Struct VtCodeError 

pub struct VtCodeError {
    pub category: ErrorCategory,
    pub code: ErrorCode,
    pub message: String,
    pub context: Option<String>,
    pub retry_after_ms: Option<u64>,
    pub source: Option<Box<dyn Error + Send + Sync>>,
}

Core error type for VT Code operations.

Uses thiserror::Error for automatic std::error::Error implementation and provides clear error messages with context.

Fields

category: ErrorCategory

Error category for categorization and handling.

code: ErrorCode

Machine-readable error code.

message: String

Human-readable error message.

context: Option<String>

Optional context for debugging.

retry_after_ms: Option<u64>

Optional backoff hint for the next retry attempt in milliseconds.

source: Option<Box<dyn Error + Send + Sync>>

Optional source error for chained errors.

Implementations

impl VtCodeError

pub fn new<S: Into<String>>( category: ErrorCategory, code: ErrorCode, message: S, ) -> Self

Create a new error with the given category, code, and message.

pub fn with_context<S: Into<String>>(self, context: S) -> Self

Add context to the error.

pub fn with_retry_after(self, retry_after: Duration) -> Self

Add a retry-after hint to the error.

pub fn with_source<E: Error + Send + Sync + 'static>(self, source: E) -> Self

Set the source error for error chaining.

pub fn retry_after(&self) -> Option<Duration>

Returns the retry-after hint as a duration when present.

pub const fn is_retryable(&self) -> bool

Returns whether the error can be retried safely.

pub fn retryability(&self) -> Retryability

Returns the retry strategy for this error category.

pub fn input<S: Into<String>>(code: ErrorCode, message: S) -> Self

Convenience method for input errors.

pub fn execution<S: Into<String>>(code: ErrorCode, message: S) -> Self

Convenience method for execution errors.

pub fn network<S: Into<String>>(code: ErrorCode, message: S) -> Self

Convenience method for network errors.

pub fn llm<S: Into<String>>(code: ErrorCode, message: S) -> Self

Convenience method for LLM errors.

pub fn config<S: Into<String>>(code: ErrorCode, message: S) -> Self

Convenience method for config errors.

pub fn security<S: Into<String>>(code: ErrorCode, message: S) -> Self

Convenience method for security errors.

pub fn system<S: Into<String>>(code: ErrorCode, message: S) -> Self

Convenience method for system errors.

pub fn internal<S: Into<String>>(code: ErrorCode, message: S) -> Self

Convenience method for internal errors.

pub fn from_category<S: Into<String>>( category: ErrorCategory, message: S, ) -> Self

Create an error from a canonical category using the default error code.

Trait Implementations

impl Debug for VtCodeError

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for VtCodeError

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for VtCodeError

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

Formats the value using the given formatter.

impl Error for VtCodeError

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 VtCodeError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for VtCodeError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for VtCodeError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for VtCodeError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<LLMError> for VtCodeError

fn from(err: LLMError) -> Self

Converts to this type from the input type.

impl From<ToolExecutionError> for VtCodeError

fn from(err: ToolExecutionError) -> 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.

impl Serialize for VtCodeError

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.