Struct WebSearchTool 

pub struct WebSearchTool { /* private fields */ }

WebSearch tool. Stateless over the network (DDG) but tracks per-instance cooldown, request cap, and short-lived result cache to avoid hammering DDG’s HTML endpoint and triggering anti-bot challenges.

Implementations

impl WebSearchTool

pub fn new() -> Self

pub fn with_config(config: WebSearchConfig) -> Self

Construct a tool with an explicit configuration. The config drives the result-count default, request timeout, cooldown, cache TTL, and session-wide request cap.

pub fn set_config(&self, config: WebSearchConfig)

Apply a new configuration (e.g., after vtcode.toml reload).

pub fn reset(&self)

Reset the in-process state (cooldown, counter, cache). Tests use this.

Trait Implementations

impl Clone for WebSearchTool

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for WebSearchTool

fn default() -> Self

Returns the “default value” for a type.

impl Tool for WebSearchTool

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

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

Execute the tool with given arguments

fn name(&self) -> &str

Get the tool’s name

fn description(&self) -> &str

Get the tool’s description

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

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

Execute with dual-channel output (LLM summary + UI content)

fn validate_args(&self, _args: &Value) -> Result<()>

Validate arguments before execution

fn parameter_schema(&self) -> Option<Value>

Optional JSON schema for the tool’s parameters, if available.

fn config_schema(&self) -> Option<Value>

Optional JSON schema for the tool’s configuration, if available.

fn state_schema(&self) -> Option<Value>

Optional JSON schema describing state persisted by the tool, if any.

fn prompt_path(&self) -> Option<Cow<'static, str>>

Optional prompt path metadata (e.g., for loading companion prompts).

fn default_permission(&self) -> ToolPolicy

Default execution policy for this tool.

fn allow_patterns(&self) -> Option<&'static [&'static str]>

Optional allowlist patterns the tool considers pre-approved.

fn deny_patterns(&self) -> Option<&'static [&'static str]>

Optional denylist patterns the tool considers blocked.

fn is_mutating(&self) -> bool

Whether this tool mutates state (files, environment, etc).

fn is_parallel_safe(&self) -> bool

Whether this tool is safe to run in parallel with other tools.

fn kind(&self) -> &'static str

Get the kind/category of this tool for matching against policies.

fn matches_kind(&self, pattern: &str) -> bool

Check if this tool matches a given kind pattern.

fn resource_hints(&self, _args: &Value) -> Vec<String>

Resources this tool might access (paths, URLs, etc).

fn execution_cost(&self) -> u8

Estimated execution cost (1-10 scale).