pi-agent-browser-native 0.9.3 → 0.9.4

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 (391) hide show
  1. package/CHANGELOG.md +77 -5
  2. package/README.md +103 -81
  3. package/dist/extensions/agent-browser/index.js +43057 -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 +218 -0
  33. package/dist/extensions/agent-browser/lib/config.js +19 -7
  34. package/dist/extensions/agent-browser/lib/electron/cdp.js +15 -7
  35. package/dist/extensions/agent-browser/lib/electron/cleanup.js +134 -55
  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 +89 -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 +249 -354
  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/input-modes/electron.js +162 -121
  50. package/dist/extensions/agent-browser/lib/input-modes/job.js +116 -313
  51. package/dist/extensions/agent-browser/lib/input-modes/lookup-network-evidence.js +104 -0
  52. package/dist/extensions/agent-browser/lib/input-modes/lookup-plan.js +132 -0
  53. package/dist/extensions/agent-browser/lib/input-modes/lookup-redaction.js +57 -0
  54. package/dist/extensions/agent-browser/lib/input-modes/lookup-source-evidence.js +151 -0
  55. package/dist/extensions/agent-browser/lib/input-modes/lookup-workspace.js +142 -0
  56. package/dist/extensions/agent-browser/lib/input-modes/lookups.js +57 -412
  57. package/dist/extensions/agent-browser/lib/input-modes/params.js +63 -17
  58. package/dist/extensions/agent-browser/lib/input-modes/qa-analysis.js +268 -0
  59. package/dist/extensions/agent-browser/lib/input-modes/qa-presentation.js +117 -0
  60. package/dist/extensions/agent-browser/lib/input-modes/script-child.js +396 -0
  61. package/dist/extensions/agent-browser/lib/input-modes/script-protocol.js +86 -0
  62. package/dist/extensions/agent-browser/lib/input-modes/script-types.js +1 -0
  63. package/dist/extensions/agent-browser/lib/input-modes/script-validation.js +60 -0
  64. package/dist/extensions/agent-browser/lib/input-modes/script.js +60 -409
  65. package/dist/extensions/agent-browser/lib/input-modes/semantic-action.js +218 -128
  66. package/dist/extensions/agent-browser/lib/input-modes/shared.js +15 -4
  67. package/dist/extensions/agent-browser/lib/input-modes/types.js +56 -7
  68. package/dist/extensions/agent-browser/lib/json-schema.js +22 -10
  69. package/dist/extensions/agent-browser/lib/launch-scoped-flags.js +17 -5
  70. package/dist/extensions/agent-browser/lib/managed-session-policy-lock.js +92 -425
  71. package/dist/extensions/agent-browser/lib/managed-session-posix-storage.js +58 -0
  72. package/dist/extensions/agent-browser/lib/managed-session-project-identity.js +244 -0
  73. package/dist/extensions/agent-browser/lib/managed-session-restore-context.js +84 -0
  74. package/dist/extensions/agent-browser/lib/managed-session-restore-policy.js +119 -0
  75. package/dist/extensions/agent-browser/lib/managed-session-restore-state.js +83 -0
  76. package/dist/extensions/agent-browser/lib/managed-session-restore.js +168 -300
  77. package/dist/extensions/agent-browser/lib/managed-session-snapshot-records.js +277 -0
  78. package/dist/extensions/agent-browser/lib/managed-session-snapshots.js +128 -305
  79. package/dist/extensions/agent-browser/lib/managed-session-storage.js +56 -253
  80. package/dist/extensions/agent-browser/lib/native-confirmation.js +140 -0
  81. package/dist/extensions/agent-browser/lib/native-output.js +43 -9
  82. package/dist/extensions/agent-browser/lib/orchestration/batch-stdin.js +106 -59
  83. package/dist/extensions/agent-browser/lib/orchestration/browser-run/artifact-merge.js +14 -6
  84. package/dist/extensions/agent-browser/lib/orchestration/browser-run/artifact-paths.js +109 -57
  85. package/dist/extensions/agent-browser/lib/orchestration/browser-run/browser-observation-result.js +82 -0
  86. package/dist/extensions/agent-browser/lib/orchestration/browser-run/click-dispatch.js +164 -60
  87. package/dist/extensions/agent-browser/lib/orchestration/browser-run/diagnostic-values.js +31 -0
  88. package/dist/extensions/agent-browser/lib/orchestration/browser-run/diagnostics.js +152 -781
  89. package/dist/extensions/agent-browser/lib/orchestration/browser-run/electron-observation.js +202 -0
  90. package/dist/extensions/agent-browser/lib/orchestration/browser-run/electron-text-diagnostics.js +109 -0
  91. package/dist/extensions/agent-browser/lib/orchestration/browser-run/fill-diagnostics.js +119 -0
  92. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-action-recovery.js +147 -0
  93. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-actions.js +144 -0
  94. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-content.js +123 -0
  95. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-contracts.js +1 -0
  96. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-details.js +156 -0
  97. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-electron.js +179 -0
  98. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-evidence.js +39 -0
  99. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-missing-binary.js +89 -0
  100. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-recovery.js +97 -0
  101. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-redaction.js +106 -0
  102. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-timeout.js +110 -0
  103. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result.js +41 -538
  104. package/dist/extensions/agent-browser/lib/orchestration/browser-run/index.js +199 -154
  105. package/dist/extensions/agent-browser/lib/orchestration/browser-run/interaction-diagnostics.js +290 -0
  106. package/dist/extensions/agent-browser/lib/orchestration/browser-run/managed-session-close.js +167 -0
  107. package/dist/extensions/agent-browser/lib/orchestration/browser-run/managed-session-daemon-inspection.js +108 -0
  108. package/dist/extensions/agent-browser/lib/orchestration/browser-run/managed-session-daemon-policy.js +127 -205
  109. package/dist/extensions/agent-browser/lib/orchestration/browser-run/native-helper-observation.js +65 -0
  110. package/dist/extensions/agent-browser/lib/orchestration/browser-run/observation-types.js +1 -0
  111. package/dist/extensions/agent-browser/lib/orchestration/browser-run/overlay-diagnostics.js +120 -0
  112. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/network-page-filter.js +113 -30
  113. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/scroll-shims.js +109 -28
  114. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/snapshot-filter-data.js +150 -0
  115. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/snapshot-filter.js +138 -253
  116. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/snapshot-rendered-text.js +147 -0
  117. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/wait-timeouts.js +59 -24
  118. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-artifacts.js +159 -0
  119. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-command.js +131 -0
  120. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-contracts.js +1 -0
  121. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-daemon.js +93 -0
  122. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-failure.js +42 -0
  123. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-guards.js +242 -0
  124. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-input.js +75 -0
  125. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-observations.js +92 -0
  126. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-page-selection.js +254 -0
  127. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-page-state.js +121 -0
  128. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-refs.js +130 -0
  129. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-resources.js +114 -0
  130. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-semantic.js +121 -0
  131. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-session-plan.js +222 -0
  132. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-timeouts.js +68 -0
  133. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare.js +176 -1123
  134. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-analysis.js +191 -0
  135. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-confirmation.js +152 -0
  136. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-diagnostics.js +182 -0
  137. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-electron.js +150 -0
  138. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-lifecycle-contracts.js +1 -0
  139. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-lifecycle-phase-contracts.js +1 -0
  140. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-lifecycle-phase.js +115 -0
  141. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-lifecycle.js +256 -0
  142. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-managed-contracts.js +1 -0
  143. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-managed.js +256 -0
  144. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-native-phase-contracts.js +1 -0
  145. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-native-phase.js +93 -0
  146. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-native.js +113 -0
  147. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-navigation-contracts.js +1 -0
  148. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-navigation.js +316 -0
  149. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-ownership.js +28 -0
  150. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-page-phase-contracts.js +1 -0
  151. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-page-phase.js +142 -0
  152. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-presentation-contracts.js +1 -0
  153. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-presentation.js +333 -0
  154. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-publication-phase-contracts.js +1 -0
  155. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-publication-phase.js +71 -0
  156. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-publication.js +201 -0
  157. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-receipts.js +183 -0
  158. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-refs.js +200 -0
  159. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-tabs.js +142 -0
  160. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output.js +18 -968
  161. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prompt-guards.js +23 -13
  162. package/dist/extensions/agent-browser/lib/orchestration/browser-run/recording-receipt-reconciliation.js +198 -0
  163. package/dist/extensions/agent-browser/lib/orchestration/browser-run/recording-recovery-contracts.js +1 -0
  164. package/dist/extensions/agent-browser/lib/orchestration/browser-run/recording-recovery-presentation.js +154 -0
  165. package/dist/extensions/agent-browser/lib/orchestration/browser-run/recording-recovery.js +68 -151
  166. package/dist/extensions/agent-browser/lib/orchestration/browser-run/screenshot-capture.js +14 -0
  167. package/dist/extensions/agent-browser/lib/orchestration/browser-run/screenshot-observation.js +169 -46
  168. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-commands.js +130 -0
  169. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-electron.js +210 -0
  170. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-observations.js +61 -0
  171. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-outcomes.js +187 -0
  172. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-refs.js +171 -0
  173. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-tabs.js +228 -0
  174. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state.js +77 -765
  175. package/dist/extensions/agent-browser/lib/orchestration/browser-run/text-visibility-diagnostics.js +182 -0
  176. package/dist/extensions/agent-browser/lib/orchestration/browser-run/timeout-diagnostics.js +256 -0
  177. package/dist/extensions/agent-browser/lib/orchestration/browser-run/timeout-progress.js +108 -0
  178. package/dist/extensions/agent-browser/lib/orchestration/code-artifact-observation.js +39 -0
  179. package/dist/extensions/agent-browser/lib/orchestration/code-image-observation.js +119 -0
  180. package/dist/extensions/agent-browser/lib/orchestration/electron-host/branch.js +92 -0
  181. package/dist/extensions/agent-browser/lib/orchestration/electron-host/cleanup-result.js +58 -0
  182. package/dist/extensions/agent-browser/lib/orchestration/electron-host/cleanup.js +78 -0
  183. package/dist/extensions/agent-browser/lib/orchestration/electron-host/contracts.js +1 -0
  184. package/dist/extensions/agent-browser/lib/orchestration/electron-host/discovery.js +106 -0
  185. package/dist/extensions/agent-browser/lib/orchestration/electron-host/index.js +48 -821
  186. package/dist/extensions/agent-browser/lib/orchestration/electron-host/policy.js +86 -0
  187. package/dist/extensions/agent-browser/lib/orchestration/electron-host/probe-collection.js +69 -0
  188. package/dist/extensions/agent-browser/lib/orchestration/electron-host/probe-data.js +167 -0
  189. package/dist/extensions/agent-browser/lib/orchestration/electron-host/probe-presentation.js +164 -0
  190. package/dist/extensions/agent-browser/lib/orchestration/electron-host/probe.js +161 -0
  191. package/dist/extensions/agent-browser/lib/orchestration/electron-host/status.js +165 -0
  192. package/dist/extensions/agent-browser/lib/orchestration/execution-queue.js +21 -9
  193. package/dist/extensions/agent-browser/lib/orchestration/extension-artifact-preflight.js +211 -0
  194. package/dist/extensions/agent-browser/lib/orchestration/extension-artifacts.js +23 -0
  195. package/dist/extensions/agent-browser/lib/orchestration/extension-attachment-replay.js +99 -0
  196. package/dist/extensions/agent-browser/lib/orchestration/extension-branch-restore.js +275 -0
  197. package/dist/extensions/agent-browser/lib/orchestration/extension-code.js +280 -0
  198. package/dist/extensions/agent-browser/lib/orchestration/extension-command-admission.js +303 -0
  199. package/dist/extensions/agent-browser/lib/orchestration/extension-command-output.js +36 -0
  200. package/dist/extensions/agent-browser/lib/orchestration/extension-command-result.js +335 -0
  201. package/dist/extensions/agent-browser/lib/orchestration/extension-command-run.js +227 -0
  202. package/dist/extensions/agent-browser/lib/orchestration/extension-command-state.js +1 -0
  203. package/dist/extensions/agent-browser/lib/orchestration/extension-electron-ownership.js +204 -0
  204. package/dist/extensions/agent-browser/lib/orchestration/extension-execution-locks.js +139 -0
  205. package/dist/extensions/agent-browser/lib/orchestration/extension-execution-queue.js +24 -0
  206. package/dist/extensions/agent-browser/lib/orchestration/extension-host-coordination.js +98 -0
  207. package/dist/extensions/agent-browser/lib/orchestration/extension-host-run.js +295 -0
  208. package/dist/extensions/agent-browser/lib/orchestration/extension-intent-replay.js +41 -0
  209. package/dist/extensions/agent-browser/lib/orchestration/extension-invocation.js +7 -0
  210. package/dist/extensions/agent-browser/lib/orchestration/extension-lifecycle.js +102 -0
  211. package/dist/extensions/agent-browser/lib/orchestration/extension-managed-ownership.js +133 -0
  212. package/dist/extensions/agent-browser/lib/orchestration/extension-observation.js +120 -0
  213. package/dist/extensions/agent-browser/lib/orchestration/extension-prompt.js +180 -0
  214. package/dist/extensions/agent-browser/lib/orchestration/extension-recording.js +290 -0
  215. package/dist/extensions/agent-browser/lib/orchestration/extension-resource-contracts.js +1 -0
  216. package/dist/extensions/agent-browser/lib/orchestration/extension-resource-replay.js +269 -0
  217. package/dist/extensions/agent-browser/lib/orchestration/extension-result-state.js +113 -0
  218. package/dist/extensions/agent-browser/lib/orchestration/extension-runtime.js +146 -0
  219. package/dist/extensions/agent-browser/lib/orchestration/extension-script-leases.js +58 -0
  220. package/dist/extensions/agent-browser/lib/orchestration/extension-tool-boundary.js +62 -0
  221. package/dist/extensions/agent-browser/lib/orchestration/extension-version-check.js +54 -0
  222. package/dist/extensions/agent-browser/lib/orchestration/input-plan-types.js +1 -0
  223. package/dist/extensions/agent-browser/lib/orchestration/input-plan.js +261 -185
  224. package/dist/extensions/agent-browser/lib/orchestration/input-redaction.js +62 -0
  225. package/dist/extensions/agent-browser/lib/orchestration/native-config.js +144 -0
  226. package/dist/extensions/agent-browser/lib/orchestration/native-root-launch.js +77 -0
  227. package/dist/extensions/agent-browser/lib/orchestration/native-session-defaults.js +210 -157
  228. package/dist/extensions/agent-browser/lib/orchestration/operation-paths.js +124 -58
  229. package/dist/extensions/agent-browser/lib/orchestration/output-file.js +197 -99
  230. package/dist/extensions/agent-browser/lib/orchestration/script-mode.js +199 -96
  231. package/dist/extensions/agent-browser/lib/owned-managed-session-context.js +55 -0
  232. package/dist/extensions/agent-browser/lib/page-target-batch.js +118 -0
  233. package/dist/extensions/agent-browser/lib/page-target-guards.js +50 -0
  234. package/dist/extensions/agent-browser/lib/page-target-navigation.js +104 -0
  235. package/dist/extensions/agent-browser/lib/page-target-validation.js +55 -246
  236. package/dist/extensions/agent-browser/lib/parsing.js +13 -4
  237. package/dist/extensions/agent-browser/lib/pi-tool-rendering.js +133 -68
  238. package/dist/extensions/agent-browser/lib/playbook.js +16 -12
  239. package/dist/extensions/agent-browser/lib/process-child.js +284 -0
  240. package/dist/extensions/agent-browser/lib/process-environment.js +13 -6
  241. package/dist/extensions/agent-browser/lib/process-errors.js +23 -0
  242. package/dist/extensions/agent-browser/lib/process-identity.js +47 -15
  243. package/dist/extensions/agent-browser/lib/process-socket-storage.js +256 -0
  244. package/dist/extensions/agent-browser/lib/process-stdout.js +74 -0
  245. package/dist/extensions/agent-browser/lib/process.js +145 -536
  246. package/dist/extensions/agent-browser/lib/prompt-artifacts.js +287 -0
  247. package/dist/extensions/agent-browser/lib/prompt-policy.js +15 -194
  248. package/dist/extensions/agent-browser/lib/read-command.js +41 -0
  249. package/dist/extensions/agent-browser/lib/read-confirmation.js +131 -68
  250. package/dist/extensions/agent-browser/lib/recording-reservations.js +118 -45
  251. package/dist/extensions/agent-browser/lib/redaction-fields.js +75 -0
  252. package/dist/extensions/agent-browser/lib/redaction-json.js +149 -0
  253. package/dist/extensions/agent-browser/lib/redaction-url.js +88 -0
  254. package/dist/extensions/agent-browser/lib/results/action-contracts.js +1 -0
  255. package/dist/extensions/agent-browser/lib/results/action-recommendations.js +28 -271
  256. package/dist/extensions/agent-browser/lib/results/artifact-contracts.js +1 -0
  257. package/dist/extensions/agent-browser/lib/results/artifact-manifest-validation.js +133 -0
  258. package/dist/extensions/agent-browser/lib/results/artifact-manifest.js +96 -94
  259. package/dist/extensions/agent-browser/lib/results/artifact-recommendations.js +73 -0
  260. package/dist/extensions/agent-browser/lib/results/categories.js +111 -54
  261. package/dist/extensions/agent-browser/lib/results/confirmation.js +29 -13
  262. package/dist/extensions/agent-browser/lib/results/editable-ref-evidence.js +62 -27
  263. package/dist/extensions/agent-browser/lib/results/electron-recommendations.js +83 -0
  264. package/dist/extensions/agent-browser/lib/results/envelope-decoding.js +48 -0
  265. package/dist/extensions/agent-browser/lib/results/envelope.js +90 -67
  266. package/dist/extensions/agent-browser/lib/results/evidence-contracts.js +1 -0
  267. package/dist/extensions/agent-browser/lib/results/failure-recommendations.js +180 -0
  268. package/dist/extensions/agent-browser/lib/results/network-routes.js +86 -45
  269. package/dist/extensions/agent-browser/lib/results/network.js +35 -12
  270. package/dist/extensions/agent-browser/lib/results/next-actions.js +49 -19
  271. package/dist/extensions/agent-browser/lib/results/presentation/artifact-files.js +320 -0
  272. package/dist/extensions/agent-browser/lib/results/presentation/artifact-format.js +138 -0
  273. package/dist/extensions/agent-browser/lib/results/presentation/artifact-images.js +113 -0
  274. package/dist/extensions/agent-browser/lib/results/presentation/artifact-verification.js +145 -0
  275. package/dist/extensions/agent-browser/lib/results/presentation/artifacts.js +99 -555
  276. package/dist/extensions/agent-browser/lib/results/presentation/batch-contracts.js +1 -0
  277. package/dist/extensions/agent-browser/lib/results/presentation/batch-recording.js +118 -0
  278. package/dist/extensions/agent-browser/lib/results/presentation/batch-redaction.js +68 -0
  279. package/dist/extensions/agent-browser/lib/results/presentation/batch-rendering.js +135 -0
  280. package/dist/extensions/agent-browser/lib/results/presentation/batch-step.js +227 -0
  281. package/dist/extensions/agent-browser/lib/results/presentation/batch-summary.js +91 -0
  282. package/dist/extensions/agent-browser/lib/results/presentation/batch.js +91 -460
  283. package/dist/extensions/agent-browser/lib/results/presentation/browser-profile-recovery.js +9 -5
  284. package/dist/extensions/agent-browser/lib/results/presentation/command-presenters.js +216 -0
  285. package/dist/extensions/agent-browser/lib/results/presentation/common.js +26 -9
  286. package/dist/extensions/agent-browser/lib/results/presentation/content.js +86 -29
  287. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-a11y.js +67 -0
  288. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-health.js +79 -0
  289. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-identity.js +199 -0
  290. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-logs.js +75 -0
  291. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-network-actions.js +216 -0
  292. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-network.js +124 -0
  293. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-redaction.js +64 -0
  294. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-storage.js +209 -0
  295. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-stream.js +69 -0
  296. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-summary.js +222 -0
  297. package/dist/extensions/agent-browser/lib/results/presentation/diagnostics.js +103 -1052
  298. package/dist/extensions/agent-browser/lib/results/presentation/early-result.js +70 -0
  299. package/dist/extensions/agent-browser/lib/results/presentation/errors.js +130 -60
  300. package/dist/extensions/agent-browser/lib/results/presentation/input-contracts.js +1 -0
  301. package/dist/extensions/agent-browser/lib/results/presentation/large-output.js +60 -145
  302. package/dist/extensions/agent-browser/lib/results/presentation/navigation.js +147 -88
  303. package/dist/extensions/agent-browser/lib/results/presentation/notices.js +75 -0
  304. package/dist/extensions/agent-browser/lib/results/presentation/observation-contracts.js +1 -0
  305. package/dist/extensions/agent-browser/lib/results/presentation/observation-rendering.js +127 -0
  306. package/dist/extensions/agent-browser/lib/results/presentation/outcomes.js +120 -0
  307. package/dist/extensions/agent-browser/lib/results/presentation/output-completion.js +77 -0
  308. package/dist/extensions/agent-browser/lib/results/presentation/output-spill.js +51 -0
  309. package/dist/extensions/agent-browser/lib/results/presentation/registry.js +116 -240
  310. package/dist/extensions/agent-browser/lib/results/presentation/semantic-action.js +35 -21
  311. package/dist/extensions/agent-browser/lib/results/presentation/skills.js +104 -73
  312. package/dist/extensions/agent-browser/lib/results/presentation/source.js +109 -0
  313. package/dist/extensions/agent-browser/lib/results/presentation.js +17 -261
  314. package/dist/extensions/agent-browser/lib/results/recommendation-contracts.js +1 -0
  315. package/dist/extensions/agent-browser/lib/results/recording.js +52 -14
  316. package/dist/extensions/agent-browser/lib/results/recovery-actions.js +14 -5
  317. package/dist/extensions/agent-browser/lib/results/recovery-next-actions.js +30 -22
  318. package/dist/extensions/agent-browser/lib/results/selector-recovery-target.js +83 -0
  319. package/dist/extensions/agent-browser/lib/results/selector-recovery.js +119 -119
  320. package/dist/extensions/agent-browser/lib/results/snapshot-compact.js +266 -0
  321. package/dist/extensions/agent-browser/lib/results/snapshot-content.js +32 -0
  322. package/dist/extensions/agent-browser/lib/results/snapshot-high-value-controls.js +104 -71
  323. package/dist/extensions/agent-browser/lib/results/snapshot-refs.js +31 -11
  324. package/dist/extensions/agent-browser/lib/results/snapshot-segments.js +125 -66
  325. package/dist/extensions/agent-browser/lib/results/snapshot-spill.js +26 -7
  326. package/dist/extensions/agent-browser/lib/results/snapshot.js +28 -248
  327. package/dist/extensions/agent-browser/lib/results/text.js +16 -5
  328. package/dist/extensions/agent-browser/lib/runtime-args-validation.js +133 -0
  329. package/dist/extensions/agent-browser/lib/runtime-compatibility.js +81 -0
  330. package/dist/extensions/agent-browser/lib/runtime-contracts.js +1 -0
  331. package/dist/extensions/agent-browser/lib/runtime-redaction.js +118 -0
  332. package/dist/extensions/agent-browser/lib/runtime-replay-events.js +144 -0
  333. package/dist/extensions/agent-browser/lib/runtime-session-identity.js +76 -0
  334. package/dist/extensions/agent-browser/lib/runtime-session-plan.js +114 -0
  335. package/dist/extensions/agent-browser/lib/runtime-session-replay.js +123 -0
  336. package/dist/extensions/agent-browser/lib/runtime-tab-correction.js +65 -0
  337. package/dist/extensions/agent-browser/lib/runtime-timeouts.js +28 -0
  338. package/dist/extensions/agent-browser/lib/runtime.js +137 -1041
  339. package/dist/extensions/agent-browser/lib/session-identity.js +51 -0
  340. package/dist/extensions/agent-browser/lib/session-page-observation.js +357 -0
  341. package/dist/extensions/agent-browser/lib/session-page-state.js +178 -333
  342. package/dist/extensions/agent-browser/lib/session-page-types.js +1 -0
  343. package/dist/extensions/agent-browser/lib/temp-artifact-budget.js +78 -0
  344. package/dist/extensions/agent-browser/lib/temp-mutation-queue.js +7 -0
  345. package/dist/extensions/agent-browser/lib/temp-root-ownership.js +234 -0
  346. package/dist/extensions/agent-browser/lib/temp-root.js +207 -0
  347. package/dist/extensions/agent-browser/lib/temp.js +33 -446
  348. package/dist/extensions/agent-browser/lib/tool-surface.js +94 -24
  349. package/dist/extensions/agent-browser/lib/upstream-version.js +3 -2
  350. package/dist/extensions/agent-browser/lib/web-search-providers.js +229 -0
  351. package/dist/extensions/agent-browser/lib/web-search-request.js +108 -0
  352. package/dist/extensions/agent-browser/lib/web-search-results.js +281 -0
  353. package/dist/extensions/agent-browser/lib/web-search-schema.js +82 -0
  354. package/dist/extensions/agent-browser/lib/web-search.js +109 -617
  355. package/dist/extensions/agent-browser/lib/webmcp-observation.js +13 -6
  356. package/dist/extensions/agent-browser/lib/windows-stock-launcher.js +63 -37
  357. package/dist/extensions/agent-browser/script-worker.js +80 -43
  358. package/dist/scripts/agent-browser-target.mjs +4 -2
  359. package/docs/ARCHITECTURE.md +17 -5
  360. package/docs/CODE_QUALITY.md +242 -0
  361. package/docs/COMMAND_REFERENCE.md +251 -220
  362. package/docs/ELECTRON.md +53 -44
  363. package/docs/RELEASE.md +18 -15
  364. package/docs/REQUIREMENTS.md +1 -0
  365. package/docs/SUPPORT_MATRIX.md +76 -75
  366. package/docs/TOOL_CONTRACT.md +145 -116
  367. package/docs/platform-smoke.md +5 -5
  368. package/package.json +143 -120
  369. package/scripts/agent-browser-capability-baseline.mjs +361 -957
  370. package/scripts/agent-browser-target.mjs +6 -2
  371. package/scripts/build.mjs +37 -8
  372. package/scripts/capability-core-commands.mjs +193 -0
  373. package/scripts/capability-options.mjs +283 -0
  374. package/scripts/capability-samples.mjs +133 -0
  375. package/scripts/capability-section.mjs +11 -0
  376. package/scripts/config.mjs +213 -114
  377. package/scripts/convert-browser-session.mjs +30 -9
  378. package/scripts/doctor-sources.mjs +195 -0
  379. package/scripts/doctor.mjs +92 -247
  380. package/scripts/platform-smoke/artifacts.mjs +38 -11
  381. package/scripts/platform-smoke/commands.mjs +104 -0
  382. package/scripts/platform-smoke/crabbox-runner.mjs +167 -80
  383. package/scripts/platform-smoke/doctor-support.mjs +157 -0
  384. package/scripts/platform-smoke/doctor-windows.mjs +230 -0
  385. package/scripts/platform-smoke/doctor.mjs +212 -320
  386. package/scripts/platform-smoke/lease-evidence.mjs +134 -0
  387. package/scripts/platform-smoke/suite-checks.mjs +98 -0
  388. package/scripts/platform-smoke/suite-evidence.mjs +281 -0
  389. package/scripts/platform-smoke/targets.mjs +158 -472
  390. package/scripts/platform-smoke.mjs +55 -40
  391. 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
  }