Struct AgentsConfigFile 

pub struct AgentsConfigFile {
    pub agents: HashMap<String, AgentConfigToml>,
    pub fallback: FallbackConfig,
}

Root TOML configuration structure.

Fields

agents: HashMap<String, AgentConfigToml>

Map of agent name to configuration.

fallback: FallbackConfig

Agent chain configuration (preferred agents + fallbacks).

Implementations

impl AgentsConfigFile

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.

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.

Arguments

• path - Path to the config file (relative to workspace root)
• workspace - The workspace to use for filesystem operations

Returns

Returns Ok(Some(config)) if file exists and parses successfully, Ok(None) if file doesn’t exist, or an error if parsing fails.

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

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

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

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.

Arguments

• path - Path to the config file (relative to workspace root)
• workspace - The workspace to use for filesystem operations

Returns

Returns Ok(ConfigInitResult::AlreadyExists) if file exists, Ok(ConfigInitResult::Created) if file was created from template, or an error if creation fails.

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.