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,105 +0,0 @@
|
|
|
1
|
-
import { hasCommandCapability } from "./command-capabilities.js";
|
|
2
|
-
export { isKnownCommandToken } from "./command-capabilities.js";
|
|
3
|
-
const WEBMCP_PAGE_MUTATION_SUBCOMMANDS = new Set(["invoke", "result", "cancel"]);
|
|
4
|
-
export function isCloseCommand(command) {
|
|
5
|
-
return hasCommandCapability(command, "closesSession");
|
|
6
|
-
}
|
|
7
|
-
export function isCloseAllCommand(commandTokens) {
|
|
8
|
-
return isCloseCommand(commandTokens[0]) && commandTokens.slice(1).includes("--all");
|
|
9
|
-
}
|
|
10
|
-
export function isOpenNavigationCommand(command) {
|
|
11
|
-
return hasCommandCapability(command, "openNavigation");
|
|
12
|
-
}
|
|
13
|
-
export function isReadOnlyDiagnosticSessionTargetCommand(command, subcommand) {
|
|
14
|
-
return (hasCommandCapability(command, "readOnlyDiagnosticSessionTarget") ||
|
|
15
|
-
(command === "webmcp" && subcommand === "list"));
|
|
16
|
-
}
|
|
17
|
-
export function isSessionTabPinningExcludedCommand(command) {
|
|
18
|
-
return hasCommandCapability(command, "excludedFromPinning");
|
|
19
|
-
}
|
|
20
|
-
export function isSessionTabPostCommandCorrectionExcludedCommand(command) {
|
|
21
|
-
return hasCommandCapability(command, "excludedFromPostCommandCorrection");
|
|
22
|
-
}
|
|
23
|
-
function recordOptionWidth(token, next) {
|
|
24
|
-
// Native validates the range; bare/non-numeric --fps keeps its old literal meaning.
|
|
25
|
-
if (token === "--fps" && /^\+?\d+$/.test(next ?? "")) {
|
|
26
|
-
return 2;
|
|
27
|
-
}
|
|
28
|
-
if (token === "--cursor" || token === "--contact-sheet") {
|
|
29
|
-
return 1;
|
|
30
|
-
}
|
|
31
|
-
return token === "--contact-sheet-threshold" && next !== undefined ? 2 : 0;
|
|
32
|
-
}
|
|
33
|
-
export function getRecordCommandOperandIndices(tokens) {
|
|
34
|
-
if (tokens[0] !== "record" || !["start", "restart"].includes(tokens[1] ?? "")) {
|
|
35
|
-
return [];
|
|
36
|
-
}
|
|
37
|
-
const operands = [];
|
|
38
|
-
for (let index = 2; index < tokens.length && operands.length < 2; index += 1) {
|
|
39
|
-
const width = recordOptionWidth(tokens[index], tokens.at(index + 1));
|
|
40
|
-
if (width > 0) {
|
|
41
|
-
index += width - 1;
|
|
42
|
-
}
|
|
43
|
-
else {
|
|
44
|
-
operands.push(index);
|
|
45
|
-
}
|
|
46
|
-
}
|
|
47
|
-
return operands.length > 0 ? operands : [2, 3];
|
|
48
|
-
}
|
|
49
|
-
export function getRecordCommandOperands(tokens) {
|
|
50
|
-
const indices = getRecordCommandOperandIndices(tokens);
|
|
51
|
-
const path = indices.at(0);
|
|
52
|
-
const url = indices.at(1);
|
|
53
|
-
return path === undefined
|
|
54
|
-
? {}
|
|
55
|
-
: { path: tokens[path], url: url === undefined ? undefined : tokens[url] };
|
|
56
|
-
}
|
|
57
|
-
/** Starts conservatively invalidate refs because older supported natives replace the page, even on failure. Restarts invalidate only when they have a URL. */
|
|
58
|
-
export function isRecordPageTransitionCommand(tokens) {
|
|
59
|
-
if (tokens[0] !== "record") {
|
|
60
|
-
return false;
|
|
61
|
-
}
|
|
62
|
-
return (tokens[1] === "start" ||
|
|
63
|
-
(tokens[1] === "restart" && getRecordCommandOperands(tokens).url !== undefined));
|
|
64
|
-
}
|
|
65
|
-
export function isWebMcpPageMutationCommand(tokens) {
|
|
66
|
-
return isWebMcpPageMutation(tokens[0], tokens[1]);
|
|
67
|
-
}
|
|
68
|
-
export function isWindowOrDiffPageTransitionCommand(command, subcommand) {
|
|
69
|
-
return ((command === "window" && subcommand === "new") || (command === "diff" && subcommand === "url"));
|
|
70
|
-
}
|
|
71
|
-
export function isRefInvalidatingBatchCommand(step) {
|
|
72
|
-
return (hasCommandCapability(step[0], "invalidatesBatchRefs") ||
|
|
73
|
-
isRecordPageTransitionCommand(step) ||
|
|
74
|
-
isWebMcpPageMutationCommand(step) ||
|
|
75
|
-
isWindowOrDiffPageTransitionCommand(step[0], step[1]));
|
|
76
|
-
}
|
|
77
|
-
export function isRefGuardedCommand(command) {
|
|
78
|
-
return hasCommandCapability(command, "guardsPageRefs");
|
|
79
|
-
}
|
|
80
|
-
export function isElectronPostCommandHealthCommand(command) {
|
|
81
|
-
return hasCommandCapability(command, "eligibleForElectronHealthProbe");
|
|
82
|
-
}
|
|
83
|
-
function isWebMcpPageMutation(command, subcommand) {
|
|
84
|
-
return command === "webmcp" && WEBMCP_PAGE_MUTATION_SUBCOMMANDS.has(subcommand ?? "");
|
|
85
|
-
}
|
|
86
|
-
export function isNavigationObservableCommandName(command, subcommand) {
|
|
87
|
-
return (hasCommandCapability(command, "navigationObservable") ||
|
|
88
|
-
isWebMcpPageMutation(command, subcommand) ||
|
|
89
|
-
isWindowOrDiffPageTransitionCommand(command, subcommand));
|
|
90
|
-
}
|
|
91
|
-
export function isUnverifiedPageTransitionCommand(command, subcommand) {
|
|
92
|
-
return (["back", "connect", "eval", "forward", "reload"].includes(command ?? "") ||
|
|
93
|
-
(command === "state" && subcommand === "load") ||
|
|
94
|
-
(command === "tab" && subcommand !== undefined && !["list", "new"].includes(subcommand)) ||
|
|
95
|
-
isWindowOrDiffPageTransitionCommand(command, subcommand) ||
|
|
96
|
-
isWebMcpPageMutation(command, subcommand));
|
|
97
|
-
}
|
|
98
|
-
export function isPageMutationCommand(command, subcommand) {
|
|
99
|
-
return (hasCommandCapability(command, "triggersPostMutationSnapshot") ||
|
|
100
|
-
isWebMcpPageMutation(command, subcommand));
|
|
101
|
-
}
|
|
102
|
-
export function isPageChangeSummaryCommand(command, subcommand) {
|
|
103
|
-
return (hasCommandCapability(command, "eligibleForPageChangeSummary") ||
|
|
104
|
-
isWebMcpPageMutation(command, subcommand));
|
|
105
|
-
}
|
|
@@ -1,450 +0,0 @@
|
|
|
1
|
-
// @ts-check
|
|
2
|
-
import { existsSync, readFileSync } from "node:fs";
|
|
3
|
-
import { homedir } from "node:os";
|
|
4
|
-
import { join, resolve } from "node:path";
|
|
5
|
-
import { DEFAULT_WEB_SEARCH_PROVIDER, WEB_SEARCH_PROVIDERS, getWebSearchProviderDescriptor, getWebSearchProviderEnvVar, } from "./config-providers.js";
|
|
6
|
-
import { parseAgentBrowserConfigLayer, describeUnknownError } from "./config-validation.js";
|
|
7
|
-
export * from "./config-providers.js";
|
|
8
|
-
export { parseAgentBrowserConfigJson, parseAgentBrowserConfigLayer, validateAgentBrowserConfig, validateWebSearchProvider, } from "./config-validation.js";
|
|
9
|
-
/** @typedef {import("./config-providers.js").WebSearchProvider} WebSearchProvider */
|
|
10
|
-
/** @typedef {import("./config-providers.js").ExaSearchType} ExaSearchType */
|
|
11
|
-
/** @typedef {import("./config-providers.js").WebSearchProviderConfigKey} WebSearchProviderConfigKey */
|
|
12
|
-
/** @typedef {import("./config-providers.js").WebSearchProviderDescriptor} WebSearchProviderDescriptor */
|
|
13
|
-
/** @typedef {import("./config-validation.js").BrowserDefaultProfilePolicy} BrowserDefaultProfilePolicy */
|
|
14
|
-
/** @typedef {import("./config-validation.js").BrowserDefaultProfileConfig} BrowserDefaultProfileConfig */
|
|
15
|
-
/** @typedef {import("./config-validation.js").BrowserConfig} BrowserConfig */
|
|
16
|
-
/** @typedef {import("./config-validation.js").WebSearchConfig} WebSearchConfig */
|
|
17
|
-
/** @typedef {import("./config-validation.js").ConfigLayerScope} ConfigLayerScope */
|
|
18
|
-
/** @typedef {import("./config-validation.js").AgentBrowserConfig} AgentBrowserConfig */
|
|
19
|
-
/** @typedef {import("./config-validation.js").ConfigLayer} ConfigLayer */
|
|
20
|
-
/** @typedef {"global" | "project" | "override" | "env-fallback"} AgentBrowserConfigScope */
|
|
21
|
-
/** @typedef {"literal" | "env" | "command"} CredentialSourceKind */
|
|
22
|
-
/** @typedef {{ readonly kind: CredentialSourceKind; readonly provider?: WebSearchProvider; readonly rawValue: string; readonly scope: AgentBrowserConfigScope }} CredentialSource */
|
|
23
|
-
/** @typedef {{ readonly global: string; readonly project: string; readonly override?: string }} AgentBrowserConfigPaths */
|
|
24
|
-
/** @typedef {{ readonly cwd?: string; readonly env?: NodeJS.ProcessEnv; readonly includeProjectConfig?: boolean }} AgentBrowserConfigLoadOptions */
|
|
25
|
-
/** @typedef {{ readonly browserDefaultProfile?: Required<BrowserDefaultProfileConfig>; readonly browserDefaultProfileScope?: ConfigLayerScope; readonly browserExecutablePath?: string; readonly browserExecutablePathScope?: ConfigLayerScope; readonly trustedBrowserDefaultProfile?: Required<BrowserDefaultProfileConfig>; readonly trustedBrowserDefaultProfileScope?: ConfigLayerScope; readonly trustedBrowserExecutablePath?: string; readonly trustedBrowserExecutablePathScope?: ConfigLayerScope; readonly config: AgentBrowserConfig; readonly webSearchCredentialSources: Readonly<Partial<Record<WebSearchProvider, CredentialSource>>>; readonly webSearchEnabled: boolean; readonly webSearchPreferredProvider: WebSearchProvider; readonly errors: readonly string[]; readonly layers: readonly ConfigLayer[]; readonly paths: AgentBrowserConfigPaths; readonly projectConfigIncluded: boolean; readonly warnings: readonly string[] }} AgentBrowserConfigState */
|
|
26
|
-
/** @typedef {{ readonly scope: string; readonly path: string; readonly exists: boolean }} ConfigFileSummary */
|
|
27
|
-
const CONFIG_DIR_NAME = ".pi";
|
|
28
|
-
export const AGENT_BROWSER_CONFIG_ENV = "PI_AGENT_BROWSER_CONFIG";
|
|
29
|
-
export const CONFIG_RELATIVE_PATH = /** @type {const} */ ([
|
|
30
|
-
CONFIG_DIR_NAME,
|
|
31
|
-
"config",
|
|
32
|
-
"pi-agent-browser-native",
|
|
33
|
-
"config.json",
|
|
34
|
-
]);
|
|
35
|
-
export const GLOBAL_CONFIG_RELATIVE_PATH = /** @type {const} */ ([
|
|
36
|
-
CONFIG_DIR_NAME,
|
|
37
|
-
"config",
|
|
38
|
-
"pi-agent-browser-native",
|
|
39
|
-
"config.json",
|
|
40
|
-
]);
|
|
41
|
-
export const SECRET_COMMAND_TIMEOUT_MS = 15_000;
|
|
42
|
-
/** @param {NodeJS.ProcessEnv} [env] */
|
|
43
|
-
export function getGlobalAgentBrowserConfigPath(env = process.env) {
|
|
44
|
-
const home = [env.HOME?.trim(), env.USERPROFILE?.trim()].find((value) => value !== undefined && value.length > 0) ?? homedir();
|
|
45
|
-
return join(home, ...GLOBAL_CONFIG_RELATIVE_PATH);
|
|
46
|
-
}
|
|
47
|
-
/** @param {string} [cwd] */
|
|
48
|
-
export function getProjectAgentBrowserConfigPath(cwd = process.cwd()) {
|
|
49
|
-
return resolve(cwd, ...CONFIG_RELATIVE_PATH);
|
|
50
|
-
}
|
|
51
|
-
/**
|
|
52
|
-
* @param {{ readonly cwd?: string; readonly env?: NodeJS.ProcessEnv }} [options]
|
|
53
|
-
* @returns {AgentBrowserConfigPaths}
|
|
54
|
-
*/
|
|
55
|
-
export function getAgentBrowserConfigPaths(options = {}) {
|
|
56
|
-
const env = options.env ?? process.env;
|
|
57
|
-
const override = env[AGENT_BROWSER_CONFIG_ENV]?.trim();
|
|
58
|
-
return {
|
|
59
|
-
global: getGlobalAgentBrowserConfigPath(env),
|
|
60
|
-
project: getProjectAgentBrowserConfigPath(options.cwd),
|
|
61
|
-
...(override !== undefined && override.length > 0 ? { override: resolve(override) } : {}),
|
|
62
|
-
};
|
|
63
|
-
}
|
|
64
|
-
/**
|
|
65
|
-
* @param {AgentBrowserConfig} base
|
|
66
|
-
* @param {AgentBrowserConfig} override
|
|
67
|
-
* @returns {AgentBrowserConfig}
|
|
68
|
-
*/
|
|
69
|
-
export function mergeAgentBrowserConfig(base, override) {
|
|
70
|
-
return {
|
|
71
|
-
...base,
|
|
72
|
-
...override,
|
|
73
|
-
browser: {
|
|
74
|
-
...base.browser,
|
|
75
|
-
...override.browser,
|
|
76
|
-
defaultProfile: override.browser?.defaultProfile ?? base.browser?.defaultProfile,
|
|
77
|
-
},
|
|
78
|
-
webSearch: {
|
|
79
|
-
...base.webSearch,
|
|
80
|
-
...override.webSearch,
|
|
81
|
-
},
|
|
82
|
-
};
|
|
83
|
-
}
|
|
84
|
-
/**
|
|
85
|
-
* @param {string} rawValue
|
|
86
|
-
* @param {AgentBrowserConfigScope} scope
|
|
87
|
-
* @param {WebSearchProvider} [provider]
|
|
88
|
-
* @returns {CredentialSource | undefined}
|
|
89
|
-
*/
|
|
90
|
-
export function classifyCredentialSource(rawValue, scope, provider) {
|
|
91
|
-
const trimmed = rawValue.trim();
|
|
92
|
-
if (trimmed.length === 0) {
|
|
93
|
-
return;
|
|
94
|
-
}
|
|
95
|
-
if (trimmed.startsWith("!")) {
|
|
96
|
-
return { kind: "command", provider, rawValue: trimmed, scope };
|
|
97
|
-
}
|
|
98
|
-
if (trimmed.includes("$")) {
|
|
99
|
-
return { kind: "env", provider, rawValue: trimmed, scope };
|
|
100
|
-
}
|
|
101
|
-
return { kind: "literal", provider, rawValue: trimmed, scope };
|
|
102
|
-
}
|
|
103
|
-
/**
|
|
104
|
-
* @param {AgentBrowserConfig} config
|
|
105
|
-
* @returns {Required<BrowserDefaultProfileConfig> | undefined}
|
|
106
|
-
*/
|
|
107
|
-
function getBrowserDefaultProfile(config) {
|
|
108
|
-
const profile = config.browser?.defaultProfile;
|
|
109
|
-
if (!profile || profile.name.trim().length === 0) {
|
|
110
|
-
return;
|
|
111
|
-
}
|
|
112
|
-
return { name: profile.name.trim(), policy: profile.policy ?? "authenticated-only" };
|
|
113
|
-
}
|
|
114
|
-
/** @param {AgentBrowserConfig} config */
|
|
115
|
-
function getBrowserExecutablePath(config) {
|
|
116
|
-
const executablePath = config.browser?.executablePath?.trim();
|
|
117
|
-
return executablePath !== undefined && executablePath.length > 0 ? executablePath : undefined;
|
|
118
|
-
}
|
|
119
|
-
/**
|
|
120
|
-
* @param {readonly ConfigLayer[]} layers
|
|
121
|
-
* @returns {ConfigLayerScope | undefined}
|
|
122
|
-
*/
|
|
123
|
-
function getBrowserDefaultProfileScope(layers) {
|
|
124
|
-
for (let index = layers.length - 1; index >= 0; index -= 1) {
|
|
125
|
-
const layer = layers.at(index);
|
|
126
|
-
if (layer?.config.browser?.defaultProfile !== undefined) {
|
|
127
|
-
return layer.scope;
|
|
128
|
-
}
|
|
129
|
-
}
|
|
130
|
-
return;
|
|
131
|
-
}
|
|
132
|
-
/**
|
|
133
|
-
* @param {readonly ConfigLayer[]} layers
|
|
134
|
-
* @returns {ConfigLayerScope | undefined}
|
|
135
|
-
*/
|
|
136
|
-
function getBrowserExecutablePathScope(layers) {
|
|
137
|
-
for (let index = layers.length - 1; index >= 0; index -= 1) {
|
|
138
|
-
const layer = layers.at(index);
|
|
139
|
-
if (layer?.config.browser?.executablePath !== undefined) {
|
|
140
|
-
return layer.scope;
|
|
141
|
-
}
|
|
142
|
-
}
|
|
143
|
-
return;
|
|
144
|
-
}
|
|
145
|
-
/**
|
|
146
|
-
* @param {readonly ConfigLayer[]} layers
|
|
147
|
-
* @returns {{ profile: Required<BrowserDefaultProfileConfig>; scope: ConfigLayerScope } | undefined}
|
|
148
|
-
*/
|
|
149
|
-
function getTrustedBrowserDefaultProfile(layers) {
|
|
150
|
-
for (let index = layers.length - 1; index >= 0; index -= 1) {
|
|
151
|
-
const layer = layers.at(index);
|
|
152
|
-
if (!layer) {
|
|
153
|
-
continue;
|
|
154
|
-
}
|
|
155
|
-
const profile = getBrowserDefaultProfile(layer.config);
|
|
156
|
-
if (profile) {
|
|
157
|
-
return { profile, scope: layer.scope };
|
|
158
|
-
}
|
|
159
|
-
}
|
|
160
|
-
return;
|
|
161
|
-
}
|
|
162
|
-
/**
|
|
163
|
-
* @param {readonly ConfigLayer[]} layers
|
|
164
|
-
* @returns {{ executablePath: string; scope: ConfigLayerScope } | undefined}
|
|
165
|
-
*/
|
|
166
|
-
function getTrustedBrowserExecutablePath(layers) {
|
|
167
|
-
for (let index = layers.length - 1; index >= 0; index -= 1) {
|
|
168
|
-
const layer = layers.at(index);
|
|
169
|
-
if (!layer) {
|
|
170
|
-
continue;
|
|
171
|
-
}
|
|
172
|
-
const executablePath = getBrowserExecutablePath(layer.config);
|
|
173
|
-
if (executablePath !== undefined && executablePath.length > 0) {
|
|
174
|
-
return { executablePath, scope: layer.scope };
|
|
175
|
-
}
|
|
176
|
-
}
|
|
177
|
-
return;
|
|
178
|
-
}
|
|
179
|
-
/**
|
|
180
|
-
* @param {readonly ConfigLayer[]} layers
|
|
181
|
-
* @param {WebSearchProviderConfigKey} key
|
|
182
|
-
* @returns {AgentBrowserConfigScope}
|
|
183
|
-
*/
|
|
184
|
-
function getWebSearchCredentialScope(layers, key) {
|
|
185
|
-
for (let index = layers.length - 1; index >= 0; index -= 1) {
|
|
186
|
-
const layer = layers.at(index);
|
|
187
|
-
if (layer?.config.webSearch?.[key] !== undefined) {
|
|
188
|
-
return layer.scope;
|
|
189
|
-
}
|
|
190
|
-
}
|
|
191
|
-
return "global";
|
|
192
|
-
}
|
|
193
|
-
/**
|
|
194
|
-
* @param {{ readonly env: NodeJS.ProcessEnv; readonly layers: readonly ConfigLayer[]; readonly mergedConfig: AgentBrowserConfig }} options
|
|
195
|
-
* @returns {Partial<Record<WebSearchProvider, CredentialSource>>}
|
|
196
|
-
*/
|
|
197
|
-
export function buildWebSearchCredentialSources(options) {
|
|
198
|
-
/** @type {Partial<Record<WebSearchProvider, CredentialSource>>} */
|
|
199
|
-
const sources = {};
|
|
200
|
-
for (const provider of WEB_SEARCH_PROVIDERS) {
|
|
201
|
-
const descriptor = getWebSearchProviderDescriptor(provider);
|
|
202
|
-
const apiKey = options.mergedConfig.webSearch?.[descriptor.configKey];
|
|
203
|
-
if (apiKey !== undefined) {
|
|
204
|
-
sources[provider] = classifyCredentialSource(apiKey, getWebSearchCredentialScope(options.layers, descriptor.configKey), provider);
|
|
205
|
-
}
|
|
206
|
-
if (!sources[provider] && (options.env[descriptor.apiKeyEnv]?.trim().length ?? 0) > 0) {
|
|
207
|
-
sources[provider] = {
|
|
208
|
-
kind: "literal",
|
|
209
|
-
provider,
|
|
210
|
-
rawValue: options.env[descriptor.apiKeyEnv] ?? "",
|
|
211
|
-
scope: "env-fallback",
|
|
212
|
-
};
|
|
213
|
-
}
|
|
214
|
-
}
|
|
215
|
-
return sources;
|
|
216
|
-
}
|
|
217
|
-
/**
|
|
218
|
-
* @param {{ readonly env: NodeJS.ProcessEnv; readonly layers: readonly ConfigLayer[]; readonly mergedConfig: AgentBrowserConfig; readonly paths: AgentBrowserConfigPaths; readonly errors: readonly string[]; readonly warnings: readonly string[]; readonly projectConfigIncluded?: boolean }} options
|
|
219
|
-
* @returns {AgentBrowserConfigState}
|
|
220
|
-
*/
|
|
221
|
-
export function buildAgentBrowserConfigState(options) {
|
|
222
|
-
const webSearchCredentialSources = buildWebSearchCredentialSources(options);
|
|
223
|
-
const trustedBrowserDefaultProfile = getTrustedBrowserDefaultProfile(options.layers);
|
|
224
|
-
const trustedBrowserExecutablePath = getTrustedBrowserExecutablePath(options.layers);
|
|
225
|
-
return {
|
|
226
|
-
browserDefaultProfile: getBrowserDefaultProfile(options.mergedConfig),
|
|
227
|
-
browserDefaultProfileScope: getBrowserDefaultProfileScope(options.layers),
|
|
228
|
-
browserExecutablePath: getBrowserExecutablePath(options.mergedConfig),
|
|
229
|
-
browserExecutablePathScope: getBrowserExecutablePathScope(options.layers),
|
|
230
|
-
trustedBrowserDefaultProfile: trustedBrowserDefaultProfile?.profile,
|
|
231
|
-
trustedBrowserDefaultProfileScope: trustedBrowserDefaultProfile?.scope,
|
|
232
|
-
trustedBrowserExecutablePath: trustedBrowserExecutablePath?.executablePath,
|
|
233
|
-
trustedBrowserExecutablePathScope: trustedBrowserExecutablePath?.scope,
|
|
234
|
-
config: options.mergedConfig,
|
|
235
|
-
webSearchCredentialSources,
|
|
236
|
-
webSearchEnabled: options.mergedConfig.webSearch?.enabled !== false,
|
|
237
|
-
webSearchPreferredProvider: options.mergedConfig.webSearch?.preferredProvider ?? DEFAULT_WEB_SEARCH_PROVIDER,
|
|
238
|
-
errors: options.errors,
|
|
239
|
-
layers: options.layers,
|
|
240
|
-
paths: options.paths,
|
|
241
|
-
projectConfigIncluded: options.projectConfigIncluded ?? options.layers.some((layer) => layer.scope === "project"),
|
|
242
|
-
warnings: options.warnings,
|
|
243
|
-
};
|
|
244
|
-
}
|
|
245
|
-
/**
|
|
246
|
-
* @param {string} path
|
|
247
|
-
* @param {ConfigLayerScope} scope
|
|
248
|
-
* @param {import("./config-validation.js").ConfigDiagnostics} errors
|
|
249
|
-
* @param {import("./config-validation.js").ConfigDiagnostics} warnings
|
|
250
|
-
* @returns {ConfigLayer | undefined}
|
|
251
|
-
*/
|
|
252
|
-
function readConfigLayerSync(path, scope, errors, warnings) {
|
|
253
|
-
let raw;
|
|
254
|
-
try {
|
|
255
|
-
raw = readFileSync(path, "utf8");
|
|
256
|
-
}
|
|
257
|
-
catch (error) {
|
|
258
|
-
if (error !== null && typeof error === "object" && "code" in error && error.code === "ENOENT") {
|
|
259
|
-
return;
|
|
260
|
-
}
|
|
261
|
-
errors.push(`Could not read ${scope} config ${path}: ${error instanceof Error ? error.message : describeUnknownError(error)}`);
|
|
262
|
-
return;
|
|
263
|
-
}
|
|
264
|
-
return parseAgentBrowserConfigLayer(raw, path, scope, errors, warnings);
|
|
265
|
-
}
|
|
266
|
-
/**
|
|
267
|
-
* @param {AgentBrowserConfigLoadOptions} [options]
|
|
268
|
-
* @returns {AgentBrowserConfigState}
|
|
269
|
-
*/
|
|
270
|
-
export function loadAgentBrowserConfigStateSync(options = {}) {
|
|
271
|
-
const env = options.env ?? process.env;
|
|
272
|
-
const paths = getAgentBrowserConfigPaths({ cwd: options.cwd, env });
|
|
273
|
-
const includeProjectConfig = options.includeProjectConfig !== false;
|
|
274
|
-
/** @type {string[]} */
|
|
275
|
-
const errors = [];
|
|
276
|
-
/** @type {string[]} */
|
|
277
|
-
const warnings = [];
|
|
278
|
-
/** @type {Array<{ path: string; scope: ConfigLayerScope }>} */
|
|
279
|
-
const layerCandidates = [{ path: paths.global, scope: "global" }];
|
|
280
|
-
if (includeProjectConfig) {
|
|
281
|
-
layerCandidates.push({ path: paths.project, scope: "project" });
|
|
282
|
-
}
|
|
283
|
-
if (paths.override !== undefined && paths.override.length > 0) {
|
|
284
|
-
layerCandidates.push({ path: paths.override, scope: "override" });
|
|
285
|
-
}
|
|
286
|
-
/** @type {ConfigLayer[]} */
|
|
287
|
-
const layers = [];
|
|
288
|
-
/** @type {AgentBrowserConfig} */
|
|
289
|
-
let mergedConfig = {};
|
|
290
|
-
for (const candidate of layerCandidates) {
|
|
291
|
-
const layer = readConfigLayerSync(candidate.path, candidate.scope, errors, warnings);
|
|
292
|
-
if (!layer) {
|
|
293
|
-
continue;
|
|
294
|
-
}
|
|
295
|
-
layers.push(layer);
|
|
296
|
-
mergedConfig = mergeAgentBrowserConfig(mergedConfig, layer.config);
|
|
297
|
-
}
|
|
298
|
-
return buildAgentBrowserConfigState({
|
|
299
|
-
env,
|
|
300
|
-
errors,
|
|
301
|
-
layers,
|
|
302
|
-
mergedConfig,
|
|
303
|
-
paths,
|
|
304
|
-
projectConfigIncluded: includeProjectConfig,
|
|
305
|
-
warnings,
|
|
306
|
-
});
|
|
307
|
-
}
|
|
308
|
-
/**
|
|
309
|
-
* @param {string} rawValue
|
|
310
|
-
* @param {NodeJS.ProcessEnv} env
|
|
311
|
-
*/
|
|
312
|
-
export function resolveEnvInterpolations(rawValue, env) {
|
|
313
|
-
let output = "";
|
|
314
|
-
for (let index = 0; index < rawValue.length; index += 1) {
|
|
315
|
-
const char = rawValue[index];
|
|
316
|
-
if (char !== "$") {
|
|
317
|
-
output += char;
|
|
318
|
-
continue;
|
|
319
|
-
}
|
|
320
|
-
const next = rawValue[index + 1];
|
|
321
|
-
if (next === "$" || next === "!") {
|
|
322
|
-
output += next;
|
|
323
|
-
index += 1;
|
|
324
|
-
continue;
|
|
325
|
-
}
|
|
326
|
-
let name = "";
|
|
327
|
-
if (next === "{") {
|
|
328
|
-
const end = rawValue.indexOf("}", index + 2);
|
|
329
|
-
if (end === -1) {
|
|
330
|
-
return;
|
|
331
|
-
}
|
|
332
|
-
name = rawValue.slice(index + 2, end);
|
|
333
|
-
index = end;
|
|
334
|
-
}
|
|
335
|
-
else {
|
|
336
|
-
const match = rawValue.slice(index + 1).match(/^([A-Za-z_][A-Za-z0-9_]*)/);
|
|
337
|
-
if (!match) {
|
|
338
|
-
output += "$";
|
|
339
|
-
continue;
|
|
340
|
-
}
|
|
341
|
-
name = match[1];
|
|
342
|
-
index += name.length;
|
|
343
|
-
}
|
|
344
|
-
if (name.length === 0) {
|
|
345
|
-
return;
|
|
346
|
-
}
|
|
347
|
-
const value = env[name];
|
|
348
|
-
if (value === undefined) {
|
|
349
|
-
return;
|
|
350
|
-
}
|
|
351
|
-
output += value;
|
|
352
|
-
}
|
|
353
|
-
return output;
|
|
354
|
-
}
|
|
355
|
-
/**
|
|
356
|
-
* @param {AgentBrowserConfigState} state
|
|
357
|
-
* @param {WebSearchProvider | "auto"} [requestedProvider]
|
|
358
|
-
* @returns {WebSearchProvider[]}
|
|
359
|
-
*/
|
|
360
|
-
export function getWebSearchProviderOrder(state, requestedProvider) {
|
|
361
|
-
if (requestedProvider !== undefined && requestedProvider !== "auto") {
|
|
362
|
-
return [requestedProvider];
|
|
363
|
-
}
|
|
364
|
-
const preferred = state.webSearchPreferredProvider;
|
|
365
|
-
return [preferred, ...WEB_SEARCH_PROVIDERS.filter((provider) => provider !== preferred)];
|
|
366
|
-
}
|
|
367
|
-
/**
|
|
368
|
-
* @param {AgentBrowserConfigState} state
|
|
369
|
-
* @param {WebSearchProvider} provider
|
|
370
|
-
*/
|
|
371
|
-
export function getWebSearchCredentialSource(state, provider) {
|
|
372
|
-
return state.webSearchCredentialSources[provider];
|
|
373
|
-
}
|
|
374
|
-
/**
|
|
375
|
-
* @param {CredentialSource | undefined} source
|
|
376
|
-
* @param {NodeJS.ProcessEnv} env
|
|
377
|
-
*/
|
|
378
|
-
export function hasPotentialCredentialSource(source, env) {
|
|
379
|
-
if (!source) {
|
|
380
|
-
return false;
|
|
381
|
-
}
|
|
382
|
-
if (source.kind === "command") {
|
|
383
|
-
return true;
|
|
384
|
-
}
|
|
385
|
-
if (source.kind === "env") {
|
|
386
|
-
return Boolean(resolveEnvInterpolations(source.rawValue, env)?.trim());
|
|
387
|
-
}
|
|
388
|
-
return Boolean(source.rawValue.trim());
|
|
389
|
-
}
|
|
390
|
-
/**
|
|
391
|
-
* @param {AgentBrowserConfigState} state
|
|
392
|
-
* @param {NodeJS.ProcessEnv} [env]
|
|
393
|
-
*/
|
|
394
|
-
export function canRegisterWebSearchTool(state, env = process.env) {
|
|
395
|
-
if (!state.webSearchEnabled || state.errors.length > 0) {
|
|
396
|
-
return false;
|
|
397
|
-
}
|
|
398
|
-
return WEB_SEARCH_PROVIDERS.some((provider) => hasPotentialCredentialSource(state.webSearchCredentialSources[provider], env));
|
|
399
|
-
}
|
|
400
|
-
/**
|
|
401
|
-
* @param {CredentialSource | undefined} source
|
|
402
|
-
* @param {WebSearchProvider} [provider]
|
|
403
|
-
*/
|
|
404
|
-
export function getCredentialSourceSummary(source, provider) {
|
|
405
|
-
if (!source) {
|
|
406
|
-
return "not configured";
|
|
407
|
-
}
|
|
408
|
-
if (source.kind === "command") {
|
|
409
|
-
return `configured via command (${source.scope})`;
|
|
410
|
-
}
|
|
411
|
-
if (source.kind === "env") {
|
|
412
|
-
return `configured via environment interpolation (${source.scope})`;
|
|
413
|
-
}
|
|
414
|
-
if (source.scope === "env-fallback") {
|
|
415
|
-
return `configured via ${getWebSearchProviderEnvVar(provider ?? source.provider ?? DEFAULT_WEB_SEARCH_PROVIDER)} environment fallback`;
|
|
416
|
-
}
|
|
417
|
-
return `configured as plaintext ${source.scope} value [redacted]`;
|
|
418
|
-
}
|
|
419
|
-
/** @param {AgentBrowserConfigState} state */
|
|
420
|
-
export function formatBrowserProfileStatus(state) {
|
|
421
|
-
const profile = state.browserDefaultProfile;
|
|
422
|
-
if (!profile) {
|
|
423
|
-
return "not configured";
|
|
424
|
-
}
|
|
425
|
-
const scope = state.browserDefaultProfileScope ?? "unknown";
|
|
426
|
-
return `${profile.name} (policy: ${profile.policy}; ${scope})`;
|
|
427
|
-
}
|
|
428
|
-
/** @param {AgentBrowserConfigState} state */
|
|
429
|
-
export function formatBrowserExecutableStatus(state) {
|
|
430
|
-
const executablePath = state.browserExecutablePath;
|
|
431
|
-
if (executablePath === undefined || executablePath.length === 0) {
|
|
432
|
-
return "not configured";
|
|
433
|
-
}
|
|
434
|
-
const scope = state.browserExecutablePathScope ?? "unknown";
|
|
435
|
-
return `${executablePath} (${scope})`;
|
|
436
|
-
}
|
|
437
|
-
/**
|
|
438
|
-
* @param {AgentBrowserConfigState} state
|
|
439
|
-
* @param {(path: string) => boolean} [exists]
|
|
440
|
-
* @returns {ConfigFileSummary[]}
|
|
441
|
-
*/
|
|
442
|
-
export function summarizeConfigFiles(state, exists = existsSync) {
|
|
443
|
-
return [
|
|
444
|
-
["global", state.paths.global],
|
|
445
|
-
["project", state.paths.project],
|
|
446
|
-
...(state.paths.override !== undefined && state.paths.override.length > 0
|
|
447
|
-
? [["override", state.paths.override]]
|
|
448
|
-
: []),
|
|
449
|
-
].map(([scope, path]) => ({ scope, path, exists: exists(path) }));
|
|
450
|
-
}
|
|
@@ -1,71 +0,0 @@
|
|
|
1
|
-
// @ts-check
|
|
2
|
-
/** @typedef {"exa" | "brave"} WebSearchProvider */
|
|
3
|
-
/** @typedef {"auto" | "fast" | "instant" | "deep-lite" | "deep" | "deep-reasoning"} ExaSearchType */
|
|
4
|
-
/** @typedef {"exaApiKey" | "braveApiKey"} WebSearchProviderConfigKey */
|
|
5
|
-
/** @typedef {{ readonly provider: WebSearchProvider; readonly apiKeyEnv: string; readonly configKey: WebSearchProviderConfigKey; readonly label: string }} WebSearchProviderDescriptor */
|
|
6
|
-
export const BRAVE_API_KEY_ENV = "BRAVE_API_KEY";
|
|
7
|
-
export const EXA_API_KEY_ENV = "EXA_API_KEY";
|
|
8
|
-
/** @type {Readonly<Record<WebSearchProvider, WebSearchProviderDescriptor>>} */
|
|
9
|
-
export const WEB_SEARCH_PROVIDER_DESCRIPTORS = Object.freeze({
|
|
10
|
-
exa: Object.freeze({
|
|
11
|
-
provider: "exa",
|
|
12
|
-
apiKeyEnv: EXA_API_KEY_ENV,
|
|
13
|
-
configKey: "exaApiKey",
|
|
14
|
-
label: "Exa",
|
|
15
|
-
}),
|
|
16
|
-
brave: Object.freeze({
|
|
17
|
-
provider: "brave",
|
|
18
|
-
apiKeyEnv: BRAVE_API_KEY_ENV,
|
|
19
|
-
configKey: "braveApiKey",
|
|
20
|
-
label: "Brave Search",
|
|
21
|
-
}),
|
|
22
|
-
});
|
|
23
|
-
/** @type {readonly WebSearchProvider[]} */
|
|
24
|
-
export const WEB_SEARCH_PROVIDERS = Object.freeze(["exa", "brave"]);
|
|
25
|
-
/** @type {WebSearchProvider} */
|
|
26
|
-
export const DEFAULT_WEB_SEARCH_PROVIDER = "exa";
|
|
27
|
-
/** @type {readonly ExaSearchType[]} */
|
|
28
|
-
export const EXA_SEARCH_TYPES = Object.freeze([
|
|
29
|
-
"auto",
|
|
30
|
-
"fast",
|
|
31
|
-
"instant",
|
|
32
|
-
"deep-lite",
|
|
33
|
-
"deep",
|
|
34
|
-
"deep-reasoning",
|
|
35
|
-
]);
|
|
36
|
-
/** @type {Readonly<Record<WebSearchProvider, WebSearchProviderConfigKey>>} */
|
|
37
|
-
export const WEB_SEARCH_PROVIDER_CONFIG_KEYS = Object.freeze({
|
|
38
|
-
exa: WEB_SEARCH_PROVIDER_DESCRIPTORS.exa.configKey,
|
|
39
|
-
brave: WEB_SEARCH_PROVIDER_DESCRIPTORS.brave.configKey,
|
|
40
|
-
});
|
|
41
|
-
/** @type {Readonly<Record<WebSearchProvider, string>>} */
|
|
42
|
-
export const WEB_SEARCH_PROVIDER_ENV_VARS = Object.freeze({
|
|
43
|
-
exa: WEB_SEARCH_PROVIDER_DESCRIPTORS.exa.apiKeyEnv,
|
|
44
|
-
brave: WEB_SEARCH_PROVIDER_DESCRIPTORS.brave.apiKeyEnv,
|
|
45
|
-
});
|
|
46
|
-
/** @param {unknown} value
|
|
47
|
-
* @returns {value is WebSearchProvider} */
|
|
48
|
-
export function isWebSearchProvider(value) {
|
|
49
|
-
return value === "exa" || value === "brave";
|
|
50
|
-
}
|
|
51
|
-
/** @param {string} provider
|
|
52
|
-
* @returns {WebSearchProviderDescriptor} */
|
|
53
|
-
export function getWebSearchProviderDescriptor(provider) {
|
|
54
|
-
if (!isWebSearchProvider(provider)) {
|
|
55
|
-
throw new Error(`Unknown web-search provider: ${provider}`);
|
|
56
|
-
}
|
|
57
|
-
return WEB_SEARCH_PROVIDER_DESCRIPTORS[provider];
|
|
58
|
-
}
|
|
59
|
-
/** @param {WebSearchProvider} provider */
|
|
60
|
-
export function getWebSearchProviderLabel(provider) {
|
|
61
|
-
return getWebSearchProviderDescriptor(provider).label;
|
|
62
|
-
}
|
|
63
|
-
/** @param {WebSearchProvider} provider */
|
|
64
|
-
export function getWebSearchProviderEnvVar(provider) {
|
|
65
|
-
return getWebSearchProviderDescriptor(provider).apiKeyEnv;
|
|
66
|
-
}
|
|
67
|
-
/** @param {WebSearchProvider} provider
|
|
68
|
-
* @returns {WebSearchProviderConfigKey} */
|
|
69
|
-
export function getWebSearchProviderConfigKey(provider) {
|
|
70
|
-
return getWebSearchProviderDescriptor(provider).configKey;
|
|
71
|
-
}
|