agent.asked
A person asked a harness for a new agent in this room. It starts with the room’s last lines, and nothing from elsewhere.
Direction: Chips → the log
Sent by: Chips only; refused from a client
Requires a run: no
Schema: agent.asked.json
Fields
Section titled “Fields”Every event also carries the envelope.
| Field | Required | Type | Description |
|---|---|---|---|
v |
yes | 1 |
Protocol major version. |
type |
yes | "agent.asked" |
|
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. |
harness_id |
yes | string |
The harness asked. It makes the agent, and registers it for the room this event’s space_id names. |
name |
yes | string |
What the new agent is to be called: the person’s word, or else the next name of its harness’s that nobody here answers to. Chips numbers it, as any other, if the name is taken by the time it is registered. |
by |
yes | string |
The person who asked. |
Example
Section titled “Example”{ "v": 1, "type": "agent.asked", "id": "evt_01K4ZQPX0000000000000000N1", "ts": "2026-10-03T18:58:00.000Z", "workspace_id": "ws_01K4ZQPX000000000000000001", "space_id": "spc_01K4ZQPX000000000000000002", "actor": { "kind": "person", "id": "usr_01K4ZQPX000000000000000003" }, "harness_id": "hrn_01K4ZQPX000000000000000004", "name": "Reviewer", "by": "usr_01K4ZQPX000000000000000003"}