Struct PiConvo 

pub struct PiConvo { /* private fields */ }

High-level interface for reading Pi sessions.

Implementations

impl PiConvo

pub fn new() -> Self

Build a manager with the default resolver (~/.pi/agent/sessions/).

pub fn with_resolver(resolver: PathResolver) -> Self

Build a manager with a custom resolver (useful for tests).

pub fn resolver(&self) -> &PathResolver

Access the underlying resolver.

pub fn exists(&self) -> bool

Whether the Pi sessions directory exists on disk.

pub fn list_projects(&self) -> Result<Vec<String>>

List known project paths (decoded cwd values).

pub fn list_sessions(&self, project: &str) -> Result<Vec<SessionMeta>>

List session metadata for a project, newest first.

pub fn read_session(&self, project: &str, session_id: &str) -> Result<PiSession>

Read a specific session by ID.

pub fn most_recent_session(&self, project: &str) -> Result<Option<PiSession>>

Read the most recently active session for a project, if any.

pub fn to_view(&self, session: &PiSession) -> ConversationView

Convert a Pi session into a provider-agnostic ConversationView.

pub fn read_all_sessions(&self, project: &str) -> Result<Vec<PiSession>>

Read all sessions for a project.

Trait Implementations

impl Clone for PiConvo

fn clone(&self) -> PiConvo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl ConversationProvider for PiConvo

fn list_conversations(&self, project: &str) -> Result<Vec<String>, ConvoError>

List conversation IDs for a project/workspace.

fn load_conversation( &self, project: &str, conversation_id: &str, ) -> Result<ConversationView, ConvoError>

Load a full conversation as a ConversationView.

fn load_metadata( &self, project: &str, conversation_id: &str, ) -> Result<ConversationMeta, ConvoError>

Load metadata only (no turns).

fn list_metadata( &self, project: &str, ) -> Result<Vec<ConversationMeta>, ConvoError>

List metadata for all conversations in a project.

impl Debug for PiConvo

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

Formats the value using the given formatter.

impl Default for PiConvo

fn default() -> PiConvo

Returns the “default value” for a type.