@myagentroam/node 0.1.0

package/dist/terminal.js

@@ -0,0 +1,417 @@
+import { randomUUID } from 'node:crypto';
+import { homedir } from 'node:os';
+import { spawn } from 'node-pty';
+import { terminalDataFrameSchema } from '@myagentroam/protocol';
+import { terminateProcessTree } from './process-tree.js';
+const MAX_FRAME_CHARACTERS = 65_536;
+const DEFAULT_MAX_TERMINALS = 10;
+const DEFAULT_MAX_TERMINALS_PER_WORKSPACE = 5;
+const DEFAULT_MAX_REPLAY_BYTES = 512 * 1024;
+const DEFAULT_IDLE_TIMEOUT_MS = 60 * 60_000;
+/**
+ * Owns Node-local PTY/ConPTY processes and their bounded output replay.
+ * Browser relay transport intentionally lives outside this class: callers pass
+ * only schema-validated TerminalDataFrame values after Server authorization.
+ */
+export class TerminalManager {
+    platform;
+    cwd;
+    profiles;
+    maxTerminals;
+    maxTerminalsPerWorkspace;
+    maxReplayBytes;
+    idleTimeoutMs;
+    now;
+    ptyFactory;
+    terminate;
+    terminals = new Map();
+    attachments = new Map();
+    frameListeners = new Set();
+    summaryListeners = new Set();
+    idleTimer;
+    constructor(options = {}) {
+        this.platform = options.platform ?? (process.platform === 'win32' ? 'win32' : 'linux');
+        this.cwd = options.cwd ?? homedir();
+        this.profiles = options.profiles ?? defaultTerminalProfiles(this.platform);
+        if (this.profiles.length === 0 || !this.profiles.some((profile) => profile.isDefault)) {
+            throw new Error('TERMINAL_PROFILE_INVALID');
+        }
+        this.maxTerminals = options.maxTerminals ?? DEFAULT_MAX_TERMINALS;
+        this.maxTerminalsPerWorkspace =
+            options.maxTerminalsPerWorkspace ?? DEFAULT_MAX_TERMINALS_PER_WORKSPACE;
+        this.maxReplayBytes = options.maxReplayBytes ?? DEFAULT_MAX_REPLAY_BYTES;
+        this.idleTimeoutMs = options.idleTimeoutMs ?? DEFAULT_IDLE_TIMEOUT_MS;
+        if (!Number.isSafeInteger(this.maxTerminals) ||
+            this.maxTerminals < 1 ||
+            this.maxTerminals > 64 ||
+            !Number.isSafeInteger(this.maxTerminalsPerWorkspace) ||
+            this.maxTerminalsPerWorkspace < 1 ||
+            this.maxTerminalsPerWorkspace > this.maxTerminals ||
+            !Number.isSafeInteger(this.maxReplayBytes) ||
+            this.maxReplayBytes < 1 ||
+            this.maxReplayBytes > 16 * 1024 * 1024 ||
+            !Number.isSafeInteger(this.idleTimeoutMs) ||
+            this.idleTimeoutMs < 1_000) {
+            throw new Error('TERMINAL_CONFIG_INVALID');
+        }
+        this.now = options.now ?? Date.now;
+        this.ptyFactory = options.ptyFactory ?? nodePtyFactory;
+        this.terminate =
+            options.terminate ?? ((child, platform) => terminateProcessTree(child, platform));
+        this.idleTimer = setInterval(() => void this.closeExpired(), Math.min(this.idleTimeoutMs, 60_000));
+        this.idleTimer.unref();
+    }
+    availableProfiles() {
+        return this.profiles.map(({ id, label, isDefault }) => ({ id, label, isDefault }));
+    }
+    limits() {
+        return {
+            maxTerminals: this.maxTerminals,
+            maxTerminalsPerWorkspace: this.maxTerminalsPerWorkspace,
+            maxReplayBytes: this.maxReplayBytes,
+            reconnectWindowMs: this.idleTimeoutMs
+        };
+    }
+    open(input = {}) {
+        const profileId = input.profileId ?? this.profiles.find((profile) => profile.isDefault)?.id;
+        if (typeof profileId !== 'string')
+            throw new Error('TERMINAL_PROFILE_INVALID');
+        const profile = this.profiles.find((candidate) => candidate.id === profileId);
+        if (profile === undefined)
+            throw new Error('TERMINAL_PROFILE_INVALID');
+        const rows = terminalDimension(input.rows, 24);
+        const cols = terminalDimension(input.cols, 80);
+        if (input.cwd !== undefined && typeof input.cwd !== 'string')
+            throw new Error('TERMINAL_OPEN_INVALID');
+        if (input.workspaceId !== undefined &&
+            input.workspaceId !== null &&
+            typeof input.workspaceId !== 'string')
+            throw new Error('TERMINAL_OPEN_INVALID');
+        this.evictForNewTerminal(input.workspaceId ?? null);
+        const pty = this.ptyFactory(profile.shell, profile.args, {
+            name: 'xterm-256color',
+            cols,
+            rows,
+            cwd: typeof input.cwd === 'string' ? input.cwd : this.cwd,
+            env: process.env
+        });
+        const createdAt = this.now();
+        const terminal = {
+            id: randomUUID(),
+            workspaceId: input.workspaceId ?? null,
+            profile,
+            pty,
+            createdAt,
+            state: 'RUNNING',
+            updatedAt: createdAt,
+            exitCode: null,
+            rows,
+            cols,
+            sequence: 0,
+            replayBytes: 0,
+            replay: [],
+            writerAttachmentId: undefined,
+            lastUsedAt: createdAt,
+            detachedAt: createdAt
+        };
+        this.terminals.set(terminal.id, terminal);
+        pty.onData((data) => this.recordOutput(terminal, data));
+        pty.onExit((event) => this.exited(terminal, event.exitCode));
+        return this.notifySummary(terminal);
+    }
+    list() {
+        return [...this.terminals.values()].map((terminal) => this.summary(terminal));
+    }
+    get(terminalId) {
+        return this.summary(this.requireTerminal(terminalId));
+    }
+    /** One attachment may write. A new writer must explicitly take over. */
+    authorizeAttach(input) {
+        if (typeof input.terminalId !== 'string')
+            throw new Error('TERMINAL_NOT_FOUND');
+        const terminal = this.requireTerminal(input.terminalId);
+        if (terminal.state !== 'RUNNING')
+            throw new Error('TERMINAL_CLOSED');
+        const afterSequence = terminalSequence(input.afterSequence);
+        const readonly = input.readonly === true;
+        if (input.readonly !== undefined && typeof input.readonly !== 'boolean')
+            throw new Error('TERMINAL_ATTACH_INVALID');
+        if (input.takeover !== undefined && typeof input.takeover !== 'boolean')
+            throw new Error('TERMINAL_ATTACH_INVALID');
+        if (!readonly && terminal.writerAttachmentId !== undefined && input.takeover !== true) {
+            throw new Error('TERMINAL_ATTACH_CONFLICT');
+        }
+        if (!readonly && terminal.writerAttachmentId !== undefined) {
+            this.attachments.delete(terminal.writerAttachmentId);
+        }
+        const attachmentId = randomUUID();
+        this.attachments.set(attachmentId, { terminalId: terminal.id, readonly });
+        if (!readonly)
+            terminal.writerAttachmentId = attachmentId;
+        terminal.updatedAt = this.now();
+        terminal.lastUsedAt = terminal.updatedAt;
+        terminal.detachedAt = undefined;
+        return {
+            attachmentId,
+            terminalId: terminal.id,
+            readonly,
+            frames: this.replayFrames(terminal, afterSequence)
+        };
+    }
+    detach(attachmentId) {
+        const attachment = this.attachments.get(attachmentId);
+        if (attachment === undefined)
+            return;
+        this.attachments.delete(attachmentId);
+        const terminal = this.terminals.get(attachment.terminalId);
+        if (terminal?.writerAttachmentId === attachmentId)
+            terminal.writerAttachmentId = undefined;
+        if (terminal !== undefined && !this.hasAttachment(terminal.id)) {
+            terminal.detachedAt = this.now();
+            terminal.lastUsedAt = terminal.detachedAt;
+            this.notifySummary(terminal);
+        }
+    }
+    /** Processes data frames from an already-authorized Server relay attachment. */
+    async acceptFrame(attachmentId, frame) {
+        const parsed = terminalDataFrameSchema.safeParse(frame);
+        if (!parsed.success)
+            throw new Error('TERMINAL_FRAME_INVALID');
+        const attachment = this.attachments.get(attachmentId);
+        if (attachment === undefined || attachment.terminalId !== parsed.data.terminalId)
+            throw new Error('TERMINAL_ATTACH_INVALID');
+        const terminal = this.requireTerminal(attachment.terminalId);
+        if (terminal.state !== 'RUNNING')
+            throw new Error('TERMINAL_CLOSED');
+        if (parsed.data.type === 'attach' ||
+            parsed.data.type === 'output' ||
+            parsed.data.type === 'exit' ||
+            parsed.data.type === 'error') {
+            throw new Error('TERMINAL_FRAME_INVALID');
+        }
+        if (attachment.readonly || terminal.writerAttachmentId !== attachmentId)
+            throw new Error('TERMINAL_WRITE_DENIED');
+        terminal.updatedAt = this.now();
+        terminal.lastUsedAt = terminal.updatedAt;
+        if (parsed.data.type === 'input') {
+            terminal.pty.write(parsed.data.data);
+            return;
+        }
+        if (parsed.data.type === 'resize') {
+            terminal.pty.resize(parsed.data.cols, parsed.data.rows);
+            terminal.cols = parsed.data.cols;
+            terminal.rows = parsed.data.rows;
+            this.notifySummary(terminal);
+            return;
+        }
+        await this.close(terminal.id);
+    }
+    async close(terminalId) {
+        const terminal = this.requireTerminal(terminalId);
+        if (terminal.state !== 'RUNNING')
+            return this.summary(terminal);
+        terminal.state = 'CLOSED';
+        terminal.updatedAt = this.now();
+        this.detachAll(terminal);
+        const summary = this.notifySummary(terminal);
+        try {
+            await this.terminate(terminal.pty, this.platform);
+        }
+        finally {
+            this.emit({ type: 'exit', terminalId: terminal.id, exitCode: terminal.exitCode });
+        }
+        return summary;
+    }
+    async shutdown() {
+        if (this.idleTimer !== undefined)
+            clearInterval(this.idleTimer);
+        this.idleTimer = undefined;
+        await Promise.all([...this.terminals.values()]
+            .filter((terminal) => terminal.state === 'RUNNING')
+            .map((terminal) => this.close(terminal.id)));
+    }
+    onFrame(listener) {
+        this.frameListeners.add(listener);
+        return () => this.frameListeners.delete(listener);
+    }
+    onSummary(listener) {
+        this.summaryListeners.add(listener);
+        return () => this.summaryListeners.delete(listener);
+    }
+    async closeExpired() {
+        const expired = [...this.terminals.values()].filter((terminal) => terminal.state === 'RUNNING' &&
+            terminal.detachedAt !== undefined &&
+            this.now() - terminal.detachedAt >= this.idleTimeoutMs);
+        await Promise.all(expired.map((terminal) => this.close(terminal.id)));
+    }
+    recordOutput(terminal, data) {
+        if (terminal.state !== 'RUNNING' || data.length === 0)
+            return;
+        for (const part of splitFrameData(data)) {
+            const frame = {
+                sequence: ++terminal.sequence,
+                data: part,
+                bytes: Buffer.byteLength(part, 'utf8')
+            };
+            terminal.replay.push(frame);
+            terminal.replayBytes += frame.bytes;
+            while (terminal.replayBytes > this.maxReplayBytes && terminal.replay.length > 0) {
+                const removed = terminal.replay.shift();
+                if (removed !== undefined)
+                    terminal.replayBytes -= removed.bytes;
+            }
+            this.emit({
+                type: 'output',
+                terminalId: terminal.id,
+                sequence: frame.sequence,
+                data: frame.data
+            });
+        }
+    }
+    exited(terminal, exitCode) {
+        if (terminal.state !== 'RUNNING')
+            return;
+        terminal.state = 'EXITED';
+        terminal.exitCode = exitCode;
+        terminal.updatedAt = this.now();
+        this.detachAll(terminal);
+        this.notifySummary(terminal);
+        this.emit({ type: 'exit', terminalId: terminal.id, exitCode });
+    }
+    replayFrames(terminal, afterSequence) {
+        const first = terminal.replay[0]?.sequence;
+        const frames = [];
+        if (first !== undefined && afterSequence < first - 1) {
+            frames.push({ type: 'error', terminalId: terminal.id, code: 'TERMINAL_REPLAY_GAP' });
+        }
+        for (const replay of terminal.replay) {
+            if (replay.sequence > afterSequence) {
+                frames.push({
+                    type: 'output',
+                    terminalId: terminal.id,
+                    sequence: replay.sequence,
+                    data: replay.data
+                });
+            }
+        }
+        return frames;
+    }
+    summary(terminal) {
+        return {
+            id: terminal.id,
+            workspaceId: terminal.workspaceId,
+            profileId: terminal.profile.id,
+            state: terminal.state,
+            createdAt: terminal.createdAt,
+            updatedAt: terminal.updatedAt,
+            exitCode: terminal.exitCode,
+            rows: terminal.rows,
+            cols: terminal.cols,
+            latestSequence: terminal.sequence
+        };
+    }
+    notifySummary(terminal) {
+        const summary = this.summary(terminal);
+        for (const listener of this.summaryListeners)
+            listener(summary);
+        return summary;
+    }
+    requireTerminal(terminalId) {
+        const terminal = this.terminals.get(terminalId);
+        if (terminal === undefined)
+            throw new Error('TERMINAL_NOT_FOUND');
+        return terminal;
+    }
+    runningCount() {
+        return [...this.terminals.values()].filter((terminal) => terminal.state === 'RUNNING').length;
+    }
+    evictForNewTerminal(workspaceId) {
+        if (workspaceId !== null &&
+            this.runningCountForWorkspace(workspaceId) >= this.maxTerminalsPerWorkspace) {
+            this.evictLeastRecentlyUsed((terminal) => terminal.workspaceId === workspaceId);
+        }
+        if (this.runningCount() >= this.maxTerminals)
+            this.evictLeastRecentlyUsed(() => true);
+    }
+    evictLeastRecentlyUsed(predicate) {
+        const candidate = [...this.terminals.values()]
+            .filter((terminal) => terminal.state === 'RUNNING' && predicate(terminal))
+            .sort((left, right) => left.lastUsedAt - right.lastUsedAt || left.createdAt - right.createdAt)[0];
+        if (candidate !== undefined)
+            void this.close(candidate.id);
+    }
+    runningCountForWorkspace(workspaceId) {
+        return [...this.terminals.values()].filter((terminal) => terminal.state === 'RUNNING' && terminal.workspaceId === workspaceId).length;
+    }
+    hasAttachment(terminalId) {
+        return [...this.attachments.values()].some((attachment) => attachment.terminalId === terminalId);
+    }
+    detachAll(terminal) {
+        for (const [attachmentId, attachment] of this.attachments) {
+            if (attachment.terminalId === terminal.id)
+                this.attachments.delete(attachmentId);
+        }
+        terminal.writerAttachmentId = undefined;
+        terminal.detachedAt = undefined;
+    }
+    emit(frame) {
+        for (const listener of this.frameListeners)
+            listener(frame);
+    }
+}
+function nodePtyFactory(shell, args, options) {
+    const pty = spawn(shell, [...args], {
+        name: options.name,
+        cols: options.cols,
+        rows: options.rows,
+        cwd: options.cwd,
+        env: options.env
+    });
+    return pty;
+}
+function defaultTerminalProfiles(platform) {
+    if (platform === 'win32') {
+        return [
+            {
+                id: 'default',
+                label: 'Windows Command Prompt',
+                shell: process.env['ComSpec'] ?? 'C:\\Windows\\System32\\cmd.exe',
+                args: [],
+                isDefault: true
+            }
+        ];
+    }
+    return [
+        {
+            id: 'default',
+            label: '用户 Shell',
+            shell: process.env['SHELL']?.trim() || '/bin/bash',
+            args: ['-l', '-i'],
+            isDefault: true
+        }
+    ];
+}
+function terminalDimension(value, fallback) {
+    if (value === undefined)
+        return fallback;
+    if (typeof value !== 'number' || !Number.isInteger(value) || value < 1 || value > 1000)
+        throw new Error('TERMINAL_DIMENSIONS_INVALID');
+    return value;
+}
+function terminalSequence(value) {
+    if (value === undefined)
+        return 0;
+    if (typeof value !== 'number' || !Number.isInteger(value) || value < 0)
+        throw new Error('TERMINAL_REPLAY_INVALID');
+    return value;
+}
+function splitFrameData(value) {
+    if (value.length <= MAX_FRAME_CHARACTERS)
+        return [value];
+    const chunks = [];
+    for (let start = 0; start < value.length; start += MAX_FRAME_CHARACTERS) {
+        chunks.push(value.slice(start, start + MAX_FRAME_CHARACTERS));
+    }
+    return chunks;
+}
+//# sourceMappingURL=terminal.js.map

package/dist/terminal.js.map

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

package/dist/workspace.d.ts

@@ -0,0 +1,116 @@
+import type { GitSummary, WorkspaceKind } from '@myagentroam/protocol';
+export interface WorkspaceInspection {
+    readonly path: string;
+    readonly kind: WorkspaceKind;
+    readonly gitSummary?: GitSummary;
+}
+export interface WorkspaceFileEntry {
+    readonly path: string;
+    readonly name: string;
+    readonly kind: 'FILE' | 'DIRECTORY';
+    readonly size: number | null;
+    readonly modifiedAt: number | null;
+}
+export interface WorkspaceFilePage {
+    readonly entries: readonly WorkspaceFileEntry[];
+    readonly nextCursor: string | null;
+    readonly truncated: boolean;
+}
+export interface WorkspaceFileSearchPage {
+    readonly entries: readonly WorkspaceFileEntry[];
+    readonly nextCursor: string | null;
+    readonly truncated: boolean;
+}
+export type WorkspaceUploadPreflightStatus = 'READY' | 'EXISTS_FILE' | 'EXISTS_DIRECTORY' | 'INVALID_NAME';
+export interface WorkspaceUploadTarget {
+    readonly path: string;
+    readonly absolutePath: string;
+    readonly status: WorkspaceUploadPreflightStatus;
+}
+export interface WorkspaceDirectoryEntry {
+    readonly path: string;
+    readonly name: string;
+    readonly selectable: boolean;
+}
+export interface WorkspaceDirectoryListing {
+    readonly homePath: string;
+    readonly currentPath: string;
+    readonly parentPath: string | null;
+    readonly browseRoots: readonly string[];
+    readonly selectable: boolean;
+    readonly entries: readonly WorkspaceDirectoryEntry[];
+    readonly truncated: boolean;
+}
+interface FileAccessOptions {
+    readonly privateRoots?: readonly string[];
+}
+/**
+ * Lists directory names only for the Workspace picker. Browsing begins at the
+ * first allowed root when configured, while the Node account home remains a
+ * browse boundary and terminal default.
+ */
+export declare function listWorkspaceDirectories(requestedPath: string | undefined, allowedRoots: readonly string[], homePath?: string): Promise<WorkspaceDirectoryListing>;
+export declare function listWorkspaceFiles(workspaceRoot: string, requestedPath?: string, cursor?: string, limit?: number, options?: FileAccessOptions): Promise<WorkspaceFilePage>;
+/** Validates an upload destination without following an existing target symlink. */
+export declare function preflightWorkspaceUpload(workspaceRoot: string, requestedDirectory: string, name: string, options?: FileAccessOptions): Promise<WorkspaceUploadTarget>;
+export declare function workspaceUploadTemporaryName(uploadId: string): string;
+export declare function readWorkspaceTextFile(workspaceRoot: string, requestedPath: string, offset?: number, limit?: number, options?: FileAccessOptions): Promise<{
+    readonly path: string;
+    readonly encoding: 'utf-8' | 'base64';
+    readonly size: number;
+    readonly content: string;
+    readonly truncated: boolean;
+    readonly nextOffset: number | null;
+}>;
+/** Reads one absolute file only when the resolved target remains within a Node allowed root. */
+export declare function readAllowedTextFile(requestedPath: string, allowedRoots: readonly string[], offset?: number, limit?: number, options?: FileAccessOptions): Promise<{
+    readonly path: string;
+    readonly encoding: 'utf-8' | 'base64';
+    readonly size: number;
+    readonly content: string;
+    readonly truncated: boolean;
+    readonly nextOffset: number | null;
+}>;
+/** Searches file names only, so an exploratory request cannot exfiltrate file contents. */
+export declare function searchWorkspaceFiles(workspaceRoot: string, query: string, cursor?: string, limit?: number, options?: FileAccessOptions): Promise<WorkspaceFileSearchPage>;
+export declare function normalizeWorkspacePath(input: string, platform?: NodeJS.Platform): string;
+export declare function isWithinAllowedRoot(target: string, roots: readonly string[], platform?: NodeJS.Platform): boolean;
+/** Resolving both candidate and roots rejects Linux symlinks which point outside a root. */
+export declare function inspectWorkspace(requestedPath: string, allowedRoots: readonly string[]): Promise<WorkspaceInspection>;
+export declare function readGitSummary(workspacePath: string): Promise<GitSummary>;
+export declare function assertSafeGitRef(ref: string): void;
+export declare function readRestrictedDiff(workspacePath: string, fromRef: string, toRef: string): Promise<{
+    readonly binary: boolean;
+    readonly text?: string;
+    readonly summary?: string;
+    readonly truncated: boolean;
+}>;
+type CurrentChange = {
+    readonly path: string;
+    readonly state: 'STAGED' | 'UNSTAGED' | 'UNTRACKED';
+    readonly change: 'ADDED' | 'MODIFIED' | 'DELETED' | 'RENAMED' | 'COPIED' | 'TYPE_CHANGED';
+};
+export declare function readCurrentChangesSummary(workspacePath: string): Promise<{
+    readonly branch: string | null;
+    readonly changes: readonly CurrentChange[];
+}>;
+export declare function readCurrentChanges(workspacePath: string): Promise<readonly {
+    readonly path: string;
+    readonly state: 'STAGED' | 'UNSTAGED' | 'UNTRACKED';
+    readonly change: 'ADDED' | 'MODIFIED' | 'DELETED' | 'RENAMED' | 'COPIED' | 'TYPE_CHANGED';
+}[]>;
+export declare function readCurrentChangeDiff(workspacePath: string, requestedPath: string): Promise<{
+    readonly binary: boolean;
+    readonly text?: string;
+    readonly summary?: string;
+    readonly truncated: boolean;
+    readonly afterText?: string;
+    readonly afterTruncated?: boolean;
+}>;
+export declare function restoreCurrentChange(workspacePath: string, requestedPath: string, state: 'STAGED' | 'UNSTAGED' | 'UNTRACKED', options?: FileAccessOptions): Promise<void>;
+export declare class GitCommandError extends Error {
+    readonly code: number;
+    readonly stderr: string;
+    constructor(code: number, stderr: string);
+}
+export {};