agent-device 0.21.30 → 0.21.31

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (304) hide show
  1. package/android/ime-helper/dist/{agent-device-android-ime-helper-0.21.30.apk → agent-device-android-ime-helper-0.21.31.apk} +0 -0
  2. package/android/ime-helper/dist/agent-device-android-ime-helper-0.21.31.apk.sha256 +1 -0
  3. package/android/ime-helper/dist/{agent-device-android-ime-helper-0.21.30.manifest.json → agent-device-android-ime-helper-0.21.31.manifest.json} +4 -4
  4. package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.31.apk +0 -0
  5. package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.31.apk.sha256 +1 -0
  6. package/android/snapshot-helper/dist/{agent-device-android-snapshot-helper-0.21.30.manifest.json → agent-device-android-snapshot-helper-0.21.31.manifest.json} +7 -7
  7. package/apple/macos-helper/Sources/AgentDeviceMacOSHelper/BackgroundInteraction.swift +20 -6
  8. package/apple/snapshot-bridge/README.md +16 -3
  9. package/apple/snapshot-bridge/SnapshotBridgeRuntime.m +33 -1
  10. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunner/AgentDeviceRunnerApp.m +110 -8
  11. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerAppScreenCapture.swift +20 -0
  12. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerSynthesizedGesture.m +4 -4
  13. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+AXSnapshotFallback.swift +1 -1
  14. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+CommandExecution.swift +30 -4
  15. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Interaction.swift +14 -4
  16. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Navigation.swift +81 -41
  17. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SequenceExecution.swift +40 -6
  18. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SnapshotAcquisition.swift +5 -0
  19. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SnapshotCapturePlan.swift +74 -10
  20. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SnapshotTiming.swift +33 -4
  21. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SynthesizedCommitDeadline.swift +2 -2
  22. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SynthesizedGesturePolicy.swift +23 -2
  23. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+SynthesizedInteraction.swift +158 -6
  24. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TextEntry.swift +165 -70
  25. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TextEntryConfirmation.swift +2 -3
  26. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TextEntryFocus.swift +49 -27
  27. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TextEntryReadiness.swift +17 -9
  28. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TextInputProbe.swift +30 -28
  29. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+TextTyping.swift +87 -87
  30. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests.swift +4 -3
  31. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerXCTestEventBridge.h +13 -0
  32. package/dist/apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerXCTestEventBridge.m +45 -0
  33. package/dist/src/absence-observation-errors.js +1 -1
  34. package/dist/src/adapter.js +1 -1
  35. package/dist/src/adb-executor.js +1 -1
  36. package/dist/src/adb-failure.js +2 -2
  37. package/dist/src/agent-browser-lifecycle.js +1 -1
  38. package/dist/src/agent-browser-process-record.js +1 -1
  39. package/dist/src/agent-browser-provider.js +1 -1
  40. package/dist/src/agent-browser-tool.js +1 -1
  41. package/dist/src/agent-device-client.js +1 -1
  42. package/dist/src/alert-tree-driver.js +1 -1
  43. package/dist/src/alert.js +1 -1
  44. package/dist/src/alert2.js +1 -1
  45. package/dist/src/android.js +1 -1
  46. package/dist/src/app-backend.js +1 -1
  47. package/dist/src/app-launch.js +1 -1
  48. package/dist/src/app-lifecycle.js +4 -4
  49. package/dist/src/app-log-runtime2.js +3 -3
  50. package/dist/src/app-log-session-resource.js +1 -1
  51. package/dist/src/app-resolution-facade.js +1 -1
  52. package/dist/src/app-resolution.js +2 -2
  53. package/dist/src/apple-runner-platform.js +1 -1
  54. package/dist/src/application-lifecycle-interaction.js +1 -1
  55. package/dist/src/artifact-tracking.js +1 -1
  56. package/dist/src/automation-helper-artifact.js +1 -1
  57. package/dist/src/automation-helper.js +1 -1
  58. package/dist/src/back-mode.js +1 -1
  59. package/dist/src/boot-diagnostics.js +1 -1
  60. package/dist/src/browser-launch.js +1 -1
  61. package/dist/src/cli-config.js +1 -1
  62. package/dist/src/cli-help.js +35 -29
  63. package/dist/src/cli-runner.js +1 -1
  64. package/dist/src/cli.js +3 -3
  65. package/dist/src/client-metro-companion.js +1 -1
  66. package/dist/src/client-metro.js +1 -1
  67. package/dist/src/client-types.d.ts +3 -3
  68. package/dist/src/cloud-artifacts.d.ts +5 -4
  69. package/dist/src/code-signature-cache.js +1 -1
  70. package/dist/src/command-metadata.js +10 -10
  71. package/dist/src/command-tools.js +2 -2
  72. package/dist/src/command.js +1 -1
  73. package/dist/src/composed-inventory-gateways.js +1 -1
  74. package/dist/src/connection-runtime.js +1 -1
  75. package/dist/src/connection.js +5 -5
  76. package/dist/src/contracts.js +1 -1
  77. package/dist/src/daemon-client-ensure.js +1 -1
  78. package/dist/src/daemon-client-lease-beat.js +1 -1
  79. package/dist/src/daemon-client-lifecycle.js +1 -1
  80. package/dist/src/daemon-client-liveness-probe.js +1 -1
  81. package/dist/src/daemon-client.js +1 -1
  82. package/dist/src/daemon-command-registry.js +1 -1
  83. package/dist/src/daemon-composition.js +1 -1
  84. package/dist/src/daemon-policy-file.js +1 -1
  85. package/dist/src/daemon-registration-owner.js +3 -3
  86. package/dist/src/daemon-resolution.js +1 -1
  87. package/dist/src/daemon-startup-diagnostics.js +1 -1
  88. package/dist/src/debug-symbols-facade.js +3 -3
  89. package/dist/src/device-claim-recovery.js +1 -1
  90. package/dist/src/device-claims.js +1 -1
  91. package/dist/src/device-inventory-context.js +1 -1
  92. package/dist/src/device-readiness-runtime.js +1 -1
  93. package/dist/src/device-selection-resolver.js +1 -1
  94. package/dist/src/device.js +1 -1
  95. package/dist/src/devicectl.js +1 -1
  96. package/dist/src/diagnostics.js +1 -1
  97. package/dist/src/display-inventory.js +1 -1
  98. package/dist/src/doctor-facade.js +1 -1
  99. package/dist/src/durable-capture-resource.js +1 -1
  100. package/dist/src/durable-resource.js +1 -1
  101. package/dist/src/engine-eval-script.js +1 -1
  102. package/dist/src/error.js +1 -1
  103. package/dist/src/explicit-session-resolution.js +1 -1
  104. package/dist/src/expo-dev-client-launch.js +1 -1
  105. package/dist/src/file.js +1 -1
  106. package/dist/src/find.js +1 -1
  107. package/dist/src/finders.js +1 -1
  108. package/dist/src/gesture-admission.js +1 -1
  109. package/dist/src/gesture-plan.js +1 -1
  110. package/dist/src/gesture-runtime.js +1 -1
  111. package/dist/src/hdc.js +1 -1
  112. package/dist/src/helper.js +2 -2
  113. package/dist/src/host.js +1 -1
  114. package/dist/src/host2.js +1 -1
  115. package/dist/src/host3.js +1 -1
  116. package/dist/src/host4.js +1 -1
  117. package/dist/src/host5.js +1 -0
  118. package/dist/src/human-control.js +1 -1
  119. package/dist/src/ime-rebind.js +1 -1
  120. package/dist/src/ime-state.js +1 -1
  121. package/dist/src/index.js +1 -1
  122. package/dist/src/input-actions.js +1 -1
  123. package/dist/src/input-actions2.js +1 -1
  124. package/dist/src/install-source-network-transport.js +1 -1
  125. package/dist/src/install-source2.js +1 -1
  126. package/dist/src/interaction-positionals.js +1 -1
  127. package/dist/src/interaction.js +1 -1
  128. package/dist/src/interaction2.js +1 -1
  129. package/dist/src/interactor-operation-catalog.js +1 -1
  130. package/dist/src/interactor.js +5 -5
  131. package/dist/src/interactor2.js +1 -1
  132. package/dist/src/interactor3.js +1 -1
  133. package/dist/src/interactor4.js +1 -1
  134. package/dist/src/interactor5.js +1 -1
  135. package/dist/src/interactors.js +1 -1
  136. package/dist/src/internal/bin.js +1 -1
  137. package/dist/src/internal/daemon.js +1 -1
  138. package/dist/src/internal/png-worker.js +1 -1
  139. package/dist/src/inventory.js +1 -1
  140. package/dist/src/inventory2.js +1 -1
  141. package/dist/src/inventory6.js +1 -1
  142. package/dist/src/ios-node-interpretation.js +1 -1
  143. package/dist/src/ios-settings.js +1 -1
  144. package/dist/src/ios-snapshot-acquisition.js +1 -1
  145. package/dist/src/ios-snapshot-engine.js +1 -1
  146. package/dist/src/ios-snapshot-runtime.js +1 -1
  147. package/dist/src/keyboard-occlusion.js +1 -1
  148. package/dist/src/keyed-lock.js +1 -1
  149. package/dist/src/launch-confirmation.js +1 -1
  150. package/dist/src/launch-services-registration.js +4 -4
  151. package/dist/src/lease.js +1 -1
  152. package/dist/src/legacy.js +1 -1
  153. package/dist/src/limrun-runtime-dependencies.js +1 -1
  154. package/dist/src/local-interactor-operation-set.js +1 -1
  155. package/dist/src/mechanics.js +12 -12
  156. package/dist/src/mobile-snapshot-semantics.js +1 -1
  157. package/dist/src/observability.js +1 -1
  158. package/dist/src/output-path.js +1 -1
  159. package/dist/src/parameterized-recorded-fill.js +1 -1
  160. package/dist/src/perf-facade.js +1 -1
  161. package/dist/src/perf-runtime-operation-builder.js +1 -1
  162. package/dist/src/perf-target.js +1 -1
  163. package/dist/src/physical-device-control.js +1 -1
  164. package/dist/src/platform-runtime-android-adb-host.js +1 -1
  165. package/dist/src/platform-runtime-claim-recovery.js +1 -1
  166. package/dist/src/platform-runtime-daemon-services.js +1 -1
  167. package/dist/src/platform-runtime-host.js +1 -1
  168. package/dist/src/platform-runtime-open-target.js +1 -1
  169. package/dist/src/platform-runtime-operation-host.js +5 -5
  170. package/dist/src/platform-runtime-runtime-hints.js +2 -2
  171. package/dist/src/platform-runtime-screen-recording-apple-simulator-host.js +1 -1
  172. package/dist/src/platform-runtime-screen-recording-finalizer-host.js +1 -1
  173. package/dist/src/platform-runtime-unavailable.js +1 -1
  174. package/dist/src/platform-runtime.js +1 -1
  175. package/dist/src/platform-runtime2.js +1 -1
  176. package/dist/src/png-resize.js +1 -1
  177. package/dist/src/png-worker-client.js +1 -1
  178. package/dist/src/process-exit.js +1 -1
  179. package/dist/src/provider-device-runtime.d.ts +28 -0
  180. package/dist/src/provider-plugin-catalog.js +2 -0
  181. package/dist/src/provider-plugin.d.ts +1 -1
  182. package/dist/src/provider-webdriver.js +1 -1
  183. package/dist/src/proxy.js +1 -1
  184. package/dist/src/react-native-overlay2.js +1 -1
  185. package/dist/src/react-native.js +1 -1
  186. package/dist/src/react-profile-command.js +1 -1
  187. package/dist/src/record-runtime.js +1 -1
  188. package/dist/src/record-trace.js +1 -1
  189. package/dist/src/recording-scope.js +1 -1
  190. package/dist/src/recording.js +1 -1
  191. package/dist/src/registry.js +1 -1
  192. package/dist/src/remote-config-core.js +1 -1
  193. package/dist/src/replay-backend-host.js +1 -1
  194. package/dist/src/replay-divergence.js +1 -1
  195. package/dist/src/replay-maestro-backend.js +3 -3
  196. package/dist/src/replay-script-selection.js +1 -1
  197. package/dist/src/replay2.js +1 -1
  198. package/dist/src/request-runtime-binding.js +1 -1
  199. package/dist/src/request.js +1 -1
  200. package/dist/src/result-serialization.js +1 -1
  201. package/dist/src/retry.js +1 -1
  202. package/dist/src/runner-cache-retention.js +1 -1
  203. package/dist/src/runner-client.js +1 -1
  204. package/dist/src/runner-dev-tools-security.js +1 -1
  205. package/dist/src/runner-device-readiness.js +1 -1
  206. package/dist/src/runner-device-set.js +1 -1
  207. package/dist/src/runner-error-classification.js +2 -2
  208. package/dist/src/runner-exchange.js +1 -1
  209. package/dist/src/runner-lease.js +1 -1
  210. package/dist/src/runner-operations-facade.js +1 -1
  211. package/dist/src/runner-retention.js +1 -1
  212. package/dist/src/runner-selector-query.js +1 -1
  213. package/dist/src/runner-start-budget.js +1 -1
  214. package/dist/src/runner-startup-transport.js +1 -1
  215. package/dist/src/runner-toolchain-probe.js +1 -1
  216. package/dist/src/runner.js +2 -2
  217. package/dist/src/runtime-admission.js +1 -1
  218. package/dist/src/runtime-deployment.js +1 -1
  219. package/dist/src/runtime-factory.js +1 -1
  220. package/dist/src/runtime-session.js +1 -1
  221. package/dist/src/runtime.js +4 -4
  222. package/dist/src/runtime10.js +2 -2
  223. package/dist/src/runtime2.js +1 -1
  224. package/dist/src/runtime3.js +5 -5
  225. package/dist/src/runtime4.js +1 -1
  226. package/dist/src/runtime5.js +1 -1
  227. package/dist/src/runtime6.js +1 -1
  228. package/dist/src/runtime7.js +1 -1
  229. package/dist/src/runtime8.js +1 -1
  230. package/dist/src/runtime9.js +2 -2
  231. package/dist/src/screen-recording-transport.js +1 -1
  232. package/dist/src/screenshot-density.js +1 -1
  233. package/dist/src/screenshot-runtime.js +1 -1
  234. package/dist/src/screenshot3.js +1 -1
  235. package/dist/src/sdk-batch-runner.js +2 -2
  236. package/dist/src/sdk-batch.js +2 -2
  237. package/dist/src/sdk-contracts.d.ts +9 -0
  238. package/dist/src/sdk-contracts.js +2 -2
  239. package/dist/src/sdk-device.js +1 -1
  240. package/dist/src/sdk-finders.js +1 -1
  241. package/dist/src/sdk-io.js +5 -5
  242. package/dist/src/sdk-remote-config.js +1 -1
  243. package/dist/src/sdk-selectors.js +1 -1
  244. package/dist/src/selection.js +0 -0
  245. package/dist/src/selector-pipeline-policy.js +1 -1
  246. package/dist/src/selector-runtime.js +1 -1
  247. package/dist/src/selectors.js +1 -1
  248. package/dist/src/server-startup.js +1 -1
  249. package/dist/src/session-paths.js +1 -1
  250. package/dist/src/session-replay-vars.js +1 -1
  251. package/dist/src/session-runtime.js +1 -1
  252. package/dist/src/session-store.js +3 -3
  253. package/dist/src/session.js +1 -1
  254. package/dist/src/session2.js +5 -5
  255. package/dist/src/settings-bluetooth.js +1 -1
  256. package/dist/src/settings.js +1 -1
  257. package/dist/src/settings2.js +1 -1
  258. package/dist/src/settle-observation-capture.js +1 -1
  259. package/dist/src/simctl-settings.js +1 -1
  260. package/dist/src/simctl.js +1 -1
  261. package/dist/src/simulator-boot.js +1 -1
  262. package/dist/src/simulator-state.js +1 -1
  263. package/dist/src/simulator.js +1 -1
  264. package/dist/src/snapshot-chrome.js +1 -1
  265. package/dist/src/snapshot-desktop-projection.js +1 -1
  266. package/dist/src/snapshot-helper-install.js +6 -6
  267. package/dist/src/snapshot-node-lookup.js +1 -1
  268. package/dist/src/snapshot-occlusion.js +1 -1
  269. package/dist/src/snapshot-runtime-binding.js +1 -1
  270. package/dist/src/snapshot-runtime-capture-input.js +1 -1
  271. package/dist/src/snapshot-runtime.js +1 -1
  272. package/dist/src/snapshot-state.js +1 -1
  273. package/dist/src/snapshot.js +1 -1
  274. package/dist/src/snapshot3.js +1 -1
  275. package/dist/src/src.js +1 -1
  276. package/dist/src/src3.js +1 -1
  277. package/dist/src/src4.js +1 -1
  278. package/dist/src/store.js +1 -1
  279. package/dist/src/tap-keyboard-occlusion.js +1 -1
  280. package/dist/src/target-evidence-tree.js +1 -1
  281. package/dist/src/target-evidence.js +1 -1
  282. package/dist/src/telephony-runtime.js +1 -1
  283. package/dist/src/text-entry-focus.js +1 -1
  284. package/dist/src/tool-provider.js +3 -3
  285. package/dist/src/tool-provider2.js +1 -1
  286. package/dist/src/tool-provider3.js +1 -1
  287. package/dist/src/toolchain-probe.js +1 -1
  288. package/dist/src/touch-reference-frame.js +1 -1
  289. package/dist/src/touch-runtime.js +1 -1
  290. package/dist/src/touch-runtime2.js +1 -1
  291. package/dist/src/tree.js +1 -1
  292. package/dist/src/tv-remote-runtime.js +1 -1
  293. package/dist/src/tv-remote.js +2 -2
  294. package/dist/src/type-text-runtime.js +1 -1
  295. package/dist/src/update-check.js +1 -1
  296. package/dist/src/vega-executable.js +1 -1
  297. package/dist/src/video.js +1 -1
  298. package/dist/src/webdriver-source.js +1 -1
  299. package/package.json +7 -6
  300. package/server.json +2 -2
  301. package/android/ime-helper/dist/agent-device-android-ime-helper-0.21.30.apk.sha256 +0 -1
  302. package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.30.apk +0 -0
  303. package/android/snapshot-helper/dist/agent-device-android-snapshot-helper-0.21.30.apk.sha256 +0 -1
  304. package/dist/src/physical-device-apps.js +0 -1
@@ -1 +1 @@
1
- import{B as e,C as t,L as n,N as r,R as i,S as a,T as o,W as s,Z as c,b as l,k as u,w as d}from"./sdk-contracts.js";import{kt as f}from"./tv-remote.js";import{a as p,t as m}from"./snapshot-capture-annotations.js";import{r as h}from"./snapshot-private-evidence.js";import{_ as g,c as _,d as v,g as ee,h as y,l as b,m as x,p as te,v as S}from"./back-mode.js";import{$n as ne,An as re,Gn as ie,In as ae,Kn as oe,Lr as se,Nr as C,On as w,Pn as ce,Sr as le,Un as ue,Vr as de,Wn as T,Wr as fe,Xn as pe,br as me,ei as he,er as E,gn as ge,hr as _e,oi as ve,qn as ye,rr as be,tr as xe,xr as Se,zn as Ce}from"./sdk-batch.js";import{n as we,r as Te,t as Ee}from"./target-evidence-tree.js";import{r as D}from"./success-text.js";import{n as De,t as Oe}from"./mobile-snapshot-semantics.js";import{n as ke,t as O}from"./interaction-error.js";import{n as Ae,r as je,t as Me}from"./absence-observation-errors.js";import{t as Ne}from"./android-snapshot-quality.js";import{c as Pe}from"./device-shell.js";import{a as Fe,n as Ie,r as Le,t as Re}from"./rect-center.js";import{a as ze,n as Be,t as Ve}from"./gesture-plan.js";import{T as He,a as Ue,d as We,f as Ge,h as Ke,i as k,m as qe,n as Je,o as Ye,r as Xe,t as A,u as Ze}from"./selector-pipeline-policy.js";import{n as Qe,r as $e}from"./snapshot-chrome.js";import{a as et,n as tt,o as nt}from"./png-worker-client.js";import{o as rt}from"./png-worker-contract.js";import{i as it}from"./png-resize.js";import{i as at}from"./ios-system-surface.js";import{t as j}from"./snapshot-baseline.js";import{n as ot,t as M}from"./snapshot-node-lookup.js";import{n as st,t as N}from"./snapshot-quality-verdict.js";import{n as ct}from"./command-policy.js";import{t as lt}from"./android-system-surface-disclosure.js";import{n as ut}from"./react-native-overlay2.js";import{n as dt,r as ft,t as pt}from"./keyboard-occlusion.js";import{n as mt,t as ht}from"./snapshot-evidence.js";import{n as gt,r as _t}from"./quality-warnings.js";import{n as vt,t as P}from"./wait.js";import{n as yt,t as bt}from"./replay.js";import{n as xt}from"./ios-snapshot-acquisition.js";import{promises as F}from"node:fs";import St from"node:path";function I(e,t){return{session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata}}function L(e){return e.clock?.now()??Date.now()}async function Ct(e,t){e.clock?await e.clock.sleep(t):await new Promise(e=>setTimeout(e,t))}function wt(e,t){return Object.fromEntries(Object.entries(e).map(([e,n])=>[e,e=>n(t,e)]))}function R(e){return e&&typeof e==`object`?e:void 0}async function z(e,t,n){if(!e.backend.captureSnapshot)throw new i(`UNSUPPORTED_OPERATION`,`snapshot is not supported by this backend`);let r=t.session??`default`,a=await e.sessions.get(r);if(!a)throw new i(`SESSION_NOT_FOUND`,`No active session. Run open first.`);let o=(await e.backend.captureSnapshot(I(e,t),{interactiveOnly:n,includeRects:!0})).snapshot;return await e.sessions.set({...a,snapshot:o}),{snapshot:o}}function Tt(e,t){if(!e||e.surfaceBundleId===t.surfaceBundleId)return;let n={from:e.surfaceBundleId??`app`,to:t.surfaceBundleId??`app`};return{...n,disclosure:at(n)}}function Et(e,t){let n=ht(e.nodes),r=Tt(t,e);if(r)return{...n,changedFromBefore:!0,surfaceChange:r};let i=t!==void 0&&n.digest!==ht(t.nodes).digest;return{...n,changedFromBefore:i}}function Dt(e){return`${e.disclosure} The settled tree and the pre-action tree describe different surfaces (${e.from} → ${e.to}), so no settled diff or refs are shown; take a snapshot to read the current surface.`}function Ot(e,n){let r=t(e.type??`Element`),i=x(e,r),a=g(e).join(`,`),o=e.hittable===!0?`hittable`:`not-hittable`;return[String(n??e.depth??0),r,i,a,o,e.actions?JSON.stringify(e.actions):``].join(`|`)}function kt(e,t,n={}){let r=Mt(jt(e,n),jt(t,n)),i={additions:0,removals:0,unchanged:0};for(let e of r)e.kind===`added`&&(i.additions+=1),e.kind===`removed`&&(i.removals+=1),e.kind===`unchanged`&&(i.unchanged+=1);return{summary:i,lines:r}}function At(e,t={}){return jt(e,t).length}function jt(e,t){return t.flatten?e.map(e=>({text:ee(e,0,!1),comparable:Ot(e,0),...t.withRefs&&e.ref?{ref:e.ref}:{}})):te(e).map(e=>({text:e.text,comparable:Ot(e.node,e.depth),...t.withRefs&&e.node.ref?{ref:e.node.ref}:{}}))}function Mt(e,t){let n=e.length,r=t.length,i=n+r,a=new Map,o=[];a.set(1,0);for(let s=0;s<=i;s+=1){o.push(new Map(a));for(let i=-s;i<=s;i+=2){let c=Pt(a,i,s)?B(a,i+1):B(a,i-1)+1,l=c-i;for(;c<n&&l<r&&e[c].comparable===t[l].comparable;)c+=1,l+=1;if(a.set(i,c),c>=n&&l>=r)return Nt(o,e,t,n,r)}}return[]}function Nt(e,t,n,r,i){let a=[],o=r,s=i;for(let r=e.length-1;r>=0;--r){let i=e[r],c=o-s,l=Pt(i,c,r)?c+1:c-1,u=B(i,l),d=u-l;for(;o>u&&s>d;)a.push({kind:`unchanged`,text:n[s-1].text}),--o,--s;if(r===0)break;if(o===u){let e=n[d];a.push({kind:`added`,text:e.text,...e.ref?{ref:e.ref}:{}}),s=d}else a.push({kind:`removed`,text:t[u].text}),o=u}return a.reverse(),a}function Pt(e,t,n){return t===-n||t!==n&&B(e,t-1)<B(e,t+1)}function B(e,t){return e.get(t)??0}function Ft(e){return e===`text`||e===`label`||e===`any`}function It(e,t,n,r){if(!(r||e===`web`))return Ft(t)?n:void 0}function Lt(e){return new i(`COMMAND_FAILED`,`find could not read the current accessibility tree`,{reason:e.reason,hint:`The snapshot quality verdict is sparse. Use screenshot as visual truth, navigate with coordinates if needed, then retry find after reaching a readable screen.`})}async function Rt(e,t){let n=t??`default`,r=await e.sessions.get(n);if(!r)throw new i(`SESSION_NOT_FOUND`,`No active session. Run open first.`);let a=r.refFrameSnapshot??r.snapshot;if(!a)throw new i(`INVALID_ARGS`,`No snapshot in session. Run snapshot first.`);return{sessionName:n,session:r,snapshot:a}}async function V(e,t,n={updateSession:!0}){let r=e.backend.captureSnapshot;if(!r)throw new i(`UNSUPPORTED_OPERATION`,`snapshot is not supported by this backend`);let a=t.session??`default`,o=await e.sessions.get(a),s=(await r(I(e,t),{interactiveOnly:n.interactiveOnly??!1,depth:t.depth,scope:n.scope??t.scope,raw:t.raw,includeRects:n.includeRects,...n.preferredBackend?{preferredBackend:n.preferredBackend}:{},...n.includeHiddenContentHints===void 0?{}:{includeHiddenContentHints:n.includeHiddenContentHints}})).snapshot;return(t.signal??e.signal)?.throwIfAborted(),n.updateSession&&o&&!N(s.snapshotQuality)&&await e.sessions.set({...o,snapshot:s}),{sessionName:a,session:o,snapshot:s}}async function zt(e,t,n){if(e.backend.readText){let r=await e.backend.readText(I(e,{session:t.sessionName}),n);if(r.text.trim())return r.text}return S(n)}function Bt(e,t,n){let r=u(t);if(!r)throw new i(`INVALID_ARGS`,n.invalidRefMessage);let o=a(e,r)??(n.fallbackLabel.length>0?ot(e,n.fallbackLabel):null);if(!o)throw new i(`COMMAND_FAILED`,n.notFoundMessage,{reason:O.refNotFound,ref:r,hint:w});return{ref:r,node:o}}function Vt(e,t){let{diagnostics:n=[],unique:r=!0,dispatched:a,...o}=t,c=new i(`COMMAND_FAILED`,re(e,n,{unique:r}),{...o,reason:O.selectorNotFound,hint:ce(n)});return a===void 0?c:s(c,a)}function Ht(e,t,n){let{command:r,...a}=n;return new i(`AMBIGUOUS_MATCH`,`Selector matched ${t.length} elements: ${e}`,{...a,...y(t),command:r,selector:e,hint:`Narrow the selector with role/id/longer text, or act on a printed candidate with a command that takes refs, such as press.`})}function Ut(e){let{outcome:t,selectorExpression:n,command:r,details:i}=e;return t.kind===`ambiguous`?Ht(t.selector,t.matchedNodes,{command:r,...i}):Vt(n,{command:r,unique:!0,...i})}async function Wt(e,t,n,r){let i=new AbortController,a=[t.signal,e.signal].filter(e=>e!==void 0),o=AbortSignal.any([...a,i.signal]),s=!1,c=setTimeout(()=>{s=!0,i.abort(new DOMException(`Wait deadline exceeded`,`TimeoutError`))},Math.max(0,n));c.unref();try{let e=await r(o);return s&&!a.some(e=>e.aborted)?{timedOut:!0}:(o.throwIfAborted(),{timedOut:!1,value:e})}catch(e){if(s&&!a.some(e=>e.aborted))return{timedOut:!0,error:e};throw e}finally{clearTimeout(c)}}function Gt(e){let t=e.snapshotQuality?.backend,n=(e.backend===`xctest`?Kt(e.nodes):e.nodes).map(Yt);return n.sort((e,t)=>Zt(e).localeCompare(Zt(t))),{captureBackend:t,nodes:n}}function Kt(e){let t=C(e);return e.filter(e=>se(e)||t.isVisibleOnScreen(e))}function qt(e,t){return!e||e.captureBackend!==t.captureBackend||e.nodes.length!==t.nodes.length?!1:e.nodes.every((e,n)=>{let r=t.nodes[n];return!r||e.identity!==r.identity?!1:!e.rect||!r.rect?e.rect===r.rect:Re(e.rect,r.rect)})}function Jt(e,t){if(!e||e.nodes.length===0||t.nodes.length===0)return!1;let n=new Map;for(let t of e.nodes)n.set(t.identity,(n.get(t.identity)??0)+1);let r=0;for(let e of t.nodes){let t=n.get(e.identity)??0;t!==0&&(r+=1,n.set(e.identity,t-1))}return r/Math.max(e.nodes.length,t.nodes.length)<.5}function Yt(e){return{identity:`${e.type??``}#${Xt(e)}`,...e.rect?{rect:{x:Math.round(e.rect.x),y:Math.round(e.rect.y),width:Math.round(e.rect.width),height:Math.round(e.rect.height)}}:{}}}function Xt(e){return[e.label,e.identifier,e.value].map(e=>String(e??``).trim()).join(`#`)}function Zt(e){let t=e.rect;return`${e.identity}#${t?`${t.x},${t.y},${t.width},${t.height}`:``}`}function Qt(e){return Math.min(300,Math.max(25,e))}const $t={"apple-runner":500,"simulator-ax-bridge":300,"appium-source":500,"limrun-ios-tree":500,"android-uiautomator":500,"harmonyos-uitest":500,"macos-helper":500,"linux-atspi":500,"agent-browser":500};function en(e){return e.producer===void 0?500:$t[e.producer]}const tn=`Settled on a nearly-empty tree — the app may still be loading. Wait for specific content (wait text ...) before interacting.`;async function nn(e,t,n){let{timeoutMs:r}=n,i=L(e),a=i+r,o=!1,s=await e.sessions.get(t.session??`default`),c=n.quietMs??500,l=sn({baseline:n.broadTransitionBaseline,platform:e.backend.platform,appBundleId:s?.appBundleId}),u=st(s?.snapshot?.snapshotQuality),d=on(i),f=0,p,m=(e,t,n)=>({settled:e,stalled:t,waitedMs:n,captures:f,nodeCount:d.lastNodeCount,quietMs:c,lastCapture:p}),h=t=>({...m(!1,t.kind===`stalled`,L(e)-i),...t.kind===`failed`?{failure:{error:t.error}}:{}});for(;L(e)<a;){let s=await mn(e,t,a-L(e),u);if(s.kind!==`captured`)return h(s);let{capture:g}=s;f+=1,p=g;let _=rn(g.snapshot,n.quietMs,l);c=_.quietMs;let{requiredQuietMs:v,pollMs:ee}=_,y=Gt(g.snapshot);u??=st(g.snapshot.snapshotQuality);let b=L(e),x=g.snapshot.nodes.length,te=g.snapshot.snapshotQuality,S=an({pacing:d,resetBudgetOnPrivateAxRecovery:n.resetBudgetOnPrivateAxRecovery,alreadyReset:o,state:{deadlineMs:a,timeoutMs:r,nowMs:b,verdict:te,signal:y,nodeCount:x,requiredQuietMs:v,pollMs:ee}});S&&(o=!0,a=S.deadlineMs);let ne=S?{settled:!1,delayMs:S.delayMs}:d.observe({signal:y,nodeCount:x,nowMs:b,requiredQuietMs:v,pollMs:ee,deadlineMs:a,captures:f});if(ne.settled)return m(!0,!1,b-i);if(ne.delayMs<=0)break;await Ct(e,ne.delayMs)}return m(!1,!1,L(e)-i)}function rn(e,t,n){let r=t??en(e),i=n.requiredQuietMs(e,r);return{quietMs:r,requiredQuietMs:i,pollMs:Qt(i)}}function an(e){let{state:t}=e,n=fn({resetRequested:e.resetBudgetOnPrivateAxRecovery,alreadyReset:e.alreadyReset,verdict:t.verdict,nowMs:t.nowMs,timeoutMs:t.timeoutMs,deadlineMs:t.deadlineMs});if(n!==void 0)return e.pacing.restart({signal:t.signal,nodeCount:t.nodeCount,nowMs:t.nowMs}),{deadlineMs:n,delayMs:e.pacing.delayMs({nowMs:t.nowMs,requiredQuietMs:t.requiredQuietMs,pollMs:t.pollMs,deadlineMs:n})}}function on(e){let t,n=0,r=e;return{get lastNodeCount(){return n},observe(e){if(!qt(t,e.signal))t=e.signal,n=e.nodeCount,r=e.nowMs;else if(e.captures>=2&&e.nowMs-r>=e.requiredQuietMs)return{settled:!0,delayMs:0};return{settled:!1,delayMs:pn({nowMs:e.nowMs,quietSinceMs:r,quietMs:e.requiredQuietMs,pollMs:e.pollMs,deadlineMs:e.deadlineMs})}},restart(e){t=e.signal,n=e.nodeCount,r=e.nowMs},delayMs(e){return pn({nowMs:e.nowMs,quietSinceMs:r,quietMs:e.requiredQuietMs,pollMs:e.pollMs,deadlineMs:e.deadlineMs})}}}function sn(e){let{platform:t,appBundleId:n}=e,r=e.baseline?.presentedSurface===`absent`?void 0:e.baseline,i,a;return{requiredQuietMs(e,o){if(i===void 0&&r&&(i=cn({baseline:r,capture:e,platform:t,appBundleId:n})),!i)return o;if(a===void 0){let t=ln(e,e.nodes,n);Jt(i,t)&&(a=Math.max(o,1500))}return a===void 0?o:Math.max(o,a)}}}function cn(e){let{baseline:t,capture:n,platform:r,appBundleId:i}=e;if(!un(n.backend,r))return;let a=n.nodes.some(se),o=t.presentedSurface===`presented`||t.nodes.length<=5;if(!(!a&&!o))return ln(n,t.nodes,i)}function ln(e,t,n){return Gt({...e,nodes:$e(t,n)})}function un(e,t){return e===`xctest`||e===void 0&&t===`ios`}function dn(e){return e?.state===`recovered`&&e.backend===`private-ax`&&e.reasonCode!==`deferred`}function fn(e){if(!(e.resetRequested!==!0||e.alreadyReset||!dn(e.verdict)))return Math.max(e.deadlineMs,e.nowMs+e.timeoutMs)}function pn(e){let t=e.quietSinceMs+e.quietMs-e.nowMs,n=t>e.pollMs?e.pollMs:Math.max(25,t+2),r=e.deadlineMs-e.nowMs,i=r-1;return i<2?r>=2?r:0:Math.min(n,i)}async function mn(e,t,n,r){try{let i=await Wt(e,t,n,async n=>await V(e,{...t,signal:n},{updateSession:!1,interactiveOnly:!0,preferredBackend:r}));return i.timedOut?{kind:`stalled`}:{kind:`captured`,capture:i.value}}catch(e){return{kind:`failed`,error:e}}}function hn(e,t,n){return{observation:{...e,captures:t?.captures??e.captures,waitedMs:t?.waitedMs??e.waitedMs,quietMs:t?.quietMs??e.quietMs,hint:`Settle observation unavailable (${n instanceof Error?n.message:String(n)}). The action itself succeeded; take a snapshot to observe the result.`}}}const gn=`The UI kept changing for the whole settle budget (animation, carousel, or ticker?), so no settled diff is shown. Raise --timeout, wait for specific content, or take a fresh snapshot.`,_n=`A snapshot capture stalled past the settle budget, so no settled diff is shown. The action itself succeeded; observe with wait stable or snapshot.`;async function vn(e,t,n){return await bn(e,t,{...n,baseline:await Cn(e,t,n.resolved),actionPoint:n.resolved.point})}const yn=async(e,t)=>(await bn(e,t,t)).observation;async function bn(e,t,n){let r=n.timeoutMs??1e4,i={settled:!1,waitedMs:0,captures:0,quietMs:n.quietMs??500,timeoutMs:r},a;try{return a=await nn(e,t,{...n.quietMs===void 0?{}:{quietMs:n.quietMs},timeoutMs:r,resetBudgetOnPrivateAxRecovery:!0,broadTransitionBaseline:n.baseline}),a.failure?hn(i,a,a.failure.error):await xn(e,t,n,i,a)}catch(e){return hn(i,a,e)}}async function xn(e,t,n,r,i){let a={...r,settled:i.settled,waitedMs:i.waitedMs,captures:i.captures,quietMs:i.quietMs};if(!i.lastCapture)return{observation:{...a,hint:i.stalled?_n:gn}};let{stored:o,session:s}=await In(e,t,i.lastCapture),c=j(i.lastCapture.snapshot),l=c.nodes,u=Tt(n.baseline,c);return{observation:{...a,...u?{surfaceChange:u}:{},...i.settled&&o&&!u?On(n.baseline.nodes,l,n.actionPoint,s?.appBundleId):{},...Pn(i,o,l.length,u)},settledCapture:c}}function Sn(e,t){if(e)return Et(e,t)}async function Cn(e,t,n){let r=await e.sessions.get(t.session??`default`);return wn(n,r)??En(n.preAction)??Tn(r)}function wn(e,t){if(e.kind===`ref`)return En(j(t?.refFrameSnapshot))}function Tn(e){let{presentedSurface:t,...n}=j(e?.refFrameSnapshot??e?.snapshot);return n}function En(e){return e?.nodes.length?e:void 0}function Dn(e,t,n){let r=kt($e(e,n),$e(t,n),{flatten:!0,withRefs:!0}),i=r.lines.filter(e=>e.kind!==`unchanged`),a=Nn(i).map(e=>({kind:e.kind,text:e.text,...e.ref?{ref:e.ref}:{}}));return{summary:r.summary,lines:a,...i.length>a.length?{truncated:!0}:{}}}function On(e,t,n,r){let i=Dn(e,t,r);return{diff:i,...kn(i,t,n,r)}}function kn(e,t,n,r){let i=new Set(e.lines.filter(e=>e.kind===`added`&&e.ref).map(e=>e.ref)),a=Qe(t,r),o=new Map(t.filter(e=>e.ref).map(e=>[e.ref,e]));return[...i].some(e=>e!==void 0&&!a.has(e)&&!An(o.get(e),n))?{}:Mn(t,i,r)}function An(e,t){if(!e?.rect||!t)return!1;let{x:n,y:r,width:i,height:a}=e.rect;return t.x>=n&&t.x<=n+i&&t.y>=r&&t.y<=r+a}const jn=new Set([`application`,`window`]);function Mn(e,n,r){let i=Qe(e,r),a=e.filter(e=>e.interactionBlocked!==`covered`&&!jn.has(t(e.type??`Element`))).filter(d).filter(e=>!n.has(e.ref)&&!i.has(e.ref));if(a.length===0)return{};let o=a.slice(0,20).map(e=>{let n=t(e.type??`Element`),r=x(e,n);return{ref:e.ref,role:n,...r?{label:r}:{}}});return{tail:o,...a.length>o.length?{tailTruncated:!0}:{}}}function Nn(e){if(e.length<=80)return e;let t=e.filter(e=>e.kind===`added`),n=new Set(t.slice(0,80)),r=80-n.size,i=[];for(let t of e)n.has(t)?i.push(t):t.kind===`removed`&&r>0&&(i.push(t),--r);return i}function Pn(e,t,n,r){let i=Fn(e,t,n).hint;if(!r)return i===void 0?{}:{hint:i};let a=Dt(r);return{hint:i===void 0?a:`${a} ${i}`}}function Fn(e,t,n){return e.stalled?{hint:_n}:e.settled?t?n<5?{hint:tn}:{}:{hint:`Settled on a sparse, unreadable tree — the diff is omitted and its refs/selectors are invalid. Use screenshot as visual truth and coordinate taps; retry snapshot after navigating.`}:{hint:gn}}async function In(e,t,n){if(N(n.snapshot.snapshotQuality))return{stored:!1};let r=await e.sessions.get(t.session??`default`);return r?(await e.sessions.set({...r,snapshot:n.snapshot}),{stored:!0,session:r}):{stored:!1}}function Ln(e){let t=e.verify===!0;return{verify:t,needsPreActionBaseline:t||e.settle!==void 0,...e.settle===void 0?{}:{settle:e.settle}}}async function Rn(e,t,n,r,i){let a=await zn(e,t,n,i);return Vn({...r,...a})}async function zn(e,t,n,r){if(r.settle!==void 0){let i=await vn(e,t,{...r.settle,resolved:n}),a=r.verify?Sn(i.settledCapture,n.preAction):void 0;return{settle:i.observation,...a?{evidence:a}:{}}}if(!r.verify)return{};let i=await Bn(e,t,n);return i?{evidence:i}:{}}async function Bn(e,t,n){try{let r=await z(e,t,!0);return Et(j(r.snapshot),n.preAction)}catch{return}}function Vn(e){let t=e;if(t.targetHittable!==!1||!Hn(t)||t.hint===void 0)return e;let{hint:n,...r}=t;return r}function Hn(e){if(e.evidence?.changedFromBefore===!0||e.settle?.surfaceChange!==void 0)return!0;let t=e.settle?.diff?.summary;return!!t&&(t.additions>0||t.removals>0)}function Un(e){return s(new i(`COMMAND_FAILED`,`${e.label} is covered by another visible element and cannot ${ft(e.action)} safely`,ke(e.node,{selector:e.selector})),`no`)}async function Wn(e){let t=await Ue(e.policy,e.nodes,e.node,e.hooks);if(t.kind===`occluded`)throw Un({label:e.label,node:t.node,action:e.action});let n=e.resolveTapPoint(t.node);return pt({nodes:e.nodes,node:t.node,action:e.action,label:e.label,...e.keyboard?{keyboard:e.keyboard}:{},tapPoint:n}),{node:t.node,tapPoint:n}}async function Gn(e,t,n,r,i,{action:a}){return await Jn(e,t,n,r,{message:`Selector ${i} resolved to an off-screen element and is not safe to ${a}`,details:{reason:`offscreen_selector`,selector:i},hint:e=>`${qn(e,i)} then retry ${a} with the same selector. --until checks the selector between passes, so it stops on the target rather than sailing past it. If it is inside a closed drawer or another tab, open that container first.`})}async function Kn(e,t,n,r,i,{action:a}){return await Jn(e,t,n,r,{message:`Ref ${i} is off-screen and not safe to ${a}`,details:{reason:`offscreen_ref`,ref:u(i)},hint:e=>`${qn(e,null)} then retry ${a} with a selector (e.g. text=/id=) rather than this @ref — the scroll expires the ref frame, so re-run snapshot -i before reusing any @ref.`})}function qn(e,t){return e?t?`Run scroll ${e} --until '${t}' to bring it on screen,`:`Scroll ${e} toward it,`:`Scroll toward it,`}async function Jn(e,t,n,r,a){let o=C(r),c=n.rect?o.resolveEffectiveViewport(n):null;if(!n.rect||!c||o.isVisibleOnScreen(n))return n;let l=o.resolveViewport(n.rect),u=await e.backend.confirmOffscreenTargetVisible?.(I(e,t),n,l);if(u)return{...n,rect:u};let d=De(n,o);throw s(new i(`COMMAND_FAILED`,a.message,{...a.details,rect:n.rect,viewport:c,...d?{scrollDirection:d}:{},hint:a.hint(d)}),`no`)}function Yn(e,t,n,r){let a=Xe(r,e,t,{platform:n});if(a.kind===`none`)return null;if(a.kind===`ambiguous`)throw new i(`AMBIGUOUS_MATCH`,`Selector matched ${a.candidates.length} distinct actionable elements: ${a.selector}`,{selector:a.selector,...y(a.candidates)});return a.resolution}async function Xn(e,t,n,r){let i=await z(e,t,r.requireInteractive),a=Yn(i.snapshot.nodes,n,e.backend.platform,r.pipeline);if((!a||!a.node.rect)&&r.requireInteractive){let s=i.snapshot;i=await z(e,t,!1),o(s,i.snapshot),a=Yn(i.snapshot.nodes,n,e.backend.platform,r.pipeline)}return{capture:i,resolved:a}}async function Zn(e){let{runtime:t,nodes:n,selectorExpression:r,action:i}=e,a=await k(A.coveredDiagnosis,n,r,{platform:t.backend.platform});if(a.kind===`occluded`)return Un({label:`Selector ${a.selector}`,node:a.node,action:i,selector:a.selector})}async function Qn(e){let{runtime:t,nodes:n,selectorExpression:r,action:i,resolved:a}=e;return await Zn({runtime:t,nodes:n,selectorExpression:r,action:i})||Vt(r,{diagnostics:a?.diagnostics??[],unique:!0,dispatched:`no`})}function $n(e,t,n,r,a){if(!n)return;let o=E(e),c=xe(e,t);if(!(pe(o,n.identity)&&be(c,n.structural)))throw s(new i(`COMMAND_FAILED`,`${r} resolved to a different element than replay verification isolated; the action was not sent`,{reason:bt,observed:o,observedStructural:c,expected:n.identity,expectedStructural:n.structural,...a?{targetRole:a}:{}}),`no`)}function er(e,t,n){$n(e,t,n.expectedResolvedTarget,n.action,n.replayTargetRole)}function tr(e){return e.hittable===!0||Ze(e)}function nr(e,t){let n=ye(E(e),t);return n.id!==void 0||n.label!==void 0?!1:ie(e.value)===null}function rr(e,t,n){let r=new Set,i=e;for(;typeof i.parentIndex==`number`;){if(r.has(i.index))return!1;if(r.add(i.index),i.parentIndex===t.index)return!0;let e=n.get(i.parentIndex);if(!e)return!1;i=e}return!1}function ir(e,t){let n=we(t);return t.filter(t=>t.index!==e.index&&rr(t,e,n)).sort((e,t)=>e.index-t.index)}function ar(e,t){let n=Fe(e.rect);return!n||!t.rect?!1:he(t.rect,n.x,n.y)}function or(e,t){if(!nr(e,t))return e;let n=ir(e,t);if(n.some(tr))return e;let r=n.find(e=>E(e).label!==void 0);return!r||!ar(r,e)?e:r}function sr(e,t){if(Buffer.byteLength(e,`utf8`)<=t)return e;let n=Buffer.byteLength(`…`,`utf8`),r=Math.max(0,t-n),i=Buffer.from(e,`utf8`),a=Math.min(r,i.length);for(;a>0&&(i[a]&192)==128;)--a;return i.subarray(0,a).toString(`utf8`)+`…`}const cr={source:`ref`,phase:`pre-action`,kind:`exact`},lr={source:`ref`,phase:`pre-action`,kind:`label-fallback`};function ur(e,t,n){return{ref:e,node:t,resolution:n===`exact`?cr:lr}}const dr={source:`runtime`,phase:`pre-action`,kind:`unique`};function fr(e,t){return e.disambiguation?{source:`runtime`,phase:`pre-action`,kind:`disambiguated`,matchCount:e.disambiguation.matchCount,winnerDiagnostic:pr(e.node,t),tiebreak:e.disambiguation.tiebreak,alternatives:e.disambiguation.alternatives.slice(0,5).map(e=>pr(e,t))}:dr}function pr(e,t){let n=fe(e.type??``),r=M(e,t);return{diagnosticRef:`diag-${e.ref}`,...n?{role:sr(n,256)}:{},...r===void 0?{}:{label:sr(r,256)}}}function mr(e,t,n,r,i){let a=n.nodes;return{node:t,selectorChain:T(t,e.backend.platform,{action:r===`fill`?`fill`:`click`,nodes:a}),refLabel:M(t,a),...gr(t,r),preAction:n,resolution:i,...hr(e,t,a,r)}}function hr(e,t,n,r){if(r!==`click`&&r!==`press`)return{};let i=or(t,n);return i===t?{}:{recordingTarget:{node:i,selectorChain:T(i,e.backend.platform,{action:`click`,nodes:n}),refLabel:M(i,n)}}}function gr(e,t){return e.hittable===!1?{targetHittable:!1,hint:`The resolved element reports hittable: false, so this ${t} may have had no visible effect. Verify with a snapshot, or prefer a @ref or a longer/more specific selector to target the intended element.`}:{}}function _r(e,t,n={}){let i=Le(t.rect),a=Fe(i??void 0);if(!i||!a)return{kind:`invalid`};let o=vr(e,t,i);if(o.length===0)return{kind:`resolved`,point:a,strategy:`center`};let s=(n.bounds??[]).reduce((e,t)=>e?br(e,t):null,i),c=s?xr(i,s,a,o):null;return c?{kind:`resolved`,point:c,strategy:`parent-owned`}:{kind:`blocked`,competitorRefs:r(o),competitorCount:o.length}}function vr(e,t,n){let r=new Map(e.map(e=>[e.index,e]));return e.filter(e=>e.index!==t.index).filter(e=>yr(e,t,r)).filter(Ze).flatMap(e=>{let t=Le(e.rect);if(!t||Ie(t,n))return[];let r=br(t,n);return r&&r.width>0&&r.height>0?[{ref:e.ref,index:e.index,rect:r}]:[]}).sort((e,t)=>e.index-t.index)}function yr(e,t,n){let r=new Set,i=e;for(;typeof i.parentIndex==`number`&&!r.has(i.index);){if(r.add(i.index),i.parentIndex===t.index)return!0;let e=n.get(i.parentIndex);if(!e)return!1;i=e}return!1}function br(e,t){let n=Math.max(e.x,t.x),r=Math.max(e.y,t.y),i=Math.min(e.x+e.width,t.x+t.width),a=Math.min(e.y+e.height,t.y+t.height);return i<=n||a<=r?null:{x:n,y:r,width:i-n,height:a-r}}function xr(e,t,n,r){let i=Er(e),a=wr(t.x,t.width,n.x,r.flatMap(({rect:e})=>[e.x,e.x+e.width]),i),o=wr(t.y,t.height,n.y,r.flatMap(({rect:e})=>[e.y,e.y+e.height]),i);return a.flatMap(a=>o.flatMap(o=>{let s={x:Math.round(a),y:Math.round(o)};if(!he(t,s.x,s.y))return[];let c=Sr(s,e,n,r,i);return c?[c]:[]})).sort(Cr)[0]?.point??null}function Sr(e,t,n,r,i){let a=Tr(e,t,r);return a.parentEdge<i||a.competitor<12?null:{point:e,distanceSquared:(e.x-n.x)**2+(e.y-n.y)**2,clearance:Math.min(a.parentEdge,a.competitor)}}function Cr(e,t){return e.distanceSquared-t.distanceSquared||t.clearance-e.clearance||e.point.y-t.point.y||e.point.x-t.point.x}function wr(e,t,n,r,i){let a=e+i,o=e+t-i;if(a>o)return[];let s=[...new Set([e,e+t,...r])].sort((e,t)=>e-t),c=new Set([n,a,o]);for(let e of r)c.add(e-12),c.add(e+12);for(let e=1;e<s.length;e+=1)c.add((s[e-1]+s[e])/2);return[...c].filter(e=>e>=a&&e<=o).sort((e,t)=>e-t)}function Tr(e,t,n){let r=Math.min(e.x-t.x,t.x+t.width-e.x,e.y-t.y,t.y+t.height-e.y),i=1/0;for(let{rect:t}of n){let n=e.x<t.x?t.x-e.x:Math.max(0,e.x-(t.x+t.width)),r=e.y<t.y?t.y-e.y:Math.max(0,e.y-(t.y+t.height));i=Math.min(i,Math.max(n,r))}return{parentEdge:r,competitor:i}}function Er(e){let t=Math.min(e.width,e.height);return Math.max(0,Math.min(12,Math.floor(t/2)-1))}function Dr(e,t,n){let r=C(t),a=_r(t,e,{bounds:[r.resolveEffectiveViewport(e),e.rect?r.resolveViewport(e.rect):null].filter(e=>e!==null)});if(a.kind===`resolved`)return a.point;throw a.kind===`invalid`?s(new i(`COMMAND_FAILED`,n.invalidMessage,{reason:O.targetBoundsInvalid,...Or(n.blockedTargetDetails)}),`no`):s(new i(`COMMAND_FAILED`,`${n.blockedTargetLabel} has no parent-owned touch point outside its interactive descendants`,{reason:`covered_by_interactive_descendants`,...n.blockedTargetDetails,competitorRefs:a.competitorRefs.slice(0,5).map(e=>`@${e}`),competitorCount:a.competitorCount,hint:`Tap the specific interactive child you intend, or use a more specific selector. Every safely tappable region of the parent belongs to one of its child controls.`}),`no`)}function Or(e){return`ref`in e?{ref:u(e.ref)??e.ref}:e}function kr(e,t){let n=u(e.ref);if(!n)throw new i(`INVALID_ARGS`,`Invalid ref: ${e.ref}`);if(u(t.ref)!==n||!d(t.node)||u(t.node.ref)!==n||!t.tree.nodes.includes(t.node))throw new i(`COMMAND_FAILED`,`Internal find target provenance does not match the interaction ref`);return{tree:t.tree,...t.keyboard?{keyboard:t.keyboard}:{},resolved:ur(n,t.node,`exact`)}}async function Ar(e,t,n){let r=await Mr(e,t,n);return{tree:j(r.snapshot),...r.snapshot.keyboard?{keyboard:r.snapshot.keyboard}:{},...r.adoptedFrom?{adoptedFrom:r.adoptedFrom}:{},resolved:r.resolved}}async function jr(e,t,n,r){let{tree:i,keyboard:a,resolved:o,adoptedFrom:s}=r.preresolvedTarget?kr(n,r.preresolvedTarget):await Ar(e,t,n),c=i.nodes,{node:l,tapPoint:d}=await Wn({policy:r.pipeline,nodes:c,...a?{keyboard:a}:{},node:o.node,action:r.action,label:`Ref ${n.ref}`,hooks:{onResolved:(e,t)=>er(e,t,r),offscreen:async(i,a)=>await Kn(e,t,i,a,n.ref,r)},resolveTapPoint:e=>Dr(e,c,{invalidMessage:`Ref ${n.ref} has no usable bounds`,blockedTargetLabel:`Ref ${n.ref}`,blockedTargetDetails:{ref:`@${u(n.ref)??e.ref}`}})});return{kind:`ref`,point:d,target:{kind:`ref`,ref:`@${o.ref}`},...s?{adoptedFrom:s}:{},...mr(e,l,i,r.action,o.resolution)}}async function Mr(e,t,n){let{session:r,snapshot:i}=await Rt(e,t.session),a=n.fallbackLabel??``,o=Fr(i.nodes,n.ref,{fallbackLabel:a});if(o.kind!==`resolved`)throw Ir(o,n.ref);return Nr({platform:e.backend.platform,session:r,frameTree:i,target:n,fallbackLabel:a,authorized:o.resolved})}function Nr(e){let{session:t,frameTree:n,target:r,fallbackLabel:i,authorized:a}=e,o=t.snapshot;if(!o)return{snapshot:n,resolved:a,adoptedFrom:`authorized-frame`};if(o===n)return{snapshot:n,resolved:a,adoptedFrom:`observation`};let s=Pr({...e,observation:o});if(s)return s;let c=Fr(o.nodes,r.ref,{fallbackLabel:i});return c.kind===`resolved`&&pe(E(a.node),E(c.resolved.node))?{snapshot:o,resolved:c.resolved,adoptedFrom:`observation`}:{snapshot:n,resolved:a,adoptedFrom:`authorized-frame`}}function Pr(e){let{platform:t,frameTree:n,observation:r,authorized:i}=e;if(t!==`android`||!i.node.identifier||!i.node.bundleId||j(n).surfaceBundleId!==j(r).surfaceBundleId)return;let a=E(i.node),o=e=>pe(a,E(e));if(n.nodes.filter(o).length!==1)return;let s=r.nodes.filter(e=>d(e)&&e.bundleId===i.node.bundleId&&o(e)),c=s[0];return s.length!==1||!c||!d(c)?{snapshot:n,resolved:i,adoptedFrom:`authorized-frame`}:{snapshot:r,resolved:ur(i.ref,c,i.resolution.kind===`label-fallback`?`label-fallback`:`exact`),adoptedFrom:`observation`}}function Fr(e,t,n){let r=u(t);if(!r)throw new i(`INVALID_ARGS`,`Invalid ref: ${t}`);let o=a(e,r);if(Lr(o))return{kind:`resolved`,resolved:ur(r,o,`exact`)};let s=n.fallbackLabel.length>0?ot(e,n.fallbackLabel):null;if(Lr(s))return{kind:`resolved`,resolved:ur(r,s,`label-fallback`)};let c=o??s;return c?{kind:`unusable`,node:c}:{kind:`missing`}}function Ir(e,t){let n=u(t)??t,r=e.kind===`unusable`?new i(`COMMAND_FAILED`,`Ref ${t} has no usable bounds`,{reason:O.targetBoundsInvalid,ref:n,hint:w}):new i(`COMMAND_FAILED`,`Ref ${t} not found`,{reason:O.refNotFound,ref:n,hint:w});return s(r,`no`)}function Lr(e){return e?d(e)&&Fe(e.rect)!==null:!1}async function H(e,t,n){return await Hr(e,t,n.action),t.target.kind===`point`?await zr(e,t,t.target,n):t.target.kind===`ref`?await jr(e,t,t.target,n):await Vr(e,t,t.target,n)}async function Rr(e,t,n){let r=(await e.sessions.get(t.session??`default`))?.snapshot,i=r?.nodes;if(!i)return;let a={x:n.x,y:n.y},o=C(i).resolveViewport({x:a.x,y:a.y,width:0,height:0});return o&&!he(o,a.x,a.y)?`Coordinates (${a.x}, ${a.y}) are outside the last-known viewport (${o.width}x${o.height}). The tap will be forwarded anyway; take a fresh snapshot if the screen changed.`:dt({nodes:i,point:a,viewport:o,...r?.keyboard?{keyboard:r.keyboard}:{}})}async function zr(e,t,n,r){let i=await Rr(e,t,n);if(!r.captureEvidenceBaseline)return{kind:`point`,point:{x:n.x,y:n.y},...i?{warning:i}:{}};let a=await Br(e,t);return{kind:`point`,point:{x:n.x,y:n.y},...a?{preAction:a}:{},...i?{warning:i}:{}}}async function Br(e,t){try{let n=await z(e,t,!0);return j(n.snapshot)}catch{return}}async function Vr(e,t,n,r){let i=n.selector,{capture:a,resolved:o}=await Xn(e,t,i,r);if(!o||!o.node.rect)throw await Qn({runtime:e,nodes:a.snapshot.nodes,selectorExpression:i,action:r.action,resolved:o});let s=o,{node:c,tapPoint:l}=await Wn({policy:r.pipeline,nodes:a.snapshot.nodes,...a.snapshot.keyboard?{keyboard:a.snapshot.keyboard}:{},node:s.node,action:r.action,label:`Selector ${s.selector}`,hooks:{onResolved:(e,t)=>er(e,t,r),offscreen:async(n,i)=>await Gn(e,t,n,i,s.selector,r)},resolveTapPoint:e=>Dr(e,a.snapshot.nodes,{invalidMessage:`Selector ${o.selector} resolved to invalid bounds`,blockedTargetLabel:`Selector ${i}`,blockedTargetDetails:{selector:i}})});return{kind:`selector`,point:l,target:{kind:`selector`,selector:o.selector},...mr(e,c,j(a.snapshot),r.action,fr(o,a.snapshot.nodes))}}async function Hr(e,t,n){if(e.backend.platform!==`macos`)return;let r=await Ur(e,t);if((r===`desktop`||r===`menubar`)&&(r!==`menubar`||n!==`click`&&n!==`press`))throw new i(`UNSUPPORTED_OPERATION`,`${n} is not supported on macOS ${r} sessions yet. Open an app session to act, or use the ${r} surface to inspect.`)}async function Ur(e,t){return(await e.sessions.get(t.session??`default`))?.metadata?.surface}async function Wr(e,t,n,r){if(r.kind===`point`||!r.node?.rect||n.expectedResolvedTarget||n.preresolvedTarget)return r;let i=await Kr(e,t,r.node,r.preAction);return i?e.backend.platform===`android`?await Xr(e,t,n,r,i):await Yr(e,t,n,r,i):r}function Gr(e){if(e.baselineFinishedAtMs===void 0)return{kind:`idle`};let t=e.nowMs-e.baselineFinishedAtMs,n=e.windowMs??500;return t>=n?{kind:`not-recent`}:e.targetShownAtRest?{kind:`stationary`}:{kind:`recheck`,waitMs:Math.max(n-t,50)}}async function Kr(e,t,n,r){let i=await Jr(e,t);if(!i)return;let a=Gr({baselineFinishedAtMs:i.finishedAt,targetShownAtRest:qr(i,n,r),nowMs:L(e),...e.backend.platform===`android`?{windowMs:1500}:{}});return a.kind===`recheck`?a:void 0}function qr(e,t,n){if(e.tree.surfaceBundleId!==n?.surfaceBundleId)return!1;let r=ne(e.tree.nodes,t);return r!==void 0&&Re(r,t.rect)}async function Jr(e,t){return(await e.sessions.get(t.session??`default`))?.movingTargetBaseline}async function Yr(e,t,n,r,i){let a=L(e);await Ct(e,i.waitMs);let o=await Qr(e,t,n);if(!o.measured)throw U(r,void 0,L(e)-a);await Ct(e,50);let s=Zr(o,await Qr(e,t,n));if(s.measured&&Re(o.rect,s.rect))return s.resolved;throw U(r,s.rect,L(e)-a)}async function Xr(e,t,n,r,i){let a=L(e),o=a+Math.max(i.waitMs,100),s=await Qr(e,t,n);if(!s.measured)throw U(r,void 0,L(e)-a);let c=L(e),l=0;for(;l<2||L(e)<o;){await Ct(e,50);let i=Zr(s,await Qr(e,t,n));if(l++,!i.measured)throw U(r,void 0,L(e)-a);if(Re(s.rect,i.rect)||(c=L(e)),L(e)-c>=100)return i.resolved;s=i}throw U(r,s.rect,L(e)-a)}function Zr(e,t){return t.measured&&t.surfaceBundleId===e.surfaceBundleId?t:{measured:!1,rect:void 0,resolved:t.resolved}}async function Qr(e,t,n){if(t.target.kind!==`ref`){let r=await H(e,t,n),i=ei(r),a=r.preAction?.surfaceBundleId;return i?{measured:!0,resolved:r,rect:i,surfaceBundleId:a}:{measured:!1,resolved:r,rect:void 0}}let{snapshot:r}=await z(e,t,!0),i=await H(e,t,n);return{resolved:i,...$r(j(r),i)}}function $r(e,t){let n=ei(t);return n!==void 0&&`adoptedFrom`in t&&t.adoptedFrom===`observation`?{measured:!0,rect:n,surfaceBundleId:e.surfaceBundleId}:{measured:!1,rect:void 0}}function ei(e){return`node`in e?e.node?.rect:void 0}function ti(e){return`The target had no confirmed resting position when the transition window after the previous action ran out, so nothing was dispatched. ${e.selector?`Run wait ${Pe(e.selector)} and retry with the same selector`:`Run snapshot -i and retry with a selector (text=/id=) rather than this @ref — re-observing retires the ref frame`}; or pass --settle to have the action itself wait for the UI to go quiet.`}function U(e,t,n){let r=e.target.kind===`selector`?e.target.selector:void 0,a=e.target.kind===`ref`?e.target.ref:void 0;return s(new i(`COMMAND_FAILED`,r?`Selector ${r} had no confirmed resting position when the transition window ran out`:`Ref ${a} had no confirmed resting position when the transition window ran out`,{reason:O.targetStillMoving,...r===void 0?{ref:a}:{selector:r},...e.node?.rect?{rect:e.node.rect}:{},...t?{movedToRect:t}:{},waitedMs:n,hint:ti({selector:r})}),`no`)}async function ni(e,t,n,r){let i=(await e.sessions.get(t.session??`default`))?.snapshot,a=i?.nodes;if(!i||!a||u(n.ref)===null)return{};let o=Fr(a,n.ref,{fallbackLabel:n.fallbackLabel??``});if(o.kind!==`resolved`)return{};let{resolved:s}=o,c=A.resolvedTarget,{node:l}=await Wn({policy:c,nodes:a,node:s.node,action:r,label:`Ref ${n.ref}`,hooks:{offscreen:async(i,a)=>await Kn(e,t,i,a,n.ref,{action:r,pipeline:c})},resolveTapPoint:e=>Fe(e.rect)});return{...gr(l,r),node:l,preAction:j(i)}}async function ri(e,t,n,r,i){let a=await ni(e,t,n,r),o=R(await i(I(e,t),{kind:`ref`,ref:n.ref,...n.fallbackLabel?{fallbackLabel:n.fallbackLabel}:{}}));return{kind:`ref`,target:{kind:`ref`,ref:n.ref},resolution:cr,...a,...o?{backendResult:o}:{}}}function ii(e,t){let n=C(e),r=e.filter(n.isVisibleInEffectiveViewport).map(e=>e.rect).filter(ai),a=r.length>0?r:e.map(e=>e.rect).filter(ai);if(a.length===0)throw new i(`COMMAND_FAILED`,`Cannot infer viewport for ${t}`);let o=Math.min(...a.map(e=>e.x)),s=Math.min(...a.map(e=>e.y)),c=Math.max(...a.map(e=>e.x+e.width)),l=Math.max(...a.map(e=>e.y+e.height));return{x:o,y:s,width:c-o,height:l-s}}function ai(e){return!!(e&&e.width>0&&e.height>0)}async function oi(e,t){return await e.backend.resolveGestureViewport?.(I(e,t))||ii((await z(e,t,!1)).snapshot.nodes,`gesture`)}const si=async(e,t)=>{let n=await H(e,t,{action:`focus`,requireInteractive:!0,pipeline:A.resolvedTarget});if(!e.backend.focus)throw new i(`UNSUPPORTED_OPERATION`,`focus is not supported by this backend`);let r=W(n),a=R(await e.backend.focus(I(e,t),r));return{...n,...a?{backendResult:a}:{},...D(`Focused (${r.x}, ${r.y})`)}},ci=async(e,t)=>{let n=Ln(t),r=await H(e,t,{action:`longPress`,requireInteractive:!0,pipeline:A.promotedTarget,captureEvidenceBaseline:n.needsPreActionBaseline,expectedResolvedTarget:t.expectedResolvedTarget});if(!e.backend.longPress)throw new i(`UNSUPPORTED_OPERATION`,`longPress is not supported by this backend`);let a=t.durationMs===void 0?void 0:qe(t.durationMs,`durationMs`,0,12e4),o=W(r),s=R(await e.backend.longPress(I(e,t),o,{durationMs:a}));return await Rn(e,t,r,{...r,...a===void 0?{}:{durationMs:a},...s?{backendResult:s}:{},...D(`Long pressed (${o.x}, ${o.y})`)},n)},li=async(e,t)=>{let n=Ln(t),r=n.needsPreActionBaseline?null:await ui(e,t);if(r)return r;let a=await H(e,t,{action:`hover`,requireInteractive:!1,pipeline:A.resolvedTarget,captureEvidenceBaseline:n.needsPreActionBaseline,expectedResolvedTarget:t.expectedResolvedTarget});if(!e.backend.hover)throw new i(`UNSUPPORTED_OPERATION`,`hover is not supported by this backend`);let o=W(a),s=R(await e.backend.hover(I(e,t),o));return await Rn(e,t,a,{...a,...s?{backendResult:s}:{},...D(`Hovered (${o.x}, ${o.y})`)},n)};async function ui(e,t){if(t.target.kind!==`ref`||!e.backend.hoverTarget||t.expectedResolvedTarget)return null;let{hoverTarget:n}=e.backend;return await ri(e,t,t.target,`hover`,async(e,t)=>await n(e,t))}const di=async(e,t)=>{if(!e.backend.performGesture)throw new i(`UNSUPPORTED_OPERATION`,`gesture is not supported by this backend`);await Hr(e,t,`drag`);let n=await oi(e,t),r=await fi(e,t,`source`),a=await fi(e,t,`destination`),o=Ve({from:W(r),to:W(a),sourceHoldMs:t.gesture.sourceHoldMs,moveMs:t.gesture.moveMs,destinationHoldMs:t.gesture.destinationHoldMs},n),s=R(await e.backend.performGesture(I(e,t),o)),{start:c,end:l}=ze(o);return{kind:`drag`,durationMs:o.durationMs,pointerCount:1,from:c,to:l,targets:{source:pi(r),destination:pi(a)},recording:mi(r,a),...s?{backendResult:s}:{},...D(`Dragged ${t.gesture.source} to ${t.gesture.destination}`)}};async function fi(e,t,n){let r=t.gesture[n];return await H(e,{...t,target:r.startsWith(`@`)?{kind:`ref`,ref:r}:{kind:`selector`,selector:r}},{action:`drag`,requireInteractive:!1,pipeline:A.resolvedTarget,expectedResolvedTarget:t.expectedResolvedTargets?.[n],replayTargetRole:n})}function pi(e){if(e.kind===`point`||!e.resolution)throw new i(`COMMAND_FAILED`,`gesture drag target resolution was not disclosed`);let t=`selectorChain`in e?e.selectorChain:void 0;return{...t?.length?{selectorChain:t}:{},resolution:e.resolution}}function mi(e,t){let n=hi(e),r=hi(t),i=gi(e),a=gi(t);return{...n?{sourceSelector:n}:{},...r?{destinationSelector:r}:{},...i?{sourceTarget:i}:{},...a?{destinationTarget:a}:{}}}function hi(e){return`selectorChain`in e&&e.selectorChain?.length?e.selectorChain.join(` || `):void 0}function gi(e){if(!(!(`selectorChain`in e)||!e.selectorChain?.length||!e.node||!e.preAction))return{selectorChain:e.selectorChain,node:e.node,preActionNodes:e.preAction.nodes}}function W(e){if(!e.point)throw new i(`COMMAND_FAILED`,`Interaction target resolved without coordinates`);return e.point}const _i=async(e,t)=>await bi(e,t,`press`),vi=async(e,t)=>await bi(e,t,`click`),yi=async(e,t)=>{if(typeof t.text!=`string`)throw new i(`INVALID_ARGS`,`fill requires text`);let n=Ln(t),r=n.needsPreActionBaseline?null:await Ci(e,t);if(r)return r;let a=await H(e,t,{action:`fill`,requireInteractive:!0,pipeline:A.resolvedTarget,captureEvidenceBaseline:n.needsPreActionBaseline,expectedResolvedTarget:t.expectedResolvedTarget,preresolvedTarget:t.preresolvedTarget});if(!e.backend.fill)throw new i(`UNSUPPORTED_OPERATION`,`fill is not supported by this backend`);let o=xi(a),s=`node`in a?a.node?.type??``:``,c=s!==``&&de(s,e.backend.platform),l=t.allowNonHittableCoordinateFallback===!0&&`node`in a&&a.node?.hittable===!1,u=R(await e.backend.fill(I(e,t),o,t.text,{delayMs:t.delayMs,allowNonHittableCoordinateFallback:l})),d=s&&!c?`fill target ${Ti(a)} resolved to "${s}", attempting fill anyway.`:void 0;return await Rn(e,t,a,{...a,text:t.text,...d?{warning:d}:{},...u?{backendResult:u}:{}},n)};async function bi(e,t,n){let r=Ln(t),a=r.needsPreActionBaseline?null:await Si(e,t,n);if(a)return a;let o={action:n,requireInteractive:!0,pipeline:A.promotedTarget,captureEvidenceBaseline:r.needsPreActionBaseline,expectedResolvedTarget:t.expectedResolvedTarget,preresolvedTarget:t.preresolvedTarget},s=await H(e,t,o);if(!e.backend.tap)throw new i(`UNSUPPORTED_OPERATION`,`tap is not supported by this backend`);let c=await Wr(e,t,o,s),l=xi(c),u;try{u=await e.backend.tap(I(e,t),l,{button:t.button,count:t.count,intervalMs:t.intervalMs,holdMs:t.holdMs,jitterPx:t.jitterPx,doubleTap:t.doubleTap})}catch(e){throw mt(e,c),e}let d=R(u);return await Rn(e,t,c,{...c,...d?{backendResult:d}:{}},r)}function xi(e){if(!e.point)throw new i(`COMMAND_FAILED`,`Interaction target resolved without coordinates`);return e.point}async function Si(e,t,n){if(n!==`click`||t.target.kind!==`ref`||!e.backend.tapTarget||wi(t)||t.expectedResolvedTarget)return null;let{tapTarget:r}=e.backend;return await ri(e,t,t.target,n,async(e,t)=>await r(e,t))}async function Ci(e,t){if(t.target.kind!==`ref`||!e.backend.fillTarget||t.expectedResolvedTarget)return null;let{fillTarget:n}=e.backend;return{...await ri(e,t,t.target,`fill`,async(e,r)=>await n(e,r,t.text,{delayMs:t.delayMs})),text:t.text}}function wi(e){return e.count!==void 0||e.intervalMs!==void 0||e.holdMs!==void 0||e.jitterPx!==void 0||e.doubleTap!==void 0||e.button!==void 0&&e.button!==`primary`}function Ti(e){return e.target?.kind===`ref`?e.target.ref:e.target?.kind===`selector`?e.target.selector:`point`}function G(e){return{includeRects:e===`visible`||e===`hidden`,interactiveOnly:!1}}const Ei=A.wait.poll.defaultTimeoutMs;function Di(e,t,n,r,i={}){let a=Ye(r),o=n??a.defaultTimeoutMs,s=J(e),c=Hi(i.isUnreadableError),l=[],u={},d=()=>Math.max(0,o-(J(e)-s));return{capture:async n=>{let r=!1,i=J(e)-s,a=t=>l.push({startedMs:i,durationMs:J(e)-s-i,outcome:t}),o=await Wt(e,t,d(),async e=>await c.attempt(async()=>{let t=await n(e);return r=!0,t}));if(!o.timedOut)return r&&c.recordReadableCapture(),a(Oi(r,c.lastUnobservedCause())),o;let f=ki(o.error,c.readableCaptures());return a(f.outcome),u=f.evidence,{timedOut:!0,deadline:f.deadline}},hasTimeRemaining:()=>d()>0,failureEvidence:()=>({timeoutMs:o,readableCaptures:c.readableCaptures(),captures:l.length,polls:Ai(l),waitedMs:J(e)-s,...u}),preserveUnreadableOnStall:i.preserveUnreadableOnStall,neverReadableCause:c.neverReadableCause,sleepUntilNextPoll:async()=>await Ui(e,t,Math.min(a.intervalMs,d())),timeoutMs:o,waitedMs:()=>J(e)-s}}function Oi(e,t){return e?`readable`:t?.outcome??`unreadable`}function ki(e,t){let n=Bi(e);if(n)return{outcome:`runner-restart`,deadline:`runner-restart-exhausted`,evidence:n};let r=vt(e instanceof i?e.details:void 0);return r?{outcome:`readiness`,deadline:`readiness-exhausted`,evidence:{readinessPhase:r}}:{outcome:`deadline`,deadline:t===0?`capture-stalled`:`capture-truncated`,evidence:{}}}function Ai(e){return e.length<=30?[...e]:[...e.slice(0,5),...e.slice(-25)]}function ji(e,t){return new i(`COMMAND_FAILED`,e,{reason:P.captureStalled,captureStalled:!0,...t,retriable:!0,hint:`No readable snapshot capture completed before the wait timeout. Retry, or use screenshot to inspect the current surface.`})}function Mi(e,t){return new i(`COMMAND_FAILED`,e,{reason:P.runnerRestartExhausted,waitRunnerRestartExhausted:!0,...t,retriable:!0,hint:`An iOS runner restart consumed the wait timeout before a readable snapshot completed. Inspect the diagnostics log for the runner invalidation/restart sequence, then retry.`})}function Ni(e,t){return new i(`COMMAND_FAILED`,e,{reason:P.readinessExhausted,...t,retriable:!0,hint:`The wait timeout ended during readiness work (${t.readinessPhase}), before that poll could capture the screen. Retry with a timeout long enough to cover it.`})}function Pi(e,t){return new i(`COMMAND_FAILED`,e,{reason:P.deadlineExceeded,captureTruncated:!0,...t})}function Fi(e,t){return new i(`COMMAND_FAILED`,e,{reason:P.targetAbsent,...t})}function Ii(e,t,n){let r=e.neverReadableCause();if(r!==void 0){if(r.outcome===`retriable`)throw Li(r.error,t);if(n)throw r.error}}function Li(t,n){let r=e(t);return new i(r.code,r.message,{reason:P.captureStalled,...r.details,...n},r)}function K(e,t,n){let r=t.failureEvidence();switch(n){case`runner-restart-exhausted`:return Mi(e,r);case`readiness-exhausted`:return Ii(t,r,!1),Ni(e,r);case`capture-stalled`:return Ii(t,r,t.preserveUnreadableOnStall===!0),ji(e,r);case`capture-truncated`:return Pi(e,r);case void 0:return Ii(t,r,!0),r.readableCaptures===0?ji(e,r):Fi(e,r);default:return zi(n)}}function Ri(e){return e===`runner-restart-exhausted`||e===`readiness-exhausted`}function zi(e){throw Error(`Unhandled wait deadline: ${String(e)}`)}function Bi(e){if(!(e instanceof i))return;let t=e.details;if(t?.runnerRestarted===!0)return{runnerRestarted:!0,...q(t,`runnerRestartReason`),...q(t,`runnerRestartCommand`),...q(t,`runnerRestartCommandId`),...q(t,`runnerInvalidatedSessionId`),...q(t,`runnerRestartSessionId`),...q(t,`logPath`),...q(t,`diagnosticId`)}}function q(e,t){let n=e?.[t];return typeof n==`string`?{[t]:n}:{}}function Vi(e){return e instanceof i&&e.details?.retriable===!0}function Hi(e=Ne){let t=0,n;return{attempt:async t=>{try{return await t()}catch(t){if(e(t))n={outcome:`unreadable`,error:t};else if(Vi(t))n={outcome:`retriable`,error:t};else throw t;return}},lastUnobservedCause:()=>n,recordReadableCapture:()=>{t+=1},readableCaptures:()=>t,neverReadableCause:()=>t===0?n:void 0}}function J(e){return e.clock?.now()??Date.now()}async function Ui(e,t,n){let r=[t.signal,e.signal].filter(e=>e!==void 0);for(let e of r)e.throwIfAborted();if(n<=0)return!1;if(e.clock){await e.clock.sleep(n);for(let e of r)e.throwIfAborted();return!0}return await new Promise((e,t)=>{let i=r.length>0?AbortSignal.any(r):void 0,a=()=>i?.removeEventListener(`abort`,s),o=setTimeout(()=>{a(),e()},n),s=()=>{clearTimeout(o),a(),t(i?.reason)};i?.addEventListener(`abort`,s,{once:!0}),o.unref()}),!0}async function Wi(e,t,n){let r=await k(A.readAny,e.nodes,t,{platform:n}),i=r.kind===`target`||r.kind===`ambiguous`?r.matchedNodes:r.kind===`occluded`?[r.node]:[];return{selector:r.kind===`target`||r.kind===`ambiguous`?r.selector:t,observation:b(e,i)}}async function Gi(e,t,n){let r=await Wi(e,t,n),i=r.observation;if(i.kind!==`absent`)throw Ae(r.selector,i);return{predicate:`absent`,pass:!0,selector:t,matches:i.matches}}async function Ki(e,t,n,r,i){let a=_(n);if(a)throw Me(a,`wait`);let o=Di(t,n,i,A.wait,{isUnreadableError:Ji,preserveUnreadableOnStall:!0}),s=G(),c,l;for(;o.hasTimeRemaining();){let i=await o.capture(async i=>{try{let{observation:a}=await Wi((await e.captureSnapshot(t,{...n,signal:i},{updateSession:!0,includeHiddenContentHints:!1,...s})).snapshot,r,t.backend.platform);if(v(a.kind))throw Ae(r,a,`wait`);return a}catch(e){throw Ne(e)?je(r,e,`wait`):e}});if(i.timedOut){l=i.deadline;break}let a=i.value;if(a?.kind===`absent`)return{kind:`absent`,waitedMs:o.waitedMs()};a?.kind===`present`&&(c=a),await o.sleepUntilNextPoll()}throw Ri(l)?K(`wait absent timed out for selector: ${r}`,o,l):c?qi(r,c,o.failureEvidence()):K(`wait absent timed out for selector: ${r}`,o,l)}function qi(e,t,n){let r=t.matches!==1;return new i(`COMMAND_FAILED`,`wait absent timed out for selector ${e}: ${t.matches} match${r?`es`:``} remain`,{reason:P.targetPresent,selector:e,...n,matches:t.matches,firstMatch:t.firstMatch})}function Ji(e){if(!(e instanceof i))return!1;let t=e.details;return t?.command===`wait`&&t.predicate===`absent`&&(v(t.observation)||t.observation===`unreadable`)}function Yi(e){if(e.kind===`ambiguous`||e.kind===`target`)return{selector:e.selector,selectorIndex:e.selectorIndex,matchedNodes:e.matchedNodes}}async function Xi(e,t,n,r,a,o){let s=Di(t,n,a,A.wait),c=G(),l,u;for(;s.hasTimeRemaining();){let i=await s.capture(async r=>await e.captureSnapshot(t,{...n,signal:r},{updateSession:!0,includeHiddenContentHints:!1,...c}));if(i.timedOut){u=i.deadline;break}let a=i.value;if(a){let e=a.snapshot.nodes,n=Yi(await k(A.wait,e,r,{platform:t.backend.platform}));if(n){let t=Zi(e,n,o);if(t.kind===`satisfied`)return{kind:`selector`,selector:n.selector,waitedMs:s.waitedMs(),node:t.node,preActionNodes:e};l=t.evidence}}await s.sleepUntilNextPoll()}throw u!==`capture-stalled`&&l?new i(`COMMAND_FAILED`,`wait matched selector ${r} but no candidate carried the recorded landmark identity`,{reason:yt,...s.failureEvidence(),...l}):K(`wait timed out for selector: ${r}`,s,u)}function Zi(e,t,n){let r=t.matchedNodes[0];if(!n)return{kind:`satisfied`,node:r};let i=we(e),a=Te(t.matchedNodes,i,oe(n),n.ancestry)[0];return a?{kind:`satisfied`,node:a}:{kind:`identity-mismatch`,evidence:{matchCount:t.matchedNodes.length,observed:E(r),observedAncestry:Ee(r,i,Math.max(n.ancestry.length,1)).chain}}}async function Qi(e,t,n,r,a){let o=a??Ei,s=r??e.stable.defaultQuietMs,c=await e.stable.capture(t,n,{quietMs:s,timeoutMs:o});if(c.failure)throw c.failure.error;if(!c.settled)throw new i(`COMMAND_FAILED`,`wait timed out waiting for a stable UI`,{reason:P.stableTimeout,...c.stalled?{captureStalled:!0}:{},quietMs:s,timeoutMs:o,captures:c.captures,nodeCount:c.nodeCount,...c.stalled?{hint:`A snapshot capture stalled past the wait timeout, so no settle verdict is available. The UI may still be readable: retry, or use screenshot to inspect the surface.`}:{}});return{kind:`stable`,waitedMs:c.waitedMs,captures:c.captures,nodeCount:c.nodeCount,...c.nodeCount<e.stable.tinyTreeNodeCount?{hint:e.stable.tinyTreeHint}:{}}}async function $i(e,t,n,r,i){let a=Di(t,n,i,A.wait),o;for(;a.hasTimeRemaining();){let i=await a.capture(async i=>await ea(e,t,{...n,signal:i},r));if(i.timedOut){o=i.deadline;break}if(i.value)return{kind:`text`,text:r,waitedMs:a.waitedMs()};await a.sleepUntilNextPoll()}throw K(`wait timed out for text: ${r}`,a,o)}async function ea(e,t,n,r){return t.backend.findText&&(await t.backend.findText(na(t,n),r)).found?!0:await ta(e,t,n,r)}async function ta(e,t,n,r){let i=await e.captureSnapshot(t,n,{updateSession:!0,includeHiddenContentHints:!1});return!!ot(i.snapshot.nodes,r)}function na(e,t){return{session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata}}function ra(e){let t=async(t,n)=>{switch(n.target.kind){case`sleep`:return await Ui(t,n,n.target.durationMs),{kind:`sleep`,waitedMs:n.target.durationMs};case`ref`:return await ia(e,t,n,n.target.ref,n.target.timeoutMs);case`selector`:return await Xi(e,t,n,n.target.selector,n.target.timeoutMs,n.target.recordedLandmark);case`absent`:return await Ki(e,t,n,n.target.selector,n.target.timeoutMs);case`stable`:return await Qi(e,t,n,n.target.quietMs,n.target.timeoutMs);case`text`:return await aa(e,t,n,n.target.text,n.target.timeoutMs);default:return oa(n.target)}};return{waitCommand:t,waitForTextCommand:async(e,n)=>{let r=await t(e,{...n,target:{kind:`text`,text:n.text,timeoutMs:n.timeoutMs}});if(r.kind!==`text`)throw new i(`COMMAND_FAILED`,`waitForText returned non-text result`);return r}}}async function ia(e,t,n,r,o){let s=await e.requireSnapshot(t,n.session),c=u(r);if(!c)throw new i(`INVALID_ARGS`,`Invalid ref: ${r}`);let l=a(s.snapshot.nodes,c);if(!l)throw new i(`COMMAND_FAILED`,`Ref ${r} not found`,{reason:O.refNotFound,ref:c,hint:w});let d=M(l,s.snapshot.nodes);if(!d)throw new i(`COMMAND_FAILED`,`Ref ${r} has no label to wait for`,{reason:O.refUnlabeled,ref:c});return await $i(e,t,n,d,o)}async function aa(e,t,n,r,a){let o=me(r);if(!o.ok)throw new i(o.code,o.message);return await $i(e,t,n,o.text,a)}function oa(e){throw Error(`Unsupported wait target: ${String(e)}`)}const sa=ra({captureSnapshot:V,requireSnapshot:Rt,stable:{defaultQuietMs:500,tinyTreeHint:tn,tinyTreeNodeCount:5,capture:nn}}),ca=sa.waitCommand,la=sa.waitForTextCommand,ua=async(e,t)=>{let n=t.locator??`any`;if(!t.query)throw new i(`INVALID_ARGS`,ae);if(t.action===`wait`)return await ma(e,t,n);if(t.action===`list`)return await ha(e,t,n);let{capture:r,match:a}=await _a(e,t,n);if(!a)throw new i(`COMMAND_FAILED`,`find did not match any element`);if(t.action===`exists`)return{kind:`found`,found:!0};if(t.action===`get_attrs`)return{kind:`attrs`,...ga(a),node:a};let o=await zt(e,r,a);return{kind:`text`,...ga(a),text:o,node:a}},da=async(e,t)=>{if(t.target.kind===`ref`){let n=await Rt(e,t.session),r=Bt(n.snapshot.nodes,t.target.ref,{fallbackLabel:t.target.fallbackLabel??``,invalidRefMessage:`get text requires a ref like @e2`,notFoundMessage:`Ref ${t.target.ref} not found`});$n(r.node,n.snapshot.nodes,t.expectedResolvedTarget,`get`);let i=T(r.node,e.backend.platform,{action:`get`,nodes:n.snapshot.nodes}),a={kind:`ref`,ref:`@${r.ref}`},o=n.snapshot.nodes;return t.property===`attrs`?{kind:`attrs`,target:a,node:r.node,selectorChain:i,preActionNodes:o}:{kind:`text`,target:a,text:await zt(e,n,r.node),node:r.node,selectorChain:i,preActionNodes:o}}let n=await va(e,t,t.session??`default`,{selector:t.target.selector,policy:t.property===`text`?A.readText:A.readUnique,hooks:{onResolved:(e,n)=>$n(e,n,t.expectedResolvedTarget,`get`)}}),r=T(n.node,e.backend.platform,{action:`get`,nodes:n.capture.snapshot.nodes});if(t.property===`attrs`)return{kind:`attrs`,target:{kind:`selector`,selector:n.selector},node:n.node,selectorChain:r,preActionNodes:n.capture.snapshot.nodes};let i=await zt(e,n.capture,n.node);return{kind:`text`,target:{kind:`selector`,selector:n.selector},text:i,node:n.node,selectorChain:r,preActionNodes:n.capture.snapshot.nodes}},fa=async(e,t)=>{let n=await da(e,{...t,property:`text`,target:t.target});if(n.kind!==`text`)throw new i(`COMMAND_FAILED`,`getText returned non-text result`);return n},pa=async(e,t)=>{let n=await da(e,{...t,property:`attrs`,target:t.target});if(n.kind!==`attrs`)throw new i(`COMMAND_FAILED`,`getAttrs returned non-attrs result`);return n};async function ma(e,t,n){let r=Di(e,t,t.timeoutMs,A.findWait),i;for(;r.hasTimeRemaining();){let a=await r.capture(async r=>await _a(e,{...t,signal:r},n,{includeHiddenContentHints:!1}));if(a.timedOut){i=a.deadline;break}if(a.value?.match)return{kind:`found`,found:!0,waitedMs:r.waitedMs()};await r.sleepUntilNextPoll()}throw K(`find wait timed out`,r,i)}async function ha(e,t,n){let r=ue(n,t.query),i=await V(e,t,{updateSession:!0,...G()});if(N(i.snapshot.snapshotQuality))throw Lt(i.snapshot.snapshotQuality);return{kind:`list`,matches:(r?Je(A.readList,i.snapshot.nodes,r,{platform:e.backend.platform}).list?.matchedNodes??[]:Ce(i.snapshot.nodes,n,t.query,{}).matches).map(e=>({...ga(e),node:e}))}}function ga(e){return e.ref===void 0?{}:{ref:`@${e.ref}`}}async function _a(e,t,n,r){let i=ue(n,t.query),a=await V(e,t,{updateSession:!0,scope:It(e.backend.platform,n,t.query,i),includeHiddenContentHints:r?.includeHiddenContentHints,...G()});if(N(a.snapshot.snapshotQuality))throw Lt(a.snapshot.snapshotQuality);if(i){let t=await k(A.readAny,a.snapshot.nodes,i,{platform:e.backend.platform});return{capture:a,match:t.kind===`target`?t.node:void 0}}return{capture:a,match:Ce(a.snapshot.nodes,n,t.query,{requireRect:!1}).matches[0]}}async function va(e,t,n,r){let i=await V(e,{...t,session:n},{updateSession:!0,...G()}),a=await k(r.policy,i.snapshot.nodes,r.selector,{platform:e.backend.platform},r.hooks);if(a.kind!==`target`)throw Ut({outcome:a,selectorExpression:r.selector,command:`get`});return{capture:i,node:a.node,selector:a.selector,...ga(a.node)}}const ya=async(e,t)=>{let n=Se(t.predicate);if(!n.ok)throw new i(n.code,n.message,{hint:n.hint});let r=n.predicate;if(r===`absent`){let e=_(t);if(e)throw Me(e)}if(r===`text`&&!t.expectedText)throw new i(`INVALID_ARGS`,_e);let a=t.selector,o=await ba(e,t,r,a);return r===`exists`?await xa(e,o,a):r===`absent`?await Gi(o.snapshot,a,e.backend.platform):await Sa(e,t,o,r,a)};async function ba(e,t,n,r){try{return await V(e,t,{updateSession:!0,...G(n)})}catch(e){throw n!==`absent`||c(e)?e:je(r,e)}}async function xa(e,t,n){let r=await k(A.readAny,t.snapshot.nodes,n,{platform:e.backend.platform});if(r.kind!==`target`)throw new i(`COMMAND_FAILED`,re(n,[],{unique:!1}),{hint:ce([])});return{predicate:`exists`,pass:!0,selector:r.selector,matches:r.matches,selectorChain:ge(n)}}async function Sa(e,t,n,r,a){let o=await k(A.readUnique,n.snapshot.nodes,a,{platform:e.backend.platform},{onResolved:(e,n)=>$n(e,n,t.expectedResolvedTarget,`is`)});if(o.kind!==`target`)throw Ut({outcome:o,selectorExpression:a,command:`is`,details:{predicate:r,selector:a}});let s=le({predicate:r,node:o.node,visibility:C(n.snapshot.nodes),expectedText:t.expectedText,platform:e.backend.platform});if(!s.pass)throw new i(`COMMAND_FAILED`,`is ${r} failed for selector ${o.selector}: ${s.details}`,{command:`is`,reason:O.predicateFailed,predicate:r,selector:o.selector,predicateDetails:s.details});return{predicate:r,pass:!0,selector:o.selector,...r===`text`?{text:s.actualText}:{},selectorChain:ge(a),node:o.node,preActionNodes:n.snapshot.nodes}}const Ca=async(e,t)=>await ya(e,{...t,predicate:`visible`,selector:t.target.selector}),wa=async(e,t)=>await ya(e,{...t,predicate:`hidden`,selector:t.target.selector}),Ta=async(e,t)=>{if(!e.backend.performGesture)throw new i(`UNSUPPORTED_OPERATION`,`gesture is not supported by this backend`);await Hr(e,t,t.gesture.intent);let n=e.backend.performGesture,r=Be(t.gesture,await oi(e,t),e.backend.platform),a=R(await n(I(e,t),r)),o=Da(r.pointers,0),s=Da(r.pointers,-1);return{kind:t.gesture.intent,durationMs:r.durationMs,pointerCount:r.pointers.length,from:o,to:s,...a?{backendResult:a}:{},...D(Oa(t.gesture,o,s))}},Ea=async(e,t)=>{let n=t.gesture;return n.intent===`drag`?await di(e,{...t,gesture:n}):await Ta(e,{...t,gesture:n})};function Da(e,t){let n=e.map(e=>t===0?e.samples[0]?.point:e.samples.at(-1)?.point);if(n.some(e=>e===void 0))throw new i(`COMMAND_FAILED`,`Gesture plan did not contain endpoint samples.`);let r=n;return{x:r.reduce((e,t)=>e+t.x,0)/r.length,y:r.reduce((e,t)=>e+t.y,0)/r.length}}function Oa(e,t,n){switch(e.intent){case`pan`:{let r=`preset`in e?t:e.origin,i=`preset`in e?{x:n.x-t.x,y:n.y-t.y}:e.delta;return`Panned (${r.x}, ${r.y}) by (${i.x}, ${i.y})`}case`fling`:return`direction`in e?`Flung ${e.direction}`:`Flung`;case`pinch`:return`Pinched to scale ${e.scale}`;case`rotate`:return`Rotated gesture ${e.degrees} degrees`;case`transform`:return`Requested transform gesture by (${e.delta.x}, ${e.delta.y}), scale ${e.scale}, rotate ${e.degrees} degrees`;case`tap`:return`Tapped ${e.points.length} points`}}const Y={find:ua,get:da,getText:fa,getAttrs:pa,is:ya,isVisible:Ca,isHidden:wa,wait:ca,waitForText:la},X={click:vi,press:_i,fill:yi,focus:si,longPress:ci,hover:li,gesture:Ea,settleObservation:yn};function ka(e){return{find:t=>Y.find(e,t),get:t=>Y.get(e,t),getText:(t,n={})=>Y.getText(e,{...n,target:t}),getAttrs:(t,n={})=>Y.getAttrs(e,{...n,target:t}),is:t=>Y.is(e,t),isVisible:(t,n={})=>Y.isVisible(e,{...n,target:t}),isHidden:(t,n={})=>Y.isHidden(e,{...n,target:t}),wait:t=>Y.wait(e,t),waitForText:(t,n={})=>Y.waitForText(e,{...n,text:t})}}function Aa(e){return{click:(t,n={})=>X.click(e,{...n,target:t}),press:(t,n={})=>X.press(e,{...n,target:t}),fill:(t,n,r={})=>X.fill(e,{...r,target:t,text:n}),focus:(t,n={})=>X.focus(e,{...n,target:t}),longPress:(t,n={})=>X.longPress(e,{...n,target:t}),hover:(t,n={})=>X.hover(e,{...n,target:t}),gesture:t=>X.gesture(e,t),settleObservation:t=>X.settleObservation(e,t)}}const ja=[0,187,255,255];function Ma(e,t){for(let n of t)n.rect.width<4||n.rect.height<4||Na(e,n.rect)}function Na(e,t){let n=Pa(t);if(n==null)return;let r=Z(n.x,0,e.width-1),i=Z(n.y,0,e.height-1),a=Z(n.right,0,e.width-1),o=Z(n.bottom,0,e.height-1);for(let t=0;t<2;t+=1){for(let n=r;n<=a;n+=1)Fa(e,n,i+t,ja),Fa(e,n,o-t,ja);for(let n=i;n<=o;n+=1)Fa(e,r+t,n,ja),Fa(e,a-t,n,ja)}}function Pa(e){let t=e.x+e.width-1,n=e.y+e.height-1;return[e.x,e.y,e.width,e.height,t,n].every(Number.isFinite)?{x:e.x,y:e.y,right:t,bottom:n}:null}function Fa(e,t,n,r){if(t<0||t>=e.width||n<0||n>=e.height)return;let i=(n*e.width+t)*4;e.data[i]=r[0],e.data[i+1]=r[1],e.data[i+2]=r[2],e.data[i+3]=r[3]}function Z(e,t,n){return Number.isFinite(e)?Math.min(Math.max(e,t),n):t}const Ia=[{x:-1,y:-1},{x:0,y:-1},{x:1,y:-1},{x:-1,y:0},{x:1,y:0},{x:-1,y:1},{x:0,y:1},{x:1,y:1}];function La(e){let{mask:t,width:n,height:r,hooks:i}=e,a=new Uint8Array(t.length),o=new Int32Array(t.length),s=[];for(let e=0;e<t.length;e+=1){if(!Ba(t,a,e))continue;let c=0,l=za(o,a,0,e),u=i.create(e);for(;c<l;){let e=o[c];c+=1,i.visit(u,e),l=Ra({mask:t,visited:a,queue:o,queueEnd:l,width:n,height:r,pixelIndex:e})}s.push(u)}return s}function Ra(e){let{mask:t,visited:n,queue:r,width:i,height:a,pixelIndex:o}=e,s=o%i,c=Math.floor(o/i),l=e.queueEnd;for(let e of Ia){let o=s+e.x,u=c+e.y;if(!Va(o,u,i,a))continue;let d=u*i+o;Ba(t,n,d)&&(l=za(r,n,l,d))}return l}function za(e,t,n,r){return t[r]=1,e[n]=r,n+1}function Ba(e,t,n){return e[n]===1&&t[n]!==1}function Va(e,t,n,r){return e>=0&&e<n&&t>=0&&t<r}function Ha(e,t){return e.flatMap(e=>Ua(e,t.baseline.width,t.baseline.height)?Wa(e,t,Xa(t.baseline.height)):[e])}function Ua(e,t,n){let r=e.maxX-e.minX+1;return e.maxY-e.minY+1>=Ya(n)&&r>=t*.35}function Wa(e,t,n){let r=Ja(e,qa(Ka(Ga(e,t.diffMask,t.baseline.width)),Math.max(1,Math.round((e.maxX-e.minX+1)*.08))),n);if(r.length<=1)return[e];let i=r.map(([n,r])=>Za(e,n,r,t)).filter(e=>e!==null);return i.length>1?i:[e]}function Ga(e,t,n){let r=[];for(let i=e.minY;i<=e.maxY;i+=1){let a=0;for(let r=e.minX;r<=e.maxX;r+=1)t[i*n+r]===1&&(a+=1);r.push(a)}return r}function Ka(e){return e.map((t,n)=>{let r=0,i=0,a=Math.max(0,n-3),o=Math.min(e.length-1,n+3);for(let t=a;t<=o;t+=1)r+=e[t],i+=1;return Math.round(r/i)})}function qa(e,t){let n=[],r=null;for(let i=0;i<e.length;i+=1){if(e[i]<=t){r??=i;continue}r!==null&&(i-r>=6&&n.push([r,i-1]),r=null)}return r!==null&&e.length-r>=6&&n.push([r,e.length-1]),n}function Ja(e,t,n){let r=[],i=e.minY;for(let[a,o]of t){let t=e.minY+Math.round((a+o)/2);t-i+1<n||e.maxY-t<n||(r.push([i,t]),i=t+1)}return r.push([i,e.maxY]),r}function Ya(e){return Math.max(48,Math.round(e*.07))}function Xa(e){return Math.max(24,Math.round(e*.03))}function Za(e,t,n,r){let i=null;for(let a=t;a<=n;a+=1)for(let t=e.minX;t<=e.maxX;t+=1){let e=a*r.baseline.width+t;r.diffMask[e]===1&&(i??=Qa(t,a),$a(i,e,t,a,r.baseline,r.current))}return i}function Qa(e,t){return{minX:e,minY:t,maxX:e,maxY:t,differentPixels:0,baselineRed:0,baselineGreen:0,baselineBlue:0,currentRed:0,currentGreen:0,currentBlue:0}}function $a(e,t,n,r,i,a){let o=t*4;e.minX=Math.min(e.minX,n),e.minY=Math.min(e.minY,r),e.maxX=Math.max(e.maxX,n),e.maxY=Math.max(e.maxY,r),e.differentPixels+=1,e.baselineRed+=i.data[o],e.baselineGreen+=i.data[o+1],e.baselineBlue+=i.data[o+2],e.currentRed+=a.data[o],e.currentGreen+=a.data[o+1],e.currentBlue+=a.data[o+2]}const eo=2.5;function to(e){let t=no(e);return Ha(t.length<=2e3?ao(t,12):t,e).sort((e,t)=>{let n=t.differentPixels-e.differentPixels;if(n!==0)return n;let r=e.minY-t.minY;return r===0?e.minX-t.minX:r}).slice(0,8).map((t,n)=>co(t,n+1,{width:e.baseline.width,height:e.baseline.height,totalPixels:e.totalPixels,differentPixels:e.differentPixels}))}function no(e){let{diffMask:t,baseline:n,current:r}=e,{width:i,height:a}=n;return La({mask:t,width:i,height:a,hooks:{create:e=>ro(e,i),visit:(e,t)=>io(e,t,i,n,r)}})}function ro(e,t){let n=e%t,r=Math.floor(e/t);return{minX:n,minY:r,maxX:n,maxY:r,differentPixels:0,baselineRed:0,baselineGreen:0,baselineBlue:0,currentRed:0,currentGreen:0,currentBlue:0}}function io(e,t,n,r,i){let a=t%n,o=Math.floor(t/n),s=t*4;e.minX=Math.min(e.minX,a),e.minY=Math.min(e.minY,o),e.maxX=Math.max(e.maxX,a),e.maxY=Math.max(e.maxY,o),e.differentPixels+=1,e.baselineRed+=r.data[s],e.baselineGreen+=r.data[s+1],e.baselineBlue+=r.data[s+2],e.currentRed+=i.data[s],e.currentGreen+=i.data[s+1],e.currentBlue+=i.data[s+2]}function ao(e,t){let n=[];for(let r of e.sort((e,t)=>{let n=e.minY-t.minY;return n===0?e.minX-t.minX:n})){let e=n.find(e=>oo(e,r,t));if(!e){n.push({...r});continue}so(e,r)}return n}function oo(e,t,n){return e.minX-n<=t.maxX&&t.minX-n<=e.maxX&&e.minY-n<=t.maxY&&t.minY-n<=e.maxY}function so(e,t){e.minX=Math.min(e.minX,t.minX),e.minY=Math.min(e.minY,t.minY),e.maxX=Math.max(e.maxX,t.maxX),e.maxY=Math.max(e.maxY,t.maxY),e.differentPixels+=t.differentPixels,e.baselineRed+=t.baselineRed,e.baselineGreen+=t.baselineGreen,e.baselineBlue+=t.baselineBlue,e.currentRed+=t.currentRed,e.currentGreen+=t.currentGreen,e.currentBlue+=t.currentBlue}function co(e,t,n){let r={x:e.minX,y:e.minY,width:e.maxX-e.minX+1,height:e.maxY-e.minY+1},i={x:Math.round(e.minX+r.width/2),y:Math.round(e.minY+r.height/2)},a=lo(e.baselineRed,e.baselineGreen,e.baselineBlue,e.differentPixels),o=lo(e.currentRed,e.currentGreen,e.currentBlue,e.differentPixels),s=r.width*r.height;return{index:t,rect:r,normalizedRect:Ge({x:Q(r.x/n.width),y:Q(r.y/n.height),width:Q(r.width/n.width),height:Q(r.height/n.height)}),differentPixels:e.differentPixels,shareOfDiffPercentage:Q(e.differentPixels/n.differentPixels),densityPercentage:Q(e.differentPixels/s),shape:po(r,n.width,n.height),size:mo(s,n.totalPixels),location:uo(i,n.width,n.height),averageBaselineColorHex:go(a),averageCurrentColorHex:go(o),baselineLuminance:Math.round(ho(a)),currentLuminance:Math.round(ho(o)),dominantChange:fo(a,o)}}function lo(e,t,n,r){return{r:Math.round(e/r),g:Math.round(t/r),b:Math.round(n/r)}}function uo(e,t,n){let r=e.x<t/3?`left`:e.x>t*2/3?`right`:`center`,i=e.y<n/3?`top`:e.y>n*2/3?`bottom`:`middle`;return r===`center`&&i===`middle`?`center`:`${i}-${r}`}function fo(e,t){let n=ho(t)-ho(e);return Math.abs(n)>=12?n>0?`brighter`:`darker`:Math.max(Math.abs(t.r-e.r),Math.abs(t.g-e.g),Math.abs(t.b-e.b))>=12?`color-shift`:`mixed`}function po(e,t,n){return e.width>=t*.55&&e.height>=n*.12?`large-area`:e.width>=e.height*eo?`horizontal-band`:e.height>=e.width*eo?`vertical-band`:`compact`}function mo(e,t){let n=e/t;return n>=.04?`large`:n>=.01?`medium`:`small`}function ho(e){return e.r*.2126+e.g*.7152+e.b*.0722}function go(e){return`#${_o(e.r)}${_o(e.g)}${_o(e.b)}`}function _o(e){return e.toString(16).padStart(2,`0`)}function Q(e){return Math.round(e*100*100)/100}const vo=Math.sqrt(3*255**2);async function yo(e,t,n={}){await bo(e,`Baseline image not found`),await bo(t,`Current screenshot not found`);let r=n.outputPath,[i,a]=await Promise.all([F.readFile(e),F.readFile(t)]),[o,s]=await Promise.all([et(i,`baseline screenshot`,n.maxPixels),et(a,`current screenshot`,n.maxPixels)]),c=xo(o,s),l=c?.compared??o,{validateScreenshotPixels:u}=await import(`./screenshot-image-size.js`);u(l.width,l.height,`comparison canvas`,n.maxPixels);let d=s;if(c&&s.width!==o.width){let{resizePngBox:e}=await import(`./png-resize.js`).then(e=>e.t);d=e(s,c.scaledCurrent.width,c.scaledCurrent.height)}let f=So(o,l.height),p=So(d,l.height),m=Math.min(o.height,d.height),h=n.threshold??.1,g=l.width*l.height,_=h*vo,{diffData:v,diffMask:ee,differentPixels:y}=await tt({baselineData:f.data,currentData:p.data,width:l.width,height:l.height,overlapHeight:m,maxColorDistance:_}),b=y>0?to({diffMask:ee,baseline:f,current:p,totalPixels:g,differentPixels:y}):[];if(y>0&&r){let e=new rt.PNG({width:l.width,height:l.height});e.data=v,Ma(e,b),await F.mkdir(St.dirname(r),{recursive:!0}),await F.writeFile(r,await nt(e))}else await Co(n.outputPath);let x=g>0?Math.round(y/g*100*100)/100:0;return{...y>0&&r?{diffPath:r}:{},...b.length>0?{regions:b}:{},...c?{normalization:c}:{},totalPixels:g,differentPixels:y,mismatchPercentage:x,match:y===0}}async function bo(e,t){try{await F.access(e)}catch{throw new i(`INVALID_ARGS`,`${t}: ${e}`)}}function xo(e,t){if(e.width===t.width&&e.height===t.height)return;let n=Math.max(1,Math.round(t.height*(e.width/t.width)));return{baseline:{width:e.width,height:e.height},current:{width:t.width,height:t.height},scaledCurrent:{width:e.width,height:n},compared:{width:e.width,height:Math.max(e.height,n)},currentScale:{x:e.width/t.width,y:n/t.height},alignment:`top-left`,coordinateSpace:`comparison-pixels`}}function So(e,t){if(e.height===t)return e;let n=new rt.PNG({width:e.width,height:t});return e.data.copy(n.data),n}async function Co(e){if(e)try{await F.unlink(e)}catch(e){if(!wo(e,`ENOENT`))throw e}}function wo(e,t){return typeof e==`object`&&!!e&&`code`in e&&e.code===t}function To(e,t,n={x:1,y:1}){let r=t.map(e=>({...e,overlayRect:{x:e.overlayRect.x*n.x,y:e.overlayRect.y*n.y,width:e.overlayRect.width*n.x,height:e.overlayRect.height*n.y}}));return e.map(e=>{let t=Eo(e,r);return t.length>0?{...e,currentOverlayMatches:t}:e})}function Eo(e,t){let n=ve(e.rect);return t.map(t=>{let r=t.overlayRect,i=We(e.rect,r);return i<=0?null:{ref:t.ref,...t.label?{label:t.label}:{},rect:r,overlayCoveragePercentage:Do(i/ve(r)),regionCoveragePercentage:Do(i/n)}}).filter(e=>e!==null).sort((e,t)=>{let n=t.regionCoveragePercentage-e.regionCoveragePercentage;return n===0?t.overlayCoveragePercentage-e.overlayCoveragePercentage:n}).slice(0,3).map(e=>({ref:e.ref,...e.label?{label:e.label}:{},rect:e.rect,regionCoveragePercentage:e.regionCoveragePercentage}))}function Do(e){return Math.round(e*100*100)/100}async function Oo(t,n,r){if(n.kind===`path`&&!t.policy.allowLocalInputPaths)throw new i(`INVALID_ARGS`,`Local ${r.field??`input`} paths are not allowed by command policy`);try{return await t.artifacts.resolveInput(n,r)}catch(t){throw e(t)}}async function ko(t,n,r){if(n?.kind===`path`&&!t.policy.allowLocalOutputPaths)throw new i(`INVALID_ARGS`,`Local output paths are not allowed by command policy`);try{return await t.artifacts.reserveOutput(n,{...r,visibility:r.visibility??`client-visible`,requestedClientPath:n?.kind===`downloadableArtifact`?n.clientPath??r.requestedClientPath:r.requestedClientPath})}catch(t){throw e(t)}}async function Ao(t,n){try{return await t.artifacts.createTempFile(n)}catch(t){throw e(t)}}const jo=async(e,t)=>{if(!t.baseline)throw new i(`INVALID_ARGS`,`diff screenshot requires a baseline image`);let n=Mo(t.threshold),r=t.current??{kind:`live`};if(t.overlayRefs&&!zo(r))throw new i(`INVALID_ARGS`,`diff screenshot <current.png> cannot use --overlay-refs because saved-image comparisons have no live accessibility refs`);let a=await Oo(e,t.baseline,{usage:`diff screenshot baseline`,field:`baseline`}),o,s,c,l=[];try{let i;zo(r)?(s=await No(e,t),i=s.path):(o=await Oo(e,r,{usage:`diff screenshot current`,field:`current`}),i=o.path),c=t.out?await ko(e,t.out,{field:`diffPath`,ext:`.png`,artifactType:`screenshot-diff`}):void 0;let u=await yo(a.path,i,{threshold:n,outputPath:c?.path,maxPixels:e.policy.maxImagePixels});zo(r)&&(u=await Po(e,t,c?.path,u,l));let d=u.diffPath?await c?.publish():void 0;return d&&l.push(d),u.diffPath||await c?.cleanup?.(),{...u,...l.length>0?{artifacts:l}:{}}}catch(e){throw await c?.cleanup?.(),e}finally{await a.cleanup?.(),await o?.cleanup?.(),await s?.cleanup?.()}};function Mo(e){if(e==null||e===``)return .1;let t=Number(e);if(Number.isNaN(t)||t<0||t>1)throw new i(`INVALID_ARGS`,`--threshold must be a number between 0 and 1`);return t}async function No(e,t){let n=await Ao(e,{prefix:`agent-device-diff-current`,ext:`.png`});try{await Fo(e,t,n.path,Io(t))}catch(e){throw await n.cleanup(),e}return n}async function Po(e,t,n,r,i){if(!t.overlayRefs)return r;if(r.match)return n&&await Ro(n),r;let a=await ko(e,Lo(t,n),{field:`currentOverlayPath`,ext:`.png`,artifactType:`screenshot`});try{let n=await Fo(e,t,a.path,{overlayRefs:!0,...Io(t)}),o=await a.publish();return o&&i.push(o),{...r,currentOverlayPath:n.path??a.path,...n.overlayRefs?{currentOverlayRefCount:n.overlayRefs.length}:{},...r.regions&&n.overlayRefs?{regions:To(r.regions,n.overlayRefs,r.normalization?.currentScale)}:{}}}catch(e){throw await a.cleanup?.(),e}}async function Fo(e,t,n,r={}){if(!e.backend.captureScreenshot)throw new i(`UNSUPPORTED_OPERATION`,`screenshot is not supported by this backend`);return await e.backend.captureScreenshot({session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata},n,r)??{}}function Io(e){return{normalizeStatusBar:e.normalizeStatusBar??!0,...e.surface?{surface:e.surface}:{}}}function Lo(e,t){if(e.currentOverlayOut)return e.currentOverlayOut;if(e.out?.kind===`path`)return{kind:`path`,path:$(t??e.out.path)};if(e.out?.kind===`downloadableArtifact`)return{kind:`downloadableArtifact`,...e.out.clientPath?{clientPath:$(e.out.clientPath)}:{},...e.out.fileName?{fileName:$(e.out.fileName)}:{}}}function $(e){let t=St.extname(e);return`${t?e.slice(0,-t.length):e}.current-overlay${t||`.png`}`}async function Ro(e){try{await F.unlink($(e))}catch(e){if(!Bo(e,`ENOENT`))throw e}}function zo(e){return e.kind===`live`}function Bo(e,t){return typeof e==`object`&&!!e&&`code`in e&&e.code===t}const Vo=async(e,t)=>{if(!e.backend.captureScreenshot)throw new i(`UNSUPPORTED_OPERATION`,`screenshot is not supported by this backend`);f(t);let n=await ko(e,t.out,{field:`path`,ext:`.png`,artifactType:`screenshot`}),r,a;try{a=(await e.backend.captureScreenshot({session:t.session,requestId:t.requestId,appId:t.appId,appBundleId:t.appBundleId,signal:t.signal??e.signal,metadata:t.metadata},n.path,{fullscreen:t.fullscreen,overlayRefs:t.overlayRefs,pixelDensity:t.pixelDensity,stabilize:t.stabilize,normalizeStatusBar:t.normalizeStatusBar,surface:t.surface}))?.displayRotation,t.scale!==void 0&&await it(n.path,t.scale),r=await n.publish()}catch(e){throw await n.cleanup?.(),e}return{path:n.path,...r?{artifacts:[r]}:{},...a?{displayRotation:a}:{},...D(`Saved screenshot: ${n.path}`)}};function Ho(e){let{nodes:t,backend:r,snapshotRaw:i}=e;if(i||!n(r))return{partial:!1,visibleNodeCount:t.length,totalNodeCount:t.length,reasons:[]};let a=Oe(t),o=new Set;return a.hiddenCount>0&&o.add(`offscreen-nodes`),a.nodes.some(e=>e.hiddenContentAbove)&&o.add(`scroll-hidden-above`),a.nodes.some(e=>e.hiddenContentBelow)&&o.add(`scroll-hidden-below`),{partial:o.size>0,visibleNodeCount:a.nodes.length,totalNodeCount:t.length,reasons:[...o]}}function Uo(e,t){return e.presentationKey?e:{...e,presentationKey:l(t)}}function Wo(e){let{previous:t,current:n,options:r,identity:i}=e;if(r.forceFull===!0||r.raw===!0||!t||t.comparisonSafe===!1||n.comparisonSafe===!1||!Go(t,n,i)||!t.presentationKey||t.presentationKey!==n.presentationKey||!Ko(t,n))return;let a=r.scope?.trim();return{ageMs:Math.max(0,n.createdAt-t.createdAt),nodeCount:n.nodes.length,...r.interactiveOnly===!0?{interactiveOnly:!0}:{},...a?{scope:a}:{}}}function Go(e,t,n){return!(e.backend&&t.backend&&e.backend!==t.backend||n?.previousAppBundleId&&n.currentAppBundleId&&n.previousAppBundleId!==n.currentAppBundleId)}function Ko(e,t){return e.truncated===t.truncated&&e.nodes.length===t.nodes.length&&e.nodes.every((e,n)=>Jo(e,t.nodes[n]))}const qo=Object.keys({index:!0,depth:!0,parentIndex:!0,type:!0,kind:!0,role:!0,subrole:!0,label:!0,value:!0,contentDescription:!0,identifier:!0,enabled:!0,editable:!0,password:!0,selected:!0,checked:!0,focused:!0,heading:!0,roleDescription:!0,placeholder:!0,hittable:!0,bundleId:!0,systemBar:!0,appName:!0,windowTitle:!0,surface:!0,keyboardOwned:!0,hiddenContentAbove:!0,hiddenContentBelow:!0,interactionBlocked:!0});function Jo(e,t){return qo.every(n=>e[n]===t[n])&&Xo(e.rect,t.rect)&&Yo(e.coveredBy,t.coveredBy)&&Zo(e.presentationHints,t.presentationHints)&&Zo(e.actions,t.actions)}function Yo(e,t){return!e||!t?e===t:e.kind===t.kind&&e.label===t.label&&Xo(e.rect,t.rect)}function Xo(e,t){return!e||!t?e===t:e.x===t.x&&e.y===t.y&&e.width===t.width&&e.height===t.height}function Zo(e,t){return!e||!t?e===t:e.length===t.length&&e.every((e,n)=>e===t[n])}const Qo=async(e,t)=>{let n=await es(e,t),r=Wo({previous:n.session?.snapshot,current:n.snapshot,options:t,identity:{previousAppBundleId:n.session?.appBundleId,currentAppBundleId:n.result.appBundleId??n.session?.appBundleId}});await e.sessions.set(ts(t.session,n));let i=rs(n.snapshot);return h(n.snapshot,{nodes:n.snapshot.nodes,...i===void 0?{}:{truncated:i},visibility:Ho({nodes:n.snapshot.nodes,backend:n.snapshot.backend,snapshotRaw:t.raw}),...m({...n.annotations,warnings:n.warnings}),...r?{unchanged:r}:{},...n.result.snapshotDiagnostics?{snapshotDiagnostics:n.result.snapshotDiagnostics}:{},...n.snapshot.keyboard?{keyboard:n.snapshot.keyboard}:{},...n.snapshot.viewport?{viewport:n.snapshot.viewport}:{},...n.snapshot.presentedSurface?{presentedSurface:n.snapshot.presentedSurface}:{},...ns(n)})},$o=async(e,t)=>{if(t.observeOnly===!0)throw new i(`INVALID_ARGS`,`observeOnly is supported by snapshot, not diff.`);let n=await es(e,t),r=t.interactiveOnly===!0,a=n.session?.snapshot,o=ts(t.session,n);if(!a){let t=At(n.snapshot.nodes,{flatten:r});return await e.sessions.set(o),{mode:`snapshot`,baselineInitialized:!0,summary:{additions:0,removals:0,unchanged:t},lines:[],...n.warnings.length>0?{warnings:n.warnings}:{}}}let s=kt(a.nodes,n.snapshot.nodes,{flatten:r});return await e.sessions.set(o),{mode:`snapshot`,baselineInitialized:!1,summary:s.summary,lines:s.lines,...n.warnings.length>0?{warnings:n.warnings}:{}}};async function es(e,t){if(!e.backend.captureSnapshot)throw new i(`UNSUPPORTED_OPERATION`,`snapshot is not supported by this backend`);let n=t.session??`default`,r=await e.sessions.get(n),a=await e.backend.captureSnapshot({session:n,requestId:t.requestId,appId:r?.appId,appBundleId:r?.appBundleId,signal:t.signal??e.signal,metadata:t.metadata},{interactiveOnly:t.interactiveOnly,depth:t.depth,scope:t.scope,raw:t.raw,customActions:t.customActions,...t.observeOnly===void 0?{}:{observeOnly:t.observeOnly}}),o=h(a.snapshot,Uo(a.snapshot,t)),s=p(a),c=L(e);return{snapshot:o,result:a,session:r,annotations:s,warnings:is({result:a,annotations:s,snapshot:o,options:t,session:r,capturedAt:o.createdAt,runtimeNow:c})}}function ts(e,t){let n=t.session?.name??e??`default`;return{...t.session??{name:n},name:n,snapshot:t.snapshot,appName:t.result.appName??t.session?.appName,appBundleId:t.result.appBundleId??t.session?.appBundleId}}function ns(e){let t=e.result.appName??e.session?.appName,n=e.result.appBundleId??e.session?.appBundleId;return{...t||n?{appName:t??n}:{},...n?{appBundleId:n}:{}}}function rs(e){return e.truncated===void 0?e.backend!==`xctest`||e.producer===void 0?!1:xt(e.producer)===`unavailable`&&void 0:e.truncated}function is(e){let t=[...e.annotations.warnings??[]];e.annotations.quality&&t.push(...gt(e.annotations.quality,e.snapshot.nodes)),t.push(..._t(rs(e.snapshot))),e.snapshot.postGestureOutcome&&t.push(Ke(e.snapshot.postGestureOutcome)),t.push(...ls(e)),e.annotations.quality||(t.push(...os(e)),t.push(...cs(e.snapshot.nodes)));let n=ut(e.snapshot.nodes);n&&t.push(n);let r=as(e.annotations);r&&t.push(r);let i=us(e);return i&&t.push(i),t.push(...ms(e.annotations.freshness,e.snapshot.backend)),Array.from(new Set(t))}function as(e){if(e.androidSnapshot?.systemSurfaceOnly===!0)return lt}function os(e){if(e.snapshot.backend!==`xctest`||e.options.interactiveOnly!==!0||e.snapshot.nodes.length!==1)return[];let t=e.snapshot.nodes[0];return ss(t)?e.snapshot.producer===`appium-source`?[`Appium page source exposed only the application root. Descendants may be absent from the acquired hierarchy; use snapshot --raw to inspect the source and verify the app accessibility tree.`]:e.snapshot.producer!==void 0&&e.snapshot.producer!==`apple-runner`?[]:[`iOS interactive snapshot exposed only the application root. XCTest accessibility queries can fail to enumerate some simulator UI trees even when screenshots and direct gestures still work. Use screenshot as visual truth, try a scoped/full snapshot for diagnostics, and prefer direct selectors when known.`]:[]}function ss(e){return e?fe(e.type??``)===`application`:!1}function cs(e){let t=new Set(e.map(e=>e.parentIndex).filter(e=>e!==void 0));return e.filter(e=>t.has(e.index)||(e.type?.toLowerCase()??``).includes(`text`)?!1:(e.label??``).split(`, `).length>10).map(e=>{let t=(e.label??``).split(`, `).length,n=e.identifier?` (${e.identifier})`:``;return`@${e.ref} [${e.type??`element`}]${n} merges ~${t} labels into a single accessibility element. The app likely marks a container as accessible, which hides every descendant from assistive tech and automation — the children cannot be addressed individually. Fix the app's accessibility (mark the rows, not the container); until then use screenshot as visual truth and coordinate taps.`})}function ls(e){let t=e.annotations.analysis;if(e.snapshot.backend!==`android`||e.options.interactiveOnly!==!0||e.snapshot.nodes.length>0||!t||(t.rawNodeCount??0)<12)return[];let n=[`Interactive snapshot is empty after filtering ${t.rawNodeCount} raw Android nodes. Likely causes: the app content is not accessibility-visible yet, a transient route change, or depth/filter options hid the target.`];return typeof e.options.depth==`number`&&typeof t.maxDepth==`number`&&t.maxDepth>=e.options.depth+2&&n.push(`Interactive output is empty at depth ${e.options.depth}; retry without -d.`),n}function us(e){let t=e.session?.snapshot;if(!e.annotations.freshness&&t&&ds(t,e.snapshot)&&fs(t,e.capturedAt,e.runtimeNow)&&He(t.nodes.length,e.snapshot.nodes.length))return ps}function ds(e,t){return e.presentationKey===void 0||t.presentationKey===void 0||e.presentationKey===t.presentationKey}function fs(e,t,n){return[t,n].some(t=>{let n=t-e.createdAt;return n>=0&&n<=2e3})}const ps=`Recent snapshots dropped sharply in node count, which suggests stale or mid-transition UI. Use screenshot as visual truth, wait briefly, then re-snapshot once.`;function ms(e,t){return!e?.staleAfterRetries||t!==`android`?[]:e.reason===`stuck-route`?[`Recent ${e.action} was followed by a nearly identical snapshot after ${e.retryCount} automatic retr${e.retryCount===1?`y`:`ies`}. If you expected navigation or submit, the tree may still be stale. Use screenshot as visual truth, wait briefly, then re-snapshot once.`]:e.reason===`sharp-drop`?[ps]:[]}const hs={screenshot:Vo,diffScreenshot:jo,snapshot:Qo,diffSnapshot:$o};function gs(e){return wt(hs,e)}function _s(e){return{backend:e.backend,artifacts:e.artifacts,sessions:e.sessions??vs(),policy:e.policy??ct(),diagnostics:e.diagnostics,clock:e.clock,signal:e.signal}}function vs(e=[]){let t=new Map(e.map(e=>[e.name,ys(e)]));return{get:e=>ys(t.get(e)),set:e=>{t.set(e.name,ys(e))},delete:e=>{t.delete(e)},list:()=>Array.from(t.values(),e=>ys(e))}}function ys(e){if(e)return{...e,...e.snapshot?{snapshot:structuredClone(e.snapshot)}:{},...e.metadata?{metadata:bs(e.metadata)}:{}}}function bs(e){try{return structuredClone(e)}catch{return{...e}}}export{Aa as a,R as c,Oo as i,I as l,gs as n,ka as o,ko as r,wt as s,_s as t};
1
+ import{C as e,G as t,L as n,N as r,Q as i,R as a,S as o,T as s,V as c,b as l,k as u,w as d}from"./sdk-contracts.js";import{jt as f}from"./tv-remote.js";import{a as p,t as m}from"./snapshot-capture-annotations.js";import{r as ee}from"./snapshot-private-evidence.js";import{_ as h,c as g,d as _,g as te,h as v,l as y,m as b,p as ne,v as x}from"./back-mode.js";import{$n as S,Ar as re,Bn as ie,En as ae,Kn as oe,Mr as se,Rn as ce,Tr as le,Ur as C,Wn as ue,Yn as de,Zr as fe,dr as pe,ei as me,er as he,gi as ge,jr as _e,lr as ve,nr as ye,or as be,pr as xe,qr as Se,rr as Ce,tr as we,ui as Te,ur as w}from"./sdk-batch.js";import{n as Ee,r as De,t as Oe}from"./target-evidence-tree.js";import{r as T}from"./success-text.js";import{n as ke,t as Ae}from"./mobile-snapshot-semantics.js";import{n as je,t as E}from"./interaction-error.js";import{n as Me,r as Ne,t as Pe}from"./absence-observation-errors.js";import{t as Fe}from"./android-snapshot-quality.js";import{c as Ie}from"./device-shell.js";import{a as Le,n as Re,r as ze,t as Be}from"./rect-center.js";import{a as Ve,n as He,t as Ue}from"./gesture-plan.js";import{T as We,a as Ge,d as Ke,f as qe,h as Je,i as D,m as Ye,n as Xe,o as Ze,r as Qe,t as O,u as $e}from"./selector-pipeline-policy.js";import{n as et,r as tt}from"./snapshot-chrome.js";import{a as nt,n as rt,o as it}from"./png-worker-client.js";import{o as at}from"./png-worker-contract.js";import{i as ot}from"./png-resize.js";import{i as st}from"./ios-system-surface.js";import{t as k}from"./snapshot-baseline.js";import{n as ct,t as lt}from"./snapshot-node-lookup.js";import{n as ut,t as dt}from"./snapshot-quality-verdict.js";import{n as ft}from"./command-policy.js";import{t as pt}from"./android-system-surface-disclosure.js";import{n as mt}from"./react-native-overlay2.js";import{n as ht,r as gt,t as _t}from"./keyboard-occlusion.js";import{n as vt,t as yt}from"./snapshot-evidence.js";import{n as bt,r as xt}from"./quality-warnings.js";import{n as St,t as A}from"./wait.js";import{n as Ct,t as wt}from"./replay.js";import{n as Tt}from"./ios-snapshot-acquisition.js";import{promises as j}from"node:fs";import Et from"node:path";function M(e,t){return{session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata}}function N(e){return e.clock?.now()??Date.now()}async function Dt(e,t){e.clock?await e.clock.sleep(t):await new Promise(e=>setTimeout(e,t))}function Ot(e,t){return Object.fromEntries(Object.entries(e).map(([e,n])=>[e,e=>n(t,e)]))}function P(e){return e&&typeof e==`object`?e:void 0}async function F(e,t,n){if(!e.backend.captureSnapshot)throw new a(`UNSUPPORTED_OPERATION`,`snapshot is not supported by this backend`);let r=t.session??`default`,i=await e.sessions.get(r);if(!i)throw new a(`SESSION_NOT_FOUND`,`No active session. Run open first.`);let o=(await e.backend.captureSnapshot(M(e,t),{interactiveOnly:n,includeRects:!0})).snapshot;return await e.sessions.set({...i,snapshot:o}),{snapshot:o}}function kt(e,t){if(!e||e.surfaceBundleId===t.surfaceBundleId)return;let n={from:e.surfaceBundleId??`app`,to:t.surfaceBundleId??`app`};return{...n,disclosure:st(n)}}function At(e,t){let n=yt(e.nodes),r=kt(t,e);if(r)return{...n,changedFromBefore:!0,surfaceChange:r};let i=t!==void 0&&n.digest!==yt(t.nodes).digest;return{...n,changedFromBefore:i}}function jt(e){return`${e.disclosure} The settled tree and the pre-action tree describe different surfaces (${e.from} → ${e.to}), so no settled diff or refs are shown; take a snapshot to read the current surface.`}function Mt(t,n){let r=e(t.type??`Element`),i=b(t,r),a=h(t).join(`,`),o=t.hittable===!0?`hittable`:`not-hittable`;return[String(n??t.depth??0),r,i,a,o,t.actions?JSON.stringify(t.actions):``].join(`|`)}function Nt(e,t,n={}){let r=It(Ft(e,n),Ft(t,n)),i={additions:0,removals:0,unchanged:0};for(let e of r)e.kind===`added`&&(i.additions+=1),e.kind===`removed`&&(i.removals+=1),e.kind===`unchanged`&&(i.unchanged+=1);return{summary:i,lines:r}}function Pt(e,t={}){return Ft(e,t).length}function Ft(e,t){return t.flatten?e.map(e=>({text:te(e,0,!1),comparable:Mt(e,0),...t.withRefs&&e.ref?{ref:e.ref}:{}})):ne(e).map(e=>({text:e.text,comparable:Mt(e.node,e.depth),...t.withRefs&&e.node.ref?{ref:e.node.ref}:{}}))}function It(e,t){let n=e.length,r=t.length,i=n+r,a=new Map,o=[];a.set(1,0);for(let s=0;s<=i;s+=1){o.push(new Map(a));for(let i=-s;i<=s;i+=2){let c=Rt(a,i,s)?I(a,i+1):I(a,i-1)+1,l=c-i;for(;c<n&&l<r&&e[c].comparable===t[l].comparable;)c+=1,l+=1;if(a.set(i,c),c>=n&&l>=r)return Lt(o,e,t,n,r)}}return[]}function Lt(e,t,n,r,i){let a=[],o=r,s=i;for(let r=e.length-1;r>=0;--r){let i=e[r],c=o-s,l=Rt(i,c,r)?c+1:c-1,u=I(i,l),d=u-l;for(;o>u&&s>d;)a.push({kind:`unchanged`,text:n[s-1].text}),--o,--s;if(r===0)break;if(o===u){let e=n[d];a.push({kind:`added`,text:e.text,...e.ref?{ref:e.ref}:{}}),s=d}else a.push({kind:`removed`,text:t[u].text}),o=u}return a.reverse(),a}function Rt(e,t,n){return t===-n||t!==n&&I(e,t-1)<I(e,t+1)}function I(e,t){return e.get(t)??0}function zt(e){return e===`text`||e===`label`||e===`any`}function Bt(e,t,n,r){if(!(r||e===`web`))return zt(t)?n:void 0}function Vt(e){return new a(`COMMAND_FAILED`,`find could not read the current accessibility tree`,{reason:e.reason,hint:`The snapshot quality verdict is sparse. Use screenshot as visual truth, navigate with coordinates if needed, then retry find after reaching a readable screen.`})}async function Ht(e,t){let n=t??`default`,r=await e.sessions.get(n);if(!r)throw new a(`SESSION_NOT_FOUND`,`No active session. Run open first.`);let i=r.refFrameSnapshot??r.snapshot;if(!i)throw new a(`INVALID_ARGS`,`No snapshot in session. Run snapshot first.`);return{sessionName:n,session:r,snapshot:i}}async function L(e,t,n={updateSession:!0}){let r=e.backend.captureSnapshot;if(!r)throw new a(`UNSUPPORTED_OPERATION`,`snapshot is not supported by this backend`);let i=t.session??`default`,o=await e.sessions.get(i),s=(await r(M(e,t),{interactiveOnly:n.interactiveOnly??!1,depth:t.depth,scope:n.scope??t.scope,raw:t.raw,includeRects:n.includeRects,...n.preferredBackend?{preferredBackend:n.preferredBackend}:{},...n.includeHiddenContentHints===void 0?{}:{includeHiddenContentHints:n.includeHiddenContentHints}})).snapshot;return(t.signal??e.signal)?.throwIfAborted(),n.updateSession&&o&&!dt(s.snapshotQuality)&&await e.sessions.set({...o,snapshot:s}),{sessionName:i,session:o,snapshot:s}}async function Ut(e,t,n){if(e.backend.readText){let r=await e.backend.readText(M(e,{session:t.sessionName}),n);if(r.text.trim())return r.text}return x(n)}function Wt(e,t,n){let r=u(t);if(!r)throw new a(`INVALID_ARGS`,n.invalidRefMessage);let i=o(e,r)??(n.fallbackLabel.length>0?ct(e,n.fallbackLabel):null);if(!i)throw new a(`COMMAND_FAILED`,n.notFoundMessage,{reason:E.refNotFound,ref:r,hint:ce});return{ref:r,node:i}}function Gt(e,n){let{diagnostics:r=[],unique:i=!0,dispatched:o,...s}=n,c=new a(`COMMAND_FAILED`,ie(e,r,{unique:i}),{...s,reason:E.selectorNotFound,hint:ue(r)});return o===void 0?c:t(c,o)}function Kt(e,t,n){let{command:r,...i}=n;return new a(`AMBIGUOUS_MATCH`,`Selector matched ${t.length} elements: ${e}`,{...i,...v(t),command:r,selector:e,hint:`Narrow the selector with role/id/longer text, or act on a printed candidate with a command that takes refs, such as press.`})}function qt(e){let{outcome:t,selectorExpression:n,command:r,details:i}=e;return t.kind===`ambiguous`?Kt(t.selector,t.matchedNodes,{command:r,...i}):Gt(n,{command:r,unique:!0,...i})}async function Jt(e,t,n,r){let i=new AbortController,a=[t.signal,e.signal].filter(e=>e!==void 0),o=AbortSignal.any([...a,i.signal]),s=!1,c=setTimeout(()=>{s=!0,i.abort(new DOMException(`Wait deadline exceeded`,`TimeoutError`))},Math.max(0,n));c.unref();try{let e=await r(o);return s&&!a.some(e=>e.aborted)?{timedOut:!0}:(o.throwIfAborted(),{timedOut:!1,value:e})}catch(e){if(s&&!a.some(e=>e.aborted))return{timedOut:!0,error:e};throw e}finally{clearTimeout(c)}}function Yt(e){let t=e.snapshotQuality?.backend,n=(e.backend===`xctest`?Xt(e.nodes):e.nodes).map($t);return n.sort((e,t)=>tn(e).localeCompare(tn(t))),{captureBackend:t,nodes:n}}function Xt(e){let t=C(e);return e.filter(e=>Se(e)||t.isVisibleOnScreen(e))}function Zt(e,t){return!e||e.captureBackend!==t.captureBackend||e.nodes.length!==t.nodes.length?!1:e.nodes.every((e,n)=>{let r=t.nodes[n];return!r||e.identity!==r.identity?!1:!e.rect||!r.rect?e.rect===r.rect:Be(e.rect,r.rect)})}function Qt(e,t){if(!e||e.nodes.length===0||t.nodes.length===0)return!1;let n=new Map;for(let t of e.nodes)n.set(t.identity,(n.get(t.identity)??0)+1);let r=0;for(let e of t.nodes){let t=n.get(e.identity)??0;t!==0&&(r+=1,n.set(e.identity,t-1))}return r/Math.max(e.nodes.length,t.nodes.length)<.5}function $t(e){return{identity:`${e.type??``}#${en(e)}`,...e.rect?{rect:{x:Math.round(e.rect.x),y:Math.round(e.rect.y),width:Math.round(e.rect.width),height:Math.round(e.rect.height)}}:{}}}function en(e){return[e.label,e.identifier,e.value].map(e=>String(e??``).trim()).join(`#`)}function tn(e){let t=e.rect;return`${e.identity}#${t?`${t.x},${t.y},${t.width},${t.height}`:``}`}function nn(e){return Math.min(300,Math.max(25,e))}const rn={"apple-runner":500,"simulator-ax-bridge":300,"appium-source":500,"limrun-ios-tree":500,"android-uiautomator":500,"harmonyos-uitest":500,"macos-helper":500,"linux-atspi":500,"agent-browser":500};function an(e){return e.producer===void 0?500:rn[e.producer]}const on=`Settled on a nearly-empty tree — the app may still be loading. Wait for specific content (wait text ...) before interacting.`;async function sn(e,t,n){let{timeoutMs:r}=n,i=N(e),a=i+r,o=!1,s=await e.sessions.get(t.session??`default`),c=n.quietMs??500,l=dn({baseline:n.broadTransitionBaseline,platform:e.backend.platform,appBundleId:s?.appBundleId}),u,d=un(i),f=0,p,m=(e,t,n)=>({settled:e,stalled:t,waitedMs:n,captures:f,nodeCount:d.lastNodeCount,quietMs:c,lastCapture:p}),ee=t=>({...m(!1,t.kind===`stalled`,N(e)-i),...t.kind===`failed`?{failure:{error:t.error}}:{}});for(;N(e)<a;){let s=await vn(e,t,a-N(e),u);if(s.kind!==`captured`)return ee(s);let{capture:h}=s;f+=1,p=h;let g=cn(h.snapshot,n.quietMs,l);c=g.quietMs;let{requiredQuietMs:_,pollMs:te}=g,v=Yt(h.snapshot);u??=ut(h.snapshot.snapshotQuality);let y=N(e),b=h.snapshot.nodes.length,ne=h.snapshot.snapshotQuality,x=ln({pacing:d,resetBudgetOnPrivateAxRecovery:n.resetBudgetOnPrivateAxRecovery,alreadyReset:o,state:{deadlineMs:a,timeoutMs:r,nowMs:y,verdict:ne,signal:v,nodeCount:b,requiredQuietMs:_,pollMs:te}});x&&(o=!0,a=x.deadlineMs);let S=x?{settled:!1,delayMs:x.delayMs}:d.observe({signal:v,nodeCount:b,nowMs:y,requiredQuietMs:_,pollMs:te,deadlineMs:a,captures:f});if(S.settled)return m(!0,!1,y-i);if(S.delayMs<=0)break;await Dt(e,S.delayMs)}return m(!1,!1,N(e)-i)}function cn(e,t,n){let r=t??an(e),i=n.requiredQuietMs(e,r);return{quietMs:r,requiredQuietMs:i,pollMs:nn(i)}}function ln(e){let{state:t}=e,n=gn({resetRequested:e.resetBudgetOnPrivateAxRecovery,alreadyReset:e.alreadyReset,verdict:t.verdict,nowMs:t.nowMs,timeoutMs:t.timeoutMs,deadlineMs:t.deadlineMs});if(n!==void 0)return e.pacing.restart({signal:t.signal,nodeCount:t.nodeCount,nowMs:t.nowMs}),{deadlineMs:n,delayMs:e.pacing.delayMs({nowMs:t.nowMs,requiredQuietMs:t.requiredQuietMs,pollMs:t.pollMs,deadlineMs:n})}}function un(e){let t,n=0,r=e;return{get lastNodeCount(){return n},observe(e){if(!Zt(t,e.signal))t=e.signal,n=e.nodeCount,r=e.nowMs;else if(e.captures>=2&&e.nowMs-r>=e.requiredQuietMs)return{settled:!0,delayMs:0};return{settled:!1,delayMs:_n({nowMs:e.nowMs,quietSinceMs:r,quietMs:e.requiredQuietMs,pollMs:e.pollMs,deadlineMs:e.deadlineMs})}},restart(e){t=e.signal,n=e.nodeCount,r=e.nowMs},delayMs(e){return _n({nowMs:e.nowMs,quietSinceMs:r,quietMs:e.requiredQuietMs,pollMs:e.pollMs,deadlineMs:e.deadlineMs})}}}function dn(e){let{platform:t,appBundleId:n}=e,r=e.baseline?.presentedSurface===`absent`?void 0:e.baseline,i,a;return{requiredQuietMs(e,o){if(i===void 0&&r&&(i=fn({baseline:r,capture:e,platform:t,appBundleId:n})),!i)return o;if(a===void 0){let t=pn(e,e.nodes,n);Qt(i,t)&&(a=Math.max(o,1500))}return a===void 0?o:Math.max(o,a)}}}function fn(e){let{baseline:t,capture:n,platform:r,appBundleId:i}=e;if(!mn(n.backend,r))return;let a=n.nodes.some(Se),o=t.presentedSurface===`presented`||t.nodes.length<=5;if(!(!a&&!o))return pn(n,t.nodes,i)}function pn(e,t,n){return Yt({...e,nodes:tt(t,n)})}function mn(e,t){return e===`xctest`||e===void 0&&t===`ios`}function hn(e){return e?.state===`recovered`&&e.backend===`private-ax`&&e.reasonCode!==`deferred`}function gn(e){if(!(e.resetRequested!==!0||e.alreadyReset||!hn(e.verdict)))return Math.max(e.deadlineMs,e.nowMs+e.timeoutMs)}function _n(e){let t=e.quietSinceMs+e.quietMs-e.nowMs,n=t>e.pollMs?e.pollMs:Math.max(25,t+2),r=e.deadlineMs-e.nowMs,i=r-1;return i<2?r>=2?r:0:Math.min(n,i)}async function vn(e,t,n,r){try{let i=await Jt(e,t,n,async n=>await L(e,{...t,signal:n},{updateSession:!1,interactiveOnly:!0,preferredBackend:r}));return i.timedOut?{kind:`stalled`}:{kind:`captured`,capture:i.value}}catch(e){return{kind:`failed`,error:e}}}function yn(e,t,n){return{observation:{...e,captures:t?.captures??e.captures,waitedMs:t?.waitedMs??e.waitedMs,quietMs:t?.quietMs??e.quietMs,hint:`Settle observation unavailable (${n instanceof Error?n.message:String(n)}). The action itself succeeded; take a snapshot to observe the result.`}}}const bn=`The UI kept changing for the whole settle budget (animation, carousel, or ticker?), so no settled diff is shown. Raise --timeout, wait for specific content, or take a fresh snapshot.`,xn=`A snapshot capture stalled past the settle budget, so no settled diff is shown. The action itself succeeded; observe with wait stable or snapshot.`;async function Sn(e,t,n){return await wn(e,t,{...n,baseline:await Dn(e,t,n.resolved),actionPoint:n.resolved.point})}const Cn=async(e,t)=>(await wn(e,t,t)).observation;async function wn(e,t,n){let r=n.timeoutMs??1e4,i={settled:!1,waitedMs:0,captures:0,quietMs:n.quietMs??500,timeoutMs:r},a;try{return a=await sn(e,t,{...n.quietMs===void 0?{}:{quietMs:n.quietMs},timeoutMs:r,resetBudgetOnPrivateAxRecovery:!0,broadTransitionBaseline:n.baseline}),a.failure?yn(i,a,a.failure.error):await Tn(e,t,n,i,a)}catch(e){return yn(i,a,e)}}async function Tn(e,t,n,r,i){let a={...r,settled:i.settled,waitedMs:i.waitedMs,captures:i.captures,quietMs:i.quietMs};if(!i.lastCapture)return{observation:{...a,hint:i.stalled?xn:bn}};let{stored:o,session:s}=await Bn(e,t,i.lastCapture),c=k(i.lastCapture.snapshot),l=c.nodes,u=kt(n.baseline,c);return{observation:{...a,...u?{surfaceChange:u}:{},...i.settled&&o&&!u?Mn(n.baseline.nodes,l,n.actionPoint,s?.appBundleId):{},...Rn(i,o,l.length,u)},settledCapture:c}}function En(e,t){if(e)return At(e,t)}async function Dn(e,t,n){let r=await e.sessions.get(t.session??`default`);return On(n,r)??An(n.preAction)??kn(r)}function On(e,t){if(e.kind===`ref`)return An(k(t?.refFrameSnapshot))}function kn(e){let{presentedSurface:t,...n}=k(e?.refFrameSnapshot??e?.snapshot);return n}function An(e){return e?.nodes.length?e:void 0}function jn(e,t,n){let r=Nt(tt(e,n),tt(t,n),{flatten:!0,withRefs:!0}),i=r.lines.filter(e=>e.kind!==`unchanged`),a=Ln(i).map(e=>({kind:e.kind,text:e.text,...e.ref?{ref:e.ref}:{}}));return{summary:r.summary,lines:a,...i.length>a.length?{truncated:!0}:{}}}function Mn(e,t,n,r){let i=jn(e,t,r);return{diff:i,...Nn(i,t,n,r)}}function Nn(e,t,n,r){let i=new Set(e.lines.filter(e=>e.kind===`added`&&e.ref).map(e=>e.ref)),a=et(t,r),o=new Map(t.filter(e=>e.ref).map(e=>[e.ref,e]));return[...i].some(e=>e!==void 0&&!a.has(e)&&!Pn(o.get(e),n))?{}:In(t,i,r)}function Pn(e,t){if(!e?.rect||!t)return!1;let{x:n,y:r,width:i,height:a}=e.rect;return t.x>=n&&t.x<=n+i&&t.y>=r&&t.y<=r+a}const Fn=new Set([`application`,`window`]);function In(t,n,r){let i=et(t,r),a=t.filter(t=>t.interactionBlocked!==`covered`&&!Fn.has(e(t.type??`Element`))).filter(d).filter(e=>!n.has(e.ref)&&!i.has(e.ref));if(a.length===0)return{};let o=a.slice(0,20).map(t=>{let n=e(t.type??`Element`),r=b(t,n);return{ref:t.ref,role:n,...r?{label:r}:{}}});return{tail:o,...a.length>o.length?{tailTruncated:!0}:{}}}function Ln(e){if(e.length<=80)return e;let t=e.filter(e=>e.kind===`added`),n=new Set(t.slice(0,80)),r=80-n.size,i=[];for(let t of e)n.has(t)?i.push(t):t.kind===`removed`&&r>0&&(i.push(t),--r);return i}function Rn(e,t,n,r){let i=zn(e,t,n).hint;if(!r)return i===void 0?{}:{hint:i};let a=jt(r);return{hint:i===void 0?a:`${a} ${i}`}}function zn(e,t,n){return e.stalled?{hint:xn}:e.settled?t?n<5?{hint:on}:{}:{hint:`Settled on a sparse, unreadable tree — the diff is omitted and its refs/selectors are invalid. Use screenshot as visual truth and coordinate taps; retry snapshot after navigating.`}:{hint:bn}}async function Bn(e,t,n){if(dt(n.snapshot.snapshotQuality))return{stored:!1};let r=await e.sessions.get(t.session??`default`);return r?(await e.sessions.set({...r,snapshot:n.snapshot}),{stored:!0,session:r}):{stored:!1}}function R(e){let t=e.verify===!0;return{verify:t,needsPreActionBaseline:t||e.settle!==void 0,...e.settle===void 0?{}:{settle:e.settle}}}async function z(e,t,n,r,i){let a=await Vn(e,t,n,i);return Un({...r,...a})}async function Vn(e,t,n,r){if(r.settle!==void 0){let i=await Sn(e,t,{...r.settle,resolved:n}),a=r.verify?En(i.settledCapture,n.preAction):void 0;return{settle:i.observation,...a?{evidence:a}:{}}}if(!r.verify)return{};let i=await Hn(e,t,n);return i?{evidence:i}:{}}async function Hn(e,t,n){try{let r=await F(e,t,!0);return At(k(r.snapshot),n.preAction)}catch{return}}function Un(e){let t=e;if(t.targetHittable!==!1||!Wn(t)||t.hint===void 0)return e;let{hint:n,...r}=t;return r}function Wn(e){if(e.evidence?.changedFromBefore===!0||e.settle?.surfaceChange!==void 0)return!0;let t=e.settle?.diff?.summary;return!!t&&(t.additions>0||t.removals>0)}function Gn(e){return t(new a(`COMMAND_FAILED`,`${e.label} is covered by another visible element and cannot ${gt(e.action)} safely`,je(e.node,{selector:e.selector})),`no`)}async function Kn(e){let t=await Ge(e.policy,e.nodes,e.node,e.hooks);if(t.kind===`occluded`)throw Gn({label:e.label,node:t.node,action:e.action});let n=e.resolveTapPoint(t.node);return _t({nodes:e.nodes,node:t.node,action:e.action,label:e.label,...e.keyboard?{keyboard:e.keyboard}:{},tapPoint:n}),{node:t.node,tapPoint:n}}async function qn(e,t,n,r,i,{action:a}){return await Xn(e,t,n,r,{message:`Selector ${i} resolved to an off-screen element and is not safe to ${a}`,details:{reason:`offscreen_selector`,selector:i},hint:e=>`${Yn(e,i)} then retry ${a} with the same selector. --until checks the selector between passes, so it stops on the target rather than sailing past it. If it is inside a closed drawer or another tab, open that container first.`})}async function Jn(e,t,n,r,i,{action:a}){return await Xn(e,t,n,r,{message:`Ref ${i} is off-screen and not safe to ${a}`,details:{reason:`offscreen_ref`,ref:u(i)},hint:e=>`${Yn(e,null)} then retry ${a} with a selector (e.g. text=/id=) rather than this @ref — the scroll expires the ref frame, so re-run snapshot -i before reusing any @ref.`})}function Yn(e,t){return e?t?`Run scroll ${e} --until '${t}' to bring it on screen,`:`Scroll ${e} toward it,`:`Scroll toward it,`}async function Xn(e,n,r,i,o){let s=C(i),c=r.rect?s.resolveEffectiveViewport(r):null;if(!r.rect||!c||s.isVisibleOnScreen(r))return r;let l=s.resolveViewport(r.rect),u=await e.backend.confirmOffscreenTargetVisible?.(M(e,n),r,l);if(u)return{...r,rect:u};let d=ke(r,s);throw t(new a(`COMMAND_FAILED`,o.message,{...o.details,rect:r.rect,viewport:c,...d?{scrollDirection:d}:{},hint:o.hint(d)}),`no`)}function Zn(e,t,n,r){let i=Qe(r,e,t,{platform:n});if(i.kind===`none`)return null;if(i.kind===`ambiguous`)throw new a(`AMBIGUOUS_MATCH`,`Selector matched ${i.candidates.length} distinct actionable elements: ${i.selector}`,{selector:i.selector,...v(i.candidates)});return i.resolution}async function Qn(e,t,n,r){let i=await F(e,t,r.requireInteractive),a=Zn(i.snapshot.nodes,n,e.backend.platform,r.pipeline);if((!a||!a.node.rect)&&r.requireInteractive){let o=i.snapshot;i=await F(e,t,!1),s(o,i.snapshot),a=Zn(i.snapshot.nodes,n,e.backend.platform,r.pipeline)}return{capture:i,resolved:a}}async function $n(e){let{runtime:t,nodes:n,selectorExpression:r,action:i}=e,a=await D(O.coveredDiagnosis,n,r,{platform:t.backend.platform});if(a.kind===`occluded`)return Gn({label:`Selector ${a.selector}`,node:a.node,action:i,selector:a.selector})}async function er(e){let{runtime:t,nodes:n,selectorExpression:r,action:i,resolved:a}=e;return await $n({runtime:t,nodes:n,selectorExpression:r,action:i})||Gt(r,{diagnostics:a?.diagnostics??[],unique:!0,dispatched:`no`})}function B(e,n,r,i,o){if(!r)return;let s=w(e),c=pe(e,n);if(!(be(s,r.identity)&&xe(c,r.structural)))throw t(new a(`COMMAND_FAILED`,`${i} resolved to a different element than replay verification isolated; the action was not sent`,{reason:wt,observed:s,observedStructural:c,expected:r.identity,expectedStructural:r.structural,...o?{targetRole:o}:{}}),`no`)}function tr(e,t,n){B(e,t,n.expectedResolvedTarget,n.action,n.replayTargetRole)}function nr(e){return e.hittable===!0||$e(e)}function rr(e,t){let n=Ce(w(e),t);return n.id!==void 0||n.label!==void 0?!1:we(e.value)===null}function ir(e,t,n){let r=new Set,i=e;for(;typeof i.parentIndex==`number`;){if(r.has(i.index))return!1;if(r.add(i.index),i.parentIndex===t.index)return!0;let e=n.get(i.parentIndex);if(!e)return!1;i=e}return!1}function ar(e,t){let n=Ee(t);return t.filter(t=>t.index!==e.index&&ir(t,e,n)).sort((e,t)=>e.index-t.index)}function or(e,t){let n=Le(e.rect);return!n||!t.rect?!1:Te(t.rect,n.x,n.y)}function sr(e,t){if(!rr(e,t))return e;let n=ar(e,t);if(n.some(nr))return e;let r=n.find(e=>w(e).label!==void 0);return!r||!or(r,e)?e:r}function cr(e,t){if(Buffer.byteLength(e,`utf8`)<=t)return e;let n=Buffer.byteLength(`…`,`utf8`),r=Math.max(0,t-n),i=Buffer.from(e,`utf8`),a=Math.min(r,i.length);for(;a>0&&(i[a]&192)==128;)--a;return i.subarray(0,a).toString(`utf8`)+`…`}const lr={source:`ref`,phase:`pre-action`,kind:`exact`},ur={source:`ref`,phase:`pre-action`,kind:`label-fallback`};function V(e,t,n){return{ref:e,node:t,resolution:n===`exact`?lr:ur}}const dr={source:`runtime`,phase:`pre-action`,kind:`unique`};function fr(e,t){return e.disambiguation?{source:`runtime`,phase:`pre-action`,kind:`disambiguated`,matchCount:e.disambiguation.matchCount,winnerDiagnostic:pr(e.node,t),tiebreak:e.disambiguation.tiebreak,alternatives:e.disambiguation.alternatives.slice(0,5).map(e=>pr(e,t))}:dr}function pr(e,t){let n=me(e.type??``),r=lt(e,t);return{diagnosticRef:`diag-${e.ref}`,...n?{role:cr(n,256)}:{},...r===void 0?{}:{label:cr(r,256)}}}function mr(e,t,n,r,i){let a=n.nodes;return{node:t,selectorChain:he(t,e.backend.platform,{action:r===`fill`?`fill`:`click`,nodes:a}),refLabel:lt(t,a),...gr(t,r),preAction:n,resolution:i,...hr(e,t,a,r)}}function hr(e,t,n,r){if(r!==`click`&&r!==`press`)return{};let i=sr(t,n);return i===t?{}:{recordingTarget:{node:i,selectorChain:he(i,e.backend.platform,{action:`click`,nodes:n}),refLabel:lt(i,n)}}}function gr(e,t){return e.hittable===!1?{targetHittable:!1,hint:`The resolved element reports hittable: false, so this ${t} may have had no visible effect. Verify with a snapshot, or prefer a @ref or a longer/more specific selector to target the intended element.`}:{}}function _r(e,t,n={}){let i=ze(t.rect),a=Le(i??void 0);if(!i||!a)return{kind:`invalid`};let o=vr(e,t,i);if(o.length===0)return{kind:`resolved`,point:a,strategy:`center`};let s=(n.bounds??[]).reduce((e,t)=>e?br(e,t):null,i),c=s?xr(i,s,a,o):null;return c?{kind:`resolved`,point:c,strategy:`parent-owned`}:{kind:`blocked`,competitorRefs:r(o),competitorCount:o.length}}function vr(e,t,n){let r=new Map(e.map(e=>[e.index,e]));return e.filter(e=>e.index!==t.index).filter(e=>yr(e,t,r)).filter($e).flatMap(e=>{let t=ze(e.rect);if(!t||Re(t,n))return[];let r=br(t,n);return r&&r.width>0&&r.height>0?[{ref:e.ref,index:e.index,rect:r}]:[]}).sort((e,t)=>e.index-t.index)}function yr(e,t,n){let r=new Set,i=e;for(;typeof i.parentIndex==`number`&&!r.has(i.index);){if(r.add(i.index),i.parentIndex===t.index)return!0;let e=n.get(i.parentIndex);if(!e)return!1;i=e}return!1}function br(e,t){let n=Math.max(e.x,t.x),r=Math.max(e.y,t.y),i=Math.min(e.x+e.width,t.x+t.width),a=Math.min(e.y+e.height,t.y+t.height);return i<=n||a<=r?null:{x:n,y:r,width:i-n,height:a-r}}function xr(e,t,n,r){let i=Er(e),a=wr(t.x,t.width,n.x,r.flatMap(({rect:e})=>[e.x,e.x+e.width]),i),o=wr(t.y,t.height,n.y,r.flatMap(({rect:e})=>[e.y,e.y+e.height]),i);return a.flatMap(a=>o.flatMap(o=>{let s={x:Math.round(a),y:Math.round(o)};if(!Te(t,s.x,s.y))return[];let c=Sr(s,e,n,r,i);return c?[c]:[]})).sort(Cr)[0]?.point??null}function Sr(e,t,n,r,i){let a=Tr(e,t,r);return a.parentEdge<i||a.competitor<12?null:{point:e,distanceSquared:(e.x-n.x)**2+(e.y-n.y)**2,clearance:Math.min(a.parentEdge,a.competitor)}}function Cr(e,t){return e.distanceSquared-t.distanceSquared||t.clearance-e.clearance||e.point.y-t.point.y||e.point.x-t.point.x}function wr(e,t,n,r,i){let a=e+i,o=e+t-i;if(a>o)return[];let s=[...new Set([e,e+t,...r])].sort((e,t)=>e-t),c=new Set([n,a,o]);for(let e of r)c.add(e-12),c.add(e+12);for(let e=1;e<s.length;e+=1)c.add((s[e-1]+s[e])/2);return[...c].filter(e=>e>=a&&e<=o).sort((e,t)=>e-t)}function Tr(e,t,n){let r=Math.min(e.x-t.x,t.x+t.width-e.x,e.y-t.y,t.y+t.height-e.y),i=1/0;for(let{rect:t}of n){let n=e.x<t.x?t.x-e.x:Math.max(0,e.x-(t.x+t.width)),r=e.y<t.y?t.y-e.y:Math.max(0,e.y-(t.y+t.height));i=Math.min(i,Math.max(n,r))}return{parentEdge:r,competitor:i}}function Er(e){let t=Math.min(e.width,e.height);return Math.max(0,Math.min(12,Math.floor(t/2)-1))}function Dr(e,n,r){let i=C(n),o=_r(n,e,{bounds:[i.resolveEffectiveViewport(e),e.rect?i.resolveViewport(e.rect):null].filter(e=>e!==null)});if(o.kind===`resolved`)return o.point;throw o.kind===`invalid`?t(new a(`COMMAND_FAILED`,r.invalidMessage,{reason:E.targetBoundsInvalid,...Or(r.blockedTargetDetails)}),`no`):t(new a(`COMMAND_FAILED`,`${r.blockedTargetLabel} has no parent-owned touch point outside its interactive descendants`,{reason:`covered_by_interactive_descendants`,...r.blockedTargetDetails,competitorRefs:o.competitorRefs.slice(0,5).map(e=>`@${e}`),competitorCount:o.competitorCount,hint:`Tap the specific interactive child you intend, or use a more specific selector. Every safely tappable region of the parent belongs to one of its child controls.`}),`no`)}function Or(e){return`ref`in e?{ref:u(e.ref)??e.ref}:e}function kr(e,t){let n=u(e.ref);if(!n)throw new a(`INVALID_ARGS`,`Invalid ref: ${e.ref}`);if(u(t.ref)!==n||!d(t.node)||u(t.node.ref)!==n||!t.tree.nodes.includes(t.node))throw new a(`COMMAND_FAILED`,`Internal find target provenance does not match the interaction ref`);return{tree:t.tree,...t.keyboard?{keyboard:t.keyboard}:{},resolved:V(n,t.node,`exact`)}}async function Ar(e,t,n){let r=await Mr(e,t,n);return{tree:k(r.snapshot),...r.snapshot.keyboard?{keyboard:r.snapshot.keyboard}:{},...r.adoptedFrom?{adoptedFrom:r.adoptedFrom}:{},resolved:r.resolved}}async function jr(e,t,n,r){let{tree:i,keyboard:a,resolved:o,adoptedFrom:s}=r.preresolvedTarget?kr(n,r.preresolvedTarget):await Ar(e,t,n),c=i.nodes,{node:l,tapPoint:d}=await Kn({policy:r.pipeline,nodes:c,...a?{keyboard:a}:{},node:o.node,action:r.action,label:`Ref ${n.ref}`,hooks:{onResolved:(e,t)=>tr(e,t,r),offscreen:async(i,a)=>await Jn(e,t,i,a,n.ref,r)},resolveTapPoint:e=>Dr(e,c,{invalidMessage:`Ref ${n.ref} has no usable bounds`,blockedTargetLabel:`Ref ${n.ref}`,blockedTargetDetails:{ref:`@${u(n.ref)??e.ref}`}})});return{kind:`ref`,point:d,target:{kind:`ref`,ref:`@${o.ref}`},...s?{adoptedFrom:s}:{},...mr(e,l,i,r.action,o.resolution)}}async function Mr(e,t,n){let{session:r,snapshot:i}=await Ht(e,t.session),a=n.fallbackLabel??``,o=Fr(i.nodes,n.ref,{fallbackLabel:a});if(o.kind!==`resolved`)throw Ir(o,n.ref);return Nr({platform:e.backend.platform,session:r,frameTree:i,target:n,fallbackLabel:a,authorized:o.resolved})}function Nr(e){let{session:t,frameTree:n,target:r,fallbackLabel:i,authorized:a}=e,o=t.snapshot;if(!o)return{snapshot:n,resolved:a,adoptedFrom:`authorized-frame`};if(o===n)return{snapshot:n,resolved:a,adoptedFrom:`observation`};let s=Pr({...e,observation:o});if(s)return s;let c=Fr(o.nodes,r.ref,{fallbackLabel:i});return c.kind===`resolved`&&be(w(a.node),w(c.resolved.node))?{snapshot:o,resolved:c.resolved,adoptedFrom:`observation`}:{snapshot:n,resolved:a,adoptedFrom:`authorized-frame`}}function Pr(e){let{platform:t,frameTree:n,observation:r,authorized:i}=e;if(t!==`android`||!i.node.identifier||!i.node.bundleId||k(n).surfaceBundleId!==k(r).surfaceBundleId)return;let a=w(i.node),o=e=>be(a,w(e));if(n.nodes.filter(o).length!==1)return;let s=r.nodes.filter(e=>d(e)&&e.bundleId===i.node.bundleId&&o(e)),c=s[0];return s.length!==1||!c||!d(c)?{snapshot:n,resolved:i,adoptedFrom:`authorized-frame`}:{snapshot:r,resolved:V(i.ref,c,i.resolution.kind===`label-fallback`?`label-fallback`:`exact`),adoptedFrom:`observation`}}function Fr(e,t,n){let r=u(t);if(!r)throw new a(`INVALID_ARGS`,`Invalid ref: ${t}`);let i=o(e,r);if(Lr(i))return{kind:`resolved`,resolved:V(r,i,`exact`)};let s=n.fallbackLabel.length>0?ct(e,n.fallbackLabel):null;if(Lr(s))return{kind:`resolved`,resolved:V(r,s,`label-fallback`)};let c=i??s;return c?{kind:`unusable`,node:c}:{kind:`missing`}}function Ir(e,n){let r=u(n)??n,i=e.kind===`unusable`?new a(`COMMAND_FAILED`,`Ref ${n} has no usable bounds`,{reason:E.targetBoundsInvalid,ref:r,hint:ce}):new a(`COMMAND_FAILED`,`Ref ${n} not found`,{reason:E.refNotFound,ref:r,hint:ce});return t(i,`no`)}function Lr(e){return e?d(e)&&Le(e.rect)!==null:!1}async function H(e,t,n){return await Hr(e,t,n.action),t.target.kind===`point`?await zr(e,t,t.target,n):t.target.kind===`ref`?await jr(e,t,t.target,n):await Vr(e,t,t.target,n)}async function Rr(e,t,n){let r=(await e.sessions.get(t.session??`default`))?.snapshot,i=r?.nodes;if(!i)return;let a={x:n.x,y:n.y},o=C(i).resolveViewport({x:a.x,y:a.y,width:0,height:0});return o&&!Te(o,a.x,a.y)?`Coordinates (${a.x}, ${a.y}) are outside the last-known viewport (${o.width}x${o.height}). The tap will be forwarded anyway; take a fresh snapshot if the screen changed.`:ht({nodes:i,point:a,viewport:o,...r?.keyboard?{keyboard:r.keyboard}:{}})}async function zr(e,t,n,r){let i=await Rr(e,t,n);if(!r.captureEvidenceBaseline)return{kind:`point`,point:{x:n.x,y:n.y},...i?{warning:i}:{}};let a=await Br(e,t);return{kind:`point`,point:{x:n.x,y:n.y},...a?{preAction:a}:{},...i?{warning:i}:{}}}async function Br(e,t){try{let n=await F(e,t,!0);return k(n.snapshot)}catch{return}}async function Vr(e,t,n,r){let i=n.selector,{capture:a,resolved:o}=await Qn(e,t,i,r);if(!o||!o.node.rect)throw await er({runtime:e,nodes:a.snapshot.nodes,selectorExpression:i,action:r.action,resolved:o});let s=o,{node:c,tapPoint:l}=await Kn({policy:r.pipeline,nodes:a.snapshot.nodes,...a.snapshot.keyboard?{keyboard:a.snapshot.keyboard}:{},node:s.node,action:r.action,label:`Selector ${s.selector}`,hooks:{onResolved:(e,t)=>tr(e,t,r),offscreen:async(n,i)=>await qn(e,t,n,i,s.selector,r)},resolveTapPoint:e=>Dr(e,a.snapshot.nodes,{invalidMessage:`Selector ${o.selector} resolved to invalid bounds`,blockedTargetLabel:`Selector ${i}`,blockedTargetDetails:{selector:i}})});return{kind:`selector`,point:l,target:{kind:`selector`,selector:o.selector},...mr(e,c,k(a.snapshot),r.action,fr(o,a.snapshot.nodes))}}async function Hr(e,t,n){if(e.backend.platform!==`macos`)return;let r=await Ur(e,t);if((r===`desktop`||r===`menubar`)&&(r!==`menubar`||n!==`click`&&n!==`press`))throw new a(`UNSUPPORTED_OPERATION`,`${n} is not supported on macOS ${r} sessions yet. Open an app session to act, or use the ${r} surface to inspect.`)}async function Ur(e,t){return(await e.sessions.get(t.session??`default`))?.metadata?.surface}async function Wr(e,t,n,r){if(r.kind===`point`||!r.node?.rect||n.expectedResolvedTarget||n.preresolvedTarget)return r;let i=await Kr(e,t,r.node,r.preAction);return i?e.backend.platform===`android`?await Xr(e,t,n,r,i):await Yr(e,t,n,r,i):r}function Gr(e){if(e.baselineFinishedAtMs===void 0)return{kind:`idle`};let t=e.nowMs-e.baselineFinishedAtMs,n=e.windowMs??500;return t>=n?{kind:`not-recent`}:e.targetShownAtRest?{kind:`stationary`}:{kind:`recheck`,waitMs:Math.max(n-t,50)}}async function Kr(e,t,n,r){let i=await Jr(e,t);if(!i)return;let a=Gr({baselineFinishedAtMs:i.finishedAt,targetShownAtRest:qr(i,n,r),nowMs:N(e),...e.backend.platform===`android`?{windowMs:1500}:{}});return a.kind===`recheck`?a:void 0}function qr(e,t,n){if(e.tree.surfaceBundleId!==n?.surfaceBundleId)return!1;let r=ve(e.tree.nodes,t);return r!==void 0&&Be(r,t.rect)}async function Jr(e,t){return(await e.sessions.get(t.session??`default`))?.movingTargetBaseline}async function Yr(e,t,n,r,i){let a=N(e);await Dt(e,i.waitMs);let o=await Qr(e,t,n);if(!o.measured)throw U(r,void 0,N(e)-a);await Dt(e,50);let s=Zr(o,await Qr(e,t,n));if(s.measured&&Be(o.rect,s.rect))return s.resolved;throw U(r,s.rect,N(e)-a)}async function Xr(e,t,n,r,i){let a=N(e),o=a+Math.max(i.waitMs,100),s=await Qr(e,t,n);if(!s.measured)throw U(r,void 0,N(e)-a);let c=N(e),l=0;for(;l<2||N(e)<o;){await Dt(e,50);let i=Zr(s,await Qr(e,t,n));if(l++,!i.measured)throw U(r,void 0,N(e)-a);if(Be(s.rect,i.rect)||(c=N(e)),N(e)-c>=100)return i.resolved;s=i}throw U(r,s.rect,N(e)-a)}function Zr(e,t){return t.measured&&t.surfaceBundleId===e.surfaceBundleId?t:{measured:!1,rect:void 0,resolved:t.resolved}}async function Qr(e,t,n){if(t.target.kind!==`ref`){let r=await H(e,t,n),i=ei(r),a=r.preAction?.surfaceBundleId;return i?{measured:!0,resolved:r,rect:i,surfaceBundleId:a}:{measured:!1,resolved:r,rect:void 0}}let{snapshot:r}=await F(e,t,!0),i=await H(e,t,n);return{resolved:i,...$r(k(r),i)}}function $r(e,t){let n=ei(t);return n!==void 0&&`adoptedFrom`in t&&t.adoptedFrom===`observation`?{measured:!0,rect:n,surfaceBundleId:e.surfaceBundleId}:{measured:!1,rect:void 0}}function ei(e){return`node`in e?e.node?.rect:void 0}function ti(e){return`The target had no confirmed resting position when the transition window after the previous action ran out, so nothing was dispatched. ${e.selector?`Run wait ${Ie(e.selector)} and retry with the same selector`:`Run snapshot -i and retry with a selector (text=/id=) rather than this @ref — re-observing retires the ref frame`}; or pass --settle to have the action itself wait for the UI to go quiet.`}function U(e,n,r){let i=e.target.kind===`selector`?e.target.selector:void 0,o=e.target.kind===`ref`?e.target.ref:void 0;return t(new a(`COMMAND_FAILED`,i?`Selector ${i} had no confirmed resting position when the transition window ran out`:`Ref ${o} had no confirmed resting position when the transition window ran out`,{reason:E.targetStillMoving,...i===void 0?{ref:o}:{selector:i},...e.node?.rect?{rect:e.node.rect}:{},...n?{movedToRect:n}:{},waitedMs:r,hint:ti({selector:i})}),`no`)}async function ni(e,t,n,r){let i=(await e.sessions.get(t.session??`default`))?.snapshot,a=i?.nodes;if(!i||!a||u(n.ref)===null)return{};let o=Fr(a,n.ref,{fallbackLabel:n.fallbackLabel??``});if(o.kind!==`resolved`)return{};let{resolved:s}=o,c=O.resolvedTarget,{node:l}=await Kn({policy:c,nodes:a,node:s.node,action:r,label:`Ref ${n.ref}`,hooks:{offscreen:async(i,a)=>await Jn(e,t,i,a,n.ref,{action:r,pipeline:c})},resolveTapPoint:e=>Le(e.rect)});return{...gr(l,r),node:l,preAction:k(i)}}async function ri(e,t,n,r,i){let a=await ni(e,t,n,r),o=P(await i(M(e,t),{kind:`ref`,ref:n.ref,...n.fallbackLabel?{fallbackLabel:n.fallbackLabel}:{}}));return{kind:`ref`,target:{kind:`ref`,ref:n.ref},resolution:lr,...a,...o?{backendResult:o}:{}}}function ii(e,t){let n=C(e),r=e.filter(n.isVisibleInEffectiveViewport).map(e=>e.rect).filter(ai),i=r.length>0?r:e.map(e=>e.rect).filter(ai);if(i.length===0)throw new a(`COMMAND_FAILED`,`Cannot infer viewport for ${t}`);let o=Math.min(...i.map(e=>e.x)),s=Math.min(...i.map(e=>e.y)),c=Math.max(...i.map(e=>e.x+e.width)),l=Math.max(...i.map(e=>e.y+e.height));return{x:o,y:s,width:c-o,height:l-s}}function ai(e){return!!(e&&e.width>0&&e.height>0)}async function oi(e,t){return await e.backend.resolveGestureViewport?.(M(e,t))||ii((await F(e,t,!1)).snapshot.nodes,`gesture`)}const si=async(e,t)=>{let n=await H(e,t,{action:`focus`,requireInteractive:!0,pipeline:O.resolvedTarget});if(!e.backend.focus)throw new a(`UNSUPPORTED_OPERATION`,`focus is not supported by this backend`);let r=W(n),i=P(await e.backend.focus(M(e,t),r));return{...n,...i?{backendResult:i}:{},...T(`Focused (${r.x}, ${r.y})`)}},ci=async(e,t)=>{let n=R(t),r=await H(e,t,{action:`longPress`,requireInteractive:!0,pipeline:O.promotedTarget,captureEvidenceBaseline:n.needsPreActionBaseline,expectedResolvedTarget:t.expectedResolvedTarget});if(!e.backend.longPress)throw new a(`UNSUPPORTED_OPERATION`,`longPress is not supported by this backend`);let i=t.durationMs===void 0?void 0:Ye(t.durationMs,`durationMs`,0,12e4),o=W(r),s=P(await e.backend.longPress(M(e,t),o,{durationMs:i}));return await z(e,t,r,{...r,...i===void 0?{}:{durationMs:i},...s?{backendResult:s}:{},...T(`Long pressed (${o.x}, ${o.y})`)},n)},li=async(e,t)=>{let n=R(t),r=n.needsPreActionBaseline?null:await ui(e,t);if(r)return r;let i=await H(e,t,{action:`hover`,requireInteractive:!1,pipeline:O.resolvedTarget,captureEvidenceBaseline:n.needsPreActionBaseline,expectedResolvedTarget:t.expectedResolvedTarget});if(!e.backend.hover)throw new a(`UNSUPPORTED_OPERATION`,`hover is not supported by this backend`);let o=W(i),s=P(await e.backend.hover(M(e,t),o));return await z(e,t,i,{...i,...s?{backendResult:s}:{},...T(`Hovered (${o.x}, ${o.y})`)},n)};async function ui(e,t){if(t.target.kind!==`ref`||!e.backend.hoverTarget||t.expectedResolvedTarget)return null;let{hoverTarget:n}=e.backend;return await ri(e,t,t.target,`hover`,async(e,t)=>await n(e,t))}const di=async(e,t)=>{if(!e.backend.performGesture)throw new a(`UNSUPPORTED_OPERATION`,`gesture is not supported by this backend`);await Hr(e,t,`drag`);let n=await oi(e,t),r=await fi(e,t,`source`),i=await fi(e,t,`destination`),o=Ue({from:W(r),to:W(i),sourceHoldMs:t.gesture.sourceHoldMs,moveMs:t.gesture.moveMs,destinationHoldMs:t.gesture.destinationHoldMs},n),s=P(await e.backend.performGesture(M(e,t),o)),{start:c,end:l}=Ve(o);return{kind:`drag`,durationMs:o.durationMs,pointerCount:1,from:c,to:l,targets:{source:pi(r),destination:pi(i)},recording:mi(r,i),...s?{backendResult:s}:{},...T(`Dragged ${t.gesture.source} to ${t.gesture.destination}`)}};async function fi(e,t,n){let r=t.gesture[n];return await H(e,{...t,target:r.startsWith(`@`)?{kind:`ref`,ref:r}:{kind:`selector`,selector:r}},{action:`drag`,requireInteractive:!1,pipeline:O.resolvedTarget,expectedResolvedTarget:t.expectedResolvedTargets?.[n],replayTargetRole:n})}function pi(e){if(e.kind===`point`||!e.resolution)throw new a(`COMMAND_FAILED`,`gesture drag target resolution was not disclosed`);let t=`selectorChain`in e?e.selectorChain:void 0;return{...t?.length?{selectorChain:t}:{},resolution:e.resolution}}function mi(e,t){let n=hi(e),r=hi(t),i=gi(e),a=gi(t);return{...n?{sourceSelector:n}:{},...r?{destinationSelector:r}:{},...i?{sourceTarget:i}:{},...a?{destinationTarget:a}:{}}}function hi(e){return`selectorChain`in e&&e.selectorChain?.length?e.selectorChain.join(` || `):void 0}function gi(e){if(!(!(`selectorChain`in e)||!e.selectorChain?.length||!e.node||!e.preAction))return{selectorChain:e.selectorChain,node:e.node,preActionNodes:e.preAction.nodes}}function W(e){if(!e.point)throw new a(`COMMAND_FAILED`,`Interaction target resolved without coordinates`);return e.point}const _i=async(e,t)=>await bi(e,t,`press`),vi=async(e,t)=>await bi(e,t,`click`),yi=async(e,t)=>{if(typeof t.text!=`string`)throw new a(`INVALID_ARGS`,`fill requires text`);let n=R(t),r=n.needsPreActionBaseline?null:await Ci(e,t);if(r)return r;let i=await H(e,t,{action:`fill`,requireInteractive:!0,pipeline:O.resolvedTarget,captureEvidenceBaseline:n.needsPreActionBaseline,expectedResolvedTarget:t.expectedResolvedTarget,preresolvedTarget:t.preresolvedTarget});if(!e.backend.fill)throw new a(`UNSUPPORTED_OPERATION`,`fill is not supported by this backend`);let o=xi(i),s=`node`in i?i.node?.type??``:``,c=s!==``&&fe(s,e.backend.platform),l=t.allowNonHittableCoordinateFallback===!0&&`node`in i&&i.node?.hittable===!1,u=P(await e.backend.fill(M(e,t),o,t.text,{delayMs:t.delayMs,allowNonHittableCoordinateFallback:l})),d=s&&!c?`fill target ${Ti(i)} resolved to "${s}", attempting fill anyway.`:void 0;return await z(e,t,i,{...i,text:t.text,...d?{warning:d}:{},...u?{backendResult:u}:{}},n)};async function bi(e,t,n){let r=R(t),i=r.needsPreActionBaseline?null:await Si(e,t,n);if(i)return i;let o={action:n,requireInteractive:!0,pipeline:O.promotedTarget,captureEvidenceBaseline:r.needsPreActionBaseline,expectedResolvedTarget:t.expectedResolvedTarget,preresolvedTarget:t.preresolvedTarget},s=await H(e,t,o);if(!e.backend.tap)throw new a(`UNSUPPORTED_OPERATION`,`tap is not supported by this backend`);let c=await Wr(e,t,o,s),l=xi(c),u;try{u=await e.backend.tap(M(e,t),l,{button:t.button,count:t.count,intervalMs:t.intervalMs,holdMs:t.holdMs,jitterPx:t.jitterPx,doubleTap:t.doubleTap})}catch(e){throw vt(e,c),e}let d=P(u);return await z(e,t,c,{...c,...d?{backendResult:d}:{}},r)}function xi(e){if(!e.point)throw new a(`COMMAND_FAILED`,`Interaction target resolved without coordinates`);return e.point}async function Si(e,t,n){if(n!==`click`||t.target.kind!==`ref`||!e.backend.tapTarget||wi(t)||t.expectedResolvedTarget)return null;let{tapTarget:r}=e.backend;return await ri(e,t,t.target,n,async(e,t)=>await r(e,t))}async function Ci(e,t){if(t.target.kind!==`ref`||!e.backend.fillTarget||t.expectedResolvedTarget)return null;let{fillTarget:n}=e.backend;return{...await ri(e,t,t.target,`fill`,async(e,r)=>await n(e,r,t.text,{delayMs:t.delayMs})),text:t.text}}function wi(e){return e.count!==void 0||e.intervalMs!==void 0||e.holdMs!==void 0||e.jitterPx!==void 0||e.doubleTap!==void 0||e.button!==void 0&&e.button!==`primary`}function Ti(e){return e.target?.kind===`ref`?e.target.ref:e.target?.kind===`selector`?e.target.selector:`point`}function G(e){return{includeRects:e===`visible`||e===`hidden`,interactiveOnly:!1}}const Ei=O.wait.poll.defaultTimeoutMs;function Di(e,t,n,r,i={}){let a=Ze(r),o=n??a.defaultTimeoutMs,s=J(e),c=Hi(i.isUnreadableError),l=[],u={},d=()=>Math.max(0,o-(J(e)-s));return{capture:async n=>{let r=!1,i=J(e)-s,a=t=>l.push({startedMs:i,durationMs:J(e)-s-i,outcome:t}),o=await Jt(e,t,d(),async e=>await c.attempt(async()=>{let t=await n(e);return r=!0,t}));if(!o.timedOut)return r&&c.recordReadableCapture(),a(Oi(r,c.lastUnobservedCause())),o;let f=ki(o.error,c.readableCaptures());return a(f.outcome),u=f.evidence,{timedOut:!0,deadline:f.deadline}},hasTimeRemaining:()=>d()>0,failureEvidence:()=>({timeoutMs:o,readableCaptures:c.readableCaptures(),captures:l.length,polls:Ai(l),waitedMs:J(e)-s,...u}),preserveUnreadableOnStall:i.preserveUnreadableOnStall,neverReadableCause:c.neverReadableCause,sleepUntilNextPoll:async()=>await Ui(e,t,Math.min(a.intervalMs,d())),timeoutMs:o,waitedMs:()=>J(e)-s}}function Oi(e,t){return e?`readable`:t?.outcome??`unreadable`}function ki(e,t){let n=Bi(e);if(n)return{outcome:`runner-restart`,deadline:`runner-restart-exhausted`,evidence:n};let r=St(e instanceof a?e.details:void 0);return r?{outcome:`readiness`,deadline:`readiness-exhausted`,evidence:{readinessPhase:r}}:{outcome:`deadline`,deadline:t===0?`capture-stalled`:`capture-truncated`,evidence:{}}}function Ai(e){return e.length<=30?[...e]:[...e.slice(0,5),...e.slice(-25)]}function ji(e,t){return new a(`COMMAND_FAILED`,e,{reason:A.captureStalled,captureStalled:!0,...t,retriable:!0,hint:`No readable snapshot capture completed before the wait timeout. Retry, or use screenshot to inspect the current surface.`})}function Mi(e,t){return new a(`COMMAND_FAILED`,e,{reason:A.runnerRestartExhausted,waitRunnerRestartExhausted:!0,...t,retriable:!0,hint:`An iOS runner restart consumed the wait timeout before a readable snapshot completed. Inspect the diagnostics log for the runner invalidation/restart sequence, then retry.`})}function Ni(e,t){return new a(`COMMAND_FAILED`,e,{reason:A.readinessExhausted,...t,retriable:!0,hint:`The wait timeout ended during readiness work (${t.readinessPhase}), before that poll could capture the screen. Retry with a timeout long enough to cover it.`})}function Pi(e,t){return new a(`COMMAND_FAILED`,e,{reason:A.deadlineExceeded,captureTruncated:!0,...t})}function Fi(e,t){return new a(`COMMAND_FAILED`,e,{reason:A.targetAbsent,...t})}function Ii(e,t,n){let r=e.neverReadableCause();if(r!==void 0){if(r.outcome===`retriable`)throw Li(r.error,t);if(n)throw r.error}}function Li(e,t){let n=c(e);return new a(n.code,n.message,{reason:A.captureStalled,...n.details,...t},n)}function K(e,t,n){let r=t.failureEvidence();switch(n){case`runner-restart-exhausted`:return Mi(e,r);case`readiness-exhausted`:return Ii(t,r,!1),Ni(e,r);case`capture-stalled`:return Ii(t,r,t.preserveUnreadableOnStall===!0),ji(e,r);case`capture-truncated`:return Pi(e,r);case void 0:return Ii(t,r,!0),r.readableCaptures===0?ji(e,r):Fi(e,r);default:return zi(n)}}function Ri(e){return e===`runner-restart-exhausted`||e===`readiness-exhausted`}function zi(e){throw Error(`Unhandled wait deadline: ${String(e)}`)}function Bi(e){if(!(e instanceof a))return;let t=e.details;if(t?.runnerRestarted===!0)return{runnerRestarted:!0,...q(t,`runnerRestartReason`),...q(t,`runnerRestartCommand`),...q(t,`runnerRestartCommandId`),...q(t,`runnerInvalidatedSessionId`),...q(t,`runnerRestartSessionId`),...q(t,`logPath`),...q(t,`diagnosticId`)}}function q(e,t){let n=e?.[t];return typeof n==`string`?{[t]:n}:{}}function Vi(e){return e instanceof a&&e.details?.retriable===!0}function Hi(e=Fe){let t=0,n;return{attempt:async t=>{try{return await t()}catch(t){if(e(t))n={outcome:`unreadable`,error:t};else if(Vi(t))n={outcome:`retriable`,error:t};else throw t;return}},lastUnobservedCause:()=>n,recordReadableCapture:()=>{t+=1},readableCaptures:()=>t,neverReadableCause:()=>t===0?n:void 0}}function J(e){return e.clock?.now()??Date.now()}async function Ui(e,t,n){let r=[t.signal,e.signal].filter(e=>e!==void 0);for(let e of r)e.throwIfAborted();if(n<=0)return!1;if(e.clock){await e.clock.sleep(n);for(let e of r)e.throwIfAborted();return!0}return await new Promise((e,t)=>{let i=r.length>0?AbortSignal.any(r):void 0,a=()=>i?.removeEventListener(`abort`,s),o=setTimeout(()=>{a(),e()},n),s=()=>{clearTimeout(o),a(),t(i?.reason)};i?.addEventListener(`abort`,s,{once:!0}),o.unref()}),!0}async function Wi(e,t,n){let r=await D(O.readAny,e.nodes,t,{platform:n}),i=r.kind===`target`||r.kind===`ambiguous`?r.matchedNodes:r.kind===`occluded`?[r.node]:[];return{selector:r.kind===`target`||r.kind===`ambiguous`?r.selector:t,observation:y(e,i)}}async function Gi(e,t,n){let r=await Wi(e,t,n),i=r.observation;if(i.kind!==`absent`)throw Me(r.selector,i);return{predicate:`absent`,pass:!0,selector:t,matches:i.matches}}async function Ki(e,t,n,r,i){let a=g(n);if(a)throw Pe(a,`wait`);let o=Di(t,n,i,O.wait,{isUnreadableError:Ji,preserveUnreadableOnStall:!0}),s=G(),c,l;for(;o.hasTimeRemaining();){let i=await o.capture(async i=>{try{let{observation:a}=await Wi((await e.captureSnapshot(t,{...n,signal:i},{updateSession:!0,includeHiddenContentHints:!1,...s})).snapshot,r,t.backend.platform);if(_(a.kind))throw Me(r,a,`wait`);return a}catch(e){throw Fe(e)?Ne(r,e,`wait`):e}});if(i.timedOut){l=i.deadline;break}let a=i.value;if(a?.kind===`absent`)return{kind:`absent`,waitedMs:o.waitedMs()};a?.kind===`present`&&(c=a),await o.sleepUntilNextPoll()}throw Ri(l)?K(`wait absent timed out for selector: ${r}`,o,l):c?qi(r,c,o.failureEvidence()):K(`wait absent timed out for selector: ${r}`,o,l)}function qi(e,t,n){let r=t.matches!==1;return new a(`COMMAND_FAILED`,`wait absent timed out for selector ${e}: ${t.matches} match${r?`es`:``} remain`,{reason:A.targetPresent,selector:e,...n,matches:t.matches,firstMatch:t.firstMatch})}function Ji(e){if(!(e instanceof a))return!1;let t=e.details;return t?.command===`wait`&&t.predicate===`absent`&&(_(t.observation)||t.observation===`unreadable`)}function Yi(e){if(e.kind===`ambiguous`||e.kind===`target`)return{selector:e.selector,selectorIndex:e.selectorIndex,matchedNodes:e.matchedNodes}}async function Xi(e,t,n,r,i,o){let s=Di(t,n,i,O.wait),c=G(),l,u;for(;s.hasTimeRemaining();){let i=await s.capture(async r=>await e.captureSnapshot(t,{...n,signal:r},{updateSession:!0,includeHiddenContentHints:!1,...c}));if(i.timedOut){u=i.deadline;break}let a=i.value;if(a){let e=a.snapshot.nodes,n=Yi(await D(O.wait,e,r,{platform:t.backend.platform}));if(n){let t=Zi(e,n,o);if(t.kind===`satisfied`)return{kind:`selector`,selector:n.selector,waitedMs:s.waitedMs(),node:t.node,preActionNodes:e};l=t.evidence}}await s.sleepUntilNextPoll()}throw u!==`capture-stalled`&&l?new a(`COMMAND_FAILED`,`wait matched selector ${r} but no candidate carried the recorded landmark identity`,{reason:Ct,...s.failureEvidence(),...l}):K(`wait timed out for selector: ${r}`,s,u)}function Zi(e,t,n){let r=t.matchedNodes[0];if(!n)return{kind:`satisfied`,node:r};let i=Ee(e),a=De(t.matchedNodes,i,ye(n),n.ancestry)[0];return a?{kind:`satisfied`,node:a}:{kind:`identity-mismatch`,evidence:{matchCount:t.matchedNodes.length,observed:w(r),observedAncestry:Oe(r,i,Math.max(n.ancestry.length,1)).chain}}}async function Qi(e,t,n,r,i){let o=i??Ei,s=r??e.stable.defaultQuietMs,c=await e.stable.capture(t,n,{quietMs:s,timeoutMs:o});if(c.failure)throw c.failure.error;if(!c.settled)throw new a(`COMMAND_FAILED`,`wait timed out waiting for a stable UI`,{reason:A.stableTimeout,...c.stalled?{captureStalled:!0}:{},quietMs:s,timeoutMs:o,captures:c.captures,nodeCount:c.nodeCount,...c.stalled?{hint:`A snapshot capture stalled past the wait timeout, so no settle verdict is available. The UI may still be readable: retry, or use screenshot to inspect the surface.`}:{}});return{kind:`stable`,waitedMs:c.waitedMs,captures:c.captures,nodeCount:c.nodeCount,...c.nodeCount<e.stable.tinyTreeNodeCount?{hint:e.stable.tinyTreeHint}:{}}}async function $i(e,t,n,r,i){let a=Di(t,n,i,O.wait),o;for(;a.hasTimeRemaining();){let i=await a.capture(async i=>await ea(e,t,{...n,signal:i},r));if(i.timedOut){o=i.deadline;break}if(i.value)return{kind:`text`,text:r,waitedMs:a.waitedMs()};await a.sleepUntilNextPoll()}throw K(`wait timed out for text: ${r}`,a,o)}async function ea(e,t,n,r){return t.backend.findText&&(await t.backend.findText(na(t,n),r)).found?!0:await ta(e,t,n,r)}async function ta(e,t,n,r){let i=await e.captureSnapshot(t,n,{updateSession:!0,includeHiddenContentHints:!1});return!!ct(i.snapshot.nodes,r)}function na(e,t){return{session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata}}function ra(e){let t=async(t,n)=>{switch(n.target.kind){case`sleep`:return await Ui(t,n,n.target.durationMs),{kind:`sleep`,waitedMs:n.target.durationMs};case`ref`:return await ia(e,t,n,n.target.ref,n.target.timeoutMs);case`selector`:return await Xi(e,t,n,n.target.selector,n.target.timeoutMs,n.target.recordedLandmark);case`absent`:return await Ki(e,t,n,n.target.selector,n.target.timeoutMs);case`stable`:return await Qi(e,t,n,n.target.quietMs,n.target.timeoutMs);case`text`:return await aa(e,t,n,n.target.text,n.target.timeoutMs);default:return oa(n.target)}};return{waitCommand:t,waitForTextCommand:async(e,n)=>{let r=await t(e,{...n,target:{kind:`text`,text:n.text,timeoutMs:n.timeoutMs}});if(r.kind!==`text`)throw new a(`COMMAND_FAILED`,`waitForText returned non-text result`);return r}}}async function ia(e,t,n,r,i){let s=await e.requireSnapshot(t,n.session),c=u(r);if(!c)throw new a(`INVALID_ARGS`,`Invalid ref: ${r}`);let l=o(s.snapshot.nodes,c);if(!l)throw new a(`COMMAND_FAILED`,`Ref ${r} not found`,{reason:E.refNotFound,ref:c,hint:ce});let d=lt(l,s.snapshot.nodes);if(!d)throw new a(`COMMAND_FAILED`,`Ref ${r} has no label to wait for`,{reason:E.refUnlabeled,ref:c});return await $i(e,t,n,d,i)}async function aa(e,t,n,r,i){let o=re(r);if(!o.ok)throw new a(o.code,o.message);return await $i(e,t,n,o.text,i)}function oa(e){throw Error(`Unsupported wait target: ${String(e)}`)}const sa=ra({captureSnapshot:L,requireSnapshot:Ht,stable:{defaultQuietMs:500,tinyTreeHint:on,tinyTreeNodeCount:5,capture:sn}}),ca=sa.waitCommand,la=sa.waitForTextCommand,ua=async(e,t)=>{let n=t.locator??`any`;if(!t.query)throw new a(`INVALID_ARGS`,oe);if(t.action===`wait`)return await ma(e,t,n);if(t.action===`list`)return await ha(e,t,n);let{capture:r,match:i}=await _a(e,t,n);if(!i)throw new a(`COMMAND_FAILED`,`find did not match any element`);if(t.action===`exists`)return{kind:`found`,found:!0};if(t.action===`get_attrs`)return{kind:`attrs`,...ga(i),node:i};let o=await Ut(e,r,i);return{kind:`text`,...ga(i),text:o,node:i}},da=async(e,t)=>{if(t.target.kind===`ref`){let n=await Ht(e,t.session),r=Wt(n.snapshot.nodes,t.target.ref,{fallbackLabel:t.target.fallbackLabel??``,invalidRefMessage:`get text requires a ref like @e2`,notFoundMessage:`Ref ${t.target.ref} not found`});B(r.node,n.snapshot.nodes,t.expectedResolvedTarget,`get`);let i=he(r.node,e.backend.platform,{action:`get`,nodes:n.snapshot.nodes}),a={kind:`ref`,ref:`@${r.ref}`},o=n.snapshot.nodes;return t.property===`attrs`?{kind:`attrs`,target:a,node:r.node,selectorChain:i,preActionNodes:o}:{kind:`text`,target:a,text:await Ut(e,n,r.node),node:r.node,selectorChain:i,preActionNodes:o}}let n=await va(e,t,t.session??`default`,{selector:t.target.selector,policy:t.property===`text`?O.readText:O.readUnique,hooks:{onResolved:(e,n)=>B(e,n,t.expectedResolvedTarget,`get`)}}),r=he(n.node,e.backend.platform,{action:`get`,nodes:n.capture.snapshot.nodes});if(t.property===`attrs`)return{kind:`attrs`,target:{kind:`selector`,selector:n.selector},node:n.node,selectorChain:r,preActionNodes:n.capture.snapshot.nodes};let i=await Ut(e,n.capture,n.node);return{kind:`text`,target:{kind:`selector`,selector:n.selector},text:i,node:n.node,selectorChain:r,preActionNodes:n.capture.snapshot.nodes}},fa=async(e,t)=>{let n=await da(e,{...t,property:`text`,target:t.target});if(n.kind!==`text`)throw new a(`COMMAND_FAILED`,`getText returned non-text result`);return n},pa=async(e,t)=>{let n=await da(e,{...t,property:`attrs`,target:t.target});if(n.kind!==`attrs`)throw new a(`COMMAND_FAILED`,`getAttrs returned non-attrs result`);return n};async function ma(e,t,n){let r=Di(e,t,t.timeoutMs,O.findWait),i;for(;r.hasTimeRemaining();){let a=await r.capture(async r=>await _a(e,{...t,signal:r},n,{includeHiddenContentHints:!1}));if(a.timedOut){i=a.deadline;break}if(a.value?.match)return{kind:`found`,found:!0,waitedMs:r.waitedMs()};await r.sleepUntilNextPoll()}throw K(`find wait timed out`,r,i)}async function ha(e,t,n){let r=S(n,t.query),i=await L(e,t,{updateSession:!0,...G()});if(dt(i.snapshot.snapshotQuality))throw Vt(i.snapshot.snapshotQuality);return{kind:`list`,matches:(r?Xe(O.readList,i.snapshot.nodes,r,{platform:e.backend.platform}).list?.matchedNodes??[]:de(i.snapshot.nodes,n,t.query,{}).matches).map(e=>({...ga(e),node:e}))}}function ga(e){return e.ref===void 0?{}:{ref:`@${e.ref}`}}async function _a(e,t,n,r){let i=S(n,t.query),a=await L(e,t,{updateSession:!0,scope:Bt(e.backend.platform,n,t.query,i),includeHiddenContentHints:r?.includeHiddenContentHints,...G()});if(dt(a.snapshot.snapshotQuality))throw Vt(a.snapshot.snapshotQuality);if(i){let t=await D(O.readAny,a.snapshot.nodes,i,{platform:e.backend.platform});return{capture:a,match:t.kind===`target`?t.node:void 0}}return{capture:a,match:de(a.snapshot.nodes,n,t.query,{requireRect:!1}).matches[0]}}async function va(e,t,n,r){let i=await L(e,{...t,session:n},{updateSession:!0,...G()}),a=await D(r.policy,i.snapshot.nodes,r.selector,{platform:e.backend.platform},r.hooks);if(a.kind!==`target`)throw qt({outcome:a,selectorExpression:r.selector,command:`get`});return{capture:i,node:a.node,selector:a.selector,...ga(a.node)}}const ya=async(e,t)=>{let n=_e(t.predicate);if(!n.ok)throw new a(n.code,n.message,{hint:n.hint});let r=n.predicate;if(r===`absent`){let e=g(t);if(e)throw Pe(e)}if(r===`text`&&!t.expectedText)throw new a(`INVALID_ARGS`,le);let i=t.selector,o=await ba(e,t,r,i);return r===`exists`?await xa(e,o,i):r===`absent`?await Gi(o.snapshot,i,e.backend.platform):await Sa(e,t,o,r,i)};async function ba(e,t,n,r){try{return await L(e,t,{updateSession:!0,...G(n)})}catch(e){throw n!==`absent`||i(e)?e:Ne(r,e)}}async function xa(e,t,n){let r=await D(O.readAny,t.snapshot.nodes,n,{platform:e.backend.platform});if(r.kind!==`target`)throw new a(`COMMAND_FAILED`,ie(n,[],{unique:!1}),{hint:ue([])});return{predicate:`exists`,pass:!0,selector:r.selector,matches:r.matches,selectorChain:ae(n)}}async function Sa(e,t,n,r,i){let o=await D(O.readUnique,n.snapshot.nodes,i,{platform:e.backend.platform},{onResolved:(e,n)=>B(e,n,t.expectedResolvedTarget,`is`)});if(o.kind!==`target`)throw qt({outcome:o,selectorExpression:i,command:`is`,details:{predicate:r,selector:i}});let s=se({predicate:r,node:o.node,visibility:C(n.snapshot.nodes),expectedText:t.expectedText,platform:e.backend.platform});if(!s.pass)throw new a(`COMMAND_FAILED`,`is ${r} failed for selector ${o.selector}: ${s.details}`,{command:`is`,reason:E.predicateFailed,predicate:r,selector:o.selector,predicateDetails:s.details});return{predicate:r,pass:!0,selector:o.selector,...r===`text`?{text:s.actualText}:{},selectorChain:ae(i),node:o.node,preActionNodes:n.snapshot.nodes}}const Ca=async(e,t)=>await ya(e,{...t,predicate:`visible`,selector:t.target.selector}),wa=async(e,t)=>await ya(e,{...t,predicate:`hidden`,selector:t.target.selector}),Ta=async(e,t)=>{if(!e.backend.performGesture)throw new a(`UNSUPPORTED_OPERATION`,`gesture is not supported by this backend`);await Hr(e,t,t.gesture.intent);let n=e.backend.performGesture,r=He(t.gesture,await oi(e,t),e.backend.platform),i=P(await n(M(e,t),r)),o=Da(r.pointers,0),s=Da(r.pointers,-1);return{kind:t.gesture.intent,durationMs:r.durationMs,pointerCount:r.pointers.length,from:o,to:s,...i?{backendResult:i}:{},...T(Oa(t.gesture,o,s))}},Ea=async(e,t)=>{let n=t.gesture;return n.intent===`drag`?await di(e,{...t,gesture:n}):await Ta(e,{...t,gesture:n})};function Da(e,t){let n=e.map(e=>t===0?e.samples[0]?.point:e.samples.at(-1)?.point);if(n.some(e=>e===void 0))throw new a(`COMMAND_FAILED`,`Gesture plan did not contain endpoint samples.`);let r=n;return{x:r.reduce((e,t)=>e+t.x,0)/r.length,y:r.reduce((e,t)=>e+t.y,0)/r.length}}function Oa(e,t,n){switch(e.intent){case`pan`:{let r=`preset`in e?t:e.origin,i=`preset`in e?{x:n.x-t.x,y:n.y-t.y}:e.delta;return`Panned (${r.x}, ${r.y}) by (${i.x}, ${i.y})`}case`fling`:return`direction`in e?`Flung ${e.direction}`:`Flung`;case`pinch`:return`Pinched to scale ${e.scale}`;case`rotate`:return`Rotated gesture ${e.degrees} degrees`;case`transform`:return`Requested transform gesture by (${e.delta.x}, ${e.delta.y}), scale ${e.scale}, rotate ${e.degrees} degrees`;case`tap`:return`Tapped ${e.points.length} points`}}const Y={find:ua,get:da,getText:fa,getAttrs:pa,is:ya,isVisible:Ca,isHidden:wa,wait:ca,waitForText:la},X={click:vi,press:_i,fill:yi,focus:si,longPress:ci,hover:li,gesture:Ea,settleObservation:Cn};function ka(e){return{find:t=>Y.find(e,t),get:t=>Y.get(e,t),getText:(t,n={})=>Y.getText(e,{...n,target:t}),getAttrs:(t,n={})=>Y.getAttrs(e,{...n,target:t}),is:t=>Y.is(e,t),isVisible:(t,n={})=>Y.isVisible(e,{...n,target:t}),isHidden:(t,n={})=>Y.isHidden(e,{...n,target:t}),wait:t=>Y.wait(e,t),waitForText:(t,n={})=>Y.waitForText(e,{...n,text:t})}}function Aa(e){return{click:(t,n={})=>X.click(e,{...n,target:t}),press:(t,n={})=>X.press(e,{...n,target:t}),fill:(t,n,r={})=>X.fill(e,{...r,target:t,text:n}),focus:(t,n={})=>X.focus(e,{...n,target:t}),longPress:(t,n={})=>X.longPress(e,{...n,target:t}),hover:(t,n={})=>X.hover(e,{...n,target:t}),gesture:t=>X.gesture(e,t),settleObservation:t=>X.settleObservation(e,t)}}const ja=[0,187,255,255];function Ma(e,t){for(let n of t)n.rect.width<4||n.rect.height<4||Na(e,n.rect)}function Na(e,t){let n=Pa(t);if(n==null)return;let r=Ia(n.x,0,e.width-1),i=Ia(n.y,0,e.height-1),a=Ia(n.right,0,e.width-1),o=Ia(n.bottom,0,e.height-1);for(let t=0;t<2;t+=1){for(let n=r;n<=a;n+=1)Fa(e,n,i+t,ja),Fa(e,n,o-t,ja);for(let n=i;n<=o;n+=1)Fa(e,r+t,n,ja),Fa(e,a-t,n,ja)}}function Pa(e){let t=e.x+e.width-1,n=e.y+e.height-1;return[e.x,e.y,e.width,e.height,t,n].every(Number.isFinite)?{x:e.x,y:e.y,right:t,bottom:n}:null}function Fa(e,t,n,r){if(t<0||t>=e.width||n<0||n>=e.height)return;let i=(n*e.width+t)*4;e.data[i]=r[0],e.data[i+1]=r[1],e.data[i+2]=r[2],e.data[i+3]=r[3]}function Ia(e,t,n){return Number.isFinite(e)?Math.min(Math.max(e,t),n):t}const La=[{x:-1,y:-1},{x:0,y:-1},{x:1,y:-1},{x:-1,y:0},{x:1,y:0},{x:-1,y:1},{x:0,y:1},{x:1,y:1}];function Ra(e){let{mask:t,width:n,height:r,hooks:i}=e,a=new Uint8Array(t.length),o=new Int32Array(t.length),s=[];for(let e=0;e<t.length;e+=1){if(!Va(t,a,e))continue;let c=0,l=Ba(o,a,0,e),u=i.create(e);for(;c<l;){let e=o[c];c+=1,i.visit(u,e),l=za({mask:t,visited:a,queue:o,queueEnd:l,width:n,height:r,pixelIndex:e})}s.push(u)}return s}function za(e){let{mask:t,visited:n,queue:r,width:i,height:a,pixelIndex:o}=e,s=o%i,c=Math.floor(o/i),l=e.queueEnd;for(let e of La){let o=s+e.x,u=c+e.y;if(!Ha(o,u,i,a))continue;let d=u*i+o;Va(t,n,d)&&(l=Ba(r,n,l,d))}return l}function Ba(e,t,n,r){return t[r]=1,e[n]=r,n+1}function Va(e,t,n){return e[n]===1&&t[n]!==1}function Ha(e,t,n,r){return e>=0&&e<n&&t>=0&&t<r}function Ua(e,t){return e.flatMap(e=>Wa(e,t.baseline.width,t.baseline.height)?Ga(e,t,Za(t.baseline.height)):[e])}function Wa(e,t,n){let r=e.maxX-e.minX+1;return e.maxY-e.minY+1>=Xa(n)&&r>=t*.35}function Ga(e,t,n){let r=Ya(e,Ja(qa(Ka(e,t.diffMask,t.baseline.width)),Math.max(1,Math.round((e.maxX-e.minX+1)*.08))),n);if(r.length<=1)return[e];let i=r.map(([n,r])=>Qa(e,n,r,t)).filter(e=>e!==null);return i.length>1?i:[e]}function Ka(e,t,n){let r=[];for(let i=e.minY;i<=e.maxY;i+=1){let a=0;for(let r=e.minX;r<=e.maxX;r+=1)t[i*n+r]===1&&(a+=1);r.push(a)}return r}function qa(e){return e.map((t,n)=>{let r=0,i=0,a=Math.max(0,n-3),o=Math.min(e.length-1,n+3);for(let t=a;t<=o;t+=1)r+=e[t],i+=1;return Math.round(r/i)})}function Ja(e,t){let n=[],r=null;for(let i=0;i<e.length;i+=1){if(e[i]<=t){r??=i;continue}r!==null&&(i-r>=6&&n.push([r,i-1]),r=null)}return r!==null&&e.length-r>=6&&n.push([r,e.length-1]),n}function Ya(e,t,n){let r=[],i=e.minY;for(let[a,o]of t){let t=e.minY+Math.round((a+o)/2);t-i+1<n||e.maxY-t<n||(r.push([i,t]),i=t+1)}return r.push([i,e.maxY]),r}function Xa(e){return Math.max(48,Math.round(e*.07))}function Za(e){return Math.max(24,Math.round(e*.03))}function Qa(e,t,n,r){let i=null;for(let a=t;a<=n;a+=1)for(let t=e.minX;t<=e.maxX;t+=1){let e=a*r.baseline.width+t;r.diffMask[e]===1&&(i??=$a(t,a),eo(i,e,t,a,r.baseline,r.current))}return i}function $a(e,t){return{minX:e,minY:t,maxX:e,maxY:t,differentPixels:0,baselineRed:0,baselineGreen:0,baselineBlue:0,currentRed:0,currentGreen:0,currentBlue:0}}function eo(e,t,n,r,i,a){let o=t*4;e.minX=Math.min(e.minX,n),e.minY=Math.min(e.minY,r),e.maxX=Math.max(e.maxX,n),e.maxY=Math.max(e.maxY,r),e.differentPixels+=1,e.baselineRed+=i.data[o],e.baselineGreen+=i.data[o+1],e.baselineBlue+=i.data[o+2],e.currentRed+=a.data[o],e.currentGreen+=a.data[o+1],e.currentBlue+=a.data[o+2]}const to=2.5;function no(e){let t=ro(e);return Ua(t.length<=2e3?oo(t,12):t,e).sort((e,t)=>{let n=t.differentPixels-e.differentPixels;if(n!==0)return n;let r=e.minY-t.minY;return r===0?e.minX-t.minX:r}).slice(0,8).map((t,n)=>lo(t,n+1,{width:e.baseline.width,height:e.baseline.height,totalPixels:e.totalPixels,differentPixels:e.differentPixels}))}function ro(e){let{diffMask:t,baseline:n,current:r}=e,{width:i,height:a}=n;return Ra({mask:t,width:i,height:a,hooks:{create:e=>io(e,i),visit:(e,t)=>ao(e,t,i,n,r)}})}function io(e,t){let n=e%t,r=Math.floor(e/t);return{minX:n,minY:r,maxX:n,maxY:r,differentPixels:0,baselineRed:0,baselineGreen:0,baselineBlue:0,currentRed:0,currentGreen:0,currentBlue:0}}function ao(e,t,n,r,i){let a=t%n,o=Math.floor(t/n),s=t*4;e.minX=Math.min(e.minX,a),e.minY=Math.min(e.minY,o),e.maxX=Math.max(e.maxX,a),e.maxY=Math.max(e.maxY,o),e.differentPixels+=1,e.baselineRed+=r.data[s],e.baselineGreen+=r.data[s+1],e.baselineBlue+=r.data[s+2],e.currentRed+=i.data[s],e.currentGreen+=i.data[s+1],e.currentBlue+=i.data[s+2]}function oo(e,t){let n=[];for(let r of e.sort((e,t)=>{let n=e.minY-t.minY;return n===0?e.minX-t.minX:n})){let e=n.find(e=>so(e,r,t));if(!e){n.push({...r});continue}co(e,r)}return n}function so(e,t,n){return e.minX-n<=t.maxX&&t.minX-n<=e.maxX&&e.minY-n<=t.maxY&&t.minY-n<=e.maxY}function co(e,t){e.minX=Math.min(e.minX,t.minX),e.minY=Math.min(e.minY,t.minY),e.maxX=Math.max(e.maxX,t.maxX),e.maxY=Math.max(e.maxY,t.maxY),e.differentPixels+=t.differentPixels,e.baselineRed+=t.baselineRed,e.baselineGreen+=t.baselineGreen,e.baselineBlue+=t.baselineBlue,e.currentRed+=t.currentRed,e.currentGreen+=t.currentGreen,e.currentBlue+=t.currentBlue}function lo(e,t,n){let r={x:e.minX,y:e.minY,width:e.maxX-e.minX+1,height:e.maxY-e.minY+1},i={x:Math.round(e.minX+r.width/2),y:Math.round(e.minY+r.height/2)},a=uo(e.baselineRed,e.baselineGreen,e.baselineBlue,e.differentPixels),o=uo(e.currentRed,e.currentGreen,e.currentBlue,e.differentPixels),s=r.width*r.height;return{index:t,rect:r,normalizedRect:qe({x:Z(r.x/n.width),y:Z(r.y/n.height),width:Z(r.width/n.width),height:Z(r.height/n.height)}),differentPixels:e.differentPixels,shareOfDiffPercentage:Z(e.differentPixels/n.differentPixels),densityPercentage:Z(e.differentPixels/s),shape:mo(r,n.width,n.height),size:ho(s,n.totalPixels),location:fo(i,n.width,n.height),averageBaselineColorHex:_o(a),averageCurrentColorHex:_o(o),baselineLuminance:Math.round(go(a)),currentLuminance:Math.round(go(o)),dominantChange:po(a,o)}}function uo(e,t,n,r){return{r:Math.round(e/r),g:Math.round(t/r),b:Math.round(n/r)}}function fo(e,t,n){let r=e.x<t/3?`left`:e.x>t*2/3?`right`:`center`,i=e.y<n/3?`top`:e.y>n*2/3?`bottom`:`middle`;return r===`center`&&i===`middle`?`center`:`${i}-${r}`}function po(e,t){let n=go(t)-go(e);return Math.abs(n)>=12?n>0?`brighter`:`darker`:Math.max(Math.abs(t.r-e.r),Math.abs(t.g-e.g),Math.abs(t.b-e.b))>=12?`color-shift`:`mixed`}function mo(e,t,n){return e.width>=t*.55&&e.height>=n*.12?`large-area`:e.width>=e.height*to?`horizontal-band`:e.height>=e.width*to?`vertical-band`:`compact`}function ho(e,t){let n=e/t;return n>=.04?`large`:n>=.01?`medium`:`small`}function go(e){return e.r*.2126+e.g*.7152+e.b*.0722}function _o(e){return`#${vo(e.r)}${vo(e.g)}${vo(e.b)}`}function vo(e){return e.toString(16).padStart(2,`0`)}function Z(e){return Math.round(e*100*100)/100}const yo=Math.sqrt(3*255**2);async function bo(e,t,n={}){await xo(e,`Baseline image not found`),await xo(t,`Current screenshot not found`);let r=n.outputPath,[i,a]=await Promise.all([j.readFile(e),j.readFile(t)]),[o,s]=await Promise.all([nt(i,`baseline screenshot`,n.maxPixels),nt(a,`current screenshot`,n.maxPixels)]),c=So(o,s),l=c?.compared??o,{validateScreenshotPixels:u}=await import(`./screenshot-image-size.js`);u(l.width,l.height,`comparison canvas`,n.maxPixels);let d=s;if(c&&s.width!==o.width){let{resizePngBox:e}=await import(`./png-resize.js`).then(e=>e.t);d=e(s,c.scaledCurrent.width,c.scaledCurrent.height)}let f=Co(o,l.height),p=Co(d,l.height),m=Math.min(o.height,d.height),ee=n.threshold??.1,h=l.width*l.height,g=ee*yo,{diffData:_,diffMask:te,differentPixels:v}=await rt({baselineData:f.data,currentData:p.data,width:l.width,height:l.height,overlapHeight:m,maxColorDistance:g}),y=v>0?no({diffMask:te,baseline:f,current:p,totalPixels:h,differentPixels:v}):[];if(v>0&&r){let e=new at.PNG({width:l.width,height:l.height});e.data=_,Ma(e,y),await j.mkdir(Et.dirname(r),{recursive:!0}),await j.writeFile(r,await it(e))}else await wo(n.outputPath);let b=h>0?Math.round(v/h*100*100)/100:0;return{...v>0&&r?{diffPath:r}:{},...y.length>0?{regions:y}:{},...c?{normalization:c}:{},totalPixels:h,differentPixels:v,mismatchPercentage:b,match:v===0}}async function xo(e,t){try{await j.access(e)}catch{throw new a(`INVALID_ARGS`,`${t}: ${e}`)}}function So(e,t){if(e.width===t.width&&e.height===t.height)return;let n=Math.max(1,Math.round(t.height*(e.width/t.width)));return{baseline:{width:e.width,height:e.height},current:{width:t.width,height:t.height},scaledCurrent:{width:e.width,height:n},compared:{width:e.width,height:Math.max(e.height,n)},currentScale:{x:e.width/t.width,y:n/t.height},alignment:`top-left`,coordinateSpace:`comparison-pixels`}}function Co(e,t){if(e.height===t)return e;let n=new at.PNG({width:e.width,height:t});return e.data.copy(n.data),n}async function wo(e){if(e)try{await j.unlink(e)}catch(e){if(!To(e,`ENOENT`))throw e}}function To(e,t){return typeof e==`object`&&!!e&&`code`in e&&e.code===t}function Eo(e,t,n={x:1,y:1}){let r=t.map(e=>({...e,overlayRect:{x:e.overlayRect.x*n.x,y:e.overlayRect.y*n.y,width:e.overlayRect.width*n.x,height:e.overlayRect.height*n.y}}));return e.map(e=>{let t=Do(e,r);return t.length>0?{...e,currentOverlayMatches:t}:e})}function Do(e,t){let n=ge(e.rect);return t.map(t=>{let r=t.overlayRect,i=Ke(e.rect,r);return i<=0?null:{ref:t.ref,...t.label?{label:t.label}:{},rect:r,overlayCoveragePercentage:Oo(i/ge(r)),regionCoveragePercentage:Oo(i/n)}}).filter(e=>e!==null).sort((e,t)=>{let n=t.regionCoveragePercentage-e.regionCoveragePercentage;return n===0?t.overlayCoveragePercentage-e.overlayCoveragePercentage:n}).slice(0,3).map(e=>({ref:e.ref,...e.label?{label:e.label}:{},rect:e.rect,regionCoveragePercentage:e.regionCoveragePercentage}))}function Oo(e){return Math.round(e*100*100)/100}async function ko(e,t,n){if(t.kind===`path`&&!e.policy.allowLocalInputPaths)throw new a(`INVALID_ARGS`,`Local ${n.field??`input`} paths are not allowed by command policy`);try{return await e.artifacts.resolveInput(t,n)}catch(e){throw c(e)}}async function Ao(e,t,n){if(t?.kind===`path`&&!e.policy.allowLocalOutputPaths)throw new a(`INVALID_ARGS`,`Local output paths are not allowed by command policy`);try{return await e.artifacts.reserveOutput(t,{...n,visibility:n.visibility??`client-visible`,requestedClientPath:t?.kind===`downloadableArtifact`?t.clientPath??n.requestedClientPath:n.requestedClientPath})}catch(e){throw c(e)}}async function jo(e,t){try{return await e.artifacts.createTempFile(t)}catch(e){throw c(e)}}const Mo=async(e,t)=>{if(!t.baseline)throw new a(`INVALID_ARGS`,`diff screenshot requires a baseline image`);let n=No(t.threshold),r=t.current??{kind:`live`};if(t.overlayRefs&&!Bo(r))throw new a(`INVALID_ARGS`,`diff screenshot <current.png> cannot use --overlay-refs because saved-image comparisons have no live accessibility refs`);let i=await ko(e,t.baseline,{usage:`diff screenshot baseline`,field:`baseline`}),o,s,c,l=[];try{let a;Bo(r)?(s=await Po(e,t),a=s.path):(o=await ko(e,r,{usage:`diff screenshot current`,field:`current`}),a=o.path),c=t.out?await Ao(e,t.out,{field:`diffPath`,ext:`.png`,artifactType:`screenshot-diff`}):void 0;let u=await bo(i.path,a,{threshold:n,outputPath:c?.path,maxPixels:e.policy.maxImagePixels});Bo(r)&&(u=await Fo(e,t,c?.path,u,l));let d=u.diffPath?await c?.publish():void 0;return d&&l.push(d),u.diffPath||await c?.cleanup?.(),{...u,...l.length>0?{artifacts:l}:{}}}catch(e){throw await c?.cleanup?.(),e}finally{await i.cleanup?.(),await o?.cleanup?.(),await s?.cleanup?.()}};function No(e){if(e==null||e===``)return .1;let t=Number(e);if(Number.isNaN(t)||t<0||t>1)throw new a(`INVALID_ARGS`,`--threshold must be a number between 0 and 1`);return t}async function Po(e,t){let n=await jo(e,{prefix:`agent-device-diff-current`,ext:`.png`});try{await Io(e,t,n.path,Lo(t))}catch(e){throw await n.cleanup(),e}return n}async function Fo(e,t,n,r,i){if(!t.overlayRefs)return r;if(r.match)return n&&await zo(n),r;let a=await Ao(e,Ro(t,n),{field:`currentOverlayPath`,ext:`.png`,artifactType:`screenshot`});try{let n=await Io(e,t,a.path,{overlayRefs:!0,...Lo(t)}),o=await a.publish();return o&&i.push(o),{...r,currentOverlayPath:n.path??a.path,...n.overlayRefs?{currentOverlayRefCount:n.overlayRefs.length}:{},...r.regions&&n.overlayRefs?{regions:Eo(r.regions,n.overlayRefs,r.normalization?.currentScale)}:{}}}catch(e){throw await a.cleanup?.(),e}}async function Io(e,t,n,r={}){if(!e.backend.captureScreenshot)throw new a(`UNSUPPORTED_OPERATION`,`screenshot is not supported by this backend`);return await e.backend.captureScreenshot({session:t.session,requestId:t.requestId,signal:t.signal??e.signal,metadata:t.metadata},n,r)??{}}function Lo(e){return{normalizeStatusBar:e.normalizeStatusBar??!0,...e.surface?{surface:e.surface}:{}}}function Ro(e,t){if(e.currentOverlayOut)return e.currentOverlayOut;if(e.out?.kind===`path`)return{kind:`path`,path:Q(t??e.out.path)};if(e.out?.kind===`downloadableArtifact`)return{kind:`downloadableArtifact`,...e.out.clientPath?{clientPath:Q(e.out.clientPath)}:{},...e.out.fileName?{fileName:Q(e.out.fileName)}:{}}}function Q(e){let t=Et.extname(e);return`${t?e.slice(0,-t.length):e}.current-overlay${t||`.png`}`}async function zo(e){try{await j.unlink(Q(e))}catch(e){if(!Vo(e,`ENOENT`))throw e}}function Bo(e){return e.kind===`live`}function Vo(e,t){return typeof e==`object`&&!!e&&`code`in e&&e.code===t}const Ho=async(e,t)=>{if(!e.backend.captureScreenshot)throw new a(`UNSUPPORTED_OPERATION`,`screenshot is not supported by this backend`);f(t);let n=await Ao(e,t.out,{field:`path`,ext:`.png`,artifactType:`screenshot`}),r,i;try{i=(await e.backend.captureScreenshot({session:t.session,requestId:t.requestId,appId:t.appId,appBundleId:t.appBundleId,signal:t.signal??e.signal,metadata:t.metadata},n.path,{fullscreen:t.fullscreen,overlayRefs:t.overlayRefs,pixelDensity:t.pixelDensity,stabilize:t.stabilize,normalizeStatusBar:t.normalizeStatusBar,surface:t.surface}))?.displayRotation,t.scale!==void 0&&await ot(n.path,t.scale),r=await n.publish()}catch(e){throw await n.cleanup?.(),e}return{path:n.path,...r?{artifacts:[r]}:{},...i?{displayRotation:i}:{},...T(`Saved screenshot: ${n.path}`)}};function Uo(e){let{nodes:t,backend:r,snapshotRaw:i}=e;if(i||!n(r))return{partial:!1,visibleNodeCount:t.length,totalNodeCount:t.length,reasons:[]};let a=Ae(t),o=new Set;return a.hiddenCount>0&&o.add(`offscreen-nodes`),a.nodes.some(e=>e.hiddenContentAbove)&&o.add(`scroll-hidden-above`),a.nodes.some(e=>e.hiddenContentBelow)&&o.add(`scroll-hidden-below`),{partial:o.size>0,visibleNodeCount:a.nodes.length,totalNodeCount:t.length,reasons:[...o]}}function Wo(e,t){return e.presentationKey?e:{...e,presentationKey:l(t)}}function Go(e){let{previous:t,current:n,options:r,identity:i}=e;if(r.forceFull===!0||r.raw===!0||!t||t.comparisonSafe===!1||n.comparisonSafe===!1||!Ko(t,n,i)||!t.presentationKey||t.presentationKey!==n.presentationKey||!qo(t,n))return;let a=r.scope?.trim();return{ageMs:Math.max(0,n.createdAt-t.createdAt),nodeCount:n.nodes.length,...r.interactiveOnly===!0?{interactiveOnly:!0}:{},...a?{scope:a}:{}}}function Ko(e,t,n){return!(e.backend&&t.backend&&e.backend!==t.backend||n?.previousAppBundleId&&n.currentAppBundleId&&n.previousAppBundleId!==n.currentAppBundleId)}function qo(e,t){return e.truncated===t.truncated&&e.nodes.length===t.nodes.length&&e.nodes.every((e,n)=>Yo(e,t.nodes[n]))}const Jo=Object.keys({index:!0,depth:!0,parentIndex:!0,type:!0,kind:!0,role:!0,subrole:!0,label:!0,value:!0,contentDescription:!0,identifier:!0,enabled:!0,editable:!0,password:!0,selected:!0,checked:!0,focused:!0,heading:!0,roleDescription:!0,placeholder:!0,hittable:!0,bundleId:!0,systemBar:!0,appName:!0,windowTitle:!0,surface:!0,keyboardOwned:!0,hiddenContentAbove:!0,hiddenContentBelow:!0,interactionBlocked:!0});function Yo(e,t){return Jo.every(n=>e[n]===t[n])&&Zo(e.rect,t.rect)&&Xo(e.coveredBy,t.coveredBy)&&Qo(e.presentationHints,t.presentationHints)&&Qo(e.actions,t.actions)}function Xo(e,t){return!e||!t?e===t:e.kind===t.kind&&e.label===t.label&&Zo(e.rect,t.rect)}function Zo(e,t){return!e||!t?e===t:e.x===t.x&&e.y===t.y&&e.width===t.width&&e.height===t.height}function Qo(e,t){return!e||!t?e===t:e.length===t.length&&e.every((e,n)=>e===t[n])}const $o=async(e,t)=>{let n=await ts(e,t),r=Go({previous:n.session?.snapshot,current:n.snapshot,options:t,identity:{previousAppBundleId:n.session?.appBundleId,currentAppBundleId:n.result.appBundleId??n.session?.appBundleId}});await e.sessions.set(ns(t.session,n));let i=is(n.snapshot);return ee(n.snapshot,{nodes:n.snapshot.nodes,...i===void 0?{}:{truncated:i},visibility:Uo({nodes:n.snapshot.nodes,backend:n.snapshot.backend,snapshotRaw:t.raw}),...m({...n.annotations,warnings:n.warnings}),...r?{unchanged:r}:{},...n.result.snapshotDiagnostics?{snapshotDiagnostics:n.result.snapshotDiagnostics}:{},...n.snapshot.keyboard?{keyboard:n.snapshot.keyboard}:{},...n.snapshot.viewport?{viewport:n.snapshot.viewport}:{},...n.snapshot.presentedSurface?{presentedSurface:n.snapshot.presentedSurface}:{},...rs(n)})},es=async(e,t)=>{if(t.observeOnly===!0)throw new a(`INVALID_ARGS`,`observeOnly is supported by snapshot, not diff.`);let n=await ts(e,t),r=t.interactiveOnly===!0,i=n.session?.snapshot,o=ns(t.session,n);if(!i){let t=Pt(n.snapshot.nodes,{flatten:r});return await e.sessions.set(o),{mode:`snapshot`,baselineInitialized:!0,summary:{additions:0,removals:0,unchanged:t},lines:[],...n.warnings.length>0?{warnings:n.warnings}:{}}}let s=Nt(i.nodes,n.snapshot.nodes,{flatten:r});return await e.sessions.set(o),{mode:`snapshot`,baselineInitialized:!1,summary:s.summary,lines:s.lines,...n.warnings.length>0?{warnings:n.warnings}:{}}};async function ts(e,t){if(!e.backend.captureSnapshot)throw new a(`UNSUPPORTED_OPERATION`,`snapshot is not supported by this backend`);let n=t.session??`default`,r=await e.sessions.get(n),i=await e.backend.captureSnapshot({session:n,requestId:t.requestId,appId:r?.appId,appBundleId:r?.appBundleId,signal:t.signal??e.signal,metadata:t.metadata},{interactiveOnly:t.interactiveOnly,depth:t.depth,scope:t.scope,raw:t.raw,customActions:t.customActions,...t.observeOnly===void 0?{}:{observeOnly:t.observeOnly}}),o=ee(i.snapshot,Wo(i.snapshot,t)),s=p(i),c=N(e);return{snapshot:o,result:i,session:r,annotations:s,warnings:as({result:i,annotations:s,snapshot:o,options:t,session:r,capturedAt:o.createdAt,runtimeNow:c})}}function ns(e,t){let n=t.session?.name??e??`default`;return{...t.session??{name:n},name:n,snapshot:t.snapshot,appName:t.result.appName??t.session?.appName,appBundleId:t.result.appBundleId??t.session?.appBundleId}}function rs(e){let t=e.result.appName??e.session?.appName,n=e.result.appBundleId??e.session?.appBundleId;return{...t||n?{appName:t??n}:{},...n?{appBundleId:n}:{}}}function is(e){return e.truncated===void 0?e.backend!==`xctest`||e.producer===void 0?!1:Tt(e.producer)===`unavailable`&&void 0:e.truncated}function as(e){let t=[...e.annotations.warnings??[]];e.annotations.quality&&t.push(...bt(e.annotations.quality,e.snapshot.nodes)),t.push(...xt(is(e.snapshot))),e.snapshot.postGestureOutcome&&t.push(Je(e.snapshot.postGestureOutcome)),t.push(...us(e)),e.annotations.quality||(t.push(...ss(e)),t.push(...ls(e.snapshot.nodes)));let n=mt(e.snapshot.nodes);n&&t.push(n);let r=os(e.annotations);r&&t.push(r);let i=ds(e);return i&&t.push(i),t.push(...hs(e.annotations.freshness,e.snapshot.backend)),Array.from(new Set(t))}function os(e){if(e.androidSnapshot?.systemSurfaceOnly===!0)return pt}function ss(e){if(e.snapshot.backend!==`xctest`||e.options.interactiveOnly!==!0||e.snapshot.nodes.length!==1)return[];let t=e.snapshot.nodes[0];return cs(t)?e.snapshot.producer===`appium-source`?[`Appium page source exposed only the application root. Descendants may be absent from the acquired hierarchy; use snapshot --raw to inspect the source and verify the app accessibility tree.`]:e.snapshot.producer!==void 0&&e.snapshot.producer!==`apple-runner`?[]:[`iOS interactive snapshot exposed only the application root. XCTest accessibility queries can fail to enumerate some simulator UI trees even when screenshots and direct gestures still work. Use screenshot as visual truth, try a scoped/full snapshot for diagnostics, and prefer direct selectors when known.`]:[]}function cs(e){return e?me(e.type??``)===`application`:!1}function ls(e){let t=new Set(e.map(e=>e.parentIndex).filter(e=>e!==void 0));return e.filter(e=>t.has(e.index)||(e.type?.toLowerCase()??``).includes(`text`)?!1:(e.label??``).split(`, `).length>10).map(e=>{let t=(e.label??``).split(`, `).length,n=e.identifier?` (${e.identifier})`:``;return`@${e.ref} [${e.type??`element`}]${n} merges ~${t} labels into a single accessibility element. The app likely marks a container as accessible, which hides every descendant from assistive tech and automation — the children cannot be addressed individually. Fix the app's accessibility (mark the rows, not the container); until then use screenshot as visual truth and coordinate taps.`})}function us(e){let t=e.annotations.analysis;if(e.snapshot.backend!==`android`||e.options.interactiveOnly!==!0||e.snapshot.nodes.length>0||!t||(t.rawNodeCount??0)<12)return[];let n=[`Interactive snapshot is empty after filtering ${t.rawNodeCount} raw Android nodes. Likely causes: the app content is not accessibility-visible yet, a transient route change, or depth/filter options hid the target.`];return typeof e.options.depth==`number`&&typeof t.maxDepth==`number`&&t.maxDepth>=e.options.depth+2&&n.push(`Interactive output is empty at depth ${e.options.depth}; retry without -d.`),n}function ds(e){let t=e.session?.snapshot;if(!e.annotations.freshness&&t&&fs(t,e.snapshot)&&ps(t,e.capturedAt,e.runtimeNow)&&We(t.nodes.length,e.snapshot.nodes.length))return ms}function fs(e,t){return e.presentationKey===void 0||t.presentationKey===void 0||e.presentationKey===t.presentationKey}function ps(e,t,n){return[t,n].some(t=>{let n=t-e.createdAt;return n>=0&&n<=2e3})}const ms=`Recent snapshots dropped sharply in node count, which suggests stale or mid-transition UI. Use screenshot as visual truth, wait briefly, then re-snapshot once.`;function hs(e,t){return!e?.staleAfterRetries||t!==`android`?[]:e.reason===`stuck-route`?[`Recent ${e.action} was followed by a nearly identical snapshot after ${e.retryCount} automatic retr${e.retryCount===1?`y`:`ies`}. If you expected navigation or submit, the tree may still be stale. Use screenshot as visual truth, wait briefly, then re-snapshot once.`]:e.reason===`sharp-drop`?[ms]:[]}const gs={screenshot:Ho,diffScreenshot:Mo,snapshot:$o,diffSnapshot:es};function _s(e){return Ot(gs,e)}function vs(e){return{backend:e.backend,artifacts:e.artifacts,sessions:e.sessions??ys(),policy:e.policy??ft(),diagnostics:e.diagnostics,clock:e.clock,signal:e.signal}}function ys(e=[]){let t=new Map(e.map(e=>[e.name,$(e)]));return{get:e=>$(t.get(e)),set:e=>{t.set(e.name,$(e))},delete:e=>{t.delete(e)},list:()=>Array.from(t.values(),e=>$(e))}}function $(e){if(e)return{...e,...e.snapshot?{snapshot:structuredClone(e.snapshot)}:{},...e.metadata?{metadata:bs(e.metadata)}:{}}}function bs(e){try{return structuredClone(e)}catch{return{...e}}}export{Aa as a,P as c,ko as i,M as l,_s as n,ka as o,Ao as r,Ot as s,vs as t};
@@ -1 +1 @@
1
- import{R as e,S as t,_ as n,j as r,k as i,nt as a,s as o}from"./sdk-contracts.js";import"./tv-remote.js";import{a as s}from"./snapshot-capture-annotations.js";import{r as c}from"./snapshot-diagnostics.js";import{r as l}from"./snapshot-private-evidence.js";import{ht as u}from"./sdk-io.js";import"./diagnostics.js";import{O as d}from"./sdk-device.js";import{On as f}from"./sdk-batch.js";import{t as p}from"./interaction-error.js";import{t as m}from"./snapshot-state.js";import{O as h,a as g,f as _,j as v,m as y,p as b,r as x,v as S,y as C}from"./snapshot-runtime-capture-input.js";import{t as w}from"./snapshot-node-lookup.js";import{randomInt as T}from"node:crypto";function E(e,t){e.snapshot!==t&&(e.snapshotGeneration=k(e.snapshotGeneration)),e.snapshot=t,e.snapshotScopeSource=void 0,t.comparisonSafe===!0&&(e.lastComparisonSafeSnapshot=t)}function D(e){e.snapshot=void 0}function O(e,t){e.snapshot=t.snapshot,t.snapshot.comparisonSafe===!0&&(e.lastComparisonSafeSnapshot=t.snapshot),e.snapshotScopeSource=t.scopeSource,e.snapshotGeneration=t.keptCurrentSnapshot?t.previousGeneration:k(t.previousGeneration)}function k(e){return e===void 0?T(1e5,1e6):e+1}function A(e){let t=e.startsWith(`@`)?e.slice(1):e,n=t.indexOf(`~`);return n===-1?t:t.slice(0,n)}function j(e,t){let n=new Set;for(let e of t){let t=A(e);t.length>0&&n.add(t)}n.size!==0&&g(e,n)}function M(e,t,n){if(!e||!n?.diff)return;let r=t.resolveCurrent(e);if(r)return j(r,F(n)),r.snapshotGeneration}function N(t,n,r,i){if(r.code!==`AMBIGUOUS_MATCH`)return r;let o=a(r.details);if(o.length===0)return r;let s=t?n.resolveCurrent(t):void 0;return s?.snapshot&&s.snapshotGeneration!==void 0&&i!==void 0&&i.nodes===s.snapshot.nodes?(j(s,o),new e(r.code,r.message,{...r.details,refsGeneration:s.snapshotGeneration},r.cause)):P(r)}function P(t){let{candidates:n,refsGeneration:r,...i}=t.details??{};return new e(t.code,t.message,{...i,hint:`Narrow the selector with role/id/longer text and retry.`},t.cause)}function F(e){let t=[];for(let n of e.diff?.lines??[])n.ref&&t.push(n.ref);for(let n of e.refs??[])t.push(n.ref);for(let n of e.tail??[])t.push(n.ref);return t}function I(e){return`Ref @${e.ref.startsWith(`@`)?e.ref.slice(1):e.ref} was minted from snapshot s${e.mintedGeneration} but the session's ref frame is now s${e.currentFrameEpoch} — re-run snapshot -i.`}function L(e){let{session:t,ref:n,mintedGeneration:r}=e;if(t&&b(t)===`expired`)return`The UI may have changed since these refs were issued, so they no longer represent current device state. Take a new snapshot before relying on or interacting with them.`;if(r!==void 0){let e=t?_(t)??0:0;if(r!==e)return I({ref:n,mintedGeneration:r,currentFrameEpoch:e})}}async function R(e){let t=await(await v().resolve(e.device,e.runnerContext)).snapshot(e.options);if(!(`stage`in t))return t;let{presentIosSnapshotAcquisition:n}=await import(`./ios-snapshot-runtime.js`);return await n(t,e.options)}async function z(e){let t=await C({session:e.session,device:e.device,interactiveOnly:e.flags?.snapshotInteractiveOnly===!0,androidFreshnessMode:e.androidFreshnessMode,capture:()=>V(e)});if(t)return t;let n=await V(e);return h(e.session),{snapshot:n.snapshot,...n.annotations}}async function B(e){if(e.captureData)return await e.captureData();let{device:t,session:i,logPath:a}=e,o=x(a,H(e),i?.appBundleId,i?.trace?.outPath);return await R({device:t,runnerContext:{requestId:o.requestId,signal:e.signal,appBundleId:o.appBundleId,verbose:o.verbose,logPath:o.logPath,traceLogPath:o.traceLogPath,iosXctestrunFile:o.iosXctestrunFile,iosXctestDerivedDataPath:o.iosXctestDerivedDataPath,iosXctestEnvDir:o.iosXctestEnvDir,runnerLeaseContext:o.runnerLeaseContext},options:{appBundleId:o.appBundleId,signal:e.signal,...r(o,n),includeRects:e.includeRects,surface:i?.surface}})}async function V(e){let t=Date.now(),n=await B(e);c(e.session,{durationMs:Date.now()-t,backend:n.backend,platform:d(e.device)});let r=s(n),i=l(n,m(n,H(e)));return r.androidSnapshot?.systemSurfaceOnly===!0&&(i.systemSurfaceOnly=!0),{data:n,snapshot:i,annotations:r}}function H(e){return e.snapshotScope===void 0?e.flags:{...e.flags,snapshotScope:e.snapshotScope}}function U(e,n){if(!e||!e.trim().startsWith(`@`))return{ok:!0,scope:e};if(!n?.snapshot)return o(`INVALID_ARGS`,`Ref scope requires an existing snapshot in session.`);let r=i(e.trim());if(!r)return o(`INVALID_ARGS`,`Invalid ref scope: ${e}`);let a=[n.snapshot,...n.snapshotScopeSource?[n.snapshotScopeSource]:[]],s=!1,c;for(let e of a){let n=t(e.nodes,r);if(n&&(s=!0,c=w(n,e.nodes),c))break}return s?c?{ok:!0,scope:c}:o(`COMMAND_FAILED`,`Ref ${e} has no label to scope by`,{reason:p.refUnlabeled,ref:r}):o(`COMMAND_FAILED`,`Ref ${e} not found`,{reason:p.refNotFound,ref:r},{hint:f})}function W(e,t,n={}){if(!e)return;let r=y(e),i=S(e);return{name:t,appBundleId:e.appBundleId,appName:e.appName,...n.includeSnapshot===!0?{snapshot:e.snapshot,...r&&n.omitRefFrameSnapshot!==!0?{refFrameSnapshot:r}:{},...i?{movingTargetBaseline:i}:{}}:{},metadata:{surface:e.surface,...n.metadata??{}}}}function G(e,t){return{get:n=>n===e?W(t,e):void 0,set:()=>{}}}function K(e){let t=e.ref;return{getRef:()=>t?e.sessionStore.refresh(t):void 0,get:n=>n===e.sessionName?W(t?e.sessionStore.resolveCurrent(t):void 0,e.sessionName,e.recordOptions):void 0,set:n=>{if(n.name!==e.sessionName){u({level:`warn`,phase:`runtime_session_write_skipped`,data:{expected:e.sessionName,received:n.name}});return}let r=t?e.sessionStore.requireCurrent(t):void 0,i=e.setRecord(n,r,t);i&&(t=i)}}}export{U as a,j as c,O as d,E as f,B as i,N as l,G as n,D as o,z as r,M as s,K as t,L as u};
1
+ import{R as e,S as t,_ as n,j as r,k as i,rt as a,s as o}from"./sdk-contracts.js";import"./tv-remote.js";import{a as s}from"./snapshot-capture-annotations.js";import{r as c}from"./snapshot-diagnostics.js";import{r as l}from"./snapshot-private-evidence.js";import{_t as u}from"./sdk-io.js";import"./diagnostics.js";import{I as d}from"./sdk-device.js";import{Rn as f}from"./sdk-batch.js";import{t as p}from"./interaction-error.js";import{t as m}from"./snapshot-state.js";import{O as h,a as g,f as _,j as v,m as y,p as b,r as x,v as S,y as C}from"./snapshot-runtime-capture-input.js";import{t as w}from"./snapshot-node-lookup.js";import{randomInt as T}from"node:crypto";function E(e,t){e.snapshot!==t&&(e.snapshotGeneration=k(e.snapshotGeneration)),e.snapshot=t,e.snapshotScopeSource=void 0,t.comparisonSafe===!0&&(e.lastComparisonSafeSnapshot=t)}function D(e){e.snapshot=void 0}function O(e,t){e.snapshot=t.snapshot,t.snapshot.comparisonSafe===!0&&(e.lastComparisonSafeSnapshot=t.snapshot),e.snapshotScopeSource=t.scopeSource,e.snapshotGeneration=t.keptCurrentSnapshot?t.previousGeneration:k(t.previousGeneration)}function k(e){return e===void 0?T(1e5,1e6):e+1}function A(e){let t=e.startsWith(`@`)?e.slice(1):e,n=t.indexOf(`~`);return n===-1?t:t.slice(0,n)}function j(e,t){let n=new Set;for(let e of t){let t=A(e);t.length>0&&n.add(t)}n.size!==0&&g(e,n)}function M(e,t,n){if(!e||!n?.diff)return;let r=t.resolveCurrent(e);if(r)return j(r,F(n)),r.snapshotGeneration}function N(t,n,r,i){if(r.code!==`AMBIGUOUS_MATCH`)return r;let o=a(r.details);if(o.length===0)return r;let s=t?n.resolveCurrent(t):void 0;return s?.snapshot&&s.snapshotGeneration!==void 0&&i!==void 0&&i.nodes===s.snapshot.nodes?(j(s,o),new e(r.code,r.message,{...r.details,refsGeneration:s.snapshotGeneration},r.cause)):P(r)}function P(t){let{candidates:n,refsGeneration:r,...i}=t.details??{};return new e(t.code,t.message,{...i,hint:`Narrow the selector with role/id/longer text and retry.`},t.cause)}function F(e){let t=[];for(let n of e.diff?.lines??[])n.ref&&t.push(n.ref);for(let n of e.refs??[])t.push(n.ref);for(let n of e.tail??[])t.push(n.ref);return t}function I(e){return`Ref @${e.ref.startsWith(`@`)?e.ref.slice(1):e.ref} was minted from snapshot s${e.mintedGeneration} but the session's ref frame is now s${e.currentFrameEpoch} — re-run snapshot -i.`}function L(e){let{session:t,ref:n,mintedGeneration:r}=e;if(t&&b(t)===`expired`)return`The UI may have changed since these refs were issued, so they no longer represent current device state. Take a new snapshot before relying on or interacting with them.`;if(r!==void 0){let e=t?_(t)??0:0;if(r!==e)return I({ref:n,mintedGeneration:r,currentFrameEpoch:e})}}async function R(e){let t=await(await v().resolve(e.device,e.runnerContext)).snapshot(e.options);if(!(`stage`in t))return t;let{presentIosSnapshotAcquisition:n}=await import(`./ios-snapshot-runtime.js`);return await n(t,e.options)}async function z(e){let t=await C({session:e.session,device:e.device,interactiveOnly:e.flags?.snapshotInteractiveOnly===!0,androidFreshnessMode:e.androidFreshnessMode,capture:()=>V(e)});if(t)return t;let n=await V(e);return h(e.session),{snapshot:n.snapshot,...n.annotations}}async function B(e){if(e.captureData)return await e.captureData();let{device:t,session:i,logPath:a}=e,o=x(a,H(e),i?.appBundleId,i?.trace?.outPath);return await R({device:t,runnerContext:{requestId:o.requestId,signal:e.signal,appBundleId:o.appBundleId,verbose:o.verbose,logPath:o.logPath,traceLogPath:o.traceLogPath,iosXctestrunFile:o.iosXctestrunFile,iosXctestDerivedDataPath:o.iosXctestDerivedDataPath,iosXctestEnvDir:o.iosXctestEnvDir,runnerLeaseContext:o.runnerLeaseContext},options:{appBundleId:o.appBundleId,signal:e.signal,...r(o,n),includeRects:e.includeRects,surface:i?.surface}})}async function V(e){let t=Date.now(),n=await B(e);c(e.session,{durationMs:Date.now()-t,backend:n.backend,platform:d(e.device)});let r=s(n),i=l(n,m(n,H(e)));return r.androidSnapshot?.systemSurfaceOnly===!0&&(i.systemSurfaceOnly=!0),{data:n,snapshot:i,annotations:r}}function H(e){return e.snapshotScope===void 0?e.flags:{...e.flags,snapshotScope:e.snapshotScope}}function U(e,n){if(!e||!e.trim().startsWith(`@`))return{ok:!0,scope:e};if(!n?.snapshot)return o(`INVALID_ARGS`,`Ref scope requires an existing snapshot in session.`);let r=i(e.trim());if(!r)return o(`INVALID_ARGS`,`Invalid ref scope: ${e}`);let a=[n.snapshot,...n.snapshotScopeSource?[n.snapshotScopeSource]:[]],s=!1,c;for(let e of a){let n=t(e.nodes,r);if(n&&(s=!0,c=w(n,e.nodes),c))break}return s?c?{ok:!0,scope:c}:o(`COMMAND_FAILED`,`Ref ${e} has no label to scope by`,{reason:p.refUnlabeled,ref:r}):o(`COMMAND_FAILED`,`Ref ${e} not found`,{reason:p.refNotFound,ref:r},{hint:f})}function W(e,t,n={}){if(!e)return;let r=y(e),i=S(e);return{name:t,appBundleId:e.appBundleId,appName:e.appName,...n.includeSnapshot===!0?{snapshot:e.snapshot,...r&&n.omitRefFrameSnapshot!==!0?{refFrameSnapshot:r}:{},...i?{movingTargetBaseline:i}:{}}:{},metadata:{surface:e.surface,...n.metadata??{}}}}function G(e,t){return{get:n=>n===e?W(t,e):void 0,set:()=>{}}}function K(e){let t=e.ref;return{getRef:()=>t?e.sessionStore.refresh(t):void 0,get:n=>n===e.sessionName?W(t?e.sessionStore.resolveCurrent(t):void 0,e.sessionName,e.recordOptions):void 0,set:n=>{if(n.name!==e.sessionName){u({level:`warn`,phase:`runtime_session_write_skipped`,data:{expected:e.sessionName,received:n.name}});return}let r=t?e.sessionStore.requireCurrent(t):void 0,i=e.setRecord(n,r,t);i&&(t=i)}}}export{U as a,j as c,O as d,E as f,B as i,N as l,G as n,D as o,z as r,M as s,K as t,L as u};