Struct LuaChild 

pub struct LuaChild { /* private fields */ }

A child entity implemented in Lua.

Can be used inside a LuaComponent to manage child entities.

Lua Table Format

Basic Child (no run capability)

{
    id = "child-1",
    status = "Idle",  -- Optional, defaults to "Idle"

    on_signal = function(sig)
        return "Handled" | "Ignored" | "Abort"
    end,

    abort = function()  -- Optional
    end,
}

Runnable Child (with run capability)

{
    id = "worker-1",

    run = function(input)
        -- Perform work
        return { success = true, data = { result = input.value * 2 } }
    end,

    on_signal = function(sig)
        return "Handled"
    end,
}

Implementations

impl LuaChild

pub fn from_table( lua: Arc<Mutex<Lua>>, table: Table, sandbox: Arc<dyn SandboxPolicy>, ) -> Result<Self, LuaError>

Creates a LuaChild from a Lua table.

Arguments

• lua - Shared Lua runtime
• table - Lua table defining the child
• sandbox - Sandbox policy for file operations and exec cwd

Errors

Returns error if table is missing required fields.

pub fn set_context(&mut self, context: Box<dyn ChildContext>)

Sets the runtime context for this child.

The context enables spawning sub-children and emitting output. Call this before running the child.

pub fn has_context(&self) -> bool

Returns true if this child has a context set.

pub fn from_table_runnable( lua: Arc<Mutex<Lua>>, table: Table, sandbox: Arc<dyn SandboxPolicy>, ) -> Result<Self, LuaError>

Creates a LuaChild from a Lua table, requiring a run callback.

Use this when you need a RunnableChild that can execute work.

Arguments

• lua - Shared Lua runtime
• table - Lua table defining the child (must have run function)
• sandbox - Sandbox policy for file operations and exec cwd

Errors

Returns error if table is missing required fields including run.

pub fn is_runnable(&self) -> bool

Returns true if this child has a run callback (is runnable).

pub fn simple( lua: Arc<Mutex<Lua>>, id: impl Into<String>, sandbox: Arc<dyn SandboxPolicy>, ) -> Result<Self, LuaError>

Creates a simple LuaChild with just an ID.

The on_signal callback will return Ignored for all signals.

Arguments

• lua - Shared Lua runtime
• id - Child identifier
• sandbox - Sandbox policy for file operations and exec cwd

pub fn from_script( lua: Arc<Mutex<Lua>>, script: &str, sandbox: Arc<dyn SandboxPolicy>, ) -> Result<Self, LuaError>

Creates a LuaChild from inline script content.

The script should return a Lua table with the child definition.

Arguments

• lua - Shared Lua runtime
• script - Inline Lua script
• sandbox - Sandbox policy for file operations and exec cwd

Errors

Returns error if script is invalid or missing required fields.

Trait Implementations

impl Child for LuaChild

fn set_context(&mut self, ctx: Box<dyn ChildContext>)

Inject a ChildContext so the child can use orcs.* functions at runtime (RPC, exec, spawn, file tools, etc.).

impl Identifiable for LuaChild

fn id(&self) -> &str

Returns the entity’s identifier.

impl RunnableChild for LuaChild

fn run(&mut self, input: Value) -> ChildResult

Execute work with the given input (synchronous).

impl SignalReceiver for LuaChild

fn on_signal(&mut self, signal: &Signal) -> SignalResponse

Handle an incoming signal.

fn abort(&mut self)

Immediate abort.

impl Statusable for LuaChild

fn status(&self) -> Status

Returns the current status.

fn status_detail(&self) -> Option<StatusDetail>

Returns detailed status information.

impl Send for LuaChild

impl Sync for LuaChild