Struct ToolDefinition 

pub struct ToolDefinition {
    pub tool_type: String,
    pub function: Option<FunctionDefinition>,
    pub web_search: Option<Value>,
    pub defer_loading: Option<bool>,
    pub namespace: Option<ToolNamespace>,
    /* private fields */
}

Universal tool definition that matches OpenAI/Anthropic/Gemini specifications Based on official API documentation from Context7

Fields

tool_type: String

The type of tool: “function”, “apply_patch” (GPT-5.1), “shell” (GPT-5.1), or “custom” (GPT-5 freeform) Also supports provider-native and hosted tool types like:

• “tool_search” (OpenAI hosted tool search)
• “file_search” and “mcp” (OpenAI Responses hosted tools)
• Anthropic tool search revisions:
• “tool_search_tool_regex_20251119”, “tool_search_tool_bm25_20251119”
• “web_search_20260209” (and other web_search_* revisions)
• “code_execution_20250825” (and other code_execution_* revisions)
• “memory_20250818” (and other memory_* revisions)

function: Option<FunctionDefinition>

Function definition containing name, description, and parameters Used for “function”, “apply_patch”, and “custom” types

web_search: Option<Value>

Provider-native web search configuration payload (e.g. Z.AI web_search tool).

defer_loading: Option<bool>

When true, the tool is deferred and only loaded when discovered via tool search (Anthropic advanced-tool-use beta) This enables dynamic tool discovery for large tool catalogs (10k+ tools)

namespace: Option<ToolNamespace>

Optional namespace grouping for deferred tools. When present and defer_loading is true, only this namespace metadata is sent upfront instead of the full tool definition.

Implementations

impl ToolDefinition

pub fn function( name: String, description: String, parameters: Value, ) -> ToolDefinition

Create a new tool definition with function type

pub fn with_strict(self, strict: bool) -> ToolDefinition

Set whether the tool should be considered strict (Anthropic structured tool use)

pub fn with_defer_loading(self, defer: bool) -> ToolDefinition

Set whether the tool should be deferred (Anthropic tool search)

pub fn with_namespace(self, namespace: ToolNamespace) -> ToolDefinition

Assign this tool to a namespace for grouped deferred loading. When both defer_loading and namespace are set, only the namespace metadata is sent upfront; the full definition is loaded on search.

pub fn tool_search(algorithm: ToolSearchAlgorithm) -> ToolDefinition

Create a tool search tool definition for Anthropic’s advanced-tool-use beta Supports regex and bm25 search algorithms

pub fn hosted_tool_search() -> ToolDefinition

Create an OpenAI hosted tool search definition.

pub fn anthropic_memory() -> ToolDefinition

Create an Anthropic native memory tool definition.

pub fn apply_patch(description: String) -> ToolDefinition

Create a new apply_patch tool definition (GPT-5.1 specific) The apply_patch tool lets models create, update, and delete files using VT Code structured diffs

pub fn custom(name: String, description: String) -> ToolDefinition

Create a new custom tool definition for freeform function calling (GPT-5 specific) Allows raw text payloads without JSON wrapping

pub fn grammar(syntax: String, definition: String) -> ToolDefinition

Create a new grammar tool definition for context-free grammar constraints (GPT-5 specific) Ensures model output matches predefined syntax

pub fn web_search(config: Value) -> ToolDefinition

Create a provider-native web search tool definition.

pub fn google_maps(config: Value) -> ToolDefinition

Create a Gemini Google Maps grounding tool definition.

pub fn url_context(config: Value) -> ToolDefinition

Create a Gemini URL Context tool definition.

pub fn function_name(&self) -> &str

Get the function name for easy access

pub fn description(&self) -> &str

Get the description for easy access

pub fn validate(&self) -> Result<(), String>

Validate that this tool definition is properly formed

pub fn is_tool_search(&self) -> bool

Returns true if this is a tool search tool type

pub fn is_anthropic_web_search(&self) -> bool

Returns true when the tool is an Anthropic native web search tool revision.

Trait Implementations

impl Clone for ToolDefinition

fn clone(&self) -> ToolDefinition

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolDefinition

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ToolDefinition

fn deserialize<__D>( __deserializer: __D, ) -> Result<ToolDefinition, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ToolDefinition

fn eq(&self, other: &ToolDefinition) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ToolDefinition

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ToolDefinition