Enum AgentEvent 

pub enum AgentEvent {
    Started,
    Status(String),
    Usage {
        input_tokens: u64,
        output_tokens: u64,
    },
    AssistantDelta(String),
    ReasoningDelta(String),
    ToolStarted {
        id: String,
        name: String,
        arguments: String,
    },
    ToolFinished {
        id: String,
        output: Vec<String>,
        status: ToolStatus,
    },
    ModelMetadataLoaded(Vec<(String, String)>),
    Retrying {
        attempt: u32,
        max_attempts: u32,
        delay_ms: u64,
        error: String,
    },
    Finished,
    Failed(String),
    Cancelled,
}

Provider-neutral semantic output from an agent turn.

Application adapters may attach local-tool audit details, UI state, or transport state when projecting these events to their own surfaces.

Variants

Started

A turn started.

Status(String)

Informational provider or run status.

Usage

Incremental token accounting.

Fields

input_tokens: u64

Number of input tokens observed for the request or increment.

output_tokens: u64

Number of output tokens observed for the request or increment.

AssistantDelta(String)

Incremental assistant text.

ReasoningDelta(String)

Incremental reasoning text.

ToolStarted

A tool call was requested.

Fields

id: String

Provider-assigned id for the tool call.

name: String

Application catalog name selected for the call.

arguments: String

Raw JSON arguments supplied for the call.

ToolFinished

A tool call completed.

Fields

id: String

Provider-assigned id for the tool call.

output: Vec<String>

Output lines returned by the application-owned executor.

status: ToolStatus

Final execution status.

ModelMetadataLoaded(Vec<(String, String)>)

Model metadata available for application model pickers.

Retrying

A retry was scheduled after a recoverable provider failure.

Fields

attempt: u32

One-based retry attempt that will run next.

max_attempts: u32

Maximum retry attempts configured for the request.

delay_ms: u64

Delay before the next attempt, in milliseconds.

error: String

Redacted, provider-neutral failure detail.

Finished

The turn completed normally.

Failed(String)

The turn failed recoverably.

Cancelled

The turn was cancelled cooperatively.

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

Formats the value using the given formatter.

impl Eq for AgentEvent

impl PartialEq for AgentEvent

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for AgentEvent