@soulcraft/brainy 3.3.1 → 3.4.0

package/bin/brainy.js

@@ -546,7 +546,7 @@ program
       metadata.encrypted = true
     }
     
-    const id = await brainyInstance.addNoun(processedData, metadata)
+    const id = await brainyInstance.add({ data: processedData, type: 'content', metadata })
     console.log(colors.success(`✅ Added successfully! ID: ${id}`))
   }))
 
@@ -1337,9 +1337,8 @@ program
     }
     
     try {
-      // In 2.0 API, addNoun takes (data, metadata) - type goes in metadata
-      metadata.type = options.type
-      const id = await brainy.addNoun(name, metadata)
+      // Use modern 3.0 API with parameter object
+      const id = await brainy.add({ data: name, type: options.type, metadata })
       
       console.log(colors.success('✅ Noun added successfully!'))
       console.log(colors.info(`🆔 ID: ${id}`))
@@ -1506,7 +1505,7 @@ program
       
       // Use the provided type or fall back to RelatedTo
       const verbType = VerbType[options.type] || options.type
-      const id = await brainy.addVerb(source, target, verbType, metadata)
+      const id = await brainy.relate({ from: source, to: target, type: verbType, metadata })
       
       console.log(colors.success('✅ Relationship added successfully!'))
       console.log(colors.info(`🆔 ID: ${id}`))

package/dist/augmentations/apiServerAugmentation.js

@@ -139,7 +139,7 @@ export class APIServerAugmentation extends BaseAugmentation {
         app.post('/api/add', async (req, res) => {
             try {
                 const { content, metadata } = req.body;
-                const id = await this.context.brain.addNoun(content, 'Content', metadata);
+                const id = await this.context.brain.add({ data: content, type: 'content', metadata });
                 res.json({ success: true, id });
             }
             catch (error) {
@@ -301,7 +301,7 @@ export class APIServerAugmentation extends BaseAugmentation {
                 }));
                 break;
             case 'add':
-                const id = await this.context.brain.addNoun(msg.content, 'Content', msg.metadata);
+                const id = await this.context.brain.add({ data: msg.content, type: 'content', metadata: msg.metadata });
                 socket.send(JSON.stringify({
                     type: 'addResult',
                     requestId: msg.requestId,

package/dist/augmentations/conduitAugmentations.d.ts

@@ -66,6 +66,6 @@ export {};
  * await conduit.establishConnection('ws://localhost:3000/ws')
  *
  * // Now operations sync automatically!
- * await clientBrain.addNoun('synced data', { source: 'client' })
+ * await clientBrain.add({ data: 'synced data', type: 'content', metadata: { source: 'client' } })
  * // This will automatically sync to the server
  */ 

package/dist/augmentations/conduitAugmentations.js

@@ -168,13 +168,18 @@ export class WebSocketConduitAugmentation extends BaseConduitAugmentation {
         try {
             switch (operation) {
                 case 'addNoun':
-                    await this.context?.brain.addNoun(params.content, params.metadata);
+                    await this.context?.brain.add({ data: params.content, type: 'content', metadata: params.metadata });
                     break;
                 case 'deleteNoun':
                     await this.context?.brain.deleteNoun(params.id);
                     break;
                 case 'addVerb':
-                    await this.context?.brain.addVerb(params.source, params.target, params.verb, params.metadata);
+                    await this.context?.brain.relate({
+                        from: params.source,
+                        to: params.target,
+                        type: params.verb,
+                        metadata: params.metadata
+                    });
                     break;
             }
         }
@@ -227,7 +232,7 @@ export class WebSocketConduitAugmentation extends BaseConduitAugmentation {
  * await conduit.establishConnection('ws://localhost:3000/ws')
  *
  * // Now operations sync automatically!
- * await clientBrain.addNoun('synced data', { source: 'client' })
+ * await clientBrain.add({ data: 'synced data', type: 'content', metadata: { source: 'client' } })
  * // This will automatically sync to the server
  */ 
 //# sourceMappingURL=conduitAugmentations.js.map

package/dist/brainy.d.ts

@@ -4,16 +4,20 @@
  * Beautiful, Professional, Planet-Scale, Fun to Use
  * NO STUBS, NO MOCKS, REAL IMPLEMENTATION
  */
+import { Vector } from './coreTypes.js';
 import { ImprovedNeuralAPI } from './neural/improvedNeuralAPI.js';
 import { NaturalLanguageProcessor } from './neural/naturalLanguageProcessor.js';
 import { TripleIntelligenceSystem } from './triple/TripleIntelligenceSystem.js';
 import { Entity, Relation, Result, AddParams, UpdateParams, RelateParams, FindParams, SimilarParams, GetRelationsParams, AddManyParams, DeleteManyParams, RelateManyParams, BatchResult, BrainyConfig } from './types/brainy.types.js';
 import { NounType } from './types/graphTypes.js';
+import { BrainyInterface } from './types/brainyDataInterface.js';
 /**
  * The main Brainy class - Clean, Beautiful, Powerful
  * REAL IMPLEMENTATION - No stubs, no mocks
+ *
+ * Implements BrainyInterface to ensure consistency across integrations
  */
-export declare class Brainy<T = any> {
+export declare class Brainy<T = any> implements BrainyInterface<T> {
     private index;
     private storage;
     private metadataIndex;
@@ -316,7 +320,7 @@ export declare class Brainy<T = any> {
     /**
      * Embed data into vector
      */
-    private embed;
+    embed(data: any): Promise<Vector>;
     /**
      * Warm up the system
      */

package/dist/brainy.js

@@ -22,6 +22,8 @@ import { NounType } from './types/graphTypes.js';
 /**
  * The main Brainy class - Clean, Beautiful, Powerful
  * REAL IMPLEMENTATION - No stubs, no mocks
+ *
+ * Implements BrainyInterface to ensure consistency across integrations
  */
 export class Brainy {
     constructor(config) {

package/dist/importManager.js

@@ -135,8 +135,8 @@ export class ImportManager {
                             _importedAt: new Date().toISOString(),
                             _confidence: item.confidence
                         };
-                        // Add to brain using proper API signature: addNoun(vectorOrData, nounType, metadata)
-                        const id = await this.brain.addNoun(dataToImport, nounType || 'content', metadata);
+                        // Add to brain using modern API signature
+                        const id = await this.brain.add({ data: dataToImport, type: nounType || 'content', metadata });
                         result.nouns.push(id);
                         result.stats.imported++;
                         return id;
@@ -165,7 +165,13 @@ export class ImportManager {
                         const match = await this.typeMatcher.matchVerbType({ id: rel.sourceId }, { id: rel.targetId }, rel.verbType);
                         verbType = match.type;
                     }
-                    const verbId = await this.brain.addVerb(rel.sourceId, rel.targetId, verbType, rel.metadata, rel.weight);
+                    const verbId = await this.brain.relate({
+                        from: rel.sourceId,
+                        to: rel.targetId,
+                        type: verbType,
+                        metadata: rel.metadata,
+                        weight: rel.weight
+                    });
                     result.verbs.push(verbId);
                     result.stats.relationships++;
                 }

package/dist/mcp/brainyMCPAdapter.js

@@ -6,6 +6,7 @@
  * and getting relationships.
  */
 import { v4 as uuidv4 } from '../universal/uuid.js';
+import { NounType } from '../types/graphTypes.js';
 import { MCP_VERSION } from '../types/mcpTypes.js';
 export class BrainyMCPAdapter {
     /**
@@ -49,7 +50,7 @@ export class BrainyMCPAdapter {
         if (!id) {
             return this.createErrorResponse(request.requestId, 'MISSING_PARAMETER', 'Parameter "id" is required');
         }
-        const noun = await this.brainyData.getNoun(id);
+        const noun = await this.brainyData.get(id);
         if (!noun) {
             return this.createErrorResponse(request.requestId, 'NOT_FOUND', `No noun found with id ${id}`);
         }
@@ -65,7 +66,7 @@ export class BrainyMCPAdapter {
         if (!query) {
             return this.createErrorResponse(request.requestId, 'MISSING_PARAMETER', 'Parameter "query" is required');
         }
-        const results = await this.brainyData.searchText(query, k);
+        const results = await this.brainyData.find({ query, limit: k });
         return this.createSuccessResponse(request.requestId, results);
     }
     /**
@@ -78,8 +79,8 @@ export class BrainyMCPAdapter {
         if (!text) {
             return this.createErrorResponse(request.requestId, 'MISSING_PARAMETER', 'Parameter "text" is required');
         }
-        // Add data directly using addNoun
-        const id = await this.brainyData.addNoun(text, 'document', metadata);
+        // Add data using modern API (interface only supports modern methods)
+        const id = await this.brainyData.add({ data: text, type: NounType.Document, metadata });
         return this.createSuccessResponse(request.requestId, { id });
     }
     /**

package/dist/neural/improvedNeuralAPI.js

@@ -2602,7 +2602,7 @@ export class ImprovedNeuralAPI {
             if (clusters.length === 0)
                 break;
             try {
-                const noun = await this.brain.getNoun(itemId);
+                const noun = await this.brain.get(itemId);
                 const itemVector = noun?.vector || [];
                 if (itemVector.length === 0)
                     continue;

package/dist/types/brainyDataInterface.d.ts

@@ -1,55 +1,48 @@
 /**
- * BrainyInterface
+ * BrainyInterface - Modern API Only
  *
- * This interface defines the methods from Brainy that are used by serverSearchAugmentations.ts.
- * It's used to break the circular dependency between brainyData.ts and serverSearchAugmentations.ts.
+ * This interface defines the MODERN methods from Brainy 3.0.
+ * Used to break circular dependencies while enforcing modern API usage.
+ *
+ * NO DEPRECATED METHODS - Only clean, modern API patterns.
  */
 import { Vector } from '../coreTypes.js';
+import { AddParams, RelateParams, Result, Entity, FindParams, SimilarParams } from './brainy.types.js';
 export interface BrainyInterface<T = unknown> {
     /**
      * Initialize the database
      */
     init(): Promise<void>;
     /**
-     * Get a noun by ID
-     * @param id The ID of the noun to get
+     * Modern add method - unified entity creation
+     * @param params Parameters for adding entities
+     * @returns The ID of the created entity
      */
-    getNoun(id: string): Promise<unknown>;
+    add(params: AddParams<T>): Promise<string>;
     /**
-     * @deprecated Use add() instead - it's smart by default now
-     * Add a noun (entity with vector and metadata) to the database
-     * @param data Text string or vector representation (will auto-embed strings)
-     * @param nounType Required noun type (one of 31 types)
-     * @param metadata Optional metadata to associate with the noun
-     * @returns The ID of the added noun
+     * Modern relate method - unified relationship creation
+     * @param params Parameters for creating relationships
+     * @returns The ID of the created relationship
      */
-    addNoun(data: string | Vector, nounType: string, metadata?: T): Promise<string>;
+    relate(params: RelateParams<T>): Promise<string>;
     /**
-     * Search for text in the database
-     * @param text The text to search for
-     * @param limit Maximum number of results to return
-     * @returns Search results
+     * Modern find method - unified search and discovery
+     * @param query Search query or parameters object
+     * @returns Array of search results
      */
-    searchText(text: string, limit?: number): Promise<unknown[]>;
+    find(query: string | FindParams<T>): Promise<Result<T>[]>;
     /**
-     * @deprecated Use relate() instead
-     * Create a relationship (verb) between two entities
-     * @param sourceId The ID of the source entity
-     * @param targetId The ID of the target entity
-     * @param verbType The type of relationship
-     * @param metadata Optional metadata about the relationship
-     * @returns The ID of the created verb
+     * Modern get method - retrieve entities by ID
+     * @param id The entity ID to retrieve
+     * @returns Entity or null if not found
      */
-    addVerb(sourceId: string, targetId: string, verbType: string, metadata?: unknown): Promise<string>;
+    get(id: string): Promise<Entity<T> | null>;
     /**
-     * Find entities similar to a given entity ID
-     * @param id ID of the entity to find similar entities for
-     * @param options Additional options
-     * @returns Array of search results with similarity scores
+     * Modern similar method - find similar entities
+     * @param params Parameters for similarity search
+     * @returns Array of similar entities with scores
      */
-    findSimilar(id: string, options?: {
-        limit?: number;
-    }): Promise<unknown[]>;
+    similar(params: SimilarParams<T>): Promise<Result<T>[]>;
     /**
      * Generate embedding vector from text
      * @param text The text to embed

package/dist/types/brainyDataInterface.js

@@ -1,8 +1,10 @@
 /**
- * BrainyInterface
+ * BrainyInterface - Modern API Only
  *
- * This interface defines the methods from Brainy that are used by serverSearchAugmentations.ts.
- * It's used to break the circular dependency between brainyData.ts and serverSearchAugmentations.ts.
+ * This interface defines the MODERN methods from Brainy 3.0.
+ * Used to break circular dependencies while enforcing modern API usage.
+ *
+ * NO DEPRECATED METHODS - Only clean, modern API patterns.
  */
 export {};
 //# sourceMappingURL=brainyDataInterface.js.map

package/package.json

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