23 lines
1.3 KiB
Plaintext
23 lines
1.3 KiB
Plaintext
name: bring_to_front
|
|
|
|
description:
|
|
Persistently activate a window so subsequent input lands on it. This deliberately breaks the no-foreground contract and is not part of the normal input ladder. For an ordinary `background_unavailable` response, retry only the refused action with `delivery_mode:"foreground"`; the input tool performs its own activate, act, and restore sequence. Use `bring_to_front` only for a focus-proxy surface that must remain foreground across multiple calls, such as a remote desktop session, or when repeated action-scoped activation prevents the remote surface from accepting input. X11: EWMH _NET_ACTIVE_WINDOW activation (the `wmctrl -a` equivalent, with proper timestamp handling to beat focus-stealing prevention). Wayland: activates through a target-addressable compositor adapter (wlroots foreign-toplevel or the GNOME Shell helper) and refuses when the compositor offers no safe adapter. Matches the macOS / Windows bring_to_front rung.
|
|
|
|
input_schema:
|
|
{
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"pid": {
|
|
"type": "integer"
|
|
},
|
|
"window_id": {
|
|
"description": "X11 window id (xid) to activate. If omitted, the first window of `pid` is used.",
|
|
"type": "integer"
|
|
}
|
|
},
|
|
"required": [
|
|
"pid"
|
|
],
|
|
"type": "object"
|
|
}
|