nterminal 1.2.0

package/dist/server/storage/fileStore.js

@@ -0,0 +1,275 @@
+import { randomUUID } from 'node:crypto';
+import { closeSync, mkdirSync, openSync, renameSync, writeSync } from 'node:fs';
+import { mkdir, open, readFile, rename } from 'node:fs/promises';
+import path from 'node:path';
+import { normalizeTerminalLayoutState } from '../../shared/layoutState.js';
+const emptyState = () => ({
+    passwordCredential: null,
+    totpCredential: null,
+    mainName: null,
+    agents: [],
+    trustedDevices: [],
+    ipWhitelist: [],
+    terminalLayout: null,
+    agentLayouts: {},
+    notificationAssets: [],
+    notificationAssetDisabledIds: []
+});
+function normalizeState(value) {
+    if (!value || typeof value !== 'object') {
+        return emptyState();
+    }
+    const state = value;
+    const passwordCredential = state.passwordCredential &&
+        typeof state.passwordCredential === 'object' &&
+        state.passwordCredential.algorithm === 'scrypt' &&
+        typeof state.passwordCredential.hash === 'string' &&
+        typeof state.passwordCredential.salt === 'string' &&
+        typeof state.passwordCredential.createdAt === 'string' &&
+        typeof state.passwordCredential.updatedAt === 'string'
+        ? state.passwordCredential
+        : null;
+    const totpCredential = state.totpCredential &&
+        typeof state.totpCredential === 'object' &&
+        typeof state.totpCredential.secret === 'string' &&
+        state.totpCredential.algorithm === 'SHA1' &&
+        state.totpCredential.digits === 6 &&
+        state.totpCredential.period === 30 &&
+        typeof state.totpCredential.createdAt === 'string'
+        ? state.totpCredential
+        : null;
+    const agents = Array.isArray(state.agents)
+        ? state.agents.filter((a) => a !== null &&
+            typeof a === 'object' &&
+            typeof a.id === 'string' &&
+            typeof a.name === 'string' &&
+            typeof a.url === 'string' &&
+            typeof a.token === 'string' &&
+            typeof a.createdAt === 'string')
+        : [];
+    const trustedDevices = Array.isArray(state.trustedDevices)
+        ? state.trustedDevices.filter((d) => d !== null &&
+            typeof d === 'object' &&
+            typeof d.id === 'string' &&
+            typeof d.tokenHash === 'string' &&
+            typeof d.label === 'string' &&
+            typeof d.createdAt === 'string' &&
+            typeof d.lastSeenAt === 'string' &&
+            typeof d.expiresAt === 'string')
+        : [];
+    const ipWhitelist = Array.isArray(state.ipWhitelist)
+        ? state.ipWhitelist.filter((r) => r !== null &&
+            typeof r === 'object' &&
+            typeof r.id === 'string' &&
+            typeof r.value === 'string' &&
+            typeof r.label === 'string' &&
+            typeof r.createdAt === 'string')
+        : [];
+    const agentLayouts = {};
+    if (state.agentLayouts && typeof state.agentLayouts === 'object') {
+        for (const [agentId, value] of Object.entries(state.agentLayouts)) {
+            const normalized = normalizeStoredTerminalLayout(value);
+            if (normalized) {
+                agentLayouts[agentId] = normalized;
+            }
+        }
+    }
+    const notificationAssets = Array.isArray(state.notificationAssets)
+        ? state.notificationAssets.filter((asset) => asset !== null &&
+            typeof asset === 'object' &&
+            typeof asset.id === 'string' &&
+            typeof asset.filename === 'string' &&
+            typeof asset.storedFilename === 'string' &&
+            (asset.contentType === 'video/mp4' ||
+                asset.contentType === 'video/webm') &&
+            typeof asset.size === 'number' &&
+            Number.isFinite(asset.size) &&
+            asset.size >= 0 &&
+            typeof asset.createdAt === 'string')
+        : [];
+    const notificationAssetDisabledIds = Array.isArray(state.notificationAssetDisabledIds)
+        ? Array.from(new Set(state.notificationAssetDisabledIds.filter((assetId) => typeof assetId === 'string' && assetId.length > 0)))
+        : [];
+    // mainName: only accept non-empty strings, otherwise null so older state
+    // files (pre-mainName) and operators who cleared the field both fall back
+    // to the client's "Local" default.
+    const rawMainName = typeof state.mainName === 'string' ? state.mainName.trim() : '';
+    const mainName = rawMainName || null;
+    return {
+        passwordCredential,
+        totpCredential,
+        mainName,
+        agents,
+        trustedDevices,
+        ipWhitelist,
+        terminalLayout: normalizeStoredTerminalLayout(state.terminalLayout),
+        agentLayouts,
+        notificationAssets,
+        notificationAssetDisabledIds
+    };
+}
+function normalizeStoredTerminalLayout(value) {
+    if (!value || typeof value !== 'object') {
+        return null;
+    }
+    const candidate = value;
+    const layout = normalizeTerminalLayoutState(candidate.layout);
+    const revision = candidate.revision;
+    if (!layout || typeof revision !== 'number' || !Number.isInteger(revision) || revision < 0 || typeof candidate.updatedAt !== 'string') {
+        return null;
+    }
+    return {
+        layout,
+        revision,
+        updatedAt: candidate.updatedAt
+    };
+}
+const DEFAULT_COALESCE_WINDOW_MS = 1000;
+export class FileStore {
+    path;
+    memoryState = null;
+    dirty = false;
+    flushTimer = null;
+    updateQueue = Promise.resolve();
+    coalesceWindowMs;
+    onError;
+    constructor(path, options = {}) {
+        this.path = path;
+        this.coalesceWindowMs = options.coalesceWindowMs ?? DEFAULT_COALESCE_WINDOW_MS;
+        this.onError = options.onError ?? defaultOnError;
+    }
+    // Replace the error handler after construction. The Fastify logger is not
+    // available when the store is built in index.ts, so we wire it in once the
+    // app is constructed.
+    setErrorHandler(handler) {
+        this.onError = handler;
+    }
+    async init() {
+        await mkdir(path.dirname(this.path), { recursive: true, mode: 0o700 });
+        try {
+            this.memoryState = deepFreeze(await this.readFromDisk());
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT') {
+                throw error;
+            }
+            this.memoryState = deepFreeze(emptyState());
+            await this.writeToDisk(this.memoryState);
+        }
+    }
+    async read() {
+        if (this.memoryState) {
+            return this.memoryState;
+        }
+        const state = deepFreeze(await this.readFromDisk());
+        this.memoryState = state;
+        return state;
+    }
+    async update(updater, options = {}) {
+        const mode = options.flush ?? 'coalesced';
+        return this.enqueue(async () => {
+            const current = this.memoryState ?? deepFreeze(await this.readFromDisk());
+            const next = deepFreeze(await updater(current));
+            this.memoryState = next;
+            this.dirty = true;
+            if (mode === 'immediate') {
+                await this.flushDirty();
+            }
+            else {
+                this.scheduleFlush();
+            }
+            return next;
+        });
+    }
+    // Force any pending coalesced write to disk now.
+    async flush() {
+        await this.enqueue(() => this.flushDirty());
+    }
+    // Synchronous flush for shutdown handlers. Bypasses the update queue so it
+    // works inside `beforeExit` and SIGTERM handlers without an extra microtask
+    // tick. Safe to call after a normal async `flush()` — becomes a no-op.
+    flushSync() {
+        this.cancelTimer();
+        if (!this.dirty || !this.memoryState) {
+            return;
+        }
+        mkdirSync(path.dirname(this.path), { recursive: true, mode: 0o700 });
+        const tempPath = `${this.path}.${process.pid}.${Date.now()}.${randomUUID()}.tmp`;
+        const fd = openSync(tempPath, 'w', 0o600);
+        try {
+            writeSync(fd, `${JSON.stringify(this.memoryState, null, 2)}\n`);
+        }
+        finally {
+            closeSync(fd);
+        }
+        renameSync(tempPath, this.path);
+        this.dirty = false;
+    }
+    async flushDirty() {
+        this.cancelTimer();
+        if (!this.dirty || !this.memoryState) {
+            return;
+        }
+        await this.writeToDisk(this.memoryState);
+        this.dirty = false;
+    }
+    scheduleFlush() {
+        if (this.flushTimer) {
+            return;
+        }
+        const window = Math.max(0, this.coalesceWindowMs);
+        this.flushTimer = setTimeout(() => {
+            this.flushTimer = null;
+            this.flush().catch((err) => this.onError(err));
+        }, window);
+        if (typeof this.flushTimer.unref === 'function') {
+            this.flushTimer.unref();
+        }
+    }
+    cancelTimer() {
+        if (this.flushTimer) {
+            clearTimeout(this.flushTimer);
+            this.flushTimer = null;
+        }
+    }
+    async readFromDisk() {
+        const raw = await readFile(this.path, 'utf8');
+        return normalizeState(JSON.parse(raw));
+    }
+    async writeToDisk(state) {
+        await mkdir(path.dirname(this.path), { recursive: true, mode: 0o700 });
+        const tempPath = `${this.path}.${process.pid}.${Date.now()}.${randomUUID()}.tmp`;
+        const handle = await open(tempPath, 'w', 0o600);
+        try {
+            await handle.writeFile(`${JSON.stringify(state, null, 2)}\n`, 'utf8');
+        }
+        finally {
+            await handle.close();
+        }
+        await rename(tempPath, this.path);
+    }
+    enqueue(fn) {
+        const run = () => fn();
+        const result = this.updateQueue.then(run, run);
+        this.updateQueue = result.then(() => undefined, () => undefined);
+        return result;
+    }
+}
+function defaultOnError(err) {
+    console.error('FileStore: coalesced flush failed', err);
+}
+// Recursively `Object.freeze` so callers of `read()` can't accidentally mutate
+// the store's internal state without going through `update()`. Skips already
+// frozen subtrees, so freezing a new state that reuses sub-objects from the
+// previous frozen state is cheap.
+function deepFreeze(value) {
+    if (value === null || typeof value !== 'object' || Object.isFrozen(value)) {
+        return value;
+    }
+    Object.freeze(value);
+    for (const key of Object.keys(value)) {
+        deepFreeze(value[key]);
+    }
+    return value;
+}
+//# sourceMappingURL=fileStore.js.map

package/dist/server/storage/fileStore.js.map

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

package/dist/server/system/stats.d.ts

@@ -0,0 +1,2 @@
+import type { SystemStatsResponse } from '../../shared/protocol.js';
+export declare function collectSystemStats(): SystemStatsResponse;

package/dist/server/system/stats.js

@@ -0,0 +1,37 @@
+import os from 'node:os';
+let previousSample = null;
+function takeCpuSample() {
+    let idle = 0;
+    let total = 0;
+    for (const cpu of os.cpus()) {
+        const t = cpu.times;
+        idle += t.idle;
+        total += t.user + t.nice + t.sys + t.idle + t.irq;
+    }
+    return { idle, total };
+}
+export function collectSystemStats() {
+    const sample = takeCpuSample();
+    let cpuPercent = null;
+    if (previousSample !== null) {
+        const totalDelta = sample.total - previousSample.total;
+        const idleDelta = sample.idle - previousSample.idle;
+        if (totalDelta > 0) {
+            const busy = Math.max(0, 1 - idleDelta / totalDelta);
+            cpuPercent = Math.round(busy * 1000) / 10;
+        }
+    }
+    previousSample = sample;
+    const totalBytes = os.totalmem();
+    const freeBytes = os.freemem();
+    const usedBytes = Math.max(0, totalBytes - freeBytes);
+    const memoryPercent = totalBytes > 0 ? Math.round((usedBytes / totalBytes) * 1000) / 10 : 0;
+    return {
+        cpuPercent,
+        memoryPercent,
+        memoryUsedBytes: usedBytes,
+        memoryTotalBytes: totalBytes,
+        cores: os.cpus().length
+    };
+}
+//# sourceMappingURL=stats.js.map

package/dist/server/system/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../../src/server/system/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAgBzB,IAAI,cAAc,GAA0B,IAAI,CAAC;AAEjD,SAAS,aAAa;IACpB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,GAAG,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5B,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC;QACpB,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC;QACf,KAAK,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC;IACpD,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;QAC5B,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC;QACvD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC;QACpD,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,GAAG,UAAU,CAAC,CAAC;YACrD,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5C,CAAC;IACH,CAAC;IACD,cAAc,GAAG,MAAM,CAAC;IAExB,MAAM,UAAU,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IACjC,MAAM,SAAS,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC,CAAC;IACtD,MAAM,aAAa,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5F,OAAO;QACL,UAAU;QACV,aAAa;QACb,eAAe,EAAE,SAAS;QAC1B,gBAAgB,EAAE,UAAU;QAC5B,KAAK,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM;KACxB,CAAC;AACJ,CAAC"}

package/dist/server/terminal/NodePtyAdapter.d.ts

@@ -0,0 +1,4 @@
+import type { PtyAdapter, PtyProcess, PtySpawnOptions } from './PtyAdapter.js';
+export declare class NodePtyAdapter implements PtyAdapter {
+    spawn(options: PtySpawnOptions): PtyProcess;
+}

package/dist/server/terminal/NodePtyAdapter.js

@@ -0,0 +1,14 @@
+import * as nodePty from 'node-pty';
+export class NodePtyAdapter {
+    spawn(options) {
+        const pty = nodePty.spawn(options.shell, [], {
+            name: 'xterm-256color',
+            cols: options.cols,
+            rows: options.rows,
+            cwd: options.cwd,
+            env: options.env
+        });
+        return pty;
+    }
+}
+//# sourceMappingURL=NodePtyAdapter.js.map

package/dist/server/terminal/NodePtyAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodePtyAdapter.js","sourceRoot":"","sources":["../../../src/server/terminal/NodePtyAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,UAAU,CAAC;AAGpC,MAAM,OAAO,cAAc;IACzB,KAAK,CAAC,OAAwB;QAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE;YAC3C,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC,CAAC;QACH,OAAO,GAAG,CAAC;IACb,CAAC;CACF"}

package/dist/server/terminal/PtyAdapter.d.ts

@@ -0,0 +1,57 @@
+import type { TerminalTranscriptProvider } from '../../shared/protocol.js';
+export interface PtyExit {
+    exitCode: number | null;
+}
+export interface PtyProcess {
+    pid: number;
+    write(data: string): void;
+    resize(cols: number, rows: number): void;
+    pause(): void;
+    resume(): void;
+    kill(): void;
+    onData(listener: (data: string) => void): Disposable;
+    onExit(listener: (event: PtyExit) => void): Disposable;
+}
+export interface Disposable {
+    dispose(): void;
+}
+export interface PtySpawnOptions {
+    sessionId: string;
+    shell: string;
+    cwd: string;
+    cols: number;
+    rows: number;
+    env: NodeJS.ProcessEnv;
+}
+export interface PersistedSession {
+    sessionId: string;
+    title?: string;
+}
+export interface PtyHistoryCapture {
+    startLine: number;
+    endLine: number;
+    hasMore: boolean;
+    output: string[];
+}
+export interface PtyHistoryCaptureOptions {
+    beforeLine?: number;
+    limit: number;
+}
+export interface PtyTranscriptSource {
+    provider: TerminalTranscriptProvider;
+    sessionId: string;
+    filePath: string;
+}
+export interface PtyAdapter {
+    spawn(options: PtySpawnOptions & {
+        title?: string;
+    }): PtyProcess;
+    listExisting?(): PersistedSession[];
+    setSessionTitle?(sessionId: string, title: string): void;
+    pollSessions?(): Promise<Map<string, {
+        currentCommand: string;
+        busy: boolean;
+    }>>;
+    captureHistory?(sessionId: string, options: PtyHistoryCaptureOptions): PtyHistoryCapture | null;
+    resolveTranscriptSource?(sessionId: string): PtyTranscriptSource | null;
+}

package/dist/server/terminal/PtyAdapter.js

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

package/dist/server/terminal/PtyAdapter.js.map

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

package/dist/server/terminal/TerminalManager.d.ts

@@ -0,0 +1,74 @@
+import type { AppConfig } from '../config.js';
+import type { ServerTerminalMessage, TerminalHistoryCursor, TerminalHistoryResponse, TerminalTranscriptHistoryResponse, TerminalTranscriptSourceResponse } from '../../shared/protocol.js';
+import type { TerminalId, TerminalSummary } from '../../shared/types.js';
+import type { PtyAdapter } from './PtyAdapter.js';
+export interface CreateTerminalOptions {
+    parentTerminalId?: TerminalId;
+    cwd?: string;
+    cols?: number;
+    rows?: number;
+}
+export interface AttachTerminalOptions {
+    replay?: boolean;
+}
+export interface TerminalAttachment {
+    terminal: TerminalSummary;
+    output: string[];
+    history: TerminalHistoryCursor | null;
+    pause(): void;
+    resume(): void;
+    dispose(): void;
+}
+export interface TerminalManagerOptions {
+    resolveCwd?: (pid: number) => Promise<string | null>;
+    now?: () => Date;
+}
+type TerminalSubscriber = (message: ServerTerminalMessage) => void;
+export declare class TerminalManager {
+    private readonly config;
+    private readonly ptyAdapter;
+    private readonly terminals;
+    private readonly resolveCwd;
+    private readonly now;
+    private readonly shellBasename;
+    private statusPollTimer;
+    private statusPollInflight;
+    constructor(config: AppConfig, ptyAdapter: PtyAdapter, options?: TerminalManagerOptions);
+    private startStatusPoller;
+    private pollOnce;
+    dispose(): void;
+    createTerminal(options?: CreateTerminalOptions): Promise<TerminalSummary>;
+    restoreSessions(): Promise<void>;
+    private wireUpPty;
+    private reattachToSession;
+    private captureTerminalHistoryCursor;
+    listTerminals(): TerminalSummary[];
+    getTerminal(id: TerminalId): TerminalSummary | null;
+    getOutputSnapshot(id: TerminalId): string[] | null;
+    getTerminalHistory(id: TerminalId, options?: {
+        beforeLine?: number;
+        limit?: number;
+    }): TerminalHistoryResponse | null;
+    getTerminalTranscriptHistory(id: TerminalId, options?: {
+        cursor?: string;
+        limit?: number;
+    }): TerminalTranscriptHistoryResponse | null;
+    getTerminalTranscriptSource(id: TerminalId): TerminalTranscriptSourceResponse | null;
+    resolveTerminalCwd(id: TerminalId): Promise<string | null>;
+    renameTerminal(id: TerminalId, title: string): TerminalSummary | null;
+    refreshTerminalCwd(id: TerminalId): Promise<TerminalSummary | null>;
+    attachTerminal(id: TerminalId, subscriber: TerminalSubscriber, options?: AttachTerminalOptions): TerminalAttachment | null;
+    writeToTerminal(id: TerminalId, data: string): boolean;
+    resizeTerminal(id: TerminalId, cols: number, rows: number): boolean;
+    closeTerminal(id: TerminalId): boolean;
+    closeAll(): void;
+    private ensureAttached;
+    private resolveInitialCwd;
+    private safeResolveCwd;
+    private refreshCwd;
+    private publish;
+    private disposeRecord;
+    private createTitle;
+    private timestamp;
+}
+export {};