Struct URLFetchTool 

pub struct URLFetchTool { /* private fields */ }

Web page fetching tool

Implementations

impl URLFetchTool

pub fn new() -> Self

Creates a web fetching tool (SSRF protection enabled by default).

The HTTP client is built per request inside guarded_get so the validated DNS answers can be pinned onto it (A3 DNS-rebinding closure).

pub fn with_allow_private_ips(self, allow: bool) -> Self

Allow requests to private/internal IP addresses (SSRF opt-in).

Trait Implementations

impl BaseTool for URLFetchTool

fn name(&self) -> &str

Returns the tool name.

fn description(&self) -> &str

Returns the tool description.

fn run<'life0, 'async_trait>( &'life0 self, input: String, ) -> Pin<Box<dyn Future<Output = Result<String, ToolError>> + Send + 'async_trait>>

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

Execute the tool (string version).

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

Returns the input JSON Schema.

fn return_direct(&self) -> bool

Whether to return result directly to user.

fn risk(&self) -> ToolRiskProfile

Declared Rule-of-Two risk profile (A2, v0.22.1).

fn handle_error<'life0, 'async_trait>( &'life0 self, error: ToolError, ) -> Pin<Box<dyn Future<Output = String> + Send + 'async_trait>>

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

Handle execution error.

impl Default for URLFetchTool

fn default() -> Self

Returns the “default value” for a type.

impl Tool for URLFetchTool

type Input = URLFetchInput

Input type (must support deserialization and JSON Schema).

type Output = URLFetchOutput

Output type (must support serialization).

fn invoke<'life0, 'async_trait>( &'life0 self, input: Self::Input, ) -> Pin<Box<dyn Future<Output = Result<Self::Output, ToolError>> + Send + 'async_trait>>

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

Execute the tool.

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

Returns the input JSON Schema.