Struct Config 

pub struct Config {

    pub provider: Option<String>,
    pub model: Option<String>,
    pub api_key: Option<String>,
    pub base_url: Option<String>,
    pub vertex_project_id: Option<String>,
    pub vertex_location: Option<String>,
    pub package_manager: Option<String>,
    pub architect_model: Option<String>,
    pub actuator_model: Option<String>,
    pub verifier_model: Option<String>,
    pub speculator_model: Option<String>,
    pub providers: BTreeMap<String, ProviderEntry>,
    pub models: Option<ModelsConfig>,
    pub external_tools: Vec<ExternalToolConfig>,
    pub ensemble: Option<Value>,
    pub verification: Option<VerificationConfig>,
    pub exploration: Option<ExplorationConfig>,
    pub prompts: Option<PromptsConfig>,
    pub context: Option<ContextConfig>,
}

Main configuration struct.

All fields are optional. Documented aliases are accepted on load so that older field names keep working (provider_type, default_provider, default_model).

Fields

provider: Option<String>

Provider id, e.g. openai, anthropic, gemini, vertex, ollama.

model: Option<String>

Default chat/simple-chat model.

api_key: Option<String>

API key for the configured provider. Optional; may also come from env.

base_url: Option<String>

Optional base URL override for OpenAI-compatible / local endpoints.

vertex_project_id: Option<String>

Google Cloud project id for Vertex AI. Optional; may also come from VERTEX_PROJECT_ID or Google Cloud project environment variables.

vertex_location: Option<String>

Vertex AI location. Optional; may also come from VERTEX_LOCATION.

package_manager: Option<String>

Preferred package manager for greenfield project init. Optional and fully plugin-driven: the active language plugin maps it to its own init command and default (e.g. Python → uv, JS → npm). Unknown values fall back to each plugin’s default. Examples: uv, poetry, pdm, pipenv (Python); pnpm, yarn (JS).

architect_model: Option<String>

Agent Architect-tier model override.

actuator_model: Option<String>

Agent Actuator-tier model override.

verifier_model: Option<String>

Agent Verifier-tier model override.

speculator_model: Option<String>

Agent Speculator-tier model override.

providers: BTreeMap<String, ProviderEntry>

The [providers.<id>] table: several credentials coexisting in one process (PSP-9 system 1). Empty for single-provider configurations, which continue to use the flat fields above.

models: Option<ModelsConfig>

The [models] table: per-tier fully qualified provider::model routes. When present it takes precedence over the flat *_model fields.

external_tools: Vec<ExternalToolConfig>

Shared MCP server configuration. Omitted modes default to agent-only.

ensemble: Option<Value>

Detector for the removed PSP-9 [ensemble] block. Deserialization only: a present block fails validation with a pointed migration error naming [exploration] (PSP-10 cutover), never a silent ignore.

verification: Option<VerificationConfig>

Verification acceptance-stage options ([verification]).

exploration: Option<ExplorationConfig>

Bounded search configuration ([exploration]; PSP-10 system 20).

prompts: Option<PromptsConfig>

Prompt bundles and activation bounds ([prompts]; PSP-10 system 25).

context: Option<ContextConfig>

Resident-context reserves ([context]; PSP-10 Definition 6).

Implementations

impl Config

pub fn from_toml_str(content: &str) -> Result<Self>

Parse a Config from a TOML string. A partial document is valid.

pub fn load_from_path(path: &Path) -> Result<Self>

Load a Config from a file path. Returns Config::default() when the file does not exist, so callers can always work with effective values.

pub fn to_toml_string(&self) -> Result<String>

Serialize this config to a TOML string.

pub fn masked(&self) -> Self

Return a clone with the API key masked, for display purposes.

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

pub fn set_value(&mut self, key: &str, value: &str) -> Result<()>

Set a single key to a string value, used by config --set.

Returns an error for unknown keys so typos surface immediately.

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

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.