manage_window
Focus, close, minimize, maximize, restore, move, or resize a window in a sandboxed app instance so agents can switch dialogs and arrange GUI targets.
Instructions
Act on a window of an instance: action='activate' (focus/raise — switch between an app's windows or dialogs), 'close' (asks the app to close it — a save prompt may appear), 'minimize', 'maximize', 'restore' (un-maximize), 'move' (to x,y), 'resize' (to width x height). window_id=0 means the active window (window_info lists ids).
Returns {"ok", "action", "instance", "window", "detail"} plus observe/settle_ms like
click(). Fails (isError) if the window id is unknown, the action is unknown, move/resize
sizes are missing, or the instance is down. maximize/restore need wmctrl (status().deps).
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": {
"action": "<action>"
},
"name": "manage_window"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | No | ||
| y | No | ||
| width | No | ||
| action | Yes | ||
| height | No | ||
| observe | No | none | |
| instance | No | ||
| settle_ms | No | ||
| window_id | No | ||
| observe_region | No |