@soulcraft/brainy 3.22.0 → 3.23.1

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [3.23.0](https://github.com/soulcraftlabs/brainy/compare/v3.22.0...v3.23.0) (2025-10-04)
+
+- refactor: streamline core API surface
+
 ### [3.22.0](https://github.com/soulcraftlabs/brainy/compare/v3.21.0...v3.22.0) (2025-10-01)
 
 - feat: add intelligent import for CSV, Excel, and PDF files (814cbb4)

package/README.md

@@ -19,14 +19,6 @@
 
 ## 🎉 Key Features
 
-### 💬 **Infinite Agent Memory**
-
-- **Never Lose Context**: Conversations preserved with semantic search
-- **Smart Context Retrieval**: Triple Intelligence finds relevant past work
-- **Claude Code Integration**: One command (`brainy conversation setup`) enables infinite memory
-- **Automatic Artifact Linking**: Code and files connected to conversations
-- **Scales to Millions**: Messages indexed and searchable in <100ms
-
 ### 🚀 **NEW in 3.21.0: Enhanced Import & Neural Processing**
 
 - **📊 Progress Tracking**: Unified progress reporting with automatic time estimation
@@ -60,42 +52,6 @@
 
 ```bash
 npm install @soulcraft/brainy
-
-# For Claude Code infinite memory (optional):
-brainy conversation setup
-```
-
-### 💬 **Infinite Memory for Claude Code**
-
-```javascript
-// One-time setup:
-// $ brainy conversation setup
-
-// Claude Code now automatically:
-// - Saves every conversation with embeddings
-// - Retrieves relevant past context
-// - Links code artifacts to conversations
-// - Never loses context or momentum
-
-// Use programmatically:
-import { Brainy } from '@soulcraft/brainy'
-
-const brain = new Brainy()
-await brain.init()
-
-// Save conversations
-await brain.conversation.saveMessage(
-  "How do I implement JWT authentication?",
-  "user",
-  { conversationId: "conv_123" }
-)
-
-// Get relevant context (semantic + temporal + graph)
-const context = await brain.conversation.getRelevantContext(
-  "JWT token validation",
-  { limit: 10, includeArtifacts: true }
-)
-// Returns: Ranked messages, linked code, similar conversations
 ```
 
 ### 🎯 **True Zero Configuration**
@@ -675,7 +631,7 @@ const similar = await brain.search(existingContent, {
 ### AI Memory Layer with Context
 
 ```javascript
-// Store conversation with relationships
+// Store messages with relationships
 const userId = await brain.add("User 123", {
     nounType: NounType.User,
     tier: "premium"
@@ -692,7 +648,7 @@ const topicId = await brain.add("Product Support", {
     category: "support"
 })
 
-// Link conversation elements
+// Link message elements
 await brain.relate(userId, messageId, "sent")
 await brain.relate(messageId, topicId, "about")
 
@@ -916,11 +872,6 @@ We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
 
 ## 📖 Documentation
 
-### Infinite Agent Memory 💬
-- [Conversation API Overview](docs/conversation/README.md) - **NEW!** Complete conversation management guide
-- [MCP Integration for Claude Code](docs/conversation/MCP_INTEGRATION.md) - **NEW!** One-command setup
-- [API Reference](docs/conversation/API_REFERENCE.md) - **NEW!** Full API documentation
-
 ### Framework Integration
 - [Framework Integration Guide](docs/guides/framework-integration.md) - Complete framework setup guide
 - [Next.js Integration](docs/guides/nextjs-integration.md) - React and Next.js examples

package/dist/brainy.d.ts

@@ -38,7 +38,6 @@ export declare class Brainy<T = any> implements BrainyInterface<T> {
     private _extractor?;
     private _tripleIntelligence?;
     private _vfs?;
-    private _conversation?;
     private initialized;
     private dimensions?;
     constructor(config?: BrainyConfig);
@@ -645,23 +644,6 @@ 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
      */

package/dist/brainy.js

@@ -1428,30 +1428,6 @@ 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/cli/index.js

@@ -11,7 +11,6 @@ import { coreCommands } from './commands/core.js';
 import { utilityCommands } from './commands/utility.js';
 import { vfsCommands } from './commands/vfs.js';
 import { dataCommands } from './commands/data.js';
-import conversationCommand from './commands/conversation.js';
 import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
@@ -144,43 +143,6 @@ program
     .option('--dimensions <number>', '2D or 3D', '2')
     .option('-o, --output <file>', 'Output file')
     .action(neuralCommands.visualize);
-// ===== Conversation Commands (Infinite Memory) =====
-program
-    .command('conversation')
-    .alias('conv')
-    .description('💬 Infinite agent memory and context management')
-    .addCommand(new Command('setup')
-    .description('Set up MCP server for Claude Code integration')
-    .action(async () => {
-    await conversationCommand.handler({ action: 'setup', _: [] });
-}))
-    .addCommand(new Command('search')
-    .description('Search messages across conversations')
-    .requiredOption('-q, --query <query>', 'Search query')
-    .option('-c, --conversation-id <id>', 'Filter by conversation')
-    .option('-r, --role <role>', 'Filter by role')
-    .option('-l, --limit <number>', 'Maximum results', '10')
-    .action(async (options) => {
-    await conversationCommand.handler({ action: 'search', ...options, _: [] });
-}))
-    .addCommand(new Command('context')
-    .description('Get relevant context for a query')
-    .requiredOption('-q, --query <query>', 'Context query')
-    .option('-l, --limit <number>', 'Maximum messages', '10')
-    .action(async (options) => {
-    await conversationCommand.handler({ action: 'context', ...options, _: [] });
-}))
-    .addCommand(new Command('thread')
-    .description('Get full conversation thread')
-    .requiredOption('-c, --conversation-id <id>', 'Conversation ID')
-    .action(async (options) => {
-    await conversationCommand.handler({ action: 'thread', ...options, _: [] });
-}))
-    .addCommand(new Command('stats')
-    .description('Show conversation statistics')
-    .action(async () => {
-    await conversationCommand.handler({ action: 'stats', _: [] });
-}));
 // ===== VFS Commands (Subcommand Group) =====
 program
     .command('vfs')

package/dist/coreTypes.d.ts

@@ -419,6 +419,12 @@ export interface StorageAdapter {
      * @returns Promise that resolves to a Map of id -> metadata
      */
     getMetadataBatch?(ids: string[]): Promise<Map<string, any>>;
+    /**
+     * Get noun metadata from storage
+     * @param id The ID of the noun
+     * @returns Promise that resolves to the metadata or null if not found
+     */
+    getNounMetadata(id: string): Promise<any | null>;
     /**
      * Save verb metadata to storage
      * @param id The ID of the verb

package/dist/index.d.ts

@@ -56,6 +56,3 @@ import { BrainyMCPAdapter, MCPAugmentationToolset, BrainyMCPService } from './mc
 import { MCPRequest, MCPResponse, MCPDataAccessRequest, MCPToolExecutionRequest, MCPSystemInfoRequest, MCPAuthenticationRequest, MCPRequestType, MCPServiceOptions, MCPTool, MCP_VERSION } from './types/mcpTypes.js';
 export { BrainyMCPAdapter, MCPAugmentationToolset, BrainyMCPService, MCPRequestType, MCP_VERSION };
 export type { MCPRequest, MCPResponse, MCPDataAccessRequest, MCPToolExecutionRequest, MCPSystemInfoRequest, MCPAuthenticationRequest, MCPServiceOptions, MCPTool };
-export { ConversationManager, createConversationManager } from './conversation/index.js';
-export { MCPConversationToolset, createConversationToolset } from './mcp/conversationTools.js';
-export type { MessageRole, ProblemSolvingPhase, ConversationMessage, ConversationMessageMetadata, ConversationThread, ConversationThreadMetadata, ConversationContext, RankedMessage, SaveMessageOptions, ContextRetrievalOptions, ConversationSearchOptions, ConversationSearchResult, ConversationTheme, ArtifactOptions, ConversationStats, CompactionOptions, CompactionResult } from './conversation/types.js';

package/dist/index.js

@@ -118,7 +118,4 @@ export {
 BrainyMCPAdapter, MCPAugmentationToolset, BrainyMCPService, 
 // MCP types
 MCPRequestType, MCP_VERSION };
-// Export Conversation API (Infinite Agent Memory)
-export { ConversationManager, createConversationManager } from './conversation/index.js';
-export { MCPConversationToolset, createConversationToolset } from './mcp/conversationTools.js';
 //# sourceMappingURL=index.js.map

package/dist/storage/adapters/baseStorageAdapter.d.ts

@@ -20,6 +20,7 @@ export declare abstract class BaseStorageAdapter implements StorageAdapter {
     abstract deleteVerb(id: string): Promise<void>;
     abstract saveMetadata(id: string, metadata: any): Promise<void>;
     abstract getMetadata(id: string): Promise<any | null>;
+    abstract getNounMetadata(id: string): Promise<any | null>;
     abstract saveVerbMetadata(id: string, metadata: any): Promise<void>;
     abstract getVerbMetadata(id: string): Promise<any | null>;
     abstract clear(): Promise<void>;

package/dist/storage/adapters/fileSystemStorage.js

@@ -464,7 +464,7 @@ export class FileSystemStorage extends BaseStorage {
             const batch = ids.slice(i, i + batchSize);
             const batchPromises = batch.map(async (id) => {
                 try {
-                    const metadata = await this.getMetadata(id);
+                    const metadata = await this.getNounMetadata(id);
                     return { id, metadata };
                 }
                 catch (error) {

package/dist/storage/adapters/opfsStorage.js

@@ -518,7 +518,7 @@ export class OPFSStorage extends BaseStorage {
             const batch = ids.slice(i, i + batchSize);
             const batchPromises = batch.map(async (id) => {
                 try {
-                    const metadata = await this.getMetadata(id);
+                    const metadata = await this.getNounMetadata(id);
                     return { id, metadata };
                 }
                 catch (error) {

package/dist/utils/metadataIndex.js

@@ -1356,7 +1356,7 @@ export class MetadataIndexManager {
                         const batch = nounIds.slice(i, i + CONCURRENCY_LIMIT);
                         const batchPromises = batch.map(async (id) => {
                             try {
-                                const metadata = await this.storage.getMetadata(id);
+                                const metadata = await this.storage.getNounMetadata(id);
                                 return { id, metadata };
                             }
                             catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulcraft/brainy",
-  "version": "3.22.0",
+  "version": "3.23.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",

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

@@ -1,22 +0,0 @@
-/**
- * 💬 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;