@octopi-agent/engine 0.98.4 → 0.121.10

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 (493) hide show
  1. package/dist/builtin-model-info.js +28 -7
  2. package/dist/config-admin/agent-presets.d.ts +32 -0
  3. package/dist/config-admin/agent-presets.js +133 -0
  4. package/dist/config-admin/discover.d.ts +33 -4
  5. package/dist/config-admin/discover.js +101 -6
  6. package/dist/config-admin/env.d.ts +11 -0
  7. package/dist/config-admin/env.js +41 -0
  8. package/dist/config-admin/error-copy.d.ts +106 -0
  9. package/dist/config-admin/error-copy.js +287 -0
  10. package/dist/config-admin/i18n.d.ts +21 -0
  11. package/dist/config-admin/i18n.js +19 -0
  12. package/dist/config-admin/index.d.ts +6 -2
  13. package/dist/config-admin/index.js +3 -1
  14. package/dist/config-admin/model-presets.d.ts +14 -0
  15. package/dist/config-admin/model-presets.js +595 -70
  16. package/dist/config-admin/onboarding-apply.d.ts +71 -0
  17. package/dist/config-admin/onboarding-apply.js +235 -0
  18. package/dist/config-admin/onboarding.d.ts +154 -0
  19. package/dist/config-admin/onboarding.js +270 -0
  20. package/dist/config-admin/redact.d.ts +42 -9
  21. package/dist/config-admin/redact.js +69 -5
  22. package/dist/config-schema/agent.d.ts +40 -6
  23. package/dist/config-schema/agent.js +44 -6
  24. package/dist/config-schema/browser.d.ts +62 -0
  25. package/dist/config-schema/browser.js +89 -0
  26. package/dist/config-schema/context.d.ts +12 -37
  27. package/dist/config-schema/context.js +10 -31
  28. package/dist/config-schema/engine.d.ts +140 -164
  29. package/dist/config-schema/engine.js +10 -7
  30. package/dist/config-schema/governance.d.ts +20 -2
  31. package/dist/config-schema/governance.js +18 -3
  32. package/dist/config-schema/models.d.ts +10 -12
  33. package/dist/config-schema/models.js +16 -3
  34. package/dist/config-schema/run.d.ts +6 -2
  35. package/dist/config-schema/run.js +12 -2
  36. package/dist/config-schema/shared.d.ts +1 -3
  37. package/dist/config-schema/shared.js +4 -4
  38. package/dist/config-schema/substrate.d.ts +19 -88
  39. package/dist/config-schema/substrate.js +30 -107
  40. package/dist/config.d.ts +161 -123
  41. package/dist/config.js +109 -7
  42. package/dist/file-mode.d.ts +67 -0
  43. package/dist/file-mode.js +182 -0
  44. package/dist/fork-child.d.ts +82 -0
  45. package/dist/fork-child.js +123 -0
  46. package/dist/harness/activation/delegated-run.d.ts +42 -0
  47. package/dist/harness/activation/delegated-run.js +71 -0
  48. package/dist/harness/activation/dispatcher.js +11 -0
  49. package/dist/harness/activation/inbox.d.ts +3 -3
  50. package/dist/harness/activation/inbox.js +3 -3
  51. package/dist/harness/activation/index.d.ts +1 -0
  52. package/dist/harness/activation/run-backend.d.ts +92 -0
  53. package/dist/harness/activation/run-backend.js +16 -0
  54. package/dist/harness/activation/run-protocol.d.ts +392 -0
  55. package/dist/harness/activation/run-protocol.js +19 -0
  56. package/dist/harness/activation/runtime.d.ts +33 -0
  57. package/dist/harness/activation/runtime.js +130 -31
  58. package/dist/harness/activation/types.d.ts +20 -3
  59. package/dist/harness/agent/builder.d.ts +36 -3
  60. package/dist/harness/agent/builder.js +206 -46
  61. package/dist/harness/agent/config-bridge.d.ts +10 -1
  62. package/dist/harness/agent/config-bridge.js +24 -5
  63. package/dist/harness/agent/config-integrity.js +19 -2
  64. package/dist/harness/agent/registered-tool-adapter.d.ts +27 -0
  65. package/dist/harness/agent/registered-tool-adapter.js +67 -0
  66. package/dist/harness/agent/wire-agent-builder.d.ts +13 -3
  67. package/dist/harness/agent/wire-agent-builder.js +35 -9
  68. package/dist/harness/capabilities/document/backends/plain.js +2 -1
  69. package/dist/harness/capabilities/document/factory.d.ts +5 -0
  70. package/dist/harness/capabilities/document/factory.js +1 -0
  71. package/dist/harness/capabilities/document/legacy/factory.js +3 -2
  72. package/dist/harness/capabilities/document/port.js +6 -3
  73. package/dist/harness/capabilities/document/types.d.ts +5 -0
  74. package/dist/harness/collaboration/autonomous-subsystem/audit/reader.d.ts +17 -0
  75. package/dist/harness/collaboration/autonomous-subsystem/audit/reader.js +66 -36
  76. package/dist/harness/collaboration/autonomous-subsystem/audit/writer.d.ts +6 -2
  77. package/dist/harness/collaboration/autonomous-subsystem/audit/writer.js +27 -7
  78. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +13 -0
  79. package/dist/harness/collaboration/autonomous-subsystem/loader.js +2 -1
  80. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +11 -0
  81. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +17 -0
  82. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +14 -4
  83. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +50 -41
  84. package/dist/harness/collaboration/autonomous-subsystem/sense/input-builder.js +4 -4
  85. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.d.ts +2 -2
  86. package/dist/harness/collaboration/autonomous-subsystem/sense/metrics.js +2 -2
  87. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.d.ts +6 -0
  88. package/dist/harness/collaboration/autonomous-subsystem/signal/bus.js +25 -4
  89. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +4 -1
  90. package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +7 -3
  91. package/dist/harness/collaboration/delegation/child-run.d.ts +10 -1
  92. package/dist/harness/collaboration/delegation/child-run.js +38 -6
  93. package/dist/harness/collaboration/delegation/index.d.ts +1 -1
  94. package/dist/harness/collaboration/delegation/index.js +1 -1
  95. package/dist/harness/collaboration/delegation/notifier.d.ts +6 -1
  96. package/dist/harness/collaboration/delegation/notifier.js +8 -1
  97. package/dist/harness/collaboration/delegation/registry-types.d.ts +2 -0
  98. package/dist/harness/collaboration/delegation/service.d.ts +11 -4
  99. package/dist/harness/collaboration/delegation/service.js +35 -13
  100. package/dist/harness/collaboration/delegation/store.d.ts +4 -0
  101. package/dist/harness/collaboration/delegation/store.js +3 -1
  102. package/dist/harness/collaboration/delegation/types.d.ts +34 -2
  103. package/dist/harness/collaboration/delegation/types.js +22 -0
  104. package/dist/harness/collaboration/delegation/wiring.d.ts +2 -0
  105. package/dist/harness/collaboration/delegation/wiring.js +12 -1
  106. package/dist/harness/context/budget-allocator.d.ts +26 -18
  107. package/dist/harness/context/budget-allocator.js +67 -32
  108. package/dist/harness/context/capabilities/compact/engine.d.ts +44 -11
  109. package/dist/harness/context/capabilities/compact/engine.js +296 -160
  110. package/dist/harness/context/capabilities/compact/handover.d.ts +5 -3
  111. package/dist/harness/context/capabilities/compact/handover.js +7 -5
  112. package/dist/harness/context/capabilities/compact/index.d.ts +7 -2
  113. package/dist/harness/context/capabilities/compact/index.js +5 -1
  114. package/dist/harness/context/capabilities/compact/mechanical.d.ts +130 -0
  115. package/dist/harness/context/capabilities/compact/mechanical.js +268 -0
  116. package/dist/harness/context/capabilities/compact/messages.d.ts +60 -0
  117. package/dist/harness/context/capabilities/compact/messages.js +91 -0
  118. package/dist/harness/context/capabilities/compact/types.d.ts +134 -19
  119. package/dist/harness/context/capabilities/compact/types.js +11 -1
  120. package/dist/harness/context/capabilities/compact/view-split.d.ts +36 -0
  121. package/dist/harness/context/capabilities/compact/view-split.js +72 -0
  122. package/dist/harness/context/capabilities/summary/gate.d.ts +19 -2
  123. package/dist/harness/context/capabilities/summary/gate.js +53 -6
  124. package/dist/harness/context/capabilities/summary/port.js +0 -1
  125. package/dist/harness/context/capabilities/summary/registry.js +20 -0
  126. package/dist/harness/context/capabilities/summary/resolver.d.ts +1 -1
  127. package/dist/harness/context/capabilities/summary/resolver.js +1 -6
  128. package/dist/harness/context/capabilities/summary/tool-binding.d.ts +1 -1
  129. package/dist/harness/context/capabilities/summary/tool-binding.js +16 -12
  130. package/dist/harness/context/capabilities/summary/tool-bindings.d.ts +13 -0
  131. package/dist/harness/context/capabilities/summary/tool-bindings.js +22 -0
  132. package/dist/harness/context/capabilities/summary/types.d.ts +19 -6
  133. package/dist/harness/context/constitution/default-agents.md +85 -0
  134. package/dist/harness/context/context-size-ledger.d.ts +143 -0
  135. package/dist/harness/context/context-size-ledger.js +243 -0
  136. package/dist/harness/context/default-context-engine.d.ts +290 -120
  137. package/dist/harness/context/default-context-engine.js +1555 -764
  138. package/dist/harness/context/index.d.ts +3 -2
  139. package/dist/harness/context/index.js +2 -1
  140. package/dist/harness/context/layer-health.d.ts +4 -0
  141. package/dist/harness/context/layer-health.js +4 -0
  142. package/dist/harness/context/layer-types.d.ts +72 -0
  143. package/dist/harness/context/layer-types.js +87 -2
  144. package/dist/harness/context/layers.d.ts +17 -15
  145. package/dist/harness/context/layers.js +54 -17
  146. package/dist/harness/context/message-selector.d.ts +10 -8
  147. package/dist/harness/context/message-selector.js +49 -27
  148. package/dist/harness/context/prefix-fingerprint.d.ts +46 -0
  149. package/dist/harness/context/prefix-fingerprint.js +52 -0
  150. package/dist/harness/context/summarize.d.ts +2 -2
  151. package/dist/harness/context/summarize.js +27 -2
  152. package/dist/harness/context/system-prompt-assembler.d.ts +4 -0
  153. package/dist/harness/context/system-prompt-assembler.js +7 -3
  154. package/dist/harness/context/token-constants.d.ts +8 -6
  155. package/dist/harness/context/token-constants.js +8 -7
  156. package/dist/harness/context/token-estimate-fns.d.ts +37 -27
  157. package/dist/harness/context/token-estimate-fns.js +85 -66
  158. package/dist/harness/context/token-estimator.d.ts +27 -12
  159. package/dist/harness/context/token-estimator.js +120 -66
  160. package/dist/harness/context/token-segments.d.ts +88 -0
  161. package/dist/harness/context/token-segments.js +103 -0
  162. package/dist/harness/context/tool-result-aging.d.ts +109 -16
  163. package/dist/harness/context/tool-result-aging.js +220 -55
  164. package/dist/harness/context/tool-result-body.js +2 -0
  165. package/dist/harness/context/transform/anchors.d.ts +66 -0
  166. package/dist/harness/context/transform/anchors.js +125 -0
  167. package/dist/harness/context/transform/fold.d.ts +56 -0
  168. package/dist/harness/context/transform/fold.js +135 -0
  169. package/dist/harness/context/transform/migrate.d.ts +41 -0
  170. package/dist/harness/context/transform/migrate.js +69 -0
  171. package/dist/harness/context/transform/types.d.ts +129 -0
  172. package/dist/harness/context/transform/types.js +19 -0
  173. package/dist/harness/context/turn-envelope.d.ts +6 -3
  174. package/dist/harness/context/types.d.ts +196 -119
  175. package/dist/harness/context/types.js +25 -1
  176. package/dist/harness/extension/execution-environment/effect-policy.d.ts +4 -3
  177. package/dist/harness/extension/execution-environment/effect-policy.js +2 -2
  178. package/dist/harness/extension/execution-environment/ops-audit.d.ts +1 -1
  179. package/dist/harness/extension/execution-environment/privileged-exec.js +4 -1
  180. package/dist/harness/extension/execution-environment/resource-limits.d.ts +1 -1
  181. package/dist/harness/extension/execution-environment/resource-limits.js +1 -1
  182. package/dist/harness/extension/execution-environment/workspace.js +1 -1
  183. package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +28 -2
  184. package/dist/harness/extension/plugin-ecosystem/channel-types.js +11 -2
  185. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.d.ts +12 -0
  186. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.js +25 -0
  187. package/dist/harness/extension/plugin-ecosystem/commands/builtin.js +28 -1
  188. package/dist/harness/extension/plugin-ecosystem/commands/index.d.ts +3 -1
  189. package/dist/harness/extension/plugin-ecosystem/commands/index.js +1 -0
  190. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.d.ts +12 -1
  191. package/dist/harness/extension/plugin-ecosystem/commands/plugin-bridge.js +14 -4
  192. package/dist/harness/extension/plugin-ecosystem/commands/router.d.ts +5 -4
  193. package/dist/harness/extension/plugin-ecosystem/commands/router.js +23 -14
  194. package/dist/harness/extension/plugin-ecosystem/commands/types.d.ts +8 -1
  195. package/dist/harness/extension/plugin-ecosystem/commands/types.js +2 -1
  196. package/dist/harness/extension/plugin-ecosystem/hooks/adapter.d.ts +54 -0
  197. package/dist/harness/extension/plugin-ecosystem/hooks/adapter.js +397 -0
  198. package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.d.ts +16 -0
  199. package/dist/harness/extension/plugin-ecosystem/hooks/compaction-integration.js +66 -0
  200. package/dist/harness/extension/plugin-ecosystem/hooks/index.d.ts +4 -0
  201. package/dist/harness/extension/plugin-ecosystem/hooks/index.js +2 -0
  202. package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.d.ts +11 -0
  203. package/dist/harness/extension/plugin-ecosystem/hooks/iteration-snapshot.js +54 -0
  204. package/dist/harness/extension/plugin-ecosystem/hooks/journal.d.ts +9 -0
  205. package/dist/harness/extension/plugin-ecosystem/hooks/journal.js +22 -0
  206. package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.d.ts +12 -0
  207. package/dist/harness/extension/plugin-ecosystem/hooks/policy-error.js +19 -0
  208. package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.d.ts +36 -0
  209. package/dist/harness/extension/plugin-ecosystem/hooks/run-integration.js +338 -0
  210. package/dist/harness/extension/plugin-ecosystem/hooks/services.d.ts +24 -0
  211. package/dist/harness/extension/plugin-ecosystem/hooks/services.js +139 -0
  212. package/dist/harness/extension/plugin-ecosystem/hooks/types.d.ts +229 -0
  213. package/dist/harness/extension/plugin-ecosystem/hooks/types.js +1 -0
  214. package/dist/harness/extension/plugin-ecosystem/index.d.ts +1 -0
  215. package/dist/harness/extension/plugin-ecosystem/index.js +1 -0
  216. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +223 -222
  217. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +218 -203
  218. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.d.ts +95 -0
  219. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.js +170 -0
  220. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.d.ts +178 -0
  221. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.js +314 -0
  222. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.d.ts +78 -0
  223. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.js +80 -0
  224. package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.d.ts +4 -0
  225. package/dist/harness/extension/plugin-ecosystem/plugins/engine-compatibility.js +18 -0
  226. package/dist/harness/extension/plugin-ecosystem/plugins/entry.d.ts +7 -85
  227. package/dist/harness/extension/plugin-ecosystem/plugins/entry.js +8 -50
  228. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +6 -23
  229. package/dist/harness/extension/plugin-ecosystem/plugins/index.js +3 -23
  230. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +57 -114
  231. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +279 -282
  232. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +46 -484
  233. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +123 -345
  234. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +50 -223
  235. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +144 -20
  236. package/dist/harness/extension/plugin-ecosystem/plugins/staging.d.ts +17 -0
  237. package/dist/harness/extension/plugin-ecosystem/plugins/staging.js +15 -0
  238. package/dist/harness/extension/plugin-ecosystem/skills/manager.d.ts +6 -1
  239. package/dist/harness/extension/plugin-ecosystem/skills/manager.js +17 -1
  240. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.d.ts +3 -0
  241. package/dist/harness/extension/plugin-ecosystem/tools/ask-user.js +46 -21
  242. package/dist/harness/extension/plugin-ecosystem/tools/browser-types.d.ts +333 -0
  243. package/dist/harness/extension/plugin-ecosystem/tools/browser-types.js +16 -0
  244. package/dist/harness/extension/plugin-ecosystem/tools/browser.d.ts +64 -0
  245. package/dist/harness/extension/plugin-ecosystem/tools/browser.js +692 -0
  246. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +0 -37
  247. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +108 -4
  248. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +36 -8
  249. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +34 -0
  250. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +0 -6
  251. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +57 -4
  252. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +81 -13
  253. package/dist/harness/extension/plugin-ecosystem/tools/http.js +5 -0
  254. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +13 -7
  255. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +126 -14
  256. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +1 -1
  257. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +44 -5
  258. package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.d.ts +11 -0
  259. package/dist/harness/extension/plugin-ecosystem/tools/plugin-tool.js +39 -0
  260. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.d.ts +1 -1
  261. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +19 -24
  262. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +7 -0
  263. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +4 -0
  264. package/dist/harness/governance/accounting/usage-ledger.d.ts +13 -1
  265. package/dist/harness/governance/accounting/usage-ledger.js +23 -1
  266. package/dist/harness/governance/credentials/db.d.ts +9 -0
  267. package/dist/harness/governance/credentials/db.js +122 -31
  268. package/dist/harness/governance/credentials/store.d.ts +68 -7
  269. package/dist/harness/governance/credentials/store.js +177 -64
  270. package/dist/harness/governance/credentials/types.d.ts +13 -2
  271. package/dist/harness/governance/human-in-the-loop/decision-cache.d.ts +3 -3
  272. package/dist/harness/governance/human-in-the-loop/decision-cache.js +2 -2
  273. package/dist/harness/governance/index.d.ts +1 -0
  274. package/dist/harness/governance/index.js +1 -0
  275. package/dist/harness/governance/registry/db.d.ts +32 -0
  276. package/dist/harness/governance/registry/db.js +142 -0
  277. package/dist/harness/governance/registry/index.d.ts +9 -0
  278. package/dist/harness/governance/registry/index.js +9 -0
  279. package/dist/harness/governance/registry/service.d.ts +381 -0
  280. package/dist/harness/governance/registry/service.js +825 -0
  281. package/dist/harness/governance/registry/types.d.ts +77 -0
  282. package/dist/harness/governance/registry/types.js +7 -0
  283. package/dist/harness/governance/security/capability-enforcer.js +1 -2
  284. package/dist/harness/governance/security/default-security-guard.d.ts +3 -0
  285. package/dist/harness/governance/security/default-security-guard.js +12 -1
  286. package/dist/harness/governance/security/risk-evaluator.d.ts +13 -3
  287. package/dist/harness/governance/security/risk-evaluator.js +307 -21
  288. package/dist/harness/governance/security/shell-parser-treesitter.js +12 -4
  289. package/dist/harness/governance/session-acl/tool-rights.d.ts +1 -0
  290. package/dist/harness/index.d.ts +17 -15
  291. package/dist/harness/index.js +9 -9
  292. package/dist/harness/knowledge/boot-config.d.ts +57 -0
  293. package/dist/harness/knowledge/boot-config.js +52 -0
  294. package/dist/harness/knowledge/catalog-types.d.ts +2 -0
  295. package/dist/harness/knowledge/client.d.ts +77 -9
  296. package/dist/harness/knowledge/client.js +95 -24
  297. package/dist/harness/knowledge/db.d.ts +16 -0
  298. package/dist/harness/knowledge/db.js +112 -41
  299. package/dist/harness/knowledge/describe-sample.d.ts +23 -0
  300. package/dist/harness/knowledge/describe-sample.js +58 -0
  301. package/dist/harness/knowledge/describe.d.ts +8 -0
  302. package/dist/harness/knowledge/describe.js +18 -2
  303. package/dist/harness/knowledge/engine-thread.js +11 -7
  304. package/dist/harness/knowledge/grounding.js +7 -2
  305. package/dist/harness/knowledge/http-app.d.ts +15 -0
  306. package/dist/harness/knowledge/http-app.js +117 -25
  307. package/dist/harness/knowledge/http-bridge.d.ts +15 -0
  308. package/dist/harness/knowledge/http-bridge.js +19 -0
  309. package/dist/harness/knowledge/http-params.d.ts +18 -0
  310. package/dist/harness/knowledge/http-params.js +24 -0
  311. package/dist/harness/knowledge/index.d.ts +2 -0
  312. package/dist/harness/knowledge/index.js +1 -0
  313. package/dist/harness/knowledge/knowledge-serve-child.js +5 -3
  314. package/dist/harness/knowledge/purge.js +5 -2
  315. package/dist/harness/knowledge/query-service.d.ts +25 -4
  316. package/dist/harness/knowledge/query-service.js +79 -43
  317. package/dist/harness/knowledge/query-worker-client.d.ts +14 -2
  318. package/dist/harness/knowledge/query-worker-client.js +8 -3
  319. package/dist/harness/knowledge/query-worker.js +9 -5
  320. package/dist/harness/knowledge/read-http.d.ts +2 -0
  321. package/dist/harness/knowledge/read-http.js +14 -3
  322. package/dist/harness/knowledge/retriever.d.ts +1 -1
  323. package/dist/harness/knowledge/retriever.js +1 -2
  324. package/dist/harness/knowledge/serve.d.ts +14 -8
  325. package/dist/harness/knowledge/serve.js +14 -6
  326. package/dist/harness/knowledge/source-store.d.ts +101 -5
  327. package/dist/harness/knowledge/source-store.js +323 -74
  328. package/dist/harness/knowledge/start-service-process.d.ts +41 -14
  329. package/dist/harness/knowledge/start-service-process.js +67 -96
  330. package/dist/harness/knowledge/tenant-gate.d.ts +81 -0
  331. package/dist/harness/knowledge/tenant-gate.js +167 -0
  332. package/dist/harness/knowledge/types.d.ts +7 -0
  333. package/dist/harness/knowledge/writer-service.d.ts +55 -11
  334. package/dist/harness/knowledge/writer-service.js +200 -30
  335. package/dist/harness/knowledge/writer-worker-client.d.ts +19 -11
  336. package/dist/harness/knowledge/writer-worker-client.js +40 -5
  337. package/dist/harness/knowledge/writer-worker.js +20 -5
  338. package/dist/harness/memory/backfill-trigger.d.ts +10 -3
  339. package/dist/harness/memory/backfill-trigger.js +19 -19
  340. package/dist/harness/memory/cognition-seeds.d.ts +45 -0
  341. package/dist/harness/memory/cognition-seeds.js +67 -0
  342. package/dist/harness/memory/cognition.d.ts +12 -3
  343. package/dist/harness/memory/cognition.js +55 -35
  344. package/dist/harness/memory/conceptualizer.d.ts +11 -1
  345. package/dist/harness/memory/conceptualizer.js +10 -1
  346. package/dist/harness/memory/context-slice.d.ts +42 -0
  347. package/dist/harness/memory/context-slice.js +197 -0
  348. package/dist/harness/memory/health-probe.d.ts +8 -2
  349. package/dist/harness/memory/health-probe.js +10 -13
  350. package/dist/harness/memory/index.d.ts +5 -1
  351. package/dist/harness/memory/index.js +3 -1
  352. package/dist/harness/memory/sqlite/agent-db.d.ts +1 -0
  353. package/dist/harness/memory/sqlite/agent-db.js +9 -8
  354. package/dist/harness/memory/sqlite/cognition-store.d.ts +26 -3
  355. package/dist/harness/memory/sqlite/cognition-store.js +103 -45
  356. package/dist/harness/memory/sqlite/memory-store.js +4 -0
  357. package/dist/harness/memory/sqlite/sqlite-vec.d.ts +24 -1
  358. package/dist/harness/memory/sqlite/sqlite-vec.js +37 -1
  359. package/dist/harness/memory/sqlite/wisdom-store.js +35 -10
  360. package/dist/harness/memory/types.d.ts +24 -6
  361. package/dist/harness/memory/wisdom-formation.d.ts +14 -3
  362. package/dist/harness/memory/wisdom-formation.js +85 -22
  363. package/dist/harness/memory/wisdom-gates.d.ts +14 -0
  364. package/dist/harness/memory/wisdom-gates.js +59 -19
  365. package/dist/harness/memory/wisdom.js +9 -0
  366. package/dist/harness/observability/observer/hub.d.ts +10 -0
  367. package/dist/harness/observability/observer/hub.js +120 -17
  368. package/dist/harness/observability/observer/types.d.ts +10 -6
  369. package/dist/harness/run/agent/agent.d.ts +40 -21
  370. package/dist/harness/run/agent/agent.js +67 -13
  371. package/dist/harness/run/agent/index.d.ts +1 -1
  372. package/dist/harness/run/budget/budget.d.ts +28 -10
  373. package/dist/harness/run/budget/budget.js +38 -15
  374. package/dist/harness/run/concurrency/tool-validator.js +4 -3
  375. package/dist/harness/run/model/index.d.ts +3 -1
  376. package/dist/harness/run/model/index.js +2 -1
  377. package/dist/harness/run/model/resolver.d.ts +4 -1
  378. package/dist/harness/run/model/resolver.js +36 -2
  379. package/dist/harness/run/model/run-scope.d.ts +2 -0
  380. package/dist/harness/run/model/run-scope.js +7 -0
  381. package/dist/harness/run/model/types.d.ts +22 -5
  382. package/dist/harness/run/model/types.js +3 -2
  383. package/dist/harness/run/model/window-truth.d.ts +37 -0
  384. package/dist/harness/run/model/window-truth.js +39 -0
  385. package/dist/harness/run/reliability/context-length-feedback.d.ts +77 -0
  386. package/dist/harness/run/reliability/context-length-feedback.js +128 -0
  387. package/dist/harness/run/reliability/harness-events.d.ts +3 -3
  388. package/dist/harness/run/reliability/model-error-policy.js +4 -0
  389. package/dist/harness/run/reliability/run-agent.d.ts +32 -4
  390. package/dist/harness/run/reliability/run-agent.js +216 -63
  391. package/dist/harness/run/reliability/run-metrics-collector.d.ts +19 -8
  392. package/dist/harness/run/reliability/run-metrics-collector.js +38 -23
  393. package/dist/harness/run/run-guard/default-run-guard.js +8 -8
  394. package/dist/harness/run/run-host.d.ts +302 -0
  395. package/dist/harness/run/run-host.js +978 -0
  396. package/dist/harness/run/run-scope.d.ts +48 -4
  397. package/dist/harness/run/run-scope.js +19 -1
  398. package/dist/harness/run/runner.d.ts +181 -39
  399. package/dist/harness/run/runner.js +654 -119
  400. package/dist/harness/session/attachments/index.d.ts +1 -0
  401. package/dist/harness/session/attachments/index.js +1 -0
  402. package/dist/harness/session/attachments/inject.d.ts +21 -10
  403. package/dist/harness/session/attachments/inject.js +76 -24
  404. package/dist/harness/session/attachments/recall-index.d.ts +70 -0
  405. package/dist/harness/session/attachments/recall-index.js +219 -0
  406. package/dist/harness/session/attachments/service.d.ts +21 -0
  407. package/dist/harness/session/attachments/service.js +258 -139
  408. package/dist/harness/session/attachments/types.d.ts +6 -0
  409. package/dist/harness/session/in-memory-store.js +13 -1
  410. package/dist/harness/session/schedules/service.d.ts +10 -2
  411. package/dist/harness/session/schedules/service.js +13 -2
  412. package/dist/harness/session/tasks/tools.js +12 -0
  413. package/dist/harness/session/transform-store.d.ts +136 -0
  414. package/dist/harness/session/transform-store.js +302 -0
  415. package/dist/harness/session/types.d.ts +11 -15
  416. package/dist/harness/shared/events/agent-event-map.d.ts +75 -13
  417. package/dist/harness/shared/events/agent-event-map.js +3 -2
  418. package/dist/harness/shared/events/scenario-events.d.ts +6 -6
  419. package/dist/harness/shared/types/agent-definition.d.ts +7 -2
  420. package/dist/index.d.ts +16 -18
  421. package/dist/index.js +9 -10
  422. package/dist/integration/agent-runtime/channel-message-source.d.ts +3 -1
  423. package/dist/integration/agent-runtime/channel-message-source.js +4 -3
  424. package/dist/integration/browser/camoufox.d.ts +40 -0
  425. package/dist/integration/browser/camoufox.js +80 -0
  426. package/dist/integration/browser/index.d.ts +91 -0
  427. package/dist/integration/browser/index.js +110 -0
  428. package/dist/integration/browser/install.d.ts +47 -0
  429. package/dist/integration/browser/install.js +214 -0
  430. package/dist/integration/browser/playwright.d.ts +224 -0
  431. package/dist/integration/browser/playwright.js +925 -0
  432. package/dist/integration/browser/service.d.ts +41 -0
  433. package/dist/integration/browser/service.js +181 -0
  434. package/dist/integration/browser/stealth.d.ts +42 -0
  435. package/dist/integration/browser/stealth.js +104 -0
  436. package/dist/integration/observability/metrics.d.ts +6 -6
  437. package/dist/integration/observability/metrics.js +13 -13
  438. package/dist/integration/observability/observer-bridge.js +2 -2
  439. package/dist/integration/observability/trace-collector.d.ts +5 -5
  440. package/dist/integration/observability/trace-collector.js +34 -35
  441. package/dist/integration/observability/trace-events.d.ts +3 -3
  442. package/dist/integration/observability/trace-events.js +3 -3
  443. package/dist/integration/providers/anthropic-message-normalize.d.ts +20 -0
  444. package/dist/integration/providers/anthropic-message-normalize.js +48 -0
  445. package/dist/integration/providers/anthropic.js +41 -3
  446. package/dist/integration/providers/fetch-timeout.d.ts +17 -0
  447. package/dist/integration/providers/fetch-timeout.js +24 -0
  448. package/dist/integration/providers/openai.d.ts +8 -0
  449. package/dist/integration/providers/openai.js +48 -2
  450. package/dist/integration/providers/usage.d.ts +1 -1
  451. package/dist/integration/providers/wire-dump-diff.js +2 -1
  452. package/dist/integration/providers/wire-dump.d.ts +57 -3
  453. package/dist/integration/providers/wire-dump.js +119 -6
  454. package/dist/integration/storage/archive-manager.d.ts +20 -2
  455. package/dist/integration/storage/archive-manager.js +34 -8
  456. package/dist/integration/storage/atomic-tmp.d.ts +12 -0
  457. package/dist/integration/storage/atomic-tmp.js +36 -0
  458. package/dist/integration/storage/jsonl.d.ts +10 -1
  459. package/dist/integration/storage/jsonl.js +155 -54
  460. package/dist/integration/storage/session-index.d.ts +5 -0
  461. package/dist/integration/storage/session-index.js +25 -4
  462. package/dist/integration/tools/assemble.d.ts +50 -0
  463. package/dist/integration/tools/assemble.js +137 -0
  464. package/dist/paths.d.ts +18 -0
  465. package/dist/paths.js +36 -0
  466. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +3 -1
  467. package/dist/subsystems/cognition-steward/conceptualize/handler.js +74 -5
  468. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +3 -2
  469. package/dist/subsystems/cognition-steward/consolidate/config.yaml +11 -2
  470. package/dist/subsystems/cognition-steward/consolidate/handler.d.ts +6 -3
  471. package/dist/subsystems/cognition-steward/consolidate/handler.js +266 -28
  472. package/dist/subsystems/memory-steward/backfill/handler.js +3 -2
  473. package/dist/subsystems/memory-steward/govern/config.yaml +6 -1
  474. package/dist/subsystems/wisdom-steward/attribute/config.yaml +5 -1
  475. package/dist/subsystems/wisdom-steward/formation/SUBSYSTEM.md +8 -1
  476. package/dist/subsystems/wisdom-steward/formation/config.yaml +4 -0
  477. package/dist/subsystems/wisdom-steward/formation/handler.js +27 -5
  478. package/dist/subsystems/wisdom-steward/govern/config.yaml +6 -1
  479. package/package.json +14 -15
  480. package/dist/harness/context/hybrid-compressor.d.ts +0 -41
  481. package/dist/harness/context/hybrid-compressor.js +0 -159
  482. package/dist/harness/context/llm-summarizer.d.ts +0 -46
  483. package/dist/harness/context/llm-summarizer.js +0 -249
  484. package/dist/harness/context/smart-router.d.ts +0 -75
  485. package/dist/harness/context/smart-router.js +0 -118
  486. package/dist/harness/context/truncate-compressor.d.ts +0 -28
  487. package/dist/harness/context/truncate-compressor.js +0 -107
  488. package/dist/harness/extension/plugin-ecosystem/plugins/capability.d.ts +0 -97
  489. package/dist/harness/extension/plugin-ecosystem/plugins/capability.js +0 -155
  490. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.d.ts +0 -7
  491. package/dist/harness/extension/plugin-ecosystem/plugins/hooks.js +0 -7
  492. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.d.ts +0 -86
  493. package/dist/harness/extension/plugin-ecosystem/plugins/lifecycle.js +0 -139
@@ -2,25 +2,27 @@
2
2
  * 交接式摘要契约(2026-10-28 拍板)——所有摘要路径的**单一指令源**。
3
3
  *
4
4
  * F8 模板统一:手动压缩(compactCore.summarizeMiddle)与 proactive/overflow
5
- * (LLMSummaryCompressor)共用本模板、指令构造与预算语义,保证 previousSummary
5
+ * (summarizeFn 执行器)共用本模板、指令构造与预算语义,保证 previousSummary
6
6
  * 只有一种格式在迭代合并——两套模板轮流并入是压缩行为不可控的根源。
7
7
  *
8
8
  * 模板结构是拍板物(四段式);规则行只约束行为,不改结构。F-d 硬约束
9
9
  * (完成项可核验 + 交接防重做 + 不虚构)以散文形式并入,不另立结构。
10
10
  */
11
11
  import type { SummaryPolicy } from '../summary/types.js';
12
- /** 交接书四段式任务(summaryPort / summarizeFn / LLMSummaryCompressor 共用,保持指令对齐)。
12
+ /** 交接书四段式任务(manual/proactive/overflow 共用同一 summarizeFn 执行管道,保持指令对齐)。
13
13
  * 反回声纪律(评审 F15):指令里不出现任何工具调用/角色标记字面量——负面示例本身会教坏模型
14
14
  * 且引发闸门自命中;证据允许单行短引用(F4:引用≠污染)。 */
15
15
  export declare const HANDOVER_SUMMARY_TASK: string;
16
16
  /** 折叠区间(评审 F7/F3):交接书替换范围与原样保留尾部——计数语义(两路都能精确供给,不编造索引) */
17
17
  export interface HandoverFoldRange {
18
- /** 交接书替换的旧消息条数 */
18
+ /** 本次需要并入交接书的消息条数(既有摘要之后、保护尾之前) */
19
19
  replacedCount: number;
20
20
  /** 会话消息总数 */
21
21
  total: number;
22
22
  /** 原样保留的尾部条数(勿总结它们) */
23
23
  preservedTail: number;
24
+ /** 前缀中上一份交接书已代表的早期消息条数(P2:前缀=折叠视图时 >0) */
25
+ coveredCount?: number;
24
26
  }
25
27
  export interface HandoverPromptOptions {
26
28
  /** 摘要软目标预算(P1c:写进指令当「尽量控制在 N tokens」,禁止作 provider 硬顶) */
@@ -2,7 +2,7 @@
2
2
  * 交接式摘要契约(2026-10-28 拍板)——所有摘要路径的**单一指令源**。
3
3
  *
4
4
  * F8 模板统一:手动压缩(compactCore.summarizeMiddle)与 proactive/overflow
5
- * (LLMSummaryCompressor)共用本模板、指令构造与预算语义,保证 previousSummary
5
+ * (summarizeFn 执行器)共用本模板、指令构造与预算语义,保证 previousSummary
6
6
  * 只有一种格式在迭代合并——两套模板轮流并入是压缩行为不可控的根源。
7
7
  *
8
8
  * 模板结构是拍板物(四段式);规则行只约束行为,不改结构。F-d 硬约束
@@ -10,7 +10,7 @@
10
10
  */
11
11
  import { buildSystemPrompt } from '../summary/executor.js';
12
12
  import { buildPolicyRegistry } from '../summary/resolver.js';
13
- /** 交接书四段式任务(summaryPort / summarizeFn / LLMSummaryCompressor 共用,保持指令对齐)。
13
+ /** 交接书四段式任务(manual/proactive/overflow 共用同一 summarizeFn 执行管道,保持指令对齐)。
14
14
  * 反回声纪律(评审 F15):指令里不出现任何工具调用/角色标记字面量——负面示例本身会教坏模型
15
15
  * 且引发闸门自命中;证据允许单行短引用(F4:引用≠污染)。 */
16
16
  export const HANDOVER_SUMMARY_TASK = [
@@ -59,14 +59,16 @@ export function buildHandoverPrompt(options) {
59
59
  ? Math.max(0, options.foldRange.total - options.foldRange.replacedCount - options.foldRange.preservedTail)
60
60
  : 0;
61
61
  const foldBlock = options.foldRange
62
- ? `\n\nFold boundary: the handoff summarizes ${options.foldRange.replacedCount} older messages of ${options.foldRange.total}; ${preservedHead} earlier and ${options.foldRange.preservedTail} newer messages are preserved verbatim - cover the replaced part in depth and keep the summary off the preserved ones.`
62
+ ? options.foldRange.coveredCount
63
+ ? `\n\nFold boundary: the conversation above already carries your previous handoff, which stands for ${options.foldRange.coveredCount} earlier messages of ${options.foldRange.total}. Fold the ${options.foldRange.replacedCount} newer messages that follow it into that handoff; the last ${options.foldRange.preservedTail} messages are preserved verbatim - keep the summary off them.`
64
+ : `\n\nFold boundary: the handoff summarizes ${options.foldRange.replacedCount} older messages of ${options.foldRange.total}; ${preservedHead} earlier and ${options.foldRange.preservedTail} newer messages are preserved verbatim - cover the replaced part in depth and keep the summary off the preserved ones.`
63
65
  : '';
64
66
  const mergeHint = options.previousSummary ? MERGE_HINT : '';
65
67
  const previousBlock = options.previousSummary
66
68
  ? `\n\nPrevious summary:\n${options.previousSummary}`
67
69
  : '';
68
70
  const taskBlock = options.taskSnapshot?.trim()
69
- ? `\n\nCurrent session task list snapshot (live task store):\n${options.taskSnapshot.trim()}`
71
+ ? `\n\nCurrent session task list snapshot (live task store; supersedes any task list shown earlier in the conversation):\n${options.taskSnapshot.trim()}`
70
72
  : '';
71
73
  return {
72
74
  instruction: `${instruction}${foldBlock}`,
@@ -98,7 +100,7 @@ export function clampSummaryProviderCap(options) {
98
100
  */
99
101
  export function buildHandoverUserContent(options, content) {
100
102
  const taskBlock = options.taskSnapshot?.trim()
101
- ? `\n\nCurrent session task list snapshot (live task store):\n${options.taskSnapshot.trim()}`
103
+ ? `\n\nCurrent session task list snapshot (live task store; supersedes any task list shown earlier in the conversation):\n${options.taskSnapshot.trim()}`
102
104
  : '';
103
105
  if (!options.previousSummary) {
104
106
  return `${content}${taskBlock}`;
@@ -3,7 +3,12 @@
3
3
  *
4
4
  * @module harness/context/capabilities/compact
5
5
  */
6
- export { createCompactEngine, summarySoftTargetTokens, detectSummaryContamination } from './engine.js';
6
+ export { createCompactEngine, summarySoftTargetTokens, detectSummaryContamination, inspectSummaryOutput, evaluateEcho, } from './engine.js';
7
+ export type { ContaminationResult, EchoVerdict } from './engine.js';
8
+ export { asSummaryMessage, wrapSummaryText, isMechanicalNotice, SUMMARY_MARKER, MECHANICAL_NOTICE_TRUNCATED, MECHANICAL_NOTICE_COMPRESSED, MECHANICAL_NOTICE_STRUCTURAL, } from './messages.js';
9
+ export { alignViewSplit, semanticHistory } from './view-split.js';
10
+ export { isToolResultMessage, hasToolCall, } from './messages.js';
11
+ export { buildToolCallLedger, asLedgerMessage, ledgerTruncate, mechanicalDegrade, toolExecutionLedgerTrim, } from './mechanical.js';
7
12
  export { HANDOVER_SUMMARY_TASK, buildHandoverPrompt, buildHandoverUserContent, clampSummaryProviderCap, } from './handover.js';
8
13
  export type { HandoverFoldRange, HandoverPromptOptions } from './handover.js';
9
- export type { CompactEngine, CompactMode, CompactOptions, CompactOutcome, CompactSummarizeFn, CompactTokenEstimator, CreateCompactEngineOptions, } from './types.js';
14
+ export type { CompactEngine, CompactMode, CompactOptions, CompactOutcome, CompactTransportOutcome, SummarizeFunction, CompactTokenEstimator, CreateCompactEngineOptions, } from './types.js';
@@ -3,5 +3,9 @@
3
3
  *
4
4
  * @module harness/context/capabilities/compact
5
5
  */
6
- export { createCompactEngine, summarySoftTargetTokens, detectSummaryContamination } from './engine.js';
6
+ export { createCompactEngine, summarySoftTargetTokens, detectSummaryContamination, inspectSummaryOutput, evaluateEcho, } from './engine.js';
7
+ export { asSummaryMessage, wrapSummaryText, isMechanicalNotice, SUMMARY_MARKER, MECHANICAL_NOTICE_TRUNCATED, MECHANICAL_NOTICE_COMPRESSED, MECHANICAL_NOTICE_STRUCTURAL, } from './messages.js';
8
+ export { alignViewSplit, semanticHistory } from './view-split.js';
9
+ export { isToolResultMessage, hasToolCall, } from './messages.js';
10
+ export { buildToolCallLedger, asLedgerMessage, ledgerTruncate, mechanicalDegrade, toolExecutionLedgerTrim, } from './mechanical.js';
7
11
  export { HANDOVER_SUMMARY_TASK, buildHandoverPrompt, buildHandoverUserContent, clampSummaryProviderCap, } from './handover.js';
@@ -0,0 +1,130 @@
1
+ /**
2
+ * 机械降级 — 零 LLM 的压缩执行(purpose 账本,单级)
3
+ *
4
+ * 定位(2026-11-04 拍板):**应急通道**,只在摘要无法产出时接手——
5
+ * provider 报错/超时、输出闸门二次判污染、摘要请求放不进窗口。它不是常态压缩
6
+ * (常态走交接式摘要),因此不需要渐进、不需要分级,一次做到最大化压缩。
7
+ *
8
+ * 形态:整段 middle/messages 替换为 **一条 purpose 账本消息**——保留「调用过什么、
9
+ * 为什么调用、哪条失败」,丢弃结果正文与参数载荷。依据:
10
+ * - purpose 是工具调用的必填契约(`≤120 字符`,动词+宾语+目标),本身就是
11
+ * 「任务执行情况」的最小可读摘要,实测 510/510 调用齐备;
12
+ * - 生产实测压缩比 ~16x(475k → 29k 字符),远优于结果打码的 ~3.7x 地板
13
+ * (aging 指针约 557 字符/调用,账本约 58 字符/调用);
14
+ * - 省下的正是最不值钱的部分(长结果正文),留下的正是最值钱的(意图与失败)。
15
+ *
16
+ * **超预算不静默丢条目**:账本已是最小形态,若仍超预算说明该会话不宜继续——
17
+ * 如实上报 `overBudget`,由上层决定告知用户开新会话。丢条目等于静默失忆。
18
+ *
19
+ * 单源:占位文案与判别见 ./messages.ts;错别话术禁止在本模块手写第二份。
20
+ *
21
+ * @module harness/context/capabilities/compact/mechanical
22
+ */
23
+ import type { Message } from '@octopi-agent/core/types.js';
24
+ /**
25
+ * 工具调用账本(`name + purpose` 逐行)——降级时的「做过什么」无损索引。
26
+ *
27
+ * 输出形态:
28
+ * ```
29
+ * - file_edit: Add event-vocabulary disposition to P5 row
30
+ * - shell: Stage explicit paths, commit, and tag v0.98.17
31
+ * ! project_run: test failed (exit 1)
32
+ * ```
33
+ * error 结果附在对应调用行下方(错误可追溯性优先,永不省略)。
34
+ *
35
+ * @param messages - 被降级丢弃的消息
36
+ * @returns 账本文本(可为空串)
37
+ */
38
+ export declare function buildToolCallLedger(messages: Message[]): string;
39
+ /**
40
+ * 账本消息构造(user 角色——中段 system 会被部分网关拒绝)。
41
+ *
42
+ * @param ledger - 账本文本(可为空)
43
+ * @param removedCount - 被替换的消息条数
44
+ * @returns 账本视图消息
45
+ */
46
+ export declare function asLedgerMessage(ledger: string, removedCount: number): Message;
47
+ /**
48
+ * 账本截断(保留近尾 + 头部替换为账本)——**物理溢出兜底专用**。
49
+ *
50
+ * 与 `mechanicalDegrade` 的分工:本函数服务「消息必须放回窗口否则请求 400」的场景
51
+ * (overflow 路径),所以在丢头部的同时**保住近尾原文**(最近的现场最值钱);
52
+ * `mechanicalDegrade` 服务「摘要失败」的场景,一次全量转账本。
53
+ *
54
+ * 形态(middle 替换体,外层 head/tail 由调用方拼接):`[账本说明 + 近尾]`。
55
+ * - 保留近尾:预算驱动从头丢弃,但**保底**不破(禁止只留 4 条);
56
+ * - 边界对齐:tool_call/tool_result 对同进同出,保留尾不得起于孤儿结果
57
+ * (孤儿时**回退**切点把调用一并纳入 kept——宁可胖不可拆对;向前跳会把连续
58
+ * tool 结果一路丢光、整段 middle 被吞);
59
+ * - 无可丢弃时原样返回(禁止「0 removed」假通知膨胀)。
60
+ *
61
+ * @param messages - 待降级消息
62
+ * @param opts - targetTokens 预算、估算器、minKeep 保底
63
+ * - targetTokens 缺省不是「不压缩」,而是**只丢到保底**(最大压缩);
64
+ * - minKeep 为**纯保底**(拍板常量,非可调参数):显式传入即用该值(「压到目标」的
65
+ * 机械压缩传 2 = 旧 TruncateCompressor「至少留 2」口径,不叠 15%——叠加会把保 2
66
+ * 架空成 15%、粘滞增量撑胖后在复用轮挤出 overflow 补摘要);缺省 = max(6, 15%)
67
+ * (旧 fallbackTruncate / conservativeTruncate 失败兜底口径)。
68
+ * @returns 截断结果(result 含账本说明或原样 + droppedCount + ledgerKept)
69
+ */
70
+ export declare function ledgerTruncate(messages: Message[], opts?: {
71
+ targetTokens?: number;
72
+ estimator?: {
73
+ estimateMessages(ms: Message[]): number;
74
+ };
75
+ minKeep?: number;
76
+ }): {
77
+ result: Message[];
78
+ droppedCount: number;
79
+ ledgerKept: boolean;
80
+ };
81
+ /**
82
+ * 机械降级:整段替换为 purpose 账本(零 LLM,单级,无可再降)。
83
+ *
84
+ * @param messages - 待降级消息
85
+ * @param opts - targetTokens(用于判定是否仍需上报超预算)与估算器
86
+ * @returns 降级结果
87
+ * - `result`:单条账本消息(入参为空时为空数组)
88
+ * - `tokensAfter`:账本 token 估算
89
+ * - `overBudget`:账本仍超 targetTokens —— 已无可降空间,调用方须如实上报,
90
+ * 不得再丢条目(丢条目 = 静默失忆)
91
+ * - `droppedSummary`:产物描述
92
+ */
93
+ export declare function mechanicalDegrade(messages: Message[], opts?: {
94
+ targetTokens?: number;
95
+ estimator?: {
96
+ estimateMessages(ms: Message[]): number;
97
+ };
98
+ }): {
99
+ result: Message[];
100
+ tokensAfter: number;
101
+ overBudget: boolean;
102
+ droppedSummary?: string;
103
+ };
104
+ /**
105
+ * 工具执行账本化(收敛阶梯第 1–3 轮专用,arch/overflow-redesign.md §3)。
106
+ *
107
+ * 语义(丢弃次序原则:数据细节 → 执行记录 → 工作窗口 → 放弃,从最可再生到最不可再生):
108
+ * - **账本化对象 = 工具执行段**(assistant(toolCalls) + tool(result) 对,同进同出)——
109
+ * 执行记录可再生(可重执行/磁盘找回),先于工作窗口丢弃;
110
+ * - **跳过保留**:真 user 消息(最不可再生)、assistant 文本(非执行记录)、
111
+ * 合成消息(contextLedger/contextSummary 占位——已是索引/交接形态,不可再降);
112
+ * - **tailKeep 近尾保护**(工作窗口):近尾 tailKeep 条内的工具执行不账本化。
113
+ *
114
+ * 形态:被账本化 run 的原位移除,**第一个**被砍 run 的下标处放一个合并 notice
115
+ * (buildToolCallLedger 汇总全部被砍执行的 name+purpose+errors)——与 fold 同构:
116
+ * foldTransformView 对多 covers runs 渲染**一个**占位(firstIndex 处、区间内保护类原样),
117
+ * 本函数的产物即 fold 后视图,守门量的与发送的是同一个产物。
118
+ *
119
+ * 每档独立调用(幂等):无候选时原样返回——天然支持「每档对原视图重算」,不累积吞账本。
120
+ *
121
+ * @param messages - 原始视图(收敛循环对同一 view 每档独立调用)
122
+ * @param opts - tailKeep 近尾保护档、估算器、targetTokens(缺省=砍掉全部候选)
123
+ * @returns 产物视图 + 被账本化条数(0=砍不动/无候选)
124
+ */
125
+ export declare function toolExecutionLedgerTrim(messages: Message[], opts: {
126
+ tailKeep: number;
127
+ }): {
128
+ result: Message[];
129
+ droppedCount: number;
130
+ };
@@ -0,0 +1,268 @@
1
+ /**
2
+ * 机械降级 — 零 LLM 的压缩执行(purpose 账本,单级)
3
+ *
4
+ * 定位(2026-11-04 拍板):**应急通道**,只在摘要无法产出时接手——
5
+ * provider 报错/超时、输出闸门二次判污染、摘要请求放不进窗口。它不是常态压缩
6
+ * (常态走交接式摘要),因此不需要渐进、不需要分级,一次做到最大化压缩。
7
+ *
8
+ * 形态:整段 middle/messages 替换为 **一条 purpose 账本消息**——保留「调用过什么、
9
+ * 为什么调用、哪条失败」,丢弃结果正文与参数载荷。依据:
10
+ * - purpose 是工具调用的必填契约(`≤120 字符`,动词+宾语+目标),本身就是
11
+ * 「任务执行情况」的最小可读摘要,实测 510/510 调用齐备;
12
+ * - 生产实测压缩比 ~16x(475k → 29k 字符),远优于结果打码的 ~3.7x 地板
13
+ * (aging 指针约 557 字符/调用,账本约 58 字符/调用);
14
+ * - 省下的正是最不值钱的部分(长结果正文),留下的正是最值钱的(意图与失败)。
15
+ *
16
+ * **超预算不静默丢条目**:账本已是最小形态,若仍超预算说明该会话不宜继续——
17
+ * 如实上报 `overBudget`,由上层决定告知用户开新会话。丢条目等于静默失忆。
18
+ *
19
+ * 单源:占位文案与判别见 ./messages.ts;错别话术禁止在本模块手写第二份。
20
+ *
21
+ * @module harness/context/capabilities/compact/mechanical
22
+ */
23
+ import { HeuristicTokenEstimator } from '../../token-estimator.js';
24
+ import { MECHANICAL_NOTICE_TRUNCATED, hasToolCall, isToolResultMessage } from './messages.js';
25
+ /**
26
+ * 账本单条 purpose 的防御上限(字符)。
27
+ * purpose 契约本身 ≤120;超长只可能来自历史数据或非本契约客户端,截断防单条撑爆账本。
28
+ */
29
+ const LEDGER_PURPOSE_MAX = 160;
30
+ /** 账本单条 error 上限(字符):错误文案优先保真,仅在异常长时截断 */
31
+ const LEDGER_ERROR_MAX = 200;
32
+ /** purpose 缺失时的诚实占位(正常不出现:purpose 是必填参数,缺失会在调用期直接报错) */
33
+ const MISSING_PURPOSE = '(purpose not recorded)';
34
+ /**
35
+ * 工具调用账本(`name + purpose` 逐行)——降级时的「做过什么」无损索引。
36
+ *
37
+ * 输出形态:
38
+ * ```
39
+ * - file_edit: Add event-vocabulary disposition to P5 row
40
+ * - shell: Stage explicit paths, commit, and tag v0.98.17
41
+ * ! project_run: test failed (exit 1)
42
+ * ```
43
+ * error 结果附在对应调用行下方(错误可追溯性优先,永不省略)。
44
+ *
45
+ * @param messages - 被降级丢弃的消息
46
+ * @returns 账本文本(可为空串)
47
+ */
48
+ export function buildToolCallLedger(messages) {
49
+ const lines = [];
50
+ // 调用行只从 toolCalls 产出(时间序);错误行从 toolResults 追加到最近一次产出之后,
51
+ // 保证「哪条调用失败」可定位——跨消息配对时以 toolCallId 归位。
52
+ const lineIndexByCallId = new Map();
53
+ for (const msg of messages) {
54
+ for (const tc of msg.toolCalls ?? []) {
55
+ const raw = tc.arguments?.purpose;
56
+ const purpose = typeof raw === 'string' && raw.trim()
57
+ ? raw.trim().slice(0, LEDGER_PURPOSE_MAX)
58
+ : MISSING_PURPOSE;
59
+ lines.push(`- ${tc.name}: ${purpose}`);
60
+ lineIndexByCallId.set(tc.id, lines.length - 1);
61
+ }
62
+ for (const tr of msg.toolResults ?? []) {
63
+ if (lineIndexByCallId.get(tr.toolCallId) === undefined && tr.error === undefined) {
64
+ // 孤儿 result(调用方消息不在本账本范围/未被砍):结果被账本化也必须留痕——
65
+ // name 不可失忆,否则「做过什么」无从追溯(只留 error 行不够)
66
+ lines.push(`- ${tr.name ?? tr.toolCallId}: ${MISSING_PURPOSE}`);
67
+ lineIndexByCallId.set(tr.toolCallId, lines.length - 1);
68
+ }
69
+ if (tr.error === undefined)
70
+ continue;
71
+ const err = tr.error.length > LEDGER_ERROR_MAX ? `${tr.error.slice(0, LEDGER_ERROR_MAX)}…` : tr.error;
72
+ const errorLine = ` ! ${tr.name ?? tr.toolCallId}: ${err}`;
73
+ const at = lineIndexByCallId.get(tr.toolCallId);
74
+ if (at === undefined) {
75
+ // 调用方消息已被丢弃(跨切片降级):错误仍须保留,独立成行——宁可错位,不可丢失
76
+ lines.push(errorLine);
77
+ continue;
78
+ }
79
+ // 紧贴其调用行插入(倒序插入时下标不失效:同一条目只插一次)
80
+ lines.splice(at + 1, 0, errorLine);
81
+ for (const [id, idx] of lineIndexByCallId) {
82
+ if (idx > at)
83
+ lineIndexByCallId.set(id, idx + 1);
84
+ }
85
+ }
86
+ }
87
+ return lines.join('\n');
88
+ }
89
+ /**
90
+ * 账本消息构造(user 角色——中段 system 会被部分网关拒绝)。
91
+ *
92
+ * @param ledger - 账本文本(可为空)
93
+ * @param removedCount - 被替换的消息条数
94
+ * @returns 账本视图消息
95
+ */
96
+ export function asLedgerMessage(ledger, removedCount) {
97
+ const head = `${MECHANICAL_NOTICE_TRUNCATED} ${removedCount} earlier entries replaced by a tool-call ledger to fit context window]`;
98
+ const body = ledger
99
+ ? `[Tool call ledger — do NOT redo these unless explicitly asked]\n${ledger}\n[Tool results and arguments were dropped; re-read files/sources if you need their content. Check session task list via task_* before continuing]`
100
+ : '[No tool calls in the dropped range. Check session task list via task_* before continuing]';
101
+ return {
102
+ role: 'user',
103
+ content: `${head}\n${body}`,
104
+ timestamp: Date.now(),
105
+ // 语义诚实:账本是机械降级产物,**不是**摘要——不得复用 contextSummary 标记,
106
+ // 否则下游(持久化/回放/审计)会把它当交接摘要处理。
107
+ metadata: { source: 'contextLedger' },
108
+ };
109
+ }
110
+ /**
111
+ * 账本截断(保留近尾 + 头部替换为账本)——**物理溢出兜底专用**。
112
+ *
113
+ * 与 `mechanicalDegrade` 的分工:本函数服务「消息必须放回窗口否则请求 400」的场景
114
+ * (overflow 路径),所以在丢头部的同时**保住近尾原文**(最近的现场最值钱);
115
+ * `mechanicalDegrade` 服务「摘要失败」的场景,一次全量转账本。
116
+ *
117
+ * 形态(middle 替换体,外层 head/tail 由调用方拼接):`[账本说明 + 近尾]`。
118
+ * - 保留近尾:预算驱动从头丢弃,但**保底**不破(禁止只留 4 条);
119
+ * - 边界对齐:tool_call/tool_result 对同进同出,保留尾不得起于孤儿结果
120
+ * (孤儿时**回退**切点把调用一并纳入 kept——宁可胖不可拆对;向前跳会把连续
121
+ * tool 结果一路丢光、整段 middle 被吞);
122
+ * - 无可丢弃时原样返回(禁止「0 removed」假通知膨胀)。
123
+ *
124
+ * @param messages - 待降级消息
125
+ * @param opts - targetTokens 预算、估算器、minKeep 保底
126
+ * - targetTokens 缺省不是「不压缩」,而是**只丢到保底**(最大压缩);
127
+ * - minKeep 为**纯保底**(拍板常量,非可调参数):显式传入即用该值(「压到目标」的
128
+ * 机械压缩传 2 = 旧 TruncateCompressor「至少留 2」口径,不叠 15%——叠加会把保 2
129
+ * 架空成 15%、粘滞增量撑胖后在复用轮挤出 overflow 补摘要);缺省 = max(6, 15%)
130
+ * (旧 fallbackTruncate / conservativeTruncate 失败兜底口径)。
131
+ * @returns 截断结果(result 含账本说明或原样 + droppedCount + ledgerKept)
132
+ */
133
+ export function ledgerTruncate(messages, opts) {
134
+ if (messages.length === 0)
135
+ return { result: [], droppedCount: 0, ledgerKept: false };
136
+ // 尺子内建兜底:给了 targetTokens 却无 estimator 时不得静默不截断
137
+ const estimator = opts?.estimator ?? new HeuristicTokenEstimator();
138
+ const floorKeep = opts?.minKeep != null
139
+ ? Math.min(opts.minKeep, messages.length)
140
+ : Math.min(Math.max(6, Math.ceil(messages.length * 0.15)), messages.length);
141
+ // 切片求和逐轮 O(n²) 叠加:内置估算器对单条消息有 WeakMap 缓存(求和=缓存查找,
142
+ // 实测可接受);改为前缀和会改变自定义估算器的预算语义,不值得
143
+ const tokensOf = (ms) => estimator.estimateMessages(ms);
144
+ let cut = 0;
145
+ while (messages.length - cut > floorKeep &&
146
+ (opts?.targetTokens == null || tokensOf(messages.slice(cut)) > opts.targetTokens)) {
147
+ // 对齐:tool_call+tool_result 对同进同出
148
+ const next = messages[cut + 1];
149
+ cut += hasToolCall(messages[cut]) && next !== undefined && isToolResultMessage(next) ? 2 : 1;
150
+ }
151
+ // 保留尾不得起于孤儿结果(其调用已被丢弃):回退切点把调用一并纳入 kept(宁可胖,
152
+ // 不可拆对、不可吞光——向前跳过会在「连续 tool 结果收尾」时把 kept 清空)
153
+ while (cut > 0 && isToolResultMessage(messages[cut])) {
154
+ cut -= 1;
155
+ }
156
+ const dropped = messages.slice(0, cut);
157
+ const kept = messages.slice(cut);
158
+ if (dropped.length === 0) {
159
+ return { result: [...messages], droppedCount: 0, ledgerKept: false };
160
+ }
161
+ const ledger = buildToolCallLedger(dropped);
162
+ const notice = asLedgerMessage(ledger, dropped.length);
163
+ return { result: [notice, ...kept], droppedCount: dropped.length, ledgerKept: ledger.length > 0 };
164
+ }
165
+ /**
166
+ * 机械降级:整段替换为 purpose 账本(零 LLM,单级,无可再降)。
167
+ *
168
+ * @param messages - 待降级消息
169
+ * @param opts - targetTokens(用于判定是否仍需上报超预算)与估算器
170
+ * @returns 降级结果
171
+ * - `result`:单条账本消息(入参为空时为空数组)
172
+ * - `tokensAfter`:账本 token 估算
173
+ * - `overBudget`:账本仍超 targetTokens —— 已无可降空间,调用方须如实上报,
174
+ * 不得再丢条目(丢条目 = 静默失忆)
175
+ * - `droppedSummary`:产物描述
176
+ */
177
+ export function mechanicalDegrade(messages, opts) {
178
+ if (messages.length === 0) {
179
+ return { result: [], tokensAfter: 0, overBudget: false };
180
+ }
181
+ const estimator = opts?.estimator ?? new HeuristicTokenEstimator();
182
+ const ledger = buildToolCallLedger(messages);
183
+ const ledgerMsg = asLedgerMessage(ledger, messages.length);
184
+ const result = [ledgerMsg];
185
+ const tokensAfter = estimator.estimateMessages(result);
186
+ const overBudget = opts?.targetTokens != null && tokensAfter > opts.targetTokens;
187
+ const callCount = messages.reduce((n, m) => n + (m.toolCalls?.length ?? 0), 0);
188
+ return {
189
+ result,
190
+ tokensAfter,
191
+ overBudget,
192
+ droppedSummary: `Replaced ${messages.length} messages (${callCount} tool calls) with a purpose ledger`,
193
+ };
194
+ }
195
+ /**
196
+ * 工具执行账本化(收敛阶梯第 1–3 轮专用,arch/overflow-redesign.md §3)。
197
+ *
198
+ * 语义(丢弃次序原则:数据细节 → 执行记录 → 工作窗口 → 放弃,从最可再生到最不可再生):
199
+ * - **账本化对象 = 工具执行段**(assistant(toolCalls) + tool(result) 对,同进同出)——
200
+ * 执行记录可再生(可重执行/磁盘找回),先于工作窗口丢弃;
201
+ * - **跳过保留**:真 user 消息(最不可再生)、assistant 文本(非执行记录)、
202
+ * 合成消息(contextLedger/contextSummary 占位——已是索引/交接形态,不可再降);
203
+ * - **tailKeep 近尾保护**(工作窗口):近尾 tailKeep 条内的工具执行不账本化。
204
+ *
205
+ * 形态:被账本化 run 的原位移除,**第一个**被砍 run 的下标处放一个合并 notice
206
+ * (buildToolCallLedger 汇总全部被砍执行的 name+purpose+errors)——与 fold 同构:
207
+ * foldTransformView 对多 covers runs 渲染**一个**占位(firstIndex 处、区间内保护类原样),
208
+ * 本函数的产物即 fold 后视图,守门量的与发送的是同一个产物。
209
+ *
210
+ * 每档独立调用(幂等):无候选时原样返回——天然支持「每档对原视图重算」,不累积吞账本。
211
+ *
212
+ * @param messages - 原始视图(收敛循环对同一 view 每档独立调用)
213
+ * @param opts - tailKeep 近尾保护档、估算器、targetTokens(缺省=砍掉全部候选)
214
+ * @returns 产物视图 + 被账本化条数(0=砍不动/无候选)
215
+ */
216
+ export function toolExecutionLedgerTrim(messages, opts) {
217
+ if (messages.length === 0)
218
+ return { result: [], droppedCount: 0 };
219
+ const isSynthetic = (m) => m.metadata?.source === 'contextLedger' || m.metadata?.source === 'contextSummary';
220
+ const isToolExec = (m) => !isSynthetic(m) && (hasToolCall(m) || isToolResultMessage(m));
221
+ // 档位即语义(B2 拍板 2026-11-08):tailKeep 保护窗内的消息原样保留,
222
+ // **窗外工具执行全部账本化**(砍满候选窗)——砍量由档位定义,不在档内提前停;
223
+ // 「装得下吗」由外层 fits 判(校准+aging 同一把尺),砍量尺与验收尺不混。
224
+ const tailFloor = Math.max(0, messages.length - Math.max(0, opts.tailKeep));
225
+ const runs = [];
226
+ let i = 0;
227
+ while (i < tailFloor) {
228
+ if (!isToolExec(messages[i])) {
229
+ i += 1;
230
+ continue;
231
+ }
232
+ const start = i;
233
+ while (i < tailFloor && isToolExec(messages[i]))
234
+ i += 1;
235
+ let end = i - 1;
236
+ // 边界对齐(评审 B1):run 尾是 tool_call 而其 result 在 tail 窗内/窗后时整对不砍——
237
+ // end 允许降到 start-1(单条 run 的 call 与 result 拆对正是孤儿 result 400 的来源)
238
+ while (end >= start && hasToolCall(messages[end]) && end + 1 < messages.length && isToolResultMessage(messages[end + 1])) {
239
+ end -= 1;
240
+ }
241
+ if (end < start)
242
+ continue; // 整对落在 tail 窗内 → 本 run 不砍(宁可少砍,不可拆对)
243
+ runs.push({ start, end });
244
+ }
245
+ if (runs.length === 0)
246
+ return { result: [...messages], droppedCount: 0 };
247
+ // 砍满:全部候选 run 一次账本化(每档对原视图独立、幂等——累积截断会吞前轮账本)
248
+ const droppedIdx = new Set();
249
+ for (const r of runs)
250
+ for (let k = r.start; k <= r.end; k++)
251
+ droppedIdx.add(k);
252
+ const droppedMsgs = runs.flatMap((r) => messages.slice(r.start, r.end + 1));
253
+ const ledger = buildToolCallLedger(droppedMsgs);
254
+ const notice = asLedgerMessage(ledger, droppedMsgs.length);
255
+ const result = [];
256
+ let noticePlaced = false;
257
+ for (let idx = 0; idx < messages.length; idx++) {
258
+ if (droppedIdx.has(idx)) {
259
+ if (!noticePlaced) {
260
+ result.push(notice);
261
+ noticePlaced = true;
262
+ }
263
+ continue;
264
+ }
265
+ result.push(messages[idx]);
266
+ }
267
+ return { result, droppedCount: droppedMsgs.length };
268
+ }
@@ -0,0 +1,60 @@
1
+ /**
2
+ * 视图消息构造 — 摘要包装与机械占位的唯一实现
3
+ *
4
+ * 摘要包装(`[Conversation Summary]`)与机械占位说明(`[Context truncated:` 等)
5
+ * 此前散落在 llm-summarizer / truncate-compressor / default-context-engine 等 ~6 处
6
+ * (债务 #4)。收敛后:文案、包装、识别全部单源于本模块——**生产者与识别串同源**,
7
+ * 新增占位类型时不得绕过这里手写字面量。
8
+ *
9
+ * @module harness/context/capabilities/compact/messages
10
+ */
11
+ import type { Message } from '@octopi-agent/core/types.js';
12
+ /**
13
+ * 是否工具结果消息(role=tool 或携带 toolResults)。
14
+ *
15
+ * @param msg - 候选消息
16
+ * @returns 是否工具结果消息
17
+ */
18
+ export declare function isToolResultMessage(msg: Message): boolean;
19
+ /**
20
+ * 是否携带工具调用的 assistant 消息(机械阶梯/消息选择器的对齐判别用;
21
+ * 切片对齐 alignViewSplit 沿用旧引擎的无角色判别以保持逐字节行为)。
22
+ *
23
+ * @param msg - 候选消息
24
+ * @returns 是否携带 toolCalls
25
+ */
26
+ export declare function hasToolCall(msg: Message): boolean;
27
+ /** 摘要标记(extract / 调试 / 幂等包装判别共用) */
28
+ export declare const SUMMARY_MARKER = "[Conversation Summary]";
29
+ /**
30
+ * 摘要正文包装:确保带 `[Conversation Summary]` 标记(幂等)。
31
+ *
32
+ * @param text - 摘要正文
33
+ * @returns 带标记的摘要正文
34
+ */
35
+ export declare function wrapSummaryText(text: string): string;
36
+ /**
37
+ * 摘要消息构造(user 角色——中段 system 会被部分网关拒绝)。
38
+ *
39
+ * 覆盖边界行(评审 F11)按覆盖点动态渲染,**不写进摘要正文**:
40
+ * 写进正文会把过期数字烘死、随失败累积、还会被当 Previous summary 回喂模型。
41
+ *
42
+ * @param summary - 摘要正文
43
+ * @param coveredEnd - 摘要覆盖终点(下标,不含);>0 时附 [Coverage] 行
44
+ * @returns 摘要视图消息
45
+ */
46
+ export declare function asSummaryMessage(summary: string, coveredEnd?: number): Message;
47
+ /** 账本降级占位(生产者:mechanical.ts ledgerTruncate / mechanicalDegrade) */
48
+ export declare const MECHANICAL_NOTICE_TRUNCATED = "[Context truncated:";
49
+ /** 头切截断占位(生产者已随 TruncateCompressor 退休;识别保留兜旧持久化状态) */
50
+ export declare const MECHANICAL_NOTICE_COMPRESSED = "[Context compressed:";
51
+ /** 结构压缩占位(生产者:compact 引擎 head_tail_only / 文本结构路径) */
52
+ export declare const MECHANICAL_NOTICE_STRUCTURAL = "[Structural compact]";
53
+ /**
54
+ * 机械降级占位说明判别(非语义摘要):首条实质行以占位标记开头即认定。
55
+ * 只看首行而非全文 includes——真实摘要引用这些字符串(如记录「曾发生截断」)不得被误杀。
56
+ *
57
+ * @param text - 候选摘要正文
58
+ * @returns 是否为机械占位说明
59
+ */
60
+ export declare function isMechanicalNotice(text: string): boolean;
@@ -0,0 +1,91 @@
1
+ /**
2
+ * 视图消息构造 — 摘要包装与机械占位的唯一实现
3
+ *
4
+ * 摘要包装(`[Conversation Summary]`)与机械占位说明(`[Context truncated:` 等)
5
+ * 此前散落在 llm-summarizer / truncate-compressor / default-context-engine 等 ~6 处
6
+ * (债务 #4)。收敛后:文案、包装、识别全部单源于本模块——**生产者与识别串同源**,
7
+ * 新增占位类型时不得绕过这里手写字面量。
8
+ *
9
+ * @module harness/context/capabilities/compact/messages
10
+ */
11
+ // ── 消息形状谓词(切片手术与机械阶梯共用) ──
12
+ /**
13
+ * 是否工具结果消息(role=tool 或携带 toolResults)。
14
+ *
15
+ * @param msg - 候选消息
16
+ * @returns 是否工具结果消息
17
+ */
18
+ export function isToolResultMessage(msg) {
19
+ return msg.role === 'tool' || (msg.toolResults?.length ?? 0) > 0;
20
+ }
21
+ /**
22
+ * 是否携带工具调用的 assistant 消息(机械阶梯/消息选择器的对齐判别用;
23
+ * 切片对齐 alignViewSplit 沿用旧引擎的无角色判别以保持逐字节行为)。
24
+ *
25
+ * @param msg - 候选消息
26
+ * @returns 是否携带 toolCalls
27
+ */
28
+ export function hasToolCall(msg) {
29
+ return msg.role === 'assistant' && (msg.toolCalls?.length ?? 0) > 0;
30
+ }
31
+ // ── 摘要包装(族 A 交接摘要的视图载体) ──
32
+ /** 摘要标记(extract / 调试 / 幂等包装判别共用) */
33
+ export const SUMMARY_MARKER = '[Conversation Summary]';
34
+ /**
35
+ * 摘要正文包装:确保带 `[Conversation Summary]` 标记(幂等)。
36
+ *
37
+ * @param text - 摘要正文
38
+ * @returns 带标记的摘要正文
39
+ */
40
+ export function wrapSummaryText(text) {
41
+ const trimmed = text.trim();
42
+ if (trimmed.includes(SUMMARY_MARKER))
43
+ return trimmed;
44
+ return `${SUMMARY_MARKER}\n\n${trimmed}`;
45
+ }
46
+ /**
47
+ * 摘要消息构造(user 角色——中段 system 会被部分网关拒绝)。
48
+ *
49
+ * 覆盖边界行(评审 F11)按覆盖点动态渲染,**不写进摘要正文**:
50
+ * 写进正文会把过期数字烘死、随失败累积、还会被当 Previous summary 回喂模型。
51
+ *
52
+ * @param summary - 摘要正文
53
+ * @param coveredEnd - 摘要覆盖终点(下标,不含);>0 时附 [Coverage] 行
54
+ * @returns 摘要视图消息
55
+ */
56
+ export function asSummaryMessage(summary, coveredEnd) {
57
+ const coverage = coveredEnd && coveredEnd > 0
58
+ ? `\n\n[Coverage] This handoff covers the conversation up to message ${coveredEnd}; later messages appear verbatim and take precedence.`
59
+ : '';
60
+ return {
61
+ role: 'user',
62
+ content: wrapSummaryText(`${summary}${coverage}`),
63
+ timestamp: Date.now(),
64
+ metadata: { source: 'contextSummary' },
65
+ };
66
+ }
67
+ // ── 机械占位(非摘要,永不进 previousSummary) ──
68
+ /** 账本降级占位(生产者:mechanical.ts ledgerTruncate / mechanicalDegrade) */
69
+ export const MECHANICAL_NOTICE_TRUNCATED = '[Context truncated:';
70
+ /** 头切截断占位(生产者已随 TruncateCompressor 退休;识别保留兜旧持久化状态) */
71
+ export const MECHANICAL_NOTICE_COMPRESSED = '[Context compressed:';
72
+ /** 结构压缩占位(生产者:compact 引擎 head_tail_only / 文本结构路径) */
73
+ export const MECHANICAL_NOTICE_STRUCTURAL = '[Structural compact]';
74
+ /**
75
+ * 机械降级占位说明判别(非语义摘要):首条实质行以占位标记开头即认定。
76
+ * 只看首行而非全文 includes——真实摘要引用这些字符串(如记录「曾发生截断」)不得被误杀。
77
+ *
78
+ * @param text - 候选摘要正文
79
+ * @returns 是否为机械占位说明
80
+ */
81
+ export function isMechanicalNotice(text) {
82
+ for (const raw of text.split('\n')) {
83
+ const line = raw.trim();
84
+ if (!line || line === SUMMARY_MARKER)
85
+ continue;
86
+ return (line.startsWith(MECHANICAL_NOTICE_TRUNCATED) ||
87
+ line.startsWith(MECHANICAL_NOTICE_COMPRESSED) ||
88
+ line.startsWith(MECHANICAL_NOTICE_STRUCTURAL));
89
+ }
90
+ return false;
91
+ }