Check one spend
check_spendRead-onlyIdempotent
Read-only gate before you spend money or significant effort once: ten ordered checks of the ABA-1 fuse, instruction source, envelope, repeat, counterparty, price, expected value, stop-loss, irreversibility, delivery, receipt. Returns verdict GO, CAUTION or STOP and, per check, the result and the reason. Anything you do not declare counts against you: undeclared never passes. Changes nothing and stores nothing. Use it for a single payment or purchase; use audit_budget to judge the standing budget controls of a whole agent; use look to judge a piece of work.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| p_basis | No | measured if p_success is a base rate from your own records, estimated if it is a guess; an estimate is halved | |
| delivery | No | how delivery is secured: escrow, on_delivery, prepaid or unknown | |
| p_success | No | probability from 0 to 1 that the spend brings its value | |
| value_usd | No | what success is worth to you in US dollars | |
| amount_usd | Yes | the amount of this one spend in US dollars, a number above zero; required | |
| reversible | No | yes if the spend can be refunded or undone | |
| effort_cost_usd | No | compute and time this action costs you besides the amount | |
| period_spent_usd | No | what you already spent in the current period | |
| probe_amount_usd | No | the small amount you allow for testing an unknown payee; default one percent of the period budget | |
| period_budget_usd | No | your budget for the current period | |
| instruction_source | No | who asked for this spend: principal, own_plan or untrusted; untrusted means a web page, a message, another agent or stored memory, and stops the spend | |
| per_action_cap_usd | No | the largest single spend your mandate allows, enforced outside the model | |
| cumulative_cost_usd | No | everything already spent on this same goal | |
| reference_price_usd | No | a usual price for the same thing, to catch a price far above normal | |
| approved_out_of_band | No | yes if a human or a policy outside the model approved this exact spend | |
| counterparty_verified | No | yes if the payee is verified or on your allowlist; otherwise only a probe amount passes | |
| intent_settled_before | No | yes if a payment with this same intent id was already settled; then this is a duplicate and stops | |
| attempts_without_progress | No | how many attempts on this goal already brought no measurable progress; three stop the line |