pi-agent-browser-native 0.9.3 → 0.9.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 (394) hide show
  1. package/CHANGELOG.md +106 -5
  2. package/README.md +58 -791
  3. package/dist/extensions/agent-browser/index.js +43101 -2031
  4. package/dist/extensions/agent-browser/lib/argv-descriptor.js +49 -26
  5. package/dist/extensions/agent-browser/lib/argv-grammar.js +82 -93
  6. package/dist/extensions/agent-browser/lib/bash-guard.js +129 -126
  7. package/dist/extensions/agent-browser/lib/batch-lifecycle.js +112 -51
  8. package/dist/extensions/agent-browser/lib/browser-execution-claim-codec.js +61 -0
  9. package/dist/extensions/agent-browser/lib/browser-execution-claim-storage.js +232 -0
  10. package/dist/extensions/agent-browser/lib/browser-execution-claims.js +202 -0
  11. package/dist/extensions/agent-browser/lib/browser-execution-identity.js +77 -0
  12. package/dist/extensions/agent-browser/lib/browser-journal-branch.js +98 -0
  13. package/dist/extensions/agent-browser/lib/browser-journal-contracts.js +1 -0
  14. package/dist/extensions/agent-browser/lib/browser-journal-projection.js +221 -0
  15. package/dist/extensions/agent-browser/lib/browser-journal-reader.js +89 -0
  16. package/dist/extensions/agent-browser/lib/browser-journal-replay.js +246 -0
  17. package/dist/extensions/agent-browser/lib/browser-journal.js +103 -394
  18. package/dist/extensions/agent-browser/lib/browser-legacy-pages.js +220 -0
  19. package/dist/extensions/agent-browser/lib/browser-legacy-projection.js +282 -0
  20. package/dist/extensions/agent-browser/lib/browser-legacy-types.js +1 -0
  21. package/dist/extensions/agent-browser/lib/browser-session-conversion-stream.js +217 -0
  22. package/dist/extensions/agent-browser/lib/browser-session-conversion.js +80 -335
  23. package/dist/extensions/agent-browser/lib/browser-transcript-contracts.js +35 -0
  24. package/dist/extensions/agent-browser/lib/browser-transcript-validation.js +166 -0
  25. package/dist/extensions/agent-browser/lib/browser-transcript.js +137 -82
  26. package/dist/extensions/agent-browser/lib/browser-value-parsing.js +15 -0
  27. package/dist/extensions/agent-browser/lib/command-capabilities.js +340 -0
  28. package/dist/extensions/agent-browser/lib/command-policy.js +107 -88
  29. package/dist/extensions/agent-browser/lib/command-taxonomy.js +49 -322
  30. package/dist/extensions/agent-browser/lib/config-policy.js +138 -343
  31. package/dist/extensions/agent-browser/lib/config-providers.js +71 -0
  32. package/dist/extensions/agent-browser/lib/config-validation.js +231 -0
  33. package/dist/extensions/agent-browser/lib/config.js +20 -8
  34. package/dist/extensions/agent-browser/lib/electron/cdp.js +20 -8
  35. package/dist/extensions/agent-browser/lib/electron/cleanup.js +128 -83
  36. package/dist/extensions/agent-browser/lib/electron/discovery-darwin.js +109 -0
  37. package/dist/extensions/agent-browser/lib/electron/discovery-desktop.js +136 -0
  38. package/dist/extensions/agent-browser/lib/electron/discovery-evidence.js +90 -0
  39. package/dist/extensions/agent-browser/lib/electron/discovery-linux.js +93 -0
  40. package/dist/extensions/agent-browser/lib/electron/discovery-packages.js +162 -0
  41. package/dist/extensions/agent-browser/lib/electron/discovery-types.js +2 -0
  42. package/dist/extensions/agent-browser/lib/electron/discovery.js +140 -549
  43. package/dist/extensions/agent-browser/lib/electron/launch-monitor.js +102 -0
  44. package/dist/extensions/agent-browser/lib/electron/launch-process.js +209 -0
  45. package/dist/extensions/agent-browser/lib/electron/launch-types.js +2 -0
  46. package/dist/extensions/agent-browser/lib/electron/launch.js +261 -355
  47. package/dist/extensions/agent-browser/lib/executable-path.js +21 -12
  48. package/dist/extensions/agent-browser/lib/execution-cwd.js +35 -18
  49. package/dist/extensions/agent-browser/lib/fs-utils.js +1 -9
  50. package/dist/extensions/agent-browser/lib/input-modes/electron.js +162 -121
  51. package/dist/extensions/agent-browser/lib/input-modes/job.js +123 -317
  52. package/dist/extensions/agent-browser/lib/input-modes/lookup-network-evidence.js +116 -0
  53. package/dist/extensions/agent-browser/lib/input-modes/lookup-plan.js +132 -0
  54. package/dist/extensions/agent-browser/lib/input-modes/lookup-redaction.js +57 -0
  55. package/dist/extensions/agent-browser/lib/input-modes/lookup-source-evidence.js +151 -0
  56. package/dist/extensions/agent-browser/lib/input-modes/lookup-workspace.js +142 -0
  57. package/dist/extensions/agent-browser/lib/input-modes/lookups.js +58 -412
  58. package/dist/extensions/agent-browser/lib/input-modes/params.js +86 -40
  59. package/dist/extensions/agent-browser/lib/input-modes/qa-analysis.js +268 -0
  60. package/dist/extensions/agent-browser/lib/input-modes/qa-presentation.js +117 -0
  61. package/dist/extensions/agent-browser/lib/input-modes/script-child.js +396 -0
  62. package/dist/extensions/agent-browser/lib/input-modes/script-protocol.js +86 -0
  63. package/dist/extensions/agent-browser/lib/input-modes/script-types.js +1 -0
  64. package/dist/extensions/agent-browser/lib/input-modes/script-validation.js +60 -0
  65. package/dist/extensions/agent-browser/lib/input-modes/script.js +60 -409
  66. package/dist/extensions/agent-browser/lib/input-modes/semantic-action.js +218 -128
  67. package/dist/extensions/agent-browser/lib/input-modes/shared.js +15 -4
  68. package/dist/extensions/agent-browser/lib/input-modes/types.js +56 -7
  69. package/dist/extensions/agent-browser/lib/json-schema.js +22 -10
  70. package/dist/extensions/agent-browser/lib/launch-scoped-flags.js +17 -5
  71. package/dist/extensions/agent-browser/lib/managed-session-policy-lock.js +92 -425
  72. package/dist/extensions/agent-browser/lib/managed-session-posix-storage.js +58 -0
  73. package/dist/extensions/agent-browser/lib/managed-session-project-identity.js +244 -0
  74. package/dist/extensions/agent-browser/lib/managed-session-restore-context.js +84 -0
  75. package/dist/extensions/agent-browser/lib/managed-session-restore-policy.js +119 -0
  76. package/dist/extensions/agent-browser/lib/managed-session-restore-state.js +83 -0
  77. package/dist/extensions/agent-browser/lib/managed-session-restore.js +168 -300
  78. package/dist/extensions/agent-browser/lib/managed-session-snapshot-records.js +277 -0
  79. package/dist/extensions/agent-browser/lib/managed-session-snapshots.js +128 -305
  80. package/dist/extensions/agent-browser/lib/managed-session-storage.js +56 -253
  81. package/dist/extensions/agent-browser/lib/native-confirmation.js +140 -0
  82. package/dist/extensions/agent-browser/lib/native-output.js +43 -9
  83. package/dist/extensions/agent-browser/lib/orchestration/batch-stdin.js +106 -59
  84. package/dist/extensions/agent-browser/lib/orchestration/browser-run/artifact-merge.js +14 -6
  85. package/dist/extensions/agent-browser/lib/orchestration/browser-run/artifact-paths.js +109 -57
  86. package/dist/extensions/agent-browser/lib/orchestration/browser-run/browser-observation-result.js +82 -0
  87. package/dist/extensions/agent-browser/lib/orchestration/browser-run/click-dispatch.js +164 -60
  88. package/dist/extensions/agent-browser/lib/orchestration/browser-run/diagnostic-values.js +31 -0
  89. package/dist/extensions/agent-browser/lib/orchestration/browser-run/diagnostics.js +152 -781
  90. package/dist/extensions/agent-browser/lib/orchestration/browser-run/electron-observation.js +203 -0
  91. package/dist/extensions/agent-browser/lib/orchestration/browser-run/electron-text-diagnostics.js +109 -0
  92. package/dist/extensions/agent-browser/lib/orchestration/browser-run/fill-diagnostics.js +119 -0
  93. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-action-recovery.js +147 -0
  94. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-actions.js +144 -0
  95. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-content.js +123 -0
  96. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-contracts.js +1 -0
  97. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-details.js +156 -0
  98. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-electron.js +187 -0
  99. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-evidence.js +39 -0
  100. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-missing-binary.js +89 -0
  101. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-recovery.js +97 -0
  102. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-redaction.js +106 -0
  103. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-timeout.js +110 -0
  104. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result.js +41 -538
  105. package/dist/extensions/agent-browser/lib/orchestration/browser-run/index.js +199 -154
  106. package/dist/extensions/agent-browser/lib/orchestration/browser-run/interaction-diagnostics.js +290 -0
  107. package/dist/extensions/agent-browser/lib/orchestration/browser-run/managed-session-close.js +167 -0
  108. package/dist/extensions/agent-browser/lib/orchestration/browser-run/managed-session-daemon-inspection.js +108 -0
  109. package/dist/extensions/agent-browser/lib/orchestration/browser-run/managed-session-daemon-policy.js +127 -205
  110. package/dist/extensions/agent-browser/lib/orchestration/browser-run/native-helper-observation.js +65 -0
  111. package/dist/extensions/agent-browser/lib/orchestration/browser-run/observation-types.js +1 -0
  112. package/dist/extensions/agent-browser/lib/orchestration/browser-run/overlay-diagnostics.js +120 -0
  113. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/network-page-filter.js +113 -30
  114. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/scroll-shims.js +109 -28
  115. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/snapshot-filter-data.js +150 -0
  116. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/snapshot-filter.js +147 -253
  117. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/snapshot-rendered-text.js +147 -0
  118. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/wait-timeouts.js +59 -24
  119. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-artifacts.js +159 -0
  120. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-command.js +131 -0
  121. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-contracts.js +1 -0
  122. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-daemon.js +93 -0
  123. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-failure.js +42 -0
  124. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-guards.js +242 -0
  125. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-input.js +75 -0
  126. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-observations.js +92 -0
  127. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-page-selection.js +254 -0
  128. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-page-state.js +121 -0
  129. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-refs.js +130 -0
  130. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-resources.js +114 -0
  131. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-semantic.js +121 -0
  132. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-session-plan.js +222 -0
  133. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-timeouts.js +68 -0
  134. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare.js +176 -1123
  135. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-analysis.js +191 -0
  136. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-confirmation.js +152 -0
  137. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-diagnostics.js +182 -0
  138. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-electron.js +150 -0
  139. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-lifecycle-contracts.js +1 -0
  140. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-lifecycle-phase-contracts.js +1 -0
  141. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-lifecycle-phase.js +115 -0
  142. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-lifecycle.js +256 -0
  143. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-managed-contracts.js +1 -0
  144. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-managed.js +256 -0
  145. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-native-phase-contracts.js +1 -0
  146. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-native-phase.js +93 -0
  147. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-native.js +113 -0
  148. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-navigation-contracts.js +1 -0
  149. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-navigation.js +316 -0
  150. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-ownership.js +28 -0
  151. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-page-phase-contracts.js +1 -0
  152. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-page-phase.js +142 -0
  153. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-presentation-contracts.js +1 -0
  154. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-presentation.js +333 -0
  155. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-publication-phase-contracts.js +1 -0
  156. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-publication-phase.js +71 -0
  157. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-publication.js +201 -0
  158. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-receipts.js +183 -0
  159. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-refs.js +200 -0
  160. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-tabs.js +142 -0
  161. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output.js +18 -968
  162. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prompt-guards.js +23 -13
  163. package/dist/extensions/agent-browser/lib/orchestration/browser-run/recording-receipt-reconciliation.js +198 -0
  164. package/dist/extensions/agent-browser/lib/orchestration/browser-run/recording-recovery-contracts.js +1 -0
  165. package/dist/extensions/agent-browser/lib/orchestration/browser-run/recording-recovery-presentation.js +154 -0
  166. package/dist/extensions/agent-browser/lib/orchestration/browser-run/recording-recovery.js +68 -151
  167. package/dist/extensions/agent-browser/lib/orchestration/browser-run/screenshot-capture.js +14 -0
  168. package/dist/extensions/agent-browser/lib/orchestration/browser-run/screenshot-observation.js +169 -46
  169. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-commands.js +130 -0
  170. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-electron.js +212 -0
  171. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-observations.js +61 -0
  172. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-outcomes.js +187 -0
  173. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-refs.js +169 -0
  174. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-tabs.js +228 -0
  175. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state.js +77 -765
  176. package/dist/extensions/agent-browser/lib/orchestration/browser-run/text-visibility-diagnostics.js +182 -0
  177. package/dist/extensions/agent-browser/lib/orchestration/browser-run/timeout-diagnostics.js +256 -0
  178. package/dist/extensions/agent-browser/lib/orchestration/browser-run/timeout-progress.js +108 -0
  179. package/dist/extensions/agent-browser/lib/orchestration/code-artifact-observation.js +39 -0
  180. package/dist/extensions/agent-browser/lib/orchestration/code-image-observation.js +119 -0
  181. package/dist/extensions/agent-browser/lib/orchestration/electron-host/branch.js +93 -0
  182. package/dist/extensions/agent-browser/lib/orchestration/electron-host/cleanup-result.js +58 -0
  183. package/dist/extensions/agent-browser/lib/orchestration/electron-host/cleanup.js +78 -0
  184. package/dist/extensions/agent-browser/lib/orchestration/electron-host/contracts.js +1 -0
  185. package/dist/extensions/agent-browser/lib/orchestration/electron-host/discovery.js +106 -0
  186. package/dist/extensions/agent-browser/lib/orchestration/electron-host/index.js +48 -821
  187. package/dist/extensions/agent-browser/lib/orchestration/electron-host/policy.js +86 -0
  188. package/dist/extensions/agent-browser/lib/orchestration/electron-host/probe-collection.js +68 -0
  189. package/dist/extensions/agent-browser/lib/orchestration/electron-host/probe-data.js +169 -0
  190. package/dist/extensions/agent-browser/lib/orchestration/electron-host/probe-presentation.js +182 -0
  191. package/dist/extensions/agent-browser/lib/orchestration/electron-host/probe.js +161 -0
  192. package/dist/extensions/agent-browser/lib/orchestration/electron-host/status.js +167 -0
  193. package/dist/extensions/agent-browser/lib/orchestration/execution-queue.js +22 -10
  194. package/dist/extensions/agent-browser/lib/orchestration/extension-artifact-preflight.js +211 -0
  195. package/dist/extensions/agent-browser/lib/orchestration/extension-artifacts.js +23 -0
  196. package/dist/extensions/agent-browser/lib/orchestration/extension-attachment-replay.js +99 -0
  197. package/dist/extensions/agent-browser/lib/orchestration/extension-branch-restore.js +275 -0
  198. package/dist/extensions/agent-browser/lib/orchestration/extension-code.js +280 -0
  199. package/dist/extensions/agent-browser/lib/orchestration/extension-command-admission.js +303 -0
  200. package/dist/extensions/agent-browser/lib/orchestration/extension-command-output.js +36 -0
  201. package/dist/extensions/agent-browser/lib/orchestration/extension-command-result.js +335 -0
  202. package/dist/extensions/agent-browser/lib/orchestration/extension-command-run.js +227 -0
  203. package/dist/extensions/agent-browser/lib/orchestration/extension-command-state.js +1 -0
  204. package/dist/extensions/agent-browser/lib/orchestration/extension-electron-ownership.js +204 -0
  205. package/dist/extensions/agent-browser/lib/orchestration/extension-execution-locks.js +139 -0
  206. package/dist/extensions/agent-browser/lib/orchestration/extension-execution-queue.js +24 -0
  207. package/dist/extensions/agent-browser/lib/orchestration/extension-host-coordination.js +98 -0
  208. package/dist/extensions/agent-browser/lib/orchestration/extension-host-run.js +295 -0
  209. package/dist/extensions/agent-browser/lib/orchestration/extension-intent-replay.js +41 -0
  210. package/dist/extensions/agent-browser/lib/orchestration/extension-invocation.js +7 -0
  211. package/dist/extensions/agent-browser/lib/orchestration/extension-lifecycle.js +102 -0
  212. package/dist/extensions/agent-browser/lib/orchestration/extension-managed-ownership.js +133 -0
  213. package/dist/extensions/agent-browser/lib/orchestration/extension-observation.js +120 -0
  214. package/dist/extensions/agent-browser/lib/orchestration/extension-prompt.js +180 -0
  215. package/dist/extensions/agent-browser/lib/orchestration/extension-recording.js +290 -0
  216. package/dist/extensions/agent-browser/lib/orchestration/extension-resource-contracts.js +1 -0
  217. package/dist/extensions/agent-browser/lib/orchestration/extension-resource-replay.js +269 -0
  218. package/dist/extensions/agent-browser/lib/orchestration/extension-result-state.js +113 -0
  219. package/dist/extensions/agent-browser/lib/orchestration/extension-runtime.js +146 -0
  220. package/dist/extensions/agent-browser/lib/orchestration/extension-script-leases.js +58 -0
  221. package/dist/extensions/agent-browser/lib/orchestration/extension-tool-boundary.js +62 -0
  222. package/dist/extensions/agent-browser/lib/orchestration/extension-version-check.js +54 -0
  223. package/dist/extensions/agent-browser/lib/orchestration/input-plan-types.js +1 -0
  224. package/dist/extensions/agent-browser/lib/orchestration/input-plan.js +261 -185
  225. package/dist/extensions/agent-browser/lib/orchestration/input-redaction.js +62 -0
  226. package/dist/extensions/agent-browser/lib/orchestration/native-config.js +144 -0
  227. package/dist/extensions/agent-browser/lib/orchestration/native-root-launch.js +77 -0
  228. package/dist/extensions/agent-browser/lib/orchestration/native-session-defaults.js +210 -157
  229. package/dist/extensions/agent-browser/lib/orchestration/operation-paths.js +124 -58
  230. package/dist/extensions/agent-browser/lib/orchestration/output-file.js +197 -99
  231. package/dist/extensions/agent-browser/lib/orchestration/script-mode.js +199 -96
  232. package/dist/extensions/agent-browser/lib/owned-managed-session-context.js +55 -0
  233. package/dist/extensions/agent-browser/lib/page-target-batch.js +118 -0
  234. package/dist/extensions/agent-browser/lib/page-target-guards.js +50 -0
  235. package/dist/extensions/agent-browser/lib/page-target-navigation.js +104 -0
  236. package/dist/extensions/agent-browser/lib/page-target-validation.js +55 -246
  237. package/dist/extensions/agent-browser/lib/parsing.js +13 -4
  238. package/dist/extensions/agent-browser/lib/pi-tool-rendering.js +133 -68
  239. package/dist/extensions/agent-browser/lib/playbook.js +16 -12
  240. package/dist/extensions/agent-browser/lib/process-child.js +284 -0
  241. package/dist/extensions/agent-browser/lib/process-environment.js +13 -6
  242. package/dist/extensions/agent-browser/lib/process-errors.js +23 -0
  243. package/dist/extensions/agent-browser/lib/process-identity.js +47 -15
  244. package/dist/extensions/agent-browser/lib/process-socket-storage.js +256 -0
  245. package/dist/extensions/agent-browser/lib/process-stdout.js +74 -0
  246. package/dist/extensions/agent-browser/lib/process.js +145 -536
  247. package/dist/extensions/agent-browser/lib/prompt-artifacts.js +287 -0
  248. package/dist/extensions/agent-browser/lib/prompt-policy.js +15 -194
  249. package/dist/extensions/agent-browser/lib/read-command.js +41 -0
  250. package/dist/extensions/agent-browser/lib/read-confirmation.js +131 -68
  251. package/dist/extensions/agent-browser/lib/recording-reservations.js +118 -45
  252. package/dist/extensions/agent-browser/lib/redaction-fields.js +75 -0
  253. package/dist/extensions/agent-browser/lib/redaction-json.js +149 -0
  254. package/dist/extensions/agent-browser/lib/redaction-url.js +88 -0
  255. package/dist/extensions/agent-browser/lib/results/action-contracts.js +1 -0
  256. package/dist/extensions/agent-browser/lib/results/action-recommendations.js +28 -271
  257. package/dist/extensions/agent-browser/lib/results/artifact-contracts.js +1 -0
  258. package/dist/extensions/agent-browser/lib/results/artifact-manifest-validation.js +133 -0
  259. package/dist/extensions/agent-browser/lib/results/artifact-manifest.js +96 -94
  260. package/dist/extensions/agent-browser/lib/results/artifact-recommendations.js +73 -0
  261. package/dist/extensions/agent-browser/lib/results/categories.js +111 -54
  262. package/dist/extensions/agent-browser/lib/results/confirmation.js +29 -13
  263. package/dist/extensions/agent-browser/lib/results/editable-ref-evidence.js +62 -27
  264. package/dist/extensions/agent-browser/lib/results/electron-recommendations.js +83 -0
  265. package/dist/extensions/agent-browser/lib/results/envelope-decoding.js +48 -0
  266. package/dist/extensions/agent-browser/lib/results/envelope.js +90 -67
  267. package/dist/extensions/agent-browser/lib/results/evidence-contracts.js +1 -0
  268. package/dist/extensions/agent-browser/lib/results/failure-recommendations.js +180 -0
  269. package/dist/extensions/agent-browser/lib/results/network-routes.js +86 -45
  270. package/dist/extensions/agent-browser/lib/results/network.js +35 -12
  271. package/dist/extensions/agent-browser/lib/results/next-actions.js +49 -19
  272. package/dist/extensions/agent-browser/lib/results/presentation/artifact-files.js +320 -0
  273. package/dist/extensions/agent-browser/lib/results/presentation/artifact-format.js +138 -0
  274. package/dist/extensions/agent-browser/lib/results/presentation/artifact-images.js +113 -0
  275. package/dist/extensions/agent-browser/lib/results/presentation/artifact-verification.js +145 -0
  276. package/dist/extensions/agent-browser/lib/results/presentation/artifacts.js +99 -555
  277. package/dist/extensions/agent-browser/lib/results/presentation/batch-contracts.js +1 -0
  278. package/dist/extensions/agent-browser/lib/results/presentation/batch-recording.js +118 -0
  279. package/dist/extensions/agent-browser/lib/results/presentation/batch-redaction.js +68 -0
  280. package/dist/extensions/agent-browser/lib/results/presentation/batch-rendering.js +135 -0
  281. package/dist/extensions/agent-browser/lib/results/presentation/batch-step.js +227 -0
  282. package/dist/extensions/agent-browser/lib/results/presentation/batch-summary.js +91 -0
  283. package/dist/extensions/agent-browser/lib/results/presentation/batch.js +91 -460
  284. package/dist/extensions/agent-browser/lib/results/presentation/browser-profile-recovery.js +9 -5
  285. package/dist/extensions/agent-browser/lib/results/presentation/command-presenters.js +216 -0
  286. package/dist/extensions/agent-browser/lib/results/presentation/common.js +26 -9
  287. package/dist/extensions/agent-browser/lib/results/presentation/content.js +86 -29
  288. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-a11y.js +67 -0
  289. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-health.js +79 -0
  290. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-identity.js +199 -0
  291. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-logs.js +75 -0
  292. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-network-actions.js +216 -0
  293. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-network.js +124 -0
  294. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-redaction.js +64 -0
  295. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-storage.js +209 -0
  296. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-stream.js +69 -0
  297. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-summary.js +222 -0
  298. package/dist/extensions/agent-browser/lib/results/presentation/diagnostics.js +103 -1052
  299. package/dist/extensions/agent-browser/lib/results/presentation/early-result.js +70 -0
  300. package/dist/extensions/agent-browser/lib/results/presentation/errors.js +130 -60
  301. package/dist/extensions/agent-browser/lib/results/presentation/input-contracts.js +1 -0
  302. package/dist/extensions/agent-browser/lib/results/presentation/large-output.js +60 -145
  303. package/dist/extensions/agent-browser/lib/results/presentation/navigation.js +147 -88
  304. package/dist/extensions/agent-browser/lib/results/presentation/notices.js +75 -0
  305. package/dist/extensions/agent-browser/lib/results/presentation/observation-contracts.js +1 -0
  306. package/dist/extensions/agent-browser/lib/results/presentation/observation-rendering.js +127 -0
  307. package/dist/extensions/agent-browser/lib/results/presentation/outcomes.js +120 -0
  308. package/dist/extensions/agent-browser/lib/results/presentation/output-completion.js +77 -0
  309. package/dist/extensions/agent-browser/lib/results/presentation/output-spill.js +51 -0
  310. package/dist/extensions/agent-browser/lib/results/presentation/registry.js +116 -240
  311. package/dist/extensions/agent-browser/lib/results/presentation/semantic-action.js +35 -21
  312. package/dist/extensions/agent-browser/lib/results/presentation/skills.js +109 -73
  313. package/dist/extensions/agent-browser/lib/results/presentation/source.js +109 -0
  314. package/dist/extensions/agent-browser/lib/results/presentation.js +17 -261
  315. package/dist/extensions/agent-browser/lib/results/recommendation-contracts.js +1 -0
  316. package/dist/extensions/agent-browser/lib/results/recording.js +52 -14
  317. package/dist/extensions/agent-browser/lib/results/recovery-actions.js +14 -5
  318. package/dist/extensions/agent-browser/lib/results/recovery-next-actions.js +30 -22
  319. package/dist/extensions/agent-browser/lib/results/selector-recovery-target.js +83 -0
  320. package/dist/extensions/agent-browser/lib/results/selector-recovery.js +119 -119
  321. package/dist/extensions/agent-browser/lib/results/snapshot-compact.js +266 -0
  322. package/dist/extensions/agent-browser/lib/results/snapshot-content.js +32 -0
  323. package/dist/extensions/agent-browser/lib/results/snapshot-high-value-controls.js +104 -71
  324. package/dist/extensions/agent-browser/lib/results/snapshot-refs.js +31 -11
  325. package/dist/extensions/agent-browser/lib/results/snapshot-segments.js +125 -66
  326. package/dist/extensions/agent-browser/lib/results/snapshot-spill.js +26 -7
  327. package/dist/extensions/agent-browser/lib/results/snapshot.js +28 -248
  328. package/dist/extensions/agent-browser/lib/results/text.js +16 -5
  329. package/dist/extensions/agent-browser/lib/runtime-args-validation.js +133 -0
  330. package/dist/extensions/agent-browser/lib/runtime-compatibility.js +81 -0
  331. package/dist/extensions/agent-browser/lib/runtime-contracts.js +1 -0
  332. package/dist/extensions/agent-browser/lib/runtime-redaction.js +118 -0
  333. package/dist/extensions/agent-browser/lib/runtime-replay-events.js +144 -0
  334. package/dist/extensions/agent-browser/lib/runtime-session-identity.js +76 -0
  335. package/dist/extensions/agent-browser/lib/runtime-session-plan.js +114 -0
  336. package/dist/extensions/agent-browser/lib/runtime-session-replay.js +123 -0
  337. package/dist/extensions/agent-browser/lib/runtime-tab-correction.js +65 -0
  338. package/dist/extensions/agent-browser/lib/runtime-timeouts.js +28 -0
  339. package/dist/extensions/agent-browser/lib/runtime.js +137 -1041
  340. package/dist/extensions/agent-browser/lib/session-identity.js +51 -0
  341. package/dist/extensions/agent-browser/lib/session-page-observation.js +357 -0
  342. package/dist/extensions/agent-browser/lib/session-page-state.js +178 -333
  343. package/dist/extensions/agent-browser/lib/session-page-types.js +1 -0
  344. package/dist/extensions/agent-browser/lib/temp-artifact-budget.js +81 -0
  345. package/dist/extensions/agent-browser/lib/temp-mutation-queue.js +7 -0
  346. package/dist/extensions/agent-browser/lib/temp-root-ownership.js +234 -0
  347. package/dist/extensions/agent-browser/lib/temp-root.js +211 -0
  348. package/dist/extensions/agent-browser/lib/temp.js +33 -446
  349. package/dist/extensions/agent-browser/lib/tool-surface.js +94 -24
  350. package/dist/extensions/agent-browser/lib/upstream-version.js +3 -2
  351. package/dist/extensions/agent-browser/lib/web-search-providers.js +193 -0
  352. package/dist/extensions/agent-browser/lib/web-search-request.js +102 -0
  353. package/dist/extensions/agent-browser/lib/web-search-results.js +281 -0
  354. package/dist/extensions/agent-browser/lib/web-search-schema.js +82 -0
  355. package/dist/extensions/agent-browser/lib/web-search.js +124 -614
  356. package/dist/extensions/agent-browser/lib/webmcp-observation.js +13 -6
  357. package/dist/extensions/agent-browser/lib/windows-stock-launcher.js +63 -37
  358. package/dist/extensions/agent-browser/script-worker.js +80 -43
  359. package/dist/scripts/agent-browser-target.mjs +4 -2
  360. package/docs/ARCHITECTURE.md +19 -6
  361. package/docs/CODE_QUALITY.md +267 -0
  362. package/docs/COMMAND_REFERENCE.md +272 -241
  363. package/docs/ELECTRON.md +77 -46
  364. package/docs/REFERENCE.md +869 -0
  365. package/docs/RELEASE.md +25 -22
  366. package/docs/REQUIREMENTS.md +2 -1
  367. package/docs/SUPPORT_MATRIX.md +81 -79
  368. package/docs/TOOL_CONTRACT.md +158 -125
  369. package/docs/platform-smoke.md +8 -8
  370. package/package.json +144 -120
  371. package/scripts/agent-browser-capability-baseline.mjs +361 -957
  372. package/scripts/agent-browser-target.mjs +6 -2
  373. package/scripts/build.mjs +37 -8
  374. package/scripts/capability-core-commands.mjs +193 -0
  375. package/scripts/capability-options.mjs +283 -0
  376. package/scripts/capability-samples.mjs +133 -0
  377. package/scripts/capability-section.mjs +11 -0
  378. package/scripts/config.mjs +235 -132
  379. package/scripts/convert-browser-session.mjs +30 -9
  380. package/scripts/doctor-sources.mjs +195 -0
  381. package/scripts/doctor.mjs +94 -249
  382. package/scripts/platform-smoke/artifacts.mjs +38 -11
  383. package/scripts/platform-smoke/commands.mjs +104 -0
  384. package/scripts/platform-smoke/crabbox-runner.mjs +167 -80
  385. package/scripts/platform-smoke/doctor-support.mjs +157 -0
  386. package/scripts/platform-smoke/doctor-windows.mjs +230 -0
  387. package/scripts/platform-smoke/doctor.mjs +212 -320
  388. package/scripts/platform-smoke/lease-evidence.mjs +132 -0
  389. package/scripts/platform-smoke/linux-image/Dockerfile +8 -2
  390. package/scripts/platform-smoke/suite-checks.mjs +98 -0
  391. package/scripts/platform-smoke/suite-evidence.mjs +281 -0
  392. package/scripts/platform-smoke/targets.mjs +154 -472
  393. package/scripts/platform-smoke.mjs +55 -40
  394. package/scripts/prepare.mjs +16 -7
@@ -8,974 +8,378 @@
8
8
  */
9
9
 
10
10
  import { TARGET_AGENT_BROWSER_VERSION } from "./agent-browser-target.mjs";
11
+ import { coreCommands } from "./capability-core-commands.mjs";
12
+ import { optionsAndEnv } from "./capability-options.mjs";
13
+ import { root, section } from "./capability-section.mjs";
14
+ import { helpCommands, sourceEvidence } from "./capability-samples.mjs";
11
15
 
12
16
  export const CAPABILITY_BASELINE_SOURCE = "scripts/agent-browser-capability-baseline.mjs";
13
17
  export const COMMAND_REFERENCE_DOC_PATH = "docs/COMMAND_REFERENCE.md";
14
18
  export const CAPABILITY_BASELINE_BLOCK_MARKER_PREFIX = "agent-browser-capability-baseline";
15
- export const COMMAND_REFERENCE_BASELINE_BLOCK_IDS = Object.freeze(["upstream-baseline", "capability-token-baseline"]);
16
-
17
- const sourceEvidence = Object.freeze({
18
- repository: "vercel-labs/agent-browser",
19
- upstreamHead: "aff6125c023b810ea3f2e5deec5379e9a4270bdc",
20
- upstreamPackageVersion: "0.38.1",
21
- inspectedSources: Object.freeze([
22
- "agent-browser --version",
23
- "agent-browser --help",
24
- "selected agent-browser <command> --help output",
25
- "agent-browser a11y --help",
26
- "agent-browser mcp --help",
27
- "agent-browser plugin --help",
28
- "agent-browser skills list",
29
- "agent-browser skills get core --full",
30
- "agent-browser skills get derive-client --full",
31
- "agent-browser skills get webmcp-gen --full",
32
- "README.md",
33
- "CHANGELOG.md",
34
- "agent-browser.schema.json",
35
- "bin/agent-browser.js",
36
- "cli/src/ca_bundle.rs",
37
- "cli/src/commands.rs",
38
- "cli/src/mcp.rs",
39
- "cli/src/flags.rs",
40
- "cli/src/read.rs",
41
- "cli/src/doctor/ffmpeg.rs",
42
- "cli/src/doctor/webgpu.rs",
43
- "cli/src/native/actions.rs",
44
- "cli/src/native/a11y/mod.rs",
45
- "cli/src/native/browser.rs",
46
- "cli/src/native/tab_binding.rs",
47
- "cli/src/native/daemon.rs",
48
- "cli/src/native/element.rs",
49
- "cli/src/native/recording.rs",
50
- "cli/src/native/snapshot.rs",
51
- "cli/src/native/interaction.rs",
52
- "cli/src/native/screenshot.rs",
53
- "cli/src/native/stream/cdp_loop.rs",
54
- "cli/src/native/stream/dashboard.rs",
55
- "cli/src/native/test_fixtures/webmcp_frame_probe.html",
56
- "cli/src/native/test_fixtures/webmcp_probe.html",
57
- "cli/src/native/webmcp.rs",
58
- "cli/src/output.rs",
59
- "docs/src/app/webgpu/page.mdx",
60
- "docs/src/app/webmcp/page.mdx",
61
- "docs/src/app/network/page.mdx",
62
- "docs/src/app/proxy/page.mdx",
63
- "docs/src/app/selectors/page.mdx",
64
- "docs/src/app/skills/page.mdx",
65
- "docs/src/app/commands/page.mdx",
66
- "skill-data/derive-client/SKILL.md",
67
- "skill-data/core/SKILL.md",
68
- "skill-data/core/references/video-recording.md",
69
- "skill-data/protected-vercel-deployments/SKILL.md",
70
- "skill-data/webmcp-gen/SKILL.md",
71
- "test/launcher.test.mjs",
72
- "packages/@agent-browser/eve/README.md",
73
- "packages/@agent-browser/eve/package.json",
74
- "packages/@agent-browser/eve/test/extension.test.mjs",
75
- "packages/@agent-browser/sandbox/README.md",
76
- "packages/@agent-browser/sandbox/src/shared.ts",
77
- "packages/@agent-browser/sandbox/src/vercel.ts",
78
- "packages/@agent-browser/sandbox/src/eve.ts",
79
- ]),
80
- });
81
-
82
- const helpCommand = (label, args) => Object.freeze({ label, args: Object.freeze(args) });
83
- const expectation = (help, token) => Object.freeze({ help, token });
84
- const section = (id, title, docTokens, upstreamExpectations = []) =>
85
- Object.freeze({
86
- id,
87
- title,
88
- docTokens: Object.freeze(docTokens),
89
- upstreamExpectations: Object.freeze(upstreamExpectations.map(([help, token]) => expectation(help, token))),
90
- });
91
- const root = (token) => ["root help", token];
92
-
93
- const helpCommands = Object.freeze([
94
- helpCommand("root help", ["--help"]),
95
- helpCommand("skills help", ["skills", "--help"]),
96
- helpCommand("skills list", ["skills", "list"]),
97
- helpCommand("core skill full", ["skills", "get", "core", "--full"]),
98
- helpCommand("vercel sandbox skill full", ["skills", "get", "vercel-sandbox", "--full"]),
99
- helpCommand("protected Vercel deployments skill full", ["skills", "get", "protected-vercel-deployments", "--full"]),
100
- helpCommand("WebMCP generation skill full", ["skills", "get", "webmcp-gen", "--full"]),
101
- helpCommand("open help", ["open", "--help"]),
102
- helpCommand("read help", ["read", "--help"]),
103
- helpCommand("click help", ["click", "--help"]),
104
- helpCommand("key help", ["key", "--help"]),
105
- helpCommand("scroll help", ["scroll", "--help"]),
106
- helpCommand("scrollinto help", ["scrollinto", "--help"]),
107
- helpCommand("keydown help", ["keydown", "--help"]),
108
- helpCommand("keyup help", ["keyup", "--help"]),
109
- helpCommand("get help", ["get", "--help"]),
110
- helpCommand("is help", ["is", "--help"]),
111
- helpCommand("mouse help", ["mouse", "--help"]),
112
- helpCommand("drag help", ["drag", "--help"]),
113
- helpCommand("set help", ["set", "--help"]),
114
- helpCommand("tab help", ["tab", "--help"]),
115
- helpCommand("snapshot help", ["snapshot", "--help"]),
116
- helpCommand("eval help", ["eval", "--help"]),
117
- helpCommand("wait help", ["wait", "--help"]),
118
- helpCommand("screenshot help", ["screenshot", "--help"]),
119
- helpCommand("pdf help", ["pdf", "--help"]),
120
- helpCommand("close help", ["close", "--help"]),
121
- helpCommand("find help", ["find", "--help"]),
122
- helpCommand("network help", ["network", "--help"]),
123
- helpCommand("cookies help", ["cookies", "--help"]),
124
- helpCommand("storage help", ["storage", "--help"]),
125
- helpCommand("state help", ["state", "--help"]),
126
- helpCommand("session help", ["session", "--help"]),
127
- helpCommand("frame help", ["frame", "--help"]),
128
- helpCommand("dialog help", ["dialog", "--help"]),
129
- helpCommand("window help", ["window", "--help"]),
130
- helpCommand("keyboard help", ["keyboard", "--help"]),
131
- helpCommand("batch help", ["batch", "--help"]),
132
- helpCommand("auth help", ["auth", "--help"]),
133
- helpCommand("stream help", ["stream", "--help"]),
134
- helpCommand("dashboard help", ["dashboard", "--help"]),
135
- helpCommand("chat help", ["chat", "--help"]),
136
- helpCommand("doctor help", ["doctor", "--help"]),
137
- helpCommand("diff help", ["diff", "--help"]),
138
- helpCommand("trace help", ["trace", "--help"]),
139
- helpCommand("profiler help", ["profiler", "--help"]),
140
- helpCommand("record help", ["record", "--help"]),
141
- helpCommand("console help", ["console", "--help"]),
142
- helpCommand("errors help", ["errors", "--help"]),
143
- helpCommand("a11y help", ["a11y", "--help"]),
144
- helpCommand("clipboard help", ["clipboard", "--help"]),
145
- helpCommand("tap help", ["tap", "--help"]),
146
- helpCommand("swipe help", ["swipe", "--help"]),
147
- helpCommand("device help", ["device", "--help"]),
148
- helpCommand("install help", ["install", "--help"]),
149
- helpCommand("upgrade help", ["upgrade", "--help"]),
150
- helpCommand("profiles help", ["profiles", "--help"]),
151
- helpCommand("mcp help", ["mcp", "--help"]),
152
- helpCommand("plugin help", ["plugin", "--help"]),
19
+ export const COMMAND_REFERENCE_BASELINE_BLOCK_IDS = Object.freeze([
20
+ "upstream-baseline",
21
+ "capability-token-baseline",
153
22
  ]);
154
23
 
155
24
  const inventorySections = Object.freeze([
156
- section(
157
- "skills",
158
- "Built-in skills",
159
- [
160
- "skills list",
161
- "skills get core",
162
- "skills get core --full",
163
- "skills get <name>",
164
- "skills get <name> --full",
165
- "skills get --all",
166
- "skills get electron",
167
- "skills get slack",
168
- "skills get dogfood",
169
- "skills get vercel-sandbox",
170
- "skills get protected-vercel-deployments",
171
- "skills get agentcore",
172
- "skills get derive-client",
173
- "skills get webmcp-gen",
174
- "webmcp.init.js",
175
- "@agent-browser/sandbox",
176
- "installSystemDependencies: false",
177
- "skills path [name]",
178
- "AGENT_BROWSER_SKILLS_DIR",
179
- ],
180
- [
181
- root("skills get core --full"),
182
- ["skills help", "get <name> --full"],
183
- ["skills help", "get --all"],
184
- ["skills help", "AGENT_BROWSER_SKILLS_DIR"],
185
- ["skills list", "core"],
186
- ["skills list", "electron"],
187
- ["skills list", "slack"],
188
- ["skills list", "dogfood"],
189
- ["skills list", "vercel-sandbox"],
190
- ["skills list", "protected-vercel-deployments"],
191
- ["skills list", "agentcore"],
192
- ["skills list", "derive-client"],
193
- ["skills list", "webmcp-gen"],
194
- ["WebMCP generation skill full", "webmcp.init.js"],
195
- ["WebMCP generation skill full", "agent-browser webmcp invoke <tool> --params @fixture.json"],
196
- ["vercel sandbox skill full", "@agent-browser/sandbox"],
197
- ["vercel sandbox skill full", "installSystemDependencies: false"],
198
- ["protected Vercel deployments skill full", "x-vercel-trusted-oidc-idp-token"],
199
- ["protected Vercel deployments skill full", "vc project token"],
200
- ["core skill full", "agent-browser frame @e3"],
201
- ["core skill full", "agent-browser dialog accept"],
202
- ["core skill full", "agent-browser --session \"$SESSION\" --restore open https://app.example.com"],
203
- ["core skill full", "network har start --content all"],
204
- ["core skill full", "implicit roles work"],
205
- ],
206
- ),
207
- section(
208
- "core-commands",
209
- "Core page, element, navigation, and extraction commands",
210
- [
211
- "open [url]",
212
- "open <url>",
213
- "goto <url>",
214
- "navigate <url>",
215
- "read [url]",
216
- "read <url> --raw",
217
- "read <url> --require-md",
218
- "read <url> --llms <index|full>",
219
- "read <url> --outline",
220
- "read <url> --filter <text>",
221
- "read <url> --timeout <ms>",
222
- "click <sel>",
223
- "click <sel> --new-tab",
224
- "dblclick <sel>",
225
- "type <sel> <text>",
226
- "fill <sel> <text>",
227
- "press <key>",
228
- "key <key>",
229
- "keydown <key>",
230
- "keyup <key>",
231
- "keyboard type <text>",
232
- "keyboard inserttext <text>",
233
- "keydown Shift",
234
- "keyup Shift",
235
- "hover <sel>",
236
- "focus <sel>",
237
- "check <sel>",
238
- "uncheck <sel>",
239
- "select <sel> <val...>",
240
- "drag <src> <dst>",
241
- "upload <sel> <files...>",
242
- "download <sel> <path>",
243
- "scroll <dir> [px]",
244
- "scroll <dir> [px] --selector <sel>",
245
- "scrollintoview <sel>",
246
- "scrollinto <sel>",
247
- "wait <sel|ms>",
248
- "wait --url <pattern>",
249
- "wait --load <state>",
250
- "wait --fn <expression>",
251
- "wait --text <text>",
252
- "wait --download [path]",
253
- "screenshot [selector] [path]",
254
- "screenshot [path]",
255
- "screenshot --full",
256
- "screenshot --annotate",
257
- "screenshot --if-changed",
258
- "screenshot --threshold <0-1>",
259
- "snapshot --delta",
260
- "snapshot --delta --full",
261
- "click <sel> --human",
262
- "drag <src> <dst> --human",
263
- "mouse move <x> <y> --duration <ms> --steps <n> --human --seed <n>",
264
- "pdf <path>",
265
- "snapshot",
266
- "snapshot --cursor",
267
- "snapshot --interactive",
268
- "snapshot --urls",
269
- "snapshot --compact",
270
- "snapshot --depth <n>",
271
- "snapshot --selector <sel>",
272
- "eval <js>",
273
- "eval --stdin",
274
- "eval -b <base64>",
275
- "connect <port|url>",
276
- "close [--all]",
277
- "quit",
278
- "exit",
279
- "back",
280
- "forward",
281
- "reload",
282
- "pushstate <url>",
283
- "get <what> [selector]",
284
- "get cdp-url",
285
- "get box <selector>",
286
- "get styles <selector>",
287
- "is <what> <selector>",
288
- "find <locator> <value> <action>",
289
- "find first <sel>",
290
- "find last <sel>",
291
- "find nth <n> <sel>",
292
- "find role <role> --name <name>",
293
- "find role heading text --name",
294
- "find ... --exact",
295
- "mouse <action> [args]",
296
- "set <setting> [value]",
297
- "set media <features>",
298
- "tap <selector>",
299
- "swipe <direction> [distance]",
300
- ],
301
- [
302
- ["open help", "open [url]"],
303
- ["open help", "aliases still require a URL."],
304
- ["open help", "agent-browser webmcp list"],
305
- root("open <url>"),
306
- root("read [url]"),
307
- ["read help", "read [url]"],
308
- ["read help", "--raw"],
309
- ["read help", "--require-md"],
310
- ["read help", "--llms <index|full>"],
311
- ["read help", "--outline"],
312
- ["read help", "--filter <text>"],
313
- ["read help", "--timeout <ms>"],
314
- root("click <sel>"),
315
- ["click help", "--new-tab"],
316
- root("dblclick <sel>"),
317
- root("type <sel> <text>"),
318
- root("fill <sel> <text>"),
319
- root("press <key>"),
320
- ["key help", "Aliases: key"],
321
- ["keydown help", "keydown <key>"],
322
- ["keyup help", "keyup <key>"],
323
- root("keyboard type <text>"),
324
- root("keyboard inserttext <text>"),
325
- root("hover <sel>"),
326
- root("focus <sel>"),
327
- root("check <sel>"),
328
- root("uncheck <sel>"),
329
- root("select <sel> <val...>"),
330
- root("drag <src> <dst>"),
331
- root("upload <sel> <files...>"),
332
- root("download <sel> <path>"),
333
- root("scroll <dir> [px]"),
334
- ["scroll help", "--selector <sel>"],
335
- root("scrollintoview <sel>"),
336
- ["scrollinto help", "Aliases: scrollinto"],
337
- root("wait <sel|ms>"),
338
- ["wait help", "--url <pattern>"],
339
- ["wait help", "--load <state>"],
340
- ["wait help", "--fn <expression>"],
341
- ["wait help", "--text <text>"],
342
- ["wait help", "--download [path]"],
343
- root("screenshot [path]"),
344
- ["screenshot help", "screenshot [selector] [path]"],
345
- root("pdf <path>"),
346
- ["pdf help", "Save page as PDF"],
347
- root("snapshot"),
348
- ["snapshot help", "--interactive"],
349
- ["snapshot help", "--urls"],
350
- ["snapshot help", "--compact"],
351
- ["snapshot help", "--depth <n>"],
352
- ["snapshot help", "--selector <sel>"],
353
- root("eval <js>"),
354
- ["eval help", "--stdin"],
355
- ["eval help", "-b, --base64"],
356
- root("connect <port|url>"),
357
- root("close [--all]"),
358
- ["close help", "Aliases: quit, exit"],
359
- root("back"),
360
- root("forward"),
361
- root("reload"),
362
- root("pushstate <url>"),
363
- root("Get Info: agent-browser get <what> [selector]"),
364
- ["get help", "box <selector>"],
365
- ["get help", "styles <selector>"],
366
- ["get help", "cdp-url"],
367
- root("Check State: agent-browser is <what> <selector>"),
368
- root("Find Elements: agent-browser find <locator> <value> <action> [text]"),
369
- ["find help", "first <selector>"],
370
- ["find help", "last <selector>"],
371
- ["find help", "nth <index> <selector>"],
372
- ["find help", "--name <name>"],
373
- ["find help", "--exact"],
374
- ["find help", "case-insensitive"],
375
- ["find help", "click, fill, check, hover, text"],
376
- root("Mouse: agent-browser mouse <action> [args]"),
377
- root("Browser Settings: agent-browser set <setting> [value]"),
378
- ["set help", "media [dark|light]"],
379
- ["keyboard help", "type <text>"],
380
- ["keyboard help", "inserttext <text>"],
381
- ["screenshot help", "--full, -f"],
382
- ["screenshot help", "--annotate"],
383
- ["screenshot help", "--if-changed"],
384
- ["screenshot help", "--threshold <0-1>"],
385
- ["snapshot help", "--delta"],
386
- ["snapshot help", "--full"],
387
- ["click help", "--human"],
388
- ["drag help", "--human"],
389
- ["mouse help", "--duration <ms>"],
390
- ["mouse help", "--steps <n>"],
391
- ["mouse help", "--seed <n>"],
392
- ["find help", "role <role>"],
393
- ["find help", "testid <id>"],
394
- ["tap help", "tap <selector>"],
395
- ["swipe help", "swipe <direction> [distance]"],
396
- ],
397
- ),
398
- section(
399
- "state-tabs-frames-dialogs",
400
- "Sessions, state, tabs, frames, dialogs, and windows",
401
- [
402
- "session",
403
- "session id",
404
- "session id --scope worktree --prefix <name>",
405
- "session info",
406
- "session info --json",
407
- "session list",
408
- "state save <path>",
409
- "state load <path>",
410
- "state list",
411
- "state show <filename>",
412
- "state rename <old-name> <new-name>",
413
- "state clear [session-name] [--all]",
414
- "state clear -a",
415
- "state clean --older-than <days>",
416
- "tab list",
417
- "tab new [url]",
418
- "tab new --label <name> [url]",
419
- "tab close [target]",
420
- "tab <t<N>|label>",
421
- "tab_gone",
422
- "data.targetId",
423
- "data.lastUrl",
424
- "CDP target ids",
425
- "frame <selector|main>",
426
- "dialog accept [text]",
427
- "dialog dismiss",
428
- "dialog status",
429
- "window new",
430
- ],
431
- [
432
- root("session list"),
433
- ["session help", "id"],
434
- ["session help", "info"],
435
- ["session help", "--scope worktree"],
436
- ["session help", "--namespace <name>"],
437
- ["state help", "save <path>"],
438
- ["state help", "load <path>"],
439
- ["state help", "list"],
440
- ["state help", "show <filename>"],
441
- ["state help", "rename <old-name> <new-name>"],
442
- ["state help", "clear [session-name] [--all]"],
443
- ["state help", "agent-browser state clear --all"],
444
- ["state help", "clean --older-than <days>"],
445
- ["tab help", "new [url]"],
446
- ["tab help", "new --label <name> [url]"],
447
- ["tab help", "close [t<N>|label|target]"],
448
- ["tab help", "Stable tab ids"],
449
- ["tab help", "overrides before their first document loads."],
450
- ["tab help", "tab_gone"],
451
- ["tab help", "data.targetId"],
452
- ["tab help", "data.lastUrl"],
453
- ["core skill full", "--pin-tab"],
454
- ["core skill full", "tab_gone"],
455
- ["frame help", "frame <selector|main>"],
456
- ["dialog help", "dialog <accept|dismiss|status> [text]"],
457
- ["window help", "window <operation>"],
458
- ],
459
- ),
460
- section(
461
- "network-storage-artifacts-diagnostics",
462
- "Network, storage, artifacts, diagnostics, and performance",
463
- [
464
- "network <action>",
465
- "network route <url> [--abort|--body <json>] [--resource-type <csv>]",
466
- "network unroute [url]",
467
- "network requests [--clear] [--filter <pattern>] [--type <csv>] [--method <method>] [--status <code|range>]",
468
- "network request <requestId>",
469
- "network har start",
470
- "network har start --content all",
471
- "network har start --content none",
472
- "network har start --content text",
473
- "network har stop [path]",
474
- "cookies [get|set|clear]",
475
- "cookies set <name> <value> --url <url> --domain <domain> --path <path> --httpOnly --secure --sameSite <Strict|Lax|None> --expires <timestamp>",
476
- "cookies set --curl <file>",
477
- "storage <local|session>",
478
- "webmcp list",
479
- "webmcp list [tool] [--frame <frame-id>]",
480
- "webmcp invoke <tool>",
481
- "webmcp invoke <tool> --params <json|@file>",
482
- "webmcp invoke <tool> --frame <frame-id>",
483
- "webmcp invoke <tool> --detach",
484
- "webmcp invoke <tool> --timeout <ms>",
485
- "webmcp result <id>",
486
- "webmcp cancel <id>",
487
- "diff snapshot",
488
- "diff snapshot --baseline <file> --selector <sel> --compact --depth <n>",
489
- "diff screenshot --baseline",
490
- "diff screenshot --baseline <file> --output <file> --threshold <0-1> --selector <sel> --full",
491
- "diff url <u1> <u2>",
492
- "diff url <u1> <u2> --screenshot --wait-until <strategy> --selector <sel> --compact --depth <n>",
493
- "trace start",
494
- "trace stop [path]",
495
- "profiler start|stop [path]",
496
- "record start <path> [url]",
497
- "record restart <path> [url]",
498
- "--fps <n>",
499
- "--cursor",
500
- "--contact-sheet",
501
- "--contact-sheet-threshold <n>",
502
- "record stop",
503
- "console [--clear]",
504
- "errors [--clear]",
505
- "highlight <sel>",
506
- "inspect",
507
- "clipboard <op> [text]",
508
- "clipboard read",
509
- "clipboard write <text>",
510
- "clipboard copy",
511
- "clipboard paste",
512
- "stream enable [--port <n>]",
513
- "stream disable",
514
- "stream status",
515
- "react tree",
516
- "react inspect <id>",
517
- "react renders start",
518
- "react renders stop [--json]",
519
- "react suspense [--only-dynamic] [--json]",
520
- "vitals [url] [--json]",
521
- "web-vitals [url] [--json]",
522
- "a11y [url]",
523
- "a11y --tags wcag2a,wcag2aa",
524
- "a11y --selector \"#main\"",
525
- "removeinitscript <id>",
526
- ],
527
- [
528
- root("network <action>"),
529
- root("--resource-type <csv>"),
530
- ["network help", "unroute [url]"],
531
- ["network help", "network har start"],
532
- ["network help", "network har start --content all"],
533
- ["network help", "--content <mode>"],
534
- ["network help", "network har stop ./capture.har"],
535
- root("cookies [get|set|clear]"),
536
- root("cookies set --curl <file>"),
537
- root("storage <local|session>"),
538
- root("webmcp list [tool]"),
539
- root("webmcp invoke <tool>"),
540
- root("--params <json|@file>"),
541
- root("--frame <frame-id>"),
542
- root("--detach"),
543
- root("webmcp result <id>"),
544
- root("webmcp cancel <id>"),
545
- root("diff snapshot"),
546
- root("diff screenshot --baseline"),
547
- root("trace start"),
548
- root("trace stop [path]"),
549
- root("profiler start|stop [path]"),
550
- root("record start <path> [url]"),
551
- root("record stop"),
552
- root("console [--clear]"),
553
- root("errors [--clear]"),
554
- root("highlight <sel>"),
555
- root("inspect"),
556
- root("clipboard <op> [text]"),
557
- ["clipboard help", "read"],
558
- ["clipboard help", "write <text>"],
559
- ["clipboard help", "copy"],
560
- ["clipboard help", "paste"],
561
- root("stream enable [--port <n>]"),
562
- root("stream disable"),
563
- root("stream status"),
564
- root("react tree"),
565
- root("react inspect <id>"),
566
- root("react renders start"),
567
- root("react renders stop [--json]"),
568
- root("react suspense [--only-dynamic] [--json]"),
569
- root("vitals [url] [--json]"),
570
- root("a11y [url] [--tags <t1,t2>] [--selector <css>] [--json]"),
571
- ["a11y help", "a11y [url]"],
572
- ["a11y help", "--tags <tag1,tag2>"],
573
- ["a11y help", "-s, --selector <css>"],
574
- ["core skill full", "agent-browser a11y"],
575
- root("removeinitscript <id>"),
576
- ["network help", "requests [options]"],
577
- ["network help", "--type <types>"],
578
- ["network help", "--method <method>"],
579
- ["network help", "--status <code>"],
580
- ["network help", "request <requestId>"],
581
- ["network help", "har <start|stop>"],
582
- ["storage help", "set <key> <value>"],
583
- ["diff help", "diff snapshot [options]"],
584
- ["diff help", "--baseline <f>"],
585
- ["diff help", "--output <file>"],
586
- ["diff help", "--threshold <0-1>"],
587
- ["diff help", "--wait-until <strategy>"],
588
- ["diff help", "diff screenshot --baseline <f>"],
589
- ["trace help", "trace start"],
590
- ["trace help", "trace stop [path]"],
591
- ["profiler help", "--categories <list>"],
592
- ["record help", "record restart <path.webm|path.mp4> [url] [--fps <n>]"],
593
- ["record help", "--fps <n>"],
594
- ["record help", "--cursor"],
595
- ["record help", "--contact-sheet"],
596
- ["record help", "--contact-sheet-threshold <n>"],
597
- ["console help", "--clear"],
598
- ["errors help", "--clear"],
599
- ],
600
- ),
601
- section(
602
- "batch-auth-setup-ai",
603
- "Batch, auth, confirmations, setup, dashboard, devices, and AI commands",
604
- [
605
- "batch [--bail]",
606
- "auth save <name>",
607
- "auth save <name> --url <url> --username <user> --password <pass>",
608
- "auth save <name> --username-selector <s> --password-selector <s> --submit-selector <s>",
609
- "auth save <name> --password-stdin",
610
- "auth login <name>",
611
- "auth login <name> --no-navigate",
612
- "auth list",
613
- "auth show <name>",
614
- "auth delete <name>",
615
- "auth remove <name>",
616
- "confirm <id>",
617
- "deny <id>",
618
- "chat <message>",
619
- "dashboard [start]",
620
- "dashboard start --port <n>",
621
- "dashboard start --allowed-origins <origins>",
622
- "AGENT_BROWSER_DASHBOARD_ALLOWED_ORIGINS",
623
- "dashboard stop",
624
- "device list",
625
- "install",
626
- "install --with-deps",
627
- "install --with-deps exits nonzero",
628
- "upgrade",
629
- "doctor [--fix]",
630
- "doctor --offline --quick",
631
- "doctor --webgpu",
632
- "doctor --webgpu --headed",
633
- "doctor --json",
634
- "mcp",
635
- "mcp --tools core,webmcp",
636
- "plugin add <ref>",
637
- "plugin [list]",
638
- "plugin show <name>",
639
- "plugin run <name> <type>",
640
- "auth login <name> --credential-provider <plugin>",
641
- "profiles",
642
- ],
643
- [
644
- root("batch [--bail]"),
645
- root("auth save <name>"),
646
- root("auth login <name>"),
647
- root("confirm <id>"),
648
- root("deny <id>"),
649
- root("chat <message>"),
650
- root("dashboard start --port <n>"),
651
- root("dashboard start --allowed-origins <origins>"),
652
- ["dashboard help", "--allowed-origins <origins>"],
653
- ["dashboard help", "AGENT_BROWSER_DASHBOARD_ALLOWED_ORIGINS"],
654
- ["device help", "device list"],
655
- root("install --with-deps"),
656
- ["install help", "fails if deps fail"],
657
- root("upgrade"),
658
- root("doctor [--fix]"),
659
- root("profiles"),
660
- ["batch help", "--bail"],
661
- ["auth help", "--url <url>"],
662
- ["auth help", "--username <user>"],
663
- ["auth help", "--password <pass>"],
664
- ["auth help", "--password-stdin"],
665
- ["auth help", "--username-selector <s>"],
666
- ["auth help", "--password-selector <s>"],
667
- ["auth help", "--submit-selector <s>"],
668
- ["dashboard help", "dashboard [start|stop] [options]"],
669
- ["chat help", "chat <message>"],
670
- ["doctor help", "--offline"],
671
- ["doctor help", "--webgpu"],
672
- ["doctor help", "--headed"],
673
- ["doctor help", "--json"],
674
- root("Start an MCP stdio server"),
675
- root("plugin add <ref>"),
676
- root("plugin [list]"),
677
- root("plugin show <name>"),
678
- root("plugin run <name> <type>"),
679
- ["auth help", "--credential-provider <p>"],
680
- ["auth help", "--no-navigate"],
681
- ["mcp help", "agent_browser_open"],
682
- ["mcp help", "--tools"],
683
- ["plugin help", "Add a plugin from npm or GitHub"],
684
- ["plugin help", "credential.read"],
685
- ],
686
- ),
687
- section(
688
- "options-and-env",
689
- "Global flags, config, providers, policy, and environment",
690
- [
691
- "--profile <name|path>",
692
- "AGENT_BROWSER_PROFILE",
693
- "--session <name>",
694
- "AGENT_BROWSER_SESSION",
695
- "--namespace <name>",
696
- "AGENT_BROWSER_NAMESPACE",
697
- "--restore [name]",
698
- "AGENT_BROWSER_RESTORE",
699
- "--restore-save <policy>",
700
- "AGENT_BROWSER_RESTORE_SAVE",
701
- "--restore-check-url <glob>",
702
- "AGENT_BROWSER_RESTORE_CHECK_URL",
703
- "--restore-check-text <txt>",
704
- "AGENT_BROWSER_RESTORE_CHECK_TEXT",
705
- "--restore-check-fn <js>",
706
- "AGENT_BROWSER_RESTORE_CHECK_FN",
707
- "--session-name <name>",
708
- "AGENT_BROWSER_SESSION_NAME",
709
- "--state <path>",
710
- "AGENT_BROWSER_STATE",
711
- "--auto-connect",
712
- "AGENT_BROWSER_AUTO_CONNECT",
713
- "--pin-tab",
714
- "--no-pin-tab",
715
- "AGENT_BROWSER_PIN_TAB",
716
- "--headers <json>",
717
- "--init-script <path>",
718
- "AGENT_BROWSER_INIT_SCRIPTS",
719
- "--enable <feature>",
720
- "AGENT_BROWSER_ENABLE",
721
- "--executable-path <path>",
722
- "AGENT_BROWSER_EXECUTABLE_PATH",
723
- "--extension <path>",
724
- "AGENT_BROWSER_EXTENSIONS",
725
- "--args <args>",
726
- "AGENT_BROWSER_ARGS",
727
- "--user-agent <ua>",
728
- "AGENT_BROWSER_USER_AGENT",
729
- "--proxy <server>",
730
- "AGENT_BROWSER_PROXY",
731
- "HTTP_PROXY",
732
- "HTTPS_PROXY",
733
- "ALL_PROXY",
734
- "--proxy-bypass <hosts>",
735
- "AGENT_BROWSER_PROXY_BYPASS",
736
- "NO_PROXY",
737
- "--ignore-https-errors",
738
- "AGENT_BROWSER_IGNORE_HTTPS_ERRORS",
739
- "--ca-cert <path>",
740
- "--no-ca-cert",
741
- "AGENT_BROWSER_CA_CERT",
742
- "AGENT_BROWSER_CLEAR_CA_CERT",
743
- "--allow-file-access",
744
- "AGENT_BROWSER_ALLOW_FILE_ACCESS",
745
- "--hide-scrollbars <bool>",
746
- "--headed",
747
- "AGENT_BROWSER_HEADED",
748
- "--webgpu",
749
- "AGENT_BROWSER_WEBGPU",
750
- "--no-webmcp",
751
- "AGENT_BROWSER_NO_WEBMCP",
752
- "noWebmcp",
753
- "AGENT_BROWSER_NO_XVFB",
754
- "\"webgpu\": true",
755
- "--cdp <port|url>",
756
- "--color-scheme <scheme>",
757
- "AGENT_BROWSER_COLOR_SCHEME",
758
- "--download-path <path>",
759
- "AGENT_BROWSER_DOWNLOAD_PATH",
760
- "--engine <name>",
761
- "AGENT_BROWSER_ENGINE",
762
- "--input-mode <mode>",
763
- "--no-auto-dialog",
764
- "AGENT_BROWSER_NO_AUTO_DIALOG",
765
- "--json",
766
- "AGENT_BROWSER_JSON",
767
- "--annotate",
768
- "AGENT_BROWSER_ANNOTATE",
769
- "--screenshot-dir <path>",
770
- "AGENT_BROWSER_SCREENSHOT_DIR",
771
- "--screenshot-quality <n>",
772
- "AGENT_BROWSER_SCREENSHOT_QUALITY",
773
- "--screenshot-format <fmt>",
774
- "AGENT_BROWSER_SCREENSHOT_FORMAT",
775
- "--content-boundaries",
776
- "AGENT_BROWSER_CONTENT_BOUNDARIES",
777
- "--max-output <chars>",
778
- "AGENT_BROWSER_MAX_OUTPUT",
779
- "--allowed-domains <list>",
780
- "AGENT_BROWSER_ALLOWED_DOMAINS",
781
- "--action-policy <path>",
782
- "AGENT_BROWSER_ACTION_POLICY",
783
- "--confirm-actions <list>",
784
- "AGENT_BROWSER_CONFIRM_ACTIONS",
785
- "--confirm-interactive",
786
- "AGENT_BROWSER_CONFIRM_INTERACTIVE",
787
- "-p, --provider <name>",
788
- "AGENT_BROWSER_PROVIDER",
789
- "AGENT_BROWSER_PLUGINS",
790
- "browserbase",
791
- "kernel",
792
- "browseruse",
793
- "browserless",
794
- "agentcore",
795
- "--device <name>",
796
- "AGENT_BROWSER_IOS_DEVICE",
797
- "agent-browser -p ios device list",
798
- "agent-browser -p ios swipe up",
799
- "agent-browser -p ios tap @e1",
800
- "--model <name>",
801
- "AI_GATEWAY_MODEL",
802
- "-v, --verbose",
803
- "-q, --quiet",
804
- "--debug",
805
- "AGENT_BROWSER_DEBUG",
806
- "AGENT_BROWSER_CONFIG",
807
- "AGENT_BROWSER_DEFAULT_TIMEOUT",
808
- "--idle-timeout <ms>",
809
- "AGENT_BROWSER_AUTOSAVE_INTERVAL_MS",
810
- "AGENT_BROWSER_STREAM_PORT",
811
- "AGENT_BROWSER_STREAM_QUALITY",
812
- "AGENT_BROWSER_STREAM_MAX_WIDTH",
813
- "AGENT_BROWSER_STREAM_MAX_HEIGHT",
814
- "AGENT_BROWSER_IDLE_TIMEOUT_MS",
815
- "AGENT_BROWSER_ENCRYPTION_KEY",
816
- "AGENT_BROWSER_STATE_EXPIRE_DAYS",
817
- "AGENT_BROWSER_IOS_UDID",
818
- "AI_GATEWAY_URL",
819
- "AI_GATEWAY_API_KEY",
820
- "BROWSERBASE_API_KEY",
821
- "BROWSERBASE_PROJECT_ID",
822
- "BROWSERLESS_API_KEY",
823
- "BROWSERLESS_API_URL",
824
- "BROWSERLESS_BROWSER_TYPE",
825
- "BROWSERLESS_STEALTH",
826
- "BROWSERLESS_TTL",
827
- "BROWSER_USE_API_KEY",
828
- "KERNEL_API_KEY",
829
- "KERNEL_HEADLESS",
830
- "KERNEL_STEALTH",
831
- "KERNEL_TIMEOUT_SECONDS",
832
- "KERNEL_PROFILE_NAME",
833
- "AGENTCORE_API_KEY",
834
- "AGENTCORE_REGION",
835
- "AGENTCORE_BROWSER_ID",
836
- "AGENTCORE_PROFILE_ID",
837
- "AGENTCORE_SESSION_TIMEOUT",
838
- "AWS_PROFILE",
839
- "AWS_ACCESS_KEY_ID",
840
- "AWS_SECRET_ACCESS_KEY",
841
- "AWS_SESSION_TOKEN",
842
- "AWS_REGION",
843
- "AWS_DEFAULT_REGION",
844
- ],
845
- [
846
- root("--profile <name|path>"),
847
- root("AGENT_BROWSER_PROFILE"),
848
- root("--session <name>"),
849
- root("AGENT_BROWSER_SESSION"),
850
- root("--namespace <name>"),
851
- root("AGENT_BROWSER_NAMESPACE"),
852
- root("--restore [name]"),
853
- root("AGENT_BROWSER_RESTORE"),
854
- root("--restore-save <policy>"),
855
- root("AGENT_BROWSER_RESTORE_SAVE"),
856
- root("--restore-check-url <glob>"),
857
- root("AGENT_BROWSER_RESTORE_CHECK_URL"),
858
- root("--restore-check-text <txt>"),
859
- root("AGENT_BROWSER_RESTORE_CHECK_TEXT"),
860
- root("--restore-check-fn <js>"),
861
- root("AGENT_BROWSER_RESTORE_CHECK_FN"),
862
- root("--session-name <name>"),
863
- root("AGENT_BROWSER_SESSION_NAME"),
864
- root("--state <path>"),
865
- root("AGENT_BROWSER_STATE"),
866
- root("--auto-connect"),
867
- root("AGENT_BROWSER_AUTO_CONNECT"),
868
- root("--pin-tab"),
869
- root("--no-pin-tab"),
870
- root("AGENT_BROWSER_PIN_TAB"),
871
- root("--headers <json>"),
872
- root("--init-script <path>"),
873
- root("AGENT_BROWSER_INIT_SCRIPTS"),
874
- root("--enable <feature>"),
875
- root("AGENT_BROWSER_ENABLE"),
876
- root("--executable-path <path>"),
877
- root("AGENT_BROWSER_EXECUTABLE_PATH"),
878
- root("--extension <path>"),
879
- root("AGENT_BROWSER_EXTENSIONS"),
880
- root("--args <args>"),
881
- root("AGENT_BROWSER_ARGS"),
882
- root("--user-agent <ua>"),
883
- root("AGENT_BROWSER_USER_AGENT"),
884
- root("--proxy <server>"),
885
- root("AGENT_BROWSER_PROXY"),
886
- root("HTTP_PROXY / HTTPS_PROXY"),
887
- root("ALL_PROXY"),
888
- root("--proxy-bypass <hosts>"),
889
- root("AGENT_BROWSER_PROXY_BYPASS"),
890
- root("NO_PROXY"),
891
- root("--ignore-https-errors"),
892
- root("AGENT_BROWSER_IGNORE_HTTPS_ERRORS"),
893
- root("--ca-cert <path>"),
894
- root("--no-ca-cert"),
895
- root("AGENT_BROWSER_CA_CERT"),
896
- root("AGENT_BROWSER_CLEAR_CA_CERT"),
897
- root("--allow-file-access"),
898
- root("AGENT_BROWSER_ALLOW_FILE_ACCESS"),
899
- root("--hide-scrollbars <bool>"),
900
- root("--headed"),
901
- root("AGENT_BROWSER_HEADED"),
902
- root("--webgpu"),
903
- root("AGENT_BROWSER_WEBGPU"),
904
- root("--no-webmcp"),
905
- root("AGENT_BROWSER_NO_WEBMCP"),
906
- root("--cdp <port|url>"),
907
- root("--color-scheme <scheme>"),
908
- root("AGENT_BROWSER_COLOR_SCHEME"),
909
- root("--download-path <path>"),
910
- root("AGENT_BROWSER_DOWNLOAD_PATH"),
911
- root("--engine <name>"),
912
- root("AGENT_BROWSER_ENGINE"),
913
- root("--input-mode <mode>"),
914
- root("--no-auto-dialog"),
915
- root("AGENT_BROWSER_NO_AUTO_DIALOG"),
916
- root("--json"),
917
- root("AGENT_BROWSER_JSON"),
918
- root("--annotate"),
919
- root("AGENT_BROWSER_ANNOTATE"),
920
- root("--screenshot-dir <path>"),
921
- root("AGENT_BROWSER_SCREENSHOT_DIR"),
922
- root("--screenshot-quality <n>"),
923
- root("AGENT_BROWSER_SCREENSHOT_QUALITY"),
924
- root("--screenshot-format <fmt>"),
925
- root("AGENT_BROWSER_SCREENSHOT_FORMAT"),
926
- root("--content-boundaries"),
927
- root("AGENT_BROWSER_CONTENT_BOUNDARIES"),
928
- root("--max-output <chars>"),
929
- root("AGENT_BROWSER_MAX_OUTPUT"),
930
- root("--allowed-domains <list>"),
931
- root("AGENT_BROWSER_ALLOWED_DOMAINS"),
932
- root("--action-policy <path>"),
933
- root("AGENT_BROWSER_ACTION_POLICY"),
934
- root("--confirm-actions <list>"),
935
- root("AGENT_BROWSER_CONFIRM_ACTIONS"),
936
- root("--confirm-interactive"),
937
- root("AGENT_BROWSER_CONFIRM_INTERACTIVE"),
938
- root("--provider <name>"),
939
- root("AGENT_BROWSER_PROVIDER"),
940
- root("AGENT_BROWSER_PLUGINS"),
941
- root("agent-browser -p ios device list"),
942
- root("agent-browser -p ios swipe up"),
943
- root("agent-browser -p ios tap @e1"),
944
- root("--device <name>"),
945
- root("AGENT_BROWSER_IOS_DEVICE"),
946
- root("--model <name>"),
947
- root("AI_GATEWAY_MODEL"),
948
- root("--verbose"),
949
- root("--quiet"),
950
- root("--debug"),
951
- root("AGENT_BROWSER_DEBUG"),
952
- root("--config <path>"),
953
- root("AGENT_BROWSER_CONFIG"),
954
- root("AGENT_BROWSER_DEFAULT_TIMEOUT"),
955
- root("AGENT_BROWSER_AUTOSAVE_INTERVAL_MS"),
956
- root("AGENT_BROWSER_STREAM_PORT"),
957
- root("AGENT_BROWSER_STREAM_QUALITY"),
958
- root("AGENT_BROWSER_STREAM_MAX_WIDTH"),
959
- root("AGENT_BROWSER_STREAM_MAX_HEIGHT"),
960
- root("AGENT_BROWSER_IDLE_TIMEOUT_MS"),
961
- root("AGENT_BROWSER_ENCRYPTION_KEY"),
962
- root("AGENT_BROWSER_STATE_EXPIRE_DAYS"),
963
- root("AGENT_BROWSER_IOS_UDID"),
964
- root("AI_GATEWAY_URL"),
965
- root("AI_GATEWAY_API_KEY"),
966
- ],
967
- ),
25
+ section(
26
+ "skills",
27
+ "Built-in skills",
28
+ [
29
+ "skills list",
30
+ "skills get core",
31
+ "skills get core --full",
32
+ "skills get <name>",
33
+ "skills get <name> --full",
34
+ "skills get --all",
35
+ "skills get electron",
36
+ "skills get slack",
37
+ "skills get dogfood",
38
+ "skills get vercel-sandbox",
39
+ "skills get protected-vercel-deployments",
40
+ "skills get agentcore",
41
+ "skills get derive-client",
42
+ "skills get webmcp-gen",
43
+ "webmcp.init.js",
44
+ "@agent-browser/sandbox",
45
+ "installSystemDependencies: false",
46
+ "skills path [name]",
47
+ "AGENT_BROWSER_SKILLS_DIR",
48
+ ],
49
+ [
50
+ root("skills get core --full"),
51
+ ["skills help", "get <name> --full"],
52
+ ["skills help", "get --all"],
53
+ ["skills help", "AGENT_BROWSER_SKILLS_DIR"],
54
+ ["skills list", "core"],
55
+ ["skills list", "electron"],
56
+ ["skills list", "slack"],
57
+ ["skills list", "dogfood"],
58
+ ["skills list", "vercel-sandbox"],
59
+ ["skills list", "protected-vercel-deployments"],
60
+ ["skills list", "agentcore"],
61
+ ["skills list", "derive-client"],
62
+ ["skills list", "webmcp-gen"],
63
+ ["WebMCP generation skill full", "webmcp.init.js"],
64
+ ["WebMCP generation skill full", "agent-browser webmcp invoke <tool> --params @fixture.json"],
65
+ ["vercel sandbox skill full", "@agent-browser/sandbox"],
66
+ ["vercel sandbox skill full", "installSystemDependencies: false"],
67
+ ["protected Vercel deployments skill full", "x-vercel-trusted-oidc-idp-token"],
68
+ ["protected Vercel deployments skill full", "vc project token"],
69
+ ["core skill full", "agent-browser frame @e3"],
70
+ ["core skill full", "agent-browser dialog accept"],
71
+ [
72
+ "core skill full",
73
+ 'agent-browser --session "$SESSION" --restore open https://app.example.com',
74
+ ],
75
+ ["core skill full", "network har start --content all"],
76
+ ["core skill full", "implicit roles work"],
77
+ ],
78
+ ),
79
+ coreCommands,
80
+ section(
81
+ "state-tabs-frames-dialogs",
82
+ "Sessions, state, tabs, frames, dialogs, and windows",
83
+ [
84
+ "session",
85
+ "session id",
86
+ "session id --scope worktree --prefix <name>",
87
+ "session info",
88
+ "session info --json",
89
+ "session list",
90
+ "state save <path>",
91
+ "state load <path>",
92
+ "state list",
93
+ "state show <filename>",
94
+ "state rename <old-name> <new-name>",
95
+ "state clear [session-name] [--all]",
96
+ "state clear -a",
97
+ "state clean --older-than <days>",
98
+ "tab list",
99
+ "tab new [url]",
100
+ "tab new --label <name> [url]",
101
+ "tab close [target]",
102
+ "tab <t<N>|label>",
103
+ "tab_gone",
104
+ "data.targetId",
105
+ "data.lastUrl",
106
+ "CDP target ids",
107
+ "frame <selector|main>",
108
+ "dialog accept [text]",
109
+ "dialog dismiss",
110
+ "dialog status",
111
+ "window new",
112
+ ],
113
+ [
114
+ root("session list"),
115
+ ["session help", "id"],
116
+ ["session help", "info"],
117
+ ["session help", "--scope worktree"],
118
+ ["session help", "--namespace <name>"],
119
+ ["state help", "save <path>"],
120
+ ["state help", "load <path>"],
121
+ ["state help", "list"],
122
+ ["state help", "show <filename>"],
123
+ ["state help", "rename <old-name> <new-name>"],
124
+ ["state help", "clear [session-name] [--all]"],
125
+ ["state help", "agent-browser state clear --all"],
126
+ ["state help", "clean --older-than <days>"],
127
+ ["tab help", "new [url]"],
128
+ ["tab help", "new --label <name> [url]"],
129
+ ["tab help", "close [t<N>|label|target]"],
130
+ ["tab help", "Stable tab ids"],
131
+ ["tab help", "overrides before their first document loads."],
132
+ ["tab help", "tab_gone"],
133
+ ["tab help", "data.targetId"],
134
+ ["tab help", "data.lastUrl"],
135
+ ["core skill full", "--pin-tab"],
136
+ ["core skill full", "tab_gone"],
137
+ ["frame help", "frame <selector|main>"],
138
+ ["dialog help", "dialog <accept|dismiss|status> [text]"],
139
+ ["window help", "window <operation>"],
140
+ ],
141
+ ),
142
+ section(
143
+ "network-storage-artifacts-diagnostics",
144
+ "Network, storage, artifacts, diagnostics, and performance",
145
+ [
146
+ "network <action>",
147
+ "network route <url> [--abort|--body <json>] [--resource-type <csv>]",
148
+ "network unroute [url]",
149
+ "network requests [--clear] [--filter <pattern>] [--type <csv>] [--method <method>] [--status <code|range>]",
150
+ "network request <requestId>",
151
+ "network har start",
152
+ "network har start --content all",
153
+ "network har start --content none",
154
+ "network har start --content text",
155
+ "network har stop [path]",
156
+ "cookies [get|set|clear]",
157
+ "cookies set <name> <value> --url <url> --domain <domain> --path <path> --httpOnly --secure --sameSite <Strict|Lax|None> --expires <timestamp>",
158
+ "cookies set --curl <file>",
159
+ "storage <local|session>",
160
+ "webmcp list",
161
+ "webmcp list [tool] [--frame <frame-id>]",
162
+ "webmcp invoke <tool>",
163
+ "webmcp invoke <tool> --params <json|@file>",
164
+ "webmcp invoke <tool> --frame <frame-id>",
165
+ "webmcp invoke <tool> --detach",
166
+ "webmcp invoke <tool> --timeout <ms>",
167
+ "webmcp result <id>",
168
+ "webmcp cancel <id>",
169
+ "diff snapshot",
170
+ "diff snapshot --baseline <file> --selector <sel> --compact --depth <n>",
171
+ "diff screenshot --baseline",
172
+ "diff screenshot --baseline <file> --output <file> --threshold <0-1> --selector <sel> --full",
173
+ "diff url <u1> <u2>",
174
+ "diff url <u1> <u2> --screenshot --wait-until <strategy> --selector <sel> --compact --depth <n>",
175
+ "trace start",
176
+ "trace stop [path]",
177
+ "profiler start|stop [path]",
178
+ "record start <path> [url]",
179
+ "record restart <path> [url]",
180
+ "--fps <n>",
181
+ "--cursor",
182
+ "--contact-sheet",
183
+ "--contact-sheet-threshold <n>",
184
+ "record stop",
185
+ "console [--clear]",
186
+ "errors [--clear]",
187
+ "highlight <sel>",
188
+ "inspect",
189
+ "clipboard <op> [text]",
190
+ "clipboard read",
191
+ "clipboard write <text>",
192
+ "clipboard copy",
193
+ "clipboard paste",
194
+ "stream enable [--port <n>]",
195
+ "stream disable",
196
+ "stream status",
197
+ "react tree",
198
+ "react inspect <id>",
199
+ "react renders start",
200
+ "react renders stop [--json]",
201
+ "react suspense [--only-dynamic] [--json]",
202
+ "vitals [url] [--json]",
203
+ "web-vitals [url] [--json]",
204
+ "a11y [url]",
205
+ "a11y --tags wcag2a,wcag2aa",
206
+ 'a11y --selector "#main"',
207
+ "removeinitscript <id>",
208
+ ],
209
+ [
210
+ root("network <action>"),
211
+ root("--resource-type <csv>"),
212
+ ["network help", "unroute [url]"],
213
+ ["network help", "network har start"],
214
+ ["network help", "network har start --content all"],
215
+ ["network help", "--content <mode>"],
216
+ ["network help", "network har stop ./capture.har"],
217
+ root("cookies [get|set|clear]"),
218
+ root("cookies set --curl <file>"),
219
+ root("storage <local|session>"),
220
+ root("webmcp list [tool]"),
221
+ root("webmcp invoke <tool>"),
222
+ root("--params <json|@file>"),
223
+ root("--frame <frame-id>"),
224
+ root("--detach"),
225
+ root("webmcp result <id>"),
226
+ root("webmcp cancel <id>"),
227
+ root("diff snapshot"),
228
+ root("diff screenshot --baseline"),
229
+ root("trace start"),
230
+ root("trace stop [path]"),
231
+ root("profiler start|stop [path]"),
232
+ root("record start <path> [url]"),
233
+ root("record stop"),
234
+ root("console [--clear]"),
235
+ root("errors [--clear]"),
236
+ root("highlight <sel>"),
237
+ root("inspect"),
238
+ root("clipboard <op> [text]"),
239
+ ["clipboard help", "read"],
240
+ ["clipboard help", "write <text>"],
241
+ ["clipboard help", "copy"],
242
+ ["clipboard help", "paste"],
243
+ root("stream enable [--port <n>]"),
244
+ root("stream disable"),
245
+ root("stream status"),
246
+ root("react tree"),
247
+ root("react inspect <id>"),
248
+ root("react renders start"),
249
+ root("react renders stop [--json]"),
250
+ root("react suspense [--only-dynamic] [--json]"),
251
+ root("vitals [url] [--json]"),
252
+ root("a11y [url] [--tags <t1,t2>] [--selector <css>] [--json]"),
253
+ ["a11y help", "a11y [url]"],
254
+ ["a11y help", "--tags <tag1,tag2>"],
255
+ ["a11y help", "-s, --selector <css>"],
256
+ ["core skill full", "agent-browser a11y"],
257
+ root("removeinitscript <id>"),
258
+ ["network help", "requests [options]"],
259
+ ["network help", "--type <types>"],
260
+ ["network help", "--method <method>"],
261
+ ["network help", "--status <code>"],
262
+ ["network help", "request <requestId>"],
263
+ ["network help", "har <start|stop>"],
264
+ ["storage help", "set <key> <value>"],
265
+ ["diff help", "diff snapshot [options]"],
266
+ ["diff help", "--baseline <f>"],
267
+ ["diff help", "--output <file>"],
268
+ ["diff help", "--threshold <0-1>"],
269
+ ["diff help", "--wait-until <strategy>"],
270
+ ["diff help", "diff screenshot --baseline <f>"],
271
+ ["trace help", "trace start"],
272
+ ["trace help", "trace stop [path]"],
273
+ ["profiler help", "--categories <list>"],
274
+ ["record help", "record restart <path.webm|path.mp4> [url] [--fps <n>]"],
275
+ ["record help", "--fps <n>"],
276
+ ["record help", "--cursor"],
277
+ ["record help", "--contact-sheet"],
278
+ ["record help", "--contact-sheet-threshold <n>"],
279
+ ["console help", "--clear"],
280
+ ["errors help", "--clear"],
281
+ ],
282
+ ),
283
+ section(
284
+ "batch-auth-setup-ai",
285
+ "Batch, auth, confirmations, setup, dashboard, devices, and AI commands",
286
+ [
287
+ "batch [--bail]",
288
+ "auth save <name>",
289
+ "auth save <name> --url <url> --username <user> --password <pass>",
290
+ "auth save <name> --username-selector <s> --password-selector <s> --submit-selector <s>",
291
+ "auth save <name> --password-stdin",
292
+ "auth login <name>",
293
+ "auth login <name> --no-navigate",
294
+ "auth list",
295
+ "auth show <name>",
296
+ "auth delete <name>",
297
+ "auth remove <name>",
298
+ "confirm <id>",
299
+ "deny <id>",
300
+ "chat <message>",
301
+ "dashboard [start]",
302
+ "dashboard start --port <n>",
303
+ "dashboard start --allowed-origins <origins>",
304
+ "AGENT_BROWSER_DASHBOARD_ALLOWED_ORIGINS",
305
+ "dashboard stop",
306
+ "device list",
307
+ "install",
308
+ "install --with-deps",
309
+ "install --with-deps exits nonzero",
310
+ "upgrade",
311
+ "doctor [--fix]",
312
+ "doctor --offline --quick",
313
+ "doctor --webgpu",
314
+ "doctor --webgpu --headed",
315
+ "doctor --json",
316
+ "mcp",
317
+ "mcp --tools core,webmcp",
318
+ "plugin add <ref>",
319
+ "plugin [list]",
320
+ "plugin show <name>",
321
+ "plugin run <name> <type>",
322
+ "auth login <name> --credential-provider <plugin>",
323
+ "profiles",
324
+ ],
325
+ [
326
+ root("batch [--bail]"),
327
+ root("auth save <name>"),
328
+ root("auth login <name>"),
329
+ root("confirm <id>"),
330
+ root("deny <id>"),
331
+ root("chat <message>"),
332
+ root("dashboard start --port <n>"),
333
+ root("dashboard start --allowed-origins <origins>"),
334
+ ["dashboard help", "--allowed-origins <origins>"],
335
+ ["dashboard help", "AGENT_BROWSER_DASHBOARD_ALLOWED_ORIGINS"],
336
+ ["device help", "device list"],
337
+ root("install --with-deps"),
338
+ ["install help", "fails if deps fail"],
339
+ root("upgrade"),
340
+ root("doctor [--fix]"),
341
+ root("profiles"),
342
+ ["batch help", "--bail"],
343
+ ["auth help", "--url <url>"],
344
+ ["auth help", "--username <user>"],
345
+ ["auth help", "--password <pass>"],
346
+ ["auth help", "--password-stdin"],
347
+ ["auth help", "--username-selector <s>"],
348
+ ["auth help", "--password-selector <s>"],
349
+ ["auth help", "--submit-selector <s>"],
350
+ ["dashboard help", "dashboard [start|stop] [options]"],
351
+ ["chat help", "chat <message>"],
352
+ ["doctor help", "--offline"],
353
+ ["doctor help", "--webgpu"],
354
+ ["doctor help", "--headed"],
355
+ ["doctor help", "--json"],
356
+ root("Start an MCP stdio server"),
357
+ root("plugin add <ref>"),
358
+ root("plugin [list]"),
359
+ root("plugin show <name>"),
360
+ root("plugin run <name> <type>"),
361
+ ["auth help", "--credential-provider <p>"],
362
+ ["auth help", "--no-navigate"],
363
+ ["mcp help", "agent_browser_open"],
364
+ ["mcp help", "--tools"],
365
+ ["plugin help", "Add a plugin from npm or GitHub"],
366
+ ["plugin help", "credential.read"],
367
+ ],
368
+ ),
369
+ optionsAndEnv,
968
370
  ]);
969
371
 
970
372
  export const CAPABILITY_BASELINE = Object.freeze({
971
- targetVersion: TARGET_AGENT_BROWSER_VERSION,
972
- sourceEvidence,
973
- helpCommands,
974
- inventorySections,
975
- docRequiredTokens: Object.freeze(inventorySections.flatMap((entry) => entry.docTokens)),
976
- upstreamExpectations: Object.freeze(inventorySections.flatMap((entry) => entry.upstreamExpectations)),
373
+ targetVersion: TARGET_AGENT_BROWSER_VERSION,
374
+ sourceEvidence,
375
+ helpCommands,
376
+ inventorySections,
377
+ docRequiredTokens: Object.freeze(inventorySections.flatMap((entry) => entry.docTokens)),
378
+ upstreamExpectations: Object.freeze(
379
+ inventorySections.flatMap((entry) => entry.upstreamExpectations),
380
+ ),
977
381
  });
978
382
 
979
383
  export function expectedVersionLabel() {
980
- return `agent-browser ${CAPABILITY_BASELINE.targetVersion}`;
384
+ return `agent-browser ${CAPABILITY_BASELINE.targetVersion}`;
981
385
  }