@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,236 +0,0 @@
1
- /**
2
- * Memory Application Service - Application Layer
3
- *
4
- * Orchestrates use cases and coordinates between domain and infrastructure.
5
- * Provides a simplified interface for external consumers.
6
- *
7
- * @module v3/memory/application/services
8
- */
9
-
10
- import { MemoryEntry, MemoryType } from '../../domain/entities/memory-entry.js';
11
- import { IMemoryRepository, VectorSearchResult, MemoryStatistics } from '../../domain/repositories/memory-repository.interface.js';
12
- import { MemoryDomainService, ConsolidationOptions, ConsolidationResult } from '../../domain/services/memory-domain-service.js';
13
- import { StoreMemoryCommandHandler, StoreMemoryInput } from '../commands/store-memory.command.js';
14
- import { DeleteMemoryCommandHandler, BulkDeleteMemoryCommandHandler } from '../commands/delete-memory.command.js';
15
- import { SearchMemoryQueryHandler, SearchMemoryInput, GetMemoryByKeyQueryHandler } from '../queries/search-memory.query.js';
16
-
17
- /**
18
- * Memory Application Service
19
- *
20
- * Main entry point for memory operations.
21
- * Coordinates commands and queries with domain services.
22
- */
23
- export class MemoryApplicationService {
24
- private readonly domainService: MemoryDomainService;
25
- private readonly storeHandler: StoreMemoryCommandHandler;
26
- private readonly deleteHandler: DeleteMemoryCommandHandler;
27
- private readonly bulkDeleteHandler: BulkDeleteMemoryCommandHandler;
28
- private readonly searchHandler: SearchMemoryQueryHandler;
29
- private readonly getByKeyHandler: GetMemoryByKeyQueryHandler;
30
-
31
- constructor(private readonly repository: IMemoryRepository) {
32
- this.domainService = new MemoryDomainService(repository);
33
- this.storeHandler = new StoreMemoryCommandHandler(repository, this.domainService);
34
- this.deleteHandler = new DeleteMemoryCommandHandler(repository);
35
- this.bulkDeleteHandler = new BulkDeleteMemoryCommandHandler(repository);
36
- this.searchHandler = new SearchMemoryQueryHandler(repository);
37
- this.getByKeyHandler = new GetMemoryByKeyQueryHandler(repository);
38
- }
39
-
40
- // ============================================================================
41
- // Store Operations (Commands)
42
- // ============================================================================
43
-
44
- /**
45
- * Store a memory entry
46
- */
47
- async store(input: StoreMemoryInput): Promise<MemoryEntry> {
48
- const result = await this.storeHandler.execute(input);
49
- return result.entry;
50
- }
51
-
52
- /**
53
- * Store multiple memory entries
54
- */
55
- async storeMany(inputs: StoreMemoryInput[]): Promise<MemoryEntry[]> {
56
- const results = await Promise.all(inputs.map((input) => this.storeHandler.execute(input)));
57
- return results.map((r) => r.entry);
58
- }
59
-
60
- // ============================================================================
61
- // Retrieve Operations (Queries)
62
- // ============================================================================
63
-
64
- /**
65
- * Get a memory entry by namespace and key
66
- */
67
- async get(namespace: string, key: string): Promise<MemoryEntry | null> {
68
- const result = await this.getByKeyHandler.execute({ namespace, key, trackAccess: true });
69
- return result.entry ?? null;
70
- }
71
-
72
- /**
73
- * Get a memory entry by ID
74
- */
75
- async getById(id: string): Promise<MemoryEntry | null> {
76
- return this.repository.findById(id);
77
- }
78
-
79
- /**
80
- * Search memory entries
81
- */
82
- async search(input: SearchMemoryInput): Promise<{
83
- entries: MemoryEntry[];
84
- total: number;
85
- hasMore: boolean;
86
- }> {
87
- const result = await this.searchHandler.execute(input);
88
- return {
89
- entries: result.entries,
90
- total: result.total,
91
- hasMore: result.hasMore,
92
- };
93
- }
94
-
95
- /**
96
- * Search by vector similarity
97
- */
98
- async searchByVector(
99
- vector: Float32Array,
100
- options?: {
101
- namespace?: string;
102
- limit?: number;
103
- threshold?: number;
104
- }
105
- ): Promise<VectorSearchResult[]> {
106
- return this.domainService.searchSimilarWithTracking(
107
- vector,
108
- options?.namespace,
109
- options?.limit ?? 10
110
- );
111
- }
112
-
113
- /**
114
- * Get all entries in a namespace
115
- */
116
- async getNamespace(namespace: string): Promise<MemoryEntry[]> {
117
- return this.repository.findByNamespace(namespace, { status: 'active' });
118
- }
119
-
120
- /**
121
- * List all namespaces
122
- */
123
- async listNamespaces(): Promise<string[]> {
124
- return this.repository.listNamespaces();
125
- }
126
-
127
- // ============================================================================
128
- // Delete Operations (Commands)
129
- // ============================================================================
130
-
131
- /**
132
- * Delete a memory entry by namespace and key
133
- */
134
- async delete(namespace: string, key: string, hardDelete = false): Promise<boolean> {
135
- const result = await this.deleteHandler.execute({ namespace, key, hardDelete });
136
- return result.deleted;
137
- }
138
-
139
- /**
140
- * Delete a memory entry by ID
141
- */
142
- async deleteById(id: string, hardDelete = false): Promise<boolean> {
143
- const result = await this.deleteHandler.execute({ id, hardDelete });
144
- return result.deleted;
145
- }
146
-
147
- /**
148
- * Delete all entries in a namespace
149
- */
150
- async deleteNamespace(namespace: string, hardDelete = false): Promise<number> {
151
- const entries = await this.repository.findByNamespace(namespace);
152
- const result = await this.bulkDeleteHandler.execute({
153
- ids: entries.map((e) => e.id),
154
- hardDelete,
155
- });
156
- return result.deletedCount;
157
- }
158
-
159
- /**
160
- * Clear all memory entries
161
- */
162
- async clear(): Promise<void> {
163
- await this.repository.clear();
164
- }
165
-
166
- // ============================================================================
167
- // Maintenance Operations
168
- // ============================================================================
169
-
170
- /**
171
- * Consolidate memories using specified strategy
172
- */
173
- async consolidate(options: ConsolidationOptions): Promise<ConsolidationResult> {
174
- return this.domainService.consolidate(options);
175
- }
176
-
177
- /**
178
- * Clean up expired memories
179
- */
180
- async cleanupExpired(): Promise<number> {
181
- return this.repository.deleteExpired();
182
- }
183
-
184
- /**
185
- * Archive cold (rarely accessed) memories
186
- */
187
- async archiveCold(milliseconds: number = 86400000): Promise<number> {
188
- return this.repository.archiveCold(milliseconds);
189
- }
190
-
191
- // ============================================================================
192
- // Statistics
193
- // ============================================================================
194
-
195
- /**
196
- * Get memory statistics
197
- */
198
- async getStatistics(): Promise<MemoryStatistics> {
199
- return this.repository.getStatistics();
200
- }
201
-
202
- /**
203
- * Count entries matching criteria
204
- */
205
- async count(options?: {
206
- namespace?: string;
207
- type?: MemoryType;
208
- }): Promise<number> {
209
- return this.repository.count(options);
210
- }
211
-
212
- /**
213
- * Analyze a namespace
214
- */
215
- async analyzeNamespace(namespace: string) {
216
- return this.domainService.analyzeNamespace(namespace);
217
- }
218
-
219
- // ============================================================================
220
- // Lifecycle
221
- // ============================================================================
222
-
223
- /**
224
- * Initialize the memory service
225
- */
226
- async initialize(): Promise<void> {
227
- await this.repository.initialize();
228
- }
229
-
230
- /**
231
- * Shutdown the memory service
232
- */
233
- async shutdown(): Promise<void> {
234
- await this.repository.shutdown();
235
- }
236
- }