@claude-flow/memory 3.0.0-alpha.1 → 3.0.0-alpha.7

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 (156) hide show
  1. package/README.md +356 -18
  2. package/dist/agent-memory-scope.d.ts +131 -0
  3. package/dist/agent-memory-scope.d.ts.map +1 -0
  4. package/dist/agent-memory-scope.js +215 -0
  5. package/dist/agent-memory-scope.js.map +1 -0
  6. package/dist/agent-memory-scope.test.d.ts +8 -0
  7. package/dist/agent-memory-scope.test.d.ts.map +1 -0
  8. package/dist/agent-memory-scope.test.js +463 -0
  9. package/dist/agent-memory-scope.test.js.map +1 -0
  10. package/dist/agentdb-adapter.d.ts +22 -3
  11. package/dist/agentdb-adapter.d.ts.map +1 -1
  12. package/dist/agentdb-adapter.js +135 -8
  13. package/dist/agentdb-adapter.js.map +1 -1
  14. package/dist/auto-memory-bridge.d.ts +226 -0
  15. package/dist/auto-memory-bridge.d.ts.map +1 -0
  16. package/dist/auto-memory-bridge.js +709 -0
  17. package/dist/auto-memory-bridge.js.map +1 -0
  18. package/dist/auto-memory-bridge.test.d.ts +8 -0
  19. package/dist/auto-memory-bridge.test.d.ts.map +1 -0
  20. package/dist/auto-memory-bridge.test.js +754 -0
  21. package/dist/auto-memory-bridge.test.js.map +1 -0
  22. package/dist/benchmark.test.d.ts +2 -0
  23. package/dist/benchmark.test.d.ts.map +1 -0
  24. package/dist/benchmark.test.js +277 -0
  25. package/dist/benchmark.test.js.map +1 -0
  26. package/dist/index.d.ts +8 -0
  27. package/dist/index.d.ts.map +1 -1
  28. package/dist/index.js +8 -0
  29. package/dist/index.js.map +1 -1
  30. package/dist/learning-bridge.d.ts +137 -0
  31. package/dist/learning-bridge.d.ts.map +1 -0
  32. package/dist/learning-bridge.js +335 -0
  33. package/dist/learning-bridge.js.map +1 -0
  34. package/dist/learning-bridge.test.d.ts +8 -0
  35. package/dist/learning-bridge.test.d.ts.map +1 -0
  36. package/dist/learning-bridge.test.js +578 -0
  37. package/dist/learning-bridge.test.js.map +1 -0
  38. package/dist/memory-graph.d.ts +100 -0
  39. package/dist/memory-graph.d.ts.map +1 -0
  40. package/dist/memory-graph.js +333 -0
  41. package/dist/memory-graph.js.map +1 -0
  42. package/dist/memory-graph.test.d.ts +8 -0
  43. package/dist/memory-graph.test.d.ts.map +1 -0
  44. package/dist/memory-graph.test.js +609 -0
  45. package/dist/memory-graph.test.js.map +1 -0
  46. package/dist/types.d.ts +3 -0
  47. package/dist/types.d.ts.map +1 -1
  48. package/package.json +19 -4
  49. package/.agentic-flow/intelligence.json +0 -16
  50. package/__tests__/coverage/base.css +0 -224
  51. package/__tests__/coverage/block-navigation.js +0 -87
  52. package/__tests__/coverage/coverage-final.json +0 -19
  53. package/__tests__/coverage/favicon.png +0 -0
  54. package/__tests__/coverage/index.html +0 -206
  55. package/__tests__/coverage/lcov-report/base.css +0 -224
  56. package/__tests__/coverage/lcov-report/block-navigation.js +0 -87
  57. package/__tests__/coverage/lcov-report/favicon.png +0 -0
  58. package/__tests__/coverage/lcov-report/index.html +0 -206
  59. package/__tests__/coverage/lcov-report/prettify.css +0 -1
  60. package/__tests__/coverage/lcov-report/prettify.js +0 -2
  61. package/__tests__/coverage/lcov-report/sort-arrow-sprite.png +0 -0
  62. package/__tests__/coverage/lcov-report/sorter.js +0 -210
  63. package/__tests__/coverage/lcov-report/src/agentdb-adapter.ts.html +0 -2737
  64. package/__tests__/coverage/lcov-report/src/agentdb-backend.ts.html +0 -3130
  65. package/__tests__/coverage/lcov-report/src/application/commands/delete-memory.command.ts.html +0 -601
  66. package/__tests__/coverage/lcov-report/src/application/commands/index.html +0 -131
  67. package/__tests__/coverage/lcov-report/src/application/commands/store-memory.command.ts.html +0 -394
  68. package/__tests__/coverage/lcov-report/src/application/queries/index.html +0 -116
  69. package/__tests__/coverage/lcov-report/src/application/queries/search-memory.query.ts.html +0 -796
  70. package/__tests__/coverage/lcov-report/src/application/services/index.html +0 -116
  71. package/__tests__/coverage/lcov-report/src/application/services/memory-application-service.ts.html +0 -793
  72. package/__tests__/coverage/lcov-report/src/cache-manager.ts.html +0 -1633
  73. package/__tests__/coverage/lcov-report/src/database-provider.ts.html +0 -1618
  74. package/__tests__/coverage/lcov-report/src/domain/entities/index.html +0 -116
  75. package/__tests__/coverage/lcov-report/src/domain/entities/memory-entry.ts.html +0 -952
  76. package/__tests__/coverage/lcov-report/src/domain/services/index.html +0 -116
  77. package/__tests__/coverage/lcov-report/src/domain/services/memory-domain-service.ts.html +0 -1294
  78. package/__tests__/coverage/lcov-report/src/hnsw-index.ts.html +0 -3124
  79. package/__tests__/coverage/lcov-report/src/hybrid-backend.ts.html +0 -2167
  80. package/__tests__/coverage/lcov-report/src/index.html +0 -266
  81. package/__tests__/coverage/lcov-report/src/infrastructure/repositories/hybrid-memory-repository.ts.html +0 -1633
  82. package/__tests__/coverage/lcov-report/src/infrastructure/repositories/index.html +0 -116
  83. package/__tests__/coverage/lcov-report/src/migration.ts.html +0 -2092
  84. package/__tests__/coverage/lcov-report/src/query-builder.ts.html +0 -1711
  85. package/__tests__/coverage/lcov-report/src/sqlite-backend.ts.html +0 -2281
  86. package/__tests__/coverage/lcov-report/src/sqljs-backend.ts.html +0 -2374
  87. package/__tests__/coverage/lcov-report/src/types.ts.html +0 -2266
  88. package/__tests__/coverage/lcov.info +0 -10238
  89. package/__tests__/coverage/prettify.css +0 -1
  90. package/__tests__/coverage/prettify.js +0 -2
  91. package/__tests__/coverage/sort-arrow-sprite.png +0 -0
  92. package/__tests__/coverage/sorter.js +0 -210
  93. package/__tests__/coverage/src/agentdb-adapter.ts.html +0 -2737
  94. package/__tests__/coverage/src/agentdb-backend.ts.html +0 -3130
  95. package/__tests__/coverage/src/application/commands/delete-memory.command.ts.html +0 -601
  96. package/__tests__/coverage/src/application/commands/index.html +0 -131
  97. package/__tests__/coverage/src/application/commands/store-memory.command.ts.html +0 -394
  98. package/__tests__/coverage/src/application/queries/index.html +0 -116
  99. package/__tests__/coverage/src/application/queries/search-memory.query.ts.html +0 -796
  100. package/__tests__/coverage/src/application/services/index.html +0 -116
  101. package/__tests__/coverage/src/application/services/memory-application-service.ts.html +0 -793
  102. package/__tests__/coverage/src/cache-manager.ts.html +0 -1633
  103. package/__tests__/coverage/src/database-provider.ts.html +0 -1618
  104. package/__tests__/coverage/src/domain/entities/index.html +0 -116
  105. package/__tests__/coverage/src/domain/entities/memory-entry.ts.html +0 -952
  106. package/__tests__/coverage/src/domain/services/index.html +0 -116
  107. package/__tests__/coverage/src/domain/services/memory-domain-service.ts.html +0 -1294
  108. package/__tests__/coverage/src/hnsw-index.ts.html +0 -3124
  109. package/__tests__/coverage/src/hybrid-backend.ts.html +0 -2167
  110. package/__tests__/coverage/src/index.html +0 -266
  111. package/__tests__/coverage/src/infrastructure/repositories/hybrid-memory-repository.ts.html +0 -1633
  112. package/__tests__/coverage/src/infrastructure/repositories/index.html +0 -116
  113. package/__tests__/coverage/src/migration.ts.html +0 -2092
  114. package/__tests__/coverage/src/query-builder.ts.html +0 -1711
  115. package/__tests__/coverage/src/sqlite-backend.ts.html +0 -2281
  116. package/__tests__/coverage/src/sqljs-backend.ts.html +0 -2374
  117. package/__tests__/coverage/src/types.ts.html +0 -2266
  118. package/benchmarks/cache-hit-rate.bench.ts +0 -535
  119. package/benchmarks/hnsw-indexing.bench.ts +0 -552
  120. package/benchmarks/memory-write.bench.ts +0 -469
  121. package/benchmarks/vector-search.bench.ts +0 -449
  122. package/docs/AGENTDB-INTEGRATION.md +0 -388
  123. package/docs/CROSS_PLATFORM.md +0 -505
  124. package/docs/WINDOWS_SUPPORT.md +0 -422
  125. package/examples/agentdb-example.ts +0 -345
  126. package/examples/cross-platform-usage.ts +0 -326
  127. package/framework/benchmark.ts +0 -112
  128. package/src/agentdb-adapter.ts +0 -884
  129. package/src/agentdb-backend.test.ts +0 -339
  130. package/src/agentdb-backend.ts +0 -1016
  131. package/src/application/commands/delete-memory.command.ts +0 -172
  132. package/src/application/commands/store-memory.command.ts +0 -103
  133. package/src/application/index.ts +0 -36
  134. package/src/application/queries/search-memory.query.ts +0 -237
  135. package/src/application/services/memory-application-service.ts +0 -236
  136. package/src/cache-manager.ts +0 -516
  137. package/src/database-provider.test.ts +0 -364
  138. package/src/database-provider.ts +0 -511
  139. package/src/domain/entities/memory-entry.ts +0 -289
  140. package/src/domain/index.ts +0 -35
  141. package/src/domain/repositories/memory-repository.interface.ts +0 -120
  142. package/src/domain/services/memory-domain-service.ts +0 -403
  143. package/src/hnsw-index.ts +0 -1013
  144. package/src/hybrid-backend.test.ts +0 -399
  145. package/src/hybrid-backend.ts +0 -694
  146. package/src/index.ts +0 -515
  147. package/src/infrastructure/index.ts +0 -23
  148. package/src/infrastructure/repositories/hybrid-memory-repository.ts +0 -516
  149. package/src/migration.ts +0 -669
  150. package/src/query-builder.ts +0 -542
  151. package/src/sqlite-backend.ts +0 -732
  152. package/src/sqljs-backend.ts +0 -763
  153. package/src/types.ts +0 -727
  154. package/tsconfig.json +0 -9
  155. package/tsconfig.tsbuildinfo +0 -1
  156. package/verify-cross-platform.ts +0 -170
@@ -1,339 +0,0 @@
1
- /**
2
- * AgentDB Backend Tests
3
- *
4
- * Tests for agentdb@2.0.0-alpha.3.4 integration with V3 memory system
5
- */
6
-
7
- import { describe, it, expect, beforeEach, afterEach } from 'vitest';
8
- import { AgentDBBackend } from './agentdb-backend.js';
9
- import { createDefaultEntry } from './types.js';
10
-
11
- describe('AgentDBBackend', () => {
12
- let backend: AgentDBBackend;
13
-
14
- beforeEach(async () => {
15
- backend = new AgentDBBackend({
16
- dbPath: ':memory:',
17
- namespace: 'test',
18
- vectorDimension: 384,
19
- });
20
- await backend.initialize();
21
- });
22
-
23
- afterEach(async () => {
24
- await backend.shutdown();
25
- });
26
-
27
- describe('Initialization', () => {
28
- it('should initialize successfully', async () => {
29
- expect(backend).toBeDefined();
30
- });
31
-
32
- it('should handle missing agentdb gracefully', async () => {
33
- const fallbackBackend = new AgentDBBackend();
34
- await fallbackBackend.initialize();
35
-
36
- // Should still work with in-memory fallback
37
- expect(fallbackBackend).toBeDefined();
38
-
39
- await fallbackBackend.shutdown();
40
- });
41
- });
42
-
43
- describe('Basic CRUD Operations', () => {
44
- it('should store and retrieve entries', async () => {
45
- const entry = createDefaultEntry({
46
- key: 'test-key',
47
- content: 'Test content',
48
- type: 'episodic',
49
- });
50
-
51
- await backend.store(entry);
52
-
53
- const retrieved = await backend.get(entry.id);
54
- expect(retrieved).toBeDefined();
55
- expect(retrieved?.content).toBe('Test content');
56
- });
57
-
58
- it('should get entry by key', async () => {
59
- const entry = createDefaultEntry({
60
- key: 'unique-key',
61
- content: 'Unique content',
62
- namespace: 'test',
63
- });
64
-
65
- await backend.store(entry);
66
-
67
- const retrieved = await backend.getByKey('test', 'unique-key');
68
- expect(retrieved).toBeDefined();
69
- expect(retrieved?.content).toBe('Unique content');
70
- });
71
-
72
- it('should update entries', async () => {
73
- const entry = createDefaultEntry({
74
- key: 'update-test',
75
- content: 'Original content',
76
- });
77
-
78
- await backend.store(entry);
79
- const originalVersion = entry.version;
80
-
81
- const updated = await backend.update(entry.id, {
82
- content: 'Updated content',
83
- });
84
-
85
- expect(updated?.content).toBe('Updated content');
86
- expect(updated?.version).toBe(originalVersion + 1);
87
- });
88
-
89
- it('should delete entries', async () => {
90
- const entry = createDefaultEntry({
91
- key: 'delete-test',
92
- content: 'To be deleted',
93
- });
94
-
95
- await backend.store(entry);
96
-
97
- const deleted = await backend.delete(entry.id);
98
- expect(deleted).toBe(true);
99
-
100
- const retrieved = await backend.get(entry.id);
101
- expect(retrieved).toBeNull();
102
- });
103
- });
104
-
105
- describe('Query Operations', () => {
106
- beforeEach(async () => {
107
- // Insert test data
108
- await backend.store(
109
- createDefaultEntry({
110
- key: 'entry-1',
111
- content: 'First entry',
112
- namespace: 'test',
113
- tags: ['tag1', 'tag2'],
114
- })
115
- );
116
-
117
- await backend.store(
118
- createDefaultEntry({
119
- key: 'entry-2',
120
- content: 'Second entry',
121
- namespace: 'test',
122
- tags: ['tag2', 'tag3'],
123
- })
124
- );
125
-
126
- await backend.store(
127
- createDefaultEntry({
128
- key: 'entry-3',
129
- content: 'Third entry',
130
- namespace: 'other',
131
- tags: ['tag1'],
132
- })
133
- );
134
- });
135
-
136
- it('should query by namespace', async () => {
137
- const results = await backend.query({
138
- type: 'hybrid',
139
- namespace: 'test',
140
- limit: 10,
141
- });
142
-
143
- expect(results.length).toBe(2);
144
- });
145
-
146
- it('should query by exact key', async () => {
147
- const results = await backend.query({
148
- type: 'exact',
149
- namespace: 'test',
150
- key: 'entry-1',
151
- limit: 10,
152
- });
153
-
154
- expect(results.length).toBe(1);
155
- expect(results[0].content).toBe('First entry');
156
- });
157
-
158
- it('should query by prefix', async () => {
159
- const results = await backend.query({
160
- type: 'prefix',
161
- keyPrefix: 'entry-',
162
- limit: 10,
163
- });
164
-
165
- expect(results.length).toBeGreaterThanOrEqual(2);
166
- });
167
-
168
- it('should query by tags', async () => {
169
- const results = await backend.query({
170
- type: 'tag',
171
- tags: ['tag2'],
172
- limit: 10,
173
- });
174
-
175
- expect(results.length).toBe(2);
176
- });
177
- });
178
-
179
- describe('Vector Search', () => {
180
- it('should perform brute-force search when agentdb unavailable', async () => {
181
- const entry = createDefaultEntry({
182
- key: 'vector-test',
183
- content: 'Vector content',
184
- });
185
-
186
- // Create a fake embedding
187
- entry.embedding = new Float32Array([0.1, 0.2, 0.3, 0.4]);
188
-
189
- await backend.store(entry);
190
-
191
- const queryEmbedding = new Float32Array([0.1, 0.2, 0.3, 0.4]);
192
-
193
- const results = await backend.search(queryEmbedding, { k: 5 });
194
-
195
- expect(results.length).toBeGreaterThan(0);
196
- expect(results[0].entry.id).toBe(entry.id);
197
- });
198
-
199
- it('should handle semantic queries', async () => {
200
- const entry = createDefaultEntry({
201
- key: 'semantic-test',
202
- content: 'Semantic content',
203
- });
204
-
205
- entry.embedding = new Float32Array([0.5, 0.5, 0.5, 0.5]);
206
-
207
- await backend.store(entry);
208
-
209
- const results = await backend.query({
210
- type: 'semantic',
211
- embedding: new Float32Array([0.5, 0.5, 0.5, 0.5]),
212
- limit: 5,
213
- });
214
-
215
- expect(results.length).toBeGreaterThan(0);
216
- });
217
- });
218
-
219
- describe('Bulk Operations', () => {
220
- it('should bulk insert entries', async () => {
221
- const entries = [
222
- createDefaultEntry({ key: 'bulk-1', content: 'Bulk 1' }),
223
- createDefaultEntry({ key: 'bulk-2', content: 'Bulk 2' }),
224
- createDefaultEntry({ key: 'bulk-3', content: 'Bulk 3' }),
225
- ];
226
-
227
- await backend.bulkInsert(entries);
228
-
229
- const count = await backend.count();
230
- expect(count).toBeGreaterThanOrEqual(3);
231
- });
232
-
233
- it('should bulk delete entries', async () => {
234
- const entries = [
235
- createDefaultEntry({ key: 'delete-1', content: 'Delete 1' }),
236
- createDefaultEntry({ key: 'delete-2', content: 'Delete 2' }),
237
- ];
238
-
239
- await backend.bulkInsert(entries);
240
-
241
- const ids = entries.map((e) => e.id);
242
- const deleted = await backend.bulkDelete(ids);
243
-
244
- expect(deleted).toBe(2);
245
- });
246
- });
247
-
248
- describe('Statistics and Health', () => {
249
- it('should provide backend statistics', async () => {
250
- await backend.store(
251
- createDefaultEntry({ key: 'stats-test', content: 'Stats content' })
252
- );
253
-
254
- const stats = await backend.getStats();
255
-
256
- expect(stats.totalEntries).toBeGreaterThan(0);
257
- expect(stats.avgQueryTime).toBeGreaterThanOrEqual(0);
258
- expect(stats.memoryUsage).toBeGreaterThan(0);
259
- });
260
-
261
- it('should perform health checks', async () => {
262
- const health = await backend.healthCheck();
263
-
264
- expect(health.status).toBeDefined();
265
- expect(['healthy', 'degraded', 'unhealthy']).toContain(health.status);
266
- expect(health.components).toBeDefined();
267
- expect(health.components.storage).toBeDefined();
268
- expect(health.components.index).toBeDefined();
269
- expect(health.components.cache).toBeDefined();
270
- });
271
- });
272
-
273
- describe('Namespace Operations', () => {
274
- beforeEach(async () => {
275
- await backend.store(
276
- createDefaultEntry({
277
- key: 'ns1-entry',
278
- content: 'NS1',
279
- namespace: 'namespace1',
280
- })
281
- );
282
-
283
- await backend.store(
284
- createDefaultEntry({
285
- key: 'ns2-entry',
286
- content: 'NS2',
287
- namespace: 'namespace2',
288
- })
289
- );
290
- });
291
-
292
- it('should list namespaces', async () => {
293
- const namespaces = await backend.listNamespaces();
294
-
295
- expect(namespaces).toContain('namespace1');
296
- expect(namespaces).toContain('namespace2');
297
- });
298
-
299
- it('should count entries by namespace', async () => {
300
- const count = await backend.count('namespace1');
301
- expect(count).toBe(1);
302
- });
303
-
304
- it('should clear namespace', async () => {
305
- const cleared = await backend.clearNamespace('namespace1');
306
- expect(cleared).toBe(1);
307
-
308
- const count = await backend.count('namespace1');
309
- expect(count).toBe(0);
310
- });
311
- });
312
-
313
- describe('Graceful Degradation', () => {
314
- it('should work without agentdb package', async () => {
315
- const fallbackBackend = new AgentDBBackend({
316
- dbPath: ':memory:',
317
- });
318
-
319
- await fallbackBackend.initialize();
320
-
321
- const entry = createDefaultEntry({
322
- key: 'fallback-test',
323
- content: 'Fallback content',
324
- });
325
-
326
- await fallbackBackend.store(entry);
327
- const retrieved = await fallbackBackend.get(entry.id);
328
-
329
- expect(retrieved).toBeDefined();
330
- expect(retrieved?.content).toBe('Fallback content');
331
-
332
- await fallbackBackend.shutdown();
333
- });
334
-
335
- it('should indicate availability status', () => {
336
- expect(typeof backend.isAvailable()).toBe('boolean');
337
- });
338
- });
339
- });