Enum SwarmError 

pub enum SwarmError {
    ApiError(String),
    ConfigError(String),
    AgentError(String),
    ValidationError(String),
    RateLimitError(String),
    NetworkError(String),
    TimeoutError(String),
    AuthError(String),
    ReqwestError(Error),
    EnvVarError(VarError),
    SerializationError(String),
    DeserializationError(String),
    XmlError(String),
    AgentNotFoundError(String),
    FunctionError(String),
    StreamError(String),
    ContextError(String),
    MaxIterationsError {
        max: usize,
        actual: usize,
    },
    JsonError(Error),
    XmlParseError(DeError),
    Other(String),
    RequestTimeoutError(u64),
    UrlValidationError(String),
}

Main error type for the Swarm library

Encompasses all possible error conditions that can occur during Swarm operations, from API communication to agent execution.

Examples

use rswarm::SwarmError;

let error = SwarmError::ApiError("Rate limit exceeded".to_string());
assert_eq!(error.to_string(), "API error: Rate limit exceeded");

// Checking if an error is retriable
assert!(SwarmError::NetworkError("Connection refused".to_string()).is_retriable());

Variants

ApiError(String)

Errors returned by the API

ConfigError(String)

Configuration-related errors

AgentError(String)

Errors related to agent execution

ValidationError(String)

Input validation errors

RateLimitError(String)

Rate limiting errors from the API

NetworkError(String)

Network communication errors

TimeoutError(String)

Timeout-related errors

AuthError(String)

Authentication and authorization errors

ReqwestError(Error)

HTTP client errors from reqwest

EnvVarError(VarError)

Environment variable errors

SerializationError(String)

Data serialization errors

DeserializationError(String)

Data deserialization errors

XmlError(String)

XML parsing and processing errors

AgentNotFoundError(String)

Errors when an agent is not found in the registry

FunctionError(String)

Function execution errors

StreamError(String)

Stream processing errors

ContextError(String)

Context variables related errors

MaxIterationsError

Maximum iterations exceeded errors

Fields

max: usize

actual: usize

JsonError(Error)

JSON processing errors

XmlParseError(DeError)

XML parsing errors from quick-xml

Other(String)

Generic/catch-all errors

RequestTimeoutError(u64)

Request timeout errors with duration

UrlValidationError(String)

URL validation errors

Implementations

impl SwarmError

pub fn is_retriable(&self) -> bool

Determines if the error is potentially retriable

Returns true for errors that might succeed on retry, such as network errors, timeouts, and rate limit errors.

Examples

use rswarm::SwarmError;

let error = SwarmError::NetworkError("Connection reset".to_string());
assert!(error.is_retriable());

let error = SwarmError::ValidationError("Invalid input".to_string());
assert!(!error.is_retriable());

pub fn is_configuration_error(&self) -> bool

Determines if the error is related to configuration

Returns true for errors that indicate configuration problems, such as invalid settings or missing credentials.

Examples

use rswarm::SwarmError;

let error = SwarmError::ConfigError("Invalid API URL".to_string());
assert!(error.is_configuration_error());

let error = SwarmError::NetworkError("Connection failed".to_string());
assert!(!error.is_configuration_error());

Trait Implementations

impl Debug for SwarmError

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

Formats the value using the given formatter.

impl Display for SwarmError

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

Formats the value using the given formatter.

impl Error for SwarmError

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<BudgetExhausted> for SwarmError

fn from(e: BudgetExhausted) -> Self

Converts to this type from the input type.

impl From<DeError> for SwarmError

fn from(source: DeError) -> Self

Converts to this type from the input type.

impl From<Error> for SwarmError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SwarmError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SwarmError

Implement From for common error conversions

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for SwarmError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<VarError> for SwarmError

fn from(source: VarError) -> Self

Converts to this type from the input type.