exchange.set
A person paused the agents in a room, or let them carry on; or Chips paused them at the room’s spend ceiling.
Direction: Chips → the log
Sent by: Chips only; refused from a client
Requires a run: no
Schema: exchange.set.json
Fields
Section titled “Fields”Every event also carries the envelope.
| Field | Required | Type | Description |
|---|---|---|---|
v |
yes | 1 |
Protocol major version. |
type |
yes | "exchange.set" |
|
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. |
state |
yes | "paused" | "going" |
paused: their messages to each other are held. going: they carry on. |
why |
no | "spend" |
Why Chips paused them: spend, the room’s job reached its ceiling (ADR 0118). Absent when a person did. |
spend |
no | object | For why: spend: what the job had spent, against what the room allows a job. |
spend.ceiling_usd |
yes | number |
What the room allows a job, in US dollars: its own ceiling, or the default (3) when nobody has set one. |
spend.spent_usd |
yes | number |
What the room’s runs reported costing since the job began, in US dollars, every harness’s together. |
spend.since_seq |
yes | number |
Where the job began: the seq of the last thing a person did in the room, or of the last brief handed into it, whichever is later; 0 when neither has happened. |
spend.uncounted_runs |
yes | number |
How many of the job’s runs reported no cost, and so count nothing. |
Example
Section titled “Example”{ "v": 1, "type": "exchange.set", "id": "evt_01K4ZQPX0000000000000000X1", "ts": "2026-10-02T18:53:00.000Z", "workspace_id": "ws_01K4ZQPX000000000000000001", "space_id": "spc_01K4ZQPX000000000000000002", "actor": { "kind": "person", "id": "usr_01K4ZQPX000000000000000003" }, "state": "paused"}