Struct ConversationStateMachine 

pub struct ConversationStateMachine { /* private fields */ }

Finite-state machine that advances a conversation through its lifecycle.

Example

use tokio_prompt_orchestrator::conversation_state::{
    ConversationStateMachine, TransitionTrigger,
};

let mut sm = ConversationStateMachine::new();
let new_phase = sm.trigger(TransitionTrigger::TaskMentioned, 1_000);
assert!(new_phase.is_some());

Implementations

impl ConversationStateMachine

pub fn new() -> Self

Create a new state machine starting in ConversationPhase::Opening.

pub fn current_phase(&self) -> &ConversationPhase

Return the current phase.

pub fn trigger( &mut self, trigger: TransitionTrigger, now: u64, ) -> Option<ConversationPhase>

Apply a trigger. Returns the new phase if a transition occurred, or None if the machine is in a terminal state or no rule matched.

pub fn can_transition( from: &ConversationPhase, trigger: &TransitionTrigger, ) -> bool

Return true if the given trigger can fire from from.

pub fn history(&self) -> &[PhaseTransition]

Return the full transition history.

pub fn time_in_current_phase(&self, now: u64) -> u64

Milliseconds spent in the current phase as of now.

pub fn detect_trigger(user_text: &str) -> Option<TransitionTrigger>

Heuristic trigger detection from raw user text.

Rules (checked in order):

• “bye” / “goodbye” / “close” → TransitionTrigger::ExplicitClose
• “thank” / “thanks” → TransitionTrigger::UserSatisfied
• “hello” / “hi” / “hey” → TransitionTrigger::UserGreeting
• text contains “?” → TransitionTrigger::QuestionAsked
• any other non-empty text → TransitionTrigger::TaskMentioned

Trait Implementations

impl Default for ConversationStateMachine

fn default() -> Self

Returns the “default value” for a type.