Enum FlowError 

#[non_exhaustive]
pub enum FlowError {
    Agent(String),
    Json(Error),
    Loop {
        reason: String,
        iter: u32,
    },
    Graph(String),
    Bus(BusError),
    Tool(ToolError),
    Cancelled,
}

Errors returned by crate::flow::Flow::run and its concrete impls.

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.

Agent(String)

An underlying klieo_core::Agent returned an error. Stringly typed because Agent::Error is associated and not erasable.

Json(Error)

Marshalling between typed I/O and serde_json::Value failed.

Loop

crate::loop_flow::LoopFlow exceeded max_iters or its predicate returned LoopVerdict::Failed.

Fields

reason: String

Human-readable reason.

iter: u32

Iteration count at termination.

Graph(String)

crate::graph::GraphFlow hit a cycle, missing node, or missing edge.

Bus(BusError)

Underlying bus surfaced a transient failure during a flow.

Tool(ToolError)

A crate::flow::Flow dispatched a tool via klieo_core::tool::ToolInvoker and the invocation itself failed. Typed (rather than stringified) so callers can match klieo_core::error::ToolError::Cancelled / klieo_core::error::ToolError::Retryable and keep the source chain intact.

Cancelled

The flow observed AgentContext::cancel before starting an iteration / step and stopped without doing further work. Distinct from a body agent’s own error so callers can tell a cooperative cancellation apart from a failure.

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

fn from(source: BusError) -> Self

Converts to this type from the input type.

impl From<Error> for FlowError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<ToolError> for FlowError

fn from(source: ToolError) -> Self

Converts to this type from the input type.