@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
@@ -5,7 +5,7 @@
5
5
  * Level 0: FATAL — 系统崩溃
6
6
  * Level 1: ERROR — 功能异常(空回复、工具失败)
7
7
  * Level 2: WARN — 可降级问题(重试、fallback)
8
- * Level 3: INFO — 关键节点(turn 开始/结束、tool 调用)
8
+ * Level 3: INFO — 关键节点(step 开始/结束、tool 调用)
9
9
  * Level 4: DEBUG — 完整数据(消息内容、token 统计)
10
10
  * Level 5: TRACE — 底层细节(原始 API 请求/响应、流式 chunk)
11
11
  */
@@ -39,8 +39,8 @@ export interface TraceEvent {
39
39
  export declare const TRACE_EVENTS: {
40
40
  readonly ENGINE_START: "engine.start";
41
41
  readonly ENGINE_END: "engine.end";
42
- readonly TURN_START: "turn.start";
43
- readonly TURN_END: "turn.end";
42
+ readonly STEP_START: "step.start";
43
+ readonly STEP_END: "step.end";
44
44
  readonly MODEL_CALL_START: "model.call.start";
45
45
  readonly MODEL_CALL_END: "model.call.end";
46
46
  readonly TOOL_EXEC_START: "tool.exec.start";
@@ -5,7 +5,7 @@
5
5
  * Level 0: FATAL — 系统崩溃
6
6
  * Level 1: ERROR — 功能异常(空回复、工具失败)
7
7
  * Level 2: WARN — 可降级问题(重试、fallback)
8
- * Level 3: INFO — 关键节点(turn 开始/结束、tool 调用)
8
+ * Level 3: INFO — 关键节点(step 开始/结束、tool 调用)
9
9
  * Level 4: DEBUG — 完整数据(消息内容、token 统计)
10
10
  * Level 5: TRACE — 底层细节(原始 API 请求/响应、流式 chunk)
11
11
  */
@@ -34,8 +34,8 @@ export const TRACE_EVENTS = {
34
34
  // Level 3: INFO — 关键节点
35
35
  ENGINE_START: 'engine.start',
36
36
  ENGINE_END: 'engine.end',
37
- TURN_START: 'turn.start',
38
- TURN_END: 'turn.end',
37
+ STEP_START: 'step.start',
38
+ STEP_END: 'step.end',
39
39
  MODEL_CALL_START: 'model.call.start',
40
40
  MODEL_CALL_END: 'model.call.end',
41
41
  TOOL_EXEC_START: 'tool.exec.start',
@@ -0,0 +1,20 @@
1
+ /**
2
+ * Anthropic Messages 线上编码归一化
3
+ *
4
+ * 背景(2026-11-12):引擎的历史形态天然会产生**连续 user** 消息——`tool_result` 块
5
+ * 后面接摘要占位、摘要占位后接 `turn_start`、`turn_end` 后接 `turn_start`。实测一个
6
+ * 765 条消息的会话里有 17 处。Anthropic 官方会把连续同角色合并,但严格端点(火山等
7
+ * anthropic-messages 代理)只回通用 InvalidParameter,不指出 param,排查成本极高。
8
+ *
9
+ * @module integration/providers/anthropic-message-normalize
10
+ */
11
+ /**
12
+ * 合并相邻同角色消息(Anthropic Messages 要求 user/assistant 交替)。
13
+ *
14
+ * 只动**线上编码**,不改变语义顺序:同角色的 content 块按原顺序拼接。非合并位置保持
15
+ * 原有形态(纯文本消息仍是字符串),把字节变化限制在真正需要合并的点。
16
+ *
17
+ * @param messages - 已转换的 Anthropic 消息(role + content)
18
+ * @returns 角色交替的消息列表(新数组,输入不被修改)
19
+ */
20
+ export declare function mergeConsecutiveSameRole(messages: Array<Record<string, unknown>>): Array<Record<string, unknown>>;
@@ -0,0 +1,48 @@
1
+ /**
2
+ * Anthropic Messages 线上编码归一化
3
+ *
4
+ * 背景(2026-11-12):引擎的历史形态天然会产生**连续 user** 消息——`tool_result` 块
5
+ * 后面接摘要占位、摘要占位后接 `turn_start`、`turn_end` 后接 `turn_start`。实测一个
6
+ * 765 条消息的会话里有 17 处。Anthropic 官方会把连续同角色合并,但严格端点(火山等
7
+ * anthropic-messages 代理)只回通用 InvalidParameter,不指出 param,排查成本极高。
8
+ *
9
+ * @module integration/providers/anthropic-message-normalize
10
+ */
11
+ /**
12
+ * 合并相邻同角色消息(Anthropic Messages 要求 user/assistant 交替)。
13
+ *
14
+ * 只动**线上编码**,不改变语义顺序:同角色的 content 块按原顺序拼接。非合并位置保持
15
+ * 原有形态(纯文本消息仍是字符串),把字节变化限制在真正需要合并的点。
16
+ *
17
+ * @param messages - 已转换的 Anthropic 消息(role + content)
18
+ * @returns 角色交替的消息列表(新数组,输入不被修改)
19
+ */
20
+ export function mergeConsecutiveSameRole(messages) {
21
+ const result = [];
22
+ for (const msg of messages) {
23
+ const last = result[result.length - 1];
24
+ if (!last || last.role !== msg.role) {
25
+ result.push({ ...msg });
26
+ continue;
27
+ }
28
+ // 同角色相邻:content 统一成块数组后拼接(字符串视作单个 text 块)
29
+ last.content = [...toContentBlocks(last.content), ...toContentBlocks(msg.content)];
30
+ }
31
+ return result;
32
+ }
33
+ /**
34
+ * content 归一化为块数组
35
+ *
36
+ * @param content - Anthropic content(字符串 / 块数组 / 空)
37
+ * @returns 块数组(空内容 → 空数组)
38
+ */
39
+ function toContentBlocks(content) {
40
+ if (Array.isArray(content))
41
+ return content;
42
+ if (typeof content === 'string') {
43
+ return content.length > 0 ? [{ type: 'text', text: content }] : [];
44
+ }
45
+ if (content == null)
46
+ return [];
47
+ return [{ type: 'text', text: String(content) }];
48
+ }
@@ -18,8 +18,11 @@
18
18
  * 实现 ModelProvider 接口。
19
19
  */
20
20
  import { tokenUsageFromAnthropic } from './usage.js';
21
+ import { mergeConsecutiveSameRole } from './anthropic-message-normalize.js';
21
22
  import { attachHttpStatus, attachStreamDiag, createStreamDiag, recordWireBytes, } from './provider-diagnostics.js';
22
23
  import { createTimeoutDispatcher, providerFetch } from './fetch-timeout.js';
24
+ /** thinkingLevel → extended thinking 预算档位(适配器语义;自定义预算走方言插件 options) */
25
+ const THINKING_BUDGET_TOKENS = { low: 2048, medium: 8192, high: 24576 };
23
26
  /**
24
27
  * Anthropic Messages Provider
25
28
  *
@@ -54,12 +57,18 @@ export class AnthropicProvider {
54
57
  }
55
58
  else {
56
59
  this.models.push(entry.name);
57
- if (entry.contextWindow != null || entry.maxOutputTokens != null || entry.temperature != null) {
60
+ if (entry.contextWindow != null ||
61
+ entry.maxOutputTokens != null ||
62
+ entry.temperature != null ||
63
+ entry.reasoning != null ||
64
+ entry.input != null) {
58
65
  this.modelInfoMap.set(entry.name, {
59
66
  name: entry.name,
60
67
  contextWindow: entry.contextWindow,
61
68
  maxOutputTokens: entry.maxOutputTokens,
62
69
  temperature: entry.temperature,
70
+ reasoning: entry.reasoning,
71
+ input: entry.input,
63
72
  });
64
73
  }
65
74
  }
@@ -353,6 +362,13 @@ export class AnthropicProvider {
353
362
  */
354
363
  toAnthropicRequest(request) {
355
364
  const systemMessages = request.messages.filter((m) => m.role === 'system');
365
+ // 契约断言:system 至多一条(托管 systemPrompt)。多条 = 上游装配契约违约
366
+ //(非托管 system 漏过反向围栏)。库语境无可靠 NODE_ENV,生产 throw 会把可容错
367
+ // 情况升级成运行失败——故此处告警 + 按序拼接容错,开发期严格性由单测断言保证
368
+ //(测试红线:违约输入必须触发告警且请求可发)。
369
+ if (systemMessages.length > 1) {
370
+ console.warn(`[octopi] anthropic adapter: contract violation — ${systemMessages.length} system messages in LLM view (expected at most 1); joining for compatibility`);
371
+ }
356
372
  const nonSystemMessages = request.messages.filter((m) => m.role !== 'system');
357
373
  const systemPrompt = systemMessages.map((m) => String(m.content ?? '')).join('\n\n');
358
374
  const messages = this.toAnthropicMessages(nonSystemMessages);
@@ -372,10 +388,29 @@ export class AnthropicProvider {
372
388
  if (systemPrompt) {
373
389
  anthropicRequest.system = systemPrompt;
374
390
  }
391
+ // thinkingLevel → extended thinking(P5 参数映射);off/undefined 不发送。
392
+ // 档位→budget_tokens 为适配器语义;自定义预算走方言插件 options。
393
+ // extended thinking 要求 temperature=1(可省略)
394
+ let thinkingBudget;
395
+ if (request.thinkingLevel !== undefined && request.thinkingLevel !== 'off') {
396
+ if (modelInfo?.reasoning === false) {
397
+ throw new Error(`Model "${modelName}" declares no reasoning support; cannot honor thinkingLevel "${request.thinkingLevel}"`);
398
+ }
399
+ thinkingBudget = THINKING_BUDGET_TOKENS[request.thinkingLevel];
400
+ if (maxTokens <= thinkingBudget) {
401
+ const limitedByCap = modelInfo?.maxOutputTokens !== undefined && modelInfo.maxOutputTokens <= thinkingBudget;
402
+ throw new Error(`thinkingLevel "${request.thinkingLevel}" budgets ${thinkingBudget} tokens but max_tokens is ${maxTokens}` +
403
+ (limitedByCap ? `; model cap ${modelInfo.maxOutputTokens} is too low for this level` : '; raise maxTokens'));
404
+ }
405
+ anthropicRequest.thinking = { type: 'enabled', budget_tokens: thinkingBudget };
406
+ }
375
407
  if (request.temperature !== undefined) {
408
+ if (thinkingBudget !== undefined && request.temperature !== 1) {
409
+ throw new Error('Anthropic extended thinking requires temperature 1');
410
+ }
376
411
  anthropicRequest.temperature = request.temperature;
377
412
  }
378
- else if (modelInfo?.temperature !== undefined) {
413
+ else if (thinkingBudget === undefined && modelInfo?.temperature !== undefined) {
379
414
  // 请求未指定时采用模型级配置;两者都未配置则不发送该参数(交给服务端默认)
380
415
  anthropicRequest.temperature = modelInfo.temperature;
381
416
  }
@@ -414,7 +449,10 @@ export class AnthropicProvider {
414
449
  i--;
415
450
  result.push({ role: 'user', content: blocks });
416
451
  }
417
- return result;
452
+ // 角色交替归一(2026-11-12):引擎历史天然产生连续 user(tool_result → 摘要占位、
453
+ // 摘要占位 → turn_start、turn_end → turn_start);严格 anthropic-messages 端点
454
+ // 只回通用 InvalidParameter,故在适配器出口统一合并。
455
+ return mergeConsecutiveSameRole(result);
418
456
  }
419
457
  /**
420
458
  * 将 OpenAI 消息格式转换为 Anthropic 消息格式
@@ -40,3 +40,20 @@ export declare const providerFetch: typeof undiciFetch;
40
40
  * @returns undici Agent,作为 fetch 的 `dispatcher` 传入
41
41
  */
42
42
  export declare function createTimeoutDispatcher(timeoutMs: number): Agent;
43
+ /**
44
+ * 创建「响应体静默合法」的 dispatcher(用于长事件流,如 run 的 NDJSON 流)。
45
+ *
46
+ * 与 {@link createTimeoutDispatcher} 的差别只在 `bodyTimeout`:这里**禁用**它。
47
+ *
48
+ * 为什么必须禁用:长流在工具执行期间**合法静默**——`timer_wait` 可以等 30 分钟,期间流上
49
+ * 零字节。而 undici 的 `bodyTimeout` 默认 300_000ms(`lib/dispatcher/client.js`:
50
+ * `this[kBodyTimeout] = bodyTimeout != null ? bodyTimeout : 300e3`),静默到点即抛
51
+ * `TypeError: terminated`,且**与是否传 AbortSignal 无关**。后果是把「工具还在跑」报成
52
+ * 网关故障,前端也永远收不到 `tool.end`(表现为 timer 一直 running)。
53
+ *
54
+ * 需要上限的是**首字节**,由 `headersTimeout` 覆盖——那才是「对端没接上/没响应」的信号。
55
+ *
56
+ * @param headersTimeoutMs - 连接 + 响应头预算(毫秒)
57
+ * @returns undici Agent,作为 `providerFetch` 的 `dispatcher` 传入
58
+ */
59
+ export declare function createStreamDispatcher(headersTimeoutMs: number): Agent;
@@ -49,3 +49,27 @@ export function createTimeoutDispatcher(timeoutMs) {
49
49
  // 而不是把连接建立也拖到 provider 超时量级
50
50
  });
51
51
  }
52
+ /**
53
+ * 创建「响应体静默合法」的 dispatcher(用于长事件流,如 run 的 NDJSON 流)。
54
+ *
55
+ * 与 {@link createTimeoutDispatcher} 的差别只在 `bodyTimeout`:这里**禁用**它。
56
+ *
57
+ * 为什么必须禁用:长流在工具执行期间**合法静默**——`timer_wait` 可以等 30 分钟,期间流上
58
+ * 零字节。而 undici 的 `bodyTimeout` 默认 300_000ms(`lib/dispatcher/client.js`:
59
+ * `this[kBodyTimeout] = bodyTimeout != null ? bodyTimeout : 300e3`),静默到点即抛
60
+ * `TypeError: terminated`,且**与是否传 AbortSignal 无关**。后果是把「工具还在跑」报成
61
+ * 网关故障,前端也永远收不到 `tool.end`(表现为 timer 一直 running)。
62
+ *
63
+ * 需要上限的是**首字节**,由 `headersTimeout` 覆盖——那才是「对端没接上/没响应」的信号。
64
+ *
65
+ * @param headersTimeoutMs - 连接 + 响应头预算(毫秒)
66
+ * @returns undici Agent,作为 `providerFetch` 的 `dispatcher` 传入
67
+ */
68
+ export function createStreamDispatcher(headersTimeoutMs) {
69
+ return new Agent({
70
+ headersTimeout: headersTimeoutMs,
71
+ // 0 = 禁用:流上的静默由业务层(工具预算 / run 生命周期)决定,不由 transport 猜
72
+ bodyTimeout: 0,
73
+ allowH2: false,
74
+ });
75
+ }
@@ -78,6 +78,14 @@ export declare class OpenAIProvider implements ModelProvider {
78
78
  stream(request: LLMRequest): AsyncGenerator<LLMStreamChunk>;
79
79
  /**
80
80
  * 检查 provider 是否可用
81
+ *
82
+ * 先探 `GET {baseUrl}/models`(免费、顺手);拿不到清单时再用一次最小对话请求
83
+ * 判定真实连通——`/models` 不是 OpenAI 兼容面的承诺路由:Mistral 的
84
+ * `/openai/v1`、Gemini 的 `/v1beta/openai` 都没有它,而火山方舟这类网关
85
+ * **先鉴权后路由**,未知路径同样回 401。
86
+ *
87
+ * 因此 404 / 401 / 403 / 405 时不直接下结论,交给对话探针:
88
+ * 对话通过(2xx 或 400/422)才算可用;对话 401/403 才判鉴权失败。
81
89
  */
82
90
  isAvailable(): Promise<boolean>;
83
91
  /**
@@ -51,12 +51,18 @@ export class OpenAIProvider {
51
51
  }
52
52
  else {
53
53
  this.models.push(entry.name);
54
- if (entry.contextWindow != null || entry.maxOutputTokens != null || entry.temperature != null) {
54
+ if (entry.contextWindow != null ||
55
+ entry.maxOutputTokens != null ||
56
+ entry.temperature != null ||
57
+ entry.reasoning != null ||
58
+ entry.input != null) {
55
59
  this.modelInfoMap.set(entry.name, {
56
60
  name: entry.name,
57
61
  contextWindow: entry.contextWindow,
58
62
  maxOutputTokens: entry.maxOutputTokens,
59
63
  temperature: entry.temperature,
64
+ reasoning: entry.reasoning,
65
+ input: entry.input,
60
66
  });
61
67
  }
62
68
  }
@@ -235,6 +241,14 @@ export class OpenAIProvider {
235
241
  }
236
242
  /**
237
243
  * 检查 provider 是否可用
244
+ *
245
+ * 先探 `GET {baseUrl}/models`(免费、顺手);拿不到清单时再用一次最小对话请求
246
+ * 判定真实连通——`/models` 不是 OpenAI 兼容面的承诺路由:Mistral 的
247
+ * `/openai/v1`、Gemini 的 `/v1beta/openai` 都没有它,而火山方舟这类网关
248
+ * **先鉴权后路由**,未知路径同样回 401。
249
+ *
250
+ * 因此 404 / 401 / 403 / 405 时不直接下结论,交给对话探针:
251
+ * 对话通过(2xx 或 400/422)才算可用;对话 401/403 才判鉴权失败。
238
252
  */
239
253
  async isAvailable() {
240
254
  try {
@@ -243,7 +257,31 @@ export class OpenAIProvider {
243
257
  signal: AbortSignal.timeout(5000),
244
258
  dispatcher: this.dispatcher,
245
259
  });
246
- return response.ok;
260
+ if (response.ok)
261
+ return true;
262
+ const probeModel = this.defaultModel ?? this.models[0];
263
+ // 5xx / 429 是端点自身状态,不拿探针掩盖
264
+ const ambiguous = response.status === 404 || response.status === 401
265
+ || response.status === 403 || response.status === 405;
266
+ if (!ambiguous || !probeModel)
267
+ return false;
268
+ const probe = await this.fetch(`${this.baseUrl}/chat/completions`, {
269
+ method: 'POST',
270
+ headers: {
271
+ 'Authorization': `Bearer ${this.apiKey}`,
272
+ 'content-type': 'application/json',
273
+ },
274
+ body: JSON.stringify({
275
+ model: probeModel,
276
+ messages: [{ role: 'user', content: 'ping' }],
277
+ max_tokens: 1,
278
+ stream: false,
279
+ }),
280
+ signal: AbortSignal.timeout(5000),
281
+ dispatcher: this.dispatcher,
282
+ });
283
+ // 400/422 = 鉴权与路由都通,只是请求内容(如模型名)被拒;连通成立。
284
+ return probe.ok || probe.status === 400 || probe.status === 422;
247
285
  }
248
286
  catch {
249
287
  return false;
@@ -299,6 +337,14 @@ export class OpenAIProvider {
299
337
  else if (cap) {
300
338
  body.max_tokens = cap;
301
339
  }
340
+ // thinkingLevel → reasoning_effort(P5 参数映射);off/undefined 不发送。
341
+ // 模型明确声明 reasoning:false 时拒绝显式思考请求;未声明不猜测,交服务端裁决
342
+ if (request.thinkingLevel !== undefined && request.thinkingLevel !== 'off') {
343
+ if (modelInfo?.reasoning === false) {
344
+ throw new Error(`Model "${String(body.model)}" declares no reasoning support; cannot honor thinkingLevel "${request.thinkingLevel}"`);
345
+ }
346
+ body.reasoning_effort = request.thinkingLevel;
347
+ }
302
348
  if (request.tools && request.tools.length > 0) {
303
349
  // 兼容接口可能拒绝 maxLength 等未知 schema 关键字
304
350
  body.tools = request.tools.map((tool) => {
@@ -3,7 +3,7 @@
3
3
  *
4
4
  * @module integration/providers/usage
5
5
  */
6
- import type { TokenUsage } from '@octopi-agent/core/types/turn.js';
6
+ import type { TokenUsage } from '@octopi-agent/core/types/step.js';
7
7
  /**
8
8
  * OpenAI / OpenAI-compatible usage
9
9
  *
@@ -11,6 +11,7 @@
11
11
  */
12
12
  import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
13
13
  import { join } from 'node:path';
14
+ import { AGED_POINTER_PREFIX } from '@octopi-agent/core/elision.js';
14
15
  import { wireUnitPayloads, } from './wire-dump.js';
15
16
  /**
16
17
  * 读取 session 目录里第一条 request 记录(用于按真实 sessionId 匹配被 sanitize 过的目录名)
@@ -186,7 +187,7 @@ export function compareWireCalls(prev, next) {
186
187
  };
187
188
  }
188
189
  /** 历史老化指针的固定前缀(见 harness/context 的 aging 输出) */
189
- const AGED_POINTER_MARKER = '[aged tool result · pointer]';
190
+ const AGED_POINTER_MARKER = AGED_POINTER_PREFIX;
190
191
  /**
191
192
  * 统计两次调用之间的历史老化(原文 → 指针)情况
192
193
  *
@@ -17,7 +17,7 @@
17
17
  *
18
18
  * @module integration/providers/wire-dump
19
19
  */
20
- import type { TokenUsage } from '@octopi-agent/core/types/turn.js';
20
+ import type { TokenUsage } from '@octopi-agent/core/types/step.js';
21
21
  import type { LLMRequest, ModelProvider } from '@octopi-agent/core/interfaces/model-provider.js';
22
22
  /** 调用方身份(由 harness 侧解析,integration 不反向依赖 harness) */
23
23
  export interface WireDumpContext {
@@ -108,9 +108,51 @@ export interface WireCallResponseInfo {
108
108
  text?: string;
109
109
  /** 推理增量汇总(同截断;部分拒答只留 reasoning,须一并留痕) */
110
110
  reasoning?: string;
111
+ /** 响应中的工具调用原始留痕(见 {@link WireToolCallTrace}) */
112
+ toolCalls?: WireToolCallTrace[];
111
113
  /** 结束原因(stop / tool_calls / length / error) */
112
114
  finishReason?: string;
113
115
  }
116
+ /**
117
+ * 响应中的工具调用原始留痕(OP-TOOL-1)
118
+ *
119
+ * 用途:OP-TOOL-1 事故(工具执行参数被 `…[N chars]` 降级标记污染)无法裁决
120
+ * 「标记是模型原始输出就有,还是引擎在派发前替换」——请求 dump 只有输入侧,
121
+ * 缺响应侧 tool_call 原文。这里把模型输出的 arguments **原文**留痕,
122
+ * 复现时与会话落盘/实际执行的参数逐字对比即可一锤定音。
123
+ */
124
+ export interface WireToolCallTrace {
125
+ /** tool_call id(会话落盘的对账主键;缺失时按 index 聚合并标 ambiguous) */
126
+ id?: string;
127
+ name: string;
128
+ /**
129
+ * 模型原始 arguments 文本(stream 按增量拼接的原文;chat 无原文可用时
130
+ * 为解析后对象的 JSON 序列化——此时非逐字节原始,以 `raw: false` 标注)
131
+ */
132
+ arguments: string;
133
+ /**
134
+ * arguments 全长(字符;`arguments` 被截断时大于其长度)。raw:true 时为
135
+ * 原文长度;raw:false 时为序列化长度(非原文,长度指纹仅供参考)
136
+ */
137
+ argumentsChars: number;
138
+ /** arguments 超出 {@link TOOL_CALL_ARGS_CAPTURE_CAP} 被显式截断(头+尾保全,绝不静默) */
139
+ truncated?: true;
140
+ /** arguments 是否为逐字节原文(stream=true;chat 序列化=false) */
141
+ raw: boolean;
142
+ /** 模型输出的 arguments 是非法 JSON、解析侧已丢原文(chat 路径的最坏情况,显式标注) */
143
+ parseError?: true;
144
+ /** 无法可靠区分 tool_call 边界(id 与 index 全缺时的聚合):内容可能混入多条调用 */
145
+ ambiguous?: true;
146
+ /** 流是否完整走到 done(false = 断流/提前退出,args 可能只是半截,勿当全量证据) */
147
+ complete?: boolean;
148
+ }
149
+ /**
150
+ * 单条 tool_call arguments 留痕上限(字符):超出则头+尾保全、中间显式省略
151
+ * (降级标记是尾锚定形态,只留头部会挖掉唯一需要的证据——OP-TOOL-1 评审 M6)。
152
+ * 与 {@link RESPONSE_CAPTURE_HARD_CAP} 同为捕获护栏常数;如运营上需要按部署
153
+ * 调整再升配置字段(wire-dump 既有硬护栏先例:MAX_ERROR_MESSAGE_CHARS)。
154
+ */
155
+ export declare const TOOL_CALL_ARGS_CAPTURE_CAP = 65536;
114
156
  /** 单次调用的收尾句柄 */
115
157
  export interface WireCallHandle {
116
158
  id: string;
@@ -189,8 +231,20 @@ export declare function defaultWireDumpDir(): string;
189
231
  /**
190
232
  * 从 wire body 提取前缀单元文本(比对与落盘的唯一权威顺序)
191
233
  *
192
- * - OpenAI:`body.messages`
193
- * - Anthropic:顶层 `system`(字符串)+ `body.messages`;system 在 wire 语义上位于最前
234
+ * **本函数的单元序列 ≠ token 顺序**:缓存前缀的真实顺序是 `tools → system → messages`,
235
+ * 而这里只产出 `system → messages`,tools 另记 `toolsHash`(见 {@link extractWireUnits}
236
+ * 调用点)。tools 不能作为单元加入本序列:它一变整条前缀即失效,已由 diff 的
237
+ * `toolsChanged → cacheableChars=0` 单独裁决,重复计入会把 stableChars 算错。
238
+ *
239
+ * dump 落盘 body 的 JSON **key 顺序**(`model/max_tokens/messages/system/tools`)只是
240
+ * provider 代码里对象字面量的书写顺序,被 `JSON.stringify` 保留下来,
241
+ * **同样不是 token 顺序**——翻看 dump 时若按 key 先后推断缓存结构会得出相反结论
242
+ * (实测:摘要请求未命中仅 6,890 token = 尾部新增两条消息,system+tools 的 94,949
243
+ * 字符一次未重算)。
244
+ *
245
+ * - OpenAI 形态:`body.messages`(system 作为 messages[0])
246
+ * - Anthropic 形态:顶层 `system`(字符串)+ `body.messages`;system 在 wire 语义
247
+ * 上位于**messages 之前**(但仍晚于 tools)
194
248
  *
195
249
  * @param body - provider 实际发送的请求体
196
250
  * @returns 前缀单元(role + 该单元 JSON 文本)
@@ -20,9 +20,33 @@
20
20
  import { createHash, randomBytes } from 'node:crypto';
21
21
  import { appendFileSync, existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync, writeFileSync } from 'node:fs';
22
22
  import { join } from 'node:path';
23
+ import { elidedCharsMarker } from '@octopi-agent/core/elision.js';
23
24
  import { getOctopiHome } from '../../paths.js';
24
25
  import { readHttpStatus, readStreamDiag, } from './provider-diagnostics.js';
25
26
  import { readAttemptBudgetExhausted } from '../../harness/run/reliability/fallback-provider.js';
27
+ /**
28
+ * 单条 tool_call arguments 留痕上限(字符):超出则头+尾保全、中间显式省略
29
+ * (降级标记是尾锚定形态,只留头部会挖掉唯一需要的证据——OP-TOOL-1 评审 M6)。
30
+ * 与 {@link RESPONSE_CAPTURE_HARD_CAP} 同为捕获护栏常数;如运营上需要按部署
31
+ * 调整再升配置字段(wire-dump 既有硬护栏先例:MAX_ERROR_MESSAGE_CHARS)。
32
+ */
33
+ export const TOOL_CALL_ARGS_CAPTURE_CAP = 65_536;
34
+ /** 超限时保留的尾部长度(尾锚定证据区) */
35
+ const TOOL_CALL_ARGS_TAIL_KEEP = 16_384;
36
+ /**
37
+ * chat 路径的 arguments 序列化(无原文可用;序列化失败不遮蔽真实响应)
38
+ *
39
+ * @param args - 解析后的参数对象
40
+ * @returns JSON 文本(失败降级为 String())
41
+ */
42
+ function stringifyArgsForTrace(args) {
43
+ try {
44
+ return JSON.stringify(args ?? {}) ?? String(args);
45
+ }
46
+ catch {
47
+ return String(args);
48
+ }
49
+ }
26
50
  /**
27
51
  * 响应留痕构造:正文/推理为空时不落字段——chat 与 stream 共用同一形态,
28
52
  * 下游不得按 `text === ''` 与 `=== undefined` 分叉解读(对称性)。
@@ -30,18 +54,58 @@ import { readAttemptBudgetExhausted } from '../../harness/run/reliability/fallba
30
54
  * @param text - 响应正文
31
55
  * @param reasoning - 推理汇总
32
56
  * @param finishReason - 结束原因
33
- * @returns 留痕对象;三项皆空时 undefined
57
+ * @param toolCalls - 工具调用原始留痕(无工具调用时不传)
58
+ * @returns 留痕对象;四项皆空时 undefined
34
59
  */
35
- function buildWireResponse(text, reasoning, finishReason) {
60
+ function buildWireResponse(text, reasoning, finishReason, toolCalls) {
36
61
  const info = {};
37
62
  if (text.length > 0)
38
63
  info.text = text;
39
64
  if (reasoning.length > 0)
40
65
  info.reasoning = reasoning;
66
+ if (toolCalls && toolCalls.length > 0)
67
+ info.toolCalls = toolCalls;
41
68
  if (finishReason !== undefined)
42
69
  info.finishReason = finishReason;
43
70
  return Object.keys(info).length > 0 ? info : undefined;
44
71
  }
72
+ /**
73
+ * 构造单条 tool_call 留痕:全文留痕、超上限显式截断(记全长,不静默)
74
+ *
75
+ * @param name - 工具名
76
+ * @param argsText - arguments 文本(stream 原文 / chat 序列化)
77
+ * @param raw - 是否逐字节原文
78
+ * @returns 留痕对象
79
+ */
80
+ /**
81
+ * 构造单条 tool_call 留痕:超上限时头+尾保全、中间显式省略(记全长,不静默)
82
+ *
83
+ * @param name - 工具名
84
+ * @param argsText - arguments 文本(stream 原文 / chat 序列化)
85
+ * @param raw - 是否逐字节原文
86
+ * @param extra - id / complete / parseError / ambiguous 附加留痕
87
+ * @returns 留痕对象
88
+ */
89
+ function buildToolCallTrace(name, argsText, raw, extra = {}) {
90
+ const overCap = argsText.length > TOOL_CALL_ARGS_CAPTURE_CAP;
91
+ let argumentsText = argsText;
92
+ if (overCap) {
93
+ const headLen = TOOL_CALL_ARGS_CAPTURE_CAP - TOOL_CALL_ARGS_TAIL_KEEP;
94
+ const omitted = argsText.length - headLen - TOOL_CALL_ARGS_TAIL_KEEP;
95
+ argumentsText =
96
+ `${argsText.slice(0, headLen)}` +
97
+ `\n${elidedCharsMarker(omitted, 'wire-dump capture')}\n` +
98
+ `${argsText.slice(-TOOL_CALL_ARGS_TAIL_KEEP)}`;
99
+ }
100
+ return {
101
+ name,
102
+ arguments: argumentsText,
103
+ argumentsChars: argsText.length,
104
+ ...(overCap ? { truncated: true } : {}),
105
+ raw,
106
+ ...extra,
107
+ };
108
+ }
45
109
  /** 错误消息落盘上限(字符):上游错误体可能带整段响应,撑爆索引无意义 */
46
110
  const MAX_ERROR_MESSAGE_CHARS = 800;
47
111
  /** 流式响应正文累积硬上限(字符):装饰器层的内存护栏,最终截断在 sink 的 maxResponseChars */
@@ -94,8 +158,20 @@ export function defaultWireDumpDir() {
94
158
  /**
95
159
  * 从 wire body 提取前缀单元文本(比对与落盘的唯一权威顺序)
96
160
  *
97
- * - OpenAI:`body.messages`
98
- * - Anthropic:顶层 `system`(字符串)+ `body.messages`;system 在 wire 语义上位于最前
161
+ * **本函数的单元序列 ≠ token 顺序**:缓存前缀的真实顺序是 `tools → system → messages`,
162
+ * 而这里只产出 `system → messages`,tools 另记 `toolsHash`(见 {@link extractWireUnits}
163
+ * 调用点)。tools 不能作为单元加入本序列:它一变整条前缀即失效,已由 diff 的
164
+ * `toolsChanged → cacheableChars=0` 单独裁决,重复计入会把 stableChars 算错。
165
+ *
166
+ * dump 落盘 body 的 JSON **key 顺序**(`model/max_tokens/messages/system/tools`)只是
167
+ * provider 代码里对象字面量的书写顺序,被 `JSON.stringify` 保留下来,
168
+ * **同样不是 token 顺序**——翻看 dump 时若按 key 先后推断缓存结构会得出相反结论
169
+ * (实测:摘要请求未命中仅 6,890 token = 尾部新增两条消息,system+tools 的 94,949
170
+ * 字符一次未重算)。
171
+ *
172
+ * - OpenAI 形态:`body.messages`(system 作为 messages[0])
173
+ * - Anthropic 形态:顶层 `system`(字符串)+ `body.messages`;system 在 wire 语义
174
+ * 上位于**messages 之前**(但仍晚于 tools)
99
175
  *
100
176
  * @param body - provider 实际发送的请求体
101
177
  * @returns 前缀单元(role + 该单元 JSON 文本)
@@ -424,11 +500,20 @@ export function withWireDump(inner, sink) {
424
500
  const startedAt = Date.now();
425
501
  try {
426
502
  const res = await inner.chat(request);
503
+ let toolCalls;
504
+ if (res.toolCalls?.length) {
505
+ toolCalls = res.toolCalls.map((tc) => buildToolCallTrace(tc.name, stringifyArgsForTrace(tc.arguments), false, {
506
+ ...(tc.id ? { id: tc.id } : {}),
507
+ complete: true,
508
+ // 解析失败原文已丢(call-model 就地置 {}):必须显式标注,防误当全量证据
509
+ ...(tc.argumentsParseError !== undefined ? { parseError: true } : {}),
510
+ }));
511
+ }
427
512
  handle?.finish({
428
513
  outcome: 'ok',
429
514
  usage: res.usage,
430
515
  durationMs: Date.now() - startedAt,
431
- response: buildWireResponse(res.content, res.reasoning ?? '', res.finishReason),
516
+ response: buildWireResponse(res.content, res.reasoning ?? '', res.finishReason, toolCalls),
432
517
  });
433
518
  return res;
434
519
  }
@@ -455,6 +540,12 @@ export function withWireDump(inner, sink) {
455
540
  let reasoningText = '';
456
541
  let contentChunksSeen = 0;
457
542
  let finishReason;
543
+ /**
544
+ * tool_call 原文留痕(OP-TOOL-1 裁决物证):优先按 id 聚合、退化按 index,
545
+ * id 与 index 全缺时聚到同一槽并显式标 ambiguous(宁可标不可伪精确)
546
+ */
547
+ const toolCallTraces = new Map();
548
+ const AMBIGUOUS_KEY = '\u0000ambiguous';
458
549
  try {
459
550
  for await (const chunk of inner.stream(request)) {
460
551
  if (ttftMs == null)
@@ -463,6 +554,20 @@ export function withWireDump(inner, sink) {
463
554
  sawDone = true;
464
555
  finishReason = chunk.finishReason;
465
556
  }
557
+ if (chunk.type === 'tool_call' && chunk.toolCall) {
558
+ const tc = chunk.toolCall;
559
+ const key = tc.id ?? (tc.index !== undefined ? `idx:${tc.index}` : AMBIGUOUS_KEY);
560
+ const existing = toolCallTraces.get(key);
561
+ const entry = existing ?? { name: '', args: '' };
562
+ if (tc.id)
563
+ entry.id = tc.id;
564
+ if (tc.name)
565
+ entry.name = tc.name;
566
+ entry.args += tc.arguments ?? '';
567
+ if (existing && key === AMBIGUOUS_KEY)
568
+ entry.ambiguous = true;
569
+ toolCallTraces.set(key, entry);
570
+ }
466
571
  // done 携带全文的实现:仅当本流没有 content 增量时采用,避免正文重复一份
467
572
  if (chunk.type === 'content' && typeof chunk.content === 'string') {
468
573
  contentChunksSeen += 1;
@@ -487,8 +592,14 @@ export function withWireDump(inner, sink) {
487
592
  throw err;
488
593
  }
489
594
  finally {
595
+ const toolCalls = [...toolCallTraces.values()].map((entry) => buildToolCallTrace(entry.name, entry.args, true, {
596
+ ...(entry.id ? { id: entry.id } : {}),
597
+ ...(entry.ambiguous ? { ambiguous: true } : {}),
598
+ // 断流/提前退出的半截捕获必须与全量可辨(勿误判「模型只输出了一半」)
599
+ complete: sawDone || completed,
600
+ }));
490
601
  // 单个超大 chunk 也能顶穿上限:截断必须在累积之后
491
- const response = buildWireResponse(responseText.slice(0, RESPONSE_CAPTURE_HARD_CAP), reasoningText.slice(0, RESPONSE_CAPTURE_HARD_CAP), finishReason);
602
+ const response = buildWireResponse(responseText.slice(0, RESPONSE_CAPTURE_HARD_CAP), reasoningText.slice(0, RESPONSE_CAPTURE_HARD_CAP), finishReason, toolCalls);
492
603
  handle.finish({
493
604
  // 正常读完但服务端没发 done 哨兵(代理断流/兼容实现)不等于消费者放弃:
494
605
  // 判 abandoned 会把真实完成记成"提前中断",并误报给 llm-diff
@@ -501,5 +612,7 @@ export function withWireDump(inner, sink) {
501
612
  });
502
613
  }
503
614
  },
615
+ // 转发 dispose:否则 wire dump 开启时,退役/停机回收会对装饰实例静默失效
616
+ ...(typeof inner.dispose === 'function' ? { dispose: () => inner.dispose?.() } : {}),
504
617
  };
505
618
  }