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
|
@@ -1,68 +0,0 @@
|
|
|
1
|
-
import { boundElectronProbeString } from "../../electron/cdp.js";
|
|
2
|
-
import { normalizeProcessError } from "../../process-errors.js";
|
|
3
|
-
import { extractStringResultField, runSessionCommandData } from "../browser-run/session-state.js";
|
|
4
|
-
import { ELECTRON_FOCUSED_ELEMENT_EVAL, extractElectronFocusedElement, extractElectronProbeTabs, summarizeElectronProbeSnapshot, getElectronProbeSummary, } from "./probe-data.js";
|
|
5
|
-
async function runElectronProbeCommandData(options) {
|
|
6
|
-
try {
|
|
7
|
-
return {
|
|
8
|
-
data: await runSessionCommandData({ ...options, pinNamespace: true, throwOnFailure: true }),
|
|
9
|
-
};
|
|
10
|
-
}
|
|
11
|
-
catch (error) {
|
|
12
|
-
return { error: normalizeProcessError(error).message };
|
|
13
|
-
}
|
|
14
|
-
}
|
|
15
|
-
function probeCommandError(result, label) {
|
|
16
|
-
return result.error !== undefined && result.error.length > 0
|
|
17
|
-
? `${label}: ${result.error}`
|
|
18
|
-
: undefined;
|
|
19
|
-
}
|
|
20
|
-
export async function collectElectronProbe(options) {
|
|
21
|
-
// Each read completes before the next: native session commands share a pending
|
|
22
|
-
// slot, and the final snapshot owns the refs published by this probe.
|
|
23
|
-
const urlResult = await runElectronProbeCommandData({ ...options, args: ["get", "url"] });
|
|
24
|
-
const urlError = probeCommandError(urlResult, "get url");
|
|
25
|
-
if (urlError !== undefined) {
|
|
26
|
-
throw new Error(urlError);
|
|
27
|
-
}
|
|
28
|
-
const url = extractStringResultField(urlResult.data, "result") ??
|
|
29
|
-
extractStringResultField(urlResult.data, "url");
|
|
30
|
-
if (url === undefined || url.trim().length === 0) {
|
|
31
|
-
throw new Error("get url returned no active page URL.");
|
|
32
|
-
}
|
|
33
|
-
const titleResult = await runElectronProbeCommandData({ ...options, args: ["get", "title"] });
|
|
34
|
-
const focusedResult = await runElectronProbeCommandData({
|
|
35
|
-
...options,
|
|
36
|
-
args: ["eval", "--stdin"],
|
|
37
|
-
stdin: ELECTRON_FOCUSED_ELEMENT_EVAL,
|
|
38
|
-
});
|
|
39
|
-
const tabsResult = await runElectronProbeCommandData({ ...options, args: ["tab", "list"] });
|
|
40
|
-
const snapshotResult = await runElectronProbeCommandData({
|
|
41
|
-
...options,
|
|
42
|
-
args: ["snapshot", "-i"],
|
|
43
|
-
});
|
|
44
|
-
const errors = [
|
|
45
|
-
probeCommandError(titleResult, "get title"),
|
|
46
|
-
probeCommandError(focusedResult, "focused element"),
|
|
47
|
-
probeCommandError(tabsResult, "tab list"),
|
|
48
|
-
probeCommandError(snapshotResult, "snapshot"),
|
|
49
|
-
]
|
|
50
|
-
.filter((item) => item !== undefined)
|
|
51
|
-
.map((error) => boundElectronProbeString(error, 240) ?? "probe command failed");
|
|
52
|
-
const { activeTab, tabs } = extractElectronProbeTabs(tabsResult.data);
|
|
53
|
-
const { refSnapshot, snapshot } = summarizeElectronProbeSnapshot(snapshotResult.data);
|
|
54
|
-
const probe = {
|
|
55
|
-
activeTab,
|
|
56
|
-
focusedElement: extractElectronFocusedElement(focusedResult.data),
|
|
57
|
-
errors: errors.length > 0 ? errors : undefined,
|
|
58
|
-
refSnapshot,
|
|
59
|
-
sessionName: options.sessionName,
|
|
60
|
-
snapshot,
|
|
61
|
-
status: errors.length === 0 ? "succeeded" : "partial",
|
|
62
|
-
tabs,
|
|
63
|
-
title: boundElectronProbeString(extractStringResultField(titleResult.data, "result") ??
|
|
64
|
-
extractStringResultField(titleResult.data, "title"), 160),
|
|
65
|
-
url,
|
|
66
|
-
};
|
|
67
|
-
return { ...probe, summary: getElectronProbeSummary(probe) };
|
|
68
|
-
}
|
|
@@ -1,169 +0,0 @@
|
|
|
1
|
-
import { boundElectronProbeString } from "../../electron/cdp.js";
|
|
2
|
-
import { isRecord } from "../../parsing.js";
|
|
3
|
-
import { extractRefSnapshotFromData } from "../../session-page-state.js";
|
|
4
|
-
export const ELECTRON_FOCUSED_ELEMENT_EVAL = `(() => {
|
|
5
|
-
const clean = (value, max = 80) => {
|
|
6
|
-
if (typeof value !== "string") return undefined;
|
|
7
|
-
const normalized = value.replace(/\\s+/g, " ").trim();
|
|
8
|
-
if (!normalized) return undefined;
|
|
9
|
-
return normalized.length > max ? normalized.slice(0, max - 3) + "..." : normalized;
|
|
10
|
-
};
|
|
11
|
-
const describeElement = (element) => {
|
|
12
|
-
if (!element || !(element instanceof Element)) return undefined;
|
|
13
|
-
const tagName = element.tagName.toLowerCase();
|
|
14
|
-
const inputLike = element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement || element instanceof HTMLSelectElement;
|
|
15
|
-
const contentEditable = element instanceof HTMLElement && element.isContentEditable;
|
|
16
|
-
const containerLike = tagName === "body" || tagName === "html";
|
|
17
|
-
const rawText = element.textContent || "";
|
|
18
|
-
const exposeText = !inputLike && !contentEditable && !containerLike;
|
|
19
|
-
const text = exposeText ? clean(rawText) : undefined;
|
|
20
|
-
return {
|
|
21
|
-
tagName: clean(tagName, 40),
|
|
22
|
-
role: clean(element.getAttribute("role") || "", 60),
|
|
23
|
-
name: clean(element.getAttribute("aria-label") || element.getAttribute("title") || text || "", 80),
|
|
24
|
-
id: clean(element.id || "", 80),
|
|
25
|
-
type: clean(element.getAttribute("type") || "", 40),
|
|
26
|
-
placeholder: clean(element.getAttribute("placeholder") || "", 80),
|
|
27
|
-
ariaLabel: clean(element.getAttribute("aria-label") || "", 80),
|
|
28
|
-
title: clean(element.getAttribute("title") || "", 80),
|
|
29
|
-
textLength: !exposeText && rawText ? rawText.length : undefined,
|
|
30
|
-
textPreview: text,
|
|
31
|
-
valueLength: inputLike && typeof element.value === "string" ? element.value.length : undefined,
|
|
32
|
-
isContentEditable: contentEditable || undefined,
|
|
33
|
-
};
|
|
34
|
-
};
|
|
35
|
-
return { focusedElement: describeElement(document.activeElement) };
|
|
36
|
-
})()`;
|
|
37
|
-
const ELECTRON_PROBE_MAX_TABS = 6;
|
|
38
|
-
const ELECTRON_PROBE_MAX_REF_IDS = 20;
|
|
39
|
-
const ELECTRON_PROBE_MAX_SNAPSHOT_LINES = 12;
|
|
40
|
-
const ELECTRON_PROBE_MAX_SNAPSHOT_CHARS = 1_600;
|
|
41
|
-
function getTrimmedString(value) {
|
|
42
|
-
return typeof value === "string" ? boundElectronProbeString(value) : undefined;
|
|
43
|
-
}
|
|
44
|
-
function getOptionalBoolean(value) {
|
|
45
|
-
return typeof value === "boolean" ? value : undefined;
|
|
46
|
-
}
|
|
47
|
-
function getOptionalNumber(value) {
|
|
48
|
-
return typeof value === "number" && Number.isFinite(value) ? value : undefined;
|
|
49
|
-
}
|
|
50
|
-
function focusedElementPayload(data) {
|
|
51
|
-
const payload = isRecord(data) && isRecord(data.result) ? data.result : data;
|
|
52
|
-
if (!isRecord(payload)) {
|
|
53
|
-
return;
|
|
54
|
-
}
|
|
55
|
-
return isRecord(payload.focusedElement) ? payload.focusedElement : payload;
|
|
56
|
-
}
|
|
57
|
-
export function extractElectronFocusedElement(data) {
|
|
58
|
-
const raw = focusedElementPayload(data);
|
|
59
|
-
if (!raw) {
|
|
60
|
-
return;
|
|
61
|
-
}
|
|
62
|
-
const focusedElement = {
|
|
63
|
-
ariaLabel: getTrimmedString(raw.ariaLabel),
|
|
64
|
-
id: getTrimmedString(raw.id),
|
|
65
|
-
isContentEditable: getOptionalBoolean(raw.isContentEditable),
|
|
66
|
-
name: getTrimmedString(raw.name),
|
|
67
|
-
placeholder: getTrimmedString(raw.placeholder),
|
|
68
|
-
role: getTrimmedString(raw.role),
|
|
69
|
-
tagName: getTrimmedString(raw.tagName),
|
|
70
|
-
textLength: getOptionalNumber(raw.textLength),
|
|
71
|
-
textPreview: getTrimmedString(raw.textPreview),
|
|
72
|
-
title: getTrimmedString(raw.title),
|
|
73
|
-
type: getTrimmedString(raw.type),
|
|
74
|
-
valueLength: getOptionalNumber(raw.valueLength),
|
|
75
|
-
};
|
|
76
|
-
return Object.values(focusedElement).some((value) => value !== undefined)
|
|
77
|
-
? focusedElement
|
|
78
|
-
: undefined;
|
|
79
|
-
}
|
|
80
|
-
function rawProbeTabs(data) {
|
|
81
|
-
if (isRecord(data) && Array.isArray(data.tabs)) {
|
|
82
|
-
return data.tabs;
|
|
83
|
-
}
|
|
84
|
-
return Array.isArray(data) ? data : [];
|
|
85
|
-
}
|
|
86
|
-
export function extractElectronProbeTabs(data) {
|
|
87
|
-
const allTabs = rawProbeTabs(data)
|
|
88
|
-
.filter(isRecord)
|
|
89
|
-
.map((tab, index) => ({
|
|
90
|
-
active: getOptionalBoolean(tab.active),
|
|
91
|
-
index: typeof tab.index === "number" && Number.isInteger(tab.index) ? tab.index : index,
|
|
92
|
-
tabId: getTrimmedString(tab.tabId) ?? getTrimmedString(tab.id),
|
|
93
|
-
title: getTrimmedString(tab.title) ?? getTrimmedString(tab.label),
|
|
94
|
-
type: getTrimmedString(tab.type),
|
|
95
|
-
url: typeof tab.url === "string" ? tab.url : undefined,
|
|
96
|
-
}));
|
|
97
|
-
if (allTabs.length === 0) {
|
|
98
|
-
return {};
|
|
99
|
-
}
|
|
100
|
-
const shown = allTabs.slice(0, ELECTRON_PROBE_MAX_TABS);
|
|
101
|
-
return {
|
|
102
|
-
activeTab: allTabs.find((tab) => tab.active === true) ?? allTabs[0],
|
|
103
|
-
tabs: {
|
|
104
|
-
omittedCount: allTabs.length > shown.length ? allTabs.length - shown.length : undefined,
|
|
105
|
-
shown,
|
|
106
|
-
total: allTabs.length,
|
|
107
|
-
},
|
|
108
|
-
};
|
|
109
|
-
}
|
|
110
|
-
function truncateElectronProbeSnapshotText(snapshotText) {
|
|
111
|
-
if (snapshotText === undefined || snapshotText.length === 0) {
|
|
112
|
-
return { lineCount: 0 };
|
|
113
|
-
}
|
|
114
|
-
const lines = snapshotText.split(/\r?\n/);
|
|
115
|
-
const shownLines = [];
|
|
116
|
-
let usedChars = 0;
|
|
117
|
-
for (const line of lines) {
|
|
118
|
-
if (shownLines.length >= ELECTRON_PROBE_MAX_SNAPSHOT_LINES) {
|
|
119
|
-
break;
|
|
120
|
-
}
|
|
121
|
-
const nextLength = usedChars + line.length + (shownLines.length > 0 ? 1 : 0);
|
|
122
|
-
if (nextLength > ELECTRON_PROBE_MAX_SNAPSHOT_CHARS) {
|
|
123
|
-
if (shownLines.length === 0) {
|
|
124
|
-
shownLines.push(`${line.slice(0, ELECTRON_PROBE_MAX_SNAPSHOT_CHARS - 3)}...`);
|
|
125
|
-
}
|
|
126
|
-
break;
|
|
127
|
-
}
|
|
128
|
-
shownLines.push(line);
|
|
129
|
-
usedChars = nextLength;
|
|
130
|
-
}
|
|
131
|
-
return {
|
|
132
|
-
lineCount: lines.length,
|
|
133
|
-
omittedLineCount: lines.length > shownLines.length ? lines.length - shownLines.length : undefined,
|
|
134
|
-
text: shownLines.length > 0 ? shownLines.join("\n") : undefined,
|
|
135
|
-
};
|
|
136
|
-
}
|
|
137
|
-
export function summarizeElectronProbeSnapshot(data) {
|
|
138
|
-
const refSnapshot = extractRefSnapshotFromData(data);
|
|
139
|
-
const rawSnapshotText = isRecord(data) ? getTrimmedString(data.snapshot) : undefined;
|
|
140
|
-
const truncated = truncateElectronProbeSnapshotText(rawSnapshotText);
|
|
141
|
-
const refIds = refSnapshot?.refIds ?? [];
|
|
142
|
-
const shownRefIds = refIds.slice(0, ELECTRON_PROBE_MAX_REF_IDS);
|
|
143
|
-
const hasSnapshot = refSnapshot !== undefined || (truncated.text !== undefined && truncated.text.length > 0);
|
|
144
|
-
const snapshot = hasSnapshot
|
|
145
|
-
? {
|
|
146
|
-
lineCount: truncated.lineCount,
|
|
147
|
-
omittedLineCount: truncated.omittedLineCount,
|
|
148
|
-
omittedRefCount: refIds.length > shownRefIds.length ? refIds.length - shownRefIds.length : undefined,
|
|
149
|
-
refCount: refIds.length,
|
|
150
|
-
refIds: shownRefIds,
|
|
151
|
-
text: truncated.text,
|
|
152
|
-
}
|
|
153
|
-
: undefined;
|
|
154
|
-
return { refSnapshot, snapshot };
|
|
155
|
-
}
|
|
156
|
-
export function getElectronProbeSummary(probe) {
|
|
157
|
-
const parts = [
|
|
158
|
-
probe.title !== undefined && probe.title.length > 0 ? `title "${probe.title}"` : undefined,
|
|
159
|
-
probe.url !== undefined && probe.url.length > 0
|
|
160
|
-
? `url ${boundElectronProbeString(probe.url, 300) ?? ""}`
|
|
161
|
-
: undefined,
|
|
162
|
-
probe.focusedElement ? "focused element" : undefined,
|
|
163
|
-
probe.tabs ? `${probe.tabs.total} tab(s)` : undefined,
|
|
164
|
-
probe.snapshot ? `${probe.snapshot.refCount} ref(s)` : undefined,
|
|
165
|
-
].filter((item) => item !== undefined);
|
|
166
|
-
return parts.length > 0
|
|
167
|
-
? `Electron probe collected ${parts.join(", ")}.`
|
|
168
|
-
: "Electron probe did not return current session state.";
|
|
169
|
-
}
|
|
@@ -1,182 +0,0 @@
|
|
|
1
|
-
import { boundElectronProbeString } from "../../electron/cdp.js";
|
|
2
|
-
import { buildAgentBrowserNextActions } from "../../results/action-recommendations.js";
|
|
3
|
-
import { buildAgentBrowserResultCategoryDetails } from "../../results/categories.js";
|
|
4
|
-
import { appendUniqueAgentBrowserNextActions } from "../../results/next-actions.js";
|
|
5
|
-
import { redactSensitiveText } from "../../runtime-redaction.js";
|
|
6
|
-
import { isAboutBlankUrl } from "../../session-page-state.js";
|
|
7
|
-
import { redactToolDetails } from "../browser-run/final-result.js";
|
|
8
|
-
import { buildElectronIdentifiers, buildElectronMismatchNextActions, formatElectronSessionMismatchText, getLiveElectronRendererTargets, } from "../browser-run/session-state.js";
|
|
9
|
-
function presentProbeTab(tab) {
|
|
10
|
-
return { ...tab, url: boundElectronProbeString(tab.url) };
|
|
11
|
-
}
|
|
12
|
-
function presentProbe(probe) {
|
|
13
|
-
return {
|
|
14
|
-
...probe,
|
|
15
|
-
activeTab: probe.activeTab ? presentProbeTab(probe.activeTab) : undefined,
|
|
16
|
-
tabs: probe.tabs ? { ...probe.tabs, shown: probe.tabs.shown.map(presentProbeTab) } : undefined,
|
|
17
|
-
url: boundElectronProbeString(probe.url, 300),
|
|
18
|
-
};
|
|
19
|
-
}
|
|
20
|
-
function presentStrings(values) {
|
|
21
|
-
return values.filter((value) => value !== undefined && value.length > 0);
|
|
22
|
-
}
|
|
23
|
-
function formatFocusedElementAttributes(element) {
|
|
24
|
-
return presentStrings([
|
|
25
|
-
element.id !== undefined && element.id.length > 0 ? `#${element.id}` : undefined,
|
|
26
|
-
element.type !== undefined && element.type.length > 0 ? `type=${element.type}` : undefined,
|
|
27
|
-
element.valueLength !== undefined ? `valueLength=${element.valueLength}` : undefined,
|
|
28
|
-
element.textLength !== undefined ? `textLength=${element.textLength}` : undefined,
|
|
29
|
-
]).join(", ");
|
|
30
|
-
}
|
|
31
|
-
function focusedElementLabel(element) {
|
|
32
|
-
return (element.name ?? element.textPreview ?? element.placeholder ?? element.ariaLabel ?? element.title);
|
|
33
|
-
}
|
|
34
|
-
function formatElectronProbeFocusedElement(element) {
|
|
35
|
-
if (!element) {
|
|
36
|
-
return;
|
|
37
|
-
}
|
|
38
|
-
const label = focusedElementLabel(element);
|
|
39
|
-
const descriptorText = presentStrings([element.role, element.tagName]).join("/");
|
|
40
|
-
const descriptor = descriptorText.length > 0 ? descriptorText : "element";
|
|
41
|
-
const suffix = formatFocusedElementAttributes(element);
|
|
42
|
-
return `Focused: ${descriptor}${label !== undefined && label.length > 0 ? ` "${label}"` : ""}${suffix.length > 0 ? ` (${suffix})` : ""}`;
|
|
43
|
-
}
|
|
44
|
-
function formatElectronProbeContextText(context) {
|
|
45
|
-
if (context.mode === "launchId") {
|
|
46
|
-
return `Probe context: wrapper launch ${context.launchId ?? "undefined"} session ${context.sessionName}.`;
|
|
47
|
-
}
|
|
48
|
-
if (context.note !== undefined && context.note.length > 0) {
|
|
49
|
-
return `Probe context: current managed session ${context.sessionName}; ${context.note}`;
|
|
50
|
-
}
|
|
51
|
-
if (context.launchId !== undefined && context.launchId.length > 0) {
|
|
52
|
-
return `Probe context: current managed session ${context.sessionName} maps to Electron launch ${context.launchId}.`;
|
|
53
|
-
}
|
|
54
|
-
return `Probe context: current managed session ${context.sessionName} only; pass electron.probe.launchId to compare wrapper-tracked launch status.`;
|
|
55
|
-
}
|
|
56
|
-
function formatElectronProbeLaunchStatusText(status, probe) {
|
|
57
|
-
if (!status) {
|
|
58
|
-
return;
|
|
59
|
-
}
|
|
60
|
-
let pidText = "";
|
|
61
|
-
if (status.pidAlive !== undefined) {
|
|
62
|
-
pidText = status.pidAlive ? ", pid alive" : ", pid dead";
|
|
63
|
-
}
|
|
64
|
-
const lines = [
|
|
65
|
-
`Launch status: ${status.portAlive ? "debug port alive" : "debug port dead"}${pidText}; ${status.targets.length} CDP target(s).`,
|
|
66
|
-
];
|
|
67
|
-
if (isAboutBlankUrl(probe.url) &&
|
|
68
|
-
(!status.portAlive ||
|
|
69
|
-
status.pidAlive === false ||
|
|
70
|
-
getLiveElectronRendererTargets(status.targets).length === 0)) {
|
|
71
|
-
lines.push("Electron lifecycle warning: the browser session is on about:blank and the wrapper launch has no live renderer target to reattach. Run electron.status, cleanup if dead, or relaunch the app.");
|
|
72
|
-
}
|
|
73
|
-
return lines.join("\n");
|
|
74
|
-
}
|
|
75
|
-
function formatProbeTabs(probe) {
|
|
76
|
-
if (!probe.tabs) {
|
|
77
|
-
return;
|
|
78
|
-
}
|
|
79
|
-
const omitted = (probe.tabs.omittedCount ?? 0) !== 0 ? ` (${probe.tabs.omittedCount ?? 0} omitted)` : "";
|
|
80
|
-
const active = probe.activeTab;
|
|
81
|
-
const activeText = active
|
|
82
|
-
? `; active ${active.index ?? "?"}: ${presentStrings([presentStrings([active.title, active.url]).join(" — "), active.tabId])[0] ?? "tab"}`
|
|
83
|
-
: "";
|
|
84
|
-
return `Tabs: ${probe.tabs.total} total${omitted}${activeText}`;
|
|
85
|
-
}
|
|
86
|
-
function formatProbeSnapshot(probe) {
|
|
87
|
-
const snapshot = probe.snapshot;
|
|
88
|
-
if (!snapshot) {
|
|
89
|
-
return [];
|
|
90
|
-
}
|
|
91
|
-
const omitted = (snapshot.omittedRefCount ?? 0) !== 0
|
|
92
|
-
? ` (${snapshot.omittedRefCount ?? 0} ref id(s) omitted)`
|
|
93
|
-
: "";
|
|
94
|
-
const lines = [`Snapshot: ${snapshot.refCount} interactive ref(s)${omitted}.`];
|
|
95
|
-
if (snapshot.text !== undefined && snapshot.text.length > 0) {
|
|
96
|
-
lines.push(snapshot.text);
|
|
97
|
-
}
|
|
98
|
-
if ((snapshot.omittedLineCount ?? 0) !== 0) {
|
|
99
|
-
lines.push(`... ${snapshot.omittedLineCount ?? 0} snapshot line(s) omitted`);
|
|
100
|
-
}
|
|
101
|
-
return lines;
|
|
102
|
-
}
|
|
103
|
-
function formatElectronProbeVisibleText(options) {
|
|
104
|
-
const probe = options.probe;
|
|
105
|
-
const page = presentStrings([probe.title, probe.url]).join(" — ");
|
|
106
|
-
const lines = [
|
|
107
|
-
`Electron probe: ${page.length > 0 ? page : probe.sessionName}`,
|
|
108
|
-
formatElectronProbeContextText(options.probeContext),
|
|
109
|
-
...presentStrings([
|
|
110
|
-
formatElectronProbeLaunchStatusText(options.status, probe),
|
|
111
|
-
options.mismatch ? formatElectronSessionMismatchText(options.mismatch) : undefined,
|
|
112
|
-
formatElectronProbeFocusedElement(probe.focusedElement),
|
|
113
|
-
formatProbeTabs(probe),
|
|
114
|
-
]),
|
|
115
|
-
...formatProbeSnapshot(probe),
|
|
116
|
-
];
|
|
117
|
-
if (probe.status === "partial") {
|
|
118
|
-
lines.push("Some probe commands did not return data; use raw agent_browser commands for deeper diagnostics.");
|
|
119
|
-
}
|
|
120
|
-
if (probe.errors && probe.errors.length > 0) {
|
|
121
|
-
lines.push(`Probe warning: ${probe.errors.slice(0, 2).join("; ")}${probe.errors.length > 2 ? "; ..." : ""}`);
|
|
122
|
-
}
|
|
123
|
-
return lines.join("\n");
|
|
124
|
-
}
|
|
125
|
-
function probeNextActions(options) {
|
|
126
|
-
const base = options.record
|
|
127
|
-
? (buildAgentBrowserNextActions({
|
|
128
|
-
electron: {
|
|
129
|
-
launchId: options.record.launchId,
|
|
130
|
-
sessionName: options.record.sessionName,
|
|
131
|
-
status: options.record.cleanupState,
|
|
132
|
-
},
|
|
133
|
-
resultCategory: "success",
|
|
134
|
-
successCategory: "completed",
|
|
135
|
-
}) ?? [])
|
|
136
|
-
: [];
|
|
137
|
-
const mismatch = options.mismatch && options.record
|
|
138
|
-
? buildElectronMismatchNextActions(options.record, options.mismatch.liveTarget)
|
|
139
|
-
: [];
|
|
140
|
-
return options.mismatch
|
|
141
|
-
? appendUniqueAgentBrowserNextActions([...mismatch], base)
|
|
142
|
-
: appendUniqueAgentBrowserNextActions([...base], mismatch);
|
|
143
|
-
}
|
|
144
|
-
export function buildElectronProbeResult(options) {
|
|
145
|
-
const probe = presentProbe(options.probe);
|
|
146
|
-
const { refSnapshot: _refSnapshot, ...boundedProbe } = probe;
|
|
147
|
-
const nextActions = probeNextActions(options);
|
|
148
|
-
const details = {
|
|
149
|
-
args: [],
|
|
150
|
-
compiledElectron: options.compiledElectron,
|
|
151
|
-
electron: {
|
|
152
|
-
action: "probe",
|
|
153
|
-
identifiers: options.record ? buildElectronIdentifiers(options.record) : undefined,
|
|
154
|
-
probe: boundedProbe,
|
|
155
|
-
probeContext: options.probeContext,
|
|
156
|
-
sessionMismatch: options.mismatch,
|
|
157
|
-
status: options.probe.status,
|
|
158
|
-
statusTargets: options.status?.targets,
|
|
159
|
-
launchStatus: options.status,
|
|
160
|
-
},
|
|
161
|
-
nextActions: nextActions.length > 0 ? nextActions : undefined,
|
|
162
|
-
...buildAgentBrowserResultCategoryDetails({ args: [], succeeded: true }),
|
|
163
|
-
managedSessionHeadedAutosaveDisabled: options.headedManagedAutosaveDisabled === true ? true : undefined,
|
|
164
|
-
managedSessionHeadedAutosaveInterval: options.headedManagedAutosaveInterval,
|
|
165
|
-
namespace: options.namespace,
|
|
166
|
-
refSnapshot: options.probe.refSnapshot,
|
|
167
|
-
sessionName: options.probe.sessionName,
|
|
168
|
-
sessionTabTarget: options.sessionTabTarget,
|
|
169
|
-
summary: options.mismatch?.summary ?? options.probe.summary,
|
|
170
|
-
usedImplicitSession: options.probeContext.mode === "current-managed-session",
|
|
171
|
-
};
|
|
172
|
-
return {
|
|
173
|
-
content: [
|
|
174
|
-
{
|
|
175
|
-
type: "text",
|
|
176
|
-
text: redactSensitiveText(formatElectronProbeVisibleText({ ...options, probe })),
|
|
177
|
-
},
|
|
178
|
-
],
|
|
179
|
-
details: redactToolDetails(details, []),
|
|
180
|
-
isError: false,
|
|
181
|
-
};
|
|
182
|
-
}
|
|
@@ -1,161 +0,0 @@
|
|
|
1
|
-
import { inspectElectronLaunchStatus } from "../../electron/cleanup.js";
|
|
2
|
-
import { getPageTargetValidationError } from "../../page-target-validation.js";
|
|
3
|
-
import { getAgentBrowserProcessEnvironment } from "../../process-environment.js";
|
|
4
|
-
import { normalizeProcessError } from "../../process-errors.js";
|
|
5
|
-
import { getSessionPageStateKey, normalizeSessionTabTarget, } from "../../session-page-state.js";
|
|
6
|
-
import { buildElectronHostFailureResult } from "../browser-run/final-result.js";
|
|
7
|
-
import { buildElectronSessionMismatch, findElectronLaunchRecordForSession, } from "../browser-run/session-state.js";
|
|
8
|
-
import { ElectronManagedSessionPolicyError, withOwnedElectronManagedSessionPolicy, } from "./policy.js";
|
|
9
|
-
import { collectElectronProbe } from "./probe-collection.js";
|
|
10
|
-
import { buildElectronProbeResult } from "./probe-presentation.js";
|
|
11
|
-
function resolveLaunchProbe(record, launchId) {
|
|
12
|
-
if (!record) {
|
|
13
|
-
return { error: `No wrapper-tracked Electron launch found for launchId ${launchId}.` };
|
|
14
|
-
}
|
|
15
|
-
if (record.sessionName === undefined || record.sessionName.length === 0) {
|
|
16
|
-
return {
|
|
17
|
-
error: `electron.probe launchId ${launchId} has no attached managed sessionName; reattach with connect or run electron.launch again.`,
|
|
18
|
-
};
|
|
19
|
-
}
|
|
20
|
-
return { record, namespace: record.namespace, sessionName: record.sessionName };
|
|
21
|
-
}
|
|
22
|
-
function resolveProbeIdentity(options, input) {
|
|
23
|
-
if (input.launchId !== undefined && input.launchId.length > 0) {
|
|
24
|
-
return resolveLaunchProbe(options.electronLaunchRecords.get(input.launchId), input.launchId);
|
|
25
|
-
}
|
|
26
|
-
const record = findElectronLaunchRecordForSession(options.managedSessionName, options.electronLaunchRecords, options.managedSessionNamespace);
|
|
27
|
-
if (!options.managedSessionActive) {
|
|
28
|
-
return {
|
|
29
|
-
error: "electron.probe requires an active attached session. Run electron.launch or connect to an Electron debug port first.",
|
|
30
|
-
};
|
|
31
|
-
}
|
|
32
|
-
if (options.managedSessionName.length === 0) {
|
|
33
|
-
return { error: "electron.probe could not resolve a managed session to inspect." };
|
|
34
|
-
}
|
|
35
|
-
return {
|
|
36
|
-
record,
|
|
37
|
-
namespace: options.managedSessionNamespace,
|
|
38
|
-
sessionName: options.managedSessionName,
|
|
39
|
-
};
|
|
40
|
-
}
|
|
41
|
-
function probeContext(identity, input, probe) {
|
|
42
|
-
const explicit = input.launchId !== undefined && input.launchId.length > 0;
|
|
43
|
-
let note;
|
|
44
|
-
if (!identity.record) {
|
|
45
|
-
note = "No wrapper-tracked Electron launch matched this current managed session.";
|
|
46
|
-
}
|
|
47
|
-
else if (!explicit &&
|
|
48
|
-
identity.record.sessionName !== undefined &&
|
|
49
|
-
identity.record.sessionName.length > 0 &&
|
|
50
|
-
identity.record.sessionName !== probe.sessionName) {
|
|
51
|
-
note = `single active Electron launch ${identity.record.launchId} uses wrapper session ${identity.record.sessionName}; pass electron.probe.launchId to inspect that launch session directly.`;
|
|
52
|
-
}
|
|
53
|
-
return {
|
|
54
|
-
launchId: identity.record?.launchId,
|
|
55
|
-
mode: explicit ? "launchId" : "current-managed-session",
|
|
56
|
-
note,
|
|
57
|
-
sessionName: probe.sessionName,
|
|
58
|
-
};
|
|
59
|
-
}
|
|
60
|
-
function probePageTarget(probe) {
|
|
61
|
-
const { title, url, activeTab, refSnapshot } = probe;
|
|
62
|
-
const snapshotTarget = refSnapshot?.target;
|
|
63
|
-
return normalizeSessionTabTarget({
|
|
64
|
-
title: title ?? activeTab?.title ?? snapshotTarget?.title,
|
|
65
|
-
url: url ?? activeTab?.url ?? snapshotTarget?.url,
|
|
66
|
-
});
|
|
67
|
-
}
|
|
68
|
-
function publishProbePageState(state, probe, namespace) {
|
|
69
|
-
const target = probePageTarget(probe);
|
|
70
|
-
const update = state.beginUpdate();
|
|
71
|
-
const key = getSessionPageStateKey(probe.sessionName, namespace) ?? probe.sessionName;
|
|
72
|
-
if (target) {
|
|
73
|
-
state.applyTabTarget({ sessionName: key, target, update });
|
|
74
|
-
}
|
|
75
|
-
if (probe.refSnapshot) {
|
|
76
|
-
state.applyRefSnapshot({
|
|
77
|
-
fallbackTarget: target,
|
|
78
|
-
sessionName: key,
|
|
79
|
-
snapshot: probe.refSnapshot,
|
|
80
|
-
update,
|
|
81
|
-
});
|
|
82
|
-
}
|
|
83
|
-
return target;
|
|
84
|
-
}
|
|
85
|
-
function resolveProbePolicy(options, identity, timeoutMs) {
|
|
86
|
-
const key = getSessionPageStateKey(identity.sessionName, identity.namespace) ?? identity.sessionName;
|
|
87
|
-
const pageState = options.sessionPageState.get(key);
|
|
88
|
-
const targetError = getPageTargetValidationError({
|
|
89
|
-
args: ["snapshot", "-i"],
|
|
90
|
-
currentPageUrl: pageState.tabTarget?.url,
|
|
91
|
-
pageUrlUnknown: pageState.tabTargetUnknown === true,
|
|
92
|
-
});
|
|
93
|
-
if (targetError !== undefined && targetError.length > 0) {
|
|
94
|
-
throw new ElectronManagedSessionPolicyError(targetError);
|
|
95
|
-
}
|
|
96
|
-
const owner = options.ownedManagedSessions.get(key);
|
|
97
|
-
return {
|
|
98
|
-
cwd: options.cwd,
|
|
99
|
-
namespace: identity.namespace,
|
|
100
|
-
sessionName: identity.sessionName,
|
|
101
|
-
signal: options.signal,
|
|
102
|
-
timeoutMs,
|
|
103
|
-
confirmActions: pageState.confirmActions ?? getAgentBrowserProcessEnvironment().AGENT_BROWSER_CONFIRM_ACTIONS,
|
|
104
|
-
electronLaunchRecord: identity.record,
|
|
105
|
-
headedManagedAutosaveDisabled: owner?.headedManagedAutosaveDisabled === true,
|
|
106
|
-
headedManagedAutosaveInterval: owner?.headedManagedAutosaveInterval,
|
|
107
|
-
restoreState: options.managedSessionRestoreState,
|
|
108
|
-
};
|
|
109
|
-
}
|
|
110
|
-
async function inspectProbeIdentity(options, identity, input, visibleInput) {
|
|
111
|
-
const status = identity.record ? await inspectElectronLaunchStatus(identity.record) : undefined;
|
|
112
|
-
const policy = resolveProbePolicy(options, identity, input.timeoutMs);
|
|
113
|
-
const probe = await withOwnedElectronManagedSessionPolicy({ ...policy, args: ["snapshot", "-i"] }, () => collectElectronProbe(policy));
|
|
114
|
-
const managedSession = {
|
|
115
|
-
sessionName: probe.sessionName,
|
|
116
|
-
title: probe.title ?? probe.activeTab?.title,
|
|
117
|
-
url: probe.url ?? probe.activeTab?.url,
|
|
118
|
-
};
|
|
119
|
-
const mismatch = identity.record && status
|
|
120
|
-
? buildElectronSessionMismatch({
|
|
121
|
-
managedSession,
|
|
122
|
-
record: identity.record,
|
|
123
|
-
statusTargets: status.targets,
|
|
124
|
-
})
|
|
125
|
-
: undefined;
|
|
126
|
-
const context = probeContext(identity, input, probe);
|
|
127
|
-
const target = publishProbePageState(options.sessionPageState, probe, identity.namespace);
|
|
128
|
-
return buildElectronProbeResult({
|
|
129
|
-
compiledElectron: visibleInput,
|
|
130
|
-
headedManagedAutosaveDisabled: policy.headedManagedAutosaveDisabled,
|
|
131
|
-
headedManagedAutosaveInterval: policy.headedManagedAutosaveInterval,
|
|
132
|
-
mismatch,
|
|
133
|
-
namespace: identity.namespace,
|
|
134
|
-
probe,
|
|
135
|
-
probeContext: context,
|
|
136
|
-
record: identity.record,
|
|
137
|
-
sessionTabTarget: target,
|
|
138
|
-
status,
|
|
139
|
-
});
|
|
140
|
-
}
|
|
141
|
-
export async function probeElectronHost(options, compiledElectron, visibleInput) {
|
|
142
|
-
const identity = resolveProbeIdentity(options, compiledElectron);
|
|
143
|
-
if ("error" in identity) {
|
|
144
|
-
return buildElectronHostFailureResult({
|
|
145
|
-
compiledElectron: visibleInput,
|
|
146
|
-
errorText: identity.error,
|
|
147
|
-
failureCategory: "validation-error",
|
|
148
|
-
});
|
|
149
|
-
}
|
|
150
|
-
try {
|
|
151
|
-
return await inspectProbeIdentity(options, identity, compiledElectron, visibleInput);
|
|
152
|
-
}
|
|
153
|
-
catch (error) {
|
|
154
|
-
const errorText = normalizeProcessError(error).message;
|
|
155
|
-
return buildElectronHostFailureResult({
|
|
156
|
-
compiledElectron: visibleInput,
|
|
157
|
-
errorText: `Electron probe failed: ${errorText}`,
|
|
158
|
-
failureCategory: error instanceof ElectronManagedSessionPolicyError ? "validation-error" : "upstream-error",
|
|
159
|
-
});
|
|
160
|
-
}
|
|
161
|
-
}
|