Struct StatsHandle 

pub struct StatsHandle { /* private fields */ }

Read-only handle exposing auto-counted [SessionStatus] metrics to the Lua bridge (e.g. alc.stats.llm_calls()).

Cloned per session and per fork-child VM. Each holds an Arc<Mutex<SessionStatus>> shared with the observer that writes to llm_calls on every paused-cycle complete.

Poison policy

Read methods return 0 (or sensible defaults) on mutex poison — they are observational and non-fatal, mirroring BudgetHandle::remaining. Reads do not mutate SessionStatus.

Implementations

impl StatsHandle

pub fn llm_calls(&self) -> u64

Total LLM calls observed in the current session so far.

Returns 0 on mutex poison (observational; matches the Null fallback used by BudgetHandle::remaining). Within a single session the Lua thread is the only writer path, so poison only occurs when an observer callback panicked under the lock — an unrecoverable state where 0 is acceptable.

Trait Implementations

impl Clone for StatsHandle

fn clone(&self) -> StatsHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.