The agent that grows with you
Python aiai-agentai-agentsanthropicchatgptclaudeclaude-codecodexhermeshermes-agentllmnous-researchopenai
fix(cli): classic /browser goes to the gateway as browser.manage, profile-safe
Tekniume7cea8729c5a
diff --git a/hermes_cli/cli_browser_gateway.py b/hermes_cli/cli_browser_gateway.pynew file mode 100644index 00000000000..2e27cc74672--- /dev/null+++ b/hermes_cli/cli_browser_gateway.py@@ -0,0 +1,86 @@+"""Classic CLI ``/browser`` on the shared gateway (#134889 CLI-9): ``browser.manage``, as Ink and+Desktop send it. Split from ``cli_commands_mixin`` (the file is over its size target)."""+from __future__ import annotations++import os+from urllib.parse import urlparse++from hermes_cli.browser_connect import DEFAULT_BROWSER_CDP_URL+from hermes_cli.cli_commands_session_tools import _say_block, _t+++def _gateway_is_remote() -> bool:+ """True when this CLI attaches to an explicitly named gateway WebSocket that is not loopback+ (``HERMES_TUI_GATEWAY_URL``): Desktop's ``mode === 'remote'``."""+ raw = os.environ.get("HERMES_TUI_GATEWAY_URL", "").strip()+ if not raw:+ return False+ host = (urlparse(raw).hostname or "").lower()+ return host not in {"127.0.0.1", "localhost", "::1"}+++def gateway_browser(cli, connection, word: str, rest: str) -> None:+ """``/browser`` on the shared gateway (#134889 CLI-9): ``browser.manage``, the verb Ink and+ Desktop send. The browser tools run in the gateway, so changing this process's+ ``BROWSER_CDP_URL`` would change nothing the agent uses. ``connect``/``disconnect`` manage a+ browser on the gateway HOST: only against a local gateway (Desktop's rule). The gateway refuses+ them by name when it serves several profiles."""+ from hermes_cli.gateway_client import GatewayClientError+ if word in {"connect", "disconnect"} and _gateway_is_remote():+ return _say_block(_t("browser.remote_gateway"))+ params = {"action": word, "session_id": cli.session_id}+ if word == "connect":+ normalized = _normalize_cdp_url(rest or DEFAULT_BROWSER_CDP_URL)+ if normalized is None:+ return+ params["url"] = normalized[0]+ print(f" {_t('browser.checking', url=params['url'])}")+ if word == "use":+ mode = rest.lower() or "on"+ if mode not in {"on", "off"}:+ return _say_block(+ _t("browser.use_usage"),+ f" {_t('browser.use_on_hint')}", f" {_t('browser.use_off_hint')}")+ params["enabled"] = mode == "on"+ try:+ result = connection.call("browser.manage", **params) or {}+ except GatewayClientError as exc:+ return _say_block(f" ⚠ {exc}")+ for message in result.get("messages") or ():+ print(f" {message}")+ if word == "use":+ return _say_block(_t("browser.use_enabled" if params["enabled"] else "browser.use_disabled"),+ f" {_t('browser.new_sessions_only')}")+ if word == "disconnect":+ return _say_block(_t("browser.disconnected"), f" {_t('browser.reverted')}")+ if word == "connect":+ if not result.get("connected"):+ return _say_block(_t("browser.not_connected"))+ return _say_block(_t("browser.connected"), f" {_t('browser.endpoint', url=result.get('url') or '')}")+ if result.get("browser_use"):+ return _say_block(_t("browser.status_browser_use"), f" {_t('browser.status_use_off_hint')}")+ if result.get("connected"):+ return _say_block(_t("browser.status_connected"), f" {_t('browser.endpoint', url=result.get('url') or '')}")+ _say_block(_t("browser.status_gateway_default"),+ f" {_t('browser.status_connect_hint')}", f" {_t('browser.status_disconnect_hint')}")+++def _normalize_cdp_url(cdp_url: str):+ """Validate a /browser connect URL: ``(cdp_url, port)`` or None after printing the error.+ A ``/devtools/browser/<id>`` path is kept verbatim; anything else is reduced to the origin."""+ parsed = urlparse(cdp_url if "://" in cdp_url else f"http://{cdp_url}")+ if parsed.scheme not in {"http", "https", "ws", "wss"}:+ _say_block(f" {_t('browser.unsupported_scheme', scheme=parsed.scheme or _t('browser.scheme_missing'))}")+ return None+ try:+ port = parsed.port or (443 if parsed.scheme in {"https", "wss"} else 80)+ except ValueError:+ _say_block(f" {_t('browser.invalid_port', url=cdp_url)}")+ return None+ if not parsed.hostname:+ _say_block(f" {_t('browser.missing_host', url=cdp_url)}")+ return None+ if parsed.path.startswith("/devtools/browser/"):+ return parsed.geturl(), port+ return parsed._replace(path="", params="", query="", fragment="").geturl(), port+diff --git a/hermes_cli/cli_commands_mixin.py b/hermes_cli/cli_commands_mixin.pyindex 6e3608b948e..5e737412b3d 100644--- a/hermes_cli/cli_commands_mixin.py+++ b/hermes_cli/cli_commands_mixin.py@@ -38,6 +38,7 @@ from hermes_cli.cli_commands_session_tools import (from hermes_cli.browser_connect import (DEFAULT_BROWSER_CDP_URL, discover_local_cdp_url, find_free_debug_port, is_browser_debug_ready,launch_chrome_debug, local_port_in_use, manual_chrome_debug_command)+from hermes_cli.cli_browser_gateway import _normalize_cdp_url# Output helpers. Slash-command text is user-visible: every literal below is load-bearing.@@ -356,26 +357,6 @@ def _browser_use(cli, arg: str) -> None:_say_block(headline, f" {_t('browser.session_reset')}")-def _normalize_cdp_url(cdp_url: str):- """Validate a /browser connect URL: ``(cdp_url, port)`` or None after printing the error.- A ``/devtools/browser/<id>`` path is kept verbatim; anything else is reduced to the origin."""- parsed = urlparse(cdp_url if "://" in cdp_url else f"http://{cdp_url}")- if parsed.scheme not in {"http", "https", "ws", "wss"}:- _say_block(f" {_t('browser.unsupported_scheme', scheme=parsed.scheme or _t('browser.scheme_missing'))}")- return None- try:- port = parsed.port or (443 if parsed.scheme in {"https", "wss"} else 80)- except ValueError:- _say_block(f" {_t('browser.invalid_port', url=cdp_url)}")- return None- if not parsed.hostname:- _say_block(f" {_t('browser.missing_host', url=cdp_url)}")- return None- if parsed.path.startswith("/devtools/browser/"):- return parsed.geturl(), port- return parsed._replace(path="", params="", query="", fragment="").geturl(), port--def _launch_default_cdp_browser(port: int):"""Launch a local debug browser for the default CDP URL; returns the discovered CDP url orNone (after printing what went wrong / how to launch manually)."""@@ -1845,6 +1826,10 @@ class CLICommandsMixin(CLICommandsSessionToolsMixin):_t("browser.usage"), "",*(f" {_t(f'browser.usage_{sub}')}" for sub in ("connect", "disconnect", "status", "use")))return+ from hermes_cli.gateway_side import connection_for+ if (connection := connection_for(self)) is not None:+ from hermes_cli.cli_browser_gateway import gateway_browser+ return gateway_browser(self, connection, word, rest.strip())handler(self, rest.strip())# ---- /heartbeat, /refine, /review -----------------------------------------------------diff --git a/locales/af.yaml b/locales/af.yamlindex 0f8ee5fdd2e..65e020d215a 100644--- a/locales/af.yaml+++ b/locales/af.yaml@@ -3009,6 +3009,10 @@ cli:usage_disconnect: "disconnect Keer terug na die verstek-blaaieragterkant"usage_status: "status Wys die huidige blaaiermodus"usage_use: "use [off] Skakel oor na Browser Use-modus (CLI 3.0) / terug na ingeboude gereedskap"+ remote_gateway: "/browser connect en /browser disconnect bestuur 'n Chromium-blaaier op die gateway-gasheer — slegs beskikbaar wanneer aan 'n plaaslike gateway gekoppel."+ checking: "Kontroleer Chromium-blaaier se afstandontfouting by {url}..."+ new_sessions_only: "Geld vir nuwe sessies — hierdie een behou sy huidige gereedskap (/new om een te begin)."+ status_gateway_default: "🌐 Blaaier: die gateway se verstek-blaaier (geen lewendige CDP-verbinding nie)"heartbeat:label: "Hartklopte"paused: "⏸ Hartklop gepouseer: {prompt}"diff --git a/locales/ar.yaml b/locales/ar.yamlindex e19d6176517..fb47bac2849 100644--- a/locales/ar.yaml+++ b/locales/ar.yaml@@ -3009,6 +3009,10 @@ cli:usage_disconnect: "disconnect الرجوع إلى الواجهة الخلفية الافتراضية للمتصفح"usage_status: "status عرض وضع المتصفح الحالي"usage_use: "use [off] التبديل إلى وضع Browser Use (CLI 3.0) / الرجوع إلى الأدوات المضمّنة"+ remote_gateway: "/browser connect و /browser disconnect يديران متصفحًا من عائلة Chromium على مضيف البوابة — متاح فقط عند الاتصال ببوابة محلية."+ checking: "جارٍ التحقق من التصحيح عن بُعد لمتصفح Chromium على {url}..."+ new_sessions_only: "ينطبق على الجلسات الجديدة — تحتفظ هذه الجلسة بأدواتها الحالية (/new لبدء جلسة)."+ status_gateway_default: "🌐 المتصفح: الواجهة الافتراضية لمتصفح البوابة (لا يوجد اتصال CDP مباشر)"heartbeat:label: "النبضات"paused: "⏸ تم إيقاف النبض مؤقتًا: {prompt}"diff --git a/locales/de.yaml b/locales/de.yamlindex 0d85243855b..79e13ad9bf6 100644--- a/locales/de.yaml+++ b/locales/de.yaml@@ -3009,6 +3009,10 @@ cli:usage_disconnect: "disconnect Zurück zum Standard-Browser-Backend"usage_status: "status Aktuellen Browser-Modus anzeigen"usage_use: "use [off] In den Browser-Use-Modus (CLI 3.0) wechseln / zurück zu den integrierten Tools"+ remote_gateway: "/browser connect und /browser disconnect verwalten einen Chromium-Browser auf dem Gateway-Host — nur mit einem lokalen Gateway verfügbar."+ checking: "Prüfe Remote-Debugging des Chromium-Browsers unter {url}..."+ new_sessions_only: "Gilt für neue Sitzungen — diese behält ihre aktuellen Tools (/new startet eine neue)."+ status_gateway_default: "🌐 Browser: Standard-Browser-Backend des Gateways (keine Live-CDP-Verbindung)"heartbeat:label: "Heartbeats"paused: "⏸ Heartbeat pausiert: {prompt}"diff --git a/locales/en.yaml b/locales/en.yamlindex 961bd90f97b..3a3c6e7e680 100644--- a/locales/en.yaml+++ b/locales/en.yaml@@ -3109,6 +3109,10 @@ cli:usage_disconnect: "disconnect Revert to default browser backend"usage_status: "status Show current browser mode"usage_use: "use [off] Switch to Browser Use mode (CLI 3.0) / back to built-in tools"+ remote_gateway: "/browser connect and /browser disconnect manage a Chromium-family browser on the gateway host — only available when connected to a local gateway."+ checking: "Checking Chromium-family browser remote debugging at {url}..."+ new_sessions_only: "Applies to new sessions — this one keeps its current tools (/new to start one)."+ status_gateway_default: "🌐 Browser: the gateway's default browser backend (no live CDP connection)"heartbeat:label: "Heartbeats"paused: "⏸ Heartbeat paused: {prompt}"diff --git a/locales/es.yaml b/locales/es.yamlindex 6f51f34607f..4b6e63cd09b 100644--- a/locales/es.yaml+++ b/locales/es.yaml@@ -3009,6 +3009,10 @@ cli:usage_disconnect: "disconnect Volver al backend de navegador predeterminado"usage_status: "status Mostrar el modo de navegador actual"usage_use: "use [off] Cambiar al modo Browser Use (CLI 3.0) / volver a las herramientas integradas"+ remote_gateway: "/browser connect y /browser disconnect gestionan un navegador Chromium en el host del gateway — solo disponible con un gateway local."+ checking: "Comprobando la depuración remota del navegador Chromium en {url}..."+ new_sessions_only: "Se aplica a sesiones nuevas — esta conserva sus herramientas actuales (/new para iniciar una)."+ status_gateway_default: "🌐 Navegador: backend de navegador predeterminado del gateway (sin conexión CDP en vivo)"heartbeat:label: "Heartbeats"paused: "⏸ Heartbeat pausado: {prompt}"diff --git a/locales/fr.yaml b/locales/fr.yamlindex df50093d340..7775ab10b11 100644--- a/locales/fr.yaml+++ b/locales/fr.yaml@@ -3314,6 +3314,10 @@ cli:usage_disconnect: "disconnect Revenir au backend de navigateur par défaut"usage_status: "status Afficher le mode de navigateur actuel"usage_use: "use [off] Passer en mode Browser Use (CLI 3.0) / revenir aux outils intégrés"+ remote_gateway: "/browser connect et /browser disconnect gèrent un navigateur Chromium sur l'hôte de la passerelle — disponible uniquement avec une passerelle locale."+ checking: "Vérification du débogage distant du navigateur Chromium à {url}..."+ new_sessions_only: "S'applique aux nouvelles sessions — celle-ci garde ses outils actuels (/new pour en démarrer une)."+ status_gateway_default: "🌐 Navigateur : backend de navigateur par défaut de la passerelle (pas de connexion CDP en direct)"heartbeat:label: "Heartbeats"paused: "⏸ Heartbeat en pause : {prompt}"diff --git a/locales/ga.yaml b/locales/ga.yamlindex 42d681ea30a..4aae78d7e02 100644--- a/locales/ga.yaml+++ b/locales/ga.yaml@@ -3009,6 +3009,10 @@ cli:usage_disconnect: "disconnect Fill ar inneall brabhsálaí réamhshocraithe"usage_status: "status Taispeáin mód reatha an bhrabhsálaí"usage_use: "use [off] Athraigh go mód Browser Use (CLI 3.0) / ar ais go huirlisí ionsuite"+ remote_gateway: "Bainistíonn /browser connect agus /browser disconnect brabhsálaí Chromium ar óstach an gheata — ar fáil ach amháin le geata áitiúil."+ checking: "Ag seiceáil dífhabhtú cianda an bhrabhsálaí Chromium ag {url}..."+ new_sessions_only: "Baineann sé le seisiúin nua — coinníonn an ceann seo a uirlisí reatha (/new chun ceann a thosú)."+ status_gateway_default: "🌐 Brabhsálaí: inneall réamhshocraithe brabhsálaí an gheata (gan nasc beo CDP)"heartbeat:label: "Buillí croí"paused: "⏸ Buille croí curtha ar sos: {prompt}"diff --git a/locales/hu.yaml b/locales/hu.yamlindex a9c122f30b7..b9905c09579 100644--- a/locales/hu.yaml+++ b/locales/hu.yaml@@ -3026,6 +3026,10 @@ cli:usage_disconnect: "disconnect Visszaállás az alapértelmezett böngésző-háttérrendszerre"usage_status: "status Jelenlegi böngészőmód megjelenítése"usage_use: "use [off] Átváltás Browser Use módra (CLI 3.0) / vissza a beépített eszközökre"+ remote_gateway: "A /browser connect és /browser disconnect egy Chromium böngészőt kezel az átjáró gépén — csak helyi átjáróval érhető el."+ checking: "A Chromium böngésző távoli hibakeresésének ellenőrzése: {url}..."+ new_sessions_only: "Új munkamenetekre vonatkozik — ez megtartja a jelenlegi eszközeit (/new újat indít)."+ status_gateway_default: "🌐 Böngésző: az átjáró alapértelmezett böngésző-háttere (nincs élő CDP-kapcsolat)"heartbeat:label: "Szívverések"paused: "⏸ Szívverés szüneteltetve: {prompt}"diff --git a/locales/it.yaml b/locales/it.yamlindex 51df6a00b34..3b43d108c82 100644--- a/locales/it.yaml+++ b/locales/it.yaml@@ -3009,6 +3009,10 @@ cli:usage_disconnect: "disconnect Torna al backend browser predefinito"usage_status: "status Mostra la modalità browser attuale"usage_use: "use [off] Passa alla modalità Browser Use (CLI 3.0) / torna agli strumenti integrati"+ remote_gateway: "/browser connect e /browser disconnect gestiscono un browser Chromium sull'host del gateway — disponibile solo con un gateway locale."+ checking: "Verifica del debug remoto del browser Chromium su {url}..."+ new_sessions_only: "Si applica alle nuove sessioni — questa mantiene gli strumenti attuali (/new per avviarne una)."+ status_gateway_default: "🌐 Browser: backend browser predefinito del gateway (nessuna connessione CDP attiva)"heartbeat:label: "Heartbeat"paused: "⏸ Heartbeat in pausa: {prompt}"diff --git a/locales/ja.yaml b/locales/ja.yamlindex 222af881a73..ed72db7b3db 100644--- a/locales/ja.yaml+++ b/locales/ja.yaml@@ -3009,6 +3009,10 @@ cli:usage_disconnect: "disconnect デフォルトのブラウザバックエンドに戻します"usage_status: "status 現在のブラウザモードを表示します"usage_use: "use [off] Browser Use モード (CLI 3.0) に切り替え / 組み込みツールに戻します"+ remote_gateway: "/browser connect と /browser disconnect はゲートウェイホスト上の Chromium 系ブラウザーを管理します — ローカルゲートウェイ接続時のみ利用できます。"+ checking: "{url} で Chromium 系ブラウザーのリモートデバッグを確認しています..."+ new_sessions_only: "新しいセッションに適用されます — このセッションは現在のツールを維持します(/new で開始)。"+ status_gateway_default: "🌐 ブラウザー: ゲートウェイの既定ブラウザーバックエンド(ライブ CDP 接続なし)"heartbeat:label: "ハートビート"paused: "⏸ ハートビートを一時停止しました: {prompt}"diff --git a/locales/ko.yaml b/locales/ko.yamlindex 407abe9526b..2aaad1977b4 100644--- a/locales/ko.yaml+++ b/locales/ko.yaml@@ -3009,6 +3009,10 @@ cli:usage_disconnect: "disconnect 기본 브라우저 백엔드로 되돌리기"usage_status: "status 현재 브라우저 모드 표시"usage_use: "use [off] Browser Use 모드(CLI 3.0)로 전환 / 내장 도구로 복귀"+ remote_gateway: "/browser connect 및 /browser disconnect는 게이트웨이 호스트의 Chromium 계열 브라우저를 관리합니다 — 로컬 게이트웨이에 연결된 경우에만 사용할 수 있습니다."+ checking: "{url}에서 Chromium 계열 브라우저 원격 디버깅을 확인하는 중..."+ new_sessions_only: "새 세션에 적용됩니다 — 이 세션은 현재 도구를 유지합니다 (/new로 새로 시작)."+ status_gateway_default: "🌐 브라우저: 게이트웨이 기본 브라우저 백엔드 (실시간 CDP 연결 없음)"heartbeat:label: "하트비트"paused: "⏸ 하트비트 일시 중지됨: {prompt}"diff --git a/locales/pt.yaml b/locales/pt.yamlindex a212aa90b50..f50e29e3c65 100644--- a/locales/pt.yaml+++ b/locales/pt.yaml@@ -3009,6 +3009,10 @@ cli:usage_disconnect: "disconnect Volta ao backend de navegador padrão"usage_status: "status Mostra o modo atual do navegador"usage_use: "use [off] Muda para o modo Browser Use (CLI 3.0) / volta às ferramentas integradas"+ remote_gateway: "/browser connect e /browser disconnect gerenciam um navegador Chromium no host do gateway — disponível apenas com um gateway local."+ checking: "Verificando a depuração remota do navegador Chromium em {url}..."+ new_sessions_only: "Aplica-se a novas sessões — esta mantém as ferramentas atuais (/new para iniciar uma)."+ status_gateway_default: "🌐 Navegador: backend de navegador padrão do gateway (sem conexão CDP ao vivo)"heartbeat:label: "Heartbeats"paused: "⏸ Heartbeat pausado: {prompt}"diff --git a/locales/ru.yaml b/locales/ru.yamlindex 25de05b911d..743a2f4b7db 100644--- a/locales/ru.yaml+++ b/locales/ru.yaml@@ -3009,6 +3009,10 @@ cli:usage_disconnect: "disconnect Вернуться к браузерному бэкенду по умолчанию"usage_status: "status Показать текущий режим браузера"usage_use: "use [off] Переключиться в режим Browser Use (CLI 3.0) / обратно к встроенным инструментам"+ remote_gateway: "/browser connect и /browser disconnect управляют браузером Chromium на хосте шлюза — доступно только при подключении к локальному шлюзу."+ checking: "Проверка удалённой отладки браузера Chromium по адресу {url}..."+ new_sessions_only: "Применяется к новым сеансам — этот сохраняет текущие инструменты (/new, чтобы начать новый)."+ status_gateway_default: "🌐 Браузер: стандартный браузер шлюза (нет активного CDP-подключения)"heartbeat:label: "Heartbeat"paused: "⏸ Heartbeat приостановлен: {prompt}"diff --git a/locales/tr.yaml b/locales/tr.yamlindex e6db1b005ed..71e5c870832 100644--- a/locales/tr.yaml+++ b/locales/tr.yaml@@ -3009,6 +3009,10 @@ cli:usage_disconnect: "disconnect Varsayılan tarayıcı arka ucuna geri döner"usage_status: "status Geçerli tarayıcı modunu gösterir"usage_use: "use [off] Browser Use moduna (CLI 3.0) geçer / yerleşik araçlara döner"+ remote_gateway: "/browser connect ve /browser disconnect ağ geçidi ana makinesindeki bir Chromium tarayıcısını yönetir — yalnızca yerel ağ geçidine bağlıyken kullanılabilir."+ checking: "{url} adresinde Chromium tarayıcısı uzaktan hata ayıklaması denetleniyor..."+ new_sessions_only: "Yeni oturumlara uygulanır — bu oturum mevcut araçlarını korur (/new ile yeni başlatın)."+ status_gateway_default: "🌐 Tarayıcı: ağ geçidinin varsayılan tarayıcı arka ucu (canlı CDP bağlantısı yok)"heartbeat:label: "Heartbeat'ler"paused: "⏸ Heartbeat duraklatıldı: {prompt}"diff --git a/locales/uk.yaml b/locales/uk.yamlindex 9499f92dec9..93af9de3b88 100644--- a/locales/uk.yaml+++ b/locales/uk.yaml@@ -3009,6 +3009,10 @@ cli:usage_disconnect: "disconnect Повернутися до бекенду браузера за замовчуванням"usage_status: "status Показати поточний режим браузера"usage_use: "use [off] Перемкнутися в режим Browser Use (CLI 3.0) / назад до вбудованих інструментів"+ remote_gateway: "/browser connect і /browser disconnect керують браузером Chromium на хості шлюзу — доступно лише з локальним шлюзом."+ checking: "Перевірка віддаленого налагодження браузера Chromium за адресою {url}..."+ new_sessions_only: "Застосовується до нових сеансів — цей зберігає поточні інструменти (/new, щоб почати новий)."+ status_gateway_default: "🌐 Браузер: типовий браузер шлюзу (немає активного CDP-з'єднання)"heartbeat:label: "Heartbeats"paused: "⏸ Heartbeat призупинено: {prompt}"diff --git a/locales/zh-hant.yaml b/locales/zh-hant.yamlindex b61dc017227..90b6e88cfb1 100644--- a/locales/zh-hant.yaml+++ b/locales/zh-hant.yaml@@ -3009,6 +3009,10 @@ cli:usage_disconnect: "disconnect 還原為預設瀏覽器後端"usage_status: "status 顯示目前的瀏覽器模式"usage_use: "use [off] 切換至 Browser Use 模式(CLI 3.0)/切回內建工具"+ remote_gateway: "/browser connect 與 /browser disconnect 管理閘道主機上的 Chromium 系瀏覽器 — 僅在連線至本機閘道時可用。"+ checking: "正在檢查 {url} 的 Chromium 系瀏覽器遠端偵錯..."+ new_sessions_only: "套用於新工作階段 — 此工作階段保留目前工具(/new 開始新的)。"+ status_gateway_default: "🌐 瀏覽器:閘道的預設瀏覽器後端(無即時 CDP 連線)"heartbeat:label: "心跳"paused: "⏸ 心跳已暫停:{prompt}"diff --git a/locales/zh.yaml b/locales/zh.yamlindex 8447f74c927..3ef33a65d88 100644--- a/locales/zh.yaml+++ b/locales/zh.yaml@@ -3009,6 +3009,10 @@ cli:usage_disconnect: "disconnect 恢复为默认浏览器后端"usage_status: "status 显示当前浏览器模式"usage_use: "use [off] 切换到 Browser Use 模式(CLI 3.0)/ 切回内置工具"+ remote_gateway: "/browser connect 和 /browser disconnect 管理网关主机上的 Chromium 系浏览器 — 仅在连接到本地网关时可用。"+ checking: "正在检查 {url} 的 Chromium 系浏览器远程调试..."+ new_sessions_only: "应用于新会话 — 此会话保留当前工具(/new 开始新的)。"+ status_gateway_default: "🌐 浏览器:网关的默认浏览器后端(无实时 CDP 连接)"heartbeat:label: "心跳"paused: "⏸ 心跳已暂停:{prompt}"diff --git a/tests/gateway/fixtures/browser_scope_peer.py b/tests/gateway/fixtures/browser_scope_peer.pyindex acf796fe5ec..a9c712472e2 100644--- a/tests/gateway/fixtures/browser_scope_peer.py+++ b/tests/gateway/fixtures/browser_scope_peer.py@@ -45,13 +45,26 @@ async def probe():ticket = mint_ticket(user_id='owner', provider='fixture')async with connect(api.api_origin.replace('http:', 'ws:') + '/api/ws?ticket=' + ticket) as ws:sid = (await rpc(ws, 'session.create', request_id='browser', source='tui', toolsets=[]))['result']['session_id']- for action, extra in [('connect', {'url': f'http://127.0.0.1:{cdp.server_port}'}),- ('disconnect', {}), ('status', {}), (None, {})]:- params = {'session_id': sid, **extra, **({'action': action} if action else {})}- reply = await rpc(ws, 'browser.manage', **params)- receipt[action or 'missing'] = {- 'code': reply.get('error', {}).get('code'), 'result': reply.get('result'),- 'cdp': os.environ.get('BROWSER_CDP_URL'), 'reaps': len(reaps)}+ # CLI-9: phase 1 serves ONE profile (its chats are all this profile's), phase 2 TWO.+ real = runner.session_authorities if hasattr(runner, 'session_authorities') else None+ for phase, serving in (('one', None), ('two', 2)):+ if serving:+ import types+ other = types.SimpleNamespace(profile_id=str(home / 'profiles' / 'bee'), retiring=False)+ runner.session_authorities = types.SimpleNamespace(+ serving=lambda: [runner.session_authority, other])+ os.environ['BROWSER_CDP_URL'] = 'http://127.0.0.1:9333' # another chat is driving this browser+ reaps.clear()+ for action, extra in [('connect', {'url': f'http://127.0.0.1:{cdp.server_port}'}),+ ('disconnect', {}), ('status', {}), (None, {})]:+ params = {'session_id': sid, **extra, **({'action': action} if action else {})}+ reply = await rpc(ws, 'browser.manage', **params)+ receipt[f"{phase}:{action or 'missing'}"] = {+ 'code': reply.get('error', {}).get('code'), 'result': reply.get('result'),+ 'message': reply.get('error', {}).get('message'),+ 'cdp': os.environ.get('BROWSER_CDP_URL'), 'reaps': len(reaps),+ 'cdp_port': cdp.server_port}+ runner.session_authorities = realfinally:cdp.shutdown()await stop_gateway_api(api)diff --git a/tests/gateway/test_browser_manage_shared_owner.py b/tests/gateway/test_browser_manage_shared_owner.pyindex 106b0b3e970..8b1e11ca910 100644--- a/tests/gateway/test_browser_manage_shared_owner.py+++ b/tests/gateway/test_browser_manage_shared_owner.py@@ -1,6 +1,8 @@-"""/browser connect|disconnect from one TUI or Desktop chat never rewrites the shared owner's-process-wide CDP endpoint or reaps other chats' browsers (dokterdok N25); /browser status and-/browser use still answer. One row per browser.manage action reaching the legacy fallback."""+"""/browser connect|disconnect through the real WS legacy fallback (dokterdok N25, #134889 CLI-9).++An owner serving ONE profile runs them: every chat on it is that profile's, and Ink, Desktop and the+classic CLI all send /browser here. An owner serving SEVERAL profiles refuses them by name, so a+browser one profile connects never reaches another profile's sessions; status still answers."""import jsonfrom pathlib import Pathimport subprocess@@ -29,12 +31,21 @@ def receipt(tmp_path_factory):return json.loads((home / 'receipt.json').read_text())[email protected]('action,refused', [- ('connect', True), ('disconnect', True), ('status', False), ('missing', False)])-def test_browser_manage_on_the_shared_owner_keeps_process_wide_cdp(receipt, action, refused):- row = receipt[action][email protected]('action', ['connect', 'disconnect', 'status', 'missing'])+def test_several_served_profiles_keep_the_process_wide_cdp(receipt, action):+ row = receipt['two:' + action]assert row['cdp'] == _OTHER_CHAT and row['reaps'] == 0, row # nothing process-wide changed- if refused:+ if action in ('connect', 'disconnect'):assert row['code'] == 4030 and row['result'] is None, row # refused in words, not -32601+ assert 'several profiles' in row['message'], rowelse:assert row['code'] is None and row['result']['url'] == _OTHER_CHAT, row+++def test_one_served_profile_connects_and_disconnects_the_gateways_browser(receipt):+ connect = receipt['one:connect']+ assert connect['code'] is None and connect['result']['connected'] is True, connect+ assert connect['cdp'] == f"http://127.0.0.1:{connect['cdp_port']}" and connect['reaps'] > 0, connect+ disconnect = receipt['one:disconnect']+ assert disconnect['code'] is None and disconnect['cdp'] is None, disconnect+ assert receipt['one:status']['result']['connected'] is Falsediff --git a/tests/hermes_cli/test_classic_browser_manage.py b/tests/hermes_cli/test_classic_browser_manage.pynew file mode 100644index 00000000000..272afc496a7--- /dev/null+++ b/tests/hermes_cli/test_classic_browser_manage.py@@ -0,0 +1,165 @@+"""CLI-9: the classic CLI's /browser goes to the gateway (``browser.manage``), like Ink and Desktop.++Browser tools run in the gateway, so a ``/browser connect`` that only rewrites the CLI process's+``BROWSER_CDP_URL`` changes nothing the agent uses. ``connect``/``disconnect`` follow Desktop's rule+(local gateway only); on a gateway serving several profiles they are refused by name, because the+live CDP endpoint is process-wide and must never reach another profile's sessions.+"""+import threading+import types+from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer+from types import SimpleNamespace++import pytest++from cli import HermesCLI+++class _Conn:+ closed = False+ final = False++ def __init__(self, replies):+ self.replies = replies+ self.calls = []++ def call(self, method, **params):+ self.calls.append((method, params))+ reply = self.replies.get(method, {})+ return reply(params) if callable(reply) else reply+++def gateway_cli(monkeypatch):+ def make(**replies):+ conn = _Conn(replies)+ monkeypatch.setattr("hermes_cli.gateway_side.connection_for", lambda cli: conn)+ cli = HermesCLI.__new__(HermesCLI)+ cli.session_id = "local-s"+ cli.agent = SimpleNamespace(_checkpoint_mgr=None)+ return cli, conn+ return make+++def _browser_calls(conn):+ return [params for method, params in conn.calls if method == "browser.manage"]+++def test_classic_browser_connect_is_the_gateways_browser_manage(gateway_cli, monkeypatch, capsys):+ monkeypatch.delenv("BROWSER_CDP_URL", raising=False)+ monkeypatch.delenv("HERMES_TUI_GATEWAY_URL", raising=False)+ cli, conn = gateway_cli(**{"browser.manage": lambda p: (+ {"connected": True, "url": p.get("url"), "messages": ["Chrome is already listening"]}+ if p["action"] == "connect" else {"connected": True, "url": "http://127.0.0.1:9333", "browser_use": False})})+ assert cli.process_command("/browser connect http://127.0.0.1:9333") is True+ assert _browser_calls(conn) == [{"action": "connect", "session_id": "local-s", "url": "http://127.0.0.1:9333"}]+ out = capsys.readouterr().out+ assert "Chrome is already listening" in out and "http://127.0.0.1:9333" in out+ import os+ assert "BROWSER_CDP_URL" not in os.environ # the CLI process is not where the tools run+ cli.process_command("/browser status")+ assert _browser_calls(conn)[-1] == {"action": "status", "session_id": "local-s"}+ assert "http://127.0.0.1:9333" in capsys.readouterr().out+ cli.process_command("/browser disconnect")+ assert _browser_calls(conn)[-1] == {"action": "disconnect", "session_id": "local-s"}+++def test_classic_browser_use_goes_to_the_gateway(gateway_cli, monkeypatch):+ cli, conn = gateway_cli(**{"browser.manage": {"connected": False, "browser_use": True}})+ monkeypatch.setattr(HermesCLI, "new_session", lambda self, *a, **k: None, raising=False)+ cli.process_command("/browser use off")+ assert _browser_calls(conn) == [{"action": "use", "session_id": "local-s", "enabled": False}]+++def test_classic_browser_connect_against_a_remote_gateway_is_refused(gateway_cli, monkeypatch, capsys):+ """Desktop's rule: connect/disconnect manage a browser on the gateway HOST."""+ monkeypatch.setenv("HERMES_TUI_GATEWAY_URL", "wss://gateway.example.com/api/ws")+ cli, conn = gateway_cli(**{"browser.manage": {"connected": False}})+ for line in ("/browser connect", "/browser disconnect"):+ cli.process_command(line)+ assert _browser_calls(conn) == []+ assert "local gateway" in capsys.readouterr().out+ cli.process_command("/browser status") # status is right on any backend+ assert _browser_calls(conn) == [{"action": "status", "session_id": "local-s"}]+++# --- the gateway side: browser.manage on a multiplexed owner -------------------------------------++class _Cdp(BaseHTTPRequestHandler):+ def do_GET(self):+ self.send_response(200)+ self.end_headers()+ self.wfile.write(b'{"webSocketDebuggerUrl": "ws://127.0.0.1/devtools/browser/x"}')++ def log_message(self, *args):+ pass+++def homes(tmp_path, monkeypatch):+ from tui_gateway import server+ launch = tmp_path / "root"+ bee = launch / "profiles" / "bee"+ bee.mkdir(parents=True)+ monkeypatch.setenv("HERMES_HOME", str(launch))+ monkeypatch.setattr(server, "_hermes_home", launch)+ monkeypatch.delenv("BROWSER_CDP_URL", raising=False)+ import tools.browser_tool_lifecycle as lifecycle+ reaps = []+ monkeypatch.setattr(lifecycle, "cleanup_all_browsers", lambda: reaps.append(1))+ cdp = ThreadingHTTPServer(("127.0.0.1", 0), _Cdp)+ threading.Thread(target=cdp.serve_forever, daemon=True).start()+ yield server, launch, bee, f"http://127.0.0.1:{cdp.server_port}", reaps+ cdp.shutdown()+++def _runner_serving(*names):+ authorities = [types.SimpleNamespace(profile_id=name, retiring=False) for name in names]+ return types.SimpleNamespace(session_authorities=types.SimpleNamespace(serving=lambda: authorities))+++def _call(server, profile_id, params):+ from gateway.runtime_bootstrap import _PURPOSE_CAPABILITIES+ from tui_gateway.ws_legacy_fallback import dispatch_legacy+ actor = types.SimpleNamespace(profile_id=str(profile_id),+ capabilities=frozenset(_PURPOSE_CAPABILITIES["interactive"]))+ written, done = [], threading.Event()+ transport = types.SimpleNamespace(write=lambda frame: written.append(frame) or done.set() or True)+ reply = dispatch_legacy(server, {"jsonrpc": "2.0", "id": 1, "method": "browser.manage", "params": params},+ transport, actor)+ return reply if reply is not None else (done.wait(10) and written[0])+++def test_a_browser_one_profile_connects_never_reaches_another_profiles_session(homes, monkeypatch):+ """Multiplexed owner: connect/disconnect from ANY profile are refused by name, so the+ process-wide CDP endpoint never changes under another profile's sessions; status still answers."""+ import os+ from gateway import run_api+ server, launch, bee, url, reaps = homes+ monkeypatch.setattr(run_api, "_ACTIVE_RUNNER", _runner_serving("default", "bee"))+ for home in (launch, bee):+ for action in ("connect", "disconnect"):+ reply = _call(server, home, {"action": action, "url": url})+ assert reply["error"]["code"] == 4030, reply+ assert "profile" in reply["error"]["message"], reply+ assert "BROWSER_CDP_URL" not in os.environ and reaps == []+ status = _call(server, bee, {"action": "status"})+ assert status["result"]["connected"] is False, status+++def test_single_profile_local_owner_connects_the_gateways_browser(homes, monkeypatch):+ """One profile: the gateway's browser tools are that profile's alone, so connect/disconnect run+ (what Ink, Desktop and now the classic CLI send)."""+ import os+ from gateway import run_api+ server, launch, _bee, url, reaps = homes+ # Multiplex mode is the default even with one profile: what counts is how many are SERVED.+ from agent import secret_scope+ monkeypatch.setattr(secret_scope, "is_multiplex_active", lambda: True)+ monkeypatch.setattr(run_api, "_ACTIVE_RUNNER", _runner_serving("default"))+ reply = _call(server, launch, {"action": "connect", "url": url})+ assert reply["result"]["connected"] is True, reply+ assert os.environ["BROWSER_CDP_URL"] == url and reaps+ assert _call(server, launch, {"action": "status"})["result"]["url"] == url+ assert _call(server, launch, {"action": "disconnect"})["result"]["connected"] is False+ assert "BROWSER_CDP_URL" not in os.environdiff --git a/tui_gateway/ws_legacy_fallback.py b/tui_gateway/ws_legacy_fallback.pyindex 491645aa55d..0cf6b14106f 100644--- a/tui_gateway/ws_legacy_fallback.py+++ b/tui_gateway/ws_legacy_fallback.py@@ -47,11 +47,29 @@ _PROCESS_GLOBAL = frozenset({"process.stop", "delegation.pause", "reload.mcp", "# Process-global ACTIONS of a verb whose other actions are fine on the shared owner (the gate above is# method-level, and refusing the whole verb turns its safe actions into the client's -32601 version-skew# notice). ``browser.manage`` connect/disconnect reap every task's browser and rewrite the process-wide-# ``BROWSER_CDP_URL`` that every chat's and served profile's browser tools read first (dokterdok N25);-# ``status`` and ``use`` (the profile's ``browser.backend``) stay. A missing action means ``status``.+# ``BROWSER_CDP_URL`` that every chat's browser tools read first (dokterdok N25); ``status`` and ``use``+# (the profile's ``browser.backend``) stay. A missing action means ``status``.+#+# CLI-9 (#134889): on an owner serving ONE profile those chats are all that profile's, so the live+# connect is the user's own choice and runs (Ink, Desktop and the classic CLI all send it here). On an+# owner serving several profiles it would reach another profile's sessions, and the browser state has+# no per-profile scope yet (``cleanup_all_browsers`` reaps every task's browser): refused by name._PROCESS_GLOBAL_ACTIONS = {"browser.manage": ({"connect", "disconnect"}, (- "/browser connect and /browser disconnect would switch the browser for every chat on this shared "- "gateway. Set browser.cdp_url in config.yaml instead, or use the classic CLI (hermes --cli)."))}+ "/browser connect and /browser disconnect are unavailable on a gateway serving several profiles: "+ "the live browser connection is shared by every profile's chats. Set browser.cdp_url in this "+ "profile's config.yaml instead."))}+++def _serves_several_profiles() -> bool:+ """Whether this owner serves more than one profile (the running gateway's authority registry);+ without a registered runner, whether the process multiplexes at all (fail closed)."""+ from gateway import run_api+ runner = getattr(run_api, "_ACTIVE_RUNNER", None)+ if runner is not None and getattr(runner, "session_authorities", None) is not None:+ from gateway.session_authorities import serving_authorities+ return len(serving_authorities(runner)) > 1+ from agent.secret_scope import is_multiplex_active+ return is_multiplex_active()def legacy_fallback_allowed(actor: Any, method: str) -> bool:@@ -142,7 +160,7 @@ def dispatch_legacy(server: Any, req: dict, transport: Any, actor: Any) -> dict"""Run ``server.dispatch`` with the ticket's profile home bound (call from a worker thread;the pool path copies this context, so long handlers see it too)."""actions, refusal = _PROCESS_GLOBAL_ACTIONS.get(req.get("method"), ((), ""))- if (req.get("params") or {}).get("action", "status") in actions:+ if (req.get("params") or {}).get("action", "status") in actions and _serves_several_profiles():return {"jsonrpc": "2.0", "id": req.get("id"), "error": {"code": 4030, "message": refusal}}try:home = _foreign_profile_home(server, getattr(actor, "profile_id", None))