Struct DynamicTool 

pub struct DynamicTool { /* private fields */ }

A tool defined at runtime: a name, a schema and a callback. The callback is the handler (ToolFn); this struct is its definition plus the erased handler a registry stages until a bus takes it. The optional liveness probe supports registry retirement; inline execution does not consult it.

Implementations

impl DynamicTool

pub fn new<F>( name: ToolName, description: impl Into<String>, parameters: Value, callback: F, ) -> Self

where F: Fn(Value) -> WasmBoxedFuture<'static, Result<ToolOutput, ToolExecutionError>> + WasmCompatSend + WasmCompatSync + 'static,

Define a tool from a context-free callback over owned arguments.

pub fn new_with_context<F>( name: ToolName, description: impl Into<String>, parameters: Value, callback: F, ) -> Self

where F: ToolCallback + 'static,

Define a tool from a callback over the dispatch-scoped context.

pub fn with_liveness<F>(self, is_live: F) -> Self

where F: Fn() -> bool + WasmCompatSend + WasmCompatSync + 'static,

Attach a liveness probe.

pub fn name(&self) -> &ToolName

The tool’s name.

pub fn definition(&self) -> ToolDefinition

The tool’s definition.

pub fn handler(&self) -> &ErasedHandler

The erased handler behind this definition.

pub fn into_parts(self) -> (ToolDefinition, ErasedHandler, Option<LivenessFn>)

Consumes the tool into its definition, handler, and optional liveness probe.

pub fn is_live(&self) -> bool

Whether the tool’s owner still serves it (true without a probe).

pub async fn execute( &self, arguments: Value, ) -> Result<ToolOutput, ToolExecutionError>

Run the tool inline with an empty context.

pub async fn execute_with( &self, context: &mut ToolContext, arguments: Value, ) -> Result<ToolOutput, ToolExecutionError>

Run the tool inline with isolated inbound values. A completed call replaces only context’s result metadata, including when the tool returns an error. Dropping the execution future leaves the caller’s context unchanged; it does not publish partial mutations.

Trait Implementations

impl Clone for DynamicTool

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DynamicTool

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

Formats the value using the given formatter.