@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
@@ -0,0 +1,123 @@
1
+ /**
2
+ * Turn start/end 信封(全回放 · append-only)
3
+ *
4
+ * 语法(唯一合法形态,无 legacy 分支):
5
+ * - 开 turn:user 消息正文 = `<turn_start id at>…<user_message>…</user_message></turn_start>`
6
+ * - 闭 turn:独立消息 `<turn_end id/>`,`metadata.source='turnEnd'`
7
+ *
8
+ * 不变式:每个 `turn_start.id` ⟺ 恰一条 `turn_end.id`;定形后字节冻结。
9
+ * 正文经 XML 转义嵌入,用户原文不得截断信封。
10
+ */
11
+ import type { Message } from '@octopi-agent/core/types.js';
12
+ /** turn_start 元素的 id 形态(会话内单调 t1,t2,…) */
13
+ export declare function formatTurnId(seq: number): string;
14
+ /** 归一化 Message.content → 纯文本(多模态取 text 块拼接;空 content → '') */
15
+ export declare function messageText(content: Message['content'] | undefined | null): string;
16
+ /** user 原文嵌入 XML 前的最小转义(防伪影标签截断信封) */
17
+ export declare function escapeUserMessageText(text: string): string;
18
+ /** 解转义(extractUserMessageText 出口) */
19
+ export declare function unescapeUserMessageText(text: string): string;
20
+ /** 开 turn 信封:一次定形后的 user 消息正文 */
21
+ export declare function formatTurnStartContent(params: {
22
+ turnId: string;
23
+ /** ISO 或已格式化时间,写入一次 */
24
+ at: string;
25
+ /** `<turn_context>…</turn_context>` 整段(含 boilerplate) */
26
+ turnContextXml: string;
27
+ /** 用户原文(将被 XML 转义后放入 user_message) */
28
+ userText: string;
29
+ }): string;
30
+ /** 闭 turn 消息正文(write-once) */
31
+ export declare function formatTurnEndContent(turnId: string): string;
32
+ /**
33
+ * 构造 turn_context 块(ephemeral 语义 + 各槽位)。
34
+ * boilerplate **禁止**出现字面量 `<user_message>` / `</user_message>`(解析取最后一块)。
35
+ */
36
+ export declare function formatTurnContextXml(params: {
37
+ turnId: string;
38
+ /** 已拼好的槽位正文(runtime_snapshot / grounding / attachments);可空 */
39
+ slotsXml: string;
40
+ }): string;
41
+ /**
42
+ * 从 turn_start 正文取出用户原文供检索 / UI / 摘要。
43
+ * 非 turn_start 正文原样返回。
44
+ * 取**最后一个** user_message 块(boilerplate 禁止再写该标签字面量)。
45
+ */
46
+ export declare function extractUserMessageText(content: string | Message['content'] | undefined | null): string;
47
+ /**
48
+ * 剥掉 `<turn_context>…</turn_context>`(摘要语义输入 / UI)。
49
+ * 保留 `<user_message>` 与 turn_start/turn_end 骨架(或在 UI 场景配合 extractUserMessageText)。
50
+ */
51
+ export declare function stripTurnContextXml(content: string | Message['content'] | undefined | null): string;
52
+ /**
53
+ * 是否 turn_start 正文(接受 string 或 Message.content)。
54
+ *
55
+ * 判形锚定到**正文开头**(允许前导空白):真实信封由 formatTurnStartContent 定形、必然以开标签起头;
56
+ * 正文中途引用标签字面量(讨论协议/贴日志/知识语料)不得命中——否则普通 user 发言会被
57
+ * 写一次守卫误判「已定形」(NEXT-STEPS D7)。
58
+ */
59
+ export declare function isTurnStartContent(content: string | Message['content'] | undefined | null): boolean;
60
+ /** 是否 turn_end 正文(同 isTurnStartContent:锚定正文开头,防止字面量误判) */
61
+ export declare function isTurnEndContent(content: string | Message['content'] | undefined | null): boolean;
62
+ /** 从 turn_start / turn_end 正文解析 id */
63
+ export declare function parseTurnIdFromContent(content: string | Message['content'] | undefined | null): string | undefined;
64
+ /** turn_context 内的槽位段(机器生成块,非用户发言) */
65
+ export interface TurnEnvelopeSlot {
66
+ /** 槽位标签(runtime_snapshot / session_attachments / knowledge_grounding) */
67
+ tag: string;
68
+ /** 槽位正文(不含包裹标签,已 trim) */
69
+ body: string;
70
+ }
71
+ /** turn_start 信封解析结果 */
72
+ export interface TurnEnvelopeParts {
73
+ /** `<turn_start id>`;缺失时 undefined */
74
+ turnId?: string;
75
+ /** `<turn_start at>`;缺失时 undefined */
76
+ at?: string;
77
+ /** turn_context 内槽位(boilerplate 不计;白名单外标签跳过;按出现顺序) */
78
+ slots: TurnEnvelopeSlot[];
79
+ /** `<user_message>` 正文(已解转义);块缺失时为 ''(坏信封不回退整段原文冒充用户发言) */
80
+ userText: string;
81
+ /** 是否含 `<user_message>` 块(false = 信封不完整,UI 应标注而非把整封当用户原文) */
82
+ hasUserMessage: boolean;
83
+ }
84
+ /**
85
+ * 槽位标签集(**转义清单的唯一真源**):joinSlotXml 生产、escapeSlotBody 定向转义、
86
+ * parseTurnEnvelope 白名单三处同源引用——新增槽位必须进此表,转义与白名单随之生效。
87
+ * 白名单外的同形标签视为正文噪音 / 注入尝试。
88
+ */
89
+ export declare const SLOT_TAGS: readonly ["runtime_snapshot", "session_attachments", "knowledge_grounding"];
90
+ export type SlotTag = (typeof SLOT_TAGS)[number];
91
+ /**
92
+ * 槽位正文定向转义(D7 方案 A′):把正文里的同名开/闭标签字面量转义为 XML 实体,
93
+ * 防语料(知识 / grounding / 附件)伪造闭合提前截断槽位、或伪造新槽位条目。
94
+ * 只动 `<tag>` / `</tag>` / `<tag ` 三种序列;其余内容(含其他合法 XML)原样保留。
95
+ *
96
+ * @param tag - 槽位标签(配合 SLOT_TAGS 使用)
97
+ * @param body - 槽位正文
98
+ * @returns 同名字面量已转义的正文
99
+ */
100
+ export declare function escapeSlotBody(tag: string, body: string): string;
101
+ /**
102
+ * 解析 turn_start 信封(槽位 + 用户原文)。
103
+ *
104
+ * 入口判形锚定正文开头(同 isTurnStartContent);turn_context 取**最后一块**
105
+ * (与 extractUserMessageText 取最后一个 user_message 同口径);槽位只认
106
+ * SLOT_TAGS 白名单(防正文伪影伪造任意槽位条目)。
107
+ *
108
+ * @param content - 消息正文(string 或 Message.content)
109
+ * @returns 信封解析结果;非 turn_start 正文返回 null
110
+ */
111
+ export declare function parseTurnEnvelope(content: string | Message['content'] | undefined | null): TurnEnvelopeParts | null;
112
+ /**
113
+ * 拼 turn_context 内的槽位 XML(runner 注入)。
114
+ * 正文经 escapeSlotBody 定向转义(D7 A′):语料同名字面量不得产出解析器眼里的标签,
115
+ * 防提前闭合 / 伪造槽位;tag 必须属于 SLOT_TAGS(转义清单唯一真源)。
116
+ * @param parts - 非空槽位段;空段被跳过
117
+ */
118
+ export declare function joinSlotXml(parts: Array<{
119
+ tag: string;
120
+ body: string;
121
+ }>): string;
122
+ /** 任意 content 归一化后的用户正文(UI / 载体扫描共用) */
123
+ export declare function unwrapUserText(content: string | Message['content'] | undefined | null): string;
@@ -0,0 +1,188 @@
1
+ /**
2
+ * Turn start/end 信封(全回放 · append-only)
3
+ *
4
+ * 语法(唯一合法形态,无 legacy 分支):
5
+ * - 开 turn:user 消息正文 = `<turn_start id at>…<user_message>…</user_message></turn_start>`
6
+ * - 闭 turn:独立消息 `<turn_end id/>`,`metadata.source='turnEnd'`
7
+ *
8
+ * 不变式:每个 `turn_start.id` ⟺ 恰一条 `turn_end.id`;定形后字节冻结。
9
+ * 正文经 XML 转义嵌入,用户原文不得截断信封。
10
+ */
11
+ import { getTextContent } from '@octopi-agent/core/types.js';
12
+ /** turn_start 元素的 id 形态(会话内单调 t1,t2,…) */
13
+ export function formatTurnId(seq) {
14
+ return `t${seq}`;
15
+ }
16
+ /** 归一化 Message.content → 纯文本(多模态取 text 块拼接;空 content → '') */
17
+ export function messageText(content) {
18
+ if (content == null)
19
+ return '';
20
+ return getTextContent(content);
21
+ }
22
+ /** user 原文嵌入 XML 前的最小转义(防伪影标签截断信封) */
23
+ export function escapeUserMessageText(text) {
24
+ return text
25
+ .replace(/&/g, '&amp;')
26
+ .replace(/</g, '&lt;')
27
+ .replace(/>/g, '&gt;');
28
+ }
29
+ /** 解转义(extractUserMessageText 出口) */
30
+ export function unescapeUserMessageText(text) {
31
+ return text
32
+ .replace(/&lt;/g, '<')
33
+ .replace(/&gt;/g, '>')
34
+ .replace(/&amp;/g, '&');
35
+ }
36
+ /** 开 turn 信封:一次定形后的 user 消息正文 */
37
+ export function formatTurnStartContent(params) {
38
+ return (`<turn_start id="${params.turnId}" at="${params.at}">\n` +
39
+ `${params.turnContextXml.trim()}\n` +
40
+ `<user_message>\n${escapeUserMessageText(params.userText)}\n</user_message>\n` +
41
+ `</turn_start>`);
42
+ }
43
+ /** 闭 turn 消息正文(write-once) */
44
+ export function formatTurnEndContent(turnId) {
45
+ return `<turn_end id="${turnId}"/>`;
46
+ }
47
+ /**
48
+ * 构造 turn_context 块(ephemeral 语义 + 各槽位)。
49
+ * boilerplate **禁止**出现字面量 `<user_message>` / `</user_message>`(解析取最后一块)。
50
+ */
51
+ export function formatTurnContextXml(params) {
52
+ const boilerplate = `[turn-scoped · ephemeral · ${params.turnId}]\n` +
53
+ `Picks and snapshots below apply ONLY to the user text in this same turn.\n` +
54
+ `They are not durable memory. Do not carry them forward as facts.\n` +
55
+ `A later turn_context supersedes these picks for new work.\n` +
56
+ `Transcript beats any stale pick.`;
57
+ const slots = params.slotsXml.trim();
58
+ return (`<turn_context authority="ephemeral" applies_to="this-turn-only" supersession="later-turn-wins">\n` +
59
+ `<boilerplate>\n${boilerplate}\n</boilerplate>\n` +
60
+ (slots ? `${slots}\n` : '') +
61
+ `</turn_context>`);
62
+ }
63
+ /**
64
+ * 从 turn_start 正文取出用户原文供检索 / UI / 摘要。
65
+ * 非 turn_start 正文原样返回。
66
+ * 取**最后一个** user_message 块(boilerplate 禁止再写该标签字面量)。
67
+ */
68
+ export function extractUserMessageText(content) {
69
+ const raw = messageText(content);
70
+ const re = /<user_message>\n?([\s\S]*?)\n?<\/user_message>/g;
71
+ let last;
72
+ let m;
73
+ while ((m = re.exec(raw)) !== null) {
74
+ last = m[1];
75
+ }
76
+ return last !== undefined ? unescapeUserMessageText(last.trim()) : raw;
77
+ }
78
+ /**
79
+ * 剥掉 `<turn_context>…</turn_context>`(摘要语义输入 / UI)。
80
+ * 保留 `<user_message>` 与 turn_start/turn_end 骨架(或在 UI 场景配合 extractUserMessageText)。
81
+ */
82
+ export function stripTurnContextXml(content) {
83
+ return messageText(content)
84
+ .replace(/<turn_context[\s\S]*?<\/turn_context>/g, '')
85
+ .trim();
86
+ }
87
+ /**
88
+ * 是否 turn_start 正文(接受 string 或 Message.content)。
89
+ *
90
+ * 判形锚定到**正文开头**(允许前导空白):真实信封由 formatTurnStartContent 定形、必然以开标签起头;
91
+ * 正文中途引用标签字面量(讨论协议/贴日志/知识语料)不得命中——否则普通 user 发言会被
92
+ * 写一次守卫误判「已定形」(NEXT-STEPS D7)。
93
+ */
94
+ export function isTurnStartContent(content) {
95
+ return /^\s*<turn_start[\s>]/.test(messageText(content));
96
+ }
97
+ /** 是否 turn_end 正文(同 isTurnStartContent:锚定正文开头,防止字面量误判) */
98
+ export function isTurnEndContent(content) {
99
+ return /^\s*<turn_end[\s/>]/.test(messageText(content));
100
+ }
101
+ /** 从 turn_start / turn_end 正文解析 id */
102
+ export function parseTurnIdFromContent(content) {
103
+ const m = /<turn_(?:start|end)\s[^>]*\bid="([^"]+)"/.exec(messageText(content));
104
+ return m ? m[1] : undefined;
105
+ }
106
+ /**
107
+ * 槽位标签集(**转义清单的唯一真源**):joinSlotXml 生产、escapeSlotBody 定向转义、
108
+ * parseTurnEnvelope 白名单三处同源引用——新增槽位必须进此表,转义与白名单随之生效。
109
+ * 白名单外的同形标签视为正文噪音 / 注入尝试。
110
+ */
111
+ export const SLOT_TAGS = [
112
+ 'runtime_snapshot',
113
+ 'session_attachments',
114
+ 'knowledge_grounding',
115
+ ];
116
+ const SLOT_TAG_SET = new Set(SLOT_TAGS);
117
+ /**
118
+ * 槽位正文定向转义(D7 方案 A′):把正文里的同名开/闭标签字面量转义为 XML 实体,
119
+ * 防语料(知识 / grounding / 附件)伪造闭合提前截断槽位、或伪造新槽位条目。
120
+ * 只动 `<tag>` / `</tag>` / `<tag ` 三种序列;其余内容(含其他合法 XML)原样保留。
121
+ *
122
+ * @param tag - 槽位标签(配合 SLOT_TAGS 使用)
123
+ * @param body - 槽位正文
124
+ * @returns 同名字面量已转义的正文
125
+ */
126
+ export function escapeSlotBody(tag, body) {
127
+ return body
128
+ .replaceAll(`</${tag}>`, `&lt;/${tag}&gt;`)
129
+ .replaceAll(`<${tag}>`, `&lt;${tag}&gt;`)
130
+ .replaceAll(`<${tag} `, `&lt;${tag} `);
131
+ }
132
+ /**
133
+ * 解析 turn_start 信封(槽位 + 用户原文)。
134
+ *
135
+ * 入口判形锚定正文开头(同 isTurnStartContent);turn_context 取**最后一块**
136
+ * (与 extractUserMessageText 取最后一个 user_message 同口径);槽位只认
137
+ * SLOT_TAGS 白名单(防正文伪影伪造任意槽位条目)。
138
+ *
139
+ * @param content - 消息正文(string 或 Message.content)
140
+ * @returns 信封解析结果;非 turn_start 正文返回 null
141
+ */
142
+ export function parseTurnEnvelope(content) {
143
+ const raw = messageText(content);
144
+ if (!/^\s*<turn_start[\s>]/.test(raw))
145
+ return null;
146
+ const at = /\sat="([^"]*)"/.exec(raw.slice(0, raw.indexOf('>') + 1))?.[1];
147
+ const slots = [];
148
+ const ctxRe = /<turn_context[^>]*>([\s\S]*?)<\/turn_context>/g;
149
+ let ctx = '';
150
+ let cm;
151
+ while ((cm = ctxRe.exec(raw)) !== null) {
152
+ ctx = cm[1] ?? '';
153
+ }
154
+ const slotRe = /<([a-z][a-z0-9_-]*)>\n?([\s\S]*?)\n?<\/\1>/g;
155
+ let sm;
156
+ while ((sm = slotRe.exec(ctx)) !== null) {
157
+ const tag = sm[1];
158
+ if (tag === 'boilerplate')
159
+ continue;
160
+ if (!SLOT_TAG_SET.has(tag))
161
+ continue;
162
+ slots.push({ tag, body: sm[2].trim() });
163
+ }
164
+ const hasUserMessage = /<user_message>/.test(raw);
165
+ return {
166
+ turnId: parseTurnIdFromContent(raw),
167
+ at,
168
+ slots,
169
+ userText: hasUserMessage ? extractUserMessageText(raw) : '',
170
+ hasUserMessage,
171
+ };
172
+ }
173
+ /**
174
+ * 拼 turn_context 内的槽位 XML(runner 注入)。
175
+ * 正文经 escapeSlotBody 定向转义(D7 A′):语料同名字面量不得产出解析器眼里的标签,
176
+ * 防提前闭合 / 伪造槽位;tag 必须属于 SLOT_TAGS(转义清单唯一真源)。
177
+ * @param parts - 非空槽位段;空段被跳过
178
+ */
179
+ export function joinSlotXml(parts) {
180
+ return parts
181
+ .filter((p) => p.body.trim().length > 0)
182
+ .map((p) => `<${p.tag}>\n${escapeSlotBody(p.tag, p.body.trim())}\n</${p.tag}>`)
183
+ .join('\n');
184
+ }
185
+ /** 任意 content 归一化后的用户正文(UI / 载体扫描共用) */
186
+ export function unwrapUserText(content) {
187
+ return extractUserMessageText(content);
188
+ }
@@ -14,8 +14,6 @@ export interface ContextEngineInfo {
14
14
  id: string;
15
15
  /** 引擎名称 */
16
16
  name: string;
17
- /** 是否拥有压缩能力(外部引擎可能自行管理) */
18
- ownsCompaction: boolean;
19
17
  }
20
18
  /**
21
19
  * Token 估算器
@@ -111,11 +109,16 @@ export interface AssembleParams {
111
109
  * 本快照用于重启后快速重建「应给 LLM 的视图」,避免立刻再打一次摘要。
112
110
  */
113
111
  export interface ContextCompactSnapshot {
114
- /** 摘要正文(previousSummary) */
112
+ /** 语义摘要正文(previousSummary;机械降级占位说明不算,不入快照) */
115
113
  summary?: string;
116
- /** 上次主动摘要时的全量消息条数 */
114
+ /** 上次主动压缩时的全量消息条数(再压缩增长门;≠摘要覆盖终点) */
117
115
  lastProactiveMessageCount?: number;
118
- /** 上次主动摘要后的视图 token 估算 */
116
+ /**
117
+ * 摘要覆盖终点(下标,不含)= tailStart。
118
+ * sticky 增量起点;写成 messages.length 会把 tail 误算进覆盖 → 滑出丢消息。
119
+ */
120
+ lastProactiveCoverEnd?: number;
121
+ /** 上次主动压缩后的视图 token 估算 */
119
122
  lastProactiveTokens?: number;
120
123
  }
121
124
  /**
@@ -124,12 +127,16 @@ export interface ContextCompactSnapshot {
124
127
  * 由 Harness 层注入,ContextEngine 用它调用 LLM 生成摘要。
125
128
  * 这样 ContextEngine 不直接依赖 ModelProvider,保持解耦。
126
129
  *
127
- * @param messages - 要摘要的消息
130
+ * 契约(迭代式更新):`options.previousSummary` 已按约定嵌入 `messages` 正文
131
+ * ("Previous summary: …" 段),实现方无需再读 opts 拼 prompt;**返回值即完整
132
+ * 更新后的摘要**,调用方不得再与旧摘要拼接。
133
+ *
134
+ * @param messages - 摘要请求消息(system 指令 + 用户正文;非原始对话序列)
128
135
  * @param options - 摘要选项
129
- * @returns 摘要文本
136
+ * @returns 完整更新后的摘要文本
130
137
  */
131
138
  export type SummarizeFunction = (messages: LLMMessage[], options?: {
132
- /** 上次摘要(用于迭代式更新) */
139
+ /** 上次摘要(已嵌入 messages 正文;仅作元信息回传) */
133
140
  previousSummary?: string;
134
141
  /** 摘要 token 预算 */
135
142
  maxTokens?: number;
@@ -163,25 +170,6 @@ export interface IngestParams {
163
170
  sessionId: string;
164
171
  message: Message;
165
172
  }
166
- export interface CompactParams {
167
- sessionId: string;
168
- /** E4:compact 键分量 */
169
- agentId?: string;
170
- /**
171
- * Token 预算;未知 contextWindow 时可省略。
172
- * 无预算且未 force 时跳过自动门槛判断;force 走结构压缩。
173
- */
174
- tokenBudget?: number;
175
- /** 显式压缩目标(配置 context.compactTargetTokens) */
176
- compactTargetTokens?: number;
177
- /** 是否强制压缩(手动 / overflow 兜底);force 不依赖 contextWindow */
178
- force?: boolean;
179
- /** 当前 token 数(可选,避免重复计算) */
180
- currentTokenCount?: number;
181
- /** 结构压缩用的头尾保护条数;未传用引擎配置 */
182
- protectFirstN?: number;
183
- protectLastN?: number;
184
- }
185
173
  export interface CompactResult {
186
174
  ok: boolean;
187
175
  compacted: boolean;
@@ -189,6 +177,11 @@ export interface CompactResult {
189
177
  tokensBefore: number;
190
178
  tokensAfter?: number;
191
179
  summary?: string;
180
+ /**
181
+ * 摘要覆盖终点(下标,**不含**)= tailStart。
182
+ * sticky 重建的增量起点;写 `messages.length` 会把 tail 误算进覆盖 → 滑出后丢消息。
183
+ */
184
+ coveredMessageCount?: number;
192
185
  }
193
186
  export interface AfterTurnParams {
194
187
  sessionId: string;
@@ -209,7 +202,6 @@ export interface AfterTurnParams {
209
202
  *
210
203
  * 可选方法:
211
204
  * - ingest(): 存储消息
212
- * - compact(): 压缩存储
213
205
  * - afterTurn(): 更新状态(turn 为**本轮增量**消息)
214
206
  *
215
207
  * 本域契约(@layer harness/context);Harness 提供 DefaultContextEngine。
@@ -232,25 +224,6 @@ export interface ContextEngine {
232
224
  * 某些引擎(如外部服务)可能需要这一步。
233
225
  */
234
226
  ingest?(params: IngestParams): Promise<void>;
235
- /**
236
- * 压缩存储(可选)
237
- *
238
- * 当存储超限时,压缩旧消息。
239
- * 引擎可以选择摘要、截断、外部存储等方式。
240
- */
241
- compact?(params: CompactParams): Promise<CompactResult>;
242
- /**
243
- * 结构压缩(手动 / overflow)— 不依赖 contextWindow
244
- * 头尾保护 + 中间段摘要
245
- */
246
- compactStructural?(input: {
247
- sessionId: string;
248
- /** E4:compact 键分量;缺省时内部状态键 = sessionId */
249
- agentId?: string;
250
- messages: Message[];
251
- summarize?: SummarizeFunction;
252
- compactTargetTokens?: number;
253
- }): Promise<CompactResult>;
254
227
  /**
255
228
  * 每轮结束后更新状态(可选)
256
229
  *
@@ -286,6 +259,21 @@ export interface CompressParams {
286
259
  previousSummary?: string;
287
260
  summarize?: SummarizeFunction;
288
261
  tokenEstimator?: TokenEstimator;
262
+ /**
263
+ * 要求产出语义摘要:设置后,机械截断(旧工具输出截断/兜底截断)即使已达标
264
+ * 也不得就此短路返回——必须尝试摘要级。主动摘要路径(applyProactiveCompact)使用:
265
+ * 否则压缩成功但永不产摘要,状态机的复用分支永远无法启用。
266
+ *
267
+ * 实现约定:仅约束「可摘要时不得走机械短路」;无摘要能力(如无 summarize)时
268
+ * 的机械降级结果是允许的,调用方以「结果中无语义摘要」识别降级
269
+ * (见 DefaultContextEngine.extractSummaryText)。
270
+ */
271
+ requireSummary?: boolean;
272
+ /**
273
+ * 缓存前缀:与会话 LLM 请求**同形**的 system+history(buildLlmMessages 产物)。
274
+ * 摘要请求只许在其**尾部**追加指令;禁止改 system / 历史字节——否则打穿 provider 前缀缓存。
275
+ */
276
+ llmPrefix?: LLMMessage[];
289
277
  }
290
278
  export interface CompressResult {
291
279
  /** 压缩后的消息/摘要 */