deckide 3.5.42 → 3.5.43

package/README.md

@@ -64,6 +64,11 @@ deckide config                 全設定表示
 deckide config set <key> <val> 設定値変更
 deckide config get <key>       設定値取得
 deckide config reset           設定リセット
+
+deckide codeserver install     code-server（VS Code エディタ）を取得/インストール
+deckide codeserver status      code-server のインストール状態
+deckide codeserver path        code-server バイナリのパスを表示
+deckide codeserver uninstall   取得済み code-server を削除
 ```
 
 ### 起動オプション
@@ -167,6 +172,29 @@ ide/
 | `AGENT_BROWSER_FFMPEG` | ffmpeg 実行ファイル | PATH から自動検出 |
 | `AGENT_BROWSER_PACTL` | pactl 実行ファイル | PATH から自動検出 |
 | `AGENT_BROWSER_AUDIO_SOURCE` | 音声キャプチャ元 | 既定 sink の monitor source |
+| `AGENT_BROWSER_WEBRTC` | エージェントブラウザ映像を WebRTC 配信（`true`/`auto`/`false`、現状はオプトイン） | false |
+| `AGENT_BROWSER_WEBRTC_BITRATE` | WebRTC ビットレート（ffmpeg `-b:v` 形式） | 3M |
+| `AGENT_BROWSER_WEBRTC_FPS` | WebRTC フレームレート | 30 |
+| `AGENT_BROWSER_WEBRTC_ICE_SERVERS` | ICE サーバ（JSON配列）。空ならホスト候補のみ（同一ホスト/LAN） | — |
+| `AGENT_BROWSER_DISPLAY` | キャプチャする X ディスプレイ（未設定なら Chrome から自動検出） | — |
+| `AGENT_BROWSER_CDP_PORT` | 共有ブラウザの CDP ポート | 9222 |
+| `AGENT_BROWSER_REAP_MCP` | リークした chrome-devtools-mcp スタックを自動回収 | true |
+| `AGENT_BROWSER_MAX_MCP_PER_AGENT` | 1エージェントが保持できる MCP スタック上限（超過分の古いものを回収） | 3 |
+| `AGENT_BROWSER_MCP_IDLE_MS` | 回収対象とみなすアイドル閾値 (ms) | 600000 |
+| `DECKIDE_CODE_SERVER_BIN` | code-server バイナリ（未設定なら ~/.deckide → PATH → 初回自動DL） | — |
+| `DECKIDE_CODE_SERVER_VERSION` | 取得する code-server バージョン | 4.125.0 |
+
+## Deck Drive シェルと code-server
+
+既定の UI は **Deck Drive**（Google Drive 風のファイル/ワークスペース・ブラウザ）です。ファイルを開くと **code-server（ブラウザ版 VS Code）** が同一オリジンのリバースプロキシ（`/codeserver/:wsId/*`）越しに起動します。ターミナルデッキ・エージェントブラウザもタブとして同じシェルに統合されています。
+
+- **code-server の取得**: 初回利用時に固定版（`DECKIDE_CODE_SERVER_VERSION`、既定 4.125.0）を `~/.deckide/code-server` へ自動ダウンロードします。手動なら `deckide codeserver install`。
+- **拡張機能**: Microsoft マーケットプレイスは利用不可（Open VSX のみ）。Pylance/Copilot/Remote-* は使えません（Pyright 等で代替）。
+- **リソース**: code-server はワークスペース毎に1プロセス（目安 +1GB RAM / +2 コア）。アイドル20分で自動停止します。
+- **認証**: code-server は `--auth none` で起動し、Deck IDE の Basic 認証配下の同一オリジンプロキシで保護します。
+- **旧 UI**: 従来の Monaco/分割ターミナル・シェルは `?shell=legacy` で引き続き利用できます。
+
+> エージェントブラウザの WebRTC 配信（`AGENT_BROWSER_WEBRTC` / `?webrtc=1`）は実験的なオプトインです。既定は従来の JPEG ストリーミングです。音声トラックは PulseAudio がある環境でのみ動作します。
 
 ## MCP / OAuth
 

package/bin/deckide.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 import { fileURLToPath } from 'node:url';
 import path from 'node:path';
@@ -172,6 +172,11 @@ Usage:
   deckide config get <key>       Get a config value
   deckide config reset           Reset all settings
 
+  deckide codeserver install     Download/install code-server (the VS Code editor)
+  deckide codeserver status      Show code-server install status
+  deckide codeserver path        Print the code-server binary path
+  deckide codeserver uninstall   Remove the downloaded code-server
+
 Options (for start):
   -p, --port <port>              Port (default: 8787)
   --host <host>                  Host (default: 0.0.0.0)
@@ -338,6 +343,50 @@ if (command === 'auth') {
 }
 
 // ── deckide status ──
+// ── deckide codeserver ──
+if (command === 'codeserver') {
+  const sub = args[1] || 'status';
+  process.env.DECKIDE_DATA_DIR = dataDir;
+  const modPath = path.join(__dirname, '..', 'dist', 'utils', 'code-server.js');
+  let CodeServerService;
+  try {
+    ({ CodeServerService } = await import(modPath));
+  } catch (e) {
+    console.error(`code-server module not found — is Deck IDE built? (${e.message})`);
+    process.exit(1);
+  }
+  const cs = new CodeServerService(new Map());
+  if (sub === 'install') {
+    try {
+      const bin = await cs.download((m) => console.log(`  ${m}`));
+      console.log(`\x1b[32mInstalled\x1b[0m → ${bin}`);
+      process.exit(0);
+    } catch (e) {
+      console.error(`\x1b[31mInstall failed:\x1b[0m ${e.message}`);
+      process.exit(1);
+    }
+  } else if (sub === 'status') {
+    const s = await cs.getStatus();
+    console.log('code-server');
+    console.log(`  acquired: ${s.acquired}`);
+    console.log(`  binPath:  ${s.binPath || '(none)'}`);
+    if (s.reason) console.log(`  note:     ${s.reason}`);
+    process.exit(0);
+  } else if (sub === 'path') {
+    const bin = await cs.resolveBin();
+    if (bin) { console.log(bin); process.exit(0); }
+    console.error('code-server is not installed (run: deckide codeserver install)');
+    process.exit(1);
+  } else if (sub === 'uninstall') {
+    await cs.uninstall();
+    console.log('Uninstalled code-server.');
+    process.exit(0);
+  } else {
+    console.error('usage: deckide codeserver install|status|path|uninstall');
+    process.exit(1);
+  }
+}
+
 if (command === 'status') {
   const settings = loadSettings();
   const port = settings.port || 8787;

package/dist/routes/codeserver.js

@@ -71,6 +71,14 @@ export function createCodeServerRouter(codeServer) {
         }
         return c.json(await codeServer.getStatus(wsId || undefined));
     });
+    // Kick off the (single-flight) code-server download without blocking — the
+    // client polls /status until acquired. No-op if already installed.
+    router.post('/install', async (c) => {
+        if (!(await codeServer.isAcquired())) {
+            void codeServer.download().catch(() => undefined);
+        }
+        return c.json(await codeServer.getStatus());
+    });
     // Reverse-proxy everything else under /codeserver/:wsId/* to that workspace's
     // code-server instance (prefix stripped).
     router.all('/:wsId/*', (c) => proxy(c, codeServer));

package/dist/utils/agent-browser.js

@@ -480,6 +480,25 @@ export class AgentBrowserService {
         })
             .catch(() => undefined);
     }
+    // Pin the active tab's render viewport to a fixed size (the WebRTC framebuffer)
+    // so captured pixels equal page coordinates. Does not mutate this.viewport, so
+    // the JPEG path's client-driven resize is unaffected when WebRTC isn't active.
+    async pinViewport(width, height) {
+        await this.ensureActiveCdp();
+        if (!this.activeCdp) {
+            return;
+        }
+        await this.activeCdp
+            .send('Emulation.setDeviceMetricsOverride', {
+            width,
+            height,
+            deviceScaleFactor: 1,
+            mobile: false,
+            screenWidth: width,
+            screenHeight: height,
+        })
+            .catch(() => undefined);
+    }
     async navigate(input) {
         const url = normalizeBrowserUrl(input);
         await this.start();
@@ -623,6 +642,9 @@ export class AgentBrowserService {
                 this.port = null;
                 this.disconnectActiveCdp();
                 this.closeBrowserCdp();
+                // Tear down the WebRTC relay too, so a Chrome crash never leaves an
+                // orphaned x11grab/ffmpeg encoder pointed at a dead display.
+                void this.webrtcRelay.stop();
                 this.tabs.clear();
                 this.activeTargetId = null;
                 this.ready = false;

package/dist/utils/browser-webrtc.js

@@ -4,7 +4,7 @@ import fs from 'node:fs/promises';
 import path from 'node:path';
 import { promisify } from 'node:util';
 import { WebSocket } from 'ws';
-import { AGENT_BROWSER_WEBRTC, AGENT_BROWSER_WEBRTC_CODEC, AGENT_BROWSER_WEBRTC_BITRATE, AGENT_BROWSER_WEBRTC_FPS, AGENT_BROWSER_DISPLAY, AGENT_BROWSER_WEBRTC_ICE_SERVERS, } from '../config.js';
+import { AGENT_BROWSER_WEBRTC, AGENT_BROWSER_WEBRTC_CODEC, AGENT_BROWSER_WEBRTC_BITRATE, AGENT_BROWSER_WEBRTC_FPS, AGENT_BROWSER_DISPLAY, AGENT_BROWSER_WEBRTC_ICE_SERVERS, AGENT_BROWSER_CDP_PORT, } from '../config.js';
 const execFileAsync = promisify(execFile);
 let weriftPromise = null;
 function loadWerift() {
@@ -51,7 +51,7 @@ async function resolveExecutable(envName, names) {
 // picks the display number for the Chrome child and exports DISPLAY/XAUTHORITY
 // only into that child's environment, so the server process can't read them from
 // its own env — we recover them from /proc/<pid>/environ instead.
-async function resolveXEnv() {
+async function resolveXEnv(cdpPort) {
     if (AGENT_BROWSER_DISPLAY) {
         return { display: AGENT_BROWSER_DISPLAY, xauthority: process.env.XAUTHORITY ?? null };
     }
@@ -63,6 +63,8 @@ async function resolveXEnv() {
         // Not Linux / no procfs.
         return process.env.DISPLAY ? { display: process.env.DISPLAY, xauthority: process.env.XAUTHORITY ?? null } : null;
     }
+    const portToken = cdpPort ? `--remote-debugging-port=${cdpPort}` : null;
+    let fallback = null;
     for (const pid of pids) {
         let comm = '';
         try {
@@ -87,9 +89,27 @@ async function resolveXEnv() {
             continue;
         }
         const xauthority = vars.find((v) => v.startsWith('XAUTHORITY='))?.slice('XAUTHORITY='.length) ?? null;
-        return { display, xauthority };
+        const candidate = { display, xauthority };
+        if (!portToken) {
+            return candidate;
+        }
+        // With multiple Chrome instances, prefer the one bound to OUR CDP port so we
+        // capture (and control) the same browser. Fall back to the first found.
+        let cmdline = '';
+        try {
+            cmdline = (await fs.readFile(`/proc/${pid}/cmdline`, 'utf8')).replace(/\0/g, ' ');
+        }
+        catch {
+            // ignore
+        }
+        if (cmdline.includes(portToken)) {
+            return candidate;
+        }
+        if (!fallback) {
+            fallback = candidate;
+        }
     }
-    return process.env.DISPLAY ? { display: process.env.DISPLAY, xauthority: process.env.XAUTHORITY ?? null } : null;
+    return fallback ?? (process.env.DISPLAY ? { display: process.env.DISPLAY, xauthority: process.env.XAUTHORITY ?? null } : null);
 }
 // Query the real screen geometry of the display so x11grab captures the exact
 // region (a mismatch makes ffmpeg error or grab garbage).
@@ -145,7 +165,7 @@ export class BrowserWebRtcRelay {
         else {
             const werift = await loadWerift();
             const ffmpeg = await resolveExecutable('AGENT_BROWSER_FFMPEG', ['ffmpeg']);
-            const xenv = await resolveXEnv();
+            const xenv = await resolveXEnv(AGENT_BROWSER_CDP_PORT);
             if (!werift) {
                 available = false;
                 reason = 'werift is not installed (npm install werift)';
@@ -298,7 +318,7 @@ export class BrowserWebRtcRelay {
         if (!ffmpeg) {
             throw new Error('ffmpeg is required for WebRTC streaming');
         }
-        const xenv = await resolveXEnv();
+        const xenv = await resolveXEnv(AGENT_BROWSER_CDP_PORT);
         if (!xenv) {
             throw new Error('No X display found to capture');
         }
@@ -311,6 +331,8 @@ export class BrowserWebRtcRelay {
         // Size the page's OS window to fill the captured screen so the framebuffer
         // region maps 1:1 to page coordinates. Best-effort; ignore failures.
         await this.host.setActiveWindowBounds(0, 0, this.size.width, this.size.height).catch(() => undefined);
+        // Pin the page render size to the framebuffer so input coords map 1:1.
+        await this.host.pinViewport(this.size.width, this.size.height).catch(() => undefined);
         // Bind an ephemeral UDP port; ffmpeg sends RTP here and we fan each packet
         // out to every viewer's track (no re-encode in werift).
         const udp = dgram.createSocket('udp4');

package/dist/utils/code-server.js

@@ -1,4 +1,5 @@
-import { spawn } from 'node:child_process';
+import { spawn, execFile } from 'node:child_process';
+import { promisify } from 'node:util';
 import net from 'node:net';
 import fs from 'node:fs/promises';
 import path from 'node:path';
@@ -6,6 +7,9 @@ import { dataDir } from '../config.js';
 const IDLE_TIMEOUT_MS = 20 * 60 * 1000;
 const START_TIMEOUT_MS = 30_000;
 const REAP_INTERVAL_MS = 60_000;
+// Pinned code-server version for reproducible auto-download.
+const CODE_SERVER_VERSION = process.env.DECKIDE_CODE_SERVER_VERSION || '4.125.0';
+const execFileAsync = promisify(execFile);
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -49,6 +53,9 @@ export class CodeServerService {
     workspaces;
     instances = new Map();
     reaper = null;
+    // Single-flight auto-download of the code-server binary.
+    downloadPromise = null;
+    downloading = false;
     // Directory layout under ~/.deckide/code-server (set by config.dataDir).
     root = path.join(dataDir, 'code-server');
     constructor(workspaces) {
@@ -70,6 +77,62 @@ export class CodeServerService {
     async isAcquired() {
         return (await this.resolveBin()) !== null;
     }
+    // Download + install the pinned code-server build into dataDir (single-flight).
+    // Returns the resolved binary path. Auto-invoked by ensure() when not present.
+    download(onLog) {
+        if (this.downloadPromise) {
+            return this.downloadPromise;
+        }
+        this.downloading = true;
+        this.downloadPromise = this.doDownload(onLog).finally(() => {
+            this.downloading = false;
+            this.downloadPromise = null;
+        });
+        return this.downloadPromise;
+    }
+    async doDownload(onLog) {
+        const version = CODE_SERVER_VERSION;
+        const os = process.platform === 'darwin' ? 'macos' : process.platform === 'linux' ? 'linux' : null;
+        if (!os) {
+            throw new Error(`Automatic code-server download is unsupported on ${process.platform}. Install code-server manually and set DECKIDE_CODE_SERVER_BIN.`);
+        }
+        const arch = process.arch === 'arm64' ? 'arm64' : process.arch === 'x64' ? 'amd64' : null;
+        if (!arch) {
+            throw new Error(`Automatic code-server download is unsupported on architecture ${process.arch}.`);
+        }
+        const name = `code-server-${version}-${os}-${arch}`;
+        const url = `https://github.com/coder/code-server/releases/download/v${version}/${name}.tar.gz`;
+        const libDir = path.join(this.root, 'lib');
+        const tarPath = path.join(this.root, `${name}.tar.gz`);
+        await fs.mkdir(libDir, { recursive: true });
+        const log = (m) => { onLog?.(m); console.log(`[code-server] ${m}`); };
+        log(`downloading ${url}`);
+        const res = await fetch(url, { redirect: 'follow' });
+        if (!res.ok) {
+            throw new Error(`code-server download failed: HTTP ${res.status}`);
+        }
+        const bytes = Buffer.from(await res.arrayBuffer());
+        await fs.writeFile(tarPath, bytes);
+        log(`extracting ${(bytes.length / 1024 / 1024).toFixed(0)}MB`);
+        await execFileAsync('tar', ['-xzf', tarPath, '-C', libDir]);
+        await fs.rm(tarPath, { force: true });
+        const innerBin = path.join(libDir, name, 'bin', 'code-server');
+        if (!(await pathExists(innerBin))) {
+            throw new Error('code-server binary not found after extraction');
+        }
+        const binDir = path.join(this.root, 'bin');
+        await fs.mkdir(binDir, { recursive: true });
+        const link = path.join(binDir, 'code-server');
+        await fs.rm(link, { force: true });
+        await fs.symlink(innerBin, link);
+        log('installed');
+        return link;
+    }
+    // Remove the downloaded code-server install (and its per-workspace data).
+    async uninstall() {
+        await this.stopAll();
+        await fs.rm(this.root, { recursive: true, force: true });
+    }
     async getStatus(wsId) {
         const bin = await this.resolveBin();
         const instance = wsId ? this.instances.get(wsId) : undefined;
@@ -79,8 +142,13 @@ export class CodeServerService {
             binPath: bin,
             running: instance ? instance.proc.exitCode == null : false,
             instances: this.instances.size,
+            downloading: this.downloading,
             wsId: wsId ?? null,
-            reason: bin ? undefined : 'code-server is not installed (run: deckide codeserver install)',
+            reason: bin
+                ? undefined
+                : this.downloading
+                    ? 'code-server is downloading…'
+                    : 'code-server will be downloaded automatically on first use',
             error: instance?.error,
         };
     }
@@ -99,9 +167,10 @@ export class CodeServerService {
         if (!workspace) {
             throw new Error(`Unknown workspace: ${wsId}`);
         }
-        const bin = await this.resolveBin();
+        let bin = await this.resolveBin();
         if (!bin) {
-            throw new Error('code-server is not installed (run: deckide codeserver install)');
+            // Auto-acquire on first use (single-flight ~100MB download).
+            bin = await this.download();
         }
         const port = await getFreePort();
         const userDataDir = path.join(this.root, 'user', wsId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deckide",
-  "version": "3.5.42",
+  "version": "3.5.43",
   "description": "Deck IDE - Browser-based IDE with terminal, file explorer, and git integration",
   "type": "module",
   "bin": {