Struct ToolExecutor 

pub struct ToolExecutor { /* private fields */ }

Tool executor with automatic audit logging and timeout protection.

The executor provides a safe, audited interface to execute tools:

1. Validates arguments against tool’s schema
2. Executes with timeout protection
3. Hashes results for Merkle chain
4. Logs execution to audit trail (if configured)

Example

use vex_llm::{ToolExecutor, ToolRegistry};

let registry = ToolRegistry::with_builtins();
let executor = ToolExecutor::new(registry);

let result = executor
    .execute("calculator", json!({"expression": "2+2"}))
    .await?;

println!("Result: {}", result.output);
println!("Hash: {}", result.hash);

Implementations

impl ToolExecutor

pub fn new(registry: ToolRegistry) -> Self

Create a new executor with the given registry

pub fn without_audit(registry: ToolRegistry) -> Self

Create executor with audit logging disabled

pub fn with_max_parallel(self, max: usize) -> Self

Set maximum parallel executions

pub fn with_allowed_capabilities(self, caps: Vec<Capability>) -> Self

Set allowed capabilities for the sandbox

pub async fn execute( &self, tool_name: &str, args: Value, ) -> Result<ToolResult, ToolError>

Execute a tool by name with given arguments.

Arguments

• tool_name - Name of the tool to execute
• args - JSON arguments to pass to the tool

Returns

• Ok(ToolResult) - Execution result with hash for verification
• Err(ToolError) - If tool not found, validation failed, execution error, or timeout

Security

• Tool lookup prevents arbitrary code execution
• Timeout prevents DoS from hanging tools
• Result hash enables tamper detection

pub async fn execute_parallel( &self, calls: Vec<(String, Value)>, ) -> Vec<Result<ToolResult, ToolError>>

Execute multiple tools in parallel.

Arguments

• calls - Vector of (tool_name, args) pairs

Returns

Vector of results in the same order as input. Each result is independent (one failure doesn’t affect others).

Security

• Respects max_parallel limit to prevent resource exhaustion
• Each tool has its own timeout

pub fn registry(&self) -> &ToolRegistry

Get a reference to the tool registry

pub fn registry_mut(&mut self) -> &mut ToolRegistry

Get a mutable reference to the tool registry

pub fn has_tool(&self, name: &str) -> bool

Check if a tool exists

pub fn tool_names(&self) -> Vec<&str>

List all available tool names

Trait Implementations

impl Debug for ToolExecutor

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

Formats the value using the given formatter.