contextos-mcp 0.4.0

package/dist/ui/text-input.js

@@ -0,0 +1,266 @@
+/**
+ * Bordered text input for the interactive REPL.
+ *
+ * Visual style inspired by OpenCode — full-width bordered text area with
+ * a darker background row, accent-colored bottom border, and multi-line
+ * paste support.
+ *
+ * Keys:
+ *   - Enter: submit
+ *   - Escape / Ctrl+C: exit
+ *   - Ctrl+D: submit
+ *   - Backspace, left/right, home/end: editing
+ *   - Paste (multi-char with newlines): captured as multi-line
+ */
+import { coral, dim, isTTY, termWidth } from "./theme.js";
+// ── ANSI helpers ─────────────────────────────────────────────────────────────
+const BG_DARK = "\x1b[48;2;30;33;39m"; // dark background for input row
+const RESET = "\x1b[0m";
+const HIDE_CURSOR = "\x1b[?25l";
+const SHOW_CURSOR = "\x1b[?25h";
+const BORDER_COLOR = "\x1b[38;2;60;63;68m"; // subtle gray for top border
+const ACCENT_COLOR = "\x1b[38;2;215;119;87m"; // coral for bottom border
+export function readTextInput(_prompt) {
+    if (!isTTY) {
+        return new Promise((resolve) => {
+            let data = "";
+            process.stdin.setEncoding("utf-8");
+            const onData = (chunk) => {
+                data += chunk;
+                if (data.includes("\n")) {
+                    process.stdin.removeListener("data", onData);
+                    resolve({ text: data.trim(), action: "submit" });
+                }
+            };
+            process.stdin.on("data", onData);
+            process.stdin.resume();
+        });
+    }
+    return new Promise((resolve) => {
+        const linesBuf = [""];
+        let cursorPos = 0;
+        const origRawMode = process.stdin.isRaw;
+        const w = termWidth();
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        process.stdin.setEncoding("utf-8");
+        // Tracks cursor position relative to top border after each drawBox()
+        let cursorRowFromTop = 0;
+        let prevTotalRows = 0;
+        function buildRows() {
+            const promptVisibleLen = 2;
+            const rows = [];
+            // Top border
+            rows.push(`${BORDER_COLOR}${"─".repeat(w)}${RESET}`);
+            // Content rows
+            const promptChar = `${ACCENT_COLOR}❯${RESET} `;
+            for (let i = 0; i < linesBuf.length; i++) {
+                const lineText = linesBuf[i];
+                const prefix = i === 0 ? promptChar : `${dim("·")} `;
+                const contentWidth = w - promptVisibleLen;
+                const displayText = lineText.length > contentWidth ? `${lineText.slice(0, contentWidth - 1)}…` : lineText;
+                const padding = Math.max(0, contentWidth - displayText.length);
+                rows.push(`${BG_DARK}${prefix}${displayText}${" ".repeat(padding)}${RESET}`);
+            }
+            // Bottom border
+            rows.push(`${ACCENT_COLOR}${"─".repeat(w)}${RESET}`);
+            // Hints — pad to full width so it fully overwrites old content
+            const hintsText = "  enter submit  esc exit";
+            const hintsPad = Math.max(0, w - hintsText.length);
+            rows.push(`${dim(hintsText)}${" ".repeat(hintsPad)}`);
+            return rows;
+        }
+        function drawBox() {
+            const out = process.stderr;
+            const promptVisibleLen = 2;
+            const rows = buildRows();
+            const totalRows = rows.length;
+            if (prevTotalRows > 0) {
+                // ── Redraw: overwrite rows in place (no \n, no scrolling) ──
+                // Move cursor to top border row
+                if (cursorRowFromTop > 0) {
+                    out.write(`\x1b[${cursorRowFromTop}A`);
+                }
+                out.write("\r");
+                // Overwrite each row in place
+                const commonRows = Math.min(totalRows, prevTotalRows);
+                for (let i = 0; i < commonRows; i++) {
+                    out.write(`\x1b[2K${rows[i]}`);
+                    if (i < commonRows - 1) {
+                        out.write("\x1b[1B\r"); // cursor down 1 (no scroll), start of line
+                    }
+                }
+                if (totalRows > prevTotalRows) {
+                    // More rows than before (multi-line paste) — append with \n
+                    for (let i = commonRows; i < totalRows; i++) {
+                        out.write(`\n\x1b[2K${rows[i]}`);
+                    }
+                }
+                else if (prevTotalRows > totalRows) {
+                    // Fewer rows than before — erase leftover old rows
+                    for (let i = totalRows; i < prevTotalRows; i++) {
+                        out.write("\x1b[1B\r\x1b[2K");
+                    }
+                    // Move back to last new row
+                    const extra = prevTotalRows - totalRows;
+                    if (extra > 0)
+                        out.write(`\x1b[${extra}A`);
+                }
+                // Cursor is now on the last row (hints).
+            }
+            else {
+                // ── Initial draw: use \n between rows, no trailing \n ──
+                for (let i = 0; i < totalRows; i++) {
+                    if (i > 0)
+                        out.write("\n");
+                    out.write(rows[i]);
+                }
+                // Cursor is on the hints line (last row).
+            }
+            prevTotalRows = totalRows;
+            // Position cursor at the active content row
+            // Cursor is currently on the hints line (last row = index totalRows-1).
+            // Content cursor is on row (1 + currentLineIdx).
+            const currentLineIdx = linesBuf.length - 1;
+            const targetRow = 1 + currentLineIdx;
+            const hintsRow = totalRows - 1;
+            const rowsUp = hintsRow - targetRow;
+            if (rowsUp > 0)
+                out.write(`\x1b[${rowsUp}A`);
+            // Set column
+            const col = promptVisibleLen + cursorPos + 1;
+            out.write(`\x1b[${col}G`);
+            cursorRowFromTop = targetRow;
+        }
+        // Initial draw
+        process.stderr.write(HIDE_CURSOR);
+        drawBox();
+        process.stderr.write(SHOW_CURSOR);
+        const onData = (data) => {
+            const hasNewlines = data.includes("\n") || data.includes("\r");
+            const isMultiChar = data.length > 1;
+            const isPaste = hasNewlines && isMultiChar;
+            if (isPaste) {
+                const pastedLines = data.split(/\r\n|\r|\n/);
+                const currentLine = linesBuf[linesBuf.length - 1];
+                linesBuf[linesBuf.length - 1] = currentLine.slice(0, cursorPos) + pastedLines[0] + currentLine.slice(cursorPos);
+                cursorPos = (currentLine.slice(0, cursorPos) + pastedLines[0]).length;
+                for (let i = 1; i < pastedLines.length; i++) {
+                    const line = pastedLines[i];
+                    if (i === pastedLines.length - 1 && line === "")
+                        break;
+                    linesBuf.push(line);
+                    cursorPos = line.length;
+                }
+                drawBox();
+                return;
+            }
+            for (let i = 0; i < data.length; i++) {
+                const ch = data[i];
+                // Escape sequences
+                if (ch === "\x1b") {
+                    if (data[i + 1] === "[") {
+                        const code = data[i + 2];
+                        if (code === "C" && cursorPos < linesBuf[linesBuf.length - 1].length) {
+                            cursorPos++;
+                            i += 2;
+                            drawBox();
+                            continue;
+                        }
+                        if (code === "D" && cursorPos > 0) {
+                            cursorPos--;
+                            i += 2;
+                            drawBox();
+                            continue;
+                        }
+                        if (code === "H") {
+                            cursorPos = 0;
+                            i += 2;
+                            drawBox();
+                            continue;
+                        }
+                        if (code === "F") {
+                            cursorPos = linesBuf[linesBuf.length - 1].length;
+                            i += 2;
+                            drawBox();
+                            continue;
+                        }
+                        i += 2;
+                        continue;
+                    }
+                    // Bare Escape — exit
+                    finishAndClear();
+                    resolve({ text: "", action: "escape" });
+                    return;
+                }
+                // Ctrl+D — submit
+                if (ch === "\x04") {
+                    const text = linesBuf.join("\n").trim();
+                    finishAndClear();
+                    resolve({ text, action: "submit" });
+                    return;
+                }
+                // Ctrl+C — exit
+                if (ch === "\x03") {
+                    finishAndClear();
+                    resolve({ text: "", action: "escape" });
+                    return;
+                }
+                // Enter — submit
+                if (ch === "\r" || ch === "\n") {
+                    const text = linesBuf.join("\n").trim();
+                    finishAndClear();
+                    resolve({ text, action: "submit" });
+                    return;
+                }
+                // Backspace
+                if (ch === "\x7f" || ch === "\b") {
+                    if (cursorPos > 0) {
+                        const line = linesBuf[linesBuf.length - 1];
+                        linesBuf[linesBuf.length - 1] = line.slice(0, cursorPos - 1) + line.slice(cursorPos);
+                        cursorPos--;
+                        drawBox();
+                    }
+                    continue;
+                }
+                // Tab — insert spaces
+                if (ch === "\t") {
+                    const line = linesBuf[linesBuf.length - 1];
+                    linesBuf[linesBuf.length - 1] = `${line.slice(0, cursorPos)}  ${line.slice(cursorPos)}`;
+                    cursorPos += 2;
+                    drawBox();
+                    continue;
+                }
+                // Regular printable character
+                if (ch >= " ") {
+                    const line = linesBuf[linesBuf.length - 1];
+                    linesBuf[linesBuf.length - 1] = line.slice(0, cursorPos) + ch + line.slice(cursorPos);
+                    cursorPos++;
+                    drawBox();
+                }
+            }
+        };
+        function finishAndClear() {
+            process.stdin.removeListener("data", onData);
+            if (origRawMode !== undefined) {
+                process.stdin.setRawMode(origRawMode);
+            }
+            // Move cursor to top of box
+            if (cursorRowFromTop > 0) {
+                process.stderr.write(`\x1b[${cursorRowFromTop}A`);
+            }
+            process.stderr.write("\r\x1b[J"); // erase from here to end of screen
+            // Write the submitted text as a clean line (so it's visible in scrollback)
+            const fullText = linesBuf.join("\n").trim();
+            if (fullText) {
+                const displayLines = fullText.split("\n");
+                for (let i = 0; i < displayLines.length; i++) {
+                    const prefix = i === 0 ? `  ${coral("swarm")}${dim(">")} ` : `  ${dim(".")}       `;
+                    process.stderr.write(`${prefix}${displayLines[i]}\n`);
+                }
+            }
+        }
+        process.stdin.on("data", onData);
+    });
+}
+//# sourceMappingURL=text-input.js.map

package/dist/ui/text-input.js.map

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

package/dist/ui/theme.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Centralized color/formatting system with TTY detection.
+ *
+ * All terminal styling flows through this module. When output is piped
+ * (not a TTY), colors are automatically stripped.
+ */
+declare const isTTY: boolean;
+declare const stdoutTTY: boolean;
+/** Brand coral — spinner, accents (inspired by Claude Code's coral orange). */
+export declare const coral: (text: string) => string;
+/** Primary accent — headers, borders. */
+export declare const cyan: (text: string) => string;
+/** Success — completed operations. */
+export declare const green: (text: string) => string;
+/** Warning — non-fatal issues. */
+export declare const yellow: (text: string) => string;
+/** Error — failures. */
+export declare const red: (text: string) => string;
+/** Secondary info — timestamps, ids, hints. */
+export declare const dim: (text: string) => string;
+/** Emphasis. */
+export declare const bold: (text: string) => string;
+/** Subtle emphasis. */
+export declare const italic: (text: string) => string;
+/** De-emphasized text. */
+export declare const gray: (text: string) => string;
+/** Magenta — sub-queries, memory. */
+export declare const magenta: (text: string) => string;
+/** White — primary content. */
+export declare const white: (text: string) => string;
+export declare const heading: (text: string) => string;
+export declare const success: (text: string) => string;
+export declare const warn: (text: string) => string;
+export declare const error: (text: string) => string;
+export declare const info: (text: string) => string;
+export declare const hint: (text: string) => string;
+export declare const symbols: {
+    readonly check: "✔" | "[OK]";
+    readonly cross: "✘" | "[ERR]";
+    readonly warn: "⚠" | "[WARN]";
+    readonly info: "●" | "[*]";
+    readonly arrow: "▶" | ">";
+    readonly dot: "·" | ".";
+    readonly dash: "─" | "-";
+    readonly vertLine: "│" | "|";
+    readonly topLeft: "╭" | "+";
+    readonly topRight: "+" | "╮";
+    readonly bottomLeft: "+" | "╰";
+    readonly bottomRight: "+" | "╯";
+    readonly horizontal: "─" | "-";
+    readonly spinner: string[];
+};
+/** Get terminal width, with a sensible fallback. */
+export declare function termWidth(): number;
+/** Draw a horizontal rule. */
+export declare function hr(char?: string): string;
+/** Right-pad a string to a given width. */
+export declare function pad(text: string, width: number): string;
+/** Strip ANSI escape codes from a string. */
+export declare function stripAnsi(text: string): string;
+/** Truncate a string to maxLen, adding ellipsis if needed. */
+export declare function truncate(text: string, maxLen: number): string;
+export { isTTY, stdoutTTY };

package/dist/ui/theme.js

@@ -0,0 +1,97 @@
+/**
+ * Centralized color/formatting system with TTY detection.
+ *
+ * All terminal styling flows through this module. When output is piped
+ * (not a TTY), colors are automatically stripped.
+ */
+const isTTY = process.stderr.isTTY ?? false;
+const stdoutTTY = process.stdout.isTTY ?? false;
+// ── ANSI helpers ────────────────────────────────────────────────────────────
+function ansi(code) {
+    if (!isTTY)
+        return (text) => text;
+    return (text) => `\x1b[${code}m${text}\x1b[0m`;
+}
+function ansiFg(r, g, b) {
+    if (!isTTY)
+        return (text) => text;
+    return (text) => `\x1b[38;2;${r};${g};${b}m${text}\x1b[0m`;
+}
+// ── Theme colors ────────────────────────────────────────────────────────────
+/** Brand coral — spinner, accents (inspired by Claude Code's coral orange). */
+export const coral = ansiFg(215, 119, 87);
+/** Primary accent — headers, borders. */
+export const cyan = ansi("36");
+/** Success — completed operations. */
+export const green = ansi("32");
+/** Warning — non-fatal issues. */
+export const yellow = ansi("33");
+/** Error — failures. */
+export const red = ansi("31");
+/** Secondary info — timestamps, ids, hints. */
+export const dim = ansi("2");
+/** Emphasis. */
+export const bold = ansi("1");
+/** Subtle emphasis. */
+export const italic = ansi("3");
+/** De-emphasized text. */
+export const gray = ansiFg(128, 128, 128);
+/** Magenta — sub-queries, memory. */
+export const magenta = ansi("35");
+/** White — primary content. */
+export const white = ansi("37");
+// ── Compound styles ─────────────────────────────────────────────────────────
+export const heading = (text) => bold(cyan(text));
+export const success = (text) => green(`${symbols.check} ${text}`);
+export const warn = (text) => yellow(`${symbols.warn} ${text}`);
+export const error = (text) => red(`${symbols.cross} ${text}`);
+export const info = (text) => cyan(`${symbols.info} ${text}`);
+export const hint = (text) => dim(`  ${text}`);
+// ── Symbols ─────────────────────────────────────────────────────────────────
+export const symbols = {
+    check: isTTY ? "\u2714" : "[OK]",
+    cross: isTTY ? "\u2718" : "[ERR]",
+    warn: isTTY ? "\u26A0" : "[WARN]",
+    info: isTTY ? "\u25CF" : "[*]",
+    arrow: isTTY ? "\u25B6" : ">",
+    dot: isTTY ? "\u00B7" : ".",
+    dash: isTTY ? "\u2500" : "-",
+    vertLine: isTTY ? "\u2502" : "|",
+    topLeft: isTTY ? "\u256D" : "+",
+    topRight: isTTY ? "\u256E" : "+",
+    bottomLeft: isTTY ? "\u2570" : "+",
+    bottomRight: isTTY ? "\u256F" : "+",
+    horizontal: isTTY ? "\u2500" : "-",
+    spinner: isTTY ? ["\u00B7", "\u2726", "\u2733", "\u2736", "\u273B", "\u273D"] : ["*"],
+};
+// ── Layout helpers ──────────────────────────────────────────────────────────
+/** Get terminal width, with a sensible fallback. */
+export function termWidth() {
+    return process.stderr.columns || 80;
+}
+/** Draw a horizontal rule. */
+export function hr(char) {
+    const c = char || symbols.horizontal;
+    return dim(c.repeat(Math.min(termWidth(), 60)));
+}
+/** Right-pad a string to a given width. */
+export function pad(text, width) {
+    const stripped = stripAnsi(text);
+    if (stripped.length >= width)
+        return text;
+    return text + " ".repeat(width - stripped.length);
+}
+/** Strip ANSI escape codes from a string. */
+export function stripAnsi(text) {
+    // eslint-disable-next-line no-control-regex
+    return text.replace(/\x1b\[[0-9;]*m/g, "");
+}
+/** Truncate a string to maxLen, adding ellipsis if needed. */
+export function truncate(text, maxLen) {
+    if (text.length <= maxLen)
+        return text;
+    return `${text.slice(0, maxLen - 1)}\u2026`;
+}
+// ── Exports ─────────────────────────────────────────────────────────────────
+export { isTTY, stdoutTTY };
+//# sourceMappingURL=theme.js.map

package/dist/ui/theme.js.map

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

package/dist/utils/command-exists.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Checks if a command/executable exists on the system PATH in a cross-platform manner.
+ * On Windows, uses `where.exe`.
+ * On POSIX (Linux/macOS), uses `which`.
+ */
+export declare function commandExists(cmd: string): Promise<boolean>;
+/**
+ * Resolves the full path to an executable from PATH.
+ * On Windows, resolves .cmd, .bat, or .exe paths so they can be executed without shell: true.
+ */
+export declare function resolveExecutablePath(cmd: string): Promise<string | null>;

package/dist/utils/command-exists.js

@@ -0,0 +1,41 @@
+import { spawn } from "node:child_process";
+/**
+ * Checks if a command/executable exists on the system PATH in a cross-platform manner.
+ * On Windows, uses `where.exe`.
+ * On POSIX (Linux/macOS), uses `which`.
+ */
+export async function commandExists(cmd) {
+    const resolved = await resolveExecutablePath(cmd);
+    return resolved !== null;
+}
+/**
+ * Resolves the full path to an executable from PATH.
+ * On Windows, resolves .cmd, .bat, or .exe paths so they can be executed without shell: true.
+ */
+export async function resolveExecutablePath(cmd) {
+    if (!cmd || typeof cmd !== "string")
+        return null;
+    const isWindows = process.platform === "win32";
+    const checkTool = isWindows ? "where.exe" : "which";
+    return new Promise((resolve) => {
+        try {
+            const proc = spawn(checkTool, [cmd], { stdio: ["ignore", "pipe", "ignore"] });
+            let stdout = "";
+            proc.stdout?.on("data", (d) => (stdout += d.toString()));
+            proc.on("close", (code) => {
+                if (code === 0 && stdout.trim()) {
+                    const firstLine = stdout.trim().split(/\r?\n/)[0].trim();
+                    resolve(firstLine || null);
+                }
+                else {
+                    resolve(null);
+                }
+            });
+            proc.on("error", () => resolve(null));
+        }
+        catch {
+            resolve(null);
+        }
+    });
+}
+//# sourceMappingURL=command-exists.js.map

package/dist/utils/command-exists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-exists.js","sourceRoot":"","sources":["../../src/utils/command-exists.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW;IAC9C,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAClD,OAAO,QAAQ,KAAK,IAAI,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,GAAW;IACtD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAEjD,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;IAC/C,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC;IAEpD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC9B,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC9E,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;YACzD,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;gBACzB,IAAI,IAAI,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;oBACjC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;oBACzD,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC;gBAC5B,CAAC;qBAAM,CAAC;oBACP,OAAO,CAAC,IAAI,CAAC,CAAC;gBACf,CAAC;YACF,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACR,OAAO,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;IACF,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/utils/process-security.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Process isolation and security utilities:
+ * - Environment sanitation (strips credentials, tokens, secrets)
+ * - Sensitive output redaction (API keys, passwords, bearer tokens)
+ * - Cross-platform bounded process tree termination (Windows taskkill, Unix process groups)
+ */
+export declare const STRICT_ENV_ALLOWLIST: Set<string>;
+/**
+ * Strips high-privilege credentials and tokens from process environment.
+ */
+export declare function getSanitizedEnv(customEnv?: Record<string, string>): NodeJS.ProcessEnv;
+/**
+ * Masks API keys, bearer tokens, passwords, and sensitive credentials in command outputs.
+ */
+export declare function redactSensitiveOutput(text?: string): string;
+/**
+ * Recursively terminates a process and all its children across Windows, macOS, and Linux.
+ */
+export declare function killProcessTree(pid: number | undefined): void;

package/dist/utils/process-security.js

@@ -0,0 +1,90 @@
+/**
+ * Process isolation and security utilities:
+ * - Environment sanitation (strips credentials, tokens, secrets)
+ * - Sensitive output redaction (API keys, passwords, bearer tokens)
+ * - Cross-platform bounded process tree termination (Windows taskkill, Unix process groups)
+ */
+import { execFileSync } from "node:child_process";
+export const STRICT_ENV_ALLOWLIST = new Set([
+    "PATH",
+    "HOME",
+    "USERPROFILE",
+    "SYSTEMROOT",
+    "WINDIR",
+    "TEMP",
+    "TMP",
+    "NODE_ENV",
+    "LANG",
+    "LC_ALL",
+    "CI",
+]);
+/**
+ * Strips high-privilege credentials and tokens from process environment.
+ */
+export function getSanitizedEnv(customEnv = {}) {
+    const sanitized = {
+        CI: "true",
+        NODE_ENV: "test",
+    };
+    for (const key of STRICT_ENV_ALLOWLIST) {
+        if (process.env[key] !== undefined) {
+            sanitized[key] = process.env[key];
+        }
+    }
+    for (const [k, v] of Object.entries(customEnv)) {
+        if (!/TOKEN|SECRET|KEY|PASSWORD|AUTH|CREDENTIAL/i.test(k) && !/^(GIT_|NODE_OPTIONS|LD_PRELOAD|DYLD_)/i.test(k)) {
+            sanitized[k] = v;
+        }
+    }
+    return sanitized;
+}
+/**
+ * Masks API keys, bearer tokens, passwords, and sensitive credentials in command outputs.
+ */
+export function redactSensitiveOutput(text = "") {
+    if (!text)
+        return "";
+    return (text
+        // Secret tokens and API keys
+        .replace(/(?:sk-[a-zA-Z0-9]{20,}|gh[pousr]-[a-zA-Z0-9]{30,}|AIza[a-zA-Z0-9_-]{30,45})/g, "[REDACTED_API_KEY]")
+        // Bearer / Authorization headers
+        .replace(/(?:Authorization:\s*)?(Bearer\s+)[^\s\n]+/gi, "$1[REDACTED_TOKEN]")
+        // Password fields
+        .replace(/(password[\s:=]+)[^\s\n&]+/gi, "$1[REDACTED_PASSWORD]")
+        // Generic high-entropy hex/base64 tokens (32+ chars)
+        .replace(/(["']?[a-zA-Z0-9_-]*(?:token|secret|password|key)["']?\s*[:=]\s*["']?)[a-zA-Z0-9_.+/=-]{32,}(["']?)/gi, "$1[REDACTED]$2")
+        .replace(/-----BEGIN (?:RSA|OPENSSH|DSA|EC)? ?PRIVATE KEY-----[\s\S]*?-----END (?:RSA|OPENSSH|DSA|EC)? ?PRIVATE KEY-----/g, "[REDACTED_PRIVATE_KEY]"));
+}
+/**
+ * Recursively terminates a process and all its children across Windows, macOS, and Linux.
+ */
+export function killProcessTree(pid) {
+    if (!pid)
+        return;
+    if (process.platform === "win32") {
+        try {
+            execFileSync("taskkill", ["/PID", String(pid), "/T", "/F"], {
+                stdio: "ignore",
+                windowsHide: true,
+            });
+        }
+        catch {
+            // Process might have already exited
+        }
+    }
+    else {
+        try {
+            // Kill entire process group
+            process.kill(-pid, "SIGKILL");
+        }
+        catch {
+            try {
+                process.kill(pid, "SIGKILL");
+            }
+            catch {
+                // Process already exited
+            }
+        }
+    }
+}
+//# sourceMappingURL=process-security.js.map

package/dist/utils/process-security.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-security.js","sourceRoot":"","sources":["../../src/utils/process-security.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IAC3C,MAAM;IACN,MAAM;IACN,aAAa;IACb,YAAY;IACZ,QAAQ;IACR,MAAM;IACN,KAAK;IACL,UAAU;IACV,MAAM;IACN,QAAQ;IACR,IAAI;CACJ,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,YAAoC,EAAE;IACrE,MAAM,SAAS,GAAsB;QACpC,EAAE,EAAE,MAAM;QACV,QAAQ,EAAE,MAAM;KAChB,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,oBAAoB,EAAE,CAAC;QACxC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YACpC,SAAS,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC;IACF,CAAC;IACD,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,4CAA4C,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,wCAAwC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAChH,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;IACF,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAI,GAAG,EAAE;IAC9C,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,OAAO,CACN,IAAI;QACH,6BAA6B;SAC5B,OAAO,CAAC,8EAA8E,EAAE,oBAAoB,CAAC;QAC9G,iCAAiC;SAChC,OAAO,CAAC,6CAA6C,EAAE,oBAAoB,CAAC;QAC7E,kBAAkB;SACjB,OAAO,CAAC,8BAA8B,EAAE,uBAAuB,CAAC;QACjE,qDAAqD;SACpD,OAAO,CACP,uGAAuG,EACvG,gBAAgB,CAChB;SACA,OAAO,CACP,iHAAiH,EACjH,wBAAwB,CACxB,CACF,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAuB;IACtD,IAAI,CAAC,GAAG;QAAE,OAAO;IAEjB,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QAClC,IAAI,CAAC;YACJ,YAAY,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE;gBAC3D,KAAK,EAAE,QAAQ;gBACf,WAAW,EAAE,IAAI;aACjB,CAAC,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACR,oCAAoC;QACrC,CAAC;IACF,CAAC;SAAM,CAAC;QACP,IAAI,CAAC;YACJ,4BAA4B;YAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACR,IAAI,CAAC;gBACJ,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC9B,CAAC;YAAC,MAAM,CAAC;gBACR,yBAAyB;YAC1B,CAAC;QACF,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/utils/rolling-buffer.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Rolling string buffer with a maximum byte limit.
+ *
+ * Drops oldest chunks when the total accumulated length exceeds `maxBytes`.
+ * Used by agent backends to prevent OOM when a runaway child process
+ * produces unbounded stdout/stderr output.
+ */
+export declare class RollingBuffer {
+    private readonly maxBytes;
+    private chunks;
+    private totalLength;
+    constructor(maxBytes?: number);
+    append(text: string): void;
+    toString(): string;
+    get length(): number;
+}