Struct Config 

pub struct Config {
    pub modules_path: Option<PathBuf>,
    pub executor: ExecutorConfig,
    pub observability: ObservabilityConfig,
    pub user_namespaces: HashMap<String, Value>,
    pub yaml_path: Option<PathBuf>,
    pub mode: ConfigMode,
}

Top-level apcore configuration (PROTOCOL_SPEC §9.1).

Canonical wire format is a nested JSON/YAML object with executor, observability, and any user-defined namespaces as siblings:

modules_path: ./modules
executor:
  max_call_depth: 32
  default_timeout: 30000
observability:
  tracing:
    enabled: true
my_vendor:
  custom_setting: foo

v0.18.0 BREAKING CHANGE. Prior versions accepted root-level max_call_depth, default_timeout_ms, etc. The custom Deserialize impl now rejects these with a hard error pointing at MIGRATION-v0.18.md.

Fields

modules_path: Option<PathBuf>

executor: ExecutorConfig

observability: ObservabilityConfig

user_namespaces: HashMap<String, Value>

User-defined and vendor namespaces. Captures any top-level key not matching a canonical namespace above. Per spec §9.1, custom namespace names should follow [a-z][a-z0-9-]*.

yaml_path: Option<PathBuf>

mode: ConfigMode

Implementations

impl Config

pub fn from_json_file(path: &Path) -> Result<Self, ModuleError>

Load config from a JSON file, apply env overrides, and validate.

pub fn from_yaml_file(path: &Path) -> Result<Self, ModuleError>

Load config from a YAML file, apply env overrides, and validate.

pub fn load(path: &Path) -> Result<Self, ModuleError>

Auto-detect format by file extension and load.

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

Validate config constraints. Returns an error listing all violations.

pub fn from_defaults() -> Self

Build config from defaults, applying env var overrides.

pub fn discover() -> Result<Self, ModuleError>

Discover and load config using the §9.14 search order.

If no file is found, returns Config::from_defaults().

pub fn get(&self, key: &str) -> Option<Value>

Get a config value by dot-path key.

Walks the canonical nested namespace tree (executor.*, observability.*, modules_path) and falls back to user-defined namespaces. Per spec §9.1, all keys MUST use the canonical <namespace>.<field> form. Legacy v0.17.x short-form aliases (e.g. bare max_call_depth) are NOT accepted.

pub fn set(&mut self, key: &str, value: Value)

Set a config value by dot-path key.

Attempts to set canonical typed fields first, then falls back to user namespaces. Returns silently on type mismatch.

pub fn reload(&mut self) -> Result<(), ModuleError>

Reload config from the stored yaml_path. Returns error if no path stored.

pub fn data(&self) -> Value

Return a serde_json::Value representing the full config as the canonical nested JSON object (PROTOCOL_SPEC §9.1 wire format).

pub fn register_namespace(reg: NamespaceRegistration) -> Result<(), ModuleError>

pub fn env_map(mapping: HashMap<String, String>) -> Result<(), ModuleError>

Register global bare env var → top-level config key mappings.

pub fn registered_namespaces() -> Vec<NamespaceInfo>

pub fn namespace(&self, name: &str) -> Option<Value>

pub fn mount( &mut self, namespace: &str, source: MountSource, ) -> Result<(), ModuleError>

pub fn bind<T: DeserializeOwned>( &self, namespace: &str, ) -> Result<T, ModuleError>

pub fn get_typed<T: DeserializeOwned>( &self, key: &str, ) -> Result<T, ModuleError>

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Config

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

Formats the value using the given formatter.

impl Default for Config

fn default() -> Config

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Config

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Serialize for Config

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

where __S: Serializer,

Serialize this value into the given Serde serializer.