Struct AoConfig 

pub struct AoConfig {
    pub port: u16,
    pub terminal_port: Option<u16>,
    pub direct_terminal_port: Option<u16>,
    pub ready_threshold_ms: u64,
    pub poll_interval: u64,
    pub power: Option<PowerConfig>,
    pub defaults: Option<DefaultsConfig>,
    pub projects: HashMap<String, ProjectConfig>,
    pub reactions: HashMap<String, ReactionConfig>,
    pub notification_routing: NotificationRouting,
    pub notifiers: HashMap<String, PluginConfig>,
    pub plugins: Vec<HashMap<String, Value>>,
}

Top-level ao-rs config file shape. All fields use #[serde(default)] so partial config files parse without error.

Fields

port: u16

Dashboard port (TS: port).

terminal_port: Option<u16>

Terminal server ports (TS: terminalPort, directTerminalPort).

direct_terminal_port: Option<u16>

ready_threshold_ms: u64

Milliseconds before a “ready” session becomes “idle” (TS: readyThresholdMs, default 300000).

poll_interval: u64

Lifecycle polling interval in seconds (default 10).

power: Option<PowerConfig>

Power management settings.

defaults: Option<DefaultsConfig>

Orchestrator-wide plugin defaults.

projects: HashMap<String, ProjectConfig>

Per-project configs keyed by project id.

reactions: HashMap<String, ReactionConfig>

Map from reaction key (e.g. "ci-failed") to its config.

notification_routing: NotificationRouting

Priority-based notification routing table.

notifiers: HashMap<String, PluginConfig>

Notifier plugin configurations (TS: notifiers).

plugins: Vec<HashMap<String, Value>>

External plugins list (installer-managed). Currently stored for parity only.

Implementations

impl AoConfig

pub fn validate(&self, config_path: &Path) -> Result<()>

Validate config semantics (beyond YAML parsing).

Returns Ok(()) when valid, otherwise a AoError::Config with an actionable, field-scoped message including the config file path.

impl AoConfig

pub const CONFIG_FILENAME: &str = "ao-rs.yaml"

Config file name in the project directory (like TS’s agent-orchestrator.yaml).

pub fn load_from_with_warnings(path: &Path) -> Result<LoadedConfig>

Read and parse a config file at an explicit path, collecting warnings for unknown fields and validating the supported subset.

pub fn load_from_or_default_with_warnings(path: &Path) -> Result<LoadedConfig>

Read a config file at an explicit path, or return an empty config if the file doesn’t exist, collecting warnings and validating.

pub fn load_from(path: &Path) -> Result<Self>

Read and parse a config file at an explicit path.

Distinct from load_default because tests should never touch ~/.ao-rs/config.yaml — they pass a tempfile instead.

pub fn load_from_or_default(path: &Path) -> Result<Self>

Read a config file at an explicit path, or return an empty config if the file doesn’t exist. Any other I/O or parse error propagates.

Only NotFound short-circuits to Default::default() — a permission denied or unreadable file should still error, since silently pretending there’s no config would mask a real misconfiguration.

Takes an explicit path (rather than always using default_path()) so tests can exercise both branches without touching $HOME.

pub fn load_default() -> Result<Self>

Load config from the current directory’s ao-rs.yaml, or return an empty config if the file doesn’t exist.

pub fn local_path() -> PathBuf

Config file path discovered from the current working directory.

pub fn path_in(dir: &Path) -> PathBuf

Config file path in a specific directory.

pub fn save_to(&self, path: &Path) -> Result<()>

Write this config to disk as YAML, creating parent dirs if needed.

Trait Implementations

impl Clone for AoConfig

fn clone(&self) -> AoConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AoConfig

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

Formats the value using the given formatter.

impl Default for AoConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AoConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for AoConfig

fn eq(&self, other: &AoConfig) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for AoConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for AoConfig

impl StructuralPartialEq for AoConfig