Struct BackendConfig 

pub struct BackendConfig {
    pub name: String,
    pub endpoint: String,
    pub model: String,
    pub model_path: Option<String>,
    pub tiers: Vec<Tier>,
    pub kind: BackendKind,
    pub api: OpenAiApi,
    pub api_key_file: Option<String>,
    pub api_key_env: Option<String>,
}

A single inference backend entry.

Two ways to define one: an inline [[backends]] array element in config.toml, or a per-file drop-in ~/.newt/backends/<name>.toml (the filename stem is the name, so a drop-in omits it). name and tiers therefore default — a minimal drop-in is just endpoint + model.

Fields

name: String

Backend name. For a per-file drop-in this is overwritten by the filename stem, so the file body may omit it.

endpoint: String

HTTP endpoint URL (Ollama / OpenAI). Defaulted so a kind = "embedded" backend — which runs in-process and has no URL — can omit it.

model: String

model_path: Option<String>

For kind = "embedded": the local GGUF model file (the in-process engine has no endpoint). ~/ is expanded at use. Ignored for HTTP backends.

tiers: Vec<Tier>

kind: BackendKind

Which wire protocol this backend speaks. Defaults to ollama so configs written before this field existed keep working.

api: OpenAiApi

For kind = "openai": which OpenAI HTTP surface to use (chat_completions default, or responses for models served only on /v1/responses). Ignored for Ollama. The agent loop also auto-falls-back to responses if chat/completions 404s with the responses-only error.

api_key_file: Option<String>

Optional path to a file whose first non-empty line is a bearer token, sent as Authorization: Bearer <token> by OpenAI-compatible backends. A leading ~/ is expanded to the home directory. Keeping the secret in a file (rather than inline in the config) keeps tokens out of version control.

api_key_env: Option<String>

Optional environment variable name holding a bearer token. Takes precedence over api_key_file when both resolve to a non-empty value.

Implementations

impl BackendConfig

pub fn resolve_api_key(&self) -> Option<String>

Resolve this backend’s bearer token, if any.

Checks api_key_env first (environment variable), then api_key_file (first non-empty line of the file, trimmed). Returns None when neither is configured or neither resolves to a non-empty value.

Trait Implementations

impl Clone for BackendConfig

fn clone(&self) -> BackendConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BackendConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BackendConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for BackendConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.