Check an agent action against a mandate
check_actionCall this before your agent does something consequential (sends, pays, deletes, publishes, installs or changes access). Pass mandate (the operator's rules; the first matching clause decides) and action (kind, verb, target, optional counterparty and amount). Returns permit, deny or escalate with the governing clause, a reason, an action digest and a signed receipt; treat error as deny. Advisory: it cannot stop an action, and it keeps no request content. To check a new mandate first, call validate_mandate. Examples: inputSchema. Docs: https://hanria.ai/llms.txt
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": {
"operation": {
"kind": "file",
"verb": "read",
"target": "/tmp/example"
},
"requested_by": {
"agent": "example-agent"
},
"justification": "Read the permitted file.",
"schema_version": "0.1-draft"
},
"mandate": {
"clauses": [
{
"id": "permit-file",
"match": {
"kind": [
"file"
]
},
"effect": "permit"
}
],
"default": "deny",
"purpose": "Permit one file action.",
"mandate_id": "minimal-permit",
"schema_version": "0.2-draft"
}
},
"name": "check_action"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | A typed description of a proposed operation, submitted by an agent to a local HANRIA runtime. MUST NOT contain credentials, secrets, private keys, or tokens. | |
| mandate | Yes | An operator-authored statement of what an agent may do. Written by a person, read by an agent, evaluated locally. A mandate is advisory: it describes intended authority and supports a local check, but it does not enforce anything. Enforcement requires a component that exclusively holds the credentials and can refuse. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| clause | No | The clause that decided, when one did. | |
| reason | Yes | ||
| outcome | Yes | Treat error as deny. | |
| receipt | No | Ed25519-signed receipt binding the outcome to this action and mandate for 15 minutes. Keys and the signed-bytes rule: https://check.hanria.ai/.well-known/hanria-receipt-keys.json | |
| clause_note | No | ||
| mandate_ref | No | ||
| action_digest | No | SHA-256 of hanria-action-v1 followed by the action's canonical JSON. | |
| schema_version | Yes |