session_ask_user
Prompt a human to perform a browser action using a confirmation badge, returning immediately while you poll for the outcome.
Instructions
Ask the human to do something in the browser, and show the request in the on-page badge with a confirmation button. Returns immediately — poll session_poll_user_action for the outcome. Also relay the instruction in your reply, so it is visible whether or not they are looking at the browser window.
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": {
"instruction": "<instruction>"
},
"name": "session_ask_user"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wait_for | No | What counts as done. 'confirmation' — the on-page button — is the only unambiguous one. | confirmation |
| instruction | Yes | Exactly what the person should do, in one sentence. |