Struct DynamicToolRegistry 

pub struct DynamicToolRegistry { /* private fields */ }

T-010: concrete dynamic registry.

Thread-safe (Arc<RwLock<...>> internals) so it can be shared between axum handlers in tokitai-mcp-server and a long-running admin endpoint that adds/removes tools at runtime.

Tool definitions live in an Inner struct behind an Arc<RwLock>. Per-tenant overrides are layered on top: enable_for / disable_for mutate a HashMap<tenant, HashSet<tool_name>>. A tool is visible to a tenant when:

1. it is globally registered, AND
2. the tenant has no entry in the overrides map (default-allow), OR
3. the tenant’s entry contains the tool name.

Note: when a tenant’s first override is a disable_for, that flips the default-allow to default-deny for that tenant. Callers wanting to keep default-allow semantics should enable_for every global tool after the first disable_for.

Implementations

impl DynamicToolRegistry

pub fn new() -> Self

Create an empty registry.

Example

use tokitai_core::DynamicToolRegistry;

let reg = DynamicToolRegistry::new();
assert!(reg.list_global().is_empty());

pub fn list_global(&self) -> Vec<String>

List the names of all globally-registered tools, in insertion order (HashMap ordering is unspecified, but the set itself is deterministic).

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

Return true if name is currently registered (globally).

pub fn definition(&self, name: &str) -> Option<ToolDefinition>

Return the ToolDefinition for a globally-registered tool, or None if it is not registered.

pub fn clear(&self)

Drop all globally-registered tools and per-tenant overrides. Useful for tests and for “reset to known state” admin flows.

pub fn call_for_tenant( &self, name: &str, tenant: Option<&str>, args: &Value, ) -> Result<Value, ToolError>

Invoke name honouring tenant’s visibility rules. Returns ToolError::NotFound when the tool is not visible to tenant (whether because it was never registered, or because the tenant’s override set excludes it).

Trait Implementations

impl CapabilityManifestProvider for DynamicToolRegistry

T-023: dynamic registries inherit the trait’s default (empty) capability manifest. Operators who need a per-tenant capability allowlist for a dynamic registry can wrap it in a McpServerBuilder::with_tool(registry) and configure the allowlist on the builder. The static #[tool] macro path is the primary T-023 surface; the dynamic path is left as a follow-up (the per-tenant gating already provides a richer policy surface than the static manifest, so collapsing the two would be a net loss).

fn capability_manifest() -> &'static [(&'static str, &'static [&'static str])]

Return the aggregated (tool_name, requires) slice for this provider. The slice is &'static so no allocation happens on the hot path.

impl Clone for DynamicToolRegistry

fn clone(&self) -> DynamicToolRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for DynamicToolRegistry

fn default() -> DynamicToolRegistry

Returns the “default value” for a type.

impl DynamicToolProvider for DynamicToolRegistry

fn add_tool( &mut self, name: &str, definition: ToolDefinition, handler: DynamicHandler, )

Register a tool under name. Replaces any existing registration under the same name. Returns the registration’s ToolDefinition for inspection / chaining.

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

Remove a tool from the global registry. Returns true when the tool existed and was removed; false when no such tool was registered.

fn enable_for(&mut self, name: &str, tenant: &str)

Enable name for a specific tenant. The tool must already be in the global registry (use DynamicToolProvider::add_tool first); this method only flips the per-tenant visibility flag.

fn disable_for(&mut self, name: &str, tenant: &str)

Disable name for a specific tenant. Has no effect on the global registry; other tenants keep their visibility.

fn visible_tools(&self, tenant: Option<&str>) -> Vec<ToolDefinition>

List the tools visible to tenant (or, when tenant is None, every globally-registered tool). Useful for diagnostics / REST /tools endpoints.

impl ToolCaller for DynamicToolRegistry

fn call_tool(&self, name: &str, args: &Value) -> Result<Value, ToolError>

Invoke a tool by name with the given JSON args.

impl ToolProvider for DynamicToolRegistry

fn tool_definitions() -> &'static [ToolDefinition]

The compile-time static slice is empty by design — the registry is purely runtime. Servers that need the list call DynamicToolProvider::visible_tools instead.

fn tool_count() -> usize

Number of tools produced by this provider.

fn find_tool(name: &str) -> Option<&'static ToolDefinition>

Look up a tool definition by its name.