@jingyi0605/codingns 0.1.0

package/dist/server/modules/terminal/runtime/terminal-output-buffer.js

@@ -0,0 +1,109 @@
+import { AppError } from "../../../shared/errors/app-error.js";
+import { nowIso } from "../../../shared/utils/time.js";
+export class TerminalOutputBuffer {
+    maxChunks;
+    maxBytes;
+    maxChunkSize;
+    buffers = new Map();
+    constructor(maxChunks = 400, maxBytes = 256 * 1024, maxChunkSize = 8 * 1024) {
+        this.maxChunks = maxChunks;
+        this.maxBytes = maxBytes;
+        this.maxChunkSize = maxChunkSize;
+    }
+    append(terminalId, content) {
+        if (!content) {
+            return [];
+        }
+        const buffer = this.getOrCreateBuffer(terminalId);
+        const chunks = [];
+        for (let index = 0; index < content.length; index += this.maxChunkSize) {
+            const chunk = {
+                terminalId,
+                cursor: String(buffer.nextCursor),
+                stream: "stdout",
+                content: content.slice(index, index + this.maxChunkSize),
+                timestamp: nowIso()
+            };
+            buffer.nextCursor += 1;
+            buffer.chunks.push(chunk);
+            buffer.totalBytes += Buffer.byteLength(chunk.content, "utf8");
+            chunks.push(chunk);
+        }
+        while (buffer.chunks.length > this.maxChunks || buffer.totalBytes > this.maxBytes) {
+            const removed = buffer.chunks.shift();
+            if (!removed) {
+                break;
+            }
+            buffer.totalBytes -= Buffer.byteLength(removed.content, "utf8");
+        }
+        return chunks;
+    }
+    readSince(terminalId, cursor) {
+        const buffer = this.buffers.get(terminalId);
+        if (!buffer || buffer.chunks.length === 0) {
+            return {
+                chunks: [],
+                truncated: false,
+                cursorReset: false,
+                latestCursor: null
+            };
+        }
+        if (cursor === null) {
+            return {
+                chunks: [...buffer.chunks],
+                truncated: false,
+                cursorReset: false,
+                latestCursor: buffer.chunks.at(-1)?.cursor ?? null
+            };
+        }
+        const parsedCursor = Number(cursor);
+        if (!Number.isInteger(parsedCursor) || parsedCursor < 0) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "RECONNECT_CURSOR_INVALID",
+                detail: "重连游标无效",
+                field: "lastCursor"
+            });
+        }
+        const earliestCursor = Number(buffer.chunks[0]?.cursor ?? "0");
+        const latestCursor = Number(buffer.chunks.at(-1)?.cursor ?? "0");
+        if (parsedCursor > latestCursor) {
+            return {
+                chunks: [...buffer.chunks],
+                truncated: true,
+                cursorReset: true,
+                latestCursor: String(latestCursor)
+            };
+        }
+        if (parsedCursor < earliestCursor - 1) {
+            return {
+                chunks: [...buffer.chunks],
+                truncated: true,
+                cursorReset: false,
+                latestCursor: String(latestCursor)
+            };
+        }
+        return {
+            chunks: buffer.chunks.filter((chunk) => Number(chunk.cursor) > parsedCursor),
+            truncated: false,
+            cursorReset: false,
+            latestCursor: String(latestCursor)
+        };
+    }
+    clear(terminalId) {
+        this.buffers.delete(terminalId);
+    }
+    getOrCreateBuffer(terminalId) {
+        let buffer = this.buffers.get(terminalId);
+        if (!buffer) {
+            buffer = {
+                chunks: [],
+                nextCursor: 1,
+                totalBytes: 0
+            };
+            this.buffers.set(terminalId, buffer);
+        }
+        return buffer;
+    }
+}
+//# sourceMappingURL=terminal-output-buffer.js.map

package/dist/server/modules/terminal/runtime/terminal-output-buffer.js.map

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

package/dist/server/modules/terminal/runtime/terminal-runtime-adapter.d.ts

@@ -0,0 +1,34 @@
+import type { TerminalInstance, TerminalRuntimeSession, TerminalRuntimeType } from "../../../types/domain.js";
+export interface PersistentSessionInspection {
+    alive: boolean;
+    shellPid: number | null;
+    detail: string | null;
+}
+export interface HostAttachmentLaunch {
+    command: string;
+    args: string[];
+    cwd: string;
+    env: Record<string, string>;
+}
+export interface TerminalRuntimeAdapter {
+    readonly type: TerminalRuntimeType;
+    readonly survivesHostRestart: boolean;
+    createPersistentSession(input: {
+        terminal: TerminalInstance;
+        session: TerminalRuntimeSession;
+        env: Record<string, string>;
+    }): PersistentSessionInspection;
+    inspectPersistentSession(input: {
+        terminal: TerminalInstance;
+        session: TerminalRuntimeSession;
+    }): PersistentSessionInspection;
+    buildHostAttachmentLaunch(input: {
+        terminal: TerminalInstance;
+        session: TerminalRuntimeSession;
+        env: Record<string, string>;
+    }): HostAttachmentLaunch;
+    terminatePersistentSession(input: {
+        terminal: TerminalInstance;
+        session: TerminalRuntimeSession;
+    }): void;
+}

package/dist/server/modules/terminal/runtime/terminal-runtime-adapter.js

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

package/dist/server/modules/terminal/runtime/terminal-runtime-adapter.js.map

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

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

@@ -0,0 +1,41 @@
+import { EventEmitter } from "node:events";
+import type { TerminalInstance, TerminalRuntimeSession } from "../../../types/domain.js";
+import type { PersistentSessionInspection } from "./terminal-runtime-adapter.js";
+export interface RuntimeAttachmentExitEvent {
+    terminalId: string;
+    exitCode: number | null;
+    requestedClose: boolean;
+    sessionAlive: boolean;
+    sessionDetail: string | null;
+    shellPid: number | null;
+}
+export declare interface TerminalRuntimeManager {
+    on(event: "output", listener: (event: {
+        terminalId: string;
+        content: string;
+    }) => void): this;
+    on(event: "exit", listener: (event: RuntimeAttachmentExitEvent) => void): this;
+    emit(event: "output", eventPayload: {
+        terminalId: string;
+        content: string;
+    }): boolean;
+    emit(event: "exit", eventPayload: RuntimeAttachmentExitEvent): boolean;
+}
+export declare class TerminalRuntimeManager extends EventEmitter {
+    private readonly attachmentManager;
+    private readonly adapters;
+    private readonly attachments;
+    private readonly closeIntents;
+    constructor();
+    createPersistentSession(terminal: TerminalInstance, session: TerminalRuntimeSession, env: Record<string, string>): PersistentSessionInspection;
+    inspectPersistentSession(terminal: TerminalInstance, session: TerminalRuntimeSession): PersistentSessionInspection;
+    ensureAttached(terminal: TerminalInstance, session: TerminalRuntimeSession, env: Record<string, string>): number | null;
+    write(terminalId: string, content: string): void;
+    resize(terminalId: string, cols: number, rows: number): void;
+    detach(terminalId: string): void;
+    terminateSession(terminal: TerminalInstance, session: TerminalRuntimeSession): boolean;
+    isAttached(terminalId: string): boolean;
+    closeAllAttachments(): void;
+    private handleAttachmentExit;
+    private getAdapter;
+}

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

@@ -0,0 +1,138 @@
+import { EventEmitter } from "node:events";
+import { EmbeddedPtyRuntimeAdapter } from "./adapters/embedded-pty-runtime-adapter.js";
+import { TmuxRuntimeAdapter } from "./adapters/tmux-runtime-adapter.js";
+import { PtyHostAttachmentManager } from "./pty-host-attachment-manager.js";
+export class TerminalRuntimeManager extends EventEmitter {
+    attachmentManager = new PtyHostAttachmentManager();
+    adapters = new Map([
+        ["embedded-pty", new EmbeddedPtyRuntimeAdapter()],
+        ["tmux", new TmuxRuntimeAdapter()]
+    ]);
+    attachments = new Map();
+    closeIntents = new Map();
+    constructor() {
+        super();
+        this.attachmentManager.on("output", (event) => {
+            this.emit("output", {
+                terminalId: event.attachmentId,
+                content: event.content
+            });
+        });
+        this.attachmentManager.on("exit", (event) => {
+            this.handleAttachmentExit(event);
+        });
+    }
+    createPersistentSession(terminal, session, env) {
+        return this.getAdapter(session).createPersistentSession({
+            terminal,
+            session,
+            env
+        });
+    }
+    inspectPersistentSession(terminal, session) {
+        const adapter = this.getAdapter(session);
+        if (this.isAttached(terminal.id) && !adapter.survivesHostRestart) {
+            return {
+                alive: true,
+                shellPid: this.attachmentManager.getProcessId(terminal.id),
+                detail: null
+            };
+        }
+        return adapter.inspectPersistentSession({
+            terminal,
+            session
+        });
+    }
+    ensureAttached(terminal, session, env) {
+        if (this.isAttached(terminal.id)) {
+            return this.attachmentManager.getProcessId(terminal.id);
+        }
+        const adapter = this.getAdapter(session);
+        const launch = adapter.buildHostAttachmentLaunch({
+            terminal,
+            session,
+            env
+        });
+        const processId = this.attachmentManager.start(terminal.id, launch);
+        this.attachments.set(terminal.id, {
+            terminal,
+            session,
+            adapter
+        });
+        return processId;
+    }
+    write(terminalId, content) {
+        this.attachmentManager.write(terminalId, content);
+    }
+    resize(terminalId, cols, rows) {
+        this.attachmentManager.resize(terminalId, cols, rows);
+    }
+    detach(terminalId) {
+        if (!this.isAttached(terminalId)) {
+            return;
+        }
+        this.closeIntents.set(terminalId, "detach");
+        this.attachmentManager.close(terminalId);
+    }
+    terminateSession(terminal, session) {
+        const adapter = this.getAdapter(session);
+        const hadAttachment = this.isAttached(terminal.id);
+        if (hadAttachment) {
+            this.closeIntents.set(terminal.id, "terminate");
+        }
+        adapter.terminatePersistentSession({
+            terminal,
+            session
+        });
+        if (hadAttachment) {
+            this.attachmentManager.close(terminal.id);
+        }
+        return hadAttachment;
+    }
+    isAttached(terminalId) {
+        return this.attachmentManager.isRunning(terminalId);
+    }
+    closeAllAttachments() {
+        for (const terminalId of this.attachments.keys()) {
+            this.closeIntents.set(terminalId, "detach");
+        }
+        this.attachmentManager.closeAll();
+    }
+    handleAttachmentExit(event) {
+        const attachment = this.attachments.get(event.attachmentId);
+        const intent = this.closeIntents.get(event.attachmentId) ?? null;
+        this.attachments.delete(event.attachmentId);
+        this.closeIntents.delete(event.attachmentId);
+        if (!attachment) {
+            this.emit("exit", {
+                terminalId: event.attachmentId,
+                exitCode: event.exitCode,
+                requestedClose: event.requestedClose,
+                sessionAlive: false,
+                sessionDetail: null,
+                shellPid: null
+            });
+            return;
+        }
+        const inspection = attachment.adapter.inspectPersistentSession({
+            terminal: attachment.terminal,
+            session: attachment.session
+        });
+        this.emit("exit", {
+            terminalId: event.attachmentId,
+            exitCode: event.exitCode,
+            requestedClose: intent === "terminate" ? true : false,
+            sessionAlive: inspection.alive,
+            sessionDetail: inspection.detail,
+            shellPid: inspection.shellPid
+        });
+    }
+    getAdapter(session) {
+        const adapter = this.adapters.get(session.runtimeType);
+        if (!adapter) {
+            throw new Error(`Missing terminal runtime adapter: ${session.runtimeType}`);
+        }
+        return adapter;
+    }
+}
+//# sourceMappingURL=terminal-runtime-manager.js.map

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

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

package/dist/server/modules/terminal/template-port-runtime.d.ts

@@ -0,0 +1,6 @@
+import type { TerminalTemplateRuntimeStatus } from "../../types/domain.js";
+export declare function discoverTemplateRuntimeStatuses(items: Array<{
+    templateId: string;
+    port: number;
+}>): Promise<TerminalTemplateRuntimeStatus[]>;
+export declare function terminateRuntimeProcess(processId: number): Promise<void>;

package/dist/server/modules/terminal/template-port-runtime.js

@@ -0,0 +1,199 @@
+import { spawn } from "node:child_process";
+import path from "node:path";
+export async function discoverTemplateRuntimeStatuses(items) {
+    const uniquePorts = [...new Set(items.map((item) => item.port))];
+    const processInfoByPort = new Map();
+    await Promise.all(uniquePorts.map(async (port) => {
+        processInfoByPort.set(port, await findPortProcess(port));
+    }));
+    return items.map((item) => {
+        const processInfo = processInfoByPort.get(item.port) ?? null;
+        return {
+            templateId: item.templateId,
+            port: item.port,
+            occupied: processInfo !== null,
+            processId: processInfo?.processId ?? null,
+            processName: processInfo?.processName ?? null,
+            processCommandLine: processInfo?.processCommandLine ?? null
+        };
+    });
+}
+export async function terminateRuntimeProcess(processId) {
+    if (!Number.isInteger(processId) || processId <= 0) {
+        throw new Error(`invalid process id: ${processId}`);
+    }
+    if (process.platform === "win32") {
+        await runProcess("taskkill", ["/PID", String(processId), "/T", "/F"]);
+        return;
+    }
+    process.kill(processId, "SIGTERM");
+    await waitForProcessExit(processId, 1500);
+    if (isProcessAlive(processId)) {
+        process.kill(processId, "SIGKILL");
+        await waitForProcessExit(processId, 1500);
+    }
+}
+async function findPortProcess(port) {
+    if (process.platform === "win32") {
+        return await findWindowsPortProcess(port);
+    }
+    return await findPosixPortProcess(port);
+}
+async function findWindowsPortProcess(port) {
+    const shellPath = process.env.SYSTEMROOT
+        ? path.join(process.env.SYSTEMROOT, "System32", "WindowsPowerShell", "v1.0", "powershell.exe")
+        : "powershell.exe";
+    const script = [
+        `$port=${port}`,
+        "$connection = Get-NetTCPConnection -State Listen -LocalPort $port -ErrorAction SilentlyContinue | Select-Object -First 1",
+        "if (-not $connection) { return }",
+        "$process = Get-CimInstance Win32_Process -Filter \"ProcessId = $($connection.OwningProcess)\" | Select-Object ProcessId, Name, CommandLine",
+        "if (-not $process) { return }",
+        "$process | ConvertTo-Json -Compress"
+    ].join("; ");
+    const stdout = await tryRunProcess(shellPath, [
+        "-NoProfile",
+        "-NonInteractive",
+        "-ExecutionPolicy",
+        "Bypass",
+        "-Command",
+        script
+    ]);
+    if (!stdout?.trim()) {
+        return null;
+    }
+    const parsed = JSON.parse(stdout);
+    if (!Number.isInteger(parsed.ProcessId) || parsed.ProcessId <= 0) {
+        return null;
+    }
+    return {
+        processId: parsed.ProcessId,
+        processName: parsed.Name?.trim() || null,
+        processCommandLine: parsed.CommandLine?.trim() || null
+    };
+}
+async function findPosixPortProcess(port) {
+    if (process.platform === "linux") {
+        const ssInfo = await findLinuxPortProcessWithSs(port);
+        if (ssInfo) {
+            return ssInfo;
+        }
+    }
+    return await findPosixPortProcessWithLsof(port);
+}
+async function findLinuxPortProcessWithSs(port) {
+    const stdout = await tryRunProcess("ss", ["-ltnp"]);
+    if (!stdout) {
+        return null;
+    }
+    for (const line of stdout.split(/\r?\n/)) {
+        if (!line.includes(`:${port}`) || !line.includes("LISTEN")) {
+            continue;
+        }
+        const matched = line.match(/users:\(\("([^"]+)",pid=(\d+),fd=\d+\)\)/);
+        if (!matched) {
+            continue;
+        }
+        const [, processName, processIdText] = matched;
+        const processId = Number(processIdText);
+        if (!Number.isInteger(processId) || processId <= 0) {
+            continue;
+        }
+        return await enrichPosixProcess(processId, processName);
+    }
+    return null;
+}
+async function findPosixPortProcessWithLsof(port) {
+    const stdout = await tryRunProcess("lsof", [
+        "-nP",
+        `-iTCP:${port}`,
+        "-sTCP:LISTEN",
+        "-Fpct"
+    ]);
+    if (!stdout) {
+        return null;
+    }
+    let processId = null;
+    let processName = null;
+    for (const line of stdout.split(/\r?\n/)) {
+        if (line.startsWith("p")) {
+            const parsed = Number(line.slice(1));
+            processId = Number.isInteger(parsed) ? parsed : null;
+            continue;
+        }
+        if (line.startsWith("c")) {
+            processName = line.slice(1).trim() || null;
+        }
+        if (processId) {
+            return await enrichPosixProcess(processId, processName);
+        }
+    }
+    return null;
+}
+async function enrichPosixProcess(processId, fallbackName) {
+    const processName = (await tryRunProcess("ps", ["-p", String(processId), "-o", "comm="]))?.trim() || fallbackName;
+    const processCommandLine = (await tryRunProcess("ps", ["-p", String(processId), "-o", "args="]))?.trim() || null;
+    return {
+        processId,
+        processName,
+        processCommandLine
+    };
+}
+async function tryRunProcess(command, args) {
+    try {
+        return await runProcess(command, args);
+    }
+    catch {
+        return null;
+    }
+}
+async function runProcess(command, args) {
+    return await new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            windowsHide: true,
+            stdio: ["ignore", "pipe", "pipe"]
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (chunk) => {
+            stdout += String(chunk);
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += String(chunk);
+        });
+        child.on("error", reject);
+        child.on("close", (exitCode) => {
+            if (exitCode !== 0) {
+                reject(new Error(stderr.trim() || `${command} exited with code ${exitCode ?? "unknown"}`));
+                return;
+            }
+            resolve(stdout);
+        });
+    });
+}
+function isProcessAlive(processId) {
+    try {
+        process.kill(processId, 0);
+        return true;
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            "code" in error &&
+            error.code === "ESRCH") {
+            return false;
+        }
+        throw error;
+    }
+}
+async function waitForProcessExit(processId, timeoutMs) {
+    const startedAt = Date.now();
+    while (Date.now() - startedAt < timeoutMs) {
+        if (!isProcessAlive(processId)) {
+            return;
+        }
+        await new Promise((resolve) => {
+            setTimeout(resolve, 100);
+        });
+    }
+}
+//# sourceMappingURL=template-port-runtime.js.map

package/dist/server/modules/terminal/template-port-runtime.js.map

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

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

@@ -0,0 +1,94 @@
+import type { FastifyReply, FastifyRequest } from "fastify";
+import type { CommandTemplateService } from "./command-template-service.js";
+import type { TerminalService } from "./terminal-service.js";
+interface TerminalListQuery {
+    workspaceId?: string;
+}
+interface TerminalParams {
+    terminalId: string;
+}
+interface TerminalHistoryQuery {
+    beforeSeq?: string;
+    limit?: string;
+}
+interface CommandTemplateParams {
+    templateId: string;
+}
+interface CreateTerminalBody {
+    workspaceId?: string;
+    name?: string;
+    cwd?: string;
+    shell?: string;
+    runtimeType?: string;
+}
+interface TerminalInputBody {
+    content?: string;
+}
+interface CommandTemplateBody {
+    workspaceId?: string;
+    name?: string;
+    cwd?: string;
+    command?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    port?: number | null;
+    runtimeType?: string | null;
+}
+interface TemplateListQuery {
+    workspaceId?: string;
+}
+interface RunTemplateBody {
+    terminalId?: string;
+    shell?: string;
+    runtimeType?: string;
+}
+export declare class TerminalController {
+    private readonly terminalService;
+    private readonly commandTemplateService;
+    constructor(terminalService: TerminalService, commandTemplateService: CommandTemplateService);
+    readonly listTerminals: (request: FastifyRequest<{
+        Querystring: TerminalListQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly createTerminal: (request: FastifyRequest<{
+        Body: CreateTerminalBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly listShellOptions: (_request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    readonly closeTerminal: (request: FastifyRequest<{
+        Params: TerminalParams;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly deleteTerminal: (request: FastifyRequest<{
+        Params: TerminalParams;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly readHistory: (request: FastifyRequest<{
+        Params: TerminalParams;
+        Querystring: TerminalHistoryQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly writeInput: (request: FastifyRequest<{
+        Params: TerminalParams;
+        Body: TerminalInputBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly listTemplates: (request: FastifyRequest<{
+        Querystring: TemplateListQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly listTemplateRuntimeStatuses: (request: FastifyRequest<{
+        Querystring: TemplateListQuery;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly createTemplate: (request: FastifyRequest<{
+        Body: CommandTemplateBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly updateTemplate: (request: FastifyRequest<{
+        Params: CommandTemplateParams;
+        Body: CommandTemplateBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly deleteTemplate: (request: FastifyRequest<{
+        Params: CommandTemplateParams;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly runTemplate: (request: FastifyRequest<{
+        Params: CommandTemplateParams;
+        Body: RunTemplateBody;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly stopTemplateRuntimeProcess: (request: FastifyRequest<{
+        Params: CommandTemplateParams;
+    }>, reply: FastifyReply) => Promise<void>;
+}
+export {};