Struct DebugConfig 

pub struct DebugConfig {
    pub enabled: bool,
    pub output_dir: PathBuf,
    pub format: DumpFormat,
    pub traces: TraceConfig,
    pub include_raw_images: bool,
}

Debug dump configuration, nested under [debug] in TOML.

When enabled = true, LLM request/response payloads are written to disk for inspection. Each session creates a subdirectory under output_dir named by session ID.

Example (TOML)

[debug]
enabled = true
format = "raw"

Fields

enabled: bool

Enable debug dump on startup (CLI --debug-dump takes priority).

output_dir: PathBuf

Directory where per-session debug dump subdirectories are created.

format: DumpFormat

Output format: "json" (default), "raw" (API payload), or "trace" (OTLP spans).

traces: TraceConfig

OTel trace configuration (only used when format = "trace").

include_raw_images: bool

Include full raw base64 MessagePart::Image bytes in debug dumps instead of a redacted <redacted image: ...> marker (#6306).

Default: false. Image payloads are redacted by default to avoid writing potentially large or sensitive binary data to disk on an opt-in debugging feature. Enable only when a developer explicitly needs full wire-payload fidelity for image-related debugging.

Trait Implementations

impl Clone for DebugConfig

fn clone(&self) -> DebugConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DebugConfig

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

Formats the value using the given formatter.

impl Default for DebugConfig

fn default() -> DebugConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DebugConfig

where DebugConfig: Default,

fn deserialize<__D>( __deserializer: __D, ) -> Result<DebugConfig, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for DebugConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.