Enum AgentState 

pub enum AgentState {
    Idle,
    Gathering {
        scope_id: ScopeId,
    },
    Planning {
        scope_id: ScopeId,
    },
    Executing {
        scope_id: ScopeId,
        tool_call_id: String,
    },
    Waiting {
        for_event_type: String,
    },
    Delegating {
        to: AgentId,
        delegation_id: DelegationId,
    },
    Complete {
        scope_id: ScopeId,
    },
    Failed {
        scope_id: ScopeId,
        error: String,
    },
}

Agent state derived from event history (NOT stored in DB)

Variants

Idle

Gathering

Fields

scope_id: ScopeId

Planning

Fields

scope_id: ScopeId

Executing

Fields

scope_id: ScopeId

tool_call_id: String

Waiting

Fields

for_event_type: String

Delegating

Fields

to: AgentId

delegation_id: DelegationId

Complete

Fields

scope_id: ScopeId

Failed

Fields

scope_id: ScopeId

error: String

Implementations

impl AgentState

pub fn from_events(events: &[Event<Value>]) -> Self

Derive agent state from event history by scanning in chronological order. Handles SCOPE_CREATED/SCOPE_CLOSED, DELEGATION_*, and AGENT_STATUS_CHANGED.

AGENT_STATUS_CHANGED events carry a "status" field in their payload. Recognised values: "executing", "waiting", "failed", "idle". This prevents silent state divergence when an agent crashes mid-execution and an explicit status change event is emitted.

pub fn can_transition_to(&self, target: &AgentState) -> bool

Check if a transition from current state to target state is valid. Valid transitions per the state machine:

• Idle -> Gathering, Delegating
• Gathering -> Planning, Failed
• Planning -> Executing, Failed
• Executing -> Waiting, Complete, Failed
• Waiting -> Executing, Failed
• Delegating -> Idle, Failed
• Complete -> Idle
• Failed -> Idle

pub fn valid_transitions(&self) -> Vec<AgentState>

Return a vector of states reachable from the current state. Uses placeholder data where necessary (scope_id preserved when available).

Trait Implementations

impl Clone for AgentState

fn clone(&self) -> AgentState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentState

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentState

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for AgentState

fn eq(&self, other: &AgentState) -> 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 Serialize for AgentState

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for AgentState

impl StructuralPartialEq for AgentState