patchwork-os 0.2.0-alpha.2 → 0.2.0-alpha.4

package/dist/drivers/gemini/index.js

@@ -0,0 +1,176 @@
+import { spawn } from "node:child_process";
+import { sanitizeEnv } from "../claude/envSanitizer.js";
+import { splitLines } from "../claude/streamParser.js";
+import { toProviderTaskOutcome } from "../types.js";
+const OUTPUT_CAP = 50 * 1024;
+function scrubSecrets(text) {
+    return text
+        .replace(/AIza[A-Za-z0-9_-]{35}/g, "[REDACTED_API_KEY]")
+        .replace(/Bearer\s+[A-Za-z0-9._-]{16,}/gi, "Bearer [REDACTED]");
+}
+/**
+ * GeminiSubprocessDriver — spawns `gemini -p` with --output-format stream-json.
+ * Auth: GEMINI_API_KEY env var (or gcloud ADC / Vertex if configured in ~/.gemini/settings.json).
+ * providerOptions: { approvalMode?: "yolo" | "auto_edit" | "default" | "plan" }
+ */
+export class GeminiSubprocessDriver {
+    binary;
+    log;
+    name = "gemini";
+    constructor(binary, log) {
+        this.binary = binary;
+        this.log = log;
+    }
+    async run(input) {
+        const opts = input.providerOptions ?? {};
+        const approvalMode = typeof opts.approvalMode === "string" ? opts.approvalMode : "yolo";
+        const args = [
+            "-p",
+            input.prompt,
+            "--output-format",
+            "stream-json",
+            "--approval-mode",
+            approvalMode,
+        ];
+        if (input.model)
+            args.push("-m", input.model);
+        // contextFiles: pass as --include-directories for directory paths
+        for (const f of input.contextFiles ?? []) {
+            if (typeof f === "string" && f.length > 0 && !f.startsWith("-")) {
+                args.push("--include-directories", f);
+            }
+        }
+        // Strip MCP_* and CLAUDECODE vars; preserve GEMINI_API_KEY + GOOGLE_* vars
+        const env = sanitizeEnv(process.env);
+        // Also strip Claude-specific auth vars that could confuse Gemini
+        for (const key of Object.keys(env)) {
+            if (key.startsWith("ANTHROPIC_") || key === "CLAUDE_API_KEY") {
+                delete env[key];
+            }
+        }
+        this.log(`[GeminiSubprocessDriver] spawning: ${this.binary} -p <prompt> (workspace: ${input.workspace})`);
+        const child = spawn(this.binary, args, {
+            cwd: input.workspace,
+            env,
+            signal: input.signal,
+            stdio: ["ignore", "pipe", "pipe"],
+            detached: true,
+        });
+        let lineBuf = "";
+        let accumulated = "";
+        let outputBytesSent = 0;
+        let firstAssistantAt;
+        let doneFromResult = false;
+        let resultSuccess = true;
+        child.stdout.setEncoding("utf-8");
+        child.stdout.on("data", (chunk) => {
+            const { lines, remainder } = splitLines(lineBuf, chunk);
+            lineBuf = remainder;
+            for (const line of lines) {
+                if (line.trim() === "")
+                    continue;
+                let event;
+                try {
+                    event = JSON.parse(line);
+                }
+                catch {
+                    // Non-JSON stderr/warning lines — skip (Gemini prints "YOLO mode..." to stdout)
+                    continue;
+                }
+                if (event.type === "message" &&
+                    event.role === "assistant" &&
+                    event.content) {
+                    if (firstAssistantAt === undefined)
+                        firstAssistantAt = Date.now();
+                    const text = event.content;
+                    accumulated += text;
+                    if (outputBytesSent < OUTPUT_CAP) {
+                        const send = text.slice(0, OUTPUT_CAP - outputBytesSent);
+                        if (send.length > 0) {
+                            input.onChunk?.(send);
+                            outputBytesSent += send.length;
+                        }
+                    }
+                }
+                else if (event.type === "result") {
+                    doneFromResult = true;
+                    resultSuccess = event.status === "success";
+                }
+            }
+        });
+        let stderr = "";
+        child.stderr.setEncoding("utf-8");
+        child.stderr.on("data", (chunk) => {
+            if (stderr.length < OUTPUT_CAP) {
+                stderr += chunk;
+                if (stderr.length > OUTPUT_CAP)
+                    stderr = stderr.slice(0, OUTPUT_CAP);
+            }
+        });
+        const start = Date.now();
+        const stderrTailOf = (s) => s.length > 0 ? scrubSecrets(s.slice(-2048)) : undefined;
+        const startupMsOf = () => firstAssistantAt !== undefined ? firstAssistantAt - start : undefined;
+        let startupTimedOut = false;
+        const startupHandle = input.startupTimeoutMs
+            ? setTimeout(() => {
+                if (firstAssistantAt === undefined && !doneFromResult) {
+                    startupTimedOut = true;
+                    child.kill();
+                }
+            }, input.startupTimeoutMs)
+            : null;
+        let exitCode;
+        try {
+            exitCode = await new Promise((resolve, reject) => {
+                child.on("close", (code) => resolve(code ?? 0));
+                child.on("error", reject);
+            });
+        }
+        catch (err) {
+            if (startupHandle)
+                clearTimeout(startupHandle);
+            const isAbort = (err instanceof Error && err.name === "AbortError") ||
+                input.signal.aborted;
+            if (isAbort) {
+                return {
+                    text: accumulated.slice(0, OUTPUT_CAP),
+                    durationMs: Date.now() - start,
+                    wasAborted: true,
+                    startupMs: startupMsOf(),
+                    stderrTail: stderrTailOf(stderr),
+                };
+            }
+            throw err;
+        }
+        if (startupHandle)
+            clearTimeout(startupHandle);
+        if (startupTimedOut) {
+            return {
+                text: accumulated.slice(0, OUTPUT_CAP),
+                durationMs: Date.now() - start,
+                wasAborted: true,
+                startupTimedOut: true,
+                stderrTail: stderrTailOf(stderr),
+            };
+        }
+        const effectiveExitCode = doneFromResult
+            ? resultSuccess
+                ? 0
+                : 1
+            : exitCode;
+        if (effectiveExitCode !== 0 && stderr) {
+            this.log(`[GeminiSubprocessDriver] stderr: ${stderr.slice(0, 500)}`);
+        }
+        return {
+            text: accumulated.slice(0, OUTPUT_CAP),
+            exitCode: effectiveExitCode,
+            durationMs: Date.now() - start,
+            stderrTail: stderrTailOf(stderr),
+            startupMs: startupMsOf(),
+        };
+    }
+    async runOutcome(input) {
+        return toProviderTaskOutcome(await this.run(input));
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/drivers/gemini/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/drivers/gemini/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAMvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,UAAU,GAAG,EAAE,GAAG,IAAI,CAAC;AAmB7B,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,IAAI;SACR,OAAO,CAAC,wBAAwB,EAAE,oBAAoB,CAAC;SACvD,OAAO,CAAC,gCAAgC,EAAE,mBAAmB,CAAC,CAAC;AACpE,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,sBAAsB;IAId;IACA;IAJV,IAAI,GAAG,QAAQ,CAAC;IAEzB,YACmB,MAAc,EACd,GAA0B;QAD1B,WAAM,GAAN,MAAM,CAAQ;QACd,QAAG,GAAH,GAAG,CAAuB;IAC1C,CAAC;IAEJ,KAAK,CAAC,GAAG,CAAC,KAAwB;QAChC,MAAM,IAAI,GAAG,KAAK,CAAC,eAAe,IAAI,EAAE,CAAC;QACzC,MAAM,YAAY,GAChB,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;QAErE,MAAM,IAAI,GAAG;YACX,IAAI;YACJ,KAAK,CAAC,MAAM;YACZ,iBAAiB;YACjB,aAAa;YACb,iBAAiB;YACjB,YAAY;SACb,CAAC;QACF,IAAI,KAAK,CAAC,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9C,kEAAkE;QAClE,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;YACzC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAChE,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,CAAC,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QAED,2EAA2E;QAC3E,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACrC,iEAAiE;QACjE,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACnC,IAAI,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,GAAG,KAAK,gBAAgB,EAAE,CAAC;gBAC7D,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QAED,IAAI,CAAC,GAAG,CACN,sCAAsC,IAAI,CAAC,MAAM,4BAA4B,KAAK,CAAC,SAAS,GAAG,CAChG,CAAC;QAEF,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE;YACrC,GAAG,EAAE,KAAK,CAAC,SAAS;YACpB,GAAG;YACH,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;YACjC,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QAEH,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,WAAW,GAAG,EAAE,CAAC;QACrB,IAAI,eAAe,GAAG,CAAC,CAAC;QACxB,IAAI,gBAAoC,CAAC;QACzC,IAAI,cAAc,GAAG,KAAK,CAAC;QAC3B,IAAI,aAAa,GAAG,IAAI,CAAC;QAEzB,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAClC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACxC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACxD,OAAO,GAAG,SAAS,CAAC;YAEpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;oBAAE,SAAS;gBACjC,IAAI,KAAkB,CAAC;gBACvB,IAAI,CAAC;oBACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAgB,CAAC;gBAC1C,CAAC;gBAAC,MAAM,CAAC;oBACP,gFAAgF;oBAChF,SAAS;gBACX,CAAC;gBAED,IACE,KAAK,CAAC,IAAI,KAAK,SAAS;oBACxB,KAAK,CAAC,IAAI,KAAK,WAAW;oBAC1B,KAAK,CAAC,OAAO,EACb,CAAC;oBACD,IAAI,gBAAgB,KAAK,SAAS;wBAAE,gBAAgB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;oBAClE,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC;oBAC3B,WAAW,IAAI,IAAI,CAAC;oBACpB,IAAI,eAAe,GAAG,UAAU,EAAE,CAAC;wBACjC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,GAAG,eAAe,CAAC,CAAC;wBACzD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BACpB,KAAK,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;4BACtB,eAAe,IAAI,IAAI,CAAC,MAAM,CAAC;wBACjC,CAAC;oBACH,CAAC;gBACH,CAAC;qBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACnC,cAAc,GAAG,IAAI,CAAC;oBACtB,aAAa,GAAG,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC;gBAC7C,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAClC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACxC,IAAI,MAAM,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;gBAC/B,MAAM,IAAI,KAAK,CAAC;gBAChB,IAAI,MAAM,CAAC,MAAM,GAAG,UAAU;oBAAE,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;YACvE,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,YAAY,GAAG,CAAC,CAAS,EAAsB,EAAE,CACrD,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1D,MAAM,WAAW,GAAG,GAAuB,EAAE,CAC3C,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,gBAAgB,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QAExE,IAAI,eAAe,GAAG,KAAK,CAAC;QAC5B,MAAM,aAAa,GAAG,KAAK,CAAC,gBAAgB;YAC1C,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE;gBACd,IAAI,gBAAgB,KAAK,SAAS,IAAI,CAAC,cAAc,EAAE,CAAC;oBACtD,eAAe,GAAG,IAAI,CAAC;oBACvB,KAAK,CAAC,IAAI,EAAE,CAAC;gBACf,CAAC;YACH,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC;YAC5B,CAAC,CAAC,IAAI,CAAC;QAET,IAAI,QAAgB,CAAC;QACrB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACvD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;gBAChD,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC5B,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,aAAa;gBAAE,YAAY,CAAC,aAAa,CAAC,CAAC;YAC/C,MAAM,OAAO,GACX,CAAC,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC;gBACnD,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC;YACvB,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO;oBACL,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC;oBACtC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;oBAC9B,UAAU,EAAE,IAAI;oBAChB,SAAS,EAAE,WAAW,EAAE;oBACxB,UAAU,EAAE,YAAY,CAAC,MAAM,CAAC;iBACjC,CAAC;YACJ,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,IAAI,aAAa;YAAE,YAAY,CAAC,aAAa,CAAC,CAAC;QAE/C,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO;gBACL,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC;gBACtC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;gBAC9B,UAAU,EAAE,IAAI;gBAChB,eAAe,EAAE,IAAI;gBACrB,UAAU,EAAE,YAAY,CAAC,MAAM,CAAC;aACjC,CAAC;QACJ,CAAC;QAED,MAAM,iBAAiB,GAAG,cAAc;YACtC,CAAC,CAAC,aAAa;gBACb,CAAC,CAAC,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,QAAQ,CAAC;QACb,IAAI,iBAAiB,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;YACtC,IAAI,CAAC,GAAG,CAAC,oCAAoC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACvE,CAAC;QAED,OAAO;YACL,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC;YACtC,QAAQ,EAAE,iBAAiB;YAC3B,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;YAC9B,UAAU,EAAE,YAAY,CAAC,MAAM,CAAC;YAChC,SAAS,EAAE,WAAW,EAAE;SACzB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAwB;QACvC,OAAO,qBAAqB,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACtD,CAAC;CACF"}

package/dist/drivers/grok/index.d.ts

@@ -0,0 +1,11 @@
+import { OpenAIApiDriver } from "../openai/index.js";
+/**
+ * Grok driver — xAI's API is OpenAI-compatible at https://api.x.ai/v1.
+ * Requires XAI_API_KEY environment variable.
+ * Install: npm install openai  (reuses OpenAI SDK with custom baseURL)
+ */
+export declare class GrokApiDriver extends OpenAIApiDriver {
+    readonly name = "grok";
+    constructor(log: (msg: string) => void);
+    protected apiKey(): string | undefined;
+}

package/dist/drivers/grok/index.js

@@ -0,0 +1,22 @@
+import { OpenAIApiDriver } from "../openai/index.js";
+/**
+ * Grok driver — xAI's API is OpenAI-compatible at https://api.x.ai/v1.
+ * Requires XAI_API_KEY environment variable.
+ * Install: npm install openai  (reuses OpenAI SDK with custom baseURL)
+ */
+export class GrokApiDriver extends OpenAIApiDriver {
+    name = "grok";
+    constructor(log) {
+        if (!process.env.XAI_API_KEY) {
+            throw new Error("GrokApiDriver requires XAI_API_KEY environment variable");
+        }
+        super(log, {
+            baseURL: "https://api.x.ai/v1",
+            defaultModel: "grok-2-latest",
+        });
+    }
+    apiKey() {
+        return process.env.XAI_API_KEY;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/drivers/grok/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/drivers/grok/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;GAIG;AACH,MAAM,OAAO,aAAc,SAAQ,eAAe;IAC9B,IAAI,GAAG,MAAM,CAAC;IAEhC,YAAY,GAA0B;QACpC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,yDAAyD,CAC1D,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,GAAG,EAAE;YACT,OAAO,EAAE,qBAAqB;YAC9B,YAAY,EAAE,eAAe;SAC9B,CAAC,CAAC;IACL,CAAC;IAEkB,MAAM;QACvB,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IACjC,CAAC;CACF"}

package/dist/drivers/index.d.ts

@@ -0,0 +1,18 @@
+import type { ProviderDriver } from "./types.js";
+export type DriverMode = "subprocess" | "api" | "openai" | "grok" | "gemini" | "none";
+export interface DriverFactoryOpts {
+    binary: string;
+    antBinary: string;
+}
+/**
+ * Create the appropriate driver from a mode string.
+ * Returns null for "none" (orchestration disabled).
+ */
+export declare function createDriver(mode: DriverMode, opts: DriverFactoryOpts, log: (msg: string) => void): ProviderDriver | null;
+export { ApiDriver } from "./claude/api.js";
+export { SubprocessDriver } from "./claude/subprocess.js";
+export { GeminiSubprocessDriver } from "./gemini/index.js";
+export { GrokApiDriver } from "./grok/index.js";
+export { OpenAIApiDriver } from "./openai/index.js";
+export type { ProviderDriver, ProviderTaskInput, ProviderTaskOutcome, ProviderTaskResult, } from "./types.js";
+export { toProviderTaskOutcome } from "./types.js";

package/dist/drivers/index.js

@@ -0,0 +1,31 @@
+import { ApiDriver } from "./claude/api.js";
+import { SubprocessDriver } from "./claude/subprocess.js";
+import { GeminiSubprocessDriver } from "./gemini/index.js";
+import { GrokApiDriver } from "./grok/index.js";
+import { OpenAIApiDriver } from "./openai/index.js";
+/**
+ * Create the appropriate driver from a mode string.
+ * Returns null for "none" (orchestration disabled).
+ */
+export function createDriver(mode, opts, log) {
+    if (mode === "none")
+        return null;
+    if (mode === "subprocess")
+        return new SubprocessDriver(opts.binary, opts.antBinary, log);
+    if (mode === "api")
+        return new ApiDriver(log);
+    if (mode === "openai")
+        return new OpenAIApiDriver(log);
+    if (mode === "grok")
+        return new GrokApiDriver(log);
+    if (mode === "gemini")
+        return new GeminiSubprocessDriver(opts.binary === "claude" ? "gemini" : opts.binary, log);
+    throw new Error(`Unknown driver mode: ${mode}`);
+}
+export { ApiDriver } from "./claude/api.js";
+export { SubprocessDriver } from "./claude/subprocess.js";
+export { GeminiSubprocessDriver } from "./gemini/index.js";
+export { GrokApiDriver } from "./grok/index.js";
+export { OpenAIApiDriver } from "./openai/index.js";
+export { toProviderTaskOutcome } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/drivers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/drivers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAgBpD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAgB,EAChB,IAAuB,EACvB,GAA0B;IAE1B,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,IAAI,KAAK,YAAY;QACvB,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAChE,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;IAC9C,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC;IACvD,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC;IACnD,IAAI,IAAI,KAAK,QAAQ;QACnB,OAAO,IAAI,sBAAsB,CAC/B,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EACjD,GAAG,CACJ,CAAC;IACJ,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAOpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/dist/drivers/openai/index.d.ts

@@ -0,0 +1,24 @@
+import type { ProviderDriver, ProviderTaskInput, ProviderTaskResult } from "../types.js";
+export interface OpenAIDriverOpts {
+    /** Override API base URL — used by Grok and other OpenAI-compatible endpoints. */
+    baseURL?: string;
+    /** Default model when input.model is not set. */
+    defaultModel?: string;
+}
+/**
+ * OpenAI API driver — streams via chat.completions.create.
+ * Dynamic import: openai package is an optional peer dep (not in package.json).
+ * Install: npm install openai
+ *
+ * Limitation: single-turn only — no agentic tool-use loop.
+ * providerOptions: { maxTokens?: number, temperature?: number }
+ */
+export declare class OpenAIApiDriver implements ProviderDriver {
+    private readonly log;
+    private readonly opts;
+    readonly name: string;
+    constructor(log: (msg: string) => void, opts?: OpenAIDriverOpts);
+    run(input: ProviderTaskInput): Promise<ProviderTaskResult>;
+    /** Override in subclasses to use a different env var. */
+    protected apiKey(): string | undefined;
+}

package/dist/drivers/openai/index.js

@@ -0,0 +1,110 @@
+const OUTPUT_CAP = 50 * 1024;
+/**
+ * OpenAI API driver — streams via chat.completions.create.
+ * Dynamic import: openai package is an optional peer dep (not in package.json).
+ * Install: npm install openai
+ *
+ * Limitation: single-turn only — no agentic tool-use loop.
+ * providerOptions: { maxTokens?: number, temperature?: number }
+ */
+export class OpenAIApiDriver {
+    log;
+    opts;
+    name = "openai";
+    constructor(log, opts = {}) {
+        this.log = log;
+        this.opts = opts;
+        if (!process.env.OPENAI_API_KEY && !opts.baseURL) {
+            throw new Error("OpenAIApiDriver requires OPENAI_API_KEY environment variable");
+        }
+    }
+    async run(input) {
+        // biome-ignore lint/suspicious/noExplicitAny: dynamic import of optional peer dep
+        let OpenAICtor;
+        try {
+            // biome-ignore lint/suspicious/noExplicitAny: dynamic import
+            const mod = await import("openai");
+            // biome-ignore lint/suspicious/noExplicitAny: dynamic import
+            OpenAICtor = mod.default ?? mod.OpenAI ?? mod;
+        }
+        catch {
+            throw new Error("OpenAIApiDriver requires openai — install it with: npm install openai");
+        }
+        const opts = input.providerOptions ?? {};
+        const maxTokens = typeof opts.maxTokens === "number" ? opts.maxTokens : 4096;
+        const temperature = typeof opts.temperature === "number" ? opts.temperature : undefined;
+        const contextNote = input.contextFiles && input.contextFiles.length > 0
+            ? `\n\n--- BEGIN CONTEXT FILE LIST ---\n${input.contextFiles
+                .map((f) => f.slice(0, 500).replace(/[\x00-\x1f\x7f]/g, ""))
+                .join("\n")}\n--- END CONTEXT FILE LIST ---`
+            : "";
+        const messages = [];
+        if (input.systemPrompt) {
+            messages.push({ role: "system", content: input.systemPrompt });
+        }
+        messages.push({ role: "user", content: input.prompt + contextNote });
+        const clientOpts = {};
+        if (this.opts.baseURL)
+            clientOpts.baseURL = this.opts.baseURL;
+        // Use provider-specific API key env var if set, fall back to OPENAI_API_KEY
+        const apiKey = this.apiKey();
+        if (apiKey)
+            clientOpts.apiKey = apiKey;
+        const client = new OpenAICtor(clientOpts);
+        const start = Date.now();
+        const model = input.model ?? this.opts.defaultModel ?? "gpt-4o";
+        this.log(`[${this.name}] streaming: model=${model} workspace=${input.workspace}`);
+        let text = "";
+        let firstChunkAt;
+        try {
+            // biome-ignore lint/suspicious/noExplicitAny: dynamic import shape
+            const stream = await client.chat.completions.create({
+                model,
+                max_tokens: maxTokens,
+                ...(temperature !== undefined ? { temperature } : {}),
+                messages,
+                stream: true,
+            }, { signal: input.signal });
+            // biome-ignore lint/suspicious/noExplicitAny: stream shape from dynamic import
+            for await (const chunk of stream) {
+                const delta = chunk.choices?.[0]?.delta?.content ?? "";
+                if (delta) {
+                    if (firstChunkAt === undefined)
+                        firstChunkAt = Date.now();
+                    text += delta;
+                    if (text.length <= OUTPUT_CAP) {
+                        input.onChunk?.(delta);
+                    }
+                }
+            }
+        }
+        catch (err) {
+            const isAbort = (err instanceof Error && err.name === "AbortError") ||
+                input.signal.aborted;
+            if (isAbort) {
+                return {
+                    text: text.slice(0, OUTPUT_CAP),
+                    durationMs: Date.now() - start,
+                    wasAborted: true,
+                    startupMs: firstChunkAt !== undefined ? firstChunkAt - start : undefined,
+                };
+            }
+            return {
+                text: text.slice(0, OUTPUT_CAP),
+                durationMs: Date.now() - start,
+                errorMessage: err instanceof Error ? err.message : String(err),
+            };
+        }
+        return {
+            text: text.slice(0, OUTPUT_CAP),
+            durationMs: Date.now() - start,
+            startupMs: firstChunkAt !== undefined ? firstChunkAt - start : undefined,
+            providerMeta: { model },
+        };
+    }
+    /** Override in subclasses to use a different env var. */
+    apiKey() {
+        return process.env.OPENAI_API_KEY;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/drivers/openai/index.js.map

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

package/dist/drivers/types.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Provider-neutral driver types.
+ * All drivers implement ProviderDriver; Claude-specific fields go in providerOptions.
+ */
+export interface ProviderTaskInput {
+    prompt: string;
+    /** Working directory / context hint passed as cwd to the subprocess or API call. */
+    workspace: string;
+    timeoutMs: number;
+    signal: AbortSignal;
+    onChunk?: (chunk: string) => void;
+    /** Informational list of paths; driver decides how to surface them. */
+    contextFiles?: string[];
+    /** Provider-specific model ID (e.g. "claude-sonnet-4-6", "gemini-2.5-pro"). */
+    model?: string;
+    systemPrompt?: string;
+    /** Startup timeout: abort if no output arrives within this many ms of spawn. */
+    startupTimeoutMs?: number;
+    /**
+     * Provider-specific overrides — driver may ignore unknown keys.
+     * Claude subprocess: { effort, fallbackModel, maxBudgetUsd, useAnt }
+     * Gemini subprocess: { binary }
+     * OpenAI API: { maxTokens, temperature }
+     */
+    providerOptions?: Record<string, unknown>;
+}
+export interface ProviderTaskResult {
+    text: string;
+    durationMs: number;
+    startupMs?: number;
+    wasAborted?: boolean;
+    /** Set when the provider signals an error (replaces exitCode for API drivers). */
+    errorMessage?: string;
+    /** Tokens used, resolved model, etc. Driver-specific. */
+    providerMeta?: Record<string, unknown>;
+    exitCode?: number;
+    stderrTail?: string;
+    startupTimedOut?: boolean;
+}
+export type ProviderTaskOutcome = {
+    outcome: "done";
+    text: string;
+    durationMs: number;
+    startupMs?: number;
+    providerMeta?: Record<string, unknown>;
+} | {
+    outcome: "error";
+    errorMessage: string;
+    durationMs: number;
+} | {
+    outcome: "aborted";
+    cancelKind: "startup_timeout" | "timeout" | "user";
+    durationMs: number;
+};
+export interface ProviderDriver {
+    readonly name: string;
+    /** Primary entry point. Must resolve; never reject (swallow errors into result). */
+    run(input: ProviderTaskInput): Promise<ProviderTaskResult>;
+    /** Optional: discriminated-union variant. Default impl wraps run(). */
+    runOutcome?(input: ProviderTaskInput): Promise<ProviderTaskOutcome>;
+    /** Optional: long-lived session lifecycle (server-mode drivers). */
+    spawnForSession?(sessionId: string): Promise<void>;
+    killForSession?(sessionId: string): void;
+    /** Called once on bridge shutdown. Clean up connections, temp files. */
+    destroy?(): Promise<void>;
+}
+export declare function toProviderTaskOutcome(result: ProviderTaskResult, cancelReason?: "timeout" | "startup_timeout" | "user" | "shutdown"): ProviderTaskOutcome;
+/**
+ * @deprecated Use ProviderDriver. IClaudeDriver is a backward-compat alias.
+ * Will be removed in a future minor version.
+ */
+export type IClaudeDriver = ProviderDriver;

package/dist/drivers/types.js

@@ -0,0 +1,30 @@
+/**
+ * Provider-neutral driver types.
+ * All drivers implement ProviderDriver; Claude-specific fields go in providerOptions.
+ */
+export function toProviderTaskOutcome(result, cancelReason) {
+    if (result.wasAborted) {
+        const cancelKind = result.startupTimedOut || cancelReason === "startup_timeout"
+            ? "startup_timeout"
+            : cancelReason === "timeout"
+                ? "timeout"
+                : "user";
+        return { outcome: "aborted", cancelKind, durationMs: result.durationMs };
+    }
+    if (result.errorMessage ||
+        (result.exitCode !== undefined && result.exitCode !== 0)) {
+        return {
+            outcome: "error",
+            errorMessage: result.errorMessage ?? `exit code ${result.exitCode}`,
+            durationMs: result.durationMs,
+        };
+    }
+    return {
+        outcome: "done",
+        text: result.text,
+        durationMs: result.durationMs,
+        startupMs: result.startupMs,
+        providerMeta: result.providerMeta,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/drivers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/drivers/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoEH,MAAM,UAAU,qBAAqB,CACnC,MAA0B,EAC1B,YAAkE;IAElE,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,MAAM,UAAU,GACd,MAAM,CAAC,eAAe,IAAI,YAAY,KAAK,iBAAiB;YAC1D,CAAC,CAAC,iBAAiB;YACnB,CAAC,CAAC,YAAY,KAAK,SAAS;gBAC1B,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,MAAM,CAAC;QACf,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;IAC3E,CAAC;IACD,IACE,MAAM,CAAC,YAAY;QACnB,CAAC,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,CAAC,EACxD,CAAC;QACD,OAAO;YACL,OAAO,EAAE,OAAO;YAChB,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,aAAa,MAAM,CAAC,QAAQ,EAAE;YACnE,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC;IACJ,CAAC;IACD,OAAO;QACL,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,YAAY,EAAE,MAAM,CAAC,YAAY;KAClC,CAAC;AACJ,CAAC"}

package/dist/index.js

@@ -3,7 +3,7 @@
 // Uses Node 20.6+ native dotenv loader; falls back to manual parse for older Node.
 {
     const { fileURLToPath: _fileURLToPath } = await import("node:url");
-    const envPath = _fileURLToPath(new URL("../../.env", import.meta.url));
+    const envPath = _fileURLToPath(new URL("../.env", import.meta.url));
     try {
         const { readFileSync, existsSync } = await import("node:fs");
         if (existsSync(envPath)) {