feat(browser): replace the preview proxy with a real browser panel and an agent web tool (#2883)

The preview panel worked by proxying a dev server through OpenChamber's own
origin and rewriting the HTML that came back. Anything the rewriter did not
anticipate broke, and pages that refuse to be embedded never loaded at all.
This deletes the proxy (-1604 lines and its tests) and merges the preview and
browser panels into one surface backed by a real Chromium view.

What the panel is now

- A `<webview>` in its own session partition: logins and cookies persist, hot
  reload works because nothing is rewritten, DevTools are one click away.
- Annotation: pick one element, drag a region, or draw freehand, write a note,
  and it reaches chat with a screenshot of the visible page with the marks on it.
- Toolbar: hard reload, page zoom, device sizes, a light/dark switch that
  applies to the page rather than the app, and cookie/cache clearing scoped to
  the panel alone.
- Several pages at once, each tab showing the page's own favicon, and an address
  bar that suggests pages already visited in this project.
- Dev servers are listed from what is actually listening on the machine, checked
  against what a project announced, so a server is offered no matter how it was
  started. One that is still starting is waited for instead of failing.

Remote dev servers

The desktop app binds a local port and pipes raw bytes to the OpenChamber host
over the existing authenticated connection, so the page keeps its own origin at
the root of its own host. The reachable set is exactly what discovery reports
and is re-checked per connection, so an authenticated client cannot dial
arbitrary local services on the host. Links and redirects to another loopback
port stay on the machine that served the page. A tunnel that cannot be opened is
reported; it is never replaced by the plain loopback URL, which would answer
from the user's own machine under a remote address.

Agent control

Browser actions are a separate `openchamber_web` tool: open, snapshot, click,
type, scroll, inspect computed styles, resize between mobile/tablet/desktop, and
capture a screenshot into `.openchamber/screenshots/` in the project. The
existing `openchamber` tool keeps sessions, worktrees and scheduled tasks. Each
has its own setting in the new Settings -> General -> OpenChamber Tools section,
and the plugin is not injected at all when both are off.

Capability belongs to the connected client, not to configuration: a client
declares on its event stream that it can drive a page, which only a Chromium
host does. Exactly one client performs each request — it claims the request
before acting, and the first claim wins — because deciding by whose result
arrives first would be too late for a click that already happened. No client
listening is answered immediately with an explanation rather than a timeout.

Runtime boundaries

Web tabs get a plain iframe that can display a page but not inspect one. The
VS Code extension no longer offers the surface at all, since nothing that makes
the panel worth having works there. Mobile is unaffected.

Native boundary

Camera, microphone, location and device-picker requests from panel pages are
denied — Electron grants them by default when no handler is set, and the panel
loads whatever address the user types. Page capture, appearance emulation and
storage clearing verify that their target belongs to the panel's own session
instead of trusting a web-contents id from the renderer.

Persisted state

Stored `preview` tabs migrate to `browser` (v13 -> v14). Context panel tab
limits are now per surface, so filling one surface no longer evicts another's
tabs. Address history is stored per project and per runtime.

Documentation

`preview.mdx` and `desktop-browser.mdx` rewritten across all locales, the agent
tool settings path corrected, new `DOCUMENTATION.md` for the browser-control
broker and the dev tunnel, and the `ui-api-decoupling` skill updated where it
still described the deleted proxy.

packages/docs/content/docs/ja/agent-control-tool.mdx

@@ -28,7 +28,7 @@ description: エージェントがチャットから OpenChamber のセッショ
 
 ## ツールを有効または無効にする
 
-**設定 → 一般 → OpenCode CLI** を開き、**エージェント制御ツール**を変更して、**Save + Reload** を選択します。この設定は、管理対象の OpenCode サーバーが再起動した後に反映されます。
+**設定 → 一般 → OpenChamber ツール** を開き、**エージェント制御ツール**を変更します。この設定は、管理対象の OpenCode サーバーが再起動すると反映されます。再起動は OpenChamber が **Apply & Restart** として案内します。
 
 OpenChamber が `OPENCODE_HOST` または skip-start で外部 OpenCode サーバーに接続している場合や、VS Code 拡張機能内では、このツールを利用できません。OpenChamber が管理する OpenCode サーバーを使用するデスクトップ版と Web 版では自動的に利用できます。
 
@@ -37,3 +37,4 @@ OpenChamber が `OPENCODE_HOST` または skip-start で外部 OpenCode サー
 - [スケジュールタスク](/ja/scheduled-tasks/)
 - [Worktree セッション](/ja/worktrees/)
 - [セッションゴール](/ja/session-goals/)
+- [ブラウザパネル](/ja/desktop-browser/) — ページを見て操作するための OpenChamber Web ツール

packages/docs/content/docs/ja/desktop-browser.mdx

@@ -1,22 +1,53 @@
 ---
-title: デスクトップブラウザ
-description: デスクトップアプリ内で任意のページを開き、検査とコンソール取得を使います。
+title: ブラウザパネル
+description: アプリ内で任意のページを開き、注釈を付け、エージェントに操作させます。
 ---
 
-# デスクトップブラウザ
+# ブラウザパネル
 
-デスクトップアプリには組み込みブラウザがあります。チャットのすぐ横で任意のページを開き、要素を指して質問したり、ページのコンソールを取得したりできます。アプリヘッダーの地球儀ボタンから開きます。
+ブラウザパネルはチャットのすぐ隣に任意のページを開きます。ヘッダーの地球儀ボタンから開いてください。
 
-> デスクトップブラウザは**デスクトップ専用**機能です。Web では、[プレビュー](/preview/) パネルがローカル開発サーバー向けに同じ検査・コンソールツールを提供します。
+デスクトップアプリでは本物のブラウザです。ログイン状態は保持され、ホットリロードが動き、開発者ツールはワンクリックで開けます。ブラウザのタブでもページの表示はできますが、中を覗くことはできません。以下の注釈ツールはデスクトップ専用です。
 
-## 検査して注釈を付ける
+ここで開いたページは、カメラ・マイク・位置情報を使えません。これらの要求は拒否されます。
 
-**inspect** をオンにして、ページ上の任意の要素をクリックします。OpenChamber はその要素について、何であるか、スタイル、位置、スクリーンショットを含むメモを取得し、チャットメッセージに添付します。エージェントに「この要素、ここ」と伝える最短の方法です。
+## ツールバー
 
-## コンソール取得
+アドレスバーはこのプロジェクトで開いたページを覚えていて、入力中に候補として出します。アドレスの一部でもページタイトルの一部でも一致します。矢印キーで候補を移動し、Enter で選択中の候補を開き、行のボタンでその候補を消せます。
 
-ブラウザはページのコンソール出力（エラー、警告、ログ）を集めるので、開発者ツールを開かずにフィルターして読めます。
+隣には **再読み込み** があり、変更がどうしても反映されないときのためにキャッシュを無視する **強制再読み込み**、そしてページだけを拡大縮小するズーム操作も並びます。
+
+**Cookie を消去** と **キャッシュを消去** はこのパネルにだけ効きます。OpenChamber のセッションや他のウィンドウには影響しません。
+
+## ページに注釈を付ける
+
+**注釈** を押すと、ページの上に3つのツールを備えたバーが表示されます。
+
+- **要素** — 要素をクリックします。別の要素をクリックすると選択が移り、同じ要素をもう一度クリックすると解除されます。
+- **範囲** — 複数の要素にまたがる話をしたいときは、領域をドラッグで囲みます。
+- **描画** — ページの上にフリーハンドで描きます。
+
+印の隣に現れる入力欄に希望を書き、**添付** を押します。Enter でも送れます。チャットメッセージには、印を付けた内容、あなたのメモ、表示中のページに印を描き込んだスクリーンショットを含むカードが付きます。「このボタン、もう少し角を丸く」と言えば済み、場所を説明する必要はありません。
+
+ページ自体は変更されません。注釈はそこにあるものに印を付けるだけです。`Esc` で取り消してツールバーを閉じます。
+
+## エージェントに操作させる
+
+エージェントはブラウザパネルを自分で使えます。ページを開き、内容を読み、クリックし、文字を入力し、スクロールし、モバイル・タブレット・デスクトップのレイアウトを切り替えて、自分の作業をあなたに頼まず自分で確認します。その様子はパネルで見えます。
+
+エージェントがページ内で任意のコードを実行することはできません。ブラウザは実際のログイン状態を保持しているため、上記の操作に限定されています。
+
+見ている内容をプロジェクト内の `.openchamber/screenshots/` に画像として保存し、返答の中で見せることもできます。ビフォー・アフターができるのはこのためで、ファイルはその後もプルリクエストに添付できる形で残ります。
+
+ブラウザ操作は **OpenChamber Web ツール** で、**設定 → 一般 → OpenChamber ツール** から単独でオン・オフできます。
+
+これにはデスクトップアプリが必要です。ブラウザのタブに表示したページは操作できません。
+
+## 開発者ツール
+
+バーのターミナルボタンを押すと、そのページに対する Chromium 本来の開発者ツールが開きます。コンソール、ネットワーク、要素など、期待どおりのものがすべて使えます。
 
 ## 関連
 
-- [プレビューと開発サーバー](/preview/) — ローカル開発サーバー向けの同じツール
+- [プレビューと開発サーバー](/preview/) — リモートマシン上のものも含め、実行中のアプリを開く
+- [エージェント制御ツール](/ja/agent-control-tool/) — チャットからセッション・worktree・スケジュールタスクを扱う

packages/docs/content/docs/ja/preview.mdx

@@ -1,32 +1,35 @@
 ---
 title: プレビューと開発サーバー
-description: 実行中の開発サーバーを OpenChamber 内で開きます。
+description: 実行中の開発サーバーを OpenChamber の中で開きます。
 ---
 
 # プレビューと開発サーバー
 
-開発サーバーを起動すると、OpenChamber は別のブラウザタブではなくアプリ内で直接開けます。サイトをチャットの横で見ながら、コンソールを取得し、要素を指して質問できます。
+開発サーバーを起動すると、OpenChamber は別のブラウザタブではなくアプリ内でそれを開けます。チャットの隣にサイトを表示したまま、要素を指し示して質問できます。
 
-## プレビューを開く
+## 開発サーバーを開く
 
-OpenChamber はターミナル出力からローカルアドレスを監視します（Vite、Next.js、Astro などが表示する `Local:` 行）。見つけると次のことができます。
+ヘッダーの地球儀ボタンからブラウザパネルを開きます。開発サーバーがすでに動いていれば一覧に表示され、クリックひとつで開けます。OpenChamber はマシン上で実際に待ち受けているものから見つけるので、どうやって起動したかに関係なく機能します。
 
-- ターミナルに **Open preview** ボタンが表示されます
-- 自動オープンを有効にした [プロジェクトアクション](/project-actions/) が開きます
-- チャットメッセージ内のローカルリンクからも開けます
+次の場合にも開発サーバーは自動で開きます。
 
-サイトはサイドパネルに読み込まれます。プレビューできるのはローカルアドレス（あなたのマシン上）のみです。
+- ターミナルのローカルアドレスで **プレビューを開く** を押したとき
+- 自動オープンを有効にした[プロジェクトアクション](/project-actions/)が起動したとき
+- チャットメッセージ内のローカルリンクをたどったとき
 
-## コンソールと検査
+アドレスはいつでも自分で入力できます。`localhost:5173` のようにスキームを省いた入力は `http://` として扱われます。
 
-プレビューパネルでは次のことができます。
+## リモートの OpenChamber を使う場合
 
-- ページの **console** を見る — エラー、警告、ログを好きなようにフィルターできます
-- **inspect** をオンにし、任意の要素をクリックして、そのメモ（セレクター、スタイル、位置、スクリーンショット）をそのままチャットへ送る
+OpenChamber が別のマシンで動いているとき、開発サーバーも*そちら*のマシンにあります。手元のノートPCの `localhost` はまったく別の場所を指します。デスクトップアプリはこれを引き受けます。ローカルポートを開いてリモートの開発サーバーまで接続を通すので、ページは普通に読み込まれ、ホットリロードも開発者ツールも動きます。入力するアドレスは期待どおりのままで、裏側の仕組みが邪魔をすることはありません。
 
-これは「このボタン、ここ」とエージェントに伝える最速の方法です。
+これにはデスクトップアプリが必要です。ブラウザのタブでは、自分のマシン上の開発サーバーだけを開けます。
+
+## ページに注釈を付ける
+
+要素を指し示す、ページに描き込む、それらをまとめてチャットへ送る方法は[ブラウザパネル](/desktop-browser/)を参照してください。
 
 ## 関連
 
-- [プロジェクトアクション](/project-actions/) — サーバー起動時に自動で開く
-- [デスクトップブラウザ](/desktop-browser/) — デスクトップで任意のページに同じツールを使う
+- [プロジェクトアクション](/project-actions/) — 起動時にサーバーを自動で開く
+- [ブラウザパネル](/desktop-browser/) — ページへの注釈とエージェントによる操作