ACAgentic Craft

IntermediateHazelJS

Idempotency

Property that performing the same logical operation multiple times yields one effect.

Authors
editorial-team
Published
Last reviewed

Direct answer

Property that performing the same logical operation multiple times yields one effect.

Plain language

If you press the button twice, you still only get one coffee.

Technical explanation

Client-supplied idempotency keys, dedupe stores, upsert semantics in @Tool adapters; essential for at-least-once AgentRuntime resumes and approveAndResume retries.

Example

create_refund({ charge_id, idempotency_key }) returns the same refund when AgentRuntime retries after a checkpoint gap.

Related

← All glossary terms