Struct LuaRuntime 

pub struct LuaRuntime { /* private fields */ }

Manages the Lua state for extensions.

Implementations

impl LuaRuntime

pub fn new() -> Result<Self, LuaError>

Create a new Lua runtime with standard libraries.

pub fn lua(&self) -> &Lua

Get a reference to the underlying Lua state.

pub fn tools(&self) -> Arc<Mutex<Vec<LuaToolHandle>>>

Get a clone of the tools handle for external access.

pub fn hooks(&self) -> Arc<Mutex<Vec<LuaHookHandle>>>

Get a clone of the hooks handle for external access.

pub fn commands(&self) -> Arc<Mutex<Vec<LuaCommandHandle>>>

Get a clone of the commands handle for external access.

pub fn native_tools(&self) -> Arc<Mutex<HashMap<String, Arc<dyn Tool>>>>

Get a clone of the native tools map.

pub fn call_context(&self) -> Arc<Mutex<Option<LuaCallContext>>>

Get a clone of the call context handle.

pub fn allowed_env(&self) -> Arc<Mutex<HashSet<String>>>

Get a clone of the allowed-env handle.

pub fn allow_shell_exec(&self) -> Arc<AtomicBool>

Get whether imp.exec() calls are currently permitted.

pub fn allow_http(&self) -> Arc<AtomicBool>

Get whether imp.http.* calls are currently permitted.

pub fn allow_secrets(&self) -> Arc<AtomicBool>

Get whether secret access is currently permitted.

pub fn allow_native_tool_calls(&self) -> Arc<AtomicBool>

Get whether imp.tool() calls are currently permitted.

pub fn set_native_tools(&self, tools: HashMap<String, Arc<dyn Tool>>)

Populate the native tool registry (called once after tools are registered).

pub fn set_call_context(&self, ctx: LuaCallContext)

Set the call context before executing a Lua tool function.

pub fn clear_call_context(&self)

Clear the call context after execution.

pub fn set_allowed_env(&self, vars: HashSet<String>)

Set the allowed env vars for this extension.

pub fn set_allow_shell_exec(&self, allowed: bool)

Set whether imp.exec() calls are permitted for the current runtime.

pub fn set_allow_http(&self, allowed: bool)

Set whether imp.http.* calls are permitted for the current runtime.

pub fn set_allow_secrets(&self, allowed: bool)

Set whether secret access is permitted for the current runtime.

pub fn set_allow_native_tool_calls(&self, allowed: bool)

Set whether imp.tool() calls are permitted for the current runtime.

pub fn apply_capability_policy(&self, policy: &LuaCapabilityPolicy)

Apply a shipped-runtime capability policy.

pub fn register_tool(&self, handle: LuaToolHandle)

Register a tool handle (called from bridge).

pub fn register_hook(&self, handle: LuaHookHandle)

Register a hook handle (called from bridge).

pub fn register_command(&self, handle: LuaCommandHandle)

Register a command handle (called from bridge).

pub fn exec(&self, source: &str) -> Result<(), LuaError>

Execute a Lua script string.

pub fn exec_file(&self, path: &Path) -> Result<(), LuaError>

Execute a Lua file.

pub fn clear_registrations(&self)

Clear all registered tools, hooks, and commands.

pub fn tool_count(&self) -> usize

Number of registered tools.

pub fn hook_count(&self) -> usize

Number of registered hooks.

pub fn command_count(&self) -> usize

Number of registered commands.

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

Get tool names.

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

Get hook event names.

pub fn execute_command( &self, name: &str, args: &str, ) -> Result<Option<String>, LuaError>

Execute a registered command by name, returning its string output.

Returns Ok(None) if the command returned nil (silent success). Returns Ok(Some(text)) if the command returned a string or value. Returns Err if the command handler or name wasn’t found.

pub fn execute_command_with_context( &self, name: &str, args: &str, call_ctx: Option<LuaCallContext>, ) -> Result<Option<String>, LuaError>

Execute a registered command with an optional host call context.

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

Get command names.

pub fn command_summaries(&self) -> Vec<(String, String)>

Get command names with descriptions for menus and discovery.

pub fn has_command(&self, name: &str) -> bool

Check if a command with the given name exists.