controlled_action
Evaluate and execute an action only when the Runtime Gate permits it, returning execution status or requesting human approval.
Instructions
Run the high-level AVP controlled-action flow.
Returns `ControlledActionOutcome.to_dict()` as a JSON string. Possible
statuses are `executed`, `approval_required`, and `blocked`. Human approval
is never auto-approved; after approval, call `execute_after_approval`.
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": {
"action": "<action>",
"resource": "<resource>",
"environment": "<environment>",
"delegation_receipt": "<delegation_receipt>"
},
"name": "controlled_action"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Action name to evaluate and execute only if Runtime Gate allows it | |
| amount | No | Optional monetary amount for spend-sensitive actions. Omit when not applicable | |
| params | No | Optional execution params as a JSON object string. Default: {} | {} |
| currency | No | Optional ISO currency code for spend-sensitive actions. Example: USD | |
| resource | Yes | Target resource identifier bound into the Runtime Gate decision | |
| environment | Yes | Execution environment. Examples: development, staging, production | |
| delegation_receipt | Yes | DelegationReceipt JSON object string issued by the workflow owner/principal | |
| approval_expires_in_seconds | No | Approval TTL in seconds when Runtime Gate returns WAITING_FOR_HUMAN_APPROVAL |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |