Enum TaskLaunchError 

pub enum TaskLaunchError {
    Compile(CompileError),
    Engine(EngineError),
    FlowEval {
        message: String,
        failed_step: Option<String>,
        verdict_value: Option<Value>,
        partial_ctx: Option<Value>,
    },
    PreDispatch(String),
}

Failure modes of TaskLaunchService::launch.

Variants

Compile(CompileError)

Compiler::compile rejected the Blueprint.

Engine(EngineError)

Engine::attach_with_ids failed.

FlowEval

A Step inside flow.ir’s eval_async produced a dispatcher error, or a sub-flow raised.

GH #76 error surface: struct variant carrying structured failure detail lifted off the eval boundary — failed_step / verdict_value come from the crate::store::run::RunContext::last_failure breadcrumb the dispatcher’s Blocked arm writes; partial_ctx comes from the same RunContext’s crate::store::run::RunContext::snapshot_partial_ctx reconstruction of the step-entry trace persisted so far. All three new fields are Option because dispatch may error via a path that does not go through the Blocked arm (upstream flow-ir eval errors, e.g. a malformed AST or an unresolved CallExtern — run_ctx itself may be None, or the flow may fail before any step was dispatched). Display preserves the pre-#76 "flow eval: {message}" prefix byte-for-byte for backwards-compatible stringification.

Fields

message: String

The stringified underlying error (EvalError::to_string() on the current write path). Preserves the pre-#76 message text.

failed_step: Option<String>

The Step.ref of the step whose Blocked outcome aborted the flow, when the dispatcher’s Blocked arm was the abort site. None for abort paths that do not go through the dispatcher (see the enum variant doc).

verdict_value: Option<Value>

The verdict Value the aborting step carried (DispatchOutcome::Blocked(v)’s v). None for the same reasons as failed_step.

partial_ctx: Option<Value>

In-tree partial_ctx surfaces step-entry log (step_id → status/binding_digest). Full value-level partial_ctx requires upstream mlua-flow-ir support to expose storage.snapshot() on error. See crate::store::run::RunContext::snapshot_partial_ctx for the reconstructed JSON shape. None when run_ctx was unavailable at the map_err site (e.g. TaskLaunchService::launch called without a RunContext).

PreDispatch(String)

Pre-dispatch validation failed: the launch was rejected before any step was dispatched. Raised when the effective check_policy (launch request > blueprint > server config) is Strict and the launch supplied neither project_root nor work_dir — a strict task would deterministically fail at its first submit-time file materialize, so the launch fails fast instead.

Trait Implementations

impl Debug for TaskLaunchError

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

Formats the value using the given formatter.

impl Display for TaskLaunchError

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

Formats the value using the given formatter.

impl Error for TaskLaunchError

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<CompileError> for TaskLaunchError

fn from(source: CompileError) -> Self

Converts to this type from the input type.

impl From<EngineError> for TaskLaunchError

fn from(source: EngineError) -> Self

Converts to this type from the input type.

impl From<TaskLaunchError> for EnhanceApplicationError

fn from(source: TaskLaunchError) -> Self

Converts to this type from the input type.

impl From<TaskLaunchError> for TaskApplicationError

fn from(source: TaskLaunchError) -> Self

Converts to this type from the input type.