agent-device 0.21.18 → 0.21.20

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{C as f,S as ae,_ as oe,b as p,m,n as se,r as h,v as ce,x as le,y as ue}from"./settings.js";import{n as de}from"./location-coordinates.js";import{c as fe,n as pe,t as me}from"./scroll-command.js";import"./device.js";import{t as he}from"./device-rotation.js";import{c as ge,r as g}from"./diagnostics.js";import{o as _}from"./exec.js";import{a as _e}from"./tv-remote.js";import"./diagnostics2.js";import"./command.js";import{i as ve,n as ye}from"./retry.js";import{a as v}from"./gesture-plan.js";import{n as be}from"./scoped-provider.js";import{n as xe,r as Se}from"./ios-snapshot-planning.js";import{n as Ce,r as we}from"./ios-system-surface.js";import{a as Te,l as Ee,n as De,s as Oe}from"./quality-warnings.js";import{r as y}from"./ios-snapshot-acquisition.js";import{t as ke}from"./png-size.js";import{n as Ae}from"./screenshot-density.js";import{i as b,n as je,r as x}from"./ios-snapshot-engine.js";import{C as Me,g as Ne,r as S}from"./host-file.js";import{c as C,f as Pe,h as Fe,m as Ie,p as Le}from"./config.js";import{o as w}from"./tool-provider.js";import{n as T,r as E,t as D}from"./physical-device-control.js";import{i as Re,n as O,r as k,s as ze}from"./runner.js";import{u as Be}from"./host.js";import{t as Ve}from"./runner-cache-metadata.js";import{a as A,n as j}from"./simctl.js";import{c as M}from"./runner-client.js";import"./runner-error-classification.js";import{n as He,r as Ue,t as N}from"./app-launch.js";import{r as P,t as F}from"./simulator.js";import{a as We,o as Ge}from"./helper.js";import{a as Ke,d as qe,f as Je,p as Ye}from"./app-resolution.js";import{i as Xe,t as Ze}from"./display-inventory.js";import{n as Qe}from"./interactor-types.js";import{n as $e}from"./multitouch-support.js";import{i as et,r as tt,t as I}from"./alert.js";import{t as nt}from"./surface-snapshot.js";import{t as rt}from"./ios-target-activation.js";import L from"node:path";async function it(e){return l(e)?await qe():(P(e,`clipboard`),await F(e),_(await A(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 at(e,t,n){if(l(e)){await Ye(t);return}if(P(e,`clipboard`),u(e)){let r=n?.signal;await F(e,{signal:r}),_(await A(e,[`pbcopy`,e.id],{allowFailure:!0,stdin:t,signal:r}),`Failed to write tvOS simulator clipboard`);return}await M(e,{command:`pasteboardWrite`,text:t},n)}function R(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 ot(e,t){R(e,h);let n=le(t);return await A(e,[`ui`,e.id,`content_size`,n]),f(n,n)}async function st(e){R(e,h),await F(e);let n=_(await A(e,[`ui`,e.id,`content_size`],{allowFailure:!0}),`Failed to read iOS content size category`),r=n.stdout.trim(),i=ae(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 f(i,r)}const ct=[`--time`,`9:41`,`--dataNetwork`,`wifi`,`--wifiMode`,`active`,`--wifiBars`,`3`,`--batteryState`,`charged`,`--batteryLevel`,`100`],lt={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`},ut={1:`searching`,2:`failed`,3:`active`},dt={0:`notSupported`,1:`searching`,2:`failed`,3:`active`},z=new Set;async function ft(e){let t=null,n=!1;if(ht(e))n=!0;else try{t=await gt(e),n=!0}catch(t){St(e,`snapshot_failed`,t)}try{(!n||t)&&await _t(e),await vt(e,ct)}catch(t){St(e,`prepare_failed`,t)}return async()=>{await pt(e,n?t:null)}}async function pt(e,t){if(await _t(e),!t){mt(e);return}await vt(e,bt(t)),B(e)}function B(e){z.delete(V(e))}function mt(e){z.add(V(e))}function ht(e){return z.has(V(e))}function V(e){return`${e.platform}:${e.kind}:${e.id}`}async function gt(e){return yt(_(await A(e,[`status_bar`,e.id,`list`],{allowFailure:!0}),`Failed to read simulator status bar overrides`).stdout)}async function _t(e){await A(e,[`status_bar`,e.id,`clear`])}async function vt(e,t){t.length!==0&&await A(e,[`status_bar`,e.id,`override`,...t])}function yt(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=lt[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=ut[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=dt[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 bt(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||xt(e.dataNetwork)||e.operatorName!==void 0)&&t.push(`--cellularBars`,e.cellularBars),e.operatorName!==void 0&&t.push(`--operatorName`,e.operatorName),t}function xt(e){return!!(e&&e!==`hide`&&e!==`wifi`)}function St(e,t,n){g({level:`warn`,phase:`ios_screenshot_status_bar_${t}`,data:{platform:e.platform,deviceKind:e.kind,deviceId:e.id,...E(n)}})}async function Ct(e,n,r,i,a){if(l(e)){let e=n.toLowerCase();if(e===`appearance`){await Je(r);return}if(e===`permission`){let e=ce(r);if(e===`deny`)throw new t(`INVALID_ARGS`,m(`permission`));let n=Dt(a?.permissionTarget);return await We(e,n)}throw new t(`INVALID_ARGS`,m(n))}P(e,`settings`),await F(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 Et(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 A(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 A(e,[`status_bar`,e.id,`override`,`--wifiMode`,t]),B(e);return}case`airplane`:p(r)?(await A(e,[`status_bar`,e.id,`override`,`--dataNetwork`,`hide`,`--wifiMode`,`failed`,`--wifiBars`,`0`,`--cellularMode`,`failed`,`--cellularBars`,`0`,`--operatorName`,``]),B(e)):(await A(e,[`status_bar`,e.id,`clear`]),mt(e));return;case`location`:{if(r.toLowerCase()===`set`){let{latitude:t,longitude:n}=de(a);return await A(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 A(e,[`privacy`,e.id,o,`location`,i]);return}case`faceid`:case`touchid`:{R(e,se);let t=o,n=At[t];await Rt(e,Lt(r,t),{settingName:t,notificationModality:n.notificationModality});return}case`appearance`:{let t=await Ot(e,r);await A(e,[`ui`,e.id,`appearance`,t]);return}case`text-size`:return await ot(e,r);case`permission`:if(!i)throw new t(`INVALID_ARGS`,`permission setting requires an active app in session`);await Mt(e,jt(ce(r)),It(a?.permissionTarget,a?.permissionMode),i);return;default:throw new t(`INVALID_ARGS`,`Unsupported setting: ${n}`)}}const wt={"text-size":st};async function Tt(e,t){return await wt[t](e)}async function Et(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 Ke(e,n);await F(e),await N(e,r);let i=_(await A(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 Ne(i);return await Promise.all(a.map(e=>Me(L.join(i,e)))),{bundleId:r,containerPath:i}}function Dt(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 Ot(e,n){let r=oe(n);if(r!==`toggle`)return r;let i=_(await A(e,[`ui`,e.id,`appearance`],{allowFailure:!0}),`Failed to read current iOS appearance`),a=kt(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 kt(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 At={faceid:{notificationModality:`pearl`},touchid:{notificationModality:`fingerTouch`}};function jt(e){return e===`deny`?`revoke`:e}async function Mt(e,t,n,r){try{await A(e,[`privacy`,e.id,t,n,r])}catch(i){throw Nt(i)?Pt(e,t,n,r,i):i}}function Nt(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 Pt(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 Ft={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 It(e,n){let r=ue(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 Ft[r]}function Lt(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 Rt(e,r,i){let a=j(e,Vt(e.id,r,i.notificationModality)),o=await w(a,{allowFailure:!0}),s=[];if(o.exitCode!==0)s.push({args:a,stderr:o.stderr,stdout:o.stdout,exitCode:o.exitCode});else{let t=zt(r);if(t!==void 0){let n=await Bt(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 H=`com.apple.BiometricKit.enrollmentChanged`;function zt(e){if(e===`enroll`)return`1`;if(e===`unenroll`)return`0`}async function Bt(e){let t=j(e,[`spawn`,e.id,`notifyutil`,`-g`,H]),n=await w(t,{allowFailure:!0}),r=n.stdout.split(`
+`).map(e=>e.trim().split(/\s+/)).find(e=>e[0]===H)?.[1];return{args:t,stderr:n.stderr,stdout:n.stdout,exitCode:n.exitCode,state:n.exitCode===0?r:void 0}}function Vt(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`,H,`1`,`-p`,H];case`unenroll`:return[...r,`-s`,H,`0`,`-p`,H]}}function Ht(e){let t=e.screenshotMetadata;if(!t||typeof t!=`object`||Array.isArray(t))return;let n=t,r=U(n.displayID),i=U(n.pixelWidth),a=U(n.pixelHeight),o=Ut(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 U(e){return typeof e==`number`&&Number.isInteger(e)&&e>0?e:void 0}function Ut(e){return typeof e==`number`&&Number.isFinite(e)&&e>0?e:void 0}const Wt={ensureBooted:F,prepareStatusBarForScreenshot:ft,resolveCaptureTarget:Xe,captureWithRetry:Jt,normalizeDensity:rn,captureWithRunner:G,shouldFallbackToRunner:tn},Gt=new Map,W=new Map;async function Kt(e,t,n={}){return l(e)?(await G(e,t,n.appBundleId,n.fullscreen,n.runnerOptions),{}):e.kind===`simulator`?await qt(e,t,n):(await D(e).captureScreenshot(e,t,{appBundleId:n.appBundleId,fullscreen:n.fullscreen,runnerOptions:n.runnerOptions,runRunnerCommand:M}),{})}async function qt(e,n,r={}){if(e.kind!==`simulator`)throw new t(`UNSUPPORTED_OPERATION`,`Simulator screenshot fallback flow supports only iOS simulators`);let i={...Wt,...r.deps??{}};r.skipIosSimulatorBootCheck||await i.ensureBooted(e);let{display:a,displayRotation:o}=await i.resolveCaptureTarget(e),s=o?{displayRotation:o}:{},c=async()=>{await i.captureWithRetry(e,n,a),await i.normalizeDensity(e,n,r.pixelDensity,a?.pointScale)},l=async()=>{};if(r.normalizeStatusBar===!0)try{l=await i.prepareStatusBarForScreenshot(e)}catch(t){$t(e,`prepare_failed`,t)}try{try{return await c(),s}catch(t){let n=t;if(r.skipIosSimulatorBootCheck&&nn(t)){await i.ensureBooted(e);try{return await c(),s}catch(e){n=e}}if(!i.shouldFallbackToRunner(n))throw n;Qt(e,`simctl_screenshot`,n)}let t=await i.captureWithRunner(e,n,r.appBundleId,r.fullscreen,r.runnerOptions);return await i.normalizeDensity(e,n,r.pixelDensity,t?.pixelsPerPoint),s}finally{await l().catch(t=>$t(e,`restore_failed`,t))}}async function Jt(e,t,n){let r=ye.fromTimeoutMs(Fe),i=[`io`,e.id,`screenshot`,...Ze(n),t];await ve(async({deadline:t})=>{await A(e,i,{timeoutMs:Math.max(1e3,t?.remainingMs()??2e4)})},{maxAttempts:5,baseDelayMs:Pe,maxDelayMs:Le,jitter:.2,shouldRetry:e=>tn(e)},{deadline:r,phase:`ios_simulator_screenshot`})}async function G(e,n,r,i,a){if(e.kind===`device`&&!l(e)){await D(e).captureScreenshot(e,n,{appBundleId:r,fullscreen:i,runnerOptions:a,preferRunner:!0,runRunnerCommand:M});return}let o=await M(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=Ht(o);if(l(e))return await S(s,n),c;if(e.kind===`simulator`)return await Yt(e,s,n),c;throw new t(`COMMAND_FAILED`,`Unsupported Apple screenshot target`)}async function Yt(e,n,r){let i=ye.fromTimeoutMs(C),a=`Unable to locate runner container for simulator screenshot`,o=W.get(e.id);if(o){let t=await Xt(o,n,r);if(t.copied)return;a=t.error,W.delete(e.id)}for(let t of Ve){let o=await A(e,[`get_app_container`,e.id,t,`data`],{allowFailure:!0,timeoutMs:Zt(i,C,`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 Xt(s,n,r);if(c.copied){W.set(e.id,s);return}a=c.error}throw new t(`COMMAND_FAILED`,`Failed to capture iOS screenshot: ${a}`)}async function Xt(e,t,n){let r=`Runner screenshot was not found in the simulator container`;for(let i of en(e,t))try{return await S(i,n),{copied:!0}}catch(e){r=e instanceof Error?e.message:String(e)}return{copied:!1,error:r}}function Zt(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 Qt(e,t,n){let r=E(n);g({level:`warn`,phase:`ios_screenshot_fallback`,data:{platform:e.platform,deviceKind:e.kind,deviceId:e.id,from:t,to:`runner`,...r}})}function $t(e,t,n){g({level:`warn`,phase:`ios_screenshot_status_bar_${t}`,data:{platform:e.platform,deviceKind:e.kind,deviceId:e.id,...E(n)}})}function en(e,t){let n=L.resolve(e),r=t.trim();if(!r)return[];let i=[],a=new Set,o=e=>{let t=L.normalize(e);a.has(t)||(a.add(t),i.push(t))},s=r.replace(/^\/+/,``),c=s.replaceAll(`\\`,`/`);if(s&&o(L.join(n,s)),L.isAbsolute(r)&&o(L.normalize(r)),c.startsWith(`tmp/`))o(L.join(n,c));else{let e=c.lastIndexOf(`/tmp/`);if(e>=0){let t=c.slice(e+1);o(L.join(n,t))}}let l=L.basename(r);return l&&o(L.join(n,`tmp`,l)),i}function tn(e){if(!(e instanceof t)||e.code!==`COMMAND_FAILED`)return!1;let n=T(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 nn(e){if(!(e instanceof t)||e.code!==`COMMAND_FAILED`)return!1;let n=T(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 rn(e,t,n,r){let i=r??await an(e),a=Ae(await ke(t),i,n);a&&await Te(t,a.width,a.height)}async function an(e){let n=Gt.get(e.id);if(n!==void 0)return n;let r=await A(e,[`getenv`,e.id,`SIMULATOR_MAINSCREEN_SCALE`],{timeoutMs:Ie}),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 Gt.set(e.id,i),i}function on(e){return!(e instanceof t)||e.details?.runnerErrorCode!==`SCROLL_KEYBOARD_OCCLUDES_SURFACE`?e:new t(e.code,e.message,{...e.details,...re})}function sn(e){let t=e?.amount!==void 0||e?.pixels!==void 0;return{...e,...t?{}:{amount:me},durationMs:e?.durationMs??400,releaseBehavior:e?.releaseBehavior??`controlled`}}function cn(e,t,n,r={includeDuration:!0}){let i=K(e.referenceWidth),a=K(e.referenceHeight);if(i===void 0||a===void 0)return q(e,{amount:n?.amount});let o=ne({direction:t,amount:n?.amount,pixels:n?.pixels,referenceWidth:i,referenceHeight:a});return q(e,{amount:n?.amount,pixels:o.pixels,durationMs:r?.includeDuration?n?.durationMs:void 0,preferProvidedPixels:!0})}function ln(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 K(e){return typeof e==`number`&&Number.isFinite(e)?e:void 0}function q(e,t){let{x1:n,y1:r,x2:i,y2:a}=dn(e),o=K(e.referenceWidth),s=K(e.referenceHeight),c=un(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=K(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 un(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 dn(e){let t=K(e.x),n=K(e.y),r=K(e.x2),i=K(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 fn(e,t,n,r,i,a){return cn(await e(t,{command:`desktopScroll`,direction:i,...ln(a,{includeDuration:!0,includeReleaseBehavior:!1}),appBundleId:n.appBundleId},r),i,a,{includeDuration:!0})}function J(e,t,n){return{command:`remotePress`,remoteButton:e,...n===void 0?{}:{durationMs:n},...t===void 0?{}:{appBundleId:t}}}function pn(e){return e===`system`?`backSystem`:`backInApp`}function mn(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 M(e,X(e,t,r,i),n),pressPoint:async(r,i)=>await hn(e,t,n,r,i),tapElementSelector:async r=>await M(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 M(e,O([{kind:`doubleTap`,x:r,y:i}],t.appBundleId),n);return k(a),a},appState:async()=>bn(await M(e,{command:`appState`,appBundleId:t.appBundleId},n)),longPress:async(r,i,a)=>await M(e,{command:`longPress`,x:r,y:i,durationMs:a,appBundleId:t.appBundleId},n),focus:async(r,i)=>await M(e,X(e,t,r,i),n),type:async(r,i)=>yn(await M(e,{command:`type`,text:r,delayMs:i,textEntryMode:r===`
+`?void 0:`append`,appBundleId:t.appBundleId},n)),fill:async(r,i,a,o,s)=>await M(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 Tn(M,e,t,n,r,i),performGesture:async r=>await Cn(e,t,n,r),gestureViewport:async()=>Sn(await M(e,{command:`gestureViewport`,appBundleId:t.appBundleId},n))}}}async function hn(e,t,n,r,i){let a=l(e)?d(i.surface):void 0;return a?await gn(t,r,i,a):i.button===`primary`?i.count===1?await vn(e,t,n,r,i):await Re(e,r,i,t.appBundleId,async t=>await M(e,t,n)):await _n(e,t,n,r,i.button)}async function gn(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 _n(e,t,n,r,i){return await M(e,{command:`mouseClick`,x:r.x,y:r.y,button:i,appBundleId:t.appBundleId},n)}async function vn(e,t,n,r,i){if(i.doubleTap){let i=await M(e,O([{kind:`doubleTap`,x:r.x,y:r.y}],t.appBundleId),n);return k(i),i}return i.holdMs>0?await M(e,{command:`longPress`,x:r.x,y:r.y,durationMs:i.holdMs,appBundleId:t.appBundleId},n):await M(e,X(e,t,r.x,r.y),n)}function yn(e){let t=e.textEntryRoute;return xn(t)?{textEntryRoute:t}:{}}function bn(t){let n=t.applicationState;return e(n)?{applicationState:n}:{}}function xn(e){return typeof e==`string`&&Qe.includes(e)}function Sn(e){let n=Y(e.x),r=Y(e.y),i=Y(e.x2),a=Y(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 Y(e){return typeof e==`number`&&Number.isFinite(e)?e:void 0}async function Cn(e,t,n,r){if(r.topology===`two`&&$e(e,r.intent),r.topology===`single`&&l(e)){let{start:i,end:a}=v(r);return await M(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}=v(r);return await M(e,{command:`swipe`,direction:wn(i,a),appBundleId:t.appBundleId},n)}return await M(e,{command:`gesture`,gesturePlan:r,appBundleId:t.appBundleId},n)}function wn(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 X(e,t,n,r){return{command:`tap`,x:n,y:r,...s(e)?{synthesized:!0}:{},appBundleId:t.appBundleId}}async function Tn(e,t,n,r,i,a){if(fe(a?.durationMs,{invalidMessage:`scroll durationMs must be a non-negative integer at most ${pe}`}),u(t))return q(await e(t,J(i,n.appBundleId,a?.durationMs),r),{amount:a?.amount,durationMs:a?.durationMs});if(ie(a??{}),l(t))return await fn(e,t,n,r,i,a);let o=sn(a),s;try{s=await e(t,{command:`scroll`,direction:i,...ln(o),appBundleId:n.appBundleId},r)}catch(e){throw on(e)}return cn(s,i,o)}const En={0:`unknown`,1:`notRunning`,2:`runningBackgroundSuspended`,3:`runningBackground`};function Dn(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=En[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 On(e){let t=kn(e.systemSurface),n=a(e.keyboard),r=Dn(e.targetActivation,e=>Be({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:Ee(e.snapshotQuality),qualityPayload:Nn(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 kn(e){if(!In(e)||typeof e.bundleId!=`string`)return;let t=we(e.bundleId);return t&&{bundleId:t.bundleId,kind:t.kind}}function An(e,t,n){let r=n.nodes??[];if(n.runnerFatal===!0||r.length===0&&n.qualityPayload===void 0)return r;let i=Se({raw:t?.raw,interactiveOnly:t?.interactiveOnly,depth:t?.depth,scope:t?.scope,customActions:t?.customActions}),a=Pn(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:xe(i),viewport:a,hittability:{kind:`available`},lineage:{targetId:e},residue:[]}};try{return je(o,i).nodes}catch(e){jn(e,n)}}function jn(e,n){let r=n.quality;if(e instanceof x&&Oe(r))throw new t(`COMMAND_FAILED`,e.message,{...b(e),...n.systemSurface?{systemSurface:n.systemSurface}:{},snapshotQuality:{state:r.state,backend:r.backend,...r.reason?{reason:r.reason}:{},...r.reasonCode?{reasonCode:r.reasonCode}:{}},hint:Mn(n.systemSurface,r)},e);Z(e,n.systemSurface)}function Mn(e,t){return[e?`${e.bundleId} hosts the surface presented over the app, and this capture targeted that surface.`:void 0,...De(t,[])].filter(e=>e!==void 0).join(` `)}function Nn(e,t){if(e!==void 0)return(!In(e)||!Array.isArray(e.nodes)||typeof e.truncated!=`boolean`)&&Z(new x(`invalid-quality-payload`,`iOS runner returned an invalid quality payload`),t),e.scope!==void 0&&e.scope!==null&&Z(new x(`invalid-quality-payload`,`iOS runner quality payload must be unscoped`,{field:`scope`}),t),{nodes:e.nodes,truncated:e.truncated,scope:null}}function Pn(e,t){return y(Fn(t),{fallbackToLargestRoot:!0})??y(Fn(e),{fallbackToLargestRoot:!0})??{kind:`missing`,reason:`not-provided`}}function Fn(e){return e?.filter(e=>e.parentIndex===void 0)??[]}function In(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function Z(e,n){throw e instanceof x?new t(`COMMAND_FAILED`,e.message,{...b(e),...n?{systemSurface:n}:{}},e):e}function Ln(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}=mn(e,n),o={open:(t,n)=>He(e,t,{appBundleId:n?.appBundleId,launchConsole:n?.launchConsole,launchArgs:n?.launchArgs,terminateRunningApp:n?.terminateRunningApp,url:n?.url,runnerOptions:a}),openDevice:()=>Ue(e),close:t=>N(e,t,a),screenshot:(t,n)=>Jn(e,t,n,a),snapshot:async t=>await Rn(e,t,a),readTextAtPoint:async(t,n)=>{let r=l(e)?d(n?.surface):void 0;return r?await Yn(t,r,n?.appBundleId):await Xn(e,t,n,a)},findText:async(t,n)=>({found:(await M(e,{command:`findText`,text:t,appBundleId:n?.appBundleId},n?.signal?{...a,signal:n.signal}:a))?.found===!0}),back:async t=>{if(u(e)){await M(e,J(`menu`,n.appBundleId),a);return}await M(e,{command:pn(t),appBundleId:n.appBundleId},a)},home:async()=>{if(u(e)){await M(e,J(`home`,n.appBundleId),a);return}await M(e,{command:`home`,appBundleId:n.appBundleId},a)},setOrientation:async r=>{let i=Kn(await M(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 M(e,{command:`appSwitcher`,appBundleId:n.appBundleId},a)},actionButton:async()=>{await M(e,{command:`actionButton`,appBundleId:n.appBundleId},a)},tvRemote:async(t,r)=>{await M(e,J(_e(t),n.appBundleId,r),a)},keyboardDismiss:async()=>{let t=await M(e,{command:`keyboardDismiss`,appBundleId:n.appBundleId},a);return{kind:`mechanism`,wasVisible:Q(t,`wasVisible`),dismissed:Q(t,`dismissed`),visible:Q(t,`visible`),mechanism:Gn(t,`keyboardDismissMechanism`)}},keyboardEnter:async()=>{let t=await M(e,{command:`keyboardReturn`,appBundleId:n.appBundleId},a);return{kind:`visibility-echo`,visible:Q(t,`visible`),wasVisible:Q(t,`wasVisible`)}},readClipboard:()=>it(e),writeClipboard:t=>at(e,t,a),setSetting:(t,n,r,i)=>Ct(e,t,n,r,i),readSetting:t=>Tt(e,t),readAlert:t=>et(e,a,t),awaitAlert:t=>tt(e,a,t),acceptAlert:t=>I(e,a,`accept`,t),dismissAlert:t=>I(e,a,`dismiss`,t),...i};return r?qn(e,n,o,r):o}async function Rn(e,t,n){let r=l(e)?d(t?.surface):void 0;return r?await nt({...t,surface:r},t?.signal):await zn(e,t,n)}async function zn(e,t,n){let r=On(await ge(`snapshot_capture`,async()=>await M(e,{command:`snapshot`,appBundleId:t?.appBundleId,interactiveOnly:t?.interactiveOnly,preferredBackend:t?.preferredBackend,customActions:t?.customActions,depth:t?.depth,scope:t?.scope,raw:t?.raw},Wn(n,t?.signal)),{backend:`xctest`}));Bn(e,t,r);let i=Vn(r);return{nodes:Hn(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 Bn(e,n,r){if(!((r.nodes?.length??0)>0)&&!Un(n,r.quality)&&e.kind===`simulator`)throw new t(`COMMAND_FAILED`,`XCTest snapshot returned 0 nodes on iOS simulator.`)}function Vn(e){let t=[];return!e.quality&&e.message&&t.push(e.message),e.systemSurface&&t.push(Ce(e.systemSurface.bundleId)),e.targetActivation&&t.push(rt(e.targetActivation)),t}function Hn(e,t,n){return l(e)?n.nodes??[]:An(e.id,t,n)}function Un(e,t){return te(e?.scope)!==null&&t!==void 0&&t.state!==`sparse`}function Wn(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 Gn(e,t){let n=e[t];return typeof n==`string`?n:void 0}function Kn(e){let n=e.orientation;if(typeof n==`string`&&he.includes(n))return n;throw new t(`COMMAND_FAILED`,`iOS runner returned an invalid orientation result`,{orientation:n})}function qn(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 be(i,n=>ze(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 Jn(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});return await Ge(n,{surface:o}),{}}return r.captureBackend===`runner`?(await G(e,n,r.appBundleId,r.fullscreen,a),{}):await Kt(e,n,{appBundleId:r.appBundleId,pixelDensity:r.pixelDensity,fullscreen:r.fullscreen,runnerOptions:a,normalizeStatusBar:r.normalizeStatusBar,skipIosSimulatorBootCheck:r.skipIosSimulatorBootCheck})}async function Yn(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 Xn(e,t,n,r){let i=await M(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{Ln as createAppleInteractor};

package/dist/src/interactor2.js

@@ -1 +1 @@
-import{N as e}from"./sdk-contracts.js";import{i as t}from"./sdk-batch-runner.js";import{a as n}from"./exec.js";import{o as r}from"./tv-remote.js";import"./command.js";import{t as i}from"./tool-provider3.js";function a(t){let n=async n=>{throw new e(`UNSUPPORTED_OPERATION`,`${n} is not supported on ${t}`)};return{open:()=>n(`open`),openDevice:()=>n(`openDevice`),close:()=>n(`close`),tap:()=>n(`tap`),longPress:()=>n(`longPress`),focus:()=>n(`focus`),type:()=>n(`type`),fill:()=>n(`fill`),scroll:()=>n(`scroll`),screenshot:()=>n(`screenshot`),snapshot:()=>n(`snapshot`),back:()=>n(`back`),setOrientation:()=>n(`setOrientation`),setSetting:()=>n(`setSetting`)}}const o={allowFailure:!0,timeoutMs:3e4};async function s(e,t){n(await i().launchApp(e.id,t,o),`Failed to launch Vega app ${t}`,{appName:t,deviceId:e.id})}async function c(e){n(await i().checkConnected(e.id,o),`Vega device is not connected`,{deviceId:e.id})}async function l(e,t){n(await i().terminateApp(e.id,t,o),`Failed to terminate Vega app ${t}`,{appName:t,deviceId:e.id})}async function u(e,t,a){let o=r(t);n(await i().pressRemote(e.id,o,a,{allowFailure:!0,timeoutMs:1e4+(a??0)}),`Failed to press Vega TV remote ${t}`,{button:t,deviceId:e.id})}const d=[{matches:(e,n)=>t(e)||!!n?.url,message:`Vega open does not support URLs or deep links.`,hint:`Use open <component-id> with an installed Vega app component ID.`},{matches:(e,t)=>!!t?.activity,message:`Vega open does not support Android activity selection.`,hint:`Remove --activity and use the Vega component ID as the open target.`},{matches:(e,t)=>!!t?.launchConsole,message:`Vega open does not support launch-console output.`,hint:`Remove --launch-console and open the Vega component ID directly.`},{matches:(e,t)=>!!t?.terminateRunningApp,message:`Vega open does not support terminating the running app before launch.`,hint:`Close the Vega component explicitly before opening it again.`},{matches:(e,t)=>!!t?.launchArgs?.length,message:`Vega open does not support launch arguments.`,hint:`Remove --launch-arg values and open the Vega component ID directly.`}];function f(e,t){return{...a(`Vega OS`),open:async(t,n)=>{p(t,n),await s(e,t)},openDevice:()=>c(e),close:t=>l(e,t),back:()=>u(e,`back`),home:()=>u(e,`home`),tvRemote:(t,n)=>u(e,t,n)}}function p(t,n){let r=d.find(({matches:e})=>e(t,n));if(r)throw new e(`UNSUPPORTED_OPERATION`,r.message,{hint:r.hint})}export{f as createVegaInteractor};
+import{N as e}from"./sdk-contracts.js";import{i as t}from"./sdk-batch-runner.js";import{o as n}from"./exec.js";import{o as r}from"./tv-remote.js";import"./command.js";import{t as i}from"./tool-provider3.js";function a(t){let n=async n=>{throw new e(`UNSUPPORTED_OPERATION`,`${n} is not supported on ${t}`)};return{open:()=>n(`open`),openDevice:()=>n(`openDevice`),close:()=>n(`close`),tap:()=>n(`tap`),longPress:()=>n(`longPress`),focus:()=>n(`focus`),type:()=>n(`type`),fill:()=>n(`fill`),scroll:()=>n(`scroll`),screenshot:()=>n(`screenshot`),snapshot:()=>n(`snapshot`),back:()=>n(`back`),setOrientation:()=>n(`setOrientation`),setSetting:()=>n(`setSetting`)}}const o={allowFailure:!0,timeoutMs:3e4};async function s(e,t){n(await i().launchApp(e.id,t,o),`Failed to launch Vega app ${t}`,{appName:t,deviceId:e.id})}async function c(e){n(await i().checkConnected(e.id,o),`Vega device is not connected`,{deviceId:e.id})}async function l(e,t){n(await i().terminateApp(e.id,t,o),`Failed to terminate Vega app ${t}`,{appName:t,deviceId:e.id})}async function u(e,t,a){let o=r(t);n(await i().pressRemote(e.id,o,a,{allowFailure:!0,timeoutMs:1e4+(a??0)}),`Failed to press Vega TV remote ${t}`,{button:t,deviceId:e.id})}const d=[{matches:(e,n)=>t(e)||!!n?.url,message:`Vega open does not support URLs or deep links.`,hint:`Use open <component-id> with an installed Vega app component ID.`},{matches:(e,t)=>!!t?.activity,message:`Vega open does not support Android activity selection.`,hint:`Remove --activity and use the Vega component ID as the open target.`},{matches:(e,t)=>!!t?.launchConsole,message:`Vega open does not support launch-console output.`,hint:`Remove --launch-console and open the Vega component ID directly.`},{matches:(e,t)=>!!t?.terminateRunningApp,message:`Vega open does not support terminating the running app before launch.`,hint:`Close the Vega component explicitly before opening it again.`},{matches:(e,t)=>!!t?.launchArgs?.length,message:`Vega open does not support launch arguments.`,hint:`Remove --launch-arg values and open the Vega component ID directly.`}];function f(e,t){return{...a(`Vega OS`),open:async(t,n)=>{p(t,n),await s(e,t)},openDevice:()=>c(e),close:t=>l(e,t),back:()=>u(e,`back`),home:()=>u(e,`home`),tvRemote:(t,n)=>u(e,t,n)}}function p(t,n){let r=d.find(({matches:e})=>e(t,n));if(r)throw new e(`UNSUPPORTED_OPERATION`,r.message,{hint:r.hint})}export{f as createVegaInteractor};

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.20`,stdout:e=>{process.stdout.write(e)},stderr:e=>{process.stderr.write(e)}}).catch(()=>process.exit(1));export{};