#[non_exhaustive]pub enum ItemKind {
Show 19 variants
UserMessage,
AgentMessage,
Reasoning,
ToolCall,
UserShell,
Subagent,
Workflow,
ReminderChild,
Compaction,
HookRun,
SideChat,
SkillRead,
WebSearch,
MonitorFeed,
DamagedRange,
ScheduledFire,
BackgroundTerminalCompletion,
OverdueNotice,
Unknown(String),
}Expand description
The eleven v1 item kinds plus post-v1 kinds. Open: a new kind is additive evolution, and clients MUST render unknown kinds generically.
Variants (Non-exhaustive)§
This enum is marked as non-exhaustive
UserMessage
A submitted user prompt. Single-shot.
AgentMessage
A committed assistant message. Delta-streamed.
Reasoning
Reasoning summary/text. Delta-streamed.
ToolCall
A committed tool call joined to its task lifecycle.
UserShell
The user shell escape hatch, item-ified; turnId is null.
Subagent
A subagent child lifecycle.
Workflow
A workflow run.
ReminderChild
A reminder agent’s child session: opened inProgress at the link
record, settled with the child task’s real terminal outcome.
Compaction
A context compaction.
HookRun
A hook run folding its started/terminal records.
SideChat
A side-chat link on its main session’s view: opened inProgress at the
side creation, settled once (Accepted completes, Rejected rejects,
Abandoned cancels) — a signpost, not a live fold.
SkillRead
A skill-read notice: single-shot only, status completed — a notice has
no progress. Experimental: stripped per-connection for unopted callers.
WebSearch
A provider-hosted web search call: a plain additive value of this open
enum — never strip-armed, since kind is required (the AuthRequired
precedent). Only the seven webSearch members are experimental-gated.
MonitorFeed
One monitor feed line as one transcript cell: a plain additive value of
this open enum, stable from day one. Single-shot only, status
completed, turnId null — arrival is the transcript fact.
DamagedRange
One damaged range of the session log, at its position. Single-shot only,
status completed, turnId null. No log record carries it: the fold
that reads the damaged bytes derives it. A build that predates the kind
decodes it only if its ItemKind has a catch-all; the protocol crate’s
does not yet.
ScheduledFire
A scheduled-task fire notice: a plain additive value of this open enum,
stable from day one — never strip-armed, since kind is required (the
AuthRequired precedent). Single-shot only, status completed,
revision 1 — a notice has no progress.
BackgroundTerminalCompletion
A background-terminal completion marker: a plain additive the protocol
spec open-enum value, stable from day one — never strip-armed, since
kind is required (the AuthRequired precedent). Single-shot only,
status completed, revision 1 — a notice has no progress.
OverdueNotice
One background-overdue drain as one transcript line: a plain additive
value of this open enum, stable from day one. Single-shot only, status
completed — a notice has no progress. text is the gate-off literal
verbatim; turnId is the draining turn.
Unknown(String)
A value from a newer host, kept verbatim so an older client decodes the rest of the message. Never construct it with a known word.