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

package/dist/handlers/rpc/file-ops.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadFile = uploadFile;
+exports.fileUploadAborted = fileUploadAborted;
+exports.downloadFile = downloadFile;
+exports.readFile = readFile;
+exports.writeFile = writeFile;
+exports.listDir = listDir;
+exports.makeDir = makeDir;
+exports.remove = remove;
+exports.stat = stat;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/**
+ * 文件操作：既有 6 类同步单帧回包 + 分片上传/下载（二进制 base64）。
+ * 分片上传：逐片 appendFileSync 到 .part 文件，isLast 时 rename 落盘（内存 O(chunk)）。
+ * 分片下载：CLI 按 chunkSize 读文件，base64 编码逐片回吐；支持 offset/length 参数做 Range 段级下载。
+ *
+ * 路径校验：拒绝 null 字节、拒绝相对解析异常。不做路径白名单（sandbox 已鉴权，CLI 信任其指令）。
+ * 错误一律抛 → router 回 rpc-result{ok:false,error}。
+ */
+function assertPath(path) {
+    if (typeof path !== 'string' || !path)
+        throw new Error('path required');
+    if (path.includes('\0'))
+        throw new Error('invalid path');
+    return path;
+}
+// ---- 分片上传：逐片 append 到 .part 文件，isLast 时 rename 落盘（内存 O(chunk)） ----
+/** 分片上传会话（按 path 索引，保存 fd + 累积大小） */
+const uploadSessions = new Map();
+function uploadFile(path, chunkDataB64, isLast) {
+    const p = assertPath(path);
+    if (typeof chunkDataB64 !== 'string')
+        throw new Error('chunkData must be base64 string');
+    const chunk = Buffer.from(chunkDataB64, 'base64');
+    const prev = uploadSessions.get(p);
+    if (!prev) {
+        // 首次分片：创建 .part 文件
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(p, '..'), { recursive: true });
+        const fd = (0, node_fs_1.openSync)(p + '.part', 'w');
+        uploadSessions.set(p, { fd, size: chunk.length });
+        (0, node_fs_1.appendFileSync)(fd, chunk);
+    }
+    else {
+        (0, node_fs_1.appendFileSync)(prev.fd, chunk);
+        prev.size += chunk.length;
+    }
+    if (isLast) {
+        const sess = uploadSessions.get(p);
+        uploadSessions.delete(p);
+        (0, node_fs_1.closeSync)(sess.fd);
+        // 原子 rename：.part → 目标路径
+        (0, node_fs_1.renameSync)(p + '.part', p);
+    }
+    return { ok: true, path: p };
+}
+function fileUploadAborted(path) {
+    const p = assertPath(path);
+    const sess = uploadSessions.get(p);
+    if (sess) {
+        (0, node_fs_1.closeSync)(sess.fd);
+        try {
+            (0, node_fs_1.unlinkSync)(p + '.part');
+        }
+        catch { /* ignore */ }
+        uploadSessions.delete(p);
+    }
+}
+/**
+ * 分片下载。支持 offset/length 做 Range 段级下载（段内仍分片回吐）：
+ *   - offset（字节）：起始位置，默认 0
+ *   - length（字节）：读取长度，默认到文件尾
+ * isLast=true 表示本段（或整个文件）的最后一片。
+ */
+function downloadFile(path, chunkB64, offset, length) {
+    const p = assertPath(path);
+    if (!(0, node_fs_1.existsSync)(p))
+        throw new Error(`not found: ${p}`);
+    const st = (0, node_fs_1.statSync)(p);
+    const start = Math.max(0, Number(offset ?? 0) || 0);
+    const len = Number(length ?? 0) > 0 ? Number(length) : st.size - start;
+    const end = Math.min(st.size, start + len);
+    let pos = start;
+    // 10 MiB 原始字节 → base64 ~13.3 MiB；分片回吐避免单帧过大（覆盖绝大多数文件）
+    const chunkSize = 10 * 1024 * 1024;
+    const fd = (0, node_fs_1.openSync)(p, 'r');
+    try {
+        const buf = Buffer.alloc(chunkSize);
+        let isLast = false;
+        while (pos < end) {
+            const want = Math.min(chunkSize, end - pos);
+            const bytes = (0, node_fs_1.readSync)(fd, buf, 0, want, pos);
+            if (bytes === 0)
+                break;
+            const slice = bytes < want ? buf.subarray(0, bytes) : buf.subarray(0, want);
+            pos += bytes;
+            isLast = pos >= end;
+            chunkB64(slice.toString('base64'), isLast);
+            if (isLast)
+                break;
+        }
+        if (!isLast && start >= end) {
+            // 空段/越界：仍回一个结束以让调用方正常收尾
+            chunkB64('', true);
+        }
+    }
+    finally {
+        (0, node_fs_1.closeSync)(fd);
+    }
+}
+// ---- 既有同步操作 ----
+function readFile(path) {
+    const p = assertPath(path);
+    return (0, node_fs_1.readFileSync)(p, 'utf8');
+}
+function writeFile(path, content) {
+    const p = assertPath(path);
+    if (typeof content !== 'string')
+        throw new Error('content must be string');
+    (0, node_fs_1.writeFileSync)(p, content);
+    return { ok: true, path: p };
+}
+function listDir(path) {
+    const p = assertPath(path);
+    const names = (0, node_fs_1.readdirSync)(p);
+    const entries = [];
+    for (const name of names) {
+        const full = (0, node_path_1.join)(p, name);
+        let isDir = false;
+        let size = 0;
+        try {
+            const st = (0, node_fs_1.lstatSync)(full);
+            isDir = st.isDirectory();
+            size = st.size;
+        }
+        catch {
+            // 无权限等：仍列出但 size 0
+        }
+        entries.push({ name, isDir, size });
+    }
+    return entries;
+}
+function makeDir(path) {
+    const p = assertPath(path);
+    (0, node_fs_1.mkdirSync)(p, { recursive: true });
+    return { ok: true, path: p };
+}
+function remove(path) {
+    const p = assertPath(path);
+    (0, node_fs_1.rmSync)(p, { recursive: true, force: true });
+    return { ok: true, path: p };
+}
+function stat(path) {
+    const p = assertPath(path);
+    const st = (0, node_fs_1.statSync)(p);
+    return {
+        size: st.size,
+        isDir: st.isDirectory(),
+        mtime: st.mtimeMs,
+    };
+}
+//# sourceMappingURL=file-ops.js.map

package/dist/handlers/rpc/file-ops.js.map

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

package/dist/handlers/rpc/router.d.ts

@@ -0,0 +1,9 @@
+import { Logger } from '../../logging/logger.js';
+import { RpcFrame } from '../../client/frames.js';
+/**
+ * RPC 路由：按 action 分发，统一回包为 rpc-result（文件操作）或 rpc-stream+rpc-end（exec_shell）。
+ * 单个 RPC 异常回 rpc-result{ok:false,error}，不向上抛、不关连接。
+ */
+type Send = (frame: string) => void;
+export declare function handleRpc(frame: RpcFrame, send: Send, logger: Logger): void;
+export {};

package/dist/handlers/rpc/router.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleRpc = handleRpc;
+const frames_js_1 = require("../../client/frames.js");
+const protocol_js_1 = require("../../client/protocol.js");
+const exec_shell_js_1 = require("./exec-shell.js");
+const file_ops_js_1 = require("./file-ops.js");
+function sendResult(reqId, ok, data, error, send) {
+    const frame = { type: 'rpc-result', reqId, ok, ...(data !== undefined ? { data } : {}), ...(error ? { error } : {}) };
+    send((0, frames_js_1.serializeFrame)(frame));
+}
+function handleRpc(frame, send, logger) {
+    const { reqId, action, params } = frame;
+    try {
+        switch (action) {
+            case protocol_js_1.RpcAction.READ_FILE: {
+                const data = (0, file_ops_js_1.readFile)(params.path);
+                sendResult(reqId, true, data, undefined, send);
+                return;
+            }
+            case protocol_js_1.RpcAction.WRITE_FILE: {
+                const data = (0, file_ops_js_1.writeFile)(params.path, params.content);
+                sendResult(reqId, true, data, undefined, send);
+                return;
+            }
+            case protocol_js_1.RpcAction.LIST_DIR: {
+                const data = (0, file_ops_js_1.listDir)(params.path);
+                sendResult(reqId, true, data, undefined, send);
+                return;
+            }
+            case protocol_js_1.RpcAction.MAKE_DIR: {
+                const data = (0, file_ops_js_1.makeDir)(params.path);
+                sendResult(reqId, true, data, undefined, send);
+                return;
+            }
+            case protocol_js_1.RpcAction.REMOVE: {
+                const data = (0, file_ops_js_1.remove)(params.path);
+                sendResult(reqId, true, data, undefined, send);
+                return;
+            }
+            case protocol_js_1.RpcAction.STAT: {
+                const data = (0, file_ops_js_1.stat)(params.path);
+                sendResult(reqId, true, data, undefined, send);
+                return;
+            }
+            case protocol_js_1.RpcAction.UPLOAD_FILE: {
+                // 分片上传：append 到内存 buffer，isLast 时落盘
+                const data = (0, file_ops_js_1.uploadFile)(params.path, params.chunkData, params.isLast);
+                sendResult(reqId, true, data, undefined, send);
+                return;
+            }
+            case protocol_js_1.RpcAction.DOWNLOAD_FILE: {
+                // 分片下载：逐片 base64 回吐到 rpc-stream；支持 offset/length 做 Range 段级下载
+                let done = false;
+                (0, file_ops_js_1.downloadFile)(params.path, (chunkB64, isLast) => {
+                    send((0, frames_js_1.serializeFrame)({
+                        type: 'rpc-stream',
+                        reqId,
+                        stream: 'stdout',
+                        data: chunkB64, // 纯 base64，不包装成 JSON
+                    }));
+                    if (isLast) {
+                        done = true;
+                        send((0, frames_js_1.serializeFrame)({ type: 'rpc-end', reqId, exitCode: 0 }));
+                    }
+                }, params.offset, params.length);
+                if (!done) {
+                    // 空文件：没有分片，直接结束
+                    send((0, frames_js_1.serializeFrame)({ type: 'rpc-end', reqId, exitCode: 0 }));
+                }
+                return;
+            }
+            case protocol_js_1.RpcAction.EXEC_SHELL: {
+                (0, exec_shell_js_1.execShell)(params.command, params.cwd, params.timeout, {
+                    onStream: (stream, data) => send((0, frames_js_1.serializeFrame)({ type: 'rpc-stream', reqId, stream, data })),
+                    onEnd: (exitCode) => {
+                        const endFrame = exitCode !== undefined
+                            ? { type: 'rpc-end', reqId, exitCode }
+                            : { type: 'rpc-end', reqId };
+                        send((0, frames_js_1.serializeFrame)(endFrame));
+                    },
+                    onError: (error) => sendResult(reqId, false, undefined, error, send),
+                }, logger);
+                return;
+            }
+            default: {
+                sendResult(reqId, false, undefined, `unknown action: ${action}`, send);
+                logger.warn({ action }, 'unknown rpc action');
+            }
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        sendResult(reqId, false, undefined, msg, send);
+        logger.warn({ action, err: msg }, 'rpc handler error');
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/handlers/rpc/router.js.map

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

package/dist/handlers/terminal/manager.d.ts

@@ -0,0 +1,20 @@
+import { Logger } from '../../logging/logger.js';
+type Send = (frame: string) => void;
+/**
+ * 多会话管理：单 ws 连接复用多个 pty，按 sessionId 索引。
+ * terminal.open → 创建；input → 写；resize → 调整；close → kill+清理。
+ * 退出时自动从 Map 删除。
+ */
+export declare class TerminalManager {
+    private sessions;
+    private logger;
+    private send;
+    constructor(send: Send, logger: Logger);
+    open(sessionId: string, cols: number, rows: number): void;
+    input(sessionId: string, data: string): void;
+    resize(sessionId: string, cols: number, rows: number): void;
+    close(sessionId: string): void;
+    /** 连接断开时清理全部会话 */
+    closeAll(): void;
+}
+export {};

package/dist/handlers/terminal/manager.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TerminalManager = void 0;
+const frames_js_1 = require("../../client/frames.js");
+const pty_session_js_1 = require("./pty-session.js");
+/**
+ * 多会话管理：单 ws 连接复用多个 pty，按 sessionId 索引。
+ * terminal.open → 创建；input → 写；resize → 调整；close → kill+清理。
+ * 退出时自动从 Map 删除。
+ */
+class TerminalManager {
+    sessions = new Map();
+    logger;
+    send;
+    constructor(send, logger) {
+        this.send = send;
+        this.logger = logger;
+    }
+    open(sessionId, cols, rows) {
+        if (this.sessions.has(sessionId)) {
+            this.logger.warn({ sessionId }, 'terminal.open for existing session, ignore');
+            return;
+        }
+        let session;
+        try {
+            session = new pty_session_js_1.PtySession(sessionId, cols, rows, {
+                onData: (data) => this.send((0, frames_js_1.serializeFrame)({ type: 'terminal.data', sessionId, data })),
+                onExit: (exitCode) => {
+                    this.send((0, frames_js_1.serializeFrame)({ type: 'terminal.exit', sessionId, exitCode }));
+                    this.sessions.delete(sessionId);
+                    this.logger.info({ sessionId, exitCode }, 'pty exited');
+                },
+            }, this.logger);
+        }
+        catch (err) {
+            // pty.spawn 同步抛（如 spawn-helper 丢失可执行位 → posix_spawnp EACCES、
+            // shell/cwd 不存在等）：不能让单会话失败把整个守护进程拖崩（否则所有终端断、
+            // CLI 离线）。回一条 terminal.exit 让 web 侧优雅收尾，并落日志便于排查。
+            const msg = err instanceof Error ? err.message : String(err);
+            this.logger.error({ sessionId, err: msg, cols, rows }, 'pty spawn failed, sending terminal.exit');
+            this.send((0, frames_js_1.serializeFrame)({ type: 'terminal.exit', sessionId, exitCode: -1 }));
+            return;
+        }
+        this.sessions.set(sessionId, session);
+    }
+    input(sessionId, data) {
+        const s = this.sessions.get(sessionId);
+        if (!s) {
+            this.logger.warn({ sessionId }, 'terminal.input for unknown session');
+            return;
+        }
+        s.write(data);
+    }
+    resize(sessionId, cols, rows) {
+        const s = this.sessions.get(sessionId);
+        if (!s)
+            return;
+        s.resize(cols, rows);
+    }
+    close(sessionId) {
+        const s = this.sessions.get(sessionId);
+        if (!s)
+            return;
+        s.kill();
+        this.sessions.delete(sessionId);
+    }
+    /** 连接断开时清理全部会话 */
+    closeAll() {
+        for (const s of this.sessions.values())
+            s.kill();
+        this.sessions.clear();
+    }
+}
+exports.TerminalManager = TerminalManager;
+//# sourceMappingURL=manager.js.map

package/dist/handlers/terminal/manager.js.map

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

package/dist/handlers/terminal/pty-session.d.ts

@@ -0,0 +1,17 @@
+import { Logger } from '../../logging/logger.js';
+/**
+ * 单个伪终端会话封装：node-pty spawn，输出转发为 terminal.data，退出转发 terminal.exit。
+ * 按 sessionId 索引，由 manager 维护。
+ */
+export interface PtyCallbacks {
+    onData: (data: string) => void;
+    onExit: (exitCode: number) => void;
+}
+export declare class PtySession {
+    private term;
+    private logger;
+    constructor(sessionId: string, cols: number, rows: number, cb: PtyCallbacks, logger: Logger);
+    write(data: string): void;
+    resize(cols: number, rows: number): void;
+    kill(): void;
+}

package/dist/handlers/terminal/pty-session.js

@@ -0,0 +1,76 @@
+"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.PtySession = void 0;
+const pty = __importStar(require("node-pty"));
+class PtySession {
+    term;
+    logger;
+    constructor(sessionId, cols, rows, cb, logger) {
+        this.logger = logger.child({ sessionId });
+        const shell = process.env.SHELL || (process.platform === 'win32' ? 'powershell.exe' : 'bash');
+        this.term = pty.spawn(shell, [], {
+            name: 'xterm-256color',
+            cols: Math.max(1, cols),
+            rows: Math.max(1, rows),
+            cwd: process.env.HOME || process.cwd(),
+            env: process.env,
+        });
+        this.term.onData((data) => cb.onData(data));
+        this.term.onExit(({ exitCode }) => cb.onExit(exitCode));
+        this.logger.info({ shell, cols, rows }, 'pty spawned');
+    }
+    write(data) {
+        this.term.write(data);
+    }
+    resize(cols, rows) {
+        try {
+            this.term.resize(Math.max(1, cols), Math.max(1, rows));
+        }
+        catch (err) {
+            this.logger.warn({ err: err instanceof Error ? err.message : String(err) }, 'pty resize failed');
+        }
+    }
+    kill() {
+        try {
+            this.term.kill();
+        }
+        catch {
+            // 已退出则忽略
+        }
+    }
+}
+exports.PtySession = PtySession;
+//# sourceMappingURL=pty-session.js.map

package/dist/handlers/terminal/pty-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-session.js","sourceRoot":"","sources":["../../../src/handlers/terminal/pty-session.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,8CAAgC;AAchC,MAAa,UAAU;IACb,IAAI,CAAW;IACf,MAAM,CAAS;IAEvB,YACE,SAAiB,EACjB,IAAY,EACZ,IAAY,EACZ,EAAgB,EAChB,MAAc;QAEd,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC9F,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,EAAE;YAC/B,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC;YACvB,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC;YACvB,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE;YACtC,GAAG,EAAE,OAAO,CAAC,GAA6B;SAC3C,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QACxD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,aAAa,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,IAAY;QAChB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,MAAM,CAAC,IAAY,EAAE,IAAY;QAC/B,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,mBAAmB,CAAC,CAAC;QACnG,CAAC;IACH,CAAC;IAED,IAAI;QACF,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;CACF;AA5CD,gCA4CC"}

package/dist/handlers/terminal/router.d.ts

@@ -0,0 +1,6 @@
+import { ServerToCliFrame } from '../../client/frames.js';
+import { TerminalManager } from './manager.js';
+/**
+ * 终端帧路由：terminal.open/input/resize/close → manager。
+ */
+export declare function handleTerminalFrame(frame: ServerToCliFrame, manager: TerminalManager): boolean;

package/dist/handlers/terminal/router.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleTerminalFrame = handleTerminalFrame;
+/**
+ * 终端帧路由：terminal.open/input/resize/close → manager。
+ */
+function handleTerminalFrame(frame, manager) {
+    switch (frame.type) {
+        case 'terminal.open':
+            manager.open(frame.sessionId, frame.cols, frame.rows);
+            return true;
+        case 'terminal.input':
+            manager.input(frame.sessionId, frame.data);
+            return true;
+        case 'terminal.resize':
+            manager.resize(frame.sessionId, frame.cols, frame.rows);
+            return true;
+        case 'terminal.close':
+            manager.close(frame.sessionId);
+            return true;
+        default:
+            return false; // 非终端帧
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/handlers/terminal/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../../src/handlers/terminal/router.ts"],"names":[],"mappings":";;AAYA,kDAoBC;AAvBD;;GAEG;AACH,SAAgB,mBAAmB,CACjC,KAAuB,EACvB,OAAwB;IAExB,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,eAAe;YAClB,OAAO,CAAC,IAAI,CAAE,KAA2B,CAAC,SAAS,EAAG,KAA2B,CAAC,IAAI,EAAG,KAA2B,CAAC,IAAI,CAAC,CAAC;YAC3H,OAAO,IAAI,CAAC;QACd,KAAK,gBAAgB;YACnB,OAAO,CAAC,KAAK,CAAE,KAA4B,CAAC,SAAS,EAAG,KAA4B,CAAC,IAAI,CAAC,CAAC;YAC3F,OAAO,IAAI,CAAC;QACd,KAAK,iBAAiB;YACpB,OAAO,CAAC,MAAM,CAAE,KAA6B,CAAC,SAAS,EAAG,KAA6B,CAAC,IAAI,EAAG,KAA6B,CAAC,IAAI,CAAC,CAAC;YACnI,OAAO,IAAI,CAAC;QACd,KAAK,gBAAgB;YACnB,OAAO,CAAC,KAAK,CAAE,KAA4B,CAAC,SAAS,CAAC,CAAC;YACvD,OAAO,IAAI,CAAC;QACd;YACE,OAAO,KAAK,CAAC,CAAC,OAAO;IACzB,CAAC;AACH,CAAC"}

package/dist/instance/id.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 生成实例 id：inst-YYYYMMDD-6位hex。
+ * 注意：不能用 Math.random()/Date.now()（运行时受限），用 crypto.randomBytes。
+ */
+export declare function generateInstanceId(): string;

package/dist/instance/id.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateInstanceId = generateInstanceId;
+const node_crypto_1 = require("node:crypto");
+/**
+ * 生成实例 id：inst-YYYYMMDD-6位hex。
+ * 注意：不能用 Math.random()/Date.now()（运行时受限），用 crypto.randomBytes。
+ */
+function generateInstanceId() {
+    const now = new Date();
+    const y = now.getUTCFullYear();
+    const m = String(now.getUTCMonth() + 1).padStart(2, '0');
+    const d = String(now.getUTCDate()).padStart(2, '0');
+    const hex = (0, node_crypto_1.randomBytes)(3).toString('hex'); // 6 位
+    return `inst-${y}${m}${d}-${hex}`;
+}
+//# sourceMappingURL=id.js.map

package/dist/instance/id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.js","sourceRoot":"","sources":["../../src/instance/id.ts"],"names":[],"mappings":";;AAMA,gDAOC;AAbD,6CAA0C;AAE1C;;;GAGG;AACH,SAAgB,kBAAkB;IAChC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,CAAC,GAAG,GAAG,CAAC,cAAc,EAAE,CAAC;IAC/B,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACzD,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,IAAA,yBAAW,EAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM;IAClD,OAAO,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;AACpC,CAAC"}

package/dist/instance/store.d.ts

@@ -0,0 +1,33 @@
+import { InstanceRecord, InstanceStatus, WsState } from './types.js';
+export declare function tokenHash(privateKey: string): string;
+export declare function loadInstance(id: string): InstanceRecord | null;
+export declare function saveInstance(rec: InstanceRecord): void;
+export declare function removeInstance(id: string): void;
+/** 列出所有实例状态记录 */
+export declare function listInstances(): InstanceRecord[];
+/** 更新实例部分字段 */
+export declare function updateInstance(id: string, patch: Partial<InstanceRecord>): InstanceRecord | null;
+export declare function setStatus(id: string, status: InstanceStatus, wsState?: WsState): void;
+/** 进程是否存活（kill 0 探测，不发信号） */
+export declare function isPidAlive(pid: number): boolean;
+/**
+ * 清理 PID 已死的残留记录——daemon 正常退出已自删，但崩溃（SIGKILL/段错误）
+ * 来不及自删时会留下 stale "running" 记录。此函数自愈：遍历全部记录，PID 死则删文件。
+ * 返回清理条数。
+ */
+export declare function purgeDeadInstances(): number;
+export interface KillResult {
+    /** 杀掉的实例记录，无则 null */
+    rec: InstanceRecord | null;
+    /** 是否成功终止 */
+    ok: boolean;
+    /** 说明（为何杀/结果） */
+    note: string;
+}
+/** 按 sandboxId 找到仍在运行的实例（PID 存活、status=running） */
+export declare function findRunningBySandboxId(sandboxId: string): InstanceRecord | null;
+/**
+ * 终止某实例进程并清理其记录。同步等待 SIGTERM，超时 SIGKILL（最多约 5s）。
+ * 用于「同 sandboxId 只允许一个进程」时，start 前杀掉旧实例。
+ */
+export declare function killInstance(id: string): Promise<KillResult>;