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 +1 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{_ as e}from"./sdk-contracts.js";import{J as t,Z as n}from"./sdk-device.js";import{r}from"./session-paths.js";import{a as i,c as a,i as o,l as s,n as c,o as l,r as u}from"./durable-capture.js";import d from"node:crypto";import f from"node:path";function p(e,t){t.admissionLedger.assertStartAllowed(t.device),h(e,t.resourcePath,t.device);let n=e.store.read(t.resourcePath);return Object.freeze({token:d.randomUUID(),generation:n.status===`decoded`?n.envelope.fence.generation+1:1})}function m(r,i,a){let o=t(a),c=f.dirname(f.dirname(i)),l=[];for(let t of r.store.list(c)){let a=r.store.read(t);if(a.status===`unreattachable`)throw new e(`COMMAND_FAILED`,`${s(g(r.displayName))} ${r.displayName} recovery record is unreattachable: ${a.message}`,{reason:a.reason,retriable:!1,hint:`Retain the corrupt or future-version ${r.displayName} manifest for manual recovery; no replacement capture is safe.`});if(a.status!==`decoded`||a.envelope.lifecycle===`completed`)continue;let c=n(a.envelope.device,o);(c||t===i)&&l.push({resourcePath:t,envelope:a.envelope,onStartDevice:c})}return{sessionsDir:c,records:l}}function h(t,n,r){let[i]=m(t,n,r).records;if(!i)return;let a=i.envelope.sessionId,o=i.onStartDevice?void 0:i.envelope.device.id;throw new e(`COMMAND_FAILED`,`${s(g(t.displayName))} ${t.displayName} resource for this ${o?`session`:`device`} has not reached a confirmed terminal state`,{reason:`cleanup-unconfirmed`,session:a,hint:o?`The open ${t.displayName} record of session "${a}" is on device "${o}". Stop it in that session, or start this one under another session name.`:`The open ${t.displayName} record belongs to session "${a}". Stop or close that session, or retry once its device is reachable; exact-owner cleanup must confirm it before a replacement starts.`})}function g(e){return/^[aeiou]/i.test(e)?`an`:`a`}function _(e){let t=(t,n)=>e.store.resolvePath(t.resolveSessionDir(n)),n=t=>({definition:e,resolveSessionDir:e=>f.join(t.sessionsDir,r(e)),...t});return Object.freeze({store:e.store,resourcePath:t,createNextFence(t){return p(e,t)},adoptStarted(t){return a(e,{...t,reportUndurableCleanup:(e,n)=>{n.confirmed?t.admissionLedger.clearUndurableCleanup(e):t.admissionLedger.blockUndurableCleanup(e,n.reason)}},e.store.resolvePath(t.binding.sessionDir))},finishLive(t){return i(e,t,e.store.resolvePath(t.binding.sessionDir))},finishRecovered(t){return c(e,t)},forceCleanupLive(t){return l(e,{...t,resourcePath:e.store.resolvePath(t.binding.sessionDir)})},recoverAll(e){return o(n(e))},recoverOne(e,t){return u(n(e),t)},async settleStartConflicts(t){let{resourcePath:r,device:i,holdsSession:a,...o}=t,s=m(e,r,i);for(let t of s.records)if(!(!t.onStartDevice||a(t.envelope.sessionId)))try{await c(e,{resourcePath:t.resourcePath,scope:o.scope,acquireControl:o.acquireControl})}catch{await u(n({...o,sessionsDir:s.sessionsDir}),t.resourcePath)}}})}export{_ as t};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{P as e,q as t}from"./sdk-contracts.js";import{ft as n,yt as r}from"./sdk-io.js";import"./diagnostics.js";import{X as i,q as a}from"./sdk-device.js";import{Tn as o}from"./sdk-batch.js";import{i as s}from"./verified-file.js";import"./file.js";import{i as c,n as l,r as u}from"./durable-resource.js";import d from"node:fs";import f from"node:path";function p(e){return e.length===0?e:e[0].toUpperCase()+e.slice(1)}function m(e){return e.replaceAll(`-`,`_`)}async function h(e,t,n){let r={kind:`pending`};try{t.binding.assertAdoptable();let i=S(b(e,t),`active`);e.store.write(n,i),r={kind:`persisted`},t.throwIfCanceled();let a=t.pendingHandle.transfer();r={kind:`transferred`,handle:a},t.binding.adopt({handle:a,envelope:i})}catch(i){throw await g(e,t,n,r,i),i}}async function g(e,t,n,r,i){let a=t.binding.canPersist(),o=r.kind!==`pending`||a&&te(e,t,n),s=_(e,t,n,await ee(t,r));t.reportUndurableCleanup(t.device,!o&&s.cleanupError===void 0||s.confirmed?{confirmed:!0}:{confirmed:!1,reason:s.cleanupError instanceof Error?s.cleanupError.message:`The durable cleanup transition could not be confirmed`}),s.cleanupError!==void 0&&re(e,t,i,s.cleanupError)}function _(e,t,n,i){try{return{confirmed:ne(e,n,t.fence,i),cleanupError:i}}catch(n){return r({level:`error`,phase:`${m(e.resourceKind)}_pending_adoption_transition_failed`,data:{session:t.binding.address,transitionError:n instanceof Error?n.message:String(n)}}),{confirmed:!1,cleanupError:i??n}}}async function ee(e,t){try{t.kind===`transferred`?await t.handle[Symbol.asyncDispose]():await e.pendingHandle[Symbol.asyncDispose]();return}catch(e){return e}}function te(e,t,n){try{return e.store.write(n,v(e,t)),!0}catch(i){try{return e.store.write(n,y(e,t,{version:0,body:{reason:`runtime-contract-invalid`}})),!0}catch(n){return r({level:`error`,phase:`${m(e.resourceKind)}_runtime_contract_tombstone_failed`,data:{session:t.binding.address,descriptorError:i instanceof Error?i.message:String(i),persistenceError:n instanceof Error?n.message:String(n)}}),!1}}}function v(e,t){try{return S(b(e,t),`active`)}catch{return y(e,t,t.envelope.descriptor)}}function y(e,t,n){return u({resourceKind:e.resourceKind,sessionId:t.binding.address,device:a(t.device),owner:t.owner,fence:t.fence,lifecycle:`open`,descriptor:n,metadata:{phase:`runtime-contract-invalid`,runtimeContractInvalid:!0}})}function b(t,n){let r=c(n.envelope);if(r.status===`decoded`&&x(r.envelope,n,t.resourceKind))return r.envelope;throw new e(`COMMAND_FAILED`,`${p(t.displayName)} runtime returned an incoherent durable envelope`,{reason:`runtime-contract-invalid`,hint:`Retain the runtime diagnostics and report the selected device and owner.`})}function x(e,t,n){return e.resourceKind===n&&e.sessionId===t.binding.address&&i(e.device,a(t.device))&&o(e.owner)===o(t.owner)&&e.fence.token===t.fence.token&&e.fence.generation===t.fence.generation&&e.lifecycle===`open`}function ne(e,t,n,r){let i=e.store.read(t);return i.status!==`decoded`||i.envelope.fence.token!==n.token||i.envelope.fence.generation!==n.generation?!1:(e.store.write(t,{...i.envelope,lifecycle:r===void 0?`completed`:`open`,metadata:{...i.envelope.metadata??{},phase:r===void 0?`completed`:`cleanup-pending`,cleanupStatus:r===void 0?`cleaned`:`cleanup-pending`}}),!0)}function re(e,t,n,i){r({level:`error`,phase:`${m(e.resourceKind)}_pending_adoption_cleanup_failed`,data:{session:t.binding.address,primaryError:n instanceof Error?n.message:String(n),cleanupError:i instanceof Error?i.message:String(i)}})}function S(e,t){return Object.freeze({...e,lifecycle:`open`,metadata:{...e.metadata??{},phase:t}})}async function C(e){e.scope.signal.throwIfAborted();let t=new AbortController,n={...e.scope,signal:AbortSignal.any([e.scope.signal,t.signal])},r=()=>{},i=new Promise((e,t)=>{r=t}),a=()=>{},o=new Promise((t,n)=>{let r=()=>{try{e.scope.signal.throwIfAborted()}catch(e){n(e)}};if(e.scope.signal.aborted){r();return}e.scope.signal.addEventListener(`abort`,r,{once:!0}),a=()=>e.scope.signal.removeEventListener(`abort`,r)}),s=setTimeout(()=>{let n=new D(e.displayName,e.deadlineMs);t.abort(n),r(n)},e.deadlineMs);s.unref?.();let c=T(e,n),l,u=c.then(e=>(l??={kind:`acquisition`},e),e=>{throw l??={kind:`acquisition-error`},e}),d=i.catch(e=>{throw l??={kind:`deadline`,error:e},e}),f=o.catch(e=>{throw l??={kind:`cancellation`,error:e},e});try{return await Promise.race([u,d,f])}finally{if(clearTimeout(s),a(),l?.kind===`deadline`||l?.kind===`cancellation`){let t=l.error;c.then(n=>w(e,n,t),()=>{}).catch(()=>{})}else c.catch(()=>{})}}async function w(e,t,n){try{t.reattached.status===`active`&&await E(e,t.reattached.handle,`late_handle_cleanup_failed`,n)}finally{await E(e,t.control,`late_control_cleanup_failed`,n)}}async function T(e,t){let n,r;try{return n=await e.acquireControl(e.envelope,t),t.signal.throwIfAborted(),r=await n.reattach(e.envelope),t.signal.throwIfAborted(),{control:n,reattached:r}}catch(t){try{r?.status===`active`&&await E(e,r.handle,`late_handle_cleanup_failed`,t)}finally{n&&await E(e,n,`late_control_cleanup_failed`,t)}throw t}}async function E(e,t,n,r){try{await t[Symbol.asyncDispose]()}catch(t){e.onLateCleanupFailure(n,t,r)}}var D=class extends Error{deadlineMs;constructor(e,t){super(`${p(e)} recovery exceeded its ${t}ms deadline`),this.name=`DurableCaptureRecoveryDeadlineError`,this.deadlineMs=t}};const O=new Map;async function k(e){return await ie(e.resourcePath,async()=>{let t=A(e.store,e.resourcePath,e.expected);if(t.envelope.lifecycle===`completed`)return await e.onCompleted({envelope:t.envelope});let n=t.envelope,r=!0;try{return await e.run({get envelope(){return n},transition(t,i={}){let a=A(e.store,e.resourcePath,e.expected);if(a.envelope.lifecycle===`completed`)throw N(e.store);if(!r)throw ae(e.store);return n=Object.freeze({...a.envelope,lifecycle:t,...i.descriptor===void 0?{}:{descriptor:i.descriptor},...i.metadata===void 0?{}:{metadata:i.metadata}}),e.store.write(e.resourcePath,n),n}})}finally{r=!1}})}function A(e,t,n){let r=e.read(t);if(r.status!==`decoded`)throw M(e,r.status===`missing`?`${e.displayName} resource record is missing`:`${e.displayName} resource record is unreattachable: ${r.message}`);if(!j(r.envelope.fence,n))throw M(e,`${e.displayName} resource ownership fence was lost`);return r}function j(e,t){return e.token===t.token&&e.generation===t.generation}async function ie(e,t){let n=O.get(e)??Promise.resolve(),r,i=new Promise(e=>{r=e}),a=n.catch(()=>{}).then(()=>i);O.set(e,a),await n.catch(()=>{});try{return await t()}finally{r(),O.get(e)===a&&O.delete(e)}}function M(t,n){return new e(`COMMAND_FAILED`,n,{reason:`ownership-fence-lost`,retriable:!1,hint:`Use the current ${t.displayName.toLowerCase()} resource owner or retain the recovery record for manual recovery.`})}function ae(e){return M(e,`${e.displayName} resource fence was released with its run`)}function oe(t){return t instanceof e&&t.details?.reason===`resource-already-completed`}function N(t){return new e(`COMMAND_FAILED`,`${t.displayName} resource record is already completed`,{reason:`resource-already-completed`,retriable:!1,hint:`Read the completed ${t.displayName.toLowerCase()} record instead of finishing or cleaning it again.`})}async function P(t,n,r){let i=n.binding.read();if(!i)throw new e(`INVALID_ARGS`,t.messages.noActive);let a=!1;try{let e=await F(t,{handle:i.handle,fence:i.envelope.fence,resourcePath:r,intent:n.intent,onCleanupPending:()=>{a=!0}});return a||n.binding.clear(i),e}catch(e){let o=t.store.read(r);throw!a&&o.status===`decoded`&&o.envelope.lifecycle===`completed`&&n.binding.clear(i),e}}async function F(e,n){return await k({store:e.store,resourcePath:n.resourcePath,expected:n.fence,onCompleted:async({envelope:i})=>{let a;try{a=await n.handle.forceCleanup()}catch(e){a={status:`cleanup-pending`,reason:`cleanup-unconfirmed`,message:t(e)}}if(!l(a)&&(n.onCleanupPending?.(a),r({level:`warn`,phase:`${m(e.resourceKind)}_terminal_cleanup_pending`,data:{resourcePath:n.resourcePath,cleanup:a}}),n.intent===`disposal`))throw W(e,a);let o=await e.completionFromMetadata?.(i.metadata);if(o!==void 0)return o;throw l(a)?N(e.store):W(e,a)},run:async t=>{q(t);let r=K(t),i;try{i=await n.handle.finish(r)}catch(r){throw await I(e,t,n,r,n.intent),r}if(i.status===`completed`)return G(e,t,i),i.result;G(e,t,i);let a=W(e,i);throw await I(e,t,n,a,n.intent),a}})}async function I(e,t,n,r,i){if(i===`capture`&&e.failedFinishPolicy===`preserve-retry-material`){R(e,n,r);return}let a;try{a=await n.handle.forceCleanup()}catch(i){z(e,n,r,i,L(t,i));return}try{H(t,a)}catch(t){z(e,n,r,a.status===`cleanup-pending`?a.message??a.reason:`cleanup returned ${a.status}`,t);return}l(a)||z(e,n,r,a.message)}function L(e,n){try{H(e,{status:`cleanup-pending`,reason:`cleanup-unconfirmed`,message:t(n)});return}catch(e){return e}}function R(e,n,i){r({level:`error`,phase:`${m(e.resourceKind)}_finish_evidence_preserved`,data:{resourcePath:n.resourcePath,finishError:t(i),failedFinishPolicy:e.failedFinishPolicy}})}function z(e,n,i,a,o){r({level:`error`,phase:`${m(e.resourceKind)}_finish_cleanup_failed`,data:{resourcePath:n.resourcePath,finishError:t(i),cleanupError:a===void 0?`cleanup could not be confirmed`:t(a),...o===void 0?{}:{transitionError:t(o)}}})}async function B(e,t){let n=t.binding.read();n&&(U(e,await k({store:e.store,resourcePath:t.resourcePath,expected:n.envelope.fence,onCompleted:async()=>await n.handle.forceCleanup(),run:async e=>{q(e);let t=await n.handle.forceCleanup();return H(e,t),t}})),t.binding.clear(n))}async function V(e,t){return await k({store:e.store,resourcePath:t.resourcePath,expected:t.envelope.fence,onCompleted:()=>({status:`already-missing`}),run:async e=>{let n=await t.cleanup();return H(e,n),n}})}function H(e,t){e.transition(l(t)?`completed`:`open`,{metadata:{...e.envelope.metadata??{},phase:l(t)?`completed`:`cleanup-pending`,cleanupStatus:t.status,...t.status===`cleanup-pending`?{cleanupPendingReason:t.reason,...t.message?{cleanupPendingMessage:t.message}:{}}:{}}})}function U(e,t){if(!l(t))throw W(e,t)}function W(t,n){return new e(`COMMAND_FAILED`,n.message??`${p(t.displayName)} cleanup could not be confirmed`,{reason:n.reason,cleanupStatus:n.status,retriable:n.reason!==`ownership-fence-lost`,hint:t.messages.cleanupPendingHint})}function G(e,t,n){if(n.status===`completed`){t.transition(`completed`,{metadata:{...t.envelope.metadata??{},...e.completionMetadata(n.result),phase:`completed`}});return}H(t,n)}function K(e){return Object.freeze({learned:e.envelope.metadata,record:t=>{e.transition(`open`,{metadata:{...e.envelope.metadata??{},...t}})}})}function q(e){e.transition(`open`,{metadata:{...e.envelope.metadata??{},phase:`completing`}})}async function se(e){let t=e.definition.store.list(e.sessionsDir),n=[];for(let r of t)n.push(e.scope.signal.aborted?`retained`:await J(e,r));return{scanned:t.length,recovered:n.filter(e=>e===`recovered`).length,retained:n.filter(e=>e===`retained`).length}}async function J(e,t){let n=ce(e,t);if(n.status!==`recoverable`)return n.status;try{return await le(e,t,n.envelope,e.acquisitionDeadlineMs??5e3)?`recovered`:`retained`}catch(n){return Z(e,n instanceof D?`timed_out`:`failed`,t,{error:n instanceof Error?n.message:String(n),...n instanceof D?{deadlineMs:n.deadlineMs}:{}}),`retained`}}function ce(e,t){let n=e.definition.store.read(t);if(n.status===`unreattachable`)return Z(e,`record_unreattachable`,t,{reason:n.reason,message:n.message,version:n.version}),{status:`retained`};if(n.status===`missing`||n.envelope.lifecycle===`completed`)return{status:`ignored`};let r=e.definition.store.resolvePath(e.resolveSessionDir(n.envelope.sessionId));return f.resolve(t)===f.resolve(r)?{status:`recoverable`,envelope:n.envelope}:(Z(e,`session_path_mismatch`,t,{envelopeSessionId:n.envelope.sessionId,canonicalPath:r}),{status:`retained`})}async function le(e,t,n,r){return await ue(e,t,n,await C({displayName:e.definition.displayName,envelope:n,scope:e.scope,deadlineMs:r,acquireControl:e.acquireControl,onLateCleanupFailure:(n,r,i)=>Z(e,n,t,{error:r instanceof Error?r.message:String(r),primaryError:i instanceof Error?i.message:String(i)})}))}async function ue(e,t,n,r){try{switch(r.reattached.status){case`active`:{let i=r.reattached.handle,a=await k({store:e.definition.store,resourcePath:t,expected:n.fence,onCompleted:async()=>await i.forceCleanup(),run:async e=>{q(e);let t=await i.forceCleanup();return H(e,t),t}});return l(a)}case`completed`:return await Y(e,t,n,{...e.definition.completionMetadata(r.reattached.result)}),!0;case`missing`:return await Y(e,t,n,{recoveryStatus:`already-missing`}),!0;case`unreattachable`:{if(!X(r.reattached.reason))return Z(e,`retained`,t,{reason:r.reattached.reason,message:r.reattached.message}),!1;let i=await V(e.definition,{envelope:n,resourcePath:t,cleanup:()=>r.control.cleanup(n)});return l(i)}}}finally{await r.control[Symbol.asyncDispose]()}}async function Y(e,t,n,r){await k({store:e.definition.store,resourcePath:t,expected:n.fence,onCompleted:()=>void 0,run:async e=>{e.transition(`completed`,{metadata:{...e.envelope.metadata??{},phase:`completed`,...r}})}})}function X(e){switch(e){case`descriptor-invalid`:case`descriptor-version-unsupported`:case`ownership-fence-lost`:return!1;case`owner-unavailable`:case`transport-not-reattachable`:return!0}}function Z(e,t,n,i){let a={phase:`${m(e.definition.resourceKind)}_recovery_${t}`,resourcePath:n,data:i};e.onDiagnostic?e.onDiagnostic(a):r({level:`warn`,phase:a.phase,data:{resourcePath:n,...i}})}async function de(n,r){let i=n.store.read(r.resourcePath);if(i.status!==`decoded`||i.envelope.lifecycle!==`open`)throw fe(n,i.status);let a=i.envelope,o=await C({displayName:n.displayName,envelope:a,scope:r.scope,deadlineMs:r.deadlineMs??5e3,acquireControl:r.acquireControl,onLateCleanupFailure:(e,i,a)=>r.scope.diagnostics.emit({level:`error`,phase:`${m(n.resourceKind)}_recovery_${e}`,data:{resourcePath:r.resourcePath,error:t(i),primaryError:t(a)}})});try{switch(o.reattached.status){case`active`:return await F(n,{handle:o.reattached.handle,fence:a.fence,resourcePath:r.resourcePath,intent:`capture`});case`completed`:{let e=o.reattached.result;return await k({store:n.store,resourcePath:r.resourcePath,expected:a.fence,onCompleted:()=>void 0,run:async t=>{G(n,t,{status:`completed`,result:e,alreadyCompleted:!0})}}),e}case`missing`:throw new e(`COMMAND_FAILED`,`${p(n.displayName)} is missing`,{reason:`resource-missing`,hint:n.messages.cleanupPendingHint});case`unreattachable`:throw X(o.reattached.reason)&&U(n,await V(n,{envelope:a,resourcePath:r.resourcePath,cleanup:()=>o.control.cleanup(a)})),new e(`COMMAND_FAILED`,o.reattached.message??`${p(n.displayName)} cannot be reattached`,{reason:o.reattached.reason,hint:n.messages.cleanupPendingHint})}}finally{await o.control[Symbol.asyncDispose]()}}function fe(t,n){return new e(`INVALID_ARGS`,n===`missing`?t.messages.noActive:`${p(t.displayName)} recovery record is not open`)}function pe(e){he(e.fileName);let t=t=>f.join(t,e.fileName);return Object.freeze({resourceKind:e.resourceKind,displayName:e.displayName,resolvePath:t,read(t){let n,r;try{if(n=s(t),n===void 0)return{status:`missing`};r=JSON.parse(d.readFileSync(n,`utf8`))}catch(t){return $(t)?{status:`missing`}:Q(_e(t,e.displayName))}finally{n!==void 0&&d.closeSync(n)}return me(c(r),e.resourceKind)},write(e,t){let r=f.dirname(e);d.mkdirSync(r,{recursive:!0}),n({destination:e,contents:`${JSON.stringify(t)}\n`})},list(e){let n;try{n=d.readdirSync(e,{withFileTypes:!0})}catch{return[]}return n.filter(e=>e.isDirectory()).map(n=>t(f.join(e,n.name))).filter(ge).sort()}})}function me(e,t){return e.status===`decoded`?e.envelope.resourceKind===t?{status:`decoded`,envelope:e.envelope}:Q(`Expected ${t} resource record, received ${e.envelope.resourceKind}`):e}function he(e){if(e.length===0||f.basename(e)!==e)throw TypeError(`Durable capture resource fileName must be one file name`)}function ge(e){try{return d.lstatSync(e),!0}catch(e){return!$(e)}}function Q(e){return{status:`unreattachable`,reason:`descriptor-invalid`,message:e}}function $(e){return typeof e==`object`&&!!e&&`code`in e&&e.code===`ENOENT`}function _e(e,t){return e instanceof Error?e.message:`${t} resource record is invalid`}export{P as a,h as c,se as i,p as l,de as n,B as o,J as r,oe as s,pe as t};
|
|
1
|
+
import{On as e}from"./sdk-batch.js";import{A as t,_ as n}from"./sdk-contracts.js";import{St as r,ht as i}from"./sdk-io.js";import"./diagnostics.js";import{J as a,Z as o}from"./sdk-device.js";import{i as s}from"./verified-file.js";import"./file.js";import{i as c,n as l,r as u}from"./durable-resource.js";import d from"node:fs";import f from"node:path";function p(e){return e.length===0?e:e[0].toUpperCase()+e.slice(1)}function m(e){return e.replaceAll(`-`,`_`)}async function h(e,t,n){let r={kind:`pending`};try{t.binding.assertAdoptable();let i=S(b(e,t),`active`);e.store.write(n,i),r={kind:`persisted`},t.throwIfCanceled();let a=t.pendingHandle.transfer();r={kind:`transferred`,handle:a},t.binding.adopt({handle:a,envelope:i})}catch(i){throw await g(e,t,n,r,i),i}}async function g(e,t,n,r,i){let a=t.binding.canPersist(),o=r.kind!==`pending`||a&&te(e,t,n),s=_(e,t,n,await ee(t,r));t.reportUndurableCleanup(t.device,!o&&s.cleanupError===void 0||s.confirmed?{confirmed:!0}:{confirmed:!1,reason:s.cleanupError instanceof Error?s.cleanupError.message:`The durable cleanup transition could not be confirmed`}),s.cleanupError!==void 0&&re(e,t,i,s.cleanupError)}function _(e,t,n,i){try{return{confirmed:ne(e,n,t.fence,i),cleanupError:i}}catch(n){return r({level:`error`,phase:`${m(e.resourceKind)}_pending_adoption_transition_failed`,data:{session:t.binding.address,transitionError:n instanceof Error?n.message:String(n)}}),{confirmed:!1,cleanupError:i??n}}}async function ee(e,t){try{t.kind===`transferred`?await t.handle[Symbol.asyncDispose]():await e.pendingHandle[Symbol.asyncDispose]();return}catch(e){return e}}function te(e,t,n){try{return e.store.write(n,v(e,t)),!0}catch(i){try{return e.store.write(n,y(e,t,{version:0,body:{reason:`runtime-contract-invalid`}})),!0}catch(n){return r({level:`error`,phase:`${m(e.resourceKind)}_runtime_contract_tombstone_failed`,data:{session:t.binding.address,descriptorError:i instanceof Error?i.message:String(i),persistenceError:n instanceof Error?n.message:String(n)}}),!1}}}function v(e,t){try{return S(b(e,t),`active`)}catch{return y(e,t,t.envelope.descriptor)}}function y(e,t,n){return u({resourceKind:e.resourceKind,sessionId:t.binding.address,device:a(t.device),owner:t.owner,fence:t.fence,lifecycle:`open`,descriptor:n,metadata:{phase:`runtime-contract-invalid`,runtimeContractInvalid:!0}})}function b(e,t){let r=c(t.envelope);if(r.status===`decoded`&&x(r.envelope,t,e.resourceKind))return r.envelope;throw new n(`COMMAND_FAILED`,`${p(e.displayName)} runtime returned an incoherent durable envelope`,{reason:`runtime-contract-invalid`,hint:`Retain the runtime diagnostics and report the selected device and owner.`})}function x(t,n,r){return t.resourceKind===r&&t.sessionId===n.binding.address&&o(t.device,a(n.device))&&e(t.owner)===e(n.owner)&&t.fence.token===n.fence.token&&t.fence.generation===n.fence.generation&&t.lifecycle===`open`}function ne(e,t,n,r){let i=e.store.read(t);return i.status!==`decoded`||i.envelope.fence.token!==n.token||i.envelope.fence.generation!==n.generation?!1:(e.store.write(t,{...i.envelope,lifecycle:r===void 0?`completed`:`open`,metadata:{...i.envelope.metadata??{},phase:r===void 0?`completed`:`cleanup-pending`,cleanupStatus:r===void 0?`cleaned`:`cleanup-pending`}}),!0)}function re(e,t,n,i){r({level:`error`,phase:`${m(e.resourceKind)}_pending_adoption_cleanup_failed`,data:{session:t.binding.address,primaryError:n instanceof Error?n.message:String(n),cleanupError:i instanceof Error?i.message:String(i)}})}function S(e,t){return Object.freeze({...e,lifecycle:`open`,metadata:{...e.metadata??{},phase:t}})}async function C(e){e.scope.signal.throwIfAborted();let t=new AbortController,n={...e.scope,signal:AbortSignal.any([e.scope.signal,t.signal])},r=()=>{},i=new Promise((e,t)=>{r=t}),a=()=>{},o=new Promise((t,n)=>{let r=()=>{try{e.scope.signal.throwIfAborted()}catch(e){n(e)}};if(e.scope.signal.aborted){r();return}e.scope.signal.addEventListener(`abort`,r,{once:!0}),a=()=>e.scope.signal.removeEventListener(`abort`,r)}),s=setTimeout(()=>{let n=new D(e.displayName,e.deadlineMs);t.abort(n),r(n)},e.deadlineMs);s.unref?.();let c=T(e,n),l,u=c.then(e=>(l??={kind:`acquisition`},e),e=>{throw l??={kind:`acquisition-error`},e}),d=i.catch(e=>{throw l??={kind:`deadline`,error:e},e}),f=o.catch(e=>{throw l??={kind:`cancellation`,error:e},e});try{return await Promise.race([u,d,f])}finally{if(clearTimeout(s),a(),l?.kind===`deadline`||l?.kind===`cancellation`){let t=l.error;c.then(n=>w(e,n,t),()=>{}).catch(()=>{})}else c.catch(()=>{})}}async function w(e,t,n){try{t.reattached.status===`active`&&await E(e,t.reattached.handle,`late_handle_cleanup_failed`,n)}finally{await E(e,t.control,`late_control_cleanup_failed`,n)}}async function T(e,t){let n,r;try{return n=await e.acquireControl(e.envelope,t),t.signal.throwIfAborted(),r=await n.reattach(e.envelope),t.signal.throwIfAborted(),{control:n,reattached:r}}catch(t){try{r?.status===`active`&&await E(e,r.handle,`late_handle_cleanup_failed`,t)}finally{n&&await E(e,n,`late_control_cleanup_failed`,t)}throw t}}async function E(e,t,n,r){try{await t[Symbol.asyncDispose]()}catch(t){e.onLateCleanupFailure(n,t,r)}}var D=class extends Error{deadlineMs;constructor(e,t){super(`${p(e)} recovery exceeded its ${t}ms deadline`),this.name=`DurableCaptureRecoveryDeadlineError`,this.deadlineMs=t}};const O=new Map;async function k(e){return await ie(e.resourcePath,async()=>{let t=A(e.store,e.resourcePath,e.expected);if(t.envelope.lifecycle===`completed`)return await e.onCompleted({envelope:t.envelope});let n=t.envelope,r=!0;try{return await e.run({get envelope(){return n},transition(t,i={}){let a=A(e.store,e.resourcePath,e.expected);if(a.envelope.lifecycle===`completed`)throw N(e.store);if(!r)throw ae(e.store);return n=Object.freeze({...a.envelope,lifecycle:t,...i.descriptor===void 0?{}:{descriptor:i.descriptor},...i.metadata===void 0?{}:{metadata:i.metadata}}),e.store.write(e.resourcePath,n),n}})}finally{r=!1}})}function A(e,t,n){let r=e.read(t);if(r.status!==`decoded`)throw M(e,r.status===`missing`?`${e.displayName} resource record is missing`:`${e.displayName} resource record is unreattachable: ${r.message}`);if(!j(r.envelope.fence,n))throw M(e,`${e.displayName} resource ownership fence was lost`);return r}function j(e,t){return e.token===t.token&&e.generation===t.generation}async function ie(e,t){let n=O.get(e)??Promise.resolve(),r,i=new Promise(e=>{r=e}),a=n.catch(()=>{}).then(()=>i);O.set(e,a),await n.catch(()=>{});try{return await t()}finally{r(),O.get(e)===a&&O.delete(e)}}function M(e,t){return new n(`COMMAND_FAILED`,t,{reason:`ownership-fence-lost`,retriable:!1,hint:`Use the current ${e.displayName.toLowerCase()} resource owner or retain the recovery record for manual recovery.`})}function ae(e){return M(e,`${e.displayName} resource fence was released with its run`)}function oe(e){return e instanceof n&&e.details?.reason===`resource-already-completed`}function N(e){return new n(`COMMAND_FAILED`,`${e.displayName} resource record is already completed`,{reason:`resource-already-completed`,retriable:!1,hint:`Read the completed ${e.displayName.toLowerCase()} record instead of finishing or cleaning it again.`})}async function P(e,t,r){let i=t.binding.read();if(!i)throw new n(`INVALID_ARGS`,e.messages.noActive);let a=!1;try{let n=await F(e,{handle:i.handle,fence:i.envelope.fence,resourcePath:r,intent:t.intent,onCleanupPending:()=>{a=!0}});return a||t.binding.clear(i),n}catch(n){let o=e.store.read(r);throw!a&&o.status===`decoded`&&o.envelope.lifecycle===`completed`&&t.binding.clear(i),n}}async function F(e,n){return await k({store:e.store,resourcePath:n.resourcePath,expected:n.fence,onCompleted:async({envelope:i})=>{let a;try{a=await n.handle.forceCleanup()}catch(e){a={status:`cleanup-pending`,reason:`cleanup-unconfirmed`,message:t(e)}}if(!l(a)&&(n.onCleanupPending?.(a),r({level:`warn`,phase:`${m(e.resourceKind)}_terminal_cleanup_pending`,data:{resourcePath:n.resourcePath,cleanup:a}}),n.intent===`disposal`))throw W(e,a);let o=await e.completionFromMetadata?.(i.metadata);if(o!==void 0)return o;throw l(a)?N(e.store):W(e,a)},run:async t=>{q(t);let r=K(t),i;try{i=await n.handle.finish(r)}catch(r){throw await I(e,t,n,r,n.intent),r}if(i.status===`completed`)return G(e,t,i),i.result;G(e,t,i);let a=W(e,i);throw await I(e,t,n,a,n.intent),a}})}async function I(e,t,n,r,i){if(i===`capture`&&e.failedFinishPolicy===`preserve-retry-material`){R(e,n,r);return}let a;try{a=await n.handle.forceCleanup()}catch(i){z(e,n,r,i,L(t,i));return}try{H(t,a)}catch(t){z(e,n,r,a.status===`cleanup-pending`?a.message??a.reason:`cleanup returned ${a.status}`,t);return}l(a)||z(e,n,r,a.message)}function L(e,n){try{H(e,{status:`cleanup-pending`,reason:`cleanup-unconfirmed`,message:t(n)});return}catch(e){return e}}function R(e,n,i){r({level:`error`,phase:`${m(e.resourceKind)}_finish_evidence_preserved`,data:{resourcePath:n.resourcePath,finishError:t(i),failedFinishPolicy:e.failedFinishPolicy}})}function z(e,n,i,a,o){r({level:`error`,phase:`${m(e.resourceKind)}_finish_cleanup_failed`,data:{resourcePath:n.resourcePath,finishError:t(i),cleanupError:a===void 0?`cleanup could not be confirmed`:t(a),...o===void 0?{}:{transitionError:t(o)}}})}async function B(e,t){let n=t.binding.read();n&&(U(e,await k({store:e.store,resourcePath:t.resourcePath,expected:n.envelope.fence,onCompleted:async()=>await n.handle.forceCleanup(),run:async e=>{q(e);let t=await n.handle.forceCleanup();return H(e,t),t}})),t.binding.clear(n))}async function V(e,t){return await k({store:e.store,resourcePath:t.resourcePath,expected:t.envelope.fence,onCompleted:()=>({status:`already-missing`}),run:async e=>{let n=await t.cleanup();return H(e,n),n}})}function H(e,t){e.transition(l(t)?`completed`:`open`,{metadata:{...e.envelope.metadata??{},phase:l(t)?`completed`:`cleanup-pending`,cleanupStatus:t.status,...t.status===`cleanup-pending`?{cleanupPendingReason:t.reason,...t.message?{cleanupPendingMessage:t.message}:{}}:{}}})}function U(e,t){if(!l(t))throw W(e,t)}function W(e,t){return new n(`COMMAND_FAILED`,t.message??`${p(e.displayName)} cleanup could not be confirmed`,{reason:t.reason,cleanupStatus:t.status,retriable:t.reason!==`ownership-fence-lost`,hint:e.messages.cleanupPendingHint})}function G(e,t,n){if(n.status===`completed`){t.transition(`completed`,{metadata:{...t.envelope.metadata??{},...e.completionMetadata(n.result),phase:`completed`}});return}H(t,n)}function K(e){return Object.freeze({learned:e.envelope.metadata,record:t=>{e.transition(`open`,{metadata:{...e.envelope.metadata??{},...t}})}})}function q(e){e.transition(`open`,{metadata:{...e.envelope.metadata??{},phase:`completing`}})}async function se(e){let t=e.definition.store.list(e.sessionsDir),n=[];for(let r of t)n.push(e.scope.signal.aborted?`retained`:await J(e,r));return{scanned:t.length,recovered:n.filter(e=>e===`recovered`).length,retained:n.filter(e=>e===`retained`).length}}async function J(e,t){let n=ce(e,t);if(n.status!==`recoverable`)return n.status;try{return await le(e,t,n.envelope,e.acquisitionDeadlineMs??5e3)?`recovered`:`retained`}catch(n){return Z(e,n instanceof D?`timed_out`:`failed`,t,{error:n instanceof Error?n.message:String(n),...n instanceof D?{deadlineMs:n.deadlineMs}:{}}),`retained`}}function ce(e,t){let n=e.definition.store.read(t);if(n.status===`unreattachable`)return Z(e,`record_unreattachable`,t,{reason:n.reason,message:n.message,version:n.version}),{status:`retained`};if(n.status===`missing`||n.envelope.lifecycle===`completed`)return{status:`ignored`};let r=e.definition.store.resolvePath(e.resolveSessionDir(n.envelope.sessionId));return f.resolve(t)===f.resolve(r)?{status:`recoverable`,envelope:n.envelope}:(Z(e,`session_path_mismatch`,t,{envelopeSessionId:n.envelope.sessionId,canonicalPath:r}),{status:`retained`})}async function le(e,t,n,r){return await ue(e,t,n,await C({displayName:e.definition.displayName,envelope:n,scope:e.scope,deadlineMs:r,acquireControl:e.acquireControl,onLateCleanupFailure:(n,r,i)=>Z(e,n,t,{error:r instanceof Error?r.message:String(r),primaryError:i instanceof Error?i.message:String(i)})}))}async function ue(e,t,n,r){try{switch(r.reattached.status){case`active`:{let i=r.reattached.handle,a=await k({store:e.definition.store,resourcePath:t,expected:n.fence,onCompleted:async()=>await i.forceCleanup(),run:async e=>{q(e);let t=await i.forceCleanup();return H(e,t),t}});return l(a)}case`completed`:return await Y(e,t,n,{...e.definition.completionMetadata(r.reattached.result)}),!0;case`missing`:return await Y(e,t,n,{recoveryStatus:`already-missing`}),!0;case`unreattachable`:{if(!X(r.reattached.reason))return Z(e,`retained`,t,{reason:r.reattached.reason,message:r.reattached.message}),!1;let i=await V(e.definition,{envelope:n,resourcePath:t,cleanup:()=>r.control.cleanup(n)});return l(i)}}}finally{await r.control[Symbol.asyncDispose]()}}async function Y(e,t,n,r){await k({store:e.definition.store,resourcePath:t,expected:n.fence,onCompleted:()=>void 0,run:async e=>{e.transition(`completed`,{metadata:{...e.envelope.metadata??{},phase:`completed`,...r}})}})}function X(e){switch(e){case`descriptor-invalid`:case`descriptor-version-unsupported`:case`ownership-fence-lost`:return!1;case`owner-unavailable`:case`transport-not-reattachable`:return!0}}function Z(e,t,n,i){let a={phase:`${m(e.definition.resourceKind)}_recovery_${t}`,resourcePath:n,data:i};e.onDiagnostic?e.onDiagnostic(a):r({level:`warn`,phase:a.phase,data:{resourcePath:n,...i}})}async function de(e,r){let i=e.store.read(r.resourcePath);if(i.status!==`decoded`||i.envelope.lifecycle!==`open`)throw fe(e,i.status);let a=i.envelope,o=await C({displayName:e.displayName,envelope:a,scope:r.scope,deadlineMs:r.deadlineMs??5e3,acquireControl:r.acquireControl,onLateCleanupFailure:(n,i,a)=>r.scope.diagnostics.emit({level:`error`,phase:`${m(e.resourceKind)}_recovery_${n}`,data:{resourcePath:r.resourcePath,error:t(i),primaryError:t(a)}})});try{switch(o.reattached.status){case`active`:return await F(e,{handle:o.reattached.handle,fence:a.fence,resourcePath:r.resourcePath,intent:`capture`});case`completed`:{let t=o.reattached.result;return await k({store:e.store,resourcePath:r.resourcePath,expected:a.fence,onCompleted:()=>void 0,run:async n=>{G(e,n,{status:`completed`,result:t,alreadyCompleted:!0})}}),t}case`missing`:throw new n(`COMMAND_FAILED`,`${p(e.displayName)} is missing`,{reason:`resource-missing`,hint:e.messages.cleanupPendingHint});case`unreattachable`:throw X(o.reattached.reason)&&U(e,await V(e,{envelope:a,resourcePath:r.resourcePath,cleanup:()=>o.control.cleanup(a)})),new n(`COMMAND_FAILED`,o.reattached.message??`${p(e.displayName)} cannot be reattached`,{reason:o.reattached.reason,hint:e.messages.cleanupPendingHint})}}finally{await o.control[Symbol.asyncDispose]()}}function fe(e,t){return new n(`INVALID_ARGS`,t===`missing`?e.messages.noActive:`${p(e.displayName)} recovery record is not open`)}function pe(e){he(e.fileName);let t=t=>f.join(t,e.fileName);return Object.freeze({resourceKind:e.resourceKind,displayName:e.displayName,resolvePath:t,read(t){let n,r;try{if(n=s(t),n===void 0)return{status:`missing`};r=JSON.parse(d.readFileSync(n,`utf8`))}catch(t){return $(t)?{status:`missing`}:Q(_e(t,e.displayName))}finally{n!==void 0&&d.closeSync(n)}return me(c(r),e.resourceKind)},write(e,t){let n=f.dirname(e);d.mkdirSync(n,{recursive:!0}),i({destination:e,contents:`${JSON.stringify(t)}\n`})},list(e){let n;try{n=d.readdirSync(e,{withFileTypes:!0})}catch{return[]}return n.filter(e=>e.isDirectory()).map(n=>t(f.join(e,n.name))).filter(ge).sort()}})}function me(e,t){return e.status===`decoded`?e.envelope.resourceKind===t?{status:`decoded`,envelope:e.envelope}:Q(`Expected ${t} resource record, received ${e.envelope.resourceKind}`):e}function he(e){if(e.length===0||f.basename(e)!==e)throw TypeError(`Durable capture resource fileName must be one file name`)}function ge(e){try{return d.lstatSync(e),!0}catch(e){return!$(e)}}function Q(e){return{status:`unreattachable`,reason:`descriptor-invalid`,message:e}}function $(e){return typeof e==`object`&&!!e&&`code`in e&&e.code===`ENOENT`}function _e(e,t){return e instanceof Error?e.message:`${t} resource record is invalid`}export{P as a,h as c,se as i,p as l,de as n,B as o,J as r,oe as s,pe as t};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{Dn as e,wn as t}from"./sdk-batch.js";import{O as n,l as r}from"./sdk-device.js";const i=4096;function a(e){return s(e,{seen:new WeakSet,nodes:0},0)}function o(e){return Object.freeze(Object.fromEntries(Object.entries(e).map(([e,t])=>[e,f(t)])))}function s(e,t,n){if(!u(e)||n>32||t.seen.has(e))return!1;t.seen.add(e),t.nodes+=1;let r=t.nodes<=i&&Object.values(e).every(e=>c(e,t,n+1));return t.seen.delete(e),r}function c(e,t,n){return d(e)?!0:n>32?!1:Array.isArray(e)?l(e,t,n):s(e,t,n)}function l(e,t,n){if(t.seen.has(e))return!1;t.seen.add(e),t.nodes+=1;let r=t.nodes<=i&&e.every(e=>c(e,t,n+1));return t.seen.delete(e),r}function u(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=Object.getPrototypeOf(e);return t===Object.prototype||t===null}function d(e){return e===null?!0:typeof e==`number`?Number.isFinite(e):typeof e==`string`||typeof e==`boolean`}function f(e){return Array.isArray(e)?Object.freeze(e.map(f)):typeof e==`object`&&e?o(e):e}function p(e){if(!C(e))return g(`Durable resource envelope must be an object`);let t=e.envelopeVersion;if(!S(t))return g(`Durable resource envelopeVersion must be a non-negative integer`);if(t!==1)return{status:`unreattachable`,reason:`descriptor-version-unsupported`,message:`Unsupported durable resource envelope version: ${t}`,version:t};if(!x(e.resourceKind))return g(`Durable resource resourceKind must be a non-empty string`);if(!x(e.sessionId))return g(`Durable resource sessionId must be a non-empty string`);let n=r(e.device);if(!n)return g(`Durable resource device identity is invalid`);let i=_(e.owner);if(!i)return g(`Durable resource owner reference is invalid`);if(i.kind===`local-family`&&i.family!==n.family)return g(`Durable resource local owner does not match the device family`);let s=v(e.fence);if(!s)return g(`Durable resource ownership fence is invalid`);if(!b(e.lifecycle))return g(`Durable resource lifecycle state is invalid`);let c=y(e.descriptor);return c?e.metadata!==void 0&&!a(e.metadata)?g(`Durable resource metadata must be a JSON object`):{status:`decoded`,envelope:Object.freeze({envelopeVersion:1,resourceKind:e.resourceKind,sessionId:e.sessionId,device:n,owner:i,fence:s,lifecycle:e.lifecycle,descriptor:c,...e.metadata===void 0?{}:{metadata:o(e.metadata)}})}:g(`Durable resource descriptor is invalid`)}function m(e,t){return Object.freeze({version:e.version,body:o(e.encode(t))})}function h(e){let t=p({envelopeVersion:1,...e});if(t.status!==`decoded`)throw TypeError(t.message);return t.envelope}function g(e){return{status:`unreattachable`,reason:`descriptor-invalid`,message:e}}function _(r){return C(r)?r.kind===`local-family`&&n(r.family)?t(r.family):r.kind===`provider-runtime`&&x(r.provider)&&x(r.instance)?e(r.provider,r.instance):null:null}function v(e){return!C(e)||!x(e.token)||!S(e.generation)?null:Object.freeze({token:e.token,generation:e.generation})}function y(e){return!C(e)||!S(e.version)||!a(e.body)?null:Object.freeze({version:e.version,body:o(e.body)})}function b(e){return e===`open`||e===`completed`}function x(e){return typeof e==`string`&&e.trim().length>0}function S(e){return typeof e==`number`&&Number.isInteger(e)&&e>=0}function C(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function w(e){return e.status===`cleaned`||e.status===`already-missing`}function T(e,t){let n,r=()=>n??=e().then(e=>(w(e)||(n=void 0),e),e=>{throw n=void 0,e});return{forceCleanup:r,[Symbol.asyncDispose]:async()=>{let{outcome:e,cause:n}=await r().then(e=>({outcome:e,cause:void 0}),e=>({outcome:{status:`cleanup-pending`,reason:`cleanup-unconfirmed`,message:e instanceof Error?e.message:void 0},cause:e}));t(e,n)}}}export{m as a,p as i,w as n,h as r,T as t};
|
package/dist/src/ended-lease.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import{w as e}from"./lease-scope.js";import{
|
|
1
|
+
import{w as e}from"./lease-scope.js";import{h as t}from"./daemon-resolution.js";import{b as n,f as r}from"./remote-connection-state.js";import{i,l as a}from"./connection-lease-transaction.js";function o(o,s,c){if(!o.remoteConfig)return;let l=e(s).map(e=>e.leaseId);if(l.length===0)return;let u=t(o.stateDir,{cwd:c.cwd,env:c.env}).baseDir,d=r({stateDir:u,session:o.session??`default`});!d?.leaseId||!l.includes(d.leaseId)||i(d)||a(d.leaseProvider,c.env).forgetsEndedConnectionLease&&n({stateDir:u,state:{...d,leaseId:void 0,updatedAt:new Date().toISOString()}})}export{o as forgetEndedConnectionLease};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{A as e,_ as t}from"./sdk-contracts.js";const n=new Set([`__proto__`,`constructor`,`prototype`]);async function r(e,t){return(await a(e,t,`evalScript`,{})).outputEnv}async function i(e,t,n,r){return await a(e,t,r,{maestro:{platform:n}})}async function a(n,r,i,a){let c=s(r),u=o(n),{default:d}=await import(`node:vm`),f={...r,...a,output:c},p;try{p=d.runInNewContext(u,f,{filename:i,timeout:1e4})}catch(n){throw new t(`COMMAND_FAILED`,`Maestro ${i} failed: ${e(n)}`,void 0,n instanceof Error?n:void 0)}return{value:p,outputEnv:l(f.output)}}function o(e){let t=e.trim();return t.startsWith("${")&&t.endsWith(`}`)?t.slice(2,-1):t}function s(e){let t=Object.create(null);for(let[n,r]of Object.entries(e))!n.startsWith(`output.`)||n===`output`||c(t,n.slice(7),r);return t}function c(e,t,n){let r=t.split(`.`).filter(d);if(r.length===0)return;let i=e;for(let e of r.slice(0,-1)){let t=i[e];(typeof t!=`object`||!t)&&(i[e]=Object.create(null)),i=i[e]}i[r.at(-1)]=n}function l(e){let t={};return u(e,[],t,new Set),t}function u(e,t,n,r){if(e!==void 0){if(typeof e!=`object`||!e){n[`output${t.map(e=>`.${e}`).join(``)}`]=f(e);return}if(!r.has(e)){r.add(e);try{let i=Array.isArray(e)?[...e.keys(),`length`]:Object.keys(e).filter(d);for(let a of i){let i=String(a);u(Array.isArray(e)&&i===`length`?e.length:e[i],[...t,i],n,r)}}finally{r.delete(e)}}}}function d(e){return!n.has(e)}function f(e){return typeof e==`string`?e:typeof e==`number`||typeof e==`boolean`?String(e):JSON.stringify(e)}export{i as evaluateMaestroConditionScript,r as evaluateMaestroEvalScript};
|
package/dist/src/error.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import{
|
|
2
|
-
`));let s=
|
|
1
|
+
import{U as e,V as t,_ as n,z as r}from"./sdk-contracts.js";import{n as i}from"./success-text.js";import{t as a}from"./output-common.js";import{r as o}from"./replay-divergence.js";const s={no:`Not dispatched.`,unknown:`May have reached the device.`};function c(t,i={}){let a=t instanceof n?r(t):t,o=e(a.details),s=a.code===`AMBIGUOUS_MATCH`?m(o):void 0,c=i.reader===`model`,{summary:u,truncated:d}=l(a,s,i.synopsis,c);return{summary:u,body:f(a,{fullMessage:d,candidateViews:s?[]:o,showDetails:i.showDetails})}}function l(e,n,r,i){let a=t(e.details),o=g(e.message),c=o.length>300?`${o.slice(0,300)}…`:o,l=u(e,a,n,r),f=i?d(e):void 0;return{summary:[`Error (${f?`${e.code}, ${f}`:e.code}): ${_(c)}`,...a?[s[a]]:[],...l?[`Next: ${l}`]:[]].join(` `),truncated:c!==o}}function u(e,t,n,r){let i=e.hint?g(e.hint):void 0,a=[...t===`unknown`?[`Run snapshot to check the screen before you retry.`]:[],...n?[`Act on one ref with a command that takes refs, such as press: ${n.join(`; `)}`]:i?[i]:[],...r&&e.code===`INVALID_ARGS`?[`Usage: ${r}`]:[]];return a.length>0?a.join(` `):void 0}function d(e){let t=e.details?.reason;if(typeof t!=`string`)return;let n=g(t);if(n.length!==0)return n.length>80?`${n.slice(0,80)}…`:n}function f(e,t){let n=[];if(t.fullMessage&&n.push(`Message: ${e.message}`),e.cause){let t=e.cause.code?`${e.cause.code} `:``;n.push(`Cause: ${t}${e.cause.message}`)}for(let t of i(e.details))n.push(`Warning: ${a(t)}`);let r=v(t.candidateViews);r.length>0&&n.push(r.join(`
|
|
2
|
+
`));let s=p(e);s&&n.push(s);let c=o(e.details);return c&&n.push(c),t.showDetails&&e.details&&n.push(JSON.stringify(e.details,null,2)),n}function p(e){if(e.logPath)return`Log: ${e.logPath}`;if(e.logPathUnavailable)return`Log: unavailable (${e.logPathUnavailable})`}function m(e){let[t,...n]=e;if(!t||n.length>0||t.kind!==`element-match`||t.matches<2||t.matches>3||t.candidates.length!==t.matches)return;let r=t.candidates.map(e=>g(y(e,t.refsGeneration)));return new Set(r.map(e=>e.replace(h,``))).size===r.length?r:void 0}const h=/^@e\d+(?:~s\d+)?\s*/;function g(e){return e.replaceAll(/\s+/g,` `).trim()}function _(e){return/[.!?…]$/.test(e)?e:`${e}.`}function v(e){return e.flatMap(e=>{if(e.kind===`element-match`){let t=e.matches-e.candidates.length;return[`Candidates:`,...e.candidates.map(t=>` ${y(t,e.refsGeneration)}`),...t>0?[` +${t} more`]:[]]}return[`Devices:`,...e.devices.map(e=>` ${e.id} ${e.name}`)]})}function y(e,t){return t===void 0?e:e.replace(/^@(e\d+)(?=\s|$)/,`@$1~s${t}`)}export{c as t};
|
package/dist/src/errors.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import{P as e,
|
|
1
|
+
import{P as e,_ as t}from"./sdk-contracts.js";import{i as n}from"./host3.js";import{t as r}from"./source-channel.js";function i(e,t,n={},i){return new r(e,t,void 0,n,i)}function a(e){return e instanceof n?new r(e.buildFailureKind,e.buildFailureCode,void 0,e.buildDetails,e.cause):e}function o(n){return n instanceof r||(n=a(n),n instanceof r)?n:e(n)?i(`cancelled`,`abort-signal`,{},n):n instanceof t&&typeof n.details?.timeoutMs==`number`?i(`timeout`,`host-operation-timeout`,{timeoutMs:n.details.timeoutMs},n):i(`transport-failure`,`unexpected-host-error`,{error:n instanceof Error?n.message:String(n)},n)}export{a as n,i as r,o as t};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{L as e,_ as t,f as n}from"./sdk-contracts.js";import{c as r}from"./device-shell.js";import{n as i}from"./device-selector-intent.js";function a(n){let i=r(n);return new t(`SESSION_NOT_FOUND`,`No active session "${n}". Run agent-device open <app> --session ${i} first, or omit --session to run against a device selector.`,{...e(n),hint:`Run agent-device session list to see the sessions this daemon holds. A daemon that was replaced or restarted starts without its predecessor's sessions.`})}function o(e){if(!e.session&&n(e.req)&&!i(e.req.flags))throw a(e.sessionAddress)}export{a as namedSessionNotFoundError,o as requireNamedSessionHoldsDevice};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{P as e}from"./sdk-contracts.js";import{t}from"./runtime-transport-hints.js";import{s as n}from"./app-resolution.js";async function r(r,i){if(!i.appBundleId||i.runtimeLaunchUrl?.trim())return;let a=t({metroHost:i.runtimeHints.metroHost,metroPort:i.runtimeHints.metroPort?Number(i.runtimeHints.metroPort):void 0,bundleUrl:i.runtimeHints.bundleUrl});if(!a)return;let o;try{o=await n(r,i.appBundleId,{timeoutMs:3e3})}catch(t){if(e(t))throw t;return}return o?`${o}://expo-development-client/?url=${encodeURIComponent(a.toString().replace(/\/+$/,``))}`:void 0}export{r as resolveExpoDevClientLaunchUrl};
|
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{_ as e}from"./sdk-contracts.js";import{n as t}from"./session-artifact-paths.js";import{t as n}from"./error.js";import{r,t as i}from"./args.js";import a from"node:fs";async function o(e,t={}){let r=t.command??(t.argv?c(t.argv):null),i=e.code===`INVALID_ARGS`&&r?await s(r):void 0,{summary:a,body:o}=n(e,{showDetails:t.debugTier,synopsis:i}),u=t.logTail?l(t.logTail):void 0,d=[a,...o,...u?[u]:[]];d.length>1&&d.push(a);for(let e of d)process.stderr.write(`${e}\n`)}async function s(e){let t=await i(e);if(t)return t.length<=160?t:`see agent-device help ${e}`}function c(t){for(let n=t.length;n>0;--n)try{return r(t.slice(0,n)).command}catch(t){if(!(t instanceof e))throw t}return null}function l(e){try{return e.daemonBaseUrl?e.record?u(`remote diagnostics`,t(e.daemonPaths.baseDir,e.record)):void 0:u(`daemon log`,e.daemonPaths.logPath)}catch{return}}function u(e,t){if(!a.existsSync(t))return;let n=d(t,64e3,200);return n.trim().length>0?`\n[${e}]\n${n.trimEnd()}`:void 0}function d(e,t,n){let r=a.openSync(e,`r`);try{let e=a.fstatSync(r).size,i=Math.min(e,t),o=Buffer.alloc(i);a.readSync(r,o,0,i,e-i);let s=o.toString(`utf8`).split(`
|
|
2
2
|
`);return i<e&&s.shift(),s.slice(-n).join(`
|
|
3
3
|
`)}finally{a.closeSync(r)}}export{o as printHumanError};
|
package/dist/src/file.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import{r as e}from"./rolldown-runtime.js";import{P as t,nt as n,z as r}from"./sdk-contracts.js";import{A as i,S as a,W as o,c as s,d as c,f as ee,k as l,l as u,o as d,p as f,pt as p,s as te,yt as m}from"./sdk-io.js";import h from"node:crypto";import g from"node:fs";import _ from"node:os";import v from"node:path";function y(e){return e?.HOME?.trim()||_.homedir()}function b(e,t={}){return e===`~`?y(t.env):e.startsWith(`~/`)?v.join(y(t.env),e.slice(2)):e}function ne(e,t){let n=b(e,t);return v.isAbsolute(n)?n:v.resolve(t.cwd,n)}function re(e){let n=e.AGENT_DEVICE_HOME?b(e.AGENT_DEVICE_HOME,{env:e}):v.join(b(`~`,{env:e}),`.agent-device`);if(!v.isAbsolute(n))throw new t(`INVALID_ARGS`,`AGENT_DEVICE_HOME must be absolute or ~/...`);return v.join(n,`config.json`)}function x(e){let n=e.AGENT_DEVICE_CLAIMS_DIR?.trim();if(!n)return v.join(_.homedir(),`.agent-device`,`device-claims`);if(!v.isAbsolute(n))throw new t(`INVALID_ARGS`,`AGENT_DEVICE_CLAIMS_DIR must be an absolute path: ${n}`,{reason:`relative_claims_dir`});return v.resolve(n)}const S=`owner.json`,C=`.lock`,w=1e3,T=1e3;async function E(e){let t=await e.acquire();try{let n=await e.task();return await t(),n}catch(e){throw await t().catch(()=>void 0),e}}const D=new Set,O=h.randomUUID();function ie(e){return k(e,e=>d({owner:e}))}function k(e,t){let n;try{n=g.lstatSync(e)}catch(t){return X(t)===`ENOENT`?{state:g.existsSync(H(e))?`publishing`:`absent`}:{state:`unproven`,reason:`owner-unreadable`}}if(!n.isDirectory())return{state:`unproven`,reason:`non-directory`};let r=Z(v.join(e,S));if(r.kind===`unreadable`)return{state:`unproven`,reason:`owner-unreadable`};if(r.kind===`unwritten`)return g.existsSync(H(e))?{state:`publishing`}:{state:`unproven`,reason:`owner-unwritten`};let{pid:i,startTime:a,acquiredAtMs:o}=r.owner;return{state:`held`,owner:{pid:i,startTime:a,acquiredAtMs:o},liveness:t(r.owner)}}function ae(e){g.mkdirSync(v.dirname(e.lockDirPath),{recursive:!0});let t=Z(v.join(e.lockDirPath,S));return A(e,{standing:j(t,t.kind===`owner`?d({owner:t.owner}):void 0),judgeOwner:e=>d({owner:e}),abandonedGuard:K(e.lockDirPath,e=>l([e.pid]).get(e.pid)??null),guardHolderStartTime:ee().startTime})}function A(e,t){let{lockDirPath:n}=e,r=t.standing;if(r.kind===`live`)return{status:`busy`,inspection:r.inspection};if(!U(n,t.abandonedGuard,t.guardHolderStartTime))return{status:`busy`,inspection:k(n,t.judgeOwner)};let i=oe(n,()=>se(e,r),e=>{e.status===`acquired`&&D.delete(e.claimToken)});return i.status===`acquired`?{status:`acquired`,acquisition:i.acquisition}:{status:i.status,inspection:i.inspection??k(n,t.judgeOwner)}}function oe(e,t,r){let i;try{i=t()}catch(t){try{Y(e)}catch(t){m({level:`warn`,phase:`process_lock_guard_release_failed`,data:{lockDirPath:e,error:n(t)}})}throw t}try{Y(e)}catch(e){throw r(i),e}return i}function se(e,t){let{lockDirPath:n}=e,r=v.join(n,S),i=le(n,r);if(i.kind===`unproven`)return{status:`unproven`,inspection:i.inspection};if(i.kind===`owner`){if(t.kind!==`reclaimable`||!M(i.owner,t.owner))return{status:`busy`};if(B(n,r,i.owner)!==`removed`)return{status:`unproven`}}return ce(e,r)}function ce(e,t){let{lockDirPath:n,owner:r}=e;try{g.mkdirSync(n)}catch(e){if(X(e)!==`EEXIST`)throw e;return{status:`unproven`}}let i=h.randomUUID(),a={...r,claimToken:i,claimIssuerId:O};try{z(t,a)}catch(e){try{g.rmdirSync(n)}catch{}throw e}return D.add(i),{status:`acquired`,claimToken:i,acquisition:L(e,a)}}function j(e,t){if(e.kind!==`owner`||t===void 0)return{kind:`none`};if(be(t)&&!xe(e.owner)){let{pid:n,startTime:r,acquiredAtMs:i}=e.owner;return{kind:`live`,inspection:{state:`held`,owner:{pid:n,startTime:r,acquiredAtMs:i},liveness:t}}}return{kind:`reclaimable`,owner:e.owner}}function le(e,t){let n;try{n=g.lstatSync(e)}catch(e){return X(e)===`ENOENT`?{kind:`absent`}:{kind:`unproven`,inspection:{state:`unproven`,reason:`owner-unreadable`}}}if(!n.isDirectory())return{kind:`unproven`,inspection:{state:`unproven`,reason:`non-directory`}};let r=Z(t);return r.kind===`owner`?{kind:`owner`,owner:r.owner}:{kind:`unproven`,inspection:{state:`unproven`,reason:r.kind===`unwritten`?`owner-unwritten`:`owner-unreadable`}}}function M(e,t){return e.pid===t.pid&&e.startTime===t.startTime&&e.acquiredAtMs===t.acquiredAtMs&&e.claimToken===t.claimToken&&e.claimIssuerId===t.claimIssuerId}async function N(e){return(await P(e)).release}async function P(e){let t=Date.now()+(e.timeoutMs??3e4),n=e.pollMs??100;F(e.signal);let r=await ue();g.mkdirSync(v.dirname(e.lockDirPath),{recursive:!0});do{F(e.signal);let i=A(e,await de(e,r));if(i.status===`acquired`)return i.acquisition;let a=t-Date.now();if(a<=0)break;await o(Math.min(n,a),e.signal),F(e.signal)}while(Date.now()<t);throw await fe(e)}function F(e){if(e?.aborted)throw r()}async function ue(){return{owner:pe(),guardHolder:J(),guardHolderStartTime:(await f()).startTime}}async function de(e,t){let n=Z(v.join(e.lockDirPath,S)),r=n.kind===`owner`?await t.owner.classify(n.owner):void 0;return{standing:j(n,r),judgeOwner:I(n,r),abandonedGuard:await q(e.lockDirPath,t.guardHolder),guardHolderStartTime:t.guardHolderStartTime}}function I(e,t){return n=>e.kind===`owner`&&t&&M(n,e.owner)?t:`unknown`}async function fe(e){let n=Z(v.join(e.lockDirPath,S)),r=n.kind===`owner`?await te({owner:n.owner}):void 0;return new t(`COMMAND_FAILED`,`Timed out waiting for ${e.description??`process lock`}`,{lockDirPath:e.lockDirPath,reason:`process_lock_timeout`,...ye(e.lockDirPath,n,r),inspection:k(e.lockDirPath,I(n,r)),hint:R(e.lockDirPath)})}function pe(){let e;return{async classify(t){!(e!==void 0&&M(e.owner,t)&&Date.now()-e.atMs<w)&&u(t.pid)&&a(t.pid)&&(e={owner:t,observation:(await i([t.pid])).get(t.pid)??null,atMs:Date.now()});let n=e&&M(e.owner,t)?e.observation:null;return s({owner:t},n)}}}function L(e,n){let{lockDirPath:r}=e,i=v.join(r,S),a=!0,o=!1;return Object.freeze({assertHeld(){if(!a||V(r,n)!==`owned`)throw new t(`COMMAND_FAILED`,`Process lock acquisition is no longer held`,{lockDirPath:r,ownerOwnershipLost:!0})},async release(){if(o)return;a=!1,D.delete(n.claimToken);let s=V(r,n);if(s===`absent`||s===`not-owner`){o=!0;return}let c=`unverified`;if(await _e(r))try{c=B(r,i,n)}finally{Y(r)}if(c!==`unverified`){o=!0;return}throw m({level:`warn`,phase:`process_lock_release_unverified`,data:{lockDirPath:r,description:e.description,ownerReleaseUnverified:!0}}),new t(`COMMAND_FAILED`,`Cannot verify ownership of ${e.description??`process lock`}`,{lockDirPath:r,ownerReleaseUnverified:!0,hint:R(r)})}})}function R(e){return`Restore process inspection or stop the verified owner, then retry. Remove ${e} and ${H(e)} only after confirming all users of this state directory have stopped.`}function z(e,t){p({destination:e,contents:JSON.stringify(t)})}function B(e,t,n){let r=V(e,n);return r===`owned`?me(e,t,n):r===`absent`?`removed`:r}function V(e,t){let n=Z(v.join(e,S));return n.kind===`unreadable`?`unverified`:n.kind===`unwritten`?g.existsSync(e)?`unverified`:`absent`:c(n.owner,t)&&n.owner.claimToken===t.claimToken?`owned`:`not-owner`}function me(e,t,n){try{if(g.readdirSync(e).some(e=>e!==S))return`unverified`}catch(e){return X(e)===`ENOENT`?`removed`:`unverified`}try{g.unlinkSync(t)}catch(e){if(X(e)!==`ENOENT`)return`unverified`}try{return g.rmdirSync(e),`removed`}catch(e){if(X(e)===`ENOENT`)return`removed`;try{p({destination:t,contents:JSON.stringify(n),publish:`link-exclusive`})}catch{}return`unverified`}}function H(e){return`${e.endsWith(C)?e.slice(0,-5):e}.reclaim${C}`}const he=/^[0-9a-f-]{36}$/;function U(e,t,n){return W(e,n)?!0:!t||!ge(e,t)?!1:W(e,n)}function W(e,t){let n=H(e),r={pid:process.pid,startTime:t,token:h.randomUUID()},i;try{i=g.openSync(n,`wx`,384)}catch(e){if(X(e)!==`EEXIST`)throw e;return!1}try{g.writeSync(i,JSON.stringify(r))}catch(e){throw g.closeSync(i),g.unlinkSync(n),e}return g.closeSync(i),!0}function ge(e,t){let n=H(e),r=`${n}.${t.token}.reap`;try{g.closeSync(g.openSync(r,`wx`,384))}catch(e){if(X(e)!==`EEXIST`)throw e;return!1}try{let r=G(n);if(r?.holder.token!==t.token)return!1;try{g.unlinkSync(n)}catch(e){if(X(e)!==`ENOENT`)throw e}return m({level:`warn`,phase:`process_lock_guard_reclaimed`,data:{lockDirPath:e,holderPid:r.holder.pid}}),!0}finally{g.rmSync(r,{force:!0})}}function G(e){let t,n;try{t=g.readFileSync(e,`utf8`),n=Date.now()-g.statSync(e).mtimeMs}catch{return}let r;try{r=JSON.parse(t)}catch{return}if(typeof r!=`object`||!r)return;let i=r;if(!(!u(i.pid)||typeof i.token!=`string`)&&he.test(i.token)&&(i.startTime===null||typeof i.startTime==`string`))return{holder:{pid:i.pid,startTime:i.startTime,token:i.token},ageMs:n}}function K(e,t){let n=G(H(e));if(!n||n.holder.pid===process.pid)return;let{holder:r,ageMs:i}=n,o=a(r.pid);if(o&&i<T)return;let c=o?t(r):null;return $(s({owner:r},c))?{token:r.token}:void 0}async function q(e,t){let n=G(H(e));if(!n)return;let r=n.holder.pid!==process.pid&&n.ageMs>=T&&a(n.holder.pid)?await t.observe(n.holder):null;return K(e,e=>e.token===n.holder.token?r:null)}function J(){let e;return{async observe(t){if(e?.token===t.token&&Date.now()-e.atMs<w)return e.observation;let n=await i([t.pid]);return e={token:t.token,observation:n.get(t.pid)??null,atMs:Date.now()},e.observation}}}async function _e(e){let t=Date.now()+5e3,n=(await f()).startTime,r=J();for(;!U(e,await q(e,r),n);){if(Date.now()>=t)return!1;await o(5)}return!0}function Y(e){try{g.unlinkSync(H(e))}catch(n){throw new t(`COMMAND_FAILED`,`Process lock mutation guard release could not be confirmed.`,{reason:`process_lock_guard_release_failed`,lockDirPath:e,hint:R(e)},n)}}function X(e){return e?.code}function Z(e){let t;try{t=g.readFileSync(e,`utf8`)}catch(e){return e?.code===`ENOENT`?{kind:`unwritten`}:{kind:`unreadable`}}let n=ve(t);return n?{kind:`owner`,owner:n}:{kind:`unreadable`}}function ve(e){let t;try{t=JSON.parse(e)}catch{return null}if(typeof t!=`object`||!t)return null;let n=t;for(let[e,t]of Object.entries(Q))if(!t(n[e]))return null;return{pid:n.pid,startTime:typeof n.startTime==`string`?n.startTime:null,acquiredAtMs:n.acquiredAtMs,claimToken:typeof n.claimToken==`string`?n.claimToken:null,claimIssuerId:typeof n.claimIssuerId==`string`?n.claimIssuerId:void 0}}const Q={pid:u,acquiredAtMs:e=>typeof e==`number`&&Number.isFinite(e),startTime:e=>e==null||typeof e==`string`};function ye(e,t,n){let r=Date.now(),i;try{i=Math.max(0,Math.round(r-g.statSync(e).mtimeMs))}catch{}return{...i===void 0?{}:{lockAgeMs:i},...t.kind===`owner`?{ownerPid:t.owner.pid,ownerStartTime:t.owner.startTime,ownerAgeMs:Math.max(0,Math.round(r-t.owner.acquiredAtMs)),ownerLiveness:n}:t.kind===`unreadable`?{ownerRecordUnreadable:!0}:{}}}function be(e){return!$(e)}function $(e){return e===`owner-process-dead`||e===`owner-process-reused`}function xe(e){return e.pid!==process.pid||e.claimToken===null||e.claimIssuerId!==O?!1:!D.has(e.claimToken)}var Se=e({NOT_REGULAR_FILE_HINT:()=>NOT_REGULAR_FILE_HINT,acquireProcessLock:()=>N,resolveDeviceClaimRoot:()=>x,withProcessLock:()=>E});export{ae as a,x as c,ie as i,re as l,N as n,E as o,P as r,b as s,Se as t,ne as u};
|
|
1
|
+
import{r as e}from"./rolldown-runtime.js";import{S as t,_ as n,z as r}from"./sdk-contracts.js";import{C as i,M as a,St as o,c as s,f as c,gt as l,j as ee,l as u,m as d,p as f,q as p,s as m,u as h}from"./sdk-io.js";import g from"node:crypto";import _ from"node:fs";import v from"node:os";import y from"node:path";function b(e){return e?.HOME?.trim()||v.homedir()}function x(e,t={}){return e===`~`?b(t.env):e.startsWith(`~/`)?y.join(b(t.env),e.slice(2)):e}function te(e,t){let n=x(e,t);return y.isAbsolute(n)?n:y.resolve(t.cwd,n)}function ne(e){let t=e.AGENT_DEVICE_HOME?x(e.AGENT_DEVICE_HOME,{env:e}):y.join(x(`~`,{env:e}),`.agent-device`);if(!y.isAbsolute(t))throw new n(`INVALID_ARGS`,`AGENT_DEVICE_HOME must be absolute or ~/...`);return y.join(t,`config.json`)}function S(e){let t=e.AGENT_DEVICE_CLAIMS_DIR?.trim();if(!t)return y.join(v.homedir(),`.agent-device`,`device-claims`);if(!y.isAbsolute(t))throw new n(`INVALID_ARGS`,`AGENT_DEVICE_CLAIMS_DIR must be an absolute path: ${t}`,{reason:`relative_claims_dir`});return y.resolve(t)}const C=`owner.json`,w=`.lock`,T=1e3,E=1e3;async function D(e){let t=await e.acquire();try{let n=await e.task();return await t(),n}catch(e){throw await t().catch(()=>void 0),e}}const O=new Set,k=g.randomUUID();function re(e){return A(e,e=>m({owner:e}))}function A(e,t){let n;try{n=_.lstatSync(e)}catch(t){return X(t)===`ENOENT`?{state:_.existsSync(H(e))?`publishing`:`absent`}:{state:`unproven`,reason:`owner-unreadable`}}if(!n.isDirectory())return{state:`unproven`,reason:`non-directory`};let r=Z(y.join(e,C));if(r.kind===`unreadable`)return{state:`unproven`,reason:`owner-unreadable`};if(r.kind===`unwritten`)return _.existsSync(H(e))?{state:`publishing`}:{state:`unproven`,reason:`owner-unwritten`};let{pid:i,startTime:a,acquiredAtMs:o}=r.owner;return{state:`held`,owner:{pid:i,startTime:a,acquiredAtMs:o},liveness:t(r.owner)}}function ie(e){_.mkdirSync(y.dirname(e.lockDirPath),{recursive:!0});let t=Z(y.join(e.lockDirPath,C));return j(e,{standing:M(t,t.kind===`owner`?m({owner:t.owner}):void 0),judgeOwner:e=>m({owner:e}),abandonedGuard:K(e.lockDirPath,e=>ee([e.pid]).get(e.pid)??null),guardHolderStartTime:f().startTime})}function j(e,t){let{lockDirPath:n}=e,r=t.standing;if(r.kind===`live`)return{status:`busy`,inspection:r.inspection};if(!U(n,t.abandonedGuard,t.guardHolderStartTime))return{status:`busy`,inspection:A(n,t.judgeOwner)};let i=ae(n,()=>oe(e,r),e=>{e.status===`acquired`&&O.delete(e.claimToken)});return i.status===`acquired`?{status:`acquired`,acquisition:i.acquisition}:{status:i.status,inspection:i.inspection??A(n,t.judgeOwner)}}function ae(e,t,n){let i;try{i=t()}catch(t){try{Y(e)}catch(t){o({level:`warn`,phase:`process_lock_guard_release_failed`,data:{lockDirPath:e,error:r(t)}})}throw t}try{Y(e)}catch(e){throw n(i),e}return i}function oe(e,t){let{lockDirPath:n}=e,r=y.join(n,C),i=ce(n,r);if(i.kind===`unproven`)return{status:`unproven`,inspection:i.inspection};if(i.kind===`owner`){if(t.kind!==`reclaimable`||!N(i.owner,t.owner))return{status:`busy`};if(B(n,r,i.owner)!==`removed`)return{status:`unproven`}}return se(e,r)}function se(e,t){let{lockDirPath:n,owner:r}=e;try{_.mkdirSync(n)}catch(e){if(X(e)!==`EEXIST`)throw e;return{status:`unproven`}}let i=g.randomUUID(),a={...r,claimToken:i,claimIssuerId:k};try{z(t,a)}catch(e){try{_.rmdirSync(n)}catch{}throw e}return O.add(i),{status:`acquired`,claimToken:i,acquisition:pe(e,a)}}function M(e,t){if(e.kind!==`owner`||t===void 0)return{kind:`none`};if(be(t)&&!xe(e.owner)){let{pid:n,startTime:r,acquiredAtMs:i}=e.owner;return{kind:`live`,inspection:{state:`held`,owner:{pid:n,startTime:r,acquiredAtMs:i},liveness:t}}}return{kind:`reclaimable`,owner:e.owner}}function ce(e,t){let n;try{n=_.lstatSync(e)}catch(e){return X(e)===`ENOENT`?{kind:`absent`}:{kind:`unproven`,inspection:{state:`unproven`,reason:`owner-unreadable`}}}if(!n.isDirectory())return{kind:`unproven`,inspection:{state:`unproven`,reason:`non-directory`}};let r=Z(t);return r.kind===`owner`?{kind:`owner`,owner:r.owner}:{kind:`unproven`,inspection:{state:`unproven`,reason:r.kind===`unwritten`?`owner-unwritten`:`owner-unreadable`}}}function N(e,t){return e.pid===t.pid&&e.startTime===t.startTime&&e.acquiredAtMs===t.acquiredAtMs&&e.claimToken===t.claimToken&&e.claimIssuerId===t.claimIssuerId}async function P(e){return(await F(e)).release}async function F(e){let t=Date.now()+(e.timeoutMs??3e4),n=e.pollMs??100;I(e.signal);let r=await le();_.mkdirSync(y.dirname(e.lockDirPath),{recursive:!0});do{I(e.signal);let i=j(e,await ue(e,r));if(i.status===`acquired`)return i.acquisition;let a=t-Date.now();if(a<=0)break;await p(Math.min(n,a),e.signal),I(e.signal)}while(Date.now()<t);throw await de(e)}function I(e){if(e?.aborted)throw t()}async function le(){return{owner:fe(),guardHolder:J(),guardHolderStartTime:(await d()).startTime}}async function ue(e,t){let n=Z(y.join(e.lockDirPath,C)),r=n.kind===`owner`?await t.owner.classify(n.owner):void 0;return{standing:M(n,r),judgeOwner:L(n,r),abandonedGuard:await q(e.lockDirPath,t.guardHolder),guardHolderStartTime:t.guardHolderStartTime}}function L(e,t){return n=>e.kind===`owner`&&t&&N(n,e.owner)?t:`unknown`}async function de(e){let t=Z(y.join(e.lockDirPath,C)),r=t.kind===`owner`?await s({owner:t.owner}):void 0;return new n(`COMMAND_FAILED`,`Timed out waiting for ${e.description??`process lock`}`,{lockDirPath:e.lockDirPath,reason:`process_lock_timeout`,...ye(e.lockDirPath,t,r),inspection:A(e.lockDirPath,L(t,r)),hint:R(e.lockDirPath)})}function fe(){let e;return{async classify(t){!(e!==void 0&&N(e.owner,t)&&Date.now()-e.atMs<T)&&h(t.pid)&&i(t.pid)&&(e={owner:t,observation:(await a([t.pid])).get(t.pid)??null,atMs:Date.now()});let n=e&&N(e.owner,t)?e.observation:null;return u({owner:t},n)}}}function pe(e,t){let{lockDirPath:r}=e,i=y.join(r,C),a=!0,s=!1;return Object.freeze({assertHeld(){if(!a||V(r,t)!==`owned`)throw new n(`COMMAND_FAILED`,`Process lock acquisition is no longer held`,{lockDirPath:r,ownerOwnershipLost:!0})},async release(){if(s)return;a=!1,O.delete(t.claimToken);let c=V(r,t);if(c===`absent`||c===`not-owner`){s=!0;return}let l=`unverified`;if(await _e(r))try{l=B(r,i,t)}finally{Y(r)}if(l!==`unverified`){s=!0;return}throw o({level:`warn`,phase:`process_lock_release_unverified`,data:{lockDirPath:r,description:e.description,ownerReleaseUnverified:!0}}),new n(`COMMAND_FAILED`,`Cannot verify ownership of ${e.description??`process lock`}`,{lockDirPath:r,ownerReleaseUnverified:!0,hint:R(r)})}})}function R(e){return`Restore process inspection or stop the verified owner, then retry. Remove ${e} and ${H(e)} only after confirming all users of this state directory have stopped.`}function z(e,t){l({destination:e,contents:JSON.stringify(t)})}function B(e,t,n){let r=V(e,n);return r===`owned`?me(e,t,n):r===`absent`?`removed`:r}function V(e,t){let n=Z(y.join(e,C));return n.kind===`unreadable`?`unverified`:n.kind===`unwritten`?_.existsSync(e)?`unverified`:`absent`:c(n.owner,t)&&n.owner.claimToken===t.claimToken?`owned`:`not-owner`}function me(e,t,n){try{if(_.readdirSync(e).some(e=>e!==C))return`unverified`}catch(e){return X(e)===`ENOENT`?`removed`:`unverified`}try{_.unlinkSync(t)}catch(e){if(X(e)!==`ENOENT`)return`unverified`}try{return _.rmdirSync(e),`removed`}catch(e){if(X(e)===`ENOENT`)return`removed`;try{l({destination:t,contents:JSON.stringify(n),publish:`link-exclusive`})}catch{}return`unverified`}}function H(e){return`${e.endsWith(w)?e.slice(0,-5):e}.reclaim${w}`}const he=/^[0-9a-f-]{36}$/;function U(e,t,n){return W(e,n)?!0:!t||!ge(e,t)?!1:W(e,n)}function W(e,t){let n=H(e),r={pid:process.pid,startTime:t,token:g.randomUUID()},i;try{i=_.openSync(n,`wx`,384)}catch(e){if(X(e)!==`EEXIST`)throw e;return!1}try{_.writeSync(i,JSON.stringify(r))}catch(e){throw _.closeSync(i),_.unlinkSync(n),e}return _.closeSync(i),!0}function ge(e,t){let n=H(e),r=`${n}.${t.token}.reap`;try{_.closeSync(_.openSync(r,`wx`,384))}catch(e){if(X(e)!==`EEXIST`)throw e;return!1}try{let r=G(n);if(r?.holder.token!==t.token)return!1;try{_.unlinkSync(n)}catch(e){if(X(e)!==`ENOENT`)throw e}return o({level:`warn`,phase:`process_lock_guard_reclaimed`,data:{lockDirPath:e,holderPid:r.holder.pid}}),!0}finally{_.rmSync(r,{force:!0})}}function G(e){let t,n;try{t=_.readFileSync(e,`utf8`),n=Date.now()-_.statSync(e).mtimeMs}catch{return}let r;try{r=JSON.parse(t)}catch{return}if(typeof r!=`object`||!r)return;let i=r;if(!(!h(i.pid)||typeof i.token!=`string`)&&he.test(i.token)&&(i.startTime===null||typeof i.startTime==`string`))return{holder:{pid:i.pid,startTime:i.startTime,token:i.token},ageMs:n}}function K(e,t){let n=G(H(e));if(!n||n.holder.pid===process.pid)return;let{holder:r,ageMs:a}=n,o=i(r.pid);if(o&&a<E)return;let s=o?t(r):null;return $(u({owner:r},s))?{token:r.token}:void 0}async function q(e,t){let n=G(H(e));if(!n)return;let r=n.holder.pid!==process.pid&&n.ageMs>=E&&i(n.holder.pid)?await t.observe(n.holder):null;return K(e,e=>e.token===n.holder.token?r:null)}function J(){let e;return{async observe(t){if(e?.token===t.token&&Date.now()-e.atMs<T)return e.observation;let n=await a([t.pid]);return e={token:t.token,observation:n.get(t.pid)??null,atMs:Date.now()},e.observation}}}async function _e(e){let t=Date.now()+5e3,n=(await d()).startTime,r=J();for(;!U(e,await q(e,r),n);){if(Date.now()>=t)return!1;await p(5)}return!0}function Y(e){try{_.unlinkSync(H(e))}catch(t){throw new n(`COMMAND_FAILED`,`Process lock mutation guard release could not be confirmed.`,{reason:`process_lock_guard_release_failed`,lockDirPath:e,hint:R(e)},t)}}function X(e){return e?.code}function Z(e){let t;try{t=_.readFileSync(e,`utf8`)}catch(e){return e?.code===`ENOENT`?{kind:`unwritten`}:{kind:`unreadable`}}let n=ve(t);return n?{kind:`owner`,owner:n}:{kind:`unreadable`}}function ve(e){let t;try{t=JSON.parse(e)}catch{return null}if(typeof t!=`object`||!t)return null;let n=t;for(let[e,t]of Object.entries(Q))if(!t(n[e]))return null;return{pid:n.pid,startTime:typeof n.startTime==`string`?n.startTime:null,acquiredAtMs:n.acquiredAtMs,claimToken:typeof n.claimToken==`string`?n.claimToken:null,claimIssuerId:typeof n.claimIssuerId==`string`?n.claimIssuerId:void 0}}const Q={pid:h,acquiredAtMs:e=>typeof e==`number`&&Number.isFinite(e),startTime:e=>e==null||typeof e==`string`};function ye(e,t,n){let r=Date.now(),i;try{i=Math.max(0,Math.round(r-_.statSync(e).mtimeMs))}catch{}return{...i===void 0?{}:{lockAgeMs:i},...t.kind===`owner`?{ownerPid:t.owner.pid,ownerStartTime:t.owner.startTime,ownerAgeMs:Math.max(0,Math.round(r-t.owner.acquiredAtMs)),ownerLiveness:n}:t.kind===`unreadable`?{ownerRecordUnreadable:!0}:{}}}function be(e){return!$(e)}function $(e){return e===`owner-process-dead`||e===`owner-process-reused`}function xe(e){return e.pid!==process.pid||e.claimToken===null||e.claimIssuerId!==k?!1:!O.has(e.claimToken)}var Se=e({NOT_REGULAR_FILE_HINT:()=>NOT_REGULAR_FILE_HINT,acquireProcessLock:()=>P,resolveDeviceClaimRoot:()=>S,withProcessLock:()=>D});export{ie as a,S as c,re as i,ne as l,P as n,D as o,F as r,x as s,Se as t,te as u};
|
package/dist/src/find.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{Nt as e,ar as t,cn as n,cr as r,ir as i,rr as a}from"./sdk-batch.js";import{at as o,p as s,s as c,z as l}from"./sdk-contracts.js";import{t as u}from"./snapshot-private-evidence.js";import"./capture.js";import{r as d,t as f}from"./success-text.js";import{o as p}from"./session-store.js";import{n as m,t as h}from"./interaction-error.js";import{r as g}from"./snapshot-occlusion.js";import{a as _,y as v}from"./snapshot-runtime-capture-input.js";import{r as y}from"./snapshot-lines.js";import{t as b}from"./context.js";import{t as x}from"./focus-runtime.js";import{a as ee,l as S,n as C,s as w,t as T}from"./selector-pipeline-policy.js";import{r as te}from"./snapshot-baseline.js";import{t as ne}from"./snapshot-quality-verdict.js";import{a as E,n as D,r as O,t as k}from"./node-touch-point.js";import{n as A}from"./capture-disclosure.js";import{t as j}from"./snapshot-runtime-binding.js";import{n as M,t as N}from"./type-text-runtime.js";import{n as re,u as P}from"./selector-runtime.js";function F(e,t,n){return c(`AMBIGUOUS_MATCH`,`find matched ${e.length} elements for ${t} "${n}". Use a more specific locator or selector.`,{locator:t,query:n,...y(e),dispatched:`no`})}function I(e,t){return c(`AMBIGUOUS_MATCH`,`find matched ${e}, which contains ${t.length} text fields. Use a more specific locator or selector.`,{ref:e,...y(t),dispatched:`no`})}function L(e,t){let n=t[0]?.rect;if(!n)return e;let r=e.filter(e=>{if(!e.rect)return!1;let t=o(e.rect);return t.x>=n.x&&t.x<=n.x+n.width&&t.y>=n.y&&t.y<=n.y+n.height}),i=r.length>0?r:e;return i.length<2?i:R(i,t,w(t))}function R(e,t,n){return e.map((e,r)=>({node:e,index:r,score:z(e,t,n)})).sort((e,t)=>t.score===e.score?V(e.node)-V(t.node)||e.index-t.index:t.score-e.score).map(e=>e.node)}function z(e,t,n){let r=n(e);if(r.reason===`covered`)return 0;let i=B(r,t[0]);return i>0?i:e.hittable&&e.rect&&!S(e,t[0])?3:+!!e.rect}function B(e,t){return e.node.rect?e.reason===`semantic-target`||e.reason===`same-rect-descendant`?4:e.reason===`hittable-ancestor`&&!S(e.node,t)?2:0:0}function V(e){return e.rect?e.rect.width*e.rect.height:1/0}function ie(e){if(e.ambiguity!==`reject-candidates`)throw Error(`find's resolution policy must reject candidates, got "${e.ambiguity}"`)}function H(e){let{nodes:t,locator:n,query:r,selectorExpression:a,flags:o,platform:s}=e,l=T.findAct,u=t.filter(e=>!S(e,t[0])),d=l.resolution,f;if(f=a?C(l,u,a,{platform:s}).list?.matchedNodes??[]:i(u,n,r,{requireRect:d.requireRect}).matches,f=L(f,t),f.length>1){ie(d);let e=U(f,o);if(!e)return{ok:!1,response:F(f,n,r)};f=e}let p=f[0]??null;return p?{ok:!0,node:p}:{ok:!1,response:c(`COMMAND_FAILED`,`find did not match any element`)}}function U(e,t){return t?.findFirst?[e[0]]:t?.findLast?[e.at(-1)]:null}function W(e){let{device:t,req:n,logPath:r,locator:i,query:a,sessionStore:o,sessionName:s}=e,c=P({ref:e.ref,device:t,sessionStore:o,sessionName:s,req:n,logPath:r,capture:e.capture,captureProof:e.captureProof});return async()=>{let{snapshot:e}=await c.capture({flags:{...n.flags,snapshotInteractiveOnly:!0},recovery:{legacyIosSparse:{query:a,shouldScope:K(i)},sparseVerdictQueryScope:{query:a,shouldScope:K(i)}}});return e}}function G(e){return c(`COMMAND_FAILED`,`find could not read the current accessibility tree`,{reason:e.reason,hint:`The snapshot quality verdict is sparse. Use screenshot as visual truth, navigate with coordinates if needed, then retry find after reaching a readable screen.`})}function K(e){return e!==`role`}async function q(i){let{req:o,sessionName:l,logPath:u,sessionStore:d,invoke:f}=i,p=d.lookup(l),m=o.command;if(m!==`find`)return null;let h=o.positionals??[],g=a(h,o.flags);if(!g.ok)return c(g.code,g.message);let{locator:_,query:v,action:y,value:b}=g.parsed;if(o.flags?.record&&!t(y))return c(`INVALID_ARGS`,`find ${y} is a mutating action and is always recorded; --record only applies to a read-only find (exists, wait, list, get text, get attrs).`);let x=await re({createCommandSurface:i.createCommandSurface,req:o,sessionName:l,logPath:u,sessionStore:d,inspectFacts:i.inspectFacts,platformServices:i.platformServices,bindDevice:i.bindDevice});if(x)return x;let S=p?d.requireCurrent(p):void 0;if(!S||!p)return s();let C=S.device,w=await j({command:`find`,device:C,session:S,plan:n({hasActiveApp:S.appBundleId!==void 0,intent:e(y)}),inspectFacts:i.inspectFacts,platformServices:i.platformServices,bindDevice:i.bindDevice});if(!w.ok)return w.response;let E=r(_,v),D={},O=W({ref:p,device:C,req:o,logPath:u,locator:_,query:v,sessionStore:d,sessionName:l,capture:w.capture,captureProof:D}),k={sessionRef:p,req:o,sessionName:l,logPath:u,sessionStore:d,invoke:f,device:C,command:m,locator:_,query:v,publicFlags:le(o.flags),boundFocusPoint:w.focusPoint,boundTypeText:w.typeText},M=await O();if(ne(M.snapshotQuality))return A({response:G(M.snapshotQuality),consumedTree:M,captureProof:D});let{nodes:N}=M,P=H({nodes:N,locator:_,query:v,selectorExpression:E,flags:o.flags,platform:C.platform});if(!P.ok)return A({response:P.response,consumedTree:M,captureProof:D});let F=P.node,I=await ee(T.findAct,N,F),L=I.node,R=`@${L.ref}`,z={...o.flags??{},noRecord:!0},B=await J(k,{node:F,resolvedNode:L,ref:R,tree:te(M),...M.keyboard?{keyboard:M.keyboard}:{},actionFlags:z,...I.kind===`occluded`?{occludedNode:I.node}:{}},y,b);return B&&A({response:B,consumedTree:M,captureProof:D})}async function J(e,t,n,r){let i={click:()=>ae(e,t),fill:()=>X(e,t,r),focus:()=>oe(e,t),type:()=>se(e,t,r)}[n];return i?await i():null}function Y(e){return{ref:e.ref,node:e.resolvedNode,tree:e.tree,...e.keyboard?{keyboard:e.keyboard}:{}}}async function ae(e,t){let{req:n,sessionName:r,sessionStore:i,sessionRef:a,invoke:s,command:c,locator:l,query:u,publicFlags:m}=e,h=await s({token:n.token,session:r,command:`click`,positionals:[t.ref],flags:t.actionFlags,internal:{findResolvedTarget:Y(t)}});if(!h.ok)return h;let g=t.resolvedNode.rect?o(t.resolvedNode.rect):t.node.rect?o(t.node.rect):null,_={ref:t.ref,locator:l,query:u};g&&(_.x=g.x,_.y=g.y);let v=f(h.data)??`Tapped ${t.ref}${g?` (${g.x}, ${g.y})`:``}`;return Object.assign(_,d(v)),p(i,a,n,c,{ref:t.ref,action:`click`,locator:l,query:u},{flags:m}),{ok:!0,data:_}}async function X(e,t,n){let{req:r,sessionName:i,sessionStore:a,sessionRef:o,invoke:s,command:l,publicFlags:u}=e;if(n===void 0)return c(`INVALID_ARGS`,`find fill requires text (use "" to clear the field)`);let d=await s({token:r.token,session:i,command:`fill`,positionals:[t.ref,n],flags:t.actionFlags,internal:{findResolvedTarget:Y(t)}});return d.ok&&p(a,o,r,l,{ref:t.ref,action:`fill`},{flags:u}),d}async function oe(e,t){let n=await Z(e,t);return n.ok&&$(e,t,`focus`),n}async function se(e,t,n){let{req:r,logPath:i}=e;if(!n)return c(`INVALID_ARGS`,`find type requires text`);let a=()=>{let t=e.sessionStore.requireCurrent(e.sessionRef);return b(i,r.flags,t.appBundleId,t.trace?.outPath)},o=M([n],a(),{rejectRefTarget:!1}),s=await Z(e,t);if(!s.ok)return s;let l=e.sessionStore.requireCurrent(e.sessionRef);_(l);let u=e.boundTypeText;if(!u)return c(`COMMAND_FAILED`,`find type was admitted without a text-entry operation`);let d=await N({operations:{typeText:u}},o,a());return $(e,t,`type`),{ok:!0,data:d}}async function Z(e,t){let{req:n,logPath:r}=e,i=ce(t,`focus`);if(i)return i;let a=k({located:t.node,resolved:t.resolvedNode,nodes:t.tree.nodes,platform:e.device.platform});if(a.kind===`several-fields`)return I(t.ref,a.fields);if(a.kind===`disabled-field`)return c(`COMMAND_FAILED`,`Matched element @${a.node.ref} is a disabled text field and cannot be focused`,{reason:h.targetDisabled,ref:`@${a.node.ref}`,hint:`Enable the field first, or target a different one.`});let o=a.node;if(g(o))return Q(o,`focus`);let s=`@${o.ref}`,d;try{await u(t.tree.nodes,`Ref ${s}`),d=D(o,t.tree.nodes,{invalidMessage:`Ref ${s} has no usable bounds`,blockedTargetLabel:`Ref ${s}`,blockedTargetDetails:{ref:s}}),O({nodes:t.tree.nodes,node:o,action:`focus`,label:`Ref ${s}`,...t.keyboard?{keyboard:t.keyboard}:{},tapPoint:d})}catch(e){return{ok:!1,error:l(e)}}let f=e.sessionStore.requireCurrent(e.sessionRef);_(f);let p=e.boundFocusPoint;return p?{ok:!0,data:await x({operations:{focusPoint:p}},d,b(r,n.flags,f.appBundleId,f.trace?.outPath))}:c(`COMMAND_FAILED`,`find focus was admitted without a focus operation`)}function ce(e,t){return e.occludedNode?Q(e.occludedNode,t):null}function Q(e,t){return c(`COMMAND_FAILED`,`Matched element @${e.ref} is covered by another visible element and cannot ${E(t)} safely`,m(e))}function $(e,t,n){let{req:r,sessionStore:i,sessionRef:a,command:o,publicFlags:s}=e;p(i,a,r,o,{ref:t.ref,action:n},{flags:s})}function le(e){return{...v(e)??{}}}export{q as handleFindCommands};
|
package/dist/src/finders.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{sr as e}from"./sdk-batch.js";import{t}from"./sdk-finders.js";export{t as findBestMatchesByLocator,e as parseFindArgs};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{i as e,t}from"./sdk-contracts.js";import{c as n}from"./screenshot.js";import"./capture.js";import{a as r,t as i}from"./sdk-device.js";import{t as a}from"./recording-scope.js";import{a as o,o as s}from"./sdk-remote-config.js";import{n as c}from"./session.js";import{c as l}from"./observability.js";const u=[{key:`keyframes`,names:[`--keyframes`],type:`string`,usageLabel:`--keyframes <json>`,usageDescription:`Fold: timed {atMs, angle} keyframes; final atMs is motion duration (up to 60000ms)`,projectConfig:!1,recorded:!0},{key:`count`,names:[`--count`],type:`int`,min:1,max:200,usageLabel:`--count <n>`,usageDescription:`Repeat count for press, swipe and gesture tap series`,projectConfig:!0,recorded:!0},{key:`pointerCount`,names:[`--pointer-count`],type:`int`,min:1,max:2,usageLabel:`--pointer-count <1|2>`,usageDescription:`Gesture pan: number of touch pointers (default 1)`,projectConfig:!0,recorded:!0},{key:`fps`,names:[`--fps`],type:`int`,min:1,max:120,usageLabel:`--fps <n>`,usageDescription:`Record: target frames per second (iOS physical device runner); also lowers the touch-overlay rate, which never exceeds 30`,projectConfig:!0,recorded:!0},{key:`quality`,names:[`--quality`],type:`string`,usageLabel:`--quality <medium|high>`,usageDescription:`Record: output quality preset; Android maps this to screenrecord bitrate, Limrun sessions map medium to recorder quality 5 and high to 8; Apple export always preserves the captured resolution, so it has no effect there. Legacy numeric values 5-7 map to medium; 8-10 map to high`,projectConfig:!0,recorded:!0},{key:`hideTouches`,names:[`--hide-touches`],type:`boolean`,usageLabel:`--hide-touches`,usageDescription:`Record: skip touch-overlay post-processing for faster raw benchmark videos`,projectConfig:!0,recorded:!0},{key:`recordingScope`,names:[`--scope`],type:`enum`,enumValues:a,usageLabel:`--scope <app|device|system>`,usageDescription:`Record: app requires an active app session; device/system records the whole screen`,projectConfig:!0,recorded:!1},{key:`intervalMs`,names:[`--interval-ms`],type:`int`,min:0,max:1e4,usageLabel:`--interval-ms <ms>`,usageDescription:`Delay between press iterations`,projectConfig:!0,recorded:!0},{key:`delayMs`,names:[`--delay-ms`],type:`int`,min:0,max:1e4,usageLabel:`--delay-ms <ms>`,usageDescription:`Delay between typed characters`,projectConfig:!0,recorded:!0},{key:`recordAs`,names:[`--record-as`],type:`string`,usageLabel:`--record-as <VAR>`,usageDescription:"Fill: send the live text but publish ${VAR} in an armed .ad recording",projectConfig:!0,recorded:!1},{key:`textStdin`,names:[`--text-stdin`],type:`boolean`,usageLabel:`--text-stdin`,usageDescription:`Fill: read the text from stdin (max 64 KiB, one trailing newline removed) instead of argv`,projectConfig:!1,recorded:!1},{key:`durationMs`,names:[`--duration-ms`],type:`int`,min:0,max:1e4,usageLabel:`--duration-ms <ms>`,usageDescription:`Scroll: pace the gesture over this duration when supported`,projectConfig:!0,recorded:!1},{key:`holdMs`,names:[`--hold-ms`],type:`int`,min:0,max:1e4,usageLabel:`--hold-ms <ms>`,usageDescription:`Press or gesture tap hold duration for each iteration`,projectConfig:!0,recorded:!0},{key:`jitterPx`,names:[`--jitter-px`],type:`int`,min:0,max:100,usageLabel:`--jitter-px <n>`,usageDescription:`Deterministic per-axis coordinate jitter in pixels`,projectConfig:!0,recorded:!0},{key:`pixels`,names:[`--pixels`],type:`int`,min:1,max:1e5,usageLabel:`--pixels <n>`,usageDescription:`Scroll: explicit gesture distance in pixels`,projectConfig:!0,recorded:!1},{key:`until`,names:[`--until`],type:`string`,usageLabel:`--until <selector>`,usageDescription:`Scroll: repeat passes until the selector is visible on screen`,projectConfig:!0,recorded:!0},{key:`maxPasses`,names:[`--max-passes`],type:`int`,min:1,max:200,usageLabel:`--max-passes <n>`,usageDescription:`Scroll --until: maximum gestures`,projectConfig:!1,recorded:!0},{key:`doubleTap`,names:[`--double-tap`],type:`boolean`,usageLabel:`--double-tap`,usageDescription:`Use double-tap gesture per press iteration`,projectConfig:!0,recorded:!0},{key:`verify`,names:[`--verify`],type:`boolean`,usageLabel:`--verify`,usageDescription:`Capture cheap post-action evidence (AX digest, node counts, changedFromBefore) instead of a follow-up snapshot`,projectConfig:!0,recorded:!1},{key:`settle`,names:[`--settle`],type:`boolean`,usageLabel:`--settle`,usageDescription:`After the action, wait for the UI to go quiet and return the settled diff vs the pre-action tree in the same response (best-effort; never fails the action)`,projectConfig:!0,recorded:!1},{key:`settleQuietMs`,names:[`--settle-quiet`],type:`int`,min:0,usageLabel:`--settle-quiet <ms>`,usageDescription:`Settle: quiet window the UI must hold to count as settled (default 500ms; 300ms when the settled tree comes from the iOS simulator snapshot bridge). On iOS, a broad screen replacement such as a modal dismissal is confirmed for at least 1500ms whatever window is asked for, within the --timeout settle deadline; a replacement from a screen the pre-action capture read as presenting nothing, such as a tab switch, gets no 1500ms confirmation and keeps the asked window`,projectConfig:!0,recorded:!1},{key:`postGestureStabilization`,names:[`--no-post-gesture-stabilization`],type:`boolean`,setValue:!1,usageLabel:`--no-post-gesture-stabilization`,usageHidden:!0,usageDescription:`Scroll, swipe, gesture swipe: skip the movement check and the stabilization wait that follow a gesture; use it only when your own polling verifies the screen`,inputDescription:`Set false to skip the movement check on a directional scroll and the stabilization wait before the next read. Set it only when your own polling verifies the screen: the next read can return a tree that the gesture is still moving.`,projectConfig:!1,recorded:!1},{key:`clickButton`,names:[`--button`],type:`enum`,enumValues:[`primary`,`secondary`,`middle`],usageLabel:`--button primary|secondary|middle`,usageDescription:`Click: choose mouse button (middle reserved for future macOS support)`,projectConfig:!0,recorded:!0},{key:`backMode`,names:[`--in-app`],type:`enum`,enumValues:[`in-app`,`system`],setValue:`in-app`,usageLabel:`--in-app`,usageDescription:`Back: use app-provided back UI when available; on iOS, the verified left-edge back swipe`,projectConfig:!0,recorded:!1},{key:`backMode`,names:[`--system`],type:`enum`,enumValues:[`in-app`,`system`],setValue:`system`,usageLabel:`--system`,usageDescription:`Back: use system back input or gesture when available; on iOS, the same left-edge back swipe as --in-app`,projectConfig:!0,recorded:!1},{key:`pauseMs`,names:[`--pause-ms`],type:`int`,min:0,max:1e4,usageLabel:`--pause-ms <ms>`,usageDescription:`Delay between swipe or gesture tap iterations`,projectConfig:!0,recorded:!0},{key:`pattern`,names:[`--pattern`],type:`enum`,enumValues:[`one-way`,`ping-pong`],usageLabel:`--pattern one-way|ping-pong`,usageDescription:`Swipe repeat pattern`,projectConfig:!0,recorded:!0},{key:`verbose`,names:[`--debug`,`--verbose`,`-v`],type:`boolean`,usageLabel:`--debug, --verbose, -v`,usageDescription:`Enable debug diagnostics; test --verbose prints per-test step timings without debug logs`,projectConfig:!0,recorded:!0},{key:`cost`,names:[`--cost`],type:`boolean`,usageLabel:`--cost`,usageDescription:`Include per-command wall-clock latency (cost.wallClockMs) in the response`,projectConfig:!0,recorded:!1},{key:`responseLevel`,names:[`--level`],type:`enum`,enumValues:e,usageLabel:`--level digest|default|full`,usageDescription:`Response detail level: digest (token-cheap), default (today), or full. Default keeps the wire shape unchanged.`,projectConfig:!0,recorded:!1},{key:`json`,names:[`--json`],type:`boolean`,usageLabel:`--json`,usageDescription:`JSON output`,projectConfig:!0,recorded:!1},{key:`help`,names:[`--help`,`-h`],type:`boolean`,usageLabel:`--help, -h`,usageDescription:`Print help and exit`,projectConfig:!1,recorded:!1},{key:`version`,names:[`--version`,`-V`],type:`boolean`,usageLabel:`--version, -V`,usageDescription:`Print version and exit`,projectConfig:!1,recorded:!1},{key:`snapshotDiff`,names:[`--diff`],type:`boolean`,usageLabel:`--diff`,usageDescription:`Snapshot: show structural diff against the previous session baseline`,projectConfig:!0,recorded:!1},{key:`saveScript`,names:[`--save-script`],type:`booleanOrString`,usageLabel:`--save-script [path]`,usageDescription:`Arm evidence capture on open, publish the armed recording on close; close --save-script alone (without an armed open) is rejected — start with open --save-script, or use session save-script mid-session. Optional custom output path.`,projectConfig:!1,recorded:!0},{key:`networkInclude`,names:[`--include`],type:`enum`,enumValues:[`summary`,`headers`,`body`,`all`],usageLabel:`--include summary|headers|body|all`,usageDescription:`Network: include headers, bodies, or both in output`,projectConfig:!0,recorded:!1},{key:`shutdown`,names:[`--shutdown`],type:`boolean`,usageLabel:`--shutdown`,usageDescription:`close: shutdown associated simulator/emulator after ending session`,projectConfig:!0,recorded:!1},{key:`relaunch`,names:[`--relaunch`],type:`boolean`,usageLabel:`--relaunch`,usageDescription:`open: terminate app process before launching it`,projectConfig:!0,recorded:!0},{key:`foreground`,names:[`--foreground`],type:`boolean`,usageLabel:`--foreground`,usageDescription:`open: keep normal app/device selection and return an initial snapshot; without an app, resolve the sole running app on the sole booted iOS simulator`,inputDescription:`Include an initial interactive snapshot in a fresh open response. With no app argument, discover the sole running app on the sole booted iOS simulator; ambiguous environments fail closed.`,projectConfig:!1,recorded:!1},{key:`restart`,names:[`--restart`],type:`boolean`,usageLabel:`--restart`,usageDescription:`logs clear: stop active stream, clear logs, then start streaming again`,projectConfig:!0,recorded:!1},{key:`retainPaths`,names:[`--retain-paths`],type:`boolean`,usageLabel:`--retain-paths`,usageDescription:`install-from-source: keep materialized artifact paths after install`,projectConfig:!0,recorded:!1},{key:`retentionMs`,names:[`--retention-ms`],type:`int`,min:1,max:2147483647,usageLabel:`--retention-ms <ms>`,usageDescription:`install-from-source: retain files for 1-2147483647 ms`,inputDescription:`When retainPaths is true, keep downloaded and extracted files for this many milliseconds.`,projectConfig:!0,recorded:!1},{key:`noRecord`,names:[`--no-record`],type:`boolean`,usageLabel:`--no-record`,usageDescription:`Do not record this action`,projectConfig:!0,recorded:!0},{key:`record`,names:[`--record`],type:`boolean`,usageLabel:`--record`,usageHidden:!0,usageDescription:`Force-record this action into a repair-armed heal; per-invocation only, the retired config key "record" no longer opts in (mutually exclusive with --no-record)`,projectConfig:!1,recorded:!0}],d=[{key:`config`,names:[`--config`],type:`string`,usageLabel:`--config <path>`,usageDescription:`Load CLI defaults from a specific config file (required for connection/provider defaults outside user config)`,projectConfig:!1,recorded:!1},{key:`remoteConfig`,names:[`--remote-config`],type:`string`,usageLabel:`--remote-config <path>`,usageDescription:`Load remote host + Metro workflow settings from a specific profile file`,projectConfig:!1,recorded:!1},{key:`stateDir`,names:[`--state-dir`],type:`string`,usageLabel:`--state-dir <path>`,usageDescription:`Daemon state directory (defaults to ~/.agent-device for packages, or a worktree-scoped dev dir from source)`,projectConfig:!1,recorded:!1},{key:`daemonBaseUrl`,names:[`--daemon-base-url`],type:`string`,usageLabel:`--daemon-base-url <url>`,usageDescription:`Explicit remote HTTP daemon base URL (skip local daemon discovery/startup)`,projectConfig:!1,recorded:!1},{key:`daemonAuthToken`,names:[`--daemon-auth-token`],type:`string`,usageLabel:`--daemon-auth-token <token>`,usageDescription:`Remote HTTP daemon or proxy auth token (sent as request token and bearer header)`,projectConfig:!1,recorded:!1},{key:`daemonTransport`,names:[`--daemon-transport`],type:`enum`,enumValues:[`auto`,`socket`,`http`],usageLabel:`--daemon-transport auto|socket|http`,usageDescription:`Daemon client transport preference`,projectConfig:!1,recorded:!1},{key:`daemonServerMode`,names:[`--daemon-server-mode`],type:`enum`,enumValues:[`socket`,`http`,`dual`],usageLabel:`--daemon-server-mode socket|http|dual`,usageDescription:`Daemon server mode used when spawning daemon`,projectConfig:!1,recorded:!1},{key:`proxyHost`,names:[`--host`],type:`string`,usageLabel:`--host <host>`,usageDescription:`Proxy: host interface to bind (default: 127.0.0.1)`,projectConfig:!1,recorded:!1},{key:`proxyPort`,names:[`--port`],type:`int`,min:1,max:65535,usageLabel:`--port <port>`,usageDescription:`Proxy: TCP port to bind (default: 0, choose a free port)`,projectConfig:!1,recorded:!1},{key:`mcpStructured`,names:[`--structured`],type:`boolean`,usageLabel:`--structured`,usageDescription:`MCP: advertise tool output schemas and return structuredContent; results are text only by default`,projectConfig:!1,recorded:!1},{key:`tenant`,names:[`--tenant`],type:`string`,usageLabel:`--tenant <id>`,usageDescription:`Tenant scope identifier for isolated daemon sessions`,projectConfig:!1,recorded:!1},{key:`sessionIsolation`,names:[`--session-isolation`],type:`enum`,enumValues:[`none`,`tenant`],usageLabel:`--session-isolation none|tenant`,usageDescription:`Session isolation strategy (tenant prefixes session namespace)`,projectConfig:!1,recorded:!1},{key:`runId`,names:[`--run-id`],type:`string`,usageLabel:`--run-id <id>`,usageDescription:`Run identifier used for tenant lease admission checks`,projectConfig:!1,recorded:!1},{key:`leaseId`,names:[`--lease-id`],type:`string`,usageLabel:`--lease-id <id>`,usageDescription:`Lease identifier bound to tenant/run admission scope`,projectConfig:!1,recorded:!1},{key:`leaseBackend`,names:[`--lease-backend`],type:`enum`,enumValues:t,usageLabel:`--lease-backend ${t.join(`|`)}`,usageDescription:`Lease backend for remote tenant connection admission`,projectConfig:!1,recorded:!1},{key:`provider`,names:[`--provider`],type:`string`,usageLabel:`--provider <name>`,usageDescription:`Cloud provider name for provider-scoped commands`,projectConfig:!1,recorded:!1},{key:`providerSessionId`,names:[`--provider-session`],type:`string`,usageLabel:`--provider-session <id>`,usageDescription:`Cloud provider session id or ARN`,projectConfig:!1,recorded:!1},{key:`providerApp`,names:[`--provider-app`],type:`string`,usageLabel:`--provider-app <ref-or-path>`,usageDescription:`Cloud provider app reference or local app path used when creating hosted WebDriver sessions`,projectConfig:!1,recorded:!1},{key:`providerOsVersion`,names:[`--provider-os-version`,`--os-version`],type:`string`,usageLabel:`--provider-os-version <version>`,usageDescription:`Hosted cloud provider OS version, for example 17 or 14.0`,projectConfig:!1,recorded:!1},{key:`providerDeviceType`,names:[`--provider-device-type`],type:`enum`,enumValues:s,usageLabel:`--provider-device-type real|virtual`,usageDescription:`TestMu AI device pool: real devices or virtual devices (emulators and simulators). Defaults to virtual`,projectConfig:!1,recorded:!1},{key:`providerProject`,names:[`--provider-project`],type:`string`,usageLabel:`--provider-project <name>`,usageDescription:`Hosted cloud provider project label`,projectConfig:!1,recorded:!1},{key:`providerBuild`,names:[`--provider-build`],type:`string`,usageLabel:`--provider-build <name>`,usageDescription:`Hosted cloud provider build label`,projectConfig:!1,recorded:!1},{key:`providerSessionName`,names:[`--provider-session-name`],type:`string`,usageLabel:`--provider-session-name <name>`,usageDescription:`Hosted cloud provider session label`,projectConfig:!1,recorded:!1},{key:`providerDeviceOrientation`,names:[`--provider-device-orientation`,`--device-orientation`],type:`enum`,enumValues:o,usageLabel:`--provider-device-orientation portrait|landscape`,usageDescription:`Screen orientation a hosted cloud provider session starts in. Set this rather than rotating after launch: a session that boots landscape renders login webviews landscape`,projectConfig:!1,recorded:!1},{key:`providerGeoLocation`,names:[`--provider-geo-location`,`--geo-location`],type:`string`,usageLabel:`--provider-geo-location <country>`,usageDescription:`Hosted cloud provider IP geolocation country code, for example US`,projectConfig:!1,recorded:!1},{key:`providerTimezone`,names:[`--provider-timezone`,`--timezone`],type:`string`,usageLabel:`--provider-timezone <zone>`,usageDescription:`Hosted cloud provider device time zone, for example New_York`,projectConfig:!1,recorded:!1},{key:`providerAppiumVersion`,names:[`--provider-appium-version`,`--appium-version`],type:`string`,usageLabel:`--provider-appium-version <version>`,usageDescription:`Hosted cloud provider Appium server version, for example 3.2.0. Without it each provider starts its own default (Appium 1.x on BrowserStack)`,projectConfig:!1,recorded:!1},{key:`providerLanguage`,names:[`--provider-language`,`--language`],type:`string`,usageLabel:`--provider-language <language>`,usageDescription:`Hosted cloud provider app language, for example Fr`,projectConfig:!1,recorded:!1},{key:`providerLocale`,names:[`--provider-locale`,`--locale`],type:`string`,usageLabel:`--provider-locale <locale>`,usageDescription:`Hosted cloud provider device locale, for example Fr`,projectConfig:!1,recorded:!1},{key:`providerNetworkProfile`,names:[`--provider-network-profile`,`--network-profile`],type:`string`,usageLabel:`--provider-network-profile <profile>`,usageDescription:`Hosted cloud provider named network condition profile, for example 4g-lte-advanced-good. Mutually exclusive with --provider-custom-network`,projectConfig:!1,recorded:!1},{key:`providerCustomNetwork`,names:[`--provider-custom-network`,`--custom-network`],type:`string`,usageLabel:`--provider-custom-network <shape>`,usageDescription:`Hosted cloud provider custom network shape. Mutually exclusive with --provider-network-profile`,projectConfig:!1,recorded:!1},{key:`providerNoResignApp`,names:[`--provider-no-resign-app`],type:`boolean`,usageLabel:`--provider-no-resign-app`,usageDescription:`iOS only: keep an Enterprise-signed app as uploaded instead of letting the provider re-sign it, which strips entitlements such as push notifications`,projectConfig:!1,recorded:!1},{key:`providerNetworkLogs`,names:[`--provider-network-logs`],type:`boolean`,usageLabel:`--provider-network-logs`,usageDescription:`Limrun: capture session network traffic; artifacts and close write it as a HAR file on the daemon host and print its path and any capture failures. Pass --provider-network-hosts with your app API hosts. Captured traffic exits through the daemon host, the HAR holds raw headers and bodies, certificate-pinned hosts and HTTPS hosts without HTTP/2 fail to connect, and DNS-over-HTTPS bypasses the capture`,projectConfig:!1,recorded:!1},{key:`providerNetworkHosts`,names:[`--provider-network-hosts`],type:`string`,usageLabel:`--provider-network-hosts <list>`,usageDescription:`With --provider-network-logs: comma-separated hosts to capture, such as your app API hosts (exact hosts, wildcards like *.example.com, or localhost:<port> routes). Replaces the noisy default of common public domains plus localhost:8081`,projectConfig:!1,recorded:!1},{key:`awsProjectArn`,names:[`--aws-project-arn`],type:`string`,usageLabel:`--aws-project-arn <arn>`,usageDescription:`AWS Device Farm project ARN for hosted WebDriver sessions`,projectConfig:!1,recorded:!1},{key:`awsDeviceArn`,names:[`--aws-device-arn`],type:`string`,usageLabel:`--aws-device-arn <arn>`,usageDescription:`AWS Device Farm device ARN for hosted WebDriver sessions`,projectConfig:!1,recorded:!1},{key:`awsAppArn`,names:[`--aws-app-arn`],type:`string`,usageLabel:`--aws-app-arn <arn>`,usageDescription:`AWS Device Farm app ARN attached to hosted remote access sessions`,projectConfig:!1,recorded:!1},{key:`awsRegion`,names:[`--aws-region`],type:`string`,usageLabel:`--aws-region <region>`,usageDescription:`AWS region for Device Farm API calls`,projectConfig:!1,recorded:!1},{key:`awsInteractionMode`,names:[`--aws-interaction-mode`],type:`enum`,enumValues:[`INTERACTIVE`,`NO_VIDEO`,`VIDEO_ONLY`],usageLabel:`--aws-interaction-mode INTERACTIVE|NO_VIDEO|VIDEO_ONLY`,usageDescription:`AWS Device Farm remote access interaction mode`,projectConfig:!1,recorded:!1},{key:`force`,names:[`--force`,`--overwrite`],type:`boolean`,usageLabel:`--force, --overwrite`,usageDescription:`Force replacement of existing state (connect: replace an active connection; --save-script: overwrite an existing target instead of refusing)`,projectConfig:!0,recorded:!0},{key:`clean`,names:[`--clean`],type:`boolean`,usageLabel:`--clean`,usageDescription:`Daemon stop: remove retained runner processes and leases after stopping`,projectConfig:!0,recorded:!1},{key:`noLogin`,names:[`--no-login`],type:`boolean`,usageLabel:`--no-login`,usageDescription:`Connect: fail instead of starting implicit cloud login`,projectConfig:!0,recorded:!1},{key:`sessionLock`,names:[`--session-lock`],type:`enum`,enumValues:[`reject`,`strip`],usageLabel:`--session-lock reject|strip`,usageDescription:`Lock bound-session device routing for this CLI invocation and nested batch steps; strip drops conflicting platform/scope selectors only, and a selector naming a different device always fails`,projectConfig:!0,recorded:!1}],f=[{key:`platform`,names:[`--platform`],type:`enum`,enumValues:r,usageLabel:`--platform ${r.join(`|`)}`,usageDescription:"Platform to target (`apple` aliases the Apple automation backend)",projectConfig:!0,recorded:!0},{key:`target`,names:[`--target`],type:`enum`,enumValues:[`mobile`,`tv`,`desktop`],usageLabel:`--target mobile|tv|desktop`,usageDescription:`Device target class to match`,projectConfig:!0,recorded:!1},{key:`device`,names:[`--device`],type:`string`,usageLabel:`--device <name>`,usageDescription:`Device name to target (a UDID belongs in --udid, a serial in --serial)`,projectConfig:!0,recorded:!0},{key:`udid`,names:[`--udid`],type:`string`,usageLabel:`--udid <udid>`,usageDescription:`Apple device or simulator UDID; the only selector that pins one device when several share a --device name`,projectConfig:!0,recorded:!0},{key:`serial`,names:[`--serial`],type:`string`,usageLabel:`--serial <serial>`,usageDescription:`Android, HarmonyOS, or Vega VVD serial`,projectConfig:!0,recorded:!0},{key:`osVersion`,names:[`--os`],type:`string`,usageLabel:`--os <version|range>`,usageDescription:`Proxy lease: OS version or range the backend picks the device by (Android: API level); refused without such a backend`,inputDescription:`Proxy lease: OS version or range, for example 18.6.2 or ">=26" (Android: API level). Honored only by a proxy backend that leases by spec; other daemons refuse it.`,projectConfig:!1,recorded:!1},{key:`imageTag`,names:[`--image-tag`],type:`string`,usageLabel:`--image-tag <tag>`,usageDescription:`Proxy lease: Android system image tag the backend picks the device by; refused without such a backend`,inputDescription:`Proxy lease: Android system image tag, for example google_apis_playstore. Honored only by a proxy backend that leases by spec; other daemons refuse it.`,projectConfig:!1,recorded:!1},{key:`deviceMode`,names:[`--device-mode`],type:`string`,usageLabel:`--device-mode <slim|full>`,usageDescription:`Proxy lease: iOS simulator mode (slim or full) the backend leases; refused without such a backend`,inputDescription:`Proxy lease: iOS simulator mode, slim or full. Honored only by a proxy backend that leases by spec; other daemons refuse it.`,projectConfig:!1,recorded:!1},{key:`deviceBaseline`,names:[`--device-baseline`],type:`string`,usageLabel:`--device-baseline <name>`,usageDescription:`Proxy lease: saved device state (baseline) the backend restores on the leased device; refused without such a backend`,inputDescription:`Proxy lease: saved device state (baseline) to restore on the leased device. Honored only by a proxy backend that leases by spec; other daemons refuse it.`,projectConfig:!1,recorded:!1},{key:`physical`,names:[`--physical`],type:`boolean`,usageLabel:`--physical`,usageDescription:`Proxy lease: ask the backend for a physical device instead of a simulator or emulator; refused without such a backend`,inputDescription:`Proxy lease: true requests a physical device; false selects nothing. Honored only by a proxy backend that leases by spec; other daemons refuse it.`,projectConfig:!1,recorded:!1},{key:`stale`,names:[`--stale`],type:`boolean`,usageLabel:`--stale`,usageDescription:`Device status: show only claims with a provably stale owner`,projectConfig:!0,recorded:!1},{key:`surface`,names:[`--surface`],type:`enum`,enumValues:c,usageLabel:`--surface app|frontmost-app|desktop|menubar`,usageDescription:`macOS session surface for open (defaults to app)`,projectConfig:!0,recorded:!0},{key:`headless`,names:[`--headless`],type:`boolean`,usageLabel:`--headless`,usageDescription:`Boot: launch Android emulator without a GUI window`,projectConfig:!0,recorded:!1},{key:`pick`,names:[`--pick`],type:`enum`,enumValues:i,usageLabel:`--pick ${i.join(`|`)}`,usageDescription:`Boot: when several equally preferred matches are all shut down, boot one (mobile over TV, newest OS, then name) instead of failing; booted ties still fail`,projectConfig:!1,recorded:!1},{key:`targetApp`,names:[`--app`,`--target-app`],type:`string`,usageLabel:`--app <id-or-name>`,usageDescription:`Target an app without opening it: doctor verifies an installed app by id or name; settings applies an app-scoped change (permission, iOS location) to a bundle id or package`,projectConfig:!1,recorded:!1},{key:`metroHost`,names:[`--metro-host`],type:`string`,usageLabel:`--metro-host <host>`,usageDescription:`Session-scoped Metro/debug host hint`,projectConfig:!1,recorded:!0},{key:`metroPort`,names:[`--metro-port`],type:`int`,min:1,max:65535,usageLabel:`--metro-port <port>`,usageDescription:`Session-scoped Metro/debug port hint; on an emulator/simulator the host defaults to the loopback alias, physical devices still need --metro-host`,projectConfig:!1,recorded:!0},{key:`metroProjectRoot`,names:[`--project-root`],type:`string`,usageLabel:`--project-root <path>`,usageDescription:`metro prepare: React Native project root (default: cwd)`,projectConfig:!1,recorded:!1},{key:`kind`,names:[`--kind`],type:`enum`,enumValues:[`auto`,`react-native`,`expo`,`repack`,...l],usageLabel:`--kind <kind>`,usageDescription:`Kind selector for commands that support it, such as metro prepare or perf artifact collectors`,projectConfig:!0,recorded:!1},{key:`perfTemplate`,names:[`--template`],type:`string`,usageLabel:`--template <name>`,usageDescription:`Perf xctrace template name, for example Time Profiler`,projectConfig:!0,recorded:!1},{key:`metroKind`,names:[`--metro-kind`],type:`enum`,enumValues:[`auto`,`react-native`,`expo`,`repack`],usageLabel:`--metro-kind auto|react-native|expo|repack`,usageDescription:`metro prepare: detect or force the React Native dev-server launcher kind`,projectConfig:!1,recorded:!1},{key:`metroPublicBaseUrl`,names:[`--public-base-url`],type:`string`,usageLabel:`--public-base-url <url>`,usageDescription:`metro prepare: public base URL used for direct dev-server bundle hints`,projectConfig:!1,recorded:!1},{key:`metroProxyBaseUrl`,names:[`--proxy-base-url`],type:`string`,usageLabel:`--proxy-base-url <url>`,usageDescription:`metro prepare: optional bridge origin for remote dev-server access`,projectConfig:!1,recorded:!1},{key:`metroBearerToken`,names:[`--bearer-token`],type:`string`,usageLabel:`--bearer-token <token>`,usageDescription:`metro prepare: host bridge bearer token (or AGENT_DEVICE_METRO_BEARER_TOKEN; falls back to AGENT_DEVICE_DAEMON_AUTH_TOKEN)`,projectConfig:!1,recorded:!1},{key:`metroPreparePort`,names:[`--port`],type:`int`,min:1,max:65535,usageLabel:`--port <port>`,usageDescription:`metro prepare: local dev-server port (default: 8081)`,projectConfig:!1,recorded:!1},{key:`metroListenHost`,names:[`--listen-host`],type:`string`,usageLabel:`--listen-host <host>`,usageDescription:`metro prepare: host dev server listens on (default: 0.0.0.0)`,projectConfig:!1,recorded:!1},{key:`metroStatusHost`,names:[`--status-host`],type:`string`,usageLabel:`--status-host <host>`,usageDescription:`metro prepare: host used for local dev-server /status polling (default: 127.0.0.1)`,projectConfig:!1,recorded:!1},{key:`metroStartupTimeoutMs`,names:[`--startup-timeout-ms`],type:`int`,min:1,usageLabel:`--startup-timeout-ms <ms>`,usageDescription:`metro prepare: timeout while waiting for the dev server to become ready`,projectConfig:!1,recorded:!1},{key:`metroProbeTimeoutMs`,names:[`--probe-timeout-ms`],type:`int`,min:1,usageLabel:`--probe-timeout-ms <ms>`,usageDescription:`metro prepare: timeout for /status and proxy bridge calls`,projectConfig:!1,recorded:!1},{key:`metroRuntimeFile`,names:[`--runtime-file`],type:`string`,usageLabel:`--runtime-file <path>`,usageDescription:`metro prepare: optional file path to persist the JSON result`,projectConfig:!1,recorded:!1},{key:`metroNoReuseExisting`,names:[`--no-reuse-existing`],type:`boolean`,usageLabel:`--no-reuse-existing`,usageDescription:`metro prepare: always start a fresh Metro process`,projectConfig:!1,recorded:!1},{key:`metroNoInstallDeps`,names:[`--no-install-deps`],type:`boolean`,usageLabel:`--no-install-deps`,usageDescription:`metro prepare: skip package-manager install when node_modules is missing`,projectConfig:!1,recorded:!1},{key:`bundleUrl`,names:[`--bundle-url`],type:`string`,usageLabel:`--bundle-url <url>`,usageDescription:`Session-scoped bundle URL hint`,projectConfig:!1,recorded:!0},{key:`launchUrl`,names:[`--launch-url`],type:`string`,usageLabel:`--launch-url <url>`,usageDescription:`Session-scoped deep link / launch URL hint`,projectConfig:!0,recorded:!0},{key:`iosSimulatorDeviceSet`,names:[`--ios-simulator-device-set`],type:`string`,usageLabel:`--ios-simulator-device-set <path>`,usageDescription:`Scope iOS simulator discovery/commands to this simulator device set`,projectConfig:!1,recorded:!1},{key:`iosXctestrunFile`,names:[`--ios-xctestrun-file`],type:`string`,usageLabel:`--ios-xctestrun-file <path>`,usageDescription:`Use an externally built iOS XCTest runner .xctestrun artifact`,projectConfig:!1,recorded:!1},{key:`iosXctestDerivedDataPath`,names:[`--ios-xctest-derived-data-path`],type:`string`,usageLabel:`--ios-xctest-derived-data-path <path>`,usageDescription:`Derived data path for external iOS XCTest runner execution`,projectConfig:!1,recorded:!1},{key:`iosXctestEnvDir`,names:[`--ios-xctest-env-dir`],type:`string`,usageLabel:`--ios-xctest-env-dir <path>`,usageDescription:`Writable directory for per-session iOS XCTest runner env overlays`,projectConfig:!1,recorded:!1},{key:`testIme`,names:[`--test-ime`],type:`boolean`,usageLabel:`--test-ime`,usageDescription:`open/test/replay: activate the headless Android test IME for deterministic Unicode text entry (default on for emulators; opt-in on real devices; on test/replay it applies to the sessions the flow opens)`,projectConfig:!0,recorded:!1},{key:`testIme`,names:[`--no-test-ime`],type:`boolean`,setValue:!1,usageLabel:`--no-test-ime`,usageDescription:`open/test/replay: keep the real Android keyboard even on emulators (opt out of the headless test IME; on test/replay it applies to the sessions the flow opens)`,projectConfig:!0,recorded:!1},{key:`androidDeviceAllowlist`,names:[`--android-device-allowlist`],type:`string`,usageLabel:`--android-device-allowlist <serials>`,usageDescription:`Comma/space separated Android serial allowlist for discovery/selection`,projectConfig:!1,recorded:!1},{key:`remote`,names:[`--remote`],type:`boolean`,usageLabel:`--remote`,usageDescription:`Doctor: check remote connection setup instead of local device inventory`,projectConfig:!0,recorded:!1},{key:`activity`,names:[`--activity`],type:`string`,usageLabel:`--activity <component>`,usageDescription:`Android launch activity (package/Class, .Class, or Class) or HarmonyOS ability name; not for URL opens`,projectConfig:!0,recorded:!1},{key:`launchConsole`,names:[`--launch-console`],type:`string`,usageLabel:`--launch-console <path>`,usageDescription:`open: capture the initial local or Limrun iOS simulator launch console window to a file`,projectConfig:!1,recorded:!1},{key:`launchArgs`,names:[`--launch-args`],type:`string`,multiple:!0,usageLabel:`--launch-args <arg>`,usageDescription:`open: repeatable launch argument forwarded verbatim to the platform launch command (iOS app process args; Android adb shell am start args). Linux and macOS reject the flag.`,projectConfig:!0,recorded:!1},{key:`header`,names:[`--header`],type:`string`,multiple:!0,usageLabel:`--header <name:value>`,usageDescription:`install-from-source: repeatable HTTP header for URL downloads`,projectConfig:!1,recorded:!1},{key:`githubActionsArtifact`,names:[`--github-actions-artifact`],type:`string`,usageLabel:`--github-actions-artifact <owner/repo:artifact>`,usageDescription:`install-from-source: GitHub Actions artifact resolved by a remote daemon`,projectConfig:!1,recorded:!1},{key:`installSource`,names:[],type:`string`,projectConfig:!1,recorded:!1},{key:`session`,names:[`--session`],type:`string`,usageLabel:`--session <name>`,usageDescription:`Named session (implicit default is scoped to this workspace + platform)`,projectConfig:!0,recorded:!1}],p=[{key:`replayUpdate`,names:[`--update`,`-u`],type:`boolean`,usageLabel:`--update, -u`,usageDescription:`Replay: retired as a rewrite (ADR 0012) — never edits the .ad file; every divergence already carries ranked selector suggestions, --update or not`,projectConfig:!0,recorded:!1},{key:`replayFrom`,names:[`--from`],type:`int`,min:1,usageLabel:`--from <n>`,usageDescription:`Replay: resume at 1-based plan step n, skipping 1..n-1 without executing them (requires --plan-digest; see a divergence report's resume field). replay only, not test`,projectConfig:!0,recorded:!1},{key:`replayPlanDigest`,names:[`--plan-digest`],type:`string`,usageLabel:`--plan-digest <sha256>`,usageDescription:`Replay: the plan digest a --from resume must match (from a prior divergence report); mismatch, edits, or include/platform-expansion changes fail INVALID_ARGS before any action`,projectConfig:!0,recorded:!1},{key:`replayKeepSession`,names:[`--keep-session`],type:`boolean`,usageLabel:`--keep-session`,usageDescription:`Replay: leave the session active by suppressing exactly an authored terminal close in a native .ad script; replay only, not test or Maestro YAML`,projectConfig:!0,recorded:!1},{key:`replayMaestro`,names:[`--maestro`],type:`boolean`,usageLabel:`--maestro`,usageDescription:`Replay: treat input as a supported Maestro YAML subset; unsupported syntax fails loudly. See agent-device help maestro for commands and boundaries`,projectConfig:!0,recorded:!1},{key:`replayEnv`,names:[`-e`,`--env`],type:`string`,multiple:!0,usageLabel:`-e KEY=VALUE, --env KEY=VALUE`,usageDescription:"Replay/Test: inject or override a ${KEY} variable for the script (repeatable)",projectConfig:!1,recorded:!1},{key:`failFast`,names:[`--fail-fast`],type:`boolean`,usageLabel:`--fail-fast`,usageDescription:`Test: stop the suite after the first failing script; with sharding, each shard stops independently`,projectConfig:!0,recorded:!1},{key:`timeoutMs`,names:[`--timeout`],type:`int`,min:1,usageLabel:`--timeout <ms>`,usageDescription:`Boot/Open/Prepare: startup budget covering the device boot (and runner preparation for prepare). Replay/Snapshot/Test: maximum wall-clock time for the command or attempt. With --settle: the settle-wait deadline (default 10s)`,projectConfig:!0,recorded:!1},{key:`waitMs`,names:[`--wait`],type:`int`,min:100,max:12e4,usageLabel:`--wait <ms>`,usageDescription:`Open: wait up to n ms for a device another session is holding before failing with DEVICE_IN_USE`,inputDescription:`Wait up to n milliseconds (100-120000) while another session holds the device, then fail with DEVICE_IN_USE. A claim held by another workspace fails at once. The wait extends this command's timeout.`,projectConfig:!1,recorded:!1},{key:`retries`,names:[`--retries`],type:`int`,min:0,max:3,usageLabel:`--retries <n>`,usageDescription:`Test: retry each failed script up to n additional times`,projectConfig:!0,recorded:!1},{key:`recordVideo`,names:[`--record-video`],type:`boolean`,usageLabel:`--record-video`,usageDescription:`Test: record each replay attempt to recording.mp4 in its attempt artifacts`,projectConfig:!0,recorded:!1},{key:`artifactsDir`,names:[`--artifacts-dir`],type:`string`,usageLabel:`--artifacts-dir <path>`,usageDescription:`Test: root directory for suite artifacts`,projectConfig:!1,recorded:!1},{key:`reporter`,names:[`--reporter`],type:`string`,multiple:!0,usageLabel:`--reporter <name-or-path>`,usageDescription:`Test: add a replay suite reporter; use default, junit:<path>, or a custom reporter path (repeatable)`,projectConfig:!1,recorded:!1},{key:`reportJunit`,names:[`--report-junit`],type:`string`,usageLabel:`--report-junit <path>`,usageDescription:`Test: compatibility alias for --reporter junit:<path>`,projectConfig:!1,recorded:!1},{key:`shardAll`,names:[`--shard-all`],type:`int`,min:1,usageLabel:`--shard-all <n>`,usageDescription:`Test: run the full suite on each of n devices; combine with --device id1,id2 for explicit connected devices; AD_SHARD_INDEX is zero-based`,projectConfig:!0,recorded:!1},{key:`shardSplit`,names:[`--shard-split`],type:`int`,min:1,usageLabel:`--shard-split <n>`,usageDescription:`Test: split runnable suite entries across n devices; AD_SHARD_INDEX is zero-based`,projectConfig:!0,recorded:!1},{key:`steps`,names:[`--steps`],type:`string`,usageLabel:`--steps <json>`,usageDescription:`Batch: JSON array of {"command","input"} steps`,projectConfig:!1,recorded:!1},{key:`stepsFile`,names:[`--steps-file`],type:`string`,usageLabel:`--steps-file <path>`,usageDescription:`Batch: read steps JSON from file`,projectConfig:!1,recorded:!1},{key:`batchOnError`,names:[`--on-error`],type:`enum`,enumValues:[`stop`],usageLabel:`--on-error stop`,usageDescription:`Batch: stop when a step fails`,projectConfig:!0,recorded:!1},{key:`batchMaxSteps`,names:[`--max-steps`],type:`int`,min:1,max:1e3,usageLabel:`--max-steps <n>`,usageDescription:`Batch: maximum number of allowed steps`,projectConfig:!0,recorded:!1},{key:`appsFilter`,names:[`--all`],type:`enum`,enumValues:[`user-installed`,`all`],setValue:`all`,usageLabel:`--all`,usageDescription:`Apps: include system/OEM apps`,projectConfig:!0,recorded:!1},{key:`snapshotInteractiveOnly`,names:[`-i`],type:`boolean`,usageLabel:`-i`,usageDescription:`Snapshot: interactive elements only`,projectConfig:!0,recorded:!0},{key:`snapshotDepth`,names:[`--depth`,`-d`],type:`int`,min:0,usageLabel:`--depth, -d <depth>`,usageDescription:`Snapshot: limit snapshot depth`,projectConfig:!0,recorded:!0},{key:`snapshotScope`,names:[`--scope`,`-s`],type:`string`,usageLabel:`--scope, -s <scope>`,usageDescription:`Snapshot: scope snapshot to label/identifier`,projectConfig:!0,recorded:!0},{key:`snapshotRaw`,names:[`--raw`],type:`boolean`,usageLabel:`--raw`,usageDescription:`Snapshot: raw node output`,projectConfig:!0,recorded:!0},{key:`snapshotCustomActions`,names:[`--actions`],type:`boolean`,usageLabel:`--actions`,usageDescription:`Snapshot: name the affordances merged inside an element (iOS sim); not directly invokable — reach them via the detail screen, labeled children, or coordinates`,inputDescription:`Name the affordances an element merged away (iOS UIAccessibilityCustomAction, React Native accessibilityActions) — a card whose reply/options controls are not separate elements still lists them here. The names are for PLANNING, not invocation: there is no API to trigger them, so reach the affordance through the element detail screen, through the same control exposed as a labeled element elsewhere, or by coordinates from its rect. iOS simulator only; costs one accessibility round trip per merged element.`,projectConfig:!0,recorded:!0},{key:`snapshotObserveOnly`,names:[`--observe-only`],type:`boolean`,usageLabel:`--observe-only`,usageDescription:`Snapshot: observe the iOS session app without activation or foreground repair`,inputDescription:`iOS only. Refuse instead of activating or repairing the session app. Reports XCUIApplication state, which does not prove screen ownership (#2696).`,projectConfig:!1,recorded:!1},{key:`snapshotForceFull`,names:[`--force-full`],type:`boolean`,usageLabel:`--force-full`,usageDescription:`Snapshot: re-emit the full tree even when unchanged`,projectConfig:!0,recorded:!1},{key:`findFirst`,names:[`--first`],type:`boolean`,usageLabel:`--first`,usageDescription:`Find: pick the first match when ambiguous`,projectConfig:!0,recorded:!1},{key:`findLast`,names:[`--last`],type:`boolean`,usageLabel:`--last`,usageDescription:`Find: pick the last match when ambiguous`,projectConfig:!0,recorded:!1},{key:`out`,names:[`--out`],type:`string`,usageLabel:`--out <path>`,usageDescription:`Output path`,projectConfig:!1,recorded:!0},{key:`artifact`,names:[`--artifact`],type:`string`,usageLabel:`--artifact <path>`,usageDescription:`Debug symbols: Apple crash artifact path (.ips, .crash, or .log)`,projectConfig:!1,recorded:!1},{key:`dsym`,names:[`--dsym`],type:`string`,usageLabel:`--dsym <path>`,usageDescription:`Debug symbols: matching .dSYM bundle path`,projectConfig:!1,recorded:!1},{key:`searchPath`,names:[`--search-path`],type:`string`,usageLabel:`--search-path <dir>`,usageDescription:`Debug symbols: directory to scan for matching .dSYM bundles`,projectConfig:!1,recorded:!1},{key:`overlayRefs`,names:[`--overlay-refs`],type:`boolean`,usageLabel:`--overlay-refs`,usageDescription:`Screenshot: draw current snapshot refs and target rectangles onto the saved PNG; diff screenshot: also write a separate current-screen overlay guide`,projectConfig:!0,recorded:!1},...n,{key:`baseline`,names:[`--baseline`,`-b`],type:`string`,usageLabel:`--baseline, -b <path>`,usageDescription:`Diff screenshot: path to baseline image file`,projectConfig:!0,recorded:!1},{key:`threshold`,names:[`--threshold`],type:`string`,usageLabel:`--threshold <0-1>`,usageDescription:`Diff screenshot: color distance threshold (default 0.1)`,projectConfig:!0,recorded:!1}],m=[...d,...f,...u,...p],h=new Map;for(let e of m)for(let t of e.names)h.set(t,e);function g(e){return h.get(e)}function _(){return m}function v(e){return m.filter(t=>t.key===e)}function y(){return new Set(m.filter(e=>e.projectConfig).map(e=>e.key))}function b(){return new Set(m.filter(e=>e.recorded).map(e=>e.key))}export{b as a,y as i,_ as n,v as r,g as t};
|
|
1
|
+
import{i as e,t}from"./sdk-contracts.js";import{c as n}from"./screenshot.js";import"./capture.js";import{a as r,t as i}from"./sdk-device.js";import{t as a}from"./recording-scope.js";import{a as o,o as s}from"./sdk-remote-config.js";import{n as c}from"./session.js";import{c as l}from"./observability.js";const u=[{key:`keyframes`,names:[`--keyframes`],type:`string`,usageLabel:`--keyframes <json>`,usageDescription:`Fold: timed {atMs, angle} keyframes; final atMs is motion duration (up to 60000ms)`,projectConfig:!1,recorded:!0},{key:`count`,names:[`--count`],type:`int`,min:1,max:200,usageLabel:`--count <n>`,usageDescription:`Repeat count for press, swipe and gesture tap series`,projectConfig:!0,recorded:!0},{key:`pointerCount`,names:[`--pointer-count`],type:`int`,min:1,max:2,usageLabel:`--pointer-count <1|2>`,usageDescription:`Gesture pan: number of touch pointers (default 1)`,projectConfig:!0,recorded:!0},{key:`fps`,names:[`--fps`],type:`int`,min:1,max:120,usageLabel:`--fps <n>`,usageDescription:`Record: target frames per second (iOS physical device runner); also lowers the touch-overlay rate, which never exceeds 30`,projectConfig:!0,recorded:!0},{key:`quality`,names:[`--quality`],type:`string`,usageLabel:`--quality <medium|high>`,usageDescription:`Record: output quality preset; Android maps this to screenrecord bitrate, Limrun sessions map medium to recorder quality 5 and high to 8; Apple export always preserves the captured resolution, so it has no effect there. Legacy numeric values 5-7 map to medium; 8-10 map to high`,projectConfig:!0,recorded:!0},{key:`hideTouches`,names:[`--hide-touches`],type:`boolean`,usageLabel:`--hide-touches`,usageDescription:`Record: skip touch-overlay post-processing for faster raw benchmark videos`,projectConfig:!0,recorded:!0},{key:`recordingScope`,names:[`--scope`],type:`enum`,enumValues:a,usageLabel:`--scope <app|device|system>`,usageDescription:`Record: app requires an active app session; device/system records the whole screen`,projectConfig:!0,recorded:!1},{key:`intervalMs`,names:[`--interval-ms`],type:`int`,min:0,max:1e4,usageLabel:`--interval-ms <ms>`,usageDescription:`Delay between press iterations`,projectConfig:!0,recorded:!0},{key:`delayMs`,names:[`--delay-ms`],type:`int`,min:0,max:1e4,usageLabel:`--delay-ms <ms>`,usageDescription:`Delay between typed characters`,projectConfig:!0,recorded:!0},{key:`recordAs`,names:[`--record-as`],type:`string`,usageLabel:`--record-as <VAR>`,usageDescription:"Fill: send the live text but publish ${VAR} in an armed .ad recording",projectConfig:!0,recorded:!1},{key:`textStdin`,names:[`--text-stdin`],type:`boolean`,usageLabel:`--text-stdin`,usageDescription:`Fill: read the text from stdin (max 64 KiB, one trailing newline removed) instead of argv`,projectConfig:!1,recorded:!1},{key:`durationMs`,names:[`--duration-ms`],type:`int`,min:0,max:1e4,usageLabel:`--duration-ms <ms>`,usageDescription:`Scroll: pace the gesture over this duration when supported`,projectConfig:!0,recorded:!1},{key:`holdMs`,names:[`--hold-ms`],type:`int`,min:0,max:1e4,usageLabel:`--hold-ms <ms>`,usageDescription:`Press or gesture tap hold duration for each iteration`,projectConfig:!0,recorded:!0},{key:`jitterPx`,names:[`--jitter-px`],type:`int`,min:0,max:100,usageLabel:`--jitter-px <n>`,usageDescription:`Deterministic per-axis coordinate jitter in pixels`,projectConfig:!0,recorded:!0},{key:`pixels`,names:[`--pixels`],type:`int`,min:1,max:1e5,usageLabel:`--pixels <n>`,usageDescription:`Scroll: explicit gesture distance in pixels`,projectConfig:!0,recorded:!1},{key:`until`,names:[`--until`],type:`string`,usageLabel:`--until <selector>`,usageDescription:`Scroll: repeat passes until the selector is visible on screen`,projectConfig:!0,recorded:!0},{key:`maxPasses`,names:[`--max-passes`],type:`int`,min:1,max:200,usageLabel:`--max-passes <n>`,usageDescription:`Scroll --until: maximum gestures`,projectConfig:!1,recorded:!0},{key:`doubleTap`,names:[`--double-tap`],type:`boolean`,usageLabel:`--double-tap`,usageDescription:`Use double-tap gesture per press iteration`,projectConfig:!0,recorded:!0},{key:`verify`,names:[`--verify`],type:`boolean`,usageLabel:`--verify`,usageDescription:`Capture cheap post-action evidence (AX digest, node counts, changedFromBefore) instead of a follow-up snapshot`,projectConfig:!0,recorded:!1},{key:`settle`,names:[`--settle`],type:`boolean`,usageLabel:`--settle`,usageDescription:`After the action, wait for the UI to go quiet and return the settled diff vs the pre-action tree in the same response (best-effort; never fails the action)`,projectConfig:!0,recorded:!1},{key:`settleQuietMs`,names:[`--settle-quiet`],type:`int`,min:0,usageLabel:`--settle-quiet <ms>`,usageDescription:`Settle: quiet window the UI must hold to count as settled (default 500ms; 300ms when the settled tree comes from the iOS simulator snapshot bridge). On iOS, a broad screen replacement such as a modal dismissal is confirmed for at least 1500ms whatever window is asked for, within the --timeout settle deadline; a replacement from a screen the pre-action capture read as presenting nothing, such as a tab switch, gets no 1500ms confirmation and keeps the asked window`,projectConfig:!0,recorded:!1},{key:`postGestureStabilization`,names:[`--no-post-gesture-stabilization`],type:`boolean`,setValue:!1,usageLabel:`--no-post-gesture-stabilization`,usageHidden:!0,usageDescription:`Scroll, swipe, gesture swipe, open: skip the movement check and the stabilization wait that follow a gesture, and on a local iOS simulator the first-screen wait after an app launch; use it only when your own polling verifies the screen`,inputDescription:`Set false to skip the movement check on a directional scroll and the stabilization wait before the next read, or, on a local iOS simulator, the first-screen wait after an app launch. Set it only when your own polling verifies the screen: the next read can return a tree that the gesture is still moving or the launch screen.`,projectConfig:!1,recorded:!1},{key:`clickButton`,names:[`--button`],type:`enum`,enumValues:[`primary`,`secondary`,`middle`],usageLabel:`--button primary|secondary|middle`,usageDescription:`Click: choose mouse button (middle reserved for future macOS support)`,projectConfig:!0,recorded:!0},{key:`backMode`,names:[`--in-app`],type:`enum`,enumValues:[`in-app`,`system`],setValue:`in-app`,usageLabel:`--in-app`,usageDescription:`Back: use app-provided back UI when available; on iOS, the one hittable navigation bar back button, confirmed by a bar change, else the verified left-edge back swipe`,projectConfig:!0,recorded:!1},{key:`backMode`,names:[`--system`],type:`enum`,enumValues:[`in-app`,`system`],setValue:`system`,usageLabel:`--system`,usageDescription:`Back: use system back input or gesture when available; on iOS, the same back as --in-app`,projectConfig:!0,recorded:!1},{key:`pauseMs`,names:[`--pause-ms`],type:`int`,min:0,max:1e4,usageLabel:`--pause-ms <ms>`,usageDescription:`Delay between swipe or gesture tap iterations`,projectConfig:!0,recorded:!0},{key:`pattern`,names:[`--pattern`],type:`enum`,enumValues:[`one-way`,`ping-pong`],usageLabel:`--pattern one-way|ping-pong`,usageDescription:`Swipe repeat pattern`,projectConfig:!0,recorded:!0},{key:`verbose`,names:[`--debug`,`--verbose`,`-v`],type:`boolean`,usageLabel:`--debug, --verbose, -v`,usageDescription:`Enable debug diagnostics; test --verbose prints per-test step timings without debug logs`,projectConfig:!0,recorded:!0},{key:`cost`,names:[`--cost`],type:`boolean`,usageLabel:`--cost`,usageDescription:`Include per-command wall-clock latency (cost.wallClockMs) in the response`,projectConfig:!0,recorded:!1},{key:`responseLevel`,names:[`--level`],type:`enum`,enumValues:e,usageLabel:`--level digest|default|full`,usageDescription:`Response detail level: digest (token-cheap), default (today), or full. Default keeps the wire shape unchanged.`,projectConfig:!0,recorded:!1},{key:`json`,names:[`--json`],type:`boolean`,usageLabel:`--json`,usageDescription:`JSON output`,projectConfig:!0,recorded:!1},{key:`help`,names:[`--help`,`-h`],type:`boolean`,usageLabel:`--help, -h`,usageDescription:`Print help and exit`,projectConfig:!1,recorded:!1},{key:`version`,names:[`--version`,`-V`],type:`boolean`,usageLabel:`--version, -V`,usageDescription:`Print version and exit`,projectConfig:!1,recorded:!1},{key:`snapshotDiff`,names:[`--diff`],type:`boolean`,usageLabel:`--diff`,usageDescription:`Snapshot: show structural diff against the previous session baseline`,projectConfig:!0,recorded:!1},{key:`saveScript`,names:[`--save-script`],type:`booleanOrString`,usageLabel:`--save-script [path]`,usageDescription:`Arm evidence capture on open, publish the armed recording on close; close --save-script alone (without an armed open) is rejected — start with open --save-script, or use session save-script mid-session. Optional custom output path.`,projectConfig:!1,recorded:!0},{key:`networkInclude`,names:[`--include`],type:`enum`,enumValues:[`summary`,`headers`,`body`,`all`],usageLabel:`--include summary|headers|body|all`,usageDescription:`Network: include headers, bodies, or both in output`,projectConfig:!0,recorded:!1},{key:`shutdown`,names:[`--shutdown`],type:`boolean`,usageLabel:`--shutdown`,usageDescription:`close: shutdown associated simulator/emulator after ending session`,projectConfig:!0,recorded:!1},{key:`relaunch`,names:[`--relaunch`],type:`boolean`,usageLabel:`--relaunch`,usageDescription:`open: terminate app process before launching it`,projectConfig:!0,recorded:!0},{key:`foreground`,names:[`--foreground`],type:`boolean`,usageLabel:`--foreground`,usageDescription:`open: keep normal app/device selection and return an initial snapshot of the first screen (a local iOS simulator waits up to 10s for it); without an app, resolve the sole running app on the sole booted iOS simulator`,inputDescription:`Include an initial interactive snapshot in a fresh open response. With no app argument, discover the sole running app on the sole booted iOS simulator; ambiguous environments fail closed.`,projectConfig:!1,recorded:!1},{key:`restart`,names:[`--restart`],type:`boolean`,usageLabel:`--restart`,usageDescription:`logs clear: stop active stream, clear logs, then start streaming again`,projectConfig:!0,recorded:!1},{key:`retainPaths`,names:[`--retain-paths`],type:`boolean`,usageLabel:`--retain-paths`,usageDescription:`install-from-source: keep materialized artifact paths after install`,projectConfig:!0,recorded:!1},{key:`retentionMs`,names:[`--retention-ms`],type:`int`,min:1,max:2147483647,usageLabel:`--retention-ms <ms>`,usageDescription:`install-from-source: retain files for 1-2147483647 ms`,inputDescription:`When retainPaths is true, keep downloaded and extracted files for this many milliseconds.`,projectConfig:!0,recorded:!1},{key:`noRecord`,names:[`--no-record`],type:`boolean`,usageLabel:`--no-record`,usageDescription:`Do not record this action`,projectConfig:!0,recorded:!0},{key:`record`,names:[`--record`],type:`boolean`,usageLabel:`--record`,usageHidden:!0,usageDescription:`Force-record this action into a repair-armed heal; per-invocation only, the retired config key "record" no longer opts in (mutually exclusive with --no-record)`,projectConfig:!1,recorded:!0}],d=[{key:`config`,names:[`--config`],type:`string`,usageLabel:`--config <path>`,usageDescription:`Load CLI defaults from a specific config file (required for connection/provider defaults outside user config)`,projectConfig:!1,recorded:!1},{key:`remoteConfig`,names:[`--remote-config`],type:`string`,usageLabel:`--remote-config <path>`,usageDescription:`Load remote host + Metro workflow settings from a specific profile file`,projectConfig:!1,recorded:!1},{key:`stateDir`,names:[`--state-dir`],type:`string`,usageLabel:`--state-dir <path>`,usageDescription:`Daemon state directory (defaults to ~/.agent-device for packages, or a worktree-scoped dev dir from source)`,projectConfig:!1,recorded:!1},{key:`daemonBaseUrl`,names:[`--daemon-base-url`],type:`string`,usageLabel:`--daemon-base-url <url>`,usageDescription:`Explicit remote HTTP daemon base URL (skip local daemon discovery/startup)`,projectConfig:!1,recorded:!1},{key:`daemonAuthToken`,names:[`--daemon-auth-token`],type:`string`,usageLabel:`--daemon-auth-token <token>`,usageDescription:`Remote HTTP daemon or proxy auth token (sent as request token and bearer header)`,projectConfig:!1,recorded:!1},{key:`daemonTransport`,names:[`--daemon-transport`],type:`enum`,enumValues:[`auto`,`socket`,`http`],usageLabel:`--daemon-transport auto|socket|http`,usageDescription:`Daemon client transport preference`,projectConfig:!1,recorded:!1},{key:`daemonServerMode`,names:[`--daemon-server-mode`],type:`enum`,enumValues:[`socket`,`http`,`dual`],usageLabel:`--daemon-server-mode socket|http|dual`,usageDescription:`Daemon server mode used when spawning daemon`,projectConfig:!1,recorded:!1},{key:`proxyHost`,names:[`--host`],type:`string`,usageLabel:`--host <host>`,usageDescription:`Proxy: host interface to bind (default: 127.0.0.1)`,projectConfig:!1,recorded:!1},{key:`proxyPort`,names:[`--port`],type:`int`,min:1,max:65535,usageLabel:`--port <port>`,usageDescription:`Proxy: TCP port to bind (default: 0, choose a free port)`,projectConfig:!1,recorded:!1},{key:`publicOrigin`,names:[`--public-origin`],type:`string`,usageLabel:`--public-origin <origin>`,usageDescription:`Proxy: public HTTP(S) origin for upload tickets`,projectConfig:!1,recorded:!1},{key:`mcpStructured`,names:[`--structured`],type:`boolean`,usageLabel:`--structured`,usageDescription:`MCP: advertise tool output schemas and return structuredContent; results are text only by default`,projectConfig:!1,recorded:!1},{key:`tenant`,names:[`--tenant`],type:`string`,usageLabel:`--tenant <id>`,usageDescription:`Tenant scope identifier for isolated daemon sessions`,projectConfig:!1,recorded:!1},{key:`sessionIsolation`,names:[`--session-isolation`],type:`enum`,enumValues:[`none`,`tenant`],usageLabel:`--session-isolation none|tenant`,usageDescription:`Session isolation strategy (tenant prefixes session namespace)`,projectConfig:!1,recorded:!1},{key:`runId`,names:[`--run-id`],type:`string`,usageLabel:`--run-id <id>`,usageDescription:`Run identifier used for tenant lease admission checks`,projectConfig:!1,recorded:!1},{key:`leaseId`,names:[`--lease-id`],type:`string`,usageLabel:`--lease-id <id>`,usageDescription:`Lease identifier bound to tenant/run admission scope`,projectConfig:!1,recorded:!1},{key:`leaseBackend`,names:[`--lease-backend`],type:`enum`,enumValues:t,usageLabel:`--lease-backend ${t.join(`|`)}`,usageDescription:`Lease backend for remote tenant connection admission`,projectConfig:!1,recorded:!1},{key:`provider`,names:[`--provider`],type:`string`,usageLabel:`--provider <name>`,usageDescription:`Cloud provider name for provider-scoped commands`,projectConfig:!1,recorded:!1},{key:`providerSessionId`,names:[`--provider-session`],type:`string`,usageLabel:`--provider-session <id>`,usageDescription:`Cloud provider session id or ARN`,projectConfig:!1,recorded:!1},{key:`providerApp`,names:[`--provider-app`],type:`string`,usageLabel:`--provider-app <ref-or-path>`,usageDescription:`Cloud provider app reference or local app path used when creating hosted WebDriver sessions`,projectConfig:!1,recorded:!1},{key:`providerOsVersion`,names:[`--provider-os-version`,`--os-version`],type:`string`,usageLabel:`--provider-os-version <version>`,usageDescription:`Hosted cloud provider OS version, for example 17 or 14.0`,projectConfig:!1,recorded:!1},{key:`providerDeviceType`,names:[`--provider-device-type`],type:`enum`,enumValues:s,usageLabel:`--provider-device-type real|virtual`,usageDescription:`TestMu AI device pool: real devices or virtual devices (emulators and simulators). Defaults to virtual`,projectConfig:!1,recorded:!1},{key:`providerProject`,names:[`--provider-project`],type:`string`,usageLabel:`--provider-project <name>`,usageDescription:`Hosted cloud provider project label`,projectConfig:!1,recorded:!1},{key:`providerBuild`,names:[`--provider-build`],type:`string`,usageLabel:`--provider-build <name>`,usageDescription:`Hosted cloud provider build label`,projectConfig:!1,recorded:!1},{key:`providerSessionName`,names:[`--provider-session-name`],type:`string`,usageLabel:`--provider-session-name <name>`,usageDescription:`Hosted cloud provider session label`,projectConfig:!1,recorded:!1},{key:`providerDeviceOrientation`,names:[`--provider-device-orientation`,`--device-orientation`],type:`enum`,enumValues:o,usageLabel:`--provider-device-orientation portrait|landscape`,usageDescription:`Screen orientation a hosted cloud provider session starts in. Set this rather than rotating after launch: a session that boots landscape renders login webviews landscape`,projectConfig:!1,recorded:!1},{key:`providerGeoLocation`,names:[`--provider-geo-location`,`--geo-location`],type:`string`,usageLabel:`--provider-geo-location <country>`,usageDescription:`Hosted cloud provider IP geolocation country code, for example US`,projectConfig:!1,recorded:!1},{key:`providerTimezone`,names:[`--provider-timezone`,`--timezone`],type:`string`,usageLabel:`--provider-timezone <zone>`,usageDescription:`Hosted cloud provider device time zone, for example New_York`,projectConfig:!1,recorded:!1},{key:`providerAppiumVersion`,names:[`--provider-appium-version`,`--appium-version`],type:`string`,usageLabel:`--provider-appium-version <version>`,usageDescription:`Hosted cloud provider Appium server version, for example 3.2.0. Without it each provider starts its own default (Appium 1.x on BrowserStack)`,projectConfig:!1,recorded:!1},{key:`providerLanguage`,names:[`--provider-language`,`--language`],type:`string`,usageLabel:`--provider-language <language>`,usageDescription:`Hosted cloud provider app language, for example Fr`,projectConfig:!1,recorded:!1},{key:`providerLocale`,names:[`--provider-locale`,`--locale`],type:`string`,usageLabel:`--provider-locale <locale>`,usageDescription:`Hosted cloud provider device locale, for example Fr`,projectConfig:!1,recorded:!1},{key:`providerNetworkProfile`,names:[`--provider-network-profile`,`--network-profile`],type:`string`,usageLabel:`--provider-network-profile <profile>`,usageDescription:`Hosted cloud provider named network condition profile, for example 4g-lte-advanced-good. Mutually exclusive with --provider-custom-network`,projectConfig:!1,recorded:!1},{key:`providerCustomNetwork`,names:[`--provider-custom-network`,`--custom-network`],type:`string`,usageLabel:`--provider-custom-network <shape>`,usageDescription:`Hosted cloud provider custom network shape. Mutually exclusive with --provider-network-profile`,projectConfig:!1,recorded:!1},{key:`providerNoResignApp`,names:[`--provider-no-resign-app`],type:`boolean`,usageLabel:`--provider-no-resign-app`,usageDescription:`iOS only: keep an Enterprise-signed app as uploaded instead of letting the provider re-sign it, which strips entitlements such as push notifications`,projectConfig:!1,recorded:!1},{key:`providerNetworkLogs`,names:[`--provider-network-logs`],type:`boolean`,usageLabel:`--provider-network-logs`,usageDescription:`Limrun: capture session network traffic; artifacts and close write it as a HAR file on the daemon host and print its path and any capture failures. Pass --provider-network-hosts with your app API hosts. Captured traffic exits through the daemon host, the HAR holds raw headers and bodies, certificate-pinned hosts and HTTPS hosts without HTTP/2 fail to connect, and DNS-over-HTTPS bypasses the capture`,projectConfig:!1,recorded:!1},{key:`providerNetworkHosts`,names:[`--provider-network-hosts`],type:`string`,usageLabel:`--provider-network-hosts <list>`,usageDescription:`With --provider-network-logs: comma-separated hosts to capture, such as your app API hosts (exact hosts, wildcards like *.example.com, or localhost:<port> routes). Replaces the noisy default of common public domains plus localhost:8081`,projectConfig:!1,recorded:!1},{key:`awsProjectArn`,names:[`--aws-project-arn`],type:`string`,usageLabel:`--aws-project-arn <arn>`,usageDescription:`AWS Device Farm project ARN for hosted WebDriver sessions`,projectConfig:!1,recorded:!1},{key:`awsDeviceArn`,names:[`--aws-device-arn`],type:`string`,usageLabel:`--aws-device-arn <arn>`,usageDescription:`AWS Device Farm device ARN for hosted WebDriver sessions`,projectConfig:!1,recorded:!1},{key:`awsAppArn`,names:[`--aws-app-arn`],type:`string`,usageLabel:`--aws-app-arn <arn>`,usageDescription:`AWS Device Farm app ARN attached to hosted remote access sessions`,projectConfig:!1,recorded:!1},{key:`awsRegion`,names:[`--aws-region`],type:`string`,usageLabel:`--aws-region <region>`,usageDescription:`AWS region for Device Farm API calls`,projectConfig:!1,recorded:!1},{key:`awsInteractionMode`,names:[`--aws-interaction-mode`],type:`enum`,enumValues:[`INTERACTIVE`,`NO_VIDEO`,`VIDEO_ONLY`],usageLabel:`--aws-interaction-mode INTERACTIVE|NO_VIDEO|VIDEO_ONLY`,usageDescription:`AWS Device Farm remote access interaction mode`,projectConfig:!1,recorded:!1},{key:`force`,names:[`--force`,`--overwrite`],type:`boolean`,usageLabel:`--force, --overwrite`,usageDescription:`Force replacement of existing state (connect: replace an active connection; --save-script: overwrite an existing target instead of refusing)`,projectConfig:!0,recorded:!0},{key:`clean`,names:[`--clean`],type:`boolean`,usageLabel:`--clean`,usageDescription:`Daemon stop: remove retained runner processes and leases after stopping`,projectConfig:!0,recorded:!1},{key:`noLogin`,names:[`--no-login`],type:`boolean`,usageLabel:`--no-login`,usageDescription:`Connect: fail instead of starting implicit cloud login`,projectConfig:!0,recorded:!1},{key:`sessionLock`,names:[`--session-lock`],type:`enum`,enumValues:[`reject`,`strip`],usageLabel:`--session-lock reject|strip`,usageDescription:`Lock bound-session device routing for this CLI invocation and nested batch steps; strip drops conflicting platform/scope selectors only, and a selector naming a different device always fails`,projectConfig:!0,recorded:!1}],f=[{key:`platform`,names:[`--platform`],type:`enum`,enumValues:r,usageLabel:`--platform ${r.join(`|`)}`,usageDescription:"Platform to target (`apple` aliases the Apple automation backend)",projectConfig:!0,recorded:!0},{key:`target`,names:[`--target`],type:`enum`,enumValues:[`mobile`,`tv`,`desktop`],usageLabel:`--target mobile|tv|desktop`,usageDescription:`Device target class to match`,projectConfig:!0,recorded:!1},{key:`device`,names:[`--device`],type:`string`,usageLabel:`--device <name>`,usageDescription:`Device name to target (a UDID belongs in --udid, a serial in --serial)`,projectConfig:!0,recorded:!0},{key:`udid`,names:[`--udid`],type:`string`,usageLabel:`--udid <udid>`,usageDescription:`Apple device or simulator UDID; the only selector that pins one device when several share a --device name`,projectConfig:!0,recorded:!0},{key:`serial`,names:[`--serial`],type:`string`,usageLabel:`--serial <serial>`,usageDescription:`Android, HarmonyOS, or Vega VVD serial`,projectConfig:!0,recorded:!0},{key:`osVersion`,names:[`--os`],type:`string`,usageLabel:`--os <version|range>`,usageDescription:`Proxy lease: OS version or range the backend picks the device by (Android: API level); refused without such a backend`,inputDescription:`Proxy lease: OS version or range, for example 18.6.2 or ">=26" (Android: API level). Honored only by a proxy backend that leases by spec; other daemons refuse it.`,projectConfig:!1,recorded:!1},{key:`imageTag`,names:[`--image-tag`],type:`string`,usageLabel:`--image-tag <tag>`,usageDescription:`Proxy lease: Android system image tag the backend picks the device by; refused without such a backend`,inputDescription:`Proxy lease: Android system image tag, for example google_apis_playstore. Honored only by a proxy backend that leases by spec; other daemons refuse it.`,projectConfig:!1,recorded:!1},{key:`deviceMode`,names:[`--device-mode`],type:`string`,usageLabel:`--device-mode <slim|full>`,usageDescription:`Proxy lease: iOS simulator mode (slim or full) the backend leases; refused without such a backend`,inputDescription:`Proxy lease: iOS simulator mode, slim or full. Honored only by a proxy backend that leases by spec; other daemons refuse it.`,projectConfig:!1,recorded:!1},{key:`deviceBaseline`,names:[`--device-baseline`],type:`string`,usageLabel:`--device-baseline <name>`,usageDescription:`Proxy lease: saved device state (baseline) the backend restores on the leased device; refused without such a backend`,inputDescription:`Proxy lease: saved device state (baseline) to restore on the leased device. Honored only by a proxy backend that leases by spec; other daemons refuse it.`,projectConfig:!1,recorded:!1},{key:`physical`,names:[`--physical`],type:`boolean`,usageLabel:`--physical`,usageDescription:`Proxy lease: ask the backend for a physical device instead of a simulator or emulator; refused without such a backend`,inputDescription:`Proxy lease: true requests a physical device; false selects nothing. Honored only by a proxy backend that leases by spec; other daemons refuse it.`,projectConfig:!1,recorded:!1},{key:`stale`,names:[`--stale`],type:`boolean`,usageLabel:`--stale`,usageDescription:`Device status: show only claims with a provably stale owner`,projectConfig:!0,recorded:!1},{key:`surface`,names:[`--surface`],type:`enum`,enumValues:c,usageLabel:`--surface app|frontmost-app|desktop|menubar`,usageDescription:`macOS session surface for open (defaults to app)`,projectConfig:!0,recorded:!0},{key:`headless`,names:[`--headless`],type:`boolean`,usageLabel:`--headless`,usageDescription:`Boot: launch Android emulator without a GUI window`,projectConfig:!0,recorded:!1},{key:`pick`,names:[`--pick`],type:`enum`,enumValues:i,usageLabel:`--pick ${i.join(`|`)}`,usageDescription:`Boot: when several equally preferred matches are all shut down, boot one (mobile over TV, newest OS, then name) instead of failing; booted ties still fail`,projectConfig:!1,recorded:!1},{key:`targetApp`,names:[`--app`,`--target-app`],type:`string`,usageLabel:`--app <id-or-name>`,usageDescription:`Target an app without opening it: doctor verifies an installed app by id or name; settings applies an app-scoped change (permission, iOS location) to a bundle id or package`,projectConfig:!1,recorded:!1},{key:`metroHost`,names:[`--metro-host`],type:`string`,usageLabel:`--metro-host <host>`,usageDescription:`Session-scoped Metro/debug host hint`,projectConfig:!1,recorded:!0},{key:`metroPort`,names:[`--metro-port`],type:`int`,min:1,max:65535,usageLabel:`--metro-port <port>`,usageDescription:`Session-scoped Metro/debug port hint; on an emulator/simulator the host defaults to the loopback alias, physical devices still need --metro-host`,projectConfig:!1,recorded:!0},{key:`metroProjectRoot`,names:[`--project-root`],type:`string`,usageLabel:`--project-root <path>`,usageDescription:`metro prepare: React Native project root (default: cwd)`,projectConfig:!1,recorded:!1},{key:`kind`,names:[`--kind`],type:`enum`,enumValues:[`auto`,`react-native`,`expo`,`repack`,...l],usageLabel:`--kind <kind>`,usageDescription:`Kind selector for commands that support it, such as metro prepare or perf artifact collectors`,projectConfig:!0,recorded:!1},{key:`perfTemplate`,names:[`--template`],type:`string`,usageLabel:`--template <name>`,usageDescription:`Perf xctrace template name, for example Time Profiler`,projectConfig:!0,recorded:!1},{key:`metroKind`,names:[`--metro-kind`],type:`enum`,enumValues:[`auto`,`react-native`,`expo`,`repack`],usageLabel:`--metro-kind auto|react-native|expo|repack`,usageDescription:`metro prepare: detect or force the React Native dev-server launcher kind`,projectConfig:!1,recorded:!1},{key:`metroPublicBaseUrl`,names:[`--public-base-url`],type:`string`,usageLabel:`--public-base-url <url>`,usageDescription:`metro prepare: public base URL used for direct dev-server bundle hints`,projectConfig:!1,recorded:!1},{key:`metroProxyBaseUrl`,names:[`--proxy-base-url`],type:`string`,usageLabel:`--proxy-base-url <url>`,usageDescription:`metro prepare: optional bridge origin for remote dev-server access`,projectConfig:!1,recorded:!1},{key:`metroBearerToken`,names:[`--bearer-token`],type:`string`,usageLabel:`--bearer-token <token>`,usageDescription:`metro prepare: host bridge bearer token (or AGENT_DEVICE_METRO_BEARER_TOKEN; falls back to AGENT_DEVICE_DAEMON_AUTH_TOKEN)`,projectConfig:!1,recorded:!1},{key:`metroPreparePort`,names:[`--port`],type:`int`,min:1,max:65535,usageLabel:`--port <port>`,usageDescription:`metro prepare: local dev-server port (default: 8081)`,projectConfig:!1,recorded:!1},{key:`metroListenHost`,names:[`--listen-host`],type:`string`,usageLabel:`--listen-host <host>`,usageDescription:`metro prepare: host dev server listens on (default: 0.0.0.0)`,projectConfig:!1,recorded:!1},{key:`metroStatusHost`,names:[`--status-host`],type:`string`,usageLabel:`--status-host <host>`,usageDescription:`metro prepare: host used for local dev-server /status polling (default: 127.0.0.1)`,projectConfig:!1,recorded:!1},{key:`metroStartupTimeoutMs`,names:[`--startup-timeout-ms`],type:`int`,min:1,usageLabel:`--startup-timeout-ms <ms>`,usageDescription:`metro prepare: timeout while waiting for the dev server to become ready`,projectConfig:!1,recorded:!1},{key:`metroProbeTimeoutMs`,names:[`--probe-timeout-ms`],type:`int`,min:1,usageLabel:`--probe-timeout-ms <ms>`,usageDescription:`metro prepare: timeout for /status and proxy bridge calls`,projectConfig:!1,recorded:!1},{key:`metroRuntimeFile`,names:[`--runtime-file`],type:`string`,usageLabel:`--runtime-file <path>`,usageDescription:`metro prepare: optional file path to persist the JSON result`,projectConfig:!1,recorded:!1},{key:`metroNoReuseExisting`,names:[`--no-reuse-existing`],type:`boolean`,usageLabel:`--no-reuse-existing`,usageDescription:`metro prepare: always start a fresh Metro process`,projectConfig:!1,recorded:!1},{key:`metroNoInstallDeps`,names:[`--no-install-deps`],type:`boolean`,usageLabel:`--no-install-deps`,usageDescription:`metro prepare: skip package-manager install when node_modules is missing`,projectConfig:!1,recorded:!1},{key:`bundleUrl`,names:[`--bundle-url`],type:`string`,usageLabel:`--bundle-url <url>`,usageDescription:`Session-scoped bundle URL hint`,projectConfig:!1,recorded:!0},{key:`launchUrl`,names:[`--launch-url`],type:`string`,usageLabel:`--launch-url <url>`,usageDescription:`Session-scoped deep link / launch URL hint`,projectConfig:!0,recorded:!0},{key:`iosSimulatorDeviceSet`,names:[`--ios-simulator-device-set`],type:`string`,usageLabel:`--ios-simulator-device-set <path>`,usageDescription:`Scope iOS simulator discovery/commands to this simulator device set`,projectConfig:!1,recorded:!1},{key:`iosXctestrunFile`,names:[`--ios-xctestrun-file`],type:`string`,usageLabel:`--ios-xctestrun-file <path>`,usageDescription:`Use an externally built iOS XCTest runner .xctestrun artifact`,projectConfig:!1,recorded:!1},{key:`iosXctestDerivedDataPath`,names:[`--ios-xctest-derived-data-path`],type:`string`,usageLabel:`--ios-xctest-derived-data-path <path>`,usageDescription:`Derived data path for external iOS XCTest runner execution`,projectConfig:!1,recorded:!1},{key:`iosXctestEnvDir`,names:[`--ios-xctest-env-dir`],type:`string`,usageLabel:`--ios-xctest-env-dir <path>`,usageDescription:`Writable directory for per-session iOS XCTest runner env overlays`,projectConfig:!1,recorded:!1},{key:`testIme`,names:[`--test-ime`],type:`boolean`,usageLabel:`--test-ime`,usageDescription:`open/test/replay: activate the headless Android test IME for deterministic Unicode text entry (default on for emulators; opt-in on real devices; on test/replay it applies to the sessions the flow opens)`,projectConfig:!0,recorded:!1},{key:`testIme`,names:[`--no-test-ime`],type:`boolean`,setValue:!1,usageLabel:`--no-test-ime`,usageDescription:`open/test/replay: keep the real Android keyboard even on emulators (opt out of the headless test IME; on test/replay it applies to the sessions the flow opens)`,projectConfig:!0,recorded:!1},{key:`androidDeviceAllowlist`,names:[`--android-device-allowlist`],type:`string`,usageLabel:`--android-device-allowlist <serials>`,usageDescription:`Comma/space separated Android serial allowlist for discovery/selection`,projectConfig:!1,recorded:!1},{key:`remote`,names:[`--remote`],type:`boolean`,usageLabel:`--remote`,usageDescription:`Doctor: check remote connection setup instead of local device inventory`,projectConfig:!0,recorded:!1},{key:`activity`,names:[`--activity`],type:`string`,usageLabel:`--activity <component>`,usageDescription:`Android launch activity (package/Class, .Class, or Class) or HarmonyOS ability name; not for URL opens`,projectConfig:!0,recorded:!1},{key:`launchConsole`,names:[`--launch-console`],type:`string`,usageLabel:`--launch-console <path>`,usageDescription:`open: capture the initial local or Limrun iOS simulator launch console window to a file`,projectConfig:!1,recorded:!1},{key:`launchArgs`,names:[`--launch-args`],type:`string`,multiple:!0,usageLabel:`--launch-args <arg>`,usageDescription:`open: repeatable launch argument forwarded verbatim to the platform launch command (iOS app process args; Android adb shell am start args). Linux and macOS reject the flag.`,projectConfig:!0,recorded:!1},{key:`header`,names:[`--header`],type:`string`,multiple:!0,usageLabel:`--header <name:value>`,usageDescription:`install-from-source: repeatable HTTP header for URL downloads`,projectConfig:!1,recorded:!1},{key:`githubActionsArtifact`,names:[`--github-actions-artifact`],type:`string`,usageLabel:`--github-actions-artifact <owner/repo:artifact>`,usageDescription:`install-from-source: GitHub Actions artifact resolved by a remote daemon`,projectConfig:!1,recorded:!1},{key:`installSource`,names:[],type:`string`,projectConfig:!1,recorded:!1},{key:`session`,names:[`--session`],type:`string`,usageLabel:`--session <name>`,usageDescription:`Named session (implicit default is scoped to this workspace + platform)`,projectConfig:!0,recorded:!1}],p=[{key:`replayUpdate`,names:[`--update`,`-u`],type:`boolean`,usageLabel:`--update, -u`,usageDescription:`Replay: retired as a rewrite (ADR 0012) — never edits the .ad file; every divergence already carries ranked selector suggestions, --update or not`,projectConfig:!0,recorded:!1},{key:`replayFrom`,names:[`--from`],type:`int`,min:1,usageLabel:`--from <n>`,usageDescription:`Replay: resume at 1-based plan step n, skipping 1..n-1 without executing them (requires --plan-digest; see a divergence report's resume field). replay only, not test`,projectConfig:!0,recorded:!1},{key:`replayPlanDigest`,names:[`--plan-digest`],type:`string`,usageLabel:`--plan-digest <sha256>`,usageDescription:`Replay: the plan digest a --from resume must match (from a prior divergence report); mismatch, edits, or include/platform-expansion changes fail INVALID_ARGS before any action`,projectConfig:!0,recorded:!1},{key:`replayKeepSession`,names:[`--keep-session`],type:`boolean`,usageLabel:`--keep-session`,usageDescription:`Replay: leave the session active by suppressing exactly an authored terminal close in a native .ad script; replay only, not test or Maestro YAML`,projectConfig:!0,recorded:!1},{key:`replayMaestro`,names:[`--maestro`],type:`boolean`,usageLabel:`--maestro`,usageDescription:`Replay: treat input as a supported Maestro YAML subset; unsupported syntax fails loudly. See agent-device help maestro for commands and boundaries`,projectConfig:!0,recorded:!1},{key:`replayEnv`,names:[`-e`,`--env`],type:`string`,multiple:!0,usageLabel:`-e KEY=VALUE, --env KEY=VALUE`,usageDescription:"Replay/Test: inject or override a ${KEY} variable for the script (repeatable)",projectConfig:!1,recorded:!1},{key:`failFast`,names:[`--fail-fast`],type:`boolean`,usageLabel:`--fail-fast`,usageDescription:`Test: stop the suite after the first failing script; with sharding, each shard stops independently`,projectConfig:!0,recorded:!1},{key:`timeoutMs`,names:[`--timeout`],type:`int`,min:1,usageLabel:`--timeout <ms>`,usageDescription:`Boot/Open/Prepare: startup budget covering the device boot (and runner preparation for prepare). Replay/Snapshot/Test: maximum wall-clock time for the command or attempt. With --settle: the settle-wait deadline (default 10s)`,projectConfig:!0,recorded:!1},{key:`waitMs`,names:[`--wait`],type:`int`,min:100,max:12e4,usageLabel:`--wait <ms>`,usageDescription:`Open: wait up to n ms for a device another session is holding before failing with DEVICE_IN_USE`,inputDescription:`Wait up to n milliseconds (100-120000) while another session holds the device, then fail with DEVICE_IN_USE. A claim held by another workspace fails at once. The wait extends this command's timeout.`,projectConfig:!1,recorded:!1},{key:`retries`,names:[`--retries`],type:`int`,min:0,max:3,usageLabel:`--retries <n>`,usageDescription:`Test: retry each failed script up to n additional times`,projectConfig:!0,recorded:!1},{key:`recordVideo`,names:[`--record-video`],type:`boolean`,usageLabel:`--record-video`,usageDescription:`Test: record each replay attempt to recording.mp4 in its attempt artifacts`,projectConfig:!0,recorded:!1},{key:`artifactsDir`,names:[`--artifacts-dir`],type:`string`,usageLabel:`--artifacts-dir <path>`,usageDescription:`Test: root directory for suite artifacts`,projectConfig:!1,recorded:!1},{key:`reporter`,names:[`--reporter`],type:`string`,multiple:!0,usageLabel:`--reporter <name-or-path>`,usageDescription:`Test: add a replay suite reporter; use default, junit:<path>, or a custom reporter path (repeatable)`,projectConfig:!1,recorded:!1},{key:`reportJunit`,names:[`--report-junit`],type:`string`,usageLabel:`--report-junit <path>`,usageDescription:`Test: compatibility alias for --reporter junit:<path>`,projectConfig:!1,recorded:!1},{key:`shardAll`,names:[`--shard-all`],type:`int`,min:1,usageLabel:`--shard-all <n>`,usageDescription:`Test: run the full suite on each of n devices; combine with --device id1,id2 for explicit connected devices; AD_SHARD_INDEX is zero-based`,projectConfig:!0,recorded:!1},{key:`shardSplit`,names:[`--shard-split`],type:`int`,min:1,usageLabel:`--shard-split <n>`,usageDescription:`Test: split runnable suite entries across n devices; AD_SHARD_INDEX is zero-based`,projectConfig:!0,recorded:!1},{key:`steps`,names:[`--steps`],type:`string`,usageLabel:`--steps <json>`,usageDescription:`Batch: JSON array of {"command","input"} steps`,projectConfig:!1,recorded:!1},{key:`stepsFile`,names:[`--steps-file`],type:`string`,usageLabel:`--steps-file <path>`,usageDescription:`Batch: read steps JSON from file`,projectConfig:!1,recorded:!1},{key:`batchOnError`,names:[`--on-error`],type:`enum`,enumValues:[`stop`],usageLabel:`--on-error stop`,usageDescription:`Batch: stop when a step fails`,projectConfig:!0,recorded:!1},{key:`batchMaxSteps`,names:[`--max-steps`],type:`int`,min:1,max:1e3,usageLabel:`--max-steps <n>`,usageDescription:`Batch: maximum number of allowed steps`,projectConfig:!0,recorded:!1},{key:`appsFilter`,names:[`--all`],type:`enum`,enumValues:[`user-installed`,`all`],setValue:`all`,usageLabel:`--all`,usageDescription:`Apps: include system/OEM apps`,projectConfig:!0,recorded:!1},{key:`snapshotInteractiveOnly`,names:[`-i`],type:`boolean`,usageLabel:`-i`,usageDescription:`Snapshot: interactive elements only`,projectConfig:!0,recorded:!0},{key:`snapshotDepth`,names:[`--depth`,`-d`],type:`int`,min:0,usageLabel:`--depth, -d <depth>`,usageDescription:`Snapshot: limit snapshot depth`,projectConfig:!0,recorded:!0},{key:`snapshotScope`,names:[`--scope`,`-s`],type:`string`,usageLabel:`--scope, -s <scope>`,usageDescription:`Snapshot: scope snapshot to label/identifier`,projectConfig:!0,recorded:!0},{key:`snapshotRaw`,names:[`--raw`],type:`boolean`,usageLabel:`--raw`,usageDescription:`Snapshot: raw node output`,projectConfig:!0,recorded:!0},{key:`snapshotCustomActions`,names:[`--actions`],type:`boolean`,usageLabel:`--actions`,usageDescription:`Snapshot: name the affordances merged inside an element (iOS sim); not directly invokable — reach them via the detail screen, labeled children, or coordinates`,inputDescription:`List the custom actions an element merged away, such as a card's reply control. Not invocable: reach the control via its detail screen, a labeled element elsewhere, or its rect. iOS simulator only; costs one accessibility round trip per merged element.`,projectConfig:!0,recorded:!0},{key:`snapshotObserveOnly`,names:[`--observe-only`],type:`boolean`,usageLabel:`--observe-only`,usageDescription:`Snapshot: observe the iOS session app without activation or foreground repair`,inputDescription:`iOS only. Refuse instead of activating or repairing the session app. Reports XCUIApplication state, which does not prove screen ownership (#2696).`,projectConfig:!1,recorded:!1},{key:`snapshotForceFull`,names:[`--force-full`],type:`boolean`,usageLabel:`--force-full`,usageDescription:`Snapshot: re-emit the full tree even when unchanged`,projectConfig:!0,recorded:!1},{key:`findFirst`,names:[`--first`],type:`boolean`,usageLabel:`--first`,usageDescription:`Find: pick the first match when ambiguous`,projectConfig:!0,recorded:!1},{key:`findLast`,names:[`--last`],type:`boolean`,usageLabel:`--last`,usageDescription:`Find: pick the last match when ambiguous`,projectConfig:!0,recorded:!1},{key:`out`,names:[`--out`],type:`string`,usageLabel:`--out <path>`,usageDescription:`Output path`,projectConfig:!1,recorded:!0},{key:`artifact`,names:[`--artifact`],type:`string`,usageLabel:`--artifact <path>`,usageDescription:`Debug symbols: Apple crash artifact path (.ips, .crash, or .log)`,projectConfig:!1,recorded:!1},{key:`dsym`,names:[`--dsym`],type:`string`,usageLabel:`--dsym <path>`,usageDescription:`Debug symbols: matching .dSYM bundle path`,projectConfig:!1,recorded:!1},{key:`searchPath`,names:[`--search-path`],type:`string`,usageLabel:`--search-path <dir>`,usageDescription:`Debug symbols: directory to scan for matching .dSYM bundles`,projectConfig:!1,recorded:!1},{key:`overlayRefs`,names:[`--overlay-refs`],type:`boolean`,usageLabel:`--overlay-refs`,usageDescription:`Screenshot: draw current snapshot refs and target rectangles onto the saved PNG; diff screenshot: also write a separate current-screen overlay guide`,projectConfig:!0,recorded:!1},...n,{key:`baseline`,names:[`--baseline`,`-b`],type:`string`,usageLabel:`--baseline, -b <path>`,usageDescription:`Diff screenshot: path to baseline image file`,projectConfig:!0,recorded:!1},{key:`threshold`,names:[`--threshold`],type:`string`,usageLabel:`--threshold <0-1>`,usageDescription:`Diff screenshot: color distance threshold (default 0.1)`,projectConfig:!0,recorded:!1}],m=[...d,...f,...u,...p],h=new Map;for(let e of m)for(let t of e.names)h.set(t,e);function g(e){return h.get(e)}function _(){return m}function v(e){return m.filter(t=>t.key===e)}function y(){return new Set(m.filter(e=>e.projectConfig).map(e=>e.key))}function b(){return new Set(m.filter(e=>e.recorded).map(e=>e.key))}export{b as a,y as i,_ as n,v as r,g as t};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{Pt as e}from"./sdk-batch.js";import{r as t}from"./success-text.js";import{n}from"./snapshot-runtime-capture-input.js";import{t as r}from"./validation.js";import{i}from"./runtime-admission.js";function a(e){return r(e,`focus requires x y`)}function o(e,t){return{point:e,...t.appBundleId===void 0?{}:{options:{appBundleId:t.appBundleId}},execution:n(t)}}async function s(t){let n=a(t.positionals);return await i({command:`focus`,device:t.device,use:e,inspectFacts:t.inspectFacts,platformServices:t.platformServices,bindDevice:t.bindDevice},(e,t)=>c(e,n,t))}async function c(e,n,r){return await e.operations.focusPoint(o(n,r)),{x:n.x,y:n.y,...t(`Focused (${n.x}, ${n.y})`)}}export{s as n,c as t};
|
package/dist/src/fold-helper.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import{r as e}from"./rolldown-runtime.js";import{
|
|
1
|
+
import{r as e}from"./rolldown-runtime.js";import{_ as t}from"./sdk-contracts.js";import{Q as n,Z as r}from"./sdk-io.js";import"./command.js";import{r as i}from"./version.js";import{f as a}from"./host-file.js";import{u as o}from"./config.js";import{s}from"./tool-provider.js";import{t as c}from"./simctl-execution.js";import{i as l,n as u,t as d}from"./host3.js";import{a as f,i as p,n as m,r as h,t as g}from"./cache.js";import _ from"node:path";const v=`Fold.m`,y=3e4,b=p+y;async function x(e={}){let t=e.host??S(),n=u(b,e.signal);try{let r=e.sourceRoot??_.join(i(),`apple`,`fold-helper`),o=await h(t,r,[v],n),s=await f(t,n),c=e.cacheRoot??_.join(a(),`.agent-device`,`fold-helper`);return await g({host:t,deadline:n,lockDescription:`iOS Simulator fold helper cache`,cacheRoot:c,binaryFilename:`fold-helper`,keyInputs:{schemaVersion:1,sourceHash:o,toolchain:s,compileArgv:C({sourceRoot:``,outputPath:``})},build:e=>w(t,n,r,e)})}catch(e){throw T(e)}}function S(){return d(s)}function C(e){return[`--sdk`,`iphonesimulator`,`clang`,`-mios-simulator-version-min=15.0`,`-fobjc-arc`,`-Wall`,`-Wextra`,`-framework`,`Foundation`,`-framework`,`IOKit`,_.join(e.sourceRoot,v),`-o`,e.outputPath]}async function w(e,t,n,i){let a=await m({host:e,deadline:t,argv:C({sourceRoot:n,outputPath:i}),budgetMs:y,label:`fold helper`});if(a.exitCode!==0||!e.exists(i))throw E(r(a))}function T(e){return!(e instanceof l)||e.buildFailureKind===`cancelled`?e:E({...e.buildDetails,cause:e.buildFailureCode},e)}function E(e,n){return new t(`COMMAND_FAILED`,`Unable to build the simulator fold helper`,{hint:`Select an Xcode with the iOS simulator SDK and foldable HID support using DEVELOPER_DIR.`,...e,reason:`fold-helper-build-failed`},n)}var D=e({HINGE_ANGLE_NO_SAMPLE_REASON:()=>O,createFoldHelper:()=>k,parseHingeReading:()=>F});const O=`fold-hinge-angle-no-sample`;function k(e){let i,a=async(a,o,s)=>{let{signal:l,timeoutMs:u,failure:d}=o;l?.throwIfAborted();let{path:f}=await(i??=x({signal:l}));l?.throwIfAborted();let p;try{p=await c(e,[`spawn`,e.id,f,...a],{signal:l,timeoutMs:u,kill:{signal:`SIGTERM`,graceMs:1e3},allowFailure:!0})}catch(r){throw l?.aborted||!n(r)?r:new t(`COMMAND_FAILED`,d.message,{...r.details,deviceId:e.id,...d.details},r)}let m=p.exitCode===0?s(p.stdout):void 0;if(m!==void 0)return m;throw new t(`COMMAND_FAILED`,d.message,r(p,{deviceId:e.id,...d.details}))};return Object.freeze({async setPose(e,t){let n=typeof e==`string`?0:e.at(-1).atMs,r=typeof e==`string`?e:JSON.stringify(e);await a([`set`,r],{signal:t,timeoutMs:n+1e4,failure:A},()=>!0)},async rotate(e,t){await a([`rotate`,e],{signal:t,timeoutMs:5e3,failure:j},()=>!0)},async readHingeAngle({signal:e,windowMs:t=0}={}){return await a([`hinge`,String(t)],{signal:e,timeoutMs:o+t,failure:M},F)},async readPanelPayload({signal:e,timeoutMs:t}){return await a([`panels`],{signal:e,timeoutMs:t,failure:N},e=>{let t=P(e)?.displays;return Array.isArray(t)?{result:{displays:t}}:void 0})}})}const A={message:`Unable to send the simulator hinge pose`,details:{reason:`fold-hid-dispatch-failed`}},j={message:`Unable to send the simulator orientation`,details:{reason:`orientation-hid-dispatch-failed`}},M={message:`The simulator reported no hinge angle sample`,details:{reason:O,hint:`The fold helper's hinge read returned no valid CoreMotion sample. The details name the cause: stderr such as a simulator runtime without CMAngleManager, or timeoutMs when the read did not finish.`}},N={message:`The simulator reported no panel table`,details:{reason:`fold-helper-panels-unreadable`}};function P(e){let t=e.trim().split(`
|
|
2
2
|
`).at(-1);if(!t)return;let n;try{n=JSON.parse(t)}catch{return}if(typeof n!=`object`||!n)return;let r=n;return r.version===1?r:void 0}function F(e){let t=P(e);if(!t||t.angleValid!==!0)return;let n=t.angleDegrees;if(!(typeof n!=`number`||!Number.isFinite(n)||n<0||n>180))return n}export{k as n,D as r,O as t};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{p as e}from"./sdk-batch.js";import{o as t}from"./snapshot-runtime-capture-input.js";import{t as
|
|
1
|
+
import{p as e}from"./sdk-batch.js";import{o as t,p as n}from"./snapshot-runtime-capture-input.js";import{r,t as i}from"./snapshot-baseline.js";import{i as a,r as o}from"./interaction-ref-policy.js";import{s}from"./runtime-session.js";import{captureSnapshotForSession as c,createInteractionRuntime as l}from"./interaction.js";import{t as u}from"./settle-observation-capture.js";async function d(t){if(!e(t.command))return{};let s=a(t.command,t.flags);if(s)return{response:s};let c=o(t.flags);if(!c)return{};let{presentedSurface:l,...u}=r(n(t.session)),d=await i({frame:u,candidates:[f(t.session.snapshot)]});return{observe:async()=>await p(t,c,d)}}function f(e){let n=r(e);if(!e||!t(e))return n;let{presentedSurface:i,...a}=n;return a}async function p(e,t,n){let r=await m(e);if(!r)return;let i=await r.interactions.settleObservation({...t,baseline:n,session:e.sessionName,requestId:e.req.meta?.requestId});if(e.sessionRef&&!e.sessionStore.resolveCurrent(e.sessionRef))return;let a=s(e.sessionRef,e.sessionStore,i);return a===void 0?i:{...i,refsGeneration:a}}async function m(e){try{let t=await u({command:e.req.command,session:e.session,inspectFacts:e.inspectFacts,platformServices:e.platformServices,bindDevice:e.bindDevice});return await l({createCommandSurface:e.createCommandSurface,req:e.req,sessionName:e.sessionName,sessionRef:e.sessionRef,logPath:e.logPath,sessionStore:e.sessionStore,contextFromFlags:e.contextFromFlags,platformServices:e.platformServices,captureSnapshotForSession:c,settleObservationCapture:t})}catch{return}}export{d as planGenericSettleObservation};
|
package/dist/src/generic.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import{c as e}from"./sdk-contracts.js";import{y as t}from"./sdk-batch-runner.js";import{
|
|
1
|
+
import{c as e}from"./sdk-contracts.js";import{y as t}from"./sdk-batch-runner.js";import{t as n}from"./success-text.js";import{i as r}from"./src3.js";import{n as i}from"./cli-runner.js";import{a,s as o}from"./output-common.js";import{exitAfterFlush as s}from"./process-exit.js";import{n as c,t as l}from"./shared.js";async function u({command:n,positionals:r,flags:a,client:o,host:u,debug:p,replayTestReporterRuntime:m,commandProgress:h,leaseDevice:g}){let{result:_,cliOutput:v}=await i({client:o,command:n,positionals:r,flags:a,commandProgress:h,env:u.env}),y=n===`open`&&v&&g?f(v,g):v;if(e(a.responseLevel)){let e=n===`open`&&g&&t(_)?{..._,lease:{device:g}}:_;return await c(a,e,()=>JSON.stringify(e,null,2)),!0}if(y)await l(a,y);else{let e=await d(n,a,_,{debug:p,replayTestReporterRuntime:m});e!==0&&await s(e)}return!0}async function d(e,t,i,s={}){return e===`test`?import(`./reporting.js`).then(({renderReplayTestResponse:e})=>e({suite:i,debug:s.debug,verbose:t.verbose,json:t.json,reporter:t.reporter,reportJunit:t.reportJunit,reporterRuntime:s.replayTestReporterRuntime})):(await l(t,o({data:i,text:n(i)},i,a(r(e)))),0)}function f(e,n){let r={lease:{device:n}},i=`Leased device: ${[n.model,n.osVersion,n.imageTag,n.physical?`physical`:`virtual`].filter(e=>!!e).join(`, `)}`;return{...e,data:t(e.data)?{...e.data,...r}:e.data,...t(e.jsonData)?{jsonData:{...e.jsonData,...r}}:{},text:e.text?`${e.text}\n${i}`:i}}export{u as runGenericClientBackedCommand};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{
|
|
1
|
+
import{V as e,y as t}from"./sdk-device.js";const n={ios:`iOS`,ipados:`iPadOS`,tvos:`tvOS`,watchos:`watchOS`,visionos:`visionOS`,macos:`macOS`},r=`Target-authored drag requires an adapter that preserves source hold, timed movement, and destination hold; it is supported on Android touch devices and iOS/iPadOS.`,i=`Android TV has no touch input — this gesture is supported on Android phones, tablets, iOS, and iPadOS.`;function a(e,t){return(t===`multi-touch`?o(e):t===`directional-fling`&&e.platform===`linux`?`Linux`:void 0)??e.appleOs??e.platform}function o(r){if(r.platform===`android`)return r.target===`tv`?`Android TV`:void 0;if(!t(r.platform))return;let i=e(r);if(i===`ios`||i===`ipados`||i===`macos`||i===`tvos`||i===`visionos`)return n[i]}function s(e,t,n){return`gesture ${n} is not supported on ${a(e,t)}`}export{s as i,n,r,i as t};
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { F as Rect, M as Point } from "./sdk-contracts.js";
|
|
2
2
|
//#region packages/contracts/src/gesture-plan-types.d.ts
|
|
3
3
|
type GesturePointerCount = 1 | 2;
|
|
4
4
|
/** Selects one-pointer release timing without changing semantic gesture intent. */
|