@claude-flow/memory 3.0.0-alpha.1

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 (214) hide show
  1. package/.agentic-flow/intelligence.json +16 -0
  2. package/README.md +249 -0
  3. package/__tests__/coverage/base.css +224 -0
  4. package/__tests__/coverage/block-navigation.js +87 -0
  5. package/__tests__/coverage/coverage-final.json +19 -0
  6. package/__tests__/coverage/favicon.png +0 -0
  7. package/__tests__/coverage/index.html +206 -0
  8. package/__tests__/coverage/lcov-report/base.css +224 -0
  9. package/__tests__/coverage/lcov-report/block-navigation.js +87 -0
  10. package/__tests__/coverage/lcov-report/favicon.png +0 -0
  11. package/__tests__/coverage/lcov-report/index.html +206 -0
  12. package/__tests__/coverage/lcov-report/prettify.css +1 -0
  13. package/__tests__/coverage/lcov-report/prettify.js +2 -0
  14. package/__tests__/coverage/lcov-report/sort-arrow-sprite.png +0 -0
  15. package/__tests__/coverage/lcov-report/sorter.js +210 -0
  16. package/__tests__/coverage/lcov-report/src/agentdb-adapter.ts.html +2737 -0
  17. package/__tests__/coverage/lcov-report/src/agentdb-backend.ts.html +3130 -0
  18. package/__tests__/coverage/lcov-report/src/application/commands/delete-memory.command.ts.html +601 -0
  19. package/__tests__/coverage/lcov-report/src/application/commands/index.html +131 -0
  20. package/__tests__/coverage/lcov-report/src/application/commands/store-memory.command.ts.html +394 -0
  21. package/__tests__/coverage/lcov-report/src/application/queries/index.html +116 -0
  22. package/__tests__/coverage/lcov-report/src/application/queries/search-memory.query.ts.html +796 -0
  23. package/__tests__/coverage/lcov-report/src/application/services/index.html +116 -0
  24. package/__tests__/coverage/lcov-report/src/application/services/memory-application-service.ts.html +793 -0
  25. package/__tests__/coverage/lcov-report/src/cache-manager.ts.html +1633 -0
  26. package/__tests__/coverage/lcov-report/src/database-provider.ts.html +1618 -0
  27. package/__tests__/coverage/lcov-report/src/domain/entities/index.html +116 -0
  28. package/__tests__/coverage/lcov-report/src/domain/entities/memory-entry.ts.html +952 -0
  29. package/__tests__/coverage/lcov-report/src/domain/services/index.html +116 -0
  30. package/__tests__/coverage/lcov-report/src/domain/services/memory-domain-service.ts.html +1294 -0
  31. package/__tests__/coverage/lcov-report/src/hnsw-index.ts.html +3124 -0
  32. package/__tests__/coverage/lcov-report/src/hybrid-backend.ts.html +2167 -0
  33. package/__tests__/coverage/lcov-report/src/index.html +266 -0
  34. package/__tests__/coverage/lcov-report/src/infrastructure/repositories/hybrid-memory-repository.ts.html +1633 -0
  35. package/__tests__/coverage/lcov-report/src/infrastructure/repositories/index.html +116 -0
  36. package/__tests__/coverage/lcov-report/src/migration.ts.html +2092 -0
  37. package/__tests__/coverage/lcov-report/src/query-builder.ts.html +1711 -0
  38. package/__tests__/coverage/lcov-report/src/sqlite-backend.ts.html +2281 -0
  39. package/__tests__/coverage/lcov-report/src/sqljs-backend.ts.html +2374 -0
  40. package/__tests__/coverage/lcov-report/src/types.ts.html +2266 -0
  41. package/__tests__/coverage/lcov.info +10238 -0
  42. package/__tests__/coverage/prettify.css +1 -0
  43. package/__tests__/coverage/prettify.js +2 -0
  44. package/__tests__/coverage/sort-arrow-sprite.png +0 -0
  45. package/__tests__/coverage/sorter.js +210 -0
  46. package/__tests__/coverage/src/agentdb-adapter.ts.html +2737 -0
  47. package/__tests__/coverage/src/agentdb-backend.ts.html +3130 -0
  48. package/__tests__/coverage/src/application/commands/delete-memory.command.ts.html +601 -0
  49. package/__tests__/coverage/src/application/commands/index.html +131 -0
  50. package/__tests__/coverage/src/application/commands/store-memory.command.ts.html +394 -0
  51. package/__tests__/coverage/src/application/queries/index.html +116 -0
  52. package/__tests__/coverage/src/application/queries/search-memory.query.ts.html +796 -0
  53. package/__tests__/coverage/src/application/services/index.html +116 -0
  54. package/__tests__/coverage/src/application/services/memory-application-service.ts.html +793 -0
  55. package/__tests__/coverage/src/cache-manager.ts.html +1633 -0
  56. package/__tests__/coverage/src/database-provider.ts.html +1618 -0
  57. package/__tests__/coverage/src/domain/entities/index.html +116 -0
  58. package/__tests__/coverage/src/domain/entities/memory-entry.ts.html +952 -0
  59. package/__tests__/coverage/src/domain/services/index.html +116 -0
  60. package/__tests__/coverage/src/domain/services/memory-domain-service.ts.html +1294 -0
  61. package/__tests__/coverage/src/hnsw-index.ts.html +3124 -0
  62. package/__tests__/coverage/src/hybrid-backend.ts.html +2167 -0
  63. package/__tests__/coverage/src/index.html +266 -0
  64. package/__tests__/coverage/src/infrastructure/repositories/hybrid-memory-repository.ts.html +1633 -0
  65. package/__tests__/coverage/src/infrastructure/repositories/index.html +116 -0
  66. package/__tests__/coverage/src/migration.ts.html +2092 -0
  67. package/__tests__/coverage/src/query-builder.ts.html +1711 -0
  68. package/__tests__/coverage/src/sqlite-backend.ts.html +2281 -0
  69. package/__tests__/coverage/src/sqljs-backend.ts.html +2374 -0
  70. package/__tests__/coverage/src/types.ts.html +2266 -0
  71. package/benchmarks/cache-hit-rate.bench.ts +535 -0
  72. package/benchmarks/hnsw-indexing.bench.ts +552 -0
  73. package/benchmarks/memory-write.bench.ts +469 -0
  74. package/benchmarks/vector-search.bench.ts +449 -0
  75. package/dist/agentdb-adapter.d.ts +146 -0
  76. package/dist/agentdb-adapter.d.ts.map +1 -0
  77. package/dist/agentdb-adapter.js +679 -0
  78. package/dist/agentdb-adapter.js.map +1 -0
  79. package/dist/agentdb-backend.d.ts +214 -0
  80. package/dist/agentdb-backend.d.ts.map +1 -0
  81. package/dist/agentdb-backend.js +827 -0
  82. package/dist/agentdb-backend.js.map +1 -0
  83. package/dist/agentdb-backend.test.d.ts +7 -0
  84. package/dist/agentdb-backend.test.d.ts.map +1 -0
  85. package/dist/agentdb-backend.test.js +258 -0
  86. package/dist/agentdb-backend.test.js.map +1 -0
  87. package/dist/application/commands/delete-memory.command.d.ts +65 -0
  88. package/dist/application/commands/delete-memory.command.d.ts.map +1 -0
  89. package/dist/application/commands/delete-memory.command.js +129 -0
  90. package/dist/application/commands/delete-memory.command.js.map +1 -0
  91. package/dist/application/commands/store-memory.command.d.ts +48 -0
  92. package/dist/application/commands/store-memory.command.d.ts.map +1 -0
  93. package/dist/application/commands/store-memory.command.js +72 -0
  94. package/dist/application/commands/store-memory.command.js.map +1 -0
  95. package/dist/application/index.d.ts +12 -0
  96. package/dist/application/index.d.ts.map +1 -0
  97. package/dist/application/index.js +15 -0
  98. package/dist/application/index.js.map +1 -0
  99. package/dist/application/queries/search-memory.query.d.ts +72 -0
  100. package/dist/application/queries/search-memory.query.d.ts.map +1 -0
  101. package/dist/application/queries/search-memory.query.js +143 -0
  102. package/dist/application/queries/search-memory.query.js.map +1 -0
  103. package/dist/application/services/memory-application-service.d.ts +121 -0
  104. package/dist/application/services/memory-application-service.d.ts.map +1 -0
  105. package/dist/application/services/memory-application-service.js +190 -0
  106. package/dist/application/services/memory-application-service.js.map +1 -0
  107. package/dist/cache-manager.d.ts +134 -0
  108. package/dist/cache-manager.d.ts.map +1 -0
  109. package/dist/cache-manager.js +407 -0
  110. package/dist/cache-manager.js.map +1 -0
  111. package/dist/database-provider.d.ts +86 -0
  112. package/dist/database-provider.d.ts.map +1 -0
  113. package/dist/database-provider.js +385 -0
  114. package/dist/database-provider.js.map +1 -0
  115. package/dist/database-provider.test.d.ts +7 -0
  116. package/dist/database-provider.test.d.ts.map +1 -0
  117. package/dist/database-provider.test.js +285 -0
  118. package/dist/database-provider.test.js.map +1 -0
  119. package/dist/domain/entities/memory-entry.d.ts +143 -0
  120. package/dist/domain/entities/memory-entry.d.ts.map +1 -0
  121. package/dist/domain/entities/memory-entry.js +226 -0
  122. package/dist/domain/entities/memory-entry.js.map +1 -0
  123. package/dist/domain/index.d.ts +11 -0
  124. package/dist/domain/index.d.ts.map +1 -0
  125. package/dist/domain/index.js +12 -0
  126. package/dist/domain/index.js.map +1 -0
  127. package/dist/domain/repositories/memory-repository.interface.d.ts +102 -0
  128. package/dist/domain/repositories/memory-repository.interface.d.ts.map +1 -0
  129. package/dist/domain/repositories/memory-repository.interface.js +11 -0
  130. package/dist/domain/repositories/memory-repository.interface.js.map +1 -0
  131. package/dist/domain/services/memory-domain-service.d.ts +105 -0
  132. package/dist/domain/services/memory-domain-service.d.ts.map +1 -0
  133. package/dist/domain/services/memory-domain-service.js +297 -0
  134. package/dist/domain/services/memory-domain-service.js.map +1 -0
  135. package/dist/hnsw-index.d.ts +111 -0
  136. package/dist/hnsw-index.d.ts.map +1 -0
  137. package/dist/hnsw-index.js +781 -0
  138. package/dist/hnsw-index.js.map +1 -0
  139. package/dist/hybrid-backend.d.ts +217 -0
  140. package/dist/hybrid-backend.d.ts.map +1 -0
  141. package/dist/hybrid-backend.js +491 -0
  142. package/dist/hybrid-backend.js.map +1 -0
  143. package/dist/hybrid-backend.test.d.ts +8 -0
  144. package/dist/hybrid-backend.test.d.ts.map +1 -0
  145. package/dist/hybrid-backend.test.js +320 -0
  146. package/dist/hybrid-backend.test.js.map +1 -0
  147. package/dist/index.d.ts +188 -0
  148. package/dist/index.d.ts.map +1 -0
  149. package/dist/index.js +345 -0
  150. package/dist/index.js.map +1 -0
  151. package/dist/infrastructure/index.d.ts +17 -0
  152. package/dist/infrastructure/index.d.ts.map +1 -0
  153. package/dist/infrastructure/index.js +16 -0
  154. package/dist/infrastructure/index.js.map +1 -0
  155. package/dist/infrastructure/repositories/hybrid-memory-repository.d.ts +66 -0
  156. package/dist/infrastructure/repositories/hybrid-memory-repository.d.ts.map +1 -0
  157. package/dist/infrastructure/repositories/hybrid-memory-repository.js +409 -0
  158. package/dist/infrastructure/repositories/hybrid-memory-repository.js.map +1 -0
  159. package/dist/migration.d.ts +68 -0
  160. package/dist/migration.d.ts.map +1 -0
  161. package/dist/migration.js +513 -0
  162. package/dist/migration.js.map +1 -0
  163. package/dist/query-builder.d.ts +211 -0
  164. package/dist/query-builder.d.ts.map +1 -0
  165. package/dist/query-builder.js +438 -0
  166. package/dist/query-builder.js.map +1 -0
  167. package/dist/sqlite-backend.d.ts +121 -0
  168. package/dist/sqlite-backend.d.ts.map +1 -0
  169. package/dist/sqlite-backend.js +564 -0
  170. package/dist/sqlite-backend.js.map +1 -0
  171. package/dist/sqljs-backend.d.ts +128 -0
  172. package/dist/sqljs-backend.d.ts.map +1 -0
  173. package/dist/sqljs-backend.js +598 -0
  174. package/dist/sqljs-backend.js.map +1 -0
  175. package/dist/types.d.ts +481 -0
  176. package/dist/types.d.ts.map +1 -0
  177. package/dist/types.js +58 -0
  178. package/dist/types.js.map +1 -0
  179. package/docs/AGENTDB-INTEGRATION.md +388 -0
  180. package/docs/CROSS_PLATFORM.md +505 -0
  181. package/docs/WINDOWS_SUPPORT.md +422 -0
  182. package/examples/agentdb-example.ts +345 -0
  183. package/examples/cross-platform-usage.ts +326 -0
  184. package/framework/benchmark.ts +112 -0
  185. package/package.json +31 -0
  186. package/src/agentdb-adapter.ts +884 -0
  187. package/src/agentdb-backend.test.ts +339 -0
  188. package/src/agentdb-backend.ts +1016 -0
  189. package/src/application/commands/delete-memory.command.ts +172 -0
  190. package/src/application/commands/store-memory.command.ts +103 -0
  191. package/src/application/index.ts +36 -0
  192. package/src/application/queries/search-memory.query.ts +237 -0
  193. package/src/application/services/memory-application-service.ts +236 -0
  194. package/src/cache-manager.ts +516 -0
  195. package/src/database-provider.test.ts +364 -0
  196. package/src/database-provider.ts +511 -0
  197. package/src/domain/entities/memory-entry.ts +289 -0
  198. package/src/domain/index.ts +35 -0
  199. package/src/domain/repositories/memory-repository.interface.ts +120 -0
  200. package/src/domain/services/memory-domain-service.ts +403 -0
  201. package/src/hnsw-index.ts +1013 -0
  202. package/src/hybrid-backend.test.ts +399 -0
  203. package/src/hybrid-backend.ts +694 -0
  204. package/src/index.ts +515 -0
  205. package/src/infrastructure/index.ts +23 -0
  206. package/src/infrastructure/repositories/hybrid-memory-repository.ts +516 -0
  207. package/src/migration.ts +669 -0
  208. package/src/query-builder.ts +542 -0
  209. package/src/sqlite-backend.ts +732 -0
  210. package/src/sqljs-backend.ts +763 -0
  211. package/src/types.ts +727 -0
  212. package/tsconfig.json +9 -0
  213. package/tsconfig.tsbuildinfo +1 -0
  214. package/verify-cross-platform.ts +170 -0
@@ -0,0 +1,72 @@
1
+ /**
2
+ * Store Memory Command - Application Layer (CQRS)
3
+ *
4
+ * Command for storing a new memory entry.
5
+ * Implements CQRS pattern per ADR-002.
6
+ *
7
+ * @module v3/memory/application/commands
8
+ */
9
+ import { MemoryEntry } from '../../domain/entities/memory-entry.js';
10
+ /**
11
+ * Store Memory Command Handler
12
+ *
13
+ * Handles the command to store a memory entry.
14
+ * Coordinates between domain services and repository.
15
+ */
16
+ export class StoreMemoryCommandHandler {
17
+ repository;
18
+ domainService;
19
+ constructor(repository, domainService) {
20
+ this.repository = repository;
21
+ this.domainService = domainService;
22
+ }
23
+ /**
24
+ * Execute the store memory command
25
+ */
26
+ async execute(input) {
27
+ // Check if entry already exists
28
+ const existing = await this.repository.findByKey(input.namespace, input.key);
29
+ const isUpdate = existing !== null;
30
+ let entry;
31
+ if (existing) {
32
+ // Update existing entry
33
+ existing.updateValue(input.value);
34
+ if (input.vector) {
35
+ existing.updateVector(input.vector);
36
+ }
37
+ if (input.metadata) {
38
+ for (const [key, value] of Object.entries(input.metadata)) {
39
+ existing.setMetadata(key, value);
40
+ }
41
+ }
42
+ await this.repository.save(existing);
43
+ entry = existing;
44
+ }
45
+ else {
46
+ // Create new entry
47
+ if (input.type) {
48
+ entry = MemoryEntry.create({
49
+ namespace: input.namespace,
50
+ key: input.key,
51
+ value: input.value,
52
+ type: input.type,
53
+ vector: input.vector,
54
+ metadata: input.metadata,
55
+ ttl: input.ttl,
56
+ });
57
+ await this.repository.save(entry);
58
+ }
59
+ else {
60
+ // Use domain service for type detection
61
+ entry = await this.domainService.storeWithTypeDetection(input.namespace, input.key, input.value, input.vector);
62
+ }
63
+ }
64
+ return {
65
+ success: true,
66
+ entryId: entry.id,
67
+ entry,
68
+ isUpdate,
69
+ };
70
+ }
71
+ }
72
+ //# sourceMappingURL=store-memory.command.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"store-memory.command.js","sourceRoot":"","sources":["../../../src/application/commands/store-memory.command.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAc,MAAM,uCAAuC,CAAC;AA2BhF;;;;;GAKG;AACH,MAAM,OAAO,yBAAyB;IAEjB;IACA;IAFnB,YACmB,UAA6B,EAC7B,aAAkC;QADlC,eAAU,GAAV,UAAU,CAAmB;QAC7B,kBAAa,GAAb,aAAa,CAAqB;IAClD,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,OAAO,CAAC,KAAuB;QACnC,gCAAgC;QAChC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7E,MAAM,QAAQ,GAAG,QAAQ,KAAK,IAAI,CAAC;QAEnC,IAAI,KAAkB,CAAC;QAEvB,IAAI,QAAQ,EAAE,CAAC;YACb,wBAAwB;YACxB,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAClC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjB,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACtC,CAAC;YACD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACnB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAC1D,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;YACD,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACrC,KAAK,GAAG,QAAQ,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,mBAAmB;YACnB,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBACf,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC;oBACzB,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,GAAG,EAAE,KAAK,CAAC,GAAG;oBACd,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;oBACxB,GAAG,EAAE,KAAK,CAAC,GAAG;iBACf,CAAC,CAAC;gBACH,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,wCAAwC;gBACxC,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,sBAAsB,CACrD,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,GAAG,EACT,KAAK,CAAC,KAAK,EACX,KAAK,CAAC,MAAM,CACb,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,KAAK,CAAC,EAAE;YACjB,KAAK;YACL,QAAQ;SACT,CAAC;IACJ,CAAC;CACF"}
@@ -0,0 +1,12 @@
1
+ /**
2
+ * Memory Application Layer - Public Exports
3
+ *
4
+ * Exports all application services, commands, and queries.
5
+ *
6
+ * @module v3/memory/application
7
+ */
8
+ export { StoreMemoryCommandHandler, type StoreMemoryInput, type StoreMemoryResult, } from './commands/store-memory.command.js';
9
+ export { DeleteMemoryCommandHandler, BulkDeleteMemoryCommandHandler, type DeleteMemoryInput, type DeleteMemoryResult, type BulkDeleteMemoryInput, type BulkDeleteMemoryResult, } from './commands/delete-memory.command.js';
10
+ export { SearchMemoryQueryHandler, GetMemoryByKeyQueryHandler, type SearchMemoryInput, type SearchMemoryResult, type GetMemoryByKeyInput, type GetMemoryByKeyResult, } from './queries/search-memory.query.js';
11
+ export { MemoryApplicationService } from './services/memory-application-service.js';
12
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/application/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,yBAAyB,EACzB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,EAC9B,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,qCAAqC,CAAC;AAG7C,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,kCAAkC,CAAC;AAG1C,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC"}
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Memory Application Layer - Public Exports
3
+ *
4
+ * Exports all application services, commands, and queries.
5
+ *
6
+ * @module v3/memory/application
7
+ */
8
+ // Commands
9
+ export { StoreMemoryCommandHandler, } from './commands/store-memory.command.js';
10
+ export { DeleteMemoryCommandHandler, BulkDeleteMemoryCommandHandler, } from './commands/delete-memory.command.js';
11
+ // Queries
12
+ export { SearchMemoryQueryHandler, GetMemoryByKeyQueryHandler, } from './queries/search-memory.query.js';
13
+ // Application Service
14
+ export { MemoryApplicationService } from './services/memory-application-service.js';
15
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/application/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,WAAW;AACX,OAAO,EACL,yBAAyB,GAG1B,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,GAK/B,MAAM,qCAAqC,CAAC;AAE7C,UAAU;AACV,OAAO,EACL,wBAAwB,EACxB,0BAA0B,GAK3B,MAAM,kCAAkC,CAAC;AAE1C,sBAAsB;AACtB,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC"}
@@ -0,0 +1,72 @@
1
+ /**
2
+ * Search Memory Query - Application Layer (CQRS)
3
+ *
4
+ * Query for searching memory entries.
5
+ * Supports text search, vector search, and filtering.
6
+ *
7
+ * @module v3/memory/application/queries
8
+ */
9
+ import { MemoryEntry, MemoryType, MemoryStatus } from '../../domain/entities/memory-entry.js';
10
+ import { IMemoryRepository } from '../../domain/repositories/memory-repository.interface.js';
11
+ /**
12
+ * Search Memory Query Input
13
+ */
14
+ export interface SearchMemoryInput {
15
+ vector?: Float32Array;
16
+ similarityThreshold?: number;
17
+ namespace?: string;
18
+ type?: MemoryType;
19
+ status?: MemoryStatus;
20
+ limit?: number;
21
+ offset?: number;
22
+ orderBy?: 'createdAt' | 'updatedAt' | 'accessCount' | 'lastAccessedAt';
23
+ orderDirection?: 'asc' | 'desc';
24
+ textQuery?: string;
25
+ trackAccess?: boolean;
26
+ }
27
+ /**
28
+ * Search Memory Query Result
29
+ */
30
+ export interface SearchMemoryResult {
31
+ entries: MemoryEntry[];
32
+ total: number;
33
+ hasMore: boolean;
34
+ searchType: 'vector' | 'filter' | 'text';
35
+ similarities?: number[];
36
+ }
37
+ /**
38
+ * Search Memory Query Handler
39
+ */
40
+ export declare class SearchMemoryQueryHandler {
41
+ private readonly repository;
42
+ constructor(repository: IMemoryRepository);
43
+ execute(input: SearchMemoryInput): Promise<SearchMemoryResult>;
44
+ private executeVectorSearch;
45
+ private executeTextSearch;
46
+ private executeFilterSearch;
47
+ private trackEntryAccess;
48
+ }
49
+ /**
50
+ * Get Memory By Key Query Input
51
+ */
52
+ export interface GetMemoryByKeyInput {
53
+ namespace: string;
54
+ key: string;
55
+ trackAccess?: boolean;
56
+ }
57
+ /**
58
+ * Get Memory By Key Query Result
59
+ */
60
+ export interface GetMemoryByKeyResult {
61
+ found: boolean;
62
+ entry?: MemoryEntry;
63
+ }
64
+ /**
65
+ * Get Memory By Key Query Handler
66
+ */
67
+ export declare class GetMemoryByKeyQueryHandler {
68
+ private readonly repository;
69
+ constructor(repository: IMemoryRepository);
70
+ execute(input: GetMemoryByKeyInput): Promise<GetMemoryByKeyResult>;
71
+ }
72
+ //# sourceMappingURL=search-memory.query.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"search-memory.query.d.ts","sourceRoot":"","sources":["../../../src/application/queries/search-memory.query.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC9F,OAAO,EACL,iBAAiB,EAGlB,MAAM,0DAA0D,CAAC;AAElE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAEhC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAG7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,MAAM,CAAC,EAAE,YAAY,CAAC;IAGtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,OAAO,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,aAAa,GAAG,gBAAgB,CAAC;IACvE,cAAc,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAGhC,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IACzC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,wBAAwB;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,iBAAiB;IAEpD,OAAO,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;YAkBtD,mBAAmB;YA8BnB,iBAAiB;YAwCjB,mBAAmB;YAmCnB,gBAAgB;CAM/B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,0BAA0B;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,iBAAiB;IAEpD,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAqBzE"}
@@ -0,0 +1,143 @@
1
+ /**
2
+ * Search Memory Query - Application Layer (CQRS)
3
+ *
4
+ * Query for searching memory entries.
5
+ * Supports text search, vector search, and filtering.
6
+ *
7
+ * @module v3/memory/application/queries
8
+ */
9
+ /**
10
+ * Search Memory Query Handler
11
+ */
12
+ export class SearchMemoryQueryHandler {
13
+ repository;
14
+ constructor(repository) {
15
+ this.repository = repository;
16
+ }
17
+ async execute(input) {
18
+ const limit = input.limit ?? 10;
19
+ const offset = input.offset ?? 0;
20
+ // Vector search takes precedence
21
+ if (input.vector) {
22
+ return this.executeVectorSearch(input, limit, offset);
23
+ }
24
+ // Text search
25
+ if (input.textQuery) {
26
+ return this.executeTextSearch(input, limit, offset);
27
+ }
28
+ // Filter-based search
29
+ return this.executeFilterSearch(input, limit, offset);
30
+ }
31
+ async executeVectorSearch(input, limit, offset) {
32
+ const results = await this.repository.searchByVector({
33
+ vector: input.vector,
34
+ namespace: input.namespace,
35
+ limit: limit + offset, // Get extra for pagination
36
+ threshold: input.similarityThreshold ?? 0.5,
37
+ type: input.type,
38
+ });
39
+ // Apply offset
40
+ const paginatedResults = results.slice(offset, offset + limit);
41
+ // Track access if requested
42
+ if (input.trackAccess) {
43
+ await this.trackEntryAccess(paginatedResults.map((r) => r.entry));
44
+ }
45
+ return {
46
+ entries: paginatedResults.map((r) => r.entry),
47
+ total: results.length,
48
+ hasMore: results.length > offset + limit,
49
+ searchType: 'vector',
50
+ similarities: paginatedResults.map((r) => r.similarity),
51
+ };
52
+ }
53
+ async executeTextSearch(input, limit, offset) {
54
+ // Get all entries matching filters
55
+ const options = {
56
+ namespace: input.namespace,
57
+ type: input.type,
58
+ status: input.status ?? 'active',
59
+ orderBy: input.orderBy ?? 'createdAt',
60
+ orderDirection: input.orderDirection ?? 'desc',
61
+ };
62
+ const allEntries = await this.repository.findAll(options);
63
+ // Filter by text query
64
+ const query = input.textQuery.toLowerCase();
65
+ const matchingEntries = allEntries.filter((entry) => {
66
+ const valueStr = JSON.stringify(entry.value).toLowerCase();
67
+ const metadataStr = JSON.stringify(entry.metadata).toLowerCase();
68
+ return valueStr.includes(query) || metadataStr.includes(query);
69
+ });
70
+ // Paginate
71
+ const paginatedEntries = matchingEntries.slice(offset, offset + limit);
72
+ // Track access if requested
73
+ if (input.trackAccess) {
74
+ await this.trackEntryAccess(paginatedEntries);
75
+ }
76
+ return {
77
+ entries: paginatedEntries,
78
+ total: matchingEntries.length,
79
+ hasMore: matchingEntries.length > offset + limit,
80
+ searchType: 'text',
81
+ };
82
+ }
83
+ async executeFilterSearch(input, limit, offset) {
84
+ const options = {
85
+ namespace: input.namespace,
86
+ type: input.type,
87
+ status: input.status ?? 'active',
88
+ limit,
89
+ offset,
90
+ orderBy: input.orderBy ?? 'createdAt',
91
+ orderDirection: input.orderDirection ?? 'desc',
92
+ };
93
+ const entries = await this.repository.findAll(options);
94
+ const total = await this.repository.count({
95
+ namespace: input.namespace,
96
+ type: input.type,
97
+ status: input.status ?? 'active',
98
+ });
99
+ // Track access if requested
100
+ if (input.trackAccess) {
101
+ await this.trackEntryAccess(entries);
102
+ }
103
+ return {
104
+ entries,
105
+ total,
106
+ hasMore: total > offset + limit,
107
+ searchType: 'filter',
108
+ };
109
+ }
110
+ async trackEntryAccess(entries) {
111
+ for (const entry of entries) {
112
+ entry.recordAccess();
113
+ await this.repository.save(entry);
114
+ }
115
+ }
116
+ }
117
+ /**
118
+ * Get Memory By Key Query Handler
119
+ */
120
+ export class GetMemoryByKeyQueryHandler {
121
+ repository;
122
+ constructor(repository) {
123
+ this.repository = repository;
124
+ }
125
+ async execute(input) {
126
+ const entry = await this.repository.findByKey(input.namespace, input.key);
127
+ if (!entry) {
128
+ return { found: false };
129
+ }
130
+ if (!entry.isAccessible()) {
131
+ return { found: false };
132
+ }
133
+ if (input.trackAccess) {
134
+ entry.recordAccess();
135
+ await this.repository.save(entry);
136
+ }
137
+ return {
138
+ found: true,
139
+ entry,
140
+ };
141
+ }
142
+ }
143
+ //# sourceMappingURL=search-memory.query.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"search-memory.query.js","sourceRoot":"","sources":["../../../src/application/queries/search-memory.query.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgDH;;GAEG;AACH,MAAM,OAAO,wBAAwB;IACN;IAA7B,YAA6B,UAA6B;QAA7B,eAAU,GAAV,UAAU,CAAmB;IAAG,CAAC;IAE9D,KAAK,CAAC,OAAO,CAAC,KAAwB;QACpC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;QAEjC,iCAAiC;QACjC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACxD,CAAC;QAED,cAAc;QACd,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACtD,CAAC;QAED,sBAAsB;QACtB,OAAO,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACxD,CAAC;IAEO,KAAK,CAAC,mBAAmB,CAC/B,KAAwB,EACxB,KAAa,EACb,MAAc;QAEd,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;YACnD,MAAM,EAAE,KAAK,CAAC,MAAO;YACrB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,2BAA2B;YAClD,SAAS,EAAE,KAAK,CAAC,mBAAmB,IAAI,GAAG;YAC3C,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC,CAAC;QAEH,eAAe;QACf,MAAM,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;QAE/D,4BAA4B;QAC5B,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACpE,CAAC;QAED,OAAO;YACL,OAAO,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;YAC7C,KAAK,EAAE,OAAO,CAAC,MAAM;YACrB,OAAO,EAAE,OAAO,CAAC,MAAM,GAAG,MAAM,GAAG,KAAK;YACxC,UAAU,EAAE,QAAQ;YACpB,YAAY,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;SACxD,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAC7B,KAAwB,EACxB,KAAa,EACb,MAAc;QAEd,mCAAmC;QACnC,MAAM,OAAO,GAAuB;YAClC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,QAAQ;YAChC,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,WAAW;YACrC,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,MAAM;SAC/C,CAAC;QAEF,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE1D,uBAAuB;QACvB,MAAM,KAAK,GAAG,KAAK,CAAC,SAAU,CAAC,WAAW,EAAE,CAAC;QAC7C,MAAM,eAAe,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;YAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;YAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;YACjE,OAAO,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;QAEH,WAAW;QACX,MAAM,gBAAgB,GAAG,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;QAEvE,4BAA4B;QAC5B,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;QAChD,CAAC;QAED,OAAO;YACL,OAAO,EAAE,gBAAgB;YACzB,KAAK,EAAE,eAAe,CAAC,MAAM;YAC7B,OAAO,EAAE,eAAe,CAAC,MAAM,GAAG,MAAM,GAAG,KAAK;YAChD,UAAU,EAAE,MAAM;SACnB,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,mBAAmB,CAC/B,KAAwB,EACxB,KAAa,EACb,MAAc;QAEd,MAAM,OAAO,GAAuB;YAClC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,QAAQ;YAChC,KAAK;YACL,MAAM;YACN,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,WAAW;YACrC,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,MAAM;SAC/C,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;YACxC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,QAAQ;SACjC,CAAC,CAAC;QAEH,4BAA4B;QAC5B,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;QAED,OAAO;YACL,OAAO;YACP,KAAK;YACL,OAAO,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK;YAC/B,UAAU,EAAE,QAAQ;SACrB,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,OAAsB;QACnD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,KAAK,CAAC,YAAY,EAAE,CAAC;YACrB,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;CACF;AAmBD;;GAEG;AACH,MAAM,OAAO,0BAA0B;IACR;IAA7B,YAA6B,UAA6B;QAA7B,eAAU,GAAV,UAAU,CAAmB;IAAG,CAAC;IAE9D,KAAK,CAAC,OAAO,CAAC,KAA0B;QACtC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAE1E,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC1B,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,CAAC;YAC1B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC1B,CAAC;QAED,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,KAAK,CAAC,YAAY,EAAE,CAAC;YACrB,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QAED,OAAO;YACL,KAAK,EAAE,IAAI;YACX,KAAK;SACN,CAAC;IACJ,CAAC;CACF"}
@@ -0,0 +1,121 @@
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
+ import { MemoryEntry, MemoryType } from '../../domain/entities/memory-entry.js';
10
+ import { IMemoryRepository, VectorSearchResult, MemoryStatistics } from '../../domain/repositories/memory-repository.interface.js';
11
+ import { ConsolidationOptions, ConsolidationResult } from '../../domain/services/memory-domain-service.js';
12
+ import { StoreMemoryInput } from '../commands/store-memory.command.js';
13
+ import { SearchMemoryInput } from '../queries/search-memory.query.js';
14
+ /**
15
+ * Memory Application Service
16
+ *
17
+ * Main entry point for memory operations.
18
+ * Coordinates commands and queries with domain services.
19
+ */
20
+ export declare class MemoryApplicationService {
21
+ private readonly repository;
22
+ private readonly domainService;
23
+ private readonly storeHandler;
24
+ private readonly deleteHandler;
25
+ private readonly bulkDeleteHandler;
26
+ private readonly searchHandler;
27
+ private readonly getByKeyHandler;
28
+ constructor(repository: IMemoryRepository);
29
+ /**
30
+ * Store a memory entry
31
+ */
32
+ store(input: StoreMemoryInput): Promise<MemoryEntry>;
33
+ /**
34
+ * Store multiple memory entries
35
+ */
36
+ storeMany(inputs: StoreMemoryInput[]): Promise<MemoryEntry[]>;
37
+ /**
38
+ * Get a memory entry by namespace and key
39
+ */
40
+ get(namespace: string, key: string): Promise<MemoryEntry | null>;
41
+ /**
42
+ * Get a memory entry by ID
43
+ */
44
+ getById(id: string): Promise<MemoryEntry | null>;
45
+ /**
46
+ * Search memory entries
47
+ */
48
+ search(input: SearchMemoryInput): Promise<{
49
+ entries: MemoryEntry[];
50
+ total: number;
51
+ hasMore: boolean;
52
+ }>;
53
+ /**
54
+ * Search by vector similarity
55
+ */
56
+ searchByVector(vector: Float32Array, options?: {
57
+ namespace?: string;
58
+ limit?: number;
59
+ threshold?: number;
60
+ }): Promise<VectorSearchResult[]>;
61
+ /**
62
+ * Get all entries in a namespace
63
+ */
64
+ getNamespace(namespace: string): Promise<MemoryEntry[]>;
65
+ /**
66
+ * List all namespaces
67
+ */
68
+ listNamespaces(): Promise<string[]>;
69
+ /**
70
+ * Delete a memory entry by namespace and key
71
+ */
72
+ delete(namespace: string, key: string, hardDelete?: boolean): Promise<boolean>;
73
+ /**
74
+ * Delete a memory entry by ID
75
+ */
76
+ deleteById(id: string, hardDelete?: boolean): Promise<boolean>;
77
+ /**
78
+ * Delete all entries in a namespace
79
+ */
80
+ deleteNamespace(namespace: string, hardDelete?: boolean): Promise<number>;
81
+ /**
82
+ * Clear all memory entries
83
+ */
84
+ clear(): Promise<void>;
85
+ /**
86
+ * Consolidate memories using specified strategy
87
+ */
88
+ consolidate(options: ConsolidationOptions): Promise<ConsolidationResult>;
89
+ /**
90
+ * Clean up expired memories
91
+ */
92
+ cleanupExpired(): Promise<number>;
93
+ /**
94
+ * Archive cold (rarely accessed) memories
95
+ */
96
+ archiveCold(milliseconds?: number): Promise<number>;
97
+ /**
98
+ * Get memory statistics
99
+ */
100
+ getStatistics(): Promise<MemoryStatistics>;
101
+ /**
102
+ * Count entries matching criteria
103
+ */
104
+ count(options?: {
105
+ namespace?: string;
106
+ type?: MemoryType;
107
+ }): Promise<number>;
108
+ /**
109
+ * Analyze a namespace
110
+ */
111
+ analyzeNamespace(namespace: string): Promise<import("../../domain/index.js").NamespaceAnalysis>;
112
+ /**
113
+ * Initialize the memory service
114
+ */
115
+ initialize(): Promise<void>;
116
+ /**
117
+ * Shutdown the memory service
118
+ */
119
+ shutdown(): Promise<void>;
120
+ }
121
+ //# sourceMappingURL=memory-application-service.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memory-application-service.d.ts","sourceRoot":"","sources":["../../../src/application/services/memory-application-service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,190 @@
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
+ import { MemoryDomainService } from '../../domain/services/memory-domain-service.js';
10
+ import { StoreMemoryCommandHandler } from '../commands/store-memory.command.js';
11
+ import { DeleteMemoryCommandHandler, BulkDeleteMemoryCommandHandler } from '../commands/delete-memory.command.js';
12
+ import { SearchMemoryQueryHandler, GetMemoryByKeyQueryHandler } from '../queries/search-memory.query.js';
13
+ /**
14
+ * Memory Application Service
15
+ *
16
+ * Main entry point for memory operations.
17
+ * Coordinates commands and queries with domain services.
18
+ */
19
+ export class MemoryApplicationService {
20
+ repository;
21
+ domainService;
22
+ storeHandler;
23
+ deleteHandler;
24
+ bulkDeleteHandler;
25
+ searchHandler;
26
+ getByKeyHandler;
27
+ constructor(repository) {
28
+ this.repository = repository;
29
+ this.domainService = new MemoryDomainService(repository);
30
+ this.storeHandler = new StoreMemoryCommandHandler(repository, this.domainService);
31
+ this.deleteHandler = new DeleteMemoryCommandHandler(repository);
32
+ this.bulkDeleteHandler = new BulkDeleteMemoryCommandHandler(repository);
33
+ this.searchHandler = new SearchMemoryQueryHandler(repository);
34
+ this.getByKeyHandler = new GetMemoryByKeyQueryHandler(repository);
35
+ }
36
+ // ============================================================================
37
+ // Store Operations (Commands)
38
+ // ============================================================================
39
+ /**
40
+ * Store a memory entry
41
+ */
42
+ async store(input) {
43
+ const result = await this.storeHandler.execute(input);
44
+ return result.entry;
45
+ }
46
+ /**
47
+ * Store multiple memory entries
48
+ */
49
+ async storeMany(inputs) {
50
+ const results = await Promise.all(inputs.map((input) => this.storeHandler.execute(input)));
51
+ return results.map((r) => r.entry);
52
+ }
53
+ // ============================================================================
54
+ // Retrieve Operations (Queries)
55
+ // ============================================================================
56
+ /**
57
+ * Get a memory entry by namespace and key
58
+ */
59
+ async get(namespace, key) {
60
+ const result = await this.getByKeyHandler.execute({ namespace, key, trackAccess: true });
61
+ return result.entry ?? null;
62
+ }
63
+ /**
64
+ * Get a memory entry by ID
65
+ */
66
+ async getById(id) {
67
+ return this.repository.findById(id);
68
+ }
69
+ /**
70
+ * Search memory entries
71
+ */
72
+ async search(input) {
73
+ const result = await this.searchHandler.execute(input);
74
+ return {
75
+ entries: result.entries,
76
+ total: result.total,
77
+ hasMore: result.hasMore,
78
+ };
79
+ }
80
+ /**
81
+ * Search by vector similarity
82
+ */
83
+ async searchByVector(vector, options) {
84
+ return this.domainService.searchSimilarWithTracking(vector, options?.namespace, options?.limit ?? 10);
85
+ }
86
+ /**
87
+ * Get all entries in a namespace
88
+ */
89
+ async getNamespace(namespace) {
90
+ return this.repository.findByNamespace(namespace, { status: 'active' });
91
+ }
92
+ /**
93
+ * List all namespaces
94
+ */
95
+ async listNamespaces() {
96
+ return this.repository.listNamespaces();
97
+ }
98
+ // ============================================================================
99
+ // Delete Operations (Commands)
100
+ // ============================================================================
101
+ /**
102
+ * Delete a memory entry by namespace and key
103
+ */
104
+ async delete(namespace, key, hardDelete = false) {
105
+ const result = await this.deleteHandler.execute({ namespace, key, hardDelete });
106
+ return result.deleted;
107
+ }
108
+ /**
109
+ * Delete a memory entry by ID
110
+ */
111
+ async deleteById(id, hardDelete = false) {
112
+ const result = await this.deleteHandler.execute({ id, hardDelete });
113
+ return result.deleted;
114
+ }
115
+ /**
116
+ * Delete all entries in a namespace
117
+ */
118
+ async deleteNamespace(namespace, hardDelete = false) {
119
+ const entries = await this.repository.findByNamespace(namespace);
120
+ const result = await this.bulkDeleteHandler.execute({
121
+ ids: entries.map((e) => e.id),
122
+ hardDelete,
123
+ });
124
+ return result.deletedCount;
125
+ }
126
+ /**
127
+ * Clear all memory entries
128
+ */
129
+ async clear() {
130
+ await this.repository.clear();
131
+ }
132
+ // ============================================================================
133
+ // Maintenance Operations
134
+ // ============================================================================
135
+ /**
136
+ * Consolidate memories using specified strategy
137
+ */
138
+ async consolidate(options) {
139
+ return this.domainService.consolidate(options);
140
+ }
141
+ /**
142
+ * Clean up expired memories
143
+ */
144
+ async cleanupExpired() {
145
+ return this.repository.deleteExpired();
146
+ }
147
+ /**
148
+ * Archive cold (rarely accessed) memories
149
+ */
150
+ async archiveCold(milliseconds = 86400000) {
151
+ return this.repository.archiveCold(milliseconds);
152
+ }
153
+ // ============================================================================
154
+ // Statistics
155
+ // ============================================================================
156
+ /**
157
+ * Get memory statistics
158
+ */
159
+ async getStatistics() {
160
+ return this.repository.getStatistics();
161
+ }
162
+ /**
163
+ * Count entries matching criteria
164
+ */
165
+ async count(options) {
166
+ return this.repository.count(options);
167
+ }
168
+ /**
169
+ * Analyze a namespace
170
+ */
171
+ async analyzeNamespace(namespace) {
172
+ return this.domainService.analyzeNamespace(namespace);
173
+ }
174
+ // ============================================================================
175
+ // Lifecycle
176
+ // ============================================================================
177
+ /**
178
+ * Initialize the memory service
179
+ */
180
+ async initialize() {
181
+ await this.repository.initialize();
182
+ }
183
+ /**
184
+ * Shutdown the memory service
185
+ */
186
+ async shutdown() {
187
+ await this.repository.shutdown();
188
+ }
189
+ }
190
+ //# sourceMappingURL=memory-application-service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memory-application-service.js","sourceRoot":"","sources":["../../../src/application/services/memory-application-service.ts"],"names":[],"mappings":"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"}