@cogitator-ai/swarms 0.1.0

package/dist/strategies/hierarchical.js.map

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

package/dist/strategies/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Strategy exports and factory
+ */
+import type { SwarmConfig, SwarmStrategy, IStrategy, HierarchicalConfig, RoundRobinConfig, ConsensusConfig, AuctionConfig, PipelineConfig, DebateConfig } from '@cogitator-ai/types';
+import type { SwarmCoordinator } from '../coordinator';
+export { BaseStrategy } from './base';
+export { HierarchicalStrategy } from './hierarchical';
+export { RoundRobinStrategy } from './round-robin';
+export { ConsensusStrategy } from './consensus';
+export { AuctionStrategy } from './auction';
+export { PipelineStrategy } from './pipeline';
+export { DebateStrategy } from './debate';
+/**
+ * Create a strategy instance based on configuration
+ */
+export declare function createStrategy(coordinator: SwarmCoordinator, config: SwarmConfig): IStrategy;
+/**
+ * Get default configuration for a strategy
+ */
+export declare function getDefaultStrategyConfig(strategy: SwarmStrategy): {
+    hierarchical?: HierarchicalConfig;
+    roundRobin?: RoundRobinConfig;
+    consensus?: ConsensusConfig;
+    auction?: AuctionConfig;
+    pipeline?: PipelineConfig;
+    debate?: DebateConfig;
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/strategies/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,SAAS,EACT,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,cAAc,EACd,YAAY,EACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAS1C;;GAEG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,gBAAgB,EAC7B,MAAM,EAAE,WAAW,GAClB,SAAS,CAqCX;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,aAAa,GAAG;IACjE,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,CAyDA"}

package/dist/strategies/index.js

@@ -0,0 +1,106 @@
+/**
+ * Strategy exports and factory
+ */
+export { BaseStrategy } from './base';
+export { HierarchicalStrategy } from './hierarchical';
+export { RoundRobinStrategy } from './round-robin';
+export { ConsensusStrategy } from './consensus';
+export { AuctionStrategy } from './auction';
+export { PipelineStrategy } from './pipeline';
+export { DebateStrategy } from './debate';
+import { HierarchicalStrategy } from './hierarchical';
+import { RoundRobinStrategy } from './round-robin';
+import { ConsensusStrategy } from './consensus';
+import { AuctionStrategy } from './auction';
+import { PipelineStrategy } from './pipeline';
+import { DebateStrategy } from './debate';
+/**
+ * Create a strategy instance based on configuration
+ */
+export function createStrategy(coordinator, config) {
+    const strategy = config.strategy;
+    switch (strategy) {
+        case 'hierarchical':
+            return new HierarchicalStrategy(coordinator, config.hierarchical);
+        case 'round-robin':
+            return new RoundRobinStrategy(coordinator, config.roundRobin);
+        case 'consensus':
+            if (!config.consensus) {
+                throw new Error('Consensus strategy requires consensus configuration');
+            }
+            return new ConsensusStrategy(coordinator, config.consensus);
+        case 'auction':
+            if (!config.auction) {
+                throw new Error('Auction strategy requires auction configuration');
+            }
+            return new AuctionStrategy(coordinator, config.auction);
+        case 'pipeline':
+            if (!config.pipeline) {
+                throw new Error('Pipeline strategy requires pipeline configuration');
+            }
+            return new PipelineStrategy(coordinator, config.pipeline);
+        case 'debate':
+            if (!config.debate) {
+                throw new Error('Debate strategy requires debate configuration');
+            }
+            return new DebateStrategy(coordinator, config.debate);
+        default:
+            throw new Error(`Unknown swarm strategy: ${strategy}`);
+    }
+}
+/**
+ * Get default configuration for a strategy
+ */
+export function getDefaultStrategyConfig(strategy) {
+    switch (strategy) {
+        case 'hierarchical':
+            return {
+                hierarchical: {
+                    maxDelegationDepth: 3,
+                    workerCommunication: false,
+                    routeThrough: 'supervisor',
+                    visibility: 'full',
+                },
+            };
+        case 'round-robin':
+            return {
+                roundRobin: {
+                    sticky: false,
+                    rotation: 'sequential',
+                },
+            };
+        case 'consensus':
+            return {
+                consensus: {
+                    threshold: 0.5,
+                    maxRounds: 3,
+                    resolution: 'majority',
+                    onNoConsensus: 'fail',
+                },
+            };
+        case 'auction':
+            return {
+                auction: {
+                    bidding: 'capability-match',
+                    selection: 'highest-bid',
+                    minBid: 0,
+                },
+            };
+        case 'pipeline':
+            return {
+                pipeline: {
+                    stages: [],
+                },
+            };
+        case 'debate':
+            return {
+                debate: {
+                    rounds: 3,
+                    format: 'structured',
+                },
+            };
+        default:
+            return {};
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/strategies/index.js.map

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

package/dist/strategies/pipeline.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Pipeline strategy - Sequential stages with optional gates
+ */
+import type { SwarmRunOptions, StrategyResult, PipelineConfig } from '@cogitator-ai/types';
+import { BaseStrategy } from './base';
+import type { SwarmCoordinator } from '../coordinator';
+export declare class PipelineStrategy extends BaseStrategy {
+    private config;
+    constructor(coordinator: SwarmCoordinator, config: PipelineConfig);
+    execute(options: SwarmRunOptions): Promise<StrategyResult>;
+    private buildDefaultStageInput;
+    private buildStageInstructions;
+    private checkGate;
+    private getRetryCount;
+}
+//# sourceMappingURL=pipeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/strategies/pipeline.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,cAAc,EAIf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,OAAO,CAAC,MAAM,CAAiB;gBAEnB,WAAW,EAAE,gBAAgB,EAAE,MAAM,EAAE,cAAc;IAS3D,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IA6HhE,OAAO,CAAC,sBAAsB;IAY9B,OAAO,CAAC,sBAAsB;YAahB,SAAS;IA4EvB,OAAO,CAAC,aAAa;CAStB"}

package/dist/strategies/pipeline.js

@@ -0,0 +1,180 @@
+/**
+ * Pipeline strategy - Sequential stages with optional gates
+ */
+import { BaseStrategy } from './base';
+export class PipelineStrategy extends BaseStrategy {
+    config;
+    constructor(coordinator, config) {
+        super(coordinator);
+        this.config = config;
+        if (!config.stages || config.stages.length === 0) {
+            throw new Error('Pipeline strategy requires at least one stage');
+        }
+    }
+    async execute(options) {
+        const agentResults = new Map();
+        const stageOutputs = new Map();
+        this.coordinator.blackboard.write('pipeline', {
+            stages: this.config.stages.map(s => s.name),
+            currentStage: 0,
+            completed: [],
+            failed: [],
+        }, 'system');
+        let currentInput = options.input;
+        let stageIndex = 0;
+        while (stageIndex < this.config.stages.length) {
+            const stage = this.config.stages[stageIndex];
+            this.coordinator.events.emit('pipeline:stage', {
+                index: stageIndex,
+                name: stage.name,
+                total: this.config.stages.length,
+            });
+            const pipelineState = this.coordinator.blackboard.read('pipeline');
+            this.coordinator.blackboard.write('pipeline', {
+                ...pipelineState,
+                currentStage: stageIndex,
+                currentStageName: stage.name,
+            }, 'system');
+            const pipelineContext = {
+                input: options.input,
+                stageIndex,
+                stageName: stage.name,
+                previousOutputs: stageOutputs,
+            };
+            const stageInput = this.config.stageInput
+                ? this.config.stageInput(currentInput, stage, pipelineContext)
+                : this.buildDefaultStageInput(currentInput, stage, pipelineContext);
+            const stageContext = {
+                ...options.context,
+                pipelineContext: {
+                    stageIndex,
+                    stageName: stage.name,
+                    totalStages: this.config.stages.length,
+                    isFirstStage: stageIndex === 0,
+                    isLastStage: stageIndex === this.config.stages.length - 1,
+                    previousOutputs: Object.fromEntries(stageOutputs),
+                },
+                stageInstructions: this.buildStageInstructions(stage, stageIndex),
+            };
+            const result = await this.coordinator.runAgent(stage.agent.name, String(stageInput), stageContext);
+            agentResults.set(stage.name, result);
+            stageOutputs.set(stage.name, result.output);
+            currentInput = result.output;
+            const updatedState = this.coordinator.blackboard.read('pipeline');
+            updatedState.completed.push(stage.name);
+            this.coordinator.blackboard.write('pipeline', updatedState, 'system');
+            if (stage.gate) {
+                const gateResult = await this.checkGate(stage, result, stageIndex, agentResults, options);
+                if (gateResult.action === 'abort') {
+                    throw new Error(`Pipeline aborted at gate '${stage.name}': ${gateResult.reason}`);
+                }
+                if (gateResult.action === 'retry-previous' && stageIndex > 0) {
+                    const state = this.coordinator.blackboard.read('pipeline');
+                    state.failed.push(stage.name);
+                    state.completed = state.completed.filter(s => s !== stage.name);
+                    this.coordinator.blackboard.write('pipeline', state, 'system');
+                    stageIndex = stageIndex - 1;
+                    currentInput = stageOutputs.get(this.config.stages[stageIndex - 1]?.name) ?? options.input;
+                    continue;
+                }
+                if (gateResult.action === 'goto' && gateResult.targetStage !== undefined) {
+                    stageIndex = gateResult.targetStage;
+                    continue;
+                }
+            }
+            this.coordinator.events.emit('pipeline:stage:complete', {
+                index: stageIndex,
+                name: stage.name,
+            });
+            stageIndex++;
+        }
+        const lastStageName = this.config.stages[this.config.stages.length - 1].name;
+        const finalOutput = stageOutputs.get(lastStageName);
+        return {
+            output: finalOutput,
+            agentResults,
+            pipelineOutputs: stageOutputs,
+        };
+    }
+    buildDefaultStageInput(prevOutput, stage, context) {
+        if (context.stageIndex === 0) {
+            return String(prevOutput);
+        }
+        return `Previous stage output:\n${prevOutput}\n\nYour task as the ${stage.name} stage: Process and transform this input according to your role.`;
+    }
+    buildStageInstructions(stage, stageIndex) {
+        const isGate = stage.gate ? '\nThis stage acts as a QUALITY GATE. Your output will be validated before proceeding.' : '';
+        return `
+You are the "${stage.name}" stage in a processing pipeline.
+Stage ${stageIndex + 1} of ${this.config.stages.length}.
+${isGate}
+
+Process the input according to your configured role and pass your output to the next stage.
+Ensure your output is well-structured and ready for the next stage to consume.
+`.trim();
+    }
+    async checkGate(stage, result, _stageIndex, _agentResults, _options) {
+        const gateConfig = this.config.gates?.[stage.name];
+        if (!gateConfig) {
+            const output = String(result.output).toLowerCase();
+            const hasError = output.includes('error') || output.includes('failed') || output.includes('cannot');
+            if (hasError) {
+                this.coordinator.events.emit('pipeline:gate:fail', {
+                    stage: stage.name,
+                    reason: 'Output contains error indicators',
+                });
+                return { action: 'skip', reason: 'Output contains error indicators' };
+            }
+            this.coordinator.events.emit('pipeline:gate:pass', { stage: stage.name });
+            return { action: 'pass' };
+        }
+        let passed;
+        try {
+            passed = gateConfig.condition(result.output);
+        }
+        catch {
+            passed = false;
+        }
+        if (passed) {
+            this.coordinator.events.emit('pipeline:gate:pass', { stage: stage.name });
+            return { action: 'pass' };
+        }
+        this.coordinator.events.emit('pipeline:gate:fail', {
+            stage: stage.name,
+            reason: 'Gate condition failed',
+        });
+        const onFail = gateConfig.onFail;
+        if (onFail === 'abort') {
+            return { action: 'abort', reason: 'Gate condition failed' };
+        }
+        if (onFail === 'skip') {
+            return { action: 'skip', reason: 'Gate condition failed, skipping' };
+        }
+        if (onFail === 'retry-previous') {
+            const retryCount = this.getRetryCount(stage.name, _agentResults);
+            if (retryCount >= gateConfig.maxRetries) {
+                return { action: 'abort', reason: `Max retries (${gateConfig.maxRetries}) exceeded` };
+            }
+            return { action: 'retry-previous' };
+        }
+        if (onFail.startsWith('goto:')) {
+            const targetStageName = onFail.slice(5);
+            const targetIndex = this.config.stages.findIndex(s => s.name === targetStageName);
+            if (targetIndex >= 0) {
+                return { action: 'goto', targetStage: targetIndex };
+            }
+            return { action: 'abort', reason: `Target stage '${targetStageName}' not found` };
+        }
+        return { action: 'pass' };
+    }
+    getRetryCount(stageName, results) {
+        let count = 0;
+        for (const key of results.keys()) {
+            if (key === stageName || key.startsWith(`${stageName}_retry`)) {
+                count++;
+            }
+        }
+        return count - 1;
+    }
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/strategies/pipeline.js.map

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

package/dist/strategies/round-robin.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Round-robin strategy - Rotate task assignment among agents
+ */
+import type { SwarmRunOptions, StrategyResult, RoundRobinConfig } from '@cogitator-ai/types';
+import { BaseStrategy } from './base';
+import type { SwarmCoordinator } from '../coordinator';
+export declare class RoundRobinStrategy extends BaseStrategy {
+    private config;
+    private currentIndex;
+    private stickyAssignments;
+    constructor(coordinator: SwarmCoordinator, config?: RoundRobinConfig);
+    execute(options: SwarmRunOptions): Promise<StrategyResult>;
+    private selectAgent;
+    private getNextAgent;
+    /**
+     * Reset the rotation index
+     */
+    reset(): void;
+    /**
+     * Get current rotation state
+     */
+    getState(): {
+        currentIndex: number;
+        stickyAssignments: Record<string, string>;
+    };
+}
+//# sourceMappingURL=round-robin.d.ts.map

package/dist/strategies/round-robin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"round-robin.d.ts","sourceRoot":"","sources":["../../src/strategies/round-robin.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,gBAAgB,EAGjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,iBAAiB,CAA6B;gBAE1C,WAAW,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,gBAAgB;IAS9D,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC;IAmDhE,OAAO,CAAC,WAAW;IAqBnB,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,QAAQ,IAAI;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC3C;CAMF"}

package/dist/strategies/round-robin.js

@@ -0,0 +1,98 @@
+/**
+ * Round-robin strategy - Rotate task assignment among agents
+ */
+import { BaseStrategy } from './base';
+export class RoundRobinStrategy extends BaseStrategy {
+    config;
+    currentIndex = 0;
+    stickyAssignments = new Map();
+    constructor(coordinator, config) {
+        super(coordinator);
+        this.config = {
+            sticky: false,
+            rotation: 'sequential',
+            ...config,
+        };
+    }
+    async execute(options) {
+        const agentResults = new Map();
+        const agents = this.coordinator.getAgents();
+        if (agents.length === 0) {
+            throw new Error('Round-robin strategy requires at least 1 agent');
+        }
+        const selectedAgent = this.selectAgent(agents, options);
+        this.coordinator.events.emit('round-robin:assigned', {
+            agent: selectedAgent.agent.name,
+            index: this.currentIndex,
+            sticky: this.config.sticky,
+        });
+        this.coordinator.blackboard.write('round-robin', {
+            currentAgent: selectedAgent.agent.name,
+            currentIndex: this.currentIndex,
+            totalAgents: agents.length,
+            stickyEnabled: this.config.sticky,
+        }, 'system');
+        const agentContext = {
+            ...options.context,
+            roundRobinContext: {
+                selectedAgent: selectedAgent.agent.name,
+                totalAgents: agents.length,
+                isSticky: this.config.sticky,
+                rotation: this.config.rotation,
+            },
+        };
+        const result = await this.coordinator.runAgent(selectedAgent.agent.name, options.input, agentContext);
+        agentResults.set(selectedAgent.agent.name, result);
+        if (this.config.rotation === 'sequential' && !this.config.sticky) {
+            this.currentIndex = (this.currentIndex + 1) % agents.length;
+        }
+        return {
+            output: result.output,
+            structured: result.structured,
+            agentResults,
+        };
+    }
+    selectAgent(agents, options) {
+        if (this.config.sticky && this.config.stickyKey) {
+            const key = this.config.stickyKey(options.input);
+            const existingAssignment = this.stickyAssignments.get(key);
+            if (existingAssignment) {
+                const agent = agents.find(a => a.agent.name === existingAssignment);
+                if (agent) {
+                    return agent;
+                }
+                this.stickyAssignments.delete(key);
+            }
+            const selectedAgent = this.getNextAgent(agents);
+            this.stickyAssignments.set(key, selectedAgent.agent.name);
+            return selectedAgent;
+        }
+        return this.getNextAgent(agents);
+    }
+    getNextAgent(agents) {
+        if (this.config.rotation === 'random') {
+            const randomIndex = Math.floor(Math.random() * agents.length);
+            this.currentIndex = randomIndex;
+            return agents[randomIndex];
+        }
+        const agent = agents[this.currentIndex];
+        return agent;
+    }
+    /**
+     * Reset the rotation index
+     */
+    reset() {
+        this.currentIndex = 0;
+        this.stickyAssignments.clear();
+    }
+    /**
+     * Get current rotation state
+     */
+    getState() {
+        return {
+            currentIndex: this.currentIndex,
+            stickyAssignments: Object.fromEntries(this.stickyAssignments),
+        };
+    }
+}
+//# sourceMappingURL=round-robin.js.map

package/dist/strategies/round-robin.js.map

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

package/dist/swarm.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Swarm - Main facade for multi-agent swarm coordination
+ */
+import type { Cogitator } from '@cogitator-ai/core';
+import type { SwarmConfig, SwarmRunOptions, StrategyResult, SwarmAgent, SwarmEventEmitter, SwarmEventType, SwarmEventHandler, MessageBus, Blackboard } from '@cogitator-ai/types';
+export declare class Swarm {
+    private config;
+    private coordinator;
+    private strategy;
+    constructor(cogitator: Cogitator, config: SwarmConfig);
+    /**
+     * Swarm name
+     */
+    get name(): string;
+    /**
+     * Swarm ID
+     */
+    get id(): string;
+    /**
+     * Strategy type
+     */
+    get strategyType(): string;
+    /**
+     * Message bus for agent communication
+     */
+    get messageBus(): MessageBus;
+    /**
+     * Shared blackboard
+     */
+    get blackboard(): Blackboard;
+    /**
+     * Event emitter for swarm events
+     */
+    get events(): SwarmEventEmitter;
+    /**
+     * Run the swarm with the configured strategy
+     */
+    run(options: SwarmRunOptions): Promise<StrategyResult>;
+    /**
+     * Get all agents in the swarm
+     */
+    getAgents(): SwarmAgent[];
+    /**
+     * Get a specific agent by name
+     */
+    getAgent(name: string): SwarmAgent | undefined;
+    /**
+     * Subscribe to swarm events
+     */
+    on(event: SwarmEventType | '*', handler: SwarmEventHandler): () => void;
+    /**
+     * Subscribe to swarm event once
+     */
+    once(event: SwarmEventType | '*', handler: SwarmEventHandler): () => void;
+    /**
+     * Get resource usage
+     */
+    getResourceUsage(): import("@cogitator-ai/types").SwarmResourceUsage;
+    /**
+     * Pause swarm execution
+     */
+    pause(): void;
+    /**
+     * Resume swarm execution
+     */
+    resume(): void;
+    /**
+     * Abort swarm execution
+     */
+    abort(): void;
+    /**
+     * Check if swarm is paused
+     */
+    isPaused(): boolean;
+    /**
+     * Check if swarm is aborted
+     */
+    isAborted(): boolean;
+    /**
+     * Reset swarm state for a new run
+     */
+    reset(): void;
+    private validateConfig;
+}
+/**
+ * Create a swarm with fluent configuration
+ */
+export declare class SwarmBuilder {
+    private config;
+    constructor(name: string);
+    strategy(strategy: SwarmConfig['strategy']): this;
+    supervisor(agent: SwarmConfig['supervisor']): this;
+    workers(agents: SwarmConfig['workers']): this;
+    agents(agents: SwarmConfig['agents']): this;
+    moderator(agent: SwarmConfig['moderator']): this;
+    router(agent: SwarmConfig['router']): this;
+    hierarchical(config: SwarmConfig['hierarchical']): this;
+    roundRobin(config: SwarmConfig['roundRobin']): this;
+    consensus(config: SwarmConfig['consensus']): this;
+    auction(config: SwarmConfig['auction']): this;
+    pipeline(config: SwarmConfig['pipeline']): this;
+    debate(config: SwarmConfig['debate']): this;
+    messaging(config: SwarmConfig['messaging']): this;
+    blackboardConfig(config: SwarmConfig['blackboard']): this;
+    resources(config: SwarmConfig['resources']): this;
+    errorHandling(config: SwarmConfig['errorHandling']): this;
+    build(cogitator: Cogitator): Swarm;
+}
+/**
+ * Create a new swarm builder
+ */
+export declare function swarm(name: string): SwarmBuilder;
+//# sourceMappingURL=swarm.d.ts.map

package/dist/swarm.d.ts.map

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