@claude-flow/memory 3.0.0-alpha.2 → 3.0.0-alpha.8

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 (164) 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 +15 -4
  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/tmp.json +0 -0
  162. package/tsconfig.json +0 -9
  163. package/tsconfig.tsbuildinfo +0 -1
  164. 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
- }