Expand description
Event-sourced Agent sessions. The append-only log is the conversation SSOT; messages, runs, interactions and UI state are deterministic projections.
Structs§
- Open
Tool Call - A tool call awaiting its result.
- Projected
Context - Injected context as projected for UI and replay.
- Projected
Message - Message as projected for UI and replay.
- Recorded
Tool Call - A tool call as recorded in
AssistantToolCalls. - Session
Event - One committed Session event with its position in the log.
- Session
Projection - Deterministic projection of a Session log used by the runtime, recovery and UI.
Enums§
- Content
Block - Typed content unit; UI and models parse types, never prose conventions.
- Delivery
Mode - How queued input reaches a Run.
- Event
- Every model-visible fact and lifecycle transition of a Session. The log is the source of truth; everything else is a projection.
- Event
Error - Invariant violated while applying an event.
- Interaction
Kind - What the Run asks the user for.
- Interaction
Resolution - How the user resolved an interaction.
- RunState
- Projected lifecycle state of one Run: live, parked on an interaction, or terminal.
- RunStatus
- Terminal Run status.
- Tool
Authorization Status - Authorization outcome of a tool call.
Constants§
- SESSION_
EVENT_ FORMAT_ VERSION - Wire/storage format of
Event; only structural changes bump it.
Traits§
- Session
Event Store - Append-only Session event storage.
Functions§
- cancel_
events - Events that close an interrupted Run as cancelled.
- failure_
events - Events that close an interrupted Run as failed with
error_code. - recovery_
events - Events that close an interrupted Run as failed with
worker_restarted, so recovery starts from a clean lifecycle. - session_
deletion_ events - Events that tombstone a Session and close its Runs.
- text
- One text content block.