agent.released
An agent was taken out of its room and is free: by an archive, a delete, a move, its harness, or a person.
Direction: Chips → the log
Sent by: Chips only; refused from a client
Requires a run: no
Schema: agent.released.json
Fields
Section titled “Fields”Every event also carries the envelope.
| Field | Required | Type | Description |
|---|---|---|---|
v |
yes | 1 |
Protocol major version. |
type |
yes | "agent.released" |
|
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. |
agent_id |
yes | string |
The agent, out of the room this event’s space_id names. |
by |
no | string |
Who did it: a person, its harness, or Chips (system). |
reason |
yes | "archived" | "deleted" | "moved" | "agent_archived" | "removed" | "agent_deleted" |
archived: its room was archived. deleted: its room was deleted. moved: it was moved to another room. agent_archived: it was archived, in its harness or by a person (ADR 0095). removed: a person took it out. agent_deleted: a person deleted it (ADR 0095). |
moved_to |
no | string |
The room it went to, when moved. |
delete |
no | true |
Written before ADR 0095: the room was deleted and the person asked for the agent to go in its harness too (ADR 0087, rule 5). Since ADR 0095 Chips writes agent.deleted for that instead; a log may still hold this. |
Example
Section titled “Example”{ "v": 1, "type": "agent.released", "id": "evt_01K4ZQPX0000000000000000G4", "ts": "2026-09-30T09:06:00.002Z", "workspace_id": "ws_01K4ZQPX000000000000000001", "actor": { "kind": "system", "id": "system" }, "agent_id": "agt_01K4ZQPX0000000000000000A1", "space_id": "spc_01K4ZQPX0000000000000000S7", "by": "usr_01K4ZQPX000000000000000003", "reason": "moved", "moved_to": "spc_01K4ZQPX000000000000000002"}