coterie 0.1.0

package/README.md

@@ -0,0 +1,137 @@
+# coterie
+
+A conversational meta-agent for your terminal. You chat like you're talking to a
+single coding assistant, but **every turn runs through a multi-agent coordination
+round** (debate, adversarial review, tournament, consensus, or single) behind the
+scenes — raising the reliability and quality of each response.
+
+```bash
+coterie chat                       # in any repo — each prompt runs a multi-agent round
+```
+
+```
+▲ coterie chat
+  mode=adversarial · workdir=. · agents: claude-code, codex, cursor · $0 metered
+  modes: single, adversarial, debate, tournament, consensus
+  Each turn: agents deliberate, then one finalizer applies edits + replies. /mode to change modes. /help for commands.
+
+coterie(adversarial)› add a retry decorator to http.py and cover it with tests
+  · implementer (claude-code)
+  · auditor (codex)
+  · judge → claude-code: tests pass, edge cases covered
+
+  Added @retry to http.py with exponential backoff + tests in test_http.py.
+```
+
+## Setup (one-time)
+
+Install from npm — puts the `coterie` command on your PATH:
+
+```bash
+npm install -g coterie
+```
+
+<details>
+<summary>Or install from source</summary>
+
+```bash
+git clone https://github.com/cxk280/coterie
+cd coterie/packages/coterie-js
+npm install
+npm run build      # compile TypeScript → dist/
+npm link           # puts `coterie` on your PATH globally
+```
+</details>
+
+Sign in to **at least two** agent CLIs — Coterie coordinates multiple agents, so
+it needs two to deliberate (any pair), and uses all you have. They run on your
+**subscriptions**, no API keys:
+
+```bash
+claude          # sign in to Claude Max, then exit
+codex           # sign in with your ChatGPT account
+cursor-agent login   # sign in to Cursor
+```
+
+Run `coterie doctor` to see which are ready:
+
+```bash
+coterie doctor  # ✓/✗ per agent; exits non-zero until at least two are ready
+```
+
+Coterie keeps no config of binary paths or credentials — it finds each CLI on
+your `PATH` and lets it read its own creds, so it authenticates exactly as your
+shell does. `coterie chat` also runs this check on startup.
+
+Then, in any repo you want it to work in:
+
+```bash
+cd ~/my-project
+coterie chat        # runs entirely on your subscriptions — $0 metered
+```
+
+## How it works
+
+Each prompt becomes a one-turn coordination round over the **real coding-agent
+CLIs you already have** — any two or more of Claude Code, Codex, and Cursor. The
+mode decides how they cooperate; the synthesized result (and any file edits) is
+the reply. Switch strategies per prompt with `/mode <name>`.
+
+Each turn has two phases: the agents **deliberate** in throwaway worktrees (they
+never touch your files), then one **finalizer** agent runs in your workdir,
+applies the edits, and writes the plain-prose reply. So file edits land in *every*
+mode, and you never get raw findings JSON back. The mode shapes the deliberation:
+
+| Mode | What the agents do | Best for |
+|---|---|---|
+| `single` | a router picks one agent to attempt it | quick edits, simple asks |
+| `adversarial` | implementer + auditor + judge, with refinement | reliable code changes |
+| `debate` | two agents argue, a moderator + judge decide | decisions, tradeoffs |
+| `tournament` | N agents compete, a bracket judge ranks | best-of-N for critical work |
+| `consensus` | agents review independently, an engine merges agreement | reviews, audits |
+
+## Runs on your subscriptions ($0 metered)
+
+Everything runs on your existing logins — the agents on **Claude Max**, **ChatGPT**
+(Codex), and **Cursor Pro**, and the behind-the-scenes coordination (routing /
+judging / moderating) on your **Claude subscription** via `claude -p`. So a full
+turn is **$0 metered** — no setup, no flags. On startup `coterie chat` checks each
+required CLI is installed and signed in, and tells you exactly what to do if not.
+
+> **No pay-as-you-go API backend (yet).** Coordination is subscription-only by
+> design, so a session can never run up a surprise metered bill. A pluggable API
+> provider (Anthropic / OpenAI-compatible) may be added later for environments
+> without the subscription CLIs — it's intentionally not wired in today.
+
+> **Grok is deferred** for the same reason: unlike Claude / Codex / Cursor it has
+> no subscription-backed headless coding CLI (only the pay-as-you-go xAI API), so
+> it can't join the $0-metered lineup yet.
+
+## Commands
+
+`/mode <name>` · `/show` `/hide` (live agent exchanges) · `/clear` · `/help` · `/exit`
+
+The agent exchanges stream live by default — each agent's contribution, the
+judge's verdict, what the finalizer changed. `/hide` (or `--quiet`) shows only the
+reply.
+
+```bash
+coterie chat --mode debate --workdir ~/proj   # start in a mode, against a repo
+coterie chat --quiet                            # hide the agent exchanges
+```
+
+## One-shot (non-conversational)
+
+```bash
+coterie run "find every bug in src/auth.ts" --config examples/consensus.coterie.yaml
+```
+
+## Test
+
+```bash
+npm test            # fast, offline, deterministic — the CI gate
+npm run test:e2e    # real-agent end-to-end (spends subscription calls; needs claude + codex signed in)
+```
+
+See the [top-level README](../../README.md) for architecture, the five modes in
+depth, and the full breakdown of the three test layers.

package/dist/adapters/base.d.ts

@@ -0,0 +1,56 @@
+/** CLIAdapter contract. Mirrors Python's `adapters/base.py`. */
+export interface AdapterResult {
+    stdout: string;
+    stderr: string;
+    exit_code: number;
+    files_changed: string[];
+    duration_s: number;
+    cost_estimate_usd: number | null;
+}
+export interface CLIAdapterCtor {
+    adapterName: string;
+    new (agent_id: string, opts?: {
+        model?: string;
+    }): CLIAdapter;
+}
+/** A DOMException-style abort error so callers can detect cancellation via
+ *  `err.name === "AbortError"` (matches what `fetch`/AbortSignal users expect). */
+export declare function abortError(): Error;
+export declare abstract class CLIAdapter {
+    readonly agent_id: string;
+    readonly opts: {
+        model?: string;
+    };
+    static readonly adapterName: string;
+    /**
+     * Env vars stripped from the agent subprocess. Lets an adapter force its CLI
+     * onto its own auth (e.g. a subscription session) instead of an API key that
+     * Coterie's coordination LLMs need in-process.
+     */
+    static readonly stripEnv: readonly string[];
+    constructor(agent_id: string, opts?: {
+        model?: string;
+    });
+    get model(): string | undefined;
+    private subprocessEnv;
+    abstract buildCommand(prompt: string, workdir: string, extra: Record<string, unknown>): string[];
+    abstract parseResult(stdout: string, stderr: string, exitCode: number): AdapterResult;
+    /** Turn one line of the CLI's streaming (NDJSON) output into a short, human
+     *  -readable progress note (e.g. "→ Read foo.ts", "→ $ npm test"), or null to
+     *  ignore it. Adapters that run in a streaming format override this; the
+     *  default (no streaming) yields nothing. */
+    streamEvent(_line: string): string | null;
+    /** Run the agent CLI asynchronously. Async (vs the old `spawnSync`) is what
+     *  keeps Node's event loop free during a turn — so the chat trace can stream
+     *  live, SIGINT is handled, and fan-out agents run concurrently. Honors a
+     *  timeout and an optional AbortSignal (both kill the child). */
+    run(prompt: string, workdir: string, opts?: {
+        timeoutMs?: number;
+        extra?: Record<string, unknown>;
+        signal?: AbortSignal;
+        onStream?: (text: string) => void;
+    }): Promise<AdapterResult>;
+    private spawnCollect;
+    protected gitChangedFiles(workdir: string): string[];
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/adapters/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/adapters/base.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAMhE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,UAAU,CAAC;CAC/D;AAED;mFACmF;AACnF,wBAAgB,UAAU,IAAI,KAAK,CAIlC;AAED,8BAAsB,UAAU;aAWZ,QAAQ,EAAE,MAAM;aAChB,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAX1C,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAEpC;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAM;gBAG/B,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO;IAG/C,IAAI,KAAK,IAAI,MAAM,GAAG,SAAS,CAE9B;IAED,OAAO,CAAC,aAAa;IAQrB,QAAQ,CAAC,YAAY,CACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,EAAE;IAEX,QAAQ,CAAC,WAAW,CAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,aAAa;IAEhB;;;iDAG6C;IAC7C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAIzC;;;qEAGiE;IAC3D,GAAG,CACP,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,GAAE;QACJ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,MAAM,CAAC,EAAE,WAAW,CAAC;QACrB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;KAC9B,GACL,OAAO,CAAC,aAAa,CAAC;IAczB,OAAO,CAAC,YAAY;IAuGpB,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;CAWrD"}

package/dist/adapters/base.js

@@ -0,0 +1,176 @@
+/** CLIAdapter contract. Mirrors Python's `adapters/base.py`. */
+import { spawn, spawnSync } from "node:child_process";
+import { sleepAwareTimeout } from "../core/timeout.js";
+/** A DOMException-style abort error so callers can detect cancellation via
+ *  `err.name === "AbortError"` (matches what `fetch`/AbortSignal users expect). */
+export function abortError() {
+    const e = new Error("The operation was aborted");
+    e.name = "AbortError";
+    return e;
+}
+export class CLIAdapter {
+    agent_id;
+    opts;
+    static adapterName;
+    /**
+     * Env vars stripped from the agent subprocess. Lets an adapter force its CLI
+     * onto its own auth (e.g. a subscription session) instead of an API key that
+     * Coterie's coordination LLMs need in-process.
+     */
+    static stripEnv = [];
+    constructor(agent_id, opts = {}) {
+        this.agent_id = agent_id;
+        this.opts = opts;
+    }
+    get model() {
+        return this.opts.model;
+    }
+    subprocessEnv() {
+        const strip = this.constructor.stripEnv;
+        if (!strip.length)
+            return undefined; // inherit process.env
+        const env = { ...process.env };
+        for (const key of strip)
+            delete env[key];
+        return env;
+    }
+    /** Turn one line of the CLI's streaming (NDJSON) output into a short, human
+     *  -readable progress note (e.g. "→ Read foo.ts", "→ $ npm test"), or null to
+     *  ignore it. Adapters that run in a streaming format override this; the
+     *  default (no streaming) yields nothing. */
+    streamEvent(_line) {
+        return null;
+    }
+    /** Run the agent CLI asynchronously. Async (vs the old `spawnSync`) is what
+     *  keeps Node's event loop free during a turn — so the chat trace can stream
+     *  live, SIGINT is handled, and fan-out agents run concurrently. Honors a
+     *  timeout and an optional AbortSignal (both kill the child). */
+    async run(prompt, workdir, opts = {}) {
+        const argv = this.buildCommand(prompt, workdir, opts.extra ?? {});
+        const [cmd, ...args] = argv;
+        if (!cmd)
+            throw new Error(`Adapter ${this.agent_id} produced an empty command`);
+        const t0 = Date.now();
+        const { stdout, stderr, code } = await this.spawnCollect(cmd, args, workdir, opts);
+        const result = this.parseResult(stdout, stderr, code);
+        result.duration_s = (Date.now() - t0) / 1000;
+        // Report which files the agent actually touched (so the trace can show
+        // "edited X, Y") unless the adapter already computed it.
+        if (!result.files_changed?.length)
+            result.files_changed = this.gitChangedFiles(workdir);
+        return result;
+    }
+    spawnCollect(cmd, args, workdir, opts) {
+        return new Promise((resolve, reject) => {
+            if (opts.signal?.aborted)
+                return reject(abortError());
+            // stdin = /dev/null so the child gets an immediate EOF. Headless agent CLIs
+            // (notably `codex exec`) otherwise block forever waiting on stdin — async
+            // spawn leaves the stdin pipe open, unlike the old spawnSync which closed it.
+            const child = spawn(cmd, args, {
+                cwd: workdir,
+                env: this.subprocessEnv(),
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+            let stdout = "";
+            let stderr = "";
+            const cap = 32 * 1024 * 1024;
+            // Buffer stdout into whole lines so each NDJSON event can be turned into a
+            // live progress note as it streams (without blocking — the loop is free).
+            const lineCap = 1024 * 1024;
+            let lineBuf = "";
+            // True while we're discarding an over-cap, not-yet-terminated line; reset
+            // at the next newline so streaming resyncs on the following whole line.
+            let lineOverflow = false;
+            child.stdout?.on("data", (d) => {
+                const s = d.toString();
+                if (stdout.length < cap)
+                    stdout += s;
+                if (!opts.onStream)
+                    return;
+                lineBuf += s;
+                let nl;
+                while ((nl = lineBuf.indexOf("\n")) >= 0) {
+                    const line = lineBuf.slice(0, nl);
+                    lineBuf = lineBuf.slice(nl + 1);
+                    if (lineOverflow) {
+                        // This newline closes the dropped line; resume on the next one.
+                        lineOverflow = false;
+                        continue;
+                    }
+                    try {
+                        const note = this.streamEvent(line);
+                        if (note)
+                            opts.onStream(note);
+                    }
+                    catch {
+                        // a malformed line must never break the run
+                    }
+                }
+                // Bound the partial-line buffer: a producer that emits a multi-megabyte
+                // single line (or never a newline) must not grow it without limit — the
+                // authoritative `stdout` is capped, and progress notes are best-effort,
+                // so drop the partial line and resync at the next newline.
+                if (lineBuf.length > lineCap) {
+                    lineBuf = "";
+                    lineOverflow = true;
+                }
+            });
+            child.stderr?.on("data", (d) => {
+                if (stderr.length < cap)
+                    stderr += d.toString();
+            });
+            // Graceful kill: SIGTERM, then SIGKILL if it doesn't exit in time.
+            const hardKill = () => {
+                if (!child.killed)
+                    child.kill("SIGKILL");
+            };
+            const kill = () => {
+                child.kill("SIGTERM");
+                setTimeout(hardKill, 2_000).unref();
+            };
+            const timeoutMs = opts.timeoutMs ?? 600_000;
+            let timedOut = false;
+            // Sleep-aware: a wall-clock timer would kill a merely-suspended child the
+            // instant the machine wakes. This only counts active time.
+            const clearTimer = sleepAwareTimeout(timeoutMs, () => {
+                timedOut = true;
+                kill();
+            });
+            const onAbort = () => {
+                kill();
+                cleanup();
+                reject(abortError());
+            };
+            opts.signal?.addEventListener("abort", onAbort, { once: true });
+            const cleanup = () => {
+                clearTimer();
+                opts.signal?.removeEventListener("abort", onAbort);
+            };
+            child.on("error", (err) => {
+                cleanup();
+                reject(err);
+            });
+            child.on("close", (code) => {
+                cleanup();
+                if (timedOut)
+                    reject(new Error(`timed out after ${Math.round(timeoutMs / 1000)}s`));
+                else
+                    resolve({ stdout, stderr, code: code ?? 1 });
+            });
+        });
+    }
+    gitChangedFiles(workdir) {
+        const proc = spawnSync("git", ["status", "--porcelain"], {
+            cwd: workdir,
+            encoding: "utf8",
+        });
+        if (proc.status !== 0)
+            return [];
+        return (proc.stdout ?? "")
+            .split("\n")
+            .filter((l) => l.trim())
+            .map((l) => l.slice(3));
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/adapters/base.js.map

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

package/dist/adapters/claudeCode.d.ts

@@ -0,0 +1,11 @@
+import { CLIAdapter, type AdapterResult } from "./base.js";
+export declare class ClaudeCodeAdapter extends CLIAdapter {
+    static readonly adapterName = "claude-code";
+    static readonly stripEnv: string[];
+    buildCommand(prompt: string, _workdir: string, extra?: Record<string, unknown>): string[];
+    /** Emit a note for each tool the agent invokes; skip thinking/text/bookkeeping
+     *  (the final answer is rendered when the run completes). */
+    streamEvent(line: string): string | null;
+    parseResult(stdout: string, stderr: string, exitCode: number): AdapterResult;
+}
+//# sourceMappingURL=claudeCode.d.ts.map

package/dist/adapters/claudeCode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claudeCode.d.ts","sourceRoot":"","sources":["../../src/adapters/claudeCode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAK3D,qBAAa,iBAAkB,SAAQ,UAAU;IAC/C,MAAM,CAAC,QAAQ,CAAC,WAAW,iBAAiB;IAI5C,MAAM,CAAC,QAAQ,CAAC,QAAQ,WAAiD;IAEzE,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,MAAM,EAAE;IAU7F;iEAC6D;IACpD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IASjD,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa;CA8B7E"}

package/dist/adapters/claudeCode.js

@@ -0,0 +1,65 @@
+import { CLIAdapter } from "./base.js";
+import { parseJsonLoose, parseNdjson } from "../core/json.js";
+import { toolHint } from "./stream.js";
+import { registerAdapter } from "../core/registry.js";
+export class ClaudeCodeAdapter extends CLIAdapter {
+    static adapterName = "claude-code";
+    // Run on the user's Claude subscription (OAuth session), not a pay-per-token
+    // API key — coordination LLMs use ANTHROPIC_API_KEY in-process, but the agent
+    // CLI should bill against the subscription.
+    static stripEnv = ["ANTHROPIC_API_KEY", "ANTHROPIC_AUTH_TOKEN"];
+    buildCommand(prompt, _workdir, extra = {}) {
+        // acceptEdits lets the agent apply file edits headlessly while still gating
+        // riskier tools — safe against an isolated workdir. stream-json (which needs
+        // --verbose) emits one NDJSON event per step so we can show live progress.
+        const permissionMode = extra.permissionMode ?? "acceptEdits";
+        const cmd = ["claude", "-p", prompt, "--output-format", "stream-json", "--verbose", "--permission-mode", permissionMode];
+        if (this.model)
+            cmd.push("--model", this.model);
+        return cmd;
+    }
+    /** Emit a note for each tool the agent invokes; skip thinking/text/bookkeeping
+     *  (the final answer is rendered when the run completes). */
+    streamEvent(line) {
+        const ev = parseJsonLoose(line);
+        if (ev?.type !== "assistant")
+            return null;
+        for (const c of ev.message?.content ?? []) {
+            if (c?.type === "tool_use")
+                return `→ ${c.name}${toolHint(c.input)}`;
+        }
+        return null;
+    }
+    parseResult(stdout, stderr, exitCode) {
+        // stdout is an NDJSON stream; the final `result` event carries the answer + cost.
+        const events = parseNdjson(stdout);
+        const result = events.find((e) => e?.type === "result");
+        if (result) {
+            const files = events
+                .flatMap((e) => (e?.type === "assistant" ? (e.message?.content ?? []) : []))
+                .filter((c) => c?.type === "tool_use" && /^(Edit|Write|NotebookEdit)$/.test(c.name))
+                .map((c) => c.input?.file_path)
+                .filter(Boolean);
+            return {
+                stdout: result.result ?? stdout,
+                stderr,
+                exit_code: exitCode,
+                files_changed: [...new Set(files)],
+                duration_s: 0,
+                cost_estimate_usd: result.total_cost_usd ?? null,
+            };
+        }
+        // Fallback: not the expected stream (older CLI / plain JSON / prose).
+        const loose = parseJsonLoose(stdout);
+        return {
+            stdout: loose?.result ?? stdout,
+            stderr,
+            exit_code: exitCode,
+            files_changed: [],
+            duration_s: 0,
+            cost_estimate_usd: loose?.total_cost_usd ?? null,
+        };
+    }
+}
+registerAdapter(ClaudeCodeAdapter);
+//# sourceMappingURL=claudeCode.js.map

package/dist/adapters/claudeCode.js.map

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

package/dist/adapters/codex.d.ts

@@ -0,0 +1,10 @@
+import { CLIAdapter, type AdapterResult } from "./base.js";
+export declare class CodexAdapter extends CLIAdapter {
+    static readonly adapterName = "codex";
+    buildCommand(prompt: string, _workdir: string, extra?: Record<string, unknown>): string[];
+    /** Each non-message item (a command, a file change, reasoning) is live activity;
+     *  the final agent_message is the answer, surfaced on completion. */
+    streamEvent(line: string): string | null;
+    parseResult(stdout: string, stderr: string, exit_code: number): AdapterResult;
+}
+//# sourceMappingURL=codex.d.ts.map

package/dist/adapters/codex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex.d.ts","sourceRoot":"","sources":["../../src/adapters/codex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAI3D,qBAAa,YAAa,SAAQ,UAAU;IAC1C,MAAM,CAAC,QAAQ,CAAC,WAAW,WAAW;IAEtC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,MAAM,EAAE;IAU7F;yEACqE;IAC5D,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAajD,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa;CAgB9E"}

package/dist/adapters/codex.js

@@ -0,0 +1,51 @@
+import { CLIAdapter } from "./base.js";
+import { parseJsonLoose, parseNdjson } from "../core/json.js";
+import { registerAdapter } from "../core/registry.js";
+export class CodexAdapter extends CLIAdapter {
+    static adapterName = "codex";
+    buildCommand(prompt, _workdir, extra = {}) {
+        // workspace-write sandboxes edits to the cwd; --skip-git-repo-check lets exec
+        // run in a plain (non-git) workdir; --json streams JSONL events for live progress.
+        const sandbox = extra.sandbox ?? "workspace-write";
+        const cmd = ["codex", "exec", "--skip-git-repo-check", "--json", "-s", sandbox];
+        if (this.model)
+            cmd.push("--model", this.model);
+        cmd.push(prompt);
+        return cmd;
+    }
+    /** Each non-message item (a command, a file change, reasoning) is live activity;
+     *  the final agent_message is the answer, surfaced on completion. */
+    streamEvent(line) {
+        const ev = parseJsonLoose(line);
+        if (ev?.type !== "item.completed")
+            return null;
+        const it = ev.item ?? {};
+        if (it.type === "agent_message" || it.type === "reasoning")
+            return null;
+        if (it.command)
+            return `→ $ ${String(it.command).replace(/\s+/g, " ").slice(0, 80)}`;
+        if (it.type === "file_change" || it.type === "patch") {
+            const f = it.path ?? (Array.isArray(it.changes) ? it.changes.map((c) => c.path).join(", ") : "");
+            return `→ edit ${String(f).slice(0, 80)}`.trimEnd();
+        }
+        return `→ ${String(it.type).replace(/_/g, " ")}`;
+    }
+    parseResult(stdout, stderr, exit_code) {
+        // stdout is JSONL; the answer is the last `agent_message` item.
+        const events = parseNdjson(stdout);
+        const messages = events
+            .filter((e) => e?.type === "item.completed" && e.item?.type === "agent_message")
+            .map((e) => e.item.text)
+            .filter(Boolean);
+        return {
+            stdout: messages.length ? messages[messages.length - 1] : stdout,
+            stderr,
+            exit_code,
+            files_changed: [],
+            duration_s: 0,
+            cost_estimate_usd: null,
+        };
+    }
+}
+registerAdapter(CodexAdapter);
+//# sourceMappingURL=codex.js.map

package/dist/adapters/codex.js.map

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

package/dist/adapters/cursor.d.ts

@@ -0,0 +1,16 @@
+import { CLIAdapter, type AdapterResult } from "./base.js";
+/**
+ * Cursor's headless agent CLI (`cursor-agent`), run on a Cursor Pro subscription.
+ * NB: `cursor-agent` is a separate install from the `cursor` editor launcher; the
+ * chat preflight checks for it. Flags verified against cursor-agent's print mode:
+ * `-p` non-interactive, `--output-format stream-json` (NDJSON events for live
+ * progress), `--force` to apply edits without a confirmation/trust prompt.
+ */
+export declare class CursorAdapter extends CLIAdapter {
+    static readonly adapterName = "cursor";
+    buildCommand(prompt: string, _workdir: string, _extra?: Record<string, unknown>): string[];
+    /** Surface tool calls as live activity; skip thinking deltas + the final text. */
+    streamEvent(line: string): string | null;
+    parseResult(stdout: string, stderr: string, exitCode: number): AdapterResult;
+}
+//# sourceMappingURL=cursor.d.ts.map

package/dist/adapters/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/adapters/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAK3D;;;;;;GAMG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAC3C,MAAM,CAAC,QAAQ,CAAC,WAAW,YAAY;IAEvC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,MAAM,EAAE;IAM9F,kFAAkF;IACzE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAWjD,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa;CAa7E"}

package/dist/adapters/cursor.js

@@ -0,0 +1,47 @@
+import { CLIAdapter } from "./base.js";
+import { parseJsonLoose, parseNdjson } from "../core/json.js";
+import { toolHint } from "./stream.js";
+import { registerAdapter } from "../core/registry.js";
+/**
+ * Cursor's headless agent CLI (`cursor-agent`), run on a Cursor Pro subscription.
+ * NB: `cursor-agent` is a separate install from the `cursor` editor launcher; the
+ * chat preflight checks for it. Flags verified against cursor-agent's print mode:
+ * `-p` non-interactive, `--output-format stream-json` (NDJSON events for live
+ * progress), `--force` to apply edits without a confirmation/trust prompt.
+ */
+export class CursorAdapter extends CLIAdapter {
+    static adapterName = "cursor";
+    buildCommand(prompt, _workdir, _extra = {}) {
+        const cmd = ["cursor-agent", "-p", prompt, "--output-format", "stream-json", "--force"];
+        if (this.model)
+            cmd.push("--model", this.model);
+        return cmd;
+    }
+    /** Surface tool calls as live activity; skip thinking deltas + the final text. */
+    streamEvent(line) {
+        const ev = parseJsonLoose(line);
+        if (ev?.type !== "assistant")
+            return null;
+        for (const c of ev.message?.content ?? []) {
+            if (c?.type === "tool_call" || c?.type === "tool_use") {
+                return `→ ${c.name ?? "tool"}${toolHint(c.input ?? c.args)}`;
+            }
+        }
+        return null;
+    }
+    parseResult(stdout, stderr, exitCode) {
+        // stdout is an NDJSON stream; the `result` event carries the final answer.
+        const events = parseNdjson(stdout);
+        const result = events.find((e) => e?.type === "result");
+        return {
+            stdout: result?.result ?? stdout,
+            stderr,
+            exit_code: exitCode,
+            files_changed: [],
+            duration_s: 0,
+            cost_estimate_usd: null,
+        };
+    }
+}
+registerAdapter(CursorAdapter);
+//# sourceMappingURL=cursor.js.map

package/dist/adapters/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/adapters/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAsB,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,OAAO,aAAc,SAAQ,UAAU;IAC3C,MAAM,CAAU,WAAW,GAAG,QAAQ,CAAC;IAEvC,YAAY,CAAC,MAAc,EAAE,QAAgB,EAAE,SAAkC,EAAE;QACjF,MAAM,GAAG,GAAG,CAAC,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;QACxF,IAAI,IAAI,CAAC,KAAK;YAAE,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAChD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,kFAAkF;IACzE,WAAW,CAAC,IAAY;QAC/B,MAAM,EAAE,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,EAAE,EAAE,IAAI,KAAK,WAAW;YAAE,OAAO,IAAI,CAAC;QAC1C,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC;YAC1C,IAAI,CAAC,EAAE,IAAI,KAAK,WAAW,IAAI,CAAC,EAAE,IAAI,KAAK,UAAU,EAAE,CAAC;gBACtD,OAAO,KAAK,CAAC,CAAC,IAAI,IAAI,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/D,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,WAAW,CAAC,MAAc,EAAE,MAAc,EAAE,QAAgB;QAC1D,2EAA2E;QAC3E,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC;QACxD,OAAO;YACL,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,MAAM;YAChC,MAAM;YACN,SAAS,EAAE,QAAQ;YACnB,aAAa,EAAE,EAAE;YACjB,UAAU,EAAE,CAAC;YACb,iBAAiB,EAAE,IAAI;SACxB,CAAC;IACJ,CAAC;;AAGH,eAAe,CAAC,aAAa,CAAC,CAAC"}

package/dist/adapters/fake.d.ts

@@ -0,0 +1,19 @@
+/** In-process FakeAdapter for tests / offline demos. */
+import { CLIAdapter, type AdapterResult } from "./base.js";
+export declare class FakeAdapterError extends Error {
+}
+export declare class FakeAdapter extends CLIAdapter {
+    static readonly adapterName = "fake";
+    private static scripts;
+    private static invocationsByAgent;
+    static script(agent_id: string, results: AdapterResult[]): void;
+    static invocationsFor(agent_id: string): Array<{
+        prompt: string;
+        workdir: string;
+    }>;
+    static resetAll(): void;
+    buildCommand(): string[];
+    parseResult(stdout: string, stderr: string, exit_code: number): AdapterResult;
+    run(prompt: string, workdir: string): Promise<AdapterResult>;
+}
+//# sourceMappingURL=fake.d.ts.map

package/dist/adapters/fake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake.d.ts","sourceRoot":"","sources":["../../src/adapters/fake.ts"],"names":[],"mappings":"AAAA,wDAAwD;AAExD,OAAO,EAAE,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAG3D,qBAAa,gBAAiB,SAAQ,KAAK;CAAG;AAE9C,qBAAa,WAAY,SAAQ,UAAU;IACzC,MAAM,CAAC,QAAQ,CAAC,WAAW,UAAU;IAErC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAsC;IAC5D,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAiE;IAElG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,IAAI;IAO/D,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAInF,MAAM,CAAC,QAAQ,IAAI,IAAI;IAKvB,YAAY,IAAI,MAAM,EAAE;IAIxB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa;IAI9D,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAa5E"}