Struct Config 

pub struct Config {
    pub version: String,
    pub project: ProjectConfig,
    pub tools: ToolsConfig,
    pub review: ReviewConfig,
    pub push_main: bool,
    pub agents: AgentsConfig,
    pub models: ModelsConfig,
    pub env: HashMap<String, String>,
}

Top-level .botbox.toml config.

All structs use snake_case (TOML native) with alias attributes for backwards compatibility when loading legacy camelCase JSON configs.

Fields

version: String

project: ProjectConfig

tools: ToolsConfig

review: ReviewConfig

push_main: bool

agents: AgentsConfig

models: ModelsConfig

env: HashMap<String, String>

Environment variables to pass to all spawned agents. Values support shell variable expansion (e.g. $HOME, ${HOME}).

Implementations

impl Config

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

Load config from a file (TOML or JSON, auto-detected by extension).

pub fn parse_toml(toml_str: &str) -> Result<Self>

Parse config from a TOML string.

pub fn parse_json(json: &str) -> Result<Self>

Parse config from a JSON string (for backwards compatibility).

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

Serialize config to a TOML string with helpful comments.

pub fn default_agent(&self) -> String

Returns the effective agent name (project.default_agent or “{name}-dev”).

pub fn channel(&self) -> String

Returns the effective channel name (project.channel or project.name).

pub fn resolved_env(&self) -> HashMap<String, String>

Returns env vars with shell variables expanded (e.g. $HOME → /home/user).

Also propagates OTEL_EXPORTER_OTLP_ENDPOINT from the process environment if set and not already defined in the config, so telemetry flows through to spawned agents.

pub fn resolve_model_pool(&self, model: &str) -> Vec<String>

Resolve a model string to the full pool of models for that tier. Tier names (fast/balanced/strong) return a shuffled Vec of all models in the pool. Legacy short names (opus/sonnet/haiku) and explicit model strings return a single-element Vec.

pub fn resolve_model(&self, model: &str) -> String

Resolve a model string: if it matches a tier name (fast/balanced/strong), randomly pick from that tier’s pool. Otherwise pass through as-is.

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<'de> Deserialize<'de> for Config

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for Config

fn schema_name() -> String

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

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.