Enum AgentEvent 

pub enum AgentEvent {
    Session(SessionEvent),
    AgentStarted {
        name: String,
    },
    AgentCompleted {
        name: String,
    },
    ToolCallStarted {
        name: String,
        args: Value,
    },
    ToolCallCompleted {
        name: String,
        result: Value,
        duration: Duration,
    },
    ToolCallFailed {
        name: String,
        error: String,
    },
    StreamingToolYield {
        name: String,
        value: Value,
    },
    AgentTransfer {
        from: String,
        to: String,
    },
    StateChanged {
        key: String,
    },
    LoopIteration {
        iteration: u32,
    },
    Timeout,
    RouteSelected {
        agent_name: String,
    },
    FallbackActivated {
        agent_name: String,
    },
}

Events emitted by agents during live execution. Wraps SessionEvent (Layer 0) and adds agent-specific events. No duplicate variants — use AgentEvent::Session(_) for wire-level events.

Variants

Session(SessionEvent)

Passthrough of wire-level session events (text, audio, turn lifecycle).

AgentStarted

Agent lifecycle. An agent has started execution.

Fields

name: String

Name of the agent that started.

AgentCompleted

An agent has completed execution.

Fields

name: String

Name of the agent that completed.

ToolCallStarted

A tool call has started execution.

Fields

name: String

Tool name.

args: Value

Tool call arguments.

ToolCallCompleted

A tool call completed successfully.

Fields

name: String

Tool name.

result: Value

The tool’s return value.

duration: Duration

How long the tool call took.

ToolCallFailed

A tool call failed.

Fields

name: String

Tool name.

error: String

Error description.

StreamingToolYield

A streaming tool yielded an intermediate value.

Fields

name: String

Tool name.

value: Value

The yielded value.

AgentTransfer

An agent transferred control to another agent.

Fields

from: String

Source agent name.

to: String

Target agent name.

StateChanged

A state key was changed.

Fields

key: String

The key that was modified.

LoopIteration

A loop agent completed an iteration.

Fields

iteration: u32

The zero-based iteration number.

Timeout

An agent timed out.

RouteSelected

A route agent selected a branch.

Fields

agent_name: String

The name of the selected agent.

FallbackActivated

A fallback agent activated a fallback branch.

Fields

agent_name: String

The name of the fallback agent that was activated.

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.