@xrkseek/harness 0.4.12 → 0.5.1

package/node_modules/@xrkseek/server-host/dist/sidebar-pty-agent.js

@@ -0,0 +1,98 @@
+/**
+ * Isolated node-pty worker for Desktop Host.
+ *
+ * Electron spawns Host with framed pipes on fds 3/4. In-process ConPTY
+ * (node-pty 1.2 Windows path) can take down that whole process when the
+ * first sidebar terminal opens. This worker runs under a fresh Node child
+ * so ConPTY never shares the Host pipe fds.
+ *
+ * Protocol (IPC): parent → spawn | write | resize | kill;
+ * worker → ready | data | exit | error.
+ */
+import { createRequire } from "node:module";
+import { clearDesktopHostPipeInheritFlags } from "./win-fd-inherit.js";
+let term;
+function send(msg) {
+    if (typeof process.send === "function") {
+        try {
+            process.send(msg);
+        }
+        catch {
+            /* parent gone */
+        }
+    }
+}
+process.on("message", (raw) => {
+    const msg = raw;
+    if (!msg || typeof msg !== "object" || !("type" in msg))
+        return;
+    if (msg.type === "spawn") {
+        if (term !== undefined) {
+            send({ type: "error", message: "pty already spawned" });
+            return;
+        }
+        void (async () => {
+            try {
+                // Worker may still hold inheritable copies of Host Face/IPC HANDLEs if
+                // the pre-fork clear missed one. Clear again immediately before ConPTY.
+                clearDesktopHostPipeInheritFlags();
+                // Resolve from this worker's node_modules (Host deploy tree).
+                const require = createRequire(import.meta.url);
+                const ptyMod = require("node-pty");
+                term = ptyMod.spawn(msg.file, [...msg.args], {
+                    name: "xterm-256color",
+                    cols: msg.cols,
+                    rows: msg.rows,
+                    cwd: msg.cwd,
+                    env: msg.env,
+                    ...(process.platform === "win32"
+                        ? { useConpty: true, conptyInheritCursor: false }
+                        : {}),
+                });
+                term.onData((data) => {
+                    send({ type: "data", data });
+                });
+                term.onExit(() => {
+                    send({ type: "exit" });
+                });
+                send({ type: "ready" });
+            }
+            catch (error) {
+                send({
+                    type: "error",
+                    message: error instanceof Error ? error.message : String(error),
+                });
+            }
+        })();
+        return;
+    }
+    if (msg.type === "write") {
+        try {
+            term?.write(msg.data);
+        }
+        catch {
+            /* ignore */
+        }
+        return;
+    }
+    if (msg.type === "resize") {
+        try {
+            term?.resize(msg.cols, msg.rows);
+        }
+        catch {
+            /* ignore */
+        }
+        return;
+    }
+    if (msg.type === "kill") {
+        try {
+            term?.kill();
+        }
+        catch {
+            /* ignore */
+        }
+        term = undefined;
+        process.exit(0);
+    }
+});
+//# sourceMappingURL=sidebar-pty-agent.js.map

package/node_modules/@xrkseek/server-host/dist/sidebar-pty-agent.js.map

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

package/node_modules/@xrkseek/server-host/dist/sidebar-pty-worker.d.ts

@@ -0,0 +1,18 @@
+export declare function useDesktopPtyWorker(): boolean;
+export interface DesktopPtyWorkerHandle {
+    write(data: string): void;
+    resize(cols: number, rows: number): void;
+    kill(): void;
+    onData(cb: (data: string) => void): {
+        dispose(): void;
+    };
+    onExit(cb: () => void): {
+        dispose(): void;
+    };
+}
+/**
+ * Fork the pty agent. Re-clears Host pipe inherit flags immediately before
+ * CreateProcess so ConPTY cannot inherit Electron framed HANDLEs.
+ */
+export declare function spawnDesktopPtyWorker(file: string, args: readonly string[], cwd: string, cols: number, rows: number, env: Record<string, string>): Promise<DesktopPtyWorkerHandle>;
+//# sourceMappingURL=sidebar-pty-worker.d.ts.map

package/node_modules/@xrkseek/server-host/dist/sidebar-pty-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar-pty-worker.d.ts","sourceRoot":"","sources":["../src/sidebar-pty-worker.ts"],"names":[],"mappings":"AAUA,wBAAgB,mBAAmB,IAAI,OAAO,CAI7C;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,IAAI,IAAI,IAAI,CAAC;IACb,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG;QAAE,OAAO,IAAI,IAAI,CAAA;KAAE,CAAC;IACxD,MAAM,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,IAAI,CAAA;KAAE,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,OAAO,CAAC,sBAAsB,CAAC,CA6HjC"}

package/node_modules/@xrkseek/server-host/dist/sidebar-pty-worker.js

@@ -0,0 +1,141 @@
+/**
+ * Desktop Host PTY worker: fork {@link ./sidebar-pty-agent.js} so Win32 ConPTY
+ * never runs inside the process that owns Electron framed pipes (fds 3/4).
+ */
+import { fork } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import { clearDesktopHostPipeInheritFlags } from "./win-fd-inherit.js";
+const PTY_DEPS_MISSING = "pty-deps-missing";
+export function useDesktopPtyWorker() {
+    // Loopback Face (ADR-0008 / DSH): ConPTY may run in-process — no Electron
+    // Face pipes to inherit. Keep the worker module for tests / opt-in only.
+    return process.env.XRK_DESKTOP_PTY_WORKER === "1";
+}
+/**
+ * Fork the pty agent. Re-clears Host pipe inherit flags immediately before
+ * CreateProcess so ConPTY cannot inherit Electron framed HANDLEs.
+ */
+export function spawnDesktopPtyWorker(file, args, cwd, cols, rows, env) {
+    // Last chance before CreateProcess — pipe-runtime cleared at boot, but any
+    // later code may have re-opened inheritable HANDLEs; ConPTY is unforgiving.
+    clearDesktopHostPipeInheritFlags();
+    const agent = fileURLToPath(new URL("./sidebar-pty-agent.js", import.meta.url));
+    const child = fork(agent, [], {
+        // Do not inherit Host stderr (or any stdio) — on Windows inheritable
+        // Electron pipe HANDLEs (fds 3/4) must stay out of the ConPTY process.
+        stdio: ["ignore", "ignore", "ignore", "ipc"],
+        env,
+        // Electron-typed @types/node ForkOptions omits windowsHide; Node accepts it.
+        ...{ windowsHide: true },
+    });
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const dataHandlers = new Set();
+        const exitHandlers = new Set();
+        let exited = false;
+        const fail = (error) => {
+            if (settled)
+                return;
+            settled = true;
+            try {
+                child.kill();
+            }
+            catch {
+                /* ignore */
+            }
+            reject(error);
+        };
+        const onMessage = (raw) => {
+            if (!raw || typeof raw !== "object" || !("type" in raw))
+                return;
+            const msg = raw;
+            if (msg.type === "ready") {
+                if (settled)
+                    return;
+                settled = true;
+                resolve({
+                    write(data) {
+                        child.send({ type: "write", data });
+                    },
+                    resize(nextCols, nextRows) {
+                        child.send({ type: "resize", cols: nextCols, rows: nextRows });
+                    },
+                    kill() {
+                        try {
+                            child.send({ type: "kill" });
+                        }
+                        catch {
+                            /* ignore */
+                        }
+                        try {
+                            child.kill();
+                        }
+                        catch {
+                            /* ignore */
+                        }
+                    },
+                    onData(cb) {
+                        dataHandlers.add(cb);
+                        return {
+                            dispose() {
+                                dataHandlers.delete(cb);
+                            },
+                        };
+                    },
+                    onExit(cb) {
+                        exitHandlers.add(cb);
+                        return {
+                            dispose() {
+                                exitHandlers.delete(cb);
+                            },
+                        };
+                    },
+                });
+                return;
+            }
+            if (msg.type === "data" && typeof msg.data === "string") {
+                for (const cb of dataHandlers)
+                    cb(msg.data);
+                return;
+            }
+            if (msg.type === "exit") {
+                if (exited)
+                    return;
+                exited = true;
+                for (const cb of exitHandlers)
+                    cb();
+                return;
+            }
+            if (msg.type === "error") {
+                fail(new Error(typeof msg.message === "string" && msg.message.length > 0
+                    ? msg.message
+                    : PTY_DEPS_MISSING));
+            }
+        };
+        child.on("message", onMessage);
+        child.on("error", (error) => {
+            fail(error instanceof Error ? error : new Error(String(error)));
+        });
+        child.on("exit", () => {
+            if (!settled) {
+                fail(new Error(PTY_DEPS_MISSING));
+                return;
+            }
+            if (exited)
+                return;
+            exited = true;
+            for (const cb of exitHandlers)
+                cb();
+        });
+        child.send({
+            type: "spawn",
+            file,
+            args,
+            cwd,
+            cols,
+            rows,
+            env,
+        });
+    });
+}
+//# sourceMappingURL=sidebar-pty-worker.js.map

package/node_modules/@xrkseek/server-host/dist/sidebar-pty-worker.js.map

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

package/node_modules/@xrkseek/server-host/dist/sidebar-pty.d.ts

@@ -14,7 +14,7 @@
  * be reported into Face `hasPtyActivity` — Agent `/permission` sandbox changes
  * stay independent of open sidebar tabs.
  */
-import type { IncomingMessage, Server } from "node:http";
+import type { IncomingMessage, Server, ServerResponse } from "node:http";
 import type { AgentOpenRegistry } from "./sidebar-agent-opens.js";
 import type { AgentPtyRegistry } from "./sidebar-agent-pty.js";
 export interface SidebarPtyOptions {
@@ -25,10 +25,17 @@ export interface SidebarPtyOptions {
     /** `sidebar_open` registry — drives `/sidebar/ws/agent-opens`. */
     readonly agentOpens?: AgentOpenRegistry;
 }
+/** Host-side handle: WS upgrades + Desktop HTTP/SSE (no TCP listen). */
+export interface SidebarPtyHandle {
+    close(): void;
+    /**
+     * Desktop `xrk-app://` cannot upgrade WebSockets. Same PTY slots over
+     * `/sidebar/api/pty/*` (SSE stream + POST input/control).
+     */
+    tryHandleHttp(req: IncomingMessage, res: ServerResponse): boolean;
+}
 /**
  * Attach `/sidebar/ws/terminal`, `/sidebar/ws/agent-terminals`, `/sidebar/ws/agent-opens`.
  */
-export declare function attachSidebarPtyUpgrades(server: Server, options: SidebarPtyOptions): {
-    close(): void;
-};
+export declare function attachSidebarPtyUpgrades(server: Server, options: SidebarPtyOptions): SidebarPtyHandle;
 //# sourceMappingURL=sidebar-pty.d.ts.map

package/node_modules/@xrkseek/server-host/dist/sidebar-pty.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sidebar-pty.d.ts","sourceRoot":"","sources":["../src/sidebar-pty.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAIzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAM/D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC;IACtD,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IACrC,kEAAkE;IAClE,QAAQ,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC;CACzC;AAiJD;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,GACzB;IAAE,KAAK,IAAI,IAAI,CAAA;CAAE,CA+anB"}
+{"version":3,"file":"sidebar-pty.d.ts","sourceRoot":"","sources":["../src/sidebar-pty.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAIzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAQ/D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC;IACtD,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IACrC,kEAAkE;IAClE,QAAQ,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC;CACzC;AAuJD,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,IAAI,IAAI,CAAC;IACd;;;OAGG;IACH,aAAa,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC;CACnE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,GACzB,gBAAgB,CAkyBlB"}