@zooique/memora 3.0.0 → 4.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 (154) hide show
  1. package/CHANGELOG.md +721 -6
  2. package/README.en.md +6 -6
  3. package/README.md +303 -303
  4. package/config.example.json +1 -8
  5. package/dist/agent/agent.d.ts +48 -4
  6. package/dist/agent/agent.d.ts.map +1 -1
  7. package/dist/agent/agent.js +130 -12
  8. package/dist/agent/agent.js.map +1 -1
  9. package/dist/agent/assembler.d.ts +19 -5
  10. package/dist/agent/assembler.d.ts.map +1 -1
  11. package/dist/agent/assembler.js +79 -16
  12. package/dist/agent/assembler.js.map +1 -1
  13. package/dist/agent/backgroundTasks.d.ts +187 -0
  14. package/dist/agent/backgroundTasks.d.ts.map +1 -0
  15. package/dist/agent/backgroundTasks.js +307 -0
  16. package/dist/agent/backgroundTasks.js.map +1 -0
  17. package/dist/agent/builtinToolHandlers.d.ts +2 -1
  18. package/dist/agent/builtinToolHandlers.d.ts.map +1 -1
  19. package/dist/agent/builtinToolHandlers.js +8 -4
  20. package/dist/agent/builtinToolHandlers.js.map +1 -1
  21. package/dist/agent/builtinTools.d.ts +15 -1
  22. package/dist/agent/builtinTools.d.ts.map +1 -1
  23. package/dist/agent/builtinTools.js +107 -27
  24. package/dist/agent/builtinTools.js.map +1 -1
  25. package/dist/agent/constants.d.ts +31 -0
  26. package/dist/agent/constants.d.ts.map +1 -1
  27. package/dist/agent/constants.js +31 -0
  28. package/dist/agent/constants.js.map +1 -1
  29. package/dist/agent/guardRail.d.ts +11 -0
  30. package/dist/agent/guardRail.d.ts.map +1 -1
  31. package/dist/agent/guardRail.js +36 -1
  32. package/dist/agent/guardRail.js.map +1 -1
  33. package/dist/agent/loop.d.ts +276 -24
  34. package/dist/agent/loop.d.ts.map +1 -1
  35. package/dist/agent/loop.js +593 -93
  36. package/dist/agent/loop.js.map +1 -1
  37. package/dist/agent/managers/archiveCoordinator.d.ts +5 -2
  38. package/dist/agent/managers/archiveCoordinator.d.ts.map +1 -1
  39. package/dist/agent/managers/archiveCoordinator.js +17 -2
  40. package/dist/agent/managers/archiveCoordinator.js.map +1 -1
  41. package/dist/agent/managers/loopMetrics.d.ts +14 -0
  42. package/dist/agent/managers/loopMetrics.d.ts.map +1 -1
  43. package/dist/agent/managers/loopMetrics.js +15 -0
  44. package/dist/agent/managers/loopMetrics.js.map +1 -1
  45. package/dist/agent/managers/memoryInspector.d.ts +1 -8
  46. package/dist/agent/managers/memoryInspector.d.ts.map +1 -1
  47. package/dist/agent/managers/memoryInspector.js +6 -30
  48. package/dist/agent/managers/memoryInspector.js.map +1 -1
  49. package/dist/agent/managers/roundSummaryGenerator.d.ts +28 -0
  50. package/dist/agent/managers/roundSummaryGenerator.d.ts.map +1 -1
  51. package/dist/agent/managers/roundSummaryGenerator.js +67 -2
  52. package/dist/agent/managers/roundSummaryGenerator.js.map +1 -1
  53. package/dist/agent/managers/sessionArchiver.d.ts +21 -3
  54. package/dist/agent/managers/sessionArchiver.d.ts.map +1 -1
  55. package/dist/agent/managers/sessionArchiver.js +20 -3
  56. package/dist/agent/managers/sessionArchiver.js.map +1 -1
  57. package/dist/agent/managers/sessionManager.d.ts.map +1 -1
  58. package/dist/agent/managers/sessionManager.js +17 -0
  59. package/dist/agent/managers/sessionManager.js.map +1 -1
  60. package/dist/agent/managers/toolCallHelpers.d.ts +109 -28
  61. package/dist/agent/managers/toolCallHelpers.d.ts.map +1 -1
  62. package/dist/agent/managers/toolCallHelpers.js +93 -37
  63. package/dist/agent/managers/toolCallHelpers.js.map +1 -1
  64. package/dist/agent/messageHistory.d.ts.map +1 -1
  65. package/dist/agent/messageHistory.js +9 -5
  66. package/dist/agent/messageHistory.js.map +1 -1
  67. package/dist/agent/seed/orchestrator.d.ts +12 -1
  68. package/dist/agent/seed/orchestrator.d.ts.map +1 -1
  69. package/dist/agent/seed/orchestrator.js +12 -1
  70. package/dist/agent/seed/orchestrator.js.map +1 -1
  71. package/dist/agent/textSanitize.d.ts +36 -0
  72. package/dist/agent/textSanitize.d.ts.map +1 -0
  73. package/dist/agent/textSanitize.js +55 -0
  74. package/dist/agent/textSanitize.js.map +1 -0
  75. package/dist/agent/toolExecutor.d.ts +48 -22
  76. package/dist/agent/toolExecutor.d.ts.map +1 -1
  77. package/dist/agent/toolExecutor.js +372 -71
  78. package/dist/agent/toolExecutor.js.map +1 -1
  79. package/dist/agent/toolLedger.d.ts +93 -41
  80. package/dist/agent/toolLedger.d.ts.map +1 -1
  81. package/dist/agent/toolLedger.js +114 -42
  82. package/dist/agent/toolLedger.js.map +1 -1
  83. package/dist/agent/toolResultOffload.d.ts +8 -0
  84. package/dist/agent/toolResultOffload.d.ts.map +1 -1
  85. package/dist/agent/toolResultOffload.js +10 -3
  86. package/dist/agent/toolResultOffload.js.map +1 -1
  87. package/dist/agent/toolRunner.d.ts +14 -7
  88. package/dist/agent/toolRunner.d.ts.map +1 -1
  89. package/dist/agent/toolRunner.js +71 -29
  90. package/dist/agent/toolRunner.js.map +1 -1
  91. package/dist/agent/tracer.d.ts +13 -1
  92. package/dist/agent/tracer.d.ts.map +1 -1
  93. package/dist/agent/types.d.ts +67 -6
  94. package/dist/agent/types.d.ts.map +1 -1
  95. package/dist/code-exec/types.d.ts +9 -0
  96. package/dist/code-exec/types.d.ts.map +1 -1
  97. package/dist/index.d.ts +21 -23
  98. package/dist/index.d.ts.map +1 -1
  99. package/dist/index.js +36 -28
  100. package/dist/index.js.map +1 -1
  101. package/dist/memory/roundStore.d.ts +67 -81
  102. package/dist/memory/roundStore.d.ts.map +1 -1
  103. package/dist/memory/roundStore.js +4 -15
  104. package/dist/memory/roundStore.js.map +1 -1
  105. package/dist/memory/types.d.ts +7 -0
  106. package/dist/memory/types.d.ts.map +1 -1
  107. package/dist/memory/types.js +4 -0
  108. package/dist/memory/types.js.map +1 -1
  109. package/dist/role-pack/rolePackManager.d.ts +42 -10
  110. package/dist/role-pack/rolePackManager.d.ts.map +1 -1
  111. package/dist/role-pack/rolePackManager.js +65 -12
  112. package/dist/role-pack/rolePackManager.js.map +1 -1
  113. package/dist/role-pack/strategyKeys.d.ts +36 -0
  114. package/dist/role-pack/strategyKeys.d.ts.map +1 -1
  115. package/dist/role-pack/strategyKeys.js +45 -0
  116. package/dist/role-pack/strategyKeys.js.map +1 -1
  117. package/dist/security/confirmEntries.d.ts +44 -0
  118. package/dist/security/confirmEntries.d.ts.map +1 -0
  119. package/dist/security/confirmEntries.js +59 -0
  120. package/dist/security/confirmEntries.js.map +1 -0
  121. package/dist/security/pathGuard.d.ts +41 -5
  122. package/dist/security/pathGuard.d.ts.map +1 -1
  123. package/dist/security/pathGuard.js +125 -4
  124. package/dist/security/pathGuard.js.map +1 -1
  125. package/dist/skill/skillScriptRunner.d.ts +147 -15
  126. package/dist/skill/skillScriptRunner.d.ts.map +1 -1
  127. package/dist/skill/skillScriptRunner.js +479 -68
  128. package/dist/skill/skillScriptRunner.js.map +1 -1
  129. package/dist/utils/configResourceManager.d.ts +6 -2
  130. package/dist/utils/configResourceManager.d.ts.map +1 -1
  131. package/dist/utils/configResourceManager.js +8 -2
  132. package/dist/utils/configResourceManager.js.map +1 -1
  133. package/dist/utils/errors.d.ts +9 -0
  134. package/dist/utils/errors.d.ts.map +1 -1
  135. package/dist/utils/errors.js +9 -0
  136. package/dist/utils/errors.js.map +1 -1
  137. package/dist/utils/eventEmitter.d.ts +57 -2
  138. package/dist/utils/eventEmitter.d.ts.map +1 -1
  139. package/dist/utils/eventEmitter.js +23 -0
  140. package/dist/utils/eventEmitter.js.map +1 -1
  141. package/dist/utils/time.d.ts +5 -2
  142. package/dist/utils/time.d.ts.map +1 -1
  143. package/dist/utils/time.js +5 -2
  144. package/dist/utils/time.js.map +1 -1
  145. package/docs/memora-api-reference.md +121 -20
  146. package/docs/memora-/346/216/245/345/205/245/346/214/207/345/215/227.md +6 -5
  147. package/package.json +4 -4
  148. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/persona.md +46 -46
  149. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/rules.md +16 -15
  150. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/emotion-wave.md +46 -46
  151. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/foreshadow.md +29 -29
  152. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/outline-expand.md +48 -46
  153. 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 -441
  154. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/story-bible.md +62 -60
@@ -1,46 +1,48 @@
1
- ---
2
- name: outline-expand
3
- description: 大纲→成文展开:骨架到章节/场景正文的分步生成,每步可确认
4
- ---
5
-
6
- # outline-expand:大纲→成文展开
7
-
8
- ## 用途
9
-
10
- 三层结构 → 大纲 → 成文之间的"最后一公里"。核心:**不一口气写长稿**,分步展开、每步确认,防止方向跑偏后返工。
11
-
12
- ## 五级展开漏斗
13
-
14
- ```
15
- ① 三层结构(需求/内核/形式)+ Logline
16
- ↓ 展开
17
- ② 大纲(卷/部级:每卷解决什么冲突、情绪主线、大高潮位置)
18
- ↓ 展开
19
- ③ 章纲(每章:激励事件/价值转变/章末钩子)
20
- ↓ 展开
21
- ④ 场景清单(每场景:人物目标/冲突/价值转变/情绪落点)
22
- ↓ 展开
23
- ⑤ 成文(场景→章→卷正文)
24
- ```
25
-
26
- **每一级都让作者确认再降级**——跑偏的成本随降级指数级上升,确认点是止损闸门。
27
-
28
- ## 展开纪律
29
-
30
- - **大纲不写死细节**:大纲是"路线图"不是"剧本"——人物在写作中会"活"起来,允许偏离但要登记(为什么偏离、新方向是否更好);
31
- - **每章开写前回读章纲**:防止"写着写着忘了这章要干嘛";
32
- - **成文时只盯当前场景**:当前场景写透,全书大局交给大纲(防信息过载);
33
- - **卡住时的回退**:卡在场景→回章纲找这章目的;卡在章→回大纲找这卷任务;找不到任务 = 这章可能不该存在。
34
-
35
- ## 交付节奏
36
-
37
- - 一次给 1-2 章成文(不是一整卷);
38
- - 每章交付后问:**这章达到章纲的转变和钩子了吗?**——达到才继续,未达先修。
39
-
40
- ## 校验清单
41
-
42
- - [ ] 五级逐层展开、每级确认过?
43
- - [ ] 大纲是路线图不写死?
44
- - [ ] 偏离有登记?
45
- - [ ] 成文聚焦当前场景?
46
- - [ ] 每次 1-2 章、章后验证转变与钩子?
1
+ ---
2
+ name: outline-expand
3
+ description: 大纲→成文展开:骨架到章节/场景正文的分步生成,每步可确认
4
+ ---
5
+
6
+ # outline-expand:大纲→成文展开
7
+
8
+ ## 用途
9
+
10
+ 三层结构 → 大纲 → 成文之间的"最后一公里"。核心:**不一口气写长稿**,分步展开、每步确认,防止方向跑偏后返工。
11
+
12
+ ## 五级展开漏斗
13
+
14
+ ```
15
+ ① 三层结构(需求/内核/形式)+ Logline
16
+ ↓ 展开
17
+ ② 大纲(卷/部级:每卷解决什么冲突、情绪主线、大高潮位置)
18
+ ↓ 展开
19
+ ③ 细纲(逐事件:激励/价值转变/钩子——只排事件序列,不排章节)
20
+ ↓ 展开
21
+ ④ 场景清单(每场景:人物目标/冲突/价值转变/情绪落点)
22
+ ↓ 展开
23
+ ⑤ 成文(场景→章→卷正文:装箱成章,此时章节才诞生)
24
+ ```
25
+
26
+ **每一级都让作者确认再降级**——跑偏的成本随降级指数级上升,确认点是止损闸门。
27
+
28
+ ## 展开纪律
29
+
30
+ - **细纲不排章节**:③ 是事件序列不是章节清单——预排章号会让后续插入支线/番外时章号错位;章在 ⑤ 装箱时才产生(见 rules.md「纲是骨架、章是装箱」);
31
+ - **大纲不写死细节**:大纲是"路线图"不是"剧本"——人物在写作中会"活"起来,允许偏离但要登记(为什么偏离、新方向是否更好);
32
+ - **开写前回读细纲**:防止"写着写着忘了这段要干嘛";
33
+ - **成文时只盯当前场景**:当前场景写透,全书大局交给大纲(防信息过载);
34
+ - **卡住时的回退**:卡在场景→回细纲找当前事件的目的;卡在章→回大纲找这卷任务;找不到任务 = 这章可能不该存在。
35
+
36
+ ## 交付节奏
37
+
38
+ - 一次给 1-2 章成文(不是一整卷);
39
+ - 每章交付后问:**这章装箱的事件达到转变与钩子了吗?**——达到才继续,未达先修。
40
+
41
+ ## 校验清单
42
+
43
+ - [ ] 五级逐层展开、每级确认过?
44
+ - [ ] 大纲是路线图不写死?
45
+ - [ ] 细纲只有事件序列、无章号预排?
46
+ - [ ] 偏离有登记?
47
+ - [ ] 成文聚焦当前场景?
48
+ - [ ] 每次 1-2 章、章后验证转变与钩子?