budget.warning
Eighty percent spent. At a hundred the run pauses rather than warning again; for a room’s job, the room’s agents pause.
Direction: Chips → Harness
Sent by: Chips only; refused from a client
Requires a run: no
Schema: budget.warning.json
Fields
Section titled “Fields”Every event also carries the envelope.
| Field | Required | Type | Description |
|---|---|---|---|
v |
yes | 1 |
Protocol major version. |
type |
yes | "budget.warning" |
|
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. |
budget |
yes | object | The ceiling and what was spent against it: the harness’s budget, or for a job the room’s ceiling and the job’s spend. |
budget.limit_usd |
yes | number |
The ceiling for this harness. |
budget.spent_usd |
yes | number |
Spent so far, estimated. |
threshold |
yes | 80 | 100 |
Which ceiling was crossed, as a percentage. |
action |
yes | "warn" | "pause" |
warn at eighty, pause at a hundred. |
scope |
no | "harness" | "job" |
Whose ceiling: the harness’s own budget (absent says the same), or the job in the room named by space_id (ADR 0118). |
since_seq |
no | number |
For a job: where it began, as context.spend.since_seq says it. A later job in the room is a new allowance. |
Example
Section titled “Example”{ "v": 1, "type": "budget.warning", "id": "evt_01K4ZQPX00000000000000007D", "ts": "2026-09-02T14:22:25.004Z", "workspace_id": "ws_01K4ZQPX000000000000000001", "space_id": "spc_01K4ZQPX000000000000000002", "actor": { "kind": "system", "id": "system" }, "budget": { "limit_usd": 3, "spent_usd": 2.41 }, "threshold": 80, "action": "warn", "scope": "job", "since_seq": 14049}