oharness 0.7.0 → 0.8.0

package/extension/README.md

@@ -0,0 +1,58 @@
+# OHarness Browser Bridge
+
+Lets a local OHarness agent drive **your** browser — the one you are already
+signed into — instead of a browser of its own.
+
+Chrome has refused remote debugging on the default profile since version 136, so
+an extension is the only sanctioned way to reach a logged-in session. While
+anything is attached, Chrome shows its own "being debugged" banner. That
+disclosure is deliberate and is not suppressed.
+
+## Setup
+
+1. Register the native messaging host, which Chrome starts for the extension.
+   The desktop app does this every time it starts. With the npm package:
+
+   ```bash
+   oharness-browser-host install
+   ```
+
+2. `chrome://extensions` → turn on **Developer mode** → **Load unpacked** →
+   choose this `extension` directory. The `key` in `manifest.json` pins its id
+   to `ccflolhofpnacaokjapodnphjjgiddmi`, wherever it is loaded from, so step 1
+   needs no id.
+
+3. In OHarness, Settings → **Use your own browser**, or in your config:
+
+   ```json
+   { "browser": { "mode": "extension" } }
+   ```
+
+The toolbar icon shows the state: a number is how many tabs are being driven,
+`!` means the host cannot be reached. Its popup lists the driven tabs and can
+take all of them back at once.
+
+## What it does
+
+Nothing clever. It forwards Chrome DevTools Protocol messages between the
+harness and `chrome.debugger`, and answers the control messages CDP has no
+browser-level equivalent for: list tabs, open, activate or close a tab, attach,
+and detach. Every decision about what to do with a page is made in the harness.
+
+Several conversations can use it at once, from any number of OHarness
+processes — the desktop app, a web server, a terminal. Each conversation opens
+its own tabs, in a green tab group titled after it.
+A tab you already had open is only touched when a conversation is told to
+select it; listing your tabs attaches to none of them. The host keeps the
+processes' requests apart and sends each tab's events to whoever attached it.
+
+`chrome://`, `edge://`, `devtools://` and extension pages are never offered:
+Chrome refuses the debugger on them.
+
+If the host goes away (a rebuild, a crash) the extension reconnects on its own.
+
+## Giving it back
+
+Press **Stop controlling all tabs** in the popup, cancel the banner on a tab, or
+disable the extension. A harness that exits without detaching has its tabs
+detached for it.

package/extension/_locales/de/messages.json

@@ -0,0 +1,83 @@
+{
+  "popupTitle": {
+    "message": "OHarness Browser Bridge"
+  },
+  "state_driving": {
+    "message": "OHarness steuert diesen Browser"
+  },
+  "state_ready": {
+    "message": "Mit OHarness verbunden"
+  },
+  "state_waiting": {
+    "message": "Bereit"
+  },
+  "state_missing": {
+    "message": "OHarness nicht erreichbar"
+  },
+  "detailDriving": {
+    "message": "Steuert $1 Tab(s). Chrome zeigt auf jedem einen Hinweisbalken."
+  },
+  "detailReady": {
+    "message": "$1 OHarness-App(s) verbunden. Es wird nichts gesteuert."
+  },
+  "detailWaiting": {
+    "message": "Wartet darauf, dass eine OHarness-Unterhaltung den Browser nutzt."
+  },
+  "detailMissing": {
+    "message": "Der lokale OHarness-Host ist auf diesem Computer nicht eingerichtet."
+  },
+  "setupIntro": {
+    "message": "Zum Verbinden eine dieser Möglichkeiten ausführen, dann erneut versuchen:"
+  },
+  "setupDesktop": {
+    "message": "Die OHarness-Desktop-App einmal öffnen."
+  },
+  "setupCli": {
+    "message": "Oder mit dem npm-Paket ausführen:"
+  },
+  "retry": {
+    "message": "Erneut versuchen"
+  },
+  "controlledTabs": {
+    "message": "Gesteuerte Tabs"
+  },
+  "release": {
+    "message": "Steuerung aller Tabs beenden"
+  },
+  "bannerNote": {
+    "message": "Nur OHarness auf diesem Computer kann diese Erweiterung nutzen. Es wird nichts an andere Stellen gesendet."
+  },
+  "extDescription": {
+    "message": "Lässt einen lokalen OHarness-Agenten diesen Browser mit Ihren Anmeldungen steuern. Chrome zeigt dabei an, dass er debuggt wird."
+  },
+  "ungrouped": {
+    "message": "Eigene Tabs"
+  },
+  "openPanel": {
+    "message": "OHarness in der Seitenleiste öffnen"
+  },
+  "panelAdopt": {
+    "message": "Diesen Tab verwenden"
+  },
+  "panelAdoptHint": {
+    "message": "Diese Unterhaltung darf $1 verwenden. Vor Aktionen auf der Website wird gefragt."
+  },
+  "panelAdoptNone": {
+    "message": "Öffne eine Webseite, um sie OHarness zu übergeben."
+  },
+  "panelNoApp": {
+    "message": "OHarness ist nicht geöffnet"
+  },
+  "panelNoAppBody": {
+    "message": "Öffne die OHarness-Desktop-App oder führe oharness web aus, dann erscheint es hier."
+  },
+  "panelDesktop": {
+    "message": "Desktop-App"
+  },
+  "panelWeb": {
+    "message": "Web"
+  },
+  "panelHelp": {
+    "message": "So funktioniert die Erweiterung"
+  }
+}

package/extension/_locales/en/messages.json

@@ -0,0 +1,83 @@
+{
+  "popupTitle": {
+    "message": "OHarness Browser Bridge"
+  },
+  "state_driving": {
+    "message": "OHarness is driving this browser"
+  },
+  "state_ready": {
+    "message": "Connected to OHarness"
+  },
+  "state_waiting": {
+    "message": "Ready"
+  },
+  "state_missing": {
+    "message": "Can't reach OHarness"
+  },
+  "detailDriving": {
+    "message": "Controlling $1 tab(s). Chrome shows a banner on each one."
+  },
+  "detailReady": {
+    "message": "$1 OHarness app(s) connected. Nothing is being controlled."
+  },
+  "detailWaiting": {
+    "message": "Waiting for an OHarness conversation to use the browser."
+  },
+  "detailMissing": {
+    "message": "The local OHarness host isn't set up on this computer."
+  },
+  "setupIntro": {
+    "message": "To connect, do one of these, then retry:"
+  },
+  "setupDesktop": {
+    "message": "Open the OHarness desktop app once."
+  },
+  "setupCli": {
+    "message": "Or, with the npm package, run"
+  },
+  "retry": {
+    "message": "Retry"
+  },
+  "controlledTabs": {
+    "message": "Controlled tabs"
+  },
+  "release": {
+    "message": "Stop controlling all tabs"
+  },
+  "bannerNote": {
+    "message": "Only OHarness running on this computer can use this extension. Nothing is sent anywhere else."
+  },
+  "extDescription": {
+    "message": "Lets a local OHarness agent drive this browser, with your signed-in sessions, while Chrome shows it is being debugged."
+  },
+  "ungrouped": {
+    "message": "Your own tabs"
+  },
+  "openPanel": {
+    "message": "Open OHarness in the side panel"
+  },
+  "panelAdopt": {
+    "message": "Use this tab"
+  },
+  "panelAdoptHint": {
+    "message": "Let this conversation use $1. It asks before acting on the site."
+  },
+  "panelAdoptNone": {
+    "message": "Open a web page to hand it to OHarness."
+  },
+  "panelNoApp": {
+    "message": "OHarness isn't open"
+  },
+  "panelNoAppBody": {
+    "message": "Open the OHarness desktop app, or run oharness web, and it will appear here."
+  },
+  "panelDesktop": {
+    "message": "Desktop app"
+  },
+  "panelWeb": {
+    "message": "Web"
+  },
+  "panelHelp": {
+    "message": "How the extension works"
+  }
+}

package/extension/_locales/fr/messages.json

@@ -0,0 +1,83 @@
+{
+  "popupTitle": {
+    "message": "OHarness Browser Bridge"
+  },
+  "state_driving": {
+    "message": "OHarness pilote ce navigateur"
+  },
+  "state_ready": {
+    "message": "Connecté à OHarness"
+  },
+  "state_waiting": {
+    "message": "Prêt"
+  },
+  "state_missing": {
+    "message": "Impossible de joindre OHarness"
+  },
+  "detailDriving": {
+    "message": "$1 onglet(s) contrôlé(s). Chrome affiche un bandeau sur chacun."
+  },
+  "detailReady": {
+    "message": "$1 application(s) OHarness connectée(s). Aucun onglet n'est contrôlé."
+  },
+  "detailWaiting": {
+    "message": "En attente qu'une conversation OHarness utilise le navigateur."
+  },
+  "detailMissing": {
+    "message": "L'hôte local OHarness n'est pas configuré sur cet ordinateur."
+  },
+  "setupIntro": {
+    "message": "Pour vous connecter, effectuez l'une de ces actions, puis réessayez :"
+  },
+  "setupDesktop": {
+    "message": "Ouvrez une fois l'application de bureau OHarness."
+  },
+  "setupCli": {
+    "message": "Ou, avec le paquet npm, exécutez"
+  },
+  "retry": {
+    "message": "Réessayer"
+  },
+  "controlledTabs": {
+    "message": "Onglets contrôlés"
+  },
+  "release": {
+    "message": "Arrêter de contrôler tous les onglets"
+  },
+  "bannerNote": {
+    "message": "Seul OHarness exécuté sur cet ordinateur peut utiliser cette extension. Rien n'est envoyé ailleurs."
+  },
+  "extDescription": {
+    "message": "Permet à un agent OHarness local de piloter ce navigateur avec vos sessions ouvertes, pendant que Chrome signale le débogage."
+  },
+  "ungrouped": {
+    "message": "Vos propres onglets"
+  },
+  "openPanel": {
+    "message": "Ouvrir OHarness dans le panneau latéral"
+  },
+  "panelAdopt": {
+    "message": "Utiliser cet onglet"
+  },
+  "panelAdoptHint": {
+    "message": "Autoriser cette conversation à utiliser $1. Elle demandera avant d'agir sur le site."
+  },
+  "panelAdoptNone": {
+    "message": "Ouvrez une page web pour la confier à OHarness."
+  },
+  "panelNoApp": {
+    "message": "OHarness n'est pas ouvert"
+  },
+  "panelNoAppBody": {
+    "message": "Ouvrez l'application de bureau OHarness ou lancez oharness web, et il apparaîtra ici."
+  },
+  "panelDesktop": {
+    "message": "Application de bureau"
+  },
+  "panelWeb": {
+    "message": "Web"
+  },
+  "panelHelp": {
+    "message": "Fonctionnement de l'extension"
+  }
+}

package/extension/_locales/ja/messages.json

@@ -0,0 +1,83 @@
+{
+  "popupTitle": {
+    "message": "OHarness Browser Bridge"
+  },
+  "state_driving": {
+    "message": "OHarness がこのブラウザを操作しています"
+  },
+  "state_ready": {
+    "message": "OHarness に接続済み"
+  },
+  "state_waiting": {
+    "message": "準備完了"
+  },
+  "state_missing": {
+    "message": "OHarness に接続できません"
+  },
+  "detailDriving": {
+    "message": "$1 個のタブを操作中です。各タブに Chrome のバナーが表示されます。"
+  },
+  "detailReady": {
+    "message": "$1 個の OHarness アプリが接続中です。操作中のタブはありません。"
+  },
+  "detailWaiting": {
+    "message": "OHarness の会話がブラウザを使うのを待っています。"
+  },
+  "detailMissing": {
+    "message": "このパソコンに OHarness のローカルホストが設定されていません。"
+  },
+  "setupIntro": {
+    "message": "接続するには、次のいずれかを行ってから再試行してください："
+  },
+  "setupDesktop": {
+    "message": "OHarness デスクトップアプリを一度起動する。"
+  },
+  "setupCli": {
+    "message": "または npm パッケージで次を実行"
+  },
+  "retry": {
+    "message": "再試行"
+  },
+  "controlledTabs": {
+    "message": "操作中のタブ"
+  },
+  "release": {
+    "message": "すべてのタブの操作を停止"
+  },
+  "bannerNote": {
+    "message": "この拡張機能を使えるのは、このパソコンで動作する OHarness だけです。データが外部に送信されることはありません。"
+  },
+  "extDescription": {
+    "message": "ローカルの OHarness エージェントが、ログイン済みのこのブラウザを操作できるようにします。操作中は Chrome にデバッグ中と表示されます。"
+  },
+  "ungrouped": {
+    "message": "自分で開いたタブ"
+  },
+  "openPanel": {
+    "message": "サイドパネルで OHarness を開く"
+  },
+  "panelAdopt": {
+    "message": "このタブを使う"
+  },
+  "panelAdoptHint": {
+    "message": "この会話に $1 の使用を許可します。サイトで操作する前に確認します。"
+  },
+  "panelAdoptNone": {
+    "message": "OHarness に渡すには Web ページを開いてください。"
+  },
+  "panelNoApp": {
+    "message": "OHarness が開いていません"
+  },
+  "panelNoAppBody": {
+    "message": "OHarness デスクトップアプリを開くか、oharness web を実行するとここに表示されます。"
+  },
+  "panelDesktop": {
+    "message": "デスクトップアプリ"
+  },
+  "panelWeb": {
+    "message": "Web"
+  },
+  "panelHelp": {
+    "message": "拡張機能の仕組み"
+  }
+}

package/extension/_locales/ko/messages.json

@@ -0,0 +1,83 @@
+{
+  "popupTitle": {
+    "message": "OHarness Browser Bridge"
+  },
+  "state_driving": {
+    "message": "OHarness가 이 브라우저를 조작하고 있습니다"
+  },
+  "state_ready": {
+    "message": "OHarness에 연결됨"
+  },
+  "state_waiting": {
+    "message": "준비됨"
+  },
+  "state_missing": {
+    "message": "OHarness에 연결할 수 없음"
+  },
+  "detailDriving": {
+    "message": "탭 $1개를 제어하고 있습니다. 각 탭에 Chrome 배너가 표시됩니다."
+  },
+  "detailReady": {
+    "message": "OHarness 앱 $1개가 연결되어 있습니다. 제어 중인 탭은 없습니다."
+  },
+  "detailWaiting": {
+    "message": "OHarness 대화가 브라우저를 사용하기를 기다리는 중입니다."
+  },
+  "detailMissing": {
+    "message": "이 컴퓨터에 OHarness 로컬 호스트가 설정되어 있지 않습니다."
+  },
+  "setupIntro": {
+    "message": "연결하려면 다음 중 하나를 한 뒤 다시 시도하세요."
+  },
+  "setupDesktop": {
+    "message": "OHarness 데스크톱 앱을 한 번 실행합니다."
+  },
+  "setupCli": {
+    "message": "또는 npm 패키지로 다음 명령을 실행합니다"
+  },
+  "retry": {
+    "message": "다시 시도"
+  },
+  "controlledTabs": {
+    "message": "제어 중인 탭"
+  },
+  "release": {
+    "message": "모든 탭 제어 중지"
+  },
+  "bannerNote": {
+    "message": "이 확장 프로그램은 이 컴퓨터에서 실행 중인 OHarness만 사용할 수 있으며, 어떤 데이터도 외부로 전송하지 않습니다."
+  },
+  "extDescription": {
+    "message": "로컬 OHarness 에이전트가 로그인된 이 브라우저를 조작할 수 있게 합니다. 조작 중에는 Chrome에 디버깅 중임이 표시됩니다."
+  },
+  "ungrouped": {
+    "message": "직접 연 탭"
+  },
+  "openPanel": {
+    "message": "사이드 패널에서 OHarness 열기"
+  },
+  "panelAdopt": {
+    "message": "이 탭 사용"
+  },
+  "panelAdoptHint": {
+    "message": "이 대화가 $1을(를) 사용하도록 합니다. 사이트에서 작업하기 전에 확인합니다."
+  },
+  "panelAdoptNone": {
+    "message": "OHarness에 넘기려면 웹 페이지를 여세요."
+  },
+  "panelNoApp": {
+    "message": "OHarness가 열려 있지 않습니다"
+  },
+  "panelNoAppBody": {
+    "message": "OHarness 데스크톱 앱을 열거나 oharness web을 실행하면 여기에 표시됩니다."
+  },
+  "panelDesktop": {
+    "message": "데스크톱 앱"
+  },
+  "panelWeb": {
+    "message": "웹"
+  },
+  "panelHelp": {
+    "message": "확장 프로그램 작동 방식"
+  }
+}

package/extension/_locales/zh_CN/messages.json

@@ -0,0 +1,83 @@
+{
+  "popupTitle": {
+    "message": "OHarness 浏览器连接器"
+  },
+  "state_driving": {
+    "message": "OHarness 正在操作这个浏览器"
+  },
+  "state_ready": {
+    "message": "已连接 OHarness"
+  },
+  "state_waiting": {
+    "message": "已就绪"
+  },
+  "state_missing": {
+    "message": "无法连接 OHarness"
+  },
+  "detailDriving": {
+    "message": "正在控制 $1 个标签页，Chrome 会在每个页面顶部显示提示条。"
+  },
+  "detailReady": {
+    "message": "已有 $1 个 OHarness 应用连接，当前没有控制任何页面。"
+  },
+  "detailWaiting": {
+    "message": "等待 OHarness 对话调用浏览器。"
+  },
+  "detailMissing": {
+    "message": "这台电脑上还没有设置 OHarness 本地连接程序。"
+  },
+  "setupIntro": {
+    "message": "请完成以下任一步骤，然后重试："
+  },
+  "setupDesktop": {
+    "message": "打开一次 OHarness 桌面版。"
+  },
+  "setupCli": {
+    "message": "或者使用 npm 版时运行"
+  },
+  "retry": {
+    "message": "重试"
+  },
+  "controlledTabs": {
+    "message": "正在控制的标签页"
+  },
+  "release": {
+    "message": "停止控制所有标签页"
+  },
+  "bannerNote": {
+    "message": "只有这台电脑上运行的 OHarness 能使用此扩展，数据不会发送到其他地方。"
+  },
+  "extDescription": {
+    "message": "让本机的 OHarness agent 使用你已登录的浏览器会话操作网页，操作期间 Chrome 会显示调试提示。"
+  },
+  "ungrouped": {
+    "message": "你自己打开的标签页"
+  },
+  "openPanel": {
+    "message": "在侧边栏中打开 OHarness"
+  },
+  "panelAdopt": {
+    "message": "使用此标签页"
+  },
+  "panelAdoptHint": {
+    "message": "让这个对话使用 $1，在该网站上操作前会先征得你的同意。"
+  },
+  "panelAdoptNone": {
+    "message": "打开一个网页，才能交给 OHarness 使用。"
+  },
+  "panelNoApp": {
+    "message": "OHarness 没有打开"
+  },
+  "panelNoAppBody": {
+    "message": "打开 OHarness 桌面版，或运行 oharness web，它就会显示在这里。"
+  },
+  "panelDesktop": {
+    "message": "桌面版"
+  },
+  "panelWeb": {
+    "message": "网页版"
+  },
+  "panelHelp": {
+    "message": "了解这个扩展"
+  }
+}