Enum AgentEvent 

#[non_exhaustive]
pub enum AgentEvent {
    LlmCallStarted,
    LlmCallCompleted {
        tokens: u32,
        latency_ms: u64,
    },
    ToolCallStarted {
        name: String,
    },
    ToolCallCompleted {
        name: String,
        ok: bool,
    },
    Completed,
    Failed {
        reason: String,
    },
    Suspended {
        reason: String,
    },
}

Step-level event emitted by the runtime during Agent::run. Wire shape is transport-agnostic; MCP HTTP maps each variant to a notifications/progress JSON-RPC notification.

Default AgentContext::progress is None, so emission is a no-op for callers that don’t opt in. Transports opt in by passing a broadcast::Sender when constructing the context.

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.

LlmCallStarted

LLM call about to be issued.

LlmCallCompleted

LLM call returned a response. tokens is prompt + completion when the provider streams a usage payload on the final chunk; 0 when the provider does not emit usage in stream mode.

Fields

tokens: u32

Total token count (prompt_tokens + completion_tokens). Zero when the provider does not surface usage in stream mode.

latency_ms: u64

Wall-clock duration in milliseconds.

ToolCallStarted

Tool dispatch begun for name.

Fields

name: String

Name of the tool being dispatched.

ToolCallCompleted

Tool dispatch returned. ok = false means the tool errored; the wire-level redaction policy decides what to surface.

Fields

name: String

Name of the tool that was dispatched.

ok: bool

true if the tool call succeeded.

Completed

Agent reached its final assistant response.

Failed

Agent failed terminally. reason is a sanitised summary; inner error chain is logged server-side by the runtime’s existing tracing::error! path on the Err return.

Fields

reason: String

Sanitised failure reason suitable for wire transmission.

Suspended

Run suspended at a step awaiting human approval (ADR-045).

Fields

reason: String

Reason supplied by the ReviewPolicy.

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 Serialize for AgentEvent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.