Skip to main content

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

Optional[str]
No description available.

Methods

open_run()

Register run_id as running (idempotent).

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.

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 166