Struct ToolExecution 

pub struct ToolExecution {
    pub id: Uuid,
    pub session_id: Uuid,
    pub message_id: Uuid,
    pub call_id: String,
    pub tool_name: String,
    pub arguments: Value,
    pub result: Option<Value>,
    pub status: ToolExecutionStatus,
    pub error: Option<String>,
    pub duration: Duration,
    pub created_at: DateTime<Utc>,
}

Persisted record of a single tool invocation.

Captures the full lifecycle: input arguments, output result, execution status, wall-clock duration, and any error message on failure.

Fields

id: Uuid

Unique execution identifier.

session_id: Uuid

Session this execution belongs to.

message_id: Uuid

Message that triggered the tool call.

call_id: String

Tool call identifier from the provider.

tool_name: String

Tool name that was executed.

arguments: Value

JSON arguments passed to the tool.

result: Option<Value>

Tool output value, if execution succeeded.

status: ToolExecutionStatus

Execution status.

error: Option<String>

Human-readable error message when status is Failed.

duration: Duration

Wall-clock execution duration.

created_at: DateTime<Utc>

When the execution started.

Implementations

impl ToolExecution

pub fn new( session_id: Uuid, message_id: Uuid, call_id: impl Into<String>, tool_name: impl Into<String>, arguments: Value, ) -> Self

Creates a new tool execution record with a generated UUIDv7 ID and current timestamp.

The execution starts with Pending status, no result, no error, and zero duration.

pub fn with_success(self, result: Value, duration: Duration) -> Self

Marks the execution as successful with the given result and duration, consuming and returning self.

pub fn with_failure(self, error: impl Into<String>, duration: Duration) -> Self

Marks the execution as failed with the given error message and duration, consuming and returning self.

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 PartialEq for ToolExecution

fn eq(&self, other: &ToolExecution) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

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.

impl StructuralPartialEq for ToolExecution