pi-agent-browser-native 0.9.5 → 0.9.7
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.
- package/CHANGELOG.md +114 -1
- package/README.md +17 -6
- package/dist/extensions/agent-browser/index.js +2482 -925
- package/dist/packaged/lib/browser-session-conversion.js +2946 -0
- package/dist/packaged/lib/config-policy.js +599 -0
- package/dist/packaged/lib/parsing.js +34 -0
- package/dist/packaged/lib/playbook.js +728 -0
- package/dist/packaged/lib/results/snapshot.js +2800 -0
- package/dist/packaged/lib/runtime.js +3075 -0
- package/docs/ARCHITECTURE.md +29 -10
- package/docs/CODE_QUALITY.md +32 -5
- package/docs/COMMAND_REFERENCE.md +156 -40
- package/docs/ELECTRON.md +1 -1
- package/docs/PERFORMANCE.md +252 -0
- package/docs/REFERENCE.md +15 -15
- package/docs/RELEASE.md +41 -18
- package/docs/REQUIREMENTS.md +6 -0
- package/docs/SESSION_STORAGE.md +13 -5
- package/docs/SUPPORT_MATRIX.md +31 -25
- package/docs/TOOL_CONTRACT.md +41 -18
- package/docs/performance/2026-10-12.json +7257 -0
- package/docs/platform-smoke.md +18 -14
- package/package.json +18 -4
- package/platform-smoke.config.mjs +3 -2
- package/scripts/agent-browser-capability-baseline.mjs +16 -2
- package/scripts/agent-browser-target.mjs +1 -1
- package/scripts/build.mjs +16 -5
- package/scripts/capability-options.mjs +20 -0
- package/scripts/capability-samples.mjs +23 -10
- package/scripts/config.mjs +1 -1
- package/scripts/convert-browser-session.mjs +1 -1
- package/scripts/platform-smoke/commands.mjs +30 -4
- package/scripts/platform-smoke/doctor-support.mjs +11 -2
- package/scripts/platform-smoke/doctor-windows.mjs +1 -1
- package/scripts/platform-smoke/doctor.mjs +26 -11
- package/scripts/platform-smoke/linux-image/Dockerfile +6 -3
- package/scripts/platform-smoke/platform-build-windows.ps1 +23 -3
- package/scripts/platform-smoke/suite-checks.mjs +11 -1
- package/scripts/platform-smoke/targets.mjs +4 -3
- package/scripts/platform-smoke.mjs +68 -25
- package/dist/extensions/agent-browser/lib/argv-descriptor.js +0 -123
- package/dist/extensions/agent-browser/lib/argv-grammar.js +0 -320
- package/dist/extensions/agent-browser/lib/bash-guard.js +0 -193
- package/dist/extensions/agent-browser/lib/batch-lifecycle.js +0 -131
- package/dist/extensions/agent-browser/lib/browser-execution-claim-codec.js +0 -61
- package/dist/extensions/agent-browser/lib/browser-execution-claim-storage.js +0 -232
- package/dist/extensions/agent-browser/lib/browser-execution-claims.js +0 -202
- package/dist/extensions/agent-browser/lib/browser-execution-identity.js +0 -77
- package/dist/extensions/agent-browser/lib/browser-journal-branch.js +0 -98
- package/dist/extensions/agent-browser/lib/browser-journal-contracts.js +0 -1
- package/dist/extensions/agent-browser/lib/browser-journal-projection.js +0 -221
- package/dist/extensions/agent-browser/lib/browser-journal-reader.js +0 -89
- package/dist/extensions/agent-browser/lib/browser-journal-replay.js +0 -246
- package/dist/extensions/agent-browser/lib/browser-journal.js +0 -148
- package/dist/extensions/agent-browser/lib/browser-legacy-pages.js +0 -220
- package/dist/extensions/agent-browser/lib/browser-legacy-projection.js +0 -282
- package/dist/extensions/agent-browser/lib/browser-legacy-types.js +0 -1
- package/dist/extensions/agent-browser/lib/browser-session-conversion-stream.js +0 -217
- package/dist/extensions/agent-browser/lib/browser-session-conversion.js +0 -126
- package/dist/extensions/agent-browser/lib/browser-transcript-contracts.js +0 -35
- package/dist/extensions/agent-browser/lib/browser-transcript-validation.js +0 -166
- package/dist/extensions/agent-browser/lib/browser-transcript.js +0 -189
- package/dist/extensions/agent-browser/lib/browser-value-parsing.js +0 -15
- package/dist/extensions/agent-browser/lib/command-capabilities.js +0 -340
- package/dist/extensions/agent-browser/lib/command-policy.js +0 -155
- package/dist/extensions/agent-browser/lib/command-taxonomy.js +0 -105
- package/dist/extensions/agent-browser/lib/config-policy.js +0 -450
- package/dist/extensions/agent-browser/lib/config-providers.js +0 -71
- package/dist/extensions/agent-browser/lib/config-validation.js +0 -231
- package/dist/extensions/agent-browser/lib/config.js +0 -69
- package/dist/extensions/agent-browser/lib/electron/cdp.js +0 -62
- package/dist/extensions/agent-browser/lib/electron/cleanup.js +0 -274
- package/dist/extensions/agent-browser/lib/electron/discovery-darwin.js +0 -109
- package/dist/extensions/agent-browser/lib/electron/discovery-desktop.js +0 -136
- package/dist/extensions/agent-browser/lib/electron/discovery-evidence.js +0 -90
- package/dist/extensions/agent-browser/lib/electron/discovery-linux.js +0 -93
- package/dist/extensions/agent-browser/lib/electron/discovery-packages.js +0 -162
- package/dist/extensions/agent-browser/lib/electron/discovery-types.js +0 -2
- package/dist/extensions/agent-browser/lib/electron/discovery.js +0 -217
- package/dist/extensions/agent-browser/lib/electron/launch-monitor.js +0 -102
- package/dist/extensions/agent-browser/lib/electron/launch-process.js +0 -209
- package/dist/extensions/agent-browser/lib/electron/launch-types.js +0 -2
- package/dist/extensions/agent-browser/lib/electron/launch.js +0 -340
- package/dist/extensions/agent-browser/lib/executable-path.js +0 -29
- package/dist/extensions/agent-browser/lib/execution-cwd.js +0 -67
- package/dist/extensions/agent-browser/lib/fs-utils.js +0 -10
- package/dist/extensions/agent-browser/lib/input-modes/electron.js +0 -201
- package/dist/extensions/agent-browser/lib/input-modes/job.js +0 -198
- package/dist/extensions/agent-browser/lib/input-modes/lookup-network-evidence.js +0 -116
- package/dist/extensions/agent-browser/lib/input-modes/lookup-plan.js +0 -132
- package/dist/extensions/agent-browser/lib/input-modes/lookup-redaction.js +0 -57
- package/dist/extensions/agent-browser/lib/input-modes/lookup-source-evidence.js +0 -151
- package/dist/extensions/agent-browser/lib/input-modes/lookup-workspace.js +0 -142
- package/dist/extensions/agent-browser/lib/input-modes/lookups.js +0 -84
- package/dist/extensions/agent-browser/lib/input-modes/params.js +0 -195
- package/dist/extensions/agent-browser/lib/input-modes/qa-analysis.js +0 -268
- package/dist/extensions/agent-browser/lib/input-modes/qa-presentation.js +0 -117
- package/dist/extensions/agent-browser/lib/input-modes/script-child.js +0 -396
- package/dist/extensions/agent-browser/lib/input-modes/script-protocol.js +0 -86
- package/dist/extensions/agent-browser/lib/input-modes/script-types.js +0 -1
- package/dist/extensions/agent-browser/lib/input-modes/script-validation.js +0 -60
- package/dist/extensions/agent-browser/lib/input-modes/script.js +0 -108
- package/dist/extensions/agent-browser/lib/input-modes/semantic-action.js +0 -243
- package/dist/extensions/agent-browser/lib/input-modes/shared.js +0 -48
- package/dist/extensions/agent-browser/lib/input-modes/types.js +0 -65
- package/dist/extensions/agent-browser/lib/json-schema.js +0 -65
- package/dist/extensions/agent-browser/lib/launch-scoped-flags.js +0 -212
- package/dist/extensions/agent-browser/lib/managed-session-policy-lock.js +0 -165
- package/dist/extensions/agent-browser/lib/managed-session-posix-storage.js +0 -58
- package/dist/extensions/agent-browser/lib/managed-session-project-identity.js +0 -244
- package/dist/extensions/agent-browser/lib/managed-session-restore-context.js +0 -84
- package/dist/extensions/agent-browser/lib/managed-session-restore-policy.js +0 -119
- package/dist/extensions/agent-browser/lib/managed-session-restore-state.js +0 -83
- package/dist/extensions/agent-browser/lib/managed-session-restore.js +0 -212
- package/dist/extensions/agent-browser/lib/managed-session-snapshot-records.js +0 -277
- package/dist/extensions/agent-browser/lib/managed-session-snapshots.js +0 -181
- package/dist/extensions/agent-browser/lib/managed-session-storage.js +0 -126
- package/dist/extensions/agent-browser/lib/native-confirmation.js +0 -140
- package/dist/extensions/agent-browser/lib/native-output.js +0 -81
- package/dist/extensions/agent-browser/lib/orchestration/batch-stdin.js +0 -182
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/artifact-merge.js +0 -30
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/artifact-paths.js +0 -188
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/browser-observation-result.js +0 -82
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/click-dispatch.js +0 -406
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/diagnostic-values.js +0 -31
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/diagnostics.js +0 -240
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/electron-observation.js +0 -203
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/electron-text-diagnostics.js +0 -109
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/fill-diagnostics.js +0 -119
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-action-recovery.js +0 -147
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-actions.js +0 -144
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-content.js +0 -123
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-contracts.js +0 -1
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-details.js +0 -156
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-electron.js +0 -187
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-evidence.js +0 -39
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-missing-binary.js +0 -89
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-recovery.js +0 -97
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-redaction.js +0 -106
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-timeout.js +0 -110
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result.js +0 -53
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/index.js +0 -224
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/interaction-diagnostics.js +0 -290
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/managed-session-close.js +0 -167
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/managed-session-daemon-inspection.js +0 -108
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/managed-session-daemon-policy.js +0 -174
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/native-helper-observation.js +0 -65
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/observation-types.js +0 -1
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/overlay-diagnostics.js +0 -120
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/network-page-filter.js +0 -192
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/scroll-shims.js +0 -225
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/snapshot-filter-data.js +0 -150
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/snapshot-filter.js +0 -174
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/snapshot-rendered-text.js +0 -147
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/wait-timeouts.js +0 -145
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-artifacts.js +0 -159
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-command.js +0 -131
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-contracts.js +0 -1
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-daemon.js +0 -93
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-failure.js +0 -42
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-guards.js +0 -242
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-input.js +0 -75
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-observations.js +0 -92
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-page-selection.js +0 -254
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-page-state.js +0 -121
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-refs.js +0 -130
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-resources.js +0 -114
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-semantic.js +0 -121
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-session-plan.js +0 -222
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-timeouts.js +0 -68
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare.js +0 -202
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-analysis.js +0 -191
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-confirmation.js +0 -152
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-diagnostics.js +0 -182
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-electron.js +0 -150
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-lifecycle-contracts.js +0 -1
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-lifecycle-phase-contracts.js +0 -1
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-lifecycle-phase.js +0 -115
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-lifecycle.js +0 -256
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-managed-contracts.js +0 -1
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-managed.js +0 -256
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-native-phase-contracts.js +0 -1
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-native-phase.js +0 -93
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-native.js +0 -113
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-navigation-contracts.js +0 -1
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-navigation.js +0 -316
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-ownership.js +0 -28
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-page-phase-contracts.js +0 -1
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-page-phase.js +0 -142
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-presentation-contracts.js +0 -1
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-presentation.js +0 -333
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-publication-phase-contracts.js +0 -1
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-publication-phase.js +0 -71
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-publication.js +0 -201
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-receipts.js +0 -183
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-refs.js +0 -200
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-tabs.js +0 -142
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output.js +0 -25
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prompt-guards.js +0 -50
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/recording-receipt-reconciliation.js +0 -198
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/recording-recovery-contracts.js +0 -1
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/recording-recovery-presentation.js +0 -154
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/recording-recovery.js +0 -80
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/screenshot-capture.js +0 -14
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/screenshot-observation.js +0 -206
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-commands.js +0 -130
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-electron.js +0 -212
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-observations.js +0 -61
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-outcomes.js +0 -187
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-refs.js +0 -169
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-tabs.js +0 -228
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state.js +0 -117
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/text-visibility-diagnostics.js +0 -182
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/timeout-diagnostics.js +0 -256
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/timeout-progress.js +0 -108
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/types.js +0 -1
- package/dist/extensions/agent-browser/lib/orchestration/code-artifact-observation.js +0 -39
- package/dist/extensions/agent-browser/lib/orchestration/code-image-observation.js +0 -119
- package/dist/extensions/agent-browser/lib/orchestration/electron-host/branch.js +0 -93
- package/dist/extensions/agent-browser/lib/orchestration/electron-host/cleanup-result.js +0 -58
- package/dist/extensions/agent-browser/lib/orchestration/electron-host/cleanup.js +0 -78
- package/dist/extensions/agent-browser/lib/orchestration/electron-host/contracts.js +0 -1
- package/dist/extensions/agent-browser/lib/orchestration/electron-host/discovery.js +0 -106
- package/dist/extensions/agent-browser/lib/orchestration/electron-host/index.js +0 -60
- package/dist/extensions/agent-browser/lib/orchestration/electron-host/policy.js +0 -86
- package/dist/extensions/agent-browser/lib/orchestration/electron-host/probe-collection.js +0 -68
- package/dist/extensions/agent-browser/lib/orchestration/electron-host/probe-data.js +0 -169
- package/dist/extensions/agent-browser/lib/orchestration/electron-host/probe-presentation.js +0 -182
- package/dist/extensions/agent-browser/lib/orchestration/electron-host/probe.js +0 -161
- package/dist/extensions/agent-browser/lib/orchestration/electron-host/status.js +0 -167
- package/dist/extensions/agent-browser/lib/orchestration/execution-queue.js +0 -98
- package/dist/extensions/agent-browser/lib/orchestration/extension-artifact-preflight.js +0 -211
- package/dist/extensions/agent-browser/lib/orchestration/extension-artifacts.js +0 -23
- package/dist/extensions/agent-browser/lib/orchestration/extension-attachment-replay.js +0 -99
- package/dist/extensions/agent-browser/lib/orchestration/extension-branch-restore.js +0 -275
- package/dist/extensions/agent-browser/lib/orchestration/extension-code.js +0 -280
- package/dist/extensions/agent-browser/lib/orchestration/extension-command-admission.js +0 -303
- package/dist/extensions/agent-browser/lib/orchestration/extension-command-output.js +0 -36
- package/dist/extensions/agent-browser/lib/orchestration/extension-command-result.js +0 -335
- package/dist/extensions/agent-browser/lib/orchestration/extension-command-run.js +0 -227
- package/dist/extensions/agent-browser/lib/orchestration/extension-command-state.js +0 -1
- package/dist/extensions/agent-browser/lib/orchestration/extension-electron-ownership.js +0 -204
- package/dist/extensions/agent-browser/lib/orchestration/extension-execution-locks.js +0 -139
- package/dist/extensions/agent-browser/lib/orchestration/extension-execution-queue.js +0 -24
- package/dist/extensions/agent-browser/lib/orchestration/extension-host-coordination.js +0 -98
- package/dist/extensions/agent-browser/lib/orchestration/extension-host-run.js +0 -295
- package/dist/extensions/agent-browser/lib/orchestration/extension-intent-replay.js +0 -41
- package/dist/extensions/agent-browser/lib/orchestration/extension-invocation.js +0 -7
- package/dist/extensions/agent-browser/lib/orchestration/extension-lifecycle.js +0 -102
- package/dist/extensions/agent-browser/lib/orchestration/extension-managed-ownership.js +0 -133
- package/dist/extensions/agent-browser/lib/orchestration/extension-observation.js +0 -120
- package/dist/extensions/agent-browser/lib/orchestration/extension-prompt.js +0 -180
- package/dist/extensions/agent-browser/lib/orchestration/extension-recording.js +0 -290
- package/dist/extensions/agent-browser/lib/orchestration/extension-resource-contracts.js +0 -1
- package/dist/extensions/agent-browser/lib/orchestration/extension-resource-replay.js +0 -269
- package/dist/extensions/agent-browser/lib/orchestration/extension-result-state.js +0 -113
- package/dist/extensions/agent-browser/lib/orchestration/extension-runtime.js +0 -146
- package/dist/extensions/agent-browser/lib/orchestration/extension-script-leases.js +0 -58
- package/dist/extensions/agent-browser/lib/orchestration/extension-tool-boundary.js +0 -62
- package/dist/extensions/agent-browser/lib/orchestration/extension-version-check.js +0 -54
- package/dist/extensions/agent-browser/lib/orchestration/input-plan-types.js +0 -1
- package/dist/extensions/agent-browser/lib/orchestration/input-plan.js +0 -313
- package/dist/extensions/agent-browser/lib/orchestration/input-redaction.js +0 -62
- package/dist/extensions/agent-browser/lib/orchestration/native-config.js +0 -144
- package/dist/extensions/agent-browser/lib/orchestration/native-root-launch.js +0 -77
- package/dist/extensions/agent-browser/lib/orchestration/native-session-defaults.js +0 -231
- package/dist/extensions/agent-browser/lib/orchestration/operation-paths.js +0 -142
- package/dist/extensions/agent-browser/lib/orchestration/output-file.js +0 -276
- package/dist/extensions/agent-browser/lib/orchestration/script-mode.js +0 -220
- package/dist/extensions/agent-browser/lib/owned-managed-session-context.js +0 -55
- package/dist/extensions/agent-browser/lib/page-target-batch.js +0 -118
- package/dist/extensions/agent-browser/lib/page-target-guards.js +0 -50
- package/dist/extensions/agent-browser/lib/page-target-navigation.js +0 -104
- package/dist/extensions/agent-browser/lib/page-target-validation.js +0 -90
- package/dist/extensions/agent-browser/lib/parsing.js +0 -30
- package/dist/extensions/agent-browser/lib/pi-tool-rendering.js +0 -343
- package/dist/extensions/agent-browser/lib/playbook.js +0 -146
- package/dist/extensions/agent-browser/lib/process-child.js +0 -284
- package/dist/extensions/agent-browser/lib/process-environment.js +0 -48
- package/dist/extensions/agent-browser/lib/process-errors.js +0 -23
- package/dist/extensions/agent-browser/lib/process-identity.js +0 -127
- package/dist/extensions/agent-browser/lib/process-socket-storage.js +0 -256
- package/dist/extensions/agent-browser/lib/process-stdout.js +0 -74
- package/dist/extensions/agent-browser/lib/process.js +0 -216
- package/dist/extensions/agent-browser/lib/prompt-artifacts.js +0 -287
- package/dist/extensions/agent-browser/lib/prompt-policy.js +0 -54
- package/dist/extensions/agent-browser/lib/read-command.js +0 -41
- package/dist/extensions/agent-browser/lib/read-confirmation.js +0 -162
- package/dist/extensions/agent-browser/lib/recording-reservations.js +0 -208
- package/dist/extensions/agent-browser/lib/redaction-fields.js +0 -75
- package/dist/extensions/agent-browser/lib/redaction-json.js +0 -149
- package/dist/extensions/agent-browser/lib/redaction-url.js +0 -88
- package/dist/extensions/agent-browser/lib/results/action-contracts.js +0 -1
- package/dist/extensions/agent-browser/lib/results/action-recommendations.js +0 -38
- package/dist/extensions/agent-browser/lib/results/artifact-contracts.js +0 -1
- package/dist/extensions/agent-browser/lib/results/artifact-manifest-validation.js +0 -133
- package/dist/extensions/agent-browser/lib/results/artifact-manifest.js +0 -173
- package/dist/extensions/agent-browser/lib/results/artifact-recommendations.js +0 -73
- package/dist/extensions/agent-browser/lib/results/categories.js +0 -152
- package/dist/extensions/agent-browser/lib/results/confirmation.js +0 -75
- package/dist/extensions/agent-browser/lib/results/contracts.js +0 -1
- package/dist/extensions/agent-browser/lib/results/editable-ref-evidence.js +0 -99
- package/dist/extensions/agent-browser/lib/results/electron-recommendations.js +0 -83
- package/dist/extensions/agent-browser/lib/results/envelope-decoding.js +0 -48
- package/dist/extensions/agent-browser/lib/results/envelope.js +0 -198
- package/dist/extensions/agent-browser/lib/results/evidence-contracts.js +0 -1
- package/dist/extensions/agent-browser/lib/results/failure-recommendations.js +0 -180
- package/dist/extensions/agent-browser/lib/results/network-routes.js +0 -133
- package/dist/extensions/agent-browser/lib/results/network.js +0 -89
- package/dist/extensions/agent-browser/lib/results/next-actions.js +0 -111
- package/dist/extensions/agent-browser/lib/results/presentation/artifact-files.js +0 -320
- package/dist/extensions/agent-browser/lib/results/presentation/artifact-format.js +0 -138
- package/dist/extensions/agent-browser/lib/results/presentation/artifact-images.js +0 -113
- package/dist/extensions/agent-browser/lib/results/presentation/artifact-verification.js +0 -145
- package/dist/extensions/agent-browser/lib/results/presentation/artifacts.js +0 -165
- package/dist/extensions/agent-browser/lib/results/presentation/batch-contracts.js +0 -1
- package/dist/extensions/agent-browser/lib/results/presentation/batch-recording.js +0 -118
- package/dist/extensions/agent-browser/lib/results/presentation/batch-redaction.js +0 -68
- package/dist/extensions/agent-browser/lib/results/presentation/batch-rendering.js +0 -135
- package/dist/extensions/agent-browser/lib/results/presentation/batch-step.js +0 -227
- package/dist/extensions/agent-browser/lib/results/presentation/batch-summary.js +0 -91
- package/dist/extensions/agent-browser/lib/results/presentation/batch.js +0 -123
- package/dist/extensions/agent-browser/lib/results/presentation/browser-profile-recovery.js +0 -54
- package/dist/extensions/agent-browser/lib/results/presentation/command-presenters.js +0 -216
- package/dist/extensions/agent-browser/lib/results/presentation/common.js +0 -81
- package/dist/extensions/agent-browser/lib/results/presentation/content.js +0 -119
- package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-a11y.js +0 -67
- package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-health.js +0 -79
- package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-identity.js +0 -199
- package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-logs.js +0 -75
- package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-network-actions.js +0 -216
- package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-network.js +0 -124
- package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-redaction.js +0 -64
- package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-storage.js +0 -209
- package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-stream.js +0 -69
- package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-summary.js +0 -222
- package/dist/extensions/agent-browser/lib/results/presentation/diagnostics.js +0 -124
- package/dist/extensions/agent-browser/lib/results/presentation/early-result.js +0 -70
- package/dist/extensions/agent-browser/lib/results/presentation/errors.js +0 -285
- package/dist/extensions/agent-browser/lib/results/presentation/input-contracts.js +0 -1
- package/dist/extensions/agent-browser/lib/results/presentation/large-output.js +0 -117
- package/dist/extensions/agent-browser/lib/results/presentation/navigation.js +0 -231
- package/dist/extensions/agent-browser/lib/results/presentation/notices.js +0 -75
- package/dist/extensions/agent-browser/lib/results/presentation/observation-contracts.js +0 -1
- package/dist/extensions/agent-browser/lib/results/presentation/observation-rendering.js +0 -127
- package/dist/extensions/agent-browser/lib/results/presentation/outcomes.js +0 -120
- package/dist/extensions/agent-browser/lib/results/presentation/output-completion.js +0 -77
- package/dist/extensions/agent-browser/lib/results/presentation/output-spill.js +0 -51
- package/dist/extensions/agent-browser/lib/results/presentation/registry.js +0 -145
- package/dist/extensions/agent-browser/lib/results/presentation/semantic-action.js +0 -104
- package/dist/extensions/agent-browser/lib/results/presentation/skills.js +0 -183
- package/dist/extensions/agent-browser/lib/results/presentation/source.js +0 -109
- package/dist/extensions/agent-browser/lib/results/presentation.js +0 -19
- package/dist/extensions/agent-browser/lib/results/recommendation-contracts.js +0 -1
- package/dist/extensions/agent-browser/lib/results/recording.js +0 -88
- package/dist/extensions/agent-browser/lib/results/recovery-actions.js +0 -118
- package/dist/extensions/agent-browser/lib/results/recovery-next-actions.js +0 -60
- package/dist/extensions/agent-browser/lib/results/selector-recovery-target.js +0 -83
- package/dist/extensions/agent-browser/lib/results/selector-recovery.js +0 -261
- package/dist/extensions/agent-browser/lib/results/snapshot-compact.js +0 -266
- package/dist/extensions/agent-browser/lib/results/snapshot-content.js +0 -32
- package/dist/extensions/agent-browser/lib/results/snapshot-high-value-controls.js +0 -240
- package/dist/extensions/agent-browser/lib/results/snapshot-refs.js +0 -103
- package/dist/extensions/agent-browser/lib/results/snapshot-segments.js +0 -383
- package/dist/extensions/agent-browser/lib/results/snapshot-spill.js +0 -53
- package/dist/extensions/agent-browser/lib/results/snapshot.js +0 -44
- package/dist/extensions/agent-browser/lib/results/text.js +0 -44
- package/dist/extensions/agent-browser/lib/runtime-args-validation.js +0 -133
- package/dist/extensions/agent-browser/lib/runtime-compatibility.js +0 -81
- package/dist/extensions/agent-browser/lib/runtime-contracts.js +0 -1
- package/dist/extensions/agent-browser/lib/runtime-redaction.js +0 -118
- package/dist/extensions/agent-browser/lib/runtime-replay-events.js +0 -144
- package/dist/extensions/agent-browser/lib/runtime-session-identity.js +0 -76
- package/dist/extensions/agent-browser/lib/runtime-session-plan.js +0 -114
- package/dist/extensions/agent-browser/lib/runtime-session-replay.js +0 -123
- package/dist/extensions/agent-browser/lib/runtime-tab-correction.js +0 -65
- package/dist/extensions/agent-browser/lib/runtime-timeouts.js +0 -28
- package/dist/extensions/agent-browser/lib/runtime.js +0 -163
- package/dist/extensions/agent-browser/lib/session-identity.js +0 -51
- package/dist/extensions/agent-browser/lib/session-page-observation.js +0 -357
- package/dist/extensions/agent-browser/lib/session-page-state.js +0 -353
- package/dist/extensions/agent-browser/lib/session-page-types.js +0 -1
- package/dist/extensions/agent-browser/lib/string-enum-schema.js +0 -8
- package/dist/extensions/agent-browser/lib/temp-artifact-budget.js +0 -81
- package/dist/extensions/agent-browser/lib/temp-mutation-queue.js +0 -7
- package/dist/extensions/agent-browser/lib/temp-root-ownership.js +0 -234
- package/dist/extensions/agent-browser/lib/temp-root.js +0 -211
- package/dist/extensions/agent-browser/lib/temp.js +0 -91
- package/dist/extensions/agent-browser/lib/tool-surface.js +0 -239
- package/dist/extensions/agent-browser/lib/upstream-version.js +0 -15
- package/dist/extensions/agent-browser/lib/web-search-providers.js +0 -193
- package/dist/extensions/agent-browser/lib/web-search-request.js +0 -102
- package/dist/extensions/agent-browser/lib/web-search-results.js +0 -281
- package/dist/extensions/agent-browser/lib/web-search-schema.js +0 -82
- package/dist/extensions/agent-browser/lib/web-search.js +0 -167
- package/dist/extensions/agent-browser/lib/webmcp-observation.js +0 -35
- package/dist/extensions/agent-browser/lib/windows-stock-launcher.js +0 -96
- package/dist/scripts/agent-browser-target.mjs +0 -23
package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-page-selection.js
DELETED
|
@@ -1,254 +0,0 @@
|
|
|
1
|
-
import { isRecord } from "../../parsing.js";
|
|
2
|
-
import { extractUpstreamCommandTokens } from "../../runtime.js";
|
|
3
|
-
import { redactInvocationArgs } from "../../runtime-redaction.js";
|
|
4
|
-
import { getExplicitSessionPageVerificationRequirement, getPageTargetValidationError, } from "../../page-target-validation.js";
|
|
5
|
-
import { buildAgentBrowserResultCategoryDetails } from "../../results/categories.js";
|
|
6
|
-
import { buildStaleRefPreflight, ensureSessionTabTarget, extractStringResultField, runSessionCommandData, shouldPinSessionTabForCommand, } from "./session-state.js";
|
|
7
|
-
import { validateStdinCommandContract } from "./prepare-input.js";
|
|
8
|
-
import { preparationFailure, preparationSessionDetails } from "./prepare-failure.js";
|
|
9
|
-
import { planHasValidationError, withPlanValidationError } from "./prepare-session-plan.js";
|
|
10
|
-
function shouldSelectRememberedTab(plan, hasReadConfirmation, request) {
|
|
11
|
-
const tokens = extractUpstreamCommandTokens(request.preparedArgs.args);
|
|
12
|
-
const knownStaleRef = buildStaleRefPreflight({
|
|
13
|
-
commandTokens: tokens,
|
|
14
|
-
currentTarget: request.page.priorSessionTabTarget,
|
|
15
|
-
refSnapshot: request.page.priorRefSnapshotState,
|
|
16
|
-
refSnapshotInvalidation: request.page.priorRefSnapshotInvalidation,
|
|
17
|
-
stdin: request.stdin,
|
|
18
|
-
});
|
|
19
|
-
const invalidStdin = validateStdinCommandContract({
|
|
20
|
-
command: plan.commandInfo.command,
|
|
21
|
-
commandTokens: tokens,
|
|
22
|
-
stdin: request.stdin,
|
|
23
|
-
});
|
|
24
|
-
const pin = shouldPinSessionTabForCommand({
|
|
25
|
-
command: plan.commandInfo.command,
|
|
26
|
-
commandTokens: tokens,
|
|
27
|
-
pinningRequired: !hasReadConfirmation &&
|
|
28
|
-
request.page.sessionTabPinningReason !== undefined &&
|
|
29
|
-
request.input.compiledQaPreset?.checks.url === undefined,
|
|
30
|
-
reopenPending: request.page.coldManagedSession,
|
|
31
|
-
sessionName: plan.sessionName,
|
|
32
|
-
stdin: request.stdin,
|
|
33
|
-
});
|
|
34
|
-
return (!planHasValidationError(plan) &&
|
|
35
|
-
!plan.plainTextInspection &&
|
|
36
|
-
!knownStaleRef &&
|
|
37
|
-
invalidStdin === undefined &&
|
|
38
|
-
request.page.priorSessionTabTarget !== undefined &&
|
|
39
|
-
pin);
|
|
40
|
-
}
|
|
41
|
-
async function reopenRememberedTab(pageState, process, plan, request) {
|
|
42
|
-
const page = request.page;
|
|
43
|
-
const target = page.priorSessionTabTarget;
|
|
44
|
-
if (!page.coldManagedSession || !target) {
|
|
45
|
-
return { page, reopened: true };
|
|
46
|
-
}
|
|
47
|
-
const data = await runSessionCommandData({
|
|
48
|
-
args: ["open", target.url],
|
|
49
|
-
cwd: process.cwd,
|
|
50
|
-
namespace: plan.namespace,
|
|
51
|
-
sessionName: plan.sessionName,
|
|
52
|
-
signal: process.signal,
|
|
53
|
-
timeoutMs: process.timeoutMs,
|
|
54
|
-
onProcessResult: ({ agentBrowserStarted }) => {
|
|
55
|
-
// A started open may navigate even when its CLI is aborted before replying.
|
|
56
|
-
if (agentBrowserStarted &&
|
|
57
|
-
page.sessionStateKey !== undefined &&
|
|
58
|
-
page.sessionStateKey !== "") {
|
|
59
|
-
pageState.setTabReopenPending({
|
|
60
|
-
pending: false,
|
|
61
|
-
sessionName: page.sessionStateKey,
|
|
62
|
-
update: request.update,
|
|
63
|
-
});
|
|
64
|
-
}
|
|
65
|
-
},
|
|
66
|
-
});
|
|
67
|
-
if (data === undefined) {
|
|
68
|
-
return { page, reopened: false };
|
|
69
|
-
}
|
|
70
|
-
return {
|
|
71
|
-
page: {
|
|
72
|
-
...page,
|
|
73
|
-
priorSessionTabTarget: {
|
|
74
|
-
...target,
|
|
75
|
-
targetId: isRecord(data) && typeof data.targetId === "string" ? data.targetId : undefined,
|
|
76
|
-
},
|
|
77
|
-
},
|
|
78
|
-
reopened: true,
|
|
79
|
-
};
|
|
80
|
-
}
|
|
81
|
-
function abortedReopenResult(restoreDisabled, plan, request) {
|
|
82
|
-
const errorText = "agent_browser was aborted while reopening the remembered page. The requested command did not run.";
|
|
83
|
-
return preparationFailure({
|
|
84
|
-
message: errorText,
|
|
85
|
-
details: {
|
|
86
|
-
aborted: true,
|
|
87
|
-
args: request.input.redactedArgs,
|
|
88
|
-
command: plan.commandInfo.command,
|
|
89
|
-
effectiveArgs: redactInvocationArgs(plan.effectiveArgs),
|
|
90
|
-
sessionMode: request.sessionMode,
|
|
91
|
-
...preparationSessionDetails(restoreDisabled, plan),
|
|
92
|
-
...buildAgentBrowserResultCategoryDetails({
|
|
93
|
-
args: request.input.redactedArgs,
|
|
94
|
-
command: plan.commandInfo.command,
|
|
95
|
-
errorText,
|
|
96
|
-
failureCategory: "aborted",
|
|
97
|
-
succeeded: false,
|
|
98
|
-
}),
|
|
99
|
-
},
|
|
100
|
-
});
|
|
101
|
-
}
|
|
102
|
-
async function selectReopenedTab(process, plan, reopened) {
|
|
103
|
-
if (process.signal?.aborted === true) {
|
|
104
|
-
return undefined;
|
|
105
|
-
}
|
|
106
|
-
if (!reopened.reopened) {
|
|
107
|
-
return {
|
|
108
|
-
error: "agent-browser could not reopen the remembered URL after the managed browser shut down. Navigate explicitly, then run snapshot -i before retrying.",
|
|
109
|
-
};
|
|
110
|
-
}
|
|
111
|
-
const target = reopened.page.priorSessionTabTarget;
|
|
112
|
-
if (!target) {
|
|
113
|
-
return undefined;
|
|
114
|
-
}
|
|
115
|
-
return ensureSessionTabTarget({
|
|
116
|
-
cwd: process.cwd,
|
|
117
|
-
namespace: plan.namespace,
|
|
118
|
-
sessionName: plan.sessionName,
|
|
119
|
-
signal: process.signal,
|
|
120
|
-
target,
|
|
121
|
-
});
|
|
122
|
-
}
|
|
123
|
-
function reconcileTabSelection(base, reopened, selection) {
|
|
124
|
-
const error = selection?.error;
|
|
125
|
-
return {
|
|
126
|
-
...base,
|
|
127
|
-
page: reopened.page,
|
|
128
|
-
sessionTabCorrection: selection?.correction,
|
|
129
|
-
sessionTabSelectionError: error,
|
|
130
|
-
executionPlan: error !== undefined && error !== ""
|
|
131
|
-
? withPlanValidationError(base.executionPlan, error)
|
|
132
|
-
: base.executionPlan,
|
|
133
|
-
};
|
|
134
|
-
}
|
|
135
|
-
export async function preparePageSelection(pageState, process, hasReadConfirmation, request) {
|
|
136
|
-
const base = {
|
|
137
|
-
page: request.page,
|
|
138
|
-
executionPlan: request.plan,
|
|
139
|
-
livePageVerified: false,
|
|
140
|
-
};
|
|
141
|
-
if (!shouldSelectRememberedTab(request.plan, hasReadConfirmation, request)) {
|
|
142
|
-
return base;
|
|
143
|
-
}
|
|
144
|
-
process.signal?.throwIfAborted();
|
|
145
|
-
const reopened = await reopenRememberedTab(pageState, process, request.plan, request);
|
|
146
|
-
const selection = await selectReopenedTab(process, request.plan, reopened);
|
|
147
|
-
if (request.page.coldManagedSession && process.signal?.aborted === true) {
|
|
148
|
-
return {
|
|
149
|
-
earlyResult: abortedReopenResult(request.restoreDisabled, request.plan, request),
|
|
150
|
-
};
|
|
151
|
-
}
|
|
152
|
-
process.signal?.throwIfAborted();
|
|
153
|
-
return reconcileTabSelection(base, reopened, selection);
|
|
154
|
-
}
|
|
155
|
-
export function callerOwnedExplicitSession(ownsSession, plan) {
|
|
156
|
-
return plan.sessionName !== undefined && !plan.usedImplicitSession && !ownsSession;
|
|
157
|
-
}
|
|
158
|
-
export function requiresLivePageVerification(preserveAttachedBrowserSession, routing, selection) {
|
|
159
|
-
return (!routing.hasReadConfirmation &&
|
|
160
|
-
(selection.page.reuseConfirmedCapture ||
|
|
161
|
-
callerOwnedExplicitSession(routing.ownsSession, selection.executionPlan) ||
|
|
162
|
-
preserveAttachedBrowserSession === true));
|
|
163
|
-
}
|
|
164
|
-
async function readLiveUrl(process, plan) {
|
|
165
|
-
try {
|
|
166
|
-
const data = await runSessionCommandData({
|
|
167
|
-
args: ["get", "url"],
|
|
168
|
-
cwd: process.cwd,
|
|
169
|
-
namespace: plan.namespace,
|
|
170
|
-
sessionName: plan.sessionName,
|
|
171
|
-
signal: process.signal,
|
|
172
|
-
throwOnFailure: true,
|
|
173
|
-
});
|
|
174
|
-
return extractStringResultField(data, "result") ?? extractStringResultField(data, "url");
|
|
175
|
-
}
|
|
176
|
-
catch (error) {
|
|
177
|
-
if (process.signal?.aborted === true) {
|
|
178
|
-
process.signal.throwIfAborted();
|
|
179
|
-
throw error;
|
|
180
|
-
}
|
|
181
|
-
// A failed read cannot establish the target; the caller retains the requirement error.
|
|
182
|
-
}
|
|
183
|
-
return undefined;
|
|
184
|
-
}
|
|
185
|
-
function verifiedLivePage(selection, url) {
|
|
186
|
-
const target = selection.page.priorSessionTabTarget;
|
|
187
|
-
return {
|
|
188
|
-
...selection,
|
|
189
|
-
livePageVerified: true,
|
|
190
|
-
page: {
|
|
191
|
-
...selection.page,
|
|
192
|
-
priorSessionTabTarget: target?.url === url ? { ...target, url } : { url },
|
|
193
|
-
priorSessionTabTargetUnknown: undefined,
|
|
194
|
-
},
|
|
195
|
-
};
|
|
196
|
-
}
|
|
197
|
-
export async function verifyPreparationLivePage(process, selection, request) {
|
|
198
|
-
const plan = selection.executionPlan;
|
|
199
|
-
if (request.requirement === undefined ||
|
|
200
|
-
request.requirement === "" ||
|
|
201
|
-
plan.sessionName === undefined ||
|
|
202
|
-
plan.sessionName === "") {
|
|
203
|
-
return selection;
|
|
204
|
-
}
|
|
205
|
-
if (process.establishAttachedBrowserSession === true) {
|
|
206
|
-
return { ...selection, executionPlan: withPlanValidationError(plan, request.requirement) };
|
|
207
|
-
}
|
|
208
|
-
const url = await readLiveUrl(process, plan);
|
|
209
|
-
if (url === undefined) {
|
|
210
|
-
return { ...selection, executionPlan: withPlanValidationError(plan, request.requirement) };
|
|
211
|
-
}
|
|
212
|
-
const error = getPageTargetValidationError({
|
|
213
|
-
args: request.args,
|
|
214
|
-
currentPageUrl: url,
|
|
215
|
-
pageUrlUnknown: false,
|
|
216
|
-
stdin: request.stdin,
|
|
217
|
-
});
|
|
218
|
-
if (error !== undefined && error !== "") {
|
|
219
|
-
return { ...selection, executionPlan: withPlanValidationError(plan, error) };
|
|
220
|
-
}
|
|
221
|
-
return verifiedLivePage(selection, url);
|
|
222
|
-
}
|
|
223
|
-
export async function verifyCommandLivePage(process, routing, selection, request) {
|
|
224
|
-
const { page, executionPlan: plan } = selection;
|
|
225
|
-
const stale = buildStaleRefPreflight({
|
|
226
|
-
commandTokens: request.commandTokens,
|
|
227
|
-
currentTarget: page.priorSessionTabTarget,
|
|
228
|
-
refSnapshot: request.resolvedSnapshot ?? page.priorRefSnapshotState,
|
|
229
|
-
refSnapshotInvalidation: request.resolvedSnapshot
|
|
230
|
-
? undefined
|
|
231
|
-
: page.priorRefSnapshotInvalidation,
|
|
232
|
-
stdin: request.stdin,
|
|
233
|
-
});
|
|
234
|
-
const invalidStdin = validateStdinCommandContract({
|
|
235
|
-
command: plan.commandInfo.command,
|
|
236
|
-
commandTokens: request.commandTokens,
|
|
237
|
-
stdin: request.stdin,
|
|
238
|
-
});
|
|
239
|
-
const eligible = !planHasValidationError(plan) &&
|
|
240
|
-
stale === undefined &&
|
|
241
|
-
invalidStdin === undefined &&
|
|
242
|
-
requiresLivePageVerification(process.preserveAttachedBrowserSession, routing, selection);
|
|
243
|
-
const requirement = eligible && !selection.livePageVerified
|
|
244
|
-
? getExplicitSessionPageVerificationRequirement({
|
|
245
|
-
args: plan.effectiveArgs,
|
|
246
|
-
stdin: request.stdin,
|
|
247
|
-
})
|
|
248
|
-
: undefined;
|
|
249
|
-
return verifyPreparationLivePage(process, selection, {
|
|
250
|
-
args: plan.effectiveArgs,
|
|
251
|
-
requirement,
|
|
252
|
-
stdin: request.stdin,
|
|
253
|
-
});
|
|
254
|
-
}
|
|
@@ -1,121 +0,0 @@
|
|
|
1
|
-
import { isCloseCommand } from "../../command-taxonomy.js";
|
|
2
|
-
import { buildPageTransitionRefSnapshotInvalidation, } from "../../session-page-state.js";
|
|
3
|
-
import { inspectManagedSessionDaemon } from "./managed-session-daemon-policy.js";
|
|
4
|
-
import { getSessionContextKey } from "./session-state.js";
|
|
5
|
-
export async function inspectPreparationGeneration(process, identity) {
|
|
6
|
-
return inspectManagedSessionDaemon({
|
|
7
|
-
...process,
|
|
8
|
-
namespace: identity.namespace,
|
|
9
|
-
sessionName: identity.sessionName,
|
|
10
|
-
includeGeneration: true,
|
|
11
|
-
headedManagedAutosaveInterval: identity.owned?.headedManagedAutosaveInterval ??
|
|
12
|
-
(identity.owned?.headedManagedAutosaveDisabled === true ? "0" : undefined),
|
|
13
|
-
});
|
|
14
|
-
}
|
|
15
|
-
function consumeConfirmedCapture(state, update, key) {
|
|
16
|
-
const confirmed = key !== undefined && key !== "" ? state.sessionPageState.getReadConfirmation(key) : undefined;
|
|
17
|
-
if (confirmed?.refSnapshotFresh !== true) {
|
|
18
|
-
return false;
|
|
19
|
-
}
|
|
20
|
-
// ponytail: reuse the approved capture for one call; DOM-only renames after that sample are not resampled on this use.
|
|
21
|
-
const consumed = { ...confirmed };
|
|
22
|
-
delete consumed.refSnapshotFresh;
|
|
23
|
-
state.sessionPageState.applyReadConfirmation(consumed, update);
|
|
24
|
-
state.observedBrowserEffects = { ...state.observedBrowserEffects, readConfirmation: consumed };
|
|
25
|
-
return true;
|
|
26
|
-
}
|
|
27
|
-
function generationInspectionEligible(plan, browserIndependent, page) {
|
|
28
|
-
if (browserIndependent || isCloseCommand(plan.commandInfo.command)) {
|
|
29
|
-
return false;
|
|
30
|
-
}
|
|
31
|
-
return ((page.priorRefSnapshotState?.refIds.length ?? 0) > 0 &&
|
|
32
|
-
page.sessionStateKey !== undefined &&
|
|
33
|
-
page.sessionStateKey !== "" &&
|
|
34
|
-
plan.sessionName !== undefined &&
|
|
35
|
-
plan.sessionName !== "");
|
|
36
|
-
}
|
|
37
|
-
async function reconcileGeneration(pageState, process, request) {
|
|
38
|
-
const { page, plan, session } = request;
|
|
39
|
-
const snapshot = page.priorRefSnapshotState;
|
|
40
|
-
const key = page.sessionStateKey;
|
|
41
|
-
const name = plan.sessionName;
|
|
42
|
-
if (!generationInspectionEligible(plan, session.browserIndependent, page) ||
|
|
43
|
-
snapshot === undefined ||
|
|
44
|
-
key === undefined ||
|
|
45
|
-
name === undefined) {
|
|
46
|
-
return { ...page, nativeGenerationChanged: false };
|
|
47
|
-
}
|
|
48
|
-
const daemon = await inspectPreparationGeneration(process, {
|
|
49
|
-
namespace: plan.namespace,
|
|
50
|
-
sessionName: name,
|
|
51
|
-
owned: session.ownedManagedSession,
|
|
52
|
-
});
|
|
53
|
-
pageState.bindSnapshotGeneration(key, daemon.status === "active" ? daemon.generation : undefined);
|
|
54
|
-
const generationKnown = daemon.status === "active" && daemon.generation !== undefined;
|
|
55
|
-
if (generationKnown && snapshot.generation === daemon.generation) {
|
|
56
|
-
return { ...page, nativeGenerationChanged: false };
|
|
57
|
-
}
|
|
58
|
-
const nativeGenerationChanged = generationKnown && snapshot.generation !== undefined;
|
|
59
|
-
const invalidation = buildPageTransitionRefSnapshotInvalidation("The native browser generation changed or could not be verified. Take a new complete snapshot before using refs, even when the URL is unchanged.");
|
|
60
|
-
pageState.applyRefSnapshotInvalidation({
|
|
61
|
-
invalidation,
|
|
62
|
-
sessionName: key,
|
|
63
|
-
update: request.update,
|
|
64
|
-
});
|
|
65
|
-
return {
|
|
66
|
-
...page,
|
|
67
|
-
nativeGenerationChanged,
|
|
68
|
-
priorRefSnapshotState: undefined,
|
|
69
|
-
priorRefSnapshotInvalidation: invalidation,
|
|
70
|
-
};
|
|
71
|
-
}
|
|
72
|
-
function coldSessionEligible(request) {
|
|
73
|
-
const nativeCold = request.inactive || request.page.nativeGenerationChanged || request.reopenPending;
|
|
74
|
-
return (!request.browserIndependent &&
|
|
75
|
-
nativeCold &&
|
|
76
|
-
request.restoreEligible &&
|
|
77
|
-
request.preserveAttachedBrowserSession !== true);
|
|
78
|
-
}
|
|
79
|
-
export async function preparePageState(state, process, request) {
|
|
80
|
-
const { plan, session, update } = request;
|
|
81
|
-
const key = getSessionContextKey(plan.sessionName, plan.namespace);
|
|
82
|
-
const pageState = state.sessionPageState;
|
|
83
|
-
const prior = pageState.get(key);
|
|
84
|
-
const page = await reconcileGeneration(pageState, process, {
|
|
85
|
-
plan,
|
|
86
|
-
session,
|
|
87
|
-
update,
|
|
88
|
-
page: {
|
|
89
|
-
sessionStateKey: key,
|
|
90
|
-
priorSessionTabTarget: prior.tabTarget,
|
|
91
|
-
priorSessionTabTargetUnknown: prior.tabTargetUnknown,
|
|
92
|
-
sessionTabPinningReason: prior.pinningReason,
|
|
93
|
-
priorRefSnapshotState: prior.refSnapshot,
|
|
94
|
-
priorRefSnapshotInvalidation: prior.refSnapshotInvalidation,
|
|
95
|
-
reuseConfirmedCapture: consumeConfirmedCapture(state, update, key),
|
|
96
|
-
coldManagedSession: false,
|
|
97
|
-
},
|
|
98
|
-
});
|
|
99
|
-
const coldManagedSession = coldSessionEligible({
|
|
100
|
-
browserIndependent: session.browserIndependent,
|
|
101
|
-
...request,
|
|
102
|
-
page,
|
|
103
|
-
reopenPending: prior.tabReopenPending === true,
|
|
104
|
-
restoreEligible: session.recordedOwnedSession !== undefined &&
|
|
105
|
-
page.sessionTabPinningReason === "restore" &&
|
|
106
|
-
session.ownedManagedSession?.restoreDecision === "enabled" &&
|
|
107
|
-
!state.managedSessionRestoreState.isDisabled(plan.sessionName, plan.namespace),
|
|
108
|
-
});
|
|
109
|
-
if (!coldManagedSession || key === undefined || key === "") {
|
|
110
|
-
return { ...page, coldManagedSession };
|
|
111
|
-
}
|
|
112
|
-
pageState.setTabReopenPending({ pending: true, sessionName: key, update });
|
|
113
|
-
const invalidation = buildPageTransitionRefSnapshotInvalidation("The managed browser shut down. Reopening its URL reloads the page; run snapshot -i before using page-scoped refs.");
|
|
114
|
-
pageState.applyRefSnapshotInvalidation({ invalidation, sessionName: key, update });
|
|
115
|
-
return {
|
|
116
|
-
...page,
|
|
117
|
-
coldManagedSession,
|
|
118
|
-
priorRefSnapshotState: undefined,
|
|
119
|
-
priorRefSnapshotInvalidation: invalidation,
|
|
120
|
-
};
|
|
121
|
-
}
|
|
@@ -1,130 +0,0 @@
|
|
|
1
|
-
import { getCompiledSemanticActionSessionPrefix } from "../../input-modes/semantic-action.js";
|
|
2
|
-
import { resolveVisibleRefActionFromSnapshot } from "../../results/selector-recovery.js";
|
|
3
|
-
import { extractRefSnapshotFromData, normalizeComparableUrl } from "../../session-page-state.js";
|
|
4
|
-
import { getGuardedRefUsage, runSessionCommandData } from "./session-state.js";
|
|
5
|
-
function describeRef(snapshot, refId) {
|
|
6
|
-
const ref = snapshot?.refs?.[refId];
|
|
7
|
-
return ref ? `${ref.role} ${JSON.stringify(ref.name)}` : "not present";
|
|
8
|
-
}
|
|
9
|
-
function refChanged(previous, current, refId) {
|
|
10
|
-
const previousRef = previous.refs?.[refId];
|
|
11
|
-
const currentRef = current.refs?.[refId];
|
|
12
|
-
if (!current.refIds.includes(refId)) {
|
|
13
|
-
return true;
|
|
14
|
-
}
|
|
15
|
-
if (!previousRef || !currentRef) {
|
|
16
|
-
return previousRef !== currentRef;
|
|
17
|
-
}
|
|
18
|
-
return previousRef.role !== currentRef.role || previousRef.name !== currentRef.name;
|
|
19
|
-
}
|
|
20
|
-
function samePageFreshnessFailure(options) {
|
|
21
|
-
const previousUrl = normalizeComparableUrl(options.previousSnapshot.target?.url);
|
|
22
|
-
const currentUrl = normalizeComparableUrl(options.currentSnapshot.target?.url);
|
|
23
|
-
if (previousUrl === undefined ||
|
|
24
|
-
previousUrl === "" ||
|
|
25
|
-
currentUrl === undefined ||
|
|
26
|
-
currentUrl === "" ||
|
|
27
|
-
previousUrl !== currentUrl ||
|
|
28
|
-
currentUrl === "about:blank") {
|
|
29
|
-
return undefined;
|
|
30
|
-
}
|
|
31
|
-
const mismatchedRefs = options.refIds.filter((refId) => refChanged(options.previousSnapshot, options.currentSnapshot, refId));
|
|
32
|
-
if (mismatchedRefs.length === 0) {
|
|
33
|
-
return undefined;
|
|
34
|
-
}
|
|
35
|
-
const refText = mismatchedRefs.map((refId) => `@${refId}`).join(", ");
|
|
36
|
-
const evidence = mismatchedRefs
|
|
37
|
-
.map((refId) => `@${refId}: previous ${describeRef(options.previousSnapshot, refId)}, current ${describeRef(options.currentSnapshot, refId)}`)
|
|
38
|
-
.join("; ");
|
|
39
|
-
return {
|
|
40
|
-
message: `Ref ${refText} no longer matches the latest same-page snapshot. The page likely rerendered after the previous snapshot; run snapshot -i and retry with current refs. Evidence: ${evidence}.`,
|
|
41
|
-
refIds: mismatchedRefs,
|
|
42
|
-
};
|
|
43
|
-
}
|
|
44
|
-
function targetPrecludesFreshness(previousSnapshot, currentTarget) {
|
|
45
|
-
const previousUrl = normalizeComparableUrl(previousSnapshot.target?.url);
|
|
46
|
-
const currentUrl = normalizeComparableUrl(currentTarget?.url);
|
|
47
|
-
if (currentUrl === "about:blank") {
|
|
48
|
-
return true;
|
|
49
|
-
}
|
|
50
|
-
return (previousUrl !== undefined &&
|
|
51
|
-
previousUrl !== "" &&
|
|
52
|
-
currentUrl !== undefined &&
|
|
53
|
-
currentUrl !== "" &&
|
|
54
|
-
previousUrl !== currentUrl);
|
|
55
|
-
}
|
|
56
|
-
export async function collectSamePageRefFreshnessPreflight(options) {
|
|
57
|
-
const refIds = [...new Set(getGuardedRefUsage(options.commandTokens, options.stdin))];
|
|
58
|
-
if (!options.previousSnapshot ||
|
|
59
|
-
options.sessionName === undefined ||
|
|
60
|
-
options.sessionName === "" ||
|
|
61
|
-
refIds.length === 0) {
|
|
62
|
-
return undefined;
|
|
63
|
-
}
|
|
64
|
-
if (targetPrecludesFreshness(options.previousSnapshot, options.currentTarget)) {
|
|
65
|
-
return undefined;
|
|
66
|
-
}
|
|
67
|
-
const snapshotData = await runSessionCommandData({
|
|
68
|
-
args: ["snapshot", "-i"],
|
|
69
|
-
cwd: options.cwd,
|
|
70
|
-
namespace: options.namespace,
|
|
71
|
-
sessionName: options.sessionName,
|
|
72
|
-
signal: options.signal,
|
|
73
|
-
});
|
|
74
|
-
const currentSnapshot = extractRefSnapshotFromData(snapshotData);
|
|
75
|
-
if (!currentSnapshot) {
|
|
76
|
-
return undefined;
|
|
77
|
-
}
|
|
78
|
-
const snapshotWithTarget = {
|
|
79
|
-
...currentSnapshot,
|
|
80
|
-
target: currentSnapshot.target ?? options.currentTarget,
|
|
81
|
-
};
|
|
82
|
-
const mismatch = samePageFreshnessFailure({
|
|
83
|
-
currentSnapshot: snapshotWithTarget,
|
|
84
|
-
previousSnapshot: options.previousSnapshot,
|
|
85
|
-
refIds,
|
|
86
|
-
});
|
|
87
|
-
return mismatch
|
|
88
|
-
? { message: mismatch.message, refIds: mismatch.refIds, snapshot: snapshotWithTarget }
|
|
89
|
-
: undefined;
|
|
90
|
-
}
|
|
91
|
-
export function canResolveSemanticVisibleRef(compiled) {
|
|
92
|
-
if (compiled?.locator === undefined) {
|
|
93
|
-
return false;
|
|
94
|
-
}
|
|
95
|
-
if (compiled.action === "select") {
|
|
96
|
-
return true;
|
|
97
|
-
}
|
|
98
|
-
return compiled.locator === "role" && ["check", "click", "fill"].includes(compiled.action);
|
|
99
|
-
}
|
|
100
|
-
export function requiresResolvedSemanticVisibleRef(compiled) {
|
|
101
|
-
return compiled?.action === "select" && compiled.locator !== undefined;
|
|
102
|
-
}
|
|
103
|
-
export async function resolveSemanticActionVisibleRefArgs(options) {
|
|
104
|
-
if (!canResolveSemanticVisibleRef(options.compiled) ||
|
|
105
|
-
options.sessionName === undefined ||
|
|
106
|
-
options.sessionName === "") {
|
|
107
|
-
return undefined;
|
|
108
|
-
}
|
|
109
|
-
const snapshotData = options.refSnapshot
|
|
110
|
-
? undefined
|
|
111
|
-
: await runSessionCommandData({
|
|
112
|
-
args: ["snapshot", "-i"],
|
|
113
|
-
cwd: options.cwd,
|
|
114
|
-
namespace: options.namespace,
|
|
115
|
-
sessionName: options.sessionName,
|
|
116
|
-
signal: options.signal,
|
|
117
|
-
});
|
|
118
|
-
const resolution = resolveVisibleRefActionFromSnapshot({
|
|
119
|
-
allowFill: true,
|
|
120
|
-
compiledAction: options.compiled,
|
|
121
|
-
refSnapshot: options.refSnapshot,
|
|
122
|
-
snapshotData,
|
|
123
|
-
});
|
|
124
|
-
return resolution
|
|
125
|
-
? {
|
|
126
|
-
args: [...getCompiledSemanticActionSessionPrefix(options.compiled), ...resolution.args],
|
|
127
|
-
snapshot: resolution.snapshot,
|
|
128
|
-
}
|
|
129
|
-
: undefined;
|
|
130
|
-
}
|
|
@@ -1,114 +0,0 @@
|
|
|
1
|
-
import { cleanupElectronLaunchResources } from "../../electron/cleanup.js";
|
|
2
|
-
import { launchElectronApp } from "../../electron/launch.js";
|
|
3
|
-
import { redactSensitiveText } from "../../runtime-redaction.js";
|
|
4
|
-
import { buildAgentBrowserResultCategoryDetails } from "../../results/categories.js";
|
|
5
|
-
import { buildElectronHostFailureResult, getElectronLaunchFailureCategory, } from "./final-result.js";
|
|
6
|
-
import { buildManagedSessionOutcome } from "./session-state.js";
|
|
7
|
-
import { prepareAgentBrowserArgs } from "./prepare-artifacts.js";
|
|
8
|
-
import { preparationFailure } from "./prepare-failure.js";
|
|
9
|
-
export async function prepareElectronLaunch(facts, input, freshSessionName) {
|
|
10
|
-
const compiled = input.compiledElectron;
|
|
11
|
-
if (compiled?.action !== "launch") {
|
|
12
|
-
return {};
|
|
13
|
-
}
|
|
14
|
-
const launched = await launchElectronApp({ ...compiled, signal: facts.signal });
|
|
15
|
-
if (!launched.ok) {
|
|
16
|
-
const managedSessionOutcome = buildManagedSessionOutcome({
|
|
17
|
-
activeAfter: facts.managedSessionActive,
|
|
18
|
-
activeBefore: facts.managedSessionActive,
|
|
19
|
-
attemptedSessionName: freshSessionName,
|
|
20
|
-
command: "connect",
|
|
21
|
-
currentSessionName: facts.managedSessionName,
|
|
22
|
-
previousSessionName: facts.managedSessionName,
|
|
23
|
-
sessionMode: "fresh",
|
|
24
|
-
succeeded: false,
|
|
25
|
-
});
|
|
26
|
-
return {
|
|
27
|
-
earlyResult: {
|
|
28
|
-
kind: "early-result",
|
|
29
|
-
result: buildElectronHostFailureResult({
|
|
30
|
-
compiledElectron: input.redactedCompiledElectron ?? compiled,
|
|
31
|
-
errorText: launched.failure.error,
|
|
32
|
-
failureCategory: getElectronLaunchFailureCategory(launched.failure),
|
|
33
|
-
launchFailure: launched.failure,
|
|
34
|
-
managedSessionOutcome,
|
|
35
|
-
status: launched.failure.reason,
|
|
36
|
-
}),
|
|
37
|
-
},
|
|
38
|
-
};
|
|
39
|
-
}
|
|
40
|
-
return {
|
|
41
|
-
electronLaunch: {
|
|
42
|
-
...launched.value,
|
|
43
|
-
record: { ...launched.value.record, ownerSessionId: facts.getOwnerSessionId() },
|
|
44
|
-
},
|
|
45
|
-
};
|
|
46
|
-
}
|
|
47
|
-
async function cleanupPreparationElectron(state, launch, timeoutMs) {
|
|
48
|
-
try {
|
|
49
|
-
const cleanup = await cleanupElectronLaunchResources({
|
|
50
|
-
child: launch.child,
|
|
51
|
-
record: launch.record,
|
|
52
|
-
timeoutMs,
|
|
53
|
-
});
|
|
54
|
-
if (cleanup.partial) {
|
|
55
|
-
state.electronLaunchRecords.set(cleanup.launchId, cleanup.record);
|
|
56
|
-
state.electronChildProcesses.set(cleanup.launchId, launch.child);
|
|
57
|
-
}
|
|
58
|
-
}
|
|
59
|
-
catch {
|
|
60
|
-
state.electronLaunchRecords.set(launch.record.launchId, launch.record);
|
|
61
|
-
state.electronChildProcesses.set(launch.record.launchId, launch.child);
|
|
62
|
-
}
|
|
63
|
-
}
|
|
64
|
-
export async function cleanupPreparationResources(state, resources) {
|
|
65
|
-
// Release native execution ownership before tearing down the task-owned Electron process.
|
|
66
|
-
await resources.lock?.release();
|
|
67
|
-
if (resources.electronLaunch) {
|
|
68
|
-
await cleanupPreparationElectron(state, resources.electronLaunch, resources.timeoutMs);
|
|
69
|
-
}
|
|
70
|
-
}
|
|
71
|
-
function artifactDirectoryFailure(error, path, redactedArgs) {
|
|
72
|
-
const guidance = "Choose a writable artifact path whose parent components are directories. Use absolute paths in raw batch artifact rows.";
|
|
73
|
-
const validationError = redactSensitiveText(`Could not prepare artifact directory ${path}: ${error.message}. ${guidance}`);
|
|
74
|
-
return preparationFailure({
|
|
75
|
-
message: validationError,
|
|
76
|
-
details: {
|
|
77
|
-
agentBrowserStarted: false,
|
|
78
|
-
args: redactedArgs,
|
|
79
|
-
nextActions: [
|
|
80
|
-
{
|
|
81
|
-
artifactPath: redactSensitiveText(path),
|
|
82
|
-
id: "verify-artifact-path",
|
|
83
|
-
reason: guidance,
|
|
84
|
-
safety: "The requested browser command did not run; inspect the directory with host file tools before retrying.",
|
|
85
|
-
tool: "agent_browser",
|
|
86
|
-
},
|
|
87
|
-
],
|
|
88
|
-
...buildAgentBrowserResultCategoryDetails({
|
|
89
|
-
args: redactedArgs,
|
|
90
|
-
succeeded: false,
|
|
91
|
-
validationError,
|
|
92
|
-
}),
|
|
93
|
-
validationError,
|
|
94
|
-
},
|
|
95
|
-
});
|
|
96
|
-
}
|
|
97
|
-
export async function prepareArtifactArguments(process, request) {
|
|
98
|
-
try {
|
|
99
|
-
return {
|
|
100
|
-
preparedArgs: await prepareAgentBrowserArgs(request.args, request.stdin, process.cwd),
|
|
101
|
-
};
|
|
102
|
-
}
|
|
103
|
-
catch (error) {
|
|
104
|
-
process.signal?.throwIfAborted();
|
|
105
|
-
if (!(error instanceof Error) ||
|
|
106
|
-
!("syscall" in error) ||
|
|
107
|
-
error.syscall !== "mkdir" ||
|
|
108
|
-
!("path" in error) ||
|
|
109
|
-
typeof error.path !== "string") {
|
|
110
|
-
throw error;
|
|
111
|
-
}
|
|
112
|
-
return { earlyResult: artifactDirectoryFailure(error, error.path, request.redactedArgs) };
|
|
113
|
-
}
|
|
114
|
-
}
|