coterie 0.1.0

package/dist/nodes/moderator.js

@@ -0,0 +1,83 @@
+import { parseJsonLoose } from "../core/json.js";
+const MODERATOR_SYSTEM = `You are an impartial debate moderator.
+Given the latest Pro and Con arguments, produce a concise round summary and identify
+the strongest unresolved disagreement. Return strict JSON only:
+{
+  "round_summary": "<2-3 sentences>",
+  "unresolved": "<the strongest open disagreement>",
+  "fact_check_needed": ["<claim>", ...]
+}`;
+const DEBATE_JUDGE_SYSTEM = `You are an impartial debate judge.
+You see N rounds of Pro and Con arguments on a single question. Pick the stronger
+position based on: evidence quality, logical coherence, addressing the opponent's strongest points,
+and practical applicability.
+
+Return strict JSON only:
+{
+  "winner": "pro" | "con" | "tie",
+  "reason": "<3-4 sentences>",
+  "scores": {"pro": <int 1-10>, "con": <int 1-10>}
+}`;
+export function makeModeratorNode(llm) {
+    return async (state) => {
+        const runs = state.runs ?? [];
+        const modeState = { ...(state.mode_state ?? {}) };
+        const proRun = [...runs].reverse().find((r) => r.role === "pro");
+        const conRun = [...runs].reverse().find((r) => r.role === "con");
+        if (!proRun || !conRun)
+            return { mode_state: modeState };
+        let summary;
+        if (!llm) {
+            summary = { round_summary: "no moderator LLM configured", unresolved: "", fact_check_needed: [] };
+        }
+        else {
+            const prompt = `Question: ${state.task}\n\nPro argument:\n${proRun.stdout.slice(0, 1500)}\n\n` +
+                `Con argument:\n${conRun.stdout.slice(0, 1500)}`;
+            const raw = await llm.chat(MODERATOR_SYSTEM, [{ role: "user", content: prompt }]);
+            summary = parseJsonLoose(raw) ?? { round_summary: raw.slice(0, 300), unresolved: "", fact_check_needed: [] };
+        }
+        modeState.rounds_completed = (modeState.rounds_completed ?? 0) + 1;
+        modeState.round_summaries = [...(modeState.round_summaries ?? []), summary];
+        return { mode_state: modeState };
+    };
+}
+export function makeDebateJudgeNode(llm) {
+    return async (state) => {
+        const cfg = state.config;
+        const sides = (cfg.debate?.sides ?? []);
+        const runs = state.runs ?? [];
+        const proRuns = runs.filter((r) => r.role === "pro");
+        const conRuns = runs.filter((r) => r.role === "con");
+        // Pair by the longer side so a dropped/failed round on either side isn't
+        // silently omitted from the judged transcript.
+        const rounds = Math.max(proRuns.length, conRuns.length);
+        const transcript = Array.from({ length: rounds }, (_, i) => {
+            const pro = proRuns[i];
+            const con = conRuns[i];
+            return `Round ${i + 1}\nPRO: ${pro ? pro.stdout.slice(0, 800) : "(missing)"}\nCON: ${con ? con.stdout.slice(0, 800) : "(missing)"}`;
+        }).join("\n\n");
+        let decision;
+        if (!llm) {
+            decision = { winner: "tie", reason: "no judge LLM configured", scores: {} };
+        }
+        else {
+            const raw = await llm.chat(DEBATE_JUDGE_SYSTEM, [
+                { role: "user", content: `Question: ${state.task}\n\n${transcript}` },
+            ]);
+            decision = parseJsonLoose(raw) ?? { winner: "tie", reason: `judge output unparseable: ${raw.slice(0, 120)}`, scores: {} };
+        }
+        const winnerLabel = decision.winner ?? "tie";
+        const winnerAgent = winnerLabel === "pro" ? sides[0] : winnerLabel === "con" ? sides[1] : "tie";
+        return {
+            mode_state: { ...(state.mode_state ?? {}), debate_verdict: decision },
+            judge_history: [{
+                    step: state.current_step_idx ?? 0,
+                    winner: winnerAgent,
+                    reason: decision.reason ?? "",
+                    scores: decision.scores ?? {},
+                }],
+            status: "done",
+        };
+    };
+}
+//# sourceMappingURL=moderator.js.map

package/dist/nodes/moderator.js.map

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

package/dist/nodes/planner.d.ts

@@ -0,0 +1,17 @@
+import type { LLMClient } from "../core/llm/base.js";
+import type { CoterieState } from "../core/state.js";
+export declare function makePlannerNode(): (state: CoterieState) => Promise<{
+    plan: string[];
+    current_step_idx: number;
+    status: "executing";
+    mode_state: Record<string, any>;
+}>;
+export declare function makeLLMPlannerNode(llm: LLMClient, opts?: {
+    maxSubtasks?: number;
+}): (state: CoterieState) => Promise<{
+    plan: string[];
+    current_step_idx: number;
+    status: "executing";
+    mode_state: Record<string, any>;
+}>;
+//# sourceMappingURL=planner.d.ts.map

package/dist/nodes/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/nodes/planner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,wBAAgB,eAAe,KACf,OAAO,YAAY;;;;;GAMlC;AASD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,IAEtE,OAAO,YAAY;;;;;GAoBlC"}

package/dist/nodes/planner.js

@@ -0,0 +1,40 @@
+export function makePlannerNode() {
+    return async (state) => ({
+        plan: [state.task],
+        current_step_idx: 0,
+        status: "executing",
+        mode_state: state.mode_state ?? {},
+    });
+}
+const PLANNER_SYSTEM = `You decompose a coding task into a sequence of focused subtasks.
+Keep subtasks atomic, in execution order, and roughly 1-2 sentences each.
+Aim for 1-5 subtasks total — return exactly one when the task is already atomic.
+
+Return strict JSON only — no prose, no markdown:
+{"subtasks": ["<subtask 1>", "<subtask 2>", ...]}`;
+export function makeLLMPlannerNode(llm, opts = {}) {
+    const maxSubtasks = opts.maxSubtasks ?? 5;
+    return async (state) => {
+        const raw = await llm.chat(PLANNER_SYSTEM, [{ role: "user", content: state.task }]);
+        let subtasks;
+        try {
+            const payload = JSON.parse(raw);
+            if (!Array.isArray(payload.subtasks) || !payload.subtasks.every((s) => typeof s === "string")) {
+                throw new Error("invalid subtasks");
+            }
+            subtasks = payload.subtasks.slice(0, maxSubtasks);
+            if (subtasks.length === 0)
+                subtasks = [state.task];
+        }
+        catch {
+            subtasks = [state.task];
+        }
+        return {
+            plan: subtasks,
+            current_step_idx: 0,
+            status: "executing",
+            mode_state: state.mode_state ?? {},
+        };
+    };
+}
+//# sourceMappingURL=planner.js.map

package/dist/nodes/planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.js","sourceRoot":"","sources":["../../src/nodes/planner.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,EAAE,KAAmB,EAAE,EAAE,CAAC,CAAC;QACrC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;QAClB,gBAAgB,EAAE,CAAC;QACnB,MAAM,EAAE,WAAoB;QAC5B,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,EAAE;KACnC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,cAAc,GAAG;;;;;kDAK2B,CAAC;AAEnD,MAAM,UAAU,kBAAkB,CAAC,GAAc,EAAE,OAAiC,EAAE;IACpF,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC;IAC1C,OAAO,KAAK,EAAE,KAAmB,EAAE,EAAE;QACnC,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACpF,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA2B,CAAC;YAC1D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC;gBAC9F,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;YACtC,CAAC;YACD,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;YAClD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,QAAQ,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QACD,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,gBAAgB,EAAE,CAAC;YACnB,MAAM,EAAE,WAAoB;YAC5B,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,EAAE;SACnC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/nodes/supervisor.d.ts

@@ -0,0 +1,28 @@
+import type { LLMClient } from "../core/llm/base.js";
+import type { CoterieState } from "../core/state.js";
+export declare function makeSupervisorNode(llm: LLMClient | null): (state: CoterieState) => Promise<{
+    status?: undefined;
+    next_agent?: undefined;
+    route_history?: undefined;
+} | {
+    status: "done";
+    next_agent: null;
+    route_history?: undefined;
+} | {
+    next_agent: any;
+    route_history: {
+        step: number;
+        agent_id: any;
+        reason: string;
+        strategy: string;
+    }[];
+    status: "executing";
+}>;
+export declare function makeStepAdvanceNode(): (state: CoterieState) => Promise<{
+    current_step_idx?: undefined;
+    status?: undefined;
+} | {
+    current_step_idx: number;
+    status: "routing";
+}>;
+//# sourceMappingURL=supervisor.d.ts.map

package/dist/nodes/supervisor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../../src/nodes/supervisor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAcrD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,IACxC,OAAO,YAAY;;;;;;;;;;;;;;;;;GAsDlC;AAED,wBAAgB,mBAAmB,KACnB,OAAO,YAAY;;;;;;GAIlC"}

package/dist/nodes/supervisor.js

@@ -0,0 +1,75 @@
+import { parseJsonLoose } from "../core/json.js";
+const SUPERVISOR_SYSTEM = `You route coding subtasks to specialist CLI agents.
+Pick the best agent for the given subtask based on each agent's stated strengths.
+Be decisive. Return strict JSON only — no prose, no markdown.
+
+Output schema: {"agent_id": "<one of the provided agent ids>", "reason": "<one sentence>"}`;
+function formatAgents(agents) {
+    return agents
+        .map((a) => `- ${a.id} (adapter=${a.adapter}, strengths=${JSON.stringify(a.strengths ?? [])})`)
+        .join("\n");
+}
+export function makeSupervisorNode(llm) {
+    return async (state) => {
+        if (state.status === "failed" || state.status === "awaiting_human")
+            return {};
+        const plan = state.plan ?? [];
+        const idx = state.current_step_idx ?? 0;
+        if (idx >= plan.length) {
+            return { status: "done", next_agent: null };
+        }
+        const cfg = state.config;
+        const agents = cfg.agents;
+        if (!agents?.length) {
+            throw new Error("supervisor: config has no agents to route to");
+        }
+        const subtask = plan[idx];
+        const routerCfg = cfg.router ?? {};
+        const strategy = routerCfg.strategy ?? "llm";
+        const enabled = routerCfg.enabled !== false;
+        // round-robin (and disabled) are deterministic. 'manual' has no interactive
+        // selection channel in a headless run, so it falls back to round-robin
+        // deterministically rather than throwing or silently hitting the LLM path.
+        if (!enabled || strategy === "round-robin" || strategy === "manual") {
+            const chosen = agents[idx % agents.length];
+            const why = !enabled ? "disabled" : strategy === "manual" ? "manual→round-robin" : "round-robin";
+            return {
+                next_agent: chosen.id,
+                route_history: [{ step: idx, agent_id: chosen.id, reason: why, strategy: why }],
+                status: "executing",
+            };
+        }
+        if (!llm)
+            throw new Error("supervisor with strategy='llm' requires an LLMClient");
+        const prompt = `Task: ${state.task}\nSubtask: ${subtask}\n\nAvailable agents:\n${formatAgents(agents)}`;
+        const raw = await llm.chat(SUPERVISOR_SYSTEM, [{ role: "user", content: prompt }]);
+        const decision = parseJsonLoose(raw);
+        let agentId;
+        let reason;
+        if (decision && typeof decision.agent_id === "string") {
+            agentId = decision.agent_id;
+            reason = decision.reason ?? "";
+        }
+        else {
+            agentId = agents[0].id;
+            reason = `router output unparseable: ${raw.slice(0, 120)}`;
+        }
+        if (!agents.find((a) => a.id === agentId)) {
+            agentId = agents[0].id;
+            reason = `router picked unknown agent; fell back to ${agentId}`;
+        }
+        return {
+            next_agent: agentId,
+            route_history: [{ step: idx, agent_id: agentId, reason, strategy: "llm" }],
+            status: "executing",
+        };
+    };
+}
+export function makeStepAdvanceNode() {
+    return async (state) => {
+        if (state.status === "failed" || state.status === "awaiting_human")
+            return {};
+        return { current_step_idx: (state.current_step_idx ?? 0) + 1, status: "routing" };
+    };
+}
+//# sourceMappingURL=supervisor.js.map

package/dist/nodes/supervisor.js.map

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

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "coterie",
+  "version": "0.1.0",
+  "description": "Conversational meta-agent for your terminal: every prompt runs through a multi-agent coordination round (debate, adversarial, tournament, consensus) over Claude Code + Codex, on your subscriptions.",
+  "license": "MIT",
+  "author": "Chris King <chris@cking.me>",
+  "homepage": "https://coterie.dev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cxk280/coterie.git",
+    "directory": "packages/coterie-js"
+  },
+  "bugs": "https://github.com/cxk280/coterie/issues",
+  "keywords": [
+    "langgraph",
+    "agents",
+    "llm",
+    "orchestration",
+    "claude",
+    "codex",
+    "cursor"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "coterie": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "schemas",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:e2e": "vitest run --config vitest.e2e.config.ts",
+    "lint": "eslint src",
+    "dev": "tsx src/cli.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@langchain/langgraph": "^0.2.0",
+    "ajv": "^8.17.1",
+    "commander": "^12.1.0",
+    "yaml": "^2.5.0",
+    "kleur": "^4.1.5"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "tsx": "^4.16.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  }
+}

package/schemas/coterie.config.schema.json

@@ -0,0 +1,204 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://coterie.dev/schemas/coterie.config.schema.json",
+  "title": "Coterie configuration",
+  "description": "Single source of truth for Coterie runtime configuration. The Python and JS runtimes both validate against this schema.",
+  "type": "object",
+  "required": ["mode", "agents"],
+  "additionalProperties": false,
+  "properties": {
+    "version": {"type": "integer", "const": 1},
+    "mode": {
+      "type": "string",
+      "enum": ["single", "consensus", "adversarial", "debate", "tournament"],
+      "description": "Coordination pattern. Each mode wires a different LangGraph topology. See docs/modes.md."
+    },
+    "agents": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["id", "adapter"],
+        "additionalProperties": false,
+        "properties": {
+          "id": {"type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$"},
+          "adapter": {
+            "type": "string",
+            "enum": ["claude-code", "codex", "cursor", "fake"]
+          },
+          "command": {"type": "array", "items": {"type": "string"}},
+          "model": {"type": "string"},
+          "strengths": {"type": "array", "items": {"type": "string"}},
+          "timeout_s": {"type": "integer", "minimum": 10, "default": 600}
+        }
+      }
+    },
+    "router": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Used in `single` mode to pick which agent handles each subtask.",
+      "properties": {
+        "enabled": {"type": "boolean", "default": true},
+        "model": {"type": "string", "default": "claude-haiku-4-5-20251001"},
+        "strategy": {
+          "type": "string",
+          "enum": ["llm", "round-robin", "manual"],
+          "default": "llm"
+        }
+      }
+    },
+    "planner": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "LLM-driven task decomposition. Off by default (trivial planner: plan = [task]). When enabled, decomposes the task into a sequence of subtasks. Only `single` mode iterates multi-step plans today; other modes use plan[0].",
+      "properties": {
+        "enabled": {"type": "boolean", "default": false},
+        "model": {"type": "string", "default": "claude-haiku-4-5-20251001"},
+        "max_subtasks": {"type": "integer", "minimum": 1, "default": 5}
+      }
+    },
+    "executor": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Adapter execution strategy. Default: `local` for sequential modes (single, adversarial, debate), `isolated` for parallel modes (consensus, tournament). Override here if needed.",
+      "properties": {
+        "kind": {
+          "type": "string",
+          "enum": ["local", "isolated"],
+          "description": "`local`: shared workdir across all calls. `isolated`: each call gets an ephemeral git worktree (or tempdir fallback)."
+        }
+      }
+    },
+    "single": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Single-routed mode: router picks one agent per subtask."
+    },
+    "consensus": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "participants": {
+          "type": "array",
+          "items": {"type": "string"},
+          "minItems": 2
+        },
+        "threshold": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "default": 0.5,
+          "description": "Agreement ratio at which a clustered finding is 'confirmed'."
+        },
+        "max_rounds": {"type": "integer", "minimum": 1, "default": 1},
+        "engine": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "model": {"type": "string", "default": "claude-opus-4-7"},
+            "confirm_threshold": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1,
+              "default": 0.5
+            }
+          }
+        }
+      }
+    },
+    "adversarial": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["implementer", "auditor"],
+      "properties": {
+        "implementer": {"type": "string"},
+        "auditor": {"type": "string"},
+        "judge": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "model": {"type": "string", "default": "claude-opus-4-7"},
+            "sustain_threshold": {
+              "type": "string",
+              "enum": ["low", "medium", "high"],
+              "default": "medium"
+            }
+          }
+        },
+        "max_rounds": {"type": "integer", "minimum": 1, "default": 3}
+      }
+    },
+    "debate": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sides"],
+      "properties": {
+        "sides": {
+          "type": "array",
+          "minItems": 2,
+          "maxItems": 2,
+          "items": {"type": "string"}
+        },
+        "rounds": {"type": "integer", "minimum": 1, "default": 3},
+        "moderator": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "model": {"type": "string", "default": "claude-haiku-4-5-20251001"}
+          }
+        },
+        "judge": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "model": {"type": "string", "default": "claude-opus-4-7"}
+          }
+        }
+      }
+    },
+    "tournament": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["participants"],
+      "properties": {
+        "participants": {
+          "type": "array",
+          "minItems": 2,
+          "items": {"type": "string"}
+        },
+        "rounds": {
+          "type": "integer",
+          "minimum": 1,
+          "default": 1,
+          "description": "Number of elimination rounds. 1 = single N-way ranking (default). N>1 = bracket: each round halves the field via the judge until one survivor or N rounds completed."
+        },
+        "judge": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "model": {"type": "string", "default": "claude-opus-4-7"},
+            "criteria": {
+              "type": "array",
+              "items": {"type": "string"},
+              "default": ["correctness", "minimal-diff", "tests-pass", "clarity"]
+            }
+          }
+        }
+      }
+    },
+    "budget": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "max_usd_per_task": {"type": "number", "minimum": 0},
+        "warn_at_usd": {"type": "number", "minimum": 0},
+        "on_exceed": {
+          "type": "string",
+          "enum": ["halt", "warn", "checkpoint"],
+          "default": "checkpoint"
+        }
+      }
+    },
+    "workdir": {"type": "string", "default": "."}
+  }
+}