Module config 

Configuration management for vectorless.

This module provides comprehensive configuration loading, validation, and management:

• Config — Main configuration structure
• ConfigLoader — Load configuration from TOML files
• ConfigValidator — Validate configuration values
• ConfigDocs — Generate configuration documentation

Quick Start

use vectorless::config::{Config, ConfigLoader};

// Load from file
let config = ConfigLoader::new()
    .file("vectorless.toml")
    .with_validation(true)
    .load()?;

// Or use defaults
let config = Config::default();

Layered Configuration

Multiple configuration files can be layered:

use vectorless::config::ConfigLoader;

let config = ConfigLoader::new()
    .file("default.toml")        // Base defaults
    .file("production.toml")     // Production overrides
    .with_validation(true)
    .load()?;

Configuration Sections

• [llm] — Unified LLM configuration (pool, retry, throttle, fallback)
• [metrics] — Unified metrics configuration
• [pilot] — Pilot navigation configuration
• [indexer] — Document indexing parameters
• [retrieval] — Retrieval model settings
• [storage] — Storage paths

Structs

CacheConfig

Cache configuration.

CompressionConfig

Compression configuration.

ConcurrencyConfig

Concurrency control configuration.

Config

Main configuration for vectorless.

ConfigDocs

Configuration documentation generator.

ConfigLoader

Configuration loader.

ConfigOverlay

Configuration overlay for layered configuration.

ConfigValidationError

Configuration validation error.

ConfigValidator

Configuration validator.

ContentAggregatorConfig

Content aggregator configuration.

FallbackConfig

Fallback configuration for error recovery.

IndexerConfig

Indexer configuration.

LlmClientConfig

Individual LLM client configuration.

LlmConfig

Generic LLM configuration.

LlmFallbackConfig

Fallback configuration for LLM calls.

LlmMetricsConfig

LLM-specific metrics configuration.

LlmPoolConfig

Unified LLM configuration.

MetricsConfig

Unified metrics configuration.

PilotMetricsConfig

Pilot-specific metrics configuration.

RetrievalConfig

Retrieval model configuration (for navigation).

RetrievalMetricsConfig

Retrieval-specific metrics configuration.

RetryConfig

Retry configuration for LLM calls.

SearchConfig

Search algorithm configuration.

StorageConfig

Storage configuration.

StrategyConfig

Strategy-specific configuration.

SufficiencyConfig

Sufficiency checker configuration.

SummaryConfig

Summary model configuration.

ThrottleConfig

Throttle/rate limiting configuration.

ValidationError

A single validation error.

Enums

CompressionAlgorithm

Compression algorithm.

ConfigError

Configuration loading errors.

FallbackBehavior

Fallback behavior when encountering errors.

LlmFallbackBehavior

Fallback behavior on errors.

LlmOnAllFailedBehavior

Behavior when all fallback attempts fail.

MergeStrategy

Configuration merge strategy.

OnAllFailedBehavior

Behavior when all fallback attempts fail.

Severity

Validation severity level.

Constants

CONFIG_FILE_NAMES

Default configuration file names to search for.

Traits

Merge

Trait for configuration merging.

ValidationRule

Trait for validation rules.

Functions

find_config_file

Find a configuration file in current or parent directories.