Enum Event 

#[non_exhaustive]
pub enum Event {
    Started {
        session: String,
        model: Option<String>,
    },
    Thinking(String),
    Text(String),
    ToolCall {
        id: Option<String>,
        name: String,
        input: Value,
    },
    ToolResult {
        id: Option<String>,
        ok: Option<bool>,
        output: String,
    },
    Usage(Usage),
    ApprovalRequest(Approval),
    RateLimit(RateLimit),
    Compaction(Compaction),
    Commands(Commands),
}

One normalized thing an agent did, agent-agnostic so a single renderer works across all three.

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 session is live. Emitted once, as early as the agent reveals it.

Fields

session: String

The native session id.

model: Option<String>

The model actually selected, when named.

Thinking(String)

Reasoning text, where the agent exposes it.

Text(String)

Assistant text as it arrives.

ToolCall

The agent invoked a tool.

Fields

id: Option<String>

Correlates with the matching Event::ToolResult, when the agent provides an id.

name: String

The tool’s name.

input: Value

Its arguments, in the agent’s own shape.

ToolResult

A tool returned.

Fields

id: Option<String>

Correlates with the originating Event::ToolCall.

ok: Option<bool>

Whether the tool reported success. None when the agent does not say.

output: String

The observation the model saw.

Usage(Usage)

Token usage so far, reported while the turn is still running.

For a live counter in a UI. Emitted once per model call, so a host can fold each into a running total with crate::Usage::accumulate, whose per-field rules were written for exactly this.

output_tokens is deliberately absent here. Mid-turn the agent reports the count as it stood when the message began, which understates the finished figure badly: a run whose per-call reports summed to 9 had generated 497 by the end. The context figures are exact, so a counter built on crate::Usage::context_tokens is honest and one built on output would not be. The true output count arrives with the crate::Outcome.

Claude reports this throughout a turn. Copilot reports once, near the end. Codex reports nothing until the turn completes, so it never emits this.

ApprovalRequest(Approval)

The agent is waiting for permission to make a tool call.

Only emitted when the request asked for it via crate::Request::approvals. The run is blocked until crate::Run::respond answers it, so a consumer that ignores this stalls until the run’s timeout.

RateLimit(RateLimit)

A quota signal. Reported, never acted on.

Compaction(Compaction)

A /compact started or settled.

Only on a run carrying crate::Command::Compact. A refusal arrives here as crate::Compaction::Finished with a reason rather than as an error, because the command ran and answered. Claude only.

Commands(Commands)

What the agent reports it can do, emitted once as the run starts.

The catalogue is the agent’s own, not this crate’s: skills, plugins and user commands differ per install. Claude only; nothing else publishes one.

Trait Implementations

impl Clone for Event

fn clone(&self) -> Event

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Event

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Event

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Event

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Event

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 Event