Enum OperationError 

pub enum OperationError {
    Shell {
        exit_code: i32,
        stderr: String,
    },
    Agent(AgentError),
    Timeout {
        step: String,
        limit: Duration,
    },
    Http {
        status: Option<u16>,
        message: String,
    },
    Deserialize {
        target_type: String,
        reason: String,
    },
    Secret {
        message: String,
    },
    External {
        origin: String,
        message: String,
    },
}

Top-level error for any workflow operation (shell or agent).

Every public operation in ironflow returns Result<T, OperationError>.

Variants

Shell

A shell command exited with a non-zero status code.

Fields

exit_code: i32

Process exit code, or -1 if the process could not be spawned.

stderr: String

Captured stderr, truncated to MAX_OUTPUT_SIZE.

Agent(AgentError)

An agent invocation failed.

Wraps an AgentError with full detail about the failure.

Timeout

An operation exceeded its configured timeout.

Fields

step: String

Human-readable description of the timed-out step (usually the command string).

limit: Duration

The Duration that was exceeded.

Http

An HTTP request failed at the transport layer or the response body could not be read.

Fields

status: Option<u16>

HTTP status code, if a response was received.

message: String

Human-readable error description.

Deserialize

Failed to deserialize a JSON response into the expected Rust type.

Returned by AgentResult::json and HttpOutput::json.

Fields

target_type: String

The Rust type name that was expected.

reason: String

The underlying serde error message.

Secret

The secret store failed to read or decrypt a secret.

Returned by SecretResolver::get implementations when the underlying storage or decryption layer errors.

Fields

message: String

Human-readable error description.

External

An error from an external library (e.g. git2, gitlab).

Used by ironflow-ops-* crates to wrap third-party library errors without introducing domain-specific variants into this enum.

Examples

use ironflow_core::error::OperationError;

let err = OperationError::External {
    origin: "git".to_string(),
    message: "reference not found".to_string(),
};
assert!(err.to_string().contains("git error"));

Fields

origin: String

Short identifier for the library or domain (e.g. "git", "gitlab").

message: String

Human-readable error description from the underlying library.

Implementations

impl OperationError

pub fn deserialize<T>(error: impl Display) -> Self

Build a Deserialize error for type T.

Trait Implementations

impl Debug for OperationError

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

Formats the value using the given formatter.

impl Display for OperationError

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

Formats the value using the given formatter.

impl Error for OperationError

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<AgentError> for OperationError

fn from(source: AgentError) -> Self

Converts to this type from the input type.