@monoes/memory 1.0.19 → 1.0.21

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 (73) hide show
  1. package/dist/hnsw-distance.d.ts +31 -0
  2. package/dist/hnsw-distance.d.ts.map +1 -0
  3. package/dist/hnsw-distance.js +106 -0
  4. package/dist/hnsw-distance.js.map +1 -0
  5. package/dist/hnsw-graph-ops.d.ts +29 -0
  6. package/dist/hnsw-graph-ops.d.ts.map +1 -0
  7. package/dist/hnsw-graph-ops.js +96 -0
  8. package/dist/hnsw-graph-ops.js.map +1 -0
  9. package/dist/hnsw-heap.d.ts +45 -0
  10. package/dist/hnsw-heap.d.ts.map +1 -0
  11. package/dist/hnsw-heap.js +155 -0
  12. package/dist/hnsw-heap.js.map +1 -0
  13. package/dist/hnsw-index.d.ts +18 -43
  14. package/dist/hnsw-index.d.ts.map +1 -1
  15. package/dist/hnsw-index.js +21 -463
  16. package/dist/hnsw-index.js.map +1 -1
  17. package/dist/hnsw-quantizer.d.ts +28 -0
  18. package/dist/hnsw-quantizer.d.ts.map +1 -0
  19. package/dist/hnsw-quantizer.js +100 -0
  20. package/dist/hnsw-quantizer.js.map +1 -0
  21. package/dist/hnsw-serialize.d.ts +39 -0
  22. package/dist/hnsw-serialize.d.ts.map +1 -0
  23. package/dist/hnsw-serialize.js +54 -0
  24. package/dist/hnsw-serialize.js.map +1 -0
  25. package/dist/migration-loaders.d.ts +38 -0
  26. package/dist/migration-loaders.d.ts.map +1 -0
  27. package/dist/migration-loaders.js +269 -0
  28. package/dist/migration-loaders.js.map +1 -0
  29. package/dist/migration-transform.d.ts +21 -0
  30. package/dist/migration-transform.d.ts.map +1 -0
  31. package/dist/migration-transform.js +124 -0
  32. package/dist/migration-transform.js.map +1 -0
  33. package/dist/migration.d.ts +38 -22
  34. package/dist/migration.d.ts.map +1 -1
  35. package/dist/migration.js +35 -348
  36. package/dist/migration.js.map +1 -1
  37. package/dist/sql-backend-ann.d.ts +46 -0
  38. package/dist/sql-backend-ann.d.ts.map +1 -0
  39. package/dist/sql-backend-ann.js +120 -0
  40. package/dist/sql-backend-ann.js.map +1 -0
  41. package/dist/sql-backend-introspect.d.ts +17 -0
  42. package/dist/sql-backend-introspect.d.ts.map +1 -0
  43. package/dist/sql-backend-introspect.js +114 -0
  44. package/dist/sql-backend-introspect.js.map +1 -0
  45. package/dist/sql-backend-reads.d.ts +53 -0
  46. package/dist/sql-backend-reads.d.ts.map +1 -0
  47. package/dist/sql-backend-reads.js +295 -0
  48. package/dist/sql-backend-reads.js.map +1 -0
  49. package/dist/sql-backend-writes.d.ts +64 -0
  50. package/dist/sql-backend-writes.d.ts.map +1 -0
  51. package/dist/sql-backend-writes.js +270 -0
  52. package/dist/sql-backend-writes.js.map +1 -0
  53. package/dist/sql-backend.d.ts +39 -96
  54. package/dist/sql-backend.d.ts.map +1 -1
  55. package/dist/sql-backend.js +49 -706
  56. package/dist/sql-backend.js.map +1 -1
  57. package/dist/types-backend.d.ts +187 -0
  58. package/dist/types-backend.d.ts.map +1 -0
  59. package/dist/types-backend.js +8 -0
  60. package/dist/types-backend.js.map +1 -0
  61. package/dist/types-core.d.ts +180 -0
  62. package/dist/types-core.d.ts.map +1 -0
  63. package/dist/types-core.js +8 -0
  64. package/dist/types-core.js.map +1 -0
  65. package/dist/types-misc.d.ts +172 -0
  66. package/dist/types-misc.d.ts.map +1 -0
  67. package/dist/types-misc.js +56 -0
  68. package/dist/types-misc.js.map +1 -0
  69. package/dist/types.d.ts +8 -516
  70. package/dist/types.d.ts.map +1 -1
  71. package/dist/types.js +5 -49
  72. package/dist/types.js.map +1 -1
  73. package/package.json +2 -2
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types-misc.d.ts","sourceRoot":"","sources":["../src/types-misc.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,56 @@
1
+ /**
2
+ * V1 Unified Memory Types — migration, events, SONA, and utility types
3
+ * Split out of types.ts (file-size sweep). Pure move.
4
+ *
5
+ * @module v1/memory/types
6
+ */
7
+ /**
8
+ * Generates a unique memory ID
9
+ */
10
+ export function generateMemoryId() {
11
+ const timestamp = Date.now().toString(36);
12
+ const random = Math.random().toString(36).substring(2, 10);
13
+ return `mem_${timestamp}_${random}`;
14
+ }
15
+ /**
16
+ * Creates a default memory entry
17
+ */
18
+ export function createDefaultEntry(input) {
19
+ const now = Date.now();
20
+ return {
21
+ id: generateMemoryId(),
22
+ key: input.key,
23
+ content: input.content,
24
+ type: input.type || 'semantic',
25
+ namespace: input.namespace || 'default',
26
+ tags: input.tags || [],
27
+ metadata: input.metadata || {},
28
+ ownerId: input.ownerId,
29
+ accessLevel: input.accessLevel || 'private',
30
+ createdAt: now,
31
+ updatedAt: now,
32
+ expiresAt: input.expiresAt,
33
+ version: 1,
34
+ references: input.references || [],
35
+ accessCount: 0,
36
+ lastAccessedAt: now,
37
+ };
38
+ }
39
+ /**
40
+ * Performance targets for V1 memory system
41
+ */
42
+ export const PERFORMANCE_TARGETS = {
43
+ /** Maximum vector search time for 100k vectors */
44
+ MAX_SEARCH_TIME_100K: 1, // ms
45
+ /** Maximum write time per entry */
46
+ MAX_WRITE_TIME: 5, // ms
47
+ /** Maximum batch insert time per entry */
48
+ MAX_BATCH_INSERT_TIME: 1, // ms
49
+ /** Target memory reduction from legacy systems */
50
+ MEMORY_REDUCTION_TARGET: 0.5, // 50%
51
+ /** Minimum search improvement over brute force */
52
+ MIN_SEARCH_IMPROVEMENT: 150, // design target, not a measured result
53
+ /** Maximum search improvement over brute force */
54
+ MAX_SEARCH_IMPROVEMENT: 12500, // design target, not a measured result
55
+ };
56
+ //# sourceMappingURL=types-misc.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types-misc.js","sourceRoot":"","sources":["../src/types-misc.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+LH;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3D,OAAO,OAAO,SAAS,IAAI,MAAM,EAAE,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAuB;IACxD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,OAAO;QACL,EAAE,EAAE,gBAAgB,EAAE;QACtB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,UAAU;QAC9B,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,SAAS;QACvC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;QACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;QAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,SAAS;QAC3C,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,EAAE;QAClC,WAAW,EAAE,CAAC;QACd,cAAc,EAAE,GAAG;KACpB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,kDAAkD;IAClD,oBAAoB,EAAE,CAAC,EAAE,KAAK;IAE9B,mCAAmC;IACnC,cAAc,EAAE,CAAC,EAAE,KAAK;IAExB,0CAA0C;IAC1C,qBAAqB,EAAE,CAAC,EAAE,KAAK;IAE/B,kDAAkD;IAClD,uBAAuB,EAAE,GAAG,EAAE,MAAM;IAEpC,kDAAkD;IAClD,sBAAsB,EAAE,GAAG,EAAE,uCAAuC;IAEpE,kDAAkD;IAClD,sBAAsB,EAAE,KAAK,EAAE,uCAAuC;CAC9D,CAAC"}
package/dist/types.d.ts CHANGED
@@ -7,522 +7,14 @@
7
7
  * standalone pure-JS HNSWIndex exists for ANN search but isn't wired into
8
8
  * the default search path (see the honesty review's HNSW growth plan).
9
9
  *
10
+ * File-size sweep: split into sibling modules (types-core.ts, types-backend.ts,
11
+ * types-misc.ts). This file remains the entry point and re-exports everything
12
+ * that used to live here so every existing import keeps working.
13
+ *
10
14
  * @module v1/memory/types
11
15
  */
12
- /**
13
- * Memory entry type classification
14
- */
15
- export type MemoryType = 'episodic' | 'semantic' | 'working' | 'cache';
16
- /** Which memory tier this entry belongs to */
17
- export type MemoryTier = 'short-term' | 'long-term' | 'entity' | 'contextual';
18
- /**
19
- * Access level for memory entries
20
- */
21
- export type AccessLevel = 'private' | 'team' | 'monoswarm' | 'public' | 'system';
22
- /**
23
- * Consistency level for distributed memory operations
24
- */
25
- export type ConsistencyLevel = 'strong' | 'eventual' | 'session' | 'weak';
26
- /**
27
- * Distance metrics for vector similarity search
28
- */
29
- export type DistanceMetric = 'cosine' | 'euclidean' | 'dot' | 'manhattan';
30
- /**
31
- * Core memory entry structure with vector embedding support
32
- */
33
- export interface MemoryEntry {
34
- /** Unique identifier */
35
- id: string;
36
- /** Human-readable key for retrieval */
37
- key: string;
38
- /** Actual content of the memory */
39
- content: string;
40
- /** Vector embedding for semantic search (Float32Array for efficiency) */
41
- embedding?: Float32Array;
42
- /** Type of memory */
43
- type: MemoryType;
44
- /** Namespace for organization */
45
- namespace: string;
46
- /** Tags for categorization and filtering */
47
- tags: string[];
48
- /** Additional metadata */
49
- metadata: Record<string, unknown>;
50
- /** Owner agent ID */
51
- ownerId?: string;
52
- /** Access level */
53
- accessLevel: AccessLevel;
54
- /** Creation timestamp */
55
- createdAt: number;
56
- /** Last update timestamp */
57
- updatedAt: number;
58
- /** Expiration timestamp (optional) */
59
- expiresAt?: number;
60
- /** Event time — when the event occurred (vs createdAt = ingestion time).
61
- * Bi-temporal model: separates T (event) from T' (record).
62
- * Source: https://arxiv.org/abs/2501.13956 (Zep/Graphiti) */
63
- eventAt?: number;
64
- /** Version number for optimistic locking */
65
- version: number;
66
- /** References to other memory entries */
67
- references: string[];
68
- /** Access count for usage tracking */
69
- accessCount: number;
70
- /** Importance score for FOREVER forgetting-curve replay (default 1.0) */
71
- importanceScore?: number;
72
- /** Last access timestamp */
73
- lastAccessedAt: number;
74
- }
75
- /**
76
- * Input for creating a new memory entry
77
- */
78
- export interface MemoryEntryInput {
79
- key: string;
80
- content: string;
81
- type?: MemoryType;
82
- namespace?: string;
83
- tags?: string[];
84
- metadata?: Record<string, unknown>;
85
- ownerId?: string;
86
- accessLevel?: AccessLevel;
87
- expiresAt?: number;
88
- references?: string[];
89
- tier?: MemoryTier;
90
- }
91
- /**
92
- * Partial update for a memory entry
93
- */
94
- export interface MemoryEntryUpdate {
95
- content?: string;
96
- tags?: string[];
97
- metadata?: Record<string, unknown>;
98
- accessLevel?: AccessLevel;
99
- expiresAt?: number;
100
- references?: string[];
101
- }
102
- /**
103
- * Query type for memory retrieval
104
- */
105
- export type QueryType = 'semantic' | 'exact' | 'prefix' | 'tag' | 'hybrid';
106
- /**
107
- * Memory query specification
108
- */
109
- export interface MemoryQuery {
110
- /** Type of query to perform */
111
- type: QueryType;
112
- /** Content for semantic search (will be embedded) */
113
- content?: string;
114
- /** Pre-computed embedding for semantic search */
115
- embedding?: Float32Array;
116
- /** Exact key to match */
117
- key?: string;
118
- /** Key prefix to match */
119
- keyPrefix?: string;
120
- /** Namespace filter */
121
- namespace?: string;
122
- /** Tag filters (entries must have all specified tags) */
123
- tags?: string[];
124
- /** Memory type filter */
125
- memoryType?: MemoryType;
126
- /** Access level filter */
127
- accessLevel?: AccessLevel;
128
- /** Owner filter */
129
- ownerId?: string;
130
- /** Metadata filters */
131
- metadata?: Record<string, unknown>;
132
- /** Time range filters (ingestion time) */
133
- createdAfter?: number;
134
- createdBefore?: number;
135
- updatedAfter?: number;
136
- updatedBefore?: number;
137
- /**
138
- * Bi-temporal event-time filters (T vs T').
139
- * Use these to query by WHEN THE EVENT OCCURRED rather than when it was recorded.
140
- * Source: arXiv:2501.13956 — Zep/Graphiti bi-temporal knowledge graph.
141
- */
142
- eventAfter?: number;
143
- eventBefore?: number;
144
- /** Maximum number of results */
145
- limit: number;
146
- /** Offset for pagination */
147
- offset?: number;
148
- /** Minimum similarity threshold (0-1) for semantic search */
149
- threshold?: number;
150
- /** Include expired entries */
151
- includeExpired?: boolean;
152
- /** Distance metric for semantic search */
153
- distanceMetric?: DistanceMetric;
154
- /** Field to sort results by (backends that support it) */
155
- sortField?: 'createdAt' | 'updatedAt' | 'lastAccessedAt' | 'accessCount' | 'key' | 'score';
156
- /** Sort direction — 'desc' (default) or 'asc' */
157
- sortDirection?: 'asc' | 'desc';
158
- }
159
- /**
160
- * Search result with similarity score
161
- */
162
- export interface SearchResult {
163
- /** The memory entry */
164
- entry: MemoryEntry;
165
- /** Similarity score (0-1, higher is better) */
166
- score: number;
167
- /** Distance from query vector */
168
- distance: number;
169
- }
170
- /**
171
- * Search options for HNSW vector search
172
- */
173
- export interface SearchOptions {
174
- /** Number of results to return */
175
- k: number;
176
- /** Search expansion factor (higher = more accurate, slower) */
177
- ef?: number;
178
- /** Minimum similarity threshold (0-1) */
179
- threshold?: number;
180
- /** Distance metric */
181
- metric?: DistanceMetric;
182
- /** Additional filters to apply post-search */
183
- filters?: MemoryQuery;
184
- }
185
- /**
186
- * HNSW index configuration
187
- */
188
- export interface HNSWConfig {
189
- /** Vector dimensions (e.g., 1536 for OpenAI embeddings) */
190
- dimensions: number;
191
- /** Maximum number of connections per layer (default: 16) */
192
- M: number;
193
- /** Size of the dynamic candidate list during construction (default: 200) */
194
- efConstruction: number;
195
- /** Maximum elements the index can hold */
196
- maxElements: number;
197
- /** Distance metric */
198
- metric: DistanceMetric;
199
- /** Enable quantization for memory efficiency */
200
- quantization?: QuantizationConfig;
201
- }
202
- /**
203
- * Quantization configuration for memory reduction
204
- */
205
- export interface QuantizationConfig {
206
- /** Quantization type */
207
- type: 'binary' | 'scalar' | 'product';
208
- /** Number of bits for scalar quantization */
209
- bits?: 4 | 8 | 16;
210
- /** Number of subquantizers for product quantization */
211
- subquantizers?: number;
212
- /** Codebook size for product quantization */
213
- codebookSize?: number;
214
- }
215
- /**
216
- * HNSW index statistics
217
- */
218
- export interface HNSWStats {
219
- /** Total number of vectors in the index */
220
- vectorCount: number;
221
- /** Memory usage in bytes */
222
- memoryUsage: number;
223
- /** Average search time in milliseconds */
224
- avgSearchTime: number;
225
- /** Index build time in milliseconds */
226
- buildTime: number;
227
- /** Compression ratio if quantization is enabled */
228
- compressionRatio?: number;
229
- }
230
- /**
231
- * Memory backend interface for storage and retrieval
232
- */
233
- export interface IMemoryBackend {
234
- /** Initialize the backend */
235
- initialize(): Promise<void>;
236
- /** Shutdown the backend */
237
- shutdown(): Promise<void>;
238
- /** Store a memory entry */
239
- store(entry: MemoryEntry): Promise<void>;
240
- /** Retrieve a memory entry by ID */
241
- get(id: string): Promise<MemoryEntry | null>;
242
- /** Retrieve a memory entry by key within a namespace */
243
- getByKey(namespace: string, key: string): Promise<MemoryEntry | null>;
244
- /** Update a memory entry */
245
- update(id: string, update: MemoryEntryUpdate): Promise<MemoryEntry | null>;
246
- /** Delete a memory entry */
247
- delete(id: string): Promise<boolean>;
248
- /** Query memory entries */
249
- query(query: MemoryQuery): Promise<MemoryEntry[]>;
250
- /** Semantic vector search */
251
- search(embedding: Float32Array, options: SearchOptions): Promise<SearchResult[]>;
252
- /** Bulk insert entries */
253
- bulkInsert(entries: MemoryEntry[]): Promise<void>;
254
- /** Bulk delete entries */
255
- bulkDelete(ids: string[]): Promise<number>;
256
- /** Get entry count */
257
- count(namespace?: string): Promise<number>;
258
- /** List all namespaces */
259
- listNamespaces(): Promise<string[]>;
260
- /** Clear all entries in a namespace */
261
- clearNamespace(namespace: string): Promise<number>;
262
- /** Get backend statistics */
263
- getStats(): Promise<BackendStats>;
264
- /** Perform health check */
265
- healthCheck(): Promise<HealthCheckResult>;
266
- }
267
- /**
268
- * Backend statistics
269
- */
270
- export interface BackendStats {
271
- /** Total number of entries */
272
- totalEntries: number;
273
- /** Entries by namespace */
274
- entriesByNamespace: Record<string, number>;
275
- /** Entries by type */
276
- entriesByType: Record<MemoryType, number>;
277
- /** Total memory usage in bytes */
278
- memoryUsage: number;
279
- /** HNSW index statistics */
280
- hnswStats?: HNSWStats;
281
- /** Cache statistics */
282
- cacheStats?: CacheStats;
283
- /** Average query time in milliseconds */
284
- avgQueryTime: number;
285
- /** Average search time in milliseconds */
286
- avgSearchTime: number;
287
- }
288
- /**
289
- * Health check result
290
- */
291
- export interface HealthCheckResult {
292
- /** Overall health status */
293
- status: 'healthy' | 'degraded' | 'unhealthy';
294
- /** Backend mode in use */
295
- mode?: 'pure-ts-fallback';
296
- /** Individual component health */
297
- components: {
298
- storage: ComponentHealth;
299
- index: ComponentHealth;
300
- cache: ComponentHealth;
301
- };
302
- /** Health check timestamp */
303
- timestamp: number;
304
- /** Any issues detected */
305
- issues: string[];
306
- /** Recommendations for improvement */
307
- recommendations: string[];
308
- }
309
- /**
310
- * Individual component health status
311
- */
312
- export interface ComponentHealth {
313
- status: 'healthy' | 'degraded' | 'unhealthy';
314
- latency: number;
315
- message?: string;
316
- }
317
- /**
318
- * Cache configuration
319
- */
320
- export interface CacheConfig {
321
- /** Maximum number of entries in the cache */
322
- maxSize: number;
323
- /** Default TTL in milliseconds */
324
- ttl: number;
325
- /** Enable LRU eviction */
326
- lruEnabled: boolean;
327
- /** Maximum memory usage in bytes */
328
- maxMemory?: number;
329
- /** Enable write-through caching */
330
- writeThrough: boolean;
331
- }
332
- /**
333
- * Cache statistics
334
- */
335
- export interface CacheStats {
336
- /** Number of entries in cache */
337
- size: number;
338
- /** Cache hit rate (0-1) */
339
- hitRate: number;
340
- /** Total cache hits */
341
- hits: number;
342
- /** Total cache misses */
343
- misses: number;
344
- /** Total evictions */
345
- evictions: number;
346
- /** Memory usage in bytes */
347
- memoryUsage: number;
348
- }
349
- /**
350
- * Cached entry wrapper
351
- */
352
- export interface CachedEntry<T> {
353
- /** The cached data */
354
- data: T;
355
- /** When the entry was cached */
356
- cachedAt: number;
357
- /** When the entry expires */
358
- expiresAt: number;
359
- /** Last access timestamp */
360
- lastAccessedAt: number;
361
- /** Access count */
362
- accessCount: number;
363
- }
364
- /**
365
- * Migration source type
366
- */
367
- export type MigrationSource = 'sqlite' | 'markdown' | 'json' | 'memory-manager' | 'monoswarm-memory' | 'distributed-memory';
368
- /**
369
- * Migration configuration
370
- */
371
- export interface MigrationConfig {
372
- /** Source backend type */
373
- source: MigrationSource;
374
- /** Source path or connection string */
375
- sourcePath: string;
376
- /** Batch size for migration */
377
- batchSize: number;
378
- /** Generate embeddings during migration */
379
- generateEmbeddings: boolean;
380
- /** Validate data during migration */
381
- validateData: boolean;
382
- /** Continue on error */
383
- continueOnError: boolean;
384
- /** Namespace mapping */
385
- namespaceMapping?: Record<string, string>;
386
- /** Type mapping */
387
- typeMapping?: Record<string, MemoryType>;
388
- }
389
- /**
390
- * Migration progress
391
- */
392
- export interface MigrationProgress {
393
- /** Total entries to migrate */
394
- total: number;
395
- /** Entries migrated so far */
396
- migrated: number;
397
- /** Entries failed */
398
- failed: number;
399
- /** Entries skipped */
400
- skipped: number;
401
- /** Current batch number */
402
- currentBatch: number;
403
- /** Total batches */
404
- totalBatches: number;
405
- /** Progress percentage (0-100) */
406
- percentage: number;
407
- /** Estimated time remaining in milliseconds */
408
- estimatedTimeRemaining: number;
409
- /** Errors encountered */
410
- errors: MigrationError[];
411
- }
412
- /**
413
- * Migration error
414
- */
415
- export interface MigrationError {
416
- /** Entry ID or key that failed */
417
- entryId: string;
418
- /** Error message */
419
- message: string;
420
- /** Error code */
421
- code: string;
422
- /** Whether the error is recoverable */
423
- recoverable: boolean;
424
- }
425
- /**
426
- * Migration result
427
- */
428
- export interface MigrationResult {
429
- /** Whether migration completed successfully */
430
- success: boolean;
431
- /** Final progress state */
432
- progress: MigrationProgress;
433
- /** Total time taken in milliseconds */
434
- duration: number;
435
- /** Summary message */
436
- summary: string;
437
- }
438
- /**
439
- * Memory event types
440
- */
441
- export type MemoryEventType = 'entry:created' | 'entry:updated' | 'entry:deleted' | 'entry:accessed' | 'entry:expired' | 'cache:hit' | 'cache:miss' | 'cache:eviction' | 'index:rebuilt' | 'migration:started' | 'migration:progress' | 'migration:completed' | 'migration:failed';
442
- /**
443
- * Memory event payload
444
- */
445
- export interface MemoryEvent {
446
- type: MemoryEventType;
447
- timestamp: number;
448
- data: Record<string, unknown>;
449
- }
450
- /**
451
- * Memory event handler
452
- */
453
- export type MemoryEventHandler = (event: MemoryEvent) => void | Promise<void>;
454
- /**
455
- * SONA learning mode for adaptive memory
456
- */
457
- export type SONAMode = 'real-time' | 'balanced' | 'research' | 'edge' | 'batch';
458
- /**
459
- * Learning pattern from SONA integration
460
- */
461
- export interface LearningPattern {
462
- /** Pattern ID */
463
- id: string;
464
- /** Pattern data */
465
- data: Record<string, unknown>;
466
- /** SONA mode used */
467
- mode: SONAMode;
468
- /** Reward signal */
469
- reward: number;
470
- /** Trajectory data */
471
- trajectory: unknown[];
472
- /** Adaptation time in milliseconds */
473
- adaptationTime: number;
474
- /** Creation timestamp */
475
- createdAt: number;
476
- }
477
- /**
478
- * Embedding generator function type
479
- */
480
- export type EmbeddingGenerator = (content: string) => Promise<Float32Array>;
481
- /**
482
- * Generates a unique memory ID
483
- */
484
- export declare function generateMemoryId(): string;
485
- /**
486
- * Creates a default memory entry
487
- */
488
- export declare function createDefaultEntry(input: MemoryEntryInput): MemoryEntry;
489
- /**
490
- * Performance targets for V1 memory system
491
- */
492
- export declare const PERFORMANCE_TARGETS: {
493
- /** Maximum vector search time for 100k vectors */
494
- readonly MAX_SEARCH_TIME_100K: 1;
495
- /** Maximum write time per entry */
496
- readonly MAX_WRITE_TIME: 5;
497
- /** Maximum batch insert time per entry */
498
- readonly MAX_BATCH_INSERT_TIME: 1;
499
- /** Target memory reduction from legacy systems */
500
- readonly MEMORY_REDUCTION_TARGET: 0.5;
501
- /** Minimum search improvement over brute force */
502
- readonly MIN_SEARCH_IMPROVEMENT: 150;
503
- /** Maximum search improvement over brute force */
504
- readonly MAX_SEARCH_IMPROVEMENT: 12500;
505
- };
506
- export interface TierManagerConfig {
507
- shortTermCapacity: number;
508
- entityStorePath: string;
509
- contextualNamespace: string;
510
- autoFlushOnSessionEnd: boolean;
511
- }
512
- export interface Episode {
513
- episodeId: string;
514
- sessionId: string;
515
- runIds: string[];
516
- summary: string;
517
- startedAt: number;
518
- endedAt: number;
519
- agentSlugs: string[];
520
- taskTypes: string[];
521
- tokenEstimate: number;
522
- }
523
- export interface EpisodicStoreConfig {
524
- filePath: string;
525
- maxRunsPerEpisode: number;
526
- summarizer?: (content: string) => Promise<string>;
527
- }
16
+ export type { BackendStats, CacheConfig, CachedEntry, CacheStats, ComponentHealth, HealthCheckResult, HNSWConfig, HNSWStats, IMemoryBackend, QuantizationConfig, } from './types-backend.js';
17
+ export type { AccessLevel, ConsistencyLevel, DistanceMetric, MemoryEntry, MemoryEntryInput, MemoryEntryUpdate, MemoryQuery, MemoryTier, MemoryType, QueryType, SearchOptions, SearchResult, } from './types-core.js';
18
+ export type { EmbeddingGenerator, Episode, EpisodicStoreConfig, LearningPattern, MemoryEvent, MemoryEventHandler, MemoryEventType, MigrationConfig, MigrationError, MigrationProgress, MigrationResult, MigrationSource, SONAMode, TierManagerConfig, } from './types-misc.js';
19
+ export { createDefaultEntry, generateMemoryId, PERFORMANCE_TARGETS, } from './types-misc.js';
528
20
  //# sourceMappingURL=types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,YAAY,EACV,YAAY,EACZ,WAAW,EACX,WAAW,EACX,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,SAAS,EACT,cAAc,EACd,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,UAAU,EACV,SAAS,EACT,aAAa,EACb,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,kBAAkB,EAClB,OAAO,EACP,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,QAAQ,EACR,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC"}
package/dist/types.js CHANGED
@@ -7,55 +7,11 @@
7
7
  * standalone pure-JS HNSWIndex exists for ANN search but isn't wired into
8
8
  * the default search path (see the honesty review's HNSW growth plan).
9
9
  *
10
+ * File-size sweep: split into sibling modules (types-core.ts, types-backend.ts,
11
+ * types-misc.ts). This file remains the entry point and re-exports everything
12
+ * that used to live here so every existing import keeps working.
13
+ *
10
14
  * @module v1/memory/types
11
15
  */
12
- /**
13
- * Generates a unique memory ID
14
- */
15
- export function generateMemoryId() {
16
- const timestamp = Date.now().toString(36);
17
- const random = Math.random().toString(36).substring(2, 10);
18
- return `mem_${timestamp}_${random}`;
19
- }
20
- /**
21
- * Creates a default memory entry
22
- */
23
- export function createDefaultEntry(input) {
24
- const now = Date.now();
25
- return {
26
- id: generateMemoryId(),
27
- key: input.key,
28
- content: input.content,
29
- type: input.type || 'semantic',
30
- namespace: input.namespace || 'default',
31
- tags: input.tags || [],
32
- metadata: input.metadata || {},
33
- ownerId: input.ownerId,
34
- accessLevel: input.accessLevel || 'private',
35
- createdAt: now,
36
- updatedAt: now,
37
- expiresAt: input.expiresAt,
38
- version: 1,
39
- references: input.references || [],
40
- accessCount: 0,
41
- lastAccessedAt: now,
42
- };
43
- }
44
- /**
45
- * Performance targets for V1 memory system
46
- */
47
- export const PERFORMANCE_TARGETS = {
48
- /** Maximum vector search time for 100k vectors */
49
- MAX_SEARCH_TIME_100K: 1, // ms
50
- /** Maximum write time per entry */
51
- MAX_WRITE_TIME: 5, // ms
52
- /** Maximum batch insert time per entry */
53
- MAX_BATCH_INSERT_TIME: 1, // ms
54
- /** Target memory reduction from legacy systems */
55
- MEMORY_REDUCTION_TARGET: 0.5, // 50%
56
- /** Minimum search improvement over brute force */
57
- MIN_SEARCH_IMPROVEMENT: 150, // 150x
58
- /** Maximum search improvement over brute force */
59
- MAX_SEARCH_IMPROVEMENT: 12500, // 12,500x
60
- };
16
+ export { createDefaultEntry, generateMemoryId, PERFORMANCE_TARGETS, } from './types-misc.js';
61
17
  //# sourceMappingURL=types.js.map