​

journal

• workspace files — checkpoints/ (shadow-git), snapshot/;
• finished conversation messages — session/store.py;

​

Design notes

• Reuses the zero-dependency stdlib sqlite3 persistence pattern already used by :mod:praisonaiagents.runs.sqlite_ledger and :mod:praisonaiagents.session (WAL, busy_timeout, a single re-entrant-lock-guarded shared connection).
• Default-off / zero-overhead: nothing writes to the journal unless a run opts in (e.g. Agent(..., durable=True)). This module is lazy-imported from :mod:praisonaiagents.runtime, so importing the package stays cheap.
• Complements — does not replace — :mod:praisonaiagents.runs, which tracks run status (queued/running/…); this tracks the per-event cursor.

from praisonaiagents.runtime import RunJournal, JournalEvent

j = RunJournal(":memory:")
j.open_run("r1", agent="coder", task="migrate module")

# ── record each boundary as it happens ──
seq = 0
j.append(JournalEvent("r1", seq, "model_decision", {"text": "call tool X"}))

# ── on resume, memoise recorded steps ──
replay = j.replay_index("r1")            # {(seq, kind): payload}
if (rec := replay.get((seq, "model_decision"))) is not None:
    resp = rec                            # cached — do NOT re-call the model

j.close_run("r1", "succeeded")

​

Import

from praisonaiagents.runtime import journal

​

Classes

​

Constants