@pixelzx/genesis 2026.5.3-5 → 2026.5.5

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 (996) hide show
  1. package/CHANGELOG.md +8 -0
  2. package/dist/.buildstamp +1 -1
  3. package/dist/abort-t5XiT6Yl.js +201 -0
  4. package/dist/abort.runtime-C_xk0DkL.js +2 -0
  5. package/dist/abort.runtime.js +1 -1
  6. package/dist/accounts-B7yDKwxi.js +104 -0
  7. package/dist/accounts-CS7VL356.js +107 -0
  8. package/dist/accounts-XvHcAtMf.js +2 -0
  9. package/dist/acp-cli-B5H0nvID.js +2193 -0
  10. package/dist/acp-spawn-BRTMqPlq.js +2 -0
  11. package/dist/acp-spawn-Dsw3dzWY.js +1093 -0
  12. package/dist/acp-stateful-target-driver-BYhkJnyh.js +89 -0
  13. package/dist/action-agents-Ca9kTFvv.js +67 -0
  14. package/dist/action-focus-D4pT0hra.js +132 -0
  15. package/dist/action-help-DMzMxFEQ.js +7 -0
  16. package/dist/action-info-Dzn_fn6G.js +101 -0
  17. package/dist/action-kill-2AQuhnLy.js +33 -0
  18. package/dist/action-list-DI1M2pKU.js +21 -0
  19. package/dist/action-log-BVKGgOki.js +30 -0
  20. package/dist/action-send-CZ2wciMW.js +39 -0
  21. package/dist/action-spawn-BdclQLrK.js +47 -0
  22. package/dist/action-unfocus-DfQuRf8d.js +29 -0
  23. package/dist/actions.runtime-B2-oz_B6.js +5 -0
  24. package/dist/actions.runtime-BoUxrcw3.js +18 -0
  25. package/dist/actions.runtime.js +1 -1
  26. package/dist/agent-CnQ3yCIw.js +2 -0
  27. package/dist/agent-command-C4H_9c2N.js +874 -0
  28. package/dist/agent-harness-runtime-D2oXzgyL.js +144 -0
  29. package/dist/agent-runner-utils-CWgPcOYn.js +239 -0
  30. package/dist/agent-runner.runtime-DvK-HQhq.js +3455 -0
  31. package/dist/agent-runner.runtime.js +1 -1
  32. package/dist/agent-runtime-BDslXtCf.js +18 -0
  33. package/dist/agents-4T7YaeKy.js +953 -0
  34. package/dist/agents-C_Gty_RK.js +5 -0
  35. package/dist/aliases-BkVpehd-.js +96 -0
  36. package/dist/aliases-DWkJWJ5A.js +2 -0
  37. package/dist/api-CgW6fcU2.js +3 -0
  38. package/dist/api-DYPaGKUj.js +5 -0
  39. package/dist/api-DdoV90Cn.js +139 -0
  40. package/dist/approval-gateway-resolver-Ba_2kb3B.js +29 -0
  41. package/dist/approval-gateway-runtime-7VMivk0A.js +2 -0
  42. package/dist/approval-handler-runtime-DUDpOwG7.js +439 -0
  43. package/dist/approval-native-runtime-KkmX9gwQ.js +729 -0
  44. package/dist/attempt-execution.runtime-CQkeVpDx.js +509 -0
  45. package/dist/attempt-execution.runtime.js +1 -1
  46. package/dist/attempt.prompt-helpers-MoT6VaD0.js +221 -0
  47. package/dist/attempt.tool-run-context-B53GhX-d.js +933 -0
  48. package/dist/audit-CvHcVVb-.js +939 -0
  49. package/dist/audit.runtime-C7n442Rc.js +7 -0
  50. package/dist/audit.runtime.js +1 -1
  51. package/dist/auth-CAnSldtM.js +2 -0
  52. package/dist/auth-Czf_o5iE.js +383 -0
  53. package/dist/auth-order-Cu9Vj7lA.js +96 -0
  54. package/dist/auth-order-q1IFw7L3.js +2 -0
  55. package/dist/bash-tools-BS4TrA4X.js +2824 -0
  56. package/dist/bash-tools-DbHYuk8O.js +3 -0
  57. package/dist/binding-routing-CnNQE65Q.js +85 -0
  58. package/dist/binding-targets-DW0ScIRI.js +121 -0
  59. package/dist/bridge-server-BGS08n2f.js +113 -0
  60. package/dist/browser-control-auth-DMlQOsyN.js +2 -0
  61. package/dist/browser-node-runtime-CF32scUO.js +12 -0
  62. package/dist/browser-profiles-CmER65eh.js +2 -0
  63. package/dist/browser-runtime-D73M9fg3.js +387 -0
  64. package/dist/browser-setup-tools-Cr0UI1rf.js +13 -0
  65. package/dist/build-BL7WirDF.js +550 -0
  66. package/dist/build-info.json +3 -3
  67. package/dist/bundled/boot-md/handler.js +2 -2
  68. package/dist/bundled/session-memory/handler.js +1 -1
  69. package/dist/call-Ckws4Nlw.js +3 -0
  70. package/dist/call-DkGNVvLy.js +331 -0
  71. package/dist/call.runtime-DfLBtAIr.js +2 -0
  72. package/dist/call.runtime.js +1 -1
  73. package/dist/capability-cli-tSqSJf2o.js +1401 -0
  74. package/dist/catchup-Dp2L1RcY.js +300 -0
  75. package/dist/channel-BIFp1GJd.js +1320 -0
  76. package/dist/channel-BZMzoXhw.js +840 -0
  77. package/dist/channel-BtPZ0i4g.js +297 -0
  78. package/dist/channel-DDd7xwLG.js +226 -0
  79. package/dist/channel-DLezQPqR.js +350 -0
  80. package/dist/channel-DcYHXn_7.js +1100 -0
  81. package/dist/channel-DzKtLfJj.js +1802 -0
  82. package/dist/channel-LlY18tI5.js +595 -0
  83. package/dist/channel-NjZviHcJ.js +1174 -0
  84. package/dist/channel-core-Cg1mFpva.js +5 -0
  85. package/dist/channel-inbound-CZpi-vp5.js +31 -0
  86. package/dist/channel-pDXIWFS4.js +453 -0
  87. package/dist/channel-plugin-runtime-DHl81Ror.js +771 -0
  88. package/dist/channel-runtime-CtYrrwow.js +425 -0
  89. package/dist/channel-wMkGGyIY.js +491 -0
  90. package/dist/channel.runtime-B1n0hvUI.js +430 -0
  91. package/dist/channel.runtime-B9iR26l_.js +576 -0
  92. package/dist/channel.runtime-C8eBQk67.js +4 -0
  93. package/dist/channel.runtime-Db8g8JCg.js +89 -0
  94. package/dist/channel.runtime-DfRfisV2.js +34702 -0
  95. package/dist/channel.runtime-gPdBMu3V.js +109 -0
  96. package/dist/channel.runtime-rG9pJ5NO.js +2364 -0
  97. package/dist/channel.runtime.js +1 -1
  98. package/dist/channel.setup-CWblUOhD.js +10 -0
  99. package/dist/channels-B4dYRKsI.js +733 -0
  100. package/dist/channels-cli-GMAOUYU3.js +268 -0
  101. package/dist/chat-D2XaZNiP.js +2758 -0
  102. package/dist/clawbot-cli-CSmdcIMT.js +9 -0
  103. package/dist/cli/daemon-cli.js +3 -3
  104. package/dist/cli-2u5IZTMS.js +219 -0
  105. package/dist/cli-Bk8uXnyc.js +72 -0
  106. package/dist/cli-DBfw9jCz.js +2 -0
  107. package/dist/cli-runner-BEqvX1ky.js +286 -0
  108. package/dist/cli-runner.runtime-BIUcUGDa.js +4 -0
  109. package/dist/cli-runner.runtime-D2u3Yw0W.js +3 -0
  110. package/dist/cli-runner.runtime.js +1 -1
  111. package/dist/cli-startup-metadata.json +2 -2
  112. package/dist/cli-waH8839u.js +2 -0
  113. package/dist/cli.runtime-mKvJpLwI.js +1261 -0
  114. package/dist/cli.runtime.js +1 -1
  115. package/dist/client-CKizOsGp.js +138 -0
  116. package/dist/client-CrPccv7a.js +713 -0
  117. package/dist/command-auth-DPkjKHdv.js +76 -0
  118. package/dist/command-config-resolution-BTjtnAp2.js +2 -0
  119. package/dist/command-config-resolution-Be3KZA_l.js +23 -0
  120. package/dist/command-config-resolution.runtime-DXgL8cm7.js +2 -0
  121. package/dist/command-config-resolution.runtime.js +1 -1
  122. package/dist/command-registry-BL1Z4Cen.js +4 -0
  123. package/dist/command-registry-BMePAw9w.js +9 -0
  124. package/dist/command-registry-core-CAay55-n.js +104 -0
  125. package/dist/command-secret-gateway-jj1Qmk9L.js +528 -0
  126. package/dist/command-status.runtime-BVcCm9_0.js +87 -0
  127. package/dist/command-status.runtime.js +1 -1
  128. package/dist/commands-acp-COdUW69f.js +77 -0
  129. package/dist/commands-compact.runtime-C0Fedews.js +10 -0
  130. package/dist/commands-compact.runtime.js +1 -1
  131. package/dist/commands-handlers.runtime-BXVM3PWG.js +4597 -0
  132. package/dist/commands-handlers.runtime.js +1 -1
  133. package/dist/commands-status-DaApOLoQ.js +16 -0
  134. package/dist/commands-status.runtime-CxSjrKne.js +3 -0
  135. package/dist/commands-status.runtime.js +1 -1
  136. package/dist/commands-subagents-control.runtime-BEfW44br.js +2 -0
  137. package/dist/commands-subagents-control.runtime-DB3AROHI.js +3 -0
  138. package/dist/commands-subagents-control.runtime.js +1 -1
  139. package/dist/commands-system-prompt-CCrUy7xq.js +158 -0
  140. package/dist/commands-system-prompt-CN56TtaC.js +2 -0
  141. package/dist/commands.runtime-Bee6dM3V.js +166 -0
  142. package/dist/commands.runtime.js +1 -1
  143. package/dist/compact-7YtEe1kG.js +1118 -0
  144. package/dist/compact.runtime-4gW_cs7D.js +12 -0
  145. package/dist/compact.runtime.js +1 -1
  146. package/dist/completion-cli-COv-r8_h.js +313 -0
  147. package/dist/config-DSsLlg8J.js +251 -0
  148. package/dist/config-cli-C9oGe9gl.js +1078 -0
  149. package/dist/configure-Bfy9tVmS.js +2 -0
  150. package/dist/configure-DpIFRaAD.js +1245 -0
  151. package/dist/connect-options-CPixzqP_.js +699 -0
  152. package/dist/control-auth-L7U2ivRJ.js +125 -0
  153. package/dist/control-service-CbUz8qU5.js +156 -0
  154. package/dist/conversation-id-BroDIGeT.js +38 -0
  155. package/dist/conversation-id-CuVi0tWe.js +235 -0
  156. package/dist/conversation-runtime-weaahZQN.js +31 -0
  157. package/dist/core-PXv1nsc-.js +275 -0
  158. package/dist/cron-cli-DZNSQBuA.js +713 -0
  159. package/dist/daemon-cli-C_9CNoZA.js +12 -0
  160. package/dist/delegate-B8wh-jjf.js +64 -0
  161. package/dist/detached-task-runtime-BTq-jIGw.js +73 -0
  162. package/dist/devices-cli-C_amY-AS.js +496 -0
  163. package/dist/diagnostics-Bw-fd0ug.js +154 -0
  164. package/dist/direct-dm-Dvqjch3O.js +64 -0
  165. package/dist/dispatch-DHPQS49Q.js +1131 -0
  166. package/dist/dispatch-acp-manager.runtime-y-oykPUz.js +3 -0
  167. package/dist/dispatch-acp-manager.runtime.js +1 -1
  168. package/dist/dispatch-acp-taSuJD5W.js +981 -0
  169. package/dist/dispatch-acp.runtime-DgyaFFNX.js +19 -0
  170. package/dist/dispatch-acp.runtime.js +1 -1
  171. package/dist/doctor-device-pairing-rxwogzYF.js +307 -0
  172. package/dist/doctor-gateway-daemon-flow-Dm4wxnTt.js +250 -0
  173. package/dist/doctor-gateway-health-wJVW5xUW.js +60 -0
  174. package/dist/doctor-health-DaodspKU.js +59 -0
  175. package/dist/doctor-health-contributions-CBVyN6ju.js +486 -0
  176. package/dist/doctor-prompter-vO6LPeXZ.js +56 -0
  177. package/dist/doctor-workspace-status-BnXA04-6.js +75 -0
  178. package/dist/dreaming-1RLie1iF.js +1574 -0
  179. package/dist/dreaming-narrative-BRtTdpbt.js +595 -0
  180. package/dist/embedded-gateway-stub.runtime-GMix51Tf.js +9 -0
  181. package/dist/embedded-gateway-stub.runtime.js +1 -1
  182. package/dist/entry.js +2 -2
  183. package/dist/exec-approvals-cli-R6jgupQH.js +498 -0
  184. package/dist/extensionAPI.js +1 -1
  185. package/dist/extensions/active-memory/index.js +1 -1
  186. package/dist/extensions/bluebubbles/api.js +3 -3
  187. package/dist/extensions/bluebubbles/channel-plugin-api.js +1 -1
  188. package/dist/extensions/browser/browser-bridge.js +1 -1
  189. package/dist/extensions/browser/browser-config.js +4 -4
  190. package/dist/extensions/browser/browser-control-auth.js +2 -2
  191. package/dist/extensions/browser/browser-doctor.js +2 -2
  192. package/dist/extensions/browser/browser-maintenance.js +2 -2
  193. package/dist/extensions/browser/browser-profiles.js +2 -2
  194. package/dist/extensions/browser/browser-runtime-api.js +10 -10
  195. package/dist/extensions/browser/index.js +1 -1
  196. package/dist/extensions/browser/plugin-registration.js +1 -1
  197. package/dist/extensions/browser/register.runtime.js +3 -3
  198. package/dist/extensions/browser/runtime-api.js +11 -11
  199. package/dist/extensions/browser/test-support.js +1 -1
  200. package/dist/extensions/device-pair/api.js +1 -1
  201. package/dist/extensions/device-pair/index.js +3 -3
  202. package/dist/extensions/device-pair/notify.js +1 -1
  203. package/dist/extensions/device-pair/pair-command-approve.js +1 -1
  204. package/dist/extensions/google-meet/index.js +2 -2
  205. package/dist/extensions/imessage/api.js +3 -3
  206. package/dist/extensions/imessage/channel-plugin-api.js +1 -1
  207. package/dist/extensions/imessage/runtime-api.js +3 -3
  208. package/dist/extensions/irc/api.js +2 -2
  209. package/dist/extensions/irc/channel-plugin-api.js +1 -1
  210. package/dist/extensions/line/api.js +2 -2
  211. package/dist/extensions/line/channel-plugin-api.js +1 -1
  212. package/dist/extensions/line/contract-api.js +1 -1
  213. package/dist/extensions/line/runtime-api.js +4 -4
  214. package/dist/extensions/line/setup-api.js +1 -1
  215. package/dist/extensions/llm-task/index.js +2 -2
  216. package/dist/extensions/lobster/index.js +3 -3
  217. package/dist/extensions/lobster/runtime-api.js +1 -1
  218. package/dist/extensions/mattermost/api.js +1 -1
  219. package/dist/extensions/mattermost/channel-plugin-api.js +1 -1
  220. package/dist/extensions/mattermost/channel-plugin-runtime.js +1 -1
  221. package/dist/extensions/mattermost/policy-api.js +1 -1
  222. package/dist/extensions/mattermost/runtime-api.js +4 -4
  223. package/dist/extensions/mattermost/slash-route-api.js +1 -1
  224. package/dist/extensions/memory-core/api.js +1 -1
  225. package/dist/extensions/memory-core/cli-metadata.js +2 -2
  226. package/dist/extensions/memory-core/index.js +3 -3
  227. package/dist/extensions/memory-lancedb/cli-metadata.js +1 -1
  228. package/dist/extensions/msteams/api.js +1 -1
  229. package/dist/extensions/msteams/channel-plugin-api.js +1 -1
  230. package/dist/extensions/msteams/runtime-api.js +3 -3
  231. package/dist/extensions/msteams/test-api.js +1 -1
  232. package/dist/extensions/nextcloud-talk/api.js +1 -1
  233. package/dist/extensions/nextcloud-talk/channel-plugin-api.js +1 -1
  234. package/dist/extensions/nextcloud-talk/runtime-api.js +2 -2
  235. package/dist/extensions/openshell/index.js +2 -2
  236. package/dist/extensions/signal/api.js +6 -6
  237. package/dist/extensions/signal/channel-plugin-api.js +1 -1
  238. package/dist/extensions/signal/reaction-runtime-api.js +1 -1
  239. package/dist/extensions/signal/runtime-api.js +7 -7
  240. package/dist/extensions/skill-workshop/api.js +1 -1
  241. package/dist/extensions/skill-workshop/index.js +1 -1
  242. package/dist/extensions/synology-chat/api.js +1 -1
  243. package/dist/extensions/synology-chat/channel-plugin-api.js +1 -1
  244. package/dist/extensions/tlon/api.js +2 -2
  245. package/dist/extensions/tlon/channel-plugin-api.js +1 -1
  246. package/dist/extensions/tlon/runtime-api.js +1 -1
  247. package/dist/extensions/tlon/test-api.js +1 -1
  248. package/dist/extensions/twitch/api.js +1 -1
  249. package/dist/extensions/twitch/channel-plugin-api.js +1 -1
  250. package/dist/extensions/twitch/setup-plugin-api.js +1 -1
  251. package/dist/extensions/zalo/api.js +3 -3
  252. package/dist/extensions/zalo/channel-plugin-api.js +1 -1
  253. package/dist/extensions/zalo/runtime-api.js +2 -2
  254. package/dist/extensions/zalo/setup-api.js +2 -2
  255. package/dist/extensions/zalouser/api.js +3 -3
  256. package/dist/extensions/zalouser/channel-plugin-api.js +1 -1
  257. package/dist/extensions/zalouser/runtime-api.js +6 -6
  258. package/dist/extensions/zalouser/setup-plugin-api.js +1 -1
  259. package/dist/extensions/zalouser/test-api.js +1 -1
  260. package/dist/fallbacks-Cckv3nng.js +2 -0
  261. package/dist/fallbacks-Y_nNY8_a.js +31 -0
  262. package/dist/fallbacks-shared-DZiG1Gr_.js +111 -0
  263. package/dist/gateway-CDfn0J87.js +115 -0
  264. package/dist/gateway-cli-D197U6l0.js +1325 -0
  265. package/dist/gateway-rpc-Bomz8HKq.js +14 -0
  266. package/dist/gateway-rpc.runtime-597tksmo.js +23 -0
  267. package/dist/gateway-rpc.runtime.js +1 -1
  268. package/dist/gateway-runtime-Bm2_MhFn.js +15 -0
  269. package/dist/gateway-status-Cr4UJKUx.js +584 -0
  270. package/dist/genesis-tools-DCRaVVjY.js +8999 -0
  271. package/dist/genesis-tools.runtime-idgd5fjy.js +2 -0
  272. package/dist/genesis-tools.runtime.js +1 -1
  273. package/dist/get-reply-BF_7bR5f.js +3879 -0
  274. package/dist/get-reply-from-config.runtime-DEq5XM_s.js +2 -0
  275. package/dist/get-reply-from-config.runtime.js +1 -1
  276. package/dist/graph-users-Bhlw-_4i.js +1337 -0
  277. package/dist/health-9ifMvGZN.js +3 -0
  278. package/dist/health-CzOJa6SX.js +469 -0
  279. package/dist/heartbeat-runner-B2Tkbj5e.js +5 -0
  280. package/dist/heartbeat-runner-B63G8dbO.js +1292 -0
  281. package/dist/heartbeat-runner.runtime-QJ_2AMjN.js +4 -0
  282. package/dist/heartbeat-runner.runtime.js +1 -1
  283. package/dist/hooks-cli-ZWI1iJnh.js +433 -0
  284. package/dist/image-fallbacks-BpTfBvbi.js +2 -0
  285. package/dist/image-fallbacks-DpVwnB41.js +31 -0
  286. package/dist/inbound-reply-dispatch-mKybIcNA.js +73 -0
  287. package/dist/index.js +2 -2
  288. package/dist/infra-runtime-CvwvzUfM.js +39 -0
  289. package/dist/init-CWeM0DfJ.js +59 -0
  290. package/dist/library-ClQalZ3x.js +45 -0
  291. package/dist/lifecycle-CgV7Cgt-.js +571 -0
  292. package/dist/lifecycle-DVWaxj-A.js +229 -0
  293. package/dist/lifecycle.runtime-DErLwVJ_.js +2 -0
  294. package/dist/lifecycle.runtime.js +1 -1
  295. package/dist/list-5RIS3LMG.js +2 -0
  296. package/dist/list-BNesYDN2.js +2 -0
  297. package/dist/list-Dk1hCKis.js +1201 -0
  298. package/dist/list-eUjt_6__.js +131 -0
  299. package/dist/list.probe-C51ceJSY.js +419 -0
  300. package/dist/llm-slug-generator-D64IMUoy.js +79 -0
  301. package/dist/llm-slug-generator.js +1 -1
  302. package/dist/load-config-Ccss2uTi.js +35 -0
  303. package/dist/local-dispatch.runtime-u7Ir1N07.js +8 -0
  304. package/dist/local-dispatch.runtime.js +1 -1
  305. package/dist/logs-cli-BYHTboPa.js +265 -0
  306. package/dist/logs-cli.runtime-CQwNptr-.js +2 -0
  307. package/dist/logs-cli.runtime.js +1 -1
  308. package/dist/main-session-restart-recovery-CA9bvC1W.js +206 -0
  309. package/dist/managed-image-attachments-B_gpkI1u.js +635 -0
  310. package/dist/managed-image-attachments-C0Y6nAP2.js +2 -0
  311. package/dist/manager-DZGFArgz.js +2 -0
  312. package/dist/manager-Df8TC4rX.js +2057 -0
  313. package/dist/markdown-to-line-xXLdnzcE.js +790 -0
  314. package/dist/mcp/plugin-tools-serve.js +1 -1
  315. package/dist/mcp-cli-B50W9Pkc.js +725 -0
  316. package/dist/mcp-http-BiUGVpJ4.js +529 -0
  317. package/dist/memory-core-host-runtime-cli-UgLo6ezC.js +9 -0
  318. package/dist/message-C95gttLd.js +232 -0
  319. package/dist/message-action-runner-0KAp6ccG.js +1407 -0
  320. package/dist/message-action-runner-BSUDvECO.js +2 -0
  321. package/dist/message-actions-Be4Ob151.js +143 -0
  322. package/dist/message.gateway.runtime-DMMRMIln.js +2 -0
  323. package/dist/message.gateway.runtime.js +1 -1
  324. package/dist/models-auth-status-DhYxBz7G.js +201 -0
  325. package/dist/models-cli-C2prinXb.js +219 -0
  326. package/dist/monitor-BEI21vNQ.js +1661 -0
  327. package/dist/monitor-BUgTAJvZ.js +1237 -0
  328. package/dist/monitor-BdJRIhi1.js +2 -0
  329. package/dist/monitor-C7wuttQJ.js +1459 -0
  330. package/dist/monitor-DMumiWnt.js +788 -0
  331. package/dist/monitor-IQo2ExmV.js +671 -0
  332. package/dist/monitor-auth-DW0lvfm3.js +207 -0
  333. package/dist/monitor-processing-DTrsRdyz.js +1974 -0
  334. package/dist/monitor.runtime-DwqyCQcb.js +2 -0
  335. package/dist/monitor.runtime.js +1 -1
  336. package/dist/monitor.webhook-D11nrUh9.js +180 -0
  337. package/dist/msteams-DO-PW98M.js +35 -0
  338. package/dist/native-hook-relay-CNZrcPIw.js +519 -0
  339. package/dist/nextcloud-talk-BeYFnATY.js +17 -0
  340. package/dist/node-cli-BFrdTPdH.js +2506 -0
  341. package/dist/nodes-cli-B3Wj_MvP.js +1046 -0
  342. package/dist/nodes-utils-AsgrCa7K.js +84 -0
  343. package/dist/nodes.helpers-CMXxavTs.js +34 -0
  344. package/dist/notify-CNS0kRWM.js +315 -0
  345. package/dist/onboard-D4ehf66t.js +632 -0
  346. package/dist/onboard-helpers-DWxdMyCs.js +6 -0
  347. package/dist/onboard-helpers-o78s0lR1.js +204 -0
  348. package/dist/onboard-remote-Cc1XlRzr.js +193 -0
  349. package/dist/onboard-remote-D8THwo3P.js +2 -0
  350. package/dist/onboard-skills-B2VoCq7v.js +134 -0
  351. package/dist/onboard-skills-DtOgSJZo.js +2 -0
  352. package/dist/openai-http-DKQZWsqY.js +500 -0
  353. package/dist/openresponses-http-C4kol41X.js +1128 -0
  354. package/dist/operator-approvals-client-BoN_VmkB.js +68 -0
  355. package/dist/outbound.runtime-D-L8FN8E.js +2 -0
  356. package/dist/outbound.runtime.js +1 -1
  357. package/dist/pair-command-approve-DMeQ6uD4.js +44 -0
  358. package/dist/persistent-bindings.lifecycle-O-RnoTW4.js +2 -0
  359. package/dist/persistent-bindings.lifecycle-bptWQEFT.js +85 -0
  360. package/dist/pi-embedded-BM79sXqb.js +2905 -0
  361. package/dist/pi-embedded-BUDWcDt8.js +4 -0
  362. package/dist/pi-embedded.runtime-D53bCPOr.js +4 -0
  363. package/dist/pi-embedded.runtime.js +1 -1
  364. package/dist/pi-tool-definition-adapter-DdYQtumi.js +217 -0
  365. package/dist/pi-tools-ihbjTP0K.js +1057 -0
  366. package/dist/pi-tools.before-tool-call-DrEqr96j.js +433 -0
  367. package/dist/pi-tools.before-tool-call-VB9YEPOv.js +2 -0
  368. package/dist/plugin-DwNULpmw.js +12195 -0
  369. package/dist/plugin-enabled-DbO9GyRJ.js +140 -0
  370. package/dist/plugin-registration-Du6hgUkp.js +23 -0
  371. package/dist/plugin-sdk/.boundary-entry-shims.stamp +1 -1
  372. package/dist/plugin-sdk/acp-binding-runtime.js +1 -1
  373. package/dist/plugin-sdk/acp-runtime.js +2 -2
  374. package/dist/plugin-sdk/agent-harness-runtime.js +5 -5
  375. package/dist/plugin-sdk/agent-harness.js +6 -6
  376. package/dist/plugin-sdk/agent-runtime.js +2 -2
  377. package/dist/plugin-sdk/approval-gateway-runtime.js +2 -2
  378. package/dist/plugin-sdk/approval-handler-runtime.js +3 -3
  379. package/dist/plugin-sdk/approval-runtime.js +1 -1
  380. package/dist/plugin-sdk/browser-node-runtime.js +4 -4
  381. package/dist/plugin-sdk/browser-setup-tools.js +3 -3
  382. package/dist/plugin-sdk/browser-support.js +7 -7
  383. package/dist/plugin-sdk/channel-core.js +2 -2
  384. package/dist/plugin-sdk/channel-inbound.js +2 -2
  385. package/dist/plugin-sdk/command-auth.js +1 -1
  386. package/dist/plugin-sdk/command-status-runtime.js +1 -1
  387. package/dist/plugin-sdk/compat.js +1 -1
  388. package/dist/plugin-sdk/conversation-binding-runtime.js +1 -1
  389. package/dist/plugin-sdk/conversation-runtime.js +3 -3
  390. package/dist/plugin-sdk/core.js +2 -2
  391. package/dist/plugin-sdk/direct-dm.js +1 -1
  392. package/dist/plugin-sdk/gateway-runtime.js +3 -3
  393. package/dist/plugin-sdk/inbound-reply-dispatch.js +1 -1
  394. package/dist/plugin-sdk/index.js +1 -1
  395. package/dist/plugin-sdk/infra-runtime.js +2 -2
  396. package/dist/plugin-sdk/irc.js +2 -2
  397. package/dist/plugin-sdk/matrix.js +1 -1
  398. package/dist/plugin-sdk/memory-core-host-runtime-cli.js +2 -2
  399. package/dist/plugin-sdk/memory-core.js +2 -2
  400. package/dist/plugin-sdk/msteams.js +2 -2
  401. package/dist/plugin-sdk/nextcloud-talk.js +2 -2
  402. package/dist/plugin-sdk/nostr.js +1 -1
  403. package/dist/plugin-sdk/reply-dispatch-runtime.js +1 -1
  404. package/dist/plugin-sdk/reply-runtime.js +4 -4
  405. package/dist/plugin-sdk/runtime-secret-resolution.js +1 -1
  406. package/dist/plugin-sdk/runtime.js +2 -2
  407. package/dist/plugin-sdk/session-visibility.js +1 -1
  408. package/dist/plugin-sdk/testing.js +4 -4
  409. package/dist/plugin-sdk/tlon.js +1 -1
  410. package/dist/plugin-sdk/zalo.js +1 -1
  411. package/dist/plugin-sdk/zalouser.js +1 -1
  412. package/dist/plugin-service-DcSnRF5x.js +2890 -0
  413. package/dist/plugins/runtime/index.js +1 -1
  414. package/dist/policy-uc224usV.js +328 -0
  415. package/dist/postinstall-inventory.json +407 -407
  416. package/dist/prepare.runtime-BPA6jMiM.js +815 -0
  417. package/dist/prepare.runtime.js +1 -1
  418. package/dist/probe-5ToseFjd.js +1443 -0
  419. package/dist/probe-BdCXAH_u.js +2 -0
  420. package/dist/probe-ByVoZEdq.js +45 -0
  421. package/dist/probe-D-D_1oc4.js +241 -0
  422. package/dist/probe-D6s_1Z5k.js +2 -0
  423. package/dist/probe-DIMAmSsO.js +74 -0
  424. package/dist/probe-DYuL-s4A.js +2205 -0
  425. package/dist/program-DDTWTh6g.js +111 -0
  426. package/dist/prompt-select-styled-kf1dPqNa.js +20 -0
  427. package/dist/protocol-Batc2DmY.js +2234 -0
  428. package/dist/provider-dispatcher-DdUqCa6H.js +2 -0
  429. package/dist/provider-dispatcher-uioW38XW.js +22 -0
  430. package/dist/qr-cli-B1WUe8Eb.js +2 -0
  431. package/dist/qr-cli-DmPti3xe.js +349 -0
  432. package/dist/reaction-runtime-api-5G3e9J0C.js +116 -0
  433. package/dist/reactions-x7VH-B95.js +998 -0
  434. package/dist/register-service-commands-DcW5qPTu.js +71 -0
  435. package/dist/register.agent-Dtj4HC7R.js +248 -0
  436. package/dist/register.configure-CJHb84Ce.js +15 -0
  437. package/dist/register.maintenance-BUkPfMcX.js +438 -0
  438. package/dist/register.message-DGFpyYBl.js +329 -0
  439. package/dist/register.onboard-D3v3xIfF.js +81 -0
  440. package/dist/register.runtime-DI4QxYdj.js +81 -0
  441. package/dist/register.runtime.js +1 -1
  442. package/dist/register.setup-CXTyuIFM.js +150 -0
  443. package/dist/register.status-health-sessions-CYUnRi97.js +1215 -0
  444. package/dist/register.subclis-DKMVrwRc.js +3 -0
  445. package/dist/register.subclis-NWRi2XKp.js +29 -0
  446. package/dist/register.subclis-core-De6qmQkr.js +243 -0
  447. package/dist/reply-dispatch-runtime-B8_j6pJi.js +13 -0
  448. package/dist/reply-runtime-DGHQDC9d.js +11 -0
  449. package/dist/reply.runtime-BCfqw2Co.js +2 -0
  450. package/dist/reply.runtime.js +1 -1
  451. package/dist/restart-health-6cjrRBpF.js +202 -0
  452. package/dist/restart-health-b6Qw43Tj.js +2 -0
  453. package/dist/root-help-BTIH_eUe.js +44 -0
  454. package/dist/routes-C3J2GfHR.js +3341 -0
  455. package/dist/routes-SMmfW6k8.js +2 -0
  456. package/dist/rpc-DQbAcIKu.js +61 -0
  457. package/dist/rpc.runtime-Q3qyofLf.js +21 -0
  458. package/dist/rpc.runtime.js +1 -1
  459. package/dist/run-delivery.runtime-BsLouK3f.js +530 -0
  460. package/dist/run-delivery.runtime.js +1 -1
  461. package/dist/run-embedded.runtime-CXd0oZQP.js +4 -0
  462. package/dist/run-embedded.runtime.js +1 -1
  463. package/dist/run-execution-cli.runtime-D-MKbq8r.js +4 -0
  464. package/dist/run-execution-cli.runtime.js +1 -1
  465. package/dist/run-executor.runtime-Cz0I8mDt.js +277 -0
  466. package/dist/run-executor.runtime.js +1 -1
  467. package/dist/run-main-CkXBTQut.js +516 -0
  468. package/dist/run-subagent-registry.runtime-Cyb8amrH.js +2 -0
  469. package/dist/run-subagent-registry.runtime.js +1 -1
  470. package/dist/run-wait-KlS0pdIK.js +135 -0
  471. package/dist/runtime-3niXLiFY.js +9 -0
  472. package/dist/runtime-api-B79e2jL2.js +4 -0
  473. package/dist/runtime-api-CM2c2bSC.js +9 -0
  474. package/dist/runtime-api-CnOFFN5q.js +14 -0
  475. package/dist/runtime-api-TnwM-EZH.js +9 -0
  476. package/dist/runtime-embedded-pi.runtime-9csGjukF.js +2 -0
  477. package/dist/runtime-embedded-pi.runtime.js +1 -1
  478. package/dist/runtime-internal-CQX4Zehn.js +2 -0
  479. package/dist/runtime-options-C0qP2VlT.js +275 -0
  480. package/dist/runtime-schema-DanWbDoL.js +27780 -0
  481. package/dist/runtime-vycfMfew.js +973 -0
  482. package/dist/scan-Bs5zROOQ.js +2 -0
  483. package/dist/scan-CP2zJb_w.js +523 -0
  484. package/dist/secrets-cli-YFTlIMmq.js +2101 -0
  485. package/dist/security-cli-B2WBRU9C.js +486 -0
  486. package/dist/selection-DSZGsU6m.js +2 -0
  487. package/dist/selection-hUGDnCgX.js +7736 -0
  488. package/dist/send-B3Ygb3r3.js +156 -0
  489. package/dist/send-DMwqnu6K.js +102 -0
  490. package/dist/send.runtime-D86atcfW.js +2 -0
  491. package/dist/send.runtime.js +1 -1
  492. package/dist/server-4gQCBM3M.js +77 -0
  493. package/dist/server-CK9eCPCG.js +13 -0
  494. package/dist/server-context-ih3GaGaI.js +847 -0
  495. package/dist/server-context-kZ_QADic.js +2 -0
  496. package/dist/server-node-events-CMlHOIKa.js +481 -0
  497. package/dist/server-plugin-bootstrap-B0XitldT.js +11333 -0
  498. package/dist/server-plugin-bootstrap-CHlVF8XB.js +2 -0
  499. package/dist/server-restart-sentinel-TpXCoiYX.js +697 -0
  500. package/dist/server.impl-B6at3Orl.js +12734 -0
  501. package/dist/session-kill-http-DvYp5h-j.js +110 -0
  502. package/dist/session-reset-service-C9rIVqF7.js +471 -0
  503. package/dist/session-route-FaMcEc7I.js +93 -0
  504. package/dist/session-status.runtime-BfPn8qA8.js +2 -0
  505. package/dist/session-status.runtime.js +1 -1
  506. package/dist/session-subagent-reactivation.runtime-C1fGNaiM.js +2 -0
  507. package/dist/session-subagent-reactivation.runtime.js +1 -1
  508. package/dist/session-tab-registry-BDK2AlxL.js +491 -0
  509. package/dist/session-visibility-BkrL2kFF.js +147 -0
  510. package/dist/sessions-helpers-YOu_5tl0.js +304 -0
  511. package/dist/sessions-history-http-DxNaoDfb.js +383 -0
  512. package/dist/sessions-patch-BPtlF0Lu.js +309 -0
  513. package/dist/sessions-resolve-B2rpvSka.js +174 -0
  514. package/dist/sessions.runtime-DEk_x65_.js +2 -0
  515. package/dist/sessions.runtime.js +1 -1
  516. package/dist/setup-DZJZF2R6.js +495 -0
  517. package/dist/setup-api-BkYWhB-B.js +29 -0
  518. package/dist/setup-core-BXBabSEx.js +171 -0
  519. package/dist/setup-core-eahC1DXh.js +176 -0
  520. package/dist/setup-surface-BEf8reey.js +286 -0
  521. package/dist/setup-surface-DAOKJ-ai.js +219 -0
  522. package/dist/setup-surface-b6gu0S8l.js +403 -0
  523. package/dist/setup.finalize-DXUCLT5O.js +539 -0
  524. package/dist/setup.gateway-config-BH4xbjcX.js +250 -0
  525. package/dist/shared-BhHdyXun.js +198 -0
  526. package/dist/shared-CKv38qsN.js +121 -0
  527. package/dist/shared-DUw9Q4Lf.js +76 -0
  528. package/dist/slash-state-BQgmhum1.js +1911 -0
  529. package/dist/src-C1B3uJMu.js +3974 -0
  530. package/dist/startup-context-DTpThe3H.js +312 -0
  531. package/dist/status-63GZxfe4.js +2 -0
  532. package/dist/status-C6qTe-QQ.js +397 -0
  533. package/dist/status-CSIGAUly.js +190 -0
  534. package/dist/status-DOW91Kcx.js +2 -0
  535. package/dist/status-all-7hqTcvxr.js +498 -0
  536. package/dist/status-json-CUzzv8An.js +14 -0
  537. package/dist/status-json-command-DwWlqvoV.js +84 -0
  538. package/dist/status-p4yx6E3C.js +209 -0
  539. package/dist/status-runtime-shared-yrzbsOR8.js +257 -0
  540. package/dist/status-subagents.runtime-CuRGoNNn.js +18 -0
  541. package/dist/status-subagents.runtime.js +1 -1
  542. package/dist/status-text-BrcRsCFE.js +237 -0
  543. package/dist/status-zV1BflCE.js +3 -0
  544. package/dist/status.gateway-connection.runtime-BKd4Zivg.js +2 -0
  545. package/dist/status.gateway-connection.runtime.js +1 -1
  546. package/dist/status.gather-B7WlHpIR.js +292 -0
  547. package/dist/status.gather-Ccewg4ce.js +2 -0
  548. package/dist/status.runtime-BFru2C4v.js +2 -0
  549. package/dist/status.runtime.js +1 -1
  550. package/dist/status.scan-mEKnAmP3.js +65 -0
  551. package/dist/status.scan-overview-B0qQVJd0.js +379 -0
  552. package/dist/status.scan.fast-json-CsU-fWhj.js +132 -0
  553. package/dist/status.scan.fast-json-tEc36TAC.js +2 -0
  554. package/dist/status.summary-Bvgry977.js +214 -0
  555. package/dist/status.summary-DRolowE_.js +2 -0
  556. package/dist/subagent-announce-Bhe55Ktf.js +351 -0
  557. package/dist/subagent-announce-delivery-NDBIRwuZ.js +726 -0
  558. package/dist/subagent-announce-output-DsmGO7Oi.js +364 -0
  559. package/dist/subagent-control-Bn8n-535.js +506 -0
  560. package/dist/subagent-followup.runtime-C7s-lOGN.js +68 -0
  561. package/dist/subagent-followup.runtime.js +1 -1
  562. package/dist/subagent-orphan-recovery-CJEhSvFZ.js +305 -0
  563. package/dist/subagent-registry-BgQA8eP1.js +1753 -0
  564. package/dist/subagent-registry-DAm-N9-O.js +3 -0
  565. package/dist/subagent-registry.runtime.js +1 -1
  566. package/dist/subagent-spawn-EXtecXVT.js +1005 -0
  567. package/dist/system-cli-CFS_PN8R.js +59 -0
  568. package/dist/targets-BXWH2MfM.js +67 -0
  569. package/dist/task-executor-DfugjJEq.js +360 -0
  570. package/dist/task-owner-access-CSwIy-v-.js +74 -0
  571. package/dist/task-registry-B-kQGKt_.js +2366 -0
  572. package/dist/task-registry-delivery-runtime-DD1_7xUF.js +3 -0
  573. package/dist/task-registry-delivery-runtime-DIsasFa1.js +2 -0
  574. package/dist/task-registry.maintenance-CxAx195T.js +2 -0
  575. package/dist/task-registry.maintenance-DIFuNnzy.js +416 -0
  576. package/dist/telegram/token.js +1 -1
  577. package/dist/testing-C7oUBiZL.js +575 -0
  578. package/dist/text-report-hYiQ_Kcv.js +587 -0
  579. package/dist/tool-resolution-CnnOHyxg.js +90 -0
  580. package/dist/tools-effective-inventory-DqYXIS6R.js +152 -0
  581. package/dist/tools-invoke-http-zop5qWa_.js +206 -0
  582. package/dist/trash-DZRlsk_R.js +24 -0
  583. package/dist/tui-cli-2cKXF0J8.js +4575 -0
  584. package/dist/update-cli-DP1KXasM.js +1759 -0
  585. package/dist/upgrade-DPFxH2YB.js +1226 -0
  586. package/dist/video-generation-task-status-BEgeadFu.js +163 -0
  587. package/dist/wait-for-idle-before-flush-CmSNfAco.js +5986 -0
  588. package/dist/wizard-models-BJGn0RnU.js +161 -0
  589. package/package.json +1 -1
  590. package/dist/abort-ca8hDmJr.js +0 -201
  591. package/dist/abort.runtime-BrChEuUS.js +0 -2
  592. package/dist/accounts-C1ECKXaw.js +0 -107
  593. package/dist/accounts-DH8HU_Fu.js +0 -104
  594. package/dist/accounts-DWQpG06j.js +0 -2
  595. package/dist/acp-cli-BLpWVnc7.js +0 -2193
  596. package/dist/acp-spawn-D1p6b1gk.js +0 -2
  597. package/dist/acp-spawn-qoyl9NiU.js +0 -1093
  598. package/dist/acp-stateful-target-driver-NL9txhIM.js +0 -89
  599. package/dist/action-agents-C729fJ_P.js +0 -67
  600. package/dist/action-focus-53k9XP4K.js +0 -132
  601. package/dist/action-help-bIJZBYLz.js +0 -7
  602. package/dist/action-info-BBzvYFX_.js +0 -101
  603. package/dist/action-kill-C4fa3E9I.js +0 -33
  604. package/dist/action-list-BEiIbwP1.js +0 -21
  605. package/dist/action-log-Cq7RLW2T.js +0 -30
  606. package/dist/action-send-DyiHgRwh.js +0 -39
  607. package/dist/action-spawn-CEZfDvXU.js +0 -47
  608. package/dist/action-unfocus-CpAw3JOi.js +0 -29
  609. package/dist/actions.runtime-BKEwPyo7.js +0 -18
  610. package/dist/actions.runtime-Bp0UusIf.js +0 -5
  611. package/dist/agent-C2hwJefQ.js +0 -2
  612. package/dist/agent-command-BAAeGRql.js +0 -874
  613. package/dist/agent-harness-runtime-Czrx53YL.js +0 -144
  614. package/dist/agent-runner-utils-DzShckNa.js +0 -239
  615. package/dist/agent-runner.runtime-d_EtNxBK.js +0 -3455
  616. package/dist/agent-runtime-DNgz7AOP.js +0 -18
  617. package/dist/agents-CZmpon7q.js +0 -5
  618. package/dist/agents-Cs9je_gQ.js +0 -953
  619. package/dist/aliases-CZemdpTj.js +0 -2
  620. package/dist/aliases-KefnmoaT.js +0 -96
  621. package/dist/api-CO05iXNH.js +0 -139
  622. package/dist/api-CyjlApHT.js +0 -3
  623. package/dist/api-DArm1ECd.js +0 -5
  624. package/dist/approval-gateway-resolver-URpDQMld.js +0 -29
  625. package/dist/approval-gateway-runtime-B087BMms.js +0 -2
  626. package/dist/approval-handler-runtime-BgRQnG4g.js +0 -439
  627. package/dist/approval-native-runtime-DAsraihr.js +0 -729
  628. package/dist/attempt-execution.runtime-D_FGkDQz.js +0 -509
  629. package/dist/attempt.prompt-helpers-CDzDUi1C.js +0 -221
  630. package/dist/attempt.tool-run-context-DitxaTPJ.js +0 -933
  631. package/dist/audit-Bq8vlxok.js +0 -939
  632. package/dist/audit.runtime-CU42yh1v.js +0 -7
  633. package/dist/auth-CQfwC-AH.js +0 -383
  634. package/dist/auth-DyWcaG4X.js +0 -2
  635. package/dist/auth-order-C3zGI0s9.js +0 -96
  636. package/dist/auth-order-XQ9ZGPd9.js +0 -2
  637. package/dist/bash-tools-BBRtIa6j.js +0 -2824
  638. package/dist/bash-tools-BI0d1TdC.js +0 -3
  639. package/dist/binding-routing-Cvm5c1IV.js +0 -85
  640. package/dist/binding-targets-DSs4NXbd.js +0 -121
  641. package/dist/bridge-server-CwWzSgv8.js +0 -113
  642. package/dist/browser-control-auth-y1f-9HRI.js +0 -2
  643. package/dist/browser-node-runtime-3UAeP8a6.js +0 -12
  644. package/dist/browser-profiles-BzzxphNW.js +0 -2
  645. package/dist/browser-runtime-jj11LR-E.js +0 -387
  646. package/dist/browser-setup-tools-CFB52yQc.js +0 -13
  647. package/dist/build-TlobwpQW.js +0 -550
  648. package/dist/call-Bx8lENb2.js +0 -3
  649. package/dist/call-jYRpeAWm.js +0 -331
  650. package/dist/call.runtime-BRluUZbD.js +0 -2
  651. package/dist/capability-cli-Iyj9Zi3g.js +0 -1401
  652. package/dist/catchup-CtxTwzY8.js +0 -300
  653. package/dist/channel-BJKHBfnq.js +0 -491
  654. package/dist/channel-BNNnYzwK.js +0 -1100
  655. package/dist/channel-BXS-Hd8p.js +0 -226
  656. package/dist/channel-C4XWpowe.js +0 -1174
  657. package/dist/channel-CJQdQgPr.js +0 -840
  658. package/dist/channel-C_zWAu4D.js +0 -595
  659. package/dist/channel-CtGzrF-K.js +0 -1802
  660. package/dist/channel-O9DE4IIq.js +0 -350
  661. package/dist/channel-WHUOtJme.js +0 -297
  662. package/dist/channel-WoDWDxqx.js +0 -1320
  663. package/dist/channel-core-BJjq9SOq.js +0 -5
  664. package/dist/channel-inbound-DLs-YfUs.js +0 -31
  665. package/dist/channel-plugin-runtime-CMG8ac2K.js +0 -771
  666. package/dist/channel-runtime-4UjeDmDI.js +0 -425
  667. package/dist/channel-ys2FFqi1.js +0 -453
  668. package/dist/channel.runtime-B38Ky3R9.js +0 -109
  669. package/dist/channel.runtime-Bl8WYZvF.js +0 -576
  670. package/dist/channel.runtime-D3kAsCsR.js +0 -89
  671. package/dist/channel.runtime-DEQ-anMf.js +0 -2364
  672. package/dist/channel.runtime-DG-EUnSC.js +0 -4
  673. package/dist/channel.runtime-IfV1Md6p.js +0 -430
  674. package/dist/channel.runtime-w1tHjTOa.js +0 -34702
  675. package/dist/channel.setup-dXwiMlyi.js +0 -10
  676. package/dist/channels-B2G1Y-iD.js +0 -733
  677. package/dist/channels-cli-YintLKAt.js +0 -268
  678. package/dist/chat-DdKbu8CA.js +0 -2758
  679. package/dist/clawbot-cli-CnHERFYk.js +0 -9
  680. package/dist/cli-CSNAd6Sz.js +0 -72
  681. package/dist/cli-CdRioBfN.js +0 -2
  682. package/dist/cli-DMPwqYqc.js +0 -219
  683. package/dist/cli-ctyAqh0j.js +0 -2
  684. package/dist/cli-runner-CNlk7xmx.js +0 -286
  685. package/dist/cli-runner.runtime-BK4sQk1m.js +0 -3
  686. package/dist/cli-runner.runtime-BT8ZZn-R.js +0 -4
  687. package/dist/cli.runtime-DU7swpBI.js +0 -1261
  688. package/dist/client-CQdcTPUf.js +0 -138
  689. package/dist/client-Vx7pseEY.js +0 -713
  690. package/dist/command-auth-DkJWb2HE.js +0 -76
  691. package/dist/command-config-resolution-CIRWRfR8.js +0 -23
  692. package/dist/command-config-resolution-DYZWj6Zm.js +0 -2
  693. package/dist/command-config-resolution.runtime-CUtVJOf0.js +0 -2
  694. package/dist/command-registry-CHy5EH0v.js +0 -4
  695. package/dist/command-registry-CyKgELQP.js +0 -9
  696. package/dist/command-registry-core-DQeRIuot.js +0 -104
  697. package/dist/command-secret-gateway-BNnWdAlq.js +0 -528
  698. package/dist/command-status.runtime-CKgimR6Y.js +0 -87
  699. package/dist/commands-acp-DSm97O5v.js +0 -77
  700. package/dist/commands-compact.runtime-BXhP6WJ6.js +0 -10
  701. package/dist/commands-handlers.runtime-FzK-n0L8.js +0 -4597
  702. package/dist/commands-status-BQnB5OSX.js +0 -16
  703. package/dist/commands-status.runtime-B6GcfEDm.js +0 -3
  704. package/dist/commands-subagents-control.runtime-CByd528A.js +0 -2
  705. package/dist/commands-subagents-control.runtime-CqI4LMYa.js +0 -3
  706. package/dist/commands-system-prompt-BD_LeeZk.js +0 -2
  707. package/dist/commands-system-prompt-C2Md_Ia1.js +0 -158
  708. package/dist/commands.runtime-CwiPf7Cc.js +0 -166
  709. package/dist/compact-B_4bMVpw.js +0 -1118
  710. package/dist/compact.runtime-BhRqiBXG.js +0 -12
  711. package/dist/completion-cli-D07hGGMI.js +0 -313
  712. package/dist/config-B1lvYOd7.js +0 -251
  713. package/dist/config-cli-BgepNwob.js +0 -1078
  714. package/dist/configure-CEfl0ORM.js +0 -2
  715. package/dist/configure-TsykzQqM.js +0 -1245
  716. package/dist/connect-options-zqTIEl6K.js +0 -699
  717. package/dist/control-auth-CNa_KHpo.js +0 -125
  718. package/dist/control-service-CZl5wFdZ.js +0 -156
  719. package/dist/conversation-id-BLY9ffjm.js +0 -38
  720. package/dist/conversation-id-DVeOM5Jh.js +0 -235
  721. package/dist/conversation-runtime-gJt7AAg2.js +0 -31
  722. package/dist/core-BtmNtOpS.js +0 -275
  723. package/dist/cron-cli-s9SF4__G.js +0 -713
  724. package/dist/daemon-cli-TCubZfI_.js +0 -12
  725. package/dist/delegate-DyITI93V.js +0 -64
  726. package/dist/detached-task-runtime-CTUQj84i.js +0 -73
  727. package/dist/devices-cli-SXcLjGmh.js +0 -496
  728. package/dist/diagnostics-waSemGnZ.js +0 -154
  729. package/dist/direct-dm-CiSjkmkL.js +0 -64
  730. package/dist/dispatch-BnQSIx2G.js +0 -1131
  731. package/dist/dispatch-acp-CaNQyl2L.js +0 -981
  732. package/dist/dispatch-acp-manager.runtime-DJK1eHYX.js +0 -3
  733. package/dist/dispatch-acp.runtime-Bl5cvtX4.js +0 -19
  734. package/dist/doctor-device-pairing-DBhEA-8G.js +0 -307
  735. package/dist/doctor-gateway-daemon-flow-Ds47Er3Y.js +0 -250
  736. package/dist/doctor-gateway-health-EWwTw5JR.js +0 -60
  737. package/dist/doctor-health-C6muRn7t.js +0 -59
  738. package/dist/doctor-health-contributions-B984415a.js +0 -486
  739. package/dist/doctor-prompter-BpOi4ndi.js +0 -56
  740. package/dist/doctor-workspace-status-CiEWZXrx.js +0 -75
  741. package/dist/dreaming-DFPenC85.js +0 -1574
  742. package/dist/dreaming-narrative-6A27_Gft.js +0 -595
  743. package/dist/embedded-gateway-stub.runtime-UVgfXZzk.js +0 -9
  744. package/dist/exec-approvals-cli-Cc_GG9ZT.js +0 -498
  745. package/dist/fallbacks-DX4YcmAx.js +0 -2
  746. package/dist/fallbacks-inTaaG-m.js +0 -31
  747. package/dist/fallbacks-shared-ow1la-U2.js +0 -111
  748. package/dist/gateway-D4iWwu3_.js +0 -115
  749. package/dist/gateway-cli-D6j0Aj3R.js +0 -1325
  750. package/dist/gateway-rpc-Dd_x2GX5.js +0 -14
  751. package/dist/gateway-rpc.runtime-Btnvsv-7.js +0 -23
  752. package/dist/gateway-runtime-DctMRv_p.js +0 -15
  753. package/dist/gateway-status-DJCtvUVn.js +0 -584
  754. package/dist/genesis-tools-CvMcpUvH.js +0 -8999
  755. package/dist/genesis-tools.runtime-Ch3NDEDq.js +0 -2
  756. package/dist/get-reply-Cm39MCyU.js +0 -3879
  757. package/dist/get-reply-from-config.runtime-CSqCYatb.js +0 -2
  758. package/dist/graph-users-BJxYqA3A.js +0 -1337
  759. package/dist/health-C14jIilQ.js +0 -469
  760. package/dist/health-C6yJSCMc.js +0 -3
  761. package/dist/heartbeat-runner-C6-gFnyC.js +0 -5
  762. package/dist/heartbeat-runner-yUYjgzIM.js +0 -1292
  763. package/dist/heartbeat-runner.runtime-DZzyrUNB.js +0 -4
  764. package/dist/hooks-cli-CCRaHheu.js +0 -433
  765. package/dist/image-fallbacks-BH9qLbBG.js +0 -31
  766. package/dist/image-fallbacks-DUOPO1ic.js +0 -2
  767. package/dist/inbound-reply-dispatch-DPf_IrbV.js +0 -73
  768. package/dist/infra-runtime-CLND6LJ0.js +0 -39
  769. package/dist/init-CzWob-9v.js +0 -59
  770. package/dist/library-C0a9Bz2M.js +0 -45
  771. package/dist/lifecycle-B_B_jt3r.js +0 -571
  772. package/dist/lifecycle-DuqKKZop.js +0 -229
  773. package/dist/lifecycle.runtime-DoosWTnK.js +0 -2
  774. package/dist/list-Bly8XeOF.js +0 -2
  775. package/dist/list-C5HvtbwZ.js +0 -2
  776. package/dist/list-CHIiamt1.js +0 -131
  777. package/dist/list-CMmJiacX.js +0 -1201
  778. package/dist/list.probe-kmHRFlrP.js +0 -419
  779. package/dist/llm-slug-generator-C3u6Ptgq.js +0 -79
  780. package/dist/load-config-CXvIGI7N.js +0 -35
  781. package/dist/local-dispatch.runtime-BNQF4rqW.js +0 -8
  782. package/dist/logs-cli-DEy1GPk2.js +0 -265
  783. package/dist/logs-cli.runtime-jWShKzQC.js +0 -2
  784. package/dist/main-session-restart-recovery-CzfY6Cd8.js +0 -206
  785. package/dist/managed-image-attachments-BGPKA7Mn.js +0 -2
  786. package/dist/managed-image-attachments-CTrq9ym-.js +0 -635
  787. package/dist/manager-C_ZGa9x8.js +0 -2057
  788. package/dist/manager-DIHLRzYF.js +0 -2
  789. package/dist/markdown-to-line-CRbbXtJK.js +0 -790
  790. package/dist/mcp-cli-FMJb3T4k.js +0 -725
  791. package/dist/mcp-http-b6UMoE_J.js +0 -529
  792. package/dist/memory-core-host-runtime-cli-CquxELNj.js +0 -9
  793. package/dist/message-CmjuvIFf.js +0 -232
  794. package/dist/message-action-runner-CiY3rhqt.js +0 -1407
  795. package/dist/message-action-runner-Do4P0h5i.js +0 -2
  796. package/dist/message-actions-BYREqFJA.js +0 -143
  797. package/dist/message.gateway.runtime-gkoWzaYV.js +0 -2
  798. package/dist/models-auth-status-B_Pcr0tl.js +0 -201
  799. package/dist/models-cli-BZSuW2gw.js +0 -219
  800. package/dist/monitor-22LY8y6z.js +0 -788
  801. package/dist/monitor-BZdf_CEm.js +0 -1237
  802. package/dist/monitor-CTVDlTs2.js +0 -671
  803. package/dist/monitor-Cfv-KGAl.js +0 -1661
  804. package/dist/monitor-DuA69-8E.js +0 -2
  805. package/dist/monitor-auth-BNDlfcw7.js +0 -207
  806. package/dist/monitor-cmWeDVxf.js +0 -1459
  807. package/dist/monitor-processing-D9Xcsagt.js +0 -1974
  808. package/dist/monitor.runtime-zWvcbNim.js +0 -2
  809. package/dist/monitor.webhook-BYWQa5lY.js +0 -180
  810. package/dist/msteams-n9HDT4O-.js +0 -35
  811. package/dist/native-hook-relay-CKyIfLOm.js +0 -519
  812. package/dist/nextcloud-talk-BuJVVP0J.js +0 -17
  813. package/dist/node-cli-DBK2TIEH.js +0 -2506
  814. package/dist/nodes-cli-D5Y1_ZVD.js +0 -1046
  815. package/dist/nodes-utils-C6IKaTjm.js +0 -84
  816. package/dist/nodes.helpers-CkJO5i0d.js +0 -34
  817. package/dist/notify-v0zoiI-O.js +0 -315
  818. package/dist/onboard-BCaLBJor.js +0 -632
  819. package/dist/onboard-helpers-Ba7ES7kB.js +0 -204
  820. package/dist/onboard-helpers-D5qdyBIj.js +0 -6
  821. package/dist/onboard-remote-BaHm_VrY.js +0 -2
  822. package/dist/onboard-remote-DbGAo_Ad.js +0 -193
  823. package/dist/onboard-skills-BA7c4li1.js +0 -2
  824. package/dist/onboard-skills-upyHp6T9.js +0 -134
  825. package/dist/openai-http-DwCqhEcX.js +0 -500
  826. package/dist/openresponses-http-tJr67vC1.js +0 -1128
  827. package/dist/operator-approvals-client-C0t_-2xC.js +0 -68
  828. package/dist/outbound.runtime-nXA4k1xA.js +0 -2
  829. package/dist/pair-command-approve-G5y-rKn9.js +0 -44
  830. package/dist/persistent-bindings.lifecycle-C56aKBVc.js +0 -2
  831. package/dist/persistent-bindings.lifecycle-CfBqvz9L.js +0 -85
  832. package/dist/pi-embedded-B1wvxHXL.js +0 -2905
  833. package/dist/pi-embedded-DmDb-oUB.js +0 -4
  834. package/dist/pi-embedded.runtime-D5xqw9Ko.js +0 -4
  835. package/dist/pi-tool-definition-adapter-CAxlo-Va.js +0 -217
  836. package/dist/pi-tools-C69yvznf.js +0 -1057
  837. package/dist/pi-tools.before-tool-call-BDeCmoAy.js +0 -2
  838. package/dist/pi-tools.before-tool-call-DG7VVNBn.js +0 -433
  839. package/dist/plugin-B9Ld0CUs.js +0 -12195
  840. package/dist/plugin-enabled-BguUplCN.js +0 -140
  841. package/dist/plugin-registration-DPBnSoak.js +0 -23
  842. package/dist/plugin-service-CdNFnRyN.js +0 -2890
  843. package/dist/policy-DgfegT_Y.js +0 -328
  844. package/dist/prepare.runtime-C_sRmuFC.js +0 -815
  845. package/dist/probe-8vb_Ssot.js +0 -45
  846. package/dist/probe-BjmKFiz1.js +0 -2205
  847. package/dist/probe-CVlOo8Hr.js +0 -74
  848. package/dist/probe-CakOsrSu.js +0 -241
  849. package/dist/probe-CbOoVumf.js +0 -2
  850. package/dist/probe-D6yFcZpK.js +0 -1443
  851. package/dist/probe-OcOYm1bj.js +0 -2
  852. package/dist/program-BJnTb7UE.js +0 -111
  853. package/dist/prompt-select-styled-C8kGHNpY.js +0 -20
  854. package/dist/protocol-C40iRm9c.js +0 -2234
  855. package/dist/provider-dispatcher-BIOPYzb9.js +0 -2
  856. package/dist/provider-dispatcher-CpwviX0O.js +0 -22
  857. package/dist/qr-cli-CJXKCj0L.js +0 -2
  858. package/dist/qr-cli-kSU9X-N0.js +0 -349
  859. package/dist/reaction-runtime-api-3XFmruJA.js +0 -116
  860. package/dist/reactions-By-nqZC6.js +0 -998
  861. package/dist/register-service-commands-fwB-T6mW.js +0 -71
  862. package/dist/register.agent-CpScU3CV.js +0 -248
  863. package/dist/register.configure-DpD3_BCK.js +0 -15
  864. package/dist/register.maintenance-ByoQXpk9.js +0 -438
  865. package/dist/register.message-BTXNOZMD.js +0 -329
  866. package/dist/register.onboard-B83CAOYy.js +0 -81
  867. package/dist/register.runtime-Doz01zcH.js +0 -81
  868. package/dist/register.setup-BKI5rwWy.js +0 -150
  869. package/dist/register.status-health-sessions-DRPszDQ-.js +0 -1215
  870. package/dist/register.subclis-DeXklyQL.js +0 -3
  871. package/dist/register.subclis-YkmoZoxl.js +0 -29
  872. package/dist/register.subclis-core-BPo4hV1Q.js +0 -243
  873. package/dist/reply-dispatch-runtime-DjIuN_dr.js +0 -13
  874. package/dist/reply-runtime-5TFidLR3.js +0 -11
  875. package/dist/reply.runtime-6d1e0INl.js +0 -2
  876. package/dist/restart-health-BWUPc4R-.js +0 -202
  877. package/dist/restart-health-CWvsjHVN.js +0 -2
  878. package/dist/root-help-D2YiFpS6.js +0 -44
  879. package/dist/routes-BdYdVpe7.js +0 -3341
  880. package/dist/routes-jYoN_qOU.js +0 -2
  881. package/dist/rpc-5tMjebZH.js +0 -61
  882. package/dist/rpc.runtime-BzAHjcm4.js +0 -21
  883. package/dist/run-delivery.runtime-qZIB76oE.js +0 -530
  884. package/dist/run-embedded.runtime-nHunVmCv.js +0 -4
  885. package/dist/run-execution-cli.runtime-CMT7La6D.js +0 -4
  886. package/dist/run-executor.runtime-BG6SDi3f.js +0 -277
  887. package/dist/run-main-CNf_LLX7.js +0 -516
  888. package/dist/run-subagent-registry.runtime-D0RcqcJr.js +0 -2
  889. package/dist/run-wait--kou3jZ7.js +0 -135
  890. package/dist/runtime-BvxkGJm2.js +0 -9
  891. package/dist/runtime-DgQ5oUKq.js +0 -973
  892. package/dist/runtime-api-6SzMK-FZ.js +0 -4
  893. package/dist/runtime-api-BAMrcB-5.js +0 -9
  894. package/dist/runtime-api-DLSrxS5O.js +0 -9
  895. package/dist/runtime-api-DsPleWQg.js +0 -14
  896. package/dist/runtime-embedded-pi.runtime-eyjaJfAz.js +0 -2
  897. package/dist/runtime-internal-BTfGDlHi.js +0 -2
  898. package/dist/runtime-options-B5_eZxMV.js +0 -275
  899. package/dist/runtime-schema-BB3QzGXJ.js +0 -27780
  900. package/dist/scan-D0fsxqed.js +0 -2
  901. package/dist/scan-DrjjN66Z.js +0 -523
  902. package/dist/secrets-cli-B7-qbfn-.js +0 -2101
  903. package/dist/security-cli-CYTPgL67.js +0 -486
  904. package/dist/selection-DEAdLh1Q.js +0 -2
  905. package/dist/selection-zPPyzfBX.js +0 -7736
  906. package/dist/send-CYKfZTCJ.js +0 -156
  907. package/dist/send-Di1tRwJD.js +0 -102
  908. package/dist/send.runtime-Bw22DBkL.js +0 -2
  909. package/dist/server-BIF5dPI_.js +0 -13
  910. package/dist/server-BJK0Q4xw.js +0 -77
  911. package/dist/server-context-CiVVCQNp.js +0 -847
  912. package/dist/server-context-DXvk5Tdy.js +0 -2
  913. package/dist/server-node-events-CdZP3Kok.js +0 -481
  914. package/dist/server-plugin-bootstrap-Di15EOt4.js +0 -11333
  915. package/dist/server-plugin-bootstrap-dboO44LL.js +0 -2
  916. package/dist/server-restart-sentinel-BWiOzljY.js +0 -697
  917. package/dist/server.impl-Ph8YCQpT.js +0 -12734
  918. package/dist/session-kill-http-B_J1fJ4-.js +0 -110
  919. package/dist/session-reset-service-DPgw70iw.js +0 -471
  920. package/dist/session-route-B0h6MEyB.js +0 -93
  921. package/dist/session-status.runtime-DCvgI1pG.js +0 -2
  922. package/dist/session-subagent-reactivation.runtime-BgsCnI-h.js +0 -2
  923. package/dist/session-tab-registry-FyN6CWh5.js +0 -491
  924. package/dist/session-visibility-CZjMA1SL.js +0 -147
  925. package/dist/sessions-helpers-B3W7MdIb.js +0 -304
  926. package/dist/sessions-history-http-Bw5J6HQ-.js +0 -383
  927. package/dist/sessions-patch-2sBcHc9a.js +0 -309
  928. package/dist/sessions-resolve-C-VZh_56.js +0 -174
  929. package/dist/sessions.runtime-cLuc67tJ.js +0 -2
  930. package/dist/setup-FW8xH-S-.js +0 -495
  931. package/dist/setup-api-Culp0Usf.js +0 -29
  932. package/dist/setup-core-CaTBS6Tz.js +0 -171
  933. package/dist/setup-core-youmXvW_.js +0 -176
  934. package/dist/setup-surface-BeMn-9hU.js +0 -403
  935. package/dist/setup-surface-CUd-s0wh.js +0 -286
  936. package/dist/setup-surface-DtscjAY3.js +0 -219
  937. package/dist/setup.finalize-BWyA4f4q.js +0 -539
  938. package/dist/setup.gateway-config-CvzMdftA.js +0 -250
  939. package/dist/shared-B3Pz1Xcr.js +0 -121
  940. package/dist/shared-Bc3x3THS.js +0 -76
  941. package/dist/shared-CxbLx0Ww.js +0 -198
  942. package/dist/slash-state-XfeMEeuI.js +0 -1911
  943. package/dist/src-BiDxQvtV.js +0 -3974
  944. package/dist/startup-context-CXQi-7YB.js +0 -312
  945. package/dist/status-Ch3bm70K.js +0 -2
  946. package/dist/status-CiQSxvY-.js +0 -3
  947. package/dist/status-DY0DlWlw.js +0 -190
  948. package/dist/status-DjdByQv-.js +0 -209
  949. package/dist/status-MT62_Jgw.js +0 -2
  950. package/dist/status-all-BD2viQD9.js +0 -498
  951. package/dist/status-json-CWS2oYON.js +0 -14
  952. package/dist/status-json-command-B6lZefoe.js +0 -84
  953. package/dist/status-pujDHwRb.js +0 -397
  954. package/dist/status-runtime-shared-Bu9Zhd7x.js +0 -257
  955. package/dist/status-subagents.runtime-B4UXD0lL.js +0 -18
  956. package/dist/status-text-myqmk4OL.js +0 -237
  957. package/dist/status.gateway-connection.runtime-B0Iwl2iZ.js +0 -2
  958. package/dist/status.gather-C51Ja0wP.js +0 -292
  959. package/dist/status.gather-DQ7WZp3H.js +0 -2
  960. package/dist/status.runtime-Cxyb3wHZ.js +0 -2
  961. package/dist/status.scan-C1aqDsy2.js +0 -65
  962. package/dist/status.scan-overview-BerlJz2l.js +0 -379
  963. package/dist/status.scan.fast-json-BXY82vu2.js +0 -2
  964. package/dist/status.scan.fast-json-DJqgEbzZ.js +0 -132
  965. package/dist/status.summary-CCdLUph8.js +0 -214
  966. package/dist/status.summary-CHAn0_FS.js +0 -2
  967. package/dist/subagent-announce-D4jG75Ub.js +0 -351
  968. package/dist/subagent-announce-delivery-BkQYzDcy.js +0 -726
  969. package/dist/subagent-announce-output-C3pkuu-t.js +0 -364
  970. package/dist/subagent-control-DVVK8du2.js +0 -506
  971. package/dist/subagent-followup.runtime-CdeweG-S.js +0 -68
  972. package/dist/subagent-orphan-recovery-ZQanOHb4.js +0 -305
  973. package/dist/subagent-registry-BcPa3ho0.js +0 -3
  974. package/dist/subagent-registry-hJUso5eL.js +0 -1753
  975. package/dist/subagent-spawn-DTaeQc9q.js +0 -1005
  976. package/dist/system-cli-CT8VaSDY.js +0 -59
  977. package/dist/targets-BPdSjnQH.js +0 -67
  978. package/dist/task-executor-B62Qzfi-.js +0 -360
  979. package/dist/task-owner-access-BBMrMOlN.js +0 -74
  980. package/dist/task-registry-BD-ew2bT.js +0 -2366
  981. package/dist/task-registry-delivery-runtime-B2WyGY0d.js +0 -3
  982. package/dist/task-registry-delivery-runtime-MFJszOHI.js +0 -2
  983. package/dist/task-registry.maintenance-0D2Yxl49.js +0 -416
  984. package/dist/task-registry.maintenance-OPlfB5W9.js +0 -2
  985. package/dist/testing-DmxZ16UC.js +0 -575
  986. package/dist/text-report-BwIpU54R.js +0 -587
  987. package/dist/tool-resolution-vn72hwMo.js +0 -90
  988. package/dist/tools-effective-inventory-DII_pOSr.js +0 -152
  989. package/dist/tools-invoke-http-DdthGR52.js +0 -206
  990. package/dist/trash-BVZu6rU7.js +0 -24
  991. package/dist/tui-cli-Bz51WCAi.js +0 -4575
  992. package/dist/update-cli-DkH8vHQP.js +0 -1759
  993. package/dist/upgrade-Dvj8K4WB.js +0 -1226
  994. package/dist/video-generation-task-status-CHYB_IeZ.js +0 -163
  995. package/dist/wait-for-idle-before-flush-DJMxeE2X.js +0 -5986
  996. package/dist/wizard-models-BNQQ7fvr.js +0 -161
@@ -1,3341 +0,0 @@
1
- import { i as formatErrorMessage } from "./errors-Jbvi20TW.js";
2
- import { a as normalizeLowercaseStringOrEmpty, c as normalizeOptionalString$4 } from "./string-coerce-C1IzJjqi.js";
3
- import { m as resolveUserPath } from "./utils-DaGfogP-.js";
4
- import { a as loadConfig, y as writeConfigFile } from "./io-h8M_Z0Lj.js";
5
- import { a as getImageMetadata, l as resizeToJpeg, r as buildImageResizeSideGrid, t as IMAGE_REDUCE_QUALITY_STEPS } from "./image-ops-DXau4yMa.js";
6
- import { a as ensureMediaDir, l as saveMediaBuffer } from "./store-Fge4lGwN.js";
7
- import { n as deriveDefaultBrowserCdpPortRange } from "./port-defaults-grVhyUfZ.js";
8
- import "./text-runtime-7KpTTpVi.js";
9
- import "./browser-setup-tools-CFB52yQc.js";
10
- import "./control-auth-CNa_KHpo.js";
11
- import { c as DEFAULT_AI_SNAPSHOT_MAX_CHARS, f as DEFAULT_BROWSER_SCREENSHOT_TIMEOUT_MS, i as resolveExistingPathsWithinRoot, n as DEFAULT_TRACE_DIR, o as resolveWritablePathWithinRoot, r as DEFAULT_UPLOAD_DIR, s as DEFAULT_AI_SNAPSHOT_EFFICIENT_MAX_CHARS, t as DEFAULT_DOWNLOAD_DIR } from "./paths-6HUizwZc.js";
12
- import { n as resolveProfile } from "./config-B1lvYOd7.js";
13
- import { d as parseBrowserHttpUrl, n as assertCdpEndpointAllowed } from "./cdp.helpers-D-cKiAJ-.js";
14
- import { a as BrowserProfileUnavailableError, c as BrowserTabNotFoundError, d as toBrowserErrorResponse, i as BrowserProfileNotFoundError, l as BrowserTargetAmbiguousError, n as BrowserConflictError, r as BrowserError, s as BrowserResourceExhaustedError, u as BrowserValidationError } from "./errors-DyjYUGQK.js";
15
- import { a as shouldUsePlaywrightForAriaSnapshot, i as resolveDefaultSnapshotFormat, n as getPwAiModule$1, o as shouldUsePlaywrightForScreenshot, r as getBrowserProfileCapabilities, t as resolveTargetIdFromTabs } from "./target-id-DwGFlj0w.js";
16
- import { _ as assertBrowserNavigationAllowed, a as resolveGenesisUserDataDir, h as resolveBrowserNavigationProxyMode, m as snapshotAria, u as captureScreenshot, x as withBrowserNavigationPolicy, y as assertBrowserNavigationResultAllowed } from "./chrome-Cs0ME7FH.js";
17
- import { n as normalizeString } from "./record-shared-B-W3jnOg.js";
18
- import { E as uploadChromeMcpFile, T as takeChromeMcpSnapshot, _ as navigateChromeMcpPage, a as closeChromeMcpTab, c as evaluateChromeMcpScript, f as getChromeMcpPid, l as fillChromeMcpElement, m as hoverChromeMcpElement, n as clickChromeMcpCoords, o as dragChromeMcpElement, r as clickChromeMcpElement, u as fillChromeMcpForm, w as takeChromeMcpScreenshot, x as resizeChromeMcpPage, y as pressChromeMcpKey } from "./chrome-mcp-DxhdLTiR.js";
19
- import { a as CONTENT_ROLES, d as ACT_MAX_CLICK_DELAY_MS, f as ACT_MAX_WAIT_TIME_MS, g as matchBrowserUrlPattern, l as normalizeBrowserFormField, o as INTERACTIVE_ROLES, p as normalizeActBoundedNonNegativeMs, r as getRoleSnapshotStats, s as STRUCTURAL_ROLES } from "./pw-role-snapshot-Bl3hTc-h.js";
20
- import { r as resolveBrowserExecutableForPlatform } from "./chrome.executables-CfWpFyzT.js";
21
- import { t as movePathToTrash } from "./trash-BVZu6rU7.js";
22
- import fs from "node:fs";
23
- import path from "node:path";
24
- import fs$1 from "node:fs/promises";
25
- import crypto from "node:crypto";
26
- //#region extensions/browser/src/browser/routes/utils.ts
27
- function normalizeOptionalString$3(value) {
28
- return value.trim() || void 0;
29
- }
30
- function asyncBrowserRoute(handler) {
31
- return (req, res) => handler(req, res);
32
- }
33
- /**
34
- * Extract profile name from query string or body and get profile context.
35
- * Query string takes precedence over body for consistency with GET routes.
36
- */
37
- function getProfileContext(req, ctx) {
38
- let profileName;
39
- if (typeof req.query.profile === "string") profileName = normalizeOptionalString$3(req.query.profile);
40
- if (!profileName && req.body && typeof req.body === "object") {
41
- const body = req.body;
42
- if (typeof body.profile === "string") profileName = normalizeOptionalString$3(body.profile);
43
- }
44
- try {
45
- return ctx.forProfile(profileName);
46
- } catch (err) {
47
- return {
48
- error: String(err),
49
- status: 404
50
- };
51
- }
52
- }
53
- function jsonError(res, status, message) {
54
- res.status(status).json({ error: message });
55
- }
56
- function toStringOrEmpty(value) {
57
- if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return normalizeOptionalString$3(String(value)) ?? "";
58
- return "";
59
- }
60
- function toNumber(value) {
61
- if (typeof value === "number" && Number.isFinite(value)) return value;
62
- const normalized = typeof value === "string" ? normalizeOptionalString$3(value) : void 0;
63
- if (normalized) {
64
- const parsed = Number(normalized);
65
- return Number.isFinite(parsed) ? parsed : void 0;
66
- }
67
- }
68
- function toBoolean(value) {
69
- if (typeof value === "boolean") return value;
70
- if (typeof value !== "string" && typeof value !== "number") return;
71
- const normalized = String(value).trim().toLowerCase();
72
- if (normalized === "true" || normalized === "1" || normalized === "yes") return true;
73
- if (normalized === "false" || normalized === "0" || normalized === "no") return false;
74
- }
75
- function toStringArray(value) {
76
- if (!Array.isArray(value)) return;
77
- const strings = value.map((v) => toStringOrEmpty(v)).filter(Boolean);
78
- return strings.length ? strings : void 0;
79
- }
80
- //#endregion
81
- //#region extensions/browser/src/browser/routes/agent.shared.ts
82
- function normalizeOptionalString$2(value) {
83
- return typeof value === "string" ? value.trim() || void 0 : void 0;
84
- }
85
- const SELECTOR_UNSUPPORTED_MESSAGE = [
86
- "Error: 'selector' is not supported. Use 'ref' from snapshot instead.",
87
- "",
88
- "Example workflow:",
89
- "1. snapshot action to get page state with refs",
90
- "2. act with ref: \"e123\" to interact with element",
91
- "",
92
- "This is more reliable for modern SPAs."
93
- ].join("\n");
94
- function readBody(req) {
95
- const body = req.body;
96
- if (!body || typeof body !== "object" || Array.isArray(body)) return {};
97
- return body;
98
- }
99
- function resolveTargetIdFromBody(body) {
100
- return (normalizeOptionalString$2(body.targetId) ?? "") || void 0;
101
- }
102
- function resolveTargetIdFromQuery(query) {
103
- return (normalizeOptionalString$2(query.targetId) ?? "") || void 0;
104
- }
105
- function handleRouteError(ctx, res, err) {
106
- const mapped = ctx.mapTabError(err);
107
- if (mapped) return jsonError(res, mapped.status, mapped.message);
108
- const browserMapped = toBrowserErrorResponse(err);
109
- if (browserMapped) return jsonError(res, browserMapped.status, browserMapped.message);
110
- jsonError(res, 500, String(err));
111
- }
112
- function resolveProfileContext(req, res, ctx) {
113
- const profileCtx = getProfileContext(req, ctx);
114
- if ("error" in profileCtx) {
115
- jsonError(res, profileCtx.status, profileCtx.error);
116
- return null;
117
- }
118
- return profileCtx;
119
- }
120
- async function getPwAiModule() {
121
- return await getPwAiModule$1({ mode: "soft" });
122
- }
123
- async function requirePwAi(res, feature) {
124
- const mod = await getPwAiModule();
125
- if (mod) return mod;
126
- jsonError(res, 501, [
127
- `Playwright is not available in this gateway build; '${feature}' is unsupported.`,
128
- "Repair the bundled browser plugin runtime dependencies so playwright-core is installed, then restart the gateway. In Docker, also install Chromium with the bundled playwright-core CLI.",
129
- "Docs: /tools/browser#playwright-requirement"
130
- ].join("\n"));
131
- return null;
132
- }
133
- async function withRouteTabContext(params) {
134
- const profileCtx = resolveProfileContext(params.req, params.res, params.ctx);
135
- if (!profileCtx) return;
136
- try {
137
- const tab = await profileCtx.ensureTabAvailable(params.targetId);
138
- return await params.run({
139
- profileCtx,
140
- tab,
141
- cdpUrl: profileCtx.profile.cdpUrl
142
- });
143
- } catch (err) {
144
- handleRouteError(params.ctx, params.res, err);
145
- return;
146
- }
147
- }
148
- async function withPlaywrightRouteContext(params) {
149
- return await withRouteTabContext({
150
- req: params.req,
151
- res: params.res,
152
- ctx: params.ctx,
153
- targetId: params.targetId,
154
- run: async ({ profileCtx, tab, cdpUrl }) => {
155
- const pw = await requirePwAi(params.res, params.feature);
156
- if (!pw) return;
157
- return await params.run({
158
- profileCtx,
159
- tab,
160
- cdpUrl,
161
- pw
162
- });
163
- }
164
- });
165
- }
166
- //#endregion
167
- //#region extensions/browser/src/browser/routes/existing-session-limits.ts
168
- const EXISTING_SESSION_LIMITS = {
169
- act: {
170
- clickSelector: "existing-session click does not support selector targeting yet; use ref.",
171
- clickButtonOrModifiers: "existing-session click currently supports left-click only (no button overrides/modifiers).",
172
- typeSelector: "existing-session type does not support selector targeting yet; use ref.",
173
- typeSlowly: "existing-session type does not support slowly=true; use fill/press instead.",
174
- typeTimeout: "existing-session type does not support timeoutMs overrides.",
175
- pressDelay: "existing-session press does not support delayMs.",
176
- hoverSelector: "existing-session hover does not support selector targeting yet; use ref.",
177
- hoverTimeout: "existing-session hover does not support timeoutMs overrides.",
178
- scrollSelector: "existing-session scrollIntoView does not support selector targeting yet; use ref.",
179
- scrollTimeout: "existing-session scrollIntoView does not support timeoutMs overrides.",
180
- dragSelector: "existing-session drag does not support selector targeting yet; use startRef/endRef.",
181
- dragTimeout: "existing-session drag does not support timeoutMs overrides.",
182
- selectSelector: "existing-session select does not support selector targeting yet; use ref.",
183
- selectSingleValue: "existing-session select currently supports a single value only.",
184
- selectTimeout: "existing-session select does not support timeoutMs overrides.",
185
- fillTimeout: "existing-session fill does not support timeoutMs overrides.",
186
- waitNetworkIdle: "existing-session wait does not support loadState=networkidle yet.",
187
- evaluateTimeout: "existing-session evaluate does not support timeoutMs overrides.",
188
- batch: "existing-session batch is not supported yet; send actions individually."
189
- },
190
- hooks: {
191
- uploadElement: "existing-session file uploads do not support element selectors; use ref/inputRef.",
192
- uploadSingleFile: "existing-session file uploads currently support one file at a time.",
193
- uploadRefRequired: "existing-session file uploads require ref or inputRef.",
194
- dialogTimeout: "existing-session dialog handling does not support timeoutMs."
195
- },
196
- download: {
197
- waitUnsupported: "download waiting is not supported for existing-session profiles yet.",
198
- downloadUnsupported: "downloads are not supported for existing-session profiles yet."
199
- },
200
- snapshot: {
201
- pdfUnsupported: "pdf is not supported for existing-session profiles yet; use screenshot/snapshot instead.",
202
- screenshotElement: "element screenshots are not supported for existing-session profiles; use ref from snapshot.",
203
- snapshotSelector: "selector/frame snapshots are not supported for existing-session profiles; snapshot the whole page and use refs."
204
- },
205
- responseBody: "response body is not supported for existing-session profiles yet."
206
- };
207
- //#endregion
208
- //#region extensions/browser/src/browser/routes/output-paths.ts
209
- async function ensureOutputRootDir(rootDir) {
210
- await fs$1.mkdir(rootDir, { recursive: true });
211
- }
212
- async function resolveWritableOutputPathOrRespond(params) {
213
- if (params.ensureRootDir) await ensureOutputRootDir(params.rootDir);
214
- const pathResult = await resolveWritablePathWithinRoot({
215
- rootDir: params.rootDir,
216
- requestedPath: params.requestedPath,
217
- scopeLabel: params.scopeLabel,
218
- defaultFileName: params.defaultFileName
219
- });
220
- if (!pathResult.ok) {
221
- params.res.status(400).json({ error: pathResult.error });
222
- return null;
223
- }
224
- return pathResult.path;
225
- }
226
- //#endregion
227
- //#region extensions/browser/src/browser/routes/agent.act.download.ts
228
- function buildDownloadRequestBase(cdpUrl, targetId, timeoutMs) {
229
- return {
230
- cdpUrl,
231
- targetId,
232
- timeoutMs: timeoutMs ?? void 0
233
- };
234
- }
235
- function registerBrowserAgentActDownloadRoutes(app, ctx) {
236
- app.post("/wait/download", asyncBrowserRoute(async (req, res) => {
237
- const body = readBody(req);
238
- const targetId = resolveTargetIdFromBody(body);
239
- const out = toStringOrEmpty(body.path) || "";
240
- const timeoutMs = toNumber(body.timeoutMs);
241
- await withRouteTabContext({
242
- req,
243
- res,
244
- ctx,
245
- targetId,
246
- run: async ({ profileCtx, cdpUrl, tab }) => {
247
- if (getBrowserProfileCapabilities(profileCtx.profile).usesChromeMcp) return jsonError(res, 501, EXISTING_SESSION_LIMITS.download.waitUnsupported);
248
- const pw = await requirePwAi(res, "wait for download");
249
- if (!pw) return;
250
- await ensureOutputRootDir(DEFAULT_DOWNLOAD_DIR);
251
- let downloadPath;
252
- if (out.trim()) {
253
- const resolvedDownloadPath = await resolveWritableOutputPathOrRespond({
254
- res,
255
- rootDir: DEFAULT_DOWNLOAD_DIR,
256
- requestedPath: out,
257
- scopeLabel: "downloads directory"
258
- });
259
- if (!resolvedDownloadPath) return;
260
- downloadPath = resolvedDownloadPath;
261
- }
262
- const requestBase = buildDownloadRequestBase(cdpUrl, tab.targetId, timeoutMs);
263
- const result = await pw.waitForDownloadViaPlaywright({
264
- ...requestBase,
265
- path: downloadPath
266
- });
267
- res.json({
268
- ok: true,
269
- targetId: tab.targetId,
270
- download: result
271
- });
272
- }
273
- });
274
- }));
275
- app.post("/download", asyncBrowserRoute(async (req, res) => {
276
- const body = readBody(req);
277
- const targetId = resolveTargetIdFromBody(body);
278
- const ref = toStringOrEmpty(body.ref);
279
- const out = toStringOrEmpty(body.path);
280
- const timeoutMs = toNumber(body.timeoutMs);
281
- if (!ref) return jsonError(res, 400, "ref is required");
282
- if (!out) return jsonError(res, 400, "path is required");
283
- await withRouteTabContext({
284
- req,
285
- res,
286
- ctx,
287
- targetId,
288
- run: async ({ profileCtx, cdpUrl, tab }) => {
289
- if (getBrowserProfileCapabilities(profileCtx.profile).usesChromeMcp) return jsonError(res, 501, EXISTING_SESSION_LIMITS.download.downloadUnsupported);
290
- const pw = await requirePwAi(res, "download");
291
- if (!pw) return;
292
- await ensureOutputRootDir(DEFAULT_DOWNLOAD_DIR);
293
- const downloadPath = await resolveWritableOutputPathOrRespond({
294
- res,
295
- rootDir: DEFAULT_DOWNLOAD_DIR,
296
- requestedPath: out,
297
- scopeLabel: "downloads directory"
298
- });
299
- if (!downloadPath) return;
300
- const requestBase = buildDownloadRequestBase(cdpUrl, tab.targetId, timeoutMs);
301
- const result = await pw.downloadViaPlaywright({
302
- ...requestBase,
303
- ref,
304
- path: downloadPath
305
- });
306
- res.json({
307
- ok: true,
308
- targetId: tab.targetId,
309
- download: result
310
- });
311
- }
312
- });
313
- }));
314
- }
315
- //#endregion
316
- //#region extensions/browser/src/browser/routes/agent.act.errors.ts
317
- const ACT_ERROR_CODES = {
318
- kindRequired: "ACT_KIND_REQUIRED",
319
- invalidRequest: "ACT_INVALID_REQUEST",
320
- selectorUnsupported: "ACT_SELECTOR_UNSUPPORTED",
321
- evaluateDisabled: "ACT_EVALUATE_DISABLED",
322
- unsupportedForExistingSession: "ACT_EXISTING_SESSION_UNSUPPORTED",
323
- targetIdMismatch: "ACT_TARGET_ID_MISMATCH"
324
- };
325
- function jsonActError(res, status, code, message) {
326
- res.status(status).json({
327
- error: message,
328
- code
329
- });
330
- }
331
- function browserEvaluateDisabledMessage(action) {
332
- return [action === "wait" ? "wait --fn is disabled by config (browser.evaluateEnabled=false)." : "act:evaluate is disabled by config (browser.evaluateEnabled=false).", "Docs: /gateway/configuration#browser-genesis-managed-browser"].join("\n");
333
- }
334
- //#endregion
335
- //#region extensions/browser/src/browser/routes/agent.act.hooks.ts
336
- function registerBrowserAgentActHookRoutes(app, ctx) {
337
- app.post("/hooks/file-chooser", asyncBrowserRoute(async (req, res) => {
338
- const body = readBody(req);
339
- const targetId = resolveTargetIdFromBody(body);
340
- const ref = toStringOrEmpty(body.ref) || void 0;
341
- const inputRef = toStringOrEmpty(body.inputRef) || void 0;
342
- const element = toStringOrEmpty(body.element) || void 0;
343
- const paths = toStringArray(body.paths) ?? [];
344
- const timeoutMs = toNumber(body.timeoutMs);
345
- if (!paths.length) return jsonError(res, 400, "paths are required");
346
- await withRouteTabContext({
347
- req,
348
- res,
349
- ctx,
350
- targetId,
351
- run: async ({ profileCtx, cdpUrl, tab }) => {
352
- const uploadPathsResult = await resolveExistingPathsWithinRoot({
353
- rootDir: DEFAULT_UPLOAD_DIR,
354
- requestedPaths: paths,
355
- scopeLabel: `uploads directory (${DEFAULT_UPLOAD_DIR})`
356
- });
357
- if (!uploadPathsResult.ok) {
358
- res.status(400).json({ error: uploadPathsResult.error });
359
- return;
360
- }
361
- const resolvedPaths = uploadPathsResult.paths;
362
- if (getBrowserProfileCapabilities(profileCtx.profile).usesChromeMcp) {
363
- if (element) return jsonError(res, 501, EXISTING_SESSION_LIMITS.hooks.uploadElement);
364
- if (resolvedPaths.length !== 1) return jsonError(res, 501, EXISTING_SESSION_LIMITS.hooks.uploadSingleFile);
365
- const uid = inputRef || ref;
366
- if (!uid) return jsonError(res, 501, EXISTING_SESSION_LIMITS.hooks.uploadRefRequired);
367
- await uploadChromeMcpFile({
368
- profileName: profileCtx.profile.name,
369
- userDataDir: profileCtx.profile.userDataDir,
370
- targetId: tab.targetId,
371
- uid,
372
- filePath: resolvedPaths[0] ?? ""
373
- });
374
- return res.json({ ok: true });
375
- }
376
- const pw = await requirePwAi(res, "file chooser hook");
377
- if (!pw) return;
378
- if (inputRef || element) {
379
- if (ref) return jsonError(res, 400, "ref cannot be combined with inputRef/element");
380
- await pw.setInputFilesViaPlaywright({
381
- cdpUrl,
382
- targetId: tab.targetId,
383
- inputRef,
384
- element,
385
- paths: resolvedPaths
386
- });
387
- } else {
388
- await pw.armFileUploadViaPlaywright({
389
- cdpUrl,
390
- targetId: tab.targetId,
391
- paths: resolvedPaths,
392
- timeoutMs: timeoutMs ?? void 0
393
- });
394
- if (ref) await pw.clickViaPlaywright({
395
- cdpUrl,
396
- targetId: tab.targetId,
397
- ssrfPolicy: ctx.state().resolved.ssrfPolicy,
398
- ref
399
- });
400
- }
401
- res.json({ ok: true });
402
- }
403
- });
404
- }));
405
- app.post("/hooks/dialog", asyncBrowserRoute(async (req, res) => {
406
- const body = readBody(req);
407
- const targetId = resolveTargetIdFromBody(body);
408
- const accept = toBoolean(body.accept);
409
- const promptText = toStringOrEmpty(body.promptText) || void 0;
410
- const timeoutMs = toNumber(body.timeoutMs);
411
- if (accept === void 0) return jsonError(res, 400, "accept is required");
412
- await withRouteTabContext({
413
- req,
414
- res,
415
- ctx,
416
- targetId,
417
- run: async ({ profileCtx, cdpUrl, tab }) => {
418
- if (getBrowserProfileCapabilities(profileCtx.profile).usesChromeMcp) {
419
- if (timeoutMs) return jsonError(res, 501, EXISTING_SESSION_LIMITS.hooks.dialogTimeout);
420
- await evaluateChromeMcpScript({
421
- profileName: profileCtx.profile.name,
422
- userDataDir: profileCtx.profile.userDataDir,
423
- targetId: tab.targetId,
424
- fn: `() => {
425
- const state = (window.__genesisDialogHook ??= {});
426
- if (!state.originals) {
427
- state.originals = {
428
- alert: window.alert.bind(window),
429
- confirm: window.confirm.bind(window),
430
- prompt: window.prompt.bind(window),
431
- };
432
- }
433
- const originals = state.originals;
434
- const restore = () => {
435
- window.alert = originals.alert;
436
- window.confirm = originals.confirm;
437
- window.prompt = originals.prompt;
438
- delete window.__genesisDialogHook;
439
- };
440
- window.alert = (...args) => {
441
- try {
442
- return undefined;
443
- } finally {
444
- restore();
445
- }
446
- };
447
- window.confirm = (...args) => {
448
- try {
449
- return ${accept ? "true" : "false"};
450
- } finally {
451
- restore();
452
- }
453
- };
454
- window.prompt = (...args) => {
455
- try {
456
- return ${accept ? JSON.stringify(promptText ?? "") : "null"};
457
- } finally {
458
- restore();
459
- }
460
- };
461
- return true;
462
- }`
463
- });
464
- return res.json({ ok: true });
465
- }
466
- const pw = await requirePwAi(res, "dialog hook");
467
- if (!pw) return;
468
- await pw.armDialogViaPlaywright({
469
- cdpUrl,
470
- targetId: tab.targetId,
471
- accept,
472
- promptText,
473
- timeoutMs: timeoutMs ?? void 0
474
- });
475
- res.json({ ok: true });
476
- }
477
- });
478
- }));
479
- }
480
- //#endregion
481
- //#region extensions/browser/src/browser/routes/agent.act.shared.ts
482
- const ACT_KINDS = [
483
- "batch",
484
- "click",
485
- "clickCoords",
486
- "close",
487
- "drag",
488
- "evaluate",
489
- "fill",
490
- "hover",
491
- "scrollIntoView",
492
- "press",
493
- "resize",
494
- "select",
495
- "type",
496
- "wait"
497
- ];
498
- function isActKind(value) {
499
- if (typeof value !== "string") return false;
500
- return ACT_KINDS.includes(value);
501
- }
502
- const ALLOWED_CLICK_MODIFIERS = new Set([
503
- "Alt",
504
- "Control",
505
- "ControlOrMeta",
506
- "Meta",
507
- "Shift"
508
- ]);
509
- function parseClickButton(raw) {
510
- if (raw === "left" || raw === "right" || raw === "middle") return raw;
511
- }
512
- function parseClickModifiers(raw) {
513
- if (raw.filter((m) => !ALLOWED_CLICK_MODIFIERS.has(m)).length) return { error: "modifiers must be Alt|Control|ControlOrMeta|Meta|Shift" };
514
- return { modifiers: raw.length ? raw : void 0 };
515
- }
516
- //#endregion
517
- //#region extensions/browser/src/browser/routes/agent.act.normalize.ts
518
- function normalizeActKind(raw) {
519
- const kind = toStringOrEmpty(raw);
520
- if (!isActKind(kind)) throw new Error("kind is required");
521
- return kind;
522
- }
523
- function countBatchActions(actions) {
524
- let count = 0;
525
- for (const action of actions) {
526
- count += 1;
527
- if (action.kind === "batch") count += countBatchActions(action.actions);
528
- }
529
- return count;
530
- }
531
- function validateBatchTargetIds(actions, targetId) {
532
- for (const action of actions) {
533
- if (action.targetId && action.targetId !== targetId) return "batched action targetId must match request targetId";
534
- if (action.kind === "batch") {
535
- const nestedError = validateBatchTargetIds(action.actions, targetId);
536
- if (nestedError) return nestedError;
537
- }
538
- }
539
- return null;
540
- }
541
- function normalizeFields(rawFields) {
542
- return (Array.isArray(rawFields) ? rawFields : []).map((field) => {
543
- if (!field || typeof field !== "object") return null;
544
- return normalizeBrowserFormField(field);
545
- }).filter((field) => field !== null);
546
- }
547
- function normalizeBatchAction(value) {
548
- if (!value || typeof value !== "object" || Array.isArray(value)) throw new Error("batch actions must be objects");
549
- return normalizeActRequest(value, { source: "batch" });
550
- }
551
- function normalizeActRequest(body, options) {
552
- const source = options?.source ?? "request";
553
- const kind = normalizeActKind(body.kind);
554
- switch (kind) {
555
- case "click": {
556
- const ref = toStringOrEmpty(body.ref) || void 0;
557
- const selector = toStringOrEmpty(body.selector) || void 0;
558
- if (!ref && !selector) throw new Error("click requires ref or selector");
559
- const buttonRaw = toStringOrEmpty(body.button);
560
- const button = buttonRaw ? parseClickButton(buttonRaw) : void 0;
561
- if (buttonRaw && !button) throw new Error("click button must be left|right|middle");
562
- const parsedModifiers = parseClickModifiers(toStringArray(body.modifiers) ?? []);
563
- if (parsedModifiers.error) throw new Error(parsedModifiers.error);
564
- const doubleClick = toBoolean(body.doubleClick);
565
- const delayMs = normalizeActBoundedNonNegativeMs(toNumber(body.delayMs), "click delayMs", ACT_MAX_CLICK_DELAY_MS);
566
- const timeoutMs = toNumber(body.timeoutMs);
567
- const targetId = toStringOrEmpty(body.targetId) || void 0;
568
- return {
569
- kind,
570
- ...ref ? { ref } : {},
571
- ...selector ? { selector } : {},
572
- ...targetId ? { targetId } : {},
573
- ...doubleClick !== void 0 ? { doubleClick } : {},
574
- ...button ? { button } : {},
575
- ...parsedModifiers.modifiers ? { modifiers: parsedModifiers.modifiers } : {},
576
- ...delayMs !== void 0 ? { delayMs } : {},
577
- ...timeoutMs !== void 0 ? { timeoutMs } : {}
578
- };
579
- }
580
- case "clickCoords": {
581
- const x = toNumber(body.x);
582
- const y = toNumber(body.y);
583
- if (x === void 0 || y === void 0 || x < 0 || y < 0) throw new Error("clickCoords requires non-negative x and y");
584
- const buttonRaw = toStringOrEmpty(body.button);
585
- const button = buttonRaw ? parseClickButton(buttonRaw) : void 0;
586
- if (buttonRaw && !button) throw new Error("clickCoords button must be left|right|middle");
587
- const doubleClick = toBoolean(body.doubleClick);
588
- const delayMs = normalizeActBoundedNonNegativeMs(toNumber(body.delayMs), "clickCoords delayMs", ACT_MAX_CLICK_DELAY_MS);
589
- const timeoutMs = toNumber(body.timeoutMs);
590
- const targetId = toStringOrEmpty(body.targetId) || void 0;
591
- return {
592
- kind,
593
- x,
594
- y,
595
- ...targetId ? { targetId } : {},
596
- ...doubleClick !== void 0 ? { doubleClick } : {},
597
- ...button ? { button } : {},
598
- ...delayMs !== void 0 ? { delayMs } : {},
599
- ...timeoutMs !== void 0 ? { timeoutMs } : {}
600
- };
601
- }
602
- case "type": {
603
- const ref = toStringOrEmpty(body.ref) || void 0;
604
- const selector = toStringOrEmpty(body.selector) || void 0;
605
- const text = body.text;
606
- if (!ref && !selector) throw new Error("type requires ref or selector");
607
- if (typeof text !== "string") throw new Error("type requires text");
608
- const targetId = toStringOrEmpty(body.targetId) || void 0;
609
- const submit = toBoolean(body.submit);
610
- const slowly = toBoolean(body.slowly);
611
- const timeoutMs = toNumber(body.timeoutMs);
612
- return {
613
- kind,
614
- ...ref ? { ref } : {},
615
- ...selector ? { selector } : {},
616
- text,
617
- ...targetId ? { targetId } : {},
618
- ...submit !== void 0 ? { submit } : {},
619
- ...slowly !== void 0 ? { slowly } : {},
620
- ...timeoutMs !== void 0 ? { timeoutMs } : {}
621
- };
622
- }
623
- case "press": {
624
- const key = toStringOrEmpty(body.key);
625
- if (!key) throw new Error("press requires key");
626
- const targetId = toStringOrEmpty(body.targetId) || void 0;
627
- const delayMs = toNumber(body.delayMs);
628
- return {
629
- kind,
630
- key,
631
- ...targetId ? { targetId } : {},
632
- ...delayMs !== void 0 ? { delayMs } : {}
633
- };
634
- }
635
- case "hover":
636
- case "scrollIntoView": {
637
- const ref = toStringOrEmpty(body.ref) || void 0;
638
- const selector = toStringOrEmpty(body.selector) || void 0;
639
- if (!ref && !selector) throw new Error(`${kind} requires ref or selector`);
640
- const targetId = toStringOrEmpty(body.targetId) || void 0;
641
- const timeoutMs = toNumber(body.timeoutMs);
642
- return {
643
- kind,
644
- ...ref ? { ref } : {},
645
- ...selector ? { selector } : {},
646
- ...targetId ? { targetId } : {},
647
- ...timeoutMs !== void 0 ? { timeoutMs } : {}
648
- };
649
- }
650
- case "drag": {
651
- const startRef = toStringOrEmpty(body.startRef) || void 0;
652
- const startSelector = toStringOrEmpty(body.startSelector) || void 0;
653
- const endRef = toStringOrEmpty(body.endRef) || void 0;
654
- const endSelector = toStringOrEmpty(body.endSelector) || void 0;
655
- if (!startRef && !startSelector) throw new Error("drag requires startRef or startSelector");
656
- if (!endRef && !endSelector) throw new Error("drag requires endRef or endSelector");
657
- const targetId = toStringOrEmpty(body.targetId) || void 0;
658
- const timeoutMs = toNumber(body.timeoutMs);
659
- return {
660
- kind,
661
- ...startRef ? { startRef } : {},
662
- ...startSelector ? { startSelector } : {},
663
- ...endRef ? { endRef } : {},
664
- ...endSelector ? { endSelector } : {},
665
- ...targetId ? { targetId } : {},
666
- ...timeoutMs !== void 0 ? { timeoutMs } : {}
667
- };
668
- }
669
- case "select": {
670
- const ref = toStringOrEmpty(body.ref) || void 0;
671
- const selector = toStringOrEmpty(body.selector) || void 0;
672
- const values = toStringArray(body.values);
673
- if (!ref && !selector || !values?.length) throw new Error("select requires ref/selector and values");
674
- const targetId = toStringOrEmpty(body.targetId) || void 0;
675
- const timeoutMs = toNumber(body.timeoutMs);
676
- return {
677
- kind,
678
- ...ref ? { ref } : {},
679
- ...selector ? { selector } : {},
680
- values,
681
- ...targetId ? { targetId } : {},
682
- ...timeoutMs !== void 0 ? { timeoutMs } : {}
683
- };
684
- }
685
- case "fill": {
686
- const fields = normalizeFields(body.fields);
687
- if (!fields.length) throw new Error("fill requires fields");
688
- const targetId = toStringOrEmpty(body.targetId) || void 0;
689
- const timeoutMs = toNumber(body.timeoutMs);
690
- return {
691
- kind,
692
- fields,
693
- ...targetId ? { targetId } : {},
694
- ...timeoutMs !== void 0 ? { timeoutMs } : {}
695
- };
696
- }
697
- case "resize": {
698
- const width = toNumber(body.width);
699
- const height = toNumber(body.height);
700
- if (width === void 0 || height === void 0 || width <= 0 || height <= 0) throw new Error("resize requires positive width and height");
701
- const targetId = toStringOrEmpty(body.targetId) || void 0;
702
- return {
703
- kind,
704
- width,
705
- height,
706
- ...targetId ? { targetId } : {}
707
- };
708
- }
709
- case "wait": {
710
- const loadStateRaw = toStringOrEmpty(body.loadState);
711
- const loadState = loadStateRaw === "load" || loadStateRaw === "domcontentloaded" || loadStateRaw === "networkidle" ? loadStateRaw : void 0;
712
- const timeMs = normalizeActBoundedNonNegativeMs(toNumber(body.timeMs), "wait timeMs", ACT_MAX_WAIT_TIME_MS);
713
- const text = toStringOrEmpty(body.text) || void 0;
714
- const textGone = toStringOrEmpty(body.textGone) || void 0;
715
- const selector = toStringOrEmpty(body.selector) || void 0;
716
- const url = toStringOrEmpty(body.url) || void 0;
717
- const fn = toStringOrEmpty(body.fn) || void 0;
718
- if (timeMs === void 0 && !text && !textGone && !selector && !url && !loadState && !fn) throw new Error("wait requires at least one of: timeMs, text, textGone, selector, url, loadState, fn");
719
- const targetId = toStringOrEmpty(body.targetId) || void 0;
720
- const timeoutMs = toNumber(body.timeoutMs);
721
- return {
722
- kind,
723
- ...timeMs !== void 0 ? { timeMs } : {},
724
- ...text ? { text } : {},
725
- ...textGone ? { textGone } : {},
726
- ...selector ? { selector } : {},
727
- ...url ? { url } : {},
728
- ...loadState ? { loadState } : {},
729
- ...fn ? { fn } : {},
730
- ...targetId ? { targetId } : {},
731
- ...timeoutMs !== void 0 ? { timeoutMs } : {}
732
- };
733
- }
734
- case "evaluate": {
735
- const fn = toStringOrEmpty(body.fn);
736
- if (!fn) throw new Error("evaluate requires fn");
737
- const ref = toStringOrEmpty(body.ref) || void 0;
738
- const targetId = toStringOrEmpty(body.targetId) || void 0;
739
- const timeoutMs = toNumber(body.timeoutMs);
740
- return {
741
- kind,
742
- fn,
743
- ...ref ? { ref } : {},
744
- ...targetId ? { targetId } : {},
745
- ...timeoutMs !== void 0 ? { timeoutMs } : {}
746
- };
747
- }
748
- case "close": {
749
- const targetId = toStringOrEmpty(body.targetId) || void 0;
750
- return {
751
- kind,
752
- ...targetId ? { targetId } : {}
753
- };
754
- }
755
- case "batch": {
756
- const actions = Array.isArray(body.actions) ? body.actions.map(normalizeBatchAction) : [];
757
- if (!actions.length) throw new Error(source === "batch" ? "batch requires actions" : "actions are required");
758
- if (countBatchActions(actions) > 100) throw new Error(`batch exceeds maximum of 100 actions`);
759
- const targetId = toStringOrEmpty(body.targetId) || void 0;
760
- const stopOnError = toBoolean(body.stopOnError);
761
- return {
762
- kind,
763
- actions,
764
- ...targetId ? { targetId } : {},
765
- ...stopOnError !== void 0 ? { stopOnError } : {}
766
- };
767
- }
768
- }
769
- throw new Error("Unsupported browser act kind");
770
- }
771
- //#endregion
772
- //#region extensions/browser/src/browser/routes/agent.act.ts
773
- function sleep(ms) {
774
- return new Promise((resolve) => setTimeout(resolve, ms));
775
- }
776
- const EXISTING_SESSION_INTERACTION_NAVIGATION_RECHECK_DELAYS_MS = [
777
- 0,
778
- 250,
779
- 500
780
- ];
781
- async function readExistingSessionLocationHref(params) {
782
- const currentUrl = await evaluateChromeMcpScript({
783
- profileName: params.profileName,
784
- userDataDir: params.userDataDir,
785
- targetId: params.targetId,
786
- fn: "() => window.location.href"
787
- });
788
- if (typeof currentUrl !== "string") throw new Error("Location probe returned a non-string result");
789
- const normalizedUrl = currentUrl.trim();
790
- if (!normalizedUrl) throw new Error("Location probe returned an empty URL");
791
- return normalizedUrl;
792
- }
793
- async function assertExistingSessionPostInteractionNavigationAllowed(params) {
794
- const ssrfPolicyOpts = withBrowserNavigationPolicy(params.ssrfPolicy);
795
- if (!ssrfPolicyOpts.ssrfPolicy) return;
796
- const listTabs = params.listTabs;
797
- const initialTabTargetIds = params.initialTabTargetIds;
798
- const assertNewTabsAllowed = async () => {
799
- const tabs = await listTabs();
800
- for (const tab of tabs) {
801
- if (initialTabTargetIds.has(tab.targetId)) continue;
802
- await assertBrowserNavigationResultAllowed({
803
- url: tab.url,
804
- ...ssrfPolicyOpts
805
- });
806
- }
807
- };
808
- let lastObservedUrl;
809
- let sawStableAllowedUrl = false;
810
- for (const delayMs of EXISTING_SESSION_INTERACTION_NAVIGATION_RECHECK_DELAYS_MS) {
811
- if (delayMs > 0) await sleep(delayMs);
812
- let currentUrl;
813
- try {
814
- currentUrl = await readExistingSessionLocationHref(params);
815
- } catch {
816
- sawStableAllowedUrl = false;
817
- continue;
818
- }
819
- await assertBrowserNavigationResultAllowed({
820
- url: currentUrl,
821
- ...ssrfPolicyOpts
822
- });
823
- if (currentUrl === lastObservedUrl) sawStableAllowedUrl = true;
824
- else sawStableAllowedUrl = false;
825
- lastObservedUrl = currentUrl;
826
- }
827
- if (sawStableAllowedUrl) {
828
- await assertNewTabsAllowed();
829
- return;
830
- }
831
- if (lastObservedUrl) {
832
- const lastDelay = EXISTING_SESSION_INTERACTION_NAVIGATION_RECHECK_DELAYS_MS[EXISTING_SESSION_INTERACTION_NAVIGATION_RECHECK_DELAYS_MS.length - 1];
833
- await sleep(lastDelay);
834
- try {
835
- const followUpUrl = await readExistingSessionLocationHref(params);
836
- await assertBrowserNavigationResultAllowed({
837
- url: followUpUrl,
838
- ...ssrfPolicyOpts
839
- });
840
- if (followUpUrl === lastObservedUrl) {
841
- await assertNewTabsAllowed();
842
- return;
843
- }
844
- } catch {}
845
- }
846
- throw new Error("Unable to verify stable post-interaction navigation");
847
- }
848
- async function runExistingSessionActionWithNavigationGuard(params) {
849
- let actionError;
850
- let result;
851
- try {
852
- result = await params.execute();
853
- } catch (error) {
854
- actionError = error;
855
- }
856
- if (params.guard) await assertExistingSessionPostInteractionNavigationAllowed(params.guard);
857
- if (actionError) throw actionError;
858
- return result;
859
- }
860
- function buildExistingSessionWaitPredicate(params) {
861
- const checks = [];
862
- if (params.text) checks.push(`Boolean(document.body?.innerText?.includes(${JSON.stringify(params.text)}))`);
863
- if (params.textGone) checks.push(`!document.body?.innerText?.includes(${JSON.stringify(params.textGone)})`);
864
- if (params.selector) checks.push(`Boolean(document.querySelector(${JSON.stringify(params.selector)}))`);
865
- if (params.loadState === "domcontentloaded") checks.push(`document.readyState === "interactive" || document.readyState === "complete"`);
866
- else if (params.loadState === "load") checks.push(`document.readyState === "complete"`);
867
- if (params.fn) checks.push(`Boolean(await (${params.fn})())`);
868
- if (checks.length === 0) return null;
869
- return checks.length === 1 ? checks[0] : checks.map((check) => `(${check})`).join(" && ");
870
- }
871
- async function waitForExistingSessionCondition(params) {
872
- if (params.timeMs && params.timeMs > 0) await sleep(params.timeMs);
873
- const predicate = buildExistingSessionWaitPredicate(params);
874
- if (!predicate && !params.url) return;
875
- const timeoutMs = Math.max(250, params.timeoutMs ?? 1e4);
876
- const deadline = Date.now() + timeoutMs;
877
- while (Date.now() < deadline) {
878
- let ready = true;
879
- if (predicate) ready = Boolean(await evaluateChromeMcpScript({
880
- profileName: params.profileName,
881
- userDataDir: params.userDataDir,
882
- targetId: params.targetId,
883
- fn: `async () => ${predicate}`
884
- }));
885
- if (ready && params.url) {
886
- const currentUrl = await evaluateChromeMcpScript({
887
- profileName: params.profileName,
888
- userDataDir: params.userDataDir,
889
- targetId: params.targetId,
890
- fn: "() => window.location.href"
891
- });
892
- ready = typeof currentUrl === "string" && matchBrowserUrlPattern(params.url, currentUrl);
893
- }
894
- if (ready) return;
895
- await sleep(250);
896
- }
897
- throw new Error("Timed out waiting for condition");
898
- }
899
- const SELECTOR_ALLOWED_KINDS = new Set([
900
- "batch",
901
- "click",
902
- "drag",
903
- "hover",
904
- "scrollIntoView",
905
- "select",
906
- "type",
907
- "wait"
908
- ]);
909
- function getExistingSessionUnsupportedMessage(action) {
910
- switch (action.kind) {
911
- case "click":
912
- if (action.selector) return EXISTING_SESSION_LIMITS.act.clickSelector;
913
- if (action.button && action.button !== "left" || Array.isArray(action.modifiers) && action.modifiers.length > 0) return EXISTING_SESSION_LIMITS.act.clickButtonOrModifiers;
914
- return null;
915
- case "clickCoords": return null;
916
- case "type":
917
- if (action.selector) return EXISTING_SESSION_LIMITS.act.typeSelector;
918
- if (action.slowly) return EXISTING_SESSION_LIMITS.act.typeSlowly;
919
- return action.timeoutMs ? EXISTING_SESSION_LIMITS.act.typeTimeout : null;
920
- case "press": return action.delayMs ? EXISTING_SESSION_LIMITS.act.pressDelay : null;
921
- case "hover":
922
- if (action.selector) return EXISTING_SESSION_LIMITS.act.hoverSelector;
923
- return action.timeoutMs ? EXISTING_SESSION_LIMITS.act.hoverTimeout : null;
924
- case "scrollIntoView":
925
- if (action.selector) return EXISTING_SESSION_LIMITS.act.scrollSelector;
926
- return action.timeoutMs ? EXISTING_SESSION_LIMITS.act.scrollTimeout : null;
927
- case "drag":
928
- if (action.startSelector || action.endSelector) return EXISTING_SESSION_LIMITS.act.dragSelector;
929
- return action.timeoutMs ? EXISTING_SESSION_LIMITS.act.dragTimeout : null;
930
- case "select":
931
- if (action.selector) return EXISTING_SESSION_LIMITS.act.selectSelector;
932
- if (action.values.length !== 1) return EXISTING_SESSION_LIMITS.act.selectSingleValue;
933
- return action.timeoutMs ? EXISTING_SESSION_LIMITS.act.selectTimeout : null;
934
- case "fill": return action.timeoutMs ? EXISTING_SESSION_LIMITS.act.fillTimeout : null;
935
- case "wait": return action.loadState === "networkidle" ? EXISTING_SESSION_LIMITS.act.waitNetworkIdle : null;
936
- case "evaluate": return action.timeoutMs !== void 0 ? EXISTING_SESSION_LIMITS.act.evaluateTimeout : null;
937
- case "batch": return EXISTING_SESSION_LIMITS.act.batch;
938
- case "resize":
939
- case "close": return null;
940
- }
941
- throw new Error("Unsupported browser act kind");
942
- }
943
- function registerBrowserAgentActRoutes(app, ctx) {
944
- app.post("/act", asyncBrowserRoute(async (req, res) => {
945
- const body = readBody(req);
946
- const kindRaw = toStringOrEmpty(body.kind);
947
- if (!isActKind(kindRaw)) return jsonActError(res, 400, ACT_ERROR_CODES.kindRequired, "kind is required");
948
- const kind = kindRaw;
949
- let action;
950
- try {
951
- action = normalizeActRequest(body);
952
- } catch (err) {
953
- return jsonActError(res, 400, ACT_ERROR_CODES.invalidRequest, formatErrorMessage(err));
954
- }
955
- const targetId = resolveTargetIdFromBody(body);
956
- if (Object.hasOwn(body, "selector") && !SELECTOR_ALLOWED_KINDS.has(kind)) return jsonActError(res, 400, ACT_ERROR_CODES.selectorUnsupported, SELECTOR_UNSUPPORTED_MESSAGE);
957
- const earlyFn = action.kind === "wait" || action.kind === "evaluate" ? action.fn : "";
958
- if ((action.kind === "evaluate" || action.kind === "wait" && earlyFn) && !ctx.state().resolved.evaluateEnabled) return jsonActError(res, 403, ACT_ERROR_CODES.evaluateDisabled, browserEvaluateDisabledMessage(action.kind === "evaluate" ? "evaluate" : "wait"));
959
- await withRouteTabContext({
960
- req,
961
- res,
962
- ctx,
963
- targetId,
964
- run: async ({ profileCtx, cdpUrl, tab }) => {
965
- const evaluateEnabled = ctx.state().resolved.evaluateEnabled;
966
- const ssrfPolicy = ctx.state().resolved.ssrfPolicy;
967
- if (action.targetId && action.targetId !== tab.targetId) return jsonActError(res, 403, ACT_ERROR_CODES.targetIdMismatch, "action targetId must match request targetId");
968
- const isExistingSession = getBrowserProfileCapabilities(profileCtx.profile).usesChromeMcp;
969
- const profileName = profileCtx.profile.name;
970
- if (isExistingSession) {
971
- const initialTabTargetIds = withBrowserNavigationPolicy(ssrfPolicy).ssrfPolicy ? new Set((await profileCtx.listTabs()).map((currentTab) => currentTab.targetId)) : /* @__PURE__ */ new Set();
972
- const existingSessionNavigationGuard = {
973
- profileName,
974
- userDataDir: profileCtx.profile.userDataDir,
975
- targetId: tab.targetId,
976
- ssrfPolicy,
977
- listTabs: () => profileCtx.listTabs(),
978
- initialTabTargetIds
979
- };
980
- const unsupportedMessage = getExistingSessionUnsupportedMessage(action);
981
- if (unsupportedMessage) return jsonActError(res, 501, ACT_ERROR_CODES.unsupportedForExistingSession, unsupportedMessage);
982
- switch (action.kind) {
983
- case "click":
984
- await runExistingSessionActionWithNavigationGuard({
985
- execute: () => clickChromeMcpElement({
986
- profileName,
987
- userDataDir: profileCtx.profile.userDataDir,
988
- targetId: tab.targetId,
989
- uid: action.ref,
990
- doubleClick: action.doubleClick ?? false,
991
- timeoutMs: action.timeoutMs,
992
- signal: req.signal
993
- }),
994
- guard: existingSessionNavigationGuard
995
- });
996
- return res.json({
997
- ok: true,
998
- targetId: tab.targetId,
999
- url: tab.url
1000
- });
1001
- case "clickCoords":
1002
- await runExistingSessionActionWithNavigationGuard({
1003
- execute: () => clickChromeMcpCoords({
1004
- profileName,
1005
- userDataDir: profileCtx.profile.userDataDir,
1006
- targetId: tab.targetId,
1007
- x: action.x,
1008
- y: action.y,
1009
- doubleClick: action.doubleClick ?? false,
1010
- button: action.button,
1011
- delayMs: action.delayMs
1012
- }),
1013
- guard: existingSessionNavigationGuard
1014
- });
1015
- return res.json({
1016
- ok: true,
1017
- targetId: tab.targetId,
1018
- url: tab.url
1019
- });
1020
- case "type":
1021
- await runExistingSessionActionWithNavigationGuard({
1022
- execute: async () => {
1023
- await fillChromeMcpElement({
1024
- profileName,
1025
- userDataDir: profileCtx.profile.userDataDir,
1026
- targetId: tab.targetId,
1027
- uid: action.ref,
1028
- value: action.text
1029
- });
1030
- if (action.submit) await pressChromeMcpKey({
1031
- profileName,
1032
- userDataDir: profileCtx.profile.userDataDir,
1033
- targetId: tab.targetId,
1034
- key: "Enter"
1035
- });
1036
- },
1037
- guard: existingSessionNavigationGuard
1038
- });
1039
- return res.json({
1040
- ok: true,
1041
- targetId: tab.targetId
1042
- });
1043
- case "press":
1044
- await runExistingSessionActionWithNavigationGuard({
1045
- execute: () => pressChromeMcpKey({
1046
- profileName,
1047
- userDataDir: profileCtx.profile.userDataDir,
1048
- targetId: tab.targetId,
1049
- key: action.key
1050
- }),
1051
- guard: existingSessionNavigationGuard
1052
- });
1053
- return res.json({
1054
- ok: true,
1055
- targetId: tab.targetId
1056
- });
1057
- case "hover":
1058
- await runExistingSessionActionWithNavigationGuard({
1059
- execute: () => hoverChromeMcpElement({
1060
- profileName,
1061
- userDataDir: profileCtx.profile.userDataDir,
1062
- targetId: tab.targetId,
1063
- uid: action.ref
1064
- }),
1065
- guard: existingSessionNavigationGuard
1066
- });
1067
- return res.json({
1068
- ok: true,
1069
- targetId: tab.targetId
1070
- });
1071
- case "scrollIntoView":
1072
- await runExistingSessionActionWithNavigationGuard({
1073
- execute: () => evaluateChromeMcpScript({
1074
- profileName,
1075
- userDataDir: profileCtx.profile.userDataDir,
1076
- targetId: tab.targetId,
1077
- fn: `(el) => { el.scrollIntoView({ block: "center", inline: "center" }); return true; }`,
1078
- args: [action.ref]
1079
- }),
1080
- guard: existingSessionNavigationGuard
1081
- });
1082
- return res.json({
1083
- ok: true,
1084
- targetId: tab.targetId
1085
- });
1086
- case "drag":
1087
- await runExistingSessionActionWithNavigationGuard({
1088
- execute: () => dragChromeMcpElement({
1089
- profileName,
1090
- userDataDir: profileCtx.profile.userDataDir,
1091
- targetId: tab.targetId,
1092
- fromUid: action.startRef,
1093
- toUid: action.endRef
1094
- }),
1095
- guard: existingSessionNavigationGuard
1096
- });
1097
- return res.json({
1098
- ok: true,
1099
- targetId: tab.targetId
1100
- });
1101
- case "select":
1102
- await runExistingSessionActionWithNavigationGuard({
1103
- execute: () => fillChromeMcpElement({
1104
- profileName,
1105
- userDataDir: profileCtx.profile.userDataDir,
1106
- targetId: tab.targetId,
1107
- uid: action.ref,
1108
- value: action.values[0] ?? ""
1109
- }),
1110
- guard: existingSessionNavigationGuard
1111
- });
1112
- return res.json({
1113
- ok: true,
1114
- targetId: tab.targetId
1115
- });
1116
- case "fill":
1117
- await runExistingSessionActionWithNavigationGuard({
1118
- execute: () => fillChromeMcpForm({
1119
- profileName,
1120
- userDataDir: profileCtx.profile.userDataDir,
1121
- targetId: tab.targetId,
1122
- elements: action.fields.map((field) => ({
1123
- uid: field.ref,
1124
- value: String(field.value ?? "")
1125
- }))
1126
- }),
1127
- guard: existingSessionNavigationGuard
1128
- });
1129
- return res.json({
1130
- ok: true,
1131
- targetId: tab.targetId
1132
- });
1133
- case "resize":
1134
- await resizeChromeMcpPage({
1135
- profileName,
1136
- userDataDir: profileCtx.profile.userDataDir,
1137
- targetId: tab.targetId,
1138
- width: action.width,
1139
- height: action.height
1140
- });
1141
- return res.json({
1142
- ok: true,
1143
- targetId: tab.targetId,
1144
- url: tab.url
1145
- });
1146
- case "wait":
1147
- await waitForExistingSessionCondition({
1148
- profileName,
1149
- userDataDir: profileCtx.profile.userDataDir,
1150
- targetId: tab.targetId,
1151
- timeMs: action.timeMs,
1152
- text: action.text,
1153
- textGone: action.textGone,
1154
- selector: action.selector,
1155
- url: action.url,
1156
- loadState: action.loadState,
1157
- fn: action.fn,
1158
- timeoutMs: action.timeoutMs
1159
- });
1160
- return res.json({
1161
- ok: true,
1162
- targetId: tab.targetId
1163
- });
1164
- case "evaluate": {
1165
- const result = await runExistingSessionActionWithNavigationGuard({
1166
- execute: () => evaluateChromeMcpScript({
1167
- profileName,
1168
- userDataDir: profileCtx.profile.userDataDir,
1169
- targetId: tab.targetId,
1170
- fn: action.fn,
1171
- args: action.ref ? [action.ref] : void 0
1172
- }),
1173
- guard: existingSessionNavigationGuard
1174
- });
1175
- return res.json({
1176
- ok: true,
1177
- targetId: tab.targetId,
1178
- url: tab.url,
1179
- result
1180
- });
1181
- }
1182
- case "close":
1183
- await closeChromeMcpTab(profileName, tab.targetId, profileCtx.profile.userDataDir);
1184
- return res.json({
1185
- ok: true,
1186
- targetId: tab.targetId
1187
- });
1188
- case "batch": return jsonActError(res, 501, ACT_ERROR_CODES.unsupportedForExistingSession, EXISTING_SESSION_LIMITS.act.batch);
1189
- }
1190
- }
1191
- const pw = await requirePwAi(res, `act:${kind}`);
1192
- if (!pw) return;
1193
- if (action.kind === "batch") {
1194
- const targetIdError = validateBatchTargetIds(action.actions, tab.targetId);
1195
- if (targetIdError) return jsonActError(res, 403, ACT_ERROR_CODES.targetIdMismatch, targetIdError);
1196
- }
1197
- const result = await pw.executeActViaPlaywright({
1198
- cdpUrl,
1199
- action,
1200
- targetId: tab.targetId,
1201
- evaluateEnabled,
1202
- ssrfPolicy,
1203
- signal: req.signal
1204
- });
1205
- switch (action.kind) {
1206
- case "batch": return res.json({
1207
- ok: true,
1208
- targetId: tab.targetId,
1209
- results: result.results ?? []
1210
- });
1211
- case "evaluate": return res.json({
1212
- ok: true,
1213
- targetId: tab.targetId,
1214
- url: tab.url,
1215
- result: result.result
1216
- });
1217
- case "click":
1218
- case "clickCoords":
1219
- case "resize": return res.json({
1220
- ok: true,
1221
- targetId: tab.targetId,
1222
- url: tab.url
1223
- });
1224
- default: return res.json({
1225
- ok: true,
1226
- targetId: tab.targetId
1227
- });
1228
- }
1229
- }
1230
- });
1231
- }));
1232
- registerBrowserAgentActHookRoutes(app, ctx);
1233
- registerBrowserAgentActDownloadRoutes(app, ctx);
1234
- app.post("/response/body", asyncBrowserRoute(async (req, res) => {
1235
- const body = readBody(req);
1236
- const targetId = resolveTargetIdFromBody(body);
1237
- const url = toStringOrEmpty(body.url);
1238
- const timeoutMs = toNumber(body.timeoutMs);
1239
- const maxChars = toNumber(body.maxChars);
1240
- if (!url) return jsonError(res, 400, "url is required");
1241
- await withRouteTabContext({
1242
- req,
1243
- res,
1244
- ctx,
1245
- targetId,
1246
- run: async ({ profileCtx, cdpUrl, tab }) => {
1247
- if (getBrowserProfileCapabilities(profileCtx.profile).usesChromeMcp) return jsonError(res, 501, EXISTING_SESSION_LIMITS.responseBody);
1248
- const pw = await requirePwAi(res, "response body");
1249
- if (!pw) return;
1250
- const result = await pw.responseBodyViaPlaywright({
1251
- cdpUrl,
1252
- targetId: tab.targetId,
1253
- url,
1254
- timeoutMs: timeoutMs ?? void 0,
1255
- maxChars: maxChars ?? void 0
1256
- });
1257
- res.json({
1258
- ok: true,
1259
- targetId: tab.targetId,
1260
- response: result
1261
- });
1262
- }
1263
- });
1264
- }));
1265
- app.post("/highlight", asyncBrowserRoute(async (req, res) => {
1266
- const body = readBody(req);
1267
- const targetId = resolveTargetIdFromBody(body);
1268
- const ref = toStringOrEmpty(body.ref);
1269
- if (!ref) return jsonError(res, 400, "ref is required");
1270
- await withRouteTabContext({
1271
- req,
1272
- res,
1273
- ctx,
1274
- targetId,
1275
- run: async ({ profileCtx, cdpUrl, tab }) => {
1276
- if (getBrowserProfileCapabilities(profileCtx.profile).usesChromeMcp) {
1277
- await evaluateChromeMcpScript({
1278
- profileName: profileCtx.profile.name,
1279
- userDataDir: profileCtx.profile.userDataDir,
1280
- targetId: tab.targetId,
1281
- args: [ref],
1282
- fn: `(el) => {
1283
- if (!(el instanceof Element)) {
1284
- return false;
1285
- }
1286
- el.scrollIntoView({ block: "center", inline: "center" });
1287
- const previousOutline = el.style.outline;
1288
- const previousOffset = el.style.outlineOffset;
1289
- el.style.outline = "3px solid #FF4500";
1290
- el.style.outlineOffset = "2px";
1291
- setTimeout(() => {
1292
- el.style.outline = previousOutline;
1293
- el.style.outlineOffset = previousOffset;
1294
- }, 2000);
1295
- return true;
1296
- }`
1297
- });
1298
- return res.json({
1299
- ok: true,
1300
- targetId: tab.targetId
1301
- });
1302
- }
1303
- const pw = await requirePwAi(res, "highlight");
1304
- if (!pw) return;
1305
- await pw.highlightViaPlaywright({
1306
- cdpUrl,
1307
- targetId: tab.targetId,
1308
- ref
1309
- });
1310
- res.json({
1311
- ok: true,
1312
- targetId: tab.targetId
1313
- });
1314
- }
1315
- });
1316
- }));
1317
- }
1318
- //#endregion
1319
- //#region extensions/browser/src/browser/routes/agent.debug.ts
1320
- function registerBrowserAgentDebugRoutes(app, ctx) {
1321
- app.get("/console", asyncBrowserRoute(async (req, res) => {
1322
- const targetId = resolveTargetIdFromQuery(req.query);
1323
- const level = typeof req.query.level === "string" ? req.query.level : "";
1324
- await withPlaywrightRouteContext({
1325
- req,
1326
- res,
1327
- ctx,
1328
- targetId,
1329
- feature: "console messages",
1330
- run: async ({ cdpUrl, tab, pw }) => {
1331
- const messages = await pw.getConsoleMessagesViaPlaywright({
1332
- cdpUrl,
1333
- targetId: tab.targetId,
1334
- level: normalizeOptionalString$4(level)
1335
- });
1336
- res.json({
1337
- ok: true,
1338
- messages,
1339
- targetId: tab.targetId
1340
- });
1341
- }
1342
- });
1343
- }));
1344
- app.get("/errors", asyncBrowserRoute(async (req, res) => {
1345
- const targetId = resolveTargetIdFromQuery(req.query);
1346
- const clear = toBoolean(req.query.clear) ?? false;
1347
- await withPlaywrightRouteContext({
1348
- req,
1349
- res,
1350
- ctx,
1351
- targetId,
1352
- feature: "page errors",
1353
- run: async ({ cdpUrl, tab, pw }) => {
1354
- const result = await pw.getPageErrorsViaPlaywright({
1355
- cdpUrl,
1356
- targetId: tab.targetId,
1357
- clear
1358
- });
1359
- res.json({
1360
- ok: true,
1361
- targetId: tab.targetId,
1362
- ...result
1363
- });
1364
- }
1365
- });
1366
- }));
1367
- app.get("/requests", asyncBrowserRoute(async (req, res) => {
1368
- const targetId = resolveTargetIdFromQuery(req.query);
1369
- const filter = typeof req.query.filter === "string" ? req.query.filter : "";
1370
- const clear = toBoolean(req.query.clear) ?? false;
1371
- await withPlaywrightRouteContext({
1372
- req,
1373
- res,
1374
- ctx,
1375
- targetId,
1376
- feature: "network requests",
1377
- run: async ({ cdpUrl, tab, pw }) => {
1378
- const result = await pw.getNetworkRequestsViaPlaywright({
1379
- cdpUrl,
1380
- targetId: tab.targetId,
1381
- filter: normalizeOptionalString$4(filter),
1382
- clear
1383
- });
1384
- res.json({
1385
- ok: true,
1386
- targetId: tab.targetId,
1387
- ...result
1388
- });
1389
- }
1390
- });
1391
- }));
1392
- app.post("/trace/start", asyncBrowserRoute(async (req, res) => {
1393
- const body = readBody(req);
1394
- const targetId = resolveTargetIdFromBody(body);
1395
- const screenshots = toBoolean(body.screenshots) ?? void 0;
1396
- const snapshots = toBoolean(body.snapshots) ?? void 0;
1397
- const sources = toBoolean(body.sources) ?? void 0;
1398
- await withPlaywrightRouteContext({
1399
- req,
1400
- res,
1401
- ctx,
1402
- targetId,
1403
- feature: "trace start",
1404
- run: async ({ cdpUrl, tab, pw }) => {
1405
- await pw.traceStartViaPlaywright({
1406
- cdpUrl,
1407
- targetId: tab.targetId,
1408
- screenshots,
1409
- snapshots,
1410
- sources
1411
- });
1412
- res.json({
1413
- ok: true,
1414
- targetId: tab.targetId
1415
- });
1416
- }
1417
- });
1418
- }));
1419
- app.post("/trace/stop", asyncBrowserRoute(async (req, res) => {
1420
- const body = readBody(req);
1421
- const targetId = resolveTargetIdFromBody(body);
1422
- const out = toStringOrEmpty(body.path) || "";
1423
- await withPlaywrightRouteContext({
1424
- req,
1425
- res,
1426
- ctx,
1427
- targetId,
1428
- feature: "trace stop",
1429
- run: async ({ cdpUrl, tab, pw }) => {
1430
- const tracePath = await resolveWritableOutputPathOrRespond({
1431
- res,
1432
- rootDir: DEFAULT_TRACE_DIR,
1433
- requestedPath: out,
1434
- scopeLabel: "trace directory",
1435
- defaultFileName: `browser-trace-${crypto.randomUUID()}.zip`,
1436
- ensureRootDir: true
1437
- });
1438
- if (!tracePath) return;
1439
- await pw.traceStopViaPlaywright({
1440
- cdpUrl,
1441
- targetId: tab.targetId,
1442
- path: tracePath
1443
- });
1444
- res.json({
1445
- ok: true,
1446
- targetId: tab.targetId,
1447
- path: path.resolve(tracePath)
1448
- });
1449
- }
1450
- });
1451
- }));
1452
- }
1453
- //#endregion
1454
- //#region extensions/browser/src/browser/chrome-mcp.snapshot.ts
1455
- function normalizeRole(node) {
1456
- return normalizeLowercaseStringOrEmpty(node.role) || "generic";
1457
- }
1458
- function escapeQuoted(value) {
1459
- return value.replaceAll("\\", "\\\\").replaceAll("\"", "\\\"");
1460
- }
1461
- function shouldIncludeNode(params) {
1462
- if (params.options?.interactive && !INTERACTIVE_ROLES.has(params.role)) return false;
1463
- if (params.options?.compact && STRUCTURAL_ROLES.has(params.role) && !params.name) return false;
1464
- return true;
1465
- }
1466
- function shouldCreateRef(role, name) {
1467
- return INTERACTIVE_ROLES.has(role) || CONTENT_ROLES.has(role) && Boolean(name);
1468
- }
1469
- function createDuplicateTracker() {
1470
- return {
1471
- counts: /* @__PURE__ */ new Map(),
1472
- keysByRef: /* @__PURE__ */ new Map(),
1473
- duplicates: /* @__PURE__ */ new Set()
1474
- };
1475
- }
1476
- function registerRef(tracker, ref, role, name) {
1477
- const key = `${role}:${name ?? ""}`;
1478
- const count = tracker.counts.get(key) ?? 0;
1479
- tracker.counts.set(key, count + 1);
1480
- tracker.keysByRef.set(ref, key);
1481
- if (count > 0) {
1482
- tracker.duplicates.add(key);
1483
- return count;
1484
- }
1485
- }
1486
- function flattenChromeMcpSnapshotToAriaNodes(root, limit = 500) {
1487
- const boundedLimit = Math.max(1, Math.min(2e3, Math.floor(limit)));
1488
- const out = [];
1489
- const visit = (node, depth) => {
1490
- if (out.length >= boundedLimit) return;
1491
- const ref = normalizeString(node.id);
1492
- if (ref) out.push({
1493
- ref,
1494
- role: normalizeRole(node),
1495
- name: normalizeString(node.name) ?? "",
1496
- value: normalizeString(node.value),
1497
- description: normalizeString(node.description),
1498
- depth
1499
- });
1500
- for (const child of node.children ?? []) {
1501
- visit(child, depth + 1);
1502
- if (out.length >= boundedLimit) return;
1503
- }
1504
- };
1505
- visit(root, 0);
1506
- return out;
1507
- }
1508
- function buildAiSnapshotFromChromeMcpSnapshot(params) {
1509
- const refs = {};
1510
- const tracker = createDuplicateTracker();
1511
- const lines = [];
1512
- const visit = (node, depth) => {
1513
- const role = normalizeRole(node);
1514
- const name = normalizeString(node.name);
1515
- const value = normalizeString(node.value);
1516
- const description = normalizeString(node.description);
1517
- const maxDepth = params.options?.maxDepth;
1518
- if (maxDepth !== void 0 && depth > maxDepth) return;
1519
- if (shouldIncludeNode({
1520
- role,
1521
- name,
1522
- options: params.options
1523
- })) {
1524
- let line = `${" ".repeat(depth)}- ${role}`;
1525
- if (name) line += ` "${escapeQuoted(name)}"`;
1526
- const ref = normalizeString(node.id);
1527
- if (ref && shouldCreateRef(role, name)) {
1528
- const nth = registerRef(tracker, ref, role, name);
1529
- refs[ref] = nth === void 0 ? {
1530
- role,
1531
- name
1532
- } : {
1533
- role,
1534
- name,
1535
- nth
1536
- };
1537
- line += ` [ref=${ref}]`;
1538
- }
1539
- if (value) line += ` value="${escapeQuoted(value)}"`;
1540
- if (description) line += ` description="${escapeQuoted(description)}"`;
1541
- lines.push(line);
1542
- }
1543
- for (const child of node.children ?? []) visit(child, depth + 1);
1544
- };
1545
- visit(params.root, 0);
1546
- for (const [ref, data] of Object.entries(refs)) {
1547
- const key = tracker.keysByRef.get(ref);
1548
- if (key && !tracker.duplicates.has(key)) delete data.nth;
1549
- }
1550
- let snapshot = lines.join("\n");
1551
- let truncated = false;
1552
- const maxChars = typeof params.maxChars === "number" && Number.isFinite(params.maxChars) && params.maxChars > 0 ? Math.floor(params.maxChars) : void 0;
1553
- if (maxChars && snapshot.length > maxChars) {
1554
- snapshot = `${snapshot.slice(0, maxChars)}\n\n[...TRUNCATED - page too large]`;
1555
- truncated = true;
1556
- }
1557
- const stats = getRoleSnapshotStats(snapshot, refs);
1558
- return truncated ? {
1559
- snapshot,
1560
- truncated,
1561
- refs,
1562
- stats
1563
- } : {
1564
- snapshot,
1565
- refs,
1566
- stats
1567
- };
1568
- }
1569
- //#endregion
1570
- //#region extensions/browser/src/browser/screenshot.ts
1571
- const DEFAULT_BROWSER_SCREENSHOT_MAX_SIDE = 2e3;
1572
- const DEFAULT_BROWSER_SCREENSHOT_MAX_BYTES = 5 * 1024 * 1024;
1573
- async function normalizeBrowserScreenshot(buffer, opts) {
1574
- const maxSide = Math.max(1, Math.round(opts?.maxSide ?? 2e3));
1575
- const maxBytes = Math.max(1, Math.round(opts?.maxBytes ?? 5242880));
1576
- const meta = await getImageMetadata(buffer);
1577
- const width = meta?.width ?? 0;
1578
- const height = meta?.height ?? 0;
1579
- const maxDim = Math.max(width, height);
1580
- if (buffer.byteLength <= maxBytes && (maxDim === 0 || width <= maxSide && height <= maxSide)) return { buffer };
1581
- const sideGrid = buildImageResizeSideGrid(maxSide, maxDim > 0 ? Math.min(maxSide, maxDim) : maxSide);
1582
- let smallest = null;
1583
- for (const side of sideGrid) for (const quality of IMAGE_REDUCE_QUALITY_STEPS) {
1584
- const out = await resizeToJpeg({
1585
- buffer,
1586
- maxSide: side,
1587
- quality,
1588
- withoutEnlargement: true
1589
- });
1590
- if (!smallest || out.byteLength < smallest.size) smallest = {
1591
- buffer: out,
1592
- size: out.byteLength
1593
- };
1594
- if (out.byteLength <= maxBytes) return {
1595
- buffer: out,
1596
- contentType: "image/jpeg"
1597
- };
1598
- }
1599
- const best = smallest?.buffer ?? buffer;
1600
- throw new Error(`Browser screenshot could not be reduced below ${(maxBytes / (1024 * 1024)).toFixed(0)}MB (got ${(best.byteLength / (1024 * 1024)).toFixed(2)}MB)`);
1601
- }
1602
- //#endregion
1603
- //#region extensions/browser/src/browser/routes/agent.snapshot-target.ts
1604
- /** Resolve the correct targetId after a navigation that may trigger a renderer swap. */
1605
- async function resolveTargetIdAfterNavigate(opts) {
1606
- let currentTargetId = opts.oldTargetId;
1607
- try {
1608
- const pickReplacement = (tabs, options) => {
1609
- if (tabs.some((tab) => tab.targetId === opts.oldTargetId)) return {
1610
- targetId: opts.oldTargetId,
1611
- shouldRetry: false
1612
- };
1613
- const byUrl = tabs.filter((tab) => tab.url === opts.navigatedUrl);
1614
- if (byUrl.length === 1) return {
1615
- targetId: byUrl[0]?.targetId ?? opts.oldTargetId,
1616
- shouldRetry: false
1617
- };
1618
- const uniqueReplacement = byUrl.filter((tab) => tab.targetId !== opts.oldTargetId);
1619
- if (uniqueReplacement.length === 1) return {
1620
- targetId: uniqueReplacement[0]?.targetId ?? opts.oldTargetId,
1621
- shouldRetry: false
1622
- };
1623
- if (options?.allowSingleTabFallback && tabs.length === 1) return {
1624
- targetId: tabs[0]?.targetId ?? opts.oldTargetId,
1625
- shouldRetry: false
1626
- };
1627
- return {
1628
- targetId: opts.oldTargetId,
1629
- shouldRetry: true
1630
- };
1631
- };
1632
- const first = pickReplacement(await opts.listTabs());
1633
- currentTargetId = first.targetId;
1634
- if (first.shouldRetry) {
1635
- await new Promise((r) => setTimeout(r, opts.retryDelayMs ?? 800));
1636
- currentTargetId = pickReplacement(await opts.listTabs(), { allowSingleTabFallback: true }).targetId;
1637
- }
1638
- } catch {}
1639
- return currentTargetId;
1640
- }
1641
- //#endregion
1642
- //#region extensions/browser/src/browser/routes/agent.snapshot.plan.ts
1643
- function readStringValue$1(value) {
1644
- return typeof value === "string" ? value : void 0;
1645
- }
1646
- function normalizeOptionalString$1(value) {
1647
- return readStringValue$1(value)?.trim() || void 0;
1648
- }
1649
- function resolveSnapshotPlan(params) {
1650
- const mode = params.query.mode === "efficient" ? "efficient" : void 0;
1651
- const labels = toBoolean(params.query.labels) ?? void 0;
1652
- const urls = toBoolean(params.query.urls) ?? void 0;
1653
- const explicitFormat = params.query.format === "aria" ? "aria" : params.query.format === "ai" ? "ai" : void 0;
1654
- const format = resolveDefaultSnapshotFormat({
1655
- profile: params.profile,
1656
- hasPlaywright: params.hasPlaywright,
1657
- explicitFormat,
1658
- mode
1659
- });
1660
- const limitRaw = readStringValue$1(params.query.limit);
1661
- const hasMaxChars = Object.hasOwn(params.query, "maxChars");
1662
- const maxCharsRaw = readStringValue$1(params.query.maxChars);
1663
- const limit = Number.isFinite(Number(limitRaw)) ? Number(limitRaw) : void 0;
1664
- const maxChars = Number.isFinite(Number(maxCharsRaw)) && Number(maxCharsRaw) > 0 ? Math.floor(Number(maxCharsRaw)) : void 0;
1665
- const resolvedMaxChars = format === "ai" ? hasMaxChars ? maxChars : mode === "efficient" ? DEFAULT_AI_SNAPSHOT_EFFICIENT_MAX_CHARS : DEFAULT_AI_SNAPSHOT_MAX_CHARS : void 0;
1666
- const interactiveRaw = toBoolean(params.query.interactive);
1667
- const compactRaw = toBoolean(params.query.compact);
1668
- const depthRaw = toNumber(params.query.depth);
1669
- const refsModeRaw = toStringOrEmpty(params.query.refs).trim();
1670
- const refsMode = refsModeRaw === "aria" ? "aria" : refsModeRaw === "role" ? "role" : void 0;
1671
- const interactive = interactiveRaw ?? (mode === "efficient" ? true : void 0);
1672
- const compact = compactRaw ?? (mode === "efficient" ? true : void 0);
1673
- const depth = depthRaw ?? (mode === "efficient" ? 6 : void 0);
1674
- const selectorValue = normalizeOptionalString$1(toStringOrEmpty(params.query.selector));
1675
- const frameSelectorValue = normalizeOptionalString$1(toStringOrEmpty(params.query.frame));
1676
- return {
1677
- format,
1678
- mode,
1679
- labels,
1680
- urls,
1681
- limit,
1682
- resolvedMaxChars,
1683
- interactive,
1684
- compact,
1685
- depth,
1686
- refsMode,
1687
- selectorValue,
1688
- frameSelectorValue,
1689
- wantsRoleSnapshot: labels === true || urls === true || mode === "efficient" || interactive === true || compact === true || depth !== void 0 || Boolean(selectorValue) || Boolean(frameSelectorValue)
1690
- };
1691
- }
1692
- //#endregion
1693
- //#region extensions/browser/src/browser/routes/agent.snapshot.ts
1694
- const CHROME_MCP_OVERLAY_ATTR = "data-genesis-mcp-overlay";
1695
- function browserNavigationPolicyForProfile$1(ctx, profileCtx) {
1696
- return withBrowserNavigationPolicy(ctx.state().resolved.ssrfPolicy, { browserProxyMode: resolveBrowserNavigationProxyMode({
1697
- resolved: ctx.state().resolved,
1698
- profile: profileCtx.profile
1699
- }) });
1700
- }
1701
- async function collectChromeMcpSnapshotUrls(params) {
1702
- const result = await evaluateChromeMcpScript({
1703
- profileName: params.profileName,
1704
- userDataDir: params.userDataDir,
1705
- targetId: params.targetId,
1706
- fn: `() => {
1707
- const seen = new Set();
1708
- const out = [];
1709
- for (const anchor of Array.from(document.querySelectorAll("a[href]"))) {
1710
- const href = anchor.href || "";
1711
- if (!href || seen.has(href)) continue;
1712
- const text = (anchor.innerText || anchor.textContent || anchor.getAttribute("aria-label") || "")
1713
- .replace(/\\s+/g, " ")
1714
- .trim()
1715
- .slice(0, 120) || href;
1716
- seen.add(href);
1717
- out.push({ text, url: href });
1718
- if (out.length >= 100) break;
1719
- }
1720
- return out;
1721
- }`
1722
- }).catch(() => []);
1723
- return Array.isArray(result) ? result.filter((entry) => entry && typeof entry === "object" && typeof entry.text === "string" && typeof entry.url === "string") : [];
1724
- }
1725
- function appendSnapshotUrls(snapshot, urls) {
1726
- if (urls.length === 0) return snapshot;
1727
- return `${snapshot}\n\nLinks:\n${urls.map((entry, index) => `${index + 1}. ${entry.text} -> ${entry.url}`).join("\n")}`;
1728
- }
1729
- async function clearChromeMcpOverlay(params) {
1730
- await evaluateChromeMcpScript({
1731
- profileName: params.profileName,
1732
- userDataDir: params.userDataDir,
1733
- targetId: params.targetId,
1734
- fn: `() => {
1735
- document.querySelectorAll("[${CHROME_MCP_OVERLAY_ATTR}]").forEach((node) => node.remove());
1736
- return true;
1737
- }`
1738
- }).catch(() => {});
1739
- }
1740
- async function renderChromeMcpLabels(params) {
1741
- const refList = JSON.stringify(params.refs);
1742
- const result = await evaluateChromeMcpScript({
1743
- profileName: params.profileName,
1744
- userDataDir: params.userDataDir,
1745
- targetId: params.targetId,
1746
- args: params.refs,
1747
- fn: `(...elements) => {
1748
- const refs = ${refList};
1749
- document.querySelectorAll("[${CHROME_MCP_OVERLAY_ATTR}]").forEach((node) => node.remove());
1750
- const root = document.createElement("div");
1751
- root.setAttribute("${CHROME_MCP_OVERLAY_ATTR}", "labels");
1752
- root.style.position = "fixed";
1753
- root.style.inset = "0";
1754
- root.style.pointerEvents = "none";
1755
- root.style.zIndex = "2147483647";
1756
- let labels = 0;
1757
- let skipped = 0;
1758
- elements.forEach((el, index) => {
1759
- if (!(el instanceof Element)) {
1760
- skipped += 1;
1761
- return;
1762
- }
1763
- const rect = el.getBoundingClientRect();
1764
- if (rect.width <= 0 && rect.height <= 0) {
1765
- skipped += 1;
1766
- return;
1767
- }
1768
- labels += 1;
1769
- const badge = document.createElement("div");
1770
- badge.setAttribute("${CHROME_MCP_OVERLAY_ATTR}", "label");
1771
- badge.textContent = refs[index] || String(labels);
1772
- badge.style.position = "fixed";
1773
- badge.style.left = \`\${Math.max(0, rect.left)}px\`;
1774
- badge.style.top = \`\${Math.max(0, rect.top)}px\`;
1775
- badge.style.transform = "translateY(-100%)";
1776
- badge.style.padding = "2px 6px";
1777
- badge.style.borderRadius = "999px";
1778
- badge.style.background = "#FF4500";
1779
- badge.style.color = "#fff";
1780
- badge.style.font = "600 12px ui-monospace, SFMono-Regular, Menlo, monospace";
1781
- badge.style.boxShadow = "0 2px 6px rgba(0,0,0,0.35)";
1782
- badge.style.whiteSpace = "nowrap";
1783
- root.appendChild(badge);
1784
- });
1785
- document.documentElement.appendChild(root);
1786
- return { labels, skipped };
1787
- }`
1788
- });
1789
- return {
1790
- labels: result && typeof result === "object" && typeof result.labels === "number" ? result.labels : 0,
1791
- skipped: result && typeof result === "object" && typeof result.skipped === "number" ? result.skipped : 0
1792
- };
1793
- }
1794
- async function saveNormalizedScreenshotResponse(params) {
1795
- const normalized = await normalizeBrowserScreenshot(params.buffer, {
1796
- maxSide: DEFAULT_BROWSER_SCREENSHOT_MAX_SIDE,
1797
- maxBytes: DEFAULT_BROWSER_SCREENSHOT_MAX_BYTES
1798
- });
1799
- await saveBrowserMediaResponse({
1800
- res: params.res,
1801
- buffer: normalized.buffer,
1802
- contentType: normalized.contentType ?? `image/${params.type}`,
1803
- maxBytes: DEFAULT_BROWSER_SCREENSHOT_MAX_BYTES,
1804
- targetId: params.targetId,
1805
- url: params.url,
1806
- labels: params.labels,
1807
- labelsCount: params.labelsCount,
1808
- labelsSkipped: params.labelsSkipped
1809
- });
1810
- }
1811
- async function saveBrowserMediaResponse(params) {
1812
- await ensureMediaDir();
1813
- const saved = await saveMediaBuffer(params.buffer, params.contentType, "browser", params.maxBytes);
1814
- params.res.json({
1815
- ok: true,
1816
- path: path.resolve(saved.path),
1817
- targetId: params.targetId,
1818
- url: params.url,
1819
- ...params.labels ? { labels: true } : {},
1820
- ...typeof params.labelsCount === "number" ? { labelsCount: params.labelsCount } : {},
1821
- ...typeof params.labelsSkipped === "number" ? { labelsSkipped: params.labelsSkipped } : {}
1822
- });
1823
- }
1824
- function registerBrowserAgentSnapshotRoutes(app, ctx) {
1825
- app.post("/navigate", asyncBrowserRoute(async (req, res) => {
1826
- const body = readBody(req);
1827
- const url = toStringOrEmpty(body.url);
1828
- const targetId = toStringOrEmpty(body.targetId) || void 0;
1829
- if (!url) return jsonError(res, 400, "url is required");
1830
- await withRouteTabContext({
1831
- req,
1832
- res,
1833
- ctx,
1834
- targetId,
1835
- run: async ({ profileCtx, tab, cdpUrl }) => {
1836
- if (getBrowserProfileCapabilities(profileCtx.profile).usesChromeMcp) {
1837
- const ssrfPolicyOpts = browserNavigationPolicyForProfile$1(ctx, profileCtx);
1838
- await assertBrowserNavigationAllowed({
1839
- url,
1840
- ...ssrfPolicyOpts
1841
- });
1842
- const result = await navigateChromeMcpPage({
1843
- profileName: profileCtx.profile.name,
1844
- userDataDir: profileCtx.profile.userDataDir,
1845
- targetId: tab.targetId,
1846
- url
1847
- });
1848
- await assertBrowserNavigationResultAllowed({
1849
- url: result.url,
1850
- ...ssrfPolicyOpts
1851
- });
1852
- return res.json({
1853
- ok: true,
1854
- targetId: tab.targetId,
1855
- ...result
1856
- });
1857
- }
1858
- const pw = await requirePwAi(res, "navigate");
1859
- if (!pw) return;
1860
- const result = await pw.navigateViaPlaywright({
1861
- cdpUrl,
1862
- targetId: tab.targetId,
1863
- url,
1864
- ...browserNavigationPolicyForProfile$1(ctx, profileCtx)
1865
- });
1866
- const currentTargetId = await resolveTargetIdAfterNavigate({
1867
- oldTargetId: tab.targetId,
1868
- navigatedUrl: result.url,
1869
- listTabs: () => profileCtx.listTabs()
1870
- });
1871
- res.json({
1872
- ok: true,
1873
- targetId: currentTargetId,
1874
- ...result
1875
- });
1876
- }
1877
- });
1878
- }));
1879
- app.post("/pdf", asyncBrowserRoute(async (req, res) => {
1880
- const targetId = toStringOrEmpty(readBody(req).targetId) || void 0;
1881
- const profileCtx = resolveProfileContext(req, res, ctx);
1882
- if (!profileCtx) return;
1883
- if (getBrowserProfileCapabilities(profileCtx.profile).usesChromeMcp) return jsonError(res, 501, EXISTING_SESSION_LIMITS.snapshot.pdfUnsupported);
1884
- await withPlaywrightRouteContext({
1885
- req,
1886
- res,
1887
- ctx,
1888
- targetId,
1889
- feature: "pdf",
1890
- run: async ({ cdpUrl, tab, pw }) => {
1891
- const pdf = await pw.pdfViaPlaywright({
1892
- cdpUrl,
1893
- targetId: tab.targetId
1894
- });
1895
- await saveBrowserMediaResponse({
1896
- res,
1897
- buffer: pdf.buffer,
1898
- contentType: "application/pdf",
1899
- maxBytes: pdf.buffer.byteLength,
1900
- targetId: tab.targetId,
1901
- url: tab.url
1902
- });
1903
- }
1904
- });
1905
- }));
1906
- app.post("/screenshot", asyncBrowserRoute(async (req, res) => {
1907
- const body = readBody(req);
1908
- const targetId = toStringOrEmpty(body.targetId) || void 0;
1909
- const fullPage = toBoolean(body.fullPage) ?? false;
1910
- const ref = toStringOrEmpty(body.ref) || void 0;
1911
- const element = toStringOrEmpty(body.element) || void 0;
1912
- const labels = toBoolean(body.labels) ?? false;
1913
- const type = body.type === "jpeg" ? "jpeg" : "png";
1914
- const timeoutMsRaw = toNumber(body.timeoutMs);
1915
- const timeoutMs = timeoutMsRaw !== void 0 ? Math.max(1, Math.floor(timeoutMsRaw)) : DEFAULT_BROWSER_SCREENSHOT_TIMEOUT_MS;
1916
- if (fullPage && (ref || element)) return jsonError(res, 400, "fullPage is not supported for element screenshots");
1917
- await withRouteTabContext({
1918
- req,
1919
- res,
1920
- ctx,
1921
- targetId,
1922
- run: async ({ profileCtx, tab, cdpUrl }) => {
1923
- if (getBrowserProfileCapabilities(profileCtx.profile).usesChromeMcp) {
1924
- const ssrfPolicyOpts = browserNavigationPolicyForProfile$1(ctx, profileCtx);
1925
- if (element) return jsonError(res, 400, EXISTING_SESSION_LIMITS.snapshot.screenshotElement);
1926
- if (ssrfPolicyOpts.ssrfPolicy) await assertBrowserNavigationResultAllowed({
1927
- url: tab.url,
1928
- ...ssrfPolicyOpts
1929
- });
1930
- if (labels) {
1931
- const built = buildAiSnapshotFromChromeMcpSnapshot({ root: await takeChromeMcpSnapshot({
1932
- profileName: profileCtx.profile.name,
1933
- userDataDir: profileCtx.profile.userDataDir,
1934
- targetId: tab.targetId
1935
- }) });
1936
- const labelResult = await renderChromeMcpLabels({
1937
- profileName: profileCtx.profile.name,
1938
- userDataDir: profileCtx.profile.userDataDir,
1939
- targetId: tab.targetId,
1940
- refs: Object.keys(built.refs)
1941
- });
1942
- try {
1943
- await saveNormalizedScreenshotResponse({
1944
- res,
1945
- buffer: await takeChromeMcpScreenshot({
1946
- profileName: profileCtx.profile.name,
1947
- userDataDir: profileCtx.profile.userDataDir,
1948
- targetId: tab.targetId,
1949
- fullPage,
1950
- format: type,
1951
- timeoutMs
1952
- }),
1953
- type,
1954
- targetId: tab.targetId,
1955
- url: tab.url,
1956
- labels: true,
1957
- labelsCount: labelResult.labels,
1958
- labelsSkipped: labelResult.skipped
1959
- });
1960
- } finally {
1961
- await clearChromeMcpOverlay({
1962
- profileName: profileCtx.profile.name,
1963
- userDataDir: profileCtx.profile.userDataDir,
1964
- targetId: tab.targetId
1965
- });
1966
- }
1967
- return;
1968
- }
1969
- await saveNormalizedScreenshotResponse({
1970
- res,
1971
- buffer: await takeChromeMcpScreenshot({
1972
- profileName: profileCtx.profile.name,
1973
- userDataDir: profileCtx.profile.userDataDir,
1974
- targetId: tab.targetId,
1975
- uid: ref,
1976
- fullPage,
1977
- format: type,
1978
- timeoutMs
1979
- }),
1980
- type,
1981
- targetId: tab.targetId,
1982
- url: tab.url
1983
- });
1984
- return;
1985
- }
1986
- let buffer;
1987
- if (labels || shouldUsePlaywrightForScreenshot({
1988
- profile: profileCtx.profile,
1989
- wsUrl: tab.wsUrl,
1990
- ref,
1991
- element
1992
- })) {
1993
- const pw = await requirePwAi(res, "screenshot");
1994
- if (!pw) return;
1995
- if (labels) {
1996
- const snap = await pw.snapshotRoleViaPlaywright({
1997
- cdpUrl,
1998
- targetId: tab.targetId,
1999
- ssrfPolicy: ctx.state().resolved.ssrfPolicy
2000
- });
2001
- const labeled = await pw.screenshotWithLabelsViaPlaywright({
2002
- cdpUrl,
2003
- targetId: tab.targetId,
2004
- refs: snap.refs,
2005
- type,
2006
- timeoutMs
2007
- });
2008
- await saveNormalizedScreenshotResponse({
2009
- res,
2010
- buffer: labeled.buffer,
2011
- type,
2012
- targetId: tab.targetId,
2013
- url: tab.url,
2014
- labels: true,
2015
- labelsCount: labeled.labels,
2016
- labelsSkipped: labeled.skipped
2017
- });
2018
- return;
2019
- }
2020
- buffer = (await pw.takeScreenshotViaPlaywright({
2021
- cdpUrl,
2022
- targetId: tab.targetId,
2023
- ref,
2024
- element,
2025
- fullPage,
2026
- type,
2027
- timeoutMs
2028
- })).buffer;
2029
- } else buffer = await captureScreenshot({
2030
- wsUrl: tab.wsUrl ?? "",
2031
- fullPage,
2032
- format: type,
2033
- quality: type === "jpeg" ? 85 : void 0,
2034
- timeoutMs
2035
- });
2036
- await saveNormalizedScreenshotResponse({
2037
- res,
2038
- buffer,
2039
- type,
2040
- targetId: tab.targetId,
2041
- url: tab.url
2042
- });
2043
- }
2044
- });
2045
- }));
2046
- app.get("/snapshot", asyncBrowserRoute(async (req, res) => {
2047
- const profileCtx = resolveProfileContext(req, res, ctx);
2048
- if (!profileCtx) return;
2049
- const targetId = typeof req.query.targetId === "string" ? req.query.targetId.trim() : "";
2050
- const hasPlaywright = Boolean(await getPwAiModule());
2051
- const plan = resolveSnapshotPlan({
2052
- profile: profileCtx.profile,
2053
- query: req.query,
2054
- hasPlaywright
2055
- });
2056
- try {
2057
- const tab = await profileCtx.ensureTabAvailable(targetId || void 0);
2058
- if ((plan.labels || plan.mode === "efficient") && plan.format === "aria") return jsonError(res, 400, "labels/mode=efficient require format=ai");
2059
- if (getBrowserProfileCapabilities(profileCtx.profile).usesChromeMcp) {
2060
- const ssrfPolicyOpts = browserNavigationPolicyForProfile$1(ctx, profileCtx);
2061
- if (plan.selectorValue || plan.frameSelectorValue) return jsonError(res, 400, EXISTING_SESSION_LIMITS.snapshot.snapshotSelector);
2062
- if (ssrfPolicyOpts.ssrfPolicy) await assertBrowserNavigationResultAllowed({
2063
- url: tab.url,
2064
- ...ssrfPolicyOpts
2065
- });
2066
- const snapshot = await takeChromeMcpSnapshot({
2067
- profileName: profileCtx.profile.name,
2068
- userDataDir: profileCtx.profile.userDataDir,
2069
- targetId: tab.targetId
2070
- });
2071
- if (plan.format === "aria") return res.json({
2072
- ok: true,
2073
- format: "aria",
2074
- targetId: tab.targetId,
2075
- url: tab.url,
2076
- nodes: flattenChromeMcpSnapshotToAriaNodes(snapshot, plan.limit)
2077
- });
2078
- const built = buildAiSnapshotFromChromeMcpSnapshot({
2079
- root: snapshot,
2080
- options: {
2081
- interactive: plan.interactive ?? void 0,
2082
- compact: plan.compact ?? void 0,
2083
- maxDepth: plan.depth ?? void 0
2084
- },
2085
- maxChars: plan.resolvedMaxChars
2086
- });
2087
- const builtWithUrls = plan.urls ? {
2088
- ...built,
2089
- snapshot: appendSnapshotUrls(built.snapshot, await collectChromeMcpSnapshotUrls({
2090
- profileName: profileCtx.profile.name,
2091
- userDataDir: profileCtx.profile.userDataDir,
2092
- targetId: tab.targetId
2093
- }))
2094
- } : built;
2095
- if (plan.labels) {
2096
- const refs = Object.keys(builtWithUrls.refs);
2097
- const labelResult = await renderChromeMcpLabels({
2098
- profileName: profileCtx.profile.name,
2099
- userDataDir: profileCtx.profile.userDataDir,
2100
- targetId: tab.targetId,
2101
- refs
2102
- });
2103
- try {
2104
- const normalized = await normalizeBrowserScreenshot(await takeChromeMcpScreenshot({
2105
- profileName: profileCtx.profile.name,
2106
- userDataDir: profileCtx.profile.userDataDir,
2107
- targetId: tab.targetId,
2108
- format: "png"
2109
- }), {
2110
- maxSide: DEFAULT_BROWSER_SCREENSHOT_MAX_SIDE,
2111
- maxBytes: DEFAULT_BROWSER_SCREENSHOT_MAX_BYTES
2112
- });
2113
- await ensureMediaDir();
2114
- const saved = await saveMediaBuffer(normalized.buffer, normalized.contentType ?? "image/png", "browser", DEFAULT_BROWSER_SCREENSHOT_MAX_BYTES);
2115
- return res.json({
2116
- ok: true,
2117
- format: "ai",
2118
- targetId: tab.targetId,
2119
- url: tab.url,
2120
- labels: true,
2121
- labelsCount: labelResult.labels,
2122
- labelsSkipped: labelResult.skipped,
2123
- imagePath: path.resolve(saved.path),
2124
- imageType: normalized.contentType?.includes("jpeg") ? "jpeg" : "png",
2125
- ...builtWithUrls
2126
- });
2127
- } finally {
2128
- await clearChromeMcpOverlay({
2129
- profileName: profileCtx.profile.name,
2130
- userDataDir: profileCtx.profile.userDataDir,
2131
- targetId: tab.targetId
2132
- });
2133
- }
2134
- }
2135
- return res.json({
2136
- ok: true,
2137
- format: "ai",
2138
- targetId: tab.targetId,
2139
- url: tab.url,
2140
- ...builtWithUrls
2141
- });
2142
- }
2143
- if (plan.format === "ai") {
2144
- const pw = await requirePwAi(res, "ai snapshot");
2145
- if (!pw) return;
2146
- const roleSnapshotArgs = {
2147
- cdpUrl: profileCtx.profile.cdpUrl,
2148
- targetId: tab.targetId,
2149
- selector: plan.selectorValue,
2150
- frameSelector: plan.frameSelectorValue,
2151
- refsMode: plan.refsMode,
2152
- ssrfPolicy: ctx.state().resolved.ssrfPolicy,
2153
- urls: plan.urls,
2154
- options: {
2155
- interactive: plan.interactive ?? void 0,
2156
- compact: plan.compact ?? void 0,
2157
- maxDepth: plan.depth ?? void 0
2158
- }
2159
- };
2160
- const snap = plan.wantsRoleSnapshot ? await pw.snapshotRoleViaPlaywright(roleSnapshotArgs) : await pw.snapshotAiViaPlaywright({
2161
- cdpUrl: profileCtx.profile.cdpUrl,
2162
- targetId: tab.targetId,
2163
- ssrfPolicy: ctx.state().resolved.ssrfPolicy,
2164
- urls: plan.urls,
2165
- ...typeof plan.resolvedMaxChars === "number" ? { maxChars: plan.resolvedMaxChars } : {}
2166
- });
2167
- if (plan.labels) {
2168
- const labeled = await pw.screenshotWithLabelsViaPlaywright({
2169
- cdpUrl: profileCtx.profile.cdpUrl,
2170
- targetId: tab.targetId,
2171
- refs: "refs" in snap ? snap.refs : {},
2172
- type: "png"
2173
- });
2174
- const normalized = await normalizeBrowserScreenshot(labeled.buffer, {
2175
- maxSide: DEFAULT_BROWSER_SCREENSHOT_MAX_SIDE,
2176
- maxBytes: DEFAULT_BROWSER_SCREENSHOT_MAX_BYTES
2177
- });
2178
- await ensureMediaDir();
2179
- const saved = await saveMediaBuffer(normalized.buffer, normalized.contentType ?? "image/png", "browser", DEFAULT_BROWSER_SCREENSHOT_MAX_BYTES);
2180
- const imageType = normalized.contentType?.includes("jpeg") ? "jpeg" : "png";
2181
- return res.json({
2182
- ok: true,
2183
- format: plan.format,
2184
- targetId: tab.targetId,
2185
- url: tab.url,
2186
- labels: true,
2187
- labelsCount: labeled.labels,
2188
- labelsSkipped: labeled.skipped,
2189
- imagePath: path.resolve(saved.path),
2190
- imageType,
2191
- ...snap
2192
- });
2193
- }
2194
- return res.json({
2195
- ok: true,
2196
- format: plan.format,
2197
- targetId: tab.targetId,
2198
- url: tab.url,
2199
- ...snap
2200
- });
2201
- }
2202
- const snap = shouldUsePlaywrightForAriaSnapshot({
2203
- profile: profileCtx.profile,
2204
- wsUrl: tab.wsUrl
2205
- }) ? requirePwAi(res, "aria snapshot").then(async (pw) => {
2206
- if (!pw) return null;
2207
- return await pw.snapshotAriaViaPlaywright({
2208
- cdpUrl: profileCtx.profile.cdpUrl,
2209
- targetId: tab.targetId,
2210
- limit: plan.limit,
2211
- ssrfPolicy: ctx.state().resolved.ssrfPolicy
2212
- });
2213
- }) : snapshotAria({
2214
- wsUrl: tab.wsUrl ?? "",
2215
- limit: plan.limit
2216
- });
2217
- const resolved = await Promise.resolve(snap);
2218
- if (!resolved) return;
2219
- return res.json({
2220
- ok: true,
2221
- format: plan.format,
2222
- targetId: tab.targetId,
2223
- url: tab.url,
2224
- ...resolved
2225
- });
2226
- } catch (err) {
2227
- handleRouteError(ctx, res, err);
2228
- }
2229
- }));
2230
- }
2231
- //#endregion
2232
- //#region extensions/browser/src/browser/routes/agent.storage.ts
2233
- function readStringValue(value) {
2234
- return typeof value === "string" ? value : void 0;
2235
- }
2236
- function normalizeOptionalString(value) {
2237
- return readStringValue(value)?.trim() || void 0;
2238
- }
2239
- function parseStorageKind(raw) {
2240
- if (raw === "local" || raw === "session") return raw;
2241
- return null;
2242
- }
2243
- function parseStorageMutationRequest(kindParam, body) {
2244
- return {
2245
- kind: parseStorageKind(toStringOrEmpty(kindParam)),
2246
- targetId: resolveTargetIdFromBody(body)
2247
- };
2248
- }
2249
- function parseRequiredStorageMutationRequest(kindParam, body) {
2250
- const parsed = parseStorageMutationRequest(kindParam, body);
2251
- if (!parsed.kind) return null;
2252
- return {
2253
- kind: parsed.kind,
2254
- targetId: parsed.targetId
2255
- };
2256
- }
2257
- function parseStorageMutationOrRespond(res, kindParam, body) {
2258
- const parsed = parseRequiredStorageMutationRequest(kindParam, body);
2259
- if (!parsed) {
2260
- jsonError(res, 400, "kind must be local|session");
2261
- return null;
2262
- }
2263
- return parsed;
2264
- }
2265
- function parseStorageMutationFromRequest(req, res) {
2266
- const body = readBody(req);
2267
- const parsed = parseStorageMutationOrRespond(res, req.params.kind, body);
2268
- if (!parsed) return null;
2269
- return {
2270
- body,
2271
- parsed
2272
- };
2273
- }
2274
- function registerBrowserAgentStorageRoutes(app, ctx) {
2275
- app.get("/cookies", asyncBrowserRoute(async (req, res) => {
2276
- await withPlaywrightRouteContext({
2277
- req,
2278
- res,
2279
- ctx,
2280
- targetId: resolveTargetIdFromQuery(req.query),
2281
- feature: "cookies",
2282
- run: async ({ cdpUrl, tab, pw }) => {
2283
- const result = await pw.cookiesGetViaPlaywright({
2284
- cdpUrl,
2285
- targetId: tab.targetId
2286
- });
2287
- res.json({
2288
- ok: true,
2289
- targetId: tab.targetId,
2290
- ...result
2291
- });
2292
- }
2293
- });
2294
- }));
2295
- app.post("/cookies/set", asyncBrowserRoute(async (req, res) => {
2296
- const body = readBody(req);
2297
- const targetId = resolveTargetIdFromBody(body);
2298
- const cookie = body.cookie && typeof body.cookie === "object" && !Array.isArray(body.cookie) ? body.cookie : null;
2299
- if (!cookie) return jsonError(res, 400, "cookie is required");
2300
- await withPlaywrightRouteContext({
2301
- req,
2302
- res,
2303
- ctx,
2304
- targetId,
2305
- feature: "cookies set",
2306
- run: async ({ cdpUrl, tab, pw }) => {
2307
- await pw.cookiesSetViaPlaywright({
2308
- cdpUrl,
2309
- targetId: tab.targetId,
2310
- cookie: {
2311
- name: toStringOrEmpty(cookie.name),
2312
- value: toStringOrEmpty(cookie.value),
2313
- url: toStringOrEmpty(cookie.url) || void 0,
2314
- domain: toStringOrEmpty(cookie.domain) || void 0,
2315
- path: toStringOrEmpty(cookie.path) || void 0,
2316
- expires: toNumber(cookie.expires) ?? void 0,
2317
- httpOnly: toBoolean(cookie.httpOnly) ?? void 0,
2318
- secure: toBoolean(cookie.secure) ?? void 0,
2319
- sameSite: cookie.sameSite === "Lax" || cookie.sameSite === "None" || cookie.sameSite === "Strict" ? cookie.sameSite : void 0
2320
- }
2321
- });
2322
- res.json({
2323
- ok: true,
2324
- targetId: tab.targetId
2325
- });
2326
- }
2327
- });
2328
- }));
2329
- app.post("/cookies/clear", asyncBrowserRoute(async (req, res) => {
2330
- await withPlaywrightRouteContext({
2331
- req,
2332
- res,
2333
- ctx,
2334
- targetId: resolveTargetIdFromBody(readBody(req)),
2335
- feature: "cookies clear",
2336
- run: async ({ cdpUrl, tab, pw }) => {
2337
- await pw.cookiesClearViaPlaywright({
2338
- cdpUrl,
2339
- targetId: tab.targetId
2340
- });
2341
- res.json({
2342
- ok: true,
2343
- targetId: tab.targetId
2344
- });
2345
- }
2346
- });
2347
- }));
2348
- app.get("/storage/:kind", asyncBrowserRoute(async (req, res) => {
2349
- const kind = parseStorageKind(toStringOrEmpty(req.params.kind));
2350
- if (!kind) return jsonError(res, 400, "kind must be local|session");
2351
- const targetId = resolveTargetIdFromQuery(req.query);
2352
- const key = toStringOrEmpty(req.query.key);
2353
- await withPlaywrightRouteContext({
2354
- req,
2355
- res,
2356
- ctx,
2357
- targetId,
2358
- feature: "storage get",
2359
- run: async ({ cdpUrl, tab, pw }) => {
2360
- const result = await pw.storageGetViaPlaywright({
2361
- cdpUrl,
2362
- targetId: tab.targetId,
2363
- kind,
2364
- key: normalizeOptionalString(key)
2365
- });
2366
- res.json({
2367
- ok: true,
2368
- targetId: tab.targetId,
2369
- ...result
2370
- });
2371
- }
2372
- });
2373
- }));
2374
- app.post("/storage/:kind/set", asyncBrowserRoute(async (req, res) => {
2375
- const mutation = parseStorageMutationFromRequest(req, res);
2376
- if (!mutation) return;
2377
- const key = toStringOrEmpty(mutation.body.key);
2378
- if (!key) return jsonError(res, 400, "key is required");
2379
- const value = typeof mutation.body.value === "string" ? mutation.body.value : "";
2380
- await withPlaywrightRouteContext({
2381
- req,
2382
- res,
2383
- ctx,
2384
- targetId: mutation.parsed.targetId,
2385
- feature: "storage set",
2386
- run: async ({ cdpUrl, tab, pw }) => {
2387
- await pw.storageSetViaPlaywright({
2388
- cdpUrl,
2389
- targetId: tab.targetId,
2390
- kind: mutation.parsed.kind,
2391
- key,
2392
- value
2393
- });
2394
- res.json({
2395
- ok: true,
2396
- targetId: tab.targetId
2397
- });
2398
- }
2399
- });
2400
- }));
2401
- app.post("/storage/:kind/clear", asyncBrowserRoute(async (req, res) => {
2402
- const mutation = parseStorageMutationFromRequest(req, res);
2403
- if (!mutation) return;
2404
- await withPlaywrightRouteContext({
2405
- req,
2406
- res,
2407
- ctx,
2408
- targetId: mutation.parsed.targetId,
2409
- feature: "storage clear",
2410
- run: async ({ cdpUrl, tab, pw }) => {
2411
- await pw.storageClearViaPlaywright({
2412
- cdpUrl,
2413
- targetId: tab.targetId,
2414
- kind: mutation.parsed.kind
2415
- });
2416
- res.json({
2417
- ok: true,
2418
- targetId: tab.targetId
2419
- });
2420
- }
2421
- });
2422
- }));
2423
- app.post("/set/offline", asyncBrowserRoute(async (req, res) => {
2424
- const body = readBody(req);
2425
- const targetId = resolveTargetIdFromBody(body);
2426
- const offline = toBoolean(body.offline);
2427
- if (offline === void 0) return jsonError(res, 400, "offline is required");
2428
- await withPlaywrightRouteContext({
2429
- req,
2430
- res,
2431
- ctx,
2432
- targetId,
2433
- feature: "offline",
2434
- run: async ({ cdpUrl, tab, pw }) => {
2435
- await pw.setOfflineViaPlaywright({
2436
- cdpUrl,
2437
- targetId: tab.targetId,
2438
- offline
2439
- });
2440
- res.json({
2441
- ok: true,
2442
- targetId: tab.targetId
2443
- });
2444
- }
2445
- });
2446
- }));
2447
- app.post("/set/headers", asyncBrowserRoute(async (req, res) => {
2448
- const body = readBody(req);
2449
- const targetId = resolveTargetIdFromBody(body);
2450
- const headers = body.headers && typeof body.headers === "object" && !Array.isArray(body.headers) ? body.headers : null;
2451
- if (!headers) return jsonError(res, 400, "headers is required");
2452
- const parsed = {};
2453
- for (const [k, v] of Object.entries(headers)) if (typeof v === "string") parsed[k] = v;
2454
- await withPlaywrightRouteContext({
2455
- req,
2456
- res,
2457
- ctx,
2458
- targetId,
2459
- feature: "headers",
2460
- run: async ({ cdpUrl, tab, pw }) => {
2461
- await pw.setExtraHTTPHeadersViaPlaywright({
2462
- cdpUrl,
2463
- targetId: tab.targetId,
2464
- headers: parsed
2465
- });
2466
- res.json({
2467
- ok: true,
2468
- targetId: tab.targetId
2469
- });
2470
- }
2471
- });
2472
- }));
2473
- app.post("/set/credentials", asyncBrowserRoute(async (req, res) => {
2474
- const body = readBody(req);
2475
- const targetId = resolveTargetIdFromBody(body);
2476
- const clear = toBoolean(body.clear) ?? false;
2477
- const username = toStringOrEmpty(body.username) || void 0;
2478
- const password = readStringValue(body.password);
2479
- await withPlaywrightRouteContext({
2480
- req,
2481
- res,
2482
- ctx,
2483
- targetId,
2484
- feature: "http credentials",
2485
- run: async ({ cdpUrl, tab, pw }) => {
2486
- await pw.setHttpCredentialsViaPlaywright({
2487
- cdpUrl,
2488
- targetId: tab.targetId,
2489
- username,
2490
- password,
2491
- clear
2492
- });
2493
- res.json({
2494
- ok: true,
2495
- targetId: tab.targetId
2496
- });
2497
- }
2498
- });
2499
- }));
2500
- app.post("/set/geolocation", asyncBrowserRoute(async (req, res) => {
2501
- const body = readBody(req);
2502
- const targetId = resolveTargetIdFromBody(body);
2503
- const clear = toBoolean(body.clear) ?? false;
2504
- const latitude = toNumber(body.latitude);
2505
- const longitude = toNumber(body.longitude);
2506
- const accuracy = toNumber(body.accuracy) ?? void 0;
2507
- const origin = toStringOrEmpty(body.origin) || void 0;
2508
- await withPlaywrightRouteContext({
2509
- req,
2510
- res,
2511
- ctx,
2512
- targetId,
2513
- feature: "geolocation",
2514
- run: async ({ cdpUrl, tab, pw }) => {
2515
- await pw.setGeolocationViaPlaywright({
2516
- cdpUrl,
2517
- targetId: tab.targetId,
2518
- latitude,
2519
- longitude,
2520
- accuracy,
2521
- origin,
2522
- clear
2523
- });
2524
- res.json({
2525
- ok: true,
2526
- targetId: tab.targetId
2527
- });
2528
- }
2529
- });
2530
- }));
2531
- app.post("/set/media", asyncBrowserRoute(async (req, res) => {
2532
- const body = readBody(req);
2533
- const targetId = resolveTargetIdFromBody(body);
2534
- const schemeRaw = toStringOrEmpty(body.colorScheme);
2535
- const colorScheme = schemeRaw === "dark" || schemeRaw === "light" || schemeRaw === "no-preference" ? schemeRaw : schemeRaw === "none" ? null : void 0;
2536
- if (colorScheme === void 0) return jsonError(res, 400, "colorScheme must be dark|light|no-preference|none");
2537
- await withPlaywrightRouteContext({
2538
- req,
2539
- res,
2540
- ctx,
2541
- targetId,
2542
- feature: "media emulation",
2543
- run: async ({ cdpUrl, tab, pw }) => {
2544
- await pw.emulateMediaViaPlaywright({
2545
- cdpUrl,
2546
- targetId: tab.targetId,
2547
- colorScheme
2548
- });
2549
- res.json({
2550
- ok: true,
2551
- targetId: tab.targetId
2552
- });
2553
- }
2554
- });
2555
- }));
2556
- app.post("/set/timezone", asyncBrowserRoute(async (req, res) => {
2557
- const body = readBody(req);
2558
- const targetId = resolveTargetIdFromBody(body);
2559
- const timezoneId = toStringOrEmpty(body.timezoneId);
2560
- if (!timezoneId) return jsonError(res, 400, "timezoneId is required");
2561
- await withPlaywrightRouteContext({
2562
- req,
2563
- res,
2564
- ctx,
2565
- targetId,
2566
- feature: "timezone",
2567
- run: async ({ cdpUrl, tab, pw }) => {
2568
- await pw.setTimezoneViaPlaywright({
2569
- cdpUrl,
2570
- targetId: tab.targetId,
2571
- timezoneId
2572
- });
2573
- res.json({
2574
- ok: true,
2575
- targetId: tab.targetId
2576
- });
2577
- }
2578
- });
2579
- }));
2580
- app.post("/set/locale", asyncBrowserRoute(async (req, res) => {
2581
- const body = readBody(req);
2582
- const targetId = resolveTargetIdFromBody(body);
2583
- const locale = toStringOrEmpty(body.locale);
2584
- if (!locale) return jsonError(res, 400, "locale is required");
2585
- await withPlaywrightRouteContext({
2586
- req,
2587
- res,
2588
- ctx,
2589
- targetId,
2590
- feature: "locale",
2591
- run: async ({ cdpUrl, tab, pw }) => {
2592
- await pw.setLocaleViaPlaywright({
2593
- cdpUrl,
2594
- targetId: tab.targetId,
2595
- locale
2596
- });
2597
- res.json({
2598
- ok: true,
2599
- targetId: tab.targetId
2600
- });
2601
- }
2602
- });
2603
- }));
2604
- app.post("/set/device", asyncBrowserRoute(async (req, res) => {
2605
- const body = readBody(req);
2606
- const targetId = resolveTargetIdFromBody(body);
2607
- const name = toStringOrEmpty(body.name);
2608
- if (!name) return jsonError(res, 400, "name is required");
2609
- await withPlaywrightRouteContext({
2610
- req,
2611
- res,
2612
- ctx,
2613
- targetId,
2614
- feature: "device emulation",
2615
- run: async ({ cdpUrl, tab, pw }) => {
2616
- await pw.setDeviceViaPlaywright({
2617
- cdpUrl,
2618
- targetId: tab.targetId,
2619
- name
2620
- });
2621
- res.json({
2622
- ok: true,
2623
- targetId: tab.targetId
2624
- });
2625
- }
2626
- });
2627
- }));
2628
- }
2629
- //#endregion
2630
- //#region extensions/browser/src/browser/routes/agent.ts
2631
- function registerBrowserAgentRoutes(app, ctx) {
2632
- registerBrowserAgentSnapshotRoutes(app, ctx);
2633
- registerBrowserAgentActRoutes(app, ctx);
2634
- registerBrowserAgentDebugRoutes(app, ctx);
2635
- registerBrowserAgentStorageRoutes(app, ctx);
2636
- }
2637
- //#endregion
2638
- //#region extensions/browser/src/browser/doctor.ts
2639
- function buildBrowserDoctorReport(params) {
2640
- const status = params.status;
2641
- const checks = [];
2642
- const transport = status.transport === "chrome-mcp" ? "chrome-mcp" : "cdp";
2643
- checks.push({
2644
- id: "plugin-enabled",
2645
- label: "Browser plugin",
2646
- status: status.enabled ? "pass" : "fail",
2647
- summary: status.enabled ? "enabled" : "disabled",
2648
- ...status.enabled ? {} : { fixHint: "Enable the browser plugin and restart the Gateway." }
2649
- });
2650
- checks.push({
2651
- id: "profile",
2652
- label: "Profile",
2653
- status: "pass",
2654
- summary: `${status.profile ?? "genesis"} via ${transport}`
2655
- });
2656
- if (transport === "chrome-mcp") checks.push({
2657
- id: "attach-target",
2658
- label: "Existing browser attach",
2659
- status: status.running ? "pass" : "fail",
2660
- summary: status.running ? "Chrome MCP target is reachable" : "Chrome MCP target is not reachable",
2661
- ...status.running ? {} : { fixHint: "Keep the matching Chromium browser running, enable remote debugging in chrome://inspect, and accept the attach prompt." }
2662
- });
2663
- else {
2664
- checks.push({
2665
- id: "managed-executable",
2666
- label: "Chromium executable",
2667
- status: status.detectError ? "fail" : status.detectedExecutablePath ? "pass" : "warn",
2668
- summary: status.detectError ? status.detectError : status.detectedExecutablePath ? `${status.detectedBrowser ?? "chromium"} at ${status.detectedExecutablePath}` : "No Chromium executable detected",
2669
- ...status.detectedExecutablePath || status.detectError ? {} : { fixHint: "Install Chrome/Chromium/Brave/Edge or set browser.executablePath." }
2670
- });
2671
- const platform = params.platform ?? process.platform;
2672
- const env = params.env ?? process.env;
2673
- const uid = params.uid ?? process.getuid?.();
2674
- if (platform === "linux" && !status.headless && !env.DISPLAY && !env.WAYLAND_DISPLAY) checks.push({
2675
- id: "display",
2676
- label: "Display",
2677
- status: "warn",
2678
- summary: "No DISPLAY or WAYLAND_DISPLAY is set while browser.headless is false",
2679
- fixHint: "Use a desktop session, Xvfb, or set browser.headless: true."
2680
- });
2681
- if (platform === "linux" && uid === 0 && !status.noSandbox) checks.push({
2682
- id: "linux-sandbox",
2683
- label: "Linux sandbox",
2684
- status: "warn",
2685
- summary: "Gateway is running as root while browser.noSandbox is false",
2686
- fixHint: "Set browser.noSandbox: true for container/root Chromium runtimes."
2687
- });
2688
- checks.push({
2689
- id: "cdp-http",
2690
- label: "CDP HTTP",
2691
- status: status.cdpHttp ? "pass" : status.running ? "fail" : "info",
2692
- summary: status.cdpHttp ? "CDP HTTP endpoint is reachable" : status.running ? "CDP HTTP endpoint is not reachable" : "Browser is not currently running",
2693
- ...status.cdpHttp || !status.running ? {} : { fixHint: "Run genesis browser start or inspect browser.cdpUrl/CDP port reachability." }
2694
- });
2695
- checks.push({
2696
- id: "cdp-websocket",
2697
- label: "CDP WebSocket",
2698
- status: status.cdpReady ? "pass" : status.running ? "fail" : "info",
2699
- summary: status.cdpReady ? "CDP WebSocket is reachable" : status.running ? "CDP WebSocket is not reachable" : "Browser is launchable but not running",
2700
- ...status.cdpReady || !status.running ? {} : { fixHint: "Check Chrome launch logs, stale locks, proxy env, and port conflicts." }
2701
- });
2702
- }
2703
- return {
2704
- ok: checks.every((check) => check.status !== "fail"),
2705
- profile: status.profile ?? "genesis",
2706
- transport,
2707
- checks,
2708
- status
2709
- };
2710
- }
2711
- const PROFILE_NAME_REGEX = /^[a-z0-9][a-z0-9-]*$/;
2712
- function isValidProfileName(name) {
2713
- if (!name || name.length > 64) return false;
2714
- return PROFILE_NAME_REGEX.test(name);
2715
- }
2716
- function allocateCdpPort(usedPorts, range) {
2717
- const start = range?.start ?? 18800;
2718
- const end = range?.end ?? 18899;
2719
- if (!Number.isFinite(start) || !Number.isFinite(end) || start <= 0 || end <= 0) return null;
2720
- if (start > end) return null;
2721
- for (let port = start; port <= end; port++) if (!usedPorts.has(port)) return port;
2722
- return null;
2723
- }
2724
- function getUsedPorts(profiles) {
2725
- if (!profiles) return /* @__PURE__ */ new Set();
2726
- const used = /* @__PURE__ */ new Set();
2727
- for (const profile of Object.values(profiles)) {
2728
- if (typeof profile.cdpPort === "number") {
2729
- used.add(profile.cdpPort);
2730
- continue;
2731
- }
2732
- const rawUrl = profile.cdpUrl?.trim();
2733
- if (!rawUrl) continue;
2734
- try {
2735
- const parsed = new URL(rawUrl);
2736
- const port = parsed.port && Number.parseInt(parsed.port, 10) > 0 ? Number.parseInt(parsed.port, 10) : parsed.protocol === "https:" ? 443 : 80;
2737
- if (!Number.isNaN(port) && port > 0 && port <= 65535) used.add(port);
2738
- } catch {}
2739
- }
2740
- return used;
2741
- }
2742
- const PROFILE_COLORS = [
2743
- "#FF4500",
2744
- "#0066CC",
2745
- "#00AA00",
2746
- "#9933FF",
2747
- "#FF6699",
2748
- "#00CCCC",
2749
- "#FF9900",
2750
- "#6666FF",
2751
- "#CC3366",
2752
- "#339966"
2753
- ];
2754
- function allocateColor(usedColors) {
2755
- for (const color of PROFILE_COLORS) if (!usedColors.has(color.toUpperCase())) return color;
2756
- return PROFILE_COLORS[usedColors.size % PROFILE_COLORS.length] ?? PROFILE_COLORS[0];
2757
- }
2758
- function getUsedColors(profiles) {
2759
- if (!profiles) return /* @__PURE__ */ new Set();
2760
- return new Set(Object.values(profiles).map((p) => p.color.toUpperCase()));
2761
- }
2762
- //#endregion
2763
- //#region extensions/browser/src/browser/profiles-service.ts
2764
- const HEX_COLOR_RE = /^#[0-9A-Fa-f]{6}$/;
2765
- const cdpPortRange = (resolved) => {
2766
- const start = resolved.cdpPortRangeStart;
2767
- const end = resolved.cdpPortRangeEnd;
2768
- if (typeof start === "number" && Number.isFinite(start) && Number.isInteger(start) && typeof end === "number" && Number.isFinite(end) && Number.isInteger(end) && start > 0 && end >= start && end <= 65535) return {
2769
- start,
2770
- end
2771
- };
2772
- return deriveDefaultBrowserCdpPortRange(resolved.controlPort);
2773
- };
2774
- function createBrowserProfilesService(ctx) {
2775
- const listProfiles = async () => {
2776
- return await ctx.listProfiles();
2777
- };
2778
- const createProfile = async (params) => {
2779
- const name = params.name.trim();
2780
- const rawCdpUrl = normalizeOptionalString$4(params.cdpUrl);
2781
- const rawUserDataDir = normalizeOptionalString$4(params.userDataDir);
2782
- const normalizedUserDataDir = rawUserDataDir ? resolveUserPath(rawUserDataDir) : void 0;
2783
- const driver = params.driver === "existing-session" ? "existing-session" : void 0;
2784
- if (!isValidProfileName(name)) throw new BrowserValidationError("invalid profile name: use lowercase letters, numbers, and hyphens only");
2785
- const state = ctx.state();
2786
- const resolvedProfiles = state.resolved.profiles;
2787
- if (name in resolvedProfiles) throw new BrowserConflictError(`profile "${name}" already exists`);
2788
- const cfg = loadConfig();
2789
- const rawProfiles = cfg.browser?.profiles ?? {};
2790
- if (name in rawProfiles) throw new BrowserConflictError(`profile "${name}" already exists`);
2791
- const usedColors = getUsedColors(resolvedProfiles);
2792
- const profileColor = params.color && HEX_COLOR_RE.test(params.color) ? params.color : allocateColor(usedColors);
2793
- let profileConfig;
2794
- if (normalizedUserDataDir && driver !== "existing-session") throw new BrowserValidationError("driver=existing-session is required when userDataDir is provided");
2795
- if (normalizedUserDataDir && !fs.existsSync(normalizedUserDataDir)) throw new BrowserValidationError(`browser user data directory not found: ${normalizedUserDataDir}`);
2796
- if (params.tor && (rawCdpUrl || driver === "existing-session")) throw new BrowserValidationError("Tor routing is only supported for locally launched managed browser profiles");
2797
- if (rawCdpUrl) {
2798
- if (driver === "existing-session") throw new BrowserValidationError("driver=existing-session does not accept cdpUrl; it attaches via the Chrome MCP auto-connect flow");
2799
- let parsed;
2800
- try {
2801
- parsed = parseBrowserHttpUrl(rawCdpUrl, "browser.profiles.cdpUrl");
2802
- await assertCdpEndpointAllowed(parsed.normalized, state.resolved.ssrfPolicy);
2803
- } catch (err) {
2804
- throw new BrowserValidationError(formatErrorMessage(err));
2805
- }
2806
- profileConfig = {
2807
- cdpUrl: parsed.normalized,
2808
- ...driver ? { driver } : {},
2809
- color: profileColor
2810
- };
2811
- } else if (driver === "existing-session") profileConfig = {
2812
- driver,
2813
- attachOnly: true,
2814
- ...normalizedUserDataDir ? { userDataDir: normalizedUserDataDir } : {},
2815
- color: profileColor
2816
- };
2817
- else {
2818
- const cdpPort = allocateCdpPort(getUsedPorts(resolvedProfiles), cdpPortRange(state.resolved));
2819
- if (cdpPort === null) throw new BrowserResourceExhaustedError("no available CDP ports in range");
2820
- profileConfig = {
2821
- cdpPort,
2822
- ...driver ? { driver } : {},
2823
- ...params.tor ? {
2824
- headless: true,
2825
- tor: {
2826
- enabled: true,
2827
- mode: "managed"
2828
- }
2829
- } : {},
2830
- color: profileColor
2831
- };
2832
- }
2833
- await writeConfigFile({
2834
- ...cfg,
2835
- browser: {
2836
- ...cfg.browser,
2837
- profiles: {
2838
- ...rawProfiles,
2839
- [name]: profileConfig
2840
- }
2841
- }
2842
- });
2843
- state.resolved.profiles[name] = profileConfig;
2844
- const resolved = resolveProfile(state.resolved, name);
2845
- if (!resolved) throw new BrowserProfileNotFoundError(`profile "${name}" not found after creation`);
2846
- const capabilities = getBrowserProfileCapabilities(resolved);
2847
- return {
2848
- ok: true,
2849
- profile: name,
2850
- transport: capabilities.usesChromeMcp ? "chrome-mcp" : "cdp",
2851
- cdpPort: capabilities.usesChromeMcp ? null : resolved.cdpPort,
2852
- cdpUrl: capabilities.usesChromeMcp ? null : resolved.cdpUrl,
2853
- userDataDir: resolved.userDataDir ?? null,
2854
- color: resolved.color,
2855
- isRemote: !resolved.cdpIsLoopback
2856
- };
2857
- };
2858
- const deleteProfile = async (nameRaw) => {
2859
- const name = nameRaw.trim();
2860
- if (!name) throw new BrowserValidationError("profile name is required");
2861
- if (!isValidProfileName(name)) throw new BrowserValidationError("invalid profile name");
2862
- const state = ctx.state();
2863
- const cfg = loadConfig();
2864
- const profiles = cfg.browser?.profiles ?? {};
2865
- if (name === (cfg.browser?.defaultProfile ?? state.resolved.defaultProfile)) throw new BrowserValidationError(`cannot delete the default profile "${name}"; change browser.defaultProfile first`);
2866
- if (!(name in profiles)) throw new BrowserProfileNotFoundError(`profile "${name}" not found`);
2867
- let deleted = false;
2868
- const resolved = resolveProfile(state.resolved, name);
2869
- if (resolved?.cdpIsLoopback && resolved.driver === "genesis") {
2870
- try {
2871
- await ctx.forProfile(name).stopRunningBrowser();
2872
- } catch {}
2873
- const userDataDir = resolveGenesisUserDataDir(name);
2874
- const profileDir = path.dirname(userDataDir);
2875
- if (fs.existsSync(profileDir)) {
2876
- await movePathToTrash(profileDir);
2877
- deleted = true;
2878
- }
2879
- }
2880
- const { [name]: _removed, ...remainingProfiles } = profiles;
2881
- await writeConfigFile({
2882
- ...cfg,
2883
- browser: {
2884
- ...cfg.browser,
2885
- profiles: remainingProfiles
2886
- }
2887
- });
2888
- delete state.resolved.profiles[name];
2889
- state.profiles.delete(name);
2890
- return {
2891
- ok: true,
2892
- profile: name,
2893
- deleted
2894
- };
2895
- };
2896
- return {
2897
- listProfiles,
2898
- createProfile,
2899
- deleteProfile
2900
- };
2901
- }
2902
- //#endregion
2903
- //#region extensions/browser/src/browser/routes/basic.ts
2904
- function handleBrowserRouteError(res, err) {
2905
- const mapped = toBrowserErrorResponse(err);
2906
- if (mapped) return jsonError(res, mapped.status, mapped.message);
2907
- jsonError(res, 500, String(err));
2908
- }
2909
- function buildTorStatus(profileCtx, running) {
2910
- const tor = profileCtx.profile.tor;
2911
- if (!tor?.enabled) return null;
2912
- return {
2913
- enabled: true,
2914
- mode: tor.mode,
2915
- routeMode: tor.routeMode,
2916
- socksHost: tor.socksHost,
2917
- socksPort: tor.socksPort,
2918
- running
2919
- };
2920
- }
2921
- async function withBasicProfileRoute(params) {
2922
- const profileCtx = resolveProfileContext(params.req, params.res, params.ctx);
2923
- if (!profileCtx) return;
2924
- try {
2925
- await params.run(profileCtx);
2926
- } catch (err) {
2927
- return handleBrowserRouteError(params.res, err);
2928
- }
2929
- }
2930
- async function withProfilesServiceMutation(params) {
2931
- try {
2932
- const service = createBrowserProfilesService(params.ctx);
2933
- const result = await params.run(service);
2934
- params.res.json(result);
2935
- } catch (err) {
2936
- return handleBrowserRouteError(params.res, err);
2937
- }
2938
- }
2939
- async function buildBrowserStatus(req, ctx) {
2940
- let current;
2941
- try {
2942
- current = ctx.state();
2943
- } catch {
2944
- throw new BrowserError("browser server not started", 503);
2945
- }
2946
- const profileCtx = getProfileContext(req, ctx);
2947
- if ("error" in profileCtx) throw new BrowserError(profileCtx.error, profileCtx.status);
2948
- const capabilities = getBrowserProfileCapabilities(profileCtx.profile);
2949
- const [cdpHttp, cdpReady] = capabilities.usesChromeMcp ? await (async () => {
2950
- const ready = await profileCtx.isTransportAvailable(600);
2951
- return [ready, ready];
2952
- })() : await Promise.all([profileCtx.isHttpReachable(300), profileCtx.isTransportAvailable(600)]);
2953
- const profileState = current.profiles.get(profileCtx.profile.name);
2954
- let detectedBrowser = null;
2955
- let detectedExecutablePath = null;
2956
- let detectError = null;
2957
- try {
2958
- const detected = resolveBrowserExecutableForPlatform(current.resolved, process.platform);
2959
- if (detected) {
2960
- detectedBrowser = detected.kind;
2961
- detectedExecutablePath = detected.path;
2962
- }
2963
- } catch (err) {
2964
- detectError = String(err);
2965
- }
2966
- return {
2967
- enabled: current.resolved.enabled,
2968
- profile: profileCtx.profile.name,
2969
- driver: profileCtx.profile.driver,
2970
- transport: capabilities.usesChromeMcp ? "chrome-mcp" : "cdp",
2971
- running: cdpReady,
2972
- cdpReady,
2973
- cdpHttp,
2974
- pid: capabilities.usesChromeMcp ? getChromeMcpPid(profileCtx.profile.name) : profileState?.running?.pid ?? null,
2975
- cdpPort: capabilities.usesChromeMcp ? null : profileCtx.profile.cdpPort,
2976
- cdpUrl: capabilities.usesChromeMcp ? null : profileCtx.profile.cdpUrl,
2977
- chosenBrowser: profileState?.running?.exe.kind ?? null,
2978
- detectedBrowser,
2979
- detectedExecutablePath,
2980
- detectError,
2981
- userDataDir: profileState?.running?.userDataDir ?? profileCtx.profile.userDataDir ?? null,
2982
- color: profileCtx.profile.color,
2983
- headless: profileCtx.profile.headless,
2984
- noSandbox: current.resolved.noSandbox,
2985
- executablePath: profileCtx.profile.executablePath ?? null,
2986
- attachOnly: profileCtx.profile.attachOnly,
2987
- tor: buildTorStatus(profileCtx, profileState?.running?.tor ? true : null)
2988
- };
2989
- }
2990
- function registerBrowserBasicRoutes(app, ctx) {
2991
- app.get("/profiles", asyncBrowserRoute(async (_req, res) => {
2992
- try {
2993
- const profiles = await createBrowserProfilesService(ctx).listProfiles();
2994
- res.json({ profiles });
2995
- } catch (err) {
2996
- jsonError(res, 500, String(err));
2997
- }
2998
- }));
2999
- app.get("/", asyncBrowserRoute(async (req, res) => {
3000
- try {
3001
- res.json(await buildBrowserStatus(req, ctx));
3002
- } catch (err) {
3003
- const mapped = toBrowserErrorResponse(err);
3004
- if (mapped) return jsonError(res, mapped.status, mapped.message);
3005
- jsonError(res, 500, String(err));
3006
- }
3007
- }));
3008
- app.get("/doctor", asyncBrowserRoute(async (req, res) => {
3009
- try {
3010
- const status = await buildBrowserStatus(req, ctx);
3011
- res.json(buildBrowserDoctorReport({ status }));
3012
- } catch (err) {
3013
- const mapped = toBrowserErrorResponse(err);
3014
- if (mapped) return jsonError(res, mapped.status, mapped.message);
3015
- jsonError(res, 500, String(err));
3016
- }
3017
- }));
3018
- app.post("/start", asyncBrowserRoute(async (req, res) => {
3019
- await withBasicProfileRoute({
3020
- req,
3021
- res,
3022
- ctx,
3023
- run: async (profileCtx) => {
3024
- await profileCtx.ensureBrowserAvailable();
3025
- res.json({
3026
- ok: true,
3027
- profile: profileCtx.profile.name
3028
- });
3029
- }
3030
- });
3031
- }));
3032
- app.post("/stop", asyncBrowserRoute(async (req, res) => {
3033
- await withBasicProfileRoute({
3034
- req,
3035
- res,
3036
- ctx,
3037
- run: async (profileCtx) => {
3038
- const result = await profileCtx.stopRunningBrowser();
3039
- res.json({
3040
- ok: true,
3041
- stopped: result.stopped,
3042
- profile: profileCtx.profile.name
3043
- });
3044
- }
3045
- });
3046
- }));
3047
- app.post("/reset-profile", asyncBrowserRoute(async (req, res) => {
3048
- await withBasicProfileRoute({
3049
- req,
3050
- res,
3051
- ctx,
3052
- run: async (profileCtx) => {
3053
- const result = await profileCtx.resetProfile();
3054
- res.json({
3055
- ok: true,
3056
- profile: profileCtx.profile.name,
3057
- ...result
3058
- });
3059
- }
3060
- });
3061
- }));
3062
- app.post("/profiles/create", asyncBrowserRoute(async (req, res) => {
3063
- const name = toStringOrEmpty(req.body?.name);
3064
- const color = toStringOrEmpty(req.body?.color);
3065
- const cdpUrl = toStringOrEmpty(req.body?.cdpUrl);
3066
- const userDataDir = toStringOrEmpty(req.body?.userDataDir);
3067
- const driver = toStringOrEmpty(req.body?.driver);
3068
- const tor = req.body?.tor === true;
3069
- if (!name) return jsonError(res, 400, "name is required");
3070
- if (driver && driver !== "genesis" && driver !== "clawd" && driver !== "existing-session") return jsonError(res, 400, `unsupported profile driver "${driver}"; use "genesis", "clawd", or "existing-session"`);
3071
- await withProfilesServiceMutation({
3072
- res,
3073
- ctx,
3074
- run: async (service) => await service.createProfile({
3075
- name,
3076
- color: color || void 0,
3077
- cdpUrl: cdpUrl || void 0,
3078
- userDataDir: userDataDir || void 0,
3079
- tor,
3080
- driver: driver === "existing-session" ? "existing-session" : driver === "genesis" || driver === "clawd" ? "genesis" : void 0
3081
- })
3082
- });
3083
- }));
3084
- app.delete("/profiles/:name", asyncBrowserRoute(async (req, res) => {
3085
- const name = toStringOrEmpty(req.params.name);
3086
- if (!name) return jsonError(res, 400, "profile name is required");
3087
- await withProfilesServiceMutation({
3088
- res,
3089
- ctx,
3090
- run: async (service) => await service.deleteProfile(name)
3091
- });
3092
- }));
3093
- }
3094
- //#endregion
3095
- //#region extensions/browser/src/browser/routes/tabs.ts
3096
- function resolveTabsProfileContext(req, res, ctx) {
3097
- const profileCtx = getProfileContext(req, ctx);
3098
- if ("error" in profileCtx) {
3099
- jsonError(res, profileCtx.status, profileCtx.error);
3100
- return null;
3101
- }
3102
- return profileCtx;
3103
- }
3104
- function browserNavigationPolicyForProfile(ctx, profileCtx) {
3105
- return withBrowserNavigationPolicy(ctx.state().resolved.ssrfPolicy, { browserProxyMode: resolveBrowserNavigationProxyMode({
3106
- resolved: ctx.state().resolved,
3107
- profile: profileCtx.profile
3108
- }) });
3109
- }
3110
- function handleTabsRouteError(ctx, res, err, opts) {
3111
- if (opts?.mapTabError) {
3112
- const mapped = ctx.mapTabError(err);
3113
- if (mapped) return jsonError(res, mapped.status, mapped.message);
3114
- }
3115
- return jsonError(res, 500, String(err));
3116
- }
3117
- async function withTabsProfileRoute(params) {
3118
- const profileCtx = resolveTabsProfileContext(params.req, params.res, params.ctx);
3119
- if (!profileCtx) return;
3120
- try {
3121
- await params.run(profileCtx);
3122
- } catch (err) {
3123
- handleTabsRouteError(params.ctx, params.res, err, { mapTabError: params.mapTabError });
3124
- }
3125
- }
3126
- async function ensureBrowserRunning(profileCtx, res) {
3127
- if (!await profileCtx.isReachable(300)) {
3128
- jsonError(res, new BrowserProfileUnavailableError("browser not running").status, "browser not running");
3129
- return false;
3130
- }
3131
- return true;
3132
- }
3133
- async function redactBlockedTabUrls(params) {
3134
- const ssrfPolicyOpts = withBrowserNavigationPolicy(params.ssrfPolicy);
3135
- if (!ssrfPolicyOpts.ssrfPolicy) return params.tabs;
3136
- const redactedTabs = [];
3137
- for (const tab of params.tabs) try {
3138
- await assertBrowserNavigationResultAllowed({
3139
- url: tab.url,
3140
- ...ssrfPolicyOpts
3141
- });
3142
- redactedTabs.push(tab);
3143
- } catch {
3144
- redactedTabs.push({
3145
- ...tab,
3146
- url: ""
3147
- });
3148
- }
3149
- return redactedTabs;
3150
- }
3151
- function resolveIndexedTab(tabs, index) {
3152
- return typeof index === "number" ? tabs[index] : tabs.at(0);
3153
- }
3154
- function parseRequiredTargetId(res, rawTargetId) {
3155
- const targetId = toStringOrEmpty(rawTargetId);
3156
- if (!targetId) {
3157
- jsonError(res, 400, "targetId is required");
3158
- return null;
3159
- }
3160
- return targetId;
3161
- }
3162
- function readOptionalTabLabel(body) {
3163
- return toStringOrEmpty(body?.label) || void 0;
3164
- }
3165
- async function runTabTargetMutation(params) {
3166
- await withTabsProfileRoute({
3167
- req: params.req,
3168
- res: params.res,
3169
- ctx: params.ctx,
3170
- mapTabError: true,
3171
- run: async (profileCtx) => {
3172
- if (!await ensureBrowserRunning(profileCtx, params.res)) return;
3173
- await params.mutate(profileCtx, params.targetId);
3174
- params.res.json({ ok: true });
3175
- }
3176
- });
3177
- }
3178
- function registerBrowserTabRoutes(app, ctx) {
3179
- app.get("/tabs", asyncBrowserRoute(async (req, res) => {
3180
- await withTabsProfileRoute({
3181
- req,
3182
- res,
3183
- ctx,
3184
- run: async (profileCtx) => {
3185
- if (!await profileCtx.isReachable(300)) return res.json({
3186
- running: false,
3187
- tabs: []
3188
- });
3189
- const tabs = await redactBlockedTabUrls({
3190
- tabs: await profileCtx.listTabs(),
3191
- ssrfPolicy: ctx.state().resolved.ssrfPolicy
3192
- });
3193
- res.json({
3194
- running: true,
3195
- tabs
3196
- });
3197
- }
3198
- });
3199
- }));
3200
- app.post("/tabs/open", asyncBrowserRoute(async (req, res) => {
3201
- const url = toStringOrEmpty(req.body?.url);
3202
- const label = readOptionalTabLabel(req.body);
3203
- if (!url) return jsonError(res, 400, "url is required");
3204
- await withTabsProfileRoute({
3205
- req,
3206
- res,
3207
- ctx,
3208
- mapTabError: true,
3209
- run: async (profileCtx) => {
3210
- await assertBrowserNavigationAllowed({
3211
- url,
3212
- ...browserNavigationPolicyForProfile(ctx, profileCtx)
3213
- });
3214
- await profileCtx.ensureBrowserAvailable();
3215
- const tab = await profileCtx.openTab(url, { label });
3216
- res.json(tab);
3217
- }
3218
- });
3219
- }));
3220
- app.post("/tabs/focus", asyncBrowserRoute(async (req, res) => {
3221
- const targetId = parseRequiredTargetId(res, req.body?.targetId);
3222
- if (!targetId) return;
3223
- await runTabTargetMutation({
3224
- req,
3225
- res,
3226
- ctx,
3227
- targetId,
3228
- mutate: async (profileCtx, id) => {
3229
- const tabs = await profileCtx.listTabs();
3230
- const resolved = resolveTargetIdFromTabs(id, tabs);
3231
- if (!resolved.ok) {
3232
- if (resolved.reason === "ambiguous") throw new BrowserTargetAmbiguousError();
3233
- throw new BrowserTabNotFoundError({ input: id });
3234
- }
3235
- const tab = tabs.find((currentTab) => currentTab.targetId === resolved.targetId);
3236
- if (!tab) throw new BrowserTabNotFoundError({ input: id });
3237
- const ssrfPolicyOpts = browserNavigationPolicyForProfile(ctx, profileCtx);
3238
- if (ssrfPolicyOpts.ssrfPolicy) await assertBrowserNavigationResultAllowed({
3239
- url: tab.url,
3240
- ...ssrfPolicyOpts
3241
- });
3242
- await profileCtx.focusTab(resolved.targetId);
3243
- }
3244
- });
3245
- }));
3246
- app.delete("/tabs/:targetId", asyncBrowserRoute(async (req, res) => {
3247
- const targetId = parseRequiredTargetId(res, req.params.targetId);
3248
- if (!targetId) return;
3249
- await runTabTargetMutation({
3250
- req,
3251
- res,
3252
- ctx,
3253
- targetId,
3254
- mutate: async (profileCtx, id) => {
3255
- await profileCtx.closeTab(id);
3256
- }
3257
- });
3258
- }));
3259
- app.post("/tabs/action", asyncBrowserRoute(async (req, res) => {
3260
- const action = toStringOrEmpty(req.body?.action);
3261
- const index = toNumber(req.body?.index);
3262
- await withTabsProfileRoute({
3263
- req,
3264
- res,
3265
- ctx,
3266
- mapTabError: true,
3267
- run: async (profileCtx) => {
3268
- if (action === "list") {
3269
- if (!await profileCtx.isReachable(300)) return res.json({
3270
- ok: true,
3271
- tabs: []
3272
- });
3273
- const tabs = await redactBlockedTabUrls({
3274
- tabs: await profileCtx.listTabs(),
3275
- ssrfPolicy: ctx.state().resolved.ssrfPolicy
3276
- });
3277
- return res.json({
3278
- ok: true,
3279
- tabs
3280
- });
3281
- }
3282
- if (action === "new") {
3283
- await profileCtx.ensureBrowserAvailable();
3284
- const tab = await profileCtx.openTab("about:blank", { label: readOptionalTabLabel(req.body) });
3285
- return res.json({
3286
- ok: true,
3287
- tab
3288
- });
3289
- }
3290
- if (action === "label") {
3291
- if (!await ensureBrowserRunning(profileCtx, res)) return;
3292
- const targetId = parseRequiredTargetId(res, req.body?.targetId);
3293
- if (!targetId) return;
3294
- const label = readOptionalTabLabel(req.body);
3295
- if (!label) return jsonError(res, 400, "label is required");
3296
- const tab = await profileCtx.labelTab(targetId, label);
3297
- return res.json({
3298
- ok: true,
3299
- tab
3300
- });
3301
- }
3302
- if (action === "close") {
3303
- if (!await ensureBrowserRunning(profileCtx, res)) return;
3304
- const target = resolveIndexedTab(await profileCtx.listTabs(), index);
3305
- if (!target) throw new BrowserTabNotFoundError();
3306
- await profileCtx.closeTab(target.targetId);
3307
- return res.json({
3308
- ok: true,
3309
- targetId: target.targetId
3310
- });
3311
- }
3312
- if (action === "select") {
3313
- if (typeof index !== "number") return jsonError(res, 400, "index is required");
3314
- if (!await ensureBrowserRunning(profileCtx, res)) return;
3315
- const target = (await profileCtx.listTabs())[index];
3316
- if (!target) throw new BrowserTabNotFoundError();
3317
- const ssrfPolicyOpts = browserNavigationPolicyForProfile(ctx, profileCtx);
3318
- if (ssrfPolicyOpts.ssrfPolicy) await assertBrowserNavigationResultAllowed({
3319
- url: target.url,
3320
- ...ssrfPolicyOpts
3321
- });
3322
- await profileCtx.focusTab(target.targetId);
3323
- return res.json({
3324
- ok: true,
3325
- targetId: target.targetId
3326
- });
3327
- }
3328
- return jsonError(res, 400, "unknown tab action");
3329
- }
3330
- });
3331
- }));
3332
- }
3333
- //#endregion
3334
- //#region extensions/browser/src/browser/routes/index.ts
3335
- function registerBrowserRoutes(app, ctx) {
3336
- registerBrowserBasicRoutes(app, ctx);
3337
- registerBrowserTabRoutes(app, ctx);
3338
- registerBrowserAgentRoutes(app, ctx);
3339
- }
3340
- //#endregion
3341
- export { registerBrowserRoutes as t };