@defai.digital/discussion-domain 13.0.3

package/dist/consensus/synthesis.js

@@ -0,0 +1,161 @@
+/**
+ * Synthesis Consensus Executor
+ *
+ * One model synthesizes all perspectives into a unified conclusion.
+ * This is the default consensus method.
+ */
+import { SYNTHESIS_FINAL, interpolate, formatPreviousResponses, getProviderSystemPrompt, } from '../prompts/templates.js';
+export class SynthesisConsensus {
+    method = 'synthesis';
+    async execute(context) {
+        const startTime = Date.now();
+        const { topic, rounds, participatingProviders, config, providerExecutor, abortSignal, onProgress } = context;
+        // Determine synthesizer (default to first participating provider or 'claude')
+        const synthesizerId = config.synthesizer ||
+            (participatingProviders.includes('claude') ? 'claude' : participatingProviders[0]) ||
+            'claude';
+        onProgress?.({
+            type: 'synthesis_start',
+            provider: synthesizerId,
+            message: `${synthesizerId} synthesizing discussion`,
+            timestamp: new Date().toISOString(),
+        });
+        // Build synthesis prompt with all round data
+        const initialPerspectives = this.formatRoundPerspectives(rounds[0]);
+        const crossDiscussion = rounds.slice(1).map((round, i) => `### Round ${i + 2}\n${this.formatRoundPerspectives(round)}`).join('\n\n');
+        const prompt = interpolate(SYNTHESIS_FINAL, {
+            topic,
+            initialPerspectives,
+            crossDiscussion: crossDiscussion || 'No cross-discussion rounds.',
+        });
+        try {
+            const result = await providerExecutor.execute({
+                providerId: synthesizerId,
+                prompt,
+                systemPrompt: getProviderSystemPrompt(synthesizerId),
+                temperature: 0.7,
+                timeoutMs: 90000, // Synthesis may take longer
+                abortSignal,
+            });
+            onProgress?.({
+                type: 'synthesis_complete',
+                provider: synthesizerId,
+                message: result.success ? 'Synthesis complete' : `Synthesis failed: ${result.error}`,
+                timestamp: new Date().toISOString(),
+            });
+            if (!result.success) {
+                return {
+                    synthesis: '',
+                    consensus: {
+                        method: 'synthesis',
+                        synthesizer: synthesizerId,
+                    },
+                    durationMs: Date.now() - startTime,
+                    success: false,
+                    error: result.error || 'Synthesis failed',
+                };
+            }
+            // Extract agreement score and dissent from synthesis
+            const analysisResult = this.analyzeSynthesis(result.content || '', participatingProviders);
+            return {
+                synthesis: result.content || '',
+                consensus: {
+                    method: 'synthesis',
+                    synthesizer: synthesizerId,
+                    agreementScore: analysisResult.agreementScore,
+                    agreements: analysisResult.agreements,
+                    dissent: config.includeDissent ? analysisResult.dissent : undefined,
+                },
+                durationMs: Date.now() - startTime,
+                success: true,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            onProgress?.({
+                type: 'synthesis_complete',
+                provider: synthesizerId,
+                message: `Synthesis error: ${errorMessage}`,
+                timestamp: new Date().toISOString(),
+            });
+            return {
+                synthesis: '',
+                consensus: {
+                    method: 'synthesis',
+                    synthesizer: synthesizerId,
+                },
+                durationMs: Date.now() - startTime,
+                success: false,
+                error: errorMessage,
+            };
+        }
+    }
+    formatRoundPerspectives(round) {
+        if (!round?.responses) {
+            return 'No responses in this round.';
+        }
+        return formatPreviousResponses(round.responses.map(r => ({
+            provider: r.provider,
+            content: r.content,
+            role: r.role,
+        })));
+    }
+    analyzeSynthesis(synthesis, providers) {
+        const agreements = [];
+        const dissent = [];
+        // Look for agreement section
+        const agreementMatch = /areas?\s+of\s+(?:strong\s+)?agreement[:\s]*([^#]+?)(?=##|$)/is.exec(synthesis);
+        if (agreementMatch?.[1]) {
+            const agreementText = agreementMatch[1];
+            // Extract bullet points
+            const bullets = agreementText.match(/[-•*]\s*([^\n]+)/g);
+            if (bullets) {
+                agreements.push(...bullets.map(b => b.replace(/^[-•*]\s*/, '').trim()));
+            }
+        }
+        // Look for disagreement/dissent section
+        const dissentMatch = /(?:key\s+)?disagreements?[:\s]*([^#]+?)(?=##|$)/is.exec(synthesis);
+        if (dissentMatch?.[1]) {
+            const dissentText = dissentMatch[1];
+            // Try to extract provider-specific dissent
+            for (const provider of providers) {
+                const providerPattern = new RegExp(`${provider}[:\\s]+([^\\n]+)`, 'i');
+                const match = dissentText.match(providerPattern);
+                if (match?.[1]) {
+                    dissent.push({
+                        provider,
+                        position: match[1].trim(),
+                    });
+                }
+            }
+            // If no provider-specific dissent found, create general entry
+            if (dissent.length === 0 && dissentText.trim().length > 0) {
+                const bullets = dissentText.match(/[-•*]\s*([^\n]+)/g);
+                if (bullets && bullets.length > 0) {
+                    dissent.push({
+                        provider: 'general',
+                        position: 'Areas of disagreement noted',
+                        keyPoints: bullets.map(b => b.replace(/^[-•*]\s*/, '').trim()),
+                    });
+                }
+            }
+        }
+        // Calculate agreement score based on content analysis
+        const agreementScore = this.calculateAgreementScore(synthesis, agreements.length, dissent.length);
+        return { agreementScore, agreements, dissent };
+    }
+    calculateAgreementScore(synthesis, agreementCount, dissentCount) {
+        // Base score from ratio of agreements to total points
+        const totalPoints = agreementCount + dissentCount;
+        if (totalPoints === 0) {
+            return 0.7; // Default moderate agreement
+        }
+        const ratioScore = agreementCount / totalPoints;
+        // Adjust based on sentiment indicators in text
+        const strongAgreementIndicators = (synthesis.match(/unanimous|all\s+(?:models?\s+)?agree|consensus|strong\s+agreement/gi) || []).length;
+        const disagreementIndicators = (synthesis.match(/disagree|conflict|diverge|oppose|contrary/gi) || []).length;
+        const sentimentAdjustment = (strongAgreementIndicators * 0.1) - (disagreementIndicators * 0.05);
+        return Math.max(0, Math.min(1, ratioScore + sentimentAdjustment));
+    }
+}
+//# sourceMappingURL=synthesis.js.map

package/dist/consensus/synthesis.js.map

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

package/dist/consensus/voting.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Voting Consensus Executor
+ *
+ * Tallies votes from all providers and determines winner based on
+ * raw counts or confidence-weighted scores.
+ */
+import type { ConsensusExecutor, ConsensusExecutionContext, ConsensusExecutionResult } from '../types.js';
+export declare class VotingConsensus implements ConsensusExecutor {
+    readonly method: "voting";
+    execute(context: ConsensusExecutionContext): Promise<ConsensusExecutionResult>;
+    private extractVotes;
+    private extractReasoning;
+    private tallyVotes;
+    private generateVoteSummary;
+    private generateFallbackSummary;
+}
+//# sourceMappingURL=voting.d.ts.map

package/dist/consensus/voting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voting.d.ts","sourceRoot":"","sources":["../../src/consensus/voting.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAQ1G,qBAAa,eAAgB,YAAW,iBAAiB;IACvD,QAAQ,CAAC,MAAM,EAAG,QAAQ,CAAU;IAE9B,OAAO,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,wBAAwB,CAAC;IAwDpF,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,UAAU;YA6CJ,mBAAmB;IAgDjC,OAAO,CAAC,uBAAuB;CA4BhC"}

package/dist/consensus/voting.js

@@ -0,0 +1,168 @@
+/**
+ * Voting Consensus Executor
+ *
+ * Tallies votes from all providers and determines winner based on
+ * raw counts or confidence-weighted scores.
+ */
+import { VOTING_TALLY, interpolate, formatVotes, getProviderSystemPrompt, } from '../prompts/templates.js';
+export class VotingConsensus {
+    method = 'voting';
+    async execute(context) {
+        const startTime = Date.now();
+        const { topic, rounds, participatingProviders, config, providerExecutor, abortSignal, onProgress } = context;
+        // Extract votes from round responses
+        const votes = this.extractVotes(rounds);
+        if (votes.length === 0) {
+            return {
+                synthesis: 'No valid votes were cast.',
+                consensus: {
+                    method: 'voting',
+                },
+                durationMs: Date.now() - startTime,
+                success: false,
+                error: 'No valid votes found in discussion rounds',
+            };
+        }
+        // Tally votes
+        const votingResults = this.tallyVotes(votes, config.threshold);
+        // Generate synthesis summary
+        const synthesizerId = config.synthesizer ||
+            (participatingProviders.includes('claude') ? 'claude' : participatingProviders[0]) ||
+            'claude';
+        onProgress?.({
+            type: 'synthesis_start',
+            provider: synthesizerId,
+            message: 'Generating vote summary',
+            timestamp: new Date().toISOString(),
+        });
+        const synthesis = await this.generateVoteSummary(topic, votingResults, synthesizerId, providerExecutor, abortSignal, onProgress);
+        return {
+            synthesis,
+            consensus: {
+                method: 'voting',
+                synthesizer: synthesizerId,
+                agreementScore: votingResults.unanimous ? 1.0 : votingResults.margin,
+            },
+            votingResults,
+            durationMs: Date.now() - startTime,
+            success: true,
+        };
+    }
+    extractVotes(rounds) {
+        const votes = [];
+        for (const round of rounds) {
+            for (const response of round.responses) {
+                if (response.vote && response.confidence !== undefined) {
+                    votes.push({
+                        provider: response.provider,
+                        choice: response.vote,
+                        confidence: response.confidence,
+                        reasoning: this.extractReasoning(response.content),
+                    });
+                }
+            }
+        }
+        return votes;
+    }
+    extractReasoning(content) {
+        const reasoningMatch = /reasoning:\s*(.+?)(?=\n\n|$)/is.exec(content);
+        return reasoningMatch?.[1] ? reasoningMatch[1].trim() : '';
+    }
+    tallyVotes(votes, _threshold) {
+        // Count raw votes
+        const rawVotes = {};
+        const weightedVotes = {};
+        for (const vote of votes) {
+            rawVotes[vote.choice] = (rawVotes[vote.choice] || 0) + 1;
+            weightedVotes[vote.choice] = (weightedVotes[vote.choice] || 0) + vote.confidence;
+        }
+        // Determine winner (by weighted votes)
+        let winner = '';
+        let maxWeight = 0;
+        let secondMaxWeight = 0;
+        for (const [choice, weight] of Object.entries(weightedVotes)) {
+            if (weight > maxWeight) {
+                secondMaxWeight = maxWeight;
+                maxWeight = weight;
+                winner = choice;
+            }
+            else if (weight > secondMaxWeight) {
+                secondMaxWeight = weight;
+            }
+        }
+        // Calculate total weight
+        const totalWeight = Object.values(weightedVotes).reduce((a, b) => a + b, 0);
+        // Check if unanimous
+        const uniqueChoices = new Set(votes.map(v => v.choice));
+        const unanimous = uniqueChoices.size === 1;
+        // Calculate margin
+        const margin = totalWeight > 0 ? (maxWeight - secondMaxWeight) / totalWeight : 0;
+        return {
+            winner,
+            votes: rawVotes,
+            weightedVotes,
+            voteRecords: votes,
+            unanimous,
+            margin,
+        };
+    }
+    async generateVoteSummary(topic, votingResults, synthesizerId, providerExecutor, abortSignal, onProgress) {
+        // Build options list
+        const options = Object.keys(votingResults.votes);
+        // Build formatted votes
+        const formattedVotes = formatVotes(votingResults.voteRecords);
+        const prompt = interpolate(VOTING_TALLY, {
+            topic,
+            options: options.join(', '),
+            votes: formattedVotes,
+        });
+        try {
+            const result = await providerExecutor.execute({
+                providerId: synthesizerId,
+                prompt,
+                systemPrompt: getProviderSystemPrompt(synthesizerId),
+                temperature: 0.5,
+                timeoutMs: 60000,
+                abortSignal,
+            });
+            onProgress?.({
+                type: 'synthesis_complete',
+                provider: synthesizerId,
+                timestamp: new Date().toISOString(),
+            });
+            if (result.success && result.content) {
+                return result.content;
+            }
+            // Fallback to generated summary
+            return this.generateFallbackSummary(votingResults);
+        }
+        catch {
+            return this.generateFallbackSummary(votingResults);
+        }
+    }
+    generateFallbackSummary(votingResults) {
+        const { winner, votes, weightedVotes, unanimous, margin, voteRecords } = votingResults;
+        let summary = `## Voting Results\n\n`;
+        summary += `**Winner**: ${winner}\n\n`;
+        if (unanimous) {
+            summary += `The vote was **unanimous** - all providers agreed on ${winner}.\n\n`;
+        }
+        else {
+            summary += `**Margin of victory**: ${(margin * 100).toFixed(1)}%\n\n`;
+        }
+        summary += `### Vote Breakdown\n\n`;
+        for (const [choice, count] of Object.entries(votes)) {
+            const weight = weightedVotes[choice] || 0;
+            summary += `- **${choice}**: ${count} vote(s), weighted score: ${weight.toFixed(2)}\n`;
+        }
+        summary += `\n### Individual Votes\n\n`;
+        for (const record of voteRecords) {
+            summary += `- **${record.provider}**: ${record.choice} (${(record.confidence * 100).toFixed(0)}% confidence)\n`;
+            if (record.reasoning) {
+                summary += `  - Reasoning: ${record.reasoning}\n`;
+            }
+        }
+        return summary;
+    }
+}
+//# sourceMappingURL=voting.js.map

package/dist/consensus/voting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voting.js","sourceRoot":"","sources":["../../src/consensus/voting.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EACL,YAAY,EACZ,WAAW,EACX,WAAW,EACX,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,OAAO,eAAe;IACjB,MAAM,GAAG,QAAiB,CAAC;IAEpC,KAAK,CAAC,OAAO,CAAC,OAAkC;QAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,sBAAsB,EAAE,MAAM,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;QAE7G,qCAAqC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAExC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO;gBACL,SAAS,EAAE,2BAA2B;gBACtC,SAAS,EAAE;oBACT,MAAM,EAAE,QAAQ;iBACjB;gBACD,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBAClC,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,2CAA2C;aACnD,CAAC;QACJ,CAAC;QAED,cAAc;QACd,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAE/D,6BAA6B;QAC7B,MAAM,aAAa,GAAG,MAAM,CAAC,WAAW;YACtC,CAAC,sBAAsB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;YAClF,QAAQ,CAAC;QAEX,UAAU,EAAE,CAAC;YACX,IAAI,EAAE,iBAAiB;YACvB,QAAQ,EAAE,aAAa;YACvB,OAAO,EAAE,yBAAyB;YAClC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAC9C,KAAK,EACL,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,UAAU,CACX,CAAC;QAEF,OAAO;YACL,SAAS;YACT,SAAS,EAAE;gBACT,MAAM,EAAE,QAAQ;gBAChB,WAAW,EAAE,aAAa;gBAC1B,cAAc,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM;aACrE;YACD,aAAa;YACb,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAClC,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAEO,YAAY,CAAC,MAA2C;QAC9D,MAAM,KAAK,GAAiB,EAAE,CAAC;QAE/B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;gBACvC,IAAI,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;oBACvD,KAAK,CAAC,IAAI,CAAC;wBACT,QAAQ,EAAE,QAAQ,CAAC,QAAQ;wBAC3B,MAAM,EAAE,QAAQ,CAAC,IAAI;wBACrB,UAAU,EAAE,QAAQ,CAAC,UAAU;wBAC/B,SAAS,EAAE,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC;qBACnD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,gBAAgB,CAAC,OAAe;QACtC,MAAM,cAAc,GAAG,gCAAgC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtE,OAAO,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,CAAC;IAEO,UAAU,CAAC,KAAmB,EAAE,UAAkB;QACxD,kBAAkB;QAClB,MAAM,QAAQ,GAA2B,EAAE,CAAC;QAC5C,MAAM,aAAa,GAA2B,EAAE,CAAC;QAEjD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACzD,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;QACnF,CAAC;QAED,uCAAuC;QACvC,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,eAAe,GAAG,CAAC,CAAC;QAExB,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;YAC7D,IAAI,MAAM,GAAG,SAAS,EAAE,CAAC;gBACvB,eAAe,GAAG,SAAS,CAAC;gBAC5B,SAAS,GAAG,MAAM,CAAC;gBACnB,MAAM,GAAG,MAAM,CAAC;YAClB,CAAC;iBAAM,IAAI,MAAM,GAAG,eAAe,EAAE,CAAC;gBACpC,eAAe,GAAG,MAAM,CAAC;YAC3B,CAAC;QACH,CAAC;QAED,yBAAyB;QACzB,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAE5E,qBAAqB;QACrB,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QACxD,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,KAAK,CAAC,CAAC;QAE3C,mBAAmB;QACnB,MAAM,MAAM,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,eAAe,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QAEjF,OAAO;YACL,MAAM;YACN,KAAK,EAAE,QAAQ;YACf,aAAa;YACb,WAAW,EAAE,KAAK;YAClB,SAAS;YACT,MAAM;SACP,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,mBAAmB,CAC/B,KAAa,EACb,aAA4B,EAC5B,aAAqB,EACrB,gBAA+D,EAC/D,WAAyB,EACzB,UAAoD;QAEpD,qBAAqB;QACrB,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAEjD,wBAAwB;QACxB,MAAM,cAAc,GAAG,WAAW,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;QAE9D,MAAM,MAAM,GAAG,WAAW,CAAC,YAAY,EAAE;YACvC,KAAK;YACL,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAC3B,KAAK,EAAE,cAAc;SACtB,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC;gBAC5C,UAAU,EAAE,aAAa;gBACzB,MAAM;gBACN,YAAY,EAAE,uBAAuB,CAAC,aAAa,CAAC;gBACpD,WAAW,EAAE,GAAG;gBAChB,SAAS,EAAE,KAAK;gBAChB,WAAW;aACZ,CAAC,CAAC;YAEH,UAAU,EAAE,CAAC;gBACX,IAAI,EAAE,oBAAoB;gBAC1B,QAAQ,EAAE,aAAa;gBACvB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACrC,OAAO,MAAM,CAAC,OAAO,CAAC;YACxB,CAAC;YAED,gCAAgC;YAChC,OAAO,IAAI,CAAC,uBAAuB,CAAC,aAAa,CAAC,CAAC;QAErD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC,uBAAuB,CAAC,aAAa,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAEO,uBAAuB,CAAC,aAA4B;QAC1D,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,aAAa,CAAC;QAEvF,IAAI,OAAO,GAAG,uBAAuB,CAAC;QACtC,OAAO,IAAI,eAAe,MAAM,MAAM,CAAC;QAEvC,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,IAAI,wDAAwD,MAAM,OAAO,CAAC;QACnF,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,0BAA0B,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QACxE,CAAC;QAED,OAAO,IAAI,wBAAwB,CAAC;QACpC,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACpD,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC1C,OAAO,IAAI,OAAO,MAAM,OAAO,KAAK,6BAA6B,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QACzF,CAAC;QAED,OAAO,IAAI,4BAA4B,CAAC;QACxC,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;YACjC,OAAO,IAAI,OAAO,MAAM,CAAC,QAAQ,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,MAAM,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC;YAChH,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACrB,OAAO,IAAI,kBAAkB,MAAM,CAAC,SAAS,IAAI,CAAC;YACpD,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/dist/executor.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Discussion Executor
+ *
+ * Main orchestrator for multi-model discussions.
+ * Coordinates pattern execution, consensus mechanisms, and result assembly.
+ *
+ * Invariants enforced:
+ * - INV-DISC-100: Provider availability check before starting
+ * - INV-DISC-101: Minimum participating providers enforced
+ * - INV-DISC-102: Provider timeouts enforced
+ * - INV-DISC-009: Result always contains synthesis
+ */
+import { type DiscussStepConfig, type DiscussionResult, type DiscussionRequest } from '@defai.digital/contracts';
+import type { DiscussionProviderExecutor, DiscussionExecutorOptions, DiscussionProgressEvent } from './types.js';
+/**
+ * Main discussion executor class.
+ *
+ * Orchestrates multi-model discussions across different patterns and consensus mechanisms.
+ */
+export declare class DiscussionExecutor {
+    private readonly providerExecutor;
+    private readonly defaultTimeoutMs;
+    private readonly checkProviderHealth;
+    private readonly traceId;
+    constructor(options: DiscussionExecutorOptions);
+    /**
+     * Execute a discussion from a DiscussionRequest (CLI/MCP input format)
+     */
+    executeRequest(request: DiscussionRequest, options?: {
+        abortSignal?: AbortSignal;
+        onProgress?: (event: DiscussionProgressEvent) => void;
+    }): Promise<DiscussionResult>;
+    /**
+     * Execute a discussion with full configuration
+     */
+    execute(config: DiscussStepConfig, options?: {
+        abortSignal?: AbortSignal;
+        onProgress?: (event: DiscussionProgressEvent) => void;
+    }): Promise<DiscussionResult>;
+    /**
+     * Check provider availability (INV-DISC-100)
+     */
+    private checkProviders;
+    /**
+     * Create a quick synthesis discussion (2 rounds, default providers)
+     */
+    quickSynthesis(topic: string, options?: {
+        providers?: string[];
+        abortSignal?: AbortSignal;
+        onProgress?: (event: DiscussionProgressEvent) => void;
+    }): Promise<DiscussionResult>;
+    /**
+     * Create a debate discussion
+     */
+    debate(topic: string, proponent?: string, opponent?: string, judge?: string, options?: {
+        rounds?: number;
+        abortSignal?: AbortSignal;
+        onProgress?: (event: DiscussionProgressEvent) => void;
+    }): Promise<DiscussionResult>;
+    /**
+     * Create a voting discussion
+     */
+    vote(question: string, voteOptions: string[], options?: {
+        providers?: string[];
+        abortSignal?: AbortSignal;
+        onProgress?: (event: DiscussionProgressEvent) => void;
+    }): Promise<DiscussionResult>;
+}
+/**
+ * Create a discussion executor with default options
+ */
+export declare function createDiscussionExecutor(providerExecutor: DiscussionProviderExecutor, options?: Partial<Omit<DiscussionExecutorOptions, 'providerExecutor'>>): DiscussionExecutor;
+//# sourceMappingURL=executor.d.ts.map

package/dist/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAIL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAElC,OAAO,KAAK,EACV,0BAA0B,EAC1B,yBAAyB,EAEzB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAIpB;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;IAC9D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAEjC,OAAO,EAAE,yBAAyB;IAO9C;;OAEG;IACG,cAAc,CAClB,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;KACvD,GACA,OAAO,CAAC,gBAAgB,CAAC;IAwB5B;;OAEG;IACG,OAAO,CACX,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE;QACR,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;KACvD,GACA,OAAO,CAAC,gBAAgB,CAAC;IAgH5B;;OAEG;YACW,cAAc;IAuB5B;;OAEG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;KACvD,GACA,OAAO,CAAC,gBAAgB,CAAC;IAY5B;;OAEG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,SAAS,SAAW,EACpB,QAAQ,SAAQ,EAChB,KAAK,SAAW,EAChB,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;KACvD,GACA,OAAO,CAAC,gBAAgB,CAAC;IA2B5B;;OAEG;IACG,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,CAAC;KACvD,GACA,OAAO,CAAC,gBAAgB,CAAC;CAsB7B;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,gBAAgB,EAAE,0BAA0B,EAC5C,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAAE,kBAAkB,CAAC,CAAC,GACrE,kBAAkB,CAKpB"}