Struct AgentsConfigFile 

pub struct AgentsConfigFile {
    pub agents: HashMap<String, AgentConfigToml>,
    pub agent_chains: HashMap<String, Vec<String>>,
    pub agent_drains: HashMap<String, String>,
    pub fallback: Option<FallbackConfig>,
    /* private fields */
}

Root TOML configuration structure.

Fields

agents: HashMap<String, AgentConfigToml>

Map of agent name to configuration.

agent_chains: HashMap<String, Vec<String>>

Named reusable agent chains.

agent_drains: HashMap<String, String>

Built-in drain bindings to named chains.

fallback: Option<FallbackConfig>

Legacy agent chain configuration (preferred agents + fallbacks).

Implementations

impl AgentsConfigFile

pub fn resolve_drains_checked( &self, ) -> Result<Option<ResolvedDrainConfig>, AgentConfigError>

Resolve the configured agent chains into explicit built-in drains.

Returns None when the file defines no chain configuration at all.

Errors

Returns error if the named chain/drain schema is internally inconsistent or mixed with the legacy [agent_chain] table.

pub fn load_from_file<P: AsRef<Path>>( path: P, ) -> Result<Option<Self>, AgentConfigError>

Load agents config from a file, returning None if file doesn’t exist.

Errors

Returns error if:

• File cannot be read
• File contents are not valid TOML

pub fn load_from_file_with_workspace( path: &Path, workspace: &dyn Workspace, ) -> Result<Option<Self>, AgentConfigError>

Load agents config from a file using workspace abstraction.

This is the architecture-conformant version that uses the Workspace trait instead of direct filesystem access, allowing for proper testing with MemoryWorkspace.

Errors

Returns error if:

• File cannot be read from workspace
• File contents are not valid TOML

pub fn ensure_config_exists<P: AsRef<Path>>( path: P, ) -> Result<ConfigInitResult, Error>

Ensure agents config file exists, creating it from template if needed.

Errors

Returns error if:

• Parent directories cannot be created
• Default template cannot be written to file

pub fn ensure_config_exists_with_workspace( path: &Path, workspace: &dyn Workspace, ) -> Result<ConfigInitResult, Error>

Ensure agents config file exists using workspace abstraction.

This is the architecture-conformant version that uses the Workspace trait instead of direct filesystem access, allowing for proper testing with MemoryWorkspace.

Errors

Returns error if:

• Parent directories cannot be created in workspace
• Default template cannot be written to workspace

Trait Implementations

impl Clone for AgentsConfigFile

fn clone(&self) -> AgentsConfigFile

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AgentsConfigFile

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentsConfigFile

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.