@soulcraft/brainy 0.57.1 → 0.58.1

package/dist/mcp/brainyMCPClient.d.ts

@@ -0,0 +1,92 @@
+/**
+ * BrainyMCPClient
+ *
+ * Client for connecting Claude instances to the Brain Jar Broadcast Server
+ * Utilizes Brainy for persistent memory and vector search capabilities
+ */
+interface ClientOptions {
+    name: string;
+    role: string;
+    serverUrl?: string;
+    autoReconnect?: boolean;
+    useBrainyMemory?: boolean;
+}
+interface Message {
+    id: string;
+    from: string;
+    to?: string | string[];
+    type: 'message' | 'notification' | 'sync' | 'heartbeat' | 'identify';
+    event?: string;
+    data: any;
+    timestamp: number;
+}
+export declare class BrainyMCPClient {
+    private socket?;
+    private options;
+    private brainy?;
+    private messageHandlers;
+    private reconnectTimeout?;
+    private isConnected;
+    constructor(options: ClientOptions);
+    /**
+     * Initialize Brainy for persistent memory
+     */
+    private initBrainy;
+    /**
+     * Connect to the broadcast server
+     */
+    connect(): Promise<void>;
+    /**
+     * Handle incoming message
+     */
+    private handleMessage;
+    /**
+     * Send a message
+     */
+    send(message: Partial<Message>): void;
+    /**
+     * Send a message to specific agent(s)
+     */
+    sendTo(recipient: string | string[], data: any): void;
+    /**
+     * Broadcast to all agents
+     */
+    broadcast(data: any): void;
+    /**
+     * Register a message handler
+     */
+    on(type: string, handler: (message: Message) => void): void;
+    /**
+     * Remove a message handler
+     */
+    off(type: string): void;
+    /**
+     * Search historical messages using Brainy's vector search
+     */
+    searchMemory(query: string, limit?: number): Promise<any[]>;
+    /**
+     * Get recent messages from Brainy memory
+     */
+    getRecentMessages(limit?: number): Promise<any[]>;
+    /**
+     * Schedule reconnection attempt
+     */
+    private scheduleReconnect;
+    /**
+     * Disconnect from server
+     */
+    disconnect(): void;
+    /**
+     * Check if connected
+     */
+    getIsConnected(): boolean;
+    /**
+     * Get agent info
+     */
+    getAgentInfo(): {
+        name: string;
+        role: string;
+        connected: boolean;
+    };
+}
+export default BrainyMCPClient;

package/dist/mcp/brainyMCPClient.js

@@ -0,0 +1,254 @@
+/**
+ * BrainyMCPClient
+ *
+ * Client for connecting Claude instances to the Brain Jar Broadcast Server
+ * Utilizes Brainy for persistent memory and vector search capabilities
+ */
+import WebSocket from 'ws';
+import { BrainyData } from '../brainyData.js';
+import { v4 as uuidv4 } from '../universal/uuid.js';
+export class BrainyMCPClient {
+    constructor(options) {
+        this.messageHandlers = new Map();
+        this.isConnected = false;
+        this.options = {
+            serverUrl: 'ws://localhost:8765',
+            autoReconnect: true,
+            useBrainyMemory: true,
+            ...options
+        };
+    }
+    /**
+     * Initialize Brainy for persistent memory
+     */
+    async initBrainy() {
+        if (this.options.useBrainyMemory && !this.brainy) {
+            this.brainy = new BrainyData({
+                storage: {
+                    requestPersistentStorage: true
+                }
+            });
+            await this.brainy.init();
+            console.log(`🧠 Brainy memory initialized for ${this.options.name}`);
+        }
+    }
+    /**
+     * Connect to the broadcast server
+     */
+    async connect() {
+        // Initialize Brainy first
+        await this.initBrainy();
+        return new Promise((resolve, reject) => {
+            try {
+                this.socket = new WebSocket(this.options.serverUrl);
+                this.socket.on('open', () => {
+                    console.log(`✅ ${this.options.name} connected to Brain Jar Broadcast`);
+                    this.isConnected = true;
+                    // Identify ourselves
+                    this.send({
+                        type: 'identify',
+                        data: {
+                            name: this.options.name,
+                            role: this.options.role
+                        }
+                    });
+                    resolve();
+                });
+                this.socket.on('message', async (data) => {
+                    try {
+                        const message = JSON.parse(data.toString());
+                        await this.handleMessage(message);
+                    }
+                    catch (error) {
+                        console.error('Error parsing message:', error);
+                    }
+                });
+                this.socket.on('close', () => {
+                    console.log(`❌ ${this.options.name} disconnected from Brain Jar`);
+                    this.isConnected = false;
+                    if (this.options.autoReconnect) {
+                        this.scheduleReconnect();
+                    }
+                });
+                this.socket.on('error', (error) => {
+                    console.error(`Connection error for ${this.options.name}:`, error);
+                    reject(error);
+                });
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+    }
+    /**
+     * Handle incoming message
+     */
+    async handleMessage(message) {
+        // Store in Brainy for persistent memory
+        if (this.brainy && message.type === 'message') {
+            try {
+                await this.brainy.add({
+                    text: `${message.from}: ${JSON.stringify(message.data)}`,
+                    metadata: {
+                        messageId: message.id,
+                        from: message.from,
+                        to: message.to,
+                        timestamp: message.timestamp,
+                        type: message.type,
+                        event: message.event
+                    }
+                });
+            }
+            catch (error) {
+                console.error('Error storing message in Brainy:', error);
+            }
+        }
+        // Handle sync messages (receive history)
+        if (message.type === 'sync' && message.data.history) {
+            console.log(`📜 ${this.options.name} received ${message.data.history.length} historical messages`);
+            // Store history in Brainy
+            if (this.brainy) {
+                for (const histMsg of message.data.history) {
+                    await this.brainy.add({
+                        text: `${histMsg.from}: ${JSON.stringify(histMsg.data)}`,
+                        metadata: histMsg
+                    });
+                }
+            }
+        }
+        // Call registered handlers
+        const handler = this.messageHandlers.get(message.type);
+        if (handler) {
+            handler(message);
+        }
+        // Call universal handler
+        const universalHandler = this.messageHandlers.get('*');
+        if (universalHandler) {
+            universalHandler(message);
+        }
+    }
+    /**
+     * Send a message
+     */
+    send(message) {
+        if (!this.socket || this.socket.readyState !== WebSocket.OPEN) {
+            console.error(`${this.options.name} is not connected`);
+            return;
+        }
+        const fullMessage = {
+            id: message.id || uuidv4(),
+            from: this.options.name,
+            type: message.type || 'message',
+            data: message.data || {},
+            timestamp: Date.now(),
+            ...message
+        };
+        this.socket.send(JSON.stringify(fullMessage));
+    }
+    /**
+     * Send a message to specific agent(s)
+     */
+    sendTo(recipient, data) {
+        this.send({
+            to: recipient,
+            type: 'message',
+            data
+        });
+    }
+    /**
+     * Broadcast to all agents
+     */
+    broadcast(data) {
+        this.send({
+            type: 'message',
+            data
+        });
+    }
+    /**
+     * Register a message handler
+     */
+    on(type, handler) {
+        this.messageHandlers.set(type, handler);
+    }
+    /**
+     * Remove a message handler
+     */
+    off(type) {
+        this.messageHandlers.delete(type);
+    }
+    /**
+     * Search historical messages using Brainy's vector search
+     */
+    async searchMemory(query, limit = 10) {
+        if (!this.brainy) {
+            console.warn('Brainy memory not initialized');
+            return [];
+        }
+        const results = await this.brainy.search(query, limit);
+        return results.map(r => ({
+            ...r.metadata,
+            relevance: r.score
+        }));
+    }
+    /**
+     * Get recent messages from Brainy memory
+     */
+    async getRecentMessages(limit = 20) {
+        if (!this.brainy) {
+            console.warn('Brainy memory not initialized');
+            return [];
+        }
+        // Search for recent activity
+        const results = await this.brainy.search('recent messages communication', limit);
+        return results
+            .map(r => r.metadata)
+            .sort((a, b) => b.timestamp - a.timestamp);
+    }
+    /**
+     * Schedule reconnection attempt
+     */
+    scheduleReconnect() {
+        if (this.reconnectTimeout) {
+            clearTimeout(this.reconnectTimeout);
+        }
+        this.reconnectTimeout = setTimeout(() => {
+            console.log(`🔄 ${this.options.name} attempting to reconnect...`);
+            this.connect().catch(error => {
+                console.error('Reconnection failed:', error);
+                this.scheduleReconnect();
+            });
+        }, 5000);
+    }
+    /**
+     * Disconnect from server
+     */
+    disconnect() {
+        if (this.reconnectTimeout) {
+            clearTimeout(this.reconnectTimeout);
+        }
+        if (this.socket) {
+            this.socket.close(1000, 'Client disconnecting');
+            this.socket = undefined;
+        }
+        this.isConnected = false;
+    }
+    /**
+     * Check if connected
+     */
+    getIsConnected() {
+        return this.isConnected;
+    }
+    /**
+     * Get agent info
+     */
+    getAgentInfo() {
+        return {
+            name: this.options.name,
+            role: this.options.role,
+            connected: this.isConnected
+        };
+    }
+}
+// Export for both environments
+export default BrainyMCPClient;
+//# sourceMappingURL=brainyMCPClient.js.map

package/dist/mcp/brainyMCPClient.js.map

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

package/dist/mcp/brainyMCPService.js

@@ -6,7 +6,7 @@
  * MCPAugmentationToolset classes and provides WebSocket and REST server implementations
  * for external model access.
  */
-import { v4 as uuidv4 } from 'uuid';
+import { v4 as uuidv4 } from '../universal/uuid.js';
 import { MCPRequestType, MCP_VERSION } from '../types/mcpTypes.js';
 import { BrainyMCPAdapter } from './brainyMCPAdapter.js';
 import { MCPAugmentationToolset } from './mcpAugmentationToolset.js';

package/dist/mcp/brainyMCPService.js.map

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

package/dist/mcp/mcpAugmentationToolset.js

@@ -4,7 +4,7 @@
  * This class exposes the Brainy augmentation pipeline as tools through the Model Control Protocol (MCP).
  * It provides methods for getting available tools and executing tools.
  */
-import { v4 as uuidv4 } from 'uuid';
+import { v4 as uuidv4 } from '../universal/uuid.js';
 import { MCP_VERSION } from '../types/mcpTypes.js';
 import { AugmentationType } from '../types/augmentations.js';
 // Import the augmentation pipeline

package/dist/mcp/mcpAugmentationToolset.js.map

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

package/dist/storage/adapters/baseStorageAdapter.d.ts

@@ -93,6 +93,24 @@ export declare abstract class BaseStorageAdapter implements StorageAdapter {
     protected lastStatisticsFlushTime: number;
     protected readonly MIN_FLUSH_INTERVAL_MS = 5000;
     protected readonly MAX_FLUSH_DELAY_MS = 30000;
+    protected throttlingDetected: boolean;
+    protected throttlingBackoffMs: number;
+    protected maxBackoffMs: number;
+    protected consecutiveThrottleEvents: number;
+    protected lastThrottleTime: number;
+    protected totalThrottleEvents: number;
+    protected throttleEventsByHour: number[];
+    protected throttleReasons: Record<string, number>;
+    protected lastThrottleHourIndex: number;
+    protected delayedOperations: number;
+    protected retriedOperations: number;
+    protected failedDueToThrottling: number;
+    protected totalDelayMs: number;
+    protected serviceThrottling: Map<string, {
+        throttleCount: number;
+        lastThrottle: number;
+        status: 'normal' | 'throttled' | 'recovering';
+    }>;
     protected abstract saveStatisticsData(statistics: StatisticsData): Promise<void>;
     protected abstract getStatisticsData(): Promise<StatisticsData | null>;
     /**
@@ -164,4 +182,45 @@ export declare abstract class BaseStorageAdapter implements StorageAdapter {
      * @returns Default statistics data
      */
     protected createDefaultStatistics(): StatisticsData;
+    /**
+     * Detect if an error is a throttling error
+     * Override this method in specific adapters for custom detection
+     */
+    protected isThrottlingError(error: any): boolean;
+    /**
+     * Track a throttling event
+     * @param error The error that caused throttling
+     * @param service Optional service that was throttled
+     */
+    protected trackThrottlingEvent(error: any, service?: string): void;
+    /**
+     * Get the reason for throttling from an error
+     */
+    protected getThrottleReason(error: any): string;
+    /**
+     * Clear throttling state after successful operations
+     */
+    protected clearThrottlingState(): void;
+    /**
+     * Handle throttling by implementing exponential backoff
+     * @param error The error that triggered throttling
+     * @param service Optional service that was throttled
+     */
+    handleThrottling(error: any, service?: string): Promise<void>;
+    /**
+     * Track a retried operation
+     */
+    protected trackRetriedOperation(): void;
+    /**
+     * Track an operation that failed due to throttling
+     */
+    protected trackFailedDueToThrottling(): void;
+    /**
+     * Get current throttling metrics
+     */
+    protected getThrottlingMetrics(): StatisticsData['throttlingMetrics'];
+    /**
+     * Include throttling metrics in statistics
+     */
+    getStatisticsWithThrottling(): Promise<StatisticsData | null>;
 }