agent-device 0.21.29 → 0.21.30

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.
Files changed (177) hide show
  1. package/android/ime-helper/dist/{agent-device-android-ime-helper-0.21.29.apk → agent-device-android-ime-helper-0.21.30.apk} +0 -0
  2. package/android/ime-helper/dist/agent-device-android-ime-helper-0.21.30.apk.sha256 +1 -0
  3. package/android/ime-helper/dist/{agent-device-android-ime-helper-0.21.29.manifest.json → agent-device-android-ime-helper-0.21.30.manifest.json} +4 -4
  4. package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.30.apk +0 -0
  5. package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.30.apk.sha256 +1 -0
  6. package/android/snapshot-helper/dist/{agent-device-android-snapshot-helper-0.21.29.manifest.json → agent-device-android-snapshot-helper-0.21.30.manifest.json} +7 -7
  7. package/apple/macos-helper/Sources/AgentDeviceMacOSHelper/AudioProbe.swift +4 -2
  8. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+CommandDispatch.swift +2 -1
  9. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+CommandExecution.swift +12 -0
  10. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Interaction.swift +25 -0
  11. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Models.swift +8 -1
  12. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Snapshot.swift +9 -6
  13. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SnapshotCapturePlan.swift +3 -0
  14. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SynthesizedInteraction.swift +35 -9
  15. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SystemModal.swift +44 -26
  16. package/dist/apple/snapshot-presentation/Sources/AgentDeviceSnapshotPresentation/SnapshotModels.swift +20 -1
  17. package/dist/apple/snapshot-presentation/Sources/AgentDeviceSnapshotPresentation/SnapshotPresentation.swift +4 -3
  18. package/dist/apple/snapshot-presentation/Sources/AgentDeviceSnapshotPresentation/SnapshotPresentationProjection.swift +4 -2
  19. package/dist/apple/snapshot-presentation/Sources/AgentDeviceSnapshotPresentation/SnapshotVisibilityFold.swift +20 -2
  20. package/dist/src/adapter.js +1 -1
  21. package/dist/src/agent-browser-lifecycle.js +1 -1
  22. package/dist/src/agent-browser-process-record.js +1 -1
  23. package/dist/src/agent-browser-provider.js +1 -1
  24. package/dist/src/agent-device-client.js +1 -1
  25. package/dist/src/alert2.js +1 -1
  26. package/dist/src/android.js +1 -1
  27. package/dist/src/app-lifecycle.js +1 -1
  28. package/dist/src/app-log-runtime2.js +3 -3
  29. package/dist/src/auth.js +1 -1
  30. package/dist/src/automation-helper.js +1 -1
  31. package/dist/src/back-mode.js +1 -1
  32. package/dist/src/cli-config.js +1 -1
  33. package/dist/src/cli-help.js +13 -10
  34. package/dist/src/cli.js +3 -3
  35. package/dist/src/client-types.d.ts +82 -13
  36. package/dist/src/cloud-artifacts.d.ts +99 -3
  37. package/dist/src/command-metadata.js +42 -42
  38. package/dist/src/composed-inventory-gateways.js +1 -1
  39. package/dist/src/connection-runtime.js +1 -1
  40. package/dist/src/connection.js +1 -1
  41. package/dist/src/contract.d.ts +2 -2
  42. package/dist/src/contracts.d.ts +1 -1
  43. package/dist/src/daemon-client-ensure.js +1 -1
  44. package/dist/src/daemon-client-ensuring.js +1 -1
  45. package/dist/src/daemon-client-lease-beat.js +1 -1
  46. package/dist/src/daemon-client-lifecycle.js +1 -1
  47. package/dist/src/daemon-client.js +2 -2
  48. package/dist/src/daemon-lifecycle-errors.js +1 -1
  49. package/dist/src/daemon-registration-owner.js +3 -3
  50. package/dist/src/daemon-registration.js +1 -1
  51. package/dist/src/daemon-resolution.js +1 -1
  52. package/dist/src/daemon-shutdown-report.js +1 -1
  53. package/dist/src/daemon-startup-diagnostics.js +1 -1
  54. package/dist/src/daemon.js +3 -3
  55. package/dist/src/device-claim-recovery.js +1 -1
  56. package/dist/src/durable-capture-resource.js +1 -1
  57. package/dist/src/durable-resource.js +1 -1
  58. package/dist/src/ended-lease.js +1 -1
  59. package/dist/src/find.js +1 -1
  60. package/dist/src/finders.js +1 -1
  61. package/dist/src/gesture-plan-types.d.ts +14 -4
  62. package/dist/src/gesture-plan.js +1 -1
  63. package/dist/src/gesture-runtime.js +1 -1
  64. package/dist/src/host4.js +1 -1
  65. package/dist/src/index.d.ts +3 -3
  66. package/dist/src/input-actions.js +1 -1
  67. package/dist/src/input-actions2.js +1 -1
  68. package/dist/src/interaction-positionals.js +1 -1
  69. package/dist/src/interaction.js +1 -1
  70. package/dist/src/interaction2.js +1 -1
  71. package/dist/src/interactor-operation-catalog.js +1 -1
  72. package/dist/src/interactor.js +5 -5
  73. package/dist/src/interactor3.js +1 -1
  74. package/dist/src/interactor4.js +1 -1
  75. package/dist/src/internal/bin.js +1 -1
  76. package/dist/src/internal/daemon.js +1 -1
  77. package/dist/src/internal/png-worker.js +1 -1
  78. package/dist/src/inventory6.js +1 -1
  79. package/dist/src/ios-node-interpretation.js +1 -1
  80. package/dist/src/ios-snapshot-acquisition.js +1 -1
  81. package/dist/src/ios-snapshot-engine.js +1 -1
  82. package/dist/src/ios-snapshot-runtime.js +1 -1
  83. package/dist/src/keyboard-occlusion.js +1 -1
  84. package/dist/src/launch-confirmation.js +1 -1
  85. package/dist/src/lease-context.js +1 -1
  86. package/dist/src/lease-registry-scope.js +1 -1
  87. package/dist/src/lease.js +1 -1
  88. package/dist/src/local-interactor-operation-set.js +1 -1
  89. package/dist/src/mechanics.js +12 -12
  90. package/dist/src/metro-session-hints.js +1 -1
  91. package/dist/src/mobile-snapshot-semantics.js +1 -1
  92. package/dist/src/observability.js +1 -1
  93. package/dist/src/observation.js +1 -1
  94. package/dist/src/parameterized-recorded-fill.js +1 -1
  95. package/dist/src/perf-facade.js +1 -1
  96. package/dist/src/platform-runtime-operation-host.js +1 -1
  97. package/dist/src/platform-runtime-unavailable.js +1 -1
  98. package/dist/src/platform-runtime.js +1 -1
  99. package/dist/src/platform-runtime2.js +1 -1
  100. package/dist/src/plugins2.js +1 -1
  101. package/dist/src/png-resize.js +1 -1
  102. package/dist/src/png-worker-client.js +1 -1
  103. package/dist/src/png-worker-contract.js +1 -1
  104. package/dist/src/provider-device-runtime.d.ts +20 -1
  105. package/dist/src/provider-plugin.d.ts +1 -1
  106. package/dist/src/react-native-overlay2.js +1 -1
  107. package/dist/src/record-runtime.js +1 -1
  108. package/dist/src/replay-maestro-backend.js +3 -3
  109. package/dist/src/replay-script-selection.js +1 -1
  110. package/dist/src/replay.d.ts +1 -1
  111. package/dist/src/request-runtime-binding.js +1 -1
  112. package/dist/src/result-serialization.js +1 -1
  113. package/dist/src/runner-error-classification.js +1 -1
  114. package/dist/src/runtime-admission.js +1 -1
  115. package/dist/src/runtime-deployment.js +1 -1
  116. package/dist/src/runtime-factory.js +1 -1
  117. package/dist/src/runtime-session.js +1 -1
  118. package/dist/src/runtime.js +5 -5
  119. package/dist/src/runtime10.js +2 -2
  120. package/dist/src/runtime3.js +5 -5
  121. package/dist/src/runtime5.js +1 -1
  122. package/dist/src/runtime6.js +1 -1
  123. package/dist/src/runtime7.js +1 -1
  124. package/dist/src/runtime8.js +1 -1
  125. package/dist/src/runtime9.js +2 -2
  126. package/dist/src/screenshot-image-size.js +1 -0
  127. package/dist/src/screenshot-image.js +1 -1
  128. package/dist/src/screenshot-runtime.js +1 -1
  129. package/dist/src/screenshot3.js +2 -2
  130. package/dist/src/sdk-batch.js +1 -1
  131. package/dist/src/sdk-contracts.d.ts +7 -1
  132. package/dist/src/sdk-finders.js +1 -1
  133. package/dist/src/sdk-selectors.d.ts +1 -1
  134. package/dist/src/sdk-selectors.js +1 -1
  135. package/dist/src/selection.js +0 -0
  136. package/dist/src/selector-pipeline-policy.js +1 -1
  137. package/dist/src/selector-runtime.js +1 -1
  138. package/dist/src/selectors.js +1 -1
  139. package/dist/src/server-startup.js +1 -1
  140. package/dist/src/session-replay-vars.js +1 -1
  141. package/dist/src/session-store.js +2 -2
  142. package/dist/src/session.js +1 -1
  143. package/dist/src/session2.js +5 -5
  144. package/dist/src/settle-observation-capture.js +1 -1
  145. package/dist/src/snapshot-capture-annotations.js +1 -1
  146. package/dist/src/snapshot-chrome.js +1 -1
  147. package/dist/src/snapshot-desktop-projection.js +1 -1
  148. package/dist/src/snapshot-helper-install.js +7 -5
  149. package/dist/src/snapshot-node-lookup.js +1 -1
  150. package/dist/src/snapshot-occlusion.js +1 -1
  151. package/dist/src/snapshot-runtime-binding.js +1 -1
  152. package/dist/src/snapshot-runtime-capture-input.js +1 -1
  153. package/dist/src/snapshot-runtime.js +1 -1
  154. package/dist/src/snapshot-state.js +1 -1
  155. package/dist/src/snapshot.js +1 -1
  156. package/dist/src/src.js +1 -1
  157. package/dist/src/src3.js +1 -1
  158. package/dist/src/src4.js +1 -1
  159. package/dist/src/tap-keyboard-occlusion.js +1 -1
  160. package/dist/src/target-evidence-tree.js +1 -1
  161. package/dist/src/target-evidence.js +1 -1
  162. package/dist/src/telephony-runtime.js +1 -1
  163. package/dist/src/text-entry-focus.js +1 -1
  164. package/dist/src/touch-reference-frame.js +1 -1
  165. package/dist/src/touch-runtime2.js +1 -1
  166. package/dist/src/tree.js +1 -1
  167. package/dist/src/tv-remote-runtime.js +1 -1
  168. package/dist/src/tv-remote.js +2 -2
  169. package/dist/src/type-text-runtime.js +1 -1
  170. package/dist/src/video.js +1 -1
  171. package/dist/src/webdriver-source.js +1 -1
  172. package/package.json +1 -1
  173. package/server.json +2 -2
  174. package/android/ime-helper/dist/agent-device-android-ime-helper-0.21.29.apk.sha256 +0 -1
  175. package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.29.apk +0 -0
  176. package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.29.apk.sha256 +0 -1
  177. package/dist/src/daemon-client-lifecycle-request.js +0 -1
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{ft 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,St as ee,_t as p,b as m,dt as h,gt as te,pt as ne,x as g}from"./back-mode.js";import{_t as _,f as re,gt as v,ht as y,lt as ie,mt as ae,ot as oe,tt as se,vt as ce,xt as le}from"./sdk-io.js";import"./diagnostics.js";import{D as ue,O as de,c as fe,m as pe,x as me}from"./sdk-device.js";import{n as he}from"./agent-device-client.js";import{s as ge,t as _e,u as ve}from"./sdk-batch.js";import{t as ye}from"./sdk-remote-config.js";import{G as be,n as xe}from"./command-metadata.js";import"./file.js";import"./command.js";import{i as Se,n as Ce}from"./daemon-client.js";import{n as we}from"./session-artifact-paths.js";import{a as Te}from"./version.js";import{p as Ee}from"./daemon-resolution.js";import{n as De,r as Oe}from"./remote-config-core.js";import{r as b,t as ke}from"./command-schema.js";import{n as x,r as S,t as Ae}from"./cli-config.js";import{t as je}from"./update-check.js";import{n as Me,r as Ne,t as Pe}from"./cli-command-aliases.js";import{exitAfterFlush as C}from"./process-exit.js";import w from"node:crypto";import T from"node:fs";import E from"node:path";import{pathToFileURL as Fe}from"node:url";const D=`open <app> --relaunch`,Ie={start:{command:`open`,example:D},restart:{command:`open`,example:D},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 Le(e){if(e.length<=2)return[];let t=f(),n=t.filter(t=>t.startsWith(e));return n.length>0?n.sort(Re).slice(0,3):ze(e,t)}function Re(e,t){return e.length-t.length||e.localeCompare(t)}function ze(e,t){let n=t.map(t=>({name:t,distance:Ve(e,t)})).filter(t=>t.distance<=Be(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 Be(e){return e.length<4?1:e.length<=6?2:3}function Ve(e,t){return e===t?0:e.startsWith(t)||t.startsWith(e)?Math.abs(e.length-t.length):He(e,t)}function He(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 Ue(e){let t=e.toLowerCase(),n=Ie[t]?.example;if(n)return n;let r=Le(t);if(r.length!==0)return r.length===1?r[0]:`one of: ${r.join(`, `)}`}const We=new Set([`--bundle-id`,`--bundleid`,`--bundle`,`--package`,`--package-name`,`--packagename`,`--app-id`,`--appid`,`--pkg`]),Ge=new Set([`--session-locked`,`--session-lock-conflicts`]),Ke={"--output":`--out`,"--path":`--out`};function qe(e,t){let n=e.toLowerCase(),r=Ke[n];if(r&&Je(r,t))return r;let i=Ye(n,t);if(i.length!==0)return i.length===1?i[0]:`one of: ${i.join(`, `)}`}function Je(e,t){let n=g().find(t=>t.names.includes(e));return n?S(n.key,t):!1}function Ye(e,t){let n=O(e);if(n.length<=2)return[];let r=Xe(t),i=r.filter(e=>O(e).startsWith(n));return i.length>0?i.sort(Re).slice(0,3):ze(n,r.map(e=>O(e))).map(e=>`--${e}`)}function Xe(e){let t=new Set;for(let n of g()){if(!S(n.key,e))continue;let r=n.names[0];r&&t.add(r)}return[...t]}function O(e){return e.replace(/^--?/,``)}function Ze(e,t){let n=e.toLowerCase();if(We.has(n))return`Unknown flag: ${e}. The app or bundle id is a positional argument, e.g. ${D}.`;if(Ge.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=qe(e,t);return r?`Unknown flag: ${e}. Did you mean ${r}?`:`Unknown flag: ${e}`}function k(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=M(l));continue}if(tt(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=M(l));continue}let[f,ee]=u?A(l):[l,void 0];if($e(r,f))continue;let p=nt(f,r);if(et(r,p)){a.push(l);continue}if(!p){if(lt(r,a,l)){r?a.push(l):r=l;continue}throw new n(`INVALID_ARGS`,Ze(f,r))}let m=at(p,f,ee,e[o+1]);m.consumeNext&&(o+=1);let h=t[p.key];if(p.multiple){let e=Array.isArray(h)?[...h,m.value]:h===void 0?[m.value]:[h,m.value];t[p.key]=e}else t[p.key]=m.value;s.push({key:p.key,token:f})}return Qe(i,t),{command:r,positionals:a,flags:t,warnings:o,providedFlags:s}}function Qe(e,t){if(e)for(let n of Pe(e)?.impliedFlags??[])t[n]=!0}function $e(e,t){return t===`-c`&&(e===`snapshot`||e===`diff`)}function et(e,t){return e===`react-devtools`?!t||!S(t.key,e):!1}function tt(e){return e===`cdp`}function nt(e,t){let n=g().filter(t=>t.names.includes(e));if(n.length<=1)return n[0]??m(e);if(t){let e=n.find(e=>S(e.key,t));if(e)return e}return m(e)}function rt(e,t){let r=t?.strictFlags??!0,i=[...e.warnings],a=x({json:!1,help:!1,version:!1},t?.defaultFlags??{});if(x(a,e.flags),e.command&&!d(e.command)&&!a.help){let t=Ue(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=>!S(t.key,e.command));if(o.length>0){let t=o.map(e=>e.token),s=ht(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=pt(e);if(s.length>0){let t=mt(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&&(S(t,e.command)||delete a[t]);ft(e,a),it(e),ve(e.command,a);let c=dt({command:e.command,positionals:e.positionals,flags:a,warnings:i});if(ke(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 it(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 A(e){let t=e.indexOf(`=`);return t===-1?[e,void 0]:[e.slice(0,t),e.slice(t+1)]}function at(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||st(i)?{value:!0,consumeNext:!1}:ct(i)?{value:i,consumeNext:!0}:{value:!0,consumeNext:!1}}let a=r??i;if(a===void 0||r===void 0&&st(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 ${ot(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 ${ot(t)}: ${a}`);return{value:e.type===`int`?Math.floor(o):o,consumeNext:r===void 0}}function ot(e){return e.replace(/^-+/,``)}function st(e){if(!e.startsWith(`-`)||e===`-`)return!1;let[t]=e.startsWith(`--`)?A(e):[e,void 0];return m(t)!==void 0}function ct(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 lt(e,t,n){if(!ut(n)||!e)return!1;let r=b(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 ut(e){return/^-\d+(\.\d+)?$/.test(e)}function dt(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 ft(e,t){let n=b(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 pt(e){let t=b(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 mt(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 ht(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 j(){let{buildUsageText:e}=await import(`./cli-help.js`).then(e=>e.n);return e()}async function gt(e){let{buildCommandUsageText:t}=await import(`./cli-help.js`).then(e=>e.n);return t(M(e))}function M(e){let t=Ne(e);if(t)throw new n(`INVALID_ARGS`,t);return Me(e)}function _t(){return{renderedToStderr:!1}}function vt(e){return t=>{t.type===`command`&&(e.renderedToStderr=!0,process.stderr.write(`${t.message}\n`))}}function yt(e){return xe(e)}const bt={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 xt(e){let t={...e.flags},n=bt[e.command];return n&&await(await n())({...e,flags:t})?!0:yt(e.command)?await St({...e,command:e.command,flags:t}):!1}async function St(e){let{runGenericClientBackedCommand:t}=await import(`./generic.js`);return await t(e)}function Ct(e){return e===`android-instance`||e===`ios-instance`}function wt(e){return[`exec`,`--yes`,`--package`,`agent-cdp@1.6.1`,`--`,`agent-cdp`,...e]}function Tt(e){return e.some(e=>e===`--url`||e.startsWith(`--url=`))}function Et(e){return e[0]===`target`&&(e[1]===`list`||e[1]===`select`)&&!Tt(e)}function Dt(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 Ot(e){let t=e?.metroPublicBaseUrl?.trim();return t?Dt(t):null}function kt(e,t={}){if(!Et(e)||!t.flags?.metroProxyBaseUrl||!Ct(t.flags.leaseBackend))return e;let r=Ot(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 At(e,t){let n=kt(e,t);return(await se(`npm`,wt(n),{cwd:t.cwd,env:t.env,allowFailure:!0,onStdoutChunk:e=>{process.stdout.write(e)},onStderrChunk:e=>{process.stderr.write(e)}})).exitCode}const N=`${l} Run agent-device help batch for the commands batch accepts and for runnable step examples.`,jt=`${_e} Run agent-device help batch for the commands batch accepts and for runnable step examples.`;function Mt(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)=>Nt(e,t+1))}function Nt(e,t){let r=c(e,t,N),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:N})}be(r,[`command`,`input`,`runtime`],`Batch step ${t}`,N);let a=u(r.runtime,t);return{command:ge(r.command,t,jt),input:s(r,t,N),...a===void 0?{}:{runtime:a}}}function Pt(e,t){let n=P(t),r={...e};return n.defaultPlatform&&r.platform===void 0&&(r.platform=n.defaultPlatform),r}function P(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=ye.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(Oe({configPath:e.remoteConfig,cwd:e.cwd,env:e.env}).profile),remoteConfig:e.remoteConfig}:{}}function Vt(e,t){let n=k(e),{env:r,cwd:i}=t,a=Ht(n.command)?Bt({remoteConfig:n.flags.remoteConfig,cwd:i,env:r}):{},o=x(Ae({command:n.command,cwd:i,cliFlags:n.flags,env:r}),a);return{...rt(n,{strictFlags:t?.strictFlags,defaultFlags:o}),providedFlags:n.providedFlags}}function Ht(e){return e!==null}function Ut(e){return I(de(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||!me(t.platform)||!pe(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=>ue(e,t)))||ue(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(!T.existsSync(t))return null;let n;try{n=JSON.parse(T.readFileSync(t,`utf8`))}catch(t){return on(e,t),null}return cn(n)?n:(on(e),null)}function qt(e){let t=V({stateDir:e.stateDir,session:e.state.session});T.mkdirSync(E.dirname(t),{recursive:!0}),rn(t,e.state),rn(H(e.stateDir),{session:e.state.session})}function Jt(e){return{baseUrl:an(e.daemonBaseUrl),transport:e.daemonTransport,serverMode:e.daemonServerMode}}function z(e){T.rmSync(V(e),{force:!0});let t=H(e.stateDir);en(e.stateDir)===e.session&&T.rmSync(t,{force:!0})}function Yt(e){let t=e.validateRemoteConfigHash??!0,r=e.remoteConfig?De({configPath:e.remoteConfig,cwd:e.cwd,env:e.env}):void 0,i=R(e)??(e.allowActiveFallback?$t({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=nn(i,e),o=ne(i);return{runtime:i.runtime,connection:p(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,...te(o),sessionIsolation:`tenant`,session:i.session,platform:i.platform??a.platform,target:i.target??a.target}}}function Xt(e){return p(ne(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 w.createHash(`sha256`).update(T.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 E.join(e.stateDir,`remote-connections`,`${sn(e.session)}.json`)}function H(e){return E.join(e,`remote-connections`,`.active-session.json`)}function $t(e){let t=en(e.stateDir);return t?R({stateDir:e.stateDir,session:t}):null}function en(e){let t=H(e);if(T.existsSync(t))try{let e=JSON.parse(T.readFileSync(t,`utf8`));return typeof e.session==`string`?e.session:void 0}catch{return}}function tn(e){if(e)return w.createHash(`sha256`).update(e).digest(`hex`).slice(0,12)}function nn(e,t){try{return Oe({configPath:e.remoteConfigPath,cwd:t.cwd,env:t.env}).profile}catch(e){if(t.validateRemoteConfigHash===!1)return{};throw e}}function rn(e,t){ie({destination:e,contents:`${JSON.stringify(t,null,2)}\n`,mode:384})}function an(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 on(e,t){y({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 sn(e){let t=e.replaceAll(/[^a-zA-Z0-9._-]/g,`_`);return t?t===e?t:`${t}-${w.createHash(`sha256`).update(e).digest(`hex`).slice(0,8)}`:`default`}function cn(e){if(!e||typeof e!=`object`||Array.isArray(e))return!1;let t=e;return t.version===1&&ln(t,[`session`,`remoteConfigPath`,`remoteConfigHash`,`tenant`,`runId`,`connectedAt`,`updatedAt`])&&un(t,[`leaseId`,`leaseBackend`,`leaseProvider`,`deviceKey`,`clientId`])&&dn(t.daemon)}function ln(e,t){return t.every(t=>typeof e[t]==`string`)}function un(e,t){return t.every(t=>e[t]===void 0||typeof e[t]==`string`)}function dn(e){return e===void 0?!0:!e||typeof e!=`object`||Array.isArray(e)?!1:fn(e)}function fn(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 pn(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 mn=1e3;async function hn(e){return await gn({command:e.command,flags:e.flags,stateDir:e.stateDir,allowInteractiveLogin:e.command===`connect`&&!e.flags.noLogin,env:e.env})}async function gn(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 G({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 U({stateDir:e.stateDir,flags:e.flags,env:t,io:e.io});return{flags:{...e.flags,daemonAuthToken:i.accessToken},source:`login`}}async function _n(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 G({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 U({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 U(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 yn({stateDir:e.stateDir,session:u}),{accessToken:s.accessToken,expiresAt:s.expiresAt,session:u}}function vn(e){let t=W(e.stateDir);if(!T.existsSync(t))return null;try{let e=JSON.parse(T.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 yn(e){let t=W(e.stateDir);T.mkdirSync(E.dirname(t),{recursive:!0,mode:448}),T.writeFileSync(t,`${JSON.stringify(e.session,null,2)}\n`,{mode:384});try{T.chmodSync(t,384)}catch{}}function bn(e){let t=W(e.stateDir);return T.existsSync(t)?(T.rmSync(t,{force:!0}),!0):!1}function W(e){return E.join(e,`auth`,`cli-session.json`)}function xn(e){let t=vn({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 G(e){let t=vn({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(mn,(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+=mn;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 pn(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:Ce({onReplaced:In}),transportForHost:e=>Ce({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=re(process)){await oe({host:n,requestEnv:void 0},async()=>await zn(e,t,n))}async function zn(e,t,n){let r=Se(t,n),i=ae(),a=Te(),o=$n(e),s=e.includes(`--json`),c=gr(e)??n.env.AGENT_DEVICE_SESSION??`default`;await le({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 C(await Un(d));return}if(c===`web`){let{runWebCommand:e}=await import(`./web.js`);await C(await e(l,{flags:d.effectiveFlags,stateDir:d.daemonPaths.baseDir,host:n}));return}if(je({command:c,currentVersion:a,stateDir:d.daemonPaths.baseDir,flags:d.effectiveFlags}),await Wn(d,r),Bn(d.effectiveFlags),c===`cdp`){await C(await At(l,{flags:d.effectiveFlags,runtime:d.resolvedRuntime,cwd:n.cwd,env:n.env}));return}f=Kn(d);let e=await qn(d),t=_t();await Jn(d,he(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&&ce(e.daemonAuthToken)}async function Vn(e,t){let r;try{r=Vt(e,{cwd:t.host.cwd,env:t.host.env})}catch(e){y({level:`error`,phase:`cli_parse_failed`,data:{error:e instanceof Error?e.message:String(e)}});let n=i(e,{diagnosticId:_().diagnosticId,logPath:v({force:!0})?.path});return t.jsonRequested?await Q({success:!1,error:n}):await Z(n,{showDetails:t.debugEnabled}),C(1)}for(let e of r.warnings)process.stderr.write(`Warning: ${e}\n`);if(r.flags.version)return process.stdout.write(`${t.version}\n`),C(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.`)),C(1);let e=a?r.positionals[0]:r.command;if(!e)return process.stdout.write(`${await j()}\n`),C(0);let t=await gt(e);return t?(process.stdout.write(t),C(0)):(await Z(new n(`INVALID_ARGS`,er(e))),process.stdout.write(`${await j()}\n`),C(1))}return r.command?{parsed:r,command:r.command,positionals:r.positionals}:(process.stdout.write(`${await j()}\n`),C(1))}async function Hn(e,n){let r=new Set(e.providedFlags.map(e=>e.key));try{let t=P({env:n.host.env,policyOverrides:e.flags,configuredPlatform:e.flags.platform,configuredSession:e.flags.session}),i=t.lockPolicy?{...e.flags}:Pt(e.flags,{env:n.host.env,policyOverrides:e.flags,configuredPlatform:e.flags.platform,configuredSession:e.flags.session}),a=Ee(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:_().diagnosticId,logPath:v({force:!0})?.path});return e.flags.json?await Q({success:!1,error:o}):await Z(o,{showDetails:n.debugOutputEnabled}),C(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 hn({command:e.command,flags:e.effectiveFlags,stateDir:e.daemonPaths.baseDir,env:e.host.env})).flags),e.effectiveFlags.remoteConfig&&or(e.command)){let n=he(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,t,r,i){let{command:a,positionals:o,effectiveFlags:s}=e;if(a===`batch`){if(!e.parsedBatchSteps)throw new n(`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}:Pt(t.input,{env:e.host.env,policyOverrides:s,configuredPlatform:s.platform,configuredSession:s.session,inheritedPlatform:s.platform})}));if(await xt({host:e.host,command:a,positionals:o,flags:{...s,batchSteps:c},client:t,debug:e.debugOutputEnabled,replayTestReporterRuntime:r,commandProgress:i}))return}else if(a===`runtime`)throw new n(`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 xt({host:e.host,command:a,positionals:o,flags:s,client:t,debug:e.debugOutputEnabled,replayTestReporterRuntime:r,commandProgress:i}))return;throw new n(`INVALID_ARGS`,tr(a))}async function Yn(e,n,r){let a=t(e),o=i(a,{diagnosticId:_().diagnosticId,logPath:v({force:!0})?.path});if(n.command===`close`&&ir(a)){n.effectiveFlags.json&&await Q({success:!0,data:{closed:`session`,source:`no-daemon`}});return}n.effectiveFlags.json?await Q({success:!1,error:o}):(await Z(o,{showDetails:n.debugOutputEnabled}),n.debugOutputEnabled&&Zn(n,o)),r&&r(),await C(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`,we(e.daemonPaths.baseDir,n))}function Qn(e,t){try{if(T.existsSync(t)){let n=T.readFileSync(t,`utf8`).split(`
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,t,r,i){let{command:a,positionals:o,effectiveFlags:s}=e;if(a===`batch`){if(!e.parsedBatchSteps)throw new n(`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:t,debug:e.debugOutputEnabled,replayTestReporterRuntime:r,commandProgress:i}))return}else if(a===`runtime`)throw new n(`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:t,debug:e.debugOutputEnabled,replayTestReporterRuntime:r,commandProgress:i}))return;throw new n(`INVALID_ARGS`,tr(a))}async function Yn(e,n,r){let a=t(e),o=i(a,{diagnosticId:v().diagnosticId,logPath:y({force:!0})?.path});if(n.command===`close`&&ir(a)){n.effectiveFlags.json&&await Q({success:!0,data:{closed:`session`,source:`no-daemon`}});return}n.effectiveFlags.json?await Q({success:!1,error:o}):(await Z(o,{showDetails:n.debugOutputEnabled}),n.debugOutputEnabled&&Zn(n,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=k(e);return nr(t.command??``,t.providedFlags)}catch{return e.includes(`--debug`)||e.includes(`-v`)||e.includes(`--verbose`)}}function er(e){let t=Ue(e);return t?`Unknown command: ${e}. Did you mean ${t}?`:`Unknown command: ${e}`}function tr(e){return d(e)?(y({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 t=``;if(e.steps)t=e.steps;else if(e.stepsFile)try{t=T.readFileSync(e.stepsFile,`utf8`)}catch(t){let r=t instanceof Error?t.message:String(t);throw new n(`INVALID_ARGS`,`Failed to read --steps-file ${e.stepsFile}: ${r}`)}return Mt(t)}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:vt(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}Fe(process.argv[1]??``).href===import.meta.url&&$(process.argv.slice(2)).catch(async e=>{let n=t(e);await Z(i(n),{showDetails:!0}),await C(1)});function _r(e){try{let t=T.existsSync(e)?T.statSync(e).size:0,n=!1,r=setInterval(()=>{if(!n&&T.existsSync(e))try{let n=T.statSync(e);if(n.size<t&&(t=0),n.size<=t)return;let r=T.openSync(e,`r`);try{let e=Buffer.alloc(n.size-t);T.readSync(r,e,0,e.length,t),t=n.size,e.length>0&&process.stdout.write(e.toString(`utf8`))}finally{T.closeSync(r)}}catch{}},200);return()=>{n=!0,clearInterval(r)}}catch{return null}}export{Et as C,F as S,R as _,xn as a,Ut as b,Jt as c,tn as d,B as f,$t as g,Gt as h,_n as i,Xt as l,L as m,U as n,pn as o,Zt as p,bn as r,$ as runCli,Wt as s,Pn as t,Kt as u,Qt as v,qt as x,z as y};
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)?(b({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 t=``;if(e.steps)t=e.steps;else if(e.stepsFile)try{t=E.readFileSync(e.stepsFile,`utf8`)}catch(t){let r=t instanceof Error?t.message:String(t);throw new n(`INVALID_ARGS`,`Failed to read --steps-file ${e.stepsFile}: ${r}`)}return jt(t)}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 n=t(e);await Z(i(n),{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,6 +1,6 @@
1
- import { $ as NormalizedError, D as AppleApplicationState, F as SnapshotCommandOptionFields, G as SnapshotVisibility, I as SnapshotKeyboardBandFact, L as SnapshotNode, O as IosSnapshotObservation, S as DeviceTarget, T as PublicPlatform, U as SnapshotUnchanged, V as SnapshotQualityVerdict, W as SnapshotViewportSize, X as DaemonError, _ as SessionIsolationMode, a as DaemonRequest, c as DaemonServerMode, f as LeaseBackend, g as ResponseLevel, i as DaemonLockPolicy, j as PresentedSurface, k as IosTargetActivation, l as DaemonTransportPreference, m as NetworkIncludeMode, o as DaemonResponse, r as DaemonInstallSource, s as DaemonResponseData, t as DaemonArtifact, v as SessionRuntimeHints, w as PlatformSelector, x as DeviceKind, y as AppleOS } from "./sdk-contracts.js";
1
+ import { A as Point, D as AppleApplicationState, F as SnapshotCommandOptionFields, G as SnapshotViewportSize, H as SnapshotQualityVerdict, I as SnapshotKeyboardBandFact, K as SnapshotVisibility, L as SnapshotNode, O as IosSnapshotObservation, S as DeviceTarget, T as PublicPlatform, V as SnapshotQualityNote, W as SnapshotUnchanged, Z as DaemonError, _ as SessionIsolationMode, a as DaemonRequest, c as DaemonServerMode, et as NormalizedError, f as LeaseBackend, g as ResponseLevel, i as DaemonLockPolicy, j as PresentedSurface, k as IosTargetActivation, l as DaemonTransportPreference, m as NetworkIncludeMode, o as DaemonResponse, r as DaemonInstallSource, s as DaemonResponseData, t as DaemonArtifact, v as SessionRuntimeHints, w as PlatformSelector, x as DeviceKind, y as AppleOS } from "./sdk-contracts.js";
2
2
  import { t as AppsFilter } from "./app-inventory.js";
3
- import { A as OrientationRequest, C as ScrollInputDirection, D as DeviceRotation, E as TransformGestureParams, M as BackMode, O as FoldPose, S as ScrollDirection, T as SwipePreset, _ as SettingName, a as AndroidSnapshotBackendMetadata, b as ScrollCommandResult, c as ScreenshotResultData, d as MACOS_PERMISSION_TARGETS, f as MOBILE_PERMISSION_TARGETS, g as SETTINGS, i as CloudProviderSessionResult, j as SetFoldPoseInput, k as FoldScreenCoordinateSpace, l as SnapshotDiagnosticsSummary, m as PermissionMode, p as PermissionAction, s as FindLocator, t as AgentArtifactsResult, u as SessionSurface, w as SwipePattern, y as TvRemoteButton } from "./cloud-artifacts.js";
3
+ import { A as HardwareButtonName, C as ScrollInputDirection, D as DeviceRotation, E as TransformGestureParams, M as SetFoldPoseInput, N as BackMode, O as FoldPose, S as ScrollDirection, T as SwipePreset, _ as SettingName, a as AndroidSnapshotBackendMetadata, b as ScrollCommandResult, c as ScreenshotResultData, d as MACOS_PERMISSION_TARGETS, f as MOBILE_PERMISSION_TARGETS, g as SETTINGS, i as CloudProviderSessionResult, j as OrientationRequest, k as FoldScreenCoordinateSpace, l as SnapshotDiagnosticsSummary, m as PermissionMode, p as PermissionAction, s as FindLocator, t as AgentArtifactsResult, u as SessionSurface, w as SwipePattern, y as TvRemoteButton } from "./cloud-artifacts.js";
4
4
  import { _ as PressCommandResponseData, f as ClickCommandResponseData, g as LongPressCommandResponseData, h as HoverCommandResponseData, m as FindCommandResponseData, p as FillCommandResponseData, v as SettleObservation, y as ClickButton } from "./sdk-selectors.js";
5
5
  import { n as GesturePointerCount } from "./gesture-plan-types.js";
6
6
  import { c as MetroPrepareOptions, d as MetroReloadResult, l as MetroPrepareResult, o as RemoteConnectionProfileFields, r as CloudProviderProfileFields, u as MetroReloadOptions } from "./sdk-remote-config.js";
@@ -469,6 +469,7 @@ type SnapshotCaptureAnnotations = {
469
469
  androidSnapshot?: AndroidSnapshotBackendMetadata;
470
470
  freshness?: SnapshotCaptureFreshness;
471
471
  quality?: SnapshotQualityVerdict;
472
+ qualityNotes?: SnapshotQualityNote[];
472
473
  warnings?: string[];
473
474
  /** The Apple runner re-activated the session app while serving this capture (#2682). */
474
475
  targetActivation?: IosTargetActivation;
@@ -476,6 +477,7 @@ type SnapshotCaptureAnnotations = {
476
477
  };
477
478
  type PublicSnapshotCaptureAnnotations = Pick<SnapshotCaptureAnnotations, 'androidSnapshot' | 'warnings' | 'targetActivation' | 'observation'> & {
478
479
  snapshotQuality?: SnapshotQualityVerdict;
480
+ snapshotQualityNotes?: SnapshotQualityNote[];
479
481
  };
480
482
  //#endregion
481
483
  //#region packages/contracts/src/client-capture.d.ts
@@ -580,6 +582,59 @@ type CaptureDiffOptions = DeviceCommandBaseOptions & Pick<CaptureSnapshotOptions
580
582
  type SelectorSnapshotCommandOptions = Pick<CaptureSnapshotOptions, 'depth' | 'scope' | 'raw'>;
581
583
  type FindSnapshotCommandOptions = Pick<CaptureSnapshotOptions, 'depth' | 'raw'>;
582
584
  //#endregion
585
+ //#region packages/contracts/src/gesture-input.d.ts
586
+ type DragGesturePayload = {
587
+ kind: 'drag';
588
+ source: string;
589
+ destination: string;
590
+ sourceHoldMs?: number;
591
+ moveMs?: number;
592
+ destinationHoldMs?: number;
593
+ };
594
+ type PanGesturePayload = {
595
+ kind: 'pan';
596
+ origin: Point;
597
+ delta: Point;
598
+ pointerCount?: GesturePointerCount;
599
+ durationMs?: number;
600
+ };
601
+ type FlingGesturePayload = {
602
+ kind: 'fling';
603
+ direction: ScrollDirection;
604
+ origin: Point;
605
+ distance?: number;
606
+ };
607
+ type SwipeGesturePayload = {
608
+ kind: 'swipe';
609
+ preset: SwipePreset;
610
+ };
611
+ type PinchGesturePayload = {
612
+ kind: 'pinch';
613
+ scale: number;
614
+ origin?: Point;
615
+ };
616
+ type RotateGesturePayload = {
617
+ kind: 'rotate';
618
+ degrees: number;
619
+ origin?: Point;
620
+ };
621
+ type TransformGesturePayload = {
622
+ kind: 'transform';
623
+ origin: Point;
624
+ delta: Point;
625
+ scale: number;
626
+ degrees: number;
627
+ durationMs?: number;
628
+ };
629
+ type TapGesturePayload = {
630
+ kind: 'tap';
631
+ points: Point[];
632
+ holdMs?: number;
633
+ count?: number;
634
+ pauseMs?: number;
635
+ };
636
+ type GesturePayload = PanGesturePayload | FlingGesturePayload | SwipeGesturePayload | PinchGesturePayload | RotateGesturePayload | TransformGesturePayload | TapGesturePayload | DragGesturePayload;
637
+ //#endregion
583
638
  //#region packages/contracts/src/client-target.d.ts
584
639
  type PointTarget = {
585
640
  x: number;
@@ -656,6 +711,7 @@ type SwipeOptions = DeviceCommandBaseOptions & {
656
711
  pauseMs?: number;
657
712
  pattern?: SwipePattern;
658
713
  };
714
+ type GestureOptions = DeviceCommandBaseOptions & GesturePayload;
659
715
  type PanOptions = DeviceCommandBaseOptions & {
660
716
  x: number;
661
717
  y: number;
@@ -664,22 +720,14 @@ type PanOptions = DeviceCommandBaseOptions & {
664
720
  pointerCount?: GesturePointerCount;
665
721
  durationMs?: number;
666
722
  };
667
- type DragOptions = DeviceCommandBaseOptions & {
668
- source: string;
669
- destination: string;
670
- sourceHoldMs?: number;
671
- moveMs?: number;
672
- destinationHoldMs?: number;
673
- };
723
+ type DragOptions = DeviceCommandBaseOptions & Omit<DragGesturePayload, 'kind'>;
674
724
  type FlingOptions = DeviceCommandBaseOptions & {
675
725
  direction: ScrollDirection;
676
726
  x: number;
677
727
  y: number;
678
728
  distance?: number;
679
729
  };
680
- type SwipeGestureOptions = DeviceCommandBaseOptions & {
681
- preset: SwipePreset;
682
- };
730
+ type SwipeGestureOptions = DeviceCommandBaseOptions & Omit<SwipeGesturePayload, 'kind'>;
683
731
  type FocusOptions = DeviceCommandBaseOptions & {
684
732
  x: number;
685
733
  y: number;
@@ -708,6 +756,8 @@ type RotateGestureOptions = DeviceCommandBaseOptions & {
708
756
  y?: number;
709
757
  };
710
758
  type TransformGestureOptions = DeviceCommandBaseOptions & TransformGestureParams;
759
+ /** Touches 2 to 5 points and holds them for `holdMs`; `count` repeats the same contacts. */
760
+ type TapGestureOptions = DeviceCommandBaseOptions & Omit<TapGesturePayload, 'kind'>;
711
761
  type ScrollOptions = DeviceCommandBaseOptions & SettleCommandOptions & {
712
762
  direction: ScrollInputDirection;
713
763
  amount?: number;
@@ -1179,6 +1229,9 @@ type TvRemoteCommandOptions = DeviceCommandBaseOptions & {
1179
1229
  button: TvRemoteButton;
1180
1230
  durationMs?: number;
1181
1231
  };
1232
+ type HardwareButtonCommandOptions = DeviceCommandBaseOptions & {
1233
+ button: HardwareButtonName;
1234
+ };
1182
1235
  type TelephonyCommandOptions = DeviceCommandBaseOptions & TelephonyEventInput;
1183
1236
  type KeyboardCommandOptions = DeviceCommandBaseOptions & {
1184
1237
  action?: 'status' | 'dismiss' | 'enter' | 'return';
@@ -1568,6 +1621,18 @@ type TvRemoteCommandResult = {
1568
1621
  durationMs?: number;
1569
1622
  message: string;
1570
1623
  };
1624
+ /**
1625
+ * `hardware-button` — `{ action: 'hardware-button', button, message: 'Pressed hardware button <button>' }`.
1626
+ *
1627
+ * The button is the public name (`volume-up`, `volume-down`, `power`). The result reports that the
1628
+ * press was dispatched; it carries no volume level or screen state, because the command observes
1629
+ * neither (#3848).
1630
+ */
1631
+ type HardwareButtonCommandResult = {
1632
+ action: 'hardware-button';
1633
+ button: HardwareButtonName;
1634
+ message: string;
1635
+ };
1571
1636
  //#endregion
1572
1637
  //#region packages/contracts/src/clipboard.d.ts
1573
1638
  /**
@@ -1781,6 +1846,7 @@ interface CommandResultMap {
1781
1846
  fill: FillCommandResponseData;
1782
1847
  find: FindCommandResponseData;
1783
1848
  fold: FoldCommandResult;
1849
+ 'hardware-button': HardwareButtonCommandResult;
1784
1850
  home: HomeCommandResult;
1785
1851
  hover: HoverCommandResponseData;
1786
1852
  keyboard: KeyboardCommandResult;
@@ -1822,6 +1888,7 @@ type AgentDeviceCommandClient = {
1822
1888
  appSwitcher: (options?: AppSwitcherCommandOptions) => Promise<CommandResult<'app-switcher'>>;
1823
1889
  actionButton: (options?: ActionButtonCommandOptions) => Promise<CommandResult<'action-button'>>;
1824
1890
  tvRemote: (options: TvRemoteCommandOptions) => Promise<CommandResult<'tv-remote'>>;
1891
+ hardwareButton: (options: HardwareButtonCommandOptions) => Promise<CommandResult<'hardware-button'>>;
1825
1892
  telephony: (options: TelephonyCommandOptions) => Promise<CommandResult<'telephony'>>;
1826
1893
  wait: (options: WaitCommandOptions) => Promise<CommandResult<'wait'>>;
1827
1894
  alert: (options?: AlertCommandOptions) => Promise<CommandRequestResult>;
@@ -1894,6 +1961,7 @@ type AgentDeviceClient = {
1894
1961
  diff: (options: CaptureDiffOptions) => Promise<CommandResult<'diff'>>;
1895
1962
  };
1896
1963
  interactions: {
1964
+ gesture: (options: GestureOptions) => Promise<CommandRequestResult>;
1897
1965
  click: (options: ClickOptions) => Promise<CommandResult<'click'>>;
1898
1966
  press: (options: PressOptions) => Promise<CommandResult<'press'>>;
1899
1967
  longPress: (options: LongPressOptions) => Promise<CommandResult<'longpress'>>;
@@ -1910,6 +1978,7 @@ type AgentDeviceClient = {
1910
1978
  pinch: (options: PinchOptions) => Promise<CommandRequestResult>;
1911
1979
  rotateGesture: (options: RotateGestureOptions) => Promise<CommandRequestResult>;
1912
1980
  transformGesture: (options: TransformGestureOptions) => Promise<CommandRequestResult>;
1981
+ tapGesture: (options: TapGestureOptions) => Promise<CommandRequestResult>;
1913
1982
  get: (options: GetOptions) => Promise<CommandRequestResult>;
1914
1983
  is: (options: IsOptions) => Promise<CommandRequestResult>;
1915
1984
  find: (options: FindOptions) => Promise<CommandResult<'find'>>;
@@ -1940,4 +2009,4 @@ type AgentDeviceClient = {
1940
2009
  };
1941
2010
  };
1942
2011
  //#endregion
1943
- export { PerfOptions as $, AppUninstallOptions as $t, WaitCommandTarget as A, InteractionTarget as At, IsOptions as B, SelectorSnapshotCommandOptions as Bt, OrientationCommandOptions as C, EnsureDaemonOptions as Cn, ScrollOptions as Ct, TvRemoteCommandOptions as D, JsonValue as Dn, TransformGestureOptions as Dt, TelephonyCommandOptions as E, JsonPrimitive as En, SwipeOptions as Et, SessionSaveScriptOptions as F, CaptureScreenshotOptions as Ft, BatchRunOptions as G, AppInstallFromSourceOptions as Gt, IsTextPredicateOptions as H, AppCloseResult as Ht, SessionSaveScriptResult as I, CaptureScreenshotResult as It, ReplayTestOptions as J, AppListOptions as Jt, BatchStep as K, AppInstallFromSourceResult as Kt, FindBaseOptions as L, CaptureSnapshotOptions as Lt, PermissionTarget as M, RefTarget as Mt, SettingsUpdateOptions as N, SelectorTarget as Nt, ViewportCommandOptions as O, isRecord as On, TypeTextOptions as Ot, SessionCloseResult as P, CaptureDiffOptions as Pt, NetworkOptions as Q, AppTriggerEventOptions as Qt, FindOptions as R, CaptureSnapshotResult as Rt, KeyboardCommandOptions as S, DeviceCommandBaseOptions as Sn, RotateGestureOptions as St, ReactNativeCommandOptions as T, JsonObject as Tn, SwipeGestureOptions as Tt, RecordControlOptions as U, AppDeployOptions as Ut, IsStatePredicateOptions as V, AppCloseOptions as Vt, CommandRequestResult as W, AppDeployResult as Wt, EventsOptions as X, AppOpenResult as Xt, AudioOptions as Y, AppOpenOptions as Yt, LogsOptions as Z, AppPushOptions as Zt, BackCommandOptions as _, AgentDeviceSelectionOptions as _n, LongPressOptions as _t, WaitCommandResult as a, AgentDeviceCapabilitiesResult as an, HumanControlHoldOptions as at, FoldCommandOptions as b, DaemonIdentity as bn, PressOptions as bt, DebugSymbolsOptions as c, AgentDeviceSessionDevice as cn, LeaseAllocateOptions as ct, PrepareCommandResult as d, StartupPerfSample as dn, ClickOptions as dt, DeviceSelectionMetadata as en, RecordOptions as et, TriggerAppEventCommandResult as f, AgentDeviceClientConfig as fn, DragOptions as ft, AppSwitcherCommandOptions as g, AgentDeviceRequestOverrides as gn, HoverOptions as gt, AppStateCommandOptions as h, AgentDeviceIdentifiers as hn, FocusOptions as ht, TraceCommandResult as i, MaterializationReleaseResult as in, HumanControlHold as it, AlertAction as j, PointTarget as jt, WaitCommandOptions as k, ElementTarget as kt, DebugSymbolsResult as l, DeviceBootOptions as ln, LeaseOptions as lt, AlertCommandOptions as m, AgentDeviceDaemonTransportContext as mn, FlingOptions as mt, AgentDeviceCommandClient as n, DeviceSelectionSource as nn, CloudArtifactsOptions as nt, DiffSnapshotCommandResult as o, AgentDeviceDevice as on, HumanControlHoldScope as ot, ActionButtonCommandOptions as p, AgentDeviceDaemonTransport as pn, FillOptions as pt, ReplayRunOptions as q, AppInstallOptions as qt, RecordingCommandResult as r, MaterializationReleaseOptions as rn, EndedLease as rt, DoctorCommandResult as s, AgentDeviceSession as sn, Lease as st, AgentDeviceClient as t, DeviceSelectionReason as tn, TraceOptions as tt, PushCommandResult as u, DeviceShutdownOptions as un, LeaseScopedOptions as ut, ClipboardCommandOptions as v, DaemonBinding as vn, PanOptions as vt, PrepareCommandOptions as w, TargetShutdownResult as wn, SettleCommandOptions as wt, HomeCommandOptions as x, DaemonLifecycle as xn, RepeatedPressOptions as xt, DoctorCommandOptions as y, DaemonConnection as yn, PinchOptions as yt, GetOptions as z, FindSnapshotCommandOptions as zt };
2012
+ export { NetworkOptions as $, AppOpenResult as $t, WaitCommandOptions as A, JsonValue as An, TransformGestureOptions as At, GetOptions as B, CaptureSnapshotOptions as Bt, KeyboardCommandOptions as C, DaemonIdentity as Cn, RepeatedPressOptions as Ct, TelephonyCommandOptions as D, TargetShutdownResult as Dn, SwipeGestureOptions as Dt, ReactNativeCommandOptions as E, EnsureDaemonOptions as En, SettleCommandOptions as Et, SessionCloseResult as F, RefTarget as Ft, CommandRequestResult as G, AppCloseResult as Gt, IsStatePredicateOptions as H, FindSnapshotCommandOptions as Ht, SessionSaveScriptOptions as I, SelectorTarget as It, ReplayRunOptions as J, AppInstallFromSourceOptions as Jt, BatchRunOptions as K, AppDeployOptions as Kt, SessionSaveScriptResult as L, CaptureDiffOptions as Lt, AlertAction as M, ElementTarget as Mt, PermissionTarget as N, InteractionTarget as Nt, TvRemoteCommandOptions as O, JsonObject as On, SwipeOptions as Ot, SettingsUpdateOptions as P, PointTarget as Pt, LogsOptions as Q, AppOpenOptions as Qt, FindBaseOptions as R, CaptureScreenshotOptions as Rt, HomeCommandOptions as S, DaemonConnection as Sn, PressOptions as St, PrepareCommandOptions as T, DeviceCommandBaseOptions as Tn, ScrollOptions as Tt, IsTextPredicateOptions as U, SelectorSnapshotCommandOptions as Ut, IsOptions as V, CaptureSnapshotResult as Vt, RecordControlOptions as W, AppCloseOptions as Wt, AudioOptions as X, AppInstallOptions as Xt, ReplayTestOptions as Y, AppInstallFromSourceResult as Yt, EventsOptions as Z, AppListOptions as Zt, BackCommandOptions as _, AgentDeviceDaemonTransportContext as _n, GestureOptions as _t, WaitCommandResult as a, DeviceSelectionSource as an, HumanControlHold as at, FoldCommandOptions as b, AgentDeviceSelectionOptions as bn, PanOptions as bt, DebugSymbolsOptions as c, AgentDeviceCapabilitiesResult as cn, Lease as ct, PrepareCommandResult as d, AgentDeviceSessionDevice as dn, LeaseScopedOptions as dt, AppPushOptions as en, PerfOptions as et, TriggerAppEventCommandResult as f, DeviceBootOptions as fn, ClickOptions as ft, AppSwitcherCommandOptions as g, AgentDeviceDaemonTransport as gn, FocusOptions as gt, AppStateCommandOptions as h, AgentDeviceClientConfig as hn, FlingOptions as ht, TraceCommandResult as i, DeviceSelectionReason as in, EndedLease as it, WaitCommandTarget as j, isRecord as jn, TypeTextOptions as jt, ViewportCommandOptions as k, JsonPrimitive as kn, TapGestureOptions as kt, DebugSymbolsResult as l, AgentDeviceDevice as ln, LeaseAllocateOptions as lt, AlertCommandOptions as m, StartupPerfSample as mn, FillOptions as mt, AgentDeviceCommandClient as n, AppUninstallOptions as nn, TraceOptions as nt, DiffSnapshotCommandResult as o, MaterializationReleaseOptions as on, HumanControlHoldOptions as ot, ActionButtonCommandOptions as p, DeviceShutdownOptions as pn, DragOptions as pt, BatchStep as q, AppDeployResult as qt, RecordingCommandResult as r, DeviceSelectionMetadata as rn, CloudArtifactsOptions as rt, DoctorCommandResult as s, MaterializationReleaseResult as sn, HumanControlHoldScope as st, AgentDeviceClient as t, AppTriggerEventOptions as tn, RecordOptions as tt, PushCommandResult as u, AgentDeviceSession as un, LeaseOptions as ut, ClipboardCommandOptions as v, AgentDeviceIdentifiers as vn, HoverOptions as vt, OrientationCommandOptions as w, DaemonLifecycle as wn, RotateGestureOptions as wt, HardwareButtonCommandOptions as x, DaemonBinding as xn, PinchOptions as xt, DoctorCommandOptions as y, AgentDeviceRequestOverrides as yn, LongPressOptions as yt, FindOptions as z, CaptureScreenshotResult as zt };
@@ -1,4 +1,4 @@
1
- import { H as SnapshotState, L as SnapshotNode, N as Rect, O as IosSnapshotObservation, P as ScreenshotOverlayRef, T as PublicPlatform, V as SnapshotQualityVerdict, W as SnapshotViewportSize, n as DaemonArtifactType } from "./sdk-contracts.js";
1
+ import { G as SnapshotViewportSize, H as SnapshotQualityVerdict, L as SnapshotNode, N as Rect, O as IosSnapshotObservation, P as ScreenshotOverlayRef, T as PublicPlatform, U as SnapshotState, V as SnapshotQualityNote, n as DaemonArtifactType } from "./sdk-contracts.js";
2
2
  import { v as SettleObservation } from "./sdk-selectors.js";
3
3
  //#region packages/contracts/src/back-mode.d.ts
4
4
  declare const BACK_MODES: readonly ['in-app', 'system'];
@@ -13,6 +13,12 @@ type DeviceRotation = (typeof DEVICE_ROTATIONS)[number];
13
13
  /** A rotation to lock the device in, or `auto` to hand rotation back to the sensor. */
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
+ /**
17
+ * The public positional names of the hardware keys: `volume-up`, `volume-down`, `power`.
18
+ * The literals are the same ones SYSTEM_BUTTON_LABELS carries for these buttons; the label
19
+ * owner's type-level check and the contracts tests refuse drift between the two lists.
20
+ */
21
+ type HardwareButtonName = 'volume-up' | 'volume-down' | 'power';
16
22
  /**
17
23
  * The three hinge poses a foldable Apple device can be put in, named after what an agent sees
18
24
  * rather than after Apple's `UIHinge.Status` cases: `closed` lights the outer panel only,
@@ -184,9 +190,98 @@ declare const TV_REMOTE_BUTTON_DEFINITIONS: {
184
190
  readonly appleRemoteButton: 'menu';
185
191
  readonly vegaKey: 'KEY_BACK';
186
192
  };
193
+ readonly 'volume-up': {
194
+ readonly aliases: readonly [];
195
+ readonly androidKeyevent: '24';
196
+ };
197
+ readonly 'volume-down': {
198
+ readonly aliases: readonly [];
199
+ readonly androidKeyevent: '25';
200
+ };
201
+ readonly mute: {
202
+ readonly aliases: readonly [];
203
+ readonly androidKeyevent: '164';
204
+ };
205
+ readonly power: {
206
+ readonly aliases: readonly [];
207
+ readonly androidKeyevent: '26';
208
+ };
209
+ readonly sleep: {
210
+ readonly aliases: readonly [];
211
+ readonly androidKeyevent: '223';
212
+ };
213
+ readonly wake: {
214
+ readonly aliases: readonly [];
215
+ readonly androidKeyevent: '224';
216
+ };
217
+ readonly 'media-play-pause': {
218
+ readonly aliases: readonly [];
219
+ readonly androidKeyevent: '85';
220
+ };
221
+ readonly 'media-next': {
222
+ readonly aliases: readonly [];
223
+ readonly androidKeyevent: '87';
224
+ };
225
+ readonly 'media-previous': {
226
+ readonly aliases: readonly [];
227
+ readonly androidKeyevent: '88';
228
+ };
229
+ readonly 'media-rewind': {
230
+ readonly aliases: readonly [];
231
+ readonly androidKeyevent: '89';
232
+ };
233
+ readonly 'media-fast-forward': {
234
+ readonly aliases: readonly [];
235
+ readonly androidKeyevent: '90';
236
+ };
237
+ readonly 'channel-up': {
238
+ readonly aliases: readonly [];
239
+ readonly androidKeyevent: '166';
240
+ };
241
+ readonly 'channel-down': {
242
+ readonly aliases: readonly [];
243
+ readonly androidKeyevent: '167';
244
+ };
245
+ readonly 'last-channel': {
246
+ readonly aliases: readonly [];
247
+ readonly androidKeyevent: '229';
248
+ };
249
+ readonly guide: {
250
+ readonly aliases: readonly [];
251
+ readonly androidKeyevent: '172';
252
+ };
253
+ readonly info: {
254
+ readonly aliases: readonly [];
255
+ readonly androidKeyevent: '165';
256
+ };
257
+ readonly captions: {
258
+ readonly aliases: readonly [];
259
+ readonly androidKeyevent: '175';
260
+ };
261
+ readonly 'tv-input': {
262
+ readonly aliases: readonly [];
263
+ readonly androidKeyevent: '178';
264
+ };
265
+ readonly 'color-red': {
266
+ readonly aliases: readonly [];
267
+ readonly androidKeyevent: '183';
268
+ };
269
+ readonly 'color-green': {
270
+ readonly aliases: readonly [];
271
+ readonly androidKeyevent: '184';
272
+ };
273
+ readonly 'color-yellow': {
274
+ readonly aliases: readonly [];
275
+ readonly androidKeyevent: '185';
276
+ };
277
+ readonly 'color-blue': {
278
+ readonly aliases: readonly [];
279
+ readonly androidKeyevent: '186';
280
+ };
187
281
  };
188
282
  declare const TV_REMOTE_BUTTONS: (keyof typeof TV_REMOTE_BUTTON_DEFINITIONS)[];
189
- type TvRemoteButton = (typeof TV_REMOTE_BUTTONS)[number];
283
+ type NamedTvRemoteButton = (typeof TV_REMOTE_BUTTONS)[number];
284
+ type TvRemoteButton = NamedTvRemoteButton | `android-keycode:${number}`;
190
285
  //#endregion
191
286
  //#region packages/contracts/src/settings-catalog.d.ts
192
287
  /**
@@ -401,6 +496,7 @@ type BackendSnapshotResult = {
401
496
  reason?: 'empty-interactive' | 'sharp-drop' | 'stuck-route';
402
497
  };
403
498
  quality?: SnapshotQualityVerdict;
499
+ qualityNotes?: SnapshotQualityNote[];
404
500
  warnings?: string[];
405
501
  observation?: IosSnapshotObservation;
406
502
  };
@@ -509,4 +605,4 @@ type CloudArtifactProvider = {
509
605
  listCloudArtifacts?: (query: CloudArtifactsQuery) => Promise<CloudArtifactsResult | undefined>;
510
606
  };
511
607
  //#endregion
512
- export { OrientationRequest as A, ScrollInputDirection as C, DeviceRotation as D, TransformGestureParams as E, BackMode as M, FoldPose as O, ScrollDirection as S, SwipePreset as T, SettingName as _, AndroidSnapshotBackendMetadata as a, ScrollCommandResult as b, ScreenshotResultData as c, MACOS_PERMISSION_TARGETS as d, MOBILE_PERMISSION_TARGETS as f, SETTINGS as g, ReadableSetting as h, CloudProviderSessionResult as i, SetFoldPoseInput as j, FoldScreenCoordinateSpace as k, SnapshotDiagnosticsSummary as l, PermissionMode as m, CloudArtifactProvider as n, BackendSnapshotResult as o, PermissionAction as p, CloudArtifactsResult as r, FindLocator as s, AgentArtifactsResult as t, SessionSurface as u, TextSizeCategory as v, SwipePattern as w, ScrollExecutionOptions as x, TvRemoteButton as y };
608
+ export { HardwareButtonName as A, ScrollInputDirection as C, DeviceRotation as D, TransformGestureParams as E, SetFoldPoseInput as M, BackMode as N, FoldPose as O, ScrollDirection as S, SwipePreset as T, SettingName as _, AndroidSnapshotBackendMetadata as a, ScrollCommandResult as b, ScreenshotResultData as c, MACOS_PERMISSION_TARGETS as d, MOBILE_PERMISSION_TARGETS as f, SETTINGS as g, ReadableSetting as h, CloudProviderSessionResult as i, OrientationRequest as j, FoldScreenCoordinateSpace as k, SnapshotDiagnosticsSummary as l, PermissionMode as m, CloudArtifactProvider as n, BackendSnapshotResult as o, PermissionAction as p, CloudArtifactsResult as r, FindLocator as s, AgentArtifactsResult as t, SessionSurface as u, TextSizeCategory as v, SwipePattern as w, ScrollExecutionOptions as x, TvRemoteButton as y };