Struct DynamicConfigManager 

pub struct DynamicConfigManager { /* private fields */ }

Manager for dynamic TOON configuration with hot-reload support

This manager:

• Loads all TOON configs at startup
• Watches config directories for changes
• Atomically swaps config on changes (lock-free reads)
• Provides convenient accessor methods

Example

let manager = DynamicConfigManager::new(
    PathBuf::from("config/agents"),
    PathBuf::from("config/models"),
    PathBuf::from("config/tools"),
    PathBuf::from("config/workflows"),
    PathBuf::from("config/mcps"),
    true, // hot_reload
)?;

// Get an agent config (lock-free)
if let Some(router) = manager.agent("router") {
    println!("Router uses model: {}", router.model);
}

Implementations

impl DynamicConfigManager

pub fn from_config(config: &AresConfig) -> Result<Self, ToonConfigError>

Create DynamicConfigManager from AresConfig

This uses the paths defined in config.config (DynamicConfigPaths) to initialize the manager.

pub fn reload(&self) -> Result<Vec<ConfigWarning>, ToonConfigError>

Reload TOON files from the configured directories (Overlay watch callback).

pub fn new( agents_dir: PathBuf, models_dir: PathBuf, tools_dir: PathBuf, workflows_dir: PathBuf, mcps_dir: PathBuf, hot_reload: bool, ) -> Result<Self, ToonConfigError>

Create a new DynamicConfigManager

Arguments

• agents_dir - Directory containing agent TOON files
• models_dir - Directory containing model TOON files
• tools_dir - Directory containing tool TOON files
• workflows_dir - Directory containing workflow TOON files
• mcps_dir - Directory containing MCP TOON files
• hot_reload - Whether to watch for file changes

pub fn set_version_tx(&self, tx: UnboundedSender<Vec<ToonAgentConfig>>)

Attach a version tracking sender. After this call, every hot-reload emits the updated agent list to this channel for a background task to persist to DB.

pub fn config(&self) -> Guard<Arc<DynamicConfig>>

Get current config snapshot (lock-free)

pub fn agent(&self, name: &str) -> Option<ToonAgentConfig>

Get a specific agent config

pub fn model(&self, name: &str) -> Option<ToonModelConfig>

Get a specific model config

pub fn tool(&self, name: &str) -> Option<ToonToolConfig>

Get a specific tool config

pub fn workflow(&self, name: &str) -> Option<ToonWorkflowConfig>

Get a specific workflow config

pub fn mcp(&self, name: &str) -> Option<ToonMcpConfig>

Get a specific MCP config

pub fn agents(&self) -> Vec<ToonAgentConfig>

Get all agents

pub fn models(&self) -> Vec<ToonModelConfig>

Get all models

pub fn tools(&self) -> Vec<ToonToolConfig>

Get all tools

pub fn workflows(&self) -> Vec<ToonWorkflowConfig>

Get all workflows

pub fn mcps(&self) -> Vec<ToonMcpConfig>

Get all MCPs

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

Get all agent names

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

Get all model names

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

Get all tool names

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

Get all workflow names

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

Get all MCP names

pub fn upsert_agent(&self, agent: ToonAgentConfig)

Hot-swap a single agent config in the in-memory cache (used for rollback). Does not write to disk — disk files are the canonical source on next restart.

Trait Implementations

impl Service for DynamicConfigManager

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

fn init(&self, _ctx: &Arc<Context>) -> ServiceInitFuture<'_>

fn check(&self) -> bool

Availability predicate for this service instance.

impl ToonAgents for DynamicConfigManager

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

Agent config by name, already converted from TOON.

fn names(&self) -> Vec<String>

Names present in the TOON set.