Enum ErrorDetails 

pub enum ErrorDetails {
    Infrastructure {
        operation: String,
        message: String,
        retryable: bool,
    },
    Configuration {
        kind: ConfigErrorKind,
        resource: String,
        message: Option<String>,
    },
    Application {
        kind: AppErrorKind,
        message: String,
        retryable: bool,
    },
    Poison {
        attempt_count: u32,
        max_attempts: u32,
        message_type: PoisonMessageType,
        message: String,
    },
}

Structured error details for orchestration failures.

Errors are categorized into three types for proper metrics and logging:

• Infrastructure: Provider failures, data corruption (abort turn, never reach user code)
• Configuration: Deployment issues like unregistered activities, nondeterminism (abort turn)
• Application: Business logic failures (flow through normal orchestration code)

Variants

Infrastructure

Infrastructure failure (provider errors, data corruption). These errors abort orchestration execution and never reach user code.

Fields

operation: String

message: String

retryable: bool

Configuration

Configuration error (unregistered orchestrations/activities, nondeterminism). These errors abort orchestration execution and never reach user code.

Fields

kind: ConfigErrorKind

resource: String

message: Option<String>

Application

Application error (business logic failures). These are the ONLY errors that orchestration code sees.

Fields

kind: AppErrorKind

message: String

retryable: bool

Poison

Poison message error - message exceeded max fetch attempts.

This indicates a message that repeatedly fails to process. Could be caused by:

• Malformed message data causing deserialization failures
• Message triggering bugs that crash the worker
• Transient infrastructure issues that became permanent
• Application code bugs triggered by specific input patterns

Fields

attempt_count: u32

Number of times the message was fetched

max_attempts: u32

Maximum allowed attempts

message_type: PoisonMessageType

Message type and identity

message: String

The poisoned message content (serialized JSON for debugging)

Implementations

impl ErrorDetails

pub fn category(&self) -> &'static str

Get failure category for metrics/logging.

pub fn is_retryable(&self) -> bool

Check if failure is retryable.

pub fn display_message(&self) -> String

Get display message for logging/UI (backward compatible format).

Trait Implementations

impl Clone for ErrorDetails

fn clone(&self) -> ErrorDetails

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ErrorDetails

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ErrorDetails

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ErrorDetails

fn eq(&self, other: &ErrorDetails) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ErrorDetails

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for ErrorDetails

impl StructuralPartialEq for ErrorDetails