Enum EngineError 

pub enum EngineError {
    Operation(OperationError),
    Store(StoreError),
    InvalidWorkflow(String),
    StepConfig(String),
    Serialization(Error),
    RunBudgetExceeded {
        run_id: Uuid,
        limit_usd: Decimal,
        spent_usd: Decimal,
        step_budget_usd: Decimal,
    },
    MonthlyBudgetExceeded {
        limit_usd: Decimal,
        spent_usd: Decimal,
    },
    MissingArtifact {
        step: String,
        pattern: String,
    },
    ArtifactNotFound {
        step: String,
        name: String,
    },
    ArtifactsUnavailable(String),
    Artifact(ArtifactError),
    ApprovalRequired {
        run_id: Uuid,
        step_id: Uuid,
        message: String,
    },
}

Errors produced by the workflow engine.

Variants

Operation(OperationError)

An operation (Shell, Http, Agent) failed during step execution.

Store(StoreError)

The backing store returned an error.

InvalidWorkflow(String)

The workflow definition is invalid.

StepConfig(String)

A step configuration could not be deserialized for execution.

Serialization(Error)

JSON serialization error.

RunBudgetExceeded

The run reached its cumulative cost cap before launching an agent step.

Raised before the step is created, so no work and no spend happen. The engine transitions the run to Cancelled.

Fields

run_id: Uuid

The run that hit its cap.

limit_usd: Decimal

The configured cap, in USD.

spent_usd: Decimal

Cost already accumulated by this run and its ancestors, in USD.

step_budget_usd: Decimal

Declared budget of the step that was about to run, in USD.

MonthlyBudgetExceeded

The global monthly cost quota is exhausted; no new run may be created.

Runs already in flight are never interrupted by this error.

Fields

limit_usd: Decimal

The configured monthly quota, in USD.

spent_usd: Decimal

Cost already spent during the current calendar month, in USD.

MissingArtifact

A step declared an output that produced no file.

Raised only when the step itself succeeded: a declared output that never materialised is a broken contract, and failing here beats failing later in whichever step tried to consume it.

Fields

step: String

Name of the step that declared the output.

pattern: String

The unmatched pattern.

ArtifactNotFound

A step asked for an artifact that no earlier step produced.

Fields

step: String

Name of the producing step that was searched for.

name: String

Name of the artifact that was searched for.

ArtifactsUnavailable(String)

Artifacts were used but no storage backend is configured.

Artifact(ArtifactError)

The artifact storage backend failed.

ApprovalRequired

The run requires human approval before continuing.

Fields

run_id: Uuid

The run that is awaiting approval.

step_id: Uuid

The approval step that triggered the pause.

message: String

The approval message.

Trait Implementations

impl Debug for EngineError

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

Formats the value using the given formatter.

impl Display for EngineError

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

Formats the value using the given formatter.

impl Error for EngineError

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<ArtifactError> for EngineError

fn from(source: ArtifactError) -> Self

Converts to this type from the input type.

impl From<Error> for EngineError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<OperationError> for EngineError

fn from(source: OperationError) -> Self

Converts to this type from the input type.

impl From<StoreError> for EngineError

fn from(source: StoreError) -> Self

Converts to this type from the input type.