agent-device 0.21.30 → 0.21.31
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.30.apk → agent-device-android-ime-helper-0.21.31.apk} +0 -0
- package/android/ime-helper/dist/agent-device-android-ime-helper-0.21.31.apk.sha256 +1 -0
- package/android/ime-helper/dist/{agent-device-android-ime-helper-0.21.30.manifest.json → agent-device-android-ime-helper-0.21.31.manifest.json} +4 -4
- package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.31.apk +0 -0
- package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.31.apk.sha256 +1 -0
- package/android/snapshot-helper/dist/{agent-device-android-snapshot-helper-0.21.30.manifest.json → agent-device-android-snapshot-helper-0.21.31.manifest.json} +7 -7
- package/apple/macos-helper/Sources/AgentDeviceMacOSHelper/BackgroundInteraction.swift +20 -6
- package/apple/snapshot-bridge/README.md +16 -3
- package/apple/snapshot-bridge/SnapshotBridgeRuntime.m +33 -1
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunner/AgentDeviceRunnerApp.m +110 -8
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerAppScreenCapture.swift +20 -0
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerSynthesizedGesture.m +4 -4
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+AXSnapshotFallback.swift +1 -1
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+CommandExecution.swift +30 -4
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Interaction.swift +14 -4
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Navigation.swift +81 -41
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SequenceExecution.swift +40 -6
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SnapshotAcquisition.swift +5 -0
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SnapshotCapturePlan.swift +74 -10
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SnapshotTiming.swift +33 -4
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SynthesizedCommitDeadline.swift +2 -2
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SynthesizedGesturePolicy.swift +23 -2
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SynthesizedInteraction.swift +158 -6
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TextEntry.swift +165 -70
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TextEntryConfirmation.swift +2 -3
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TextEntryFocus.swift +49 -27
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TextEntryReadiness.swift +17 -9
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TextInputProbe.swift +30 -28
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TextTyping.swift +87 -87
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests.swift +4 -3
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerXCTestEventBridge.h +13 -0
- package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerXCTestEventBridge.m +45 -0
- package/dist/src/absence-observation-errors.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/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/agent-device-client.js +1 -1
- package/dist/src/alert-tree-driver.js +1 -1
- package/dist/src/alert.js +1 -1
- package/dist/src/alert2.js +1 -1
- package/dist/src/android.js +1 -1
- package/dist/src/app-backend.js +1 -1
- package/dist/src/app-launch.js +1 -1
- package/dist/src/app-lifecycle.js +4 -4
- package/dist/src/app-log-runtime2.js +3 -3
- package/dist/src/app-log-session-resource.js +1 -1
- package/dist/src/app-resolution-facade.js +1 -1
- package/dist/src/app-resolution.js +2 -2
- package/dist/src/apple-runner-platform.js +1 -1
- package/dist/src/application-lifecycle-interaction.js +1 -1
- package/dist/src/artifact-tracking.js +1 -1
- package/dist/src/automation-helper-artifact.js +1 -1
- package/dist/src/automation-helper.js +1 -1
- package/dist/src/back-mode.js +1 -1
- package/dist/src/boot-diagnostics.js +1 -1
- package/dist/src/browser-launch.js +1 -1
- package/dist/src/cli-config.js +1 -1
- package/dist/src/cli-help.js +35 -29
- package/dist/src/cli-runner.js +1 -1
- package/dist/src/cli.js +3 -3
- package/dist/src/client-metro-companion.js +1 -1
- package/dist/src/client-metro.js +1 -1
- package/dist/src/client-types.d.ts +3 -3
- package/dist/src/cloud-artifacts.d.ts +5 -4
- package/dist/src/code-signature-cache.js +1 -1
- package/dist/src/command-metadata.js +10 -10
- package/dist/src/command-tools.js +2 -2
- package/dist/src/command.js +1 -1
- package/dist/src/composed-inventory-gateways.js +1 -1
- package/dist/src/connection-runtime.js +1 -1
- package/dist/src/connection.js +5 -5
- package/dist/src/contracts.js +1 -1
- package/dist/src/daemon-client-ensure.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.js +1 -1
- package/dist/src/daemon-command-registry.js +1 -1
- package/dist/src/daemon-composition.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-resolution.js +1 -1
- package/dist/src/daemon-startup-diagnostics.js +1 -1
- package/dist/src/debug-symbols-facade.js +3 -3
- package/dist/src/device-claim-recovery.js +1 -1
- package/dist/src/device-claims.js +1 -1
- package/dist/src/device-inventory-context.js +1 -1
- package/dist/src/device-readiness-runtime.js +1 -1
- package/dist/src/device-selection-resolver.js +1 -1
- package/dist/src/device.js +1 -1
- package/dist/src/devicectl.js +1 -1
- package/dist/src/diagnostics.js +1 -1
- package/dist/src/display-inventory.js +1 -1
- package/dist/src/doctor-facade.js +1 -1
- package/dist/src/durable-capture-resource.js +1 -1
- package/dist/src/durable-resource.js +1 -1
- package/dist/src/engine-eval-script.js +1 -1
- package/dist/src/error.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/file.js +1 -1
- package/dist/src/find.js +1 -1
- package/dist/src/finders.js +1 -1
- package/dist/src/gesture-admission.js +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.js +2 -2
- 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 -0
- package/dist/src/human-control.js +1 -1
- package/dist/src/ime-rebind.js +1 -1
- package/dist/src/ime-state.js +1 -1
- 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-source-network-transport.js +1 -1
- package/dist/src/install-source2.js +1 -1
- package/dist/src/interaction-positionals.js +1 -1
- package/dist/src/interaction.js +1 -1
- package/dist/src/interaction2.js +1 -1
- package/dist/src/interactor-operation-catalog.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/daemon.js +1 -1
- package/dist/src/internal/png-worker.js +1 -1
- package/dist/src/inventory.js +1 -1
- package/dist/src/inventory2.js +1 -1
- package/dist/src/inventory6.js +1 -1
- package/dist/src/ios-node-interpretation.js +1 -1
- package/dist/src/ios-settings.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/keyboard-occlusion.js +1 -1
- package/dist/src/keyed-lock.js +1 -1
- package/dist/src/launch-confirmation.js +1 -1
- package/dist/src/launch-services-registration.js +4 -4
- package/dist/src/lease.js +1 -1
- package/dist/src/legacy.js +1 -1
- package/dist/src/limrun-runtime-dependencies.js +1 -1
- package/dist/src/local-interactor-operation-set.js +1 -1
- package/dist/src/mechanics.js +12 -12
- package/dist/src/mobile-snapshot-semantics.js +1 -1
- package/dist/src/observability.js +1 -1
- package/dist/src/output-path.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-target.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-claim-recovery.js +1 -1
- package/dist/src/platform-runtime-daemon-services.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 +5 -5
- package/dist/src/platform-runtime-runtime-hints.js +2 -2
- 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-unavailable.js +1 -1
- package/dist/src/platform-runtime.js +1 -1
- package/dist/src/platform-runtime2.js +1 -1
- package/dist/src/png-resize.js +1 -1
- package/dist/src/png-worker-client.js +1 -1
- package/dist/src/process-exit.js +1 -1
- package/dist/src/provider-device-runtime.d.ts +28 -0
- package/dist/src/provider-plugin-catalog.js +2 -0
- package/dist/src/provider-plugin.d.ts +1 -1
- package/dist/src/provider-webdriver.js +1 -1
- package/dist/src/proxy.js +1 -1
- package/dist/src/react-native-overlay2.js +1 -1
- 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-scope.js +1 -1
- package/dist/src/recording.js +1 -1
- package/dist/src/registry.js +1 -1
- package/dist/src/remote-config-core.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 +3 -3
- package/dist/src/replay-script-selection.js +1 -1
- package/dist/src/replay2.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 +1 -1
- package/dist/src/retry.js +1 -1
- package/dist/src/runner-cache-retention.js +1 -1
- package/dist/src/runner-client.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-error-classification.js +2 -2
- package/dist/src/runner-exchange.js +1 -1
- package/dist/src/runner-lease.js +1 -1
- package/dist/src/runner-operations-facade.js +1 -1
- package/dist/src/runner-retention.js +1 -1
- package/dist/src/runner-selector-query.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-probe.js +1 -1
- package/dist/src/runner.js +2 -2
- 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.js +4 -4
- package/dist/src/runtime10.js +2 -2
- package/dist/src/runtime2.js +1 -1
- package/dist/src/runtime3.js +5 -5
- package/dist/src/runtime4.js +1 -1
- package/dist/src/runtime5.js +1 -1
- package/dist/src/runtime6.js +1 -1
- package/dist/src/runtime7.js +1 -1
- package/dist/src/runtime8.js +1 -1
- package/dist/src/runtime9.js +2 -2
- package/dist/src/screen-recording-transport.js +1 -1
- package/dist/src/screenshot-density.js +1 -1
- package/dist/src/screenshot-runtime.js +1 -1
- package/dist/src/screenshot3.js +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 +9 -0
- package/dist/src/sdk-contracts.js +2 -2
- package/dist/src/sdk-device.js +1 -1
- package/dist/src/sdk-finders.js +1 -1
- package/dist/src/sdk-io.js +5 -5
- package/dist/src/sdk-remote-config.js +1 -1
- 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-startup.js +1 -1
- package/dist/src/session-paths.js +1 -1
- package/dist/src/session-replay-vars.js +1 -1
- package/dist/src/session-runtime.js +1 -1
- package/dist/src/session-store.js +3 -3
- package/dist/src/session.js +1 -1
- package/dist/src/session2.js +5 -5
- package/dist/src/settings-bluetooth.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-settings.js +1 -1
- package/dist/src/simctl.js +1 -1
- package/dist/src/simulator-boot.js +1 -1
- package/dist/src/simulator-state.js +1 -1
- package/dist/src/simulator.js +1 -1
- package/dist/src/snapshot-chrome.js +1 -1
- package/dist/src/snapshot-desktop-projection.js +1 -1
- package/dist/src/snapshot-helper-install.js +6 -6
- package/dist/src/snapshot-node-lookup.js +1 -1
- package/dist/src/snapshot-occlusion.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/snapshot3.js +1 -1
- package/dist/src/src.js +1 -1
- package/dist/src/src3.js +1 -1
- package/dist/src/src4.js +1 -1
- package/dist/src/store.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/text-entry-focus.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-reference-frame.js +1 -1
- package/dist/src/touch-runtime.js +1 -1
- package/dist/src/touch-runtime2.js +1 -1
- package/dist/src/tree.js +1 -1
- package/dist/src/tv-remote-runtime.js +1 -1
- package/dist/src/tv-remote.js +2 -2
- package/dist/src/type-text-runtime.js +1 -1
- package/dist/src/update-check.js +1 -1
- package/dist/src/vega-executable.js +1 -1
- package/dist/src/video.js +1 -1
- package/dist/src/webdriver-source.js +1 -1
- package/package.json +7 -6
- package/server.json +2 -2
- package/android/ime-helper/dist/agent-device-android-ime-helper-0.21.30.apk.sha256 +0 -1
- package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.30.apk +0 -0
- package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.30.apk.sha256 +0 -1
- package/dist/src/physical-device-apps.js +0 -1
package/dist/src/cli-help.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import{r as e}from"./rolldown-runtime.js";import{O as t,x as n}from"./back-mode.js";import{
|
|
2
|
-
`)}const
|
|
1
|
+
import{r as e}from"./rolldown-runtime.js";import{O as t,x as n}from"./back-mode.js";import{Pr as r}from"./sdk-batch.js";import{O as i,V as a,f as o,k as s}from"./command-metadata.js";import{a as c}from"./version.js";import{n as l,r as u}from"./command-schema.js";import{n as d}from"./cli-command-aliases.js";import{n as f}from"./provider-plugin-catalog.js";const p=[`Flows: launchApp (with clearState, permissions, and Apple-only launch arguments; permissions apply after state clearing but before launch, and a launchApp without permissions touches nothing — there is no silent all: allow default); setPermissions (mid-flow permission grants, denials, and resets; all resolves in the backend — one simctl call on iOS, the declared permissions on Android — with specific entries overriding after it); runFlow file/inline; runFlow.when and repeat.while conditions (platform, visible, notVisible, and true, all re-evaluated before every repeat iteration); onFlowStart/onFlowComplete; repeat with times, while, or both; and retry.`,`Interactions: tapOn, doubleTapOn, longPressOn, inputText on the focused element, eraseText, openLink, hideKeyboard, basic pressKey, and back; selector targets poll until available and support recursive index, childOf, above, below, leftOf, rightOf, containsChild, containsDescendants, points, and optional; outer command labels are metadata, not target selectors.`,'Assertions and navigation: assertVisible, assertNotVisible, assertTrue (literal values and ${VAR} lookups only; "", "false", "0", "null", and "undefined" are falsy, everything else is truthy), extendedWaitUntil, scroll, scrollUntilVisible, absolute/percentage/target swipe, takeScreenshot, waitForAnimationToEnd, clearState, stopApp, and killApp (system-initiated process death: am kill on ADB-backed Android devices, which refuse a foreground target with android-kill-requires-background-app — background the app first, for example pressKey: Home — and fail a target whose process survives with android-kill-process-survived; iOS, Limrun, and WebDriver-provider backends run it as stopApp).',`Scripts: ordered runScript file/env scripts with http.post, json, and output variables; evalScript inline expressions run flow-scoped JavaScript and write output.* leaves for later steps.`],m=[`Permissions: every entry is one settings permission call, applied in order with all first; the step stops at the first entry the selected platform refuses, earlier entries stay applied, and the error names what landed. Android’s only allow level is while-in-use, so location: inuse and location: never mean allow and deny there, while location: always and photos: limited are Apple-only and fail. On iOS, which service a runtime changes is simctl privacy’s own verdict: current runtimes refuse a targeted notifications change and leave notifications untouched under all.`,`Runtime: iOS and Android only; launchApp.clearState and standalone clearState support Android and iOS simulators, launch arguments are Apple-only, and other standalone device utility/state commands are unsupported.`,"Expressions: evalScript and condition true: fields (runFlow.when and repeat.while share one evaluator) are evaluated as JavaScript (flow env and prior output leaves are string-typed); a true: field that is a boolean, a maestro.platform comparison, or plain literal text after ${VAR} lookups is decided without JavaScript, with the assertTrue falsy table for literal text. Other fields stay literal or ${VAR} lookup-only — assertTrue supports literals and bare lookups, and other expression-shaped payloads fail loud.",`Environment: flow env is the default, AD_VAR_* overrides it, and CLI -e KEY=VALUE wins over both.`,`Failure diagnostics: resolved targets and runFlow paths are rendered, while inputText payloads remain hidden; do not place secrets in diagnostic identifiers.`,`Trust: runScript, evalScript, and JavaScript condition true: fields execute flow scripts in-process via node:vm, which is not a security sandbox; runScript may make http.post network requests and its output keys cannot contain a dot. evalScript and true: fields that need JavaScript are refused outright for a flow accepted over the daemon’s remote HTTP surface, since that context can escape to the host.`,`Errors and tracking: unsupported commands and fields fail with source context when available; open a focused issue only when implementation work is planned.`];function h(){return[`Supported subset:`,...p.map(e=>` - ${e}`),``,`Boundaries:`,...m.map(e=>` - ${e}`)].join(`
|
|
2
|
+
`)}const g={summary:`Full multi-touch gesture shapes and platform quirks`,body:`agent-device help gestures
|
|
3
3
|
|
|
4
4
|
Full command shapes and platform quirks for touch/pointer gestures beyond scroll/swipe. Read this when a task needs multi-touch, a repeated gesture series, or exact per-platform verification.
|
|
5
5
|
|
|
@@ -33,14 +33,14 @@ macOS:
|
|
|
33
33
|
Context menus are secondary clicks, not long presses: agent-device click @e66 --button secondary --platform macos, then snapshot -i.
|
|
34
34
|
For fast desktop list traversal, prefer fixed pixel wheel steps and batch them when no snapshot is needed between passes:
|
|
35
35
|
agent-device scroll down --pixels 200 --duration-ms 50 --platform macos
|
|
36
|
-
agent-device batch --steps '[{"command":"scroll","input":{"direction":"down","pixels":200,"durationMs":50}},{"command":"scroll","input":{"direction":"down","pixels":200,"durationMs":50}}]' --platform macos`},
|
|
36
|
+
agent-device batch --steps '[{"command":"scroll","input":{"direction":"down","pixels":200,"durationMs":50}},{"command":"scroll","input":{"direction":"down","pixels":200,"durationMs":50}}]' --platform macos`},_={maestro:{id:`maestro`,help:{summary:`Supported Maestro YAML commands, grammar, and runtime boundaries`,body:`agent-device help maestro
|
|
37
37
|
|
|
38
38
|
Run Maestro compatibility flows with replay <flow.yaml> --maestro or test <path> --maestro. Bind an iOS or Android target with --platform or an existing session.
|
|
39
39
|
|
|
40
|
-
${
|
|
40
|
+
${h()}
|
|
41
41
|
|
|
42
42
|
Unsupported syntax fails loudly rather than being skipped. Architecture, performance tradeoffs, and declared conformance divergences: https://github.com/callstack/agent-device/blob/main/docs/adr/0015-direct-maestro-engine.md
|
|
43
|
-
Focused compatibility request: https://github.com/callstack/agent-device/issues/new`}}};function
|
|
43
|
+
Focused compatibility request: https://github.com/callstack/agent-device/issues/new`}}};function v(e){return _[e]}function y(e){let t=e.endsWith(`?`),n=t?e.slice(0,-1):e;return t?`[${n}]`:`<${n}>`}function b(e){return n().filter(t=>t.key===e)}function x(e){if(!e.usageHidden)return e.usageLabel??e.names[0]}function S(e){return(e??[]).flatMap(e=>b(e).map(x).filter(e=>e!==void 0).map(e=>`[${e}]`))}function C(e,t){return[t.usageOverride??[e,...(t.positionalArgs??[]).map(y)].join(` `),...S(t.usageFlags??t.allowedFlags)].join(` `)}const w=`Wait failure contract:
|
|
44
44
|
Read --json error.details.reason.
|
|
45
45
|
wait_target_absent: readable capture, no match.
|
|
46
46
|
wait_target_present: absence timeout; details.matches/firstMatch.
|
|
@@ -51,7 +51,7 @@ Focused compatibility request: https://github.com/callstack/agent-device/issues/
|
|
|
51
51
|
wait_runner_restart_exhausted: restart deadline -- retriable.
|
|
52
52
|
wait_landmark_identity_mismatch: replay guard: selector matched, recorded identity differed.
|
|
53
53
|
wait_stable_timeout: no stable UI -- not absence.
|
|
54
|
-
`,
|
|
54
|
+
`,T={"manual-qa":{summary:`Follow manual test scripts with exact interactions and verification`,body:`agent-device help manual-qa
|
|
55
55
|
|
|
56
56
|
Use this when asked to follow a manual QA script, test case, checklist, acceptance flow, or user-provided instructions.
|
|
57
57
|
|
|
@@ -94,7 +94,7 @@ Recovery:
|
|
|
94
94
|
Sparse or recovered accessibility snapshot: use screenshot as visual truth, leave the bad screen if needed, then retry snapshot -i.
|
|
95
95
|
Non-hittable success hint: verify with the settled diff or snapshot; retarget by a better ref/selector if the UI did not change.
|
|
96
96
|
|
|
97
|
-
${
|
|
97
|
+
${w}`}},E={debugging:{summary:`Targeted failure evidence without dumping stale context`,body:`agent-device help debugging
|
|
98
98
|
|
|
99
99
|
Use this when behavior fails, hangs, times out, throws alerts, or needs runtime evidence.
|
|
100
100
|
|
|
@@ -217,7 +217,7 @@ Text-entry quirks:
|
|
|
217
217
|
iOS accessibility-driven fill types the replacement once and never clears and retypes a read-back mismatch. Exact settled text confirms the entry. A value containing only characters in order from the post-clear value plus the request fails with TEXT_ENTRY_MISMATCH, including plain dropped characters and unchanged values; legitimate trimming or masks can also hit this limit ("5" into "$0.00" displaying "$0.05"). Other settled values return verification: "unconfirmed" with requested/before/after/target evidence, including grouping ("00 062 91 77" for "000629177"), currency ("$10.00" for "1000"), and OTP summaries. Missing, reordered, duplicated or stale text can also be unconfirmed, so assert the expected value with a value selector, get/is, or the resulting screen before continuing. For single-line fills ending in a submit key, any non-matching value observed on the same target succeeds unverified, including partial or cleared text; this exception skips dropped-character checks because the submit may change the field. Assert the resulting screen. Multiline fields compare newlines as content. Unreadable or removed fields remain unverified. The coordinate-driven fill route still requires an exact match. After TEXT_ENTRY_MISMATCH, inspect the field and retry fill only if it needs correction, using the --delay-ms value from the error hint.
|
|
218
218
|
|
|
219
219
|
React Native internals:
|
|
220
|
-
If the question is about React component props, state, hooks, the component tree, performance, render causes, slow components, or rerenders, use help react-devtools instead of inferring from screenshots or logs.`}},
|
|
220
|
+
If the question is about React component props, state, hooks, the component tree, performance, render causes, slow components, or rerenders, use help react-devtools instead of inferring from screenshots or logs.`}},D={dogfood:{summary:`Exploratory QA workflow with reproducible evidence`,body:`agent-device help dogfood
|
|
221
221
|
|
|
222
222
|
Use this when asked to dogfood, exploratory test, bug hunt, QA, or find issues in an app.
|
|
223
223
|
|
|
@@ -310,7 +310,7 @@ Evidence:
|
|
|
310
310
|
|
|
311
311
|
Report:
|
|
312
312
|
Summarize what changed, exact validation commands, pass/fail observations, artifact paths, and residual risk.
|
|
313
|
-
If live validation is blocked, state the blocker, device/session, and exact next command needed.`}};function
|
|
313
|
+
If live validation is blocked, state the blocker, device/session, and exact next command needed.`}};function O(){return`agent-device <command> [args] [--json]
|
|
314
314
|
|
|
315
315
|
Automates iOS, Android, macOS, TV, and web apps for AI agents.
|
|
316
316
|
All ${t().length} commands: agent-device help commands
|
|
@@ -361,7 +361,7 @@ Guides (agent-device help <topic>):
|
|
|
361
361
|
react-native / react-devtools / cdp / tv / web / macos / remote
|
|
362
362
|
physical-device / ios-system-ui / maestro
|
|
363
363
|
foldable iPhone Duo panels, the fold command, and why refs die on a pose change
|
|
364
|
-
`}var
|
|
364
|
+
`}var k=e({buildCommandUsageText:()=>G,buildUsageText:()=>R,helpTopicIds:()=>q,resolveHelpTargetUsageText:()=>K});const A=[`Default config files: ~/.agent-device/config.json (or <AGENT_DEVICE_HOME>/config.json), ./agent-device.json (project-safe defaults only).`,`Use --config <path> or AGENT_DEVICE_CONFIG for explicit connection/provider defaults; project config cannot select endpoints or credentials.`],j=[{label:`AGENT_DEVICE_SESSION`,description:`Explicit session name`},{label:`AGENT_DEVICE_PLATFORM`,description:`Default platform binding`},{label:`AGENT_DEVICE_SCREENSHOT_SCALE`,description:`Default screenshot scale factor`},{label:`AGENT_DEVICE_SESSION_LOCK`,description:`Bound-session conflict mode`},{label:`AGENT_DEVICE_DAEMON_BASE_URL`,description:`Connect to remote daemon`},{label:`AGENT_DEVICE_DAEMON_AUTH_TOKEN`,description:`Remote daemon service/API token`},{label:`AGENT_DEVICE_DAEMON_STARTUP_TIMEOUT_MS`,description:`Local daemon startup ceiling (default 120000)`},{label:`AGENT_DEVICE_CLOUD_BASE_URL`,description:`Bridge/control-plane API origin for cloud auth and /api-keys`}],M=[`agent-device open Settings --platform ios`,`agent-device open https://example.com --platform web`,`agent-device snapshot -i`,`agent-device fill @e3 "test@example.com"`,`agent-device replay ./session.ad`,`agent-device wait absent 'label="Loading..."' 3000`,`agent-device test ./suite --platform android`],N={commands:{summary:`Full command catalog, global flags, configuration, and environment`,body:`agent-device help commands`},...T,maestro:v(`maestro`).help,workflow:{summary:`Normal agent-device bootstrap, exploration, and validation loop`,body:`agent-device help workflow
|
|
365
365
|
|
|
366
366
|
Command shapes, refs, selectors, waits, recovery, and platform limits for open -> snapshot -i -> settle -> verify -> close loop.
|
|
367
367
|
|
|
@@ -401,7 +401,7 @@ Session ordering:
|
|
|
401
401
|
Stateful commands (open/press/fill/type/scroll/back/alert/replay/batch/close) run serially within one session. Parallelize only read-only commands, or separate sessions/devices.
|
|
402
402
|
|
|
403
403
|
Read-only and waits:
|
|
404
|
-
${
|
|
404
|
+
${w}
|
|
405
405
|
snapshot/get/is/find answer read-only questions; snapshot -i is for refs. --settle confirms local UI quieted; delayed results use wait text "Expected result" or wait <selector> instead of polling; strict disappearance uses wait absent <selector>.
|
|
406
406
|
wait stable [quietMs] [timeoutMs] (defaults 500/10000) is the fallback for open/relaunch/navigation, or an intentionally-unsettled mutation -- not after a --settle whose diff already shows the change. Ambiguous find: add --first or --last.
|
|
407
407
|
|
|
@@ -417,7 +417,7 @@ Validation and evidence:
|
|
|
417
417
|
|
|
418
418
|
React Native: help react-native for Metro/Re.Pack reload, DevTools, RN overlays. JS-only change: metro reload, find "Home"; open --relaunch for native reset.
|
|
419
419
|
|
|
420
|
-
Lifecycle facts (trust these instead of probing): open without --relaunch is idempotent-foreground; --relaunch restarts it. close keeps a healthy iOS runner warm by default; runners
|
|
420
|
+
Lifecycle facts (trust these instead of probing): open without --relaunch is idempotent-foreground except native macOS app opens (background); --relaunch restarts it. close keeps a healthy iOS runner warm by default; runners/daemons self-idle after 5 minutes; stale leases self-reclaim. open device claims reclaim other worktrees' warm runners; "already owned by another agent-device daemon" = owner outside claim arbitration. Env vars: help physical-device.
|
|
421
421
|
|
|
422
422
|
Escalate:
|
|
423
423
|
help manual-qa scripted manual QA
|
|
@@ -476,7 +476,7 @@ Batch:
|
|
|
476
476
|
Recording:
|
|
477
477
|
record start/stop. Default scope is app (needs an active open session); use --scope device/system for whole-screen capture spanning multiple apps/home/settings. --quality medium|high on Android and Apple targets. stop burns touch overlays into the video by default; --hide-touches skips that for the fastest raw recording, and is recommended for gesture-heavy iOS simulator proof videos since overlay timing depends on a stable runner session. Android adb screenrecord has a 180s limit, so long Android recordings return as multiple MP4 chunks while the daemon stays alive; after a daemon restart, record stop recovers only manifest-owned chunks. record stop is safe to repeat: if its request window ended while the daemon was still exporting, running it again in that session returns the completed recording instead of starting a second one.
|
|
478
478
|
record contact-sheet <video.mp4> [--out <sheet.png>] reads an exported MP4 back and writes one PNG holding the frames where the screen visibly changed, each labeled with its elapsed time. It is how you read a recording you cannot play, and it needs no session or device; the frames come out of that file, so the sheet cannot describe a screen the video does not contain. The sample grid is bounded and spread over the whole clip, so it reports coverage, not a review: a flash that opens and closes between two sample times is not in it. Needs a macOS host and an MP4 (a WebM recording is refused).
|
|
479
|
-
Tracing: trace start ./trace.log, trace stop ./trace.log (path is positional, not --path).`},gestures:
|
|
479
|
+
Tracing: trace start ./trace.log, trace stop ./trace.log (path is positional, not --path).`},gestures:g,tv:{summary:`Android TV, tvOS, and Vega VVD focus-first remote navigation`,body:`agent-device help tv
|
|
480
480
|
|
|
481
481
|
Use this when the target is Android TV, Apple TV/tvOS, or an Amazon Vega OS TV app running in the Vega Virtual Device (VVD). TV surfaces are focus-first: move focus with remote/D-pad buttons, then activate the focused control.
|
|
482
482
|
|
|
@@ -527,7 +527,7 @@ Focus and visual truth:
|
|
|
527
527
|
On Android TV and tvOS, if snapshot -i exposes a focused node, verify it with is focused <selector>.
|
|
528
528
|
Use wait focused=true only when repeated snapshots preserve focus metadata for the app.
|
|
529
529
|
If the app exposes only a surface view, or focus metadata is transient, use screenshot --overlay-refs, screenshot, or diff snapshot as visual truth and keep moving focus with tv-remote. On Vega OS, use the VVD display as visual truth until capture support lands.
|
|
530
|
-
Do not assume press/click @ref works on Android TV, tvOS, or Vega OS until the desired element is focused.`},...
|
|
530
|
+
Do not assume press/click @ref works on Android TV, tvOS, or Vega OS until the desired element is focused.`},...E,"react-devtools":{summary:`React Native components, props/state/hooks, and render profiling`,body:`agent-device help react-devtools
|
|
531
531
|
|
|
532
532
|
Use this for React Native internals the accessibility tree cannot show: the component tree, a component's props, state, hooks, and owners, errors and warnings components logged while rendering, and render performance (slow renders, rerenders and their causes, commits over a 16 ms frame).
|
|
533
533
|
|
|
@@ -739,7 +739,7 @@ Android physical-device prerequisites:
|
|
|
739
739
|
Android does not need the iOS runner signing setup. For React Native/Expo Metro reachability, read help react-native.
|
|
740
740
|
|
|
741
741
|
Runner and daemon lifecycle (applies to simulators too):
|
|
742
|
-
open without --relaunch is idempotent-foreground for an already-running app
|
|
742
|
+
open without --relaunch is idempotent-foreground for an already-running app, except native macOS app opens keep it in the background (help macos); neither restarts the process. open --relaunch restarts the app; on iOS simulators this collapses to one simctl launch --terminate-running-process call instead of a separate terminate-then-launch.
|
|
743
743
|
No runner read launches a session app that is not running: snapshot, wait, is, get, a reading find, and an interaction's leading reads (a gesture's viewport read, the capture that resolves a selector click/fill) answer the retriable APP_NOT_RUNNING instead of bare-launching over a launch SpringBoard still holds behind its deep-link confirmation. Only open, activate, and a command that mutates without a leading read bring a stopped app up.
|
|
744
744
|
close keeps a healthy iOS simulator XCTest runner warm by default so the next open on that simulator (same udid in the same simulator set) skips the runner build, unless --shutdown was requested, the session was recording, or the session held a device lease. A retained runner auto-stops after an idle window (default 5 minutes); set AGENT_DEVICE_IOS_RUNNER_IDLE_STOP_MS to override, or 0 to disable idle stop and retain until daemon exit. Only a ready runner with an observed listener is retained; close retires unfinished prewarm recovery. Losing the retained listener stops that generation, and daemon shutdown stops idle retained runners rather than handing them off without supervision.
|
|
745
745
|
Each AGENT_DEVICE_STATE_DIR runs its own daemon. It self-exits after an idle window (default 5 minutes, matching the runner idle-stop default) once it has no open sessions, no in-flight requests, and no active recording; set AGENT_DEVICE_DAEMON_IDLE_TIMEOUT_MS to override, or 0 to disable idle reap.
|
|
@@ -786,9 +786,13 @@ Providers:
|
|
|
786
786
|
Direct proxy: agent-device connect proxy --daemon-base-url <proxy-agent-device-url> stores the shared proxy profile and client identity.
|
|
787
787
|
BrowserStack: agent-device connect browserstack verifies credentials, the exact device, and a bs:// app reference, then stores a local provider profile. It does not create an App Automate session.
|
|
788
788
|
AWS Device Farm: agent-device connect aws-device-farm verifies credentials and the exact project, device, and optional app upload, then stores a local provider profile. It does not create a remote access session.
|
|
789
|
-
TestMu AI: agent-device connect testmu verifies credentials and the exact virtual device (emulator or simulator) or, with --provider-device-type real, real device and OS version, then stores a local provider profile. --provider-app takes an lt:// app reference, an https URL, or a local path: connect looks an lt:// id up among your uploads for that device pool, while URL and local sources are uploaded and validated when open creates the session. It does not create a hub session.
|
|
789
|
+
TestMu AI (plugin, install separately): agent-device connect testmu verifies credentials and the exact virtual device (emulator or simulator) or, with --provider-device-type real, real device and OS version, then stores a local provider profile. --provider-app takes an lt:// app reference, an https URL, or a local path: connect looks an lt:// id up among your uploads for that device pool, while URL and local sources are uploaded and validated when open creates the session. It does not create a hub session.
|
|
790
790
|
Limrun: agent-device connect limrun verifies access to the selected iOS or Android instance service, then stores a local provider profile. It does not create an instance.
|
|
791
791
|
|
|
792
|
+
Plugin installation:
|
|
793
|
+
${f()}
|
|
794
|
+
Plugin help is available before installation. plugins list --json reports your installed plugins. A missing plugin returns reason plugin-not-installed with its installation command; a selected plugin that cannot supply the provider returns plugin-unavailable instead. After changing plugins, close sessions and stop an existing local daemon with the same --state-dir before the next device command.
|
|
795
|
+
|
|
792
796
|
After direct-provider connect:
|
|
793
797
|
Read the printed Device, App, Next, and workflow-note lines. They are also available as verification/device/app/liveSession/nextSteps/notes in --json output.
|
|
794
798
|
BrowserStack, AWS Device Farm, and TestMu AI create the hosted session on open. open needs the installed package or bundle identifier, not the app artifact name, ARN, or lt:// id.
|
|
@@ -941,7 +945,9 @@ Rules:
|
|
|
941
945
|
Do not let iOS simulator-set scoping hide macOS desktop targets.
|
|
942
946
|
Prefer refs/selectors over raw coordinates.
|
|
943
947
|
macOS snapshot rects are window-space; use current refs or overlay refs instead of guessing coordinates.
|
|
944
|
-
On the default XCTest backend a read (snapshot, get, find) of a session app that sits behind other windows is answered from where it sits, without raising the app; interactions and a window-level screenshot of that app still bring it forward
|
|
948
|
+
On the default XCTest backend a read (snapshot, get, find) of a session app that sits behind other windows is answered from where it sits, without raising the app; interactions and a window-level screenshot of that app still bring it forward.
|
|
949
|
+
With AGENT_DEVICE_MACOS_APP_BACKEND=native, each app opened on the app surface is its own device: sessions on different apps run in parallel; a same-app or whole-Mac (desktop, menubar, frontmost-app) session conflicts.
|
|
950
|
+
An app session opens its app in the background and opens or closes only that app (open <url> goes to it). It refuses clipboard, settings, and audio probe; use a --surface desktop session for those, or a new --session for another app.`},web:{summary:`Minimal browser workflow with the managed web backend`,body:`agent-device help web
|
|
945
951
|
|
|
946
952
|
Use --platform web only for the minimal browser command loop exposed through agent-device.
|
|
947
953
|
|
|
@@ -988,30 +994,30 @@ Out of scope for agent-device web support:
|
|
|
988
994
|
Rules:
|
|
989
995
|
Do not claim web e2e CI exists unless a project workflow explicitly provides it.
|
|
990
996
|
Do not use native mobile or desktop setup commands such as boot, apps, install, settings, alert, keyboard, perf, logs, or react-devtools for --platform web.
|
|
991
|
-
Keep browser plans session-scoped: open a URL, inspect refs, act on refs/selectors, verify with wait/get/is/snapshot, capture screenshot only when visual evidence is needed, then close.`},...
|
|
997
|
+
Keep browser plans session-scoped: open a URL, inspect refs, act on refs/selectors, verify with wait/get/is/snapshot, capture screenshot only when visual evidence is needed, then close.`},...D};function P(e,t,n){let r=n.endsWith(`?`),i=r?n.slice(0,-1):n,a=/^[a-z-]+(?:\|[a-z-]+)+$/i.test(i),o=a||t.usageOverride!==void 0&&t.usageOverride.startsWith(`${e} ${i}`);return r?a?`[${i}]`:o?i:`[${i}]`:o?i:`<${i}>`}function F(e,t){return t.listUsageOverride?t.listUsageOverride:[e,...(t.positionalArgs??[]).map(n=>P(e,t,n))].join(` `)}function I(){return O()}function L(){return`agent-device help commands
|
|
992
998
|
|
|
993
999
|
Full command catalog. Use agent-device help <command> for exact flags and behavior.
|
|
994
1000
|
|
|
995
|
-
${
|
|
1001
|
+
${W(t().map(e=>{let t=l(e);return{name:e,schema:t,usage:F(e,t)}}))}
|
|
996
1002
|
|
|
997
|
-
${
|
|
1003
|
+
${V(`Device Selection (shared by device commands; help <command> lists each command's flags):`,z(i))}
|
|
998
1004
|
|
|
999
|
-
${
|
|
1005
|
+
${V(`Global Flags:`,z(s))}
|
|
1000
1006
|
|
|
1001
|
-
${
|
|
1007
|
+
${U(`Configuration:`,A)}
|
|
1002
1008
|
|
|
1003
|
-
${
|
|
1009
|
+
${H(`Environment:`,j)}
|
|
1004
1010
|
|
|
1005
|
-
${
|
|
1006
|
-
`}function
|
|
1007
|
-
`)}function
|
|
1008
|
-
`)}function
|
|
1011
|
+
${U(`Examples:`,M)}
|
|
1012
|
+
`}function R(){return I()}function z(e){return n().filter(t=>e.has(t.key)&&t.usageLabel!==void 0&&t.usageDescription!==void 0)}function B(e,t){return t?e.map(e=>{let n=t[e.key];return n===void 0?e:{...e,usageDescription:n}}):e}function V(e,t){return H(e,t.map(e=>({label:e.usageLabel??``,description:e.usageDescription??``})))}function H(e,t){if(t.length===0)return`${e}\n (none)`;let n=Math.max(...t.map(e=>Math.min(e.label.length,26)))+2,r=[e];for(let e of t){let t=e.label.length<=26?e.label.padEnd(n):`${e.label} `;r.push(` ${t}${e.description}`)}return r.join(`
|
|
1013
|
+
`)}function U(e,t){return t.length===0?`${e}\n (none)`:[e,...t.map(e=>` ${e}`)].join(`
|
|
1014
|
+
`)}function W(e){return H(`Commands:`,e.map(e=>({label:e.usage,description:e.schema.text.summary})))}function G(e){let t=J(e);if(t)return t;let n=u(e);if(!n)return null;let r=C(e,n),i=B(z(new Set(n.allowedFlags??[])),n.flagDescriptionOverrides),o=[];e===`connect`&&o.push(`Optional provider plugins:\n${f()}`),i.length>0&&o.push(V(`Command flags:`,i));let s=o.length>0?`\n\n${o.join(`
|
|
1009
1015
|
|
|
1010
1016
|
`)}`:``;return`Usage:
|
|
1011
1017
|
agent-device ${r}
|
|
1012
1018
|
|
|
1013
1019
|
${a(n.text)}${s}
|
|
1014
|
-
`}function
|
|
1020
|
+
`}function K(e){return G(d(e))}function q(){return Object.keys(N)}function J(e){let t=N[e];if(!t)return null;let n=e===`commands`?L():t.body,r=Y.filter(t=>t.topic!==e).map(e=>` ${e.line}\n`).join(``);return`${X(e,n)}
|
|
1015
1021
|
|
|
1016
1022
|
Related:
|
|
1017
|
-
${r}`}const
|
|
1023
|
+
${r}`}const Y=[{topic:null,line:`agent-device help <command> command-specific flags`},{topic:`manual-qa`,line:`agent-device help manual-qa routine QA loop`},{topic:`workflow`,line:`agent-device help workflow full automation reference`}];function X(e,t){let n=`agent-device help ${e}`;return t.startsWith(n)?`agent-device ${c()} — ${e}${t.slice(n.length)}`:t}export{K as i,k as n,q as r,R as t};
|
package/dist/src/cli-runner.js
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import{R as e}from"./sdk-contracts.js";import{
|
|
1
|
+
import{R as e}from"./sdk-contracts.js";import{bt as t}from"./sdk-io.js";import"./diagnostics.js";import{C as n,o as r}from"./command-metadata.js";import{t as i}from"./cli-output.js";import{n as a}from"./command-surface.js";const o=65536;async function s(t){if(t.isTTY)throw new e(`INVALID_ARGS`,`fill --text-stdin reads piped input, but stdin is a terminal.`,{reason:`fill_text_stdin_tty`,hint:`Pipe the text in, for example: printf %s "$PASSWORD" | agent-device fill @e3 --text-stdin`});let n=[],r=0,i=``;for await(let a of t){let t=u(i,a);if(i=t.held,r+=d(t.piece),r>65536)throw new e(`INVALID_ARGS`,`fill --text-stdin accepts at most ${o} bytes of input.`,{reason:`fill_text_stdin_too_large`,maxBytes:o});n.push(f(t.piece))}if(i)throw m();let a=h(p(Buffer.concat(n)));if(a===``)throw new e(`INVALID_ARGS`,`fill --text-stdin received no text.`,{reason:`fill_text_stdin_empty`,hint:`Check that the piped value is set. To clear a field, pass an empty text argument instead: fill @e3 ""`});return a}const c=/[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/,l=/[\uD800-\uDBFF]$/;function u(e,t){if(typeof t!=`string`){if(e)throw m();return{piece:t,held:``}}let n=e+t;return l.test(n)?{piece:n.slice(0,-1),held:n.slice(-1)}:{piece:n,held:``}}function d(e){return typeof e==`string`?Buffer.byteLength(e,`utf8`):e.byteLength}function f(e){if(typeof e!=`string`)return e;if(c.test(e))throw m();return Buffer.from(e,`utf8`)}function p(e){try{return new TextDecoder(`utf-8`,{fatal:!0,ignoreBOM:!0}).decode(e)}catch{throw m()}}function m(){return new e(`INVALID_ARGS`,`fill --text-stdin input is not valid UTF-8.`,{reason:`fill_text_stdin_invalid_utf8`})}function h(e){return e.endsWith(`\r
|
|
2
2
|
`)?e.slice(0,-2):e.endsWith(`
|
|
3
3
|
`)?e.slice(0,-1):e}const g=r();function _(e,t,r){let i=g[e];if(!i)throw Error(`Missing CLI reader for command: ${e}`);return{...i(t,r),...n(e,r)}}async function v(e){return(await y(e)).result}async function y(e){let n=_(e.command,e.positionals,e.flags);if(e.flags.textStdin){let e=await s(process.stdin);t(e),n.text=e}let r=await a(e.client,e.command,n);return{result:r,cliOutput:await i({name:e.command,input:n,result:r,progress:e.commandProgress,env:e.env})}}export{y as n,v as t};
|
package/dist/src/cli.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import{r as e}from"./rolldown-runtime.js";import{B as t,R as n,d as r,et as i,m as a}from"./sdk-contracts.js";import{gt as o}from"./tv-remote.js";import{d as s,f as c,s as l,u}from"./sdk-batch-runner.js";import{D as d,O as f,b as p,ht as m,pt as h,vt as g,wt as ee,x as _,yt as te}from"./back-mode.js";import{_t as v,f as ne,gt as y,ht as b,lt as re,mt as ie,ot as ae,tt as oe,vt as se,xt as ce}from"./sdk-io.js";import"./diagnostics.js";import{D as le,O as ue,c as de,m as fe,x as pe}from"./sdk-device.js";import{n as me}from"./agent-device-client.js";import{s as he,t as ge,u as _e}from"./sdk-batch.js";import{t as ve}from"./sdk-remote-config.js";import{G as ye,n as be}from"./command-metadata.js";import"./file.js";import"./command.js";import{i as xe,n as Se}from"./daemon-client.js";import{n as Ce}from"./session-artifact-paths.js";import{a as we}from"./version.js";import{m as Te}from"./daemon-resolution.js";import{n as Ee,r as De}from"./remote-config-core.js";import{r as x,t as Oe}from"./command-schema.js";import{n as S,r as C,t as ke}from"./cli-config.js";import{t as Ae}from"./update-check.js";import{n as je,r as Me,t as Ne}from"./cli-command-aliases.js";import{exitAfterFlush as w}from"./process-exit.js";import T from"node:crypto";import E from"node:fs";import D from"node:path";import{pathToFileURL as Pe}from"node:url";const O=`open <app> --relaunch`,Fe={start:{command:`open`,example:O},restart:{command:`open`,example:O},touch:{command:`press`,example:`press`},input:{command:`fill`,example:`fill`},settext:{command:`fill`,example:`fill`},entertext:{command:`fill`,example:`fill`},screencap:{command:`screenshot`,example:`screenshot`},capture:{command:`screenshot`,example:`screenshot`},dismiss:{command:`keyboard`,example:`keyboard dismiss`},"get-text":{command:`get`,example:`get text`},gettext:{command:`get`,example:`get text`},get_text:{command:`get`,example:`get text`},"open-url":{command:`open`,example:`open <url>`},"close-session":{command:`close`,example:`close`}};function Ie(e){if(e.length<=2)return[];let t=f(),n=t.filter(t=>t.startsWith(e));return n.length>0?n.sort(Le).slice(0,3):Re(e,t)}function Le(e,t){return e.length-t.length||e.localeCompare(t)}function Re(e,t){let n=t.map(t=>({name:t,distance:Be(e,t)})).filter(t=>t.distance<=ze(e));if(n.length===0)return[];let r=Math.min(...n.map(e=>e.distance));return n.filter(e=>e.distance===r).sort((e,t)=>e.name.localeCompare(t.name)).slice(0,3).map(e=>e.name)}function ze(e){return e.length<4?1:e.length<=6?2:3}function Be(e,t){return e===t?0:e.startsWith(t)||t.startsWith(e)?Math.abs(e.length-t.length):Ve(e,t)}function Ve(e,t){let n=e.length+1,r=t.length+1,i=Array.from({length:n},()=>Array(r).fill(0));for(let e=0;e<n;e+=1)i[e][0]=e;for(let e=0;e<r;e+=1)i[0][e]=e;for(let a=1;a<n;a+=1)for(let n=1;n<r;n+=1){let r=e[a-1]===t[n-1]?0:1;i[a][n]=Math.min(i[a-1][n]+1,i[a][n-1]+1,i[a-1][n-1]+r)}return i[n-1][r-1]}function He(e){let t=e.toLowerCase(),n=Fe[t]?.example;if(n)return n;let r=Ie(t);if(r.length!==0)return r.length===1?r[0]:`one of: ${r.join(`, `)}`}const Ue=new Set([`--bundle-id`,`--bundleid`,`--bundle`,`--package`,`--package-name`,`--packagename`,`--app-id`,`--appid`,`--pkg`]),We=new Set([`--session-locked`,`--session-lock-conflicts`]),Ge={"--output":`--out`,"--path":`--out`};function Ke(e,t){let n=e.toLowerCase(),r=Ge[n];if(r&&qe(r,t))return r;let i=Je(n,t);if(i.length!==0)return i.length===1?i[0]:`one of: ${i.join(`, `)}`}function qe(e,t){let n=_().find(t=>t.names.includes(e));return n?C(n.key,t):!1}function Je(e,t){let n=k(e);if(n.length<=2)return[];let r=Ye(t),i=r.filter(e=>k(e).startsWith(n));return i.length>0?i.sort(Le).slice(0,3):Re(n,r.map(e=>k(e))).map(e=>`--${e}`)}function Ye(e){let t=new Set;for(let n of _()){if(!C(n.key,e))continue;let r=n.names[0];r&&t.add(r)}return[...t]}function k(e){return e.replace(/^--?/,``)}function Xe(e,t){let n=e.toLowerCase();if(Ue.has(n))return`Unknown flag: ${e}. The app or bundle id is a positional argument, e.g. ${O}.`;if(We.has(n))return`Unknown flag: ${e}. Use --session-lock reject|strip instead.`;if(n===o.cliToken)return`Unknown flag: ${e}. ${o.migration.screenshot}. ${o.migration.record}.`;let r=Ke(e,t);return r?`Unknown flag: ${e}. Did you mean ${r}?`:`Unknown flag: ${e}`}function A(e){let t={json:!1,help:!1,version:!1},r=null,i=null,a=[],o=[],s=[],c=!0;for(let o=0;o<e.length;o+=1){let l=e[o];if(c&&l===`--`){c=!1;continue}if(!c){r?a.push(l):(i=l,r=N(l));continue}if(et(r)){a.push(l);continue}let u=l.startsWith(`--`),d=l.startsWith(`-`)&&l.length>1;if(!u&&!d){r?a.push(l):(i=l,r=N(l));continue}let[f,p]=u?j(l):[l,void 0];if(Qe(r,f))continue;let m=tt(f,r);if($e(r,m)){a.push(l);continue}if(!m){if(ct(r,a,l)){r?a.push(l):r=l;continue}throw new n(`INVALID_ARGS`,Xe(f,r))}let h=it(m,f,p,e[o+1]);h.consumeNext&&(o+=1);let g=t[m.key];if(m.multiple){let e=Array.isArray(g)?[...g,h.value]:g===void 0?[h.value]:[g,h.value];t[m.key]=e}else t[m.key]=h.value;s.push({key:m.key,token:f})}return Ze(i,t),{command:r,positionals:a,flags:t,warnings:o,providedFlags:s}}function Ze(e,t){if(e)for(let n of Ne(e)?.impliedFlags??[])t[n]=!0}function Qe(e,t){return t===`-c`&&(e===`snapshot`||e===`diff`)}function $e(e,t){return e===`react-devtools`?!t||!C(t.key,e):!1}function et(e){return e===`cdp`}function tt(e,t){let n=_().filter(t=>t.names.includes(e));if(n.length<=1)return n[0]??p(e);if(t){let e=n.find(e=>C(e.key,t));if(e)return e}return p(e)}function nt(e,t){let r=t?.strictFlags??!0,i=[...e.warnings],a=S({json:!1,help:!1,version:!1},t?.defaultFlags??{});if(S(a,e.flags),e.command&&!d(e.command)&&!a.help){let t=He(e.command),r=t?`Unknown command: ${e.command}. Did you mean ${t}?`:`Unknown command: ${e.command}`;throw new n(`INVALID_ARGS`,r)}let o=e.providedFlags.filter(t=>!C(t.key,e.command));if(o.length>0){let t=o.map(e=>e.token),s=mt(e.command,t);if(r)throw new n(`INVALID_ARGS`,s);i.push(s);for(let e of o)delete a[e.key]}let s=ft(e);if(s.length>0){let t=pt(e.command,e.positionals[0],s);if(r)throw new n(`INVALID_ARGS`,t);i.push(t);for(let e of s)delete a[e.key]}for(let t of Object.keys(a))a[t]!==void 0&&(C(t,e.command)||delete a[t]);dt(e,a),rt(e),_e(e.command,a);let c=ut({command:e.command,positionals:e.positionals,flags:a,warnings:i});if(Oe(c.command,c.positionals),c.command===`batch`&&+!!a.steps+ +!!a.stepsFile!=1)throw new n(`INVALID_ARGS`,`batch requires exactly one step source: --steps or --steps-file.`);return c}function rt(e){if(e.command!==`back`)return;let t=e.providedFlags.filter(e=>e.key===`backMode`);if(!(new Set(t.map(e=>e.token)).size<=1))throw new n(`INVALID_ARGS`,`back accepts only one explicit mode flag: use either --in-app or --system.`)}function j(e){let t=e.indexOf(`=`);return t===-1?[e,void 0]:[e.slice(0,t),e.slice(t+1)]}function it(e,t,r,i){if(e.setValue!==void 0){if(r!==void 0)throw new n(`INVALID_ARGS`,`Flag ${t} does not take a value.`);return{value:e.setValue,consumeNext:!1}}if(e.type===`boolean`){if(r!==void 0)throw new n(`INVALID_ARGS`,`Flag ${t} does not take a value.`);return{value:!0,consumeNext:!1}}if(e.type===`booleanOrString`){if(r!==void 0){if(r.trim().length===0)throw new n(`INVALID_ARGS`,`Flag ${t} requires a non-empty value when provided.`);return{value:r,consumeNext:!1}}return i===void 0||ot(i)?{value:!0,consumeNext:!1}:st(i)?{value:i,consumeNext:!0}:{value:!0,consumeNext:!1}}let a=r??i;if(a===void 0||r===void 0&&ot(a))throw new n(`INVALID_ARGS`,`Flag ${t} requires a value.`);if(e.type===`string`)return{value:a,consumeNext:r===void 0};if(e.type===`enum`){if(!e.enumValues?.includes(a))throw new n(`INVALID_ARGS`,`Invalid ${at(t)}: ${a}`);return{value:a,consumeNext:r===void 0}}if(a.trim().length===0)throw new n(`INVALID_ARGS`,`Flag ${t} requires a value.`);let o=Number(a);if(!Number.isFinite(o)||typeof e.min==`number`&&o<e.min||typeof e.max==`number`&&o>e.max)throw new n(`INVALID_ARGS`,`Invalid ${at(t)}: ${a}`);return{value:e.type===`int`?Math.floor(o):o,consumeNext:r===void 0}}function at(e){return e.replace(/^-+/,``)}function ot(e){if(!e.startsWith(`-`)||e===`-`)return!1;let[t]=e.startsWith(`--`)?j(e):[e,void 0];return p(t)!==void 0}function st(e){let t=e.trim();return!t||/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(t)?!1:!!(t.startsWith(`./`)||t.startsWith(`../`)||t.startsWith(`~/`)||t.startsWith(`/`)||t.includes(`/`)||t.includes(`\\`))}function ct(e,t,n){if(!lt(n)||!e)return!1;let r=x(e);if(!r||r.allowsExtraPositionals)return!0;let i=r.positionalArgs??[];return i.length===0?!1:t.length<i.length||i.some(e=>e.includes(`?`))}function lt(e){return/^-\d+(\.\d+)?$/.test(e)}function ut(e){if(e.flags.help)return e;if(e.command===`snapshot`&&e.flags.snapshotDiff){let{snapshotDiff:t,...n}=e.flags;return{command:`diff`,positionals:[`snapshot`,...e.positionals],flags:n,warnings:e.warnings}}return e}function dt(e,t){let n=x(e.command)?.explicitOnlyFlags;if(n===void 0)return;let r=new Set(e.providedFlags.map(e=>e.key));for(let e of n)r.has(e)||delete t[e]}function ft(e){let t=x(e.command)?.flagsByAction,n=e.positionals[0];if(t===void 0||n===void 0||!Object.hasOwn(t,n))return[];let r=t[n];if(r===void 0)return[];let i=new Set(Object.values(t).flat());return e.providedFlags.filter(e=>i.has(e.key)&&!r.includes(e.key))}function pt(e,t,n){return`${e} ${t} does not read ${n.map(e=>e.token).join(`, `)}. Run \`${e} ${t} --help\` for the options it reads.`}function mt(e,t){return e?t.length===1?`Flag ${t[0]} is not supported for command ${e}.`:`Flags ${t.join(`, `)} are not supported for command ${e}.`:t.length===1?`Flag ${t[0]} requires a command that supports it.`:`Flags ${t.join(`, `)} require a command that supports them.`}async function M(){let{buildUsageText:e}=await import(`./cli-help.js`).then(e=>e.n);return e()}async function ht(e){let{buildCommandUsageText:t}=await import(`./cli-help.js`).then(e=>e.n);return t(N(e))}function N(e){let t=Me(e);if(t)throw new n(`INVALID_ARGS`,t);return je(e)}function gt(){return{renderedToStderr:!1}}function _t(e){return t=>{t.type===`command`&&(e.renderedToStderr=!0,process.stderr.write(`${t.message}\n`))}}function vt(e){return be(e)}const yt={connect:async()=>(await import(`./connection.js`)).connectCommand,disconnect:async()=>(await import(`./connection.js`)).disconnectCommand,connection:async()=>(await import(`./connection.js`)).connectionCommand,auth:async()=>(await import(`./auth.js`)).authCommand,plugins:async()=>(await import(`./plugins2.js`)).pluginsCommand,daemon:async()=>(await import(`./daemon.js`)).daemonCommand,device:async()=>(await import(`./device.js`)).deviceCommand,proxy:async()=>(await import(`./proxy.js`)).proxyCommand,takeover:async()=>(await import(`./takeover.js`)).takeoverCommand,replay:async()=>(await import(`./replay2.js`)).replayCommand,screenshot:async()=>(await import(`./screenshot3.js`)).screenshotCommand,diff:async()=>(await import(`./screenshot3.js`)).diffCommand,record:async()=>(await import(`./recording.js`)).recordingCommand};async function bt(e){let t={...e.flags},n=yt[e.command];return n&&await(await n())({...e,flags:t})?!0:vt(e.command)?await xt({...e,command:e.command,flags:t}):!1}async function xt(e){let{runGenericClientBackedCommand:t}=await import(`./generic.js`);return await t(e)}function St(e){return e===`android-instance`||e===`ios-instance`}function Ct(e){return[`exec`,`--yes`,`--package`,`agent-cdp@1.6.1`,`--`,`agent-cdp`,...e]}function wt(e){return e.some(e=>e===`--url`||e.startsWith(`--url=`))}function Tt(e){return e[0]===`target`&&(e[1]===`list`||e[1]===`select`)&&!wt(e)}function Et(e){let t=new URL(e);t.search=``,t.hash=``;let n=t.pathname.replace(/\/+$/,``);return t.pathname=n.endsWith(`/index.bundle`)?n.slice(0,-13)||`/`:n||`/`,t.toString().replace(/\/+$/,``)}function Dt(e){let t=e?.metroPublicBaseUrl?.trim();return t?Et(t):null}function Ot(e,t={}){if(!Tt(e)||!t.flags?.metroProxyBaseUrl||!St(t.flags.leaseBackend))return e;let r=Dt(t.flags);if(!r)throw new n(`INVALID_ARGS`,`cdp remote bridge target discovery requires a React Native dev-server public base URL.`,{hint:`Include metroPublicBaseUrl in the remote config so cdp can reach the local or tunneled Metro/Re.Pack CDP endpoint without bridge proxy authentication.`});return[...e,`--url`,r]}async function kt(e,t){let n=Ot(e,t);return(await oe(`npm`,Ct(n),{cwd:t.cwd,env:t.env,allowFailure:!0,onStdoutChunk:e=>{process.stdout.write(e)},onStderrChunk:e=>{process.stderr.write(e)}})).exitCode}const P=`${l} Run agent-device help batch for the commands batch accepts and for runnable step examples.`,At=`${ge} Run agent-device help batch for the commands batch accepts and for runnable step examples.`;function jt(e){let t;try{t=JSON.parse(e)}catch{throw new n(`INVALID_ARGS`,`Batch steps must be valid JSON.`)}if(!Array.isArray(t)||t.length===0)throw new n(`INVALID_ARGS`,`Batch steps must be a non-empty JSON array.`);return t.map((e,t)=>Mt(e,t+1))}function Mt(e,t){let r=c(e,t,P),i=[`positionals`,`flags`].filter(e=>e in r);if(i.length>0){let e=i.map(e=>`"${e}"`).join(`, `);throw new n(`INVALID_ARGS`,`Batch step ${t} uses removed field(s): ${e}. Use {"command":"...","input":{...}}. Example: {"command":"open","input":{"app":"settings","platform":"ios"}}.`,{hint:P})}ye(r,[`command`,`input`,`runtime`],`Batch step ${t}`,P);let a=u(r.runtime,t);return{command:he(r.command,t,At),input:s(r,t,P),...a===void 0?{}:{runtime:a}}}function Nt(e,t){let n=Pt(t),r={...e};return n.defaultPlatform&&r.platform===void 0&&(r.platform=n.defaultPlatform),r}function Pt(e){let{env:t}=e,n=e.inheritedPlatform??e.configuredPlatform??It(t.AGENT_DEVICE_PLATFORM),r=Rt(e.configuredSession??t.AGENT_DEVICE_SESSION);return{defaultPlatform:n,lockPolicy:Ft(e.policyOverrides,t,r)}}function Ft(e,t,n){let r=e?.sessionLock??Lt(t.AGENT_DEVICE_SESSION_LOCK);if(r)return r;if(n)return`reject`}function It(e){if(e===void 0)return;let t=e.trim().toLowerCase();if(t){if(t===`ios`||t===`android`||t===`apple`)return t;throw new n(`INVALID_ARGS`,`Invalid AGENT_DEVICE_PLATFORM: ${e}. Use ios, android, or apple.`)}}function Lt(e){if(e===void 0)return;let t=e.trim().toLowerCase();if(t){if(t===`reject`||t===`strip`)return t;throw new n(`INVALID_ARGS`,`Invalid session lock mode: ${e}. Use reject or strip.`)}}function Rt(e){return typeof e==`string`&&e.trim().length>0}const zt=ve.map(e=>e.key);function F(e){let t={};for(let n of zt){let r=e[n];r!==void 0&&(t[n]=r)}return t}function Bt(e){return e.remoteConfig?{...F(De({configPath:e.remoteConfig,cwd:e.cwd,env:e.env}).profile),remoteConfig:e.remoteConfig}:{}}function Vt(e,t){let n=A(e),{env:r,cwd:i}=t,a=Ht(n.command)?Bt({remoteConfig:n.flags.remoteConfig,cwd:i,env:r}):{},o=S(ke({command:n.command,cwd:i,cliFlags:n.flags,env:r}),a);return{...nt(n,{strictFlags:t?.strictFlags,defaultFlags:o}),providedFlags:n.providedFlags}}function Ht(e){return e!==null}function Ut(e){return I(ue(e),e.target,e.id)}function I(e,t,n){let i=r(e);return{platform:e,target:t,leaseBackend:i,identityFlag:i?de(e):void 0,id:n}}function Wt(e){return h(e)}function Gt(e){let t=ee(e);if(!(!t||!pe(t.platform)||!fe(t.target)))return I(t.platform,t.target,t.id)}function L(e){let t=[e.leaseBackend?a(e.leaseBackend):void 0,e.recordedPlatform].filter(e=>e!==void 0);if(t.some(e=>t.some(t=>le(e,t)))||le(e.requestedPlatform,t[0]??e.recordedPlatform))return{ok:!1,boundPlatform:t[0],requestedPlatform:e.requestedPlatform};let n=[...t,e.requestedPlatform].filter(e=>e!==void 0);return{ok:!0,platform:n.find(e=>e!==`apple`)??n[0]}}function Kt(e,t){return t!==void 0&&e.platform===void 0?!1:L({leaseBackend:e.leaseBackend,recordedPlatform:e.platform,requestedPlatform:t}).ok}function R(e){let t=V(e);if(!E.existsSync(t))return null;let n;try{n=JSON.parse(E.readFileSync(t,`utf8`))}catch(t){return an(e,t),null}return sn(n)?n:(an(e),null)}function qt(e){let t=V({stateDir:e.stateDir,session:e.state.session});E.mkdirSync(D.dirname(t),{recursive:!0}),nn(t,e.state),nn(H(e.stateDir),{session:e.state.session})}function Jt(e){return{baseUrl:rn(e.daemonBaseUrl),transport:e.daemonTransport,serverMode:e.daemonServerMode}}function z(e){E.rmSync(V(e),{force:!0});let t=H(e.stateDir);$t(e.stateDir)===e.session&&E.rmSync(t,{force:!0})}function Yt(e){let t=e.validateRemoteConfigHash??!0,r=e.remoteConfig?Ee({configPath:e.remoteConfig,cwd:e.cwd,env:e.env}):void 0,i=R(e)??(e.allowActiveFallback?U({stateDir:e.stateDir}):null);if(!i||r&&i.remoteConfigPath!==r)return null;if(t&&B(i.remoteConfigPath)!==i.remoteConfigHash)throw new n(`INVALID_ARGS`,`Active remote connection config changed. Run agent-device connect --force to refresh it.`,{remoteConfig:i.remoteConfigPath});let a=tn(i,e),o=m(i);return{runtime:i.runtime,connection:te(o),flags:{...a,remoteConfig:i.remoteConfigPath,daemonBaseUrl:i.daemon?.baseUrl??a.daemonBaseUrl,daemonAuthToken:a.daemonAuthToken,daemonTransport:i.daemon?.transport??a.daemonTransport,daemonServerMode:i.daemon?.serverMode??a.daemonServerMode,...g(o),sessionIsolation:`tenant`,session:i.session,platform:i.platform??a.platform,target:i.target??a.target}}}function Xt(e){return te(m(e))}function Zt(e,t){return{leaseProvider:e.leaseProvider??t.leaseProvider,clientId:e.clientId??t.clientId,deviceKey:e.deviceKey??t.deviceKey}}function Qt(e,t){return!t||(t.leaseProvider===void 0||e.leaseProvider===t.leaseProvider)&&(t.clientId===void 0||e.clientId===t.clientId)}function B(e){try{return T.createHash(`sha256`).update(E.readFileSync(e)).digest(`hex`)}catch(t){throw new n(`INVALID_ARGS`,`Remote config file not found: ${e}`,{cause:t instanceof Error?t.message:String(t)})}}function V(e){return D.join(e.stateDir,`remote-connections`,`${on(e.session)}.json`)}function H(e){return D.join(e,`remote-connections`,`.active-session.json`)}function U(e){let t=$t(e.stateDir);return t?R({stateDir:e.stateDir,session:t}):null}function $t(e){let t=H(e);if(E.existsSync(t))try{let e=JSON.parse(E.readFileSync(t,`utf8`));return typeof e.session==`string`?e.session:void 0}catch{return}}function en(e){if(e)return T.createHash(`sha256`).update(e).digest(`hex`).slice(0,12)}function tn(e,t){try{return De({configPath:e.remoteConfigPath,cwd:t.cwd,env:t.env}).profile}catch(e){if(t.validateRemoteConfigHash===!1)return{};throw e}}function nn(e,t){re({destination:e,contents:`${JSON.stringify(t,null,2)}\n`,mode:384})}function rn(e){if(!e)return;let t=new URL(e);t.username=``,t.password=``;for(let e of Array.from(t.searchParams.keys()))/(auth|key|password|secret|token)/i.test(e)&&t.searchParams.delete(e);return t.toString().replace(/\/+$/,``)}function an(e,t){b({level:`warn`,phase:`remote_connection_state_invalid`,data:{session:e.session,cause:t instanceof Error?t.message:t?String(t):void 0}}),z(e)}function on(e){let t=e.replaceAll(/[^a-zA-Z0-9._-]/g,`_`);return t?t===e?t:`${t}-${T.createHash(`sha256`).update(e).digest(`hex`).slice(0,8)}`:`default`}function sn(e){if(!e||typeof e!=`object`||Array.isArray(e))return!1;let t=e;return t.version===1&&cn(t,[`session`,`remoteConfigPath`,`remoteConfigHash`,`tenant`,`runId`,`connectedAt`,`updatedAt`])&&ln(t,[`leaseId`,`leaseBackend`,`leaseProvider`,`deviceKey`,`clientId`])&&un(t.daemon)}function cn(e,t){return t.every(t=>typeof e[t]==`string`)}function ln(e,t){return t.every(t=>e[t]===void 0||typeof e[t]==`string`)}function un(e){return e===void 0?!0:!e||typeof e!=`object`||Array.isArray(e)?!1:dn(e)}function dn(e){let t=e;return(t.baseUrl===void 0||typeof t.baseUrl==`string`)&&(t.authToken===void 0||typeof t.authToken==`string`)&&(t.transport===void 0||typeof t.transport==`string`)&&(t.serverMode===void 0||typeof t.serverMode==`string`)}async function fn(e,t){let r=await e.text(),i={};if(r.trim().length>0)try{i=JSON.parse(r)}catch(r){throw new n(`COMMAND_FAILED`,t.invalidJsonMessage,{status:e.status},r instanceof Error?r:void 0)}if(!e.ok)throw new n(`UNAUTHORIZED`,t.rejectedMessage,{status:e.status,response:i});return i}const pn=1e3;async function mn(e){return await hn({command:e.command,flags:e.flags,stateDir:e.stateDir,allowInteractiveLogin:e.command===`connect`&&!e.flags.noLogin,env:e.env})}async function hn(e){let{env:t}=e;if(!e.flags.daemonBaseUrl)return{flags:e.flags,source:`none`};if(X(e.flags.daemonAuthToken))return{flags:e.flags,source:`flag`};if(X(t.AGENT_DEVICE_DAEMON_AUTH_TOKEN))return{flags:e.flags,source:`env`};if(!kn(e.flags.daemonBaseUrl,t))return{flags:e.flags,source:`none`};let r=await xn({stateDir:e.stateDir,flags:e.flags,env:t,io:e.io});if(r)return{flags:{...e.flags,daemonAuthToken:r.accessToken},source:`cli-session`};if(!e.allowInteractiveLogin)throw e.flags.noLogin?new n(`UNAUTHORIZED`,`Remote daemon authentication is required.`,{hint:`Run agent-device auth login, unset --no-login, or set AGENT_DEVICE_DAEMON_AUTH_TOKEN.`}):On(e.command,t);let i=await W({stateDir:e.stateDir,flags:e.flags,env:t,io:e.io});return{flags:{...e.flags,daemonAuthToken:i.accessToken},source:`login`}}async function gn(e){let{env:t}=e;if(X(e.flags.daemonAuthToken))return{accessToken:e.flags.daemonAuthToken,cloudBaseUrl:J(t)};if(X(t.AGENT_DEVICE_DAEMON_AUTH_TOKEN))return{accessToken:t.AGENT_DEVICE_DAEMON_AUTH_TOKEN,cloudBaseUrl:J(t)};let r=await xn({stateDir:e.stateDir,flags:e.flags,env:t,io:e.io});if(r)return{accessToken:r.accessToken,cloudBaseUrl:r.cloudBaseUrl};if(e.flags.noLogin)throw new n(`UNAUTHORIZED`,`Cloud connection profile authentication is required.`,{hint:`Run agent-device auth login, unset --no-login, or set AGENT_DEVICE_DAEMON_AUTH_TOKEN.`});let i=await W({stateDir:e.stateDir,flags:e.flags,env:t,io:e.io,commandLabel:`agent-device connect`});return{accessToken:i.accessToken,cloudBaseUrl:i.session.cloudBaseUrl}}async function W(e){let{env:t}=e,r=Tn(t,e.io);if(r===`non-interactive`)throw On(e.commandLabel??`agent-device connect`,t);let i=J(t),a=await K({baseUrl:i,pathName:`/api/control-plane/device-auth/start`,body:{client:`agent-device`,tenant:e.flags.tenant,runId:e.flags.runId,daemonBaseUrl:e.flags.daemonBaseUrl,session:e.flags.session},fetchImpl:e.io?.fetch});await wn(a);let o=X(a.verificationUriComplete)?a.verificationUriComplete:a.verificationUri;if(r===`local-browser`)Y(e.io,`Opening ${a.verificationUri}...\n`),await jn(o,e.io);else{let t=An(a.verificationUri,a.userCode);Y(e.io,`Open this URL on your machine:\n${t}\n\nWaiting for approval for 10 minutes...\n`)}let s=await Cn({cloudBaseUrl:i,deviceCode:a.deviceCode,expiresIn:a.expiresIn,interval:a.interval,fetchImpl:e.io?.fetch,now:e.io?.now}),c=s.cliSession?.refreshCredential??s.cliSession?.refreshToken;if(!X(s.accessToken)||!X(c))throw new n(`UNAUTHORIZED`,`Device authorization did not return CLI credentials.`);let l=new Date(e.io?.now?.()??Date.now()).toISOString(),u={version:1,id:s.cliSession?.id??`cli-${Date.now().toString(36)}`,cloudBaseUrl:i,workspaceId:s.cliSession?.workspaceId,accountId:s.cliSession?.accountId,name:s.cliSession?.name,refreshCredential:c,createdAt:l,expiresAt:s.cliSession?.expiresAt};return vn({stateDir:e.stateDir,session:u}),{accessToken:s.accessToken,expiresAt:s.expiresAt,session:u}}function _n(e){let t=G(e.stateDir);if(!E.existsSync(t))return null;try{let e=JSON.parse(E.readFileSync(t,`utf8`));return e.version!==1||!X(e.id)||!X(e.cloudBaseUrl)||!X(e.refreshCredential)||!X(e.createdAt)?null:e}catch{return null}}function vn(e){let t=G(e.stateDir);E.mkdirSync(D.dirname(t),{recursive:!0,mode:448}),E.writeFileSync(t,`${JSON.stringify(e.session,null,2)}\n`,{mode:384});try{E.chmodSync(t,384)}catch{}}function yn(e){let t=G(e.stateDir);return E.existsSync(t)?(E.rmSync(t,{force:!0}),!0):!1}function G(e){return D.join(e,`auth`,`cli-session.json`)}function bn(e){let t=_n({stateDir:e.stateDir});return t?{authenticated:!0,source:`cli-session`,sessionId:t.id,cloudBaseUrl:t.cloudBaseUrl,workspaceId:t.workspaceId,accountId:t.accountId,name:t.name,createdAt:t.createdAt,expiresAt:t.expiresAt,expired:Mn(t.expiresAt,e.now)}:{authenticated:!1,source:`none`}}async function xn(e){let t=_n({stateDir:e.stateDir});return!t||Mn(t.expiresAt,e.io?.now)?null:{accessToken:(await Sn({session:t,flags:e.flags,env:e.env,io:e.io})).accessToken,cloudBaseUrl:J(e.env,t.cloudBaseUrl)}}async function Sn(e){let t=await K({baseUrl:J(e.env,e.session.cloudBaseUrl),pathName:`/api/control-plane/cli-session/refresh`,body:{refreshCredential:e.session.refreshCredential,tenant:e.flags.tenant,runId:e.flags.runId,daemonBaseUrl:e.flags.daemonBaseUrl,session:e.flags.session},fetchImpl:e.io?.fetch});if(X(t.accessToken))return{accessToken:t.accessToken,expiresAt:t.expiresAt};throw t.status===`revoked`||t.error===`revoked`?new n(`UNAUTHORIZED`,`Stored cloud CLI session was revoked.`,{hint:`Run agent-device auth login again, or set AGENT_DEVICE_DAEMON_AUTH_TOKEN.`,status:t.status,error:t.error}):new n(`UNAUTHORIZED`,`Failed to refresh CLI session.`,{hint:`Run agent-device auth login again, or set AGENT_DEVICE_DAEMON_AUTH_TOKEN.`,status:t.status,error:t.error})}async function Cn(e){let t=e.now??Date.now,r=Math.min((e.expiresIn??600)*1e3,6e5),i=t()+r,a=Math.max(pn,(e.interval??5)*1e3);for(;t()<i;){let t=await K({baseUrl:e.cloudBaseUrl,pathName:`/api/control-plane/device-auth/poll`,body:{deviceCode:e.deviceCode},fetchImpl:e.fetchImpl});if(t.status===`approved`||X(t.accessToken))return t;if(t.status===`slow_down`||t.error===`slow_down`)a+=pn;else if(t.status!==`authorization_pending`&&t.error!==`authorization_pending`)throw new n(`UNAUTHORIZED`,`Device authorization was not approved.`,{status:t.status,error:t.error});await Nn(a)}throw new n(`TIMEOUT`,`Device authorization expired before approval.`)}async function K(e){let t=await(e.fetchImpl??fetch)(new URL(e.pathName,e.baseUrl),{method:`POST`,headers:{"content-type":`application/json`},body:JSON.stringify(e.body),signal:AbortSignal.timeout(15e3)});return await fn(t,{invalidJsonMessage:`Cloud auth endpoint returned invalid JSON (${t.status}).`,rejectedMessage:`Cloud auth endpoint rejected the request.`})}async function wn(e){if(!X(e.deviceCode))throw q(`deviceCode`);if(!X(e.userCode))throw q(`userCode`);if(!X(e.verificationUri))throw q(`verificationUri`);let{isSafeBrowserUrl:t}=await import(`./browser-launch.js`);if(!t(e.verificationUri))throw q(`verificationUri`);if(X(e.verificationUriComplete)&&!t(e.verificationUriComplete))throw q(`verificationUriComplete`)}function q(e){return new n(`COMMAND_FAILED`,`Cloud auth start returned an unusable response.`,{field:e})}function Tn(e,t){let n=t?.stdinIsTTY??process.stdin.isTTY,r=t?.stdoutIsTTY??process.stdout.isTTY;return En(e)||!n||!r?`non-interactive`:Dn(e)?`device-code`:`local-browser`}function En(e){return e.CI===`true`||e.GITHUB_ACTIONS===`true`||e.BUILDKITE===`true`}function Dn(e){return!!(e.SSH_TTY||e.SSH_CONNECTION||e.CODESPACES===`true`||e.GITPOD_WORKSPACE_ID||e.REMOTE_CONTAINERS===`true`)}function On(e,t){let r=J(t);return new n(`UNAUTHORIZED`,`${e} cannot perform interactive login in CI or a non-interactive shell.`,{hint:`Create a service/API token: ${new URL(`/api-keys`,r).toString()} Then set AGENT_DEVICE_DAEMON_AUTH_TOKEN=adc_live_...`})}function J(e,t){let r=e.AGENT_DEVICE_CLOUD_BASE_URL??t??`https://cloud.agent-device.dev`;try{return new URL(r).toString().replace(/\/+$/,``)}catch(e){throw new n(`INVALID_ARGS`,`Invalid AGENT_DEVICE_CLOUD_BASE_URL.`,{cloudBaseUrl:r},e instanceof Error?e:void 0)}}function kn(e,t){if(t.AGENT_DEVICE_CLOUD_AUTH===`1`||t.AGENT_DEVICE_CLOUD_AUTH===`true`||X(t.AGENT_DEVICE_CLOUD_BASE_URL))return!0;try{let t=new URL(e).hostname.toLowerCase();return t===`agent-device.dev`||t.endsWith(`.agent-device.dev`)}catch{return!1}}function An(e,t){let n=new URL(e);return n.searchParams.set(`user_code`,t),n.toString()}async function jn(e,t){if(t?.openBrowser){await t.openBrowser(e);return}let{openUrlInBrowser:n}=await import(`./browser-launch.js`);await n(e)||Y(t,`Open this URL on your machine:\n${e}\n`)}function Y(e,t){(e?.stderr??process.stderr).write(t)}function Mn(e,t){if(!e)return!1;let n=Date.parse(e);return!Number.isFinite(n)||n<=(t?.()??Date.now())}function X(e){return typeof e==`string`&&e.trim().length>0}async function Nn(e){await new Promise(t=>setTimeout(t,e))}var Pn=e({runCli:()=>$});const Z=(e,t={})=>import(`./error.js`).then(e=>e.t).then(({printHumanError:n})=>n(e,t)),Q=e=>import(`./json.js`).then(({printJson:t})=>t(e)),Fn={sendToDaemon:Se({onReplaced:In}),transportForHost:e=>Se({host:e,onReplaced:In})};function In(e){let{stateDir:t,previous:n,reason:r}=e,i=n.version?`pid ${n.pid}, v${n.version}`:`pid ${n.pid}`;process.stderr.write(r===`unreachable`?`Replaced unreachable daemon (${i}) in ${t}.\n`:`Replaced idle daemon (${i}) in ${t}: it did not match this client.\n`)}const Ln=new Set([`launchUrl`,`kind`,`metroBearerToken`,`metroKind`,`metroListenHost`,`metroNoInstallDeps`,`metroNoReuseExisting`,`metroPreparePort`,`metroProbeTimeoutMs`,`metroProjectRoot`,`metroProxyBaseUrl`,`metroPublicBaseUrl`,`metroRuntimeFile`,`metroStartupTimeoutMs`,`metroStatusHost`]),Rn=new Set([`connect`,`connection`,`close`,`daemon`,`plugins`,`device`,`disconnect`,`metro`,`proxy`,`session`,`takeover`]);async function $(e,t=Fn,n=ne(process)){await ae({host:n,requestEnv:void 0},async()=>await zn(e,t,n))}async function zn(e,t,n){let r=xe(t,n),i=ie(),a=we(),o=$n(e),s=e.includes(`--json`),c=gr(e)??n.env.AGENT_DEVICE_SESSION??`default`;await ce({session:c,requestId:i,command:e[0],debug:o},async()=>{let{parsed:t,command:c,positionals:l}=await Vn(e,{host:n,version:a,jsonRequested:s,debugEnabled:o}),u=nr(c,t.providedFlags),d=await Hn(t,{host:n,command:c,positionals:l,requestId:i,debugOutputEnabled:u});Bn(d.effectiveFlags);let f=null;try{if(c===`react-devtools`){await w(await Un(d));return}if(c===`web`){let{runWebCommand:e}=await import(`./web.js`);await w(await e(l,{flags:d.effectiveFlags,stateDir:d.daemonPaths.baseDir,host:n}));return}if(Ae({command:c,currentVersion:a,stateDir:d.daemonPaths.baseDir,flags:d.effectiveFlags}),await Wn(d,r),Bn(d.effectiveFlags),c===`cdp`){await w(await kt(l,{flags:d.effectiveFlags,runtime:d.resolvedRuntime,cwd:n.cwd,env:n.env}));return}f=Kn(d);let e=await qn(d),t=gt();await Jn(d,me(Gn(d),{host:d.host,transport:fr({host:n,command:c,flags:d.effectiveFlags,replayTestReporterRuntime:e,commandProgress:t,transport:r})}),e,t)}catch(e){await Yn(e,d,f)}finally{f&&f()}})}function Bn(e){e.daemonAuthToken&&se(e.daemonAuthToken)}async function Vn(e,t){let r;try{r=Vt(e,{cwd:t.host.cwd,env:t.host.env})}catch(e){b({level:`error`,phase:`cli_parse_failed`,data:{error:e instanceof Error?e.message:String(e)}});let n=i(e,{diagnosticId:v().diagnosticId,logPath:y({force:!0})?.path});return t.jsonRequested?await Q({success:!1,error:n}):await Z(n,{showDetails:t.debugEnabled}),w(1)}for(let e of r.warnings)process.stderr.write(`Warning: ${e}\n`);if(r.flags.version)return process.stdout.write(`${t.version}\n`),w(0);let a=r.command===`help`,o=r.flags.help;if(a||o){if(a&&r.positionals.length>1)return await Z(new n(`INVALID_ARGS`,`help accepts at most one command.`)),w(1);let e=a?r.positionals[0]:r.command;if(!e)return process.stdout.write(`${await M()}\n`),w(0);let t=await ht(e);return t?(process.stdout.write(t),w(0)):(await Z(new n(`INVALID_ARGS`,er(e))),process.stdout.write(`${await M()}\n`),w(1))}return r.command?{parsed:r,command:r.command,positionals:r.positionals}:(process.stdout.write(`${await M()}\n`),w(1))}async function Hn(e,n){let r=new Set(e.providedFlags.map(e=>e.key));try{let t=Pt({env:n.host.env,policyOverrides:e.flags,configuredPlatform:e.flags.platform,configuredSession:e.flags.session}),i=t.lockPolicy?{...e.flags}:Nt(e.flags,{env:n.host.env,policyOverrides:e.flags,configuredPlatform:e.flags.platform,configuredSession:e.flags.session}),a=Te(i.stateDir,{env:n.host.env,cwd:n.host.cwd}),o=i.session??`default`,s=ar({host:n.host,command:n.command,explicitFlagKeys:r,stateDir:a.baseDir,session:o,remoteConfig:i.remoteConfig,hasResolvedSession:i.session!==void 0}),c=s?ur(i,s.flags,r):i;return{...n,binding:t,flags:i,daemonPaths:a,sessionName:o,connectionDefaults:s,explicitFlagKeys:r,effectiveFlags:c,resolvedRuntime:s?.runtime,connectionMetadata:s?.connection,parsedBatchSteps:void 0}}catch(r){let a=t(r),o=i(a,{diagnosticId:v().diagnosticId,logPath:y({force:!0})?.path});return e.flags.json?await Q({success:!1,error:o}):await Z(o,{showDetails:n.debugOutputEnabled}),w(1)}}async function Un(e){let{runReactDevtoolsCommand:t}=await import(`./react-devtools.js`);return await t(e.positionals,{flags:e.effectiveFlags,stateDir:e.daemonPaths.baseDir,session:e.effectiveFlags.session??e.sessionName})}async function Wn(e,t){if(e.command===`batch`){if(e.positionals.length>0)throw new n(`INVALID_ARGS`,`batch does not accept positional arguments.`);e.parsedBatchSteps=rr(e.flags)}if(sr(e.command)&&(e.effectiveFlags=(await mn({command:e.command,flags:e.effectiveFlags,stateDir:e.daemonPaths.baseDir,env:e.host.env})).flags),e.effectiveFlags.remoteConfig&&or(e.command)){let n=me(Gn(e),{host:e.host,transport:mr(t)}),{materializeRemoteConnectionForCommand:r}=await import(`./connection-runtime.js`),i=await r({host:e.host,command:e.command,flags:e.effectiveFlags,client:n,runtime:e.resolvedRuntime,positionals:e.positionals,batchSteps:e.parsedBatchSteps,forceRuntimePrepare:dr(e.explicitFlagKeys)});e.effectiveFlags=i.flags,e.resolvedRuntime=i.runtime,e.connectionMetadata=i.connection}cr({command:e.command,flags:e.effectiveFlags,runtime:e.resolvedRuntime,explicitFlagKeys:e.explicitFlagKeys,hadConnectionDefaults:!!e.connectionDefaults})&&process.stderr.write(`Warning: open is using explicit remote daemon or tenant flags without saved Metro runtime hints. React Native apps may launch without bundle/runtime hints; prefer connect --remote-config <path> first or pass --remote-config <path> on this command.
|
|
2
|
-
`)}function Gn(e){let t=e.effectiveFlags,n=e.connectionMetadata;return{session:t.session,requestId:e.requestId,stateDir:t.stateDir,daemonBaseUrl:t.daemonBaseUrl,daemonAuthToken:t.daemonAuthToken,daemonTransport:t.daemonTransport,daemonServerMode:t.daemonServerMode,tenant:t.tenant,sessionIsolation:t.sessionIsolation,runId:t.runId,leaseId:t.leaseId,leaseBackend:t.leaseBackend,leaseProvider:n?.leaseProvider,clientId:n?.clientId,deviceKey:n?.deviceKey,providerApp:t.providerApp,providerOsVersion:t.providerOsVersion,providerDeviceType:t.providerDeviceType,providerProject:t.providerProject,providerBuild:t.providerBuild,providerSessionName:t.providerSessionName,providerDeviceOrientation:t.providerDeviceOrientation,providerGeoLocation:t.providerGeoLocation,providerTimezone:t.providerTimezone,providerAppiumVersion:t.providerAppiumVersion,providerLanguage:t.providerLanguage,providerLocale:t.providerLocale,providerNetworkProfile:t.providerNetworkProfile,providerCustomNetwork:t.providerCustomNetwork,providerNoResignApp:t.providerNoResignApp,awsProjectArn:t.awsProjectArn,awsDeviceArn:t.awsDeviceArn,awsAppArn:t.awsAppArn,awsRegion:t.awsRegion,awsInteractionMode:t.awsInteractionMode,runtime:e.resolvedRuntime,lockPolicy:e.binding.lockPolicy,lockPlatform:e.binding.defaultPlatform,cwd:e.host.cwd,debug:e.debugOutputEnabled,cost:t.cost,responseLevel:t.responseLevel}}function Kn(e){let t=e.effectiveFlags.daemonBaseUrl;return e.debugOutputEnabled&&!e.effectiveFlags.json&&!t?_r(e.daemonPaths.logPath):null}async function qn(e){if(e.command!==`test`)return;let{createReplayTestReporterRuntime:t}=await import(`./reporting.js`);return t({debug:e.debugOutputEnabled,verbose:e.effectiveFlags.verbose,json:e.effectiveFlags.json,reporter:e.effectiveFlags.reporter,reportJunit:e.effectiveFlags.reportJunit})}async function Jn(e,
|
|
1
|
+
import{r as e}from"./rolldown-runtime.js";import{R as t,V as n,d as r,m as i,tt as a}from"./sdk-contracts.js";import{vt as o}from"./tv-remote.js";import{d as s,f as c,s as l,u}from"./sdk-batch-runner.js";import{D as d,O as f,b as p,ht as m,pt as h,vt as g,wt as ee,x as _,yt as te}from"./back-mode.js";import{Ct as ne,_t as v,bt as re,dt as ie,f as ae,gt as oe,nt as se,st as ce,vt as y,yt as b}from"./sdk-io.js";import"./diagnostics.js";import{F as le,I as ue,k as de,u as fe,x as pe}from"./sdk-device.js";import{n as me}from"./agent-device-client.js";import{s as he,t as ge,u as _e}from"./sdk-batch.js";import{t as ve}from"./sdk-remote-config.js";import{G as ye,n as be}from"./command-metadata.js";import"./file.js";import"./command.js";import{i as xe,n as Se}from"./daemon-client.js";import{n as Ce}from"./session-artifact-paths.js";import{a as we}from"./version.js";import{m as Te}from"./daemon-resolution.js";import{n as Ee,r as De}from"./remote-config-core.js";import{r as x,t as Oe}from"./command-schema.js";import{n as S,r as C,t as ke}from"./cli-config.js";import{t as Ae}from"./update-check.js";import{n as je,r as Me,t as Ne}from"./cli-command-aliases.js";import{exitAfterFlush as w}from"./process-exit.js";import T from"node:crypto";import E from"node:fs";import D from"node:path";import{pathToFileURL as Pe}from"node:url";const O=`open <app> --relaunch`,Fe={start:{command:`open`,example:O},restart:{command:`open`,example:O},touch:{command:`press`,example:`press`},input:{command:`fill`,example:`fill`},settext:{command:`fill`,example:`fill`},entertext:{command:`fill`,example:`fill`},screencap:{command:`screenshot`,example:`screenshot`},capture:{command:`screenshot`,example:`screenshot`},dismiss:{command:`keyboard`,example:`keyboard dismiss`},"get-text":{command:`get`,example:`get text`},gettext:{command:`get`,example:`get text`},get_text:{command:`get`,example:`get text`},"open-url":{command:`open`,example:`open <url>`},"close-session":{command:`close`,example:`close`}};function Ie(e){if(e.length<=2)return[];let t=f(),n=t.filter(t=>t.startsWith(e));return n.length>0?n.sort(Le).slice(0,3):Re(e,t)}function Le(e,t){return e.length-t.length||e.localeCompare(t)}function Re(e,t){let n=t.map(t=>({name:t,distance:Be(e,t)})).filter(t=>t.distance<=ze(e));if(n.length===0)return[];let r=Math.min(...n.map(e=>e.distance));return n.filter(e=>e.distance===r).sort((e,t)=>e.name.localeCompare(t.name)).slice(0,3).map(e=>e.name)}function ze(e){return e.length<4?1:e.length<=6?2:3}function Be(e,t){return e===t?0:e.startsWith(t)||t.startsWith(e)?Math.abs(e.length-t.length):Ve(e,t)}function Ve(e,t){let n=e.length+1,r=t.length+1,i=Array.from({length:n},()=>Array(r).fill(0));for(let e=0;e<n;e+=1)i[e][0]=e;for(let e=0;e<r;e+=1)i[0][e]=e;for(let a=1;a<n;a+=1)for(let n=1;n<r;n+=1){let r=e[a-1]===t[n-1]?0:1;i[a][n]=Math.min(i[a-1][n]+1,i[a][n-1]+1,i[a-1][n-1]+r)}return i[n-1][r-1]}function He(e){let t=e.toLowerCase(),n=Fe[t]?.example;if(n)return n;let r=Ie(t);if(r.length!==0)return r.length===1?r[0]:`one of: ${r.join(`, `)}`}const Ue=new Set([`--bundle-id`,`--bundleid`,`--bundle`,`--package`,`--package-name`,`--packagename`,`--app-id`,`--appid`,`--pkg`]),We=new Set([`--session-locked`,`--session-lock-conflicts`]),Ge={"--output":`--out`,"--path":`--out`};function Ke(e,t){let n=e.toLowerCase(),r=Ge[n];if(r&&qe(r,t))return r;let i=Je(n,t);if(i.length!==0)return i.length===1?i[0]:`one of: ${i.join(`, `)}`}function qe(e,t){let n=_().find(t=>t.names.includes(e));return n?C(n.key,t):!1}function Je(e,t){let n=k(e);if(n.length<=2)return[];let r=Ye(t),i=r.filter(e=>k(e).startsWith(n));return i.length>0?i.sort(Le).slice(0,3):Re(n,r.map(e=>k(e))).map(e=>`--${e}`)}function Ye(e){let t=new Set;for(let n of _()){if(!C(n.key,e))continue;let r=n.names[0];r&&t.add(r)}return[...t]}function k(e){return e.replace(/^--?/,``)}function Xe(e,t){let n=e.toLowerCase();if(Ue.has(n))return`Unknown flag: ${e}. The app or bundle id is a positional argument, e.g. ${O}.`;if(We.has(n))return`Unknown flag: ${e}. Use --session-lock reject|strip instead.`;if(n===o.cliToken)return`Unknown flag: ${e}. ${o.migration.screenshot}. ${o.migration.record}.`;let r=Ke(e,t);return r?`Unknown flag: ${e}. Did you mean ${r}?`:`Unknown flag: ${e}`}function A(e){let n={json:!1,help:!1,version:!1},r=null,i=null,a=[],o=[],s=[],c=!0;for(let o=0;o<e.length;o+=1){let l=e[o];if(c&&l===`--`){c=!1;continue}if(!c){r?a.push(l):(i=l,r=N(l));continue}if(et(r)){a.push(l);continue}let u=l.startsWith(`--`),d=l.startsWith(`-`)&&l.length>1;if(!u&&!d){r?a.push(l):(i=l,r=N(l));continue}let[f,p]=u?j(l):[l,void 0];if(Qe(r,f))continue;let m=tt(f,r);if($e(r,m)){a.push(l);continue}if(!m){if(ct(r,a,l)){r?a.push(l):r=l;continue}throw new t(`INVALID_ARGS`,Xe(f,r))}let h=it(m,f,p,e[o+1]);h.consumeNext&&(o+=1);let g=n[m.key];if(m.multiple){let e=Array.isArray(g)?[...g,h.value]:g===void 0?[h.value]:[g,h.value];n[m.key]=e}else n[m.key]=h.value;s.push({key:m.key,token:f})}return Ze(i,n),{command:r,positionals:a,flags:n,warnings:o,providedFlags:s}}function Ze(e,t){if(e)for(let n of Ne(e)?.impliedFlags??[])t[n]=!0}function Qe(e,t){return t===`-c`&&(e===`snapshot`||e===`diff`)}function $e(e,t){return e===`react-devtools`?!t||!C(t.key,e):!1}function et(e){return e===`cdp`}function tt(e,t){let n=_().filter(t=>t.names.includes(e));if(n.length<=1)return n[0]??p(e);if(t){let e=n.find(e=>C(e.key,t));if(e)return e}return p(e)}function nt(e,n){let r=n?.strictFlags??!0,i=[...e.warnings],a=S({json:!1,help:!1,version:!1},n?.defaultFlags??{});if(S(a,e.flags),e.command&&!d(e.command)&&!a.help){let n=He(e.command),r=n?`Unknown command: ${e.command}. Did you mean ${n}?`:`Unknown command: ${e.command}`;throw new t(`INVALID_ARGS`,r)}let o=e.providedFlags.filter(t=>!C(t.key,e.command));if(o.length>0){let n=o.map(e=>e.token),s=mt(e.command,n);if(r)throw new t(`INVALID_ARGS`,s);i.push(s);for(let e of o)delete a[e.key]}let s=ft(e);if(s.length>0){let n=pt(e.command,e.positionals[0],s);if(r)throw new t(`INVALID_ARGS`,n);i.push(n);for(let e of s)delete a[e.key]}for(let t of Object.keys(a))a[t]!==void 0&&(C(t,e.command)||delete a[t]);dt(e,a),rt(e),_e(e.command,a);let c=ut({command:e.command,positionals:e.positionals,flags:a,warnings:i});if(Oe(c.command,c.positionals),c.command===`batch`&&+!!a.steps+ +!!a.stepsFile!=1)throw new t(`INVALID_ARGS`,`batch requires exactly one step source: --steps or --steps-file.`);return c}function rt(e){if(e.command!==`back`)return;let n=e.providedFlags.filter(e=>e.key===`backMode`);if(!(new Set(n.map(e=>e.token)).size<=1))throw new t(`INVALID_ARGS`,`back accepts only one explicit mode flag: use either --in-app or --system.`)}function j(e){let t=e.indexOf(`=`);return t===-1?[e,void 0]:[e.slice(0,t),e.slice(t+1)]}function it(e,n,r,i){if(e.setValue!==void 0){if(r!==void 0)throw new t(`INVALID_ARGS`,`Flag ${n} does not take a value.`);return{value:e.setValue,consumeNext:!1}}if(e.type===`boolean`){if(r!==void 0)throw new t(`INVALID_ARGS`,`Flag ${n} does not take a value.`);return{value:!0,consumeNext:!1}}if(e.type===`booleanOrString`){if(r!==void 0){if(r.trim().length===0)throw new t(`INVALID_ARGS`,`Flag ${n} requires a non-empty value when provided.`);return{value:r,consumeNext:!1}}return i===void 0||ot(i)?{value:!0,consumeNext:!1}:st(i)?{value:i,consumeNext:!0}:{value:!0,consumeNext:!1}}let a=r??i;if(a===void 0||r===void 0&&ot(a))throw new t(`INVALID_ARGS`,`Flag ${n} requires a value.`);if(e.type===`string`)return{value:a,consumeNext:r===void 0};if(e.type===`enum`){if(!e.enumValues?.includes(a))throw new t(`INVALID_ARGS`,`Invalid ${at(n)}: ${a}`);return{value:a,consumeNext:r===void 0}}if(a.trim().length===0)throw new t(`INVALID_ARGS`,`Flag ${n} requires a value.`);let o=Number(a);if(!Number.isFinite(o)||typeof e.min==`number`&&o<e.min||typeof e.max==`number`&&o>e.max)throw new t(`INVALID_ARGS`,`Invalid ${at(n)}: ${a}`);return{value:e.type===`int`?Math.floor(o):o,consumeNext:r===void 0}}function at(e){return e.replace(/^-+/,``)}function ot(e){if(!e.startsWith(`-`)||e===`-`)return!1;let[t]=e.startsWith(`--`)?j(e):[e,void 0];return p(t)!==void 0}function st(e){let t=e.trim();return!t||/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(t)?!1:!!(t.startsWith(`./`)||t.startsWith(`../`)||t.startsWith(`~/`)||t.startsWith(`/`)||t.includes(`/`)||t.includes(`\\`))}function ct(e,t,n){if(!lt(n)||!e)return!1;let r=x(e);if(!r||r.allowsExtraPositionals)return!0;let i=r.positionalArgs??[];return i.length===0?!1:t.length<i.length||i.some(e=>e.includes(`?`))}function lt(e){return/^-\d+(\.\d+)?$/.test(e)}function ut(e){if(e.flags.help)return e;if(e.command===`snapshot`&&e.flags.snapshotDiff){let{snapshotDiff:t,...n}=e.flags;return{command:`diff`,positionals:[`snapshot`,...e.positionals],flags:n,warnings:e.warnings}}return e}function dt(e,t){let n=x(e.command)?.explicitOnlyFlags;if(n===void 0)return;let r=new Set(e.providedFlags.map(e=>e.key));for(let e of n)r.has(e)||delete t[e]}function ft(e){let t=x(e.command)?.flagsByAction,n=e.positionals[0];if(t===void 0||n===void 0||!Object.hasOwn(t,n))return[];let r=t[n];if(r===void 0)return[];let i=new Set(Object.values(t).flat());return e.providedFlags.filter(e=>i.has(e.key)&&!r.includes(e.key))}function pt(e,t,n){return`${e} ${t} does not read ${n.map(e=>e.token).join(`, `)}. Run \`${e} ${t} --help\` for the options it reads.`}function mt(e,t){return e?t.length===1?`Flag ${t[0]} is not supported for command ${e}.`:`Flags ${t.join(`, `)} are not supported for command ${e}.`:t.length===1?`Flag ${t[0]} requires a command that supports it.`:`Flags ${t.join(`, `)} require a command that supports them.`}async function M(){let{buildUsageText:e}=await import(`./cli-help.js`).then(e=>e.n);return e()}async function ht(e){let{buildCommandUsageText:t}=await import(`./cli-help.js`).then(e=>e.n);return t(N(e))}function N(e){let n=Me(e);if(n)throw new t(`INVALID_ARGS`,n);return je(e)}function gt(){return{renderedToStderr:!1}}function _t(e){return t=>{t.type===`command`&&(e.renderedToStderr=!0,process.stderr.write(`${t.message}\n`))}}function vt(e){return be(e)}const yt={connect:async()=>(await import(`./connection.js`)).connectCommand,disconnect:async()=>(await import(`./connection.js`)).disconnectCommand,connection:async()=>(await import(`./connection.js`)).connectionCommand,auth:async()=>(await import(`./auth.js`)).authCommand,plugins:async()=>(await import(`./plugins2.js`)).pluginsCommand,daemon:async()=>(await import(`./daemon.js`)).daemonCommand,device:async()=>(await import(`./device.js`)).deviceCommand,proxy:async()=>(await import(`./proxy.js`)).proxyCommand,takeover:async()=>(await import(`./takeover.js`)).takeoverCommand,replay:async()=>(await import(`./replay2.js`)).replayCommand,screenshot:async()=>(await import(`./screenshot3.js`)).screenshotCommand,diff:async()=>(await import(`./screenshot3.js`)).diffCommand,record:async()=>(await import(`./recording.js`)).recordingCommand};async function bt(e){let t={...e.flags},n=yt[e.command];return n&&await(await n())({...e,flags:t})?!0:vt(e.command)?await xt({...e,command:e.command,flags:t}):!1}async function xt(e){let{runGenericClientBackedCommand:t}=await import(`./generic.js`);return await t(e)}function St(e){return e===`android-instance`||e===`ios-instance`}function Ct(e){return[`exec`,`--yes`,`--package`,`agent-cdp@1.6.1`,`--`,`agent-cdp`,...e]}function wt(e){return e.some(e=>e===`--url`||e.startsWith(`--url=`))}function Tt(e){return e[0]===`target`&&(e[1]===`list`||e[1]===`select`)&&!wt(e)}function Et(e){let t=new URL(e);t.search=``,t.hash=``;let n=t.pathname.replace(/\/+$/,``);return t.pathname=n.endsWith(`/index.bundle`)?n.slice(0,-13)||`/`:n||`/`,t.toString().replace(/\/+$/,``)}function Dt(e){let t=e?.metroPublicBaseUrl?.trim();return t?Et(t):null}function Ot(e,n={}){if(!Tt(e)||!n.flags?.metroProxyBaseUrl||!St(n.flags.leaseBackend))return e;let r=Dt(n.flags);if(!r)throw new t(`INVALID_ARGS`,`cdp remote bridge target discovery requires a React Native dev-server public base URL.`,{hint:`Include metroPublicBaseUrl in the remote config so cdp can reach the local or tunneled Metro/Re.Pack CDP endpoint without bridge proxy authentication.`});return[...e,`--url`,r]}async function kt(e,t){let n=Ot(e,t);return(await se(`npm`,Ct(n),{cwd:t.cwd,env:t.env,allowFailure:!0,onStdoutChunk:e=>{process.stdout.write(e)},onStderrChunk:e=>{process.stderr.write(e)}})).exitCode}const P=`${l} Run agent-device help batch for the commands batch accepts and for runnable step examples.`,At=`${ge} Run agent-device help batch for the commands batch accepts and for runnable step examples.`;function jt(e){let n;try{n=JSON.parse(e)}catch{throw new t(`INVALID_ARGS`,`Batch steps must be valid JSON.`)}if(!Array.isArray(n)||n.length===0)throw new t(`INVALID_ARGS`,`Batch steps must be a non-empty JSON array.`);return n.map((e,t)=>Mt(e,t+1))}function Mt(e,n){let r=c(e,n,P),i=[`positionals`,`flags`].filter(e=>e in r);if(i.length>0){let e=i.map(e=>`"${e}"`).join(`, `);throw new t(`INVALID_ARGS`,`Batch step ${n} uses removed field(s): ${e}. Use {"command":"...","input":{...}}. Example: {"command":"open","input":{"app":"settings","platform":"ios"}}.`,{hint:P})}ye(r,[`command`,`input`,`runtime`],`Batch step ${n}`,P);let a=u(r.runtime,n);return{command:he(r.command,n,At),input:s(r,n,P),...a===void 0?{}:{runtime:a}}}function Nt(e,t){let n=Pt(t),r={...e};return n.defaultPlatform&&r.platform===void 0&&(r.platform=n.defaultPlatform),r}function Pt(e){let{env:t}=e,n=e.inheritedPlatform??e.configuredPlatform??It(t.AGENT_DEVICE_PLATFORM),r=Rt(e.configuredSession??t.AGENT_DEVICE_SESSION);return{defaultPlatform:n,lockPolicy:Ft(e.policyOverrides,t,r)}}function Ft(e,t,n){let r=e?.sessionLock??Lt(t.AGENT_DEVICE_SESSION_LOCK);if(r)return r;if(n)return`reject`}function It(e){if(e===void 0)return;let n=e.trim().toLowerCase();if(n){if(n===`ios`||n===`android`||n===`apple`)return n;throw new t(`INVALID_ARGS`,`Invalid AGENT_DEVICE_PLATFORM: ${e}. Use ios, android, or apple.`)}}function Lt(e){if(e===void 0)return;let n=e.trim().toLowerCase();if(n){if(n===`reject`||n===`strip`)return n;throw new t(`INVALID_ARGS`,`Invalid session lock mode: ${e}. Use reject or strip.`)}}function Rt(e){return typeof e==`string`&&e.trim().length>0}const zt=ve.map(e=>e.key);function F(e){let t={};for(let n of zt){let r=e[n];r!==void 0&&(t[n]=r)}return t}function Bt(e){return e.remoteConfig?{...F(De({configPath:e.remoteConfig,cwd:e.cwd,env:e.env}).profile),remoteConfig:e.remoteConfig}:{}}function Vt(e,t){let n=A(e),{env:r,cwd:i}=t,a=Ht(n.command)?Bt({remoteConfig:n.flags.remoteConfig,cwd:i,env:r}):{},o=S(ke({command:n.command,cwd:i,cliFlags:n.flags,env:r}),a);return{...nt(n,{strictFlags:t?.strictFlags,defaultFlags:o}),providedFlags:n.providedFlags}}function Ht(e){return e!==null}function Ut(e){return I(ue(e),e.target,e.id)}function I(e,t,n){let i=r(e);return{platform:e,target:t,leaseBackend:i,identityFlag:i?fe(e):void 0,id:n}}function Wt(e){return h(e)}function Gt(e){let t=ee(e);if(!(!t||!de(t.platform)||!pe(t.target)))return I(t.platform,t.target,t.id)}function L(e){let t=[e.leaseBackend?i(e.leaseBackend):void 0,e.recordedPlatform].filter(e=>e!==void 0);if(t.some(e=>t.some(t=>le(e,t)))||le(e.requestedPlatform,t[0]??e.recordedPlatform))return{ok:!1,boundPlatform:t[0],requestedPlatform:e.requestedPlatform};let n=[...t,e.requestedPlatform].filter(e=>e!==void 0);return{ok:!0,platform:n.find(e=>e!==`apple`)??n[0]}}function Kt(e,t){return t!==void 0&&e.platform===void 0?!1:L({leaseBackend:e.leaseBackend,recordedPlatform:e.platform,requestedPlatform:t}).ok}function R(e){let t=V(e);if(!E.existsSync(t))return null;let n;try{n=JSON.parse(E.readFileSync(t,`utf8`))}catch(t){return an(e,t),null}return sn(n)?n:(an(e),null)}function qt(e){let t=V({stateDir:e.stateDir,session:e.state.session});E.mkdirSync(D.dirname(t),{recursive:!0}),nn(t,e.state),nn(H(e.stateDir),{session:e.state.session})}function Jt(e){return{baseUrl:rn(e.daemonBaseUrl),transport:e.daemonTransport,serverMode:e.daemonServerMode}}function z(e){E.rmSync(V(e),{force:!0});let t=H(e.stateDir);$t(e.stateDir)===e.session&&E.rmSync(t,{force:!0})}function Yt(e){let n=e.validateRemoteConfigHash??!0,r=e.remoteConfig?Ee({configPath:e.remoteConfig,cwd:e.cwd,env:e.env}):void 0,i=R(e)??(e.allowActiveFallback?U({stateDir:e.stateDir}):null);if(!i||r&&i.remoteConfigPath!==r)return null;if(n&&B(i.remoteConfigPath)!==i.remoteConfigHash)throw new t(`INVALID_ARGS`,`Active remote connection config changed. Run agent-device connect --force to refresh it.`,{remoteConfig:i.remoteConfigPath});let a=tn(i,e),o=m(i);return{runtime:i.runtime,connection:te(o),flags:{...a,remoteConfig:i.remoteConfigPath,daemonBaseUrl:i.daemon?.baseUrl??a.daemonBaseUrl,daemonAuthToken:a.daemonAuthToken,daemonTransport:i.daemon?.transport??a.daemonTransport,daemonServerMode:i.daemon?.serverMode??a.daemonServerMode,...g(o),sessionIsolation:`tenant`,session:i.session,platform:i.platform??a.platform,target:i.target??a.target}}}function Xt(e){return te(m(e))}function Zt(e,t){return{leaseProvider:e.leaseProvider??t.leaseProvider,clientId:e.clientId??t.clientId,deviceKey:e.deviceKey??t.deviceKey}}function Qt(e,t){return!t||(t.leaseProvider===void 0||e.leaseProvider===t.leaseProvider)&&(t.clientId===void 0||e.clientId===t.clientId)}function B(e){try{return T.createHash(`sha256`).update(E.readFileSync(e)).digest(`hex`)}catch(n){throw new t(`INVALID_ARGS`,`Remote config file not found: ${e}`,{cause:n instanceof Error?n.message:String(n)})}}function V(e){return D.join(e.stateDir,`remote-connections`,`${on(e.session)}.json`)}function H(e){return D.join(e,`remote-connections`,`.active-session.json`)}function U(e){let t=$t(e.stateDir);return t?R({stateDir:e.stateDir,session:t}):null}function $t(e){let t=H(e);if(E.existsSync(t))try{let e=JSON.parse(E.readFileSync(t,`utf8`));return typeof e.session==`string`?e.session:void 0}catch{return}}function en(e){if(e)return T.createHash(`sha256`).update(e).digest(`hex`).slice(0,12)}function tn(e,t){try{return De({configPath:e.remoteConfigPath,cwd:t.cwd,env:t.env}).profile}catch(e){if(t.validateRemoteConfigHash===!1)return{};throw e}}function nn(e,t){ie({destination:e,contents:`${JSON.stringify(t,null,2)}\n`,mode:384})}function rn(e){if(!e)return;let t=new URL(e);t.username=``,t.password=``;for(let e of Array.from(t.searchParams.keys()))/(auth|key|password|secret|token)/i.test(e)&&t.searchParams.delete(e);return t.toString().replace(/\/+$/,``)}function an(e,t){v({level:`warn`,phase:`remote_connection_state_invalid`,data:{session:e.session,cause:t instanceof Error?t.message:t?String(t):void 0}}),z(e)}function on(e){let t=e.replaceAll(/[^a-zA-Z0-9._-]/g,`_`);return t?t===e?t:`${t}-${T.createHash(`sha256`).update(e).digest(`hex`).slice(0,8)}`:`default`}function sn(e){if(!e||typeof e!=`object`||Array.isArray(e))return!1;let t=e;return t.version===1&&cn(t,[`session`,`remoteConfigPath`,`remoteConfigHash`,`tenant`,`runId`,`connectedAt`,`updatedAt`])&&ln(t,[`leaseId`,`leaseBackend`,`leaseProvider`,`deviceKey`,`clientId`])&&un(t.daemon)}function cn(e,t){return t.every(t=>typeof e[t]==`string`)}function ln(e,t){return t.every(t=>e[t]===void 0||typeof e[t]==`string`)}function un(e){return e===void 0?!0:!e||typeof e!=`object`||Array.isArray(e)?!1:dn(e)}function dn(e){let t=e;return(t.baseUrl===void 0||typeof t.baseUrl==`string`)&&(t.authToken===void 0||typeof t.authToken==`string`)&&(t.transport===void 0||typeof t.transport==`string`)&&(t.serverMode===void 0||typeof t.serverMode==`string`)}async function fn(e,n){let r=await e.text(),i={};if(r.trim().length>0)try{i=JSON.parse(r)}catch(r){throw new t(`COMMAND_FAILED`,n.invalidJsonMessage,{status:e.status},r instanceof Error?r:void 0)}if(!e.ok)throw new t(`UNAUTHORIZED`,n.rejectedMessage,{status:e.status,response:i});return i}const pn=1e3;async function mn(e){return await hn({command:e.command,flags:e.flags,stateDir:e.stateDir,allowInteractiveLogin:e.command===`connect`&&!e.flags.noLogin,env:e.env})}async function hn(e){let{env:n}=e;if(!e.flags.daemonBaseUrl)return{flags:e.flags,source:`none`};if(X(e.flags.daemonAuthToken))return{flags:e.flags,source:`flag`};if(X(n.AGENT_DEVICE_DAEMON_AUTH_TOKEN))return{flags:e.flags,source:`env`};if(!kn(e.flags.daemonBaseUrl,n))return{flags:e.flags,source:`none`};let r=await xn({stateDir:e.stateDir,flags:e.flags,env:n,io:e.io});if(r)return{flags:{...e.flags,daemonAuthToken:r.accessToken},source:`cli-session`};if(!e.allowInteractiveLogin)throw e.flags.noLogin?new t(`UNAUTHORIZED`,`Remote daemon authentication is required.`,{hint:`Run agent-device auth login, unset --no-login, or set AGENT_DEVICE_DAEMON_AUTH_TOKEN.`}):On(e.command,n);let i=await W({stateDir:e.stateDir,flags:e.flags,env:n,io:e.io});return{flags:{...e.flags,daemonAuthToken:i.accessToken},source:`login`}}async function gn(e){let{env:n}=e;if(X(e.flags.daemonAuthToken))return{accessToken:e.flags.daemonAuthToken,cloudBaseUrl:J(n)};if(X(n.AGENT_DEVICE_DAEMON_AUTH_TOKEN))return{accessToken:n.AGENT_DEVICE_DAEMON_AUTH_TOKEN,cloudBaseUrl:J(n)};let r=await xn({stateDir:e.stateDir,flags:e.flags,env:n,io:e.io});if(r)return{accessToken:r.accessToken,cloudBaseUrl:r.cloudBaseUrl};if(e.flags.noLogin)throw new t(`UNAUTHORIZED`,`Cloud connection profile authentication is required.`,{hint:`Run agent-device auth login, unset --no-login, or set AGENT_DEVICE_DAEMON_AUTH_TOKEN.`});let i=await W({stateDir:e.stateDir,flags:e.flags,env:n,io:e.io,commandLabel:`agent-device connect`});return{accessToken:i.accessToken,cloudBaseUrl:i.session.cloudBaseUrl}}async function W(e){let{env:n}=e,r=Tn(n,e.io);if(r===`non-interactive`)throw On(e.commandLabel??`agent-device connect`,n);let i=J(n),a=await K({baseUrl:i,pathName:`/api/control-plane/device-auth/start`,body:{client:`agent-device`,tenant:e.flags.tenant,runId:e.flags.runId,daemonBaseUrl:e.flags.daemonBaseUrl,session:e.flags.session},fetchImpl:e.io?.fetch});await wn(a);let o=X(a.verificationUriComplete)?a.verificationUriComplete:a.verificationUri;if(r===`local-browser`)Y(e.io,`Opening ${a.verificationUri}...\n`),await jn(o,e.io);else{let t=An(a.verificationUri,a.userCode);Y(e.io,`Open this URL on your machine:\n${t}\n\nWaiting for approval for 10 minutes...\n`)}let s=await Cn({cloudBaseUrl:i,deviceCode:a.deviceCode,expiresIn:a.expiresIn,interval:a.interval,fetchImpl:e.io?.fetch,now:e.io?.now}),c=s.cliSession?.refreshCredential??s.cliSession?.refreshToken;if(!X(s.accessToken)||!X(c))throw new t(`UNAUTHORIZED`,`Device authorization did not return CLI credentials.`);let l=new Date(e.io?.now?.()??Date.now()).toISOString(),u={version:1,id:s.cliSession?.id??`cli-${Date.now().toString(36)}`,cloudBaseUrl:i,workspaceId:s.cliSession?.workspaceId,accountId:s.cliSession?.accountId,name:s.cliSession?.name,refreshCredential:c,createdAt:l,expiresAt:s.cliSession?.expiresAt};return vn({stateDir:e.stateDir,session:u}),{accessToken:s.accessToken,expiresAt:s.expiresAt,session:u}}function _n(e){let t=G(e.stateDir);if(!E.existsSync(t))return null;try{let e=JSON.parse(E.readFileSync(t,`utf8`));return e.version!==1||!X(e.id)||!X(e.cloudBaseUrl)||!X(e.refreshCredential)||!X(e.createdAt)?null:e}catch{return null}}function vn(e){let t=G(e.stateDir);E.mkdirSync(D.dirname(t),{recursive:!0,mode:448}),E.writeFileSync(t,`${JSON.stringify(e.session,null,2)}\n`,{mode:384});try{E.chmodSync(t,384)}catch{}}function yn(e){let t=G(e.stateDir);return E.existsSync(t)?(E.rmSync(t,{force:!0}),!0):!1}function G(e){return D.join(e,`auth`,`cli-session.json`)}function bn(e){let t=_n({stateDir:e.stateDir});return t?{authenticated:!0,source:`cli-session`,sessionId:t.id,cloudBaseUrl:t.cloudBaseUrl,workspaceId:t.workspaceId,accountId:t.accountId,name:t.name,createdAt:t.createdAt,expiresAt:t.expiresAt,expired:Mn(t.expiresAt,e.now)}:{authenticated:!1,source:`none`}}async function xn(e){let t=_n({stateDir:e.stateDir});return!t||Mn(t.expiresAt,e.io?.now)?null:{accessToken:(await Sn({session:t,flags:e.flags,env:e.env,io:e.io})).accessToken,cloudBaseUrl:J(e.env,t.cloudBaseUrl)}}async function Sn(e){let n=await K({baseUrl:J(e.env,e.session.cloudBaseUrl),pathName:`/api/control-plane/cli-session/refresh`,body:{refreshCredential:e.session.refreshCredential,tenant:e.flags.tenant,runId:e.flags.runId,daemonBaseUrl:e.flags.daemonBaseUrl,session:e.flags.session},fetchImpl:e.io?.fetch});if(X(n.accessToken))return{accessToken:n.accessToken,expiresAt:n.expiresAt};throw n.status===`revoked`||n.error===`revoked`?new t(`UNAUTHORIZED`,`Stored cloud CLI session was revoked.`,{hint:`Run agent-device auth login again, or set AGENT_DEVICE_DAEMON_AUTH_TOKEN.`,status:n.status,error:n.error}):new t(`UNAUTHORIZED`,`Failed to refresh CLI session.`,{hint:`Run agent-device auth login again, or set AGENT_DEVICE_DAEMON_AUTH_TOKEN.`,status:n.status,error:n.error})}async function Cn(e){let n=e.now??Date.now,r=Math.min((e.expiresIn??600)*1e3,6e5),i=n()+r,a=Math.max(pn,(e.interval??5)*1e3);for(;n()<i;){let n=await K({baseUrl:e.cloudBaseUrl,pathName:`/api/control-plane/device-auth/poll`,body:{deviceCode:e.deviceCode},fetchImpl:e.fetchImpl});if(n.status===`approved`||X(n.accessToken))return n;if(n.status===`slow_down`||n.error===`slow_down`)a+=pn;else if(n.status!==`authorization_pending`&&n.error!==`authorization_pending`)throw new t(`UNAUTHORIZED`,`Device authorization was not approved.`,{status:n.status,error:n.error});await Nn(a)}throw new t(`TIMEOUT`,`Device authorization expired before approval.`)}async function K(e){let t=await(e.fetchImpl??fetch)(new URL(e.pathName,e.baseUrl),{method:`POST`,headers:{"content-type":`application/json`},body:JSON.stringify(e.body),signal:AbortSignal.timeout(15e3)});return await fn(t,{invalidJsonMessage:`Cloud auth endpoint returned invalid JSON (${t.status}).`,rejectedMessage:`Cloud auth endpoint rejected the request.`})}async function wn(e){if(!X(e.deviceCode))throw q(`deviceCode`);if(!X(e.userCode))throw q(`userCode`);if(!X(e.verificationUri))throw q(`verificationUri`);let{isSafeBrowserUrl:t}=await import(`./browser-launch.js`);if(!t(e.verificationUri))throw q(`verificationUri`);if(X(e.verificationUriComplete)&&!t(e.verificationUriComplete))throw q(`verificationUriComplete`)}function q(e){return new t(`COMMAND_FAILED`,`Cloud auth start returned an unusable response.`,{field:e})}function Tn(e,t){let n=t?.stdinIsTTY??process.stdin.isTTY,r=t?.stdoutIsTTY??process.stdout.isTTY;return En(e)||!n||!r?`non-interactive`:Dn(e)?`device-code`:`local-browser`}function En(e){return e.CI===`true`||e.GITHUB_ACTIONS===`true`||e.BUILDKITE===`true`}function Dn(e){return!!(e.SSH_TTY||e.SSH_CONNECTION||e.CODESPACES===`true`||e.GITPOD_WORKSPACE_ID||e.REMOTE_CONTAINERS===`true`)}function On(e,n){let r=J(n);return new t(`UNAUTHORIZED`,`${e} cannot perform interactive login in CI or a non-interactive shell.`,{hint:`Create a service/API token: ${new URL(`/api-keys`,r).toString()} Then set AGENT_DEVICE_DAEMON_AUTH_TOKEN=adc_live_...`})}function J(e,n){let r=e.AGENT_DEVICE_CLOUD_BASE_URL??n??`https://cloud.agent-device.dev`;try{return new URL(r).toString().replace(/\/+$/,``)}catch(e){throw new t(`INVALID_ARGS`,`Invalid AGENT_DEVICE_CLOUD_BASE_URL.`,{cloudBaseUrl:r},e instanceof Error?e:void 0)}}function kn(e,t){if(t.AGENT_DEVICE_CLOUD_AUTH===`1`||t.AGENT_DEVICE_CLOUD_AUTH===`true`||X(t.AGENT_DEVICE_CLOUD_BASE_URL))return!0;try{let t=new URL(e).hostname.toLowerCase();return t===`agent-device.dev`||t.endsWith(`.agent-device.dev`)}catch{return!1}}function An(e,t){let n=new URL(e);return n.searchParams.set(`user_code`,t),n.toString()}async function jn(e,t){if(t?.openBrowser){await t.openBrowser(e);return}let{openUrlInBrowser:n}=await import(`./browser-launch.js`);await n(e)||Y(t,`Open this URL on your machine:\n${e}\n`)}function Y(e,t){(e?.stderr??process.stderr).write(t)}function Mn(e,t){if(!e)return!1;let n=Date.parse(e);return!Number.isFinite(n)||n<=(t?.()??Date.now())}function X(e){return typeof e==`string`&&e.trim().length>0}async function Nn(e){await new Promise(t=>setTimeout(t,e))}var Pn=e({runCli:()=>$});const Z=(e,t={})=>import(`./error.js`).then(e=>e.t).then(({printHumanError:n})=>n(e,t)),Q=e=>import(`./json.js`).then(({printJson:t})=>t(e)),Fn={sendToDaemon:Se({onReplaced:In}),transportForHost:e=>Se({host:e,onReplaced:In})};function In(e){let{stateDir:t,previous:n,reason:r}=e,i=n.version?`pid ${n.pid}, v${n.version}`:`pid ${n.pid}`;process.stderr.write(r===`unreachable`?`Replaced unreachable daemon (${i}) in ${t}.\n`:`Replaced idle daemon (${i}) in ${t}: it did not match this client.\n`)}const Ln=new Set([`launchUrl`,`kind`,`metroBearerToken`,`metroKind`,`metroListenHost`,`metroNoInstallDeps`,`metroNoReuseExisting`,`metroPreparePort`,`metroProbeTimeoutMs`,`metroProjectRoot`,`metroProxyBaseUrl`,`metroPublicBaseUrl`,`metroRuntimeFile`,`metroStartupTimeoutMs`,`metroStatusHost`]),Rn=new Set([`connect`,`connection`,`close`,`daemon`,`plugins`,`device`,`disconnect`,`metro`,`proxy`,`session`,`takeover`]);async function $(e,t=Fn,n=ae(process)){await ce({host:n,requestEnv:void 0},async()=>await zn(e,t,n))}async function zn(e,t,n){let r=xe(t,n),i=oe(),a=we(),o=$n(e),s=e.includes(`--json`),c=gr(e)??n.env.AGENT_DEVICE_SESSION??`default`;await ne({session:c,requestId:i,command:e[0],debug:o},async()=>{let{parsed:t,command:c,positionals:l}=await Vn(e,{host:n,version:a,jsonRequested:s,debugEnabled:o}),u=nr(c,t.providedFlags),d=await Hn(t,{host:n,command:c,positionals:l,requestId:i,debugOutputEnabled:u});Bn(d.effectiveFlags);let f=null;try{if(c===`react-devtools`){await w(await Un(d));return}if(c===`web`){let{runWebCommand:e}=await import(`./web.js`);await w(await e(l,{flags:d.effectiveFlags,stateDir:d.daemonPaths.baseDir,host:n}));return}if(Ae({command:c,currentVersion:a,stateDir:d.daemonPaths.baseDir,flags:d.effectiveFlags}),await Wn(d,r),Bn(d.effectiveFlags),c===`cdp`){await w(await kt(l,{flags:d.effectiveFlags,runtime:d.resolvedRuntime,cwd:n.cwd,env:n.env}));return}f=Kn(d);let e=await qn(d),t=gt();await Jn(d,me(Gn(d),{host:d.host,transport:fr({host:n,command:c,flags:d.effectiveFlags,replayTestReporterRuntime:e,commandProgress:t,transport:r})}),e,t)}catch(e){await Yn(e,d,f)}finally{f&&f()}})}function Bn(e){e.daemonAuthToken&&re(e.daemonAuthToken)}async function Vn(e,n){let r;try{r=Vt(e,{cwd:n.host.cwd,env:n.host.env})}catch(e){v({level:`error`,phase:`cli_parse_failed`,data:{error:e instanceof Error?e.message:String(e)}});let t=a(e,{diagnosticId:b().diagnosticId,logPath:y({force:!0})?.path});return n.jsonRequested?await Q({success:!1,error:t}):await Z(t,{showDetails:n.debugEnabled}),w(1)}for(let e of r.warnings)process.stderr.write(`Warning: ${e}\n`);if(r.flags.version)return process.stdout.write(`${n.version}\n`),w(0);let i=r.command===`help`,o=r.flags.help;if(i||o){if(i&&r.positionals.length>1)return await Z(new t(`INVALID_ARGS`,`help accepts at most one command.`)),w(1);let e=i?r.positionals[0]:r.command;if(!e)return process.stdout.write(`${await M()}\n`),w(0);let n=await ht(e);return n?(process.stdout.write(n),w(0)):(await Z(new t(`INVALID_ARGS`,er(e))),process.stdout.write(`${await M()}\n`),w(1))}return r.command?{parsed:r,command:r.command,positionals:r.positionals}:(process.stdout.write(`${await M()}\n`),w(1))}async function Hn(e,t){let r=new Set(e.providedFlags.map(e=>e.key));try{let n=Pt({env:t.host.env,policyOverrides:e.flags,configuredPlatform:e.flags.platform,configuredSession:e.flags.session}),i=n.lockPolicy?{...e.flags}:Nt(e.flags,{env:t.host.env,policyOverrides:e.flags,configuredPlatform:e.flags.platform,configuredSession:e.flags.session}),a=Te(i.stateDir,{env:t.host.env,cwd:t.host.cwd}),o=i.session??`default`,s=ar({host:t.host,command:t.command,explicitFlagKeys:r,stateDir:a.baseDir,session:o,remoteConfig:i.remoteConfig,hasResolvedSession:i.session!==void 0}),c=s?ur(i,s.flags,r):i;return{...t,binding:n,flags:i,daemonPaths:a,sessionName:o,connectionDefaults:s,explicitFlagKeys:r,effectiveFlags:c,resolvedRuntime:s?.runtime,connectionMetadata:s?.connection,parsedBatchSteps:void 0}}catch(r){let i=n(r),o=a(i,{diagnosticId:b().diagnosticId,logPath:y({force:!0})?.path});return e.flags.json?await Q({success:!1,error:o}):await Z(o,{showDetails:t.debugOutputEnabled}),w(1)}}async function Un(e){let{runReactDevtoolsCommand:t}=await import(`./react-devtools.js`);return await t(e.positionals,{flags:e.effectiveFlags,stateDir:e.daemonPaths.baseDir,session:e.effectiveFlags.session??e.sessionName})}async function Wn(e,n){if(e.command===`batch`){if(e.positionals.length>0)throw new t(`INVALID_ARGS`,`batch does not accept positional arguments.`);e.parsedBatchSteps=rr(e.flags)}if(sr(e.command)&&(e.effectiveFlags=(await mn({command:e.command,flags:e.effectiveFlags,stateDir:e.daemonPaths.baseDir,env:e.host.env})).flags),e.effectiveFlags.remoteConfig&&or(e.command)){let t=me(Gn(e),{host:e.host,transport:mr(n)}),{materializeRemoteConnectionForCommand:r}=await import(`./connection-runtime.js`),i=await r({host:e.host,command:e.command,flags:e.effectiveFlags,client:t,runtime:e.resolvedRuntime,positionals:e.positionals,batchSteps:e.parsedBatchSteps,forceRuntimePrepare:dr(e.explicitFlagKeys)});e.effectiveFlags=i.flags,e.resolvedRuntime=i.runtime,e.connectionMetadata=i.connection}cr({command:e.command,flags:e.effectiveFlags,runtime:e.resolvedRuntime,explicitFlagKeys:e.explicitFlagKeys,hadConnectionDefaults:!!e.connectionDefaults})&&process.stderr.write(`Warning: open is using explicit remote daemon or tenant flags without saved Metro runtime hints. React Native apps may launch without bundle/runtime hints; prefer connect --remote-config <path> first or pass --remote-config <path> on this command.
|
|
2
|
+
`)}function Gn(e){let t=e.effectiveFlags,n=e.connectionMetadata;return{session:t.session,requestId:e.requestId,stateDir:t.stateDir,daemonBaseUrl:t.daemonBaseUrl,daemonAuthToken:t.daemonAuthToken,daemonTransport:t.daemonTransport,daemonServerMode:t.daemonServerMode,tenant:t.tenant,sessionIsolation:t.sessionIsolation,runId:t.runId,leaseId:t.leaseId,leaseBackend:t.leaseBackend,leaseProvider:n?.leaseProvider,clientId:n?.clientId,deviceKey:n?.deviceKey,providerApp:t.providerApp,providerOsVersion:t.providerOsVersion,providerDeviceType:t.providerDeviceType,providerProject:t.providerProject,providerBuild:t.providerBuild,providerSessionName:t.providerSessionName,providerDeviceOrientation:t.providerDeviceOrientation,providerGeoLocation:t.providerGeoLocation,providerTimezone:t.providerTimezone,providerAppiumVersion:t.providerAppiumVersion,providerLanguage:t.providerLanguage,providerLocale:t.providerLocale,providerNetworkProfile:t.providerNetworkProfile,providerCustomNetwork:t.providerCustomNetwork,providerNoResignApp:t.providerNoResignApp,awsProjectArn:t.awsProjectArn,awsDeviceArn:t.awsDeviceArn,awsAppArn:t.awsAppArn,awsRegion:t.awsRegion,awsInteractionMode:t.awsInteractionMode,runtime:e.resolvedRuntime,lockPolicy:e.binding.lockPolicy,lockPlatform:e.binding.defaultPlatform,cwd:e.host.cwd,debug:e.debugOutputEnabled,cost:t.cost,responseLevel:t.responseLevel}}function Kn(e){let t=e.effectiveFlags.daemonBaseUrl;return e.debugOutputEnabled&&!e.effectiveFlags.json&&!t?_r(e.daemonPaths.logPath):null}async function qn(e){if(e.command!==`test`)return;let{createReplayTestReporterRuntime:t}=await import(`./reporting.js`);return t({debug:e.debugOutputEnabled,verbose:e.effectiveFlags.verbose,json:e.effectiveFlags.json,reporter:e.effectiveFlags.reporter,reportJunit:e.effectiveFlags.reportJunit})}async function Jn(e,n,r,i){let{command:a,positionals:o,effectiveFlags:s}=e;if(a===`batch`){if(!e.parsedBatchSteps)throw new t(`INVALID_ARGS`,`batch requires --steps or --steps-file.`);let c=e.parsedBatchSteps.map((t,n)=>({...t,input:e.binding.lockPolicy&&e.flags.platform===void 0?{...t.input}:Nt(t.input,{env:e.host.env,policyOverrides:s,configuredPlatform:s.platform,configuredSession:s.session,inheritedPlatform:s.platform})}));if(await bt({host:e.host,command:a,positionals:o,flags:{...s,batchSteps:c},client:n,debug:e.debugOutputEnabled,replayTestReporterRuntime:r,commandProgress:i}))return}else if(a===`runtime`)throw new t(`INVALID_ARGS`,`runtime command was removed. Use connect --remote-config <path> for remote runs, or metro prepare --remote-config <path> for inspection.`);else if(await bt({host:e.host,command:a,positionals:o,flags:s,client:n,debug:e.debugOutputEnabled,replayTestReporterRuntime:r,commandProgress:i}))return;throw new t(`INVALID_ARGS`,tr(a))}async function Yn(e,t,r){let i=n(e),o=a(i,{diagnosticId:b().diagnosticId,logPath:y({force:!0})?.path});if(t.command===`close`&&ir(i)){t.effectiveFlags.json&&await Q({success:!0,data:{closed:`session`,source:`no-daemon`}});return}t.effectiveFlags.json?await Q({success:!1,error:o}):(await Z(o,{showDetails:t.debugOutputEnabled}),t.debugOutputEnabled&&Zn(t,o)),r&&r(),await w(1)}const Xn=64e3;function Zn(e,t){if(!e.effectiveFlags.daemonBaseUrl){Qn(`daemon log`,e.daemonPaths.logPath);return}let n=t.diagnosticsRecord;n&&Qn(`remote diagnostics`,Ce(e.daemonPaths.baseDir,n))}function Qn(e,t){try{if(E.existsSync(t)){let n=E.readFileSync(t,`utf8`).split(`
|
|
3
3
|
`),r=n.slice(Math.max(0,n.length-200)).join(`
|
|
4
|
-
`);r.length>Xn&&(r=r.slice(r.length-Xn)),r.trim().length>0&&process.stderr.write(`\n[${e}]\n${r}\n`)}}catch{}}function $n(e){try{let t=A(e);return nr(t.command??``,t.providedFlags)}catch{return e.includes(`--debug`)||e.includes(`-v`)||e.includes(`--verbose`)}}function er(e){let t=He(e);return t?`Unknown command: ${e}. Did you mean ${t}?`:`Unknown command: ${e}`}function tr(e){return d(e)?(
|
|
4
|
+
`);r.length>Xn&&(r=r.slice(r.length-Xn)),r.trim().length>0&&process.stderr.write(`\n[${e}]\n${r}\n`)}}catch{}}function $n(e){try{let t=A(e);return nr(t.command??``,t.providedFlags)}catch{return e.includes(`--debug`)||e.includes(`-v`)||e.includes(`--verbose`)}}function er(e){let t=He(e);return t?`Unknown command: ${e}. Did you mean ${t}?`:`Unknown command: ${e}`}function tr(e){return d(e)?(v({level:`error`,phase:`cli_known_command_unhandled`,data:{command:e}}),`Command is registered but no CLI handler accepted it: ${e}`):`Unknown command: ${e}`}function nr(e,t){return t.some(t=>t.key===`verbose`&&(t.token===`--debug`||t.token===`-v`||e!==`test`))}function rr(e){let n=``;if(e.steps)n=e.steps;else if(e.stepsFile)try{n=E.readFileSync(e.stepsFile,`utf8`)}catch(n){let r=n instanceof Error?n.message:String(n);throw new t(`INVALID_ARGS`,`Failed to read --steps-file ${e.stepsFile}: ${r}`)}return jt(n)}function ir(e){return e.code===`COMMAND_FAILED`?e.details?.kind===`daemon_startup_failed`?!0:e.message.toLowerCase().includes(`failed to start daemon`)?typeof e.details?.infoPath==`string`||typeof e.details?.lockPath==`string`:!1:!1}function ar(e){return e.command===`connect`||e.command===`connection`||e.command===`daemon`||e.command===`plugins`||e.command===`proxy`?null:Yt({stateDir:e.stateDir,session:e.session,remoteConfig:e.remoteConfig,cwd:e.host.cwd,env:e.host.env,allowActiveFallback:!e.explicitFlagKeys.has(`session`)&&(!e.remoteConfig||e.command===`disconnect`||!e.hasResolvedSession),validateRemoteConfigHash:e.command!==`disconnect`})}function or(e){return!Rn.has(e)}function sr(e){return e!==`auth`&&e!==`connection`&&e!==`daemon`&&e!==`plugins`&&e!==`device`&&e!==`proxy`}function cr(e){return e.command!==`open`||e.runtime||e.flags.bundleUrl||e.flags.metroHost||e.flags.metroPort||e.flags.remoteConfig||e.hadConnectionDefaults?!1:lr(e.explicitFlagKeys)}function lr(e){return e.has(`daemonBaseUrl`)||e.has(`daemonTransport`)||e.has(`tenant`)||e.has(`sessionIsolation`)||e.has(`runId`)||e.has(`leaseId`)||e.has(`leaseBackend`)}function ur(e,t,n){let r={...e};for(let[e,i]of Object.entries(t))i!==void 0&&(n.has(e)||(r[e]=i));return r}function dr(e){for(let t of Ln)if(e.has(t))return!0;return!1}function fr(e){let t=pr(e);return e.flags.remoteConfig?async(n,r)=>{let i=await t(n,r),{forgetEndedProxyLease:a}=await import(`./ended-lease.js`);return a(e.flags,i,e.host),i}:t}function pr(e){let{command:t,flags:n,replayTestReporterRuntime:r,transport:i}=e;if(n.json)return mr(i);let a=t===`test`&&r?r.onProgress:_t(e.commandProgress);return async(e,n)=>{let r={...n,onProgress:a};return await hr(i,{...e,meta:{...e.meta,requestProgress:t===`test`?`replay-test`:`command`}},r)}}function mr(e){return async(t,n)=>await hr(e,t,n)}async function hr(e,t,n){return await e(t,n)}function gr(e){for(let t=0;t<e.length;t+=1){let n=e[t];if(n.startsWith(`--session=`)){let e=n.slice(10).trim();return e.length>0?e:null}if(n===`--session`){let n=e[t+1]?.trim();return n&&!n.startsWith(`-`)?n:null}}return null}Pe(process.argv[1]??``).href===import.meta.url&&$(process.argv.slice(2)).catch(async e=>{let t=n(e);await Z(a(t),{showDetails:!0}),await w(1)});function _r(e){try{let t=E.existsSync(e)?E.statSync(e).size:0,n=!1,r=setInterval(()=>{if(!n&&E.existsSync(e))try{let n=E.statSync(e);if(n.size<t&&(t=0),n.size<=t)return;let r=E.openSync(e,`r`);try{let e=Buffer.alloc(n.size-t);E.readSync(r,e,0,e.length,t),t=n.size,e.length>0&&process.stdout.write(e.toString(`utf8`))}finally{E.closeSync(r)}}catch{}},200);return()=>{n=!0,clearInterval(r)}}catch{return null}}export{Tt as C,F as S,R as _,bn as a,Ut as b,Jt as c,en as d,B as f,U as g,Gt as h,gn as i,Xt as l,L as m,W as n,fn as o,Zt as p,yn as r,$ as runCli,Wt as s,Pn as t,Kt as u,Qt as v,qt as x,z as y};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
import{R as e}from"./sdk-contracts.js";import{
|
|
1
|
+
import{R as e}from"./sdk-contracts.js";import{P as t,b as n,et as r,j as i,k as a,m as o,p as s}from"./sdk-io.js";import"./command.js";import{t as c}from"./base-url.js";import{a as l,c as u,d,f,i as p,l as m,n as h,o as g,r as _,s as v,u as y}from"./client-companion-tunnel-contract.js";import{createHash as b}from"node:crypto";import x from"node:fs";import S from"node:path";import{fileURLToPath as C}from"node:url";const w=`companion-tunnel`;function T(e){return b(`sha256`).update(e).digest(`hex`)}function E(e){return typeof e==`string`&&e.trim()?e.trim():void 0}function D(e){if(!e||typeof e!=`object`||Array.isArray(e))return;let t=e;if(typeof t.tenantId==`string`&&typeof t.runId==`string`&&typeof t.leaseId==`string`)return{tenantId:t.tenantId,runId:t.runId,leaseId:t.leaseId}}function O(e,t){return e.tenantId===t.tenantId&&e.runId===t.runId&&e.leaseId===t.leaseId}function k(e,t,n,r){let i=r??S.join(e,`.agent-device`);if(!n)return{statePath:S.join(i,`${t.slug}.json`),logPath:S.join(i,`${t.slug}.log`)};let a=T(n).slice(0,12),o=S.join(i,t.slug);return{statePath:S.join(o,`${t.slug}-${a}.json`),logPath:S.join(o,`${t.slug}-${a}.log`)}}function A(e){try{let t=JSON.parse(x.readFileSync(e,`utf8`));if(!Number.isInteger(t.pid)||Number(t.pid)<=0||typeof t.serverBaseUrl!=`string`||typeof t.localBaseUrl!=`string`||typeof t.tokenHash!=`string`||t.tokenHash.length===0)return null;let n=Array.isArray(t.consumers)?t.consumers.filter(e=>typeof e==`string`&&e.length>0):[];return{pid:Number(t.pid),startTime:typeof t.startTime==`string`?t.startTime:void 0,command:typeof t.command==`string`?t.command:void 0,serverBaseUrl:t.serverBaseUrl,localBaseUrl:t.localBaseUrl,launchUrl:E(t.launchUrl),registerPath:E(t.registerPath),unregisterPath:E(t.unregisterPath),bridgeScope:D(t.bridgeScope),tokenHash:t.tokenHash,consumers:n}}catch{return null}}function j(e,t){x.mkdirSync(S.dirname(e),{recursive:!0}),x.writeFileSync(e,`${JSON.stringify(t,null,2)}\n`,`utf8`)}function M(e){x.mkdirSync(S.dirname(e),{recursive:!0}),x.closeSync(x.openSync(e,`a`))}function N(e){try{x.unlinkSync(e)}catch{}}function P(e){try{x.readdirSync(e).length===0&&x.rmdirSync(e)}catch{}}function F(e,t){let n=S.dirname(e.statePath),r=S.dirname(e.logPath);N(e.statePath),N(e.logPath),P(n),r!==n&&P(r),S.basename(n)===t.slug&&P(S.dirname(n))}function I(e,t){return e.includes(t.runArg)}function L(e,t){if(!n(e.pid))return!1;if(e.startTime){let t=i(e.pid);if(!t||t!==e.startTime)return!1}let r=a(e.pid);return!r||!I(r,t.definition)||!e.bridgeScope?!1:e.serverBaseUrl===c(t.serverBaseUrl)&&e.localBaseUrl===c(t.localBaseUrl)&&e.launchUrl===E(t.launchUrl)&&e.registerPath===E(t.registerPath)&&e.unregisterPath===E(t.unregisterPath)&&O(e.bridgeScope,t.bridgeScope)&&e.tokenHash===T(t.bearerToken)}function R(e){return E(e.consumerKey)??E(e.profileKey)??null}function z(e,t){return!t||e.consumers.includes(t)?e:{...e,consumers:[...e.consumers,t]}}function B(e,t){return t?{...e,consumers:e.consumers.filter(e=>e!==t)}:{...e,consumers:[]}}async function V(e,n,r){let i=await t({pid:e.pid,identity:{startTime:e.startTime,matches:e=>I(e,n)}},{termTimeoutMs:1e3,killTimeoutMs:1e3});if(i.status===`retained`)throw H({...i,pid:e.pid},n,r)}function H(t,n,r){let i=t.reason===`identity-unverified`?`${n.displayName} ${o(t.pid,`the ${n.displayName} this profile started`)}. Stop it yourself, as its owner if needed.`:`${n.displayName} pid ${t.pid} is still running${t.reason===`exit-timeout`?`: it survived ${t.signal}.`:t.errno===`EPERM`?`: it refused ${t.signal} (${t.errno}), so it belongs to another user or was started with elevated privileges. Stop it as that user, e.g. \`sudo kill ${t.pid}\`.`:`: it refused ${t.signal} (${t.errno}).`}`;return new e(`COMMAND_FAILED`,i,{...s(t,t.pid),statePath:r.statePath,logPath:r.logPath,hint:`${r.statePath} still tracks this pid, so a retry acts on that same companion instead of starting a second one.`})}function U(e,t){try{j(e,t)}catch{}}function W(e,t,n){n===void 0?delete e[t]:e[t]=n}function G(e,t){let n={...t};return n[m]=c(e.serverBaseUrl),n[h]=e.bearerToken,n[p]=c(e.localBaseUrl),n[y]=k(e.projectRoot,e.definition,e.profileKey,e.stateDir).statePath,n[u]=e.bridgeScope.tenantId,n[v]=e.bridgeScope.runId,n[g]=e.bridgeScope.leaseId,W(n,_,E(e.launchUrl)),W(n,l,E(e.registerPath)),W(n,d,E(e.unregisterPath)),n}function K(e){let t=C(import.meta.url),n=S.extname(t)||`.js`,r=[S.join(S.dirname(t),`${w}${n}`),S.join(S.dirname(t),`internal`,`${w}${n}`)].find(e=>x.existsSync(e));if(!r)throw Error(`${e.displayName} entrypoint not found. Rebuild the package to include the companion worker entry.`);return r}function q(e,t){let n=K(e.definition),o=n.endsWith(`.ts`)?[`--experimental-strip-types`]:[];x.mkdirSync(S.dirname(t),{recursive:!0});let s=x.openSync(t,`a`),l=0;try{l=r(process.execPath,[...o,n,e.definition.runArg],{cwd:e.cwd,env:G(e,e.env),stdio:[`ignore`,s,s]})}finally{x.closeSync(s)}if(!Number.isInteger(l)||l<=0)throw Error(`Failed to start ${e.definition.displayName} process.`);return{pid:l,startTime:i(l)??void 0,command:a(l)??void 0,serverBaseUrl:c(e.serverBaseUrl),localBaseUrl:c(e.localBaseUrl),launchUrl:E(e.launchUrl),registerPath:E(e.registerPath),unregisterPath:E(e.unregisterPath),bridgeScope:e.bridgeScope,tokenHash:T(e.bearerToken),consumers:[]}}async function J(t){let n=R(t),r=k(t.projectRoot,t.definition,t.profileKey,t.stateDir),i=A(r.statePath);if(i&&L(i,t)){let e=z(i,n);return e!==i&&j(r.statePath,e),{pid:i.pid,spawned:!1,statePath:r.statePath,logPath:r.logPath}}i&&(await V(i,t.definition,r),F(r,t.definition)),M(r.statePath);let a;try{a=q(t,r.logPath),j(r.statePath,z(a,n))}catch(n){if(a)try{await V(a,t.definition,r)}catch(t){throw U(r.statePath,a),t instanceof e&&(t.cause=n),t}throw F(r,t.definition),n}return{pid:a.pid,spawned:!0,statePath:r.statePath,logPath:r.logPath}}async function Y(e){let t=R(e),n=k(e.projectRoot,e.definition,e.profileKey,e.stateDir),r=A(n.statePath);if(!r)return F(n,e.definition),{stopped:!1,statePath:n.statePath};let i=B(r,t);return i.consumers.length>0?(j(n.statePath,i),{stopped:!1,statePath:n.statePath}):(await V(r,e.definition,n),F(n,e.definition),{stopped:!0,statePath:n.statePath})}const X={slug:`metro-companion`,runArg:f,displayName:`Metro companion`};async function Z(e){return await J({...e,definition:X,registerPath:e.registerPath??`/api/metro/companion/register`})}async function Q(e){return await Y({...e,definition:X})}export{Z as ensureMetroCompanion,Q as stopMetroCompanion};
|
package/dist/src/client-metro.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import{B as e,R as t}from"./sdk-contracts.js";import{$ as n,P as r,V as i,j as a,m as o,nt as s,p as c,w as l}from"./sdk-io.js";import{c as u}from"./file.js";import"./command.js";import{t as d}from"./base-url.js";import{d as f}from"./src2.js";import"./retry.js";import{n as p,r as m}from"./project-runtime.js";import{ensureMetroCompanion as h}from"./client-metro-companion.js";import{n as g,r as _,t as v}from"./metro-reload-endpoints.js";import y from"node:fs";import b from"node:path";function x(e){return typeof e==`string`&&e.trim()?d(e.trim()):``}function S(e){return typeof e==`string`&&e.trim()?e.trim():void 0}function C(e,t,n){return u(e,{env:t,cwd:n})}function w(e){try{return y.accessSync(e,y.constants.F_OK),!0}catch{return!1}}function T(e){try{return y.statSync(e).isDirectory()}catch{return!1}}function E(e){let n=b.join(e,`package.json`),r=m(e);if(!r)throw new t(`INVALID_ARGS`,`package.json not found at ${n}`);return r}const D=[{file:`pnpm-lock.yaml`,command:`pnpm`},{file:`yarn.lock`,command:`yarn`},{file:`bun.lock`,command:`bun`},{file:`bun.lockb`,command:`bun`},{file:`package-lock.json`,command:`npm`}];function O(e){let t=e;for(;;){for(let{file:e,command:n}of D)if(w(b.join(t,e)))return{command:n,installArgs:[`install`]};if(w(b.join(t,`.git`)))return null;let e=b.dirname(t);if(e===t)return null;t=e}}function k(e){return O(e)??{command:`npm`,installArgs:[`install`]}}function A(e,t){if(t!==`auto`)return t;let n=p(e);return n===`expo`||n===`repack`?n:`react-native`}function j(e,t){return typeof{...e.dependencies??{},...e.devDependencies??{}}[t]==`string`}function M(e,t){return[`js`,`mjs`,`cjs`,`ts`,`mts`,`cts`].some(n=>w(b.join(e,`${t}.config.${n}`)))}function N(e,t){return M(e,`rspack`)?`rspack`:M(e,`webpack`)?`webpack`:j(t,`@rspack/core`)?`rspack`:j(t,`webpack`)?`webpack`:`rspack`}function P(e,t,n){if(e==null||e===``)return t;let r=Number.parseInt(String(e),10);return Number.isInteger(r)?Math.max(r,n):t}function F(e){return e===`expo`?v:`index.bundle`}function I(e,t,n){return{platform:t,bundleUrl:f(e,t,F(n))}}function L(e,t){return{platform:t,metroHost:S(e?.metro_host),metroPort:e?.metro_port,bundleUrl:S(e?.metro_bundle_url),launchUrl:S(e?.launch_url)}}function R(e,t){if(T(b.join(e,`node_modules`)))return{installed:!1};let n=k(e);try{s(n.command,n.installArgs,{cwd:e,env:t})}catch(e){throw z(e,n)}return{installed:!0,packageManager:n.command}}function z(n,r){let i=e(n),a=`Dependency install failed using detected package manager "${r.command}". If dependencies are already installed (for example via a monorepo root install), pass --no-install-deps to skip this step, or install manually with "${r.command} ${r.installArgs.join(` `)}" from the project root.`;return new t(i.code,i.message,{...i.details??{},hint:a,packageManager:r.command},i)}async function B(e){await i(e)}async function V(e,n,r={}){try{let t=await fetch(e,{headers:r,signal:AbortSignal.timeout(n)});return{ok:t.ok,status:t.status,body:await t.text()}}catch(r){throw r instanceof Error&&r.name===`TimeoutError`?new t(`COMMAND_FAILED`,`Timed out fetching ${e} after ${n}ms`):r}}async function H(e,t){try{let n=await V(e,t);return n.ok&&n.body.includes(`packager-status:running`)}catch{return!1}}function U(e,t,n,r){return e===`expo`?{command:`npx`,installArgs:[`expo`,`start`,`--host`,`lan`,`--port`,String(n)]}:e===`repack`?{command:`npx`,installArgs:[`react-native`,t===`webpack`?`webpack-start`:`rspack-start`,`--host`,r,`--port`,String(n)]}:{command:`npx`,installArgs:[`react-native`,`start`,`--host`,r,`--port`,String(n)]}}function W(e,r,i,o,s,c,l){let u=U(r,i,o,s);y.mkdirSync(b.dirname(c),{recursive:!0});let d=y.openSync(c,`a`),f=0;try{f=n(u.command,u.installArgs,{cwd:e,env:l,stdio:[`ignore`,d,d]})}finally{y.closeSync(d)}if(!Number.isInteger(f)||f<=0)throw new t(`COMMAND_FAILED`,`Failed to start React Native dev server. Expected a detached child PID.`);return{pid:f,startTime:a(f)??void 0}}function G(e,n,r,i){let a=`React Native dev server did not become ready at ${e} within ${n.startupTimeoutMs}ms. Check ${n.logPath}.`;if(`throws`in i)return new t(`COMMAND_FAILED`,a,{logPath:n.logPath},i.throws);if(i.status===`stopped`)return new t(`COMMAND_FAILED`,a,{logPath:n.logPath});let s=i.reason===`identity-unverified`?o(r,`the process this run started`):`pid ${r} is still running${i.reason===`signal-failed`?` and refused ${i.signal} (${i.errno})`:``}`;return new t(`COMMAND_FAILED`,`${a} Dev server ${s}; stop it before retrying.`,{logPath:n.logPath,...c(i,r)})}function K(e,t){return{Authorization:`Bearer ${t}`,"Content-Type":`application/json`,...e.includes(`ngrok`)?{"ngrok-skip-browser-warning":`1`}:{}}}function q(e,n){let r=new t(`COMMAND_FAILED`,e);return r.retryable=n,r}function J(e,t){return!!(e>=500||e===408||e===425||e===429||JSON.stringify(t).includes(`Metro companion is not connected`))}function Y(e){return!!(e&&typeof e==`object`&&`retryable`in e&&e.retryable===!0)}async function X(e){let t;try{t=await fetch(`${e.baseUrl}/api/metro/bridge`,{method:`POST`,headers:K(e.baseUrl,e.bearerToken),body:JSON.stringify({...e.scope,...e.runtime?{ios_runtime:e.runtime}:{},timeout_ms:e.timeoutMs}),signal:AbortSignal.timeout(e.timeoutMs)})}catch(t){throw t instanceof Error&&t.name===`TimeoutError`?q(`/api/metro/bridge timed out after ${e.timeoutMs}ms calling ${e.baseUrl}/api/metro/bridge`,!0):q(t instanceof Error?t.message:String(t),!0)}let n=ee(await t.text(),t.status,e.baseUrl);if(!t.ok)throw q(`/api/metro/bridge failed (${t.status}): ${JSON.stringify(n)}`,J(t.status,n));return Q(n)}function ee(e,t,n){if(!e)return{};try{let t=JSON.parse(e);if(!t||typeof t!=`object`||Array.isArray(t))throw Error(`Expected a JSON object`);return t}catch(r){let i=e.slice(0,200);throw q(`/api/metro/bridge returned invalid JSON (${t}) from ${n}: ${r instanceof Error?r.message:String(r)}. body=${JSON.stringify(i)}`,J(t,e))}}function Z(e){return{enabled:e.enabled,baseUrl:e.base_url,statusUrl:e.status_url??``,bundleUrl:e.bundle_url??``,iosRuntime:L(e.ios_runtime,`ios`),androidRuntime:L(e.android_runtime,`android`),upstream:{bundleUrl:e.upstream.bundle_url??``,host:e.upstream.host??``,port:e.upstream.port??0,statusUrl:e.upstream.status_url??``},probe:{reachable:e.probe.reachable,statusCode:e.probe.status_code,latencyMs:e.probe.latency_ms,detail:e.probe.detail}}}function Q(e){let t=e.data??e;if(!t||typeof t!=`object`||Array.isArray(t))throw q(`/api/metro/bridge returned malformed descriptor: Expected a JSON object.`,!1);try{return Z(t)}catch(e){throw q(`/api/metro/bridge returned malformed descriptor: ${e instanceof Error?e.message:String(e)}`,!1)}}function $(e,t,n,r,i){let a=[`Metro bridge is required for this run but could not be configured via ${e}/api/metro/bridge.`];return t&&a.push(`bridgeError=${t}`),n?.probe.reachable===!1&&a.push(`bridgeProbe=${n.probe.detail||`unreachable (status ${n.probe.statusCode||0})`}`),r&&r!==t&&a.push(`initialBridgeError=${r}`),i&&a.push(`metroCompanionLog=${i}`),a.join(` `)}function te(e,n){if(!n?.iosRuntime.bundleUrl)throw new t(`COMMAND_FAILED`,$(e,`bridge descriptor is missing ios_runtime.metro_bundle_url`,n))}function ne(e,n,r){let i=n||S(r.AGENT_DEVICE_METRO_BEARER_TOKEN)||``,a=i||e&&S(r.AGENT_DEVICE_DAEMON_AUTH_TOKEN)||``;if(e&&!a)throw new t(`INVALID_ARGS`,`metro prepare requires proxy auth when --proxy-base-url is provided. Pass --bearer-token or set AGENT_DEVICE_METRO_BEARER_TOKEN or AGENT_DEVICE_DAEMON_AUTH_TOKEN.`);if(!e&&i)throw new t(`INVALID_ARGS`,`metro prepare requires --proxy-base-url when proxy auth is provided.`);return{proxyEnabled:!!(e&&a),proxyBaseUrl:e,proxyBearerToken:a}}function re(e){if(!e?.tenantId||!e.runId||!e.leaseId)throw new t(`INVALID_ARGS`,`metro prepare with proxy requires tenantId, runId, and leaseId bridge scope.`);return e}function ie(e,n){if(!(e||n))throw new t(`INVALID_ARGS`,`metro prepare requires --public-base-url <url> or --proxy-base-url <url>.`)}function ae(e,t,n){return e.runtimeFilePath?C(e.runtimeFilePath,t,n):null}function oe(e,t,n,r){return C(e.logPath??b.join(r,`.agent-device`,`metro.log`),t,n)}function se(e,t){let n=e.env??t.env,r=t.cwd,i=C(e.projectRoot??r,n,r),a=e.kind??`auto`,o=null,s;a===`auto`?(o=E(i),s=A(o,a)):s=a;let c=null;s===`repack`&&(o??=E(i),c=N(i,o));let l=x(e.publicBaseUrl),u=x(e.proxyBaseUrl);ie(l,u);let{proxyEnabled:d,proxyBaseUrl:f,proxyBearerToken:p}=ne(u,S(e.proxyBearerToken)??``,n);return{env:n,cwd:r,projectRoot:i,kind:s,repackBundler:c,metroPort:g(e.metroPort??8081,8081),listenHost:S(e.listenHost)??`0.0.0.0`,statusHost:S(e.statusHost)??`127.0.0.1`,publicBaseUrl:l,proxyBaseUrl:f,proxyBearerToken:p,bridgeScope:d?re(e.bridgeScope):null,startupTimeoutMs:P(e.startupTimeoutMs,18e4,3e4),probeTimeoutMs:P(e.probeTimeoutMs,1e4,1e3),reuseExisting:e.reuseExisting??!0,installProjectDeps:e.installDependenciesIfNeeded??!0,runtimeFilePath:ae(e,n,r),logPath:oe(e,n,r,i)}}async function ce(e,t,n){let r=Date.now()+t;for(;Date.now()<r;){let t=r-Date.now();if(await H(e,Math.min(n,Math.max(t,1))))return!0;let i=Math.min(500,Math.max(r-Date.now(),0));i>0&&await B(i)}return!1}async function le(e){let n=Date.now()+e.startupTimeoutMs,r=null,i=null;for(;Date.now()<n;){try{let t=await X({baseUrl:e.baseUrl,bearerToken:e.bearerToken,scope:e.scope,runtime:e.runtime,timeoutMs:e.probeTimeoutMs});if(t.probe.reachable!==!1)return t;r=t,i=null}catch(n){if(i=n instanceof Error?n.message:String(n),!Y(n))throw new t(`COMMAND_FAILED`,$(e.baseUrl,i,r,e.initialBridgeError,e.companionLogPath),void 0,n)}let a=Math.min(1e3,Math.max(n-Date.now(),0));a>0&&await B(a)}throw new t(`COMMAND_FAILED`,$(e.baseUrl,i,r,e.initialBridgeError,e.companionLogPath))}async function ue(e){let t=`http://${e.statusHost}:${e.metroPort}/status`;if(e.reuseExisting&&await H(t,e.probeTimeoutMs))return{started:!1,reused:!0,pid:0,statusUrl:t};let n=W(e.projectRoot,e.kind,e.repackBundler,e.metroPort,e.listenHost,e.logPath,e.env);if(await ce(t,e.startupTimeoutMs,e.probeTimeoutMs))return{started:!0,reused:!1,pid:n.pid,statusUrl:t};let i=await r({pid:n.pid,identity:{startTime:n.startTime}},{termTimeoutMs:1e3,killTimeoutMs:1e3}).catch(e=>({throws:e}));throw G(t,e,n.pid,i)}async function de(e,t){let n=t.bridgeScope;if(!n)return null;let r=null,i=null;try{r=await X({baseUrl:t.proxyBaseUrl,bearerToken:t.proxyBearerToken,scope:n,timeoutMs:t.probeTimeoutMs})}catch(e){if(!Y(e))throw e;i=e instanceof Error?e.message:String(e)}return(!r||r.probe.reachable===!1)&&(r=await fe(e,t,n,r,i)),te(t.proxyBaseUrl,r),r}async function fe(e,n,r,i,a){let o;try{o=(await h({projectRoot:n.projectRoot,serverBaseUrl:n.proxyBaseUrl,bearerToken:n.proxyBearerToken,bridgeScope:r,localBaseUrl:`http://${n.statusHost}:${n.metroPort}`,launchUrl:S(e.launchUrl),profileKey:S(e.companionProfileKey),consumerKey:S(e.companionConsumerKey),env:n.env,cwd:n.cwd})).logPath}catch(e){throw new t(`COMMAND_FAILED`,$(n.proxyBaseUrl,e instanceof Error?e.message:String(e),i,a),e instanceof t?l(e.details):void 0,e)}try{return await le({baseUrl:n.proxyBaseUrl,bearerToken:n.proxyBearerToken,scope:r,probeTimeoutMs:n.probeTimeoutMs,startupTimeoutMs:n.startupTimeoutMs,initialBridgeError:a,companionLogPath:o})}catch(e){throw e instanceof Error?e:Error(String(e))}}function pe(e,t){return{baseIosRuntime:e?I(e,`ios`,t):{platform:`ios`},baseAndroidRuntime:e?I(e,`android`,t):{platform:`android`}}}function me(e,t){e&&(y.mkdirSync(b.dirname(e),{recursive:!0}),y.writeFileSync(e,JSON.stringify(t,null,2)))}async function he(e,t){let n=se(e,t),r=n.installProjectDeps?R(n.projectRoot,n.env):{installed:!1},i=await ue(n),{baseIosRuntime:a,baseAndroidRuntime:o}=pe(n.publicBaseUrl,n.kind),s=await de(e,n),c=s?.iosRuntime??a,l=s?.androidRuntime??o,u={projectRoot:n.projectRoot,kind:n.kind,dependenciesInstalled:r.installed,packageManager:r.packageManager??null,started:i.started,reused:i.reused,pid:i.pid,logPath:n.logPath,statusUrl:i.statusUrl,runtimeFilePath:n.runtimeFilePath,iosRuntime:c,androidRuntime:l,bridge:s};return me(n.runtimeFilePath,u),u}function ge(e){let t=e.trimStart().slice(0,15).toLowerCase();return t.startsWith(`<!doctype`)||t.startsWith(`<html`)}async function _e(e,n){await new Promise((r,i)=>{let a=new WebSocket(e),o=e=>{clearTimeout(s);try{a.close()}catch{}i(new t(`COMMAND_FAILED`,e))},s=setTimeout(()=>{o(`Timed out broadcasting reload to ${e} after ${n}ms`)},n);a.addEventListener(`open`,()=>{a.send(JSON.stringify({version:2,method:`reload`}));let e=()=>{if(a.bufferedAmount===0){clearTimeout(s),a.close(),r();return}setTimeout(e,20)};e()}),a.addEventListener(`error`,()=>{o(`Failed to reach the dev server message socket at ${e}`)})})}async function ve(e={}){let n=P(e.timeoutMs,1e4,1e3),{reloadUrl:r,messageSocketUrl:i}=_(e),a=await V(r,n);if(a.ok&&!ge(a.body))return{reloaded:!0,reloadUrl:r,status:a.status,body:a.body,transport:`http`};try{await _e(i,n)}catch(e){throw new t(`COMMAND_FAILED`,`React Native dev server reload failed (${a.status}).`,{reloadUrl:r,status:a.status,body:a.body.slice(0,500),messageSocketUrl:i,hint:`Verify Metro or Re.Pack is running and the target React Native app is connected to this dev server instance.`},e instanceof Error?e:void 0)}return{reloaded:!0,reloadUrl:i,status:a.status,body:``,transport:`message-socket`}}export{he as prepareMetroRuntime,ve as reloadMetro};
|
|
1
|
+
import{R as e,V as t}from"./sdk-contracts.js";import{H as n,P as r,et as i,j as a,m as o,p as s,rt as c,w as l}from"./sdk-io.js";import{u}from"./file.js";import"./command.js";import{t as d}from"./base-url.js";import{d as f}from"./src2.js";import"./retry.js";import{n as p,r as m}from"./project-runtime.js";import{ensureMetroCompanion as h}from"./client-metro-companion.js";import{n as g,r as _,t as v}from"./metro-reload-endpoints.js";import y from"node:fs";import b from"node:path";function x(e){return typeof e==`string`&&e.trim()?d(e.trim()):``}function S(e){return typeof e==`string`&&e.trim()?e.trim():void 0}function C(e,t,n){return u(e,{env:t,cwd:n})}function w(e){try{return y.accessSync(e,y.constants.F_OK),!0}catch{return!1}}function T(e){try{return y.statSync(e).isDirectory()}catch{return!1}}function E(t){let n=b.join(t,`package.json`),r=m(t);if(!r)throw new e(`INVALID_ARGS`,`package.json not found at ${n}`);return r}const D=[{file:`pnpm-lock.yaml`,command:`pnpm`},{file:`yarn.lock`,command:`yarn`},{file:`bun.lock`,command:`bun`},{file:`bun.lockb`,command:`bun`},{file:`package-lock.json`,command:`npm`}];function O(e){let t=e;for(;;){for(let{file:e,command:n}of D)if(w(b.join(t,e)))return{command:n,installArgs:[`install`]};if(w(b.join(t,`.git`)))return null;let e=b.dirname(t);if(e===t)return null;t=e}}function k(e){return O(e)??{command:`npm`,installArgs:[`install`]}}function A(e,t){if(t!==`auto`)return t;let n=p(e);return n===`expo`||n===`repack`?n:`react-native`}function j(e,t){return typeof{...e.dependencies??{},...e.devDependencies??{}}[t]==`string`}function M(e,t){return[`js`,`mjs`,`cjs`,`ts`,`mts`,`cts`].some(n=>w(b.join(e,`${t}.config.${n}`)))}function N(e,t){return M(e,`rspack`)?`rspack`:M(e,`webpack`)?`webpack`:j(t,`@rspack/core`)?`rspack`:j(t,`webpack`)?`webpack`:`rspack`}function P(e,t,n){if(e==null||e===``)return t;let r=Number.parseInt(String(e),10);return Number.isInteger(r)?Math.max(r,n):t}function F(e){return e===`expo`?v:`index.bundle`}function I(e,t,n){return{platform:t,bundleUrl:f(e,t,F(n))}}function L(e,t){return{platform:t,metroHost:S(e?.metro_host),metroPort:e?.metro_port,bundleUrl:S(e?.metro_bundle_url),launchUrl:S(e?.launch_url)}}function R(e,t){if(T(b.join(e,`node_modules`)))return{installed:!1};let n=k(e);try{c(n.command,n.installArgs,{cwd:e,env:t})}catch(e){throw z(e,n)}return{installed:!0,packageManager:n.command}}function z(n,r){let i=t(n),a=`Dependency install failed using detected package manager "${r.command}". If dependencies are already installed (for example via a monorepo root install), pass --no-install-deps to skip this step, or install manually with "${r.command} ${r.installArgs.join(` `)}" from the project root.`;return new e(i.code,i.message,{...i.details??{},hint:a,packageManager:r.command},i)}async function B(e){await n(e)}async function V(t,n,r={}){try{let e=await fetch(t,{headers:r,signal:AbortSignal.timeout(n)});return{ok:e.ok,status:e.status,body:await e.text()}}catch(r){throw r instanceof Error&&r.name===`TimeoutError`?new e(`COMMAND_FAILED`,`Timed out fetching ${t} after ${n}ms`):r}}async function H(e,t){try{let n=await V(e,t);return n.ok&&n.body.includes(`packager-status:running`)}catch{return!1}}function U(e,t,n,r){return e===`expo`?{command:`npx`,installArgs:[`expo`,`start`,`--host`,`lan`,`--port`,String(n)]}:e===`repack`?{command:`npx`,installArgs:[`react-native`,t===`webpack`?`webpack-start`:`rspack-start`,`--host`,r,`--port`,String(n)]}:{command:`npx`,installArgs:[`react-native`,`start`,`--host`,r,`--port`,String(n)]}}function W(t,n,r,o,s,c,l){let u=U(n,r,o,s);y.mkdirSync(b.dirname(c),{recursive:!0});let d=y.openSync(c,`a`),f=0;try{f=i(u.command,u.installArgs,{cwd:t,env:l,stdio:[`ignore`,d,d]})}finally{y.closeSync(d)}if(!Number.isInteger(f)||f<=0)throw new e(`COMMAND_FAILED`,`Failed to start React Native dev server. Expected a detached child PID.`);return{pid:f,startTime:a(f)??void 0}}function G(t,n,r,i){let a=`React Native dev server did not become ready at ${t} within ${n.startupTimeoutMs}ms. Check ${n.logPath}.`;if(`throws`in i)return new e(`COMMAND_FAILED`,a,{logPath:n.logPath},i.throws);if(i.status===`stopped`)return new e(`COMMAND_FAILED`,a,{logPath:n.logPath});let c=i.reason===`identity-unverified`?o(r,`the process this run started`):`pid ${r} is still running${i.reason===`signal-failed`?` and refused ${i.signal} (${i.errno})`:``}`;return new e(`COMMAND_FAILED`,`${a} Dev server ${c}; stop it before retrying.`,{logPath:n.logPath,...s(i,r)})}function K(e,t){return{Authorization:`Bearer ${t}`,"Content-Type":`application/json`,...e.includes(`ngrok`)?{"ngrok-skip-browser-warning":`1`}:{}}}function q(t,n){let r=new e(`COMMAND_FAILED`,t);return r.retryable=n,r}function J(e,t){return!!(e>=500||e===408||e===425||e===429||JSON.stringify(t).includes(`Metro companion is not connected`))}function Y(e){return!!(e&&typeof e==`object`&&`retryable`in e&&e.retryable===!0)}async function X(e){let t;try{t=await fetch(`${e.baseUrl}/api/metro/bridge`,{method:`POST`,headers:K(e.baseUrl,e.bearerToken),body:JSON.stringify({...e.scope,...e.runtime?{ios_runtime:e.runtime}:{},timeout_ms:e.timeoutMs}),signal:AbortSignal.timeout(e.timeoutMs)})}catch(t){throw t instanceof Error&&t.name===`TimeoutError`?q(`/api/metro/bridge timed out after ${e.timeoutMs}ms calling ${e.baseUrl}/api/metro/bridge`,!0):q(t instanceof Error?t.message:String(t),!0)}let n=ee(await t.text(),t.status,e.baseUrl);if(!t.ok)throw q(`/api/metro/bridge failed (${t.status}): ${JSON.stringify(n)}`,J(t.status,n));return Q(n)}function ee(e,t,n){if(!e)return{};try{let t=JSON.parse(e);if(!t||typeof t!=`object`||Array.isArray(t))throw Error(`Expected a JSON object`);return t}catch(r){let i=e.slice(0,200);throw q(`/api/metro/bridge returned invalid JSON (${t}) from ${n}: ${r instanceof Error?r.message:String(r)}. body=${JSON.stringify(i)}`,J(t,e))}}function Z(e){return{enabled:e.enabled,baseUrl:e.base_url,statusUrl:e.status_url??``,bundleUrl:e.bundle_url??``,iosRuntime:L(e.ios_runtime,`ios`),androidRuntime:L(e.android_runtime,`android`),upstream:{bundleUrl:e.upstream.bundle_url??``,host:e.upstream.host??``,port:e.upstream.port??0,statusUrl:e.upstream.status_url??``},probe:{reachable:e.probe.reachable,statusCode:e.probe.status_code,latencyMs:e.probe.latency_ms,detail:e.probe.detail}}}function Q(e){let t=e.data??e;if(!t||typeof t!=`object`||Array.isArray(t))throw q(`/api/metro/bridge returned malformed descriptor: Expected a JSON object.`,!1);try{return Z(t)}catch(e){throw q(`/api/metro/bridge returned malformed descriptor: ${e instanceof Error?e.message:String(e)}`,!1)}}function $(e,t,n,r,i){let a=[`Metro bridge is required for this run but could not be configured via ${e}/api/metro/bridge.`];return t&&a.push(`bridgeError=${t}`),n?.probe.reachable===!1&&a.push(`bridgeProbe=${n.probe.detail||`unreachable (status ${n.probe.statusCode||0})`}`),r&&r!==t&&a.push(`initialBridgeError=${r}`),i&&a.push(`metroCompanionLog=${i}`),a.join(` `)}function te(t,n){if(!n?.iosRuntime.bundleUrl)throw new e(`COMMAND_FAILED`,$(t,`bridge descriptor is missing ios_runtime.metro_bundle_url`,n))}function ne(t,n,r){let i=n||S(r.AGENT_DEVICE_METRO_BEARER_TOKEN)||``,a=i||t&&S(r.AGENT_DEVICE_DAEMON_AUTH_TOKEN)||``;if(t&&!a)throw new e(`INVALID_ARGS`,`metro prepare requires proxy auth when --proxy-base-url is provided. Pass --bearer-token or set AGENT_DEVICE_METRO_BEARER_TOKEN or AGENT_DEVICE_DAEMON_AUTH_TOKEN.`);if(!t&&i)throw new e(`INVALID_ARGS`,`metro prepare requires --proxy-base-url when proxy auth is provided.`);return{proxyEnabled:!!(t&&a),proxyBaseUrl:t,proxyBearerToken:a}}function re(t){if(!t?.tenantId||!t.runId||!t.leaseId)throw new e(`INVALID_ARGS`,`metro prepare with proxy requires tenantId, runId, and leaseId bridge scope.`);return t}function ie(t,n){if(!(t||n))throw new e(`INVALID_ARGS`,`metro prepare requires --public-base-url <url> or --proxy-base-url <url>.`)}function ae(e,t,n){return e.runtimeFilePath?C(e.runtimeFilePath,t,n):null}function oe(e,t,n,r){return C(e.logPath??b.join(r,`.agent-device`,`metro.log`),t,n)}function se(e,t){let n=e.env??t.env,r=t.cwd,i=C(e.projectRoot??r,n,r),a=e.kind??`auto`,o=null,s;a===`auto`?(o=E(i),s=A(o,a)):s=a;let c=null;s===`repack`&&(o??=E(i),c=N(i,o));let l=x(e.publicBaseUrl),u=x(e.proxyBaseUrl);ie(l,u);let{proxyEnabled:d,proxyBaseUrl:f,proxyBearerToken:p}=ne(u,S(e.proxyBearerToken)??``,n);return{env:n,cwd:r,projectRoot:i,kind:s,repackBundler:c,metroPort:g(e.metroPort??8081,8081),listenHost:S(e.listenHost)??`0.0.0.0`,statusHost:S(e.statusHost)??`127.0.0.1`,publicBaseUrl:l,proxyBaseUrl:f,proxyBearerToken:p,bridgeScope:d?re(e.bridgeScope):null,startupTimeoutMs:P(e.startupTimeoutMs,18e4,3e4),probeTimeoutMs:P(e.probeTimeoutMs,1e4,1e3),reuseExisting:e.reuseExisting??!0,installProjectDeps:e.installDependenciesIfNeeded??!0,runtimeFilePath:ae(e,n,r),logPath:oe(e,n,r,i)}}async function ce(e,t,n){let r=Date.now()+t;for(;Date.now()<r;){let t=r-Date.now();if(await H(e,Math.min(n,Math.max(t,1))))return!0;let i=Math.min(500,Math.max(r-Date.now(),0));i>0&&await B(i)}return!1}async function le(t){let n=Date.now()+t.startupTimeoutMs,r=null,i=null;for(;Date.now()<n;){try{let e=await X({baseUrl:t.baseUrl,bearerToken:t.bearerToken,scope:t.scope,runtime:t.runtime,timeoutMs:t.probeTimeoutMs});if(e.probe.reachable!==!1)return e;r=e,i=null}catch(n){if(i=n instanceof Error?n.message:String(n),!Y(n))throw new e(`COMMAND_FAILED`,$(t.baseUrl,i,r,t.initialBridgeError,t.companionLogPath),void 0,n)}let a=Math.min(1e3,Math.max(n-Date.now(),0));a>0&&await B(a)}throw new e(`COMMAND_FAILED`,$(t.baseUrl,i,r,t.initialBridgeError,t.companionLogPath))}async function ue(e){let t=`http://${e.statusHost}:${e.metroPort}/status`;if(e.reuseExisting&&await H(t,e.probeTimeoutMs))return{started:!1,reused:!0,pid:0,statusUrl:t};let n=W(e.projectRoot,e.kind,e.repackBundler,e.metroPort,e.listenHost,e.logPath,e.env);if(await ce(t,e.startupTimeoutMs,e.probeTimeoutMs))return{started:!0,reused:!1,pid:n.pid,statusUrl:t};let i=await r({pid:n.pid,identity:{startTime:n.startTime}},{termTimeoutMs:1e3,killTimeoutMs:1e3}).catch(e=>({throws:e}));throw G(t,e,n.pid,i)}async function de(e,t){let n=t.bridgeScope;if(!n)return null;let r=null,i=null;try{r=await X({baseUrl:t.proxyBaseUrl,bearerToken:t.proxyBearerToken,scope:n,timeoutMs:t.probeTimeoutMs})}catch(e){if(!Y(e))throw e;i=e instanceof Error?e.message:String(e)}return(!r||r.probe.reachable===!1)&&(r=await fe(e,t,n,r,i)),te(t.proxyBaseUrl,r),r}async function fe(t,n,r,i,a){let o;try{o=(await h({projectRoot:n.projectRoot,serverBaseUrl:n.proxyBaseUrl,bearerToken:n.proxyBearerToken,bridgeScope:r,localBaseUrl:`http://${n.statusHost}:${n.metroPort}`,launchUrl:S(t.launchUrl),profileKey:S(t.companionProfileKey),consumerKey:S(t.companionConsumerKey),env:n.env,cwd:n.cwd})).logPath}catch(t){throw new e(`COMMAND_FAILED`,$(n.proxyBaseUrl,t instanceof Error?t.message:String(t),i,a),t instanceof e?l(t.details):void 0,t)}try{return await le({baseUrl:n.proxyBaseUrl,bearerToken:n.proxyBearerToken,scope:r,probeTimeoutMs:n.probeTimeoutMs,startupTimeoutMs:n.startupTimeoutMs,initialBridgeError:a,companionLogPath:o})}catch(e){throw e instanceof Error?e:Error(String(e))}}function pe(e,t){return{baseIosRuntime:e?I(e,`ios`,t):{platform:`ios`},baseAndroidRuntime:e?I(e,`android`,t):{platform:`android`}}}function me(e,t){e&&(y.mkdirSync(b.dirname(e),{recursive:!0}),y.writeFileSync(e,JSON.stringify(t,null,2)))}async function he(e,t){let n=se(e,t),r=n.installProjectDeps?R(n.projectRoot,n.env):{installed:!1},i=await ue(n),{baseIosRuntime:a,baseAndroidRuntime:o}=pe(n.publicBaseUrl,n.kind),s=await de(e,n),c=s?.iosRuntime??a,l=s?.androidRuntime??o,u={projectRoot:n.projectRoot,kind:n.kind,dependenciesInstalled:r.installed,packageManager:r.packageManager??null,started:i.started,reused:i.reused,pid:i.pid,logPath:n.logPath,statusUrl:i.statusUrl,runtimeFilePath:n.runtimeFilePath,iosRuntime:c,androidRuntime:l,bridge:s};return me(n.runtimeFilePath,u),u}function ge(e){let t=e.trimStart().slice(0,15).toLowerCase();return t.startsWith(`<!doctype`)||t.startsWith(`<html`)}async function _e(t,n){await new Promise((r,i)=>{let a=new WebSocket(t),o=t=>{clearTimeout(s);try{a.close()}catch{}i(new e(`COMMAND_FAILED`,t))},s=setTimeout(()=>{o(`Timed out broadcasting reload to ${t} after ${n}ms`)},n);a.addEventListener(`open`,()=>{a.send(JSON.stringify({version:2,method:`reload`}));let e=()=>{if(a.bufferedAmount===0){clearTimeout(s),a.close(),r();return}setTimeout(e,20)};e()}),a.addEventListener(`error`,()=>{o(`Failed to reach the dev server message socket at ${t}`)})})}async function ve(t={}){let n=P(t.timeoutMs,1e4,1e3),{reloadUrl:r,messageSocketUrl:i}=_(t),a=await V(r,n);if(a.ok&&!ge(a.body))return{reloaded:!0,reloadUrl:r,status:a.status,body:a.body,transport:`http`};try{await _e(i,n)}catch(t){throw new e(`COMMAND_FAILED`,`React Native dev server reload failed (${a.status}).`,{reloadUrl:r,status:a.status,body:a.body.slice(0,500),messageSocketUrl:i,hint:`Verify Metro or Re.Pack is running and the target React Native app is connected to this dev server instance.`},t instanceof Error?t:void 0)}return{reloaded:!0,reloadUrl:i,status:a.status,body:``,transport:`message-socket`}}export{he as prepareMetroRuntime,ve as reloadMetro};
|
|
@@ -1624,9 +1624,9 @@ type TvRemoteCommandResult = {
|
|
|
1624
1624
|
/**
|
|
1625
1625
|
* `hardware-button` — `{ action: 'hardware-button', button, message: 'Pressed hardware button <button>' }`.
|
|
1626
1626
|
*
|
|
1627
|
-
* The button is the public name (`volume-up`, `volume-down`, `power`
|
|
1628
|
-
*
|
|
1629
|
-
*
|
|
1627
|
+
* The button is the public name (`volume-up`, `volume-down`, `power`, `mute`, `sleep`, `wake`, or
|
|
1628
|
+
* one of the five media names). The result reports that the press was dispatched; it carries no
|
|
1629
|
+
* volume level, mute state, or screen state, because the command observes none of them (#3848).
|
|
1630
1630
|
*/
|
|
1631
1631
|
type HardwareButtonCommandResult = {
|
|
1632
1632
|
action: 'hardware-button';
|
|
@@ -14,11 +14,12 @@ type DeviceRotation = (typeof DEVICE_ROTATIONS)[number];
|
|
|
14
14
|
declare const ORIENTATION_REQUESTS: readonly ["portrait", "portrait-upside-down", "landscape-left", "landscape-right", "auto"];
|
|
15
15
|
type OrientationRequest = (typeof ORIENTATION_REQUESTS)[number];
|
|
16
16
|
/**
|
|
17
|
-
* The public positional names of the hardware keys:
|
|
18
|
-
*
|
|
19
|
-
* owner's type-level check and the
|
|
17
|
+
* The public positional names of the hardware keys: the volume/power/mute keys, the explicit
|
|
18
|
+
* sleep and wake events, and the five media keys. The literals are the same ones
|
|
19
|
+
* SYSTEM_BUTTON_LABELS carries for these buttons; the label owner's type-level check and the
|
|
20
|
+
* contracts tests refuse drift between the two lists.
|
|
20
21
|
*/
|
|
21
|
-
type HardwareButtonName = 'volume-up' | 'volume-down' | 'power';
|
|
22
|
+
type HardwareButtonName = 'volume-up' | 'volume-down' | 'power' | 'mute' | 'sleep' | 'wake' | 'media-play-pause' | 'media-next' | 'media-previous' | 'media-rewind' | 'media-fast-forward';
|
|
22
23
|
/**
|
|
23
24
|
* The three hinge poses a foldable Apple device can be put in, named after what an agent sees
|
|
24
25
|
* rather than after Apple's `UIHinge.Status` cases: `closed` lights the outer panel only,
|