@zooique/memora 3.0.1 → 5.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 (282) hide show
  1. package/CHANGELOG.md +161 -1033
  2. package/README.en.md +46 -39
  3. package/README.md +40 -35
  4. package/config.example.json +1 -8
  5. package/dist/agent/agent.d.ts +88 -80
  6. package/dist/agent/agent.d.ts.map +1 -1
  7. package/dist/agent/agent.js +272 -221
  8. package/dist/agent/agent.js.map +1 -1
  9. package/dist/agent/assembler.d.ts +22 -21
  10. package/dist/agent/assembler.d.ts.map +1 -1
  11. package/dist/agent/assembler.js +120 -46
  12. package/dist/agent/assembler.js.map +1 -1
  13. package/dist/agent/backgroundTasks.d.ts +194 -0
  14. package/dist/agent/backgroundTasks.d.ts.map +1 -0
  15. package/dist/agent/backgroundTasks.js +314 -0
  16. package/dist/agent/backgroundTasks.js.map +1 -0
  17. package/dist/agent/budget.d.ts +23 -5
  18. package/dist/agent/budget.d.ts.map +1 -1
  19. package/dist/agent/budget.js +8 -2
  20. package/dist/agent/budget.js.map +1 -1
  21. package/dist/agent/builtinToolHandlers.d.ts +29 -9
  22. package/dist/agent/builtinToolHandlers.d.ts.map +1 -1
  23. package/dist/agent/builtinToolHandlers.js +53 -13
  24. package/dist/agent/builtinToolHandlers.js.map +1 -1
  25. package/dist/agent/builtinTools.d.ts +15 -1
  26. package/dist/agent/builtinTools.d.ts.map +1 -1
  27. package/dist/agent/builtinTools.js +111 -30
  28. package/dist/agent/builtinTools.js.map +1 -1
  29. package/dist/agent/constants.d.ts +31 -6
  30. package/dist/agent/constants.d.ts.map +1 -1
  31. package/dist/agent/constants.js +38 -8
  32. package/dist/agent/constants.js.map +1 -1
  33. package/dist/agent/contextManager.d.ts +8 -0
  34. package/dist/agent/contextManager.d.ts.map +1 -1
  35. package/dist/agent/contextManager.js +45 -3
  36. package/dist/agent/contextManager.js.map +1 -1
  37. package/dist/agent/contextPreparer.d.ts +1 -1
  38. package/dist/agent/contextPreparer.d.ts.map +1 -1
  39. package/dist/agent/contextPreparer.js +15 -10
  40. package/dist/agent/contextPreparer.js.map +1 -1
  41. package/dist/agent/guardRail.d.ts +12 -1
  42. package/dist/agent/guardRail.d.ts.map +1 -1
  43. package/dist/agent/guardRail.js +37 -2
  44. package/dist/agent/guardRail.js.map +1 -1
  45. package/dist/agent/loop.d.ts +319 -34
  46. package/dist/agent/loop.d.ts.map +1 -1
  47. package/dist/agent/loop.js +713 -110
  48. package/dist/agent/loop.js.map +1 -1
  49. package/dist/agent/managers/archiveCoordinator.d.ts +19 -4
  50. package/dist/agent/managers/archiveCoordinator.d.ts.map +1 -1
  51. package/dist/agent/managers/archiveCoordinator.js +25 -4
  52. package/dist/agent/managers/archiveCoordinator.js.map +1 -1
  53. package/dist/agent/managers/chatLockManager.d.ts +3 -9
  54. package/dist/agent/managers/chatLockManager.d.ts.map +1 -1
  55. package/dist/agent/managers/chatLockManager.js +7 -25
  56. package/dist/agent/managers/chatLockManager.js.map +1 -1
  57. package/dist/agent/managers/llmCaller.d.ts.map +1 -1
  58. package/dist/agent/managers/llmCaller.js +27 -1
  59. package/dist/agent/managers/llmCaller.js.map +1 -1
  60. package/dist/agent/managers/loopMetrics.d.ts +14 -0
  61. package/dist/agent/managers/loopMetrics.d.ts.map +1 -1
  62. package/dist/agent/managers/loopMetrics.js +15 -0
  63. package/dist/agent/managers/loopMetrics.js.map +1 -1
  64. package/dist/agent/managers/memoryInspector.d.ts +13 -15
  65. package/dist/agent/managers/memoryInspector.d.ts.map +1 -1
  66. package/dist/agent/managers/memoryInspector.js +38 -49
  67. package/dist/agent/managers/memoryInspector.js.map +1 -1
  68. package/dist/agent/managers/roundSummaryGenerator.d.ts +31 -1
  69. package/dist/agent/managers/roundSummaryGenerator.d.ts.map +1 -1
  70. package/dist/agent/managers/roundSummaryGenerator.js +81 -6
  71. package/dist/agent/managers/roundSummaryGenerator.js.map +1 -1
  72. package/dist/agent/managers/sessionArchiver.d.ts +35 -3
  73. package/dist/agent/managers/sessionArchiver.d.ts.map +1 -1
  74. package/dist/agent/managers/sessionArchiver.js +34 -3
  75. package/dist/agent/managers/sessionArchiver.js.map +1 -1
  76. package/dist/agent/managers/sessionManager.d.ts +21 -88
  77. package/dist/agent/managers/sessionManager.d.ts.map +1 -1
  78. package/dist/agent/managers/sessionManager.js +94 -278
  79. package/dist/agent/managers/sessionManager.js.map +1 -1
  80. package/dist/agent/managers/toolCallHelpers.d.ts +109 -28
  81. package/dist/agent/managers/toolCallHelpers.d.ts.map +1 -1
  82. package/dist/agent/managers/toolCallHelpers.js +93 -37
  83. package/dist/agent/managers/toolCallHelpers.js.map +1 -1
  84. package/dist/agent/messageHistory.d.ts.map +1 -1
  85. package/dist/agent/messageHistory.js +9 -5
  86. package/dist/agent/messageHistory.js.map +1 -1
  87. package/dist/agent/seed/orchestrator.d.ts +12 -1
  88. package/dist/agent/seed/orchestrator.d.ts.map +1 -1
  89. package/dist/agent/seed/orchestrator.js +15 -4
  90. package/dist/agent/seed/orchestrator.js.map +1 -1
  91. package/dist/agent/seed/prepare.d.ts.map +1 -1
  92. package/dist/agent/seed/prepare.js +9 -4
  93. package/dist/agent/seed/prepare.js.map +1 -1
  94. package/dist/agent/seed/types.d.ts +11 -4
  95. package/dist/agent/seed/types.d.ts.map +1 -1
  96. package/dist/agent/seed/types.js +2 -2
  97. package/dist/agent/textSanitize.d.ts +36 -0
  98. package/dist/agent/textSanitize.d.ts.map +1 -0
  99. package/dist/agent/textSanitize.js +55 -0
  100. package/dist/agent/textSanitize.js.map +1 -0
  101. package/dist/agent/toolExecutor.d.ts +97 -26
  102. package/dist/agent/toolExecutor.d.ts.map +1 -1
  103. package/dist/agent/toolExecutor.js +444 -78
  104. package/dist/agent/toolExecutor.js.map +1 -1
  105. package/dist/agent/toolLedger.d.ts +93 -41
  106. package/dist/agent/toolLedger.d.ts.map +1 -1
  107. package/dist/agent/toolLedger.js +114 -42
  108. package/dist/agent/toolLedger.js.map +1 -1
  109. package/dist/agent/toolResultCache.js +1 -1
  110. package/dist/agent/toolResultOffload.d.ts +8 -0
  111. package/dist/agent/toolResultOffload.d.ts.map +1 -1
  112. package/dist/agent/toolResultOffload.js +10 -3
  113. package/dist/agent/toolResultOffload.js.map +1 -1
  114. package/dist/agent/toolRunner.d.ts +16 -7
  115. package/dist/agent/toolRunner.d.ts.map +1 -1
  116. package/dist/agent/toolRunner.js +74 -29
  117. package/dist/agent/toolRunner.js.map +1 -1
  118. package/dist/agent/tracer.d.ts +13 -1
  119. package/dist/agent/tracer.d.ts.map +1 -1
  120. package/dist/agent/types.d.ts +74 -30
  121. package/dist/agent/types.d.ts.map +1 -1
  122. package/dist/code-exec/types.d.ts +9 -0
  123. package/dist/code-exec/types.d.ts.map +1 -1
  124. package/dist/index.d.ts +28 -41
  125. package/dist/index.d.ts.map +1 -1
  126. package/dist/index.js +65 -54
  127. package/dist/index.js.map +1 -1
  128. package/dist/logging/logger.d.ts +4 -1
  129. package/dist/logging/logger.d.ts.map +1 -1
  130. package/dist/logging/logger.js +5 -2
  131. package/dist/logging/logger.js.map +1 -1
  132. package/dist/memory/gcService.d.ts.map +1 -1
  133. package/dist/memory/gcService.js +3 -5
  134. package/dist/memory/gcService.js.map +1 -1
  135. package/dist/memory/inMemorySessionStore.d.ts +2 -2
  136. package/dist/memory/inMemorySessionStore.js +2 -2
  137. package/dist/memory/inMemoryStorage.d.ts +4 -3
  138. package/dist/memory/inMemoryStorage.d.ts.map +1 -1
  139. package/dist/memory/inMemoryStorage.js +2 -2
  140. package/dist/memory/inMemoryStorage.js.map +1 -1
  141. package/dist/memory/nodeSqliteStorage.d.ts +17 -0
  142. package/dist/memory/nodeSqliteStorage.d.ts.map +1 -0
  143. package/dist/memory/nodeSqliteStorage.js +393 -0
  144. package/dist/memory/nodeSqliteStorage.js.map +1 -0
  145. package/dist/memory/projectManager.d.ts +10 -20
  146. package/dist/memory/projectManager.d.ts.map +1 -1
  147. package/dist/memory/projectManager.js +27 -41
  148. package/dist/memory/projectManager.js.map +1 -1
  149. package/dist/memory/roundStore.d.ts +143 -82
  150. package/dist/memory/roundStore.d.ts.map +1 -1
  151. package/dist/memory/roundStore.js +4 -15
  152. package/dist/memory/roundStore.js.map +1 -1
  153. package/dist/memory/roundSummaryLookup.d.ts +26 -0
  154. package/dist/memory/roundSummaryLookup.d.ts.map +1 -0
  155. package/dist/memory/roundSummaryLookup.js +19 -0
  156. package/dist/memory/roundSummaryLookup.js.map +1 -0
  157. package/dist/memory/sessionStore.d.ts +19 -2
  158. package/dist/memory/sessionStore.d.ts.map +1 -1
  159. package/dist/memory/sessionStore.js.map +1 -1
  160. package/dist/memory/sourceValidation.d.ts +2 -13
  161. package/dist/memory/sourceValidation.d.ts.map +1 -1
  162. package/dist/memory/sourceValidation.js +5 -16
  163. package/dist/memory/sourceValidation.js.map +1 -1
  164. package/dist/memory/storageInterface.d.ts +26 -16
  165. package/dist/memory/storageInterface.d.ts.map +1 -1
  166. package/dist/memory/supersedeResolve.d.ts +39 -0
  167. package/dist/memory/supersedeResolve.d.ts.map +1 -0
  168. package/dist/memory/supersedeResolve.js +16 -0
  169. package/dist/memory/supersedeResolve.js.map +1 -0
  170. package/dist/memory/types.d.ts +10 -2
  171. package/dist/memory/types.d.ts.map +1 -1
  172. package/dist/memory/types.js +6 -1
  173. package/dist/memory/types.js.map +1 -1
  174. package/dist/role-pack/rolePackManager.d.ts +74 -33
  175. package/dist/role-pack/rolePackManager.d.ts.map +1 -1
  176. package/dist/role-pack/rolePackManager.js +112 -53
  177. package/dist/role-pack/rolePackManager.js.map +1 -1
  178. package/dist/role-pack/strategyKeys.d.ts +44 -0
  179. package/dist/role-pack/strategyKeys.d.ts.map +1 -1
  180. package/dist/role-pack/strategyKeys.js +55 -0
  181. package/dist/role-pack/strategyKeys.js.map +1 -1
  182. package/dist/role-pack/strategyResolver.d.ts +6 -1
  183. package/dist/role-pack/strategyResolver.d.ts.map +1 -1
  184. package/dist/role-pack/strategyResolver.js +20 -2
  185. package/dist/role-pack/strategyResolver.js.map +1 -1
  186. package/dist/role-pack/types.d.ts +5 -1
  187. package/dist/role-pack/types.d.ts.map +1 -1
  188. package/dist/security/confirmEntries.d.ts +44 -0
  189. package/dist/security/confirmEntries.d.ts.map +1 -0
  190. package/dist/security/confirmEntries.js +59 -0
  191. package/dist/security/confirmEntries.js.map +1 -0
  192. package/dist/security/pathGuard.d.ts +42 -6
  193. package/dist/security/pathGuard.d.ts.map +1 -1
  194. package/dist/security/pathGuard.js +126 -5
  195. package/dist/security/pathGuard.js.map +1 -1
  196. package/dist/skill/skillScriptRunner.d.ts +147 -15
  197. package/dist/skill/skillScriptRunner.d.ts.map +1 -1
  198. package/dist/skill/skillScriptRunner.js +479 -68
  199. package/dist/skill/skillScriptRunner.js.map +1 -1
  200. package/dist/utils/backgroundTask.d.ts +56 -34
  201. package/dist/utils/backgroundTask.d.ts.map +1 -1
  202. package/dist/utils/backgroundTask.js +130 -99
  203. package/dist/utils/backgroundTask.js.map +1 -1
  204. package/dist/utils/configResourceManager.d.ts +6 -2
  205. package/dist/utils/configResourceManager.d.ts.map +1 -1
  206. package/dist/utils/configResourceManager.js +8 -2
  207. package/dist/utils/configResourceManager.js.map +1 -1
  208. package/dist/utils/errors.d.ts +12 -2
  209. package/dist/utils/errors.d.ts.map +1 -1
  210. package/dist/utils/errors.js +12 -2
  211. package/dist/utils/errors.js.map +1 -1
  212. package/dist/utils/eventEmitter.d.ts +76 -23
  213. package/dist/utils/eventEmitter.d.ts.map +1 -1
  214. package/dist/utils/eventEmitter.js +23 -3
  215. package/dist/utils/eventEmitter.js.map +1 -1
  216. package/dist/utils/time.d.ts +8 -5
  217. package/dist/utils/time.d.ts.map +1 -1
  218. package/dist/utils/time.js +8 -5
  219. package/dist/utils/time.js.map +1 -1
  220. package/dist/utils/toError.d.ts +1 -1
  221. package/dist/utils/toError.js +1 -1
  222. package/dist/web-fetch/loginWall.d.ts +39 -0
  223. package/dist/web-fetch/loginWall.d.ts.map +1 -0
  224. package/dist/web-fetch/loginWall.js +78 -0
  225. package/dist/web-fetch/loginWall.js.map +1 -0
  226. package/dist/web-fetch/types.d.ts +8 -0
  227. package/dist/web-fetch/types.d.ts.map +1 -1
  228. package/dist/web-fetch/webFetchProvider.d.ts.map +1 -1
  229. package/dist/web-fetch/webFetchProvider.js +3 -1
  230. package/dist/web-fetch/webFetchProvider.js.map +1 -1
  231. package/dist/web-search/fetchWebSearchProvider.js +28 -23
  232. package/dist/web-search/fetchWebSearchProvider.js.map +1 -1
  233. package/docs/architecture/role-pack-authoring-guide.md +3 -1
  234. package/docs/architecture/role-pack-spec.md +2 -1
  235. package/docs/memora-api-reference.md +1349 -1175
  236. package/docs/memora-/345/215/207/347/272/247/346/214/207/345/215/227-4.x-/345/210/260-5.0.0.md +385 -0
  237. package/docs/memora-/346/216/245/345/205/245/346/214/207/345/215/227.md +91 -52
  238. package/docs/role-pack-/345/274/200/346/224/276/351/224/256/346/214/207/345/215/227.md +148 -148
  239. package/package.json +9 -4
  240. package/role-packs/README.md +41 -40
  241. package/role-packs/memora/345/212/251/346/211/213/rules.md +4 -4
  242. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/manifest.json +1 -0
  243. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/persona.md +1 -1
  244. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/rules.md +1 -0
  245. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/emotion-wave.md +1 -1
  246. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/foreshadow.md +1 -1
  247. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/outline-expand.md +32 -5
  248. 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 +10 -6
  249. package/role-packs//345/205/261/351/270/243/345/260/217/350/257/264/345/256/266/skills/story-bible.md +3 -1
  250. 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 +1 -0
  251. package/dist/agent/managers/dedupManager.d.ts +0 -85
  252. package/dist/agent/managers/dedupManager.d.ts.map +0 -1
  253. package/dist/agent/managers/dedupManager.js +0 -248
  254. package/dist/agent/managers/dedupManager.js.map +0 -1
  255. package/dist/agent/managers/goalConsistencyChecker.d.ts +0 -42
  256. package/dist/agent/managers/goalConsistencyChecker.d.ts.map +0 -1
  257. package/dist/agent/managers/goalConsistencyChecker.js +0 -178
  258. package/dist/agent/managers/goalConsistencyChecker.js.map +0 -1
  259. package/dist/agent/managers/llmJudgeHelper.d.ts +0 -21
  260. package/dist/agent/managers/llmJudgeHelper.d.ts.map +0 -1
  261. package/dist/agent/managers/llmJudgeHelper.js +0 -32
  262. package/dist/agent/managers/llmJudgeHelper.js.map +0 -1
  263. package/dist/agent/managers/memoryAdvisor.d.ts +0 -105
  264. package/dist/agent/managers/memoryAdvisor.d.ts.map +0 -1
  265. package/dist/agent/managers/memoryAdvisor.js +0 -322
  266. package/dist/agent/managers/memoryAdvisor.js.map +0 -1
  267. package/dist/agent/managers/memoryGovernance.d.ts +0 -24
  268. package/dist/agent/managers/memoryGovernance.d.ts.map +0 -1
  269. package/dist/agent/managers/memoryGovernance.js +0 -46
  270. package/dist/agent/managers/memoryGovernance.js.map +0 -1
  271. package/dist/memory/governance.d.ts +0 -17
  272. package/dist/memory/governance.d.ts.map +0 -1
  273. package/dist/memory/governance.js +0 -17
  274. package/dist/memory/governance.js.map +0 -1
  275. package/dist/memory/projectRegistry.d.ts +0 -47
  276. package/dist/memory/projectRegistry.d.ts.map +0 -1
  277. package/dist/memory/projectRegistry.js +0 -151
  278. package/dist/memory/projectRegistry.js.map +0 -1
  279. package/dist/utils/recallDefaults.d.ts +0 -16
  280. package/dist/utils/recallDefaults.d.ts.map +0 -1
  281. package/dist/utils/recallDefaults.js +0 -16
  282. package/dist/utils/recallDefaults.js.map +0 -1
@@ -1,9 +1,10 @@
1
1
  import type { AgentLoop } from '../agent/loop.js';
2
- import type { AgentChunk, ArchiveMode, AgentOptions, AgentContext, ToolExecutionRecord, SessionCheckpoint } from '../agent/types.js';
2
+ import type { AgentChunk, ArchiveMode, AgentOptions, AgentContext, SessionCheckpoint } from '../agent/types.js';
3
3
  import type { InteractiveInputKind } from '../memory/roundStore.js';
4
+ import type { BackgroundTask } from '../agent/backgroundTasks.js';
4
5
  import type { ToolExecutor } from '../agent/toolExecutor.js';
5
6
  import type { MessageHistory } from '../agent/messageHistory.js';
6
- import { ProjectManager, type ProjectContext } from '../memory/projectManager.js';
7
+ import { type ProjectContext } from '../memory/projectManager.js';
7
8
  import { SecurityGuard } from '../security/pathGuard.js';
8
9
  import type { SkillManager } from '../skill/skillManager.js';
9
10
  import type { RolePackManager } from '../role-pack/rolePackManager.js';
@@ -14,12 +15,10 @@ import type { WorkProjectionManager } from '../agent/managers/workProjection.js'
14
15
  import type { MemoryInspector } from '../agent/managers/memoryInspector.js';
15
16
  import { type GCResult } from '../memory/gcService.js';
16
17
  import type { SessionManager, AgentForkResult } from '../agent/managers/sessionManager.js';
17
- import { MemoryGovernance } from '../agent/managers/memoryGovernance.js';
18
18
  import { type ArchiveTriggerOptions } from '../agent/managers/archiveCoordinator.js';
19
19
  import { TypedEventEmitter, type AgentEventMap } from '../utils/eventEmitter.js';
20
20
  import type { LlmProvider, Message } from '../llm/provider.js';
21
21
  import type { AgentMetrics } from '../agent/tracer.js';
22
- import type { BackgroundTaskStats } from '../utils/backgroundTask.js';
23
22
  /**
24
23
  * Memora Agent 门面类
25
24
  *
@@ -37,8 +36,6 @@ export declare class Agent extends TypedEventEmitter<AgentEventMap> {
37
36
  /** 角色包管理器(角色+技能+规则的唯一真理源) */
38
37
  private _rolePackManager;
39
38
  private memoryInspector;
40
- /** 记忆治理统一门面(L0/L1/L2/L3 + 诊断) */
41
- private _governance;
42
39
  /** TextPolishManager(文本润色管理器,LLM 语法修正 + 表达优化) */
43
40
  private textPolisher;
44
41
  /** 会话管理器(从 Agent 拆分出的会话管理职责) */
@@ -67,11 +64,22 @@ export declare class Agent extends TypedEventEmitter<AgentEventMap> {
67
64
  * 用 Set 去重——同一 source 只需补执行一次。
68
65
  */
69
66
  private pendingConfigReload;
67
+ /**
68
+ * 对话期间被 chatLock 拒掉的归档模式切换:**末次为准**(不排队——VS Code 设置本身也是后写覆盖)。
69
+ *
70
+ * 与 pendingConfigReload 同族:轮终(chat() / resumeExecution() 的 frame 退出)统一补执行,
71
+ * 语义见 flushPendingTurnEndTasks。null = 无待补执行的切换。
72
+ */
73
+ private pendingArchiveMode;
70
74
  constructor(opts: AgentOptions);
71
75
  /**
72
76
  * 初始化 Agent:加载索引、组装内部组件
77
+ *
78
+ * ⚠️ **项目在构造时钉死**(`AgentOptions.projectPath`),`init()` **不接受路径覆盖参数**——
79
+ * 形态定案「一个 Agent = 一个项目」:换项目请宿主新建一个 Agent 实例,不要在单实例内改绑
80
+ * (原 `init(projectPathOverride?)` 于 PR-SWITCH-2 删除:它与该原则直接冲突,且全仓零调用)。
73
81
  */
74
- init(projectPathOverride?: string): Promise<ProjectContext>;
82
+ init(): Promise<ProjectContext>;
75
83
  /**
76
84
  * 登记作品投影实时刷新处理器:register_work 工具 / 右键登记成功后,
77
85
  * 内核 WorkProjectionManager 触发 workProjectionGenerated 事件(携带已写入内存 entries 的投影),
@@ -83,9 +91,19 @@ export declare class Agent extends TypedEventEmitter<AgentEventMap> {
83
91
  /**
84
92
  * 注册暂停超时归档处理器(SessionManager 两条超时路径——启动加载与运行时定时器——统一在此消费)
85
93
  * 注册在 init() 内(close() 的 removeAllListeners + init 起始的 disposePreviousInstance 保证实例周期内恰好一个监听器),
86
- * 挂在生命周期稳定的 Agent 上,rebuildComponents() 重建管理器后仍有效。
94
+ * 挂在生命周期稳定的 Agent 上,组件重装配后仍有效。
87
95
  */
88
96
  private registerPauseTimeoutArchiver;
97
+ /**
98
+ * 注册「会话离场归档」处理器:会话因切换/分叉不再是当前会话时,对其做会话级归档
99
+ * (summary/keyTopics 写入 SessionMeta,供 list_sessions 路标与宿主历史菜单悬停摘要)。
100
+ * 两条触发源:
101
+ * - sessionSwitched(switchToSession 切走旧会话):载荷已含旧会话 date/session;
102
+ * - sessionForked(forkSession 从源会话分出新支):载荷 from 为完整会话标识,此处拆解。
103
+ * 注册在 init() 内(与 registerPauseTimeoutArchiver 同生命周期,close 的 removeAllListeners 兜底)。
104
+ * fire-and-forget:归档失败不阻塞切换/分叉主流程,仅记录。
105
+ */
106
+ private registerSessionArchiveOnLeave;
89
107
  /**
90
108
  * 关闭旧实例(如果已初始化),失败不阻塞重建
91
109
  */
@@ -125,17 +143,21 @@ export declare class Agent extends TypedEventEmitter<AgentEventMap> {
125
143
  */
126
144
  private acquireChatLock;
127
145
  /**
128
- * 补执行对话期间暂存的配置重载请求
129
- */
130
- private flushPendingConfigReload;
131
- /**
132
- * 强制释放对话锁
146
+ * 补执行对话期间暂存的**轮终任务**(当前两类:配置重载 source、归档模式切换)
147
+ *
148
+ * 挂载点 = **两处**都必须挂,缺一即同族缺陷(见 clearPlanOnTurnEnd 的「单一收口点」注释):
149
+ * - chat() 的 finally(本文件 chat() 生成器收尾块)
150
+ * - resumeExecution() 的 finally——缺它则「暂停→续跑」期间暂存的项滞留到下一次 chat(),
151
+ * 用户若不再发问则**永久丢失**(2026-10-16 实证:此前仅 chat() 挂点存在,该缺陷为空头承诺)。
133
152
  *
134
- * 宿主在"无进展超时"确认 generator 挂起后调用,使用户能立即发起新对话(否则需等锁超时)。
135
- * 安全机制委托 ChatLockManager.forceRelease:递增 token 让原 chat() 的 finally 跳过清理、abort signal 让响应点退出;
136
- * 原 generator 仍可能后台运行但不影响新调用。幂等(未忙时 no-op)。
153
+ * 位置约束:必须在 release(myToken) **之后** ⇒ 到达时 chatLock 已释放,此处再申请不会撞 busy。
154
+ * 语义 = 「流退出」(generator frame exit)而非「turn 真正收场(非 paused)」:
155
+ * 暂停边界同样会执行本方法,这与「暂停期间直接改 = 即时生效」的现状一致(ADR-041 §2)。
156
+ *
157
+ * 失败策略:**成功才清槽**。失败保留暂存 + logger.warn,顺延下一个安全点(幂等保证重复应用无害)。
158
+ * ⚠ 下方 reloadConfig 段仍是既有的「先 clear 再尝试」(失败即丢失)——同族债已登记,本批不动其行为。
137
159
  */
138
- forceReleaseChatLock(): void;
160
+ private flushPendingTurnEndTasks;
139
161
  /**
140
162
  * 发送用户消息,非流式返回完整回复
141
163
  */
@@ -167,9 +189,8 @@ export declare class Agent extends TypedEventEmitter<AgentEventMap> {
167
189
  private consumeExecutionStream;
168
190
  /**
169
191
  * 暂停会话(用户/Agent/系统均可触发,暂停前自动创建检查点)
170
- * @param lowRisk 低风险暂停不计入连续暂停计数(默认 false)
171
192
  */
172
- pause(reason: string, source?: 'user' | 'agent' | 'system', lowRisk?: boolean): boolean;
193
+ pause(reason: string, source?: 'user' | 'agent' | 'system'): boolean;
173
194
  /**
174
195
  * 恢复会话(从 PAUSED 恢复到 RUNNING)
175
196
  */
@@ -230,8 +251,13 @@ export declare class Agent extends TypedEventEmitter<AgentEventMap> {
230
251
  * 归属:插话同时以「补充」交互输入持久化到当前闭环节点(interactiveInputs),
231
252
  * 保证跨重启重放时插话内容不丢失、不分裂新轮。持久化 fire-and-forget(appendUser 内部
232
253
  * 已 catch 写入失败,仅记日志),不阻塞插话本身。
254
+ *
255
+ * 上限裁决:loop 待注入插话达 LOOP_CONSTANTS.MAX_PENDING_INTERJECTIONS 时**整条拒收**——
256
+ * 先入队后持久化(顺序即语义):拒收时零入队、零落盘、零上屏(调用方据返回值提示用户)。
257
+ *
258
+ * @returns true=已入队并持久化;false=已达上限被拒收(未入队未落盘)
233
259
  */
234
- interject(content: string): void;
260
+ interject(content: string): boolean;
235
261
  /**
236
262
  * 删除待注入的插话(宿主 UI 层用户后悔)。与 interject 对称。
237
263
  * 注意:interject 时已持久化到 history(交互输入归属),此处只从内核队列移除,不删除已落盘记录——
@@ -268,10 +294,6 @@ export declare class Agent extends TypedEventEmitter<AgentEventMap> {
268
294
  * 返回 false 表示无在途提问(提供方未调用 / 已消费)。
269
295
  */
270
296
  answerQuestion(answers: readonly string[]): boolean;
271
- /**
272
- * 追加计划任务项(SESSION_APPEND_TASK 落点):在现有 plan 末尾追加新任务项
273
- */
274
- appendPlanItem(description: string): number;
275
297
  /**
276
298
  * 卸载运行态挂载物:清空检查点计划与任务项推进日志(宿主任务流结束/停止/异常广播 idle 前调用),
277
299
  * 回到"空闲 = 无挂载物"的资源层常态;会话历史与记忆等资源层内容不受影响。
@@ -290,53 +312,48 @@ export declare class Agent extends TypedEventEmitter<AgentEventMap> {
290
312
  * 故保留不清;恢复完成后该 turn 最终退出时仍会走本方法无条件清空。
291
313
  *
292
314
  * 运行时状态(plan/planItemLog)清空,但对话记录里的 round-block 折叠块已沉淀为历史(不落盘删除)。
293
- * 挂点:chat() 与 resumeExecution 的 finally 块(generator close 时触发,确保所有 yield 已被宿主消费)
294
- */
295
- private clearPlanOnTurnEnd;
296
- /**
297
- * 内核→宿主信号:当前会话是否可"无输入续跑"(决定暂停按钮显隐 + 暂停后继续 UI)
315
+ * 挂点:chat() 与 resumeExecution 的 finally 块(generator close 时触发,确保所有 yield 已被宿主消费)。
298
316
  *
299
- * 真值条件:① 状态机已 paused(已软暂停必可续跑,最高优先级——pauseRequested 在下一 step 边界才挂起,
300
- * 彼时 inAutonomousStep 已重置为 false,仅看它会误报);② loop 在自主工具步(可暴露暂停按钮在边界挂起);
301
- * ③ 存在未完成的计划任务项(多轮任务可续跑下一轮)。三者皆否(纯单轮、无待续目标)→ 隐藏暂停按钮(仅停止)。
317
+ * 清空前产出一条 `plan_snapshot` chunk(任务表全量终态):turn 结束后宿主落盘轨由此获得
318
+ * 任务项完成态的唯一结构化真源(重放恢复绿勾用);中断轮同样经过本方法 → 中断轮也拍。
319
+ * 委托为同步 generator(`yield*` 消费),快照 chunk 尽力交付、清空动作经内部 try/finally
320
+ * 无条件执行——即使宿主提前终止流(快照未被消费),plan 也不跨 turn 残留(行为与改造前一致)。
302
321
  */
303
- canContinueWithoutInput(): boolean;
304
- /**
305
- * 触发会话异常(公开 API,宿主显式调用):仅 RUNNING 状态可触发,异常时自动创建检查点保存状态。
306
- * 生产内部无调用者——运行时异常(LLM 超时/工具失败)走 yield {type:'error'} 事件流不翻状态机;
307
- * 本 API 供宿主在自定义异常(如外部服务故障)显式触发,或经检查点恢复回填进入 ERROR 态。
308
- */
309
- triggerError(cause: string): boolean;
310
- /**
311
- * 从异常恢复:校验恢复条件(error.recovered === true 且 cause 已解除)
312
- */
313
- recover(): boolean;
322
+ private clearPlanOnTurnEnd;
314
323
  /**
315
324
  * 创建会话检查点:快照当前运行时状态(热记忆等),生成纯内存态快照
316
325
  * (不落盘、无序列化/恢复路径——中止/断电走「中断轮补全为完整 turn」)。
317
- * 无 role/standard 会话能力位,createCheckpoint 仅收 mainGoal。
326
+ * 返回值恒非空:未 init 时由 assertInitialized/requireSessionManager 抛错(configError),
327
+ * 不返回 null——null 仅属于 getCheckpoint()(首个检查点尚未创建)。
318
328
  */
319
- createCheckpoint(mainGoal?: string): SessionCheckpoint | null;
329
+ createCheckpoint(): SessionCheckpoint;
320
330
  /**
321
331
  * 获取当前检查点
322
332
  */
323
333
  getCheckpoint(): SessionCheckpoint | null;
324
334
  /**
325
- * 获取最近一次处理线程的工具执行历史(loop 域聚合出口,补待办 #3)
335
+ * 后台任务只读快照(宿主 UI 出口 · 见 `docs/方案-后台任务可见性与kill入口-20261004.md` §2.1)
326
336
  *
327
- * 数据源自 sessionManager 检查点的 completedToolCalls(已由
328
- * AGENT_CONSTANTS.COMPLETED_TOOL_CALLS_MAX 做 FIFO 封顶)。本方法剥离「恢复/幂等」内部
329
- * 语义,提供稳定的 execute 域只读契约——宿主可在透明面板/观测面消费本轮及历史的工具调用
330
- * 明细(工具名 / 成败 / 结果摘要),与累计 AgentMetrics.tools 互补。
337
+ * 委托 loop → `BackgroundTaskRegistry.list()`。返回**只读投影**
338
+ * (taskId / command / startedAt / status / result?),不含进程句柄——
339
+ * 宿主拿它渲染列表,但**无从操纵进程**(注册表按 Agent 实例隔离,
340
+ * 导出注册表类会让宿主跨会话 kill,故只出方法不出类)。
331
341
  *
332
- * @param limit 返回条数上限(默认取封顶上限,超界由调用方控制,取最近 limit 条)
333
- * @returns 工具执行记录(记录顺序:时间正序即旧→新;无记录返回空数组;返回浅拷贝防宿主改动检查点)
342
+ * ⚠️ 未初始化**抛 `configError`**(与既有门面同构,`assertInitialized` 是门面统一契约)——
343
+ * 调用方须自行保证 init 完成,本方法不做静默降级(静默返回空会把「未初始化」
344
+ * 伪装成「没有后台任务」)。
334
345
  */
335
- getRecentToolExecutions(limit?: number): ToolExecutionRecord[];
346
+ listBackgroundTasks(): readonly BackgroundTask[];
336
347
  /**
337
- * 向 loop 注入 system 消息
348
+ * 终止后台任务(宿主 UI 出口 · 同上 §2.1)
349
+ *
350
+ * 委托 loop → `BackgroundTaskRegistry.kill()`:先取已捕获输出快照再杀树,
351
+ * 返回终态投影(用户点「终止」即等价于模型调 `kill_command`)。
352
+ *
353
+ * @returns 终态投影;`taskId` 不存在 → `null`
354
+ * @throws 未初始化时抛 `configError`(同 `listBackgroundTasks`)
338
355
  */
339
- injectSystemMessage(message: string): void;
356
+ killBackgroundTask(taskId: string): BackgroundTask | null;
340
357
  /**
341
358
  * 从指定 Round 位置分叉当前会话(委托至 SessionManager):
342
359
  * round-based 模式唯一分叉方式——创建新会话,复制 Round ID 列表(指针复制),
@@ -359,14 +376,6 @@ export declare class Agent extends TypedEventEmitter<AgentEventMap> {
359
376
  * @param result - 分叉结果(含新会话名/日期/Round 列表)
360
377
  */
361
378
  private ensureForkSessionTitle;
362
- /**
363
- * 切换到指定项目:切换后自动 rebuildComponents();Agent 级记忆存储(宿主注入,实例不随项目切换重建)保留,项目级配置(.memora/)重新加载
364
- *
365
- * `nameOrPath` 只接受两种输入:① 项目注册表中的项目名(依赖注册表跨项目共享,见 dataDir/registryDir);
366
- * ② 项目根目录的**绝对路径**。二者都不满足时抛 configError——否则相对串会以 process.cwd()
367
- * 为基准解析,静默造出非预期的项目目录并占用其锁。
368
- */
369
- switchProject(nameOrPath: string): Promise<AgentContext>;
370
379
  /**
371
380
  * 组装所有运行时组件(一行委托给 assembler 工厂)
372
381
  *
@@ -404,7 +413,17 @@ export declare class Agent extends TypedEventEmitter<AgentEventMap> {
404
413
  getEffectiveMaxTokens(): number | undefined;
405
414
  setBackgroundProvider(provider: LlmProvider | null): void;
406
415
  /**
407
- * 运行时切换归档模式:对话进行中禁止切换(避免本轮 postProcess 行为不一致),无变更幂等返回
416
+ * 运行时切换归档模式:**对话进行中不即时生效** → 暂存期望值 + 抛错,由 flushPendingTurnEndTasks 补执行。
417
+ *
418
+ * 契约与 reloadConfig(source) 逐字同构:
419
+ * - busy 时 **既暂存、又抛错**——抛错是「已排期到轮终」的传输方式,不是「静默接受」。
420
+ * 宿主据此走 catch 分支向用户如实说明「运行时将在当前对话结束后生效」(settingsPanel.setArchiveMode)。
421
+ * - 补执行点:chat() / resumeExecution() 的 finally(流退出),见 flushPendingTurnEndTasks。
422
+ *
423
+ * ⚠ 守卫用 chatLock.isBusy(`assertNotBusy` 同源),而该锁 180s 超时会**自动释放且不中断生成流**
424
+ * (见 ChatLockManager.acquire 计时器)⇒ 长轮跑过 180s 后本方法会即时生效而非暂存,
425
+ * 此时本轮的**后半程**即按新模式归档。这是既有判据的缺陷,非本方法引入;
426
+ * 判据统一问题已登记专项(本批不动判据),此处如实注明而非回避。
408
427
  */
409
428
  setArchiveMode(mode: ArchiveMode): void;
410
429
  /**
@@ -469,15 +488,17 @@ export declare class Agent extends TypedEventEmitter<AgentEventMap> {
469
488
  /**
470
489
  * 手动归档会话(更新 SessionMeta,委托 ArchiveCoordinator)
471
490
  *
472
- * 适用于 manual 模式(用户手动触发;full 模式由宿主切换前自动调用)。
473
- * options 透传给 ArchiveCoordinator:宿主自动触发传 { autoTriggered: true }(按其模式判断),
491
+ * 适用于 manual 模式(用户手动触发;自动归档由内核监听器在会话切走/分叉离场/暂停超时时触发)。
492
+ * options 透传给 ArchiveCoordinator:内核自动触发传 { autoTriggered: true }(按其模式判断),
474
493
  * 用户手动触发省略 options(默认 autoTriggered=false,无条件执行)。
475
494
  *
476
495
  * @returns 归档结果(updatedFields 可能为空,表示无归档价值或 LLM 失败)
477
496
  */
478
497
  archiveSession(date: string, session: string, options?: ArchiveTriggerOptions): Promise<SessionArchiveResult>;
479
498
  /**
480
- * 重载配置类记忆:从 configDir 重新扫描指定 source 并更新内存缓存(设定记忆纯文件装载,不写记忆库),使当前会话立即生效(无需重启)。
499
+ * 从 configDir 重新扫描指定 source 并更新内存缓存(设定记忆纯文件装载,不写记忆库)。
500
+ * **空闲时**使当前会话立即生效(无需重启);**对话进行中**则暂存 source 并抛错(见下方 busy 分支),
501
+ * 由 flushPendingTurnEndTasks 在流退出时补执行——故此处不宜读作「无条件立即生效」。
481
502
  * - 'skill' → SkillManager.reload() 重扫 skills/
482
503
  * - 'rolePack' → RolePackManager.reload() 重扫 role-packs/(保持激活角色,刷新 AgentLoop 前缀)
483
504
  * - 'rule' → 经角色包管理机制热更新(即 rolePack)
@@ -487,10 +508,6 @@ export declare class Agent extends TypedEventEmitter<AgentEventMap> {
487
508
  skill: number;
488
509
  rolePack: number;
489
510
  }>;
490
- /**
491
- * 重建内部组件(history / loop / managers):通常由 switchProject() 自动触发,仅强制刷新时手动调用
492
- */
493
- rebuildComponents(): Promise<void>;
494
511
  /**
495
512
  * 检查 Agent 是否已初始化(methodName 用于错误消息,requires 为需检查的组件列表)
496
513
  */
@@ -559,13 +576,6 @@ export declare class Agent extends TypedEventEmitter<AgentEventMap> {
559
576
  get provider(): LlmProvider;
560
577
  get isBusy(): boolean;
561
578
  get lastInteractionAt(): Date | null;
562
- /** 记忆治理统一门面(语义去重 / 来源健康诊断 / 冲突检测 / 建议推荐),Agent 上的记忆管理方法统一收口于此(无显式衰减层面) */
563
- get governance(): MemoryGovernance | null;
564
- /**
565
- * 后台任务统计快照(宿主观测后台副作用健康度,纯只读转发 utils 单例)。
566
- * @returns 在途 / 成功 / 失败计数
567
- */
568
- getBackgroundTaskStats(): BackgroundTaskStats;
569
579
  /**
570
580
  * 获取 Agent 运行时指标快照(可观测性):聚合 AgentLoop 指标与 Agent 层治理指标;
571
581
  * 未初始化返回全零默认值(不抛异常),纯只读同步零副作用,适合宿主定期轮询监控面板。
@@ -581,8 +591,6 @@ export declare class Agent extends TypedEventEmitter<AgentEventMap> {
581
591
  get rolePacks(): RolePackManager | null;
582
592
  /** 记忆查看器(快照 + 搜索 + 统计;宿主常用 `const mem = agent.memory; if (!mem) return []`) */
583
593
  get memory(): MemoryInspector | null;
584
- /** 项目管理器(返回 null 表示 Agent 未初始化) */
585
- get projects(): ProjectManager | null;
586
594
  /** 安全守卫(写入确认回调注册:`onWriteConfirmation` 返回 true 放行、false 拒绝;未初始化/projectPath 未设为 null) */
587
595
  get security(): SecurityGuard | null;
588
596
  /** 作品投影管理器(用户主动登记的 JSON 极简索引;`registerWork`/`listWorks`/`loadAndGetContextBlock`/`isFileMalformed`) */
@@ -1 +1 @@
1
- {"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/agent/agent.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/agent/agent.ts"],"names":[],"mappings":"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"}