@soulcraft/brainy 3.3.1 → 3.5.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/api/DataAPI.js

@@ -61,7 +61,7 @@ export class DataAPI {
         // Compress if requested
         if (compress) {
             // Import zlib for compression
-            const { gzipSync } = await import('zlib');
+            const { gzipSync } = await import('node:zlib');
             const jsonString = JSON.stringify(backupData);
             const compressed = gzipSync(Buffer.from(jsonString));
             return {

package/dist/api/UniversalImportAPI.js

@@ -78,7 +78,7 @@ export class UniversalImportAPI {
      */
     async importFromFile(filePath) {
         // Read the actual file content
-        const { readFileSync } = await import('fs');
+        const { readFileSync } = await import('node:fs');
         const ext = filePath.split('.').pop()?.toLowerCase() || 'txt';
         try {
             const fileContent = readFileSync(filePath, 'utf-8');

package/dist/augmentations/apiServerAugmentation.js

@@ -72,7 +72,7 @@ export class APIServerAugmentation extends BaseAugmentation {
             const express = await import('express').catch(() => null);
             const cors = await import('cors').catch(() => null);
             const ws = await import('ws').catch(() => null);
-            const { createServer } = await import('http');
+            const { createServer } = await import('node:http');
             if (!express || !cors || !ws) {
                 this.log('Express, cors, or ws not available. Install with: npm install express cors ws', 'error');
                 return;
@@ -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/auditLogAugmentation.js

@@ -3,7 +3,7 @@
  * Provides comprehensive audit trail for all Brainy operations
  */
 import { BaseAugmentation } from './brainyAugmentation.js';
-import { createHash } from 'crypto';
+import { createHash } from 'node:crypto';
 /**
  * Audit Log Augmentation
  */

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/augmentations/configResolver.js

@@ -7,9 +7,9 @@
  * - Runtime updates
  * - Default values from schema
  */
-import { existsSync, readFileSync } from 'fs';
-import { join } from 'path';
-import { homedir } from 'os';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
 /**
  * Configuration source priority (highest to lowest)
  */
@@ -379,8 +379,8 @@ export class AugmentationConfigResolver {
         if (typeof process === 'undefined' || typeof window !== 'undefined') {
             throw new Error('Cannot save configuration files in browser environment');
         }
-        const fs = await import('fs');
-        const path = await import('path');
+        const fs = await import('node:fs');
+        const path = await import('node:path');
         const configPath = filepath || this.options.configPaths?.[0] || '.brainyrc';
         const augId = this.options.augmentationId;
         // Load existing config if it exists

package/dist/augmentations/discovery/localDiscovery.js

@@ -4,8 +4,8 @@
  * Discovers augmentations installed locally in node_modules
  * and built-in augmentations that ship with Brainy
  */
-import { existsSync, readdirSync, readFileSync } from 'fs';
-import { join } from 'path';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
 /**
  * Discovers augmentations installed locally
  */

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/config/storageAutoConfig.js

@@ -300,8 +300,8 @@ async function isWritable(dirPath) {
         return false;
     try {
         // Dynamic import fs for Node.js
-        const { promises: fs } = await import('fs');
-        const path = await import('path');
+        const { promises: fs } = await import('node:fs');
+        const path = await import('node:path');
         // Try to create directory if it doesn't exist
         await fs.mkdir(dirPath, { recursive: true });
         // Try to write a test file

package/dist/cortex/backupRestore.js

@@ -257,16 +257,16 @@ export class BackupRestore {
     }
     async compressData(data) {
         // Use zlib gzip compression
-        const { gzip } = await import('zlib');
-        const { promisify } = await import('util');
+        const { gzip } = await import('node:zlib');
+        const { promisify } = await import('node:util');
         const gzipAsync = promisify(gzip);
         const compressed = await gzipAsync(Buffer.from(data, 'utf-8'));
         return compressed.toString('base64');
     }
     async decompressData(data) {
         // Use zlib gunzip decompression
-        const { gunzip } = await import('zlib');
-        const { promisify } = await import('util');
+        const { gunzip } = await import('node:zlib');
+        const { promisify } = await import('node:util');
         const gunzipAsync = promisify(gunzip);
         const compressed = Buffer.from(data, 'base64');
         const decompressed = await gunzipAsync(compressed);
@@ -274,7 +274,7 @@ export class BackupRestore {
     }
     async encryptData(data, password) {
         // Use crypto module for AES-256 encryption
-        const crypto = await import('crypto');
+        const crypto = await import('node:crypto');
         // Generate key from password
         const key = crypto.createHash('sha256').update(password).digest();
         const iv = crypto.randomBytes(16);
@@ -286,7 +286,7 @@ export class BackupRestore {
     }
     async decryptData(data, password) {
         // Use crypto module for AES-256 decryption
-        const crypto = await import('crypto');
+        const crypto = await import('node:crypto');
         // Split IV and encrypted data
         const [ivString, encrypted] = data.split(':');
         const iv = Buffer.from(ivString, 'base64');
@@ -367,7 +367,7 @@ export class BackupRestore {
     }
     async calculateChecksum(data) {
         // Use crypto module for SHA-256 checksum
-        const crypto = await import('crypto');
+        const crypto = await import('node:crypto');
         return crypto.createHash('sha256').update(data).digest('hex');
     }
     formatFileSize(bytes) {

package/dist/critical/model-guardian.js

@@ -10,9 +10,9 @@
  * 3. Model MUST produce consistent 384-dim embeddings
  * 4. System MUST fail fast if model unavailable in production
  */
-import { existsSync } from 'fs';
-import { stat } from 'fs/promises';
-import { join } from 'path';
+import { existsSync } from 'node:fs';
+import { stat } from 'node:fs/promises';
+import { join } from 'node:path';
 import { env } from '@huggingface/transformers';
 // CRITICAL: These values MUST NEVER CHANGE
 const CRITICAL_MODEL_CONFIG = {
@@ -172,8 +172,8 @@ export class ModelGuardian {
      */
     async computeFileHash(filePath) {
         try {
-            const { readFile } = await import('fs/promises');
-            const { createHash } = await import('crypto');
+            const { readFile } = await import('node:fs/promises');
+            const { createHash } = await import('node:crypto');
             const fileBuffer = await readFile(filePath);
             const hash = createHash('sha256').update(fileBuffer).digest('hex');
             return hash;

package/dist/distributed/cacheSync.d.ts

@@ -2,7 +2,7 @@
  * Distributed Cache Synchronization
  * Provides cache coherence across multiple Brainy instances
  */
-import { EventEmitter } from 'events';
+import { EventEmitter } from 'node:events';
 export interface CacheSyncConfig {
     nodeId: string;
     syncInterval?: number;

package/dist/distributed/cacheSync.js

@@ -2,7 +2,7 @@
  * Distributed Cache Synchronization
  * Provides cache coherence across multiple Brainy instances
  */
-import { EventEmitter } from 'events';
+import { EventEmitter } from 'node:events';
 /**
  * Distributed Cache Synchronizer
  */

package/dist/distributed/coordinator.d.ts

@@ -2,7 +2,7 @@
  * Distributed Coordinator for Brainy 3.0
  * Provides leader election, consensus, and coordination for distributed instances
  */
-import { EventEmitter } from 'events';
+import { EventEmitter } from 'node:events';
 import { NetworkTransport } from './networkTransport.js';
 export interface NodeInfo {
     id: string;

package/dist/distributed/coordinator.js

@@ -2,8 +2,8 @@
  * Distributed Coordinator for Brainy 3.0
  * Provides leader election, consensus, and coordination for distributed instances
  */
-import { EventEmitter } from 'events';
-import { createHash } from 'crypto';
+import { EventEmitter } from 'node:events';
+import { createHash } from 'node:crypto';
 /**
  * Distributed Coordinator implementing Raft-like consensus
  */

package/dist/distributed/httpTransport.d.ts

@@ -3,8 +3,8 @@
  * Simple, reliable, works everywhere - no WebSocket complexity!
  * REAL PRODUCTION CODE - Handles millions of operations
  */
-import * as http from 'http';
-import { EventEmitter } from 'events';
+import * as http from 'node:http';
+import { EventEmitter } from 'node:events';
 export interface TransportMessage {
     id: string;
     method: string;

package/dist/distributed/httpTransport.js

@@ -3,11 +3,11 @@
  * Simple, reliable, works everywhere - no WebSocket complexity!
  * REAL PRODUCTION CODE - Handles millions of operations
  */
-import * as http from 'http';
-import * as https from 'https';
-import { EventEmitter } from 'events';
-import * as net from 'net';
-import { URL } from 'url';
+import * as http from 'node:http';
+import * as https from 'node:https';
+import { EventEmitter } from 'node:events';
+import * as net from 'node:net';
+import { URL } from 'node:url';
 export class HTTPTransport extends EventEmitter {
     constructor(nodeId) {
         super();

package/dist/distributed/networkTransport.d.ts

@@ -2,7 +2,7 @@
  * Network Transport Layer for Distributed Brainy
  * Uses WebSocket + HTTP for maximum compatibility
  */
-import { EventEmitter } from 'events';
+import { EventEmitter } from 'node:events';
 export interface NetworkMessage {
     type: string;
     from: string;

package/dist/distributed/networkTransport.js

@@ -2,8 +2,8 @@
  * Network Transport Layer for Distributed Brainy
  * Uses WebSocket + HTTP for maximum compatibility
  */
-import * as http from 'http';
-import { EventEmitter } from 'events';
+import * as http from 'node:http';
+import { EventEmitter } from 'node:events';
 import { WebSocket } from 'ws';
 // Use dynamic imports for Node.js specific modules
 let WebSocketServer;
@@ -311,7 +311,7 @@ export class NetworkTransport extends EventEmitter {
         const token = process.env.KUBERNETES_TOKEN || '';
         try {
             // Query Kubernetes API for pod endpoints
-            const https = await import('https');
+            const https = await import('node:https');
             const response = await new Promise((resolve, reject) => {
                 https.get(`${apiServer}/api/v1/namespaces/${namespace}/endpoints/${serviceName}`, {
                     headers: {

package/dist/distributed/readWriteSeparation.d.ts

@@ -2,7 +2,7 @@
  * Read/Write Separation for Distributed Scaling
  * Implements primary-replica architecture for scalable reads
  */
-import { EventEmitter } from 'events';
+import { EventEmitter } from 'node:events';
 import { DistributedCoordinator } from './coordinator.js';
 import { ShardManager } from './shardManager.js';
 import { CacheSync } from './cacheSync.js';

package/dist/distributed/readWriteSeparation.js

@@ -2,7 +2,7 @@
  * Read/Write Separation for Distributed Scaling
  * Implements primary-replica architecture for scalable reads
  */
-import { EventEmitter } from 'events';
+import { EventEmitter } from 'node:events';
 /**
  * Read/Write Separation Manager
  */

package/dist/distributed/shardManager.d.ts

@@ -2,7 +2,7 @@
  * Shard Manager for Horizontal Scaling
  * Implements consistent hashing for data distribution across shards
  */
-import { EventEmitter } from 'events';
+import { EventEmitter } from 'node:events';
 export interface ShardConfig {
     shardCount?: number;
     replicationFactor?: number;

package/dist/distributed/shardManager.js

@@ -2,8 +2,8 @@
  * Shard Manager for Horizontal Scaling
  * Implements consistent hashing for data distribution across shards
  */
-import { createHash } from 'crypto';
-import { EventEmitter } from 'events';
+import { createHash } from 'node:crypto';
+import { EventEmitter } from 'node:events';
 /**
  * Consistent Hash Ring for shard distribution
  */

package/dist/distributed/shardMigration.d.ts

@@ -4,7 +4,7 @@
  * Handles zero-downtime migration of data between nodes
  * Uses streaming for efficient transfer of large datasets
  */
-import { EventEmitter } from 'events';
+import { EventEmitter } from 'node:events';
 import type { StorageAdapter } from '../coreTypes.js';
 import type { ShardManager } from './shardManager.js';
 import type { HTTPTransport } from './httpTransport.js';

package/dist/distributed/shardMigration.js

@@ -4,7 +4,7 @@
  * Handles zero-downtime migration of data between nodes
  * Uses streaming for efficient transfer of large datasets
  */
-import { EventEmitter } from 'events';
+import { EventEmitter } from 'node:events';
 export class ShardMigrationManager extends EventEmitter {
     constructor(nodeId, storage, shardManager, transport, coordinator) {
         super();

package/dist/distributed/storageDiscovery.d.ts

@@ -3,7 +3,7 @@
  * Uses shared storage (S3/GCS/R2) as coordination point
  * REAL PRODUCTION CODE - No mocks, no stubs!
  */
-import { EventEmitter } from 'events';
+import { EventEmitter } from 'node:events';
 import { StorageAdapter } from '../coreTypes.js';
 export interface NodeInfo {
     id: string;

package/dist/distributed/storageDiscovery.js

@@ -3,8 +3,8 @@
  * Uses shared storage (S3/GCS/R2) as coordination point
  * REAL PRODUCTION CODE - No mocks, no stubs!
  */
-import { EventEmitter } from 'events';
-import * as os from 'os';
+import { EventEmitter } from 'node:events';
+import * as os from 'node:os';
 export class StorageDiscovery extends EventEmitter {
     constructor(storage, nodeId) {
         super();

package/dist/embeddings/EmbeddingManager.js

@@ -16,8 +16,8 @@
  * hybridModelManager, universalMemoryManager, and more.
  */
 import { pipeline, env } from '@huggingface/transformers';
-import { existsSync } from 'fs';
-import { join } from 'path';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
 // Global state for true singleton across entire process
 let globalInstance = null;
 let globalInitPromise = null;

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/storage/adapters/fileSystemStorage.js

@@ -11,8 +11,8 @@ let moduleLoadingPromise = null;
 // Try to load Node.js modules
 try {
     // Using dynamic imports to avoid issues in browser environments
-    const fsPromise = import('fs');
-    const pathPromise = import('path');
+    const fsPromise = import('node:fs');
+    const pathPromise = import('node:path');
     moduleLoadingPromise = Promise.all([fsPromise, pathPromise])
         .then(([fsModule, pathModule]) => {
         fs = fsModule;

package/dist/storage/cacheManager.js

@@ -279,7 +279,7 @@ export class CacheManager {
             if (this.environment === Environment.NODE) {
                 try {
                     // Use dynamic import for OS module
-                    const os = await import('os');
+                    const os = await import('node:os');
                     // Get actual system memory information
                     const totalMemory = os.totalmem();
                     const freeMemory = os.freemem();

package/dist/storage/enhancedClearOperations.js

@@ -139,7 +139,7 @@ export class EnhancedFileSystemClear {
         const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
         const backupDir = `${this.rootDir}-backup-${timestamp}`;
         // Use cp -r for efficient directory copying
-        const { spawn } = await import('child_process');
+        const { spawn } = await import('node:child_process');
         return new Promise((resolve, reject) => {
             const cp = spawn('cp', ['-r', this.rootDir, backupDir]);
             cp.on('close', (code) => {

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/dist/universal/crypto.js

@@ -8,7 +8,8 @@ let nodeCrypto = null;
 // Dynamic import for Node.js crypto (only in Node.js environment)
 if (isNode()) {
     try {
-        nodeCrypto = await import('crypto');
+        // Use node: protocol to prevent bundler polyfilling (requires Node 22+)
+        nodeCrypto = await import('node:crypto');
     }
     catch {
         // Ignore import errors in non-Node environments

package/dist/universal/events.js

@@ -8,7 +8,7 @@ let nodeEvents = null;
 // Dynamic import for Node.js events (only in Node.js environment)
 if (isNode()) {
     try {
-        nodeEvents = await import('events');
+        nodeEvents = await import('node:events');
     }
     catch {
         // Ignore import errors in non-Node environments

package/dist/universal/fs.js

@@ -8,7 +8,8 @@ let nodeFs = null;
 // Dynamic import for Node.js fs (only in Node.js environment)
 if (isNode()) {
     try {
-        nodeFs = await import('fs/promises');
+        // Use node: protocol to prevent bundler polyfilling (requires Node 22+)
+        nodeFs = await import('node:fs/promises');
     }
     catch {
         // Ignore import errors in non-Node environments

package/dist/universal/path.js

@@ -8,7 +8,8 @@ let nodePath = null;
 // Dynamic import for Node.js path (only in Node.js environment)
 if (isNode()) {
     try {
-        nodePath = await import('path');
+        // Use node: protocol to prevent bundler polyfilling (requires Node 22+)
+        nodePath = await import('node:path');
     }
     catch {
         // Ignore import errors in non-Node environments

package/dist/utils/adaptiveSocketManager.js

@@ -3,7 +3,7 @@
  * Automatically manages socket pools and connection settings based on load patterns
  * Zero-configuration approach that learns and adapts to workload characteristics
  */
-import { Agent as HttpsAgent } from 'https';
+import { Agent as HttpsAgent } from 'node:https';
 import { NodeHttpHandler } from '@smithy/node-http-handler';
 import { createModuleLogger } from './logger.js';
 /**

package/dist/utils/autoConfiguration.js

@@ -159,7 +159,7 @@ export class AutoConfiguration {
         // Node.js memory detection
         if (isNode()) {
             try {
-                const os = await import('os');
+                const os = await import('node:os');
                 availableMemory = os.totalmem() * 0.7; // Use 70% of total memory
                 cpuCores = os.cpus().length;
             }

package/dist/utils/embedding.js

@@ -3,8 +3,8 @@
  * Complete rewrite to eliminate TensorFlow.js and use ONNX-based models
  */
 import { isBrowser } from './environment.js';
-import { join } from 'path';
-import { existsSync } from 'fs';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
 // @ts-ignore - Transformers.js is now the primary embedding library
 import { pipeline, env } from '@huggingface/transformers';
 // CRITICAL: Disable ONNX memory arena to prevent 4-8GB allocation

package/dist/utils/paramValidation.js

@@ -5,7 +5,7 @@
  * Only enforces universal truths, learns everything else
  */
 import { NounType, VerbType } from '../types/graphTypes.js';
-import * as os from 'os';
+import * as os from 'node:os';
 /**
  * Auto-configured limits based on system resources
  * These adapt to available memory and observed performance

package/dist/utils/structuredLogger.js

@@ -4,8 +4,8 @@
  * performance tracking, and multiple transport support
  */
 import { performance } from 'perf_hooks';
-import { hostname } from 'os';
-import { randomUUID } from 'crypto';
+import { hostname } from 'node:os';
+import { randomUUID } from 'node:crypto';
 export var LogLevel;
 (function (LogLevel) {
     LogLevel[LogLevel["SILENT"] = -1] = "SILENT";

package/dist/utils/version.js

@@ -1,9 +1,9 @@
 /**
  * Version utilities for Brainy
  */
-import { readFileSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
+import { readFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
 // Get package.json path relative to this file
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);

package/package.json

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