Sessions

Sessions are the unit of conversation in the agent platform. Every session is identified by (targetKey, profileKey) plus a stable session id. This section covers the operational lifecycle: creating sessions, resuming them, attaching artifacts (the target snapshot, REPL state, files), and the full state machine from creation to deletion.

Pages

• Create session — session.create and the path that runs implicitly on first $prompt.
• Resume session — how $prompt finds an existing session and reuses it.
• Attach artifact — what gets glued onto a session beyond messages: snapshots, REPL state, activity frames.
• Session context — what an agent loop sees at the start of a turn.
• Session lifecycle — create → run → resume → delete; persistence semantics.

See also

• Sessions overview
• Reference: session schema

Source: projects/matrix-3/packages/agents/src/AgentsRoot.ts accepts list, projects/matrix-3/packages/agents/src/AgentsStore.ts:455-580 for session CRUD.