Struct ToolRegistry 

pub struct ToolRegistry { /* private fields */ }

Request-scoped registry built from RequestPayload.tools. Maps the name the LLM sees → routing metadata.

Implementations

impl ToolRegistry

pub async fn build_with_handlers( tools: &mut [ResponsesTool], executors: &mut GatewayExecutors, ) -> Result<Self, ToolError>

Build a registry from declared tools and attach gateway handlers for dispatchable tool types.

Errors

Returns ToolError::Config when Codex namespace member flattening would collide with another declared tool name, when discovered MCP tools derive the same internal model-visible name, or when an MCP declaration is itself invalid (for example, a request tries to override a gateway-configured server’s connection). Transient MCP discovery failures (the server could not be reached) are not returned as errors; they are recorded as failed McpListTools metadata so the rest of the request can proceed.

Panics

Panics if serialization of a tool param struct fails, which cannot happen for the types defined in this module (#[derive(Serialize)] on plain structs).

pub fn lookup(&self, tool_name: &str) -> Option<&ToolEntry>

pub fn is_empty(&self) -> bool

pub fn len(&self) -> usize

pub fn contains_mcp_server_label(&self, server_label: &str) -> bool

pub fn restore_final_payload_output(&self, output: &mut [OutputItem])

pub fn restore_stream_event_wire(&self, wire: &mut WireEvent) -> bool

pub fn gateway_owned<'a>( &self, calls: &'a [FunctionToolCall], ) -> Vec<&'a FunctionToolCall>

Returns the subset of calls whose names map to gateway-owned tools.

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

pub fn client_owned<'a>( &self, calls: &'a [FunctionToolCall], ) -> Vec<&'a FunctionToolCall>

Returns the subset of calls whose names map to client-owned tools (Function, Codex namespace members, or unknown names).

pub async fn dispatch( &self, call: &FunctionToolCall, ) -> Option<GatewayDispatchResult>

Trait Implementations

impl Debug for ToolRegistry

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

Formats the value using the given formatter.

impl Default for ToolRegistry

fn default() -> ToolRegistry

Returns the “default value” for a type.