pi-agent-browser-native 0.9.3 → 0.9.4
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 +77 -5
- package/README.md +103 -81
- package/dist/extensions/agent-browser/index.js +43057 -2031
- package/dist/extensions/agent-browser/lib/argv-descriptor.js +49 -26
- package/dist/extensions/agent-browser/lib/argv-grammar.js +82 -93
- package/dist/extensions/agent-browser/lib/bash-guard.js +129 -126
- package/dist/extensions/agent-browser/lib/batch-lifecycle.js +112 -51
- package/dist/extensions/agent-browser/lib/browser-execution-claim-codec.js +61 -0
- package/dist/extensions/agent-browser/lib/browser-execution-claim-storage.js +232 -0
- package/dist/extensions/agent-browser/lib/browser-execution-claims.js +202 -0
- package/dist/extensions/agent-browser/lib/browser-execution-identity.js +77 -0
- package/dist/extensions/agent-browser/lib/browser-journal-branch.js +98 -0
- package/dist/extensions/agent-browser/lib/browser-journal-contracts.js +1 -0
- package/dist/extensions/agent-browser/lib/browser-journal-projection.js +221 -0
- package/dist/extensions/agent-browser/lib/browser-journal-reader.js +89 -0
- package/dist/extensions/agent-browser/lib/browser-journal-replay.js +246 -0
- package/dist/extensions/agent-browser/lib/browser-journal.js +103 -394
- package/dist/extensions/agent-browser/lib/browser-legacy-pages.js +220 -0
- package/dist/extensions/agent-browser/lib/browser-legacy-projection.js +282 -0
- package/dist/extensions/agent-browser/lib/browser-legacy-types.js +1 -0
- package/dist/extensions/agent-browser/lib/browser-session-conversion-stream.js +217 -0
- package/dist/extensions/agent-browser/lib/browser-session-conversion.js +80 -335
- package/dist/extensions/agent-browser/lib/browser-transcript-contracts.js +35 -0
- package/dist/extensions/agent-browser/lib/browser-transcript-validation.js +166 -0
- package/dist/extensions/agent-browser/lib/browser-transcript.js +137 -82
- package/dist/extensions/agent-browser/lib/browser-value-parsing.js +15 -0
- package/dist/extensions/agent-browser/lib/command-capabilities.js +340 -0
- package/dist/extensions/agent-browser/lib/command-policy.js +107 -88
- package/dist/extensions/agent-browser/lib/command-taxonomy.js +49 -322
- package/dist/extensions/agent-browser/lib/config-policy.js +138 -343
- package/dist/extensions/agent-browser/lib/config-providers.js +71 -0
- package/dist/extensions/agent-browser/lib/config-validation.js +218 -0
- package/dist/extensions/agent-browser/lib/config.js +19 -7
- package/dist/extensions/agent-browser/lib/electron/cdp.js +15 -7
- package/dist/extensions/agent-browser/lib/electron/cleanup.js +134 -55
- package/dist/extensions/agent-browser/lib/electron/discovery-darwin.js +109 -0
- package/dist/extensions/agent-browser/lib/electron/discovery-desktop.js +136 -0
- package/dist/extensions/agent-browser/lib/electron/discovery-evidence.js +89 -0
- package/dist/extensions/agent-browser/lib/electron/discovery-linux.js +93 -0
- package/dist/extensions/agent-browser/lib/electron/discovery-packages.js +162 -0
- package/dist/extensions/agent-browser/lib/electron/discovery-types.js +2 -0
- package/dist/extensions/agent-browser/lib/electron/discovery.js +140 -549
- package/dist/extensions/agent-browser/lib/electron/launch-monitor.js +102 -0
- package/dist/extensions/agent-browser/lib/electron/launch-process.js +209 -0
- package/dist/extensions/agent-browser/lib/electron/launch-types.js +2 -0
- package/dist/extensions/agent-browser/lib/electron/launch.js +249 -354
- package/dist/extensions/agent-browser/lib/executable-path.js +21 -12
- package/dist/extensions/agent-browser/lib/execution-cwd.js +35 -18
- package/dist/extensions/agent-browser/lib/input-modes/electron.js +162 -121
- package/dist/extensions/agent-browser/lib/input-modes/job.js +116 -313
- package/dist/extensions/agent-browser/lib/input-modes/lookup-network-evidence.js +104 -0
- package/dist/extensions/agent-browser/lib/input-modes/lookup-plan.js +132 -0
- package/dist/extensions/agent-browser/lib/input-modes/lookup-redaction.js +57 -0
- package/dist/extensions/agent-browser/lib/input-modes/lookup-source-evidence.js +151 -0
- package/dist/extensions/agent-browser/lib/input-modes/lookup-workspace.js +142 -0
- package/dist/extensions/agent-browser/lib/input-modes/lookups.js +57 -412
- package/dist/extensions/agent-browser/lib/input-modes/params.js +63 -17
- package/dist/extensions/agent-browser/lib/input-modes/qa-analysis.js +268 -0
- package/dist/extensions/agent-browser/lib/input-modes/qa-presentation.js +117 -0
- package/dist/extensions/agent-browser/lib/input-modes/script-child.js +396 -0
- package/dist/extensions/agent-browser/lib/input-modes/script-protocol.js +86 -0
- package/dist/extensions/agent-browser/lib/input-modes/script-types.js +1 -0
- package/dist/extensions/agent-browser/lib/input-modes/script-validation.js +60 -0
- package/dist/extensions/agent-browser/lib/input-modes/script.js +60 -409
- package/dist/extensions/agent-browser/lib/input-modes/semantic-action.js +218 -128
- package/dist/extensions/agent-browser/lib/input-modes/shared.js +15 -4
- package/dist/extensions/agent-browser/lib/input-modes/types.js +56 -7
- package/dist/extensions/agent-browser/lib/json-schema.js +22 -10
- package/dist/extensions/agent-browser/lib/launch-scoped-flags.js +17 -5
- package/dist/extensions/agent-browser/lib/managed-session-policy-lock.js +92 -425
- package/dist/extensions/agent-browser/lib/managed-session-posix-storage.js +58 -0
- package/dist/extensions/agent-browser/lib/managed-session-project-identity.js +244 -0
- package/dist/extensions/agent-browser/lib/managed-session-restore-context.js +84 -0
- package/dist/extensions/agent-browser/lib/managed-session-restore-policy.js +119 -0
- package/dist/extensions/agent-browser/lib/managed-session-restore-state.js +83 -0
- package/dist/extensions/agent-browser/lib/managed-session-restore.js +168 -300
- package/dist/extensions/agent-browser/lib/managed-session-snapshot-records.js +277 -0
- package/dist/extensions/agent-browser/lib/managed-session-snapshots.js +128 -305
- package/dist/extensions/agent-browser/lib/managed-session-storage.js +56 -253
- package/dist/extensions/agent-browser/lib/native-confirmation.js +140 -0
- package/dist/extensions/agent-browser/lib/native-output.js +43 -9
- package/dist/extensions/agent-browser/lib/orchestration/batch-stdin.js +106 -59
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/artifact-merge.js +14 -6
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/artifact-paths.js +109 -57
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/browser-observation-result.js +82 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/click-dispatch.js +164 -60
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/diagnostic-values.js +31 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/diagnostics.js +152 -781
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/electron-observation.js +202 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/electron-text-diagnostics.js +109 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/fill-diagnostics.js +119 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-action-recovery.js +147 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-actions.js +144 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-content.js +123 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-contracts.js +1 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-details.js +156 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-electron.js +179 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-evidence.js +39 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-missing-binary.js +89 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-recovery.js +97 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-redaction.js +106 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result-timeout.js +110 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/final-result.js +41 -538
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/index.js +199 -154
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/interaction-diagnostics.js +290 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/managed-session-close.js +167 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/managed-session-daemon-inspection.js +108 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/managed-session-daemon-policy.js +127 -205
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/native-helper-observation.js +65 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/observation-types.js +1 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/overlay-diagnostics.js +120 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/network-page-filter.js +113 -30
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/scroll-shims.js +109 -28
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/snapshot-filter-data.js +150 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/snapshot-filter.js +138 -253
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/snapshot-rendered-text.js +147 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare/wait-timeouts.js +59 -24
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-artifacts.js +159 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-command.js +131 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-contracts.js +1 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-daemon.js +93 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-failure.js +42 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-guards.js +242 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-input.js +75 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-observations.js +92 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-page-selection.js +254 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-page-state.js +121 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-refs.js +130 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-resources.js +114 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-semantic.js +121 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-session-plan.js +222 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare-timeouts.js +68 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prepare.js +176 -1123
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-analysis.js +191 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-confirmation.js +152 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-diagnostics.js +182 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-electron.js +150 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-lifecycle-contracts.js +1 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-lifecycle-phase-contracts.js +1 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-lifecycle-phase.js +115 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-lifecycle.js +256 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-managed-contracts.js +1 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-managed.js +256 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-native-phase-contracts.js +1 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-native-phase.js +93 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-native.js +113 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-navigation-contracts.js +1 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-navigation.js +316 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-ownership.js +28 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-page-phase-contracts.js +1 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-page-phase.js +142 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-presentation-contracts.js +1 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-presentation.js +333 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-publication-phase-contracts.js +1 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-publication-phase.js +71 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-publication.js +201 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-receipts.js +183 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-refs.js +200 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output-tabs.js +142 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/process-output.js +18 -968
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/prompt-guards.js +23 -13
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/recording-receipt-reconciliation.js +198 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/recording-recovery-contracts.js +1 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/recording-recovery-presentation.js +154 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/recording-recovery.js +68 -151
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/screenshot-capture.js +14 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/screenshot-observation.js +169 -46
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-commands.js +130 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-electron.js +210 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-observations.js +61 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-outcomes.js +187 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-refs.js +171 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state-tabs.js +228 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/session-state.js +77 -765
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/text-visibility-diagnostics.js +182 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/timeout-diagnostics.js +256 -0
- package/dist/extensions/agent-browser/lib/orchestration/browser-run/timeout-progress.js +108 -0
- package/dist/extensions/agent-browser/lib/orchestration/code-artifact-observation.js +39 -0
- package/dist/extensions/agent-browser/lib/orchestration/code-image-observation.js +119 -0
- package/dist/extensions/agent-browser/lib/orchestration/electron-host/branch.js +92 -0
- package/dist/extensions/agent-browser/lib/orchestration/electron-host/cleanup-result.js +58 -0
- package/dist/extensions/agent-browser/lib/orchestration/electron-host/cleanup.js +78 -0
- package/dist/extensions/agent-browser/lib/orchestration/electron-host/contracts.js +1 -0
- package/dist/extensions/agent-browser/lib/orchestration/electron-host/discovery.js +106 -0
- package/dist/extensions/agent-browser/lib/orchestration/electron-host/index.js +48 -821
- package/dist/extensions/agent-browser/lib/orchestration/electron-host/policy.js +86 -0
- package/dist/extensions/agent-browser/lib/orchestration/electron-host/probe-collection.js +69 -0
- package/dist/extensions/agent-browser/lib/orchestration/electron-host/probe-data.js +167 -0
- package/dist/extensions/agent-browser/lib/orchestration/electron-host/probe-presentation.js +164 -0
- package/dist/extensions/agent-browser/lib/orchestration/electron-host/probe.js +161 -0
- package/dist/extensions/agent-browser/lib/orchestration/electron-host/status.js +165 -0
- package/dist/extensions/agent-browser/lib/orchestration/execution-queue.js +21 -9
- package/dist/extensions/agent-browser/lib/orchestration/extension-artifact-preflight.js +211 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-artifacts.js +23 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-attachment-replay.js +99 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-branch-restore.js +275 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-code.js +280 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-command-admission.js +303 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-command-output.js +36 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-command-result.js +335 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-command-run.js +227 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-command-state.js +1 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-electron-ownership.js +204 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-execution-locks.js +139 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-execution-queue.js +24 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-host-coordination.js +98 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-host-run.js +295 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-intent-replay.js +41 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-invocation.js +7 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-lifecycle.js +102 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-managed-ownership.js +133 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-observation.js +120 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-prompt.js +180 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-recording.js +290 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-resource-contracts.js +1 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-resource-replay.js +269 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-result-state.js +113 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-runtime.js +146 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-script-leases.js +58 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-tool-boundary.js +62 -0
- package/dist/extensions/agent-browser/lib/orchestration/extension-version-check.js +54 -0
- package/dist/extensions/agent-browser/lib/orchestration/input-plan-types.js +1 -0
- package/dist/extensions/agent-browser/lib/orchestration/input-plan.js +261 -185
- package/dist/extensions/agent-browser/lib/orchestration/input-redaction.js +62 -0
- package/dist/extensions/agent-browser/lib/orchestration/native-config.js +144 -0
- package/dist/extensions/agent-browser/lib/orchestration/native-root-launch.js +77 -0
- package/dist/extensions/agent-browser/lib/orchestration/native-session-defaults.js +210 -157
- package/dist/extensions/agent-browser/lib/orchestration/operation-paths.js +124 -58
- package/dist/extensions/agent-browser/lib/orchestration/output-file.js +197 -99
- package/dist/extensions/agent-browser/lib/orchestration/script-mode.js +199 -96
- package/dist/extensions/agent-browser/lib/owned-managed-session-context.js +55 -0
- package/dist/extensions/agent-browser/lib/page-target-batch.js +118 -0
- package/dist/extensions/agent-browser/lib/page-target-guards.js +50 -0
- package/dist/extensions/agent-browser/lib/page-target-navigation.js +104 -0
- package/dist/extensions/agent-browser/lib/page-target-validation.js +55 -246
- package/dist/extensions/agent-browser/lib/parsing.js +13 -4
- package/dist/extensions/agent-browser/lib/pi-tool-rendering.js +133 -68
- package/dist/extensions/agent-browser/lib/playbook.js +16 -12
- package/dist/extensions/agent-browser/lib/process-child.js +284 -0
- package/dist/extensions/agent-browser/lib/process-environment.js +13 -6
- package/dist/extensions/agent-browser/lib/process-errors.js +23 -0
- package/dist/extensions/agent-browser/lib/process-identity.js +47 -15
- package/dist/extensions/agent-browser/lib/process-socket-storage.js +256 -0
- package/dist/extensions/agent-browser/lib/process-stdout.js +74 -0
- package/dist/extensions/agent-browser/lib/process.js +145 -536
- package/dist/extensions/agent-browser/lib/prompt-artifacts.js +287 -0
- package/dist/extensions/agent-browser/lib/prompt-policy.js +15 -194
- package/dist/extensions/agent-browser/lib/read-command.js +41 -0
- package/dist/extensions/agent-browser/lib/read-confirmation.js +131 -68
- package/dist/extensions/agent-browser/lib/recording-reservations.js +118 -45
- package/dist/extensions/agent-browser/lib/redaction-fields.js +75 -0
- package/dist/extensions/agent-browser/lib/redaction-json.js +149 -0
- package/dist/extensions/agent-browser/lib/redaction-url.js +88 -0
- package/dist/extensions/agent-browser/lib/results/action-contracts.js +1 -0
- package/dist/extensions/agent-browser/lib/results/action-recommendations.js +28 -271
- package/dist/extensions/agent-browser/lib/results/artifact-contracts.js +1 -0
- package/dist/extensions/agent-browser/lib/results/artifact-manifest-validation.js +133 -0
- package/dist/extensions/agent-browser/lib/results/artifact-manifest.js +96 -94
- package/dist/extensions/agent-browser/lib/results/artifact-recommendations.js +73 -0
- package/dist/extensions/agent-browser/lib/results/categories.js +111 -54
- package/dist/extensions/agent-browser/lib/results/confirmation.js +29 -13
- package/dist/extensions/agent-browser/lib/results/editable-ref-evidence.js +62 -27
- package/dist/extensions/agent-browser/lib/results/electron-recommendations.js +83 -0
- package/dist/extensions/agent-browser/lib/results/envelope-decoding.js +48 -0
- package/dist/extensions/agent-browser/lib/results/envelope.js +90 -67
- package/dist/extensions/agent-browser/lib/results/evidence-contracts.js +1 -0
- package/dist/extensions/agent-browser/lib/results/failure-recommendations.js +180 -0
- package/dist/extensions/agent-browser/lib/results/network-routes.js +86 -45
- package/dist/extensions/agent-browser/lib/results/network.js +35 -12
- package/dist/extensions/agent-browser/lib/results/next-actions.js +49 -19
- package/dist/extensions/agent-browser/lib/results/presentation/artifact-files.js +320 -0
- package/dist/extensions/agent-browser/lib/results/presentation/artifact-format.js +138 -0
- package/dist/extensions/agent-browser/lib/results/presentation/artifact-images.js +113 -0
- package/dist/extensions/agent-browser/lib/results/presentation/artifact-verification.js +145 -0
- package/dist/extensions/agent-browser/lib/results/presentation/artifacts.js +99 -555
- package/dist/extensions/agent-browser/lib/results/presentation/batch-contracts.js +1 -0
- package/dist/extensions/agent-browser/lib/results/presentation/batch-recording.js +118 -0
- package/dist/extensions/agent-browser/lib/results/presentation/batch-redaction.js +68 -0
- package/dist/extensions/agent-browser/lib/results/presentation/batch-rendering.js +135 -0
- package/dist/extensions/agent-browser/lib/results/presentation/batch-step.js +227 -0
- package/dist/extensions/agent-browser/lib/results/presentation/batch-summary.js +91 -0
- package/dist/extensions/agent-browser/lib/results/presentation/batch.js +91 -460
- package/dist/extensions/agent-browser/lib/results/presentation/browser-profile-recovery.js +9 -5
- package/dist/extensions/agent-browser/lib/results/presentation/command-presenters.js +216 -0
- package/dist/extensions/agent-browser/lib/results/presentation/common.js +26 -9
- package/dist/extensions/agent-browser/lib/results/presentation/content.js +86 -29
- package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-a11y.js +67 -0
- package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-health.js +79 -0
- package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-identity.js +199 -0
- package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-logs.js +75 -0
- package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-network-actions.js +216 -0
- package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-network.js +124 -0
- package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-redaction.js +64 -0
- package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-storage.js +209 -0
- package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-stream.js +69 -0
- package/dist/extensions/agent-browser/lib/results/presentation/diagnostic-summary.js +222 -0
- package/dist/extensions/agent-browser/lib/results/presentation/diagnostics.js +103 -1052
- package/dist/extensions/agent-browser/lib/results/presentation/early-result.js +70 -0
- package/dist/extensions/agent-browser/lib/results/presentation/errors.js +130 -60
- package/dist/extensions/agent-browser/lib/results/presentation/input-contracts.js +1 -0
- package/dist/extensions/agent-browser/lib/results/presentation/large-output.js +60 -145
- package/dist/extensions/agent-browser/lib/results/presentation/navigation.js +147 -88
- package/dist/extensions/agent-browser/lib/results/presentation/notices.js +75 -0
- package/dist/extensions/agent-browser/lib/results/presentation/observation-contracts.js +1 -0
- package/dist/extensions/agent-browser/lib/results/presentation/observation-rendering.js +127 -0
- package/dist/extensions/agent-browser/lib/results/presentation/outcomes.js +120 -0
- package/dist/extensions/agent-browser/lib/results/presentation/output-completion.js +77 -0
- package/dist/extensions/agent-browser/lib/results/presentation/output-spill.js +51 -0
- package/dist/extensions/agent-browser/lib/results/presentation/registry.js +116 -240
- package/dist/extensions/agent-browser/lib/results/presentation/semantic-action.js +35 -21
- package/dist/extensions/agent-browser/lib/results/presentation/skills.js +104 -73
- package/dist/extensions/agent-browser/lib/results/presentation/source.js +109 -0
- package/dist/extensions/agent-browser/lib/results/presentation.js +17 -261
- package/dist/extensions/agent-browser/lib/results/recommendation-contracts.js +1 -0
- package/dist/extensions/agent-browser/lib/results/recording.js +52 -14
- package/dist/extensions/agent-browser/lib/results/recovery-actions.js +14 -5
- package/dist/extensions/agent-browser/lib/results/recovery-next-actions.js +30 -22
- package/dist/extensions/agent-browser/lib/results/selector-recovery-target.js +83 -0
- package/dist/extensions/agent-browser/lib/results/selector-recovery.js +119 -119
- package/dist/extensions/agent-browser/lib/results/snapshot-compact.js +266 -0
- package/dist/extensions/agent-browser/lib/results/snapshot-content.js +32 -0
- package/dist/extensions/agent-browser/lib/results/snapshot-high-value-controls.js +104 -71
- package/dist/extensions/agent-browser/lib/results/snapshot-refs.js +31 -11
- package/dist/extensions/agent-browser/lib/results/snapshot-segments.js +125 -66
- package/dist/extensions/agent-browser/lib/results/snapshot-spill.js +26 -7
- package/dist/extensions/agent-browser/lib/results/snapshot.js +28 -248
- package/dist/extensions/agent-browser/lib/results/text.js +16 -5
- package/dist/extensions/agent-browser/lib/runtime-args-validation.js +133 -0
- package/dist/extensions/agent-browser/lib/runtime-compatibility.js +81 -0
- package/dist/extensions/agent-browser/lib/runtime-contracts.js +1 -0
- package/dist/extensions/agent-browser/lib/runtime-redaction.js +118 -0
- package/dist/extensions/agent-browser/lib/runtime-replay-events.js +144 -0
- package/dist/extensions/agent-browser/lib/runtime-session-identity.js +76 -0
- package/dist/extensions/agent-browser/lib/runtime-session-plan.js +114 -0
- package/dist/extensions/agent-browser/lib/runtime-session-replay.js +123 -0
- package/dist/extensions/agent-browser/lib/runtime-tab-correction.js +65 -0
- package/dist/extensions/agent-browser/lib/runtime-timeouts.js +28 -0
- package/dist/extensions/agent-browser/lib/runtime.js +137 -1041
- package/dist/extensions/agent-browser/lib/session-identity.js +51 -0
- package/dist/extensions/agent-browser/lib/session-page-observation.js +357 -0
- package/dist/extensions/agent-browser/lib/session-page-state.js +178 -333
- package/dist/extensions/agent-browser/lib/session-page-types.js +1 -0
- package/dist/extensions/agent-browser/lib/temp-artifact-budget.js +78 -0
- package/dist/extensions/agent-browser/lib/temp-mutation-queue.js +7 -0
- package/dist/extensions/agent-browser/lib/temp-root-ownership.js +234 -0
- package/dist/extensions/agent-browser/lib/temp-root.js +207 -0
- package/dist/extensions/agent-browser/lib/temp.js +33 -446
- package/dist/extensions/agent-browser/lib/tool-surface.js +94 -24
- package/dist/extensions/agent-browser/lib/upstream-version.js +3 -2
- package/dist/extensions/agent-browser/lib/web-search-providers.js +229 -0
- package/dist/extensions/agent-browser/lib/web-search-request.js +108 -0
- package/dist/extensions/agent-browser/lib/web-search-results.js +281 -0
- package/dist/extensions/agent-browser/lib/web-search-schema.js +82 -0
- package/dist/extensions/agent-browser/lib/web-search.js +109 -617
- package/dist/extensions/agent-browser/lib/webmcp-observation.js +13 -6
- package/dist/extensions/agent-browser/lib/windows-stock-launcher.js +63 -37
- package/dist/extensions/agent-browser/script-worker.js +80 -43
- package/dist/scripts/agent-browser-target.mjs +4 -2
- package/docs/ARCHITECTURE.md +17 -5
- package/docs/CODE_QUALITY.md +242 -0
- package/docs/COMMAND_REFERENCE.md +251 -220
- package/docs/ELECTRON.md +53 -44
- package/docs/RELEASE.md +18 -15
- package/docs/REQUIREMENTS.md +1 -0
- package/docs/SUPPORT_MATRIX.md +76 -75
- package/docs/TOOL_CONTRACT.md +145 -116
- package/docs/platform-smoke.md +5 -5
- package/package.json +143 -120
- package/scripts/agent-browser-capability-baseline.mjs +361 -957
- package/scripts/agent-browser-target.mjs +6 -2
- package/scripts/build.mjs +37 -8
- package/scripts/capability-core-commands.mjs +193 -0
- package/scripts/capability-options.mjs +283 -0
- package/scripts/capability-samples.mjs +133 -0
- package/scripts/capability-section.mjs +11 -0
- package/scripts/config.mjs +213 -114
- package/scripts/convert-browser-session.mjs +30 -9
- package/scripts/doctor-sources.mjs +195 -0
- package/scripts/doctor.mjs +92 -247
- package/scripts/platform-smoke/artifacts.mjs +38 -11
- package/scripts/platform-smoke/commands.mjs +104 -0
- package/scripts/platform-smoke/crabbox-runner.mjs +167 -80
- package/scripts/platform-smoke/doctor-support.mjs +157 -0
- package/scripts/platform-smoke/doctor-windows.mjs +230 -0
- package/scripts/platform-smoke/doctor.mjs +212 -320
- package/scripts/platform-smoke/lease-evidence.mjs +134 -0
- package/scripts/platform-smoke/suite-checks.mjs +98 -0
- package/scripts/platform-smoke/suite-evidence.mjs +281 -0
- package/scripts/platform-smoke/targets.mjs +158 -472
- package/scripts/platform-smoke.mjs +55 -40
- package/scripts/prepare.mjs +16 -7
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
import { redactSensitiveText } from "../runtime.js";
|
|
2
|
+
import { runAgentBrowserProcess } from "../process.js";
|
|
3
|
+
import { getAgentBrowserProcessEnvironment } from "../process-environment.js";
|
|
4
|
+
import { MINIMUM_AGENT_BROWSER_VERSION, SUPPORTED_AGENT_BROWSER_VERSION_LABEL, TARGET_AGENT_BROWSER_VERSION, getAgentBrowserVersionValidationError, parseAgentBrowserVersionOutput, } from "../upstream-version.js";
|
|
5
|
+
function unavailableProbe(probe) {
|
|
6
|
+
const error = probe.spawnError;
|
|
7
|
+
return ((error !== undefined && "code" in error && error.code === "ENOENT") ||
|
|
8
|
+
probe.exitCode === 127 ||
|
|
9
|
+
probe.aborted);
|
|
10
|
+
}
|
|
11
|
+
function probeVersion(probe) {
|
|
12
|
+
if (probe.spawnError || probe.exitCode !== 0) {
|
|
13
|
+
const stderr = probe.stderr.trim();
|
|
14
|
+
const detail = redactSensitiveText(probe.spawnError?.message ?? (stderr !== "" ? stderr : `exit ${probe.exitCode}`));
|
|
15
|
+
return {
|
|
16
|
+
error: `agent-browser --version could not be validated (${detail}). Run pi-agent-browser-doctor before browser-backed calls.`,
|
|
17
|
+
};
|
|
18
|
+
}
|
|
19
|
+
return {
|
|
20
|
+
observedVersion: parseAgentBrowserVersionOutput(probe.stdout),
|
|
21
|
+
error: getAgentBrowserVersionValidationError(probe.stdout),
|
|
22
|
+
};
|
|
23
|
+
}
|
|
24
|
+
export async function validateUpstreamVersion(cache, cwd, signal) {
|
|
25
|
+
const env = getAgentBrowserProcessEnvironment();
|
|
26
|
+
const key = `${cwd}\0${env.PATH ?? env.Path ?? ""}`;
|
|
27
|
+
if (cache.has(key)) {
|
|
28
|
+
return undefined;
|
|
29
|
+
}
|
|
30
|
+
const probe = await runAgentBrowserProcess({ args: ["--version"], cwd, signal, timeoutMs: 5000 });
|
|
31
|
+
if (unavailableProbe(probe)) {
|
|
32
|
+
return undefined;
|
|
33
|
+
}
|
|
34
|
+
const { error, observedVersion } = probeVersion(probe);
|
|
35
|
+
if (error === undefined || error === "") {
|
|
36
|
+
cache.add(key);
|
|
37
|
+
return undefined;
|
|
38
|
+
}
|
|
39
|
+
return {
|
|
40
|
+
content: [{ type: "text", text: error }],
|
|
41
|
+
details: {
|
|
42
|
+
expectedVersion: TARGET_AGENT_BROWSER_VERSION,
|
|
43
|
+
failureCategory: "validation-error",
|
|
44
|
+
observedVersion,
|
|
45
|
+
resultCategory: "failure",
|
|
46
|
+
minimumSupportedVersion: MINIMUM_AGENT_BROWSER_VERSION,
|
|
47
|
+
versionValidation: {
|
|
48
|
+
expected: SUPPORTED_AGENT_BROWSER_VERSION_LABEL,
|
|
49
|
+
observed: observedVersion,
|
|
50
|
+
},
|
|
51
|
+
},
|
|
52
|
+
isError: true,
|
|
53
|
+
};
|
|
54
|
+
}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -1,55 +1,19 @@
|
|
|
1
1
|
import { parseArgvDescriptor } from "../argv-descriptor.js";
|
|
2
|
+
import { isRecord } from "../parsing.js";
|
|
3
|
+
import { isStringArray } from "../input-modes/shared.js";
|
|
2
4
|
import { normalizeUrlLessOpen } from "./batch-stdin.js";
|
|
3
|
-
import { isPlainTextInspectionArgs, validateToolArgs, redactInvocationArgs
|
|
5
|
+
import { isPlainTextInspectionArgs, validateToolArgs, redactInvocationArgs } from "../runtime.js";
|
|
4
6
|
import { buildAgentBrowserResultCategoryDetails } from "../results/categories.js";
|
|
5
7
|
import { compileAgentBrowserElectron } from "../input-modes/electron.js";
|
|
6
8
|
import { compileAgentBrowserQaPreset } from "../input-modes/job.js";
|
|
7
|
-
import { compileAgentBrowserNetworkSourceLookup, compileAgentBrowserSourceLookup,
|
|
9
|
+
import { compileAgentBrowserNetworkSourceLookup, compileAgentBrowserSourceLookup, } from "../input-modes/lookups.js";
|
|
8
10
|
import { compileAgentBrowserSemanticAction } from "../input-modes/semantic-action.js";
|
|
9
|
-
|
|
10
|
-
if (!compiled)
|
|
11
|
-
return undefined;
|
|
12
|
-
if (compiled.action === "list") {
|
|
13
|
-
return { ...compiled, query: compiled.query ? redactSensitiveText(compiled.query) : undefined };
|
|
14
|
-
}
|
|
15
|
-
if (compiled.action === "launch") {
|
|
16
|
-
return { ...compiled, appArgs: compiled.appArgs ? redactInvocationArgs(compiled.appArgs) : undefined };
|
|
17
|
-
}
|
|
18
|
-
return { ...compiled };
|
|
19
|
-
}
|
|
20
|
-
function redactCompiledJob(compiled) {
|
|
21
|
-
const redactedSteps = compiled?.steps.map((step) => ({ ...step, args: redactInvocationArgs(step.args) }));
|
|
22
|
-
return compiled && redactedSteps
|
|
23
|
-
? { ...compiled, stdin: JSON.stringify(redactedSteps.map((step) => step.args)), steps: redactedSteps }
|
|
24
|
-
: undefined;
|
|
25
|
-
}
|
|
26
|
-
function redactCompiledSourceLookup(compiled) {
|
|
27
|
-
const redactedSteps = compiled?.steps.map((step) => ({ ...step, args: redactInvocationArgs(step.args) }));
|
|
28
|
-
return compiled && redactedSteps
|
|
29
|
-
? { ...compiled, stdin: JSON.stringify(redactedSteps.map((step) => step.args)), steps: redactedSteps }
|
|
30
|
-
: undefined;
|
|
31
|
-
}
|
|
32
|
-
function redactCompiledNetworkSourceLookup(compiled) {
|
|
33
|
-
const redactedSteps = compiled?.steps.map((step) => ({ ...step, args: redactNetworkSourceLookupArgs(step.args) }));
|
|
34
|
-
return compiled && redactedSteps
|
|
35
|
-
? {
|
|
36
|
-
...compiled,
|
|
37
|
-
args: redactNetworkSourceLookupArgs(compiled.args),
|
|
38
|
-
query: {
|
|
39
|
-
...compiled.query,
|
|
40
|
-
filter: redactNetworkSourceLookupUrl(compiled.query.filter),
|
|
41
|
-
url: redactNetworkSourceLookupUrl(compiled.query.url),
|
|
42
|
-
},
|
|
43
|
-
stdin: JSON.stringify(redactedSteps.map((step) => step.args)),
|
|
44
|
-
steps: redactedSteps,
|
|
45
|
-
}
|
|
46
|
-
: undefined;
|
|
47
|
-
}
|
|
11
|
+
import { redactCompiledElectron, redactCompiledJob, redactCompiledNetworkSourceLookup, redactCompiledSourceLookup, } from "./input-redaction.js";
|
|
48
12
|
function normalizeExplicitEvalStdinArgs(args, stdin) {
|
|
49
13
|
if (stdin !== undefined) {
|
|
50
14
|
return { args, stdin };
|
|
51
15
|
}
|
|
52
|
-
const descriptor = parseArgvDescriptor(args);
|
|
16
|
+
const descriptor = parseArgvDescriptor([...args]);
|
|
53
17
|
if (descriptor.commandInfo.command !== "eval") {
|
|
54
18
|
return { args, stdin };
|
|
55
19
|
}
|
|
@@ -58,164 +22,276 @@ function normalizeExplicitEvalStdinArgs(args, stdin) {
|
|
|
58
22
|
return { args, stdin };
|
|
59
23
|
}
|
|
60
24
|
const commandStartIndex = args.length - descriptor.commandTokens.length;
|
|
61
|
-
const stdinValue = descriptor.commandTokens.slice(stdinIndex + 1).join(" ");
|
|
62
25
|
return {
|
|
63
|
-
args: [
|
|
64
|
-
|
|
26
|
+
args: [
|
|
27
|
+
...args.slice(0, commandStartIndex),
|
|
28
|
+
...descriptor.commandTokens.slice(0, stdinIndex + 1),
|
|
29
|
+
],
|
|
30
|
+
stdin: descriptor.commandTokens.slice(stdinIndex + 1).join(" "),
|
|
65
31
|
};
|
|
66
32
|
}
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
const attachedQaSessionError = compiledQaPreset?.checks.attached
|
|
115
|
-
? params.sessionMode === "fresh"
|
|
116
|
-
? "qa.attached cannot be used with sessionMode=fresh; attach or launch a session first, then run qa.attached with the current session."
|
|
117
|
-
: undefined
|
|
118
|
-
: undefined;
|
|
119
|
-
const validationError = semanticActionResult.error
|
|
120
|
-
?? qaResult.error
|
|
121
|
-
?? sourceLookupResult.error
|
|
122
|
-
?? networkSourceLookupResult.error
|
|
123
|
-
?? electronResult.error
|
|
124
|
-
?? inputModeError
|
|
125
|
-
?? generatedStdinError
|
|
126
|
-
?? outputPathError
|
|
127
|
-
?? timeoutMsError
|
|
128
|
-
?? attachedQaSessionError
|
|
129
|
-
?? (compiledElectron ? undefined : validateToolArgs(toolArgs) ?? getBatchPreflightValidationError(toolArgs, toolStdin));
|
|
130
|
-
const redactedCompiledJob = redactCompiledJob(compiledJob);
|
|
131
|
-
const redactedCompiledSemanticAction = compiledSemanticAction
|
|
132
|
-
? { ...compiledSemanticAction, args: redactInvocationArgs(compiledSemanticAction.args) }
|
|
133
|
-
: undefined;
|
|
134
|
-
const attemptedKind = compiledElectron
|
|
135
|
-
? "electron"
|
|
136
|
-
: compiledNetworkSourceLookup
|
|
137
|
-
? "networkSourceLookup"
|
|
138
|
-
: compiledSourceLookup
|
|
139
|
-
? "sourceLookup"
|
|
140
|
-
: compiledQaPreset
|
|
141
|
-
? "qa"
|
|
142
|
-
: compiledSemanticAction
|
|
143
|
-
? "semanticAction"
|
|
144
|
-
: hasExplicitArgs
|
|
145
|
-
? "args"
|
|
146
|
-
: undefined;
|
|
147
|
-
const redactedCompiledElectron = redactCompiledElectron(compiledElectron);
|
|
148
|
-
const redactedCompiledNetworkSourceLookup = redactCompiledNetworkSourceLookup(compiledNetworkSourceLookup);
|
|
149
|
-
const redactedCompiledQaPreset = compiledQaPreset && redactedCompiledJob ? { ...redactedCompiledJob, checks: compiledQaPreset.checks } : undefined;
|
|
150
|
-
const redactedCompiledSourceLookup = redactCompiledSourceLookup(compiledSourceLookup);
|
|
151
|
-
const normalized = validationError || isPlainTextInspectionArgs(toolArgs) ? { args: toolArgs, stdin: toolStdin } : normalizeUrlLessOpen(toolArgs, toolStdin);
|
|
152
|
-
const resolvedBase = { redactedArgs, toolArgs: normalized.args, toolStdin: normalized.stdin };
|
|
153
|
-
if (validationError) {
|
|
33
|
+
function fieldShapeError(params) {
|
|
34
|
+
if (params.args !== undefined && !isStringArray(params.args)) {
|
|
35
|
+
return "args must be an array of strings when provided.";
|
|
36
|
+
}
|
|
37
|
+
if (params.stdin !== undefined && typeof params.stdin !== "string") {
|
|
38
|
+
return "stdin must be a string when provided.";
|
|
39
|
+
}
|
|
40
|
+
return undefined;
|
|
41
|
+
}
|
|
42
|
+
function outputPathError(value) {
|
|
43
|
+
if (value !== undefined && (typeof value !== "string" || value.trim().length === 0)) {
|
|
44
|
+
return "outputPath must be a non-empty string when provided.";
|
|
45
|
+
}
|
|
46
|
+
return undefined;
|
|
47
|
+
}
|
|
48
|
+
/** Compiles all requested modes once, then validates selection before exposing executable input. */
|
|
49
|
+
class BrowserInputCompiler {
|
|
50
|
+
params;
|
|
51
|
+
preflight;
|
|
52
|
+
semanticAction;
|
|
53
|
+
qa;
|
|
54
|
+
sourceLookup;
|
|
55
|
+
networkSourceLookup;
|
|
56
|
+
electron;
|
|
57
|
+
modes;
|
|
58
|
+
constructor(params, preflight) {
|
|
59
|
+
this.params = params;
|
|
60
|
+
this.preflight = preflight;
|
|
61
|
+
this.semanticAction =
|
|
62
|
+
params.semanticAction === undefined
|
|
63
|
+
? {}
|
|
64
|
+
: compileAgentBrowserSemanticAction(params.semanticAction);
|
|
65
|
+
this.qa = params.qa === undefined ? {} : compileAgentBrowserQaPreset(params.qa);
|
|
66
|
+
this.sourceLookup =
|
|
67
|
+
params.sourceLookup === undefined ? {} : compileAgentBrowserSourceLookup(params.sourceLookup);
|
|
68
|
+
this.networkSourceLookup =
|
|
69
|
+
params.networkSourceLookup === undefined
|
|
70
|
+
? {}
|
|
71
|
+
: compileAgentBrowserNetworkSourceLookup(params.networkSourceLookup);
|
|
72
|
+
this.electron =
|
|
73
|
+
params.electron === undefined ? {} : compileAgentBrowserElectron(params.electron);
|
|
74
|
+
this.modes = this.projectModes();
|
|
75
|
+
}
|
|
76
|
+
projectModes() {
|
|
77
|
+
const compiledJob = this.qa.compiled;
|
|
78
|
+
const redactedCompiledJob = redactCompiledJob(compiledJob);
|
|
79
|
+
const compiledSemanticAction = this.semanticAction.compiled;
|
|
154
80
|
return {
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
compiledElectron,
|
|
158
|
-
compiledGeneratedBatch,
|
|
81
|
+
compiledElectron: this.electron.compiled,
|
|
82
|
+
compiledGeneratedBatch: this.networkSourceLookup.compiled ?? this.sourceLookup.compiled ?? compiledJob,
|
|
159
83
|
compiledJob,
|
|
160
|
-
compiledNetworkSourceLookup,
|
|
161
|
-
compiledQaPreset,
|
|
84
|
+
compiledNetworkSourceLookup: this.networkSourceLookup.compiled,
|
|
85
|
+
compiledQaPreset: this.qa.compiled,
|
|
162
86
|
compiledSemanticAction,
|
|
163
|
-
compiledSourceLookup,
|
|
164
|
-
|
|
165
|
-
redactedCompiledElectron,
|
|
87
|
+
compiledSourceLookup: this.sourceLookup.compiled,
|
|
88
|
+
redactedCompiledElectron: redactCompiledElectron(this.electron.compiled),
|
|
166
89
|
redactedCompiledJob,
|
|
167
|
-
redactedCompiledNetworkSourceLookup,
|
|
168
|
-
redactedCompiledQaPreset
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
90
|
+
redactedCompiledNetworkSourceLookup: redactCompiledNetworkSourceLookup(this.networkSourceLookup.compiled),
|
|
91
|
+
redactedCompiledQaPreset: compiledJob !== undefined && redactedCompiledJob !== undefined
|
|
92
|
+
? { ...redactedCompiledJob, checks: compiledJob.checks }
|
|
93
|
+
: undefined,
|
|
94
|
+
redactedCompiledSemanticAction: compiledSemanticAction === undefined
|
|
95
|
+
? undefined
|
|
96
|
+
: {
|
|
97
|
+
...compiledSemanticAction,
|
|
98
|
+
args: redactInvocationArgs([...compiledSemanticAction.args]),
|
|
99
|
+
},
|
|
100
|
+
redactedCompiledSourceLookup: redactCompiledSourceLookup(this.sourceLookup.compiled),
|
|
173
101
|
};
|
|
174
102
|
}
|
|
175
|
-
|
|
176
|
-
|
|
103
|
+
attemptedKind() {
|
|
104
|
+
if (this.electron.compiled !== undefined) {
|
|
105
|
+
return "electron";
|
|
106
|
+
}
|
|
107
|
+
if (this.networkSourceLookup.compiled !== undefined) {
|
|
108
|
+
return "networkSourceLookup";
|
|
109
|
+
}
|
|
110
|
+
if (this.sourceLookup.compiled !== undefined) {
|
|
111
|
+
return "sourceLookup";
|
|
112
|
+
}
|
|
113
|
+
if (this.qa.compiled !== undefined) {
|
|
114
|
+
return "qa";
|
|
115
|
+
}
|
|
116
|
+
if (this.semanticAction.compiled !== undefined) {
|
|
117
|
+
return "semanticAction";
|
|
118
|
+
}
|
|
119
|
+
return Array.isArray(this.params.args) ? "args" : undefined;
|
|
177
120
|
}
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
121
|
+
inputModeError() {
|
|
122
|
+
const selected = [
|
|
123
|
+
Array.isArray(this.params.args),
|
|
124
|
+
this.semanticAction.compiled !== undefined,
|
|
125
|
+
this.qa.compiled !== undefined,
|
|
126
|
+
this.sourceLookup.compiled !== undefined,
|
|
127
|
+
this.networkSourceLookup.compiled !== undefined,
|
|
128
|
+
this.electron.compiled !== undefined,
|
|
129
|
+
].filter((active) => active).length;
|
|
130
|
+
return selected === 1
|
|
131
|
+
? undefined
|
|
132
|
+
: "Provide exactly one of args, semanticAction, qa, sourceLookup, networkSourceLookup, or electron.";
|
|
187
133
|
}
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
134
|
+
generatedStdinError() {
|
|
135
|
+
if (this.params.stdin === undefined) {
|
|
136
|
+
return undefined;
|
|
137
|
+
}
|
|
138
|
+
if (this.modes.compiledGeneratedBatch !== undefined) {
|
|
139
|
+
return "Do not provide stdin with qa, sourceLookup, or networkSourceLookup; those modes generate their own batch stdin.";
|
|
140
|
+
}
|
|
141
|
+
return this.electron.compiled === undefined
|
|
142
|
+
? undefined
|
|
143
|
+
: "Do not provide stdin with electron; electron mode is host-only or manages its own input.";
|
|
197
144
|
}
|
|
198
|
-
|
|
145
|
+
timeoutError() {
|
|
146
|
+
const value = this.params.timeoutMs;
|
|
147
|
+
if (value === undefined) {
|
|
148
|
+
return undefined;
|
|
149
|
+
}
|
|
150
|
+
if (typeof value !== "number" || !Number.isSafeInteger(value) || value <= 0) {
|
|
151
|
+
return "timeoutMs must be a positive integer when provided.";
|
|
152
|
+
}
|
|
153
|
+
if (this.electron.compiled === undefined) {
|
|
154
|
+
return undefined;
|
|
155
|
+
}
|
|
156
|
+
return this.electron.compiled.action === "list"
|
|
157
|
+
? "electron.list has no configurable timeout; remove top-level timeoutMs."
|
|
158
|
+
: "Use electron.timeoutMs for this action; top-level timeoutMs applies only to browser CLI subprocess calls.";
|
|
159
|
+
}
|
|
160
|
+
attachedQaError() {
|
|
161
|
+
return this.qa.compiled?.checks.attached === true && this.params.sessionMode === "fresh"
|
|
162
|
+
? "qa.attached cannot be used with sessionMode=fresh; attach or launch a session first, then run qa.attached with the current session."
|
|
163
|
+
: undefined;
|
|
164
|
+
}
|
|
165
|
+
validationError(args, stdin) {
|
|
166
|
+
const compilationError = this.compilationError();
|
|
167
|
+
const shapeError = fieldShapeError(this.params);
|
|
168
|
+
const modeError = this.inputModeError() ?? this.generatedStdinError();
|
|
169
|
+
const optionsError = this.optionsError();
|
|
170
|
+
const error = compilationError ?? shapeError ?? modeError ?? optionsError;
|
|
171
|
+
if (error !== undefined) {
|
|
172
|
+
return error;
|
|
173
|
+
}
|
|
174
|
+
return this.electron.compiled === undefined
|
|
175
|
+
? (validateToolArgs([...args]) ?? this.preflight(args, stdin))
|
|
176
|
+
: undefined;
|
|
177
|
+
}
|
|
178
|
+
compilationError() {
|
|
179
|
+
return (this.semanticAction.error ??
|
|
180
|
+
this.qa.error ??
|
|
181
|
+
this.sourceLookup.error ??
|
|
182
|
+
this.networkSourceLookup.error ??
|
|
183
|
+
this.electron.error);
|
|
184
|
+
}
|
|
185
|
+
optionsError() {
|
|
186
|
+
return outputPathError(this.params.outputPath) ?? this.timeoutError() ?? this.attachedQaError();
|
|
187
|
+
}
|
|
188
|
+
validInput(base) {
|
|
189
|
+
const { compiledElectron, compiledSemanticAction, redactedCompiledElectron, redactedCompiledSemanticAction, } = this.modes;
|
|
190
|
+
if (compiledElectron !== undefined && redactedCompiledElectron !== undefined) {
|
|
191
|
+
return {
|
|
192
|
+
...base,
|
|
193
|
+
compiledElectron,
|
|
194
|
+
kind: "electron",
|
|
195
|
+
redactedCompiledElectron,
|
|
196
|
+
status: "valid",
|
|
197
|
+
};
|
|
198
|
+
}
|
|
199
|
+
const generated = this.validGeneratedInput(base);
|
|
200
|
+
if (generated !== undefined) {
|
|
201
|
+
return generated;
|
|
202
|
+
}
|
|
203
|
+
if (compiledSemanticAction !== undefined && redactedCompiledSemanticAction !== undefined) {
|
|
204
|
+
return {
|
|
205
|
+
...base,
|
|
206
|
+
compiledSemanticAction,
|
|
207
|
+
kind: "semanticAction",
|
|
208
|
+
redactedCompiledSemanticAction,
|
|
209
|
+
status: "valid",
|
|
210
|
+
};
|
|
211
|
+
}
|
|
212
|
+
return { ...base, kind: "args", status: "valid" };
|
|
213
|
+
}
|
|
214
|
+
validGeneratedInput(base) {
|
|
215
|
+
const { compiledNetworkSourceLookup, compiledSourceLookup, compiledQaPreset, redactedCompiledNetworkSourceLookup, redactedCompiledSourceLookup, redactedCompiledQaPreset, redactedCompiledJob, } = this.modes;
|
|
216
|
+
if (compiledNetworkSourceLookup !== undefined &&
|
|
217
|
+
redactedCompiledNetworkSourceLookup !== undefined) {
|
|
218
|
+
return {
|
|
219
|
+
...base,
|
|
220
|
+
compiledGeneratedBatch: compiledNetworkSourceLookup,
|
|
221
|
+
compiledNetworkSourceLookup,
|
|
222
|
+
kind: "networkSourceLookup",
|
|
223
|
+
redactedCompiledNetworkSourceLookup,
|
|
224
|
+
status: "valid",
|
|
225
|
+
};
|
|
226
|
+
}
|
|
227
|
+
if (compiledSourceLookup !== undefined && redactedCompiledSourceLookup !== undefined) {
|
|
228
|
+
return {
|
|
229
|
+
...base,
|
|
230
|
+
compiledGeneratedBatch: compiledSourceLookup,
|
|
231
|
+
compiledSourceLookup,
|
|
232
|
+
kind: "sourceLookup",
|
|
233
|
+
redactedCompiledSourceLookup,
|
|
234
|
+
status: "valid",
|
|
235
|
+
};
|
|
236
|
+
}
|
|
237
|
+
if (compiledQaPreset !== undefined &&
|
|
238
|
+
redactedCompiledJob !== undefined &&
|
|
239
|
+
redactedCompiledQaPreset !== undefined) {
|
|
240
|
+
return {
|
|
241
|
+
...base,
|
|
242
|
+
compiledGeneratedBatch: compiledQaPreset,
|
|
243
|
+
compiledJob: compiledQaPreset,
|
|
244
|
+
compiledQaPreset,
|
|
245
|
+
kind: "qa",
|
|
246
|
+
redactedCompiledJob,
|
|
247
|
+
redactedCompiledQaPreset,
|
|
248
|
+
status: "valid",
|
|
249
|
+
};
|
|
250
|
+
}
|
|
251
|
+
return undefined;
|
|
252
|
+
}
|
|
253
|
+
explicitInput() {
|
|
254
|
+
return normalizeExplicitEvalStdinArgs(isStringArray(this.params.args) ? this.params.args : [], typeof this.params.stdin === "string" ? this.params.stdin : undefined);
|
|
255
|
+
}
|
|
256
|
+
executionInput() {
|
|
257
|
+
const explicit = this.explicitInput();
|
|
199
258
|
return {
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
redactedCompiledQaPreset,
|
|
207
|
-
status: "valid",
|
|
259
|
+
args: this.electron.compiled === undefined
|
|
260
|
+
? (this.semanticAction.compiled?.args ??
|
|
261
|
+
this.modes.compiledGeneratedBatch?.args ??
|
|
262
|
+
explicit.args)
|
|
263
|
+
: [],
|
|
264
|
+
stdin: this.modes.compiledGeneratedBatch?.stdin ?? explicit.stdin,
|
|
208
265
|
};
|
|
209
266
|
}
|
|
210
|
-
|
|
211
|
-
|
|
267
|
+
resolve() {
|
|
268
|
+
const { args, stdin } = this.executionInput();
|
|
269
|
+
const redactedArgs = redactInvocationArgs([...args]);
|
|
270
|
+
const validationError = this.validationError(args, stdin);
|
|
271
|
+
const normalized = validationError !== undefined || isPlainTextInspectionArgs([...args])
|
|
272
|
+
? { args, stdin }
|
|
273
|
+
: normalizeUrlLessOpen([...args], stdin);
|
|
274
|
+
const base = { redactedArgs, toolArgs: normalized.args, toolStdin: normalized.stdin };
|
|
275
|
+
if (validationError !== undefined) {
|
|
276
|
+
return {
|
|
277
|
+
...base,
|
|
278
|
+
...this.modes,
|
|
279
|
+
attemptedKind: this.attemptedKind(),
|
|
280
|
+
kind: "invalid",
|
|
281
|
+
status: "invalid",
|
|
282
|
+
validationError,
|
|
283
|
+
};
|
|
284
|
+
}
|
|
285
|
+
return this.validInput(base);
|
|
212
286
|
}
|
|
213
|
-
|
|
287
|
+
}
|
|
288
|
+
export function resolveAgentBrowserInput(options) {
|
|
289
|
+
const params = isRecord(options.params) ? options.params : {};
|
|
290
|
+
return new BrowserInputCompiler(params, options.getBatchPreflightValidationError).resolve();
|
|
214
291
|
}
|
|
215
292
|
export function buildValidationFailureResult(input) {
|
|
216
|
-
const validationError = input.validationError ?? "Invalid agent_browser input.";
|
|
217
293
|
return {
|
|
218
|
-
content: [{ type: "text", text: validationError }],
|
|
294
|
+
content: [{ type: "text", text: input.validationError }],
|
|
219
295
|
details: {
|
|
220
296
|
args: input.redactedArgs,
|
|
221
297
|
compiledElectron: input.redactedCompiledElectron,
|
|
@@ -225,12 +301,12 @@ export function buildValidationFailureResult(input) {
|
|
|
225
301
|
compiledNetworkSourceLookup: input.redactedCompiledNetworkSourceLookup,
|
|
226
302
|
compiledSemanticAction: input.redactedCompiledSemanticAction,
|
|
227
303
|
...buildAgentBrowserResultCategoryDetails({
|
|
228
|
-
args: input.redactedArgs,
|
|
229
|
-
errorText: validationError,
|
|
304
|
+
args: [...input.redactedArgs],
|
|
305
|
+
errorText: input.validationError,
|
|
230
306
|
succeeded: false,
|
|
231
|
-
validationError,
|
|
307
|
+
validationError: input.validationError,
|
|
232
308
|
}),
|
|
233
|
-
validationError,
|
|
309
|
+
validationError: input.validationError,
|
|
234
310
|
},
|
|
235
311
|
isError: true,
|
|
236
312
|
};
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
import { redactInvocationArgs, redactSensitiveText } from "../runtime.js";
|
|
2
|
+
import { redactNetworkSourceLookupArgs, redactNetworkSourceLookupUrl, } from "../input-modes/lookups.js";
|
|
3
|
+
export function redactCompiledElectron(compiled) {
|
|
4
|
+
if (compiled === undefined) {
|
|
5
|
+
return undefined;
|
|
6
|
+
}
|
|
7
|
+
if (compiled.action === "list") {
|
|
8
|
+
return {
|
|
9
|
+
...compiled,
|
|
10
|
+
query: compiled.query !== undefined && compiled.query.length > 0
|
|
11
|
+
? redactSensitiveText(compiled.query)
|
|
12
|
+
: undefined,
|
|
13
|
+
};
|
|
14
|
+
}
|
|
15
|
+
if (compiled.action === "launch") {
|
|
16
|
+
return {
|
|
17
|
+
...compiled,
|
|
18
|
+
appArgs: compiled.appArgs === undefined ? undefined : redactInvocationArgs([...compiled.appArgs]),
|
|
19
|
+
};
|
|
20
|
+
}
|
|
21
|
+
return { ...compiled };
|
|
22
|
+
}
|
|
23
|
+
export function redactCompiledJob(compiled) {
|
|
24
|
+
if (compiled === undefined) {
|
|
25
|
+
return undefined;
|
|
26
|
+
}
|
|
27
|
+
const steps = compiled.steps.map((step) => ({
|
|
28
|
+
...step,
|
|
29
|
+
args: redactInvocationArgs([...step.args]),
|
|
30
|
+
}));
|
|
31
|
+
return { ...compiled, stdin: JSON.stringify(steps.map((step) => step.args)), steps };
|
|
32
|
+
}
|
|
33
|
+
export function redactCompiledSourceLookup(compiled) {
|
|
34
|
+
if (compiled === undefined) {
|
|
35
|
+
return undefined;
|
|
36
|
+
}
|
|
37
|
+
const steps = compiled.steps.map((step) => ({
|
|
38
|
+
...step,
|
|
39
|
+
args: redactInvocationArgs([...step.args]),
|
|
40
|
+
}));
|
|
41
|
+
return { ...compiled, stdin: JSON.stringify(steps.map((step) => step.args)), steps };
|
|
42
|
+
}
|
|
43
|
+
export function redactCompiledNetworkSourceLookup(compiled) {
|
|
44
|
+
if (compiled === undefined) {
|
|
45
|
+
return undefined;
|
|
46
|
+
}
|
|
47
|
+
const steps = compiled.steps.map((step) => ({
|
|
48
|
+
...step,
|
|
49
|
+
args: redactNetworkSourceLookupArgs([...step.args]),
|
|
50
|
+
}));
|
|
51
|
+
return {
|
|
52
|
+
...compiled,
|
|
53
|
+
args: redactNetworkSourceLookupArgs([...compiled.args]),
|
|
54
|
+
query: {
|
|
55
|
+
...compiled.query,
|
|
56
|
+
filter: redactNetworkSourceLookupUrl(compiled.query.filter),
|
|
57
|
+
url: redactNetworkSourceLookupUrl(compiled.query.url),
|
|
58
|
+
},
|
|
59
|
+
stdin: JSON.stringify(steps.map((step) => step.args)),
|
|
60
|
+
steps,
|
|
61
|
+
};
|
|
62
|
+
}
|