@soulcraft/brainy 1.5.0 → 2.0.0

package/dist/chat/BrainyChat.d.ts

@@ -8,7 +8,7 @@
  * - Uses standard NounType.Message for all chat messages
  * - Employs VerbType.Communicates and VerbType.Precedes for conversation flow
  * - Auto-discovery of previous sessions using Brainy's search capabilities
- * - Hybrid architecture: basic chat (open source) + premium memory sync
+ * - Full-featured chat with memory and context management
  */
 import { BrainyData } from '../brainyData.js';
 export interface ChatMessage {
@@ -37,13 +37,12 @@ export interface ChatSession {
         tags?: string[];
         summary?: string;
         archived?: boolean;
-        premium?: boolean;
     };
 }
 /**
- * Enhanced BrainyChat with automatic context loading and intelligent memory
+ * BrainyChat with automatic context loading and intelligent memory
  *
- * This extends basic chat functionality with premium features when available
+ * Full-featured chat functionality with conversation persistence
  */
 export declare class BrainyChat {
     private brainy;
@@ -65,6 +64,15 @@ export declare class BrainyChat {
      * Stores using standard NounType.Message and creates conversation flow relationships
      */
     addMessage(content: string, speaker?: string, metadata?: ChatMessage['metadata']): Promise<ChatMessage>;
+    /**
+     * Ask a question and get a template-based response
+     * This provides basic functionality without requiring an LLM
+     */
+    ask(question: string, options?: {
+        includeSources?: boolean;
+        maxSources?: number;
+        sessionId?: string;
+    }): Promise<string>;
     /**
      * Get conversation history for current session
      * Uses Brainy's graph traversal to get messages in chronological order
@@ -91,13 +99,14 @@ export declare class BrainyChat {
      */
     switchToSession(sessionId: string): Promise<ChatSession | null>;
     /**
-     * Archive a session (premium feature)
+     * Archive a session
      * Maintains full searchability while organizing conversations
      */
     archiveSession(sessionId: string): Promise<boolean>;
     /**
-     * Generate session summary using AI (premium feature)
-     * Intelligently summarizes long conversations
+     * Generate session summary
+     * Creates a simple summary of the conversation
+     * For AI summaries, users can integrate their own LLM
      */
     generateSessionSummary(sessionId: string): Promise<string | null>;
     private createMessageRelationships;
@@ -107,7 +116,6 @@ export declare class BrainyChat {
     private nounToChatMessage;
     private nounToChatSession;
     private toTimestamp;
-    private isPremiumEnabled;
     getCurrentSessionId(): string | null;
     getCurrentSession(): ChatSession | null;
 }

package/dist/chat/BrainyChat.js

@@ -8,13 +8,13 @@
  * - Uses standard NounType.Message for all chat messages
  * - Employs VerbType.Communicates and VerbType.Precedes for conversation flow
  * - Auto-discovery of previous sessions using Brainy's search capabilities
- * - Hybrid architecture: basic chat (open source) + premium memory sync
+ * - Full-featured chat with memory and context management
  */
 import { NounType, VerbType } from '../types/graphTypes.js';
 /**
- * Enhanced BrainyChat with automatic context loading and intelligent memory
+ * BrainyChat with automatic context loading and intelligent memory
  *
- * This extends basic chat functionality with premium features when available
+ * Full-featured chat functionality with conversation persistence
  */
 export class BrainyChat {
     constructor(brainy) {
@@ -29,7 +29,8 @@ export class BrainyChat {
     async initialize() {
         try {
             // Search for the most recent chat message using Brainy's search
-            const recentMessages = await this.brainy.search('recent chat conversation', 1, {
+            const recentMessages = await this.brainy.search('recent chat conversation', {
+                limit: 1,
                 nounTypes: [NounType.Message],
                 metadata: {
                     messageType: 'chat'
@@ -63,8 +64,7 @@ export class BrainyChat {
             messageCount: 0,
             participants,
             metadata: {
-                tags: ['active'],
-                premium: await this.isPremiumEnabled()
+                tags: ['active']
             }
         };
         // Store session using BrainyData add() method
@@ -123,6 +123,44 @@ export class BrainyChat {
         await this.updateSessionMetadata();
         return message;
     }
+    /**
+     * Ask a question and get a template-based response
+     * This provides basic functionality without requiring an LLM
+     */
+    async ask(question, options) {
+        // Add the user's question to the chat
+        await this.addMessage(question, 'user');
+        // Search for relevant content using Brainy's search
+        const searchResults = await this.brainy.search(question, {
+            limit: options?.maxSources || 5
+        });
+        // Generate a template-based response
+        let response = '';
+        if (searchResults.length === 0) {
+            response = "I don't have enough information to answer that question based on the current data.";
+        }
+        else {
+            // Check if this is a count question
+            if (question.toLowerCase().includes('how many') || question.toLowerCase().includes('count')) {
+                response = `Based on the search results, I found ${searchResults.length} relevant items.`;
+            }
+            // Check if this is a list question
+            else if (question.toLowerCase().includes('list') || question.toLowerCase().includes('show me')) {
+                response = `Here are the relevant items I found:\n${searchResults.map((r, i) => `${i + 1}. ${r.metadata?.title || r.metadata?.content || r.id}`).join('\n')}`;
+            }
+            // General question
+            else {
+                response = `Based on the available data, I found information related to your question. The most relevant content includes: ${searchResults[0].metadata?.title || searchResults[0].metadata?.content || searchResults[0].id}`;
+            }
+            // Add sources if requested
+            if (options?.includeSources && searchResults.length > 0) {
+                response += '\n\nSources: ' + searchResults.map(r => r.id).join(', ');
+            }
+        }
+        // Add the assistant's response to the chat
+        await this.addMessage(response, 'assistant');
+        return response;
+    }
     /**
      * Get conversation history for current session
      * Uses Brainy's graph traversal to get messages in chronological order
@@ -133,7 +171,8 @@ export class BrainyChat {
         try {
             // Search for messages in this session using Brainy's search
             const messageNouns = await this.brainy.search('', // Empty query to get all messages
-            limit, {
+            {
+                limit: limit,
                 nounTypes: [NounType.Message],
                 metadata: {
                     sessionId: this.currentSessionId,
@@ -162,7 +201,8 @@ export class BrainyChat {
             metadata.speaker = options.speaker;
         }
         try {
-            const results = await this.brainy.search(options?.semanticSearch !== false ? query : '', options?.limit || 20, {
+            const results = await this.brainy.search(options?.semanticSearch !== false ? query : '', {
+                limit: options?.limit || 20,
                 nounTypes: [NounType.Message],
                 metadata
             });
@@ -179,7 +219,8 @@ export class BrainyChat {
      */
     async getSessions(limit = 20) {
         try {
-            const sessionNouns = await this.brainy.search('', limit, {
+            const sessionNouns = await this.brainy.search('', {
+                limit: limit,
                 nounTypes: [NounType.Concept],
                 metadata: {
                     sessionType: 'chat'
@@ -211,13 +252,10 @@ export class BrainyChat {
         }
     }
     /**
-     * Archive a session (premium feature)
+     * Archive a session
      * Maintains full searchability while organizing conversations
      */
     async archiveSession(sessionId) {
-        if (!await this.isPremiumEnabled()) {
-            throw new Error('Session archiving requires premium Brain Cloud subscription');
-        }
         try {
             // Since BrainyData doesn't have update, add an archive marker
             await this.brainy.add({
@@ -237,13 +275,11 @@ export class BrainyChat {
         return false;
     }
     /**
-     * Generate session summary using AI (premium feature)
-     * Intelligently summarizes long conversations
+     * Generate session summary
+     * Creates a simple summary of the conversation
+     * For AI summaries, users can integrate their own LLM
      */
     async generateSessionSummary(sessionId) {
-        if (!await this.isPremiumEnabled()) {
-            throw new Error('AI session summaries require premium Brain Cloud subscription');
-        }
         try {
             const messages = await this.getHistoryForSession(sessionId, 100);
             const content = messages
@@ -265,7 +301,8 @@ export class BrainyChat {
             relationship: 'message-in-session'
         });
         // Find previous message to create conversation flow using VerbType.Precedes
-        const previousMessages = await this.brainy.search('', 1, {
+        const previousMessages = await this.brainy.search('', {
+            limit: 1,
             nounTypes: [NounType.Message],
             metadata: {
                 sessionId: this.currentSessionId,
@@ -280,7 +317,8 @@ export class BrainyChat {
     }
     async loadSession(sessionId) {
         try {
-            const sessionNouns = await this.brainy.search('', 1, {
+            const sessionNouns = await this.brainy.search('', {
+                limit: 1,
                 nounTypes: [NounType.Concept],
                 metadata: {
                     sessionType: 'chat'
@@ -299,7 +337,8 @@ export class BrainyChat {
     }
     async getHistoryForSession(sessionId, limit = 50) {
         try {
-            const messageNouns = await this.brainy.search('', limit, {
+            const messageNouns = await this.brainy.search('', {
+                limit: limit,
                 nounTypes: [NounType.Message],
                 metadata: {
                     sessionId: sessionId,
@@ -346,17 +385,6 @@ export class BrainyChat {
         const nanoseconds = (date.getTime() % 1000) * 1000000;
         return { seconds, nanoseconds };
     }
-    async isPremiumEnabled() {
-        // Check if premium augmentations are available
-        // This would integrate with the license validation system
-        try {
-            const augmentations = await this.brainy.listAugmentations();
-            return augmentations.some((aug) => aug.premium === true && aug.enabled === true);
-        }
-        catch {
-            return false;
-        }
-    }
     // Public API methods for CLI integration
     getCurrentSessionId() {
         return this.currentSessionId;

package/dist/chat/ChatCLI.d.ts

@@ -5,7 +5,7 @@
  * - Auto-discovery of previous sessions
  * - Intelligent context loading
  * - Multi-agent coordination support
- * - Premium memory sync integration
+ * - Full conversation history and context
  */
 import { type ChatMessage } from './BrainyChat.js';
 import { BrainyData } from '../brainyData.js';

package/dist/chat/ChatCLI.js

@@ -5,7 +5,7 @@
  * - Auto-discovery of previous sessions
  * - Intelligent context loading
  * - Multi-agent coordination support
- * - Premium memory sync integration
+ * - Full conversation history and context
  */
 import { BrainyChat } from './BrainyChat.js';
 // Simple color utility without external dependencies
@@ -204,13 +204,13 @@ export class ChatCLI {
         console.log('  🔍 Semantic search using vector similarity');
         console.log('  📊 Standard noun/verb graph relationships');
         console.log();
-        console.log(colors.green('Want More? Premium Features:'));
+        console.log(colors.green('Additional Features:'));
         console.log('  🤝 Multi-agent coordination');
-        console.log('  ☁️  Cross-device memory sync');
-        console.log('  🎨 Rich web coordination UI');
-        console.log('  🔄 Real-time team collaboration');
+        console.log('  ☁️  Cross-device sync via augmentations');
+        console.log('  🎨 Web UI integration possible');
+        console.log('  🔄 Real-time collaboration via WebSocket');
         console.log();
-        console.log(colors.blue('Get premium: brainy cloud auth'));
+        console.log(colors.blue('All features included - MIT Licensed'));
         console.log();
     }
     // Private methods

package/dist/cli/catalog.d.ts

@@ -1,8 +1,8 @@
 /**
- * Brain Cloud Catalog Integration for CLI
+ * Augmentation Catalog for CLI
  *
- * Fetches and displays augmentation catalog
- * Falls back to local cache if API is unavailable
+ * Displays available augmentations catalog
+ * Local catalog with caching support
  */
 interface Augmentation {
     id: string;

package/dist/cli/catalog.js

@@ -1,14 +1,14 @@
 /**
- * Brain Cloud Catalog Integration for CLI
+ * Augmentation Catalog for CLI
  *
- * Fetches and displays augmentation catalog
- * Falls back to local cache if API is unavailable
+ * Displays available augmentations catalog
+ * Local catalog with caching support
  */
 import chalk from 'chalk';
 import { readFileSync, writeFileSync, existsSync } from 'fs';
 import { join } from 'path';
 import { homedir } from 'os';
-const CATALOG_API = process.env.BRAIN_CLOUD_CATALOG_URL || 'https://catalog.brain-cloud.soulcraft.com';
+const CATALOG_API = process.env.BRAINY_CATALOG_URL || null;
 const CACHE_PATH = join(homedir(), '.brainy', 'catalog-cache.json');
 const CACHE_TTL = 24 * 60 * 60 * 1000; // 24 hours
 /**
@@ -20,20 +20,24 @@ export async function fetchCatalog() {
         const cached = loadCache();
         if (cached)
             return cached;
-        // Fetch from API
-        const response = await fetch(`${CATALOG_API}/api/catalog/cli`);
-        if (!response.ok)
-            throw new Error('API unavailable');
-        const catalog = await response.json();
-        // Save to cache
-        saveCache(catalog);
-        return catalog;
+        // If external catalog API is configured, try to fetch
+        if (CATALOG_API) {
+            const response = await fetch(`${CATALOG_API}/api/catalog/cli`);
+            if (!response.ok)
+                throw new Error('API unavailable');
+            const catalog = await response.json();
+            // Save to cache
+            saveCache(catalog);
+            return catalog;
+        }
+        // Fall back to local catalog
+        return getDefaultCatalog();
     }
     catch (error) {
         // Try loading from cache even if expired
         const cached = loadCache(true);
         if (cached) {
-            console.log(chalk.yellow('📡 Using cached catalog (API unavailable)'));
+            console.log(chalk.yellow('📡 Using cached catalog'));
             return cached;
         }
         // Fall back to hardcoded catalog
@@ -49,7 +53,7 @@ export async function showCatalog(options) {
         console.log(chalk.red('❌ Could not load augmentation catalog'));
         return;
     }
-    console.log(chalk.cyan.bold('🧠 Brain Cloud Augmentation Catalog'));
+    console.log(chalk.cyan.bold('🧠 Brainy Augmentation Catalog'));
     console.log(chalk.gray(`Version ${catalog.version}`));
     console.log('');
     // Filter augmentations
@@ -88,7 +92,7 @@ export async function showCatalog(options) {
     console.log(chalk.green(`✅ ${available} available`) + chalk.gray(` • `) +
         chalk.yellow(`🔜 ${coming} coming soon`));
     console.log('');
-    console.log(chalk.dim('Sign up at app.soulcraft.com to activate'));
+    console.log(chalk.dim('Configure augmentations with "brainy augment"'));
     console.log(chalk.dim('Run "brainy augment info <name>" for details'));
 }
 /**
@@ -110,8 +114,10 @@ export async function showAugmentationInfo(id) {
         });
         return;
     }
-    // Fetch full details from API
+    // Fetch full details from API if available
     try {
+        if (!CATALOG_API)
+            throw new Error('No external catalog configured');
         const response = await fetch(`${CATALOG_API}/api/catalog/augmentation/${id}`);
         const details = await response.json();
         console.log(chalk.cyan.bold(`📦 ${details.name}`));
@@ -155,57 +161,61 @@ export async function showAugmentationInfo(id) {
         console.log(chalk.cyan.bold(`📦 ${aug.name}`));
         console.log(aug.description);
         console.log('');
-        console.log(chalk.dim('Full details unavailable (API offline)'));
+        console.log(chalk.dim('Full details unavailable (no external catalog configured)'));
     }
 }
 /**
  * Show user's available augmentations
  */
 export async function showAvailable(licenseKey) {
-    const key = licenseKey || process.env.BRAINY_LICENSE_KEY || readLicenseFile();
-    if (!key) {
-        console.log(chalk.yellow('⚠️  No license key found'));
-        console.log('');
-        console.log('To see your available augmentations:');
-        console.log('  1. Sign up at app.soulcraft.com');
-        console.log('  2. Run: brainy augment activate');
+    // Show local catalog as default
+    const catalog = await fetchCatalog();
+    if (!catalog) {
+        console.log(chalk.red('❌ Could not load augmentation catalog'));
         return;
     }
-    try {
-        const response = await fetch(`${CATALOG_API}/api/catalog/available`, {
-            headers: { 'x-license-key': key }
+    console.log(chalk.cyan.bold('🧠 Available Augmentations'));
+    console.log('');
+    const available = catalog.augmentations.filter(a => a.status === 'available');
+    const grouped = groupByCategory(available, catalog.categories);
+    for (const [category, augs] of Object.entries(grouped)) {
+        if (augs.length === 0)
+            continue;
+        const cat = catalog.categories.find(c => c.id === category);
+        console.log(chalk.bold(`${cat?.icon || '📦'} ${cat?.name || category}`));
+        augs.forEach(aug => {
+            console.log(`  ✅ ${aug.name}`);
+            console.log(chalk.gray(`     ${aug.description}`));
         });
-        if (!response.ok) {
-            throw new Error('Invalid license');
-        }
-        const data = await response.json();
-        console.log(chalk.cyan.bold('🧠 Your Available Augmentations'));
-        console.log(chalk.gray(`Plan: ${data.plan}`));
         console.log('');
-        const grouped = groupByCategory(data.augmentations, []);
-        for (const [category, augs] of Object.entries(grouped)) {
-            console.log(chalk.bold(category));
-            augs.forEach(aug => {
-                console.log(`  ✅ ${aug.name}`);
+    }
+    console.log(chalk.green(`✅ ${available.length} augmentations available`));
+    // If external API is configured and license key provided, try to fetch personalized data
+    if (CATALOG_API && licenseKey) {
+        try {
+            const response = await fetch(`${CATALOG_API}/api/catalog/available`, {
+                headers: { 'x-license-key': licenseKey }
             });
-            console.log('');
-        }
-        if (data.operations) {
-            const used = data.operations.used || 0;
-            const limit = data.operations.limit;
-            const percent = limit === 'unlimited' ? 0 : Math.round((used / limit) * 100);
-            console.log(chalk.bold('Usage:'));
-            if (limit === 'unlimited') {
-                console.log(`  Unlimited operations`);
-            }
-            else {
-                console.log(`  ${used.toLocaleString()} / ${limit.toLocaleString()} operations (${percent}%)`);
+            if (response.ok) {
+                const data = await response.json();
+                console.log(chalk.gray(`Plan: ${data.plan || 'Standard'}`));
+                if (data.operations) {
+                    const used = data.operations.used || 0;
+                    const limit = data.operations.limit;
+                    const percent = limit === 'unlimited' ? 0 : Math.round((used / limit) * 100);
+                    console.log(chalk.bold('Usage:'));
+                    if (limit === 'unlimited') {
+                        console.log(`  Unlimited operations`);
+                    }
+                    else {
+                        console.log(`  ${used.toLocaleString()} / ${limit.toLocaleString()} operations (${percent}%)`);
+                    }
+                }
             }
         }
-    }
-    catch (error) {
-        console.log(chalk.red('❌ Could not fetch available augmentations'));
-        console.log(chalk.gray(error.message));
+        catch (error) {
+            // Ignore external API errors - local catalog is sufficient
+        }
     }
 }
 // Helper functions
@@ -287,36 +297,72 @@ function readLicenseFile() {
     return null;
 }
 function getDefaultCatalog() {
-    // Hardcoded fallback catalog
+    // Local catalog with current features
     return {
-        version: '1.0.0',
+        version: '1.5.0',
         categories: [
-            { id: 'memory', name: 'Memory', icon: '🧠', description: 'AI memory and persistence' },
-            { id: 'coordination', name: 'Coordination', icon: '🤝', description: 'Multi-agent orchestration' },
-            { id: 'enterprise', name: 'Enterprise', icon: '🏢', description: 'Business integrations' }
+            { id: 'core', name: 'Core Features', icon: '🧠', description: 'Essential brainy functionality' },
+            { id: 'neural', name: 'Neural API', icon: '🔗', description: 'Semantic similarity and clustering' },
+            { id: 'enterprise', name: 'Enterprise', icon: '🏢', description: 'Business integrations' },
+            { id: 'storage', name: 'Storage', icon: '💾', description: 'Data persistence and caching' }
         ],
         augmentations: [
             {
-                id: 'ai-memory',
-                name: 'AI Memory',
-                category: 'memory',
-                description: 'Persistent memory across all AI sessions',
+                id: 'vector-search',
+                name: 'Vector Search',
+                category: 'core',
+                description: 'High-performance semantic search with HNSW indexing',
                 status: 'available',
                 popular: true
             },
             {
-                id: 'agent-coordinator',
-                name: 'Agent Coordinator',
-                category: 'coordination',
-                description: 'Multi-agent handoffs and orchestration',
+                id: 'neural-similarity',
+                name: 'Neural Similarity API',
+                category: 'neural',
+                description: 'Advanced semantic similarity, clustering, and hierarchy detection',
                 status: 'available',
                 popular: true
             },
             {
-                id: 'notion-sync',
-                name: 'Notion Sync',
+                id: 'intelligent-verb-scoring',
+                name: 'Intelligent Verb Scoring',
+                category: 'neural',
+                description: 'Smart relationship scoring with taxonomy understanding',
+                status: 'available'
+            },
+            {
+                id: 'wal-augmentation',
+                name: 'WAL-based Augmentation',
                 category: 'enterprise',
-                description: 'Bidirectional Notion database sync',
+                description: 'Write-ahead log for reliable augmentation processing',
+                status: 'available'
+            },
+            {
+                id: 'connection-pooling',
+                name: 'Connection Pooling',
+                category: 'enterprise',
+                description: 'Efficient database connection management',
+                status: 'available'
+            },
+            {
+                id: 'batch-processing',
+                name: 'Batch Processing',
+                category: 'enterprise',
+                description: 'High-throughput batch operations with deduplication',
+                status: 'available'
+            },
+            {
+                id: 's3-storage',
+                name: 'S3 Compatible Storage',
+                category: 'storage',
+                description: 'Cloud storage with optimized batch operations',
+                status: 'available'
+            },
+            {
+                id: 'opfs-storage',
+                name: 'OPFS Storage',
+                category: 'storage',
+                description: 'Browser-based persistent storage',
                 status: 'available'
             }
         ]

package/dist/cli/commands/core.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Core CLI Commands - TypeScript Implementation
+ *
+ * Essential database operations: add, search, get, relate, import, export
+ */
+interface CoreOptions {
+    verbose?: boolean;
+    json?: boolean;
+    pretty?: boolean;
+}
+interface AddOptions extends CoreOptions {
+    id?: string;
+    metadata?: string;
+    type?: string;
+}
+interface SearchOptions extends CoreOptions {
+    limit?: string;
+    threshold?: string;
+    metadata?: string;
+}
+interface GetOptions extends CoreOptions {
+    withConnections?: boolean;
+}
+interface RelateOptions extends CoreOptions {
+    weight?: string;
+    metadata?: string;
+}
+interface ImportOptions extends CoreOptions {
+    format?: 'json' | 'csv' | 'jsonl';
+    batchSize?: string;
+}
+interface ExportOptions extends CoreOptions {
+    format?: 'json' | 'csv' | 'jsonl';
+}
+export declare const coreCommands: {
+    /**
+     * Add data to the neural database
+     */
+    add(text: string, options: AddOptions): Promise<void>;
+    /**
+     * Search the neural database
+     */
+    search(query: string, options: SearchOptions): Promise<void>;
+    /**
+     * Get item by ID
+     */
+    get(id: string, options: GetOptions): Promise<void>;
+    /**
+     * Create relationship between items
+     */
+    relate(source: string, verb: string, target: string, options: RelateOptions): Promise<void>;
+    /**
+     * Import data from file
+     */
+    import(file: string, options: ImportOptions): Promise<void>;
+    /**
+     * Export database
+     */
+    export(file: string | undefined, options: ExportOptions): Promise<void>;
+};
+export {};