Struct LuaSandbox 

pub struct LuaSandbox { /* private fields */ }

A sandboxed Lua 5.4 VM.

Implementations

impl LuaSandbox

pub fn new() -> SoulResult<Self>

Create a new sandboxed Lua VM.

Removes dangerous globals: io, os, debug, require, loadfile, dofile, load.

pub fn lua(&self) -> &Lua

Get a reference to the inner Lua VM (for registering custom functions).

pub fn set_string(&self, name: &str, value: &str) -> SoulResult<()>

Set a string global variable.

pub fn set_json(&self, name: &str, value: &Value) -> SoulResult<()>

Set a JSON value as a Lua global (recursively converts objects/arrays to tables).

pub fn exec(&self, code: &str) -> SoulResult<String>

Execute Lua code and return the result as a string.

pub async fn exec_with_timeout( &self, code: &str, timeout_secs: u64, ) -> SoulResult<String>

Execute Lua code with a timeout (wall-clock seconds).

pub fn take_output(&self) -> Vec<String>

Take accumulated output buffer contents.

pub fn take_final_answer(&self) -> Option<String>

Check if final_answer has been called, and take the value.

pub fn has_final_answer(&self) -> bool

Check if final_answer has been set (without consuming it).

pub fn get_global_string(&self, name: &str) -> SoulResult<Option<String>>

Read a Lua global variable and return it as a string.

Used by final_var(varname) to return a REPL variable as the answer without requiring the LLM to serialize it into final_answer().

pub fn register_llm_query(&self, channel: LlmQueryChannel) -> SoulResult<()>

Register llm_query(prompt) and llm_query_batched(prompts) functions.

These let Lua code make synchronous sub-LLM calls. The functions block on a channel — the RLM engine fulfills requests asynchronously on the other end.