AI & agents

Durable, resumable agent runs

Lets a long multi-step agent run survive a restart and resume where it stopped, without repeating side effects.

RoadmapEngine edition 5f8ea3af

What it does

The engine contains a durable run store: a persisted state machine that executes an ordered plan of tool steps and writes a checkpoint after each one. It sits beside the in-memory agent loop. No route or command mounts it, so it is a roadmap capability.

How it works

A run moves through pending, running, waiting for approval, completed, failed and cancelled. For every side-effecting step the store writes a record before the tool runs, under a stable idempotency key, and advances the checkpoint solely after the effect is durable. A crash in either window costs at most one redundant tool call, never a duplicated effect, provided the tool honours the key.

Lifecycle events are appended to the durable outbox before the matching state change, and a step event is re-emitted on resume, so the event stream is complete after a crash. A step that needs approval parks the run in a durable waiting state that survives a restart; approve and deny drive it forward. Cancellation is a durable flag re-read at every boundary, and a lease stops two workers from driving one run.

Where you reach it

  • LibraryDurableRunStore (Rust crate kynetra-agents; not mounted by the server)

Limits

  • Not reachable through any route, command or setting of the private-preview server.
  • Exactly-once effects depend on the tool honouring the idempotency key it is given.

Evidence

  • Tests31 test functions cover kill-and-resume, crash windows, approval parking, cancellation, leases and event emission

Test coverage is listed as present in the engine repository at this edition. This page does not report test results.

KynetraDB is in private preview

This is not available in the preview. Request a preview to discuss the current scope.