Struct LuaRuntime 

pub struct LuaRuntime {
    source: String,
    modules_path: Option<PathBuf>,
    timeout_ms: u64,
}

Holds a validated Lua script and executes it against a Context.

A fresh Lua VM is created for every execution, so scripts cannot leak state between requests; only the source text is retained between calls.

Fields

source: String

The full script source, re-loaded into a fresh VM per execution.

modules_path: Option<PathBuf>

Directory the sandboxed require resolves modules from; None disables require.

timeout_ms: u64

Configured execution timeout in milliseconds (currently stored but not enforced by the VM).

Implementations

impl LuaRuntime

pub fn new( source: &str, timeout_ms: u64, modules_path: Option<PathBuf>, ) -> Result<Self, String>

Compiles and validates the script in a throwaway VM, failing early if the source has syntax errors, its top level errors on load, or it does not define a global execute function. This runs once at policy-compile time, not per request.

pub fn execute(&self, ctx: Context) -> Result<Context, PluginExecutionError>

Runs the script’s execute(ctx) against the given context in a fresh VM and returns the context rebuilt from the table the script returned.

Every failure mode (load, marshalling either way, missing execute, or a runtime error raised by the script) returns a PluginExecutionError carrying the original context, with a distinguishing error code (LUA_LOAD_ERROR, LUA_MARSHAL_ERROR, LUA_MISSING_EXECUTE, LUA_EXECUTION_ERROR, LUA_UNMARSHAL_ERROR), so the graph engine routes through the error port exactly like a native plugin failure.