@octopi-agent/engine 0.102.10 → 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 (317) 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 +5 -1
  23. package/dist/config-schema/agent.js +20 -2
  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 +7 -2
  27. package/dist/config-schema/context.js +6 -3
  28. package/dist/config-schema/engine.d.ts +86 -7
  29. package/dist/config-schema/engine.js +9 -2
  30. package/dist/config-schema/governance.d.ts +12 -1
  31. package/dist/config-schema/governance.js +10 -2
  32. package/dist/config-schema/models.d.ts +12 -8
  33. package/dist/config-schema/models.js +16 -1
  34. package/dist/config-schema/run.d.ts +4 -0
  35. package/dist/config-schema/run.js +10 -0
  36. package/dist/config-schema/shared.d.ts +1 -0
  37. package/dist/config-schema/shared.js +4 -2
  38. package/dist/config-schema/substrate.d.ts +5 -0
  39. package/dist/config-schema/substrate.js +8 -0
  40. package/dist/config.d.ts +116 -10
  41. package/dist/config.js +109 -13
  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 +4 -0
  49. package/dist/harness/activation/index.d.ts +1 -0
  50. package/dist/harness/activation/run-backend.d.ts +92 -0
  51. package/dist/harness/activation/run-backend.js +16 -0
  52. package/dist/harness/activation/run-protocol.d.ts +392 -0
  53. package/dist/harness/activation/run-protocol.js +19 -0
  54. package/dist/harness/activation/runtime.d.ts +33 -0
  55. package/dist/harness/activation/runtime.js +119 -28
  56. package/dist/harness/activation/types.d.ts +19 -2
  57. package/dist/harness/agent/builder.d.ts +12 -0
  58. package/dist/harness/agent/builder.js +78 -22
  59. package/dist/harness/agent/config-bridge.d.ts +10 -1
  60. package/dist/harness/agent/config-bridge.js +15 -3
  61. package/dist/harness/agent/registered-tool-adapter.d.ts +27 -0
  62. package/dist/harness/agent/registered-tool-adapter.js +67 -0
  63. package/dist/harness/agent/wire-agent-builder.d.ts +2 -0
  64. package/dist/harness/agent/wire-agent-builder.js +9 -2
  65. package/dist/harness/capabilities/document/backends/plain.js +2 -1
  66. package/dist/harness/capabilities/document/legacy/factory.js +3 -2
  67. package/dist/harness/collaboration/autonomous-subsystem/audit/reader.d.ts +17 -0
  68. package/dist/harness/collaboration/autonomous-subsystem/audit/reader.js +66 -36
  69. package/dist/harness/collaboration/autonomous-subsystem/audit/writer.d.ts +6 -2
  70. package/dist/harness/collaboration/autonomous-subsystem/audit/writer.js +27 -7
  71. package/dist/harness/collaboration/autonomous-subsystem/boundary/validator.js +13 -0
  72. package/dist/harness/collaboration/autonomous-subsystem/loader.js +1 -0
  73. package/dist/harness/collaboration/autonomous-subsystem/runtime.d.ts +11 -0
  74. package/dist/harness/collaboration/autonomous-subsystem/runtime.js +17 -0
  75. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.d.ts +13 -3
  76. package/dist/harness/collaboration/autonomous-subsystem/sense/engine.js +48 -39
  77. package/dist/harness/collaboration/autonomous-subsystem/think/executor.js +3 -0
  78. package/dist/harness/collaboration/autonomous-subsystem/types.d.ts +4 -0
  79. package/dist/harness/collaboration/delegation/child-run.d.ts +9 -0
  80. package/dist/harness/collaboration/delegation/child-run.js +34 -2
  81. package/dist/harness/collaboration/delegation/registry-types.d.ts +2 -0
  82. package/dist/harness/collaboration/delegation/service.d.ts +9 -4
  83. package/dist/harness/collaboration/delegation/service.js +33 -12
  84. package/dist/harness/collaboration/delegation/store.d.ts +2 -0
  85. package/dist/harness/collaboration/delegation/store.js +1 -0
  86. package/dist/harness/collaboration/delegation/types.d.ts +11 -0
  87. package/dist/harness/collaboration/delegation/wiring.d.ts +2 -0
  88. package/dist/harness/collaboration/delegation/wiring.js +1 -0
  89. package/dist/harness/context/capabilities/compact/engine.d.ts +44 -5
  90. package/dist/harness/context/capabilities/compact/engine.js +127 -39
  91. package/dist/harness/context/capabilities/compact/index.d.ts +2 -1
  92. package/dist/harness/context/capabilities/compact/index.js +1 -1
  93. package/dist/harness/context/capabilities/compact/types.d.ts +59 -9
  94. package/dist/harness/context/capabilities/summary/gate.d.ts +19 -2
  95. package/dist/harness/context/capabilities/summary/gate.js +53 -6
  96. package/dist/harness/context/capabilities/summary/registry.js +20 -0
  97. package/dist/harness/context/capabilities/summary/tool-binding.js +16 -12
  98. package/dist/harness/context/capabilities/summary/tool-bindings.d.ts +13 -0
  99. package/dist/harness/context/capabilities/summary/tool-bindings.js +22 -0
  100. package/dist/harness/context/capabilities/summary/types.d.ts +16 -0
  101. package/dist/harness/context/constitution/default-agents.md +85 -0
  102. package/dist/harness/context/context-size-ledger.js +8 -1
  103. package/dist/harness/context/default-context-engine.d.ts +100 -6
  104. package/dist/harness/context/default-context-engine.js +382 -89
  105. package/dist/harness/context/index.d.ts +2 -1
  106. package/dist/harness/context/index.js +1 -0
  107. package/dist/harness/context/layer-health.d.ts +4 -0
  108. package/dist/harness/context/layer-health.js +4 -0
  109. package/dist/harness/context/layer-types.d.ts +57 -0
  110. package/dist/harness/context/layer-types.js +73 -1
  111. package/dist/harness/context/layers.d.ts +3 -0
  112. package/dist/harness/context/layers.js +13 -6
  113. package/dist/harness/context/prefix-fingerprint.d.ts +46 -0
  114. package/dist/harness/context/prefix-fingerprint.js +52 -0
  115. package/dist/harness/context/summarize.js +18 -0
  116. package/dist/harness/context/system-prompt-assembler.d.ts +2 -0
  117. package/dist/harness/context/system-prompt-assembler.js +5 -2
  118. package/dist/harness/context/tool-result-aging.d.ts +104 -16
  119. package/dist/harness/context/tool-result-aging.js +211 -57
  120. package/dist/harness/context/types.d.ts +71 -4
  121. package/dist/harness/context/types.js +25 -1
  122. package/dist/harness/extension/execution-environment/effect-policy.d.ts +4 -3
  123. package/dist/harness/extension/execution-environment/effect-policy.js +2 -2
  124. package/dist/harness/extension/execution-environment/privileged-exec.js +4 -1
  125. package/dist/harness/extension/execution-environment/workspace.js +1 -1
  126. package/dist/harness/extension/plugin-ecosystem/channel-types.d.ts +27 -1
  127. package/dist/harness/extension/plugin-ecosystem/channel-types.js +11 -2
  128. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.d.ts +12 -0
  129. package/dist/harness/extension/plugin-ecosystem/client-tools/registry.js +25 -0
  130. package/dist/harness/extension/plugin-ecosystem/commands/builtin.js +28 -1
  131. package/dist/harness/extension/plugin-ecosystem/index.d.ts +1 -0
  132. package/dist/harness/extension/plugin-ecosystem/index.js +1 -0
  133. package/dist/harness/extension/plugin-ecosystem/plugins/api.d.ts +168 -1
  134. package/dist/harness/extension/plugin-ecosystem/plugins/api.js +156 -15
  135. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.d.ts +95 -0
  136. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-instances.js +170 -0
  137. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.d.ts +178 -0
  138. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-kinds.js +314 -0
  139. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.d.ts +40 -5
  140. package/dist/harness/extension/plugin-ecosystem/plugins/contribution-registry.js +45 -26
  141. package/dist/harness/extension/plugin-ecosystem/plugins/index.d.ts +1 -1
  142. package/dist/harness/extension/plugin-ecosystem/plugins/loader.d.ts +11 -1
  143. package/dist/harness/extension/plugin-ecosystem/plugins/loader.js +42 -76
  144. package/dist/harness/extension/plugin-ecosystem/plugins/manager.d.ts +30 -1
  145. package/dist/harness/extension/plugin-ecosystem/plugins/manager.js +46 -0
  146. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.d.ts +9 -0
  147. package/dist/harness/extension/plugin-ecosystem/plugins/manifest.js +19 -14
  148. package/dist/harness/extension/plugin-ecosystem/plugins/staging.d.ts +3 -1
  149. package/dist/harness/extension/plugin-ecosystem/plugins/staging.js +1 -1
  150. package/dist/harness/extension/plugin-ecosystem/tools/browser-types.d.ts +333 -0
  151. package/dist/harness/extension/plugin-ecosystem/tools/browser-types.js +16 -0
  152. package/dist/harness/extension/plugin-ecosystem/tools/browser.d.ts +64 -0
  153. package/dist/harness/extension/plugin-ecosystem/tools/browser.js +692 -0
  154. package/dist/harness/extension/plugin-ecosystem/tools/builtin.d.ts +0 -37
  155. package/dist/harness/extension/plugin-ecosystem/tools/builtin.js +108 -4
  156. package/dist/harness/extension/plugin-ecosystem/tools/delegation.js +18 -0
  157. package/dist/harness/extension/plugin-ecosystem/tools/file-edit.js +34 -0
  158. package/dist/harness/extension/plugin-ecosystem/tools/file-search.d.ts +0 -6
  159. package/dist/harness/extension/plugin-ecosystem/tools/file-search.js +57 -4
  160. package/dist/harness/extension/plugin-ecosystem/tools/git-tools.js +81 -13
  161. package/dist/harness/extension/plugin-ecosystem/tools/http.js +5 -0
  162. package/dist/harness/extension/plugin-ecosystem/tools/knowledge.js +13 -7
  163. package/dist/harness/extension/plugin-ecosystem/tools/package-tools.js +126 -14
  164. package/dist/harness/extension/plugin-ecosystem/tools/platform.d.ts +1 -1
  165. package/dist/harness/extension/plugin-ecosystem/tools/platform.js +44 -5
  166. package/dist/harness/extension/plugin-ecosystem/tools/tool-bus.js +10 -24
  167. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.d.ts +7 -0
  168. package/dist/harness/extension/plugin-ecosystem/tools/tool-set.js +4 -0
  169. package/dist/harness/governance/credentials/db.d.ts +9 -0
  170. package/dist/harness/governance/credentials/db.js +122 -31
  171. package/dist/harness/governance/credentials/store.d.ts +68 -7
  172. package/dist/harness/governance/credentials/store.js +177 -64
  173. package/dist/harness/governance/credentials/types.d.ts +13 -2
  174. package/dist/harness/governance/index.d.ts +1 -0
  175. package/dist/harness/governance/index.js +1 -0
  176. package/dist/harness/governance/registry/db.d.ts +32 -0
  177. package/dist/harness/governance/registry/db.js +142 -0
  178. package/dist/harness/governance/registry/index.d.ts +9 -0
  179. package/dist/harness/governance/registry/index.js +9 -0
  180. package/dist/harness/governance/registry/service.d.ts +381 -0
  181. package/dist/harness/governance/registry/service.js +825 -0
  182. package/dist/harness/governance/registry/types.d.ts +77 -0
  183. package/dist/harness/governance/registry/types.js +7 -0
  184. package/dist/harness/governance/security/default-security-guard.d.ts +3 -0
  185. package/dist/harness/governance/security/default-security-guard.js +12 -1
  186. package/dist/harness/governance/security/risk-evaluator.d.ts +13 -3
  187. package/dist/harness/governance/security/risk-evaluator.js +307 -21
  188. package/dist/harness/governance/security/shell-parser-treesitter.js +12 -4
  189. package/dist/harness/governance/session-acl/tool-rights.d.ts +1 -0
  190. package/dist/harness/index.d.ts +5 -3
  191. package/dist/harness/index.js +2 -2
  192. package/dist/harness/knowledge/boot-config.d.ts +2 -0
  193. package/dist/harness/knowledge/boot-config.js +2 -0
  194. package/dist/harness/knowledge/client.d.ts +53 -7
  195. package/dist/harness/knowledge/client.js +77 -20
  196. package/dist/harness/knowledge/db.d.ts +16 -0
  197. package/dist/harness/knowledge/db.js +107 -41
  198. package/dist/harness/knowledge/engine-thread.js +5 -7
  199. package/dist/harness/knowledge/grounding.js +4 -1
  200. package/dist/harness/knowledge/http-app.d.ts +15 -0
  201. package/dist/harness/knowledge/http-app.js +82 -21
  202. package/dist/harness/knowledge/http-bridge.d.ts +15 -0
  203. package/dist/harness/knowledge/http-bridge.js +19 -0
  204. package/dist/harness/knowledge/knowledge-serve-child.js +2 -3
  205. package/dist/harness/knowledge/query-service.d.ts +12 -2
  206. package/dist/harness/knowledge/query-service.js +75 -41
  207. package/dist/harness/knowledge/query-worker-client.d.ts +5 -1
  208. package/dist/harness/knowledge/query-worker-client.js +4 -1
  209. package/dist/harness/knowledge/query-worker.js +5 -3
  210. package/dist/harness/knowledge/read-http.d.ts +2 -0
  211. package/dist/harness/knowledge/read-http.js +9 -2
  212. package/dist/harness/knowledge/retriever.d.ts +1 -1
  213. package/dist/harness/knowledge/retriever.js +1 -2
  214. package/dist/harness/knowledge/serve.d.ts +6 -1
  215. package/dist/harness/knowledge/serve.js +5 -6
  216. package/dist/harness/knowledge/source-store.d.ts +101 -5
  217. package/dist/harness/knowledge/source-store.js +297 -71
  218. package/dist/harness/knowledge/start-service-process.d.ts +27 -8
  219. package/dist/harness/knowledge/start-service-process.js +49 -90
  220. package/dist/harness/knowledge/tenant-gate.d.ts +81 -0
  221. package/dist/harness/knowledge/tenant-gate.js +167 -0
  222. package/dist/harness/knowledge/writer-service.d.ts +18 -2
  223. package/dist/harness/knowledge/writer-service.js +80 -16
  224. package/dist/harness/knowledge/writer-worker-client.d.ts +9 -2
  225. package/dist/harness/knowledge/writer-worker-client.js +20 -3
  226. package/dist/harness/knowledge/writer-worker.js +11 -4
  227. package/dist/harness/memory/backfill-trigger.d.ts +10 -3
  228. package/dist/harness/memory/backfill-trigger.js +19 -19
  229. package/dist/harness/memory/cognition-seeds.d.ts +45 -0
  230. package/dist/harness/memory/cognition-seeds.js +67 -0
  231. package/dist/harness/memory/cognition.d.ts +12 -3
  232. package/dist/harness/memory/cognition.js +55 -35
  233. package/dist/harness/memory/conceptualizer.d.ts +11 -1
  234. package/dist/harness/memory/conceptualizer.js +10 -1
  235. package/dist/harness/memory/context-slice.d.ts +42 -0
  236. package/dist/harness/memory/context-slice.js +197 -0
  237. package/dist/harness/memory/health-probe.d.ts +8 -2
  238. package/dist/harness/memory/health-probe.js +10 -13
  239. package/dist/harness/memory/index.d.ts +5 -1
  240. package/dist/harness/memory/index.js +3 -1
  241. package/dist/harness/memory/sqlite/agent-db.d.ts +1 -0
  242. package/dist/harness/memory/sqlite/agent-db.js +9 -8
  243. package/dist/harness/memory/sqlite/cognition-store.d.ts +26 -3
  244. package/dist/harness/memory/sqlite/cognition-store.js +103 -45
  245. package/dist/harness/memory/sqlite/memory-store.js +4 -0
  246. package/dist/harness/memory/sqlite/sqlite-vec.d.ts +24 -1
  247. package/dist/harness/memory/sqlite/sqlite-vec.js +37 -1
  248. package/dist/harness/memory/types.d.ts +18 -2
  249. package/dist/harness/observability/observer/hub.d.ts +10 -0
  250. package/dist/harness/observability/observer/hub.js +95 -2
  251. package/dist/harness/run/agent/agent.js +3 -2
  252. package/dist/harness/run/concurrency/tool-validator.js +4 -3
  253. package/dist/harness/run/reliability/run-agent.d.ts +22 -0
  254. package/dist/harness/run/reliability/run-agent.js +79 -10
  255. package/dist/harness/run/run-host.d.ts +302 -0
  256. package/dist/harness/run/run-host.js +978 -0
  257. package/dist/harness/run/run-scope.d.ts +11 -0
  258. package/dist/harness/run/run-scope.js +19 -1
  259. package/dist/harness/run/runner.d.ts +149 -22
  260. package/dist/harness/run/runner.js +352 -35
  261. package/dist/harness/session/in-memory-store.js +13 -1
  262. package/dist/harness/session/schedules/service.d.ts +10 -2
  263. package/dist/harness/session/schedules/service.js +13 -2
  264. package/dist/harness/session/tasks/tools.js +12 -0
  265. package/dist/harness/session/types.d.ts +10 -14
  266. package/dist/harness/shared/events/agent-event-map.d.ts +29 -0
  267. package/dist/harness/shared/types/agent-definition.d.ts +6 -0
  268. package/dist/index.d.ts +3 -2
  269. package/dist/index.js +2 -1
  270. package/dist/integration/agent-runtime/channel-message-source.d.ts +3 -1
  271. package/dist/integration/agent-runtime/channel-message-source.js +4 -3
  272. package/dist/integration/browser/camoufox.d.ts +40 -0
  273. package/dist/integration/browser/camoufox.js +80 -0
  274. package/dist/integration/browser/index.d.ts +91 -0
  275. package/dist/integration/browser/index.js +110 -0
  276. package/dist/integration/browser/install.d.ts +47 -0
  277. package/dist/integration/browser/install.js +214 -0
  278. package/dist/integration/browser/playwright.d.ts +224 -0
  279. package/dist/integration/browser/playwright.js +925 -0
  280. package/dist/integration/browser/service.d.ts +41 -0
  281. package/dist/integration/browser/service.js +181 -0
  282. package/dist/integration/browser/stealth.d.ts +42 -0
  283. package/dist/integration/browser/stealth.js +104 -0
  284. package/dist/integration/providers/anthropic-message-normalize.d.ts +20 -0
  285. package/dist/integration/providers/anthropic-message-normalize.js +48 -0
  286. package/dist/integration/providers/anthropic.js +27 -2
  287. package/dist/integration/providers/fetch-timeout.d.ts +17 -0
  288. package/dist/integration/providers/fetch-timeout.js +24 -0
  289. package/dist/integration/providers/openai.d.ts +8 -0
  290. package/dist/integration/providers/openai.js +41 -1
  291. package/dist/integration/providers/wire-dump-diff.js +2 -1
  292. package/dist/integration/providers/wire-dump.d.ts +56 -2
  293. package/dist/integration/providers/wire-dump.js +119 -6
  294. package/dist/integration/storage/archive-manager.d.ts +14 -2
  295. package/dist/integration/storage/archive-manager.js +24 -8
  296. package/dist/integration/storage/atomic-tmp.d.ts +12 -0
  297. package/dist/integration/storage/atomic-tmp.js +36 -0
  298. package/dist/integration/storage/jsonl.d.ts +9 -0
  299. package/dist/integration/storage/jsonl.js +137 -38
  300. package/dist/integration/storage/session-index.d.ts +5 -0
  301. package/dist/integration/storage/session-index.js +25 -4
  302. package/dist/integration/tools/assemble.d.ts +50 -0
  303. package/dist/integration/tools/assemble.js +137 -0
  304. package/dist/paths.d.ts +18 -0
  305. package/dist/paths.js +36 -0
  306. package/dist/subsystems/cognition-steward/conceptualize/config.yaml +3 -1
  307. package/dist/subsystems/cognition-steward/conceptualize/handler.js +74 -5
  308. package/dist/subsystems/cognition-steward/consolidate/SUBSYSTEM.md +3 -2
  309. package/dist/subsystems/cognition-steward/consolidate/config.yaml +11 -2
  310. package/dist/subsystems/cognition-steward/consolidate/handler.d.ts +6 -3
  311. package/dist/subsystems/cognition-steward/consolidate/handler.js +266 -28
  312. package/dist/subsystems/memory-steward/backfill/handler.js +3 -2
  313. package/dist/subsystems/memory-steward/govern/config.yaml +6 -1
  314. package/dist/subsystems/wisdom-steward/attribute/config.yaml +5 -1
  315. package/dist/subsystems/wisdom-steward/formation/config.yaml +3 -0
  316. package/dist/subsystems/wisdom-steward/govern/config.yaml +6 -1
  317. package/package.json +5 -3
@@ -0,0 +1,41 @@
1
+ /**
2
+ * DefaultBrowserService — BrowserService 实现(key/ID 会话索引)
3
+ *
4
+ * 并发纪律(评审 B4/N8):acquire 做 single-flight(同 key 并发只起一个浏览器);
5
+ * close 先关再摘表(失败可重试),但全程带 closing 守卫——关闭在途的会话对
6
+ * get/byId/acquire 一律不可见(否则并发方会拿到半死会话 / 关闭后复活);
7
+ * dispose 收口进程生命周期 + 空闲回收,防 agent 忘记 browser_close 时
8
+ * Chromium 进程泄漏。
9
+ */
10
+ import type { BrowserLaunchOptions, BrowserPort, BrowserService, BrowserSession, BrowserSessionId, BrowserSessionInfo } from '../../harness/extension/plugin-ecosystem/tools/browser-types.js';
11
+ export declare class DefaultBrowserService implements BrowserService {
12
+ private readonly port;
13
+ private readonly options;
14
+ private readonly byKeyMap;
15
+ private readonly byIdMap;
16
+ private readonly byKeyInflight;
17
+ private readonly lastUsedAt;
18
+ /** 关闭在途的会话(对 get/byId/acquire 不可见;防复活窗口) */
19
+ private readonly closing;
20
+ private disposed;
21
+ private readonly sweepTimer;
22
+ constructor(port: BrowserPort, options?: {
23
+ /** 空闲回收(毫秒);<= 0 = 不回收 */
24
+ sessionIdleTimeoutMs?: number;
25
+ });
26
+ acquire(sessionKey: string, options?: BrowserLaunchOptions): Promise<BrowserSession>;
27
+ get(sessionKey: string): Promise<BrowserSession | undefined>;
28
+ byId(id: BrowserSessionId): Promise<BrowserSession | undefined>;
29
+ close(sessionKeyOrId: string): Promise<boolean>;
30
+ list(): Promise<BrowserSessionInfo[]>;
31
+ dispose(): Promise<void>;
32
+ /**
33
+ * 关闭一个会话(closing 守卫 + 先关再摘表)。
34
+ * 失败也摘表(评审 F8):关闭失败的会话是半死态(如归档失败但浏览器已关),
35
+ * 留表会毒化 acquire/get(全报 closed),代价是 close 不可重试、下次 acquire 重 launch。
36
+ */
37
+ private closeSession;
38
+ private evict;
39
+ private sweepIdle;
40
+ private assertUsable;
41
+ }
@@ -0,0 +1,181 @@
1
+ /**
2
+ * DefaultBrowserService — BrowserService 实现(key/ID 会话索引)
3
+ *
4
+ * 并发纪律(评审 B4/N8):acquire 做 single-flight(同 key 并发只起一个浏览器);
5
+ * close 先关再摘表(失败可重试),但全程带 closing 守卫——关闭在途的会话对
6
+ * get/byId/acquire 一律不可见(否则并发方会拿到半死会话 / 关闭后复活);
7
+ * dispose 收口进程生命周期 + 空闲回收,防 agent 忘记 browser_close 时
8
+ * Chromium 进程泄漏。
9
+ */
10
+ const IDLE_SWEEP_INTERVAL_MS = 60_000;
11
+ export class DefaultBrowserService {
12
+ port;
13
+ options;
14
+ byKeyMap = new Map();
15
+ byIdMap = new Map();
16
+ byKeyInflight = new Map();
17
+ lastUsedAt = new Map();
18
+ /** 关闭在途的会话(对 get/byId/acquire 不可见;防复活窗口) */
19
+ closing = new Set();
20
+ disposed = false;
21
+ sweepTimer;
22
+ constructor(port, options = {}) {
23
+ this.port = port;
24
+ this.options = options;
25
+ const idleTimeoutMs = options.sessionIdleTimeoutMs ?? 1_800_000;
26
+ if (idleTimeoutMs > 0) {
27
+ this.sweepTimer = setInterval(() => {
28
+ void this.sweepIdle(idleTimeoutMs);
29
+ }, IDLE_SWEEP_INTERVAL_MS);
30
+ // 回收定时器不得钉住进程退出
31
+ this.sweepTimer.unref?.();
32
+ }
33
+ }
34
+ async acquire(sessionKey, options) {
35
+ this.assertUsable();
36
+ const existing = this.byKeyMap.get(sessionKey);
37
+ if (existing) {
38
+ if (!this.closing.has(existing.id)) {
39
+ this.lastUsedAt.set(existing.id, Date.now());
40
+ return existing;
41
+ }
42
+ // 关闭在途:当缺席处理(摘表后走新 launch,不复用半死会话)
43
+ this.evict(existing);
44
+ }
45
+ const inflight = this.byKeyInflight.get(sessionKey);
46
+ if (inflight)
47
+ return inflight;
48
+ // single-flight:launch 期间同 key 的并发调用等同一个 promise
49
+ const promise = (async () => {
50
+ try {
51
+ const session = await this.port.launch({ ...options, ownerKey: sessionKey });
52
+ if (this.disposed) {
53
+ // dispose 竞态:已宣告收尾则不能复活会话(评审 B4「复活」路径)
54
+ await session.close();
55
+ throw new Error('browser_service_disposed: service disposed during acquire');
56
+ }
57
+ this.byKeyMap.set(sessionKey, session);
58
+ this.byIdMap.set(session.id, session);
59
+ this.lastUsedAt.set(session.id, Date.now());
60
+ return session;
61
+ }
62
+ finally {
63
+ this.byKeyInflight.delete(sessionKey);
64
+ }
65
+ })();
66
+ this.byKeyInflight.set(sessionKey, promise);
67
+ return promise;
68
+ }
69
+ async get(sessionKey) {
70
+ const found = this.byKeyMap.get(sessionKey);
71
+ if (!found || this.closing.has(found.id))
72
+ return undefined;
73
+ this.lastUsedAt.set(found.id, Date.now());
74
+ return found;
75
+ }
76
+ async byId(id) {
77
+ const found = this.byIdMap.get(id);
78
+ if (!found || this.closing.has(found.id))
79
+ return undefined;
80
+ this.lastUsedAt.set(found.id, Date.now());
81
+ return found;
82
+ }
83
+ async close(sessionKeyOrId) {
84
+ let session = this.byKeyMap.get(sessionKeyOrId) ?? this.byIdMap.get(sessionKeyOrId);
85
+ if (session && this.closing.has(session.id))
86
+ return true; // 在途关闭 = 已受理
87
+ if (!session) {
88
+ // 关闭与在途 acquire 交错:等 launch 落地再关(防「close 返回后会话复活」)
89
+ const inflight = this.byKeyInflight.get(sessionKeyOrId);
90
+ if (inflight) {
91
+ try {
92
+ session = await inflight;
93
+ }
94
+ catch {
95
+ return false; // acquire 失败 = 没有会话可关
96
+ }
97
+ }
98
+ }
99
+ if (!session)
100
+ return false;
101
+ return this.closeSession(session);
102
+ }
103
+ async list() {
104
+ return this.port.list();
105
+ }
106
+ async dispose() {
107
+ if (this.disposed)
108
+ return;
109
+ this.disposed = true;
110
+ if (this.sweepTimer)
111
+ clearInterval(this.sweepTimer);
112
+ const sessions = [...this.byIdMap.values()];
113
+ this.byKeyMap.clear();
114
+ this.byIdMap.clear();
115
+ this.lastUsedAt.clear();
116
+ this.closing.clear();
117
+ // 尽力关全部;单个失败不阻断其余(逐个隔离异常)
118
+ for (const session of sessions) {
119
+ try {
120
+ await session.close();
121
+ }
122
+ catch {
123
+ // 收尾路径:失败无法重试,吞掉但已尽力(dispose 是兜底回收)
124
+ }
125
+ }
126
+ }
127
+ /**
128
+ * 关闭一个会话(closing 守卫 + 先关再摘表)。
129
+ * 失败也摘表(评审 F8):关闭失败的会话是半死态(如归档失败但浏览器已关),
130
+ * 留表会毒化 acquire/get(全报 closed),代价是 close 不可重试、下次 acquire 重 launch。
131
+ */
132
+ async closeSession(session) {
133
+ if (this.closing.has(session.id))
134
+ return true;
135
+ this.closing.add(session.id);
136
+ try {
137
+ await session.close();
138
+ }
139
+ catch (err) {
140
+ this.evict(session);
141
+ this.closing.delete(session.id);
142
+ throw err;
143
+ }
144
+ this.evict(session);
145
+ this.closing.delete(session.id);
146
+ return true;
147
+ }
148
+ evict(session) {
149
+ // 身份判定(评审 N3):失败路径的 evict 可能晚于同 key 重 launch——只摘"仍是这个会话"的记录
150
+ if (this.byKeyMap.get(session.ownerKey) === session) {
151
+ this.byKeyMap.delete(session.ownerKey);
152
+ }
153
+ this.byIdMap.delete(session.id);
154
+ this.lastUsedAt.delete(session.id);
155
+ }
156
+ async sweepIdle(idleTimeoutMs) {
157
+ const now = Date.now();
158
+ for (const [id, usedAt] of [...this.lastUsedAt]) {
159
+ if (now - usedAt <= idleTimeoutMs)
160
+ continue;
161
+ const session = this.byIdMap.get(id);
162
+ if (!session || this.closing.has(id)) {
163
+ if (!session)
164
+ this.lastUsedAt.delete(id);
165
+ continue;
166
+ }
167
+ try {
168
+ await this.closeSession(session);
169
+ }
170
+ catch {
171
+ // 回收失败:closeSession 已摘表(下次 acquire 重 launch);
172
+ // 极端情况下的进程级泄漏风险已记入 KNOWN-ISSUES
173
+ }
174
+ }
175
+ }
176
+ assertUsable() {
177
+ if (this.disposed) {
178
+ throw new Error('browser_service_disposed: browser service has been disposed');
179
+ }
180
+ }
181
+ }
@@ -0,0 +1,42 @@
1
+ /**
2
+ * integration/browser/stealth.ts — stealth fallback 链(P3)
3
+ *
4
+ * `engine: "stealth"`:按 `stealth.fallback`(缺省 `rebrowser->camoufox`)持有多个
5
+ * 单引擎服务;挑战判定命中经 {@link StealthFallbackService.rotateAfterChallenge}
6
+ * **按会话 key** 有界轮换到下一后端重试一次,链穷尽返回 false(工具层走 HITL)。
7
+ *
8
+ * 轮换是 per-key 的:一个 key 撞挑战只影响它自己的后端选择,其他 key 仍从链头开始。
9
+ *
10
+ * @module
11
+ */
12
+ import type { BrowserLaunchOptions, BrowserService, BrowserSession, BrowserSessionId, BrowserSessionInfo, StealthRotatable } from '../../harness/extension/plugin-ecosystem/tools/browser-types.js';
13
+ /**
14
+ * 解析 `stealth.fallback` 链字符串。
15
+ *
16
+ * @param fallback - `->` 分隔的引擎序列(缺省 `rebrowser->camoufox`)
17
+ * @returns 引擎名序列(保序去重)
18
+ * @throws 含白名单外成员或空链时 `Error`(装配期 fail-loud,不静默截断)
19
+ */
20
+ export declare function parseFallbackChain(fallback?: string): string[];
21
+ /**
22
+ * stealth 链服务:同 key 会话走当前后端;挑战命中换下一后端(一次为限)。
23
+ */
24
+ export declare class StealthFallbackService implements BrowserService, StealthRotatable {
25
+ private readonly chain;
26
+ /** per-key 当前后端下标(缺省 0 = 链头) */
27
+ private readonly indexByKey;
28
+ private disposed;
29
+ /**
30
+ * @param chain - 按 fallback 序排列的单引擎服务(长度 ≥ 1)
31
+ */
32
+ constructor(chain: BrowserService[]);
33
+ private svc;
34
+ acquire(sessionKey: string, options?: BrowserLaunchOptions): Promise<BrowserSession>;
35
+ get(sessionKey: string): Promise<BrowserSession | undefined>;
36
+ byId(id: BrowserSessionId): Promise<BrowserSession | undefined>;
37
+ close(sessionKeyOrId: string): Promise<boolean>;
38
+ list(): Promise<BrowserSessionInfo[]>;
39
+ rotateAfterChallenge(sessionKey: string): Promise<boolean>;
40
+ dispose(): Promise<void>;
41
+ private assertUsable;
42
+ }
@@ -0,0 +1,104 @@
1
+ /** 链成员白名单(P3 双 stealth 后端;其余引擎不得进链) */
2
+ const CHAIN_ENGINES = new Set(['rebrowser', 'camoufox']);
3
+ /**
4
+ * 解析 `stealth.fallback` 链字符串。
5
+ *
6
+ * @param fallback - `->` 分隔的引擎序列(缺省 `rebrowser->camoufox`)
7
+ * @returns 引擎名序列(保序去重)
8
+ * @throws 含白名单外成员或空链时 `Error`(装配期 fail-loud,不静默截断)
9
+ */
10
+ export function parseFallbackChain(fallback) {
11
+ const raw = (fallback ?? 'rebrowser->camoufox')
12
+ .split('->')
13
+ .map((s) => s.trim())
14
+ .filter((s) => s.length > 0);
15
+ const seen = new Set();
16
+ const chain = [];
17
+ for (const name of raw) {
18
+ if (!CHAIN_ENGINES.has(name)) {
19
+ throw new Error(`invalid_config: browser.stealth.fallback member "${name}" (allowed: rebrowser, camoufox)`);
20
+ }
21
+ if (seen.has(name))
22
+ continue; // 保序去重(重复成员无意义)
23
+ seen.add(name);
24
+ chain.push(name);
25
+ }
26
+ if (chain.length === 0) {
27
+ throw new Error('invalid_config: browser.stealth.fallback resolved to an empty chain');
28
+ }
29
+ return chain;
30
+ }
31
+ /**
32
+ * stealth 链服务:同 key 会话走当前后端;挑战命中换下一后端(一次为限)。
33
+ */
34
+ export class StealthFallbackService {
35
+ chain;
36
+ /** per-key 当前后端下标(缺省 0 = 链头) */
37
+ indexByKey = new Map();
38
+ disposed = false;
39
+ /**
40
+ * @param chain - 按 fallback 序排列的单引擎服务(长度 ≥ 1)
41
+ */
42
+ constructor(chain) {
43
+ this.chain = chain;
44
+ if (chain.length === 0)
45
+ throw new Error('invalid_config: stealth fallback chain is empty');
46
+ }
47
+ svc(key) {
48
+ const idx = Math.min(this.indexByKey.get(key) ?? 0, this.chain.length - 1);
49
+ return this.chain[idx];
50
+ }
51
+ async acquire(sessionKey, options) {
52
+ this.assertUsable();
53
+ return this.svc(sessionKey).acquire(sessionKey, options);
54
+ }
55
+ async get(sessionKey) {
56
+ // 轮换后新会话在新后端;旧后端可能仍持有其他 key 的会话——全链扫(精确归属由 key 保证)
57
+ for (const svc of this.chain) {
58
+ const hit = await svc.get(sessionKey);
59
+ if (hit)
60
+ return hit;
61
+ }
62
+ return undefined;
63
+ }
64
+ async byId(id) {
65
+ for (const svc of this.chain) {
66
+ const hit = await svc.byId(id);
67
+ if (hit)
68
+ return hit;
69
+ }
70
+ return undefined;
71
+ }
72
+ async close(sessionKeyOrId) {
73
+ let closed = false;
74
+ for (const svc of this.chain) {
75
+ closed = (await svc.close(sessionKeyOrId)) || closed;
76
+ }
77
+ return closed;
78
+ }
79
+ async list() {
80
+ const out = [];
81
+ for (const svc of this.chain)
82
+ out.push(...(await svc.list()));
83
+ return out;
84
+ }
85
+ async rotateAfterChallenge(sessionKey) {
86
+ this.assertUsable();
87
+ const idx = this.indexByKey.get(sessionKey) ?? 0;
88
+ if (idx >= this.chain.length - 1)
89
+ return false; // 链穷尽:HITL 出口
90
+ await this.chain[idx].close(sessionKey);
91
+ this.indexByKey.set(sessionKey, idx + 1);
92
+ return true;
93
+ }
94
+ async dispose() {
95
+ if (this.disposed)
96
+ return;
97
+ this.disposed = true;
98
+ await Promise.all(this.chain.map((svc) => svc.dispose()));
99
+ }
100
+ assertUsable() {
101
+ if (this.disposed)
102
+ throw new Error('browser service disposed');
103
+ }
104
+ }
@@ -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
  *
@@ -385,10 +388,29 @@ export class AnthropicProvider {
385
388
  if (systemPrompt) {
386
389
  anthropicRequest.system = systemPrompt;
387
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
+ }
388
407
  if (request.temperature !== undefined) {
408
+ if (thinkingBudget !== undefined && request.temperature !== 1) {
409
+ throw new Error('Anthropic extended thinking requires temperature 1');
410
+ }
389
411
  anthropicRequest.temperature = request.temperature;
390
412
  }
391
- else if (modelInfo?.temperature !== undefined) {
413
+ else if (thinkingBudget === undefined && modelInfo?.temperature !== undefined) {
392
414
  // 请求未指定时采用模型级配置;两者都未配置则不发送该参数(交给服务端默认)
393
415
  anthropicRequest.temperature = modelInfo.temperature;
394
416
  }
@@ -427,7 +449,10 @@ export class AnthropicProvider {
427
449
  i--;
428
450
  result.push({ role: 'user', content: blocks });
429
451
  }
430
- return result;
452
+ // 角色交替归一(2026-11-12):引擎历史天然产生连续 user(tool_result → 摘要占位、
453
+ // 摘要占位 → turn_start、turn_end → turn_start);严格 anthropic-messages 端点
454
+ // 只回通用 InvalidParameter,故在适配器出口统一合并。
455
+ return mergeConsecutiveSameRole(result);
431
456
  }
432
457
  /**
433
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
  /**
@@ -241,6 +241,14 @@ export class OpenAIProvider {
241
241
  }
242
242
  /**
243
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 才判鉴权失败。
244
252
  */
245
253
  async isAvailable() {
246
254
  try {
@@ -249,7 +257,31 @@ export class OpenAIProvider {
249
257
  signal: AbortSignal.timeout(5000),
250
258
  dispatcher: this.dispatcher,
251
259
  });
252
- 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;
253
285
  }
254
286
  catch {
255
287
  return false;
@@ -305,6 +337,14 @@ export class OpenAIProvider {
305
337
  else if (cap) {
306
338
  body.max_tokens = cap;
307
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
+ }
308
348
  if (request.tools && request.tools.length > 0) {
309
349
  // 兼容接口可能拒绝 maxLength 等未知 schema 关键字
310
350
  body.tools = request.tools.map((tool) => {
@@ -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
  *