Struct WebSearchTool 

pub struct WebSearchTool { /* private fields */ }

Web search tool for searching the internet. Supports multiple providers: DuckDuckGo (free), Brave (requires API key), SearXNG (self-hosted, requires instance URL).

The Brave API key is resolved lazily at execution time: if the boot-time key is missing or still encrypted, the tool re-reads config.toml, decrypts the [web_search] brave_api_key field, and uses the result. This ensures that keys set or rotated after boot, and encrypted keys, are correctly picked up.

Implementations

impl WebSearchTool

pub fn new( provider: String, brave_api_key: Option<String>, max_results: usize, timeout_secs: u64, ) -> Self

pub fn new_with_config( provider: String, brave_api_key: Option<String>, searxng_instance_url: Option<String>, max_results: usize, timeout_secs: u64, config_path: PathBuf, secrets_encrypt: bool, ) -> Self

Create a WebSearchTool with config-reload and decryption support.

config_path is the path to config.toml so the tool can re-read the Brave API key at execution time. secrets_encrypt controls whether the key is decrypted via SecretStore.

Trait Implementations

impl Tool for WebSearchTool

fn name(&self) -> &str

Tool name (used in LLM function calling)

fn description(&self) -> &str

Human-readable description

fn parameters_schema(&self) -> Value

JSON schema for parameters

fn execute<'life0, 'async_trait>( &'life0 self, args: Value, ) -> Pin<Box<dyn Future<Output = Result<ToolResult>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Execute the tool with given arguments

fn execute_with_progress<'life0, 'life1, 'async_trait>( &'life0 self, args: Value, _sink: &'life1 dyn ProgressSink, ) -> Pin<Box<dyn Future<Output = Result<ToolResult>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Execute the tool with a progress-notification sink.

fn spec(&self) -> ToolSpec

Get the full spec for LLM registration