Enum AgentError 

#[non_exhaustive]
pub enum AgentError {
    Session(SessionError),
    Tool(ToolError),
    Llm(LlmError),
    State(StateError),
    InvalidOutput {
        expected: &'static str,
        reason: String,
        text: String,
    },
    UnknownAgent(String),
    TransferRequested(String),
    TransferFailed(String),
    SessionClosed,
    Timeout,
    Config(String),
    Other(String),
}

Errors that can occur during agent execution.

A model failure arrives as AgentError::Llm with its kind intact, so a caller can branch on it:

use gemini_adk_rs::error::AgentError;
use gemini_adk_rs::llm::LlmError;

let err = AgentError::from(LlmError::Api { status: 429, message: "slow down".into() });
assert!(err.as_llm().is_some_and(LlmError::is_rate_limited));

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Session(SessionError)

A wire-level session error (WebSocket, auth, setup).

Tool(ToolError)

A tool execution error.

Llm(LlmError)

The model call failed; the LlmError says how.

State(StateError)

Reading or writing session state failed.

InvalidOutput

The model’s reply did not match the requested output type, even after it was asked to correct it.

Fields

expected: &'static str

The Rust type the reply had to deserialize into.

reason: String

Why it did not.

text: String

The reply as received.

UnknownAgent(String)

The requested agent was not found in the registry.

TransferRequested(String)

The agent requested a transfer to another agent.

TransferFailed(String)

An agent transfer was attempted but failed.

SessionClosed

The underlying session has been closed.

Timeout

The operation timed out.

Config(String)

A configuration error.

Other(String)

A catch-all for other errors.

Implementations

impl AgentError

pub fn as_llm(&self) -> Option<&LlmError>

The model error behind this one, if a model call failed.

Trait Implementations

impl Debug for AgentError

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

Formats the value using the given formatter.

impl Display for AgentError

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

Formats the value using the given formatter.

impl Error for AgentError

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<ConfigError> for AgentError

fn from(err: ConfigError) -> AgentError

Converts to this type from the input type.

impl From<LlmError> for AgentError

fn from(source: LlmError) -> AgentError

Converts to this type from the input type.

impl From<SessionError> for AgentError

fn from(source: SessionError) -> AgentError

Converts to this type from the input type.

impl From<StateError> for AgentError

fn from(source: StateError) -> AgentError

Converts to this type from the input type.

impl From<ToolError> for AgentError

fn from(source: ToolError) -> AgentError

Converts to this type from the input type.