Idempotency

experimental

Reusable idempotency records for safely deduplicating retries, webhooks, jobs, payments, forms, and other at-least-once operations.

4 hooks 5 events 5 permissions

Idempotency is source-visible, contract-first code — your agent reads the whole interface before it composes, never a black box.

Every hook has typed I/O and required tests, and the composition is pinned in microservices.lock.json — what you inspect here is exactly what pnpm microservices check verifies and deploys.

Typed hooks

Extension points with typed input/output and required tests — customize behavior without forking the module.

  • beforeIdempotencyClaim
  • afterIdempotencyComplete
  • afterIdempotencyFail
  • onIdempotencyReplay

Events emitted

A stable, documented event surface other modules can subscribe to.

  • idempotency.claimed
  • idempotency.replayed
  • idempotency.completed
  • idempotency.failed
  • idempotency.expired_pruned

Permissions

Scoped capabilities the module declares; the gateway enforces them at the boundary.

  • idempotency.claim
  • idempotency.read
  • idempotency.admin
  • idempotency.extend
  • idempotency.observe

Experimental listing. Generated from the canonical module manifest via `registry build`.