Skip to main content

Module ui_shortcuts

Module ui_shortcuts 

Source
Expand description

Agent-facing shortcuts (ListShortcuts / RunCommand / PressKeys), docs/specs/PLAN_SHORTCUTS_VERIFIED_AND_APP_API_2026_10_10.md §4. Same identity model as the rest of ui_handlers: the caller’s own pane is derived from its verified identity, never taken from the request.

Functions§

close_pane 🔒
RunCommand pane:close: the pane named by target, closed the way ClosePane closes it (app_api::pane::close_pane_as). A pane the agent is in closes at once; another agent’s pane waits 15 s for its user to keep it, and the answer says so. The key itself closes the focused pane at once, with no undo, so the page never runs it for MuxAPI.
handle_ui_press_keys 🔒
POST /api/v1/ui/shortcuts/press — backs PressKeys.
handle_ui_run_command 🔒
POST /api/v1/ui/shortcuts/run — backs RunCommand.
handle_ui_shortcuts_list 🔒
POST /api/v1/ui/shortcuts/list — backs ListShortcuts.
refused_command 🔒
Commands no agent may run: agents are first-class owners, so only what has no protection. A permanent delete can’t be undone. The frontend refuses it too, and PressKeys of any key bound to it.