desktop_wait
Pause execution or block until a desktop condition is met, such as elapsed milliseconds, an element, window, text, menu, notification, or lifecycle event, so automated actions can be verified.
Instructions
agent-desktop wait: Wait for time (ms), element presence, text, or window appearance
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "desktop_wait"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ms | No | Milliseconds to pause | |
| app | No | Scope element, window, or text wait to this application | |
| menu | No | Block until a menu surface is open | |
| text | No | Block until text appears in the app's accessibility tree; with --notification, filter notification text | |
| count | No | Expected match count for --text waits | |
| event | No | Block until a desktop lifecycle signal, detected by baseline diff without needing to know the id/title up front: window-opened, window-closed, app-launched, app-terminated, focus-changed, surface-appeared, surface-dismissed | |
| value | No | Expected value for --predicate value | |
| action | No | Action for --predicate actionable: click (default), type, set-value, or clear | |
| window | No | Block until a window with this title appears; with --event, narrows the event wait to that window title instead of selecting a mode | |
| element | No | Block until this element ref appears in the tree | |
| timeout | No | Timeout in milliseconds for element/window/text waits | |
| predicate | No | Element wait predicate: exists, enabled, visible, actionable, or value | |
| window_id | No | Optional: narrow --event window-opened/window-closed/focus-changed to one window ID | |
| menu_closed | No | Block until the menu surface is dismissed | |
| notification | No | Block until a new notification arrives |