Struct CursorIO 

pub struct CursorIO { /* private fields */ }

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

Implementations

impl CursorIO

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 read_composer_headers(&self) -> Result<ComposerHeaders>

Read composer.composerHeaders verbatim.

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

All composer ids known to the database, including drafts. Use Self::list_composers when you only want sessions that have at least one bubble on disk.

pub fn list_composers(&self) -> Result<Vec<ComposerListing>>

Composer headers paired to whether they have any rendered bubbles. Empty drafts (has_bubbles == false) are commonly dropped by callers that want a session list.

pub fn list_session_metadata(&self) -> Result<Vec<CursorSessionMetadata>>

Lightweight per-composer metadata for every composer that has at least one bubble on disk.

pub fn read_session_metadata( &self, composer_id: &str, ) -> Result<CursorSessionMetadata>

Lightweight metadata for one composer.

pub fn composer_exists(&self, composer_id: &str) -> Result<bool>

Whether the composer exists in the database (either as a header or as bubble rows).

pub fn read_session(&self, composer_id: &str) -> Result<CursorSession>

Load one session fully (composer data + bubbles + referenced content blobs) and attach the JSONL transcript path when the composer’s workspace folder maps cleanly into ~/.cursor/projects/<slug>/agent-transcripts/<id>/<id>.jsonl.

pub fn locate_transcript(&self, session: &CursorSession) -> Option<PathBuf>

Resolve the JSONL transcript path for a session, if the file exists on disk. Cursor only emits a transcript for agent-mode runs against a real on-disk workspace.

Trait Implementations

impl Default for CursorIO

fn default() -> Self

Returns the “default value” for a type.