Struct Config 

pub struct Config {

    pub provider: String,
    pub model: Option<String>,
    pub language: String,
    pub output: String,
    pub output_file: Option<PathBuf>,
    pub timestamps: bool,
    pub verbose: bool,
    pub openrouter_api_key: Option<SecretString>,
    pub openrouter_base_url: String,
    pub openrouter_default_model: String,
    pub openrouter_allow_custom_endpoint: bool,
    pub openrouter_stt_mode: String,
    pub openrouter_use_system_proxy: bool,
    pub providers: ProvidersConfig,
    pub cleanup_style: String,
    pub cleanup_provider: String,
    pub cleanup_openrouter_model: Option<String>,
    pub tts_provider: String,
    pub tts_model: String,
    pub tts_voice: String,
    pub tts_language: String,
    pub tts_speaking_rate: f32,
    pub tts_max_chars: usize,
    pub tts_timeout_ms: u64,
    pub tts_pack_dir: Option<PathBuf>,
    pub tts_allow_unverified: bool,
    pub tts_custom_models: Vec<CustomTtsModelConfig>,
    pub local_only: bool,
    pub config_path: Option<PathBuf>,
    pub cache_dir: PathBuf,
}

Fully-resolved runtime configuration after merging all sources.

STT direction uses provider / model / language. TTS uses tts_*. OpenRouter options remain on the historical openrouter_* fields (mirrors of [providers.openrouter] / legacy [openrouter]). Other vendors live under Config::providers so the flat surface does not grow per vendor.

Fields

provider: String

STT provider id (local, openrouter, …). Never inferred from key presence.

model: Option<String>

language: String

output: String

output_file: Option<PathBuf>

timestamps: bool

verbose: bool

openrouter_api_key: Option<SecretString>

OpenRouter API key — redacted via SecretString (JOE-1779).

openrouter_base_url: String

openrouter_default_model: String

openrouter_allow_custom_endpoint: bool

Allow custom credentialed endpoints (JOE-1587).

openrouter_stt_mode: String

auto | chat | transcriptions (JOE-1586).

openrouter_use_system_proxy: bool

providers: ProvidersConfig

Named non-OpenRouter provider credentials (JOE-1935).

cleanup_style: String

Cleanup style name (raw, clean, …).

cleanup_provider: String

Cleanup backend name (rules, openrouter).

cleanup_openrouter_model: Option<String>

Optional dedicated model for OpenRouter cleanup.

tts_provider: String

TTS provider name (default local).

tts_model: String

tts_voice: String

tts_language: String

tts_speaking_rate: f32

tts_max_chars: usize

tts_timeout_ms: u64

tts_pack_dir: Option<PathBuf>

Optional default pack directory for local override (JOE-1619).

tts_allow_unverified: bool

tts_custom_models: Vec<CustomTtsModelConfig>

Validated custom TTS catalogue entries (empty when packs not present yet).

local_only: bool

When true, remote STT/TTS providers are rejected at validation (JOE-1935).

config_path: Option<PathBuf>

cache_dir: PathBuf

Implementations

impl Config

pub fn default_config_path() -> Option<PathBuf>

Resolve the platform-appropriate config file path.

pub fn default_cache_dir() -> Result<PathBuf>

Resolve the platform-appropriate cache directory (models live under models/).

pub fn load() -> Result<Self>

Load config file from the default location (if present) and merge with env vars.

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

Load from an explicit config file path (used in tests / CLI --config).

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

Load from an explicit path; error if the file is missing (JOE-1608).

pub fn openrouter_api_key_exposed(&self) -> Option<String>

Expose the OpenRouter API key as a plain string for provider construction.

pub fn provider_secret(&self, id: &ProviderId) -> Option<SecretString>

Provider-scoped secret for build-context construction (JOE-1935).

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

Validate provider/model/style/limit cross-fields (JOE-1608 / JOE-1935).

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

Validate [[tts.custom_models]] uniqueness and reserved namespaces.

pub fn effective_diagnostic(&self) -> EffectiveConfigDiagnostic

Redacted diagnostic view for --print-effective-config (JOE-1608 / JOE-1935).

pub fn apply_cli( &mut self, provider: Option<&str>, model: Option<&str>, language: Option<&str>, output: Option<&str>, output_file: Option<&Path>, timestamps: bool, verbose: bool, cleanup: Option<&str>, cleanup_provider: Option<&str>, cleanup_model: Option<&str>, )

Apply CLI overrides on top of the loaded config.

pub fn resolve_model(&self, model_explicitly_set: bool) -> Result<String>

Resolve the effective model for the active provider.

Trait Implementations

impl AsRef<Config> for ValidatedConfig

fn as_ref(&self) -> &Config

Converts this type into a shared reference of the (usually inferred) input type.

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.