@xrkseek/harness 0.3.11 → 0.4.0-rc.2

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

@@ -0,0 +1,377 @@
+/**
+ * Agent-owned sidebar PTY registry (`terminal_create` …). Parallel to user-tab
+ * PTYs in `sidebar-pty.ts` — uuid-keyed, not counted in Face `hasPtyActivity`.
+ */
+import { randomUUID } from "node:crypto";
+import { homedir } from "node:os";
+import { BoundedTextBuffer } from "@xrkseek/exec-pty";
+/** UTF-8 byte ceiling for agent terminal transcripts (same idea as PTY scrollback). */
+const TRANSCRIPT_MAX_BYTES = 1 << 20;
+export const ALLOWED_SIGNALS = [
+    "SIGINT",
+    "SIGTERM",
+    "SIGKILL",
+    "SIGHUP",
+    "SIGTSTP",
+];
+export const DEFAULT_READ_COUNT = 500;
+export const TERMINAL_DIM_MIN = 2;
+export const TERMINAL_DIM_MAX = 1024;
+export function clampDims(cols, rows) {
+    const clamp = (value) => Math.min(TERMINAL_DIM_MAX, Math.max(TERMINAL_DIM_MIN, Math.floor(value)));
+    return { cols: clamp(cols), rows: clamp(rows) };
+}
+const SIGNAL_NAMES = {
+    1: "SIGHUP",
+    2: "SIGINT",
+    3: "SIGQUIT",
+    9: "SIGKILL",
+    15: "SIGTERM",
+    20: "SIGTSTP",
+};
+function signalNameOf(signal) {
+    if (signal === null || signal === undefined)
+        return null;
+    return SIGNAL_NAMES[signal] ?? `signal ${signal}`;
+}
+function transcriptText(handle) {
+    return handle.transcript.snapshot().text;
+}
+function locateNeedle(transcript, needle) {
+    if (needle === "")
+        return undefined;
+    const idx = transcript.indexOf(needle);
+    if (idx === -1)
+        return undefined;
+    let line = 0;
+    let lineStart = 0;
+    for (let i = 0; i < idx; i += 1) {
+        if (transcript.charCodeAt(i) === 0x0a) {
+            line += 1;
+            lineStart = i + 1;
+        }
+    }
+    return { line, column: idx - lineStart };
+}
+export function snapshotOf(handle) {
+    const out = {
+        uuid: handle.uuid,
+        title: handle.title,
+        command: handle.command,
+        exited: handle.exited,
+    };
+    if (handle.exited) {
+        return {
+            ...out,
+            exitCode: handle.exitCode ?? null,
+            exitSignal: signalNameOf(handle.exitSignal),
+        };
+    }
+    return out;
+}
+function defaultShellArgv() {
+    if (process.platform === "win32") {
+        const comspec = process.env.ComSpec?.trim();
+        return {
+            file: comspec && comspec.length > 0 ? comspec : "cmd.exe",
+            args: [],
+        };
+    }
+    const shell = process.env.SHELL?.trim();
+    return {
+        file: shell && shell.length > 0 ? shell : "/bin/bash",
+        args: ["-l"],
+    };
+}
+async function loadNodePty() {
+    try {
+        return await import("node-pty");
+    }
+    catch {
+        throw new Error("pty-deps-missing");
+    }
+}
+export class AgentPtyRegistry {
+    defaultShell;
+    defaultShellArgs;
+    sessions = new Map();
+    changeListeners = new Set();
+    constructor(defaultShell, defaultShellArgs = []) {
+        this.defaultShell = defaultShell;
+        this.defaultShellArgs = defaultShellArgs;
+    }
+    async create(sessionId, title, command, cwd, cols = 80, rows = 24, shell, shellArgs) {
+        const uuid = randomUUID();
+        const dims = clampDims(cols, rows);
+        const nodePty = await loadNodePty();
+        const fallback = defaultShellArgv();
+        const file = shell?.trim() || this.defaultShell || fallback.file;
+        const args = shellArgs ??
+            (this.defaultShellArgs.length > 0
+                ? this.defaultShellArgs
+                : shell
+                    ? []
+                    : fallback.args);
+        const env = {};
+        for (const [k, v] of Object.entries(process.env)) {
+            if (typeof v === "string")
+                env[k] = v;
+        }
+        if (!env.TERM)
+            env.TERM = "xterm-256color";
+        let pty;
+        try {
+            pty = nodePty.spawn(file, args, {
+                name: "xterm-256color",
+                cols: dims.cols,
+                rows: dims.rows,
+                cwd,
+                env,
+                ...(process.platform === "win32"
+                    ? { useConpty: true, conptyInheritCursor: false }
+                    : {}),
+            });
+        }
+        catch (first) {
+            const home = homedir();
+            if (!home || home === cwd)
+                throw first;
+            pty = nodePty.spawn(file, args, {
+                name: "xterm-256color",
+                cols: dims.cols,
+                rows: dims.rows,
+                cwd: home,
+                env,
+                ...(process.platform === "win32"
+                    ? { useConpty: true, conptyInheritCursor: false }
+                    : {}),
+            });
+        }
+        const handle = {
+            uuid,
+            sessionId,
+            title,
+            command,
+            cwd,
+            pty,
+            transcript: new BoundedTextBuffer(TRANSCRIPT_MAX_BYTES),
+            exited: false,
+            dataDisposable: { dispose() { } },
+            exitDisposable: { dispose() { } },
+        };
+        handle.dataDisposable = pty.onData((data) => {
+            handle.transcript.append(data);
+        });
+        handle.exitDisposable = pty.onExit(({ exitCode, signal }) => {
+            handle.exited = true;
+            handle.exitCode = exitCode;
+            handle.exitSignal = signal ?? null;
+            this.notify();
+        });
+        if (command !== "") {
+            try {
+                pty.write(`${command}\r`);
+            }
+            catch {
+                /* spawn race — onExit will mark exited */
+            }
+        }
+        this.sessions.set(uuid, handle);
+        this.notify();
+        return uuid;
+    }
+    list(sessionId) {
+        const out = [];
+        for (const handle of this.sessions.values()) {
+            if (handle.sessionId === sessionId)
+                out.push(snapshotOf(handle));
+        }
+        return out;
+    }
+    expect(uuid) {
+        const handle = this.sessions.get(uuid);
+        if (handle === undefined) {
+            throw new Error(`agent terminal "${uuid}" not found`);
+        }
+        return handle;
+    }
+    assertOwned(uuid, sessionId) {
+        const handle = this.expect(uuid);
+        if (handle.sessionId !== sessionId) {
+            throw new Error(`agent terminal "${uuid}" not found`);
+        }
+        return handle;
+    }
+    send(uuid, text) {
+        const handle = this.expect(uuid);
+        if (handle.exited) {
+            throw new Error(`agent terminal "${uuid}" has exited`);
+        }
+        handle.pty.write(text);
+    }
+    read(uuid, offset, count) {
+        const handle = this.expect(uuid);
+        const lines = transcriptText(handle).split("\n");
+        const totalLines = lines.length;
+        const pageSize = Math.max(1, Math.min(count ?? DEFAULT_READ_COUNT, DEFAULT_READ_COUNT));
+        let start;
+        if (offset === undefined || offset === 0)
+            start = 0;
+        else if (offset < 0)
+            start = Math.max(0, totalLines + offset);
+        else
+            start = Math.min(offset, totalLines);
+        const end = Math.min(start + pageSize, totalLines);
+        return {
+            text: lines.slice(start, end).join("\n"),
+            totalLines,
+            lineBegin: start,
+            lineEnd: end,
+        };
+    }
+    resize(uuid, cols, rows) {
+        const handle = this.expect(uuid);
+        const dims = clampDims(cols, rows);
+        if (!handle.exited)
+            handle.pty.resize(dims.cols, dims.rows);
+        return dims;
+    }
+    async waitFor(uuid, needle, timeoutMs = 10_000, signal) {
+        if (needle === "")
+            throw new Error("needle must be a non-empty string");
+        const handle = this.expect(uuid);
+        const timeout = Math.max(100, Math.floor(timeoutMs));
+        const start = Date.now();
+        const deadline = start + timeout;
+        if (handle.exited) {
+            return {
+                kind: "exited",
+                needle,
+                exitCode: handle.exitCode ?? null,
+                exitSignal: signalNameOf(handle.exitSignal),
+            };
+        }
+        const firstHit = locateNeedle(transcriptText(handle), needle);
+        if (firstHit !== undefined) {
+            return {
+                kind: "found",
+                needle,
+                line: firstHit.line,
+                column: firstHit.column,
+                elapsedMs: Date.now() - start,
+            };
+        }
+        while (true) {
+            if (signal?.aborted) {
+                throw new DOMException("aborted", "AbortError");
+            }
+            if (handle.exited) {
+                return {
+                    kind: "exited",
+                    needle,
+                    exitCode: handle.exitCode ?? null,
+                    exitSignal: signalNameOf(handle.exitSignal),
+                };
+            }
+            const hit = locateNeedle(transcriptText(handle), needle);
+            if (hit !== undefined) {
+                return {
+                    kind: "found",
+                    needle,
+                    line: hit.line,
+                    column: hit.column,
+                    elapsedMs: Date.now() - start,
+                };
+            }
+            if (Date.now() >= deadline) {
+                return {
+                    kind: "timeout",
+                    needle,
+                    timeoutMs: timeout,
+                    totalLines: transcriptText(handle).split("\n").length,
+                };
+            }
+            await new Promise((r) => {
+                const t = setTimeout(r, 50);
+                if (typeof t === "object" && "unref" in t) {
+                    t.unref();
+                }
+            });
+        }
+    }
+    signal(uuid, sig) {
+        const handle = this.expect(uuid);
+        if (handle.exited)
+            return;
+        if (sig === "SIGINT" || sig === "SIGTSTP") {
+            try {
+                handle.pty.write(sig === "SIGINT" ? "\x03" : "\x1a");
+            }
+            catch {
+                /* tearing down */
+            }
+            return;
+        }
+        try {
+            handle.pty.kill(sig);
+        }
+        catch {
+            try {
+                handle.pty.kill();
+            }
+            catch {
+                /* gone */
+            }
+        }
+    }
+    close(uuid) {
+        const handle = this.sessions.get(uuid);
+        if (handle === undefined)
+            return false;
+        this.sessions.delete(uuid);
+        try {
+            handle.dataDisposable.dispose();
+        }
+        catch {
+            /* ignore */
+        }
+        try {
+            handle.exitDisposable.dispose();
+        }
+        catch {
+            /* ignore */
+        }
+        try {
+            handle.pty.kill();
+        }
+        catch {
+            /* ignore */
+        }
+        this.notify();
+        return true;
+    }
+    get(uuid) {
+        return this.sessions.get(uuid);
+    }
+    subscribe(listener) {
+        this.changeListeners.add(listener);
+        return () => {
+            this.changeListeners.delete(listener);
+        };
+    }
+    disposeAll() {
+        for (const uuid of [...this.sessions.keys()])
+            this.close(uuid);
+    }
+    notify() {
+        for (const listener of [...this.changeListeners]) {
+            try {
+                listener();
+            }
+            catch {
+                /* ignore subscriber errors */
+            }
+        }
+    }
+}
+//# sourceMappingURL=sidebar-agent-pty.js.map

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

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

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

@@ -0,0 +1,25 @@
+/**
+ * Model-facing sidebar agent tools: `sidebar_open` + `terminal_*` (agent PTY).
+ * Bound per Agent with a closed-over sessionId (same pattern as Face subagent tools).
+ */
+import type { ToolRegistry } from "@xrkseek/core-tools";
+import { AgentOpenRegistry } from "./sidebar-agent-opens.js";
+import { AgentPtyRegistry } from "./sidebar-agent-pty.js";
+export declare function boundBytes(text: string, maxBytes: number): {
+    text: string;
+    truncated: boolean;
+};
+export interface SidebarAgentToolsOptions {
+    readonly sessionId: string;
+    readonly agentOpens: AgentOpenRegistry;
+    readonly agentPty: AgentPtyRegistry;
+    readonly resolveCwd: (sessionId: string) => string;
+    readonly readPrefs: () => Record<string, unknown>;
+    readonly readShellOverrides: () => {
+        shell?: string;
+        shellArgs?: string[];
+    };
+}
+/** Register/replace sidebar agent tools on a live Agent tool registry. */
+export declare function bindSidebarAgentTools(tools: ToolRegistry, options: SidebarAgentToolsOptions): void;
+//# sourceMappingURL=sidebar-agent-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar-agent-tools.d.ts","sourceRoot":"","sources":["../src/sidebar-agent-tools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EACL,iBAAiB,EAElB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,gBAAgB,EAGjB,MAAM,wBAAwB,CAAC;AAIhC,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAMtC;AAMD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClD,QAAQ,CAAC,kBAAkB,EAAE,MAAM;QACjC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;CACH;AAkWD,0EAA0E;AAC1E,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,wBAAwB,GAChC,IAAI,CAWN"}