Struct ConvoIO 

pub struct ConvoIO { /* private fields */ }

The facade most consumers want. Wraps a PathResolver and lazily opens the database on demand.

Implementations

impl ConvoIO

pub fn new() -> Self

pub fn with_resolver(resolver: PathResolver) -> Self

pub fn resolver(&self) -> &PathResolver

pub fn exists(&self) -> bool

pub fn db_path(&self) -> Result<PathBuf>

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

List every project in the database.

pub fn list_sessions(&self, project_id: Option<&str>) -> Result<Vec<Session>>

List every session, optionally filtered by project id.

pub fn list_session_metadata( &self, project_id: Option<&str>, ) -> Result<Vec<SessionMetadata>>

Lightweight per-session metadata. One DB query per session header + one aggregated query per session for the message count — cheap enough for interactive listing.

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

Load one session fully (messages + parts attached).

pub fn read_metadata(&self, session_id: &str) -> Result<SessionMetadata>

Return one session’s metadata by id.

pub fn session_exists(&self, session_id: &str) -> Result<bool>

pub fn part_type_counts( &self, session_id: &str, ) -> Result<BTreeMap<String, usize>>

Discriminator counts across all parts in a session — useful for quick inspection / debugging.

pub fn role_counts(&self, session_id: &str) -> Result<BTreeMap<String, usize>>

Total message-role counts. Handy for sanity checks.

Trait Implementations

impl Default for ConvoIO

fn default() -> Self

Returns the “default value” for a type.