Trait Store 

pub trait Store {
    type H: Harness;
    type Ref;

    // Required methods
    fn discover(&self) -> Result<Vec<Discovered<Self::Ref>>>;
    fn load(&self, reference: &Self::Ref) -> Result<Transcript<Self::H>>;
    fn save(&self, transcript: &Transcript<Self::H>) -> Result<Saved<Self::Ref>>;
    fn delete(&self, reference: &Self::Ref) -> Result<()>;

    // Provided method
    fn fingerprints(
        &self,
        _refs: &[Self::Ref],
    ) -> Result<HashMap<String, String>> { ... }
}

Reading and writing native transcripts against a real backend (a session directory, a SQLite database, an import subprocess).

Required Associated Types

type H: Harness

The harness this store reads and writes.

type Ref

A locator for one transcript at rest: a file path, a database id, a slug.

Required Methods

fn discover(&self) -> Result<Vec<Discovered<Self::Ref>>>

Cheap metadata scan — no full message parsing.

Errors

When the backend itself fails; a missing root is Ok(vec![]).

fn load(&self, reference: &Self::Ref) -> Result<Transcript<Self::H>>

Load and parse one transcript into its faithful native representation.

Errors

When the reference doesn’t exist or its content doesn’t parse.

fn save(&self, transcript: &Transcript<Self::H>) -> Result<Saved<Self::Ref>>

Persist a native transcript so the harness can resume it.

Errors

When the backend rejects the write.

fn delete(&self, reference: &Self::Ref) -> Result<()>

Remove one transcript from the backend so the harness no longer lists or resumes it. File-backed stores remove the session file or directory; OpenCode archives the session in place.

Errors

When the reference doesn’t exist or the backend rejects the removal.

Provided Methods

fn fingerprints(&self, _refs: &[Self::Ref]) -> Result<HashMap<String, String>>

Per-reference change cursors, for callers that cache parsed transcripts. Default: no fingerprints, forcing a re-parse. Backends with a cheap change signal (file mtime, a MAX(updated) query) should override.

Errors

When the backend itself fails; per-reference failures are empty strings.

Dyn Compatibility

This trait is dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety".

Implementors

impl Store for AmpStore

type H = Amp

type Ref = PathBuf

impl Store for AntigravityStore

Available on crate feature opencode only.

type H = Antigravity

type Ref = PathBuf

impl Store for CampfireStore

type H = Campfire

type Ref = PathBuf

impl Store for ClaudeStore

type H = ClaudeCode

type Ref = PathBuf

impl Store for CodexStore

type H = Codex

type Ref = PathBuf

impl Store for CoworkStore

type H = Cowork

type Ref = PathBuf

impl Store for CursorDesktopStore

Available on crate feature opencode only.

type H = CursorDesktop

type Ref = String

impl Store for CursorStore

Available on crate feature opencode only.

type H = Cursor

type Ref = PathBuf

impl Store for GrokStore

type H = Grok

type Ref = PathBuf

impl Store for HermesStore

Available on crate feature hermes only.

type H = Hermes

type Ref = String

impl Store for OpenCodeStore

type H = OpenCode

type Ref = String

impl Store for PiStore

type H = Pi

type Ref = PathBuf