Enum ToolError 

pub enum ToolError {
    NotFound {
        name: String,
    },
    InvalidArguments {
        tool: String,
        reason: String,
    },
    ExecutionFailed {
        tool: String,
        message: String,
    },
    Timeout {
        tool: String,
        timeout_ms: u64,
    },
    Serialization(Error),
    AuditFailed(String),
    Unavailable {
        name: String,
        reason: String,
    },
}

Error types for tool execution with precise variants for each failure mode.

Example

use vex_llm::ToolError;

let err = ToolError::not_found("unknown_tool");
assert!(err.to_string().contains("unknown_tool"));

Variants

NotFound

Tool not found in registry

Fields

name: String

Name of the tool that was requested

InvalidArguments

Invalid arguments provided to tool

Fields

tool: String

Name of the tool

reason: String

Human-readable reason for validation failure

ExecutionFailed

Tool execution failed

Fields

tool: String

Name of the tool

message: String

Error message (sanitized)

Timeout

Tool execution exceeded timeout

Fields

tool: String

Name of the tool

timeout_ms: u64

Timeout in milliseconds

Serialization(Error)

JSON serialization/deserialization error

AuditFailed(String)

Audit logging failed (non-fatal, logged but doesn’t stop execution)

Unavailable

Tool is disabled or unavailable

Fields

name: String

Name of the tool

reason: String

Reason for unavailability

Implementations

impl ToolError

pub fn not_found(name: impl Into<String>) -> Self

Create a NotFound error

Example

use vex_llm::ToolError;
let err = ToolError::not_found("my_tool");

pub fn invalid_args(tool: impl Into<String>, reason: impl Into<String>) -> Self

Create an InvalidArguments error with context

Security Note

The reason should not contain raw user input to prevent information leakage

pub fn execution_failed( tool: impl Into<String>, message: impl Into<String>, ) -> Self

Create an ExecutionFailed error

Security Note

The message should be sanitized before passing to this constructor

pub fn timeout(tool: impl Into<String>, timeout_ms: u64) -> Self

Create a Timeout error

pub fn unavailable(name: impl Into<String>, reason: impl Into<String>) -> Self

Create an Unavailable error

pub fn is_retryable(&self) -> bool

Check if this error is recoverable (can retry)

pub fn should_audit(&self) -> bool

Check if this error should be logged to audit trail

Trait Implementations

impl Debug for ToolError

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for ToolError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for ToolError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for ToolError

fn from(source: Error) -> Self

Converts to this type from the input type.