show_headless_desktop
Temporarily switch the live screen to a headless desktop, enabling a person to complete a login or manual step with a safety banner and emergency exit.
Instructions
Temporarily switch the live screen to a headless desktop for human interaction.
The entire off-screen desktop (and the apps running on it) becomes interactive
and visible, so a person can complete a LOGIN or any manual step. A topmost,
non-dismissible banner explains what to do and provides an EMERGENCY EXIT button
that immediately restores the normal desktop. Call hide_headless_desktop to
switch back normally afterwards.
Args: params (ShowHeadlessDesktopInput): desktop name and banner instruction.
Returns: str: JSON {"ok": true, "name": "...", "visible": true, "safety_banner": true, "note": "..."}.
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": {
"params": "<params>"
},
"name": "show_headless_desktop"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |