Struct SessionHandle 

pub struct SessionHandle { /* private fields */ }

Handle to a specific session, providing access to its data.

Implementations

impl SessionHandle

pub fn from_events(events: Vec<AgentEvent>) -> Self

Create a SessionHandle from raw events (for testing, simulations, custom pipelines).

This allows you to use SessionHandle API without a Client connection.

Examples

use agtrace_sdk::{SessionHandle, types::AgentEvent};

let events: Vec<AgentEvent> = vec![/* ... */];
let handle = SessionHandle::from_events(events);

let session = handle.assemble()?;
let summary = handle.summarize()?;

pub fn events(&self) -> Result<Vec<AgentEvent>>

Load raw events for this session.

pub fn assemble(&self) -> Result<AgentSession>

Assemble events into a structured session.

Returns only the main stream. For multi-stream sessions (with sidechains or subagents), use assemble_all() instead.

pub fn assemble_all(&self) -> Result<Vec<AgentSession>>

Assemble all streams from events into separate sessions.

Unlike assemble() which returns only the main stream, this method returns all streams (Main, Sidechain, Subagent) found in the session’s events.

pub fn export(&self, strategy: ExportStrategy) -> Result<Vec<AgentEvent>>

Export session with specified strategy.

pub fn metadata(&self) -> Result<Option<SessionMetadata>>

Get session metadata (DB-derived: project_hash, provider).

Returns None for standalone sessions (created from events without workspace).

pub fn raw_files(&self) -> Result<Vec<RawFileContent>>

Get raw log files for this session.

Returns the list of raw log file paths and their contents. Returns empty vector for standalone sessions (created from events without workspace).

pub fn summarize(&self) -> Result<SessionSummary>

Summarize session statistics.

pub fn analyze(&self) -> Result<SessionAnalyzer>

Analyze session with diagnostic lenses.

pub fn child_sessions(&self) -> Result<Vec<ChildSessionInfo>>

Get child sessions (subagents) that were spawned from this session.

Returns a list of child session summaries with their spawn context (turn_index, step_index). Returns empty vector for standalone sessions.