Struct LuaPluginOptions 

pub struct LuaPluginOptions {
    pub memory_mb: u32,
    pub max_instructions: u64,
    pub http_timeout: Duration,
    pub network_allow: Vec<String>,
    pub network: bool,
    pub env_access: bool,
    pub sober: Option<SoberHost>,
    pub repo_root: Option<PathBuf>,
}

Tunable knobs for a LuaPlugin VM.

Defaults are conservative and align with Capabilities::legacy_default(): 64 MB memory, 10 M instructions per hook call, 5 s HTTP timeout.

[HAZMAT] The instruction cap is best-effort under LuaJIT. LuaJIT’s tracing JIT can compile a tight integer loop into native code that bypasses debug hooks; the cap will not trip on that specific pathology until the loop calls a function or touches a table / string. In practice every real plugin does. The memory cap and HTTP timeout are not affected by JIT and remain hard limits.

Fields

memory_mb: u32

Heap memory ceiling in megabytes. Counted by the Lua GC.

max_instructions: u64

Hard cap on Lua instructions per single hook call. Set to 0 to disable (not recommended).

http_timeout: Duration

Per-request HTTP timeout.

network_allow: Vec<String>

If set, restrict outbound HTTP to these hosts (suffix match).

network: bool

Master switch for outbound HTTP.

env_access: bool

Allow os.getenv. Disable in hardened deployments.

sober: Option<SoberHost>

Host-provided Sober bridge. Only set when the manifest grants it.

repo_root: Option<PathBuf>

Repository root; used to scope the plugin’s storage table.

Implementations

impl LuaPluginOptions

pub fn from_capabilities(caps: &Capabilities) -> Self

Derive runtime options from a manifest capability block.

Trait Implementations

impl Clone for LuaPluginOptions

fn clone(&self) -> LuaPluginOptions

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LuaPluginOptions

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for LuaPluginOptions

fn default() -> Self

Returns the “default value” for a type.