Struct ToolSearchContext 

pub struct ToolSearchContext { /* private fields */ }

Context for tracking tool search state during input conversion.

This struct maintains:

• pending_calls: Map of call_id -> tool_search_call items awaiting output
• resolved_tools: Final merged tool list after processing all input items
• priority: Strategy for merging predefined and searched tools

Implementations

impl ToolSearchContext

pub fn new(priority: ToolPriority) -> Self

Create a new context with the given priority strategy.

pub fn register_search_call(&mut self, call_id: &str)

Record that a tool_search_call was initiated with the given id.

pub fn is_registered_search(&self, call_id: &str) -> bool

Check if a call_id corresponds to a registered tool_search_call.

pub fn set_predefined_tools(&mut self, tools: Vec<Tool>)

Set the predefined tools from the request.

This should be called once at the start of processing.

pub fn add_searched_tools(&mut self, tools: Vec<Tool>, call_id: &str)

Add tools from a tool_search_output item.

The tools are collected but not yet merged - merging happens at finalize.

pub fn complete_search(&mut self, call_id: &str)

Mark the tool_search_call as completed (output received).

Currently a no-op since we don’t validate strict call_id matching, but could be used for future validation.

pub fn finalize(self) -> Vec<Tool>

Finalize the context and resolve the final tool list.

This applies the priority strategy to merge predefined and searched tools. Returns the resolved tools and clears internal state.

Note: This method takes self by value and returns an owned Vec<Tool>. Subsequent calls to resolved_tools() will return an empty vec.

pub fn resolved_tools(&self) -> &[Tool]

Get the resolved tools without finalizing (for reading only).

pub fn priority(&self) -> ToolPriority

Get the priority strategy.

pub fn has_pending_searches(&self) -> bool

Check if any searches are still pending (have output without a matching search).

pub fn predefined_count(&self) -> usize

Get count of predefined tools.

pub fn searched_count(&self) -> usize

Get count of searched tools.

Trait Implementations

impl Clone for ToolSearchContext

fn clone(&self) -> ToolSearchContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ToolSearchContext

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

Formats the value using the given formatter.