Struct Registry 

pub struct Registry { /* private fields */ }

Thread-safe registry of callable tools.

Optionally wires the HITL stages (per locked decision D10): sensitivity → (if RequireApproval) human approval → invoke. The authorization stage is owned by the boundary (rskit-mcp, etc.) and is not enforced here; this preserves module layering.

Implementations

impl Registry

pub fn new() -> Self

Create a new empty registry.

pub fn with_sensitivity_evaluator( self, evaluator: Arc<dyn SensitivityEvaluator>, ) -> Self

Inject a sensitivity evaluator. When unset, no sensitivity checks run.

pub fn with_human_approval(self, approval: Arc<dyn HumanApproval>) -> Self

Inject a human-approval gate. When unset, RequireApproval decisions are treated as denials.

pub fn register(&self, tool: Box<dyn Callable>) -> AppResult<()>

Register a tool. Returns error on empty name or duplicate.

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

Get a tool by name.

pub fn list(&self) -> Vec<Definition>

List all registered tool definitions.

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

List all registered tool names.

pub async fn call( &self, name: &str, ctx: &Context, input: ToolInput, ) -> AppResult<ToolResult>

Call a tool by name with a context. Runs the HITL stages (sensitivity → human approval) if configured before invoking the tool.

pub async fn call_validated( &self, name: &str, ctx: &Context, input: ToolInput, ) -> AppResult<ToolResult>

Call a tool after the caller has already validated the input schema.

This still runs HITL stages before invoking the tool, but skips the schema validation pass performed by Registry::call.

pub fn search(&self, query: &str) -> Vec<Definition>

Search for tools whose name or description contains the query (case-insensitive).

pub fn filter_by_execution_hint(&self, hint: ExecutionHint) -> Vec<Definition>

Filter tools by execution_hint annotation.

pub async fn call_batch( &self, calls: Vec<(&str, ToolInput)>, ctx: &Context, options: BatchOptions, ) -> Vec<AppResult<ToolResult>>

Call multiple tools with caller-supplied concurrency policy. Each call goes through the same HITL stages as Registry::call.

pub fn len(&self) -> usize

Number of registered tools.

pub fn is_empty(&self) -> bool

Whether the registry is empty.

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

Check if a tool is registered.

Trait Implementations

impl Component for Registry

fn name(&self) -> &'static str

Stable identifier used in logs and health responses.

fn start<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = AppResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Start the component.

fn stop<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = AppResult<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Stop the component gracefully.

fn health(&self) -> Health

Return an instantaneous health snapshot.

impl Default for Registry

fn default() -> Self

Returns the “default value” for a type.