@soulcraft/brainy 0.40.0 → 0.43.0

package/dist/index.js

@@ -0,0 +1,81 @@
+/**
+ * Brainy
+ * A vector and graph database using HNSW
+ */
+// CRITICAL: The TensorFlow.js environment patch is now centralized in setup.ts
+// We import setup.js below which applies the necessary patches through textEncoding.js
+// This ensures a consistent patching approach and avoids conflicts
+// Import the setup file for its side-effects.
+// This MUST be the very first import to ensure patches are applied
+// before any other module (like TensorFlow.js) is loaded.
+import './setup.js';
+// Export main BrainyData class and related types
+import { BrainyData } from './brainyData.js';
+export { BrainyData };
+// Export distance functions for convenience
+import { euclideanDistance, cosineDistance, manhattanDistance, dotProductDistance, getStatistics } from './utils/index.js';
+export { euclideanDistance, cosineDistance, manhattanDistance, dotProductDistance, getStatistics };
+// Export embedding functionality
+import { UniversalSentenceEncoder, createEmbeddingFunction, createTensorFlowEmbeddingFunction, createThreadedEmbeddingFunction, defaultEmbeddingFunction } from './utils/embedding.js';
+// Export worker utilities
+import { executeInThread, cleanupWorkerPools } from './utils/workerUtils.js';
+// Export logging utilities
+import { logger, LogLevel, configureLogger, createModuleLogger } from './utils/logger.js';
+// Export environment utilities
+import { isBrowser, isNode, isWebWorker, areWebWorkersAvailable, areWorkerThreadsAvailable, areWorkerThreadsAvailableSync, isThreadingAvailable, isThreadingAvailableAsync } from './utils/environment.js';
+export { UniversalSentenceEncoder, createEmbeddingFunction, createTensorFlowEmbeddingFunction, createThreadedEmbeddingFunction, defaultEmbeddingFunction, 
+// Worker utilities
+executeInThread, cleanupWorkerPools, 
+// Environment utilities
+isBrowser, isNode, isWebWorker, areWebWorkersAvailable, areWorkerThreadsAvailable, areWorkerThreadsAvailableSync, isThreadingAvailable, isThreadingAvailableAsync, 
+// Logging utilities
+logger, LogLevel, configureLogger, createModuleLogger };
+// Export storage adapters
+import { OPFSStorage, MemoryStorage, R2Storage, S3CompatibleStorage, createStorage } from './storage/storageFactory.js';
+export { OPFSStorage, MemoryStorage, R2Storage, S3CompatibleStorage, createStorage };
+// FileSystemStorage is exported separately to avoid browser build issues
+export { FileSystemStorage } from './storage/adapters/fileSystemStorage.js';
+// Export unified pipeline
+import { Pipeline, pipeline, augmentationPipeline, ExecutionMode, executeStreamlined, executeByType, executeSingle, processStaticData, processStreamingData, createPipeline, createStreamingPipeline, StreamlinedExecutionMode } from './pipeline.js';
+// Export sequential pipeline (for backward compatibility)
+import { SequentialPipeline, sequentialPipeline } from './sequentialPipeline.js';
+// Export augmentation factory
+import { createSenseAugmentation, addWebSocketSupport, executeAugmentation, loadAugmentationModule } from './augmentationFactory.js';
+export { 
+// Unified pipeline exports
+Pipeline, pipeline, augmentationPipeline, ExecutionMode, SequentialPipeline, sequentialPipeline, 
+// Streamlined pipeline exports (now part of unified pipeline)
+executeStreamlined, executeByType, executeSingle, processStaticData, processStreamingData, createPipeline, createStreamingPipeline, StreamlinedExecutionMode, 
+// Augmentation factory exports
+createSenseAugmentation, addWebSocketSupport, executeAugmentation, loadAugmentationModule };
+// Export augmentation registry for build-time loading
+import { availableAugmentations, registerAugmentation, initializeAugmentationPipeline, setAugmentationEnabled, getAugmentationsByType } from './augmentationRegistry.js';
+export { availableAugmentations, registerAugmentation, initializeAugmentationPipeline, setAugmentationEnabled, getAugmentationsByType };
+// Export augmentation registry loader for build tools
+import { loadAugmentationsFromModules, createAugmentationRegistryPlugin, createAugmentationRegistryRollupPlugin } from './augmentationRegistryLoader.js';
+export { loadAugmentationsFromModules, createAugmentationRegistryPlugin, createAugmentationRegistryRollupPlugin };
+// Export augmentation implementations
+import { MemoryStorageAugmentation, FileSystemStorageAugmentation, OPFSStorageAugmentation, createMemoryAugmentation } from './augmentations/memoryAugmentations.js';
+import { WebSocketConduitAugmentation, WebRTCConduitAugmentation, createConduitAugmentation } from './augmentations/conduitAugmentations.js';
+import { ServerSearchConduitAugmentation, ServerSearchActivationAugmentation, createServerSearchAugmentations } from './augmentations/serverSearchAugmentations.js';
+// Non-LLM exports
+export { MemoryStorageAugmentation, FileSystemStorageAugmentation, OPFSStorageAugmentation, createMemoryAugmentation, WebSocketConduitAugmentation, WebRTCConduitAugmentation, createConduitAugmentation, ServerSearchConduitAugmentation, ServerSearchActivationAugmentation, createServerSearchAugmentations };
+// Export HNSW index and optimized version
+import { HNSWIndex } from './hnsw/hnswIndex.js';
+import { HNSWIndexOptimized } from './hnsw/hnswIndexOptimized.js';
+export { HNSWIndex, HNSWIndexOptimized };
+import { AugmentationType } from './types/augmentations.js';
+export { AugmentationType };
+import { NounType, VerbType } from './types/graphTypes.js';
+// Export type utility functions
+import { getNounTypes, getVerbTypes, getNounTypeMap, getVerbTypeMap } from './utils/typeUtils.js';
+export { NounType, VerbType, getNounTypes, getVerbTypes, getNounTypeMap, getVerbTypeMap };
+// Export MCP (Model Control Protocol) components
+import { BrainyMCPAdapter, MCPAugmentationToolset, BrainyMCPService } from './mcp/index.js'; // Import from mcp/index.js
+import { MCPRequestType, MCP_VERSION } from './types/mcpTypes.js';
+export { 
+// MCP classes
+BrainyMCPAdapter, MCPAugmentationToolset, BrainyMCPService, 
+// MCP types
+MCPRequestType, MCP_VERSION };
+//# sourceMappingURL=index.js.map

package/dist/mcp/brainyMCPAdapter.js

@@ -0,0 +1,142 @@
+/**
+ * BrainyMCPAdapter
+ *
+ * This class provides an adapter for accessing Brainy data through the Model Control Protocol (MCP).
+ * It wraps a BrainyData instance and exposes methods for getting vectors, searching similar items,
+ * and getting relationships.
+ */
+import { v4 as uuidv4 } from 'uuid';
+import { MCP_VERSION } from '../types/mcpTypes.js';
+export class BrainyMCPAdapter {
+    /**
+     * Creates a new BrainyMCPAdapter
+     * @param brainyData The BrainyData instance to wrap
+     */
+    constructor(brainyData) {
+        this.brainyData = brainyData;
+    }
+    /**
+     * Handles an MCP data access request
+     * @param request The MCP request
+     * @returns An MCP response
+     */
+    async handleRequest(request) {
+        try {
+            switch (request.operation) {
+                case 'get':
+                    return await this.handleGetRequest(request);
+                case 'search':
+                    return await this.handleSearchRequest(request);
+                case 'add':
+                    return await this.handleAddRequest(request);
+                case 'getRelationships':
+                    return await this.handleGetRelationshipsRequest(request);
+                default:
+                    return this.createErrorResponse(request.requestId, 'UNSUPPORTED_OPERATION', `Operation ${request.operation} is not supported`);
+            }
+        }
+        catch (error) {
+            return this.createErrorResponse(request.requestId, 'INTERNAL_ERROR', error instanceof Error ? error.message : String(error));
+        }
+    }
+    /**
+     * Handles a get request
+     * @param request The MCP request
+     * @returns An MCP response
+     */
+    async handleGetRequest(request) {
+        const { id } = request.parameters;
+        if (!id) {
+            return this.createErrorResponse(request.requestId, 'MISSING_PARAMETER', 'Parameter "id" is required');
+        }
+        const noun = await this.brainyData.get(id);
+        if (!noun) {
+            return this.createErrorResponse(request.requestId, 'NOT_FOUND', `No noun found with id ${id}`);
+        }
+        return this.createSuccessResponse(request.requestId, noun);
+    }
+    /**
+     * Handles a search request
+     * @param request The MCP request
+     * @returns An MCP response
+     */
+    async handleSearchRequest(request) {
+        const { query, k = 10 } = request.parameters;
+        if (!query) {
+            return this.createErrorResponse(request.requestId, 'MISSING_PARAMETER', 'Parameter "query" is required');
+        }
+        const results = await this.brainyData.searchText(query, k);
+        return this.createSuccessResponse(request.requestId, results);
+    }
+    /**
+     * Handles an add request
+     * @param request The MCP request
+     * @returns An MCP response
+     */
+    async handleAddRequest(request) {
+        const { text, metadata } = request.parameters;
+        if (!text) {
+            return this.createErrorResponse(request.requestId, 'MISSING_PARAMETER', 'Parameter "text" is required');
+        }
+        const id = await this.brainyData.add(text, metadata);
+        return this.createSuccessResponse(request.requestId, { id });
+    }
+    /**
+     * Handles a getRelationships request
+     * @param request The MCP request
+     * @returns An MCP response
+     */
+    async handleGetRelationshipsRequest(request) {
+        const { id } = request.parameters;
+        if (!id) {
+            return this.createErrorResponse(request.requestId, 'MISSING_PARAMETER', 'Parameter "id" is required');
+        }
+        // This is a simplified implementation - in a real implementation, we would
+        // need to check if these methods exist on the BrainyDataInterface
+        const outgoing = await this.brainyData.getVerbsBySource?.(id) || [];
+        const incoming = await this.brainyData.getVerbsByTarget?.(id) || [];
+        return this.createSuccessResponse(request.requestId, { outgoing, incoming });
+    }
+    /**
+     * Creates a success response
+     * @param requestId The request ID
+     * @param data The response data
+     * @returns An MCP response
+     */
+    createSuccessResponse(requestId, data) {
+        return {
+            success: true,
+            requestId,
+            version: MCP_VERSION,
+            data
+        };
+    }
+    /**
+     * Creates an error response
+     * @param requestId The request ID
+     * @param code The error code
+     * @param message The error message
+     * @param details Optional error details
+     * @returns An MCP response
+     */
+    createErrorResponse(requestId, code, message, details) {
+        return {
+            success: false,
+            requestId,
+            version: MCP_VERSION,
+            error: {
+                code,
+                message,
+                details
+            }
+        };
+    }
+    /**
+     * Creates a new request ID
+     * @returns A new UUID
+     */
+    generateRequestId() {
+        return uuidv4();
+    }
+}
+//# sourceMappingURL=brainyMCPAdapter.js.map

package/dist/mcp/brainyMCPAdapter.js.map

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

package/dist/mcp/brainyMCPService.js

@@ -0,0 +1,248 @@
+/**
+ * BrainyMCPService
+ *
+ * This class provides a unified service for accessing Brainy data and augmentations
+ * through the Model Control Protocol (MCP). It integrates the BrainyMCPAdapter and
+ * MCPAugmentationToolset classes and provides WebSocket and REST server implementations
+ * for external model access.
+ */
+import { v4 as uuidv4 } from 'uuid';
+import { MCPRequestType, MCP_VERSION } from '../types/mcpTypes.js';
+import { BrainyMCPAdapter } from './brainyMCPAdapter.js';
+import { MCPAugmentationToolset } from './mcpAugmentationToolset.js';
+import { isBrowser, isNode } from '../utils/environment.js';
+export class BrainyMCPService {
+    /**
+     * Creates a new BrainyMCPService
+     * @param brainyData The BrainyData instance to wrap
+     * @param options Configuration options for the service
+     */
+    constructor(brainyData, options = {}) {
+        this.dataAdapter = new BrainyMCPAdapter(brainyData);
+        this.toolset = new MCPAugmentationToolset();
+        this.options = options;
+        this.authTokens = new Map();
+        this.rateLimits = new Map();
+    }
+    /**
+     * Handles an MCP request
+     * @param request The MCP request
+     * @returns An MCP response
+     */
+    async handleRequest(request) {
+        try {
+            switch (request.type) {
+                case MCPRequestType.DATA_ACCESS:
+                    return await this.dataAdapter.handleRequest(request);
+                case MCPRequestType.TOOL_EXECUTION:
+                    return await this.toolset.handleRequest(request);
+                case MCPRequestType.SYSTEM_INFO:
+                    return await this.handleSystemInfoRequest(request);
+                case MCPRequestType.AUTHENTICATION:
+                    return await this.handleAuthenticationRequest(request);
+                default:
+                    return this.createErrorResponse(request.requestId, 'UNSUPPORTED_REQUEST_TYPE', `Request type ${request.type} is not supported`);
+            }
+        }
+        catch (error) {
+            return this.createErrorResponse(request.requestId, 'INTERNAL_ERROR', error instanceof Error ? error.message : String(error));
+        }
+    }
+    /**
+     * Handles a system info request
+     * @param request The MCP request
+     * @returns An MCP response
+     */
+    async handleSystemInfoRequest(request) {
+        try {
+            switch (request.infoType) {
+                case 'status':
+                    return this.createSuccessResponse(request.requestId, {
+                        status: 'active',
+                        version: MCP_VERSION,
+                        environment: isBrowser() ? 'browser' : isNode() ? 'node' : 'unknown'
+                    });
+                case 'availableTools':
+                    const tools = await this.toolset.getAvailableTools();
+                    return this.createSuccessResponse(request.requestId, tools);
+                case 'version':
+                    return this.createSuccessResponse(request.requestId, {
+                        version: MCP_VERSION
+                    });
+                default:
+                    return this.createErrorResponse(request.requestId, 'UNSUPPORTED_INFO_TYPE', `Info type ${request.infoType} is not supported`);
+            }
+        }
+        catch (error) {
+            return this.createErrorResponse(request.requestId, 'INTERNAL_ERROR', error instanceof Error ? error.message : String(error));
+        }
+    }
+    /**
+     * Handles an authentication request
+     * @param request The MCP request
+     * @returns An MCP response
+     */
+    async handleAuthenticationRequest(request) {
+        try {
+            if (!this.options.enableAuth) {
+                return this.createSuccessResponse(request.requestId, {
+                    authenticated: true,
+                    message: 'Authentication is not enabled'
+                });
+            }
+            const { credentials } = request;
+            // Check API key authentication
+            if (credentials.apiKey &&
+                this.options.apiKeys?.includes(credentials.apiKey)) {
+                const token = this.generateAuthToken('api-user');
+                return this.createSuccessResponse(request.requestId, {
+                    authenticated: true,
+                    token
+                });
+            }
+            // Check username/password authentication
+            // This is a placeholder - in a real implementation, you would check against a database
+            if (credentials.username === 'admin' &&
+                credentials.password === 'password') {
+                const token = this.generateAuthToken(credentials.username);
+                return this.createSuccessResponse(request.requestId, {
+                    authenticated: true,
+                    token
+                });
+            }
+            return this.createErrorResponse(request.requestId, 'INVALID_CREDENTIALS', 'Invalid credentials');
+        }
+        catch (error) {
+            return this.createErrorResponse(request.requestId, 'INTERNAL_ERROR', error instanceof Error ? error.message : String(error));
+        }
+    }
+    /**
+     * Checks if a request is valid
+     * @param request The request to check
+     * @returns Whether the request is valid
+     */
+    isValidRequest(request) {
+        return (request &&
+            typeof request === 'object' &&
+            request.type &&
+            request.requestId &&
+            request.version);
+    }
+    /**
+     * Checks if a request is authenticated
+     * @param request The request to check
+     * @returns Whether the request is authenticated
+     */
+    isAuthenticated(request) {
+        if (!this.options.enableAuth) {
+            return true;
+        }
+        return request.authToken ? this.isValidToken(request.authToken) : false;
+    }
+    /**
+     * Checks if a token is valid
+     * @param token The token to check
+     * @returns Whether the token is valid
+     */
+    isValidToken(token) {
+        const tokenInfo = this.authTokens.get(token);
+        if (!tokenInfo) {
+            return false;
+        }
+        if (tokenInfo.expires < Date.now()) {
+            this.authTokens.delete(token);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Generates an authentication token
+     * @param userId The user ID to associate with the token
+     * @returns The generated token
+     */
+    generateAuthToken(userId) {
+        const token = uuidv4();
+        const expires = Date.now() + 24 * 60 * 60 * 1000; // 24 hours
+        this.authTokens.set(token, { userId, expires });
+        return token;
+    }
+    /**
+     * Checks if a client has exceeded the rate limit
+     * @param clientId The client ID to check
+     * @returns Whether the client is within the rate limit
+     */
+    checkRateLimit(clientId) {
+        if (!this.options.rateLimit) {
+            return true;
+        }
+        const now = Date.now();
+        const limit = this.rateLimits.get(clientId);
+        if (!limit) {
+            this.rateLimits.set(clientId, {
+                count: 1,
+                resetTime: now + this.options.rateLimit.windowMs
+            });
+            return true;
+        }
+        if (limit.resetTime < now) {
+            limit.count = 1;
+            limit.resetTime = now + this.options.rateLimit.windowMs;
+            return true;
+        }
+        if (limit.count >= this.options.rateLimit.maxRequests) {
+            return false;
+        }
+        limit.count++;
+        return true;
+    }
+    /**
+     * Creates a success response
+     * @param requestId The request ID
+     * @param data The response data
+     * @returns An MCP response
+     */
+    createSuccessResponse(requestId, data) {
+        return {
+            success: true,
+            requestId,
+            version: MCP_VERSION,
+            data
+        };
+    }
+    /**
+     * Creates an error response
+     * @param requestId The request ID
+     * @param code The error code
+     * @param message The error message
+     * @param details Optional error details
+     * @returns An MCP response
+     */
+    createErrorResponse(requestId, code, message, details) {
+        return {
+            success: false,
+            requestId,
+            version: MCP_VERSION,
+            error: {
+                code,
+                message,
+                details
+            }
+        };
+    }
+    /**
+     * Creates a new request ID
+     * @returns A new UUID
+     */
+    generateRequestId() {
+        return uuidv4();
+    }
+    /**
+     * Handles an MCP request directly (for in-process models)
+     * @param request The MCP request
+     * @returns An MCP response
+     */
+    async handleMCPRequest(request) {
+        return await this.handleRequest(request);
+    }
+}
+//# sourceMappingURL=brainyMCPService.js.map

package/dist/mcp/brainyMCPService.js.map

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

package/dist/mcp/index.js

@@ -0,0 +1,17 @@
+/**
+ * Model Control Protocol (MCP) for Brainy
+ *
+ * This module provides a Model Control Protocol (MCP) implementation for Brainy,
+ * allowing external models to access Brainy data and use the augmentation pipeline as tools.
+ */
+// Import and re-export the MCP components
+import { BrainyMCPAdapter } from './brainyMCPAdapter.js';
+import { MCPAugmentationToolset } from './mcpAugmentationToolset.js';
+import { BrainyMCPService } from './brainyMCPService.js';
+// Export the MCP components
+export { BrainyMCPAdapter };
+export { MCPAugmentationToolset };
+export { BrainyMCPService };
+// Export the MCP types
+export * from '../types/mcpTypes.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,0CAA0C;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAExD,4BAA4B;AAC5B,OAAO,EAAE,gBAAgB,EAAE,CAAA;AAC3B,OAAO,EAAE,sBAAsB,EAAE,CAAA;AACjC,OAAO,EAAE,gBAAgB,EAAE,CAAA;AAE3B,uBAAuB;AACvB,cAAc,sBAAsB,CAAA"}