@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,60 +1,62 @@
1
- ---
2
- name: story-bible
3
- description: 设定圣经:长篇一致性档案——人物/世界观/时间线/伏笔统一存档,AI 协作刚需
4
- ---
5
-
6
- # story-bible:设定圣经
7
-
8
- ## 用途
9
-
10
- 长篇小说的**一致性总账**。写 50 章后,前文的设定/人物状态/伏笔必须还能查得到、对得上——尤其 AI 协作时,圣经是"前文"的唯一权威来源,不靠模型记忆。
11
-
12
- ## 四卷圣经
13
-
14
- ### 卷 1:人物档案
15
-
16
- ```markdown
17
- <人物名>
18
- - 目标(当前):
19
- - 动机(深层):
20
- - 压力下的反应方式:
21
- - 关系:<谁>(连接/张力/弧线)
22
- - 状态变化:<章节> 发生了什么 → 状态如何变
23
- ```
24
-
25
- ### 卷 2:世界观设定
26
-
27
- ```markdown
28
- - 时代 / 期限 / 地点 / 冲突层面(四维)
29
- - 规则清单:每条规则 + 它产生的冲突
30
- - 修订记录:何时改了什么(防止设定漂移后读者对不上)
31
- ```
32
-
33
- ### 卷 3:时间线
34
-
35
- ```markdown
36
- | 章节 | 关键事件 | 人物状态 | 伏笔 |
37
- |------|---------|---------|------|
38
- ```
39
-
40
- ### 卷 4:伏笔台账
41
-
42
- ```markdown
43
- | 伏笔 | 埋设章节 | 计划回收章节 | 当前状态(待回收/已回收/悬置) |
44
- |------|---------|------------|------------------------------|
45
- ```
46
-
47
- ## AI 协作纪律
48
-
49
- 1. **动笔前先读圣经**(read_file)——不靠对话记忆,承接前文以圣经为准;
50
- 2. **新增设定先入册再写**——正文写到新设定,先补进对应卷再落笔;
51
- 3. **矛盾以圣经为准**——正文与圣经冲突时,正文是错的,改正文;
52
- 4. **每 5 章复盘一次**:时间线/伏笔台账对一遍,防漂移。
53
-
54
- ## 校验清单
55
-
56
- - [ ] 四卷齐全且最新?
57
- - [ ] 新增设定已入册?
58
- - [ ] 伏笔台账无遗漏(埋了没登记)?
59
- - [ ] 时间线无矛盾?
60
- - [ ] 动笔前读了圣经?
1
+ ---
2
+ name: story-bible
3
+ description: 设定圣经:长篇一致性档案——人物/世界观/时间线/伏笔统一存档,AI 协作刚需
4
+ ---
5
+
6
+ # story-bible:设定圣经
7
+
8
+ ## 用途
9
+
10
+ 长篇小说的**一致性总账**。写 50 章后,前文的设定/人物状态/伏笔必须还能查得到、对得上——尤其 AI 协作时,圣经是"前文"的唯一权威来源,不靠模型记忆。
11
+
12
+ ## 四卷圣经
13
+
14
+ ### 卷 1:人物档案
15
+
16
+ ```markdown
17
+ <人物名>
18
+ - 目标(当前):
19
+ - 动机(深层):
20
+ - 压力下的反应方式:
21
+ - 关系:<谁>(连接/张力/弧线)
22
+ - 状态变化:<章节> 发生了什么 → 状态如何变
23
+ ```
24
+
25
+ ### 卷 2:世界观设定
26
+
27
+ ```markdown
28
+ - 时代 / 期限 / 地点 / 冲突层面(四维)
29
+ - 规则清单:每条规则 + 它产生的冲突
30
+ - 修订记录:何时改了什么(防止设定漂移后读者对不上)
31
+ ```
32
+
33
+ ### 卷 3:时间线
34
+
35
+ ```markdown
36
+ | 章节 | 关键事件 | 人物状态 | 伏笔 |
37
+ |------|---------|---------|------|
38
+ ```
39
+
40
+ ### 卷 4:伏笔台账
41
+
42
+ ```markdown
43
+ | 伏笔 | 埋设点(事件/场景) | 计划回收点(事件/场景) | 当前状态(待回收/已回收/悬置) |
44
+ |------|---------|------------|------------------------------|
45
+ ```
46
+
47
+ 未落正文前只标事件不标章,成文后回填章号(见 rules.md「纲是骨架、章是装箱」)。
48
+
49
+ ## AI 协作纪律
50
+
51
+ 1. **动笔前先读圣经**(read_file)——不靠对话记忆,承接前文以圣经为准;
52
+ 2. **新增设定先入册再写**——正文写到新设定,先补进对应卷再落笔;
53
+ 3. **矛盾以圣经为准**——正文与圣经冲突时,正文是错的,改正文;
54
+ 4. **每 5 章复盘一次**:时间线/伏笔台账对一遍,防漂移。
55
+
56
+ ## 校验清单
57
+
58
+ - [ ] 四卷齐全且最新?
59
+ - [ ] 新增设定已入册?
60
+ - [ ] 伏笔台账无遗漏(埋了没登记)?
61
+ - [ ] 时间线无矛盾?
62
+ - [ ] 动笔前读了圣经?