@octopi-agent/engine 0.70.7 → 0.90.11

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 (390) 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 +81 -5
  6. package/dist/config-schema/context.d.ts +24 -5
  7. package/dist/config-schema/context.js +28 -1
  8. package/dist/config-schema/engine.d.ts +205 -13
  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 +93 -1
  12. package/dist/config-schema/models.d.ts +3 -3
  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 +13 -0
  18. package/dist/config-schema/shared.js +22 -0
  19. package/dist/config-schema/substrate.d.ts +2 -2
  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 +201 -8
  23. package/dist/config.js +105 -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 +50 -5
  31. package/dist/harness/agent/builder.js +189 -59
  32. package/dist/harness/agent/config-bridge.d.ts +33 -25
  33. package/dist/harness/agent/config-bridge.js +84 -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 +46 -0
  37. package/dist/harness/agent/tool-purpose.js +127 -0
  38. package/dist/harness/agent/wire-agent-builder.d.ts +133 -0
  39. package/dist/harness/agent/wire-agent-builder.js +370 -0
  40. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.d.ts +11 -1
  41. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +11 -1
  42. package/dist/harness/collaboration/autonomous-subsystem/loader.d.ts +13 -0
  43. package/dist/harness/collaboration/autonomous-subsystem/loader.js +16 -1
  44. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +8 -1
  45. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +17 -9
  46. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +12 -0
  47. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +19 -0
  48. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.d.ts +6 -0
  49. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.js +24 -7
  50. package/dist/harness/collaboration/autonomous-subsystem/think/executor.d.ts +5 -2
  51. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +11 -3
  52. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +1 -1
  53. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -1
  54. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.d.ts +7 -4
  55. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.js +8 -9
  56. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.d.ts +36 -10
  57. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +60 -7
  58. package/dist/harness/collaboration/delegation/child-run.d.ts +144 -0
  59. package/dist/harness/collaboration/delegation/child-run.js +241 -0
  60. package/dist/harness/collaboration/delegation/index.d.ts +26 -0
  61. package/dist/harness/collaboration/delegation/index.js +25 -0
  62. package/dist/harness/collaboration/delegation/notifier.d.ts +46 -0
  63. package/dist/harness/collaboration/delegation/notifier.js +84 -0
  64. package/dist/harness/collaboration/delegation/registry-types.d.ts +200 -0
  65. package/dist/harness/collaboration/delegation/registry-types.js +61 -0
  66. package/dist/harness/collaboration/delegation/registry.d.ts +110 -0
  67. package/dist/harness/collaboration/delegation/registry.js +220 -0
  68. package/dist/harness/collaboration/delegation/service.d.ts +249 -0
  69. package/dist/harness/collaboration/delegation/service.js +499 -0
  70. package/dist/harness/collaboration/delegation/store.d.ts +155 -0
  71. package/dist/harness/collaboration/delegation/store.js +271 -0
  72. package/dist/harness/collaboration/delegation/transport.d.ts +73 -0
  73. package/dist/harness/collaboration/delegation/transport.js +61 -0
  74. package/dist/harness/collaboration/delegation/types.d.ts +231 -0
  75. package/dist/harness/collaboration/delegation/types.js +70 -0
  76. package/dist/harness/collaboration/delegation/wiring.d.ts +111 -0
  77. package/dist/harness/collaboration/delegation/wiring.js +145 -0
  78. package/dist/harness/collaboration/orchestration/index.d.ts +11 -13
  79. package/dist/harness/collaboration/orchestration/index.js +11 -11
  80. package/dist/harness/context/assembler.d.ts +2 -2
  81. package/dist/harness/context/assembler.js +12 -7
  82. package/dist/harness/context/capabilities/compact/engine.js +80 -38
  83. package/dist/harness/context/capabilities/compact/types.d.ts +12 -1
  84. package/dist/harness/context/capabilities/summary/registry.js +10 -0
  85. package/dist/harness/context/constitution/default-agents.md +230 -228
  86. package/dist/harness/context/default-context-engine.d.ts +101 -23
  87. package/dist/harness/context/default-context-engine.js +483 -172
  88. package/dist/harness/context/hybrid-compressor.d.ts +3 -3
  89. package/dist/harness/context/hybrid-compressor.js +18 -23
  90. package/dist/harness/context/index.d.ts +5 -1
  91. package/dist/harness/context/index.js +2 -0
  92. package/dist/harness/context/layer-snapshot.d.ts +4 -0
  93. package/dist/harness/context/layer-snapshot.js +30 -18
  94. package/dist/harness/context/layer-types.d.ts +85 -1
  95. package/dist/harness/context/layer-types.js +110 -4
  96. package/dist/harness/context/layers.d.ts +5 -2
  97. package/dist/harness/context/layers.js +11 -5
  98. package/dist/harness/context/llm-summarizer.d.ts +15 -1
  99. package/dist/harness/context/llm-summarizer.js +107 -56
  100. package/dist/harness/context/message-selector.js +6 -2
  101. package/dist/harness/context/root-instructions.d.ts +72 -0
  102. package/dist/harness/context/root-instructions.js +227 -0
  103. package/dist/harness/context/runtime-datetime.d.ts +34 -7
  104. package/dist/harness/context/runtime-datetime.js +66 -10
  105. package/dist/harness/context/smart-router.d.ts +1 -1
  106. package/dist/harness/context/smart-router.js +1 -1
  107. package/dist/harness/context/system-prompt-assembler.d.ts +30 -0
  108. package/dist/harness/context/system-prompt-assembler.js +73 -6
  109. package/dist/harness/context/token-constants.d.ts +2 -2
  110. package/dist/harness/context/token-constants.js +2 -2
  111. package/dist/harness/context/token-estimate-fns.d.ts +1 -3
  112. package/dist/harness/context/token-estimate-fns.js +2 -4
  113. package/dist/harness/context/token-estimator.d.ts +1 -1
  114. package/dist/harness/context/token-estimator.js +14 -6
  115. package/dist/harness/context/tool-result-aging.d.ts +140 -0
  116. package/dist/harness/context/tool-result-aging.js +331 -0
  117. package/dist/harness/context/tool-result-body.d.ts +10 -0
  118. package/dist/harness/context/tool-result-body.js +27 -0
  119. package/dist/harness/context/turn-envelope.d.ts +123 -0
  120. package/dist/harness/context/turn-envelope.js +188 -0
  121. package/dist/harness/context/types.d.ts +35 -47
  122. package/dist/harness/extension/execution-environment/effect-policy.d.ts +258 -0
  123. package/dist/harness/extension/execution-environment/effect-policy.js +358 -0
  124. package/dist/harness/extension/execution-environment/index.d.ts +18 -2
  125. package/dist/harness/extension/execution-environment/index.js +11 -2
  126. package/dist/harness/extension/execution-environment/isolation.js +5 -1
  127. package/dist/harness/extension/execution-environment/memory-undo.d.ts +101 -0
  128. package/dist/harness/extension/execution-environment/memory-undo.js +192 -0
  129. package/dist/harness/extension/execution-environment/process-isolation.d.ts +84 -0
  130. package/dist/harness/extension/execution-environment/process-isolation.js +315 -0
  131. package/dist/harness/extension/execution-environment/resource-limits.d.ts +36 -0
  132. package/dist/harness/extension/execution-environment/resource-limits.js +84 -0
  133. package/dist/harness/extension/execution-environment/sandbox.d.ts +125 -4
  134. package/dist/harness/extension/execution-environment/sandbox.js +521 -51
  135. package/dist/harness/extension/execution-environment/shell-journal.d.ts +100 -0
  136. package/dist/harness/extension/execution-environment/shell-journal.js +299 -0
  137. package/dist/harness/extension/execution-environment/tool-capabilities.d.ts +45 -0
  138. package/dist/harness/extension/execution-environment/tool-capabilities.js +126 -0
  139. package/dist/harness/extension/execution-environment/types.d.ts +67 -39
  140. package/dist/harness/extension/execution-environment/types.js +2 -2
  141. package/dist/harness/extension/execution-environment/undo-log.d.ts +203 -0
  142. package/dist/harness/extension/execution-environment/undo-log.js +627 -0
  143. package/dist/harness/extension/execution-environment/undo-merge.d.ts +40 -0
  144. package/dist/harness/extension/execution-environment/undo-merge.js +167 -0
  145. package/dist/harness/extension/plugin-ecosystem/client-tools/index.d.ts +1 -1
  146. package/dist/harness/extension/plugin-ecosystem/client-tools/types.d.ts +9 -0
  147. package/dist/harness/extension/plugin-ecosystem/mcp/bridge.js +2 -0
  148. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +1 -6
  149. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +3 -8
  150. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -3
  151. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -3
  152. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +2 -10
  153. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +2 -9
  154. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -3
  155. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +1 -3
  156. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +2 -4
  157. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +4 -21
  158. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +3 -9
  159. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +4 -8
  160. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +1 -4
  161. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +1 -3
  162. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +1 -1
  163. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +1 -1
  164. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.d.ts +51 -0
  165. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +153 -0
  166. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +1 -0
  167. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +18 -3
  168. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +277 -81
  169. package/dist/harness/extension/plugin-ecosystem/tools/delegation.d.ts +31 -0
  170. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +291 -0
  171. package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +10 -2
  172. package/dist/harness/extension/plugin-ecosystem/tools/env-info.js +1 -0
  173. package/dist/harness/extension/plugin-ecosystem/tools/eol.d.ts +35 -0
  174. package/dist/harness/extension/plugin-ecosystem/tools/eol.js +43 -0
  175. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +40 -9
  176. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.d.ts +33 -0
  177. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +376 -0
  178. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +12 -2
  179. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +241 -70
  180. package/dist/harness/extension/plugin-ecosystem/tools/git-runner.d.ts +31 -0
  181. package/dist/harness/extension/plugin-ecosystem/tools/git-runner.js +104 -0
  182. package/dist/harness/extension/plugin-ecosystem/tools/git-status-snapshot.d.ts +111 -0
  183. package/dist/harness/extension/plugin-ecosystem/tools/git-status-snapshot.js +197 -0
  184. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.d.ts +27 -0
  185. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +463 -0
  186. package/dist/harness/extension/plugin-ecosystem/tools/http.d.ts +10 -6
  187. package/dist/harness/extension/plugin-ecosystem/tools/http.js +41 -47
  188. package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +6 -0
  189. package/dist/harness/extension/plugin-ecosystem/tools/index.js +4 -0
  190. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +4 -0
  191. package/dist/harness/extension/plugin-ecosystem/tools/memory.js +25 -1
  192. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.d.ts +13 -0
  193. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +391 -0
  194. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +51 -2
  195. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +151 -12
  196. package/dist/harness/extension/plugin-ecosystem/tools/session-history.js +2 -0
  197. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +10 -1
  198. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +35 -19
  199. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +8 -0
  200. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +5 -0
  201. package/dist/harness/extension/plugin-ecosystem/tools/web-search.js +1 -0
  202. package/dist/harness/governance/credentials/index.d.ts +1 -1
  203. package/dist/harness/governance/credentials/store.d.ts +16 -4
  204. package/dist/harness/governance/credentials/store.js +33 -6
  205. package/dist/harness/governance/credentials/types.d.ts +11 -0
  206. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +105 -0
  207. package/dist/harness/governance/human-in-the-loop/decision-cache.js +184 -0
  208. package/dist/harness/governance/human-in-the-loop/index.d.ts +5 -5
  209. package/dist/harness/governance/human-in-the-loop/index.js +3 -3
  210. package/dist/harness/governance/human-in-the-loop/types.d.ts +7 -62
  211. package/dist/harness/governance/human-in-the-loop/types.js +6 -2
  212. package/dist/harness/governance/security/capability-enforcer.d.ts +9 -1
  213. package/dist/harness/governance/security/capability-enforcer.js +31 -8
  214. package/dist/harness/governance/security/degradation.js +5 -7
  215. package/dist/harness/governance/security/risk-evaluator.d.ts +1 -1
  216. package/dist/harness/governance/security/risk-evaluator.js +4 -82
  217. package/dist/harness/governance/security/temp-path.d.ts +41 -0
  218. package/dist/harness/governance/security/temp-path.js +117 -0
  219. package/dist/harness/governance/session-acl/index.d.ts +1 -0
  220. package/dist/harness/governance/session-acl/index.js +1 -0
  221. package/dist/harness/governance/session-acl/rights.d.ts +12 -0
  222. package/dist/harness/governance/session-acl/rights.js +89 -7
  223. package/dist/harness/governance/session-acl/seed-roles.js +9 -1
  224. package/dist/harness/governance/session-acl/service.js +21 -29
  225. package/dist/harness/governance/session-acl/tool-rights.d.ts +81 -0
  226. package/dist/harness/governance/session-acl/tool-rights.js +238 -0
  227. package/dist/harness/governance/session-acl/types.d.ts +22 -0
  228. package/dist/harness/index.d.ts +16 -12
  229. package/dist/harness/index.js +10 -6
  230. package/dist/harness/knowledge/file-identity.d.ts +8 -0
  231. package/dist/harness/knowledge/file-identity.js +26 -1
  232. package/dist/harness/knowledge/file-index-store.js +11 -11
  233. package/dist/harness/knowledge/grounding.d.ts +2 -1
  234. package/dist/harness/knowledge/grounding.js +8 -5
  235. package/dist/harness/knowledge/index-store.d.ts +31 -4
  236. package/dist/harness/knowledge/index-store.js +121 -39
  237. package/dist/harness/knowledge/index.d.ts +2 -2
  238. package/dist/harness/knowledge/index.js +1 -1
  239. package/dist/harness/knowledge/ingest.d.ts +115 -115
  240. package/dist/harness/knowledge/ingest.js +154 -151
  241. package/dist/harness/knowledge/job-control-state.js +4 -4
  242. package/dist/harness/knowledge/job-control.js +11 -11
  243. package/dist/harness/knowledge/knowledge-serve-child.js +1 -1
  244. package/dist/harness/knowledge/membership-store.js +11 -11
  245. package/dist/harness/knowledge/network-guard.d.ts +61 -4
  246. package/dist/harness/knowledge/network-guard.js +390 -113
  247. package/dist/harness/knowledge/purge.js +4 -1
  248. package/dist/harness/knowledge/query-service.js +3 -3
  249. package/dist/harness/knowledge/writer-service.d.ts +2 -0
  250. package/dist/harness/knowledge/writer-service.js +14 -13
  251. package/dist/harness/memory/backfill-coverage.js +3 -1
  252. package/dist/harness/memory/backfill-trigger.d.ts +2 -2
  253. package/dist/harness/memory/backfill-trigger.js +4 -4
  254. package/dist/harness/memory/index.d.ts +1 -0
  255. package/dist/harness/memory/index.js +1 -0
  256. package/dist/harness/memory/sqlite/agent-db.js +2 -0
  257. package/dist/harness/memory/sqlite/memory-store.d.ts +1 -0
  258. package/dist/harness/memory/sqlite/memory-store.js +14 -4
  259. package/dist/harness/memory/sqlite/wisdom-store.js +9 -9
  260. package/dist/harness/memory/store.d.ts +1 -0
  261. package/dist/harness/memory/store.js +3 -0
  262. package/dist/harness/memory/time-format.d.ts +28 -0
  263. package/dist/harness/memory/time-format.js +52 -0
  264. package/dist/harness/memory/types.d.ts +12 -0
  265. package/dist/harness/observability/observer/hub.js +53 -2
  266. package/dist/harness/observability/observer/index.d.ts +2 -2
  267. package/dist/harness/observability/observer/index.js +1 -1
  268. package/dist/harness/observability/observer/types.d.ts +80 -0
  269. package/dist/harness/observability/observer/types.js +118 -9
  270. package/dist/harness/run/agent/agent.d.ts +18 -0
  271. package/dist/harness/run/agent/agent.js +26 -0
  272. package/dist/harness/run/concurrency/tool-loop-detection-core.d.ts +1 -1
  273. package/dist/harness/run/concurrency/tool-loop-detection-core.js +1 -1
  274. package/dist/harness/run/reliability/harness-events.d.ts +4 -0
  275. package/dist/harness/run/reliability/run-agent.js +110 -18
  276. package/dist/harness/run/reliability/run-metrics-collector.d.ts +28 -2
  277. package/dist/harness/run/reliability/run-metrics-collector.js +92 -2
  278. package/dist/harness/run/run-guard/default-run-guard.d.ts +0 -5
  279. package/dist/harness/run/run-guard/default-run-guard.js +104 -44
  280. package/dist/harness/run/run-scope.d.ts +52 -0
  281. package/dist/harness/run/runner.d.ts +117 -16
  282. package/dist/harness/run/runner.js +668 -157
  283. package/dist/harness/session/attachments/llm-intent.js +17 -17
  284. package/dist/harness/session/history/port.js +16 -5
  285. package/dist/harness/session/in-memory-store.d.ts +6 -0
  286. package/dist/harness/session/in-memory-store.js +55 -3
  287. package/dist/harness/session/schedules/index.d.ts +10 -0
  288. package/dist/harness/session/schedules/index.js +10 -0
  289. package/dist/harness/session/schedules/render.d.ts +13 -0
  290. package/dist/harness/session/schedules/render.js +63 -0
  291. package/dist/harness/session/schedules/service.d.ts +179 -0
  292. package/dist/harness/session/schedules/service.js +695 -0
  293. package/dist/harness/session/schedules/store.d.ts +119 -0
  294. package/dist/harness/session/schedules/store.js +323 -0
  295. package/dist/harness/session/schedules/tools.d.ts +39 -0
  296. package/dist/harness/session/schedules/tools.js +442 -0
  297. package/dist/harness/session/schedules/types.d.ts +104 -0
  298. package/dist/harness/session/schedules/types.js +97 -0
  299. package/dist/harness/session/tasks/tools.js +22 -0
  300. package/dist/harness/session/title.js +25 -9
  301. package/dist/harness/session/types.d.ts +35 -0
  302. package/dist/harness/shared/events/agent-event-map.d.ts +39 -0
  303. package/dist/harness/shared/events/agent-event-map.js +2 -0
  304. package/dist/harness/shared/types/agent-definition.d.ts +23 -0
  305. package/dist/index.d.ts +25 -9
  306. package/dist/index.js +11 -2
  307. package/dist/integration/observability/run-telemetry.d.ts +8 -0
  308. package/dist/integration/observability/run-telemetry.js +31 -8
  309. package/dist/integration/observability/trace-collector.js +26 -4
  310. package/dist/integration/observability/trace-events.d.ts +1 -0
  311. package/dist/integration/observability/trace-events.js +2 -0
  312. package/dist/integration/observability/trace-logger.js +27 -17
  313. package/dist/integration/providers/anthropic.d.ts +10 -0
  314. package/dist/integration/providers/anthropic.js +44 -1
  315. package/dist/integration/providers/openai.d.ts +10 -0
  316. package/dist/integration/providers/openai.js +58 -2
  317. package/dist/integration/providers/wire-dump-diff.d.ts +191 -0
  318. package/dist/integration/providers/wire-dump-diff.js +351 -0
  319. package/dist/integration/providers/wire-dump.d.ts +178 -0
  320. package/dist/integration/providers/wire-dump.js +396 -0
  321. package/dist/integration/storage/jsonl.d.ts +29 -0
  322. package/dist/integration/storage/jsonl.js +243 -41
  323. package/dist/integration/storage/session-index.js +63 -8
  324. package/dist/paths.d.ts +19 -0
  325. package/dist/paths.js +38 -1
  326. package/dist/subsystems/cognition-steward/conceptualize/SUBSYSTEM.md +43 -43
  327. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +50 -50
  328. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +6 -6
  329. package/dist/subsystems/cognition-steward/consolidate/config.yaml +54 -54
  330. package/dist/subsystems/memory-steward/backfill/handler.js +9 -0
  331. package/dist/subsystems/safety-guard/config.yaml +3 -1
  332. package/dist/subsystems/wisdom-steward/evaluate/config.yaml +50 -50
  333. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +42 -42
  334. package/dist/subsystems/wisdom-steward/formation/config.yaml +54 -54
  335. package/dist/subsystems/wisdom-steward/govern/config.yaml +55 -55
  336. package/package.json +115 -115
  337. package/dist/harness/collaboration/multi-agent/agent-registry-types.d.ts +0 -144
  338. package/dist/harness/collaboration/multi-agent/agent-registry-types.js +0 -25
  339. package/dist/harness/collaboration/multi-agent/index.d.ts +0 -17
  340. package/dist/harness/collaboration/multi-agent/index.js +0 -15
  341. package/dist/harness/collaboration/multi-agent/process.d.ts +0 -167
  342. package/dist/harness/collaboration/multi-agent/process.js +0 -256
  343. package/dist/harness/collaboration/multi-agent/registry.d.ts +0 -36
  344. package/dist/harness/collaboration/multi-agent/registry.js +0 -137
  345. package/dist/harness/collaboration/multi-agent/swarm.d.ts +0 -135
  346. package/dist/harness/collaboration/multi-agent/swarm.js +0 -317
  347. package/dist/harness/collaboration/multi-agent/types.d.ts +0 -66
  348. package/dist/harness/collaboration/multi-agent/types.js +0 -15
  349. package/dist/harness/collaboration/orchestration/async-task-store.d.ts +0 -107
  350. package/dist/harness/collaboration/orchestration/async-task-store.js +0 -12
  351. package/dist/harness/collaboration/orchestration/async-task.d.ts +0 -156
  352. package/dist/harness/collaboration/orchestration/async-task.js +0 -359
  353. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.d.ts +0 -47
  354. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.js +0 -61
  355. package/dist/harness/collaboration/orchestration/planner/index.d.ts +0 -9
  356. package/dist/harness/collaboration/orchestration/planner/index.js +0 -6
  357. package/dist/harness/collaboration/orchestration/planner/llm-planner.d.ts +0 -54
  358. package/dist/harness/collaboration/orchestration/planner/llm-planner.js +0 -167
  359. package/dist/harness/collaboration/orchestration/planner/rule-planner.d.ts +0 -85
  360. package/dist/harness/collaboration/orchestration/planner/rule-planner.js +0 -175
  361. package/dist/harness/collaboration/orchestration/quality/classifier.d.ts +0 -21
  362. package/dist/harness/collaboration/orchestration/quality/classifier.js +0 -235
  363. package/dist/harness/collaboration/orchestration/quality/gate.d.ts +0 -29
  364. package/dist/harness/collaboration/orchestration/quality/gate.js +0 -409
  365. package/dist/harness/collaboration/orchestration/quality/index.d.ts +0 -9
  366. package/dist/harness/collaboration/orchestration/quality/index.js +0 -8
  367. package/dist/harness/collaboration/orchestration/quality/types.d.ts +0 -159
  368. package/dist/harness/collaboration/orchestration/quality/types.js +0 -33
  369. package/dist/harness/collaboration/orchestration/scheduler/index.d.ts +0 -5
  370. package/dist/harness/collaboration/orchestration/scheduler/index.js +0 -4
  371. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.d.ts +0 -143
  372. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.js +0 -297
  373. package/dist/harness/collaboration/orchestration/strategy/classifier.d.ts +0 -12
  374. package/dist/harness/collaboration/orchestration/strategy/classifier.js +0 -81
  375. package/dist/harness/collaboration/orchestration/strategy/index.d.ts +0 -3
  376. package/dist/harness/collaboration/orchestration/strategy/index.js +0 -2
  377. package/dist/harness/collaboration/orchestration/strategy/router.d.ts +0 -28
  378. package/dist/harness/collaboration/orchestration/strategy/router.js +0 -105
  379. package/dist/harness/collaboration/orchestration/strategy/types.d.ts +0 -49
  380. package/dist/harness/collaboration/orchestration/strategy/types.js +0 -4
  381. package/dist/harness/collaboration/orchestration/workflow/engine.d.ts +0 -86
  382. package/dist/harness/collaboration/orchestration/workflow/engine.js +0 -298
  383. package/dist/harness/collaboration/orchestration/workflow/index.d.ts +0 -9
  384. package/dist/harness/collaboration/orchestration/workflow/index.js +0 -7
  385. package/dist/harness/collaboration/orchestration/workflow/types.d.ts +0 -143
  386. package/dist/harness/collaboration/orchestration/workflow/types.js +0 -7
  387. package/dist/harness/governance/human-in-the-loop/approval-manager.d.ts +0 -32
  388. package/dist/harness/governance/human-in-the-loop/approval-manager.js +0 -93
  389. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.d.ts +0 -0
  390. /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,70 @@ 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
+ * 轮次锚点判定(turn 边界类消费方:isMidTurn / compact / tool-result-aging)。
209
+ *
210
+ * 能开轮的输入 = 真实用户发言 + `source:'runtime'` 的 activation 唤醒输入
211
+ * (compiler 打标、确实开轮且是该 turn 的输入);引擎载体插槽与 schedule
212
+ * notify 便签(`delivery:'notify'`)不开轮。2026-10-24 拍板拆分:wake
213
+ * 「开轮但不是人话」——两类消费方各取所需,一个布尔不再混答两个问题。
214
+ *
215
+ * @param msg - 消息(结构化入参,接受 Message 及其裁剪形态)
216
+ * @returns true = 该消息能作为 turn 边界锚点
217
+ */
218
+ export declare function isTurnAnchor(msg: {
219
+ role?: string;
220
+ metadata?: {
221
+ source?: unknown;
222
+ delivery?: unknown;
223
+ };
224
+ }): boolean;
225
+ /**
226
+ * 人话判定(人类文本类消费方:title / grounding.latestUserText / backfill userTurns)。
227
+ *
228
+ * 只有真实用户创作的文本才是「人话」:引擎载体插槽、schedule notify 便签、
229
+ * `source:'runtime'` 的 activation 唤醒输入(机器提示词)都会污染标题与 grounding 锚点。
230
+ * 注意本谓词**不看 agentId**:isMidTurn 另有「无 agentId 归因」的收紧
231
+ * (多 agent 共线语义),在其调用处叠加。
232
+ *
233
+ * @param msg - 消息(结构化入参,接受 Message 及其裁剪形态)
234
+ * @returns true = 真实用户创作的发言
235
+ */
236
+ export declare function isHumanSpeech(msg: {
237
+ role?: string;
238
+ metadata?: {
239
+ source?: unknown;
240
+ delivery?: unknown;
241
+ };
242
+ }): boolean;
243
+ /**
244
+ * 聊天回放隐藏谓词(D9 收敛的唯一真源)。
245
+ *
246
+ * observer `isHiddenFromChat` 与 gateway `ConversationAdapter.isHiddenSystemHistory`
247
+ * 均委托本函数——两份手抄清单曾漂移(observer 漏 3 个 source),收敛后不再各自维护。
248
+ * 语义(D8 拍板后):
249
+ * - 引擎载体插槽(knowledgeGrounding / sessionAttachment / runtimeSnapshot)与 turn 闭标:
250
+ * 只进 LLM 上下文,不进聊天回放;
251
+ * - `contextSummary` / `engineHint` / `runStopped`:**不隐藏**——渲染为系统提示条
252
+ * (SystemConversationItem),不冒充用户气泡。`runStopped` 是引擎主动终止 turn
253
+ * 的唯一可见凭证,隐藏它等于允许静默掐断任务;
254
+ * - 托管 systemPrompt 与无 metadata 的历史人格整段注入(长度+关键词启发式):隐藏。
255
+ *
256
+ * @param input - 消息的 role / metadata.source / 正文文本
257
+ * @returns true = 聊天回放跳过本条
258
+ */
259
+ export declare function isChatReplayHidden(input: {
260
+ role?: string;
261
+ source?: string;
262
+ text: string;
263
+ }): boolean;
181
264
  export interface ExtractLayerQueryOptions {
182
265
  /**
183
266
  * 额外主题线索(会话任务标题/当前步骤等)。
@@ -198,6 +281,7 @@ export declare function isThinLayerQuery(text: string): boolean;
198
281
  *
199
282
  * 默认取最近一条用户消息;若其为纯应答(「继续」「好」),回看最多 2 条更早的用户消息,
200
283
  * 并追加 `topicHints`(任务 focus)。独立新问题只用本句,不掺任务/上文,避免稀释主题。
284
+ * 引擎载体插槽(快照/grounding/附件/摘要)不算用户发言,一律跳过(防旧记忆择取混入 query)。
201
285
  *
202
286
  * @param messages - 会话消息(含本轮用户输入)
203
287
  * @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,117 @@ 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
+ * 轮次锚点判定(turn 边界类消费方:isMidTurn / compact / tool-result-aging)。
95
+ *
96
+ * 能开轮的输入 = 真实用户发言 + `source:'runtime'` 的 activation 唤醒输入
97
+ * (compiler 打标、确实开轮且是该 turn 的输入);引擎载体插槽与 schedule
98
+ * notify 便签(`delivery:'notify'`)不开轮。2026-10-24 拍板拆分:wake
99
+ * 「开轮但不是人话」——两类消费方各取所需,一个布尔不再混答两个问题。
100
+ *
101
+ * @param msg - 消息(结构化入参,接受 Message 及其裁剪形态)
102
+ * @returns true = 该消息能作为 turn 边界锚点
103
+ */
104
+ export function isTurnAnchor(msg) {
105
+ if (msg.role !== 'user')
106
+ return false;
107
+ if (isEngineCarrierSource(msg.metadata?.source))
108
+ return false;
109
+ // schedule notify 是机器便签(producer 见 gateway setNotify),不是用户输入
110
+ if (msg.metadata?.delivery === 'notify')
111
+ return false;
112
+ return true;
113
+ }
114
+ /**
115
+ * 人话判定(人类文本类消费方:title / grounding.latestUserText / backfill userTurns)。
116
+ *
117
+ * 只有真实用户创作的文本才是「人话」:引擎载体插槽、schedule notify 便签、
118
+ * `source:'runtime'` 的 activation 唤醒输入(机器提示词)都会污染标题与 grounding 锚点。
119
+ * 注意本谓词**不看 agentId**:isMidTurn 另有「无 agentId 归因」的收紧
120
+ * (多 agent 共线语义),在其调用处叠加。
121
+ *
122
+ * @param msg - 消息(结构化入参,接受 Message 及其裁剪形态)
123
+ * @returns true = 真实用户创作的发言
124
+ */
125
+ export function isHumanSpeech(msg) {
126
+ if (!isTurnAnchor(msg))
127
+ return false;
128
+ // wake 是机器开轮输入:能锚定 turn,但不是人话
129
+ return msg.metadata?.source !== 'runtime';
130
+ }
131
+ /**
132
+ * 聊天回放隐藏谓词(D9 收敛的唯一真源)。
133
+ *
134
+ * observer `isHiddenFromChat` 与 gateway `ConversationAdapter.isHiddenSystemHistory`
135
+ * 均委托本函数——两份手抄清单曾漂移(observer 漏 3 个 source),收敛后不再各自维护。
136
+ * 语义(D8 拍板后):
137
+ * - 引擎载体插槽(knowledgeGrounding / sessionAttachment / runtimeSnapshot)与 turn 闭标:
138
+ * 只进 LLM 上下文,不进聊天回放;
139
+ * - `contextSummary` / `engineHint` / `runStopped`:**不隐藏**——渲染为系统提示条
140
+ * (SystemConversationItem),不冒充用户气泡。`runStopped` 是引擎主动终止 turn
141
+ * 的唯一可见凭证,隐藏它等于允许静默掐断任务;
142
+ * - 托管 systemPrompt 与无 metadata 的历史人格整段注入(长度+关键词启发式):隐藏。
143
+ *
144
+ * @param input - 消息的 role / metadata.source / 正文文本
145
+ * @returns true = 聊天回放跳过本条
146
+ */
147
+ export function isChatReplayHidden(input) {
148
+ if (input.source === 'knowledgeGrounding' ||
149
+ input.source === 'sessionAttachment' ||
150
+ input.source === 'runtimeSnapshot' ||
151
+ input.source === 'turnEnd') {
152
+ return true;
153
+ }
154
+ if (input.role !== 'system')
155
+ return false;
156
+ if (input.source === 'systemPrompt')
157
+ return true;
158
+ return (input.text.length > 200 &&
159
+ /AGENTS\.md|Session Startup|Operating Instructions|Agent Persona/i.test(input.text));
160
+ }
61
161
  function userMessageText(m) {
162
+ let text = '';
62
163
  if (typeof m.content === 'string')
63
- return m.content;
64
- if (Array.isArray(m.content)) {
65
- return m.content
164
+ text = m.content;
165
+ else if (Array.isArray(m.content)) {
166
+ text = m.content
66
167
  .filter((b) => b.type === 'text')
67
168
  .map((b) => b.text)
68
169
  .join(' ');
69
170
  }
70
- return '';
171
+ // turn_start 信封:检索只采 <user_message>,不采 turn_context picks
172
+ return extractUserMessageText(text);
71
173
  }
72
174
  /**
73
175
  * 是否无检索语义的短应答(继续/好/可以…)
@@ -85,6 +187,7 @@ export function isThinLayerQuery(text) {
85
187
  *
86
188
  * 默认取最近一条用户消息;若其为纯应答(「继续」「好」),回看最多 2 条更早的用户消息,
87
189
  * 并追加 `topicHints`(任务 focus)。独立新问题只用本句,不掺任务/上文,避免稀释主题。
190
+ * 引擎载体插槽(快照/grounding/附件/摘要)不算用户发言,一律跳过(防旧记忆择取混入 query)。
88
191
  *
89
192
  * @param messages - 会话消息(含本轮用户输入)
90
193
  * @param options - topicHints / maxChars
@@ -96,6 +199,9 @@ export function extractLayerQuery(messages, options) {
96
199
  const m = messages[i];
97
200
  if (m.role !== 'user')
98
201
  continue;
202
+ const src = m.metadata?.source;
203
+ if (src && ENGINE_CARRIER_SOURCES.has(src))
204
+ continue;
99
205
  const text = userMessageText(m).trim();
100
206
  if (text)
101
207
  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
  }