@octopi-agent/engine 0.70.7 → 0.86.38

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 (362) hide show
  1. package/LICENSE +201 -201
  2. package/NOTICE +7 -7
  3. package/README.md +64 -26
  4. package/dist/config-schema/agent.d.ts +89 -1
  5. package/dist/config-schema/agent.js +69 -0
  6. package/dist/config-schema/context.d.ts +23 -4
  7. package/dist/config-schema/context.js +28 -1
  8. package/dist/config-schema/engine.d.ts +201 -9
  9. package/dist/config-schema/engine.js +31 -2
  10. package/dist/config-schema/governance.d.ts +95 -0
  11. package/dist/config-schema/governance.js +91 -0
  12. package/dist/config-schema/models.d.ts +1 -1
  13. package/dist/config-schema/observability.d.ts +6 -0
  14. package/dist/config-schema/observability.js +16 -0
  15. package/dist/config-schema/run.d.ts +10 -0
  16. package/dist/config-schema/run.js +18 -0
  17. package/dist/config-schema/shared.d.ts +10 -0
  18. package/dist/config-schema/shared.js +10 -0
  19. package/dist/config-schema/substrate.d.ts +1 -1
  20. package/dist/config-schema/subsystems.d.ts +1 -1
  21. package/dist/config-schema/subsystems.js +2 -1
  22. package/dist/config.d.ts +178 -7
  23. package/dist/config.js +113 -3
  24. package/dist/harness/activation/compiler.js +3 -0
  25. package/dist/harness/activation/runtime.d.ts +7 -0
  26. package/dist/harness/activation/runtime.js +60 -2
  27. package/dist/harness/activation/sources/agent-signal.d.ts +11 -0
  28. package/dist/harness/activation/sources/agent-signal.js +33 -0
  29. package/dist/harness/activation/types.d.ts +6 -1
  30. package/dist/harness/agent/builder.d.ts +47 -3
  31. package/dist/harness/agent/builder.js +180 -54
  32. package/dist/harness/agent/config-bridge.d.ts +33 -25
  33. package/dist/harness/agent/config-bridge.js +81 -291
  34. package/dist/harness/agent/index.d.ts +3 -1
  35. package/dist/harness/agent/index.js +2 -1
  36. package/dist/harness/agent/tool-purpose.d.ts +38 -0
  37. package/dist/harness/agent/tool-purpose.js +118 -0
  38. package/dist/harness/agent/wire-agent-builder.d.ts +133 -0
  39. package/dist/harness/agent/wire-agent-builder.js +363 -0
  40. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +4 -1
  41. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +14 -8
  42. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +12 -0
  43. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +19 -0
  44. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.d.ts +6 -0
  45. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.js +24 -7
  46. package/dist/harness/collaboration/autonomous-subsystem/think/executor.d.ts +5 -2
  47. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +11 -3
  48. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +1 -1
  49. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -1
  50. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.d.ts +7 -4
  51. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.js +8 -9
  52. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.d.ts +36 -10
  53. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +60 -7
  54. package/dist/harness/collaboration/delegation/child-run.d.ts +144 -0
  55. package/dist/harness/collaboration/delegation/child-run.js +241 -0
  56. package/dist/harness/collaboration/delegation/index.d.ts +26 -0
  57. package/dist/harness/collaboration/delegation/index.js +25 -0
  58. package/dist/harness/collaboration/delegation/notifier.d.ts +46 -0
  59. package/dist/harness/collaboration/delegation/notifier.js +84 -0
  60. package/dist/harness/collaboration/delegation/registry-types.d.ts +200 -0
  61. package/dist/harness/collaboration/delegation/registry-types.js +61 -0
  62. package/dist/harness/collaboration/delegation/registry.d.ts +110 -0
  63. package/dist/harness/collaboration/delegation/registry.js +220 -0
  64. package/dist/harness/collaboration/delegation/service.d.ts +249 -0
  65. package/dist/harness/collaboration/delegation/service.js +499 -0
  66. package/dist/harness/collaboration/delegation/store.d.ts +155 -0
  67. package/dist/harness/collaboration/delegation/store.js +271 -0
  68. package/dist/harness/collaboration/delegation/transport.d.ts +73 -0
  69. package/dist/harness/collaboration/delegation/transport.js +61 -0
  70. package/dist/harness/collaboration/delegation/types.d.ts +231 -0
  71. package/dist/harness/collaboration/delegation/types.js +70 -0
  72. package/dist/harness/collaboration/delegation/wiring.d.ts +111 -0
  73. package/dist/harness/collaboration/delegation/wiring.js +145 -0
  74. package/dist/harness/collaboration/orchestration/index.d.ts +11 -13
  75. package/dist/harness/collaboration/orchestration/index.js +11 -11
  76. package/dist/harness/context/assembler.d.ts +2 -2
  77. package/dist/harness/context/assembler.js +12 -7
  78. package/dist/harness/context/capabilities/compact/engine.js +80 -38
  79. package/dist/harness/context/capabilities/compact/types.d.ts +12 -1
  80. package/dist/harness/context/capabilities/summary/registry.js +10 -0
  81. package/dist/harness/context/constitution/default-agents.md +230 -228
  82. package/dist/harness/context/default-context-engine.d.ts +101 -23
  83. package/dist/harness/context/default-context-engine.js +483 -172
  84. package/dist/harness/context/hybrid-compressor.d.ts +3 -3
  85. package/dist/harness/context/hybrid-compressor.js +18 -23
  86. package/dist/harness/context/index.d.ts +5 -1
  87. package/dist/harness/context/index.js +2 -0
  88. package/dist/harness/context/layer-snapshot.d.ts +4 -0
  89. package/dist/harness/context/layer-snapshot.js +30 -18
  90. package/dist/harness/context/layer-types.d.ts +49 -1
  91. package/dist/harness/context/layer-types.js +72 -4
  92. package/dist/harness/context/layers.d.ts +5 -2
  93. package/dist/harness/context/layers.js +11 -5
  94. package/dist/harness/context/llm-summarizer.d.ts +15 -1
  95. package/dist/harness/context/llm-summarizer.js +107 -56
  96. package/dist/harness/context/message-selector.js +6 -2
  97. package/dist/harness/context/root-instructions.d.ts +72 -0
  98. package/dist/harness/context/root-instructions.js +227 -0
  99. package/dist/harness/context/runtime-datetime.d.ts +34 -7
  100. package/dist/harness/context/runtime-datetime.js +66 -10
  101. package/dist/harness/context/smart-router.d.ts +1 -1
  102. package/dist/harness/context/smart-router.js +1 -1
  103. package/dist/harness/context/system-prompt-assembler.d.ts +30 -0
  104. package/dist/harness/context/system-prompt-assembler.js +67 -6
  105. package/dist/harness/context/token-constants.d.ts +2 -2
  106. package/dist/harness/context/token-constants.js +2 -2
  107. package/dist/harness/context/token-estimate-fns.d.ts +1 -3
  108. package/dist/harness/context/token-estimate-fns.js +2 -4
  109. package/dist/harness/context/token-estimator.d.ts +1 -1
  110. package/dist/harness/context/token-estimator.js +14 -6
  111. package/dist/harness/context/tool-result-aging.d.ts +140 -0
  112. package/dist/harness/context/tool-result-aging.js +331 -0
  113. package/dist/harness/context/tool-result-body.d.ts +10 -0
  114. package/dist/harness/context/tool-result-body.js +27 -0
  115. package/dist/harness/context/turn-envelope.d.ts +123 -0
  116. package/dist/harness/context/turn-envelope.js +188 -0
  117. package/dist/harness/context/types.d.ts +35 -47
  118. package/dist/harness/extension/execution-environment/effect-policy.d.ts +248 -0
  119. package/dist/harness/extension/execution-environment/effect-policy.js +334 -0
  120. package/dist/harness/extension/execution-environment/index.d.ts +18 -2
  121. package/dist/harness/extension/execution-environment/index.js +11 -2
  122. package/dist/harness/extension/execution-environment/memory-undo.d.ts +101 -0
  123. package/dist/harness/extension/execution-environment/memory-undo.js +192 -0
  124. package/dist/harness/extension/execution-environment/process-isolation.d.ts +84 -0
  125. package/dist/harness/extension/execution-environment/process-isolation.js +315 -0
  126. package/dist/harness/extension/execution-environment/resource-limits.d.ts +36 -0
  127. package/dist/harness/extension/execution-environment/resource-limits.js +84 -0
  128. package/dist/harness/extension/execution-environment/sandbox.d.ts +125 -4
  129. package/dist/harness/extension/execution-environment/sandbox.js +493 -51
  130. package/dist/harness/extension/execution-environment/shell-journal.d.ts +100 -0
  131. package/dist/harness/extension/execution-environment/shell-journal.js +299 -0
  132. package/dist/harness/extension/execution-environment/tool-capabilities.d.ts +45 -0
  133. package/dist/harness/extension/execution-environment/tool-capabilities.js +126 -0
  134. package/dist/harness/extension/execution-environment/types.d.ts +67 -39
  135. package/dist/harness/extension/execution-environment/types.js +2 -2
  136. package/dist/harness/extension/execution-environment/undo-log.d.ts +203 -0
  137. package/dist/harness/extension/execution-environment/undo-log.js +627 -0
  138. package/dist/harness/extension/execution-environment/undo-merge.d.ts +40 -0
  139. package/dist/harness/extension/execution-environment/undo-merge.js +167 -0
  140. package/dist/harness/extension/plugin-ecosystem/client-tools/index.d.ts +1 -1
  141. package/dist/harness/extension/plugin-ecosystem/client-tools/types.d.ts +9 -0
  142. package/dist/harness/extension/plugin-ecosystem/mcp/bridge.js +2 -0
  143. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +1 -6
  144. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +3 -8
  145. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -3
  146. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -3
  147. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +2 -10
  148. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +2 -9
  149. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -3
  150. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +1 -3
  151. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +2 -4
  152. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +4 -21
  153. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +3 -9
  154. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +4 -8
  155. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +1 -4
  156. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +1 -3
  157. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +1 -1
  158. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +1 -1
  159. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.d.ts +45 -0
  160. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +136 -0
  161. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +1 -0
  162. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +18 -3
  163. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +277 -81
  164. package/dist/harness/extension/plugin-ecosystem/tools/delegation.d.ts +31 -0
  165. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +291 -0
  166. package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +10 -2
  167. package/dist/harness/extension/plugin-ecosystem/tools/env-info.js +1 -0
  168. package/dist/harness/extension/plugin-ecosystem/tools/eol.d.ts +35 -0
  169. package/dist/harness/extension/plugin-ecosystem/tools/eol.js +43 -0
  170. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +40 -9
  171. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.d.ts +33 -0
  172. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +376 -0
  173. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +12 -2
  174. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +239 -61
  175. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.d.ts +27 -0
  176. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +554 -0
  177. package/dist/harness/extension/plugin-ecosystem/tools/http.d.ts +10 -6
  178. package/dist/harness/extension/plugin-ecosystem/tools/http.js +41 -47
  179. package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +2 -0
  180. package/dist/harness/extension/plugin-ecosystem/tools/index.js +2 -0
  181. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +4 -0
  182. package/dist/harness/extension/plugin-ecosystem/tools/memory.js +25 -1
  183. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.d.ts +13 -0
  184. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +391 -0
  185. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +51 -2
  186. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +151 -12
  187. package/dist/harness/extension/plugin-ecosystem/tools/session-history.js +2 -0
  188. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +10 -1
  189. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +35 -19
  190. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +8 -0
  191. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +5 -0
  192. package/dist/harness/extension/plugin-ecosystem/tools/web-search.js +1 -0
  193. package/dist/harness/governance/credentials/index.d.ts +1 -1
  194. package/dist/harness/governance/credentials/store.d.ts +16 -4
  195. package/dist/harness/governance/credentials/store.js +33 -6
  196. package/dist/harness/governance/credentials/types.d.ts +11 -0
  197. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +105 -0
  198. package/dist/harness/governance/human-in-the-loop/decision-cache.js +184 -0
  199. package/dist/harness/governance/human-in-the-loop/index.d.ts +5 -5
  200. package/dist/harness/governance/human-in-the-loop/index.js +3 -3
  201. package/dist/harness/governance/human-in-the-loop/types.d.ts +7 -62
  202. package/dist/harness/governance/human-in-the-loop/types.js +6 -2
  203. package/dist/harness/governance/security/capability-enforcer.d.ts +9 -1
  204. package/dist/harness/governance/security/capability-enforcer.js +31 -8
  205. package/dist/harness/governance/security/degradation.js +5 -7
  206. package/dist/harness/governance/security/risk-evaluator.d.ts +1 -1
  207. package/dist/harness/governance/security/risk-evaluator.js +4 -82
  208. package/dist/harness/governance/security/temp-path.d.ts +41 -0
  209. package/dist/harness/governance/security/temp-path.js +117 -0
  210. package/dist/harness/governance/session-acl/index.d.ts +1 -0
  211. package/dist/harness/governance/session-acl/index.js +1 -0
  212. package/dist/harness/governance/session-acl/rights.d.ts +12 -0
  213. package/dist/harness/governance/session-acl/rights.js +89 -7
  214. package/dist/harness/governance/session-acl/seed-roles.js +9 -1
  215. package/dist/harness/governance/session-acl/service.js +21 -29
  216. package/dist/harness/governance/session-acl/tool-rights.d.ts +81 -0
  217. package/dist/harness/governance/session-acl/tool-rights.js +238 -0
  218. package/dist/harness/governance/session-acl/types.d.ts +22 -0
  219. package/dist/harness/index.d.ts +14 -12
  220. package/dist/harness/index.js +9 -6
  221. package/dist/harness/knowledge/file-index-store.js +11 -11
  222. package/dist/harness/knowledge/grounding.d.ts +2 -1
  223. package/dist/harness/knowledge/grounding.js +6 -3
  224. package/dist/harness/knowledge/index.d.ts +2 -2
  225. package/dist/harness/knowledge/index.js +1 -1
  226. package/dist/harness/knowledge/ingest.js +4 -1
  227. package/dist/harness/knowledge/job-control-state.js +4 -4
  228. package/dist/harness/knowledge/job-control.js +11 -11
  229. package/dist/harness/knowledge/membership-store.js +11 -11
  230. package/dist/harness/knowledge/network-guard.d.ts +61 -4
  231. package/dist/harness/knowledge/network-guard.js +390 -113
  232. package/dist/harness/knowledge/query-service.js +3 -3
  233. package/dist/harness/knowledge/writer-service.d.ts +2 -0
  234. package/dist/harness/knowledge/writer-service.js +14 -13
  235. package/dist/harness/memory/backfill-trigger.d.ts +2 -2
  236. package/dist/harness/memory/backfill-trigger.js +4 -4
  237. package/dist/harness/memory/index.d.ts +1 -0
  238. package/dist/harness/memory/index.js +1 -0
  239. package/dist/harness/memory/sqlite/agent-db.js +2 -0
  240. package/dist/harness/memory/sqlite/memory-store.d.ts +1 -0
  241. package/dist/harness/memory/sqlite/memory-store.js +14 -4
  242. package/dist/harness/memory/sqlite/wisdom-store.js +9 -9
  243. package/dist/harness/memory/store.d.ts +1 -0
  244. package/dist/harness/memory/store.js +3 -0
  245. package/dist/harness/memory/time-format.d.ts +28 -0
  246. package/dist/harness/memory/time-format.js +52 -0
  247. package/dist/harness/memory/types.d.ts +12 -0
  248. package/dist/harness/observability/observer/hub.js +23 -1
  249. package/dist/harness/observability/observer/index.d.ts +2 -2
  250. package/dist/harness/observability/observer/index.js +1 -1
  251. package/dist/harness/observability/observer/types.d.ts +57 -0
  252. package/dist/harness/observability/observer/types.js +118 -9
  253. package/dist/harness/run/agent/agent.d.ts +18 -0
  254. package/dist/harness/run/agent/agent.js +26 -0
  255. package/dist/harness/run/concurrency/tool-loop-detection-core.d.ts +1 -1
  256. package/dist/harness/run/concurrency/tool-loop-detection-core.js +1 -1
  257. package/dist/harness/run/reliability/harness-events.d.ts +4 -0
  258. package/dist/harness/run/reliability/run-agent.js +110 -18
  259. package/dist/harness/run/reliability/run-metrics-collector.d.ts +28 -2
  260. package/dist/harness/run/reliability/run-metrics-collector.js +92 -2
  261. package/dist/harness/run/run-guard/default-run-guard.d.ts +0 -5
  262. package/dist/harness/run/run-guard/default-run-guard.js +104 -44
  263. package/dist/harness/run/run-scope.d.ts +52 -0
  264. package/dist/harness/run/runner.d.ts +101 -16
  265. package/dist/harness/run/runner.js +556 -158
  266. package/dist/harness/session/attachments/llm-intent.js +17 -17
  267. package/dist/harness/session/history/port.js +1 -0
  268. package/dist/harness/session/in-memory-store.d.ts +1 -0
  269. package/dist/harness/session/in-memory-store.js +22 -1
  270. package/dist/harness/session/schedules/index.d.ts +10 -0
  271. package/dist/harness/session/schedules/index.js +10 -0
  272. package/dist/harness/session/schedules/render.d.ts +13 -0
  273. package/dist/harness/session/schedules/render.js +63 -0
  274. package/dist/harness/session/schedules/service.d.ts +179 -0
  275. package/dist/harness/session/schedules/service.js +695 -0
  276. package/dist/harness/session/schedules/store.d.ts +119 -0
  277. package/dist/harness/session/schedules/store.js +323 -0
  278. package/dist/harness/session/schedules/tools.d.ts +39 -0
  279. package/dist/harness/session/schedules/tools.js +442 -0
  280. package/dist/harness/session/schedules/types.d.ts +104 -0
  281. package/dist/harness/session/schedules/types.js +97 -0
  282. package/dist/harness/session/tasks/tools.js +22 -0
  283. package/dist/harness/session/types.d.ts +35 -0
  284. package/dist/harness/shared/events/agent-event-map.d.ts +13 -0
  285. package/dist/harness/shared/types/agent-definition.d.ts +23 -0
  286. package/dist/index.d.ts +23 -9
  287. package/dist/index.js +10 -2
  288. package/dist/integration/providers/anthropic.d.ts +10 -0
  289. package/dist/integration/providers/anthropic.js +44 -1
  290. package/dist/integration/providers/openai.d.ts +10 -0
  291. package/dist/integration/providers/openai.js +58 -2
  292. package/dist/integration/providers/wire-dump-diff.d.ts +191 -0
  293. package/dist/integration/providers/wire-dump-diff.js +351 -0
  294. package/dist/integration/providers/wire-dump.d.ts +178 -0
  295. package/dist/integration/providers/wire-dump.js +396 -0
  296. package/dist/integration/storage/jsonl.d.ts +11 -0
  297. package/dist/integration/storage/jsonl.js +148 -39
  298. package/dist/integration/storage/session-index.js +63 -8
  299. package/dist/subsystems/cognition-steward/conceptualize/SUBSYSTEM.md +43 -43
  300. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +50 -50
  301. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +6 -6
  302. package/dist/subsystems/cognition-steward/consolidate/config.yaml +54 -54
  303. package/dist/subsystems/memory-steward/backfill/handler.js +9 -0
  304. package/dist/subsystems/wisdom-steward/evaluate/config.yaml +50 -50
  305. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +42 -42
  306. package/dist/subsystems/wisdom-steward/formation/config.yaml +54 -54
  307. package/dist/subsystems/wisdom-steward/govern/config.yaml +55 -55
  308. package/package.json +115 -115
  309. package/dist/harness/collaboration/multi-agent/agent-registry-types.d.ts +0 -144
  310. package/dist/harness/collaboration/multi-agent/agent-registry-types.js +0 -25
  311. package/dist/harness/collaboration/multi-agent/index.d.ts +0 -17
  312. package/dist/harness/collaboration/multi-agent/index.js +0 -15
  313. package/dist/harness/collaboration/multi-agent/process.d.ts +0 -167
  314. package/dist/harness/collaboration/multi-agent/process.js +0 -256
  315. package/dist/harness/collaboration/multi-agent/registry.d.ts +0 -36
  316. package/dist/harness/collaboration/multi-agent/registry.js +0 -137
  317. package/dist/harness/collaboration/multi-agent/swarm.d.ts +0 -135
  318. package/dist/harness/collaboration/multi-agent/swarm.js +0 -317
  319. package/dist/harness/collaboration/multi-agent/types.d.ts +0 -66
  320. package/dist/harness/collaboration/multi-agent/types.js +0 -15
  321. package/dist/harness/collaboration/orchestration/async-task-store.d.ts +0 -107
  322. package/dist/harness/collaboration/orchestration/async-task-store.js +0 -12
  323. package/dist/harness/collaboration/orchestration/async-task.d.ts +0 -156
  324. package/dist/harness/collaboration/orchestration/async-task.js +0 -359
  325. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.d.ts +0 -47
  326. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.js +0 -61
  327. package/dist/harness/collaboration/orchestration/planner/index.d.ts +0 -9
  328. package/dist/harness/collaboration/orchestration/planner/index.js +0 -6
  329. package/dist/harness/collaboration/orchestration/planner/llm-planner.d.ts +0 -54
  330. package/dist/harness/collaboration/orchestration/planner/llm-planner.js +0 -167
  331. package/dist/harness/collaboration/orchestration/planner/rule-planner.d.ts +0 -85
  332. package/dist/harness/collaboration/orchestration/planner/rule-planner.js +0 -175
  333. package/dist/harness/collaboration/orchestration/quality/classifier.d.ts +0 -21
  334. package/dist/harness/collaboration/orchestration/quality/classifier.js +0 -235
  335. package/dist/harness/collaboration/orchestration/quality/gate.d.ts +0 -29
  336. package/dist/harness/collaboration/orchestration/quality/gate.js +0 -409
  337. package/dist/harness/collaboration/orchestration/quality/index.d.ts +0 -9
  338. package/dist/harness/collaboration/orchestration/quality/index.js +0 -8
  339. package/dist/harness/collaboration/orchestration/quality/types.d.ts +0 -159
  340. package/dist/harness/collaboration/orchestration/quality/types.js +0 -33
  341. package/dist/harness/collaboration/orchestration/scheduler/index.d.ts +0 -5
  342. package/dist/harness/collaboration/orchestration/scheduler/index.js +0 -4
  343. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.d.ts +0 -143
  344. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.js +0 -297
  345. package/dist/harness/collaboration/orchestration/strategy/classifier.d.ts +0 -12
  346. package/dist/harness/collaboration/orchestration/strategy/classifier.js +0 -81
  347. package/dist/harness/collaboration/orchestration/strategy/index.d.ts +0 -3
  348. package/dist/harness/collaboration/orchestration/strategy/index.js +0 -2
  349. package/dist/harness/collaboration/orchestration/strategy/router.d.ts +0 -28
  350. package/dist/harness/collaboration/orchestration/strategy/router.js +0 -105
  351. package/dist/harness/collaboration/orchestration/strategy/types.d.ts +0 -49
  352. package/dist/harness/collaboration/orchestration/strategy/types.js +0 -4
  353. package/dist/harness/collaboration/orchestration/workflow/engine.d.ts +0 -86
  354. package/dist/harness/collaboration/orchestration/workflow/engine.js +0 -298
  355. package/dist/harness/collaboration/orchestration/workflow/index.d.ts +0 -9
  356. package/dist/harness/collaboration/orchestration/workflow/index.js +0 -7
  357. package/dist/harness/collaboration/orchestration/workflow/types.d.ts +0 -143
  358. package/dist/harness/collaboration/orchestration/workflow/types.js +0 -7
  359. package/dist/harness/governance/human-in-the-loop/approval-manager.d.ts +0 -32
  360. package/dist/harness/governance/human-in-the-loop/approval-manager.js +0 -93
  361. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.d.ts +0 -0
  362. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.js +0 -0
@@ -16,11 +16,16 @@
16
16
  */
17
17
  import { getTextContent } from '@octopi-agent/core/types.js';
18
18
  import { HeuristicTokenEstimator, estimateLLMMessages } from './token-estimator.js';
19
+ import { toolResultBody } from './tool-result-body.js';
20
+ import { buildToolCallLedger } from './llm-summarizer.js';
21
+ import { agedToolResultPointer, agedToolArgDigest, applyAgingToMessages, computeToolResultAgingPlan, resolveToolResultAgingOptions, } from './tool-result-aging.js';
19
22
  import { DefaultMessageSelector } from './message-selector.js';
20
23
  import { HybridCompressor } from './hybrid-compressor.js';
21
24
  import { DefaultBudgetAllocator } from './budget-allocator.js';
22
25
  import { SmartRouter } from './smart-router.js';
23
26
  import { compactStateKey } from './compact-key.js';
27
+ import { isEngineCarrierSource } from './layer-types.js';
28
+ import { extractUserMessageText, isTurnStartContent, } from './turn-envelope.js';
24
29
  import { createCompactEngine } from './capabilities/compact/index.js';
25
30
  // ── 引擎实现 ──
26
31
  /** 摘要正文包装:确保带 [Conversation Summary] 标记,便于 extract / 调试 */
@@ -36,7 +41,6 @@ export class DefaultContextEngine {
36
41
  info = {
37
42
  id: 'default',
38
43
  name: 'Default Context Engine',
39
- ownsCompaction: true,
40
44
  };
41
45
  config;
42
46
  router;
@@ -51,9 +55,14 @@ export class DefaultContextEngine {
51
55
  router: config?.router ?? {},
52
56
  protectFirstN: config?.protectFirstN ?? 3,
53
57
  protectLastN: config?.protectLastN ?? 20,
54
- compactThreshold: config?.compactThreshold ?? 0.5,
55
58
  proactiveCompactRatio: config?.proactiveCompactRatio ?? 0.6,
56
59
  proactiveCooldownMs: config?.proactiveCooldownMs ?? 30_000,
60
+ historyAging: resolveToolResultAgingOptions(config?.historyAging),
61
+ targetTokens: config?.targetTokens ?? 200_000,
62
+ // <1 或非法值回落缺省——0 会把目标线压成 0(压缩风暴),不是「禁用」语义
63
+ compactFallbackRatio: config?.compactFallbackRatio != null && config.compactFallbackRatio >= 1
64
+ ? config.compactFallbackRatio
65
+ : 3,
57
66
  compactEngine: config?.compactEngine ??
58
67
  createCompactEngine({
59
68
  defaultProtectHead: config?.protectFirstN ?? 3,
@@ -84,6 +93,10 @@ export class DefaultContextEngine {
84
93
  const { sessionId, agentId, messages, systemPrompt, tools, contextWindow, compactTargetTokens, signal, tokenEstimator, summarize, emit, loadCompactState, } = params;
85
94
  // E4:引擎内部 compact 状态键 = (sessionId, agentId)
86
95
  const stateKey = compactStateKey(sessionId, agentId);
96
+ // F1-B2:老化计划基于**完整历史**(append-only)一次算好、随视图复用——
97
+ // 按裁剪视图重算会让已降级条目回原文、批量边界来回翻转(烧前缀缓存)。
98
+ // 估算(estimateLLMMessages)作用于老化后的 LLM 视图,尺子与实际请求一致。
99
+ const agingPlan = computeToolResultAgingPlan(messages, this.config.historyAging);
87
100
  // 窗口未知且无显式 compactTargetTokens:跳过基于预算的自动压缩/截断
88
101
  const budgetCap = params.tokenBudget ?? contextWindow ?? compactTargetTokens;
89
102
  const windowKnown = contextWindow != null && contextWindow > 0;
@@ -99,16 +112,35 @@ export class DefaultContextEngine {
99
112
  ...existing,
100
113
  previousSummary: restored.summary ?? existing?.previousSummary,
101
114
  lastProactiveMessageCount: restored.lastProactiveMessageCount ?? existing?.lastProactiveMessageCount,
115
+ lastProactiveCoverEnd: restored.lastProactiveCoverEnd ?? existing?.lastProactiveCoverEnd,
102
116
  lastProactiveTokens: restored.lastProactiveTokens ?? existing?.lastProactiveTokens,
103
117
  });
104
118
  }
105
119
  }
106
120
  }
107
- // 未知窗口:无 token 预算 → 不 proactive、不按 budget 截消息
121
+ // 未知窗口:无 token 预算 → 不按 budget 截消息。
122
+ // F1-B3:targetTokens>0 时兜底压缩与窗口无关,窗口未知照样执行(工作目标解耦);
123
+ // targetTokens=0:只挂窗口比例线(proactiveCompactRatio);该模式窗口未知时跳过 proactive。
108
124
  // 已有结构压缩摘要时,用 head + summary + tail 视图
109
125
  if (!windowKnown && !targetKnown && budgetCap == null) {
110
- const view = this.buildStructuralView(sessionId, messages, emit, stateKey);
111
- const llmMessages = this.buildLlmMessages(view.messages, systemPrompt, tools);
126
+ const proactive = this.config.targetTokens > 0
127
+ ? await this.applyProactiveCompact({
128
+ sessionId,
129
+ stateKey,
130
+ messages,
131
+ messagesBudget: 0,
132
+ agingPlan,
133
+ summarize,
134
+ estimator,
135
+ emit,
136
+ systemPrompt,
137
+ tools,
138
+ })
139
+ : { messages };
140
+ const view = proactive.messages !== messages
141
+ ? { messages: proactive.messages, droppedSummary: proactive.droppedSummary }
142
+ : this.buildStructuralView(sessionId, messages, emit, stateKey);
143
+ const llmMessages = this.buildLlmMessages(view.messages, systemPrompt, tools, agingPlan);
112
144
  const rawEstimatedTokens = estimateLLMMessages(llmMessages);
113
145
  this.states.set(stateKey, {
114
146
  ...this.states.get(stateKey),
@@ -137,9 +169,12 @@ export class DefaultContextEngine {
137
169
  stateKey,
138
170
  messages,
139
171
  messagesBudget: budget.messagesBudget,
172
+ agingPlan,
140
173
  summarize,
141
174
  estimator,
142
175
  emit,
176
+ systemPrompt,
177
+ tools,
143
178
  });
144
179
  const workingMessages = proactive.messages;
145
180
  const proactiveDroppedSummary = proactive.droppedSummary;
@@ -151,7 +186,7 @@ export class DefaultContextEngine {
151
186
  }, estimator);
152
187
  // 3. 如果没有溢出,不需要压缩
153
188
  if (selection.overflow.length === 0) {
154
- const llmMessages = this.buildLlmMessages(selection.kept, systemPrompt, tools);
189
+ const llmMessages = this.buildLlmMessages(selection.kept, systemPrompt, tools, agingPlan);
155
190
  const rawEstimatedTokens = estimateLLMMessages(llmMessages);
156
191
  const estimatedTokens = this.calibrateTokens(sessionId, rawEstimatedTokens, stateKey);
157
192
  this.states.set(stateKey, {
@@ -191,6 +226,8 @@ export class DefaultContextEngine {
191
226
  tokensBefore: overflowTokensBefore,
192
227
  });
193
228
  try {
229
+ // 缓存前缀:本轮会话同形 system+history(与主动摘要同纪律)
230
+ const overflowLlmPrefix = this.buildLlmMessages(workingMessages, systemPrompt, tools, agingPlan);
194
231
  switch (routing.route) {
195
232
  case 'truncate_tool_results_only': {
196
233
  const compressed = await this.config.compressor.compress({
@@ -211,14 +248,15 @@ export class DefaultContextEngine {
211
248
  previousSummary,
212
249
  summarize,
213
250
  tokenEstimator: estimator,
251
+ llmPrefix: overflowLlmPrefix,
214
252
  });
215
253
  compressedOverflow = compressed.result;
216
254
  droppedSummary = compressed.droppedSummary;
217
255
  break;
218
256
  }
219
257
  default: {
220
- // 兜底:直接截断
221
- compressedOverflow = selection.overflow.slice(-4);
258
+ // 兜底:保守降级(head + 工具账本 + tail),禁止只留 4 条
259
+ compressedOverflow = await this.conservativeTruncate(selection.overflow, estimator);
222
260
  break;
223
261
  }
224
262
  }
@@ -231,17 +269,24 @@ export class DefaultContextEngine {
231
269
  error: err instanceof Error ? err.message : String(err),
232
270
  durationMs: Date.now() - overflowStart,
233
271
  });
234
- // 压缩失败:截断兜底,不中断本轮
235
- compressedOverflow = selection.overflow.slice(-4);
272
+ // 压缩失败:保守降级,不中断本轮
273
+ compressedOverflow = await this.conservativeTruncate(selection.overflow, estimator);
236
274
  droppedSummary = 'Context compact failed; fell back to truncation';
237
275
  }
238
- // 6. 重组:head + compressed overflow + tail
239
- // kept = head + (部分 middle) + tail,tail 和 kept 有重叠
240
- // head = kept 中去掉 tail 的部分(包含 head + 部分 middle)
241
- const head = selection.kept.length > selection.tail.length
242
- ? selection.kept.slice(0, selection.kept.length - selection.tail.length)
243
- : [];
244
- const reassembled = [...head, ...compressedOverflow, ...selection.tail];
276
+ // 6. 重组(严格时间序):protectHead → 压缩旧 middle → 未压新 middle → tail
277
+ // kept = [protectHead, selectedMiddle, tail];overflow = 较旧 middle。
278
+ // 禁止把 compressedOverflow 插在 selectedMiddle 之后(乱序会伤推理且每轮边界漂移打穿前缀)。
279
+ const tailLen = selection.tail.length;
280
+ const keptBody = selection.kept.slice(0, Math.max(0, selection.kept.length - tailLen));
281
+ const headCount = Math.min(this.config.protectFirstN, workingMessages.length);
282
+ const protectHead = keptBody.slice(0, Math.min(headCount, keptBody.length));
283
+ const selectedMiddle = keptBody.slice(protectHead.length);
284
+ const reassembled = [
285
+ ...protectHead,
286
+ ...compressedOverflow,
287
+ ...selectedMiddle,
288
+ ...selection.tail,
289
+ ];
245
290
  // 7. 更新状态
246
291
  const compressedTokens = estimator.estimateMessages(reassembled);
247
292
  emit?.({
@@ -258,11 +303,15 @@ export class DefaultContextEngine {
258
303
  ...overflowState,
259
304
  // 存摘要正文(而非 dropped 描述),供下次迭代更新
260
305
  previousSummary: this.extractSummaryText(compressedOverflow) ?? overflowState?.previousSummary,
261
- lastEstimatedTokens: compressedTokens,
262
306
  });
263
- // 8. 构建 LLM 消息
264
- const llmMessages = this.buildLlmMessages(reassembled, systemPrompt, tools);
307
+ // 8. 构建 LLM 消息(校准基 = 老化后 LLM 视图估算——尺子必须量实际请求,
308
+ // 不能像旧代码存 raw Message 估算,否则 calibrationRatio 系统性漂移)
309
+ const llmMessages = this.buildLlmMessages(reassembled, systemPrompt, tools, agingPlan);
265
310
  const rawEstimatedTokens = estimateLLMMessages(llmMessages);
311
+ this.states.set(stateKey, {
312
+ ...this.states.get(stateKey),
313
+ lastEstimatedTokens: rawEstimatedTokens,
314
+ });
266
315
  const estimatedTokens = this.calibrateTokens(sessionId, rawEstimatedTokens, stateKey);
267
316
  return {
268
317
  messages: llmMessages,
@@ -282,92 +331,234 @@ export class DefaultContextEngine {
282
331
  return {
283
332
  summary: state?.previousSummary,
284
333
  lastProactiveMessageCount: state?.lastProactiveMessageCount,
334
+ lastProactiveCoverEnd: state?.lastProactiveCoverEnd,
285
335
  lastProactiveTokens: state?.lastProactiveTokens,
286
336
  };
287
337
  }
288
338
  /**
289
- * 主动摘要:消息 token 超过 messagesBudget × ratio 时,在硬溢出前压缩
339
+ * 主动压缩(路径 A):消息 token 超过触发线时,在硬溢出前收缩
290
340
  *
291
- * 策略:
292
- * - 未超阈值:原样返回
293
- * - 超阈值且需要新摘要(无 previousSummary / 新增消息够多):LLM 压缩中间段
294
- * - 超阈值但增量很小:用 previousSummary + head/tail 重建视图(零 LLM)
341
+ * 触发线取两条线的 min(都保留,缺一不可):
342
+ * - **目标线** targetTokens × compactFallbackRatio——与窗口解耦,防长会话失忆
343
+ * - **窗口比例线** messagesBudget × proactiveCompactRatio——防小窗口/已知窗口到顶仍未触发
344
+ *
345
+ * 语义(粘滞 + ratio=0 禁新压缩):
346
+ * - **压缩视图粘滞**:一旦建立过压缩态(previousSummary 或 lastProactiveMessageCount),
347
+ * 后续装配优先复用 head+摘要/机械中间+tail,不因估算回落或 ratio=0 而打回全量
348
+ * (全量请求会 bust 前缀缓存,且等于撤销已完成的压缩)。
349
+ * - **proactiveCompactRatio=0**:禁止**发起新的**路径 A 压缩(不只禁 LLM);
350
+ * **不**丢弃已有压缩视图。
351
+ * - 策略:
352
+ * - ratio=0:无压缩态原样返回;有压缩态仅粘滞重建
353
+ * - 未超线且无压缩态:原样返回
354
+ * - 超线且需要新一轮压缩(上次压缩后新增消息够多):LLM 压缩中间段并产出语义摘要
355
+ * - 已有压缩态且增量小或冷却中或禁新 LLM:零 LLM 重建视图
295
356
  */
296
357
  async applyProactiveCompact(params) {
297
- const { sessionId, messages, messagesBudget, summarize, estimator, emit } = params;
358
+ const { sessionId, messages, messagesBudget, agingPlan, summarize, estimator, emit, systemPrompt, tools, } = params;
298
359
  const stateKey = params.stateKey ?? sessionId;
299
360
  const ratio = this.config.proactiveCompactRatio;
300
- if (!summarize || ratio <= 0 || messages.length === 0) {
301
- return { messages };
302
- }
303
- const currentTokens = estimator.estimateMessages(messages);
304
- const threshold = Math.floor(messagesBudget * ratio);
305
- if (currentTokens <= threshold) {
361
+ const state = this.states.get(stateKey);
362
+ if (messages.length === 0) {
306
363
  return { messages };
307
364
  }
308
365
  const protectFirstN = this.config.protectFirstN;
309
366
  const protectLastN = this.config.protectLastN;
367
+ // 压缩态粘滞:有摘要或覆盖计数即认定「已压缩」,之后不回全量
368
+ const hasCompactView = state?.lastProactiveMessageCount != null || !!state?.previousSummary;
369
+ // 边界对齐(不拆 tool_call/tool_result 对)——两形状都会被严格网关 400
370
+ const { headEnd, tailStart } = this.alignViewSplit(messages, protectFirstN, protectLastN);
371
+ const head = messages.slice(0, headEnd);
372
+ const tail = messages.slice(tailStart);
373
+ const middle = this.semanticHistory(messages.slice(headEnd, tailStart));
374
+ const headTailTokens = estimator.estimateMessages(head) + estimator.estimateMessages(tail);
375
+ /**
376
+ * 零 LLM 粘滞重建。
377
+ *
378
+ * 有语义摘要时:head + 摘要 + **摘要覆盖点之后的增量** + tail。
379
+ * 增量(上次 `lastProactiveMessageCount` 之后、已滑出 tail 的消息)不得被旧摘要顶掉——
380
+ * 否则长 tool turn 会丢当前 run 前半段工作记录。
381
+ *
382
+ * @param targetMiddleTokens - 增量段机械压缩预算
383
+ * @returns 重建视图;无法重建时返回 null
384
+ */
385
+ const rebuildStickyView = async (targetMiddleTokens) => {
386
+ if (messages.length <= protectFirstN + protectLastN) {
387
+ return null;
388
+ }
389
+ if (state?.previousSummary) {
390
+ const summaryMsg = {
391
+ role: 'user',
392
+ content: wrapContextSummary(state.previousSummary),
393
+ timestamp: Date.now(),
394
+ metadata: { source: 'contextSummary' },
395
+ };
396
+ // 摘要覆盖到 lastProactiveCoverEnd(tailStart);之后的消息是增量,必须保留
397
+ const coverUpTo = state.lastProactiveCoverEnd ?? 0;
398
+ const sinceIdx = Math.max(coverUpTo, headEnd);
399
+ const sinceCompact = this.semanticHistory(messages.slice(sinceIdx, tailStart));
400
+ let extra = sinceCompact;
401
+ if (sinceCompact.length > 0) {
402
+ const extraTokens = estimator.estimateMessages(sinceCompact);
403
+ if (extraTokens > targetMiddleTokens) {
404
+ try {
405
+ const compressedExtra = await this.config.compressor.compress({
406
+ messages: sinceCompact,
407
+ targetTokens: targetMiddleTokens,
408
+ tokenEstimator: estimator,
409
+ });
410
+ extra = compressedExtra.result;
411
+ }
412
+ catch {
413
+ // 机械压缩失败:保留增量原文(宁可胖,不可丢)
414
+ extra = sinceCompact;
415
+ }
416
+ }
417
+ }
418
+ return { messages: [...head, summaryMsg, ...extra, ...tail] };
419
+ }
420
+ if (middle.length === 0) {
421
+ return null;
422
+ }
423
+ try {
424
+ const compressed = await this.config.compressor.compress({
425
+ messages: middle,
426
+ targetTokens: targetMiddleTokens,
427
+ tokenEstimator: estimator,
428
+ });
429
+ return { messages: [...head, ...compressed.result, ...tail] };
430
+ }
431
+ catch {
432
+ return null;
433
+ }
434
+ };
435
+ // F1-B3:尺子量**老化视图**(实际请求的保守上界)——raw 估算会把 B2 稳态误判超线(双机制打架)。
436
+ // 压缩输入仍用原 messages(摘要质量需要原文)。
437
+ const currentTokens = estimator.estimateMessages(applyAgingToMessages(messages, agingPlan, this.config.historyAging));
438
+ // 两条触发线(都保留;刻意不用 legacy 命名,防被当成死代码清掉):
439
+ // - 目标线 targetLine = targetTokens × compactFallbackRatio:与窗口解耦(F1-B3),
440
+ // 防长会话失忆;1M 窗口只挂比例线会永不触发。
441
+ // - 窗口比例线 windowRatioLine = messagesBudget × proactiveCompactRatio:
442
+ // 防小窗口(256k 等)在摸到目标线之前就顶满。
443
+ // 窗口未知(messagesBudget=0)时比例线为 +∞,只用目标线。
444
+ const targetLine = Math.ceil(this.config.targetTokens * this.config.compactFallbackRatio);
445
+ const windowRatioLine = messagesBudget > 0 ? Math.floor(messagesBudget * ratio) : Number.POSITIVE_INFINITY;
446
+ // ratio=0:禁止发起新的路径 A 压缩(不只禁 LLM)。已有粘滞视图仍重建,不打回全量。
447
+ if (ratio <= 0) {
448
+ if (!hasCompactView) {
449
+ return { messages };
450
+ }
451
+ // 粘滞增量预算挂工作目标(不挂被禁用的比例线)
452
+ const stickyBase = this.config.targetTokens > 0 ? this.config.targetTokens : 20_000;
453
+ const stickyMiddleTokens = Math.max(200, Math.floor(stickyBase * 0.55) - headTailTokens);
454
+ const sticky = await rebuildStickyView(stickyMiddleTokens);
455
+ if (!sticky) {
456
+ return { messages };
457
+ }
458
+ const reducedTokens = estimator.estimateMessages(sticky.messages);
459
+ this.states.set(stateKey, {
460
+ ...state,
461
+ lastProactiveTokens: reducedTokens,
462
+ lastEstimatedTokens: reducedTokens,
463
+ });
464
+ return { messages: sticky.messages };
465
+ }
466
+ // 触发线:目标线与窗口比例线取 min——小窗口走有门槛/冷却的温和 A,
467
+ // 不被挤成死代码后交给无门槛的溢出路径每 turn 压缩(双机制打架换位置,评审 H1)。
468
+ const threshold = this.config.targetTokens > 0 ? Math.min(targetLine, windowRatioLine) : windowRatioLine;
469
+ const targetMiddleTokens = Math.max(200, Math.floor(threshold * 0.55) - headTailTokens);
470
+ // 新 LLM 压缩闸门(方案 E):
471
+ // - 无 summarize 或 turn 内:禁止新 LLM,不丢已有压缩态
472
+ // - **turn 内**(最近真实 user 之后已有工具活动):禁止新 LLM 摘要——
473
+ // 活动工作记录在 middle 里,摘要会吃掉当前 run;只允许机械分级
474
+ // - turn 边界(新 user 刚到、工具活动尚未开始):才允许对更早历史做 LLM 摘要
475
+ const midTurn = isMidTurn(messages);
476
+ const allowNewLlmCompact = !!summarize && !midTurn;
477
+ // 未超线:无压缩态则原样;有压缩态则粘滞重建(禁止回全量)
478
+ if (currentTokens <= threshold) {
479
+ if (!hasCompactView) {
480
+ return { messages };
481
+ }
482
+ const sticky = await rebuildStickyView(targetMiddleTokens);
483
+ if (!sticky) {
484
+ return { messages };
485
+ }
486
+ const reducedTokens = estimator.estimateMessages(sticky.messages);
487
+ this.states.set(stateKey, {
488
+ ...state,
489
+ lastProactiveTokens: reducedTokens,
490
+ lastEstimatedTokens: reducedTokens,
491
+ });
492
+ return { messages: sticky.messages };
493
+ }
310
494
  if (messages.length <= protectFirstN + protectLastN) {
311
495
  return { messages };
312
496
  }
313
- const state = this.states.get(stateKey);
314
- const head = messages.slice(0, protectFirstN);
315
- const tail = messages.slice(-protectLastN);
316
- // 增量很小:直接用上次摘要重建视图,避免每轮打 LLM
317
- // 注意:只比「自上次摘要以来新增条数」,不要拿全量 token 和压缩后视图比
497
+ // 判据:是否开启新一轮压缩 —— 只看「自上次压缩以来的新增条数」与冷却。
498
+ // 注意:只比「自上次压缩以来新增条数」,不要拿全量 token 和压缩后视图比;
499
+ // 也不要把「有无 previousSummary」当判据:压缩可能是机械截断(无摘要),
500
+ // 拿摘要存在与否当判据会让无摘要会话每轮重裁、复用分支永远进不去。
318
501
  const lastCount = state?.lastProactiveMessageCount;
319
502
  const newSinceLast = lastCount === undefined ? messages.length : messages.length - lastCount;
320
503
  const minNewForResummarize = Math.max(3, Math.floor(protectLastN * 0.25));
321
- const needNewSummary = !state?.previousSummary || newSinceLast >= minNewForResummarize;
504
+ // 增长门(target 模式;防「偶发兜底」变「周期压缩」):持续超线的会话全量口径不回落,
505
+ // 若只看消息增量,每攒 minNewForResummarize 条就全量重压(LLM 成本/延迟失控)。
506
+ // 只有全量口径较上次压缩实质增长(≥ 25% 阈值)才允许再打 LLM。
507
+ // targetTokens=0(只挂窗口比例线)保持既有「攒够增量重试」节奏不动。
508
+ const lastFull = state?.lastProactiveFullTokens;
509
+ const grownEnough = this.config.targetTokens <= 0 ||
510
+ lastFull === undefined ||
511
+ currentTokens >= lastFull + Math.max(1, Math.floor(threshold * 0.25));
512
+ const needNewCompaction = newSinceLast >= minNewForResummarize && grownEnough;
322
513
  // 冷却:刚做过 LLM 摘要则优先缓存重建,降低单 turn 双摘要概率
323
514
  const cooldownMs = this.config.proactiveCooldownMs;
324
515
  const inCooldown = cooldownMs > 0 &&
325
516
  state?.lastProactiveLlmAt != null &&
326
517
  Date.now() - state.lastProactiveLlmAt < cooldownMs;
327
- if (state?.previousSummary && (!needNewSummary || inCooldown)) {
328
- // 摘要用 user 角色承载,避免中段 system 被严格网关拒绝
329
- const summaryMsg = {
330
- role: 'user',
331
- content: wrapContextSummary(state.previousSummary),
332
- timestamp: Date.now(),
333
- metadata: { source: 'contextSummary' },
334
- };
335
- const reduced = [...head, summaryMsg, ...tail];
336
- const reducedTokens = estimator.estimateMessages(reduced);
337
- // 只更新视图 token,**不要**改 lastProactiveMessageCount:
338
- // 该字段表示「摘要覆盖到的全量条数」,只能在真正 LLM 摘要时推进。
339
- // 若缓存重建也改成 messages.length,每轮 +1 会永远凑不满再摘要阈值。
340
- this.states.set(stateKey, {
341
- ...state,
342
- lastProactiveTokens: reducedTokens,
343
- lastEstimatedTokens: reducedTokens,
344
- });
345
- // 缓存重建极快,仍发 start/end 以便 UI 状态机一致(cached=true)
346
- emit?.({
347
- type: 'context.compact.start',
348
- sessionId,
349
- reason: 'proactive',
350
- tokensBefore: currentTokens,
351
- threshold,
352
- });
353
- emit?.({
354
- type: 'context.compact.end',
355
- sessionId,
356
- reason: 'proactive',
357
- tokensBefore: currentTokens,
358
- tokensAfter: reducedTokens,
359
- durationMs: 0,
360
- cached: true,
361
- });
362
- return { messages: reduced };
518
+ // 复用重建(零 LLM):已压缩过,且增量小或在冷却期或禁止新 LLM。
519
+ if (hasCompactView &&
520
+ (!allowNewLlmCompact || !needNewCompaction || inCooldown)) {
521
+ const sticky = await rebuildStickyView(targetMiddleTokens);
522
+ if (sticky) {
523
+ const reducedTokens = estimator.estimateMessages(sticky.messages);
524
+ // 只更新视图 token,**不要**改 lastProactiveMessageCount:
525
+ // 该字段表示「压缩覆盖到的全量条数」,只能在真正完成一次压缩时推进。
526
+ // 若复用重建也改成 messages.length,每轮 +1 会永远凑不满再压缩阈值。
527
+ this.states.set(stateKey, {
528
+ ...state,
529
+ lastProactiveTokens: reducedTokens,
530
+ lastEstimatedTokens: reducedTokens,
531
+ });
532
+ emit?.({
533
+ type: 'context.compact.start',
534
+ sessionId,
535
+ reason: 'proactive',
536
+ tokensBefore: currentTokens,
537
+ threshold,
538
+ });
539
+ emit?.({
540
+ type: 'context.compact.end',
541
+ sessionId,
542
+ reason: 'proactive',
543
+ tokensBefore: currentTokens,
544
+ tokensAfter: reducedTokens,
545
+ durationMs: 0,
546
+ cached: true,
547
+ });
548
+ return { messages: sticky.messages };
549
+ }
363
550
  }
364
- // 需要新摘要:压缩 head/tail 之间的中间段(语义历史,不含 grounding)
365
- const middle = this.semanticHistory(messages.slice(protectFirstN, messages.length - protectLastN));
551
+ // 禁新路径 A(无 summarize / turn 内)且无粘滞视图:超线也只走机械(不打摘要 LLM)
552
+ if (!allowNewLlmCompact) {
553
+ const sticky = await rebuildStickyView(targetMiddleTokens);
554
+ return sticky ? { messages: sticky.messages } : { messages };
555
+ }
556
+ // 需要新一轮压缩:压缩 head/tail 之间的中间段(语义历史,不含 grounding)。
557
+ // requireSummary:主交付是语义摘要(缓解长会话失忆),机械截断达标也必须补摘要——
558
+ // 否则 previousSummary 永远为空、复用分支永远进不去,每个 turn 都会重裁+发通知。
366
559
  if (middle.length === 0) {
367
560
  return { messages };
368
561
  }
369
- const headTailTokens = estimator.estimateMessages(head) + estimator.estimateMessages(tail);
370
- const targetMiddleTokens = Math.max(200, Math.floor(threshold * 0.55) - headTailTokens);
371
562
  const proactiveStart = Date.now();
372
563
  emit?.({
373
564
  type: 'context.compact.start',
@@ -378,12 +569,16 @@ export class DefaultContextEngine {
378
569
  });
379
570
  let compressed;
380
571
  try {
572
+ // 缓存前缀 = 会话同形 system+history(禁止改字节);摘要指令只挂在尾部
573
+ const llmPrefix = this.buildLlmMessages(messages, systemPrompt, tools, agingPlan);
381
574
  compressed = await this.config.compressor.compress({
382
575
  messages: middle,
383
576
  targetTokens: targetMiddleTokens,
384
577
  previousSummary: state?.previousSummary,
385
578
  summarize,
386
579
  tokenEstimator: estimator,
580
+ requireSummary: true,
581
+ llmPrefix,
387
582
  });
388
583
  }
389
584
  catch (err) {
@@ -394,8 +589,9 @@ export class DefaultContextEngine {
394
589
  error: err instanceof Error ? err.message : String(err),
395
590
  durationMs: Date.now() - proactiveStart,
396
591
  });
397
- // 主动摘要失败:不改视图,交给后续硬溢出路径处理
398
- return { messages };
592
+ // 主动摘要失败:优先粘滞重建,其次不改视图
593
+ const sticky = await rebuildStickyView(targetMiddleTokens);
594
+ return sticky ? { messages: sticky.messages } : { messages };
399
595
  }
400
596
  const reduced = [...head, ...compressed.result, ...tail];
401
597
  const reducedTokens = estimator.estimateMessages(reduced);
@@ -404,8 +600,13 @@ export class DefaultContextEngine {
404
600
  ...state,
405
601
  previousSummary: actualSummary,
406
602
  lastEstimatedTokens: reducedTokens,
603
+ // 增长门用全量条数;覆盖终点单独记 tailStart(tail 不在摘要内)
407
604
  lastProactiveMessageCount: messages.length,
605
+ lastProactiveCoverEnd: tailStart,
408
606
  lastProactiveTokens: reducedTokens,
607
+ lastProactiveFullTokens: currentTokens,
608
+ // 本轮(requireSummary)真正发起过 LLM 摘要调用(成功或失败均算发起),
609
+ // 时间戳用于冷却;复用重建与纯机械降级不得推进此字段。
409
610
  lastProactiveLlmAt: Date.now(),
410
611
  });
411
612
  emit?.({
@@ -422,32 +623,131 @@ export class DefaultContextEngine {
422
623
  droppedSummary: compressed.droppedSummary ?? 'Older turns proactively summarized',
423
624
  };
424
625
  }
425
- /** 从压缩结果中提取摘要正文(contextSummary 标记或 [Conversation Summary] 前缀) */
626
+ /**
627
+ * 保守降级(overflow **middle 替换体**):工具账本说明 + 近尾
628
+ * 外层 head/tail 由 assemble 重组拼接,此处不得重复携带。
629
+ *
630
+ * @param messages - 待降级消息(overflow 段)
631
+ * @param _estimator - token 估算器(保留签名对称)
632
+ * @returns 降级后的消息列表
633
+ */
634
+ async conservativeTruncate(messages, _estimator) {
635
+ const keepCount = Math.min(Math.max(6, Math.ceil(messages.length * 0.15)), messages.length);
636
+ const kept = messages.slice(-keepCount);
637
+ const dropped = messages.slice(0, messages.length - keepCount);
638
+ // 无可丢弃:原样返回(禁止「0 removed」假通知膨胀)
639
+ if (dropped.length === 0) {
640
+ return [...messages];
641
+ }
642
+ const body = buildToolCallLedger(dropped);
643
+ const notice = {
644
+ role: 'user',
645
+ content: body
646
+ ? `[Context truncated: ${dropped.length} earlier messages removed to fit context window]\n[Tool call ledger — do NOT redo these unless explicitly asked]\n${body}`
647
+ : `[Context truncated: ${dropped.length} earlier messages removed to fit context window]`,
648
+ timestamp: Date.now(),
649
+ metadata: { source: 'contextSummary' },
650
+ };
651
+ return [notice, ...kept];
652
+ }
653
+ /**
654
+ * 从压缩结果中提取语义摘要正文(contextSummary 标记或 [Conversation Summary] 前缀)。
655
+ * 机械降级的占位说明([Context truncated / [Context compressed / [Structural compact])
656
+ * 不算语义摘要:把它们当摘要存入 previousSummary 会污染增量合并输入,
657
+ * 并让复用分支拿到假摘要、掩盖「从未真正摘要」的事实。
658
+ */
426
659
  extractSummaryText(compressed) {
427
660
  for (const m of compressed) {
428
- if (m.metadata?.source === 'contextSummary' && typeof m.content === 'string' && m.content.trim()) {
661
+ if (m.metadata?.source === 'contextSummary' &&
662
+ typeof m.content === 'string' &&
663
+ m.content.trim() &&
664
+ !this.isMechanicalNotice(m.content)) {
429
665
  return m.content;
430
666
  }
431
667
  }
432
668
  for (const m of compressed) {
433
- if (typeof m.content === 'string' && m.content.includes('[Conversation Summary]')) {
669
+ if (typeof m.content === 'string' &&
670
+ m.content.includes('[Conversation Summary]') &&
671
+ !this.isMechanicalNotice(m.content)) {
434
672
  return m.content;
435
673
  }
436
674
  }
437
675
  return undefined;
438
676
  }
439
677
  /**
440
- * 压缩/摘要的语义输入:丢掉托管 system 与 knowledgeGrounding
441
- * (grounding 每轮现算,不进 previousSummary)
678
+ * 机械降级占位说明判别(非语义摘要):首条实质行以占位标记开头即认定。
679
+ * 只看首行而非全文 includes——真实摘要引用这些字符串(如记录「曾发生截断」)不得被误杀。
680
+ *
681
+ * @param text - 候选摘要正文
682
+ * @returns 是否为机械占位说明
683
+ */
684
+ isMechanicalNotice(text) {
685
+ for (const raw of text.split('\n')) {
686
+ const line = raw.trim();
687
+ if (!line || line === '[Conversation Summary]')
688
+ continue;
689
+ return (line.startsWith('[Context truncated:') ||
690
+ line.startsWith('[Context compressed:') ||
691
+ line.startsWith('[Structural compact]'));
692
+ }
693
+ return false;
694
+ }
695
+ /**
696
+ * 判断是否工具结果消息(视图边界对齐用)
697
+ *
698
+ * @param msg - 待判定消息
699
+ * @returns 是否为工具结果消息
700
+ */
701
+ isToolResultMessage(msg) {
702
+ return msg.role === 'tool' || (msg.toolResults?.length ?? 0) > 0;
703
+ }
704
+ /**
705
+ * 视图切分边界对齐(不拆 tool_call/tool_result 对)
706
+ *
707
+ * head 不得停在带 toolCalls 的 assistant 上(其结果落入中间段,视图里会成悬空调用);
708
+ * tail 不得起于 tool 结果(其调用在中间段,会成孤儿结果)——两种形状都会被严格网关 400。
709
+ *
710
+ * @param messages - 全量消息
711
+ * @param headCount - 期望头部条数
712
+ * @param tailCount - 期望尾部条数
713
+ * @returns 对齐后的 head 终点(不含)与 tail 起点(含)
714
+ */
715
+ alignViewSplit(messages, headCount, tailCount) {
716
+ let headEnd = Math.min(headCount, messages.length);
717
+ while (headEnd > 0 && (messages[headEnd - 1]?.toolCalls?.length ?? 0) > 0) {
718
+ headEnd--;
719
+ }
720
+ let tailStart = Math.max(0, messages.length - tailCount);
721
+ while (tailStart > headEnd && this.isToolResultMessage(messages[tailStart])) {
722
+ tailStart--;
723
+ }
724
+ return { headEnd, tailStart };
725
+ }
726
+ /**
727
+ * 压缩/摘要的语义输入:丢掉托管 system 与 turn 信封元数据
728
+ * (turn_context picks 不进 previousSummary——防陈旧择取固化进摘要);
729
+ * turn_start 只保留 <user_message> 正文。
442
730
  */
443
731
  semanticHistory(messages) {
444
- return messages.filter((m) => {
732
+ const out = [];
733
+ for (const m of messages) {
445
734
  if (m.role === 'system' && m.metadata?.source === 'systemPrompt')
446
- return false;
735
+ continue;
736
+ if (m.metadata?.source === 'turnEnd')
737
+ continue;
447
738
  if (m.metadata?.source === 'knowledgeGrounding')
448
- return false;
449
- return true;
450
- });
739
+ continue;
740
+ if (m.metadata?.source === 'runtimeSnapshot')
741
+ continue;
742
+ if (m.metadata?.source === 'sessionAttachment')
743
+ continue;
744
+ if (isTurnStartContent(m.content)) {
745
+ out.push({ ...m, content: extractUserMessageText(m.content) });
746
+ continue;
747
+ }
748
+ out.push(m);
749
+ }
750
+ return out;
451
751
  }
452
752
  /**
453
753
  * 结构视图:有 previousSummary 时 head + summary + tail;否则原样
@@ -464,8 +764,11 @@ export class DefaultContextEngine {
464
764
  if (messages.length <= protectFirstN + protectLastN) {
465
765
  return { messages };
466
766
  }
467
- const head = messages.slice(0, protectFirstN);
468
- const tail = messages.slice(-protectLastN);
767
+ // 边界对齐(不拆 tool_call/tool_result 对):与 applyProactiveCompact 同款——
768
+ // 未对齐的 head/tail 会被严格网关 400
769
+ const { headEnd, tailStart } = this.alignViewSplit(messages, protectFirstN, protectLastN);
770
+ const head = messages.slice(0, headEnd);
771
+ const tail = messages.slice(tailStart);
469
772
  const summaryMsg = {
470
773
  role: 'user',
471
774
  content: wrapContextSummary(summary),
@@ -495,7 +798,7 @@ export class DefaultContextEngine {
495
798
  * 算法委托 capabilities/compact;本引擎只维护 E4 状态。
496
799
  */
497
800
  async structuralCompact(params) {
498
- const { sessionId, messages, summarize, estimator } = params;
801
+ const { sessionId, messages, summarize, estimator, llmPrefix } = params;
499
802
  const stateKey = params.stateKey ?? sessionId;
500
803
  const protectFirstN = this.config.protectFirstN;
501
804
  const protectLastN = this.config.protectLastN;
@@ -503,14 +806,21 @@ export class DefaultContextEngine {
503
806
  const state = this.states.get(stateKey);
504
807
  if (messages.length <= protectFirstN + protectLastN) {
505
808
  return {
506
- summary: state?.previousSummary ?? '',
809
+ summary: state?.previousSummary,
810
+ compacted: false,
507
811
  tokensBefore,
508
812
  tokensAfter: tokensBefore,
813
+ coveredMessageCount: state?.lastProactiveCoverEnd,
509
814
  };
510
815
  }
511
- const outcome = await this.config.compactEngine.compactMessages(this.semanticHistory(messages), {
512
- protectHead: protectFirstN,
513
- protectTail: protectLastN,
816
+ // 覆盖坐标与 applyProactiveCompact / rebuildStickyView 同一系:
817
+ // 原始 messages 上 alignViewSplit → middle 语义历史 → 摘要;coverEnd = tailStart。
818
+ // 禁止对 semanticHistory(全量) 切 protectHead/Tail(过滤数组下标 ≠ 原始下标,会丢消息)。
819
+ const { headEnd, tailStart } = this.alignViewSplit(messages, protectFirstN, protectLastN);
820
+ const middle = this.semanticHistory(messages.slice(headEnd, tailStart));
821
+ const outcome = await this.config.compactEngine.compactMessages(middle, {
822
+ protectHead: 0,
823
+ protectTail: 0,
514
824
  targetTokens: params.compactTargetTokens,
515
825
  mode: 'structure_only',
516
826
  previousSummary: state?.previousSummary,
@@ -520,67 +830,28 @@ export class DefaultContextEngine {
520
830
  ? Math.max(200, Math.floor(params.compactTargetTokens * 0.3))
521
831
  : undefined,
522
832
  onSummarizeFail: 'truncate',
833
+ llmPrefix,
523
834
  });
524
- const summary = outcome.summary ??
525
- state?.previousSummary ??
526
- `[Structural compact] dropped messages (contextWindow unknown)`;
835
+ // 与 extractSummaryText 同一不变量:机械占位说明不是语义摘要,不得进入 previousSummary
836
+ // (增量合并输入、复用重建依据、持久化快照来源)——否则占位会经快照恢复再次污染状态。
837
+ const semanticSummary = outcome.summary && !this.isMechanicalNotice(outcome.summary) ? outcome.summary : undefined;
838
+ const summary = semanticSummary ?? state?.previousSummary;
527
839
  const tokensAfter = outcome.tokensAfter ?? tokensBefore;
528
840
  this.states.set(stateKey, {
529
841
  ...state,
530
842
  previousSummary: summary,
531
843
  lastProactiveMessageCount: messages.length,
844
+ lastProactiveCoverEnd: tailStart,
532
845
  lastProactiveTokens: tokensAfter,
533
846
  lastEstimatedTokens: tokensAfter,
534
847
  lastProactiveLlmAt: summarize ? Date.now() : state?.lastProactiveLlmAt,
535
848
  });
536
- return { summary, tokensBefore, tokensAfter };
537
- }
538
- /**
539
- * 压缩存储
540
- *
541
- * - force / 无 tokenBudget:可走结构压缩(compactStructural)
542
- * - 有 tokenBudget 且非 force:低于阈值跳过
543
- * - 窗口未知且非 force、无 target:跳过自动压缩
544
- */
545
- async compact(params) {
546
- const { sessionId, agentId, tokenBudget, compactTargetTokens, force, currentTokenCount, } = params;
547
- const stateKey = compactStateKey(sessionId, agentId);
548
- const state = this.states.get(stateKey);
549
- if (!state) {
550
- return {
551
- ok: true,
552
- compacted: false,
553
- reason: 'No state found for session',
554
- tokensBefore: 0,
555
- };
556
- }
557
- const tokensBefore = currentTokenCount ?? state.lastEstimatedTokens ?? state.lastProactiveTokens ?? 0;
558
- if (!force && tokenBudget != null && tokenBudget > 0) {
559
- const threshold = Math.floor(tokenBudget * this.config.compactThreshold);
560
- if (tokensBefore <= threshold) {
561
- return {
562
- ok: true,
563
- compacted: false,
564
- reason: `Tokens (${tokensBefore}) below threshold (${threshold})`,
565
- tokensBefore,
566
- };
567
- }
568
- }
569
- // 窗口未知 + 非 force + 无显式 target:禁用自动压缩
570
- if (!force && tokenBudget == null && compactTargetTokens == null) {
571
- return {
572
- ok: true,
573
- compacted: false,
574
- reason: 'contextWindow unknown; auto compact disabled (force/structural still available)',
575
- tokensBefore,
576
- };
577
- }
578
- this.states.delete(stateKey);
579
849
  return {
580
- ok: true,
581
- compacted: true,
582
- reason: force ? 'forced' : 'threshold',
850
+ summary,
851
+ compacted: outcome.compacted,
583
852
  tokensBefore,
853
+ tokensAfter,
854
+ coveredMessageCount: tailStart,
584
855
  };
585
856
  }
586
857
  /**
@@ -599,14 +870,16 @@ export class DefaultContextEngine {
599
870
  summarize: input.summarize,
600
871
  estimator,
601
872
  compactTargetTokens: input.compactTargetTokens,
873
+ llmPrefix: input.llmPrefix,
602
874
  });
603
875
  return {
604
876
  ok: true,
605
- compacted: Boolean(result.summary),
877
+ compacted: result.compacted,
606
878
  reason: 'structural',
607
879
  tokensBefore: result.tokensBefore,
608
880
  tokensAfter: result.tokensAfter,
609
- summary: result.summary || undefined,
881
+ summary: result.summary,
882
+ coveredMessageCount: result.coveredMessageCount,
610
883
  };
611
884
  }
612
885
  /**
@@ -657,7 +930,6 @@ export class DefaultContextEngine {
657
930
  * 使用校准比率修正 token 估算
658
931
  *
659
932
  * 当有真实 usage 数据时,用 calibrationRatio 修正启发式估算值。
660
- * 参考 OpenClaw 的 estimateContextTokens() 策略:
661
933
  * 优先用真实值,估算只做兜底,校准比率平滑修正偏差。
662
934
  */
663
935
  calibrateTokens(sessionId, rawEstimated, stateKey) {
@@ -669,7 +941,7 @@ export class DefaultContextEngine {
669
941
  const clampedRatio = Math.max(0.5, Math.min(2.0, state.calibrationRatio));
670
942
  return Math.ceil(rawEstimated * clampedRatio);
671
943
  }
672
- buildLlmMessages(messages, systemPrompt, tools) {
944
+ buildLlmMessages(messages, systemPrompt, tools, aging) {
673
945
  const result = [];
674
946
  // 系统提示词(唯一权威来源)。
675
947
  // Loop 会把同一内容以 metadata.source==='systemPrompt' unshift 进 messages,
@@ -677,21 +949,19 @@ export class DefaultContextEngine {
677
949
  if (systemPrompt) {
678
950
  result.push({ role: 'system', content: systemPrompt });
679
951
  }
680
- // knowledgeGrounding:只保留最近一条(旧 grounding 不回放;每轮现算)
681
- let lastGroundingIdx = -1;
682
- for (let i = 0; i < messages.length; i++) {
683
- if (messages[i].metadata?.source === 'knowledgeGrounding')
684
- lastGroundingIdx = i;
685
- }
952
+ // 全回放(append-only):turn_context / turn_end / 历史槽位一律保留,
953
+ // 否则历史中部删改会打穿 provider 前缀缓存。
954
+ // 唯一例外:runStopped 是引擎停止的审计/展示凭据,不是对话内容——
955
+ // 它只进聊天回放(系统提示条),不回灌 LLM(否则每次停止都在上下文里留痕)。
686
956
  for (let i = 0; i < messages.length; i++) {
687
957
  const msg = messages[i];
688
958
  if (msg.role === 'system' && msg.metadata?.source === 'systemPrompt') {
689
959
  continue;
690
960
  }
691
- if (msg.metadata?.source === 'knowledgeGrounding' && i !== lastGroundingIdx) {
961
+ if (msg.metadata?.source === 'runStopped') {
692
962
  continue;
693
963
  }
694
- result.push(...this.convertMessage(msg));
964
+ result.push(...this.convertMessage(msg, aging));
695
965
  }
696
966
  return result;
697
967
  }
@@ -704,7 +974,7 @@ export class DefaultContextEngine {
704
974
  * - 工具结果消息
705
975
  * - 多模态消息
706
976
  */
707
- convertMessage(msg) {
977
+ convertMessage(msg, aging) {
708
978
  const result = [];
709
979
  // 清理无效消息
710
980
  if (this.shouldSkipMessage(msg)) {
@@ -715,11 +985,10 @@ export class DefaultContextEngine {
715
985
  // 错误必须进入 content:Loop 写历史时 result=null、error=文案,
716
986
  // 若只读 result 会变成 "null",LLM 看不到失败原因。
717
987
  for (const tr of msg.toolResults ?? []) {
718
- const content = tr.error !== undefined
719
- ? JSON.stringify({ error: tr.error })
720
- : typeof tr.result === 'string'
721
- ? tr.result
722
- : JSON.stringify(tr.result ?? null);
988
+ // F1-B2:老化条目降级为结构化指针(错误文案保真在指针内;tool_call 配对不动)
989
+ const content = aging && aging.agedIds.has(tr.toolCallId)
990
+ ? agedToolResultPointer(tr, aging.argsById.get(tr.toolCallId), this.config.historyAging)
991
+ : toolResultBody(tr);
723
992
  result.push({
724
993
  role: 'tool',
725
994
  content,
@@ -730,17 +999,23 @@ export class DefaultContextEngine {
730
999
  }
731
1000
  else if (msg.role === 'assistant' && msg.toolCalls?.length) {
732
1001
  // 带工具调用的 assistant 消息
1002
+ // F1-B2:与结果同步老化的参数降级为键值摘要(id/name 不动,arguments 仍是合法 JSON)
733
1003
  result.push({
734
1004
  role: 'assistant',
735
1005
  content: getTextContent(msg.content) || null,
736
- tool_calls: msg.toolCalls.map(tc => ({
737
- id: tc.id,
738
- type: 'function',
739
- function: {
740
- name: tc.name,
741
- arguments: JSON.stringify(tc.arguments),
742
- },
743
- })),
1006
+ tool_calls: msg.toolCalls.map(tc => {
1007
+ const args = aging && this.config.historyAging.ageToolArgs && aging.agedIds.has(tc.id)
1008
+ ? agedToolArgDigest(tc.name, tc.arguments, this.config.historyAging)
1009
+ : tc.arguments;
1010
+ return {
1011
+ id: tc.id,
1012
+ type: 'function',
1013
+ function: {
1014
+ name: tc.name,
1015
+ arguments: JSON.stringify(args),
1016
+ },
1017
+ };
1018
+ }),
744
1019
  });
745
1020
  }
746
1021
  else if (Array.isArray(msg.content)) {
@@ -834,3 +1109,39 @@ export class DefaultContextEngine {
834
1109
  return false;
835
1110
  }
836
1111
  }
1112
+ /**
1113
+ * 是否处于 turn 内(最近真实 user 消息之后已有工具活动)
1114
+ *
1115
+ * 方案 E:turn 内 middle 全是当前 run 工作记录,禁止 LLM 摘要;
1116
+ * turn 边界(新 user 刚落、尚无工具)才允许对更早历史做语义压缩。
1117
+ *
1118
+ * 「真实 user」= 无 agentId 归因,且非引擎载体(含 `engineHint` reliability 注入)。
1119
+ * 多 agent 共线时带 agentId 的 user 不重置本边界(只认主对话发言)。
1120
+ *
1121
+ * @param messages - 全量消息
1122
+ * @returns 是否 turn 内
1123
+ */
1124
+ export function isMidTurn(messages) {
1125
+ let lastGenuineUserIdx = -1;
1126
+ for (let i = 0; i < messages.length; i++) {
1127
+ const msg = messages[i];
1128
+ if (msg.role !== 'user')
1129
+ continue;
1130
+ if (msg.agentId)
1131
+ continue;
1132
+ if (isEngineCarrierSource(msg.metadata?.source))
1133
+ continue;
1134
+ lastGenuineUserIdx = i;
1135
+ }
1136
+ if (lastGenuineUserIdx < 0)
1137
+ return false;
1138
+ for (let i = lastGenuineUserIdx + 1; i < messages.length; i++) {
1139
+ const msg = messages[i];
1140
+ if (msg.role === 'tool' ||
1141
+ (msg.toolResults?.length ?? 0) > 0 ||
1142
+ (msg.toolCalls?.length ?? 0) > 0) {
1143
+ return true;
1144
+ }
1145
+ }
1146
+ return false;
1147
+ }