Struct WebFetchTool 

pub struct WebFetchTool { /* private fields */ }

Tool that fetches a URL and returns its content as plain text.

HTTP URLs are automatically upgraded to HTTPS. Cross-host redirects are reported back to the caller. Results are cached per URL for 15 minutes.

Implementations

impl WebFetchTool

pub fn new() -> Self

Trait Implementations

impl Default for WebFetchTool

fn default() -> Self

Returns the “default value” for a type.

impl Tool for WebFetchTool

fn definition(&self) -> ToolDefinition

Describe the tool’s name, prose description, and JSON-schema input.

fn prompt_text(&self) -> Option<&'static str>

Optional detailed usage instructions injected into the system prompt. Return None if the tool has no extra behavioral guidance.

fn is_concurrency_safe(&self, _: &Value) -> bool

Whether the tool is safe to run concurrently with other invocations.

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

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

Execute the tool. Errors are surfaced as is_error: true tool results rather than aborting the turn, so the model can try to recover.

fn validate<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _arguments: &'life1 Value, _context: &'life2 ToolContext, ) -> Pin<Box<dyn Future<Output = Result<(), AgentError>> + Send + 'async_trait>>

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

Validate raw arguments before the permission check runs.

fn check_permission<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _arguments: &'life1 Value, _context: &'life2 ToolContext, ) -> Pin<Box<dyn Future<Output = Result<PermissionDecision, AgentError>> + Send + 'async_trait>>

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

Decide whether the call is allowed, denied, or needs human approval.

fn interrupt_behavior(&self) -> InterruptBehavior

How the tool wants to be interrupted.

fn invocation_detail(&self, arguments: &Value) -> String

Return a human-readable summary of the invocation from its arguments.