@soulcraft/brainy 2.10.1 → 2.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. package/README.md +10 -10
  2. package/dist/augmentations/apiServerAugmentation.js +2 -2
  3. package/dist/augmentations/display/fieldPatterns.d.ts +1 -1
  4. package/dist/augmentations/display/fieldPatterns.js +1 -1
  5. package/dist/augmentations/display/intelligentComputation.d.ts +2 -2
  6. package/dist/augmentations/display/intelligentComputation.js +4 -4
  7. package/dist/augmentations/display/types.d.ts +1 -1
  8. package/dist/augmentations/neuralImport.js +4 -4
  9. package/dist/augmentations/synapseAugmentation.js +3 -3
  10. package/dist/augmentations/typeMatching/brainyTypes.d.ts +83 -0
  11. package/dist/augmentations/typeMatching/brainyTypes.js +425 -0
  12. package/dist/augmentations/universalDisplayAugmentation.d.ts +1 -1
  13. package/dist/augmentations/universalDisplayAugmentation.js +1 -1
  14. package/dist/brainyData.d.ts +20 -41
  15. package/dist/brainyData.js +1467 -1430
  16. package/dist/chat/BrainyChat.js +11 -11
  17. package/dist/examples/basicUsage.js +4 -1
  18. package/dist/importManager.js +2 -2
  19. package/dist/index.d.ts +3 -1
  20. package/dist/index.js +5 -1
  21. package/dist/neural/embeddedPatterns.d.ts +1 -1
  22. package/dist/neural/embeddedPatterns.js +2 -2
  23. package/dist/neural/improvedNeuralAPI.d.ts +346 -0
  24. package/dist/neural/improvedNeuralAPI.js +2439 -0
  25. package/dist/neural/types.d.ts +267 -0
  26. package/dist/neural/types.js +24 -0
  27. package/dist/storage/adapters/fileSystemStorage.d.ts +2 -2
  28. package/dist/storage/adapters/fileSystemStorage.js +2 -2
  29. package/dist/storage/adapters/memoryStorage.d.ts +4 -4
  30. package/dist/storage/adapters/memoryStorage.js +4 -4
  31. package/dist/storage/adapters/opfsStorage.d.ts +2 -2
  32. package/dist/storage/adapters/opfsStorage.js +2 -2
  33. package/dist/storage/adapters/s3CompatibleStorage.d.ts +2 -2
  34. package/dist/storage/adapters/s3CompatibleStorage.js +2 -2
  35. package/dist/storage/baseStorage.d.ts +12 -2
  36. package/dist/storage/baseStorage.js +32 -0
  37. package/dist/types/brainyDataInterface.d.ts +2 -5
  38. package/dist/utils/brainyTypes.d.ts +217 -0
  39. package/dist/utils/brainyTypes.js +261 -0
  40. package/dist/utils/typeValidation.d.ts +25 -0
  41. package/dist/utils/typeValidation.js +127 -0
  42. package/package.json +1 -1
@@ -0,0 +1,425 @@
1
+ /**
2
+ * BrainyTypes - Intelligent type detection using semantic embeddings
3
+ *
4
+ * This module uses our existing TransformerEmbedding and similarity functions
5
+ * to intelligently match data to our 31 noun types and 40 verb types.
6
+ *
7
+ * Features:
8
+ * - Semantic similarity matching using embeddings
9
+ * - Context-aware type detection
10
+ * - Confidence scoring
11
+ * - Caching for performance
12
+ */
13
+ import { NounType, VerbType } from '../../types/graphTypes.js';
14
+ import { TransformerEmbedding } from '../../utils/embedding.js';
15
+ import { cosineDistance } from '../../utils/distance.js';
16
+ /**
17
+ * Type descriptions for semantic matching
18
+ * These descriptions are used to generate embeddings for each type
19
+ */
20
+ const NOUN_TYPE_DESCRIPTIONS = {
21
+ // Core Entity Types
22
+ [NounType.Person]: 'person human individual user employee customer citizen member author creator agent actor participant',
23
+ [NounType.Organization]: 'organization company business corporation institution agency department team group committee board',
24
+ [NounType.Location]: 'location place address city country region area zone coordinate position site venue building',
25
+ [NounType.Thing]: 'thing object item product device equipment tool instrument asset artifact material physical tangible',
26
+ [NounType.Concept]: 'concept idea theory principle philosophy belief value abstract intangible notion thought',
27
+ [NounType.Event]: 'event occurrence incident activity happening meeting conference celebration milestone timestamp date',
28
+ // Digital/Content Types
29
+ [NounType.Document]: 'document file report article paper text pdf word contract agreement record documentation',
30
+ [NounType.Media]: 'media image photo video audio music podcast multimedia graphic visualization animation',
31
+ [NounType.File]: 'file digital data binary code script program software archive package bundle',
32
+ [NounType.Message]: 'message email chat communication notification alert announcement broadcast transmission',
33
+ [NounType.Content]: 'content information data text material resource publication post blog webpage',
34
+ // Collection Types
35
+ [NounType.Collection]: 'collection group set list array category folder directory catalog inventory database',
36
+ [NounType.Dataset]: 'dataset data table spreadsheet database records statistics metrics measurements analysis',
37
+ // Business/Application Types
38
+ [NounType.Product]: 'product item merchandise offering service feature application software solution package',
39
+ [NounType.Service]: 'service offering subscription support maintenance utility function capability',
40
+ [NounType.User]: 'user account profile member subscriber customer client participant identity credentials',
41
+ [NounType.Task]: 'task action todo item job assignment duty responsibility activity step procedure',
42
+ [NounType.Project]: 'project initiative program campaign effort endeavor plan scheme venture undertaking',
43
+ // Descriptive Types
44
+ [NounType.Process]: 'process workflow procedure method algorithm sequence pipeline operation routine protocol',
45
+ [NounType.State]: 'state status condition phase stage mode situation circumstance configuration setting',
46
+ [NounType.Role]: 'role position title function responsibility duty job capacity designation authority',
47
+ [NounType.Topic]: 'topic subject theme category tag keyword area domain field discipline specialty',
48
+ [NounType.Language]: 'language dialect locale tongue vernacular communication speech linguistics vocabulary',
49
+ [NounType.Currency]: 'currency money dollar euro pound yen bitcoin payment financial monetary unit',
50
+ [NounType.Measurement]: 'measurement metric quantity value amount size dimension weight height volume distance',
51
+ // Scientific/Research Types
52
+ [NounType.Hypothesis]: 'hypothesis theory proposition thesis assumption premise conjecture speculation prediction',
53
+ [NounType.Experiment]: 'experiment test trial study research investigation analysis observation examination',
54
+ // Legal/Regulatory Types
55
+ [NounType.Contract]: 'contract agreement deal treaty pact covenant license terms conditions policy',
56
+ [NounType.Regulation]: 'regulation law rule policy standard compliance requirement guideline ordinance statute',
57
+ // Technical Infrastructure Types
58
+ [NounType.Interface]: 'interface API endpoint protocol specification contract schema definition connection',
59
+ [NounType.Resource]: 'resource infrastructure server database storage compute memory bandwidth capacity asset'
60
+ };
61
+ const VERB_TYPE_DESCRIPTIONS = {
62
+ // Core Relationship Types
63
+ [VerbType.RelatedTo]: 'related connected associated linked correlated relevant pertinent applicable',
64
+ [VerbType.Contains]: 'contains includes holds stores encompasses comprises consists incorporates',
65
+ [VerbType.PartOf]: 'part component element member piece portion section segment constituent',
66
+ [VerbType.LocatedAt]: 'located situated positioned placed found exists resides occupies',
67
+ [VerbType.References]: 'references cites mentions points links refers quotes sources',
68
+ // Temporal/Causal Types
69
+ [VerbType.Precedes]: 'precedes before earlier prior previous antecedent preliminary foregoing',
70
+ [VerbType.Succeeds]: 'succeeds follows after later subsequent next ensuing succeeding',
71
+ [VerbType.Causes]: 'causes triggers induces produces generates results influences affects',
72
+ [VerbType.DependsOn]: 'depends requires needs relies necessitates contingent prerequisite',
73
+ [VerbType.Requires]: 'requires needs demands necessitates mandates obliges compels entails',
74
+ // Creation/Transformation Types
75
+ [VerbType.Creates]: 'creates makes produces generates builds constructs forms establishes',
76
+ [VerbType.Transforms]: 'transforms converts changes modifies alters transitions morphs evolves',
77
+ [VerbType.Becomes]: 'becomes turns evolves transforms changes transitions develops grows',
78
+ [VerbType.Modifies]: 'modifies changes updates alters edits revises adjusts adapts',
79
+ [VerbType.Consumes]: 'consumes uses utilizes depletes expends absorbs takes processes',
80
+ // Ownership/Attribution Types
81
+ [VerbType.Owns]: 'owns possesses holds controls manages administers governs maintains',
82
+ [VerbType.AttributedTo]: 'attributed credited assigned ascribed authored written composed',
83
+ [VerbType.CreatedBy]: 'created made produced generated built developed authored written',
84
+ [VerbType.BelongsTo]: 'belongs property possession part member affiliate associated owned',
85
+ // Social/Organizational Types
86
+ [VerbType.MemberOf]: 'member participant affiliate associate belongs joined enrolled registered',
87
+ [VerbType.WorksWith]: 'works collaborates cooperates partners teams assists helps supports',
88
+ [VerbType.FriendOf]: 'friend companion buddy pal acquaintance associate connection relationship',
89
+ [VerbType.Follows]: 'follows subscribes tracks monitors watches observes trails pursues',
90
+ [VerbType.Likes]: 'likes enjoys appreciates favors prefers admires values endorses',
91
+ [VerbType.ReportsTo]: 'reports answers subordinate accountable responsible supervised managed',
92
+ [VerbType.Supervises]: 'supervises manages oversees directs leads controls guides administers',
93
+ [VerbType.Mentors]: 'mentors teaches guides coaches instructs trains advises counsels',
94
+ [VerbType.Communicates]: 'communicates talks speaks messages contacts interacts corresponds exchanges',
95
+ // Descriptive/Functional Types
96
+ [VerbType.Describes]: 'describes explains details documents specifies outlines depicts characterizes',
97
+ [VerbType.Defines]: 'defines specifies establishes determines sets declares identifies designates',
98
+ [VerbType.Categorizes]: 'categorizes classifies groups sorts organizes arranges labels tags',
99
+ [VerbType.Measures]: 'measures quantifies gauges assesses evaluates calculates determines counts',
100
+ [VerbType.Evaluates]: 'evaluates assesses analyzes reviews examines appraises judges rates',
101
+ [VerbType.Uses]: 'uses utilizes employs applies operates handles manipulates exploits',
102
+ [VerbType.Implements]: 'implements executes realizes performs accomplishes carries delivers completes',
103
+ [VerbType.Extends]: 'extends expands enhances augments amplifies broadens enlarges develops',
104
+ // Enhanced Relationships
105
+ [VerbType.Inherits]: 'inherits derives extends receives obtains acquires succeeds legacy',
106
+ [VerbType.Conflicts]: 'conflicts contradicts opposes clashes disputes disagrees incompatible inconsistent',
107
+ [VerbType.Synchronizes]: 'synchronizes coordinates aligns harmonizes matches corresponds parallels coincides',
108
+ [VerbType.Competes]: 'competes rivals contends contests challenges opposes vies struggles'
109
+ };
110
+ /**
111
+ * BrainyTypes - Intelligent type detection for nouns and verbs
112
+ */
113
+ export class BrainyTypes {
114
+ constructor() {
115
+ this.nounEmbeddings = new Map();
116
+ this.verbEmbeddings = new Map();
117
+ this.initialized = false;
118
+ this.cache = new Map();
119
+ this.embedder = new TransformerEmbedding({ verbose: false });
120
+ }
121
+ /**
122
+ * Initialize the type matcher by generating embeddings for all types
123
+ */
124
+ async init() {
125
+ if (this.initialized)
126
+ return;
127
+ await this.embedder.init();
128
+ // Generate embeddings for noun types
129
+ for (const [type, description] of Object.entries(NOUN_TYPE_DESCRIPTIONS)) {
130
+ const embedding = await this.embedder.embed(description);
131
+ this.nounEmbeddings.set(type, embedding);
132
+ }
133
+ // Generate embeddings for verb types
134
+ for (const [type, description] of Object.entries(VERB_TYPE_DESCRIPTIONS)) {
135
+ const embedding = await this.embedder.embed(description);
136
+ this.verbEmbeddings.set(type, embedding);
137
+ }
138
+ this.initialized = true;
139
+ }
140
+ /**
141
+ * Match an object to the most appropriate noun type
142
+ */
143
+ async matchNounType(obj) {
144
+ await this.init();
145
+ // Create a text representation of the object for embedding
146
+ const textRepresentation = this.createTextRepresentation(obj);
147
+ // Check cache
148
+ const cacheKey = `noun:${textRepresentation}`;
149
+ if (this.cache.has(cacheKey)) {
150
+ return this.cache.get(cacheKey);
151
+ }
152
+ // Generate embedding for the input
153
+ const inputEmbedding = await this.embedder.embed(textRepresentation);
154
+ // Calculate similarities to all noun types
155
+ const similarities = [];
156
+ for (const [type, typeEmbedding] of this.nounEmbeddings.entries()) {
157
+ // Convert cosine distance to similarity (1 - distance)
158
+ const similarity = 1 - cosineDistance(inputEmbedding, typeEmbedding);
159
+ similarities.push({ type, similarity });
160
+ }
161
+ // Sort by similarity (highest first)
162
+ similarities.sort((a, b) => b.similarity - a.similarity);
163
+ // Apply heuristic rules for common patterns
164
+ const heuristicType = this.applyNounHeuristics(obj);
165
+ if (heuristicType) {
166
+ // Boost the heuristic type's confidence
167
+ const heuristicIndex = similarities.findIndex(s => s.type === heuristicType);
168
+ if (heuristicIndex > 0) {
169
+ similarities[heuristicIndex].similarity *= 1.2; // 20% boost
170
+ similarities.sort((a, b) => b.similarity - a.similarity);
171
+ }
172
+ }
173
+ // Create result
174
+ const result = {
175
+ type: similarities[0].type,
176
+ confidence: similarities[0].similarity,
177
+ reasoning: this.generateReasoning(obj, similarities[0].type, 'noun'),
178
+ alternatives: similarities.slice(1, 4).map(s => ({
179
+ type: s.type,
180
+ confidence: s.similarity
181
+ }))
182
+ };
183
+ // Cache result
184
+ this.cache.set(cacheKey, result);
185
+ return result;
186
+ }
187
+ /**
188
+ * Match a relationship to the most appropriate verb type
189
+ */
190
+ async matchVerbType(sourceObj, targetObj, relationshipHint) {
191
+ await this.init();
192
+ // Create text representation of the relationship
193
+ const textRepresentation = this.createRelationshipText(sourceObj, targetObj, relationshipHint);
194
+ // Check cache
195
+ const cacheKey = `verb:${textRepresentation}`;
196
+ if (this.cache.has(cacheKey)) {
197
+ return this.cache.get(cacheKey);
198
+ }
199
+ // Generate embedding
200
+ const inputEmbedding = await this.embedder.embed(textRepresentation);
201
+ // Calculate similarities to all verb types
202
+ const similarities = [];
203
+ for (const [type, typeEmbedding] of this.verbEmbeddings.entries()) {
204
+ const similarity = 1 - cosineDistance(inputEmbedding, typeEmbedding);
205
+ similarities.push({ type, similarity });
206
+ }
207
+ // Sort by similarity
208
+ similarities.sort((a, b) => b.similarity - a.similarity);
209
+ // Apply heuristic rules
210
+ const heuristicType = this.applyVerbHeuristics(sourceObj, targetObj, relationshipHint);
211
+ if (heuristicType) {
212
+ const heuristicIndex = similarities.findIndex(s => s.type === heuristicType);
213
+ if (heuristicIndex > 0) {
214
+ similarities[heuristicIndex].similarity *= 1.2;
215
+ similarities.sort((a, b) => b.similarity - a.similarity);
216
+ }
217
+ }
218
+ // Create result
219
+ const result = {
220
+ type: similarities[0].type,
221
+ confidence: similarities[0].similarity,
222
+ reasoning: this.generateReasoning({ source: sourceObj, target: targetObj, hint: relationshipHint }, similarities[0].type, 'verb'),
223
+ alternatives: similarities.slice(1, 4).map(s => ({
224
+ type: s.type,
225
+ confidence: s.similarity
226
+ }))
227
+ };
228
+ // Cache result
229
+ this.cache.set(cacheKey, result);
230
+ return result;
231
+ }
232
+ /**
233
+ * Create text representation of an object for embedding
234
+ */
235
+ createTextRepresentation(obj) {
236
+ const parts = [];
237
+ // Add type if available
238
+ if (typeof obj === 'object' && obj !== null) {
239
+ // Add field names and values
240
+ for (const [key, value] of Object.entries(obj)) {
241
+ parts.push(key);
242
+ if (typeof value === 'string') {
243
+ parts.push(value.slice(0, 100)); // Limit string length
244
+ }
245
+ else if (typeof value === 'number' || typeof value === 'boolean') {
246
+ parts.push(String(value));
247
+ }
248
+ }
249
+ // Add special fields with higher weight
250
+ const importantFields = ['type', 'kind', 'category', 'class', 'name', 'title', 'description'];
251
+ for (const field of importantFields) {
252
+ if (obj[field]) {
253
+ parts.push(String(obj[field]));
254
+ parts.push(String(obj[field])); // Double weight for important fields
255
+ }
256
+ }
257
+ }
258
+ else if (typeof obj === 'string') {
259
+ parts.push(obj);
260
+ }
261
+ else {
262
+ parts.push(String(obj));
263
+ }
264
+ return parts.join(' ');
265
+ }
266
+ /**
267
+ * Create text representation of a relationship
268
+ */
269
+ createRelationshipText(sourceObj, targetObj, relationshipHint) {
270
+ const parts = [];
271
+ if (relationshipHint) {
272
+ parts.push(relationshipHint);
273
+ parts.push(relationshipHint); // Double weight for explicit hint
274
+ }
275
+ // Add source context
276
+ if (sourceObj) {
277
+ parts.push('source:');
278
+ parts.push(this.getObjectSummary(sourceObj));
279
+ }
280
+ // Add target context
281
+ if (targetObj) {
282
+ parts.push('target:');
283
+ parts.push(this.getObjectSummary(targetObj));
284
+ }
285
+ return parts.join(' ');
286
+ }
287
+ /**
288
+ * Get a brief summary of an object
289
+ */
290
+ getObjectSummary(obj) {
291
+ if (typeof obj === 'string')
292
+ return obj.slice(0, 50);
293
+ if (typeof obj !== 'object' || obj === null)
294
+ return String(obj);
295
+ const summary = [];
296
+ const fields = ['type', 'name', 'title', 'id', 'category', 'kind'];
297
+ for (const field of fields) {
298
+ if (obj[field]) {
299
+ summary.push(String(obj[field]));
300
+ }
301
+ }
302
+ return summary.join(' ').slice(0, 100);
303
+ }
304
+ /**
305
+ * Apply heuristic rules for noun type detection
306
+ */
307
+ applyNounHeuristics(obj) {
308
+ if (typeof obj !== 'object' || obj === null)
309
+ return null;
310
+ // Person heuristics
311
+ if (obj.email || obj.firstName || obj.lastName || obj.username || obj.age || obj.gender) {
312
+ return NounType.Person;
313
+ }
314
+ // Organization heuristics
315
+ if (obj.companyName || obj.organizationId || obj.employees || obj.industry) {
316
+ return NounType.Organization;
317
+ }
318
+ // Location heuristics
319
+ if (obj.latitude || obj.longitude || obj.address || obj.city || obj.country || obj.coordinates) {
320
+ return NounType.Location;
321
+ }
322
+ // Document heuristics
323
+ if (obj.content && (obj.title || obj.author) || obj.documentType || obj.pages) {
324
+ return NounType.Document;
325
+ }
326
+ // Event heuristics
327
+ if (obj.startTime || obj.endTime || obj.date || obj.eventType || obj.attendees) {
328
+ return NounType.Event;
329
+ }
330
+ // Product heuristics
331
+ if (obj.price || obj.sku || obj.inventory || obj.productId) {
332
+ return NounType.Product;
333
+ }
334
+ // Task heuristics
335
+ if (obj.status && (obj.assignee || obj.dueDate) || obj.priority || obj.completed !== undefined) {
336
+ return NounType.Task;
337
+ }
338
+ // Media heuristics
339
+ if (obj.url && (obj.url.match(/\.(jpg|jpeg|png|gif|mp4|mp3|wav)/i))) {
340
+ return NounType.Media;
341
+ }
342
+ // Dataset heuristics
343
+ if (Array.isArray(obj.data) || obj.rows || obj.columns || obj.schema) {
344
+ return NounType.Dataset;
345
+ }
346
+ return null;
347
+ }
348
+ /**
349
+ * Apply heuristic rules for verb type detection
350
+ */
351
+ applyVerbHeuristics(sourceObj, targetObj, relationshipHint) {
352
+ if (!relationshipHint)
353
+ return null;
354
+ const hint = relationshipHint.toLowerCase();
355
+ // Ownership patterns
356
+ if (hint.includes('own') || hint.includes('possess') || hint.includes('has')) {
357
+ return VerbType.Owns;
358
+ }
359
+ // Creation patterns
360
+ if (hint.includes('create') || hint.includes('made') || hint.includes('authored')) {
361
+ return VerbType.Creates;
362
+ }
363
+ // Containment patterns
364
+ if (hint.includes('contain') || hint.includes('include') || hint.includes('has')) {
365
+ return VerbType.Contains;
366
+ }
367
+ // Membership patterns
368
+ if (hint.includes('member') || hint.includes('belong') || hint.includes('part')) {
369
+ return VerbType.MemberOf;
370
+ }
371
+ // Reference patterns
372
+ if (hint.includes('refer') || hint.includes('cite') || hint.includes('link')) {
373
+ return VerbType.References;
374
+ }
375
+ // Dependency patterns
376
+ if (hint.includes('depend') || hint.includes('require') || hint.includes('need')) {
377
+ return VerbType.DependsOn;
378
+ }
379
+ return null;
380
+ }
381
+ /**
382
+ * Generate human-readable reasoning for the type selection
383
+ */
384
+ generateReasoning(obj, selectedType, typeKind) {
385
+ const descriptions = typeKind === 'noun' ? NOUN_TYPE_DESCRIPTIONS : VERB_TYPE_DESCRIPTIONS;
386
+ const typeDesc = descriptions[selectedType];
387
+ if (typeKind === 'noun') {
388
+ const fields = Object.keys(obj).slice(0, 3).join(', ');
389
+ return `Matched to ${selectedType} based on semantic similarity to "${typeDesc.split(' ').slice(0, 5).join(' ')}..." and object fields: ${fields}`;
390
+ }
391
+ else {
392
+ return `Matched to ${selectedType} based on semantic similarity to "${typeDesc.split(' ').slice(0, 5).join(' ')}..." and relationship context`;
393
+ }
394
+ }
395
+ /**
396
+ * Clear the cache
397
+ */
398
+ clearCache() {
399
+ this.cache.clear();
400
+ }
401
+ /**
402
+ * Dispose of resources
403
+ */
404
+ async dispose() {
405
+ await this.embedder.dispose();
406
+ this.cache.clear();
407
+ this.nounEmbeddings.clear();
408
+ this.verbEmbeddings.clear();
409
+ }
410
+ }
411
+ /**
412
+ * Singleton instance for efficient reuse
413
+ */
414
+ let globalInstance = null;
415
+ /**
416
+ * Get or create the global BrainyTypes instance
417
+ */
418
+ export async function getBrainyTypes() {
419
+ if (!globalInstance) {
420
+ globalInstance = new BrainyTypes();
421
+ await globalInstance.init();
422
+ }
423
+ return globalInstance;
424
+ }
425
+ //# sourceMappingURL=brainyTypes.js.map
@@ -4,7 +4,7 @@
4
4
  * 🎨 Provides intelligent display fields for any noun or verb using AI-powered analysis
5
5
  *
6
6
  * Features:
7
- * - ✅ Leverages existing IntelligentTypeMatcher for semantic type detection
7
+ * - ✅ Leverages existing BrainyTypes for semantic type detection
8
8
  * - ✅ Complete icon coverage for all 31 NounTypes + 40+ VerbTypes
9
9
  * - ✅ Zero performance impact with lazy computation and intelligent caching
10
10
  * - ✅ Perfect isolation - can be disabled, replaced, or configured
@@ -4,7 +4,7 @@
4
4
  * 🎨 Provides intelligent display fields for any noun or verb using AI-powered analysis
5
5
  *
6
6
  * Features:
7
- * - ✅ Leverages existing IntelligentTypeMatcher for semantic type detection
7
+ * - ✅ Leverages existing BrainyTypes for semantic type detection
8
8
  * - ✅ Complete icon coverage for all 31 NounTypes + 40+ VerbTypes
9
9
  * - ✅ Zero performance impact with lazy computation and intelligent caching
10
10
  * - ✅ Perfect isolation - can be disabled, replaced, or configured
@@ -12,6 +12,7 @@ import { WebSocketConnection } from './types/augmentations.js';
12
12
  import { BrainyDataInterface } from './types/brainyDataInterface.js';
13
13
  import { DistributedConfig } from './types/distributedTypes.js';
14
14
  import { SearchCacheConfig } from './utils/searchCache.js';
15
+ import { ImprovedNeuralAPI } from './neural/improvedNeuralAPI.js';
15
16
  import { TripleQuery, TripleResult } from './triple/TripleIntelligence.js';
16
17
  export interface BrainyDataConfig {
17
18
  /**
@@ -623,33 +624,6 @@ export declare class BrainyData<T = any> implements BrainyDataInterface<T> {
623
624
  * @returns The connection object
624
625
  */
625
626
  connectToRemoteServer(serverUrl: string, protocols?: string | string[]): Promise<WebSocketConnection>;
626
- /**
627
- * Add data to the database with intelligent processing
628
- *
629
- * @param vectorOrData Vector or data to add
630
- * @param metadata Optional metadata to associate with the data
631
- * @param options Additional options for processing
632
- * @returns The ID of the added data
633
- *
634
- * @example
635
- * // Auto mode - intelligently decides processing
636
- * await brainy.add("Customer feedback: Great product!")
637
- *
638
- * @example
639
- * // Explicit literal mode for sensitive data
640
- * await brainy.add("API_KEY=secret123", null, { process: 'literal' })
641
- *
642
- * @example
643
- * // Force neural processing
644
- * await brainy.add("John works at Acme Corp", null, { process: 'neural' })
645
- */
646
- add(vectorOrData: Vector | any, metadata?: T, options?: {
647
- forceEmbed?: boolean;
648
- addToRemote?: boolean;
649
- id?: string;
650
- service?: string;
651
- process?: 'auto' | 'literal' | 'neural';
652
- }): Promise<string>;
653
627
  /**
654
628
  * Add a vector to the remote server
655
629
  * @param id ID of the vector to add
@@ -666,13 +640,14 @@ export declare class BrainyData<T = any> implements BrainyDataInterface<T> {
666
640
  * @returns Array of IDs for the added items
667
641
  */
668
642
  /**
669
- * Add multiple nouns in batch
670
- * @param items Array of nouns to add
643
+ * Add multiple nouns in batch with required types
644
+ * @param items Array of nouns to add (all must have types)
671
645
  * @param options Batch processing options
672
646
  * @returns Array of generated IDs
673
647
  */
674
648
  addNouns(items: Array<{
675
649
  vectorOrData: Vector | any;
650
+ nounType: NounType | string;
676
651
  metadata?: T;
677
652
  }>, options?: {
678
653
  forceEmbed?: boolean;
@@ -682,12 +657,13 @@ export declare class BrainyData<T = any> implements BrainyDataInterface<T> {
682
657
  }): Promise<string[]>;
683
658
  /**
684
659
  * Add multiple vectors or data items to both local and remote databases
685
- * @param items Array of items to add
660
+ * @param items Array of items to add (with required types)
686
661
  * @param options Additional options
687
662
  * @returns Array of IDs for the added items
688
663
  */
689
664
  addBatchToBoth(items: Array<{
690
665
  vectorOrData: Vector | any;
666
+ nounType: NounType | string;
691
667
  metadata?: T;
692
668
  }>, options?: {
693
669
  forceEmbed?: boolean;
@@ -1529,14 +1505,21 @@ export declare class BrainyData<T = any> implements BrainyDataInterface<T> {
1529
1505
  * @returns Created noun ID
1530
1506
  */
1531
1507
  /**
1532
- * Add a noun to the database
1508
+ * Add a noun to the database with required type
1533
1509
  * Clean 2.0 API - primary method for adding data
1534
1510
  *
1535
1511
  * @param vectorOrData Vector array or data to embed
1536
- * @param metadata Metadata to store with the noun
1512
+ * @param nounType Required noun type (one of 31 types)
1513
+ * @param metadata Optional metadata object
1537
1514
  * @returns The generated ID
1538
1515
  */
1539
- addNoun(vectorOrData: Vector | any, metadata?: T): Promise<string>;
1516
+ addNoun(vectorOrData: Vector | any, nounType: NounType | string, metadata?: T, options?: {
1517
+ forceEmbed?: boolean;
1518
+ addToRemote?: boolean;
1519
+ id?: string;
1520
+ service?: string;
1521
+ process?: 'auto' | 'literal' | 'neural';
1522
+ }): Promise<string>;
1540
1523
  /**
1541
1524
  * Add Verb - Unified relationship creation between nouns
1542
1525
  * Creates typed relationships with proper vector embeddings from metadata
@@ -1705,23 +1688,19 @@ export declare class BrainyData<T = any> implements BrainyDataInterface<T> {
1705
1688
  * - brain.neural.clusterStream() - Progressive streaming
1706
1689
  * - brain.neural.getLOD() - Level-of-detail for scale
1707
1690
  */
1708
- get neural(): any;
1691
+ get neural(): ImprovedNeuralAPI;
1709
1692
  /**
1710
1693
  * Simple similarity check (shorthand for neural.similar)
1711
1694
  */
1712
- similar(a: any, b: any): Promise<number>;
1695
+ similar(a: any, b: any, options?: any): Promise<number>;
1713
1696
  /**
1714
1697
  * Get semantic clusters (shorthand for neural.clusters)
1715
1698
  */
1716
- clusters(options?: any): Promise<any[]>;
1699
+ clusters(items?: any, options?: any): Promise<any[]>;
1717
1700
  /**
1718
1701
  * Get related items (shorthand for neural.neighbors)
1719
1702
  */
1720
- related(id: string, limit?: number): Promise<any[]>;
1721
- /**
1722
- * Get visualization data (shorthand for neural.visualize)
1723
- */
1724
- visualize(options?: any): Promise<any>;
1703
+ related(id: string, options?: any): Promise<any[]>;
1725
1704
  /**
1726
1705
  * 🚀 TRIPLE INTELLIGENCE SEARCH - Natural Language & Complex Queries
1727
1706
  * The revolutionary search that combines vector, graph, and metadata intelligence!