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.

Uses the shared VM. extra_lib_paths must be empty — use [eval_simple_with_paths] when project-local paths are needed.

pub async fn eval_simple_with_paths( &self, code: String, extra_lib_paths: Vec<PathBuf>, ) -> Result<Value, String>

Evaluate Lua code without LLM bridge, with optional extra package paths.

When extra_lib_paths is empty, reuses the shared VM (cheap). When non-empty, spawns a dedicated VM so the extra resolvers are active (slightly more expensive, but pkg_list is the only caller and it is low-frequency).

pub async fn start_session( &self, code: String, ctx: Value, extra_lib_paths: Vec<PathBuf>, ) -> 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).

extra_lib_paths are prepended to self.lib_paths so project-local packages take precedence over the global package directory.