Struct UnifiedToolError 

pub struct UnifiedToolError {
    pub kind: UnifiedErrorKind,
    pub severity: ErrorSeverity,
    pub user_message: String,
    pub debug_context: Option<DebugContext>,
    pub source: Option<Error>,
}

Unified tool error envelope

Fields

kind: UnifiedErrorKind

Error classification

severity: ErrorSeverity

Severity level

user_message: String

User-facing message (safe to display)

debug_context: Option<DebugContext>

Debug context (tool name, args, etc.)

source: Option<Error>

Original error (for chaining)

Implementations

impl UnifiedToolError

pub fn new(kind: UnifiedErrorKind, user_message: impl Into<String>) -> Self

Create a new unified error

pub fn with_context(self, ctx: DebugContext) -> Self

Add debug context

pub fn with_source(self, err: Error) -> Self

Add source error

pub fn with_tool_name(self, name: &str) -> Self

Add tool name to debug context

pub fn with_invocation_id(self, id: ToolInvocationId) -> Self

Add invocation ID to debug context

pub fn with_duration(self, duration: Duration) -> Self

Add duration metadata

pub fn is_retryable(&self) -> bool

Check if error is retryable

pub fn is_llm_mistake(&self) -> bool

Check if this is an LLM argument error (should not count toward circuit breaker)

pub fn category(&self) -> ErrorCategory

Return the canonical VT Code error category for this tool error.

Trait Implementations

impl Debug for UnifiedToolError

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

Formats the value using the given formatter.

impl Display for UnifiedToolError

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

Formats the value using the given formatter.

impl Error for UnifiedToolError

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<ToolCallError> for UnifiedToolError

Convert from handlers::ToolCallError

fn from(err: ToolCallError) -> Self

Converts to this type from the input type.

impl From<ToolError> for UnifiedToolError

Convert from handlers::sandboxing::ToolError

fn from(err: ToolError) -> Self

Converts to this type from the input type.

impl From<UnifiedToolError> for VtCodeError

fn from(err: UnifiedToolError) -> Self

Converts to this type from the input type.