Struct Session 

pub struct Session { /* private fields */ }

Per-channel evaluator. Owns mutable state across forms (defun-defined symbols persist between requests in the same session via SymbolTable; the wasm ModuleCache reuses compilations of structurally identical forms) and an interrupt handle that cooperatively short-circuits the next form on demand.

Eval pipeline: nomiscript::Compiler::compile_with_mode(Eval) emits a module exporting nomi-eval; the form’s final value rides the function’s (ref null any) return slot and the host walks it into an EvalValue via decode_eval_result.

Implementations

impl Session

pub fn new(ctx: ScriptCtx) -> Result<Self, SessionError>

pub fn ctx(&self) -> &ScriptCtx

pub fn interrupt_handle(&self) -> InterruptHandle

pub fn completions(&self, prefix: &str) -> Vec<String>

Symbol names completing prefix, sorted and deduplicated, for the SLYNK completion rex (M-x sly-complete-symbol / mREPL TAB). The reader folds symbols with make_ascii_uppercase at read time, so the match uppercases the prefix the SAME way (ASCII-only — matching the reader, not full Unicode) and returns the canonical name (it re-reads identically). Skips (SETF …) setf-place names and compiler-internal $… / __… symbols — none are head symbols a user types. An empty prefix lists every completable symbol.

pub fn epoch_bumper(&self) -> EpochBumper

Cooperative cancel handle for an in-flight nomi-eval. Clone and hand to the transport layer: when the client sends a cancel signal (e.g. emacs C-g), call .bump() and the awaiting evaluation traps with EngineError::EpochInterrupt, surfacing on the wire as (:error (:code interrupted ...)).

pub fn cache_size(&self) -> Result<usize, EngineError>

Number of pre-compiled wasm modules currently cached. Used by tests to confirm the phase-4 pre-warm step ran and that subsequent handle_form calls of cached forms don’t trigger a cold compile.

pub async fn handle_form(&mut self, frame: &str) -> String

pub async fn handle_request(&mut self, source: &str) -> EvalOutcome

Structured eval of a single bare form (not an envelope frame): clears the output buffer, runs the form, and returns the captured script output alongside the typed value/error payload. The SLYNK mREPL uses this so it can render :write-string (output) and :write-values / :evaluation-aborted (payload) separately. handle_form is unchanged.

pub async fn handle_file(&mut self, path: &str) -> EvalOutcome

Reads path, evaluates every top-level form in source order (state — defuns etc. — accumulates across forms, like the sshd channel), and returns a short summary. Powers SLY’s M-x sly-load-file (slynk:load-file). Captured output across all forms is returned for the caller to surface; a failing form aborts the load at that point.