Struct AgentRegistry 

pub struct AgentRegistry { /* private fields */ }

Registry for managing agent configurations and creating agent instances

Supports both TOML-based static config and TOON-based dynamic config. TOML configs take precedence over TOON configs when both exist.

Implementations

impl AgentRegistry

pub fn new( provider_registry: Arc<ProviderRegistry>, tools: Arc<Tools>, ) -> AgentRegistry

Create a new agent registry

pub fn from_config( agents: HashMap<String, AgentConfig>, provider_registry: Arc<ProviderRegistry>, tools: Arc<Tools>, ) -> AgentRegistry

Create an agent registry from TOML agent configs

pub fn with_dynamic_config( agents: HashMap<String, AgentConfig>, provider_registry: Arc<ProviderRegistry>, tools: Arc<Tools>, dynamic_config: Arc<dyn ToonAgents>, ) -> AgentRegistry

Create an agent registry with both TOML and TOON config support

pub fn set_dynamic_config(&mut self, dynamic_config: Arc<dyn ToonAgents>)

Set the dynamic TOON agent lookup

pub fn register(&mut self, name: &str, config: AgentConfig)

Register an agent configuration

pub fn get_config(&self, name: &str) -> Option<&AgentConfig>

Get an agent configuration by name (TOML only)

Note: For lookups that include TOON, use get_config_any instead.

pub fn get_config_any(&self, name: &str) -> Option<AgentConfig>

Get an agent configuration by name from TOML or TOON.

pub fn get_toon_config(&self, name: &str) -> Option<AgentConfig>

Get TOON agent config by name (already converted to AgentConfig)

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

Get all agent names (from both TOML and TOON)

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

Check if an agent exists (in either TOML or TOON config)

pub async fn create_agent( &self, name: &str, ) -> Result<ConfigurableAgent, AppError>

Create an agent instance by name

This creates a new ConfigurableAgent with the appropriate LLM client and tool registry based on the agent’s configuration.

Lookup order:

1. TOML config (ares.toml [agents.*])
2. TOON config (config/agents/*.toon)

pub async fn create_agent_from_config( &self, name: &str, config: &AgentConfig, ) -> Result<ConfigurableAgent, AppError>

Create an agent instance from an explicit configuration

pub async fn create_agent_from_config_with_fallbacks( &self, name: &str, config: &AgentConfig, tenant_id: &str, pool: &Pool<Postgres>, fleet_secrets: &FleetSecrets, ) -> Result<ConfigurableAgent, AppError>

Create an agent instance from an explicit configuration with tier resolution and fallback providers wired in.

pub async fn create_agent_by_type( &self, agent_type: AgentType, ) -> Result<ConfigurableAgent, AppError>

Create an agent instance for a specific AgentType

pub fn type_to_name(agent_type: &AgentType) -> &str

Convert AgentType to agent name

pub fn get_agent_model(&self, name: &str) -> Option<String>

Get the model name for an agent (checks both TOML and TOON)

pub fn get_agent_tools(&self, name: &str) -> Vec<String>

Get the tools for an agent (checks both TOML and TOON). Returns the explicit allowed_tools list, falling back to the legacy tools field. An empty result means no configured tools; runtime execution remains deny-by-default.

pub fn get_agent_system_prompt(&self, name: &str) -> Option<String>

Get the system prompt for an agent (checks both TOML and TOON)

Trait Implementations

impl Service for AgentRegistry

fn name(&self) -> &'static str

fn init( &self, _ctx: &Arc<Context>, ) -> Pin<Box<dyn Future<Output = Result<Option<Box<dyn Disposable>>, CordisError>> + Send + '_>>

fn check(&self) -> bool

Availability predicate for this service instance.