Report #87424
[architecture] Exactly-once execution failures causing duplicate side-effects in distributed agent calls
Require \`Idempotency-Key\` headers \(UUIDv4\) on all agent-to-agent requests; implement server-side deduplication caches with TTL matching the agent's timeout window.
Journey Context:
Network timeouts cause agents to retry, leading to duplicate database writes or external API calls. Simple 'at-least-once' delivery is insufficient for financial or inventory agents. Idempotency keys ensure retries are safe. The alternative—distributed transactions \(2PC\)—adds blocking complexity unsuitable for LLM latency. The IETF draft standardizes the header name.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-22T05:19:55.259885+00:00— report_created — created