Enum AgentEvent 

#[non_exhaustive]
pub enum AgentEvent {
    ToolCall {
        name: String,
    },
    ToolResult {
        name: String,
        size_bytes: usize,
    },
    Token(String),
    Usage(Usage),
    BuildMutation {
        xml: String,
        label: String,
    },
    Trace(AgentTrace),
}

Events yielded by the agent during a response.

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.

ToolCall

The agent is calling a tool (yields tool name for progress indication).

Fields

name: String

ToolResult

A tool has returned a result (yields tool name and response size).

Fields

name: String

size_bytes: usize

Token(String)

A token of the final streamed response.

Usage(Usage)

Cumulative token usage across all LLM calls for this response.

BuildMutation

The agent has produced a build mutation. Emitted after the final response.

Fields

xml: String

label: String

Trace(AgentTrace)

Complete reasoning trace for this response. Emitted last.