Struct Registry 

pub struct Registry {
    pub warnings: Vec<String>,
    /* private fields */
}

The registry.

Fields

warnings: Vec<String>

Non-fatal findings from the build (collisions, missing profile tools).

Implementations

impl Registry

pub fn build( settings: &Settings, servers: &[ServerTools], ) -> Result<Registry, Vec<String>>

Build from settings + the connected servers’ tool lists. Errors are the RFC 0028 §4 startup validation failures (unknown override target, server not declared, tool not advertised, mapping does not compile, disabled ∩ overrides ≠ ∅, disabling an unknown tool).

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

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

pub fn servers(&self) -> &[String]

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn iter(&self) -> impl Iterator<Item = &ToolSpec>

pub fn allowed(&self, caller: &Caller<'_>, name: &str) -> bool

Whether caller may call name (RFC 0028 §3 grants + RFC 0029 §2).

pub fn defs_for( &self, caller: &Caller<'_>, select: Option<&AgentTools>, ) -> Vec<ToolDef>

The LLM-facing definitions for a caller, filtered by the agent’s tool selection (agent.tools.internal|mcp|code) when given.

pub fn validate_args(&self, name: &str, args: &Value) -> Result<(), String>

Validate call arguments against the tool’s input schema.

pub fn validate_result(&self, name: &str, result: &Value) -> Result<(), String>

Validate a result against the tool’s output schema (when it has one).

pub fn route(&self, name: &str) -> Option<Route<'_>>

Where a call goes (None = unknown or unavailable).

pub fn map_args(m: &Mapping, args: &Value, ctx: &Value) -> Result<Value, String>

Render a mapped tool’s MCP arguments from the internal call’s args and the call context ({instance, run?, ctx?, principal?}). Without an args template the internal args pass through unchanged.

pub fn map_result(m: &Mapping, result_ctx: &Value) -> Result<Value, String>

Map an MCP CallToolResult (as the {"result": …} context the store adapter also uses) back to the internal output. Without a result template: structuredContent, else the text parsed as JSON, else the text.

pub fn tags_of(&self, names: &[String]) -> Vec<TrifectaTag>

The trifecta tags a set of tool names carries (for the gate).

pub fn status(&self) -> Value

A status view (agent://tools).

Trait Implementations

impl Clone for Registry

fn clone(&self) -> Registry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Registry

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

Formats the value using the given formatter.

impl Default for Registry

fn default() -> Registry

Returns the “default value” for a type.