Struct StateContext 

pub struct StateContext {
    pub current_state: String,
    /* private fields */
}

The FSM context injected into state-matched handlers.

Provides typed access to state transitions and arbitrary key-value data associated with the current conversation slot.

Fields

current_state: String

The state key that matched this handler, provided as context.

Implementations

impl StateContext

pub fn new( storage: Arc<dyn StateStorage>, key: StateKey, current_state: String, ) -> Self

Construct a new StateContext. Called internally by the dispatcher.

pub async fn transition( &self, new_state: impl FsmState, ) -> Result<(), StorageError>

Transition to a new state. Overwrites the current state.

pub async fn clear_state(&self) -> Result<(), StorageError>

Clear the current state (set to None). Leaves data intact.

pub async fn set_data<T: Serialize>( &self, field: &str, value: T, ) -> Result<(), StorageError>

Set a typed data value for field. The value is serialized to JSON.

pub async fn get_data<T: DeserializeOwned>( &self, field: &str, ) -> Result<Option<T>, StorageError>

Get a typed data value for field. Returns None if not set.

pub async fn get_all_data(&self) -> Result<HashMap<String, Value>, StorageError>

Return all data fields as a raw JSON map.

pub async fn clear_data(&self) -> Result<(), StorageError>

Remove all data fields. State is unchanged.

pub async fn clear_all(&self) -> Result<(), StorageError>

Reset both state and all data (full conversation reset).

pub fn key(&self) -> &StateKey

The StateKey for this conversation slot.

Trait Implementations

impl Clone for StateContext

fn clone(&self) -> StateContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StateContext

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

Formats the value using the given formatter.