Struct DebugDumper 

pub struct DebugDumper { /* private fields */ }

Cloneable debug dump writer; clones share the same atomic counter.

Implementations

impl DebugDumper

pub fn new(base_dir: &Path, format: DumpFormat) -> Result<Self>

Create a new dumper, creating a timestamped subdirectory under base_dir.

Errors

Returns an error if the directory cannot be created.

pub fn with_include_raw_images(self, include: bool) -> Self

Sets whether MessagePart::Image payloads are written to debug dumps as full raw base64 bytes instead of a redacted <redacted image: ...> marker.

Default: false (redacted). Mirrors zeph_config::DebugConfig::include_raw_images; enable only when a developer explicitly needs full wire-payload fidelity for image-related debugging (#6306). Logs a warning when enabled so operators have a visible signal that this security tradeoff is active.

pub fn dir(&self) -> &Path

Return the session dump directory.

pub fn is_trace_format(&self) -> bool

Returns true when the dump format is DumpFormat::Trace.

In Trace mode dump_request returns early without using provider_request, so callers can skip the expensive debug_request_json serialization.

pub fn dump_request(&self, request: &RequestDebugDump<'_>) -> u32

Dump the messages about to be sent to the LLM.

Returns an ID that must be passed to dump_response to correlate request and response. When format = Trace, no file is written (spans are collected by trace::TracingCollector).

pub fn dump_response(&self, id: u32, response: &str)

Dump the LLM response corresponding to a prior dump_request call. When format = Trace, this is a no-op.

pub fn dump_tool_output(&self, tool_name: &str, output: &str)

Dump raw tool output before any truncation or summarization. When format = Trace, this is a no-op (tool output is recorded via TracingCollector).

pub fn dump_focus_knowledge(&self, knowledge: &str)

Dump the accumulated Focus Agent knowledge blocks. When format = Trace, this is a no-op.

pub fn dump_tool_error(&self, tool_name: &str, error: &ToolError)

Dump a tool error with error classification for debugging transient/permanent failures. When format = Trace, this is a no-op.

Trait Implementations

impl Clone for DebugDumper

fn clone(&self) -> DebugDumper

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl DebugDumpSink for DebugDumper

Lets zeph-subagent’s agent loop write sub-agent LLM request/response pairs through the same DebugDumper the top-level agent loop uses, without zeph-subagent depending on zeph-core (#6391). See zeph_llm::debug_dump::DebugDumpSink for the contract.

fn is_trace_format(&self) -> bool

Returns true when the active dump format does not need provider_request built (e.g. Trace format, which records spans instead of numbered files) — callers can skip the (non-free) request serialization in that case.

fn dump_request( &self, model_name: &str, messages: &[Message], tools: &[ToolDefinition], provider_request: Value, ) -> u32

Dump the outgoing request. Returns an id that must be passed to dump_response to correlate the pair.

fn dump_response(&self, id: u32, response: &ChatResponse)

Dump the response paired with a prior dump_request call.