Enum ActivationReason 

#[non_exhaustive]
pub enum ActivationReason {
    EntryPoint,
    Edge {
        from: String,
    },
    ConditionalEdge {
        from: String,
    },
    Resume,
    Retry {
        attempt: u32,
    },
}

Why a node was activated in a particular superstep.

Tracks the causal chain of execution. Useful standalone:

• Debugging: trace execution flow through the graph
• HITL: show humans WHY a node will run (“activated by edge from chat”)
• Streaming: emit activation events as they happen

The optional matrix layer also uses activation patterns as training data to learn which routing paths lead to convergence.

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.

EntryPoint

First nodes activated from START edges.

Edge

Activated by a fixed edge from a completed node.

Fields

from: String

The node whose completion triggered this activation.

ConditionalEdge

Activated by a conditional edge (router selected this node).

Fields

from: String

The node whose router selected this activation.

Resume

Resumed after an interrupt (human-in-the-loop).

Retry

Re-executed after a retryable failure.

Fields

attempt: u32

Which retry attempt this is (1-based).

Trait Implementations

impl Clone for ActivationReason

fn clone(&self) -> ActivationReason

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ActivationReason

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ActivationReason

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ActivationReason

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

where __S: Serializer,

Serialize this value into the given Serde serializer.