Struct HTTPTool 

pub struct HTTPTool { /* private fields */ }

HTTP request tool (GET/POST) with SSRF protection.

Implementations

impl HTTPTool

pub fn new() -> Self

Creates an HTTP tool with a 30s timeout and SSRF protection enabled.

pub fn with_timeout(timeout: Duration) -> Self

Creates an HTTP tool with a custom timeout (SSRF protection enabled).

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

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

pub async fn get(&self, url: &str) -> Result<String, ToolError>

Sends a GET request, following redirects with SSRF checks per hop.

pub async fn post(&self, url: &str, body: Value) -> Result<String, ToolError>

Sends a POST request with a JSON body (single-hop SSRF check).

Trait Implementations

impl BaseTool for HTTPTool

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 HTTPTool

fn default() -> Self

Returns the “default value” for a type.