@team-work/sandbox-client 0.1.1-beta.0

package/README.md

@@ -0,0 +1,69 @@
+# @team-work/sandbox-client
+
+team-work 平台的 sandbox CLI 客户端。全局命令 `tw`，在用户机器后台运行，通过 WebSocket 接入 sandbox 服务端，接受远程调度执行 **伪终端会话 / shell 执行 / 文件操作**。
+
+## 安装
+
+```bash
+npm i -g @team-work/sandbox-client
+```
+
+## 快速开始
+
+```bash
+# 1. 配置 sandbox 服务地址（ws://host:18081/ws/sandbox/cli）
+tw config set serverUrl ws://10.0.0.1:18081/ws/sandbox/cli
+# 可选：自定义日志目录（默认 ~/.tw/logs）
+tw config set logDir /var/log/tw
+
+# 2. 后台启动（sandboxId + privateKey 均为位置参数）
+tw start <sandboxId> <privateKey>
+# 输出：inst-20260805-1a2b3c started (pid 12345)
+
+# 3. 查询 / 列举 / 停止
+tw status              # 取最近一个实例
+tw list                # 列出所有激活态实例
+tw stop <id>
+tw log <id> [--follow] # 跟踪日志
+
+# 4. 自更新
+tw update
+```
+
+## 命令一览
+
+| 命令 | 说明 |
+|------|------|
+| `tw config set <key> <value>` | 设置配置（serverUrl / logDir） |
+| `tw config get <key>` | 读取配置 |
+| `tw config list` | 列出全部配置 |
+| `tw config unset <key>` | 删除配置 |
+| `tw start <sandboxId> <privateKey> [--foreground] [--id <instId>]` | 启动守护进程 |
+| `tw status [id]` | 查询实例状态 |
+| `tw stop [id] [--yes]` | 停止实例 |
+| `tw list` | 列出所有实例 |
+| `tw log [id] [--follow]` | 查看实例日志 |
+| `tw update` | 自更新 CLI |
+
+## 协议
+
+CLI 严格对齐 sandbox 服务端 `/ws/cli` 协议：
+
+- raw `ws`，UTF-8 JSON 文本帧，按 `type` 字段区分。
+- 握手：首帧 `{type:'hello', sandboxId, privateKey}` → `{type:'hello-ack', ok}`。
+- 上报：`{type:'report', config:{ip,os,cpu,memory,storage,cliVersion}}`。
+- 心跳：每 25s `{type:'ping'}` → `{type:'pong'}`。
+- RPC：服务端 `{type:'rpc', reqId, action, params}`；CLI 按 action 回 `rpc-result`（文件操作）或 `rpc-stream`+`rpc-end`（exec_shell）。
+- 伪终端：`terminal.open/input/resize/close`（server→cli），`terminal.data/exit`（cli→server），按 `sessionId` 多会话复用。
+
+详见 sandbox 服务端 `src/gateway/cli.gateway.ts`。
+
+## 配置文件位置
+
+- 配置：`~/.tw/config.json`（权限 0600）
+- 实例状态：`~/.tw/instances/<id>.json`（权限 0600）
+- 日志：`~/.tw/logs/<id>.log`（或自定义 logDir）
+
+## License
+
+MIT

package/dist/cli/config-cmd.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+/** `tw config <get|set|list|unset>` */
+export declare function buildConfigCommand(): Command;

package/dist/cli/config-cmd.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildConfigCommand = buildConfigCommand;
+const commander_1 = require("commander");
+const index_js_1 = require("../config/index.js");
+const schema_js_1 = require("../config/schema.js");
+/** `tw config <get|set|list|unset>` */
+function buildConfigCommand() {
+    const cmd = new commander_1.Command('config');
+    cmd
+        .command('set <key> <value>')
+        .description('设置配置项（serverUrl / logDir）')
+        .action((key, value) => {
+        if (!(0, schema_js_1.isValidKey)(key)) {
+            console.error(`未知配置项: ${key}（合法: ${schema_js_1.CONFIG_KEYS.join(', ')}）`);
+            process.exit(1);
+        }
+        try {
+            (0, index_js_1.setConfig)(key, value);
+            console.log(`已设置 ${key} = ${value}`);
+        }
+        catch (err) {
+            console.error(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+    cmd
+        .command('get <key>')
+        .description('读取配置项')
+        .action((key) => {
+        if (!(0, schema_js_1.isValidKey)(key)) {
+            console.error(`未知配置项: ${key}`);
+            process.exit(1);
+        }
+        const config = (0, index_js_1.loadConfig)();
+        console.log(config[key]);
+    });
+    cmd
+        .command('list')
+        .description('列出全部配置')
+        .action(() => {
+        const config = (0, index_js_1.loadConfig)();
+        for (const k of schema_js_1.CONFIG_KEYS) {
+            console.log(`${k} = ${config[k]}`);
+        }
+    });
+    cmd
+        .command('unset <key>')
+        .description('删除配置项（恢复默认）')
+        .action((key) => {
+        if (!(0, schema_js_1.isValidKey)(key)) {
+            console.error(`未知配置项: ${key}`);
+            process.exit(1);
+        }
+        (0, index_js_1.unsetConfig)(key);
+        console.log(`已删除 ${key}`);
+    });
+    return cmd;
+}
+//# sourceMappingURL=config-cmd.js.map

package/dist/cli/config-cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-cmd.js","sourceRoot":"","sources":["../../src/cli/config-cmd.ts"],"names":[],"mappings":";;AAMA,gDAuDC;AA7DD,yCAAoC;AAEpC,iDAAwE;AACxE,mDAA8D;AAE9D,uCAAuC;AACvC,SAAgB,kBAAkB;IAChC,MAAM,GAAG,GAAG,IAAI,mBAAO,CAAC,QAAQ,CAAC,CAAC;IAElC,GAAG;SACA,OAAO,CAAC,mBAAmB,CAAC;SAC5B,WAAW,CAAC,2BAA2B,CAAC;SACxC,MAAM,CAAC,CAAC,GAAW,EAAE,KAAa,EAAE,EAAE;QACrC,IAAI,CAAC,IAAA,sBAAU,EAAC,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,QAAQ,uBAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,CAAC;YACH,IAAA,oBAAS,EAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,MAAM,KAAK,EAAE,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,GAAG;SACA,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,OAAO,CAAC;SACpB,MAAM,CAAC,CAAC,GAAW,EAAE,EAAE;QACtB,IAAI,CAAC,IAAA,sBAAU,EAAC,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,MAAM,GAAG,IAAA,qBAAU,GAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEL,GAAG;SACA,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,QAAQ,CAAC;SACrB,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,MAAM,GAAG,IAAA,qBAAU,GAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,IAAI,uBAAW,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACrC,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,GAAG;SACA,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,aAAa,CAAC;SAC1B,MAAM,CAAC,CAAC,GAAW,EAAE,EAAE;QACtB,IAAI,CAAC,IAAA,sBAAU,EAAC,GAAG,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,IAAA,sBAAW,EAAC,GAAG,CAAC,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEL,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/index.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const info_js_1 = require("../utils/info.js");
+const config_cmd_js_1 = require("./config-cmd.js");
+const start_cmd_js_1 = require("./start-cmd.js");
+const status_cmd_js_1 = require("./status-cmd.js");
+const stop_cmd_js_1 = require("./stop-cmd.js");
+const list_cmd_js_1 = require("./list-cmd.js");
+const log_cmd_js_1 = require("./log-cmd.js");
+const update_cmd_js_1 = require("./update-cmd.js");
+const program = new commander_1.Command('tw');
+program
+    .name('tw')
+    .description('team-work sandbox CLI client')
+    .version((0, info_js_1.getPkgInfo)().version);
+program.addCommand((0, config_cmd_js_1.buildConfigCommand)());
+program.addCommand((0, start_cmd_js_1.buildStartCommand)());
+program.addCommand((0, status_cmd_js_1.buildStatusCommand)());
+program.addCommand((0, stop_cmd_js_1.buildStopCommand)());
+program.addCommand((0, list_cmd_js_1.buildListCommand)());
+program.addCommand((0, log_cmd_js_1.buildLogCommand)());
+program.addCommand((0, update_cmd_js_1.buildUpdateCommand)());
+// 缺省显示 help
+program.parseAsync(process.argv).catch((err) => {
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;;AAEA,yCAAoC;AAEpC,8CAA8C;AAC9C,mDAAqD;AACrD,iDAAmD;AACnD,mDAAqD;AACrD,+CAAiD;AACjD,+CAAiD;AACjD,6CAA+C;AAC/C,mDAAqD;AAErD,MAAM,OAAO,GAAG,IAAI,mBAAO,CAAC,IAAI,CAAC,CAAC;AAElC,OAAO;KACJ,IAAI,CAAC,IAAI,CAAC;KACV,WAAW,CAAC,8BAA8B,CAAC;KAC3C,OAAO,CAAC,IAAA,oBAAU,GAAE,CAAC,OAAO,CAAC,CAAC;AAEjC,OAAO,CAAC,UAAU,CAAC,IAAA,kCAAkB,GAAE,CAAC,CAAC;AACzC,OAAO,CAAC,UAAU,CAAC,IAAA,gCAAiB,GAAE,CAAC,CAAC;AACxC,OAAO,CAAC,UAAU,CAAC,IAAA,kCAAkB,GAAE,CAAC,CAAC;AACzC,OAAO,CAAC,UAAU,CAAC,IAAA,8BAAgB,GAAE,CAAC,CAAC;AACvC,OAAO,CAAC,UAAU,CAAC,IAAA,8BAAgB,GAAE,CAAC,CAAC;AACvC,OAAO,CAAC,UAAU,CAAC,IAAA,4BAAe,GAAE,CAAC,CAAC;AACtC,OAAO,CAAC,UAAU,CAAC,IAAA,kCAAkB,GAAE,CAAC,CAAC;AAEzC,YAAY;AACZ,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IAC7C,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/cli/list-cmd.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+/** `tw list`：列出本机所有激活态实例（PID 已死的残留自动清理） */
+export declare function buildListCommand(): Command;

package/dist/cli/list-cmd.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildListCommand = buildListCommand;
+const commander_1 = require("commander");
+const store_js_1 = require("../instance/store.js");
+/** `tw list`：列出本机所有激活态实例（PID 已死的残留自动清理） */
+function buildListCommand() {
+    const cmd = new commander_1.Command('list');
+    cmd.description('列出所有实例').action(() => {
+        (0, store_js_1.purgeDeadInstances)(); // 自愈：清掉崩溃未自删的 stale 记录
+        const all = (0, store_js_1.listInstances)();
+        if (!all.length) {
+            console.log('暂无实例');
+            return;
+        }
+        // 按启动时间降序
+        all.sort((a, b) => (a.startedAt < b.startedAt ? 1 : -1));
+        const header = ['ID', 'PID', 'STATUS', 'WS', 'SANDBOX', 'STARTED'];
+        const rows = all.map((r) => [
+            r.id,
+            String(r.pid),
+            r.status,
+            r.wsState,
+            r.sandboxId,
+            r.startedAt.replace('T', ' ').slice(0, 19),
+        ]);
+        const widths = header.map((_, i) => Math.max(header[i].length, ...rows.map((r) => r[i].length)));
+        const fmt = (cells) => cells.map((c, i) => c.padEnd(widths[i])).join('  ');
+        console.log(fmt(header));
+        console.log(widths.map((w) => '-'.repeat(w)).join('  '));
+        for (const r of rows)
+            console.log(fmt(r));
+    });
+    return cmd;
+}
+//# sourceMappingURL=list-cmd.js.map

package/dist/cli/list-cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-cmd.js","sourceRoot":"","sources":["../../src/cli/list-cmd.ts"],"names":[],"mappings":";;AAKA,4CA8BC;AAnCD,yCAAoC;AAEpC,mDAAyE;AAEzE,2CAA2C;AAC3C,SAAgB,gBAAgB;IAC9B,MAAM,GAAG,GAAG,IAAI,mBAAO,CAAC,MAAM,CAAC,CAAC;IAChC,GAAG,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE;QACpC,IAAA,6BAAkB,GAAE,CAAC,CAAC,uBAAuB;QAC7C,MAAM,GAAG,GAAG,IAAA,wBAAa,GAAE,CAAC;QAC5B,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACpB,OAAO;QACT,CAAC;QACD,UAAU;QACV,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEzD,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAC1B,CAAC,CAAC,EAAE;YACJ,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC;YACb,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SAC3C,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACjC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAC5D,CAAC;QACF,MAAM,GAAG,GAAG,CAAC,KAAe,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrF,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACzD,KAAK,MAAM,CAAC,IAAI,IAAI;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/cli/log-cmd.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+/** `tw log [id] [--follow] [--changes]` */
+export declare function buildLogCommand(): Command;

package/dist/cli/log-cmd.js

@@ -0,0 +1,118 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildLogCommand = buildLogCommand;
+const commander_1 = require("commander");
+const node_fs_1 = require("node:fs");
+const node_readline_1 = __importDefault(require("node:readline"));
+const paths_js_1 = require("../config/paths.js");
+const store_js_1 = require("../instance/store.js");
+function resolveLogFile(id) {
+    if (id) {
+        const rec = (0, store_js_1.loadInstance)(id);
+        if (rec)
+            return rec.logFile;
+        return null;
+    }
+    // 取最近实例
+    const all = (0, store_js_1.listInstances)();
+    if (!all.length)
+        return null;
+    all.sort((a, b) => (a.lastSeenAt < b.lastSeenAt ? 1 : -1));
+    return all[0].logFile;
+}
+/** 解析 pino JSON 行，提取 msg / level / time */
+function parsePinoLine(line) {
+    try {
+        const j = JSON.parse(line);
+        return { time: j.time, level: j.level, msg: j.msg, ...j };
+    }
+    catch {
+        return null;
+    }
+}
+/** `tw log [id] [--follow] [--changes]` */
+function buildLogCommand() {
+    const cmd = new commander_1.Command('log');
+    cmd
+        .description('查看实例日志（缺省取最近一个）')
+        .argument('[id]', '实例 id')
+        .option('-f, --follow', '持续跟踪（类似 tail -f）', false)
+        .option('-c, --changes', '仅输出变更行（含 auth/fail/error/warn 等关键词）', false)
+        .option('--clean', '清理超期日志文件（同时输出）', false)
+        .option('--clean-days <days>', '超期天数，默认 7', '7')
+        .action(async (id, opts) => {
+        // --clean：清理超期日志并报告
+        if (opts.clean) {
+            const days = parseInt(opts.cleanDays, 10);
+            if (Number.isNaN(days) || days <= 0) {
+                console.error('--clean-days 必须是正整数');
+                process.exit(1);
+            }
+            const maxAgeMs = days * 24 * 60 * 60 * 1000;
+            const n = (0, paths_js_1.purgeOldLogs)(paths_js_1.DEFAULT_LOG_DIR, maxAgeMs);
+            console.log(`已清理 ${n} 个超过 ${days} 天的日志文件 (${paths_js_1.DEFAULT_LOG_DIR})`);
+            return;
+        }
+        const file = resolveLogFile(id);
+        if (!file || !(0, node_fs_1.existsSync)(file)) {
+            console.error(id ? `实例或日志不存在: ${id}` : '暂无实例日志');
+            process.exit(1);
+        }
+        const content = (0, node_fs_1.readFileSync)(file, 'utf8');
+        const lines = content.split('\n').filter(Boolean);
+        if (opts.changes) {
+            // 变更模式：只输出含 "changed" / "update" / "auth" / "fail" / "error" / "warn" 关键词的行
+            const keywords = ['changed', 'update', 'auth', 'fail', 'error', 'warn', 'removed', 'added', 'purge', 'exit'];
+            const filtered = lines.filter((l) => {
+                const p = parsePinoLine(l);
+                if (!p)
+                    return false;
+                const msg = String(p.msg ?? '').toLowerCase();
+                return keywords.some((k) => msg.includes(k));
+            });
+            if (!filtered.length) {
+                console.log('(无变更相关日志)');
+            }
+            else {
+                for (const l of filtered)
+                    console.log(l);
+            }
+            return;
+        }
+        const tail = async () => {
+            const stream = (0, node_fs_1.createReadStream)(file, { encoding: 'utf8' });
+            const rl = node_readline_1.default.createInterface({ input: stream, crlfDelay: Infinity });
+            for await (const line of rl) {
+                console.log(line);
+            }
+        };
+        await tail();
+        if (!opts.follow)
+            return;
+        // follow：轮询新内容（用顶部导入的 statSync）
+        let size = (0, node_fs_1.statSync)(file).size;
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            await new Promise((r) => setTimeout(r, 500));
+            let st;
+            try {
+                st = (0, node_fs_1.statSync)(file);
+            }
+            catch {
+                continue;
+            }
+            if (st.size > size) {
+                const stream = (0, node_fs_1.createReadStream)(file, { encoding: 'utf8', start: size });
+                const rl = node_readline_1.default.createInterface({ input: stream, crlfDelay: Infinity });
+                for await (const line of rl)
+                    console.log(line);
+                size = st.size;
+            }
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=log-cmd.js.map

package/dist/cli/log-cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-cmd.js","sourceRoot":"","sources":["../../src/cli/log-cmd.ts"],"names":[],"mappings":"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"}

package/dist/cli/start-cmd.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+/** `tw start <sandboxId> <privateKey> [--foreground] [--id <instId>]` */
+export declare function buildStartCommand(): Command;

package/dist/cli/start-cmd.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildStartCommand = buildStartCommand;
+const commander_1 = require("commander");
+const index_js_1 = require("../config/index.js");
+const launch_js_1 = require("../daemon/launch.js");
+const detach_js_1 = require("../daemon/detach.js");
+const store_js_1 = require("../instance/store.js");
+/** `tw start <sandboxId> <privateKey> [--foreground] [--id <instId>]` */
+function buildStartCommand() {
+    const cmd = new commander_1.Command('start');
+    cmd
+        .description('后台启动守护进程，连接 sandbox')
+        .argument('<sandboxId>', '沙箱 ID（oauth_sandbox 表主键）')
+        .argument('<privateKey>', '私钥（hello 握手凭证）')
+        .option('--foreground', '前台运行（调试用，不 detach）', false)
+        .option('--daemon', '(内部) 作为被拉起的守护进程直接运行，写文件日志', false)
+        .option('--id <instId>', '指定实例 id（默认自动生成）')
+        .option('--replace', '强制替换同 sandboxId 旧实例（默认 false）', false)
+        .action(async (sandboxId, privateKey, opts) => {
+        const config = (0, index_js_1.loadConfig)();
+        if (!config.serverUrl) {
+            console.error('未配置 serverUrl，请先执行: tw config set serverUrl ws://host:port/ws/sandbox/cli');
+            process.exit(1);
+        }
+        // 内部 daemon 子进程直接跑；此时父进程已完成替换逻辑
+        if (opts.daemon) {
+            const code = await (0, launch_js_1.runDaemon)({ sandboxId, privateKey, config, instanceId: opts.id, foreground: false });
+            process.exit(code);
+        }
+        // 同 sandboxId 只允许一个运行进程：发现旧的 running 实例则杀掉再启。
+        const existing = (0, store_js_1.findRunningBySandboxId)(sandboxId);
+        if (existing && existing.id !== opts.id) {
+            if (!opts.replace) {
+                console.error(`sandbox ${sandboxId} 已有运行实例 ${existing.id} (pid ${existing.pid})。\n` +
+                    `若确认替换，请加 --replace 参数：tw start ${sandboxId} <key> --replace`);
+                process.exit(1);
+            }
+            const res = await (0, store_js_1.killInstance)(existing.id);
+            console.log(res.note);
+            if (res.rec && !res.ok) {
+                console.error('旧实例终止失败，中止启动');
+                process.exit(1);
+            }
+        }
+        if (opts.foreground) {
+            const code = await (0, launch_js_1.runDaemon)({ sandboxId, privateKey, config, instanceId: opts.id, foreground: true });
+            process.exit(code);
+        }
+        // 后台：spawn detached 子进程
+        const entryPath = process.argv[1];
+        const { instanceId, child } = (0, detach_js_1.detachStart)({ sandboxId, privateKey, entryPath, instanceId: opts.id });
+        // 子进程异常退出（极少）直接报错
+        child.on('error', (err) => {
+            console.error('启动失败:', err.message);
+            process.exit(1);
+        });
+        const rec = await (0, detach_js_1.waitForInstance)(instanceId, 3000);
+        if (!rec) {
+            console.error('实例启动超时，请检查日志:', instanceId);
+            process.exit(1);
+        }
+        console.log(`${rec.id} started (pid ${rec.pid})`);
+        console.log(`日志: ${rec.logFile}`);
+        process.exit(0);
+    });
+    return cmd;
+}
+//# sourceMappingURL=start-cmd.js.map

package/dist/cli/start-cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-cmd.js","sourceRoot":"","sources":["../../src/cli/start-cmd.ts"],"names":[],"mappings":"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"}

package/dist/cli/status-cmd.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+/** `tw status [id]` */
+export declare function buildStatusCommand(): Command;

package/dist/cli/status-cmd.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildStatusCommand = buildStatusCommand;
+const commander_1 = require("commander");
+const store_js_1 = require("../instance/store.js");
+/** 取最近一个实例（按 lastSeenAt 降序） */
+function latestInstance() {
+    const all = (0, store_js_1.listInstances)();
+    if (!all.length)
+        return null;
+    all.sort((a, b) => (a.lastSeenAt < b.lastSeenAt ? 1 : -1));
+    return all[0];
+}
+/** `tw status [id]` */
+function buildStatusCommand() {
+    const cmd = new commander_1.Command('status');
+    cmd
+        .description('查询实例状态（缺省取最近一个）')
+        .argument('[id]', '实例 id')
+        .action((id) => {
+        (0, store_js_1.purgeDeadInstances)(); // 自愈
+        const rec = id ? (0, store_js_1.loadInstance)(id) : latestInstance();
+        if (!rec) {
+            console.error(id ? `实例不存在: ${id}` : '暂无实例');
+            process.exit(1);
+        }
+        const alive = (0, store_js_1.isPidAlive)(rec.pid);
+        if (!alive) {
+            // 残留记录（理论上 purgeDeadInstances 已清，兜底）
+            (0, store_js_1.removeInstance)(rec.id);
+            console.error(id ? `实例 ${id} 已退出（记录已清理）` : '暂无实例');
+            process.exit(1);
+        }
+        console.log(`ID           ${rec.id}`);
+        console.log(`PID          ${rec.pid} (alive)`);
+        console.log(`Sandbox      ${rec.sandboxId}`);
+        console.log(`Server       ${rec.serverUrl}`);
+        console.log(`WS           ${rec.wsState}`);
+        console.log(`Status       ${rec.status}`);
+        console.log(`Started      ${rec.startedAt}`);
+        console.log(`Last seen    ${rec.lastSeenAt}`);
+        console.log(`Log          ${rec.logFile}`);
+    });
+    return cmd;
+}
+//# sourceMappingURL=status-cmd.js.map

package/dist/cli/status-cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-cmd.js","sourceRoot":"","sources":["../../src/cli/status-cmd.ts"],"names":[],"mappings":";;AAcA,gDA8BC;AA5CD,yCAAoC;AAEpC,mDAAmH;AAGnH,+BAA+B;AAC/B,SAAS,cAAc;IACrB,MAAM,GAAG,GAAG,IAAA,wBAAa,GAAE,CAAC;IAC5B,IAAI,CAAC,GAAG,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC7B,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;AAChB,CAAC;AAED,uBAAuB;AACvB,SAAgB,kBAAkB;IAChC,MAAM,GAAG,GAAG,IAAI,mBAAO,CAAC,QAAQ,CAAC,CAAC;IAClC,GAAG;SACA,WAAW,CAAC,iBAAiB,CAAC;SAC9B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;SACzB,MAAM,CAAC,CAAC,EAAW,EAAE,EAAE;QACtB,IAAA,6BAAkB,GAAE,CAAC,CAAC,KAAK;QAC3B,MAAM,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,IAAA,uBAAY,EAAC,EAAE,CAAC,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC;QACrD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,KAAK,GAAG,IAAA,qBAAU,EAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,qCAAqC;YACrC,IAAA,yBAAc,EAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACvB,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IACL,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/cli/stop-cmd.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+/** `tw stop [id] [--yes]` */
+export declare function buildStopCommand(): Command;

package/dist/cli/stop-cmd.js

@@ -0,0 +1,115 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildStopCommand = buildStopCommand;
+const commander_1 = require("commander");
+const readline = __importStar(require("node:readline"));
+const store_js_1 = require("../instance/store.js");
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+function latestInstance() {
+    const all = (0, store_js_1.listInstances)();
+    if (!all.length)
+        return null;
+    all.sort((a, b) => (a.lastSeenAt < b.lastSeenAt ? 1 : -1));
+    return all[0];
+}
+async function killPid(pid) {
+    if (!(0, store_js_1.isPidAlive)(pid))
+        return true;
+    try {
+        process.kill(pid, 'SIGTERM');
+    }
+    catch {
+        return false;
+    }
+    // 等 5s，仍存活则 SIGKILL
+    for (let i = 0; i < 50; i++) {
+        await sleep(100);
+        if (!(0, store_js_1.isPidAlive)(pid))
+            return true;
+    }
+    if ((0, store_js_1.isPidAlive)(pid)) {
+        try {
+            process.kill(pid, 'SIGKILL');
+        }
+        catch {
+            // ignore
+        }
+        await sleep(200);
+    }
+    return !(0, store_js_1.isPidAlive)(pid);
+}
+function confirm(question) {
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(/^y(es)?$/i.test(answer.trim()));
+        });
+    });
+}
+/** `tw stop [id] [--yes]` */
+function buildStopCommand() {
+    const cmd = new commander_1.Command('stop');
+    cmd
+        .description('停止实例（缺省取最近一个）')
+        .argument('[id]', '实例 id')
+        .option('--yes', '跳过二次确认', false)
+        .action(async (id, opts) => {
+        const rec = id ? (0, store_js_1.loadInstance)(id) : latestInstance();
+        if (!rec) {
+            console.error(id ? `实例不存在: ${id}` : '暂无实例');
+            process.exit(1);
+        }
+        if (!opts.yes) {
+            const ok = await confirm(`确认停止 ${rec.id} (pid ${rec.pid})? [y/N] `);
+            if (!ok) {
+                console.log('已取消');
+                process.exit(0);
+            }
+        }
+        const success = await killPid(rec.pid);
+        // daemon 收到 SIGTERM 会自删记录；兜底：若文件仍在则删（SIGKILL 未自删场景）
+        (0, store_js_1.removeInstance)(rec.id);
+        if (success)
+            console.log(`${rec.id} stopped`);
+        else {
+            console.error(`${rec.id} 停止失败（pid ${rec.pid}）`);
+            process.exit(1);
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=stop-cmd.js.map

package/dist/cli/stop-cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-cmd.js","sourceRoot":"","sources":["../../src/cli/stop-cmd.ts"],"names":[],"mappings":"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"}

package/dist/cli/update-cmd.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+/** `tw update`：自更新 CLI 本身 */
+export declare function buildUpdateCommand(): Command;