Struct TraceStore 

pub struct TraceStore { /* private fields */ }

Stores and retrieves reasoning traces.

Implementations

impl TraceStore

pub fn add_trace( &self, session_id: Option<&str>, parent_id: Option<&str>, trace_type: &str, content: &str, metadata: Option<Value>, ) -> Result<String>

Record a new trace entry. Returns the generated trace ID.

• session_id: optional grouping key (e.g. a request or agent run ID).
• parent_id: optional ID of a parent trace for tree structures.
• trace_type: semantic label (e.g. "thought", "tool_call").
• content: the text body of the trace.
• metadata: optional JSON payload.

pub fn get_traces( &self, session_id: &str, limit: Option<usize>, offset: Option<usize>, ) -> Result<Vec<Trace>>

Return traces for a given session in chronological order.

Use limit and offset for pagination. Pass None for both to retrieve all traces.

pub fn get_trace_tree(&self, root_id: &str) -> Result<Vec<Trace>>

Return a subtree of traces rooted at root_id.

Uses a recursive CTE to follow parent_id links. The root trace itself is included. Results are ordered by created_at ascending.