@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,333 @@
1
+ /**
2
+ * browser-types — 浏览器操作契约(arch/browser-capability.md §3.2)
3
+ *
4
+ * 契约住在 Harness(与 `web-search-types.ts` 同模式):工具面消费这些类型,
5
+ * `integration/browser/*` 实现之(依赖方向:Integration → Harness,边界测试强制)。
6
+ *
7
+ * 效应语义(arch/browser-capability.md §3.6):
8
+ * - 浏览器 = 网络出口(外泄通道)+ 不可逆外部写;工具面须走确认闸门/审计。
9
+ * - {@link BrowserSession.inspectAction} 在执行前暴露敏感效应分类(密码字段 /
10
+ * 表单提交),由工具层决定是否过 {@link import('@octopi-agent/core/types.js').HitlDecision}。
11
+ * - ref 生命周期绑定快照代数:导航/上下文失效后旧 ref 一律 `stale_ref` 报错,
12
+ * 不静默重试(避免对错误元素操作)。
13
+ */
14
+ /** 浏览器会话 ID(跨工具↔集成边界的品牌 ID) */
15
+ /** 默认工具/动作超时(毫秒;`browser.timeoutMs` 可覆盖)——工具定义与驱动共用一个源 */
16
+ export declare const BROWSER_DEFAULT_TIMEOUT_MS = 30000;
17
+ export type BrowserSessionId = string & {
18
+ readonly __brand: 'BrowserSessionId';
19
+ };
20
+ /** 快照元素引用(绑定快照代数,导航后失效) */
21
+ export type ElementRef = string & {
22
+ readonly __brand: 'ElementRef';
23
+ };
24
+ /** 后端引擎标识(arch/browser-capability.md §3.3 后端矩阵) */
25
+ export type BrowserEngineId = 'playwright' | 'rebrowser' | 'camoufox' | 'cdp-attach' | 'cloud';
26
+ /** 拟人化节流参数(P3;区间 [min,max] 毫秒随机;0 = 关闭该维度) */
27
+ export interface HumanizeOptions {
28
+ /** 逐键打字延迟区间(默认 [20, 80]) */
29
+ typingDelayMs?: [number, number];
30
+ /** 动作间抖动区间(默认 [100, 600]) */
31
+ actionJitterMs?: [number, number];
32
+ /** 动作重试上限(默认 2;有界重试,禁止重试风暴) */
33
+ maxRetries?: number;
34
+ }
35
+ /** stealth 配置(P3;arch/browser-capability.md §3.5/§3.6) */
36
+ export interface BrowserStealthConfig {
37
+ /** engine=stealth 的后端链(`->` 分隔,缺省 `rebrowser->camoufox`) */
38
+ fallback?: string;
39
+ /** 行为拟人化节流(stealth 引擎缺省启用) */
40
+ humanize?: HumanizeOptions;
41
+ }
42
+ /** 会话身份三型 */
43
+ export interface BrowserIdentity {
44
+ kind: 'incognito' | 'profile' | 'attach';
45
+ profileId?: string;
46
+ }
47
+ /** 启动选项(P1:无痕单页;持久 profile = P2) */
48
+ export interface BrowserLaunchOptions {
49
+ /** 默认 true(无头);HITL 场景可有头 */
50
+ headless?: boolean;
51
+ /**
52
+ * 浏览器来源:`chromium` = 管理版 Chromium(`octopi browser install`);
53
+ * `chrome` = 系统安装的 Google Chrome(零下载)。
54
+ */
55
+ channel?: 'chromium' | 'chrome';
56
+ viewport?: {
57
+ width: number;
58
+ height: number;
59
+ };
60
+ locale?: string;
61
+ timeoutMs?: number;
62
+ /** 会话归属 key(service 层设置;显式引用校验用,防跨会话操作) */
63
+ ownerKey?: string;
64
+ /** 请求级策略(URL 判定/写确认/账本);缺省 = 无策略(仅裸端口直用时允许) */
65
+ policy?: BrowserRequestPolicy;
66
+ /** P3:拟人化节流参数(会话消费逐键打字延迟;工具层消费抖动/重试) */
67
+ humanize?: HumanizeOptions;
68
+ /** 持久 profile ID(P2:identity.kind='profile';storageState 归档/恢复) */
69
+ profileId?: string;
70
+ /** profile 存储目录(`OCTOPI_HOME/browser-profiles`;assemble 注入) */
71
+ profileDir?: string;
72
+ /** 关闭时归档 storageState(缺省 false;与 profileId/profileDir 同用) */
73
+ persistProfile?: boolean;
74
+ }
75
+ /**
76
+ * 请求级策略(arch/browser-capability.md §3.6)。
77
+ * 在**网络请求层**收口(CDP Fetch 域逐请求暂停;`context.route` 不触发于重定向跳,
78
+ * 已弃用):覆盖重定向、子资源、
79
+ * 页内点击导航——策略判定是单一实现,DOM 层敏感标记只是提前预判。
80
+ */
81
+ export interface BrowserRequestPolicy {
82
+ /** 每个网络请求的 URL 判定;抛错 = 拦截该请求 */
83
+ checkUrl(url: string): Promise<void>;
84
+ /**
85
+ * 外部写确认闸门:**所有非 GET 请求**触发(P2 收紧:含 fetch/XHR;P1 只闸文档导航)。
86
+ * `documentLevel` = 文档级提交(表单/上传语义);false = 页内脚本写入。
87
+ * false = 拦截。工具层按 `method+origin` 做会话级审批缓存,避免同源重复确认。
88
+ */
89
+ confirmWrite(intent: {
90
+ method: string;
91
+ url: string;
92
+ documentLevel: boolean;
93
+ }): Promise<boolean>;
94
+ /** 账本回调(写尝试/拦截;fire-and-forget) */
95
+ record?(event: BrowserPolicyEvent): void;
96
+ }
97
+ export interface BrowserPolicyEvent {
98
+ kind: 'write.attempt' | 'write.blocked' | 'blocked';
99
+ url: string;
100
+ method?: string;
101
+ reason?: string;
102
+ }
103
+ /** attach 用户真实浏览器(P2;经 connectOverCDP,复用其登录/指纹) */
104
+ export interface BrowserAttachOptions {
105
+ /** CDP 端点(ws://… 或 http://127.0.0.1:9222;缺省后者) */
106
+ endpoint?: string;
107
+ timeoutMs?: number;
108
+ /** 会话归属 key(同 launch) */
109
+ ownerKey?: string;
110
+ /** 请求级策略(同 launch;attach 会话同样逐请求收口) */
111
+ policy?: BrowserRequestPolicy;
112
+ }
113
+ /** 会话摘要(list) */
114
+ export interface BrowserSessionInfo {
115
+ id: BrowserSessionId;
116
+ engine: BrowserEngineId;
117
+ identity: BrowserIdentity;
118
+ url?: string;
119
+ }
120
+ export interface GotoOptions {
121
+ waitUntil?: 'load' | 'domcontentloaded' | 'networkidle';
122
+ timeoutMs?: number;
123
+ }
124
+ export interface GotoResult {
125
+ url: string;
126
+ title: string;
127
+ /**
128
+ * HTTP 状态码。**同文档导航/`about:blank` 无 HTTP 响应时省略**——
129
+ * 不编造 200(AGENTS.md no-fake-data)。
130
+ */
131
+ status?: number;
132
+ }
133
+ /** 挑战页情报(启发式识别;见 arch/browser-capability.md §3.7) */
134
+ export interface ChallengeInfo {
135
+ kind: 'captcha' | 'interstitial';
136
+ /** 命中的识别标记(如实透出,供人/模型判断) */
137
+ marker: string;
138
+ }
139
+ /**
140
+ * 确定性结构化抽取规格(P2):字段名 → CSS 选择器 + 可选属性。
141
+ * 不做语义理解(那是模型自己的活);只做 DOM 查询,结果为真实数据或 null。
142
+ */
143
+ export interface ExtractFieldSpec {
144
+ selector: string;
145
+ /** 取元素属性;缺省取文本(textContent 去空白);属性缺失 = null */
146
+ attribute?: string;
147
+ /** 取全部匹配(数组);缺省取第一个 */
148
+ multiple?: boolean;
149
+ /** multiple 数组上限(缺省 50,防整表进上下文;超限截断) */
150
+ maxItems?: number;
151
+ }
152
+ export type ExtractSpec = Record<string, ExtractFieldSpec>;
153
+ /**
154
+ * 抽取结果:字段 → 字符串 / `Array<string | null>`(multiple;属性缺失项为 null)/ null
155
+ * (无匹配 = null,不编造)。
156
+ */
157
+ export type ExtractResult = Record<string, string | Array<string | null> | null>;
158
+ /**
159
+ * 抽取产出(P2 预算语义,评审 N5):数据 + 截断标记 + multiple 命中总数
160
+ * (`counts` 让调用方知道被 maxItems 截断前的真实条数——"50 条不是全部")。
161
+ */
162
+ export interface ExtractOutcome {
163
+ data: ExtractResult;
164
+ truncated: boolean;
165
+ counts?: Record<string, number>;
166
+ }
167
+ export interface SnapshotOptions {
168
+ /** 只列可交互元素(省 token) */
169
+ interactiveOnly?: boolean;
170
+ /** 序列化预算(字符);超出截断并标 truncated */
171
+ maxChars?: number;
172
+ }
173
+ /** 快照元素语义标签(敏感效应判定 + 语义提示) */
174
+ export type SnapshotTag = 'submit' | 'password' | 'file' | 'heading';
175
+ /** 快照条目:可交互元素(带 ref)或纯文本流 */
176
+ export type SnapshotItem = {
177
+ ref: ElementRef;
178
+ role: string;
179
+ name: string;
180
+ value?: string;
181
+ checked?: boolean;
182
+ tags?: SnapshotTag[];
183
+ } | {
184
+ ref?: undefined;
185
+ role: 'text' | 'heading';
186
+ name: string;
187
+ };
188
+ export interface PageSnapshot {
189
+ url: string;
190
+ title: string;
191
+ /** 文档序条目(可交互元素 + 文本流) */
192
+ items: SnapshotItem[];
193
+ /** 因 maxChars 预算截断 */
194
+ truncated?: boolean;
195
+ }
196
+ /** 页面动作(可辨识联合) */
197
+ export type PageAction = {
198
+ kind: 'click';
199
+ ref: ElementRef;
200
+ } | {
201
+ kind: 'fill';
202
+ ref: ElementRef;
203
+ value: string;
204
+ } | {
205
+ kind: 'select';
206
+ ref: ElementRef;
207
+ value: string;
208
+ } | {
209
+ kind: 'check';
210
+ ref: ElementRef;
211
+ } | {
212
+ kind: 'uncheck';
213
+ ref: ElementRef;
214
+ } | {
215
+ kind: 'hover';
216
+ ref: ElementRef;
217
+ } | {
218
+ kind: 'press';
219
+ key: string;
220
+ ref?: ElementRef;
221
+ } | {
222
+ kind: 'scroll';
223
+ deltaY: number;
224
+ } | {
225
+ kind: 'wait';
226
+ ms: number;
227
+ }
228
+ /** P2:向文件输入框上传本地文件(外部写;fileUpload 闸) */
229
+ | {
230
+ kind: 'upload';
231
+ ref: ElementRef;
232
+ path: string;
233
+ };
234
+ /** 动作意图预检(工具层确认闸门依据;基于快照元数据,不发浏览器往返) */
235
+ export interface ActionIntent {
236
+ action: PageAction;
237
+ /**
238
+ * 敏感效应分类:`false` = 常规;对象 = 需过确认闸门的不可逆外部写。
239
+ * `passwordField` = 向密码字段填写;`formSubmit` = 提交表单;`fileUpload` = 上传本地文件。
240
+ */
241
+ sensitive: false | {
242
+ kind: 'passwordField' | 'formSubmit' | 'fileUpload';
243
+ description: string;
244
+ };
245
+ /** 目标元素(审计/UI 展示) */
246
+ target?: {
247
+ role: string;
248
+ name: string;
249
+ };
250
+ }
251
+ export interface ActResult {
252
+ ok: true;
253
+ url: string;
254
+ title: string;
255
+ }
256
+ export interface ScreenshotOptions {
257
+ fullPage?: boolean;
258
+ /** 元素截图(省略 = 视口/整页) */
259
+ ref?: ElementRef;
260
+ type?: 'png' | 'jpeg';
261
+ }
262
+ /**
263
+ * 截图结果。**数据不进 LLM 工具结果**(工具结果在 LLM 边界是纯文本序列化,
264
+ * 见 core `normalizeMessagesForLlm`):工具面落盘后返回路径。
265
+ */
266
+ export interface ScreenshotResult {
267
+ mimeType: string;
268
+ data: Uint8Array;
269
+ }
270
+ /** 浏览器端口(integration/browser 实现) */
271
+ export interface BrowserPort {
272
+ launch(options?: BrowserLaunchOptions): Promise<BrowserSession>;
273
+ /** P2:attach 用户真实浏览器(CDP) */
274
+ attach(options?: BrowserAttachOptions): Promise<BrowserSession>;
275
+ list(): Promise<BrowserSessionInfo[]>;
276
+ }
277
+ /** stealth 链服务(P3)的挑战轮换原语;非链式服务不实现(工具层视同链穷尽) */
278
+ export interface StealthRotatable {
279
+ /**
280
+ * 挑战驱动的后端轮换:关掉该 key 当前会话并切到链上下一后端。
281
+ *
282
+ * @param sessionKey - 会话归属 key(acquire 时的 key)
283
+ * @returns true=已轮换(调用方重新 acquire 重试一次);false=链已穷尽(走 HITL)
284
+ */
285
+ rotateAfterChallenge(sessionKey: string): Promise<boolean>;
286
+ }
287
+ /** 单会话页面面(P1 单页;多标签 P2+) */
288
+ export interface BrowserSession {
289
+ readonly id: BrowserSessionId;
290
+ readonly engine: BrowserEngineId;
291
+ readonly identity: BrowserIdentity;
292
+ /** 会话归属 key(创建时的 sessionKey;显式引用须同 owner) */
293
+ readonly ownerKey: string;
294
+ /** 当前页面 URL(未导航时 about:blank) */
295
+ readonly url: string;
296
+ goto(url: string, options?: GotoOptions): Promise<GotoResult>;
297
+ snapshot(options?: SnapshotOptions): Promise<PageSnapshot>;
298
+ /**
299
+ * 动作预检:暴露敏感效应分类(不执行动作)。
300
+ * 元数据来源 = 快照时刻;ref 过期由后续 `act` 的 stale_ref 兜底。
301
+ */
302
+ inspectAction(action: PageAction): Promise<ActionIntent>;
303
+ act(action: PageAction): Promise<ActResult>;
304
+ screenshot(options?: ScreenshotOptions): Promise<ScreenshotResult>;
305
+ /** 挑战页启发式识别(captcha/interstitial;无挑战返回 undefined) */
306
+ detectChallenge(): Promise<ChallengeInfo | undefined>;
307
+ /** 确定性结构化抽取(CSS 选择器 → 真实数据;无匹配字段为 null;带截断标记与命中数) */
308
+ extract(spec: ExtractSpec): Promise<ExtractOutcome>;
309
+ close(): Promise<void>;
310
+ }
311
+ /**
312
+ * 会话服务(工具面唯一入口;integration/browser/service.ts 实现)。
313
+ * 按会话 key(工具侧 = `context.sessionId`)取得/创建隐式会话;
314
+ * 显式 `session` 参数经 {@link byId} 直取。
315
+ */
316
+ export interface BrowserService {
317
+ /** 取得/创建 key 的隐式会话(已存在则复用) */
318
+ acquire(sessionKey: string, options?: BrowserLaunchOptions): Promise<BrowserSession>;
319
+ /** 只查不建:key 的既有隐式会话(无则 undefined) */
320
+ get(sessionKey: string): Promise<BrowserSession | undefined>;
321
+ /** 按会话 ID 直取(显式 session 参数) */
322
+ byId(id: BrowserSessionId): Promise<BrowserSession | undefined>;
323
+ /** 关闭会话(隐式 key 或显式 ID 同参);返回是否确实关闭过 */
324
+ close(sessionKeyOrId: string): Promise<boolean>;
325
+ /**
326
+ * P3(可选):挑战驱动的后端轮换(stealth 链)。true=已切下一后端(调用方重新
327
+ * acquire 重试一次);false=链已穷尽(走 HITL)。非链式服务不实现(视同 false)。
328
+ */
329
+ rotateAfterChallenge?(sessionKey: string): Promise<boolean>;
330
+ list(): Promise<BrowserSessionInfo[]>;
331
+ /** 进程/装配生命周期收尾:关掉全部会话并停止回收定时器 */
332
+ dispose(): Promise<void>;
333
+ }
@@ -0,0 +1,16 @@
1
+ /**
2
+ * browser-types — 浏览器操作契约(arch/browser-capability.md §3.2)
3
+ *
4
+ * 契约住在 Harness(与 `web-search-types.ts` 同模式):工具面消费这些类型,
5
+ * `integration/browser/*` 实现之(依赖方向:Integration → Harness,边界测试强制)。
6
+ *
7
+ * 效应语义(arch/browser-capability.md §3.6):
8
+ * - 浏览器 = 网络出口(外泄通道)+ 不可逆外部写;工具面须走确认闸门/审计。
9
+ * - {@link BrowserSession.inspectAction} 在执行前暴露敏感效应分类(密码字段 /
10
+ * 表单提交),由工具层决定是否过 {@link import('@octopi-agent/core/types.js').HitlDecision}。
11
+ * - ref 生命周期绑定快照代数:导航/上下文失效后旧 ref 一律 `stale_ref` 报错,
12
+ * 不静默重试(避免对错误元素操作)。
13
+ */
14
+ /** 浏览器会话 ID(跨工具↔集成边界的品牌 ID) */
15
+ /** 默认工具/动作超时(毫秒;`browser.timeoutMs` 可覆盖)——工具定义与驱动共用一个源 */
16
+ export const BROWSER_DEFAULT_TIMEOUT_MS = 30_000;
@@ -0,0 +1,64 @@
1
+ /**
2
+ * browser_* 工具面 — 浏览器操作五件套(arch/browser-capability.md §3.4)
3
+ *
4
+ * 效应纪律(§3.6):
5
+ * - 浏览器 = 网络出口(外泄通道)+ 不可逆外部写。URL 判定与外部写闸门在**请求层**
6
+ * 收口(BrowserRequestPolicy 注入会话;重定向/子资源/页内导航全覆盖),DOM 层
7
+ * 敏感标记(passwordField/formSubmit)只是提前预判——两层都过才执行。
8
+ * - 确认闸门复用 HitlDecision(confirmEffect 缺失时敏感动作 fail-closed 拒绝)。
9
+ * - 导航/写尝试/拦截经 recordOpsEvent 进统一效应账本。
10
+ * - 截图落盘经 fileEffects(L3 undo 记账),返回**路径**——工具结果在 LLM 边界是
11
+ * 纯文本序列化(core normalizeMessagesForLlm),图像数据不进上下文。
12
+ */
13
+ import type { RegisteredTool } from '@octopi-agent/core/types.js';
14
+ import type { BrowserService, BrowserStealthConfig, HumanizeOptions } from './browser-types.js';
15
+ export interface BrowserToolOptions {
16
+ /**
17
+ * 敏感动作确认闸门三档(2026-11-20 拍板,替代布尔组合):
18
+ * `strict` = 所有非 GET 过闸(含页内 fetch/XHR);`standard`(缺省)= 仅文档级
19
+ * (表单提交/密码/上传);`off` = 全放开。
20
+ */
21
+ confirm?: 'strict' | 'standard' | 'off';
22
+ /** P3:引擎名(humanize 缺省启用判定用;stealth/rebrowser/camoufox = 启用) */
23
+ engine?: string;
24
+ /** stealth(P3):humanize 拟人化节流由工具层消费(stealth 引擎缺省启用) */
25
+ stealth?: BrowserStealthConfig;
26
+ /** 持久 profile(P2):persist=关闭时归档 storageState;defaultProfile=隐式会话默认身份 */
27
+ profiles?: {
28
+ persist?: boolean;
29
+ defaultProfile?: string;
30
+ };
31
+ /** profile 存储目录(assemble 按 OCTOPI_HOME 注入) */
32
+ profileDir?: string;
33
+ urlPolicy?: {
34
+ /** 域名 allow(`*.suffix` 通配,匹配域及其子域);缺省 = 不限制 */
35
+ allow?: string[];
36
+ /** 域名 deny(优先于 allow) */
37
+ deny?: string[];
38
+ };
39
+ allowPrivateNetwork?: boolean;
40
+ timeoutMs?: number;
41
+ snapshotMaxChars?: number;
42
+ }
43
+ export declare function domainMatches(pattern: string, host: string): boolean;
44
+ export declare function assertBrowserUrlAllowed(rawUrl: string, options: {
45
+ urlPolicy?: BrowserToolOptions['urlPolicy'];
46
+ allowPrivateNetwork?: boolean;
47
+ }): Promise<void>;
48
+ /**
49
+ * 确认闸三档 → 单闸开关的唯一映射(DOM 闸与请求层闸共用;勿在调用点手写档位判断)。
50
+ *
51
+ * @param confirm - 三档配置(缺省 `standard`)
52
+ * @param kind - 闸门种类(`xhr` = 页内 fetch/XHR 外部写)
53
+ * @returns 该闸在当前档位下是否启用
54
+ */
55
+ export declare function confirmGateEnabled(confirm: BrowserToolOptions['confirm'], kind: 'passwordField' | 'formSubmit' | 'fileUpload' | 'xhr'): boolean;
56
+ /**
57
+ * 生效 humanize 参数:显式配置优先;stealth 系引擎(stealth/rebrowser/camoufox)
58
+ * 缺省启用;其余引擎无配置则不启用。
59
+ *
60
+ * @param opts - 工具选项(engine + stealth.humanize)
61
+ * @returns 生效参数;undefined = 不启用拟人化
62
+ */
63
+ export declare function effectiveHumanize(opts: BrowserToolOptions): Required<HumanizeOptions> | undefined;
64
+ export declare function createBrowserTools(service: BrowserService, options?: BrowserToolOptions): RegisteredTool[];