@zooique/memora 2.0.0 → 3.0.0

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 (588) hide show
  1. package/CHANGELOG.md +1028 -0
  2. package/README.en.md +305 -0
  3. package/README.md +303 -148
  4. package/config.example.json +43 -0
  5. package/dist/agent/agent.d.ts +438 -295
  6. package/dist/agent/agent.d.ts.map +1 -1
  7. package/dist/agent/agent.js +1368 -836
  8. package/dist/agent/agent.js.map +1 -1
  9. package/dist/agent/assembler.d.ts +117 -39
  10. package/dist/agent/assembler.d.ts.map +1 -1
  11. package/dist/agent/assembler.js +574 -71
  12. package/dist/agent/assembler.js.map +1 -1
  13. package/dist/agent/budget.d.ts +131 -0
  14. package/dist/agent/budget.d.ts.map +1 -0
  15. package/dist/agent/budget.js +128 -0
  16. package/dist/agent/budget.js.map +1 -0
  17. package/dist/agent/builtinToolHandlers.d.ts +229 -17
  18. package/dist/agent/builtinToolHandlers.d.ts.map +1 -1
  19. package/dist/agent/builtinToolHandlers.js +758 -70
  20. package/dist/agent/builtinToolHandlers.js.map +1 -1
  21. package/dist/agent/builtinTools.d.ts +198 -7
  22. package/dist/agent/builtinTools.d.ts.map +1 -1
  23. package/dist/agent/builtinTools.js +646 -14
  24. package/dist/agent/builtinTools.js.map +1 -1
  25. package/dist/agent/compaction.d.ts +93 -0
  26. package/dist/agent/compaction.d.ts.map +1 -0
  27. package/dist/agent/compaction.js +192 -0
  28. package/dist/agent/compaction.js.map +1 -0
  29. package/dist/agent/constants.d.ts +139 -18
  30. package/dist/agent/constants.d.ts.map +1 -1
  31. package/dist/agent/constants.js +154 -18
  32. package/dist/agent/constants.js.map +1 -1
  33. package/dist/agent/contextManager.d.ts +126 -76
  34. package/dist/agent/contextManager.d.ts.map +1 -1
  35. package/dist/agent/contextManager.js +197 -135
  36. package/dist/agent/contextManager.js.map +1 -1
  37. package/dist/agent/contextPreparer.d.ts +78 -0
  38. package/dist/agent/contextPreparer.d.ts.map +1 -0
  39. package/dist/agent/contextPreparer.js +128 -0
  40. package/dist/agent/contextPreparer.js.map +1 -0
  41. package/dist/agent/duplicateInterceptor.d.ts +67 -0
  42. package/dist/agent/duplicateInterceptor.d.ts.map +1 -0
  43. package/dist/agent/duplicateInterceptor.js +82 -0
  44. package/dist/agent/duplicateInterceptor.js.map +1 -0
  45. package/dist/agent/guardRail.d.ts +166 -0
  46. package/dist/agent/guardRail.d.ts.map +1 -0
  47. package/dist/agent/guardRail.js +333 -0
  48. package/dist/agent/guardRail.js.map +1 -0
  49. package/dist/agent/loop.d.ts +718 -253
  50. package/dist/agent/loop.d.ts.map +1 -1
  51. package/dist/agent/loop.js +2215 -648
  52. package/dist/agent/loop.js.map +1 -1
  53. package/dist/agent/managers/archiveCoordinator.d.ts +21 -74
  54. package/dist/agent/managers/archiveCoordinator.d.ts.map +1 -1
  55. package/dist/agent/managers/archiveCoordinator.js +32 -105
  56. package/dist/agent/managers/archiveCoordinator.js.map +1 -1
  57. package/dist/agent/managers/chatLockManager.d.ts +20 -88
  58. package/dist/agent/managers/chatLockManager.d.ts.map +1 -1
  59. package/dist/agent/managers/chatLockManager.js +31 -103
  60. package/dist/agent/managers/chatLockManager.js.map +1 -1
  61. package/dist/agent/managers/dedupManager.d.ts +85 -0
  62. package/dist/agent/managers/dedupManager.d.ts.map +1 -0
  63. package/dist/agent/managers/dedupManager.js +248 -0
  64. package/dist/agent/managers/dedupManager.js.map +1 -0
  65. package/dist/agent/managers/goalConsistencyChecker.d.ts +42 -0
  66. package/dist/agent/managers/goalConsistencyChecker.d.ts.map +1 -0
  67. package/dist/agent/managers/goalConsistencyChecker.js +178 -0
  68. package/dist/agent/managers/goalConsistencyChecker.js.map +1 -0
  69. package/dist/agent/managers/llmCaller.d.ts +124 -0
  70. package/dist/agent/managers/llmCaller.d.ts.map +1 -0
  71. package/dist/agent/managers/llmCaller.js +417 -0
  72. package/dist/agent/managers/llmCaller.js.map +1 -0
  73. package/dist/agent/managers/llmJudgeHelper.d.ts +21 -0
  74. package/dist/agent/managers/llmJudgeHelper.d.ts.map +1 -0
  75. package/dist/agent/managers/llmJudgeHelper.js +32 -0
  76. package/dist/agent/managers/llmJudgeHelper.js.map +1 -0
  77. package/dist/agent/managers/loopMetrics.d.ts +58 -0
  78. package/dist/agent/managers/loopMetrics.d.ts.map +1 -0
  79. package/dist/agent/managers/loopMetrics.js +68 -0
  80. package/dist/agent/managers/loopMetrics.js.map +1 -0
  81. package/dist/agent/managers/memoryAdvisor.d.ts +27 -120
  82. package/dist/agent/managers/memoryAdvisor.d.ts.map +1 -1
  83. package/dist/agent/managers/memoryAdvisor.js +56 -192
  84. package/dist/agent/managers/memoryAdvisor.js.map +1 -1
  85. package/dist/agent/managers/memoryGovernance.d.ts +24 -0
  86. package/dist/agent/managers/memoryGovernance.d.ts.map +1 -0
  87. package/dist/agent/managers/memoryGovernance.js +46 -0
  88. package/dist/agent/managers/memoryGovernance.js.map +1 -0
  89. package/dist/agent/managers/memoryInspector.d.ts +59 -393
  90. package/dist/agent/managers/memoryInspector.d.ts.map +1 -1
  91. package/dist/agent/managers/memoryInspector.js +92 -736
  92. package/dist/agent/managers/memoryInspector.js.map +1 -1
  93. package/dist/agent/managers/roundSummaryGenerator.d.ts +56 -0
  94. package/dist/agent/managers/roundSummaryGenerator.d.ts.map +1 -0
  95. package/dist/agent/managers/roundSummaryGenerator.js +201 -0
  96. package/dist/agent/managers/roundSummaryGenerator.js.map +1 -0
  97. package/dist/agent/managers/sessionArchiver.d.ts +19 -63
  98. package/dist/agent/managers/sessionArchiver.d.ts.map +1 -1
  99. package/dist/agent/managers/sessionArchiver.js +83 -157
  100. package/dist/agent/managers/sessionArchiver.js.map +1 -1
  101. package/dist/agent/managers/sessionManager.d.ts +286 -57
  102. package/dist/agent/managers/sessionManager.d.ts.map +1 -1
  103. package/dist/agent/managers/sessionManager.js +846 -85
  104. package/dist/agent/managers/sessionManager.js.map +1 -1
  105. package/dist/agent/managers/sessionNamer.d.ts +35 -0
  106. package/dist/agent/managers/sessionNamer.d.ts.map +1 -0
  107. package/dist/agent/managers/sessionNamer.js +104 -0
  108. package/dist/agent/managers/sessionNamer.js.map +1 -0
  109. package/dist/agent/managers/streamAccumulator.d.ts +20 -0
  110. package/dist/agent/managers/streamAccumulator.d.ts.map +1 -0
  111. package/dist/agent/managers/streamAccumulator.js +15 -0
  112. package/dist/agent/managers/streamAccumulator.js.map +1 -0
  113. package/dist/agent/managers/textPolishManager.d.ts +8 -44
  114. package/dist/agent/managers/textPolishManager.d.ts.map +1 -1
  115. package/dist/agent/managers/textPolishManager.js +12 -47
  116. package/dist/agent/managers/textPolishManager.js.map +1 -1
  117. package/dist/agent/managers/toolCallHelpers.d.ts +105 -0
  118. package/dist/agent/managers/toolCallHelpers.d.ts.map +1 -0
  119. package/dist/agent/managers/toolCallHelpers.js +161 -0
  120. package/dist/agent/managers/toolCallHelpers.js.map +1 -0
  121. package/dist/agent/managers/workProjection.d.ts +57 -87
  122. package/dist/agent/managers/workProjection.d.ts.map +1 -1
  123. package/dist/agent/managers/workProjection.js +166 -246
  124. package/dist/agent/managers/workProjection.js.map +1 -1
  125. package/dist/agent/messageHistory.d.ts +134 -84
  126. package/dist/agent/messageHistory.d.ts.map +1 -1
  127. package/dist/agent/messageHistory.js +419 -133
  128. package/dist/agent/messageHistory.js.map +1 -1
  129. package/dist/agent/needsPlanning.d.ts +28 -0
  130. package/dist/agent/needsPlanning.d.ts.map +1 -0
  131. package/dist/agent/needsPlanning.js +68 -0
  132. package/dist/agent/needsPlanning.js.map +1 -0
  133. package/dist/agent/seed/index.d.ts +11 -0
  134. package/dist/agent/seed/index.d.ts.map +1 -0
  135. package/dist/agent/seed/index.js +10 -0
  136. package/dist/agent/seed/index.js.map +1 -0
  137. package/dist/agent/seed/orchestrator.d.ts +83 -0
  138. package/dist/agent/seed/orchestrator.d.ts.map +1 -0
  139. package/dist/agent/seed/orchestrator.js +260 -0
  140. package/dist/agent/seed/orchestrator.js.map +1 -0
  141. package/dist/agent/seed/prepare.d.ts +49 -0
  142. package/dist/agent/seed/prepare.d.ts.map +1 -0
  143. package/dist/agent/seed/prepare.js +107 -0
  144. package/dist/agent/seed/prepare.js.map +1 -0
  145. package/dist/agent/seed/types.d.ts +115 -0
  146. package/dist/agent/seed/types.d.ts.map +1 -0
  147. package/dist/agent/seed/types.js +15 -0
  148. package/dist/agent/seed/types.js.map +1 -0
  149. package/dist/agent/sessionStateMachine.d.ts +78 -0
  150. package/dist/agent/sessionStateMachine.d.ts.map +1 -0
  151. package/dist/agent/sessionStateMachine.js +182 -0
  152. package/dist/agent/sessionStateMachine.js.map +1 -0
  153. package/dist/agent/taskTableRenderer.d.ts +51 -0
  154. package/dist/agent/taskTableRenderer.d.ts.map +1 -0
  155. package/dist/agent/taskTableRenderer.js +115 -0
  156. package/dist/agent/taskTableRenderer.js.map +1 -0
  157. package/dist/agent/toolExecutor.d.ts +255 -9
  158. package/dist/agent/toolExecutor.d.ts.map +1 -1
  159. package/dist/agent/toolExecutor.js +956 -20
  160. package/dist/agent/toolExecutor.js.map +1 -1
  161. package/dist/agent/toolLedger.d.ts +120 -0
  162. package/dist/agent/toolLedger.d.ts.map +1 -0
  163. package/dist/agent/toolLedger.js +149 -0
  164. package/dist/agent/toolLedger.js.map +1 -0
  165. package/dist/agent/toolResultCache.d.ts +134 -0
  166. package/dist/agent/toolResultCache.d.ts.map +1 -0
  167. package/dist/agent/toolResultCache.js +243 -0
  168. package/dist/agent/toolResultCache.js.map +1 -0
  169. package/dist/agent/toolResultOffload.d.ts +59 -0
  170. package/dist/agent/toolResultOffload.d.ts.map +1 -0
  171. package/dist/agent/toolResultOffload.js +70 -0
  172. package/dist/agent/toolResultOffload.js.map +1 -0
  173. package/dist/agent/toolRunner.d.ts +59 -0
  174. package/dist/agent/toolRunner.d.ts.map +1 -0
  175. package/dist/agent/toolRunner.js +147 -0
  176. package/dist/agent/toolRunner.js.map +1 -0
  177. package/dist/agent/tracer.d.ts +99 -107
  178. package/dist/agent/tracer.d.ts.map +1 -1
  179. package/dist/agent/tracer.js +24 -69
  180. package/dist/agent/tracer.js.map +1 -1
  181. package/dist/agent/types.d.ts +512 -162
  182. package/dist/agent/types.d.ts.map +1 -1
  183. package/dist/agent/types.js +2 -51
  184. package/dist/agent/types.js.map +1 -1
  185. package/dist/code-exec/codeExecutionProvider.d.ts +16 -0
  186. package/dist/code-exec/codeExecutionProvider.d.ts.map +1 -0
  187. package/dist/code-exec/codeExecutionProvider.js +57 -0
  188. package/dist/code-exec/codeExecutionProvider.js.map +1 -0
  189. package/dist/code-exec/types.d.ts +37 -0
  190. package/dist/code-exec/types.d.ts.map +1 -0
  191. package/dist/code-exec/types.js +12 -0
  192. package/dist/code-exec/types.js.map +1 -0
  193. package/dist/config/expandEnvVars.d.ts +22 -0
  194. package/dist/config/expandEnvVars.d.ts.map +1 -0
  195. package/dist/config/expandEnvVars.js +38 -0
  196. package/dist/config/expandEnvVars.js.map +1 -0
  197. package/dist/config/loader.d.ts +59 -242
  198. package/dist/config/loader.d.ts.map +1 -1
  199. package/dist/config/loader.js +237 -194
  200. package/dist/config/loader.js.map +1 -1
  201. package/dist/index.d.ts +69 -74
  202. package/dist/index.d.ts.map +1 -1
  203. package/dist/index.js +93 -63
  204. package/dist/index.js.map +1 -1
  205. package/dist/llm/abortSignal.d.ts +2 -3
  206. package/dist/llm/abortSignal.d.ts.map +1 -1
  207. package/dist/llm/abortSignal.js +2 -3
  208. package/dist/llm/abortSignal.js.map +1 -1
  209. package/dist/llm/factory.d.ts +29 -25
  210. package/dist/llm/factory.d.ts.map +1 -1
  211. package/dist/llm/factory.js +34 -69
  212. package/dist/llm/factory.js.map +1 -1
  213. package/dist/llm/openaiCompatible.d.ts +25 -40
  214. package/dist/llm/openaiCompatible.d.ts.map +1 -1
  215. package/dist/llm/openaiCompatible.js +181 -129
  216. package/dist/llm/openaiCompatible.js.map +1 -1
  217. package/dist/llm/provider.d.ts +29 -42
  218. package/dist/llm/provider.d.ts.map +1 -1
  219. package/dist/llm/provider.js +11 -10
  220. package/dist/llm/provider.js.map +1 -1
  221. package/dist/llm/types.d.ts +54 -11
  222. package/dist/llm/types.d.ts.map +1 -1
  223. package/dist/llm/types.js +0 -5
  224. package/dist/llm/types.js.map +1 -1
  225. package/dist/logging/logger.d.ts +8 -29
  226. package/dist/logging/logger.d.ts.map +1 -1
  227. package/dist/logging/logger.js +43 -233
  228. package/dist/logging/logger.js.map +1 -1
  229. package/dist/logging/loggerInterface.d.ts +9 -8
  230. package/dist/logging/loggerInterface.d.ts.map +1 -1
  231. package/dist/memory/gcService.d.ts +164 -0
  232. package/dist/memory/gcService.d.ts.map +1 -0
  233. package/dist/memory/gcService.js +215 -0
  234. package/dist/memory/gcService.js.map +1 -0
  235. package/dist/memory/governance.d.ts +17 -0
  236. package/dist/memory/governance.d.ts.map +1 -0
  237. package/dist/memory/governance.js +17 -0
  238. package/dist/memory/governance.js.map +1 -0
  239. package/dist/memory/inMemoryRoundStore.d.ts +124 -0
  240. package/dist/memory/inMemoryRoundStore.d.ts.map +1 -0
  241. package/dist/memory/inMemoryRoundStore.js +216 -0
  242. package/dist/memory/inMemoryRoundStore.js.map +1 -0
  243. package/dist/memory/inMemorySessionStore.d.ts +92 -0
  244. package/dist/memory/inMemorySessionStore.d.ts.map +1 -0
  245. package/dist/memory/inMemorySessionStore.js +219 -0
  246. package/dist/memory/inMemorySessionStore.js.map +1 -0
  247. package/dist/memory/inMemorySessionViewLoader.d.ts +89 -0
  248. package/dist/memory/inMemorySessionViewLoader.d.ts.map +1 -0
  249. package/dist/memory/inMemorySessionViewLoader.js +183 -0
  250. package/dist/memory/inMemorySessionViewLoader.js.map +1 -0
  251. package/dist/memory/inMemoryStorage.d.ts +26 -141
  252. package/dist/memory/inMemoryStorage.d.ts.map +1 -1
  253. package/dist/memory/inMemoryStorage.js +48 -187
  254. package/dist/memory/inMemoryStorage.js.map +1 -1
  255. package/dist/memory/keywordsTouch.d.ts +20 -0
  256. package/dist/memory/keywordsTouch.d.ts.map +1 -0
  257. package/dist/memory/keywordsTouch.js +25 -0
  258. package/dist/memory/keywordsTouch.js.map +1 -0
  259. package/dist/memory/lockManager.d.ts +7 -2
  260. package/dist/memory/lockManager.d.ts.map +1 -1
  261. package/dist/memory/lockManager.js +35 -11
  262. package/dist/memory/lockManager.js.map +1 -1
  263. package/dist/memory/projectManager.d.ts +30 -128
  264. package/dist/memory/projectManager.d.ts.map +1 -1
  265. package/dist/memory/projectManager.js +39 -171
  266. package/dist/memory/projectManager.js.map +1 -1
  267. package/dist/memory/projectRegistry.d.ts +22 -37
  268. package/dist/memory/projectRegistry.d.ts.map +1 -1
  269. package/dist/memory/projectRegistry.js +78 -85
  270. package/dist/memory/projectRegistry.js.map +1 -1
  271. package/dist/memory/roundStore.d.ts +629 -0
  272. package/dist/memory/roundStore.d.ts.map +1 -0
  273. package/dist/memory/roundStore.js +116 -0
  274. package/dist/memory/roundStore.js.map +1 -0
  275. package/dist/memory/sessionStore.d.ts +70 -61
  276. package/dist/memory/sessionStore.d.ts.map +1 -1
  277. package/dist/memory/sessionStore.js +23 -1
  278. package/dist/memory/sessionStore.js.map +1 -1
  279. package/dist/memory/sessionViewLoader.d.ts +141 -0
  280. package/dist/memory/sessionViewLoader.d.ts.map +1 -0
  281. package/dist/memory/sessionViewLoader.js +65 -0
  282. package/dist/memory/sessionViewLoader.js.map +1 -0
  283. package/dist/memory/sourceValidation.d.ts +18 -9
  284. package/dist/memory/sourceValidation.d.ts.map +1 -1
  285. package/dist/memory/sourceValidation.js +35 -29
  286. package/dist/memory/sourceValidation.js.map +1 -1
  287. package/dist/memory/storageInterface.d.ts +45 -126
  288. package/dist/memory/storageInterface.d.ts.map +1 -1
  289. package/dist/memory/types.d.ts +82 -168
  290. package/dist/memory/types.d.ts.map +1 -1
  291. package/dist/memory/types.js +116 -79
  292. package/dist/memory/types.js.map +1 -1
  293. package/dist/project-search/projectSearchProvider.d.ts +29 -0
  294. package/dist/project-search/projectSearchProvider.d.ts.map +1 -0
  295. package/dist/project-search/projectSearchProvider.js +57 -0
  296. package/dist/project-search/projectSearchProvider.js.map +1 -0
  297. package/dist/project-search/terms.d.ts +14 -0
  298. package/dist/project-search/terms.d.ts.map +1 -0
  299. package/dist/project-search/terms.js +68 -0
  300. package/dist/project-search/terms.js.map +1 -0
  301. package/dist/project-search/types.d.ts +139 -0
  302. package/dist/project-search/types.d.ts.map +1 -0
  303. package/dist/project-search/types.js +8 -0
  304. package/dist/project-search/types.js.map +1 -0
  305. package/dist/role-pack/capabilityMap.d.ts +28 -0
  306. package/dist/role-pack/capabilityMap.d.ts.map +1 -0
  307. package/dist/role-pack/capabilityMap.js +56 -0
  308. package/dist/role-pack/capabilityMap.js.map +1 -0
  309. package/dist/role-pack/constants.d.ts +21 -0
  310. package/dist/role-pack/constants.d.ts.map +1 -0
  311. package/dist/role-pack/constants.js +21 -0
  312. package/dist/role-pack/constants.js.map +1 -0
  313. package/dist/role-pack/rolePackManager.d.ts +269 -0
  314. package/dist/role-pack/rolePackManager.d.ts.map +1 -0
  315. package/dist/role-pack/rolePackManager.js +1082 -0
  316. package/dist/role-pack/rolePackManager.js.map +1 -0
  317. package/dist/role-pack/strategyKeys.d.ts +100 -0
  318. package/dist/role-pack/strategyKeys.d.ts.map +1 -0
  319. package/dist/role-pack/strategyKeys.js +184 -0
  320. package/dist/role-pack/strategyKeys.js.map +1 -0
  321. package/dist/role-pack/strategyResolver.d.ts +109 -0
  322. package/dist/role-pack/strategyResolver.d.ts.map +1 -0
  323. package/dist/role-pack/strategyResolver.js +304 -0
  324. package/dist/role-pack/strategyResolver.js.map +1 -0
  325. package/dist/role-pack/types.d.ts +237 -0
  326. package/dist/role-pack/types.d.ts.map +1 -0
  327. package/dist/role-pack/types.js +8 -0
  328. package/dist/role-pack/types.js.map +1 -0
  329. package/dist/role-pack/validator.d.ts +38 -0
  330. package/dist/role-pack/validator.d.ts.map +1 -0
  331. package/dist/role-pack/validator.js +436 -0
  332. package/dist/role-pack/validator.js.map +1 -0
  333. package/dist/security/pathGuard.d.ts +69 -72
  334. package/dist/security/pathGuard.d.ts.map +1 -1
  335. package/dist/security/pathGuard.js +151 -131
  336. package/dist/security/pathGuard.js.map +1 -1
  337. package/dist/skill/skillLayer3.d.ts +91 -0
  338. package/dist/skill/skillLayer3.d.ts.map +1 -0
  339. package/dist/skill/skillLayer3.js +104 -0
  340. package/dist/skill/skillLayer3.js.map +1 -0
  341. package/dist/skill/skillManager.d.ts +127 -56
  342. package/dist/skill/skillManager.d.ts.map +1 -1
  343. package/dist/skill/skillManager.js +318 -163
  344. package/dist/skill/skillManager.js.map +1 -1
  345. package/dist/skill/skillScriptRunner.d.ts +97 -0
  346. package/dist/skill/skillScriptRunner.d.ts.map +1 -0
  347. package/dist/skill/skillScriptRunner.js +271 -0
  348. package/dist/skill/skillScriptRunner.js.map +1 -0
  349. package/dist/skill/types.d.ts +73 -17
  350. package/dist/skill/types.d.ts.map +1 -1
  351. package/dist/skill/types.js +5 -1
  352. package/dist/skill/types.js.map +1 -1
  353. package/dist/utils/array.d.ts +5 -6
  354. package/dist/utils/array.d.ts.map +1 -1
  355. package/dist/utils/array.js +6 -6
  356. package/dist/utils/array.js.map +1 -1
  357. package/dist/utils/atomicWrite.d.ts +8 -0
  358. package/dist/utils/atomicWrite.d.ts.map +1 -0
  359. package/dist/utils/atomicWrite.js +31 -0
  360. package/dist/utils/atomicWrite.js.map +1 -0
  361. package/dist/utils/backgroundTask.d.ts +38 -0
  362. package/dist/utils/backgroundTask.d.ts.map +1 -0
  363. package/dist/utils/backgroundTask.js +117 -0
  364. package/dist/utils/backgroundTask.js.map +1 -0
  365. package/dist/utils/configResourceManager.d.ts +79 -0
  366. package/dist/utils/configResourceManager.d.ts.map +1 -0
  367. package/dist/utils/configResourceManager.js +150 -0
  368. package/dist/utils/configResourceManager.js.map +1 -0
  369. package/dist/utils/errors.d.ts +48 -56
  370. package/dist/utils/errors.d.ts.map +1 -1
  371. package/dist/utils/errors.js +60 -58
  372. package/dist/utils/errors.js.map +1 -1
  373. package/dist/utils/eventEmitter.d.ts +141 -63
  374. package/dist/utils/eventEmitter.d.ts.map +1 -1
  375. package/dist/utils/eventEmitter.js +50 -35
  376. package/dist/utils/eventEmitter.js.map +1 -1
  377. package/dist/utils/fileSafe.d.ts +20 -0
  378. package/dist/utils/fileSafe.d.ts.map +1 -0
  379. package/dist/utils/fileSafe.js +56 -0
  380. package/dist/utils/fileSafe.js.map +1 -0
  381. package/dist/utils/frontmatter.d.ts +2 -3
  382. package/dist/utils/frontmatter.d.ts.map +1 -1
  383. package/dist/utils/frontmatter.js +6 -5
  384. package/dist/utils/frontmatter.js.map +1 -1
  385. package/dist/utils/hash.d.ts +12 -0
  386. package/dist/utils/hash.d.ts.map +1 -0
  387. package/dist/utils/hash.js +27 -0
  388. package/dist/utils/hash.js.map +1 -0
  389. package/dist/utils/http.d.ts +17 -0
  390. package/dist/utils/http.d.ts.map +1 -0
  391. package/dist/utils/http.js +29 -0
  392. package/dist/utils/http.js.map +1 -0
  393. package/dist/utils/json.d.ts +1 -1
  394. package/dist/utils/json.js +1 -1
  395. package/dist/utils/math.d.ts +34 -1
  396. package/dist/utils/math.d.ts.map +1 -1
  397. package/dist/utils/math.js +47 -14
  398. package/dist/utils/math.js.map +1 -1
  399. package/dist/utils/objects.d.ts +2 -3
  400. package/dist/utils/objects.d.ts.map +1 -1
  401. package/dist/utils/objects.js +2 -3
  402. package/dist/utils/objects.js.map +1 -1
  403. package/dist/utils/recallDefaults.d.ts +16 -0
  404. package/dist/utils/recallDefaults.d.ts.map +1 -0
  405. package/dist/utils/recallDefaults.js +16 -0
  406. package/dist/utils/recallDefaults.js.map +1 -0
  407. package/dist/utils/safeTimer.d.ts +8 -36
  408. package/dist/utils/safeTimer.d.ts.map +1 -1
  409. package/dist/utils/safeTimer.js +9 -37
  410. package/dist/utils/safeTimer.js.map +1 -1
  411. package/dist/utils/scanner.d.ts +97 -17
  412. package/dist/utils/scanner.d.ts.map +1 -1
  413. package/dist/utils/scanner.js +269 -47
  414. package/dist/utils/scanner.js.map +1 -1
  415. package/dist/utils/segmenter.d.ts +20 -29
  416. package/dist/utils/segmenter.d.ts.map +1 -1
  417. package/dist/utils/segmenter.js +230 -88
  418. package/dist/utils/segmenter.js.map +1 -1
  419. package/dist/utils/strings.d.ts +15 -32
  420. package/dist/utils/strings.d.ts.map +1 -1
  421. package/dist/utils/strings.js +25 -44
  422. package/dist/utils/strings.js.map +1 -1
  423. package/dist/utils/time.d.ts +37 -0
  424. package/dist/utils/time.d.ts.map +1 -1
  425. package/dist/utils/time.js +56 -0
  426. package/dist/utils/time.js.map +1 -1
  427. package/dist/utils/toError.d.ts +13 -1
  428. package/dist/utils/toError.d.ts.map +1 -1
  429. package/dist/utils/toError.js +18 -1
  430. package/dist/utils/toError.js.map +1 -1
  431. package/dist/web-fetch/fetchWebFetchProvider.d.ts +14 -0
  432. package/dist/web-fetch/fetchWebFetchProvider.d.ts.map +1 -0
  433. package/dist/web-fetch/fetchWebFetchProvider.js +69 -0
  434. package/dist/web-fetch/fetchWebFetchProvider.js.map +1 -0
  435. package/dist/web-fetch/types.d.ts +30 -0
  436. package/dist/web-fetch/types.d.ts.map +1 -0
  437. package/dist/web-fetch/types.js +7 -0
  438. package/dist/web-fetch/types.js.map +1 -0
  439. package/dist/web-fetch/webFetchProvider.d.ts +10 -0
  440. package/dist/web-fetch/webFetchProvider.d.ts.map +1 -0
  441. package/dist/web-fetch/webFetchProvider.js +28 -0
  442. package/dist/web-fetch/webFetchProvider.js.map +1 -0
  443. package/dist/web-search/fetchWebSearchProvider.d.ts +27 -0
  444. package/dist/web-search/fetchWebSearchProvider.d.ts.map +1 -0
  445. package/dist/web-search/fetchWebSearchProvider.js +199 -0
  446. package/dist/web-search/fetchWebSearchProvider.js.map +1 -0
  447. package/dist/web-search/types.d.ts +46 -0
  448. package/dist/web-search/types.d.ts.map +1 -0
  449. package/dist/web-search/types.js +2 -0
  450. package/dist/{persona → web-search}/types.js.map +1 -1
  451. package/dist/web-search/webSearchProvider.d.ts +10 -0
  452. package/dist/web-search/webSearchProvider.d.ts.map +1 -0
  453. package/dist/web-search/webSearchProvider.js +30 -0
  454. package/dist/web-search/webSearchProvider.js.map +1 -0
  455. package/docs/architecture/role-pack-authoring-guide.md +243 -0
  456. package/docs/architecture/role-pack-spec.md +767 -0
  457. package/docs/memora-api-reference.md +1175 -0
  458. package/docs/memora-/346/216/245/345/205/245/346/214/207/345/215/227.md +843 -0
  459. package/docs/role-pack-/345/274/200/346/224/276/351/224/256/346/214/207/345/215/227.md +148 -0
  460. package/package.json +105 -83
  461. package/role-packs/README.md +41 -0
  462. package/role-packs/memora/345/212/251/346/211/213/manifest.json +12 -0
  463. package/role-packs/memora/345/212/251/346/211/213/persona.md +12 -0
  464. package/role-packs/memora/345/212/251/346/211/213/rules.md +4 -0
  465. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/manifest.json +44 -0
  466. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/persona.md +46 -0
  467. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/rules.md +15 -0
  468. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/character-sheet.md +34 -0
  469. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/core-extractor.md +37 -0
  470. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/craft-review.md +69 -0
  471. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/dialogue-craft.md +45 -0
  472. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/emotion-wave.md +46 -0
  473. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/empathy-craft.md +79 -0
  474. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/foreshadow.md +29 -0
  475. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/hotspot-mapping.md +121 -0
  476. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/idea-lever.md +42 -0
  477. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/logline-craft.md +47 -0
  478. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/longform-guard.md +64 -0
  479. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/need-finder.md +40 -0
  480. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/outline-expand.md +46 -0
  481. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/pacing-hook.md +34 -0
  482. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/polish-method.md +113 -0
  483. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/pov-discipline.md +79 -0
  484. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/project-init/SKILL.md +112 -0
  485. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/project-init/scripts/init-novel-project.mjs +441 -0
  486. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/relationship-web.md +47 -0
  487. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/scene-craft.md +46 -0
  488. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/story-bible.md +60 -0
  489. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/story-structure.md +36 -0
  490. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/style-weaver.md +109 -0
  491. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/three-layer-check.md +27 -0
  492. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/world-builder.md +41 -0
  493. package/role-packs//347/231/275/350/257/235/346/226/271/346/241/210/350/256/276/350/256/241/345/270/210/manifest.json +48 -0
  494. package/role-packs//347/231/275/350/257/235/346/226/271/346/241/210/350/256/276/350/256/241/345/270/210/persona.md +73 -0
  495. package/role-packs//347/231/275/350/257/235/346/226/271/346/241/210/350/256/276/350/256/241/345/270/210/rules.md +19 -0
  496. package/role-packs//347/231/275/350/257/235/346/226/271/346/241/210/350/256/276/350/256/241/345/270/210/skills/api-doc-writer.md +40 -0
  497. package/role-packs//347/231/275/350/257/235/346/226/271/346/241/210/350/256/276/350/256/241/345/270/210/skills/doc-planner.md +42 -0
  498. package/role-packs//347/231/275/350/257/235/346/226/271/346/241/210/350/256/276/350/256/241/345/270/210/skills/nutrient-search.md +28 -0
  499. package/role-packs//347/231/275/350/257/235/346/226/271/346/241/210/350/256/276/350/256/241/345/270/210/skills/seed-finder.md +28 -0
  500. package/role-packs//347/231/275/350/257/235/346/226/271/346/241/210/350/256/276/350/256/241/345/270/210/skills/ssot-audit.md +34 -0
  501. package/role-packs//347/231/275/350/257/235/346/226/271/346/241/210/350/256/276/350/256/241/345/270/210/skills/style-guide.md +40 -0
  502. package/dist/agent/guardrail.d.ts +0 -47
  503. package/dist/agent/guardrail.d.ts.map +0 -1
  504. package/dist/agent/guardrail.js +0 -51
  505. package/dist/agent/guardrail.js.map +0 -1
  506. package/dist/agent/managers/autoConfigRefiner.d.ts +0 -39
  507. package/dist/agent/managers/autoConfigRefiner.d.ts.map +0 -1
  508. package/dist/agent/managers/autoConfigRefiner.js +0 -150
  509. package/dist/agent/managers/autoConfigRefiner.js.map +0 -1
  510. package/dist/agent/managers/configManager.d.ts +0 -125
  511. package/dist/agent/managers/configManager.d.ts.map +0 -1
  512. package/dist/agent/managers/configManager.js +0 -194
  513. package/dist/agent/managers/configManager.js.map +0 -1
  514. package/dist/agent/managers/insightExtractor.d.ts +0 -139
  515. package/dist/agent/managers/insightExtractor.d.ts.map +0 -1
  516. package/dist/agent/managers/insightExtractor.js +0 -401
  517. package/dist/agent/managers/insightExtractor.js.map +0 -1
  518. package/dist/agent/managers/memoryDecayScheduler.d.ts +0 -198
  519. package/dist/agent/managers/memoryDecayScheduler.d.ts.map +0 -1
  520. package/dist/agent/managers/memoryDecayScheduler.js +0 -349
  521. package/dist/agent/managers/memoryDecayScheduler.js.map +0 -1
  522. package/dist/agent/managers/relationBuilder.d.ts +0 -131
  523. package/dist/agent/managers/relationBuilder.d.ts.map +0 -1
  524. package/dist/agent/managers/relationBuilder.js +0 -192
  525. package/dist/agent/managers/relationBuilder.js.map +0 -1
  526. package/dist/agent/personaMatcher.d.ts +0 -29
  527. package/dist/agent/personaMatcher.d.ts.map +0 -1
  528. package/dist/agent/personaMatcher.js +0 -60
  529. package/dist/agent/personaMatcher.js.map +0 -1
  530. package/dist/agent/userFactExtractor.d.ts +0 -25
  531. package/dist/agent/userFactExtractor.d.ts.map +0 -1
  532. package/dist/agent/userFactExtractor.js +0 -81
  533. package/dist/agent/userFactExtractor.js.map +0 -1
  534. package/dist/eval/evalRunner.d.ts +0 -94
  535. package/dist/eval/evalRunner.d.ts.map +0 -1
  536. package/dist/eval/evalRunner.js +0 -141
  537. package/dist/eval/evalRunner.js.map +0 -1
  538. package/dist/eval/evalTypes.d.ts +0 -148
  539. package/dist/eval/evalTypes.d.ts.map +0 -1
  540. package/dist/eval/evalTypes.js +0 -118
  541. package/dist/eval/evalTypes.js.map +0 -1
  542. package/dist/eval/scenarios.d.ts +0 -33
  543. package/dist/eval/scenarios.d.ts.map +0 -1
  544. package/dist/eval/scenarios.js +0 -109
  545. package/dist/eval/scenarios.js.map +0 -1
  546. package/dist/llm/embedding.d.ts +0 -67
  547. package/dist/llm/embedding.d.ts.map +0 -1
  548. package/dist/llm/embedding.js +0 -184
  549. package/dist/llm/embedding.js.map +0 -1
  550. package/dist/memory/hybridMerge.d.ts +0 -54
  551. package/dist/memory/hybridMerge.d.ts.map +0 -1
  552. package/dist/memory/hybridMerge.js +0 -36
  553. package/dist/memory/hybridMerge.js.map +0 -1
  554. package/dist/memory/inMemoryRelationStore.d.ts +0 -51
  555. package/dist/memory/inMemoryRelationStore.d.ts.map +0 -1
  556. package/dist/memory/inMemoryRelationStore.js +0 -65
  557. package/dist/memory/inMemoryRelationStore.js.map +0 -1
  558. package/dist/memory/loader.d.ts +0 -49
  559. package/dist/memory/loader.d.ts.map +0 -1
  560. package/dist/memory/loader.js +0 -93
  561. package/dist/memory/loader.js.map +0 -1
  562. package/dist/memory/recall.d.ts +0 -66
  563. package/dist/memory/recall.d.ts.map +0 -1
  564. package/dist/memory/recall.js +0 -142
  565. package/dist/memory/recall.js.map +0 -1
  566. package/dist/memory/relationStore.d.ts +0 -78
  567. package/dist/memory/relationStore.d.ts.map +0 -1
  568. package/dist/memory/relationStore.js +0 -2
  569. package/dist/memory/relationStore.js.map +0 -1
  570. package/dist/memory/store.d.ts +0 -50
  571. package/dist/memory/store.d.ts.map +0 -1
  572. package/dist/memory/store.js +0 -161
  573. package/dist/memory/store.js.map +0 -1
  574. package/dist/memory/userProfile.d.ts +0 -156
  575. package/dist/memory/userProfile.d.ts.map +0 -1
  576. package/dist/memory/userProfile.js +0 -320
  577. package/dist/memory/userProfile.js.map +0 -1
  578. package/dist/memory/vectorStore.d.ts +0 -185
  579. package/dist/memory/vectorStore.d.ts.map +0 -1
  580. package/dist/memory/vectorStore.js +0 -257
  581. package/dist/memory/vectorStore.js.map +0 -1
  582. package/dist/persona/personaManager.d.ts +0 -160
  583. package/dist/persona/personaManager.d.ts.map +0 -1
  584. package/dist/persona/personaManager.js +0 -414
  585. package/dist/persona/personaManager.js.map +0 -1
  586. package/dist/persona/types.d.ts +0 -32
  587. package/dist/persona/types.d.ts.map +0 -1
  588. package/dist/persona/types.js +0 -5
@@ -0,0 +1,216 @@
1
+ /**
2
+ * 内存问答闭环存储实现 — IRoundStore 的纯 JS 内存版
3
+ *
4
+ * 设计理念:
5
+ * - 零依赖零 IO,用于单元测试、临时占位
6
+ * - 不持久化(进程退出即丢失),仅限测试/开发
7
+ * - 生产由宿主注入持久化实现(FileRoundStore 或宿主自选后端)
8
+ */
9
+ import { logger } from '../logging/logger.js';
10
+ /**
11
+ * 内存问答闭环存储
12
+ *
13
+ * 核心实现:
14
+ * - Map 存储(id → Round)
15
+ * - 引用计数内置于 Round.refCount
16
+ * - 支持批量获取(getByIds)
17
+ * - 支持按状态筛选(listByStatus)
18
+ * - 支持孤立检查(listOrphaned)
19
+ */
20
+ export class InMemoryRoundStore {
21
+ /** Round 存储(id → Round) */
22
+ rounds = new Map();
23
+ /**
24
+ * 存储问答闭环(新增或更新)
25
+ *
26
+ * @param round - 问答闭环对象
27
+ */
28
+ save(round) {
29
+ // 浅拷贝,防止外部修改影响内部状态
30
+ this.rounds.set(round.id, { ...round });
31
+ }
32
+ /**
33
+ * 按 ID 获取问答闭环
34
+ *
35
+ * @param roundId - 全局唯一 Round ID
36
+ * @returns Round 对象,不存在返回 null
37
+ */
38
+ getById(roundId) {
39
+ const round = this.rounds.get(roundId);
40
+ if (!round)
41
+ return null;
42
+ return { ...round };
43
+ }
44
+ /**
45
+ * 批量获取问答闭环
46
+ *
47
+ * 不存在的 ID 会被跳过,不报错
48
+ *
49
+ * @param roundIds - Round ID 数组
50
+ * @returns Round 对象数组(按输入顺序,跳过不存在的)
51
+ */
52
+ getByIds(roundIds) {
53
+ const results = [];
54
+ for (const id of roundIds) {
55
+ const round = this.rounds.get(id);
56
+ if (round) {
57
+ results.push({ ...round });
58
+ }
59
+ }
60
+ return results;
61
+ }
62
+ /**
63
+ * 列出所有问答闭环
64
+ *
65
+ * ⚠️ 生产环境慎用:全量遍历可能性能开销大
66
+ *
67
+ * @returns 所有 Round 数组(浅拷贝)
68
+ */
69
+ listAll() {
70
+ return Array.from(this.rounds.values()).map((r) => ({ ...r }));
71
+ }
72
+ /**
73
+ * 增加引用计数
74
+ *
75
+ * 分叉时调用:新会话引用同一个 Round
76
+ *
77
+ * @param roundId - 需要增加引用的 Round ID
78
+ */
79
+ incrementRef(roundId) {
80
+ const round = this.rounds.get(roundId);
81
+ if (!round) {
82
+ logger.warn({ roundId }, 'incrementRef: Round 不存在');
83
+ return;
84
+ }
85
+ round.refCount++;
86
+ this.rounds.set(roundId, { ...round });
87
+ }
88
+ /**
89
+ * 减少引用计数
90
+ *
91
+ * 删除会话时调用
92
+ * 引用计数不会降到 0 以下
93
+ *
94
+ * @param roundId - 需要减少引用的 Round ID
95
+ */
96
+ decrementRef(roundId) {
97
+ const round = this.rounds.get(roundId);
98
+ if (!round) {
99
+ logger.warn({ roundId }, 'decrementRef: Round 不存在');
100
+ return;
101
+ }
102
+ if (round.refCount > 0) {
103
+ round.refCount--;
104
+ this.rounds.set(roundId, { ...round });
105
+ }
106
+ }
107
+ /**
108
+ * 删除问答闭环(物理删除,不可恢复)
109
+ *
110
+ * 前置条件:refCount === 0
111
+ *
112
+ * @param roundId - 要删除的 Round ID
113
+ * @returns 是否删除成功(refCount > 0 时返回 false)
114
+ */
115
+ delete(roundId) {
116
+ const round = this.rounds.get(roundId);
117
+ if (!round)
118
+ return false;
119
+ // 检查引用计数
120
+ if (round.refCount > 0) {
121
+ logger.warn({ roundId, refCount: round.refCount }, 'delete: Round 仍被引用,无法删除');
122
+ return false;
123
+ }
124
+ this.rounds.delete(roundId);
125
+ return true;
126
+ }
127
+ /**
128
+ * 按状态列出问答闭环
129
+ *
130
+ * @param status - Round 状态筛选
131
+ * @returns 符合条件的 Round 数组
132
+ */
133
+ listByStatus(status) {
134
+ return Array.from(this.rounds.values())
135
+ .filter((r) => r.status === status)
136
+ .map((r) => ({ ...r }));
137
+ }
138
+ /**
139
+ * 获取孤立的问答闭环列表(refCount === 0)
140
+ *
141
+ * 用于 GC 服务批量清理
142
+ *
143
+ * @param minAgeMs - 最小存活时间(毫秒),避免清理正在使用的 Round
144
+ * @returns 孤立 Round 数组
145
+ */
146
+ listOrphaned(minAgeMs = 0) {
147
+ const now = Date.now();
148
+ const minAgeMsSec = minAgeMs / 1000; // 转换为秒
149
+ return Array.from(this.rounds.values())
150
+ .filter((r) => {
151
+ // 检查引用计数
152
+ if (r.refCount > 0)
153
+ return false;
154
+ // 检查存活时间
155
+ const createdAtMs = new Date(r.createdAt).getTime();
156
+ const ageSec = (now - createdAtMs) / 1000;
157
+ if (ageSec < minAgeMsSec)
158
+ return false;
159
+ // 孤儿 = 无引用且超龄:
160
+ // complete 轮在删会话归零后回收;pending/error 轮(崩溃残留 refCount=0)同样回收,
161
+ // 进行中轮由 minAgeMs 兜底保护,不被误清
162
+ return true;
163
+ })
164
+ .map((r) => ({ ...r }));
165
+ }
166
+ /**
167
+ * 列出指定日期最近未完成(pending/error)的崩溃残留轮(step 原子落盘)。
168
+ *
169
+ * 崩溃发生在 appendAssistant 前时,该轮 refCount=0、未登记会话、orphan 但可能有已落盘
170
+ * processEvents(step 检查点)。宿主重启后经此口「找到」中断轮,再调收场方法
171
+ * (MessageHistory.appendInterrupted)**升级为正常 stop turn**(非半成品草稿)。
172
+ * 只读、不改写、不登记会话;升级完成(complete + refCount>0)前为打捞窗口内中间态,
173
+ * 超龄仍未升级的中断轮由 GC 回收(默认 24h 存活保护覆盖打捞窗口,不误回收)。
174
+ *
175
+ * @param date - YYYY-MM-DD,按 createdAt 前缀匹配(ISO 头 10 位)
176
+ * @param limit - 最多条数,按 createdAt 降序(最新在前);缺省不截断
177
+ * @returns 中断残留 Round 数组(倒序)
178
+ */
179
+ listInterruptedRecent(date, limit) {
180
+ // 崩溃残留轮 = refCount 0 + 未完成(pending/error),按创建日期精确过滤后倒序取最新
181
+ //
182
+ // ⚠️ `'error'` 是**预留态**(明示收起):
183
+ // 全仓**无任何写点**把 Round.status 置为 'error'(写点仅 pending → complete /
184
+ // appendInterrupted → interrupted,中断轮不伪 complete)——它在此处与
185
+ // 'pending' **共用同一条打捞条件**,故保留字段本身零成本、删除反而是无谓改动。
186
+ // 保留的是「接口形状」而非「当前行为」:若未来出现「整轮失败且需与中断区分」的
187
+ // 真实需求,可在此分支补齐语义,无需改签名。
188
+ // ⚠️ `interrupted` **不入本打捞口**:运行期收场已即时标 interrupted 且 refCount 0→1,
189
+ // 不再符合 `refCount===0` 的崩溃孤儿条件;interrupted 轮是「已收场的停 turn」,不属崩溃残留。
190
+ // 纪律:勿因「grep 到零写点」而删该字段(它是打捞条件的组成部分,非死代码)。
191
+ const interrupted = Array.from(this.rounds.values())
192
+ .filter((r) => r.refCount === 0 && (r.status === 'pending' || r.status === 'error'))
193
+ .filter((r) => r.createdAt.startsWith(date))
194
+ .sort((a, b) => b.createdAt.localeCompare(a.createdAt));
195
+ return (limit !== undefined ? interrupted.slice(0, limit) : interrupted).map((r) => ({ ...r }));
196
+ }
197
+ /**
198
+ * 获取存储中的 Round 数量
199
+ *
200
+ * 用于监控和测试
201
+ *
202
+ * @returns Round 总数
203
+ */
204
+ size() {
205
+ return this.rounds.size;
206
+ }
207
+ /**
208
+ * 清空存储(测试用)
209
+ *
210
+ * ⚠️ 不可逆操作,仅用于测试
211
+ */
212
+ clear() {
213
+ this.rounds.clear();
214
+ }
215
+ }
216
+ //# sourceMappingURL=inMemoryRoundStore.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"inMemoryRoundStore.js","sourceRoot":"","sources":["../../src/memory/inMemoryRoundStore.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,92 @@
1
+ /**
2
+ * 内存会话存储实现 — ISessionStore 的纯 JS 内存版
3
+ *
4
+ * 设计理念:
5
+ * - 零依赖零 IO,用于单元测试、临时占位
6
+ * - 单一存储模型:round-based(会话仅持 roundIds,消息内容在 RoundStore)
7
+ *
8
+ * 存储结构:
9
+ * - metas: Map(sessionId → SessionMeta)— 元数据
10
+ * - roundIdsMap: Map(sessionId → string[])— 会话的 Round ID 列表(唯一内容来源)
11
+ * - roundStore: IRoundStore — 问答闭环物理存储(真相源)
12
+ */
13
+ import type { IRoundStore } from '../memory/roundStore.js';
14
+ import type { ISessionStore, SessionMessage, SessionMeta } from '../memory/sessionStore.js';
15
+ /**
16
+ * 内存会话存储
17
+ */
18
+ export declare class InMemorySessionStore implements ISessionStore {
19
+ private readonly roundStore;
20
+ /** 会话元数据存储 */
21
+ private readonly metas;
22
+ /** Round ID 列表存储:key = sessionId,value = roundId 数组(round-based 模式) */
23
+ private readonly roundIdsMap;
24
+ constructor(roundStore?: IRoundStore);
25
+ /**
26
+ * 加载指定会话的完整消息列表(从 roundIds → RoundStore 展开)。
27
+ */
28
+ loadMessages(date: string, session: string): SessionMessage[];
29
+ /**
30
+ * 列出所有会话标识
31
+ */
32
+ listSessions(): string[];
33
+ /**
34
+ * 获取会话元数据
35
+ *
36
+ * SSOT:SessionMeta 为纯展示 DTO(不含 roundIds),Round ID 需经 getRoundIds() 真源读取
37
+ */
38
+ getSessionMeta(sessionId: string): SessionMeta | undefined;
39
+ /**
40
+ * 设置会话标题
41
+ */
42
+ setSessionTitle(sessionId: string, title: string): void;
43
+ /**
44
+ * 更新会话元数据
45
+ */
46
+ updateSessionMeta(sessionId: string, meta: Partial<SessionMeta>): void;
47
+ /**
48
+ * 列出所有会话元数据(按 updatedAt **降序**,最近活跃在前——ISessionStore 排序契约)
49
+ *
50
+ * 方向必须与宿主实现一致:SessionManager.restoreMostRecentSession 视 [0] 为「最近活跃
51
+ * 唯一真理源」,升规则会恢复成最旧会话。
52
+ */
53
+ listSessionMetas(): SessionMeta[];
54
+ /**
55
+ * 追加 Round ID 到会话
56
+ */
57
+ appendRoundId(sessionId: string, roundId: string): void;
58
+ /**
59
+ * 批量追加 Round ID 到会话
60
+ */
61
+ appendRoundIds(sessionId: string, roundIds: string[]): void;
62
+ /**
63
+ * 获取会话的 Round ID 列表
64
+ */
65
+ getRoundIds(sessionId: string): string[];
66
+ /**
67
+ * 设置会话的 Round ID 列表
68
+ */
69
+ setRoundIds(sessionId: string, roundIds: string[]): void;
70
+ /**
71
+ * 创建新会话元数据
72
+ */
73
+ createSession(meta: SessionMeta): void;
74
+ /**
75
+ * 删除会话
76
+ */
77
+ deleteSession(sessionId: string): void;
78
+ /**
79
+ * 更新会话的消息计数(round-based 固有语义缓存:每个完整轮 = User+AI 2 条)。
80
+ * 派生逻辑单一真源 = deriveMessageCount(本方法仅做「写回 meta」副作用)。
81
+ */
82
+ private updateMessageCount;
83
+ /**
84
+ * 派生会话消息数(round-based 固有语义:roundIds.length * 2)——**单一真源**。
85
+ */
86
+ private deriveMessageCount;
87
+ /**
88
+ * 清空所有存储(测试用)
89
+ */
90
+ clear(): void;
91
+ }
92
+ //# sourceMappingURL=inMemorySessionStore.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"inMemorySessionStore.d.ts","sourceRoot":"","sources":["../../src/memory/inMemorySessionStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG3F;;GAEG;AACH,qBAAa,oBAAqB,YAAW,aAAa;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;IACzC,cAAc;IACd,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkC;IACxD,uEAAuE;IACvE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;gBAE/C,UAAU,CAAC,EAAE,WAAW;IAMpC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE;IA8B7D;;OAEG;IACH,YAAY,IAAI,MAAM,EAAE;IAaxB;;;;OAIG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI1D;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAmBvD;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAmBtE;;;;;OAKG;IACH,gBAAgB,IAAI,WAAW,EAAE;IAMjC;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IASvD;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAS3D;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE;IAIxC;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAOxD;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAKtC;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAYtC;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAK1B;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}
@@ -0,0 +1,219 @@
1
+ /**
2
+ * 内存会话存储实现 — ISessionStore 的纯 JS 内存版
3
+ *
4
+ * 设计理念:
5
+ * - 零依赖零 IO,用于单元测试、临时占位
6
+ * - 单一存储模型:round-based(会话仅持 roundIds,消息内容在 RoundStore)
7
+ *
8
+ * 存储结构:
9
+ * - metas: Map(sessionId → SessionMeta)— 元数据
10
+ * - roundIdsMap: Map(sessionId → string[])— 会话的 Round ID 列表(唯一内容来源)
11
+ * - roundStore: IRoundStore — 问答闭环物理存储(真相源)
12
+ */
13
+ import { isRoundSettled } from '../memory/roundStore.js';
14
+ import { InMemoryRoundStore } from '../memory/inMemoryRoundStore.js';
15
+ /**
16
+ * 内存会话存储
17
+ */
18
+ export class InMemorySessionStore {
19
+ roundStore;
20
+ /** 会话元数据存储 */
21
+ metas = new Map();
22
+ /** Round ID 列表存储:key = sessionId,value = roundId 数组(round-based 模式) */
23
+ roundIdsMap = new Map();
24
+ constructor(roundStore) {
25
+ this.roundStore = roundStore ?? new InMemoryRoundStore();
26
+ }
27
+ // ─── 会话消息读写(round-based 唯一真相源) ──────────
28
+ /**
29
+ * 加载指定会话的完整消息列表(从 roundIds → RoundStore 展开)。
30
+ */
31
+ loadMessages(date, session) {
32
+ const sessionId = `${date}-${session}`;
33
+ const roundIds = this.getRoundIds(sessionId);
34
+ if (roundIds.length === 0)
35
+ return [];
36
+ const rounds = this.roundStore.getByIds(roundIds);
37
+ const messages = [];
38
+ for (const round of rounds) {
39
+ messages.push({
40
+ role: round.userMessage.role,
41
+ content: round.userMessage.content,
42
+ timestamp: round.userMessage.timestamp,
43
+ roundId: round.id,
44
+ });
45
+ // 判据收口 isRoundSettled:中断轮(interrupted)同样计入——本方法是 LLM 历史注入
46
+ // (restoreHistory)唯一上游,漏计会让中断轮回复从上下文消失(见该函数文档)
47
+ if (round.assistantMessage && isRoundSettled(round.status)) {
48
+ messages.push({
49
+ role: round.assistantMessage.role,
50
+ content: round.assistantMessage.content,
51
+ timestamp: round.assistantMessage.timestamp,
52
+ roundId: round.id,
53
+ });
54
+ }
55
+ }
56
+ return messages;
57
+ }
58
+ // ─── 通用方法 ─────────────────────────────────────────
59
+ /**
60
+ * 列出所有会话标识
61
+ */
62
+ listSessions() {
63
+ const sessions = new Set();
64
+ // 从 roundIds 中收集
65
+ for (const sessionId of this.roundIdsMap.keys()) {
66
+ sessions.add(sessionId);
67
+ }
68
+ // 从 metas 中收集
69
+ for (const sessionId of this.metas.keys()) {
70
+ sessions.add(sessionId);
71
+ }
72
+ return Array.from(sessions).sort();
73
+ }
74
+ /**
75
+ * 获取会话元数据
76
+ *
77
+ * SSOT:SessionMeta 为纯展示 DTO(不含 roundIds),Round ID 需经 getRoundIds() 真源读取
78
+ */
79
+ getSessionMeta(sessionId) {
80
+ return this.metas.get(sessionId);
81
+ }
82
+ /**
83
+ * 设置会话标题
84
+ */
85
+ setSessionTitle(sessionId, title) {
86
+ const existing = this.metas.get(sessionId);
87
+ if (existing) {
88
+ this.metas.set(sessionId, {
89
+ ...existing,
90
+ displayName: title,
91
+ updatedAt: new Date().toISOString(),
92
+ });
93
+ }
94
+ else {
95
+ const messageCount = this.deriveMessageCount(sessionId);
96
+ this.metas.set(sessionId, {
97
+ sessionId,
98
+ displayName: title,
99
+ updatedAt: new Date().toISOString(),
100
+ messageCount,
101
+ });
102
+ }
103
+ }
104
+ /**
105
+ * 更新会话元数据
106
+ */
107
+ updateSessionMeta(sessionId, meta) {
108
+ const existing = this.metas.get(sessionId);
109
+ if (existing) {
110
+ this.metas.set(sessionId, {
111
+ ...existing,
112
+ ...meta,
113
+ updatedAt: new Date().toISOString(),
114
+ });
115
+ }
116
+ else {
117
+ const messageCount = this.deriveMessageCount(sessionId);
118
+ this.metas.set(sessionId, {
119
+ sessionId,
120
+ updatedAt: new Date().toISOString(),
121
+ messageCount,
122
+ ...meta,
123
+ });
124
+ }
125
+ }
126
+ /**
127
+ * 列出所有会话元数据(按 updatedAt **降序**,最近活跃在前——ISessionStore 排序契约)
128
+ *
129
+ * 方向必须与宿主实现一致:SessionManager.restoreMostRecentSession 视 [0] 为「最近活跃
130
+ * 唯一真理源」,升规则会恢复成最旧会话。
131
+ */
132
+ listSessionMetas() {
133
+ return Array.from(this.metas.values()).sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
134
+ }
135
+ // ─── Round-based 模式方法 ──────────────────────────────
136
+ /**
137
+ * 追加 Round ID 到会话
138
+ */
139
+ appendRoundId(sessionId, roundId) {
140
+ const roundIds = this.roundIdsMap.get(sessionId) ?? [];
141
+ roundIds.push(roundId);
142
+ this.roundIdsMap.set(sessionId, roundIds);
143
+ // 更新元数据
144
+ this.updateMessageCount(sessionId);
145
+ }
146
+ /**
147
+ * 批量追加 Round ID 到会话
148
+ */
149
+ appendRoundIds(sessionId, roundIds) {
150
+ const existing = this.roundIdsMap.get(sessionId) ?? [];
151
+ const merged = [...existing, ...roundIds];
152
+ this.roundIdsMap.set(sessionId, merged);
153
+ // 更新元数据
154
+ this.updateMessageCount(sessionId);
155
+ }
156
+ /**
157
+ * 获取会话的 Round ID 列表
158
+ */
159
+ getRoundIds(sessionId) {
160
+ return this.roundIdsMap.get(sessionId) ?? [];
161
+ }
162
+ /**
163
+ * 设置会话的 Round ID 列表
164
+ */
165
+ setRoundIds(sessionId, roundIds) {
166
+ this.roundIdsMap.set(sessionId, [...roundIds]);
167
+ // 更新元数据
168
+ this.updateMessageCount(sessionId);
169
+ }
170
+ /**
171
+ * 创建新会话元数据
172
+ */
173
+ createSession(meta) {
174
+ // SSOT:SessionMeta 为纯展示 DTO(无 roundIds),设置轮次请走 setRoundIds 真源
175
+ this.metas.set(meta.sessionId, { ...meta });
176
+ }
177
+ /**
178
+ * 删除会话
179
+ */
180
+ deleteSession(sessionId) {
181
+ // 引用递减:被删除会话放弃其 Round 引用(refCount 归零的轮由 GC 回收)
182
+ const roundIds = this.roundIdsMap.get(sessionId) ?? [];
183
+ for (const roundId of roundIds) {
184
+ this.roundStore.decrementRef(roundId);
185
+ }
186
+ this.metas.delete(sessionId);
187
+ this.roundIdsMap.delete(sessionId);
188
+ }
189
+ // ─── 私有辅助方法 ─────────────────────────────────────
190
+ /**
191
+ * 更新会话的消息计数(round-based 固有语义缓存:每个完整轮 = User+AI 2 条)。
192
+ * 派生逻辑单一真源 = deriveMessageCount(本方法仅做「写回 meta」副作用)。
193
+ */
194
+ updateMessageCount(sessionId) {
195
+ const meta = this.metas.get(sessionId);
196
+ if (!meta)
197
+ return;
198
+ this.metas.set(sessionId, {
199
+ ...meta,
200
+ messageCount: this.deriveMessageCount(sessionId),
201
+ updatedAt: new Date().toISOString(),
202
+ });
203
+ }
204
+ /**
205
+ * 派生会话消息数(round-based 固有语义:roundIds.length * 2)——**单一真源**。
206
+ */
207
+ deriveMessageCount(sessionId) {
208
+ const roundIds = this.roundIdsMap.get(sessionId) ?? [];
209
+ return roundIds.length * 2;
210
+ }
211
+ /**
212
+ * 清空所有存储(测试用)
213
+ */
214
+ clear() {
215
+ this.metas.clear();
216
+ this.roundIdsMap.clear();
217
+ }
218
+ }
219
+ //# sourceMappingURL=inMemorySessionStore.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"inMemorySessionStore.js","sourceRoot":"","sources":["../../src/memory/inMemorySessionStore.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,89 @@
1
+ /**
2
+ * 内存会话视图加载器 — ISessionViewLoader 的内存版实现
3
+ *
4
+ * 职责:将 Session(Round ID 列表)+ RoundStore(物理存储)组合成完整视图
5
+ *
6
+ * 使用场景:
7
+ * - 宿主生产:宿主封装本类并注入文件系统存储(VS Code 宿主 WorkspaceSessionViewLoader
8
+ * 即委托本类,入口 extension.ts → sessionViewLoader.ts:delegate)
9
+ * - 测试环境(零依赖)
10
+ * - 开发调试
11
+ */
12
+ import type { IRoundStore } from '../memory/roundStore.js';
13
+ import type { ISessionStore } from '../memory/sessionStore.js';
14
+ import type { ISessionViewLoader, SessionView, SessionSummary } from '../memory/sessionViewLoader.js';
15
+ /**
16
+ * 内存会话视图加载器
17
+ *
18
+ * 实现策略:
19
+ * 1. 从 SessionStore 获取 SessionMeta(含 roundIds)
20
+ * 2. 从 RoundStore 批量加载所有 Round
21
+ * 3. 展开为扁平消息列表
22
+ * 4. 支持截断操作(分叉场景)
23
+ */
24
+ export declare class InMemorySessionViewLoader implements ISessionViewLoader {
25
+ private readonly roundStore;
26
+ private readonly sessionStore;
27
+ constructor(roundStore: IRoundStore, sessionStore: ISessionStore);
28
+ /**
29
+ * 加载会话的完整对话视图
30
+ *
31
+ * 流程:
32
+ * 1. 获取 SessionMeta(含 roundIds 列表)
33
+ * 2. 从 RoundStore 批量加载所有 Round
34
+ * 3. 展开为扁平消息列表
35
+ *
36
+ * @param sessionId - 会话 ID
37
+ * @returns 完整会话视图
38
+ * @throws Error 会话不存在时抛出
39
+ */
40
+ loadView(sessionId: string): SessionView;
41
+ /**
42
+ * 加载会话的简化摘要(用于历史列表等轻量场景)
43
+ *
44
+ * @param sessionId - 会话 ID
45
+ * @returns 会话摘要,不存在返回 null
46
+ */
47
+ loadSummary(sessionId: string): SessionSummary | null;
48
+ /**
49
+ * 批量加载多个会话的摘要
50
+ *
51
+ * @param sessionIds - 会话 ID 数组
52
+ * @returns 会话摘要数组
53
+ */
54
+ loadBatchSummaries(sessionIds: string[]): SessionSummary[];
55
+ /**
56
+ * 获取会话的消息数量
57
+ *
58
+ * 不加载完整 Round 数据,仅统计消息数
59
+ *
60
+ * @param sessionId - 会话 ID
61
+ * @returns 消息数量(User + AI)
62
+ */
63
+ getMessageCount(sessionId: string): number;
64
+ /**
65
+ * 从指定 Round 位置截断会话视图
66
+ *
67
+ * 用途:分叉操作时获取分叉点之前的对话
68
+ *
69
+ * @param sessionId - 会话 ID
70
+ * @param upToRoundId - 截断到哪个 Round(包含)
71
+ * @returns 截断后的会话视图
72
+ */
73
+ loadViewUpTo(sessionId: string, upToRoundId: string): SessionView;
74
+ /**
75
+ * 获取会话元数据
76
+ *
77
+ * 直接走 sessionStore.getSessionMeta——ISessionStore 接口**必选**方法(sessionStore.ts 契约),
78
+ * 宿主与内核实现均齐备。返回浅拷贝防外部改 meta 污染存储。
79
+ */
80
+ private getSessionMeta;
81
+ /**
82
+ * 获取会话的 Round ID 列表(SSOT:唯一真源为 sessionStore.getRoundIds)
83
+ *
84
+ * SessionMeta 已回归纯展示 DTO(无 roundIds 字段),轮次一律经真源方法读取。
85
+ * 接口契约保证返回 string[](非空数组也可能),直接展开即可,无需存在性判断。
86
+ */
87
+ private getRoundIds;
88
+ }
89
+ //# sourceMappingURL=inMemorySessionViewLoader.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"inMemorySessionViewLoader.d.ts","sourceRoot":"","sources":["../../src/memory/inMemorySessionViewLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAe,MAAM,0BAA0B,CAAC;AAQ3E,OAAO,KAAK,EACV,kBAAkB,EAClB,WAAW,EACX,cAAc,EACf,MAAM,+BAA+B,CAAC;AAEvC;;;;;;;;GAQG;AACH,qBAAa,yBAA0B,YAAW,kBAAkB;IAClE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAc;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgB;gBAEjC,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa;IAKhE;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW;IAwBxC;;;;;OAKG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAqCrD;;;;;OAKG;IACH,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE;IAkB1D;;;;;;;OAOG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAM1C;;;;;;;;OAQG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,WAAW;IA0BjE;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAKtB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;CAGpB"}