Struct TraceStore 

pub struct TraceStore { /* private fields */ }

Trace storage for reading and writing Agent Trace records.

Provides both sync and async APIs for flexibility.

Implementations

impl TraceStore

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

Create a new trace store at the specified base directory.

pub fn for_workspace(workspace_path: impl AsRef<Path>) -> Self

Create a trace store under the .vtcode directory in the workspace.

pub fn base_dir(&self) -> &Path

Get the base directory for trace storage.

pub fn ensure_dir(&self) -> Result<()>

Ensure the trace storage directory exists.

pub fn write_trace(&self, trace: &TraceRecord) -> Result<PathBuf>

Write a trace record to storage.

The filename is based on the trace ID or git revision if available.

pub fn read_trace(&self, filename: &str) -> Result<TraceRecord>

Read a trace record by filename.

pub fn read_trace_from_path(&self, path: &Path) -> Result<TraceRecord>

Read a trace record from a specific path.

pub fn read_by_revision(&self, revision: &str) -> Result<Option<TraceRecord>>

Read a trace by git revision.

pub fn list_traces(&self) -> Result<Vec<PathBuf>>

List all trace files in storage.

pub fn delete_trace(&self, filename: &str) -> Result<()>

Delete a trace by filename.

pub fn cleanup(&self, keep_count: usize) -> Result<usize>

Clean up old traces, keeping only the most recent N.

pub async fn ensure_dir_async(&self) -> Result<()>

Ensure the trace storage directory exists (async).

pub async fn write_trace_async(&self, trace: &TraceRecord) -> Result<PathBuf>

Write a trace record to storage (async).

pub async fn read_trace_from_path_async( &self, path: &Path, ) -> Result<TraceRecord>

Read a trace record from a specific path (async).

pub async fn read_by_revision_async( &self, revision: &str, ) -> Result<Option<TraceRecord>>

Read a trace by git revision (async).

Trait Implementations

impl Clone for TraceStore

fn clone(&self) -> TraceStore

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TraceStore

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

Formats the value using the given formatter.