@sanqianx/claude-ai-workbench 0.13.2 → 0.13.3

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claude-ai-workbench/core",
-  "version": "0.13.2",
+  "version": "0.13.3",
   "type": "commonjs",
   "main": "index.js",
   "browser": "index.js",
@@ -20,7 +20,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@claude-ai-workbench/contracts": "0.13.2"
+    "@claude-ai-workbench/contracts": "0.13.3"
   },
   "engines": {
     "node": ">=18"

package/packages/server/README.md

@@ -1,17 +1,17 @@
-# @claude-ai-workbench/server
-
-版本化 REST/SSE Server SDK，同时提供 `claude-workbench-server` 命令。
-
-```js
-const { createWorkbenchServer } = require("@claude-ai-workbench/server");
-const app = createWorkbenchServer({ dataDir: "./workbench-data", serveHost: false });
-app.server.listen(5760, "127.0.0.1");
-```
-
-命令行启动：
-
-```bash
-claude-workbench-server
-```
-
-默认只应监听本机地址。若要跨机器部署，应在外层增加 HTTPS、身份认证和访问控制。
+# @claude-ai-workbench/server
+
+版本化 REST/SSE Server SDK，同时提供 `claude-workbench-server` 命令。
+
+```js
+const { createWorkbenchServer } = require("@claude-ai-workbench/server");
+const app = createWorkbenchServer({ dataDir: "./workbench-data", serveHost: false });
+app.server.listen(5760, "127.0.0.1");
+```
+
+命令行启动：
+
+```bash
+claude-workbench-server
+```
+
+默认只应监听本机地址。若要跨机器部署，应在外层增加 HTTPS、身份认证和访问控制。

package/packages/server/bin/agent-terminal-server.js

@@ -1,42 +1,42 @@
-#!/usr/bin/env node
-'use strict';
-// Standalone Agent Terminal entry point. Fresh data directory (~/.agent-terminal
-// by default, AGENT_TERMINAL_DATA_DIR overrides) so the terminal product starts
-// independently from any legacy workbench data.
-const os = require('os');
-const path = require('path');
-const fs = require('fs');
-const { createWorkbenchServer } = require('..');
-const { warmFolderPicker } = require('../lib/folder-picker');
-
-const port = Number(process.env.AGENT_TERMINAL_PORT || process.env.CLAUDE_WORKBENCH_PORT || 5760);
-const host = process.env.AGENT_TERMINAL_HOST || '127.0.0.1';
-const dataDir = process.env.AGENT_TERMINAL_DATA_DIR || path.join(os.homedir(), '.agent-terminal');
-fs.mkdirSync(dataDir, { recursive: true });
-// The agent-session runner resolves its own store through these env vars;
-// without them it falls back to the legacy ~/.claude-ai-workbench layout.
-process.env.CLAUDE_AI_WORKBENCH_DATA_DIR = dataDir;
-process.env.KB_DATA_DIR = dataDir;
-
-
-const app = createWorkbenchServer({ dataDir });
-app.server.listen(port, host, () => {
-  process.stdout.write(`Agent Terminal listening at http://${host}:${port}/agent-terminal/ (data: ${dataDir})\n`);
-  // Compile the folder-picker helper up front so the first "browse…" click
-  // pops the dialog in milliseconds instead of paying the powershell +
-  // Add-Type startup. Never blocks or crashes the server.
-  if (process.env.KB_WORKBENCH_DISABLE_PICKER !== '1') warmFolderPicker({ title: '选择项目文件夹' }).catch(() => {});
-});
-
-let stopping = false;
-async function shutdown() {
-  if (stopping) return; stopping = true;
-  setTimeout(() => process.exit(1), 10000).unref();
-  try { await app.service.destroy(); }
-  catch { process.stderr.write('SHUTDOWN_FAILED: 客户端运行环境未能完整关闭。\n'); process.exitCode = 1; }
-  app.server.closeAllConnections?.();
-  app.server.close(() => process.exit(process.exitCode || 0));
-}
-process.on('SIGINT', shutdown);
-process.on('SIGTERM', shutdown);
-process.on('message', message => { if (message?.type === 'kb:shutdown') shutdown(); });
+#!/usr/bin/env node
+'use strict';
+// Standalone Agent Terminal entry point. Fresh data directory (~/.agent-terminal
+// by default, AGENT_TERMINAL_DATA_DIR overrides) so the terminal product starts
+// independently from any legacy workbench data.
+const os = require('os');
+const path = require('path');
+const fs = require('fs');
+const { createWorkbenchServer } = require('..');
+const { warmFolderPicker } = require('../lib/folder-picker');
+
+const port = Number(process.env.AGENT_TERMINAL_PORT || process.env.CLAUDE_WORKBENCH_PORT || 5760);
+const host = process.env.AGENT_TERMINAL_HOST || '127.0.0.1';
+const dataDir = process.env.AGENT_TERMINAL_DATA_DIR || path.join(os.homedir(), '.agent-terminal');
+fs.mkdirSync(dataDir, { recursive: true });
+// The agent-session runner resolves its own store through these env vars;
+// without them it falls back to the legacy ~/.claude-ai-workbench layout.
+process.env.CLAUDE_AI_WORKBENCH_DATA_DIR = dataDir;
+process.env.KB_DATA_DIR = dataDir;
+
+
+const app = createWorkbenchServer({ dataDir });
+app.server.listen(port, host, () => {
+  process.stdout.write(`Agent Terminal listening at http://${host}:${port}/agent-terminal/ (data: ${dataDir})\n`);
+  // Compile the folder-picker helper up front so the first "browse…" click
+  // pops the dialog in milliseconds instead of paying the powershell +
+  // Add-Type startup. Never blocks or crashes the server.
+  if (process.env.KB_WORKBENCH_DISABLE_PICKER !== '1') warmFolderPicker({ title: '选择项目文件夹' }).catch(() => {});
+});
+
+let stopping = false;
+async function shutdown() {
+  if (stopping) return; stopping = true;
+  setTimeout(() => process.exit(1), 10000).unref();
+  try { await app.service.destroy(); }
+  catch { process.stderr.write('SHUTDOWN_FAILED: 客户端运行环境未能完整关闭。\n'); process.exitCode = 1; }
+  app.server.closeAllConnections?.();
+  app.server.close(() => process.exit(process.exitCode || 0));
+}
+process.on('SIGINT', shutdown);
+process.on('SIGTERM', shutdown);
+process.on('message', message => { if (message?.type === 'kb:shutdown') shutdown(); });

package/packages/server/bin/claude-workbench.js

@@ -1,225 +1,225 @@
-#!/usr/bin/env node
-'use strict';
-
-// Standalone CLI for the published claude-ai-workbench package:
-//   claude-workbench                start the server in the foreground
-//   claude-workbench start [-d]     start in the foreground, detached with -d
-//   claude-workbench stop           stop the running instance
-//   claude-workbench status         report whether an instance is running
-//   claude-workbench -v             print the package version
-// Wired up via the package.json bin field, so a global `npm i -g
-// claude-ai-workbench` puts the `claude-workbench` command on PATH.
-
-const { execFileSync, spawn } = require('child_process');
-const fs = require('fs');
-const net = require('net');
-const os = require('os');
-const path = require('path');
-
-const pkg = require(path.join(__dirname, '..', '..', '..', 'package.json'));
-// The standalone product is the Agent Terminal: current dark UI, its own
-// clean data directory — not the legacy workbench data at ~/.claude-ai-workbench.
-const serverScript = path.join(__dirname, 'agent-terminal-server.js');
-const DEFAULT_PORT = 5760;
-
-function dataDir() {
-  return path.resolve(process.env.AGENT_TERMINAL_DATA_DIR || path.join(os.homedir(), '.agent-terminal'));
-}
-function pidFile() {
-  return path.join(dataDir(), 'server.pid');
-}
-function port() {
-  return Number(process.env.AGENT_TERMINAL_PORT || process.env.CLAUDE_WORKBENCH_PORT || DEFAULT_PORT);
-}
-function listenUrl() {
-  const host = process.env.AGENT_TERMINAL_HOST || process.env.CLAUDE_WORKBENCH_HOST || '127.0.0.1';
-  return `http://${host}:${port()}/agent-terminal/`;
-}
-
-function writePid(pid) {
-  fs.mkdirSync(dataDir(), { recursive: true });
-  fs.writeFileSync(pidFile(), String(pid), 'utf8');
-}
-function readPid() {
-  try {
-    const pid = Number(fs.readFileSync(pidFile(), 'utf8').trim());
-    return Number.isInteger(pid) && pid > 0 ? pid : null;
-  } catch {
-    return null;
-  }
-}
-function clearPid() {
-  try { fs.unlinkSync(pidFile()); } catch { /* already gone */ }
-}
-
-function alive(pid) {
-  if (process.platform === 'win32') {
-    try {
-      const out = execFileSync('tasklist', ['/FI', `PID eq ${pid}`, '/FO', 'CSV', '/NH'], {
-        encoding: 'utf8', windowsHide: true, timeout: 10000,
-      });
-      return out.includes(`"${pid}"`);
-    } catch {
-      return false;
-    }
-  }
-  try { process.kill(pid, 0); return true; } catch { return false; }
-}
-
-function killPid(pid) {
-  if (process.platform === 'win32') {
-    execFileSync('taskkill', ['/pid', String(pid), '/T', '/F'], { windowsHide: true, stdio: 'ignore', timeout: 15000 });
-    return;
-  }
-  process.kill(pid, 'SIGTERM');
-}
-
-// Fallback for instances started without this CLI (raw bin script, lost data
-// dir): whoever is LISTENING on the workbench port is the instance.
-function pidsListeningOnPort(portNum) {
-  let out = '';
-  try {
-    out = execFileSync('netstat', ['-ano'], {
-      encoding: 'utf8', windowsHide: true, timeout: 15000, maxBuffer: 16 * 1024 * 1024,
-    });
-  } catch {
-    return [];
-  }
-  const pids = new Set();
-  for (const line of out.split(/\r?\n/)) {
-    if (!/LISTENING/i.test(line)) continue;
-    const columns = line.trim().split(/\s+/);
-    if (!String(columns[1] || '').endsWith(`:${portNum}`)) continue;
-    const pid = Number(columns[columns.length - 1]);
-    if (Number.isInteger(pid) && pid > 0) pids.add(pid);
-  }
-  return [...pids];
-}
-
-function stopTargets() {
-  const pid = readPid();
-  if (pid && alive(pid)) return [pid];
-  return pidsListeningOnPort(port());
-}
-
-// True when something already listens on the workbench port. Checked before
-// every start so a busy port surfaces as guidance instead of the server's
-// raw EADDRINUSE stack trace.
-function probePortInUse(portNum, host) {
-  return new Promise((resolve) => {
-    const server = net.createServer();
-    server.once('error', () => resolve(true));
-    server.once('listening', () => server.close(() => resolve(false)));
-    server.listen(portNum, host);
-  });
-}
-
-async function cmdStart(argv) {
-  const daemon = argv.includes('-d') || argv.includes('--daemon');
-  const existing = readPid();
-  if (existing && alive(existing)) {
-    process.stdout.write(`claude-workbench is already running (pid ${existing}) at ${listenUrl()}\n`);
-    return 0;
-  }
-  const host = process.env.CLAUDE_WORKBENCH_HOST || '127.0.0.1';
-  if (await probePortInUse(port(), host)) {
-    const holders = pidsListeningOnPort(port());
-    process.stderr.write(
-      `port ${port()} is already in use${holders.length ? ` (pid ${holders.join(', ')})` : ''} — `
-      + `another instance may be running there.\n`
-      + `Try: claude-workbench stop, or pick another port via CLAUDE_WORKBENCH_PORT.\n`);
-    return 1;
-  }
-  if (daemon) {
-    const child = spawn(process.execPath, [serverScript], { detached: true, stdio: 'ignore', windowsHide: true });
-    child.unref();
-    writePid(child.pid);
-    process.stdout.write(`claude-workbench ${pkg.version} started in the background (pid ${child.pid}) at ${listenUrl()}\n`);
-    return 0;
-  }
-  writePid(process.pid);
-  process.on('exit', clearPid);
-  process.stderr.write(`claude-workbench ${pkg.version} starting at ${listenUrl()} (Ctrl+C stops)\n`);
-  require(serverScript); // constructs and listens in-process; owns the lifetime
-  return null;
-}
-
-function cmdStop() {
-  const targets = stopTargets();
-  if (!targets.length) {
-    clearPid(); // stale pid file from a crashed instance
-    process.stdout.write(`claude-workbench is not running (port ${port()})\n`);
-    return 1;
-  }
-  let failed = false;
-  for (const pid of targets) {
-    try {
-      killPid(pid);
-      process.stdout.write(`stopped pid ${pid}\n`);
-    } catch (error) {
-      failed = true;
-      process.stderr.write(`failed to stop pid ${pid}: ${error.message}\n`);
-    }
-  }
-  clearPid();
-  return failed ? 1 : 0;
-}
-
-function cmdStatus() {
-  const pid = readPid();
-  if (pid && alive(pid)) {
-    process.stdout.write(`claude-workbench is running (pid ${pid}) at ${listenUrl()}\n`);
-    return 0;
-  }
-  const portPids = pidsListeningOnPort(port());
-  if (portPids.length) {
-    process.stdout.write(`claude-workbench is running without a pid file (pid ${portPids.join(', ')}) at ${listenUrl()}\n`);
-    return 0;
-  }
-  clearPid();
-  process.stdout.write(`claude-workbench is not running\n`);
-  return 1;
-}
-
-function cmdVersion() {
-  process.stdout.write(`${pkg.version}\n`);
-  return 0;
-}
-
-function help() {
-  return [
-    `claude-ai-workbench ${pkg.version} — local workbench server for Claude Code, Codex, OpenCode`,
-    '',
-    'usage: claude-workbench [command]',
-    '',
-    'commands:',
-    '  start [-d|--daemon]   start the server (foreground by default, background with -d)',
-    '  stop                  stop the running server',
-    '  status                show whether the server is running',
-    '  -v | --version        print the version',
-    '  -h | --help           show this help',
-    '',
-    'environment:',
-    `  AGENT_TERMINAL_PORT            port to listen on (default ${DEFAULT_PORT}; CLAUDE_WORKBENCH_PORT also honored)`,
-    '  AGENT_TERMINAL_HOST            bind address (default 127.0.0.1)',
-    '  AGENT_TERMINAL_DATA_DIR        data directory (default ~/.agent-terminal)',
-  ].join('\n');
-}
-
-async function main(argv) {
-  const command = argv[0];
-  if (command === undefined || command === 'start') return cmdStart(argv.slice(1));
-  if (command === 'stop') return cmdStop();
-  if (command === 'status') return cmdStatus();
-  if (command === 'version' || command === '-v' || command === '--version') return cmdVersion();
-  if (command === '-h' || command === '--help' || command === 'help') {
-    process.stdout.write(`${help()}\n`);
-    return 0;
-  }
-  process.stderr.write(`unknown command: ${command}\n\n${help()}\n`);
-  return 1;
-}
-
-main(process.argv.slice(2)).then((exitCode) => {
-  if (exitCode !== null && exitCode !== undefined) process.exitCode = exitCode;
-});
+#!/usr/bin/env node
+'use strict';
+
+// Standalone CLI for the published claude-ai-workbench package:
+//   claude-workbench                start the server in the foreground
+//   claude-workbench start [-d]     start in the foreground, detached with -d
+//   claude-workbench stop           stop the running instance
+//   claude-workbench status         report whether an instance is running
+//   claude-workbench -v             print the package version
+// Wired up via the package.json bin field, so a global `npm i -g
+// claude-ai-workbench` puts the `claude-workbench` command on PATH.
+
+const { execFileSync, spawn } = require('child_process');
+const fs = require('fs');
+const net = require('net');
+const os = require('os');
+const path = require('path');
+
+const pkg = require(path.join(__dirname, '..', '..', '..', 'package.json'));
+// The standalone product is the Agent Terminal: current dark UI, its own
+// clean data directory — not the legacy workbench data at ~/.claude-ai-workbench.
+const serverScript = path.join(__dirname, 'agent-terminal-server.js');
+const DEFAULT_PORT = 5760;
+
+function dataDir() {
+  return path.resolve(process.env.AGENT_TERMINAL_DATA_DIR || path.join(os.homedir(), '.agent-terminal'));
+}
+function pidFile() {
+  return path.join(dataDir(), 'server.pid');
+}
+function port() {
+  return Number(process.env.AGENT_TERMINAL_PORT || process.env.CLAUDE_WORKBENCH_PORT || DEFAULT_PORT);
+}
+function listenUrl() {
+  const host = process.env.AGENT_TERMINAL_HOST || process.env.CLAUDE_WORKBENCH_HOST || '127.0.0.1';
+  return `http://${host}:${port()}/agent-terminal/`;
+}
+
+function writePid(pid) {
+  fs.mkdirSync(dataDir(), { recursive: true });
+  fs.writeFileSync(pidFile(), String(pid), 'utf8');
+}
+function readPid() {
+  try {
+    const pid = Number(fs.readFileSync(pidFile(), 'utf8').trim());
+    return Number.isInteger(pid) && pid > 0 ? pid : null;
+  } catch {
+    return null;
+  }
+}
+function clearPid() {
+  try { fs.unlinkSync(pidFile()); } catch { /* already gone */ }
+}
+
+function alive(pid) {
+  if (process.platform === 'win32') {
+    try {
+      const out = execFileSync('tasklist', ['/FI', `PID eq ${pid}`, '/FO', 'CSV', '/NH'], {
+        encoding: 'utf8', windowsHide: true, timeout: 10000,
+      });
+      return out.includes(`"${pid}"`);
+    } catch {
+      return false;
+    }
+  }
+  try { process.kill(pid, 0); return true; } catch { return false; }
+}
+
+function killPid(pid) {
+  if (process.platform === 'win32') {
+    execFileSync('taskkill', ['/pid', String(pid), '/T', '/F'], { windowsHide: true, stdio: 'ignore', timeout: 15000 });
+    return;
+  }
+  process.kill(pid, 'SIGTERM');
+}
+
+// Fallback for instances started without this CLI (raw bin script, lost data
+// dir): whoever is LISTENING on the workbench port is the instance.
+function pidsListeningOnPort(portNum) {
+  let out = '';
+  try {
+    out = execFileSync('netstat', ['-ano'], {
+      encoding: 'utf8', windowsHide: true, timeout: 15000, maxBuffer: 16 * 1024 * 1024,
+    });
+  } catch {
+    return [];
+  }
+  const pids = new Set();
+  for (const line of out.split(/\r?\n/)) {
+    if (!/LISTENING/i.test(line)) continue;
+    const columns = line.trim().split(/\s+/);
+    if (!String(columns[1] || '').endsWith(`:${portNum}`)) continue;
+    const pid = Number(columns[columns.length - 1]);
+    if (Number.isInteger(pid) && pid > 0) pids.add(pid);
+  }
+  return [...pids];
+}
+
+function stopTargets() {
+  const pid = readPid();
+  if (pid && alive(pid)) return [pid];
+  return pidsListeningOnPort(port());
+}
+
+// True when something already listens on the workbench port. Checked before
+// every start so a busy port surfaces as guidance instead of the server's
+// raw EADDRINUSE stack trace.
+function probePortInUse(portNum, host) {
+  return new Promise((resolve) => {
+    const server = net.createServer();
+    server.once('error', () => resolve(true));
+    server.once('listening', () => server.close(() => resolve(false)));
+    server.listen(portNum, host);
+  });
+}
+
+async function cmdStart(argv) {
+  const daemon = argv.includes('-d') || argv.includes('--daemon');
+  const existing = readPid();
+  if (existing && alive(existing)) {
+    process.stdout.write(`claude-workbench is already running (pid ${existing}) at ${listenUrl()}\n`);
+    return 0;
+  }
+  const host = process.env.CLAUDE_WORKBENCH_HOST || '127.0.0.1';
+  if (await probePortInUse(port(), host)) {
+    const holders = pidsListeningOnPort(port());
+    process.stderr.write(
+      `port ${port()} is already in use${holders.length ? ` (pid ${holders.join(', ')})` : ''} — `
+      + `another instance may be running there.\n`
+      + `Try: claude-workbench stop, or pick another port via CLAUDE_WORKBENCH_PORT.\n`);
+    return 1;
+  }
+  if (daemon) {
+    const child = spawn(process.execPath, [serverScript], { detached: true, stdio: 'ignore', windowsHide: true });
+    child.unref();
+    writePid(child.pid);
+    process.stdout.write(`claude-workbench ${pkg.version} started in the background (pid ${child.pid}) at ${listenUrl()}\n`);
+    return 0;
+  }
+  writePid(process.pid);
+  process.on('exit', clearPid);
+  process.stderr.write(`claude-workbench ${pkg.version} starting at ${listenUrl()} (Ctrl+C stops)\n`);
+  require(serverScript); // constructs and listens in-process; owns the lifetime
+  return null;
+}
+
+function cmdStop() {
+  const targets = stopTargets();
+  if (!targets.length) {
+    clearPid(); // stale pid file from a crashed instance
+    process.stdout.write(`claude-workbench is not running (port ${port()})\n`);
+    return 1;
+  }
+  let failed = false;
+  for (const pid of targets) {
+    try {
+      killPid(pid);
+      process.stdout.write(`stopped pid ${pid}\n`);
+    } catch (error) {
+      failed = true;
+      process.stderr.write(`failed to stop pid ${pid}: ${error.message}\n`);
+    }
+  }
+  clearPid();
+  return failed ? 1 : 0;
+}
+
+function cmdStatus() {
+  const pid = readPid();
+  if (pid && alive(pid)) {
+    process.stdout.write(`claude-workbench is running (pid ${pid}) at ${listenUrl()}\n`);
+    return 0;
+  }
+  const portPids = pidsListeningOnPort(port());
+  if (portPids.length) {
+    process.stdout.write(`claude-workbench is running without a pid file (pid ${portPids.join(', ')}) at ${listenUrl()}\n`);
+    return 0;
+  }
+  clearPid();
+  process.stdout.write(`claude-workbench is not running\n`);
+  return 1;
+}
+
+function cmdVersion() {
+  process.stdout.write(`${pkg.version}\n`);
+  return 0;
+}
+
+function help() {
+  return [
+    `claude-ai-workbench ${pkg.version} — local workbench server for Claude Code, Codex, OpenCode`,
+    '',
+    'usage: claude-workbench [command]',
+    '',
+    'commands:',
+    '  start [-d|--daemon]   start the server (foreground by default, background with -d)',
+    '  stop                  stop the running server',
+    '  status                show whether the server is running',
+    '  -v | --version        print the version',
+    '  -h | --help           show this help',
+    '',
+    'environment:',
+    `  AGENT_TERMINAL_PORT            port to listen on (default ${DEFAULT_PORT}; CLAUDE_WORKBENCH_PORT also honored)`,
+    '  AGENT_TERMINAL_HOST            bind address (default 127.0.0.1)',
+    '  AGENT_TERMINAL_DATA_DIR        data directory (default ~/.agent-terminal)',
+  ].join('\n');
+}
+
+async function main(argv) {
+  const command = argv[0];
+  if (command === undefined || command === 'start') return cmdStart(argv.slice(1));
+  if (command === 'stop') return cmdStop();
+  if (command === 'status') return cmdStatus();
+  if (command === 'version' || command === '-v' || command === '--version') return cmdVersion();
+  if (command === '-h' || command === '--help' || command === 'help') {
+    process.stdout.write(`${help()}\n`);
+    return 0;
+  }
+  process.stderr.write(`unknown command: ${command}\n\n${help()}\n`);
+  return 1;
+}
+
+main(process.argv.slice(2)).then((exitCode) => {
+  if (exitCode !== null && exitCode !== undefined) process.exitCode = exitCode;
+});