Enum Error 

#[non_exhaustive]
pub enum Error {
    AgentNotStarted,
    BackendError {
        message: String,
    },
    ConnectionError {
        message: String,
    },
    QuotaExceeded {
        retry_after: Duration,
    },
    ChannelClosed {
        message: String,
    },
    Safety,
    MaxTokens,
    ConnectionClosed {
        message: String,
    },
    Timeout {
        duration: Duration,
        operation: String,
    },
    Stream(StreamError),
    InvalidConfig {
        message: String,
    },
    Io {
        message: String,
        kind: ErrorKind,
    },
}

All errors that can occur in the bridge layer.

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.

AgentNotStarted

The agent was not started or has been shut down before an operation was requested.

BackendError

An exception was raised in the backend.

Fields

message: String

Formatted traceback or error message from backend.

ConnectionError

A connection-level error from the Antigravity SDK.

Fields

message: String

Human-readable description of the connection failure.

QuotaExceeded

Quota / rate-limit error (HTTP 429 or equivalent).

Fields

retry_after: Duration

Suggested wait duration before retrying.

ChannelClosed

The internal command channel was closed unexpectedly.

Fields

message: String

Context about which channel closed.

Safety

The agent request was blocked due to safety violations.

MaxTokens

The agent request reached the max tokens limit.

ConnectionClosed

Connection was permanently closed.

Fields

message: String

Human-readable descriptor.

Timeout

An operation exceeded its configured timeout.

Fields

duration: Duration

How long we waited before giving up.

operation: String

Which operation timed out.

Stream(StreamError)

An error originating from the streaming response layer.

InvalidConfig

The provided configuration is invalid or self-contradictory.

Fields

message: String

Human-readable description of the configuration issue.

Io

An I/O error occurred during a file or socket operation.

Fields

message: String

The original I/O error message.

kind: ErrorKind

The category of I/O error.

Implementations

impl Error

pub fn is_retryable(&self) -> bool

Returns true if this error is potentially transient and the operation may succeed on retry with with_retry.

Currently retryable:

• Error::ConnectionError — network-level failures
• Error::QuotaExceeded — rate-limited, retry after backoff
• Backend errors containing HTTP 503 — server overload

Note: The agent’s internal retry loop handles quota errors automatically via crate::quota::QuotaState. This method is primarily for consumers who want to retry at a higher level.

pub fn is_quota_error(&self) -> bool

Returns true if this error indicates a quota / rate-limit condition.

Matches the structured Error::QuotaExceeded variant as well as backend errors whose message contains HTTP 429, 503, or RESOURCE_EXHAUSTED status indicators.

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

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

Converts a Python exception into the most specific Error variant.

Checks for Antigravity SDK errors (connection, validation), Pydantic validation errors, and Python ImportError before falling back to Error::BackendError with a formatted traceback.

This impl is always compiled because pyo3 is a mandatory dependency of the bridge crate — the entire runtime requires it. If you depend on agy-bridge as a library, pyo3 will be linked transitively.

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<StreamError> for Error

fn from(err: StreamError) -> Self

Converts to this type from the input type.