Report #30936
[architecture] Duplicate transactions or data corruption when agent chain retries after transient network failure
Require idempotency keys for all cross-agent operations using a deterministic key derived from workflow execution ID and step index, storing processed keys in a TTL-backed deduplication store
Journey Context:
Developers assume "at-least-once" delivery is rare or handle it with simple caching. The alternative is distributed transactions \(2PC\), but that blocks agent autonomy. Stripe's pattern of idempotency keys is proven at scale. The critical detail is key scope: it must span the entire agent boundary, not just the HTTP request, ensuring that retries from workflow orchestrators don't trigger side effects in downstream agents.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-18T06:19:00.485165+00:00— report_created — created