@soulcraft/brainy 3.18.0 → 3.19.1

package/dist/api/DataAPI.d.ts

@@ -69,7 +69,7 @@ export declare class DataAPI {
     private getEntity;
     private getRelation?;
     private brain;
-    constructor(storage: StorageAdapter, getEntity: (id: string) => Promise<Entity | null>, getRelation?: ((id: string) => Promise<Relation | null>) | undefined, brain?: any);
+    constructor(storage: StorageAdapter, getEntity: (id: string) => Promise<Entity | null>, getRelation?: (id: string) => Promise<Relation | null>, brain?: any);
     /**
      * Create a backup of all data
      */

package/dist/augmentations/cacheAugmentation.d.ts

@@ -98,7 +98,7 @@ export declare class CacheAugmentation extends BaseAugmentation {
     /**
      * Get the underlying SearchCache instance (for compatibility)
      */
-    getSearchCache(): SearchCache<GraphNoun> | null;
+    getSearchCache(): SearchCache<GraphNoun>;
     /**
      * Get memory usage
      */

package/dist/augmentations/metricsAugmentation.d.ts

@@ -100,13 +100,13 @@ export declare class MetricsAugmentation extends BaseAugmentation {
             p99Latency: number;
         };
     } | {
-        nounCount?: Record<string, number> | undefined;
-        verbCount?: Record<string, number> | undefined;
-        metadataCount?: Record<string, number> | undefined;
-        hnswIndexSize?: number | undefined;
-        totalNodes?: number | undefined;
-        totalEdges?: number | undefined;
-        totalMetadata?: number | undefined;
+        nounCount?: Record<string, number>;
+        verbCount?: Record<string, number>;
+        metadataCount?: Record<string, number>;
+        hnswIndexSize?: number;
+        totalNodes?: number;
+        totalEdges?: number;
+        totalMetadata?: number;
         operations?: {
             add: number;
             search: number;
@@ -114,10 +114,10 @@ export declare class MetricsAugmentation extends BaseAugmentation {
             update: number;
             relate: number;
             total: number;
-        } | undefined;
-        fieldNames?: Record<string, string[]> | undefined;
-        standardFieldMappings?: Record<string, Record<string, string[]>> | undefined;
-        contentTypes?: Record<string, number> | undefined;
+        };
+        fieldNames?: Record<string, string[]>;
+        standardFieldMappings?: Record<string, Record<string, string[]>>;
+        contentTypes?: Record<string, number>;
         dataFreshness?: {
             oldestEntry: string;
             newestEntry: string;
@@ -129,32 +129,32 @@ export declare class MetricsAugmentation extends BaseAugmentation {
                 last30d: number;
                 older: number;
             };
-        } | undefined;
+        };
         storageMetrics?: {
             totalSizeBytes: number;
             nounsSizeBytes: number;
             verbsSizeBytes: number;
             metadataSizeBytes: number;
             indexSizeBytes: number;
-        } | undefined;
+        };
         searchMetrics?: {
             totalSearches: number;
             averageSearchTimeMs: number;
             searchesLastHour: number;
             searchesLastDay: number;
             topSearchTerms?: string[];
-        } | undefined;
+        };
         verbStatistics?: {
             totalVerbs: number;
             verbTypes: Record<string, number>;
             averageConnectionsPerVerb: number;
-        } | undefined;
+        };
         serviceActivity?: Record<string, {
             firstActivity: string;
             lastActivity: string;
             totalOperations: number;
-        }> | undefined;
-        services?: import("../coreTypes.js").ServiceStatistics[] | undefined;
+        }>;
+        services?: import("../coreTypes.js").ServiceStatistics[];
         throttlingMetrics?: {
             storage?: {
                 currentlyThrottled: boolean;
@@ -177,9 +177,9 @@ export declare class MetricsAugmentation extends BaseAugmentation {
                 lastThrottle: string;
                 status: "normal" | "throttled" | "recovering";
             }>;
-        } | undefined;
-        lastUpdated?: string | undefined;
-        distributedConfig?: import("../types/distributedTypes.js").SharedConfig | undefined;
+        };
+        lastUpdated?: string;
+        distributedConfig?: import("../types/distributedTypes.js").SharedConfig;
         enabled: boolean;
         note: string;
         totalSearches?: undefined;

package/dist/brainy.d.ts

@@ -38,6 +38,7 @@ export declare class Brainy<T = any> implements BrainyInterface<T> {
     private _extractor?;
     private _tripleIntelligence?;
     private _vfs?;
+    private _conversation?;
     private initialized;
     private dimensions?;
     constructor(config?: BrainyConfig);
@@ -644,6 +645,23 @@ export declare class Brainy<T = any> implements BrainyInterface<T> {
      * Virtual File System API - Knowledge Operating System
      */
     vfs(): VirtualFileSystem;
+    /**
+     * Conversation Manager API - Infinite Agent Memory
+     *
+     * Provides conversation and context management for AI agents:
+     * - Save and retrieve conversation messages
+     * - Semantic search across conversation history
+     * - Smart context retrieval with relevance ranking
+     * - Artifact management (code, files, documents)
+     * - Conversation themes and clustering
+     *
+     * @returns ConversationManager instance
+     * @example
+     * const conv = brain.conversation
+     * await conv.saveMessage("How do I implement auth?", "user", { conversationId: "conv_123" })
+     * const context = await conv.getRelevantContext("authentication implementation")
+     */
+    conversation(): any;
     /**
      * Data Management API - backup, restore, import, export
      */
@@ -806,7 +824,7 @@ export declare class Brainy<T = any> implements BrainyInterface<T> {
      */
     get augmentations(): {
         list: () => string[];
-        get: (name: string) => import("./augmentations/brainyAugmentation.js").BrainyAugmentation | undefined;
+        get: (name: string) => import("./augmentations/brainyAugmentation.js").BrainyAugmentation;
         has: (name: string) => boolean;
     };
     /**

package/dist/brainy.js

@@ -1419,6 +1419,30 @@ export class Brainy {
         }
         return this._vfs;
     }
+    /**
+     * Conversation Manager API - Infinite Agent Memory
+     *
+     * Provides conversation and context management for AI agents:
+     * - Save and retrieve conversation messages
+     * - Semantic search across conversation history
+     * - Smart context retrieval with relevance ranking
+     * - Artifact management (code, files, documents)
+     * - Conversation themes and clustering
+     *
+     * @returns ConversationManager instance
+     * @example
+     * const conv = brain.conversation
+     * await conv.saveMessage("How do I implement auth?", "user", { conversationId: "conv_123" })
+     * const context = await conv.getRelevantContext("authentication implementation")
+     */
+    conversation() {
+        if (!this._conversation) {
+            // Lazy-load ConversationManager to avoid circular dependencies
+            const { ConversationManager } = require('./conversation/conversationManager.js');
+            this._conversation = new ConversationManager(this);
+        }
+        return this._conversation;
+    }
     /**
      * Data Management API - backup, restore, import, export
      */

package/dist/brainyData.js

@@ -20,7 +20,6 @@ import { DistributedConfigManager, HashPartitioner, OperationalModeFactory, Doma
 import { CacheAutoConfigurator } from './utils/cacheAutoConfig.js';
 import { RequestDeduplicator } from './utils/requestDeduplicator.js';
 import { AugmentationRegistry } from './augmentations/brainyAugmentation.js';
-import { WALAugmentation } from './augmentations/walAugmentation.js';
 import { RequestDeduplicatorAugmentation } from './augmentations/requestDeduplicatorAugmentation.js';
 import { ConnectionPoolAugmentation } from './augmentations/connectionPoolAugmentation.js';
 import { BatchProcessingAugmentation } from './augmentations/batchProcessingAugmentation.js';
@@ -310,7 +309,7 @@ export class BrainyData {
         // Priority 100: Critical system operations
         // Disable WAL in test environments to avoid directory creation issues
         const isTestEnvironment = process.env.NODE_ENV === 'test' || process.env.VITEST === 'true';
-        this.augmentations.register(new WALAugmentation({ enabled: !isTestEnvironment }));
+//         this.augmentations.register(new WALAugmentation({ enabled: !isTestEnvironment }));
         this.augmentations.register(new ConnectionPoolAugmentation());
         // Priority 95: Entity registry for fast external-ID to UUID mapping
         this.augmentations.register(new EntityRegistryAugmentation({

package/dist/cli/catalog.js

@@ -5,9 +5,9 @@
  * Local catalog with caching support
  */
 import chalk from 'chalk';
-import { readFileSync, writeFileSync, existsSync } from 'fs';
-import { join } from 'path';
-import { homedir } from 'os';
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
 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
@@ -237,7 +237,7 @@ function saveCache(catalog) {
     try {
         const dir = join(homedir(), '.brainy');
         if (!existsSync(dir)) {
-            require('fs').mkdirSync(dir, { recursive: true });
+            mkdirSync(dir, { recursive: true });
         }
         writeFileSync(CACHE_PATH, JSON.stringify({
             catalog,
@@ -293,7 +293,10 @@ function readLicenseFile() {
             return readFileSync(licensePath, 'utf8').trim();
         }
     }
-    catch { }
+    catch (error) {
+        // License file read failed, return null
+        console.debug('Failed to read license file:', error);
+    }
     return null;
 }
 function getDefaultCatalog() {
@@ -330,13 +333,6 @@ function getDefaultCatalog() {
                 description: 'Smart relationship scoring with taxonomy understanding',
                 status: 'available'
             },
-            {
-                id: 'wal-augmentation',
-                name: 'WAL-based Augmentation',
-                category: 'enterprise',
-                description: 'Write-ahead log for reliable augmentation processing',
-                status: 'available'
-            },
             {
                 id: 'connection-pooling',
                 name: 'Connection Pooling',

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

@@ -0,0 +1,22 @@
+/**
+ * 💬 Conversation CLI Commands
+ *
+ * CLI interface for infinite agent memory and conversation management
+ */
+interface CommandArguments {
+    action?: string;
+    conversationId?: string;
+    query?: string;
+    role?: string;
+    limit?: number;
+    format?: string;
+    output?: string;
+    _: string[];
+}
+export declare const conversationCommand: {
+    command: string;
+    describe: string;
+    builder: (yargs: any) => any;
+    handler: (argv: CommandArguments) => Promise<void>;
+};
+export default conversationCommand;