cli_browser_gateway.py 3.6 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374
  1. """Classic CLI ``/browser`` on the shared gateway (#134889 CLI-9): ``browser.manage``, as Ink and
  2. Desktop send it. Split from ``cli_commands_mixin`` (the file is over its size target)."""
  3. from __future__ import annotations
  4. import os
  5. from urllib.parse import urlparse
  6. from hermes_cli.browser_connect import DEFAULT_BROWSER_CDP_URL
  7. from hermes_cli.cli_commands_session_tools import _say_block, _t
  8. def _gateway_is_remote() -> bool:
  9. """True when this CLI attaches to an explicitly named gateway WebSocket that is not loopback
  10. (``HERMES_TUI_GATEWAY_URL``): Desktop's ``mode === 'remote'``."""
  11. raw = os.environ.get("HERMES_TUI_GATEWAY_URL", "").strip()
  12. if not raw:
  13. return False
  14. host = (urlparse(raw).hostname or "").lower()
  15. return host not in {"127.0.0.1", "localhost", "::1"}
  16. def gateway_browser(cli, connection, word: str, rest: str) -> None:
  17. """``/browser`` on the shared gateway (#134889 CLI-9): ``browser.manage``, the verb Ink and
  18. Desktop send. The browser tools run in the gateway, so changing this process's
  19. ``BROWSER_CDP_URL`` would change nothing the agent uses. ``connect``/``disconnect`` manage a
  20. browser on the gateway HOST: only against a local gateway (Desktop's rule). The gateway scopes
  21. them to this session's profile."""
  22. from hermes_cli.gateway_client import GatewayClientError
  23. if word in {"connect", "disconnect"} and _gateway_is_remote():
  24. return _say_block(_t("browser.remote_gateway"))
  25. params = {"action": word, "session_id": cli.session_id}
  26. if word == "connect":
  27. normalized = _normalize_cdp_url(rest or DEFAULT_BROWSER_CDP_URL)
  28. if normalized is None:
  29. return
  30. params["url"] = normalized[0]
  31. print(f" {_t('browser.checking', url=params['url'])}")
  32. try:
  33. result = connection.call("browser.manage", **params) or {}
  34. except GatewayClientError as exc:
  35. return _say_block(f" ⚠ {exc}")
  36. for message in result.get("messages") or ():
  37. print(f" {message}")
  38. if word == "disconnect":
  39. return _say_block(_t("browser.disconnected"), f" {_t('browser.reverted')}")
  40. if word == "connect":
  41. if not result.get("connected"):
  42. return _say_block(_t("browser.not_connected"))
  43. return _say_block(_t("browser.connected"), f" {_t('browser.endpoint', url=result.get('url') or '')}")
  44. if result.get("connected"):
  45. return _say_block(_t("browser.status_connected"), f" {_t('browser.endpoint', url=result.get('url') or '')}")
  46. _say_block(_t("browser.status_gateway_default"),
  47. f" {_t('browser.status_connect_hint')}", f" {_t('browser.status_disconnect_hint')}")
  48. def _normalize_cdp_url(cdp_url: str):
  49. """Validate a /browser connect URL: ``(cdp_url, port)`` or None after printing the error.
  50. A ``/devtools/browser/<id>`` path is kept verbatim; anything else is reduced to the origin."""
  51. parsed = urlparse(cdp_url if "://" in cdp_url else f"http://{cdp_url}")
  52. if parsed.scheme not in {"http", "https", "ws", "wss"}:
  53. _say_block(f" {_t('browser.unsupported_scheme', scheme=parsed.scheme or _t('browser.scheme_missing'))}")
  54. return None
  55. try:
  56. port = parsed.port or (443 if parsed.scheme in {"https", "wss"} else 80)
  57. except ValueError:
  58. _say_block(f" {_t('browser.invalid_port', url=cdp_url)}")
  59. return None
  60. if not parsed.hostname:
  61. _say_block(f" {_t('browser.missing_host', url=cdp_url)}")
  62. return None
  63. if parsed.path.startswith("/devtools/browser/"):
  64. return parsed.geturl(), port
  65. return parsed._replace(path="", params="", query="", fragment="").geturl(), port