Struct ToolEvent 

pub struct ToolEvent {
    pub call_id: String,
    pub tool_name: String,
    pub phase: ToolEventPhase,
    pub elapsed_ms: Option<u64>,
    pub is_mutating: bool,
    pub auto_approved: bool,
    pub summary: Option<String>,
    pub error: Option<String>,
}

A structured event emitted during tool execution.

Fields

call_id: String

Tool call ID (matches ToolCall.id)

tool_name: String

Canonical tool name

phase: ToolEventPhase

Current lifecycle phase

elapsed_ms: Option<u64>

Wall-clock duration since the call began (None for Begin phase)

is_mutating: bool

Whether the tool is mutating (writes files, runs commands, etc.)

auto_approved: bool

Whether the execution was auto-approved (no user prompt)

summary: Option<String>

Human-readable summary (e.g. file paths affected, command preview)

error: Option<String>

Error message if phase == Error

Implementations

impl ToolEvent

pub fn into_agent_event(self) -> AgentEvent

Convert this event into an AgentEvent::ToolLifecycle for streaming through the agent event channel to the UI.

Trait Implementations

impl Clone for ToolEvent

fn clone(&self) -> ToolEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ToolEvent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ToolEvent

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.