Struct Sim 

pub struct Sim { /* private fields */ }

A deterministic, model-free driver for a compiled conversation.

Implementations

impl Sim

pub fn new(convo: &CompiledConversation, mode: Enforcement) -> Self

Build a simulator over convo in the given enforcement mode.

pub fn set(&self, key: impl Into<String>, value: impl Serialize) -> &Self

Set a state value directly (information a recognizer can’t supply, or a scripted shortcut). Does not advance a turn.

pub async fn user(&mut self, utterance: &str) -> &mut Self

The fake user speaks: run the conversation’s extractors over the utterance to fill slots (respecting validators), then advance a turn.

pub fn turn(&mut self) -> &mut Self

Advance a turn with no new user input (e.g. waiting on a tool/resolver).

pub fn tool_ok(&mut self, tool: &str) -> &mut Self

A tool succeeds now; records it and advances a turn (processing any digression resume).

pub fn schedule_tool( &mut self, tool: impl Into<String>, after: u32, ) -> &mut Self

Schedule a tool to succeed after turns — models tool latency.

pub fn active(&self) -> Vec<String>

Active step ids in the currently-driving layer.

pub fn active_overlay(&self) -> Option<&str>

The active digression, if one is suspending the main flow.

pub fn allowed(&self, tool: &str) -> bool

Whether tool is admitted right now.

pub fn denied(&self) -> BTreeMap<String, String>

Currently-blocked tools, mapped to the reason.

pub fn is_complete(&self) -> bool

Whether the conversation is complete.

pub fn slot<T: DeserializeOwned>(&self, key: &str) -> Option<T>

Read a slot value.

pub fn explain(&self) -> FlowExplanation

The active layer’s control-plane explanation.

pub fn state(&self) -> &State

The simulation state (for custom assertions / slot evidence).