Struct ToolServerHandle 

pub struct ToolServerHandle(/* private fields */);

A cheaply-cloneable handle to the shared tool server state.

All operations acquire locks directly on the underlying state. Multiple handles (e.g. across agents) can share the same state without channel-based message routing.

Implementations

impl ToolServerHandle

pub async fn add_tool<T>(&self, tool: T)

where T: Tool + 'static,

Register a new static tool. Re-registering an existing name replaces the implementation (last wins) and keeps its position.

pub async fn add_dynamic_tool(&self, tool: DynamicTool)

Register a runtime-defined static tool.

pub async fn add_portable_dynamic_tool(&self, tool: PortableDynamicTool)

Register a context-free dynamic tool through the classic adapter.

pub async fn append_toolset(&self, toolset: ToolSet)

Merge an entire toolset into the server in registration order. Existing names are replaced (last wins) and keep their position.

pub async fn remove_tool(&self, tool_name: &str)

Remove a tool by name.

pub async fn execute( &self, tool_name: &str, args: &str, context: &mut ToolContext, ) -> ToolResult

Look up and execute a tool through the canonical structured path.

The implementation handle is cloned under a brief read lock, so a long execution never blocks registration changes. The tool receives one snapshot of the supplied inbound values. Its result metadata is published back to context, while mutations to its inbound snapshot are discarded.

pub async fn get_tool_defs( &self, prompt: Option<String>, ) -> Result<Vec<ToolDefinition>, ToolServerError>

Retrieve tool definitions, optionally using a prompt to select dynamic tools from configured vector stores.

Trait Implementations

impl Clone for ToolServerHandle

fn clone(&self) -> ToolServerHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.