@soulcraft/brainy 2.10.1 → 2.12.0

package/README.md

@@ -44,13 +44,13 @@ const brain = new BrainyData()
 await brain.init()
 
 // Add entities (nouns) with automatic embedding
-const jsId = await brain.addNoun("JavaScript is a programming language", { 
+const jsId = await brain.addNoun("JavaScript is a programming language", 'concept', { 
   type: "language", 
   year: 1995,
   paradigm: "multi-paradigm"
 })
 
-const nodeId = await brain.addNoun("Node.js runtime environment", {
+const nodeId = await brain.addNoun("Node.js runtime environment", 'concept', {
   type: "runtime",
   year: 2009,
   platform: "server-side"
@@ -225,7 +225,7 @@ const results = await brain.find({
 ### CRUD Operations
 ```javascript
 // Create entities (nouns)
-const id = await brain.addNoun(data, metadata)
+const id = await brain.addNoun(data, nounType, metadata)
 
 // Create relationships (verbs)
 const verbId = await brain.addVerb(sourceId, targetId, "relationType", {
@@ -255,18 +255,18 @@ const exported = await brain.export({ format: 'json' })
 ### Knowledge Management with Relationships
 ```javascript
 // Store documentation with rich relationships
-const apiGuide = await brain.addNoun("REST API Guide", {
+const apiGuide = await brain.addNoun("REST API Guide", 'document', {
   title: "API Guide",
   category: "documentation",
   version: "2.0"
 })
 
-const author = await brain.addNoun("Jane Developer", {
+const author = await brain.addNoun("Jane Developer", 'person', {
   type: "person",
   role: "tech-lead"
 })
 
-const project = await brain.addNoun("E-commerce Platform", {
+const project = await brain.addNoun("E-commerce Platform", 'project', {
   type: "project",
   status: "active"
 })
@@ -295,18 +295,18 @@ const similar = await brain.search(existingContent, {
 ### AI Memory Layer with Context
 ```javascript
 // Store conversation with relationships
-const userId = await brain.addNoun("User 123", {
+const userId = await brain.addNoun("User 123", 'user', {
   type: "user",
   tier: "premium"
 })
 
-const messageId = await brain.addNoun(userMessage, {
+const messageId = await brain.addNoun(userMessage, 'message', {
   type: "message",
   timestamp: Date.now(),
   session: "abc"
 })
 
-const topicId = await brain.addNoun("Product Support", {
+const topicId = await brain.addNoun("Product Support", 'topic', {
   type: "topic",
   category: "support"
 })
@@ -431,7 +431,7 @@ for (const cluster of feedbackClusters) {
 }
 
 // Find related documents
-const docId = await brain.addNoun("Machine learning guide")
+const docId = await brain.addNoun("Machine learning guide", 'document')
 const similar = await neural.neighbors(docId, 5)
 // Returns 5 most similar documents
 

package/dist/augmentations/apiServerAugmentation.js

@@ -138,7 +138,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.add(content, metadata);
+                const id = await this.context.brain.addNoun(content, 'Content', metadata);
                 res.json({ success: true, id });
             }
             catch (error) {
@@ -300,7 +300,7 @@ export class APIServerAugmentation extends BaseAugmentation {
                 }));
                 break;
             case 'add':
-                const id = await this.context.brain.add(msg.content, msg.metadata);
+                const id = await this.context.brain.addNoun(msg.content, 'Content', msg.metadata);
                 socket.send(JSON.stringify({
                     type: 'addResult',
                     requestId: msg.requestId,

package/dist/augmentations/display/fieldPatterns.d.ts

@@ -24,7 +24,7 @@ export declare const TYPE_SPECIFIC_PATTERNS: Record<string, FieldPattern[]>;
 export declare function getFieldPatterns(entityType: 'noun' | 'verb', specificType?: string): FieldPattern[];
 /**
  * Priority fields for different entity types (for AI analysis)
- * Used by the IntelligentTypeMatcher and neural processing
+ * Used by the BrainyTypes and neural processing
  */
 export declare const TYPE_PRIORITY_FIELDS: Record<string, string[]>;
 /**

package/dist/augmentations/display/fieldPatterns.js

@@ -242,7 +242,7 @@ export function getFieldPatterns(entityType, specificType) {
 }
 /**
  * Priority fields for different entity types (for AI analysis)
- * Used by the IntelligentTypeMatcher and neural processing
+ * Used by the BrainyTypes and neural processing
  */
 export const TYPE_PRIORITY_FIELDS = {
     [NounType.Person]: [

package/dist/augmentations/display/intelligentComputation.d.ts

@@ -2,7 +2,7 @@
  * Universal Display Augmentation - Intelligent Computation Engine
  *
  * Leverages existing Brainy AI infrastructure for intelligent field computation:
- * - IntelligentTypeMatcher for semantic type detection
+ * - BrainyTypes for semantic type detection
  * - Neural Import patterns for field analysis
  * - JSON processing utilities for field extraction
  * - Existing NounType/VerbType taxonomy (31+40 types)
@@ -36,7 +36,7 @@ export declare class IntelligentComputationEngine {
      */
     computeVerbDisplay(verb: GraphVerb): Promise<ComputedDisplayFields>;
     /**
-     * AI-powered computation using your existing IntelligentTypeMatcher
+     * AI-powered computation using your existing BrainyTypes
      * @param data Entity data/metadata
      * @param entityType Type of entity (noun/verb)
      * @param options Additional options

package/dist/augmentations/display/intelligentComputation.js

@@ -2,12 +2,12 @@
  * Universal Display Augmentation - Intelligent Computation Engine
  *
  * Leverages existing Brainy AI infrastructure for intelligent field computation:
- * - IntelligentTypeMatcher for semantic type detection
+ * - BrainyTypes for semantic type detection
  * - Neural Import patterns for field analysis
  * - JSON processing utilities for field extraction
  * - Existing NounType/VerbType taxonomy (31+40 types)
  */
-import { getTypeMatcher } from '../typeMatching/intelligentTypeMatcher.js';
+import { getBrainyTypes } from '../typeMatching/brainyTypes.js';
 import { getFieldPatterns, getPriorityFields } from './fieldPatterns.js';
 import { prepareJsonForVectorization } from '../../utils/jsonProcessing.js';
 import { NounType, VerbType } from '../../types/graphTypes.js';
@@ -29,7 +29,7 @@ export class IntelligentComputationEngine {
             return;
         try {
             // 🧠 LEVERAGE YOUR EXISTING AI INFRASTRUCTURE
-            this.typeMatcher = await getTypeMatcher();
+            this.typeMatcher = await getBrainyTypes();
             if (this.typeMatcher) {
                 console.log('🎨 Display computation engine initialized with AI intelligence');
             }
@@ -96,7 +96,7 @@ export class IntelligentComputationEngine {
         }
     }
     /**
-     * AI-powered computation using your existing IntelligentTypeMatcher
+     * AI-powered computation using your existing BrainyTypes
      * @param data Entity data/metadata
      * @param entityType Type of entity (noun/verb)
      * @param options Additional options

package/dist/augmentations/display/types.d.ts

@@ -83,7 +83,7 @@ export interface FieldComputationContext {
     };
 }
 /**
- * Type matching result from IntelligentTypeMatcher
+ * Type matching result from BrainyTypes
  */
 export interface TypeMatchResult {
     type: string;

package/dist/augmentations/neuralImport.js

@@ -8,7 +8,7 @@
  */
 import { BaseAugmentation } from './brainyAugmentation.js';
 import * as path from '../universal/path.js';
-import { getTypeMatcher } from './typeMatching/intelligentTypeMatcher.js';
+import { getBrainyTypes } from './typeMatching/brainyTypes.js';
 import { prodLog } from '../utils/logger.js';
 /**
  * Neural Import Augmentation - Unified Implementation
@@ -37,7 +37,7 @@ export class NeuralImportAugmentation extends BaseAugmentation {
     }
     async onInitialize() {
         try {
-            this.typeMatcher = await getTypeMatcher();
+            this.typeMatcher = await getBrainyTypes();
             this.log('🧠 Neural Import augmentation initialized with intelligent type matching');
         }
         catch (error) {
@@ -378,7 +378,7 @@ export class NeuralImportAugmentation extends BaseAugmentation {
     async inferNounType(obj) {
         if (!this.typeMatcher) {
             // Initialize type matcher if not available
-            this.typeMatcher = await getTypeMatcher();
+            this.typeMatcher = await getBrainyTypes();
         }
         const result = await this.typeMatcher.matchNounType(obj);
         // Log if confidence is low for debugging
@@ -428,7 +428,7 @@ export class NeuralImportAugmentation extends BaseAugmentation {
     async inferVerbType(fieldName, sourceObj, targetObj) {
         if (!this.typeMatcher) {
             // Initialize type matcher if not available
-            this.typeMatcher = await getTypeMatcher();
+            this.typeMatcher = await getBrainyTypes();
         }
         const result = await this.typeMatcher.matchVerbType(sourceObj, targetObj, fieldName);
         // Log if confidence is low for debugging

package/dist/augmentations/synapseAugmentation.js

@@ -173,7 +173,7 @@ export class SynapseAugmentation extends BaseAugmentation {
                     }
                     // Store original content with neural metadata
                     if (typeof content === 'string') {
-                        await this.context.brain.add(content, {
+                        await this.context.brain.addNoun(content, 'Content', {
                             ...enrichedMetadata,
                             _neuralProcessed: true,
                             _neuralConfidence: neuralResult.data.confidence,
@@ -190,11 +190,11 @@ export class SynapseAugmentation extends BaseAugmentation {
         }
         // Fallback to basic storage
         if (typeof content === 'string') {
-            await this.context.brain.add(content, enrichedMetadata);
+            await this.context.brain.addNoun(content, 'Content', enrichedMetadata);
         }
         else {
             // For structured data, store as JSON
-            await this.context.brain.add(JSON.stringify(content), enrichedMetadata);
+            await this.context.brain.addNoun(JSON.stringify(content), 'Content', enrichedMetadata);
         }
     }
     /**

package/dist/augmentations/typeMatching/brainyTypes.d.ts

@@ -0,0 +1,83 @@
+/**
+ * BrainyTypes - Intelligent type detection using semantic embeddings
+ *
+ * This module uses our existing TransformerEmbedding and similarity functions
+ * to intelligently match data to our 31 noun types and 40 verb types.
+ *
+ * Features:
+ * - Semantic similarity matching using embeddings
+ * - Context-aware type detection
+ * - Confidence scoring
+ * - Caching for performance
+ */
+/**
+ * Result of type matching with confidence scores
+ */
+export interface TypeMatchResult {
+    type: string;
+    confidence: number;
+    reasoning: string;
+    alternatives: Array<{
+        type: string;
+        confidence: number;
+    }>;
+}
+/**
+ * BrainyTypes - Intelligent type detection for nouns and verbs
+ */
+export declare class BrainyTypes {
+    private embedder;
+    private nounEmbeddings;
+    private verbEmbeddings;
+    private initialized;
+    private cache;
+    constructor();
+    /**
+     * Initialize the type matcher by generating embeddings for all types
+     */
+    init(): Promise<void>;
+    /**
+     * Match an object to the most appropriate noun type
+     */
+    matchNounType(obj: any): Promise<TypeMatchResult>;
+    /**
+     * Match a relationship to the most appropriate verb type
+     */
+    matchVerbType(sourceObj: any, targetObj: any, relationshipHint?: string): Promise<TypeMatchResult>;
+    /**
+     * Create text representation of an object for embedding
+     */
+    private createTextRepresentation;
+    /**
+     * Create text representation of a relationship
+     */
+    private createRelationshipText;
+    /**
+     * Get a brief summary of an object
+     */
+    private getObjectSummary;
+    /**
+     * Apply heuristic rules for noun type detection
+     */
+    private applyNounHeuristics;
+    /**
+     * Apply heuristic rules for verb type detection
+     */
+    private applyVerbHeuristics;
+    /**
+     * Generate human-readable reasoning for the type selection
+     */
+    private generateReasoning;
+    /**
+     * Clear the cache
+     */
+    clearCache(): void;
+    /**
+     * Dispose of resources
+     */
+    dispose(): Promise<void>;
+}
+/**
+ * Get or create the global BrainyTypes instance
+ */
+export declare function getBrainyTypes(): Promise<BrainyTypes>;