@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
@@ -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
+ }
@@ -48,10 +48,10 @@ export interface MetricsSnapshot {
48
48
  toolErrors: Record<string, number>;
49
49
  /** 活跃 session 数 */
50
50
  sessionsActive: number;
51
- /** 总 turn 数 */
52
- turnsTotal: number;
53
- /** 以失败告终的 turn 数(turn.end 带 error;含重试中失败尝试,失败不再是指标盲区) */
54
- failedTurns: number;
51
+ /** 总 step 数 */
52
+ stepsTotal: number;
53
+ /** 以失败告终的 step 数(step.end 带 error;含重试中失败尝试,失败不再是指标盲区) */
54
+ failedSteps: number;
55
55
  /** 空回复数 */
56
56
  emptyResponses: number;
57
57
  /** 重试次数 */
@@ -85,8 +85,8 @@ export declare class MetricsAggregator {
85
85
  private _toolLatency;
86
86
  private _toolErrors;
87
87
  private _sessionsActive;
88
- private _turnsTotal;
89
- private _failedTurns;
88
+ private _stepsTotal;
89
+ private _failedSteps;
90
90
  private _emptyResponses;
91
91
  private _retriesTotal;
92
92
  private _snapshots;
@@ -62,8 +62,8 @@ export class MetricsAggregator {
62
62
  _toolErrors = new Map();
63
63
  // Session 指标
64
64
  _sessionsActive = new Set();
65
- _turnsTotal = 0;
66
- _failedTurns = 0;
65
+ _stepsTotal = 0;
66
+ _failedSteps = 0;
67
67
  _emptyResponses = 0;
68
68
  _retriesTotal = 0;
69
69
  // 快照历史
@@ -123,20 +123,20 @@ export class MetricsAggregator {
123
123
  }
124
124
  break;
125
125
  }
126
- // ── Turn ──
127
- // 只计完整结束的 turn:重试中失败尝试的 turn_end(error) 不是用户语义上的轮次,
128
- // 否则 turnsTotal 会把失败尝试计成 turn、与 llmCalls 倒挂;失败调用的空输出
126
+ // ── Step ──
127
+ // 只计完整结束的 turn:重试中失败尝试的 step_end(error) 不是用户语义上的轮次,
128
+ // 否则 stepsTotal 会把失败尝试计成 step、与 llmCalls 倒挂;失败调用的空输出
129
129
  // 也不是「空响应」。
130
- case 'turn.end': {
130
+ case 'step.end': {
131
131
  const failed = Boolean(event.data?.error);
132
132
  if (!failed) {
133
- this._turnsTotal++;
133
+ this._stepsTotal++;
134
134
  if (!event.data?.content || event.data.content.length === 0) {
135
135
  this._emptyResponses++;
136
136
  }
137
137
  }
138
138
  else {
139
- this._failedTurns++;
139
+ this._failedSteps++;
140
140
  }
141
141
  break;
142
142
  }
@@ -170,8 +170,8 @@ export class MetricsAggregator {
170
170
  toolLatency: Object.fromEntries([...this._toolLatency.entries()].map(([k, v]) => [k, v.getStats()])),
171
171
  toolErrors: Object.fromEntries(this._toolErrors),
172
172
  sessionsActive: this._sessionsActive.size,
173
- turnsTotal: this._turnsTotal,
174
- failedTurns: this._failedTurns,
173
+ stepsTotal: this._stepsTotal,
174
+ failedSteps: this._failedSteps,
175
175
  emptyResponses: this._emptyResponses,
176
176
  retriesTotal: this._retriesTotal,
177
177
  estimatedCostUsd: Math.round(estimatedCostUsd * 10000) / 10000,
@@ -197,8 +197,8 @@ export class MetricsAggregator {
197
197
  this._toolLatency.clear();
198
198
  this._toolErrors.clear();
199
199
  this._sessionsActive.clear();
200
- this._turnsTotal = 0;
201
- this._failedTurns = 0;
200
+ this._stepsTotal = 0;
201
+ this._failedSteps = 0;
202
202
  this._emptyResponses = 0;
203
203
  this._retriesTotal = 0;
204
204
  this._snapshots = [];
@@ -222,7 +222,7 @@ export function formatMetricsSnapshot(snap) {
222
222
  lines.push(`${'─'.repeat(50)}`);
223
223
  lines.push(`Uptime: ${(snap.uptimeMs / 1000).toFixed(0)}s`);
224
224
  lines.push(`Sessions: ${snap.sessionsActive} active`);
225
- lines.push(`Turns: ${snap.turnsTotal} (${snap.failedTurns} failed)`);
225
+ lines.push(`Steps: ${snap.stepsTotal} (${snap.failedSteps} failed)`);
226
226
  lines.push(`Empty replies: ${snap.emptyResponses}`);
227
227
  lines.push(`Retries: ${snap.retriesTotal}`);
228
228
  lines.push('');
@@ -13,7 +13,7 @@
13
13
  import { TraceLogger } from './trace-logger.js';
14
14
  import { MetricsAggregator } from './metrics.js';
15
15
  import { TraceLevel, TRACE_EVENTS } from './trace-events.js';
16
- import { makeTokenUsage } from '@octopi-agent/core/types/turn.js';
16
+ import { makeTokenUsage } from '@octopi-agent/core/types/step.js';
17
17
  // ── Span 实现 ──
18
18
  class BridgeSpan {
19
19
  id;
@@ -176,7 +176,7 @@ export class ObserverBridge {
176
176
  return { ts: Date.now(), level: TraceLevel.INFO, type: TRACE_EVENTS.MODEL_CALL_START, data: attributes };
177
177
  case 'agent.tool.exec':
178
178
  return { ts: Date.now(), level: TraceLevel.INFO, type: TRACE_EVENTS.TOOL_EXEC_START, data: attributes };
179
- case 'agent.iteration':
179
+ case 'agent.step':
180
180
  // 迭代开始,MetricsAggregator 不直接处理这个
181
181
  return null;
182
182
  default:
@@ -30,8 +30,8 @@ export declare class TraceCollector {
30
30
  private logger;
31
31
  private metrics;
32
32
  private config;
33
- private turnCount;
34
- private currentTurnId?;
33
+ private stepCount;
34
+ private currentStepId?;
35
35
  constructor(config?: TraceCollectorConfig);
36
36
  /**
37
37
  * 包装引擎事件流,自动记录 trace
@@ -55,12 +55,12 @@ export declare class TraceCollector {
55
55
  *
56
56
  * @param event - AgentEvent
57
57
  * @param ctx - 会话上下文
58
- * @param turnId - 轮次 id(可选)
58
+ * @param stepId - 轮次 id(可选)
59
59
  */
60
60
  record(event: AgentEvent, ctx?: {
61
61
  sessionId?: string;
62
62
  agentId?: string;
63
- }, turnId?: string): void;
63
+ }, stepId?: string): void;
64
64
  /**
65
65
  * 记录单个事件
66
66
  */
@@ -82,7 +82,7 @@ export declare class TraceCollector {
82
82
  recordSessionState(ctx: {
83
83
  sessionId: string;
84
84
  messageCount: number;
85
- turnCount: number;
85
+ stepCount: number;
86
86
  sessionSize?: string;
87
87
  agentId?: string;
88
88
  }): void;
@@ -14,8 +14,8 @@ export class TraceCollector {
14
14
  logger;
15
15
  metrics;
16
16
  config;
17
- turnCount = 0;
18
- currentTurnId;
17
+ stepCount = 0;
18
+ currentStepId;
19
19
  constructor(config) {
20
20
  this.config = {
21
21
  captureStreamDeltas: false,
@@ -43,22 +43,22 @@ export class TraceCollector {
43
43
  * @yields 原始事件(不修改)
44
44
  */
45
45
  async *wrap(events, ctx = {}) {
46
- const turnId = `turn_${++this.turnCount}`;
47
- this.currentTurnId = turnId;
48
- this.logger.info(TRACE_EVENTS.TURN_START, { turnId }, ctx);
49
- let sawTurnEnd = false;
46
+ const stepId = `step_${++this.stepCount}`;
47
+ this.currentStepId = stepId;
48
+ this.logger.info(TRACE_EVENTS.STEP_START, { stepId }, ctx);
49
+ let sawStepEnd = false;
50
50
  for await (const event of events) {
51
- if (event.type === 'turn.end')
52
- sawTurnEnd = true;
51
+ if (event.type === 'step.end')
52
+ sawStepEnd = true;
53
53
  // 记录到 trace
54
- this.recordEvent(event, ctx, turnId);
54
+ this.recordEvent(event, ctx, stepId);
55
55
  // 原样传递
56
56
  yield event;
57
57
  }
58
- // 收口行仅在事件流自身无 turn.end 时补——recordEvent 已把 turn.end 映射为 TURN_END,
59
- // 再补一行即双计(turn 统计翻倍)
60
- if (!sawTurnEnd) {
61
- this.logger.info(TRACE_EVENTS.TURN_END, { turnId }, ctx);
58
+ // 收口行仅在事件流自身无 step.end 时补——recordEvent 已把 step.end 映射为 STEP_END,
59
+ // 再补一行即双计(step 统计翻倍)
60
+ if (!sawStepEnd) {
61
+ this.logger.info(TRACE_EVENTS.STEP_END, { stepId }, ctx);
62
62
  }
63
63
  }
64
64
  /**
@@ -74,17 +74,17 @@ export class TraceCollector {
74
74
  *
75
75
  * @param event - AgentEvent
76
76
  * @param ctx - 会话上下文
77
- * @param turnId - 轮次 id(可选)
77
+ * @param stepId - 轮次 id(可选)
78
78
  */
79
- record(event, ctx = {}, turnId = `turn_${++this.turnCount}`) {
80
- if (!this.currentTurnId)
81
- this.currentTurnId = turnId;
82
- this.recordEvent(event, ctx, turnId);
79
+ record(event, ctx = {}, stepId = `step_${++this.stepCount}`) {
80
+ if (!this.currentStepId)
81
+ this.currentStepId = stepId;
82
+ this.recordEvent(event, ctx, stepId);
83
83
  }
84
84
  /**
85
85
  * 记录单个事件
86
86
  */
87
- recordEvent(event, ctx, turnId) {
87
+ recordEvent(event, ctx, stepId) {
88
88
  const base = {
89
89
  sessionId: event.sessionId ?? ctx.sessionId,
90
90
  agentId: event.agentId ?? ctx.agentId,
@@ -94,19 +94,18 @@ export class TraceCollector {
94
94
  case 'engine.start':
95
95
  this.logger.info(TRACE_EVENTS.ENGINE_START, event.data, base);
96
96
  break;
97
- // Runner 词表:iteration.start ≈ turn 开始
98
- case 'iteration.start':
99
- case 'turn.start':
100
- this.logger.info(TRACE_EVENTS.TURN_START, { turnId }, base);
97
+ // step.start = 模型轮开始
98
+ case 'step.start':
99
+ this.logger.info(TRACE_EVENTS.STEP_START, { stepId }, base);
101
100
  break;
102
- // Runner 词表:turn.end 携带 usage。F3-c 起不再冒充 model.call.end
101
+ // Runner 词表:step.end 携带 usage。F3-c 起不再冒充 model.call.end
103
102
  //(LoopObserver 的 model.call.end 才带 durationMs/ttft;两行各归各位,p50/p95 取数不双计。
104
- // F3-d 起 turn.end 事件还带 llmTiming 供 UI timeline 展示,本白名单仍不落盘——trace 指标只认 model.call.*)
105
- case 'turn.end':
106
- this.logger.info(TRACE_EVENTS.TURN_END, {
103
+ // F3-d 起 step.end 事件还带 llmTiming 供 UI timeline 展示,本白名单仍不落盘——trace 指标只认 model.call.*)
104
+ case 'step.end':
105
+ this.logger.info(TRACE_EVENTS.STEP_END, {
107
106
  contentLength: event.data?.content?.length ?? 0,
108
107
  usage: event.data?.usage,
109
- turnId,
108
+ stepId,
110
109
  }, base);
111
110
  break;
112
111
  case 'model.call.start':
@@ -115,7 +114,7 @@ export class TraceCollector {
115
114
  callId: event.data?.callId,
116
115
  reqChars: event.data?.reqChars,
117
116
  toolChars: event.data?.toolChars,
118
- turnId,
117
+ stepId,
119
118
  }, base);
120
119
  break;
121
120
  case 'model.call.end':
@@ -130,7 +129,7 @@ export class TraceCollector {
130
129
  contentLength: event.data?.content?.length ?? 0,
131
130
  toolCallCount: event.data?.toolCallCount ?? 0,
132
131
  usage: event.data?.usage,
133
- turnId,
132
+ stepId,
134
133
  }, base);
135
134
  break;
136
135
  // Runner 收口计时(wait/build/run_end;`[timing]` 探针转正,F3)
@@ -140,7 +139,7 @@ export class TraceCollector {
140
139
  case 'model.call.error':
141
140
  this.logger.error(TRACE_EVENTS.MODEL_CALL_ERROR, {
142
141
  error: event.data?.error,
143
- turnId,
142
+ stepId,
144
143
  }, base);
145
144
  break;
146
145
  // ── 工具执行 ──
@@ -148,14 +147,14 @@ export class TraceCollector {
148
147
  this.logger.info(TRACE_EVENTS.TOOL_EXEC_START, {
149
148
  toolName: event.data?.toolName,
150
149
  toolCallId: event.data?.toolCallId,
151
- turnId,
150
+ stepId,
152
151
  }, base);
153
152
  break;
154
153
  case 'tool.exec.end':
155
154
  this.logger.info(TRACE_EVENTS.TOOL_EXEC_END, {
156
155
  toolName: event.data?.toolName,
157
156
  hasError: event.data?.hasError,
158
- turnId,
157
+ stepId,
159
158
  }, base);
160
159
  break;
161
160
  // ── 流式 delta(TRACE 级别,数据量大) ──
@@ -163,7 +162,7 @@ export class TraceCollector {
163
162
  if (this.config.captureStreamDeltas) {
164
163
  this.logger.trace(TRACE_EVENTS.MODEL_STREAM_DELTA, {
165
164
  delta: event.data?.delta,
166
- turnId,
165
+ stepId,
167
166
  }, base);
168
167
  }
169
168
  break;
@@ -171,7 +170,7 @@ export class TraceCollector {
171
170
  case 'retry':
172
171
  this.logger.warn(TRACE_EVENTS.MODEL_RETRY, {
173
172
  delayMs: event.data?.delayMs,
174
- turnId,
173
+ stepId,
175
174
  }, base);
176
175
  break;
177
176
  // ── 安全 ──