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),
}

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.

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

fn from(source: SubAgentError) -> Self

Converts to this type from the input type.