Enum AgentEvent 

#[non_exhaustive]
pub enum AgentEvent {
    AgentStart,
    AgentEnd {
        messages: Vec<AgentMessage>,
    },
    TurnStart,
    TurnEnd {
        message: AgentMessage,
        tool_results: Vec<ToolResultMessage>,
    },
    MessageStart {
        message: AgentMessage,
    },
    MessageUpdate {
        message: AgentMessage,
        assistant_event: Box<AssistantStreamEvent>,
    },
    MessageEnd {
        message: AgentMessage,
    },
    ToolExecutionStart {
        tool_call_id: String,
        tool_name: String,
        args: Value,
    },
    ToolExecutionUpdate {
        tool_call_id: String,
        tool_name: String,
        args: Value,
        partial_result: Value,
    },
    ToolExecutionEnd {
        tool_call_id: String,
        tool_name: String,
        result: Value,
        is_error: bool,
    },
    QueueUpdate {
        steering: Vec<String>,
        follow_up: Vec<String>,
    },
}

Events emitted during the agent loop lifecycle.

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.

AgentStart

The agent loop has started.

AgentEnd

The agent loop has ended. No more loop events will be emitted.

Fields

messages: Vec<AgentMessage>

TurnStart

A new turn (provider request/response cycle) has started.

TurnEnd

A turn has ended with the assistant message and any tool results.

Fields

message: AgentMessage

tool_results: Vec<ToolResultMessage>

MessageStart

An assistant message has started streaming.

Fields

message: AgentMessage

MessageUpdate

An assistant message has been updated with a stream event.

Fields

message: AgentMessage

assistant_event: Box<AssistantStreamEvent>

MessageEnd

An assistant message has finished streaming.

Fields

message: AgentMessage

ToolExecutionStart

Tool execution is about to begin.

Fields

tool_call_id: String

tool_name: String

args: Value

ToolExecutionUpdate

Tool execution has produced a progress update.

Fields

tool_call_id: String

tool_name: String

args: Value

partial_result: Value

ToolExecutionEnd

Tool execution has completed.

Fields

tool_call_id: String

tool_name: String

result: Value

is_error: bool

QueueUpdate

Queue messages were delivered to the conversation.

Fields

steering: Vec<String>

follow_up: Vec<String>

Trait Implementations

impl Debug for AgentEvent

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

Formats the value using the given formatter.