question.answered

The chosen options or free text, or a note that the timeout passed.

Direction: Chips → Harness
Sent by: a person or a harness
Requires a run: yes
Schema: question.answered.json

Fields

Every event also carries the envelope.

Field	Required	Type	Description
v	yes	1	Protocol major version.
type	yes	"question.answered"
id	yes	string	The event’s own id. Stable across a retry of the same event.
ts	yes	string	When it happened, by Chips’ clock. Stamped on the way in; a value the sender writes is replaced.
workspace_id	yes	string	A workspace identifier: ws_ followed by a ULID.
space_id	no	string	The space, when the event belongs to one.
run_id	no	string	The run, when the event belongs to one.
seq	no	number	Assigned by the server on append, monotonic per workspace. Absent on the way in.
idempotency_key	no	string	Required on every client-originated write. Sending the same key twice is a no-op.
actor	yes	object	The participant an event is attributed to.
actor.kind	yes	"person" | "harness" | "agent" | "system"	Whether a person, a harness, one of a harness’s agents or Chips itself acted.
actor.id	yes	string	The participant id, or system for Chips.
actor.harness_id	no	string	For an agent: the harness it speaks through, whose budget and runs are the agent’s (ADR 0087). Filled in by Chips.
ask_id	yes	string	A question identifier: qst_ followed by a ULID.
answers	yes	object[]	One entry per question that was answered.
answers[].question_id	yes	string
answers[].values	yes	string[]	The chosen option values.
answers[].free_text	no	string	What the person typed instead.
answered_by	yes	string	Who answered, or system on a timeout — a harness when it settles its own question, answered in its own tools. Filled in by Chips from the credential that sent it.
answered_at	yes	string	When it was answered. Stamped by Chips.
timed_out	no	boolean	True when the default was taken rather than a choice.

Example

{
  "v": 1,
  "type": "question.answered",
  "id": "evt_01K4ZQPX000000000000000077",
  "ts": "2026-09-02T14:22:19.004Z",
  "workspace_id": "ws_01K4ZQPX000000000000000001",
  "space_id": "spc_01K4ZQPX000000000000000002",
  "actor": {
    "kind": "system",
    "id": "system"
  },
  "run_id": "run_01K4ZQPX000000000000000005",
  "ask_id": "qst_01K4ZQPX000000000000000009",
  "answers": [
    {
      "question_id": "delivery-window",
      "values": ["19"]
    }
  ],
  "answered_by": "usr_01K4ZQPX000000000000000003",
  "answered_at": "2026-09-02T14:29:40.117Z",
  "timed_out": false
}