2776813df3
The Sep 2026 decomposition (PR #102117) makes internal import paths a non-API: names now live in the focused modules that define them. This commit is the ONLY thing keeping the old paths alive, so external plugins have time to update. It is deliberately a single, unsquashed commit: git revert <this sha> removes every shim, stub and manifest at once on the announced date. Nothing in-tree may depend on these pointers: scripts/check_compat_pointers.py (wired into lint.yml) fails CI if it does. What it adds (see COMPAT_MANIFEST.md, compat_manifest.json): - 332 facade modules get one delimited `PLUGIN-COMPAT` block appended at the end of the file - 1,172 moved names resolved lazily via a module `__getattr__` (PEP 562) — never a top-level import, so no import cycles; facades that already had `__getattr__` get a chained one - 592 third-party/stdlib names the old modules used to expose, with their original import statements - 266 public definitions that had been deleted as unused, restored byte-for-byte from the pre-decomposition tree (+40 private helpers and 16 imports pulled in only because a restored definition needs them) - 3 deleted modules recreated as re-export stubs (gateway/startup_watchdog, hermes_cli/observability/ relay_runtime, tools/environments/modal_utils) - private names (`_x`) get no pointer: they were never API (3,792 skipped) Verified: all 335 touched modules import under a fresh HERMES_HOME and every manifest name resolves; the lint reports zero in-tree uses; ruff clean; targeted suites unchanged.
90 lines
3.5 KiB
Python
90 lines
3.5 KiB
Python
#!/usr/bin/env python3
|
|
"""The `desktop_preview` tool — the preview pane beside the chat, as ONE tool.
|
|
|
|
open/close/read used to be three tools that each re-taught "the preview pane" world;
|
|
one action enum states it once (~576 -> ~210 schema tokens). action=read keeps its
|
|
agent-level callback dispatch (agent_runtime_helpers -> agent.read_preview_callback).
|
|
Lives in the ``desktop_ui`` toolset — desktop-app sessions only.
|
|
"""
|
|
|
|
from tools import desktop_ui
|
|
from tools.open_preview_tool import _normalize_target, open_preview_tool
|
|
from tools.registry import registry, tool_error
|
|
|
|
|
|
def preview_close(url: str = "") -> str:
|
|
target = _normalize_target(url or "")
|
|
return desktop_ui.emit_or_error(
|
|
"preview.close",
|
|
{"url": target},
|
|
"Failed to close the preview: ",
|
|
"The preview pane is only available in the Hermes desktop app.",
|
|
{"success": True, "closed": target or "all"},
|
|
)
|
|
|
|
|
|
_ACTIONS = {
|
|
"open": lambda args: open_preview_tool(url=args.get("url", ""), label=args.get("label", "")),
|
|
"close": lambda args: preview_close(url=args.get("url", "")),
|
|
# read needs the GUI callback and is dispatched at the agent level.
|
|
"read": lambda args: tool_error(
|
|
"preview read must run inside a desktop session (no GUI callback here)."),
|
|
}
|
|
|
|
|
|
def _handle_preview(args, **kw):
|
|
"""Non-read actions only: action=read is dispatched at the agent level."""
|
|
fn = _ACTIONS.get((args.get("action") or "").strip())
|
|
if fn is None:
|
|
return tool_error("action must be one of: open, close, read.")
|
|
return fn(args)
|
|
|
|
|
|
PREVIEW_SCHEMA = {
|
|
"name": "desktop_preview",
|
|
"description": (
|
|
"Open, close, or read the preview pane beside the chat. open: show "
|
|
"a web URL (bare domains fine), a localhost dev server, or a file path "
|
|
"(HTML renders live) — opens for the current window only. close: dismiss "
|
|
"the whole pane, or one tab via url. read: what the pane currently shows "
|
|
"— returns {kind, url, title, text, start, end, total_chars}; a Browser "
|
|
"tab's text is the rendered page's visible text, paged with start/count "
|
|
"(char offsets); a file tab answers identity only (read the file with "
|
|
"read_file)."
|
|
),
|
|
"parameters": {
|
|
"type": "object",
|
|
"properties": {
|
|
"action": {"type": "string", "enum": ["open", "close", "read"]},
|
|
"url": {
|
|
"type": "string",
|
|
"description": "open: the target. close: one tab (omit for the whole pane).",
|
|
},
|
|
"label": {"type": "string", "description": "open: optional tab label."},
|
|
"start": {"type": "integer", "description": "read: 0-indexed char offset."},
|
|
"count": {"type": "integer", "description": "read: chars to return (capped per read)."},
|
|
},
|
|
"required": ["action"],
|
|
},
|
|
}
|
|
|
|
|
|
registry.register(
|
|
name="desktop_preview",
|
|
toolset="desktop_ui",
|
|
schema=PREVIEW_SCHEMA,
|
|
handler=_handle_preview,
|
|
emoji="🖼️",
|
|
)
|
|
|
|
|
|
# ---- BEGIN PLUGIN-COMPAT (revert-scheduled; see COMPAT_MANIFEST.md) ----
|
|
# Names external plugins imported from this module before the Sep 2026 decomposition.
|
|
# Internal code MUST NOT use these (scripts/check_compat_pointers.py fails CI if it does).
|
|
# The whole block is removed by reverting the commit that added it.
|
|
import json # noqa: F401,E402
|
|
|
|
def preview_open(url: str, label: str = "") -> str:
|
|
return open_preview_tool(url=url, label=label)
|
|
# ---- END PLUGIN-COMPAT ----
|