@cogitator-ai/swarms 0.3.20 → 0.4.0

package/README.md

@@ -655,6 +655,185 @@ swarm.once('swarm:complete', (event) => {
 
 ---
 
+## Distributed Execution
+
+Run swarm agents across multiple workers using Redis-backed communication and BullMQ job queues. Each agent executes as a separate job, enabling horizontal scaling and parallel processing.
+
+### Basic Distributed Swarm
+
+```typescript
+import { Cogitator, Agent } from '@cogitator-ai/core';
+import { SwarmBuilder } from '@cogitator-ai/swarms';
+
+const cogitator = new Cogitator({ defaultModel: 'gpt-4o' });
+
+const swarm = new SwarmBuilder('distributed-team')
+  .strategy('hierarchical')
+  .supervisor(new Agent({ name: 'lead', instructions: 'Coordinate the team' }))
+  .workers([
+    new Agent({ name: 'analyst-1', instructions: 'Analyze data' }),
+    new Agent({ name: 'analyst-2', instructions: 'Analyze data' }),
+    new Agent({ name: 'analyst-3', instructions: 'Analyze data' }),
+  ])
+  .distributed({
+    enabled: true,
+    queue: 'swarm-agent-jobs',
+    timeout: 300000,
+    redis: {
+      host: 'localhost',
+      port: 6379,
+    },
+  })
+  .build(cogitator);
+
+const result = await swarm.run({
+  input: 'Analyze Q4 sales data across all regions',
+});
+
+// Cleanup Redis connections when done
+await swarm.close();
+```
+
+### Distributed Configuration Options
+
+```typescript
+interface DistributedSwarmConfig {
+  enabled: boolean;
+  queue?: string; // Job queue name (default: 'swarm-agent-jobs')
+  workerConcurrency?: number; // Workers per process (default: 4)
+  timeout?: number; // Job timeout in ms (default: 300000)
+  redis?: {
+    host?: string; // Redis host (default: 'localhost')
+    port?: number; // Redis port (default: 6379)
+    password?: string; // Redis password
+    keyPrefix?: string; // Key prefix (default: 'swarm')
+    db?: number; // Redis database (default: 0)
+  };
+  retry?: {
+    maxRetries?: number; // Max retry attempts
+    backoff?: 'constant' | 'linear' | 'exponential';
+    initialDelay?: number; // Initial delay in ms
+    maxDelay?: number; // Max delay in ms
+  };
+  cleanupAfter?: number; // Cleanup keys after ms
+}
+```
+
+### Redis-Backed Communication
+
+Distributed swarms use Redis for shared state synchronization:
+
+```typescript
+import { RedisMessageBus, RedisBlackboard, RedisSwarmEventEmitter } from '@cogitator-ai/swarms';
+import Redis from 'ioredis';
+
+const redis = new Redis({ host: 'localhost', port: 6379 });
+
+// Message bus for agent-to-agent communication
+const messageBus = new RedisMessageBus(
+  { enabled: true, protocol: 'direct' },
+  { redis, swarmId: 'my-swarm', keyPrefix: 'swarm' }
+);
+await messageBus.initialize();
+
+// Shared blackboard for state
+const blackboard = new RedisBlackboard(
+  { enabled: true, sections: { results: [] }, trackHistory: true },
+  { redis, swarmId: 'my-swarm', keyPrefix: 'swarm' }
+);
+await blackboard.initialize();
+
+// Event emitter for cross-worker events
+const events = new RedisSwarmEventEmitter({
+  redis,
+  swarmId: 'my-swarm',
+  keyPrefix: 'swarm',
+});
+await events.initialize();
+```
+
+### Setting Up Workers
+
+Workers process distributed swarm jobs. Use with `@cogitator-ai/worker`:
+
+```typescript
+import { WorkerPool } from '@cogitator-ai/worker';
+
+const pool = new WorkerPool({
+  concurrency: 4,
+  redis: {
+    host: 'localhost',
+    port: 6379,
+  },
+  queues: ['swarm-agent-jobs'],
+});
+
+await pool.start();
+
+// Workers automatically process swarm-agent jobs
+// Each job runs a single agent and publishes results back to Redis
+```
+
+### Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                        Swarm.run()                          │
+│  distributed: true → DistributedSwarmCoordinator            │
+│  distributed: false → SwarmCoordinator (in-memory)          │
+└─────────────────────────────────────────────────────────────┘
+                              │
+              ┌───────────────┴───────────────┐
+              ▼                               ▼
+┌─────────────────────────┐     ┌─────────────────────────────┐
+│  DistributedCoordinator │     │  Redis (Shared State)       │
+│  - dispatches agent jobs│────▶│  - swarm:{id}:blackboard    │
+│  - subscribes to results│     │  - swarm:{id}:messages      │
+│  - coordinates strategy │     │  - swarm:{id}:results       │
+└─────────────────────────┘     └─────────────────────────────┘
+              │                               ▲
+              │ job queue                     │
+              ▼                               │
+┌─────────────────────────┐                   │
+│  BullMQ Queue           │                   │
+│  swarm-agent-jobs       │                   │
+└─────────────────────────┘                   │
+              │                               │
+    ┌─────────┼─────────┐                     │
+    ▼         ▼         ▼                     │
+┌───────┐ ┌───────┐ ┌───────┐                │
+│Worker1│ │Worker2│ │Worker3│ ───────────────┘
+│ Agent │ │ Agent │ │ Agent │  publish results
+└───────┘ └───────┘ └───────┘
+```
+
+### Local vs Distributed
+
+The same swarm works in both modes with identical API:
+
+```typescript
+// Local execution (in-process)
+const localSwarm = new SwarmBuilder('local-team')
+  .strategy('consensus')
+  .agents([agent1, agent2, agent3])
+  .consensus({ threshold: 0.6, maxRounds: 3, resolution: 'majority', onNoConsensus: 'fail' })
+  .build(cogitator);
+
+// Distributed execution (across workers)
+const distributedSwarm = new SwarmBuilder('distributed-team')
+  .strategy('consensus')
+  .agents([agent1, agent2, agent3])
+  .consensus({ threshold: 0.6, maxRounds: 3, resolution: 'majority', onNoConsensus: 'fail' })
+  .distributed({ enabled: true, redis: { host: 'redis.example.com' } })
+  .build(cogitator);
+
+// Same API for both
+const localResult = await localSwarm.run({ input: 'Task...' });
+const distributedResult = await distributedSwarm.run({ input: 'Task...' });
+```
+
+---
+
 ## Swarm Control
 
 ### Pause and Resume
@@ -784,6 +963,19 @@ import type {
 } from '@cogitator-ai/swarms';
 ```
 
+### Distributed Types
+
+```typescript
+import type { DistributedSwarmConfig } from '@cogitator-ai/types';
+
+import {
+  RedisMessageBus,
+  RedisBlackboard,
+  RedisSwarmEventEmitter,
+  DistributedSwarmCoordinator,
+} from '@cogitator-ai/swarms';
+```
+
 ---
 
 ## Examples

package/dist/communication/index.d.ts

@@ -1,7 +1,10 @@
 /**
  * Communication primitives for swarm coordination
  */
-export { SwarmEventEmitterImpl } from './event-emitter';
-export { InMemoryMessageBus, createMessageBus } from './message-bus';
-export { InMemoryBlackboard, createBlackboard } from './blackboard';
+export { SwarmEventEmitterImpl } from './event-emitter.js';
+export { InMemoryMessageBus, createMessageBus } from './message-bus.js';
+export { InMemoryBlackboard, createBlackboard } from './blackboard.js';
+export { RedisMessageBus, type RedisMessageBusOptions } from './redis-message-bus.js';
+export { RedisBlackboard, type RedisBlackboardOptions } from './redis-blackboard.js';
+export { RedisSwarmEventEmitter, type RedisEventEmitterOptions } from './redis-event-emitter.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/communication/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEvE,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,KAAK,wBAAwB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/communication/index.js

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

package/dist/communication/index.js.map

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/communication/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEvE,OAAO,EAAE,eAAe,EAA+B,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAE,eAAe,EAA+B,MAAM,uBAAuB,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAiC,MAAM,0BAA0B,CAAC"}

package/dist/communication/redis-blackboard.d.ts

@@ -0,0 +1,36 @@
+import type { Blackboard, BlackboardConfig, BlackboardSection, BlackboardHistoryEntry } from '@cogitator-ai/types';
+import type { Redis } from 'ioredis';
+export interface RedisBlackboardOptions {
+    redis: Redis;
+    swarmId: string;
+    keyPrefix?: string;
+}
+export declare class RedisBlackboard implements Blackboard {
+    private redis;
+    private subscriber;
+    private swarmId;
+    private keyPrefix;
+    private config;
+    private subscriptions;
+    private localCache;
+    private historyCache;
+    constructor(config: BlackboardConfig, options: RedisBlackboardOptions);
+    private sectionKey;
+    private historyKey;
+    private channelKey;
+    initialize(): Promise<void>;
+    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;
+    close(): Promise<void>;
+    syncFromRedis(): Promise<void>;
+    private notifySubscribers;
+}
+//# sourceMappingURL=redis-blackboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redis-blackboard.d.ts","sourceRoot":"","sources":["../../src/communication/redis-blackboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAUD,qBAAa,eAAgB,YAAW,UAAU;IAChD,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,aAAa,CAAsE;IAC3F,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,YAAY,CAA+C;gBAEvD,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,sBAAsB;IAQrE,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,UAAU;IAIZ,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAyDjC,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;IA2C3D,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;IAQ7B,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAiB3F,WAAW,IAAI,MAAM,EAAE;IAIvB,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,SAAS;IAY1E,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB,EAAE;IAIrD,KAAK,IAAI,IAAI;IAWP,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAepC,OAAO,CAAC,iBAAiB;CAU1B"}

package/dist/communication/redis-blackboard.js

@@ -0,0 +1,203 @@
+export class RedisBlackboard {
+    redis;
+    subscriber;
+    swarmId;
+    keyPrefix;
+    config;
+    subscriptions = new Map();
+    localCache = new Map();
+    historyCache = new Map();
+    constructor(config, options) {
+        this.config = config;
+        this.redis = options.redis;
+        this.subscriber = options.redis.duplicate();
+        this.swarmId = options.swarmId;
+        this.keyPrefix = options.keyPrefix ?? 'swarm';
+    }
+    sectionKey(section) {
+        return `${this.keyPrefix}:${this.swarmId}:blackboard:${section}`;
+    }
+    historyKey(section) {
+        return `${this.keyPrefix}:${this.swarmId}:blackboard:${section}:history`;
+    }
+    channelKey() {
+        return `${this.keyPrefix}:${this.swarmId}:blackboard:changes`;
+    }
+    async initialize() {
+        for (const [name, initialData] of Object.entries(this.config.sections)) {
+            const section = {
+                name,
+                data: initialData,
+                lastModified: Date.now(),
+                modifiedBy: 'system',
+                version: 1,
+            };
+            this.localCache.set(name, section);
+            const existing = await this.redis.get(this.sectionKey(name));
+            if (!existing) {
+                await this.redis.set(this.sectionKey(name), JSON.stringify(section));
+                if (this.config.trackHistory) {
+                    const entry = {
+                        value: initialData,
+                        writtenBy: 'system',
+                        timestamp: Date.now(),
+                        version: 1,
+                    };
+                    await this.redis.rpush(this.historyKey(name), JSON.stringify(entry));
+                    this.historyCache.set(name, [entry]);
+                }
+            }
+            else {
+                const stored = JSON.parse(existing);
+                this.localCache.set(name, stored);
+            }
+        }
+        await this.subscriber.subscribe(this.channelKey());
+        this.subscriber.on('message', (_channel, messageJson) => {
+            try {
+                const { section, data, agentName, version, timestamp } = JSON.parse(messageJson);
+                const stored = {
+                    name: section,
+                    data,
+                    lastModified: timestamp,
+                    modifiedBy: agentName,
+                    version,
+                };
+                this.localCache.set(section, stored);
+                this.notifySubscribers(section, data, agentName);
+            }
+            catch { }
+        });
+    }
+    read(section) {
+        const cached = this.localCache.get(section);
+        if (!cached) {
+            throw new Error(`Blackboard section '${section}' not found`);
+        }
+        return cached.data;
+    }
+    write(section, data, agentName) {
+        if (!this.config.enabled) {
+            throw new Error('Blackboard is not enabled');
+        }
+        const existing = this.localCache.get(section);
+        const version = existing ? existing.version + 1 : 1;
+        const timestamp = Date.now();
+        const newSection = {
+            name: section,
+            data,
+            lastModified: timestamp,
+            modifiedBy: agentName,
+            version,
+        };
+        this.localCache.set(section, newSection);
+        void this.redis.set(this.sectionKey(section), JSON.stringify(newSection));
+        if (this.config.trackHistory) {
+            const entry = {
+                value: data,
+                writtenBy: agentName,
+                timestamp,
+                version,
+            };
+            if (!this.historyCache.has(section)) {
+                this.historyCache.set(section, []);
+            }
+            this.historyCache.get(section).push(entry);
+            void this.redis.rpush(this.historyKey(section), JSON.stringify(entry));
+        }
+        void this.redis.publish(this.channelKey(), JSON.stringify({ section, data, agentName, version, timestamp }));
+        this.notifySubscribers(section, data, agentName);
+    }
+    append(section, item, agentName) {
+        const current = this.localCache.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.localCache.has(section);
+    }
+    delete(section) {
+        this.localCache.delete(section);
+        this.historyCache.delete(section);
+        this.subscriptions.delete(section);
+        void this.redis.del(this.sectionKey(section));
+        void this.redis.del(this.historyKey(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.localCache.keys());
+    }
+    getSection(section) {
+        const cached = this.localCache.get(section);
+        if (!cached)
+            return undefined;
+        return {
+            name: cached.name,
+            data: cached.data,
+            lastModified: cached.lastModified,
+            modifiedBy: cached.modifiedBy,
+            version: cached.version,
+        };
+    }
+    getHistory(section) {
+        return this.historyCache.get(section) ?? [];
+    }
+    clear() {
+        const sections = Array.from(this.localCache.keys());
+        this.localCache.clear();
+        this.historyCache.clear();
+        for (const section of sections) {
+            void this.redis.del(this.sectionKey(section));
+            void this.redis.del(this.historyKey(section));
+        }
+    }
+    async close() {
+        await this.subscriber.unsubscribe();
+        await this.subscriber.quit();
+    }
+    async syncFromRedis() {
+        const pattern = `${this.keyPrefix}:${this.swarmId}:blackboard:*`;
+        const keys = await this.redis.keys(pattern);
+        for (const key of keys) {
+            if (key.endsWith(':history'))
+                continue;
+            const raw = await this.redis.get(key);
+            if (raw) {
+                const stored = JSON.parse(raw);
+                this.localCache.set(stored.name, stored);
+            }
+        }
+    }
+    notifySubscribers(section, data, agentName) {
+        const handlers = this.subscriptions.get(section);
+        if (handlers) {
+            for (const handler of handlers) {
+                void Promise.resolve(handler(data, agentName)).catch((error) => {
+                    console.warn('[RedisBlackboard] Handler error:', error);
+                });
+            }
+        }
+    }
+}
+//# sourceMappingURL=redis-blackboard.js.map

package/dist/communication/redis-blackboard.js.map

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

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

@@ -0,0 +1,36 @@
+import type { SwarmEventEmitter, SwarmEventType, SwarmEvent, SwarmEventHandler } from '@cogitator-ai/types';
+import type { Redis } from 'ioredis';
+export interface RedisEventEmitterOptions {
+    redis: Redis;
+    swarmId: string;
+    keyPrefix?: string;
+    maxEvents?: number;
+}
+export declare class RedisSwarmEventEmitter implements SwarmEventEmitter {
+    private redis;
+    private subscriber;
+    private swarmId;
+    private keyPrefix;
+    private maxEvents;
+    private handlers;
+    private localEvents;
+    constructor(options: RedisEventEmitterOptions);
+    private eventsKey;
+    private channelKey;
+    initialize(): Promise<void>;
+    on(event: SwarmEventType | '*', handler: SwarmEventHandler): () => void;
+    once(event: SwarmEventType, handler: SwarmEventHandler): () => void;
+    emit(event: SwarmEventType, data?: unknown, agentName?: string): void;
+    emitAsync(event: SwarmEventType, data?: unknown, agentName?: string): Promise<void>;
+    off(event: SwarmEventType | '*', handler: SwarmEventHandler): void;
+    removeAllListeners(event?: SwarmEventType): void;
+    getEvents(): SwarmEvent[];
+    getEventsAsync(): Promise<SwarmEvent[]>;
+    getEventsByType(type: SwarmEventType): SwarmEvent[];
+    getEventsByAgent(agentName: string): SwarmEvent[];
+    clearEvents(): void;
+    clearEventsAsync(): Promise<void>;
+    close(): Promise<void>;
+    private notifyHandlers;
+}
+//# sourceMappingURL=redis-event-emitter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redis-event-emitter.d.ts","sourceRoot":"","sources":["../../src/communication/redis-event-emitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,iBAAiB,EAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,sBAAuB,YAAW,iBAAiB;IAC9D,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAA2D;IAC3E,OAAO,CAAC,WAAW,CAAoB;gBAE3B,OAAO,EAAE,wBAAwB;IAQ7C,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,UAAU;IAIZ,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAejC,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;IAUnE,IAAI,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAI/D,SAAS,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBzF,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;IAInB,cAAc,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAK7C,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,EAAE;IAInD,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE;IAIjD,WAAW,IAAI,IAAI;IAIb,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,OAAO,CAAC,cAAc;CAmBvB"}

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

@@ -0,0 +1,130 @@
+export class RedisSwarmEventEmitter {
+    redis;
+    subscriber;
+    swarmId;
+    keyPrefix;
+    maxEvents;
+    handlers = new Map();
+    localEvents = [];
+    constructor(options) {
+        this.redis = options.redis;
+        this.subscriber = options.redis.duplicate();
+        this.swarmId = options.swarmId;
+        this.keyPrefix = options.keyPrefix ?? 'swarm';
+        this.maxEvents = options.maxEvents ?? 1000;
+    }
+    eventsKey() {
+        return `${this.keyPrefix}:${this.swarmId}:events`;
+    }
+    channelKey() {
+        return `${this.keyPrefix}:${this.swarmId}:events:live`;
+    }
+    async initialize() {
+        await this.subscriber.subscribe(this.channelKey());
+        this.subscriber.on('message', (_channel, messageJson) => {
+            try {
+                const event = JSON.parse(messageJson);
+                this.localEvents.push(event);
+                if (this.localEvents.length > this.maxEvents) {
+                    this.localEvents = this.localEvents.slice(-this.maxEvents);
+                }
+                this.notifyHandlers(event);
+            }
+            catch { }
+        });
+    }
+    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);
+            void Promise.resolve(handler(e)).catch((error) => {
+                console.warn('[RedisSwarmEventEmitter] Once handler error:', error);
+            });
+        };
+        return this.on(event, wrapper);
+    }
+    emit(event, data, agentName) {
+        void this.emitAsync(event, data, agentName);
+    }
+    async emitAsync(event, data, agentName) {
+        const swarmEvent = {
+            type: event,
+            timestamp: Date.now(),
+            agentName,
+            data,
+        };
+        const eventJson = JSON.stringify(swarmEvent);
+        await this.redis.rpush(this.eventsKey(), eventJson);
+        const len = await this.redis.llen(this.eventsKey());
+        if (len > this.maxEvents) {
+            await this.redis.ltrim(this.eventsKey(), len - this.maxEvents, -1);
+        }
+        await this.redis.publish(this.channelKey(), eventJson);
+    }
+    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.localEvents];
+    }
+    async getEventsAsync() {
+        const raw = await this.redis.lrange(this.eventsKey(), 0, -1);
+        return raw.map((r) => JSON.parse(r));
+    }
+    getEventsByType(type) {
+        return this.localEvents.filter((e) => e.type === type);
+    }
+    getEventsByAgent(agentName) {
+        return this.localEvents.filter((e) => e.agentName === agentName);
+    }
+    clearEvents() {
+        this.localEvents = [];
+    }
+    async clearEventsAsync() {
+        await this.redis.del(this.eventsKey());
+        this.localEvents = [];
+    }
+    async close() {
+        await this.subscriber.unsubscribe();
+        await this.subscriber.quit();
+    }
+    notifyHandlers(event) {
+        const handlers = this.handlers.get(event.type);
+        if (handlers) {
+            for (const handler of handlers) {
+                void Promise.resolve(handler(event)).catch((error) => {
+                    console.warn('[RedisSwarmEventEmitter] Handler error:', error);
+                });
+            }
+        }
+        const wildcardHandlers = this.handlers.get('*');
+        if (wildcardHandlers) {
+            for (const handler of wildcardHandlers) {
+                void Promise.resolve(handler(event)).catch((error) => {
+                    console.warn('[RedisSwarmEventEmitter] Wildcard handler error:', error);
+                });
+            }
+        }
+    }
+}
+//# sourceMappingURL=redis-event-emitter.js.map