@octopi-agent/engine 0.65.0 → 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 (421) 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 +285 -9
  9. package/dist/config-schema/engine.js +35 -3
  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 +87 -1
  20. package/dist/config-schema/substrate.js +114 -0
  21. package/dist/config-schema/subsystems.d.ts +1 -1
  22. package/dist/config-schema/subsystems.js +2 -1
  23. package/dist/config.d.ts +249 -7
  24. package/dist/config.js +113 -3
  25. package/dist/harness/activation/compiler.js +3 -0
  26. package/dist/harness/activation/runtime.d.ts +7 -0
  27. package/dist/harness/activation/runtime.js +60 -2
  28. package/dist/harness/activation/sources/agent-signal.d.ts +11 -0
  29. package/dist/harness/activation/sources/agent-signal.js +33 -0
  30. package/dist/harness/activation/types.d.ts +6 -1
  31. package/dist/harness/agent/builder.d.ts +48 -4
  32. package/dist/harness/agent/builder.js +206 -55
  33. package/dist/harness/agent/config-bridge.d.ts +33 -25
  34. package/dist/harness/agent/config-bridge.js +83 -280
  35. package/dist/harness/agent/index.d.ts +3 -1
  36. package/dist/harness/agent/index.js +2 -1
  37. package/dist/harness/agent/tool-purpose.d.ts +38 -0
  38. package/dist/harness/agent/tool-purpose.js +118 -0
  39. package/dist/harness/agent/wire-agent-builder.d.ts +133 -0
  40. package/dist/harness/agent/wire-agent-builder.js +363 -0
  41. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +4 -1
  42. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +14 -8
  43. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +12 -0
  44. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +19 -0
  45. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.d.ts +6 -0
  46. package/dist/harness/collaboration/autonomous-subsystem/sense/session-lifecycle-bridge.js +24 -7
  47. package/dist/harness/collaboration/autonomous-subsystem/think/executor.d.ts +5 -2
  48. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +11 -3
  49. package/dist/harness/collaboration/autonomous-subsystem/think/index.d.ts +1 -1
  50. package/dist/harness/collaboration/autonomous-subsystem/think/index.js +1 -1
  51. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.d.ts +7 -4
  52. package/dist/harness/collaboration/autonomous-subsystem/think/llm-port.js +8 -9
  53. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.d.ts +36 -10
  54. package/dist/harness/collaboration/autonomous-subsystem/think/model-resolver.js +60 -7
  55. package/dist/harness/collaboration/delegation/child-run.d.ts +144 -0
  56. package/dist/harness/collaboration/delegation/child-run.js +241 -0
  57. package/dist/harness/collaboration/delegation/index.d.ts +26 -0
  58. package/dist/harness/collaboration/delegation/index.js +25 -0
  59. package/dist/harness/collaboration/delegation/notifier.d.ts +46 -0
  60. package/dist/harness/collaboration/delegation/notifier.js +84 -0
  61. package/dist/harness/collaboration/delegation/registry-types.d.ts +200 -0
  62. package/dist/harness/collaboration/delegation/registry-types.js +61 -0
  63. package/dist/harness/collaboration/delegation/registry.d.ts +110 -0
  64. package/dist/harness/collaboration/delegation/registry.js +220 -0
  65. package/dist/harness/collaboration/delegation/service.d.ts +249 -0
  66. package/dist/harness/collaboration/delegation/service.js +499 -0
  67. package/dist/harness/collaboration/delegation/store.d.ts +155 -0
  68. package/dist/harness/collaboration/delegation/store.js +271 -0
  69. package/dist/harness/collaboration/delegation/transport.d.ts +73 -0
  70. package/dist/harness/collaboration/delegation/transport.js +61 -0
  71. package/dist/harness/collaboration/delegation/types.d.ts +231 -0
  72. package/dist/harness/collaboration/delegation/types.js +70 -0
  73. package/dist/harness/collaboration/delegation/wiring.d.ts +111 -0
  74. package/dist/harness/collaboration/delegation/wiring.js +145 -0
  75. package/dist/harness/collaboration/orchestration/index.d.ts +11 -13
  76. package/dist/harness/collaboration/orchestration/index.js +11 -11
  77. package/dist/harness/context/assembler.d.ts +2 -2
  78. package/dist/harness/context/assembler.js +12 -7
  79. package/dist/harness/context/capabilities/compact/engine.js +80 -38
  80. package/dist/harness/context/capabilities/compact/types.d.ts +12 -1
  81. package/dist/harness/context/capabilities/summary/gate.js +2 -2
  82. package/dist/harness/context/capabilities/summary/policies.js +5 -5
  83. package/dist/harness/context/capabilities/summary/registry.js +39 -24
  84. package/dist/harness/context/constitution/default-agents.md +230 -228
  85. package/dist/harness/context/default-context-engine.d.ts +101 -23
  86. package/dist/harness/context/default-context-engine.js +483 -172
  87. package/dist/harness/context/hybrid-compressor.d.ts +3 -3
  88. package/dist/harness/context/hybrid-compressor.js +18 -23
  89. package/dist/harness/context/index.d.ts +5 -1
  90. package/dist/harness/context/index.js +2 -0
  91. package/dist/harness/context/layer-health.js +3 -2
  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 +49 -1
  95. package/dist/harness/context/layer-types.js +72 -4
  96. package/dist/harness/context/layers.d.ts +32 -15
  97. package/dist/harness/context/layers.js +87 -71
  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 +33 -0
  108. package/dist/harness/context/system-prompt-assembler.js +78 -7
  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 +248 -0
  123. package/dist/harness/extension/execution-environment/effect-policy.js +334 -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/memory-undo.d.ts +101 -0
  127. package/dist/harness/extension/execution-environment/memory-undo.js +192 -0
  128. package/dist/harness/extension/execution-environment/process-isolation.d.ts +84 -0
  129. package/dist/harness/extension/execution-environment/process-isolation.js +315 -0
  130. package/dist/harness/extension/execution-environment/resource-limits.d.ts +36 -0
  131. package/dist/harness/extension/execution-environment/resource-limits.js +84 -0
  132. package/dist/harness/extension/execution-environment/sandbox.d.ts +125 -4
  133. package/dist/harness/extension/execution-environment/sandbox.js +493 -51
  134. package/dist/harness/extension/execution-environment/shell-journal.d.ts +100 -0
  135. package/dist/harness/extension/execution-environment/shell-journal.js +299 -0
  136. package/dist/harness/extension/execution-environment/tool-capabilities.d.ts +45 -0
  137. package/dist/harness/extension/execution-environment/tool-capabilities.js +126 -0
  138. package/dist/harness/extension/execution-environment/types.d.ts +67 -39
  139. package/dist/harness/extension/execution-environment/types.js +2 -2
  140. package/dist/harness/extension/execution-environment/undo-log.d.ts +203 -0
  141. package/dist/harness/extension/execution-environment/undo-log.js +627 -0
  142. package/dist/harness/extension/execution-environment/undo-merge.d.ts +40 -0
  143. package/dist/harness/extension/execution-environment/undo-merge.js +167 -0
  144. package/dist/harness/extension/plugin-ecosystem/client-tools/index.d.ts +4 -0
  145. package/dist/harness/extension/plugin-ecosystem/client-tools/index.js +3 -0
  146. package/dist/harness/extension/plugin-ecosystem/client-tools/invoke.d.ts +56 -0
  147. package/dist/harness/extension/plugin-ecosystem/client-tools/invoke.js +281 -0
  148. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.d.ts +98 -0
  149. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.js +250 -0
  150. package/dist/harness/extension/plugin-ecosystem/client-tools/stream.d.ts +124 -0
  151. package/dist/harness/extension/plugin-ecosystem/client-tools/stream.js +372 -0
  152. package/dist/harness/extension/plugin-ecosystem/client-tools/types.d.ts +118 -0
  153. package/dist/harness/extension/plugin-ecosystem/client-tools/types.js +8 -0
  154. package/dist/harness/extension/plugin-ecosystem/index.d.ts +1 -0
  155. package/dist/harness/extension/plugin-ecosystem/index.js +1 -0
  156. package/dist/harness/extension/plugin-ecosystem/mcp/bridge.js +2 -0
  157. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +1 -6
  158. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +3 -8
  159. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -3
  160. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -3
  161. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +2 -10
  162. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +2 -9
  163. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -3
  164. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +1 -3
  165. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +2 -4
  166. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +4 -21
  167. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +3 -9
  168. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +4 -8
  169. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +1 -4
  170. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +1 -3
  171. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +1 -1
  172. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +1 -1
  173. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.d.ts +45 -0
  174. package/dist/harness/extension/plugin-ecosystem/tools/allowlisted-run.js +136 -0
  175. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +1 -0
  176. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +18 -3
  177. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +278 -82
  178. package/dist/harness/extension/plugin-ecosystem/tools/delegation.d.ts +31 -0
  179. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +291 -0
  180. package/dist/harness/extension/plugin-ecosystem/tools/document-tools.js +10 -2
  181. package/dist/harness/extension/plugin-ecosystem/tools/env-info.js +1 -0
  182. package/dist/harness/extension/plugin-ecosystem/tools/eol.d.ts +35 -0
  183. package/dist/harness/extension/plugin-ecosystem/tools/eol.js +43 -0
  184. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +40 -9
  185. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.d.ts +33 -0
  186. package/dist/harness/extension/plugin-ecosystem/tools/file-ops.js +376 -0
  187. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +12 -2
  188. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +239 -61
  189. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.d.ts +27 -0
  190. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +554 -0
  191. package/dist/harness/extension/plugin-ecosystem/tools/http.d.ts +10 -6
  192. package/dist/harness/extension/plugin-ecosystem/tools/http.js +41 -47
  193. package/dist/harness/extension/plugin-ecosystem/tools/index.d.ts +2 -0
  194. package/dist/harness/extension/plugin-ecosystem/tools/index.js +2 -0
  195. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +4 -0
  196. package/dist/harness/extension/plugin-ecosystem/tools/memory.d.ts +11 -1
  197. package/dist/harness/extension/plugin-ecosystem/tools/memory.js +39 -1
  198. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.d.ts +13 -0
  199. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +391 -0
  200. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +51 -2
  201. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +151 -12
  202. package/dist/harness/extension/plugin-ecosystem/tools/session-history.js +2 -0
  203. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +10 -1
  204. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +35 -19
  205. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +8 -0
  206. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +5 -0
  207. package/dist/harness/extension/plugin-ecosystem/tools/web-search.js +1 -0
  208. package/dist/harness/governance/credentials/index.d.ts +1 -1
  209. package/dist/harness/governance/credentials/store.d.ts +16 -4
  210. package/dist/harness/governance/credentials/store.js +33 -6
  211. package/dist/harness/governance/credentials/types.d.ts +11 -0
  212. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +105 -0
  213. package/dist/harness/governance/human-in-the-loop/decision-cache.js +184 -0
  214. package/dist/harness/governance/human-in-the-loop/index.d.ts +5 -5
  215. package/dist/harness/governance/human-in-the-loop/index.js +3 -3
  216. package/dist/harness/governance/human-in-the-loop/types.d.ts +7 -62
  217. package/dist/harness/governance/human-in-the-loop/types.js +6 -2
  218. package/dist/harness/governance/security/capability-enforcer.d.ts +9 -1
  219. package/dist/harness/governance/security/capability-enforcer.js +31 -8
  220. package/dist/harness/governance/security/degradation.js +5 -7
  221. package/dist/harness/governance/security/risk-evaluator.d.ts +1 -1
  222. package/dist/harness/governance/security/risk-evaluator.js +4 -82
  223. package/dist/harness/governance/security/temp-path.d.ts +41 -0
  224. package/dist/harness/governance/security/temp-path.js +117 -0
  225. package/dist/harness/governance/session-acl/index.d.ts +1 -0
  226. package/dist/harness/governance/session-acl/index.js +1 -0
  227. package/dist/harness/governance/session-acl/rights.d.ts +12 -0
  228. package/dist/harness/governance/session-acl/rights.js +89 -7
  229. package/dist/harness/governance/session-acl/seed-roles.js +9 -1
  230. package/dist/harness/governance/session-acl/service.js +21 -29
  231. package/dist/harness/governance/session-acl/tool-rights.d.ts +81 -0
  232. package/dist/harness/governance/session-acl/tool-rights.js +238 -0
  233. package/dist/harness/governance/session-acl/types.d.ts +22 -0
  234. package/dist/harness/index.d.ts +18 -15
  235. package/dist/harness/index.js +11 -7
  236. package/dist/harness/knowledge/file-index-store.js +11 -11
  237. package/dist/harness/knowledge/grounding.d.ts +2 -1
  238. package/dist/harness/knowledge/grounding.js +6 -3
  239. package/dist/harness/knowledge/index.d.ts +2 -2
  240. package/dist/harness/knowledge/index.js +1 -1
  241. package/dist/harness/knowledge/ingest.js +4 -1
  242. package/dist/harness/knowledge/job-control-state.js +4 -4
  243. package/dist/harness/knowledge/job-control.js +11 -11
  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/query-service.js +8 -8
  248. package/dist/harness/knowledge/retriever.js +1 -1
  249. package/dist/harness/knowledge/source-store.d.ts +17 -2
  250. package/dist/harness/knowledge/source-store.js +6 -5
  251. package/dist/harness/knowledge/writer-service.d.ts +2 -0
  252. package/dist/harness/knowledge/writer-service.js +14 -13
  253. package/dist/harness/memory/backfill-trigger.d.ts +2 -2
  254. package/dist/harness/memory/backfill-trigger.js +4 -4
  255. package/dist/harness/memory/cognition-decay.d.ts +36 -0
  256. package/dist/harness/memory/cognition-decay.js +55 -0
  257. package/dist/harness/memory/cognition-gates.d.ts +60 -0
  258. package/dist/harness/memory/cognition-gates.js +191 -0
  259. package/dist/harness/memory/cognition-trigger.d.ts +30 -0
  260. package/dist/harness/memory/cognition-trigger.js +41 -0
  261. package/dist/harness/memory/cognition-types.d.ts +1 -1
  262. package/dist/harness/memory/cognition.d.ts +40 -8
  263. package/dist/harness/memory/cognition.js +432 -79
  264. package/dist/harness/memory/conceptualizer.d.ts +66 -0
  265. package/dist/harness/memory/conceptualizer.js +246 -0
  266. package/dist/harness/memory/index.d.ts +17 -2
  267. package/dist/harness/memory/index.js +12 -1
  268. package/dist/harness/memory/sqlite/agent-db.d.ts +9 -0
  269. package/dist/harness/memory/sqlite/agent-db.js +120 -15
  270. package/dist/harness/memory/sqlite/cognition-store.d.ts +55 -16
  271. package/dist/harness/memory/sqlite/cognition-store.js +591 -144
  272. package/dist/harness/memory/sqlite/memory-store.d.ts +1 -0
  273. package/dist/harness/memory/sqlite/memory-store.js +14 -4
  274. package/dist/harness/memory/sqlite/wisdom-store.d.ts +33 -14
  275. package/dist/harness/memory/sqlite/wisdom-store.js +257 -44
  276. package/dist/harness/memory/store.d.ts +1 -0
  277. package/dist/harness/memory/store.js +3 -0
  278. package/dist/harness/memory/time-format.d.ts +28 -0
  279. package/dist/harness/memory/time-format.js +52 -0
  280. package/dist/harness/memory/types.d.ts +343 -16
  281. package/dist/harness/memory/types.js +49 -0
  282. package/dist/harness/memory/wisdom-formation.d.ts +101 -0
  283. package/dist/harness/memory/wisdom-formation.js +304 -0
  284. package/dist/harness/memory/wisdom-gates.d.ts +50 -0
  285. package/dist/harness/memory/wisdom-gates.js +204 -0
  286. package/dist/harness/memory/wisdom-policy.d.ts +107 -0
  287. package/dist/harness/memory/wisdom-policy.js +220 -0
  288. package/dist/harness/memory/wisdom-types.d.ts +3 -2
  289. package/dist/harness/memory/wisdom-types.js +2 -2
  290. package/dist/harness/memory/wisdom.d.ts +27 -0
  291. package/dist/harness/memory/wisdom.js +181 -0
  292. package/dist/harness/observability/observer/hub.js +23 -1
  293. package/dist/harness/observability/observer/index.d.ts +2 -2
  294. package/dist/harness/observability/observer/index.js +1 -1
  295. package/dist/harness/observability/observer/types.d.ts +57 -0
  296. package/dist/harness/observability/observer/types.js +118 -9
  297. package/dist/harness/run/agent/agent.d.ts +27 -0
  298. package/dist/harness/run/agent/agent.js +45 -0
  299. package/dist/harness/run/concurrency/tool-loop-detection-core.d.ts +1 -1
  300. package/dist/harness/run/concurrency/tool-loop-detection-core.js +1 -1
  301. package/dist/harness/run/reliability/harness-events.d.ts +4 -0
  302. package/dist/harness/run/reliability/run-agent.js +116 -20
  303. package/dist/harness/run/reliability/run-metrics-collector.d.ts +28 -2
  304. package/dist/harness/run/reliability/run-metrics-collector.js +92 -2
  305. package/dist/harness/run/run-guard/default-run-guard.d.ts +0 -5
  306. package/dist/harness/run/run-guard/default-run-guard.js +104 -44
  307. package/dist/harness/run/run-scope.d.ts +52 -0
  308. package/dist/harness/run/runner.d.ts +101 -16
  309. package/dist/harness/run/runner.js +557 -158
  310. package/dist/harness/session/attachments/llm-intent.js +17 -17
  311. package/dist/harness/session/history/port.js +1 -0
  312. package/dist/harness/session/in-memory-store.d.ts +1 -0
  313. package/dist/harness/session/in-memory-store.js +22 -1
  314. package/dist/harness/session/index.d.ts +1 -0
  315. package/dist/harness/session/index.js +1 -0
  316. package/dist/harness/session/schedules/index.d.ts +10 -0
  317. package/dist/harness/session/schedules/index.js +10 -0
  318. package/dist/harness/session/schedules/render.d.ts +13 -0
  319. package/dist/harness/session/schedules/render.js +63 -0
  320. package/dist/harness/session/schedules/service.d.ts +179 -0
  321. package/dist/harness/session/schedules/service.js +695 -0
  322. package/dist/harness/session/schedules/store.d.ts +119 -0
  323. package/dist/harness/session/schedules/store.js +323 -0
  324. package/dist/harness/session/schedules/tools.d.ts +39 -0
  325. package/dist/harness/session/schedules/tools.js +442 -0
  326. package/dist/harness/session/schedules/types.d.ts +104 -0
  327. package/dist/harness/session/schedules/types.js +97 -0
  328. package/dist/harness/session/tasks/tools.js +22 -0
  329. package/dist/harness/session/title.d.ts +86 -0
  330. package/dist/harness/session/title.js +268 -0
  331. package/dist/harness/session/types.d.ts +35 -0
  332. package/dist/harness/shared/events/agent-event-map.d.ts +21 -0
  333. package/dist/harness/shared/events/agent-event-map.js +1 -0
  334. package/dist/harness/shared/types/agent-definition.d.ts +23 -0
  335. package/dist/index.d.ts +25 -9
  336. package/dist/index.js +11 -2
  337. package/dist/integration/providers/anthropic.d.ts +10 -0
  338. package/dist/integration/providers/anthropic.js +44 -1
  339. package/dist/integration/providers/openai.d.ts +10 -0
  340. package/dist/integration/providers/openai.js +58 -2
  341. package/dist/integration/providers/wire-dump-diff.d.ts +191 -0
  342. package/dist/integration/providers/wire-dump-diff.js +351 -0
  343. package/dist/integration/providers/wire-dump.d.ts +178 -0
  344. package/dist/integration/providers/wire-dump.js +396 -0
  345. package/dist/integration/storage/jsonl.d.ts +11 -0
  346. package/dist/integration/storage/jsonl.js +148 -39
  347. package/dist/integration/storage/session-index.js +63 -8
  348. package/dist/subsystems/cognition-steward/conceptualize/SUBSYSTEM.md +43 -0
  349. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +50 -0
  350. package/dist/subsystems/cognition-steward/conceptualize/handler.d.ts +9 -0
  351. package/dist/subsystems/cognition-steward/conceptualize/handler.js +125 -0
  352. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +6 -0
  353. package/dist/subsystems/cognition-steward/consolidate/config.yaml +54 -0
  354. package/dist/subsystems/cognition-steward/consolidate/handler.d.ts +12 -0
  355. package/dist/subsystems/cognition-steward/consolidate/handler.js +93 -0
  356. package/dist/subsystems/memory-steward/backfill/handler.js +9 -0
  357. package/dist/subsystems/wisdom-steward/evaluate/config.yaml +50 -0
  358. package/dist/subsystems/wisdom-steward/evaluate/handler.d.ts +18 -0
  359. package/dist/subsystems/wisdom-steward/evaluate/handler.js +91 -0
  360. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +42 -0
  361. package/dist/subsystems/wisdom-steward/formation/config.yaml +54 -0
  362. package/dist/subsystems/wisdom-steward/formation/handler.d.ts +18 -0
  363. package/dist/subsystems/wisdom-steward/formation/handler.js +212 -0
  364. package/dist/subsystems/wisdom-steward/govern/config.yaml +55 -0
  365. package/dist/subsystems/wisdom-steward/govern/handler.d.ts +17 -0
  366. package/dist/subsystems/wisdom-steward/govern/handler.js +68 -0
  367. package/package.json +115 -115
  368. package/dist/harness/collaboration/multi-agent/agent-registry-types.d.ts +0 -144
  369. package/dist/harness/collaboration/multi-agent/agent-registry-types.js +0 -25
  370. package/dist/harness/collaboration/multi-agent/index.d.ts +0 -17
  371. package/dist/harness/collaboration/multi-agent/index.js +0 -15
  372. package/dist/harness/collaboration/multi-agent/process.d.ts +0 -167
  373. package/dist/harness/collaboration/multi-agent/process.js +0 -256
  374. package/dist/harness/collaboration/multi-agent/registry.d.ts +0 -36
  375. package/dist/harness/collaboration/multi-agent/registry.js +0 -137
  376. package/dist/harness/collaboration/multi-agent/swarm.d.ts +0 -135
  377. package/dist/harness/collaboration/multi-agent/swarm.js +0 -317
  378. package/dist/harness/collaboration/multi-agent/types.d.ts +0 -66
  379. package/dist/harness/collaboration/multi-agent/types.js +0 -15
  380. package/dist/harness/collaboration/orchestration/async-task-store.d.ts +0 -107
  381. package/dist/harness/collaboration/orchestration/async-task-store.js +0 -12
  382. package/dist/harness/collaboration/orchestration/async-task.d.ts +0 -156
  383. package/dist/harness/collaboration/orchestration/async-task.js +0 -359
  384. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.d.ts +0 -47
  385. package/dist/harness/collaboration/orchestration/planner/hybrid-planner.js +0 -61
  386. package/dist/harness/collaboration/orchestration/planner/index.d.ts +0 -9
  387. package/dist/harness/collaboration/orchestration/planner/index.js +0 -6
  388. package/dist/harness/collaboration/orchestration/planner/llm-planner.d.ts +0 -54
  389. package/dist/harness/collaboration/orchestration/planner/llm-planner.js +0 -167
  390. package/dist/harness/collaboration/orchestration/planner/rule-planner.d.ts +0 -85
  391. package/dist/harness/collaboration/orchestration/planner/rule-planner.js +0 -175
  392. package/dist/harness/collaboration/orchestration/quality/classifier.d.ts +0 -21
  393. package/dist/harness/collaboration/orchestration/quality/classifier.js +0 -235
  394. package/dist/harness/collaboration/orchestration/quality/gate.d.ts +0 -29
  395. package/dist/harness/collaboration/orchestration/quality/gate.js +0 -409
  396. package/dist/harness/collaboration/orchestration/quality/index.d.ts +0 -9
  397. package/dist/harness/collaboration/orchestration/quality/index.js +0 -8
  398. package/dist/harness/collaboration/orchestration/quality/types.d.ts +0 -159
  399. package/dist/harness/collaboration/orchestration/quality/types.js +0 -33
  400. package/dist/harness/collaboration/orchestration/scheduler/index.d.ts +0 -5
  401. package/dist/harness/collaboration/orchestration/scheduler/index.js +0 -4
  402. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.d.ts +0 -143
  403. package/dist/harness/collaboration/orchestration/scheduler/task-scheduler.js +0 -297
  404. package/dist/harness/collaboration/orchestration/strategy/classifier.d.ts +0 -12
  405. package/dist/harness/collaboration/orchestration/strategy/classifier.js +0 -81
  406. package/dist/harness/collaboration/orchestration/strategy/index.d.ts +0 -3
  407. package/dist/harness/collaboration/orchestration/strategy/index.js +0 -2
  408. package/dist/harness/collaboration/orchestration/strategy/router.d.ts +0 -28
  409. package/dist/harness/collaboration/orchestration/strategy/router.js +0 -105
  410. package/dist/harness/collaboration/orchestration/strategy/types.d.ts +0 -49
  411. package/dist/harness/collaboration/orchestration/strategy/types.js +0 -4
  412. package/dist/harness/collaboration/orchestration/workflow/engine.d.ts +0 -86
  413. package/dist/harness/collaboration/orchestration/workflow/engine.js +0 -298
  414. package/dist/harness/collaboration/orchestration/workflow/index.d.ts +0 -9
  415. package/dist/harness/collaboration/orchestration/workflow/index.js +0 -7
  416. package/dist/harness/collaboration/orchestration/workflow/types.d.ts +0 -143
  417. package/dist/harness/collaboration/orchestration/workflow/types.js +0 -7
  418. package/dist/harness/governance/human-in-the-loop/approval-manager.d.ts +0 -32
  419. package/dist/harness/governance/human-in-the-loop/approval-manager.js +0 -93
  420. /package/dist/harness/collaboration/{multi-agent → delegation}/message-channel-types.d.ts +0 -0
  421. /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';
@@ -96,8 +96,9 @@ export async function probeContextLayerHealth(deps) {
96
96
  let wisdomEntries;
97
97
  if (deps.wisdomStore) {
98
98
  try {
99
- const all = await deps.wisdomStore.getAll();
100
- wisdomEntries = all.length;
99
+ const stats = await deps.wisdomStore.stats();
100
+ // 未退役条目(含 trial/contested);不是注入命中数
101
+ wisdomEntries = stats.total - (stats.byStatus.retired ?? 0) - (stats.byStatus.superseded ?? 0);
101
102
  summary.wisdom = wisdomEntries;
102
103
  }
103
104
  catch {
@@ -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
  }
@@ -106,19 +109,35 @@ export declare class CognitionLayer extends BaseLayer {
106
109
  assemble(ctx: LayerAssembleContext): Promise<LayerContent | null>;
107
110
  }
108
111
  /**
109
- * Wisdom 层 — 从 WisdomStore 读取高优先思维范式
112
+ * Wisdom 层 — 小核心 + 场景匹配注入判断范式
110
113
  *
111
- * 当前薄实现:取全部并按 priority 排序后截断。
112
- * 后续可改为场景匹配 / applicableScenarios 过滤。
114
+ * 不做全量 dump。匹配失败只注入 core(宁缺毋滥)。
113
115
  */
114
116
  export declare class WisdomLayer extends BaseLayer {
115
- private readonly getEntries;
117
+ private readonly select;
118
+ private readonly onInjected?;
119
+ private readonly coreMaxItems?;
120
+ private readonly scenarioMaxItems?;
116
121
  constructor(options: {
117
- getEntries: () => Promise<Array<{
118
- id: string;
119
- content: string;
120
- priority: number;
122
+ select: (query: string) => Promise<Array<{
123
+ entry: {
124
+ id: string;
125
+ statement: string;
126
+ scenario: {
127
+ problemTypes: string[];
128
+ antiScenarios?: string[];
129
+ };
130
+ effect: {
131
+ posture?: string;
132
+ questions?: string[];
133
+ };
134
+ };
135
+ bucket: 'core' | 'scenario';
121
136
  }>>;
137
+ /** S1 applied 入账(注入命中) */
138
+ onInjected?: (ids: string[]) => void | Promise<void>;
139
+ coreMaxItems?: number;
140
+ scenarioMaxItems?: number;
122
141
  order?: number;
123
142
  });
124
143
  assemble(ctx: LayerAssembleContext): Promise<LayerContent | null>;
@@ -133,11 +152,9 @@ export interface CreateDefaultLayersOptions {
133
152
  knowledgeShowProgress?: 'off' | 'bucket' | 'exact';
134
153
  memoryStore?: MemoryStore;
135
154
  cognitionStore?: ConceptGraphStore;
136
- wisdomEntries?: () => Promise<Array<{
137
- id: string;
138
- content: string;
139
- priority: number;
140
- }>>;
155
+ wisdomStore?: import('../memory/types.js').WisdomStore;
156
+ wisdomCoreMaxItems?: number;
157
+ wisdomScenarioMaxItems?: number;
141
158
  }
142
159
  /**
143
160
  * 按可用依赖创建启用层列表