Trait ToolExecutor

Source

pub trait ToolExecutor: Send + Sync {
    // Required method
    fn execute<'life0, 'life1, 'life2, 'async_trait>(
        &'life0 self,
        tool: &'life1 str,
        params: &'life2 Value,
    ) -> Pin<Box<dyn Future<Output = Result<Value, String>> + Send + 'async_trait>>
       where Self: 'async_trait,
             'life0: 'async_trait,
             'life1: 'async_trait,
             'life2: 'async_trait;

    // Provided method
    fn execute_with_action<'life0, 'life1, 'life2, 'life3, 'async_trait>(
        &'life0 self,
        tool: &'life1 str,
        params: &'life2 Value,
        _action_id: &'life3 str,
        _timeout_ms: Option<u64>,
    ) -> Pin<Box<dyn Future<Output = Result<Value, String>> + Send + 'async_trait>>
       where Self: 'async_trait,
             'life0: 'async_trait,
             'life1: 'async_trait,
             'life2: 'async_trait,
             'life3: 'async_trait { ... }
}

Expand description

Trait for tool execution. Implement this to provide tools to the runtime.

In-process: implement directly with function calls. Daemon mode: implement by sending JSON-RPC to the client.

Required Methods§

Source

fn execute<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, tool: &'life1 str, params: &'life2 Value, ) -> Pin<Box<dyn Future<Output = Result<Value, String>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Provided Methods§

Source

fn execute_with_action<'life0, 'life1, 'life2, 'life3, 'async_trait>( &'life0 self, tool: &'life1 str, params: &'life2 Value, _action_id: &'life3 str, _timeout_ms: Option<u64>, ) -> Pin<Box<dyn Future<Output = Result<Value, String>> + Send + 'async_trait>>
where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait,

Variant that also carries the originating proposal Action.id and its timeout_ms budget.

action_id: WS-based executors (car-server-core::WsToolExecutor) use it so the daemon-initiated tools.execute request to the client carries the same id the host’s process-wide handler is keyed on — without this round-trip the host can’t disambiguate concurrent callbacks for the same tool (Parslee-ai/car-releases#43 follow-up).

timeout_ms: the action’s per-call budget. WS executors MUST bound their callback wait by this (falling back to a default when None) so the daemon→host wait and the executor’s own action deadline stay coordinated — otherwise a hardcoded inner wait reaps a call the outer deadline still permits (Parslee-ai/car#259). In-process executors that don’t need either can keep the default forward to [execute].