ai-consensus-core 0.9.0

package/dist/engine.js

@@ -0,0 +1,428 @@
+// ─────────────────────────────────────────────────────────────
+// ConsensusEngine — CVP orchestrator
+// ─────────────────────────────────────────────────────────────
+// Drives the full protocol: round scheduling, phase prompts,
+// blind/sequential dispatch, confidence extraction, stats,
+// disagreement detection, early stopping, optional judge synthesis.
+//
+// Zero LLM-provider coupling. A `ModelCaller` is the single
+// extension point — see `types.ts`.
+import { TypedEventEmitter } from "./events.js";
+import { JUDGE_PERSONA } from "./personas.js";
+import { extractConfidence, extractJudgeConfidence, extractJudgeSection, } from "./parser.js";
+import { buildJudgeSystemPrompt, buildJudgeUserPrompt, buildParticipantSystemPrompt, getRoundMeta, } from "./prompts.js";
+import { average, consensusScore, detectDisagreements, mulberry32, shuffle, stddev, } from "./stats.js";
+// ── Defaults ───────────────────────────────────────────────
+const DEFAULTS = {
+    maxRounds: 4,
+    earlyStop: true,
+    convergenceDelta: 3,
+    disagreementThreshold: 20,
+    blindFirstRound: true,
+    randomizeOrder: true,
+    participantTemperature: 0.7,
+    maxOutputTokens: 1500,
+    judgeTemperature: 0.3,
+    judgeMaxOutputTokens: 1500,
+};
+const MAX_ROUNDS_CAP = 10;
+const MIN_PARTICIPANTS = 2;
+// ── Public engine ──────────────────────────────────────────
+export class ConsensusEngine extends TypedEventEmitter {
+    #caller;
+    constructor(caller) {
+        super();
+        this.#caller = caller;
+    }
+    /**
+     * Run the Consensus Validation Protocol end-to-end.
+     *
+     * Emits events throughout (see {@link ConsensusEventMap}). Resolves with the
+     * final {@link ConsensusResult}. Rejects only on `AbortError` from a
+     * cancelled run — per-participant ModelCaller failures are captured into
+     * the per-response `error` field and do not abort the loop.
+     */
+    async run(options) {
+        const opts = normalizeOptions(options);
+        const startedAt = Date.now();
+        const rng = opts.randomSeed !== undefined ? mulberry32(opts.randomSeed) : Math.random;
+        const allResponses = [];
+        const rounds = [];
+        const roundScores = [];
+        let stopReason = "max-rounds";
+        let earlyStopInfo;
+        try {
+            for (let round = 1; round <= opts.maxRounds; round++) {
+                throwIfAborted(opts.signal);
+                const { phase, label } = getRoundMeta(round, opts.maxRounds);
+                const blind = round === 1 && opts.blindFirstRound;
+                const order = !blind && opts.randomizeOrder && round > 1
+                    ? shuffle(opts.participants, rng)
+                    : opts.participants.slice();
+                this.emit("roundStart", {
+                    round,
+                    phase,
+                    label,
+                    blind,
+                    participantIds: order.map((p) => p.id),
+                });
+                const roundStartedAt = Date.now();
+                const previousResponses = allResponses.filter((r) => r.round < round);
+                const roundResponses = await this.#runRound({
+                    round,
+                    phase,
+                    blind,
+                    order,
+                    previousResponses,
+                    totalRounds: opts.maxRounds,
+                    question: opts.question,
+                    temperature: opts.participantTemperature,
+                    maxOutputTokens: opts.maxOutputTokens,
+                    signal: opts.signal,
+                });
+                const roundCompletedAt = Date.now();
+                allResponses.push(...roundResponses);
+                const scored = roundResponses.filter((r) => !r.error);
+                const confidences = scored.map((r) => r.confidence);
+                const avg = average(confidences);
+                const sd = stddev(confidences);
+                const score = consensusScore(confidences);
+                roundScores.push(score);
+                const disagreements = detectDisagreements({
+                    round,
+                    responses: roundResponses,
+                    participants: opts.participants,
+                    threshold: opts.disagreementThreshold,
+                });
+                for (const d of disagreements) {
+                    this.emit("disagreementDetected", { round, disagreement: d });
+                }
+                const roundResult = {
+                    round,
+                    phase,
+                    label,
+                    blind,
+                    responses: roundResponses,
+                    averageConfidence: avg,
+                    stddev: sd,
+                    score,
+                    disagreements,
+                    startedAt: roundStartedAt,
+                    completedAt: roundCompletedAt,
+                    durationMs: roundCompletedAt - roundStartedAt,
+                };
+                rounds.push(roundResult);
+                this.emit("roundComplete", {
+                    round,
+                    phase,
+                    averageConfidence: avg,
+                    stddev: sd,
+                    score,
+                    disagreements,
+                    responses: roundResponses,
+                    durationMs: roundResult.durationMs,
+                });
+                if (opts.earlyStop &&
+                    round >= 2 &&
+                    round < opts.maxRounds &&
+                    roundScores.length >= 2) {
+                    const prev = roundScores[roundScores.length - 2];
+                    const delta = Math.abs(score - prev);
+                    if (delta <= opts.convergenceDelta) {
+                        const reason = `Consensus score delta ${delta.toFixed(1)} between rounds ${round - 1} and ${round} is at or below the convergence threshold (${opts.convergenceDelta}).`;
+                        earlyStopInfo = { round, delta, reason };
+                        stopReason = "converged";
+                        this.emit("earlyStop", { round, delta, reason });
+                        break;
+                    }
+                }
+            }
+            // Judge synthesis (optional)
+            const lastRound = rounds[rounds.length - 1];
+            let synthesis;
+            if (opts.judge && lastRound) {
+                throwIfAborted(opts.signal);
+                synthesis = await this.#runJudge({
+                    judgeModelId: opts.judge.modelId,
+                    judgeCaller: opts.judge.caller ?? this.#caller,
+                    judgeTemperature: opts.judge.temperature ?? DEFAULTS.judgeTemperature,
+                    judgeMaxOutputTokens: opts.judge.maxOutputTokens ?? DEFAULTS.judgeMaxOutputTokens,
+                    finalResponses: lastRound.responses,
+                    participants: opts.participants,
+                    question: opts.question,
+                    lastRoundNumber: lastRound.round,
+                    signal: opts.signal,
+                });
+            }
+            const completedAt = Date.now();
+            const finalConfidences = lastRound
+                ? lastRound.responses.filter((r) => !r.error).map((r) => r.confidence)
+                : [];
+            const result = {
+                question: opts.question,
+                participants: opts.participants,
+                rounds,
+                roundsCompleted: rounds.length,
+                finalScore: lastRound?.score ?? 0,
+                finalAverageConfidence: average(finalConfidences),
+                finalStddev: stddev(finalConfidences),
+                stopReason,
+                earlyStop: earlyStopInfo,
+                synthesis,
+                startedAt,
+                completedAt,
+                durationMs: completedAt - startedAt,
+            };
+            this.emit("finalResult", { result });
+            return result;
+        }
+        catch (err) {
+            if (isAbortError(err)) {
+                const completedAt = Date.now();
+                const lastRound = rounds[rounds.length - 1];
+                const finalConfidences = lastRound
+                    ? lastRound.responses.filter((r) => !r.error).map((r) => r.confidence)
+                    : [];
+                const result = {
+                    question: opts.question,
+                    participants: opts.participants,
+                    rounds,
+                    roundsCompleted: rounds.length,
+                    finalScore: lastRound?.score ?? 0,
+                    finalAverageConfidence: average(finalConfidences),
+                    finalStddev: stddev(finalConfidences),
+                    stopReason: "aborted",
+                    earlyStop: earlyStopInfo,
+                    startedAt,
+                    completedAt,
+                    durationMs: completedAt - startedAt,
+                };
+                this.emit("finalResult", { result });
+                return result;
+            }
+            const error = err instanceof Error ? err : new Error(String(err));
+            this.emit("error", error);
+            throw error;
+        }
+    }
+    // ── Round orchestration ──────────────────────────────────
+    async #runRound(args) {
+        const { round, phase, blind, order, previousResponses, totalRounds, question, temperature, maxOutputTokens, signal, } = args;
+        if (blind) {
+            const promises = order.map((participant) => this.#callParticipant({
+                participant,
+                round,
+                phase,
+                totalRounds,
+                question,
+                previousResponses: [],
+                temperature,
+                maxOutputTokens,
+                signal,
+                runningConfidences: [],
+            }));
+            return Promise.all(promises);
+        }
+        const collected = [];
+        for (const participant of order) {
+            throwIfAborted(signal);
+            const visible = [...previousResponses, ...collected];
+            const confidencesSoFar = collected
+                .filter((r) => !r.error)
+                .map((r) => r.confidence);
+            const response = await this.#callParticipant({
+                participant,
+                round,
+                phase,
+                totalRounds,
+                question,
+                previousResponses: visible,
+                temperature,
+                maxOutputTokens,
+                signal,
+                runningConfidences: confidencesSoFar,
+            });
+            collected.push(response);
+        }
+        return collected;
+    }
+    // ── Single participant call ──────────────────────────────
+    async #callParticipant(args) {
+        const { participant, round, phase, totalRounds, question, previousResponses, temperature, maxOutputTokens, signal, runningConfidences, } = args;
+        const system = buildParticipantSystemPrompt({
+            personaSystemPrompt: participant.persona.systemPrompt,
+            phase,
+            round,
+            totalRounds,
+            previousResponses,
+        });
+        this.emit("participantStart", {
+            round,
+            phase,
+            participantId: participant.id,
+            modelId: participant.modelId,
+            personaId: participant.persona.id,
+        });
+        const startedAt = Date.now();
+        let content = "";
+        let error;
+        let usage;
+        try {
+            const result = await this.#caller({
+                participantId: participant.id,
+                modelId: participant.modelId,
+                round,
+                phase,
+                system,
+                user: question,
+                temperature,
+                maxOutputTokens,
+                signal,
+                onToken: (token) => {
+                    this.emit("participantToken", {
+                        round,
+                        participantId: participant.id,
+                        token,
+                    });
+                },
+            });
+            content = result.content;
+            usage = result.usage;
+        }
+        catch (err) {
+            if (isAbortError(err))
+                throw err;
+            error = err instanceof Error ? err.message : String(err);
+            content = content || `[Error from ${participant.modelId}: ${error}]`;
+        }
+        const completedAt = Date.now();
+        const confidence = error ? 0 : extractConfidence(content);
+        const response = {
+            participantId: participant.id,
+            modelId: participant.modelId,
+            personaId: participant.persona.id,
+            round,
+            phase,
+            content,
+            confidence,
+            error,
+            usage,
+            startedAt,
+            completedAt,
+            durationMs: completedAt - startedAt,
+        };
+        this.emit("participantComplete", { round, phase, response });
+        if (!error) {
+            const withSelf = [...runningConfidences, confidence];
+            this.emit("confidenceUpdate", {
+                round,
+                participantId: participant.id,
+                confidence,
+                runningAverage: average(withSelf),
+            });
+        }
+        return response;
+    }
+    // ── Judge synthesizer ────────────────────────────────────
+    async #runJudge(args) {
+        const { judgeModelId, judgeCaller, judgeTemperature, judgeMaxOutputTokens, finalResponses, participants, question, lastRoundNumber, signal, } = args;
+        this.emit("synthesisStart", { modelId: judgeModelId });
+        const system = buildJudgeSystemPrompt({
+            judgeSystemPrompt: JUDGE_PERSONA.systemPrompt,
+            question,
+        });
+        const user = buildJudgeUserPrompt({
+            finalResponses,
+            participants,
+        });
+        const startedAt = Date.now();
+        let content = "";
+        let usage;
+        try {
+            const result = await judgeCaller({
+                participantId: "judge",
+                modelId: judgeModelId,
+                round: lastRoundNumber,
+                phase: "synthesis",
+                system,
+                user,
+                temperature: judgeTemperature,
+                maxOutputTokens: judgeMaxOutputTokens,
+                signal,
+                onToken: (token) => {
+                    this.emit("synthesisToken", { token });
+                },
+            });
+            content = result.content;
+            usage = result.usage;
+        }
+        catch (err) {
+            if (isAbortError(err))
+                throw err;
+            const msg = err instanceof Error ? err.message : String(err);
+            content = content || `[Judge error from ${judgeModelId}: ${msg}]`;
+        }
+        const completedAt = Date.now();
+        const synthesis = {
+            modelId: judgeModelId,
+            content,
+            majorityPosition: extractJudgeSection(content, "Majority Position"),
+            minorityPositions: extractJudgeSection(content, "Minority Positions"),
+            unresolvedDisputes: extractJudgeSection(content, "Unresolved Disputes"),
+            judgeConfidence: extractJudgeConfidence(content),
+            usage,
+            startedAt,
+            completedAt,
+            durationMs: completedAt - startedAt,
+        };
+        this.emit("synthesisComplete", { synthesis });
+        return synthesis;
+    }
+}
+function normalizeOptions(options) {
+    if (!options.question || options.question.trim().length === 0) {
+        throw new Error("ConsensusEngine: `question` must be a non-empty string.");
+    }
+    if (!Array.isArray(options.participants) || options.participants.length < MIN_PARTICIPANTS) {
+        throw new Error(`ConsensusEngine: at least ${MIN_PARTICIPANTS} participants are required (got ${options.participants?.length ?? 0}).`);
+    }
+    const ids = new Set();
+    for (const p of options.participants) {
+        if (ids.has(p.id)) {
+            throw new Error(`ConsensusEngine: duplicate participant id "${p.id}".`);
+        }
+        ids.add(p.id);
+    }
+    const maxRounds = clampInt(options.maxRounds ?? DEFAULTS.maxRounds, 1, MAX_ROUNDS_CAP);
+    return {
+        question: options.question,
+        participants: options.participants.slice(),
+        maxRounds,
+        earlyStop: options.earlyStop ?? DEFAULTS.earlyStop,
+        convergenceDelta: options.convergenceDelta ?? DEFAULTS.convergenceDelta,
+        disagreementThreshold: options.disagreementThreshold ?? DEFAULTS.disagreementThreshold,
+        blindFirstRound: options.blindFirstRound ?? DEFAULTS.blindFirstRound,
+        randomizeOrder: options.randomizeOrder ?? DEFAULTS.randomizeOrder,
+        participantTemperature: options.participantTemperature ?? DEFAULTS.participantTemperature,
+        maxOutputTokens: options.maxOutputTokens ?? DEFAULTS.maxOutputTokens,
+        judge: options.judge,
+        randomSeed: options.randomSeed,
+        signal: options.signal,
+    };
+}
+function clampInt(n, lo, hi) {
+    return Math.max(lo, Math.min(hi, Math.trunc(n)));
+}
+function throwIfAborted(signal) {
+    if (signal?.aborted) {
+        const reason = signal.reason;
+        if (reason instanceof Error)
+            throw reason;
+        throw new DOMException("Aborted", "AbortError");
+    }
+}
+function isAbortError(err) {
+    return (err instanceof DOMException && err.name === "AbortError") || (err instanceof Error && err.name === "AbortError");
+}
+export { DEFAULTS as CONSENSUS_DEFAULTS, MAX_ROUNDS_CAP };
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/events.d.ts

@@ -0,0 +1,29 @@
+import type { ConsensusEventMap } from "./types.js";
+/**
+ * Thin, strictly-typed wrapper around Node's EventEmitter.
+ *
+ * We don't rely on Node 22+'s generic `EventEmitter<T>` so this works on every
+ * Node 20+ release. The shape is intentionally narrow — if you need `prependListener`
+ * or `rawListeners` for this, add them here and keep the types honest.
+ *
+ * The constraint is a self-referential mapped type rather than a bare
+ * `Record<string, (...args: never[]) => void>` so that interface-based event
+ * maps (which lack an implicit string index signature) satisfy it.
+ */
+export declare class TypedEventEmitter<Events extends {
+    [K in keyof Events]: (...args: never[]) => void;
+}> {
+    private readonly emitter;
+    constructor();
+    on<K extends keyof Events & string>(event: K, listener: Events[K]): this;
+    once<K extends keyof Events & string>(event: K, listener: Events[K]): this;
+    off<K extends keyof Events & string>(event: K, listener: Events[K]): this;
+    removeAllListeners<K extends keyof Events & string>(event?: K): this;
+    listenerCount<K extends keyof Events & string>(event: K): number;
+    protected emit<K extends keyof Events & string>(event: K, ...args: Parameters<Events[K]>): boolean;
+}
+/**
+ * A narrower alias for consumers who want the concrete engine event map.
+ */
+export type ConsensusEmitter = TypedEventEmitter<ConsensusEventMap>;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAIpD;;;;;;;;;;GAUG;AACH,qBAAa,iBAAiB,CAC5B,MAAM,SAAS;KAAG,CAAC,IAAI,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI;CAAE;IAElE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;;IAQ9C,EAAE,CAAC,CAAC,SAAS,MAAM,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI;IAKxE,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI;IAK1E,GAAG,CAAC,CAAC,SAAS,MAAM,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI;IAKzE,kBAAkB,CAAC,CAAC,SAAS,MAAM,MAAM,GAAG,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI;IAMpE,aAAa,CAAC,CAAC,SAAS,MAAM,MAAM,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM;IAIhE,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,GAAG,MAAM,EAC5C,KAAK,EAAE,CAAC,EACR,GAAG,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAC7B,OAAO;CAGX;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,iBAAiB,CAAC,CAAC"}

package/dist/events.js

@@ -0,0 +1,46 @@
+import { EventEmitter } from "node:events";
+/**
+ * Thin, strictly-typed wrapper around Node's EventEmitter.
+ *
+ * We don't rely on Node 22+'s generic `EventEmitter<T>` so this works on every
+ * Node 20+ release. The shape is intentionally narrow — if you need `prependListener`
+ * or `rawListeners` for this, add them here and keep the types honest.
+ *
+ * The constraint is a self-referential mapped type rather than a bare
+ * `Record<string, (...args: never[]) => void>` so that interface-based event
+ * maps (which lack an implicit string index signature) satisfy it.
+ */
+export class TypedEventEmitter {
+    emitter = new EventEmitter();
+    constructor() {
+        // Consensus runs can fan out to many observers (UI, logs, MCP progress…).
+        // Default cap of 10 is too low for real-world use.
+        this.emitter.setMaxListeners(0);
+    }
+    on(event, listener) {
+        this.emitter.on(event, listener);
+        return this;
+    }
+    once(event, listener) {
+        this.emitter.once(event, listener);
+        return this;
+    }
+    off(event, listener) {
+        this.emitter.off(event, listener);
+        return this;
+    }
+    removeAllListeners(event) {
+        if (event)
+            this.emitter.removeAllListeners(event);
+        else
+            this.emitter.removeAllListeners();
+        return this;
+    }
+    listenerCount(event) {
+        return this.emitter.listenerCount(event);
+    }
+    emit(event, ...args) {
+        return this.emitter.emit(event, ...args);
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK3C;;;;;;;;;;GAUG;AACH,MAAM,OAAO,iBAAiB;IAGX,OAAO,GAAG,IAAI,YAAY,EAAE,CAAC;IAE9C;QACE,0EAA0E;QAC1E,mDAAmD;QACnD,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,EAAE,CAAkC,KAAQ,EAAE,QAAmB;QAC/D,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAkC,CAAC,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAkC,KAAQ,EAAE,QAAmB;QACjE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,QAAkC,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAkC,KAAQ,EAAE,QAAmB;QAChE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAkC,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kBAAkB,CAAkC,KAAS;QAC3D,IAAI,KAAK;YAAE,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;;YAC7C,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa,CAAkC,KAAQ;QACrD,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC3C,CAAC;IAES,IAAI,CACZ,KAAQ,EACR,GAAG,IAA2B;QAE9B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,GAAI,IAAkB,CAAC,CAAC;IAC1D,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { ConsensusEngine, CONSENSUS_DEFAULTS, MAX_ROUNDS_CAP } from "./engine.js";
+export { PERSONAS, JUDGE_PERSONA, getPersonaById, getPersonaOrDefault, } from "./personas.js";
+export { buildParticipantSystemPrompt, buildJudgeSystemPrompt, buildJudgeUserPrompt, formatPreviousResponses, getRoundMeta, } from "./prompts.js";
+export { extractConfidence, extractJudgeConfidence, extractJudgeSection, stripConfidenceLine, } from "./parser.js";
+export { average, stddev, consensusScore, detectDisagreements, shuffle, mulberry32, } from "./stats.js";
+export { TypedEventEmitter } from "./events.js";
+export type { ConsensusEmitter } from "./events.js";
+export { PersonaSchema, ParticipantSchema, PHASES } from "./types.js";
+export type { Persona, Participant, Phase, TokenUsage, ModelCaller, ModelCallRequest, ModelCallResponse, ParticipantResponse, Disagreement, RoundResult, SynthesisResult, ConsensusResult, ConsensusOptions, StopReason, ConsensusEventMap, ConsensusEventName, RoundStartEvent, ParticipantStartEvent, ParticipantTokenEvent, ParticipantCompleteEvent, ConfidenceUpdateEvent, DisagreementDetectedEvent, RoundCompleteEvent, EarlyStopEvent, SynthesisStartEvent, SynthesisTokenEvent, SynthesisCompleteEvent, FinalResultEvent, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElF,OAAO,EACL,QAAQ,EACR,aAAa,EACb,cAAc,EACd,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EACvB,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,OAAO,EACP,MAAM,EACN,cAAc,EACd,mBAAmB,EACnB,OAAO,EACP,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAGtE,YAAY,EACV,OAAO,EACP,WAAW,EACX,KAAK,EACL,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,WAAW,EACX,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,UAAU,EAEV,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+// ─────────────────────────────────────────────────────────────
+// ai-consensus-core — public API
+// ─────────────────────────────────────────────────────────────
+export { ConsensusEngine, CONSENSUS_DEFAULTS, MAX_ROUNDS_CAP } from "./engine.js";
+export { PERSONAS, JUDGE_PERSONA, getPersonaById, getPersonaOrDefault, } from "./personas.js";
+export { buildParticipantSystemPrompt, buildJudgeSystemPrompt, buildJudgeUserPrompt, formatPreviousResponses, getRoundMeta, } from "./prompts.js";
+export { extractConfidence, extractJudgeConfidence, extractJudgeSection, stripConfidenceLine, } from "./parser.js";
+export { average, stddev, consensusScore, detectDisagreements, shuffle, mulberry32, } from "./stats.js";
+export { TypedEventEmitter } from "./events.js";
+// Schemas (zod) — exported for callers that want boundary validation.
+export { PersonaSchema, ParticipantSchema, PHASES } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,iCAAiC;AACjC,gEAAgE;AAEhE,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElF,OAAO,EACL,QAAQ,EACR,aAAa,EACb,cAAc,EACd,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,oBAAoB,EACpB,uBAAuB,EACvB,YAAY,GACb,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,OAAO,EACP,MAAM,EACN,cAAc,EACd,mBAAmB,EACnB,OAAO,EACP,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,sEAAsE;AACtE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC"}

package/dist/parser.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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 declare function extractConfidence(text: string): number;
+/**
+ * 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 declare function extractJudgeConfidence(text: string): number;
+/**
+ * Extract a named `## Heading`-style section from a judge synthesis.
+ * Returns the trimmed section body, or "" if not found.
+ */
+export declare function extractJudgeSection(text: string, heading: string): string;
+/**
+ * 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 declare function stripConfidenceLine(text: string): string;
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAOA;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM3D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAKzE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD"}