Struct Fetch 

pub struct Fetch { /* private fields */ }

HTTP GET a URL with an SSRF guard.

Rejects non-http(s) schemes, rejects URLs whose DNS resolution returns any IP in the loopback / private / link-local / unspecified / multicast ranges, and explicitly blocklists the cloud metadata endpoints. Redirects are disabled on the underlying ureq agent so attackers cannot bypass the resolved-IP check via 302 Location: http://169.254.169.254/….

Implementations

impl Fetch

pub fn new() -> Self

pub fn with_allow_hosts(self, hosts: Vec<String>) -> Self

Restrict fetches to an explicit host allowlist. When set, any URL whose host (case-insensitive) is not in the list is rejected before DNS resolution.

pub fn with_max_bytes(self, n: usize) -> Self

Set the maximum number of response bytes to read. Defaults to 64KB.

Trait Implementations

impl Default for Fetch

fn default() -> Self

Returns the “default value” for a type.

impl Tool for Fetch

fn name(&self) -> &str

The tool’s name — used by the model to invoke it and for dispatch.

fn description(&self) -> &str

Human-readable description sent to the model as part of the tool list. This is the primary steering mechanism for tool selection.

fn schema(&self) -> Value

JSON Schema describing the tool’s arguments.

fn call(&self, args: Value) -> Result<String, String>

Execute the tool synchronously. Return a string result or an error message. Callers must enforce result-byte caps and envelope framing before persisting or feeding back to the model.