Struct ToolExecution 

pub struct ToolExecution {
    pub tool_call_id: String,
    pub thread_id: ThreadId,
    pub tool_name: String,
    pub display_name: String,
    pub input: Value,
    pub status: ExecutionStatus,
    pub result: Option<ToolResult>,
    pub operation_id: Option<String>,
    pub started_at: OffsetDateTime,
    pub completed_at: Option<OffsetDateTime>,
}

Record of a tool execution for idempotency.

This struct tracks tool executions to prevent duplicate execution when the agent loop retries after a failure. The write-ahead pattern ensures that execution intent is recorded BEFORE calling the tool, and updated with results AFTER completion.

Fields

tool_call_id: String

The tool call ID from the LLM (unique per invocation)

thread_id: ThreadId

Thread this execution belongs to

tool_name: String

Tool name

display_name: String

Display name

input: Value

Input parameters (for verification)

status: ExecutionStatus

Current status

result: Option<ToolResult>

Result if completed

operation_id: Option<String>

For async tools: the operation ID returned by execute()

started_at: OffsetDateTime

Timestamp when execution started

completed_at: Option<OffsetDateTime>

Timestamp when execution completed

Implementations

impl ToolExecution

pub fn new_in_flight( tool_call_id: impl Into<String>, thread_id: ThreadId, tool_name: impl Into<String>, display_name: impl Into<String>, input: Value, started_at: OffsetDateTime, ) -> Self

Create a new in-flight execution record.

pub fn complete(&mut self, result: ToolResult)

Mark this execution as completed with a result.

pub fn set_operation_id(&mut self, operation_id: impl Into<String>)

Set the operation ID for async tool tracking.

pub fn is_in_flight(&self) -> bool

Returns true if this execution is still in flight.

pub fn is_completed(&self) -> bool

Returns true if this execution has completed.

Trait Implementations

impl Clone for ToolExecution

fn clone(&self) -> ToolExecution

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolExecution

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ToolExecution

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ToolExecution

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

where __S: Serializer,

Serialize this value into the given Serde serializer.