Struct ToolResult 

pub struct ToolResult {
    pub output: Value,
    pub hash: Hash,
    pub execution_time: Duration,
    pub tokens_used: Option<u32>,
    pub timestamp: String,
    pub tool_name: String,
}

Result of a tool execution with cryptographic verification data.

Example

use vex_llm::ToolResult;
use serde_json::json;
use std::time::Duration;

let result = ToolResult::new(
    "calculator",
    &json!({"expression": "2+2"}),
    json!({"result": 4}),
    Duration::from_millis(5),
);

// Hash is automatically computed
assert!(!result.hash.to_string().is_empty());
assert_eq!(result.output["result"], 4);

Fields

output: Value

The output value from the tool

hash: Hash

SHA-256 hash of (tool_name + args + output + timestamp) Used for Merkle tree integration and verification

execution_time: Duration

How long the tool took to execute

tokens_used: Option<u32>

Optional token count (for LLM-based tools)

timestamp: String

ISO 8601 timestamp of execution

tool_name: String

Name of the tool that produced this result

Implementations

impl ToolResult

pub fn new( tool_name: &str, args: &Value, output: Value, execution_time: Duration, ) -> Self

Create a new tool result with automatic hash computation.

The hash is computed from a deterministic JSON representation of:

• Tool name
• Input arguments
• Output value
• Timestamp

Arguments

• tool_name - Name of the tool
• args - Input arguments that were passed to the tool
• output - Result value from the tool
• execution_time - How long execution took

Security

The timestamp is captured at creation time and included in the hash to prevent replay attacks where an old result could be substituted.

pub fn with_tokens(self, tokens: u32) -> Self

Add token usage information

pub fn verify(&self, args: &Value) -> bool

Verify that the hash matches the content

Returns

true if the hash is valid for the current content, false otherwise. A false result indicates potential tampering.

pub fn execution_ms(&self) -> u128

Get execution time in milliseconds

Trait Implementations

impl Clone for ToolResult

fn clone(&self) -> ToolResult

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolResult

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ToolResult

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ToolResult

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

where __S: Serializer,

Serialize this value into the given Serde serializer.