agent-device 0.16.5 → 0.16.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (74) hide show
  1. package/android-multitouch-helper/dist/{agent-device-android-multitouch-helper-0.16.5.apk → agent-device-android-multitouch-helper-0.16.7.apk} +0 -0
  2. package/android-multitouch-helper/dist/agent-device-android-multitouch-helper-0.16.7.apk.sha256 +1 -0
  3. package/android-multitouch-helper/dist/{agent-device-android-multitouch-helper-0.16.5.manifest.json → agent-device-android-multitouch-helper-0.16.7.manifest.json} +4 -4
  4. package/android-snapshot-helper/dist/agent-device-android-snapshot-helper-0.16.7.apk +0 -0
  5. package/android-snapshot-helper/dist/agent-device-android-snapshot-helper-0.16.7.apk.sha256 +1 -0
  6. package/android-snapshot-helper/dist/{agent-device-android-snapshot-helper-0.16.5.manifest.json → agent-device-android-snapshot-helper-0.16.7.manifest.json} +6 -6
  7. package/dist/src/1010.js +1 -0
  8. package/dist/src/1231.js +1 -1
  9. package/dist/src/1352.js +1 -0
  10. package/dist/src/1998.js +1 -0
  11. package/dist/src/208.js +1 -1
  12. package/dist/src/221.js +6 -6
  13. package/dist/src/2415.js +31 -0
  14. package/dist/src/2805.js +1 -0
  15. package/dist/src/5186.js +1 -0
  16. package/dist/src/5310.js +1 -0
  17. package/dist/src/5792.js +1 -0
  18. package/dist/src/6085.js +1 -0
  19. package/dist/src/6629.js +1 -0
  20. package/dist/src/8114.js +4 -0
  21. package/dist/src/8133.js +1 -0
  22. package/dist/src/8502.js +1 -0
  23. package/dist/src/8699.js +1 -0
  24. package/dist/src/8806.js +7 -0
  25. package/dist/src/940.js +1 -1
  26. package/dist/src/9404.js +1 -0
  27. package/dist/src/9471.js +1 -0
  28. package/dist/src/9533.js +1 -0
  29. package/dist/src/9542.js +3 -3
  30. package/dist/src/9671.js +1 -0
  31. package/dist/src/android-adb.js +1 -1
  32. package/dist/src/android-snapshot-helper.d.ts +2 -1
  33. package/dist/src/android-snapshot-helper.js +1 -1
  34. package/dist/src/android.js +5 -0
  35. package/dist/src/apple.js +1 -0
  36. package/dist/src/apps.js +13 -0
  37. package/dist/src/args.js +449 -0
  38. package/dist/src/batch.js +1 -1
  39. package/dist/src/cli.js +36 -492
  40. package/dist/src/command-metadata.js +1 -0
  41. package/dist/src/command-surface.js +1 -0
  42. package/dist/src/contracts.d.ts +1 -0
  43. package/dist/src/devices.js +1 -0
  44. package/dist/src/devices~1.js +1 -0
  45. package/dist/src/devices~2.js +1 -0
  46. package/dist/src/find.js +1 -0
  47. package/dist/src/finders.d.ts +1 -0
  48. package/dist/src/generic.js +9 -0
  49. package/dist/src/index.d.ts +12 -0
  50. package/dist/src/input-actions.js +1 -0
  51. package/dist/src/input-actions~1.js +1 -0
  52. package/dist/src/interaction.js +1 -0
  53. package/dist/src/internal/bin.js +5 -2
  54. package/dist/src/internal/daemon.js +1 -100
  55. package/dist/src/lease.js +1 -0
  56. package/dist/src/linux.js +1 -0
  57. package/dist/src/notifications.js +1 -0
  58. package/dist/src/react-native.js +1 -0
  59. package/dist/src/record-trace.js +26 -0
  60. package/dist/src/recording-provider.js +1 -0
  61. package/dist/src/selector-runtime.js +1 -0
  62. package/dist/src/selectors.d.ts +1 -0
  63. package/dist/src/server.js +1 -1
  64. package/dist/src/session.js +29 -0
  65. package/dist/src/snapshot.js +2 -0
  66. package/package.json +4 -1
  67. package/server.json +2 -2
  68. package/android-multitouch-helper/dist/agent-device-android-multitouch-helper-0.16.5.apk.sha256 +0 -1
  69. package/android-snapshot-helper/dist/agent-device-android-snapshot-helper-0.16.5.apk +0 -0
  70. package/android-snapshot-helper/dist/agent-device-android-snapshot-helper-0.16.5.apk.sha256 +0 -1
  71. package/dist/src/1769.js +0 -7
  72. package/dist/src/6277.js +0 -4
  73. package/dist/src/7519.js +0 -1
  74. package/dist/src/89.js +0 -1
@@ -0,0 +1 @@
1
+ import{withSuccessText as e,successText as n}from"./1998.js";import{AppError as i}from"./9152.js";function t(e){let n=e.appId??e.bundleId??e.packageName;return{session:e.session,appId:n,appBundleId:e.bundleId,package:e.packageName}}function a(e,n,i){return{deviceId:n,deviceName:i,..."android"===e?{serial:n}:"ios"===e?{udid:n}:{}}}function r(e,n={}){let i=n.includeAndroidSerial??!0;return{platform:e.platform,target:e.target,device:e.name,id:e.id,..."ios"===e.platform?{device_udid:e.ios?.udid??e.id,ios_simulator_device_set:e.ios?.simulatorSetPath??null}:{},..."android"===e.platform&&i?{serial:e.android?.serial??e.id}:{}}}function d(e){return{name:e.name,...r(e.device,{includeAndroidSerial:!1}),createdAt:e.createdAt}}function o(e){return{platform:e.platform,id:e.id,name:e.name,kind:e.kind,target:e.target,..."boolean"==typeof e.booted?{booted:e.booted}:{}}}function u(e){return e.bundleId??e.package??e.app}function l(n){return e({app:n.app,appPath:n.appPath,platform:n.platform,...n.appId?{appId:n.appId}:{},...n.bundleId?{bundleId:n.bundleId}:{},...n.package?{package:n.package}:{}},`Installed: ${u(n)}`)}function s(e){return e.appName??e.bundleId??e.packageName??e.launchTarget}function p(n){return e({launchTarget:n.launchTarget,...n.appName?{appName:n.appName}:{},...n.appId?{appId:n.appId}:{},...n.bundleId?{bundleId:n.bundleId}:{},...n.packageName?{package:n.packageName}:{},...n.installablePath?{installablePath:n.installablePath}:{},...n.archivePath?{archivePath:n.archivePath}:{},...n.materializationId?{materializationId:n.materializationId}:{},...n.materializationExpiresAt?{materializationExpiresAt:n.materializationExpiresAt}:{}},`Installed: ${s(n)}`)}function c(n){let i=n.appName??n.appBundleId??n.session;return e({session:n.session,...n.appName?{appName:n.appName}:{},...n.appBundleId?{appBundleId:n.appBundleId}:{},...n.startup?{startup:n.startup}:{},...n.runtime?{runtime:n.runtime}:{},...n.device?r(n.device):{}},i?`Opened: ${i}`:"Opened")}function m(e){return{session:e.session,...e.shutdown?{shutdown:e.shutdown}:{},...n(e.session?`Closed: ${e.session}`:"Closed")}}function f(e){return{nodes:e.nodes,truncated:e.truncated,...e.appName?{appName:e.appName}:{},...e.appBundleId?{appBundleId:e.appBundleId}:{},...e.visibility?{visibility:e.visibility}:{},...e.androidSnapshot?{androidSnapshot:e.androidSnapshot}:{},...e.warnings&&e.warnings.length>0?{warnings:e.warnings}:{},...e.unchanged?{unchanged:e.unchanged}:{}}}function v(e,n,t,a){let r=t(e[n]);if(void 0===r)throw new i("COMMAND_FAILED",a,{response:e});return r}function g(e,n){return v(e,n,y,`Daemon response is missing "${n}".`)}function I(e,n){return y(e[n])}function h(e,n){var i;let t;return i=y,null===(t=e[n])?null:i(t)}function b(e,n){return v(e,n,A,`Daemon response is missing numeric "${n}".`)}function N(e,n){return v(e,n,z,`Daemon response has invalid "${n}".`)}function S(e,n){return v(e,n,P,`Daemon response has invalid "${n}".`)}function R(e,n){return function(e){return"tv"===e||"mobile"===e||"desktop"===e?e:void 0}(e[n])??"mobile"}function _(e,n){let i=e[n];if(!C(i))return;let t=k(i,"x"),a=k(i,"y"),r=k(i,"width"),d=k(i,"height");if(void 0!==t&&void 0!==a&&void 0!==r&&void 0!==d)return{x:t,y:a,width:r,height:d}}function D(e,n){let i=e[n];if(!C(i))return;let t=k(i,"x"),a=k(i,"y");if(void 0!==t&&void 0!==a)return{x:t,y:a}}function k(e,n){let i=e[n];return"number"==typeof i?i:void 0}function y(e){return"string"==typeof e&&e.length>0?e:void 0}function A(e){return"number"==typeof e&&Number.isFinite(e)?e:void 0}function z(e){return"ios"===e||"macos"===e||"android"===e||"linux"===e?e:void 0}function P(e){return"simulator"===e||"emulator"===e||"device"===e?e:void 0}function w(e){if(!C(e))throw new i("COMMAND_FAILED","Daemon returned an unexpected response shape.",{value:e});return e}function C(e){return"object"==typeof e&&null!==e}function E(e){let n={};for(let[i,t]of Object.entries(e))void 0!==t&&(n[i]=t);return n}function x(e){return e.split("\n").map(e=>e.trim()).filter(e=>e.length>0)}export{w as asRecord,t as buildAppIdentifiers,a as buildDeviceIdentifiers,C as isRecord,R as readDeviceTarget,h as readNullableString,I as readOptionalString,D as readPoint,_ as readRect,S as readRequiredDeviceKind,b as readRequiredNumber,N as readRequiredPlatform,g as readRequiredString,u as resolveDeployResultTarget,s as resolveInstallFromSourceResultTarget,m as serializeCloseResult,l as serializeDeployResult,o as serializeDevice,p as serializeInstallFromSourceResult,c as serializeOpenResult,d as serializeSessionListEntry,f as serializeSnapshotResult,x as splitNonEmptyTrimmedLines,E as stripUndefined};
@@ -0,0 +1 @@
1
+ let e={devices:"List available devices.",boot:"Boot or prepare a selected device without using CLI positional arguments.",apps:"List installed apps.",session:"List active sessions.",open:"Open an app, deep link, URL, or platform surface.",close:"Close an app or end the active session.",install:"Install an app binary.",reinstall:"Reinstall an app binary.","install-from-source":"Install an app from a structured source.",push:"Deliver a push payload.","trigger-app-event":"Trigger an app-defined event.",snapshot:"Capture an accessibility snapshot.",screenshot:"Capture a screenshot.",diff:"Diff accessibility snapshots.",wait:"Wait for duration, text, ref, or selector.",alert:"Inspect or handle platform alerts.",appstate:"Show foreground app or activity.",back:"Navigate back.",home:"Go to the home screen.",rotate:"Rotate device orientation.","app-switcher":"Open the app switcher.",keyboard:"Inspect or dismiss the keyboard.",clipboard:"Read or write clipboard text.","react-native":"Run supported React Native app automation helpers.",replay:"Replay a recorded session.",test:"Run one or more replay scripts.",perf:"Show session performance metrics.",logs:"Manage session app logs.",network:"Show recent HTTP traffic.",record:"Start or stop screen recording.",trace:"Start or stop trace capture.",settings:"Change OS settings and app permissions.",metro:"Prepare Metro runtime or reload React Native apps.",click:"Click or tap a semantic UI target by ref, selector, or point.",press:"Press a semantic UI target by ref, selector, or point.",fill:"Fill text into a semantic UI target by ref, selector, or point.",longpress:"Long press by ref, selector, or point.",swipe:"Swipe between two points.",focus:"Focus input at coordinates.",type:"Type text in the focused field.",scroll:"Scroll in a direction or to an edge.",get:"Get element text or attributes.",is:"Assert UI state.",find:"Find an element and optionally act on it.",gesture:"Run a structured gesture.",batch:"Run multiple structured command steps in one daemon request."};function t(t){let r=e[t];if(!r)throw Error(`Missing command description for ${t}`);return r}function r(){return Object.entries(e).map(([e,t])=>({name:e,description:t}))}export{r as listCommandDescriptionMetadata,t as requireCommandDescription};
@@ -0,0 +1 @@
1
+ import{AppError as e}from"./9152.js";let s=["out","overlayRefs","screenshotFullscreen","screenshotMaxSize","screenshotNoStabilize"],n=["screenshotFullscreen","screenshotMaxSize","screenshotNoStabilize"],t=[{key:"screenshotFullscreen",names:["--fullscreen"],type:"boolean",usageLabel:"--fullscreen",usageDescription:"Screenshot: capture the full screen instead of the app window"},{key:"screenshotMaxSize",names:["--max-size"],type:"int",min:1,usageLabel:"--max-size <px>",usageDescription:"Screenshot: downscale so the longest edge is at most <px>"},{key:"screenshotNoStabilize",names:["--no-stabilize"],type:"boolean",usageLabel:"--no-stabilize",usageDescription:"Screenshot: skip Android demo-mode/status-bar stabilization and settle delay for low-latency capture loops"}];function r(e){return l({overlayRefs:e?.overlayRefs,fullscreen:e?.screenshotFullscreen,maxSize:e?.screenshotMaxSize,stabilize:!e?.screenshotNoStabilize&&void 0})}function o(e={}){return l({overlayRefs:e.overlayRefs,screenshotFullscreen:e.screenshotFullscreen??e.fullscreen,screenshotMaxSize:e.screenshotMaxSize??e.maxSize,screenshotNoStabilize:e.screenshotNoStabilize??(!1===e.stabilize||void 0)})}function i(e,s){s?.screenshotFullscreen&&e.push("--fullscreen"),"number"==typeof s?.screenshotMaxSize&&e.push("--max-size",String(s.screenshotMaxSize)),s?.screenshotNoStabilize&&e.push("--no-stabilize")}function a(s){let{args:n,flags:t,index:r}=s,o=n[r];if("--fullscreen"===o)return t.screenshotFullscreen=!0,{handled:!0,nextIndex:r};if("--no-stabilize"===o)return t.screenshotNoStabilize=!0,{handled:!0,nextIndex:r};if("--max-size"===o){let s=n[r+1],o=void 0===s?NaN:Number(s);if(!Number.isInteger(o)||o<1)throw new e("INVALID_ARGS","screenshot --max-size requires a positive integer");return t.screenshotMaxSize=o,{handled:!0,nextIndex:r+1}}return{handled:!1}}function l(e){return Object.fromEntries(Object.entries(e).filter(e=>void 0!==e[1]))}export{n as SCREENSHOT_ACTION_FLAG_KEYS,s as SCREENSHOT_COMMAND_FLAG_KEYS,t as SCREENSHOT_SPECIFIC_FLAG_DEFINITIONS,i as appendScreenshotScriptFlags,a as readScreenshotScriptFlag,o as screenshotFlagsFromOptions,r as screenshotOptionsFromFlags};
@@ -0,0 +1 @@
1
+ let e={alert:"alert",appState:"appstate",appSwitcher:"app-switcher",apps:"apps",back:"back",batch:"batch",boot:"boot",click:"click",close:"close",clipboard:"clipboard",devices:"devices",diff:"diff",fill:"fill",find:"find",focus:"focus",gesture:"gesture",get:"get",home:"home",install:"install",installFromSource:"install-from-source",is:"is",keyboard:"keyboard",logs:"logs",longPress:"longpress",network:"network",open:"open",perf:"perf",press:"press",push:"push",record:"record",reactNative:"react-native",reinstall:"reinstall",replay:"replay",rotate:"rotate",scroll:"scroll",screenshot:"screenshot",settings:"settings",snapshot:"snapshot",swipe:"swipe",test:"test",trace:"trace",triggerAppEvent:"trigger-app-event",type:"type",wait:"wait"},t={installSource:"install_source",leaseAllocate:"lease_allocate",leaseHeartbeat:"lease_heartbeat",leaseRelease:"lease_release",releaseMaterializedPaths:"release_materialized_paths",runtime:"runtime",sessionList:"session_list"},s={auth:"auth",connect:"connect",connection:"connection",disconnect:"disconnect",mcp:"mcp",metro:"metro",reactDevtools:"react-devtools",session:"session"},a="gesture requires one of: pan, fling, swipe, pinch, rotate, transform",r=[e.devices,e.boot,e.apps,e.open,e.close,e.install,e.reinstall,e.installFromSource,e.push,e.triggerAppEvent,e.snapshot,e.screenshot,e.diff,e.wait,e.alert,e.settings,e.click,e.press,e.longPress,e.swipe,e.focus,e.type,e.fill,e.scroll,e.get,e.gesture,e.is,e.find,e.perf,e.logs,e.network,e.record,e.trace,e.test,e.appState,e.back,e.home,e.rotate,e.appSwitcher,e.keyboard,e.clipboard,e.reactNative],o=l(s.auth,s.connect,s.connection,s.disconnect,s.mcp,s.reactDevtools);l(s.auth,s.connect,s.connection,s.disconnect,s.mcp,s.metro,s.reactDevtools,s.session,e.appState,e.batch,e.devices,e.gesture,e.replay,e.test,e.trace);let i={inventory:l(t.sessionList,e.devices,e.apps),state:l(e.boot,e.appState),observability:l(e.perf,e.logs,e.network),replay:l(e.replay,e.test),snapshot:l(e.snapshot,e.diff,e.wait,e.alert,e.settings),replayScopedAction:l(e.alert,e.back,e.click,e.clipboard,e.diff,e.fill,e.find,e.gesture,e.get,e.home,e.is,e.keyboard,e.longPress,"pinch",e.press,e.record,e.reactNative,e.rotate,e.screenshot,e.scroll,e.settings,e.snapshot,e.swipe,e.type,e.wait),androidBlockingDialogGuardedAction:l(e.back,e.click,e.fill,e.focus,e.gesture,e.home,e.keyboard,e.longPress,"fling","pan","pinch",e.press,e.rotate,"rotate-gesture",e.scroll,e.swipe,"transform-gesture",e.type),selectorValidationExempt:l(t.sessionList,e.devices,t.releaseMaterializedPaths),leaseAdmissionExempt:l(t.sessionList,e.devices,t.releaseMaterializedPaths,t.leaseAllocate,t.leaseHeartbeat,t.leaseRelease),leaseHandler:l(t.leaseAllocate,t.leaseHeartbeat,t.leaseRelease),sessionHandler:l(t.installSource,t.releaseMaterializedPaths,t.sessionList,e.appState,e.apps,e.batch,e.boot,e.clipboard,e.close,e.devices,e.install,e.keyboard,e.logs,e.network,e.open,e.perf,e.push,e.reinstall,e.replay,e.test,e.triggerAppEvent,t.runtime),reactNativeHandler:l(e.reactNative),recordTraceHandler:l(e.record,e.trace),findHandler:l(e.find),interactionHandler:l(e.click,e.fill,e.get,e.is,e.longPress,e.press,e.type)};function l(...e){return new Set(e)}function n(){return[...Object.values(e),...Object.values(s)].sort()}function c(t){return Object.values(e).includes(t)||t===s.metro||t===s.session}function p(){return n().filter(e=>!o.has(e))}export{r as BATCH_COMMAND_NAMES,i as DAEMON_COMMAND_GROUPS,a as GESTURE_SUBCOMMAND_ERROR,t as INTERNAL_COMMANDS,e as PUBLIC_COMMANDS,c as isClientBackedCliCommandName,n as listCliCommandNames,p as listMcpExposedCommandNames};
@@ -0,0 +1 @@
1
+ import{splitSelectorFromArgs as t,tryParseSelectorChain as e}from"./940.js";import{AppError as r}from"./9152.js";import{compactRecord as i}from"./9404.js";import{PUBLIC_COMMANDS as n}from"./5792.js";import{readLocationCoordinate as o}from"./1998.js";import{screenshotOptionsFromFlags as s,screenshotFlagsFromOptions as a}from"./5310.js";function l(t,e){return r=>u(t,e?e(r):[],r)}function u(t,e,r){return{command:t,positionals:e,options:function(t){var e;let r="mobile"===(e=t.deviceTarget??t.target)||"tv"===e||"desktop"===e?e:void 0;if(void 0===r&&void 0===t.target)return t;let{target:i,...n}=t;return void 0===r?n:{...n,target:r}}(r)}}function c(t){return i({session:t.session,platform:t.platform,deviceTarget:t.target,device:t.device,udid:t.udid,serial:t.serial,iosSimulatorDeviceSet:t.iosSimulatorDeviceSet,androidDeviceAllowlist:t.androidDeviceAllowlist})}function f(t){return{platform:t.platform,target:t.target,device:t.device,udid:t.udid,serial:t.serial,iosSimulatorDeviceSet:t.iosSimulatorDeviceSet,androidDeviceAllowlist:t.androidDeviceAllowlist}}function d(t){return i({depth:t.snapshotDepth,scope:t.snapshotScope,raw:t.snapshotRaw})}function p(t){return{depth:t.snapshotDepth,scope:t.snapshotScope,raw:t.snapshotRaw}}function m(t){return i({count:t.count,intervalMs:t.intervalMs,holdMs:t.holdMs,jitterPx:t.jitterPx,doubleTap:t.doubleTap})}function h(t){return"ref"in t&&void 0!==t.ref?i({kind:"ref",ref:t.ref,label:t.label}):"selector"in t&&void 0!==t.selector?{kind:"selector",selector:t.selector}:{kind:"point",x:t.x,y:t.y}}function g(t){let e=S(t);if("string"==typeof e.ref)return[e.ref,...A(e.label)];if("string"==typeof e.selector)return[e.selector];if("point"===e.kind||void 0!==e.x||void 0!==e.y)return[String(v(e.x,"x")),String(v(e.y,"y"))];throw new r("INVALID_ARGS","interaction requires @ref, selector, or point target")}function w(t){let e=S(t);if("string"==typeof e.ref)return[e.ref,...A(e.label)];if("string"==typeof e.selector)return[e.selector];throw new r("INVALID_ARGS","element command requires @ref or selector target")}function S(t){if(!t||"object"!=typeof t||Array.isArray(t))throw new r("INVALID_ARGS","Expected target object.");let e=t.target;return e&&"object"==typeof e&&!Array.isArray(e)?e:t}function v(t,e){if("number"!=typeof t||!Number.isFinite(t))throw new r("INVALID_ARGS",`point target requires numeric ${e}.`);return t}function A(t){return"string"==typeof t&&t.length>0?[t]:[]}function _(t){if(t[0]?.startsWith("@"))return{ref:t[0],label:D(t.slice(1))};let e=t.join(" ").trim();if(!e)throw new r("INVALID_ARGS","get requires @ref or selector expression");return{selector:e}}function I(t){if("text"===t||"attrs"===t)return t;throw new r("INVALID_ARGS","get only supports text or attrs")}function N(e,i={}){let n=t(e,i);if(!n)throw new r("INVALID_ARGS","is requires a selector expression");return n}function x(t,e){try{let e=JSON.parse(t);if(e&&"object"==typeof e&&!Array.isArray(e))return e}catch{}throw new r("INVALID_ARGS",`${e} must be a JSON object`)}function D(t){return t.join(" ").trim()||void 0}function R(...t){return new Set(t)}function b(t){return new Set(t)}function y(t,e){return void 0!==t&&e.has(t)}function M(t){return void 0!==t&&""!==t.trim()&&Number.isFinite(Number(t))}function G(t){return void 0===t?void 0:Number(t)}function L(t){return void 0===t?[]:[t]}function F(t){return void 0===t?[]:[String(t)]}function V(t,e){if(void 0===t||""===t)throw new r("INVALID_ARGS",e);return t}function C(t,e){if("string"!=typeof t||0===t.length)throw new r("INVALID_ARGS",e);return t}function k(t){if(!t)return null;let e=Number(t);return Number.isFinite(e)?e:null}let j={snapshot:(t,e)=>({...c(e),interactiveOnly:e.snapshotInteractiveOnly,compact:e.snapshotCompact,depth:e.snapshotDepth,scope:e.snapshotScope,raw:e.snapshotRaw,forceFull:e.snapshotForceFull}),screenshot:(t,e)=>({...c(e),path:t[0]??e.out,...s(e)}),diff:(t,e)=>{if("snapshot"!==t[0])throw new r("INVALID_ARGS","Only diff snapshot is available through this parser.");return{...c(e),kind:"snapshot",out:e.out,interactiveOnly:e.snapshotInteractiveOnly,compact:e.snapshotCompact,depth:e.snapshotDepth,scope:e.snapshotScope,raw:e.snapshotRaw}},wait:(t,e)=>(function(t,e){let i=E(t);if(!i)throw new r("INVALID_ARGS","wait requires <ms>, text <text>, @ref, or <selector> [timeoutMs].");let n={...f(e),...p(e)};if("sleep"===i.kind)return{...n,durationMs:i.durationMs};if("text"===i.kind){if(!i.text)throw new r("INVALID_ARGS","wait requires text.");return{...n,text:i.text,...K(i.timeoutMs)}}return"ref"===i.kind?{...n,ref:i.rawRef,...K(i.timeoutMs)}:{...n,selector:i.selectorExpression,...K(i.timeoutMs)}})(t,e),alert:(t,e)=>({...c(e),...function(t){if(t.length>2)throw new r("INVALID_ARGS","alert accepts at most action and timeout arguments.");return i({action:function(t){let e=t?.toLowerCase();if(void 0===e||"get"===e||"accept"===e||"dismiss"===e||"wait"===e)return e;throw new r("INVALID_ARGS","alert action must be get, accept, dismiss, or wait.")}(t[0]),timeoutMs:function(t,e){if(void 0===t)return;let i=Number(t);if(Number.isFinite(i))return i;throw new r("INVALID_ARGS",`${e} must be a finite number.`)}(t[1],"alert timeout")})}(t)}),settings:(t,e)=>(function(t,e){let i=f(e),n=t[0],s=t[1];if(y(n,P)&&y(s,T))return{...i,setting:n,state:s};if("location"===n&&"set"===s)return{...i,setting:n,state:s,latitude:o(t[2],"latitude"),longitude:o(t[3],"longitude")};if("appearance"===n&&y(s,O)||y(n,H)&&y(s,U)||"fingerprint"===n&&y(s,W))return{...i,setting:n,state:s};if("permission"===n&&y(s,$))return{...i,setting:n,state:s,permission:function(t){if(y(t,J))return t;throw new r("INVALID_ARGS","settings permission requires a permission target.")}(t[2]),mode:function(t){if(void 0===t||"full"===t||"limited"===t)return t;throw new r("INVALID_ARGS","settings permission mode must be full or limited.")}(t[3])};if("clear-app-state"===n){let e="clear"===s?t[2]:s;return{...i,setting:n,state:"clear",app:e}}throw new r("INVALID_ARGS","Invalid settings arguments.")})(t,e)},q={snapshot:l(n.snapshot),screenshot:t=>u(n.screenshot,L(t.path),{...t,...a(t)}),diff:l(n.diff,t=>[C(t.kind,"diff requires kind")]),wait:l(n.wait,t=>(function(t){if(1!==[void 0!==t.durationMs?"durationMs":void 0,void 0!==t.text?"text":void 0,void 0!==t.ref?"ref":void 0,void 0!==t.selector?"selector":void 0].filter(Boolean).length)throw new r("INVALID_ARGS","wait command requires exactly one of durationMs, text, ref, or selector.");if(void 0!==t.durationMs)return[String(t.durationMs)];let i=F(t.timeoutMs);if(void 0!==t.text)return["text",t.text,...i];if(void 0!==t.ref)return[t.ref,...i];let n=t.selector;if(!e(n))throw new r("INVALID_ARGS",`Invalid wait selector: ${n}`);return[n,...i]})(t)),alert:l(n.alert,t=>{var e;return[(e=t).action??"get",...F(e.timeoutMs)]}),settings:l(n.settings,t=>{var e;return"clear-app-state"===(e=t).setting?[e.setting,...L(e.app)]:"location"===e.setting&&"set"===e.state?[e.setting,e.state,String(e.latitude),String(e.longitude)]:"permission"===e.setting?[e.setting,e.state,e.permission,...L(e.mode)]:[e.setting,e.state]})};function E(r){let i=r[0];if(void 0===i)return null;let n=k(i);if(null!==n)return{kind:"sleep",durationMs:n};let o=k(r[r.length-1]);if("text"===i)return{kind:"text",text:(null!==o?r.slice(1,-1).join(" "):r.slice(1).join(" ")).trim(),timeoutMs:o};if(i.startsWith("@"))return{kind:"ref",rawRef:i,timeoutMs:o};let s=t(null!==o?r.slice(0,-1):r.slice());return s&&0===s.rest.length&&e(s.selectorExpression)?{kind:"selector",selectorExpression:s.selectorExpression,timeoutMs:o}:{kind:"text",text:(null!==o?r.slice(0,-1).join(" "):r.join(" ")).trim(),timeoutMs:o}}function K(t){return null===t?{}:{timeoutMs:t}}let P=R("wifi","airplane","location","animations"),T=R("on","off"),O=R("light","dark","toggle"),H=R("faceid","touchid"),U=R("match","nonmatch","enroll","unenroll"),W=R("match","nonmatch"),$=R("grant","deny","reset"),J=R("camera","microphone","photos","contacts","contacts-limited","notifications","calendar","location","location-always","media-library","motion","reminders","siri","accessibility","screen-recording","input-monitoring");export{j as captureCliReaders,q as captureDaemonWriters,b as commandNameSet,c as commonInputFromFlags,l as direct,w as elementTargetPositionals,g as interactionTargetPositionals,M as isFiniteNumberString,G as optionalCliNumber,F as optionalNumber,L as optionalString,D as optionalTrimmedText,k as parseTimeout,E as parseWaitPositionals,_ as readElementTargetFromPositionals,I as readGetFormat,x as readJsonObject,m as repeatedInputFromFlags,u as request,C as requiredDaemonString,V as requiredString,f as selectionOptionsFromFlags,d as selectorSnapshotInputFromFlags,p as selectorSnapshotOptionsFromFlags,N as splitRequiredSelector,h as targetInputFromClientTarget};
@@ -0,0 +1 @@
1
+ import{AppError as t}from"./9152.js";let e=["camera","microphone","photos","contacts","contacts-limited","notifications","calendar","location","location-always","media-library","motion","reminders","siri"];function r(e){let r=e.trim().toLowerCase();if("grant"===r)return"grant";if("deny"===r)return"deny";if("reset"===r)return"reset";throw new t("INVALID_ARGS",`Invalid permission action: ${e}. Use grant|deny|reset.`)}function i(r){let i=r?.trim().toLowerCase();if("camera"===i||"microphone"===i||"photos"===i||"contacts"===i||"contacts-limited"===i||"notifications"===i||"calendar"===i||"location"===i||"location-always"===i||"media-library"===i||"motion"===i||"reminders"===i||"siri"===i)return i;throw new t("INVALID_ARGS",`permission setting requires a target: ${e.join("|")}`)}function n(e){let r=e.trim().toLowerCase();if("light"===r)return"light";if("dark"===r)return"dark";if("toggle"===r)return"toggle";throw new t("INVALID_ARGS",`Invalid appearance state: ${e}. Use light|dark|toggle.`)}function o(e){let r=e.toLowerCase();if("on"===r||"true"===r||"1"===r)return!0;if("off"===r||"false"===r||"0"===r)return!1;throw new t("INVALID_ARGS",`Invalid setting state: ${e}`)}function a(t){return t.map(t=>({args:t.args.join(" "),exitCode:t.exitCode,stderr:t.stderr.slice(0,400)}))}export{n as parseAppearanceAction,r as parsePermissionAction,i as parsePermissionTarget,o as parseSettingState,a as summarizeCommandAttemptFailures};
@@ -0,0 +1,4 @@
1
+ import e from"node:path";import t from"node:crypto";import n from"node:fs";import{resolveUserPath as r,expandUserHomePath as o}from"./3267.js";import{findProjectRoot as s}from"./9671.js";function i(e,t){let n=[],r=e+t.toString(),o=r.indexOf("\n");for(;-1!==o;){let e=r.slice(0,o).trim();r=r.slice(o+1),e&&n.push(e),o=r.indexOf("\n")}return{lines:n,buffer:r}}function a(t){let n,s=(n=(t??"").trim())?r(n):e.join(o("~"),".agent-device");return{baseDir:s,infoPath:e.join(s,"daemon.json"),lockPath:e.join(s,"daemon.lock"),logPath:e.join(s,"daemon.log"),sessionsDir:e.join(s,"sessions")}}function u(e){let t=(e??"").trim().toLowerCase();return"http"===t?"http":"dual"===t?"dual":"socket"}function l(e){let t=(e??"").trim().toLowerCase();return"auto"===t?"auto":"socket"===t?"socket":"http"===t?"http":"auto"}function p(e){return"tenant"===(e??"").trim().toLowerCase()?"tenant":"none"}function f(e){if(!e)return;let t=e.trim();if(t&&/^[a-zA-Z0-9._-]{1,128}$/.test(t))return t}let m=/(?:^|[^\w$.])(?:import|export)\s+(?:type\s+)?(?:[^'"`]*?\s+from\s+)?['"]([^'"]+)['"]/gm,c=/import\(\s*['"]([^'"]+)['"]\s*\)/gm,d=[".ts",".tsx",".js",".jsx",".mjs",".cjs"];function h(){let e=process.argv[1];return e?g(e):"unknown"}function g(r,o=s()){try{let s=e.resolve(o),i=[e.resolve(r)],a=new Set,u=[];for(;i.length>0;){let t=i.pop();if(!t||a.has(t))continue;a.add(t);let r=n.statSync(t);if(!r.isFile())continue;let o=e.relative(s,t)||t;u.push(`${o}:${r.size}:${Math.trunc(r.mtimeMs)}`);let l=n.readFileSync(t,"utf8");for(let n of function(e){let t=new Set;return v(e,m,t),v(e,c,t),[...t]}(l)){let r=function(t,n){let r=e.resolve(e.dirname(t),n),o=y(r);if(o)return o;for(let e of d){let t=y(`${r}${e}`);if(t)return t}for(let t of d){let n=y(e.join(r,`index${t}`));if(n)return n}return null}(t,n);r&&i.push(r)}}let l=u.sort().join("|"),p=t.createHash("sha1").update(l).digest("hex");return`graph:${u.length}:${p}`}catch{return"unknown"}}function v(e,t,n){t.lastIndex=0;let r=null;for(;null!==(r=t.exec(e));){let e=r[1]?.trim();e?.startsWith(".")&&n.add(e)}}function y(e){try{return n.statSync(e).isFile()?e:null}catch{return null}}function $(e){return e.meta?.requestProgress==="replay-test"}function S(e){return!!e&&"object"==typeof e&&"progress"===e.type&&!!e.event}function x(e){return!!e&&"object"==typeof e&&"response"===e.type&&!!e.response}function j(e){return`${JSON.stringify({type:"progress",event:e})}
2
+ `}function D(e){return`${JSON.stringify({type:"response",response:e})}
3
+ `}function P(e){return`${JSON.stringify({type:"response",response:e})}
4
+ `}function _(e){var t;if("replay-test"!==e.type)return;let n=[e.status,`${e.index}/${e.total}`,e.file];void 0!==e.attempt&&void 0!==e.maxAttempts&&n.push(`attempt=${e.attempt}/${e.maxAttempts}`),e.retrying&&n.push("retry=true"),void 0!==e.durationMs&&n.push(`duration=${(t=e.durationMs,`${(Math.max(0,t)/1e3).toFixed(2)}s`)}`),e.artifactsDir&&"fail"===e.status&&n.push(`artifacts=${e.artifactsDir}`);let r=e.message?.replace(/\s+/g," ").trim();return r&&n.push(r),n.join(" ")}export{g as computeDaemonCodeSignature,i as consumeTextLines,_ as formatRequestProgressEvent,S as isDaemonProgressEnvelope,x as isDaemonResponseEnvelope,f as normalizeTenantId,h as resolveDaemonCodeSignature,a as resolveDaemonPaths,u as resolveDaemonServerMode,l as resolveDaemonTransportPreference,p as resolveSessionIsolationMode,j as serializeDaemonProgressEnvelope,D as serializeDaemonResponseEnvelope,P as serializeDaemonRpcResponseEnvelope,$ as shouldStreamRequestProgress};
@@ -0,0 +1 @@
1
+ import{emitDiagnostic as e}from"./7599.js";import{AppError as t}from"./9152.js";import{isClipboardShellUnsupported as i}from"./8806.js";import{resolveAndroidAdbExecutor as n}from"./9639.js";import{sleep as r}from"./4829.js";let o=new Set(["com.google.android.inputmethod.latin","com.samsung.android.honeyboard","com.touchtype.swiftkey","com.microsoft.swiftkey"]);function a(e){let t=u(e.packageName),i=(e.resourceId??"").toLowerCase(),n=u(e.activeInputMethodPackage);if(t&&n&&t===n)return{inputMethodOwned:!0,source:"active-input-method"};if(n&&i.startsWith(`${n}:id/`))return{inputMethodOwned:!0,source:"active-input-method-resource"};if(t&&o.has(t))return{inputMethodOwned:!0,source:"known-ime-package"};for(let e of o)if(i.startsWith(`${e}:id/`))return{inputMethodOwned:!0,source:"known-ime-resource"};return{inputMethodOwned:!1,source:"app"}}function d(e){return a(e).inputMethodOwned}function u(e){return(e??"").trim().toLowerCase()||void 0}let s=["mInputShown","mIsInputViewShown","isInputViewShown","mDecorViewVisible","mWindowVisible","mInShowWindow"],c=new Map([[2,"number"],[3,"phone"],[4,"datetime"]]),l=new Set([32,208]),p=new Set([128,224,144]);async function w(e){return await f(n(e))}async function f(i){var n,r,d;let w,f,m,h,_,I,y,C,g=await i(["shell","dumpsys","input_method"],{allowFailure:!0});if(0!==g.exitCode)throw new t("COMMAND_FAILED","Failed to query Android keyboard state",{stdout:g.stdout,stderr:g.stderr,exitCode:g.exitCode});return f=function(e){var t=function(e,t){let i=new Map,n=RegExp(`\\b(${t.join("|")})=([a-zA-Z]+)\\b`,"g");for(let t of e.matchAll(n)){let e=t[1],n=t[2]?.toLowerCase();e&&("true"===n||"false"===n)&&i.set(e,"true"===n)}return i}(e,s);if(0===t.size)return null;let i=A(t,["mWindowVisible","mDecorViewVisible","mInShowWindow"]);if(void 0!==i)return i;let n=t.get("mInputShown");return void 0!==n?n:A(t,["mIsInputViewShown","isInputViewShown"])??null}(n=g.stdout)??function(e){let t=e.match(/\bmImeWindowVis=0x([0-9a-fA-F]+)\b/),i=t?.[1];if(!i)return null;let n=Number.parseInt(i,16);return Number.isNaN(n)?null:(1&n)!=0}(n),m=(w=b(n,/\binputType=0x([0-9a-fA-F]+)\b/gi))?`0x${w.toLowerCase()}`:void 0,h=b(n,/\bpackageName=([A-Za-z0-9_.]+)\b/g),_=b(n,/\b(?:resourceId|resource-id)=([^\s,}]+)/g),y=function(e,t,i){return e||t?a({packageName:e,resourceId:t,activeInputMethodPackage:i}).inputMethodOwned?"ime":"app":"unknown"}(h,_,I=function(e){for(let t of[/\bmCurMethodId=([^\s]+)/i,/\bmCurId=([^\s]+)/i,/\bmCurrentInputMethodId=([^\s]+)/i,/\bcurMethodId=([^\s]+)/i]){let i=e.match(t),n=function(e){let t=(e??"").trim();if(!t)return;let i=(t.split("/")[0]??"").match(/[a-zA-Z0-9_.]+/);return u(i?.[0])}(i?.[1]);if(n)return n}}(n)),r=h,d=_,!I&&((C=u(r))&&o.has(C)||function(e){let t=(e??"").toLowerCase();for(let e of o)if(t.startsWith(`${e}:id/`))return!0;return!1}(d))&&e({level:"warn",phase:"android_input_ownership_fallback",data:{focusedPackage:r,focusedResourceId:d}}),{visible:f??!1,inputType:m,type:m?function(e){let t=Number.parseInt(e.replace(/^0x/i,""),16);if(Number.isNaN(t))return"unknown";let i=15&t,n=c.get(i);if(n)return n;if(1!==i)return"unknown";let r=4080&t;return l.has(r)?"email":p.has(r)?"password":"text"}(m):void 0,inputMethodPackage:I,focusedPackage:h,focusedResourceId:_,inputOwner:y}}async function m(e){return await h(n(e))}async function h(e){let i=await f(e),n=i,o=0;for(;n.visible&&o<2;)await e(["shell","input","keyevent","111"]),o+=1,await r(120),n=await f(e);if(i.visible&&n.visible)throw new t("UNSUPPORTED_OPERATION","Android keyboard dismiss is unavailable for the current IME without back navigation.",{attempts:o,inputType:n.inputType,type:n.type,inputMethodPackage:n.inputMethodPackage,focusedPackage:n.focusedPackage,focusedResourceId:n.focusedResourceId,inputOwner:n.inputOwner});return{attempts:o,wasVisible:i.visible,dismissed:i.visible&&!n.visible,visible:n.visible,inputType:n.inputType,type:n.type,inputMethodPackage:n.inputMethodPackage,focusedPackage:n.focusedPackage,focusedResourceId:n.focusedResourceId,inputOwner:n.inputOwner}}function b(e,t){let i;for(let n of e.matchAll(t))i=n[1];return i}function A(e,t){for(let i of t){let t=e.get(i);if(void 0!==t)return t}}async function _(e){return await I(n(e))}async function I(e){let t,i;return(i=(t=(await g(e,["shell","cmd","clipboard","get","text"],"read")).replace(/\r\n/g,"\n").replace(/\n$/,"")).match(/^clipboard text:\s*(.*)$/i))?i[1]??"":"null"===t.trim().toLowerCase()?"":t}async function y(e,t){await C(n(e),t)}async function C(e,t){await g(e,["shell","cmd","clipboard","set","text",t],"write")}async function g(e,n,r){let o=await e(n,{allowFailure:!0});if(i(o.stdout,o.stderr))throw new t("UNSUPPORTED_OPERATION",`Android shell clipboard ${r} is not supported on this device.`);if(0!==o.exitCode)throw new t("COMMAND_FAILED",`Failed to ${r} Android clipboard text`,{stdout:o.stdout,stderr:o.stderr,exitCode:o.exitCode});return o.stdout}export{m as dismissAndroidKeyboard,h as dismissAndroidKeyboardWithAdb,w as getAndroidKeyboardState,f as getAndroidKeyboardStatusWithAdb,d as isAndroidInputMethodOwnedNode,_ as readAndroidClipboardText,I as readAndroidClipboardWithAdb,y as writeAndroidClipboardText,C as writeAndroidClipboardWithAdb};
@@ -0,0 +1 @@
1
+ import{PUBLIC_COMMANDS as t}from"./5792.js";import{splitSelectorFromArgs as r}from"./940.js";import{AppError as e}from"./9152.js";import{optionalTrimmedText as i,readElementTargetFromPositionals as o,optionalCliNumber as n,repeatedInputFromFlags as s,optionalNumber as l,targetInputFromClientTarget as u,requiredDaemonString as a,request as c,interactionTargetPositionals as g,direct as m,isFiniteNumberString as f,commonInputFromFlags as d,selectorSnapshotInputFromFlags as p,readGetFormat as _,elementTargetPositionals as x}from"./6085.js";let M={click:(t,r)=>({...d(r),...p(r),...s(r),target:u(b(t)),button:r.clickButton}),press:(t,r)=>({...d(r),...p(r),...s(r),target:u(b(t))}),longpress:(t,r)=>{let e,i={...b((e=function(t){if(f(t[0])&&f(t[1]))return{target:t.slice(0,2),...void 0!==t[2]?{durationMs:Number(t[2])}:{}};let r=t.at(-1);return t.length>1&&f(r)?{target:t.slice(0,-1),durationMs:Number(r)}:{target:t}}(t)).target),...void 0!==e.durationMs?{durationMs:e.durationMs}:{}};return{...d(r),...p(r),target:u(i),durationMs:i.durationMs}},swipe:(t,r)=>({...d(r),from:{x:Number(t[0]),y:Number(t[1])},to:{x:Number(t[2]),y:Number(t[3])},durationMs:n(t[4]),count:r.count,pauseMs:r.pauseMs,pattern:r.pattern}),focus:(t,r)=>({...d(r),x:Number(t[0]),y:Number(t[1])}),type:(t,r)=>({...d(r),text:t.join(" "),delayMs:r.delayMs}),fill:(t,r)=>{let e=S(t);return{...d(r),...p(r),target:u(e.target),text:e.text,delayMs:r.delayMs}},scroll:(t,r)=>({...d(r),direction:function(t){if("up"===t||"down"===t||"left"===t||"right"===t||"top"===t||"bottom"===t)return t;throw new e("INVALID_ARGS",`Unknown direction: ${String(t)}`)}(t[0]),amount:n(t[1]),pixels:r.pixels}),get:(t,r)=>({...d(r),...p(r),format:_(t[0]),target:u(o(t.slice(1)))})},N={click:r=>c(t.click,g(r),{...r,clickButton:r.button}),press:m(t.press,t=>g(t)),longpress:m(t.longPress,t=>{var r;return[...g(r=t),...l(r.durationMs)]}),swipe:m(t.swipe,function(t){return[String(t.from?.x),String(t.from?.y),String(t.to?.x),String(t.to?.y),...l(t.durationMs)]}),focus:m(t.focus,t=>[String(t.x),String(t.y)]),type:m(t.type,t=>[t.text]),fill:m(t.fill,t=>{var r;return[...g(r=t),r.text]}),scroll:m(t.scroll,t=>[a(t.direction,"scroll requires direction"),...l(t.amount)]),get:m(t.get,t=>[a(t.format,"get requires format"),...x(t)])};function b(t){if(t[0]?.startsWith("@")){let r=i(t.slice(1));return{ref:t[0],...void 0===r?{}:{label:r}}}let e=r(t);return e?{selector:e.selectorExpression}:{x:Number(t[0]),y:Number(t[1])}}function S(t){let e=t[0];if(e?.startsWith("@")){let r=t.length>=3?t.slice(2).join(" "):t.slice(1).join(" ");return{kind:"ref",target:{ref:e,label:t.length>=3?i(t.slice(1,2)):void 0},text:r}}let o=r(t,{preferTrailingValue:!0});return o?{kind:"selector",target:{selector:o.selectorExpression},text:o.rest.join(" ")}:{kind:"point",target:{x:Number(t[0]),y:Number(t[1])},text:t.slice(2).join(" ")}}export{M as interactionCliReaders,N as interactionDaemonWriters,S as readFillTargetFromPositionals,b as readInteractionTargetFromPositionals};
@@ -0,0 +1 @@
1
+ import{screenshotFlagsFromOptions as e}from"./5310.js";import{AppError as t}from"./9152.js";import{readRequiredString as r,readRequiredPlatform as i,readRequiredDeviceKind as a,readNullableString as n,readDeviceTarget as o,readRect as s,asRecord as l,stripUndefined as u,isRecord as c,buildAppIdentifiers as d,buildDeviceIdentifiers as p,readRequiredNumber as f,readPoint as m,readOptionalString as h}from"./2805.js";import{INTERNAL_COMMANDS as g,BATCH_COMMAND_NAMES as y,PUBLIC_COMMANDS as v}from"./5792.js";import{assertResolvedAppsFilter as S}from"./1393.js";import{request as b,selectorSnapshotOptionsFromFlags as w,direct as A,requiredString as I,commonInputFromFlags as _,optionalString as N,readJsonObject as R,optionalNumber as M,optionalCliNumber as x,selectionOptionsFromFlags as k,commandNameSet as D,captureDaemonWriters as L,requiredDaemonString as q,splitRequiredSelector as P}from"./6085.js";import{parseDeviceRotation as C}from"./1998.js";import{compactRecord as V}from"./9404.js";import{interactionDaemonWriters as G}from"./8502.js";function E(e,t){let a=h(e,"bundleId"),n=h(e,"package");return{app:r(e,"app"),appPath:r(e,"appPath"),platform:i(e,"platform"),appId:a??n,bundleId:a,package:n,identifiers:d({session:t,bundleId:a,packageName:n})}}function U(e,r){let i=h(e,"bundleId"),a=h(e,"packageName"),n=i??a??h(e,"appId"),o=h(e,"launchTarget")??a??i??n;if(!o)throw new t("COMMAND_FAILED",'Daemon response is missing "launchTarget".',{response:e});return{appName:h(e,"appName"),appId:n,bundleId:i,packageName:a,launchTarget:o,installablePath:h(e,"installablePath"),archivePath:h(e,"archivePath"),materializationId:h(e,"materializationId"),materializationExpiresAt:h(e,"materializationExpiresAt"),identifiers:d({session:r,bundleId:i,packageName:a,appId:n})}}function $(e){return{released:!0===e.released,materializationId:r(e,"materializationId"),identifiers:{}}}function z(e){let{record:t,platform:r,id:i,name:n,target:o}=F(e,"name");return{platform:r,target:o,kind:a(t,"kind"),id:i,name:n,booted:"boolean"==typeof t.booted?t.booted:void 0,identifiers:p(r,i,n),...K(r,i)}}function T(e){let{record:t,platform:i,id:a,name:o,target:s}=F(e,"name"),l=r(t,"device"),u={session:o,...p(i,a,l)};return{name:o,createdAt:f(t,"createdAt"),device:{platform:i,target:s,id:a,name:l,identifiers:u,...K(i,a,n(t,"ios_simulator_device_set"))},identifiers:u}}function F(e,t){let a=l(e);return{record:a,platform:i(a,"platform"),id:r(a,"id"),name:r(a,t),target:o(a,"target")}}function K(e,t,r){return{ios:"ios"===e?{udid:t,...void 0!==r?{simulatorSetPath:r}:{}}:void 0,android:"android"===e?{serial:t}:void 0}}function B(e){if(!c(e))return;let t=e.platform,r=h(e,"metroHost"),i="number"==typeof e.metroPort?e.metroPort:void 0;return{platform:"ios"===t||"android"===t?t:void 0,metroHost:r,metroPort:i,bundleUrl:h(e,"bundleUrl"),launchUrl:h(e,"launchUrl")}}function O(e){let t=e.platform,r=h(e,"id"),i=h(e,"device");if("ios"!==t&&"macos"!==t&&"android"!==t&&"linux"!==t||!r||!i)return;let a=o(e,"target"),s=p(t,r,i);return{platform:t,target:a,id:r,name:i,identifiers:s,ios:"ios"===t?{udid:h(e,"device_udid")??r,simulatorSetPath:n(e,"ios_simulator_device_set")}:void 0,android:"android"===t?{serial:h(e,"serial")??r}:void 0}}function j(e){if(c(e)&&"number"==typeof e.durationMs&&"string"==typeof e.measuredAt&&"string"==typeof e.method)return{durationMs:e.durationMs,measuredAt:e.measuredAt,method:e.method,appTarget:h(e,"appTarget"),appBundleId:h(e,"appBundleId")}}function H(e){return Array.isArray(e)?e:[]}function J(e){let t=e.overlayRefs;if(!Array.isArray(t))return;let r=[];for(let e of t){if(!c(e))continue;let t=h(e,"ref"),i=s(e,"rect"),a=s(e,"overlayRect"),n=m(e,"center");t&&i&&a&&n&&r.push({ref:t,label:h(e,"label"),rect:i,overlayRect:a,center:n})}return r}function W(t){return u({stateDir:t.stateDir,daemonBaseUrl:t.daemonBaseUrl,daemonAuthToken:t.daemonAuthToken,daemonTransport:t.daemonTransport,daemonServerMode:t.daemonServerMode,tenant:t.tenant,sessionIsolation:t.sessionIsolation,runId:t.runId,leaseId:t.leaseId,leaseBackend:t.leaseBackend,platform:t.platform,target:t.target,device:t.device,udid:t.udid,serial:t.serial,iosSimulatorDeviceSet:t.iosSimulatorDeviceSet,androidDeviceAllowlist:t.androidDeviceAllowlist,surface:t.surface,activity:t.activity,launchConsole:t.launchConsole,launchArgs:t.launchArgs,relaunch:t.relaunch,shutdown:t.shutdown,saveScript:t.saveScript,noRecord:t.noRecord,backMode:t.backMode,metroHost:t.metroHost,metroPort:t.metroPort,bundleUrl:t.bundleUrl,launchUrl:t.launchUrl,snapshotInteractiveOnly:t.interactiveOnly,snapshotCompact:t.compact,snapshotDepth:t.depth,snapshotScope:t.scope,snapshotRaw:t.raw,snapshotForceFull:t.forceFull,...e(t),appsFilter:t.appsFilter,out:t.out,count:t.count,fps:t.fps,quality:t.quality,hideTouches:t.hideTouches,intervalMs:t.intervalMs,delayMs:t.delayMs,holdMs:t.holdMs,jitterPx:t.jitterPx,pixels:t.pixels,doubleTap:t.doubleTap,clickButton:t.clickButton,pauseMs:t.pauseMs,pattern:t.pattern,headless:t.headless,restart:t.restart,replayUpdate:t.replayUpdate,replayBackend:t.replayBackend,replayEnv:t.replayEnv,replayShellEnv:t.replayShellEnv,failFast:t.failFast,timeoutMs:t.timeoutMs,retries:t.retries,artifactsDir:t.artifactsDir,reportJunit:t.reportJunit,findFirst:t.findFirst,findLast:t.findLast,networkInclude:t.networkInclude,batchOnError:t.batchOnError,batchMaxSteps:t.batchMaxSteps,batchSteps:t.batchSteps,verbose:t.debug})}function Q(e){return u({requestId:e.requestId,cwd:e.cwd,debug:e.debug,lockPolicy:e.lockPolicy,lockPlatform:e.lockPlatform,tenantId:e.tenant,runId:e.runId,leaseId:e.leaseId,leaseBackend:e.leaseBackend,leaseTtlMs:e.leaseTtlMs,sessionIsolation:e.sessionIsolation,installSource:e.installSource,retainMaterializedPaths:e.retainMaterializedPaths,materializedPathRetentionMs:e.materializedPathRetentionMs,materializationId:e.materializationId})}function X(e){return e??"default"}function Y(e,r){if(!e||"object"!=typeof e||Array.isArray(e))throw new t("INVALID_ARGS",`${r} installSource must be an object.`);if("github-actions-artifact"!==et(e.type,`${r} installSource.type`))throw new t("INVALID_ARGS",`${r} installSource.type must be "github-actions-artifact".`);let{owner:i,repo:a}=ee(et(e.repo,`${r} installSource.repo`),`${r} installSource.repo`);return Z(i,a,e.artifact,`${r} installSource.artifact`)}function Z(e,r,i,a){var n;return"number"==typeof i||"string"==typeof(n=i)&&/^\d+$/.test(n.trim())?{kind:"github-actions-artifact",owner:e,repo:r,artifactId:function(e,r){let i="number"==typeof e?e:"string"==typeof e?Number(e):NaN;if(!Number.isInteger(i))throw new t("INVALID_ARGS",`${r} must be an integer.`);return i}(i,a)}:{kind:"github-actions-artifact",owner:e,repo:r,artifactName:et(i,a)}}function ee(e,r){let i=e.indexOf("/");if(i<=0||i===e.length-1||-1!==e.indexOf("/",i+1))throw new t("INVALID_ARGS",`${r} must use owner/repo.`);let a={owner:e.slice(0,i).trim(),repo:e.slice(i+1).trim()};if(!a.owner||!a.repo)throw new t("INVALID_ARGS",`${r} must use owner/repo.`);return a}function et(e,r){let i="string"==typeof e&&e.trim().length>0?e.trim():void 0;if(!i)throw new t("INVALID_ARGS",`${r} must be a non-empty string.`);return i}let er={devices:(e,t)=>_(t),apps:(e,t)=>({..._(t),appsFilter:S(t.appsFilter)}),session:(e,r)=>({..._(r),action:function(e){let r=e??"list";if("list"===r)return r;throw new t("INVALID_ARGS","session only supports list")}(e[0])}),boot:(e,t)=>({..._(t),headless:t.headless}),open:(e,t)=>({..._(t),app:e[0],url:e[1],surface:t.surface,activity:t.activity,launchConsole:t.launchConsole,launchArgs:t.launchArgs,relaunch:t.relaunch,saveScript:t.saveScript,noRecord:t.noRecord}),close:(e,t)=>({..._(t),app:e[0],shutdown:t.shutdown,saveScript:t.saveScript}),install:ea,reinstall:ea,"install-from-source":(e,r)=>({..._(r),source:function(e,r){let i=e[0]?.trim();if(e.length>1)throw new t("INVALID_ARGS","install-from-source accepts either one <url> positional or --github-actions-artifact");let a=r.githubActionsArtifact?function(e,r="--github-actions-artifact"){let i=e.indexOf(":");if(i<=0||i===e.length-1)throw new t("INVALID_ARGS",`${r} must use owner/repo:artifact, for example thymikee/RNCLI83:6635342232`);let{owner:a,repo:n}=ee(e.slice(0,i),r);return Z(a,n,e.slice(i+1),`${r} artifact`)}(r.githubActionsArtifact):void 0,n=r.installSource;if(1!=+!!i+ +!!a+ +!!n)throw new t("INVALID_ARGS","install-from-source requires exactly one source: <url>, --github-actions-artifact, or config installSource");if(!i&&r.header&&r.header.length>0)throw new t("INVALID_ARGS","install-from-source --header is only supported for URL sources");return a||n||{kind:"url",url:i,headers:function(e){if(!e||0===e.length)return;let r={};for(let i of e){let e=i.indexOf(":");if(e<=0)throw new t("INVALID_ARGS",`Invalid --header value "${i}". Expected "name:value".`);let a=i.slice(0,e).trim(),n=i.slice(e+1).trim();if(!a)throw new t("INVALID_ARGS",`Invalid --header value "${i}". Header name cannot be empty.`);r[a]=n}return r}(r.header)}}(e,r),retainPaths:r.retainPaths,retentionMs:r.retentionMs}),push:(e,t)=>({..._(t),app:I(e[0],"push requires bundleOrPackage"),payload:I(e[1],"push requires payloadOrJson")}),"trigger-app-event":(e,t)=>({..._(t),event:I(e[0],"trigger-app-event requires event"),payload:e[1]?R(e[1],"trigger-app-event payload"):void 0})},ei={devices:A(v.devices),boot:A(v.boot),apps:A(v.apps),open:A(v.open,function(e){return e.app?e.url?[e.app,e.url]:[e.app]:[]}),close:A(v.close,e=>N(e.app)),install:A(v.install,e=>en(e.app,e.appPath)),reinstall:A(v.reinstall,e=>en(e.app,e.appPath)),"install-from-source":e=>b(g.installSource,[],{...e,installSource:e.source,retainMaterializedPaths:e.retainPaths,materializedPathRetentionMs:e.retentionMs}),push:A(v.push,e=>{var t;return[(t=e).app,"string"==typeof t.payload?t.payload:JSON.stringify(t.payload)]}),"trigger-app-event":A(v.triggerAppEvent,e=>{var t;return[(t=e).event,...t.payload?[JSON.stringify(t.payload)]:[]]})};function ea(e,t,r="install"){return{..._(t),app:I(e[0],`${r} requires app`),appPath:I(e[1],`${r} requires path`)}}function en(e,t){return[q(e,"missing first positional"),q(t,"missing second positional")]}let eo={gesture:function(e,r){let i=e[0],a=e.slice(1),n=_(r);switch(i){case"pan":return{...n,kind:i,origin:{x:Number(a[0]),y:Number(a[1])},delta:{x:Number(a[2]),y:Number(a[3])},durationMs:x(a[4])};case"fling":return{...n,kind:i,direction:a[0],origin:{x:Number(a[1]),y:Number(a[2])},distance:x(a[3]),durationMs:x(a[4])};case"swipe":return{...n,kind:i,preset:a[0],durationMs:x(a[1])};case"pinch":return{...n,kind:i,scale:Number(a[0]),origin:void 0===a[1]||void 0===a[2]?void 0:{x:Number(a[1]),y:Number(a[2])}};case"rotate":return{...n,kind:i,degrees:Number(a[0]),origin:void 0===a[1]||void 0===a[2]?void 0:{x:Number(a[1]),y:Number(a[2])},velocity:x(a[3])};case"transform":return{...n,kind:i,origin:{x:Number(a[0]),y:Number(a[1])},delta:{x:Number(a[2]),y:Number(a[3])},scale:Number(a[4]),degrees:Number(a[5]),durationMs:x(a[6])};default:throw new t("INVALID_ARGS","gesture requires pan, fling, swipe, pinch, rotate, or transform")}}},es={gesture:A(v.gesture,function(e){switch(e.kind){case"pan":return["pan",String(e.origin?.x),String(e.origin?.y),String(e.delta?.x),String(e.delta?.y),...M(e.durationMs)];case"fling":return["fling",q(e.direction,"gesture fling requires direction"),String(e.origin?.x),String(e.origin?.y),...M(e.distance),...M(e.durationMs)];case"swipe":return el(e);case"pinch":return["pinch",String(e.scale),...M(e.origin?.x),...M(e.origin?.y)];case"rotate":return["rotate",String(e.degrees),...M(e.origin?.x),...M(e.origin?.y),...M(e.velocity)];case"transform":return["transform",String(e.origin?.x),String(e.origin?.y),String(e.delta?.x),String(e.delta?.y),String(e.scale),String(e.degrees),...M(e.durationMs)];default:throw new t("INVALID_ARGS","gesture requires pan, fling, swipe, pinch, rotate, or transform")}}),"gesture-pan":A(v.gesture,function(e){return["pan",String(e.x),String(e.y),String(e.dx),String(e.dy),...M(e.durationMs)]}),"gesture-fling":A(v.gesture,e=>{var t;let r;return r=void 0!==(t=e).durationMs?t.distance??180:t.distance,["fling",t.direction,String(t.x),String(t.y),...M(r),...M(t.durationMs)]}),"gesture-swipe":A(v.gesture,el),"gesture-pinch":A(v.gesture,function(e){return["pinch",String(e.scale),...M(e.x),...M(e.y)]}),"gesture-rotate":A(v.gesture,e=>(function(e){var r=e;if(void 0===r.x&&void 0!==r.y||void 0!==r.x&&void 0===r.y)throw new t("INVALID_ARGS","gesture rotate center requires both x and y");let i=void 0===e.x||void 0===e.y?[]:[String(e.x),String(e.y)];return["rotate",String(e.degrees),...i,...M(e.velocity)]})(e)),"gesture-transform":A(v.gesture,function(e){return["transform",String(e.x),String(e.y),String(e.dx),String(e.dy),String(e.scale),String(e.degrees),...M(e.durationMs)]})};function el(e){return["swipe",q(e.preset,"gesture swipe requires preset"),...M(e.durationMs)]}let eu={perf:(e,t)=>_(t),logs:(e,r)=>({..._(r),action:function(e){if(void 0!==e){if("path"===e||"start"===e||"stop"===e||"doctor"===e||"mark"===e||"clear"===e)return e;throw new t("INVALID_ARGS","logs requires path, start, stop, doctor, mark, or clear")}}(e[0]),message:e.slice(1).join(" ")||void 0,restart:r.restart}),network:(e,r)=>({..._(r),action:function(e){if(void 0!==e){if("dump"===e||"log"===e)return e;throw new t("INVALID_ARGS","network requires dump or log")}}(e[0]),limit:x(e[1]),include:r.networkInclude??function(e){if(void 0!==e){if("summary"===e||"headers"===e||"body"===e||"all"===e)return e;throw new t("INVALID_ARGS","network include mode must be summary, headers, body, or all")}}(e[2])}),record:(e,t)=>({..._(t),action:ep(e[0],"record"),path:e[1],fps:t.fps,quality:t.quality,hideTouches:t.hideTouches}),trace:(e,t)=>({..._(t),action:ep(e[0],"trace"),path:e[1]})},ec={perf:A(v.perf),logs:A(v.logs,e=>{var t;return[(t=e).action??"path",...N(t.message)]}),network:e=>{var t;return b(v.network,[...(t=e).action?[t.action]:[],...M(t.limit)],{...e,networkInclude:e.include})},record:A(v.record,e=>ed(e)),trace:A(v.trace,e=>ed(e))};function ed(e){return[e.action,...N(e.path)]}function ep(e,r){if("start"===e||"stop"===e)return e;throw new t("INVALID_ARGS",`${r} requires start|stop`)}let ef={replay:(e,t)=>({..._(t),path:I(e[0],"replay requires path"),update:t.replayUpdate,backend:t.replayMaestro?"maestro":void 0,env:t.replayEnv}),test:(e,t)=>({..._(t),paths:e,update:t.replayUpdate,backend:t.replayMaestro?"maestro":void 0,env:t.replayEnv,failFast:t.failFast,timeoutMs:t.timeoutMs,retries:t.retries,artifactsDir:t.artifactsDir,reportJunit:t.reportJunit})};function em(e){return e.backend??(!0===e.maestro?"maestro":void 0)}function eh(e){let t={};for(let[r,i]of Object.entries(e))"string"==typeof i&&r.startsWith("AD_VAR_")&&(t[r]=i);return t}let eg={find:(e,r)=>(function(e,r){var i;let a={...{depth:(i=r).snapshotDepth,raw:i.snapshotRaw},...k(r),first:r.findFirst,last:r.findLast},n=function(e){if("text"===e||"label"===e||"value"===e||"role"===e||"id"===e)return e}(e[0]),o=void 0!==n,s=o?e[1]:e[0],l=o?2:1,u=e[l];if(void 0===u)return{...a,locator:n,query:ev(s)};if("get"===u){let r=e[l+1];if("text"===r)return{...a,locator:n,query:ev(s),action:"getText"};if("attrs"===r)return{...a,locator:n,query:ev(s),action:"getAttrs"};throw new t("INVALID_ARGS","find get only supports text or attrs")}if("wait"===u)return{...a,locator:n,query:ev(s),action:"wait",timeoutMs:x(e[l+1])};if("fill"===u||"type"===u)return{...a,locator:n,query:ev(s),action:u,value:e.slice(l+1).join(" ")};if("click"===u||"focus"===u||"exists"===u)return{...a,locator:n,query:ev(s),action:u};throw new t("INVALID_ARGS",`Unsupported find action: ${u}`)})(e,r),is:(e,r)=>(function(e,r){let i={...w(r),...k(r)},a=e[0],n=P(e.slice(1),{preferTrailingValue:"text"===a});if("text"===a)return{...i,predicate:a,selector:n.selectorExpression,value:n.rest.join(" ")};if("visible"===a||"hidden"===a||"exists"===a||"editable"===a||"selected"===a)return{...i,predicate:a,selector:n.selectorExpression};throw new t("INVALID_ARGS","is requires predicate: visible|hidden|exists|editable|selected|text")})(e,r)},ey={is:A(v.is,e=>{var t;return[(t=e).predicate,t.selector,..."text"===t.predicate?[t.value]:[]]}),find:e=>b(v.find,function(e){let t=e.locator&&"any"!==e.locator?[e.locator,e.query]:[e.query];switch(e.action){case void 0:case"click":case"focus":case"exists":return e.action?[...t,e.action]:t;case"getText":return[...t,"get","text"];case"getAttrs":return[...t,"get","attrs"];case"wait":return[...t,"wait",...M(e.timeoutMs)];case"fill":case"type":return[...t,e.action,e.value]}}(e),{...e,findFirst:e.first,findLast:e.last})};function ev(e){if(void 0===e||""===e)throw new t("INVALID_ARGS","find requires query");return e}let eS={appstate:(e,t)=>_(t),home:(e,t)=>_(t),"app-switcher":(e,t)=>_(t),back:(e,t)=>({..._(t),mode:t.backMode}),rotate:(e,t)=>({..._(t),orientation:C(e[0])}),keyboard:(e,r)=>({..._(r),...function(e){if(e.length>1)throw new t("INVALID_ARGS","keyboard accepts at most one action argument.");return V({action:function(e){let r=e?.toLowerCase();if("get"===r)return"status";if(void 0===r||"status"===r||"dismiss"===r||"enter"===r||"return"===r)return r;throw new t("INVALID_ARGS","keyboard action must be status, get, dismiss, enter, or return.")}(e[0])})}(e)}),clipboard:(e,r)=>({..._(r),...function(e){let r=e[0]?.toLowerCase();if("read"!==r&&"write"!==r)throw new t("INVALID_ARGS","clipboard requires a subcommand: read or write.");if("read"===r){if(1!==e.length)throw new t("INVALID_ARGS","clipboard read does not accept additional arguments.");return{action:r}}if(e.length<2)throw new t("INVALID_ARGS","clipboard write requires text.");return{action:r,text:e.slice(1).join(" ")}}(e)}),"react-native":(e,r)=>({..._(r),action:function(e){if("dismiss-overlay"===e)return e;throw new t("INVALID_ARGS","react-native supports only: dismiss-overlay")}(e[0])})},eb={appstate:A(v.appState),back:e=>{var t;return b(v.back,[],{...e,backMode:"in-app"===(t=e.mode)||"system"===t?t:void 0})},home:A(v.home),rotate:A(v.rotate,e=>[q(e.orientation,"rotate requires orientation")]),"app-switcher":A(v.appSwitcher),keyboard:A(v.keyboard,e=>N(e.action)),clipboard:A(v.clipboard,e=>{var t;return"read"===(t=e).action?["read"]:["write",t.text]}),"react-native":A(v.reactNative,e=>[q(e.action,"react-native requires action")])},ew={...ei,...L,...G,...es,...ey,...ec,replay:e=>b(v.replay,[q(e.path,"replay requires path")],{...e,replayUpdate:e.update,replayBackend:em(e),replayEnv:e.env,replayShellEnv:eh(process.env)}),test:e=>b(v.test,e.paths??[],{...e,replayUpdate:e.update,replayBackend:em(e),replayEnv:e.env,replayShellEnv:eh(process.env)}),...eb,batch:e=>b(v.batch,[],{...e,batchSteps:function(e){if(!Array.isArray(e)||0===e.length)throw new t("INVALID_ARGS","batch requires a non-empty steps array.");return e.map((e,r)=>{var i;let a,n,o,s,l,u;return o=function(e,r){let i="string"==typeof e.command?e.command.trim().toLowerCase():"";if(eI.has(i))return i;throw new t("INVALID_ARGS",`Batch step ${r} command is not available through command batch: ${String(e.command)}`)}(n=function(e,r){if(!e||"object"!=typeof e||Array.isArray(e))throw new t("INVALID_ARGS",`Invalid batch step ${r}.`);return e}(e,i=r+1),i),s=function(e,r){let i=e.input;if(!i||"object"!=typeof i||Array.isArray(i))throw new t("INVALID_ARGS",`Batch step ${r} input must be an object.`);return i}(n,i),l=function(e,r){let i=e.runtime;if(void 0!==i&&(!i||"object"!=typeof i||Array.isArray(i)))throw new t("INVALID_ARGS",`Batch step ${r} runtime must be an object.`);return i}(n,i),{...u={command:(a=e_(o,s)).command,positionals:a.positionals,flags:W(a.options),runtime:a.options.runtime},runtime:l??u.runtime}})}(e.steps),batchOnError:e.onError,batchMaxSteps:e.maxSteps})},eA=y,eI=D(eA);function e_(e,t){return ew[e](t)}export{er as appCliReaders,eA as batchCommandNames,W as buildFlags,Q as buildMeta,eo as gestureCliReaders,E as normalizeDeployResult,z as normalizeDevice,U as normalizeInstallFromSourceResult,$ as normalizeMaterializationReleaseResult,O as normalizeOpenDevice,B as normalizeRuntimeHints,T as normalizeSession,j as normalizeStartupSample,eu as observabilityCliReaders,Y as parseInstallSourceConfig,e_ as prepareDaemonCommandRequest,J as readScreenshotOverlayRefs,H as readSnapshotNodes,ef as replayCliReaders,X as resolveSessionName,eg as selectorCliReaders,eS as systemCliReaders};
@@ -0,0 +1,7 @@
1
+ import{promises as t}from"node:fs";import e from"node:os";import a from"node:path";import{asAppError as n,AppError as i}from"./9152.js";import{emitDiagnostic as r}from"./7599.js";import{runCmd as o,resolveFileOverridePath as s,whichCmd as l,runCmdDetached as d}from"./9818.js";import{ensureAndroidSdkPathConfigured as u,resolveAndroidArchivePackageName as c}from"./7651.js";import{sleep as p}from"./4829.js";import{createAndroidPortReverseManager as f,resolveAndroidAdbProvider as m,installAndroidAdbPackage as w,resolveAndroidAdbExecutor as h}from"./9639.js";import{materializeInstallablePath as A,isTrustedInstallSourceUrl as y}from"./989.js";let g=["mCurrentFocus=Window{","mFocusedApp=AppWindowToken{","mResumedActivity:","ResumedActivity:"],v=/\bApplication Not Responding:\s*([A-Za-z0-9_.]+)/i,_=/([^{}]*\bis(?:n't| not)\s+responding[^{}]*)/i,M=/\b([A-Za-z][A-Za-z0-9_]*(?:\.[A-Za-z0-9_]+)+)\b/;function b(t){let e=new Set;for(let a of t.split("\n")){let t=a.trim();if(!t)continue;let n=t.split(/\s+/)[0]??"";if(!n.includes("/"))continue;let i=n.split("/")[0]??"";i.includes(".")&&i&&e.add(i)}return Array.from(e)}function I(t){return t.split("\n").map(t=>{let e=t.trim();return e.startsWith("package:")?e.slice(8):e}).filter(Boolean)}function N(t){return O(t,t=>(function(t){for(let e of t.trim().split(/\s+/)){let t=e.indexOf("/");if(t<=0)continue;let a=D(e.slice(0,t),!1),n=D(e.slice(t+1),!0);if(a&&n&&a.length===t)return{package:a,activity:n}}return null})(t))}function O(t,e){let a=t.split("\n");for(let t of g)for(let n of a){let a=n.indexOf(t);if(-1===a)continue;let i=n.trim(),r=e(n.slice(a+t.length),i);if(r)return r}return null}function D(t,e){let a=0;for(;a<t.length&&function(t,e){if(!t)return!1;let a=t.charCodeAt(0);return a>=48&&a<=57||a>=65&&a<=90||a>=97&&a<=122||"_"===t||"."===t||e&&"$"===t}(t[a],e);)a+=1;return t.slice(0,a)}function C(t){let e=t.trim();if(!e||/\s/.test(e))return!1;let a=/^([A-Za-z][A-Za-z0-9+.-]*):(.+)$/.exec(e);if(!a)return!1;let n=a[1]?.toLowerCase(),i=a[2]??"";return"http"!==n&&"https"!==n&&"ws"!==n&&"wss"!==n&&"ftp"!==n&&"ftps"!==n||i.startsWith("//")}function E(t){let e=t.trim().split(":")[0]?.toLowerCase();return"http"===e||"https"===e}function T(t,e){let a=t?.trim();return a||(E(e)?"com.apple.mobilesafari":void 0)}function L(t={}){let e=t.ttlMs??3e4,a=t.nowMs??Date.now,n=new Map,i=t=>{var e;let a=[(e=t).platform,e.deviceId,""].join("\0");for(let t of n.keys())t.startsWith(a)&&n.delete(t)};return{get(t,e){let i=k(t,e),r=n.get(i);if(r)return r.expiresAtMs<=a()?void n.delete(i):r.value},set:(t,i,r)=>(n.set(k(t,i),{value:r,expiresAtMs:a()+e}),r),clear(t){i(t)},async invalidateWhile(t,e){i(t);try{return await e()}finally{i(t)}}}}function k(t,e){return[t.platform,t.deviceId,t.variant??"",e.trim().toLowerCase()].join("\0")}function S(t){return["1","true","yes","on"].includes((t??"").trim().toLowerCase())}class R{startedAtMs;expiresAtMs;constructor(t,e){this.startedAtMs=t,this.expiresAtMs=t+Math.max(0,e)}static fromTimeoutMs(t,e=Date.now()){return new R(e,t)}remainingMs(t=Date.now()){return Math.max(0,this.expiresAtMs-t)}elapsedMs(t=Date.now()){return Math.max(0,t-this.startedAtMs)}isExpired(t=Date.now()){return 0>=this.remainingMs(t)}}async function x(t,e={},a={}){let n,r={maxAttempts:e.maxAttempts??3,baseDelayMs:e.baseDelayMs??200,maxDelayMs:e.maxDelayMs??2e3,jitter:e.jitter??.2,shouldRetry:e.shouldRetry};for(let e=1;e<=r.maxAttempts;e+=1){if(a.signal?.aborted)throw new i("COMMAND_FAILED","request canceled",{reason:"request_canceled"});if(a.deadline?.isExpired()&&e>1)break;try{let n=await t({attempt:e,maxAttempts:r.maxAttempts,deadline:a.deadline});return a.onEvent?.({phase:a.phase,event:"succeeded",attempt:e,maxAttempts:r.maxAttempts,elapsedMs:a.deadline?.elapsedMs(),remainingMs:a.deadline?.remainingMs()}),P({phase:a.phase,event:"succeeded",attempt:e,maxAttempts:r.maxAttempts,elapsedMs:a.deadline?.elapsedMs(),remainingMs:a.deadline?.remainingMs()}),n}catch(d){n=d;let t=a.classifyReason?.(d),i={phase:a.phase,event:"attempt_failed",attempt:e,maxAttempts:r.maxAttempts,elapsedMs:a.deadline?.elapsedMs(),remainingMs:a.deadline?.remainingMs(),reason:t};if(a.onEvent?.(i),P(i),e>=r.maxAttempts||r.shouldRetry&&!r.shouldRetry(d,e))break;let o=function(t,e,a,n){let i=Math.min(e,t*2**(n-1));return Math.max(0,i+i*a*(2*Math.random()-1))}(r.baseDelayMs,r.maxDelayMs,r.jitter,e),s=a.deadline?Math.min(o,a.deadline.remainingMs()):o;if(s<=0)break;let l={phase:a.phase,event:"retry_scheduled",attempt:e,maxAttempts:r.maxAttempts,delayMs:s,elapsedMs:a.deadline?.elapsedMs(),remainingMs:a.deadline?.remainingMs(),reason:t};a.onEvent?.(l),P(l),await function(t,e){return new Promise(a=>{if(e?.aborted)return void a();let n=!1,i=()=>{n||(n=!0,e&&e.removeEventListener("abort",o),a())},r=setTimeout(i,t);function o(){clearTimeout(r),i()}e&&e.addEventListener("abort",o,{once:!0})})}(s,a.signal)}}let o={phase:a.phase,event:"exhausted",attempt:r.maxAttempts,maxAttempts:r.maxAttempts,elapsedMs:a.deadline?.elapsedMs(),remainingMs:a.deadline?.remainingMs(),reason:a.classifyReason?.(n)};if(a.onEvent?.(o),P(o),n)throw n;throw new i("COMMAND_FAILED","retry failed")}async function U(t,e={}){return x(()=>t(),{maxAttempts:e.attempts,baseDelayMs:e.baseDelayMs,maxDelayMs:e.maxDelayMs,jitter:e.jitter,shouldRetry:e.shouldRetry})}function P(t){r({level:"attempt_failed"===t.event||"exhausted"===t.event?"warn":"debug",phase:"retry",data:{...t}})}function F(t){return t?.trim()||void 0}function B(t){return F(t)}function $(t){return new Set(t.split(/[\s,]+/).map(t=>t.trim()).filter(Boolean))}function V(t,e=process.env){let a=F(t)??F(e.AGENT_DEVICE_ANDROID_DEVICE_ALLOWLIST);if(a)return $(a)}let W=new Set(["IOS_BOOT_TIMEOUT","IOS_RUNNER_CONNECT_TIMEOUT","IOS_TOOL_MISSING","ANDROID_BOOT_TIMEOUT","ADB_TRANSPORT_UNAVAILABLE","CI_RESOURCE_STARVATION_SUSPECTED"]);function G(t){return W.has(t.toUpperCase())}function j(t){let e=t.error?n(t.error):null,a=t.context?.platform,i=t.context?.phase;if(e?.code==="TOOL_MISSING")return"android"===a?"ADB_TRANSPORT_UNAVAILABLE":"IOS_TOOL_MISSING";let r=e?.details??{},o="string"==typeof r.message?r.message:void 0,s="string"==typeof r.stdout?r.stdout:void 0,l="string"==typeof r.stderr?r.stderr:void 0,d=r.boot&&"object"==typeof r.boot?r.boot:null,u=r.bootstatus&&"object"==typeof r.bootstatus?r.bootstatus:null,c=[t.message,e?.message,t.stdout,t.stderr,o,s,l,"string"==typeof d?.stdout?d.stdout:void 0,"string"==typeof d?.stderr?d.stderr:void 0,"string"==typeof u?.stdout?u.stdout:void 0,"string"==typeof u?.stderr?u.stderr:void 0].filter(Boolean).join("\n").toLowerCase();return"ios"===a&&(c.includes("runner did not accept connection")||"connect"===i&&(c.includes("timed out")||c.includes("timeout")||c.includes("econnrefused")||c.includes("connection refused")||c.includes("fetch failed")||c.includes("socket hang up")))?"IOS_RUNNER_CONNECT_TIMEOUT":"ios"===a&&"boot"===i&&(c.includes("timed out")||c.includes("timeout"))?"IOS_BOOT_TIMEOUT":"android"===a&&"boot"===i&&(c.includes("timed out")||c.includes("timeout"))?"ANDROID_BOOT_TIMEOUT":c.includes("resource temporarily unavailable")||c.includes("killed: 9")||c.includes("cannot allocate memory")||c.includes("system is low on memory")?"CI_RESOURCE_STARVATION_SUSPECTED":"android"===a&&(c.includes("device not found")||c.includes("no devices")||c.includes("device offline")||c.includes("offline")||c.includes("unauthorized")||c.includes("not authorized")||c.includes("unable to locate device")||c.includes("invalid device"))?"ADB_TRANSPORT_UNAVAILABLE":e?.code==="COMMAND_FAILED"||c.length>0?"BOOT_COMMAND_FAILED":"UNKNOWN"}function H(t){switch(t){case"IOS_BOOT_TIMEOUT":return"Retry simulator boot and inspect simctl bootstatus logs; in CI reduce parallel jobs or use a larger runner.";case"IOS_RUNNER_CONNECT_TIMEOUT":return"Retry runner startup, inspect xcodebuild logs, and verify simulator responsiveness before command execution.";case"ANDROID_BOOT_TIMEOUT":return"Retry emulator startup and verify sys.boot_completed reaches 1; consider increasing startup budget in CI.";case"ADB_TRANSPORT_UNAVAILABLE":return"Check adb server/device transport (adb devices -l), restart adb, and ensure the target device is online and authorized.";case"CI_RESOURCE_STARVATION_SUSPECTED":return"CI machine may be resource constrained; reduce parallel jobs or use a larger runner.";case"IOS_TOOL_MISSING":return"Xcode command-line tools are missing or not in PATH; run xcode-select --install and verify xcrun works.";case"BOOT_COMMAND_FAILED":return"Inspect command stderr/stdout for the failing boot phase and retry after environment validation.";default:return"Retry once and inspect verbose logs for the failing phase."}}let K=["android.software.leanback","android.software.leanback_only","android.hardware.type.television"];async function z(t,e,a){let n=Array(t.length),i=0,r=Math.min(e,t.length);return await Promise.all(Array.from({length:r},async()=>{for(;i<t.length;){let e=i;i+=1,n[e]=await a(t[e])}})),n}function q(t){return`${t.stdout}
2
+ ${t.stderr}`}function Z(t,e){return["-s",t,...e]}function J(t){return t.startsWith("emulator-")}function X(t){return t.toLowerCase().replace(/_/g," ").replace(/\s+/g," ").trim()}async function Q(t,e=1e4){return o("adb",Z(t,["shell","getprop","sys.boot_completed"]),{allowFailure:!0,timeoutMs:e})}async function Y(t,e){let a=e.replace(/_/g," ").trim();if(!J(t))return a||t;let n=await te(t);return n?n.replace(/_/g," "):a||t}async function tt(t,e,a){try{return await a("adb",Z(t,e),{allowFailure:!0,timeoutMs:1e4})}catch(t){var i;if("COMMAND_FAILED"===(i=n(t)).code&&"number"==typeof i.details?.timeoutMs)return;throw t}}async function te(t,e=o){for(let a of["ro.boot.qemu.avd_name","persist.sys.avd_name"]){let n=await tt(t,["shell","getprop",a],e);if(!n)continue;let i=n.stdout.trim();if(0===n.exitCode&&i.length>0)return i}let a=await tt(t,["emu","avd","name"],e);if(!a)return;let n=function(t){let e=t.split("\n").map(t=>t.trim()).filter(t=>t.length>0);if(0!==e.length)return"OK"===e.at(-1)&&e.pop(),e.join("\n").trim()||void 0}(a.stdout);if(0===a.exitCode&&n)return n}async function ta(t,e){let a=q(await o("adb",Z(t,["shell","cmd","package","has-feature",e]),{allowFailure:!0,timeoutMs:1e4})).toLowerCase();return!!a.includes("true")||!a.includes("false")&&null}async function tn(t){return(await z(K,2,async e=>await ta(t,e))).some(t=>!0===t)}async function ti(t){var e;let a;return"tv"===((a=q(await o("adb",Z(t,["shell","getprop","ro.build.characteristics"]),{allowFailure:!0,timeoutMs:1e4})).toLowerCase()).includes("tv")||a.includes("leanback")?"tv":null)||await tn(t)?"tv":(e=q(await o("adb",Z(t,["shell","pm","list","features"]),{allowFailure:!0,timeoutMs:1e4})),/feature:android\.(software\.leanback(_only)?|hardware\.type\.television)\b/i.test(e))?"tv":"mobile"}async function tr(t={}){if(await u(),!await l("adb"))throw new i("TOOL_MISSING","adb not found in PATH");let e=t.serialAllowlist??V(void 0),a=(await to()).filter(t=>!e||e.has(t.serial));return await z(a,3,async({serial:t,rawModel:e})=>{let[a,n,i]=await Promise.all([Y(t,e),tu(t),ti(t)]);return{platform:"android",id:t,name:a,kind:J(t)?"emulator":"device",target:i,booted:n}})}async function to(){return(await o("adb",["devices","-l"],{timeoutMs:1e4})).stdout.split("\n").map(t=>t.trim()).filter(t=>t.length>0&&!t.startsWith("List of devices")).map(t=>t.split(/\s+/)).flatMap(t=>{let e=t[0];return void 0===e||"device"!==t[1]?[]:[{serial:e,rawModel:(t.find(t=>t.startsWith("model:"))??"").replace("model:","")}]})}async function ts(){let t=await o("emulator",["-list-avds"],{allowFailure:!0,timeoutMs:1e4});if(0!==t.exitCode)throw new i("COMMAND_FAILED","Failed to list Android emulator AVDs",{stdout:t.stdout,stderr:t.stderr,exitCode:t.exitCode,hint:"Verify Android emulator tooling is installed and available in PATH."});return t.stdout.split("\n").map(t=>t.trim()).filter(t=>t.length>0)}async function tl(t){let e=Date.now();for(;Date.now()-e<t.timeoutMs;){try{let e=await td(t.avdName,t.serial);if(e)return{platform:"android",id:e,name:t.avdName,kind:"emulator",target:"mobile",booted:!1}}catch{}await p(1e3)}throw new i("COMMAND_FAILED","Android emulator did not appear in time",{avdName:t.avdName,serial:t.serial,timeoutMs:t.timeoutMs,hint:"Check emulator logs and verify the AVD can start from command line."})}async function td(t,e){let a=X(t);for(let t of(await to()).filter(t=>(!e||t.serial===e)&&J(t.serial)))if(X(t.rawModel)===a||X(await Y(t.serial,t.rawModel))===a)return t.serial}async function tu(t){try{let e=await Q(t);return"1"===e.stdout.trim()}catch{return!1}}async function tc(t){var e,a;let n;await u();let r=t.avdName.trim();if(!r)throw new i("INVALID_ARGS","Android emulator boot requires a non-empty AVD name.");let o=t.timeoutMs??12e4;if(!await l("adb"))throw new i("TOOL_MISSING","adb not found in PATH");if(!await l("emulator"))throw new i("TOOL_MISSING","emulator not found in PATH");let s=await ts(),c=function(t,e){let a=t.find(t=>t===e);if(a)return a;let n=X(e);return t.find(t=>X(t)===n)}(s,r);if(!c)throw new i("DEVICE_NOT_FOUND",`No Android emulator AVD named ${t.avdName}`,{requestedAvdName:r,availableAvds:s,hint:"Run `emulator -list-avds` and pass an existing AVD name to --device."});let p=Date.now(),f=(e=await tr(),a=t.serial,n=X(c),e.find(t=>"android"===t.platform&&"emulator"===t.kind&&(!a||t.id===a)&&X(t.name)===n));if(!f){let e=["-avd",c];t.headless&&e.push("-no-window","-no-audio"),d("emulator",e)}let m=f??await tl({avdName:c,serial:t.serial,timeoutMs:o}),w=Math.max(1e3,o-(Date.now()-p));await tp(m.id,w);let h=(await tr()).find(t=>t.id===m.id);return h?{...h,name:c,booted:!0}:{...m,name:c,booted:!0}}async function tp(t,e=6e4){let a,r=R.fromTimeoutMs(e),o=Math.max(1,Math.ceil(e/1e3)),s=!1;try{await x(async({deadline:n})=>{if(n?.isExpired())throw s=!0,new i("COMMAND_FAILED","Android boot deadline exceeded",{serial:t,timeoutMs:e,elapsedMs:r.elapsedMs(),message:"timeout"});let o=Math.max(1e3,n?.remainingMs()??e),l=await Q(t,Math.min(o,1e4));if(a=l,"1"!==l.stdout.trim())throw new i("COMMAND_FAILED","Android device is still booting",{serial:t,stdout:l.stdout,stderr:l.stderr,exitCode:l.exitCode})},{maxAttempts:o,baseDelayMs:1e3,maxDelayMs:1e3,jitter:0,shouldRetry:t=>{let e=j({error:t,stdout:a?.stdout,stderr:a?.stderr,context:{platform:"android",phase:"boot"}});return"ADB_TRANSPORT_UNAVAILABLE"!==e&&"ANDROID_BOOT_TIMEOUT"!==e}},{deadline:r,phase:"boot",classifyReason:t=>j({error:t,stdout:a?.stdout,stderr:a?.stderr,context:{platform:"android",phase:"boot"}})})}catch(f){let o=n(f),l=a?.stdout,d=a?.stderr,u=a?.exitCode,c=j({error:f,stdout:l,stderr:d,context:{platform:"android",phase:"boot"}});"BOOT_COMMAND_FAILED"===c&&"Android device is still booting"===o.message&&(c="ANDROID_BOOT_TIMEOUT");let p={serial:t,timeoutMs:e,elapsedMs:r.elapsedMs(),reason:c,hint:H(c),stdout:l,stderr:d,exitCode:u};if(s||"ANDROID_BOOT_TIMEOUT"===c)throw new i("COMMAND_FAILED","Android device did not finish booting in time",p);if("TOOL_MISSING"===o.code)throw new i("TOOL_MISSING",o.message,{...p,...o.details??{}});if("ADB_TRANSPORT_UNAVAILABLE"===c)throw new i("COMMAND_FAILED",o.message,{...p,...o.details??{}});throw new i(o.code,o.message,{...p,...o.details??{}},o.cause)}}async function tf(t,e,a){return await h(t)(e,a)}function tm(t){return{platform:"android",id:t,name:t,kind:t.startsWith("emulator-")?"emulator":"device",booted:!0}}function tw(t,e){let a=`${t}
3
+ ${e}`.toLowerCase();return a.includes("no shell command implementation")||a.includes("unknown command")}let th=/\.(?:apk|aab)$/i,tA=/^[A-Za-z_][\w]*(\.[A-Za-z_][\w]*)+$/;function ty(t){var e,a;let n=t.trim();return 0===n.length?"other":th.test(n)?n.includes("/")||n.includes("\\")||n.startsWith(".")||n.startsWith("~")||(e=n,!tA.test(e))?"binary":"package":(a=n,tA.test(a))?"package":"other"}function tg(t){return`Android runtime hints require an installed package name, not "${t}". Install or reinstall the app first, then relaunch by package.`}async function tv(t,e){let n="url"===t.kind&&y(t.url),i=await A({source:t,isInstallablePath:(t,e)=>{var n;let i;return e.isFile()&&(n=t,".apk"===(i=a.extname(n).toLowerCase())||".aab"===i)},installableLabel:"Android installable (.apk or .aab)",allowArchiveExtraction:"url"!==t.kind||n,signal:e?.signal});try{let t=e?.resolveIdentity===!1?{}:await t_(i.installablePath);return{archivePath:i.archivePath,installablePath:i.installablePath,packageName:t.packageName,cleanup:i.cleanup}}catch(t){throw await i.cleanup(),t}}async function t_(t){let e=a.extname(t).toLowerCase();return".apk"!==e&&".aab"!==e?{}:{packageName:await c(t)}}let tM={settings:{type:"intent",value:"android.settings.SETTINGS"}},tb="android.intent.category.LAUNCHER",tI="android.intent.category.LEANBACK_LAUNCHER",tN="android.intent.category.DEFAULT",tO="Run agent-device apps --platform android to discover the installed package name, then retry open with that exact package.",tD=new Set(["localhost","127.0.0.1","::1","[::1]"]),tC=L();function tE(t){return{platform:"android",deviceId:t.id,variant:t.target??""}}async function tT(t,e){let a=e.trim();if("package"===ty(a))return{type:"package",value:a};let n=tM[a.toLowerCase()];if(n)return n;let r=tE(t),o=tC.get(r,a);if(o)return o;let s=(await tf(t,["shell","pm","list","packages"])).stdout.split("\n").map(t=>t.replace("package:","").trim()).filter(Boolean).filter(t=>t.toLowerCase().includes(a.toLowerCase())),l=s[0];if(void 0!==l&&1===s.length)return tC.set(r,a,{type:"package",value:l});if(s.length>1)throw new i("INVALID_ARGS",`Multiple packages matched "${e}"`,{matches:s,hint:"Run agent-device apps --platform android to see the exact installed package names before retrying open."});throw new i("APP_NOT_INSTALLED",`No package found matching "${e}"`,{hint:tO})}async function tL(t,e){let a=await tk(t);return("user-installed"===e?(await tR(t)).filter(t=>a.has(t)):Array.from(a)).sort((t,e)=>t.localeCompare(e)).map(t=>({package:t,name:tx(t)}))}async function tk(t){let e=new Set;for(let a of tS(t,{includeFallbackWhenUnknown:!0})){let n=await tf(t,["shell","cmd","package","query-activities","--brief","-a","android.intent.action.MAIN","-c",a],{allowFailure:!0});if(0===n.exitCode&&0!==n.stdout.trim().length)for(let t of b(n.stdout))e.add(t)}return e}function tS(t,e={}){return"tv"===t.target?[tI]:"mobile"===t.target?[tb]:e.includeFallbackWhenUnknown?[tb,tI]:[tb]}async function tR(t){return I((await tf(t,["shell","pm","list","packages","-3"])).stdout)}function tx(t){let e=new Set(["com","android","google","app","apps","service","services","mobile","client"]),a=t.split(".").flatMap(t=>t.split(/[_-]+/)).map(t=>t.trim().toLowerCase()).filter(t=>t.length>0),n=a[a.length-1]??t;for(let t=a.length-1;t>=0;t-=1){let i=a[t];if(i&&!e.has(i)){n=i;break}}return n.split(/[^a-z0-9]+/i).filter(Boolean).map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join(" ")}async function tU(t){let e=await tF(t,[["shell","dumpsys","window","windows"],["shell","dumpsys","window"]]);if(e)return e;let a=await tF(t,[["shell","dumpsys","activity","activities"],["shell","dumpsys","activity"]]);return a||{}}async function tP(t){return await tB(t,[["shell","dumpsys","window","windows"],["shell","dumpsys","window"]])}async function tF(t,e){for(let a of e){let e=N((await tf(t,a,{allowFailure:!0})).stdout??"");if(e)return e}return null}async function tB(t,e){for(let a of e){let e=O((await tf(t,a,{allowFailure:!0})).stdout??"",(t,e)=>(function(t,e){let a=t.split("}")[0]?.trim()??t.trim(),n=v.exec(a);if(n){let t=n[1];return{package:t,focusedWindow:`Application Not Responding: ${t}`,raw:e}}let i=_.exec(a);if(!i)return null;let r=i[1];if(void 0===r)return null;let o=r.trim().replace(/\s+/g," "),s=M.exec(o)?.[1];return{...s?{package:s}:{},focusedWindow:o,raw:e}})(t,e));if(e)return e}return null}async function t$(t,e){let a=function(t){let e;try{e=new URL(t)}catch{return null}let a=e.hostname.toLowerCase();if(!tD.has(a)||!e.port)return null;let n=Number(e.port);return Number.isInteger(n)?`tcp:${n}`:null}(e);if(!a)return;let n=f(m(t));try{await n.ensure({local:a,remote:a})}catch(e){let t={localPort:a.replace("tcp:",""),operation:`adb reverse ${a} ${a}`};throw e instanceof i&&Object.assign(t,{hint:e.details?.hint,diagnosticId:e.details?.diagnosticId,logPath:e.details?.logPath}),new i("COMMAND_FAILED",`Failed to ensure Android port reverse ${a} before opening localhost URL`,t,e)}}function tV(t){return/^[A-Za-z0-9_@%+=:,./-]+$/.test(t)?t:`'${t.replace(/'/g,"'\\''")}'`}function tW(t){return(t.launchArgs??[]).map(tV)}async function tG(t,e,a){var n;t.booted||await tp(t.id);let i="string"==typeof(n=a)?{activity:n}:n??{},r=i.activity,o=e.trim();if(C(o))return void await tj(t,o,i);if(void 0!==i.url)return void await tH(t,e,i);let s=await tT(t,e),l=tS(t)[0]??tb;"intent"===s.type?await tK(t,s.value,i):r?await tz(t,s.value,r,l,i):await tq(t,s.value,l,i)}async function tj(t,e,a){var n;let r;if(a.activity)throw new i("INVALID_ARGS","Activity override is not supported when opening a deep link URL");await t$(t,e),await tf(t,["shell","am","start","-W","-a","android.intent.action.VIEW","-d",e,...(n=a.appBundleId,(r=n?.trim())?["-p",r]:[]),...tW(a)])}async function tH(t,e,a){if(a.activity)throw new i("INVALID_ARGS","Activity override is not supported when opening an app-bound deep link URL");let n=a.url?.trim()??"";if(!C(n))throw new i("INVALID_ARGS","Android app-bound open requires a valid URL target");let r=await tJ(t,e,"app-bound open");await tf(t,["shell","am","start","-W","-a","android.intent.action.VIEW","-d",n,"-p",r,...tW(a)])}async function tK(t,e,a){if(a.activity)throw new i("INVALID_ARGS","Activity override requires a package name, not an intent");await tf(t,["shell","am","start","-W","-a",e,...tW(a)])}async function tz(t,e,a,n,i){let r=a.includes("/")?a:`${e}/${a.startsWith(".")?a:`.${a}`}`;try{await tf(t,tZ(r,n,i))}catch(a){throw await tY(t,e,a),a}}async function tq(t,e,a,n){let r=await tf(t,["shell","am","start","-W","-a","android.intent.action.MAIN","-c",tN,"-c",a,"-p",e,...tW(n)],{allowFailure:!0});if(0===r.exitCode&&!t9(r.stdout,r.stderr))return;let o=await t1(t,e);if(!o){if(!await tQ(t,e))throw tX(e);throw new i("COMMAND_FAILED",`Failed to launch ${e}`,{stdout:r.stdout,stderr:r.stderr})}await tf(t,tZ(o,a,n))}function tZ(t,e,a){return["shell","am","start","-W","-a","android.intent.action.MAIN","-c",tN,"-c",e,"-n",t,...tW(a)]}async function tJ(t,e,a){let n=await tT(t,e);if("intent"===n.type)throw new i("INVALID_ARGS",`Android ${a} requires a package name, not an intent`);return n.value}function tX(t){return new i("APP_NOT_INSTALLED",`No package found matching "${t}"`,{package:t,hint:tO})}async function tQ(t,e){let a=await tf(t,["shell","pm","path",e],{allowFailure:!0}),n=`${a.stdout}
4
+ ${a.stderr}`;return!!(0===a.exitCode&&/\bpackage:/i.test(n))||(t0(n),!1)}async function tY(t,e,a){if(t0(a instanceof i?`${String(a.details?.stdout??"")}
5
+ ${String(a.details?.stderr??"")}`:"")||!await tQ(t,e))throw tX(e)}function t0(t){return/\bunknown package\b/i.test(t)||/\bpackage .* (?:was|is) not found\b/i.test(t)||/\bpackage .* does not exist\b/i.test(t)||/\bcould not find package\b/i.test(t)}async function t1(t,e){for(let a of Array.from(new Set(tS(t,{includeFallbackWhenUnknown:!0})))){let n=await tf(t,["shell","cmd","package","resolve-activity","--brief","-a","android.intent.action.MAIN","-c",a,e],{allowFailure:!0});if(0!==n.exitCode)continue;let i=t2(n.stdout);if(i)return i}return null}function t9(t,e){let a=`${t}
6
+ ${e}`;return/Error:.*(?:Activity not started|unable to resolve Intent)/i.test(a)}function t2(t){let e=t.split("\n").map(t=>t.trim()).filter(Boolean);for(let t=e.length-1;t>=0;t-=1){let a=e[t];if(void 0===a||!a.includes("/"))continue;let n=a.split(/\s+/)[0];if(void 0!==n)return n}return null}async function t3(t){t.booted||await tp(t.id)}async function t4(t,e){if("settings"===e.trim().toLowerCase()){await tf(t,["shell","am","force-stop","com.android.settings"]),await t5(t,"com.android.settings");return}let a=await tT(t,e);if("intent"===a.type)throw new i("INVALID_ARGS","Close requires a package name, not an intent");await tf(t,["shell","am","force-stop",a.value]),await t5(t,a.value)}async function t5(t,e){await t8(t,e),await t6(t,e)}async function t8(t,e){let a=Date.now()+2e3;for(;Date.now()<a;){let a=await t7(t);if(a?.package!==e)return;await p(50)}}async function t7(t){for(let e of[["shell","dumpsys","window","windows"],["shell","dumpsys","window"],["shell","dumpsys","activity","activities"],["shell","dumpsys","activity"]]){let a=N((await tf(t,e,{allowFailure:!0})).stdout??"");if(a)return a}return null}async function t6(t,e){let a=Date.now()+2e3;for(;Date.now()<a;){if(!await et(t,e)&&(await p(150),!await et(t,e)))return;await p(50)}}async function et(t,e){return((await tf(t,["shell","pidof",e],{allowFailure:!0})).stdout??"").trim().length>0}async function ee(t,e){let a=await tT(t,e);if("intent"===a.type)throw new i("INVALID_ARGS","App uninstall requires a package name, not an intent");let n=await tf(t,["uninstall",a.value],{allowFailure:!0});if(0!==n.exitCode){let t=`${n.stdout}
7
+ ${n.stderr}`.toLowerCase();if(!t.includes("unknown package")&&!t.includes("not installed"))throw new i("COMMAND_FAILED",`adb uninstall failed for ${a.value}`,{stdout:n.stdout,stderr:n.stderr,exitCode:n.exitCode})}return{package:a.value}}let ea=null;async function en(){let t=`${process.env.PATH??""}::${process.env.AGENT_DEVICE_BUNDLETOOL_JAR??""}`;if(ea?.key===t)return ea.invocation;if(await l("bundletool")){let e={cmd:"bundletool",prefixArgs:[]};return ea={key:t,invocation:e},e}let e=await s(process.env.AGENT_DEVICE_BUNDLETOOL_JAR,"AGENT_DEVICE_BUNDLETOOL_JAR");if(!e)throw new i("TOOL_MISSING","bundletool not found in PATH. Install bundletool or set AGENT_DEVICE_BUNDLETOOL_JAR to a bundletool-all.jar path.");let a={cmd:"java",prefixArgs:["-jar",e]};return ea={key:t,invocation:a},a}async function ei(t){let e=await en();await o(e.cmd,[...e.prefixArgs,...t])}async function er(n,i){let r=m(n),o="universal";if(r.installBundle)return void await r.installBundle(i,{mode:o});let s=await t.mkdtemp(a.join(e.tmpdir(),"agent-device-aab-")),l=a.join(s,"bundle.apks");try{await ei(["build-apks","--bundle",i,"--output",l,"--mode",o]),await ei(["install-apks","--apks",l,"--device-id",n.id])}finally{await t.rm(s,{recursive:!0,force:!0})}}async function eo(t,e){".aab"===a.extname(e).toLowerCase()?await er(t,e):await w(e,{device:t,replace:!0})}async function es(t){return new Set((await tf(t,["shell","pm","list","packages"])).stdout.split("\n").map(t=>t.replace("package:","").trim()).filter(Boolean))}async function el(t,e){let a=Array.from(await es(t)).filter(t=>!e.has(t));if(1===a.length)return a[0]}async function ed(t,e){await tC.invalidateWhile(tE(t),async()=>{t.booted||await tp(t.id),await eo(t,e)})}async function eu(t,e,a){let n=a?void 0:await es(t);return await ed(t,e),a??(n?await el(t,n):void 0)}async function ec(t,e){t.booted||await tp(t.id);let a=await tv({kind:"path",path:e});try{let e=await eu(t,a.installablePath,a.packageName),n=e?tx(e):void 0;return{archivePath:a.archivePath,installablePath:a.installablePath,packageName:e,appName:n,launchTarget:e}}finally{await a.cleanup()}}async function ep(t,e,a){return await tC.invalidateWhile(tE(t),async()=>{t.booted||await tp(t.id);let{package:n}=await ee(t,e),i=await tv({kind:"path",path:a},{resolveIdentity:!1});try{await ed(t,i.installablePath)}finally{await i.cleanup()}return{package:n}})}async function ef(t,e={}){let a=["logcat","-d","-v","time"];void 0!==e.lines&&a.push("-t",String(Math.max(1,Math.floor(e.lines))));let n=await t(a,{allowFailure:!0,timeoutMs:e.timeoutMs,signal:e.signal});if(0!==n.exitCode)throw new i("COMMAND_FAILED","Failed to capture Android logcat",{stdout:n.stdout,stderr:n.stderr,exitCode:n.exitCode});return n.stdout}function em(t,e={}){if(!t.spawn)throw new i("UNSUPPORTED_OPERATION","Android ADB provider does not support streams",{capability:"adb.spawn"});let a=["logcat","-v","time"];e.pid&&a.push("--pid",e.pid);let n=t.spawn(a,{stdio:["ignore","pipe","pipe"],signal:e.signal});return e.output&&n.stdout&&n.stdout.pipe(e.output,{end:!1}),n}export{R as Deadline,tm as androidDeviceForSerial,H as bootFailureHint,ef as captureAndroidLogcatWithAdb,ty as classifyAndroidAppTarget,j as classifyBootFailure,t4 as closeAndroidApp,L as createAppResolutionCache,tc as ensureAndroidEmulatorBooted,tg as formatAndroidInstalledPackageRequiredMessage,tU as getAndroidAppState,tP as getAndroidBlockingDialogFocus,tx as inferAndroidAppName,ec as installAndroidApp,eu as installAndroidInstallablePathAndResolvePackageName,t9 as isAmStartError,tw as isClipboardShellUnsupported,C as isDeepLinkTarget,S as isEnvTruthy,G as isInfrastructureBootFailureReason,E as isWebUrl,tL as listAndroidApps,tr as listAndroidDevices,tG as openAndroidApp,t3 as openAndroidDevice,N as parseAndroidForegroundApp,t2 as parseAndroidLaunchComponent,b as parseAndroidLaunchablePackages,I as parseAndroidUserInstalledPackages,$ as parseSerialAllowlist,tv as prepareAndroidInstallArtifact,ep as reinstallAndroidApp,tT as resolveAndroidApp,V as resolveAndroidSerialAllowlist,T as resolveIosDeviceDeepLinkBundleId,B as resolveIosSimulatorDeviceSetPath,x as retryWithPolicy,tf as runAndroidAdb,em as streamAndroidLogcatWithAdb,tp as waitForAndroidBoot,U as withRetry};
package/dist/src/940.js CHANGED
@@ -1 +1 @@
1
- import{AppError as e}from"./9152.js";import{normalizeText as t}from"./7556.js";let r=new Set(["id","role","text","label","value","appname","windowtitle"]),n=new Set(["visible","hidden","editable","selected","enabled","hittable"]),l=new Set([...r,...n]);function i(t){let r=t.trim();if(!r)throw new e("INVALID_ARGS","Selector expression cannot be empty");let n=function(t){let r=[],n="",l=null;for(let i=0;i<t.length;i+=1){let u=t[i];if(('"'===u||"'"===u)&&!h(t,i)){l=f(l,u),n+=u;continue}if(!l&&"|"===u&&"|"===t[i+1]){let l=n.trim();if(!l)throw new e("INVALID_ARGS",`Invalid selector fallback expression: ${t}`);r.push(l),n="",i+=1;continue}n+=u}let i=n.trim();if(!i)throw new e("INVALID_ARGS",`Invalid selector fallback expression: ${t}`);return r.push(i),r}(r);if(0===n.length)throw new e("INVALID_ARGS","Selector expression cannot be empty");return{raw:r,selectors:n.map(t=>(function(t){let r=t.trim();if(!r)throw new e("INVALID_ARGS","Selector segment cannot be empty");let n=function(t){let r=[],n="",l=null;for(let e=0;e<t.length;e+=1){let i=t.charAt(e);if(('"'===i||"'"===i)&&!h(t,e)){l=f(l,i),n+=i;continue}if(!l&&/\s/.test(i)){n.trim()&&r.push(n.trim()),n="";continue}n+=i}if(l)throw new e("INVALID_ARGS",`Unclosed quote in selector: ${t}`);return n.trim()&&r.push(n.trim()),r}(r);if(0===n.length)throw new e("INVALID_ARGS",`Invalid selector segment: ${t}`);return{raw:r,terms:n.map(s)}})(t))}}function u(e){try{return i(e)}catch{return null}}function o(e){let t=e.trim();if(!t)return!1;if("||"===t)return!0;let r=t.indexOf("=");if(-1!==r){let e=t.slice(0,r).trim().toLowerCase();return l.has(e)}return l.has(t.toLowerCase())}function a(e,t={}){if(0===e.length)return null;let r=t.preferTrailingValue??!1,n=0,l=[];for(;n<e.length;){let t=e[n];if(void 0===t||!o(t))break;n+=1;let r=e.slice(0,n).join(" ").trim();r&&u(r)&&l.push(n)}if(0===l.length)return null;let i=l.at(-1);if(void 0===i)return null;let c=i;if(r)for(let t=l.length-1;t>=0;t-=1){let r=l[t];if(void 0!==r&&r<e.length){c=r;break}}let s=e.slice(0,c).join(" ").trim();return s?{selectorExpression:s,rest:e.slice(c)}:null}function c(e){let t=e[0]??"",r=a(e.slice(1),{preferTrailingValue:"text"===t});return{predicate:t,split:r}}function s(t){let r=t.trim();if(!r)throw new e("INVALID_ARGS","Empty selector term");let i=r.indexOf("=");if(-1===i){let l=r.toLowerCase();if(!n.has(l))throw new e("INVALID_ARGS",`Invalid selector term "${t}", expected key=value`);return{key:l,value:!0}}let u=r.slice(0,i).trim().toLowerCase(),o=r.slice(i+1).trim();if(!l.has(u))throw new e("INVALID_ARGS",`Unknown selector key: ${u}`);if(!o)throw new e("INVALID_ARGS",`Missing selector value for key: ${u}`);if(n.has(u)){let t,r="true"===(t=d(o).toLowerCase())||"false"!==t&&null;if(null===r)throw new e("INVALID_ARGS",`Invalid boolean value for ${u}: ${o}`);return{key:u,value:r}}return{key:u,value:d(o)}}function f(e,t){return e?e===t?null:e:t}function d(e){let t=e.trim();return t.startsWith('"')&&t.endsWith('"')||t.startsWith("'")&&t.endsWith("'")?t.slice(1,-1).replace(/\\(["'])/g,"$1"):t}function h(e,t){let r=0;for(let n=t-1;n>=0&&"\\"===e[n];n-=1)r+=1;return r%2==1}function p(e){var t;let r,n=w(e.label),l=w(e.value),i=w(e.identifier),u=(t=i)&&!/^[\w.]+:id\/[\w.-]+$/i.test(t)&&!/^_?NS:\d+$/i.test(t)?i:"";return(r=g(e.type??"")).includes("textfield")||r.includes("securetextfield")||r.includes("searchfield")||r.includes("edittext")||r.includes("textview")||r.includes("textarea")?l||n||u:n||l||u}function m(e){let t=e.replace(/\s+/g," ").trim();return t.length<=48?t:`${t.slice(0,45)}...`}function b(e,t){var r;let n=p(e),l=function(e,t){if("text-view"===t||"text-field"===t||"search"===t)return!0;let r=g(e.type??""),n=`${e.role??""} ${e.subrole??""}`.toLowerCase();return r.includes("textview")||r.includes("textarea")||r.includes("textfield")||r.includes("securetextfield")||r.includes("searchfield")||r.includes("edittext")||n.includes("text area")||n.includes("text field")}(e,t);return{text:n,isLargeSurface:l,shouldSummarize:l&&!!(r=n)&&(r.length>80||/[\r\n]/.test(r))}}function w(e){return"string"==typeof e?e.trim():""}function g(e){let t=e.trim().replace(/XCUIElementType/gi,"").replace(/^AX/,"").toLowerCase(),r=Math.max(t.lastIndexOf("."),t.lastIndexOf("/"));return -1!==r&&(t=t.slice(r+1)),t}function v(e,t){let r=t.toLowerCase();return e.find(e=>{let t=(e.label??"").toLowerCase(),n=(e.value??"").toLowerCase(),l=(e.identifier??"").toLowerCase();return t.includes(r)||n.includes(r)||l.includes(r)})??null}function x(e,t){let r=[e.label,e.value,e.identifier].map(e=>"string"==typeof e?e.trim():"").find(e=>e&&e.length>0);return r&&S(r)?r:function(e,t){if(!e.rect)return;let r=e.rect.y+e.rect.height/2,n=null;for(let e of t){if(!e.rect)continue;let t=[e.label,e.value,e.identifier].map(e=>"string"==typeof e?e.trim():"").find(e=>e&&e.length>0);if(!t||!S(t))continue;let l=Math.abs(e.rect.y+e.rect.height/2-r);(!n||l<n.distance)&&(n={label:t,distance:l})}return n?.label}(e,t)??(r&&S(r)?r:void 0)}function S(e){let t=e.trim();return!(!t||/^(true|false)$/i.test(t)||/^\d+$/.test(t))}function I(e){let t=[],r=[];for(let n of e){let e=n.depth??0;for(;t.length>0&&e<=t[t.length-1];)t.pop();let l=g(n.type??""),i=[n.label,n.value,n.identifier].map(e=>"string"==typeof e?e.trim():"").find(e=>e&&e.length>0),u=!!i&&S(i);if(("group"===l||"ioscontentgroup"===l)&&!u){t.push(e);continue}let o=Math.max(0,e-t.length);r.push({...n,depth:o})}return r}function $(e,t){let r=g(e);return!r||("android"===t?r.includes("edittext")||r.includes("autocompletetextview"):r.includes("textfield")||r.includes("securetextfield")||r.includes("searchfield")||r.includes("textview")||r.includes("textarea")||"search"===r)}function A(e,t){return t.hittable?t:y(e,t,e=>!0===e.hittable)}function y(e,t,r){let n=t,l=new Set;for(;void 0!==n.parentIndex&&!l.has(n.ref);){l.add(n.ref);let t=e[n.parentIndex];if(!t)break;if(r(t))return t;n=t}return null}function N(e){return[e.label,e.value,e.identifier].map(e=>"string"==typeof e?e.trim():"").filter(e=>e.length>0)[0]??""}function L(e){return p(e)}function _(e){return!0===e.hittable||!!e.rect&&e.rect.width>0&&e.rect.height>0}function C(e,t){return $(e.type??"",t)&&!1!==e.enabled}function R(e,t,r){return t.terms.every(t=>(function(e,t,r){switch(t.key){case"id":return V(e.identifier,String(t.value));case"role":return V(g(e.type??""),String(t.value));case"label":return V(e.label,String(t.value));case"value":return V(e.value,String(t.value));case"text":return V(N(e),String(t.value));case"appname":return V(e.appName,String(t.value));case"windowtitle":return V(e.windowTitle,String(t.value));case"visible":return _(e)===!!t.value;case"hidden":return!_(e)==!!t.value;case"editable":return C(e,r)===!!t.value;case"selected":return!0===e.selected==!!t.value;case"enabled":return!1!==e.enabled==!!t.value;case"hittable":return!0===e.hittable==!!t.value;default:return!1}})(e,t,r))}function V(e,r){return t(e??"")===t(r)}function G(e,t,r){let n=r.requireRect??!1,l=r.requireUnique??!0,i=[];for(let[u,o]of t.selectors.entries()){let t=function(e,t,r,n){let l=0,i=null,u=null,o=!1;for(let a of e){if(n&&!a.rect||!R(a,t,r))continue;if(l+=1,i??=a,!u){u=a;continue}let e=function(e,t){let r=e.depth??0,n=t.depth??0;if(r!==n)return r>n?1:-1;let l=k(e),i=k(t);return l!==i?l<i?1:-1:0}(a,u);e>0?(u=a,o=!1):0===e&&(o=!0)}return{count:l,firstNode:i,disambiguated:o?null:u}}(e,o,r.platform,n);if(i.push({selector:o.raw,matches:t.count}),0!==t.count&&t.firstNode){if(l&&1!==t.count){if(!r.disambiguateAmbiguous||!t.disambiguated)continue;return{node:t.disambiguated,selector:o,selectorIndex:u,matches:t.count,diagnostics:i}}return{node:t.firstNode,selector:o,selectorIndex:u,matches:t.count,diagnostics:i}}}return null}function T(e,t,r){let n=r.requireRect??!1,l=[];for(let[i,u]of t.selectors.entries()){let t=function(e,t,r,n){let l=0;for(let i of e)(!n||i.rect)&&R(i,t,r)&&(l+=1);return l}(e,u,r.platform,n);if(l.push({selector:u.raw,matches:t}),t>0)return{selectorIndex:i,selector:u,matches:t,diagnostics:l}}return null}function D(e,t,r){if(0===t.length)return`Selector did not match: ${e.raw}`;let n=t.map(e=>`${e.selector} -> ${e.matches}`).join(", ");return r.unique??!0?`Selector did not resolve uniquely (${n})`:`Selector did not match (${n})`}function k(e){return e.rect?e.rect.width*e.rect.height:1/0}function q(e,t,r={}){let n=[],l=g(e.type??""),i=U(e.identifier),u=U(e.label),o=U(e.value),a=U(N(e)),c="fill"===r.action;i&&n.push(`id=${M(i)}`),l&&u&&n.push(c?`role=${M(l)} label=${M(u)} editable=true`:`role=${M(l)} label=${M(u)}`),u&&n.push(c?`label=${M(u)} editable=true`:`label=${M(u)}`),o&&n.push(c?`value=${M(o)} editable=true`:`value=${M(o)}`),a&&a!==u&&a!==o&&n.push(c?`text=${M(a)} editable=true`:`text=${M(a)}`),l&&c&&!n.some(e=>e.includes("editable=true"))&&n.push(`role=${M(l)} editable=true`);let s=Array.from(new Set(n));return 0===s.length&&l&&s.push(c?`role=${M(l)} editable=true`:`role=${M(l)}`),0===s.length&&_(e)&&s.push("visible=true"),s}function M(e){return JSON.stringify(e)}function U(e){if(!e)return null;let t=e.trim();return t||null}export{q as buildSelectorChainForNode,m as buildTextPreview,b as describeTextSurface,L as extractNodeReadText,N as extractNodeText,p as extractReadableText,y as findNearestAncestor,A as findNearestHittableAncestor,v as findNodeByLabel,T as findSelectorChainMatch,D as formatSelectorFailure,$ as isFillableType,C as isNodeEditable,_ as isNodeVisible,o as isSelectorToken,R as matchesSelector,g as normalizeType,i as parseSelectorChain,I as pruneGroupNodes,x as resolveRefLabel,G as resolveSelectorChain,c as splitIsSelectorArgs,a as splitSelectorFromArgs,w as trimText,u as tryParseSelectorChain};
1
+ import{AppError as e}from"./9152.js";import{normalizeText as t}from"./7556.js";let n=new Set(["id","role","text","label","value","appname","windowtitle"]),r=new Set(["visible","hidden","editable","selected","enabled","hittable"]),l=new Set([...n,...r]);function i(t){let n=t.trim();if(!n)throw new e("INVALID_ARGS","Selector expression cannot be empty");let r=function(t){let n=[],r="",l=null;for(let i=0;i<t.length;i+=1){let u=t[i];if(('"'===u||"'"===u)&&!h(t,i)){l=f(l,u),r+=u;continue}if(!l&&"|"===u&&"|"===t[i+1]){let l=r.trim();if(!l)throw new e("INVALID_ARGS",`Invalid selector fallback expression: ${t}`);n.push(l),r="",i+=1;continue}r+=u}let i=r.trim();if(!i)throw new e("INVALID_ARGS",`Invalid selector fallback expression: ${t}`);return n.push(i),n}(n);if(0===r.length)throw new e("INVALID_ARGS","Selector expression cannot be empty");return{raw:n,selectors:r.map(t=>(function(t){let n=t.trim();if(!n)throw new e("INVALID_ARGS","Selector segment cannot be empty");let r=function(t){let n=[],r="",l=null;for(let e=0;e<t.length;e+=1){let i=t.charAt(e);if(('"'===i||"'"===i)&&!h(t,e)){l=f(l,i),r+=i;continue}if(!l&&/\s/.test(i)){r.trim()&&n.push(r.trim()),r="";continue}r+=i}if(l)throw new e("INVALID_ARGS",`Unclosed quote in selector: ${t}`);return r.trim()&&n.push(r.trim()),n}(n);if(0===r.length)throw new e("INVALID_ARGS",`Invalid selector segment: ${t}`);return{raw:n,terms:r.map(s)}})(t))}}function u(e){try{return i(e)}catch{return null}}function o(e){let t=e.trim();if(!t)return!1;if("||"===t)return!0;let n=t.indexOf("=");if(-1!==n){let e=t.slice(0,n).trim().toLowerCase();return l.has(e)}return l.has(t.toLowerCase())}function a(e,t={}){if(0===e.length)return null;let n=t.preferTrailingValue??!1,r=0,l=[];for(;r<e.length;){let t=e[r];if(void 0===t||!o(t))break;r+=1;let n=e.slice(0,r).join(" ").trim();n&&u(n)&&l.push(r)}if(0===l.length)return null;let i=l.at(-1);if(void 0===i)return null;let c=i;if(n)for(let t=l.length-1;t>=0;t-=1){let n=l[t];if(void 0!==n&&n<e.length){c=n;break}}let s=e.slice(0,c).join(" ").trim();return s?{selectorExpression:s,rest:e.slice(c)}:null}function c(e){let t=e[0]??"",n=a(e.slice(1),{preferTrailingValue:"text"===t});return{predicate:t,split:n}}function s(t){let n=t.trim();if(!n)throw new e("INVALID_ARGS","Empty selector term");let i=n.indexOf("=");if(-1===i){let l=n.toLowerCase();if(!r.has(l))throw new e("INVALID_ARGS",`Invalid selector term "${t}", expected key=value`);return{key:l,value:!0}}let u=n.slice(0,i).trim().toLowerCase(),o=n.slice(i+1).trim();if(!l.has(u))throw new e("INVALID_ARGS",`Unknown selector key: ${u}`);if(!o)throw new e("INVALID_ARGS",`Missing selector value for key: ${u}`);if(r.has(u)){let t,n="true"===(t=d(o).toLowerCase())||"false"!==t&&null;if(null===n)throw new e("INVALID_ARGS",`Invalid boolean value for ${u}: ${o}`);return{key:u,value:n}}return{key:u,value:d(o)}}function f(e,t){return e?e===t?null:e:t}function d(e){let t=e.trim();return t.startsWith('"')&&t.endsWith('"')||t.startsWith("'")&&t.endsWith("'")?t.slice(1,-1).replace(/\\(["'])/g,"$1"):t}function h(e,t){let n=0;for(let r=t-1;r>=0&&"\\"===e[r];r-=1)n+=1;return n%2==1}function p(e){var t;let n,r=w(e.label),l=w(e.value),i=w(e.identifier),u=(t=i)&&!/^[\w.]+:id\/[\w.-]+$/i.test(t)&&!/^_?NS:\d+$/i.test(t)?i:"";return(n=x(e.type??"")).includes("textfield")||n.includes("securetextfield")||n.includes("searchfield")||n.includes("edittext")||n.includes("textview")||n.includes("textarea")?l||r||u:r||l||u}function m(e){let t=e.replace(/\s+/g," ").trim();return t.length<=48?t:`${t.slice(0,45)}...`}function b(e,t){var n;let r=p(e),l=function(e,t){if("text-view"===t||"text-field"===t||"search"===t)return!0;let n=x(e.type??""),r=`${e.role??""} ${e.subrole??""}`.toLowerCase();return n.includes("textview")||n.includes("textarea")||n.includes("textfield")||n.includes("securetextfield")||n.includes("searchfield")||n.includes("edittext")||r.includes("text area")||r.includes("text field")}(e,t);return{text:r,isLargeSurface:l,shouldSummarize:l&&!!(n=r)&&(n.length>80||/[\r\n]/.test(n))}}function w(e){return"string"==typeof e?e.trim():""}function x(e){let t=e.trim().replace(/XCUIElementType/gi,"").replace(/^AX/,"").toLowerCase(),n=Math.max(t.lastIndexOf("."),t.lastIndexOf("/"));return -1!==n&&(t=t.slice(n+1)),t}function g(e,t){let n=t.toLowerCase();return e.find(e=>{let t=(e.label??"").toLowerCase(),r=(e.value??"").toLowerCase(),l=(e.identifier??"").toLowerCase();return t.includes(n)||r.includes(n)||l.includes(n)})??null}function v(e,t){let n=[e.label,e.value,e.identifier].map(e=>"string"==typeof e?e.trim():"").find(e=>e&&e.length>0);return n&&S(n)?n:function(e,t){if(!e.rect)return;let n=e.rect.y+e.rect.height/2,r=null;for(let e of t){if(!e.rect)continue;let t=[e.label,e.value,e.identifier].map(e=>"string"==typeof e?e.trim():"").find(e=>e&&e.length>0);if(!t||!S(t))continue;let l=Math.abs(e.rect.y+e.rect.height/2-n);(!r||l<r.distance)&&(r={label:t,distance:l})}return r?.label}(e,t)??(n&&S(n)?n:void 0)}function S(e){let t=e.trim();return!(!t||/^(true|false)$/i.test(t)||/^\d+$/.test(t))}function I(e){let t=[],n=[];for(let r of e){let e=r.depth??0;for(;t.length>0&&e<=t[t.length-1];)t.pop();let l=x(r.type??""),i=[r.label,r.value,r.identifier].map(e=>"string"==typeof e?e.trim():"").find(e=>e&&e.length>0),u=!!i&&S(i);if(("group"===l||"ioscontentgroup"===l)&&!u){t.push(e);continue}let o=Math.max(0,e-t.length);n.push({...r,depth:o})}return n}function $(e,t){let n=x(e);return!n||("android"===t?n.includes("edittext")||n.includes("autocompletetextview"):n.includes("textfield")||n.includes("securetextfield")||n.includes("searchfield")||n.includes("textview")||n.includes("textarea")||"search"===n)}function A(e,t){return t.hittable?t:_(e,t,e=>!0===e.hittable)}function y(e){return new Map(e.map(e=>[e.index,e]))}function N(e,t,n,r){let l=t,i=new Set;for(;"number"==typeof l.parentIndex&&!i.has(l.index)&&(i.add(l.index),l=n.get(l.parentIndex)??e[l.parentIndex]);){let e=r(l);if(null!==e)return e}return null}function L(e,t,n,r){return!!N(e,t,r,e=>e===n||e.index===n.index?e:null)}function _(e,t,n){let r=y(e);return N(e,t,r,e=>n(e)?e:null)}function C(e){return[e.label,e.value,e.identifier].map(e=>"string"==typeof e?e.trim():"").filter(e=>e.length>0)[0]??""}function R(e){return p(e)}function V(e){return!0===e.hittable||!!e.rect&&e.rect.width>0&&e.rect.height>0}function D(e,t){return $(e.type??"",t)&&!1!==e.enabled}function G(e,t,n){return t.terms.every(t=>(function(e,t,n){switch(t.key){case"id":return T(e.identifier,String(t.value));case"role":return T(x(e.type??""),String(t.value));case"label":return T(e.label,String(t.value));case"value":return T(e.value,String(t.value));case"text":return T(C(e),String(t.value));case"appname":return T(e.appName,String(t.value));case"windowtitle":return T(e.windowTitle,String(t.value));case"visible":return V(e)===!!t.value;case"hidden":return!V(e)==!!t.value;case"editable":return D(e,n)===!!t.value;case"selected":return!0===e.selected==!!t.value;case"enabled":return!1!==e.enabled==!!t.value;case"hittable":return!0===e.hittable==!!t.value;default:return!1}})(e,t,n))}function T(e,n){return t(e??"")===t(n)}function k(e,t,n){let r=n.requireRect??!1,l=n.requireUnique??!0,i=[];for(let[u,o]of t.selectors.entries()){let t=function(e,t,n,r){let l=0,i=null,u=null,o=!1;for(let a of e){if(r&&!a.rect||!G(a,t,n))continue;if(l+=1,i??=a,!u){u=a;continue}let e=function(e,t){let n=e.depth??0,r=t.depth??0;if(n!==r)return n>r?1:-1;let l=O(e),i=O(t);return l!==i?l<i?1:-1:0}(a,u);e>0?(u=a,o=!1):0===e&&(o=!0)}return{count:l,firstNode:i,disambiguated:o?null:u}}(e,o,n.platform,r);if(i.push({selector:o.raw,matches:t.count}),0!==t.count&&t.firstNode){if(l&&1!==t.count){if(!n.disambiguateAmbiguous||!t.disambiguated)continue;return{node:t.disambiguated,selector:o,selectorIndex:u,matches:t.count,diagnostics:i}}return{node:t.firstNode,selector:o,selectorIndex:u,matches:t.count,diagnostics:i}}}return null}function M(e,t,n){let r=n.requireRect??!1,l=[];for(let[i,u]of t.selectors.entries()){let t=function(e,t,n,r){let l=0;for(let i of e)(!r||i.rect)&&G(i,t,n)&&(l+=1);return l}(e,u,n.platform,r);if(l.push({selector:u.raw,matches:t}),t>0)return{selectorIndex:i,selector:u,matches:t,diagnostics:l}}return null}function q(e,t,n){if(0===t.length)return`Selector did not match: ${e.raw}`;let r=t.map(e=>`${e.selector} -> ${e.matches}`).join(", ");return n.unique??!0?`Selector did not resolve uniquely (${r})`:`Selector did not match (${r})`}function O(e){return e.rect?e.rect.width*e.rect.height:1/0}function U(e,t,n={}){let r=[],l=x(e.type??""),i=F(e.identifier),u=F(e.label),o=F(e.value),a=F(C(e)),c="fill"===n.action;i&&r.push(`id=${E(i)}`),l&&u&&r.push(c?`role=${E(l)} label=${E(u)} editable=true`:`role=${E(l)} label=${E(u)}`),u&&r.push(c?`label=${E(u)} editable=true`:`label=${E(u)}`),o&&r.push(c?`value=${E(o)} editable=true`:`value=${E(o)}`),a&&a!==u&&a!==o&&r.push(c?`text=${E(a)} editable=true`:`text=${E(a)}`),l&&c&&!r.some(e=>e.includes("editable=true"))&&r.push(`role=${E(l)} editable=true`);let s=Array.from(new Set(r));return 0===s.length&&l&&s.push(c?`role=${E(l)} editable=true`:`role=${E(l)}`),0===s.length&&V(e)&&s.push("visible=true"),s}function E(e){return JSON.stringify(e)}function F(e){if(!e)return null;let t=e.trim();return t||null}export{U as buildSelectorChainForNode,y as buildSnapshotNodeByIndex,m as buildTextPreview,b as describeTextSurface,R as extractNodeReadText,C as extractNodeText,p as extractReadableText,_ as findNearestAncestor,A as findNearestHittableAncestor,g as findNodeByLabel,M as findSelectorChainMatch,N as findSnapshotAncestor,q as formatSelectorFailure,L as isDescendantOfSnapshotNode,$ as isFillableType,D as isNodeEditable,V as isNodeVisible,o as isSelectorToken,G as matchesSelector,x as normalizeType,i as parseSelectorChain,I as pruneGroupNodes,v as resolveRefLabel,k as resolveSelectorChain,c as splitIsSelectorArgs,a as splitSelectorFromArgs,w as trimText,u as tryParseSelectorChain};
@@ -0,0 +1 @@
1
+ let e=["ios","android","macos","linux","apple"],t=["mobile","tv","desktop"],r=["ref","selector","point"];function i(e){return{type:"string",...e?{description:e}:{}}}function n(e){return{type:"integer",...e?{description:e}:{}}}function o(e){return{type:"boolean",...e?{description:e}:{}}}function s(e){return{type:"object",additionalProperties:!0,...e?{description:e}:{}}}function a(e){return{...e,required:!0}}function d(e){return z(i(e),k)}function c(e){return z({type:"number",...e?{description:e}:{}},$)}function l(e,t={}){var r,i;return z((r=e,i=t,{...n(r),...void 0===i.min?{}:{minimum:i.min},...void 0===i.max?{}:{maximum:i.max}}),(e,r)=>F(e,r,t))}function u(e){return z(o(e),D)}function p(e,t){return z({type:"string",enum:e,...t?{description:t}:{}},(t,r)=>U(t,r,e))}function f(e){return z(s(e),H)}function m(e){return z({type:"array",items:{type:"string"},...e?{description:e}:{}},K)}function b(e){return z(e,(e,t)=>e[t])}function g(e,t){return z(e,t)}function y(){return z({oneOf:[...W(),{type:"object",properties:{kind:{type:"string",const:"point"},x:{type:"number"},y:{type:"number"}},required:["kind","x","y"],additionalProperties:!1}],description:"UI target. This is separate from deviceTarget, which selects the device form."},(e,t)=>void 0===e[t]?void 0:function(e,t){let i=G(e,t),n=q(i,"kind",r);switch(n){case"ref":return{kind:n,ref:T(i,"ref"),label:k(i,"label")};case"selector":return{kind:n,selector:T(i,"selector")};case"point":return{kind:n,x:O(i,"x"),y:O(i,"y")}}}(e,t))}function h(){return z({oneOf:W(),description:"UI element target by snapshot ref or selector expression."},(e,t)=>{let r,i;return void 0===e[t]?void 0:"ref"===(i=q(r=G(e,t),"kind",["ref","selector"]))?{kind:i,ref:T(r,"ref"),label:k(r,"label")}:{kind:i,selector:T(r,"selector")}})}function v(e){return z({type:"object",description:e,properties:{x:{type:"number"},y:{type:"number"}},required:["x","y"],additionalProperties:!1},(e,t)=>void 0===e[t]?void 0:I(e,t))}function w(){return{depth:l("Snapshot traversal depth.",{min:0}),scope:d("Snapshot scope selector used before resolution."),raw:u("Use raw snapshot data during selector resolution.")}}function x(){return{count:l("Number of press/click repetitions.",{min:1}),intervalMs:l("Delay between repeated press/click actions.",{min:0}),holdMs:l("Hold duration for each action.",{min:0}),jitterPx:l("Randomization radius in pixels.",{min:0}),doubleTap:u("Request a double-tap action.")}}function E(r){return function(r,i=[]){return{type:"object",properties:{session:{type:"string",description:"Agent-device session name."},platform:{type:"string",enum:e,description:"Platform selector used to resolve a device."},deviceTarget:{type:"string",enum:t,description:"Device target form. Maps to the CLI --target flag."},target:{type:"string",enum:t,description:"Alias for deviceTarget on commands without a UI target field. Interaction commands reserve target for the UI element."},device:{type:"string",description:"Device name selector."},udid:{type:"string",description:"iOS device UDID selector."},serial:{type:"string",description:"Android serial selector."},iosSimulatorDeviceSet:{type:"string",description:"iOS simulator device-set path used for device resolution."},androidDeviceAllowlist:{type:"string",description:"Android serial allowlist used for device resolution."},daemonBaseUrl:{type:"string",description:"Remote daemon base URL."},daemonAuthToken:{type:"string",description:"Remote daemon auth token."},tenant:{type:"string",description:"Remote tenant identifier."},runId:{type:"string",description:"Lease run identifier."},leaseId:{type:"string",description:"Existing lease identifier."},cwd:{type:"string",description:"Working directory for command execution."},debug:{type:"boolean",description:"Enable debug diagnostics."},...r},...i.length>0?{required:i}:{},additionalProperties:!1}}(Object.fromEntries(Object.entries(r).map(([e,t])=>[e,t.schema])),Object.entries(r).flatMap(([e,t])=>t.required?[e]:[]))}function j(e,t){let r=A(e),i=Object.fromEntries(Object.entries(t).flatMap(([e,t])=>{let i=t.read(r,e);if(t.required&&void 0===i)throw Error(`Expected ${e} to be set.`);return void 0===i?[]:[[e,i]]})),n=S(r,{readTargetAlias:!Object.hasOwn(t,"target")});return L({...n,...P(n),...i})}function A(e){if(null==e)return{};if(!e||"object"!=typeof e||Array.isArray(e))throw Error("Expected object arguments.");return e}function S(r,i={}){return{session:k(r,"session"),platform:U(r,"platform",e),deviceTarget:function(e,r){let i=U(e,"deviceTarget",t);if(!1===r.readTargetAlias||void 0===e.target)return i;let n=U(e,"target",t);if(void 0!==i&&n!==i)throw Error("Expected target alias to match deviceTarget when both are set.");return i??n}(r,i),device:k(r,"device"),udid:k(r,"udid"),serial:k(r,"serial"),iosSimulatorDeviceSet:k(r,"iosSimulatorDeviceSet"),androidDeviceAllowlist:k(r,"androidDeviceAllowlist"),daemonBaseUrl:k(r,"daemonBaseUrl"),daemonAuthToken:k(r,"daemonAuthToken"),tenant:k(r,"tenant"),runId:k(r,"runId"),leaseId:k(r,"leaseId"),cwd:k(r,"cwd"),debug:D(r,"debug")}}function I(e,t){let r=G(e,t);return{x:O(r,"x"),y:O(r,"y")}}function T(e,t){let r=e[t];if("string"!=typeof r||0===r.length)throw Error(`Expected ${t} to be a non-empty string.`);return r}function k(e,t){let r=e[t];if(void 0!==r){if("string"!=typeof r||0===r.length)throw Error(`Expected ${t} to be a non-empty string.`);return r}}function O(e,t){let r=e[t];if("number"!=typeof r||!Number.isFinite(r))throw Error(`Expected ${t} to be a finite number.`);return r}function $(e,t){let r=e[t];if(void 0!==r){if("number"!=typeof r||!Number.isFinite(r))throw Error(`Expected ${t} to be a finite number.`);return r}}function F(e,t,r={}){let i=e[t];if(void 0!==i){if(!Number.isInteger(i))throw Error(`Expected ${t} to be an integer.`);if(void 0!==r.min&&i<r.min)throw Error(`Expected ${t} to be at least ${r.min}.`);if(void 0!==r.max&&i>r.max)throw Error(`Expected ${t} to be at most ${r.max}.`);return i}}function D(e,t){let r=e[t];if(void 0!==r){if("boolean"!=typeof r)throw Error(`Expected ${t} to be a boolean.`);return r}}function q(e,t,r){let i=e[t];if("string"!=typeof i||!r.includes(i))throw Error(`Expected ${t} to be one of: ${r.join(", ")}.`);return i}function U(e,t,r){let i=e[t];if(void 0!==i){if("string"!=typeof i||!r.includes(i))throw Error(`Expected ${t} to be one of: ${r.join(", ")}.`);return i}}function P(e){return L({session:e.session,platform:e.platform,target:e.deviceTarget,device:e.device,udid:e.udid,serial:e.serial,iosSimulatorDeviceSet:e.iosSimulatorDeviceSet,androidDeviceAllowlist:e.androidDeviceAllowlist,daemonBaseUrl:e.daemonBaseUrl,daemonAuthToken:e.daemonAuthToken,tenant:e.tenant,runId:e.runId,leaseId:e.leaseId,cwd:e.cwd,debug:e.debug})}function M(e){switch(e.kind){case"ref":return{ref:e.ref,label:e.label};case"selector":return{selector:e.selector};case"point":return{x:e.x,y:e.y}}}function R(e){switch(e.kind){case"ref":return{ref:e.ref,label:e.label};case"selector":return{selector:e.selector}}}function B(e){return{count:e.count,intervalMs:e.intervalMs,holdMs:e.holdMs,jitterPx:e.jitterPx,doubleTap:e.doubleTap}}function C(e){return{depth:e.depth,scope:e.scope,raw:e.raw}}function N(e,t,r){let i=new Set(t),n=Object.keys(e).filter(e=>!i.has(e));if(n.length>0)throw Error(`${r} has unknown field(s): ${n.join(", ")}.`)}function L(e){return Object.fromEntries(Object.entries(e).filter(([,e])=>void 0!==e))}function z(e,t){return{schema:e,required:!1,read:t}}function H(e,t){let r=e[t];if(void 0!==r){if(!r||"object"!=typeof r||Array.isArray(r))throw Error(`Expected ${t} to be an object.`);return r}}function K(e,t){let r=e[t];if(void 0!==r){if(!Array.isArray(r)||r.some(e=>"string"!=typeof e))throw Error(`Expected ${t} to be an array of strings.`);return r}}function W(){return[{type:"object",properties:{kind:{type:"string",const:"ref"},ref:{type:"string",description:"Snapshot element ref such as @e12."},label:{type:"string",description:"Optional human label for the ref."}},required:["kind","ref"],additionalProperties:!1},{type:"object",properties:{kind:{type:"string",const:"selector"},selector:{type:"string",description:"Agent-device selector expression."}},required:["kind","selector"],additionalProperties:!1}]}function G(e,t){let r=e[t];if(!r||"object"!=typeof r||Array.isArray(r))throw Error(`Expected ${t} to be an object.`);return r}export{N as assertAllowedKeys,u as booleanField,o as booleanSchema,P as commonToClientOptions,L as compactRecord,g as customField,h as elementTargetField,p as enumField,E as fieldsInputSchema,l as integerField,n as integerSchema,y as interactionTargetField,b as jsonSchemaField,f as looseObjectField,s as looseObjectSchema,c as numberField,U as optionalEnum,F as optionalInteger,v as pointField,S as readCommonInput,j as readFieldInput,A as readInputRecord,I as readPoint,x as repeatedFields,q as requiredEnum,a as requiredField,O as requiredNumber,w as selectorSnapshotFields,m as stringArrayField,d as stringField,i as stringSchema,R as toClientElementTarget,M as toClientInteractionTarget,B as toRepeatedOptions,C as toSelectorSnapshotOptions};
@@ -0,0 +1 @@
1
+ import{setSessionSnapshot as e,getSnapshotReferenceFrame as r,captureSnapshot as t,recordTouchVisualizationEvent as n,markAndroidSnapshotFreshness as o,isNavigationSensitiveAction as i}from"./2415.js";import{successText as a}from"./1998.js";import{getAndroidScreenSize as c}from"./input-actions.js";import{emitDiagnostic as s}from"./7599.js";async function d(r,n,o,i,a){let c={...n??{},snapshotInteractiveOnly:a.interactiveOnly,snapshotCompact:a.interactiveOnly},s=i(c,r.appBundleId,r.trace?.outPath),{snapshot:d}=await t({device:r.device,session:r,flags:c,outPath:c.out,logPath:s.logPath??"",androidFreshnessMode:a.androidFreshnessMode});return e(r,d),o.set(r.name,r),d}function f(e){var r,t,n;let o,i,c,{data:s,fallbackX:d,fallbackY:f,referenceFrame:u,extra:l}=e,h=(r=l,t=d,n=f,o="string"==typeof r?.ref?r.ref:void 0,i="string"==typeof r?.button?r.button:void 0,c="string"==typeof r?.gesture?r.gesture:void 0,("string"==typeof r?.text?`Filled ${Array.from(r.text).length} chars`:o?"longpress"===c?`Long pressed @${o} (${t}, ${n})`:i&&"primary"!==i?`Clicked ${i} @${o} (${t}, ${n})`:`Tapped @${o} (${t}, ${n})`:void 0)??("string"==typeof s?.message?s.message:void 0));return{x:d,y:f,...u??{},...l??{},...s??{},...a(h)}}function u(e){let{session:r,sessionStore:t,command:a,positionals:c,flags:s,result:d,responseData:f,actionStartedAt:u,actionFinishedAt:l,androidFreshnessBaseline:h}=e;return t.recordAction(r,{command:a,positionals:c,flags:s??{},result:d}),i(a)&&o(r,a,h??r.snapshot),n(r,a,c,d,s??{},u,l),{ok:!0,data:f}}async function l(e){let{session:t,flags:n,sessionStore:o,contextFromFlags:i,captureSnapshotForSession:a}=e;if(!t.recording)return;if(t.recording.touchReferenceFrame)return t.recording.touchReferenceFrame;if("android"===t.device.platform){let e=await c(t.device),r={referenceWidth:e.width,referenceHeight:e.height};return t.recording&&(t.recording.touchReferenceFrame=r),r}let s=r(t.snapshot);if(s)return t.recording&&(t.recording.touchReferenceFrame=s),s;if(!t.recording)return;let d=r(await a(t,n,o,i,{interactiveOnly:!0}));return d&&t.recording&&(t.recording.touchReferenceFrame=d),d}async function h(e){try{return await l(e)}catch(r){s({level:"warn",phase:"touch_reference_frame_resolve_failed",data:{platform:e.session.device.platform,error:r instanceof Error?r.message:String(r)}});return}}function g(e){return r({nodes:e,createdAt:0})}export{f as buildTouchVisualizationResult,u as finalizeTouchInteraction,d as interaction_snapshot_captureSnapshotForSession,g as readSnapshotNodesReferenceFrame,h as resolveDirectTouchReferenceFrameSafely};