@zooique/memora 1.0.1 → 2.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 (163) hide show
  1. package/README.md +4 -4
  2. package/dist/agent/agent.d.ts +66 -99
  3. package/dist/agent/agent.d.ts.map +1 -1
  4. package/dist/agent/agent.js +263 -208
  5. package/dist/agent/agent.js.map +1 -1
  6. package/dist/agent/assembler.d.ts +3 -3
  7. package/dist/agent/assembler.d.ts.map +1 -1
  8. package/dist/agent/assembler.js +10 -9
  9. package/dist/agent/assembler.js.map +1 -1
  10. package/dist/agent/builtinToolHandlers.d.ts +1 -1
  11. package/dist/agent/builtinToolHandlers.d.ts.map +1 -1
  12. package/dist/agent/builtinToolHandlers.js +5 -4
  13. package/dist/agent/builtinToolHandlers.js.map +1 -1
  14. package/dist/agent/loop.d.ts +79 -1
  15. package/dist/agent/loop.d.ts.map +1 -1
  16. package/dist/agent/loop.js +315 -189
  17. package/dist/agent/loop.js.map +1 -1
  18. package/dist/agent/managers/chatLockManager.d.ts +116 -0
  19. package/dist/agent/managers/chatLockManager.d.ts.map +1 -0
  20. package/dist/agent/managers/chatLockManager.js +191 -0
  21. package/dist/agent/managers/chatLockManager.js.map +1 -0
  22. package/dist/agent/managers/insightExtractor.d.ts +31 -3
  23. package/dist/agent/managers/insightExtractor.d.ts.map +1 -1
  24. package/dist/agent/managers/insightExtractor.js +122 -51
  25. package/dist/agent/managers/insightExtractor.js.map +1 -1
  26. package/dist/agent/managers/memoryAdvisor.d.ts +102 -2
  27. package/dist/agent/managers/memoryAdvisor.d.ts.map +1 -1
  28. package/dist/agent/managers/memoryAdvisor.js +262 -4
  29. package/dist/agent/managers/memoryAdvisor.js.map +1 -1
  30. package/dist/agent/managers/memoryDecayScheduler.d.ts +85 -0
  31. package/dist/agent/managers/memoryDecayScheduler.d.ts.map +1 -1
  32. package/dist/agent/managers/memoryDecayScheduler.js +215 -0
  33. package/dist/agent/managers/memoryDecayScheduler.js.map +1 -1
  34. package/dist/agent/managers/memoryInspector.d.ts +222 -14
  35. package/dist/agent/managers/memoryInspector.d.ts.map +1 -1
  36. package/dist/agent/managers/memoryInspector.js +436 -10
  37. package/dist/agent/managers/memoryInspector.js.map +1 -1
  38. package/dist/agent/managers/relationBuilder.d.ts +4 -4
  39. package/dist/agent/managers/relationBuilder.d.ts.map +1 -1
  40. package/dist/agent/managers/relationBuilder.js +3 -2
  41. package/dist/agent/managers/relationBuilder.js.map +1 -1
  42. package/dist/agent/managers/sessionArchiver.d.ts +6 -0
  43. package/dist/agent/managers/sessionArchiver.d.ts.map +1 -1
  44. package/dist/agent/managers/sessionArchiver.js +68 -8
  45. package/dist/agent/managers/sessionArchiver.js.map +1 -1
  46. package/dist/agent/managers/sessionManager.d.ts.map +1 -1
  47. package/dist/agent/managers/sessionManager.js +9 -17
  48. package/dist/agent/managers/sessionManager.js.map +1 -1
  49. package/dist/agent/managers/textPolishManager.d.ts +62 -0
  50. package/dist/agent/managers/textPolishManager.d.ts.map +1 -0
  51. package/dist/agent/managers/textPolishManager.js +99 -0
  52. package/dist/agent/managers/textPolishManager.js.map +1 -0
  53. package/dist/agent/personaMatcher.d.ts +29 -0
  54. package/dist/agent/personaMatcher.d.ts.map +1 -0
  55. package/dist/agent/personaMatcher.js +60 -0
  56. package/dist/agent/personaMatcher.js.map +1 -0
  57. package/dist/agent/toolExecutor.d.ts +2 -2
  58. package/dist/agent/toolExecutor.d.ts.map +1 -1
  59. package/dist/agent/toolExecutor.js +2 -1
  60. package/dist/agent/toolExecutor.js.map +1 -1
  61. package/dist/agent/tracer.d.ts +31 -0
  62. package/dist/agent/tracer.d.ts.map +1 -1
  63. package/dist/agent/tracer.js +31 -0
  64. package/dist/agent/tracer.js.map +1 -1
  65. package/dist/agent/types.d.ts +124 -0
  66. package/dist/agent/types.d.ts.map +1 -1
  67. package/dist/agent/types.js +38 -0
  68. package/dist/agent/types.js.map +1 -1
  69. package/dist/config/loader.d.ts +4 -4
  70. package/dist/config/loader.js +23 -1
  71. package/dist/config/loader.js.map +1 -1
  72. package/dist/eval/evalRunner.d.ts +94 -0
  73. package/dist/eval/evalRunner.d.ts.map +1 -0
  74. package/dist/eval/evalRunner.js +141 -0
  75. package/dist/eval/evalRunner.js.map +1 -0
  76. package/dist/eval/evalTypes.d.ts +21 -0
  77. package/dist/eval/evalTypes.d.ts.map +1 -1
  78. package/dist/eval/evalTypes.js +15 -0
  79. package/dist/eval/evalTypes.js.map +1 -1
  80. package/dist/eval/scenarios.d.ts +33 -0
  81. package/dist/eval/scenarios.d.ts.map +1 -0
  82. package/dist/eval/scenarios.js +109 -0
  83. package/dist/eval/scenarios.js.map +1 -0
  84. package/dist/index.d.ts +41 -7
  85. package/dist/index.d.ts.map +1 -1
  86. package/dist/index.js +36 -5
  87. package/dist/index.js.map +1 -1
  88. package/dist/llm/abortSignal.d.ts +27 -0
  89. package/dist/llm/abortSignal.d.ts.map +1 -0
  90. package/dist/llm/abortSignal.js +44 -0
  91. package/dist/llm/abortSignal.js.map +1 -0
  92. package/dist/llm/embedding.d.ts +1 -12
  93. package/dist/llm/embedding.d.ts.map +1 -1
  94. package/dist/llm/embedding.js +5 -17
  95. package/dist/llm/embedding.js.map +1 -1
  96. package/dist/llm/openaiCompatible.d.ts.map +1 -1
  97. package/dist/llm/openaiCompatible.js +15 -25
  98. package/dist/llm/openaiCompatible.js.map +1 -1
  99. package/dist/memory/inMemoryStorage.d.ts.map +1 -1
  100. package/dist/memory/inMemoryStorage.js +7 -6
  101. package/dist/memory/inMemoryStorage.js.map +1 -1
  102. package/dist/memory/lockManager.d.ts.map +1 -1
  103. package/dist/memory/lockManager.js +4 -12
  104. package/dist/memory/lockManager.js.map +1 -1
  105. package/dist/memory/projectManager.d.ts +6 -6
  106. package/dist/memory/projectManager.d.ts.map +1 -1
  107. package/dist/memory/projectManager.js +12 -12
  108. package/dist/memory/projectManager.js.map +1 -1
  109. package/dist/memory/projectRegistry.d.ts.map +1 -1
  110. package/dist/memory/projectRegistry.js +4 -12
  111. package/dist/memory/projectRegistry.js.map +1 -1
  112. package/dist/memory/recall.js +2 -2
  113. package/dist/memory/recall.js.map +1 -1
  114. package/dist/memory/sourceValidation.d.ts +6 -0
  115. package/dist/memory/sourceValidation.d.ts.map +1 -1
  116. package/dist/memory/sourceValidation.js +3 -1
  117. package/dist/memory/sourceValidation.js.map +1 -1
  118. package/dist/memory/vectorStore.d.ts +16 -2
  119. package/dist/memory/vectorStore.d.ts.map +1 -1
  120. package/dist/memory/vectorStore.js.map +1 -1
  121. package/dist/persona/personaManager.d.ts +30 -4
  122. package/dist/persona/personaManager.d.ts.map +1 -1
  123. package/dist/persona/personaManager.js +47 -14
  124. package/dist/persona/personaManager.js.map +1 -1
  125. package/dist/skill/skillManager.d.ts.map +1 -1
  126. package/dist/skill/skillManager.js +2 -1
  127. package/dist/skill/skillManager.js.map +1 -1
  128. package/dist/utils/array.d.ts +24 -0
  129. package/dist/utils/array.d.ts.map +1 -0
  130. package/dist/utils/array.js +24 -0
  131. package/dist/utils/array.js.map +1 -0
  132. package/dist/utils/errors.d.ts +10 -8
  133. package/dist/utils/errors.d.ts.map +1 -1
  134. package/dist/utils/errors.js +12 -9
  135. package/dist/utils/errors.js.map +1 -1
  136. package/dist/utils/eventEmitter.d.ts +7 -0
  137. package/dist/utils/eventEmitter.d.ts.map +1 -1
  138. package/dist/utils/eventEmitter.js.map +1 -1
  139. package/dist/utils/objects.d.ts +17 -0
  140. package/dist/utils/objects.d.ts.map +1 -0
  141. package/dist/utils/objects.js +19 -0
  142. package/dist/utils/objects.js.map +1 -0
  143. package/dist/utils/segmenter.d.ts +11 -0
  144. package/dist/utils/segmenter.d.ts.map +1 -1
  145. package/dist/utils/segmenter.js +13 -0
  146. package/dist/utils/segmenter.js.map +1 -1
  147. package/dist/utils/strings.d.ts +22 -1
  148. package/dist/utils/strings.d.ts.map +1 -1
  149. package/dist/utils/strings.js +29 -1
  150. package/dist/utils/strings.js.map +1 -1
  151. package/dist/utils/time.d.ts +18 -3
  152. package/dist/utils/time.d.ts.map +1 -1
  153. package/dist/utils/time.js +24 -8
  154. package/dist/utils/time.js.map +1 -1
  155. package/dist/utils/toError.d.ts +8 -4
  156. package/dist/utils/toError.d.ts.map +1 -1
  157. package/dist/utils/toError.js +25 -5
  158. package/dist/utils/toError.js.map +1 -1
  159. package/package.json +11 -1
  160. package/dist/agent/managers/memoryMutator.d.ts +0 -92
  161. package/dist/agent/managers/memoryMutator.d.ts.map +0 -1
  162. package/dist/agent/managers/memoryMutator.js +0 -94
  163. package/dist/agent/managers/memoryMutator.js.map +0 -1
@@ -1,94 +0,0 @@
1
- /**
2
- * 记忆写入器类
3
- *
4
- * 宿主项目通过 agent.memoryMutator 访问写操作,无需绕过 inspector 直接访问 agent.storage
5
- * (后者已废弃,详见 agent.ts)。
6
- */
7
- export class MemoryMutator {
8
- index;
9
- /** 关系存储侧车(可选,ADR-014,未注入时关系写方法静默 no-op) */
10
- relationStore;
11
- /**
12
- * @param index - 记忆存储(用于 upsert/delete/restore/purge/purgeExpired)
13
- * @param relationStore - 关系存储侧车(可选,用于 addRelation/removeRelation)
14
- */
15
- constructor(index, relationStore = null) {
16
- this.index = index;
17
- this.relationStore = relationStore;
18
- }
19
- // ─── 记忆写入(IMemoryStorage 代理) ───────────────────
20
- /**
21
- * 插入或更新记忆
22
- *
23
- * @param memory 完整记忆对象
24
- */
25
- upsert(memory) {
26
- this.index.upsert(memory);
27
- }
28
- /**
29
- * 软删除记忆(写入 deletedAt)
30
- *
31
- * @param id 记忆唯一标识(${source}:${name} 格式)
32
- */
33
- delete(id) {
34
- this.index.delete(id);
35
- }
36
- /**
37
- * 恢复软删除的记忆(清除 deletedAt)
38
- *
39
- * @param id 记忆唯一标识
40
- */
41
- restore(id) {
42
- this.index.restore(id);
43
- }
44
- /**
45
- * 物理删除记忆(不可恢复,用于回收站彻底删除)
46
- *
47
- * @param id 记忆唯一标识
48
- */
49
- purge(id) {
50
- this.index.purge(id);
51
- }
52
- /**
53
- * 清理过期的软删除记忆
54
- *
55
- * 物理删除所有 deletedAt 早于 before 的记忆。
56
- * 由宿主项目的定时器调用(默认 30 天保留期)。
57
- *
58
- * @param before 时间阈值,deletedAt 早于此值的记忆将被物理删除
59
- * @returns 被清理的记忆数量
60
- */
61
- purgeExpired(before) {
62
- return this.index.purgeExpired(before);
63
- }
64
- // ─── 关系写入(IMemoryRelationStore 代理,ADR-014 侧车) ───
65
- /**
66
- * 添加记忆关系(透传 relationStore)
67
- *
68
- * 用于宿主 UI 手动创建关系(关系图右键菜单 → 连线 → 创建关系)。
69
- * relationStore 未注入时静默降级(不阻塞)。
70
- *
71
- * @param relation 关系边数据
72
- */
73
- addRelation(relation) {
74
- if (!this.relationStore)
75
- return;
76
- this.relationStore.addRelation(relation);
77
- }
78
- /**
79
- * 删除记忆关系(透传 relationStore)
80
- *
81
- * 用于宿主 UI 手动删除关系(关系图右键菜单 → 编辑关系 → 删除)。
82
- * relationStore 未注入时静默降级(不阻塞)。
83
- *
84
- * @param sourceId 关系起点
85
- * @param targetId 关系终点
86
- * @param type 关系类型
87
- */
88
- removeRelation(sourceId, targetId, type) {
89
- if (!this.relationStore)
90
- return;
91
- this.relationStore.removeRelation(sourceId, targetId, type);
92
- }
93
- }
94
- //# sourceMappingURL=memoryMutator.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"memoryMutator.js","sourceRoot":"","sources":["../../../src/agent/managers/memoryMutator.ts"],"names":[],"mappings":"AAsBA;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IASL;IARnB,2CAA2C;IAC1B,aAAa,CAA8B;IAE5D;;;OAGG;IACH,YACmB,KAAqB,EACtC,gBAA6C,IAAI;QADhC,UAAK,GAAL,KAAK,CAAgB;QAGtC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAED,kDAAkD;IAElD;;;;OAIG;IACH,MAAM,CAAC,MAAc;QACnB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,EAAU;QACf,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,EAAU;QAChB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,EAAU;QACd,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACvB,CAAC;IAED;;;;;;;;OAQG;IACH,YAAY,CAAC,MAAY;QACvB,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,mDAAmD;IAEnD;;;;;;;OAOG;IACH,WAAW,CAAC,QAAwB;QAClC,IAAI,CAAC,IAAI,CAAC,aAAa;YAAE,OAAO;QAChC,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;;;OASG;IACH,cAAc,CAAC,QAAgB,EAAE,QAAgB,EAAE,IAAY;QAC7D,IAAI,CAAC,IAAI,CAAC,aAAa;YAAE,OAAO;QAChC,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC9D,CAAC;CACF"}