Struct Session 

pub struct Session { /* private fields */ }

A Lua execution session with domain state tracking.

Each session owns a dedicated Lua VM via _vm_driver. The VM’s OS thread stays alive as long as the driver is held, and exits cleanly when the session is dropped (channel closes → Lua thread drains and exits).

Implementations

impl Session

pub fn new( llm_rx: Receiver<LlmRequest>, exec_task: AsyncTask, metrics: ExecutionMetrics, vm_driver: AsyncIsleDriver, ) -> Self

Create a new session.

Arguments

• llm_rx — Receiver for LLM requests from the Lua bridge.
• exec_task — The coroutine execution task handle.
• metrics — Session metrics (owns the LogSink ring buffer; the bridge reads its log_sink_handle() separately to wire print() / alc.log() into the same ring buffer that metrics.snapshot() exposes via recent_logs in alc_status).
• vm_driver — Keeps the Lua OS thread alive.

Returns

A new Session in the Running state.

pub fn snapshot( &self, pending_filter: Option<&PendingFilter>, include_history: bool, ) -> Value

Lightweight snapshot for external observation (alc_status).

Returns session state label and running metrics without consuming or modifying the session.

Arguments

• pending_filter — Opt-in projection for the currently pending LLM queries. None emits only pending_queries: N (integer count), preserving the v0.x wire shape for light-weight polling. Some(filter) adds a pending: [...] array projected through the filter’s field flags.
• include_history — When true, conversation_history (≤10 entries) is included in the metrics output. When false (default), the key is absent. High-frequency polling callers should leave this false to avoid wire bloat.

Returns

A serde_json::Value snapshot with the following additive fields beyond v0.x:

• phase — 5-value string derived from ExecutionState: "running", "paused", "completed", "failed", "cancelled". The existing state key is retained for backward compatibility (3-value).
• started_at — Unix millisecond timestamp when the session was created.
• last_activity_at — Unix millisecond timestamp of the most recent feed_one. Note: started_at and last_activity_at are wall-clock values while expiry GC uses the monotonic last_active Instant; they may skew slightly on NTP adjustments (acceptable for observability use).

pub fn is_expired(&self, ttl: Duration) -> bool

Returns true if the session has been idle longer than ttl.

Uses saturating_duration_since to avoid panics if the clock drifts backwards (though this is extremely rare with monotonic clocks).