Enum FlowgentraError 

#[non_exhaustive]
pub enum FlowgentraError {
    ConfigError(String),
    GraphError(String),
    NodeNotFound(String),
    InvalidEdge(String),
    RoutingError(String),
    CycleDetected,
    RecursionLimitExceeded {
        limit: usize,
    },
    NoTerminationPath {
        nodes: String,
    },
    NodeExecutionError(String),
    RuntimeError(String),
    InvalidStateTransition(String),
    ExecutionError(String),
    ExecutionAborted(String),
    TimeoutError,
    ExecutionTimeout(String),
    ParallelExecutionError(String),
    StateError(String),
    Context(String, Box<FlowgentraError>),
    LLMError(String),
    MCPError(String),
    MCPTransportError(String),
    MCPServerError(String),
    ToolError(String),
    ValidationError(String),
    SerializationError(Error),
    YamlError(String),
    IoError(Error),
}

Comprehensive error enum covering all possible FlowgentraAI failures

Each variant is designed to provide context about what went wrong, making it easy to handle different error scenarios.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

ConfigError(String)

Invalid or malformed configuration

GraphError(String)

Issues with graph structure or operations

NodeNotFound(String)

Node not found in the graph

InvalidEdge(String)

Invalid edge definition

RoutingError(String)

Routing condition failed

CycleDetected

Cycle detected in acyclic graph

RecursionLimitExceeded

Recursion limit exceeded during graph execution

Fields

limit: usize

NoTerminationPath

Cyclic graph has nodes with no path to END (infinite loop risk)

Fields

nodes: String

NodeExecutionError(String)

Error during node execution

RuntimeError(String)

Runtime orchestration error

InvalidStateTransition(String)

Invalid state transition

ExecutionError(String)

Execution failed

ExecutionAborted(String)

Execution aborted by middleware

TimeoutError

Operation timed out

ExecutionTimeout(String)

Execution timeout

ParallelExecutionError(String)

Error during parallel execution

StateError(String)

Error with state management

Context(String, Box<FlowgentraError>)

Error context wrapper preserving the original error trace

LLMError(String)

LLM operation failed

MCPError(String)

MCP (Model Context Protocol) operation failed

MCPTransportError(String)

MCP transport-level error (connection refused, timeout, DNS failure). Safe to retry because the request never reached the server.

MCPServerError(String)

MCP server-side error (HTTP 5xx, tool execution failure). NOT safe to retry blindly — the tool may have executed.

ToolError(String)

Tool operation failed

ValidationError(String)

Validation error (e.g., schema validation)

SerializationError(Error)

JSON serialization/deserialization failed

YamlError(String)

YAML parsing failed

IoError(Error)

File I/O operation failed

Implementations

impl FlowgentraError

pub fn is_retryable(&self) -> bool

Returns true if this is a transport-level error safe to retry.

impl FlowgentraError

pub fn context(self, msg: &str) -> Self

Add context to an error message

Useful for providing debugging information without re-wrapping the error.

Example

use flowgentra_ai::core::error::FlowgentraError;

let err = FlowgentraError::ConfigError("invalid value".to_string());
let contextualized = err.context("while loading agent config from 'config.yaml'");

pub fn is_timeout(&self) -> bool

Check if error is a timeout

pub fn is_validation_error(&self) -> bool

Check if error is a validation error

pub fn is_llm_error(&self) -> bool

Check if error is an LLM error

pub fn is_state_error(&self) -> bool

Check if error is a state-related error

pub fn hint(&self) -> Option<&'static str>

Get a hint for common error scenarios

Trait Implementations

impl Debug for FlowgentraError

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

Formats the value using the given formatter.

impl Display for FlowgentraError

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

Formats the value using the given formatter.

impl Error for FlowgentraError

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 FlowgentraError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for FlowgentraError

fn from(source: Error) -> Self

Converts to this type from the input type.