Skip to content

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

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.
{
"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"
}