@cogitator-ai/swarms 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Cogitator Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,90 @@
+# @cogitator-ai/swarms
+
+Multi-agent swarm coordination for Cogitator. Orchestrate teams of AI agents with various collaboration strategies.
+
+## Installation
+
+```bash
+pnpm add @cogitator-ai/swarms
+```
+
+## Usage
+
+### Hierarchical Swarm
+
+Supervisor delegates tasks to workers:
+
+```typescript
+import { Swarm, SwarmBuilder } from '@cogitator-ai/swarms';
+
+const swarm = new SwarmBuilder('dev-team')
+  .strategy('hierarchical')
+  .supervisor(techLeadAgent)
+  .workers([coderAgent, testerAgent, reviewerAgent])
+  .build();
+
+const result = await swarm.run(cogitator, {
+  input: 'Build a REST API for user management',
+});
+```
+
+### Debate Swarm
+
+Multiple perspectives with synthesis:
+
+```typescript
+const swarm = new SwarmBuilder('analysis-team')
+  .strategy('debate')
+  .agents([optimistAgent, skepticAgent, pragmatistAgent])
+  .config({
+    rounds: 3,
+    moderator: moderatorAgent,
+  })
+  .build();
+```
+
+### Pipeline Swarm
+
+Sequential processing stages:
+
+```typescript
+const swarm = new SwarmBuilder('content-pipeline')
+  .strategy('pipeline')
+  .stages([
+    { agent: ideationAgent, name: 'ideation' },
+    { agent: writerAgent, name: 'writing' },
+    { agent: editorAgent, name: 'editing' },
+  ])
+  .build();
+```
+
+### Communication
+
+Agents can communicate via message bus and shared blackboard:
+
+```typescript
+const swarm = new SwarmBuilder('research-team')
+  .strategy('hierarchical')
+  .supervisor(supervisorAgent)
+  .workers([researcher1, researcher2])
+  .blackboard({ enabled: true, sections: { findings: [] } })
+  .messageBus({ enabled: true })
+  .build();
+```
+
+### Available Strategies
+
+- **hierarchical** - Supervisor-worker delegation
+- **round-robin** - Load-balanced rotation
+- **consensus** - Voting-based decisions
+- **pipeline** - Sequential stages
+- **debate** - Advocate vs critic with synthesis
+- **auction** - Bidding for task assignment
+
+## Documentation
+
+See the [Cogitator documentation](https://github.com/eL1fe/cogitator) for full API reference.
+
+## License
+
+MIT

package/dist/communication/blackboard.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Blackboard for shared state between agents
+ */
+import type { Blackboard, BlackboardConfig, BlackboardSection, BlackboardHistoryEntry } from '@cogitator-ai/types';
+export declare class InMemoryBlackboard implements Blackboard {
+    private sections;
+    private history;
+    private subscriptions;
+    private config;
+    constructor(config: BlackboardConfig);
+    read<T = unknown>(section: string): T;
+    write<T>(section: string, data: T, agentName: string): void;
+    append<T>(section: string, item: T, agentName: string): void;
+    has(section: string): boolean;
+    delete(section: string): void;
+    subscribe(section: string, handler: (data: unknown, agentName: string) => void): () => void;
+    getSections(): string[];
+    getSection<T = unknown>(section: string): BlackboardSection<T> | undefined;
+    getHistory(section: string): BlackboardHistoryEntry[];
+    clear(): void;
+    private notifySubscribers;
+}
+export declare function createBlackboard(config?: Partial<BlackboardConfig>): Blackboard;
+//# sourceMappingURL=blackboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blackboard.d.ts","sourceRoot":"","sources":["../../src/communication/blackboard.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAE7B,qBAAa,kBAAmB,YAAW,UAAU;IACnD,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,OAAO,CAA+C;IAC9D,OAAO,CAAC,aAAa,CAAsE;IAC3F,OAAO,CAAC,MAAM,CAAmB;gBAErB,MAAM,EAAE,gBAAgB;IAyBpC,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC;IAQrC,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAkC3D,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAgB5D,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI7B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAM7B,SAAS,CACP,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,GAClD,MAAM,IAAI;IAiBb,WAAW,IAAI,MAAM,EAAE;IAIvB,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,SAAS;IAI1E,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB,EAAE;IAIrD,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,iBAAiB;CAW1B;AAED,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,UAAU,CAO/E"}

package/dist/communication/blackboard.js

@@ -0,0 +1,135 @@
+/**
+ * Blackboard for shared state between agents
+ */
+export class InMemoryBlackboard {
+    sections = new Map();
+    history = new Map();
+    subscriptions = new Map();
+    config;
+    constructor(config) {
+        this.config = config;
+        for (const [name, initialData] of Object.entries(config.sections)) {
+            this.sections.set(name, {
+                name,
+                data: initialData,
+                lastModified: Date.now(),
+                modifiedBy: 'system',
+                version: 1,
+            });
+            if (config.trackHistory) {
+                this.history.set(name, [
+                    {
+                        value: initialData,
+                        writtenBy: 'system',
+                        timestamp: Date.now(),
+                        version: 1,
+                    },
+                ]);
+            }
+        }
+    }
+    read(section) {
+        const sec = this.sections.get(section);
+        if (!sec) {
+            throw new Error(`Blackboard section '${section}' not found`);
+        }
+        return sec.data;
+    }
+    write(section, data, agentName) {
+        if (!this.config.enabled) {
+            throw new Error('Blackboard is not enabled');
+        }
+        const existing = this.sections.get(section);
+        const version = existing ? existing.version + 1 : 1;
+        const timestamp = Date.now();
+        const newSection = {
+            name: section,
+            data,
+            lastModified: timestamp,
+            modifiedBy: agentName,
+            version,
+        };
+        this.sections.set(section, newSection);
+        if (this.config.trackHistory) {
+            if (!this.history.has(section)) {
+                this.history.set(section, []);
+            }
+            this.history.get(section).push({
+                value: data,
+                writtenBy: agentName,
+                timestamp,
+                version,
+            });
+        }
+        this.notifySubscribers(section, data, agentName);
+    }
+    append(section, item, agentName) {
+        const current = this.sections.get(section);
+        if (!current) {
+            this.write(section, [item], agentName);
+            return;
+        }
+        if (!Array.isArray(current.data)) {
+            throw new Error(`Section '${section}' is not an array, cannot append`);
+        }
+        const newData = [...current.data, item];
+        this.write(section, newData, agentName);
+    }
+    has(section) {
+        return this.sections.has(section);
+    }
+    delete(section) {
+        this.sections.delete(section);
+        this.history.delete(section);
+        this.subscriptions.delete(section);
+    }
+    subscribe(section, handler) {
+        if (!this.subscriptions.has(section)) {
+            this.subscriptions.set(section, new Set());
+        }
+        this.subscriptions.get(section).add(handler);
+        return () => {
+            const handlers = this.subscriptions.get(section);
+            if (handlers) {
+                handlers.delete(handler);
+                if (handlers.size === 0) {
+                    this.subscriptions.delete(section);
+                }
+            }
+        };
+    }
+    getSections() {
+        return Array.from(this.sections.keys());
+    }
+    getSection(section) {
+        return this.sections.get(section);
+    }
+    getHistory(section) {
+        return this.history.get(section) ?? [];
+    }
+    clear() {
+        this.sections.clear();
+        this.history.clear();
+    }
+    notifySubscribers(section, data, agentName) {
+        const handlers = this.subscriptions.get(section);
+        if (handlers) {
+            for (const handler of handlers) {
+                try {
+                    handler(data, agentName);
+                }
+                catch {
+                }
+            }
+        }
+    }
+}
+export function createBlackboard(config) {
+    return new InMemoryBlackboard({
+        enabled: true,
+        sections: {},
+        trackHistory: false,
+        ...config,
+    });
+}
+//# sourceMappingURL=blackboard.js.map

package/dist/communication/blackboard.js.map

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

package/dist/communication/event-emitter.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Event emitter for swarm coordination
+ */
+import type { SwarmEventEmitter, SwarmEventType, SwarmEvent, SwarmEventHandler } from '@cogitator-ai/types';
+export declare class SwarmEventEmitterImpl implements SwarmEventEmitter {
+    private handlers;
+    private events;
+    private maxEvents;
+    constructor(maxEvents?: number);
+    on(event: SwarmEventType | '*', handler: SwarmEventHandler): () => void;
+    once(event: SwarmEventType, handler: SwarmEventHandler): () => void;
+    emit(event: SwarmEventType, data?: unknown, agentName?: string): void;
+    off(event: SwarmEventType | '*', handler: SwarmEventHandler): void;
+    removeAllListeners(event?: SwarmEventType): void;
+    getEvents(): SwarmEvent[];
+    getEventsByType(type: SwarmEventType): SwarmEvent[];
+    getEventsByAgent(agentName: string): SwarmEvent[];
+    clearEvents(): void;
+}
+//# sourceMappingURL=event-emitter.d.ts.map

package/dist/communication/event-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitter.d.ts","sourceRoot":"","sources":["../../src/communication/event-emitter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAE7B,qBAAa,qBAAsB,YAAW,iBAAiB;IAC7D,OAAO,CAAC,QAAQ,CAA2D;IAC3E,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,SAAS,CAAS;gBAEd,SAAS,SAAO;IAI5B,EAAE,CAAC,KAAK,EAAE,cAAc,GAAG,GAAG,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,IAAI;IASvE,IAAI,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,IAAI;IAQnE,IAAI,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAmCrE,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,GAAG,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAUlE,kBAAkB,CAAC,KAAK,CAAC,EAAE,cAAc,GAAG,IAAI;IAQhD,SAAS,IAAI,UAAU,EAAE;IAIzB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,EAAE;IAInD,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE;IAIjD,WAAW,IAAI,IAAI;CAGpB"}

package/dist/communication/event-emitter.js

@@ -0,0 +1,87 @@
+/**
+ * Event emitter for swarm coordination
+ */
+export class SwarmEventEmitterImpl {
+    handlers = new Map();
+    events = [];
+    maxEvents;
+    constructor(maxEvents = 1000) {
+        this.maxEvents = maxEvents;
+    }
+    on(event, handler) {
+        if (!this.handlers.has(event)) {
+            this.handlers.set(event, new Set());
+        }
+        this.handlers.get(event).add(handler);
+        return () => this.off(event, handler);
+    }
+    once(event, handler) {
+        const wrapper = (e) => {
+            this.off(event, wrapper);
+            handler(e);
+        };
+        return this.on(event, wrapper);
+    }
+    emit(event, data, agentName) {
+        const swarmEvent = {
+            type: event,
+            timestamp: Date.now(),
+            agentName,
+            data,
+        };
+        this.events.push(swarmEvent);
+        if (this.events.length > this.maxEvents) {
+            this.events = this.events.slice(-this.maxEvents);
+        }
+        const handlers = this.handlers.get(event);
+        if (handlers) {
+            for (const handler of handlers) {
+                try {
+                    handler(swarmEvent);
+                }
+                catch {
+                }
+            }
+        }
+        const wildcardHandlers = this.handlers.get('*');
+        if (wildcardHandlers) {
+            for (const handler of wildcardHandlers) {
+                try {
+                    handler(swarmEvent);
+                }
+                catch {
+                }
+            }
+        }
+    }
+    off(event, handler) {
+        const handlers = this.handlers.get(event);
+        if (handlers) {
+            handlers.delete(handler);
+            if (handlers.size === 0) {
+                this.handlers.delete(event);
+            }
+        }
+    }
+    removeAllListeners(event) {
+        if (event) {
+            this.handlers.delete(event);
+        }
+        else {
+            this.handlers.clear();
+        }
+    }
+    getEvents() {
+        return [...this.events];
+    }
+    getEventsByType(type) {
+        return this.events.filter((e) => e.type === type);
+    }
+    getEventsByAgent(agentName) {
+        return this.events.filter((e) => e.agentName === agentName);
+    }
+    clearEvents() {
+        this.events = [];
+    }
+}
+//# sourceMappingURL=event-emitter.js.map

package/dist/communication/event-emitter.js.map

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

package/dist/communication/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Communication primitives for swarm coordination
+ */
+export { SwarmEventEmitterImpl } from './event-emitter';
+export { InMemoryMessageBus, createMessageBus } from './message-bus';
+export { InMemoryBlackboard, createBlackboard } from './blackboard';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/communication/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/communication/index.js

@@ -0,0 +1,7 @@
+/**
+ * Communication primitives for swarm coordination
+ */
+export { SwarmEventEmitterImpl } from './event-emitter';
+export { InMemoryMessageBus, createMessageBus } from './message-bus';
+export { InMemoryBlackboard, createBlackboard } from './blackboard';
+//# sourceMappingURL=index.js.map

package/dist/communication/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/communication/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/communication/message-bus.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Message bus for agent-to-agent communication
+ */
+import type { MessageBus, MessageBusConfig, SwarmMessage } from '@cogitator-ai/types';
+export declare class InMemoryMessageBus implements MessageBus {
+    private messages;
+    private subscriptions;
+    private config;
+    private agentMessageCounts;
+    constructor(config: MessageBusConfig);
+    send(message: Omit<SwarmMessage, 'id' | 'timestamp'>): Promise<SwarmMessage>;
+    broadcast(from: string, content: string, channel?: string): Promise<void>;
+    subscribe(agentName: string, handler: (msg: SwarmMessage) => void): () => void;
+    getMessages(agentName: string, limit?: number): SwarmMessage[];
+    getConversation(agent1: string, agent2: string): SwarmMessage[];
+    getAllMessages(): SwarmMessage[];
+    getUnreadMessages(agentName: string): SwarmMessage[];
+    clear(): void;
+    resetTurnCounts(): void;
+    private notifySubscribers;
+}
+export declare function createMessageBus(config?: Partial<MessageBusConfig>): MessageBus;
+//# sourceMappingURL=message-bus.d.ts.map

package/dist/communication/message-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-bus.d.ts","sourceRoot":"","sources":["../../src/communication/message-bus.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,YAAY,EACb,MAAM,qBAAqB,CAAC;AAE7B,qBAAa,kBAAmB,YAAW,UAAU;IACnD,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,aAAa,CAAuD;IAC5E,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,kBAAkB,CAA6B;gBAE3C,MAAM,EAAE,gBAAgB;IAI9B,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IA6C5E,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/E,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI;IAiB9E,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE;IAc9D,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE;IAQ/D,cAAc,IAAI,YAAY,EAAE;IAIhC,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,EAAE;IAQpD,KAAK,IAAI,IAAI;IAKb,eAAe,IAAI,IAAI;IAIvB,OAAO,CAAC,iBAAiB;CAwB1B;AAED,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,UAAU,CAM/E"}

package/dist/communication/message-bus.js

@@ -0,0 +1,128 @@
+/**
+ * Message bus for agent-to-agent communication
+ */
+import { nanoid } from 'nanoid';
+export class InMemoryMessageBus {
+    messages = [];
+    subscriptions = new Map();
+    config;
+    agentMessageCounts = new Map();
+    constructor(config) {
+        this.config = config;
+    }
+    async send(message) {
+        if (!this.config.enabled) {
+            throw new Error('Message bus is not enabled');
+        }
+        if (this.config.maxMessageLength &&
+            message.content.length > this.config.maxMessageLength) {
+            throw new Error(`Message exceeds max length of ${this.config.maxMessageLength} characters`);
+        }
+        if (this.config.maxMessagesPerTurn) {
+            const count = this.agentMessageCounts.get(message.from) ?? 0;
+            if (count >= this.config.maxMessagesPerTurn) {
+                throw new Error(`Agent ${message.from} exceeded max messages per turn (${this.config.maxMessagesPerTurn})`);
+            }
+            this.agentMessageCounts.set(message.from, count + 1);
+        }
+        if (this.config.maxTotalMessages &&
+            this.messages.length >= this.config.maxTotalMessages) {
+            throw new Error(`Max total messages (${this.config.maxTotalMessages}) reached`);
+        }
+        const fullMessage = {
+            ...message,
+            id: `msg_${nanoid(12)}`,
+            timestamp: Date.now(),
+        };
+        this.messages.push(fullMessage);
+        this.notifySubscribers(fullMessage);
+        return fullMessage;
+    }
+    async broadcast(from, content, channel) {
+        await this.send({
+            swarmId: '',
+            from,
+            to: 'broadcast',
+            type: 'notification',
+            content,
+            channel,
+        });
+    }
+    subscribe(agentName, handler) {
+        if (!this.subscriptions.has(agentName)) {
+            this.subscriptions.set(agentName, new Set());
+        }
+        this.subscriptions.get(agentName).add(handler);
+        return () => {
+            const handlers = this.subscriptions.get(agentName);
+            if (handlers) {
+                handlers.delete(handler);
+                if (handlers.size === 0) {
+                    this.subscriptions.delete(agentName);
+                }
+            }
+        };
+    }
+    getMessages(agentName, limit) {
+        const relevant = this.messages.filter((m) => m.to === agentName ||
+            m.to === 'broadcast' ||
+            m.from === agentName);
+        if (limit) {
+            return relevant.slice(-limit);
+        }
+        return relevant;
+    }
+    getConversation(agent1, agent2) {
+        return this.messages.filter((m) => (m.from === agent1 && m.to === agent2) ||
+            (m.from === agent2 && m.to === agent1));
+    }
+    getAllMessages() {
+        return [...this.messages];
+    }
+    getUnreadMessages(agentName) {
+        return this.messages.filter((m) => (m.to === agentName || m.to === 'broadcast') &&
+            m.from !== agentName);
+    }
+    clear() {
+        this.messages = [];
+        this.agentMessageCounts.clear();
+    }
+    resetTurnCounts() {
+        this.agentMessageCounts.clear();
+    }
+    notifySubscribers(message) {
+        if (message.to !== 'broadcast') {
+            const handlers = this.subscriptions.get(message.to);
+            if (handlers) {
+                for (const handler of handlers) {
+                    try {
+                        handler(message);
+                    }
+                    catch {
+                    }
+                }
+            }
+        }
+        else {
+            for (const [agentName, handlers] of this.subscriptions) {
+                if (agentName !== message.from) {
+                    for (const handler of handlers) {
+                        try {
+                            handler(message);
+                        }
+                        catch {
+                        }
+                    }
+                }
+            }
+        }
+    }
+}
+export function createMessageBus(config) {
+    return new InMemoryMessageBus({
+        enabled: true,
+        protocol: 'direct',
+        ...config,
+    });
+}
+//# sourceMappingURL=message-bus.js.map

package/dist/communication/message-bus.js.map

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

package/dist/coordinator.d.ts

@@ -0,0 +1,44 @@
+/**
+ * SwarmCoordinator - Execution engine for multi-agent swarms
+ */
+import type { Cogitator } from '@cogitator-ai/core';
+import type { SwarmConfig, SwarmAgent, SwarmAgentMetadata, RunResult, MessageBus, Blackboard, SwarmEventEmitter, SwarmCoordinatorInterface } from '@cogitator-ai/types';
+export declare class SwarmCoordinator implements SwarmCoordinatorInterface {
+    private cogitator;
+    private config;
+    private agents;
+    private _messageBus;
+    private _blackboard;
+    private _events;
+    private resourceTracker;
+    private circuitBreaker?;
+    private aborted;
+    private paused;
+    private swarmId;
+    constructor(cogitator: Cogitator, config: SwarmConfig);
+    private initializeAgents;
+    get messageBus(): MessageBus;
+    get blackboard(): Blackboard;
+    get events(): SwarmEventEmitter;
+    getSwarmId(): string;
+    getAgent(name: string): SwarmAgent | undefined;
+    getAgents(): SwarmAgent[];
+    getAgentsByRole(role: SwarmAgentMetadata['role']): SwarmAgent[];
+    runAgent(agentName: string, input: string, context?: Record<string, unknown>): Promise<RunResult>;
+    runAgentsParallel(agents: {
+        name: string;
+        input: string;
+        context?: Record<string, unknown>;
+    }[], maxConcurrency?: number): Promise<Map<string, RunResult>>;
+    private handleAgentError;
+    private retryAgentRun;
+    private setAgentState;
+    getResourceUsage(): import("@cogitator-ai/types").SwarmResourceUsage;
+    pause(): void;
+    resume(): void;
+    abort(): void;
+    isAborted(): boolean;
+    isPaused(): boolean;
+    reset(): void;
+}
+//# sourceMappingURL=coordinator.d.ts.map

package/dist/coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../src/coordinator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,EAEV,WAAW,EACX,UAAU,EACV,kBAAkB,EAElB,SAAS,EACT,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,yBAAyB,EAC1B,MAAM,qBAAqB,CAAC;AAS7B,qBAAa,gBAAiB,YAAW,yBAAyB;IAChE,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW;IA2BrD,OAAO,CAAC,gBAAgB;IA2DxB,IAAI,UAAU,IAAI,UAAU,CAE3B;IAED,IAAI,UAAU,IAAI,UAAU,CAE3B;IAED,IAAI,MAAM,IAAI,iBAAiB,CAE9B;IAED,UAAU,IAAI,MAAM;IAIpB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI9C,SAAS,IAAI,UAAU,EAAE;IAIzB,eAAe,CAAC,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAAG,UAAU,EAAE;IAIzD,QAAQ,CACZ,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,SAAS,CAAC;IAiEf,iBAAiB,CACrB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,EAAE,EAC5E,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;YA+BpB,gBAAgB;YAyChB,aAAa;IAoC3B,OAAO,CAAC,aAAa;IAOrB,gBAAgB;IAIhB,KAAK,IAAI,IAAI;IAIb,MAAM,IAAI,IAAI;IAId,KAAK,IAAI,IAAI;IAIb,SAAS,IAAI,OAAO;IAIpB,QAAQ,IAAI,OAAO;IAInB,KAAK,IAAI,IAAI;CAgBd"}