Skip to content

The agent that grows with you

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.py
new file mode 100644
index 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.py
index 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 or
None (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.yaml
index 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.yaml
index 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.yaml
index 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.yaml
index 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.yaml
index 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.yaml
index 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.yaml
index 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.yaml
index 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.yaml
index 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.yaml
index 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.yaml
index 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.yaml
index 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.yaml
index 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.yaml
index 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.yaml
index 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.yaml
index 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.yaml
index 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.py
index 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 = real
finally:
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.py
index 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 json
from pathlib import Path
import 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'], row
else:
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 False
diff --git a/tests/hermes_cli/test_classic_browser_manage.py b/tests/hermes_cli/test_classic_browser_manage.py
new file mode 100644
index 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.environ
diff --git a/tui_gateway/ws_legacy_fallback.py b/tui_gateway/ws_legacy_fallback.py
index 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))