@jingyi0605/codingns 0.1.0

package/dist/server/modules/terminal/runtime/pty-host-attachment-manager.js

@@ -0,0 +1,141 @@
+import { accessSync, chmodSync, constants, existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { EventEmitter } from "node:events";
+import { spawn } from "node-pty";
+import { AppError } from "../../../shared/errors/app-error.js";
+const require = createRequire(import.meta.url);
+let hasEnsuredPtySpawnHelper = false;
+export class PtyHostAttachmentManager extends EventEmitter {
+    attachments = new Map();
+    requestedClose = new Set();
+    start(attachmentId, input) {
+        try {
+            ensurePtySpawnHelperExecutable();
+            const ptyProcess = spawn(input.command, input.args, {
+                cols: input.cols ?? 120,
+                rows: input.rows ?? 30,
+                cwd: input.cwd,
+                env: input.env,
+                name: "xterm-color"
+            });
+            const processId = normalizeProcessId(ptyProcess.pid);
+            this.attachments.set(attachmentId, {
+                pty: ptyProcess,
+                processId
+            });
+            ptyProcess.onData((content) => {
+                this.emit("output", {
+                    attachmentId,
+                    content
+                });
+            });
+            ptyProcess.onExit((event) => {
+                this.attachments.delete(attachmentId);
+                const requestedClose = this.requestedClose.delete(attachmentId);
+                this.emit("exit", {
+                    attachmentId,
+                    exitCode: event.exitCode ?? null,
+                    requestedClose
+                });
+            });
+            return processId;
+        }
+        catch (error) {
+            throw new AppError({
+                statusCode: 502,
+                errorCode: "PTY_START_FAILED",
+                detail: error instanceof Error ? error.message : "PTY 启动失败"
+            });
+        }
+    }
+    write(attachmentId, content) {
+        const runtime = this.attachments.get(attachmentId);
+        if (!runtime) {
+            throw new AppError({
+                statusCode: 409,
+                errorCode: "TERMINAL_NOT_RUNNING",
+                detail: "终端当前不可写入"
+            });
+        }
+        runtime.pty.write(content);
+    }
+    resize(attachmentId, cols, rows) {
+        const runtime = this.attachments.get(attachmentId);
+        if (!runtime) {
+            throw new AppError({
+                statusCode: 409,
+                errorCode: "TERMINAL_NOT_RUNNING",
+                detail: "终端当前不可调整尺寸"
+            });
+        }
+        runtime.pty.resize(cols, rows);
+    }
+    close(attachmentId) {
+        const runtime = this.attachments.get(attachmentId);
+        if (!runtime) {
+            return;
+        }
+        this.requestedClose.add(attachmentId);
+        runtime.pty.kill();
+    }
+    isRunning(attachmentId) {
+        return this.attachments.has(attachmentId);
+    }
+    getProcessId(attachmentId) {
+        return this.attachments.get(attachmentId)?.processId ?? null;
+    }
+    closeAll() {
+        for (const attachmentId of this.attachments.keys()) {
+            this.close(attachmentId);
+        }
+    }
+}
+function normalizeProcessId(processId) {
+    if (typeof processId !== "number" || !Number.isInteger(processId) || processId <= 0) {
+        return null;
+    }
+    return processId;
+}
+function ensurePtySpawnHelperExecutable() {
+    if (hasEnsuredPtySpawnHelper || process.platform !== "darwin") {
+        return;
+    }
+    const helperPath = resolvePtySpawnHelperPath();
+    if (!helperPath) {
+        hasEnsuredPtySpawnHelper = true;
+        return;
+    }
+    try {
+        accessSync(helperPath, constants.X_OK);
+        hasEnsuredPtySpawnHelper = true;
+        return;
+    }
+    catch {
+        // 文件存在但不可执行时，自动修复权限。
+    }
+    try {
+        chmodSync(helperPath, 0o755);
+        hasEnsuredPtySpawnHelper = true;
+    }
+    catch (error) {
+        throw new AppError({
+            statusCode: 502,
+            errorCode: "PTY_START_FAILED",
+            detail: error instanceof Error
+                ? `node-pty spawn-helper 权限修复失败: ${error.message}`
+                : "node-pty spawn-helper 权限修复失败"
+        });
+    }
+}
+function resolvePtySpawnHelperPath() {
+    try {
+        const packageJsonPath = require.resolve("node-pty/package.json");
+        const helperPath = path.join(path.dirname(packageJsonPath), "prebuilds", `${process.platform}-${process.arch}`, "spawn-helper");
+        return existsSync(helperPath) ? helperPath : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=pty-host-attachment-manager.js.map

package/dist/server/modules/terminal/runtime/pty-host-attachment-manager.js.map

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

package/dist/server/modules/terminal/runtime/pty-runtime-manager.d.ts

@@ -0,0 +1,29 @@
+import { EventEmitter } from "node:events";
+import type { TerminalInstance } from "../../../types/domain.js";
+export interface TerminalRuntimeExitEvent {
+    terminalId: string;
+    exitCode: number | null;
+    requestedClose: boolean;
+}
+export declare interface PtyRuntimeManager {
+    on(event: "output", listener: (event: {
+        terminalId: string;
+        content: string;
+    }) => void): this;
+    on(event: "exit", listener: (event: TerminalRuntimeExitEvent) => void): this;
+    emit(event: "output", eventPayload: {
+        terminalId: string;
+        content: string;
+    }): boolean;
+    emit(event: "exit", eventPayload: TerminalRuntimeExitEvent): boolean;
+}
+export declare class PtyRuntimeManager extends EventEmitter {
+    private readonly runtimes;
+    private readonly requestedClose;
+    start(terminal: TerminalInstance, env: Record<string, string>): number | null;
+    write(terminalId: string, content: string): void;
+    resize(terminalId: string, cols: number, rows: number): void;
+    close(terminalId: string): void;
+    isRunning(terminalId: string): boolean;
+    closeAll(): void;
+}

package/dist/server/modules/terminal/runtime/pty-runtime-manager.js

@@ -0,0 +1,138 @@
+import { accessSync, chmodSync, constants, existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { EventEmitter } from "node:events";
+import { spawn } from "node-pty";
+import { AppError } from "../../../shared/errors/app-error.js";
+const require = createRequire(import.meta.url);
+let hasEnsuredPtySpawnHelper = false;
+export class PtyRuntimeManager extends EventEmitter {
+    runtimes = new Map();
+    requestedClose = new Set();
+    start(terminal, env) {
+        try {
+            ensurePtySpawnHelperExecutable();
+            const ptyProcess = spawn(terminal.shell, [], {
+                cols: 120,
+                rows: 30,
+                cwd: terminal.cwd,
+                env,
+                name: "xterm-color"
+            });
+            const processId = normalizeProcessId(ptyProcess.pid);
+            this.runtimes.set(terminal.id, {
+                pty: ptyProcess,
+                processId
+            });
+            ptyProcess.onData((content) => {
+                this.emit("output", {
+                    terminalId: terminal.id,
+                    content
+                });
+            });
+            ptyProcess.onExit((event) => {
+                this.runtimes.delete(terminal.id);
+                const requestedClose = this.requestedClose.delete(terminal.id);
+                this.emit("exit", {
+                    terminalId: terminal.id,
+                    exitCode: event.exitCode ?? null,
+                    requestedClose
+                });
+            });
+            return processId;
+        }
+        catch (error) {
+            throw new AppError({
+                statusCode: 502,
+                errorCode: "PTY_START_FAILED",
+                detail: error instanceof Error ? error.message : "PTY 启动失败"
+            });
+        }
+    }
+    write(terminalId, content) {
+        const runtime = this.runtimes.get(terminalId);
+        if (!runtime) {
+            throw new AppError({
+                statusCode: 409,
+                errorCode: "TERMINAL_NOT_RUNNING",
+                detail: "终端当前不可写入"
+            });
+        }
+        runtime.pty.write(content);
+    }
+    resize(terminalId, cols, rows) {
+        const runtime = this.runtimes.get(terminalId);
+        if (!runtime) {
+            throw new AppError({
+                statusCode: 409,
+                errorCode: "TERMINAL_NOT_RUNNING",
+                detail: "终端当前不可调整尺寸"
+            });
+        }
+        runtime.pty.resize(cols, rows);
+    }
+    close(terminalId) {
+        const runtime = this.runtimes.get(terminalId);
+        if (!runtime) {
+            return;
+        }
+        this.requestedClose.add(terminalId);
+        runtime.pty.kill();
+    }
+    isRunning(terminalId) {
+        return this.runtimes.has(terminalId);
+    }
+    closeAll() {
+        for (const terminalId of this.runtimes.keys()) {
+            this.close(terminalId);
+        }
+    }
+}
+function normalizeProcessId(processId) {
+    if (typeof processId !== "number" || !Number.isInteger(processId) || processId <= 0) {
+        return null;
+    }
+    return processId;
+}
+function ensurePtySpawnHelperExecutable() {
+    if (hasEnsuredPtySpawnHelper || process.platform !== "darwin") {
+        return;
+    }
+    const helperPath = resolvePtySpawnHelperPath();
+    if (!helperPath) {
+        hasEnsuredPtySpawnHelper = true;
+        return;
+    }
+    try {
+        accessSync(helperPath, constants.X_OK);
+        hasEnsuredPtySpawnHelper = true;
+        return;
+    }
+    catch {
+        // 文件存在但不可执行时，自动修复权限。
+    }
+    try {
+        chmodSync(helperPath, 0o755);
+        hasEnsuredPtySpawnHelper = true;
+    }
+    catch (error) {
+        throw new AppError({
+            statusCode: 502,
+            errorCode: "PTY_START_FAILED",
+            detail: error instanceof Error
+                ? `node-pty spawn-helper 权限修复失败: ${error.message}`
+                : "node-pty spawn-helper 权限修复失败"
+        });
+    }
+}
+function resolvePtySpawnHelperPath() {
+    try {
+        const packageJsonPath = require.resolve("node-pty/package.json");
+        const helperPath = path.join(path.dirname(packageJsonPath), "prebuilds", `${process.platform}-${process.arch}`, "spawn-helper");
+        return existsSync(helperPath) ? helperPath : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=pty-runtime-manager.js.map

package/dist/server/modules/terminal/runtime/pty-runtime-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pty-runtime-manager.js","sourceRoot":"","sources":["../../../../../src/modules/terminal/runtime/pty-runtime-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,KAAK,EAAa,MAAM,UAAU,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAG/D,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,IAAI,wBAAwB,GAAG,KAAK,CAAC;AAoBrC,MAAM,OAAO,iBAAkB,SAAQ,YAAY;IAChC,QAAQ,GAAG,IAAI,GAAG,EAAiC,CAAC;IACpD,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IAEpD,KAAK,CAAC,QAA0B,EAAE,GAA2B;QAC3D,IAAI,CAAC;YACH,8BAA8B,EAAE,CAAC;YAEjC,MAAM,UAAU,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,EAAE;gBAC3C,IAAI,EAAE,GAAG;gBACT,IAAI,EAAE,EAAE;gBACR,GAAG,EAAE,QAAQ,CAAC,GAAG;gBACjB,GAAG;gBACH,IAAI,EAAE,aAAa;aACpB,CAAC,CAAC;YAEH,MAAM,SAAS,GAAG,kBAAkB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACrD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE;gBAC7B,GAAG,EAAE,UAAU;gBACf,SAAS;aACV,CAAC,CAAC;YAEH,UAAU,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC5B,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE;oBAClB,UAAU,EAAE,QAAQ,CAAC,EAAE;oBACvB,OAAO;iBACR,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;gBAC1B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBAClC,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBAE/D,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;oBAChB,UAAU,EAAE,QAAQ,CAAC,EAAE;oBACvB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,IAAI;oBAChC,cAAc;iBACf,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,QAAQ,CAAC;gBACjB,UAAU,EAAE,GAAG;gBACf,SAAS,EAAE,kBAAkB;gBAC7B,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU;aAC5D,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAkB,EAAE,OAAe;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAE9C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,QAAQ,CAAC;gBACjB,UAAU,EAAE,GAAG;gBACf,SAAS,EAAE,sBAAsB;gBACjC,MAAM,EAAE,UAAU;aACnB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,UAAkB,EAAE,IAAY,EAAE,IAAY;QACnD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAE9C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,QAAQ,CAAC;gBACjB,UAAU,EAAE,GAAG;gBACf,SAAS,EAAE,sBAAsB;gBACjC,MAAM,EAAE,YAAY;aACrB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,UAAkB;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAE9C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IAED,SAAS,CAAC,UAAkB;QAC1B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC;IAED,QAAQ;QACN,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;YAC9C,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;CACF;AAED,SAAS,kBAAkB,CAAC,SAA6B;IACvD,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACpF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,8BAA8B;IACrC,IAAI,wBAAwB,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9D,OAAO;IACT,CAAC;IAED,MAAM,UAAU,GAAG,yBAAyB,EAAE,CAAC;IAE/C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,wBAAwB,GAAG,IAAI,CAAC;QAChC,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,UAAU,CAAC,UAAU,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACvC,wBAAwB,GAAG,IAAI,CAAC;QAChC,OAAO;IACT,CAAC;IAAC,MAAM,CAAC;QACP,qBAAqB;IACvB,CAAC;IAED,IAAI,CAAC;QACH,SAAS,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAC7B,wBAAwB,GAAG,IAAI,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,QAAQ,CAAC;YACjB,UAAU,EAAE,GAAG;YACf,SAAS,EAAE,kBAAkB;YAC7B,MAAM,EACJ,KAAK,YAAY,KAAK;gBACpB,CAAC,CAAC,iCAAiC,KAAK,CAAC,OAAO,EAAE;gBAClD,CAAC,CAAC,8BAA8B;SACrC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,yBAAyB;IAChC,IAAI,CAAC;QACH,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC;QACjE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAC1B,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,EAC7B,WAAW,EACX,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,EACrC,cAAc,CACf,CAAC;QAEF,OAAO,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/server/modules/terminal/runtime/terminal-log-file-store.d.ts

@@ -0,0 +1,14 @@
+export interface TerminalLogAppendResult {
+    startOffset: number;
+    endOffset: number;
+    byteLength: number;
+}
+export declare class TerminalLogFileStore {
+    private readonly rootDir;
+    constructor(rootDir: string);
+    append(relativePath: string, content: string, currentSizeBytes: number): TerminalLogAppendResult;
+    deleteTerminalLogs(terminalId: string): void;
+    read(relativePath: string, startOffset: number, byteLength: number): string;
+    buildActiveRelativePath(terminalId: string): string;
+    private resolvePath;
+}

package/dist/server/modules/terminal/runtime/terminal-log-file-store.js

@@ -0,0 +1,47 @@
+import { appendFileSync, closeSync, mkdirSync, openSync, readSync, rmSync } from "node:fs";
+import path from "node:path";
+export class TerminalLogFileStore {
+    rootDir;
+    constructor(rootDir) {
+        this.rootDir = rootDir;
+    }
+    append(relativePath, content, currentSizeBytes) {
+        const filePath = this.resolvePath(relativePath);
+        mkdirSync(path.dirname(filePath), { recursive: true });
+        appendFileSync(filePath, content, "utf8");
+        const byteLength = Buffer.byteLength(content, "utf8");
+        return {
+            startOffset: currentSizeBytes,
+            endOffset: currentSizeBytes + byteLength,
+            byteLength
+        };
+    }
+    deleteTerminalLogs(terminalId) {
+        const terminalDir = this.resolvePath(terminalId);
+        rmSync(terminalDir, { recursive: true, force: true });
+    }
+    read(relativePath, startOffset, byteLength) {
+        const filePath = this.resolvePath(relativePath);
+        const fd = openSync(filePath, "r");
+        const buffer = Buffer.alloc(byteLength);
+        try {
+            readSync(fd, buffer, 0, byteLength, startOffset);
+        }
+        finally {
+            closeSync(fd);
+        }
+        return buffer.toString("utf8");
+    }
+    buildActiveRelativePath(terminalId) {
+        return path.join(terminalId, "active.log");
+    }
+    resolvePath(relativePath) {
+        const resolvedRoot = path.resolve(this.rootDir);
+        const resolvedPath = path.resolve(resolvedRoot, relativePath);
+        if (resolvedPath !== resolvedRoot && !resolvedPath.startsWith(`${resolvedRoot}${path.sep}`)) {
+            throw new Error(`Invalid terminal log path: ${relativePath}`);
+        }
+        return resolvedPath;
+    }
+}
+//# sourceMappingURL=terminal-log-file-store.js.map

package/dist/server/modules/terminal/runtime/terminal-log-file-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-log-file-store.js","sourceRoot":"","sources":["../../../../../src/modules/terminal/runtime/terminal-log-file-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC3F,OAAO,IAAI,MAAM,WAAW,CAAC;AAQ7B,MAAM,OAAO,oBAAoB;IACF;IAA7B,YAA6B,OAAe;QAAf,YAAO,GAAP,OAAO,CAAQ;IAAG,CAAC;IAEhD,MAAM,CAAC,YAAoB,EAAE,OAAe,EAAE,gBAAwB;QACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QAEhD,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAE1C,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAEtD,OAAO;YACL,WAAW,EAAE,gBAAgB;YAC7B,SAAS,EAAE,gBAAgB,GAAG,UAAU;YACxC,UAAU;SACX,CAAC;IACJ,CAAC;IAED,kBAAkB,CAAC,UAAkB;QACnC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QACjD,MAAM,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,CAAC,YAAoB,EAAE,WAAmB,EAAE,UAAkB;QAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;QAChD,MAAM,EAAE,GAAG,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAExC,IAAI,CAAC;YACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;QACnD,CAAC;gBAAS,CAAC;YACT,SAAS,CAAC,EAAE,CAAC,CAAC;QAChB,CAAC;QAED,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,uBAAuB,CAAC,UAAkB;QACxC,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAC7C,CAAC;IAEO,WAAW,CAAC,YAAoB;QACtC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QAE9D,IAAI,YAAY,KAAK,YAAY,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;YAC5F,MAAM,IAAI,KAAK,CAAC,8BAA8B,YAAY,EAAE,CAAC,CAAC;QAChE,CAAC;QAED,OAAO,YAAY,CAAC;IACtB,CAAC;CACF"}

package/dist/server/modules/terminal/runtime/terminal-log-spooler.d.ts

@@ -0,0 +1,28 @@
+import type { TerminalOutputChunk } from "../../../types/domain.js";
+import type { TerminalLogFileRepository } from "../../../storage/repositories/terminal-log-file-repository.js";
+import type { TerminalLogSegmentRepository } from "../../../storage/repositories/terminal-log-segment-repository.js";
+interface TerminalLogSpoolerOptions {
+    logRootDir: string;
+    fileRepository: TerminalLogFileRepository;
+    segmentRepository: TerminalLogSegmentRepository;
+    flushIntervalMs?: number;
+    maxBatchBytes?: number;
+}
+export declare class TerminalLogSpooler {
+    private readonly options;
+    private readonly fileStore;
+    private readonly pendingByTerminalId;
+    private readonly flushIntervalMs;
+    private readonly maxBatchBytes;
+    constructor(options: TerminalLogSpoolerOptions);
+    appendChunks(terminalId: string, chunks: TerminalOutputChunk[]): void;
+    flushTerminal(terminalId: string): void;
+    flushAll(): void;
+    clearTerminal(terminalId: string): void;
+    deleteTerminalLogs(terminalId: string): void;
+    private persistChunks;
+    private getOrCreateBatch;
+    private scheduleFlush;
+    private clearBatchTimer;
+}
+export {};

package/dist/server/modules/terminal/runtime/terminal-log-spooler.js

@@ -0,0 +1,162 @@
+import { createId } from "../../../shared/utils/id.js";
+import { nowIso } from "../../../shared/utils/time.js";
+import { TerminalLogFileStore } from "./terminal-log-file-store.js";
+const DEFAULT_FLUSH_INTERVAL_MS = 500;
+const DEFAULT_MAX_BATCH_BYTES = 32 * 1024;
+export class TerminalLogSpooler {
+    options;
+    fileStore;
+    pendingByTerminalId = new Map();
+    flushIntervalMs;
+    maxBatchBytes;
+    constructor(options) {
+        this.options = options;
+        this.fileStore = new TerminalLogFileStore(options.logRootDir);
+        this.flushIntervalMs = options.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS;
+        this.maxBatchBytes = options.maxBatchBytes ?? DEFAULT_MAX_BATCH_BYTES;
+    }
+    appendChunks(terminalId, chunks) {
+        if (chunks.length === 0) {
+            return;
+        }
+        const batch = this.getOrCreateBatch(terminalId);
+        for (const chunk of chunks) {
+            batch.chunks.push(chunk);
+            batch.totalBytes += Buffer.byteLength(chunk.content, "utf8");
+        }
+        if (batch.flushing) {
+            return;
+        }
+        this.scheduleFlush(terminalId, batch.totalBytes >= this.maxBatchBytes ? 0 : this.flushIntervalMs);
+    }
+    flushTerminal(terminalId) {
+        const batch = this.pendingByTerminalId.get(terminalId);
+        if (!batch || batch.flushing || batch.chunks.length === 0) {
+            return;
+        }
+        this.clearBatchTimer(batch);
+        batch.flushing = true;
+        const flushingChunks = batch.chunks;
+        const flushingBytes = batch.totalBytes;
+        batch.chunks = [];
+        batch.totalBytes = 0;
+        try {
+            this.persistChunks(terminalId, flushingChunks);
+        }
+        catch (error) {
+            batch.chunks = [...flushingChunks, ...batch.chunks];
+            batch.totalBytes += flushingBytes;
+            console.warn("[terminal-log-flush-failed]", {
+                terminalId,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            this.scheduleFlush(terminalId, this.flushIntervalMs);
+        }
+        finally {
+            batch.flushing = false;
+            if (batch.chunks.length > 0) {
+                this.scheduleFlush(terminalId, batch.totalBytes >= this.maxBatchBytes ? 0 : this.flushIntervalMs);
+            }
+            else if (!batch.timer) {
+                this.pendingByTerminalId.delete(terminalId);
+            }
+        }
+    }
+    flushAll() {
+        for (const terminalId of [...this.pendingByTerminalId.keys()]) {
+            this.flushTerminal(terminalId);
+        }
+    }
+    clearTerminal(terminalId) {
+        const batch = this.pendingByTerminalId.get(terminalId);
+        if (!batch) {
+            return;
+        }
+        this.clearBatchTimer(batch);
+        this.pendingByTerminalId.delete(terminalId);
+    }
+    deleteTerminalLogs(terminalId) {
+        this.clearTerminal(terminalId);
+        this.fileStore.deleteTerminalLogs(terminalId);
+    }
+    persistChunks(terminalId, chunks) {
+        const startSeq = parseCursor(chunks[0]?.cursor);
+        const endSeq = parseCursor(chunks.at(-1)?.cursor);
+        if (startSeq === null || endSeq === null) {
+            throw new Error("终端日志分段缺少有效 cursor");
+        }
+        const content = chunks.map((chunk) => chunk.content).join("");
+        const timestamp = nowIso();
+        let activeFile = this.options.fileRepository.findActiveByTerminalId(terminalId);
+        if (!activeFile) {
+            activeFile = this.options.fileRepository.create({
+                id: createId(),
+                terminalId,
+                relativePath: this.fileStore.buildActiveRelativePath(terminalId),
+                status: "active",
+                startSeq,
+                endSeq: null,
+                sizeBytes: 0,
+                createdAt: timestamp,
+                updatedAt: timestamp
+            });
+        }
+        const appendResult = this.fileStore.append(activeFile.relativePath, content, activeFile.sizeBytes);
+        this.options.segmentRepository.create({
+            id: createId(),
+            terminalId,
+            fileId: activeFile.id,
+            startSeq,
+            endSeq,
+            startOffset: appendResult.startOffset,
+            endOffset: appendResult.endOffset,
+            byteLength: appendResult.byteLength,
+            createdAt: timestamp
+        });
+        this.options.fileRepository.updateLifecycle({
+            id: activeFile.id,
+            status: activeFile.status,
+            endSeq,
+            sizeBytes: appendResult.endOffset,
+            updatedAt: timestamp
+        });
+    }
+    getOrCreateBatch(terminalId) {
+        let batch = this.pendingByTerminalId.get(terminalId);
+        if (!batch) {
+            batch = {
+                chunks: [],
+                totalBytes: 0,
+                timer: null,
+                flushing: false
+            };
+            this.pendingByTerminalId.set(terminalId, batch);
+        }
+        return batch;
+    }
+    scheduleFlush(terminalId, delayMs) {
+        const batch = this.pendingByTerminalId.get(terminalId);
+        if (!batch) {
+            return;
+        }
+        this.clearBatchTimer(batch);
+        batch.timer = setTimeout(() => {
+            batch.timer = null;
+            this.flushTerminal(terminalId);
+        }, Math.max(0, delayMs));
+    }
+    clearBatchTimer(batch) {
+        if (batch.timer) {
+            clearTimeout(batch.timer);
+            batch.timer = null;
+        }
+    }
+}
+function parseCursor(cursor) {
+    const value = Number(cursor);
+    if (!Number.isInteger(value) || value <= 0) {
+        return null;
+    }
+    return value;
+}
+//# sourceMappingURL=terminal-log-spooler.js.map

package/dist/server/modules/terminal/runtime/terminal-log-spooler.js.map

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

package/dist/server/modules/terminal/runtime/terminal-output-buffer.d.ts

@@ -0,0 +1,18 @@
+import type { TerminalOutputChunk } from "../../../types/domain.js";
+export interface TerminalBackfillResult {
+    chunks: TerminalOutputChunk[];
+    truncated: boolean;
+    cursorReset: boolean;
+    latestCursor: string | null;
+}
+export declare class TerminalOutputBuffer {
+    private readonly maxChunks;
+    private readonly maxBytes;
+    private readonly maxChunkSize;
+    private readonly buffers;
+    constructor(maxChunks?: number, maxBytes?: number, maxChunkSize?: number);
+    append(terminalId: string, content: string): TerminalOutputChunk[];
+    readSince(terminalId: string, cursor: string | null): TerminalBackfillResult;
+    clear(terminalId: string): void;
+    private getOrCreateBuffer;
+}