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,142 +0,0 @@
1
- import { inspectElectronLaunchStatus } from "../../electron/cleanup.js";
2
- import { commandExplicitlyTargetsAboutBlank, isAboutBlankSessionTabTarget, normalizeSessionTabTarget, } from "../../session-page-state.js";
3
- import { extractUpstreamCommandTokens } from "../../argv-descriptor.js";
4
- import { applyOpenResultTabCorrection, buildAboutBlankRecoveryHint, buildElectronPostCommandHealthDiagnostic, buildElectronSessionMismatch, collectSessionTabSelection, findElectronLaunchRecordForSession, shouldCorrectSessionTabAfterCommand, shouldInspectElectronPostCommandHealth, } from "./session-state.js";
5
- import { sleepMs } from "./diagnostics.js";
6
- function unexpectedBlankTarget(draft) {
7
- const explicitBlank = draft.dispatchedCommands.some((step) => commandExplicitlyTargetsAboutBlank(extractUpstreamCommandTokens(step)));
8
- return (draft.succeeded &&
9
- !draft.tabTransition &&
10
- !draft.destinationTransition &&
11
- !explicitBlank &&
12
- draft.nestedBatchClose === undefined &&
13
- draft.input.prepared.priorSessionTabTarget !== undefined &&
14
- !isAboutBlankSessionTabTarget(draft.input.prepared.priorSessionTabTarget) &&
15
- isAboutBlankSessionTabTarget(draft.observedSessionTabTarget ?? draft.currentSessionTabTarget));
16
- }
17
- async function inspectBlankElectronMismatch(draft, observed) {
18
- const { prepared, state } = draft.input;
19
- const record = findElectronLaunchRecordForSession(prepared.executionPlan.sessionName, state.electronLaunchRecords, prepared.executionPlan.namespace);
20
- const sessionName = prepared.executionPlan.sessionName;
21
- if (!record || sessionName === undefined || sessionName.length === 0) {
22
- return;
23
- }
24
- draft.electronStatusAfterCommand = await inspectElectronLaunchStatus(record);
25
- draft.electronSessionMismatch = buildElectronSessionMismatch({
26
- managedSession: { sessionName, title: observed?.title, url: observed?.url ?? "about:blank" },
27
- record,
28
- statusTargets: draft.electronStatusAfterCommand.targets,
29
- });
30
- }
31
- export async function recoverUnexpectedBlankTarget(draft) {
32
- const { prepared, cwd, signal } = draft.input;
33
- draft.sessionTabCorrection = prepared.sessionTabCorrection;
34
- const prior = prepared.priorSessionTabTarget;
35
- if (!unexpectedBlankTarget(draft) || !prior) {
36
- return;
37
- }
38
- const observed = draft.observedSessionTabTarget ?? draft.currentSessionTabTarget;
39
- const correction = await collectSessionTabSelection({
40
- cwd,
41
- namespace: prepared.executionPlan.namespace,
42
- sessionName: prepared.executionPlan.sessionName,
43
- signal,
44
- target: prior,
45
- });
46
- const applied = correction
47
- ? await applyOpenResultTabCorrection({
48
- correction,
49
- cwd,
50
- namespace: prepared.executionPlan.namespace,
51
- sessionName: prepared.executionPlan.sessionName,
52
- signal,
53
- })
54
- : undefined;
55
- if (applied) {
56
- draft.sessionTabCorrection = applied;
57
- draft.currentSessionTabTarget = prior;
58
- }
59
- else {
60
- draft.currentSessionTabTarget = observed ?? normalizeSessionTabTarget({ url: "about:blank" });
61
- }
62
- draft.aboutBlankSessionMismatch = {
63
- activeUrl: "about:blank",
64
- recoveryApplied: applied !== undefined,
65
- recoveryHint: buildAboutBlankRecoveryHint(),
66
- targetTitle: prior.title,
67
- targetUrl: prior.url,
68
- };
69
- await inspectBlankElectronMismatch(draft, observed);
70
- }
71
- function needsPostCommandPinning(draft) {
72
- const { prepared } = draft.input;
73
- return (draft.succeeded &&
74
- prepared.priorSessionTabTarget !== undefined &&
75
- !draft.sessionTabCorrection &&
76
- !draft.aboutBlankSessionMismatch &&
77
- !commandExplicitlyTargetsAboutBlank(prepared.commandTokens) &&
78
- shouldCorrectSessionTabAfterCommand({
79
- command: prepared.executionPlan.commandInfo.command,
80
- pinningRequired: prepared.sessionTabPinningReason !== undefined,
81
- sessionName: prepared.executionPlan.sessionName,
82
- }));
83
- }
84
- export async function pinPostCommandTarget(draft) {
85
- const target = draft.observedSessionTabTarget;
86
- if (!needsPostCommandPinning(draft) || !target) {
87
- return;
88
- }
89
- const { prepared, cwd, signal } = draft.input;
90
- const correction = await collectSessionTabSelection({
91
- cwd,
92
- namespace: prepared.executionPlan.namespace,
93
- sessionName: prepared.executionPlan.sessionName,
94
- signal,
95
- target,
96
- });
97
- if (!correction) {
98
- return;
99
- }
100
- const applied = await applyOpenResultTabCorrection({
101
- correction,
102
- cwd,
103
- namespace: prepared.executionPlan.namespace,
104
- sessionName: prepared.executionPlan.sessionName,
105
- signal,
106
- });
107
- // The draft is per-call and is never passed to either helper; no external writer can install a correction here.
108
- if (applied) {
109
- draft.sessionTabCorrection = applied;
110
- }
111
- }
112
- export async function inspectElectronHealth(draft) {
113
- const { prepared, state } = draft.input;
114
- draft.electronRecordForCommand = findElectronLaunchRecordForSession(prepared.executionPlan.sessionName, state.electronLaunchRecords, prepared.executionPlan.namespace);
115
- const record = draft.electronRecordForCommand;
116
- if (!draft.succeeded ||
117
- !record ||
118
- !shouldInspectElectronPostCommandHealth(prepared.executionPlan.commandInfo.command)) {
119
- return;
120
- }
121
- draft.electronStatusAfterCommand ??= await inspectElectronLaunchStatus(record);
122
- draft.electronPostCommandHealth = buildElectronPostCommandHealthDiagnostic({
123
- command: prepared.executionPlan.commandInfo.command,
124
- record,
125
- status: draft.electronStatusAfterCommand,
126
- target: draft.observedSessionTabTarget ?? draft.currentSessionTabTarget,
127
- });
128
- if (draft.electronPostCommandHealth &&
129
- draft.electronPostCommandHealth.reason !== "process-dead") {
130
- await sleepMs(draft.input.electronPostCommandStatusSettleMs);
131
- draft.electronStatusAfterCommand = await inspectElectronLaunchStatus(record);
132
- draft.electronPostCommandHealth = buildElectronPostCommandHealthDiagnostic({
133
- command: prepared.executionPlan.commandInfo.command,
134
- record,
135
- status: draft.electronStatusAfterCommand,
136
- target: draft.observedSessionTabTarget ?? draft.currentSessionTabTarget,
137
- });
138
- }
139
- if (draft.electronPostCommandHealth) {
140
- draft.succeeded = false;
141
- }
142
- }
@@ -1,25 +0,0 @@
1
- import { rm } from "node:fs/promises";
2
- import { captureBrowserOutputOwnership } from "./process-output-ownership.js";
3
- import { observeNativeEffects } from "./process-output-native-phase.js";
4
- import { observePageEffects } from "./process-output-page-phase.js";
5
- import { commitLifecycleEffects } from "./process-output-lifecycle-phase.js";
6
- import { publishOutputEffects } from "./process-output-publication-phase.js";
7
- import { buildOutputResult } from "./process-output-publication.js";
8
- export async function processBrowserOutput(input) {
9
- const ownership = captureBrowserOutputOwnership(input);
10
- try {
11
- const native = await observeNativeEffects(input, ownership);
12
- const page = await observePageEffects(input, native);
13
- const lifecycle = await commitLifecycleEffects(input, native, page, ownership);
14
- const { publication, recovery } = await publishOutputEffects(input, native, page, lifecycle);
15
- return buildOutputResult({ input, native, page, lifecycle, publication }, recovery);
16
- }
17
- finally {
18
- const path = input.processResult.stdoutSpillPath;
19
- if (path !== undefined && path.length > 0) {
20
- await rm(path, { force: true }).catch(() => {
21
- // This raw spool is disposable and may already be removed; cleanup must not replace the native outcome or a publication failure.
22
- });
23
- }
24
- }
25
- }
@@ -1,50 +0,0 @@
1
- import { isAbsolute, resolve } from "node:path";
2
- import { isCloseCommand } from "../../command-taxonomy.js";
3
- import { executableExistsOnPath } from "../../executable-path.js";
4
- function resolveArtifactPath(cwd, path) {
5
- return isAbsolute(path) ? path : resolve(cwd, path);
6
- }
7
- function manifestContainsArtifact(manifest, cwd, artifact) {
8
- if (!manifest) {
9
- return false;
10
- }
11
- const requestedAbsolutePath = resolveArtifactPath(cwd, artifact.path);
12
- const expectedKind = artifact.kind === "screenshot" ? "image" : "video";
13
- return manifest.entries.some((entry) => {
14
- const entryAbsolutePath = entry.absolutePath ?? resolveArtifactPath(cwd, entry.path);
15
- return (entry.storageScope === "explicit-path" &&
16
- entry.kind === expectedKind &&
17
- entryAbsolutePath === requestedAbsolutePath &&
18
- entry.retentionState === "live" &&
19
- entry.exists === true);
20
- });
21
- }
22
- async function isArtifactRequired(artifact) {
23
- if (artifact.required) {
24
- return true;
25
- }
26
- return artifact.kind === "recording" && (await executableExistsOnPath("ffmpeg"));
27
- }
28
- export async function findRequestedArtifactCloseViolation(options) {
29
- if (!isCloseCommand(options.command)) {
30
- return undefined;
31
- }
32
- const requirements = await Promise.all(options.promptPolicy.requestedArtifacts.map(async (artifact) => ({
33
- artifact,
34
- required: await isArtifactRequired(artifact),
35
- })));
36
- const missingArtifacts = requirements
37
- .filter(({ artifact, required }) => required && !manifestContainsArtifact(options.artifactManifest, options.cwd, artifact))
38
- .map(({ artifact }) => artifact);
39
- if (missingArtifacts.length === 0) {
40
- return undefined;
41
- }
42
- const missingList = missingArtifacts
43
- .map((artifact) => `${artifact.kind}: ${artifact.path}`)
44
- .join(", ");
45
- return {
46
- message: `Blocked browser close because requested artifact path${missingArtifacts.length === 1 ? " is" : "s are"} missing or unverified: ${missingList}. Save the requested artifact path first, or report why an optional artifact is unavailable before closing.`,
47
- missingArtifacts,
48
- reason: "requested-artifacts-missing-before-close",
49
- };
50
- }
@@ -1,198 +0,0 @@
1
- import { resolve } from "node:path";
2
- import { getAgentBrowserSessionIdentityKey } from "../../argv-grammar.js";
3
- import { getRecordCommandOperands } from "../../command-taxonomy.js";
4
- import { isRecord } from "../../parsing.js";
5
- import { extractEnvelopeErrorText } from "../../results/envelope.js";
6
- import { getRecordingReceipt } from "../../results/recording.js";
7
- import { getUpstreamEffectiveBatchSteps } from "../batch-stdin.js";
8
- import { diagnosticErrorText } from "./diagnostic-values.js";
9
- import { runSessionCommandData } from "./session-state.js";
10
- export function isRecordingStop(tokens) {
11
- return tokens[0] === "record" && tokens[1] === "stop";
12
- }
13
- function rowError(row) {
14
- return isRecord(row) ? row.error : undefined;
15
- }
16
- function rowResult(row) {
17
- return isRecord(row) && isRecord(row.result) ? row.result : undefined;
18
- }
19
- function stopNeedsRecovery(options, row) {
20
- return (options.processResult.timedOut ||
21
- /no recording in progress/i.test(extractEnvelopeErrorText(rowError(row) ?? options.envelope?.error) ?? ""));
22
- }
23
- function reservationForStart(options, step, row) {
24
- if (step[0] !== "record" || !["start", "restart"].includes(step[1] ?? "")) {
25
- return undefined;
26
- }
27
- if (isRecord(row) && row.success === false) {
28
- return undefined;
29
- }
30
- return buildStartReservation(options, step, rowResult(row));
31
- }
32
- function buildStartReservation(options, step, started) {
33
- const path = typeof started?.path === "string" ? started.path : getRecordCommandOperands(step).path;
34
- if (path === undefined ||
35
- path === "" ||
36
- options.sessionName === undefined ||
37
- options.sessionName === "") {
38
- return undefined;
39
- }
40
- return {
41
- absolutePath: resolve(options.cwd, path),
42
- cwd: options.cwd,
43
- path,
44
- namespace: options.namespace,
45
- sessionName: options.sessionName,
46
- recordingId: typeof started?.recordingId === "string" ? started.recordingId : undefined,
47
- startedAtMs: options.artifactRunStartedAtMs,
48
- };
49
- }
50
- function recoverySource(options) {
51
- const batch = options.commandTokens[0] === "batch";
52
- return {
53
- batch,
54
- steps: batch
55
- ? getUpstreamEffectiveBatchSteps(options.commandTokens, options.stdin)
56
- : [options.commandTokens],
57
- rows: batch && Array.isArray(options.envelope?.data) ? options.envelope.data : undefined,
58
- };
59
- }
60
- function originalAttempt(options, stopRow) {
61
- const error = options.processResult.timedOut
62
- ? `Record stop timed out after ${options.processResult.timeoutMs ?? "undefined"} ms.`
63
- : (extractEnvelopeErrorText(rowError(stopRow) ?? options.envelope?.error) ??
64
- "Record stop did not return a receipt.");
65
- return {
66
- success: false,
67
- exitCode: options.processResult.exitCode,
68
- timedOut: options.processResult.timedOut,
69
- error,
70
- parseError: options.parseError,
71
- };
72
- }
73
- function recordingAttemptWasInterrupted(options) {
74
- return (options.processResult.aborted ||
75
- (options.signal?.aborted ?? false) ||
76
- !options.processResult.agentBrowserStarted);
77
- }
78
- export function planRecordingRecovery(options) {
79
- if (recordingAttemptWasInterrupted(options)) {
80
- return undefined;
81
- }
82
- const { batch, steps, rows } = recoverySource(options);
83
- const stopIndex = steps.reduce((last, step, index) => isRecordingStop(step) && stopNeedsRecovery(options, rows?.at(index)) ? index : last, -1);
84
- if (stopIndex < 0) {
85
- return undefined;
86
- }
87
- let expected = options.reservation;
88
- for (const [index, step] of steps.slice(0, stopIndex).entries()) {
89
- expected = reservationForStart(options, step, rows?.at(index)) ?? expected;
90
- }
91
- return {
92
- batch,
93
- rows,
94
- stopIndex,
95
- expected,
96
- attempt: originalAttempt(options, rows?.at(stopIndex)),
97
- };
98
- }
99
- function receiptMatches(receipt, expected, nowMs) {
100
- if (resolve(expected.cwd, receipt.path) !== expected.absolutePath) {
101
- return false;
102
- }
103
- if (expected.recordingId !== undefined && expected.recordingId !== "") {
104
- return receipt.recordingId === expected.recordingId;
105
- }
106
- const startedAtMs = Date.parse(receipt.capture.startedAt ?? "");
107
- return (expected.startedAtMs !== undefined &&
108
- startedAtMs >= expected.startedAtMs &&
109
- startedAtMs <= nowMs);
110
- }
111
- function sameNativeSession(info, options) {
112
- if (!isRecord(info) || typeof info.session !== "string" || options.sessionName === undefined) {
113
- return false;
114
- }
115
- return (getAgentBrowserSessionIdentityKey(info.session, typeof info.namespace === "string" ? info.namespace : undefined) === getAgentBrowserSessionIdentityKey(options.sessionName, options.namespace));
116
- }
117
- function reconcileNativeReceipts(info, options, expected) {
118
- const recordings = nativeRecordingState(info);
119
- const current = getRecordingReceipt(recordings?.current);
120
- const unavailable = {
121
- current,
122
- status: "unavailable",
123
- reason: "Native session info did not provide a matching recording receipt. File presence alone cannot prove successful recording finalization.",
124
- };
125
- if (!recordings) {
126
- return unavailable;
127
- }
128
- if (!sameNativeSession(info, options)) {
129
- return {
130
- current,
131
- status: "mismatch",
132
- reason: "Native session info reported a different namespace/session; its recording receipt was not used.",
133
- };
134
- }
135
- if (!expected) {
136
- return unavailable;
137
- }
138
- for (const candidate of [recordings.current, recordings.last]) {
139
- const receipt = getRecordingReceipt(candidate);
140
- if (receipt && receiptMatches(receipt, expected, Date.now())) {
141
- return { ...unavailable, receipt, data: candidate };
142
- }
143
- }
144
- return {
145
- current,
146
- status: "mismatch",
147
- reason: "Native recording IDs, paths or capture windows did not match this attempt; unrelated receipt measurements were not used.",
148
- };
149
- }
150
- function nativeRecordingState(info) {
151
- const runtime = isRecord(info) && isRecord(info.runtime) ? info.runtime : undefined;
152
- return isRecord(runtime?.recording) ? runtime.recording : undefined;
153
- }
154
- export async function collectRecordingReceiptEvidence(options, expected) {
155
- try {
156
- const info = await runSessionCommandData({
157
- args: ["session", "info"],
158
- cwd: options.cwd,
159
- namespace: options.namespace,
160
- pinNamespace: true,
161
- sessionName: options.sessionName,
162
- signal: options.signal,
163
- timeoutMs: 2_000,
164
- });
165
- return reconcileNativeReceipts(info, options, expected);
166
- }
167
- catch (error) {
168
- return {
169
- status: "unavailable",
170
- reason: `Native session info was unavailable: ${diagnosticErrorText(error)}. File presence alone cannot prove successful recording finalization.`,
171
- };
172
- }
173
- }
174
- export function anotherTakeUsesPath(evidence, expected) {
175
- const { current, receipt } = evidence;
176
- return (current !== undefined &&
177
- receipt !== undefined &&
178
- expected !== undefined &&
179
- current.recordingId !== receipt.recordingId &&
180
- resolve(expected.cwd, current.path) === expected.absolutePath);
181
- }
182
- function encodedOutputIsComplete(receipt) {
183
- return (receipt.success === true &&
184
- receipt.output.encoderSucceeded === true &&
185
- receipt.output.encodedFrames !== null &&
186
- receipt.output.encodedFrames > 0 &&
187
- receipt.file.exists === true &&
188
- receipt.file.sizeBytes !== null &&
189
- receipt.file.sizeBytes > 0);
190
- }
191
- export function recordingHasTerminalMeasurements(evidence, expected) {
192
- const receipt = evidence.receipt;
193
- return (receipt !== undefined &&
194
- encodedOutputIsComplete(receipt) &&
195
- Number.isFinite(Date.parse(receipt.capture.startedAt ?? "")) &&
196
- Number.isFinite(Date.parse(receipt.capture.endedAt ?? "")) &&
197
- !anotherTakeUsesPath(evidence, expected));
198
- }
@@ -1,154 +0,0 @@
1
- import { buildToolPresentation } from "../../results/presentation.js";
2
- import { isRecord } from "../../parsing.js";
3
- import { anotherTakeUsesPath, } from "./recording-receipt-reconciliation.js";
4
- export function recordingRecoveryData(plan, evidence) {
5
- return (evidence.data ??
6
- (plan.expected
7
- ? { path: plan.expected.absolutePath, recordingId: plan.expected.recordingId, success: null }
8
- : undefined));
9
- }
10
- export async function presentRecordingReceipt(options, plan, evidence, terminalMeasurements) {
11
- const expected = plan.expected;
12
- const data = recordingRecoveryData(plan, evidence);
13
- return buildToolPresentation({
14
- modelVisible: options.modelVisible,
15
- artifactManifest: options.artifactManifest,
16
- artifactMinUpdatedAtMs: expected?.startedAtMs ?? options.artifactRunStartedAtMs,
17
- artifactMaxUpdatedAtMs: Date.now(),
18
- artifactRequest: expected
19
- ? {
20
- path: expected.path,
21
- absolutePath: expected.absolutePath,
22
- status: terminalMeasurements ? undefined : "unverified",
23
- }
24
- : undefined,
25
- commandInfo: { command: "record", subcommand: "stop" },
26
- cwd: expected?.cwd ?? options.cwd,
27
- envelope: { success: evidence.receipt?.success === true, data },
28
- namespace: options.namespace,
29
- sessionName: options.sessionName,
30
- recordingPending: evidence.receipt
31
- ? evidence.receipt.success === null
32
- : options.processResult.timedOut,
33
- });
34
- }
35
- export function classifyRecordingRecovery(evidence, plan, verified) {
36
- const receipt = evidence.receipt;
37
- if (!receipt) {
38
- return { status: evidence.status, reason: evidence.reason };
39
- }
40
- if (verified) {
41
- return {
42
- status: "recovered",
43
- reason: "Native terminal success and encoder measurements match the expected recording and the verified file.",
44
- };
45
- }
46
- if (receipt.success === null) {
47
- return {
48
- status: "pending",
49
- reason: "The matching native take is still pending; no terminal success was reported.",
50
- };
51
- }
52
- if (!receipt.success) {
53
- return {
54
- status: "failed",
55
- reason: `The matching native receipt reports failure: ${receipt.error ?? "unknown encoder/capture failure"}.`,
56
- };
57
- }
58
- return {
59
- status: "unverified",
60
- reason: anotherTakeUsesPath(evidence, plan.expected)
61
- ? "Another active recording uses this path. The previous receipt cannot verify the new take's file."
62
- : "A matching receipt was found, but successful encoding and a matching fresh file could not both be verified.",
63
- };
64
- }
65
- export function repairRecordingEnvelope(options, plan, data, verified) {
66
- if (plan.rows) {
67
- const rows = plan.rows.map((row, index) => index === plan.stopIndex && isRecord(row)
68
- ? { ...row, result: data, success: verified, error: verified ? undefined : row.error }
69
- : row);
70
- const healed = verified &&
71
- !options.processResult.timedOut &&
72
- rows.every((row) => isRecord(row) && row.success === true);
73
- return {
74
- healed,
75
- envelope: {
76
- success: healed,
77
- data: rows,
78
- error: healed ? undefined : options.envelope?.error,
79
- },
80
- };
81
- }
82
- if (!plan.batch) {
83
- return {
84
- healed: verified,
85
- envelope: { success: verified, data, error: verified ? undefined : plan.attempt.error },
86
- };
87
- }
88
- return { healed: false, envelope: options.envelope };
89
- }
90
- function recordingSessionArgs(options, command) {
91
- return [
92
- "--namespace",
93
- options.namespace ?? "",
94
- "--session",
95
- options.sessionName ?? "",
96
- ...command,
97
- ];
98
- }
99
- function pendingTakeIsCurrent(evidence, recovery) {
100
- return (evidence.current !== undefined &&
101
- evidence.receipt !== undefined &&
102
- evidence.current.recordingId === evidence.receipt.recordingId &&
103
- recovery.status === "pending");
104
- }
105
- function buildRecordingFollowups(options, evidence, recovery) {
106
- if (options.sessionName === undefined || options.sessionName === "") {
107
- return [];
108
- }
109
- const actions = recovery.healed
110
- ? []
111
- : [
112
- {
113
- id: "inspect-recording-receipt",
114
- tool: "agent_browser",
115
- params: { args: recordingSessionArgs(options, ["session", "info"]) },
116
- reason: "Inspect the native current/last recording receipts for this exact session.",
117
- safety: "Read-only status; does not launch or retarget the browser. Do not infer encoding success from an existing file.",
118
- },
119
- ];
120
- if (pendingTakeIsCurrent(evidence, recovery)) {
121
- actions.push({
122
- id: "stop-pending-recording",
123
- tool: "agent_browser",
124
- params: { args: recordingSessionArgs(options, ["record", "stop"]) },
125
- reason: `Finalize the still-current native recording ${evidence.receipt?.recordingId ?? "null"}; it has not reported a terminal outcome.`,
126
- safety: "Run only while this same recording remains current. No repeated stop was dispatched during recovery.",
127
- });
128
- }
129
- return actions;
130
- }
131
- export function finishRecordingPresentation(options, presentation, evidence, recovery) {
132
- const content = [...presentation.content];
133
- if (options.modelVisible !== false) {
134
- content.unshift({
135
- type: "text",
136
- text: `Recording receipt recovery (${recovery.status}): ${recovery.reason}\nOriginal attempt: ${recovery.attempt.error}`,
137
- });
138
- }
139
- const failure = recovery.healed
140
- ? {}
141
- : {
142
- resultCategory: "failure",
143
- failureCategory: options.processResult.timedOut ? "timeout" : "upstream-error",
144
- successCategory: undefined,
145
- summary: `${recovery.attempt.error} ${recovery.reason}`,
146
- };
147
- return {
148
- ...presentation,
149
- ...failure,
150
- content,
151
- nextActions: buildRecordingFollowups(options, evidence, recovery),
152
- recordingRecovery: recovery,
153
- };
154
- }
@@ -1,80 +0,0 @@
1
- import { isPendingRecordingArtifact, mergeSessionArtifactManifest, } from "../../results/artifact-manifest.js";
2
- import { appendUniqueAgentBrowserNextActions } from "../../results/next-actions.js";
3
- import { buildArtifactVerificationSummary, buildManifestEntriesForFileArtifacts, } from "../../results/presentation/artifacts.js";
4
- import { collectRecordingReceiptEvidence, isRecordingStop, planRecordingRecovery, recordingHasTerminalMeasurements, } from "./recording-receipt-reconciliation.js";
5
- import { classifyRecordingRecovery, finishRecordingPresentation, presentRecordingReceipt, repairRecordingEnvelope, recordingRecoveryData, } from "./recording-recovery-presentation.js";
6
- export async function recoverRecordingStop(options) {
7
- const plan = planRecordingRecovery(options);
8
- if (!plan) {
9
- return undefined;
10
- }
11
- const evidence = await collectRecordingReceiptEvidence(options, plan.expected);
12
- const terminalMeasurements = recordingHasTerminalMeasurements(evidence, plan.expected);
13
- const presentation = await presentRecordingReceipt(options, plan, evidence, terminalMeasurements);
14
- const verified = terminalMeasurements &&
15
- presentation.artifactVerification?.verified === true &&
16
- presentation.artifacts?.at(0)?.sizeBytes === evidence.receipt?.file.sizeBytes;
17
- const data = recordingRecoveryData(plan, evidence);
18
- const repaired = repairRecordingEnvelope(options, plan, data, verified);
19
- const recovery = {
20
- attempt: plan.attempt,
21
- expected: plan.expected,
22
- healed: repaired.healed,
23
- namespace: options.namespace,
24
- sessionName: options.sessionName,
25
- source: "session-info",
26
- receipt: evidence.receipt,
27
- ...classifyRecordingRecovery(evidence, plan, verified),
28
- };
29
- return {
30
- batch: plan.batch,
31
- envelope: repaired.envelope,
32
- partialBatch: plan.batch && plan.rows === undefined,
33
- stopIndex: plan.stopIndex,
34
- presentation: finishRecordingPresentation(options, presentation, evidence, recovery),
35
- recovery,
36
- };
37
- }
38
- function mergeRecoveryNextActions(base, result) {
39
- const laterRecording = base.batchSteps
40
- ?.slice(result.stopIndex + 1)
41
- .some((step) => step.artifacts?.some(isPendingRecordingArtifact) === true) === true;
42
- const unrelatedFailure = base.batchFailure !== undefined && !isRecordingStop(base.batchFailure.failedStep.command ?? []);
43
- const nextActions = (base.nextActions ?? []).filter((action) => action.id === "stop-pending-recording" ? laterRecording : unrelatedFailure);
44
- appendUniqueAgentBrowserNextActions(nextActions, result.presentation.nextActions);
45
- return nextActions;
46
- }
47
- export function mergeRecordingRecoveryPresentation(base, result) {
48
- if (!result.batch) {
49
- return { ...result.presentation, content: [...result.presentation.content] };
50
- }
51
- const artifacts = result.partialBatch
52
- ? [...(base.artifacts ?? []), ...(result.presentation.artifacts ?? [])]
53
- : base.artifacts;
54
- return {
55
- ...base,
56
- artifacts,
57
- artifactVerification: buildArtifactVerificationSummary(artifacts ?? []),
58
- batchSteps: base.batchSteps?.map((step) => step.index === result.stopIndex
59
- ? {
60
- ...step,
61
- artifacts: result.presentation.artifacts,
62
- artifactVerification: result.presentation.artifactVerification,
63
- }
64
- : step),
65
- artifactManifest: result.partialBatch
66
- ? mergeSessionArtifactManifest({
67
- base: base.artifactManifest,
68
- entries: buildManifestEntriesForFileArtifacts(result.presentation.artifacts ?? []),
69
- })
70
- : base.artifactManifest,
71
- content: [
72
- ...base.content,
73
- ...(result.partialBatch
74
- ? result.presentation.content
75
- : result.presentation.content.slice(0, 1)),
76
- ],
77
- nextActions: mergeRecoveryNextActions(base, result),
78
- recordingRecovery: result.recovery,
79
- };
80
- }
@@ -1,14 +0,0 @@
1
- import { getScreenshotPathTokenIndex, getScreenshotPositionalIndices } from "./artifact-paths.js";
2
- export function getScreenshotCapture(command) {
3
- if (command[0] !== "screenshot") {
4
- return { kind: "unknown" };
5
- }
6
- if (command.includes("--full") || command.includes("-f")) {
7
- return { kind: "full-page" };
8
- }
9
- const positional = getScreenshotPositionalIndices(command);
10
- const selectorIndex = positional.find((index) => index !== getScreenshotPathTokenIndex(command));
11
- return selectorIndex === undefined
12
- ? { kind: "viewport" }
13
- : { kind: "element", selector: command[selectorIndex] };
14
- }