@cogitator-ai/swarms 0.1.0

package/dist/tools/voting.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Swarm voting tools for consensus decision-making
+ */
+import type { Blackboard, SwarmEventEmitter } from '@cogitator-ai/types';
+/**
+ * Create voting tools for consensus strategies
+ */
+export declare function createVotingTools(blackboard: Blackboard, events: SwarmEventEmitter, currentAgent: string, agentWeight?: number): {
+    castVote: import("@cogitator-ai/types").Tool<{
+        decision: string;
+        reasoning?: string | undefined;
+        confidence?: number | undefined;
+    }, {
+        success: boolean;
+        error: string;
+        voteRecorded?: undefined;
+        round?: undefined;
+        decision?: undefined;
+        weight?: undefined;
+    } | {
+        success: boolean;
+        voteRecorded: boolean;
+        round: number;
+        decision: string;
+        weight: number;
+        error?: undefined;
+    }>;
+    getVotes: import("@cogitator-ai/types").Tool<{
+        round?: number | undefined;
+        includeReasoning?: boolean | undefined;
+    }, {
+        success: boolean;
+        error: string;
+        votes: never[];
+        currentRound?: undefined;
+        totalVotes?: undefined;
+        threshold?: undefined;
+        resolution?: undefined;
+        summary?: undefined;
+    } | {
+        success: boolean;
+        currentRound: number;
+        totalVotes: number;
+        threshold: number;
+        resolution: string;
+        votes: {
+            reasoning?: string | undefined;
+            agent: string;
+            decision: string;
+            round: number;
+            weight: number;
+        }[];
+        summary: {
+            decision: string;
+            count: number;
+            weightedCount: number;
+            voters: string[];
+        }[];
+        error?: undefined;
+    }>;
+    changeVote: import("@cogitator-ai/types").Tool<{
+        newDecision: string;
+        reasoning?: string | undefined;
+    }, {
+        success: boolean;
+        error: string;
+        previousDecision?: undefined;
+        newDecision?: undefined;
+        round?: undefined;
+    } | {
+        success: boolean;
+        previousDecision: string | null;
+        newDecision: string;
+        round: number;
+        error?: undefined;
+    }>;
+    getConsensusStatus: import("@cogitator-ai/types").Tool<{}, {
+        active: boolean;
+        error: string;
+        topic?: undefined;
+        currentRound?: undefined;
+        maxRounds?: undefined;
+        roundsRemaining?: undefined;
+        threshold?: undefined;
+        resolution?: undefined;
+        currentVotes?: undefined;
+        leadingDecision?: undefined;
+        leadingVotes?: undefined;
+        consensusRatio?: undefined;
+        wouldReachConsensus?: undefined;
+        hasVoted?: undefined;
+    } | {
+        active: boolean;
+        topic: string;
+        currentRound: number;
+        maxRounds: number;
+        roundsRemaining: number;
+        threshold: number;
+        resolution: string;
+        currentVotes: number;
+        leadingDecision: string;
+        leadingVotes: number;
+        consensusRatio: number;
+        wouldReachConsensus: boolean;
+        hasVoted: boolean;
+        error?: undefined;
+    }>;
+};
+export type VotingTools = ReturnType<typeof createVotingTools>;
+//# sourceMappingURL=voting.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"voting.d.ts","sourceRoot":"","sources":["../../src/tools/voting.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAWzE;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,iBAAiB,EACzB,YAAY,EAAE,MAAM,EACpB,WAAW,SAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkPhB;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/tools/voting.js

@@ -0,0 +1,201 @@
+/**
+ * Swarm voting tools for consensus decision-making
+ */
+import { z } from 'zod';
+import { tool } from '@cogitator-ai/core';
+/**
+ * Create voting tools for consensus strategies
+ */
+export function createVotingTools(blackboard, events, currentAgent, agentWeight = 1) {
+    const castVote = tool({
+        name: 'cast_vote',
+        description: 'Cast a vote in the current consensus round',
+        parameters: z.object({
+            decision: z.string().describe('Your decision/vote'),
+            reasoning: z.string().optional().describe('Optional reasoning for your vote'),
+            confidence: z.number().optional().describe('Confidence level 0-1 (optional, affects display only)'),
+        }),
+        execute: async ({ decision, reasoning, confidence }) => {
+            const consensusState = blackboard.read('consensus');
+            if (!consensusState) {
+                return {
+                    success: false,
+                    error: 'No active consensus session',
+                };
+            }
+            const vote = {
+                agentName: currentAgent,
+                decision,
+                reasoning,
+                weight: agentWeight,
+                round: consensusState.currentRound,
+                timestamp: Date.now(),
+            };
+            consensusState.votes.push(vote);
+            blackboard.write('consensus', consensusState, currentAgent);
+            events.emit('consensus:vote', {
+                agent: currentAgent,
+                decision,
+                round: consensusState.currentRound,
+                confidence,
+            }, currentAgent);
+            return {
+                success: true,
+                voteRecorded: true,
+                round: consensusState.currentRound,
+                decision,
+                weight: agentWeight,
+            };
+        },
+    });
+    const getVotes = tool({
+        name: 'get_votes',
+        description: 'Get all votes cast in the current consensus session',
+        parameters: z.object({
+            round: z.number().optional().describe('Specific round to get votes for (all rounds if omitted)'),
+            includeReasoning: z.boolean().optional().describe('Include vote reasoning'),
+        }),
+        execute: async ({ round, includeReasoning = false }) => {
+            const consensusState = blackboard.read('consensus');
+            if (!consensusState) {
+                return {
+                    success: false,
+                    error: 'No active consensus session',
+                    votes: [],
+                };
+            }
+            let votes = consensusState.votes;
+            if (round !== undefined) {
+                votes = votes.filter(v => v.round === round);
+            }
+            const voteCounts = new Map();
+            for (const vote of votes) {
+                const key = vote.decision.toLowerCase().trim();
+                const existing = voteCounts.get(key) ?? { count: 0, weighted: 0, voters: [] };
+                existing.count++;
+                existing.weighted += vote.weight;
+                existing.voters.push(vote.agentName);
+                voteCounts.set(key, existing);
+            }
+            return {
+                success: true,
+                currentRound: consensusState.currentRound,
+                totalVotes: votes.length,
+                threshold: consensusState.threshold,
+                resolution: consensusState.resolution,
+                votes: votes.map(v => ({
+                    agent: v.agentName,
+                    decision: v.decision,
+                    round: v.round,
+                    weight: v.weight,
+                    ...(includeReasoning ? { reasoning: v.reasoning } : {}),
+                })),
+                summary: Array.from(voteCounts.entries()).map(([decision, data]) => ({
+                    decision,
+                    count: data.count,
+                    weightedCount: data.weighted,
+                    voters: data.voters,
+                })),
+            };
+        },
+    });
+    const changeVote = tool({
+        name: 'change_vote',
+        description: 'Change your previous vote in the current round',
+        parameters: z.object({
+            newDecision: z.string().describe('Your new decision/vote'),
+            reasoning: z.string().optional().describe('Reasoning for changing your vote'),
+        }),
+        execute: async ({ newDecision, reasoning }) => {
+            const consensusState = blackboard.read('consensus');
+            if (!consensusState) {
+                return {
+                    success: false,
+                    error: 'No active consensus session',
+                };
+            }
+            const previousVoteIndex = consensusState.votes.findIndex(v => v.agentName === currentAgent && v.round === consensusState.currentRound);
+            const previousDecision = previousVoteIndex >= 0
+                ? consensusState.votes[previousVoteIndex].decision
+                : null;
+            if (previousVoteIndex >= 0) {
+                consensusState.votes.splice(previousVoteIndex, 1);
+            }
+            const vote = {
+                agentName: currentAgent,
+                decision: newDecision,
+                reasoning,
+                weight: agentWeight,
+                round: consensusState.currentRound,
+                timestamp: Date.now(),
+            };
+            consensusState.votes.push(vote);
+            blackboard.write('consensus', consensusState, currentAgent);
+            events.emit('consensus:vote:changed', {
+                agent: currentAgent,
+                previousDecision,
+                newDecision,
+                round: consensusState.currentRound,
+            }, currentAgent);
+            return {
+                success: true,
+                previousDecision,
+                newDecision,
+                round: consensusState.currentRound,
+            };
+        },
+    });
+    const getConsensusStatus = tool({
+        name: 'get_consensus_status',
+        description: 'Get the current status of the consensus session',
+        parameters: z.object({}),
+        execute: async () => {
+            const consensusState = blackboard.read('consensus');
+            if (!consensusState) {
+                return {
+                    active: false,
+                    error: 'No active consensus session',
+                };
+            }
+            const currentRoundVotes = consensusState.votes.filter(v => v.round === consensusState.currentRound);
+            const voteCounts = new Map();
+            for (const vote of currentRoundVotes) {
+                const key = vote.decision.toLowerCase().trim();
+                voteCounts.set(key, (voteCounts.get(key) ?? 0) + 1);
+            }
+            const totalVotes = currentRoundVotes.length;
+            let leadingDecision = '';
+            let leadingCount = 0;
+            for (const [decision, count] of voteCounts) {
+                if (count > leadingCount) {
+                    leadingCount = count;
+                    leadingDecision = decision;
+                }
+            }
+            const consensusRatio = totalVotes > 0 ? leadingCount / totalVotes : 0;
+            const wouldReachConsensus = consensusRatio >= consensusState.threshold;
+            return {
+                active: true,
+                topic: consensusState.topic,
+                currentRound: consensusState.currentRound,
+                maxRounds: consensusState.maxRounds,
+                roundsRemaining: consensusState.maxRounds - consensusState.currentRound,
+                threshold: consensusState.threshold,
+                resolution: consensusState.resolution,
+                currentVotes: totalVotes,
+                leadingDecision,
+                leadingVotes: leadingCount,
+                consensusRatio: Math.round(consensusRatio * 100) / 100,
+                wouldReachConsensus,
+                hasVoted: currentRoundVotes.some(v => v.agentName === currentAgent),
+            };
+        },
+    });
+    return {
+        castVote,
+        getVotes,
+        changeVote,
+        getConsensusStatus,
+    };
+}
+//# sourceMappingURL=voting.js.map

package/dist/tools/voting.js.map

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

package/dist/workflow/swarm-node.d.ts

@@ -0,0 +1,43 @@
+/**
+ * SwarmNode - Run a swarm as a workflow node
+ */
+import type { WorkflowNode, WorkflowState, NodeContext, SwarmConfig, SwarmRunOptions, StrategyResult } from '@cogitator-ai/types';
+import type { Cogitator } from '@cogitator-ai/core';
+import { Swarm } from '../swarm';
+/**
+ * Extended context with Cogitator for swarm nodes
+ */
+export interface SwarmNodeContext<S = WorkflowState> extends NodeContext<S> {
+    cogitator: Cogitator;
+}
+export interface SwarmNodeOptions<S = WorkflowState> {
+    /**
+     * Map swarm result to state updates
+     */
+    stateMapper?: (result: StrategyResult) => Partial<S>;
+    /**
+     * Map current state to swarm input
+     */
+    inputMapper?: (state: S, input?: unknown) => string;
+    /**
+     * Additional run options for the swarm
+     */
+    runOptions?: Partial<SwarmRunOptions>;
+}
+/**
+ * Create a workflow node that runs a swarm
+ */
+export declare function swarmNode<S extends WorkflowState = WorkflowState>(swarmOrConfig: Swarm | SwarmConfig, options?: SwarmNodeOptions<S>): WorkflowNode<S>;
+/**
+ * Create a conditional swarm node that only runs if condition is met
+ */
+export declare function conditionalSwarmNode<S extends WorkflowState = WorkflowState>(swarmOrConfig: Swarm | SwarmConfig, condition: (state: S, ctx: NodeContext<S>) => boolean, options?: SwarmNodeOptions<S>): WorkflowNode<S>;
+/**
+ * Create a node that runs multiple swarms in parallel and merges results
+ */
+export declare function parallelSwarmsNode<S extends WorkflowState = WorkflowState>(swarms: {
+    swarm: Swarm | SwarmConfig;
+    key: string;
+    options?: SwarmNodeOptions<S>;
+}[], mergeResults?: (results: Record<string, StrategyResult>) => Partial<S>): WorkflowNode<S>;
+//# sourceMappingURL=swarm-node.d.ts.map

package/dist/workflow/swarm-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm-node.d.ts","sourceRoot":"","sources":["../../src/workflow/swarm-node.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,WAAW,EAEX,WAAW,EACX,eAAe,EACf,cAAc,EACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEjC;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,aAAa,CAAE,SAAQ,WAAW,CAAC,CAAC,CAAC;IACzE,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,aAAa;IACjD;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;IAErD;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,MAAM,CAAC;IAEpD;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;CACvC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,EAC/D,aAAa,EAAE,KAAK,GAAG,WAAW,EAClC,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC5B,YAAY,CAAC,CAAC,CAAC,CA6CjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,EAC1E,aAAa,EAAE,KAAK,GAAG,WAAW,EAClC,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO,EACrD,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC5B,YAAY,CAAC,CAAC,CAAC,CAcjB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa,EACxE,MAAM,EAAE;IACN,KAAK,EAAE,KAAK,GAAG,WAAW,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;CAC/B,EAAE,EACH,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GACrE,YAAY,CAAC,CAAC,CAAC,CA4CjB"}

package/dist/workflow/swarm-node.js

@@ -0,0 +1,111 @@
+/**
+ * SwarmNode - Run a swarm as a workflow node
+ */
+import { Swarm } from '../swarm';
+/**
+ * Create a workflow node that runs a swarm
+ */
+export function swarmNode(swarmOrConfig, options) {
+    const name = swarmOrConfig instanceof Swarm
+        ? swarmOrConfig.name
+        : swarmOrConfig.name;
+    return {
+        name: `swarm:${name}`,
+        fn: async (ctx) => {
+            const extCtx = ctx;
+            const swarm = swarmOrConfig instanceof Swarm
+                ? swarmOrConfig
+                : new Swarm(extCtx.cogitator, swarmOrConfig);
+            let input;
+            if (options?.inputMapper) {
+                input = options.inputMapper(ctx.state, ctx.input);
+            }
+            else if (typeof ctx.input === 'string') {
+                input = ctx.input;
+            }
+            else if (ctx.input !== undefined) {
+                input = JSON.stringify(ctx.input);
+            }
+            else {
+                input = JSON.stringify(ctx.state);
+            }
+            const result = await swarm.run({
+                input,
+                context: {
+                    workflowContext: {
+                        nodeId: ctx.nodeId,
+                        step: ctx.step,
+                        workflowState: ctx.state,
+                    },
+                },
+                ...options?.runOptions,
+            });
+            const stateUpdate = options?.stateMapper?.(result);
+            return {
+                state: stateUpdate,
+                output: result.output,
+            };
+        },
+    };
+}
+/**
+ * Create a conditional swarm node that only runs if condition is met
+ */
+export function conditionalSwarmNode(swarmOrConfig, condition, options) {
+    const baseNode = swarmNode(swarmOrConfig, options);
+    return {
+        name: baseNode.name,
+        fn: async (ctx) => {
+            if (!condition(ctx.state, ctx)) {
+                return {
+                    output: null,
+                };
+            }
+            return baseNode.fn(ctx);
+        },
+    };
+}
+/**
+ * Create a node that runs multiple swarms in parallel and merges results
+ */
+export function parallelSwarmsNode(swarms, mergeResults) {
+    return {
+        name: `parallel-swarms:${swarms.map(s => {
+            const swarm = s.swarm instanceof Swarm ? s.swarm : s.swarm;
+            return 'name' in swarm ? swarm.name : 'unnamed';
+        }).join(',')}`,
+        fn: async (ctx) => {
+            const extCtx = ctx;
+            const results = {};
+            await Promise.all(swarms.map(async ({ swarm: swarmOrConfig, key, options }) => {
+                const swarm = swarmOrConfig instanceof Swarm
+                    ? swarmOrConfig
+                    : new Swarm(extCtx.cogitator, swarmOrConfig);
+                let input;
+                if (options?.inputMapper) {
+                    input = options.inputMapper(ctx.state, ctx.input);
+                }
+                else if (typeof ctx.input === 'string') {
+                    input = ctx.input;
+                }
+                else if (ctx.input !== undefined) {
+                    input = JSON.stringify(ctx.input);
+                }
+                else {
+                    input = JSON.stringify(ctx.state);
+                }
+                const result = await swarm.run({
+                    input,
+                    ...options?.runOptions,
+                });
+                results[key] = result;
+            }));
+            const stateUpdate = mergeResults?.(results);
+            return {
+                state: stateUpdate,
+                output: results,
+            };
+        },
+    };
+}
+//# sourceMappingURL=swarm-node.js.map

package/dist/workflow/swarm-node.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@cogitator-ai/swarms",
+  "version": "0.1.0",
+  "description": "Multi-agent swarm coordination for Cogitator",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "nanoid": "^5.0.4",
+    "zod": "^3.22.0",
+    "@cogitator-ai/workflows": "0.1.0",
+    "@cogitator-ai/types": "0.1.0",
+    "@cogitator-ai/core": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/eL1fe/cogitator.git",
+    "directory": "packages/swarms"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}