Struct ConfigFile 

pub struct ConfigFile {
    pub auto_pull: bool,
    pub models_home: Option<PathBuf>,
    pub model: Option<ModelConfig>,
    pub n_ctx: u32,
    pub n_gpu_layers: i32,
    pub admin_addr: Option<String>,
    pub backends: Option<Vec<BackendEntry>>,
    pub listen: Option<ListenConfig>,
}

Top-level config-file schema.

Two flavours coexist:

• Legacy single-backend — model: at the top level, plus n_ctx / n_gpu_layers. Implies one kind: "llamacpp" backend.
• Multi-backend — backends: [...] carries an ordered list of backend entries. Router walks the list per ADR 0007.

The two are mutually exclusive at parse time: setting both is a validation error. auto_pull and admin_addr apply to both flavours.

Fields

auto_pull: bool

When true and a kind: "llamacpp" model file is absent, the daemon downloads it from the entry’s source_url on startup. When false, the daemon refuses to start with a clear error pointing at the operator’s next step. Default: true. Applies to every llamacpp entry in backends:.

models_home: Option<PathBuf>

Override for the shared model store root. When unset the daemon falls back to MODELS_HOME env, then the platform default. Tilde-expanded on read.

model: Option<ModelConfig>

Legacy single-backend model spec. Deprecated in favour of backends: but kept for v0.1.x config-file compatibility. Mutually exclusive with backends:.

n_ctx: u32

Llama.cpp context window in tokens. Default: 8192. Used as the fallback for legacy model: entries; multi-backend entries carry their own n_ctx.

n_gpu_layers: i32

Llama.cpp GPU layer offload count. 0 = CPU-only. Default: 0. Used as the fallback for legacy model: entries; multi- backend entries carry their own n_gpu_layers.

admin_addr: Option<String>

Admin socket address. Default: platform-specific path per docs/protocol-v1.md §“Admin endpoint”.

backends: Option<Vec<BackendEntry>>

Ordered list of backends (multi-backend shape). First entry is highest priority — the router tries it first, then the next, etc. Mutually exclusive with model:.

listen: Option<ListenConfig>

Optional listener overrides. Default behaviour is unchanged: the operator picks a transport via --tcp / --uds / --pipe on the CLI. When listen: is present and the CLI did not pass a transport flag, the daemon binds the transports declared here. CLI flags always win when both are set. Restart-time only — no config watcher.

Implementations

impl ConfigFile

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

Read + parse + validate a config file at path.

pub fn resolved_backends(&self) -> Vec<BackendEntry>

Canonical multi-backend list. When the operator wrote the legacy single-backend shape (model: at top level), this returns a one-element list with kind: "llamacpp" so the rest of the daemon only ever sees the multi-backend shape.

Trait Implementations

impl Clone for ConfigFile

fn clone(&self) -> ConfigFile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConfigFile

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ConfigFile

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ConfigFile

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

where __S: Serializer,

Serialize this value into the given Serde serializer.