Run Journal • AI Agent SDK

RunJournal: Append-only, restart-safe run-state journal backed by SQLite.

RunJournal

Defined in the journal module.

AI Agent

Append-only, restart-safe run-state journal backed by SQLite.

Thread-safe: a single re-entrant lock guards a shared connection opened with `check_same_thread=False, mirroring :class:~praisonaiagents.runs. sqlite_ledger.SQLiteRunLedger`.

Constructor

ParamField Optional[str]

No description available.

Methods

open_run()

set_checkpoint()

Bind the latest files checkpoint to `run_id` for resume.

close_run()

Mark `run_id` terminal so it is no longer resumed on restart.

delete_run()

Remove `run_id` and all its journal events.

run_meta()

Return the :class:RunMeta for `run_id or None` if unknown.

interrupted_runs()

Return ids of runs still `running` — resume candidates on restart.

append()

Append `ev to the journal (idempotent on run_id/seq/kind`).

events()

Return all journal events for `run_id ordered by (seq, kind)`.

replay_index()

Return a `(seq, kind): payload` lookup for memoised replay.

last_iteration()

Return the highest journalled iteration index, or `None`.

assert_replay_order()

Determinism guardrail: fail loud if replay diverges from the journal.

close()

Close the underlying database connection.

Source

View on GitHub

praisonaiagents/runtime/journal.py at line 170