@soulcraft/brainy 2.6.0 → 2.7.1

package/README.md

@@ -71,6 +71,18 @@ const filtered = await brain.find({
 })
 ```
 
+## 📋 System Requirements
+
+**Node.js Version:** 22 LTS or later (recommended)
+
+- ✅ **Node.js 22 LTS** - Fully supported and recommended for production
+- ✅ **Node.js 20 LTS** - Compatible (maintenance mode)
+- ❌ **Node.js 24** - Not supported (known ONNX runtime compatibility issues)
+
+> **Important:** Brainy uses ONNX runtime for AI embeddings. Node.js 24 has known compatibility issues that cause crashes during inference operations. We recommend Node.js 22 LTS for maximum stability.
+
+If using nvm: `nvm use` (we provide a `.nvmrc` file)
+
 ## 🚀 Key Features
 
 ### World's First Triple Intelligence™ Engine

package/dist/embeddings/universal-memory-manager.d.ts

@@ -23,7 +23,7 @@ export declare class UniversalMemoryManager {
     embed(data: string | string[]): Promise<Vector>;
     private checkMemoryLimits;
     private ensureEmbeddingFunction;
-    private initNodeWorker;
+    private initNodeDirect;
     private initServerless;
     private initBrowser;
     private initFallback;

package/dist/embeddings/universal-memory-manager.js

@@ -13,18 +13,21 @@ const isServerless = typeof process !== 'undefined' && (process.env.VERCEL ||
     process.env.FUNCTIONS_WORKER_RUNTIME);
 export class UniversalMemoryManager {
     constructor() {
+        // CRITICAL FIX: Never use worker threads with ONNX Runtime
+        // Worker threads cause HandleScope V8 API errors due to isolate issues
+        // Always use direct embedding on main thread for ONNX compatibility
         this.embeddingFunction = null;
         this.embedCount = 0;
         this.restartCount = 0;
         this.lastRestart = 0;
-        // Choose strategy based on environment
         if (isServerless) {
             this.strategy = 'serverless-restart';
             this.maxEmbeddings = 50; // Restart frequently in serverless
         }
         else if (isNode && !isBrowser) {
-            this.strategy = 'node-worker';
-            this.maxEmbeddings = 100; // Worker can handle more
+            // CHANGED: Use direct strategy instead of node-worker to avoid V8 isolate issues
+            this.strategy = 'node-direct';
+            this.maxEmbeddings = 200; // Main thread can handle more with single model instance
         }
         else if (isBrowser) {
             this.strategy = 'browser-dispose';
@@ -35,6 +38,7 @@ export class UniversalMemoryManager {
             this.maxEmbeddings = 75;
         }
         console.log(`🧠 Universal Memory Manager: Using ${this.strategy} strategy`);
+        console.log('✅ UNIVERSAL: Memory-safe embedding system initialized');
     }
     async getEmbeddingFunction() {
         return async (data) => {
@@ -62,8 +66,8 @@ export class UniversalMemoryManager {
             return;
         }
         switch (this.strategy) {
-            case 'node-worker':
-                await this.initNodeWorker();
+            case 'node-direct':
+                await this.initNodeDirect();
                 break;
             case 'serverless-restart':
                 await this.initServerless();
@@ -75,19 +79,12 @@ export class UniversalMemoryManager {
                 await this.initFallback();
         }
     }
-    async initNodeWorker() {
+    async initNodeDirect() {
         if (isNode) {
-            try {
-                // Try to use worker threads if available
-                const { workerEmbeddingManager } = await import('./worker-manager.js');
-                this.embeddingFunction = workerEmbeddingManager;
-                console.log('✅ Using Node.js worker threads for embeddings');
-            }
-            catch (error) {
-                console.warn('⚠️ Worker threads not available, falling back to direct embedding');
-                console.warn('Error:', error instanceof Error ? error.message : String(error));
-                await this.initDirect();
-            }
+            // CRITICAL: Use direct embedding to avoid worker thread V8 isolate issues
+            // This prevents HandleScope errors and ensures single model instance
+            console.log('✅ Using Node.js direct embedding (main thread - ONNX compatible)');
+            await this.initDirect();
         }
     }
     async initServerless() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "2.6.0",
+  "version": "2.7.1",
   "description": "Universal Knowledge Protocol™ - World's first Triple Intelligence database unifying vector, graph, and document search in one API. 31 nouns × 40 verbs for infinite expressiveness.",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -55,7 +55,7 @@
     }
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
     "build": "npm run build:patterns:if-needed && tsc",