Struct FailTool 

pub struct FailTool;

A tool that always fails with an error.

Useful for testing error handling in agent loops, tool budgets, and error recovery strategies.

Example

use traitclaw_test_utils::tools::FailTool;
use traitclaw_core::traits::tool::Tool;

let result = FailTool.execute(traitclaw_test_utils::tools::FailInput {
    message: None,
}).await;
assert!(result.is_err());

Trait Implementations

impl Tool for FailTool

type Input = FailInput

Input type — must be deserializable from JSON and have a JSON Schema.

type Output = Value

Output type — must be serializable to JSON.

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

The unique name of this tool.

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

A description of what this tool does (sent to the LLM).

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

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

Execute this tool with the given input.

fn schema(&self) -> ToolSchema

Generate the JSON Schema for this tool’s parameters.