Struct ToolRegistry 

pub struct ToolRegistry { /* private fields */ }

Central registry mapping tool names to their trait-based handlers. Every tool is trait-based and resolved here; the earlier match-cascade dispatch has been fully retired.

Handlers are stored behind Arc (not Box) so the dispatch layer can hand an owned, 'static handle to tokio::task::spawn_blocking. That lets a blocking handler run on the dedicated blocking pool under a watchdog deadline instead of pinning a scarce core worker via block_in_place (#271 — a hung handler must never swallow the JSON-RPC response).

Implementations

impl ToolRegistry

pub fn new() -> Self

pub fn register(&mut self, tool: Box<dyn McpTool>)

pub fn get(&self, name: &str) -> Option<&dyn McpTool>

pub fn get_arc(&self, name: &str) -> Option<Arc<dyn McpTool>>

Clone an owned, 'static handle to a registered tool.

Unlike get, the returned Arc can be moved into spawn_blocking, so the dispatch layer can execute the (synchronous) handler off the async core workers under a watchdog (#271).

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

pub fn static_name(&self, name: &str) -> Option<&'static str>

The registry’s own 'static key for name, if it is a registered tool. Telemetry counts per tool only under these keys, so a caller-supplied string never reaches a counter.

pub fn tool_defs(&self) -> Vec<Tool>

Returns MCP Tool definitions in the official public surface.

Deprecated aliases and local-only collaboration compatibility tools remain callable through dispatch but are neither published nor counted as official tools. Applies MCP ToolAnnotations (readOnlyHint, destructiveHint) so clients can make informed decisions about tool usage in restricted contexts.

pub fn registered_tool_defs(&self) -> Vec<Tool>

Returns MCP Tool definitions for every registered tool, including deprecated aliases and local-only compatibility substrate. Used by callability and schema checks that cover the full registry.

pub fn active_tool_defs(&self) -> Vec<Tool>

Returns tool definitions filtered by the dynamic tool state. Only includes tools whose category is currently active.

pub fn profile_tool_defs(&self, profile: &ToolProfile) -> Vec<Tool>

Returns tool definitions filtered by a tool profile. Only includes tools whose name is enabled by the given profile.

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn names(&self) -> Vec<&'static str>

Trait Implementations

impl Default for ToolRegistry

fn default() -> Self

Returns the “default value” for a type.