Struct StateMachine 

pub struct StateMachine { /* private fields */ }

Implementations

impl StateMachine

pub fn new(config: StateConfig) -> Result<StateMachine, AgentError>

pub fn current(&self) -> String

pub fn previous(&self) -> Option<String>

pub fn current_definition(&self) -> Option<StateDefinition>

pub fn get_definition(&self, state: &str) -> Option<&StateDefinition>

pub fn get_parent_definition(&self) -> Option<StateDefinition>

pub fn current_tool_scope_snapshot(&self) -> (u64, Vec<Vec<ToolRef>>)

Returns the generation and every explicit tool scope from root to current state as one authority snapshot.

pub fn generation(&self) -> u64

Returns the current state-authority generation after any active mutation completes.

pub fn transition_to(&self, state: &str, reason: &str) -> Result<(), AgentError>

Applies one valid transition and advances the authority generation after all state fields are committed.

pub fn available_transitions(&self) -> Vec<Transition>

pub fn auto_transitions(&self) -> Vec<Transition>

pub fn history(&self) -> Vec<StateTransitionEvent>

pub fn increment_turn(&self)

pub fn turn_count(&self) -> u32

pub fn increment_no_transition(&self)

pub fn no_transition_count(&self) -> u32

pub fn reset_no_transition(&self)

pub fn check_fallback(&self) -> Option<String>

pub fn reset(&self)

Restores the initial state and advances generation only when reset changes machine state.

pub fn snapshot(&self) -> StateMachineSnapshot

Captures a consistent persistence snapshot after any active state mutation completes.

pub fn restore(&self, snapshot: StateMachineSnapshot) -> Result<(), AgentError>

Restores a valid snapshot and advances generation only when persisted machine state differs.

pub fn config(&self) -> &StateConfig

pub fn check_timeout(&self) -> Option<String>

pub fn current_depth(&self) -> usize

pub fn is_in_sub_state(&self) -> bool

pub fn parent_state(&self) -> Option<String>

pub fn root_state(&self) -> String

pub fn is_on_cooldown(&self, target: &str, cooldown_turns: u32) -> bool

Check if a transition target is on cooldown (was recently transitioned to).