Prevent Duplicate Consequential Agent Actions
once_executeCALL THIS when an AI agent is about to perform or retry a consequential external side effect where duplication would be harmful: purchase, refund, payment, booking, send, create, modify, submit, or delete. ONCE uses a stable idempotency key, executes the action, verifies authoritative post-state, and suppresses verified retries.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"idempotencyKey": "<idempotencyKey>",
"action": "<action>",
"verify": "<verify>"
},
"name": "once_execute"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | ||
| verify | Yes | ||
| idempotencyKey | Yes | Stable key representing this one intended real-world action. Reuse it for retries. |