@soulcraft/brainy 0.62.0 → 0.62.2

package/README.md

@@ -9,9 +9,8 @@
 [![Node.js](https://img.shields.io/badge/node-%3E%3D24.4.1-brightgreen.svg)](https://nodejs.org/)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.4.5-blue.svg)](https://www.typescriptlang.org/)
 
-# 🧠 BRAINY: Your AI-Powered Second Brain
+# 🧠 The World's First Multi-Dimensional AI Database™
 
-**The World's First Multi-Dimensional AI Database™**  
 *Vector similarity • Graph relationships • Metadata facets • Neural understanding*
 
 **Build AI apps that actually understand your data - in minutes, not months**
@@ -20,6 +19,22 @@
 
 ---
 
+## ✅ 100% Free & Open Source
+
+**Brainy is completely free. No license keys. No limits. No catch.**
+
+Every feature you see here works without any payment or registration:
+- ✓ Full vector database
+- ✓ Graph relationships
+- ✓ Semantic search
+- ✓ All storage adapters
+- ✓ Complete API
+- ✓ Forever free
+
+> 🌩️ **Brain Cloud** is an optional add-on for teams who want cloud sync and enterprise connectors.
+
+---
+
 ## 🚀 What Can You Build?
 
 ### 💬 **AI Chat Apps** - That Actually Remember
@@ -134,13 +149,14 @@ const results = await brain.search("companies founded by Elon")
 # Auto-setup with cloud instance provisioning (RECOMMENDED)
 brainy cloud setup --email your@email.com
 
-# Or install manually
-npm install @soulcraft/brainy @soulcraft/brain-cloud
+# Sign up at app.soulcraft.com (free trial)
+brainy cloud auth  # Auto-configures based on your plan
 ```
 
 ```javascript
 import { BrainyData, Cortex } from '@soulcraft/brainy'
-import { AIMemory, AgentCoordinator } from '@soulcraft/brain-cloud'
+// After authentication, augmentations auto-load
+// No imports needed - they're managed by your account!
 
 const brain = new BrainyData()
 const cortex = new Cortex()
@@ -205,20 +221,17 @@ cortex.register(new Translator())         // Multi-language support
 - 📊 Data Visualizer
 - 🎨 Image Understanding
 
-### 💼 **Premium Augmentations** (@soulcraft/brain-cloud)
-For teams that need AI memory and enterprise features:
+### ☁️ **Brain Cloud** (Optional Add-On)
+🌟 **Brainy works perfectly without this!** Brain Cloud adds team features:
 
 ```javascript
-import { 
-  AIMemory,          // Persistent AI memory
-  AgentCoordinator,  // Multi-agent handoffs
-  NotionSync,        // Notion integration
-  SalesforceConnect  // CRM integration
-} from '@soulcraft/brain-cloud'
-
-// Requires license key - get one at soulcraft.com
-const aiMemory = new AIMemory({
-  licenseKey: process.env.BRAINY_LICENSE_KEY
+// Brain Cloud features are in the main package
+// But require API key to activate cloud services
+import { BrainyVectorDB } from '@soulcraft/brainy'
+
+// Activate Brain Cloud features with API key
+const brain = new BrainyVectorDB({
+  cloud: { apiKey: process.env.BRAIN_CLOUD_KEY }  // Optional
 })
 
 cortex.register(aiMemory)  // AI remembers everything

package/bin/brainy.js

@@ -345,7 +345,7 @@ program
       
       try {
         // Test connection to Brain Cloud worker
-        const healthUrl = `https://brain-cloud.dpsifr.workers.dev/health`
+        const healthUrl = `https://api.soulcraft.com/brain-cloud/health`
         const response = await fetch(healthUrl, {
           headers: { 'x-customer-id': options.connect }
         })
@@ -357,7 +357,7 @@ program
           console.log(chalk.gray(`⏰ Connected at: ${new Date(data.timestamp).toLocaleString()}`))
           
           // Test memories endpoint
-          const memoriesResponse = await fetch(`https://brain-cloud.dpsifr.workers.dev/memories`, {
+          const memoriesResponse = await fetch(`https://api.soulcraft.com/brain-cloud/memories`, {
             headers: { 'x-customer-id': options.connect }
           })
           
@@ -384,7 +384,7 @@ program
       console.log(chalk.green(`📦 Exporting data from Brain Cloud instance: ${options.export}`))
       
       try {
-        const response = await fetch(`https://brain-cloud.dpsifr.workers.dev/export`, {
+        const response = await fetch(`https://api.soulcraft.com/brain-cloud/export`, {
           headers: { 'x-customer-id': options.export }
         })
         
@@ -408,7 +408,7 @@ program
       console.log(chalk.green(`🔍 Checking status of Brain Cloud instance: ${options.status}`))
       
       try {
-        const response = await fetch(`https://brain-cloud.dpsifr.workers.dev/health`, {
+        const response = await fetch(`https://api.soulcraft.com/brain-cloud/health`, {
           headers: { 'x-customer-id': options.status }
         })
         
@@ -419,7 +419,7 @@ program
           console.log(chalk.gray(`⏰ Last check: ${new Date(data.timestamp).toLocaleString()}`))
           
           // Get memory count
-          const memoriesResponse = await fetch(`https://brain-cloud.dpsifr.workers.dev/memories`, {
+          const memoriesResponse = await fetch(`https://api.soulcraft.com/brain-cloud/memories`, {
             headers: { 'x-customer-id': options.status }
           })
           
@@ -549,9 +549,12 @@ augment
       output: process.stdout
     })
     
-    console.log(chalk.cyan('🧠 Brain Cloud Activation'))
+    console.log(chalk.cyan('☁️  Brain Cloud Activation (Optional Premium)'))
     console.log('')
-    console.log('Get your license at: ' + chalk.green('app.soulcraft.com'))
+    console.log(chalk.yellow('Note: Brainy core is 100% free and fully functional!'))
+    console.log('Brain Cloud adds optional team & sync features.')
+    console.log('')
+    console.log('Get Brain Cloud at: ' + chalk.green('app.soulcraft.com'))
     console.log('(14-day free trial available)')
     console.log('')
     
@@ -567,12 +570,12 @@ augment
         
         console.log(chalk.green('✅ License saved!'))
         console.log('')
-        console.log('Install Brain Cloud:')
-        console.log(chalk.cyan('  npm install @soulcraft/brain-cloud'))
+        console.log('// Brain Cloud is NOT an npm package!')
+        console.log('// Augmentations auto-load based on your subscription')
         console.log('')
-        console.log('Then use in your code:')
-        console.log(chalk.gray('  import { AIMemory } from "@soulcraft/brain-cloud"'))
-        console.log(chalk.gray('  cortex.register(new AIMemory())'))
+        console.log('Next steps:')
+        console.log(chalk.cyan('  brainy cloud auth'))
+        console.log(chalk.gray('  # Your augmentations will auto-load'))
       } else {
         console.log(chalk.red('Invalid license key'))
       }
@@ -915,7 +918,7 @@ async function detectCustomerId() {
     const testIds = ['demo-test-auto', 'demo-test123']
     for (const id of testIds) {
       try {
-        const response = await fetch(`https://brain-cloud.dpsifr.workers.dev/health`, {
+        const response = await fetch(`https://api.soulcraft.com/brain-cloud/health`, {
           headers: { 'x-customer-id': id }
         })
         if (response.ok) {
@@ -947,7 +950,7 @@ async function setupBrainCloudMemory(customerId) {
           args: ["brainy-mcp-server.js"],
           env: {
             CUSTOMER_ID: customerId,
-            BRAIN_CLOUD_URL: "https://brain-cloud.dpsifr.workers.dev"
+            BRAIN_CLOUD_URL: "https://api.soulcraft.com/brain-cloud"
           }
         }
       }
@@ -1001,7 +1004,7 @@ When working with multiple AI assistants, we automatically coordinate:
   try {
     const brainyConfig = {
       brainCloudCustomerId: customerId,
-      brainCloudUrl: 'https://brain-cloud.dpsifr.workers.dev',
+      brainCloudUrl: 'https://api.soulcraft.com/brain-cloud',
       lastConnected: new Date().toISOString()
     }
     

package/dist/utils/modelLoader.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Smart Model Loader - Zero Configuration ML Models
+ * Downloads models on-demand, caches intelligently
+ */
+export declare class SmartModelLoader {
+    private static readonly MODEL_SOURCES;
+    static loadModel(modelName: string): Promise<ArrayBuffer>;
+    private static tryLoadFrom;
+    private static cacheLocally;
+    private static generateFallbackModel;
+}
+export declare function getEmbedding(text: string): Promise<Float32Array>;

package/dist/utils/modelLoader.js

@@ -0,0 +1,88 @@
+/**
+ * Smart Model Loader - Zero Configuration ML Models
+ * Downloads models on-demand, caches intelligently
+ */
+export class SmartModelLoader {
+    static async loadModel(modelName) {
+        // Try each source in order
+        for (const source of this.MODEL_SOURCES) {
+            try {
+                const model = await this.tryLoadFrom(source, modelName);
+                if (model) {
+                    await this.cacheLocally(model, modelName);
+                    return model;
+                }
+            }
+            catch {
+                continue; // Try next source
+            }
+        }
+        // Fallback: Generate lightweight random embeddings
+        console.warn('Using fallback embeddings (reduced accuracy)');
+        return this.generateFallbackModel(modelName);
+    }
+    static async tryLoadFrom(source, model) {
+        if (source.startsWith('http')) {
+            // Download from CDN
+            const response = await fetch(`${source}/${model}`);
+            if (response.ok) {
+                return await response.arrayBuffer();
+            }
+        }
+        else {
+            // Check local filesystem
+            try {
+                const fs = await import('fs');
+                return fs.readFileSync(`${source}/${model}`);
+            }
+            catch {
+                return null;
+            }
+        }
+        return null;
+    }
+    static async cacheLocally(model, name) {
+        // Cache in best available location
+        if (typeof window !== 'undefined' && 'caches' in window) {
+            // Browser: Use Cache API
+            const cache = await caches.open('brainy-models');
+            await cache.put(name, new Response(model));
+        }
+        else if (typeof process !== 'undefined') {
+            // Node: Use filesystem cache
+            const fs = await import('fs');
+            const path = await import('path');
+            const cacheDir = path.join(process.env.HOME || '', '.brainy', 'models');
+            fs.mkdirSync(cacheDir, { recursive: true });
+            fs.writeFileSync(path.join(cacheDir, name), Buffer.from(model));
+        }
+    }
+    static generateFallbackModel(name) {
+        // Deterministic "random" embeddings based on input
+        // Good enough for development/testing
+        const seed = name.split('').reduce((a, b) => a + b.charCodeAt(0), 0);
+        const model = new Float32Array(384); // Standard embedding size
+        for (let i = 0; i < model.length; i++) {
+            model[i] = Math.sin(seed * (i + 1)) * 0.1;
+        }
+        return model.buffer;
+    }
+}
+SmartModelLoader.MODEL_SOURCES = [
+    // 1. Check if bundled locally
+    './models',
+    '../models',
+    // 2. Check user's cache
+    '~/.brainy/models',
+    // 3. Check CDN (fast, free)
+    'https://cdn.jsdelivr.net/npm/@brainy/models@latest',
+    'https://unpkg.com/@brainy/models',
+    // 4. Check Hugging Face (original source)
+    'https://huggingface.co/Xenova/all-MiniLM-L6-v2/resolve/main'
+];
+// Usage - Zero configuration required!
+export async function getEmbedding(text) {
+    const model = await SmartModelLoader.loadModel('encoder.onnx');
+    // ... use model
+}
+//# sourceMappingURL=modelLoader.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "0.62.0",
+  "version": "0.62.2",
   "description": "Multi-Dimensional AI Database - Vector similarity, graph relationships, metadata facets with HNSW indexing and OPFS storage",
   "main": "dist/index.js",
   "module": "dist/index.js",