Enum DispatchOutcome 

#[non_exhaustive]
pub enum DispatchOutcome {
    Pass(Value),
    Blocked(Value),
    Skip(Value),
    Suspended(ResumeKey),
    Cancelled,
    Timeout,
}

Result of a dispatch_attempt_with call (or the conceptual outcome of a task attempt more broadly).

#[non_exhaustive] (GH #76 Skip tier) so future tier additions (e.g. a Deferred sibling of Skip) are additive — external crates cannot exhaustively match on this enum, and must include a _ arm.

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.

Pass(Value)

The attempt completed with ok = true; carries the result value.

Blocked(Value)

The attempt completed with ok = false, or dispatch itself failed; carries the result/error value.

Skip(Value)

GH #76 Skip tier: sibling tier of Self::Pass / Self::Blocked. The worker completed successfully (ok = true) but declared its output is NOT applicable to the surrounding flow — the enclosing [crate::blueprint::EngineDispatcher::dispatch] treats this as flow-continuation (does NOT propagate an error to flow-ir) while short-circuiting the write to the step’s declared out binding. Carries the returning agent’s verdict payload for observability (StepEntry.status = "skipped"); downstream $.<step_id> references see whatever pre-existing value the binding held (typically absent). Mirrors spawn_halt’s “ok=true + marker” wire pattern.

Suspended(ResumeKey)

The task suspended (e.g. via query_senior) before completing; carries the key needed to resume it.

Cancelled

The task was cancelled before completing.

Timeout

The attempt did not complete within the allotted time.

Trait Implementations

impl Clone for DispatchOutcome

fn clone(&self) -> DispatchOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DispatchOutcome

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for DispatchOutcome

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for DispatchOutcome

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.