runs • AI Agent SDK

Durable, recoverable run-ledger module for PraisonAI Agents.

runs

AI Agent

Durable, recoverable run-ledger module for PraisonAI Agents.

Provides a first-class ledger so long-running / async agent runs survive a gateway restart: every run is recorded with a stable `run_id, a :class:RunStatus`, a progress summary and a terminal outcome. On restart, orphaned runs are reconciled so the gateway can notify the originating user.

Layering:

Thin protocol + data shapes (:mod:~praisonaiagents.runs.protocols) are
always available and carry no heavy imports.
A zero-dependency SQLite default store
(:class:~praisonaiagents.runs.sqlite_ledger.SQLiteRunLedger) is lazily
loaded so importing this package stays cheap.

Usage::

python

from praisonaiagents.runs import SQLiteRunLedger, RunRecord, RunStatus

ledger = SQLiteRunLedger()                       # ~/.praisonai/runs/ledger.db
ledger.upsert(RunRecord(run_id="r1", channel="#ops",
                        status=RunStatus.RUNNING))
# ...gateway restarts...
for lost in ledger.recover_orphans():            # reconcile on boot
    notify_origin(lost)

Import

python

from praisonaiagents import runs