Enum NodeResult 

#[non_exhaustive]
pub enum NodeResult<U: StateUpdate> {
    Update(U),
    Interrupt(InterruptRequest<U>),
    Error(PeError),
    Converge(ConvergenceSignal<U>),
}

What a node can return — unified enum covering all execution outcomes. Every variant works standalone. Converge adds optional matrix data but degrades to Update automatically when the matrix layer isn’t active.

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.

Update(U)

Normal completion — apply this update to state

Interrupt(InterruptRequest<U>)

Pause for human input — checkpoint and wait

Error(PeError)

Unrecoverable error — propagate to caller

Converge(ConvergenceSignal<U>)

Optional convergence signal — carries quality/surprise metadata. Without the matrix layer, degrades to Update(signal.partial_update). With the matrix layer, the extra metadata guides learned routing.

Implementations

impl<U: StateUpdate> NodeResult<U>

pub fn into_standard(self) -> NodeResult<U>

Strip optional convergence metadata — Converge becomes plain Update. Called automatically by the engine when the matrix layer is not active.

pub fn is_interrupt(&self) -> bool

Check if this result is an interrupt

pub fn is_error(&self) -> bool

Check if this result is an error

Trait Implementations

impl<U: Clone + StateUpdate> Clone for NodeResult<U>

fn clone(&self) -> NodeResult<U>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<U: Debug + StateUpdate> Debug for NodeResult<U>

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

Formats the value using the given formatter.