d4cec15b47
Behavior-neutral structural pass over tools/*: god-file extractions into sibling modules (file_operations_common/lint/search, file_tools_paths/ read_tracking/write, code_execution_env/rpc, tool_search_catalog/names/ validation, tts_command_provider, ...), duplicate helper unification, if/elif -> dispatch tables, dead-code removal, docstring compaction. Tool schemas (get_tool_definitions) verified byte-identical to base.
59 lines
1.9 KiB
Python
59 lines
1.9 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.desktop_ui import passthrough_json
|
|
from tools.registry import registry, tool_error
|
|
|
|
|
|
def read_window_below_tool(callback: Optional[Callable] = None) -> str:
|
|
"""Return the window underneath the Hermes window as a JSON string."""
|
|
if callback is None:
|
|
return tool_error(
|
|
"read_window_below is only available in the Hermes desktop app."
|
|
)
|
|
|
|
try:
|
|
raw = callback()
|
|
except Exception as exc:
|
|
return tool_error(f"Failed to read the window below: {exc}")
|
|
|
|
if not raw:
|
|
return tool_error(
|
|
"Could not determine the window underneath (the desktop app did "
|
|
"not answer, or window enumeration is unavailable on this system)."
|
|
)
|
|
return passthrough_json(raw)
|
|
|
|
|
|
READ_WINDOW_BELOW_SCHEMA = {
|
|
"name": "read_window_below",
|
|
"description": (
|
|
"Identify the app window directly behind the Hermes desktop window "
|
|
"(what the user is working 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="🪟",
|
|
)
|