@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
@@ -6,7 +6,7 @@
6
6
  * 2. LLM 摘要(如果可用)
7
7
  * 3. 截断(兜底)
8
8
  *
9
- * 参考 OpenClaw 的智能路由 + Hermes 的四阶段压缩算法。
9
+ * 智能路由 + 四阶段压缩算法。
10
10
  */
11
11
  import type { Compressor, CompressParams, CompressResult } from './types.js';
12
12
  export declare class HybridCompressor implements Compressor {
@@ -17,8 +17,8 @@ export declare class HybridCompressor implements Compressor {
17
17
  * 压缩消息
18
18
  *
19
19
  * 策略:
20
- * 1. 预处理:清除旧工具结果(无 LLM)
21
- * 2. 如果有摘要函数,使用 LLM 摘要
20
+ * 1. 机械预处理(截断旧工具结果)——只作用于**丢弃体/机械路径**,不进 LLM 摘要输入
21
+ * 2. 如果有摘要函数,对**原文**做 LLM 摘要(F-b:禁止先打码再摘要)
22
22
  * 3. 否则使用截断
23
23
  */
24
24
  compress(params: CompressParams): Promise<CompressResult>;
@@ -6,19 +6,20 @@
6
6
  * 2. LLM 摘要(如果可用)
7
7
  * 3. 截断(兜底)
8
8
  *
9
- * 参考 OpenClaw 的智能路由 + Hermes 的四阶段压缩算法。
9
+ * 智能路由 + 四阶段压缩算法。
10
10
  */
11
11
  import { HeuristicTokenEstimator } from './token-estimator.js';
12
12
  import { LLMSummaryCompressor } from './llm-summarizer.js';
13
+ import { toolResultBody } from './tool-result-body.js';
13
14
  import { TruncateCompressor } from './truncate-compressor.js';
14
15
  /**
15
16
  * 工具结果截断阈值(字符数)
16
17
  */
17
18
  const TOOL_RESULT_TRUNCATE_THRESHOLD = 200;
18
19
  /**
19
- * 工具结果截断后的占位符
20
+ * 工具结果截断后的占位符(中性归档措辞——禁止诱导重跑)
20
21
  */
21
- const TOOL_RESULT_PLACEHOLDER = '[Tool output truncated - too long to display. Use the tool again if needed.]';
22
+ const TOOL_RESULT_PLACEHOLDER = '[Tool output archived in session log — do NOT re-run unless the output is needed again.]';
22
23
  export class HybridCompressor {
23
24
  llmCompressor;
24
25
  truncateCompressor;
@@ -30,8 +31,8 @@ export class HybridCompressor {
30
31
  * 压缩消息
31
32
  *
32
33
  * 策略:
33
- * 1. 预处理:清除旧工具结果(无 LLM)
34
- * 2. 如果有摘要函数,使用 LLM 摘要
34
+ * 1. 机械预处理(截断旧工具结果)——只作用于**丢弃体/机械路径**,不进 LLM 摘要输入
35
+ * 2. 如果有摘要函数,对**原文**做 LLM 摘要(F-b:禁止先打码再摘要)
35
36
  * 3. 否则使用截断
36
37
  */
37
38
  async compress(params) {
@@ -46,30 +47,31 @@ export class HybridCompressor {
46
47
  }
47
48
  // 计算当前 token 数
48
49
  const currentTokens = estimator.estimateMessages(messages);
49
- // 如果已经在预算内,不需要压缩
50
- if (currentTokens <= targetTokens) {
50
+ // 如果已经在预算内,不需要压缩。
51
+ // requireSummary 除外:主动摘要路径的主交付是语义摘要,达标也必须继续到摘要级。
52
+ if (currentTokens <= targetTokens && !params.requireSummary) {
51
53
  return {
52
54
  result: [...messages],
53
55
  estimatedTokens: currentTokens,
54
56
  };
55
57
  }
56
- // 第一级:清除旧工具结果(无 LLM)
58
+ // 机械预处理:仅给机械截断/残差用(F-b:不进摘要输入)
57
59
  const preprocessed = this.preprocessToolResults(messages);
58
60
  const preprocessedTokens = estimator.estimateMessages(preprocessed);
59
- // 如果预处理后已在预算内
60
- if (preprocessedTokens <= targetTokens) {
61
+ // 如果预处理后已在预算内(requireSummary 时同样继续:机械截断不产出语义摘要)
62
+ if (preprocessedTokens <= targetTokens && !params.requireSummary) {
61
63
  return {
62
64
  result: preprocessed,
63
65
  estimatedTokens: preprocessedTokens,
64
66
  droppedSummary: 'Old tool outputs truncated',
65
67
  };
66
68
  }
67
- // 第二级:LLM 摘要(如果可用)
69
+ // 第二级:LLM 摘要 —— 输入为原文(F-b)
68
70
  if (params.summarize) {
69
71
  try {
70
72
  const result = await this.llmCompressor.compress({
71
73
  ...params,
72
- messages: preprocessed,
74
+ messages,
73
75
  });
74
76
  return result;
75
77
  }
@@ -78,7 +80,7 @@ export class HybridCompressor {
78
80
  console.warn('LLM summarization failed, falling back to truncation:', err);
79
81
  }
80
82
  }
81
- // 第三级:截断(兜底)
83
+ // 第三级:截断(兜底)——机械预处理后的丢弃体
82
84
  return this.truncateCompressor.compress({
83
85
  ...params,
84
86
  messages: preprocessed,
@@ -113,18 +115,11 @@ export class HybridCompressor {
113
115
  }
114
116
  // 旧的工具结果:截断冗长的输出
115
117
  const truncatedResults = msg.toolResults.map(tr => {
116
- const body = tr.error !== undefined
117
- ? JSON.stringify({ error: tr.error })
118
- : typeof tr.result === 'string'
119
- ? tr.result
120
- : JSON.stringify(tr.result ?? null);
118
+ const body = toolResultBody(tr);
121
119
  if (body.length > TOOL_RESULT_TRUNCATE_THRESHOLD) {
122
- // 错误结果截断 error 字段,成功结果截断 result 字段
120
+ // error 永不打码(错误可追溯性优先,与 B2 同红线);只截断成功结果
123
121
  if (tr.error !== undefined) {
124
- return {
125
- ...tr,
126
- error: TOOL_RESULT_PLACEHOLDER,
127
- };
122
+ return tr;
128
123
  }
129
124
  return {
130
125
  ...tr,
@@ -1,9 +1,11 @@
1
1
  /**
2
2
  * Harness Context 模块导出
3
3
  */
4
- export type { ContextEngine, ContextEngineInfo, AssembleParams, AssembleResult, IngestParams, CompactParams, CompactResult, AfterTurnParams, TokenEstimator, SummarizeFunction, MessageSelector, SelectResult, SelectOptions, Compressor, CompressParams, CompressResult, BudgetAllocator, BudgetAllocateParams, BudgetAllocateResult, ContextCompactReason, ContextCompactEvent, ContextEmitFn, ContextCompactSnapshot, } from './types.js';
4
+ export type { ContextEngine, ContextEngineInfo, AssembleParams, AssembleResult, IngestParams, CompactResult, AfterTurnParams, TokenEstimator, SummarizeFunction, MessageSelector, SelectResult, SelectOptions, Compressor, CompressParams, CompressResult, BudgetAllocator, BudgetAllocateParams, BudgetAllocateResult, ContextCompactReason, ContextCompactEvent, ContextEmitFn, ContextCompactSnapshot, } from './types.js';
5
5
  export { DefaultContextEngine } from './default-context-engine.js';
6
6
  export type { DefaultContextEngineConfig } from './default-context-engine.js';
7
+ export { formatTurnId, formatTurnStartContent, formatTurnEndContent, formatTurnContextXml, extractUserMessageText, stripTurnContextXml, isTurnStartContent, isTurnEndContent, parseTurnIdFromContent, parseTurnEnvelope, joinSlotXml, unwrapUserText, messageText, escapeUserMessageText, } from './turn-envelope.js';
8
+ export type { TurnEnvelopeSlot, TurnEnvelopeParts } from './turn-envelope.js';
7
9
  export { HeuristicTokenEstimator, estimateTextTokens, estimateLLMMessages } from './token-estimator.js';
8
10
  export { CHARS_PER_TOKEN, TOOL_RESULT_CHARS_PER_TOKEN, JSON_CHARS_PER_TOKEN, MESSAGE_OVERHEAD_TOKENS, SAFETY_MARGIN, IMAGE_TOKEN_ESTIMATE, AUDIO_TOKEN_ESTIMATE, VIDEO_TOKEN_ESTIMATE, SAMPLE_THRESHOLD, } from './token-constants.js';
9
11
  export { LAYER_ORDER, LAYER_PRIORITY, LAYER_DEFAULT_SHARE, extractLayerQuery, isThinLayerQuery, hasLayerText, } from './layer-types.js';
@@ -24,3 +26,5 @@ export { loadConstitution, productConstitutionPath } from './constitution/load-c
24
26
  export type { ConstitutionConfig, ConstitutionMode, LoadedConstitution } from './constitution/load-constitution.js';
25
27
  export type { SystemPromptAssembleInput, SystemPromptAssembleOutput, } from './system-prompt-assembler.js';
26
28
  export { formatRuntimeDatetimeInjection, formatRuntimeWorkspaceInjection, withRuntimeDatetimeInjection, withRuntimeEnvironmentInjection, } from './runtime-datetime.js';
29
+ export { clearRootInstructionCache, formatRootInstructionsInjection, loadRootInstructionDocs, loadRootInstructionsInjection, } from './root-instructions.js';
30
+ export type { RootInstructionDoc } from './root-instructions.js';
@@ -2,6 +2,7 @@
2
2
  * Harness Context 模块导出
3
3
  */
4
4
  export { DefaultContextEngine } from './default-context-engine.js';
5
+ export { formatTurnId, formatTurnStartContent, formatTurnEndContent, formatTurnContextXml, extractUserMessageText, stripTurnContextXml, isTurnStartContent, isTurnEndContent, parseTurnIdFromContent, parseTurnEnvelope, joinSlotXml, unwrapUserText, messageText, escapeUserMessageText, } from './turn-envelope.js';
5
6
  // ── Token 估算(跨域门面;浏览器侧可直连 token-estimator / token-constants) ──
6
7
  export { HeuristicTokenEstimator, estimateTextTokens, estimateLLMMessages } from './token-estimator.js';
7
8
  export { CHARS_PER_TOKEN, TOOL_RESULT_CHARS_PER_TOKEN, JSON_CHARS_PER_TOKEN, MESSAGE_OVERHEAD_TOKENS, SAFETY_MARGIN, IMAGE_TOKEN_ESTIMATE, AUDIO_TOKEN_ESTIMATE, VIDEO_TOKEN_ESTIMATE, SAMPLE_THRESHOLD, } from './token-constants.js';
@@ -15,3 +16,4 @@ export { createProviderSummarize, pickSummarizeProvider } from './summarize.js';
15
16
  export { createDefaultSystemPromptAssembler } from './system-prompt-assembler.js';
16
17
  export { loadConstitution, productConstitutionPath } from './constitution/load-constitution.js';
17
18
  export { formatRuntimeDatetimeInjection, formatRuntimeWorkspaceInjection, withRuntimeDatetimeInjection, withRuntimeEnvironmentInjection, } from './runtime-datetime.js';
19
+ export { clearRootInstructionCache, formatRootInstructionsInjection, loadRootInstructionDocs, loadRootInstructionsInjection, } from './root-instructions.js';
@@ -10,6 +10,8 @@ export declare const ALL_LAYER_IDS: readonly ContextLayerId[];
10
10
  export type LayerUiStatus = 'idle' | 'included' | 'empty' | 'dropped' | 'error' | 'unregistered';
11
11
  export interface LayerRuntimeView {
12
12
  id: ContextLayerId;
13
+ /** E8 装配位置(system/snapshot);同 id 双实例时主行=system、附加行=snapshot */
14
+ placement?: 'system' | 'snapshot';
13
15
  status: LayerUiStatus;
14
16
  included: boolean;
15
17
  tokens: number;
@@ -31,6 +33,8 @@ export interface ContextLayersSnapshot {
31
33
  systemBudget: number;
32
34
  structureReserve?: number;
33
35
  usedTokens: number;
36
+ /** 易变快照组实际使用 token(E8;无 snapshot 层时缺省) */
37
+ usedSnapshotTokens?: number;
34
38
  shares: Partial<Record<ContextLayerId, number>>;
35
39
  query?: string;
36
40
  /** 恒为契约层顺序,便于 UI 直接渲染 */
@@ -27,18 +27,41 @@ export const ALL_LAYER_IDS = [
27
27
  */
28
28
  export function buildContextLayersSnapshot(params) {
29
29
  const { manifest } = params;
30
- const entryById = new Map();
30
+ // E8:同 id 可有 system/snapshot 双条目(如 runtime 双实例)——按 id#placement 分键;
31
+ // 主行(七层表)优先取 system 份,snapshot 份追加为附加行,观测面不丢内容
32
+ const entryByKey = new Map();
31
33
  for (const entry of manifest.layers) {
32
- entryById.set(entry.id, entry);
34
+ const placement = entry.placement === 'snapshot' ? 'snapshot' : 'system';
35
+ entryByKey.set(`${entry.id}#${placement}`, entry);
33
36
  }
37
+ const dualSnapshotExtras = manifest.layers.filter((e) => e.placement === 'snapshot' && entryByKey.has(`${e.id}#system`));
34
38
  const enabled = params.enabledLayerIds ??
35
39
  manifest.layers.map((l) => l.id);
36
40
  const enabledSet = new Set(enabled);
41
+ const toView = (entry) => ({
42
+ id: entry.id,
43
+ placement: entry.placement === 'snapshot' ? 'snapshot' : 'system',
44
+ status: deriveLayerStatus(entry),
45
+ included: entry.included,
46
+ tokens: entry.tokens,
47
+ budgetTokens: entry.budgetTokens ?? 0,
48
+ priority: entry.priority,
49
+ order: entry.order,
50
+ droppable: entry.droppable ?? entry.id !== 'persona',
51
+ reason: entry.reason,
52
+ dropped: entry.dropped,
53
+ sources: entry.sources,
54
+ preview: entry.preview,
55
+ content: entry.content,
56
+ });
37
57
  const layers = ALL_LAYER_IDS.map((id) => {
38
- const entry = entryById.get(id);
58
+ const entry = entryByKey.get(`${id}#system`) ?? entryByKey.get(`${id}#snapshot`);
39
59
  const droppable = entry?.droppable ?? (id !== 'persona');
40
60
  const base = {
41
61
  id,
62
+ // 占位行(unregistered/idle)也带 placement:契约缺省 = query 择取层(memory/cognition/wisdom)
63
+ // 属快照组、其余属 system 组(layers.ts 各层构造 placement),否则 UI 分组会把它们错放进 System
64
+ placement: id === 'memory' || id === 'cognition' || id === 'wisdom' ? 'snapshot' : 'system',
42
65
  priority: entry?.priority ?? LAYER_PRIORITY[id],
43
66
  order: entry?.order ?? LAYER_ORDER[id],
44
67
  droppable,
@@ -62,28 +85,17 @@ export function buildContextLayersSnapshot(params) {
62
85
  budgetTokens: 0,
63
86
  };
64
87
  }
65
- return {
66
- id,
67
- status: deriveLayerStatus(entry),
68
- included: entry.included,
69
- tokens: entry.tokens,
70
- budgetTokens: entry.budgetTokens ?? 0,
71
- priority: entry.priority,
72
- order: entry.order,
73
- droppable: entry.droppable ?? droppable,
74
- reason: entry.reason,
75
- dropped: entry.dropped,
76
- sources: entry.sources,
77
- preview: entry.preview,
78
- content: entry.content,
79
- };
88
+ return toView(entry);
80
89
  });
90
+ // 双生 snapshot 条目(如 runtime 易变份)追加为附加行,观测面不丢内容
91
+ layers.push(...dualSnapshotExtras.map(toView));
81
92
  return {
82
93
  sessionId: manifest.sessionId,
83
94
  assembledAt: params.assembledAt,
84
95
  systemBudget: manifest.systemBudget,
85
96
  structureReserve: manifest.structureReserve,
86
97
  usedTokens: manifest.usedTokens,
98
+ usedSnapshotTokens: manifest.usedSnapshotTokens,
87
99
  shares: manifest.shares,
88
100
  query: params.query,
89
101
  layers,
@@ -75,6 +75,13 @@ export interface LayerContent {
75
75
  /** 溯源:文件路径、memory id、skill id 等 */
76
76
  sources?: string[];
77
77
  }
78
+ /**
79
+ * 装配位置(宪法 E8:缓存稳定前缀)
80
+ *
81
+ * - `system`(缺省):缓存稳定片段 → system prompt
82
+ * - `snapshot`:每 run 易变快照(Run 作用域 / query 相关择取)→ 消息尾部 content 侧
83
+ */
84
+ export type LayerPlacement = 'system' | 'snapshot';
78
85
  /**
79
86
  * ContextLayer — 单层内容提供者
80
87
  *
@@ -93,6 +100,14 @@ export interface ContextLayer {
93
100
  readonly droppable: boolean;
94
101
  /** system prompt 中的位置(小的在前) */
95
102
  readonly order: number;
103
+ /**
104
+ * 装配位置(宪法 E8)。缺省 `system`。
105
+ *
106
+ * 跨 run 可变的内容(query 相关检索择取、datetime、tasks/guidance 等)
107
+ * 必须标 `snapshot`:不得进入 system prompt 前缀,由调用方作为本轮
108
+ * 易变快照在消息尾部(content 侧)送达。
109
+ */
110
+ readonly placement?: LayerPlacement;
96
111
  /**
97
112
  * 变更指纹。与上次不同则强制重新 assemble;返回 null 表示每轮都重算。
98
113
  *
@@ -108,6 +123,8 @@ export interface ContextLayer {
108
123
  /** 装配清单(可观测,不进入模型输入) */
109
124
  export interface LayerManifestEntry {
110
125
  id: ContextLayerId;
126
+ /** 装配位置(E8);缺省 system */
127
+ placement?: LayerPlacement;
111
128
  included: boolean;
112
129
  tokens: number;
113
130
  /** 本层硬顶 token(仅 layerShares 配置过的层);无单层上限时缺省 */
@@ -134,8 +151,10 @@ export interface AssembleManifest {
134
151
  systemBudget: number;
135
152
  /** 结构预留(分隔符等) */
136
153
  structureReserve?: number;
137
- /** 实际使用的 token */
154
+ /** 实际使用的 token(system 组) */
138
155
  usedTokens: number;
156
+ /** 易变快照组实际使用的 token(E8;无 snapshot 层时缺省) */
157
+ usedSnapshotTokens?: number;
139
158
  /**
140
159
  * 显式配置的 layerShares 硬顶比例(未配置的层不出现)
141
160
  * 不再表示「启用层归一化后的全局配额」
@@ -178,6 +197,34 @@ export interface ContextAssembleParams {
178
197
  };
179
198
  signal?: AbortSignal;
180
199
  }
200
+ /**
201
+ * 判断消息 source 是否为引擎载体插槽(非用户发言)
202
+ *
203
+ * @param source - `message.metadata.source`
204
+ * @returns true 表示机器插槽(快照/grounding/附件/摘要)
205
+ */
206
+ export declare function isEngineCarrierSource(source: unknown): boolean;
207
+ /**
208
+ * 聊天回放隐藏谓词(D9 收敛的唯一真源)。
209
+ *
210
+ * observer `isHiddenFromChat` 与 gateway `ConversationAdapter.isHiddenSystemHistory`
211
+ * 均委托本函数——两份手抄清单曾漂移(observer 漏 3 个 source),收敛后不再各自维护。
212
+ * 语义(D8 拍板后):
213
+ * - 引擎载体插槽(knowledgeGrounding / sessionAttachment / runtimeSnapshot)与 turn 闭标:
214
+ * 只进 LLM 上下文,不进聊天回放;
215
+ * - `contextSummary` / `engineHint` / `runStopped`:**不隐藏**——渲染为系统提示条
216
+ * (SystemConversationItem),不冒充用户气泡。`runStopped` 是引擎主动终止 turn
217
+ * 的唯一可见凭证,隐藏它等于允许静默掐断任务;
218
+ * - 托管 systemPrompt 与无 metadata 的历史人格整段注入(长度+关键词启发式):隐藏。
219
+ *
220
+ * @param input - 消息的 role / metadata.source / 正文文本
221
+ * @returns true = 聊天回放跳过本条
222
+ */
223
+ export declare function isChatReplayHidden(input: {
224
+ role?: string;
225
+ source?: string;
226
+ text: string;
227
+ }): boolean;
181
228
  export interface ExtractLayerQueryOptions {
182
229
  /**
183
230
  * 额外主题线索(会话任务标题/当前步骤等)。
@@ -198,6 +245,7 @@ export declare function isThinLayerQuery(text: string): boolean;
198
245
  *
199
246
  * 默认取最近一条用户消息;若其为纯应答(「继续」「好」),回看最多 2 条更早的用户消息,
200
247
  * 并追加 `topicHints`(任务 focus)。独立新问题只用本句,不掺任务/上文,避免稀释主题。
248
+ * 引擎载体插槽(快照/grounding/附件/摘要)不算用户发言,一律跳过(防旧记忆择取混入 query)。
201
249
  *
202
250
  * @param messages - 会话消息(含本轮用户输入)
203
251
  * @param options - topicHints / maxChars
@@ -13,6 +13,7 @@
13
13
  * 各层业务实现(检索、打分、落盘)可在后续迭代中逐个替换,
14
14
  * 不改变本契约。
15
15
  */
16
+ import { extractUserMessageText } from './turn-envelope.js';
16
17
  /**
17
18
  * 默认层顺序(数字越小越靠 system prompt 前部)
18
19
  *
@@ -58,16 +59,79 @@ export const LAYER_DEFAULT_SHARE = {
58
59
  // ── 工具函数 ──
59
60
  /** 纯应答/推进语:本身无检索语义,需要回看上文 */
60
61
  const ACK_LAYER_QUERY_RE = /^(好|好的|好呀|好吧|嗯+|行|可以|继续|接着|然后呢?|下一步|收到|开始吧?|没问题|就这样|ok+|okay|yes|yeah|yep|go(\s+on)?|proceed)[\s!!。.~~]*$/i;
62
+ /**
63
+ * 引擎托管的 user 角色插槽(快照/grounding/附件/摘要)——不是用户发言。
64
+ * 检索 query 只采信真实用户文本;否则上轮快照(含旧记忆择取)会混入 query
65
+ * 造成择取自我强化漂移。
66
+ */
67
+ const ENGINE_CARRIER_SOURCES = new Set([
68
+ 'runtimeSnapshot',
69
+ 'knowledgeGrounding',
70
+ 'sessionAttachment',
71
+ 'contextSummary',
72
+ /** reliability/steer 注入(wrap-up / planning / noop / truncate notice 等)——非用户发言 */
73
+ 'engineHint',
74
+ /** turn 闭标(`<turn_end id/>`)——不是用户发言 */
75
+ 'turnEnd',
76
+ /**
77
+ * 引擎主动停止的收口说明(RunGuard / Budget 裁决)。
78
+ *
79
+ * 引擎有权终止 turn,就必须留下用户可见的原因;这条既不是用户发言,
80
+ * 也不进 LLM 上下文(见 DefaultContextEngine.buildLlmMessages)。
81
+ */
82
+ 'runStopped',
83
+ ]);
84
+ /**
85
+ * 判断消息 source 是否为引擎载体插槽(非用户发言)
86
+ *
87
+ * @param source - `message.metadata.source`
88
+ * @returns true 表示机器插槽(快照/grounding/附件/摘要)
89
+ */
90
+ export function isEngineCarrierSource(source) {
91
+ return ENGINE_CARRIER_SOURCES.has(source);
92
+ }
93
+ /**
94
+ * 聊天回放隐藏谓词(D9 收敛的唯一真源)。
95
+ *
96
+ * observer `isHiddenFromChat` 与 gateway `ConversationAdapter.isHiddenSystemHistory`
97
+ * 均委托本函数——两份手抄清单曾漂移(observer 漏 3 个 source),收敛后不再各自维护。
98
+ * 语义(D8 拍板后):
99
+ * - 引擎载体插槽(knowledgeGrounding / sessionAttachment / runtimeSnapshot)与 turn 闭标:
100
+ * 只进 LLM 上下文,不进聊天回放;
101
+ * - `contextSummary` / `engineHint` / `runStopped`:**不隐藏**——渲染为系统提示条
102
+ * (SystemConversationItem),不冒充用户气泡。`runStopped` 是引擎主动终止 turn
103
+ * 的唯一可见凭证,隐藏它等于允许静默掐断任务;
104
+ * - 托管 systemPrompt 与无 metadata 的历史人格整段注入(长度+关键词启发式):隐藏。
105
+ *
106
+ * @param input - 消息的 role / metadata.source / 正文文本
107
+ * @returns true = 聊天回放跳过本条
108
+ */
109
+ export function isChatReplayHidden(input) {
110
+ if (input.source === 'knowledgeGrounding' ||
111
+ input.source === 'sessionAttachment' ||
112
+ input.source === 'runtimeSnapshot' ||
113
+ input.source === 'turnEnd') {
114
+ return true;
115
+ }
116
+ if (input.role !== 'system')
117
+ return false;
118
+ if (input.source === 'systemPrompt')
119
+ return true;
120
+ return (input.text.length > 200 &&
121
+ /AGENTS\.md|Session Startup|Operating Instructions|Agent Persona/i.test(input.text));
122
+ }
61
123
  function userMessageText(m) {
124
+ let text = '';
62
125
  if (typeof m.content === 'string')
63
- return m.content;
64
- if (Array.isArray(m.content)) {
65
- return m.content
126
+ text = m.content;
127
+ else if (Array.isArray(m.content)) {
128
+ text = m.content
66
129
  .filter((b) => b.type === 'text')
67
130
  .map((b) => b.text)
68
131
  .join(' ');
69
132
  }
70
- return '';
133
+ // turn_start 信封:检索只采 <user_message>,不采 turn_context picks
134
+ return extractUserMessageText(text);
71
135
  }
72
136
  /**
73
137
  * 是否无检索语义的短应答(继续/好/可以…)
@@ -85,6 +149,7 @@ export function isThinLayerQuery(text) {
85
149
  *
86
150
  * 默认取最近一条用户消息;若其为纯应答(「继续」「好」),回看最多 2 条更早的用户消息,
87
151
  * 并追加 `topicHints`(任务 focus)。独立新问题只用本句,不掺任务/上文,避免稀释主题。
152
+ * 引擎载体插槽(快照/grounding/附件/摘要)不算用户发言,一律跳过(防旧记忆择取混入 query)。
88
153
  *
89
154
  * @param messages - 会话消息(含本轮用户输入)
90
155
  * @param options - topicHints / maxChars
@@ -96,6 +161,9 @@ export function extractLayerQuery(messages, options) {
96
161
  const m = messages[i];
97
162
  if (m.role !== 'user')
98
163
  continue;
164
+ const src = m.metadata?.source;
165
+ if (src && ENGINE_CARRIER_SOURCES.has(src))
166
+ continue;
99
167
  const text = userMessageText(m).trim();
100
168
  if (text)
101
169
  userTexts.push(text);
@@ -5,7 +5,7 @@
5
5
  * 不在本文件做相关性打分、embedding、衰减等智能逻辑。
6
6
  * 各层质量打磨后续替换 assemble 实现即可,契约不变。
7
7
  */
8
- import type { ContextLayer, ContextLayerId, LayerAssembleContext, LayerContent } from './layer-types.js';
8
+ import type { ContextLayer, ContextLayerId, LayerAssembleContext, LayerContent, LayerPlacement } from './layer-types.js';
9
9
  import type { MemoryStore, ConceptGraphStore } from '../memory/types.js';
10
10
  import type { KnowledgeCatalogProvider } from '../knowledge/catalog-types.js';
11
11
  declare abstract class BaseLayer implements ContextLayer {
@@ -14,7 +14,8 @@ declare abstract class BaseLayer implements ContextLayer {
14
14
  readonly defaultShare: number;
15
15
  readonly droppable: boolean;
16
16
  readonly order: number;
17
- constructor(id: ContextLayerId, overrides?: Partial<Pick<ContextLayer, 'priority' | 'defaultShare' | 'droppable' | 'order'>>);
17
+ readonly placement: LayerPlacement;
18
+ constructor(id: ContextLayerId, overrides?: Partial<Pick<ContextLayer, 'priority' | 'defaultShare' | 'droppable' | 'order' | 'placement'>>);
18
19
  abstract assemble(ctx: LayerAssembleContext): Promise<LayerContent | null>;
19
20
  protected content(text: string, extra?: Partial<LayerContent>): LayerContent | null;
20
21
  /**
@@ -64,6 +65,8 @@ export declare class RuntimeLayer extends BaseLayer {
64
65
  constructor(options: {
65
66
  getText: (ctx: LayerAssembleContext) => Promise<string> | string;
66
67
  order?: number;
68
+ /** E8:稳定锚点(workspace/root_instructions)留 system;易变注入(datetime/tasks)标 snapshot */
69
+ placement?: LayerPlacement;
67
70
  });
68
71
  assemble(ctx: LayerAssembleContext): Promise<LayerContent | null>;
69
72
  }
@@ -7,6 +7,7 @@
7
7
  */
8
8
  import { LAYER_DEFAULT_SHARE, LAYER_ORDER, LAYER_PRIORITY, } from './layer-types.js';
9
9
  import { formatWisdomBody } from '../memory/wisdom-formation.js';
10
+ import { formatMemoryTimeSuffix } from '../memory/time-format.js';
10
11
  // ── 基类 ──
11
12
  class BaseLayer {
12
13
  id;
@@ -14,12 +15,14 @@ class BaseLayer {
14
15
  defaultShare;
15
16
  droppable;
16
17
  order;
18
+ placement;
17
19
  constructor(id, overrides) {
18
20
  this.id = id;
19
21
  this.priority = overrides?.priority ?? LAYER_PRIORITY[id];
20
22
  this.defaultShare = overrides?.defaultShare ?? LAYER_DEFAULT_SHARE[id];
21
23
  this.droppable = overrides?.droppable ?? id !== 'persona';
22
24
  this.order = overrides?.order ?? LAYER_ORDER[id];
25
+ this.placement = overrides?.placement ?? 'system';
23
26
  }
24
27
  content(text, extra) {
25
28
  const trimmed = text.trim();
@@ -102,7 +105,7 @@ export class SkillLayer extends BaseLayer {
102
105
  export class RuntimeLayer extends BaseLayer {
103
106
  getText;
104
107
  constructor(options) {
105
- super('runtime', { order: options.order });
108
+ super('runtime', { order: options.order, placement: options.placement ?? 'system' });
106
109
  this.getText = options.getText;
107
110
  }
108
111
  async assemble(ctx) {
@@ -221,7 +224,7 @@ export class MemoryLayer extends BaseLayer {
221
224
  /** 向量相关性地板;默认见 retrieval-rank(与 search 工具相比更严) */
222
225
  minSimilarity;
223
226
  constructor(options) {
224
- super('memory', { order: options.order });
227
+ super('memory', { order: options.order, placement: 'snapshot' });
225
228
  this.store = options.store;
226
229
  this.limit = options.limit ?? 5;
227
230
  this.minSimilarity = options.minSimilarity;
@@ -242,7 +245,10 @@ export class MemoryLayer extends BaseLayer {
242
245
  if (injectable.length === 0)
243
246
  return null;
244
247
  const body = injectable
245
- .map((m) => m.futureUse ? `- [${m.type}] ${m.content} (when: ${m.futureUse})` : `- [${m.type}] ${m.content}`)
248
+ .map((m) => {
249
+ const when = m.futureUse ? ` (when: ${m.futureUse})` : '';
250
+ return `- [${m.type}] ${m.content}${when}${formatMemoryTimeSuffix(m)}`;
251
+ })
246
252
  .join('\n');
247
253
  const text = `# 相关记忆\n\n${body}`;
248
254
  const { text: truncated, dropped } = this.truncateToBudget(text, ctx.tokenBudget);
@@ -257,7 +263,7 @@ export class CognitionLayer extends BaseLayer {
257
263
  store;
258
264
  depth;
259
265
  constructor(options) {
260
- super('cognition', { order: options.order });
266
+ super('cognition', { order: options.order, placement: 'snapshot' });
261
267
  this.store = options.store;
262
268
  this.depth = options.depth ?? 2;
263
269
  }
@@ -325,7 +331,7 @@ export class WisdomLayer extends BaseLayer {
325
331
  coreMaxItems;
326
332
  scenarioMaxItems;
327
333
  constructor(options) {
328
- super('wisdom', { order: options.order });
334
+ super('wisdom', { order: options.order, placement: 'snapshot' });
329
335
  this.select = options.select;
330
336
  this.onInjected = options.onInjected;
331
337
  this.coreMaxItems = options.coreMaxItems;
@@ -9,7 +9,15 @@
9
9
  * 2. 调用 LLM 生成结构化摘要
10
10
  * 3. 摘要 token 预算:contentTokens × 0.20(上下限:2000 - 12000)
11
11
  */
12
+ import type { Message } from '@octopi-agent/core/types.js';
12
13
  import type { Compressor, CompressParams, CompressResult } from './types.js';
14
+ /**
15
+ * 工具调用账本(name+args 紧凑清单)——降级时的「做过什么」无损索引
16
+ *
17
+ * @param messages - 被降级丢弃的消息
18
+ * @returns 账本文本(可为空串)
19
+ */
20
+ export declare function buildToolCallLedger(messages: Message[]): string;
13
21
  export declare class LLMSummaryCompressor implements Compressor {
14
22
  /**
15
23
  * 压缩消息
@@ -29,10 +37,16 @@ export declare class LLMSummaryCompressor implements Compressor {
29
37
  private calculateSummaryBudget;
30
38
  /**
31
39
  * 格式化消息为 LLM 可读的上下文
40
+ *
41
+ * 归因保留(模型 2):多 agent 共线的摘要不得张冠李戴
42
+ * (惯例出处 session/history/port.ts renderMessage 的 role(agentId);此处大写仅排版差异)。
32
43
  */
33
44
  private formatMessagesForSummary;
34
45
  /**
35
- * 回退截断(当 LLM 摘要不可用时)
46
+ * 回退截断(当 LLM 摘要不可用时)——保守降级
47
+ *
48
+ * 作为 **middle 替换体**:账本说明 + 近尾若干条。
49
+ * 外层 head/tail 由调用方(applyProactiveCompact)拼接,此处不得重复携带。
36
50
  */
37
51
  private fallbackTruncate;
38
52
  }