Enum OrchestrationError 

pub enum OrchestrationError {
    Disabled,
    PlanningFailed(String),
    InvalidGraph(String),
    CycleDetected,
    TaskNotFound(String),
    NoAgentAvailable(String),
    GraphNotFound(String),
    Scheduler(String),
    AggregationFailed(String),
    Persistence(String),
    TaskTimeout(String),
    Canceled,
    InvalidCommand(String),
    VerificationFailed(String),
    InvalidConfig(String),
    SubAgent(SubAgentError),
    Llm(LlmError),
    PredicateNotSupported(String),
    ReplanBudgetExhausted {
        task_id: String,
        reason: String,
    },
    CascadeAborted {
        root: TaskId,
        chain: Vec<LineageEntry>,
    },
}

All error variants produced by the orchestration subsystem.

Variants are exhaustive — callers that match on this type should use a _ => … arm to stay robust against future additions.

Fail-open policy

LLM-backed steps (verification, replan) are always fail-open: on failure they log a warning and continue rather than returning an error. Only structural invariant violations and hard configuration errors propagate as Err.

Examples

use zeph_orchestration::OrchestrationError;

fn describe(err: &OrchestrationError) -> &'static str {
    match err {
        OrchestrationError::CycleDetected => "graph has a cycle",
        OrchestrationError::Disabled => "orchestration is off",
        _ => "other orchestration error",
    }
}

let err = OrchestrationError::CycleDetected;
assert_eq!(describe(&err), "graph has a cycle");

Variants

Disabled

Orchestration is disabled in configuration.

PlanningFailed(String)

The LLM planner failed to produce a valid task graph.

InvalidGraph(String)

The task graph structure is invalid (e.g. wrong task-id invariant, bad reference).

CycleDetected

A cycle was detected during topological sort of the task graph.

TaskNotFound(String)

A TaskId or task title lookup yielded no result.

NoAgentAvailable(String)

No agent in the available pool can be routed to a task.

GraphNotFound(String)

A GraphId could not be found in persistence.

Scheduler(String)

An internal scheduler invariant was violated.

AggregationFailed(String)

Result aggregation failed and the fallback path also failed.

Persistence(String)

A database read/write or serialization error in graph persistence.

TaskTimeout(String)

A task exceeded its per-task wall-clock timeout.

Canceled

The scheduler or a task was canceled by the caller.

InvalidCommand(String)

A /plan CLI command could not be parsed.

VerificationFailed(String)

Hard invariant violation during verification (e.g. cycle detected after inject_tasks).

Never used for LLM call failures — those are fail-open and only log a warning.

InvalidConfig(String)

A required configuration value is missing or out of range.

SubAgent(SubAgentError)

Propagated error from a sub-agent execution.

Llm(LlmError)

An LLM provider call failed in a context with no more specific variant.

Existing call sites that map LlmError to PlanningFailed or other semantic variants are intentional and should not be changed. This variant is for new code and for callers in zeph-core that propagate raw LLM errors.

PredicateNotSupported(String)

A VerifyPredicate::Expression was encountered; only Natural is supported in v1.

ReplanBudgetExhausted

Predicate remediation could not be injected because the replan budget is exhausted.

Fields

task_id: String

Task that triggered remediation.

reason: String

Human-readable reason (e.g. “predicate remediation”).

CascadeAborted

The DAG was aborted because a consecutive error chain in a depends_on path (or a region fan-out failure rate) exceeded the configured threshold.

chain_depth in the display is chain.len() for quick log scanning; the full LineageEntry list is emitted to the structured audit log.

Fields

root: TaskId

Root task ID where the failure chain began.

chain: Vec<LineageEntry>

Full lineage chain at the time of abort; earliest entry first.

Trait Implementations

impl Debug for OrchestrationError

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

Formats the value using the given formatter.

impl Display for OrchestrationError

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

Formats the value using the given formatter.

impl Error for OrchestrationError

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<LlmError> for OrchestrationError

fn from(source: LlmError) -> Self

Converts to this type from the input type.

impl From<SubAgentError> for OrchestrationError

fn from(source: SubAgentError) -> Self

Converts to this type from the input type.