Struct AgentSpawner 

pub struct AgentSpawner { /* private fields */ }

Factory for creating agents at runtime from YAML, specs, or templates.

Implementations

impl AgentSpawner

pub fn new() -> AgentSpawner

pub fn with_shared_llms(self, registry: LLMRegistry) -> AgentSpawner

Share LLM connections across all spawned agents.

pub fn with_shared_storage(self, storage: Arc<dyn AgentStorage>) -> AgentSpawner

Share a storage backend (e.g. one SQLite DB for all NPCs).

pub fn with_shared_context( self, key: impl Into<String>, value: Value, ) -> AgentSpawner

Inject a context value available to all spawned agents.

pub fn with_shared_context_map( self, ctx: HashMap<String, Value>, ) -> AgentSpawner

Inject an entire map of shared context values.

pub fn with_max_agents(self, max: usize) -> AgentSpawner

Limit total spawned agents.

pub fn with_name_prefix(self, prefix: impl Into<String>) -> AgentSpawner

Auto-name agents with prefix + zero-padded counter.

pub fn with_template( self, name: impl Into<String>, yaml_template: impl Into<String>, ) -> AgentSpawner

Register a named template from a plain YAML string (no metadata).

pub fn with_templates( self, templates: HashMap<String, ResolvedTemplate>, ) -> AgentSpawner

Bulk-register resolved templates (with metadata already extracted).

pub fn with_allowed_tools(self, tools: Vec<String>) -> AgentSpawner

Set the tool allowlist for spawned agents.

pub async fn spawn_from_yaml( &self, yaml: &str, ) -> Result<SpawnedAgent, AgentError>

Spawn an agent from a YAML string.

pub async fn spawn_from_spec( &self, spec: AgentSpec, ) -> Result<SpawnedAgent, AgentError>

Spawn an agent from a pre-built AgentSpec.

pub async fn spawn_with_id( &self, id: String, spec: AgentSpec, ) -> Result<SpawnedAgent, AgentError>

Spawn an agent with a specific ID, used for session restore.

pub async fn spawn_from_template( &self, template_name: &str, variables: HashMap<String, String>, ) -> Result<SpawnedAgent, AgentError>

Spawn from a named template with caller-provided variables.

Template rendering merges two namespaces:

• Caller variables: top-level ({{ name }}, {{ role }})
• Shared context: under context. prefix ({{ context.world_name }})

pub fn spawned_count(&self) -> u32

Returns the current number of agents that have been spawned.

pub fn notify_agent_removed(&self)

Decrement the agent count (called when an agent is removed from the registry).

pub fn llm_registry(&self) -> Option<&LLMRegistry>

Returns a reference to the shared LLM registry, if configured.

pub fn shared_storage(&self) -> Option<&Arc<dyn AgentStorage>>

Returns a reference to the shared storage, if configured.

pub fn templates(&self) -> &HashMap<String, ResolvedTemplate>

Returns a reference to the resolved template map.

Trait Implementations

impl Default for AgentSpawner

fn default() -> AgentSpawner

Returns the “default value” for a type.