parasor 0.1.0

package/server/port-forwarder/forwarder.js.map

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

package/server/port-scanner/scanner.d.ts

@@ -0,0 +1,24 @@
+import type { PortInfo, Session } from "@parasor/shared";
+export interface LsofEntry {
+    pid: number;
+    port: number;
+    bindsAll: boolean;
+}
+export declare function parseLsofOutput(output: string): LsofEntry[];
+export declare function buildProcessTree(psOutput: string): Map<number, Set<number>>;
+export declare function findDescendantPids(root: number, tree: Map<number, Set<number>>, maxDepth: number): Set<number>;
+export declare class PortScanner {
+    private lastResult;
+    private timer;
+    private readonly activeInterval;
+    private readonly idleInterval;
+    private onChange;
+    onPortsChanged(cb: (projectId: string, ports: PortInfo[]) => void): void;
+    start(getSessions: () => Session[], hasRecentActivity?: () => boolean): void;
+    stop(): void;
+    getProjectPorts(projectId: string): PortInfo[];
+    getAllPorts(): Record<string, PortInfo[]>;
+    private scan;
+    private diffAndNotify;
+}
+//# sourceMappingURL=scanner.d.ts.map

package/server/port-scanner/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/port-scanner/scanner.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAIzD,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,CAyB3D;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAiB3E;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,EAC9B,QAAQ,EAAE,MAAM,GACf,GAAG,CAAC,MAAM,CAAC,CAsBb;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CACT;IAEP,cAAc,CAAC,EAAE,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,IAAI,GAAG,IAAI;IAIxE,KAAK,CAAC,WAAW,EAAE,MAAM,OAAO,EAAE,EAAE,iBAAiB,CAAC,EAAE,MAAM,OAAO,GAAG,IAAI;IAqC5E,IAAI,IAAI,IAAI;IAOZ,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,EAAE;IAI9C,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;YAQ3B,IAAI;IA4DlB,OAAO,CAAC,aAAa;CAiBtB"}

package/server/port-scanner/scanner.js

@@ -0,0 +1,193 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+export function parseLsofOutput(output) {
+    const entries = [];
+    let currentPid = null;
+    for (const line of output.split("\n")) {
+        if (!line.trim())
+            continue;
+        if (line.startsWith("p")) {
+            currentPid = parseInt(line.slice(1), 10);
+        }
+        else if (line.startsWith("n") && currentPid !== null) {
+            const addr = line.slice(1);
+            const colonIdx = addr.lastIndexOf(":");
+            if (colonIdx === -1)
+                continue;
+            const host = addr.slice(0, colonIdx);
+            const port = parseInt(addr.slice(colonIdx + 1), 10);
+            if (Number.isNaN(port))
+                continue;
+            const bindsAll = host === "*" || host === "0.0.0.0" || host === "[::]" || host === "";
+            entries.push({ pid: currentPid, port, bindsAll });
+        }
+    }
+    return entries;
+}
+export function buildProcessTree(psOutput) {
+    const tree = new Map();
+    for (const line of psOutput.split("\n")) {
+        const trimmed = line.trim();
+        const parts = trimmed.split(/\s+/);
+        if (parts.length < 2)
+            continue;
+        const pid = parseInt(parts[0], 10);
+        const ppid = parseInt(parts[1], 10);
+        if (Number.isNaN(pid) || Number.isNaN(ppid))
+            continue;
+        if (!tree.has(ppid))
+            tree.set(ppid, new Set());
+        tree.get(ppid)?.add(pid);
+    }
+    return tree;
+}
+export function findDescendantPids(root, tree, maxDepth) {
+    const result = new Set();
+    const queue = [
+        { pid: root, depth: 0 },
+    ];
+    while (queue.length > 0) {
+        const next = queue.shift();
+        if (!next)
+            break;
+        const { pid, depth } = next;
+        if (depth >= maxDepth)
+            continue;
+        const children = tree.get(pid);
+        if (!children)
+            continue;
+        for (const child of children) {
+            result.add(child);
+            queue.push({ pid: child, depth: depth + 1 });
+        }
+    }
+    return result;
+}
+export class PortScanner {
+    lastResult = new Map();
+    timer = null;
+    activeInterval = 3000;
+    idleInterval = 10000;
+    onChange = null;
+    onPortsChanged(cb) {
+        this.onChange = cb;
+    }
+    start(getSessions, hasRecentActivity) {
+        let currentInterval = this.activeInterval;
+        const tick = async () => {
+            const sessions = getSessions().filter((s) => s.state === "running" && s.pid !== null);
+            if (sessions.length === 0) {
+                for (const projectId of this.lastResult.keys()) {
+                    this.onChange?.(projectId, []);
+                }
+                this.lastResult.clear();
+                return;
+            }
+            try {
+                const result = await this.scan(sessions);
+                this.diffAndNotify(result);
+            }
+            catch {
+                // scan failure -- skip silently
+            }
+            const wantedInterval = hasRecentActivity?.()
+                ? this.activeInterval
+                : this.idleInterval;
+            if (wantedInterval !== currentInterval) {
+                currentInterval = wantedInterval;
+                if (this.timer)
+                    clearInterval(this.timer);
+                this.timer = setInterval(tick, currentInterval);
+            }
+        };
+        this.timer = setInterval(tick, currentInterval);
+        tick();
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    getProjectPorts(projectId) {
+        return this.lastResult.get(projectId) ?? [];
+    }
+    getAllPorts() {
+        const result = {};
+        for (const [k, v] of this.lastResult) {
+            result[k] = v;
+        }
+        return result;
+    }
+    async scan(sessions) {
+        const [lsofOut, psOut] = await Promise.all([
+            execFileAsync("lsof", ["-iTCP", "-sTCP:LISTEN", "-n", "-P", "-Fpn"], {
+                timeout: 5000,
+            })
+                .then((r) => r.stdout)
+                .catch(() => ""),
+            execFileAsync("ps", ["-eo", "pid,ppid"], { timeout: 5000 })
+                .then((r) => r.stdout)
+                .catch(() => ""),
+        ]);
+        const listenEntries = parseLsofOutput(lsofOut);
+        const listenByPid = new Map();
+        for (const entry of listenEntries) {
+            if (!listenByPid.has(entry.pid))
+                listenByPid.set(entry.pid, []);
+            listenByPid.get(entry.pid)?.push(entry);
+        }
+        const processTree = buildProcessTree(psOut);
+        const projectPorts = new Map();
+        const sessionsByProject = new Map();
+        for (const s of sessions) {
+            if (!sessionsByProject.has(s.projectId))
+                sessionsByProject.set(s.projectId, []);
+            sessionsByProject.get(s.projectId)?.push(s);
+        }
+        for (const [projectId, projectSessions] of sessionsByProject) {
+            const ports = [];
+            const seenPorts = new Set();
+            for (const session of projectSessions) {
+                if (!session.pid)
+                    continue;
+                const descendants = findDescendantPids(session.pid, processTree, 5);
+                descendants.add(session.pid);
+                for (const pid of descendants) {
+                    const entries = listenByPid.get(pid);
+                    if (!entries)
+                        continue;
+                    for (const entry of entries) {
+                        if (seenPorts.has(entry.port))
+                            continue;
+                        seenPorts.add(entry.port);
+                        ports.push({
+                            port: entry.port,
+                            pid: entry.pid,
+                            bindsAll: entry.bindsAll,
+                        });
+                    }
+                }
+            }
+            ports.sort((a, b) => a.port - b.port);
+            projectPorts.set(projectId, ports);
+        }
+        return projectPorts;
+    }
+    diffAndNotify(newResult) {
+        const allProjectIds = new Set([
+            ...this.lastResult.keys(),
+            ...newResult.keys(),
+        ]);
+        for (const projectId of allProjectIds) {
+            const oldPorts = this.lastResult.get(projectId) ?? [];
+            const newPorts = newResult.get(projectId) ?? [];
+            if (JSON.stringify(oldPorts) !== JSON.stringify(newPorts)) {
+                this.onChange?.(projectId, newPorts);
+            }
+        }
+        this.lastResult = newResult;
+    }
+}
+//# sourceMappingURL=scanner.js.map

package/server/port-scanner/scanner.js.map

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

package/server/pty/connection-lifecycle.d.ts

@@ -0,0 +1,50 @@
+export type RemoteConnState = "connecting" | "snapshot-pending" | "ready" | "dropped";
+export declare class ConnectionLifecycle {
+    private state;
+    private _connectionId;
+    private _generation;
+    private readonly handshakePromise;
+    private resolveHandshake;
+    private rejectHandshakePromise;
+    constructor();
+    /** Current state token. Kept as a getter so callers cannot mutate it. */
+    get current(): RemoteConnState;
+    /** Daemon-assigned connection identifier, stamped at HELLO_ACK time.
+     *  Zero before HELLO_ACK; used by the host to fill outgoing frame headers. */
+    get connectionId(): number;
+    /** Generation latch stamped at HELLO_ACK time; included in every outgoing
+     *  frame header so a fenced daemon can recognize stale connections. */
+    get generation(): bigint;
+    /** Promise that resolves once handshake completes (HELLO_ACK + first
+     *  SESSION_LIST applied) and rejects on connection drop / handshake error. */
+    get awaitReady(): Promise<void>;
+    get isDropped(): boolean;
+    get isReady(): boolean;
+    /** True iff the handshake is still in-flight (HELLO_ACK or first
+     *  SESSION_LIST has not yet been processed). */
+    get isAwaitingHandshake(): boolean;
+    /** HELLO_ACK arrived and validated by the caller. Stamps connectionId +
+     *  generation and transitions `connecting -> snapshot-pending`. Returns
+     *  false if the current state is not `connecting` (stale / duplicate ack
+     *  is silently ignored, matching the prior inline guard). */
+    applyHelloAck(connectionId: number, generation: bigint): boolean;
+    /** First SESSION_LIST applied in `snapshot-pending` -- transition to
+     *  `ready` and resolve the handshake Promise. Returns false on any other
+     *  current state (later SESSION_LIST frames just update the mirror). */
+    markReady(): boolean;
+    /** Reject the handshake Promise with `err` without changing state.
+     *  Used so a connection-level NACK (requestId=0) can surface the daemon's
+     *  specific NACK code on the awaiter, before the subsequent `drop()` chain
+     *  would otherwise reject with the generic "connection-dropped" error.
+     *  The second reject from `drop()` is a no-op because Promise rejection
+     *  is idempotent. */
+    rejectHandshakeOnly(err: Error): void;
+    /** Transition to `dropped`. Idempotent -- returns false if already dropped.
+     *  If the handshake was still awaiting, rejects the Promise with `err`
+     *  (Promise reject is itself idempotent, so a prior `rejectHandshakeOnly`
+     *  takes precedence on the awaiter side). Returns true iff state actually
+     *  transitioned, so callers can gate side effects (correlator.rejectAll,
+     *  etc.) on the transition rather than on the previous state. */
+    drop(err: Error): boolean;
+}
+//# sourceMappingURL=connection-lifecycle.d.ts.map

package/server/pty/connection-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-lifecycle.d.ts","sourceRoot":"","sources":["../../src/pty/connection-lifecycle.ts"],"names":[],"mappings":"AAuBA,MAAM,MAAM,eAAe,GACvB,YAAY,GACZ,kBAAkB,GAClB,OAAO,GACP,SAAS,CAAC;AAEd,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAgB;IACjD,OAAO,CAAC,gBAAgB,CAAc;IACtC,OAAO,CAAC,sBAAsB,CAAwB;;IAStD,yEAAyE;IACzE,IAAI,OAAO,IAAI,eAAe,CAE7B;IAED;kFAC8E;IAC9E,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;2EACuE;IACvE,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;kFAC8E;IAC9E,IAAI,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAE9B;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;oDACgD;IAChD,IAAI,mBAAmB,IAAI,OAAO,CAEjC;IAED;;;iEAG6D;IAC7D,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO;IAQhE;;4EAEwE;IACxE,SAAS,IAAI,OAAO;IAOpB;;;;;yBAKqB;IACrB,mBAAmB,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI;IAIrC;;;;;qEAKiE;IACjE,IAAI,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO;CAO1B"}

package/server/pty/connection-lifecycle.js

@@ -0,0 +1,113 @@
+/*
+ * Handshake state machine for {@link RemotePtyHost}.
+ *
+ * States:
+ *   connecting       -- HELLO sent, awaiting HELLO_ACK
+ *   snapshot-pending -- HELLO_ACK received, awaiting first SESSION_LIST
+ *   ready            -- initial SESSION_LIST applied; mirror reflects daemon snapshot.
+ *                      `awaitReady` resolves only at this point so callers never
+ *                      observe a stale (= empty) mirror after await.
+ *   dropped          -- wire dead; pending requests rejected by the host.
+ *
+ * The two-step "ack then snapshot" handshake closes a race: HELLO_ACK alone
+ * leaves `list()` returning [] until the SESSION_LIST broadcast arrives a tick
+ * later, so any caller running sync accessors immediately after
+ * `await connect()` would see a phantom empty world.
+ *
+ * Pure with respect to socket / wire -- this class owns the state machine,
+ * the connectionId + generation stamped at HELLO_ACK time (used by the host
+ * to fill outgoing frames), and the deferred handshake Promise. It does NOT
+ * write to the socket, reject correlator entries, or touch the session
+ * mirror -- those stay on {@link RemotePtyHost}.
+ */
+export class ConnectionLifecycle {
+    state = "connecting";
+    _connectionId = 0;
+    _generation = 0n;
+    handshakePromise;
+    resolveHandshake;
+    rejectHandshakePromise;
+    constructor() {
+        this.handshakePromise = new Promise((resolve, reject) => {
+            this.resolveHandshake = resolve;
+            this.rejectHandshakePromise = reject;
+        });
+    }
+    /** Current state token. Kept as a getter so callers cannot mutate it. */
+    get current() {
+        return this.state;
+    }
+    /** Daemon-assigned connection identifier, stamped at HELLO_ACK time.
+     *  Zero before HELLO_ACK; used by the host to fill outgoing frame headers. */
+    get connectionId() {
+        return this._connectionId;
+    }
+    /** Generation latch stamped at HELLO_ACK time; included in every outgoing
+     *  frame header so a fenced daemon can recognize stale connections. */
+    get generation() {
+        return this._generation;
+    }
+    /** Promise that resolves once handshake completes (HELLO_ACK + first
+     *  SESSION_LIST applied) and rejects on connection drop / handshake error. */
+    get awaitReady() {
+        return this.handshakePromise;
+    }
+    get isDropped() {
+        return this.state === "dropped";
+    }
+    get isReady() {
+        return this.state === "ready";
+    }
+    /** True iff the handshake is still in-flight (HELLO_ACK or first
+     *  SESSION_LIST has not yet been processed). */
+    get isAwaitingHandshake() {
+        return this.state === "connecting" || this.state === "snapshot-pending";
+    }
+    /** HELLO_ACK arrived and validated by the caller. Stamps connectionId +
+     *  generation and transitions `connecting -> snapshot-pending`. Returns
+     *  false if the current state is not `connecting` (stale / duplicate ack
+     *  is silently ignored, matching the prior inline guard). */
+    applyHelloAck(connectionId, generation) {
+        if (this.state !== "connecting")
+            return false;
+        this._connectionId = connectionId;
+        this._generation = generation;
+        this.state = "snapshot-pending";
+        return true;
+    }
+    /** First SESSION_LIST applied in `snapshot-pending` -- transition to
+     *  `ready` and resolve the handshake Promise. Returns false on any other
+     *  current state (later SESSION_LIST frames just update the mirror). */
+    markReady() {
+        if (this.state !== "snapshot-pending")
+            return false;
+        this.state = "ready";
+        this.resolveHandshake();
+        return true;
+    }
+    /** Reject the handshake Promise with `err` without changing state.
+     *  Used so a connection-level NACK (requestId=0) can surface the daemon's
+     *  specific NACK code on the awaiter, before the subsequent `drop()` chain
+     *  would otherwise reject with the generic "connection-dropped" error.
+     *  The second reject from `drop()` is a no-op because Promise rejection
+     *  is idempotent. */
+    rejectHandshakeOnly(err) {
+        this.rejectHandshakePromise(err);
+    }
+    /** Transition to `dropped`. Idempotent -- returns false if already dropped.
+     *  If the handshake was still awaiting, rejects the Promise with `err`
+     *  (Promise reject is itself idempotent, so a prior `rejectHandshakeOnly`
+     *  takes precedence on the awaiter side). Returns true iff state actually
+     *  transitioned, so callers can gate side effects (correlator.rejectAll,
+     *  etc.) on the transition rather than on the previous state. */
+    drop(err) {
+        if (this.state === "dropped")
+            return false;
+        const wasAwaiting = this.isAwaitingHandshake;
+        this.state = "dropped";
+        if (wasAwaiting)
+            this.rejectHandshakePromise(err);
+        return true;
+    }
+}
+//# sourceMappingURL=connection-lifecycle.js.map

package/server/pty/connection-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-lifecycle.js","sourceRoot":"","sources":["../../src/pty/connection-lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAQH,MAAM,OAAO,mBAAmB;IACtB,KAAK,GAAoB,YAAY,CAAC;IACtC,aAAa,GAAG,CAAC,CAAC;IAClB,WAAW,GAAG,EAAE,CAAC;IACR,gBAAgB,CAAgB;IACzC,gBAAgB,CAAc;IAC9B,sBAAsB,CAAwB;IAEtD;QACE,IAAI,CAAC,gBAAgB,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC5D,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC;YAChC,IAAI,CAAC,sBAAsB,GAAG,MAAM,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,yEAAyE;IACzE,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;kFAC8E;IAC9E,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED;2EACuE;IACvE,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;kFAC8E;IAC9E,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC;IAClC,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,KAAK,KAAK,OAAO,CAAC;IAChC,CAAC;IAED;oDACgD;IAChD,IAAI,mBAAmB;QACrB,OAAO,IAAI,CAAC,KAAK,KAAK,YAAY,IAAI,IAAI,CAAC,KAAK,KAAK,kBAAkB,CAAC;IAC1E,CAAC;IAED;;;iEAG6D;IAC7D,aAAa,CAAC,YAAoB,EAAE,UAAkB;QACpD,IAAI,IAAI,CAAC,KAAK,KAAK,YAAY;YAAE,OAAO,KAAK,CAAC;QAC9C,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;QAClC,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,kBAAkB,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;4EAEwE;IACxE,SAAS;QACP,IAAI,IAAI,CAAC,KAAK,KAAK,kBAAkB;YAAE,OAAO,KAAK,CAAC;QACpD,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC;QACrB,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;yBAKqB;IACrB,mBAAmB,CAAC,GAAU;QAC5B,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED;;;;;qEAKiE;IACjE,IAAI,CAAC,GAAU;QACb,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAC3C,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,CAAC;QAC7C,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,IAAI,WAAW;YAAE,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/server/pty/daemon-connect.d.ts

@@ -0,0 +1,52 @@
+import * as net from "node:net";
+/**
+ * Promise-wrap `net.connect(socketPath)`. Resolves once the socket emits
+ * `connect`, rejects with the `NodeJS.ErrnoException` from the first
+ * `error`. The success path removes the one-shot `error` listener so a
+ * later transport fault on the same socket reaches the caller's own
+ * listeners instead of an orphaned rejector.
+ */
+export declare function connectToDaemonSocket(socketPath: string): Promise<net.Socket>;
+export interface AutoSpawnInput {
+    /** `(err as NodeJS.ErrnoException).code` from the failed first connect. */
+    code: string | undefined;
+    /** Value of `process.env.PARASOR_PTY_AUTOSTART`. `"1"` forces ON, `"0"`
+     *  forces OFF, anything else (including undefined) falls back to the
+     *  default rule. */
+    explicit: string | undefined;
+    /** Result of {@link isServiceManagedDaemonInstalled} -- when true the
+     *  default is OFF (service unit is the canonical owner, spawning here
+     *  would create the unmanaged-daemon split-brain `service install` /
+     *  `restart --all` are meant to heal). */
+    serviceInstalled: boolean;
+}
+export interface AutoSpawnDecision {
+    /** True iff the errno code matched "daemon not running"
+     *  (`ECONNREFUSED` / `ENOENT`). Other codes signal "socket file exists
+     *  but daemon is unhealthy" -> never auto-spawn. */
+    noDaemon: boolean;
+    /** True iff the caller should fork the daemon and retry once. */
+    autoStart: boolean;
+}
+/** Pure derivation of the auto-spawn policy. Explicit env override always
+ *  wins; otherwise default depends on whether a service-managed daemon
+ *  unit is installed. */
+export declare function decideAutoSpawn(input: AutoSpawnInput): AutoSpawnDecision;
+export interface NoDaemonErrorMessageInput {
+    /** Original connect error -- only `.message` is read. */
+    err: Error;
+    /** Unix-domain socket path the caller was trying to reach. */
+    socketPath: string;
+    /** Output of {@link decideAutoSpawn} for the same error (drives the
+     *  "service installed but unreachable" vs "no daemon at all" branch). */
+    noDaemon: boolean;
+    /** Result of {@link isServiceManagedDaemonInstalled} -- selects between
+     *  the service-managed guidance and the casual `parasor` guidance. */
+    serviceInstalled: boolean;
+}
+/** Build the user-facing "cannot connect to daemon" message. Three
+ *  branches: noDaemon + serviceInstalled (service-managed but down),
+ *  noDaemon + !serviceInstalled (casual install path), and !noDaemon
+ *  (unhealthy socket -- daemon log is the next step). */
+export declare function formatNoDaemonError(input: NoDaemonErrorMessageInput): string;
+//# sourceMappingURL=daemon-connect.d.ts.map

package/server/pty/daemon-connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-connect.d.ts","sourceRoot":"","sources":["../../src/pty/daemon-connect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAehC;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAW7E;AAED,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB;;wBAEoB;IACpB,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B;;;8CAG0C;IAC1C,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC;;wDAEoD;IACpD,QAAQ,EAAE,OAAO,CAAC;IAClB,iEAAiE;IACjE,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;yBAEyB;AACzB,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,iBAAiB,CASxE;AAED,MAAM,WAAW,yBAAyB;IACxC,yDAAyD;IACzD,GAAG,EAAE,KAAK,CAAC;IACX,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB;6EACyE;IACzE,QAAQ,EAAE,OAAO,CAAC;IAClB;0EACsE;IACtE,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;;yDAGyD;AACzD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,yBAAyB,GAAG,MAAM,CAc5E"}

package/server/pty/daemon-connect.js

@@ -0,0 +1,62 @@
+import * as net from "node:net";
+/*
+ * Connect-side helpers split out of {@link createPtyHost}.
+ *
+ * These three pure-ish helpers cover the "first connect to the daemon
+ * Unix-domain socket" path (auto-spawn decision + connect retry + the
+ * user-facing "cannot connect" guidance string). They do NOT cover the
+ * version-mismatch recovery flow -- that orchestrator stays inline in
+ * {@link createPtyHost} (4-step sequential teardown/respawn/reconnect
+ * with per-step error wrapping) since each step injects a distinct
+ * dependency module and the value of unit-testing it is the orchestrator
+ * itself, not the leaves.
+ */
+/**
+ * Promise-wrap `net.connect(socketPath)`. Resolves once the socket emits
+ * `connect`, rejects with the `NodeJS.ErrnoException` from the first
+ * `error`. The success path removes the one-shot `error` listener so a
+ * later transport fault on the same socket reaches the caller's own
+ * listeners instead of an orphaned rejector.
+ */
+export function connectToDaemonSocket(socketPath) {
+    return new Promise((resolve, reject) => {
+        const s = net.connect(socketPath);
+        s.once("connect", () => {
+            s.removeAllListeners("error");
+            resolve(s);
+        });
+        s.once("error", (err) => {
+            reject(err);
+        });
+    });
+}
+/** Pure derivation of the auto-spawn policy. Explicit env override always
+ *  wins; otherwise default depends on whether a service-managed daemon
+ *  unit is installed. */
+export function decideAutoSpawn(input) {
+    const noDaemon = input.code === "ECONNREFUSED" || input.code === "ENOENT";
+    const autoStart = input.explicit === "1"
+        ? true
+        : input.explicit === "0"
+            ? false
+            : !input.serviceInstalled;
+    return { noDaemon, autoStart };
+}
+/** Build the user-facing "cannot connect to daemon" message. Three
+ *  branches: noDaemon + serviceInstalled (service-managed but down),
+ *  noDaemon + !serviceInstalled (casual install path), and !noDaemon
+ *  (unhealthy socket -- daemon log is the next step). */
+export function formatNoDaemonError(input) {
+    return (`parasor-pty-host: cannot connect to ${input.socketPath}: ${input.err.message}. ` +
+        (input.noDaemon
+            ? input.serviceInstalled
+                ? "A service-managed daemon is installed but not reachable. " +
+                    "Run `parasor service restart --all` to bring it back up, " +
+                    "or set PARASOR_PTY_AUTOSTART=1 to override (not recommended -- " +
+                    "bypasses the service manager and risks split-brain)."
+                : "Set PARASOR_PTY_AUTOSTART=1 (default) or start the daemon " +
+                    "(`parasor-pty-host` entry script). " +
+                    "Set PARASOR_PTY_DAEMON=0 to fall back to in-process mode."
+            : "Daemon socket is unhealthy; check the daemon log."));
+}
+//# sourceMappingURL=daemon-connect.js.map

package/server/pty/daemon-connect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon-connect.js","sourceRoot":"","sources":["../../src/pty/daemon-connect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,UAAU,CAAC;AAEhC;;;;;;;;;;;GAWG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAkB;IACtD,OAAO,IAAI,OAAO,CAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACjD,MAAM,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAClC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;YACrB,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;YAC9B,OAAO,CAAC,CAAC,CAAC,CAAC;QACb,CAAC,CAAC,CAAC;QACH,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAA0B,EAAE,EAAE;YAC7C,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAyBD;;yBAEyB;AACzB,MAAM,UAAU,eAAe,CAAC,KAAqB;IACnD,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;IAC1E,MAAM,SAAS,GACb,KAAK,CAAC,QAAQ,KAAK,GAAG;QACpB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,KAAK,CAAC,QAAQ,KAAK,GAAG;YACtB,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;IAChC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AACjC,CAAC;AAeD;;;yDAGyD;AACzD,MAAM,UAAU,mBAAmB,CAAC,KAAgC;IAClE,OAAO,CACL,uCAAuC,KAAK,CAAC,UAAU,KAAK,KAAK,CAAC,GAAG,CAAC,OAAO,IAAI;QACjF,CAAC,KAAK,CAAC,QAAQ;YACb,CAAC,CAAC,KAAK,CAAC,gBAAgB;gBACtB,CAAC,CAAC,2DAA2D;oBAC3D,2DAA2D;oBAC3D,iEAAiE;oBACjE,sDAAsD;gBACxD,CAAC,CAAC,4DAA4D;oBAC5D,qCAAqC;oBACrC,2DAA2D;YAC/D,CAAC,CAAC,mDAAmD,CAAC,CACzD,CAAC;AACJ,CAAC"}

package/server/pty/handshake-timeout-race.d.ts

@@ -0,0 +1,22 @@
+export interface RaceHandshakeWithTimeoutOpts {
+    /** Promise that resolves once the handshake completes successfully or
+     *  rejects on a wire / protocol fault detected by the caller. */
+    awaiter: Promise<void>;
+    /** Wall-clock deadline in milliseconds. */
+    timeoutMs: number;
+    /** Side effect invoked exactly once when the deadline fires before
+     *  `awaiter` settles. Production: `() => socket.destroy()`. Thrown errors
+     *  are swallowed -- the socket may already be in an error state, and the
+     *  caller still needs the typed timeout error to propagate. */
+    onTimeout: () => void;
+    /** Build the typed error rejected when the deadline fires. The configured
+     *  `timeoutMs` is passed back so the message can include it without the
+     *  caller re-encoding the value. */
+    buildTimeoutError: (timeoutMs: number) => Error;
+}
+/** Race `awaiter` against `timeoutMs`. On deadline: run `onTimeout`
+ *  (swallowing throws), then reject with `buildTimeoutError(timeoutMs)`.
+ *  The internal timer is cleared in `finally` so a late timeout cannot
+ *  resolve the race after the awaiter settled first. */
+export declare function raceHandshakeWithTimeout(opts: RaceHandshakeWithTimeoutOpts): Promise<void>;
+//# sourceMappingURL=handshake-timeout-race.d.ts.map

package/server/pty/handshake-timeout-race.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handshake-timeout-race.d.ts","sourceRoot":"","sources":["../../src/pty/handshake-timeout-race.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,4BAA4B;IAC3C;qEACiE;IACjE,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB;;;mEAG+D;IAC/D,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB;;wCAEoC;IACpC,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,KAAK,CAAC;CACjD;AAED;;;wDAGwD;AACxD,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,4BAA4B,GACjC,OAAO,CAAC,IAAI,CAAC,CAef"}

package/server/pty/handshake-timeout-race.js

@@ -0,0 +1,23 @@
+/** Race `awaiter` against `timeoutMs`. On deadline: run `onTimeout`
+ *  (swallowing throws), then reject with `buildTimeoutError(timeoutMs)`.
+ *  The internal timer is cleared in `finally` so a late timeout cannot
+ *  resolve the race after the awaiter settled first. */
+export function raceHandshakeWithTimeout(opts) {
+    let timer = null;
+    const timeoutPromise = new Promise((_, reject) => {
+        timer = setTimeout(() => {
+            try {
+                opts.onTimeout();
+            }
+            catch {
+                /* swallowed -- see opts.onTimeout doc */
+            }
+            reject(opts.buildTimeoutError(opts.timeoutMs));
+        }, opts.timeoutMs);
+    });
+    return Promise.race([opts.awaiter, timeoutPromise]).finally(() => {
+        if (timer !== null)
+            clearTimeout(timer);
+    });
+}
+//# sourceMappingURL=handshake-timeout-race.js.map

package/server/pty/handshake-timeout-race.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handshake-timeout-race.js","sourceRoot":"","sources":["../../src/pty/handshake-timeout-race.ts"],"names":[],"mappings":"AAiCA;;;wDAGwD;AACxD,MAAM,UAAU,wBAAwB,CACtC,IAAkC;IAElC,IAAI,KAAK,GAAyC,IAAI,CAAC;IACvD,MAAM,cAAc,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QACtD,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,IAAI,CAAC;gBACH,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,CAAC;YAAC,MAAM,CAAC;gBACP,yCAAyC;YAC3C,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;QACjD,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACrB,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;QAC/D,IAAI,KAAK,KAAK,IAAI;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/server/pty/headless-replay-snapshot.d.ts

@@ -0,0 +1,28 @@
+export interface HeadlessReplaySnapshotOptions {
+    cols: number;
+    rows: number;
+    scrollbackLines: number;
+    maxBytes: number;
+}
+export interface HeadlessReplaySnapshot {
+    text: string;
+    rawBytes: number;
+    snapshotBytes: number;
+    bufferLines: number;
+    emittedLines: number;
+    durationMs: number;
+}
+export declare class HeadlessTerminalState {
+    private readonly term;
+    private readonly cols;
+    private readonly rows;
+    private readonly scrollbackLines;
+    private readonly maxBytes;
+    private rawBytes;
+    private pendingWrite;
+    constructor(options: HeadlessReplaySnapshotOptions);
+    write(data: string): Promise<void>;
+    snapshot(): Promise<HeadlessReplaySnapshot>;
+}
+export declare function buildHeadlessReplaySnapshot(raw: string, options: HeadlessReplaySnapshotOptions): Promise<HeadlessReplaySnapshot>;
+//# sourceMappingURL=headless-replay-snapshot.d.ts.map

package/server/pty/headless-replay-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless-replay-snapshot.d.ts","sourceRoot":"","sources":["../../src/pty/headless-replay-snapshot.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAiQD,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqC;IAC1D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,YAAY,CAAqB;gBAE7B,OAAO,EAAE,6BAA6B;IAgBlD,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5B,QAAQ,IAAI,OAAO,CAAC,sBAAsB,CAAC;CAalD;AAED,wBAAsB,2BAA2B,CAC/C,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,sBAAsB,CAAC,CAmBjC"}