agent-device 0.21.18 → 0.21.19

package/dist/src/interactor.js

@@ -1,6 +1,6 @@
-import{C as e,J as t,N as n,w as r}from"./sdk-contracts.js";import{i}from"./capture.js";import{D as a}from"./sdk-batch-runner.js";import{D as o,O as s,f as c,m as l,p as ee,y as u}from"./sdk-device.js";import{Hr as te}from"./sdk-batch.js";import{d as ne,i as re,l as ie}from"./scroll-gesture.js";import{n as d}from"./session.js";import{a as ae,n as f}from"./alert-contract.js";import{C as oe,S as se,_ as ce,b as p,m as le,n as ue,r as m,v as h,x as de,y as fe}from"./settings.js";import{n as pe}from"./location-coordinates.js";import{c as me,n as he,t as ge}from"./scroll-command.js";import"./device.js";import{t as _e}from"./device-rotation.js";import{c as ve,r as g}from"./diagnostics.js";import{a as _}from"./exec.js";import{t as ye}from"./timeouts.js";import{a as be}from"./tv-remote.js";import"./diagnostics2.js";import"./command.js";import{i as xe,n as Se}from"./retry.js";import{a as Ce}from"./gesture-plan.js";import{n as we}from"./scoped-provider.js";import{n as Te,r as Ee}from"./ios-snapshot-planning.js";import{a as De,l as Oe,n as ke,s as Ae}from"./quality-warnings.js";import{n as je,r as Me}from"./ios-system-surface.js";import{r as Ne}from"./ios-snapshot-acquisition.js";import{t as Pe}from"./png-size.js";import{n as Fe}from"./screenshot-density.js";import{n as Ie}from"./interactor-types.js";import{i as v,n as Le,r as y}from"./ios-snapshot-engine.js";import{C as Re,g as ze,r as Be}from"./host-file.js";import{c as b,d as Ve,f as He,m as Ue,p as We}from"./config.js";import{o as Ge}from"./tool-provider.js";import{n as Ke,r as x,t as S}from"./physical-device-control.js";import{i as qe,n as C,r as w,s as Je}from"./runner.js";import{l as Ye}from"./host.js";import{t as Xe}from"./runner-cache-metadata.js";import{a as T,n as E}from"./simctl.js";import{c as D}from"./runner-client.js";import"./runner-error-classification.js";import{n as Ze,r as Qe,t as $e}from"./app-launch.js";import{r as O,t as k}from"./simulator.js";import{a as et,i as tt,o as nt}from"./helper.js";import{a as rt,d as it,f as at,p as ot}from"./app-resolution.js";import{i as st,t as ct}from"./display-inventory.js";import{n as lt}from"./multitouch-support.js";import{t as ut}from"./surface-snapshot.js";import{t as dt}from"./ios-target-activation.js";import A from"node:path";async function ft(e){return l(e)?await it():(O(e,`clipboard`),await k(e),_(await T(e,[`pbpaste`,e.id],{allowFailure:!0}),`Failed to read iOS simulator clipboard`).stdout.replaceAll(`\r
+import{C as e,N as t,Q as n,w as r}from"./sdk-contracts.js";import{i}from"./capture.js";import{D as a}from"./sdk-batch-runner.js";import{D as o,O as s,f as c,m as l,p as ee,y as u}from"./sdk-device.js";import{Ur as te}from"./sdk-batch.js";import{d as ne,i as re,l as ie}from"./scroll-gesture.js";import{n as d}from"./session.js";import{a as ae,n as f}from"./alert-contract.js";import{C as oe,S as se,_ as ce,b as p,m as le,n as ue,r as m,v as h,x as de,y as fe}from"./settings.js";import{n as pe}from"./location-coordinates.js";import{c as me,n as he,t as ge}from"./scroll-command.js";import"./device.js";import{t as _e}from"./device-rotation.js";import{c as ve,r as g}from"./diagnostics.js";import{a as _}from"./exec.js";import{t as ye}from"./timeouts.js";import{a as be}from"./tv-remote.js";import"./diagnostics2.js";import"./command.js";import{i as xe,n as Se}from"./retry.js";import{a as Ce}from"./gesture-plan.js";import{n as we}from"./scoped-provider.js";import{n as Te,r as Ee}from"./ios-snapshot-planning.js";import{n as De,r as Oe}from"./ios-system-surface.js";import{a as ke,l as Ae,n as je,s as Me}from"./quality-warnings.js";import{r as Ne}from"./ios-snapshot-acquisition.js";import{t as Pe}from"./png-size.js";import{n as Fe}from"./screenshot-density.js";import{i as v,n as Ie,r as y}from"./ios-snapshot-engine.js";import{C as Le,g as Re,r as ze}from"./host-file.js";import{c as b,d as Be,f as Ve,m as He,p as Ue}from"./config.js";import{o as We}from"./tool-provider.js";import{n as Ge,r as x,t as S}from"./physical-device-control.js";import{i as Ke,n as C,r as w,s as qe}from"./runner.js";import{l as Je}from"./host.js";import{t as Ye}from"./runner-cache-metadata.js";import{a as T,n as E}from"./simctl.js";import{c as D}from"./runner-client.js";import"./runner-error-classification.js";import{n as Xe,r as Ze,t as Qe}from"./app-launch.js";import{r as O,t as k}from"./simulator.js";import{a as $e,i as et,o as tt}from"./helper.js";import{a as nt,d as rt,f as it,p as at}from"./app-resolution.js";import{i as ot,t as st}from"./display-inventory.js";import{n as ct}from"./interactor-types.js";import{n as lt}from"./multitouch-support.js";import{t as ut}from"./surface-snapshot.js";import{t as dt}from"./ios-target-activation.js";import A from"node:path";async function ft(e){return l(e)?await rt():(O(e,`clipboard`),await k(e),_(await T(e,[`pbpaste`,e.id],{allowFailure:!0}),`Failed to read iOS simulator clipboard`).stdout.replaceAll(`\r
 `,`
-`).replace(/\n$/,``))}async function pt(e,t,n){if(l(e)){await ot(t);return}if(O(e,`clipboard`),u(e)){let r=n?.signal;await k(e,{signal:r}),_(await T(e,[`pbcopy`,e.id],{allowFailure:!0,stdin:t,signal:r}),`Failed to write tvOS simulator clipboard`);return}await D(e,{command:`pasteboardWrite`,text:t},n)}function j(e,t){if(!c(e))throw new n(`UNSUPPORTED_OPERATION`,t.message,{deviceId:e.id,appleOs:o(e),deviceKind:e.kind,reason:t.reason,hint:t.hint})}async function mt(e,t){j(e,m);let n=de(t);return await T(e,[`ui`,e.id,`content_size`,n]),oe(n,n)}async function ht(e){j(e,m),await k(e);let t=_(await T(e,[`ui`,e.id,`content_size`],{allowFailure:!0}),`Failed to read iOS content size category`),r=t.stdout.trim(),i=se(r);if(i===void 0)throw new n(`COMMAND_FAILED`,`iOS simulator reported an unknown text size: ${r||`(empty)`}`,{deviceId:e.id,stdout:t.stdout,stderr:t.stderr,hint:"Boot the simulator, or run `xcrun simctl ui <device> content_size` to see what it reports."});return oe(i,r)}const gt=[`--time`,`9:41`,`--dataNetwork`,`wifi`,`--wifiMode`,`active`,`--wifiBars`,`3`,`--batteryState`,`charged`,`--batteryLevel`,`100`],_t={0:`hide`,1:`wifi`,6:`3g`,7:`4g`,8:`lte`,9:`lte-a`,10:`lte+`,11:`5g`,12:`5g+`,13:`5g-uwb`,14:`5g-uc`},vt={1:`searching`,2:`failed`,3:`active`},yt={0:`notSupported`,1:`searching`,2:`failed`,3:`active`},M=new Set;async function bt(e){let t=null,n=!1;if(St(e))n=!0;else try{t=await Ct(e),n=!0}catch(t){R(e,`snapshot_failed`,t)}try{(!n||t)&&await I(e),await L(e,gt)}catch(t){R(e,`prepare_failed`,t)}return async()=>{await xt(e,n?t:null)}}async function xt(e,t){if(await I(e),!t){P(e);return}await L(e,Tt(t)),N(e)}function N(e){M.delete(F(e))}function P(e){M.add(F(e))}function St(e){return M.has(F(e))}function F(e){return`${e.platform}:${e.kind}:${e.id}`}async function Ct(e){return wt(_(await T(e,[`status_bar`,e.id,`list`],{allowFailure:!0}),`Failed to read simulator status bar overrides`).stdout)}async function I(e){await T(e,[`status_bar`,e.id,`clear`])}async function L(e,t){t.length!==0&&await T(e,[`status_bar`,e.id,`override`,...t])}function wt(e){let t={},r=e.split(`
-`).map(e=>e.trim()).filter(e=>e.length>0&&e!==`Current Status Bar Overrides:`&&!/^=+$/.test(e));for(let e of r){let r=/^DataNetworkType:\s+(\d+)$/.exec(e);if(r){let e=Number(r[1]),i=_t[e];if(!i)throw new n(`COMMAND_FAILED`,`Unsupported simulator data network type: ${e}`);t.dataNetwork=i;continue}let i=/^WiFi Mode:\s+(\d+),\s+WiFi Bars:\s+(\d+)$/.exec(e);if(i){let e=vt[Number(i[1])];e&&(t.wifiMode=e),t.wifiBars=i[2];continue}let a=/^Cell Mode:\s+(\d+),\s+Cell Bars:\s+(\d+)$/.exec(e);if(a){let e=Number(a[1]),r=yt[e];if(!r)throw new n(`COMMAND_FAILED`,`Unsupported simulator cellular mode: ${e}`);t.cellularMode=r,t.cellularBars=a[2];continue}let o=/^Operator Name:\s*(.*)$/.exec(e);if(o){t.operatorName=o[1]??``;continue}}return Object.keys(t).length===0?null:t}function Tt(e){let t=[];return e.dataNetwork&&t.push(`--dataNetwork`,e.dataNetwork),e.wifiMode&&t.push(`--wifiMode`,e.wifiMode),e.wifiBars!==void 0&&(e.dataNetwork===`wifi`||e.wifiMode)&&t.push(`--wifiBars`,e.wifiBars),e.cellularMode&&t.push(`--cellularMode`,e.cellularMode),e.cellularBars!==void 0&&(e.cellularMode||Et(e.dataNetwork)||e.operatorName!==void 0)&&t.push(`--cellularBars`,e.cellularBars),e.operatorName!==void 0&&t.push(`--operatorName`,e.operatorName),t}function Et(e){return!!(e&&e!==`hide`&&e!==`wifi`)}function R(e,t,n){g({level:`warn`,phase:`ios_screenshot_status_bar_${t}`,data:{platform:e.platform,deviceKind:e.kind,deviceId:e.id,...x(n)}})}async function Dt(e,t,r,i,a){if(l(e)){let e=t.toLowerCase();if(e===`appearance`){await at(r);return}if(e===`permission`){let e=h(r);if(e===`deny`)throw new n(`INVALID_ARGS`,le(`permission`));let t=jt(a?.permissionTarget);return await et(e,t)}throw new n(`INVALID_ARGS`,le(t))}O(e,`settings`),await k(e);let o=t.toLowerCase();switch(o){case`clear-app-state`:{if(r.toLowerCase()!==`clear`)throw new n(`INVALID_ARGS`,`settings clear-app-state only supports clear.`);if(!i)throw new n(`INVALID_ARGS`,`settings clear-app-state requires an app id or an active app session.`);let t=await At(e,i);return{bundleId:t.bundleId,containerPath:t.containerPath,cleared:!0}}case`reset-keychain`:if(r.toLowerCase()!==`clear`)throw new n(`INVALID_ARGS`,`settings reset-keychain only supports clear.`);return await T(e,[`keychain`,e.id,`reset`]),{scope:`simulator`,cleared:!0,message:`Reset the whole iOS simulator keychain. This clears keychain-backed credentials for every installed app, not just the app under test.`};case`wifi`:{let t=p(r)?`active`:`failed`;await T(e,[`status_bar`,e.id,`override`,`--wifiMode`,t]),N(e);return}case`airplane`:p(r)?(await T(e,[`status_bar`,e.id,`override`,`--dataNetwork`,`hide`,`--wifiMode`,`failed`,`--wifiBars`,`0`,`--cellularMode`,`failed`,`--cellularBars`,`0`,`--operatorName`,``]),N(e)):(await T(e,[`status_bar`,e.id,`clear`]),P(e));return;case`location`:{if(r.toLowerCase()===`set`){let{latitude:t,longitude:n}=pe(a);return await T(e,[`location`,e.id,`set`,`${t},${n}`]),{latitude:t,longitude:n}}let t=p(r);if(!i)throw new n(`INVALID_ARGS`,`location setting requires an active app in session`);let o=t?`grant`:`revoke`;await T(e,[`privacy`,e.id,o,`location`,i]);return}case`faceid`:case`touchid`:{j(e,ue);let t=o,n=Pt[t];await Ht(e,Vt(r,t),{settingName:t,notificationModality:n.notificationModality});return}case`appearance`:{let t=await Mt(e,r);await T(e,[`ui`,e.id,`appearance`,t]);return}case`text-size`:return await mt(e,r);case`permission`:if(!i)throw new n(`INVALID_ARGS`,`permission setting requires an active app in session`);await It(e,Ft(h(r)),Bt(a?.permissionTarget,a?.permissionMode),i);return;default:throw new n(`INVALID_ARGS`,`Unsupported setting: ${t}`)}}const Ot={"text-size":ht};async function kt(e,t){return await Ot[t](e)}async function At(e,t){if(!ee(e)||e.kind!==`simulator`)throw new n(`UNSUPPORTED_OPERATION`,`Clearing app state is currently supported only on iOS simulators.`);let r=await rt(e,t);await k(e),await $e(e,r);let i=_(await T(e,[`get_app_container`,e.id,r,`data`],{allowFailure:!0}),`simctl get_app_container failed for ${r}`).stdout.trim();if(!i)throw new n(`COMMAND_FAILED`,`simctl get_app_container returned an empty data container path for ${r}`);let a=await ze(i);return await Promise.all(a.map(e=>Re(A.join(i,e)))),{bundleId:r,containerPath:i}}function jt(e){let t=e?.trim().toLowerCase();if(t===`accessibility`||t===`screen-recording`||t===`input-monitoring`)return t;throw new n(`INVALID_ARGS`,`Unsupported macOS permission target. Use accessibility|screen-recording|input-monitoring.`)}async function Mt(e,t){let r=ce(t);if(r!==`toggle`)return r;let i=_(await T(e,[`ui`,e.id,`appearance`],{allowFailure:!0}),`Failed to read current iOS appearance`),a=Nt(i.stdout,i.stderr);if(!a)throw new n(`COMMAND_FAILED`,`Unable to determine current iOS appearance for toggle`,{stdout:i.stdout,stderr:i.stderr});return a===`dark`?`light`:`dark`}function Nt(e,t){let n=/\b(light|dark|unsupported|unknown)\b/i.exec(`${e}\n${t}`);if(!n)return null;let r=n[1]?.toLowerCase();return r===`dark`?`dark`:r===`light`?`light`:null}const Pt={faceid:{notificationModality:`pearl`},touchid:{notificationModality:`fingerTouch`}};function Ft(e){return e===`deny`?`revoke`:e}async function It(e,t,n,r){try{await T(e,[`privacy`,e.id,t,n,r])}catch(i){throw Lt(i)?Rt(e,t,n,r,i):i}}function Lt(e){if(!(e instanceof n)||e.code!==`COMMAND_FAILED`)return!1;let t=String(e.details?.stderr??``).toLowerCase();return/failed to (set|grant|revoke|reset) access/.test(t)&&t.includes(`operation not permitted`)}function Rt(e,t,r,i,a){return t===`reset`?new n(`UNSUPPORTED_OPERATION`,`iOS simulator does not support resetting ${r} permission via simctl privacy on this runtime.`,{deviceId:e.id,appBundleId:i,hint:`Use reinstall to force a fresh prompt, or reset simulator content and settings.`},a):new n(`UNSUPPORTED_OPERATION`,`iOS simulator does not support setting ${r} permission via simctl privacy on this runtime.`,{deviceId:e.id,appBundleId:i,hint:"Privacy support varies by Xcode runtime: run `xcrun simctl privacy help` for its documented services, or use the `all` target, which applies the action to every service this runtime can change."},a)}const zt={all:`all`,camera:`camera`,microphone:`microphone`,contacts:`contacts`,"contacts-limited":`contacts-limited`,notifications:`notifications`,calendar:`calendar`,location:`location`,"location-always":`location-always`,"media-library":`media-library`,motion:`motion`,reminders:`reminders`,siri:`siri`};function Bt(e,t){let r=fe(e);if(r===`photos`){let e=t?.trim().toLowerCase();if(!e||e===`full`)return`photos`;if(e===`limited`)return`photos-add`;throw new n(`INVALID_ARGS`,`Invalid photos mode: ${t}. Use full|limited.`)}if(t?.trim())throw new n(`INVALID_ARGS`,`Permission mode is only supported for photos. Received: ${t}.`);return zt[r]}function Vt(e,t){let r=e.trim().toLowerCase();if(r===`match`)return`match`;if(r===`nonmatch`)return`nonmatch`;if(r===`enroll`)return`enroll`;if(r===`unenroll`)return`unenroll`;throw new n(`INVALID_ARGS`,`Invalid ${t} state: ${e}. Use match|nonmatch|enroll|unenroll.`)}async function Ht(e,r,i){let a=E(e,Gt(e.id,r,i.notificationModality)),o=await Ge(a,{allowFailure:!0}),s=[];if(o.exitCode!==0)s.push({args:a,stderr:o.stderr,stdout:o.stdout,exitCode:o.exitCode});else{let t=Ut(r);if(t!==void 0){let n=await Wt(e);if(n.state===t)return;s.push({args:n.args,stderr:n.stderr,stdout:n.stdout,exitCode:n.exitCode})}else return}throw new n(`COMMAND_FAILED`,`Failed to simulate ${i.settingName}.`,{deviceId:e.id,action:r,setting:i.settingName,attempts:t(s)})}const z=`com.apple.BiometricKit.enrollmentChanged`;function Ut(e){if(e===`enroll`)return`1`;if(e===`unenroll`)return`0`}async function Wt(e){let t=E(e,[`spawn`,e.id,`notifyutil`,`-g`,z]),n=await Ge(t,{allowFailure:!0}),r=n.stdout.split(`
-`).map(e=>e.trim().split(/\s+/)).find(e=>e[0]===z)?.[1];return{args:t,stderr:n.stderr,stdout:n.stdout,exitCode:n.exitCode,state:n.exitCode===0?r:void 0}}function Gt(e,t,n){let r=[`spawn`,e,`notifyutil`];switch(t){case`match`:return[...r,`-p`,`com.apple.BiometricKit_Sim.${n}.match`];case`nonmatch`:return[...r,`-p`,`com.apple.BiometricKit_Sim.${n}.nomatch`];case`enroll`:return[...r,`-s`,z,`1`,`-p`,z];case`unenroll`:return[...r,`-s`,z,`0`,`-p`,z]}}function Kt(e){let t=e.screenshotMetadata;if(!t||typeof t!=`object`||Array.isArray(t))return;let n=t,r=B(n.displayID),i=B(n.pixelWidth),a=B(n.pixelHeight),o=qt(n.pixelsPerPoint);if(r!==void 0&&i!==void 0&&a!==void 0&&o!==void 0)return Object.freeze({displayID:r,pixelWidth:i,pixelHeight:a,pixelsPerPoint:o})}function B(e){return typeof e==`number`&&Number.isInteger(e)&&e>0?e:void 0}function qt(e){return typeof e==`number`&&Number.isFinite(e)&&e>0?e:void 0}const Jt={ensureBooted:k,prepareStatusBarForScreenshot:bt,resolveCaptureDisplay:st,captureWithRetry:Zt,normalizeDensity:sn,captureWithRunner:U,shouldFallbackToRunner:an},V=new Map,H=new Map;async function Yt(e,t,n={}){if(l(e)){await U(e,t,n.appBundleId,n.fullscreen,n.runnerOptions);return}if(e.kind===`simulator`){await Xt(e,t,n);return}await S(e).captureScreenshot(e,t,{appBundleId:n.appBundleId,fullscreen:n.fullscreen,runnerOptions:n.runnerOptions,runRunnerCommand:D})}async function Xt(e,t,r={}){if(e.kind!==`simulator`)throw new n(`UNSUPPORTED_OPERATION`,`Simulator screenshot fallback flow supports only iOS simulators`);let i={...Jt,...r.deps??{}};r.skipIosSimulatorBootCheck||await i.ensureBooted(e);let a=await i.resolveCaptureDisplay(e),o=async()=>{await i.captureWithRetry(e,t,a),await i.normalizeDensity(e,t,r.pixelDensity,a?.pointScale)},s=async()=>{};if(r.normalizeStatusBar===!0)try{s=await i.prepareStatusBarForScreenshot(e)}catch(t){nn(e,`prepare_failed`,t)}try{try{await o();return}catch(t){let n=t;if(r.skipIosSimulatorBootCheck&&on(t)){await i.ensureBooted(e);try{await o();return}catch(e){n=e}}if(!i.shouldFallbackToRunner(n))throw n;tn(e,`simctl_screenshot`,n)}let n=await i.captureWithRunner(e,t,r.appBundleId,r.fullscreen,r.runnerOptions);await i.normalizeDensity(e,t,r.pixelDensity,n?.pixelsPerPoint)}finally{await s().catch(t=>nn(e,`restore_failed`,t))}}async function Zt(e,t,n){let r=Se.fromTimeoutMs(Ue),i=[`io`,e.id,`screenshot`,...ct(n),t];await xe(async({deadline:t})=>{await T(e,i,{timeoutMs:Math.max(1e3,t?.remainingMs()??2e4)})},{maxAttempts:5,baseDelayMs:Ve,maxDelayMs:He,jitter:.2,shouldRetry:e=>an(e)},{deadline:r,phase:`ios_simulator_screenshot`})}async function U(e,t,r,i,a){if(e.kind===`device`&&!l(e)){await S(e).captureScreenshot(e,t,{appBundleId:r,fullscreen:i,runnerOptions:a,preferRunner:!0,runRunnerCommand:D});return}let o=await D(e,{command:`screenshot`,appBundleId:r,fullscreen:i,inlineScreenshot:!1},a),s=o.message;if(!s)throw new n(`COMMAND_FAILED`,`Failed to capture iOS screenshot: runner returned no file path`);let c=Kt(o);if(l(e))return await Be(s,t),c;if(e.kind===`simulator`)return await Qt(e,s,t),c;throw new n(`COMMAND_FAILED`,`Unsupported Apple screenshot target`)}async function Qt(e,t,r){let i=Se.fromTimeoutMs(b),a=`Unable to locate runner container for simulator screenshot`,o=H.get(e.id);if(o){let n=await $t(o,t,r);if(n.copied)return;a=n.error,H.delete(e.id)}for(let n of Xe){let o=await T(e,[`get_app_container`,e.id,n,`data`],{allowFailure:!0,timeoutMs:en(i,b,`runner screenshot container lookup`)});if(o.exitCode!==0){let e=o.stderr.trim();e&&(a=e);continue}let s=o.stdout.trim();if(!s){a=`simctl get_app_container returned empty output`;continue}let c=await $t(s,t,r);if(c.copied){H.set(e.id,s);return}a=c.error}throw new n(`COMMAND_FAILED`,`Failed to capture iOS screenshot: ${a}`)}async function $t(e,t,n){let r=`Runner screenshot was not found in the simulator container`;for(let i of rn(e,t))try{return await Be(i,n),{copied:!0}}catch(e){r=e instanceof Error?e.message:String(e)}return{copied:!1,error:r}}function en(e,t,r){let i=e.remainingMs();if(i>0)return i;throw new n(`COMMAND_FAILED`,`iOS ${r} timed out after ${t}ms`,{timeoutMs:t,step:r})}function tn(e,t,n){let r=x(n);g({level:`warn`,phase:`ios_screenshot_fallback`,data:{platform:e.platform,deviceKind:e.kind,deviceId:e.id,from:t,to:`runner`,...r}})}function nn(e,t,n){g({level:`warn`,phase:`ios_screenshot_status_bar_${t}`,data:{platform:e.platform,deviceKind:e.kind,deviceId:e.id,...x(n)}})}function rn(e,t){let n=A.resolve(e),r=t.trim();if(!r)return[];let i=[],a=new Set,o=e=>{let t=A.normalize(e);a.has(t)||(a.add(t),i.push(t))},s=r.replace(/^\/+/,``),c=s.replaceAll(`\\`,`/`);if(s&&o(A.join(n,s)),A.isAbsolute(r)&&o(A.normalize(r)),c.startsWith(`tmp/`))o(A.join(n,c));else{let e=c.lastIndexOf(`/tmp/`);if(e>=0){let t=c.slice(e+1);o(A.join(n,t))}}let l=A.basename(r);return l&&o(A.join(n,`tmp`,l)),i}function an(e){if(!(e instanceof n)||e.code!==`COMMAND_FAILED`)return!1;let t=Ke(e);return t.includes(`timeout waiting for screen surfaces`)||t.includes(`nsposixerrordomain`)&&t.includes(`code=60`)&&t.includes(`screenshot`)||t.includes(`timed out`)&&t.includes(`screenshot`)}function on(e){if(!(e instanceof n)||e.code!==`COMMAND_FAILED`)return!1;let t=Ke(e);return t.includes(`not booted`)||t.includes(`current state: shutdown`)||t.includes(`current state is shutdown`)||t.includes(`current state=shutdown`)||t.includes(`state: shutdown`)||t.includes(`state=shutdown`)}async function sn(e,t,n,r){let i=r??await cn(e),a=Fe(await Pe(t),i,n);a&&await De(t,a.width,a.height)}async function cn(e){let t=V.get(e.id);if(t!==void 0)return t;let r=await T(e,[`getenv`,e.id,`SIMULATOR_MAINSCREEN_SCALE`],{timeoutMs:We}),i=Number(r.stdout.trim());if(!Number.isFinite(i)||i<=0)throw new n(`COMMAND_FAILED`,`Failed to read iOS simulator screenshot scale from SIMULATOR_MAINSCREEN_SCALE`);return V.set(e.id,i),i}function ln(e){return!(e instanceof n)||e.details?.runnerErrorCode!==`SCROLL_KEYBOARD_OCCLUDES_SURFACE`?e:new n(e.code,e.message,{...e.details,...re})}function un(e){let t=e?.amount!==void 0||e?.pixels!==void 0;return{...e,...t?{}:{amount:ge},durationMs:e?.durationMs??400,releaseBehavior:e?.releaseBehavior??`controlled`}}function dn(e,t,n,r={includeDuration:!0}){let i=W(e.referenceWidth),a=W(e.referenceHeight);if(i===void 0||a===void 0)return G(e,{amount:n?.amount});let o=ne({direction:t,amount:n?.amount,pixels:n?.pixels,referenceWidth:i,referenceHeight:a});return G(e,{amount:n?.amount,pixels:o.pixels,durationMs:r?.includeDuration?n?.durationMs:void 0,preferProvidedPixels:!0})}function fn(e,t={}){return{...e?.amount===void 0?{}:{amount:e.amount},...e?.pixels===void 0?{}:{pixels:e.pixels},...t.includeDuration!==!1&&e?.durationMs!==void 0?{durationMs:e.durationMs}:{},...t.includeReleaseBehavior!==!1&&e?.releaseBehavior!==void 0?{scrollReleaseBehavior:e.releaseBehavior}:{}}}function W(e){return typeof e==`number`&&Number.isFinite(e)?e:void 0}function G(e,t){let{x1:n,y1:r,x2:i,y2:a}=mn(e),o=W(e.referenceWidth),s=W(e.referenceHeight),c=pn(t,n!==void 0&&i!==void 0?Math.round(Math.abs(i-n)):void 0,r!==void 0&&a!==void 0?Math.round(Math.abs(a-r)):void 0),l=W(e.keyboardMinY);return{...n===void 0?{}:{x1:n},...r===void 0?{}:{y1:r},...i===void 0?{}:{x2:i},...a===void 0?{}:{y2:a},...o===void 0?{}:{referenceWidth:o},...s===void 0?{}:{referenceHeight:s},...e.keyboardAvoided===!0?{keyboardAvoided:!0}:{},...l===void 0?{}:{keyboardMinY:l},...t?.amount===void 0?{}:{amount:t.amount},...c===void 0?{}:{pixels:c},...t?.durationMs===void 0?{}:{durationMs:t.durationMs}}}function pn(e,t,n){if(e?.preferProvidedPixels&&e.pixels!==void 0)return e.pixels;if(t!==void 0&&t>0)return t;if(n!==void 0&&n>0)return n}function mn(e){let t=W(e.x),n=W(e.y),r=W(e.x2),i=W(e.y2);return{...t===void 0?{}:{x1:t},...n===void 0?{}:{y1:n},...r===void 0?{}:{x2:r},...i===void 0?{}:{y2:i}}}async function hn(e,t,n,r,i,a){return dn(await e(t,{command:`desktopScroll`,direction:i,...fn(a,{includeDuration:!0,includeReleaseBehavior:!1}),appBundleId:n.appBundleId},r),i,a,{includeDuration:!0})}function K(e,t,n){return{command:`remotePress`,remoteButton:e,...n===void 0?{}:{durationMs:n},...t===void 0?{}:{appBundleId:t}}}function gn(e){return e===`system`?`backSystem`:`backInApp`}function _n(e,t){let n={signal:t.signal,verbose:t.verbose,logPath:t.logPath,traceLogPath:t.traceLogPath,requestId:t.requestId,iosXctestrunFile:t.iosXctestrunFile,iosXctestDerivedDataPath:t.iosXctestDerivedDataPath,iosXctestEnvDir:t.iosXctestEnvDir,runnerLeaseContext:t.runnerLeaseContext};return{runnerOpts:n,overrides:{tap:async(r,i)=>await D(e,J(e,t,r,i),n),pressPoint:async(r,i)=>await vn(e,t,n,r,i),tapElementSelector:async r=>await D(e,{command:`tap`,selectorKey:r.key,selectorValue:r.value,allowNonHittableCoordinateFallback:r.allowNonHittableCoordinateFallback,...r.expectedPoint?{x:r.expectedPoint.x,y:r.expectedPoint.y}:{},...s(e)?{synthesized:!0}:{},appBundleId:t.appBundleId},n),doubleTap:async(r,i)=>{let a=await D(e,C([{kind:`doubleTap`,x:r,y:i}],t.appBundleId),n);return w(a),a},appState:async()=>Cn(await D(e,{command:`appState`,appBundleId:t.appBundleId},n)),longPress:async(r,i,a)=>await D(e,{command:`longPress`,x:r,y:i,durationMs:a,appBundleId:t.appBundleId},n),focus:async(r,i)=>await D(e,J(e,t,r,i),n),type:async(r,i)=>Sn(await D(e,{command:`type`,text:r,delayMs:i,textEntryMode:r===`
-`?void 0:`append`,appBundleId:t.appBundleId},n)),fill:async(r,i,a,o,s)=>await D(e,{command:`type`,x:r,y:i,text:a,delayMs:o,textEntryMode:`replace`,...s?.allowNonHittableCoordinateFallback?{allowNonHittableCoordinateFallback:!0}:{},appBundleId:t.appBundleId},n),scroll:async(r,i)=>await On(D,e,t,n,r,i),performGesture:async r=>await En(e,t,n,r),gestureViewport:async()=>Tn(await D(e,{command:`gestureViewport`,appBundleId:t.appBundleId},n))}}}async function vn(e,t,n,r,i){let a=l(e)?d(i.surface):void 0;return a?await yn(t,r,i,a):i.button===`primary`?i.count===1?await xn(e,t,n,r,i):await qe(e,r,i,t.appBundleId,async t=>await D(e,t,n)):await bn(e,t,n,r,i.button)}async function yn(e,t,r,i){if(r.button!==`primary`)throw new n(`UNSUPPORTED_OPERATION`,`${r.button} click is not supported on macOS ${i} sessions.`);let{runMacOsPressAction:a}=await import(`./helper.js`).then(e=>e.t),o=await a(t.x,t.y,{bundleId:e.appBundleId,surface:i,holdMs:r.holdMs,clicks:r.count,doubleClick:r.doubleTap,intervalMs:r.intervalMs,signal:e.signal});return o.holdMs===void 0?{}:{holdMs:o.holdMs}}async function bn(e,t,n,r,i){return await D(e,{command:`mouseClick`,x:r.x,y:r.y,button:i,appBundleId:t.appBundleId},n)}async function xn(e,t,n,r,i){if(i.doubleTap){let i=await D(e,C([{kind:`doubleTap`,x:r.x,y:r.y}],t.appBundleId),n);return w(i),i}return i.holdMs>0?await D(e,{command:`longPress`,x:r.x,y:r.y,durationMs:i.holdMs,appBundleId:t.appBundleId},n):await D(e,J(e,t,r.x,r.y),n)}function Sn(e){let t=e.textEntryRoute;return wn(t)?{textEntryRoute:t}:{}}function Cn(t){let n=t.applicationState;return e(n)?{applicationState:n}:{}}function wn(e){return typeof e==`string`&&Ie.includes(e)}function Tn(e){let t=q(e.x),r=q(e.y),i=q(e.x2),a=q(e.y2);if(t===void 0||r===void 0||i===void 0||a===void 0||i<=0||a<=0)throw new n(`COMMAND_FAILED`,`Apple runner returned an invalid gesture viewport`);return{x:t,y:r,width:i,height:a}}function q(e){return typeof e==`number`&&Number.isFinite(e)?e:void 0}async function En(e,t,n,r){if(r.topology===`two`&&lt(e,r.intent),r.topology===`single`&&l(e)){let{start:i,end:a}=Ce(r);return await D(e,{command:`drag`,x:i.x,y:i.y,x2:a.x,y2:a.y,durationMs:r.durationMs,appBundleId:t.appBundleId},n)}if(r.topology===`single`&&u(e)){let{start:i,end:a}=Ce(r);return await D(e,{command:`swipe`,direction:Dn(i,a),appBundleId:t.appBundleId},n)}return await D(e,{command:`gesture`,gesturePlan:r,appBundleId:t.appBundleId},n)}function Dn(e,t){let n=t.x-e.x,r=t.y-e.y;return Math.abs(n)>=Math.abs(r)?n>=0?`right`:`left`:r>=0?`down`:`up`}function J(e,t,n,r){return{command:`tap`,x:n,y:r,...s(e)?{synthesized:!0}:{},appBundleId:t.appBundleId}}async function On(e,t,n,r,i,a){if(me(a?.durationMs,{invalidMessage:`scroll durationMs must be a non-negative integer at most ${he}`}),u(t))return G(await e(t,K(i,n.appBundleId,a?.durationMs),r),{amount:a?.amount,durationMs:a?.durationMs});if(ie(a??{}),l(t))return await hn(e,t,n,r,i,a);let o=un(a),s;try{s=await e(t,{command:`scroll`,direction:i,...fn(o),appBundleId:n.appBundleId},r)}catch(e){throw ln(e)}return dn(s,i,o)}function Y(e,t,n){if(l(e)){let e=n?.surface===`frontmost-app`?{surface:n.surface}:{bundleId:n?.appBundleId,surface:n?.surface};return async t=>await tt(t,e)}return async(r,i)=>await D(e,{command:`alert`,action:r,appBundleId:n?.appBundleId,timeoutMs:i},t)}async function kn(e,t,n){return await Y(e,t,n)(`get`,ae)}async function An(e,t,r){let i=Y(e,t,r),a=r?.timeoutMs??1e4,o=Date.now(),s=!0;for(;Date.now()-o<a;){try{let e=s?a:Mn(o,a);return s=!1,await i(`get`,e)}catch(e){if(!X(e))throw e}await ye(300)}throw new n(`COMMAND_FAILED`,`alert wait timed out`)}async function jn(e,t,n,r){let i=Y(e,t,r),a=ee(e)?ae:f,o=Date.now(),s,c=!0;for(;Date.now()-o<f;){try{let e=c?a:Mn(o,f);return c=!1,await i(n,e)}catch(e){if(s=e,!X(e))break}await ye(300)}throw Nn(s)}function Mn(e,t){return Math.max(1,t-(Date.now()-e))}function Nn(e){return!(e instanceof n)||!X(e)?e:new n(e.code,e.message,{...e.details??{},hint:`If the permission sheet is visible in snapshot or screenshot but alert reports no alert, take a scoped snapshot around the visible button label and use press @ref.`})}function X(e){if(!(e instanceof n))return!1;let t=e.details??{};return t.runnerErrorCode===`ALERT_NOT_FOUND`||t.reason===`alert-not-found`}const Pn={0:`unknown`,1:`notRunning`,2:`runningBackgroundSuspended`,3:`runningBackground`};function Fn(e,t){if(typeof e!=`object`||!e||Array.isArray(e))return;let n={...e},i=n.reason;if(!r(i))return;let a=n.priorState;if(typeof a!=`number`||!Number.isInteger(a))return;let o=Pn[a];o===void 0&&t?.({reason:i,rawPriorState:a});let s=n.otherActiveApplicationPid;return{reason:i,priorState:o??`unknown`,...typeof s==`number`&&Number.isInteger(s)&&s>0?{otherActiveApplicationPid:s}:{}}}function In(e){let t=Ln(e.systemSurface),n=a(e.keyboard),r=Fn(e.targetActivation,e=>Ye({level:`debug`,phase:`ios_runner_target_activation_prior_state_unmapped`,data:e}));return{nodes:Array.isArray(e.nodes)?e.nodes:void 0,truncated:typeof e.truncated==`boolean`?e.truncated:void 0,quality:Oe(e.snapshotQuality),qualityPayload:Vn(e.qualityPayload,t),runnerFatal:e.runnerFatal===!0,...n?{keyboard:n}:{},...t?{systemSurface:t}:{},...r?{targetActivation:r}:{},message:typeof e.message==`string`&&e.message.trim().length>0?e.message:void 0}}function Ln(e){if(!Wn(e)||typeof e.bundleId!=`string`)return;let t=Me(e.bundleId);return t&&{bundleId:t.bundleId,kind:t.kind}}function Rn(e,t,n){let r=n.nodes??[];if(n.runnerFatal===!0||r.length===0&&n.qualityPayload===void 0)return r;let i=Ee({raw:t?.raw,interactiveOnly:t?.interactiveOnly,depth:t?.depth,scope:t?.scope,customActions:t?.customActions}),a=Hn(r,n.qualityPayload?.nodes),o={stage:`presented`,presentation:{producer:`apple-runner`,intent:`full`,payload:{nodes:r,truncated:n.truncated??!1,...n.quality?.effectiveDepth===void 0?{}:{effectiveDepth:n.quality.effectiveDepth}},...n.qualityPayload?{qualityPayload:n.qualityPayload}:{}},validation:{presentationKey:Te(i),viewport:a,hittability:{kind:`available`},lineage:{targetId:e},residue:[]}};try{return Le(o,i).nodes}catch(e){zn(e,n)}}function zn(e,t){let r=t.quality;if(e instanceof y&&Ae(r))throw new n(`COMMAND_FAILED`,e.message,{...v(e),...t.systemSurface?{systemSurface:t.systemSurface}:{},snapshotQuality:{state:r.state,backend:r.backend,...r.reason?{reason:r.reason}:{},...r.reasonCode?{reasonCode:r.reasonCode}:{}},hint:Bn(t.systemSurface,r)},e);Z(e,t.systemSurface)}function Bn(e,t){return[e?`${e.bundleId} hosts the surface presented over the app, and this capture targeted that surface.`:void 0,...ke(t,[])].filter(e=>e!==void 0).join(` `)}function Vn(e,t){if(e!==void 0)return(!Wn(e)||!Array.isArray(e.nodes)||typeof e.truncated!=`boolean`)&&Z(new y(`invalid-quality-payload`,`iOS runner returned an invalid quality payload`),t),e.scope!==void 0&&e.scope!==null&&Z(new y(`invalid-quality-payload`,`iOS runner quality payload must be unscoped`,{field:`scope`}),t),{nodes:e.nodes,truncated:e.truncated,scope:null}}function Hn(e,t){return Ne(Un(t),{fallbackToLargestRoot:!0})??Ne(Un(e),{fallbackToLargestRoot:!0})??{kind:`missing`,reason:`not-provided`}}function Un(e){return e?.filter(e=>e.parentIndex===void 0)??[]}function Wn(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Z(e,t){throw e instanceof y?new n(`COMMAND_FAILED`,e.message,{...v(e),...t?{systemSurface:t}:{}},e):e}function Gn(e,t,r){if(e.appleOs===`watchos`)throw new n(`UNSUPPORTED_PLATFORM`,`watchOS is not supported: XCUITest cannot drive watchOS UI, so this device has no runner backend.`);let{overrides:i,runnerOpts:a}=_n(e,t),o={open:(t,n)=>Ze(e,t,{appBundleId:n?.appBundleId,launchConsole:n?.launchConsole,launchArgs:n?.launchArgs,terminateRunningApp:n?.terminateRunningApp,url:n?.url,runnerOptions:a}),openDevice:()=>Qe(e),close:t=>$e(e,t,a),screenshot:(t,n)=>nr(e,t,n,a),snapshot:async t=>await Kn(e,t,a),readTextAtPoint:async(t,n)=>{let r=l(e)?d(n?.surface):void 0;return r?await rr(t,r,n?.appBundleId):await ir(e,t,n,a)},findText:async(t,n)=>({found:(await D(e,{command:`findText`,text:t,appBundleId:n?.appBundleId},n?.signal?{...a,signal:n.signal}:a))?.found===!0}),back:async n=>{if(u(e)){await D(e,K(`menu`,t.appBundleId),a);return}await D(e,{command:gn(n),appBundleId:t.appBundleId},a)},home:async()=>{if(u(e)){await D(e,K(`home`,t.appBundleId),a);return}await D(e,{command:`home`,appBundleId:t.appBundleId},a)},setOrientation:async r=>{let i=er(await D(e,{command:`rotate`,orientation:r,appBundleId:t.appBundleId},a));if(i!==r)throw new n(`COMMAND_FAILED`,`iOS runner observed ${i} after requesting ${r}`,{requestedOrientation:r,observedOrientation:i});return{orientation:i}},appSwitcher:async()=>{await D(e,{command:`appSwitcher`,appBundleId:t.appBundleId},a)},actionButton:async()=>{await D(e,{command:`actionButton`,appBundleId:t.appBundleId},a)},tvRemote:async(n,r)=>{await D(e,K(be(n),t.appBundleId,r),a)},keyboardDismiss:async()=>{let n=await D(e,{command:`keyboardDismiss`,appBundleId:t.appBundleId},a);return{kind:`mechanism`,wasVisible:Q(n,`wasVisible`),dismissed:Q(n,`dismissed`),visible:Q(n,`visible`),mechanism:$n(n,`keyboardDismissMechanism`)}},keyboardEnter:async()=>{let n=await D(e,{command:`keyboardReturn`,appBundleId:t.appBundleId},a);return{kind:`visibility-echo`,visible:Q(n,`visible`),wasVisible:Q(n,`wasVisible`)}},readClipboard:()=>ft(e),writeClipboard:t=>pt(e,t,a),setSetting:(t,n,r,i)=>Dt(e,t,n,r,i),readSetting:t=>kt(e,t),readAlert:t=>kn(e,a,t),awaitAlert:t=>An(e,a,t),acceptAlert:t=>jn(e,a,`accept`,t),dismissAlert:t=>jn(e,a,`dismiss`,t),...i};return r?tr(e,t,o,r):o}async function Kn(e,t,n){let r=l(e)?d(t?.surface):void 0;return r?await ut({...t,surface:r},t?.signal):await qn(e,t,n)}async function qn(e,t,n){let r=In(await ve(`snapshot_capture`,async()=>await D(e,{command:`snapshot`,appBundleId:t?.appBundleId,interactiveOnly:t?.interactiveOnly,preferredBackend:t?.preferredBackend,customActions:t?.customActions,depth:t?.depth,scope:t?.scope,raw:t?.raw},Qn(n,t?.signal)),{backend:`xctest`}));Jn(e,t,r);let i=Yn(r);return{nodes:Xn(e,t,r),truncated:r.truncated??!1,backend:`xctest`,producer:`apple-runner`,...r.quality?{quality:r.quality}:{},...r.systemSurface?{systemSurface:r.systemSurface}:{},...r.keyboard?{keyboard:r.keyboard}:{},...r.targetActivation?{targetActivation:r.targetActivation}:{},...i.length>0?{warnings:i}:{}}}function Jn(e,t,r){if(!((r.nodes?.length??0)>0)&&!Zn(t,r.quality)&&e.kind===`simulator`)throw new n(`COMMAND_FAILED`,`XCTest snapshot returned 0 nodes on iOS simulator.`)}function Yn(e){let t=[];return!e.quality&&e.message&&t.push(e.message),e.systemSurface&&t.push(je(e.systemSurface.bundleId)),e.targetActivation&&t.push(dt(e.targetActivation)),t}function Xn(e,t,n){return l(e)?n.nodes??[]:Rn(e.id,t,n)}function Zn(e,t){return te(e?.scope)!==null&&t!==void 0&&t.state!==`sparse`}function Qn(e,t){return t?{...e,signal:e.signal?AbortSignal.any([e.signal,t]):t}:e}function Q(e,t){let n=e[t];return typeof n==`boolean`?n:void 0}function $n(e,t){let n=e[t];return typeof n==`string`?n:void 0}function er(e){let t=e.orientation;if(typeof t==`string`&&_e.includes(t))return t;throw new n(`COMMAND_FAILED`,`iOS runner returned an invalid orientation result`,{orientation:t})}function tr(e,t,n,r){let i={...n,open:async()=>$(`open`),openDevice:async()=>$(`openDevice`),close:async()=>$(`close`),screenshot:async()=>$(`screenshot`),readClipboard:async()=>$(`readClipboard`),setSetting:async()=>$(`setSetting`),readSetting:async()=>$(`readSetting`)};return we(i,n=>Je(r,{deviceId:e.id,requestId:t.requestId},n))}function $(e){throw new n(`UNSUPPORTED_OPERATION`,`${e} uses local Apple tooling (simctl/devicectl), which an injected runner transport cannot reach; the provider session must supply its own ${e} implementation.`)}async function nr(e,t,r={},a){let o=l(e)?d(r.surface):void 0;if(o){if(r.fullscreen)throw new n(`INVALID_ARGS`,`screenshot --fullscreen is not accepted on the macOS ${o} surface: it always captures the main display`,{reason:i.macOsHelperSurfaceFixedFrame,surface:o});await nt(t,{surface:o});return}if(r.captureBackend===`runner`){await U(e,t,r.appBundleId,r.fullscreen,a);return}await Yt(e,t,{appBundleId:r.appBundleId,pixelDensity:r.pixelDensity,fullscreen:r.fullscreen,runnerOptions:a,normalizeStatusBar:r.normalizeStatusBar,skipIosSimulatorBootCheck:r.skipIosSimulatorBootCheck})}async function rr(e,t,n){let{runMacOsReadTextAction:r}=await import(`./helper.js`).then(e=>e.t);return(await r(e.x,e.y,{bundleId:n,surface:t})).text}async function ir(e,t,n,r){let i=await D(e,{command:`readText`,x:t.x,y:t.y,appBundleId:n?.appBundleId},n?.signal?{...r,signal:n.signal}:r);return typeof i.text==`string`?i.text:typeof i.message==`string`?i.message:void 0}export{Gn as createAppleInteractor};
+`).replace(/\n$/,``))}async function pt(e,t,n){if(l(e)){await at(t);return}if(O(e,`clipboard`),u(e)){let r=n?.signal;await k(e,{signal:r}),_(await T(e,[`pbcopy`,e.id],{allowFailure:!0,stdin:t,signal:r}),`Failed to write tvOS simulator clipboard`);return}await D(e,{command:`pasteboardWrite`,text:t},n)}function j(e,n){if(!c(e))throw new t(`UNSUPPORTED_OPERATION`,n.message,{deviceId:e.id,appleOs:o(e),deviceKind:e.kind,reason:n.reason,hint:n.hint})}async function mt(e,t){j(e,m);let n=de(t);return await T(e,[`ui`,e.id,`content_size`,n]),oe(n,n)}async function ht(e){j(e,m),await k(e);let n=_(await T(e,[`ui`,e.id,`content_size`],{allowFailure:!0}),`Failed to read iOS content size category`),r=n.stdout.trim(),i=se(r);if(i===void 0)throw new t(`COMMAND_FAILED`,`iOS simulator reported an unknown text size: ${r||`(empty)`}`,{deviceId:e.id,stdout:n.stdout,stderr:n.stderr,hint:"Boot the simulator, or run `xcrun simctl ui <device> content_size` to see what it reports."});return oe(i,r)}const gt=[`--time`,`9:41`,`--dataNetwork`,`wifi`,`--wifiMode`,`active`,`--wifiBars`,`3`,`--batteryState`,`charged`,`--batteryLevel`,`100`],_t={0:`hide`,1:`wifi`,6:`3g`,7:`4g`,8:`lte`,9:`lte-a`,10:`lte+`,11:`5g`,12:`5g+`,13:`5g-uwb`,14:`5g-uc`},vt={1:`searching`,2:`failed`,3:`active`},yt={0:`notSupported`,1:`searching`,2:`failed`,3:`active`},M=new Set;async function bt(e){let t=null,n=!1;if(St(e))n=!0;else try{t=await Ct(e),n=!0}catch(t){R(e,`snapshot_failed`,t)}try{(!n||t)&&await I(e),await L(e,gt)}catch(t){R(e,`prepare_failed`,t)}return async()=>{await xt(e,n?t:null)}}async function xt(e,t){if(await I(e),!t){P(e);return}await L(e,Tt(t)),N(e)}function N(e){M.delete(F(e))}function P(e){M.add(F(e))}function St(e){return M.has(F(e))}function F(e){return`${e.platform}:${e.kind}:${e.id}`}async function Ct(e){return wt(_(await T(e,[`status_bar`,e.id,`list`],{allowFailure:!0}),`Failed to read simulator status bar overrides`).stdout)}async function I(e){await T(e,[`status_bar`,e.id,`clear`])}async function L(e,t){t.length!==0&&await T(e,[`status_bar`,e.id,`override`,...t])}function wt(e){let n={},r=e.split(`
+`).map(e=>e.trim()).filter(e=>e.length>0&&e!==`Current Status Bar Overrides:`&&!/^=+$/.test(e));for(let e of r){let r=/^DataNetworkType:\s+(\d+)$/.exec(e);if(r){let e=Number(r[1]),i=_t[e];if(!i)throw new t(`COMMAND_FAILED`,`Unsupported simulator data network type: ${e}`);n.dataNetwork=i;continue}let i=/^WiFi Mode:\s+(\d+),\s+WiFi Bars:\s+(\d+)$/.exec(e);if(i){let e=vt[Number(i[1])];e&&(n.wifiMode=e),n.wifiBars=i[2];continue}let a=/^Cell Mode:\s+(\d+),\s+Cell Bars:\s+(\d+)$/.exec(e);if(a){let e=Number(a[1]),r=yt[e];if(!r)throw new t(`COMMAND_FAILED`,`Unsupported simulator cellular mode: ${e}`);n.cellularMode=r,n.cellularBars=a[2];continue}let o=/^Operator Name:\s*(.*)$/.exec(e);if(o){n.operatorName=o[1]??``;continue}}return Object.keys(n).length===0?null:n}function Tt(e){let t=[];return e.dataNetwork&&t.push(`--dataNetwork`,e.dataNetwork),e.wifiMode&&t.push(`--wifiMode`,e.wifiMode),e.wifiBars!==void 0&&(e.dataNetwork===`wifi`||e.wifiMode)&&t.push(`--wifiBars`,e.wifiBars),e.cellularMode&&t.push(`--cellularMode`,e.cellularMode),e.cellularBars!==void 0&&(e.cellularMode||Et(e.dataNetwork)||e.operatorName!==void 0)&&t.push(`--cellularBars`,e.cellularBars),e.operatorName!==void 0&&t.push(`--operatorName`,e.operatorName),t}function Et(e){return!!(e&&e!==`hide`&&e!==`wifi`)}function R(e,t,n){g({level:`warn`,phase:`ios_screenshot_status_bar_${t}`,data:{platform:e.platform,deviceKind:e.kind,deviceId:e.id,...x(n)}})}async function Dt(e,n,r,i,a){if(l(e)){let e=n.toLowerCase();if(e===`appearance`){await it(r);return}if(e===`permission`){let e=h(r);if(e===`deny`)throw new t(`INVALID_ARGS`,le(`permission`));let n=jt(a?.permissionTarget);return await $e(e,n)}throw new t(`INVALID_ARGS`,le(n))}O(e,`settings`),await k(e);let o=n.toLowerCase();switch(o){case`clear-app-state`:{if(r.toLowerCase()!==`clear`)throw new t(`INVALID_ARGS`,`settings clear-app-state only supports clear.`);if(!i)throw new t(`INVALID_ARGS`,`settings clear-app-state requires an app id or an active app session.`);let n=await At(e,i);return{bundleId:n.bundleId,containerPath:n.containerPath,cleared:!0}}case`reset-keychain`:if(r.toLowerCase()!==`clear`)throw new t(`INVALID_ARGS`,`settings reset-keychain only supports clear.`);return await T(e,[`keychain`,e.id,`reset`]),{scope:`simulator`,cleared:!0,message:`Reset the whole iOS simulator keychain. This clears keychain-backed credentials for every installed app, not just the app under test.`};case`wifi`:{let t=p(r)?`active`:`failed`;await T(e,[`status_bar`,e.id,`override`,`--wifiMode`,t]),N(e);return}case`airplane`:p(r)?(await T(e,[`status_bar`,e.id,`override`,`--dataNetwork`,`hide`,`--wifiMode`,`failed`,`--wifiBars`,`0`,`--cellularMode`,`failed`,`--cellularBars`,`0`,`--operatorName`,``]),N(e)):(await T(e,[`status_bar`,e.id,`clear`]),P(e));return;case`location`:{if(r.toLowerCase()===`set`){let{latitude:t,longitude:n}=pe(a);return await T(e,[`location`,e.id,`set`,`${t},${n}`]),{latitude:t,longitude:n}}let n=p(r);if(!i)throw new t(`INVALID_ARGS`,`location setting requires an active app in session`);let o=n?`grant`:`revoke`;await T(e,[`privacy`,e.id,o,`location`,i]);return}case`faceid`:case`touchid`:{j(e,ue);let t=o,n=Pt[t];await Ht(e,Vt(r,t),{settingName:t,notificationModality:n.notificationModality});return}case`appearance`:{let t=await Mt(e,r);await T(e,[`ui`,e.id,`appearance`,t]);return}case`text-size`:return await mt(e,r);case`permission`:if(!i)throw new t(`INVALID_ARGS`,`permission setting requires an active app in session`);await It(e,Ft(h(r)),Bt(a?.permissionTarget,a?.permissionMode),i);return;default:throw new t(`INVALID_ARGS`,`Unsupported setting: ${n}`)}}const Ot={"text-size":ht};async function kt(e,t){return await Ot[t](e)}async function At(e,n){if(!ee(e)||e.kind!==`simulator`)throw new t(`UNSUPPORTED_OPERATION`,`Clearing app state is currently supported only on iOS simulators.`);let r=await nt(e,n);await k(e),await Qe(e,r);let i=_(await T(e,[`get_app_container`,e.id,r,`data`],{allowFailure:!0}),`simctl get_app_container failed for ${r}`).stdout.trim();if(!i)throw new t(`COMMAND_FAILED`,`simctl get_app_container returned an empty data container path for ${r}`);let a=await Re(i);return await Promise.all(a.map(e=>Le(A.join(i,e)))),{bundleId:r,containerPath:i}}function jt(e){let n=e?.trim().toLowerCase();if(n===`accessibility`||n===`screen-recording`||n===`input-monitoring`)return n;throw new t(`INVALID_ARGS`,`Unsupported macOS permission target. Use accessibility|screen-recording|input-monitoring.`)}async function Mt(e,n){let r=ce(n);if(r!==`toggle`)return r;let i=_(await T(e,[`ui`,e.id,`appearance`],{allowFailure:!0}),`Failed to read current iOS appearance`),a=Nt(i.stdout,i.stderr);if(!a)throw new t(`COMMAND_FAILED`,`Unable to determine current iOS appearance for toggle`,{stdout:i.stdout,stderr:i.stderr});return a===`dark`?`light`:`dark`}function Nt(e,t){let n=/\b(light|dark|unsupported|unknown)\b/i.exec(`${e}\n${t}`);if(!n)return null;let r=n[1]?.toLowerCase();return r===`dark`?`dark`:r===`light`?`light`:null}const Pt={faceid:{notificationModality:`pearl`},touchid:{notificationModality:`fingerTouch`}};function Ft(e){return e===`deny`?`revoke`:e}async function It(e,t,n,r){try{await T(e,[`privacy`,e.id,t,n,r])}catch(i){throw Lt(i)?Rt(e,t,n,r,i):i}}function Lt(e){if(!(e instanceof t)||e.code!==`COMMAND_FAILED`)return!1;let n=String(e.details?.stderr??``).toLowerCase();return/failed to (set|grant|revoke|reset) access/.test(n)&&n.includes(`operation not permitted`)}function Rt(e,n,r,i,a){return n===`reset`?new t(`UNSUPPORTED_OPERATION`,`iOS simulator does not support resetting ${r} permission via simctl privacy on this runtime.`,{deviceId:e.id,appBundleId:i,hint:`Use reinstall to force a fresh prompt, or reset simulator content and settings.`},a):new t(`UNSUPPORTED_OPERATION`,`iOS simulator does not support setting ${r} permission via simctl privacy on this runtime.`,{deviceId:e.id,appBundleId:i,hint:"Privacy support varies by Xcode runtime: run `xcrun simctl privacy help` for its documented services, or use the `all` target, which applies the action to every service this runtime can change."},a)}const zt={all:`all`,camera:`camera`,microphone:`microphone`,contacts:`contacts`,"contacts-limited":`contacts-limited`,notifications:`notifications`,calendar:`calendar`,location:`location`,"location-always":`location-always`,"media-library":`media-library`,motion:`motion`,reminders:`reminders`,siri:`siri`};function Bt(e,n){let r=fe(e);if(r===`photos`){let e=n?.trim().toLowerCase();if(!e||e===`full`)return`photos`;if(e===`limited`)return`photos-add`;throw new t(`INVALID_ARGS`,`Invalid photos mode: ${n}. Use full|limited.`)}if(n?.trim())throw new t(`INVALID_ARGS`,`Permission mode is only supported for photos. Received: ${n}.`);return zt[r]}function Vt(e,n){let r=e.trim().toLowerCase();if(r===`match`)return`match`;if(r===`nonmatch`)return`nonmatch`;if(r===`enroll`)return`enroll`;if(r===`unenroll`)return`unenroll`;throw new t(`INVALID_ARGS`,`Invalid ${n} state: ${e}. Use match|nonmatch|enroll|unenroll.`)}async function Ht(e,r,i){let a=E(e,Gt(e.id,r,i.notificationModality)),o=await We(a,{allowFailure:!0}),s=[];if(o.exitCode!==0)s.push({args:a,stderr:o.stderr,stdout:o.stdout,exitCode:o.exitCode});else{let t=Ut(r);if(t!==void 0){let n=await Wt(e);if(n.state===t)return;s.push({args:n.args,stderr:n.stderr,stdout:n.stdout,exitCode:n.exitCode})}else return}throw new t(`COMMAND_FAILED`,`Failed to simulate ${i.settingName}.`,{deviceId:e.id,action:r,setting:i.settingName,attempts:n(s)})}const z=`com.apple.BiometricKit.enrollmentChanged`;function Ut(e){if(e===`enroll`)return`1`;if(e===`unenroll`)return`0`}async function Wt(e){let t=E(e,[`spawn`,e.id,`notifyutil`,`-g`,z]),n=await We(t,{allowFailure:!0}),r=n.stdout.split(`
+`).map(e=>e.trim().split(/\s+/)).find(e=>e[0]===z)?.[1];return{args:t,stderr:n.stderr,stdout:n.stdout,exitCode:n.exitCode,state:n.exitCode===0?r:void 0}}function Gt(e,t,n){let r=[`spawn`,e,`notifyutil`];switch(t){case`match`:return[...r,`-p`,`com.apple.BiometricKit_Sim.${n}.match`];case`nonmatch`:return[...r,`-p`,`com.apple.BiometricKit_Sim.${n}.nomatch`];case`enroll`:return[...r,`-s`,z,`1`,`-p`,z];case`unenroll`:return[...r,`-s`,z,`0`,`-p`,z]}}function Kt(e){let t=e.screenshotMetadata;if(!t||typeof t!=`object`||Array.isArray(t))return;let n=t,r=B(n.displayID),i=B(n.pixelWidth),a=B(n.pixelHeight),o=qt(n.pixelsPerPoint);if(r!==void 0&&i!==void 0&&a!==void 0&&o!==void 0)return Object.freeze({displayID:r,pixelWidth:i,pixelHeight:a,pixelsPerPoint:o})}function B(e){return typeof e==`number`&&Number.isInteger(e)&&e>0?e:void 0}function qt(e){return typeof e==`number`&&Number.isFinite(e)&&e>0?e:void 0}const Jt={ensureBooted:k,prepareStatusBarForScreenshot:bt,resolveCaptureDisplay:ot,captureWithRetry:Zt,normalizeDensity:sn,captureWithRunner:U,shouldFallbackToRunner:an},V=new Map,H=new Map;async function Yt(e,t,n={}){if(l(e)){await U(e,t,n.appBundleId,n.fullscreen,n.runnerOptions);return}if(e.kind===`simulator`){await Xt(e,t,n);return}await S(e).captureScreenshot(e,t,{appBundleId:n.appBundleId,fullscreen:n.fullscreen,runnerOptions:n.runnerOptions,runRunnerCommand:D})}async function Xt(e,n,r={}){if(e.kind!==`simulator`)throw new t(`UNSUPPORTED_OPERATION`,`Simulator screenshot fallback flow supports only iOS simulators`);let i={...Jt,...r.deps??{}};r.skipIosSimulatorBootCheck||await i.ensureBooted(e);let a=await i.resolveCaptureDisplay(e),o=async()=>{await i.captureWithRetry(e,n,a),await i.normalizeDensity(e,n,r.pixelDensity,a?.pointScale)},s=async()=>{};if(r.normalizeStatusBar===!0)try{s=await i.prepareStatusBarForScreenshot(e)}catch(t){nn(e,`prepare_failed`,t)}try{try{await o();return}catch(t){let n=t;if(r.skipIosSimulatorBootCheck&&on(t)){await i.ensureBooted(e);try{await o();return}catch(e){n=e}}if(!i.shouldFallbackToRunner(n))throw n;tn(e,`simctl_screenshot`,n)}let t=await i.captureWithRunner(e,n,r.appBundleId,r.fullscreen,r.runnerOptions);await i.normalizeDensity(e,n,r.pixelDensity,t?.pixelsPerPoint)}finally{await s().catch(t=>nn(e,`restore_failed`,t))}}async function Zt(e,t,n){let r=Se.fromTimeoutMs(He),i=[`io`,e.id,`screenshot`,...st(n),t];await xe(async({deadline:t})=>{await T(e,i,{timeoutMs:Math.max(1e3,t?.remainingMs()??2e4)})},{maxAttempts:5,baseDelayMs:Be,maxDelayMs:Ve,jitter:.2,shouldRetry:e=>an(e)},{deadline:r,phase:`ios_simulator_screenshot`})}async function U(e,n,r,i,a){if(e.kind===`device`&&!l(e)){await S(e).captureScreenshot(e,n,{appBundleId:r,fullscreen:i,runnerOptions:a,preferRunner:!0,runRunnerCommand:D});return}let o=await D(e,{command:`screenshot`,appBundleId:r,fullscreen:i,inlineScreenshot:!1},a),s=o.message;if(!s)throw new t(`COMMAND_FAILED`,`Failed to capture iOS screenshot: runner returned no file path`);let c=Kt(o);if(l(e))return await ze(s,n),c;if(e.kind===`simulator`)return await Qt(e,s,n),c;throw new t(`COMMAND_FAILED`,`Unsupported Apple screenshot target`)}async function Qt(e,n,r){let i=Se.fromTimeoutMs(b),a=`Unable to locate runner container for simulator screenshot`,o=H.get(e.id);if(o){let t=await $t(o,n,r);if(t.copied)return;a=t.error,H.delete(e.id)}for(let t of Ye){let o=await T(e,[`get_app_container`,e.id,t,`data`],{allowFailure:!0,timeoutMs:en(i,b,`runner screenshot container lookup`)});if(o.exitCode!==0){let e=o.stderr.trim();e&&(a=e);continue}let s=o.stdout.trim();if(!s){a=`simctl get_app_container returned empty output`;continue}let c=await $t(s,n,r);if(c.copied){H.set(e.id,s);return}a=c.error}throw new t(`COMMAND_FAILED`,`Failed to capture iOS screenshot: ${a}`)}async function $t(e,t,n){let r=`Runner screenshot was not found in the simulator container`;for(let i of rn(e,t))try{return await ze(i,n),{copied:!0}}catch(e){r=e instanceof Error?e.message:String(e)}return{copied:!1,error:r}}function en(e,n,r){let i=e.remainingMs();if(i>0)return i;throw new t(`COMMAND_FAILED`,`iOS ${r} timed out after ${n}ms`,{timeoutMs:n,step:r})}function tn(e,t,n){let r=x(n);g({level:`warn`,phase:`ios_screenshot_fallback`,data:{platform:e.platform,deviceKind:e.kind,deviceId:e.id,from:t,to:`runner`,...r}})}function nn(e,t,n){g({level:`warn`,phase:`ios_screenshot_status_bar_${t}`,data:{platform:e.platform,deviceKind:e.kind,deviceId:e.id,...x(n)}})}function rn(e,t){let n=A.resolve(e),r=t.trim();if(!r)return[];let i=[],a=new Set,o=e=>{let t=A.normalize(e);a.has(t)||(a.add(t),i.push(t))},s=r.replace(/^\/+/,``),c=s.replaceAll(`\\`,`/`);if(s&&o(A.join(n,s)),A.isAbsolute(r)&&o(A.normalize(r)),c.startsWith(`tmp/`))o(A.join(n,c));else{let e=c.lastIndexOf(`/tmp/`);if(e>=0){let t=c.slice(e+1);o(A.join(n,t))}}let l=A.basename(r);return l&&o(A.join(n,`tmp`,l)),i}function an(e){if(!(e instanceof t)||e.code!==`COMMAND_FAILED`)return!1;let n=Ge(e);return n.includes(`timeout waiting for screen surfaces`)||n.includes(`nsposixerrordomain`)&&n.includes(`code=60`)&&n.includes(`screenshot`)||n.includes(`timed out`)&&n.includes(`screenshot`)}function on(e){if(!(e instanceof t)||e.code!==`COMMAND_FAILED`)return!1;let n=Ge(e);return n.includes(`not booted`)||n.includes(`current state: shutdown`)||n.includes(`current state is shutdown`)||n.includes(`current state=shutdown`)||n.includes(`state: shutdown`)||n.includes(`state=shutdown`)}async function sn(e,t,n,r){let i=r??await cn(e),a=Fe(await Pe(t),i,n);a&&await ke(t,a.width,a.height)}async function cn(e){let n=V.get(e.id);if(n!==void 0)return n;let r=await T(e,[`getenv`,e.id,`SIMULATOR_MAINSCREEN_SCALE`],{timeoutMs:Ue}),i=Number(r.stdout.trim());if(!Number.isFinite(i)||i<=0)throw new t(`COMMAND_FAILED`,`Failed to read iOS simulator screenshot scale from SIMULATOR_MAINSCREEN_SCALE`);return V.set(e.id,i),i}function ln(e){return!(e instanceof t)||e.details?.runnerErrorCode!==`SCROLL_KEYBOARD_OCCLUDES_SURFACE`?e:new t(e.code,e.message,{...e.details,...re})}function un(e){let t=e?.amount!==void 0||e?.pixels!==void 0;return{...e,...t?{}:{amount:ge},durationMs:e?.durationMs??400,releaseBehavior:e?.releaseBehavior??`controlled`}}function dn(e,t,n,r={includeDuration:!0}){let i=W(e.referenceWidth),a=W(e.referenceHeight);if(i===void 0||a===void 0)return G(e,{amount:n?.amount});let o=ne({direction:t,amount:n?.amount,pixels:n?.pixels,referenceWidth:i,referenceHeight:a});return G(e,{amount:n?.amount,pixels:o.pixels,durationMs:r?.includeDuration?n?.durationMs:void 0,preferProvidedPixels:!0})}function fn(e,t={}){return{...e?.amount===void 0?{}:{amount:e.amount},...e?.pixels===void 0?{}:{pixels:e.pixels},...t.includeDuration!==!1&&e?.durationMs!==void 0?{durationMs:e.durationMs}:{},...t.includeReleaseBehavior!==!1&&e?.releaseBehavior!==void 0?{scrollReleaseBehavior:e.releaseBehavior}:{}}}function W(e){return typeof e==`number`&&Number.isFinite(e)?e:void 0}function G(e,t){let{x1:n,y1:r,x2:i,y2:a}=mn(e),o=W(e.referenceWidth),s=W(e.referenceHeight),c=pn(t,n!==void 0&&i!==void 0?Math.round(Math.abs(i-n)):void 0,r!==void 0&&a!==void 0?Math.round(Math.abs(a-r)):void 0),l=W(e.keyboardMinY);return{...n===void 0?{}:{x1:n},...r===void 0?{}:{y1:r},...i===void 0?{}:{x2:i},...a===void 0?{}:{y2:a},...o===void 0?{}:{referenceWidth:o},...s===void 0?{}:{referenceHeight:s},...e.keyboardAvoided===!0?{keyboardAvoided:!0}:{},...l===void 0?{}:{keyboardMinY:l},...t?.amount===void 0?{}:{amount:t.amount},...c===void 0?{}:{pixels:c},...t?.durationMs===void 0?{}:{durationMs:t.durationMs}}}function pn(e,t,n){if(e?.preferProvidedPixels&&e.pixels!==void 0)return e.pixels;if(t!==void 0&&t>0)return t;if(n!==void 0&&n>0)return n}function mn(e){let t=W(e.x),n=W(e.y),r=W(e.x2),i=W(e.y2);return{...t===void 0?{}:{x1:t},...n===void 0?{}:{y1:n},...r===void 0?{}:{x2:r},...i===void 0?{}:{y2:i}}}async function hn(e,t,n,r,i,a){return dn(await e(t,{command:`desktopScroll`,direction:i,...fn(a,{includeDuration:!0,includeReleaseBehavior:!1}),appBundleId:n.appBundleId},r),i,a,{includeDuration:!0})}function K(e,t,n){return{command:`remotePress`,remoteButton:e,...n===void 0?{}:{durationMs:n},...t===void 0?{}:{appBundleId:t}}}function gn(e){return e===`system`?`backSystem`:`backInApp`}function _n(e,t){let n={signal:t.signal,verbose:t.verbose,logPath:t.logPath,traceLogPath:t.traceLogPath,requestId:t.requestId,iosXctestrunFile:t.iosXctestrunFile,iosXctestDerivedDataPath:t.iosXctestDerivedDataPath,iosXctestEnvDir:t.iosXctestEnvDir,runnerLeaseContext:t.runnerLeaseContext};return{runnerOpts:n,overrides:{tap:async(r,i)=>await D(e,J(e,t,r,i),n),pressPoint:async(r,i)=>await vn(e,t,n,r,i),tapElementSelector:async r=>await D(e,{command:`tap`,selectorKey:r.key,selectorValue:r.value,allowNonHittableCoordinateFallback:r.allowNonHittableCoordinateFallback,...r.expectedPoint?{x:r.expectedPoint.x,y:r.expectedPoint.y}:{},...s(e)?{synthesized:!0}:{},appBundleId:t.appBundleId},n),doubleTap:async(r,i)=>{let a=await D(e,C([{kind:`doubleTap`,x:r,y:i}],t.appBundleId),n);return w(a),a},appState:async()=>Cn(await D(e,{command:`appState`,appBundleId:t.appBundleId},n)),longPress:async(r,i,a)=>await D(e,{command:`longPress`,x:r,y:i,durationMs:a,appBundleId:t.appBundleId},n),focus:async(r,i)=>await D(e,J(e,t,r,i),n),type:async(r,i)=>Sn(await D(e,{command:`type`,text:r,delayMs:i,textEntryMode:r===`
+`?void 0:`append`,appBundleId:t.appBundleId},n)),fill:async(r,i,a,o,s)=>await D(e,{command:`type`,x:r,y:i,text:a,delayMs:o,textEntryMode:`replace`,...s?.allowNonHittableCoordinateFallback?{allowNonHittableCoordinateFallback:!0}:{},appBundleId:t.appBundleId},n),scroll:async(r,i)=>await On(D,e,t,n,r,i),performGesture:async r=>await En(e,t,n,r),gestureViewport:async()=>Tn(await D(e,{command:`gestureViewport`,appBundleId:t.appBundleId},n))}}}async function vn(e,t,n,r,i){let a=l(e)?d(i.surface):void 0;return a?await yn(t,r,i,a):i.button===`primary`?i.count===1?await xn(e,t,n,r,i):await Ke(e,r,i,t.appBundleId,async t=>await D(e,t,n)):await bn(e,t,n,r,i.button)}async function yn(e,n,r,i){if(r.button!==`primary`)throw new t(`UNSUPPORTED_OPERATION`,`${r.button} click is not supported on macOS ${i} sessions.`);let{runMacOsPressAction:a}=await import(`./helper.js`).then(e=>e.t),o=await a(n.x,n.y,{bundleId:e.appBundleId,surface:i,holdMs:r.holdMs,clicks:r.count,doubleClick:r.doubleTap,intervalMs:r.intervalMs,signal:e.signal});return o.holdMs===void 0?{}:{holdMs:o.holdMs}}async function bn(e,t,n,r,i){return await D(e,{command:`mouseClick`,x:r.x,y:r.y,button:i,appBundleId:t.appBundleId},n)}async function xn(e,t,n,r,i){if(i.doubleTap){let i=await D(e,C([{kind:`doubleTap`,x:r.x,y:r.y}],t.appBundleId),n);return w(i),i}return i.holdMs>0?await D(e,{command:`longPress`,x:r.x,y:r.y,durationMs:i.holdMs,appBundleId:t.appBundleId},n):await D(e,J(e,t,r.x,r.y),n)}function Sn(e){let t=e.textEntryRoute;return wn(t)?{textEntryRoute:t}:{}}function Cn(t){let n=t.applicationState;return e(n)?{applicationState:n}:{}}function wn(e){return typeof e==`string`&&ct.includes(e)}function Tn(e){let n=q(e.x),r=q(e.y),i=q(e.x2),a=q(e.y2);if(n===void 0||r===void 0||i===void 0||a===void 0||i<=0||a<=0)throw new t(`COMMAND_FAILED`,`Apple runner returned an invalid gesture viewport`);return{x:n,y:r,width:i,height:a}}function q(e){return typeof e==`number`&&Number.isFinite(e)?e:void 0}async function En(e,t,n,r){if(r.topology===`two`&&lt(e,r.intent),r.topology===`single`&&l(e)){let{start:i,end:a}=Ce(r);return await D(e,{command:`drag`,x:i.x,y:i.y,x2:a.x,y2:a.y,durationMs:r.durationMs,appBundleId:t.appBundleId},n)}if(r.topology===`single`&&u(e)){let{start:i,end:a}=Ce(r);return await D(e,{command:`swipe`,direction:Dn(i,a),appBundleId:t.appBundleId},n)}return await D(e,{command:`gesture`,gesturePlan:r,appBundleId:t.appBundleId},n)}function Dn(e,t){let n=t.x-e.x,r=t.y-e.y;return Math.abs(n)>=Math.abs(r)?n>=0?`right`:`left`:r>=0?`down`:`up`}function J(e,t,n,r){return{command:`tap`,x:n,y:r,...s(e)?{synthesized:!0}:{},appBundleId:t.appBundleId}}async function On(e,t,n,r,i,a){if(me(a?.durationMs,{invalidMessage:`scroll durationMs must be a non-negative integer at most ${he}`}),u(t))return G(await e(t,K(i,n.appBundleId,a?.durationMs),r),{amount:a?.amount,durationMs:a?.durationMs});if(ie(a??{}),l(t))return await hn(e,t,n,r,i,a);let o=un(a),s;try{s=await e(t,{command:`scroll`,direction:i,...fn(o),appBundleId:n.appBundleId},r)}catch(e){throw ln(e)}return dn(s,i,o)}function Y(e,t,n){if(l(e)){let e=n?.surface===`frontmost-app`?{surface:n.surface}:{bundleId:n?.appBundleId,surface:n?.surface};return async t=>await et(t,e)}return async(r,i)=>await D(e,{command:`alert`,action:r,appBundleId:n?.appBundleId,timeoutMs:i},t)}async function kn(e,t,n){return await Y(e,t,n)(`get`,ae)}async function An(e,n,r){let i=Y(e,n,r),a=r?.timeoutMs??1e4,o=Date.now(),s=!0;for(;Date.now()-o<a;){try{let e=s?a:Mn(o,a);return s=!1,await i(`get`,e)}catch(e){if(!X(e))throw e}await ye(300)}throw new t(`COMMAND_FAILED`,`alert wait timed out`)}async function jn(e,t,n,r){let i=Y(e,t,r),a=ee(e)?ae:f,o=Date.now(),s,c=!0;for(;Date.now()-o<f;){try{let e=c?a:Mn(o,f);return c=!1,await i(n,e)}catch(e){if(s=e,!X(e))break}await ye(300)}throw Nn(s)}function Mn(e,t){return Math.max(1,t-(Date.now()-e))}function Nn(e){return!(e instanceof t)||!X(e)?e:new t(e.code,e.message,{...e.details??{},hint:`If the permission sheet is visible in snapshot or screenshot but alert reports no alert, take a scoped snapshot around the visible button label and use press @ref.`})}function X(e){if(!(e instanceof t))return!1;let n=e.details??{};return n.runnerErrorCode===`ALERT_NOT_FOUND`||n.reason===`alert-not-found`}const Pn={0:`unknown`,1:`notRunning`,2:`runningBackgroundSuspended`,3:`runningBackground`};function Fn(e,t){if(typeof e!=`object`||!e||Array.isArray(e))return;let n={...e},i=n.reason;if(!r(i))return;let a=n.priorState;if(typeof a!=`number`||!Number.isInteger(a))return;let o=Pn[a];o===void 0&&t?.({reason:i,rawPriorState:a});let s=n.otherActiveApplicationPid;return{reason:i,priorState:o??`unknown`,...typeof s==`number`&&Number.isInteger(s)&&s>0?{otherActiveApplicationPid:s}:{}}}function In(e){let t=Ln(e.systemSurface),n=a(e.keyboard),r=Fn(e.targetActivation,e=>Je({level:`debug`,phase:`ios_runner_target_activation_prior_state_unmapped`,data:e}));return{nodes:Array.isArray(e.nodes)?e.nodes:void 0,truncated:typeof e.truncated==`boolean`?e.truncated:void 0,quality:Ae(e.snapshotQuality),qualityPayload:Vn(e.qualityPayload,t),runnerFatal:e.runnerFatal===!0,...n?{keyboard:n}:{},...t?{systemSurface:t}:{},...r?{targetActivation:r}:{},message:typeof e.message==`string`&&e.message.trim().length>0?e.message:void 0}}function Ln(e){if(!Wn(e)||typeof e.bundleId!=`string`)return;let t=Oe(e.bundleId);return t&&{bundleId:t.bundleId,kind:t.kind}}function Rn(e,t,n){let r=n.nodes??[];if(n.runnerFatal===!0||r.length===0&&n.qualityPayload===void 0)return r;let i=Ee({raw:t?.raw,interactiveOnly:t?.interactiveOnly,depth:t?.depth,scope:t?.scope,customActions:t?.customActions}),a=Hn(r,n.qualityPayload?.nodes),o={stage:`presented`,presentation:{producer:`apple-runner`,intent:`full`,payload:{nodes:r,truncated:n.truncated??!1,...n.quality?.effectiveDepth===void 0?{}:{effectiveDepth:n.quality.effectiveDepth}},...n.qualityPayload?{qualityPayload:n.qualityPayload}:{}},validation:{presentationKey:Te(i),viewport:a,hittability:{kind:`available`},lineage:{targetId:e},residue:[]}};try{return Ie(o,i).nodes}catch(e){zn(e,n)}}function zn(e,n){let r=n.quality;if(e instanceof y&&Me(r))throw new t(`COMMAND_FAILED`,e.message,{...v(e),...n.systemSurface?{systemSurface:n.systemSurface}:{},snapshotQuality:{state:r.state,backend:r.backend,...r.reason?{reason:r.reason}:{},...r.reasonCode?{reasonCode:r.reasonCode}:{}},hint:Bn(n.systemSurface,r)},e);Z(e,n.systemSurface)}function Bn(e,t){return[e?`${e.bundleId} hosts the surface presented over the app, and this capture targeted that surface.`:void 0,...je(t,[])].filter(e=>e!==void 0).join(` `)}function Vn(e,t){if(e!==void 0)return(!Wn(e)||!Array.isArray(e.nodes)||typeof e.truncated!=`boolean`)&&Z(new y(`invalid-quality-payload`,`iOS runner returned an invalid quality payload`),t),e.scope!==void 0&&e.scope!==null&&Z(new y(`invalid-quality-payload`,`iOS runner quality payload must be unscoped`,{field:`scope`}),t),{nodes:e.nodes,truncated:e.truncated,scope:null}}function Hn(e,t){return Ne(Un(t),{fallbackToLargestRoot:!0})??Ne(Un(e),{fallbackToLargestRoot:!0})??{kind:`missing`,reason:`not-provided`}}function Un(e){return e?.filter(e=>e.parentIndex===void 0)??[]}function Wn(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Z(e,n){throw e instanceof y?new t(`COMMAND_FAILED`,e.message,{...v(e),...n?{systemSurface:n}:{}},e):e}function Gn(e,n,r){if(e.appleOs===`watchos`)throw new t(`UNSUPPORTED_PLATFORM`,`watchOS is not supported: XCUITest cannot drive watchOS UI, so this device has no runner backend.`);let{overrides:i,runnerOpts:a}=_n(e,n),o={open:(t,n)=>Xe(e,t,{appBundleId:n?.appBundleId,launchConsole:n?.launchConsole,launchArgs:n?.launchArgs,terminateRunningApp:n?.terminateRunningApp,url:n?.url,runnerOptions:a}),openDevice:()=>Ze(e),close:t=>Qe(e,t,a),screenshot:(t,n)=>nr(e,t,n,a),snapshot:async t=>await Kn(e,t,a),readTextAtPoint:async(t,n)=>{let r=l(e)?d(n?.surface):void 0;return r?await rr(t,r,n?.appBundleId):await ir(e,t,n,a)},findText:async(t,n)=>({found:(await D(e,{command:`findText`,text:t,appBundleId:n?.appBundleId},n?.signal?{...a,signal:n.signal}:a))?.found===!0}),back:async t=>{if(u(e)){await D(e,K(`menu`,n.appBundleId),a);return}await D(e,{command:gn(t),appBundleId:n.appBundleId},a)},home:async()=>{if(u(e)){await D(e,K(`home`,n.appBundleId),a);return}await D(e,{command:`home`,appBundleId:n.appBundleId},a)},setOrientation:async r=>{let i=er(await D(e,{command:`rotate`,orientation:r,appBundleId:n.appBundleId},a));if(i!==r)throw new t(`COMMAND_FAILED`,`iOS runner observed ${i} after requesting ${r}`,{requestedOrientation:r,observedOrientation:i});return{orientation:i}},appSwitcher:async()=>{await D(e,{command:`appSwitcher`,appBundleId:n.appBundleId},a)},actionButton:async()=>{await D(e,{command:`actionButton`,appBundleId:n.appBundleId},a)},tvRemote:async(t,r)=>{await D(e,K(be(t),n.appBundleId,r),a)},keyboardDismiss:async()=>{let t=await D(e,{command:`keyboardDismiss`,appBundleId:n.appBundleId},a);return{kind:`mechanism`,wasVisible:Q(t,`wasVisible`),dismissed:Q(t,`dismissed`),visible:Q(t,`visible`),mechanism:$n(t,`keyboardDismissMechanism`)}},keyboardEnter:async()=>{let t=await D(e,{command:`keyboardReturn`,appBundleId:n.appBundleId},a);return{kind:`visibility-echo`,visible:Q(t,`visible`),wasVisible:Q(t,`wasVisible`)}},readClipboard:()=>ft(e),writeClipboard:t=>pt(e,t,a),setSetting:(t,n,r,i)=>Dt(e,t,n,r,i),readSetting:t=>kt(e,t),readAlert:t=>kn(e,a,t),awaitAlert:t=>An(e,a,t),acceptAlert:t=>jn(e,a,`accept`,t),dismissAlert:t=>jn(e,a,`dismiss`,t),...i};return r?tr(e,n,o,r):o}async function Kn(e,t,n){let r=l(e)?d(t?.surface):void 0;return r?await ut({...t,surface:r},t?.signal):await qn(e,t,n)}async function qn(e,t,n){let r=In(await ve(`snapshot_capture`,async()=>await D(e,{command:`snapshot`,appBundleId:t?.appBundleId,interactiveOnly:t?.interactiveOnly,preferredBackend:t?.preferredBackend,customActions:t?.customActions,depth:t?.depth,scope:t?.scope,raw:t?.raw},Qn(n,t?.signal)),{backend:`xctest`}));Jn(e,t,r);let i=Yn(r);return{nodes:Xn(e,t,r),truncated:r.truncated??!1,backend:`xctest`,producer:`apple-runner`,...r.quality?{quality:r.quality}:{},...r.systemSurface?{systemSurface:r.systemSurface}:{},...r.keyboard?{keyboard:r.keyboard}:{},...r.targetActivation?{targetActivation:r.targetActivation}:{},...i.length>0?{warnings:i}:{}}}function Jn(e,n,r){if(!((r.nodes?.length??0)>0)&&!Zn(n,r.quality)&&e.kind===`simulator`)throw new t(`COMMAND_FAILED`,`XCTest snapshot returned 0 nodes on iOS simulator.`)}function Yn(e){let t=[];return!e.quality&&e.message&&t.push(e.message),e.systemSurface&&t.push(De(e.systemSurface.bundleId)),e.targetActivation&&t.push(dt(e.targetActivation)),t}function Xn(e,t,n){return l(e)?n.nodes??[]:Rn(e.id,t,n)}function Zn(e,t){return te(e?.scope)!==null&&t!==void 0&&t.state!==`sparse`}function Qn(e,t){return t?{...e,signal:e.signal?AbortSignal.any([e.signal,t]):t}:e}function Q(e,t){let n=e[t];return typeof n==`boolean`?n:void 0}function $n(e,t){let n=e[t];return typeof n==`string`?n:void 0}function er(e){let n=e.orientation;if(typeof n==`string`&&_e.includes(n))return n;throw new t(`COMMAND_FAILED`,`iOS runner returned an invalid orientation result`,{orientation:n})}function tr(e,t,n,r){let i={...n,open:async()=>$(`open`),openDevice:async()=>$(`openDevice`),close:async()=>$(`close`),screenshot:async()=>$(`screenshot`),readClipboard:async()=>$(`readClipboard`),setSetting:async()=>$(`setSetting`),readSetting:async()=>$(`readSetting`)};return we(i,n=>qe(r,{deviceId:e.id,requestId:t.requestId},n))}function $(e){throw new t(`UNSUPPORTED_OPERATION`,`${e} uses local Apple tooling (simctl/devicectl), which an injected runner transport cannot reach; the provider session must supply its own ${e} implementation.`)}async function nr(e,n,r={},a){let o=l(e)?d(r.surface):void 0;if(o){if(r.fullscreen)throw new t(`INVALID_ARGS`,`screenshot --fullscreen is not accepted on the macOS ${o} surface: it always captures the main display`,{reason:i.macOsHelperSurfaceFixedFrame,surface:o});await tt(n,{surface:o});return}if(r.captureBackend===`runner`){await U(e,n,r.appBundleId,r.fullscreen,a);return}await Yt(e,n,{appBundleId:r.appBundleId,pixelDensity:r.pixelDensity,fullscreen:r.fullscreen,runnerOptions:a,normalizeStatusBar:r.normalizeStatusBar,skipIosSimulatorBootCheck:r.skipIosSimulatorBootCheck})}async function rr(e,t,n){let{runMacOsReadTextAction:r}=await import(`./helper.js`).then(e=>e.t);return(await r(e.x,e.y,{bundleId:n,surface:t})).text}async function ir(e,t,n,r){let i=await D(e,{command:`readText`,x:t.x,y:t.y,appBundleId:n?.appBundleId},n?.signal?{...r,signal:n.signal}:r);return typeof i.text==`string`?i.text:typeof i.message==`string`?i.message:void 0}export{Gn as createAppleInteractor};

package/dist/src/internal/bin.js

@@ -1 +1 @@
-async function e(e,n,r){try{await t(e,n,r)}catch(e){r.stderr(`${e instanceof Error?e.message:String(e)}\n`),await(await n.processExit()).exitAfterFlush(1)}}async function t(e,t,l){if(e.length===0)return await n(t,l);if(o(e))return await r(t,l);let u=c(e);if(u!==void 0)return await i(u,e,t,l);if(s(e))return await(await t.mcp()).runAgentDeviceMcpServer();await a(e,t)}async function n(e,t){t.stdout(`${(await e.help()).buildUsageText()}\n`),await(await e.processExit()).exitAfterFlush(1)}async function r(e,t){t.stdout(`${t.bundledVersion??(await e.version()).readVersion()}\n`)}async function i(e,t,n,r){let i=await n.help(),o=e===null?`${i.buildUsageText()}\n`:i.resolveHelpTargetUsageText(e);if(o===null)return await a(t,n);r.stdout(o)}async function a(e,t){await(await t.cli()).runCliProcess(e)}function o(e){return e.length===1&&(e[0]===`--version`||e[0]===`-V`)}function s(e){return e[0]===`mcp`&&!e.some(l)}function c(e){let[t,n]=e;if(e.length===1)return t===`help`||l(t)?null:void 0;if(e.length===2)return t===`help`?n:l(n)?t:void 0}function l(e){return e===`--help`||e===`-h`}e(process.argv.slice(2),{help:()=>import(`../cli-help.js`).then(e=>e.n),cli:()=>import(`../process-entry.js`),mcp:()=>import(`../server.js`),version:()=>import(`../version.js`).then(e=>e.t),processExit:()=>import(`../process-exit.js`)},{bundledVersion:`0.21.18`,stdout:e=>{process.stdout.write(e)},stderr:e=>{process.stderr.write(e)}}).catch(()=>process.exit(1));export{};
+async function e(e,n,r){try{await t(e,n,r)}catch(e){r.stderr(`${e instanceof Error?e.message:String(e)}\n`),await(await n.processExit()).exitAfterFlush(1)}}async function t(e,t,l){if(e.length===0)return await n(t,l);if(o(e))return await r(t,l);let u=c(e);if(u!==void 0)return await i(u,e,t,l);if(s(e))return await(await t.mcp()).runAgentDeviceMcpServer();await a(e,t)}async function n(e,t){t.stdout(`${(await e.help()).buildUsageText()}\n`),await(await e.processExit()).exitAfterFlush(1)}async function r(e,t){t.stdout(`${t.bundledVersion??(await e.version()).readVersion()}\n`)}async function i(e,t,n,r){let i=await n.help(),o=e===null?`${i.buildUsageText()}\n`:i.resolveHelpTargetUsageText(e);if(o===null)return await a(t,n);r.stdout(o)}async function a(e,t){await(await t.cli()).runCliProcess(e)}function o(e){return e.length===1&&(e[0]===`--version`||e[0]===`-V`)}function s(e){return e[0]===`mcp`&&!e.some(l)}function c(e){let[t,n]=e;if(e.length===1)return t===`help`||l(t)?null:void 0;if(e.length===2)return t===`help`?n:l(n)?t:void 0}function l(e){return e===`--help`||e===`-h`}e(process.argv.slice(2),{help:()=>import(`../cli-help.js`).then(e=>e.n),cli:()=>import(`../process-entry.js`),mcp:()=>import(`../server.js`),version:()=>import(`../version.js`).then(e=>e.t),processExit:()=>import(`../process-exit.js`)},{bundledVersion:`0.21.19`,stdout:e=>{process.stdout.write(e)},stderr:e=>{process.stderr.write(e)}}).catch(()=>process.exit(1));export{};