Struct GatewayConfig 

pub struct GatewayConfig {
    pub mode: DeploymentMode,
    pub local: LocalModeConfig,
    pub remote: RemoteModeConfig,
    pub agent: AgentConnectConfig,
    pub storage: StorageConfig,
}

Top-level gateway configuration loaded at startup.

Composes the four sub-configs and a DeploymentMode flag. All fields use #[serde(default)] so a minimal YAML — even an empty document — deserialises into the documented defaults.

Fields

mode: DeploymentMode

Which topology to boot — local-dev or remote control-plane.

local: LocalModeConfig

Settings for mode = Local.

remote: RemoteModeConfig

Settings for mode = Remote.

agent: AgentConnectConfig

Settings the SDK FFI shim reads to dial the gateway.

storage: StorageConfig

Durable-persistence configuration (Epic 18 — AAASM-1569).

Implementations

impl GatewayConfig

pub fn expand_paths(&mut self)

Expand a leading ~ in every path field to the user’s home directory.

Touches local.storage_path and both remote.tls paths. A no-op when the home directory cannot be resolved or when no field starts with ~. Idempotent — calling twice produces the same result as calling once.

impl GatewayConfig

pub fn apply_env_overrides(&mut self) -> Result<(), ConfigError>

Apply the documented AA_MODE / AAASM_* environment variables on top of self, overriding any fields they set.

Returns ConfigError::InvalidMode / ConfigError::InvalidPort when an env var has been set to a value that cannot be parsed.

impl GatewayConfig

pub fn validate(&self) -> Result<(), ConfigError>

Validate the fully-loaded config — call this after expand_paths and apply_env_overrides so values coming in from env vars are included in the checks.

Currently enforces two storage-retention invariants from E18 S-H (AAASM-1582):

• storage.retention.cold_action = archive requires storage.retention.archive_url to be set (in YAML or by env var) — returns ConfigError::ArchiveUrlRequired.
• storage.retention.warm_days must be strictly greater than storage.retention.hot_days — returns ConfigError::WarmDaysNotGreaterThanHotDays.

impl GatewayConfig

pub fn resolve_storage_backend(&mut self)

Infer storage.backend from mode when it was not explicitly set in YAML or via the AAASM_STORAGE_BACKEND env var.

• mode: Local → storage.backend = Sqlite
• mode: Remote → storage.backend = Postgres

No-op when the operator explicitly set storage.backend in YAML or via AAASM_STORAGE_BACKEND — their choice always wins, including the odd-but-valid mode: remote + storage.backend: sqlite combo (an in-memory test runner pointed at the remote API surface).

Trait Implementations

impl Clone for GatewayConfig

fn clone(&self) -> GatewayConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GatewayConfig

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

Formats the value using the given formatter.

impl Default for GatewayConfig

fn default() -> GatewayConfig

Returns the “default value” for a type.

impl Eq for GatewayConfig

impl PartialEq for GatewayConfig

fn eq(&self, other: &GatewayConfig) -> 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 StructuralPartialEq for GatewayConfig