Enum AgentEvent 

#[non_exhaustive]
pub enum AgentEvent {
    TurnStart,
    ProviderProgress {
        progress: ProviderProgress,
    },
    TextDelta {
        delta: String,
    },
    ThinkingDelta {
        delta: String,
    },
    ReasoningComplete {
        blocks: Vec<ReasoningBlock>,
    },
    ToolCallStarted {
        name: String,
    },
    ToolCall {
        call: ToolCall,
        provenance: ToolProvenance,
        summary_fields: Vec<String>,
    },
    ToolResult {
        result: MessageToolResult,
    },
    TurnEnd {
        stop_reason: StopReason,
        usage: Usage,
    },
    Error {
        message: String,
    },
}

Events emitted during a turn for streaming.

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.

TurnStart

Turn has started.

ProviderProgress

Transient, typed provider dispatch/retry progress for the active request.

Fields

progress: ProviderProgress

Provider-owned progress facts. This event is never a transcript message.

TextDelta

A text delta was received from the provider.

Fields

delta: String

The text chunk.

ThinkingDelta

A transient thinking/reasoning delta was received from the provider.

Thinking deltas are live UI preview data. They must not be persisted as normal conversation history or included in the final assistant text.

Fields

delta: String

The thinking text chunk.

ReasoningComplete

Emitted once per provider response, before TurnEnd, when the response carried reasoning blocks. Durable replay payload; never display content.

Fields

blocks: Vec<ReasoningBlock>

Provider-native reasoning blocks in stream order.

ToolCallStarted

Tool call detected: parameters still streaming.

Fields

name: String

Name of the tool being called.

ToolCall

A tool call was requested.

Fields

call: ToolCall

The tool call details.

provenance: ToolProvenance

The provenance of the tool being called.

summary_fields: Vec<String>

Fields to display in the TUI summary (from tool summary_fields()).

ToolResult

A tool call completed.

Fields

result: MessageToolResult

The tool result.

TurnEnd

Turn has ended.

Fields

stop_reason: StopReason

Why the turn ended.

usage: Usage

Token usage for this turn.

Error

An error occurred.

Fields

message: String

Error message.

Trait Implementations

impl Clone for AgentEvent

fn clone(&self) -> AgentEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentEvent

fn deserialize<__D>( __deserializer: __D, ) -> Result<AgentEvent, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for AgentEvent

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for AgentEvent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for AgentEvent