Struct ChainedInvoker 

pub struct ChainedInvoker { /* private fields */ }

Tool invoker that dispatches calls to a registered set of Tool impls by name. Validates args against each tool’s json_schema before invocation, and enforces a per-invocation timeout.

Implementations

impl ChainedInvoker

pub fn new() -> ChainedInvoker

Build an empty invoker with a 30-second default timeout.

pub fn with_default_timeout(self, t: Duration) -> ChainedInvoker

Override the default per-tool timeout. Default: 30 seconds.

pub fn with_per_tool_timeout( self, tool_name: impl Into<String>, dur: Duration, ) -> ChainedInvoker

Override the timeout for a specific tool by name. Repeated calls for the same tool_name keep the latest. The override applies regardless of registration order — the tool need not be added before the override.

pub fn add_tool(&mut self, tool: Arc<dyn Tool>) -> Result<(), InvokerError>

Register a tool by mutating the invoker in place. Useful when building from a dynamic source (e.g. iterating a Vec). Returns InvokerError::DuplicateTool when a tool with the same name is already registered.

pub fn with_tool( self, tool: Arc<dyn Tool>, ) -> Result<ChainedInvoker, InvokerError>

Register a tool, consuming and returning self. Convenient for inline chaining: ChainedInvoker::new().with_tool(a)?.with_tool(b)?. Delegates to Self::add_tool.

pub fn with_tool_owned<T>(self, tool: T) -> Result<ChainedInvoker, InvokerError>

where T: Tool + 'static,

Returns InvokerError::DuplicateTool when a tool with the same name is already registered.

Trait Implementations

impl Debug for ChainedInvoker

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

Formats the value using the given formatter.

impl Default for ChainedInvoker

fn default() -> ChainedInvoker

Returns the “default value” for a type.

impl ToolInvoker for ChainedInvoker

fn invoke<'life0, 'life1, 'async_trait>( &'life0 self, name: &'life1 str, args: Value, ctx: ToolCtx, ) -> Pin<Box<dyn Future<Output = Result<Value, ToolError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, ChainedInvoker: 'async_trait,

Invoke name with args against the supplied context.

fn catalogue(&self) -> Vec<ToolDef>

Return the catalogue this invoker exposes.

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

Mirrors Tool::redacts_audit across the invoker boundary (dispatch holds a ToolInvoker, not the concrete Tool). Per-name granularity so one invoker can mix PII-handling and non-PII tools. Default false (raw).

fn is_tool_idempotent(&self, _name: &str) -> bool

Returns true if invoke(name, args, ctx) is safe to re-execute from the original arguments — i.e. read-only, deterministic, or duplicate execution has no business effect.