parasor 0.1.0

package/server/pty/headless-replay-snapshot.js

@@ -0,0 +1,285 @@
+import { Buffer } from "node:buffer";
+import * as xtermHeadless from "@xterm/headless";
+function resolveTerminalCtor() {
+    const ctor = xtermHeadless.Terminal ??
+        xtermHeadless.default?.Terminal;
+    if (!ctor) {
+        throw new Error("@xterm/headless Terminal constructor unavailable");
+    }
+    return ctor;
+}
+const TerminalCtor = resolveTerminalCtor();
+function clampPositiveInteger(value, fallback) {
+    return Number.isSafeInteger(value) && value > 0 ? value : fallback;
+}
+function utf8Tail(text, maxBytes) {
+    const buf = Buffer.from(text, "utf8");
+    if (buf.length <= maxBytes)
+        return text;
+    const slice = buf.subarray(buf.length - maxBytes);
+    let start = 0;
+    while (start < slice.length && start < 3 && (slice[start] & 0xc0) === 0x80) {
+        start++;
+    }
+    return slice.subarray(start).toString("utf8");
+}
+function writeTerminal(term, data) {
+    return new Promise((resolve) => {
+        term.write(data, resolve);
+    });
+}
+function colorSgr(mode, color, foreground) {
+    if (mode === 0 || color < 0)
+        return [];
+    const base = foreground ? 30 : 40;
+    if (mode === 0x01_00_00_00) {
+        return [String(color < 8 ? base + color : base + 60 + (color - 8))];
+    }
+    if (mode === 0x02_00_00_00) {
+        return [foreground ? "38" : "48", "5", String(color)];
+    }
+    if (mode === 0x03_00_00_00) {
+        return [
+            foreground ? "38" : "48",
+            "2",
+            String((color >> 16) & 0xff),
+            String((color >> 8) & 0xff),
+            String(color & 0xff),
+        ];
+    }
+    return [];
+}
+function cellSgr(cell) {
+    const codes = [
+        ...(cell.isBold() ? ["1"] : []),
+        ...(cell.isItalic() ? ["3"] : []),
+        ...(cell.isUnderline() ? ["4"] : []),
+        ...colorSgr(cell.getFgColorMode(), cell.getFgColor(), true),
+        ...colorSgr(cell.getBgColorMode(), cell.getBgColor(), false),
+    ];
+    return codes.length === 0 ? "" : `\x1b[${codes.join(";")}m`;
+}
+function cellHasSerializedAttrs(cell) {
+    return Boolean(cell.isBold() ||
+        cell.isItalic() ||
+        cell.isUnderline() ||
+        cell.getFgColorMode() !== 0 ||
+        cell.getBgColorMode() !== 0);
+}
+function sameCellAttrs(left, right) {
+    return (left !== null &&
+        left.isBold() === right.isBold() &&
+        left.isItalic() === right.isItalic() &&
+        left.isUnderline() === right.isUnderline() &&
+        left.getFgColorMode() === right.getFgColorMode() &&
+        left.getFgColor() === right.getFgColor() &&
+        left.getBgColorMode() === right.getBgColorMode() &&
+        left.getBgColor() === right.getBgColor());
+}
+function clampInteger(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+function lineCursorEndColumn(line) {
+    if (!line)
+        return 0;
+    let lastColumn = -1;
+    let lastWidth = 1;
+    for (let column = line.length - 1; column >= 0; column -= 1) {
+        const cell = line.getCell(column);
+        if (!cell || cell.getWidth() === 0)
+            continue;
+        if ((cell.getChars() || " ") === " ")
+            continue;
+        lastColumn = column;
+        lastWidth = Math.max(1, cell.getWidth());
+        break;
+    }
+    return lastColumn < 0 ? 0 : Math.min(line.length - 1, lastColumn + lastWidth);
+}
+function lineHasSerializedContent(line) {
+    if (!line)
+        return false;
+    for (let column = line.length - 1; column >= 0; column -= 1) {
+        const cell = line.getCell(column);
+        if (!cell || cell.getWidth() === 0)
+            continue;
+        if ((cell.getChars() || " ") !== " ")
+            return true;
+        if (cellHasSerializedAttrs(cell))
+            return true;
+    }
+    return false;
+}
+function serializeLine(line) {
+    if (!line)
+        return "";
+    let lastColumn = -1;
+    for (let column = line.length - 1; column >= 0; column -= 1) {
+        const cell = line.getCell(column);
+        if (!cell || cell.getWidth() === 0)
+            continue;
+        if ((cell.getChars() || " ") === " " && !cellHasSerializedAttrs(cell)) {
+            continue;
+        }
+        lastColumn = column;
+        break;
+    }
+    if (lastColumn < 0)
+        return "";
+    let serialized = "";
+    let previousCell = null;
+    let hasAttrs = false;
+    for (let column = 0; column <= lastColumn; column++) {
+        const cell = line.getCell(column);
+        if (!cell)
+            continue;
+        const width = cell.getWidth();
+        if (width === 0)
+            continue;
+        const chars = cell.getChars() || " ";
+        if (!sameCellAttrs(previousCell, cell)) {
+            if (hasAttrs)
+                serialized += "\x1b[0m";
+            const sgr = cellSgr(cell);
+            if (sgr !== "") {
+                serialized += sgr;
+                hasAttrs = true;
+            }
+            else {
+                hasAttrs = false;
+            }
+            previousCell = cell;
+        }
+        serialized += chars;
+    }
+    return hasAttrs ? `${serialized}\x1b[0m` : serialized;
+}
+function snapshotTerminal(term, options) {
+    const buffer = term.buffer.active;
+    const cursorAbsY = buffer.baseY + buffer.cursorY;
+    const cursorX = clampInteger(buffer.cursorX, 0, Math.max(0, term.cols - 1));
+    const start = Math.max(0, buffer.length - (options.scrollbackLines + options.rows));
+    let end = buffer.length;
+    while (end > start) {
+        if (end - 1 <= cursorAbsY)
+            break;
+        if (lineHasSerializedContent(buffer.getLine(end - 1)))
+            break;
+        end -= 1;
+    }
+    const reversedLines = [];
+    let snapshotBytes = 0;
+    for (let i = end - 1; i >= start; i -= 1) {
+        const line = serializeLine(buffer.getLine(i));
+        const separatorBytes = reversedLines.length === 0 ? 0 : 2;
+        const lineBytes = Buffer.byteLength(line, "utf8");
+        const nextBytes = snapshotBytes + separatorBytes + lineBytes;
+        if (nextBytes > options.maxBytes) {
+            const remainingBytes = options.maxBytes - snapshotBytes - separatorBytes;
+            if (remainingBytes > 0) {
+                const partialLine = utf8Tail(line, remainingBytes);
+                if (partialLine.length > 0) {
+                    reversedLines.push({
+                        bufferIndex: i,
+                        text: partialLine,
+                        complete: false,
+                    });
+                }
+            }
+            break;
+        }
+        reversedLines.push({ bufferIndex: i, text: line, complete: true });
+        snapshotBytes = nextBytes;
+    }
+    const rows = reversedLines.reverse();
+    const lines = rows.map((row) => row.text);
+    let text = lines.join("\r\n");
+    const firstBufferIndex = rows[0]?.bufferIndex;
+    const lastBufferIndex = rows.at(-1)?.bufferIndex;
+    if (firstBufferIndex !== undefined && lastBufferIndex !== undefined) {
+        const cursorRowInSnapshot = cursorAbsY - firstBufferIndex;
+        const visibleStartInSnapshot = Math.max(0, lines.length - options.rows);
+        const visibleCursorRow = cursorRowInSnapshot - visibleStartInSnapshot;
+        const naturalCursorRow = Math.min(lines.length - 1, options.rows - 1);
+        const naturalCursorX = lineCursorEndColumn(buffer.getLine(lastBufferIndex));
+        const cursorRowComplete = rows.find((row) => row.bufferIndex === cursorAbsY)?.complete ?? false;
+        const cursorIsVisible = cursorRowComplete &&
+            cursorAbsY >= firstBufferIndex &&
+            cursorAbsY <= lastBufferIndex &&
+            visibleCursorRow >= 0 &&
+            visibleCursorRow < options.rows;
+        const cursorNeedsRestore = cursorIsVisible &&
+            (visibleCursorRow !== naturalCursorRow || cursorX !== naturalCursorX);
+        if (cursorNeedsRestore) {
+            const restore = `\x1b[${visibleCursorRow + 1};${cursorX + 1}H`;
+            if (Buffer.byteLength(text + restore, "utf8") <= options.maxBytes) {
+                text += restore;
+            }
+        }
+    }
+    return {
+        text,
+        snapshotBytes: Buffer.byteLength(text, "utf8"),
+        bufferLines: buffer.length,
+        emittedLines: lines.length,
+    };
+}
+export class HeadlessTerminalState {
+    term;
+    cols;
+    rows;
+    scrollbackLines;
+    maxBytes;
+    rawBytes = 0;
+    pendingWrite = Promise.resolve();
+    constructor(options) {
+        this.cols = clampPositiveInteger(options.cols, 80);
+        this.rows = clampPositiveInteger(options.rows, 24);
+        this.scrollbackLines = clampPositiveInteger(options.scrollbackLines, 10_000);
+        this.maxBytes = clampPositiveInteger(options.maxBytes, 1024 * 1024);
+        this.term = new TerminalCtor({
+            cols: this.cols,
+            rows: this.rows,
+            scrollback: this.scrollbackLines,
+            allowProposedApi: true,
+        });
+    }
+    write(data) {
+        this.rawBytes += Buffer.byteLength(data, "utf8");
+        this.pendingWrite = this.pendingWrite.then(() => writeTerminal(this.term, data));
+        return this.pendingWrite;
+    }
+    async snapshot() {
+        const startedAt = performance.now();
+        await this.pendingWrite;
+        return {
+            ...snapshotTerminal(this.term, {
+                scrollbackLines: this.scrollbackLines,
+                rows: this.rows,
+                maxBytes: this.maxBytes,
+            }),
+            rawBytes: this.rawBytes,
+            durationMs: Math.round((performance.now() - startedAt) * 10) / 10,
+        };
+    }
+}
+export async function buildHeadlessReplaySnapshot(raw, options) {
+    const startedAt = performance.now();
+    const cols = clampPositiveInteger(options.cols, 80);
+    const rows = clampPositiveInteger(options.rows, 24);
+    const scrollbackLines = clampPositiveInteger(options.scrollbackLines, 10_000);
+    const maxBytes = clampPositiveInteger(options.maxBytes, 1024 * 1024);
+    const term = new TerminalCtor({
+        cols,
+        rows,
+        scrollback: scrollbackLines,
+        allowProposedApi: true,
+    });
+    await writeTerminal(term, raw);
+    return {
+        ...snapshotTerminal(term, { scrollbackLines, rows, maxBytes }),
+        rawBytes: Buffer.byteLength(raw, "utf8"),
+        durationMs: Math.round((performance.now() - startedAt) * 10) / 10,
+    };
+}
+//# sourceMappingURL=headless-replay-snapshot.js.map

package/server/pty/headless-replay-snapshot.js.map

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

package/server/pty/headless-terminal-state-cache.d.ts

@@ -0,0 +1,31 @@
+import { type HeadlessReplaySnapshot, type HeadlessReplaySnapshotOptions } from "./headless-replay-snapshot.js";
+export type HeadlessStateSnapshotSource = "headless-state" | "headless-rebuild";
+export interface HeadlessTerminalStateCacheOptions extends HeadlessReplaySnapshotOptions {
+    maxSessions: number;
+    ttlMs: number;
+    now?: () => number;
+}
+export interface HeadlessStateSnapshot {
+    source: HeadlessStateSnapshotSource;
+    snapshot: HeadlessReplaySnapshot;
+}
+export declare class HeadlessTerminalStateCache {
+    private readonly entries;
+    private readonly maxSessions;
+    private readonly ttlMs;
+    private readonly now;
+    private readonly stateOptions;
+    constructor(options: HeadlessTerminalStateCacheOptions);
+    size(): number;
+    delete(sessionId: string): void;
+    clear(): void;
+    write(sessionId: string, data: string): Promise<void>;
+    writeExisting(sessionId: string, data: string): Promise<boolean>;
+    snapshot(sessionId: string, dimensions?: Pick<HeadlessReplaySnapshotOptions, "cols" | "rows">): Promise<HeadlessStateSnapshot | null>;
+    rebuild(sessionId: string, raw: string, dimensions?: Pick<HeadlessReplaySnapshotOptions, "cols" | "rows">): Promise<HeadlessStateSnapshot | null>;
+    private touch;
+    private replace;
+    private pruneExpired;
+    private evictOverflow;
+}
+//# sourceMappingURL=headless-terminal-state-cache.d.ts.map

package/server/pty/headless-terminal-state-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless-terminal-state-cache.d.ts","sourceRoot":"","sources":["../../src/pty/headless-terminal-state-cache.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,6BAA6B,EAEnC,MAAM,+BAA+B,CAAC;AAEvC,MAAM,MAAM,2BAA2B,GAAG,gBAAgB,GAAG,kBAAkB,CAAC;AAEhF,MAAM,WAAW,iCACf,SAAQ,6BAA6B;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,2BAA2B,CAAC;IACpC,QAAQ,EAAE,sBAAsB,CAAC;CAClC;AAaD,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgC;gBAEjD,OAAO,EAAE,iCAAiC;IAYtD,IAAI,IAAI,MAAM;IAKd,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI/B,KAAK,IAAI,IAAI;IAIP,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrD,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAShE,QAAQ,CACZ,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,IAAI,CAAC,6BAA6B,EAAE,MAAM,GAAG,MAAM,CAAC,GAChE,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAkBlC,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,IAAI,CAAC,6BAA6B,EAAE,MAAM,GAAG,MAAM,CAAC,GAChE,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IAUxC,OAAO,CAAC,KAAK;IAUb,OAAO,CAAC,OAAO;IAmBf,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,aAAa;CActB"}

package/server/pty/headless-terminal-state-cache.js

@@ -0,0 +1,119 @@
+import { Buffer } from "node:buffer";
+import { HeadlessTerminalState, } from "./headless-replay-snapshot.js";
+function clampPositiveInteger(value, fallback) {
+    return Number.isSafeInteger(value) && value > 0 ? value : fallback;
+}
+export class HeadlessTerminalStateCache {
+    entries = new Map();
+    maxSessions;
+    ttlMs;
+    now;
+    stateOptions;
+    constructor(options) {
+        this.maxSessions = clampPositiveInteger(options.maxSessions, 8);
+        this.ttlMs = clampPositiveInteger(options.ttlMs, 10 * 60_000);
+        this.now = options.now ?? (() => Date.now());
+        this.stateOptions = {
+            cols: options.cols,
+            rows: options.rows,
+            scrollbackLines: options.scrollbackLines,
+            maxBytes: options.maxBytes,
+        };
+    }
+    size() {
+        this.pruneExpired();
+        return this.entries.size;
+    }
+    delete(sessionId) {
+        this.entries.delete(sessionId);
+    }
+    clear() {
+        this.entries.clear();
+    }
+    async write(sessionId, data) {
+        const entry = this.touch(sessionId);
+        await entry.state.write(data);
+    }
+    async writeExisting(sessionId, data) {
+        this.pruneExpired();
+        const entry = this.entries.get(sessionId);
+        if (!entry)
+            return false;
+        entry.lastUsedAt = this.now();
+        await entry.state.write(data);
+        return true;
+    }
+    async snapshot(sessionId, dimensions) {
+        this.pruneExpired();
+        const entry = this.entries.get(sessionId);
+        if (!entry)
+            return null;
+        if (dimensions &&
+            (entry.cols !== dimensions.cols || entry.rows !== dimensions.rows)) {
+            this.entries.delete(sessionId);
+            return null;
+        }
+        entry.lastUsedAt = this.now();
+        return {
+            source: "headless-state",
+            snapshot: await entry.state.snapshot(),
+        };
+    }
+    async rebuild(sessionId, raw, dimensions) {
+        if (Buffer.byteLength(raw, "utf8") === 0)
+            return null;
+        const entry = this.replace(sessionId, dimensions);
+        await entry.state.write(raw);
+        return {
+            source: "headless-rebuild",
+            snapshot: await entry.state.snapshot(),
+        };
+    }
+    touch(sessionId) {
+        this.pruneExpired();
+        const existing = this.entries.get(sessionId);
+        if (existing) {
+            existing.lastUsedAt = this.now();
+            return existing;
+        }
+        return this.replace(sessionId);
+    }
+    replace(sessionId, dimensions) {
+        const stateOptions = {
+            ...this.stateOptions,
+            ...dimensions,
+        };
+        const entry = {
+            state: new HeadlessTerminalState(stateOptions),
+            lastUsedAt: this.now(),
+            cols: stateOptions.cols,
+            rows: stateOptions.rows,
+        };
+        this.entries.set(sessionId, entry);
+        this.evictOverflow();
+        return entry;
+    }
+    pruneExpired() {
+        const cutoff = this.now() - this.ttlMs;
+        for (const [sessionId, entry] of this.entries) {
+            if (entry.lastUsedAt < cutoff)
+                this.entries.delete(sessionId);
+        }
+    }
+    evictOverflow() {
+        while (this.entries.size > this.maxSessions) {
+            let oldestSessionId = null;
+            let oldestLastUsedAt = Number.POSITIVE_INFINITY;
+            for (const [sessionId, entry] of this.entries) {
+                if (entry.lastUsedAt < oldestLastUsedAt) {
+                    oldestSessionId = sessionId;
+                    oldestLastUsedAt = entry.lastUsedAt;
+                }
+            }
+            if (!oldestSessionId)
+                return;
+            this.entries.delete(oldestSessionId);
+        }
+    }
+}
+//# sourceMappingURL=headless-terminal-state-cache.js.map

package/server/pty/headless-terminal-state-cache.js.map

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

package/server/pty/hello-ack-validator.d.ts

@@ -0,0 +1,15 @@
+import type { Buffer } from "node:buffer";
+export type HelloAckValidation = {
+    ok: true;
+    connectionId: number;
+    generation: bigint;
+} | {
+    ok: false;
+    code: "frame-invalid" | "version-mismatch";
+    message: string;
+};
+/** Decode + version-compat check on a HELLO_ACK frame payload. `ourVersion`
+ *  is the server's own `PROTOCOL_VERSION` constant; injecting it lets the
+ *  test suite pin both sides of the compatibility comparison. */
+export declare function validateHelloAck(payload: Buffer, ourVersion: string): HelloAckValidation;
+//# sourceMappingURL=hello-ack-validator.d.ts.map

package/server/pty/hello-ack-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hello-ack-validator.d.ts","sourceRoot":"","sources":["../../src/pty/hello-ack-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAqB1C,MAAM,MAAM,kBAAkB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACtD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,eAAe,GAAG,kBAAkB,CAAC;IAC3C,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN;;iEAEiE;AACjE,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,kBAAkB,CAuBpB"}

package/server/pty/hello-ack-validator.js

@@ -0,0 +1,30 @@
+import { decodeJsonPayload, isCompatibleVersion, } from "./host-protocol/messages.js";
+/** Decode + version-compat check on a HELLO_ACK frame payload. `ourVersion`
+ *  is the server's own `PROTOCOL_VERSION` constant; injecting it lets the
+ *  test suite pin both sides of the compatibility comparison. */
+export function validateHelloAck(payload, ourVersion) {
+    let body;
+    try {
+        body = decodeJsonPayload(payload);
+    }
+    catch {
+        return {
+            ok: false,
+            code: "frame-invalid",
+            message: "HELLO_ACK undecodable",
+        };
+    }
+    if (!isCompatibleVersion(ourVersion, body.protocolVersion)) {
+        return {
+            ok: false,
+            code: "version-mismatch",
+            message: `daemon protocol ${body.protocolVersion} not compatible with server ${ourVersion}`,
+        };
+    }
+    return {
+        ok: true,
+        connectionId: body.connectionId,
+        generation: BigInt(body.generation),
+    };
+}
+//# sourceMappingURL=hello-ack-validator.js.map

package/server/pty/hello-ack-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hello-ack-validator.js","sourceRoot":"","sources":["../../src/pty/hello-ack-validator.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iBAAiB,EAEjB,mBAAmB,GACpB,MAAM,6BAA6B,CAAC;AAwBrC;;iEAEiE;AACjE,MAAM,UAAU,gBAAgB,CAC9B,OAAe,EACf,UAAkB;IAElB,IAAI,IAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,IAAI,GAAG,iBAAiB,CAAkB,OAAO,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,uBAAuB;SACjC,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,mBAAmB,CAAC,UAAU,EAAE,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;QAC3D,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,mBAAmB,IAAI,CAAC,eAAe,+BAA+B,UAAU,EAAE;SAC5F,CAAC;IACJ,CAAC;IACD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC;KACpC,CAAC;AACJ,CAAC"}

package/server/pty/host-daemon/bootstrap.d.ts

@@ -0,0 +1,100 @@
+import * as net from "node:net";
+import type { AppStateStore } from "../../state/app-state.js";
+import type { PtyHost } from "../host.js";
+import { PtyHostDaemon } from "./daemon.js";
+import { type DaemonPaths } from "./paths.js";
+export interface BootstrapOptions {
+    paths?: DaemonPaths;
+    host?: PtyHost;
+    store?: AppStateStore;
+    log?: (line: string) => void;
+    /** Listen on `paths.socketPath` (default true). Disable for TCP-only tests. */
+    acceptUnix?: boolean;
+    /** When ≥ 0, also accept on 127.0.0.1:<port>. 0 picks an ephemeral port. */
+    acceptTcpPort?: number;
+    /** Signals that should trigger graceful shutdown. Default: SIGTERM, SIGINT. */
+    signals?: NodeJS.Signals[];
+    /** When false, skip lockfile acquisition (tests share a runtime dir). */
+    acquireLock?: boolean;
+    /** When false, skip the  mode-marker enforcement (in-process tests). */
+    enforceModeMarker?: boolean;
+    /**
+     * AppState directory (where `state.json` lives). The  mode
+     * marker is written here so an in-process server that opens the
+     * same `state.json` collides on the same marker regardless of
+     * daemon-runtime-dir overrides. Defaults to `PARASOR_CONFIG_DIR`
+     * or `~/.config/parasor`, matching `AppStateStore`.
+     */
+    appStateDir?: string;
+    /**
+     * SIGTERM->5s->SIGKILL escalation test seams. Production
+     * defaults to `process.kill` and `setTimeout`-based sleep. Tests pass
+     * spies + virtual clock to drive the escalation deterministically
+     * without spawning real PTYs (sandbox-blocked).
+     */
+    killProcess?: (pid: number, signal: NodeJS.Signals | 0) => boolean;
+    sleep?: (ms: number) => Promise<void>;
+    /**
+     * Override the SIGTERM->SIGKILL grace window. Tests use 0 to skip the
+     * wall-clock wait intentionally.
+     */
+    shutdownGraceMs?: number;
+    /**
+     * Override the in-flight-host-call drain deadline. Defaults to 3000ms
+     * in production. Tests pass a small value to drive the timeout branch,
+     * where bootstrap must skip the daemon-shutdown marker.
+     */
+    drainTimeoutMs?: number;
+    /**
+     * Canonical absolute path of `<rootDir>/uploads`. Plumbed through to
+     * `InProcessPtyHost` so the
+     * daemon-side `buildSessionEnv` can stamp `PARASOR_UPLOAD_DIR=<dir>/<sid>`
+     * onto every spawned PTY. Without this the default-deployment
+     * (`PARASOR_PTY_DAEMON !== "0"`, i.e. remote mode) silently bypasses
+     * the per-session isolation the in-process path enforces -- a
+     * different PTY's `--add-dir` would either point at nothing or inherit a
+     * stale shared root via `setPtyEnv` from an older server. Null in tests
+     * that don't exercise the upload pipeline.
+     */
+    uploadsDir?: string | null;
+}
+export interface RunningDaemon {
+    daemon: PtyHostDaemon;
+    paths: DaemonPaths;
+    /** Bound TCP port if `acceptTcpPort` was provided, else `null`. */
+    tcpPort: number | null;
+    /** Stop accepting connections, evict the current peer, release lock. */
+    shutdown: (reason?: string) => Promise<void>;
+}
+export declare function bootstrapDaemon(opts?: BootstrapOptions): Promise<RunningDaemon>;
+/**
+ * Probes a Unix-domain socket path with a non-blocking connect.
+ *
+ *   - `connect` event   -> true  (= a daemon is listening and accepted SYN)
+ *   - `error` event     -> false (ECONNREFUSED / ENOENT / etc. -- file is
+ *                                a stale leftover, kernel decides instantly)
+ *   - timeout exceeded  -> true  (treated as "live but stalled", *not*
+ *                                "dead". Fail-closed for split-brain
+ *                                defense -- see reviewed for correctness 5th pass.)
+ *
+ * Why timeout = alive: when no listener owns `socketPath` the kernel
+ * synchronously returns ECONNREFUSED (file exists, no socket) or ENOENT
+ * (file gone), so a probe that takes longer than `timeoutMs` is almost
+ * certainly hitting a daemon whose accept loop is blocked (event loop
+ * stall, GC pause, kernel listen-backlog full). Treating that as "dead"
+ * would unlink the active socket and let a second daemon take over --
+ * exactly the split-brain scenario this probe exists to prevent. The
+ * priority axis here is stability > startup latency, so we err on the
+ * side of "another daemon is alive, refuse to boot".
+ *
+ * We open the socket and IMMEDIATELY destroy it without sending HELLO --
+ * the daemon's connection-tracking layer drops idle pre-HELLO sockets
+ * cleanly so this leaves no observable state behind.
+ *
+ * Exported only for unit testing -- the alive-detection path is also
+ * exercised end-to-end by  manual smoke tests (Unix-socket bind is
+ * blocked under macOS sandbox-exec so we can't drive a real listener
+ * from Vitest).
+ */
+export declare function isSocketActive(socketPath: string, timeoutMs: number, connectFn?: (path: string) => net.Socket): Promise<boolean>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/server/pty/host-daemon/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../../src/pty/host-daemon/bootstrap.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAOhC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAY5C,OAAO,EACL,KAAK,WAAW,EAGjB,MAAM,YAAY,CAAC;AAMpB,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,+EAA+E;IAC/E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IAC3B,yEAAyE;IACzE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,wEAAwE;IACxE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,CAAC,KAAK,OAAO,CAAC;IACnE,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,WAAW,CAAC;IACnB,mEAAmE;IACnE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,wEAAwE;IACxE,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AAID,wBAAsB,eAAe,CACnC,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,aAAa,CAAC,CAyfxB;AAmBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EAIjB,SAAS,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,GAAG,CAAC,MAAoB,GACpD,OAAO,CAAC,OAAO,CAAC,CAyBlB"}