coterie 0.1.0

package/dist/chat/render.js

@@ -0,0 +1,113 @@
+/** Human-readable rendering of a coordination round. Agents emit JSON (findings,
+ *  verdicts) and prose; this module turns that into something a person reads.
+ *  Nothing here ever surfaces raw JSON to the user. */
+/** If `stdout` is a JSON findings array (possibly fenced), return it (maybe
+ *  empty); otherwise null. Distinguishes "structured findings" from prose, which
+ *  `parseFindings` in the auditor can't (it returns `[]` for both). */
+function asFindingsArray(stdout) {
+    let s = stdout.trim();
+    if (s.startsWith("```")) {
+        const lines = s.split("\n");
+        const last = lines[lines.length - 1];
+        s = (last && last.startsWith("```") ? lines.slice(1, -1) : lines.slice(1)).join("\n").trim();
+    }
+    if (!s.startsWith("["))
+        return null;
+    try {
+        const data = JSON.parse(s);
+        return Array.isArray(data) ? data : null;
+    }
+    catch {
+        return null;
+    }
+}
+function capLines(text, maxChars) {
+    const t = text.trim();
+    if (t.length <= maxChars)
+        return t;
+    return t.slice(0, maxChars).trimEnd() + " …";
+}
+/** Did this agent run fail? A non-zero exit always counts. An exit-0 run with no
+ *  stdout but error-looking stderr (auth/rate-limit/crash the CLI reported but
+ *  didn't exit on) counts too — but a benign warning on stderr with no stdout
+ *  (e.g. a deprecation notice from an agent that only edited files) does not. */
+const STDERR_ERROR_RE = /error|fail|denied|unauthor|not logged in|rate.?limit|expired|invalid|quota|ENOENT|timed? ?out/i;
+export function runFailed(run) {
+    if (run.exit_code !== 0)
+        return true;
+    if (!run.stdout.trim() && run.stderr.trim())
+        return STDERR_ERROR_RE.test(run.stderr);
+    return false;
+}
+/** A one-line, human-readable description of a failed run. */
+export function renderFailure(run) {
+    const exit = run.exit_code !== 0 ? ` (exit ${run.exit_code})` : "";
+    const detail = (run.stderr || run.stdout || "").trim().split("\n")[0] ?? "";
+    return `failed${exit}${detail ? `: ${detail.slice(0, 200)}` : ""}`;
+}
+const RATE_LIMIT_RE = /rate.?limit|quota|usage limit|too many requests|\b429\b|resets? (?:at|in)|try again (?:later|in)|exhausted/i;
+const AUTH_RE = /not logged in|unauthor|authentication|please (?:sign|log) ?in|login required|subscription|expired|invalid (?:api )?key|\b401\b|\b403\b/i;
+/** Classify *why* a run failed so the session can adapt: drop a rate-limited or
+ *  signed-out agent when others remain, or bubble up when/whether it'll recover. */
+export function classifyFailure(run) {
+    if (!runFailed(run))
+        return { kind: null, detail: "" };
+    const text = `${run.stderr}\n${run.stdout}`.trim();
+    const firstLine = text.split("\n").find((l) => l.trim())?.trim().slice(0, 200) ?? "";
+    // Surface a recovery hint if the CLI gave one.
+    const when = text.match(/(?:resets?|try again|retry)[^.\n]*?(?:at|in)\s+[^.\n]{1,40}/i)?.[0];
+    const detail = when ? `${firstLine}${firstLine.includes(when) ? "" : ` — ${when}`}` : firstLine;
+    if (RATE_LIMIT_RE.test(text))
+        return { kind: "rate-limit", detail };
+    if (AUTH_RE.test(text))
+        return { kind: "auth", detail };
+    return { kind: null, detail };
+}
+/** Render one agent's contribution as readable lines (no raw JSON). */
+export function renderContribution(run, maxChars = 1200) {
+    const findings = asFindingsArray(run.stdout);
+    if (findings !== null) {
+        if (findings.length === 0)
+            return "no defects reported";
+        return findings
+            .filter((f) => f && typeof f === "object" && typeof f.description === "string")
+            .map((f) => `• [${f.severity ?? "?"}] ${f.category ?? "finding"}: ${f.description}`)
+            .join("\n");
+    }
+    const text = (run.stdout ?? "").trim();
+    return text ? capLines(text, maxChars) : "(no output)";
+}
+/** A compact, readable digest of the deliberation, handed to the finalizer agent
+ *  as advice. Built generically from runs + verdicts + mode-specific summaries. */
+export function digestRound(final) {
+    const runs = final.runs ?? [];
+    const parts = [];
+    for (const run of runs) {
+        parts.push(`### ${run.role} — ${run.agent_id}\n${renderContribution(run, 1500)}`);
+    }
+    const verdicts = (final.judge_history ?? [])
+        .map((j) => `- ${j.winner}${j.reason ? `: ${j.reason}` : ""}`)
+        .filter(Boolean);
+    if (verdicts.length)
+        parts.push(`### verdicts\n${verdicts.join("\n")}`);
+    const consensus = (final.mode_state?.consensus_findings ?? []);
+    if (consensus.length) {
+        const lines = consensus.map((c) => {
+            // Denominator is the participant total, not the supporter count (which
+            // would always read "N/N"). Fall back to deriving it from the ratio.
+            const total = c.participant_count ??
+                (c.agreement_ratio ? Math.round(c.agreement_count / c.agreement_ratio) : c.agreement_count);
+            return `- [${c.label}] [${c.severity}] ${c.description} (${c.agreement_count}/${total} agree)`;
+        });
+        parts.push(`### consensus findings\n${lines.join("\n")}`);
+    }
+    // Cap the assembled digest so a many-run round can't hand the finalizer an
+    // unbounded prompt (compounds the argv limit). Per-contribution caps above
+    // bound each piece; this bounds the whole.
+    const digest = parts.join("\n\n") || "(the deliberation produced no output)";
+    const MAX_DIGEST = 12_000;
+    return digest.length > MAX_DIGEST
+        ? digest.slice(0, MAX_DIGEST) + "\n\n…(deliberation digest truncated)…"
+        : digest;
+}
+//# sourceMappingURL=render.js.map

package/dist/chat/render.js.map

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

package/dist/chat/repl.d.ts

@@ -0,0 +1,9 @@
+/** The `coterie chat` REPL: a conversational loop where each turn runs through
+ *  the active coordination mode and returns the synthesized result. */
+import type { Mode } from "../core/state.js";
+export declare function runChat(opts: {
+    mode: Mode;
+    workdir: string;
+    quiet: boolean;
+}): Promise<void>;
+//# sourceMappingURL=repl.d.ts.map

package/dist/chat/repl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../../src/chat/repl.ts"],"names":[],"mappings":"AAAA;uEACuE;AAUvE,OAAO,KAAK,EAAY,IAAI,EAAE,MAAM,kBAAkB,CAAC;AA4CvD,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA4JlG"}

package/dist/chat/repl.js

@@ -0,0 +1,275 @@
+/** The `coterie chat` REPL: a conversational loop where each turn runs through
+ *  the active coordination mode and returns the synthesized result. */
+import { setMaxListeners } from "node:events";
+import { createInterface } from "node:readline";
+import kleur from "kleur";
+import { gitRepoReady, IsolatedWorktreeExecutor } from "../core/executor.js";
+import { buildLLM, coordinationCliFor } from "../core/llm/build.js";
+import { validateRuntimeConfig } from "../core/validate.js";
+import { buildGraph } from "../graph.js";
+import { defaultConfig } from "./configs.js";
+import { formatDoctor, MIN_AGENTS, runDoctor } from "./doctor.js";
+import { runFinalizer } from "./finalizer.js";
+import { agentStatuses } from "./preflight.js";
+import { classifyFailure, digestRound } from "./render.js";
+import { rule, Trace } from "./trace.js";
+import { Transcript } from "./transcript.js";
+const MODES = ["single", "adversarial", "debate", "tournament", "consensus"];
+/** Bare words (no leading slash) that mean "leave the REPL". Without this they'd
+ *  be sent to the agents as a task — wasting a real (subscription) round and the
+ *  user's time on the most reflexive action there is. */
+const QUIT_WORDS = new Set(["exit", "quit", "q", ":q"]);
+async function buildLlms(mode, cfg, cli) {
+    return {
+        supervisor_llm: mode === "single" ? await buildLLM(cfg.router?.model, cli) : null,
+        judge_llm: ["adversarial", "tournament", "debate"].includes(mode) ? await buildLLM(cfg[mode]?.judge?.model, cli) : null,
+        consensus_llm: mode === "consensus" ? await buildLLM(cfg.consensus?.engine?.model, cli) : null,
+        moderator_llm: mode === "debate" ? await buildLLM(cfg.debate?.moderator?.model, cli) : null,
+        planner_llm: cfg.planner?.enabled ? await buildLLM(cfg.planner?.model, cli) : null,
+    };
+}
+const HELP = `
+Commands:
+  /mode <name>   switch coordination mode (${MODES.join(", ")})
+  /show /hide    show or hide the live agent exchanges
+  /clear         forget the conversation so far
+  /help          this help
+  /exit          quit (or just type 'exit' / 'quit')
+  Ctrl+C         cancel the current turn (press again at the prompt to quit)
+
+Each turn the agents deliberate (review/critique/compete, in throwaway
+workspaces), then one final agent applies the edits in your workdir and writes
+the reply — so file edits land in every mode. The mode shapes the deliberation:
+'single' is quickest; 'adversarial' adds an auditor/judge loop; 'debate' /
+'tournament' / 'consensus' get more perspectives before the finalizer acts.
+`.trim();
+export async function runChat(opts) {
+    let mode = opts.mode;
+    // Build the session lineup from whichever agents are actually available; need
+    // at least two to coordinate. Roles within each mode are auto-assigned from it.
+    // Probe every known agent once, then derive both the ready lineup and the
+    // installed-but-signed-out ones (so we can tell the user why they're missing).
+    const statuses = agentStatuses();
+    const agents = statuses.filter((s) => s.status.ok).map((s) => s.agent);
+    const signedOut = statuses.filter((s) => s.status.reason === "not signed in");
+    if (agents.length < MIN_AGENTS) {
+        console.error(kleur.yellow(formatDoctor(runDoctor())));
+        process.exitCode = 1;
+        return;
+    }
+    // Deliberation runs in an isolated git worktree of the workdir, so it must be a
+    // git repo with a commit — otherwise every turn would error mid-flight.
+    const git = gitRepoReady(opts.workdir);
+    if (!git.ok) {
+        console.error(kleur.yellow(`Can't start: ${opts.workdir} is ${git.reason}. coterie runs each turn's deliberation in an ` +
+            "isolated git worktree, so the working directory must be a git repo with at least one commit.\n" +
+            "  Fix: cd into your project and run `git init && git add -A && git commit -m init`."));
+        process.exitCode = 1;
+        return;
+    }
+    const transcript = new Transcript();
+    const trace = new Trace(!opts.quiet);
+    trace.attach();
+    console.log(kleur.cyan().bold("▲ coterie chat"));
+    console.log(kleur.dim(`  mode=${mode} · workdir=${opts.workdir} · agents: ${agents.map((a) => a.id).join(", ")} · $0 metered\n` +
+        `  modes: ${MODES.join(", ")}\n` +
+        "  Each turn: agents deliberate, then one finalizer applies edits + replies. /mode to change modes. /help for commands."));
+    // An agent that's installed but signed out isn't broken — it just can't join.
+    // Say so clearly (and how to fix it) instead of silently dropping it.
+    for (const s of signedOut) {
+        console.log(kleur.yellow(`  ⚠ ${s.status.cli} is installed but not signed in — sitting this session out. ${s.status.fix ?? ""}`.trimEnd()));
+    }
+    // Coordination (routing / judging / merging) prefers Claude but falls back to
+    // codex/cursor, so it works without Claude. Note the coordinator if it's not
+    // Claude, so the choice is visible.
+    const coordCli = coordinationCliFor(agents.map((a) => a.id));
+    if (coordCli !== "claude") {
+        console.log(kleur.dim(`  coordination: ${coordCli} (Claude not detected — using an available agent)`));
+    }
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const setPrompt = () => rl.setPrompt(kleur.cyan(`\ncoterie(${mode})› `));
+    // Ctrl+C cancels the in-flight turn (aborting the agent subprocesses) and keeps
+    // the session alive; at the prompt with nothing running it quits.
+    let activeAbort = null;
+    // Agents that hit a hard limit / auth failure this session, with the reason.
+    // We drop them from later turns when ≥2 agents remain; otherwise we keep them
+    // and bubble up the limit info (you can't coordinate with fewer than two).
+    const sidelined = new Map();
+    rl.on("SIGINT", () => {
+        if (activeAbort && !activeAbort.signal.aborted) {
+            activeAbort.abort();
+            console.log(kleur.yellow("\n  ↩ canceling this turn… (Ctrl+C again at the prompt to quit)"));
+        }
+        else {
+            rl.close();
+        }
+    });
+    setPrompt();
+    rl.prompt();
+    for await (const line of rl) {
+        const text = line.trim();
+        try {
+            if (!text) {
+                // no-op
+            }
+            else if (QUIT_WORDS.has(text.toLowerCase())) {
+                break;
+            }
+            else if (text.startsWith("/")) {
+                const [rawCmd, ...rest] = text.slice(1).split(/\s+/);
+                const cmd = (rawCmd ?? "").toLowerCase();
+                if (cmd === "exit" || cmd === "quit" || cmd === "q")
+                    break;
+                else if (cmd === "help")
+                    console.log(HELP);
+                else if (cmd === "hide") {
+                    trace.visible = false;
+                    console.log(kleur.dim("  (trace hidden)"));
+                }
+                else if (cmd === "show") {
+                    trace.visible = true;
+                    console.log(kleur.dim("  (trace shown)"));
+                }
+                else if (cmd === "clear") {
+                    transcript.clear();
+                    console.log(kleur.dim("  (conversation cleared)"));
+                }
+                else if (cmd === "mode") {
+                    const next = (rest[0] ?? "").toLowerCase();
+                    if (MODES.includes(next)) {
+                        mode = next;
+                        setPrompt();
+                        console.log(kleur.dim(`  (mode → ${mode})`));
+                    }
+                    else
+                        console.log(kleur.red(`  unknown mode '${rest[0] ?? ""}'; pick one of ${MODES.join(", ")}`));
+                }
+                else
+                    console.log(kleur.red(`  unknown command '/${rawCmd ?? ""}' — /help`));
+            }
+            else {
+                // Build this turn's lineup: drop sidelined agents, but never below the
+                // two needed to coordinate.
+                let lineup = agents.filter((a) => !sidelined.has(a.id));
+                if (lineup.length < MIN_AGENTS) {
+                    for (const a of agents) {
+                        if (sidelined.has(a.id)) {
+                            console.log(kleur.yellow(`  ⚠ ${a.id} is unavailable (${sidelined.get(a.id)}) but kept — dropping it would leave fewer than ${MIN_AGENTS} agents.`));
+                        }
+                    }
+                    lineup = agents;
+                }
+                else if (lineup.length < agents.length) {
+                    for (const a of agents) {
+                        if (sidelined.has(a.id))
+                            console.log(kleur.dim(`  (sitting out ${a.id} this session — ${sidelined.get(a.id)})`));
+                    }
+                }
+                activeAbort = new AbortController();
+                // LangGraph attaches an abort listener per step; lift the ceiling so a
+                // multi-round turn doesn't trip Node's MaxListenersExceededWarning.
+                setMaxListeners(128, activeAbort.signal);
+                try {
+                    const runs = await runTurn(text, mode, opts.workdir, lineup, transcript, trace, activeAbort.signal);
+                    // Learn from failures: sideline agents that hit a limit / auth problem.
+                    for (const r of runs ?? []) {
+                        const c = classifyFailure(r);
+                        if (c.kind && !sidelined.has(r.agent_id)) {
+                            sidelined.set(r.agent_id, c.detail || c.kind);
+                            console.log(kleur.yellow(`  ▸ ${r.agent_id} hit a ${c.kind} issue — sitting it out for the rest of this session. ${c.detail}`.trimEnd()));
+                        }
+                    }
+                }
+                finally {
+                    activeAbort = null;
+                }
+            }
+        }
+        catch (e) {
+            console.error(kleur.red(`  error: ${e instanceof Error ? e.message : String(e)}`));
+        }
+        rl.prompt();
+    }
+    trace.detach();
+    rl.close();
+    console.log(kleur.dim("\nbye."));
+}
+async function runTurn(text, mode, workdir, agents, transcript, trace, signal) {
+    const cfg = defaultConfig(mode, agents);
+    validateRuntimeConfig(cfg);
+    // Coordination runs on an available agent's CLI — prefer Claude, else fall back
+    // to codex/cursor so a turn works without Claude on the machine.
+    const coordCli = coordinationCliFor(agents.map((a) => a.id));
+    const llms = await buildLlms(mode, cfg, coordCli);
+    // Deliberation never touches the real workdir — it runs in throwaway worktrees
+    // and feeds the finalizer as advice. The finalizer is the sole mutator.
+    const graph = buildGraph({ workdir, executor: new IsolatedWorktreeExecutor(), config: cfg, ...llms });
+    const task = transcript.taskFor(text);
+    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: {},
+    };
+    trace.reset();
+    if (trace.visible)
+        console.log("\n" + rule(`deliberating · ${mode}`));
+    let final = initial;
+    try {
+        // recursionLimit is a hard backstop against an unbounded loop (on top of each
+        // mode's own round cap); the modes settle in far fewer supersteps.
+        for await (const state of await graph.stream(initial, { streamMode: "values", signal, recursionLimit: 24 })) {
+            final = state;
+            trace.update(state);
+        }
+        // Don't apply edits off a deliberation that halted (budget) or is waiting on
+        // a human — the finalizer is the sole mutator, so skipping it leaves the
+        // workdir untouched.
+        if (final.status === "failed" || final.status === "awaiting_human") {
+            console.log(kleur.yellow(`\n  ⚠ deliberation ended as '${final.status}' — not applying any edits this turn.`));
+            transcript.add("user", text);
+            transcript.add("assistant", `(no changes — deliberation ended as ${final.status})`);
+            return final.runs ?? [];
+        }
+        if (trace.visible)
+            console.log("\n" + rule("finalizing"));
+        // The finalizer (the judge seat) is the first available agent. Only pass a
+        // model when it's Claude Code — the judge-model aliases are Claude-specific.
+        const finalizerAdapter = agents[0].adapter;
+        const finalizerModel = finalizerAdapter === "claude-code" ? "claude-opus-4-7" : undefined;
+        const { answer, run } = await runFinalizer({
+            task,
+            digest: digestRound(final),
+            workdir,
+            adapter: finalizerAdapter,
+            model: finalizerModel,
+            signal,
+        });
+        const reply = answer || "(the finalizer produced no reply — check the workdir for edits)";
+        console.log("\n" + kleur.cyan().bold("coterie ›") + " " + reply);
+        const totalSpend = (final.spend_usd ?? 0) + (run.cost_estimate_usd ?? 0);
+        if (totalSpend)
+            console.log(kleur.dim(`  (≈ $${totalSpend.toFixed(4)} subscription usage — $0 metered)`));
+        transcript.add("user", text);
+        transcript.add("assistant", reply);
+        return [...(final.runs ?? []), run];
+    }
+    catch (e) {
+        if (signal.aborted || (e instanceof Error && e.name === "AbortError")) {
+            console.log(kleur.yellow("\n  ↩ canceled — back to the prompt.") +
+                kleur.dim(" (Deliberation runs in a scratch copy, so your files are untouched.)"));
+            return null;
+        }
+        throw e;
+    }
+}
+//# sourceMappingURL=repl.js.map

package/dist/chat/repl.js.map

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

package/dist/chat/trace.d.ts

@@ -0,0 +1,29 @@
+/** Live, elegant trace of a coordination round. Per-agent activity is driven by
+ *  the process-wide progress bus (`core/progress`): each agent emits `start` when
+ *  it begins and `done` when it finishes, so the back-and-forth streams live even
+ *  when a mode fans agents out concurrently (e.g. consensus). Judge verdicts come
+ *  from the graph's streamed state snapshots. Everything is shown by default;
+ *  `visible=false` (via `--quiet` / `/hide`) silences the commentary — but agent
+ *  *failures* surface regardless, since a silent failure is worse than a noisy one. */
+import type { JudgeDecision } from "../core/state.js";
+/** A thin section rule, e.g. `── deliberating · consensus ──────────`. */
+export declare function rule(label: string): string;
+export declare class Trace {
+    visible: boolean;
+    private seenJudge;
+    private onStart?;
+    private onDone?;
+    private onStep?;
+    constructor(visible: boolean);
+    /** Subscribe to the progress bus for the lifetime of the session. The handlers
+     *  read `this.visible` at emit time, so `/show` / `/hide` take effect live. */
+    attach(): void;
+    detach(): void;
+    reset(): void;
+    private renderRun;
+    /** Surface new judge verdicts from a streamed state snapshot. */
+    update(state: {
+        judge_history?: JudgeDecision[];
+    }): void;
+}
+//# sourceMappingURL=trace.d.ts.map

package/dist/chat/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/chat/trace.ts"],"names":[],"mappings":"AAAA;;;;;;uFAMuF;AAKvF,OAAO,KAAK,EAAY,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAwDhE,0EAA0E;AAC1E,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI1C;AAED,qBAAa,KAAK;IAMG,OAAO,EAAE,OAAO;IALnC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,OAAO,CAAC,CAAgC;IAChD,OAAO,CAAC,MAAM,CAAC,CAA+B;IAC9C,OAAO,CAAC,MAAM,CAAC,CAA+B;gBAE3B,OAAO,EAAE,OAAO;IAEnC;mFAC+E;IAC/E,MAAM,IAAI,IAAI;IAiBd,MAAM,IAAI,IAAI;IAMd,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,SAAS;IAgBjB,iEAAiE;IACjE,MAAM,CAAC,KAAK,EAAE;QAAE,aAAa,CAAC,EAAE,aAAa,EAAE,CAAA;KAAE,GAAG,IAAI;CAUzD"}

package/dist/chat/trace.js

@@ -0,0 +1,132 @@
+/** Live, elegant trace of a coordination round. Per-agent activity is driven by
+ *  the process-wide progress bus (`core/progress`): each agent emits `start` when
+ *  it begins and `done` when it finishes, so the back-and-forth streams live even
+ *  when a mode fans agents out concurrently (e.g. consensus). Judge verdicts come
+ *  from the graph's streamed state snapshots. Everything is shown by default;
+ *  `visible=false` (via `--quiet` / `/hide`) silences the commentary — but agent
+ *  *failures* surface regardless, since a silent failure is worse than a noisy one. */
+import kleur from "kleur";
+import { progress } from "../core/progress.js";
+import { renderContribution, renderFailure, runFailed } from "./render.js";
+// A bright, distinct color per agent so each one is easy to follow in a round.
+// Assigned in first-seen order and stable for the session.
+const AGENT_PALETTE = [kleur.cyan, kleur.green, kleur.yellow, kleur.magenta, kleur.blue, kleur.red];
+const agentColors = new Map();
+function agentColor(agentId) {
+    let c = agentColors.get(agentId);
+    if (!c) {
+        c = AGENT_PALETTE[agentColors.size % AGENT_PALETTE.length];
+        agentColors.set(agentId, c);
+    }
+    return c;
+}
+const ROLE_LABELS = {
+    "consensus-participant": "participant",
+    "tournament-participant": "contender",
+};
+/** Glyph + color + label for a line. Coordination roles (judge/moderator) and the
+ *  finalizer get fixed colors; every actual agent gets its own palette color so
+ *  the three agents in a round are visually distinct. */
+function roleStyle(role, agentId) {
+    if (role === "finalizer")
+        return { glyph: "✦", color: kleur.green, label: "finalizer" };
+    if (role === "judge" || role === "moderator")
+        return { glyph: "⚖", color: kleur.magenta, label: role };
+    return { glyph: "◆", color: agentColor(agentId), label: ROLE_LABELS[role] ?? role };
+}
+function meta(run) {
+    const bits = [];
+    if (run.duration_s)
+        bits.push(`${run.duration_s.toFixed(1)}s`);
+    if (run.cost_estimate_usd != null)
+        bits.push(`$${run.cost_estimate_usd.toFixed(4)}`);
+    return bits.length ? kleur.dim(`  ${bits.join(" · ")}`) : "";
+}
+/** Prefix each content line with a colored gutter bar so a block reads as one
+ *  unit, attributed to its agent. Content stays the terminal's default color
+ *  (bright/legible) rather than dimmed. */
+function block(text, gutter) {
+    const bar = gutter("│");
+    return text
+        .split("\n")
+        .map((l) => `    ${bar} ${l}`)
+        .join("\n");
+}
+/** A thin section rule, e.g. `── deliberating · consensus ──────────`. */
+export function rule(label) {
+    const head = kleur.dim("── ") + kleur.bold().cyan(label) + kleur.dim(" ");
+    const visibleLen = 3 + label.length + 1;
+    return head + kleur.dim("─".repeat(Math.max(0, 56 - visibleLen)));
+}
+export class Trace {
+    visible;
+    seenJudge = 0;
+    onStart;
+    onDone;
+    onStep;
+    constructor(visible) {
+        this.visible = visible;
+    }
+    /** Subscribe to the progress bus for the lifetime of the session. The handlers
+     *  read `this.visible` at emit time, so `/show` / `/hide` take effect live. */
+    attach() {
+        this.onStart = (ev) => {
+            if (!this.visible)
+                return;
+            const { glyph, color, label } = roleStyle(ev.role, ev.agent_id);
+            console.log(`  ${color(glyph)} ${kleur.bold(color(label))} ${kleur.dim(`· ${ev.agent_id}`)} ${kleur.dim().italic("· working…")}`);
+        };
+        // Live activity from inside a run (tool calls, commands, edits), in the agent's
+        // own color so concurrent agents (consensus/tournament) stay legible.
+        this.onStep = (ev) => {
+            if (this.visible)
+                console.log(`      ${kleur.dim(ev.agent_id)} ${agentColor(ev.agent_id)(ev.text)}`);
+        };
+        this.onDone = ({ run }) => this.renderRun(run);
+        progress.on("start", this.onStart);
+        progress.on("step", this.onStep);
+        progress.on("done", this.onDone);
+    }
+    detach() {
+        if (this.onStart)
+            progress.off("start", this.onStart);
+        if (this.onStep)
+            progress.off("step", this.onStep);
+        if (this.onDone)
+            progress.off("done", this.onDone);
+    }
+    reset() {
+        this.seenJudge = 0;
+    }
+    renderRun(run) {
+        const { glyph, color, label } = roleStyle(run.role, run.agent_id);
+        if (runFailed(run)) {
+            console.warn(`  ${kleur.yellow("✗")} ${kleur.bold().yellow(label)} ${kleur.dim(`· ${run.agent_id}`)} ${kleur.yellow(renderFailure(run))}`);
+            return;
+        }
+        if (!this.visible)
+            return;
+        if (run.role === "finalizer") {
+            const changed = run.files_changed?.length ? kleur.dim(` — edited ${run.files_changed.join(", ")}`) : "";
+            console.log(`  ${color(glyph)} ${kleur.bold(color("finalizer"))} ${kleur.dim(`· ${run.agent_id}`)}${meta(run)}${changed}`);
+            return;
+        }
+        console.log(`  ${color(glyph)} ${kleur.bold(color(label))} ${kleur.dim(`· ${run.agent_id}`)}${meta(run)}`);
+        console.log(block(renderContribution(run, 800), color));
+    }
+    /** Surface new judge verdicts from a streamed state snapshot. */
+    update(state) {
+        if (!this.visible)
+            return;
+        const judges = state.judge_history ?? [];
+        while (this.seenJudge < judges.length) {
+            const j = judges[this.seenJudge++];
+            if (!j)
+                continue;
+            console.log(`  ${kleur.magenta("⚖")} ${kleur.magenta().bold("judge")} ${kleur.dim("→")} ${kleur.bold().magenta(j.winner)}`);
+            if (j.reason)
+                console.log(block(j.reason, kleur.magenta));
+        }
+    }
+}
+//# sourceMappingURL=trace.js.map

package/dist/chat/trace.js.map

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

package/dist/chat/transcript.d.ts

@@ -0,0 +1,15 @@
+/** Conversation memory. Agents are stateless subprocess calls, so prior turns
+ *  are threaded into each new turn's task as context. */
+export interface Turn {
+    role: "user" | "assistant";
+    content: string;
+}
+export declare class Transcript {
+    private turns;
+    add(role: Turn["role"], content: string): void;
+    clear(): void;
+    get length(): number;
+    /** Build the task for a new prompt, prepending the (bounded) conversation. */
+    taskFor(prompt: string): string;
+}
+//# sourceMappingURL=transcript.d.ts.map

package/dist/chat/transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.ts","sourceRoot":"","sources":["../../src/chat/transcript.ts"],"names":[],"mappings":"AAAA;yDACyD;AAEzD,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAQD,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAc;IAE3B,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9C,KAAK,IAAI,IAAI;IAIb,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,8EAA8E;IAC9E,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAiBhC"}