| 1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889 |
- #!/usr/bin/env python3
- """Open a URL, dev server, or file in the Hermes desktop GUI's preview pane.
- Registration lives in the `desktop_preview` tool (``tools.preview_tool``); this module keeps
- the normalizer + open action. Emits ``preview.open`` via ``desktop_ui``: the renderer opens
- the pane for the window that asked and never steals focus for a background session.
- """
- import os
- import re
- from pathlib import Path
- from urllib.parse import unquote, urlparse
- from tools import desktop_ui
- from tools.registry import tool_error
- def _normalize_target(raw: str) -> str:
- """Coax a bare host/domain into a fetchable URL; leave paths + schemes alone.
- ``www.cnn.com`` -> ``https://www.cnn.com``; ``localhost:3000`` -> ``http://localhost:3000``.
- File paths and explicit schemes pass through for the renderer's preview normalizer.
- """
- v = raw.strip().strip("`").strip()
- if not v or "://" in v or v.startswith(("/", "./", "../", "~", "file:")):
- return v
- if re.match(r"^(localhost|127\.0\.0\.1|0\.0\.0\.0|\[::1\])(:\d+)?(/|$)", v, re.IGNORECASE):
- return "http://" + v
- if re.match(r"^[\w.-]+\.[a-z]{2,}(:\d+)?(/.*)?$", v, re.IGNORECASE):
- return "https://" + v
- return v
- def _local_fs_path(target: str) -> Path | None:
- """Return a filesystem path for local targets; None for http(s) URLs."""
- raw = (target or "").strip()
- if not raw:
- return None
- if "://" in raw:
- parsed = urlparse(raw)
- if parsed.scheme.lower() != "file":
- return None
- path = unquote(parsed.path or "")
- if parsed.netloc and parsed.netloc not in {"", "localhost"}:
- path = f"//{parsed.netloc}{path}"
- elif (
- os.name == "nt"
- and len(path) >= 3
- and path[0] == "/"
- and path[2] == ":"
- ):
- path = path[1:]
- return Path(path) if path else None
- return Path(raw).expanduser()
- def _is_existing_directory(target: str) -> bool:
- path = _local_fs_path(target)
- if path is None:
- return False
- try:
- return path.is_dir()
- except OSError:
- # Stat failed (permissions, broken reparse, etc.). Do not treat that
- # as "this is a directory" — reject only when we positively observe
- # an existing directory. The renderer still sees the original target.
- return False
- def open_preview_tool(url: str, label: str = "") -> str:
- """Ask the desktop GUI to show ``url`` in the preview pane beside the chat."""
- target = _normalize_target(url or "")
- if not target:
- return tool_error(
- "url is required — a web URL (https://…), a localhost dev server, or a "
- "file path to show in the preview pane.")
- if _is_existing_directory(target):
- return tool_error(
- "directories are not previewable — pass a file path or a URL. "
- f"{target} is a directory."
- )
- label = (label or "").strip()
- return desktop_ui.emit_or_error(
- "preview.open",
- {"url": target, "label": label},
- "Failed to open the preview pane: ",
- "The preview pane is only available in the Hermes desktop app.",
- {"success": True, "url": target, "label": label})
|