coterie 0.1.0

package/dist/chat/transcript.js

@@ -0,0 +1,39 @@
+/** Conversation memory. Agents are stateless subprocess calls, so prior turns
+ *  are threaded into each new turn's task as context. */
+/** Cap on how much prior conversation rides into each turn's task. Prompts are
+ *  passed as a subprocess argv element, so an unbounded transcript would inflate
+ *  every turn's cost and eventually exceed the OS argv limit (ARG_MAX → E2BIG).
+ *  We keep the most recent turns within this character budget. */
+const MAX_HISTORY_CHARS = 12_000;
+export class Transcript {
+    turns = [];
+    add(role, content) {
+        this.turns.push({ role, content });
+    }
+    clear() {
+        this.turns = [];
+    }
+    get length() {
+        return this.turns.length;
+    }
+    /** Build the task for a new prompt, prepending the (bounded) conversation. */
+    taskFor(prompt) {
+        if (this.turns.length === 0)
+            return prompt;
+        const lines = [];
+        let used = 0;
+        // Walk newest→oldest, keeping turns until the budget is spent.
+        for (let i = this.turns.length - 1; i >= 0; i--) {
+            const t = this.turns[i];
+            const line = `${t.role === "user" ? "User" : "Assistant"}: ${t.content}`;
+            if (used + line.length > MAX_HISTORY_CHARS) {
+                lines.unshift("…(earlier conversation trimmed)…");
+                break;
+            }
+            lines.unshift(line);
+            used += line.length;
+        }
+        return `Conversation so far:\n${lines.join("\n\n")}\n\n---\nUser's new request: ${prompt}`;
+    }
+}
+//# sourceMappingURL=transcript.js.map

package/dist/chat/transcript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.js","sourceRoot":"","sources":["../../src/chat/transcript.ts"],"names":[],"mappings":"AAAA;yDACyD;AAOzD;;;kEAGkE;AAClE,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAEjC,MAAM,OAAO,UAAU;IACb,KAAK,GAAW,EAAE,CAAC;IAE3B,GAAG,CAAC,IAAkB,EAAE,OAAe;QACrC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAClB,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,8EAA8E;IAC9E,OAAO,CAAC,MAAc;QACpB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC;QAC3C,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,+DAA+D;QAC/D,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAChD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC;YACzB,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;YACzE,IAAI,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,iBAAiB,EAAE,CAAC;gBAC3C,KAAK,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC;gBAClD,MAAM;YACR,CAAC;YACD,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACpB,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC;QACtB,CAAC;QACD,OAAO,yBAAyB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,gCAAgC,MAAM,EAAE,CAAC;IAC7F,CAAC;CACF"}

package/dist/cli.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+/** Composition root. Picks LLM provider per role + executor. */
+import "./adapters/index.js";
+import "./modes/index.js";
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,gEAAgE;AAsBhE,OAAO,qBAAqB,CAAC;AAC7B,OAAO,kBAAkB,CAAC"}

package/dist/cli.js

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+/** Composition root. Picks LLM provider per role + executor. */
+import { setMaxListeners } from "node:events";
+import { Command } from "commander";
+import kleur from "kleur";
+// A turn aborts via one AbortSignal that LangGraph fans out to per-step derived
+// signals; raise the default ceiling for all newly-created EventTargets so a
+// multi-round turn never trips Node's MaxListenersExceededWarning.
+setMaxListeners(64);
+import { formatProblems, preflight } from "./chat/preflight.js";
+import { renderFailure, runFailed } from "./chat/render.js";
+import { loadConfig } from "./config.js";
+import { progress } from "./core/progress.js";
+import { validateRuntimeConfig } from "./core/validate.js";
+import { IsolatedWorktreeExecutor, LocalSubprocessExecutor } from "./core/executor.js";
+import { buildLLM, coordinationCliFor } from "./core/llm/build.js";
+import { buildGraph } from "./graph.js";
+import "./adapters/index.js"; // trigger adapter registration
+import "./modes/index.js"; // trigger mode registration
+function buildExecutor(cfg) {
+    const explicit = cfg.executor?.kind;
+    if (explicit === "local")
+        return new LocalSubprocessExecutor();
+    if (explicit === "isolated")
+        return new IsolatedWorktreeExecutor();
+    if (explicit != null) {
+        console.warn(kleur.yellow(`unknown executor.kind '${explicit}'; using the mode default (local/isolated)`));
+    }
+    // `run` has no separate finalizer, so adversarial/debate use the local executor
+    // on purpose — their edits land in the workdir (that's the point of `run`).
+    // The parallel many-agent modes isolate to avoid clobbering each other.
+    if (cfg.mode === "consensus" || cfg.mode === "tournament")
+        return new IsolatedWorktreeExecutor();
+    return new LocalSubprocessExecutor();
+}
+async function main() {
+    const program = new Command();
+    program
+        .name("coterie")
+        .description("Chat with a team of AI coding agents that collaborate on each task — in your terminal.")
+        .version("0.1.0")
+        .showHelpAfterError("(run `coterie --help` to see the available commands)");
+    program
+        .command("run")
+        .description("Run one task through a coordination mode from a config file (for scripting/CI; for interactive use see `chat`).")
+        .argument("<task>", "Task to run through the agent graph")
+        .requiredOption("--config <path>", "Path to a coterie.yaml config (see examples/ in the repo for templates)")
+        .option("--workdir <path>", "Working directory", ".")
+        .action(async (task, opts) => {
+        const cfg = loadConfig(opts.config);
+        validateRuntimeConfig(cfg);
+        // Same friendly preflight as chat: surface missing/signed-out agents up
+        // front instead of failing with a raw spawn error deep in the graph.
+        const problems = preflight(cfg);
+        if (problems.length) {
+            console.error(kleur.yellow(formatProblems(problems)));
+            process.exit(1);
+        }
+        const mode = cfg.mode;
+        const executor = buildExecutor(cfg);
+        const coordCli = coordinationCliFor(cfg.agents.map((a) => a.id));
+        const llms = {
+            supervisor_llm: mode === "single" ? await buildLLM(cfg.router?.model, coordCli) : null,
+            judge_llm: ["adversarial", "tournament", "debate"].includes(mode)
+                ? await buildLLM(cfg[mode]?.judge?.model, coordCli)
+                : null,
+            consensus_llm: mode === "consensus" ? await buildLLM(cfg.consensus?.engine?.model, coordCli) : null,
+            moderator_llm: mode === "debate" ? await buildLLM(cfg.debate?.moderator?.model, coordCli) : null,
+            planner_llm: cfg.planner?.enabled ? await buildLLM(cfg.planner?.model, coordCli) : null,
+        };
+        const graph = buildGraph({ workdir: opts.workdir, executor, config: cfg, ...llms });
+        console.log(kleur.cyan().bold(`— coterie · mode=${mode} · ${cfg.agents.length} agents —`));
+        // Stream live progress so a long run isn't a silent wait.
+        const onDone = ({ run }) => {
+            const tag = runFailed(run) ? kleur.yellow(`⚠ ${renderFailure(run)}`) : kleur.dim("done");
+            console.log(kleur.dim(`  · ${run.role} (${run.agent_id}) `) + tag);
+        };
+        progress.on("done", onDone);
+        const initial = {
+            task, mode, plan: [], current_step_idx: 0, runs: [], artifacts: {},
+            status: "planning", config: cfg, spend_usd: 0, route_history: [],
+            judge_history: [], next_agent: null, mode_state: {},
+        };
+        const final = await graph.invoke(initial, { recursionLimit: 24 }).finally(() => progress.off("done", onDone));
+        if (final.runs?.length)
+            console.log(final.runs[final.runs.length - 1].stdout);
+        for (const r of final.runs ?? []) {
+            if (runFailed(r))
+                console.error(kleur.yellow(`⚠ ${r.role} (${r.agent_id}) ${renderFailure(r)}`));
+        }
+        console.log(kleur.dim(`total spend ≈ $${(final.spend_usd ?? 0).toFixed(4)}`));
+        console.log(kleur.bold(`— ${final.status} —`));
+        process.exit(final.status === "done" ? 0 : 1);
+    });
+    program
+        .command("chat")
+        .description("Conversational REPL: each turn runs through a coordination mode behind the scenes.")
+        .option("--mode <mode>", "Coordination mode (single|adversarial|debate|tournament|consensus)", "adversarial")
+        .option("--workdir <path>", "Directory the agents read/edit", ".")
+        .option("--quiet", "Start with the live agent exchanges hidden (show only the final reply)", false)
+        .action(async (opts) => {
+        const { runChat } = await import("./chat/repl.js");
+        const valid = ["single", "adversarial", "debate", "tournament", "consensus"];
+        if (!valid.includes(opts.mode)) {
+            console.error(`unknown mode '${opts.mode}'; pick one of ${valid.join(", ")}`);
+            process.exit(2);
+        }
+        await runChat({ mode: opts.mode, workdir: opts.workdir, quiet: opts.quiet });
+    });
+    program
+        .command("doctor")
+        .description("Check which agent CLIs are installed and signed in (Coterie needs at least two).")
+        .action(async () => {
+        const { runDoctor, formatDoctor } = await import("./chat/doctor.js");
+        const result = runDoctor();
+        console.log(formatDoctor(result));
+        process.exit(result.ok ? 0 : 1);
+    });
+    // No subcommand: show help and exit cleanly (0). Printing help is a success,
+    // not an error — bare `coterie` shouldn't look like something went wrong.
+    if (process.argv.slice(2).length === 0) {
+        program.outputHelp();
+        return;
+    }
+    await program.parseAsync(process.argv);
+}
+main().catch((e) => {
+    // Friendly one-line errors for a CLI; full stack only when DEBUG is set.
+    console.error(kleur.red(e instanceof Error ? e.message : String(e)));
+    if (process.env.DEBUG && e instanceof Error)
+        console.error(e.stack);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,2 @@
+export declare function loadConfig(path: string): Record<string, any>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAYA,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAuC5D"}

package/dist/config.js

@@ -0,0 +1,52 @@
+import { readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import Ajv2020 from "ajv/dist/2020.js";
+import { parse as parseYaml } from "yaml";
+const here = dirname(fileURLToPath(import.meta.url));
+// Schema ships inside the package (../schemas relative to both src/ and dist/),
+// so config validation works for npm installs, not just the source checkout.
+const SCHEMA_PATH = resolve(here, "..", "schemas", "coterie.config.schema.json");
+export function loadConfig(path) {
+    let text;
+    try {
+        text = readFileSync(path, "utf8");
+    }
+    catch (e) {
+        if (e?.code === "ENOENT")
+            throw new Error(`Config file not found: ${path}`);
+        throw e;
+    }
+    let raw;
+    try {
+        raw = parseYaml(text);
+    }
+    catch (e) {
+        throw new Error(`Invalid YAML in ${path}: ${e?.message ?? String(e)}`);
+    }
+    if (raw === null || raw === undefined) {
+        throw new Error(`Config file is empty: ${path}`);
+    }
+    if (typeof raw !== "object" || Array.isArray(raw)) {
+        throw new Error(`Invalid config: ${path} must contain a YAML mapping (key: value) at the top level`);
+    }
+    // Validate against the bundled schema. Only a *missing* schema file is skipped
+    // (a partial/broken install); a schema that loads MUST run, so genuine config
+    // errors always surface rather than being silently swallowed.
+    let schemaText = null;
+    try {
+        schemaText = readFileSync(SCHEMA_PATH, "utf8");
+    }
+    catch {
+        schemaText = null;
+    }
+    if (schemaText) {
+        const ajv = new Ajv2020({ allErrors: true, strict: false });
+        const validate = ajv.compile(JSON.parse(schemaText));
+        if (!validate(raw)) {
+            throw new Error(`Invalid config: ${ajv.errorsText(validate.errors)}`);
+        }
+    }
+    return raw;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,OAAO,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAE1C,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrD,gFAAgF;AAChF,6EAA6E;AAC7E,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,4BAA4B,CAAC,CAAC;AAEjF,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,IAAI,CAAC,EAAE,IAAI,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;QAC5E,MAAM,CAAC,CAAC;IACV,CAAC;IAED,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,KAAK,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,4DAA4D,CAAC,CAAC;IACvG,CAAC;IAED,+EAA+E;IAC/E,8EAA8E;IAC9E,8DAA8D;IAC9D,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,IAAI,CAAC;QACH,UAAU,GAAG,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,UAAU,GAAG,IAAI,CAAC;IACpB,CAAC;IACD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5D,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;QACrD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IACD,OAAO,GAA0B,CAAC;AACpC,CAAC"}

package/dist/core/annotation.d.ts

@@ -0,0 +1,22 @@
+/**
+ * LangGraph state annotation. The reducer-bearing channels here mirror the
+ * `Annotated[..., add]` Python TypedDict fields.
+ */
+import type { AgentRun, JudgeDecision, Mode, RouteDecision, Status } from "./state.js";
+export declare const CoterieStateAnnotation: import("@langchain/langgraph").AnnotationRoot<{
+    task: import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+    mode: import("@langchain/langgraph").BinaryOperatorAggregate<Mode, Mode>;
+    plan: import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+    current_step_idx: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+    runs: import("@langchain/langgraph").BinaryOperatorAggregate<AgentRun[], AgentRun[]>;
+    artifacts: import("@langchain/langgraph").BinaryOperatorAggregate<Record<string, string>, Record<string, string>>;
+    status: import("@langchain/langgraph").BinaryOperatorAggregate<Status, Status>;
+    config: import("@langchain/langgraph").BinaryOperatorAggregate<Record<string, any>, Record<string, any>>;
+    spend_usd: import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
+    route_history: import("@langchain/langgraph").BinaryOperatorAggregate<RouteDecision[], RouteDecision[]>;
+    judge_history: import("@langchain/langgraph").BinaryOperatorAggregate<JudgeDecision[], JudgeDecision[]>;
+    next_agent: import("@langchain/langgraph").BinaryOperatorAggregate<string | null, string | null>;
+    mode_state: import("@langchain/langgraph").BinaryOperatorAggregate<Record<string, any>, Record<string, any>>;
+}>;
+export type CoterieStateValues = typeof CoterieStateAnnotation.State;
+//# sourceMappingURL=annotation.d.ts.map

package/dist/core/annotation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation.d.ts","sourceRoot":"","sources":["../../src/core/annotation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EACV,QAAQ,EAER,aAAa,EACb,IAAI,EACJ,aAAa,EACb,MAAM,EACP,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;EAsCjC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,OAAO,sBAAsB,CAAC,KAAK,CAAC"}

package/dist/core/annotation.js

@@ -0,0 +1,45 @@
+/**
+ * LangGraph state annotation. The reducer-bearing channels here mirror the
+ * `Annotated[..., add]` Python TypedDict fields.
+ */
+import { Annotation } from "@langchain/langgraph";
+export const CoterieStateAnnotation = Annotation.Root({
+    task: Annotation({ default: () => "", reducer: (_a, b) => b }),
+    mode: Annotation({ default: () => "single", reducer: (_a, b) => b }),
+    plan: Annotation({ default: () => [], reducer: (_a, b) => b }),
+    current_step_idx: Annotation({ default: () => 0, reducer: (_a, b) => b }),
+    runs: Annotation({
+        default: () => [],
+        reducer: (a, b) => [...a, ...b],
+    }),
+    artifacts: Annotation({
+        default: () => ({}),
+        reducer: (_a, b) => b,
+    }),
+    status: Annotation({ default: () => "planning", reducer: (_a, b) => b }),
+    config: Annotation({
+        default: () => ({}),
+        reducer: (_a, b) => b,
+    }),
+    spend_usd: Annotation({
+        default: () => 0,
+        reducer: (a, b) => a + b,
+    }),
+    route_history: Annotation({
+        default: () => [],
+        reducer: (a, b) => [...a, ...b],
+    }),
+    judge_history: Annotation({
+        default: () => [],
+        reducer: (a, b) => [...a, ...b],
+    }),
+    next_agent: Annotation({
+        default: () => null,
+        reducer: (_a, b) => b,
+    }),
+    mode_state: Annotation({
+        default: () => ({}),
+        reducer: (_a, b) => b,
+    }),
+});
+//# sourceMappingURL=annotation.js.map

package/dist/core/annotation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation.js","sourceRoot":"","sources":["../../src/core/annotation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAWlD,MAAM,CAAC,MAAM,sBAAsB,GAAG,UAAU,CAAC,IAAI,CAAC;IACpD,IAAI,EAAE,UAAU,CAAS,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;IACtE,IAAI,EAAE,UAAU,CAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;IAC1E,IAAI,EAAE,UAAU,CAAW,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;IACxE,gBAAgB,EAAE,UAAU,CAAS,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;IACjF,IAAI,EAAE,UAAU,CAAa;QAC3B,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE;QACjB,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;KAChC,CAAC;IACF,SAAS,EAAE,UAAU,CAAyB;QAC5C,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;KACtB,CAAC;IACF,MAAM,EAAE,UAAU,CAAS,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;IAChF,MAAM,EAAE,UAAU,CAAsB;QACtC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;KACtB,CAAC;IACF,SAAS,EAAE,UAAU,CAAS;QAC5B,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;QAChB,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC;KACzB,CAAC;IACF,aAAa,EAAE,UAAU,CAAkB;QACzC,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE;QACjB,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;KAChC,CAAC;IACF,aAAa,EAAE,UAAU,CAAkB;QACzC,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE;QACjB,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;KAChC,CAAC;IACF,UAAU,EAAE,UAAU,CAAgB;QACpC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI;QACnB,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;KACtB,CAAC;IACF,UAAU,EAAE,UAAU,CAAsB;QAC1C,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;KACtB,CAAC;CACH,CAAC,CAAC"}

package/dist/core/compile.d.ts

@@ -0,0 +1,3 @@
+/** Shared graph compilation. */
+export declare function compileGraph(builder: any, _config: Record<string, any>): any;
+//# sourceMappingURL=compile.d.ts.map

package/dist/core/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/core/compile.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAMhC,wBAAgB,YAAY,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,CAE5E"}

package/dist/core/compile.js

@@ -0,0 +1,9 @@
+/** Shared graph compilation. */
+// NOTE: the prior checkpointer + interruptBefore path (audit #23) was removed —
+// it required a `configurable.thread_id` at stream/invoke time (never passed) and
+// there was no resume path, so the interrupt/`awaiting_human` flow was unusable.
+// Budget halts now surface as a terminal status instead (the finalizer is skipped).
+export function compileGraph(builder, _config) {
+    return builder.compile();
+}
+//# sourceMappingURL=compile.js.map

package/dist/core/compile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.js","sourceRoot":"","sources":["../../src/core/compile.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAEhC,gFAAgF;AAChF,kFAAkF;AAClF,iFAAiF;AACjF,oFAAoF;AACpF,MAAM,UAAU,YAAY,CAAC,OAAY,EAAE,OAA4B;IACrE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;AAC3B,CAAC"}

package/dist/core/executor.d.ts

@@ -0,0 +1,32 @@
+/**
+ * AdapterExecutor seam. Mirrors Python `core/executor.py`.
+ *
+ * Two concretes:
+ * - `LocalSubprocessExecutor` — delegates to `adapter.run()`. Default.
+ * - `IsolatedWorktreeExecutor` — each call runs in an ephemeral git worktree.
+ */
+import type { AdapterResult, CLIAdapter } from "../adapters/base.js";
+export interface ExecuteOpts {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    /** Called with a short progress note for each streamed event from the agent. */
+    onStream?: (text: string) => void;
+}
+/** Whether `workdir` is a git repo with ≥1 commit — the precondition for isolated
+ *  worktree deliberation. Lets callers warn upfront instead of failing mid-turn. */
+export declare function gitRepoReady(workdir: string): {
+    ok: boolean;
+    reason?: string;
+};
+export interface AdapterExecutor {
+    execute(adapter: CLIAdapter, prompt: string, workdir: string, opts?: ExecuteOpts): Promise<AdapterResult>;
+}
+export declare class LocalSubprocessExecutor implements AdapterExecutor {
+    execute(adapter: CLIAdapter, prompt: string, workdir: string, opts?: ExecuteOpts): Promise<AdapterResult>;
+}
+export declare class IsolatedWorktreeExecutor implements AdapterExecutor {
+    execute(adapter: CLIAdapter, prompt: string, workdir: string, opts?: ExecuteOpts): Promise<AdapterResult>;
+    private makeIsolated;
+    private cleanup;
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/core/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/core/executor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAErE,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED;oFACoF;AACpF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAM9E;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,CACL,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,aAAa,CAAC,CAAC;CAC3B;AAED,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CACL,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,aAAa,CAAC;CAG1B;AAED,qBAAa,wBAAyB,YAAW,eAAe;IACxD,OAAO,CACX,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,aAAa,CAAC;IASzB,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,OAAO;CAgBhB"}

package/dist/core/executor.js

@@ -0,0 +1,73 @@
+/**
+ * AdapterExecutor seam. Mirrors Python `core/executor.py`.
+ *
+ * Two concretes:
+ * - `LocalSubprocessExecutor` — delegates to `adapter.run()`. Default.
+ * - `IsolatedWorktreeExecutor` — each call runs in an ephemeral git worktree.
+ */
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+/** Whether `workdir` is a git repo with ≥1 commit — the precondition for isolated
+ *  worktree deliberation. Lets callers warn upfront instead of failing mid-turn. */
+export function gitRepoReady(workdir) {
+    const inside = spawnSync("git", ["rev-parse", "--is-inside-work-tree"], { cwd: workdir, encoding: "utf8" });
+    if (inside.status !== 0)
+        return { ok: false, reason: "not a git repository" };
+    const head = spawnSync("git", ["rev-parse", "HEAD"], { cwd: workdir, encoding: "utf8" });
+    if (head.status !== 0)
+        return { ok: false, reason: "the git repository has no commits yet" };
+    return { ok: true };
+}
+export class LocalSubprocessExecutor {
+    execute(adapter, prompt, workdir, opts = {}) {
+        return adapter.run(prompt, workdir, opts);
+    }
+}
+export class IsolatedWorktreeExecutor {
+    async execute(adapter, prompt, workdir, opts = {}) {
+        const isolated = this.makeIsolated(workdir);
+        try {
+            return await adapter.run(prompt, isolated, opts);
+        }
+        finally {
+            this.cleanup(isolated, workdir);
+        }
+    }
+    makeIsolated(base) {
+        const d = mkdtempSync(join(tmpdir(), "coterie-wt-"));
+        if (!existsSync(join(base, ".git"))) {
+            rmSync(d, { recursive: true, force: true });
+            throw new Error(`coterie runs deliberation in an isolated git worktree, but ${base} is not a git repository. ` +
+                "Run `git init && git add -A && git commit -m init` there first.");
+        }
+        const proc = spawnSync("git", ["worktree", "add", "--detach", d], { cwd: base, encoding: "utf8" });
+        if (proc.status !== 0) {
+            // Never silently run the agent against an empty temp dir with none of the
+            // user's code — fail loudly instead.
+            rmSync(d, { recursive: true, force: true });
+            throw new Error(`could not create an isolated worktree in ${base}: ${(proc.stderr || "").trim().slice(0, 200)} ` +
+                "(a git repo needs at least one commit).");
+        }
+        return d;
+    }
+    cleanup(isolated, base) {
+        const removed = spawnSync("git", ["worktree", "remove", "--force", isolated], {
+            cwd: base,
+            encoding: "utf8",
+        });
+        try {
+            rmSync(isolated, { recursive: true, force: true });
+        }
+        catch {
+            // best-effort
+        }
+        // If `git worktree remove` failed, the .git/worktrees entry would linger and
+        // accumulate over a session — prune the now-deleted dir's stale registration.
+        if (removed.status !== 0) {
+            spawnSync("git", ["worktree", "prune"], { cwd: base, encoding: "utf8" });
+        }
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/core/executor.js.map

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

package/dist/core/json.d.ts

@@ -0,0 +1,9 @@
+/** Parse JSON that an LLM may have wrapped in a ```json fence or padded with
+ *  prose ("Here's the result: [...]"). Coordination nodes call this instead of a
+ *  bare JSON.parse so a well-formed answer in a fence/prose wrapper isn't
+ *  misread as a parse failure. Returns undefined when no JSON value is found. */
+export declare function parseJsonLoose(raw: string): any;
+/** Parse NDJSON (one JSON value per line) — the streaming format the agent CLIs
+ *  emit. Blank or unparseable lines are skipped. */
+export declare function parseNdjson(text: string): any[];
+//# sourceMappingURL=json.d.ts.map

package/dist/core/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/core/json.ts"],"names":[],"mappings":"AAAA;;;iFAGiF;AACjF,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAsB/C;AAED;oDACoD;AACpD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,EAAE,CAY/C"}

package/dist/core/json.js

@@ -0,0 +1,49 @@
+/** Parse JSON that an LLM may have wrapped in a ```json fence or padded with
+ *  prose ("Here's the result: [...]"). Coordination nodes call this instead of a
+ *  bare JSON.parse so a well-formed answer in a fence/prose wrapper isn't
+ *  misread as a parse failure. Returns undefined when no JSON value is found. */
+export function parseJsonLoose(raw) {
+    if (!raw)
+        return undefined;
+    let s = raw.trim();
+    const fence = s.match(/^```[a-zA-Z]*\n([\s\S]*?)\n?```$/);
+    if (fence?.[1] !== undefined)
+        s = fence[1].trim();
+    try {
+        return JSON.parse(s);
+    }
+    catch {
+        // Fall back to extracting the first balanced-looking object/array span.
+    }
+    const start = s.search(/[[{]/);
+    if (start === -1)
+        return undefined;
+    const close = s[start] === "{" ? "}" : "]";
+    const end = s.lastIndexOf(close);
+    if (end <= start)
+        return undefined;
+    try {
+        return JSON.parse(s.slice(start, end + 1));
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Parse NDJSON (one JSON value per line) — the streaming format the agent CLIs
+ *  emit. Blank or unparseable lines are skipped. */
+export function parseNdjson(text) {
+    const out = [];
+    for (const line of text.split("\n")) {
+        const t = line.trim();
+        if (!t)
+            continue;
+        try {
+            out.push(JSON.parse(t));
+        }
+        catch {
+            // ignore non-JSON noise on a line
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=json.js.map

package/dist/core/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/core/json.ts"],"names":[],"mappings":"AAAA;;;iFAGiF;AACjF,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAEnB,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAC1D,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS;QAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAElD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,wEAAwE;IAC1E,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACnC,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC3C,MAAM,GAAG,GAAG,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,GAAG,IAAI,KAAK;QAAE,OAAO,SAAS,CAAC;IACnC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;oDACoD;AACpD,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,GAAG,GAAU,EAAE,CAAC;IACtB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,IAAI,CAAC;YACH,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;QACpC,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/core/llm/base.d.ts

@@ -0,0 +1,9 @@
+/** LLMClient contract. One method (`chat`). */
+export interface LLMMessage {
+    role: "user" | "assistant" | "system";
+    content: string;
+}
+export interface LLMClient {
+    chat(system: string, messages: LLMMessage[]): Promise<string>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/core/llm/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/core/llm/base.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAE/C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/D"}

package/dist/core/llm/base.js

@@ -0,0 +1,3 @@
+/** LLMClient contract. One method (`chat`). */
+export {};
+//# sourceMappingURL=base.js.map

package/dist/core/llm/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/core/llm/base.ts"],"names":[],"mappings":"AAAA,+CAA+C"}

package/dist/core/llm/build.d.ts

@@ -0,0 +1,16 @@
+/** Coordination LLM construction — subscription-only, with fallback.
+ *
+ * Coordination (judge / router / consensus engine / moderator) runs on a coding
+ * agent's CLI so it stays $0-metered (no pay-as-you-go API). Claude is preferred
+ * (it supports tool-disabling + reports cost), but coterie must work without
+ * Claude on the machine — so it falls back to codex, then cursor. There is
+ * intentionally no metered API backend.
+ */
+import type { LLMClient } from "./base.js";
+export type CoordinationCli = "claude" | "codex" | "cursor-agent";
+/** Choose the coordination CLI from the agents available this session, preferring
+ *  claude-code → codex → cursor. `agentIds` are config agent ids (claude-code,
+ *  codex, cursor). */
+export declare function coordinationCliFor(agentIds: string[]): CoordinationCli;
+export declare function buildLLM(model?: string, cli?: CoordinationCli): Promise<LLMClient>;
+//# sourceMappingURL=build.d.ts.map

package/dist/core/llm/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/core/llm/build.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAK3C,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,GAAG,cAAc,CAAC;AAElE;;sBAEsB;AACtB,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,eAAe,CAKtE;AAED,wBAAsB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,GAAE,eAA0B,GAAG,OAAO,CAAC,SAAS,CAAC,CASlG"}