Struct LuaInProcessSpawnerFactory 

pub struct LuaInProcessSpawnerFactory { /* private fields */ }

Factory for AgentKind::Lua. At build time it looks the fn_id up in its internal registry and returns an InProcSpawner with the Lua-eval WorkerFn registered under agent_name — one InProcSpawner instance per agent.

Naming convention: <WorkerIMPL><AdapterType>SpawnerFactory (Lua worker on InProcess adapter). One half of the old InProcSpawnerFactory, split into Lua and RustFn variants.

Spec shape:

{ "fn_id": "patch-spawner" }     // Lua source id pre-registered with the factory

Implementations

impl LuaInProcessSpawnerFactory

pub fn new() -> Self

Start with no registered scripts and no host bridges.

pub fn with_bridge(self, name: impl Into<String>, bridge: HostBridge) -> Self

Register a host bridge. Subsequent register_lua calls snapshot the current bridge set.

Ordering rule: register bridges first, then call register_lua; bridges added after register_lua will not be visible to that script.

pub fn register_lua( self, fn_id: impl Into<String>, source: LuaScriptSource, ) -> Self

Register a Lua-eval Worker under fn_id.

Each dispatch spins up a fresh mlua::Lua VM, injects globals (_PROMPT / _AGENT / _TASK_ID / _ATTEMPT / _CTX — the last is _PROMPT parsed as JSON, or nil if that fails), evaluates the script, and marshals the returned table into a WorkerResult.

Marshalling rules for the return value:

• { value = ..., ok = bool } → WorkerResult.value / WorkerResult.ok verbatim.
• Anything else → value = <returned value>, ok = true.

Execution runs on tokio::task::spawn_blocking because mlua::Lua is !Send and needs to stay away from the tokio async context. Host bridges (the Lua-to-Rust callback path) previously registered with Self::with_bridge are snapshotted at call time and injected into every dispatch inside run_lua_worker.

Trait Implementations

impl Default for LuaInProcessSpawnerFactory

fn default() -> Self

Returns the “default value” for a type.

impl SpawnerFactory for LuaInProcessSpawnerFactory

fn build( &self, agent_def: &AgentDef, _hint: Option<&Value>, ) -> Result<Arc<dyn SpawnerAdapter>, CompileError>

Build the concrete SpawnerAdapter for one AgentDef. hint is the matching entry (if any) from Blueprint.hints.per_agent.

impl SpawnerFactoryKind for LuaInProcessSpawnerFactory

const KIND: AgentKind = AgentKind::Lua

The AgentKind this factory handles — used as the HashMap key by SpawnerRegistry::register.

type Worker = LuaWorker

The concrete Worker type produced by this AgentKind — this binds the type chain all the way from AgentKind down to Worker. Every factory declares it so the AgentKind → Worker mapping is explicit across all four layers. It is the source of truth for preserving the concrete type right up until SpawnerAdapter::spawn erases it into Box<dyn Worker>.