Struct AttemptOutcome 

pub struct AttemptOutcome { /* private fields */ }

Semantic grouping of attempt result kind, optional error detail, and optional opaque handler output.

The result and error fields are semantically coupled: the error message is only meaningful in the context of its result kind. The output field is an opaque byte payload that successful handlers can use to return structured data to the dispatch loop / projection (e.g., ContextStore references).

Implementations

impl AttemptOutcome

pub fn success() -> Self

Creates a successful outcome with no error detail and no output.

pub fn success_with_output(output: Vec<u8>) -> Self

Creates a successful outcome carrying opaque output bytes.

An empty vec is normalized to None (no output).

pub fn failure(error: impl Into<String>) -> Self

Creates a failure outcome with an error message.

pub fn timeout(error: impl Into<String>) -> Self

Creates a timeout outcome with an error message.

pub fn suspended() -> Self

Creates a suspended outcome with no output.

Suspended attempts do not count toward the max_attempts retry cap.

pub fn suspended_with_output(output: Vec<u8>) -> Self

Creates a suspended outcome carrying opaque partial-state bytes.

An empty vec is normalized to None (no output). The handler may use this to persist partial execution state for use when the run resumes.

pub fn from_raw_parts( result: AttemptResultKind, error: Option<String>, output: Option<Vec<u8>>, ) -> Result<Self, AttemptOutcomeError>

Reconstructs an outcome from raw parts with semantic validation.

This is intended for WAL replay / deserialization paths where the result kind, error, and output are stored separately. Validates that:

• Success / Suspended have error == None (output is optional)
• Failure / Timeout have error == Some(_) and output == None

Errors

Returns AttemptOutcomeError if the result kind and error do not satisfy the semantic coupling invariant.

pub fn result(&self) -> AttemptResultKind

Returns the canonical attempt result kind.

pub fn error(&self) -> Option<&str>

Returns the optional error detail.

pub fn output(&self) -> Option<&[u8]>

Returns the optional opaque output bytes produced by the handler.

pub fn into_parts(self) -> (AttemptResultKind, Option<String>, Option<Vec<u8>>)

Consumes the outcome, returning its parts for ownership transfer.

Trait Implementations

impl Clone for AttemptOutcome

fn clone(&self) -> AttemptOutcome

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AttemptOutcome

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

Formats the value using the given formatter.

impl PartialEq for AttemptOutcome

fn eq(&self, other: &AttemptOutcome) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for AttemptOutcome

impl StructuralPartialEq for AttemptOutcome