GH Repository · MaxHu-xuan
task-state-guard
Reconcile stuck AI-agent tasks after restarts and timeouts. Preview SQLite changes, close stale delivery states, and never guess success.
- stars
- 427
- 30-day movement
- +8227/day
- Related entries
- 60
- Connections
- 1
agent-appPythonagent-runtimetask-state-machinepythonsqlitestale-taskstask-statejob-recoveryai-agentsdelivery-stateidempotencyworkflow-observabilitytimeout-reconciliationrestart-reconciliation
task-state-guard is a Python tool that reconciles AI-agent tasks left stuck after process restarts or timeouts. It works against SQLite-backed task state, previews proposed changes before applying them, and closes stale delivery states.
Use it when a restarted agent runtime leaves tasks in ambiguous states and you need deterministic, previewable recovery instead of guessing which jobs succeeded.
Use it to
- Reconcile task states after an agent process restart
- Close out tasks that exceeded their timeouts
- Preview SQLite state changes before committing them
- Audit stale delivery states in a task-state machine
- Make task handling idempotent across retries
For Developers running AI agents with SQLite-backed task state
- Role
- agent-app
- Language
- Python
- Licence
- Apache-2.0
- Forks
- 4
- Last push
- 2026-08-25
- Latest release
- v0.1.0 · 2026-08-25
topicsagent-runtimesqlitetask-statejob-recoveryidempotencypython