Struct AdkError 

pub struct AdkError {
    pub component: ErrorComponent,
    pub category: ErrorCategory,
    pub code: &'static str,
    pub message: String,
    pub retry: RetryHint,
    pub details: Box<ErrorDetails>,
    /* private fields */
}

Unified structured error type for all ADK-Rust operations.

Migration from enum syntax

Before (0.4.x enum):

// Construction
Err(AdkError::Model("rate limited".into()))
// Matching
matches!(err, AdkError::Model(_))

After (0.5.x struct):

use adk_core::{AdkError, ErrorComponent, ErrorCategory};

// Structured construction
let err = AdkError::new(
    ErrorComponent::Model,
    ErrorCategory::RateLimited,
    "model.openai.rate_limited",
    "rate limited",
);

// Backward-compat construction (for migration)
let err = AdkError::model("rate limited");

// Checking
assert!(err.is_model());
assert!(err.is_retryable()); // reads retry.should_retry

Fields

component: ErrorComponent

category: ErrorCategory

code: &'static str

message: String

retry: RetryHint

details: Box<ErrorDetails>

Implementations

impl AdkError

pub fn new( component: ErrorComponent, category: ErrorCategory, code: &'static str, message: impl Into<String>, ) -> Self

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

pub fn with_retry(self, retry: RetryHint) -> Self

pub fn with_details(self, details: ErrorDetails) -> Self

pub fn with_upstream_status(self, status_code: u16) -> Self

pub fn with_request_id(self, request_id: impl Into<String>) -> Self

pub fn with_provider(self, provider: impl Into<String>) -> Self

impl AdkError

pub fn not_found( component: ErrorComponent, code: &'static str, message: impl Into<String>, ) -> Self

pub fn rate_limited( component: ErrorComponent, code: &'static str, message: impl Into<String>, ) -> Self

pub fn unauthorized( component: ErrorComponent, code: &'static str, message: impl Into<String>, ) -> Self

pub fn internal( component: ErrorComponent, code: &'static str, message: impl Into<String>, ) -> Self

pub fn timeout( component: ErrorComponent, code: &'static str, message: impl Into<String>, ) -> Self

pub fn unavailable( component: ErrorComponent, code: &'static str, message: impl Into<String>, ) -> Self

impl AdkError

pub fn agent(message: impl Into<String>) -> Self

pub fn model(message: impl Into<String>) -> Self

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

pub fn session(message: impl Into<String>) -> Self

pub fn memory(message: impl Into<String>) -> Self

pub fn config(message: impl Into<String>) -> Self

pub fn artifact(message: impl Into<String>) -> Self

impl AdkError

pub fn is_agent(&self) -> bool

pub fn is_model(&self) -> bool

pub fn is_tool(&self) -> bool

pub fn is_session(&self) -> bool

pub fn is_artifact(&self) -> bool

pub fn is_memory(&self) -> bool

pub fn is_config(&self) -> bool

impl AdkError

pub fn is_retryable(&self) -> bool

pub fn is_not_found(&self) -> bool

pub fn is_unauthorized(&self) -> bool

pub fn is_rate_limited(&self) -> bool

pub fn is_timeout(&self) -> bool

impl AdkError

pub fn http_status_code(&self) -> u16

impl AdkError

pub fn to_problem_json(&self) -> Value

Trait Implementations

impl Debug for AdkError

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

Formats the value using the given formatter.

impl Display for AdkError

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

Formats the value using the given formatter.

impl Error for AdkError

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<IdentityError> for AdkError

fn from(err: IdentityError) -> Self

Converts to this type from the input type.