@soulcraft/brainy 2.9.0 → 2.10.1

package/dist/index.js

@@ -11,6 +11,22 @@
 // Export main BrainyData class and related types
 import { BrainyData } from './brainyData.js';
 export { BrainyData };
+// Export zero-configuration types and enums
+export { 
+// Preset names
+PresetName, 
+// Model configuration
+ModelPrecision, 
+// Storage configuration  
+StorageOption, 
+// Feature configuration
+FeatureSet, 
+// Distributed roles
+DistributedRole, 
+// Categories
+PresetCategory, registerStorageAugmentation, registerPresetAugmentation, 
+// Preset utilities
+getPreset, isValidPreset, getPresetsByCategory, getAllPresetNames, getPresetDescription } from './config/index.js';
 // Export Cortex (the orchestrator)
 export { Cortex, cortex } from './cortex.js';
 // Export Neural Import (AI data understanding)

package/dist/utils/embedding.js

@@ -13,9 +13,10 @@ import { pipeline, env } from '@huggingface/transformers';
 if (typeof process !== 'undefined' && process.env) {
     process.env.ORT_DISABLE_MEMORY_ARENA = '1';
     process.env.ORT_DISABLE_MEMORY_PATTERN = '1';
-    // Also limit ONNX thread count for more predictable memory usage
-    process.env.ORT_INTRA_OP_NUM_THREADS = '2';
-    process.env.ORT_INTER_OP_NUM_THREADS = '2';
+    // Force single-threaded operation for maximum stability (Node.js 24 compatibility)
+    process.env.ORT_INTRA_OP_NUM_THREADS = '1'; // Single thread for operators
+    process.env.ORT_INTER_OP_NUM_THREADS = '1'; // Single thread for sessions
+    process.env.ORT_NUM_THREADS = '1'; // Additional safety override
 }
 /**
  * Detect the best available GPU device for the current environment
@@ -79,7 +80,7 @@ export class TransformerEmbedding {
             localFilesOnly = options.localFilesOnly;
         }
         else if (process.env.BRAINY_ALLOW_REMOTE_MODELS === 'false') {
-            // 2. Environment variable explicitly disables remote models
+            // 2. Environment variable explicitly disables remote models (legacy support)
             localFilesOnly = true;
         }
         else if (process.env.NODE_ENV === 'development') {
@@ -259,9 +260,9 @@ export class TransformerEmbedding {
                 session_options: {
                     enableCpuMemArena: false, // Disable pre-allocated memory arena
                     enableMemPattern: false, // Disable memory pattern optimization
-                    interOpNumThreads: 2, // Limit thread count
-                    intraOpNumThreads: 2, // Limit parallelism
-                    graphOptimizationLevel: 'all'
+                    interOpNumThreads: 1, // Force single thread for V8 stability
+                    intraOpNumThreads: 1, // Force single thread for V8 stability
+                    graphOptimizationLevel: 'disabled' // Disable threading optimizations
                 }
             };
             // Add device configuration for GPU acceleration
@@ -311,8 +312,8 @@ export class TransformerEmbedding {
                             // Both local and remote failed - throw comprehensive error
                             const errorMsg = `Failed to load embedding model "${this.options.model}". ` +
                                 `Local models not found and remote download failed. ` +
-                                `To fix: 1) Set BRAINY_ALLOW_REMOTE_MODELS=true, ` +
-                                `2) Run "npm run download-models", or ` +
+                                `To fix: 1) Run "npm run download-models", ` +
+                                `2) Check your internet connection, or ` +
                                 `3) Use a custom embedding function.`;
                             throw new Error(errorMsg);
                         }

package/dist/utils/nodeVersionCheck.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Node.js Version Compatibility Check
+ *
+ * Brainy requires Node.js 22.x LTS for maximum stability with ONNX Runtime.
+ * This prevents V8 HandleScope locking issues in worker threads.
+ */
+export interface VersionInfo {
+    current: string;
+    major: number;
+    isSupported: boolean;
+    recommendation: string;
+}
+/**
+ * Check if the current Node.js version is supported
+ */
+export declare function checkNodeVersion(): VersionInfo;
+/**
+ * Enforce Node.js version requirement with helpful error messaging
+ */
+export declare function enforceNodeVersion(): void;
+/**
+ * Soft warning for version issues (non-blocking)
+ */
+export declare function warnNodeVersion(): boolean;

package/dist/utils/nodeVersionCheck.js

@@ -0,0 +1,65 @@
+/**
+ * Node.js Version Compatibility Check
+ *
+ * Brainy requires Node.js 22.x LTS for maximum stability with ONNX Runtime.
+ * This prevents V8 HandleScope locking issues in worker threads.
+ */
+/**
+ * Check if the current Node.js version is supported
+ */
+export function checkNodeVersion() {
+    const nodeVersion = process.version;
+    const majorVersion = parseInt(nodeVersion.split('.')[0].substring(1));
+    const versionInfo = {
+        current: nodeVersion,
+        major: majorVersion,
+        isSupported: majorVersion === 22,
+        recommendation: 'Node.js 22.x LTS'
+    };
+    return versionInfo;
+}
+/**
+ * Enforce Node.js version requirement with helpful error messaging
+ */
+export function enforceNodeVersion() {
+    const versionInfo = checkNodeVersion();
+    if (!versionInfo.isSupported) {
+        const errorMessage = [
+            '🚨 BRAINY COMPATIBILITY ERROR',
+            '━'.repeat(50),
+            `❌ Current Node.js: ${versionInfo.current}`,
+            `✅ Required: ${versionInfo.recommendation}`,
+            '',
+            '💡 Quick Fix:',
+            '  nvm install 22 && nvm use 22',
+            '  npm install',
+            '',
+            '📖 Why Node.js 22?',
+            '  • Maximum ONNX Runtime stability',
+            '  • Prevents V8 threading crashes',
+            '  • Optimal zero-config performance',
+            '',
+            '🔗 More info: https://github.com/soulcraftlabs/brainy#node-version',
+            '━'.repeat(50)
+        ].join('\n');
+        throw new Error(errorMessage);
+    }
+}
+/**
+ * Soft warning for version issues (non-blocking)
+ */
+export function warnNodeVersion() {
+    const versionInfo = checkNodeVersion();
+    if (!versionInfo.isSupported) {
+        console.warn([
+            '⚠️  BRAINY VERSION WARNING',
+            `   Current: ${versionInfo.current}`,
+            `   Recommended: ${versionInfo.recommendation}`,
+            '   Consider upgrading for best stability',
+            ''
+        ].join('\n'));
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=nodeVersionCheck.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "2.9.0",
+  "version": "2.10.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": ">=22.0.0"
+    "node": "22.x"
   },
   "scripts": {
     "build": "npm run build:patterns:if-needed && tsc",