Struct MediaConfig 

pub struct MediaConfig {
    pub api_key: Option<String>,
    pub base_url: Option<String>,
    pub allowed_read_dirs: Vec<String>,
    pub image_gen: ImageGenConfig,
    pub vision: VisionConfig,
    pub tts: TtsConfig,
    pub stt: SttConfig,
    pub book: BookConfig,
    pub podcast: PodcastConfig,
}

Configuration for multimedia tools (image generation, vision, TTS, STT).

All four tools are disabled by default — operators opt in per-tool. Credential resolution order for each tool (first non-empty wins):

1. media.api_key (plaintext in config; discouraged but supported)
2. Environment variable MICROCLAW_OPENAI_API_KEY
3. Environment variable OPENAI_API_KEY
4. config.openai_api_key (existing top-level field; used by transcribe)

Fields

api_key: Option<String>

Optional explicit API key. Prefer env vars (MICROCLAW_OPENAI_API_KEY or OPENAI_API_KEY) over plaintext here.

base_url: Option<String>

Optional per-module base URL override. Falls back to openai_base_url then to https://api.openai.com/v1.

allowed_read_dirs: Vec<String>

Extra directories that describe_image / transcribe_audio may read from, beyond the working_dir default. Absolute paths only. Empty by default — matches the previous working-dir-only behavior.

image_gen: ImageGenConfig

vision: VisionConfig

tts: TtsConfig

stt: SttConfig

book: BookConfig

podcast: PodcastConfig

Implementations

impl MediaConfig

pub fn resolve_api_key( &self, fallback_openai_key: Option<&str>, ) -> Option<String>

Resolve the API key using the documented priority order. Returns None if no source is configured. Never logs the value.

pub fn resolve_base_url(&self, fallback: Option<&str>) -> String

Resolve the base URL using the documented priority order. Always returns a non-empty value (defaults to OpenAI).

Trait Implementations

impl Clone for MediaConfig

fn clone(&self) -> MediaConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MediaConfig

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

Formats the value using the given formatter.

impl Default for MediaConfig

fn default() -> MediaConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for MediaConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for MediaConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.