Skip to main content

AdkError

adk_rust::error

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 */
}

Expand description

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",
);
assert!(err.is_retryable()); // RateLimited → should_retry = true

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

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>, ) -> AdkError

Available on crate feature tools only.

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

Available on crate feature tools only.

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

Available on crate feature tools only.

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

Available on crate feature tools only.

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

Available on crate feature tools only.

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

Available on crate feature tools only.

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

Available on crate feature tools only.

impl AdkError

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

Available on crate feature tools only.

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

Available on crate feature tools only.

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

Available on crate feature tools only.

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

Available on crate feature tools only.

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

Available on crate feature tools only.

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

Available on crate feature tools only.

impl AdkError

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

Available on crate feature tools only.

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

Available on crate feature tools only.

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

Available on crate feature tools only.

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

Available on crate feature tools only.

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

Available on crate feature tools only.

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

Available on crate feature tools only.

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

Available on crate feature tools only.

impl AdkError

pub fn is_agent(&self) -> bool

Available on crate feature tools only.

pub fn is_model(&self) -> bool

Available on crate feature tools only.

pub fn is_tool(&self) -> bool

Available on crate feature tools only.

pub fn is_session(&self) -> bool

Available on crate feature tools only.

pub fn is_artifact(&self) -> bool

Available on crate feature tools only.

pub fn is_memory(&self) -> bool

Available on crate feature tools only.

pub fn is_config(&self) -> bool

Available on crate feature tools only.

impl AdkError

pub fn is_retryable(&self) -> bool

Available on crate feature tools only.

pub fn is_not_found(&self) -> bool

Available on crate feature tools only.

pub fn is_unauthorized(&self) -> bool

Available on crate feature tools only.

pub fn is_rate_limited(&self) -> bool

Available on crate feature tools only.

pub fn is_timeout(&self) -> bool

Available on crate feature tools only.

impl AdkError

pub fn http_status_code(&self) -> u16

Available on crate feature tools only.

impl AdkError

pub fn to_problem_json(&self) -> Value

Available on crate feature tools only.

Trait Implementations§

impl Debug for AdkError

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

Formats the value using the given formatter. Read more

impl Display for AdkError

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

Formats the value using the given formatter. Read more

impl Error for AdkError

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

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

1.0.0 · Source§

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

1.0.0 · Source§

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. Read more

impl From<AdkError> for EvalError

fn from(err: AdkError) -> EvalError

Converts to this type from the input type.

impl From<AdkError> for RagError

fn from(source: AdkError) -> RagError

Converts to this type from the input type.

impl From<AnthropicApiError> for AdkError

fn from(err: AnthropicApiError) -> AdkError

Converts to this type from the input type.

impl From<AuthError> for AdkError

fn from(err: AuthError) -> AdkError

Converts to this type from the input type.

impl From<ConversionError> for AdkError

fn from(err: ConversionError) -> AdkError

Converts to this type from the input type.

impl From<EvalError> for AdkError

fn from(err: EvalError) -> AdkError

Converts to this type from the input type.

impl From<GraphError> for AdkError

fn from(err: GraphError) -> AdkError

Converts to this type from the input type.

impl From<GuardrailError> for AdkError

fn from(err: GuardrailError) -> AdkError

Converts to this type from the input type.

impl From<IdentityError> for AdkError

fn from(err: IdentityError) -> AdkError

Converts to this type from the input type.

impl From<PaymentsAuthError> for AdkError

fn from(value: PaymentsAuthError) -> AdkError

Converts to this type from the input type.

impl From<PaymentsKernelError> for AdkError

fn from(value: PaymentsKernelError) -> AdkError

Converts to this type from the input type.

impl From<RagError> for AdkError

fn from(err: RagError) -> AdkError

Converts to this type from the input type.

impl From<SharedStateError> for AdkError

fn from(err: SharedStateError) -> AdkError

Converts to this type from the input type.

impl From<SkillError> for AdkError

fn from(err: SkillError) -> AdkError

Converts to this type from the input type.

Auto Trait Implementations§

impl Freeze for AdkError

impl !RefUnwindSafe for AdkError

impl Send for AdkError

impl Sync for AdkError

impl Unpin for AdkError

impl UnsafeUnpin for AdkError

impl !UnwindSafe for AdkError

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> AsErrorSource for T
where T: Error + 'static,

fn as_error_source(&self) -> &(dyn Error + 'static)

For maximum effectiveness, this needs to be called as a method to benefit from Rust’s automatic dereferencing of method receivers.

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> FutureExt for T

fn with_context(self, otel_cx: Context) -> WithContext<Self>

Attaches the provided Context to this type, returning a WithContext wrapper. Read more

fn with_current_context(self) -> WithContext<Self>

Attaches the current Context to this type, returning a WithContext wrapper. Read more

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

impl<T, U> Into<U> for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> IntoEither for T

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more

impl<T> IntoRequest<T> for T

fn into_request(self) -> Request<T>

Wrap the input message T in a tonic::Request

impl<Unshared, Shared> IntoShared<Shared> for Unshared
where Shared: FromUnshared<Unshared>,

fn into_shared(self) -> Shared

Creates a shared type from an unshared type.

impl<L> LayerExt<L> for L

fn named_layer<S>(&self, service: S) -> Layered<<L as Layer<S>>::Service, S>
where L: Layer<S>,

Applies the layer to a service and wraps it in Layered.

impl<T> PolicyExt for T
where T: ?Sized,

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more

impl<T> Same for T

type Output = T

Should always be Self

impl<T> ToString for T
where T: Display + ?Sized,

fn to_string(&self) -> String

Converts the given value to a String. Read more

impl<T> ToStringFallible for T
where T: Display,

fn try_to_string(&self) -> Result<String, TryReserveError>

ToString::to_string, but without panic on OOM.

impl<T, U> TryFrom<U> for T
where U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

fn vzip(self) -> V

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more