pi-agent-browser-native 0.9.5 → 0.9.6

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 (380) hide show
  1. package/CHANGELOG.md +19 -0
  2. package/README.md +3 -0
  3. package/dist/extensions/agent-browser/index.js +1214 -583
  4. package/dist/packaged/lib/browser-session-conversion.js +2810 -0
  5. package/dist/packaged/lib/config-policy.js +599 -0
  6. package/dist/packaged/lib/parsing.js +34 -0
  7. package/dist/packaged/lib/playbook.js +694 -0
  8. package/dist/packaged/lib/results/snapshot.js +2671 -0
  9. package/dist/packaged/lib/runtime.js +3027 -0
  10. package/docs/ARCHITECTURE.md +11 -1
  11. package/docs/CODE_QUALITY.md +11 -0
  12. package/docs/COMMAND_REFERENCE.md +2 -2
  13. package/docs/PERFORMANCE.md +243 -0
  14. package/docs/REFERENCE.md +3 -3
  15. package/docs/SESSION_STORAGE.md +11 -3
  16. package/docs/SUPPORT_MATRIX.md +8 -4
  17. package/docs/TOOL_CONTRACT.md +4 -4
  18. package/docs/performance/2026-10-12.json +7257 -0
  19. package/package.json +13 -2
  20. package/scripts/build.mjs +16 -5
  21. package/scripts/config.mjs +1 -1
  22. package/scripts/convert-browser-session.mjs +1 -1
  23. package/dist/extensions/agent-browser/lib/argv-descriptor.js +0 -123
  24. package/dist/extensions/agent-browser/lib/argv-grammar.js +0 -320
  25. package/dist/extensions/agent-browser/lib/bash-guard.js +0 -193
  26. package/dist/extensions/agent-browser/lib/batch-lifecycle.js +0 -131
  27. package/dist/extensions/agent-browser/lib/browser-execution-claim-codec.js +0 -61
  28. package/dist/extensions/agent-browser/lib/browser-execution-claim-storage.js +0 -232
  29. package/dist/extensions/agent-browser/lib/browser-execution-claims.js +0 -202
  30. package/dist/extensions/agent-browser/lib/browser-execution-identity.js +0 -77
  31. package/dist/extensions/agent-browser/lib/browser-journal-branch.js +0 -98
  32. package/dist/extensions/agent-browser/lib/browser-journal-contracts.js +0 -1
  33. package/dist/extensions/agent-browser/lib/browser-journal-projection.js +0 -221
  34. package/dist/extensions/agent-browser/lib/browser-journal-reader.js +0 -89
  35. package/dist/extensions/agent-browser/lib/browser-journal-replay.js +0 -246
  36. package/dist/extensions/agent-browser/lib/browser-journal.js +0 -148
  37. package/dist/extensions/agent-browser/lib/browser-legacy-pages.js +0 -220
  38. package/dist/extensions/agent-browser/lib/browser-legacy-projection.js +0 -282
  39. package/dist/extensions/agent-browser/lib/browser-legacy-types.js +0 -1
  40. package/dist/extensions/agent-browser/lib/browser-session-conversion-stream.js +0 -217
  41. package/dist/extensions/agent-browser/lib/browser-session-conversion.js +0 -126
  42. package/dist/extensions/agent-browser/lib/browser-transcript-contracts.js +0 -35
  43. package/dist/extensions/agent-browser/lib/browser-transcript-validation.js +0 -166
  44. package/dist/extensions/agent-browser/lib/browser-transcript.js +0 -189
  45. package/dist/extensions/agent-browser/lib/browser-value-parsing.js +0 -15
  46. package/dist/extensions/agent-browser/lib/command-capabilities.js +0 -340
  47. package/dist/extensions/agent-browser/lib/command-policy.js +0 -155
  48. package/dist/extensions/agent-browser/lib/command-taxonomy.js +0 -105
  49. package/dist/extensions/agent-browser/lib/config-policy.js +0 -450
  50. package/dist/extensions/agent-browser/lib/config-providers.js +0 -71
  51. package/dist/extensions/agent-browser/lib/config-validation.js +0 -231
  52. package/dist/extensions/agent-browser/lib/config.js +0 -69
  53. package/dist/extensions/agent-browser/lib/electron/cdp.js +0 -62
  54. package/dist/extensions/agent-browser/lib/electron/cleanup.js +0 -274
  55. package/dist/extensions/agent-browser/lib/electron/discovery-darwin.js +0 -109
  56. package/dist/extensions/agent-browser/lib/electron/discovery-desktop.js +0 -136
  57. package/dist/extensions/agent-browser/lib/electron/discovery-evidence.js +0 -90
  58. package/dist/extensions/agent-browser/lib/electron/discovery-linux.js +0 -93
  59. package/dist/extensions/agent-browser/lib/electron/discovery-packages.js +0 -162
  60. package/dist/extensions/agent-browser/lib/electron/discovery-types.js +0 -2
  61. package/dist/extensions/agent-browser/lib/electron/discovery.js +0 -217
  62. package/dist/extensions/agent-browser/lib/electron/launch-monitor.js +0 -102
  63. package/dist/extensions/agent-browser/lib/electron/launch-process.js +0 -209
  64. package/dist/extensions/agent-browser/lib/electron/launch-types.js +0 -2
  65. package/dist/extensions/agent-browser/lib/electron/launch.js +0 -340
  66. package/dist/extensions/agent-browser/lib/executable-path.js +0 -29
  67. package/dist/extensions/agent-browser/lib/execution-cwd.js +0 -67
  68. package/dist/extensions/agent-browser/lib/fs-utils.js +0 -10
  69. package/dist/extensions/agent-browser/lib/input-modes/electron.js +0 -201
  70. package/dist/extensions/agent-browser/lib/input-modes/job.js +0 -198
  71. package/dist/extensions/agent-browser/lib/input-modes/lookup-network-evidence.js +0 -116
  72. package/dist/extensions/agent-browser/lib/input-modes/lookup-plan.js +0 -132
  73. package/dist/extensions/agent-browser/lib/input-modes/lookup-redaction.js +0 -57
  74. package/dist/extensions/agent-browser/lib/input-modes/lookup-source-evidence.js +0 -151
  75. package/dist/extensions/agent-browser/lib/input-modes/lookup-workspace.js +0 -142
  76. package/dist/extensions/agent-browser/lib/input-modes/lookups.js +0 -84
  77. package/dist/extensions/agent-browser/lib/input-modes/params.js +0 -195
  78. package/dist/extensions/agent-browser/lib/input-modes/qa-analysis.js +0 -268
  79. package/dist/extensions/agent-browser/lib/input-modes/qa-presentation.js +0 -117
  80. package/dist/extensions/agent-browser/lib/input-modes/script-child.js +0 -396
  81. package/dist/extensions/agent-browser/lib/input-modes/script-protocol.js +0 -86
  82. package/dist/extensions/agent-browser/lib/input-modes/script-types.js +0 -1
  83. package/dist/extensions/agent-browser/lib/input-modes/script-validation.js +0 -60
  84. package/dist/extensions/agent-browser/lib/input-modes/script.js +0 -108
  85. package/dist/extensions/agent-browser/lib/input-modes/semantic-action.js +0 -243
  86. package/dist/extensions/agent-browser/lib/input-modes/shared.js +0 -48
  87. package/dist/extensions/agent-browser/lib/input-modes/types.js +0 -65
  88. package/dist/extensions/agent-browser/lib/json-schema.js +0 -65
  89. package/dist/extensions/agent-browser/lib/launch-scoped-flags.js +0 -212
  90. package/dist/extensions/agent-browser/lib/managed-session-policy-lock.js +0 -165
  91. package/dist/extensions/agent-browser/lib/managed-session-posix-storage.js +0 -58
  92. package/dist/extensions/agent-browser/lib/managed-session-project-identity.js +0 -244
  93. package/dist/extensions/agent-browser/lib/managed-session-restore-context.js +0 -84
  94. package/dist/extensions/agent-browser/lib/managed-session-restore-policy.js +0 -119
  95. package/dist/extensions/agent-browser/lib/managed-session-restore-state.js +0 -83
  96. package/dist/extensions/agent-browser/lib/managed-session-restore.js +0 -212
  97. package/dist/extensions/agent-browser/lib/managed-session-snapshot-records.js +0 -277
  98. package/dist/extensions/agent-browser/lib/managed-session-snapshots.js +0 -181
  99. package/dist/extensions/agent-browser/lib/managed-session-storage.js +0 -126
  100. package/dist/extensions/agent-browser/lib/native-confirmation.js +0 -140
  101. package/dist/extensions/agent-browser/lib/native-output.js +0 -81
  102. package/dist/extensions/agent-browser/lib/orchestration/batch-stdin.js +0 -182
  103. package/dist/extensions/agent-browser/lib/orchestration/browser-run/artifact-merge.js +0 -30
  104. package/dist/extensions/agent-browser/lib/orchestration/browser-run/artifact-paths.js +0 -188
  105. package/dist/extensions/agent-browser/lib/orchestration/browser-run/browser-observation-result.js +0 -82
  106. package/dist/extensions/agent-browser/lib/orchestration/browser-run/click-dispatch.js +0 -406
  107. package/dist/extensions/agent-browser/lib/orchestration/browser-run/diagnostic-values.js +0 -31
  108. package/dist/extensions/agent-browser/lib/orchestration/browser-run/diagnostics.js +0 -240
  109. package/dist/extensions/agent-browser/lib/orchestration/browser-run/electron-observation.js +0 -203
  110. package/dist/extensions/agent-browser/lib/orchestration/browser-run/electron-text-diagnostics.js +0 -109
  111. package/dist/extensions/agent-browser/lib/orchestration/browser-run/fill-diagnostics.js +0 -119
  112. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-action-recovery.js +0 -147
  113. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-actions.js +0 -144
  114. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-content.js +0 -123
  115. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-contracts.js +0 -1
  116. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-details.js +0 -156
  117. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-electron.js +0 -187
  118. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-evidence.js +0 -39
  119. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-missing-binary.js +0 -89
  120. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-recovery.js +0 -97
  121. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-redaction.js +0 -106
  122. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-timeout.js +0 -110
  123. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result.js +0 -53
  124. package/dist/extensions/agent-browser/lib/orchestration/browser-run/index.js +0 -224
  125. package/dist/extensions/agent-browser/lib/orchestration/browser-run/interaction-diagnostics.js +0 -290
  126. package/dist/extensions/agent-browser/lib/orchestration/browser-run/managed-session-close.js +0 -167
  127. package/dist/extensions/agent-browser/lib/orchestration/browser-run/managed-session-daemon-inspection.js +0 -108
  128. package/dist/extensions/agent-browser/lib/orchestration/browser-run/managed-session-daemon-policy.js +0 -174
  129. package/dist/extensions/agent-browser/lib/orchestration/browser-run/native-helper-observation.js +0 -65
  130. package/dist/extensions/agent-browser/lib/orchestration/browser-run/observation-types.js +0 -1
  131. package/dist/extensions/agent-browser/lib/orchestration/browser-run/overlay-diagnostics.js +0 -120
  132. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/network-page-filter.js +0 -192
  133. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/scroll-shims.js +0 -225
  134. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/snapshot-filter-data.js +0 -150
  135. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/snapshot-filter.js +0 -174
  136. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/snapshot-rendered-text.js +0 -147
  137. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/wait-timeouts.js +0 -145
  138. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-artifacts.js +0 -159
  139. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-command.js +0 -131
  140. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-contracts.js +0 -1
  141. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-daemon.js +0 -93
  142. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-failure.js +0 -42
  143. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-guards.js +0 -242
  144. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-input.js +0 -75
  145. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-observations.js +0 -92
  146. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-page-selection.js +0 -254
  147. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-page-state.js +0 -121
  148. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-refs.js +0 -130
  149. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-resources.js +0 -114
  150. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-semantic.js +0 -121
  151. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-session-plan.js +0 -222
  152. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-timeouts.js +0 -68
  153. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare.js +0 -202
  154. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-analysis.js +0 -191
  155. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-confirmation.js +0 -152
  156. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-diagnostics.js +0 -182
  157. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-electron.js +0 -150
  158. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-lifecycle-contracts.js +0 -1
  159. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-lifecycle-phase-contracts.js +0 -1
  160. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-lifecycle-phase.js +0 -115
  161. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-lifecycle.js +0 -256
  162. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-managed-contracts.js +0 -1
  163. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-managed.js +0 -256
  164. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-native-phase-contracts.js +0 -1
  165. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-native-phase.js +0 -93
  166. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-native.js +0 -113
  167. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-navigation-contracts.js +0 -1
  168. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-navigation.js +0 -316
  169. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-ownership.js +0 -28
  170. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-page-phase-contracts.js +0 -1
  171. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-page-phase.js +0 -142
  172. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-presentation-contracts.js +0 -1
  173. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-presentation.js +0 -333
  174. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-publication-phase-contracts.js +0 -1
  175. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-publication-phase.js +0 -71
  176. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-publication.js +0 -201
  177. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-receipts.js +0 -183
  178. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-refs.js +0 -200
  179. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-tabs.js +0 -142
  180. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output.js +0 -25
  181. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prompt-guards.js +0 -50
  182. package/dist/extensions/agent-browser/lib/orchestration/browser-run/recording-receipt-reconciliation.js +0 -198
  183. package/dist/extensions/agent-browser/lib/orchestration/browser-run/recording-recovery-contracts.js +0 -1
  184. package/dist/extensions/agent-browser/lib/orchestration/browser-run/recording-recovery-presentation.js +0 -154
  185. package/dist/extensions/agent-browser/lib/orchestration/browser-run/recording-recovery.js +0 -80
  186. package/dist/extensions/agent-browser/lib/orchestration/browser-run/screenshot-capture.js +0 -14
  187. package/dist/extensions/agent-browser/lib/orchestration/browser-run/screenshot-observation.js +0 -206
  188. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-commands.js +0 -130
  189. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-electron.js +0 -212
  190. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-observations.js +0 -61
  191. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-outcomes.js +0 -187
  192. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-refs.js +0 -169
  193. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-tabs.js +0 -228
  194. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state.js +0 -117
  195. package/dist/extensions/agent-browser/lib/orchestration/browser-run/text-visibility-diagnostics.js +0 -182
  196. package/dist/extensions/agent-browser/lib/orchestration/browser-run/timeout-diagnostics.js +0 -256
  197. package/dist/extensions/agent-browser/lib/orchestration/browser-run/timeout-progress.js +0 -108
  198. package/dist/extensions/agent-browser/lib/orchestration/browser-run/types.js +0 -1
  199. package/dist/extensions/agent-browser/lib/orchestration/code-artifact-observation.js +0 -39
  200. package/dist/extensions/agent-browser/lib/orchestration/code-image-observation.js +0 -119
  201. package/dist/extensions/agent-browser/lib/orchestration/electron-host/branch.js +0 -93
  202. package/dist/extensions/agent-browser/lib/orchestration/electron-host/cleanup-result.js +0 -58
  203. package/dist/extensions/agent-browser/lib/orchestration/electron-host/cleanup.js +0 -78
  204. package/dist/extensions/agent-browser/lib/orchestration/electron-host/contracts.js +0 -1
  205. package/dist/extensions/agent-browser/lib/orchestration/electron-host/discovery.js +0 -106
  206. package/dist/extensions/agent-browser/lib/orchestration/electron-host/index.js +0 -60
  207. package/dist/extensions/agent-browser/lib/orchestration/electron-host/policy.js +0 -86
  208. package/dist/extensions/agent-browser/lib/orchestration/electron-host/probe-collection.js +0 -68
  209. package/dist/extensions/agent-browser/lib/orchestration/electron-host/probe-data.js +0 -169
  210. package/dist/extensions/agent-browser/lib/orchestration/electron-host/probe-presentation.js +0 -182
  211. package/dist/extensions/agent-browser/lib/orchestration/electron-host/probe.js +0 -161
  212. package/dist/extensions/agent-browser/lib/orchestration/electron-host/status.js +0 -167
  213. package/dist/extensions/agent-browser/lib/orchestration/execution-queue.js +0 -98
  214. package/dist/extensions/agent-browser/lib/orchestration/extension-artifact-preflight.js +0 -211
  215. package/dist/extensions/agent-browser/lib/orchestration/extension-artifacts.js +0 -23
  216. package/dist/extensions/agent-browser/lib/orchestration/extension-attachment-replay.js +0 -99
  217. package/dist/extensions/agent-browser/lib/orchestration/extension-branch-restore.js +0 -275
  218. package/dist/extensions/agent-browser/lib/orchestration/extension-code.js +0 -280
  219. package/dist/extensions/agent-browser/lib/orchestration/extension-command-admission.js +0 -303
  220. package/dist/extensions/agent-browser/lib/orchestration/extension-command-output.js +0 -36
  221. package/dist/extensions/agent-browser/lib/orchestration/extension-command-result.js +0 -335
  222. package/dist/extensions/agent-browser/lib/orchestration/extension-command-run.js +0 -227
  223. package/dist/extensions/agent-browser/lib/orchestration/extension-command-state.js +0 -1
  224. package/dist/extensions/agent-browser/lib/orchestration/extension-electron-ownership.js +0 -204
  225. package/dist/extensions/agent-browser/lib/orchestration/extension-execution-locks.js +0 -139
  226. package/dist/extensions/agent-browser/lib/orchestration/extension-execution-queue.js +0 -24
  227. package/dist/extensions/agent-browser/lib/orchestration/extension-host-coordination.js +0 -98
  228. package/dist/extensions/agent-browser/lib/orchestration/extension-host-run.js +0 -295
  229. package/dist/extensions/agent-browser/lib/orchestration/extension-intent-replay.js +0 -41
  230. package/dist/extensions/agent-browser/lib/orchestration/extension-invocation.js +0 -7
  231. package/dist/extensions/agent-browser/lib/orchestration/extension-lifecycle.js +0 -102
  232. package/dist/extensions/agent-browser/lib/orchestration/extension-managed-ownership.js +0 -133
  233. package/dist/extensions/agent-browser/lib/orchestration/extension-observation.js +0 -120
  234. package/dist/extensions/agent-browser/lib/orchestration/extension-prompt.js +0 -180
  235. package/dist/extensions/agent-browser/lib/orchestration/extension-recording.js +0 -290
  236. package/dist/extensions/agent-browser/lib/orchestration/extension-resource-contracts.js +0 -1
  237. package/dist/extensions/agent-browser/lib/orchestration/extension-resource-replay.js +0 -269
  238. package/dist/extensions/agent-browser/lib/orchestration/extension-result-state.js +0 -113
  239. package/dist/extensions/agent-browser/lib/orchestration/extension-runtime.js +0 -146
  240. package/dist/extensions/agent-browser/lib/orchestration/extension-script-leases.js +0 -58
  241. package/dist/extensions/agent-browser/lib/orchestration/extension-tool-boundary.js +0 -62
  242. package/dist/extensions/agent-browser/lib/orchestration/extension-version-check.js +0 -54
  243. package/dist/extensions/agent-browser/lib/orchestration/input-plan-types.js +0 -1
  244. package/dist/extensions/agent-browser/lib/orchestration/input-plan.js +0 -313
  245. package/dist/extensions/agent-browser/lib/orchestration/input-redaction.js +0 -62
  246. package/dist/extensions/agent-browser/lib/orchestration/native-config.js +0 -144
  247. package/dist/extensions/agent-browser/lib/orchestration/native-root-launch.js +0 -77
  248. package/dist/extensions/agent-browser/lib/orchestration/native-session-defaults.js +0 -231
  249. package/dist/extensions/agent-browser/lib/orchestration/operation-paths.js +0 -142
  250. package/dist/extensions/agent-browser/lib/orchestration/output-file.js +0 -276
  251. package/dist/extensions/agent-browser/lib/orchestration/script-mode.js +0 -220
  252. package/dist/extensions/agent-browser/lib/owned-managed-session-context.js +0 -55
  253. package/dist/extensions/agent-browser/lib/page-target-batch.js +0 -118
  254. package/dist/extensions/agent-browser/lib/page-target-guards.js +0 -50
  255. package/dist/extensions/agent-browser/lib/page-target-navigation.js +0 -104
  256. package/dist/extensions/agent-browser/lib/page-target-validation.js +0 -90
  257. package/dist/extensions/agent-browser/lib/parsing.js +0 -30
  258. package/dist/extensions/agent-browser/lib/pi-tool-rendering.js +0 -343
  259. package/dist/extensions/agent-browser/lib/playbook.js +0 -146
  260. package/dist/extensions/agent-browser/lib/process-child.js +0 -284
  261. package/dist/extensions/agent-browser/lib/process-environment.js +0 -48
  262. package/dist/extensions/agent-browser/lib/process-errors.js +0 -23
  263. package/dist/extensions/agent-browser/lib/process-identity.js +0 -127
  264. package/dist/extensions/agent-browser/lib/process-socket-storage.js +0 -256
  265. package/dist/extensions/agent-browser/lib/process-stdout.js +0 -74
  266. package/dist/extensions/agent-browser/lib/process.js +0 -216
  267. package/dist/extensions/agent-browser/lib/prompt-artifacts.js +0 -287
  268. package/dist/extensions/agent-browser/lib/prompt-policy.js +0 -54
  269. package/dist/extensions/agent-browser/lib/read-command.js +0 -41
  270. package/dist/extensions/agent-browser/lib/read-confirmation.js +0 -162
  271. package/dist/extensions/agent-browser/lib/recording-reservations.js +0 -208
  272. package/dist/extensions/agent-browser/lib/redaction-fields.js +0 -75
  273. package/dist/extensions/agent-browser/lib/redaction-json.js +0 -149
  274. package/dist/extensions/agent-browser/lib/redaction-url.js +0 -88
  275. package/dist/extensions/agent-browser/lib/results/action-contracts.js +0 -1
  276. package/dist/extensions/agent-browser/lib/results/action-recommendations.js +0 -38
  277. package/dist/extensions/agent-browser/lib/results/artifact-contracts.js +0 -1
  278. package/dist/extensions/agent-browser/lib/results/artifact-manifest-validation.js +0 -133
  279. package/dist/extensions/agent-browser/lib/results/artifact-manifest.js +0 -173
  280. package/dist/extensions/agent-browser/lib/results/artifact-recommendations.js +0 -73
  281. package/dist/extensions/agent-browser/lib/results/categories.js +0 -152
  282. package/dist/extensions/agent-browser/lib/results/confirmation.js +0 -75
  283. package/dist/extensions/agent-browser/lib/results/contracts.js +0 -1
  284. package/dist/extensions/agent-browser/lib/results/editable-ref-evidence.js +0 -99
  285. package/dist/extensions/agent-browser/lib/results/electron-recommendations.js +0 -83
  286. package/dist/extensions/agent-browser/lib/results/envelope-decoding.js +0 -48
  287. package/dist/extensions/agent-browser/lib/results/envelope.js +0 -198
  288. package/dist/extensions/agent-browser/lib/results/evidence-contracts.js +0 -1
  289. package/dist/extensions/agent-browser/lib/results/failure-recommendations.js +0 -180
  290. package/dist/extensions/agent-browser/lib/results/network-routes.js +0 -133
  291. package/dist/extensions/agent-browser/lib/results/network.js +0 -89
  292. package/dist/extensions/agent-browser/lib/results/next-actions.js +0 -111
  293. package/dist/extensions/agent-browser/lib/results/presentation/artifact-files.js +0 -320
  294. package/dist/extensions/agent-browser/lib/results/presentation/artifact-format.js +0 -138
  295. package/dist/extensions/agent-browser/lib/results/presentation/artifact-images.js +0 -113
  296. package/dist/extensions/agent-browser/lib/results/presentation/artifact-verification.js +0 -145
  297. package/dist/extensions/agent-browser/lib/results/presentation/artifacts.js +0 -165
  298. package/dist/extensions/agent-browser/lib/results/presentation/batch-contracts.js +0 -1
  299. package/dist/extensions/agent-browser/lib/results/presentation/batch-recording.js +0 -118
  300. package/dist/extensions/agent-browser/lib/results/presentation/batch-redaction.js +0 -68
  301. package/dist/extensions/agent-browser/lib/results/presentation/batch-rendering.js +0 -135
  302. package/dist/extensions/agent-browser/lib/results/presentation/batch-step.js +0 -227
  303. package/dist/extensions/agent-browser/lib/results/presentation/batch-summary.js +0 -91
  304. package/dist/extensions/agent-browser/lib/results/presentation/batch.js +0 -123
  305. package/dist/extensions/agent-browser/lib/results/presentation/browser-profile-recovery.js +0 -54
  306. package/dist/extensions/agent-browser/lib/results/presentation/command-presenters.js +0 -216
  307. package/dist/extensions/agent-browser/lib/results/presentation/common.js +0 -81
  308. package/dist/extensions/agent-browser/lib/results/presentation/content.js +0 -119
  309. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-a11y.js +0 -67
  310. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-health.js +0 -79
  311. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-identity.js +0 -199
  312. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-logs.js +0 -75
  313. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-network-actions.js +0 -216
  314. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-network.js +0 -124
  315. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-redaction.js +0 -64
  316. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-storage.js +0 -209
  317. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-stream.js +0 -69
  318. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-summary.js +0 -222
  319. package/dist/extensions/agent-browser/lib/results/presentation/diagnostics.js +0 -124
  320. package/dist/extensions/agent-browser/lib/results/presentation/early-result.js +0 -70
  321. package/dist/extensions/agent-browser/lib/results/presentation/errors.js +0 -285
  322. package/dist/extensions/agent-browser/lib/results/presentation/input-contracts.js +0 -1
  323. package/dist/extensions/agent-browser/lib/results/presentation/large-output.js +0 -117
  324. package/dist/extensions/agent-browser/lib/results/presentation/navigation.js +0 -231
  325. package/dist/extensions/agent-browser/lib/results/presentation/notices.js +0 -75
  326. package/dist/extensions/agent-browser/lib/results/presentation/observation-contracts.js +0 -1
  327. package/dist/extensions/agent-browser/lib/results/presentation/observation-rendering.js +0 -127
  328. package/dist/extensions/agent-browser/lib/results/presentation/outcomes.js +0 -120
  329. package/dist/extensions/agent-browser/lib/results/presentation/output-completion.js +0 -77
  330. package/dist/extensions/agent-browser/lib/results/presentation/output-spill.js +0 -51
  331. package/dist/extensions/agent-browser/lib/results/presentation/registry.js +0 -145
  332. package/dist/extensions/agent-browser/lib/results/presentation/semantic-action.js +0 -104
  333. package/dist/extensions/agent-browser/lib/results/presentation/skills.js +0 -183
  334. package/dist/extensions/agent-browser/lib/results/presentation/source.js +0 -109
  335. package/dist/extensions/agent-browser/lib/results/presentation.js +0 -19
  336. package/dist/extensions/agent-browser/lib/results/recommendation-contracts.js +0 -1
  337. package/dist/extensions/agent-browser/lib/results/recording.js +0 -88
  338. package/dist/extensions/agent-browser/lib/results/recovery-actions.js +0 -118
  339. package/dist/extensions/agent-browser/lib/results/recovery-next-actions.js +0 -60
  340. package/dist/extensions/agent-browser/lib/results/selector-recovery-target.js +0 -83
  341. package/dist/extensions/agent-browser/lib/results/selector-recovery.js +0 -261
  342. package/dist/extensions/agent-browser/lib/results/snapshot-compact.js +0 -266
  343. package/dist/extensions/agent-browser/lib/results/snapshot-content.js +0 -32
  344. package/dist/extensions/agent-browser/lib/results/snapshot-high-value-controls.js +0 -240
  345. package/dist/extensions/agent-browser/lib/results/snapshot-refs.js +0 -103
  346. package/dist/extensions/agent-browser/lib/results/snapshot-segments.js +0 -383
  347. package/dist/extensions/agent-browser/lib/results/snapshot-spill.js +0 -53
  348. package/dist/extensions/agent-browser/lib/results/snapshot.js +0 -44
  349. package/dist/extensions/agent-browser/lib/results/text.js +0 -44
  350. package/dist/extensions/agent-browser/lib/runtime-args-validation.js +0 -133
  351. package/dist/extensions/agent-browser/lib/runtime-compatibility.js +0 -81
  352. package/dist/extensions/agent-browser/lib/runtime-contracts.js +0 -1
  353. package/dist/extensions/agent-browser/lib/runtime-redaction.js +0 -118
  354. package/dist/extensions/agent-browser/lib/runtime-replay-events.js +0 -144
  355. package/dist/extensions/agent-browser/lib/runtime-session-identity.js +0 -76
  356. package/dist/extensions/agent-browser/lib/runtime-session-plan.js +0 -114
  357. package/dist/extensions/agent-browser/lib/runtime-session-replay.js +0 -123
  358. package/dist/extensions/agent-browser/lib/runtime-tab-correction.js +0 -65
  359. package/dist/extensions/agent-browser/lib/runtime-timeouts.js +0 -28
  360. package/dist/extensions/agent-browser/lib/runtime.js +0 -163
  361. package/dist/extensions/agent-browser/lib/session-identity.js +0 -51
  362. package/dist/extensions/agent-browser/lib/session-page-observation.js +0 -357
  363. package/dist/extensions/agent-browser/lib/session-page-state.js +0 -353
  364. package/dist/extensions/agent-browser/lib/session-page-types.js +0 -1
  365. package/dist/extensions/agent-browser/lib/string-enum-schema.js +0 -8
  366. package/dist/extensions/agent-browser/lib/temp-artifact-budget.js +0 -81
  367. package/dist/extensions/agent-browser/lib/temp-mutation-queue.js +0 -7
  368. package/dist/extensions/agent-browser/lib/temp-root-ownership.js +0 -234
  369. package/dist/extensions/agent-browser/lib/temp-root.js +0 -211
  370. package/dist/extensions/agent-browser/lib/temp.js +0 -91
  371. package/dist/extensions/agent-browser/lib/tool-surface.js +0 -239
  372. package/dist/extensions/agent-browser/lib/upstream-version.js +0 -15
  373. package/dist/extensions/agent-browser/lib/web-search-providers.js +0 -193
  374. package/dist/extensions/agent-browser/lib/web-search-request.js +0 -102
  375. package/dist/extensions/agent-browser/lib/web-search-results.js +0 -281
  376. package/dist/extensions/agent-browser/lib/web-search-schema.js +0 -82
  377. package/dist/extensions/agent-browser/lib/web-search.js +0 -167
  378. package/dist/extensions/agent-browser/lib/webmcp-observation.js +0 -35
  379. package/dist/extensions/agent-browser/lib/windows-stock-launcher.js +0 -96
  380. package/dist/scripts/agent-browser-target.mjs +0 -23
@@ -1,147 +0,0 @@
1
- import { isRecord } from "../../../parsing.js";
2
- import { redactSensitiveText } from "../../../runtime-redaction.js";
3
- const RENDERED_TEXT_SEARCH_MAX_MATCHES = 8;
4
- export function buildRenderedTextSearchEval(search) {
5
- return `(() => {
6
- const query = ${JSON.stringify(search.trim().toLowerCase())};
7
- const limit = ${RENDERED_TEXT_SEARCH_MAX_MATCHES};
8
- const normalize = (value) => String(value ?? "").replace(/\\s+/g, " ").trim();
9
- const attributeTextOf = (element) => [element.getAttribute("aria-label"), element.getAttribute("title"), element.getAttribute("placeholder")].filter(Boolean).join(" ");
10
- const searchableTextOf = (element) => normalize([attributeTextOf(element), element.textContent].filter(Boolean).join(" "));
11
- const renderedTextOf = (element) => normalize([attributeTextOf(element), element instanceof HTMLElement ? element.innerText : element.textContent].filter(Boolean).join(" "));
12
- const isRendered = (element) => {
13
- if (!(element instanceof Element) || element.getClientRects().length === 0) return false;
14
- const visibility = getComputedStyle(element).visibility;
15
- if (visibility === "hidden" || visibility === "collapse") return false;
16
- for (let current = element; current; current = current.parentElement) {
17
- if (Number(getComputedStyle(current).opacity) === 0) return false;
18
- }
19
- return true;
20
- };
21
- const validationPattern = /(?:^|[-_\\s])(?:error|invalid|validation|warning)(?:$|[-_\\s])/i;
22
- const validationAncestor = (element) => {
23
- for (let current = element; current && current !== document.body; current = current.parentElement) {
24
- const role = current.getAttribute("role");
25
- const live = current.getAttribute("aria-live");
26
- const descriptor = [current.id, current.className, current.getAttribute("data-testid")].map(normalize).join(" ");
27
- if (["alert", "alertdialog", "status"].includes(role || "") || current.getAttribute("aria-invalid") === "true" || (live && live !== "off") || validationPattern.test(descriptor)) return current;
28
- }
29
- return null;
30
- };
31
- const candidates = Array.from(document.querySelectorAll("body *")).filter((element) => searchableTextOf(element).toLowerCase().includes(query));
32
- const candidateSet = new Set(candidates);
33
- const minimal = candidates.filter((element) => !Array.from(element.children).some((child) => candidateSet.has(child)));
34
- const rendered = minimal.filter((element) => isRendered(element) && renderedTextOf(element).toLowerCase().includes(query));
35
- const matches = rendered.map((element, index) => {
36
- const semantic = validationAncestor(element);
37
- const source = semantic || element;
38
- const text = renderedTextOf(element);
39
- const matchIndex = text.toLowerCase().indexOf(query);
40
- const start = Math.max(0, matchIndex - 80);
41
- const snippet = text.slice(start, start + 240);
42
- const rect = element.getBoundingClientRect();
43
- const name = normalize(element.getAttribute("aria-label") || element.getAttribute("title") || element.getAttribute("placeholder")) || undefined;
44
- return {
45
- index,
46
- kind: semantic ? "validation" : "text",
47
- name,
48
- offscreen: rect.bottom < 0 || rect.right < 0 || rect.top > innerHeight || rect.left > innerWidth,
49
- role: source.getAttribute("role") || undefined,
50
- tagName: element.tagName.toLowerCase(),
51
- text: snippet,
52
- };
53
- }).sort((left, right) => (left.kind === right.kind ? left.index - right.index : left.kind === "validation" ? -1 : 1));
54
- const unique = [];
55
- const seen = new Set();
56
- for (const match of matches) {
57
- const key = [match.kind, match.role, match.name, match.text].join("\\n");
58
- if (seen.has(key)) continue;
59
- seen.add(key);
60
- const { index, ...visible } = match;
61
- unique.push(visible);
62
- }
63
- return { matches: unique.slice(0, limit), totalMatches: unique.length, truncated: unique.length > limit };
64
- })()`;
65
- }
66
- export function extractRenderedTextSearchResult(data) {
67
- const result = isRecord(data) && isRecord(data.result) ? data.result : data;
68
- if (!isRecord(result) || !Array.isArray(result.matches)) {
69
- return undefined;
70
- }
71
- const matches = result.matches
72
- .flatMap((value) => {
73
- if (!isRecord(value) ||
74
- (value.kind !== "text" && value.kind !== "validation") ||
75
- typeof value.offscreen !== "boolean" ||
76
- typeof value.tagName !== "string" ||
77
- typeof value.text !== "string") {
78
- return [];
79
- }
80
- return [
81
- {
82
- kind: value.kind,
83
- ...(typeof value.name === "string" ? { name: redactSensitiveText(value.name) } : {}),
84
- offscreen: value.offscreen,
85
- ...(typeof value.role === "string" ? { role: value.role } : {}),
86
- tagName: value.tagName,
87
- text: redactSensitiveText(value.text),
88
- },
89
- ];
90
- })
91
- .slice(0, RENDERED_TEXT_SEARCH_MAX_MATCHES);
92
- const totalMatches = typeof result.totalMatches === "number" &&
93
- Number.isInteger(result.totalMatches) &&
94
- result.totalMatches >= matches.length
95
- ? result.totalMatches
96
- : matches.length;
97
- return {
98
- matches,
99
- totalMatches,
100
- truncated: result.truncated === true || totalMatches > matches.length,
101
- };
102
- }
103
- export function attachRenderedTextMatchRefs(matches, snapshotData) {
104
- if (!isRecord(snapshotData) || !isRecord(snapshotData.refs)) {
105
- return [...matches];
106
- }
107
- const refs = snapshotData.refs;
108
- return matches.map((match) => {
109
- if (match.name === undefined || match.name === "") {
110
- return match;
111
- }
112
- const normalizedName = match.name.replace(/\s+/g, " ").trim().toLowerCase();
113
- const candidates = Object.entries(refs).filter(([, value]) => {
114
- if (!isRecord(value) || typeof value.name !== "string") {
115
- return false;
116
- }
117
- const nameMatches = value.name.replace(/\s+/g, " ").trim().toLowerCase() === normalizedName;
118
- return (nameMatches &&
119
- (match.role === undefined ||
120
- match.role === "" ||
121
- typeof value.role !== "string" ||
122
- value.role.toLowerCase() === match.role.toLowerCase()));
123
- });
124
- return candidates.length === 1 ? { ...match, ref: candidates[0][0] } : match;
125
- });
126
- }
127
- export function formatRenderedTextSearchMatches(result) {
128
- if (!result || result.matches.length === 0) {
129
- return undefined;
130
- }
131
- const lines = result.matches.map((match) => {
132
- const context = [
133
- match.kind === "validation" ? "validation" : undefined,
134
- match.offscreen ? "outside viewport" : undefined,
135
- match.role,
136
- match.tagName,
137
- match.ref !== undefined && match.ref !== "" ? `@${match.ref}` : undefined,
138
- ]
139
- .filter(Boolean)
140
- .join(", ");
141
- return `- ${JSON.stringify(match.text)}${context !== "" ? ` (${context})` : ""}`;
142
- });
143
- if (result.truncated) {
144
- lines.push(`- ... (${result.totalMatches - result.matches.length} additional rendered-text matches omitted)`);
145
- }
146
- return ["Rendered page text matches:", ...lines].join("\n");
147
- }
@@ -1,145 +0,0 @@
1
- import { GLOBAL_BOOLEAN_FLAGS_WITH_OPTIONAL_VALUES, VALUE_FLAGS } from "../../../argv-grammar.js";
2
- import { isOpenNavigationCommand } from "../../../command-taxonomy.js";
3
- import { getExplicitReadUrl, isBrowserIndependentRead } from "../../../command-policy.js";
4
- import { getAgentBrowserProcessTimeoutMs } from "../../../process.js";
5
- import { getUpstreamEffectiveBatchSteps } from "../../batch-stdin.js";
6
- const POSITIONAL_VALUE_FLAGS = new Set([...VALUE_FLAGS, "--llms"]);
7
- const COMMAND_PROCESS_TIMEOUT_GRACE_MS = 5_000;
8
- function parseMillisecondsToken(token) {
9
- if (token === undefined || !/^\d+$/.test(token)) {
10
- return undefined;
11
- }
12
- const parsed = Number(token);
13
- return Number.isSafeInteger(parsed) ? parsed : undefined;
14
- }
15
- function supportsCommandTimeout(commandTokens) {
16
- const [command, subcommand] = commandTokens;
17
- return (command === "wait" ||
18
- command === "read" ||
19
- (command === "webmcp" && ["invoke", "result"].includes(subcommand)));
20
- }
21
- function findCommandTimeoutMs(commandTokens) {
22
- if (!supportsCommandTimeout(commandTokens)) {
23
- return undefined;
24
- }
25
- for (let index = 1; index < commandTokens.length; index += 1) {
26
- const token = commandTokens[index];
27
- if (token === "--timeout") {
28
- return parseMillisecondsToken(commandTokens[index + 1]);
29
- }
30
- if (token.startsWith("--timeout=")) {
31
- return parseMillisecondsToken(token.slice("--timeout=".length));
32
- }
33
- }
34
- const firstWaitArgument = commandTokens[0] === "wait" ? commandTokens.at(1) : undefined;
35
- return firstWaitArgument !== undefined &&
36
- firstWaitArgument !== "" &&
37
- !firstWaitArgument.startsWith("-")
38
- ? parseMillisecondsToken(firstWaitArgument)
39
- : undefined;
40
- }
41
- export function findFirstPositionalArgument(commandTokens) {
42
- for (let index = 1; index < commandTokens.length; index += 1) {
43
- const token = commandTokens[index];
44
- const flag = token.split("=", 1)[0];
45
- if (POSITIONAL_VALUE_FLAGS.has(flag)) {
46
- if (!token.includes("=")) {
47
- index += 1;
48
- }
49
- continue;
50
- }
51
- if (GLOBAL_BOOLEAN_FLAGS_WITH_OPTIONAL_VALUES.has(flag) &&
52
- ["true", "false"].includes(commandTokens[index + 1] ?? "")) {
53
- index += 1;
54
- continue;
55
- }
56
- if (!token.startsWith("-")) {
57
- return token;
58
- }
59
- }
60
- return undefined;
61
- }
62
- function readUsesActivePageUrl(commandTokens) {
63
- return (!isBrowserIndependentRead(commandTokens) &&
64
- commandTokens.some((token) => token === "--require-md" || token === "--llms" || token.startsWith("--llms=")));
65
- }
66
- function readRequestBudget(commandTokens, activePageUrl) {
67
- const target = getExplicitReadUrl(commandTokens) ?? activePageUrl;
68
- if (target === undefined) {
69
- return 1;
70
- }
71
- let url;
72
- try {
73
- url = new URL(target.includes("://") ? target : `https://${target}`);
74
- }
75
- catch {
76
- return 1;
77
- }
78
- const ancestorCount = url.pathname.split("/").filter(Boolean).length + 1;
79
- if (commandTokens.some((token) => token === "--llms" || token.startsWith("--llms="))) {
80
- return ancestorCount;
81
- }
82
- if (commandTokens.includes("--raw")) {
83
- return 1;
84
- }
85
- return ancestorCount + 3;
86
- }
87
- function commandTimeoutBudgetMs(commandTokens, activePageUrl) {
88
- const timeoutMs = findCommandTimeoutMs(commandTokens);
89
- if (timeoutMs === undefined) {
90
- return undefined;
91
- }
92
- return commandTokens[0] === "read"
93
- ? timeoutMs * readRequestBudget(commandTokens, activePageUrl)
94
- : timeoutMs;
95
- }
96
- function findCommandTimeoutBudgetMs(commandTokens, stdin, activePageUrl) {
97
- const directTimeout = commandTimeoutBudgetMs(commandTokens, activePageUrl);
98
- if (directTimeout !== undefined) {
99
- return directTimeout;
100
- }
101
- if (commandTokens[0] !== "batch") {
102
- return undefined;
103
- }
104
- let batchTimeoutTotal = 0;
105
- let batchPageUrl = activePageUrl;
106
- for (const step of getUpstreamEffectiveBatchSteps(commandTokens, stdin)) {
107
- batchTimeoutTotal += commandTimeoutBudgetMs(step, batchPageUrl) ?? 0;
108
- if (isOpenNavigationCommand(step[0])) {
109
- batchPageUrl = findFirstPositionalArgument(step);
110
- }
111
- }
112
- return batchTimeoutTotal === 0 ? undefined : batchTimeoutTotal;
113
- }
114
- function activeReadNeedsPageUrl(commandTokens) {
115
- return (commandTokens[0] === "read" &&
116
- findCommandTimeoutMs(commandTokens) !== undefined &&
117
- readUsesActivePageUrl(commandTokens));
118
- }
119
- export function commandTimeoutNeedsActivePageUrl(commandTokens, stdin) {
120
- if (commandTokens[0] === "read") {
121
- return activeReadNeedsPageUrl(commandTokens);
122
- }
123
- if (commandTokens[0] !== "batch") {
124
- return false;
125
- }
126
- let hasKnownPageUrl = false;
127
- for (const step of getUpstreamEffectiveBatchSteps(commandTokens, stdin)) {
128
- if (isOpenNavigationCommand(step[0]) && (findFirstPositionalArgument(step) ?? "") !== "") {
129
- hasKnownPageUrl = true;
130
- }
131
- if (!hasKnownPageUrl && activeReadNeedsPageUrl(step)) {
132
- return true;
133
- }
134
- }
135
- return false;
136
- }
137
- export function getCommandAwareProcessTimeoutMs(commandTokens, stdin, activePageUrl) {
138
- const timeoutBudgetMs = findCommandTimeoutBudgetMs(commandTokens, stdin, activePageUrl);
139
- if (timeoutBudgetMs === undefined) {
140
- return undefined;
141
- }
142
- const neededTimeoutMs = timeoutBudgetMs + COMMAND_PROCESS_TIMEOUT_GRACE_MS;
143
- const defaultProcessTimeoutMs = getAgentBrowserProcessTimeoutMs();
144
- return neededTimeoutMs > defaultProcessTimeoutMs ? neededTimeoutMs : undefined;
145
- }
@@ -1,159 +0,0 @@
1
- import { copyFile, mkdir } from "node:fs/promises";
2
- import { dirname, resolve } from "node:path";
3
- import { projectUpstreamGlobalFlags } from "../../argv-grammar.js";
4
- import { pathExists } from "../../fs-utils.js";
5
- import { extractCommandTokens, extractUpstreamCommandTokens, parseWaitCommandTokens, } from "../../runtime.js";
6
- import { getUpstreamEffectiveBatchSteps, parseBatchStdinJsonArray } from "../batch-stdin.js";
7
- import { getScreenshotPathTokenIndex } from "./artifact-paths.js";
8
- function getArtifactParentPathTokenIndex(commandTokens) {
9
- if (commandTokens[0] === "download" && commandTokens.length >= 3) {
10
- return 2;
11
- }
12
- if (commandTokens[0] === "pdf" && commandTokens.length >= 2) {
13
- return 1;
14
- }
15
- if (commandTokens[0] === "state" && commandTokens[1] === "save" && commandTokens.length >= 3) {
16
- return 2;
17
- }
18
- if (commandTokens[0] === "wait") {
19
- return parseWaitCommandTokens(commandTokens).downloadPathIndex;
20
- }
21
- return undefined;
22
- }
23
- async function ensureArtifactParentDirectory(commandTokens, cwd) {
24
- const pathIndex = getArtifactParentPathTokenIndex(commandTokens);
25
- if (pathIndex === undefined) {
26
- return;
27
- }
28
- const requestedPath = commandTokens.at(pathIndex);
29
- if (requestedPath === undefined || requestedPath === "") {
30
- return;
31
- }
32
- await mkdir(dirname(resolve(cwd, requestedPath)), { recursive: true });
33
- }
34
- function screenshotPathIndex(commandTokens, batchStep) {
35
- if (batchStep) {
36
- return getScreenshotPathTokenIndex(commandTokens);
37
- }
38
- const projection = projectUpstreamGlobalFlags(commandTokens);
39
- const index = getScreenshotPathTokenIndex(projection.tokens);
40
- return index === undefined ? undefined : projection.indices[index];
41
- }
42
- async function normalizeScreenshotPathInTokens(commandTokens, cwd, batchStep = false) {
43
- const pathIndex = screenshotPathIndex(commandTokens, batchStep);
44
- if (pathIndex === undefined) {
45
- return { tokens: [...commandTokens] };
46
- }
47
- const requestedPath = commandTokens[pathIndex];
48
- const absolutePath = resolve(cwd, requestedPath);
49
- await mkdir(dirname(absolutePath), { recursive: true });
50
- const tokens = [...commandTokens];
51
- tokens[pathIndex] = absolutePath;
52
- const terminatorIndex = batchStep ? -1 : tokens.indexOf("--");
53
- if (terminatorIndex >= 0) {
54
- tokens.splice(terminatorIndex, 1);
55
- }
56
- return { request: { absolutePath, path: requestedPath }, tokens };
57
- }
58
- async function prepareRawBatchDirectories(steps, cwd) {
59
- for (const step of steps) {
60
- // Preserve native row ordering and fail at the first unwritable directory.
61
- // oxlint-disable-next-line no-await-in-loop
62
- await ensureArtifactParentDirectory(step, cwd);
63
- if (step[0] === "screenshot") {
64
- // Resolve only for mkdir: native raw row strings must remain unchanged.
65
- // oxlint-disable-next-line no-await-in-loop
66
- await normalizeScreenshotPathInTokens(step, cwd, true);
67
- }
68
- }
69
- }
70
- function isStringRow(value) {
71
- if (!Array.isArray(value)) {
72
- return false;
73
- }
74
- const items = value;
75
- return items.every((item) => typeof item === "string");
76
- }
77
- async function prepareBatchScreenshotPaths(args, stdin, cwd) {
78
- const commandTokens = extractUpstreamCommandTokens(args);
79
- if (commandTokens[0] !== "batch") {
80
- return undefined;
81
- }
82
- const argumentSteps = getUpstreamEffectiveBatchSteps(commandTokens, undefined);
83
- if (argumentSteps.length > 0) {
84
- await prepareRawBatchDirectories(argumentSteps, cwd);
85
- return undefined;
86
- }
87
- if (stdin === undefined) {
88
- return undefined;
89
- }
90
- const parsed = parseBatchStdinJsonArray(stdin);
91
- if (parsed.error !== undefined && parsed.error !== "") {
92
- return undefined;
93
- }
94
- if (parsed.steps === undefined) {
95
- return undefined;
96
- }
97
- const batchScreenshotPathRequests = [];
98
- const preparedSteps = await Promise.all(parsed.steps.map(async (step, index) => {
99
- if (!isStringRow(step)) {
100
- return step;
101
- }
102
- await ensureArtifactParentDirectory(step, cwd);
103
- if (step[0] !== "screenshot") {
104
- return step;
105
- }
106
- const normalized = await normalizeScreenshotPathInTokens(step, cwd, true);
107
- batchScreenshotPathRequests[index] = normalized.request;
108
- return normalized.tokens;
109
- }));
110
- if (!batchScreenshotPathRequests.some((request) => request !== undefined)) {
111
- return undefined;
112
- }
113
- return {
114
- args: [...args],
115
- batchScreenshotPathRequests: parsed.steps.flatMap((step, index) => Array.isArray(step) && step.length === 0 ? [] : [batchScreenshotPathRequests[index]]),
116
- stdin: JSON.stringify(preparedSteps),
117
- };
118
- }
119
- export async function prepareAgentBrowserArgs(args, stdin, cwd) {
120
- const preparedBatch = await prepareBatchScreenshotPaths(args, stdin, cwd);
121
- if (preparedBatch) {
122
- return preparedBatch;
123
- }
124
- const commandTokens = extractCommandTokens(args);
125
- await ensureArtifactParentDirectory(extractUpstreamCommandTokens(args), cwd);
126
- const normalized = await normalizeScreenshotPathInTokens(commandTokens, cwd);
127
- if (!normalized.request) {
128
- return { args: [...args] };
129
- }
130
- const commandStartIndex = args.length - commandTokens.length;
131
- return {
132
- args: [...args.slice(0, commandStartIndex), ...normalized.tokens],
133
- screenshotPathRequest: normalized.request,
134
- };
135
- }
136
- export async function repairScreenshotData(options) {
137
- const { cwd, data, request } = options;
138
- if (data.changed === false) {
139
- return { data };
140
- }
141
- const reportedPath = typeof data.path === "string" ? data.path : undefined;
142
- const reportedAbsolutePath = reportedPath !== undefined && reportedPath !== "" ? resolve(cwd, reportedPath) : undefined;
143
- let status = (await pathExists(request.absolutePath))
144
- ? "saved"
145
- : "missing";
146
- let tempPath;
147
- if (reportedAbsolutePath !== undefined && reportedAbsolutePath !== request.absolutePath) {
148
- tempPath = reportedAbsolutePath;
149
- if (status === "missing" && (await pathExists(reportedAbsolutePath))) {
150
- await mkdir(dirname(request.absolutePath), { recursive: true });
151
- await copyFile(reportedAbsolutePath, request.absolutePath);
152
- status = "repaired-from-temp";
153
- }
154
- }
155
- return {
156
- data: { ...data, path: request.absolutePath },
157
- request: { ...request, status, tempPath },
158
- };
159
- }
@@ -1,131 +0,0 @@
1
- import { prepareAgentBrowserSpawnArgs } from "../../process.js";
2
- import { redactInvocationArgs } from "../../runtime-redaction.js";
3
- import { getBooleanFlagValue } from "../../argv-grammar.js";
4
- import { prepareClickDispatchProbe } from "./click-dispatch.js";
5
- import { collectScrollPositionSnapshot } from "./diagnostics.js";
6
- import { preparationSessionDetails } from "./prepare-failure.js";
7
- import { buildInvocationPreview } from "./prepare-input.js";
8
- import { prepareProcessTimeout } from "./prepare-timeouts.js";
9
- function shouldProbeScrollNoop(managedSessionActive, context) {
10
- const plan = context.semantic.selection.executionPlan;
11
- const amount = Number(context.semantic.commandTokens.find((token) => /^\d+(?:\.\d+)?$/.test(token)));
12
- return (plan.commandInfo.command === "scroll" &&
13
- plan.startupScopedFlags.length === 0 &&
14
- (managedSessionActive || context.sessionMode === "fresh") &&
15
- (!Number.isFinite(amount) || amount >= 500));
16
- }
17
- function redactedSemanticAction(context) {
18
- const compiled = context.input.redactedCompiledSemanticAction;
19
- return context.semantic.resolution && compiled?.action === "select"
20
- ? { ...compiled, args: redactInvocationArgs(context.semantic.resolution.args) }
21
- : compiled;
22
- }
23
- async function nativeCommandEvidence(facts, context) {
24
- const plan = context.semantic.selection.executionPlan;
25
- const page = context.semantic.selection.page;
26
- const promptSnapshot = context.semantic.resolvedSnapshot ?? page.priorRefSnapshotState;
27
- const processStdin = context.preparedArgs.stdin ?? context.stdin;
28
- const processTimeoutMs = await prepareProcessTimeout(facts, {
29
- commandTokens: context.semantic.commandTokens,
30
- namespace: plan.namespace,
31
- sessionName: plan.sessionName,
32
- stdin: processStdin,
33
- pageUrl: page.priorSessionTabTarget?.url,
34
- refSnapshot: promptSnapshot,
35
- });
36
- const clickDispatchProbe = context.input.compiledElectron === undefined
37
- ? await prepareClickDispatchProbe({
38
- commandTokens: [...context.semantic.commandTokens],
39
- cwd: facts.cwd,
40
- namespace: plan.namespace,
41
- refSnapshot: promptSnapshot,
42
- sessionName: plan.sessionName,
43
- signal: facts.signal,
44
- timeoutMs: processTimeoutMs,
45
- })
46
- : undefined;
47
- const redactedProcessArgs = redactInvocationArgs(prepareAgentBrowserSpawnArgs(plan.effectiveArgs, context.session.ownedManagedSession?.compatibilityUserAgent, facts.preserveAttachedBrowserSession, context.chromeStartupArgs));
48
- const probeScroll = shouldProbeScrollNoop(facts.managedSessionActive, context);
49
- const scrollPositionBefore = probeScroll
50
- ? await collectScrollPositionSnapshot({
51
- cwd: facts.cwd,
52
- namespace: plan.namespace,
53
- sessionName: plan.sessionName,
54
- signal: facts.signal,
55
- })
56
- : undefined;
57
- facts.onUpdate?.({
58
- content: [
59
- {
60
- type: "text",
61
- text: `Running agent-browser ${buildInvocationPreview(redactedProcessArgs)}`,
62
- },
63
- ],
64
- details: {
65
- compatibilityWorkaround: plan.compatibilityWorkaround,
66
- effectiveArgs: redactedProcessArgs,
67
- sessionMode: context.sessionMode,
68
- sessionTabCorrection: context.semantic.selection.sessionTabCorrection,
69
- ...preparationSessionDetails(facts.isRestoreDisabled(), plan),
70
- },
71
- });
72
- return {
73
- processArgs: plan.effectiveArgs,
74
- processStdin,
75
- processTimeoutMs,
76
- clickDispatchProbe,
77
- redactedProcessArgs,
78
- shouldProbeScrollNoop: probeScroll,
79
- scrollPositionBefore,
80
- };
81
- }
82
- export async function prepareNativeCommand(facts, context, evidence) {
83
- const native = await nativeCommandEvidence(facts, context);
84
- const plan = context.semantic.selection.executionPlan;
85
- const page = context.semantic.selection.page;
86
- const input = context.input;
87
- return {
88
- kind: "ready",
89
- prepared: {
90
- compiledElectron: input.compiledElectron,
91
- compiledJob: input.compiledJob,
92
- compiledNetworkSourceLookup: input.compiledNetworkSourceLookup,
93
- compiledQaPreset: input.compiledQaPreset,
94
- compiledSemanticAction: input.compiledSemanticAction,
95
- compiledSourceLookup: input.compiledSourceLookup,
96
- redactedArgs: input.redactedArgs,
97
- redactedCompiledElectron: input.redactedCompiledElectron,
98
- redactedCompiledJob: input.redactedCompiledJob,
99
- redactedCompiledNetworkSourceLookup: input.redactedCompiledNetworkSourceLookup,
100
- redactedCompiledQaPreset: input.redactedCompiledQaPreset,
101
- redactedCompiledSourceLookup: input.redactedCompiledSourceLookup,
102
- ...native,
103
- chromeStartupArgs: context.chromeStartupArgs,
104
- commandTokens: [...context.semantic.commandTokens],
105
- headedLaunch: context.session.headedLaunch,
106
- providerLaunch: context.session.providerLaunch,
107
- managedSessionPolicyLock: context.policy.lock,
108
- compatibilityWorkaround: plan.compatibilityWorkaround,
109
- electronLaunch: context.electronLaunch,
110
- exactSensitiveValues: [...evidence.exactSensitiveValues],
111
- executionPlan: plan,
112
- ownedManagedSessionContext: context.session.ownedManagedSession,
113
- preparedArgs: context.preparedArgs,
114
- readConfirmation: context.session.readConfirmation,
115
- priorRefSnapshotState: page.priorRefSnapshotState,
116
- priorSessionTabTarget: page.priorSessionTabTarget,
117
- priorSessionTabTargetUnknown: page.priorSessionTabTargetUnknown,
118
- redactedCompiledSemanticAction: redactedSemanticAction(context),
119
- redactedEffectiveArgs: [...evidence.redactedEffectiveArgs],
120
- redactedRecoveryHint: evidence.redactedRecoveryHint,
121
- resolvedSemanticActionRefSnapshot: context.semantic.resolvedSnapshot,
122
- runtimeToolArgs: [...context.runtimeToolArgs],
123
- runtimeToolStdin: context.stdin,
124
- sessionMode: context.sessionMode,
125
- sessionTabCorrection: context.semantic.selection.sessionTabCorrection,
126
- sessionTabPinningReason: page.sessionTabPinningReason,
127
- statePatch: evidence.statePatch,
128
- userRequestedJson: getBooleanFlagValue(context.runtimeToolArgs, "--json") === true,
129
- },
130
- };
131
- }
@@ -1,93 +0,0 @@
1
- import { parseArgvDescriptor } from "../../argv-descriptor.js";
2
- import { needsManagedSession } from "../../command-policy.js";
3
- import { isCloseCommand } from "../../command-taxonomy.js";
4
- import { acquireOwnedManagedSessionDaemonPolicy, inspectManagedSessionDaemon, } from "./managed-session-daemon-policy.js";
5
- import { planHasValidationError, withPlanValidationError, } from "./prepare-session-plan.js";
6
- function daemonReuseError(plan, session, policy) {
7
- if (policy.error !== undefined && policy.error !== "") {
8
- return policy.error;
9
- }
10
- if (isCloseCommand(plan.commandInfo.command) || policy.daemonStatus !== "active") {
11
- return undefined;
12
- }
13
- if (session.offCurrentLaunchScopedFlags.length > 0) {
14
- return `This older wrapper-owned session is already running, so launch-scoped flags ${session.offCurrentLaunchScopedFlags.join(", ")} would replace or be ignored by upstream agent-browser. Close it first, or remove the explicit --session and retry with sessionMode: "fresh".`;
15
- }
16
- if (session.offCurrentCompatibilityUpgrade) {
17
- return 'This older wrapper-owned session is already running without the user agent required by this site. Close it first, or remove the explicit --session and retry with sessionMode: "fresh".';
18
- }
19
- return undefined;
20
- }
21
- function applyColdCompatibility(plan, session, context, status) {
22
- if (isCloseCommand(plan.commandInfo.command) ||
23
- status !== "inactive" ||
24
- session.compatibilityUserAgent === undefined ||
25
- session.compatibilityUserAgent === "" ||
26
- session.compatibilityUserAgentApplied) {
27
- return { plan, ownedManagedSession: context };
28
- }
29
- return {
30
- ownedManagedSession: { ...context, compatibilityUserAgent: session.compatibilityUserAgent },
31
- plan: {
32
- ...plan,
33
- effectiveArgs: ["--user-agent", session.compatibilityUserAgent, ...plan.effectiveArgs],
34
- },
35
- };
36
- }
37
- export async function prepareDaemonPolicy(process, electronLaunchRecord, planning) {
38
- const { plan, session } = planning;
39
- const context = session.ownedManagedSession;
40
- if (session.browserIndependent || planHasValidationError(plan) || !context) {
41
- return { plan, session, policy: { inactive: false } };
42
- }
43
- const policy = await acquireOwnedManagedSessionDaemonPolicy({
44
- context,
45
- electronLaunchRecord,
46
- electronVerificationTimeoutMs: process.timeoutMs,
47
- mode: isCloseCommand(plan.commandInfo.command) ? "close" : "reuse",
48
- signal: process.signal,
49
- });
50
- const error = daemonReuseError(plan, session, policy);
51
- const resolved = error !== undefined && error !== ""
52
- ? { plan: withPlanValidationError(plan, error), ownedManagedSession: context }
53
- : applyColdCompatibility(plan, session, context, policy.daemonStatus);
54
- return {
55
- plan: resolved.plan,
56
- session: { ...session, ownedManagedSession: resolved.ownedManagedSession },
57
- policy: {
58
- lock: policy.lock,
59
- inactive: policy.daemonStatus === "inactive",
60
- cleanupOnlyReason: policy.error !== undefined && policy.error !== "" ? policy.cleanupOnlyReason : undefined,
61
- },
62
- };
63
- }
64
- function chromeStartupEligible(facts, plan, request) {
65
- return (facts.chromeStartupArgs !== undefined &&
66
- facts.preserveAttachedBrowserSession !== true &&
67
- !request.browserIndependent &&
68
- !planHasValidationError(plan) &&
69
- !isCloseCommand(plan.commandInfo.command) &&
70
- needsManagedSession(parseArgvDescriptor(request.preparedArgs.args), request.stdin));
71
- }
72
- export async function prepareChromeStartupArgs(facts, planning, request) {
73
- if (!chromeStartupEligible(facts, planning.plan, {
74
- ...request,
75
- browserIndependent: planning.session.browserIndependent,
76
- })) {
77
- return undefined;
78
- }
79
- const { plan, session, policy } = planning;
80
- let inactive = policy.inactive;
81
- if (!session.ownedManagedSession) {
82
- inactive =
83
- facts.daemonInactive ??
84
- (plan.sessionName !== undefined &&
85
- (await inspectManagedSessionDaemon({
86
- cwd: facts.cwd,
87
- signal: facts.signal,
88
- sessionName: plan.sessionName,
89
- namespace: plan.namespace,
90
- })).status === "inactive");
91
- }
92
- return inactive || facts.configuredChromeLaunch === true ? facts.chromeStartupArgs : undefined;
93
- }