Enum Error 

pub enum Error {
    Http(Error),
    Json(Error),
    Config(String),
    Api {
        status: Option<u16>,
        message: String,
    },
    Stream(String),
    Tool(String),
    InvalidInput(String),
    Timeout,
    Other(String),
}

Errors from configuration, transport, stream decoding, and tool execution.

reqwest::Error and serde_json::Error convert automatically through ?.

Variants

Http(Error)

A reqwest transport error, including connection failures and timeouts.

Json(Error)

A serde JSON serialization or deserialization error.

Config(String)

Invalid SDK configuration.

Api

A model API error with an optional structured HTTP status.

Use Error::api_status when a status is available. Retry classification uses that field, never status-like text in the message.

Fields

status: Option<u16>

HTTP status code, when the error originated from an HTTP response.

message: String

Error message or response body reported by the server.

Stream(String)

An SSE or stream-processing error.

Tool(String)

A tool lookup or execution error.

InvalidInput(String)

Invalid input to an SDK operation.

Timeout

An explicit SDK timeout error.

Other(String)

An error without a more specific category.

Implementations

impl Error

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

Creates a configuration error.

pub fn api(msg: impl Into<String>) -> Self

Creates an API error without a status.

It is non-retryable regardless of the message. Use api_status when the HTTP status is known.

pub fn api_status(status: u16, msg: impl Into<String>) -> Self

Create a new API error from an HTTP error response.

Prefer this over Error::api whenever a status code is available: retry classification reads Error::status_code, and an error built without a status is treated as non-retryable no matter what its message says.

Arguments

• status - HTTP status code from the response
• msg - Response body or error message from the API server

Example

use open_agent::Error;

let err = Error::api_status(429, "Rate limit exceeded");
assert_eq!(err.to_string(), "API error 429: Rate limit exceeded");
assert_eq!(err.status_code(), Some(429));

pub fn status_code(&self) -> Option<u16>

Returns the status carried by Error::Api, or None.

No other variant exposes a status through this method.

pub fn stream(msg: impl Into<String>) -> Self

Creates a stream-processing error.

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

Creates a tool execution error.

pub fn invalid_input(msg: impl Into<String>) -> Self

Creates an invalid-input error.

pub fn other(msg: impl Into<String>) -> Self

Creates an uncategorized error.

pub fn timeout() -> Self

Creates an explicit timeout error.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.