Enum WorkflowError 

#[non_exhaustive]
pub enum WorkflowError {
    Build(WorkflowBuildError),
    AuthorityEscalation {
        step: StepId,
        capability: String,
    },
    Step {
        step: StepId,
        source: Box<WorkflowStepError>,
    },
    ParallelBranch {
        step: StepId,
        branch: StepId,
        source: Box<WorkflowStepError>,
    },
    RaceAllFailed {
        step: StepId,
        failures: BTreeMap<StepId, String>,
    },
    Cancelled,
    DeadlineExceeded,
    DurableWaitRequiresWorker,
    WakeMismatch,
    Wait(WorkflowWaitError),
    Serialization(Error),
    Budget(BudgetExceeded),
    ChildRun(ChildRunError),
    AmbiguousCheckpoint {
        step: StepId,
    },
    CheckpointIdentityMismatch,
    CheckpointUsageMismatch,
    Journal(JournalError),
    Checkpoint(CheckpointError),
}

Failure of workflow execution or recovery.

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.

Build(WorkflowBuildError)

A workflow definition is invalid.

AuthorityEscalation

A child requested authority absent from its parent run.

Fields

step: StepId

Step whose grant was rejected.

capability: String

Missing capability name.

Step

A step failed.

Fields

step: StepId

Stable failed step identifier.

source: Box<WorkflowStepError>

Typed step failure.

ParallelBranch

One branch of a parallel node failed.

Fields

step: StepId

Stable parallel node identifier.

branch: StepId

Stable failed branch identifier.

source: Box<WorkflowStepError>

Typed branch failure.

RaceAllFailed

Every branch in a first-success race failed.

Fields

step: StepId

Stable race node identifier.

failures: BTreeMap<StepId, String>

Safe branch failure explanations.

Cancelled

The workflow was cancelled.

DeadlineExceeded

The workflow deadline elapsed.

DurableWaitRequiresWorker

A durable wait was executed outside the distributed worker boundary.

WakeMismatch

Stored wake data does not match the checkpoint’s durable wait.

Wait(WorkflowWaitError)

A durable wait or human decision violated its domain invariants.

Serialization(Error)

A durable wait output could not be represented as canonical JSON.

Budget(BudgetExceeded)

Parallel budget reservation or consumption exceeded a hard limit.

ChildRun(ChildRunError)

A child Run rejected its capability or budget scope.

AmbiguousCheckpoint

Recovery would silently retry a possibly partial step.

Fields

step: StepId

Interrupted step identifier.

CheckpointIdentityMismatch

Persisted state does not belong to this workflow definition.

CheckpointUsageMismatch

Persisted usage is incompatible with the supplied run context.

Journal(JournalError)

Structured event recording failed.

Checkpoint(CheckpointError)

Checkpoint persistence or validation failed.

Trait Implementations

impl Debug for WorkflowError

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

Formats the value using the given formatter.

impl Display for WorkflowError

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

Formats the value using the given formatter.

impl Error for WorkflowError

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<BudgetExceeded> for WorkflowError

fn from(source: BudgetExceeded) -> Self

Converts to this type from the input type.

impl From<CheckpointError> for WorkflowError

fn from(source: CheckpointError) -> Self

Converts to this type from the input type.

impl From<ChildRunError> for WorkflowError

fn from(source: ChildRunError) -> Self

Converts to this type from the input type.

impl From<Error> for WorkflowError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<JournalError> for WorkflowError

fn from(source: JournalError) -> Self

Converts to this type from the input type.

impl From<WorkflowBuildError> for WorkflowError

fn from(source: WorkflowBuildError) -> Self

Converts to this type from the input type.

impl From<WorkflowWaitError> for WorkflowError

fn from(source: WorkflowWaitError) -> Self

Converts to this type from the input type.