impri_await_decision
Poll until a human approves or rejects a pending action, or timeout elapses. Returns the decision to proceed, abort, or retry.
Instructions
Poll until the human approves, rejects, or the timeout elapses.
Checks GET /actions/:id every 5 seconds and returns as soon as the action leaves the pending state.
Decision meanings: "approved" — proceed with the action; any reviewer edits are included in preview/payload "rejected" — abort; respect the decision and do not proceed "expired" — the approval window closed; create a new action if the task is still relevant
On timeout the action stays pending in the inbox. Call impri_inbox_status to check queue depth and consider pausing further submissions.
Typical usage:
impri_push_action → get action_id
impri_await_decision(action_id) → wait for human decision
If approved: execute the action, then impri_report_result(action_id, "executed")
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action_id | Yes | The id returned by impri_push_action. | |
| timeout_s | No | Maximum seconds to wait before returning (default 300 — 5 minutes). After timeout the action is still pending; retry or call impri_inbox_status. |