@cogitator-ai/swarms 0.1.0

package/dist/swarm.js

@@ -0,0 +1,280 @@
+/**
+ * Swarm - Main facade for multi-agent swarm coordination
+ */
+import { SwarmCoordinator } from './coordinator';
+import { createStrategy } from './strategies/index';
+export class Swarm {
+    config;
+    coordinator;
+    strategy;
+    constructor(cogitator, config) {
+        this.config = this.validateConfig(config);
+        this.coordinator = new SwarmCoordinator(cogitator, config);
+        this.strategy = createStrategy(this.coordinator, config);
+    }
+    /**
+     * Swarm name
+     */
+    get name() {
+        return this.config.name;
+    }
+    /**
+     * Swarm ID
+     */
+    get id() {
+        return this.coordinator.getSwarmId();
+    }
+    /**
+     * Strategy type
+     */
+    get strategyType() {
+        return this.config.strategy;
+    }
+    /**
+     * Message bus for agent communication
+     */
+    get messageBus() {
+        return this.coordinator.messageBus;
+    }
+    /**
+     * Shared blackboard
+     */
+    get blackboard() {
+        return this.coordinator.blackboard;
+    }
+    /**
+     * Event emitter for swarm events
+     */
+    get events() {
+        return this.coordinator.events;
+    }
+    /**
+     * Run the swarm with the configured strategy
+     */
+    async run(options) {
+        this.coordinator.events.emit('swarm:start', {
+            swarmId: this.id,
+            strategy: this.config.strategy,
+            input: options.input.slice(0, 100),
+        });
+        try {
+            const result = await this.strategy.execute(options);
+            this.coordinator.events.emit('swarm:complete', {
+                swarmId: this.id,
+                outputLength: typeof result.output === 'string' ? result.output.length : 0,
+                agentCount: result.agentResults.size,
+            });
+            return result;
+        }
+        catch (error) {
+            this.coordinator.events.emit('swarm:error', {
+                swarmId: this.id,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+            throw error;
+        }
+    }
+    /**
+     * Get all agents in the swarm
+     */
+    getAgents() {
+        return this.coordinator.getAgents();
+    }
+    /**
+     * Get a specific agent by name
+     */
+    getAgent(name) {
+        return this.coordinator.getAgent(name);
+    }
+    /**
+     * Subscribe to swarm events
+     */
+    on(event, handler) {
+        return this.coordinator.events.on(event, handler);
+    }
+    /**
+     * Subscribe to swarm event once
+     */
+    once(event, handler) {
+        return this.coordinator.events.once(event, handler);
+    }
+    /**
+     * Get resource usage
+     */
+    getResourceUsage() {
+        return this.coordinator.getResourceUsage();
+    }
+    /**
+     * Pause swarm execution
+     */
+    pause() {
+        this.coordinator.pause();
+        this.coordinator.events.emit('swarm:paused', { swarmId: this.id });
+    }
+    /**
+     * Resume swarm execution
+     */
+    resume() {
+        this.coordinator.resume();
+        this.coordinator.events.emit('swarm:resumed', { swarmId: this.id });
+    }
+    /**
+     * Abort swarm execution
+     */
+    abort() {
+        this.coordinator.abort();
+        this.coordinator.events.emit('swarm:aborted', { swarmId: this.id });
+    }
+    /**
+     * Check if swarm is paused
+     */
+    isPaused() {
+        return this.coordinator.isPaused();
+    }
+    /**
+     * Check if swarm is aborted
+     */
+    isAborted() {
+        return this.coordinator.isAborted();
+    }
+    /**
+     * Reset swarm state for a new run
+     */
+    reset() {
+        this.coordinator.reset();
+        this.coordinator.events.emit('swarm:reset', { swarmId: this.id });
+    }
+    validateConfig(config) {
+        const validStrategies = [
+            'hierarchical',
+            'round-robin',
+            'consensus',
+            'auction',
+            'pipeline',
+            'debate',
+        ];
+        if (!validStrategies.includes(config.strategy)) {
+            throw new Error(`Invalid swarm strategy: ${config.strategy}. Valid strategies: ${validStrategies.join(', ')}`);
+        }
+        switch (config.strategy) {
+            case 'hierarchical':
+                if (!config.supervisor) {
+                    throw new Error('Hierarchical strategy requires a supervisor agent');
+                }
+                break;
+            case 'pipeline':
+                if (!config.pipeline?.stages || config.pipeline.stages.length === 0) {
+                    throw new Error('Pipeline strategy requires at least one stage');
+                }
+                break;
+            case 'consensus':
+                if (!config.consensus) {
+                    throw new Error('Consensus strategy requires consensus configuration');
+                }
+                if (!config.agents || config.agents.length < 2) {
+                    throw new Error('Consensus strategy requires at least 2 agents');
+                }
+                break;
+            case 'debate':
+                if (!config.debate) {
+                    throw new Error('Debate strategy requires debate configuration');
+                }
+                break;
+            case 'auction':
+                if (!config.auction) {
+                    throw new Error('Auction strategy requires auction configuration');
+                }
+                break;
+        }
+        return config;
+    }
+}
+/**
+ * Create a swarm with fluent configuration
+ */
+export class SwarmBuilder {
+    config = {};
+    constructor(name) {
+        this.config.name = name;
+    }
+    strategy(strategy) {
+        this.config.strategy = strategy;
+        return this;
+    }
+    supervisor(agent) {
+        this.config.supervisor = agent;
+        return this;
+    }
+    workers(agents) {
+        this.config.workers = agents;
+        return this;
+    }
+    agents(agents) {
+        this.config.agents = agents;
+        return this;
+    }
+    moderator(agent) {
+        this.config.moderator = agent;
+        return this;
+    }
+    router(agent) {
+        this.config.router = agent;
+        return this;
+    }
+    hierarchical(config) {
+        this.config.hierarchical = config;
+        return this;
+    }
+    roundRobin(config) {
+        this.config.roundRobin = config;
+        return this;
+    }
+    consensus(config) {
+        this.config.consensus = config;
+        return this;
+    }
+    auction(config) {
+        this.config.auction = config;
+        return this;
+    }
+    pipeline(config) {
+        this.config.pipeline = config;
+        return this;
+    }
+    debate(config) {
+        this.config.debate = config;
+        return this;
+    }
+    messaging(config) {
+        this.config.messaging = config;
+        return this;
+    }
+    blackboardConfig(config) {
+        this.config.blackboard = config;
+        return this;
+    }
+    resources(config) {
+        this.config.resources = config;
+        return this;
+    }
+    errorHandling(config) {
+        this.config.errorHandling = config;
+        return this;
+    }
+    build(cogitator) {
+        if (!this.config.name) {
+            throw new Error('Swarm name is required');
+        }
+        if (!this.config.strategy) {
+            throw new Error('Swarm strategy is required');
+        }
+        return new Swarm(cogitator, this.config);
+    }
+}
+/**
+ * Create a new swarm builder
+ */
+export function swarm(name) {
+    return new SwarmBuilder(name);
+}
+//# sourceMappingURL=swarm.js.map

package/dist/swarm.js.map

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

package/dist/tools/blackboard.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Swarm blackboard tools for shared state management
+ */
+import type { Blackboard } from '@cogitator-ai/types';
+/**
+ * Create blackboard tools bound to a blackboard instance
+ */
+export declare function createBlackboardTools(blackboard: Blackboard, currentAgent: string): {
+    readBlackboard: import("@cogitator-ai/types").Tool<{
+        section: string;
+        key?: string | undefined;
+    }, {
+        found: boolean;
+        section: string;
+        key: string;
+        data: {} | null;
+    } | {
+        found: boolean;
+        section: string;
+        data: {} | null;
+        key?: undefined;
+    }>;
+    writeBlackboard: import("@cogitator-ai/types").Tool<{
+        section: string;
+        data?: unknown;
+        merge?: boolean | undefined;
+    }, {
+        written: boolean;
+        section: string;
+        merged: boolean;
+    }>;
+    appendBlackboard: import("@cogitator-ai/types").Tool<{
+        section: string;
+        item?: unknown;
+    }, {
+        appended: boolean;
+        section: string;
+        error?: undefined;
+    } | {
+        appended: boolean;
+        error: string;
+        section?: undefined;
+    }>;
+    listBlackboardSections: import("@cogitator-ai/types").Tool<{
+        prefix?: string | undefined;
+    }, {
+        sections: string[];
+        count: number;
+    }>;
+    getBlackboardHistory: import("@cogitator-ai/types").Tool<{
+        section: string;
+        limit?: number | undefined;
+    }, {
+        section: string;
+        history: never[];
+        count: number;
+        totalHistory?: undefined;
+    } | {
+        section: string;
+        history: {
+            version: number;
+            writtenBy: string;
+            timestamp: number;
+            hasValue: boolean;
+        }[];
+        count: number;
+        totalHistory: number;
+    }>;
+};
+export type BlackboardTools = ReturnType<typeof createBlackboardTools>;
+//# sourceMappingURL=blackboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blackboard.d.ts","sourceRoot":"","sources":["../../src/tools/blackboard.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwJjF;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/tools/blackboard.js

@@ -0,0 +1,149 @@
+/**
+ * Swarm blackboard tools for shared state management
+ */
+import { z } from 'zod';
+import { tool } from '@cogitator-ai/core';
+/**
+ * Create blackboard tools bound to a blackboard instance
+ */
+export function createBlackboardTools(blackboard, currentAgent) {
+    const readBlackboard = tool({
+        name: 'read_blackboard',
+        description: 'Read data from the shared blackboard',
+        parameters: z.object({
+            section: z.string().describe('The section name to read from'),
+            key: z.string().optional().describe('Specific key within the section (reads entire section if omitted)'),
+        }),
+        execute: async ({ section, key }) => {
+            const data = blackboard.read(section);
+            if (data === undefined) {
+                return {
+                    found: false,
+                    section,
+                    data: null,
+                };
+            }
+            if (key && typeof data === 'object' && data !== null) {
+                const value = data[key];
+                return {
+                    found: value !== undefined,
+                    section,
+                    key,
+                    data: value ?? null,
+                };
+            }
+            return {
+                found: true,
+                section,
+                data,
+            };
+        },
+    });
+    const writeBlackboard = tool({
+        name: 'write_blackboard',
+        description: 'Write data to the shared blackboard',
+        parameters: z.object({
+            section: z.string().describe('The section name to write to'),
+            data: z.unknown().describe('The data to write (will replace existing section data)'),
+            merge: z.boolean().optional().describe('If true and data is an object, merge with existing data'),
+        }),
+        execute: async ({ section, data, merge }) => {
+            if (merge && typeof data === 'object' && data !== null) {
+                const existing = blackboard.read(section);
+                if (existing && typeof existing === 'object') {
+                    const merged = { ...existing, ...data };
+                    blackboard.write(section, merged, currentAgent);
+                    return {
+                        written: true,
+                        section,
+                        merged: true,
+                    };
+                }
+            }
+            blackboard.write(section, data, currentAgent);
+            return {
+                written: true,
+                section,
+                merged: false,
+            };
+        },
+    });
+    const appendBlackboard = tool({
+        name: 'append_blackboard',
+        description: 'Append an item to an array section on the blackboard',
+        parameters: z.object({
+            section: z.string().describe('The section name (must be an array)'),
+            item: z.unknown().describe('The item to append'),
+        }),
+        execute: async ({ section, item }) => {
+            try {
+                blackboard.append(section, item, currentAgent);
+                return {
+                    appended: true,
+                    section,
+                };
+            }
+            catch (error) {
+                return {
+                    appended: false,
+                    error: error instanceof Error ? error.message : 'Failed to append',
+                };
+            }
+        },
+    });
+    const listBlackboardSections = tool({
+        name: 'list_blackboard_sections',
+        description: 'List all available sections on the blackboard',
+        parameters: z.object({
+            prefix: z.string().optional().describe('Filter sections by prefix'),
+        }),
+        execute: async ({ prefix }) => {
+            let sections = blackboard.getSections();
+            if (prefix) {
+                sections = sections.filter(s => s.startsWith(prefix));
+            }
+            return {
+                sections,
+                count: sections.length,
+            };
+        },
+    });
+    const getBlackboardHistory = tool({
+        name: 'get_blackboard_history',
+        description: 'Get the history of changes for a section',
+        parameters: z.object({
+            section: z.string().describe('The section to get history for'),
+            limit: z.number().optional().describe('Maximum number of history entries (default: 10)'),
+        }),
+        execute: async ({ section, limit = 10 }) => {
+            const history = blackboard.getHistory(section);
+            if (!history || history.length === 0) {
+                return {
+                    section,
+                    history: [],
+                    count: 0,
+                };
+            }
+            const entries = history.slice(-limit).map(entry => ({
+                version: entry.version,
+                writtenBy: entry.writtenBy,
+                timestamp: entry.timestamp,
+                hasValue: entry.value !== undefined,
+            }));
+            return {
+                section,
+                history: entries,
+                count: entries.length,
+                totalHistory: history.length,
+            };
+        },
+    });
+    return {
+        readBlackboard,
+        writeBlackboard,
+        appendBlackboard,
+        listBlackboardSections,
+        getBlackboardHistory,
+    };
+}
+//# sourceMappingURL=blackboard.js.map

package/dist/tools/blackboard.js.map

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

package/dist/tools/delegation.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Swarm delegation tools for hierarchical task management
+ */
+import type { SwarmCoordinatorInterface, Blackboard } from '@cogitator-ai/types';
+/**
+ * Create delegation tools for supervisor agents
+ */
+export declare function createDelegationTools(coordinator: SwarmCoordinatorInterface, blackboard: Blackboard, currentAgent: string): {
+    delegateTask: import("@cogitator-ai/types").Tool<{
+        worker: string;
+        task: string;
+        context?: Record<string, unknown> | undefined;
+        priority?: "high" | "normal" | "low" | undefined;
+        waitForCompletion?: boolean | undefined;
+    }, {
+        success: boolean;
+        error: string;
+        availableWorkers: string[];
+        taskId?: undefined;
+        worker?: undefined;
+        async?: undefined;
+        message?: undefined;
+        output?: undefined;
+        usage?: undefined;
+    } | {
+        success: boolean;
+        taskId: string;
+        worker: string;
+        async: boolean;
+        message: string;
+        error?: undefined;
+        availableWorkers?: undefined;
+        output?: undefined;
+        usage?: undefined;
+    } | {
+        success: boolean;
+        taskId: string;
+        worker: string;
+        output: string;
+        usage: {
+            tokens: number;
+            cost: number;
+            duration: number;
+        };
+        error?: undefined;
+        availableWorkers?: undefined;
+        async?: undefined;
+        message?: undefined;
+    } | {
+        success: boolean;
+        taskId: string;
+        worker: string;
+        error: string;
+        availableWorkers?: undefined;
+        async?: undefined;
+        message?: undefined;
+        output?: undefined;
+        usage?: undefined;
+    }>;
+    checkProgress: import("@cogitator-ai/types").Tool<{
+        worker: string;
+    }, {
+        found: boolean;
+        error: string;
+        worker?: undefined;
+        state?: undefined;
+        tokenCount?: undefined;
+        tasks?: undefined;
+        lastTask?: undefined;
+    } | {
+        found: boolean;
+        worker: string;
+        state: import("@cogitator-ai/types").SwarmAgentState;
+        tokenCount: number;
+        tasks: {
+            total: number;
+            completed: number;
+            pending: number;
+            failed: number;
+        };
+        lastTask: {
+            id: string;
+            task: string;
+            status: string;
+            result: unknown;
+        } | null;
+        error?: undefined;
+    }>;
+    requestRevision: import("@cogitator-ai/types").Tool<{
+        worker: string;
+        feedback: string;
+        taskId?: string | undefined;
+    }, {
+        success: boolean;
+        error: string;
+        taskId?: undefined;
+        worker?: undefined;
+        revisedOutput?: undefined;
+    } | {
+        success: boolean;
+        taskId: string;
+        worker: string;
+        revisedOutput: string;
+        error?: undefined;
+    }>;
+    listWorkers: import("@cogitator-ai/types").Tool<{
+        includeMetadata?: boolean | undefined;
+    }, {
+        count: number;
+        workers: {
+            expertise?: string[] | undefined;
+            priority?: number | undefined;
+            name: string;
+            state: import("@cogitator-ai/types").SwarmAgentState;
+            tokenCount: number;
+        }[];
+    }>;
+};
+export type DelegationTools = ReturnType<typeof createDelegationTools>;
+//# sourceMappingURL=delegation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delegation.d.ts","sourceRoot":"","sources":["../../src/tools/delegation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,yBAAyB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjF;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,yBAAyB,EACtC,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwSrB;AAED,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC"}