Struct Config 

pub struct Config {

    pub agent: AgentConfig,
    pub provider: ProviderConfig,
    pub storage: StorageConfig,
    pub budget: BudgetConfig,
    pub retry: RetryConfig,
    pub tools: ToolsConfig,
    pub models: ModelDefaults,
    pub max_tokens: u32,
    pub shell: ShellDefaults,
    pub store: StoreConfig,
    pub providers: ProviderSettings,
    pub comms: CommsRuntimeConfig,
    pub compaction: CompactionRuntimeConfig,
    pub limits: LimitsConfig,
    pub rest: RestServerConfig,
    pub hooks: HooksConfig,
    pub skills: SkillsConfig,
    pub self_hosted: SelfHostedConfig,
    pub provider_tools: ProviderToolsConfig,
}

Complete configuration for Meerkat

Fields

agent: AgentConfig

provider: ProviderConfig

storage: StorageConfig

budget: BudgetConfig

retry: RetryConfig

tools: ToolsConfig

models: ModelDefaults

max_tokens: u32

shell: ShellDefaults

store: StoreConfig

providers: ProviderSettings

comms: CommsRuntimeConfig

compaction: CompactionRuntimeConfig

limits: LimitsConfig

rest: RestServerConfig

hooks: HooksConfig

skills: SkillsConfig

self_hosted: SelfHostedConfig

provider_tools: ProviderToolsConfig

Implementations

impl Config

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

Build the effective model registry for this config snapshot.

pub fn template_toml() -> &'static str

Return the config template as TOML.

pub fn template() -> Result<Self, ConfigError>

Parse the config template into a Config value.

impl Config

pub async fn load() -> Result<Self, ConfigError>

Load configuration from all sources with proper layering Order: defaults → project config OR global config → env vars (secrets only) → CLI (CLI applied separately)

pub async fn load_layered_hooks() -> Result<HooksConfig, ConfigError>

Load only hook configuration with explicit global -> project layering.

This preserves existing config precedence for non-hook fields while allowing deterministic hook registration ordering across scopes.

pub async fn load_layered_hooks_from( start_dir: &Path, home_dir: Option<&Path>, ) -> Result<HooksConfig, ConfigError>

Load only hook configuration with explicit global -> project layering.

impl Config

pub fn budget_limits(&self) -> BudgetLimits

Convert config limits into runtime budget limits.

pub fn global_config_path() -> Option<PathBuf>

Get global config path (~/.rkat/config.toml)

pub async fn merge_file(&mut self, path: &PathBuf) -> Result<(), ConfigError>

Merge configuration from a TOML file

pub fn merge_toml_str(&mut self, content: &str) -> Result<(), ConfigError>

Merge configuration from a TOML string.

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

Apply environment variable overrides

pub fn apply_cli_overrides(&mut self, cli: CliOverrides)

Apply CLI argument overrides.

• Explicit CLI flags override scalar runtime knobs.
• override_config applies RFC 7396 JSON merge-patch semantics.

impl Config

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

Validate configuration invariants.

Called after loading and after persisting. Checks:

• No "*" wildcards in allowlists
• Every concrete provider key is present and non-empty
• Resolved defaults are valid

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() -> Self

Returns the “default value” for a type.

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

where Config: Default,

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

where __D: Deserializer<'de>,

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.