@jingyi0605/codingns 0.1.0

package/dist/server/modules/terminal/terminal-controller.js

@@ -0,0 +1,236 @@
+import { AppError } from "../../shared/errors/app-error.js";
+import { listTerminalShellOptions } from "./terminal-shell.js";
+export class TerminalController {
+    terminalService;
+    commandTemplateService;
+    constructor(terminalService, commandTemplateService) {
+        this.terminalService = terminalService;
+        this.commandTemplateService = commandTemplateService;
+    }
+    listTerminals = async (request, reply) => {
+        const workspaceId = request.query.workspaceId?.trim();
+        if (!workspaceId) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "INVALID_INPUT",
+                detail: "查询终端必须提供 workspaceId",
+                field: "workspaceId"
+            });
+        }
+        reply.send({
+            items: this.terminalService.listTerminals(workspaceId)
+        });
+    };
+    createTerminal = async (request, reply) => {
+        const workspaceId = request.body.workspaceId?.trim();
+        if (!workspaceId) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "INVALID_INPUT",
+                detail: "创建终端必须提供 workspaceId",
+                field: "workspaceId"
+            });
+        }
+        const terminal = this.terminalService.createTerminal({
+            workspaceId,
+            name: request.body.name?.trim(),
+            cwd: request.body.cwd?.trim(),
+            shell: request.body.shell?.trim(),
+            runtimeType: normalizeRuntimeType(request.body.runtimeType),
+            createdByUserId: request.auth.user.userId
+        });
+        reply.status(201).send(terminal);
+    };
+    listShellOptions = async (_request, reply) => {
+        reply.send({
+            items: listTerminalShellOptions()
+        });
+    };
+    closeTerminal = async (request, reply) => {
+        reply.send(this.terminalService.closeTerminal(request.params.terminalId));
+    };
+    deleteTerminal = async (request, reply) => {
+        reply.send(this.terminalService.deleteTerminal(request.params.terminalId));
+    };
+    readHistory = async (request, reply) => {
+        const beforeSeq = normalizeOptionalInteger(request.query.beforeSeq, "beforeSeq");
+        const limit = normalizePositiveInteger(request.query.limit, 20, 100, "limit");
+        reply.send(this.terminalService.readTerminalHistory(request.params.terminalId, beforeSeq, limit));
+    };
+    writeInput = async (request, reply) => {
+        const content = request.body.content;
+        if (typeof content !== "string") {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "INVALID_INPUT",
+                detail: "终端输入必须提供 content",
+                field: "content"
+            });
+        }
+        reply.send(this.terminalService.writeInput(request.params.terminalId, content));
+    };
+    listTemplates = async (request, reply) => {
+        const workspaceId = request.query.workspaceId?.trim();
+        if (!workspaceId) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "INVALID_INPUT",
+                detail: "查询命令模板必须提供 workspaceId",
+                field: "workspaceId"
+            });
+        }
+        reply.send({
+            items: this.commandTemplateService.listTemplates(workspaceId)
+        });
+    };
+    listTemplateRuntimeStatuses = async (request, reply) => {
+        const workspaceId = request.query.workspaceId?.trim();
+        if (!workspaceId) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "INVALID_INPUT",
+                detail: "查询命令模板运行状态必须提供 workspaceId",
+                field: "workspaceId"
+            });
+        }
+        reply.send({
+            items: await this.commandTemplateService.listTemplateRuntimeStatuses(workspaceId)
+        });
+    };
+    createTemplate = async (request, reply) => {
+        const workspaceId = request.body.workspaceId?.trim();
+        if (!workspaceId) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "INVALID_INPUT",
+                detail: "创建命令模板必须提供 workspaceId",
+                field: "workspaceId"
+            });
+        }
+        const template = this.commandTemplateService.createTemplate({
+            workspaceId,
+            name: request.body.name,
+            cwd: request.body.cwd,
+            command: request.body.command,
+            args: normalizeArgs(request.body.args),
+            env: request.body.env,
+            port: normalizePort(request.body.port),
+            runtimeType: normalizeRuntimeType(request.body.runtimeType)
+        });
+        reply.status(201).send(template);
+    };
+    updateTemplate = async (request, reply) => {
+        reply.send(this.commandTemplateService.updateTemplate(request.params.templateId, {
+            workspaceId: request.body.workspaceId,
+            name: request.body.name,
+            cwd: request.body.cwd,
+            command: request.body.command,
+            args: normalizeArgs(request.body.args),
+            env: request.body.env,
+            port: normalizePort(request.body.port),
+            runtimeType: normalizeRuntimeType(request.body.runtimeType)
+        }));
+    };
+    deleteTemplate = async (request, reply) => {
+        reply.send(this.commandTemplateService.deleteTemplate(request.params.templateId));
+    };
+    runTemplate = async (request, reply) => {
+        reply.send(this.commandTemplateService.runTemplate({
+            templateId: request.params.templateId,
+            terminalId: request.body.terminalId?.trim(),
+            shell: request.body.shell?.trim(),
+            runtimeType: normalizeRuntimeType(request.body.runtimeType),
+            userId: request.auth.user.userId
+        }));
+    };
+    stopTemplateRuntimeProcess = async (request, reply) => {
+        reply.send(await this.commandTemplateService.stopTemplateRuntimeProcess(request.params.templateId));
+    };
+}
+function normalizeArgs(input) {
+    if (!input) {
+        return [];
+    }
+    if (!Array.isArray(input) || input.some((item) => typeof item !== "string")) {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "INVALID_INPUT",
+            detail: "args 必须是字符串数组",
+            field: "args"
+        });
+    }
+    return input;
+}
+function normalizeRuntimeType(input) {
+    if (input === undefined) {
+        return undefined;
+    }
+    if (input === null) {
+        return null;
+    }
+    const value = input.trim();
+    if (!value) {
+        return null;
+    }
+    if (value === "embedded-pty" ||
+        value === "tmux" ||
+        value === "conpty-powershell" ||
+        value === "conpty-cmd" ||
+        value === "conpty-git-bash") {
+        return value;
+    }
+    throw new AppError({
+        statusCode: 400,
+        errorCode: "INVALID_INPUT",
+        detail: `不支持的终端 runtimeType：${value}`,
+        field: "runtimeType"
+    });
+}
+function normalizePort(input) {
+    if (input === undefined) {
+        return undefined;
+    }
+    if (input === null) {
+        return null;
+    }
+    if (!Number.isInteger(input)) {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "INVALID_INPUT",
+            detail: "port 必须是整数",
+            field: "port"
+        });
+    }
+    return input;
+}
+function normalizeOptionalInteger(input, field) {
+    if (input === undefined || input.trim() === "") {
+        return null;
+    }
+    const value = Number(input);
+    if (!Number.isInteger(value) || value <= 0) {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "INVALID_INPUT",
+            detail: `${field} 必须是正整数`,
+            field
+        });
+    }
+    return value;
+}
+function normalizePositiveInteger(input, fallback, max, field) {
+    if (input === undefined || input.trim() === "") {
+        return fallback;
+    }
+    const value = Number(input);
+    if (!Number.isInteger(value) || value <= 0) {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "INVALID_INPUT",
+            detail: `${field} 必须是正整数`,
+            field
+        });
+    }
+    return Math.min(value, max);
+}
+//# sourceMappingURL=terminal-controller.js.map

package/dist/server/modules/terminal/terminal-controller.js.map

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

package/dist/server/modules/terminal/terminal-history.d.ts

@@ -0,0 +1,18 @@
+export interface TerminalHistorySegmentDto {
+    id: string;
+    fileId: string;
+    startSeq: number;
+    endSeq: number;
+    content: string;
+    byteLength: number;
+    createdAt: string;
+}
+export interface TerminalHistoryPageDto {
+    terminalId: string;
+    content: string;
+    lineCount: number;
+    anchorLine: number;
+    replaceContent?: boolean;
+    hasMore: boolean;
+    nextBeforeSeq: number | null;
+}

package/dist/server/modules/terminal/terminal-history.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=terminal-history.js.map

package/dist/server/modules/terminal/terminal-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-history.js","sourceRoot":"","sources":["../../../../src/modules/terminal/terminal-history.ts"],"names":[],"mappings":""}

package/dist/server/modules/terminal/terminal-paths.d.ts

@@ -0,0 +1 @@
+export declare function resolveWorkspaceCwd(workspacePath: string, cwd?: string | null): string;

package/dist/server/modules/terminal/terminal-paths.js

@@ -0,0 +1,27 @@
+import path from "node:path";
+import { AppError } from "../../shared/errors/app-error.js";
+export function resolveWorkspaceCwd(workspacePath, cwd) {
+    const candidate = cwd?.trim() ? cwd.trim() : workspacePath;
+    const resolvedWorkspace = path.resolve(workspacePath);
+    const resolvedCandidate = path.resolve(candidate);
+    if (!isPathInsideWorkspace(resolvedWorkspace, resolvedCandidate)) {
+        throw new AppError({
+            statusCode: 400,
+            errorCode: "INVALID_CWD",
+            detail: "cwd 必须位于工作区目录内",
+            field: "cwd"
+        });
+    }
+    return resolvedCandidate;
+}
+function isPathInsideWorkspace(workspacePath, candidatePath) {
+    const normalizedWorkspace = normalizePathForCompare(workspacePath);
+    const normalizedCandidate = normalizePathForCompare(candidatePath);
+    const relativePath = path.relative(normalizedWorkspace, normalizedCandidate);
+    return relativePath === "" || (!relativePath.startsWith("..") && !path.isAbsolute(relativePath));
+}
+function normalizePathForCompare(input) {
+    const resolved = path.resolve(input);
+    return process.platform === "win32" ? resolved.toLowerCase() : resolved;
+}
+//# sourceMappingURL=terminal-paths.js.map

package/dist/server/modules/terminal/terminal-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-paths.js","sourceRoot":"","sources":["../../../../src/modules/terminal/terminal-paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAE5D,MAAM,UAAU,mBAAmB,CAAC,aAAqB,EAAE,GAAmB;IAC5E,MAAM,SAAS,GAAG,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC;IAC3D,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACtD,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAElD,IAAI,CAAC,qBAAqB,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,QAAQ,CAAC;YACjB,UAAU,EAAE,GAAG;YACf,SAAS,EAAE,aAAa;YACxB,MAAM,EAAE,gBAAgB;YACxB,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACL,CAAC;IAED,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,SAAS,qBAAqB,CAAC,aAAqB,EAAE,aAAqB;IACzE,MAAM,mBAAmB,GAAG,uBAAuB,CAAC,aAAa,CAAC,CAAC;IACnE,MAAM,mBAAmB,GAAG,uBAAuB,CAAC,aAAa,CAAC,CAAC;IACnE,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAC,CAAC;IAE7E,OAAO,YAAY,KAAK,EAAE,IAAI,CAAC,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC;AACnG,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAa;IAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACrC,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC1E,CAAC"}

package/dist/server/modules/terminal/terminal-service.d.ts

@@ -0,0 +1,112 @@
+import { EventEmitter } from "node:events";
+import type Database from "better-sqlite3";
+import type { TerminalInstance, TerminalOutputChunk, TerminalRuntimeSession, TerminalRuntimeType } from "../../types/domain.js";
+import type { TerminalInstanceRepository } from "../../storage/repositories/terminal-instance-repository.js";
+import type { TerminalLogFileRepository } from "../../storage/repositories/terminal-log-file-repository.js";
+import type { TerminalLogSegmentRepository } from "../../storage/repositories/terminal-log-segment-repository.js";
+import type { TerminalRuntimeSessionRepository } from "../../storage/repositories/terminal-runtime-session-repository.js";
+import type { WorkspaceService } from "../workspace/workspace-service.js";
+import type { TerminalHistoryPageDto } from "./terminal-history.js";
+import { type TerminalBackfillResult } from "./runtime/terminal-output-buffer.js";
+interface CreateTerminalInput {
+    workspaceId: string;
+    name?: string;
+    cwd?: string | null;
+    shell?: string | null;
+    runtimeType?: TerminalRuntimeType | null;
+    createdByUserId: string;
+    env?: Record<string, string>;
+}
+interface SubscribeTerminalCallbacks {
+    onBackfill: (payload: TerminalBackfillResult) => Promise<void> | void;
+    onOutput: (chunk: TerminalOutputChunk) => Promise<void> | void;
+    onStatus: (terminal: TerminalInstance) => Promise<void> | void;
+    onExit: (payload: {
+        terminal: TerminalInstance;
+        requestedClose: boolean;
+    }) => Promise<void> | void;
+}
+type TerminalCloseReason = "user_closed" | "idle_timeout";
+interface TerminalServiceOptions {
+    terminalLogRootDir?: string;
+    terminalLogFileRepository?: TerminalLogFileRepository;
+    terminalLogSegmentRepository?: TerminalLogSegmentRepository;
+}
+export declare interface TerminalService {
+    on(event: "output", listener: (event: {
+        terminalId: string;
+        chunks: TerminalOutputChunk[];
+    }) => void): this;
+    on(event: "status", listener: (terminal: TerminalInstance) => void): this;
+    on(event: "exit", listener: (event: {
+        terminal: TerminalInstance;
+        requestedClose: boolean;
+    }) => void): this;
+    emit(event: "output", eventPayload: {
+        terminalId: string;
+        chunks: TerminalOutputChunk[];
+    }): boolean;
+    emit(event: "status", terminal: TerminalInstance): boolean;
+    emit(event: "exit", eventPayload: {
+        terminal: TerminalInstance;
+        requestedClose: boolean;
+    }): boolean;
+}
+export declare class TerminalService extends EventEmitter {
+    private readonly db;
+    private readonly terminalInstanceRepository;
+    private readonly terminalRuntimeSessionRepository;
+    private readonly workspaceService;
+    private readonly outputBuffer;
+    private readonly runtimeManager;
+    private readonly lastPersistedActivity;
+    private readonly terminalSubscriptionCounts;
+    private readonly pendingCloseReasons;
+    private readonly pendingDeletedTerminalIds;
+    private readonly terminalLogSpooler;
+    private readonly terminalLogFileRepository;
+    private readonly terminalLogSegmentRepository;
+    private readonly terminalLogFileStore;
+    private isDisposing;
+    constructor(db: Database.Database, terminalInstanceRepository: TerminalInstanceRepository, terminalRuntimeSessionRepository: TerminalRuntimeSessionRepository, workspaceService: WorkspaceService, _idleTimeoutSeconds: number, options?: TerminalServiceOptions);
+    createTerminal(input: CreateTerminalInput): TerminalInstance;
+    listTerminals(workspaceId: string): TerminalInstance[];
+    getTerminalOrThrow(terminalId: string): TerminalInstance;
+    getRuntimeSessionOrThrow(runtimeSessionId: string): TerminalRuntimeSession;
+    closeTerminal(terminalId: string, reason?: TerminalCloseReason): {
+        success: true;
+    };
+    deleteTerminal(terminalId: string): {
+        success: true;
+    };
+    writeInput(terminalId: string, content: string): {
+        accepted: true;
+    };
+    resizeTerminal(terminalId: string, cols: number, rows: number): {
+        accepted: true;
+    };
+    subscribeTerminal(terminalId: string, lastCursor: string | null, callbacks: SubscribeTerminalCallbacks): {
+        close(): void;
+    };
+    dispose(): Promise<void>;
+    readTerminalHistory(terminalId: string, beforeSeq: number | null, limit: number): TerminalHistoryPageDto;
+    private readTerminalHistorySegments;
+    private handleRuntimeOutput;
+    private handleRuntimeExit;
+    private touchLastActiveAt;
+    private ensureTerminalInteractive;
+    private ensureTerminalAttachedForSubscription;
+    private ensureTerminalRunning;
+    private reconcileTerminalRuntime;
+    private markTerminalRunning;
+    private markTerminalLost;
+    private markTerminalError;
+    private finalizeTerminalClosure;
+    private recoverRuntimeStates;
+    private retainTerminalSubscription;
+    private releaseTerminalSubscription;
+    private detachRuntimeAttachmentIfIdle;
+    private flushTerminalLogs;
+    private clearTerminalLogs;
+}
+export {};