genesis-ai-cli 7.4.5

package/dist/src/agents/message-bus.js

@@ -0,0 +1,267 @@
+"use strict";
+/**
+ * Genesis 4.0 - Message Bus
+ *
+ * Pub/Sub message bus for agent communication.
+ * Based on EventEmitter pattern with typed messages.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.messageBus = exports.MessageBus = void 0;
+exports.createMessage = createMessage;
+const crypto_1 = require("crypto");
+// ============================================================================
+// Message Bus Class
+// ============================================================================
+class MessageBus {
+    subscriptions = new Map();
+    messageQueue = [];
+    processing = false;
+    messageHistory = [];
+    maxHistorySize = 1000;
+    // Metrics
+    metrics = {
+        messagesSent: 0,
+        messagesDelivered: 0,
+        messagesDropped: 0,
+        startTime: new Date(),
+    };
+    // ============================================================================
+    // Core Methods
+    // ============================================================================
+    /**
+     * Subscribe to messages
+     */
+    subscribe(agentId, handler, filter) {
+        const subscriptionId = (0, crypto_1.randomUUID)();
+        this.subscriptions.set(subscriptionId, {
+            id: subscriptionId,
+            agentId,
+            filter,
+            handler,
+        });
+        return subscriptionId;
+    }
+    /**
+     * Unsubscribe from messages
+     */
+    unsubscribe(subscriptionId) {
+        return this.subscriptions.delete(subscriptionId);
+    }
+    /**
+     * Publish a message
+     */
+    async publish(message) {
+        const fullMessage = {
+            ...message,
+            id: (0, crypto_1.randomUUID)(),
+            timestamp: new Date(),
+        };
+        this.messageQueue.push(fullMessage);
+        this.metrics.messagesSent++;
+        // Store in history
+        this.addToHistory(fullMessage);
+        // Process queue
+        await this.processQueue();
+        return fullMessage.id;
+    }
+    /**
+     * Create and publish a message (helper)
+     */
+    async send(from, to, type, payload, options = {}) {
+        return this.publish({
+            from,
+            to,
+            type,
+            payload,
+            priority: options.priority || 'normal',
+            replyTo: options.replyTo,
+            correlationId: options.correlationId,
+        });
+    }
+    /**
+     * Broadcast to all agents
+     */
+    async broadcast(from, type, payload, priority = 'normal') {
+        return this.send(from, 'broadcast', type, payload, { priority });
+    }
+    // ============================================================================
+    // Queue Processing
+    // ============================================================================
+    async processQueue() {
+        if (this.processing)
+            return;
+        this.processing = true;
+        try {
+            // Sort by priority
+            this.messageQueue.sort((a, b) => {
+                const priorityOrder = { critical: 0, high: 1, normal: 2, low: 3 };
+                return priorityOrder[a.priority] - priorityOrder[b.priority];
+            });
+            while (this.messageQueue.length > 0) {
+                const message = this.messageQueue.shift();
+                await this.deliverMessage(message);
+            }
+        }
+        finally {
+            this.processing = false;
+        }
+    }
+    async deliverMessage(message) {
+        const targetSubscriptions = this.findSubscriptions(message);
+        if (targetSubscriptions.length === 0) {
+            this.metrics.messagesDropped++;
+            return;
+        }
+        // Deliver to all matching subscriptions
+        const deliveryPromises = targetSubscriptions.map(async (sub) => {
+            try {
+                await sub.handler(message);
+                this.metrics.messagesDelivered++;
+            }
+            catch (error) {
+                console.error(`[MessageBus] Error delivering to ${sub.agentId}:`, error);
+            }
+        });
+        await Promise.all(deliveryPromises);
+    }
+    findSubscriptions(message) {
+        const matching = [];
+        for (const sub of this.subscriptions.values()) {
+            // Check if message is for this subscriber
+            if (message.to !== 'broadcast') {
+                // Exact match by ID
+                const exactMatch = message.to === sub.agentId;
+                // Match by agent type (e.g., 'explorer' matches 'explorer-12345678')
+                const typeMatch = sub.agentId.startsWith(message.to + '-');
+                if (!exactMatch && !typeMatch) {
+                    continue;
+                }
+            }
+            // Check filter
+            if (sub.filter) {
+                if (sub.filter.types && !sub.filter.types.includes(message.type)) {
+                    continue;
+                }
+                if (sub.filter.from && !sub.filter.from.includes(message.from)) {
+                    continue;
+                }
+                if (sub.filter.priority && !sub.filter.priority.includes(message.priority)) {
+                    continue;
+                }
+            }
+            matching.push(sub);
+        }
+        return matching;
+    }
+    // ============================================================================
+    // History
+    // ============================================================================
+    addToHistory(message) {
+        this.messageHistory.push(message);
+        if (this.messageHistory.length > this.maxHistorySize) {
+            this.messageHistory.shift();
+        }
+    }
+    getHistory(filter) {
+        let filtered = [...this.messageHistory];
+        if (filter?.from) {
+            filtered = filtered.filter((m) => m.from === filter.from);
+        }
+        if (filter?.to) {
+            filtered = filtered.filter((m) => m.to === filter.to);
+        }
+        if (filter?.type) {
+            filtered = filtered.filter((m) => m.type === filter.type);
+        }
+        if (filter?.limit) {
+            filtered = filtered.slice(-filter.limit);
+        }
+        return filtered;
+    }
+    // ============================================================================
+    // Utilities
+    // ============================================================================
+    /**
+     * Wait for a specific message (useful for request-response)
+     */
+    waitForMessage(filter, timeout = 30000) {
+        return new Promise((resolve, reject) => {
+            const timeoutId = setTimeout(() => {
+                this.unsubscribe(subId);
+                reject(new Error('Message timeout'));
+            }, timeout);
+            // Subscribe using the expected recipient ID so we receive messages addressed to them
+            const subscriberId = filter.to || 'waiter-' + (0, crypto_1.randomUUID)();
+            const subId = this.subscribe(subscriberId, (message) => {
+                let matches = true;
+                if (filter.replyTo && message.replyTo !== filter.replyTo)
+                    matches = false;
+                if (filter.correlationId && message.correlationId !== filter.correlationId)
+                    matches = false;
+                if (filter.type && message.type !== filter.type)
+                    matches = false;
+                if (filter.from && !message.from.startsWith(filter.from))
+                    matches = false;
+                if (matches) {
+                    clearTimeout(timeoutId);
+                    this.unsubscribe(subId);
+                    resolve(message);
+                }
+            });
+        });
+    }
+    /**
+     * Request-response pattern
+     */
+    async request(from, to, type, payload, timeout = 30000) {
+        const correlationId = (0, crypto_1.randomUUID)();
+        // Set up response listener first
+        // We subscribe as 'from' to receive responses addressed to us
+        const responsePromise = this.waitForMessage({ correlationId, from: to, to: from }, timeout);
+        // Send request
+        await this.send(from, to, type, payload, { correlationId });
+        // Wait for response
+        return responsePromise;
+    }
+    // ============================================================================
+    // Metrics
+    // ============================================================================
+    getMetrics() {
+        return {
+            ...this.metrics,
+            uptime: Date.now() - this.metrics.startTime.getTime(),
+            activeSubscriptions: this.subscriptions.size,
+            queueLength: this.messageQueue.length,
+            historySize: this.messageHistory.length,
+        };
+    }
+    // ============================================================================
+    // Cleanup
+    // ============================================================================
+    clear() {
+        this.subscriptions.clear();
+        this.messageQueue = [];
+        this.messageHistory = [];
+    }
+}
+exports.MessageBus = MessageBus;
+// ============================================================================
+// Singleton Export
+// ============================================================================
+exports.messageBus = new MessageBus();
+// ============================================================================
+// Helper Functions
+// ============================================================================
+function createMessage(from, to, type, payload, options = {}) {
+    return {
+        id: (0, crypto_1.randomUUID)(),
+        from,
+        to,
+        type,
+        payload,
+        timestamp: new Date(),
+        priority: options.priority || 'normal',
+        replyTo: options.replyTo,
+        correlationId: options.correlationId,
+    };
+}

package/dist/src/agents/narrator.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Genesis 4.0 - Narrator Agent
+ *
+ * Creates coherent narratives from events and experiences.
+ * The storyteller: "Here's what happened..."
+ *
+ * Features:
+ * - Event to narrative transformation
+ * - Temporal coherence
+ * - Causal reasoning
+ * - Multi-perspective storytelling
+ * - Summary generation
+ */
+import { BaseAgent } from './base-agent.js';
+import { MessageBus } from './message-bus.js';
+import { Message, MessageType } from './types.js';
+interface Event {
+    id: string;
+    type: string;
+    timestamp: Date;
+    actors: string[];
+    action: string;
+    outcome?: string;
+    context?: string;
+    importance?: number;
+}
+interface Narrative {
+    id: string;
+    title: string;
+    summary: string;
+    chapters: Chapter[];
+    themes: string[];
+    timeline: {
+        start: Date;
+        end: Date;
+        duration: number;
+    };
+    createdAt: Date;
+}
+interface Chapter {
+    title: string;
+    content: string;
+    events: string[];
+    startTime: Date;
+    endTime: Date;
+}
+interface NarrativeStyle {
+    voice: 'first_person' | 'third_person' | 'omniscient';
+    tone: 'formal' | 'casual' | 'technical' | 'poetic';
+    detail: 'minimal' | 'moderate' | 'detailed';
+}
+export declare class NarratorAgent extends BaseAgent {
+    private eventBuffer;
+    private narratives;
+    private defaultStyle;
+    private themeKeywords;
+    constructor(bus?: MessageBus);
+    protected getMessageTypes(): MessageType[];
+    process(message: Message): Promise<Message | null>;
+    private handleEvent;
+    private collectEvent;
+    private createEvent;
+    private describeAction;
+    private handleNarrateRequest;
+    private getEventsInRange;
+    generateNarrative(events: Event[], style?: NarrativeStyle, format?: 'summary' | 'detailed' | 'chapters'): Narrative;
+    private detectThemes;
+    private generateTitle;
+    private generateChapters;
+    private groupEvents;
+    private generateChapterTitle;
+    private narrate;
+    private narrateEvent;
+    private pastTense;
+    private generateSummary;
+    private formatDuration;
+    private createEmptyNarrative;
+    private handleQuery;
+    getStats(): {
+        eventsBuffered: number;
+        narrativesGenerated: number;
+        recentThemes: string[];
+    };
+    private capitalize;
+    addEvent(event: Partial<Event>): void;
+    getEventBuffer(): Event[];
+    setDefaultStyle(style: Partial<NarrativeStyle>): void;
+}
+export declare function createNarratorAgent(bus?: MessageBus): NarratorAgent;
+export {};