Struct SqliteRunStore 

pub struct SqliteRunStore { /* private fields */ }

SQLite-backed persistent RunStore.

Open with SqliteRunStore::open (file path) or SqliteRunStore::open_in_memory (tests). Both return the store plus an AsyncIsleDriver the caller must shutdown().await when done — dropping the driver without a shutdown call leaves the SQLite thread as-is until the process exits.

Implementations

impl SqliteRunStore

pub async fn open( path: impl AsRef<Path>, ) -> Result<(Self, AsyncIsleDriver), RunStoreError>

Open (or create) a SQLite database file and run the schema migrations.

pub async fn open_in_memory() -> Result<(Self, AsyncIsleDriver), RunStoreError>

Open an ephemeral in-memory database (tests, doctests).

Trait Implementations

impl RunStore for SqliteRunStore

fn name(&self) -> &str

Backend name — for diagnostics/logging.

fn create<'life0, 'async_trait>( &'life0 self, record: RunRecord, ) -> Pin<Box<dyn Future<Output = Result<(), RunStoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Create a new Run row. Returns Duplicate if record.id is already stored.

fn get<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 RunId, ) -> Pin<Box<dyn Future<Output = Result<RunRecord, RunStoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Fetch a Run by id.

fn list_by_task<'life0, 'life1, 'async_trait>( &'life0 self, task_id: &'life1 TaskId, ) -> Pin<Box<dyn Future<Output = Result<Vec<RunRecord>, RunStoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

List every Run kicked from task_id, ascending by created_at (oldest kick first).

fn append_step_entry<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 RunId, entry: StepEntry, ) -> Pin<Box<dyn Future<Output = Result<(), RunStoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Append one step-trace entry to a Run’s step_entries, bumping updated_at to now.

fn append_degradation<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 RunId, entry: DegradationEntry, ) -> Pin<Box<dyn Future<Output = Result<(), RunStoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Append one worker-reported degradation to a Run’s degradations (GH #32), bumping updated_at to now. Independent of Self::append_step_entry — degradations never flow through step OUTPUT/fold.

fn update_status<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 RunId, status: RunStatus, ) -> Pin<Box<dyn Future<Output = Result<(), RunStoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Update a Run’s status, bumping updated_at to now.

fn try_transition<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 RunId, from: RunStatus, to: RunStatus, ) -> Pin<Box<dyn Future<Output = Result<bool, RunStoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Atomically transition a Run’s status from from to to, bumping updated_at to now — the compare-and-set primitive the resume path (POST /v1/runs/:id/resume) uses to guard against a double resume racing the same Interrupted Run into Running twice.

fn set_result<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 RunId, result_ref: Value, ) -> Pin<Box<dyn Future<Output = Result<(), RunStoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Set a Run’s terminal result_ref, bumping updated_at to now.

fn set_input_json<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 RunId, input_json: String, ) -> Pin<Box<dyn Future<Output = Result<(), RunStoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Replace the opaque launch snapshot after pre-dispatch binding has enriched it (for example with immutable bound_agents).

fn list_running<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Vec<RunRecord>, RunStoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

List every Run currently Running (issue #35 ST2 boot sweep + ST4 occupancy check reuse this). No ordering guarantee.

fn list<'life0, 'life1, 'async_trait>( &'life0 self, filter: &'life1 RunListFilter, ) -> Pin<Box<dyn Future<Output = Result<Vec<RunRecord>, RunStoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

List Runs matching filter, newest-first (created_at descending) — the GET /v1/runs collection read.

fn delete<'life0, 'life1, 'async_trait>( &'life0 self, id: &'life1 RunId, ) -> Pin<Box<dyn Future<Output = Result<(), RunStoreError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Delete a Run row (the DELETE /v1/runs/:id retention operation). The caller is responsible for pruning the sibling trace stream (crate::store::trace::RunTraceStore::delete_run) — the two stores are deliberately uncoupled at the trait level.