Enum WorkflowRuntimeError 

pub enum WorkflowRuntimeError {
    Validation(ValidationErrors),
    MissingStartNode,
    NodeNotFound {
        node_id: String,
    },
    StepLimitExceeded {
        max_steps: usize,
    },
    Cancelled,
    Llm {
        node_id: String,
        source: LlmExecutionError,
    },
    Tool {
        node_id: String,
        source: ToolExecutionError,
    },
    LlmRetryExhausted {
        node_id: String,
        attempts: usize,
        last_error: LlmExecutionError,
    },
    ToolRetryExhausted {
        node_id: String,
        attempts: usize,
        last_error: ToolExecutionError,
    },
    LlmTimeout {
        node_id: String,
        timeout_ms: u128,
        attempts: usize,
    },
    ToolTimeout {
        node_id: String,
        timeout_ms: u128,
        attempts: usize,
    },
    MissingToolExecutor {
        node_id: String,
    },
    MissingNextEdge {
        node_id: String,
    },
    InvalidCondition {
        node_id: String,
        expression: String,
        reason: String,
    },
    InvalidLoopCondition {
        node_id: String,
        expression: String,
        reason: String,
    },
    LoopIterationLimitExceeded {
        node_id: String,
        max_iterations: u32,
    },
    MissingNextTransition {
        node_id: String,
    },
    ScopeAccess {
        node_id: String,
        source: ScopeAccessError,
    },
    TraceRecording(TraceRecordError),
    Replay(ReplayError),
    ReplayRequiresTraceRecording,
    ParallelBranchUnsupported {
        node_id: String,
        branch_id: String,
        reason: String,
    },
    MissingMergeSource {
        node_id: String,
        source_id: String,
    },
    MergeQuorumNotMet {
        node_id: String,
        required: usize,
        resolved: usize,
    },
    MapItemsNotArray {
        node_id: String,
        items_path: String,
    },
    InvalidReduceInput {
        node_id: String,
        source_node: String,
        reason: String,
    },
    SubgraphNotFound {
        node_id: String,
        graph: String,
    },
    BatchItemsNotArray {
        node_id: String,
        items_path: String,
    },
    FilterItemsNotArray {
        node_id: String,
        items_path: String,
    },
    InvalidFilterExpression {
        node_id: String,
        expression: String,
        reason: String,
    },
    ExpressionScopeLimitExceeded {
        node_id: String,
        actual_bytes: usize,
        limit_bytes: usize,
    },
    ParallelBranchLimitExceeded {
        node_id: String,
        actual_branches: usize,
        max_branches: usize,
    },
    MapItemLimitExceeded {
        node_id: String,
        actual_items: usize,
        max_items: usize,
    },
    FilterItemLimitExceeded {
        node_id: String,
        actual_items: usize,
        max_items: usize,
    },
    MissingPath {
        node_id: String,
        path: String,
    },
    CacheKeyNotString {
        node_id: String,
        path: String,
    },
    InvalidHumanDecision {
        node_id: String,
        path: String,
        value: String,
    },
    InvalidEventValue {
        node_id: String,
        path: String,
    },
    InvalidRouterExpression {
        node_id: String,
        expression: String,
        reason: String,
    },
    InvalidTransformExpression {
        node_id: String,
        expression: String,
        reason: String,
    },
    RetryCompensateFailed {
        node_id: String,
        attempts: usize,
        compensation_error: ToolExecutionError,
    },
}

Runtime failures.

Variants

Validation(ValidationErrors)

Workflow failed structural validation.

MissingStartNode

Workflow has no start node.

NodeNotFound

Current node id not found in node index.

Fields

node_id: String

Missing node id.

StepLimitExceeded

Loop protection guard triggered.

Fields

max_steps: usize

Configured max steps.

Cancelled

Execution cancelled by caller.

Llm

LLM node failed.

Fields

node_id: String

Failing node id.

source: LlmExecutionError

Source error.

Tool

Tool node failed.

Fields

node_id: String

Failing node id.

source: ToolExecutionError

Source error.

LlmRetryExhausted

LLM node exhausted all retry attempts.

Fields

node_id: String

Failing node id.

attempts: usize

Number of attempts made.

last_error: LlmExecutionError

Last attempt error.

ToolRetryExhausted

Tool node exhausted all retry attempts.

Fields

node_id: String

Failing node id.

attempts: usize

Number of attempts made.

last_error: ToolExecutionError

Last attempt error.

LlmTimeout

LLM node timed out across all attempts.

Fields

node_id: String

Failing node id.

timeout_ms: u128

Per-attempt timeout in milliseconds.

attempts: usize

Number of attempts made.

ToolTimeout

Tool node timed out across all attempts.

Fields

node_id: String

Failing node id.

timeout_ms: u128

Per-attempt timeout in milliseconds.

attempts: usize

Number of attempts made.

MissingToolExecutor

Tool node reached without an executor.

Fields

node_id: String

Failing node id.

MissingNextEdge

LLM/tool node missing its next edge.

Fields

node_id: String

Failing node id.

InvalidCondition

Condition expression could not be evaluated.

Fields

node_id: String

Failing node id.

expression: String

Condition expression.

reason: String

Detailed reason.

InvalidLoopCondition

Loop condition expression could not be evaluated.

Fields

node_id: String

Failing node id.

expression: String

Loop condition expression.

reason: String

Detailed reason.

LoopIterationLimitExceeded

Loop exceeded configured max iterations.

Fields

node_id: String

Failing node id.

max_iterations: u32

Configured max iterations.

MissingNextTransition

Non-terminal node did not return a next transition.

Fields

node_id: String

Failing node id.

ScopeAccess

Scoped state boundary check failed.

Fields

node_id: String

Failing node id.

source: ScopeAccessError

Source access error.

TraceRecording(TraceRecordError)

Trace recorder operation failed.

Replay(ReplayError)

Replay trace validation failed.

ReplayRequiresTraceRecording

Replay mode requested without trace recording.

ParallelBranchUnsupported

Parallel branch references unsupported node kind.

Fields

node_id: String

Parallel node id.

branch_id: String

Branch node id.

reason: String

Reason for rejection.

MissingMergeSource

Merge node cannot resolve one or more sources.

Fields

node_id: String

Merge node id.

source_id: String

Missing source id.

MergeQuorumNotMet

Merge quorum policy could not be satisfied.

Fields

node_id: String

Merge node id.

required: usize

Required number of sources.

resolved: usize

Number of resolved sources.

MapItemsNotArray

Map node items path did not resolve to an array.

Fields

node_id: String

Map node id.

items_path: String

Configured path.

InvalidReduceInput

Reduce node source value is not reducible.

Fields

node_id: String

Reduce node id.

source_node: String

Source node id.

reason: String

Detailed reason.

SubgraphNotFound

Subgraph registry key not found.

Fields

node_id: String

graph: String

BatchItemsNotArray

Batch source path did not resolve to an array.

Fields

node_id: String

items_path: String

FilterItemsNotArray

Filter source path did not resolve to an array.

Fields

node_id: String

items_path: String

InvalidFilterExpression

Filter expression failed while evaluating one item.

Fields

node_id: String

expression: String

reason: String

ExpressionScopeLimitExceeded

Serialized expression scope exceeded configured runtime limit.

Fields

node_id: String

actual_bytes: usize

limit_bytes: usize

ParallelBranchLimitExceeded

Parallel branch fan-out exceeded configured runtime limit.

Fields

node_id: String

actual_branches: usize

max_branches: usize

MapItemLimitExceeded

Map item count exceeded configured runtime limit.

Fields

node_id: String

actual_items: usize

max_items: usize

FilterItemLimitExceeded

Filter item count exceeded configured runtime limit.

Fields

node_id: String

actual_items: usize

max_items: usize

MissingPath

A node-required path could not be resolved.

Fields

node_id: String

path: String

CacheKeyNotString

A cache key path did not resolve to a string.

Fields

node_id: String

path: String

InvalidHumanDecision

Human decision value is unsupported.

Fields

node_id: String

path: String

value: String

InvalidEventValue

Event value did not resolve to a string.

Fields

node_id: String

path: String

InvalidRouterExpression

Router expression evaluation failed.

Fields

node_id: String

expression: String

reason: String

InvalidTransformExpression

Transform expression evaluation failed.

Fields

node_id: String

expression: String

reason: String

RetryCompensateFailed

Explicit retry/compensate node exhausted primary and compensation failed.

Fields

node_id: String

attempts: usize

compensation_error: ToolExecutionError

Trait Implementations

impl Debug for WorkflowRuntimeError

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

Formats the value using the given formatter.

impl Display for WorkflowRuntimeError

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

Formats the value using the given formatter.

impl Error for WorkflowRuntimeError

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<ReplayError> for WorkflowRuntimeError

fn from(source: ReplayError) -> Self

Converts to this type from the input type.

impl From<TraceRecordError> for WorkflowRuntimeError

fn from(source: TraceRecordError) -> Self

Converts to this type from the input type.

impl From<ValidationErrors> for WorkflowRuntimeError

fn from(source: ValidationErrors) -> Self

Converts to this type from the input type.