Files
hermes-agent/tools/apply_layout_tool.py
Teknium 5442a2a371 refactor(tools): trim small tool modules (docstrings, dead constant, prefix table)
- audio_container: CONTAINER_TO_EXT built from one tuple; fixed-prefix sniffs table-driven.
- apply_layout_tool: dead _TIMEOUT_NOTE indirection inlined.
- Module/function docstrings compacted by hand; regexes, byte patterns, schemas and
  registry.register kwargs byte-identical (SCHEMA_SAME verified).
2026-09-02 22:36:16 -07:00

53 lines
1.9 KiB
Python

"""Apply a layout preset in the Hermes desktop GUI (``layout.apply`` via ``desktop_ui``).
The renderer resolves the id against its layouts registry (core, plugin and user
presets are one list); only the active window's session acts, so a background turn
never rearranges the desktop. Preset ids are free-form on purpose. The renderer
answers with the applied id/title, or the available ids when unknown, so the model
can self-correct without a registry-listing tool.
"""
from tools import desktop_ui
from tools.registry import registry, tool_error
def apply_layout_tool(preset: str) -> str:
"""Ask the desktop GUI to apply layout preset ``preset``."""
name = (preset or "").strip()
if not name:
return tool_error("preset is required — a layout preset id, e.g. 'default' or 'focus'.")
return desktop_ui.emit_or_error(
"layout.apply", {"preset": name}, f"Failed to apply layout '{name}': ",
"Layout apply is only available in the Hermes desktop app.", {"success": True, "preset": name},
)
APPLY_LAYOUT_SCHEMA = {
"name": "apply_layout",
"description": (
"Apply a saved layout preset to the Hermes desktop app when the user "
"asks to rearrange the workspace. Built-ins: default (chat + "
"sidebars), focus (chat only), terminal-deck, quad; plugin/user "
"presets by id. To reveal ONE pane, use focus_pane instead."
),
"parameters": {
"type": "object",
"properties": {
"preset": {
"type": "string",
"description": "Layout preset id to apply (e.g. 'default', 'focus', 'terminal-deck', 'quad', or a user/plugin preset id).",
},
},
"required": ["preset"],
},
}
registry.register(
name="apply_layout",
toolset="desktop_ui",
schema=APPLY_LAYOUT_SCHEMA,
handler=lambda args, **kw: apply_layout_tool(preset=args.get("preset", "")),
emoji="🧱",
)