Struct AiConfig 

pub struct AiConfig {

    pub provider: String,
    pub model: String,
    pub timeout_seconds: u64,
    pub allow_paid_models: bool,
    pub max_tokens: u32,
    pub temperature: f32,
    pub circuit_breaker_threshold: u32,
    pub circuit_breaker_reset_seconds: u64,
    pub retry_max_attempts: u32,
    pub tasks: Option<TasksConfig>,
    pub fallback: Option<FallbackConfig>,
    pub custom_guidance: Option<String>,
    pub validation_enabled: bool,
}

AI provider settings.

Fields

provider: String

AI provider: one of "gemini", "openrouter", "groq", "cerebras", "zenmux", or "zai".

model: String

Model identifier.

timeout_seconds: u64

Request timeout in seconds.

allow_paid_models: bool

Allow paid models (default: true).

max_tokens: u32

Maximum tokens for API responses.

temperature: f32

Temperature for API requests (0.0-1.0).

circuit_breaker_threshold: u32

Circuit breaker failure threshold before opening (default: 3).

circuit_breaker_reset_seconds: u64

Circuit breaker reset timeout in seconds (default: 60).

retry_max_attempts: u32

Maximum retry attempts for rate-limited requests (default: 3).

tasks: Option<TasksConfig>

Task-specific model overrides.

fallback: Option<FallbackConfig>

Fallback provider chain for resilience.

custom_guidance: Option<String>

Custom guidance to override or extend default best practices.

Allows users to provide project-specific tooling recommendations that will be appended to the default best practices context. Useful for enforcing project-specific choices (e.g., poetry instead of uv).

validation_enabled: bool

Enable pre-flight model validation with fuzzy matching (default: true).

When enabled, validates that the configured model ID exists in the cached model registry before creating an AI client. Provides helpful suggestions if an invalid model ID is detected.

Implementations

impl AiConfig

pub fn resolve_for_task(&self, task: TaskType) -> (String, String)

Resolve provider and model for a specific task type.

Returns a tuple of (provider, model) by checking task-specific overrides first, then falling back to the default provider and model.

Arguments

• task - The task type to resolve configuration for

Returns

A tuple of (provider_name, model_name) strings

Trait Implementations

impl Clone for AiConfig

fn clone(&self) -> AiConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AiConfig

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

Formats the value using the given formatter.

impl Default for AiConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for AiConfig

where AiConfig: 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 AiConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.