Check the premises an action relies on
check_premisesCall it before EVERY action that changes or sends anything in any system, listed in get_my_setup or not (D-053). Stage 1 of the pre-action guard. Given the action you are about to take and the PINNED subject ids it relies on, returns allow/hold/deny per premise plus a short-lived lease for each cleared one. Takes subject ids, never a natural-language question — retrieval wording cannot change the verdict. To check the DOCUMENT you work from, omit subject_id and pass the document from get_my_setup as relied_on with content_hash ("sha256:" + hex SHA-256 of the exact text you read): allow only when that is the version its owner confirmed. Do the work, then call verify_premises with these leases IMMEDIATELY before acting. Fails closed: an unknown pin, an unreadable record or a premise that cannot be leased all return hold, never allow. Give Rithmo time to answer: wait at least 10 seconds for this call. No answer in that time is not a yes: do not act, as for a hold.
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": {
"intended_action": "<intended_action>",
"premises": "<premises>"
},
"name": "check_premises"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| run | No | Optional: the run context from start_agent_run, naming WHICH of your agents this check is for. Pass it when your connection serves several agents. A run whose agent was retired, or whose installation was disconnected, is refused here — the governed call is denied, not just hidden. | |
| surface | No | Optional: the external system the action concerns, forwarded to the guard for observation scoping. | |
| premises | Yes | The configured premises the intended action relies on. Pinned ids only; this tool never searches. | |
| resumes_hold | No | Optional: the hold_id of YOUR earlier held call that this call checks again (after get_hold_status says a person closed it). Linked only when it is the same request: your own hold, the same intended_action and the same premises (role and subject). The response says whether it was linked. It never changes the verdict -- this is a fresh check. | |
| action_fields | No | Optional: the action's structured details, by name (e.g. {"amount": 900, "to": ["jane@example.com"]}). An agent whose rules limit a detail must send it; a detail its rules need that is missing is refused. The leases returned are bound to exactly these details: verify_premises must be given the same ones. Optional reserved detail "target": where the action happens, as "<system>:<place>[@<ref>]" (e.g. "github:owner/repo@refs/heads/main"), so what that system later shows was done there can be tied to this check; report the resulting id with report_action_outcome external_ref. | |
| intended_action | Yes | What the caller is about to do, as a short stable string (e.g. "send the weekly report"). Hashed into the lease, so a lease acquired for one action cannot authorize a different one. |