Internal Agents Map

The worker can stop. The work can continue.

A new worker can continue from a saved record.

First posted · Updated · 2 min read

What the next worker reads

Shopify’s Aquifer keeps session identity and an append-only event log in Postgres. An idle worker can exit; a fresh worker reads the same conversation when the next interaction arrives. [1]

Worker ARecords events, then exits.
Worker BReads the session when work resumes.
Shared Postgres sessionThe identity and event log remain outside either worker.
Our illustration of Aquifer's reported separation of workers and session state.

Sentry’s Junior pauses near a serverless deadline and queues a continuation task. Its intended pause point is the end of a tool result. This describes task continuation; it does not document recovery of every local file. [2]

Sierra’s Agency restores a hibernated runner by replaying ordered events from its last checkpoint. The application-specific runner decides what goes into the checkpoint and subsequent events. That choice determines what replay can restore. [3]

Conversation, files, and effects

These mechanisms preserve different records. A restored conversation does not imply that a workspace file survived. A restored file does not establish whether an earlier request completed in another system.

Our inference is that recovery needs to identify which of these records the next worker can trust. For an external action, a receipt or an idempotency mechanism may be needed to distinguish a completed request from one that needs retrying. The reports above do not establish that their session recovery provides this property for every connected tool.

Sources

  1. Shopify: Under the RiverThe session record and disposable workers.
  2. Sentry: Building an internPauses and continuation tasks before timeouts.
  3. Sierra: AgencyCheckpoints and event replay after inactivity.
Know an internal agent?

Share a resource or public mention, suggest an addition, or correct an existing entry. Pull requests are also welcome.