Enum SailError 

#[non_exhaustive]
pub enum SailError {
    Config {
        message: String,
    },
    Internal {
        message: String,
    },
    Transport {
        kind: TransportKind,
        message: String,
        source: Option<Box<dyn StdError + Send + Sync + 'static>>,
    },
    Creation {
        message: String,
        status: u16,
        body: Value,
    },
    NotFound {
        message: String,
    },
    PermissionDenied {
        message: String,
    },
    FileNotFound {
        message: String,
    },
    InvalidArgument {
        message: String,
    },
    Api {
        status: u16,
        message: String,
        body: Value,
    },
    ExecRequestNotFound {
        message: String,
    },
    Terminated {
        message: String,
    },
    WorkerLost {
        message: String,
    },
    ExecInterrupted {
        retryable: bool,
        message: String,
    },
    ExecCanceled {
        message: String,
    },
    BrokenPipe {
        message: String,
    },
    Execution {
        code: GrpcCode,
        detail: String,
    },
}

The canonical Sail error. Variants carry structured fields so bindings can populate their own exception attributes without parsing strings.

Display is for Rust logs only; bindings format their own user-facing text.

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.

Config

Configuration/usage error (e.g. missing API key, bad SAIL_MODE).

Fields

message: String

Human-readable description of the misconfiguration.

Internal

Unexpected internal failure (client build, TLS config, invariant).

Fields

message: String

Human-readable description of the internal failure.

Transport

HTTP/gRPC dial-time transport failure. source is the underlying transport error (e.g. the originating tonic::Status) for Rust callers.

Fields

kind: TransportKind

Whether the transport failed by timeout or by connection error.

message: String

Human-readable description of the transport failure.

source: Option<Box<dyn StdError + Send + Sync + 'static>>

The underlying transport error, retained for Rust callers; None when no originating error was available.

Creation

Sailbox creation failed (non-2xx on create).

Fields

message: String

Human-readable description of the creation failure.

status: u16

HTTP status code returned by the create request.

body: Value

Parsed response body from the failed create request.

NotFound

A resource was not found (404 on get / unknown id across orgs).

Fields

message: String

Human-readable description of the missing resource.

PermissionDenied

A credential problem: missing/invalid API key or insufficient scope.

Fields

message: String

Human-readable description of the credential or scope problem.

FileNotFound

A file operation referenced a path that does not exist.

Fields

message: String

Human-readable description of the missing path.

InvalidArgument

A request argument was rejected as invalid.

Fields

message: String

Human-readable description of why the argument was rejected.

Api

Any other non-2xx API response.

Fields

status: u16

HTTP status code returned by the API.

message: String

Human-readable description of the API failure.

body: Value

Parsed response body from the failed API request.

ExecRequestNotFound

A wait referenced an unknown exec request.

Fields

message: String

Human-readable description of the unknown exec request.

Terminated

The sailbox no longer exists on the worker.

Fields

message: String

Human-readable description noting the sailbox is gone.

WorkerLost

The worker hosting the sailbox was lost; output is unrecoverable.

Fields

message: String

Human-readable description of the worker loss.

ExecInterrupted

The command was interrupted; retryable indicates whether a retry could still observe the result.

Fields

retryable: bool

Whether a retry could still observe the command’s result.

message: String

Human-readable description of the interruption.

ExecCanceled

The command was canceled before producing an exit code.

Fields

message: String

Human-readable description of the cancellation.

BrokenPipe

A stdin write hit a command that already finished or closed its stdin.

Fields

message: String

Human-readable description of the broken-pipe condition.

Execution

Any other exec-RPC failure, classified by gRPC code.

Fields

code: GrpcCode

The gRPC status code that classifies the failure.

detail: String

Human-readable detail describing the failure.

Implementations

impl SailError

pub fn from_exec_status(status: &Status) -> SailError

Classify an exec-context gRPC status into the canonical taxonomy.

NOT_FOUND splits into SailError::ExecRequestNotFound (the wait referenced an unknown exec request) versus SailError::Terminated (the sailbox itself is gone). A credential failure maps to SailError::PermissionDenied, matching the listener/file mappers. Everything else is a generic SailError::Execution carrying the structured code; bindings format their own message from code + detail.

pub fn from_rpc_status(status: &Status) -> SailError

Classify a general (non-exec) worker-proxy gRPC status (listeners, files). NOT_FOUND maps to SailError::NotFound, a credential failure to SailError::PermissionDenied, and everything else to SailError::Execution carrying the structured code.

pub fn from_file_rpc_status(status: &Status) -> SailError

Classify a file-RPC gRPC status. Files have their own taxonomy: a missing path is SailError::FileNotFound (not the generic NotFound), and a rejected argument is SailError::InvalidArgument.

Trait Implementations

impl Debug for SailError

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

Formats the value using the given formatter.

impl Display for SailError

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

Formats the value using the given formatter.

impl Error for SailError

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.