ai-consensus-core 0.9.0

package/dist/parser.js

@@ -0,0 +1,55 @@
+// ─────────────────────────────────────────────────────────────
+// Parser — extractors for confidence and judge sections
+// ─────────────────────────────────────────────────────────────
+const CONFIDENCE_RE = /CONFIDENCE:\s*(\d+)/i;
+const JUDGE_CONFIDENCE_RE = /JUDGE_CONFIDENCE:\s*\[?\s*(\d+)\s*\]?/i;
+/**
+ * Extract the trailing `CONFIDENCE: N` value. Clamps to [0, 100] and
+ * defaults to 50 when the marker is absent.
+ *
+ * The default is intentional: an absent marker is a model compliance
+ * issue, not a "low-confidence" signal, so we treat it as neutral rather
+ * than letting it skew the consensus score downward.
+ */
+export function extractConfidence(text) {
+    const match = CONFIDENCE_RE.exec(text);
+    if (!match)
+        return 50;
+    const n = Number.parseInt(match[1], 10);
+    if (Number.isNaN(n))
+        return 50;
+    return Math.min(100, Math.max(0, n));
+}
+/**
+ * Extract the judge's self-reported synthesis confidence. Tolerates both
+ * `JUDGE_CONFIDENCE: 87` and `JUDGE_CONFIDENCE: [87]` forms, since the
+ * JUDGE_PERSONA prompt wraps the placeholder in brackets.
+ */
+export function extractJudgeConfidence(text) {
+    const match = JUDGE_CONFIDENCE_RE.exec(text);
+    if (!match)
+        return 50;
+    const n = Number.parseInt(match[1], 10);
+    if (Number.isNaN(n))
+        return 50;
+    return Math.min(100, Math.max(0, n));
+}
+/**
+ * Extract a named `## Heading`-style section from a judge synthesis.
+ * Returns the trimmed section body, or "" if not found.
+ */
+export function extractJudgeSection(text, heading) {
+    const escaped = heading.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const pattern = new RegExp(`##\\s*${escaped}\\s*\\n([\\s\\S]*?)(?=\\n##\\s|$)`, "i");
+    const m = pattern.exec(text);
+    return m ? m[1].trim() : "";
+}
+/**
+ * Strip the trailing `CONFIDENCE: N` line from a body. Used when quoting
+ * a participant response back to a downstream model, so the marker from
+ * an earlier round doesn't bleed into the next round's parser pass.
+ */
+export function stripConfidenceLine(text) {
+    return text.replace(/\nCONFIDENCE:\s*\d+\s*$/i, "").trim();
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,wDAAwD;AACxD,gEAAgE;AAEhE,MAAM,aAAa,GAAG,sBAAsB,CAAC;AAC7C,MAAM,mBAAmB,GAAG,wCAAwC,CAAC;AAErE;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;IACzC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;IACzC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,OAAe;IAC/D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,SAAS,OAAO,mCAAmC,EAAE,GAAG,CAAC,CAAC;IACrF,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,0BAA0B,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAC7D,CAAC"}

package/dist/personas.d.ts

@@ -0,0 +1,16 @@
+import type { Persona } from "./types.js";
+export declare const PERSONAS: readonly Persona[];
+/** Look up a persona by id. Returns `undefined` if not found. */
+export declare function getPersonaById(id: string): Persona | undefined;
+/** Look up a persona by id, falling back to the first persona if the id is unknown. */
+export declare function getPersonaOrDefault(id: string): Persona;
+/**
+ * The Judge persona — used by the non-voting synthesizer.
+ * Not exposed via the participant selector.
+ *
+ * The output contract is exact: four markdown sections followed by a
+ * `JUDGE_CONFIDENCE: [0-100]` line. `parser.extractJudgeSection` and
+ * `parser.extractJudgeConfidence` both key off this contract.
+ */
+export declare const JUDGE_PERSONA: Persona;
+//# sourceMappingURL=personas.d.ts.map

package/dist/personas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"personas.d.ts","sourceRoot":"","sources":["../src/personas.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,eAAO,MAAM,QAAQ,EAAE,SAAS,OAAO,EAgE7B,CAAC;AAEX,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE9D;AAED,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,OA2B3B,CAAC"}

package/dist/personas.js

@@ -0,0 +1,109 @@
+// ─────────────────────────────────────────────────────────────
+// Personas — ported verbatim from roundtable/lib/personas.ts
+// ─────────────────────────────────────────────────────────────
+// Seven debate personas + one non-voting judge. IDs, names,
+// emojis, colors and system prompts are byte-for-byte identical
+// to the source, so a run here is behaviorally equivalent to a
+// run in the original roundtable UI.
+export const PERSONAS = [
+    {
+        id: "pessimist",
+        name: "Risk Analyst",
+        emoji: "☠️",
+        color: "#ef4444",
+        description: "Identifies risks, failure modes, tail risks, and worst-case scenarios",
+        systemPrompt: `You are a rigorous Risk Analyst. Your role is to surface hidden dangers, second-order effects, tail risks, and plausible failure modes. You are not cynical — you are protective. Be precise, evidence-based, and constructive. Highlight what could go wrong and why, so the group can make more robust decisions.`,
+    },
+    {
+        id: "first-principles",
+        name: "First-Principles Engineer",
+        emoji: "⚙️",
+        color: "#3b82f6",
+        description: "Breaks every claim down to fundamental truths and reasons from the ground up",
+        systemPrompt: `You are a First-Principles Engineer. Ruthlessly decompose every claim into its most fundamental axioms. Reject analogies and conventional wisdom. Question every assumption. Structure your thinking clearly and expose hidden premises that others are taking for granted.`,
+    },
+    {
+        id: "vc-specialist",
+        name: "VC Funds Specialist",
+        emoji: "💰",
+        color: "#10b981",
+        description: "Evaluates through market dynamics, scalability, moats, and investment viability",
+        systemPrompt: `You are a battle-tested Venture Capital Specialist. Analyze everything through the lens of market opportunity, scalable business models, competitive moats, unit economics, network effects, and capital efficiency. Think in terms of TAM/SAM/SOM, defensibility, and long-term value creation.`,
+    },
+    {
+        id: "scientific-skeptic",
+        name: "Scientific Skeptic",
+        emoji: "🔬",
+        color: "#f59e0b",
+        description: "Demands rigorous evidence and applies scientific scrutiny to every claim",
+        systemPrompt: `You are a Scientific Skeptic. Demand high-quality evidence for every assertion. Question methodology, sample size, selection bias, statistical power, and reproducibility. Distinguish correlation from causation. Call out logical fallacies and over-extrapolation without mercy.`,
+    },
+    {
+        id: "optimistic-futurist",
+        name: "Optimistic Futurist",
+        emoji: "🚀",
+        color: "#8b5cf6",
+        description: "Sees transformative potential and identifies exponential upside opportunities",
+        systemPrompt: `You are an Optimistic Futurist. Identify exponential trends, paradigm shifts, and breakthrough opportunities. Paint compelling visions of positive futures while remaining grounded. Focus on how obstacles can be overcome and how the idea could scale into something transformative.`,
+    },
+    {
+        id: "devils-advocate",
+        name: "Devil's Advocate",
+        emoji: "⚖️",
+        color: "#ec4899",
+        description: "Stress-tests ideas by arguing the strongest possible counter-position",
+        systemPrompt: `You are the Devil's Advocate. Your job is to construct the strongest possible counter-arguments to whatever position is emerging. Do this constructively — not to win, but to expose weaknesses and make the final consensus more robust. Be sharp, logical, and relentless.`,
+    },
+    {
+        id: "domain-expert",
+        name: "Domain Expert",
+        emoji: "🧠",
+        color: "#06b6d4",
+        description: "Brings deep technical and practical implementation knowledge with concrete examples",
+        systemPrompt: `You are a seasoned Domain Expert with years of hands-on experience. Ground your analysis in real-world implementation details, known patterns, anti-patterns, edge cases, and practical constraints. Be specific, cite concrete examples, and provide reality-checks that only deep domain knowledge can offer.`,
+    },
+];
+/** Look up a persona by id. Returns `undefined` if not found. */
+export function getPersonaById(id) {
+    return PERSONAS.find((p) => p.id === id);
+}
+/** Look up a persona by id, falling back to the first persona if the id is unknown. */
+export function getPersonaOrDefault(id) {
+    return getPersonaById(id) ?? PERSONAS[0];
+}
+/**
+ * The Judge persona — used by the non-voting synthesizer.
+ * Not exposed via the participant selector.
+ *
+ * The output contract is exact: four markdown sections followed by a
+ * `JUDGE_CONFIDENCE: [0-100]` line. `parser.extractJudgeSection` and
+ * `parser.extractJudgeConfidence` both key off this contract.
+ */
+export const JUDGE_PERSONA = {
+    id: "judge",
+    name: "Consensus Judge",
+    emoji: "🪶",
+    color: "#eab308",
+    description: "Non-voting synthesizer that summarises majority and minority positions",
+    systemPrompt: `You are the Consensus Judge. You do NOT participate in the debate and you do NOT vote. Your only job is to read the final-round responses from every participant and produce a faithful synthesis.
+
+Produce your output in exactly this shape, with those headings:
+
+## Majority Position
+One paragraph describing the position held by the largest coherent group, with the participants who held it.
+
+## Minority Positions
+One short paragraph per dissenting view. Always preserve conditional exceptions — do not collapse them into the majority.
+
+## Unresolved Disputes
+Bullet list of specific disagreements that remained open at the end of the debate. If none, say "None".
+
+## Synthesis Confidence
+A single integer 0-100 reflecting how confident you are that the above synthesis is faithful to what was actually said. End with a line in exactly this format: \`JUDGE_CONFIDENCE: [0-100]\`.
+
+Rules:
+- Do not invent claims. Quote or paraphrase what participants actually said.
+- Do not pick a winner. Your job is faithfulness, not victory.
+- Do not collapse a minority view with a conditional exception into the majority.`,
+};
+//# sourceMappingURL=personas.js.map

package/dist/personas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"personas.js","sourceRoot":"","sources":["../src/personas.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,6DAA6D;AAC7D,gEAAgE;AAChE,4DAA4D;AAC5D,gEAAgE;AAChE,+DAA+D;AAC/D,qCAAqC;AAIrC,MAAM,CAAC,MAAM,QAAQ,GAAuB;IAC1C;QACE,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,SAAS;QAChB,WAAW,EACT,uEAAuE;QACzE,YAAY,EAAE,qTAAqT;KACpU;IACD;QACE,EAAE,EAAE,kBAAkB;QACtB,IAAI,EAAE,2BAA2B;QACjC,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,SAAS;QAChB,WAAW,EACT,8EAA8E;QAChF,YAAY,EAAE,6QAA6Q;KAC5R;IACD;QACE,EAAE,EAAE,eAAe;QACnB,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,SAAS;QAChB,WAAW,EACT,iFAAiF;QACnF,YAAY,EAAE,kSAAkS;KACjT;IACD;QACE,EAAE,EAAE,oBAAoB;QACxB,IAAI,EAAE,oBAAoB;QAC1B,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,SAAS;QAChB,WAAW,EACT,0EAA0E;QAC5E,YAAY,EAAE,qRAAqR;KACpS;IACD;QACE,EAAE,EAAE,qBAAqB;QACzB,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,SAAS;QAChB,WAAW,EACT,+EAA+E;QACjF,YAAY,EAAE,yRAAyR;KACxS;IACD;QACE,EAAE,EAAE,iBAAiB;QACrB,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,SAAS;QAChB,WAAW,EACT,uEAAuE;QACzE,YAAY,EAAE,8QAA8Q;KAC7R;IACD;QACE,EAAE,EAAE,eAAe;QACnB,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,IAAI;QACX,KAAK,EAAE,SAAS;QAChB,WAAW,EACT,qFAAqF;QACvF,YAAY,EAAE,iTAAiT;KAChU;CACO,CAAC;AAEX,iEAAiE;AACjE,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,mBAAmB,CAAC,EAAU;IAC5C,OAAO,cAAc,CAAC,EAAE,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAE,CAAC;AAC5C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAY;IACpC,EAAE,EAAE,OAAO;IACX,IAAI,EAAE,iBAAiB;IACvB,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,SAAS;IAChB,WAAW,EACT,wEAAwE;IAC1E,YAAY,EAAE;;;;;;;;;;;;;;;;;;;kFAmBkE;CACjF,CAAC"}

package/dist/prompts.d.ts

@@ -0,0 +1,60 @@
+import type { ParticipantResponse, Participant, Phase } from "./types.js";
+export interface RoundMeta {
+    phase: Phase;
+    label: string;
+}
+/**
+ * Map a round number to its phase and human label.
+ *
+ *   Round 1      → initial-analysis     "Initial Analysis"
+ *   Round 2      → counterarguments     "Counterarguments"
+ *   Round 3      → evidence-assessment  "Evidence Assessment"
+ *   Round 4..N-1 → synthesis            "Synthesis & Refinement (Round N)"
+ *   Round N      → synthesis            "Final Synthesis"
+ */
+export declare function getRoundMeta(round: number, totalRounds: number): RoundMeta;
+/**
+ * Format the block of previous responses that a participant sees at the
+ * start of rounds 2+. Matches roundtable's "PREVIOUS ROUND RESPONSES"
+ * fence so models can't latch onto a different delimiter across versions.
+ */
+export declare function formatPreviousResponses(responses: readonly ParticipantResponse[]): string;
+/**
+ * Build the full system prompt for a single participant call.
+ *
+ * Shape:
+ *
+ *     {persona.systemPrompt}
+ *
+ *     {phase instructions}{previous-responses block, if any}
+ *
+ *     IMPORTANT: End your response with a line in exactly this format:
+ *     CONFIDENCE: [number 0-100]
+ */
+export declare function buildParticipantSystemPrompt(params: {
+    personaSystemPrompt: string;
+    phase: Phase;
+    round: number;
+    totalRounds: number;
+    previousResponses: readonly ParticipantResponse[];
+}): string;
+/**
+ * Build the judge's system prompt. We append the original user prompt to
+ * the JUDGE_PERSONA's instructions so the model knows what was debated,
+ * without having to infer it from participant text.
+ */
+export declare function buildJudgeSystemPrompt(params: {
+    judgeSystemPrompt: string;
+    question: string;
+}): string;
+/**
+ * Build the judge's user content: the final-round responses, labelled with
+ * persona name and model id, and with the trailing `CONFIDENCE: N` line
+ * stripped from each body (the participant confidence is surfaced in the
+ * heading instead).
+ */
+export declare function buildJudgeUserPrompt(params: {
+    finalResponses: readonly ParticipantResponse[];
+    participants: readonly Participant[];
+}): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAE1E,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,CAW1E;AA0BD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,mBAAmB,EAAE,GAAG,MAAM,CAMzF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE;IACnD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACnD,GAAG,MAAM,CAST;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE;IAC7C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,CAOT;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,cAAc,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC/C,YAAY,EAAE,SAAS,WAAW,EAAE,CAAC;CACtC,GAAG,MAAM,CAWT"}

package/dist/prompts.js

@@ -0,0 +1,111 @@
+// ─────────────────────────────────────────────────────────────
+// Prompts — faithful port of the CVP prompt templates.
+// ─────────────────────────────────────────────────────────────
+// The exact strings here shape model behavior. Any drift between
+// this file and roundtable/lib/consensus-engine.ts will change
+// run semantics, so edits should be deliberate.
+/**
+ * Map a round number to its phase and human label.
+ *
+ *   Round 1      → initial-analysis     "Initial Analysis"
+ *   Round 2      → counterarguments     "Counterarguments"
+ *   Round 3      → evidence-assessment  "Evidence Assessment"
+ *   Round 4..N-1 → synthesis            "Synthesis & Refinement (Round N)"
+ *   Round N      → synthesis            "Final Synthesis"
+ */
+export function getRoundMeta(round, totalRounds) {
+    if (round === 1)
+        return { phase: "initial-analysis", label: "Initial Analysis" };
+    if (round === 2)
+        return { phase: "counterarguments", label: "Counterarguments" };
+    if (round === 3)
+        return { phase: "evidence-assessment", label: "Evidence Assessment" };
+    return {
+        phase: "synthesis",
+        label: round === totalRounds
+            ? "Final Synthesis"
+            : `Synthesis & Refinement (Round ${round})`,
+    };
+}
+const PHASE_INSTRUCTIONS = {
+    "initial-analysis": (round, total) => `This is Round ${round}/${total}: INITIAL ANALYSIS.
+Provide your initial analysis of the prompt. Share your perspective, key observations, and preliminary assessment. State your confidence level (0-100) at the end.`,
+    counterarguments: (round, total) => `This is Round ${round}/${total}: COUNTERARGUMENTS.
+Review the initial analyses from all participants below. Identify weaknesses, biases, and blind spots. Offer substantive counterarguments. Challenge assumptions. State your updated confidence level (0-100) at the end.`,
+    "evidence-assessment": (round, total) => `This is Round ${round}/${total}: EVIDENCE ASSESSMENT.
+Evaluate the strength of evidence and reasoning presented so far. Distinguish well-supported claims from speculation. Identify areas where consensus is forming and where disagreement remains substantive. State your confidence level (0-100) at the end.`,
+    synthesis: (round, total) => {
+        const isFinal = round === total;
+        const header = isFinal ? "FINAL SYNTHESIS" : "SYNTHESIS & REFINEMENT";
+        const directive = isFinal
+            ? "Provide your final, considered position."
+            : "Refine your position based on the strongest arguments presented.";
+        return `This is Round ${round}/${total}: ${header}.
+Synthesize the discussion so far into a coherent assessment. Acknowledge remaining uncertainties. ${directive} State your final confidence level (0-100) at the end.`;
+    },
+};
+/**
+ * Format the block of previous responses that a participant sees at the
+ * start of rounds 2+. Matches roundtable's "PREVIOUS ROUND RESPONSES"
+ * fence so models can't latch onto a different delimiter across versions.
+ */
+export function formatPreviousResponses(responses) {
+    if (responses.length === 0)
+        return "";
+    const blocks = responses.map((r) => `[Participant ${r.participantId} | Confidence: ${r.confidence}%]\n${r.content}`);
+    return `\n\n--- PREVIOUS ROUND RESPONSES ---\n${blocks.join("\n\n---\n\n")}\n--- END PREVIOUS RESPONSES ---`;
+}
+/**
+ * Build the full system prompt for a single participant call.
+ *
+ * Shape:
+ *
+ *     {persona.systemPrompt}
+ *
+ *     {phase instructions}{previous-responses block, if any}
+ *
+ *     IMPORTANT: End your response with a line in exactly this format:
+ *     CONFIDENCE: [number 0-100]
+ */
+export function buildParticipantSystemPrompt(params) {
+    const instructions = PHASE_INSTRUCTIONS[params.phase](params.round, params.totalRounds);
+    const previousContext = formatPreviousResponses(params.previousResponses);
+    return `${params.personaSystemPrompt}
+
+${instructions}${previousContext}
+
+IMPORTANT: End your response with a line in exactly this format:
+CONFIDENCE: [number 0-100]`;
+}
+/**
+ * Build the judge's system prompt. We append the original user prompt to
+ * the JUDGE_PERSONA's instructions so the model knows what was debated,
+ * without having to infer it from participant text.
+ */
+export function buildJudgeSystemPrompt(params) {
+    return `${params.judgeSystemPrompt}
+
+The original prompt that was debated was:
+"""
+${params.question}
+"""`;
+}
+/**
+ * Build the judge's user content: the final-round responses, labelled with
+ * persona name and model id, and with the trailing `CONFIDENCE: N` line
+ * stripped from each body (the participant confidence is surfaced in the
+ * heading instead).
+ */
+export function buildJudgeUserPrompt(params) {
+    const { finalResponses, participants } = params;
+    const blocks = finalResponses.map((r) => {
+        const p = participants.find((x) => x.id === r.participantId);
+        const label = p
+            ? `${p.persona.name} (${p.modelId})`
+            : r.participantId;
+        const body = r.content.replace(/\nCONFIDENCE:\s*\d+\s*$/i, "").trim();
+        return `### ${label} — self-reported confidence ${r.confidence}%\n${body}`;
+    });
+    return `Below are the final-round responses from every participant. Synthesize them per your instructions.\n\n${blocks.join("\n\n---\n\n")}`;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

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

package/dist/stats.d.ts

@@ -0,0 +1,42 @@
+import type { Disagreement, Participant, ParticipantResponse } from "./types.js";
+/** Arithmetic mean. Returns 0 for empty input. */
+export declare function average(xs: readonly number[]): number;
+/**
+ * Population standard deviation (divides by N, not N-1).
+ *
+ * We use population stddev rather than sample stddev to stay aligned with
+ * the roundtable reference implementation. The participant count is the
+ * entire panel, not a sample from a larger distribution.
+ */
+export declare function stddev(xs: readonly number[]): number;
+/**
+ * Consensus score: `round(clamp(avg − 0.5·stddev, 0, 100))`.
+ *
+ * Penalizes disagreement (high stddev) against the pack's confidence.
+ * Integer-rounded so early-stop deltas are stable.
+ */
+export declare function consensusScore(confidences: readonly number[]): number;
+/**
+ * Pairwise disagreement detection. Any two non-errored responses whose
+ * confidence differs by at least `threshold` (default 20) generates a
+ * Disagreement entry. Deterministic (no text-based heuristic, no extra
+ * LLM calls).
+ */
+export declare function detectDisagreements(params: {
+    round: number;
+    responses: readonly ParticipantResponse[];
+    participants: readonly Participant[];
+    threshold?: number;
+}): Disagreement[];
+/**
+ * Fisher–Yates shuffle. Pure (returns a new array) and takes an injectable
+ * RNG so callers can seed it for deterministic replay.
+ */
+export declare function shuffle<T>(input: readonly T[], rng?: () => number): T[];
+/**
+ * Small, allocation-free mulberry32 PRNG. Used only when the caller
+ * passes `randomSeed` for deterministic runs — otherwise we use
+ * `Math.random`. Not cryptographically secure; we don't need it to be.
+ */
+export declare function mulberry32(seed: number): () => number;
+//# sourceMappingURL=stats.d.ts.map

package/dist/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../src/stats.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjF,kDAAkD;AAClD,wBAAgB,OAAO,CAAC,EAAE,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAKrD;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CASpD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAKrE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC1C,YAAY,EAAE,SAAS,WAAW,EAAE,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,YAAY,EAAE,CA0BjB;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,GAAG,GAAE,MAAM,MAAoB,GAAG,CAAC,EAAE,CASpF;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,MAAM,CASrD"}

package/dist/stats.js

@@ -0,0 +1,108 @@
+// ─────────────────────────────────────────────────────────────
+// Stats — averages, standard deviation, consensus score,
+// disagreement detection.
+// ─────────────────────────────────────────────────────────────
+/** Arithmetic mean. Returns 0 for empty input. */
+export function average(xs) {
+    if (xs.length === 0)
+        return 0;
+    let sum = 0;
+    for (const x of xs)
+        sum += x;
+    return sum / xs.length;
+}
+/**
+ * Population standard deviation (divides by N, not N-1).
+ *
+ * We use population stddev rather than sample stddev to stay aligned with
+ * the roundtable reference implementation. The participant count is the
+ * entire panel, not a sample from a larger distribution.
+ */
+export function stddev(xs) {
+    if (xs.length === 0)
+        return 0;
+    const mean = average(xs);
+    let varSum = 0;
+    for (const x of xs) {
+        const d = x - mean;
+        varSum += d * d;
+    }
+    return Math.sqrt(varSum / xs.length);
+}
+/**
+ * Consensus score: `round(clamp(avg − 0.5·stddev, 0, 100))`.
+ *
+ * Penalizes disagreement (high stddev) against the pack's confidence.
+ * Integer-rounded so early-stop deltas are stable.
+ */
+export function consensusScore(confidences) {
+    if (confidences.length === 0)
+        return 0;
+    const avg = average(confidences);
+    const sd = stddev(confidences);
+    return Math.round(Math.max(0, Math.min(100, avg - sd * 0.5)));
+}
+/**
+ * Pairwise disagreement detection. Any two non-errored responses whose
+ * confidence differs by at least `threshold` (default 20) generates a
+ * Disagreement entry. Deterministic (no text-based heuristic, no extra
+ * LLM calls).
+ */
+export function detectDisagreements(params) {
+    const { round, responses, participants } = params;
+    const threshold = params.threshold ?? 20;
+    const out = [];
+    for (let i = 0; i < responses.length; i++) {
+        for (let j = i + 1; j < responses.length; j++) {
+            const a = responses[i];
+            const b = responses[j];
+            if (a.error || b.error)
+                continue;
+            const delta = Math.abs(a.confidence - b.confidence);
+            if (delta < threshold)
+                continue;
+            const pa = participants.find((p) => p.id === a.participantId);
+            const pb = participants.find((p) => p.id === b.participantId);
+            const label = pa && pb ? `${pa.persona.name} vs ${pb.persona.name}` : "Confidence split";
+            out.push({
+                id: `r${round}-${a.participantId}-${b.participantId}`,
+                round,
+                participantAId: a.participantId,
+                participantBId: b.participantId,
+                severity: delta,
+                label,
+            });
+        }
+    }
+    return out;
+}
+/**
+ * Fisher–Yates shuffle. Pure (returns a new array) and takes an injectable
+ * RNG so callers can seed it for deterministic replay.
+ */
+export function shuffle(input, rng = Math.random) {
+    const out = input.slice();
+    for (let i = out.length - 1; i > 0; i--) {
+        const j = Math.floor(rng() * (i + 1));
+        const tmp = out[i];
+        out[i] = out[j];
+        out[j] = tmp;
+    }
+    return out;
+}
+/**
+ * Small, allocation-free mulberry32 PRNG. Used only when the caller
+ * passes `randomSeed` for deterministic runs — otherwise we use
+ * `Math.random`. Not cryptographically secure; we don't need it to be.
+ */
+export function mulberry32(seed) {
+    let t = seed >>> 0;
+    return () => {
+        t = (t + 0x6d2b79f5) >>> 0;
+        let r = t;
+        r = Math.imul(r ^ (r >>> 15), r | 1);
+        r ^= r + Math.imul(r ^ (r >>> 7), r | 61);
+        return ((r ^ (r >>> 14)) >>> 0) / 4294967296;
+    };
+}
+//# sourceMappingURL=stats.js.map

package/dist/stats.js.map

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