Files
hermes-agent/tools/read_window_tool.py
T
Teknium 95505c60e9 docs(tools): lead every tool description with its key capability
The deferred tool_search catalog shows each tool's first sentence clipped to
60 chars, so lines like 'image_generate: Generate high-quality images from
text prompts, or edit /…' hid that it edits with reference images on the
user's configured model. An agent skipped it and called FAL directly with a
hardcoded model.

- catalog line cap 60 -> 80 (CATALOG_SUMMARY_MAX_CHARS); every built-in
  tool's first sentence now fits and leads with what it does
- image_generate/video_generate say they use the configured model;
  image_generate says to use it rather than direct API calls/scripts
- web_search/web_extract/browser_exec name when to use each other
- drop a duplicated cronjob sentence and filler in skill_view/video_generate
- regenerate tests/fixtures/prompt_surface
2026-10-23 16:04:50 -07:00

48 lines
1.7 KiB
Python

#!/usr/bin/env python3
"""Read which OS window sits directly underneath the Hermes desktop window.
The window list lives with the OS, so this round-trips through the gateway's
blocking-prompt bridge like `read_terminal`: ``window.read.request`` -> the renderer's
main process (native window enumeration) -> ``window.read.respond``.
"""
from typing import Callable, Optional
from tools.read_terminal_tool import read_pane
from tools.registry import registry
def read_window_below_tool(callback: Optional[Callable] = None) -> str:
"""Return the window underneath the Hermes window as a JSON string."""
return read_pane(callback, (), (
"read_window_below is only available in the Hermes desktop app.",
"",
"Failed to read the window below: ",
"Could not determine the window underneath (the desktop app did "
"not answer, or window enumeration is unavailable on this system).",
))
READ_WINDOW_BELOW_SCHEMA = {
"name": "read_window_below",
"description": (
"Identify the app window behind the Hermes desktop window (what the user is in). JSON: {window: {app, title, bounds, "
"id}, frontmost, platform}. title may be empty when the OS withholds "
"it (noted in `note`); where windows cannot be enumerated at all, "
"{error, platform} says what would fix it — relay that instead of "
"retrying. Metadata only; never captures pixels."
),
"parameters": {
"type": "object", "properties": {}
},
}
registry.register(
name="read_window_below",
toolset="desktop_ui",
schema=READ_WINDOW_BELOW_SCHEMA,
handler=lambda args, **kw: read_window_below_tool(callback=kw.get("callback")),
emoji="🪟",
)