Struct ProviderBuildContext 

pub struct ProviderBuildContext { /* private fields */ }

Bounded inputs for constructing a single provider instance.

Secret scoping

At most one provider-scoped API key may be present. Factories must not receive a bag of every vendor credential. Callers (engine / CLI) select the key for the factory being built before invoking [TranscriptionProviderFactory::build] / [SynthesisProviderFactory::build].

Implementations

impl ProviderBuildContext

pub fn new(cache_dir: impl Into<PathBuf>) -> Self

Minimal context: cache root only (process-global pools used by factories if needed).

pub fn with_local_only(self, local_only: bool) -> Self

pub fn with_api_key(self, key: Option<SecretString>) -> Self

Attach a single provider-scoped secret (already selected by the caller).

pub fn with_base_url(self, base_url: Option<String>) -> Self

pub fn with_allow_custom_endpoint(self, allow: bool) -> Self

pub fn with_use_system_proxy(self, use_proxy: bool) -> Self

pub fn with_show_progress(self, show: bool) -> Self

pub fn with_stt_mode(self, mode: OpenRouterSttMode) -> Self

pub fn with_tts_max_chars(self, n: Option<usize>) -> Self

pub fn with_stt_pool(self, pool: Arc<SttContextPool>) -> Self

pub fn with_governor(self, gov: Arc<ResourceGovernor>) -> Self

pub fn with_metrics(self, metrics: Arc<Metrics>) -> Self

pub fn with_tts_pool(self, pool: Arc<TtsSessionPool>) -> Self

pub fn cache_dir(&self) -> &Path

pub fn local_only(&self) -> bool

pub fn base_url(&self) -> Option<&str>

pub fn allow_custom_endpoint(&self) -> bool

pub fn use_system_proxy(&self) -> bool

pub fn show_progress(&self) -> bool

pub fn stt_mode(&self) -> OpenRouterSttMode

pub fn tts_max_chars(&self) -> Option<usize>

pub fn stt_pool(&self) -> Option<&Arc<SttContextPool>>

pub fn governor(&self) -> Option<&Arc<ResourceGovernor>>

pub fn metrics(&self) -> Option<&Arc<Metrics>>

pub fn tts_pool(&self) -> Option<&Arc<TtsSessionPool>>

pub fn api_key(&self) -> Option<&SecretString>

Borrow the scoped API key for provider construction (JOE-1980).

Returns SecretString — not a plaintext String. Providers must retain the redacting type until the final Authorization/xi-api-key header build.

pub fn api_key_cloned(&self) -> Option<SecretString>

Clone the scoped secret (still redacting) for factory ownership transfer.

pub fn has_api_key(&self) -> bool

Whether a scoped key is present (without revealing it).

pub fn api_key_exposed(&self) -> Option<SecretString>

👎Deprecated:

use api_key_cloned() — does not return plaintext

Deprecated alias: prefer Self::api_key_cloned.

Trait Implementations

impl Clone for ProviderBuildContext

fn clone(&self) -> ProviderBuildContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProviderBuildContext

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

Formats the value using the given formatter.