@cogitator-ai/swarms 0.1.0

package/dist/strategies/consensus.js

@@ -0,0 +1,328 @@
+/**
+ * Consensus strategy - Agents vote and reach agreement
+ */
+import { BaseStrategy } from './base';
+export class ConsensusStrategy extends BaseStrategy {
+    config;
+    constructor(coordinator, config) {
+        super(coordinator);
+        this.config = config;
+    }
+    async execute(options) {
+        const agentResults = new Map();
+        const allVotes = [];
+        const discussionTranscript = [];
+        const agents = this.coordinator.getAgents();
+        if (agents.length < 2) {
+            throw new Error('Consensus strategy requires at least 2 agents');
+        }
+        const supervisors = this.coordinator.getAgentsByRole('supervisor');
+        const supervisor = supervisors.length > 0 ? supervisors[0] : null;
+        this.coordinator.blackboard.write('consensus', {
+            topic: options.input,
+            maxRounds: this.config.maxRounds,
+            currentRound: 0,
+            votes: [],
+            resolution: this.config.resolution,
+            threshold: this.config.threshold,
+        }, 'system');
+        let consensusReached = false;
+        let winningDecision = null;
+        let finalRound = 0;
+        for (let round = 1; round <= this.config.maxRounds && !consensusReached; round++) {
+            finalRound = round;
+            this.coordinator.events.emit('consensus:round', { round, total: this.config.maxRounds });
+            const consensusState = this.coordinator.blackboard.read('consensus');
+            this.coordinator.blackboard.write('consensus', {
+                ...consensusState,
+                currentRound: round,
+            }, 'system');
+            const roundVotes = [];
+            const previousDiscussion = this.getPreviousDiscussion(discussionTranscript, round);
+            for (const swarmAgent of agents) {
+                if (swarmAgent.metadata.role === 'supervisor')
+                    continue;
+                const agentContext = {
+                    ...options.context,
+                    consensusContext: {
+                        round,
+                        totalRounds: this.config.maxRounds,
+                        resolution: this.config.resolution,
+                        threshold: this.config.threshold,
+                        previousVotes: this.summarizeVotes(allVotes.filter(v => v.round < round)),
+                        previousDiscussion,
+                    },
+                    consensusInstructions: this.buildConsensusInstructions(swarmAgent, round),
+                };
+                const input = round === 1
+                    ? `Consider the following and provide your decision:\n\n${options.input}\n\nProvide your vote as: VOTE: [your decision]\nFollowed by your reasoning.`
+                    : `Continue the consensus discussion on: ${options.input}\n\nPrevious votes and discussion:\n${previousDiscussion}\n\nProvide your updated vote as: VOTE: [your decision]\nFollowed by your reasoning.`;
+                this.coordinator.events.emit('consensus:turn', {
+                    round,
+                    agent: swarmAgent.agent.name,
+                }, swarmAgent.agent.name);
+                const result = await this.coordinator.runAgent(swarmAgent.agent.name, input, agentContext);
+                agentResults.set(`${swarmAgent.agent.name}_round${round}`, result);
+                const vote = this.extractVote(result.output, swarmAgent, round);
+                if (vote) {
+                    roundVotes.push(vote);
+                    allVotes.push(vote);
+                }
+                const message = {
+                    id: `consensus_${round}_${swarmAgent.agent.name}`,
+                    swarmId: '',
+                    from: swarmAgent.agent.name,
+                    to: 'broadcast',
+                    type: 'notification',
+                    content: result.output,
+                    channel: 'consensus',
+                    timestamp: Date.now(),
+                    metadata: { round, vote: vote?.decision },
+                };
+                discussionTranscript.push(message);
+            }
+            const updatedState = this.coordinator.blackboard.read('consensus');
+            updatedState.votes = allVotes;
+            this.coordinator.blackboard.write('consensus', updatedState, 'system');
+            const consensusResult = this.checkConsensus(roundVotes, agents.filter(a => a.metadata.role !== 'supervisor'));
+            if (consensusResult.reached) {
+                consensusReached = true;
+                winningDecision = consensusResult.decision;
+                this.coordinator.events.emit('consensus:reached', {
+                    round,
+                    decision: winningDecision,
+                    votes: consensusResult.voteCounts,
+                });
+            }
+        }
+        let finalOutput;
+        if (consensusReached && winningDecision) {
+            finalOutput = this.buildConsensusOutput(winningDecision, allVotes, finalRound, true);
+        }
+        else {
+            switch (this.config.onNoConsensus) {
+                case 'supervisor-decides':
+                    if (supervisor) {
+                        const supervisorResult = await this.runSupervisorDecision(supervisor, options, allVotes, discussionTranscript);
+                        agentResults.set(supervisor.agent.name, supervisorResult);
+                        finalOutput = supervisorResult.output;
+                    }
+                    else {
+                        finalOutput = this.buildConsensusOutput(null, allVotes, finalRound, false);
+                    }
+                    break;
+                case 'escalate':
+                    finalOutput = `ESCALATION REQUIRED\n\n${this.buildConsensusOutput(null, allVotes, finalRound, false)}\n\nNo consensus reached after ${this.config.maxRounds} rounds. Please escalate to human decision-maker.`;
+                    break;
+                case 'fail':
+                default:
+                    throw new Error(`Consensus not reached after ${this.config.maxRounds} rounds`);
+            }
+        }
+        const votesMap = new Map();
+        for (const vote of allVotes) {
+            votesMap.set(`${vote.agentName}_round${vote.round}`, {
+                decision: vote.decision,
+                reasoning: vote.reasoning,
+                weight: vote.weight,
+            });
+        }
+        return {
+            output: finalOutput,
+            agentResults,
+            votes: votesMap,
+        };
+    }
+    extractVote(output, agent, round) {
+        const voteMatch = /VOTE:\s*([^\n]+)/i.exec(output);
+        if (!voteMatch) {
+            const decisionMatch = /(?:decision|vote|choose|select):\s*([^\n]+)/i.exec(output);
+            if (!decisionMatch)
+                return null;
+            return {
+                agentName: agent.agent.name,
+                decision: decisionMatch[1].trim(),
+                reasoning: output,
+                weight: this.getAgentWeight(agent),
+                round,
+            };
+        }
+        return {
+            agentName: agent.agent.name,
+            decision: voteMatch[1].trim(),
+            reasoning: output.replace(voteMatch[0], '').trim(),
+            weight: this.getAgentWeight(agent),
+            round,
+        };
+    }
+    getAgentWeight(agent) {
+        if (this.config.weights?.[agent.agent.name] !== undefined) {
+            return this.config.weights[agent.agent.name];
+        }
+        if (agent.metadata.weight !== undefined) {
+            return agent.metadata.weight;
+        }
+        return 1;
+    }
+    checkConsensus(votes, agents) {
+        if (votes.length === 0) {
+            return { reached: false, decision: null, voteCounts: [] };
+        }
+        const voteCounts = new Map();
+        for (const vote of votes) {
+            const normalized = vote.decision.toLowerCase().trim();
+            const existing = voteCounts.get(normalized);
+            if (existing) {
+                existing.count++;
+                existing.weightedCount += vote.weight;
+                existing.voters.push(vote.agentName);
+            }
+            else {
+                voteCounts.set(normalized, {
+                    decision: vote.decision,
+                    count: 1,
+                    weightedCount: vote.weight,
+                    voters: [vote.agentName],
+                });
+            }
+        }
+        const countsArray = Array.from(voteCounts.values());
+        const totalVotes = votes.length;
+        const totalWeight = votes.reduce((sum, v) => sum + v.weight, 0);
+        switch (this.config.resolution) {
+            case 'unanimous': {
+                if (countsArray.length === 1 && countsArray[0].count === agents.length) {
+                    return { reached: true, decision: countsArray[0].decision, voteCounts: countsArray };
+                }
+                return { reached: false, decision: null, voteCounts: countsArray };
+            }
+            case 'weighted': {
+                const sorted = countsArray.sort((a, b) => b.weightedCount - a.weightedCount);
+                const topOption = sorted[0];
+                const weightRatio = topOption.weightedCount / totalWeight;
+                if (weightRatio >= this.config.threshold) {
+                    return { reached: true, decision: topOption.decision, voteCounts: countsArray };
+                }
+                return { reached: false, decision: null, voteCounts: countsArray };
+            }
+            case 'majority':
+            default: {
+                const sorted = countsArray.sort((a, b) => b.count - a.count);
+                const topOption = sorted[0];
+                const voteRatio = topOption.count / totalVotes;
+                if (voteRatio >= this.config.threshold) {
+                    return { reached: true, decision: topOption.decision, voteCounts: countsArray };
+                }
+                return { reached: false, decision: null, voteCounts: countsArray };
+            }
+        }
+    }
+    summarizeVotes(votes) {
+        if (votes.length === 0)
+            return 'No previous votes.';
+        const byAgent = new Map();
+        for (const vote of votes) {
+            const existing = byAgent.get(vote.agentName) ?? [];
+            existing.push(vote);
+            byAgent.set(vote.agentName, existing);
+        }
+        return Array.from(byAgent.entries())
+            .map(([agent, agentVotes]) => {
+            const lastVote = agentVotes[agentVotes.length - 1];
+            return `${agent}: ${lastVote.decision}`;
+        })
+            .join('\n');
+    }
+    getPreviousDiscussion(transcript, currentRound) {
+        const previousMessages = transcript.filter((m) => m.metadata?.round < currentRound);
+        if (previousMessages.length === 0)
+            return '';
+        return previousMessages
+            .map((m) => `[${m.from}]: ${m.content}`)
+            .join('\n\n');
+    }
+    buildConsensusInstructions(agent, round) {
+        const resolutionDesc = {
+            majority: `A decision wins if it receives ${Math.round(this.config.threshold * 100)}% or more of the votes.`,
+            unanimous: 'All agents must agree on the same decision.',
+            weighted: `A decision wins if its weighted vote reaches ${Math.round(this.config.threshold * 100)}% of total weight.`,
+        };
+        return `
+You are participating in a consensus decision-making process.
+
+Round ${round} of ${this.config.maxRounds}
+Resolution: ${this.config.resolution} - ${resolutionDesc[this.config.resolution]}
+
+Your weight in this vote: ${this.getAgentWeight(agent)}
+
+Instructions:
+1. Consider the topic carefully
+2. Review previous votes and reasoning if available
+3. Provide your vote in the format: VOTE: [your decision]
+4. Explain your reasoning
+5. If you're changing your vote from a previous round, explain why
+
+Be constructive and aim for consensus while maintaining your expert judgment.
+`.trim();
+    }
+    async runSupervisorDecision(supervisor, options, votes, transcript) {
+        const voteSummary = this.summarizeVotes(votes);
+        const discussionSummary = transcript
+            .map((m) => `[${m.from}]: ${m.content.slice(0, 300)}...`)
+            .join('\n\n');
+        const input = `
+As the supervisor, the team has not reached consensus after ${this.config.maxRounds} rounds.
+
+Original topic: ${options.input}
+
+Vote summary:
+${voteSummary}
+
+Discussion highlights:
+${discussionSummary}
+
+Please make the final decision and explain your reasoning.
+Provide your decision as: FINAL DECISION: [your decision]
+`.trim();
+        return this.coordinator.runAgent(supervisor.agent.name, input, {
+            ...options.context,
+            supervisorContext: {
+                noConsensusEscalation: true,
+                rounds: this.config.maxRounds,
+                totalVotes: votes.length,
+            },
+        });
+    }
+    buildConsensusOutput(decision, votes, rounds, reached) {
+        const votesByRound = new Map();
+        for (const vote of votes) {
+            const existing = votesByRound.get(vote.round) ?? [];
+            existing.push(vote);
+            votesByRound.set(vote.round, existing);
+        }
+        let output = reached
+            ? `CONSENSUS REACHED\n\nDecision: ${decision}\n\n`
+            : `NO CONSENSUS\n\n`;
+        output += `Rounds: ${rounds}\nResolution method: ${this.config.resolution}\nThreshold: ${Math.round(this.config.threshold * 100)}%\n\n`;
+        output += '=== Vote History ===\n\n';
+        for (const [round, roundVotes] of votesByRound) {
+            output += `Round ${round}:\n`;
+            for (const vote of roundVotes) {
+                output += `  ${vote.agentName}: ${vote.decision}${vote.weight !== 1 ? ` (weight: ${vote.weight})` : ''}\n`;
+            }
+            output += '\n';
+        }
+        const finalVotes = votes.filter(v => v.round === rounds);
+        const voteCounts = new Map();
+        for (const vote of finalVotes) {
+            const key = vote.decision.toLowerCase().trim();
+            voteCounts.set(key, (voteCounts.get(key) ?? 0) + 1);
+        }
+        output += '=== Final Vote Tally ===\n';
+        for (const [decision, count] of voteCounts) {
+            output += `  ${decision}: ${count} votes\n`;
+        }
+        return output;
+    }
+}
+//# sourceMappingURL=consensus.js.map

package/dist/strategies/consensus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consensus.js","sourceRoot":"","sources":["../../src/strategies/consensus.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAkBtC,MAAM,OAAO,iBAAkB,SAAQ,YAAY;IACzC,MAAM,CAAkB;IAEhC,YAAY,WAA6B,EAAE,MAAuB;QAChE,KAAK,CAAC,WAAW,CAAC,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAwB;QACpC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAqB,CAAC;QAClD,MAAM,QAAQ,GAAW,EAAE,CAAC;QAC5B,MAAM,oBAAoB,GAAmB,EAAE,CAAC;QAEhD,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC;QAC5C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;QACnE,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAElE,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,EAAE;YAC7C,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;YAChC,YAAY,EAAE,CAAC;YACf,KAAK,EAAE,EAAE;YACT,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;YAClC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;SACjC,EAAE,QAAQ,CAAC,CAAC;QAEb,IAAI,gBAAgB,GAAG,KAAK,CAAC;QAC7B,IAAI,eAAe,GAAkB,IAAI,CAAC;QAC1C,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,gBAAgB,EAAE,KAAK,EAAE,EAAE,CAAC;YACjF,UAAU,GAAG,KAAK,CAAC;YACnB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;YAEzF,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAoB,WAAW,CAAC,CAAC;YACxF,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,EAAE;gBAC7C,GAAG,cAAc;gBACjB,YAAY,EAAE,KAAK;aACpB,EAAE,QAAQ,CAAC,CAAC;YAEb,MAAM,UAAU,GAAW,EAAE,CAAC;YAE9B,MAAM,kBAAkB,GAAG,IAAI,CAAC,qBAAqB,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC;YAEnF,KAAK,MAAM,UAAU,IAAI,MAAM,EAAE,CAAC;gBAChC,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,KAAK,YAAY;oBAAE,SAAS;gBAExD,MAAM,YAAY,GAAG;oBACnB,GAAG,OAAO,CAAC,OAAO;oBAClB,gBAAgB,EAAE;wBAChB,KAAK;wBACL,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;wBAClC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;wBAClC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;wBAChC,aAAa,EAAE,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC;wBACzE,kBAAkB;qBACnB;oBACD,qBAAqB,EAAE,IAAI,CAAC,0BAA0B,CAAC,UAAU,EAAE,KAAK,CAAC;iBAC1E,CAAC;gBAEF,MAAM,KAAK,GAAG,KAAK,KAAK,CAAC;oBACvB,CAAC,CAAC,wDAAwD,OAAO,CAAC,KAAK,8EAA8E;oBACrJ,CAAC,CAAC,yCAAyC,OAAO,CAAC,KAAK,uCAAuC,kBAAkB,sFAAsF,CAAC;gBAE1M,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE;oBAC7C,KAAK;oBACL,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI;iBAC7B,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAE1B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAC5C,UAAU,CAAC,KAAK,CAAC,IAAI,EACrB,KAAK,EACL,YAAY,CACb,CAAC;gBACF,YAAY,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,SAAS,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;gBAEnE,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;gBAChE,IAAI,IAAI,EAAE,CAAC;oBACT,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACtB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACtB,CAAC;gBAED,MAAM,OAAO,GAAiB;oBAC5B,EAAE,EAAE,aAAa,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE;oBACjD,OAAO,EAAE,EAAE;oBACX,IAAI,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI;oBAC3B,EAAE,EAAE,WAAW;oBACf,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,MAAM,CAAC,MAAM;oBACtB,OAAO,EAAE,WAAW;oBACpB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;oBACrB,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE;iBAC1C,CAAC;gBACF,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrC,CAAC;YAED,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAoB,WAAW,CAAC,CAAC;YACtF,YAAY,CAAC,KAAK,GAAG,QAAQ,CAAC;YAC9B,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,WAAW,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;YAEvE,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC;YAC9G,IAAI,eAAe,CAAC,OAAO,EAAE,CAAC;gBAC5B,gBAAgB,GAAG,IAAI,CAAC;gBACxB,eAAe,GAAG,eAAe,CAAC,QAAQ,CAAC;gBAC3C,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE;oBAChD,KAAK;oBACL,QAAQ,EAAE,eAAe;oBACzB,KAAK,EAAE,eAAe,CAAC,UAAU;iBAClC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,IAAI,WAAmB,CAAC;QAExB,IAAI,gBAAgB,IAAI,eAAe,EAAE,CAAC;YACxC,WAAW,GAAG,IAAI,CAAC,oBAAoB,CAAC,eAAe,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;QACvF,CAAC;aAAM,CAAC;YACN,QAAQ,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;gBAClC,KAAK,oBAAoB;oBACvB,IAAI,UAAU,EAAE,CAAC;wBACf,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,qBAAqB,CACvD,UAAU,EACV,OAAO,EACP,QAAQ,EACR,oBAAoB,CACrB,CAAC;wBACF,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;wBAC1D,WAAW,GAAG,gBAAgB,CAAC,MAAM,CAAC;oBACxC,CAAC;yBAAM,CAAC;wBACN,WAAW,GAAG,IAAI,CAAC,oBAAoB,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;oBAC7E,CAAC;oBACD,MAAM;gBAER,KAAK,UAAU;oBACb,WAAW,GAAG,0BAA0B,IAAI,CAAC,oBAAoB,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC,kCAAkC,IAAI,CAAC,MAAM,CAAC,SAAS,mDAAmD,CAAC;oBAC/M,MAAM;gBAER,KAAK,MAAM,CAAC;gBACZ;oBACE,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,CAAC,MAAM,CAAC,SAAS,SAAS,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAC;QAC5C,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,SAAS,IAAI,CAAC,KAAK,EAAE,EAAE;gBACnD,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;QACL,CAAC;QAED,OAAO;YACL,MAAM,EAAE,WAAW;YACnB,YAAY;YACZ,KAAK,EAAE,QAAQ;SAChB,CAAC;IACJ,CAAC;IAEO,WAAW,CAAC,MAAc,EAAE,KAAiB,EAAE,KAAa;QAClE,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,aAAa,GAAG,8CAA8C,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAClF,IAAI,CAAC,aAAa;gBAAE,OAAO,IAAI,CAAC;YAEhC,OAAO;gBACL,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;gBAC3B,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;gBACjC,SAAS,EAAE,MAAM;gBACjB,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;gBAClC,KAAK;aACN,CAAC;QACJ,CAAC;QAED,OAAO;YACL,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI;YAC3B,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;YAC7B,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE;YAClD,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;YAClC,KAAK;SACN,CAAC;IACJ,CAAC;IAEO,cAAc,CAAC,KAAiB;QACtC,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YAC1D,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACxC,OAAO,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC/B,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAEO,cAAc,CACpB,KAAa,EACb,MAAoB;QAEpB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QAC5D,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,GAAG,EAAqB,CAAC;QAEhD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;YACtD,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAE5C,IAAI,QAAQ,EAAE,CAAC;gBACb,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACjB,QAAQ,CAAC,aAAa,IAAI,IAAI,CAAC,MAAM,CAAC;gBACtC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACvC,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,GAAG,CAAC,UAAU,EAAE;oBACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,KAAK,EAAE,CAAC;oBACR,aAAa,EAAE,IAAI,CAAC,MAAM;oBAC1B,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC;iBACzB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QACpD,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;QAChC,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAEhE,QAAQ,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YAC/B,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;oBACvE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;gBACvF,CAAC;gBACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;YACrE,CAAC;YAED,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;gBAC7E,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;gBAC5B,MAAM,WAAW,GAAG,SAAS,CAAC,aAAa,GAAG,WAAW,CAAC;gBAE1D,IAAI,WAAW,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;oBACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;gBAClF,CAAC;gBACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;YACrE,CAAC;YAED,KAAK,UAAU,CAAC;YAChB,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;gBAC7D,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;gBAC5B,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,GAAG,UAAU,CAAC;gBAE/C,IAAI,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;oBACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;gBAClF,CAAC;gBACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;YACrE,CAAC;QACH,CAAC;IACH,CAAC;IAEO,cAAc,CAAC,KAAa;QAClC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,oBAAoB,CAAC;QAEpD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YACnD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;aACjC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,EAAE;YAC3B,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACnD,OAAO,GAAG,KAAK,KAAK,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAC1C,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IAEO,qBAAqB,CAAC,UAA0B,EAAE,YAAoB;QAC5E,MAAM,gBAAgB,GAAG,UAAU,CAAC,MAAM,CACxC,CAAC,CAAC,EAAE,EAAE,CAAE,CAAC,CAAC,QAAQ,EAAE,KAAgB,GAAG,YAAY,CACpD,CAAC;QAEF,IAAI,gBAAgB,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAE7C,OAAO,gBAAgB;aACpB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;aACvC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClB,CAAC;IAEO,0BAA0B,CAAC,KAAiB,EAAE,KAAa;QACjE,MAAM,cAAc,GAAG;YACrB,QAAQ,EAAE,kCAAkC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC,yBAAyB;YAC5G,SAAS,EAAE,6CAA6C;YACxD,QAAQ,EAAE,gDAAgD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC,oBAAoB;SACtH,CAAC;QAEF,OAAO;;;QAGH,KAAK,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS;cAC3B,IAAI,CAAC,MAAM,CAAC,UAAU,MAAM,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;;4BAEpD,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;;;;;;;;;;CAUrD,CAAC,IAAI,EAAE,CAAC;IACP,CAAC;IAEO,KAAK,CAAC,qBAAqB,CACjC,UAAsB,EACtB,OAAwB,EACxB,KAAa,EACb,UAA0B;QAE1B,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,iBAAiB,GAAG,UAAU;aACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC;aACxD,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhB,MAAM,KAAK,GAAG;8DAC4C,IAAI,CAAC,MAAM,CAAC,SAAS;;kBAEjE,OAAO,CAAC,KAAK;;;EAG7B,WAAW;;;EAGX,iBAAiB;;;;CAIlB,CAAC,IAAI,EAAE,CAAC;QAEL,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;YAC7D,GAAG,OAAO,CAAC,OAAO;YAClB,iBAAiB,EAAE;gBACjB,qBAAqB,EAAE,IAAI;gBAC3B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;gBAC7B,UAAU,EAAE,KAAK,CAAC,MAAM;aACzB;SACF,CAAC,CAAC;IACL,CAAC;IAEO,oBAAoB,CAC1B,QAAuB,EACvB,KAAa,EACb,MAAc,EACd,OAAgB;QAEhB,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACpD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,MAAM,GAAG,OAAO;YAClB,CAAC,CAAC,kCAAkC,QAAQ,MAAM;YAClD,CAAC,CAAC,kBAAkB,CAAC;QAEvB,MAAM,IAAI,WAAW,MAAM,wBAAwB,IAAI,CAAC,MAAM,CAAC,UAAU,gBAAgB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC;QAExI,MAAM,IAAI,0BAA0B,CAAC;QACrC,KAAK,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,YAAY,EAAE,CAAC;YAC/C,MAAM,IAAI,SAAS,KAAK,KAAK,CAAC;YAC9B,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;YAC7G,CAAC;YACD,MAAM,IAAI,IAAI,CAAC;QACjB,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC;QACzD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC7C,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;YAC/C,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACtD,CAAC;QAED,MAAM,IAAI,4BAA4B,CAAC;QACvC,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,QAAQ,KAAK,KAAK,UAAU,CAAC;QAC9C,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/strategies/debate.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Debate strategy - Agents argue positions, moderator synthesizes
+ */
+import type { SwarmRunOptions, StrategyResult, DebateConfig } from '@cogitator-ai/types';
+import { BaseStrategy } from './base';
+import type { SwarmCoordinator } from '../coordinator';
+export declare class DebateStrategy extends BaseStrategy {
+    private config;
+    constructor(coordinator: SwarmCoordinator, config: DebateConfig);
+    execute(options: SwarmRunOptions): Promise<StrategyResult>;
+    private getPreviousArguments;
+    private buildDebateInstructions;
+    private synthesizeDebate;
+}
+//# 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":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,YAAY,EAGb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,MAAM,CAAe;gBAEjB,WAAW,EAAE,gBAAgB,EAAE,MAAM,EAAE,YAAY;IAQzD,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAmJhE,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,uBAAuB;IA6B/B,OAAO,CAAC,gBAAgB;CAuBzB"}

package/dist/strategies/debate.js

@@ -0,0 +1,171 @@
+/**
+ * Debate strategy - Agents argue positions, moderator synthesizes
+ */
+import { BaseStrategy } from './base';
+export class DebateStrategy extends BaseStrategy {
+    config;
+    constructor(coordinator, config) {
+        super(coordinator);
+        this.config = {
+            format: 'structured',
+            ...config,
+        };
+    }
+    async execute(options) {
+        const agentResults = new Map();
+        const debateTranscript = [];
+        const advocates = this.coordinator.getAgents().filter((a) => a.metadata.role === 'advocate');
+        const critics = this.coordinator.getAgents().filter((a) => a.metadata.role === 'critic');
+        const moderators = this.coordinator.getAgents().filter((a) => a.metadata.role === 'moderator');
+        let debaters = [...advocates, ...critics];
+        if (debaters.length === 0) {
+            debaters = this.coordinator.getAgents().filter((a) => a.metadata.role !== 'moderator');
+        }
+        if (debaters.length < 2) {
+            throw new Error('Debate strategy requires at least 2 debating agents');
+        }
+        const moderator = moderators.length > 0 ? moderators[0] : null;
+        this.coordinator.blackboard.write('debate', {
+            topic: options.input,
+            rounds: this.config.rounds,
+            currentRound: 0,
+            arguments: [],
+        }, 'system');
+        for (let round = 1; round <= this.config.rounds; round++) {
+            this.coordinator.events.emit('debate:round', { round, total: this.config.rounds });
+            const debateState = this.coordinator.blackboard.read('debate');
+            this.coordinator.blackboard.write('debate', {
+                ...debateState,
+                currentRound: round,
+            }, 'system');
+            for (const debater of debaters) {
+                const previousArguments = this.getPreviousArguments(debateTranscript, round);
+                const debaterContext = {
+                    ...options.context,
+                    debateContext: {
+                        round,
+                        totalRounds: this.config.rounds,
+                        role: debater.metadata.role ?? 'debater',
+                        previousArguments,
+                        format: this.config.format,
+                    },
+                    debateInstructions: this.buildDebateInstructions(debater.metadata.role ?? 'debater', round, this.config.rounds, previousArguments),
+                };
+                const input = round === 1
+                    ? options.input
+                    : `Continue the debate on: ${options.input}\n\nPrevious arguments:\n${previousArguments}`;
+                this.coordinator.events.emit('debate:turn', {
+                    round,
+                    agent: debater.agent.name,
+                    role: debater.metadata.role,
+                }, debater.agent.name);
+                const result = await this.coordinator.runAgent(debater.agent.name, input, debaterContext);
+                agentResults.set(`${debater.agent.name}_round${round}`, result);
+                const message = {
+                    id: `debate_${round}_${debater.agent.name}`,
+                    swarmId: '',
+                    from: debater.agent.name,
+                    to: 'broadcast',
+                    type: 'notification',
+                    content: result.output,
+                    channel: 'debate',
+                    timestamp: Date.now(),
+                    metadata: { round, role: debater.metadata.role },
+                };
+                debateTranscript.push(message);
+                const currentDebate = this.coordinator.blackboard.read('debate');
+                currentDebate.arguments.push({
+                    agent: debater.agent.name,
+                    role: debater.metadata.role,
+                    round,
+                    argument: result.output,
+                });
+                this.coordinator.blackboard.write('debate', currentDebate, debater.agent.name);
+            }
+        }
+        let finalOutput;
+        let moderatorResult;
+        if (moderator) {
+            const synthesisInput = `
+Synthesize the following debate on the topic: "${options.input}"
+
+Debate transcript:
+${debateTranscript.map((m) => `[${m.metadata?.role ?? m.from}]: ${m.content}`).join('\n\n')}
+
+Please provide:
+1. A balanced summary of the key arguments from each side
+2. Points of agreement and disagreement
+3. Your assessment of the strongest arguments
+4. A final recommendation or conclusion
+`.trim();
+            moderatorResult = await this.coordinator.runAgent(moderator.agent.name, synthesisInput, {
+                ...options.context,
+                moderatorContext: {
+                    debateRounds: this.config.rounds,
+                    participantCount: debaters.length,
+                    format: this.config.format,
+                },
+            });
+            agentResults.set(moderator.agent.name, moderatorResult);
+            finalOutput = moderatorResult.output;
+        }
+        else {
+            finalOutput = this.synthesizeDebate(debateTranscript, options.input);
+        }
+        return {
+            output: finalOutput,
+            structured: moderatorResult?.structured,
+            agentResults,
+            debateTranscript,
+        };
+    }
+    getPreviousArguments(transcript, currentRound) {
+        const previousMessages = transcript.filter((m) => m.metadata?.round < currentRound);
+        if (previousMessages.length === 0)
+            return '';
+        return previousMessages
+            .map((m) => `[${m.metadata?.role ?? m.from}]: ${m.content}`)
+            .join('\n\n');
+    }
+    buildDebateInstructions(role, round, totalRounds, previousArguments) {
+        const roleInstructions = {
+            advocate: 'You are arguing IN FAVOR of the proposition. Find compelling reasons to support it.',
+            critic: 'You are arguing AGAINST the proposition. Find weaknesses and raise objections.',
+            debater: 'Present your perspective on the topic with well-reasoned arguments.',
+        };
+        const instruction = roleInstructions[role] ?? roleInstructions.debater;
+        return `
+${instruction}
+
+This is round ${round} of ${totalRounds}.
+${previousArguments ? '\nConsider and respond to the previous arguments when formulating your position.' : ''}
+
+Guidelines:
+- Be concise but thorough
+- Support your claims with reasoning
+- Address counterarguments if applicable
+- Maintain a professional and constructive tone
+${this.config.format === 'structured' ? '- Structure your argument with clear points' : ''}
+`.trim();
+    }
+    synthesizeDebate(transcript, topic) {
+        const argumentsByAgent = {};
+        for (const msg of transcript) {
+            const agent = msg.from;
+            if (!argumentsByAgent[agent]) {
+                argumentsByAgent[agent] = [];
+            }
+            argumentsByAgent[agent].push(msg.content);
+        }
+        let summary = `Debate Summary on: "${topic}"\n\n`;
+        for (const [agent, args] of Object.entries(argumentsByAgent)) {
+            summary += `=== ${agent} ===\n`;
+            args.forEach((arg, i) => {
+                summary += `Round ${i + 1}: ${arg.slice(0, 200)}...\n`;
+            });
+            summary += '\n';
+        }
+        return summary;
+    }
+}
+//# 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/hierarchical.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Hierarchical strategy - Supervisor delegates to workers
+ */
+import type { SwarmRunOptions, StrategyResult, HierarchicalConfig } from '@cogitator-ai/types';
+import { BaseStrategy } from './base';
+import type { SwarmCoordinator } from '../coordinator';
+export declare class HierarchicalStrategy extends BaseStrategy {
+    private config;
+    constructor(coordinator: SwarmCoordinator, config?: HierarchicalConfig);
+    execute(options: SwarmRunOptions): Promise<StrategyResult>;
+    private buildDelegationInstructions;
+}
+//# sourceMappingURL=hierarchical.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchical.d.ts","sourceRoot":"","sources":["../../src/strategies/hierarchical.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,kBAAkB,EAEnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,OAAO,CAAC,MAAM,CAAqB;gBAEvB,WAAW,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,kBAAkB;IAWhE,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAsDhE,OAAO,CAAC,2BAA2B;CAkCpC"}

package/dist/strategies/hierarchical.js

@@ -0,0 +1,86 @@
+/**
+ * Hierarchical strategy - Supervisor delegates to workers
+ */
+import { BaseStrategy } from './base';
+export class HierarchicalStrategy extends BaseStrategy {
+    config;
+    constructor(coordinator, config) {
+        super(coordinator);
+        this.config = {
+            maxDelegationDepth: 3,
+            workerCommunication: false,
+            routeThrough: 'supervisor',
+            visibility: 'full',
+            ...config,
+        };
+    }
+    async execute(options) {
+        const agentResults = new Map();
+        const supervisors = this.coordinator.getAgents().filter((a) => a.metadata.role === 'supervisor');
+        if (supervisors.length === 0) {
+            throw new Error('Hierarchical strategy requires a supervisor agent');
+        }
+        const supervisor = supervisors[0];
+        const workers = this.coordinator.getAgents().filter((a) => a.metadata.role === 'worker');
+        const workerInfo = workers.map((w) => ({
+            name: w.agent.name,
+            description: w.agent.config.description ?? w.agent.config.instructions.slice(0, 200),
+            expertise: w.metadata.expertise ?? [],
+        }));
+        const supervisorContext = {
+            ...options.context,
+            availableWorkers: workerInfo,
+            hierarchyConfig: {
+                maxDelegationDepth: this.config.maxDelegationDepth,
+                workerCommunication: this.config.workerCommunication,
+            },
+            delegationInstructions: this.buildDelegationInstructions(workerInfo),
+        };
+        this.coordinator.blackboard.write('tasks', [], 'system');
+        this.coordinator.blackboard.write('workerResults', {}, 'system');
+        const supervisorResult = await this.coordinator.runAgent(supervisor.agent.name, options.input, supervisorContext);
+        agentResults.set(supervisor.agent.name, supervisorResult);
+        for (const worker of workers) {
+            if (worker.lastResult) {
+                agentResults.set(worker.agent.name, worker.lastResult);
+            }
+        }
+        return {
+            output: supervisorResult.output,
+            structured: supervisorResult.structured,
+            agentResults,
+        };
+    }
+    buildDelegationInstructions(workerInfo) {
+        const workerList = workerInfo
+            .map((w) => {
+            const expertise = w.expertise.length > 0 ? ` (expertise: ${w.expertise.join(', ')})` : '';
+            return `- ${w.name}: ${w.description}${expertise}`;
+        })
+            .join('\n');
+        return `
+You are a supervisor managing a team of workers. You can delegate tasks to workers and coordinate their work.
+
+Available workers:
+${workerList}
+
+You can use the following tools to manage your team:
+- delegate_task(worker, task): Assign a task to a specific worker
+- check_progress(worker): Check the status and last output of a worker
+- request_revision(worker, feedback): Ask a worker to revise their work
+
+Your job is to:
+1. Analyze the incoming task
+2. Break it down into subtasks suitable for your workers
+3. Delegate subtasks to appropriate workers
+4. Coordinate and synthesize their outputs
+5. Provide a final response
+
+Important:
+- Workers cannot see each other's outputs unless you share them via your coordination
+- You are responsible for quality control and final output
+- If a worker's output is insufficient, request a revision
+`.trim();
+    }
+}
+//# sourceMappingURL=hierarchical.js.map