Struct KodaConfig 

pub struct KodaConfig {

    pub agent_name: String,
    pub system_prompt: String,
    pub allowed_tools: Vec<String>,
    pub disallowed_tools: Vec<String>,
    pub provider_type: ProviderType,
    pub base_url: String,
    pub model: String,
    pub max_context_tokens: usize,
    pub agents_dir: PathBuf,
    pub model_settings: ModelSettings,
    pub max_iterations: u32,
    pub skip_memory: bool,
    pub trust: TrustMode,
}

Runtime configuration assembled from CLI args, env vars, and agent JSON.

Fields

agent_name: String

Agent name (e.g. "koda", "scout").

system_prompt: String

Assembled system prompt.

allowed_tools: Vec<String>

Allowlisted tool names (empty = all tools).

disallowed_tools: Vec<String>

Denylisted tool names.

provider_type: ProviderType

Active provider type.

base_url: String

API base URL.

model: String

Model identifier.

max_context_tokens: usize

Max context window tokens.

agents_dir: PathBuf

Directory containing agent JSON configs.

model_settings: ModelSettings

Model-specific settings (max_tokens, temperature, etc.).

max_iterations: u32

Max inference iterations per turn.

skip_memory: bool

Skip injecting project/global memory into the system prompt. Set by skip_memory: true in agent JSON. Default: false.

trust: TrustMode

Trust mode for this session. Default: TrustMode::Safe.

Implementations

impl KodaConfig

pub fn load(project_root: &Path, agent_name: &str) -> Result<Self>

Load config from the agent JSON file. Search order: project agents/ → user ~/.config/koda/agents/ → built-in (embedded).

pub fn with_overrides( self, base_url: Option<String>, model: Option<String>, provider: Option<String>, ) -> Self

Apply CLI/env overrides on top of the loaded config.

pub fn with_model_overrides( self, max_tokens: Option<u32>, temperature: Option<f64>, thinking_budget: Option<u32>, reasoning_effort: Option<String>, ) -> Self

Apply model-specific setting overrides from CLI.

pub fn with_trust(self, mode: TrustMode) -> Self

Override the trust mode (e.g. from --mode safe on the CLI).

pub fn recalculate_model_derived(&mut self)

Recalculate model-derived settings (context window, tier, iteration limits).

Call this whenever self.model or self.provider_type changes to keep context window, tier, and iteration defaults in sync with the new model. Uses the hardcoded lookup table as a synchronous fallback. For API-sourced values, call apply_provider_capabilities after this.

pub fn apply_provider_capabilities(&mut self, caps: &ModelCapabilities)

Apply capabilities queried from the provider API.

Overrides the hardcoded context window and max output tokens with values reported by the provider. Call this after recalculate_model_derived when you have access to the provider.

pub async fn query_and_apply_capabilities(&mut self, provider: &dyn LlmProvider)

Query the provider API for model capabilities and apply them.

Convenience wrapper: queries model_capabilities() on the provider and applies the result. Logs a debug message if the API doesn’t report capabilities (falls back to hardcoded lookup).

pub fn load_agent_json( project_root: &Path, agent_name: &str, ) -> Result<AgentConfig>

Load the raw AgentConfig for an agent without resolving it into a full KodaConfig. Preserves Option<String> fields so callers can distinguish “explicitly set” from “not set” — used by sub-agent dispatch to decide which parent fields to inherit.

Search order mirrors load: project agents/ → built-in.

pub fn load_builtin(name: &str) -> Option<AgentConfig>

Try to load a built-in (embedded) agent by name.

pub fn builtin_agents() -> Vec<(String, AgentConfig)>

Return all built-in agent configs (name, parsed config).

pub fn default_for_testing(provider_type: ProviderType) -> Self

Create a minimal config for testing. Available in both koda-core and downstream crate tests.

Trait Implementations

impl Clone for KodaConfig

fn clone(&self) -> KodaConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for KodaConfig

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

Formats the value using the given formatter.