Enum AgentEvent 

pub enum AgentEvent {
    TurnStart {
        turn: u32,
    },
    ThinkingDelta(String),
    TextDelta(String),
    AssistantText(String),
    ToolCall {
        id: String,
        name: String,
        input: Value,
    },
    ToolDenied {
        name: String,
        reason: String,
    },
    ToolResult {
        id: String,
        name: String,
        is_error: bool,
        content: String,
    },
    TurnUsage(Usage),
    QueuedInput(String),
    MessageDelivered {
        id: String,
        from: String,
    },
    Compacted {
        messages_before: usize,
        messages_after: usize,
        prompt_tokens: u64,
    },
    Done(Box<RunOutcome>),
    Nested {
        tool: String,
        id: Option<String>,
        event: Box<AgentEvent>,
    },
}

Everything the loop wants to tell an observer. The CLI renders these; a batch runner ignores all but the last.

Variants

TurnStart

Fields

turn: u32

ThinkingDelta(String)

TextDelta(String)

AssistantText(String)

The complete assistant text for this turn, after streaming finishes.

ToolCall

Fields

id: String

name: String

input: Value

ToolDenied

Fields

name: String

reason: String

ToolResult

Fields

id: String

name: String

is_error: bool

content: String

TurnUsage(Usage)

QueuedInput(String)

Text the user queued mid-run has just entered the conversation.

MessageDelivered

Another agent’s message has just entered the conversation, sender taint merged first. See crate::mailbox.

Fields

id: String

from: String

Compacted

The transcript was summarised to fit the context window.

Fields

messages_before: usize

messages_after: usize

prompt_tokens: u64

Done(Box<RunOutcome>)

Nested

Something happening inside a tool that contains a run of its own — a subagent’s turn, seen from the parent. tool is the parent-visible tool name; id is the parent’s tool_use id for the call, which is what keeps two parallel delegations attributable; the boxed event is the child’s own. A grandchild arrives already wrapped, so depth is the nesting count.

Fields

tool: String

id: Option<String>

event: Box<AgentEvent>

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.