Enum AgentStreamEvent 

#[non_exhaustive]
pub enum AgentStreamEvent {
    Started {
        agent: String,
    },
    TurnStarted {
        turn: u32,
    },
    Model {
        turn: u32,
        event: ModelStreamEvent,
    },
    ContextRetrieved {
        source: String,
        documents: usize,
    },
    CallableStarted {
        turn: u32,
        kind: CallableKind,
        call: ToolCall,
    },
    CallableCompleted {
        turn: u32,
        kind: CallableKind,
        call_id: String,
        name: String,
        success: bool,
    },
    UsageUpdated {
        usage: Usage,
    },
    Completed {
        outcome: AgentOutcome,
    },
    ConversationSummaryStarted {
        checkpoint_id: CheckpointId,
        through_sequence: ConversationSequence,
    },
    ConversationSummaryCommitted {
        through_sequence: ConversationSequence,
        usage: Usage,
    },
    ConversationCommitted {
        outcome: AgentOutcome,
        conversation_version: ConversationVersion,
    },
    TerminalRepairScheduled {
        attempt: u32,
        failure: TerminalRequirementFailure,
    },
    TurnReviewStarted {
        turn: u32,
    },
    TurnReviewCompleted {
        turn: u32,
        verdict: TerminalReviewVerdictKind,
    },
    TurnReviewRepairScheduled {
        attempt: u32,
        turn: u32,
    },
    TerminalReviewStarted {
        attempt: u32,
    },
    TerminalReviewCompleted {
        attempt: u32,
        verdict: TerminalReviewVerdictKind,
    },
    TerminalReviewRepairScheduled {
        attempt: u32,
    },
}

One real-time event from the canonical Agent execution loop.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Started

The Agent execution started.

Fields

agent: String

Stable local Agent name.

TurnStarted

A model turn started.

Fields

turn: u32

One-based turn number.

Model

One provider-neutral model streaming event.

Fields

turn: u32

One-based owning turn.

event: ModelStreamEvent

Canonical event accepted by the model stream accumulator.

ContextRetrieved

One dynamic context source completed retrieval.

Fields

source: String

Operator-visible source name.

documents: usize

Number of documents injected into the transcript.

CallableStarted

A Tool or child Agent call started.

Fields

turn: u32

One-based owning turn.

kind: CallableKind

Callable boundary.

call: ToolCall

Canonical model-emitted call.

CallableCompleted

A Tool or child Agent call reached a recoverable terminal result.

Fields

turn: u32

One-based owning turn.

kind: CallableKind

Callable boundary.

call_id: String

Model-emitted call identity.

name: String

Model-facing callable name.

success: bool

Whether execution produced a successful output.

UsageUpdated

Shared run-tree resource usage changed.

Fields

usage: Usage

Latest cumulative usage snapshot.

Completed

The Agent reached a terminal model response.

Fields

outcome: AgentOutcome

Complete canonical outcome.

ConversationSummaryStarted

A checkpointed summary batch is about to run or resume.

Fields

checkpoint_id: CheckpointId

Stable summary Agent checkpoint identity.

through_sequence: ConversationSequence

Last transcript entry included in this batch.

ConversationSummaryCommitted

A summary batch and its session progress have been persisted.

Fields

through_sequence: ConversationSequence

Last transcript entry covered by the committed summary.

usage: Usage

Shared cumulative resource usage including summary generation.

ConversationCommitted

The terminal checkpoint and conversation transcript committed atomically.

Fields

outcome: AgentOutcome

Complete canonical outcome.

conversation_version: ConversationVersion

Committed transcript version.

TerminalRepairScheduled

An invalid terminal candidate scheduled a bounded repair turn.

Fields

attempt: u32

One-based repair attempt number.

failure: TerminalRequirementFailure

Safe reason the candidate was rejected.

TurnReviewStarted

Internal review started before a model response can affect execution.

Fields

turn: u32

One-based model turn being reviewed.

TurnReviewCompleted

Internal review returned a validated verdict.

Fields

turn: u32

One-based model turn that was reviewed.

verdict: TerminalReviewVerdictKind

Stable semantic verdict category.

TurnReviewRepairScheduled

An internal review verdict scheduled a replacement model turn.

Fields

attempt: u32

Cumulative one-based internal repair number.

turn: u32

Model turn whose response was rejected.

TerminalReviewStarted

Semantic review of a locally valid terminal candidate started.

Fields

attempt: u32

One-based review attempt.

TerminalReviewCompleted

Semantic review returned a validated verdict.

Fields

attempt: u32

One-based review attempt.

verdict: TerminalReviewVerdictKind

Stable semantic verdict category.

TerminalReviewRepairScheduled

A semantic review verdict scheduled a bounded regeneration turn.

Fields

attempt: u32

One-based repair number.

Trait Implementations

impl Clone for AgentStreamEvent

fn clone(&self) -> AgentStreamEvent

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AgentStreamEvent

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentStreamEvent

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for AgentStreamEvent

fn eq(&self, other: &AgentStreamEvent) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for AgentStreamEvent

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AgentStreamEvent