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 fn build(tools: &[ResponsesTool]) -> Result<Self, ToolError>

Build a registry from the declared tools.

Duplicate tool names result in last-write-wins, logged at warn level.

Errors

Returns ToolError::Config when Codex namespace member flattening would collide with another declared tool name.

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 build_with_handlers( tools: &[ResponsesTool], handler_for: impl FnMut(ToolType) -> Option<Arc<dyn GatewayExecutor>>, ) -> 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.

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 restore_final_payload_output(&self, output: &mut [OutputItem])

pub fn restore_stream_event_value(&self, value: &mut Value) -> 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.