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 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.