@cat-factory/consensus 0.6.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Igor Savin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/ConsensusAgentExecutor.d.ts

@@ -0,0 +1,68 @@
+import { type AgentExecutor, type AgentJobHandle, type AgentJobUpdate, type AgentRunContext, type AgentRunResult, type AsyncAgentExecutor, type ConsensusSessionRepository, type ExecutionEventPublisher, type ModelProvider, type ModelProviderResolver, type ModelRef } from '@cat-factory/kernel';
+import { type AgentRouting } from '@cat-factory/agents';
+import type { GenerateFn } from './strategies/types.js';
+export interface ConsensusAgentExecutorDependencies {
+    /**
+     * The standard executor (typically the `CompositeAgentExecutor`) consensus wraps and
+     * DELEGATES to: when a step is not consensus-enabled, or gating marks the task
+     * ineligible, the standard single-actor agent runs exactly as before (preserving the
+     * container/async path for kinds that need a checkout).
+     */
+    standard: AgentExecutor;
+    /** Per-scope model provider (preferred); leases the run's DB-backed API keys. */
+    modelProviderResolver?: ModelProviderResolver;
+    /** Static provider (tests / no pool). One of the two MUST be present. */
+    modelProvider?: ModelProvider;
+    agentRouting: AgentRouting;
+    resolveBlockModel?: (modelId: string | undefined) => ModelRef | undefined;
+    resolveWorkspaceModelDefault?: (workspaceId: string, agentKind: string) => Promise<string | undefined>;
+    /** Persists the session transcript (the observability surface). Optional. */
+    sessionRepository?: ConsensusSessionRepository;
+    /** Pushes live transcript updates to the SPA. Optional. */
+    eventPublisher?: ExecutionEventPublisher;
+    /** Epoch-ms clock; defaults to Date.now. */
+    now?: () => number;
+    /** Structured logger; optional. */
+    logger?: {
+        info(obj: unknown, msg?: string): void;
+        warn?(obj: unknown, msg?: string): void;
+    };
+    /** Inject the LLM call (tests); defaults to the Vercel AI SDK wrapper. */
+    generate?: GenerateFn;
+}
+/**
+ * An {@link AgentExecutor} that runs an eligible, consensus-enabled step through a
+ * multi-model consensus process (specialist panel / debate / ranked voting), persisting
+ * the transcript and returning a normal {@link AgentRunResult} of the SAME shape the
+ * underlying agent kind would have produced — so the rest of the engine is untouched.
+ * Every other step delegates to the wrapped standard executor.
+ */
+export declare class ConsensusAgentExecutor implements AsyncAgentExecutor {
+    private readonly deps;
+    private readonly resolveBlockModel;
+    private readonly now;
+    private readonly generate;
+    constructor(deps: ConsensusAgentExecutorDependencies);
+    /**
+     * Whether this step should actually run consensus (enabled, the kind carries a
+     * consensus capability trait, ≥2 participants, gate passes). The eligibility check
+     * is the runtime backstop for the builder's UI guard: a pipeline crafted via the
+     * API with a consensus config on an INELIGIBLE kind (e.g. the container `coder`,
+     * which must clone/edit/commit/PR) must NOT be diverted to an inline multi-model
+     * panel — it falls through to the standard executor unchanged.
+     */
+    private consensusActive;
+    private providerFor;
+    private baseRef;
+    /** A participant/synthesizer's ref: its pinned model (degraded for inline) else the base ref. */
+    private refForModelId;
+    run(context: AgentRunContext): Promise<AgentRunResult>;
+    private emit;
+    resolveModel(context: AgentRunContext): Promise<string | undefined>;
+    isQuotaBased(context: AgentRunContext): Promise<boolean>;
+    runsAsync(context: AgentRunContext): boolean;
+    startJob(context: AgentRunContext): Promise<AgentJobHandle>;
+    pollJob(handle: AgentJobHandle): Promise<AgentJobUpdate>;
+    stopJob(handle: AgentJobHandle): Promise<void>;
+}
+//# sourceMappingURL=ConsensusAgentExecutor.d.ts.map

package/dist/ConsensusAgentExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConsensusAgentExecutor.d.ts","sourceRoot":"","sources":["../src/ConsensusAgentExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EAGvB,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,QAAQ,EAGd,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACL,KAAK,YAAY,EAMlB,MAAM,qBAAqB,CAAA;AAO5B,OAAO,KAAK,EACV,UAAU,EAIX,MAAM,uBAAuB,CAAA;AAE9B,MAAM,WAAW,kCAAkC;IACjD;;;;;OAKG;IACH,QAAQ,EAAE,aAAa,CAAA;IACvB,iFAAiF;IACjF,qBAAqB,CAAC,EAAE,qBAAqB,CAAA;IAC7C,yEAAyE;IACzE,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,YAAY,EAAE,YAAY,CAAA;IAC1B,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,KAAK,QAAQ,GAAG,SAAS,CAAA;IACzE,4BAA4B,CAAC,EAAE,CAC7B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAChC,6EAA6E;IAC7E,iBAAiB,CAAC,EAAE,0BAA0B,CAAA;IAC9C,2DAA2D;IAC3D,cAAc,CAAC,EAAE,uBAAuB,CAAA;IACxC,4CAA4C;IAC5C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;IAClB,mCAAmC;IACnC,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;IAC5F,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,UAAU,CAAA;CACtB;AAQD;;;;;;GAMG;AACH,qBAAa,sBAAuB,YAAW,kBAAkB;IAC/D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoC;IACzD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAuD;IACzF,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAY;IAErC,YAAY,IAAI,EAAE,kCAAkC,EAQnD;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,eAAe;YAQT,WAAW;IAczB,OAAO,CAAC,OAAO;IAef,iGAAiG;IACjG,OAAO,CAAC,aAAa;IAQf,GAAG,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CA4G3D;YAEa,IAAI;IAcZ,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAOxE;IAED,YAAY,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAIvD;IAKD,SAAS,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAG3C;IAED,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAK1D;IAED,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAKvD;IAEK,OAAO,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAInD;CACF"}

package/dist/ConsensusAgentExecutor.js

@@ -0,0 +1,237 @@
+import { inlineModelRef, isAsyncAgentExecutor, } from '@cat-factory/kernel';
+import { composeBlockSystemPrompt, resolveAgentConfig, resolveInlineModelRef, systemPromptFor, userPromptFor, } from '@cat-factory/agents';
+import { decideConsensusMode } from './gating.js';
+import { isConsensusEligible } from './traits.js';
+import { runSpecialistPanel } from './strategies/specialistPanel.js';
+import { runDebate } from './strategies/debate.js';
+import { runRankedVoting } from './strategies/rankedVoting.js';
+import { defaultGenerate } from './strategies/shared.js';
+const STRATEGIES = {
+    'specialist-panel': runSpecialistPanel,
+    debate: runDebate,
+    'ranked-voting': runRankedVoting,
+};
+/**
+ * An {@link AgentExecutor} that runs an eligible, consensus-enabled step through a
+ * multi-model consensus process (specialist panel / debate / ranked voting), persisting
+ * the transcript and returning a normal {@link AgentRunResult} of the SAME shape the
+ * underlying agent kind would have produced — so the rest of the engine is untouched.
+ * Every other step delegates to the wrapped standard executor.
+ */
+export class ConsensusAgentExecutor {
+    deps;
+    resolveBlockModel;
+    now;
+    generate;
+    constructor(deps) {
+        if (!deps.modelProviderResolver && !deps.modelProvider) {
+            throw new Error('ConsensusAgentExecutor requires a modelProviderResolver or a modelProvider');
+        }
+        this.deps = deps;
+        this.resolveBlockModel = deps.resolveBlockModel ?? (() => undefined);
+        this.now = deps.now ?? (() => Date.now());
+        this.generate = deps.generate ?? defaultGenerate;
+    }
+    /**
+     * Whether this step should actually run consensus (enabled, the kind carries a
+     * consensus capability trait, ≥2 participants, gate passes). The eligibility check
+     * is the runtime backstop for the builder's UI guard: a pipeline crafted via the
+     * API with a consensus config on an INELIGIBLE kind (e.g. the container `coder`,
+     * which must clone/edit/commit/PR) must NOT be diverted to an inline multi-model
+     * panel — it falls through to the standard executor unchanged.
+     */
+    consensusActive(context) {
+        const cfg = context.consensus;
+        if (!cfg || !cfg.enabled)
+            return false;
+        if (!isConsensusEligible(context.agentKind))
+            return false;
+        if (cfg.participants.length < 2)
+            return false;
+        return decideConsensusMode(context.block.estimate, cfg.gating) === 'consensus';
+    }
+    async providerFor(context) {
+        if (this.deps.modelProviderResolver && context.workspaceId) {
+            return this.deps.modelProviderResolver.forScope({
+                workspaceId: context.workspaceId,
+                userId: context.initiatedByUserId,
+            });
+        }
+        if (this.deps.modelProvider)
+            return this.deps.modelProvider;
+        if (this.deps.modelProviderResolver) {
+            return this.deps.modelProviderResolver.forScope({ workspaceId: context.workspaceId ?? '' });
+        }
+        throw new Error('ConsensusAgentExecutor: no model provider available');
+    }
+    baseRef(context) {
+        return resolveInlineModelRef({
+            agentRouting: this.deps.agentRouting,
+            resolveBlockModel: this.resolveBlockModel,
+            resolveWorkspaceModelDefault: this.deps.resolveWorkspaceModelDefault,
+        }, {
+            agentKind: context.agentKind,
+            blockModelId: context.block.modelId,
+            workspaceId: context.workspaceId,
+        });
+    }
+    /** A participant/synthesizer's ref: its pinned model (degraded for inline) else the base ref. */
+    refForModelId(modelId, base) {
+        if (modelId) {
+            const pinned = this.resolveBlockModel(modelId);
+            if (pinned)
+                return inlineModelRef(pinned, base);
+        }
+        return base;
+    }
+    async run(context) {
+        if (!this.consensusActive(context))
+            return this.deps.standard.run(context);
+        const cfg = context.consensus;
+        const provider = await this.providerFor(context);
+        const base = await this.baseRef(context);
+        const config = resolveAgentConfig(this.deps.agentRouting, context.agentKind);
+        const baseSystem = composeBlockSystemPrompt(config.system ?? systemPromptFor(context.agentKind), context.block);
+        const goalPrompt = userPromptFor(context);
+        const participants = cfg.participants.map((p) => {
+            const ref = this.refForModelId(p.modelId, base);
+            return {
+                id: p.id,
+                role: p.role,
+                ...(p.systemFraming ? { systemFraming: p.systemFraming } : {}),
+                model: provider.resolve(ref),
+                modelLabel: `${ref.provider}:${ref.model}`,
+            };
+        });
+        const synthRef = this.refForModelId(cfg.synthesizerModelId, base);
+        const synthesizer = {
+            model: provider.resolve(synthRef),
+            modelLabel: `${synthRef.provider}:${synthRef.model}`,
+        };
+        const session = {
+            id: `cns_${context.executionId ?? 'x'}_${context.stepIndex}`,
+            blockId: context.block.id ?? '',
+            executionId: context.executionId ?? null,
+            stepIndex: context.stepIndex,
+            agentKind: context.agentKind,
+            strategy: cfg.strategy,
+            status: 'running',
+            participants: cfg.participants,
+            rounds: [],
+            synthesis: null,
+            confidence: null,
+            dissent: [],
+            error: null,
+            createdAt: this.now(),
+            updatedAt: this.now(),
+        };
+        await this.emit(context, session);
+        this.deps.logger?.info({
+            msg: 'consensus.start',
+            strategy: cfg.strategy,
+            agentKind: context.agentKind,
+            participants: participants.length,
+            executionId: context.executionId,
+            stepIndex: context.stepIndex,
+        }, 'consensus session started');
+        const tags = {
+            agentKind: context.agentKind,
+            workspaceId: context.workspaceId,
+            executionId: context.executionId,
+        };
+        try {
+            const result = await STRATEGIES[cfg.strategy]({
+                agentKind: context.agentKind,
+                baseSystem,
+                goalPrompt,
+                participants,
+                synthesizer,
+                rounds: cfg.rounds ?? 2,
+                generate: this.generate,
+                tags,
+                onProgress: async (update) => {
+                    session.rounds = update.rounds;
+                    session.status = update.status;
+                    session.updatedAt = this.now();
+                    await this.emit(context, session);
+                },
+            });
+            session.rounds = result.rounds;
+            session.synthesis = result.synthesis;
+            session.confidence = result.confidence;
+            session.dissent = result.dissent;
+            session.status = 'done';
+            session.updatedAt = this.now();
+            await this.emit(context, session);
+            this.deps.logger?.info({ msg: 'consensus.done', strategy: cfg.strategy, confidence: result.confidence }, 'consensus session complete');
+            return {
+                output: result.synthesis,
+                model: `consensus:${cfg.strategy}:${synthesizer.modelLabel}`,
+                usage: result.usage,
+            };
+        }
+        catch (error) {
+            session.status = 'failed';
+            session.error = error instanceof Error ? error.message : String(error);
+            session.updatedAt = this.now();
+            await this.emit(context, session);
+            this.deps.logger?.warn?.({ msg: 'consensus.failed', error: session.error }, 'consensus session failed');
+            throw error;
+        }
+    }
+    async emit(context, session) {
+        if (!context.workspaceId)
+            return;
+        try {
+            await this.deps.sessionRepository?.upsert(context.workspaceId, session);
+        }
+        catch {
+            // Persistence is best-effort observability; never wedge the run.
+        }
+        try {
+            await this.deps.eventPublisher?.consensusSessionChanged?.(context.workspaceId, session);
+        }
+        catch {
+            // Push is best-effort.
+        }
+    }
+    async resolveModel(context) {
+        if (!this.consensusActive(context)) {
+            return this.deps.standard.resolveModel?.(context) ?? Promise.resolve(undefined);
+        }
+        const base = await this.baseRef(context);
+        const ref = this.refForModelId(context.consensus.synthesizerModelId, base);
+        return `consensus:${context.consensus.strategy}:${ref.provider}:${ref.model}`;
+    }
+    isQuotaBased(context) {
+        // Consensus makes metered inline calls; only the delegated path can be quota-based.
+        if (this.consensusActive(context))
+            return Promise.resolve(false);
+        return this.deps.standard.isQuotaBased?.(context) ?? Promise.resolve(false);
+    }
+    // --- Async delegation: only ever reached for non-consensus (delegated) steps, since
+    // `runsAsync` returns false while consensus is active (forcing the engine's inline path).
+    runsAsync(context) {
+        if (this.consensusActive(context))
+            return false;
+        return isAsyncAgentExecutor(this.deps.standard) && this.deps.standard.runsAsync(context);
+    }
+    startJob(context) {
+        if (!isAsyncAgentExecutor(this.deps.standard)) {
+            throw new Error(`No async executor for agent kind '${context.agentKind}'`);
+        }
+        return this.deps.standard.startJob(context);
+    }
+    pollJob(handle) {
+        if (!isAsyncAgentExecutor(this.deps.standard)) {
+            throw new Error('Wrapped executor does not support async jobs');
+        }
+        return this.deps.standard.pollJob(handle);
+    }
+    async stopJob(handle) {
+        if (isAsyncAgentExecutor(this.deps.standard) && this.deps.standard.stopJob) {
+            await this.deps.standard.stopJob(handle);
+        }
+    }
+}
+//# sourceMappingURL=ConsensusAgentExecutor.js.map

package/dist/ConsensusAgentExecutor.js.map

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

package/dist/gating.d.ts

@@ -0,0 +1,15 @@
+import type { ConsensusGating, TaskEstimate } from '@cat-factory/kernel';
+export type ConsensusMode = 'consensus' | 'standard';
+/**
+ * Decide whether to run consensus given the task estimate and the step's gating config.
+ *
+ *  - No gating / gating disabled → always `consensus` (the user opted in unconditionally).
+ *  - Gating enabled, estimate present → `consensus` iff ANY supplied axis is met or
+ *    exceeded (risk ≥ minRisk OR impact ≥ minImpact OR complexity ≥ minComplexity).
+ *    A gating block with no thresholds set never triggers on score (so it falls to
+ *    `standard`) — configuring gating means you must give it at least one bar.
+ *  - Gating enabled, estimate absent → `gating.onMissingEstimate` (default `consensus`,
+ *    fail-safe to thoroughness: we couldn't prove the task is low-stakes).
+ */
+export declare function decideConsensusMode(estimate: TaskEstimate | null | undefined, gating: ConsensusGating | undefined): ConsensusMode;
+//# sourceMappingURL=gating.d.ts.map

package/dist/gating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gating.d.ts","sourceRoot":"","sources":["../src/gating.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAMxE,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,UAAU,CAAA;AAEpD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,EACzC,MAAM,EAAE,eAAe,GAAG,SAAS,GAClC,aAAa,CAaf"}

package/dist/gating.js

@@ -0,0 +1,28 @@
+/**
+ * Decide whether to run consensus given the task estimate and the step's gating config.
+ *
+ *  - No gating / gating disabled → always `consensus` (the user opted in unconditionally).
+ *  - Gating enabled, estimate present → `consensus` iff ANY supplied axis is met or
+ *    exceeded (risk ≥ minRisk OR impact ≥ minImpact OR complexity ≥ minComplexity).
+ *    A gating block with no thresholds set never triggers on score (so it falls to
+ *    `standard`) — configuring gating means you must give it at least one bar.
+ *  - Gating enabled, estimate absent → `gating.onMissingEstimate` (default `consensus`,
+ *    fail-safe to thoroughness: we couldn't prove the task is low-stakes).
+ */
+export function decideConsensusMode(estimate, gating) {
+    if (!gating || !gating.enabled)
+        return 'consensus';
+    if (!estimate)
+        return gating.onMissingEstimate ?? 'consensus';
+    const axes = [
+        [gating.minComplexity, estimate.complexity],
+        [gating.minRisk, estimate.risk],
+        [gating.minImpact, estimate.impact],
+    ];
+    for (const [threshold, value] of axes) {
+        if (threshold !== undefined && value >= threshold)
+            return 'consensus';
+    }
+    return 'standard';
+}
+//# sourceMappingURL=gating.js.map

package/dist/gating.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gating.js","sourceRoot":"","sources":["../src/gating.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAyC,EACzC,MAAmC;IAEnC,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,WAAW,CAAA;IAClD,IAAI,CAAC,QAAQ;QAAE,OAAO,MAAM,CAAC,iBAAiB,IAAI,WAAW,CAAA;IAE7D,MAAM,IAAI,GAAwC;QAChD,CAAC,MAAM,CAAC,aAAa,EAAE,QAAQ,CAAC,UAAU,CAAC;QAC3C,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC;QAC/B,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC;KACpC,CAAA;IACD,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;QACtC,IAAI,SAAS,KAAK,SAAS,IAAI,KAAK,IAAI,SAAS;YAAE,OAAO,WAAW,CAAA;IACvE,CAAC;IACD,OAAO,UAAU,CAAA;AACnB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { ConsensusAgentExecutor, type ConsensusAgentExecutorDependencies, } from './ConsensusAgentExecutor.js';
+export { decideConsensusMode, type ConsensusMode } from './gating.js';
+export { SPECIALIST_PANEL_CAPABLE, DEBATE_CAPABLE, RANKED_VOTING_CAPABLE, CONSENSUS_TRAITS, STRATEGY_TRAIT, DEFAULT_CONSENSUS_ELIGIBLE_KINDS, registerConsensusTraits, consensusStrategiesFor, isConsensusEligible, } from './traits.js';
+export { runSpecialistPanel } from './strategies/specialistPanel.js';
+export { runDebate } from './strategies/debate.js';
+export { runRankedVoting, parseScoreMap } from './strategies/rankedVoting.js';
+export { defaultGenerate } from './strategies/shared.js';
+export type { ConsensusUsage, GenerateArgs, GenerateFn, GenerateResult, ObsTags, ResolvedParticipant, StrategyInput, StrategyResult, } from './strategies/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,EACL,sBAAsB,EACtB,KAAK,kCAAkC,GACxC,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AACrE,OAAO,EACL,wBAAwB,EACxB,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,gCAAgC,EAChC,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAClD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,YAAY,EACV,cAAc,EACd,YAAY,EACZ,UAAU,EACV,cAAc,EACd,OAAO,EACP,mBAAmB,EACnB,aAAa,EACb,cAAc,GACf,MAAM,uBAAuB,CAAA"}

package/dist/index.js

@@ -0,0 +1,11 @@
+// @cat-factory/consensus — the optional consensus-orchestration mechanism. A deployment
+// mixes it in as a dependency and wires `ConsensusAgentExecutor` (wrapping the standard
+// composite) into each runtime facade; without it the product runs exactly as before.
+export { ConsensusAgentExecutor, } from './ConsensusAgentExecutor.js';
+export { decideConsensusMode } from './gating.js';
+export { SPECIALIST_PANEL_CAPABLE, DEBATE_CAPABLE, RANKED_VOTING_CAPABLE, CONSENSUS_TRAITS, STRATEGY_TRAIT, DEFAULT_CONSENSUS_ELIGIBLE_KINDS, registerConsensusTraits, consensusStrategiesFor, isConsensusEligible, } from './traits.js';
+export { runSpecialistPanel } from './strategies/specialistPanel.js';
+export { runDebate } from './strategies/debate.js';
+export { runRankedVoting, parseScoreMap } from './strategies/rankedVoting.js';
+export { defaultGenerate } from './strategies/shared.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,wFAAwF;AACxF,wFAAwF;AACxF,sFAAsF;AAEtF,OAAO,EACL,sBAAsB,GAEvB,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAAE,mBAAmB,EAAsB,MAAM,aAAa,CAAA;AACrE,OAAO,EACL,wBAAwB,EACxB,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,gCAAgC,EAChC,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAClD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/strategies/debate.d.ts

@@ -0,0 +1,9 @@
+import type { StrategyInput, StrategyResult } from './types.js';
+/**
+ * Debate: an initial independent draft round, then `rounds-1` critique rounds in which
+ * each participant sees the ANONYMIZED latest peer arguments and revises its own position
+ * (defending or conceding on the merits), and finally a neutral judge synthesizes the last
+ * round. Independence first, anonymized exposure, explicit disagreement, capped rounds.
+ */
+export declare function runDebate(input: StrategyInput): Promise<StrategyResult>;
+//# sourceMappingURL=debate.d.ts.map

package/dist/strategies/debate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debate.d.ts","sourceRoot":"","sources":["../../src/strategies/debate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAuC,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AASpG;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CA+D7E"}

package/dist/strategies/debate.js

@@ -0,0 +1,75 @@
+import { SYNTHESIZER_SYSTEM, participantSystem, renderAnonymized, sumUsage, synthesisPrompt, } from './shared.js';
+/**
+ * Debate: an initial independent draft round, then `rounds-1` critique rounds in which
+ * each participant sees the ANONYMIZED latest peer arguments and revises its own position
+ * (defending or conceding on the merits), and finally a neutral judge synthesizes the last
+ * round. Independence first, anonymized exposure, explicit disagreement, capped rounds.
+ */
+export async function runDebate(input) {
+    const { participants, baseSystem, goalPrompt, generate, tags } = input;
+    const totalRounds = Math.max(1, Math.min(5, Math.floor(input.rounds || 2)));
+    const rounds = [];
+    const usageParts = [];
+    // Round 0 — independent drafts, in parallel.
+    let latest = await Promise.all(participants.map(async (p) => {
+        const { text, usage } = await generate({
+            model: p.model,
+            system: participantSystem(baseSystem, p),
+            prompt: goalPrompt,
+            temperature: 0.7,
+            tags,
+        });
+        usageParts.push(usage);
+        return { participantId: p.id, text };
+    }));
+    rounds.push({ index: 0, kind: 'draft', contributions: latest });
+    await input.onProgress?.({ rounds: [...rounds], status: 'running' });
+    // Critique rounds — each participant revises after reading the anonymized peers.
+    for (let r = 1; r < totalRounds; r++) {
+        const priorByParticipant = new Map(latest.map((c) => [c.participantId, c]));
+        const next = await Promise.all(participants.map(async (p) => {
+            const peers = latest.filter((c) => c.participantId !== p.id);
+            const ownPrior = priorByParticipant.get(p.id)?.text ?? '';
+            const prompt = debateCritiquePrompt(goalPrompt, ownPrior, peers, participants);
+            const { text, usage } = await generate({
+                model: p.model,
+                system: participantSystem(baseSystem, p),
+                prompt,
+                temperature: 0.5,
+                tags,
+            });
+            usageParts.push(usage);
+            return { participantId: p.id, text };
+        }));
+        latest = next;
+        rounds.push({ index: r, kind: 'critique', contributions: next });
+        await input.onProgress?.({ rounds: [...rounds], status: 'running' });
+    }
+    await input.onProgress?.({ rounds: [...rounds], status: 'synthesizing' });
+    const rendered = renderAnonymized(latest, participants);
+    const { text: synthesis, usage: synthUsage } = await generate({
+        model: input.synthesizer.model,
+        system: SYNTHESIZER_SYSTEM,
+        prompt: synthesisPrompt(goalPrompt, rendered, 'These are the experts’ final positions after debate. Produce the single best final result now, in exactly the format the task requires.'),
+        temperature: 0.2,
+        tags,
+    });
+    usageParts.push(synthUsage);
+    return { rounds, synthesis, confidence: null, dissent: [], usage: sumUsage(usageParts) };
+}
+function debateCritiquePrompt(goalPrompt, ownPrior, peers, participants) {
+    return [
+        'TASK:',
+        goalPrompt,
+        '',
+        'Your previous answer:',
+        ownPrior || '(none)',
+        '',
+        'Other experts answered the same task as follows (anonymized):',
+        '',
+        renderAnonymized(peers, participants),
+        '',
+        'Critique their reasoning and reconsider your own. Where a peer is more correct, adopt it; where you are right, defend it with evidence. Then give your improved, complete answer to the task (not just the diff).',
+    ].join('\n');
+}
+//# sourceMappingURL=debate.js.map

package/dist/strategies/debate.js.map

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

package/dist/strategies/rankedVoting.d.ts

@@ -0,0 +1,12 @@
+import type { StrategyInput, StrategyResult } from './types.js';
+/**
+ * Ranked voting / scoring: each participant produces an independent candidate answer,
+ * then every participant scores ALL candidates (0..1) against the task; scores are
+ * aggregated deterministically (mean) and the highest-rated candidate wins. The winning
+ * candidate becomes the result, the mean is the confidence, and a near-tie is reported as
+ * dissent. Independence first; peer scoring is anonymized; aggregation is deterministic.
+ */
+export declare function runRankedVoting(input: StrategyInput): Promise<StrategyResult>;
+/** Tolerant parse of a `{ "Expert A": 0.8, ... }` score map; clamps to [0,1]. */
+export declare function parseScoreMap(text: string, labels: string[]): Record<string, number>;
+//# sourceMappingURL=rankedVoting.d.ts.map

package/dist/strategies/rankedVoting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rankedVoting.d.ts","sourceRoot":"","sources":["../../src/strategies/rankedVoting.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAkB,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAG/E;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAqEnF;AAiBD,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkBpF"}

package/dist/strategies/rankedVoting.js

@@ -0,0 +1,108 @@
+import { anonLabel, participantSystem, renderAnonymized, sumUsage } from './shared.js';
+/**
+ * Ranked voting / scoring: each participant produces an independent candidate answer,
+ * then every participant scores ALL candidates (0..1) against the task; scores are
+ * aggregated deterministically (mean) and the highest-rated candidate wins. The winning
+ * candidate becomes the result, the mean is the confidence, and a near-tie is reported as
+ * dissent. Independence first; peer scoring is anonymized; aggregation is deterministic.
+ */
+export async function runRankedVoting(input) {
+    const { participants, baseSystem, goalPrompt, generate, tags } = input;
+    const usageParts = [];
+    // Round 0 — independent candidates, in parallel.
+    const candidates = await Promise.all(participants.map(async (p) => {
+        const { text, usage } = await generate({
+            model: p.model,
+            system: participantSystem(baseSystem, p),
+            prompt: goalPrompt,
+            temperature: 0.7,
+            tags,
+        });
+        usageParts.push(usage);
+        return { participantId: p.id, text };
+    }));
+    const draftRound = { index: 0, kind: 'draft', contributions: candidates };
+    await input.onProgress?.({ rounds: [draftRound], status: 'running' });
+    const labels = participants.map((_, i) => anonLabel(i));
+    const rendered = renderAnonymized(candidates, participants);
+    // Round 1 — each participant scores every candidate 0..1.
+    const scoreContributions = await Promise.all(participants.map(async (p) => {
+        const { text, usage } = await generate({
+            model: p.model,
+            system: participantSystem(baseSystem, p),
+            prompt: scorePrompt(goalPrompt, rendered, labels),
+            temperature: 0.1,
+            tags,
+        });
+        usageParts.push(usage);
+        const map = parseScoreMap(text, labels);
+        const scores = labels.map((label) => ({
+            dimension: label,
+            value: map[label] ?? 0,
+        }));
+        return { participantId: p.id, text, scores };
+    }));
+    const scoreRound = { index: 1, kind: 'score', contributions: scoreContributions };
+    await input.onProgress?.({ rounds: [draftRound, scoreRound], status: 'synthesizing' });
+    // Deterministic aggregation: mean score per candidate across all scorers.
+    const means = labels.map((label) => {
+        const vals = scoreContributions
+            .map((c) => c.scores?.find((s) => s.dimension === label)?.value)
+            .filter((v) => typeof v === 'number');
+        return vals.length ? vals.reduce((a, b) => a + b, 0) / vals.length : 0;
+    });
+    let winner = 0;
+    for (let i = 1; i < means.length; i++)
+        if (means[i] > means[winner])
+            winner = i;
+    const sorted = [...means].sort((a, b) => b - a);
+    const dissent = sorted.length >= 2 && sorted[0] - sorted[1] < 0.1
+        ? [`Close vote: top candidates scored ${sorted[0].toFixed(2)} vs ${sorted[1].toFixed(2)}.`]
+        : [];
+    return {
+        rounds: [draftRound, scoreRound],
+        synthesis: candidates[winner]?.text ?? '',
+        confidence: means[winner] ?? null,
+        dissent,
+        usage: sumUsage(usageParts),
+    };
+}
+function scorePrompt(goalPrompt, rendered, labels) {
+    return [
+        'TASK:',
+        goalPrompt,
+        '',
+        'Candidate answers from independent experts (anonymized):',
+        '',
+        rendered,
+        '',
+        `Score how well EACH candidate solves the task, from 0 (poor) to 1 (excellent). Be discriminating. Respond with ONLY a JSON object mapping each label to its score, e.g. {${labels
+            .map((l) => `"${l}":0.0`)
+            .join(',')}} — no prose, no code fences.`,
+    ].join('\n');
+}
+/** Tolerant parse of a `{ "Expert A": 0.8, ... }` score map; clamps to [0,1]. */
+export function parseScoreMap(text, labels) {
+    const start = text.indexOf('{');
+    const end = text.lastIndexOf('}');
+    const out = {};
+    if (start === -1 || end <= start)
+        return out;
+    let raw;
+    try {
+        raw = JSON.parse(text.slice(start, end + 1));
+    }
+    catch {
+        return out;
+    }
+    if (!raw || typeof raw !== 'object')
+        return out;
+    const obj = raw;
+    for (const label of labels) {
+        const v = obj[label];
+        if (typeof v === 'number' && Number.isFinite(v))
+            out[label] = Math.max(0, Math.min(1, v));
+    }
+    return out;
+}
+//# sourceMappingURL=rankedVoting.js.map

package/dist/strategies/rankedVoting.js.map

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

package/dist/strategies/shared.d.ts

@@ -0,0 +1,25 @@
+import type { ConsensusContribution } from '@cat-factory/kernel';
+import type { ConsensusUsage, GenerateFn, ResolvedParticipant } from './types.js';
+/** The default LLM call: a one-shot `generateText` tagged for the observability sink. */
+export declare const defaultGenerate: GenerateFn;
+export declare const ZERO_USAGE: ConsensusUsage;
+export declare function addUsage(a: ConsensusUsage, b: ConsensusUsage): ConsensusUsage;
+export declare function sumUsage(parts: ConsensusUsage[]): ConsensusUsage;
+/** Stable anonymous label for a participant index, so peers can't anchor on identity. */
+export declare function anonLabel(index: number): string;
+/** The per-participant system prompt: base role + their distinct perspective framing. */
+export declare function participantSystem(base: string, participant: ResolvedParticipant): string;
+/**
+ * Render a set of contributions anonymously for a critique/synthesis prompt. `participants`
+ * provides the index order so labels are stable across rounds.
+ */
+export declare function renderAnonymized(contributions: ConsensusContribution[], participants: ResolvedParticipant[]): string;
+/** The neutral synthesizer/judge system prompt. */
+export declare const SYNTHESIZER_SYSTEM: string;
+/**
+ * Build the synthesizer prompt: the original goal plus the anonymized contributions to
+ * merge. `formatReminder` re-states the required output format (e.g. JSON for an
+ * estimator) so the synthesis stays consumable by the engine.
+ */
+export declare function synthesisPrompt(goalPrompt: string, rendered: string, formatReminder: string): string;
+//# sourceMappingURL=shared.d.ts.map

package/dist/strategies/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/strategies/shared.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAChE,OAAO,KAAK,EACV,cAAc,EAEd,UAAU,EAEV,mBAAmB,EACpB,MAAM,YAAY,CAAA;AAMnB,yFAAyF;AACzF,eAAO,MAAM,eAAe,EAAE,UAiB7B,CAAA;AAED,eAAO,MAAM,UAAU,EAAE,cAAoD,CAAA;AAE7E,wBAAgB,QAAQ,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,cAAc,GAAG,cAAc,CAK7E;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,cAAc,CAEhE;AAED,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,yFAAyF;AACzF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB,GAAG,MAAM,CAGxF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,qBAAqB,EAAE,EACtC,YAAY,EAAE,mBAAmB,EAAE,GAClC,MAAM,CAOR;AAED,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,QAKpB,CAAA;AAEX;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GACrB,MAAM,CAWR"}

package/dist/strategies/shared.js

@@ -0,0 +1,81 @@
+import { generateText } from 'ai';
+import { catFactoryObservability } from '@cat-factory/kernel';
+// Shared helpers for the consensus strategies: the default Vercel-AI-SDK `generate`
+// implementation, usage accumulation, anonymization (so peers judge ideas, not authors),
+// and the participant/synthesizer prompt builders that encode the debate best-practices.
+/** The default LLM call: a one-shot `generateText` tagged for the observability sink. */
+export const defaultGenerate = async (args) => {
+    const { text, usage } = await generateText({
+        model: args.model,
+        system: args.system,
+        prompt: args.prompt,
+        ...(args.temperature !== undefined ? { temperature: args.temperature } : {}),
+        ...(args.maxOutputTokens !== undefined ? { maxOutputTokens: args.maxOutputTokens } : {}),
+        providerOptions: catFactoryObservability({
+            agentKind: args.tags.agentKind,
+            workspaceId: args.tags.workspaceId,
+            executionId: args.tags.executionId,
+        }),
+    });
+    return {
+        text: text.trim(),
+        usage: { inputTokens: usage.inputTokens ?? 0, outputTokens: usage.outputTokens ?? 0 },
+    };
+};
+export const ZERO_USAGE = { inputTokens: 0, outputTokens: 0 };
+export function addUsage(a, b) {
+    return {
+        inputTokens: a.inputTokens + b.inputTokens,
+        outputTokens: a.outputTokens + b.outputTokens,
+    };
+}
+export function sumUsage(parts) {
+    return parts.reduce(addUsage, ZERO_USAGE);
+}
+/** Stable anonymous label for a participant index, so peers can't anchor on identity. */
+export function anonLabel(index) {
+    return `Expert ${String.fromCharCode(65 + (index % 26))}`;
+}
+/** The per-participant system prompt: base role + their distinct perspective framing. */
+export function participantSystem(base, participant) {
+    if (!participant.systemFraming)
+        return base;
+    return `${base}\n\nYour assigned perspective as the "${participant.role}": ${participant.systemFraming}\nArgue your perspective rigorously and honestly; do not merely agree.`;
+}
+/**
+ * Render a set of contributions anonymously for a critique/synthesis prompt. `participants`
+ * provides the index order so labels are stable across rounds.
+ */
+export function renderAnonymized(contributions, participants) {
+    return contributions
+        .map((c) => {
+        const idx = participants.findIndex((p) => p.id === c.participantId);
+        return `### ${anonLabel(idx < 0 ? 0 : idx)}\n${c.text}`;
+    })
+        .join('\n\n');
+}
+/** The neutral synthesizer/judge system prompt. */
+export const SYNTHESIZER_SYSTEM = [
+    'You are a neutral synthesizer chairing a panel of independent experts who each tackled the SAME task.',
+    'Your job is to produce ONE final, polished result that is better than any single contribution.',
+    'Combine the strongest, best-justified points; resolve contradictions on the merits (not by vote-counting or splitting the difference); and silently drop weak or unsupported claims.',
+    'Do not mention the experts, the panel, or that a synthesis occurred — output only the final result itself, in exactly the format the task requires.',
+].join(' ');
+/**
+ * Build the synthesizer prompt: the original goal plus the anonymized contributions to
+ * merge. `formatReminder` re-states the required output format (e.g. JSON for an
+ * estimator) so the synthesis stays consumable by the engine.
+ */
+export function synthesisPrompt(goalPrompt, rendered, formatReminder) {
+    return [
+        'TASK:',
+        goalPrompt,
+        '',
+        'The independent expert responses to merge:',
+        '',
+        rendered,
+        '',
+        formatReminder,
+    ].join('\n');
+}
+//# sourceMappingURL=shared.js.map

package/dist/strategies/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/strategies/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAA;AACjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAU7D,oFAAoF;AACpF,yFAAyF;AACzF,yFAAyF;AAEzF,yFAAyF;AACzF,MAAM,CAAC,MAAM,eAAe,GAAe,KAAK,EAAE,IAAkB,EAA2B,EAAE;IAC/F,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,YAAY,CAAC;QACzC,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,GAAG,CAAC,IAAI,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,eAAe,EAAE,uBAAuB,CAAC;YACvC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS;YAC9B,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW;YAClC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW;SACnC,CAAC;KACH,CAAC,CAAA;IACF,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;QACjB,KAAK,EAAE,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,CAAC,EAAE;KACtF,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAmB,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAA;AAE7E,MAAM,UAAU,QAAQ,CAAC,CAAiB,EAAE,CAAiB;IAC3D,OAAO;QACL,WAAW,EAAE,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW;QAC1C,YAAY,EAAE,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY;KAC9C,CAAA;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAuB;IAC9C,OAAO,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAA;AAC3C,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,UAAU,MAAM,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,EAAE,CAAA;AAC3D,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,WAAgC;IAC9E,IAAI,CAAC,WAAW,CAAC,aAAa;QAAE,OAAO,IAAI,CAAA;IAC3C,OAAO,GAAG,IAAI,yCAAyC,WAAW,CAAC,IAAI,MAAM,WAAW,CAAC,aAAa,wEAAwE,CAAA;AAChL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,aAAsC,EACtC,YAAmC;IAEnC,OAAO,aAAa;SACjB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,GAAG,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,aAAa,CAAC,CAAA;QACnE,OAAO,OAAO,SAAS,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAA;IACzD,CAAC,CAAC;SACD,IAAI,CAAC,MAAM,CAAC,CAAA;AACjB,CAAC;AAED,mDAAmD;AACnD,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,uGAAuG;IACvG,gGAAgG;IAChG,sLAAsL;IACtL,qJAAqJ;CACtJ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAEX;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,UAAkB,EAClB,QAAgB,EAChB,cAAsB;IAEtB,OAAO;QACL,OAAO;QACP,UAAU;QACV,EAAE;QACF,4CAA4C;QAC5C,EAAE;QACF,QAAQ;QACR,EAAE;QACF,cAAc;KACf,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC"}

package/dist/strategies/specialistPanel.d.ts

@@ -0,0 +1,9 @@
+import type { StrategyInput, StrategyResult } from './types.js';
+/**
+ * Specialist panel: every participant answers the goal INDEPENDENTLY and in parallel
+ * (blind to each other — no anchoring/groupthink), then a neutral synthesizer merges the
+ * drafts into one polished result. The single highest-leverage consensus shape: diversity
+ * of role + model, independence before exposure, neutral synthesis.
+ */
+export declare function runSpecialistPanel(input: StrategyInput): Promise<StrategyResult>;
+//# sourceMappingURL=specialistPanel.d.ts.map

package/dist/strategies/specialistPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specialistPanel.d.ts","sourceRoot":"","sources":["../../src/strategies/specialistPanel.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAS/D;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CA2CtF"}

package/dist/strategies/specialistPanel.js

@@ -0,0 +1,42 @@
+import { SYNTHESIZER_SYSTEM, participantSystem, renderAnonymized, sumUsage, synthesisPrompt, } from './shared.js';
+/**
+ * Specialist panel: every participant answers the goal INDEPENDENTLY and in parallel
+ * (blind to each other — no anchoring/groupthink), then a neutral synthesizer merges the
+ * drafts into one polished result. The single highest-leverage consensus shape: diversity
+ * of role + model, independence before exposure, neutral synthesis.
+ */
+export async function runSpecialistPanel(input) {
+    const { participants, baseSystem, goalPrompt, generate, tags } = input;
+    const drafts = await Promise.all(participants.map(async (p) => {
+        const { text, usage } = await generate({
+            model: p.model,
+            system: participantSystem(baseSystem, p),
+            prompt: goalPrompt,
+            temperature: 0.7,
+            tags,
+        });
+        return { contribution: { participantId: p.id, text }, usage };
+    }));
+    const draftRound = {
+        index: 0,
+        kind: 'draft',
+        contributions: drafts.map((d) => d.contribution),
+    };
+    await input.onProgress?.({ rounds: [draftRound], status: 'synthesizing' });
+    const rendered = renderAnonymized(draftRound.contributions, participants);
+    const { text: synthesis, usage: synthUsage } = await generate({
+        model: input.synthesizer.model,
+        system: SYNTHESIZER_SYSTEM,
+        prompt: synthesisPrompt(goalPrompt, rendered, 'Produce the single best final result now, in exactly the format the task requires.'),
+        temperature: 0.2,
+        tags,
+    });
+    return {
+        rounds: [draftRound],
+        synthesis,
+        confidence: null,
+        dissent: [],
+        usage: sumUsage([...drafts.map((d) => d.usage), synthUsage]),
+    };
+}
+//# sourceMappingURL=specialistPanel.js.map

package/dist/strategies/specialistPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specialistPanel.js","sourceRoot":"","sources":["../../src/strategies/specialistPanel.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,QAAQ,EACR,eAAe,GAChB,MAAM,aAAa,CAAA;AAEpB;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAAoB;IAC3D,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,KAAK,CAAA;IAEtE,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAC3B,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC;YACrC,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,iBAAiB,CAAC,UAAU,EAAE,CAAC,CAAC;YACxC,MAAM,EAAE,UAAU;YAClB,WAAW,EAAE,GAAG;YAChB,IAAI;SACL,CAAC,CAAA;QACF,OAAO,EAAE,YAAY,EAAE,EAAE,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAA2B,EAAE,KAAK,EAAE,CAAA;IACxF,CAAC,CAAC,CACH,CAAA;IAED,MAAM,UAAU,GAAmB;QACjC,KAAK,EAAE,CAAC;QACR,IAAI,EAAE,OAAO;QACb,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC;KACjD,CAAA;IACD,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAA;IAE1E,MAAM,QAAQ,GAAG,gBAAgB,CAAC,UAAU,CAAC,aAAa,EAAE,YAAY,CAAC,CAAA;IACzE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,QAAQ,CAAC;QAC5D,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,KAAK;QAC9B,MAAM,EAAE,kBAAkB;QAC1B,MAAM,EAAE,eAAe,CACrB,UAAU,EACV,QAAQ,EACR,oFAAoF,CACrF;QACD,WAAW,EAAE,GAAG;QAChB,IAAI;KACL,CAAC,CAAA;IAEF,OAAO;QACL,MAAM,EAAE,CAAC,UAAU,CAAC;QACpB,SAAS;QACT,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,EAAE;QACX,KAAK,EAAE,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,CAAC;KAC7D,CAAA;AACH,CAAC"}

package/dist/strategies/types.d.ts

@@ -0,0 +1,71 @@
+import type { LanguageModel } from 'ai';
+import type { ConsensusRound, ConsensusSessionStatus } from '@cat-factory/kernel';
+/** Token usage accumulated across a strategy's LLM calls. */
+export interface ConsensusUsage {
+    inputTokens: number;
+    outputTokens: number;
+}
+/** A participant with its model resolved to a concrete handle. */
+export interface ResolvedParticipant {
+    id: string;
+    role: string;
+    systemFraming?: string;
+    model: LanguageModel;
+    /** `provider:model`, for the transcript + synthesizer label. */
+    modelLabel: string;
+}
+/** Observability tags threaded into every sub-call's provider options. */
+export interface ObsTags {
+    agentKind: string;
+    workspaceId?: string;
+    executionId?: string;
+}
+export interface GenerateArgs {
+    model: LanguageModel;
+    system: string;
+    prompt: string;
+    temperature?: number;
+    maxOutputTokens?: number;
+    tags: ObsTags;
+}
+export interface GenerateResult {
+    text: string;
+    usage: ConsensusUsage;
+}
+/** Inject the LLM call so strategies stay testable; defaults to {@link defaultGenerate}. */
+export type GenerateFn = (args: GenerateArgs) => Promise<GenerateResult>;
+export interface StrategyInput {
+    agentKind: string;
+    /** The base role/system prompt of the underlying agent kind. */
+    baseSystem: string;
+    /** The user prompt describing the goal (the same one the standard agent would get). */
+    goalPrompt: string;
+    participants: ResolvedParticipant[];
+    synthesizer: {
+        model: LanguageModel;
+        modelLabel: string;
+    };
+    /** Debate rounds (incl. the initial draft); clamped/ignored by non-debate strategies. */
+    rounds: number;
+    generate: GenerateFn;
+    tags: ObsTags;
+    /**
+     * Stream progress so the executor can persist + push the live transcript after each
+     * round / on synthesis. Best-effort; failures are swallowed by the executor's wiring.
+     */
+    onProgress?: (update: {
+        rounds: ConsensusRound[];
+        status: ConsensusSessionStatus;
+    }) => Promise<void>;
+}
+export interface StrategyResult {
+    rounds: ConsensusRound[];
+    /** The final synthesized artifact — becomes the step's output. */
+    synthesis: string;
+    /** Aggregate confidence (0..1) when the strategy yields one (ranked-voting), else null. */
+    confidence: number | null;
+    /** Notable unresolved disagreements surfaced during the process. */
+    dissent: string[];
+    usage: ConsensusUsage;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/strategies/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/strategies/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAA;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAOjF,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,kEAAkE;AAClE,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,KAAK,EAAE,aAAa,CAAA;IACpB,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,0EAA0E;AAC1E,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,aAAa,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,IAAI,EAAE,OAAO,CAAA;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,cAAc,CAAA;CACtB;AAED,4FAA4F;AAC5F,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,cAAc,CAAC,CAAA;AAExE,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAA;IAClB,uFAAuF;IACvF,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,mBAAmB,EAAE,CAAA;IACnC,WAAW,EAAE;QAAE,KAAK,EAAE,aAAa,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAA;IACzD,yFAAyF;IACzF,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,UAAU,CAAA;IACpB,IAAI,EAAE,OAAO,CAAA;IACb;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE;QACpB,MAAM,EAAE,cAAc,EAAE,CAAA;QACxB,MAAM,EAAE,sBAAsB,CAAA;KAC/B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,EAAE,CAAA;IACxB,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAA;IACjB,2FAA2F;IAC3F,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,oEAAoE;IACpE,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,KAAK,EAAE,cAAc,CAAA;CACtB"}

package/dist/strategies/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/strategies/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/strategies/types.ts"],"names":[],"mappings":""}

package/dist/traits.d.ts

@@ -0,0 +1,35 @@
+import type { AgentKind, ConsensusStrategy } from '@cat-factory/kernel';
+export declare const SPECIALIST_PANEL_CAPABLE = "specialist-panel-capable";
+export declare const DEBATE_CAPABLE = "debate-capable";
+export declare const RANKED_VOTING_CAPABLE = "ranked-voting-capable";
+/** Map a strategy to the trait that gates its eligibility. */
+export declare const STRATEGY_TRAIT: Record<ConsensusStrategy, string>;
+/** All consensus capability traits. */
+export declare const CONSENSUS_TRAITS: readonly ["specialist-panel-capable", "debate-capable", "ranked-voting-capable"];
+/**
+ * The default-eligible kinds, each carrying all three consensus traits. A deployment
+ * can extend this with {@link assignAgentTraits}. NOTE: `architect` and `analysis` run
+ * in a container against a real checkout in their standard mode; in CONSENSUS mode they
+ * reason inline over the provided context (spec + requirements + prior outputs) rather
+ * than exploring the checkout — a deliberate trade made worthwhile by the gating, which
+ * only triggers consensus for high-complexity/risk/impact tasks.
+ *
+ *  - architect      → a well-reasoned architecture document
+ *  - analysis       → a deep investigation / aggregate of observations
+ *  - reviewer       → a rigorous, high-confidence code review (the companion verdict)
+ *  - task-estimator → an accurate complexity/risk/impact estimate (ranked-scoring)
+ */
+export declare const DEFAULT_CONSENSUS_ELIGIBLE_KINDS: AgentKind[];
+/**
+ * Register the consensus capability traits and assign them to the default-eligible
+ * kinds. A startup import side-effect each facade calls when consensus is enabled,
+ * mirroring the custom-agent / model-provider registry seams. Idempotent.
+ *
+ * @param kinds override the default-eligible set (e.g. a deployment's own kinds).
+ */
+export declare function registerConsensusTraits(kinds?: AgentKind[]): void;
+/** The consensus strategies a kind is eligible for, derived from its traits. */
+export declare function consensusStrategiesFor(kind: AgentKind): ConsensusStrategy[];
+/** Whether a kind is eligible for at least one consensus strategy. */
+export declare function isConsensusEligible(kind: AgentKind): boolean;
+//# sourceMappingURL=traits.d.ts.map

package/dist/traits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traits.d.ts","sourceRoot":"","sources":["../src/traits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAUvE,eAAO,MAAM,wBAAwB,6BAA6B,CAAA;AAClE,eAAO,MAAM,cAAc,mBAAmB,CAAA;AAC9C,eAAO,MAAM,qBAAqB,0BAA0B,CAAA;AAE5D,8DAA8D;AAC9D,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAI5D,CAAA;AAED,uCAAuC;AACvC,eAAO,MAAM,gBAAgB,kFAInB,CAAA;AAEV;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gCAAgC,EAAE,SAAS,EAKvD,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,GAAE,SAAS,EAAqC,GACpD,IAAI,CAGN;AAED,gFAAgF;AAChF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,GAAG,iBAAiB,EAAE,CAK3E;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAE5D"}

package/dist/traits.js

@@ -0,0 +1,64 @@
+import { assignAgentTraits, registerAgentTrait, traitsFor } from '@cat-factory/agents';
+import { TASK_ESTIMATOR_AGENT_KIND } from '@cat-factory/agents';
+// The group of consensus CAPABILITY traits an agent kind can carry. Each marks the
+// kind eligible for one consensus strategy: when a step's kind carries the trait, the
+// pipeline builder offers that strategy under "Enable Consensus". They are pure marker
+// traits (no prompt guidance — their effect lives in the consensus executor + the
+// builder UI), registered alongside the built-in `code-aware` / `spec-aware` traits.
+export const SPECIALIST_PANEL_CAPABLE = 'specialist-panel-capable';
+export const DEBATE_CAPABLE = 'debate-capable';
+export const RANKED_VOTING_CAPABLE = 'ranked-voting-capable';
+/** Map a strategy to the trait that gates its eligibility. */
+export const STRATEGY_TRAIT = {
+    'specialist-panel': SPECIALIST_PANEL_CAPABLE,
+    debate: DEBATE_CAPABLE,
+    'ranked-voting': RANKED_VOTING_CAPABLE,
+};
+/** All consensus capability traits. */
+export const CONSENSUS_TRAITS = [
+    SPECIALIST_PANEL_CAPABLE,
+    DEBATE_CAPABLE,
+    RANKED_VOTING_CAPABLE,
+];
+/**
+ * The default-eligible kinds, each carrying all three consensus traits. A deployment
+ * can extend this with {@link assignAgentTraits}. NOTE: `architect` and `analysis` run
+ * in a container against a real checkout in their standard mode; in CONSENSUS mode they
+ * reason inline over the provided context (spec + requirements + prior outputs) rather
+ * than exploring the checkout — a deliberate trade made worthwhile by the gating, which
+ * only triggers consensus for high-complexity/risk/impact tasks.
+ *
+ *  - architect      → a well-reasoned architecture document
+ *  - analysis       → a deep investigation / aggregate of observations
+ *  - reviewer       → a rigorous, high-confidence code review (the companion verdict)
+ *  - task-estimator → an accurate complexity/risk/impact estimate (ranked-scoring)
+ */
+export const DEFAULT_CONSENSUS_ELIGIBLE_KINDS = [
+    'architect',
+    'analysis',
+    'reviewer',
+    TASK_ESTIMATOR_AGENT_KIND,
+];
+/**
+ * Register the consensus capability traits and assign them to the default-eligible
+ * kinds. A startup import side-effect each facade calls when consensus is enabled,
+ * mirroring the custom-agent / model-provider registry seams. Idempotent.
+ *
+ * @param kinds override the default-eligible set (e.g. a deployment's own kinds).
+ */
+export function registerConsensusTraits(kinds = DEFAULT_CONSENSUS_ELIGIBLE_KINDS) {
+    for (const trait of CONSENSUS_TRAITS)
+        registerAgentTrait({ id: trait });
+    for (const kind of kinds)
+        assignAgentTraits(kind, CONSENSUS_TRAITS);
+}
+/** The consensus strategies a kind is eligible for, derived from its traits. */
+export function consensusStrategiesFor(kind) {
+    const traits = traitsFor(kind);
+    return Object.keys(STRATEGY_TRAIT).filter((s) => traits.has(STRATEGY_TRAIT[s]));
+}
+/** Whether a kind is eligible for at least one consensus strategy. */
+export function isConsensusEligible(kind) {
+    return consensusStrategiesFor(kind).length > 0;
+}
+//# sourceMappingURL=traits.js.map

package/dist/traits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traits.js","sourceRoot":"","sources":["../src/traits.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACtF,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAE/D,mFAAmF;AACnF,sFAAsF;AACtF,uFAAuF;AACvF,kFAAkF;AAClF,qFAAqF;AAErF,MAAM,CAAC,MAAM,wBAAwB,GAAG,0BAA0B,CAAA;AAClE,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,CAAA;AAC9C,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAA;AAE5D,8DAA8D;AAC9D,MAAM,CAAC,MAAM,cAAc,GAAsC;IAC/D,kBAAkB,EAAE,wBAAwB;IAC5C,MAAM,EAAE,cAAc;IACtB,eAAe,EAAE,qBAAqB;CACvC,CAAA;AAED,uCAAuC;AACvC,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,wBAAwB;IACxB,cAAc;IACd,qBAAqB;CACb,CAAA;AAEV;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAgB;IAC3D,WAAW;IACX,UAAU;IACV,UAAU;IACV,yBAAyB;CAC1B,CAAA;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAAK,GAAgB,gCAAgC;IAErD,KAAK,MAAM,KAAK,IAAI,gBAAgB;QAAE,kBAAkB,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAA;IACvE,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAA;AACrE,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,sBAAsB,CAAC,IAAe;IACpD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAC9B,OAAQ,MAAM,CAAC,IAAI,CAAC,cAAc,CAAyB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACvE,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAC9B,CAAA;AACH,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,mBAAmB,CAAC,IAAe;IACjD,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;AAChD,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@cat-factory/consensus",
+  "version": "0.6.0",
+  "description": "Optional consensus-orchestration mechanism (specialist panel / debate / ranked voting) for cat-factory agent steps, with task-estimate gating.",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "ai": "^6.0.208",
+    "@cat-factory/agents": "0.6.0",
+    "@cat-factory/contracts": "0.6.0",
+    "@cat-factory/kernel": "0.6.0"
+  },
+  "devDependencies": {
+    "typescript": "7.0.1-rc",
+    "vitest": "^4.1.9"
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:run": "vitest run"
+  }
+}