wait_for_text
Wait for specific text to appear or disappear on screen using OCR polling, returning as soon as the condition is met or reporting a timeout instead of sleeping blindly.
Instructions
Wait until text appears on screen (or, appear=false, disappears) — by OCR/parse polling.
The honest replacement for "sleep and hope" after navigation or a submit: returns as soon as
the text is (not) there, or reports "timed_out": true.
Returns {"ok", "instance", "found": bool, "satisfied": bool, "elapsed_ms", "polls", "element": {id, type, label, center} | null, "timed_out"}. "satisfied" is what you waited for; "timed_out": true with satisfied: false is reported, not hidden — screenshot to see what IS there. timeout_ms max 60000, interval_ms 300–5000. Fails (isError) if the instance is down or there is no grounding backend (vision mode 'none').
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": {
"text": "<text>"
},
"name": "wait_for_text"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | ||
| appear | No | ||
| instance | No | ||
| timeout_ms | No | ||
| interval_ms | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |