Struct Executor 

pub struct Executor { /* private fields */ }

Lua execution engine.

Holds a shared VM for lightweight stateless operations (eval_simple) and spawns per-session VMs for coroutine-based execution (start_session).

Per-session VMs eliminate global namespace pollution between concurrent sessions — each session’s alc, ctx, and package.loaded are fully isolated.

Implementations

impl Executor

pub async fn new(lib_paths: Vec<PathBuf>) -> Result<Self>

pub async fn eval_simple(&self, code: String) -> Result<Value, String>

Evaluate Lua code without LLM bridge. For lightweight operations like reading package metadata.

pub async fn start_session( &self, code: String, ctx: Value, ) -> Result<Session, String>

Start a new Lua execution session on a dedicated VM.

Each session gets its own Lua VM (OS thread + mlua instance) so concurrent sessions cannot interfere with each other’s globals. The VM is cleaned up automatically when the session completes or is abandoned (all senders drop → channel closes → thread exits).