Skip to main content

Module events

Module events 

Source
Expand description

Re-exports structured execution events from the standalone crate.

Modules§

atif
Agent Trajectory Interchange Format (ATIF) types and builder.
matrix
Canonical durable contracts for local matrix execution.
trace
Agent Trace specification types for AI code attribution.

Structs§

AgentMessageItem
CommandExecutionItem
ContextResetEvent
DecisionItem
A consequential choice and the agent’s reported public rationale.
ErrorItem
ExecutionContext
Optional recorded execution ancestry. Absent fields are historical gaps.
FileChangeItem
FileUpdateChange
HarnessEventItem
InterjectedEvent
ItemCompletedEvent
ItemContext
Item identity, timing, and command semantics for explanation consumers.
ItemStartedEvent
ItemUpdatedEvent
McpToolCallItem
PermissionRequestedEvent
PermissionResolvedEvent
PlanApprovalRequestedEvent
PlanApprovalResolvedEvent
PlanDeltaEvent
PlanItem
ReasoningItem
ThreadCompactBoundaryEvent
ThreadCompletedEvent
ThreadErrorEvent
ThreadItem
ThreadStartedEvent
TokenBreakdown
Per-request token-budget breakdown for the assembled first-request prefix.
ToolInvocationItem
ToolOutputItem
TurnBlockedEvent
TurnCompletedEvent
TurnFailedEvent
TurnStartedEvent
Usage
VersionedThreadEvent
Wraps a ThreadEvent with schema metadata so downstream consumers can negotiate compatibility before processing an event stream.
WebSearchItem

Enums§

CommandActivity
Recorded shell classification, supplied by the runtime’s shared classifier.
CommandExecutionStatus
CompactionMode
CompactionTrigger
ContextResetTrigger
HarnessEventKind
InputOrigin
Origin of a turn’s input; internal turns retain their parent task.
InterjectionSource
McpToolCallStatus
PatchApplyStatus
PatchChangeKind
PermissionDecision
PlanApprovalDecision
RedirectKind
ThreadCompletionSubtype
ThreadEvent
Structured events emitted during autonomous execution.
ThreadItemDetails
ToolCallStatus
ToolOutcome
Fine-grained outcome of a tool invocation lifecycle.

Constants§

EVENT_SCHEMA_VERSION
Semantic version of the serialized event schema exported by this crate.
MAX_IN_PROGRESS_EXEC_SESSIONS
Bound on exec session ids recorded in one turn’s turn.completed event. Mirrors SnapshotTurnDiagnostics::in_progress_exec_sessions (cap 4, newest first) so ThreadEvent and checkpoint diagnostics cannot drift.

Traits§

EventEmitter
Sink for processing ThreadEvent instances.

Functions§

deserialize_null_as_default
Serde helper that accepts explicit null as T::default() for backward-compatible checkpoint/diagnostics payloads. Pair with #[serde(default, deserialize_with = "deserialize_null_as_default")] so both missing and null fields degrade to the default instead of failing deserialization. Reused by downstream crates (e.g. vtcode-core snapshots) so the null-tolerance rule cannot drift between copies.
tool_outcome_from_status
Map a terminal ToolCallStatus to its corresponding ToolOutcome.