space.created
A space was opened: a direct message, a group, a channel or a thread.
Direction: Chips → the log
Sent by: a person
Requires a run: no
Schema: space.created.json
Fields
Section titled “Fields”Every event also carries the envelope.
| Field | Required | Type | Description |
|---|---|---|---|
v |
yes | 1 |
Protocol major version. |
type |
yes | "space.created" |
|
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. |
kind |
yes | "direct" | "group" | "channel" | "thread" |
Mixed membership is the norm; the kind is about shape, not about who is in it. |
title |
no | string |
What to call it. Direct messages have none. |
parent_space_id |
no | string |
The space this is a thread of (M5.4). A thread has no members of its own: whoever is in the parent is in the thread, and leaves it with the parent. |
root_message_id |
no | string |
For a thread: the message in the parent it grew from, which is where it is drawn. |
external_key |
no | string |
What this space is in the adapter’s own terms — a worktree path, the id of a project or an agent in the harness’s own tree — prefixed by the harness. Unique in a workspace, so opening the same thing twice finds the space rather than making another (ADR 0024). |
opened_for |
no | string |
The person this was opened on behalf of, when it was not they who opened it. A harness opens a space for its owner as it finds one (ADR 0024); without this they would not be sent the event that names it, and the space would arrive with no title. |
asked_of |
no | string |
The harness a person opened this room for, to make something of its own for it: an agent, a session, wherever it keeps such things. Only a person asks, only of a harness that declares new_spaces, and never in a thread or a room that already has a key. The harness is sent this event, and answers with space.claimed. |
also_asked_of |
no | string[] |
The other harnesses asked with asked_of, when a person picked several faces (ADR 0084, ADR 0087’s addendum of 30 September). Each is sent this event and answers with a new agent in the room, in its own place; only asked_of names the room. |
Example
Section titled “Example”{ "v": 1, "type": "space.created", "id": "evt_01K4ZQPX0000000000000000C8", "ts": "2026-09-02T14:20:00.004Z", "workspace_id": "ws_01K4ZQPX000000000000000001", "space_id": "spc_01K4ZQPX000000000000000002", "actor": { "kind": "person", "id": "usr_01K4ZQPX000000000000000003" }, "kind": "group", "title": "PO-4471"}