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

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 (163) 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/hybrid-backend.d.ts.map +1 -1
  27. package/dist/hybrid-backend.js +29 -4
  28. package/dist/hybrid-backend.js.map +1 -1
  29. package/dist/index.d.ts +8 -0
  30. package/dist/index.d.ts.map +1 -1
  31. package/dist/index.js +8 -0
  32. package/dist/index.js.map +1 -1
  33. package/dist/learning-bridge.d.ts +137 -0
  34. package/dist/learning-bridge.d.ts.map +1 -0
  35. package/dist/learning-bridge.js +335 -0
  36. package/dist/learning-bridge.js.map +1 -0
  37. package/dist/learning-bridge.test.d.ts +8 -0
  38. package/dist/learning-bridge.test.d.ts.map +1 -0
  39. package/dist/learning-bridge.test.js +578 -0
  40. package/dist/learning-bridge.test.js.map +1 -0
  41. package/dist/memory-graph.d.ts +100 -0
  42. package/dist/memory-graph.d.ts.map +1 -0
  43. package/dist/memory-graph.js +333 -0
  44. package/dist/memory-graph.js.map +1 -0
  45. package/dist/memory-graph.test.d.ts +8 -0
  46. package/dist/memory-graph.test.d.ts.map +1 -0
  47. package/dist/memory-graph.test.js +609 -0
  48. package/dist/memory-graph.test.js.map +1 -0
  49. package/dist/sqlite-backend.js +3 -3
  50. package/dist/sqljs-backend.d.ts.map +1 -1
  51. package/dist/sqljs-backend.js +5 -2
  52. package/dist/sqljs-backend.js.map +1 -1
  53. package/dist/types.d.ts +3 -0
  54. package/dist/types.d.ts.map +1 -1
  55. package/package.json +20 -5
  56. package/.agentic-flow/intelligence.json +0 -16
  57. package/__tests__/coverage/base.css +0 -224
  58. package/__tests__/coverage/block-navigation.js +0 -87
  59. package/__tests__/coverage/coverage-final.json +0 -19
  60. package/__tests__/coverage/favicon.png +0 -0
  61. package/__tests__/coverage/index.html +0 -206
  62. package/__tests__/coverage/lcov-report/base.css +0 -224
  63. package/__tests__/coverage/lcov-report/block-navigation.js +0 -87
  64. package/__tests__/coverage/lcov-report/favicon.png +0 -0
  65. package/__tests__/coverage/lcov-report/index.html +0 -206
  66. package/__tests__/coverage/lcov-report/prettify.css +0 -1
  67. package/__tests__/coverage/lcov-report/prettify.js +0 -2
  68. package/__tests__/coverage/lcov-report/sort-arrow-sprite.png +0 -0
  69. package/__tests__/coverage/lcov-report/sorter.js +0 -210
  70. package/__tests__/coverage/lcov-report/src/agentdb-adapter.ts.html +0 -2737
  71. package/__tests__/coverage/lcov-report/src/agentdb-backend.ts.html +0 -3130
  72. package/__tests__/coverage/lcov-report/src/application/commands/delete-memory.command.ts.html +0 -601
  73. package/__tests__/coverage/lcov-report/src/application/commands/index.html +0 -131
  74. package/__tests__/coverage/lcov-report/src/application/commands/store-memory.command.ts.html +0 -394
  75. package/__tests__/coverage/lcov-report/src/application/queries/index.html +0 -116
  76. package/__tests__/coverage/lcov-report/src/application/queries/search-memory.query.ts.html +0 -796
  77. package/__tests__/coverage/lcov-report/src/application/services/index.html +0 -116
  78. package/__tests__/coverage/lcov-report/src/application/services/memory-application-service.ts.html +0 -793
  79. package/__tests__/coverage/lcov-report/src/cache-manager.ts.html +0 -1633
  80. package/__tests__/coverage/lcov-report/src/database-provider.ts.html +0 -1618
  81. package/__tests__/coverage/lcov-report/src/domain/entities/index.html +0 -116
  82. package/__tests__/coverage/lcov-report/src/domain/entities/memory-entry.ts.html +0 -952
  83. package/__tests__/coverage/lcov-report/src/domain/services/index.html +0 -116
  84. package/__tests__/coverage/lcov-report/src/domain/services/memory-domain-service.ts.html +0 -1294
  85. package/__tests__/coverage/lcov-report/src/hnsw-index.ts.html +0 -3124
  86. package/__tests__/coverage/lcov-report/src/hybrid-backend.ts.html +0 -2167
  87. package/__tests__/coverage/lcov-report/src/index.html +0 -266
  88. package/__tests__/coverage/lcov-report/src/infrastructure/repositories/hybrid-memory-repository.ts.html +0 -1633
  89. package/__tests__/coverage/lcov-report/src/infrastructure/repositories/index.html +0 -116
  90. package/__tests__/coverage/lcov-report/src/migration.ts.html +0 -2092
  91. package/__tests__/coverage/lcov-report/src/query-builder.ts.html +0 -1711
  92. package/__tests__/coverage/lcov-report/src/sqlite-backend.ts.html +0 -2281
  93. package/__tests__/coverage/lcov-report/src/sqljs-backend.ts.html +0 -2374
  94. package/__tests__/coverage/lcov-report/src/types.ts.html +0 -2266
  95. package/__tests__/coverage/lcov.info +0 -10238
  96. package/__tests__/coverage/prettify.css +0 -1
  97. package/__tests__/coverage/prettify.js +0 -2
  98. package/__tests__/coverage/sort-arrow-sprite.png +0 -0
  99. package/__tests__/coverage/sorter.js +0 -210
  100. package/__tests__/coverage/src/agentdb-adapter.ts.html +0 -2737
  101. package/__tests__/coverage/src/agentdb-backend.ts.html +0 -3130
  102. package/__tests__/coverage/src/application/commands/delete-memory.command.ts.html +0 -601
  103. package/__tests__/coverage/src/application/commands/index.html +0 -131
  104. package/__tests__/coverage/src/application/commands/store-memory.command.ts.html +0 -394
  105. package/__tests__/coverage/src/application/queries/index.html +0 -116
  106. package/__tests__/coverage/src/application/queries/search-memory.query.ts.html +0 -796
  107. package/__tests__/coverage/src/application/services/index.html +0 -116
  108. package/__tests__/coverage/src/application/services/memory-application-service.ts.html +0 -793
  109. package/__tests__/coverage/src/cache-manager.ts.html +0 -1633
  110. package/__tests__/coverage/src/database-provider.ts.html +0 -1618
  111. package/__tests__/coverage/src/domain/entities/index.html +0 -116
  112. package/__tests__/coverage/src/domain/entities/memory-entry.ts.html +0 -952
  113. package/__tests__/coverage/src/domain/services/index.html +0 -116
  114. package/__tests__/coverage/src/domain/services/memory-domain-service.ts.html +0 -1294
  115. package/__tests__/coverage/src/hnsw-index.ts.html +0 -3124
  116. package/__tests__/coverage/src/hybrid-backend.ts.html +0 -2167
  117. package/__tests__/coverage/src/index.html +0 -266
  118. package/__tests__/coverage/src/infrastructure/repositories/hybrid-memory-repository.ts.html +0 -1633
  119. package/__tests__/coverage/src/infrastructure/repositories/index.html +0 -116
  120. package/__tests__/coverage/src/migration.ts.html +0 -2092
  121. package/__tests__/coverage/src/query-builder.ts.html +0 -1711
  122. package/__tests__/coverage/src/sqlite-backend.ts.html +0 -2281
  123. package/__tests__/coverage/src/sqljs-backend.ts.html +0 -2374
  124. package/__tests__/coverage/src/types.ts.html +0 -2266
  125. package/benchmarks/cache-hit-rate.bench.ts +0 -535
  126. package/benchmarks/hnsw-indexing.bench.ts +0 -552
  127. package/benchmarks/memory-write.bench.ts +0 -469
  128. package/benchmarks/vector-search.bench.ts +0 -449
  129. package/docs/AGENTDB-INTEGRATION.md +0 -388
  130. package/docs/CROSS_PLATFORM.md +0 -505
  131. package/docs/WINDOWS_SUPPORT.md +0 -422
  132. package/examples/agentdb-example.ts +0 -345
  133. package/examples/cross-platform-usage.ts +0 -326
  134. package/framework/benchmark.ts +0 -112
  135. package/src/agentdb-adapter.ts +0 -884
  136. package/src/agentdb-backend.test.ts +0 -339
  137. package/src/agentdb-backend.ts +0 -1016
  138. package/src/application/commands/delete-memory.command.ts +0 -172
  139. package/src/application/commands/store-memory.command.ts +0 -103
  140. package/src/application/index.ts +0 -36
  141. package/src/application/queries/search-memory.query.ts +0 -237
  142. package/src/application/services/memory-application-service.ts +0 -236
  143. package/src/cache-manager.ts +0 -516
  144. package/src/database-provider.test.ts +0 -364
  145. package/src/database-provider.ts +0 -511
  146. package/src/domain/entities/memory-entry.ts +0 -289
  147. package/src/domain/index.ts +0 -35
  148. package/src/domain/repositories/memory-repository.interface.ts +0 -120
  149. package/src/domain/services/memory-domain-service.ts +0 -403
  150. package/src/hnsw-index.ts +0 -1013
  151. package/src/hybrid-backend.test.ts +0 -399
  152. package/src/hybrid-backend.ts +0 -694
  153. package/src/index.ts +0 -515
  154. package/src/infrastructure/index.ts +0 -23
  155. package/src/infrastructure/repositories/hybrid-memory-repository.ts +0 -516
  156. package/src/migration.ts +0 -669
  157. package/src/query-builder.ts +0 -542
  158. package/src/sqlite-backend.ts +0 -732
  159. package/src/sqljs-backend.ts +0 -763
  160. package/src/types.ts +0 -727
  161. package/tsconfig.json +0 -9
  162. package/tsconfig.tsbuildinfo +0 -1
  163. 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
- });