Enum AgentError 

#[non_exhaustive]
pub enum AgentError {
    ContextWindowOverflow {
        model: String,
    },
    ModelThrottled,
    NetworkError {
        source: Box<dyn Error + Send + Sync>,
    },
    StructuredOutputFailed {
        attempts: usize,
        last_error: String,
    },
    AlreadyRunning,
    NoMessages,
    InvalidContinue,
    StreamError {
        source: Box<dyn Error + Send + Sync>,
    },
    Aborted,
    Plugin {
        name: String,
        source: Box<dyn Error + Send + Sync>,
    },
    CacheMiss,
    ContentFiltered,
    SyncInAsyncContext,
    RuntimeInit {
        source: Error,
    },
}

The top-level error type for the swink agent.

Each variant maps to a specific failure mode described in PRD section 10.3.

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.

ContextWindowOverflow

Provider rejected the request because input exceeds the model’s context window.

Fields

model: String

ModelThrottled

Rate limit / 429 received from the provider.

NetworkError

Transient IO or connection failure.

Fields

source: Box<dyn Error + Send + Sync>

StructuredOutputFailed

Structured output validation failed after exhausting all retry attempts.

Fields

attempts: usize

last_error: String

AlreadyRunning

prompt() was called while a run is already active.

NoMessages

continue_loop() was called with an empty message history.

InvalidContinue

continue_loop() was called when the last message is an assistant message.

StreamError

Non-retryable failure from the StreamFn implementation.

Fields

source: Box<dyn Error + Send + Sync>

Aborted

The operation was cancelled via a CancellationToken.

Plugin

An error from a plugin or extension.

Fields

name: String

source: Box<dyn Error + Send + Sync>

CacheMiss

Provider-side context cache was not found (evicted or expired).

The framework resets CacheState before consulting the configured retry strategy. Custom strategies can choose to retry with CacheHint::Write.

ContentFiltered

Provider safety / content filter blocked the response.

Non-retryable — the input triggered a provider-side content policy. Callers can match on this variant to distinguish safety blocks from auth or network errors.

SyncInAsyncContext

A synchronous API (prompt_sync, continue_sync, etc.) was called from within an active Tokio runtime.

These methods create their own Tokio runtime internally. Calling them from async code (or any thread that already has a Tokio runtime) would panic. Use the _async or _stream variants instead.

RuntimeInit

The internal Tokio runtime used by blocking sync APIs failed to start.

Fields

source: Error

Implementations

impl AgentError

pub const fn is_retryable(&self) -> bool

Returns true for error variants that are safe to retry by default (ModelThrottled and NetworkError).

pub fn network(err: impl Error + Send + Sync + 'static) -> Self

Convenience constructor for AgentError::NetworkError.

pub fn stream(err: impl Error + Send + Sync + 'static) -> Self

Convenience constructor for AgentError::StreamError.

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

Convenience constructor for AgentError::ContextWindowOverflow.

pub fn structured_output_failed( attempts: usize, last_error: impl Into<String>, ) -> Self

Convenience constructor for AgentError::StructuredOutputFailed.

pub fn plugin( name: impl Into<String>, source: impl Error + Send + Sync + 'static, ) -> Self

Convenience constructor for AgentError::Plugin.

pub const fn runtime_init(source: Error) -> Self

Convenience constructor for AgentError::RuntimeInit.

Trait Implementations

impl Debug for AgentError

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

Formats the value using the given formatter.

impl Display for AgentError

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

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

fn from(err: Error) -> Self

Converts to this type from the input type.