pi-agent-browser-native 0.9.3 → 0.9.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (394) hide show
  1. package/CHANGELOG.md +106 -5
  2. package/README.md +58 -791
  3. package/dist/extensions/agent-browser/index.js +43101 -2031
  4. package/dist/extensions/agent-browser/lib/argv-descriptor.js +49 -26
  5. package/dist/extensions/agent-browser/lib/argv-grammar.js +82 -93
  6. package/dist/extensions/agent-browser/lib/bash-guard.js +129 -126
  7. package/dist/extensions/agent-browser/lib/batch-lifecycle.js +112 -51
  8. package/dist/extensions/agent-browser/lib/browser-execution-claim-codec.js +61 -0
  9. package/dist/extensions/agent-browser/lib/browser-execution-claim-storage.js +232 -0
  10. package/dist/extensions/agent-browser/lib/browser-execution-claims.js +202 -0
  11. package/dist/extensions/agent-browser/lib/browser-execution-identity.js +77 -0
  12. package/dist/extensions/agent-browser/lib/browser-journal-branch.js +98 -0
  13. package/dist/extensions/agent-browser/lib/browser-journal-contracts.js +1 -0
  14. package/dist/extensions/agent-browser/lib/browser-journal-projection.js +221 -0
  15. package/dist/extensions/agent-browser/lib/browser-journal-reader.js +89 -0
  16. package/dist/extensions/agent-browser/lib/browser-journal-replay.js +246 -0
  17. package/dist/extensions/agent-browser/lib/browser-journal.js +103 -394
  18. package/dist/extensions/agent-browser/lib/browser-legacy-pages.js +220 -0
  19. package/dist/extensions/agent-browser/lib/browser-legacy-projection.js +282 -0
  20. package/dist/extensions/agent-browser/lib/browser-legacy-types.js +1 -0
  21. package/dist/extensions/agent-browser/lib/browser-session-conversion-stream.js +217 -0
  22. package/dist/extensions/agent-browser/lib/browser-session-conversion.js +80 -335
  23. package/dist/extensions/agent-browser/lib/browser-transcript-contracts.js +35 -0
  24. package/dist/extensions/agent-browser/lib/browser-transcript-validation.js +166 -0
  25. package/dist/extensions/agent-browser/lib/browser-transcript.js +137 -82
  26. package/dist/extensions/agent-browser/lib/browser-value-parsing.js +15 -0
  27. package/dist/extensions/agent-browser/lib/command-capabilities.js +340 -0
  28. package/dist/extensions/agent-browser/lib/command-policy.js +107 -88
  29. package/dist/extensions/agent-browser/lib/command-taxonomy.js +49 -322
  30. package/dist/extensions/agent-browser/lib/config-policy.js +138 -343
  31. package/dist/extensions/agent-browser/lib/config-providers.js +71 -0
  32. package/dist/extensions/agent-browser/lib/config-validation.js +231 -0
  33. package/dist/extensions/agent-browser/lib/config.js +20 -8
  34. package/dist/extensions/agent-browser/lib/electron/cdp.js +20 -8
  35. package/dist/extensions/agent-browser/lib/electron/cleanup.js +128 -83
  36. package/dist/extensions/agent-browser/lib/electron/discovery-darwin.js +109 -0
  37. package/dist/extensions/agent-browser/lib/electron/discovery-desktop.js +136 -0
  38. package/dist/extensions/agent-browser/lib/electron/discovery-evidence.js +90 -0
  39. package/dist/extensions/agent-browser/lib/electron/discovery-linux.js +93 -0
  40. package/dist/extensions/agent-browser/lib/electron/discovery-packages.js +162 -0
  41. package/dist/extensions/agent-browser/lib/electron/discovery-types.js +2 -0
  42. package/dist/extensions/agent-browser/lib/electron/discovery.js +140 -549
  43. package/dist/extensions/agent-browser/lib/electron/launch-monitor.js +102 -0
  44. package/dist/extensions/agent-browser/lib/electron/launch-process.js +209 -0
  45. package/dist/extensions/agent-browser/lib/electron/launch-types.js +2 -0
  46. package/dist/extensions/agent-browser/lib/electron/launch.js +261 -355
  47. package/dist/extensions/agent-browser/lib/executable-path.js +21 -12
  48. package/dist/extensions/agent-browser/lib/execution-cwd.js +35 -18
  49. package/dist/extensions/agent-browser/lib/fs-utils.js +1 -9
  50. package/dist/extensions/agent-browser/lib/input-modes/electron.js +162 -121
  51. package/dist/extensions/agent-browser/lib/input-modes/job.js +123 -317
  52. package/dist/extensions/agent-browser/lib/input-modes/lookup-network-evidence.js +116 -0
  53. package/dist/extensions/agent-browser/lib/input-modes/lookup-plan.js +132 -0
  54. package/dist/extensions/agent-browser/lib/input-modes/lookup-redaction.js +57 -0
  55. package/dist/extensions/agent-browser/lib/input-modes/lookup-source-evidence.js +151 -0
  56. package/dist/extensions/agent-browser/lib/input-modes/lookup-workspace.js +142 -0
  57. package/dist/extensions/agent-browser/lib/input-modes/lookups.js +58 -412
  58. package/dist/extensions/agent-browser/lib/input-modes/params.js +86 -40
  59. package/dist/extensions/agent-browser/lib/input-modes/qa-analysis.js +268 -0
  60. package/dist/extensions/agent-browser/lib/input-modes/qa-presentation.js +117 -0
  61. package/dist/extensions/agent-browser/lib/input-modes/script-child.js +396 -0
  62. package/dist/extensions/agent-browser/lib/input-modes/script-protocol.js +86 -0
  63. package/dist/extensions/agent-browser/lib/input-modes/script-types.js +1 -0
  64. package/dist/extensions/agent-browser/lib/input-modes/script-validation.js +60 -0
  65. package/dist/extensions/agent-browser/lib/input-modes/script.js +60 -409
  66. package/dist/extensions/agent-browser/lib/input-modes/semantic-action.js +218 -128
  67. package/dist/extensions/agent-browser/lib/input-modes/shared.js +15 -4
  68. package/dist/extensions/agent-browser/lib/input-modes/types.js +56 -7
  69. package/dist/extensions/agent-browser/lib/json-schema.js +22 -10
  70. package/dist/extensions/agent-browser/lib/launch-scoped-flags.js +17 -5
  71. package/dist/extensions/agent-browser/lib/managed-session-policy-lock.js +92 -425
  72. package/dist/extensions/agent-browser/lib/managed-session-posix-storage.js +58 -0
  73. package/dist/extensions/agent-browser/lib/managed-session-project-identity.js +244 -0
  74. package/dist/extensions/agent-browser/lib/managed-session-restore-context.js +84 -0
  75. package/dist/extensions/agent-browser/lib/managed-session-restore-policy.js +119 -0
  76. package/dist/extensions/agent-browser/lib/managed-session-restore-state.js +83 -0
  77. package/dist/extensions/agent-browser/lib/managed-session-restore.js +168 -300
  78. package/dist/extensions/agent-browser/lib/managed-session-snapshot-records.js +277 -0
  79. package/dist/extensions/agent-browser/lib/managed-session-snapshots.js +128 -305
  80. package/dist/extensions/agent-browser/lib/managed-session-storage.js +56 -253
  81. package/dist/extensions/agent-browser/lib/native-confirmation.js +140 -0
  82. package/dist/extensions/agent-browser/lib/native-output.js +43 -9
  83. package/dist/extensions/agent-browser/lib/orchestration/batch-stdin.js +106 -59
  84. package/dist/extensions/agent-browser/lib/orchestration/browser-run/artifact-merge.js +14 -6
  85. package/dist/extensions/agent-browser/lib/orchestration/browser-run/artifact-paths.js +109 -57
  86. package/dist/extensions/agent-browser/lib/orchestration/browser-run/browser-observation-result.js +82 -0
  87. package/dist/extensions/agent-browser/lib/orchestration/browser-run/click-dispatch.js +164 -60
  88. package/dist/extensions/agent-browser/lib/orchestration/browser-run/diagnostic-values.js +31 -0
  89. package/dist/extensions/agent-browser/lib/orchestration/browser-run/diagnostics.js +152 -781
  90. package/dist/extensions/agent-browser/lib/orchestration/browser-run/electron-observation.js +203 -0
  91. package/dist/extensions/agent-browser/lib/orchestration/browser-run/electron-text-diagnostics.js +109 -0
  92. package/dist/extensions/agent-browser/lib/orchestration/browser-run/fill-diagnostics.js +119 -0
  93. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-action-recovery.js +147 -0
  94. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-actions.js +144 -0
  95. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-content.js +123 -0
  96. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-contracts.js +1 -0
  97. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-details.js +156 -0
  98. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-electron.js +187 -0
  99. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-evidence.js +39 -0
  100. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-missing-binary.js +89 -0
  101. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-recovery.js +97 -0
  102. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-redaction.js +106 -0
  103. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-timeout.js +110 -0
  104. package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result.js +41 -538
  105. package/dist/extensions/agent-browser/lib/orchestration/browser-run/index.js +199 -154
  106. package/dist/extensions/agent-browser/lib/orchestration/browser-run/interaction-diagnostics.js +290 -0
  107. package/dist/extensions/agent-browser/lib/orchestration/browser-run/managed-session-close.js +167 -0
  108. package/dist/extensions/agent-browser/lib/orchestration/browser-run/managed-session-daemon-inspection.js +108 -0
  109. package/dist/extensions/agent-browser/lib/orchestration/browser-run/managed-session-daemon-policy.js +127 -205
  110. package/dist/extensions/agent-browser/lib/orchestration/browser-run/native-helper-observation.js +65 -0
  111. package/dist/extensions/agent-browser/lib/orchestration/browser-run/observation-types.js +1 -0
  112. package/dist/extensions/agent-browser/lib/orchestration/browser-run/overlay-diagnostics.js +120 -0
  113. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/network-page-filter.js +113 -30
  114. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/scroll-shims.js +109 -28
  115. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/snapshot-filter-data.js +150 -0
  116. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/snapshot-filter.js +147 -253
  117. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/snapshot-rendered-text.js +147 -0
  118. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/wait-timeouts.js +59 -24
  119. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-artifacts.js +159 -0
  120. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-command.js +131 -0
  121. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-contracts.js +1 -0
  122. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-daemon.js +93 -0
  123. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-failure.js +42 -0
  124. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-guards.js +242 -0
  125. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-input.js +75 -0
  126. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-observations.js +92 -0
  127. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-page-selection.js +254 -0
  128. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-page-state.js +121 -0
  129. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-refs.js +130 -0
  130. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-resources.js +114 -0
  131. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-semantic.js +121 -0
  132. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-session-plan.js +222 -0
  133. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-timeouts.js +68 -0
  134. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare.js +176 -1123
  135. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-analysis.js +191 -0
  136. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-confirmation.js +152 -0
  137. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-diagnostics.js +182 -0
  138. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-electron.js +150 -0
  139. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-lifecycle-contracts.js +1 -0
  140. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-lifecycle-phase-contracts.js +1 -0
  141. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-lifecycle-phase.js +115 -0
  142. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-lifecycle.js +256 -0
  143. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-managed-contracts.js +1 -0
  144. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-managed.js +256 -0
  145. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-native-phase-contracts.js +1 -0
  146. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-native-phase.js +93 -0
  147. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-native.js +113 -0
  148. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-navigation-contracts.js +1 -0
  149. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-navigation.js +316 -0
  150. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-ownership.js +28 -0
  151. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-page-phase-contracts.js +1 -0
  152. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-page-phase.js +142 -0
  153. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-presentation-contracts.js +1 -0
  154. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-presentation.js +333 -0
  155. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-publication-phase-contracts.js +1 -0
  156. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-publication-phase.js +71 -0
  157. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-publication.js +201 -0
  158. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-receipts.js +183 -0
  159. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-refs.js +200 -0
  160. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-tabs.js +142 -0
  161. package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output.js +18 -968
  162. package/dist/extensions/agent-browser/lib/orchestration/browser-run/prompt-guards.js +23 -13
  163. package/dist/extensions/agent-browser/lib/orchestration/browser-run/recording-receipt-reconciliation.js +198 -0
  164. package/dist/extensions/agent-browser/lib/orchestration/browser-run/recording-recovery-contracts.js +1 -0
  165. package/dist/extensions/agent-browser/lib/orchestration/browser-run/recording-recovery-presentation.js +154 -0
  166. package/dist/extensions/agent-browser/lib/orchestration/browser-run/recording-recovery.js +68 -151
  167. package/dist/extensions/agent-browser/lib/orchestration/browser-run/screenshot-capture.js +14 -0
  168. package/dist/extensions/agent-browser/lib/orchestration/browser-run/screenshot-observation.js +169 -46
  169. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-commands.js +130 -0
  170. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-electron.js +212 -0
  171. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-observations.js +61 -0
  172. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-outcomes.js +187 -0
  173. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-refs.js +169 -0
  174. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-tabs.js +228 -0
  175. package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state.js +77 -765
  176. package/dist/extensions/agent-browser/lib/orchestration/browser-run/text-visibility-diagnostics.js +182 -0
  177. package/dist/extensions/agent-browser/lib/orchestration/browser-run/timeout-diagnostics.js +256 -0
  178. package/dist/extensions/agent-browser/lib/orchestration/browser-run/timeout-progress.js +108 -0
  179. package/dist/extensions/agent-browser/lib/orchestration/code-artifact-observation.js +39 -0
  180. package/dist/extensions/agent-browser/lib/orchestration/code-image-observation.js +119 -0
  181. package/dist/extensions/agent-browser/lib/orchestration/electron-host/branch.js +93 -0
  182. package/dist/extensions/agent-browser/lib/orchestration/electron-host/cleanup-result.js +58 -0
  183. package/dist/extensions/agent-browser/lib/orchestration/electron-host/cleanup.js +78 -0
  184. package/dist/extensions/agent-browser/lib/orchestration/electron-host/contracts.js +1 -0
  185. package/dist/extensions/agent-browser/lib/orchestration/electron-host/discovery.js +106 -0
  186. package/dist/extensions/agent-browser/lib/orchestration/electron-host/index.js +48 -821
  187. package/dist/extensions/agent-browser/lib/orchestration/electron-host/policy.js +86 -0
  188. package/dist/extensions/agent-browser/lib/orchestration/electron-host/probe-collection.js +68 -0
  189. package/dist/extensions/agent-browser/lib/orchestration/electron-host/probe-data.js +169 -0
  190. package/dist/extensions/agent-browser/lib/orchestration/electron-host/probe-presentation.js +182 -0
  191. package/dist/extensions/agent-browser/lib/orchestration/electron-host/probe.js +161 -0
  192. package/dist/extensions/agent-browser/lib/orchestration/electron-host/status.js +167 -0
  193. package/dist/extensions/agent-browser/lib/orchestration/execution-queue.js +22 -10
  194. package/dist/extensions/agent-browser/lib/orchestration/extension-artifact-preflight.js +211 -0
  195. package/dist/extensions/agent-browser/lib/orchestration/extension-artifacts.js +23 -0
  196. package/dist/extensions/agent-browser/lib/orchestration/extension-attachment-replay.js +99 -0
  197. package/dist/extensions/agent-browser/lib/orchestration/extension-branch-restore.js +275 -0
  198. package/dist/extensions/agent-browser/lib/orchestration/extension-code.js +280 -0
  199. package/dist/extensions/agent-browser/lib/orchestration/extension-command-admission.js +303 -0
  200. package/dist/extensions/agent-browser/lib/orchestration/extension-command-output.js +36 -0
  201. package/dist/extensions/agent-browser/lib/orchestration/extension-command-result.js +335 -0
  202. package/dist/extensions/agent-browser/lib/orchestration/extension-command-run.js +227 -0
  203. package/dist/extensions/agent-browser/lib/orchestration/extension-command-state.js +1 -0
  204. package/dist/extensions/agent-browser/lib/orchestration/extension-electron-ownership.js +204 -0
  205. package/dist/extensions/agent-browser/lib/orchestration/extension-execution-locks.js +139 -0
  206. package/dist/extensions/agent-browser/lib/orchestration/extension-execution-queue.js +24 -0
  207. package/dist/extensions/agent-browser/lib/orchestration/extension-host-coordination.js +98 -0
  208. package/dist/extensions/agent-browser/lib/orchestration/extension-host-run.js +295 -0
  209. package/dist/extensions/agent-browser/lib/orchestration/extension-intent-replay.js +41 -0
  210. package/dist/extensions/agent-browser/lib/orchestration/extension-invocation.js +7 -0
  211. package/dist/extensions/agent-browser/lib/orchestration/extension-lifecycle.js +102 -0
  212. package/dist/extensions/agent-browser/lib/orchestration/extension-managed-ownership.js +133 -0
  213. package/dist/extensions/agent-browser/lib/orchestration/extension-observation.js +120 -0
  214. package/dist/extensions/agent-browser/lib/orchestration/extension-prompt.js +180 -0
  215. package/dist/extensions/agent-browser/lib/orchestration/extension-recording.js +290 -0
  216. package/dist/extensions/agent-browser/lib/orchestration/extension-resource-contracts.js +1 -0
  217. package/dist/extensions/agent-browser/lib/orchestration/extension-resource-replay.js +269 -0
  218. package/dist/extensions/agent-browser/lib/orchestration/extension-result-state.js +113 -0
  219. package/dist/extensions/agent-browser/lib/orchestration/extension-runtime.js +146 -0
  220. package/dist/extensions/agent-browser/lib/orchestration/extension-script-leases.js +58 -0
  221. package/dist/extensions/agent-browser/lib/orchestration/extension-tool-boundary.js +62 -0
  222. package/dist/extensions/agent-browser/lib/orchestration/extension-version-check.js +54 -0
  223. package/dist/extensions/agent-browser/lib/orchestration/input-plan-types.js +1 -0
  224. package/dist/extensions/agent-browser/lib/orchestration/input-plan.js +261 -185
  225. package/dist/extensions/agent-browser/lib/orchestration/input-redaction.js +62 -0
  226. package/dist/extensions/agent-browser/lib/orchestration/native-config.js +144 -0
  227. package/dist/extensions/agent-browser/lib/orchestration/native-root-launch.js +77 -0
  228. package/dist/extensions/agent-browser/lib/orchestration/native-session-defaults.js +210 -157
  229. package/dist/extensions/agent-browser/lib/orchestration/operation-paths.js +124 -58
  230. package/dist/extensions/agent-browser/lib/orchestration/output-file.js +197 -99
  231. package/dist/extensions/agent-browser/lib/orchestration/script-mode.js +199 -96
  232. package/dist/extensions/agent-browser/lib/owned-managed-session-context.js +55 -0
  233. package/dist/extensions/agent-browser/lib/page-target-batch.js +118 -0
  234. package/dist/extensions/agent-browser/lib/page-target-guards.js +50 -0
  235. package/dist/extensions/agent-browser/lib/page-target-navigation.js +104 -0
  236. package/dist/extensions/agent-browser/lib/page-target-validation.js +55 -246
  237. package/dist/extensions/agent-browser/lib/parsing.js +13 -4
  238. package/dist/extensions/agent-browser/lib/pi-tool-rendering.js +133 -68
  239. package/dist/extensions/agent-browser/lib/playbook.js +16 -12
  240. package/dist/extensions/agent-browser/lib/process-child.js +284 -0
  241. package/dist/extensions/agent-browser/lib/process-environment.js +13 -6
  242. package/dist/extensions/agent-browser/lib/process-errors.js +23 -0
  243. package/dist/extensions/agent-browser/lib/process-identity.js +47 -15
  244. package/dist/extensions/agent-browser/lib/process-socket-storage.js +256 -0
  245. package/dist/extensions/agent-browser/lib/process-stdout.js +74 -0
  246. package/dist/extensions/agent-browser/lib/process.js +145 -536
  247. package/dist/extensions/agent-browser/lib/prompt-artifacts.js +287 -0
  248. package/dist/extensions/agent-browser/lib/prompt-policy.js +15 -194
  249. package/dist/extensions/agent-browser/lib/read-command.js +41 -0
  250. package/dist/extensions/agent-browser/lib/read-confirmation.js +131 -68
  251. package/dist/extensions/agent-browser/lib/recording-reservations.js +118 -45
  252. package/dist/extensions/agent-browser/lib/redaction-fields.js +75 -0
  253. package/dist/extensions/agent-browser/lib/redaction-json.js +149 -0
  254. package/dist/extensions/agent-browser/lib/redaction-url.js +88 -0
  255. package/dist/extensions/agent-browser/lib/results/action-contracts.js +1 -0
  256. package/dist/extensions/agent-browser/lib/results/action-recommendations.js +28 -271
  257. package/dist/extensions/agent-browser/lib/results/artifact-contracts.js +1 -0
  258. package/dist/extensions/agent-browser/lib/results/artifact-manifest-validation.js +133 -0
  259. package/dist/extensions/agent-browser/lib/results/artifact-manifest.js +96 -94
  260. package/dist/extensions/agent-browser/lib/results/artifact-recommendations.js +73 -0
  261. package/dist/extensions/agent-browser/lib/results/categories.js +111 -54
  262. package/dist/extensions/agent-browser/lib/results/confirmation.js +29 -13
  263. package/dist/extensions/agent-browser/lib/results/editable-ref-evidence.js +62 -27
  264. package/dist/extensions/agent-browser/lib/results/electron-recommendations.js +83 -0
  265. package/dist/extensions/agent-browser/lib/results/envelope-decoding.js +48 -0
  266. package/dist/extensions/agent-browser/lib/results/envelope.js +90 -67
  267. package/dist/extensions/agent-browser/lib/results/evidence-contracts.js +1 -0
  268. package/dist/extensions/agent-browser/lib/results/failure-recommendations.js +180 -0
  269. package/dist/extensions/agent-browser/lib/results/network-routes.js +86 -45
  270. package/dist/extensions/agent-browser/lib/results/network.js +35 -12
  271. package/dist/extensions/agent-browser/lib/results/next-actions.js +49 -19
  272. package/dist/extensions/agent-browser/lib/results/presentation/artifact-files.js +320 -0
  273. package/dist/extensions/agent-browser/lib/results/presentation/artifact-format.js +138 -0
  274. package/dist/extensions/agent-browser/lib/results/presentation/artifact-images.js +113 -0
  275. package/dist/extensions/agent-browser/lib/results/presentation/artifact-verification.js +145 -0
  276. package/dist/extensions/agent-browser/lib/results/presentation/artifacts.js +99 -555
  277. package/dist/extensions/agent-browser/lib/results/presentation/batch-contracts.js +1 -0
  278. package/dist/extensions/agent-browser/lib/results/presentation/batch-recording.js +118 -0
  279. package/dist/extensions/agent-browser/lib/results/presentation/batch-redaction.js +68 -0
  280. package/dist/extensions/agent-browser/lib/results/presentation/batch-rendering.js +135 -0
  281. package/dist/extensions/agent-browser/lib/results/presentation/batch-step.js +227 -0
  282. package/dist/extensions/agent-browser/lib/results/presentation/batch-summary.js +91 -0
  283. package/dist/extensions/agent-browser/lib/results/presentation/batch.js +91 -460
  284. package/dist/extensions/agent-browser/lib/results/presentation/browser-profile-recovery.js +9 -5
  285. package/dist/extensions/agent-browser/lib/results/presentation/command-presenters.js +216 -0
  286. package/dist/extensions/agent-browser/lib/results/presentation/common.js +26 -9
  287. package/dist/extensions/agent-browser/lib/results/presentation/content.js +86 -29
  288. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-a11y.js +67 -0
  289. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-health.js +79 -0
  290. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-identity.js +199 -0
  291. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-logs.js +75 -0
  292. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-network-actions.js +216 -0
  293. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-network.js +124 -0
  294. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-redaction.js +64 -0
  295. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-storage.js +209 -0
  296. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-stream.js +69 -0
  297. package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-summary.js +222 -0
  298. package/dist/extensions/agent-browser/lib/results/presentation/diagnostics.js +103 -1052
  299. package/dist/extensions/agent-browser/lib/results/presentation/early-result.js +70 -0
  300. package/dist/extensions/agent-browser/lib/results/presentation/errors.js +130 -60
  301. package/dist/extensions/agent-browser/lib/results/presentation/input-contracts.js +1 -0
  302. package/dist/extensions/agent-browser/lib/results/presentation/large-output.js +60 -145
  303. package/dist/extensions/agent-browser/lib/results/presentation/navigation.js +147 -88
  304. package/dist/extensions/agent-browser/lib/results/presentation/notices.js +75 -0
  305. package/dist/extensions/agent-browser/lib/results/presentation/observation-contracts.js +1 -0
  306. package/dist/extensions/agent-browser/lib/results/presentation/observation-rendering.js +127 -0
  307. package/dist/extensions/agent-browser/lib/results/presentation/outcomes.js +120 -0
  308. package/dist/extensions/agent-browser/lib/results/presentation/output-completion.js +77 -0
  309. package/dist/extensions/agent-browser/lib/results/presentation/output-spill.js +51 -0
  310. package/dist/extensions/agent-browser/lib/results/presentation/registry.js +116 -240
  311. package/dist/extensions/agent-browser/lib/results/presentation/semantic-action.js +35 -21
  312. package/dist/extensions/agent-browser/lib/results/presentation/skills.js +109 -73
  313. package/dist/extensions/agent-browser/lib/results/presentation/source.js +109 -0
  314. package/dist/extensions/agent-browser/lib/results/presentation.js +17 -261
  315. package/dist/extensions/agent-browser/lib/results/recommendation-contracts.js +1 -0
  316. package/dist/extensions/agent-browser/lib/results/recording.js +52 -14
  317. package/dist/extensions/agent-browser/lib/results/recovery-actions.js +14 -5
  318. package/dist/extensions/agent-browser/lib/results/recovery-next-actions.js +30 -22
  319. package/dist/extensions/agent-browser/lib/results/selector-recovery-target.js +83 -0
  320. package/dist/extensions/agent-browser/lib/results/selector-recovery.js +119 -119
  321. package/dist/extensions/agent-browser/lib/results/snapshot-compact.js +266 -0
  322. package/dist/extensions/agent-browser/lib/results/snapshot-content.js +32 -0
  323. package/dist/extensions/agent-browser/lib/results/snapshot-high-value-controls.js +104 -71
  324. package/dist/extensions/agent-browser/lib/results/snapshot-refs.js +31 -11
  325. package/dist/extensions/agent-browser/lib/results/snapshot-segments.js +125 -66
  326. package/dist/extensions/agent-browser/lib/results/snapshot-spill.js +26 -7
  327. package/dist/extensions/agent-browser/lib/results/snapshot.js +28 -248
  328. package/dist/extensions/agent-browser/lib/results/text.js +16 -5
  329. package/dist/extensions/agent-browser/lib/runtime-args-validation.js +133 -0
  330. package/dist/extensions/agent-browser/lib/runtime-compatibility.js +81 -0
  331. package/dist/extensions/agent-browser/lib/runtime-contracts.js +1 -0
  332. package/dist/extensions/agent-browser/lib/runtime-redaction.js +118 -0
  333. package/dist/extensions/agent-browser/lib/runtime-replay-events.js +144 -0
  334. package/dist/extensions/agent-browser/lib/runtime-session-identity.js +76 -0
  335. package/dist/extensions/agent-browser/lib/runtime-session-plan.js +114 -0
  336. package/dist/extensions/agent-browser/lib/runtime-session-replay.js +123 -0
  337. package/dist/extensions/agent-browser/lib/runtime-tab-correction.js +65 -0
  338. package/dist/extensions/agent-browser/lib/runtime-timeouts.js +28 -0
  339. package/dist/extensions/agent-browser/lib/runtime.js +137 -1041
  340. package/dist/extensions/agent-browser/lib/session-identity.js +51 -0
  341. package/dist/extensions/agent-browser/lib/session-page-observation.js +357 -0
  342. package/dist/extensions/agent-browser/lib/session-page-state.js +178 -333
  343. package/dist/extensions/agent-browser/lib/session-page-types.js +1 -0
  344. package/dist/extensions/agent-browser/lib/temp-artifact-budget.js +81 -0
  345. package/dist/extensions/agent-browser/lib/temp-mutation-queue.js +7 -0
  346. package/dist/extensions/agent-browser/lib/temp-root-ownership.js +234 -0
  347. package/dist/extensions/agent-browser/lib/temp-root.js +211 -0
  348. package/dist/extensions/agent-browser/lib/temp.js +33 -446
  349. package/dist/extensions/agent-browser/lib/tool-surface.js +94 -24
  350. package/dist/extensions/agent-browser/lib/upstream-version.js +3 -2
  351. package/dist/extensions/agent-browser/lib/web-search-providers.js +193 -0
  352. package/dist/extensions/agent-browser/lib/web-search-request.js +102 -0
  353. package/dist/extensions/agent-browser/lib/web-search-results.js +281 -0
  354. package/dist/extensions/agent-browser/lib/web-search-schema.js +82 -0
  355. package/dist/extensions/agent-browser/lib/web-search.js +124 -614
  356. package/dist/extensions/agent-browser/lib/webmcp-observation.js +13 -6
  357. package/dist/extensions/agent-browser/lib/windows-stock-launcher.js +63 -37
  358. package/dist/extensions/agent-browser/script-worker.js +80 -43
  359. package/dist/scripts/agent-browser-target.mjs +4 -2
  360. package/docs/ARCHITECTURE.md +19 -6
  361. package/docs/CODE_QUALITY.md +267 -0
  362. package/docs/COMMAND_REFERENCE.md +272 -241
  363. package/docs/ELECTRON.md +77 -46
  364. package/docs/REFERENCE.md +869 -0
  365. package/docs/RELEASE.md +25 -22
  366. package/docs/REQUIREMENTS.md +2 -1
  367. package/docs/SUPPORT_MATRIX.md +81 -79
  368. package/docs/TOOL_CONTRACT.md +158 -125
  369. package/docs/platform-smoke.md +8 -8
  370. package/package.json +144 -120
  371. package/scripts/agent-browser-capability-baseline.mjs +361 -957
  372. package/scripts/agent-browser-target.mjs +6 -2
  373. package/scripts/build.mjs +37 -8
  374. package/scripts/capability-core-commands.mjs +193 -0
  375. package/scripts/capability-options.mjs +283 -0
  376. package/scripts/capability-samples.mjs +133 -0
  377. package/scripts/capability-section.mjs +11 -0
  378. package/scripts/config.mjs +235 -132
  379. package/scripts/convert-browser-session.mjs +30 -9
  380. package/scripts/doctor-sources.mjs +195 -0
  381. package/scripts/doctor.mjs +94 -249
  382. package/scripts/platform-smoke/artifacts.mjs +38 -11
  383. package/scripts/platform-smoke/commands.mjs +104 -0
  384. package/scripts/platform-smoke/crabbox-runner.mjs +167 -80
  385. package/scripts/platform-smoke/doctor-support.mjs +157 -0
  386. package/scripts/platform-smoke/doctor-windows.mjs +230 -0
  387. package/scripts/platform-smoke/doctor.mjs +212 -320
  388. package/scripts/platform-smoke/lease-evidence.mjs +132 -0
  389. package/scripts/platform-smoke/linux-image/Dockerfile +8 -2
  390. package/scripts/platform-smoke/suite-checks.mjs +98 -0
  391. package/scripts/platform-smoke/suite-evidence.mjs +281 -0
  392. package/scripts/platform-smoke/targets.mjs +154 -472
  393. package/scripts/platform-smoke.mjs +55 -40
  394. package/scripts/prepare.mjs +16 -7
@@ -0,0 +1,142 @@
1
+ import { observeHelperConfirmation } from "./process-output-confirmation.js";
2
+ import { verifyClickDispatch, observeNavigationTarget, correctRestoredOpenTab, observeWebMcpTarget, resolveObservedPageTarget, } from "./process-output-navigation.js";
3
+ import { recoverUnexpectedBlankTarget, pinPostCommandTarget, inspectElectronHealth, } from "./process-output-tabs.js";
4
+ import { collectPageDiagnostics } from "./process-output-diagnostics.js";
5
+ import { collectTimeoutPartialProgress } from "./diagnostics.js";
6
+ import { normalizeSessionTabTarget } from "../../session-page-state.js";
7
+ import { reconcileOutputRefs } from "./process-output-refs.js";
8
+ async function recoverTimeoutPageTarget(view) {
9
+ const timeoutPartialProgress = view.input.processResult.timedOut &&
10
+ !view.recordingStopRecovery &&
11
+ !view.input.prepared.readConfirmation
12
+ ? await collectTimeoutPartialProgress({
13
+ commandTokens: view.input.prepared.commandTokens,
14
+ compiledJob: view.input.prepared.compiledJob,
15
+ cwd: view.input.cwd,
16
+ operationCwd: view.input.operationCwd,
17
+ namespace: view.input.prepared.executionPlan.namespace,
18
+ sessionName: view.input.prepared.executionPlan.sessionName,
19
+ stdin: view.input.prepared.runtimeToolStdin,
20
+ })
21
+ : undefined;
22
+ let currentSessionTabTarget = view.currentSessionTabTarget;
23
+ if (!currentSessionTabTarget && timeoutPartialProgress?.liveUrlRecovered === true) {
24
+ currentSessionTabTarget = normalizeSessionTabTarget(timeoutPartialProgress.currentPage);
25
+ }
26
+ return { timeoutPartialProgress, currentSessionTabTarget };
27
+ }
28
+ function createPageOutputPhase(input, native) {
29
+ return {
30
+ input,
31
+ aboutBlankSessionMismatch: undefined,
32
+ activeNetworkRoutes: undefined,
33
+ diagnostics: {
34
+ selectorTextVisibilityDiagnostics: [],
35
+ electronBroadGetTextScopeDiagnostics: [],
36
+ },
37
+ batchCommandSteps: native.batchCommandSteps,
38
+ batchRefSnapshotState: undefined,
39
+ browserIndependentRead: native.browserIndependentRead,
40
+ clickDispatchDiagnostic: undefined,
41
+ confirmationFromHelper: false,
42
+ confirmedCommand: native.confirmedCommand,
43
+ confirmedData: native.confirmedData,
44
+ confirmedEffects: native.confirmedEffects,
45
+ currentRefSnapshot: undefined,
46
+ currentRefSnapshotInvalidation: undefined,
47
+ currentSessionTabTarget: undefined,
48
+ destinationTransition: native.destinationTransition,
49
+ directClose: native.directClose,
50
+ dispatchedCommands: native.dispatchedCommands,
51
+ electronPostCommandHealth: undefined,
52
+ electronRecordForCommand: undefined,
53
+ electronSessionMismatch: undefined,
54
+ electronStatusAfterCommand: undefined,
55
+ failedTransitionReverification: false,
56
+ nativeCommandMayHaveExecuted: native.nativeCommandMayHaveExecuted,
57
+ navigationSummary: undefined,
58
+ nestedBatchClose: native.nestedBatchClose,
59
+ nestedBatchClosed: native.nestedBatchClosed,
60
+ networkRoutesBySession: native.networkRoutesBySession,
61
+ observedSessionTabTarget: undefined,
62
+ openResultTabCorrection: undefined,
63
+ presentationEnvelope: native.presentationEnvelope,
64
+ processSucceeded: native.processSucceeded,
65
+ readConfirmation: native.readConfirmation,
66
+ readConfirmationEvent: native.readConfirmationEvent,
67
+ recordingStopRecovery: native.recordingStopRecovery,
68
+ resultingPageState: { pageTargetMayHaveChanged: false, pageUrlUnknown: false },
69
+ sessionStateKey: native.sessionStateKey,
70
+ sessionTabCorrection: undefined,
71
+ succeeded: native.succeeded,
72
+ tabTransition: false,
73
+ textOutput: native.textOutput,
74
+ timeoutPartialProgress: undefined,
75
+ trustsReportedPageTarget: false,
76
+ unobservedMutation: native.unobservedMutation,
77
+ unsettledWebMcpMutation: false,
78
+ };
79
+ }
80
+ export async function observePageEffects(input, native) {
81
+ const draft = createPageOutputPhase(input, native);
82
+ await verifyClickDispatch(draft);
83
+ await observeNavigationTarget(draft);
84
+ await correctRestoredOpenTab(draft);
85
+ observeWebMcpTarget(draft);
86
+ observeHelperConfirmation(draft);
87
+ await resolveObservedPageTarget(draft);
88
+ await recoverUnexpectedBlankTarget(draft);
89
+ await pinPostCommandTarget(draft);
90
+ await inspectElectronHealth(draft);
91
+ const timeoutRecovery = await recoverTimeoutPageTarget(draft);
92
+ draft.timeoutPartialProgress = timeoutRecovery.timeoutPartialProgress;
93
+ draft.currentSessionTabTarget = timeoutRecovery.currentSessionTabTarget;
94
+ const collected = await collectPageDiagnostics({
95
+ input,
96
+ aboutBlankSessionMismatch: draft.aboutBlankSessionMismatch,
97
+ clickDispatchDiagnostic: draft.clickDispatchDiagnostic,
98
+ currentSessionTabTarget: draft.currentSessionTabTarget,
99
+ electronRecordForCommand: draft.electronRecordForCommand,
100
+ navigationSummary: draft.navigationSummary,
101
+ networkRoutesBySession: draft.networkRoutesBySession,
102
+ presentationEnvelope: draft.presentationEnvelope,
103
+ sessionStateKey: draft.sessionStateKey,
104
+ sessionTabCorrection: draft.sessionTabCorrection,
105
+ succeeded: draft.succeeded,
106
+ });
107
+ draft.diagnostics = collected.diagnostics;
108
+ draft.activeNetworkRoutes = collected.activeNetworkRoutes;
109
+ draft.networkRoutesBySession = collected.networkRoutesBySession;
110
+ await reconcileOutputRefs(draft);
111
+ return {
112
+ aboutBlankSessionMismatch: draft.aboutBlankSessionMismatch,
113
+ activeNetworkRoutes: draft.activeNetworkRoutes,
114
+ diagnostics: draft.diagnostics,
115
+ batchRefSnapshotState: draft.batchRefSnapshotState,
116
+ clickDispatchDiagnostic: draft.clickDispatchDiagnostic,
117
+ confirmationFromHelper: draft.confirmationFromHelper,
118
+ confirmedEffects: draft.confirmedEffects,
119
+ currentRefSnapshot: draft.currentRefSnapshot,
120
+ currentRefSnapshotInvalidation: draft.currentRefSnapshotInvalidation,
121
+ currentSessionTabTarget: draft.currentSessionTabTarget,
122
+ directClose: draft.directClose,
123
+ electronPostCommandHealth: draft.electronPostCommandHealth,
124
+ electronSessionMismatch: draft.electronSessionMismatch,
125
+ navigationSummary: draft.navigationSummary,
126
+ nestedBatchClosed: draft.nestedBatchClosed,
127
+ networkRoutesBySession: draft.networkRoutesBySession,
128
+ observedSessionTabTarget: draft.observedSessionTabTarget,
129
+ openResultTabCorrection: draft.openResultTabCorrection,
130
+ presentationEnvelope: draft.presentationEnvelope,
131
+ processSucceeded: draft.processSucceeded,
132
+ readConfirmationEvent: draft.readConfirmationEvent,
133
+ recordingStopRecovery: draft.recordingStopRecovery,
134
+ sessionStateKey: draft.sessionStateKey,
135
+ sessionTabCorrection: draft.sessionTabCorrection,
136
+ succeeded: draft.succeeded,
137
+ textOutput: draft.textOutput,
138
+ timeoutPartialProgress: draft.timeoutPartialProgress,
139
+ unobservedMutation: draft.unobservedMutation,
140
+ unsettledWebMcpMutation: draft.unsettledWebMcpMutation,
141
+ };
142
+ }
@@ -0,0 +1,333 @@
1
+ import { isStringArray } from "../../results/presentation/content.js";
2
+ import { buildReadConfirmationNextActions, } from "../../read-confirmation.js";
3
+ import { isCloseCommand } from "../../command-taxonomy.js";
4
+ import { applyNetworkRouteRecords } from "../../results/network-routes.js";
5
+ import { buildToolPresentation } from "../../results/presentation.js";
6
+ import { compactLargePresentationOutput } from "../../results/presentation/large-output.js";
7
+ import { extractEnvelopeErrorText, getAgentBrowserErrorText } from "../../results/envelope.js";
8
+ import { detectConfirmationRequired } from "../../results/confirmation.js";
9
+ import { omitUpstreamLifecycle } from "../../results/presentation/common.js";
10
+ import { getClipboardWritePayloadCandidates, redactClipboardPermissionEcho, redactClipboardPermissionErrorValue, } from "../../results/presentation/errors.js";
11
+ import { isRecord } from "../../parsing.js";
12
+ import { extractUpstreamCommandTokens } from "../../argv-descriptor.js";
13
+ import { getStaleRefArgs } from "./session-state.js";
14
+ import { mergeRecordingRecoveryPresentation } from "./recording-recovery.js";
15
+ import { buildWrapperRecoveryHint } from "./final-result.js";
16
+ import { setNetworkRouteState } from "./process-output-diagnostics.js";
17
+ export function resolveOutputError(draft) {
18
+ resolveNativeErrorText(draft);
19
+ applyErrorEnvelopeFallback(draft);
20
+ redactClipboardError(draft);
21
+ applyTextErrorEnvelope(draft);
22
+ observeResultLaunchPolicy(draft);
23
+ }
24
+ export async function renderNativePresentation(draft) {
25
+ draft.presentation = await buildNativePresentation(draft);
26
+ if (draft.recordingStopRecovery) {
27
+ draft.presentation = mergeRecordingRecoveryPresentation(draft.presentation, draft.recordingStopRecovery);
28
+ }
29
+ classifyMalformedNativeFailure(draft);
30
+ renderPresentationConfirmation(draft);
31
+ await renderUpgradeFailure(draft);
32
+ if (draft.electronHandoff?.error !== undefined &&
33
+ draft.electronHandoff.error.length > 0 &&
34
+ draft.electronHandoff.failureCategory !== undefined &&
35
+ draft.electronHandoff.failureCategory.length > 0) {
36
+ draft.presentation.failureCategory = draft.electronHandoff.failureCategory;
37
+ }
38
+ }
39
+ export function reclassifyPresentation(draft) {
40
+ applyBatchNetworkRouteState(draft);
41
+ if (draft.presentation.resultCategory === "failure" && draft.succeeded) {
42
+ draft.succeeded = false;
43
+ draft.presentationEnvelope = {
44
+ ...draft.presentationEnvelope,
45
+ error: draft.presentation.summary,
46
+ success: false,
47
+ };
48
+ }
49
+ reclassifyScrollNoop(draft);
50
+ renderParseFailureArtifacts(draft);
51
+ }
52
+ function resolveNativeErrorText(draft) {
53
+ draft.errorText =
54
+ draft.recordingStopRecovery?.recovery.healed === true
55
+ ? undefined
56
+ : getAgentBrowserErrorText({
57
+ aborted: draft.input.processResult.aborted,
58
+ command: draft.input.prepared.executionPlan.commandInfo.command,
59
+ effectiveArgs: draft.input.prepared.redactedProcessArgs,
60
+ envelope: draft.presentationEnvelope,
61
+ exitCode: draft.input.processResult.exitCode,
62
+ parseError: draft.parseError,
63
+ plainTextInspection: draft.plainTextInspection,
64
+ staleRefArgs: getStaleRefArgs(draft.input.prepared.commandTokens, draft.input.prepared.runtimeToolStdin),
65
+ spawnError: draft.input.processResult.spawnError,
66
+ stderr: draft.input.processResult.stderr,
67
+ timedOut: draft.input.processResult.timedOut,
68
+ timeoutMs: draft.input.processResult.timeoutMs,
69
+ wrapperRecoveryHint: buildWrapperRecoveryHint({
70
+ sessionTabCorrection: draft.sessionTabCorrection,
71
+ }),
72
+ });
73
+ }
74
+ function applyErrorEnvelopeFallback(draft) {
75
+ if (draft.errorText !== undefined &&
76
+ draft.errorText.length > 0 &&
77
+ draft.presentationEnvelope?.success === false &&
78
+ extractEnvelopeErrorText(draft.presentationEnvelope.error) === undefined) {
79
+ draft.presentationEnvelope = { ...draft.presentationEnvelope, error: draft.errorText };
80
+ }
81
+ }
82
+ function redactClipboardError(draft) {
83
+ if (draft.errorText !== undefined && draft.errorText.length > 0) {
84
+ const clipboardWritePayloadCandidates = getClipboardWritePayloadCandidates(draft.input.prepared.commandTokens);
85
+ draft.errorText = redactClipboardPermissionEcho(draft.input.prepared.executionPlan.commandInfo, draft.errorText);
86
+ if (draft.presentationEnvelope?.error !== undefined) {
87
+ draft.presentationEnvelope = {
88
+ ...draft.presentationEnvelope,
89
+ error: redactClipboardPermissionErrorValue(draft.input.prepared.executionPlan.commandInfo, draft.presentationEnvelope.error, clipboardWritePayloadCandidates),
90
+ };
91
+ }
92
+ }
93
+ }
94
+ function applyTextErrorEnvelope(draft) {
95
+ if ((draft.plainTextUpgrade || draft.textOutput) &&
96
+ draft.errorText !== undefined &&
97
+ draft.errorText.length > 0) {
98
+ draft.presentationEnvelope = {
99
+ ...draft.presentationEnvelope,
100
+ success: false,
101
+ error: draft.errorText,
102
+ };
103
+ }
104
+ }
105
+ function observeResultLaunchPolicy(draft) {
106
+ const resultRetainsPreparedManagedSession = preparedSessionRetained(draft);
107
+ draft.resultHeadedManagedAutosaveDisabled =
108
+ draft.input.prepared.ownedManagedSessionContext?.headedManagedAutosaveDisabled === true &&
109
+ resultRetainsPreparedManagedSession &&
110
+ !(draft.commandClosesSession && draft.succeeded);
111
+ draft.resultHeadedManagedAutosaveInterval =
112
+ resultRetainsPreparedManagedSession && !(draft.commandClosesSession && draft.succeeded)
113
+ ? draft.input.prepared.ownedManagedSessionContext?.headedManagedAutosaveInterval
114
+ : undefined;
115
+ }
116
+ function classifyMalformedNativeFailure(draft) {
117
+ if (draft.parseError !== undefined &&
118
+ draft.parseError.length > 0 &&
119
+ draft.input.processResult.exitCode !== 0 &&
120
+ draft.input.processResult.stderr.trim().length > 0 &&
121
+ !draft.input.processResult.timedOut &&
122
+ !draft.input.processResult.aborted &&
123
+ !draft.input.processResult.spawnError) {
124
+ draft.presentation.failureCategory = "upstream-error";
125
+ }
126
+ }
127
+ function renderPresentationConfirmation(draft) {
128
+ const confirmation = draft.readConfirmationEvent ?? draft.input.prepared.readConfirmation;
129
+ if (confirmation) {
130
+ draft.presentation.readConfirmation = confirmation;
131
+ renderPendingHelperConfirmation(draft, confirmation);
132
+ if (draft.readConfirmationEvent?.state === "pending") {
133
+ draft.presentation.resultCategory = "failure";
134
+ draft.presentation.failureCategory = "confirmation-required";
135
+ draft.presentation.successCategory = undefined;
136
+ if (draft.confirmationFromHelper) {
137
+ draft.presentation.content.unshift({
138
+ type: "text",
139
+ text: `Native helper ${confirmation.command ?? "read"} requires confirmation (${confirmation.action ?? "read"}, ${confirmation.id}). The requested command's result, if dispatched, is preserved below.`,
140
+ });
141
+ }
142
+ }
143
+ }
144
+ }
145
+ async function renderUpgradeFailure(draft) {
146
+ if (draft.plainTextUpgrade &&
147
+ !draft.textOutput &&
148
+ !draft.succeeded &&
149
+ typeof draft.presentationEnvelope?.data === "string") {
150
+ draft.presentation.data = draft.presentationEnvelope.data;
151
+ const errorContent = draft.presentation.content.at(0);
152
+ if (errorContent?.type === "text" && draft.presentationEnvelope.data.length > 0) {
153
+ errorContent.text += `\n\n${draft.presentationEnvelope.data}`;
154
+ }
155
+ if (draft.input.modelVisible !== false) {
156
+ draft.presentation = await compactLargePresentationOutput({
157
+ artifactManifest: draft.artifactManifest,
158
+ commandInfo: draft.input.prepared.executionPlan.commandInfo,
159
+ data: draft.presentation.data,
160
+ persistentArtifactStore: draft.persistentArtifactStore,
161
+ presentation: draft.presentation,
162
+ });
163
+ }
164
+ }
165
+ }
166
+ function reclassifyScrollNoop(draft) {
167
+ if (draft.diagnostics.scrollNoopDiagnostic) {
168
+ draft.succeeded = false;
169
+ draft.presentation.resultCategory = "failure";
170
+ draft.presentation.failureCategory = "upstream-error";
171
+ draft.presentationEnvelope = {
172
+ ...draft.presentationEnvelope,
173
+ error: "Scroll completed with no observed movement.",
174
+ success: false,
175
+ };
176
+ draft.presentation.summary = "Scroll completed with no observed movement.";
177
+ if (isRecord(draft.presentation.data)) {
178
+ draft.presentation.data = { ...draft.presentation.data, noMovement: true, scrolled: false };
179
+ }
180
+ if (draft.presentation.content[0]?.type === "text") {
181
+ const details = isRecord(draft.presentation.data)
182
+ ? JSON.stringify(omitUpstreamLifecycle(draft.presentation.data), null, 2)
183
+ : draft.presentation.content[0].text;
184
+ draft.presentation.content[0] = {
185
+ ...draft.presentation.content[0],
186
+ text: `Scroll completed with no observed movement.\n\n${details}`,
187
+ };
188
+ }
189
+ else {
190
+ draft.presentation.content.unshift({
191
+ type: "text",
192
+ text: "Scroll completed with no observed movement.",
193
+ });
194
+ }
195
+ }
196
+ }
197
+ function renderParseFailureArtifacts(draft) {
198
+ if (draft.parseFailureOutput.artifactManifest) {
199
+ draft.presentation.artifactManifest = draft.parseFailureOutput.artifactManifest;
200
+ draft.presentation.artifactRetentionSummary = draft.parseFailureOutput.artifactRetentionSummary;
201
+ }
202
+ renderParseFailureNotice(draft);
203
+ if (draft.presentation.artifactManifest) {
204
+ draft.artifactManifest = draft.presentation.artifactManifest;
205
+ }
206
+ }
207
+ function renderPendingHelperConfirmation(draft, confirmation) {
208
+ if (confirmation.state !== "cleared" ||
209
+ !detectConfirmationRequired(draft.presentationEnvelope?.data)) {
210
+ draft.presentation.nextActions = buildReadConfirmationNextActions(confirmation, draft.readConfirmationEvent?.state === "pending");
211
+ }
212
+ }
213
+ function inspectionPresentation(draft) {
214
+ return {
215
+ artifacts: undefined,
216
+ batchFailure: undefined,
217
+ batchSteps: undefined,
218
+ content: [{ type: "text", text: draft.inspectionText ?? "" }],
219
+ data: undefined,
220
+ fullOutputPath: undefined,
221
+ fullOutputPaths: undefined,
222
+ imagePath: undefined,
223
+ imagePaths: undefined,
224
+ savedFile: undefined,
225
+ savedFilePath: undefined,
226
+ summary: `${draft.input.prepared.redactedArgs.join(" ")} completed`,
227
+ };
228
+ }
229
+ function previousContactSheetPath(draft) {
230
+ const key = draft.sessionStateKey;
231
+ return key !== undefined && key.length > 0
232
+ ? draft.input.state.activeRecordingReservations?.get(key)?.contactSheetPath
233
+ : undefined;
234
+ }
235
+ function presentationCleanupOwnership(draft) {
236
+ const key = draft.sessionStateKey;
237
+ return key !== undefined &&
238
+ key.length > 0 &&
239
+ (draft.input.state.ownedManagedSessions.has(key) ||
240
+ draft.input.prepared.executionPlan.managedSessionName !== undefined)
241
+ ? "wrapper-managed"
242
+ : "caller-owned";
243
+ }
244
+ async function buildNativePresentation(draft) {
245
+ if (draft.plainTextInspection) {
246
+ return inspectionPresentation(draft);
247
+ }
248
+ if (draft.recordingStopRecovery && !draft.recordingStopRecovery.batch) {
249
+ return draft.recordingStopRecovery.presentation;
250
+ }
251
+ return buildToolPresentation({
252
+ textOutput: draft.textOutput,
253
+ stdin: draft.input.prepared.processStdin,
254
+ modelVisible: draft.input.modelVisible,
255
+ args: draft.input.prepared.redactedProcessArgs,
256
+ artifactManifest: draft.artifactManifest,
257
+ artifactMaxUpdatedAtMs: Date.now(),
258
+ artifactMinUpdatedAtMs: draft.input.artifactRunStartedAtMs,
259
+ artifactRequest: draft.screenshotArtifactRequest,
260
+ batchArtifactRequests: draft.batchScreenshotArtifactRequests,
261
+ commandInfo: {
262
+ ...draft.input.prepared.executionPlan.commandInfo,
263
+ commandTokens: draft.input.prepared.commandTokens,
264
+ },
265
+ compiledSemanticAction: draft.input.prepared.compiledSemanticAction,
266
+ cwd: draft.operationCwd,
267
+ envelope: draft.presentationEnvelope,
268
+ errorText: draft.errorText,
269
+ namespace: draft.input.prepared.executionPlan.namespace,
270
+ networkRouteDiagnostics: draft.diagnostics.networkRouteDiagnostics,
271
+ networkRoutes: draft.activeNetworkRoutes,
272
+ persistentArtifactStore: draft.persistentArtifactStore,
273
+ previousRecordingContactSheetPath: previousContactSheetPath(draft),
274
+ piCleanupOwnership: presentationCleanupOwnership(draft),
275
+ sessionName: draft.input.prepared.executionPlan.sessionName,
276
+ });
277
+ }
278
+ function preparedSessionRetained(draft) {
279
+ return (!draft.managedSessionOutcome ||
280
+ (draft.managedSessionOutcome.activeAfter &&
281
+ draft.managedSessionOutcome.attemptedSessionName ===
282
+ draft.managedSessionOutcome.currentSessionName));
283
+ }
284
+ function renderParseFailureNotice(draft) {
285
+ const path = draft.parseFailureOutput.fullOutputPath ?? "";
286
+ const unavailable = draft.parseFailureOutput.fullOutputUnavailable ?? "";
287
+ if (path.length === 0 && unavailable.length === 0) {
288
+ return;
289
+ }
290
+ const firstContent = draft.presentation.content.at(0);
291
+ const existingText = firstContent?.type === "text" ? firstContent.text : "";
292
+ const noticeLines = [
293
+ path.length > 0 ? `Full output path: ${path}` : `Full raw output unavailable: ${unavailable}`,
294
+ draft.parseFailureOutput.artifactRetentionSummary,
295
+ ].filter((item) => item !== undefined);
296
+ const notice = noticeLines.join("\n");
297
+ draft.presentation.content[0] = {
298
+ type: "text",
299
+ text: existingText.length > 0 ? `${existingText}\n\n${notice}` : notice,
300
+ };
301
+ }
302
+ function batchRouteEffect(item) {
303
+ if (!isRecord(item) || !isStringArray(item.command)) {
304
+ return;
305
+ }
306
+ return {
307
+ tokens: extractUpstreamCommandTokens(item.command),
308
+ succeeded: item.success !== false && !detectConfirmationRequired(item.result),
309
+ };
310
+ }
311
+ function applyBatchNetworkRouteState(draft) {
312
+ const key = draft.sessionStateKey;
313
+ const data = draft.presentationEnvelope?.data;
314
+ if (!draft.succeeded || key === undefined || key.length === 0 || !Array.isArray(data)) {
315
+ return;
316
+ }
317
+ let routes = draft.networkRoutesBySession.get(key);
318
+ for (const item of data) {
319
+ const effect = batchRouteEffect(item);
320
+ if (!effect) {
321
+ continue;
322
+ }
323
+ routes =
324
+ effect.succeeded && isCloseCommand(effect.tokens[0])
325
+ ? undefined
326
+ : applyNetworkRouteRecords(routes, effect.tokens, effect.succeeded);
327
+ }
328
+ draft.networkRoutesBySession = setNetworkRouteState({
329
+ routes,
330
+ routesBySession: draft.networkRoutesBySession,
331
+ sessionName: key,
332
+ });
333
+ }
@@ -0,0 +1,71 @@
1
+ import { renderNativePresentation, reclassifyPresentation } from "./process-output-presentation.js";
2
+ import { bindOutputDaemonReceipt, publishConfirmedSnapshot } from "./process-output-receipts.js";
3
+ import { analyzeOutputChecks, renderAttachedQaBanner, collectEvalGuidance, } from "./process-output-analysis.js";
4
+ import { collectPublicationWarnings, recoverFinalOutput } from "./process-output-publication.js";
5
+ function createPublicationOutputPhase(input, native, page, lifecycle) {
6
+ return {
7
+ input,
8
+ aboutBlankSessionMismatch: lifecycle.aboutBlankSessionMismatch,
9
+ activeNetworkRoutes: page.activeNetworkRoutes,
10
+ artifactCleanup: undefined,
11
+ artifactManifest: lifecycle.artifactManifest,
12
+ authoritativePageState: undefined,
13
+ batchRefSnapshotState: page.batchRefSnapshotState,
14
+ batchScreenshotArtifactRequests: native.batchScreenshotArtifactRequests,
15
+ commandClosesSession: lifecycle.commandClosesSession,
16
+ confirmationFromHelper: lifecycle.confirmationFromHelper,
17
+ confirmedEffects: page.confirmedEffects,
18
+ currentRefSnapshot: lifecycle.currentRefSnapshot,
19
+ currentRefSnapshotInvalidation: lifecycle.currentRefSnapshotInvalidation,
20
+ currentSessionTabTarget: lifecycle.currentSessionTabTarget,
21
+ currentSessionTabTargetUnknown: undefined,
22
+ electronHandoff: lifecycle.electronHandoff,
23
+ electronPostCommandHealth: page.electronPostCommandHealth,
24
+ electronSessionMismatch: page.electronSessionMismatch,
25
+ errorText: lifecycle.errorText,
26
+ evalResultWarning: undefined,
27
+ evalStdinHint: undefined,
28
+ inspectionText: native.inspectionText,
29
+ managedSessionOutcome: lifecycle.managedSessionOutcome,
30
+ navigationSummary: page.navigationSummary,
31
+ diagnostics: page.diagnostics,
32
+ networkRoutesBySession: lifecycle.networkRoutesBySession,
33
+ networkSourceLookup: undefined,
34
+ operationCwd: input.operationCwd ?? input.cwd,
35
+ parseError: lifecycle.parseError,
36
+ parseFailureOutput: native.parseFailureOutput,
37
+ parseSucceeded: lifecycle.parseSucceeded,
38
+ persistentArtifactStore: native.persistentArtifactStore,
39
+ plainTextInspection: lifecycle.plainTextInspection,
40
+ plainTextUpgrade: lifecycle.plainTextUpgrade,
41
+ presentation: { content: [], summary: "" },
42
+ presentationEnvelope: lifecycle.presentationEnvelope,
43
+ processSucceeded: lifecycle.processSucceeded,
44
+ qaAttachedTarget: undefined,
45
+ qaPreset: undefined,
46
+ readConfirmationEvent: lifecycle.readConfirmationEvent,
47
+ recordingStopRecovery: lifecycle.recordingStopRecovery,
48
+ redactedContent: [],
49
+ resultArtifactManifest: undefined,
50
+ screenshotArtifactRequest: native.screenshotArtifactRequest,
51
+ sessionStateKey: lifecycle.sessionStateKey,
52
+ sessionTabCorrection: lifecycle.sessionTabCorrection,
53
+ sourceLookup: undefined,
54
+ succeeded: lifecycle.succeeded,
55
+ textOutput: lifecycle.textOutput,
56
+ unobservedMutation: page.unobservedMutation,
57
+ };
58
+ }
59
+ export async function publishOutputEffects(input, native, page, lifecycle) {
60
+ const draft = createPublicationOutputPhase(input, native, page, lifecycle);
61
+ await renderNativePresentation(draft);
62
+ reclassifyPresentation(draft);
63
+ await analyzeOutputChecks(draft);
64
+ renderAttachedQaBanner(draft);
65
+ collectEvalGuidance(draft);
66
+ await collectPublicationWarnings(draft);
67
+ const recovery = await recoverFinalOutput(draft);
68
+ await bindOutputDaemonReceipt(draft);
69
+ publishConfirmedSnapshot(draft);
70
+ return { publication: draft, recovery };
71
+ }