agent-device 0.21.37 → 0.21.38
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/android/ime-helper/dist/{agent-device-android-ime-helper-0.21.37.apk → agent-device-android-ime-helper-0.21.38.apk} +0 -0
- package/android/ime-helper/dist/agent-device-android-ime-helper-0.21.38.apk.sha256 +1 -0
- package/android/ime-helper/dist/{agent-device-android-ime-helper-0.21.37.manifest.json → agent-device-android-ime-helper-0.21.38.manifest.json} +4 -4
- package/android/snapshot-helper/dist/{agent-device-android-snapshot-helper-0.21.37.apk → agent-device-android-snapshot-helper-0.21.38.apk} +0 -0
- package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.38.apk.sha256 +1 -0
- package/android/snapshot-helper/dist/{agent-device-android-snapshot-helper-0.21.37.manifest.json → agent-device-android-snapshot-helper-0.21.38.manifest.json} +7 -7
- package/apple/fold-helper/Fold.m +8 -4
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerKeyboardReturnKey.swift +53 -0
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+AXSnapshotFallback.swift +42 -4
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+CommandExecution.swift +26 -18
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Interaction.swift +42 -11
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Keyboard.swift +123 -22
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Models.swift +7 -0
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Navigation.swift +570 -53
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests.swift +41 -0
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerXCTestEventBridge.h +7 -0
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerXCTestEventBridge.m +17 -1
- package/dist/src/THIRD_PARTY_NOTICES.txt +2 -2
- package/dist/src/absence-observation-errors.js +1 -1
- package/dist/src/absence-observation.js +1 -1
- package/dist/src/adapter.js +1 -1
- package/dist/src/adb-executor.js +1 -1
- package/dist/src/adb-failure.js +2 -2
- package/dist/src/adb-transport.js +1 -1
- package/dist/src/agent-browser-lifecycle.js +1 -1
- package/dist/src/agent-browser-process-record.js +1 -1
- package/dist/src/agent-browser-provider.js +1 -1
- package/dist/src/agent-browser-tool.js +1 -1
- package/dist/src/ai-sdk.d.ts +1 -1
- package/dist/src/ai-sdk.js +1 -1
- package/dist/src/alert-contract.js +1 -1
- package/dist/src/alert-tree-driver.js +1 -1
- package/dist/src/alert.js +1 -1
- package/dist/src/android-adb.d.ts +1 -1
- package/dist/src/android.js +1 -1
- package/dist/src/android2.js +1 -1
- package/dist/src/app-backend.js +1 -1
- package/dist/src/app-catalog.js +1 -1
- package/dist/src/app-deployment-resolution.js +1 -1
- package/dist/src/app-inventory.js +1 -1
- package/dist/src/app-launch.js +1 -1
- package/dist/src/app-lifecycle.js +4 -4
- package/dist/src/app-lifecycle2.js +2 -2
- package/dist/src/app-log-files.js +1 -1
- package/dist/src/app-log-runtime2.js +2 -2
- package/dist/src/app-log-session-resource.js +1 -1
- package/dist/src/app-resolution.js +1 -1
- package/dist/src/app-state-read.js +1 -1
- package/dist/src/app-state-runtime.d.ts +1 -1
- package/dist/src/application-lifecycle-interaction.js +1 -1
- package/dist/src/archive.js +1 -1
- package/dist/src/args.js +1 -1
- package/dist/src/artifact-download.js +1 -1
- package/dist/src/artifact-tracking.js +1 -1
- package/dist/src/auth-session.js +1 -1
- package/dist/src/auth.js +1 -1
- package/dist/src/automation-helper-artifact.js +1 -1
- package/dist/src/automation-helper.js +1 -1
- package/dist/src/await-with-signal.js +1 -1
- package/dist/src/backend-snapshot-options.js +1 -1
- package/dist/src/boot-diagnostics.js +1 -1
- package/dist/src/bridge-source.js +1 -1
- package/dist/src/browser-launch.js +1 -1
- package/dist/src/browserstack-device-features.js +1 -1
- package/dist/src/browserstack.js +1 -1
- package/dist/src/cache.js +1 -1
- package/dist/src/capture-disclosure.js +1 -1
- package/dist/src/capture-lifecycle.js +1 -1
- package/dist/src/cli-config.js +1 -1
- package/dist/src/cli-help.js +19 -16
- package/dist/src/cli-output.js +11 -11
- package/dist/src/cli-runner.js +1 -1
- package/dist/src/cli.js +2 -2
- package/dist/src/click-button.js +1 -1
- package/dist/src/client-metro-companion.js +1 -1
- package/dist/src/client-metro.js +1 -1
- package/dist/src/client-options.js +1 -1
- package/dist/src/client-port.d.ts +246 -208
- package/dist/src/clipboard-shell-response.js +1 -1
- package/dist/src/cloud-artifacts.d.ts +7 -2
- package/dist/src/code-signature-cache.js +1 -1
- package/dist/src/command-schema.js +6 -4
- package/dist/src/command-tools.js +3 -3
- package/dist/src/command.js +1 -1
- package/dist/src/composed-inventory-gateways.js +1 -1
- package/dist/src/composite-resource-admission.js +1 -1
- package/dist/src/config.js +1 -1
- package/dist/src/connection-lease-transaction.js +1 -1
- package/dist/src/connection-metro-runtime.js +1 -1
- package/dist/src/connection-runtime.js +1 -1
- package/dist/src/connection-verification.js +1 -1
- package/dist/src/connection.js +3 -3
- package/dist/src/context.js +1 -1
- package/dist/src/contract.d.ts +2 -1
- package/dist/src/contracts.d.ts +1 -1
- package/dist/src/contracts.js +1 -1
- package/dist/src/daemon-client-attach.js +1 -1
- package/dist/src/daemon-client-dispatch-disclosure.js +1 -1
- package/dist/src/daemon-client-ensure.js +1 -1
- package/dist/src/daemon-client-ensuring.js +1 -1
- package/dist/src/daemon-client-lease-beat.js +1 -1
- package/dist/src/daemon-client-lifecycle.js +1 -1
- package/dist/src/daemon-client-liveness-probe.js +1 -1
- package/dist/src/daemon-client-remote-health-cache.js +1 -0
- package/dist/src/daemon-client-remote-health-recovery.js +1 -0
- package/dist/src/daemon-client-transport.js +1 -1
- package/dist/src/daemon-command-registry.js +1 -1
- package/dist/src/daemon-composition.js +1 -1
- package/dist/src/daemon-diagnostics-scope.js +1 -1
- package/dist/src/daemon-http.js +1 -1
- package/dist/src/daemon-launch-spec.js +1 -1
- package/dist/src/daemon-lifecycle-errors.js +1 -1
- package/dist/src/daemon-policy-file.js +1 -1
- package/dist/src/daemon-registration-owner.js +3 -3
- package/dist/src/daemon-registration.js +1 -1
- package/dist/src/daemon-resolution.js +1 -1
- package/dist/src/daemon-startup-diagnostics.js +1 -1
- package/dist/src/daemon-stop.js +1 -1
- package/dist/src/daemon.js +1 -1
- package/dist/src/debug-symbols-facade.js +3 -3
- package/dist/src/device-claim-admission.js +1 -0
- package/dist/src/device-claim-reconciliation.js +1 -0
- package/dist/src/device-claim-recovery.js +1 -1
- package/dist/src/device-claim-rule.js +1 -1
- package/dist/src/device-claims.js +1 -1
- package/dist/src/device-input-state.d.ts +1 -1
- package/dist/src/device-inventory-context.js +1 -1
- package/dist/src/device-selection-resolver.js +1 -1
- package/dist/src/device-session.js +1 -1
- package/dist/src/device-shell.js +1 -1
- package/dist/src/device.js +1 -1
- package/dist/src/device3.js +3 -3
- package/dist/src/devicectl.js +1 -1
- package/dist/src/diagnostics.js +1 -1
- package/dist/src/discovery.js +1 -1
- package/dist/src/dispatch-resolve.js +1 -1
- package/dist/src/display-inventory.js +1 -1
- package/dist/src/doctor-facade.js +1 -1
- package/dist/src/doctor2.js +1 -1
- package/dist/src/durable-capture-resource.js +1 -1
- package/dist/src/durable-capture.js +1 -1
- package/dist/src/durable-resource.js +1 -1
- package/dist/src/ended-lease.js +1 -1
- package/dist/src/engine-eval-script.js +1 -1
- package/dist/src/error.js +2 -2
- package/dist/src/errors.js +1 -1
- package/dist/src/explicit-session-resolution.js +1 -1
- package/dist/src/expo-dev-client-launch.js +1 -1
- package/dist/src/failure-output.js +1 -1
- package/dist/src/file.js +1 -1
- package/dist/src/find.js +1 -1
- package/dist/src/finders.js +1 -1
- package/dist/src/flag-registry.js +1 -1
- package/dist/src/focus-runtime.js +1 -1
- package/dist/src/fold-helper.js +1 -1
- package/dist/src/generic-settle.js +1 -1
- package/dist/src/generic.js +1 -1
- package/dist/src/gesture-admission.js +1 -1
- package/dist/src/gesture-plan-types.d.ts +1 -1
- package/dist/src/gesture-plan.js +1 -1
- package/dist/src/gesture-runtime.js +1 -1
- package/dist/src/hdc.js +1 -1
- package/dist/src/helper-artifacts.js +1 -1
- package/dist/src/helper.js +2 -2
- package/dist/src/host-file.js +1 -1
- package/dist/src/host.js +1 -1
- package/dist/src/host2.js +1 -1
- package/dist/src/host3.js +1 -1
- package/dist/src/host4.js +1 -1
- package/dist/src/host5.js +1 -1
- package/dist/src/host6.js +1 -1
- package/dist/src/human-control-contract.js +1 -1
- package/dist/src/human-control.js +1 -1
- package/dist/src/ime-rebind.js +1 -1
- package/dist/src/ime-settings-record.js +1 -1
- package/dist/src/ime-state.js +1 -1
- package/dist/src/index.d.ts +3 -3
- package/dist/src/index.js +1 -1
- package/dist/src/input-actions.js +1 -1
- package/dist/src/input-actions2.js +1 -1
- package/dist/src/install-artifact-facade.js +1 -1
- package/dist/src/install-source-network-transport.js +1 -1
- package/dist/src/install-source2.js +1 -1
- package/dist/src/interaction-error.js +1 -1
- package/dist/src/interaction-positionals.js +1 -1
- package/dist/src/interaction-ref-policy.js +1 -1
- package/dist/src/interaction2.js +1 -1
- package/dist/src/interactor-operation-binding.js +1 -1
- package/dist/src/interactor.js +5 -5
- package/dist/src/interactor2.js +1 -1
- package/dist/src/interactor3.js +1 -1
- package/dist/src/interactor4.js +1 -1
- package/dist/src/interactor5.js +1 -1
- package/dist/src/interactors.js +1 -1
- package/dist/src/internal/bin.js +1 -1
- package/dist/src/internal/companion-tunnel.js +1 -1
- package/dist/src/internal/daemon.js +1 -1
- package/dist/src/internal/png-worker.js +1 -1
- package/dist/src/internal/run-script-child.js +1 -1
- package/dist/src/inventory.js +1 -1
- package/dist/src/inventory2.js +1 -1
- package/dist/src/inventory3.js +1 -1
- package/dist/src/inventory5.js +1 -1
- package/dist/src/ios-node-interpretation.js +1 -1
- package/dist/src/ios-simulator-accessibility.js +1 -1
- package/dist/src/ios-snapshot-acquisition.js +1 -1
- package/dist/src/ios-snapshot-engine.js +1 -1
- package/dist/src/ios-snapshot-runtime.js +1 -1
- package/dist/src/launch-confirmation.js +1 -1
- package/dist/src/launch-services-registration.js +1 -1
- package/dist/src/lease-context.js +1 -1
- package/dist/src/lease-registry-scope.js +1 -1
- package/dist/src/lease-release2.js +1 -1
- package/dist/src/lease-scope.js +1 -1
- package/dist/src/lease.js +1 -1
- package/dist/src/leased-recording-retention.js +1 -1
- package/dist/src/legacy.js +1 -1
- package/dist/src/limrun-download-file.js +1 -1
- package/dist/src/limrun-ios-files.js +1 -1
- package/dist/src/limrun-ios-runner.js +2 -2
- package/dist/src/limrun-runtime-dependencies.js +1 -1
- package/dist/src/limrun.d.ts +1 -1
- package/dist/src/local-interactor-operation-set.js +1 -1
- package/dist/src/local-simulator-apps.js +1 -1
- package/dist/src/local-simulator-files.js +1 -1
- package/dist/src/location-coordinates.js +1 -1
- package/dist/src/manifest.js +1 -1
- package/dist/src/mechanics.js +12 -12
- package/dist/src/merge-flags.js +1 -1
- package/dist/src/metro-reload-endpoints.js +1 -1
- package/dist/src/metro-session-hints.js +1 -1
- package/dist/src/metro.d.ts +1 -1
- package/dist/src/mobile-snapshot-semantics.js +1 -1
- package/dist/src/network-traffic.js +1 -1
- package/dist/src/node-http.js +1 -1
- package/dist/src/node-touch-point.js +1 -1
- package/dist/src/observation.js +1 -1
- package/dist/src/open-script.js +1 -1
- package/dist/src/open-target-device-resolution.js +1 -1
- package/dist/src/orientation.js +1 -1
- package/dist/src/parameterized-recorded-fill.js +1 -1
- package/dist/src/perf-facade.js +1 -1
- package/dist/src/perf-runtime-operation-builder.js +1 -1
- package/dist/src/perf-runtime-plan.js +1 -1
- package/dist/src/perf-target.js +2 -2
- package/dist/src/perf.js +1 -1
- package/dist/src/physical-device-control.js +1 -1
- package/dist/src/platform-runtime-android-adb-host.js +1 -1
- package/dist/src/platform-runtime-app-log-process.js +1 -1
- package/dist/src/platform-runtime-apple-application-tools.js +1 -1
- package/dist/src/platform-runtime-claim-recovery.js +1 -1
- package/dist/src/platform-runtime-host.js +1 -1
- package/dist/src/platform-runtime-open-target.js +1 -1
- package/dist/src/platform-runtime-operation-host.js +3 -3
- package/dist/src/platform-runtime-runtime-hints.js +1 -1
- package/dist/src/platform-runtime-screen-recording-apple-runner-transport.js +1 -1
- package/dist/src/platform-runtime-screen-recording-apple-simulator-host.js +1 -1
- package/dist/src/platform-runtime-screen-recording-finalizer-host.js +1 -1
- package/dist/src/platform-runtime-screen-recording-process-host.js +1 -1
- package/dist/src/platform-runtime-shutdown-error.js +1 -1
- package/dist/src/platform-runtime-unavailable.js +1 -1
- package/dist/src/platform-runtime.js +1 -1
- package/dist/src/platform-runtime2.js +1 -1
- package/dist/src/plist.js +1 -1
- package/dist/src/plugins2.js +1 -1
- package/dist/src/png-crop-bytes.js +1 -1
- package/dist/src/png-resize.js +1 -1
- package/dist/src/png-size.js +1 -1
- package/dist/src/png-worker-client.js +1 -1
- package/dist/src/png.js +1 -1
- package/dist/src/post-gesture-stability.js +1 -1
- package/dist/src/process-executable-path.js +1 -0
- package/dist/src/process-exit.js +1 -1
- package/dist/src/provider-device-runtime.d.ts +2 -2
- package/dist/src/provider-limrun-credentials.js +1 -1
- package/dist/src/provider-plugin.d.ts +1 -1
- package/dist/src/provider-profile-fields.js +1 -1
- package/dist/src/provider-webdriver.js +1 -1
- package/dist/src/provider.js +1 -1
- package/dist/src/proxy.js +2 -2
- package/dist/src/react-devtools-connection.js +1 -1
- package/dist/src/react-devtools-inspect-command.js +1 -1
- package/dist/src/react-native-overlay2.js +2 -2
- package/dist/src/react-native.js +1 -1
- package/dist/src/react-profile-command.js +1 -1
- package/dist/src/record-runtime.js +1 -1
- package/dist/src/record-trace.js +1 -1
- package/dist/src/recording-gestures.js +1 -1
- package/dist/src/recording.js +1 -1
- package/dist/src/rect-center.js +1 -1
- package/dist/src/register-builtins.js +1 -1
- package/dist/src/registry.js +1 -1
- package/dist/src/remote-config-core.js +1 -1
- package/dist/src/remote-config-flags.js +1 -1
- package/dist/src/remote-connection-state.js +1 -1
- package/dist/src/replay-backend-host.js +1 -1
- package/dist/src/replay-divergence.js +1 -1
- package/dist/src/replay-maestro-backend.js +2 -2
- package/dist/src/replay.d.ts +1 -1
- package/dist/src/replay2.js +1 -1
- package/dist/src/reporting.js +1 -1
- package/dist/src/request-dispatch-disclosure.js +1 -1
- package/dist/src/request-ended-leases.js +1 -1
- package/dist/src/request-providers.js +1 -1
- package/dist/src/request-runtime-binding.js +1 -1
- package/dist/src/request.js +1 -1
- package/dist/src/result-serialization.js +2 -2
- package/dist/src/retry.js +1 -1
- package/dist/src/run-script-execution.js +6 -8
- package/dist/src/run-script-http.js +1 -1
- package/dist/src/runner-cache-metadata.js +1 -1
- package/dist/src/runner-cache-retention.js +1 -1
- package/dist/src/runner-client.js +1 -1
- package/dist/src/runner-contract.js +1 -1
- package/dist/src/runner-dev-tools-security.js +1 -1
- package/dist/src/runner-device-readiness.js +1 -1
- package/dist/src/runner-device-set.js +1 -1
- package/dist/src/runner-disposal.js +1 -1
- package/dist/src/runner-error-classification.js +2 -2
- package/dist/src/runner-exchange.js +1 -1
- package/dist/src/runner-io.js +1 -1
- package/dist/src/runner-launched-session.js +1 -1
- package/dist/src/runner-lease.js +1 -1
- package/dist/src/runner-lifecycle.js +1 -1
- package/dist/src/runner-operations-facade.js +1 -1
- package/dist/src/runner-panel.js +1 -1
- package/dist/src/runner-retention.js +1 -1
- package/dist/src/runner-runtime.js +1 -1
- package/dist/src/runner-selector-query.js +1 -1
- package/dist/src/runner-sequence.js +1 -1
- package/dist/src/runner-start-budget.js +1 -1
- package/dist/src/runner-startup-transport.js +1 -1
- package/dist/src/runner-toolchain-identity.js +1 -1
- package/dist/src/runtime-admission.js +1 -1
- package/dist/src/runtime-deployment.js +1 -1
- package/dist/src/runtime-factory.js +1 -1
- package/dist/src/runtime-session.js +1 -1
- package/dist/src/runtime-transport-hints.js +1 -1
- package/dist/src/runtime.js +2 -2
- package/dist/src/runtime10.js +1 -1
- package/dist/src/runtime11.js +1 -1
- package/dist/src/runtime12.js +1 -1
- package/dist/src/runtime13.js +2 -2
- package/dist/src/runtime2.js +2 -2
- package/dist/src/runtime4.js +3 -3
- package/dist/src/runtime5.js +1 -1
- package/dist/src/runtime6.js +1 -1
- package/dist/src/runtime7.js +2 -2
- package/dist/src/runtime8.js +1 -1
- package/dist/src/runtime9.js +1 -1
- package/dist/src/screen-recording-admission-ledger.js +1 -0
- package/dist/src/screen-recording-completion.js +1 -1
- package/dist/src/screen-recording-options.js +1 -1
- package/dist/src/screen-recording-resource-recovery.js +1 -1
- package/dist/src/screen-recording-stop-recovery.js +1 -1
- package/dist/src/screen-recording-transport.js +1 -1
- package/dist/src/screenshot-density.js +1 -1
- package/dist/src/screenshot-image-size.js +1 -1
- package/dist/src/screenshot-image.js +1 -1
- package/dist/src/screenshot-runtime.js +1 -1
- package/dist/src/screenshot-runtime2.js +1 -1
- package/dist/src/screenshot.js +1 -1
- package/dist/src/screenshot2.js +1 -1
- package/dist/src/screenshot4.js +1 -1
- package/dist/src/script-source.js +1 -1
- package/dist/src/script.js +1 -1
- package/dist/src/scroll-command.js +1 -1
- package/dist/src/scroll-gesture.js +1 -1
- package/dist/src/sdk-batch-runner.d.ts +1 -1
- package/dist/src/sdk-batch-runner.js +2 -2
- package/dist/src/sdk-batch.js +2 -2
- package/dist/src/sdk-contracts.d.ts +26 -2
- package/dist/src/sdk-contracts.js +2 -2
- package/dist/src/sdk-device.js +1 -1
- package/dist/src/sdk-finders.d.ts +1 -1
- package/dist/src/sdk-finders.js +1 -1
- package/dist/src/sdk-io.js +5 -5
- package/dist/src/sdk-remote-config.d.ts +1 -1
- package/dist/src/sdk-remote-config.js +1 -1
- package/dist/src/sdk-selectors.d.ts +9 -6
- package/dist/src/sdk-selectors.js +1 -1
- package/dist/src/selection.js +0 -0
- package/dist/src/selector-pipeline-policy.js +1 -1
- package/dist/src/selector-runtime.js +1 -1
- package/dist/src/selectors.js +1 -1
- package/dist/src/server-shutdown.js +1 -1
- package/dist/src/server-startup.js +2 -2
- package/dist/src/server.js +4 -4
- package/dist/src/session-allocation.js +1 -1
- package/dist/src/session-artifact-paths.js +1 -1
- package/dist/src/session-capture-binding.js +1 -1
- package/dist/src/session-device-resolution.js +1 -1
- package/dist/src/session-event-action.js +1 -1
- package/dist/src/session-open.js +1 -1
- package/dist/src/session-repair-tombstone.js +1 -1
- package/dist/src/session-replay-vars.js +1 -1
- package/dist/src/session-routing.js +1 -1
- package/dist/src/session-runtime-admission.js +1 -1
- package/dist/src/session-runtime.js +1 -1
- package/dist/src/session-script-destination.js +1 -0
- package/dist/src/session-selector.js +1 -1
- package/dist/src/session-store.js +3 -3
- package/dist/src/session-teardown.js +1 -1
- package/dist/src/session-tenant-scope.js +1 -1
- package/dist/src/session2.js +5 -5
- package/dist/src/settings-bluetooth.js +1 -1
- package/dist/src/settings-global-toggle.js +1 -1
- package/dist/src/settings.js +1 -1
- package/dist/src/settings2.js +1 -1
- package/dist/src/settle-observation-capture.js +1 -1
- package/dist/src/simctl-execution.js +1 -1
- package/dist/src/simctl-facade.js +1 -1
- package/dist/src/simctl.js +1 -1
- package/dist/src/simulator-app-budget.js +1 -1
- package/dist/src/simulator-boot.js +1 -1
- package/dist/src/simulator-facade.js +1 -1
- package/dist/src/simulator-state.js +1 -1
- package/dist/src/simulator.js +1 -1
- package/dist/src/snapshot-baseline.js +1 -1
- package/dist/src/snapshot-chrome.js +1 -1
- package/dist/src/snapshot-desktop-projection.js +1 -1
- package/dist/src/snapshot-diagnostics.js +1 -1
- package/dist/src/snapshot-helper-install.js +3 -3
- package/dist/src/snapshot-helper-session.js +1 -1
- package/dist/src/snapshot-lines.js +1 -1
- package/dist/src/snapshot-node-lookup.js +1 -1
- package/dist/src/snapshot-occlusion.js +1 -1
- package/dist/src/snapshot-private-evidence.js +1 -1
- package/dist/src/snapshot-runtime-binding.js +1 -1
- package/dist/src/snapshot-runtime-capture-input.js +1 -1
- package/dist/src/snapshot-runtime.js +1 -1
- package/dist/src/snapshot-state.js +1 -1
- package/dist/src/snapshot.js +1 -1
- package/dist/src/snapshot2.js +1 -1
- package/dist/src/snapshot3.js +2 -2
- package/dist/src/snapshot4.js +1 -1
- package/dist/src/source-channel.js +1 -1
- package/dist/src/src.js +1 -1
- package/dist/src/src10.js +1 -1
- package/dist/src/src11.js +1 -1
- package/dist/src/src2.js +1 -1
- package/dist/src/src3.js +5 -5
- package/dist/src/src4.js +2 -2
- package/dist/src/src5.js +1 -1
- package/dist/src/src6.js +1 -1
- package/dist/src/src8.js +1 -1
- package/dist/src/store-legacy.js +1 -1
- package/dist/src/store.js +1 -1
- package/dist/src/string-enum.js +1 -1
- package/dist/src/surface-snapshot.js +1 -1
- package/dist/src/surface-snapshot2.js +1 -1
- package/dist/src/sync-cache.js +1 -1
- package/dist/src/system-surface-foreground.js +2 -2
- package/dist/src/takeover.js +1 -1
- package/dist/src/tap-keyboard-occlusion.js +1 -1
- package/dist/src/target-evidence-tree.js +1 -1
- package/dist/src/target-evidence.js +1 -1
- package/dist/src/telephony-runtime.js +1 -1
- package/dist/src/tool-provider-facade.js +1 -1
- package/dist/src/tool-provider.js +3 -3
- package/dist/src/tool-provider2.js +1 -1
- package/dist/src/tool-provider3.js +1 -1
- package/dist/src/toolchain-probe.js +1 -1
- package/dist/src/touch-runtime.js +1 -1
- package/dist/src/touch-runtime2.js +1 -1
- package/dist/src/transport.js +2 -2
- package/dist/src/tree.js +1 -1
- package/dist/src/tv-remote-runtime.js +1 -1
- package/dist/src/tv-remote.js +1 -1
- package/dist/src/type-text-runtime.js +1 -1
- package/dist/src/unsupported-interactor.js +1 -1
- package/dist/src/update-check.js +1 -1
- package/dist/src/validation.js +1 -1
- package/dist/src/vars.js +1 -1
- package/dist/src/vega-executable.js +1 -1
- package/dist/src/verified-file.js +1 -1
- package/dist/src/video.js +2 -2
- package/dist/src/viewport.js +1 -1
- package/dist/src/web.js +1 -1
- package/dist/src/webdriver-source.js +1 -1
- package/package.json +2 -2
- package/server.json +2 -2
- package/android/ime-helper/dist/agent-device-android-ime-helper-0.21.37.apk.sha256 +0 -1
- package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.37.apk.sha256 +0 -1
- package/dist/src/capture-output-ownership.js +0 -1
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
import { A as
|
|
1
|
+
import { A as IosSnapshotObservation, C as DeviceKind, D as PublicPlatform, E as PlatformSelector, G as SnapshotUnchanged, K as SnapshotViewportSize, L as SnapshotCommandOptionFields, M as Point, N as PresentedSurface, Q as DaemonError, R as SnapshotKeyboardBandFact, U as SnapshotQualityNote, W as SnapshotQualityVerdict, _ as ScriptDeliveryFailure, a as DaemonRequest, b as AppleOS, c as DaemonServerMode, f as LeaseBackend, g as ResponseLevel, i as DaemonLockPolicy, j as IosTargetActivation, k as AppleApplicationState, l as DaemonTransportPreference, m as NetworkIncludeMode, o as DaemonResponse, q as SnapshotVisibility, r as DaemonInstallSource, s as DaemonResponseData, t as DaemonArtifact, tt as NormalizedError, v as SessionIsolationMode, w as DeviceTarget, x as BootPickPolicy, y as SessionRuntimeHints, z as SnapshotNode } from "./sdk-contracts.js";
|
|
2
2
|
import { t as BatchRunResult } from "./sdk-batch-runner.js";
|
|
3
|
-
import { _ as PressCommandResponseData, f as ClickCommandResponseData, g as LongPressCommandResponseData, h as HoverCommandResponseData, m as FindCommandResponseData, p as FillCommandResponseData, v as SettleObservation, y as ClickButton } from "./sdk-selectors.js";
|
|
3
|
+
import { _ as PressCommandResponseData, b as PostGestureOutcome, f as ClickCommandResponseData, g as LongPressCommandResponseData, h as HoverCommandResponseData, m as FindCommandResponseData, p as FillCommandResponseData, v as SettleObservation, y as ClickButton } from "./sdk-selectors.js";
|
|
4
4
|
import { A as ScrollDirection, C as HardwareButtonName, D as ScreenshotCaptureBackend, E as SnapshotDiagnosticsSummary, F as BackMode, I as SessionSurface, M as SwipePattern, N as SwipePreset, P as TransformGestureParams, S as FoldScreenCoordinateSpace, T as SetFoldPoseInput, _ as TvRemoteButton, a as AndroidSnapshotBackendMetadata, b as DeviceRotation, c as ScreenshotResultData, d as PermissionAction, f as PermissionMode, h as SettingName, i as CloudProviderSessionResult, j as ScrollInputDirection, k as ScreenshotScreenMask, l as MACOS_PERMISSION_TARGETS, m as SETTINGS, o as FindLocator, t as AgentArtifactsResult, u as MOBILE_PERMISSION_TARGETS, v as ScrollCommandResult, w as OrientationRequest, x as FoldPose } from "./cloud-artifacts.js";
|
|
5
5
|
import { a as RecordingExportQuality, i as RecordingScope, r as ReplaySuiteResult, t as ReplayCommandResult } from "./replay.js";
|
|
6
6
|
import { c as MetroPrepareOptions, d as MetroReloadResult, l as MetroPrepareResult, o as RemoteConnectionProfileFields, r as CloudProviderProfileFields, u as MetroReloadOptions } from "./sdk-remote-config.js";
|
|
@@ -312,6 +312,12 @@ type AgentDeviceSessionDevice = {
|
|
|
312
312
|
* Apple devices; `platform` still carries the leaf (`ios`/`macos`).
|
|
313
313
|
*/
|
|
314
314
|
appleOs?: AppleOS;
|
|
315
|
+
/** Simulator/emulator/physical split. Absent only from a daemon older than the field. */
|
|
316
|
+
kind?: DeviceKind;
|
|
317
|
+
/** Hardware model, for example `iPhone 17 Pro` or `Pixel 9`, when the host or provider reports it. */
|
|
318
|
+
model?: string;
|
|
319
|
+
/** OS version, for example `26.1` or `16`, when the host or provider reports it. Never inferred. */
|
|
320
|
+
osVersion?: string;
|
|
315
321
|
identifiers: AgentDeviceIdentifiers;
|
|
316
322
|
ios?: {
|
|
317
323
|
udid: string;
|
|
@@ -491,156 +497,58 @@ type HumanControlHoldOptions = {
|
|
|
491
497
|
ttlMs?: number;
|
|
492
498
|
};
|
|
493
499
|
//#endregion
|
|
494
|
-
//#region packages/contracts/src/
|
|
495
|
-
type
|
|
496
|
-
|
|
497
|
-
|
|
498
|
-
|
|
499
|
-
|
|
500
|
-
|
|
501
|
-
|
|
502
|
-
source: DeviceSelectionSource;
|
|
503
|
-
candidateCount: number;
|
|
504
|
-
/** Whether this request booted a previously stopped local virtual target during open. */
|
|
505
|
-
bootOccurred: boolean;
|
|
506
|
-
};
|
|
507
|
-
type AppInstallOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & LeaseDeviceSpec & {
|
|
508
|
-
app?: string;
|
|
509
|
-
appPath: string;
|
|
510
|
-
};
|
|
511
|
-
type AppDeployOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & LeaseDeviceSpec & {
|
|
512
|
-
app: string;
|
|
513
|
-
appPath: string;
|
|
514
|
-
};
|
|
515
|
-
type AppDeployResult = {
|
|
516
|
-
app: string;
|
|
517
|
-
appPath: string;
|
|
518
|
-
platform: PublicPlatform;
|
|
519
|
-
appId?: string;
|
|
520
|
-
bundleId?: string;
|
|
521
|
-
package?: string;
|
|
522
|
-
identifiers: AgentDeviceIdentifiers;
|
|
523
|
-
};
|
|
524
|
-
type AppOpenOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & LeaseDeviceSpec & {
|
|
525
|
-
app?: string;
|
|
526
|
-
url?: string;
|
|
527
|
-
surface?: SessionSurface;
|
|
528
|
-
activity?: string;
|
|
529
|
-
launchConsole?: string;
|
|
530
|
-
launchArgs?: string[];
|
|
531
|
-
relaunch?: boolean;
|
|
532
|
-
/** Startup budget in milliseconds: bounds the Simulator boot wait on a cold device. */
|
|
533
|
-
timeoutMs?: number;
|
|
534
|
-
/**
|
|
535
|
-
* Wait up to n milliseconds (100-120000) while another session holds the device, then fail
|
|
536
|
-
* with DEVICE_IN_USE. A claim held by another workspace fails at once. The wait extends this
|
|
537
|
-
* command's timeout.
|
|
538
|
-
*/
|
|
539
|
-
waitMs?: number;
|
|
540
|
-
/**
|
|
541
|
-
* Include an initial interactive snapshot in a fresh open response. With no
|
|
542
|
-
* app argument, discover the sole running app on the sole booted iOS
|
|
543
|
-
* simulator; ambiguous environments fail closed.
|
|
544
|
-
*/
|
|
545
|
-
foreground?: boolean;
|
|
546
|
-
saveScript?: boolean | string;
|
|
547
|
-
/** #1258: overwrite an existing --save-script target instead of refusing. Alias: --overwrite. */
|
|
548
|
-
force?: boolean;
|
|
549
|
-
testIme?: boolean;
|
|
550
|
-
noRecord?: boolean;
|
|
551
|
-
runtime?: SessionRuntimeHints;
|
|
552
|
-
};
|
|
553
|
-
type AppOpenResult = AppOpenResultBase & (LaunchConfirmationClientOutcome | LaunchConfirmationAbsent);
|
|
554
|
-
type AppOpenResultBase = {
|
|
555
|
-
session: string;
|
|
556
|
-
warnings?: string[];
|
|
557
|
-
sessionStateDir?: string;
|
|
558
|
-
runnerLogPath?: string;
|
|
559
|
-
requestLogPath?: string;
|
|
560
|
-
eventLogPath?: string;
|
|
561
|
-
appName?: string;
|
|
562
|
-
appBundleId?: string;
|
|
563
|
-
appId?: string;
|
|
564
|
-
startup?: StartupPerfSample;
|
|
565
|
-
runtime?: SessionRuntimeHints;
|
|
566
|
-
selection?: DeviceSelectionMetadata;
|
|
567
|
-
device?: AgentDeviceSessionDevice;
|
|
568
|
-
/**
|
|
569
|
-
* Initial interactive snapshot captured immediately after an open that
|
|
570
|
-
* requested `foreground`, composed from the same snapshot-runtime dispatch
|
|
571
|
-
* `agent-device snapshot -i` uses. It stays loosely typed rather than reusing
|
|
572
|
-
* `CaptureSnapshotResult` because the daemon-side composition does not attach
|
|
573
|
-
* client-only fields like `identifiers`.
|
|
574
|
-
*/
|
|
575
|
-
snapshot?: Record<string, unknown>;
|
|
576
|
-
/**
|
|
577
|
-
* open --foreground: present when the session opened successfully but the
|
|
578
|
-
* composed initial snapshot capture failed. Carries the FULL daemon error
|
|
579
|
-
* shape (code, message, hint, details, diagnosticId, logPath) so recovery
|
|
580
|
-
* guidance survives to the caller; the session itself is open and usable —
|
|
581
|
-
* a `warnings` entry says so and points at `snapshot -i`.
|
|
582
|
-
*/
|
|
583
|
-
initialSnapshotError?: DaemonError;
|
|
584
|
-
identifiers: AgentDeviceIdentifiers;
|
|
585
|
-
};
|
|
586
|
-
type AppCloseOptions = AgentDeviceRequestOverrides & {
|
|
587
|
-
app?: string;
|
|
588
|
-
shutdown?: boolean;
|
|
589
|
-
saveScript?: boolean | string;
|
|
590
|
-
/** #1258: overwrite an existing --save-script target instead of refusing. Alias: --overwrite. */
|
|
591
|
-
force?: boolean;
|
|
592
|
-
};
|
|
593
|
-
type AppCloseResult = {
|
|
594
|
-
session: string;
|
|
595
|
-
closedApp?: string;
|
|
596
|
-
shutdown?: TargetShutdownResult;
|
|
597
|
-
/**
|
|
598
|
-
* #1258: absolute path of the committed session/healed script when this close
|
|
599
|
-
* published one (`close --save-script`, or a repair-armed session's finalize)
|
|
600
|
-
* — so a client that requested publication learns where the file landed.
|
|
601
|
-
*/
|
|
602
|
-
savedScript?: string;
|
|
603
|
-
identifiers: AgentDeviceIdentifiers;
|
|
604
|
-
};
|
|
605
|
-
type AppInstallFromSourceOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & {
|
|
606
|
-
source: DaemonInstallSource;
|
|
607
|
-
retainPaths?: boolean;
|
|
608
|
-
retentionMs?: number;
|
|
500
|
+
//#region packages/contracts/src/gesture-input.d.ts
|
|
501
|
+
type DragGesturePayload = {
|
|
502
|
+
kind: 'drag';
|
|
503
|
+
source: string;
|
|
504
|
+
destination: string;
|
|
505
|
+
sourceHoldMs?: number;
|
|
506
|
+
moveMs?: number;
|
|
507
|
+
destinationHoldMs?: number;
|
|
609
508
|
};
|
|
610
|
-
type
|
|
611
|
-
|
|
612
|
-
|
|
613
|
-
|
|
614
|
-
|
|
615
|
-
|
|
616
|
-
installablePath?: string;
|
|
617
|
-
archivePath?: string;
|
|
618
|
-
materializationId?: string;
|
|
619
|
-
materializationExpiresAt?: string;
|
|
620
|
-
identifiers: AgentDeviceIdentifiers;
|
|
509
|
+
type PanGesturePayload = {
|
|
510
|
+
kind: 'pan';
|
|
511
|
+
origin: Point;
|
|
512
|
+
delta: Point;
|
|
513
|
+
pointerCount?: GesturePointerCount;
|
|
514
|
+
durationMs?: number;
|
|
621
515
|
};
|
|
622
|
-
type
|
|
623
|
-
|
|
516
|
+
type FlingGesturePayload = {
|
|
517
|
+
kind: 'fling';
|
|
518
|
+
direction: ScrollDirection;
|
|
519
|
+
origin: Point;
|
|
520
|
+
distance?: number;
|
|
624
521
|
};
|
|
625
|
-
type
|
|
626
|
-
|
|
627
|
-
|
|
522
|
+
type SwipeGesturePayload = {
|
|
523
|
+
kind: 'swipe';
|
|
524
|
+
preset: SwipePreset;
|
|
628
525
|
};
|
|
629
|
-
type
|
|
630
|
-
|
|
526
|
+
type PinchGesturePayload = {
|
|
527
|
+
kind: 'pinch';
|
|
528
|
+
scale: number;
|
|
529
|
+
origin?: Point;
|
|
631
530
|
};
|
|
632
|
-
type
|
|
633
|
-
|
|
634
|
-
|
|
531
|
+
type RotateGesturePayload = {
|
|
532
|
+
kind: 'rotate';
|
|
533
|
+
degrees: number;
|
|
534
|
+
origin?: Point;
|
|
635
535
|
};
|
|
636
|
-
type
|
|
637
|
-
|
|
536
|
+
type TransformGesturePayload = {
|
|
537
|
+
kind: 'transform';
|
|
538
|
+
origin: Point;
|
|
539
|
+
delta: Point;
|
|
540
|
+
scale: number;
|
|
541
|
+
degrees: number;
|
|
542
|
+
durationMs?: number;
|
|
638
543
|
};
|
|
639
|
-
type
|
|
640
|
-
|
|
641
|
-
|
|
642
|
-
|
|
544
|
+
type TapGesturePayload = {
|
|
545
|
+
kind: 'tap';
|
|
546
|
+
points: Point[];
|
|
547
|
+
holdMs?: number;
|
|
548
|
+
count?: number;
|
|
549
|
+
pauseMs?: number;
|
|
643
550
|
};
|
|
551
|
+
type GesturePayload = PanGesturePayload | FlingGesturePayload | SwipeGesturePayload | PinchGesturePayload | RotateGesturePayload | TransformGesturePayload | TapGesturePayload | DragGesturePayload;
|
|
644
552
|
//#endregion
|
|
645
553
|
//#region packages/contracts/src/snapshot-capture-annotations.d.ts
|
|
646
554
|
type SnapshotCaptureAnalysis = {
|
|
@@ -672,13 +580,9 @@ type PublicSnapshotCaptureAnnotations = Pick<SnapshotCaptureAnnotations, 'androi
|
|
|
672
580
|
//#region packages/contracts/src/client-capture.d.ts
|
|
673
581
|
type CaptureSnapshotOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & Omit<SnapshotCommandOptionFields, 'customActions'> & {
|
|
674
582
|
/**
|
|
675
|
-
*
|
|
676
|
-
*
|
|
677
|
-
*
|
|
678
|
-
* invocation: there is no API to trigger them, so reach the affordance through the
|
|
679
|
-
* element detail screen, through the same control exposed as a labeled element
|
|
680
|
-
* elsewhere, or by coordinates from its rect. iOS simulator only; costs one
|
|
681
|
-
* accessibility round trip per merged element.
|
|
583
|
+
* List the custom actions an element merged away, such as a card's reply control.
|
|
584
|
+
* Not invocable: reach the control via its detail screen, a labeled element elsewhere,
|
|
585
|
+
* or its rect. iOS simulator only; costs one accessibility round trip per merged element.
|
|
682
586
|
*/
|
|
683
587
|
customActions?: SnapshotCommandOptionFields['customActions'];
|
|
684
588
|
timeoutMs?: number;
|
|
@@ -726,6 +630,12 @@ type CaptureSnapshotResult = {
|
|
|
726
630
|
* of the field means a non-iOS producer or an older runner published nothing.
|
|
727
631
|
*/
|
|
728
632
|
presentedSurface?: PresentedSurface;
|
|
633
|
+
/**
|
|
634
|
+
* Present when the tree may not show the surface at rest: `unsettled` (still changing after a
|
|
635
|
+
* gesture), `no-effect` (a gesture changed nothing), or `loading` (the app launched by `open`
|
|
636
|
+
* still showed no first screen when its wait ran out).
|
|
637
|
+
*/
|
|
638
|
+
postGestureOutcome?: PostGestureOutcome;
|
|
729
639
|
/**
|
|
730
640
|
* Screenshot captured automatically when the semantic snapshot was sparse.
|
|
731
641
|
* Remote clients receive a materialized local path through the daemon artifact channel.
|
|
@@ -747,6 +657,11 @@ type CaptureSnapshotResult = {
|
|
|
747
657
|
ref: string;
|
|
748
658
|
label?: string;
|
|
749
659
|
}>;
|
|
660
|
+
/**
|
|
661
|
+
* ADR 0016 (#4564): a remote recording's script version this capture recorded was not delivered.
|
|
662
|
+
* The capture kept its success, so the caller file may hold an older version.
|
|
663
|
+
*/
|
|
664
|
+
scriptDeliveryFailure?: ScriptDeliveryFailure;
|
|
750
665
|
} & PublicSnapshotCaptureAnnotations;
|
|
751
666
|
type CaptureScreenshotOptions = AgentDeviceRequestOverrides & {
|
|
752
667
|
path?: string;
|
|
@@ -765,6 +680,11 @@ type CaptureScreenshotOptions = AgentDeviceRequestOverrides & {
|
|
|
765
680
|
};
|
|
766
681
|
type CaptureScreenshotResult = ScreenshotResultData & {
|
|
767
682
|
path: string;
|
|
683
|
+
/**
|
|
684
|
+
* ADR 0016 (#4564): a remote recording's script version this capture recorded was not delivered.
|
|
685
|
+
* The capture kept its success, so the caller file may hold an older version.
|
|
686
|
+
*/
|
|
687
|
+
scriptDeliveryFailure?: ScriptDeliveryFailure;
|
|
768
688
|
identifiers: AgentDeviceIdentifiers;
|
|
769
689
|
};
|
|
770
690
|
type CaptureDiffOptions = DeviceCommandBaseOptions & Pick<CaptureSnapshotOptions, 'interactiveOnly' | 'depth' | 'scope' | 'raw'> & {
|
|
@@ -774,59 +694,6 @@ type CaptureDiffOptions = DeviceCommandBaseOptions & Pick<CaptureSnapshotOptions
|
|
|
774
694
|
type SelectorSnapshotCommandOptions = Pick<CaptureSnapshotOptions, 'depth' | 'scope' | 'raw'>;
|
|
775
695
|
type FindSnapshotCommandOptions = Pick<CaptureSnapshotOptions, 'depth' | 'raw'>;
|
|
776
696
|
//#endregion
|
|
777
|
-
//#region packages/contracts/src/gesture-input.d.ts
|
|
778
|
-
type DragGesturePayload = {
|
|
779
|
-
kind: 'drag';
|
|
780
|
-
source: string;
|
|
781
|
-
destination: string;
|
|
782
|
-
sourceHoldMs?: number;
|
|
783
|
-
moveMs?: number;
|
|
784
|
-
destinationHoldMs?: number;
|
|
785
|
-
};
|
|
786
|
-
type PanGesturePayload = {
|
|
787
|
-
kind: 'pan';
|
|
788
|
-
origin: Point;
|
|
789
|
-
delta: Point;
|
|
790
|
-
pointerCount?: GesturePointerCount;
|
|
791
|
-
durationMs?: number;
|
|
792
|
-
};
|
|
793
|
-
type FlingGesturePayload = {
|
|
794
|
-
kind: 'fling';
|
|
795
|
-
direction: ScrollDirection;
|
|
796
|
-
origin: Point;
|
|
797
|
-
distance?: number;
|
|
798
|
-
};
|
|
799
|
-
type SwipeGesturePayload = {
|
|
800
|
-
kind: 'swipe';
|
|
801
|
-
preset: SwipePreset;
|
|
802
|
-
};
|
|
803
|
-
type PinchGesturePayload = {
|
|
804
|
-
kind: 'pinch';
|
|
805
|
-
scale: number;
|
|
806
|
-
origin?: Point;
|
|
807
|
-
};
|
|
808
|
-
type RotateGesturePayload = {
|
|
809
|
-
kind: 'rotate';
|
|
810
|
-
degrees: number;
|
|
811
|
-
origin?: Point;
|
|
812
|
-
};
|
|
813
|
-
type TransformGesturePayload = {
|
|
814
|
-
kind: 'transform';
|
|
815
|
-
origin: Point;
|
|
816
|
-
delta: Point;
|
|
817
|
-
scale: number;
|
|
818
|
-
degrees: number;
|
|
819
|
-
durationMs?: number;
|
|
820
|
-
};
|
|
821
|
-
type TapGesturePayload = {
|
|
822
|
-
kind: 'tap';
|
|
823
|
-
points: Point[];
|
|
824
|
-
holdMs?: number;
|
|
825
|
-
count?: number;
|
|
826
|
-
pauseMs?: number;
|
|
827
|
-
};
|
|
828
|
-
type GesturePayload = PanGesturePayload | FlingGesturePayload | SwipeGesturePayload | PinchGesturePayload | RotateGesturePayload | TransformGesturePayload | TapGesturePayload | DragGesturePayload;
|
|
829
|
-
//#endregion
|
|
830
697
|
//#region packages/contracts/src/client-target.d.ts
|
|
831
698
|
type PointTarget = {
|
|
832
699
|
x: number;
|
|
@@ -874,12 +741,13 @@ type SettleCommandOptions = {
|
|
|
874
741
|
settleQuietMs?: number;
|
|
875
742
|
timeoutMs?: number;
|
|
876
743
|
};
|
|
877
|
-
/** For a caller that verifies the screen by polling it: opts out of the checks after a gesture. */
|
|
744
|
+
/** For a caller that verifies the screen by polling it: opts out of the checks after a gesture or an app launch. */
|
|
878
745
|
type PostGestureStabilizationOptions = {
|
|
879
746
|
/**
|
|
880
747
|
* Set false to skip the movement check on a directional scroll and the stabilization wait
|
|
881
|
-
* before the next read
|
|
882
|
-
* return a tree that the
|
|
748
|
+
* before the next read, or, on a local iOS simulator, the first-screen wait after an app launch.
|
|
749
|
+
* Set it only when your own polling verifies the screen: the next read can return a tree that the
|
|
750
|
+
* gesture is still moving or the launch screen.
|
|
883
751
|
*/
|
|
884
752
|
postGestureStabilization?: boolean;
|
|
885
753
|
};
|
|
@@ -970,6 +838,169 @@ type ScrollOptions = DeviceCommandBaseOptions & SettleCommandOptions & PostGestu
|
|
|
970
838
|
maxPasses?: number;
|
|
971
839
|
};
|
|
972
840
|
//#endregion
|
|
841
|
+
//#region packages/contracts/src/client-app.d.ts
|
|
842
|
+
type DeviceSelectionReason = 'explicit-selector' | 'existing-session' | 'single-booted-local' | 'single-bootable-local' | 'single-app-installed-local' |
|
|
843
|
+
/** `boot --pick newest` chose among several equally preferred, shut-down local devices. */
|
|
844
|
+
'newest-bootable-local' | 'preferred-local' | 'single-provider-device';
|
|
845
|
+
type DeviceSelectionSource = 'session' | 'local' | 'provider';
|
|
846
|
+
/** Deterministic device-selection evidence shared by daemon responses and the published client. */
|
|
847
|
+
type DeviceSelectionMetadata = {
|
|
848
|
+
reason: DeviceSelectionReason;
|
|
849
|
+
source: DeviceSelectionSource;
|
|
850
|
+
candidateCount: number;
|
|
851
|
+
/** Whether this request booted a previously stopped local virtual target during open. */
|
|
852
|
+
bootOccurred: boolean;
|
|
853
|
+
};
|
|
854
|
+
type AppInstallOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & LeaseDeviceSpec & {
|
|
855
|
+
app?: string;
|
|
856
|
+
appPath: string;
|
|
857
|
+
};
|
|
858
|
+
type AppDeployOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & LeaseDeviceSpec & {
|
|
859
|
+
app: string;
|
|
860
|
+
appPath: string;
|
|
861
|
+
};
|
|
862
|
+
type AppDeployResult = {
|
|
863
|
+
app: string;
|
|
864
|
+
appPath: string;
|
|
865
|
+
platform: PublicPlatform;
|
|
866
|
+
appId?: string;
|
|
867
|
+
bundleId?: string;
|
|
868
|
+
package?: string;
|
|
869
|
+
identifiers: AgentDeviceIdentifiers;
|
|
870
|
+
};
|
|
871
|
+
type AppOpenOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & LeaseDeviceSpec & PostGestureStabilizationOptions & {
|
|
872
|
+
app?: string;
|
|
873
|
+
url?: string;
|
|
874
|
+
surface?: SessionSurface;
|
|
875
|
+
activity?: string;
|
|
876
|
+
launchConsole?: string;
|
|
877
|
+
launchArgs?: string[];
|
|
878
|
+
relaunch?: boolean;
|
|
879
|
+
/** Startup budget in milliseconds: bounds the Simulator boot wait on a cold device. */
|
|
880
|
+
timeoutMs?: number;
|
|
881
|
+
/**
|
|
882
|
+
* Wait up to n milliseconds (100-120000) while another session holds the device, then fail
|
|
883
|
+
* with DEVICE_IN_USE. A claim held by another workspace fails at once. The wait extends this
|
|
884
|
+
* command's timeout.
|
|
885
|
+
*/
|
|
886
|
+
waitMs?: number;
|
|
887
|
+
/**
|
|
888
|
+
* Include an initial interactive snapshot in a fresh open response. With no
|
|
889
|
+
* app argument, discover the sole running app on the sole booted iOS
|
|
890
|
+
* simulator; ambiguous environments fail closed.
|
|
891
|
+
*/
|
|
892
|
+
foreground?: boolean;
|
|
893
|
+
saveScript?: boolean | string;
|
|
894
|
+
/** #1258: overwrite an existing --save-script target instead of refusing. Alias: --overwrite. */
|
|
895
|
+
force?: boolean;
|
|
896
|
+
testIme?: boolean;
|
|
897
|
+
noRecord?: boolean;
|
|
898
|
+
runtime?: SessionRuntimeHints;
|
|
899
|
+
};
|
|
900
|
+
type AppOpenResult = AppOpenResultBase & (LaunchConfirmationClientOutcome | LaunchConfirmationAbsent);
|
|
901
|
+
type AppOpenResultBase = {
|
|
902
|
+
session: string;
|
|
903
|
+
warnings?: string[];
|
|
904
|
+
/**
|
|
905
|
+
* ADR 0016 (#4564): a remote recording's first script version was not delivered. The open kept
|
|
906
|
+
* its success, so the caller file may hold no script at all, or an older one.
|
|
907
|
+
*/
|
|
908
|
+
scriptDeliveryFailure?: ScriptDeliveryFailure;
|
|
909
|
+
sessionStateDir?: string;
|
|
910
|
+
runnerLogPath?: string;
|
|
911
|
+
requestLogPath?: string;
|
|
912
|
+
eventLogPath?: string;
|
|
913
|
+
appName?: string;
|
|
914
|
+
appBundleId?: string;
|
|
915
|
+
appId?: string;
|
|
916
|
+
startup?: StartupPerfSample;
|
|
917
|
+
runtime?: SessionRuntimeHints;
|
|
918
|
+
selection?: DeviceSelectionMetadata;
|
|
919
|
+
device?: AgentDeviceSessionDevice;
|
|
920
|
+
/**
|
|
921
|
+
* Initial interactive snapshot captured immediately after an open that
|
|
922
|
+
* requested `foreground`, composed from the same snapshot-runtime dispatch
|
|
923
|
+
* `agent-device snapshot -i` uses. It stays loosely typed rather than reusing
|
|
924
|
+
* `CaptureSnapshotResult` because the daemon-side composition does not attach
|
|
925
|
+
* client-only fields like `identifiers`.
|
|
926
|
+
*/
|
|
927
|
+
snapshot?: Record<string, unknown>;
|
|
928
|
+
/**
|
|
929
|
+
* open --foreground: present when the session opened successfully but the
|
|
930
|
+
* composed initial snapshot capture failed. Carries the FULL daemon error
|
|
931
|
+
* shape (code, message, hint, details, diagnosticId, logPath) so recovery
|
|
932
|
+
* guidance survives to the caller; the session itself is open and usable —
|
|
933
|
+
* a `warnings` entry says so and points at `snapshot -i`.
|
|
934
|
+
*/
|
|
935
|
+
initialSnapshotError?: DaemonError;
|
|
936
|
+
identifiers: AgentDeviceIdentifiers;
|
|
937
|
+
};
|
|
938
|
+
type AppCloseOptions = AgentDeviceRequestOverrides & {
|
|
939
|
+
app?: string;
|
|
940
|
+
shutdown?: boolean;
|
|
941
|
+
saveScript?: boolean | string;
|
|
942
|
+
/** #1258: overwrite an existing --save-script target instead of refusing. Alias: --overwrite. */
|
|
943
|
+
force?: boolean;
|
|
944
|
+
};
|
|
945
|
+
type AppCloseResult = {
|
|
946
|
+
session: string;
|
|
947
|
+
closedApp?: string;
|
|
948
|
+
shutdown?: TargetShutdownResult;
|
|
949
|
+
/**
|
|
950
|
+
* #1258: absolute path of the committed session/healed script when this close
|
|
951
|
+
* published one (`close --save-script`, or a repair-armed session's finalize)
|
|
952
|
+
* — so a client that requested publication learns where the file landed.
|
|
953
|
+
*/
|
|
954
|
+
savedScript?: string;
|
|
955
|
+
/** ADR 0016 (#4564): the close's response warnings, kept so a lost final script is read, not skipped. */
|
|
956
|
+
warnings?: string[];
|
|
957
|
+
/**
|
|
958
|
+
* ADR 0016 (#4564): the final script of a remote recording was not delivered. The close kept its
|
|
959
|
+
* success, so this is the only channel that says the caller file still holds an older version.
|
|
960
|
+
*/
|
|
961
|
+
scriptDeliveryFailure?: ScriptDeliveryFailure;
|
|
962
|
+
identifiers: AgentDeviceIdentifiers;
|
|
963
|
+
};
|
|
964
|
+
type AppInstallFromSourceOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & {
|
|
965
|
+
source: DaemonInstallSource;
|
|
966
|
+
retainPaths?: boolean;
|
|
967
|
+
retentionMs?: number;
|
|
968
|
+
};
|
|
969
|
+
type AppInstallFromSourceResult = {
|
|
970
|
+
appName?: string;
|
|
971
|
+
appId?: string;
|
|
972
|
+
bundleId?: string;
|
|
973
|
+
packageName?: string;
|
|
974
|
+
launchTarget: string;
|
|
975
|
+
installablePath?: string;
|
|
976
|
+
archivePath?: string;
|
|
977
|
+
materializationId?: string;
|
|
978
|
+
materializationExpiresAt?: string;
|
|
979
|
+
identifiers: AgentDeviceIdentifiers;
|
|
980
|
+
};
|
|
981
|
+
type AppListOptions = AgentDeviceRequestOverrides & AgentDeviceSelectionOptions & {
|
|
982
|
+
appsFilter?: AppsFilter;
|
|
983
|
+
};
|
|
984
|
+
type AppPushOptions = DeviceCommandBaseOptions & {
|
|
985
|
+
app: string;
|
|
986
|
+
payload: string | JsonObject;
|
|
987
|
+
};
|
|
988
|
+
type AppUninstallOptions = DeviceCommandBaseOptions & LeaseDeviceSpec & {
|
|
989
|
+
app: string;
|
|
990
|
+
};
|
|
991
|
+
type AppTriggerEventOptions = DeviceCommandBaseOptions & {
|
|
992
|
+
event: string;
|
|
993
|
+
payload?: JsonObject;
|
|
994
|
+
};
|
|
995
|
+
type MaterializationReleaseOptions = AgentDeviceRequestOverrides & {
|
|
996
|
+
materializationId: string;
|
|
997
|
+
};
|
|
998
|
+
type MaterializationReleaseResult = {
|
|
999
|
+
released: boolean;
|
|
1000
|
+
materializationId: string;
|
|
1001
|
+
identifiers: AgentDeviceIdentifiers;
|
|
1002
|
+
};
|
|
1003
|
+
//#endregion
|
|
973
1004
|
//#region packages/contracts/src/logs.d.ts
|
|
974
1005
|
declare const LOG_ACTION_VALUES: readonly ['path', 'start', 'stop', 'doctor', 'mark', 'clear'];
|
|
975
1006
|
type LogAction = (typeof LOG_ACTION_VALUES)[number];
|
|
@@ -1166,6 +1197,13 @@ type SessionCloseResult = {
|
|
|
1166
1197
|
* — so a client that requested publication learns where the file landed.
|
|
1167
1198
|
*/
|
|
1168
1199
|
savedScript?: string;
|
|
1200
|
+
/** ADR 0016 (#4564): the close's response warnings, kept so a lost final script is read, not skipped. */
|
|
1201
|
+
warnings?: string[];
|
|
1202
|
+
/**
|
|
1203
|
+
* ADR 0016 (#4564): the final script of a remote recording was not delivered. The close kept its
|
|
1204
|
+
* success, so this is the only channel that says the caller file still holds an older version.
|
|
1205
|
+
*/
|
|
1206
|
+
scriptDeliveryFailure?: ScriptDeliveryFailure;
|
|
1169
1207
|
identifiers: AgentDeviceIdentifiers;
|
|
1170
1208
|
};
|
|
1171
1209
|
type SessionSaveScriptOptions = AgentDeviceRequestOverrides & {
|
|
@@ -2076,4 +2114,4 @@ type AgentDeviceClient = {
|
|
|
2076
2114
|
};
|
|
2077
2115
|
};
|
|
2078
2116
|
//#endregion
|
|
2079
|
-
export { RecordOptions as $, EndedLease as $t, AlertAction as A, DaemonConnection as An,
|
|
2117
|
+
export { RecordOptions as $, EndedLease as $t, AlertAction as A, DaemonConnection as An, PressOptions as At, IsStatePredicateOptions as B, ElementTarget as Bt, PrepareCommandOptions as C, AgentDeviceClientConfig as Cn, FocusOptions as Ct, ViewportCommandOptions as D, AgentDeviceRequestOverrides as Dn, PanOptions as Dt, TvRemoteCommandOptions as E, AgentDeviceIdentifiers as En, LongPressOptions as Et, SessionSaveScriptResult as F, SwipeGestureOptions as Ft, BatchStep as G, CaptureDiffOptions as Gt, RecordControlOptions as H, PointTarget as Ht, FindBaseOptions as I, SwipeOptions as It, AudioOptions as J, CaptureSnapshotOptions as Jt, ReplayRunOptions as K, CaptureScreenshotOptions as Kt, FindOptions as L, TapGestureOptions as Lt, SettingsUpdateOptions as M, DaemonLifecycle as Mn, RotateGestureOptions as Mt, SessionCloseResult as N, DeviceCommandBaseOptions as Nn, ScrollOptions as Nt, WaitCommandOptions as O, AgentDeviceSelectionOptions as On, PinchOptions as Ot, SessionSaveScriptOptions as P, EnsureDaemonOptions as Pn, SettleCommandOptions as Pt, PerfOptions as Q, CloudArtifactsOptions as Qt, GetOptions as R, TransformGestureOptions as Rt, OrientationCommandOptions as S, isRecord as Sn, FlingOptions as St, TelephonyCommandOptions as T, AgentDeviceDaemonTransportContext as Tn, HoverOptions as Tt, CommandRequestResult as U, RefTarget as Ut, IsTextPredicateOptions as V, InteractionTarget as Vt, BatchRunOptions as W, SelectorTarget as Wt, LogsOptions as X, FindSnapshotCommandOptions as Xt, EventsOptions as Y, CaptureSnapshotResult as Yt, NetworkOptions as Z, SelectorSnapshotCommandOptions as Zt, DoctorCommandOptions as _, PushCommandResult as _n, MaterializationReleaseOptions as _t, WaitCommandResult as a, LeaseDevice as an, AppInstallFromSourceOptions as at, HomeCommandOptions as b, JsonPrimitive as bn, DragOptions as bt, DoctorCommandResult as c, LeaseScopedOptions as cn, AppListOptions as ct, ActionButtonCommandOptions as d, AgentDeviceSession as dn, AppPushOptions as dt, HumanControlHold as en, TraceOptions as et, AlertCommandOptions as f, AgentDeviceSessionDevice as fn, AppTriggerEventOptions as ft, ClipboardCommandOptions as g, TargetShutdownResult as gn, DeviceSelectionSource as gt, BackCommandOptions as h, StartupPerfSample as hn, DeviceSelectionReason as ht, TraceCommandResult as i, LeaseAllocateOptions as in, AppDeployResult as it, PermissionTarget as j, DaemonIdentity as jn, RepeatedPressOptions as jt, WaitCommandTarget as k, DaemonBinding as kn, PostGestureStabilizationOptions as kt, DebugSymbolsOptions as l, AgentDeviceCapabilitiesResult as ln, AppOpenOptions as lt, AppSwitcherCommandOptions as m, DeviceShutdownOptions as mn, DeviceSelectionMetadata as mt, AgentDeviceCommandClient as n, HumanControlHoldScope as nn, AppCloseResult as nt, TriggerAppEventCommandResult as o, LeaseDeviceSpec as on, AppInstallFromSourceResult as ot, AppStateCommandOptions as p, DeviceBootOptions as pn, AppUninstallOptions as pt, ReplayTestOptions as q, CaptureScreenshotResult as qt, RecordingCommandResult as r, Lease as rn, AppDeployOptions as rt, DiffSnapshotCommandResult as s, LeaseOptions as sn, AppInstallOptions as st, AgentDeviceClient as t, HumanControlHoldOptions as tn, AppCloseOptions as tt, DebugSymbolsResult as u, AgentDeviceDevice as un, AppOpenResult as ut, FoldCommandOptions as v, PrepareCommandResult as vn, MaterializationReleaseResult as vt, ReactNativeCommandOptions as w, AgentDeviceDaemonTransport as wn, GestureOptions as wt, KeyboardCommandOptions as x, JsonValue as xn, FillOptions as xt, HardwareButtonCommandOptions as y, JsonObject as yn, ClickOptions as yt, IsOptions as z, TypeTextOptions as zt };
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{_ as e}from"./sdk-contracts.js";import{n as t,r as n}from"./adb.js";const r=`This Android build ships no shell implementation for the clipboard service, so adb cannot read or write the clipboard on it. Verify a copy flow by pasting into a focused field and reading that field back.`;function i(e){return n(e.stderr)?`no-shell-command`:e.exitCode===0?`executed`:t(e.stdout,e.stderr)?`no-shell-command`:`call-failed`}function a(e){return e===`executed`?`supported`:e===`no-shell-command`?`unsupported`:`probe-failed`}function o(e){return a(i(e))}function s(t){return new e(`UNSUPPORTED_OPERATION`,`Android shell clipboard ${t} is not supported on this device.`,{reason:`android_clipboard_shell_command_unavailable`,hint:r})}export{r as ANDROID_CLIPBOARD_SHELL_COMMAND_UNAVAILABLE_HINT,s as androidClipboardShellCommandUnavailableError,o as androidClipboardShellSupportForResult,i as classifyAndroidClipboardShellResponse};
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import {
|
|
1
|
+
import { A as IosSnapshotObservation, D as PublicPlatform, F as Rect, I as ScreenshotOverlayRef, K as SnapshotViewportSize, U as SnapshotQualityNote, W as SnapshotQualityVerdict, n as DaemonArtifactType, z as SnapshotNode } from "./sdk-contracts.js";
|
|
2
|
+
import { v as SettleObservation, x as SnapshotState } from "./sdk-selectors.js";
|
|
3
3
|
//#region packages/contracts/src/session-surface.d.ts
|
|
4
4
|
declare const SESSION_SURFACES: readonly ['app', 'frontmost-app', 'desktop', 'menubar'];
|
|
5
5
|
type SessionSurface = (typeof SESSION_SURFACES)[number];
|
|
@@ -549,6 +549,11 @@ type AndroidSnapshotBackendMetadata = {
|
|
|
549
549
|
cacheInvalidated?: boolean;
|
|
550
550
|
captureMode?: string;
|
|
551
551
|
systemSurfaceOnly?: boolean;
|
|
552
|
+
/**
|
|
553
|
+
* Package of the foreground application window the snapshot helper captured: active or focused,
|
|
554
|
+
* at the highest layer, and not owned by the system. Absent when the helper saw none.
|
|
555
|
+
*/
|
|
556
|
+
foregroundWindowPackage?: string;
|
|
552
557
|
windowCount?: number;
|
|
553
558
|
/**
|
|
554
559
|
* `AccessibilityWindowInfo` types of the listed windows the helper could not serialize because
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{gt as e}from"./sdk-io.js";import"./file.js";import{a as t,r as n,s as r,t as i}from"./code-signature.js";import a from"node:crypto";import o from"node:fs";import s from"node:os";import c from"node:path";function l(e,a){let o=t(a),s=t(e),c=v(s,o),l=i(o,s),d=u(c,o,l);if(d)return n(d.files);let p;try{p=r(s,o)}catch{return`unknown`}return f(p.files,l)&&_(c,p),n(p.files)}function u(e,t,n){let r=p(e);if(!(!r||!f(r.files,n))){for(let[e,n,i]of r.files){let r=d(c.resolve(t,e));if(!r?.isFile()||r.size!==n||Math.trunc(r.mtimeMs)!==i)return}for(let e of r.absentPaths)if(d(c.resolve(t,e))?.isFile())return;return r}}function d(e){try{return o.statSync(e)}catch{return}}function f(e,t){return e.some(([e])=>e===t)}function p(e){let t=m(e);if(!t)return;let n=[];for(let e of t.files){let t=g(e);if(!t)return;n.push(t)}if(t.absent.every(e=>typeof e==`string`))return{files:n,absentPaths:t.absent}}function m(e){let t=h(e);if(t===void 0)return;let n;try{n=JSON.parse(t)}catch{return}if(!n||typeof n!=`object`)return;let r=n;if(r.version===2&&!(!Array.isArray(r.files)||!Array.isArray(r.absent)))return{files:r.files,absent:r.absent}}function h(e){let t;try{t=o.openSync(e,`r`)}catch{return}try{let e=process.getuid?.();return e!==void 0&&o.fstatSync(t).uid!==e?void 0:o.readFileSync(t,`utf8`)}catch{return}finally{o.closeSync(t)}}function g(e){if(!Array.isArray(e)||e.length!==3)return;let[t,n,r]=e;if(typeof t==`string`&&typeof n==`number`&&typeof r==`number`)return[t,n,r]}function _(t,n){let r={version:2,files:[...n.files],absent:[...n.absentPaths]};try{o.mkdirSync(c.dirname(t),{recursive:!0,mode:448}),e({destination:t,contents:JSON.stringify(r),mode:384})}catch{}}function v(e,t){let n=a.createHash(`sha1`).update(`${t} ${e}`).digest(`hex`),r=`agent-device-code-signature-${process.getuid?.()??`user`}`;return c.join(s.tmpdir(),r,`${n}.json`)}export{l as resolveCachedDaemonCodeSignature};
|
|
@@ -1,17 +1,19 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{_ as e}from"./sdk-contracts.js";import{D as t,O as n,l as r,o as i,w as a}from"./src3.js";const o={plugins:{text:{summary:`Manage installed provider plugins`,description:`Install, list, update, or remove npm provider plugins in AGENT_DEVICE_HOME (default ~/.agent-device). Changes take effect after restarting the local daemon. list works offline and, when a daemon is running for --state-dir, also reports the providers it registered. Use --json for structured results.`},usageOverride:`plugins list [--state-dir <path>]|add <package[@version]>|update <package>|remove <package>`,listUsageOverride:`plugins`,positionalArgs:[`list|add|update|remove`,`package?`],flagsByAction:{list:[`stateDir`],add:[],update:[],remove:[]},supportedFlags:[`stateDir`]},cdp:{text:{summary:`Inspect CDP targets, JS heap, and leaks`,description:`Run CDP commands for React Native diagnostics, JS heap usage, heap snapshots, and leak analysis`},usageOverride:`cdp [...args]`,listUsageOverride:`cdp`,positionalArgs:[`args?`],allowsExtraPositionals:!0,supportedFlags:a},auth:{text:{summary:`Manage cloud login state`,description:`Manage cloud login state used by remote daemon and cloud device workflows.`},usageOverride:`auth status|login|logout`,listUsageOverride:`auth`,positionalArgs:[`status|login|logout`],supportedFlags:[`remoteConfig`,`stateDir`]},daemon:{text:{summary:`Stop a local daemon or show the providers it registered`,description:`stop stops a local daemon after verifying its PID/start-time identity. Use --clean to remove retained Apple runner processes and leases owned by that daemon. status reads the daemon record without contacting the daemon and lists every provider plugin it registered, built in or installed, with the reason any plugin failed to register. Use --json for structured results.`},usageOverride:`daemon stop [--clean] [--state-dir <path>] | daemon status [--state-dir <path>]`,usageFlags:[],listUsageOverride:`daemon stop|status`,positionalArgs:[`stop|status`],allowedFlags:[`clean`],flagsByAction:{stop:[`clean`],status:[]},supportedFlags:[`stateDir`]},device:{text:{summary:`Inspect and recover enforced local device ownership without a daemon`,description:`Inspect enforced host-local device ownership claims without starting or contacting a daemon; status --stale only inspects proven-stale claims. release --stale settles a provably dead owner through exact-owner resource reconciliation and clears its claim last — live and uncertain owners always fail closed. Automatic reclamation still occurs during open and daemon startup.`},usageOverride:`device status|release [--platform <platform>] [--udid <udid>] [--serial <serial>]`,listUsageOverride:`device status`,positionalArgs:[`status|release`],allowedFlags:[`stale`],supportedFlags:[`platform`,`device`,`udid`,`serial`],explicitOnlyFlags:[`platform`,`device`,`udid`,`serial`]},connect:{text:{summary:`Configure remote or provider state`,description:`Configure remote access without allocating a device. Direct providers validate credentials/resources before saving state and print the exact device/app preparation needed before open. AGENT_DEVICE_CLOUD_BASE_URL is the bridge/control-plane API origin; use AGENT_DEVICE_DAEMON_AUTH_TOKEN=adc_live_... for CI/service-token automation.`},usageOverride:`connect [provider] [--remote-config <path>] [--daemon-base-url <url>] [--tenant <id>] [--run-id <id>] [--lease-id <id>] [--lease-backend <backend>] [--force] [--no-login]`,usageFlags:[],listUsageOverride:`connect`,positionalArgs:[`provider?`],allowedFlags:[`remoteConfig`,`daemonBaseUrl`,`tenant`,`runId`,`leaseId`,`leaseBackend`,`providerApp`,`providerOsVersion`,`providerDeviceType`,`providerProject`,`providerBuild`,`providerSessionName`,`providerDeviceOrientation`,`providerGeoLocation`,`providerTimezone`,`providerAppiumVersion`,`providerLanguage`,`providerLocale`,`providerNetworkProfile`,`providerCustomNetwork`,`providerNoResignApp`,`providerNetworkLogs`,`providerNetworkHosts`,`awsProjectArn`,`awsDeviceArn`,`awsAppArn`,`awsRegion`,`awsInteractionMode`,...t,`force`,`noLogin`],supportedFlags:[`stateDir`,`daemonAuthToken`,`session`,`platform`,`device`,...n,`launchUrl`]},connection:{text:{summary:`Inspect the saved remote connection`,description:`Inspect active remote connection state`},usageOverride:`connection status`,listUsageOverride:`connection`,positionalArgs:[`status`],supportedFlags:[`remoteConfig`,`stateDir`,`session`]},disconnect:{text:{summary:`Clear remote connection state and release leases`,description:`Disconnect remote daemon state, stop owned Metro companion, and release lease`},listUsageOverride:`disconnect`,allowedFlags:[`shutdown`],supportedFlags:[`remoteConfig`,`stateDir`,`session`]},mcp:{text:{summary:`Start MCP server`,description:`Start the official stdio MCP server. It exposes command tools backed by the agent-device client. Tool results are compact text by default; a non-default AGENT_DEVICE_RESPONSE_LEVEL or AGENT_DEVICE_COST returns JSON text. With --structured, tools also advertise output schemas and return structuredContent, including errors, for clients that read results as data. It accepts no other flags or arguments besides --structured, --help, and --version; configure it with AGENT_DEVICE_* environment variables or AGENT_DEVICE_CONFIG.`},allowedFlags:[`mcpStructured`]},proxy:{text:{summary:`Expose a local daemon through an HTTP tunnel`,description:`Expose the local daemon HTTP contract through a tunnel-friendly reverse proxy.
|
|
2
2
|
|
|
3
3
|
Run this on the host that has access to simulators/devices, expose the printed local proxy URL through a tunnel, then point another machine at the tunnel URL with connect proxy.
|
|
4
4
|
|
|
5
5
|
The proxy starts or reuses a local HTTP daemon, accepts /health, /rpc, /upload and resumable /upload/* routes, and /artifacts plus /artifacts/*, and also accepts the same routes under /agent-device/*. Health is unauthenticated for reachability probes. Other routes require the generated bearer token printed at startup, or the explicit --daemon-auth-token value when provided. The proxy rewrites authorized client requests to the upstream daemon token instead of exposing the local daemon token.
|
|
6
6
|
|
|
7
|
+
For a TLS-terminated tunnel, set --public-origin to the public HTTP(S) origin, for example --public-origin https://public.example:8443. Forwarded and X-Forwarded-* headers do not select upload ticket origins. For an ephemeral tunnel, obtain its public name first, then configure and restart the proxy. Without a fixed origin, Node uses the actual socket scheme and validated Host.
|
|
8
|
+
|
|
7
9
|
Use the /agent-device base path when connecting through cloudflared, ngrok, or another shared origin. Treat the bearer token as a secret; anyone with it can control the proxied daemon. This direct proxy flow does not use agent-device auth.
|
|
8
10
|
|
|
9
|
-
Remote captures write generated artifacts on the daemon. Screenshot, recording, performance, and trace paths select downloads on the client; they never select host files. Direct RPC callers download returned artifact IDs through /artifacts/<id>. Remote requests ignore client cwd and refuse host tooling paths
|
|
11
|
+
Remote captures write generated artifacts on the daemon. Screenshot, recording, performance, and trace paths select downloads on the client; they never select host files. Direct RPC callers download returned artifact IDs through /artifacts/<id>. Remote requests ignore client cwd and refuse host tooling paths and --launch-console. A fresh open --save-script=<path> arms recording; after each recorded action the client refreshes that caller file, and close writes the final script there. Remote session save-script, close/replay --save-script, and --save-script in batch steps remain refused.
|
|
10
12
|
|
|
11
13
|
Examples:
|
|
12
|
-
agent-device proxy --port 4310
|
|
13
14
|
cloudflared tunnel --url http://127.0.0.1:4310
|
|
14
|
-
agent-device
|
|
15
|
+
agent-device proxy --port 4310 --public-origin https://example.trycloudflare.com
|
|
16
|
+
agent-device connect proxy --daemon-base-url https://example.trycloudflare.com/agent-device --daemon-auth-token <token>`},listUsageOverride:`proxy`,allowedFlags:[`proxyHost`,`proxyPort`,`publicOrigin`,`daemonAuthToken`,`stateDir`]},takeover:{text:{summary:`Pause agent interactions while a person controls a device`,description:`Temporarily hand control of the active remote lease device to a person. The foreground command pauses state-changing agent commands, renews the hold until Ctrl+C, and then releases it. Read-only diagnostics remain available. Uses the active connection and --session, with normal tenant and lease admission. status lists holds on that device; release removes a hold owned by the admitted lease. The host-only /admin/human-control/holds API uses the separate local daemon token. Holds do not survive daemon restart. Local takeover without a remote device lease is not supported.`},usageOverride:`takeover [status | release <hold-id>] [--session <name>]`,listUsageOverride:`takeover [status|release]`,positionalArgs:[`status|release?`,`hold-id?`],supportedFlags:[`stateDir`,`session`,`remoteConfig`,`daemonBaseUrl`,`daemonAuthToken`,`daemonTransport`,`tenant`,`runId`,`leaseId`,`leaseBackend`,`sessionIsolation`]},"react-devtools":{text:{summary:`React Native components, props/state/hooks, and render profiling`,description:`Inspect React Native components and profile their renders through the Metro dev server`},usageOverride:`react-devtools tree [@ref|Name]|find <Name>|inspect <@ref|Name>|errors|profile start|stop|report [Component]|commit [N]`,listUsageOverride:`react-devtools`,positionalArgs:[`args?`],allowsExtraPositionals:!0,supportedFlags:a},web:{text:{summary:`Manage web automation backend`,description:`Install and inspect the managed web automation backend used by --platform web.
|
|
15
17
|
|
|
16
18
|
First-run flow:
|
|
17
19
|
agent-device web setup
|