owa_click
Presses an app control by its on-screen label, trying candidate labels in order and waiting for panels to render. Use "Panel > Control" to target the right control and read the result to confirm what the click did.
Instructions
Click a control in the app, found by the exact words written on it -- pass a list of candidate labels and the first one on screen wins. Waits a moment for a panel that is still rendering, and when nothing matches it answers with the closest labels it did find, so retry with one of those instead of giving up. Write "Panel > Control" to mean the one inside that panel ("Background > Videos"), which is how a word several panels share picks the right one. The answer says what was pressed AND what the press did: didChange, isOnNow for a control with an on/off state, opened / closed (menu, dialog, panel or window) for what it brought up or put away, and unverified when nothing changed. Pressing something is not the thing happening -- on unverified, check (owa_list_screens, owa_app_state, owa_find_ui) before telling the user it worked. Anything that changes what the congregation sees -- presenting, clearing, hiding a screen -- must be offered to the user first, never done unasked. button: "right" opens the control's own menu (a list row's Rename, Move to Trash…); clicks: 2 double-clicks (opens a document, plays a clip).
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": {
"find": "<find>"
},
"name": "owa_click"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| find | Yes | The label written on the control, or a list of candidate labels to try in order. | |
| page | No | Part of the window URL, e.g. "reader.html"; default the main window. | |
| button | No | ||
| clicks | No |