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
@@ -0,0 +1,54 @@
1
+ import { redactSensitiveText } from "../runtime.js";
2
+ import { runAgentBrowserProcess } from "../process.js";
3
+ import { getAgentBrowserProcessEnvironment } from "../process-environment.js";
4
+ import { MINIMUM_AGENT_BROWSER_VERSION, SUPPORTED_AGENT_BROWSER_VERSION_LABEL, TARGET_AGENT_BROWSER_VERSION, getAgentBrowserVersionValidationError, parseAgentBrowserVersionOutput, } from "../upstream-version.js";
5
+ function unavailableProbe(probe) {
6
+ const error = probe.spawnError;
7
+ return ((error !== undefined && "code" in error && error.code === "ENOENT") ||
8
+ probe.exitCode === 127 ||
9
+ probe.aborted);
10
+ }
11
+ function probeVersion(probe) {
12
+ if (probe.spawnError || probe.exitCode !== 0) {
13
+ const stderr = probe.stderr.trim();
14
+ const detail = redactSensitiveText(probe.spawnError?.message ?? (stderr !== "" ? stderr : `exit ${probe.exitCode}`));
15
+ return {
16
+ error: `agent-browser --version could not be validated (${detail}). Run pi-agent-browser-doctor before browser-backed calls.`,
17
+ };
18
+ }
19
+ return {
20
+ observedVersion: parseAgentBrowserVersionOutput(probe.stdout),
21
+ error: getAgentBrowserVersionValidationError(probe.stdout),
22
+ };
23
+ }
24
+ export async function validateUpstreamVersion(cache, cwd, signal) {
25
+ const env = getAgentBrowserProcessEnvironment();
26
+ const key = `${cwd}\0${env.PATH ?? env.Path ?? ""}`;
27
+ if (cache.has(key)) {
28
+ return undefined;
29
+ }
30
+ const probe = await runAgentBrowserProcess({ args: ["--version"], cwd, signal, timeoutMs: 5000 });
31
+ if (unavailableProbe(probe)) {
32
+ return undefined;
33
+ }
34
+ const { error, observedVersion } = probeVersion(probe);
35
+ if (error === undefined || error === "") {
36
+ cache.add(key);
37
+ return undefined;
38
+ }
39
+ return {
40
+ content: [{ type: "text", text: error }],
41
+ details: {
42
+ expectedVersion: TARGET_AGENT_BROWSER_VERSION,
43
+ failureCategory: "validation-error",
44
+ observedVersion,
45
+ resultCategory: "failure",
46
+ minimumSupportedVersion: MINIMUM_AGENT_BROWSER_VERSION,
47
+ versionValidation: {
48
+ expected: SUPPORTED_AGENT_BROWSER_VERSION_LABEL,
49
+ observed: observedVersion,
50
+ },
51
+ },
52
+ isError: true,
53
+ };
54
+ }
@@ -1,55 +1,19 @@
1
1
  import { parseArgvDescriptor } from "../argv-descriptor.js";
2
+ import { isRecord } from "../parsing.js";
3
+ import { isStringArray } from "../input-modes/shared.js";
2
4
  import { normalizeUrlLessOpen } from "./batch-stdin.js";
3
- import { isPlainTextInspectionArgs, validateToolArgs, redactInvocationArgs, redactSensitiveText } from "../runtime.js";
5
+ import { isPlainTextInspectionArgs, validateToolArgs, redactInvocationArgs } from "../runtime.js";
4
6
  import { buildAgentBrowserResultCategoryDetails } from "../results/categories.js";
5
7
  import { compileAgentBrowserElectron } from "../input-modes/electron.js";
6
8
  import { compileAgentBrowserQaPreset } from "../input-modes/job.js";
7
- import { compileAgentBrowserNetworkSourceLookup, compileAgentBrowserSourceLookup, redactNetworkSourceLookupArgs, redactNetworkSourceLookupUrl } from "../input-modes/lookups.js";
9
+ import { compileAgentBrowserNetworkSourceLookup, compileAgentBrowserSourceLookup, } from "../input-modes/lookups.js";
8
10
  import { compileAgentBrowserSemanticAction } from "../input-modes/semantic-action.js";
9
- function redactCompiledElectron(compiled) {
10
- if (!compiled)
11
- return undefined;
12
- if (compiled.action === "list") {
13
- return { ...compiled, query: compiled.query ? redactSensitiveText(compiled.query) : undefined };
14
- }
15
- if (compiled.action === "launch") {
16
- return { ...compiled, appArgs: compiled.appArgs ? redactInvocationArgs(compiled.appArgs) : undefined };
17
- }
18
- return { ...compiled };
19
- }
20
- function redactCompiledJob(compiled) {
21
- const redactedSteps = compiled?.steps.map((step) => ({ ...step, args: redactInvocationArgs(step.args) }));
22
- return compiled && redactedSteps
23
- ? { ...compiled, stdin: JSON.stringify(redactedSteps.map((step) => step.args)), steps: redactedSteps }
24
- : undefined;
25
- }
26
- function redactCompiledSourceLookup(compiled) {
27
- const redactedSteps = compiled?.steps.map((step) => ({ ...step, args: redactInvocationArgs(step.args) }));
28
- return compiled && redactedSteps
29
- ? { ...compiled, stdin: JSON.stringify(redactedSteps.map((step) => step.args)), steps: redactedSteps }
30
- : undefined;
31
- }
32
- function redactCompiledNetworkSourceLookup(compiled) {
33
- const redactedSteps = compiled?.steps.map((step) => ({ ...step, args: redactNetworkSourceLookupArgs(step.args) }));
34
- return compiled && redactedSteps
35
- ? {
36
- ...compiled,
37
- args: redactNetworkSourceLookupArgs(compiled.args),
38
- query: {
39
- ...compiled.query,
40
- filter: redactNetworkSourceLookupUrl(compiled.query.filter),
41
- url: redactNetworkSourceLookupUrl(compiled.query.url),
42
- },
43
- stdin: JSON.stringify(redactedSteps.map((step) => step.args)),
44
- steps: redactedSteps,
45
- }
46
- : undefined;
47
- }
11
+ import { redactCompiledElectron, redactCompiledJob, redactCompiledNetworkSourceLookup, redactCompiledSourceLookup, } from "./input-redaction.js";
48
12
  function normalizeExplicitEvalStdinArgs(args, stdin) {
49
13
  if (stdin !== undefined) {
50
14
  return { args, stdin };
51
15
  }
52
- const descriptor = parseArgvDescriptor(args);
16
+ const descriptor = parseArgvDescriptor([...args]);
53
17
  if (descriptor.commandInfo.command !== "eval") {
54
18
  return { args, stdin };
55
19
  }
@@ -58,164 +22,276 @@ function normalizeExplicitEvalStdinArgs(args, stdin) {
58
22
  return { args, stdin };
59
23
  }
60
24
  const commandStartIndex = args.length - descriptor.commandTokens.length;
61
- const stdinValue = descriptor.commandTokens.slice(stdinIndex + 1).join(" ");
62
25
  return {
63
- args: [...args.slice(0, commandStartIndex), ...descriptor.commandTokens.slice(0, stdinIndex + 1)],
64
- stdin: stdinValue,
26
+ args: [
27
+ ...args.slice(0, commandStartIndex),
28
+ ...descriptor.commandTokens.slice(0, stdinIndex + 1),
29
+ ],
30
+ stdin: descriptor.commandTokens.slice(stdinIndex + 1).join(" "),
65
31
  };
66
32
  }
67
- export function resolveAgentBrowserInput(options) {
68
- const { getBatchPreflightValidationError, params } = options;
69
- const semanticActionResult = params.semanticAction === undefined ? {} : compileAgentBrowserSemanticAction(params.semanticAction);
70
- const qaResult = params.qa === undefined ? {} : compileAgentBrowserQaPreset(params.qa);
71
- const sourceLookupResult = params.sourceLookup === undefined ? {} : compileAgentBrowserSourceLookup(params.sourceLookup);
72
- const networkSourceLookupResult = params.networkSourceLookup === undefined ? {} : compileAgentBrowserNetworkSourceLookup(params.networkSourceLookup);
73
- const electronResult = params.electron === undefined ? {} : compileAgentBrowserElectron(params.electron);
74
- const hasExplicitArgs = Array.isArray(params.args);
75
- const explicitInputModes = [
76
- hasExplicitArgs,
77
- Boolean(semanticActionResult.compiled),
78
- Boolean(qaResult.compiled),
79
- Boolean(sourceLookupResult.compiled),
80
- Boolean(networkSourceLookupResult.compiled),
81
- Boolean(electronResult.compiled),
82
- ].filter(Boolean).length;
83
- const inputModeError = explicitInputModes !== 1
84
- ? "Provide exactly one of args, semanticAction, qa, sourceLookup, networkSourceLookup, or electron."
85
- : undefined;
86
- const compiledSemanticAction = semanticActionResult.compiled;
87
- const compiledQaPreset = qaResult.compiled;
88
- const compiledSourceLookup = sourceLookupResult.compiled;
89
- const compiledNetworkSourceLookup = networkSourceLookupResult.compiled;
90
- const compiledElectron = electronResult.compiled;
91
- const compiledJob = compiledQaPreset;
92
- const compiledGeneratedBatch = compiledNetworkSourceLookup ?? compiledSourceLookup ?? compiledJob;
93
- const normalizedExplicitArgs = normalizeExplicitEvalStdinArgs(params.args ?? [], params.stdin);
94
- const toolArgs = compiledElectron ? [] : compiledSemanticAction?.args ?? compiledGeneratedBatch?.args ?? normalizedExplicitArgs.args;
95
- const toolStdin = compiledGeneratedBatch?.stdin ?? normalizedExplicitArgs.stdin;
96
- const redactedArgs = redactInvocationArgs(toolArgs);
97
- const generatedStdinError = params.stdin !== undefined
98
- ? compiledGeneratedBatch
99
- ? "Do not provide stdin with qa, sourceLookup, or networkSourceLookup; those modes generate their own batch stdin."
100
- : compiledElectron
101
- ? "Do not provide stdin with electron; electron mode is host-only or manages its own input."
102
- : undefined
103
- : undefined;
104
- const outputPathError = params.outputPath !== undefined && (typeof params.outputPath !== "string" || params.outputPath.trim().length === 0)
105
- ? "outputPath must be a non-empty string when provided."
106
- : undefined;
107
- const timeoutMsError = params.timeoutMs !== undefined && (typeof params.timeoutMs !== "number" || !Number.isSafeInteger(params.timeoutMs) || params.timeoutMs <= 0)
108
- ? "timeoutMs must be a positive integer when provided."
109
- : compiledElectron && params.timeoutMs !== undefined
110
- ? compiledElectron.action === "list"
111
- ? "electron.list has no configurable timeout; remove top-level timeoutMs."
112
- : "Use electron.timeoutMs for this action; top-level timeoutMs applies only to browser CLI subprocess calls."
113
- : undefined;
114
- const attachedQaSessionError = compiledQaPreset?.checks.attached
115
- ? params.sessionMode === "fresh"
116
- ? "qa.attached cannot be used with sessionMode=fresh; attach or launch a session first, then run qa.attached with the current session."
117
- : undefined
118
- : undefined;
119
- const validationError = semanticActionResult.error
120
- ?? qaResult.error
121
- ?? sourceLookupResult.error
122
- ?? networkSourceLookupResult.error
123
- ?? electronResult.error
124
- ?? inputModeError
125
- ?? generatedStdinError
126
- ?? outputPathError
127
- ?? timeoutMsError
128
- ?? attachedQaSessionError
129
- ?? (compiledElectron ? undefined : validateToolArgs(toolArgs) ?? getBatchPreflightValidationError(toolArgs, toolStdin));
130
- const redactedCompiledJob = redactCompiledJob(compiledJob);
131
- const redactedCompiledSemanticAction = compiledSemanticAction
132
- ? { ...compiledSemanticAction, args: redactInvocationArgs(compiledSemanticAction.args) }
133
- : undefined;
134
- const attemptedKind = compiledElectron
135
- ? "electron"
136
- : compiledNetworkSourceLookup
137
- ? "networkSourceLookup"
138
- : compiledSourceLookup
139
- ? "sourceLookup"
140
- : compiledQaPreset
141
- ? "qa"
142
- : compiledSemanticAction
143
- ? "semanticAction"
144
- : hasExplicitArgs
145
- ? "args"
146
- : undefined;
147
- const redactedCompiledElectron = redactCompiledElectron(compiledElectron);
148
- const redactedCompiledNetworkSourceLookup = redactCompiledNetworkSourceLookup(compiledNetworkSourceLookup);
149
- const redactedCompiledQaPreset = compiledQaPreset && redactedCompiledJob ? { ...redactedCompiledJob, checks: compiledQaPreset.checks } : undefined;
150
- const redactedCompiledSourceLookup = redactCompiledSourceLookup(compiledSourceLookup);
151
- const normalized = validationError || isPlainTextInspectionArgs(toolArgs) ? { args: toolArgs, stdin: toolStdin } : normalizeUrlLessOpen(toolArgs, toolStdin);
152
- const resolvedBase = { redactedArgs, toolArgs: normalized.args, toolStdin: normalized.stdin };
153
- if (validationError) {
33
+ function fieldShapeError(params) {
34
+ if (params.args !== undefined && !isStringArray(params.args)) {
35
+ return "args must be an array of strings when provided.";
36
+ }
37
+ if (params.stdin !== undefined && typeof params.stdin !== "string") {
38
+ return "stdin must be a string when provided.";
39
+ }
40
+ return undefined;
41
+ }
42
+ function outputPathError(value) {
43
+ if (value !== undefined && (typeof value !== "string" || value.trim().length === 0)) {
44
+ return "outputPath must be a non-empty string when provided.";
45
+ }
46
+ return undefined;
47
+ }
48
+ /** Compiles all requested modes once, then validates selection before exposing executable input. */
49
+ class BrowserInputCompiler {
50
+ params;
51
+ preflight;
52
+ semanticAction;
53
+ qa;
54
+ sourceLookup;
55
+ networkSourceLookup;
56
+ electron;
57
+ modes;
58
+ constructor(params, preflight) {
59
+ this.params = params;
60
+ this.preflight = preflight;
61
+ this.semanticAction =
62
+ params.semanticAction === undefined
63
+ ? {}
64
+ : compileAgentBrowserSemanticAction(params.semanticAction);
65
+ this.qa = params.qa === undefined ? {} : compileAgentBrowserQaPreset(params.qa);
66
+ this.sourceLookup =
67
+ params.sourceLookup === undefined ? {} : compileAgentBrowserSourceLookup(params.sourceLookup);
68
+ this.networkSourceLookup =
69
+ params.networkSourceLookup === undefined
70
+ ? {}
71
+ : compileAgentBrowserNetworkSourceLookup(params.networkSourceLookup);
72
+ this.electron =
73
+ params.electron === undefined ? {} : compileAgentBrowserElectron(params.electron);
74
+ this.modes = this.projectModes();
75
+ }
76
+ projectModes() {
77
+ const compiledJob = this.qa.compiled;
78
+ const redactedCompiledJob = redactCompiledJob(compiledJob);
79
+ const compiledSemanticAction = this.semanticAction.compiled;
154
80
  return {
155
- ...resolvedBase,
156
- attemptedKind,
157
- compiledElectron,
158
- compiledGeneratedBatch,
81
+ compiledElectron: this.electron.compiled,
82
+ compiledGeneratedBatch: this.networkSourceLookup.compiled ?? this.sourceLookup.compiled ?? compiledJob,
159
83
  compiledJob,
160
- compiledNetworkSourceLookup,
161
- compiledQaPreset,
84
+ compiledNetworkSourceLookup: this.networkSourceLookup.compiled,
85
+ compiledQaPreset: this.qa.compiled,
162
86
  compiledSemanticAction,
163
- compiledSourceLookup,
164
- kind: "invalid",
165
- redactedCompiledElectron,
87
+ compiledSourceLookup: this.sourceLookup.compiled,
88
+ redactedCompiledElectron: redactCompiledElectron(this.electron.compiled),
166
89
  redactedCompiledJob,
167
- redactedCompiledNetworkSourceLookup,
168
- redactedCompiledQaPreset,
169
- redactedCompiledSemanticAction,
170
- redactedCompiledSourceLookup,
171
- status: "invalid",
172
- validationError,
90
+ redactedCompiledNetworkSourceLookup: redactCompiledNetworkSourceLookup(this.networkSourceLookup.compiled),
91
+ redactedCompiledQaPreset: compiledJob !== undefined && redactedCompiledJob !== undefined
92
+ ? { ...redactedCompiledJob, checks: compiledJob.checks }
93
+ : undefined,
94
+ redactedCompiledSemanticAction: compiledSemanticAction === undefined
95
+ ? undefined
96
+ : {
97
+ ...compiledSemanticAction,
98
+ args: redactInvocationArgs([...compiledSemanticAction.args]),
99
+ },
100
+ redactedCompiledSourceLookup: redactCompiledSourceLookup(this.sourceLookup.compiled),
173
101
  };
174
102
  }
175
- if (compiledElectron && redactedCompiledElectron) {
176
- return { ...resolvedBase, compiledElectron, kind: "electron", redactedCompiledElectron, status: "valid" };
103
+ attemptedKind() {
104
+ if (this.electron.compiled !== undefined) {
105
+ return "electron";
106
+ }
107
+ if (this.networkSourceLookup.compiled !== undefined) {
108
+ return "networkSourceLookup";
109
+ }
110
+ if (this.sourceLookup.compiled !== undefined) {
111
+ return "sourceLookup";
112
+ }
113
+ if (this.qa.compiled !== undefined) {
114
+ return "qa";
115
+ }
116
+ if (this.semanticAction.compiled !== undefined) {
117
+ return "semanticAction";
118
+ }
119
+ return Array.isArray(this.params.args) ? "args" : undefined;
177
120
  }
178
- if (compiledNetworkSourceLookup && redactedCompiledNetworkSourceLookup) {
179
- return {
180
- ...resolvedBase,
181
- compiledGeneratedBatch: compiledNetworkSourceLookup,
182
- compiledNetworkSourceLookup,
183
- kind: "networkSourceLookup",
184
- redactedCompiledNetworkSourceLookup,
185
- status: "valid",
186
- };
121
+ inputModeError() {
122
+ const selected = [
123
+ Array.isArray(this.params.args),
124
+ this.semanticAction.compiled !== undefined,
125
+ this.qa.compiled !== undefined,
126
+ this.sourceLookup.compiled !== undefined,
127
+ this.networkSourceLookup.compiled !== undefined,
128
+ this.electron.compiled !== undefined,
129
+ ].filter((active) => active).length;
130
+ return selected === 1
131
+ ? undefined
132
+ : "Provide exactly one of args, semanticAction, qa, sourceLookup, networkSourceLookup, or electron.";
187
133
  }
188
- if (compiledSourceLookup && redactedCompiledSourceLookup) {
189
- return {
190
- ...resolvedBase,
191
- compiledGeneratedBatch: compiledSourceLookup,
192
- compiledSourceLookup,
193
- kind: "sourceLookup",
194
- redactedCompiledSourceLookup,
195
- status: "valid",
196
- };
134
+ generatedStdinError() {
135
+ if (this.params.stdin === undefined) {
136
+ return undefined;
137
+ }
138
+ if (this.modes.compiledGeneratedBatch !== undefined) {
139
+ return "Do not provide stdin with qa, sourceLookup, or networkSourceLookup; those modes generate their own batch stdin.";
140
+ }
141
+ return this.electron.compiled === undefined
142
+ ? undefined
143
+ : "Do not provide stdin with electron; electron mode is host-only or manages its own input.";
197
144
  }
198
- if (compiledQaPreset && redactedCompiledJob && redactedCompiledQaPreset) {
145
+ timeoutError() {
146
+ const value = this.params.timeoutMs;
147
+ if (value === undefined) {
148
+ return undefined;
149
+ }
150
+ if (typeof value !== "number" || !Number.isSafeInteger(value) || value <= 0) {
151
+ return "timeoutMs must be a positive integer when provided.";
152
+ }
153
+ if (this.electron.compiled === undefined) {
154
+ return undefined;
155
+ }
156
+ return this.electron.compiled.action === "list"
157
+ ? "electron.list has no configurable timeout; remove top-level timeoutMs."
158
+ : "Use electron.timeoutMs for this action; top-level timeoutMs applies only to browser CLI subprocess calls.";
159
+ }
160
+ attachedQaError() {
161
+ return this.qa.compiled?.checks.attached === true && this.params.sessionMode === "fresh"
162
+ ? "qa.attached cannot be used with sessionMode=fresh; attach or launch a session first, then run qa.attached with the current session."
163
+ : undefined;
164
+ }
165
+ validationError(args, stdin) {
166
+ const compilationError = this.compilationError();
167
+ const shapeError = fieldShapeError(this.params);
168
+ const modeError = this.inputModeError() ?? this.generatedStdinError();
169
+ const optionsError = this.optionsError();
170
+ const error = compilationError ?? shapeError ?? modeError ?? optionsError;
171
+ if (error !== undefined) {
172
+ return error;
173
+ }
174
+ return this.electron.compiled === undefined
175
+ ? (validateToolArgs([...args]) ?? this.preflight(args, stdin))
176
+ : undefined;
177
+ }
178
+ compilationError() {
179
+ return (this.semanticAction.error ??
180
+ this.qa.error ??
181
+ this.sourceLookup.error ??
182
+ this.networkSourceLookup.error ??
183
+ this.electron.error);
184
+ }
185
+ optionsError() {
186
+ return outputPathError(this.params.outputPath) ?? this.timeoutError() ?? this.attachedQaError();
187
+ }
188
+ validInput(base) {
189
+ const { compiledElectron, compiledSemanticAction, redactedCompiledElectron, redactedCompiledSemanticAction, } = this.modes;
190
+ if (compiledElectron !== undefined && redactedCompiledElectron !== undefined) {
191
+ return {
192
+ ...base,
193
+ compiledElectron,
194
+ kind: "electron",
195
+ redactedCompiledElectron,
196
+ status: "valid",
197
+ };
198
+ }
199
+ const generated = this.validGeneratedInput(base);
200
+ if (generated !== undefined) {
201
+ return generated;
202
+ }
203
+ if (compiledSemanticAction !== undefined && redactedCompiledSemanticAction !== undefined) {
204
+ return {
205
+ ...base,
206
+ compiledSemanticAction,
207
+ kind: "semanticAction",
208
+ redactedCompiledSemanticAction,
209
+ status: "valid",
210
+ };
211
+ }
212
+ return { ...base, kind: "args", status: "valid" };
213
+ }
214
+ validGeneratedInput(base) {
215
+ const { compiledNetworkSourceLookup, compiledSourceLookup, compiledQaPreset, redactedCompiledNetworkSourceLookup, redactedCompiledSourceLookup, redactedCompiledQaPreset, redactedCompiledJob, } = this.modes;
216
+ if (compiledNetworkSourceLookup !== undefined &&
217
+ redactedCompiledNetworkSourceLookup !== undefined) {
218
+ return {
219
+ ...base,
220
+ compiledGeneratedBatch: compiledNetworkSourceLookup,
221
+ compiledNetworkSourceLookup,
222
+ kind: "networkSourceLookup",
223
+ redactedCompiledNetworkSourceLookup,
224
+ status: "valid",
225
+ };
226
+ }
227
+ if (compiledSourceLookup !== undefined && redactedCompiledSourceLookup !== undefined) {
228
+ return {
229
+ ...base,
230
+ compiledGeneratedBatch: compiledSourceLookup,
231
+ compiledSourceLookup,
232
+ kind: "sourceLookup",
233
+ redactedCompiledSourceLookup,
234
+ status: "valid",
235
+ };
236
+ }
237
+ if (compiledQaPreset !== undefined &&
238
+ redactedCompiledJob !== undefined &&
239
+ redactedCompiledQaPreset !== undefined) {
240
+ return {
241
+ ...base,
242
+ compiledGeneratedBatch: compiledQaPreset,
243
+ compiledJob: compiledQaPreset,
244
+ compiledQaPreset,
245
+ kind: "qa",
246
+ redactedCompiledJob,
247
+ redactedCompiledQaPreset,
248
+ status: "valid",
249
+ };
250
+ }
251
+ return undefined;
252
+ }
253
+ explicitInput() {
254
+ return normalizeExplicitEvalStdinArgs(isStringArray(this.params.args) ? this.params.args : [], typeof this.params.stdin === "string" ? this.params.stdin : undefined);
255
+ }
256
+ executionInput() {
257
+ const explicit = this.explicitInput();
199
258
  return {
200
- ...resolvedBase,
201
- compiledGeneratedBatch: compiledQaPreset,
202
- compiledJob: compiledQaPreset,
203
- compiledQaPreset,
204
- kind: "qa",
205
- redactedCompiledJob,
206
- redactedCompiledQaPreset,
207
- status: "valid",
259
+ args: this.electron.compiled === undefined
260
+ ? (this.semanticAction.compiled?.args ??
261
+ this.modes.compiledGeneratedBatch?.args ??
262
+ explicit.args)
263
+ : [],
264
+ stdin: this.modes.compiledGeneratedBatch?.stdin ?? explicit.stdin,
208
265
  };
209
266
  }
210
- if (compiledSemanticAction && redactedCompiledSemanticAction) {
211
- return { ...resolvedBase, compiledSemanticAction, kind: "semanticAction", redactedCompiledSemanticAction, status: "valid" };
267
+ resolve() {
268
+ const { args, stdin } = this.executionInput();
269
+ const redactedArgs = redactInvocationArgs([...args]);
270
+ const validationError = this.validationError(args, stdin);
271
+ const normalized = validationError !== undefined || isPlainTextInspectionArgs([...args])
272
+ ? { args, stdin }
273
+ : normalizeUrlLessOpen([...args], stdin);
274
+ const base = { redactedArgs, toolArgs: normalized.args, toolStdin: normalized.stdin };
275
+ if (validationError !== undefined) {
276
+ return {
277
+ ...base,
278
+ ...this.modes,
279
+ attemptedKind: this.attemptedKind(),
280
+ kind: "invalid",
281
+ status: "invalid",
282
+ validationError,
283
+ };
284
+ }
285
+ return this.validInput(base);
212
286
  }
213
- return { ...resolvedBase, kind: "args", status: "valid" };
287
+ }
288
+ export function resolveAgentBrowserInput(options) {
289
+ const params = isRecord(options.params) ? options.params : {};
290
+ return new BrowserInputCompiler(params, options.getBatchPreflightValidationError).resolve();
214
291
  }
215
292
  export function buildValidationFailureResult(input) {
216
- const validationError = input.validationError ?? "Invalid agent_browser input.";
217
293
  return {
218
- content: [{ type: "text", text: validationError }],
294
+ content: [{ type: "text", text: input.validationError }],
219
295
  details: {
220
296
  args: input.redactedArgs,
221
297
  compiledElectron: input.redactedCompiledElectron,
@@ -225,12 +301,12 @@ export function buildValidationFailureResult(input) {
225
301
  compiledNetworkSourceLookup: input.redactedCompiledNetworkSourceLookup,
226
302
  compiledSemanticAction: input.redactedCompiledSemanticAction,
227
303
  ...buildAgentBrowserResultCategoryDetails({
228
- args: input.redactedArgs,
229
- errorText: validationError,
304
+ args: [...input.redactedArgs],
305
+ errorText: input.validationError,
230
306
  succeeded: false,
231
- validationError,
307
+ validationError: input.validationError,
232
308
  }),
233
- validationError,
309
+ validationError: input.validationError,
234
310
  },
235
311
  isError: true,
236
312
  };
@@ -0,0 +1,62 @@
1
+ import { redactInvocationArgs, redactSensitiveText } from "../runtime.js";
2
+ import { redactNetworkSourceLookupArgs, redactNetworkSourceLookupUrl, } from "../input-modes/lookups.js";
3
+ export function redactCompiledElectron(compiled) {
4
+ if (compiled === undefined) {
5
+ return undefined;
6
+ }
7
+ if (compiled.action === "list") {
8
+ return {
9
+ ...compiled,
10
+ query: compiled.query !== undefined && compiled.query.length > 0
11
+ ? redactSensitiveText(compiled.query)
12
+ : undefined,
13
+ };
14
+ }
15
+ if (compiled.action === "launch") {
16
+ return {
17
+ ...compiled,
18
+ appArgs: compiled.appArgs === undefined ? undefined : redactInvocationArgs([...compiled.appArgs]),
19
+ };
20
+ }
21
+ return { ...compiled };
22
+ }
23
+ export function redactCompiledJob(compiled) {
24
+ if (compiled === undefined) {
25
+ return undefined;
26
+ }
27
+ const steps = compiled.steps.map((step) => ({
28
+ ...step,
29
+ args: redactInvocationArgs([...step.args]),
30
+ }));
31
+ return { ...compiled, stdin: JSON.stringify(steps.map((step) => step.args)), steps };
32
+ }
33
+ export function redactCompiledSourceLookup(compiled) {
34
+ if (compiled === undefined) {
35
+ return undefined;
36
+ }
37
+ const steps = compiled.steps.map((step) => ({
38
+ ...step,
39
+ args: redactInvocationArgs([...step.args]),
40
+ }));
41
+ return { ...compiled, stdin: JSON.stringify(steps.map((step) => step.args)), steps };
42
+ }
43
+ export function redactCompiledNetworkSourceLookup(compiled) {
44
+ if (compiled === undefined) {
45
+ return undefined;
46
+ }
47
+ const steps = compiled.steps.map((step) => ({
48
+ ...step,
49
+ args: redactNetworkSourceLookupArgs([...step.args]),
50
+ }));
51
+ return {
52
+ ...compiled,
53
+ args: redactNetworkSourceLookupArgs([...compiled.args]),
54
+ query: {
55
+ ...compiled.query,
56
+ filter: redactNetworkSourceLookupUrl(compiled.query.filter),
57
+ url: redactNetworkSourceLookupUrl(compiled.query.url),
58
+ },
59
+ stdin: JSON.stringify(steps.map((step) => step.args)),
60
+ steps,
61
+ };
62
+ }