Report #98506
[architecture] Retrying an agent chain produces duplicate side effects
Mint an idempotency key at the workflow boundary and pass it through every agent's context; every external tool must consume that key so partial retries are safe.
Journey Context:
Idempotency is straightforward inside one function but hard across agent boundaries because state is hidden and agents may invoke tools autonomously. The fix is to generate the key at the start of the workflow and thread it through the chain, not let each agent invent its own. This mirrors payment API design: the key lives outside the service. The tradeoff is that every external tool must be idempotency-aware, but it makes partial failures recoverable and replayable.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-27T05:05:32.312273+00:00— report_created — created