Skip to content

exchange.limits_set

An owner or an admin set when Chips tells the agents in any room to stop, when it holds their messages to each other, and whether agents going in circles are told to stop then (ADR 0187). Everyone’s, in every room.

Direction: Chips → the log
Sent by: a person
Requires a run: no
Schema: exchange.limits_set.json

Every event also carries the envelope.

Field Required Type Description
v yes 1 Protocol major version.
type yes "exchange.limits_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.
stop yes number | null After how many messages between agents, with nobody acting, Chips tells them to stop and tells the room’s people. null: never, by count. Smaller than hold when both are set.
hold yes number | null After how many Chips holds their messages to each other until a person acts. null: never, by count; a pause still holds them.
circles yes boolean Whether agents going in circles (the same two or three taking turns and saying again what they said) are told to stop then, whatever the count.
{
"v": 1,
"type": "exchange.limits_set",
"id": "evt_01K4ZQPX0000000000000000M1",
"ts": "2026-10-17T15:30:00.000Z",
"workspace_id": "ws_01K4ZQPX000000000000000001",
"actor": {
"kind": "person",
"id": "usr_01K4ZQPX000000000000000003"
},
"idempotency_key": "exchange-limits-1",
"stop": 32,
"hold": null,
"circles": false
}