Struct ToolStartEvent 

pub struct ToolStartEvent {
    pub tool_name: ToolName,
    pub tool_call_id: String,
    pub params: Option<Value>,
    pub parent_tool_use_id: Option<String>,
    pub started_at: Instant,
    pub speculative: bool,
    pub sandbox_profile: Option<SandboxProfile>,
}

Event carrying data for a tool call start, emitted before execution begins.

Passed by value to Channel::send_tool_start and carried by LoopbackEvent::ToolStart. All fields are owned — no lifetime parameters.

Fields

tool_name: ToolName

Name of the tool being invoked.

tool_call_id: String

Opaque tool call ID assigned by the LLM.

params: Option<Value>

Raw input parameters passed to the tool (e.g. {"command": "..."} for bash).

parent_tool_use_id: Option<String>

Set when this tool call is made by a subagent; identifies the parent’s tool_call_id.

started_at: Instant

Wall-clock instant when the tool call was initiated; used to compute elapsed time.

speculative: bool

True when this tool call was speculatively dispatched before LLM finished decoding.

TUI renders a [spec] prefix; Telegram suppresses unless chat_visibility = verbose.

sandbox_profile: Option<SandboxProfile>

OS sandbox profile applied to this tool call, if any.

None means no sandbox was applied (not configured or not a subprocess executor).

Trait Implementations

impl Clone for ToolStartEvent

fn clone(&self) -> ToolStartEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolStartEvent

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

Formats the value using the given formatter.