Struct Config 

pub struct Config {

    pub http_proxy: String,
    pub https_proxy: String,
    pub proxy_auth: Option<ProxyAuth>,
    pub proxy_auth_encrypted: Option<String>,
    pub model: Option<String>,
    pub headless_auth: bool,
    pub provider: String,
    pub providers: ProviderConfigs,
    pub server: ServerConfig,
    pub keyword_masking: KeywordMaskingConfig,
    pub anthropic_model_mapping: AnthropicModelMapping,
    pub gemini_model_mapping: GeminiModelMapping,
    pub mcp: McpConfig,
    pub extra: BTreeMap<String, Value>,
}

Main configuration structure for Bamboo agent

Contains all settings needed to run the agent, including provider credentials, proxy settings, model selection, and server configuration.

Fields

http_proxy: String

HTTP proxy URL (e.g., http://proxy.example.com:8080)

https_proxy: String

HTTPS proxy URL (e.g., https://proxy.example.com:8080)

proxy_auth: Option<ProxyAuth>

Proxy authentication credentials

Note: this is kept in-memory only. On disk we store proxy_auth_encrypted.

proxy_auth_encrypted: Option<String>

Encrypted proxy authentication credentials (nonce:ciphertext)

This is the at-rest storage representation. When present, Bamboo will decrypt it into proxy_auth at load time.

model: Option<String>

Default model to use (can be overridden per provider)

headless_auth: bool

Deprecated: Use providers.copilot.headless_auth instead

provider: String

Default LLM provider to use (e.g., “anthropic”, “openai”, “gemini”, “copilot”)

providers: ProviderConfigs

Provider-specific configurations

server: ServerConfig

HTTP server configuration

keyword_masking: KeywordMaskingConfig

Global keyword masking configuration.

Previously persisted in keyword_masking.json (now unified into config.json).

anthropic_model_mapping: AnthropicModelMapping

Anthropic model mapping configuration.

Previously persisted in anthropic-model-mapping.json (now unified into config.json).

gemini_model_mapping: GeminiModelMapping

Gemini model mapping configuration.

Previously persisted in gemini-model-mapping.json (now unified into config.json).

mcp: McpConfig

MCP server configuration.

Previously persisted in mcp.json (now unified into config.json).

extra: BTreeMap<String, Value>

Extension fields stored at the root of config.json.

This keeps the config forward-compatible and allows unrelated subsystems (e.g. setup UI state) to persist their own keys without getting dropped by typed (de)serialization.

Implementations

impl Config

pub fn new() -> Self

Load configuration from file with environment variable overrides

Configuration loading order:

1. Try loading from config.json ({data_dir}/config.json)
2. Migrate old format if detected
3. Use defaults
4. Apply environment variable overrides (highest priority)

Environment Variables

• BAMBOO_PORT: Override server port
• BAMBOO_BIND: Override bind address
• BAMBOO_DATA_DIR: Override data directory
• BAMBOO_PROVIDER: Override default provider
• MODEL: Default model name
• BAMBOO_HEADLESS: Enable headless authentication mode

pub fn from_data_dir(data_dir: Option<PathBuf>) -> Self

Load configuration from a specific data directory

Arguments

• data_dir - Optional data directory path. If None, uses default (~/.bamboo)

pub fn hydrate_proxy_auth_from_encrypted(&mut self)

Populate proxy_auth (plaintext) from proxy_auth_encrypted if present.

Many parts of the code rely on proxy_auth being hydrated in-memory so we can re-encrypt deterministically on save without ever persisting plaintext credentials.

pub fn refresh_proxy_auth_encrypted(&mut self) -> Result<()>

Refresh proxy_auth_encrypted from the current in-memory proxy_auth.

This is used both when persisting the config to disk and when generating API responses that should never include plaintext proxy credentials.

pub fn hydrate_provider_api_keys_from_encrypted(&mut self)

pub fn refresh_provider_api_keys_encrypted(&mut self) -> Result<()>

pub fn hydrate_mcp_secrets_from_encrypted(&mut self)

pub fn refresh_mcp_secrets_encrypted(&mut self) -> Result<()>

pub fn server_addr(&self) -> String

Get the full server address (bind:port)

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

Save configuration to disk

pub fn save_to_dir(&self, data_dir: PathBuf) -> Result<()>

Save configuration to disk under the provided data directory.

Configuration is always stored as {data_dir}/config.json.

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

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.