Enum FlowError 

pub enum FlowError {
    Parse(String),
    Analyze(String),
    Compile(String),
    Runtime(String),
    Denied(String),
    Core(Error),
}

A failure in one of the Flux-Lang pipeline phases.

Variants

Parse(String)

The compact syntax or JSON AST could not be parsed.

Analyze(String)

The analyzer rejected the AST (unknown op, unbound symbol, illegal expression position, invalid name, arity/required-param or scalar type mismatch, unbounded loop, …). Effect authorization is not the analyzer’s job — policy decides allow/deny/approve at dispatch.

Compile(String)

The LLM front-end failed to produce a valid AST (after repair attempts).

Runtime(String)

A failure while executing a plan.

Denied(String)

The host’s safety envelope refused to run an op — a policy / permission-rule / capability-scope / user-approval denial, marked by the host on the dispatch outcome (OpOutcome::denied). Structured (not the in-band error string a failed op surfaces as) so is_fatal can see it: re-attempting a deliberate refusal can never succeed and only re-prompts/re-audits the same denial (L-21).

Core(Error)

An error bubbled up from a lower flux layer.

Implementations

impl FlowError

pub fn is_fatal(&self) -> bool

Whether this error is fatal — a deliberate refusal (a denied confirm, an op Denied by the host’s safety envelope) or a failed invariant (AssertFailed) — rather than a transient failure. Fatal errors must never be re-attempted or silently absorbed by the reliability wrappers: retry propagates them immediately, and the wrap points (loop’s body re-wrap, the composite-op boundary) preserve their structural identity instead of stringifying them, so an enclosing retry still sees them.

Trait Implementations

impl Debug for FlowError

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

Formats the value using the given formatter.

impl Display for FlowError

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

Formats the value using the given formatter.

impl Error for FlowError

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<Error> for FlowError

fn from(source: Error) -> Self

Converts to this type from the input type.