agent-device 0.8.4 → 0.8.5

package/README.md

@@ -14,7 +14,7 @@ The project is in early development and considered experimental. Pull requests a
 
 ## Features
 - Platforms: iOS/tvOS (simulator + physical device core automation) and Android/AndroidTV (emulator + device).
-- Core commands: `open`, `back`, `home`, `app-switcher`, `press`, `long-press`, `focus`, `type`, `fill`, `scroll`, `scrollintoview`, `wait`, `alert`, `screenshot`, `close`, `install`, `reinstall`, `push`, `trigger-app-event`.
+- Core commands: `open`, `back`, `home`, `app-switcher`, `press`, `long-press`, `focus`, `type`, `fill`, `scroll`, `scrollintoview`, `wait`, `alert`, `screenshot`, `close`, `install`, `install-from-source`, `reinstall`, `push`, `trigger-app-event`.
 - Inspection commands: `snapshot` (accessibility tree), `diff snapshot` (structural baseline diff), `appstate`, `apps`, `devices`.
 - Clipboard commands: `clipboard read`, `clipboard write <text>`.
 - Keyboard commands: `keyboard status|get|dismiss` (Android).
@@ -344,8 +344,10 @@ Navigation helpers:
 - Use `boot` mainly when starting a new session and `open` fails because no booted simulator/emulator is available.
 - `open [app|url] [url]` already boots/activates the selected target when needed.
 - `install <app> <path>` installs app binary without uninstalling first (Android + iOS simulator/device).
+- `install-from-source <url>` installs from a URL source through the normal daemon artifact flow; repeat `--header name:value` for authenticated downloads.
 - `reinstall <app> <path>` uninstalls and installs the app binary in one command (Android + iOS simulator/device).
 - `install`/`reinstall` accept package/bundle id style app names and support `~` in paths.
+- `install-from-source` supports `--retain-paths` and `--retention-ms <ms>` when callers need retained materialized artifact paths after the install.
 - When `AGENT_DEVICE_DAEMON_BASE_URL` targets a remote daemon, local `.apk`/`.aab`/`.ipa` files and `.app` bundles are uploaded automatically before `install`/`reinstall`.
 - Remote daemon clients can persist session-scoped runtime hints with `runtime set` before `open`; Android launches write React Native dev prefs, and iOS simulator launches write React Native bundle defaults before app start. Example: `agent-device runtime set --session my-session --platform android --metro-host 10.0.0.10 --metro-port 8081 --launch-url "myapp://dev"`.
 - Remote daemon screenshots and recordings are materialized back to the caller path instead of returning host-local daemon paths.

package/dist/src/224.js

@@ -1,2 +1,2 @@
-import{createRequestId as e,node_path as t,isAgentDeviceDaemonProcess as r,runCmdDetached as a,readVersion as n,findProjectRoot as o,node_https as i,runCmdSync as s,withDiagnosticTimer as d,resolveDaemonTransportPreference as l,emitDiagnostic as u,spawn as c,AppError as p,node_fs as m,resolveDaemonPaths as f,node_net as h,resolveDaemonServerMode as I,stopProcessForTakeover as v,node_http as w}from"./331.js";async function g(e){let{localPath:r,baseUrl:a,token:n}=e,o=m.statSync(r).isDirectory(),s=t.basename(r),d=new URL("upload",a.endsWith("/")?a:`${a}/`),l="https:"===d.protocol?i:w,u={"x-artifact-type":o?"app-bundle":"file","x-artifact-filename":s,"transfer-encoding":"chunked"};return n&&(u.authorization=`Bearer ${n}`,u["x-agent-device-token"]=n),new Promise((e,a)=>{let n=l.request({protocol:d.protocol,host:d.hostname,port:d.port,method:"POST",path:d.pathname+d.search,headers:u},t=>{let r="";t.setEncoding("utf8"),t.on("data",e=>{r+=e}),t.on("end",()=>{clearTimeout(i);try{let t=JSON.parse(r);if(!t.ok||!t.uploadId)return void a(new p("COMMAND_FAILED",`Upload failed: ${r}`));e(t.uploadId)}catch{a(new p("COMMAND_FAILED",`Invalid upload response: ${r}`))}})}),i=setTimeout(()=>{n.destroy(),a(new p("COMMAND_FAILED","Artifact upload timed out",{timeoutMs:3e5,hint:"The upload to the remote daemon exceeded the 5-minute timeout."}))},3e5);if(n.on("error",e=>{clearTimeout(i),a(new p("COMMAND_FAILED","Failed to upload artifact to remote daemon",{hint:"Verify the remote daemon is reachable and supports artifact uploads."},e))}),o){let e=c("tar",["cf","-","-C",t.dirname(r),t.basename(r)],{stdio:["ignore","pipe","pipe"]});e.stdout.pipe(n),e.on("error",e=>{n.destroy(),a(new p("COMMAND_FAILED","Failed to create tar archive for app bundle",{},e))}),e.on("close",e=>{0!==e&&(n.destroy(),a(new p("COMMAND_FAILED",`tar failed with exit code ${e}`)))})}else{let e=m.createReadStream(r);e.pipe(n),e.on("error",e=>{n.destroy(),a(new p("COMMAND_FAILED","Failed to read local artifact",{},e))})}})}let A=function(e=process.env.AGENT_DEVICE_DAEMON_TIMEOUT_MS){if(!e)return 9e4;let t=Number(e);return Number.isFinite(t)?Math.max(1e3,Math.floor(t)):9e4}(),y=function(e=process.env.AGENT_DEVICE_DAEMON_STARTUP_TIMEOUT_MS){if(!e)return 15e3;let t=Number(e);return Number.isFinite(t)?Math.max(1e3,Math.floor(t)):15e3}(),D=function(e=process.env.AGENT_DEVICE_DAEMON_STARTUP_ATTEMPTS){if(!e)return 2;let t=Number(e);return Number.isFinite(t)?Math.min(5,Math.max(1,Math.floor(t))):2}(),_=["xcodebuild .*AgentDeviceRunnerUITests/RunnerTests/testCommand","xcodebuild .*AgentDeviceRunner\\.env\\.session-","xcodebuild build-for-testing .*ios-runner/AgentDeviceRunner/AgentDeviceRunner\\.xcodeproj"];async function b(t){let r=t.meta?.requestId??e(),a=!!(t.meta?.debug||t.flags?.verbose),n=function(e){let t=e.flags?.stateDir??process.env.AGENT_DEVICE_STATE_DIR,r=function(e){let t;if(e){try{t=new URL(e)}catch(t){throw new p("INVALID_ARGS","Invalid daemon base URL",{daemonBaseUrl:e},t instanceof Error?t:void 0)}if("http:"!==t.protocol&&"https:"!==t.protocol)throw new p("INVALID_ARGS","Daemon base URL must use http or https",{daemonBaseUrl:e});return t.toString().replace(/\/+$/,"")}}(e.flags?.daemonBaseUrl??process.env.AGENT_DEVICE_DAEMON_BASE_URL),a=e.flags?.daemonAuthToken??process.env.AGENT_DEVICE_DAEMON_AUTH_TOKEN,n=e.flags?.daemonTransport??process.env.AGENT_DEVICE_DAEMON_TRANSPORT,o=l(n);if(r&&"socket"===o)throw new p("INVALID_ARGS","Remote daemon base URL only supports HTTP transport. Remove --daemon-transport socket.",{daemonBaseUrl:r});let i=I(e.flags?.daemonServerMode??process.env.AGENT_DEVICE_DAEMON_SERVER_MODE??("dual"===n?"dual":void 0));return{paths:f(t),transportPreference:o,serverMode:i,remoteBaseUrl:r,remoteAuthToken:a}}(t),o=await d("daemon_startup",async()=>await T(n),{requestId:r,session:t.session}),i=await P(t,o),s={...t,positionals:i.positionals,flags:i.flags,token:o.token,meta:{...t.meta??{},requestId:r,debug:a,cwd:t.meta?.cwd,tenantId:t.meta?.tenantId??t.flags?.tenant,runId:t.meta?.runId??t.flags?.runId,leaseId:t.meta?.leaseId??t.flags?.leaseId,sessionIsolation:t.meta?.sessionIsolation??t.flags?.sessionIsolation,lockPolicy:t.meta?.lockPolicy,lockPlatform:t.meta?.lockPlatform,...i.uploadedArtifactId?{uploadedArtifactId:i.uploadedArtifactId}:{},...i.clientArtifactPaths?{clientArtifactPaths:i.clientArtifactPaths}:{},...i.installSource?{installSource:i.installSource}:{}}};return u({level:"info",phase:"daemon_request_prepare",data:{requestId:r,command:t.command,session:t.session}}),await d("daemon_request",async()=>await B(o,s,n.transportPreference),{requestId:r,command:t.command})}async function P(e,r){let a,n=[...e.positionals??[]],o=e.flags?{...e.flags}:void 0,i=e.meta?.installSource,s={};if(J(r)){let d=function(e,r){if("screenshot"===e.command){let t=S(e,"path",".png");return r[0]?{field:"path",localPath:t,positionalIndex:0,positionalPath:M("screenshot",".png")}:{field:"path",localPath:t,positionalIndex:0,flagPath:M("screenshot",".png")}}if("record"===e.command&&"start"===(r[0]??"").toLowerCase()){let r=S(e,"outPath",".mp4",1);return{field:"outPath",localPath:r,positionalIndex:1,positionalPath:M("recording",t.extname(r)||".mp4")}}return null}(e,n);d&&(void 0!==d.positionalPath&&(n[d.positionalIndex]=d.positionalPath),void 0!==d.flagPath&&((o??={}).out=d.flagPath),s[d.field]=d.localPath);let l=await E(e,r);l&&(i=l.installSource,a=l.uploadedArtifactId??a)}if(!J(r)||"install"!==e.command&&"reinstall"!==e.command||n.length<2)return{positionals:n,flags:o,installSource:i,uploadedArtifactId:a,...Object.keys(s).length>0?{clientArtifactPaths:s}:{}};let d=n[1];if(d.startsWith("remote:"))return n[1]=d.slice(7),{positionals:n,flags:o,...Object.keys(s).length>0?{clientArtifactPaths:s}:{}};let l=t.isAbsolute(d)?d:t.resolve(e.meta?.cwd??process.cwd(),d);return m.existsSync(l)?{positionals:n,flags:o,installSource:i,uploadedArtifactId:a=await g({localPath:l,baseUrl:r.baseUrl,token:r.token}),...Object.keys(s).length>0?{clientArtifactPaths:s}:{}}:{positionals:n,flags:o,...Object.keys(s).length>0?{clientArtifactPaths:s}:{}}}async function E(e,r){let a=e.meta?.installSource;if("install_source"!==e.command||!a||"path"!==a.kind)return null;let n=a.path.trim();if(!n)return{installSource:a};if(n.startsWith("remote:"))return{installSource:{...a,path:n.slice(7)}};let o=t.isAbsolute(n)?n:t.resolve(e.meta?.cwd??process.cwd(),n);if(!m.existsSync(o))return{installSource:{...a,path:o}};let i=await g({localPath:o,baseUrl:r.baseUrl,token:r.token});return{installSource:{...a,path:o},uploadedArtifactId:i}}function S(e,r,a,n=0){let o=e.positionals?.[n]??e.flags?.out,i=`${"path"===r?"screenshot":"recording"}-${Date.now()}${a}`,s=o&&o.trim().length>0?o:i;return t.isAbsolute(s)?s:t.resolve(e.meta?.cwd??process.cwd(),s)}function M(e,r){let a=r.startsWith(".")?r:`.${r}`;return t.posix.join("/tmp",`agent-device-${e}-${Date.now()}-${Math.random().toString(36).slice(2,8)}${a}`)}async function T(e){let a;if(e.remoteBaseUrl){let t={transport:"http",token:e.remoteAuthToken??"",pid:0,baseUrl:e.remoteBaseUrl};if(await x(t,"http"))return t;throw new p("COMMAND_FAILED","Remote daemon is unavailable",{daemonBaseUrl:e.remoteBaseUrl,hint:"Verify AGENT_DEVICE_DAEMON_BASE_URL points to a reachable daemon with GET /health and POST /rpc."})}let i=U(e.paths.infoPath),s=n(),d=function(e,r=o()){try{let a=m.statSync(e),n=t.relative(r,e)||e;return`${n}:${a.size}:${Math.trunc(a.mtimeMs)}`}catch{return"unknown"}}((a=z()).useSrc?a.srcPath:a.distPath,a.root),l=!!i&&await x(i,e.transportPreference);if(i&&i.version===s&&i.codeSignature===d&&l)return i;i&&(i.version!==s||i.codeSignature!==d||!l)&&(await O(i),F(e.paths.infoPath)),function(e){let t=L(e);if(!t.hasLock||t.hasInfo)return;let a=C(e.lockPath);if(!a)return F(e.lockPath);r(a.pid,a.processStartTime)||F(e.lockPath)}(e.paths);let u=0;for(let t=1;t<=D;t+=1){await $(e);let r=await N(y,e);if(r)return r;if(await R(e.paths)){u+=1;continue}let a=L(e.paths);if(!(t<D))break;if(!a.hasInfo&&!a.hasLock){await k(150);continue}}let c=L(e.paths);throw new p("COMMAND_FAILED","Failed to start daemon",{kind:"daemon_startup_failed",infoPath:e.paths.infoPath,lockPath:e.paths.lockPath,startupTimeoutMs:y,startupAttempts:D,lockRecoveryCount:u,metadataState:c,hint:function(e,t=f(process.env.AGENT_DEVICE_STATE_DIR)){return e.hasLock&&!e.hasInfo?`Detected ${t.lockPath} without ${t.infoPath}. If no agent-device daemon process is running, delete ${t.lockPath} and retry.`:e.hasLock&&e.hasInfo?`Daemon metadata may be stale. If no agent-device daemon process is running, delete ${t.infoPath} and ${t.lockPath}, then retry.`:`Daemon metadata is missing or stale. Delete ${t.infoPath} if present and retry.`}(c,e.paths)})}async function N(e,t){let r=Date.now();for(;Date.now()-r<e;){let e=U(t.paths.infoPath);if(e&&await x(e,t.transportPreference))return e;await new Promise(e=>setTimeout(e,100))}return null}async function k(e){await new Promise(t=>setTimeout(t,e))}async function R(e){let t=L(e);if(!t.hasLock||t.hasInfo)return!1;let a=C(e.lockPath);return a&&r(a.pid,a.processStartTime)&&await v(a.pid,{termTimeoutMs:3e3,killTimeoutMs:1e3,expectedStartTime:a.processStartTime}),F(e.lockPath),!0}async function O(e){await v(e.pid,{termTimeoutMs:3e3,killTimeoutMs:1e3,expectedStartTime:e.processStartTime})}function U(e){let t=q(e);if(!t||"object"!=typeof t)return null;let r="string"==typeof t.token&&t.token.length>0?t.token:null;if(!r)return null;let a=Number.isInteger(t.port)&&Number(t.port)>0,n=Number.isInteger(t.httpPort)&&Number(t.httpPort)>0;if(!a&&!n)return null;let o=t.transport,i="string"==typeof t.version?t.version:void 0,s="string"==typeof t.codeSignature?t.codeSignature:void 0,d="string"==typeof t.processStartTime?t.processStartTime:void 0,l=Number.isInteger(t.pid)&&Number(t.pid)>0;return{token:r,port:a?Number(t.port):void 0,httpPort:n?Number(t.httpPort):void 0,transport:"socket"===o||"http"===o||"dual"===o?o:void 0,pid:l?Number(t.pid):0,version:i,codeSignature:s,processStartTime:d}}function C(e){let t=q(e);return t&&"object"==typeof t&&Number.isInteger(t.pid)&&Number(t.pid)>0?{pid:Number(t.pid),processStartTime:"string"==typeof t.processStartTime?t.processStartTime:void 0,startedAt:"number"==typeof t.startedAt?t.startedAt:void 0}:null}function L(e){return{hasInfo:m.existsSync(e.infoPath),hasLock:m.existsSync(e.lockPath)}}function q(e){if(!m.existsSync(e))return null;try{return JSON.parse(m.readFileSync(e,"utf8"))}catch{return null}}function F(e){try{m.existsSync(e)&&m.unlinkSync(e)}catch{}}async function x(e,t){var r;return"http"===G(e,t)?await function(e){let t=e.baseUrl?Q(e.baseUrl,"health"):e.httpPort?`http://127.0.0.1:${e.httpPort}/health`:null;if(!t)return Promise.resolve(!1);let r=new URL(t),a="https:"===r.protocol?i:w,n=e.baseUrl?3e3:500;return new Promise(e=>{let t=a.request({protocol:r.protocol,host:r.hostname,port:r.port,path:r.pathname+r.search,method:"GET",timeout:n},t=>{t.resume(),e((t.statusCode??500)<500)});t.on("timeout",()=>{t.destroy(),e(!1)}),t.on("error",()=>{e(!1)}),t.end()})}(e):await ((r=e.port)?new Promise(e=>{let t=h.createConnection({host:"127.0.0.1",port:r},()=>{t.destroy(),e(!0)});t.on("error",()=>{e(!1)})}):Promise.resolve(!1))}async function $(e){let t=z(),r=t.useSrc?["--experimental-strip-types",t.srcPath]:[t.distPath],n={...process.env,AGENT_DEVICE_STATE_DIR:e.paths.baseDir,AGENT_DEVICE_DAEMON_SERVER_MODE:e.serverMode};a(process.execPath,r,{env:n})}function z(){let e=o(),r=t.join(e,"dist","src","daemon.js"),a=t.join(e,"src","daemon.ts"),n=m.existsSync(r),i=m.existsSync(a);if(!n&&!i)throw new p("COMMAND_FAILED","Daemon entry not found",{distPath:r,srcPath:a});return{root:e,distPath:r,srcPath:a,useSrc:process.execArgv.includes("--experimental-strip-types")?i:!n&&i}}async function B(e,t,r){return"http"===G(e,r)?await H(e,t):await j(e,t)}function G(e,t){if(e.baseUrl){if("socket"===t)throw new p("COMMAND_FAILED","Remote daemon endpoint only supports HTTP transport",{daemonBaseUrl:e.baseUrl});return"http"}if("http"===t||"socket"===t){var r=e,a=t;if(V(r,a))return a;throw new p("COMMAND_FAILED","http"===a?"Daemon HTTP endpoint is unavailable":"Daemon socket endpoint is unavailable")}let n=("socket"===e.transport||"dual"===e.transport?["socket","http"]:["http","socket"]).find(t=>V(e,t));if(n)return n;throw new p("COMMAND_FAILED","Daemon metadata has no reachable transport")}function V(e,t){return"http"===t?!!e.httpPort:!!e.port}async function j(e,t){let r=e.port;if(!r)throw new p("COMMAND_FAILED","Daemon socket endpoint is unavailable");return new Promise((a,n)=>{let o=h.createConnection({host:"127.0.0.1",port:r},()=>{o.write(`${JSON.stringify(t)}
-`)}),i=setTimeout(()=>{o.destroy();let r=K(),a=W(e,f(t.flags?.stateDir??process.env.AGENT_DEVICE_STATE_DIR));u({level:"error",phase:"daemon_request_timeout",data:{timeoutMs:A,requestId:t.meta?.requestId,command:t.command,timedOutRunnerPidsTerminated:r.terminated,timedOutRunnerCleanupError:r.error,daemonPidReset:e.pid,daemonPidForceKilled:a.forcedKill}}),n(new p("COMMAND_FAILED","Daemon request timed out",{timeoutMs:A,requestId:t.meta?.requestId,hint:"Retry with --debug and check daemon diagnostics logs. Timed-out iOS runner xcodebuild processes were terminated when detected."}))},A),s="";o.setEncoding("utf8"),o.on("data",e=>{let r=(s+=e).indexOf("\n");if(-1===r)return;let d=s.slice(0,r).trim();if(d)try{let e=JSON.parse(d);o.end(),clearTimeout(i),a(e)}catch(e){clearTimeout(i),n(new p("COMMAND_FAILED","Invalid daemon response",{requestId:t.meta?.requestId,line:d},e instanceof Error?e:void 0))}}),o.on("error",e=>{clearTimeout(i),u({level:"error",phase:"daemon_request_socket_error",data:{requestId:t.meta?.requestId,message:e instanceof Error?e.message:String(e)}}),n(new p("COMMAND_FAILED","Failed to communicate with daemon",{requestId:t.meta?.requestId,hint:"Retry command. If this persists, clean stale daemon metadata and start a fresh session."},e))})})}async function H(t,r){let a=t.baseUrl?new URL(Q(t.baseUrl,"rpc")):t.httpPort?new URL(`http://127.0.0.1:${t.httpPort}/rpc`):null;if(!a)throw new p("COMMAND_FAILED","Daemon HTTP endpoint is unavailable");let n=JSON.stringify({jsonrpc:"2.0",id:r.meta?.requestId??e(),method:"agent_device.command",params:r}),o={"content-type":"application/json","content-length":Buffer.byteLength(n)};return t.baseUrl&&t.token&&(o.authorization=`Bearer ${t.token}`,o["x-agent-device-token"]=t.token),await new Promise((e,s)=>{let d=f(r.flags?.stateDir??process.env.AGENT_DEVICE_STATE_DIR),l=("https:"===a.protocol?i:w).request({protocol:a.protocol,host:a.hostname,port:a.port,method:"POST",path:a.pathname+a.search,headers:o},a=>{let n="";a.setEncoding("utf8"),a.on("data",e=>{n+=e}),a.on("end",()=>{clearTimeout(c);try{let a=JSON.parse(n);if(a.error){let e=a.error.data??{};s(new p(String(e.code??"COMMAND_FAILED"),String(e.message??a.error.message??"Daemon RPC request failed"),{..."object"==typeof e.details&&e.details?e.details:{},hint:"string"==typeof e.hint?e.hint:void 0,diagnosticId:"string"==typeof e.diagnosticId?e.diagnosticId:void 0,logPath:"string"==typeof e.logPath?e.logPath:void 0,requestId:r.meta?.requestId}));return}if(!a.result||"object"!=typeof a.result)return void s(new p("COMMAND_FAILED","Invalid daemon RPC response",{requestId:r.meta?.requestId}));if(t.baseUrl&&a.result.ok)return void X(t,r,a.result).then(e).catch(s);e(a.result)}catch(e){clearTimeout(c),s(new p("COMMAND_FAILED","Invalid daemon response",{requestId:r.meta?.requestId,line:n},e instanceof Error?e:void 0))}})}),c=setTimeout(()=>{l.destroy();let e=J(t)?{terminated:0}:K(),a=J(t)?{forcedKill:!1}:W(t,d);u({level:"error",phase:"daemon_request_timeout",data:{timeoutMs:A,requestId:r.meta?.requestId,command:r.command,timedOutRunnerPidsTerminated:e.terminated,timedOutRunnerCleanupError:e.error,daemonPidReset:J(t)?void 0:t.pid,daemonPidForceKilled:J(t)?void 0:a.forcedKill,daemonBaseUrl:t.baseUrl}}),s(new p("COMMAND_FAILED","Daemon request timed out",{timeoutMs:A,requestId:r.meta?.requestId,hint:J(t)?"Retry with --debug and verify the remote daemon URL, auth token, and remote host logs.":"Retry with --debug and check daemon diagnostics logs. Timed-out iOS runner xcodebuild processes were terminated when detected."}))},A);l.on("error",e=>{clearTimeout(c),u({level:"error",phase:"daemon_request_socket_error",data:{requestId:r.meta?.requestId,message:e instanceof Error?e.message:String(e)}}),s(new p("COMMAND_FAILED","Failed to communicate with daemon",{requestId:r.meta?.requestId,hint:J(t)?"Retry command. If this persists, verify the remote daemon URL, auth token, and remote host reachability.":"Retry command. If this persists, clean stale daemon metadata and start a fresh session."},e))}),l.write(n),l.end()})}function K(){let e=0;try{for(let t of _){let r=s("pkill",["-f",t],{allowFailure:!0});0===r.exitCode&&(e+=1)}return{terminated:e}}catch(t){return{terminated:e,error:t instanceof Error?t.message:String(t)}}}function W(e,t){let a=!1;try{r(e.pid,e.processStartTime)&&(process.kill(e.pid,"SIGKILL"),a=!0)}catch{v(e.pid,{termTimeoutMs:3e3,killTimeoutMs:1e3,expectedStartTime:e.processStartTime})}finally{F(t.infoPath),F(t.lockPath)}return{forcedKill:a}}function J(e){return"string"==typeof e.baseUrl&&e.baseUrl.length>0}function Q(e,t){return new URL(t,e.endsWith("/")?e:`${e}/`).toString()}async function X(e,r,a){let n=Array.isArray(a.data?.artifacts)?a.data.artifacts:[];if(0===n.length||!e.baseUrl)return a;let o=a.data?{...a.data}:{},i=[];for(let a of n){if(!a||"object"!=typeof a||"string"!=typeof a.artifactId){i.push(a);continue}let n=function(e,r){if(e.localPath&&e.localPath.trim().length>0)return e.localPath;let a=e.fileName?.trim()||`${e.field}-${Date.now()}`;return t.resolve(r.meta?.cwd??process.cwd(),a)}(a,r);await Y({baseUrl:e.baseUrl,token:e.token,artifactId:a.artifactId,destinationPath:n,requestId:r.meta?.requestId}),o[a.field]=n,i.push({...a,localPath:n})}return o.artifacts=i,{ok:!0,data:o}}async function Y(e){var r,a;let n,o=new URL((r=e.baseUrl,a=e.artifactId,n=r.endsWith("/")?r:`${r}/`,new URL(`upload/${encodeURIComponent(a)}`,n).toString())),s="https:"===o.protocol?i:w;await m.promises.mkdir(t.dirname(e.destinationPath),{recursive:!0}),await new Promise((t,r)=>{let a=!1,n=e.timeoutMs??A,i=n=>{if(!a){if(a=!0,clearTimeout(l),n)return void m.promises.rm(e.destinationPath,{force:!0}).finally(()=>r(n));t()}},d=s.request({protocol:o.protocol,host:o.hostname,port:o.port,method:"GET",path:o.pathname+o.search,headers:e.token?{authorization:`Bearer ${e.token}`,"x-agent-device-token":e.token}:void 0},t=>{if((t.statusCode??500)>=400){let r="";t.setEncoding("utf8"),t.on("data",e=>{r+=e}),t.on("end",()=>{i(new p("COMMAND_FAILED","Failed to download remote artifact",{artifactId:e.artifactId,statusCode:t.statusCode,requestId:e.requestId,body:r}))});return}let r=m.createWriteStream(e.destinationPath);r.on("error",e=>{i(e instanceof Error?e:Error(String(e)))}),t.on("error",e=>{i(e instanceof Error?e:Error(String(e)))}),t.on("aborted",()=>{i(new p("COMMAND_FAILED","Remote artifact download was interrupted",{artifactId:e.artifactId,requestId:e.requestId}))}),r.on("finish",()=>{r.close(()=>i())}),t.pipe(r)}),l=setTimeout(()=>{d.destroy(new p("COMMAND_FAILED","Remote artifact download timed out",{artifactId:e.artifactId,requestId:e.requestId,timeoutMs:n}))},n);d.on("error",t=>{t instanceof p?i(t):i(new p("COMMAND_FAILED","Failed to download remote artifact",{artifactId:e.artifactId,requestId:e.requestId,timeoutMs:n},t instanceof Error?t:void 0))}),d.end()})}function Z(e){let t=e.appId??e.bundleId??e.packageName;return{session:e.session,appId:t,appBundleId:e.bundleId,package:e.packageName}}function ee(e,t,r){return{deviceId:t,deviceName:r,..."ios"===e?{udid:t}:{serial:t}}}function et(e,t={}){let r=t.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&&r?{serial:e.android?.serial??e.id}:{}}}function er(e){return{name:e.name,...et(e.device,{includeAndroidSerial:!1}),createdAt:e.createdAt}}function ea(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 en(e){return{udid:e.udid,device:e.device,runtime:e.runtime,ios_simulator_device_set:e.iosSimulatorDeviceSet??null,created:e.created,booted:e.booted}}function eo(e){return{session:e.session,configured:e.configured,...e.cleared?{cleared:!0}:{},...e.runtime?{runtime:e.runtime}:{}}}function ei(e){return{app:e.app,appPath:e.appPath,platform:e.platform,...e.appId?{appId:e.appId}:{},...e.bundleId?{bundleId:e.bundleId}:{},...e.package?{package:e.package}:{}}}function es(e){return{session:e.session,...e.appName?{appName:e.appName}:{},...e.appBundleId?{appBundleId:e.appBundleId}:{},...e.startup?{startup:e.startup}:{},...e.runtime?{runtime:e.runtime}:{},...e.device?et(e.device):{}}}function ed(e){return{session:e.session,...e.shutdown?{shutdown:e.shutdown}:{}}}function el(e){return{nodes:e.nodes,truncated:e.truncated,...e.appName?{appName:e.appName}:{},...e.appBundleId?{appBundleId:e.appBundleId}:{}}}function eu(e,t){let r=eA(e,"bundleId"),a=eA(e,"package");return{app:eg(e,"app"),appPath:eg(e,"appPath"),platform:ey(e,"platform"),appId:r??a,bundleId:r,package:a,identifiers:Z({session:t,bundleId:r,packageName:a})}}function ec(e,t){return{session:t,configured:!0===e.configured,cleared:!0===e.cleared||void 0,runtime:ef(e.runtime),identifiers:{session:t}}}function ep(e){var t;let r=ev(e),a=ey(r,"platform"),n=eg(r,"id"),o=eg(r,"name");return{platform:a,target:eD(r,"target"),kind:e_(r,t="kind",eM,`Daemon response has invalid "${t}".`),id:n,name:o,booted:"boolean"==typeof r.booted?r.booted:void 0,identifiers:ee(a,n,o),ios:"ios"===a?{udid:n}:void 0,android:"android"===a?{serial:n}:void 0}}function em(e){var t;let r=ev(e),a=ey(r,"platform"),n=eg(r,"id"),o=eg(r,"name"),i=eD(r,"target"),s=eg(r,"device"),d={session:o,...ee(a,n,s)};return{name:o,createdAt:e_(r,t="createdAt",eE,`Daemon response is missing numeric "${t}".`),device:{platform:a,target:i,id:n,name:s,identifiers:d,ios:"ios"===a?{udid:n,simulatorSetPath:eb(r,"ios_simulator_device_set",eP)}:void 0,android:"android"===a?{serial:n}:void 0},identifiers:d}}function ef(e){if(!ew(e))return;let t=e.platform,r=eA(e,"metroHost"),a="number"==typeof e.metroPort?e.metroPort:void 0;return{platform:"ios"===t||"android"===t?t:void 0,metroHost:r,metroPort:a,bundleUrl:eA(e,"bundleUrl"),launchUrl:eA(e,"launchUrl")}}function eh(e,t){return t??e??"default"}function eI(e){let t={};for(let[r,a]of Object.entries(e))void 0!==a&&(t[r]=a);return t}function ev(e){if(!ew(e))throw new p("COMMAND_FAILED","Daemon returned an unexpected response shape.",{value:e});return e}function ew(e){return"object"==typeof e&&null!==e}function eg(e,t){return e_(e,t,eP,`Daemon response is missing "${t}".`)}function eA(e,t){return eP(e[t])}function ey(e,t){return e_(e,t,eS,`Daemon response has invalid "${t}".`)}function eD(e,t){return eT(e[t])??"mobile"}function e_(e,t,r,a){let n=r(e[t]);if(void 0===n)throw new p("COMMAND_FAILED",a,{response:e});return n}function eb(e,t,r){let a=e[t];return null===a?null:r(a)}function eP(e){return"string"==typeof e&&e.length>0?e:void 0}function eE(e){return"number"==typeof e&&Number.isFinite(e)?e:void 0}function eS(e){return"ios"===e||"android"===e?e:void 0}function eM(e){return"simulator"===e||"emulator"===e||"device"===e?e:void 0}function eT(e){return"tv"===e?"tv":"mobile"===e?"mobile":void 0}function eN(e={},t={}){let r=t.transport??b,a=async(t,a=[],n={})=>{let o={...e,...n},i=await r({session:eh(e.session,n.session),command:t,positionals:a,flags:eI({stateDir:o.stateDir,daemonBaseUrl:o.daemonBaseUrl,daemonAuthToken:o.daemonAuthToken,daemonTransport:o.daemonTransport,daemonServerMode:o.daemonServerMode,tenant:o.tenant,sessionIsolation:o.sessionIsolation,runId:o.runId,leaseId:o.leaseId,platform:o.platform,target:o.target,device:o.device,udid:o.udid,serial:o.serial,iosSimulatorDeviceSet:o.iosSimulatorDeviceSet,androidDeviceAllowlist:o.androidDeviceAllowlist,runtime:o.simulatorRuntimeId,boot:o.boot,reuseExisting:o.reuseExisting,activity:o.activity,relaunch:o.relaunch,shutdown:o.shutdown,saveScript:o.saveScript,noRecord:o.noRecord,metroHost:o.metroHost,metroPort:o.metroPort,bundleUrl:o.bundleUrl,launchUrl:o.launchUrl,snapshotInteractiveOnly:o.interactiveOnly,snapshotCompact:o.compact,snapshotDepth:o.depth,snapshotScope:o.scope,snapshotRaw:o.raw,verbose:o.debug}),runtime:o.runtime,meta:eI({requestId:o.requestId,cwd:o.cwd,debug:o.debug,lockPolicy:o.lockPolicy,lockPlatform:o.lockPlatform,tenantId:o.tenant,runId:o.runId,leaseId:o.leaseId,sessionIsolation:o.sessionIsolation,installSource:o.installSource,retainMaterializedPaths:o.retainMaterializedPaths,materializedPathRetentionMs:o.materializedPathRetentionMs,materializationId:o.materializationId})});if(!i.ok)throw new p(i.error.code,i.error.message,{...i.error.details??{},hint:i.error.hint,diagnosticId:i.error.diagnosticId,logPath:i.error.logPath});return i.data??{}},n=async(e={})=>{let t=await a("session_list",[],e);return(Array.isArray(t.sessions)?t.sessions:[]).map(em)};return{devices:{list:async(e={})=>{let t=await a("devices",[],e);return(Array.isArray(t.devices)?t.devices:[]).map(ep)}},sessions:{list:async(e={})=>await n(e),close:async(t={})=>{let r=eh(e.session,t.session),n=(await a("close",[],t)).shutdown;return{session:r,shutdown:"object"==typeof n&&null!==n?n:void 0,identifiers:{session:r}}}},simulators:{ensure:async e=>{let{runtime:t,...r}=e,n=await a("ensure-simulator",[],{...r,simulatorRuntimeId:t}),o=eg(n,"udid"),i=eg(n,"device");return{udid:o,device:i,runtime:eg(n,"runtime"),created:!0===n.created,booted:!0===n.booted,iosSimulatorDeviceSet:eb(n,"ios_simulator_device_set",eP),identifiers:{deviceId:o,deviceName:i,udid:o}}}},apps:{install:async t=>eu(await a("install",[t.app,t.appPath],t),eh(e.session,t.session)),reinstall:async t=>eu(await a("reinstall",[t.app,t.appPath],t),eh(e.session,t.session)),installFromSource:async t=>(function(e,t){let r=eA(e,"bundleId"),a=eA(e,"packageName"),n=r??a??eA(e,"appId"),o=eA(e,"launchTarget")??a??r??n;if(!o)throw new p("COMMAND_FAILED",'Daemon response is missing "launchTarget".',{response:e});return{appName:eA(e,"appName"),appId:n,bundleId:r,packageName:a,launchTarget:o,installablePath:eA(e,"installablePath"),archivePath:eA(e,"archivePath"),materializationId:eA(e,"materializationId"),materializationExpiresAt:eA(e,"materializationExpiresAt"),identifiers:Z({session:t,bundleId:r,packageName:a,appId:n})}})(await a("install_source",[],{...t,installSource:t.source,retainMaterializedPaths:t.retainPaths,materializedPathRetentionMs:t.retentionMs}),eh(e.session,t.session)),open:async t=>{let r=eh(e.session,t.session),n=t.url?[t.app,t.url]:[t.app],o=await a("open",n,t),i=function(e){let t=e.platform,r=eA(e,"id"),a=eA(e,"device");if("ios"!==t&&"android"!==t||!r||!a)return;let n=eD(e,"target"),o=ee(t,r,a);return{platform:t,target:n,id:r,name:a,identifiers:o,ios:"ios"===t?{udid:eA(e,"device_udid")??r,simulatorSetPath:eb(e,"ios_simulator_device_set",eP)}:void 0,android:"android"===t?{serial:eA(e,"serial")??r}:void 0}}(o),s=eA(o,"appBundleId");return{session:r,appName:eA(o,"appName"),appBundleId:s,appId:s,startup:function(e){if(ew(e)&&"number"==typeof e.durationMs&&"string"==typeof e.measuredAt&&"string"==typeof e.method)return{durationMs:e.durationMs,measuredAt:e.measuredAt,method:e.method,appTarget:eA(e,"appTarget"),appBundleId:eA(e,"appBundleId")}}(o.startup),runtime:ef(o.runtime),device:i,identifiers:{session:r,deviceId:i?.id,deviceName:i?.name,udid:i?.ios?.udid,serial:i?.android?.serial,appId:s,appBundleId:s}}},close:async(t={})=>{let r=eh(e.session,t.session),n=(await a("close",t.app?[t.app]:[],t)).shutdown;return{session:r,closedApp:t.app,shutdown:"object"==typeof n&&null!==n?n:void 0,identifiers:{session:r}}}},materializations:{release:async e=>{var t;return{released:!0===(t=await a("release_materialized_paths",[],{...e,materializationId:e.materializationId})).released,materializationId:eg(t,"materializationId"),identifiers:{}}}},runtime:{set:async t=>ec(await a("runtime",["set"],t),eh(e.session,t.session)),show:async(t={})=>ec(await a("runtime",["show"],t),eh(e.session,t.session))},capture:{snapshot:async(t={})=>{var r;let n=eh(e.session,t.session),o=await a("snapshot",[],t),i=eA(o,"appBundleId");return{nodes:Array.isArray(r=o.nodes)?r:[],truncated:!0===o.truncated,appName:eA(o,"appName"),appBundleId:i,identifiers:{session:n,appId:i,appBundleId:i}}},screenshot:async(t={})=>{let r=eh(e.session,t.session);return{path:eg(await a("screenshot",t.path?[t.path]:[],t),"path"),identifiers:{session:r}}}}}}export{eN as createAgentDeviceClient,b as sendToDaemon,ed as serializeCloseResult,ei as serializeDeployResult,ea as serializeDevice,en as serializeEnsureSimulatorResult,es as serializeOpenResult,eo as serializeRuntimeResult,er as serializeSessionListEntry,el as serializeSnapshotResult};
+import{createRequestId as e,node_path as t,isAgentDeviceDaemonProcess as a,runCmdDetached as r,readVersion as n,findProjectRoot as o,node_https as i,runCmdSync as s,withDiagnosticTimer as d,resolveDaemonTransportPreference as l,emitDiagnostic as u,spawn as c,AppError as p,node_fs as m,resolveDaemonPaths as f,node_net as h,resolveDaemonServerMode as I,stopProcessForTakeover as v,node_http as g}from"./331.js";async function w(e){let{localPath:a,baseUrl:r,token:n}=e,o=m.statSync(a).isDirectory(),s=t.basename(a),d=new URL("upload",r.endsWith("/")?r:`${r}/`),l="https:"===d.protocol?i:g,u={"x-artifact-type":o?"app-bundle":"file","x-artifact-filename":s,"transfer-encoding":"chunked"};return n&&(u.authorization=`Bearer ${n}`,u["x-agent-device-token"]=n),new Promise((e,r)=>{let n=l.request({protocol:d.protocol,host:d.hostname,port:d.port,method:"POST",path:d.pathname+d.search,headers:u},t=>{let a="";t.setEncoding("utf8"),t.on("data",e=>{a+=e}),t.on("end",()=>{clearTimeout(i);try{let t=JSON.parse(a);if(!t.ok||!t.uploadId)return void r(new p("COMMAND_FAILED",`Upload failed: ${a}`));e(t.uploadId)}catch{r(new p("COMMAND_FAILED",`Invalid upload response: ${a}`))}})}),i=setTimeout(()=>{n.destroy(),r(new p("COMMAND_FAILED","Artifact upload timed out",{timeoutMs:3e5,hint:"The upload to the remote daemon exceeded the 5-minute timeout."}))},3e5);if(n.on("error",e=>{clearTimeout(i),r(new p("COMMAND_FAILED","Failed to upload artifact to remote daemon",{hint:"Verify the remote daemon is reachable and supports artifact uploads."},e))}),o){let e=c("tar",["cf","-","-C",t.dirname(a),t.basename(a)],{stdio:["ignore","pipe","pipe"]});e.stdout.pipe(n),e.on("error",e=>{n.destroy(),r(new p("COMMAND_FAILED","Failed to create tar archive for app bundle",{},e))}),e.on("close",e=>{0!==e&&(n.destroy(),r(new p("COMMAND_FAILED",`tar failed with exit code ${e}`)))})}else{let e=m.createReadStream(a);e.pipe(n),e.on("error",e=>{n.destroy(),r(new p("COMMAND_FAILED","Failed to read local artifact",{},e))})}})}let A=function(e=process.env.AGENT_DEVICE_DAEMON_TIMEOUT_MS){if(!e)return 9e4;let t=Number(e);return Number.isFinite(t)?Math.max(1e3,Math.floor(t)):9e4}(),y=function(e=process.env.AGENT_DEVICE_DAEMON_STARTUP_TIMEOUT_MS){if(!e)return 15e3;let t=Number(e);return Number.isFinite(t)?Math.max(1e3,Math.floor(t)):15e3}(),D=function(e=process.env.AGENT_DEVICE_DAEMON_STARTUP_ATTEMPTS){if(!e)return 2;let t=Number(e);return Number.isFinite(t)?Math.min(5,Math.max(1,Math.floor(t))):2}(),b=["xcodebuild .*AgentDeviceRunnerUITests/RunnerTests/testCommand","xcodebuild .*AgentDeviceRunner\\.env\\.session-","xcodebuild build-for-testing .*ios-runner/AgentDeviceRunner/AgentDeviceRunner\\.xcodeproj"];async function P(t){let a=t.meta?.requestId??e(),r=!!(t.meta?.debug||t.flags?.verbose),n=function(e){let t=e.flags?.stateDir??process.env.AGENT_DEVICE_STATE_DIR,a=function(e){let t;if(e){try{t=new URL(e)}catch(t){throw new p("INVALID_ARGS","Invalid daemon base URL",{daemonBaseUrl:e},t instanceof Error?t:void 0)}if("http:"!==t.protocol&&"https:"!==t.protocol)throw new p("INVALID_ARGS","Daemon base URL must use http or https",{daemonBaseUrl:e});return t.toString().replace(/\/+$/,"")}}(e.flags?.daemonBaseUrl??process.env.AGENT_DEVICE_DAEMON_BASE_URL),r=e.flags?.daemonAuthToken??process.env.AGENT_DEVICE_DAEMON_AUTH_TOKEN,n=e.flags?.daemonTransport??process.env.AGENT_DEVICE_DAEMON_TRANSPORT,o=l(n);if(a&&"socket"===o)throw new p("INVALID_ARGS","Remote daemon base URL only supports HTTP transport. Remove --daemon-transport socket.",{daemonBaseUrl:a});let i=I(e.flags?.daemonServerMode??process.env.AGENT_DEVICE_DAEMON_SERVER_MODE??("dual"===n?"dual":void 0));return{paths:f(t),transportPreference:o,serverMode:i,remoteBaseUrl:a,remoteAuthToken:r}}(t),o=await d("daemon_startup",async()=>await T(n),{requestId:a,session:t.session}),i=await E(t,o),s={...t,positionals:i.positionals,flags:i.flags,token:o.token,meta:{...t.meta??{},requestId:a,debug:r,cwd:t.meta?.cwd,tenantId:t.meta?.tenantId??t.flags?.tenant,runId:t.meta?.runId??t.flags?.runId,leaseId:t.meta?.leaseId??t.flags?.leaseId,sessionIsolation:t.meta?.sessionIsolation??t.flags?.sessionIsolation,lockPolicy:t.meta?.lockPolicy,lockPlatform:t.meta?.lockPlatform,...i.uploadedArtifactId?{uploadedArtifactId:i.uploadedArtifactId}:{},...i.clientArtifactPaths?{clientArtifactPaths:i.clientArtifactPaths}:{},...i.installSource?{installSource:i.installSource}:{}}};return u({level:"info",phase:"daemon_request_prepare",data:{requestId:a,command:t.command,session:t.session}}),await d("daemon_request",async()=>await B(o,s,n.transportPreference),{requestId:a,command:t.command})}async function E(e,a){let r,n=[...e.positionals??[]],o=e.flags?{...e.flags}:void 0,i=e.meta?.installSource,s={};if(J(a)){let d=function(e,a){if("screenshot"===e.command){let t=S(e,"path",".png");return a[0]?{field:"path",localPath:t,positionalIndex:0,positionalPath:M("screenshot",".png")}:{field:"path",localPath:t,positionalIndex:0,flagPath:M("screenshot",".png")}}if("record"===e.command&&"start"===(a[0]??"").toLowerCase()){let a=S(e,"outPath",".mp4",1);return{field:"outPath",localPath:a,positionalIndex:1,positionalPath:M("recording",t.extname(a)||".mp4")}}return null}(e,n);d&&(void 0!==d.positionalPath&&(n[d.positionalIndex]=d.positionalPath),void 0!==d.flagPath&&((o??={}).out=d.flagPath),s[d.field]=d.localPath);let l=await _(e,a);l&&(i=l.installSource,r=l.uploadedArtifactId??r)}if(!J(a)||"install"!==e.command&&"reinstall"!==e.command||n.length<2)return{positionals:n,flags:o,installSource:i,uploadedArtifactId:r,...Object.keys(s).length>0?{clientArtifactPaths:s}:{}};let d=n[1];if(d.startsWith("remote:"))return n[1]=d.slice(7),{positionals:n,flags:o,...Object.keys(s).length>0?{clientArtifactPaths:s}:{}};let l=t.isAbsolute(d)?d:t.resolve(e.meta?.cwd??process.cwd(),d);return m.existsSync(l)?{positionals:n,flags:o,installSource:i,uploadedArtifactId:r=await w({localPath:l,baseUrl:a.baseUrl,token:a.token}),...Object.keys(s).length>0?{clientArtifactPaths:s}:{}}:{positionals:n,flags:o,...Object.keys(s).length>0?{clientArtifactPaths:s}:{}}}async function _(e,a){let r=e.meta?.installSource;if("install_source"!==e.command||!r||"path"!==r.kind)return null;let n=r.path.trim();if(!n)return{installSource:r};if(n.startsWith("remote:"))return{installSource:{...r,path:n.slice(7)}};let o=t.isAbsolute(n)?n:t.resolve(e.meta?.cwd??process.cwd(),n);if(!m.existsSync(o))return{installSource:{...r,path:o}};let i=await w({localPath:o,baseUrl:a.baseUrl,token:a.token});return{installSource:{...r,path:o},uploadedArtifactId:i}}function S(e,a,r,n=0){let o=e.positionals?.[n]??e.flags?.out,i=`${"path"===a?"screenshot":"recording"}-${Date.now()}${r}`,s=o&&o.trim().length>0?o:i;return t.isAbsolute(s)?s:t.resolve(e.meta?.cwd??process.cwd(),s)}function M(e,a){let r=a.startsWith(".")?a:`.${a}`;return t.posix.join("/tmp",`agent-device-${e}-${Date.now()}-${Math.random().toString(36).slice(2,8)}${r}`)}async function T(e){let r;if(e.remoteBaseUrl){let t={transport:"http",token:e.remoteAuthToken??"",pid:0,baseUrl:e.remoteBaseUrl};if(await F(t,"http"))return t;throw new p("COMMAND_FAILED","Remote daemon is unavailable",{daemonBaseUrl:e.remoteBaseUrl,hint:"Verify AGENT_DEVICE_DAEMON_BASE_URL points to a reachable daemon with GET /health and POST /rpc."})}let i=U(e.paths.infoPath),s=n(),d=function(e,a=o()){try{let r=m.statSync(e),n=t.relative(a,e)||e;return`${n}:${r.size}:${Math.trunc(r.mtimeMs)}`}catch{return"unknown"}}((r=$()).useSrc?r.srcPath:r.distPath,r.root),l=!!i&&await F(i,e.transportPreference);if(i&&i.version===s&&i.codeSignature===d&&l)return i;i&&(i.version!==s||i.codeSignature!==d||!l)&&(await O(i),x(e.paths.infoPath)),function(e){let t=L(e);if(!t.hasLock||t.hasInfo)return;let r=C(e.lockPath);if(!r)return x(e.lockPath);a(r.pid,r.processStartTime)||x(e.lockPath)}(e.paths);let u=0;for(let t=1;t<=D;t+=1){await z(e);let a=await N(y,e);if(a)return a;if(await R(e.paths)){u+=1;continue}let r=L(e.paths);if(!(t<D))break;if(!r.hasInfo&&!r.hasLock){await k(150);continue}}let c=L(e.paths);throw new p("COMMAND_FAILED","Failed to start daemon",{kind:"daemon_startup_failed",infoPath:e.paths.infoPath,lockPath:e.paths.lockPath,startupTimeoutMs:y,startupAttempts:D,lockRecoveryCount:u,metadataState:c,hint:function(e,t=f(process.env.AGENT_DEVICE_STATE_DIR)){return e.hasLock&&!e.hasInfo?`Detected ${t.lockPath} without ${t.infoPath}. If no agent-device daemon process is running, delete ${t.lockPath} and retry.`:e.hasLock&&e.hasInfo?`Daemon metadata may be stale. If no agent-device daemon process is running, delete ${t.infoPath} and ${t.lockPath}, then retry.`:`Daemon metadata is missing or stale. Delete ${t.infoPath} if present and retry.`}(c,e.paths)})}async function N(e,t){let a=Date.now();for(;Date.now()-a<e;){let e=U(t.paths.infoPath);if(e&&await F(e,t.transportPreference))return e;await new Promise(e=>setTimeout(e,100))}return null}async function k(e){await new Promise(t=>setTimeout(t,e))}async function R(e){let t=L(e);if(!t.hasLock||t.hasInfo)return!1;let r=C(e.lockPath);return r&&a(r.pid,r.processStartTime)&&await v(r.pid,{termTimeoutMs:3e3,killTimeoutMs:1e3,expectedStartTime:r.processStartTime}),x(e.lockPath),!0}async function O(e){await v(e.pid,{termTimeoutMs:3e3,killTimeoutMs:1e3,expectedStartTime:e.processStartTime})}function U(e){let t=q(e);if(!t||"object"!=typeof t)return null;let a="string"==typeof t.token&&t.token.length>0?t.token:null;if(!a)return null;let r=Number.isInteger(t.port)&&Number(t.port)>0,n=Number.isInteger(t.httpPort)&&Number(t.httpPort)>0;if(!r&&!n)return null;let o=t.transport,i="string"==typeof t.version?t.version:void 0,s="string"==typeof t.codeSignature?t.codeSignature:void 0,d="string"==typeof t.processStartTime?t.processStartTime:void 0,l=Number.isInteger(t.pid)&&Number(t.pid)>0;return{token:a,port:r?Number(t.port):void 0,httpPort:n?Number(t.httpPort):void 0,transport:"socket"===o||"http"===o||"dual"===o?o:void 0,pid:l?Number(t.pid):0,version:i,codeSignature:s,processStartTime:d}}function C(e){let t=q(e);return t&&"object"==typeof t&&Number.isInteger(t.pid)&&Number(t.pid)>0?{pid:Number(t.pid),processStartTime:"string"==typeof t.processStartTime?t.processStartTime:void 0,startedAt:"number"==typeof t.startedAt?t.startedAt:void 0}:null}function L(e){return{hasInfo:m.existsSync(e.infoPath),hasLock:m.existsSync(e.lockPath)}}function q(e){if(!m.existsSync(e))return null;try{return JSON.parse(m.readFileSync(e,"utf8"))}catch{return null}}function x(e){try{m.existsSync(e)&&m.unlinkSync(e)}catch{}}async function F(e,t){var a;return"http"===G(e,t)?await function(e){let t=e.baseUrl?Q(e.baseUrl,"health"):e.httpPort?`http://127.0.0.1:${e.httpPort}/health`:null;if(!t)return Promise.resolve(!1);let a=new URL(t),r="https:"===a.protocol?i:g,n=e.baseUrl?3e3:500;return new Promise(e=>{let t=r.request({protocol:a.protocol,host:a.hostname,port:a.port,path:a.pathname+a.search,method:"GET",timeout:n},t=>{t.resume(),e((t.statusCode??500)<500)});t.on("timeout",()=>{t.destroy(),e(!1)}),t.on("error",()=>{e(!1)}),t.end()})}(e):await ((a=e.port)?new Promise(e=>{let t=h.createConnection({host:"127.0.0.1",port:a},()=>{t.destroy(),e(!0)});t.on("error",()=>{e(!1)})}):Promise.resolve(!1))}async function z(e){let t=$(),a=t.useSrc?["--experimental-strip-types",t.srcPath]:[t.distPath],n={...process.env,AGENT_DEVICE_STATE_DIR:e.paths.baseDir,AGENT_DEVICE_DAEMON_SERVER_MODE:e.serverMode};r(process.execPath,a,{env:n})}function $(){let e=o(),a=t.join(e,"dist","src","daemon.js"),r=t.join(e,"src","daemon.ts"),n=m.existsSync(a),i=m.existsSync(r);if(!n&&!i)throw new p("COMMAND_FAILED","Daemon entry not found",{distPath:a,srcPath:r});return{root:e,distPath:a,srcPath:r,useSrc:process.execArgv.includes("--experimental-strip-types")?i:!n&&i}}async function B(e,t,a){return"http"===G(e,a)?await H(e,t):await j(e,t)}function G(e,t){if(e.baseUrl){if("socket"===t)throw new p("COMMAND_FAILED","Remote daemon endpoint only supports HTTP transport",{daemonBaseUrl:e.baseUrl});return"http"}if("http"===t||"socket"===t){var a=e,r=t;if(V(a,r))return r;throw new p("COMMAND_FAILED","http"===r?"Daemon HTTP endpoint is unavailable":"Daemon socket endpoint is unavailable")}let n=("socket"===e.transport||"dual"===e.transport?["socket","http"]:["http","socket"]).find(t=>V(e,t));if(n)return n;throw new p("COMMAND_FAILED","Daemon metadata has no reachable transport")}function V(e,t){return"http"===t?!!e.httpPort:!!e.port}async function j(e,t){let a=e.port;if(!a)throw new p("COMMAND_FAILED","Daemon socket endpoint is unavailable");return new Promise((r,n)=>{let o=h.createConnection({host:"127.0.0.1",port:a},()=>{o.write(`${JSON.stringify(t)}
+`)}),i=setTimeout(()=>{o.destroy();let a=K(),r=W(e,f(t.flags?.stateDir??process.env.AGENT_DEVICE_STATE_DIR));u({level:"error",phase:"daemon_request_timeout",data:{timeoutMs:A,requestId:t.meta?.requestId,command:t.command,timedOutRunnerPidsTerminated:a.terminated,timedOutRunnerCleanupError:a.error,daemonPidReset:e.pid,daemonPidForceKilled:r.forcedKill}}),n(new p("COMMAND_FAILED","Daemon request timed out",{timeoutMs:A,requestId:t.meta?.requestId,hint:"Retry with --debug and check daemon diagnostics logs. Timed-out iOS runner xcodebuild processes were terminated when detected."}))},A),s="";o.setEncoding("utf8"),o.on("data",e=>{let a=(s+=e).indexOf("\n");if(-1===a)return;let d=s.slice(0,a).trim();if(d)try{let e=JSON.parse(d);o.end(),clearTimeout(i),r(e)}catch(e){clearTimeout(i),n(new p("COMMAND_FAILED","Invalid daemon response",{requestId:t.meta?.requestId,line:d},e instanceof Error?e:void 0))}}),o.on("error",e=>{clearTimeout(i),u({level:"error",phase:"daemon_request_socket_error",data:{requestId:t.meta?.requestId,message:e instanceof Error?e.message:String(e)}}),n(new p("COMMAND_FAILED","Failed to communicate with daemon",{requestId:t.meta?.requestId,hint:"Retry command. If this persists, clean stale daemon metadata and start a fresh session."},e))})})}async function H(t,a){let r=t.baseUrl?new URL(Q(t.baseUrl,"rpc")):t.httpPort?new URL(`http://127.0.0.1:${t.httpPort}/rpc`):null;if(!r)throw new p("COMMAND_FAILED","Daemon HTTP endpoint is unavailable");let n=JSON.stringify({jsonrpc:"2.0",id:a.meta?.requestId??e(),method:"agent_device.command",params:a}),o={"content-type":"application/json","content-length":Buffer.byteLength(n)};return t.baseUrl&&t.token&&(o.authorization=`Bearer ${t.token}`,o["x-agent-device-token"]=t.token),await new Promise((e,s)=>{let d=f(a.flags?.stateDir??process.env.AGENT_DEVICE_STATE_DIR),l=("https:"===r.protocol?i:g).request({protocol:r.protocol,host:r.hostname,port:r.port,method:"POST",path:r.pathname+r.search,headers:o},r=>{let n="";r.setEncoding("utf8"),r.on("data",e=>{n+=e}),r.on("end",()=>{clearTimeout(c);try{let r=JSON.parse(n);if(r.error){let e=r.error.data??{};s(new p(String(e.code??"COMMAND_FAILED"),String(e.message??r.error.message??"Daemon RPC request failed"),{..."object"==typeof e.details&&e.details?e.details:{},hint:"string"==typeof e.hint?e.hint:void 0,diagnosticId:"string"==typeof e.diagnosticId?e.diagnosticId:void 0,logPath:"string"==typeof e.logPath?e.logPath:void 0,requestId:a.meta?.requestId}));return}if(!r.result||"object"!=typeof r.result)return void s(new p("COMMAND_FAILED","Invalid daemon RPC response",{requestId:a.meta?.requestId}));if(t.baseUrl&&r.result.ok)return void X(t,a,r.result).then(e).catch(s);e(r.result)}catch(e){clearTimeout(c),s(new p("COMMAND_FAILED","Invalid daemon response",{requestId:a.meta?.requestId,line:n},e instanceof Error?e:void 0))}})}),c=setTimeout(()=>{l.destroy();let e=J(t)?{terminated:0}:K(),r=J(t)?{forcedKill:!1}:W(t,d);u({level:"error",phase:"daemon_request_timeout",data:{timeoutMs:A,requestId:a.meta?.requestId,command:a.command,timedOutRunnerPidsTerminated:e.terminated,timedOutRunnerCleanupError:e.error,daemonPidReset:J(t)?void 0:t.pid,daemonPidForceKilled:J(t)?void 0:r.forcedKill,daemonBaseUrl:t.baseUrl}}),s(new p("COMMAND_FAILED","Daemon request timed out",{timeoutMs:A,requestId:a.meta?.requestId,hint:J(t)?"Retry with --debug and verify the remote daemon URL, auth token, and remote host logs.":"Retry with --debug and check daemon diagnostics logs. Timed-out iOS runner xcodebuild processes were terminated when detected."}))},A);l.on("error",e=>{clearTimeout(c),u({level:"error",phase:"daemon_request_socket_error",data:{requestId:a.meta?.requestId,message:e instanceof Error?e.message:String(e)}}),s(new p("COMMAND_FAILED","Failed to communicate with daemon",{requestId:a.meta?.requestId,hint:J(t)?"Retry command. If this persists, verify the remote daemon URL, auth token, and remote host reachability.":"Retry command. If this persists, clean stale daemon metadata and start a fresh session."},e))}),l.write(n),l.end()})}function K(){let e=0;try{for(let t of b){let a=s("pkill",["-f",t],{allowFailure:!0});0===a.exitCode&&(e+=1)}return{terminated:e}}catch(t){return{terminated:e,error:t instanceof Error?t.message:String(t)}}}function W(e,t){let r=!1;try{a(e.pid,e.processStartTime)&&(process.kill(e.pid,"SIGKILL"),r=!0)}catch{v(e.pid,{termTimeoutMs:3e3,killTimeoutMs:1e3,expectedStartTime:e.processStartTime})}finally{x(t.infoPath),x(t.lockPath)}return{forcedKill:r}}function J(e){return"string"==typeof e.baseUrl&&e.baseUrl.length>0}function Q(e,t){return new URL(t,e.endsWith("/")?e:`${e}/`).toString()}async function X(e,a,r){let n=Array.isArray(r.data?.artifacts)?r.data.artifacts:[];if(0===n.length||!e.baseUrl)return r;let o=r.data?{...r.data}:{},i=[];for(let r of n){if(!r||"object"!=typeof r||"string"!=typeof r.artifactId){i.push(r);continue}let n=function(e,a){if(e.localPath&&e.localPath.trim().length>0)return e.localPath;let r=e.fileName?.trim()||`${e.field}-${Date.now()}`;return t.resolve(a.meta?.cwd??process.cwd(),r)}(r,a);await Y({baseUrl:e.baseUrl,token:e.token,artifactId:r.artifactId,destinationPath:n,requestId:a.meta?.requestId}),o[r.field]=n,i.push({...r,localPath:n})}return o.artifacts=i,{ok:!0,data:o}}async function Y(e){var a,r;let n,o=new URL((a=e.baseUrl,r=e.artifactId,n=a.endsWith("/")?a:`${a}/`,new URL(`upload/${encodeURIComponent(r)}`,n).toString())),s="https:"===o.protocol?i:g;await m.promises.mkdir(t.dirname(e.destinationPath),{recursive:!0}),await new Promise((t,a)=>{let r=!1,n=e.timeoutMs??A,i=n=>{if(!r){if(r=!0,clearTimeout(l),n)return void m.promises.rm(e.destinationPath,{force:!0}).finally(()=>a(n));t()}},d=s.request({protocol:o.protocol,host:o.hostname,port:o.port,method:"GET",path:o.pathname+o.search,headers:e.token?{authorization:`Bearer ${e.token}`,"x-agent-device-token":e.token}:void 0},t=>{if((t.statusCode??500)>=400){let a="";t.setEncoding("utf8"),t.on("data",e=>{a+=e}),t.on("end",()=>{i(new p("COMMAND_FAILED","Failed to download remote artifact",{artifactId:e.artifactId,statusCode:t.statusCode,requestId:e.requestId,body:a}))});return}let a=m.createWriteStream(e.destinationPath);a.on("error",e=>{i(e instanceof Error?e:Error(String(e)))}),t.on("error",e=>{i(e instanceof Error?e:Error(String(e)))}),t.on("aborted",()=>{i(new p("COMMAND_FAILED","Remote artifact download was interrupted",{artifactId:e.artifactId,requestId:e.requestId}))}),a.on("finish",()=>{a.close(()=>i())}),t.pipe(a)}),l=setTimeout(()=>{d.destroy(new p("COMMAND_FAILED","Remote artifact download timed out",{artifactId:e.artifactId,requestId:e.requestId,timeoutMs:n}))},n);d.on("error",t=>{t instanceof p?i(t):i(new p("COMMAND_FAILED","Failed to download remote artifact",{artifactId:e.artifactId,requestId:e.requestId,timeoutMs:n},t instanceof Error?t:void 0))}),d.end()})}function Z(e){let t=e.appId??e.bundleId??e.packageName;return{session:e.session,appId:t,appBundleId:e.bundleId,package:e.packageName}}function ee(e,t,a){return{deviceId:t,deviceName:a,..."ios"===e?{udid:t}:{serial:t}}}function et(e,t={}){let a=t.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&&a?{serial:e.android?.serial??e.id}:{}}}function ea(e){return{name:e.name,...et(e.device,{includeAndroidSerial:!1}),createdAt:e.createdAt}}function er(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 en(e){return{udid:e.udid,device:e.device,runtime:e.runtime,ios_simulator_device_set:e.iosSimulatorDeviceSet??null,created:e.created,booted:e.booted}}function eo(e){return{session:e.session,configured:e.configured,...e.cleared?{cleared:!0}:{},...e.runtime?{runtime:e.runtime}:{}}}function ei(e){return{app:e.app,appPath:e.appPath,platform:e.platform,...e.appId?{appId:e.appId}:{},...e.bundleId?{bundleId:e.bundleId}:{},...e.package?{package:e.package}:{}}}function es(e){return{launchTarget:e.launchTarget,...e.appName?{appName:e.appName}:{},...e.appId?{appId:e.appId}:{},...e.bundleId?{bundleId:e.bundleId}:{},...e.packageName?{package:e.packageName}:{},...e.installablePath?{installablePath:e.installablePath}:{},...e.archivePath?{archivePath:e.archivePath}:{},...e.materializationId?{materializationId:e.materializationId}:{},...e.materializationExpiresAt?{materializationExpiresAt:e.materializationExpiresAt}:{}}}function ed(e){return{session:e.session,...e.appName?{appName:e.appName}:{},...e.appBundleId?{appBundleId:e.appBundleId}:{},...e.startup?{startup:e.startup}:{},...e.runtime?{runtime:e.runtime}:{},...e.device?et(e.device):{}}}function el(e){return{session:e.session,...e.shutdown?{shutdown:e.shutdown}:{}}}function eu(e){return{nodes:e.nodes,truncated:e.truncated,...e.appName?{appName:e.appName}:{},...e.appBundleId?{appBundleId:e.appBundleId}:{}}}function ec(e,t){let a=ey(e,"bundleId"),r=ey(e,"package");return{app:eA(e,"app"),appPath:eA(e,"appPath"),platform:eD(e,"platform"),appId:a??r,bundleId:a,package:r,identifiers:Z({session:t,bundleId:a,packageName:r})}}function ep(e,t){return{session:t,configured:!0===e.configured,cleared:!0===e.cleared||void 0,runtime:eh(e.runtime),identifiers:{session:t}}}function em(e){var t;let a=eg(e),r=eD(a,"platform"),n=eA(a,"id"),o=eA(a,"name");return{platform:r,target:eb(a,"target"),kind:eP(a,t="kind",eT,`Daemon response has invalid "${t}".`),id:n,name:o,booted:"boolean"==typeof a.booted?a.booted:void 0,identifiers:ee(r,n,o),ios:"ios"===r?{udid:n}:void 0,android:"android"===r?{serial:n}:void 0}}function ef(e){var t;let a=eg(e),r=eD(a,"platform"),n=eA(a,"id"),o=eA(a,"name"),i=eb(a,"target"),s=eA(a,"device"),d={session:o,...ee(r,n,s)};return{name:o,createdAt:eP(a,t="createdAt",eS,`Daemon response is missing numeric "${t}".`),device:{platform:r,target:i,id:n,name:s,identifiers:d,ios:"ios"===r?{udid:n,simulatorSetPath:eE(a,"ios_simulator_device_set",e_)}:void 0,android:"android"===r?{serial:n}:void 0},identifiers:d}}function eh(e){if(!ew(e))return;let t=e.platform,a=ey(e,"metroHost"),r="number"==typeof e.metroPort?e.metroPort:void 0;return{platform:"ios"===t||"android"===t?t:void 0,metroHost:a,metroPort:r,bundleUrl:ey(e,"bundleUrl"),launchUrl:ey(e,"launchUrl")}}function eI(e,t){return t??e??"default"}function ev(e){let t={};for(let[a,r]of Object.entries(e))void 0!==r&&(t[a]=r);return t}function eg(e){if(!ew(e))throw new p("COMMAND_FAILED","Daemon returned an unexpected response shape.",{value:e});return e}function ew(e){return"object"==typeof e&&null!==e}function eA(e,t){return eP(e,t,e_,`Daemon response is missing "${t}".`)}function ey(e,t){return e_(e[t])}function eD(e,t){return eP(e,t,eM,`Daemon response has invalid "${t}".`)}function eb(e,t){return eN(e[t])??"mobile"}function eP(e,t,a,r){let n=a(e[t]);if(void 0===n)throw new p("COMMAND_FAILED",r,{response:e});return n}function eE(e,t,a){let r=e[t];return null===r?null:a(r)}function e_(e){return"string"==typeof e&&e.length>0?e:void 0}function eS(e){return"number"==typeof e&&Number.isFinite(e)?e:void 0}function eM(e){return"ios"===e||"android"===e?e:void 0}function eT(e){return"simulator"===e||"emulator"===e||"device"===e?e:void 0}function eN(e){return"tv"===e?"tv":"mobile"===e?"mobile":void 0}function ek(e={},t={}){let a=t.transport??P,r=async(t,r=[],n={})=>{let o={...e,...n},i=await a({session:eI(e.session,n.session),command:t,positionals:r,flags:ev({stateDir:o.stateDir,daemonBaseUrl:o.daemonBaseUrl,daemonAuthToken:o.daemonAuthToken,daemonTransport:o.daemonTransport,daemonServerMode:o.daemonServerMode,tenant:o.tenant,sessionIsolation:o.sessionIsolation,runId:o.runId,leaseId:o.leaseId,platform:o.platform,target:o.target,device:o.device,udid:o.udid,serial:o.serial,iosSimulatorDeviceSet:o.iosSimulatorDeviceSet,androidDeviceAllowlist:o.androidDeviceAllowlist,runtime:o.simulatorRuntimeId,boot:o.boot,reuseExisting:o.reuseExisting,activity:o.activity,relaunch:o.relaunch,shutdown:o.shutdown,saveScript:o.saveScript,noRecord:o.noRecord,metroHost:o.metroHost,metroPort:o.metroPort,bundleUrl:o.bundleUrl,launchUrl:o.launchUrl,snapshotInteractiveOnly:o.interactiveOnly,snapshotCompact:o.compact,snapshotDepth:o.depth,snapshotScope:o.scope,snapshotRaw:o.raw,verbose:o.debug}),runtime:o.runtime,meta:ev({requestId:o.requestId,cwd:o.cwd,debug:o.debug,lockPolicy:o.lockPolicy,lockPlatform:o.lockPlatform,tenantId:o.tenant,runId:o.runId,leaseId:o.leaseId,sessionIsolation:o.sessionIsolation,installSource:o.installSource,retainMaterializedPaths:o.retainMaterializedPaths,materializedPathRetentionMs:o.materializedPathRetentionMs,materializationId:o.materializationId})});if(!i.ok)throw new p(i.error.code,i.error.message,{...i.error.details??{},hint:i.error.hint,diagnosticId:i.error.diagnosticId,logPath:i.error.logPath});return i.data??{}},n=async(e={})=>{let t=await r("session_list",[],e);return(Array.isArray(t.sessions)?t.sessions:[]).map(ef)};return{devices:{list:async(e={})=>{let t=await r("devices",[],e);return(Array.isArray(t.devices)?t.devices:[]).map(em)}},sessions:{list:async(e={})=>await n(e),close:async(t={})=>{let a=eI(e.session,t.session),n=(await r("close",[],t)).shutdown;return{session:a,shutdown:"object"==typeof n&&null!==n?n:void 0,identifiers:{session:a}}}},simulators:{ensure:async e=>{let{runtime:t,...a}=e,n=await r("ensure-simulator",[],{...a,simulatorRuntimeId:t}),o=eA(n,"udid"),i=eA(n,"device");return{udid:o,device:i,runtime:eA(n,"runtime"),created:!0===n.created,booted:!0===n.booted,iosSimulatorDeviceSet:eE(n,"ios_simulator_device_set",e_),identifiers:{deviceId:o,deviceName:i,udid:o}}}},apps:{install:async t=>ec(await r("install",[t.app,t.appPath],t),eI(e.session,t.session)),reinstall:async t=>ec(await r("reinstall",[t.app,t.appPath],t),eI(e.session,t.session)),installFromSource:async t=>(function(e,t){let a=ey(e,"bundleId"),r=ey(e,"packageName"),n=a??r??ey(e,"appId"),o=ey(e,"launchTarget")??r??a??n;if(!o)throw new p("COMMAND_FAILED",'Daemon response is missing "launchTarget".',{response:e});return{appName:ey(e,"appName"),appId:n,bundleId:a,packageName:r,launchTarget:o,installablePath:ey(e,"installablePath"),archivePath:ey(e,"archivePath"),materializationId:ey(e,"materializationId"),materializationExpiresAt:ey(e,"materializationExpiresAt"),identifiers:Z({session:t,bundleId:a,packageName:r,appId:n})}})(await r("install_source",[],{...t,installSource:t.source,retainMaterializedPaths:t.retainPaths,materializedPathRetentionMs:t.retentionMs}),eI(e.session,t.session)),open:async t=>{let a=eI(e.session,t.session),n=t.url?[t.app,t.url]:[t.app],o=await r("open",n,t),i=function(e){let t=e.platform,a=ey(e,"id"),r=ey(e,"device");if("ios"!==t&&"android"!==t||!a||!r)return;let n=eb(e,"target"),o=ee(t,a,r);return{platform:t,target:n,id:a,name:r,identifiers:o,ios:"ios"===t?{udid:ey(e,"device_udid")??a,simulatorSetPath:eE(e,"ios_simulator_device_set",e_)}:void 0,android:"android"===t?{serial:ey(e,"serial")??a}:void 0}}(o),s=ey(o,"appBundleId");return{session:a,appName:ey(o,"appName"),appBundleId:s,appId:s,startup:function(e){if(ew(e)&&"number"==typeof e.durationMs&&"string"==typeof e.measuredAt&&"string"==typeof e.method)return{durationMs:e.durationMs,measuredAt:e.measuredAt,method:e.method,appTarget:ey(e,"appTarget"),appBundleId:ey(e,"appBundleId")}}(o.startup),runtime:eh(o.runtime),device:i,identifiers:{session:a,deviceId:i?.id,deviceName:i?.name,udid:i?.ios?.udid,serial:i?.android?.serial,appId:s,appBundleId:s}}},close:async(t={})=>{let a=eI(e.session,t.session),n=(await r("close",t.app?[t.app]:[],t)).shutdown;return{session:a,closedApp:t.app,shutdown:"object"==typeof n&&null!==n?n:void 0,identifiers:{session:a}}}},materializations:{release:async e=>{var t;return{released:!0===(t=await r("release_materialized_paths",[],{...e,materializationId:e.materializationId})).released,materializationId:eA(t,"materializationId"),identifiers:{}}}},runtime:{set:async t=>ep(await r("runtime",["set"],t),eI(e.session,t.session)),show:async(t={})=>ep(await r("runtime",["show"],t),eI(e.session,t.session))},capture:{snapshot:async(t={})=>{var a;let n=eI(e.session,t.session),o=await r("snapshot",[],t),i=ey(o,"appBundleId");return{nodes:Array.isArray(a=o.nodes)?a:[],truncated:!0===o.truncated,appName:ey(o,"appName"),appBundleId:i,identifiers:{session:n,appId:i,appBundleId:i}}},screenshot:async(t={})=>{let a=eI(e.session,t.session);return{path:eA(await r("screenshot",t.path?[t.path]:[],t),"path"),identifiers:{session:a}}}}}}export{ek as createAgentDeviceClient,P as sendToDaemon,el as serializeCloseResult,ei as serializeDeployResult,er as serializeDevice,en as serializeEnsureSimulatorResult,es as serializeInstallFromSourceResult,ed as serializeOpenResult,eo as serializeRuntimeResult,ea as serializeSessionListEntry,eu as serializeSnapshotResult};

package/dist/src/bin.js

@@ -1,85 +1,85 @@
-import{PNG as e}from"pngjs";import{formatSnapshotLine as t,SETTINGS_USAGE_OVERRIDE as s,styleText as i,parseBatchStepsJson as o,buildSnapshotDisplayLines as a}from"./274.js";import{createRequestId as r,node_path as n,normalizeError as l,resolveUserPath as d,readVersion as p,getDiagnosticsMeta as u,emitDiagnostic as c,promises as g,asAppError as f,expandUserHomePath as m,pathToFileURL as h,AppError as y,node_fs as w,node_os as v,withDiagnosticsScope as b,flushDiagnosticsToSessionFile as $,resolveDaemonPaths as k}from"./331.js";import{serializeOpenResult as S,sendToDaemon as A,serializeSessionListEntry as D,serializeDeployResult as I,serializeSnapshotResult as L,serializeCloseResult as x,serializeRuntimeResult as N,serializeEnsureSimulatorResult as O,createAgentDeviceClient as F,serializeDevice as _}from"./224.js";let E=["snapshotInteractiveOnly","snapshotCompact","snapshotDepth","snapshotScope","snapshotRaw"],C=["snapshotDepth","snapshotScope","snapshotRaw"],j=[{key:"config",names:["--config"],type:"string",usageLabel:"--config <path>",usageDescription:"Load CLI defaults from a specific config file"},{key:"stateDir",names:["--state-dir"],type:"string",usageLabel:"--state-dir <path>",usageDescription:"Daemon state directory (defaults to ~/.agent-device)"},{key:"daemonBaseUrl",names:["--daemon-base-url"],type:"string",usageLabel:"--daemon-base-url <url>",usageDescription:"Explicit remote HTTP daemon base URL (skip local daemon discovery/startup)"},{key:"daemonAuthToken",names:["--daemon-auth-token"],type:"string",usageLabel:"--daemon-auth-token <token>",usageDescription:"Remote HTTP daemon auth token (sent as request token and bearer header)"},{key:"daemonTransport",names:["--daemon-transport"],type:"enum",enumValues:["auto","socket","http"],usageLabel:"--daemon-transport auto|socket|http",usageDescription:"Daemon client transport preference"},{key:"daemonServerMode",names:["--daemon-server-mode"],type:"enum",enumValues:["socket","http","dual"],usageLabel:"--daemon-server-mode socket|http|dual",usageDescription:"Daemon server mode used when spawning daemon"},{key:"tenant",names:["--tenant"],type:"string",usageLabel:"--tenant <id>",usageDescription:"Tenant scope identifier for isolated daemon sessions"},{key:"sessionIsolation",names:["--session-isolation"],type:"enum",enumValues:["none","tenant"],usageLabel:"--session-isolation none|tenant",usageDescription:"Session isolation strategy (tenant prefixes session namespace)"},{key:"runId",names:["--run-id"],type:"string",usageLabel:"--run-id <id>",usageDescription:"Run identifier used for tenant lease admission checks"},{key:"leaseId",names:["--lease-id"],type:"string",usageLabel:"--lease-id <id>",usageDescription:"Lease identifier bound to tenant/run admission scope"},{key:"sessionLock",names:["--session-lock"],type:"enum",enumValues:["reject","strip"],usageLabel:"--session-lock reject|strip",usageDescription:"Lock bound-session device routing for this CLI invocation and nested batch steps"},{key:"sessionLocked",names:["--session-locked"],type:"boolean",usageLabel:"--session-locked",usageDescription:"Deprecated alias for --session-lock reject"},{key:"sessionLockConflicts",names:["--session-lock-conflicts"],type:"enum",enumValues:["reject","strip"],usageLabel:"--session-lock-conflicts reject|strip",usageDescription:"Deprecated alias for --session-lock"},{key:"platform",names:["--platform"],type:"enum",enumValues:["ios","android","apple"],usageLabel:"--platform ios|android|apple",usageDescription:"Platform to target (`apple` aliases the iOS/tvOS backend)"},{key:"target",names:["--target"],type:"enum",enumValues:["mobile","tv"],usageLabel:"--target mobile|tv",usageDescription:"Device target class to match"},{key:"device",names:["--device"],type:"string",usageLabel:"--device <name>",usageDescription:"Device name to target"},{key:"udid",names:["--udid"],type:"string",usageLabel:"--udid <udid>",usageDescription:"iOS device UDID"},{key:"serial",names:["--serial"],type:"string",usageLabel:"--serial <serial>",usageDescription:"Android device serial"},{key:"headless",names:["--headless"],type:"boolean",usageLabel:"--headless",usageDescription:"Boot: launch Android emulator without a GUI window"},{key:"runtime",names:["--runtime"],type:"string",usageLabel:"--runtime <id>",usageDescription:"ensure-simulator: CoreSimulator runtime identifier (e.g. com.apple.CoreSimulator.SimRuntime.iOS-18-0)"},{key:"metroHost",names:["--metro-host"],type:"string",usageLabel:"--metro-host <host>",usageDescription:"runtime set: session-scoped Metro/debug host hint"},{key:"metroPort",names:["--metro-port"],type:"int",min:1,max:65535,usageLabel:"--metro-port <port>",usageDescription:"runtime set: session-scoped Metro/debug port hint"},{key:"bundleUrl",names:["--bundle-url"],type:"string",usageLabel:"--bundle-url <url>",usageDescription:"runtime set: session-scoped bundle URL hint"},{key:"launchUrl",names:["--launch-url"],type:"string",usageLabel:"--launch-url <url>",usageDescription:"runtime set: session-scoped deep link / launch URL hint"},{key:"boot",names:["--boot"],type:"boolean",usageLabel:"--boot",usageDescription:"ensure-simulator: boot the simulator after ensuring it exists"},{key:"reuseExisting",names:["--reuse-existing"],type:"boolean",usageLabel:"--reuse-existing",usageDescription:"ensure-simulator: reuse an existing simulator (default: true)"},{key:"iosSimulatorDeviceSet",names:["--ios-simulator-device-set"],type:"string",usageLabel:"--ios-simulator-device-set <path>",usageDescription:"Scope iOS simulator discovery/commands to this simulator device set"},{key:"androidDeviceAllowlist",names:["--android-device-allowlist"],type:"string",usageLabel:"--android-device-allowlist <serials>",usageDescription:"Comma/space separated Android serial allowlist for discovery/selection"},{key:"activity",names:["--activity"],type:"string",usageLabel:"--activity <component>",usageDescription:"Android app launch activity (package/Activity); not for URL opens"},{key:"session",names:["--session"],type:"string",usageLabel:"--session <name>",usageDescription:"Named session"},{key:"count",names:["--count"],type:"int",min:1,max:200,usageLabel:"--count <n>",usageDescription:"Repeat count for press/swipe series"},{key:"fps",names:["--fps"],type:"int",min:1,max:120,usageLabel:"--fps <n>",usageDescription:"Record: target frames per second (iOS physical device runner)"},{key:"intervalMs",names:["--interval-ms"],type:"int",min:0,max:1e4,usageLabel:"--interval-ms <ms>",usageDescription:"Delay between press iterations"},{key:"holdMs",names:["--hold-ms"],type:"int",min:0,max:1e4,usageLabel:"--hold-ms <ms>",usageDescription:"Press hold duration for each iteration"},{key:"jitterPx",names:["--jitter-px"],type:"int",min:0,max:100,usageLabel:"--jitter-px <n>",usageDescription:"Deterministic coordinate jitter radius for press"},{key:"doubleTap",names:["--double-tap"],type:"boolean",usageLabel:"--double-tap",usageDescription:"Use double-tap gesture per press iteration"},{key:"pauseMs",names:["--pause-ms"],type:"int",min:0,max:1e4,usageLabel:"--pause-ms <ms>",usageDescription:"Delay between swipe iterations"},{key:"pattern",names:["--pattern"],type:"enum",enumValues:["one-way","ping-pong"],usageLabel:"--pattern one-way|ping-pong",usageDescription:"Swipe repeat pattern"},{key:"verbose",names:["--debug","--verbose","-v"],type:"boolean",usageLabel:"--debug, --verbose, -v",usageDescription:"Enable debug diagnostics and stream daemon/runner logs"},{key:"json",names:["--json"],type:"boolean",usageLabel:"--json",usageDescription:"JSON output"},{key:"help",names:["--help","-h"],type:"boolean",usageLabel:"--help, -h",usageDescription:"Print help and exit"},{key:"version",names:["--version","-V"],type:"boolean",usageLabel:"--version, -V",usageDescription:"Print version and exit"},{key:"saveScript",names:["--save-script"],type:"booleanOrString",usageLabel:"--save-script [path]",usageDescription:"Save session script (.ad) on close; optional custom output path"},{key:"shutdown",names:["--shutdown"],type:"boolean",usageLabel:"--shutdown",usageDescription:"close: shutdown associated iOS simulator after ending session"},{key:"relaunch",names:["--relaunch"],type:"boolean",usageLabel:"--relaunch",usageDescription:"open: terminate app process before launching it"},{key:"restart",names:["--restart"],type:"boolean",usageLabel:"--restart",usageDescription:"logs clear: stop active stream, clear logs, then start streaming again"},{key:"noRecord",names:["--no-record"],type:"boolean",usageLabel:"--no-record",usageDescription:"Do not record this action"},{key:"replayUpdate",names:["--update","-u"],type:"boolean",usageLabel:"--update, -u",usageDescription:"Replay: update selectors and rewrite replay file in place"},{key:"steps",names:["--steps"],type:"string",usageLabel:"--steps <json>",usageDescription:"Batch: JSON array of steps"},{key:"stepsFile",names:["--steps-file"],type:"string",usageLabel:"--steps-file <path>",usageDescription:"Batch: read steps JSON from file"},{key:"batchOnError",names:["--on-error"],type:"enum",enumValues:["stop"],usageLabel:"--on-error stop",usageDescription:"Batch: stop when a step fails"},{key:"batchMaxSteps",names:["--max-steps"],type:"int",min:1,max:1e3,usageLabel:"--max-steps <n>",usageDescription:"Batch: maximum number of allowed steps"},{key:"appsFilter",names:["--user-installed"],type:"enum",setValue:"user-installed",usageLabel:"--user-installed",usageDescription:"Apps: list user-installed apps"},{key:"appsFilter",names:["--all"],type:"enum",setValue:"all",usageLabel:"--all",usageDescription:"Apps: list all apps (include system/default apps)"},{key:"snapshotInteractiveOnly",names:["-i"],type:"boolean",usageLabel:"-i",usageDescription:"Snapshot: interactive elements only"},{key:"snapshotCompact",names:["-c"],type:"boolean",usageLabel:"-c",usageDescription:"Snapshot: compact output (drop empty structure)"},{key:"snapshotDepth",names:["--depth","-d"],type:"int",min:0,usageLabel:"--depth, -d <depth>",usageDescription:"Snapshot: limit snapshot depth"},{key:"snapshotScope",names:["--scope","-s"],type:"string",usageLabel:"--scope, -s <scope>",usageDescription:"Snapshot: scope snapshot to label/identifier"},{key:"snapshotRaw",names:["--raw"],type:"boolean",usageLabel:"--raw",usageDescription:"Snapshot: raw node output"},{key:"out",names:["--out"],type:"string",usageLabel:"--out <path>",usageDescription:"Output path"},{key:"baseline",names:["--baseline","-b"],type:"string",usageLabel:"--baseline, -b <path>",usageDescription:"Diff screenshot: path to baseline image file"},{key:"threshold",names:["--threshold"],type:"string",usageLabel:"--threshold <0-1>",usageDescription:"Diff screenshot: color distance threshold (default 0.1)"}],P=new Set(["json","config","stateDir","daemonBaseUrl","daemonAuthToken","daemonTransport","daemonServerMode","tenant","sessionIsolation","runId","leaseId","sessionLock","sessionLocked","sessionLockConflicts","help","version","verbose","platform","target","device","udid","serial","iosSimulatorDeviceSet","androidDeviceAllowlist","session","noRecord"]),R={boot:{description:"Ensure target device/simulator is booted and ready",positionalArgs:[],allowedFlags:["headless"]},open:{description:"Boot device/simulator; optionally launch app or deep link URL",positionalArgs:["appOrUrl?","url?"],allowedFlags:["activity","saveScript","relaunch"]},close:{description:"Close app or just end session",positionalArgs:["app?"],allowedFlags:["saveScript","shutdown"]},reinstall:{description:"Uninstall + install app from binary path",positionalArgs:["app","path"],allowedFlags:[]},install:{description:"Install app from binary path without uninstalling first",positionalArgs:["app","path"],allowedFlags:[]},push:{description:"Simulate push notification payload delivery",positionalArgs:["bundleOrPackage","payloadOrJson"],allowedFlags:[]},snapshot:{description:"Capture accessibility tree",positionalArgs:[],allowedFlags:[...E]},diff:{usageOverride:"diff snapshot | diff screenshot --baseline <path> [--out <diff.png>] [--threshold <0-1>]",description:"Diff accessibility snapshot or compare screenshots pixel-by-pixel",positionalArgs:["kind"],allowedFlags:[...E,"baseline","threshold","out"]},"ensure-simulator":{description:"Ensure an iOS simulator exists in a device set (create if missing)",positionalArgs:[],allowedFlags:["runtime","boot","reuseExisting"],skipCapabilityCheck:!0},devices:{description:"List available devices",positionalArgs:[],allowedFlags:[],skipCapabilityCheck:!0},apps:{description:"List installed apps (includes default/system apps by default)",positionalArgs:[],allowedFlags:["appsFilter"],defaults:{appsFilter:"all"}},appstate:{description:"Show foreground app/activity",positionalArgs:[],allowedFlags:[],skipCapabilityCheck:!0},runtime:{usageOverride:"runtime set|show|clear",description:"Manage session-scoped runtime hints",positionalArgs:["set|show|clear"],allowedFlags:["metroHost","metroPort","bundleUrl","launchUrl"],skipCapabilityCheck:!0},clipboard:{usageOverride:"clipboard read | clipboard write <text>",description:"Read or write device clipboard text",positionalArgs:["read|write","text?"],allowsExtraPositionals:!0,allowedFlags:[]},keyboard:{usageOverride:"keyboard [status|get|dismiss]",description:"Inspect Android keyboard visibility/type or dismiss it",positionalArgs:["action?"],allowedFlags:[]},perf:{description:"Show session performance metrics (startup timing)",positionalArgs:[],allowedFlags:[]},back:{description:"Navigate back (where supported)",positionalArgs:[],allowedFlags:[]},home:{description:"Go to home screen (where supported)",positionalArgs:[],allowedFlags:[]},"app-switcher":{description:"Open app switcher (where supported)",positionalArgs:[],allowedFlags:[]},wait:{usageOverride:"wait <ms>|text <text>|@ref|<selector> [timeoutMs]",description:"Wait for duration, text, ref, or selector to appear",positionalArgs:["durationOrSelector","timeoutMs?"],allowsExtraPositionals:!0,allowedFlags:[...C]},alert:{usageOverride:"alert [get|accept|dismiss|wait] [timeout]",description:"Inspect or handle alert (iOS simulator)",positionalArgs:["action?","timeout?"],allowedFlags:[]},click:{usageOverride:"click <x y|@ref|selector>",description:"Tap/click by coordinates, snapshot ref, or selector",positionalArgs:["target"],allowsExtraPositionals:!0,allowedFlags:["count","intervalMs","holdMs","jitterPx","doubleTap",...C]},get:{usageOverride:"get text|attrs <@ref|selector>",description:"Return element text/attributes by ref or selector",positionalArgs:["subcommand","target"],allowedFlags:[...C]},replay:{description:"Replay a recorded session",positionalArgs:["path"],allowedFlags:["replayUpdate"],skipCapabilityCheck:!0},batch:{usageOverride:"batch [--steps <json> | --steps-file <path>]",description:"Execute multiple commands in one daemon request",positionalArgs:[],allowedFlags:["steps","stepsFile","batchOnError","batchMaxSteps","out"],skipCapabilityCheck:!0},press:{usageOverride:"press <x y|@ref|selector>",description:"Tap/press by coordinates, snapshot ref, or selector (supports repeated series)",positionalArgs:["targetOrX","y?"],allowsExtraPositionals:!0,allowedFlags:["count","intervalMs","holdMs","jitterPx","doubleTap",...C]},longpress:{description:"Long press by coordinates (iOS and Android)",positionalArgs:["x","y","durationMs?"],allowedFlags:[]},swipe:{description:"Swipe coordinates with optional repeat pattern",positionalArgs:["x1","y1","x2","y2","durationMs?"],allowedFlags:["count","pauseMs","pattern"]},focus:{description:"Focus input at coordinates",positionalArgs:["x","y"],allowedFlags:[]},type:{description:"Type text in focused field",positionalArgs:["text"],allowsExtraPositionals:!0,allowedFlags:[]},fill:{usageOverride:"fill <x> <y> <text> | fill <@ref|selector> <text>",description:"Tap then type",positionalArgs:["targetOrX","yOrText","text?"],allowsExtraPositionals:!0,allowedFlags:[...C]},scroll:{description:"Scroll in direction (0-1 amount)",positionalArgs:["direction","amount?"],allowedFlags:[]},scrollintoview:{usageOverride:"scrollintoview <text|@ref>",description:"Scroll until text appears or a snapshot ref is brought into view",positionalArgs:["target"],allowsExtraPositionals:!0,allowedFlags:[]},pinch:{description:"Pinch/zoom gesture (iOS simulator)",positionalArgs:["scale","x?","y?"],allowedFlags:[]},screenshot:{description:"Capture screenshot",positionalArgs:["path?"],allowedFlags:["out"]},"trigger-app-event":{usageOverride:"trigger-app-event <event> [payloadJson]",description:"Trigger app-defined event hook via deep link template",positionalArgs:["event","payloadJson?"],allowedFlags:[]},record:{usageOverride:"record start [path] [--fps <n>] | record stop",description:"Start/stop screen recording",positionalArgs:["start|stop","path?"],allowedFlags:["fps"]},trace:{usageOverride:"trace start [path] | trace stop [path]",description:"Start/stop trace log capture",positionalArgs:["start|stop","path?"],allowedFlags:[],skipCapabilityCheck:!0},logs:{usageOverride:"logs path | logs start | logs stop | logs clear [--restart] | logs doctor | logs mark [message...]",description:"Session app log info, start/stop streaming, diagnostics, and markers",positionalArgs:["path|start|stop|clear|doctor|mark","message?"],allowsExtraPositionals:!0,allowedFlags:["restart"]},network:{usageOverride:"network dump [limit] [summary|headers|body|all] | network log [limit] [summary|headers|body|all]",description:"Dump recent HTTP(s) traffic parsed from the session app log",positionalArgs:["dump|log","limit?","include?"],allowedFlags:[]},find:{usageOverride:"find <locator|text> <action> [value]",description:"Find by text/label/value/role/id and run action",positionalArgs:["query","action","value?"],allowsExtraPositionals:!0,allowedFlags:["snapshotDepth","snapshotRaw"]},is:{description:"Assert UI state (visible|hidden|exists|editable|selected|text)",positionalArgs:["predicate","selector","value?"],allowsExtraPositionals:!0,allowedFlags:[...C]},settings:{usageOverride:s,description:"Toggle OS settings, appearance, and app permissions (session app scope for permission actions)",positionalArgs:["setting","state","target?","mode?"],allowedFlags:[]},session:{usageOverride:"session list",description:"List active sessions",positionalArgs:["list?"],allowedFlags:[],skipCapabilityCheck:!0}},V=new Map,T=new Map;for(let e of j){for(let t of e.names)V.set(t,e);let t=T.get(e.key);t?t.push(e):T.set(e.key,[e])}function M(e){if(e)return R[e]}function G(){return Object.keys(R)}function U(e){let t=e.endsWith("?"),s=t?e.slice(0,-1):e;return t?`[${s}]`:`<${s}>`}function B(e,t){return t.usageOverride?t.usageOverride:[e,...t.positionalArgs.map(U),...t.allowedFlags.flatMap(e=>(T.get(e)??[]).map(e=>e.usageLabel??e.names[0])).map(e=>`[${e}]`)].join(" ")}let q=function(){let e=`agent-device <command> [args] [--json]
+import{PNG as e}from"pngjs";import{formatSnapshotLine as t,SETTINGS_USAGE_OVERRIDE as s,styleText as i,parseBatchStepsJson as a,buildSnapshotDisplayLines as r}from"./274.js";import{createRequestId as o,node_path as n,normalizeError as l,resolveUserPath as d,readVersion as p,getDiagnosticsMeta as u,emitDiagnostic as c,promises as g,asAppError as f,expandUserHomePath as m,pathToFileURL as h,AppError as y,node_fs as w,node_os as v,withDiagnosticsScope as b,flushDiagnosticsToSessionFile as $,resolveDaemonPaths as k}from"./331.js";import{serializeOpenResult as A,sendToDaemon as S,serializeSessionListEntry as D,serializeDeployResult as I,serializeSnapshotResult as L,serializeCloseResult as x,serializeRuntimeResult as N,serializeEnsureSimulatorResult as O,serializeInstallFromSourceResult as F,serializeDevice as _,createAgentDeviceClient as E}from"./224.js";let P=["snapshotInteractiveOnly","snapshotCompact","snapshotDepth","snapshotScope","snapshotRaw"],R=["snapshotDepth","snapshotScope","snapshotRaw"],C=[{key:"config",names:["--config"],type:"string",usageLabel:"--config <path>",usageDescription:"Load CLI defaults from a specific config file"},{key:"stateDir",names:["--state-dir"],type:"string",usageLabel:"--state-dir <path>",usageDescription:"Daemon state directory (defaults to ~/.agent-device)"},{key:"daemonBaseUrl",names:["--daemon-base-url"],type:"string",usageLabel:"--daemon-base-url <url>",usageDescription:"Explicit remote HTTP daemon base URL (skip local daemon discovery/startup)"},{key:"daemonAuthToken",names:["--daemon-auth-token"],type:"string",usageLabel:"--daemon-auth-token <token>",usageDescription:"Remote HTTP daemon auth token (sent as request token and bearer header)"},{key:"daemonTransport",names:["--daemon-transport"],type:"enum",enumValues:["auto","socket","http"],usageLabel:"--daemon-transport auto|socket|http",usageDescription:"Daemon client transport preference"},{key:"daemonServerMode",names:["--daemon-server-mode"],type:"enum",enumValues:["socket","http","dual"],usageLabel:"--daemon-server-mode socket|http|dual",usageDescription:"Daemon server mode used when spawning daemon"},{key:"tenant",names:["--tenant"],type:"string",usageLabel:"--tenant <id>",usageDescription:"Tenant scope identifier for isolated daemon sessions"},{key:"sessionIsolation",names:["--session-isolation"],type:"enum",enumValues:["none","tenant"],usageLabel:"--session-isolation none|tenant",usageDescription:"Session isolation strategy (tenant prefixes session namespace)"},{key:"runId",names:["--run-id"],type:"string",usageLabel:"--run-id <id>",usageDescription:"Run identifier used for tenant lease admission checks"},{key:"leaseId",names:["--lease-id"],type:"string",usageLabel:"--lease-id <id>",usageDescription:"Lease identifier bound to tenant/run admission scope"},{key:"sessionLock",names:["--session-lock"],type:"enum",enumValues:["reject","strip"],usageLabel:"--session-lock reject|strip",usageDescription:"Lock bound-session device routing for this CLI invocation and nested batch steps"},{key:"sessionLocked",names:["--session-locked"],type:"boolean",usageLabel:"--session-locked",usageDescription:"Deprecated alias for --session-lock reject"},{key:"sessionLockConflicts",names:["--session-lock-conflicts"],type:"enum",enumValues:["reject","strip"],usageLabel:"--session-lock-conflicts reject|strip",usageDescription:"Deprecated alias for --session-lock"},{key:"platform",names:["--platform"],type:"enum",enumValues:["ios","android","apple"],usageLabel:"--platform ios|android|apple",usageDescription:"Platform to target (`apple` aliases the iOS/tvOS backend)"},{key:"target",names:["--target"],type:"enum",enumValues:["mobile","tv"],usageLabel:"--target mobile|tv",usageDescription:"Device target class to match"},{key:"device",names:["--device"],type:"string",usageLabel:"--device <name>",usageDescription:"Device name to target"},{key:"udid",names:["--udid"],type:"string",usageLabel:"--udid <udid>",usageDescription:"iOS device UDID"},{key:"serial",names:["--serial"],type:"string",usageLabel:"--serial <serial>",usageDescription:"Android device serial"},{key:"headless",names:["--headless"],type:"boolean",usageLabel:"--headless",usageDescription:"Boot: launch Android emulator without a GUI window"},{key:"runtime",names:["--runtime"],type:"string",usageLabel:"--runtime <id>",usageDescription:"ensure-simulator: CoreSimulator runtime identifier (e.g. com.apple.CoreSimulator.SimRuntime.iOS-18-0)"},{key:"metroHost",names:["--metro-host"],type:"string",usageLabel:"--metro-host <host>",usageDescription:"runtime set: session-scoped Metro/debug host hint"},{key:"metroPort",names:["--metro-port"],type:"int",min:1,max:65535,usageLabel:"--metro-port <port>",usageDescription:"runtime set: session-scoped Metro/debug port hint"},{key:"bundleUrl",names:["--bundle-url"],type:"string",usageLabel:"--bundle-url <url>",usageDescription:"runtime set: session-scoped bundle URL hint"},{key:"launchUrl",names:["--launch-url"],type:"string",usageLabel:"--launch-url <url>",usageDescription:"runtime set: session-scoped deep link / launch URL hint"},{key:"boot",names:["--boot"],type:"boolean",usageLabel:"--boot",usageDescription:"ensure-simulator: boot the simulator after ensuring it exists"},{key:"reuseExisting",names:["--reuse-existing"],type:"boolean",usageLabel:"--reuse-existing",usageDescription:"ensure-simulator: reuse an existing simulator (default: true)"},{key:"iosSimulatorDeviceSet",names:["--ios-simulator-device-set"],type:"string",usageLabel:"--ios-simulator-device-set <path>",usageDescription:"Scope iOS simulator discovery/commands to this simulator device set"},{key:"androidDeviceAllowlist",names:["--android-device-allowlist"],type:"string",usageLabel:"--android-device-allowlist <serials>",usageDescription:"Comma/space separated Android serial allowlist for discovery/selection"},{key:"activity",names:["--activity"],type:"string",usageLabel:"--activity <component>",usageDescription:"Android app launch activity (package/Activity); not for URL opens"},{key:"header",names:["--header"],type:"string",multiple:!0,usageLabel:"--header <name:value>",usageDescription:"install-from-source: repeatable HTTP header for URL downloads"},{key:"session",names:["--session"],type:"string",usageLabel:"--session <name>",usageDescription:"Named session"},{key:"count",names:["--count"],type:"int",min:1,max:200,usageLabel:"--count <n>",usageDescription:"Repeat count for press/swipe series"},{key:"fps",names:["--fps"],type:"int",min:1,max:120,usageLabel:"--fps <n>",usageDescription:"Record: target frames per second (iOS physical device runner)"},{key:"intervalMs",names:["--interval-ms"],type:"int",min:0,max:1e4,usageLabel:"--interval-ms <ms>",usageDescription:"Delay between press iterations"},{key:"holdMs",names:["--hold-ms"],type:"int",min:0,max:1e4,usageLabel:"--hold-ms <ms>",usageDescription:"Press hold duration for each iteration"},{key:"jitterPx",names:["--jitter-px"],type:"int",min:0,max:100,usageLabel:"--jitter-px <n>",usageDescription:"Deterministic coordinate jitter radius for press"},{key:"doubleTap",names:["--double-tap"],type:"boolean",usageLabel:"--double-tap",usageDescription:"Use double-tap gesture per press iteration"},{key:"pauseMs",names:["--pause-ms"],type:"int",min:0,max:1e4,usageLabel:"--pause-ms <ms>",usageDescription:"Delay between swipe iterations"},{key:"pattern",names:["--pattern"],type:"enum",enumValues:["one-way","ping-pong"],usageLabel:"--pattern one-way|ping-pong",usageDescription:"Swipe repeat pattern"},{key:"verbose",names:["--debug","--verbose","-v"],type:"boolean",usageLabel:"--debug, --verbose, -v",usageDescription:"Enable debug diagnostics and stream daemon/runner logs"},{key:"json",names:["--json"],type:"boolean",usageLabel:"--json",usageDescription:"JSON output"},{key:"help",names:["--help","-h"],type:"boolean",usageLabel:"--help, -h",usageDescription:"Print help and exit"},{key:"version",names:["--version","-V"],type:"boolean",usageLabel:"--version, -V",usageDescription:"Print version and exit"},{key:"saveScript",names:["--save-script"],type:"booleanOrString",usageLabel:"--save-script [path]",usageDescription:"Save session script (.ad) on close; optional custom output path"},{key:"shutdown",names:["--shutdown"],type:"boolean",usageLabel:"--shutdown",usageDescription:"close: shutdown associated iOS simulator after ending session"},{key:"relaunch",names:["--relaunch"],type:"boolean",usageLabel:"--relaunch",usageDescription:"open: terminate app process before launching it"},{key:"restart",names:["--restart"],type:"boolean",usageLabel:"--restart",usageDescription:"logs clear: stop active stream, clear logs, then start streaming again"},{key:"retainPaths",names:["--retain-paths"],type:"boolean",usageLabel:"--retain-paths",usageDescription:"install-from-source: keep materialized artifact paths after install"},{key:"retentionMs",names:["--retention-ms"],type:"int",min:1,usageLabel:"--retention-ms <ms>",usageDescription:"install-from-source: retention TTL for materialized artifact paths"},{key:"noRecord",names:["--no-record"],type:"boolean",usageLabel:"--no-record",usageDescription:"Do not record this action"},{key:"replayUpdate",names:["--update","-u"],type:"boolean",usageLabel:"--update, -u",usageDescription:"Replay: update selectors and rewrite replay file in place"},{key:"steps",names:["--steps"],type:"string",usageLabel:"--steps <json>",usageDescription:"Batch: JSON array of steps"},{key:"stepsFile",names:["--steps-file"],type:"string",usageLabel:"--steps-file <path>",usageDescription:"Batch: read steps JSON from file"},{key:"batchOnError",names:["--on-error"],type:"enum",enumValues:["stop"],usageLabel:"--on-error stop",usageDescription:"Batch: stop when a step fails"},{key:"batchMaxSteps",names:["--max-steps"],type:"int",min:1,max:1e3,usageLabel:"--max-steps <n>",usageDescription:"Batch: maximum number of allowed steps"},{key:"appsFilter",names:["--user-installed"],type:"enum",setValue:"user-installed",usageLabel:"--user-installed",usageDescription:"Apps: list user-installed apps"},{key:"appsFilter",names:["--all"],type:"enum",setValue:"all",usageLabel:"--all",usageDescription:"Apps: list all apps (include system/default apps)"},{key:"snapshotInteractiveOnly",names:["-i"],type:"boolean",usageLabel:"-i",usageDescription:"Snapshot: interactive elements only"},{key:"snapshotCompact",names:["-c"],type:"boolean",usageLabel:"-c",usageDescription:"Snapshot: compact output (drop empty structure)"},{key:"snapshotDepth",names:["--depth","-d"],type:"int",min:0,usageLabel:"--depth, -d <depth>",usageDescription:"Snapshot: limit snapshot depth"},{key:"snapshotScope",names:["--scope","-s"],type:"string",usageLabel:"--scope, -s <scope>",usageDescription:"Snapshot: scope snapshot to label/identifier"},{key:"snapshotRaw",names:["--raw"],type:"boolean",usageLabel:"--raw",usageDescription:"Snapshot: raw node output"},{key:"out",names:["--out"],type:"string",usageLabel:"--out <path>",usageDescription:"Output path"},{key:"baseline",names:["--baseline","-b"],type:"string",usageLabel:"--baseline, -b <path>",usageDescription:"Diff screenshot: path to baseline image file"},{key:"threshold",names:["--threshold"],type:"string",usageLabel:"--threshold <0-1>",usageDescription:"Diff screenshot: color distance threshold (default 0.1)"}],j=new Set(["json","config","stateDir","daemonBaseUrl","daemonAuthToken","daemonTransport","daemonServerMode","tenant","sessionIsolation","runId","leaseId","sessionLock","sessionLocked","sessionLockConflicts","help","version","verbose","platform","target","device","udid","serial","iosSimulatorDeviceSet","androidDeviceAllowlist","session","noRecord"]),V={boot:{description:"Ensure target device/simulator is booted and ready",positionalArgs:[],allowedFlags:["headless"]},open:{description:"Boot device/simulator; optionally launch app or deep link URL",positionalArgs:["appOrUrl?","url?"],allowedFlags:["activity","saveScript","relaunch"]},close:{description:"Close app or just end session",positionalArgs:["app?"],allowedFlags:["saveScript","shutdown"]},reinstall:{description:"Uninstall + install app from binary path",positionalArgs:["app","path"],allowedFlags:[]},install:{description:"Install app from binary path without uninstalling first",positionalArgs:["app","path"],allowedFlags:[]},"install-from-source":{description:"Install app from a URL source through the normal daemon artifact flow",positionalArgs:["url"],allowedFlags:["header","retainPaths","retentionMs"]},push:{description:"Simulate push notification payload delivery",positionalArgs:["bundleOrPackage","payloadOrJson"],allowedFlags:[]},snapshot:{description:"Capture accessibility tree",positionalArgs:[],allowedFlags:[...P]},diff:{usageOverride:"diff snapshot | diff screenshot --baseline <path> [--out <diff.png>] [--threshold <0-1>]",description:"Diff accessibility snapshot or compare screenshots pixel-by-pixel",positionalArgs:["kind"],allowedFlags:[...P,"baseline","threshold","out"]},"ensure-simulator":{description:"Ensure an iOS simulator exists in a device set (create if missing)",positionalArgs:[],allowedFlags:["runtime","boot","reuseExisting"],skipCapabilityCheck:!0},devices:{description:"List available devices",positionalArgs:[],allowedFlags:[],skipCapabilityCheck:!0},apps:{description:"List installed apps (includes default/system apps by default)",positionalArgs:[],allowedFlags:["appsFilter"],defaults:{appsFilter:"all"}},appstate:{description:"Show foreground app/activity",positionalArgs:[],allowedFlags:[],skipCapabilityCheck:!0},runtime:{usageOverride:"runtime set|show|clear",description:"Manage session-scoped runtime hints",positionalArgs:["set|show|clear"],allowedFlags:["metroHost","metroPort","bundleUrl","launchUrl"],skipCapabilityCheck:!0},clipboard:{usageOverride:"clipboard read | clipboard write <text>",description:"Read or write device clipboard text",positionalArgs:["read|write","text?"],allowsExtraPositionals:!0,allowedFlags:[]},keyboard:{usageOverride:"keyboard [status|get|dismiss]",description:"Inspect Android keyboard visibility/type or dismiss it",positionalArgs:["action?"],allowedFlags:[]},perf:{description:"Show session performance metrics (startup timing)",positionalArgs:[],allowedFlags:[]},back:{description:"Navigate back (where supported)",positionalArgs:[],allowedFlags:[]},home:{description:"Go to home screen (where supported)",positionalArgs:[],allowedFlags:[]},"app-switcher":{description:"Open app switcher (where supported)",positionalArgs:[],allowedFlags:[]},wait:{usageOverride:"wait <ms>|text <text>|@ref|<selector> [timeoutMs]",description:"Wait for duration, text, ref, or selector to appear",positionalArgs:["durationOrSelector","timeoutMs?"],allowsExtraPositionals:!0,allowedFlags:[...R]},alert:{usageOverride:"alert [get|accept|dismiss|wait] [timeout]",description:"Inspect or handle alert (iOS simulator)",positionalArgs:["action?","timeout?"],allowedFlags:[]},click:{usageOverride:"click <x y|@ref|selector>",description:"Tap/click by coordinates, snapshot ref, or selector",positionalArgs:["target"],allowsExtraPositionals:!0,allowedFlags:["count","intervalMs","holdMs","jitterPx","doubleTap",...R]},get:{usageOverride:"get text|attrs <@ref|selector>",description:"Return element text/attributes by ref or selector",positionalArgs:["subcommand","target"],allowedFlags:[...R]},replay:{description:"Replay a recorded session",positionalArgs:["path"],allowedFlags:["replayUpdate"],skipCapabilityCheck:!0},batch:{usageOverride:"batch [--steps <json> | --steps-file <path>]",description:"Execute multiple commands in one daemon request",positionalArgs:[],allowedFlags:["steps","stepsFile","batchOnError","batchMaxSteps","out"],skipCapabilityCheck:!0},press:{usageOverride:"press <x y|@ref|selector>",description:"Tap/press by coordinates, snapshot ref, or selector (supports repeated series)",positionalArgs:["targetOrX","y?"],allowsExtraPositionals:!0,allowedFlags:["count","intervalMs","holdMs","jitterPx","doubleTap",...R]},longpress:{description:"Long press by coordinates (iOS and Android)",positionalArgs:["x","y","durationMs?"],allowedFlags:[]},swipe:{description:"Swipe coordinates with optional repeat pattern",positionalArgs:["x1","y1","x2","y2","durationMs?"],allowedFlags:["count","pauseMs","pattern"]},focus:{description:"Focus input at coordinates",positionalArgs:["x","y"],allowedFlags:[]},type:{description:"Type text in focused field",positionalArgs:["text"],allowsExtraPositionals:!0,allowedFlags:[]},fill:{usageOverride:"fill <x> <y> <text> | fill <@ref|selector> <text>",description:"Tap then type",positionalArgs:["targetOrX","yOrText","text?"],allowsExtraPositionals:!0,allowedFlags:[...R]},scroll:{description:"Scroll in direction (0-1 amount)",positionalArgs:["direction","amount?"],allowedFlags:[]},scrollintoview:{usageOverride:"scrollintoview <text|@ref>",description:"Scroll until text appears or a snapshot ref is brought into view",positionalArgs:["target"],allowsExtraPositionals:!0,allowedFlags:[]},pinch:{description:"Pinch/zoom gesture (iOS simulator)",positionalArgs:["scale","x?","y?"],allowedFlags:[]},screenshot:{description:"Capture screenshot",positionalArgs:["path?"],allowedFlags:["out"]},"trigger-app-event":{usageOverride:"trigger-app-event <event> [payloadJson]",description:"Trigger app-defined event hook via deep link template",positionalArgs:["event","payloadJson?"],allowedFlags:[]},record:{usageOverride:"record start [path] [--fps <n>] | record stop",description:"Start/stop screen recording",positionalArgs:["start|stop","path?"],allowedFlags:["fps"]},trace:{usageOverride:"trace start [path] | trace stop [path]",description:"Start/stop trace log capture",positionalArgs:["start|stop","path?"],allowedFlags:[],skipCapabilityCheck:!0},logs:{usageOverride:"logs path | logs start | logs stop | logs clear [--restart] | logs doctor | logs mark [message...]",description:"Session app log info, start/stop streaming, diagnostics, and markers",positionalArgs:["path|start|stop|clear|doctor|mark","message?"],allowsExtraPositionals:!0,allowedFlags:["restart"]},network:{usageOverride:"network dump [limit] [summary|headers|body|all] | network log [limit] [summary|headers|body|all]",description:"Dump recent HTTP(s) traffic parsed from the session app log",positionalArgs:["dump|log","limit?","include?"],allowedFlags:[]},find:{usageOverride:"find <locator|text> <action> [value]",description:"Find by text/label/value/role/id and run action",positionalArgs:["query","action","value?"],allowsExtraPositionals:!0,allowedFlags:["snapshotDepth","snapshotRaw"]},is:{description:"Assert UI state (visible|hidden|exists|editable|selected|text)",positionalArgs:["predicate","selector","value?"],allowsExtraPositionals:!0,allowedFlags:[...R]},settings:{usageOverride:s,description:"Toggle OS settings, appearance, and app permissions (session app scope for permission actions)",positionalArgs:["setting","state","target?","mode?"],allowedFlags:[]},session:{usageOverride:"session list",description:"List active sessions",positionalArgs:["list?"],allowedFlags:[],skipCapabilityCheck:!0}},T=new Map,M=new Map;for(let e of C){for(let t of e.names)T.set(t,e);let t=M.get(e.key);t?t.push(e):M.set(e.key,[e])}function G(e){if(e)return V[e]}function U(){return Object.keys(V)}function B(e){let t=e.endsWith("?"),s=t?e.slice(0,-1):e;return t?`[${s}]`:`<${s}>`}function q(e,t){return t.usageOverride?t.usageOverride:[e,...t.positionalArgs.map(B),...t.allowedFlags.flatMap(e=>(M.get(e)??[]).map(e=>e.usageLabel??e.names[0])).map(e=>`[${e}]`)].join(" ")}let J=function(){let e=`agent-device <command> [args] [--json]
 
 CLI to control iOS and Android devices for AI agents.
-`,t=G().map(e=>{let t=R[e];if(!t)throw Error(`Missing command schema for ${e}`);return{name:e,schema:t,usage:B(e,t)}}),s=Math.max(...t.map(e=>e.usage.length))+2,i=["Commands:"];for(let e of t)i.push(`  ${e.usage.padEnd(s)}${e.schema.description}`);let o=W("Flags:",j.filter(e=>e.usageLabel&&e.usageDescription));return`${e}
+`,t=U().map(e=>{let t=V[e];if(!t)throw Error(`Missing command schema for ${e}`);return{name:e,schema:t,usage:q(e,t)}}),s=Math.max(...t.map(e=>e.usage.length))+2,i=["Commands:"];for(let e of t)i.push(`  ${e.usage.padEnd(s)}${e.schema.description}`);let a=z("Flags:",C.filter(e=>e.usageLabel&&e.usageDescription));return`${e}
 ${i.join("\n")}
 
-${o}
-`}();function J(e){return j.filter(t=>e.has(t.key)&&void 0!==t.usageLabel&&void 0!==t.usageDescription)}function W(e,t){if(0===t.length)return`${e}
-  (none)`;let s=Math.max(...t.map(e=>(e.usageLabel??"").length))+2,i=[e];for(let e of t)i.push(`  ${(e.usageLabel??"").padEnd(s)}${e.usageDescription??""}`);return i.join("\n")}let z=new Set(["config","help","version","batchSteps"]),H={iosSimulatorDeviceSet:["IOS_SIMULATOR_DEVICE_SET"],androidDeviceAllowlist:["ANDROID_DEVICE_ALLOWLIST"]},K=new Set(["1","true","yes","on"]),Z=new Set(["0","false","no","off"]),X=function(){let e=new Map;for(let t of j){let s=e.get(t.key);s?s.push(t):e.set(t.key,[t])}let t=new Map;for(let e of P)t.set(e,new Set(["*"]));for(let e of G()){let s=M(e);if(s)for(let i of s.allowedFlags){let s=t.get(i);s&&s.has("*")||(s?s.add(e):t.set(i,new Set([e])))}}return[...e.entries()].map(([e,s])=>{var i;return{key:e,flagDefinitions:s,config:{enabled:!z.has(e),key:e},env:{names:[(i=e,`AGENT_DEVICE_${i.replace(/([A-Z])/g,"_$1").replace(/[^A-Za-z0-9_]/g,"_").toUpperCase()}`),...H[e]??[]]},supportsCommand(s){let i=t.get(e);return!!i&&(!!i.has("*")||!!s&&i.has(s))}}}).sort((e,t)=>e.key.localeCompare(t.key))}(),Y=new Map(X.map(e=>[e.key,e]));function Q(e,t){return Y.get(e)?.supportsCommand(t)??!1}function ee(e,t,s,i){let o=function(e){let t=e.flagDefinitions.find(e=>void 0===e.setValue);if(t)return t;let s=function(e){let t=e.flagDefinitions[0];if(!t)throw Error(`Missing flag definition for option ${e.key}`);return t}(e);if("enum"===s.type){let t=e.flagDefinitions.map(e=>e.setValue).filter(e=>void 0!==e);return{...s,setValue:void 0,enumValues:t}}return s}(e);if("boolean"===o.type){var a=t,r=s,n=i;if("boolean"==typeof a)return a;if("string"==typeof a){let e=et(a);if(void 0!==e)return e}throw new y("INVALID_ARGS",`Invalid value for "${n}" in ${r}. Expected boolean.`)}if("booleanOrString"===o.type){if("boolean"==typeof t)return t;if("string"==typeof t&&void 0!==et(t))return et(t);if("string"==typeof t&&t.trim().length>0)return t;throw new y("INVALID_ARGS",`Invalid value for "${i}" in ${s}. Expected boolean or non-empty string.`)}if("string"===o.type){if("string"==typeof t&&t.trim().length>0)return t;throw new y("INVALID_ARGS",`Invalid value for "${i}" in ${s}. Expected non-empty string.`)}if("enum"===o.type){if(void 0!==o.setValue){var l=o,d=t,p=s,u=i;let e=l.setValue;if(d===e)return e;if("string"==typeof d){let t=d.trim();if(""===t||"true"===t||"1"===t)return e;if("false"===t||"0"===t)return}if(!0===d)return e;if(!1!==d)throw new y("INVALID_ARGS",`Invalid value for "${u}" in ${p}. Expected boolean or ${String(e)}.`);return}if("string"!=typeof t||!o.enumValues?.includes(t))throw new y("INVALID_ARGS",`Invalid value for "${i}" in ${s}. Expected one of: ${o.enumValues?.join(", ")}.`);return t}let c="number"==typeof t?t:"string"==typeof t?Number(t):NaN;if(!Number.isFinite(c)||!Number.isInteger(c))throw new y("INVALID_ARGS",`Invalid value for "${i}" in ${s}. Expected integer.`);if("number"==typeof o.min&&c<o.min)throw new y("INVALID_ARGS",`Invalid value for "${i}" in ${s}. Must be >= ${o.min}.`);if("number"==typeof o.max&&c>o.max)throw new y("INVALID_ARGS",`Invalid value for "${i}" in ${s}. Must be <= ${o.max}.`);return c}function et(e){let t=e.trim().toLowerCase();return!!K.has(t)||!Z.has(t)&&void 0}function es(e){let t=e.indexOf("=");return -1===t?[e,void 0]:[e.slice(0,t),e.slice(t+1)]}function ei(e){return e.replace(/^-+/,"")}function eo(e){if(!e.startsWith("-")||"-"===e)return!1;let[t]=e.startsWith("--")?es(e):[e,void 0];return void 0!==V.get(t)}function ea(e){return"long-press"===e?"longpress":"metrics"===e?"perf":e}function er(e,t){for(let[s,i]of Object.entries(t))void 0!==i&&(e[s]=i);return e}function en(e){process.stdout.write(`${JSON.stringify(e,null,2)}
-`)}function el(e,t={}){let s=e instanceof y?l(e):e;process.stderr.write(`Error (${s.code}): ${s.message}
+${a}
+`}();function W(e){return C.filter(t=>e.has(t.key)&&void 0!==t.usageLabel&&void 0!==t.usageDescription)}function z(e,t){if(0===t.length)return`${e}
+  (none)`;let s=Math.max(...t.map(e=>(e.usageLabel??"").length))+2,i=[e];for(let e of t)i.push(`  ${(e.usageLabel??"").padEnd(s)}${e.usageDescription??""}`);return i.join("\n")}let H=new Set(["config","help","version","batchSteps"]),K={iosSimulatorDeviceSet:["IOS_SIMULATOR_DEVICE_SET"],androidDeviceAllowlist:["ANDROID_DEVICE_ALLOWLIST"]},Z=new Set(["1","true","yes","on"]),X=new Set(["0","false","no","off"]),Y=function(){let e=new Map;for(let t of C){let s=e.get(t.key);s?s.push(t):e.set(t.key,[t])}let t=new Map;for(let e of j)t.set(e,new Set(["*"]));for(let e of U()){let s=G(e);if(s)for(let i of s.allowedFlags){let s=t.get(i);s&&s.has("*")||(s?s.add(e):t.set(i,new Set([e])))}}return[...e.entries()].map(([e,s])=>{var i;return{key:e,flagDefinitions:s,config:{enabled:!H.has(e),key:e},env:{names:[(i=e,`AGENT_DEVICE_${i.replace(/([A-Z])/g,"_$1").replace(/[^A-Za-z0-9_]/g,"_").toUpperCase()}`),...K[e]??[]]},supportsCommand(s){let i=t.get(e);return!!i&&(!!i.has("*")||!!s&&i.has(s))}}}).sort((e,t)=>e.key.localeCompare(t.key))}(),Q=new Map(Y.map(e=>[e.key,e]));function ee(e,t){return Q.get(e)?.supportsCommand(t)??!1}function et(e,t,s,i){let a=function(e){let t=e.flagDefinitions.find(e=>void 0===e.setValue);if(t)return t;let s=function(e){let t=e.flagDefinitions[0];if(!t)throw Error(`Missing flag definition for option ${e.key}`);return t}(e);if("enum"===s.type){let t=e.flagDefinitions.map(e=>e.setValue).filter(e=>void 0!==e);return{...s,setValue:void 0,enumValues:t}}return s}(e);if(a.multiple)return(Array.isArray(t)?t:[t]).map(t=>et({...e,flagDefinitions:e.flagDefinitions.map(e=>({...e,multiple:!1}))},t,s,i));if("boolean"===a.type){var r=t,o=s,n=i;if("boolean"==typeof r)return r;if("string"==typeof r){let e=es(r);if(void 0!==e)return e}throw new y("INVALID_ARGS",`Invalid value for "${n}" in ${o}. Expected boolean.`)}if("booleanOrString"===a.type){if("boolean"==typeof t)return t;if("string"==typeof t&&void 0!==es(t))return es(t);if("string"==typeof t&&t.trim().length>0)return t;throw new y("INVALID_ARGS",`Invalid value for "${i}" in ${s}. Expected boolean or non-empty string.`)}if("string"===a.type){if("string"==typeof t&&t.trim().length>0)return t;throw new y("INVALID_ARGS",`Invalid value for "${i}" in ${s}. Expected non-empty string.`)}if("enum"===a.type){if(void 0!==a.setValue){var l=a,d=t,p=s,u=i;let e=l.setValue;if(d===e)return e;if("string"==typeof d){let t=d.trim();if(""===t||"true"===t||"1"===t)return e;if("false"===t||"0"===t)return}if(!0===d)return e;if(!1!==d)throw new y("INVALID_ARGS",`Invalid value for "${u}" in ${p}. Expected boolean or ${String(e)}.`);return}if("string"!=typeof t||!a.enumValues?.includes(t))throw new y("INVALID_ARGS",`Invalid value for "${i}" in ${s}. Expected one of: ${a.enumValues?.join(", ")}.`);return t}let c="number"==typeof t?t:"string"==typeof t?Number(t):NaN;if(!Number.isFinite(c)||!Number.isInteger(c))throw new y("INVALID_ARGS",`Invalid value for "${i}" in ${s}. Expected integer.`);if("number"==typeof a.min&&c<a.min)throw new y("INVALID_ARGS",`Invalid value for "${i}" in ${s}. Must be >= ${a.min}.`);if("number"==typeof a.max&&c>a.max)throw new y("INVALID_ARGS",`Invalid value for "${i}" in ${s}. Must be <= ${a.max}.`);return c}function es(e){let t=e.trim().toLowerCase();return!!Z.has(t)||!X.has(t)&&void 0}function ei(e){let t=e.indexOf("=");return -1===t?[e,void 0]:[e.slice(0,t),e.slice(t+1)]}function ea(e){return e.replace(/^-+/,"")}function er(e){if(!e.startsWith("-")||"-"===e)return!1;let[t]=e.startsWith("--")?ei(e):[e,void 0];return void 0!==T.get(t)}function eo(e){return"long-press"===e?"longpress":"metrics"===e?"perf":e}function en(e,t){for(let[s,i]of Object.entries(t))void 0!==i&&(e[s]=i);return e}function el(e){process.stdout.write(`${JSON.stringify(e,null,2)}
+`)}function ed(e,t={}){let s=e instanceof y?l(e):e;process.stderr.write(`Error (${s.code}): ${s.message}
 `),s.hint&&process.stderr.write(`Hint: ${s.hint}
 `),s.diagnosticId&&process.stderr.write(`Diagnostic ID: ${s.diagnosticId}
 `),s.logPath&&process.stderr.write(`Diagnostics Log: ${s.logPath}
 `),t.showDetails&&s.details&&process.stderr.write(`${JSON.stringify(s.details,null,2)}
-`)}function ed(e,s={}){let i=e.nodes,o=Array.isArray(i)?i:[],r=!!e.truncated,n="string"==typeof e.appName?e.appName:void 0,l="string"==typeof e.appBundleId?e.appBundleId:void 0,d=[];n&&d.push(`Page: ${n}`),l&&d.push(`App: ${l}`);let p=`Snapshot: ${o.length} nodes${r?" (truncated)":""}`,u=d.length>0?`${d.join("\n")}
-`:"";if(0===o.length)return`${u}${p}
-`;if(s.raw){let e=o.map(e=>JSON.stringify(e));return`${u}${p}
+`)}function ep(e,s={}){let i=e.nodes,a=Array.isArray(i)?i:[],o=!!e.truncated,n="string"==typeof e.appName?e.appName:void 0,l="string"==typeof e.appBundleId?e.appBundleId:void 0,d=[];n&&d.push(`Page: ${n}`),l&&d.push(`App: ${l}`);let p=`Snapshot: ${a.length} nodes${o?" (truncated)":""}`,u=d.length>0?`${d.join("\n")}
+`:"";if(0===a.length)return`${u}${p}
+`;if(s.raw){let e=a.map(e=>JSON.stringify(e));return`${u}${p}
 ${e.join("\n")}
-`}if(s.flatten){let e=o.map(e=>t(e,0,!1));return`${u}${p}
+`}if(s.flatten){let e=a.map(e=>t(e,0,!1));return`${u}${p}
 ${e.join("\n")}
-`}let c=a(o).map(e=>e.text);return`${u}${p}
+`}let c=r(a).map(e=>e.text);return`${u}${p}
 ${c.join("\n")}
-`}function ep(e){return"number"==typeof e&&Number.isFinite(e)?e:0}function eu(){let e=process.env.FORCE_COLOR;return"string"==typeof e?"0"!==e:"string"!=typeof process.env.NO_COLOR&&!!process.stdout.isTTY}let ec=255*Math.sqrt(3);async function eg(t,s,i={}){await ef(t,"Baseline image not found"),await ef(s,"Current screenshot not found");let o=i.outputPath,[a,r]=await Promise.all([g.readFile(t),g.readFile(s)]),l=em(a,"baseline"),d=em(r,"current"),p=i.threshold??.1;if(l.width!==d.width||l.height!==d.height){let e=l.width*l.height;return await eh(i.outputPath),{match:!1,mismatchPercentage:100,totalPixels:e,differentPixels:e,dimensionMismatch:{expected:{width:l.width,height:l.height},actual:{width:d.width,height:d.height}}}}let u=l.width*l.height,c=p*ec,f=new e({width:l.width,height:l.height}),m=0;for(let e=0;e<l.data.length;e+=4){if(Math.sqrt((l.data[e]-d.data[e])**2+(l.data[e+1]-d.data[e+1])**2+(l.data[e+2]-d.data[e+2])**2)>c){m+=1,f.data[e]=255,f.data[e+1]=0,f.data[e+2]=0,f.data[e+3]=255;continue}let t=Math.round(.3*Math.round((l.data[e]+l.data[e+1]+l.data[e+2])/3));f.data[e]=t,f.data[e+1]=t,f.data[e+2]=t,f.data[e+3]=255}m>0&&o?(await g.mkdir(n.dirname(o),{recursive:!0}),await g.writeFile(o,e.sync.write(f))):await eh(i.outputPath);let h=u>0?Math.round(m/u*1e4)/100:0;return{...m>0&&o?{diffPath:o}:{},totalPixels:u,differentPixels:m,mismatchPercentage:h,match:0===m}}async function ef(e,t){try{await g.access(e)}catch{throw new y("INVALID_ARGS",`${t}: ${e}`)}}function em(t,s){try{return e.sync.read(t)}catch(e){throw new y("COMMAND_FAILED",`Failed to decode ${s} screenshot as PNG`,{label:s,reason:e instanceof Error?e.message:String(e)})}}async function eh(e){if(e)try{await g.unlink(e)}catch(e){var t;if(!("object"==typeof(t=e)&&null!==t&&"code"in t&&"ENOENT"===t.code))throw e}}async function ey(e){let t=ew[e.command];return!!t&&await t(e)}let ew={session:async({positionals:e,flags:t,client:s})=>{if("list"!==(e[0]??"list"))throw new y("INVALID_ARGS","session only supports list");let i={sessions:(await s.sessions.list()).map(D)};return t.json?en({success:!0,data:i}):process.stdout.write(`${JSON.stringify(i,null,2)}
-`),!0},devices:async({flags:e,client:t})=>{let s=await t.devices.list(e$(e)),i={devices:s.map(_)};return e.json?en({success:!0,data:i}):process.stdout.write(`${s.map(ek).join("\n")}
-`),!0},"ensure-simulator":async({flags:e,client:t})=>{if(!e.device)throw new y("INVALID_ARGS","ensure-simulator requires --device <name>");let s=await t.simulators.ensure({device:e.device,runtime:e.runtime,boot:e.boot,reuseExisting:e.reuseExisting,iosSimulatorDeviceSet:e.iosSimulatorDeviceSet}),i=O(s);if(e.json)en({success:!0,data:i});else{let e=s.created?"Created":"Reused",t=s.booted?" (booted)":"";process.stdout.write(`${e}: ${s.device} ${s.udid}${t}
+`}function eu(e){return"number"==typeof e&&Number.isFinite(e)?e:0}function ec(){let e=process.env.FORCE_COLOR;return"string"==typeof e?"0"!==e:"string"!=typeof process.env.NO_COLOR&&!!process.stdout.isTTY}let eg=255*Math.sqrt(3);async function ef(t,s,i={}){await em(t,"Baseline image not found"),await em(s,"Current screenshot not found");let a=i.outputPath,[r,o]=await Promise.all([g.readFile(t),g.readFile(s)]),l=eh(r,"baseline"),d=eh(o,"current"),p=i.threshold??.1;if(l.width!==d.width||l.height!==d.height){let e=l.width*l.height;return await ey(i.outputPath),{match:!1,mismatchPercentage:100,totalPixels:e,differentPixels:e,dimensionMismatch:{expected:{width:l.width,height:l.height},actual:{width:d.width,height:d.height}}}}let u=l.width*l.height,c=p*eg,f=new e({width:l.width,height:l.height}),m=0;for(let e=0;e<l.data.length;e+=4){if(Math.sqrt((l.data[e]-d.data[e])**2+(l.data[e+1]-d.data[e+1])**2+(l.data[e+2]-d.data[e+2])**2)>c){m+=1,f.data[e]=255,f.data[e+1]=0,f.data[e+2]=0,f.data[e+3]=255;continue}let t=Math.round(.3*Math.round((l.data[e]+l.data[e+1]+l.data[e+2])/3));f.data[e]=t,f.data[e+1]=t,f.data[e+2]=t,f.data[e+3]=255}m>0&&a?(await g.mkdir(n.dirname(a),{recursive:!0}),await g.writeFile(a,e.sync.write(f))):await ey(i.outputPath);let h=u>0?Math.round(m/u*1e4)/100:0;return{...m>0&&a?{diffPath:a}:{},totalPixels:u,differentPixels:m,mismatchPercentage:h,match:0===m}}async function em(e,t){try{await g.access(e)}catch{throw new y("INVALID_ARGS",`${t}: ${e}`)}}function eh(t,s){try{return e.sync.read(t)}catch(e){throw new y("COMMAND_FAILED",`Failed to decode ${s} screenshot as PNG`,{label:s,reason:e instanceof Error?e.message:String(e)})}}async function ey(e){if(e)try{await g.unlink(e)}catch(e){var t;if(!("object"==typeof(t=e)&&null!==t&&"code"in t&&"ENOENT"===t.code))throw e}}async function ew(e){let t=ev[e.command];return!!t&&await t(e)}let ev={session:async({positionals:e,flags:t,client:s})=>{if("list"!==(e[0]??"list"))throw new y("INVALID_ARGS","session only supports list");let i={sessions:(await s.sessions.list()).map(D)};return t.json?el({success:!0,data:i}):process.stdout.write(`${JSON.stringify(i,null,2)}
+`),!0},devices:async({flags:e,client:t})=>{let s=await t.devices.list(eA(e)),i={devices:s.map(_)};return e.json?el({success:!0,data:i}):process.stdout.write(`${s.map(eS).join("\n")}
+`),!0},"ensure-simulator":async({flags:e,client:t})=>{if(!e.device)throw new y("INVALID_ARGS","ensure-simulator requires --device <name>");let s=await t.simulators.ensure({device:e.device,runtime:e.runtime,boot:e.boot,reuseExisting:e.reuseExisting,iosSimulatorDeviceSet:e.iosSimulatorDeviceSet}),i=O(s);if(e.json)el({success:!0,data:i});else{let e=s.created?"Created":"Reused",t=s.booted?" (booted)":"";process.stdout.write(`${e}: ${s.device} ${s.udid}${t}
 `),s.runtime&&process.stdout.write(`Runtime: ${s.runtime}
-`)}return!0},runtime:async({positionals:e,flags:t,client:s})=>{let i=(e[0]??"show").toLowerCase();return"set"===i?(eb(await s.runtime.set({platform:t.platform,metroHost:t.metroHost,metroPort:t.metroPort,bundleUrl:t.bundleUrl,launchUrl:t.launchUrl}),t),!0):"show"===i&&(eb(await s.runtime.show(),t),!0)},install:async({positionals:e,flags:t,client:s})=>{let i=await ev("install",e,t,s);return t.json&&en({success:!0,data:I(i)}),!0},reinstall:async({positionals:e,flags:t,client:s})=>{let i=await ev("reinstall",e,t,s);return t.json&&en({success:!0,data:I(i)}),!0},open:async({positionals:e,flags:t,client:s})=>{if(!e[0])return!1;let i=await s.apps.open({app:e[0],url:e[1],activity:t.activity,relaunch:t.relaunch,saveScript:t.saveScript,noRecord:t.noRecord,...e$(t)});return t.json&&en({success:!0,data:S(i)}),!0},close:async({positionals:e,flags:t,client:s})=>{let i=e[0]?await s.apps.close({app:e[0],shutdown:t.shutdown}):await s.sessions.close({shutdown:t.shutdown});return t.json&&en({success:!0,data:x(i)}),!0},snapshot:async({flags:e,client:t})=>{let s=L(await t.capture.snapshot({...e$(e),interactiveOnly:e.snapshotInteractiveOnly,compact:e.snapshotCompact,depth:e.snapshotDepth,scope:e.snapshotScope,raw:e.snapshotRaw}));return e.json?en({success:!0,data:s}):process.stdout.write(ed(s,{raw:e.snapshotRaw,flatten:e.snapshotInteractiveOnly})),!0},screenshot:async({positionals:e,flags:t,client:s})=>{let i=await s.capture.screenshot({path:e[0]??t.out}),o={path:i.path};return t.json?en({success:!0,data:o}):process.stdout.write(`${i.path}
-`),!0},diff:async({positionals:e,flags:t,client:s})=>{let o;if("screenshot"!==e[0])return!1;let a=t.baseline;if(!a||"string"!=typeof a)throw new y("INVALID_ARGS","diff screenshot requires --baseline <path>");let r=d(a),l="string"==typeof t.out?d(t.out):void 0,p=.1;if(null!=t.threshold&&""!==t.threshold&&(Number.isNaN(p=Number(t.threshold))||p<0||p>1))throw new y("INVALID_ARGS","--threshold must be a number between 0 and 1");let u=w.mkdtempSync(n.join(v.tmpdir(),"agent-device-diff-current-")),c=n.join(u,`current-${Date.now()}.png`),g=(await s.capture.screenshot({path:c})).path;try{o=await eg(r,g,{threshold:p,outputPath:l})}finally{try{w.unlinkSync(g)}catch{}try{w.rmSync(u,{recursive:!0,force:!0})}catch{}}return t.json?en({success:!0,data:o}):process.stdout.write(function(e){var t,s;let o=eu(),a=!0===e.match,r=ep(e.differentPixels),l=ep(e.totalPixels),d=ep(e.mismatchPercentage),p=e.diffPath,u=e.dimensionMismatch,c=[];if(a){let e=o?i("green","✓"):"✓";c.push(`${e} Screenshots match.`)}else if(u){let e=o?i("red","✗"):"✗",t=u.expected,s=u.actual;c.push(`${e} Screenshots have different dimensions: expected ${t?.width}x${t?.height}, got ${s?.width}x${s?.height}`)}else{let e=o?i("red","✗"):"✗",t=0===d&&r>0?"<0.01":String(d);c.push(`${e} ${t}% pixels differ`)}if(p&&!a){let e,s,a=(t=p,e=process.cwd(),""!==(s=n.relative(e,t))&&(s.startsWith("..")||n.isAbsolute(s))?t:""===s?".":`.${n.sep}${s}`),r=o?i("dim","Diff image:"):"Diff image:",l=o?i("green",a):a;c.push(`  ${r} ${l}`)}if(!a&&!u){let e=o?(s=String(r),i("red",s)):String(r);c.push(`  ${e} different / ${l} total pixels`)}return`${c.join("\n")}
-`}(o)),!0}};async function ev(e,t,s,i){let o=t[0],a=t[1];if(!o||!a)throw new y("INVALID_ARGS",`${e} requires: ${e} <app> <path-to-app-binary>`);let r={app:o,appPath:a,...e$(s)};return"install"===e?await i.apps.install(r):await i.apps.reinstall(r)}function eb(e,t){let s=N(e);t.json?en({success:!0,data:s}):e.configured?process.stdout.write(`${JSON.stringify(e.runtime??{},null,2)}
-`):process.stdout.write("No runtime hints configured\n")}function e$(e){return{platform:e.platform,target:e.target,device:e.device,udid:e.udid,serial:e.serial,iosSimulatorDeviceSet:e.iosSimulatorDeviceSet,androidDeviceAllowlist:e.androidDeviceAllowlist}}function ek(e){let t=e.kind?` ${e.kind}`:"",s=e.target?` target=${e.target}`:"",i="boolean"==typeof e.booted?` booted=${e.booted}`:"";return`${e.name} (${e.platform}${t}${s})${i}`}function eS(e,t={}){let s=eA(t),i={...e};return s.defaultPlatform&&void 0===i.platform&&(i.platform=s.defaultPlatform),i}function eA(e){var t,s,i,o;let a,r=e.env??process.env,n=e.inheritedPlatform??e.configuredPlatform??function(e){if(void 0===e)return;let t=e.trim().toLowerCase();if(t){if("ios"===t||"android"===t||"apple"===t)return t;throw new y("INVALID_ARGS",`Invalid AGENT_DEVICE_PLATFORM: ${e}. Use ios, android, or apple.`)}}(r.AGENT_DEVICE_PLATFORM),l="string"==typeof(t=e.configuredSession??r.AGENT_DEVICE_SESSION)&&t.trim().length>0;return{defaultPlatform:n,lockPolicy:(s=e.policyOverrides,i=r,o=l,(a=s?.sessionLock??s?.sessionLockConflicts??eD(i.AGENT_DEVICE_SESSION_LOCK)??eD(i.AGENT_DEVICE_SESSION_LOCK_CONFLICTS))||(s?.sessionLocked===!0||function(e){if(!e)return!1;switch(e.trim().toLowerCase()){case"1":case"true":case"yes":case"on":return!0;default:return!1}}(i.AGENT_DEVICE_SESSION_LOCKED)||o?"reject":void 0))}}function eD(e){if(void 0===e)return;let t=e.trim().toLowerCase();if(t){if("reject"===t||"strip"===t)return t;throw new y("INVALID_ARGS",`Invalid session lock mode: ${e}. Use reject or strip.`)}}function eI(e,t){for(let[s,i]of Object.entries(t))void 0!==i&&(e[s]=i);return e}let eL={sendToDaemon:A};async function ex(e,t=eL){let s=r(),a=e.includes("--debug")||e.includes("--verbose")||e.includes("-v"),g=e.includes("--json"),h=function(e){for(let t=0;t<e.length;t+=1){let s=e[t];if(s.startsWith("--session=")){let e=s.slice(10).trim();return e.length>0?e:null}if("--session"===s){let s=e[t+1]?.trim();if(s&&!s.startsWith("-"))return s;break}}return null}(e)??process.env.AGENT_DEVICE_SESSION??"default";await b({session:h,requestId:s,command:e[0],debug:a},async()=>{var r,h,v,b,S,A,D,I,L,x,N;let O;try{let t,s,i,o,a,l,p;r={cwd:process.cwd(),env:process.env},t=function(e){let t={json:!1,help:!1,version:!1},s=null,i=[],o=[],a=!0;for(let r=0;r<e.length;r+=1){let n=e[r];if(a&&"--"===n){a=!1;continue}if(!a){s?i.push(n):s=ea(n);continue}let l=n.startsWith("--"),d=n.startsWith("-")&&n.length>1;if(!l&&!d){s?i.push(n):s=ea(n);continue}let[p,u]=l?es(n):[n,void 0],c=V.get(p);if(!c){if(function(e,t,s){var i;if(i=s,!/^-\d+(\.\d+)?$/.test(i)||!e)return!1;let o=M(e);return!o||!!o.allowsExtraPositionals||0!==o.positionalArgs.length&&(t.length<o.positionalArgs.length||o.positionalArgs.some(e=>e.includes("?")))}(s,i,n)){s?i.push(n):s=n;continue}throw new y("INVALID_ARGS",`Unknown flag: ${p}`)}let g=function(e,t,s,i){if(void 0!==e.setValue){if(void 0!==s)throw new y("INVALID_ARGS",`Flag ${t} does not take a value.`);return{value:e.setValue,consumeNext:!1}}if("boolean"===e.type){if(void 0!==s)throw new y("INVALID_ARGS",`Flag ${t} does not take a value.`);return{value:!0,consumeNext:!1}}if("booleanOrString"===e.type){if(void 0!==s){if(0===s.trim().length)throw new y("INVALID_ARGS",`Flag ${t} requires a non-empty value when provided.`);return{value:s,consumeNext:!1}}return void 0===i||eo(i)||!function(e){let t=e.trim();return!(!t||/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(t))&&!!(t.startsWith("./")||t.startsWith("../")||t.startsWith("~/")||t.startsWith("/")||t.includes("/")||t.includes("\\"))}(i)?{value:!0,consumeNext:!1}:{value:i,consumeNext:!0}}let o=s??i;if(void 0===o||void 0===s&&eo(o))throw new y("INVALID_ARGS",`Flag ${t} requires a value.`);if("string"===e.type)return{value:o,consumeNext:void 0===s};if("enum"===e.type){if(!e.enumValues?.includes(o))throw new y("INVALID_ARGS",`Invalid ${ei(t)}: ${o}`);return{value:o,consumeNext:void 0===s}}let a=Number(o);if(!Number.isFinite(a)||"number"==typeof e.min&&a<e.min||"number"==typeof e.max&&a>e.max)throw new y("INVALID_ARGS",`Invalid ${ei(t)}: ${o}`);return{value:Math.floor(a),consumeNext:void 0===s}}(c,p,u,e[r+1]);g.consumeNext&&(r+=1),t[c.key]=g.value,o.push({key:c.key,token:p})}return{command:s,positionals:i,flags:t,warnings:[],providedFlags:o}}(e),s=r?.env??process.env,i=r?.cwd??process.cwd(),o=(h={command:t.command,cwd:i,cliFlags:t.flags,env:s}).env??process.env,a=eI({},function(e){let t={};for(let s of e)eI(t,function(e,t){let s,i;if(!w.existsSync(e)){if(t)throw new y("INVALID_ARGS",`Config file not found: ${e}`);return{}}try{s=w.readFileSync(e,"utf8")}catch(t){throw new y("INVALID_ARGS",`Failed to read config file: ${e}`,{cause:t instanceof Error?t.message:String(t)})}try{i=JSON.parse(s)}catch(t){throw new y("INVALID_ARGS",`Invalid JSON in config file: ${e}`,{cause:t instanceof Error?t.message:String(t)})}if(!i||"object"!=typeof i||Array.isArray(i))throw new y("INVALID_ARGS",`Config file must contain a JSON object: ${e}`);return function(e,t){let s={};for(let[i,o]of Object.entries(e)){let e=Y.get(i);if(!e)throw new y("INVALID_ARGS",`Unknown config key "${i}" in ${t}.`);if(!e.config.enabled)throw new y("INVALID_ARGS",`Unsupported config key "${i}" in ${t}.`);s[i]=ee(e,o,t,i)}return s}(i,`config file ${e}`)}(s.path,s.required));return t}((v=h.cwd,b=h.cliFlags.config,S=o,(p=b??S.AGENT_DEVICE_CONFIG)?[{path:(A=p,D=v,I=S,d(A,{cwd:D,env:I})),required:!0}]:[{path:(L=S,n.join(m("~",{env:L}),".agent-device","config.json")),required:!1},{path:n.resolve(v,"agent-device.json"),required:!1}]))),l=eI(a,function(e,t){let s={};for(let i of X.filter(e=>e.config.enabled&&e.supportsCommand(t))){let t=i.env.names.map(t=>({name:t,value:e[t]})).find(e=>"string"==typeof e.value&&e.value.trim().length>0);t&&(s[i.key]=ee(i,t.value,`environment variable ${t.name}`,t.name))}return s}(o,h.command)),O=function(e,t){let s=t?.strictFlags??function(e){if(!e)return!1;let t=e.trim().toLowerCase();return"1"===t||"true"===t||"yes"===t||"on"===t}(process.env.AGENT_DEVICE_STRICT_FLAGS),i=[...e.warnings],o=er({json:!1,help:!1,version:!1},t?.defaultFlags??{});er(o,e.flags);let a=M(e.command),r=e.providedFlags.filter(t=>!Q(t.key,e.command));if(r.length>0){var n,l;let t=r.map(e=>e.token),a=(n=e.command,l=t,n?1===l.length?`Flag ${l[0]} is not supported for command ${n}.`:`Flags ${l.join(", ")} are not supported for command ${n}.`:1===l.length?`Flag ${l[0]} requires a command that supports it.`:`Flags ${l.join(", ")} require a command that supports them.`);if(s)throw new y("INVALID_ARGS",a);for(let e of(i.push(`${a} Enable AGENT_DEVICE_STRICT_FLAGS=1 to fail fast.`),r))delete o[e.key]}for(let t of Object.keys(o))void 0!==o[t]&&(Q(t,e.command)||delete o[t]);if(a?.defaults)for(let[e,t]of Object.entries(a.defaults))void 0===o[e]&&(o[e]=t);if("batch"===e.command&&1!=+!!o.steps+ +!!o.stepsFile)throw new y("INVALID_ARGS","batch requires exactly one step source: --steps or --steps-file.");return{command:e.command,positionals:e.positionals,flags:o,warnings:i}}(t,{strictFlags:r?.strictFlags,defaultFlags:l})}catch(t){c({level:"error",phase:"cli_parse_failed",data:{error:t instanceof Error?t.message:String(t)}});let e=l(t,{diagnosticId:u().diagnosticId,logPath:$({force:!0})??void 0});g?en({success:!1,error:e}):el(e,{showDetails:a}),process.exit(1);return}for(let e of O.warnings)process.stderr.write(`Warning: ${e}
+`)}return!0},runtime:async({positionals:e,flags:t,client:s})=>{let i=(e[0]??"show").toLowerCase();return"set"===i?(ek(await s.runtime.set({platform:t.platform,metroHost:t.metroHost,metroPort:t.metroPort,bundleUrl:t.bundleUrl,launchUrl:t.launchUrl}),t),!0):"show"===i&&(ek(await s.runtime.show(),t),!0)},install:async({positionals:e,flags:t,client:s})=>{let i=await eb("install",e,t,s);return t.json&&el({success:!0,data:I(i)}),!0},reinstall:async({positionals:e,flags:t,client:s})=>{let i=await eb("reinstall",e,t,s);return t.json&&el({success:!0,data:I(i)}),!0},"install-from-source":async({positionals:e,flags:t,client:s})=>{let i=await e$(e,t,s);return t.json&&el({success:!0,data:F(i)}),!0},open:async({positionals:e,flags:t,client:s})=>{if(!e[0])return!1;let i=await s.apps.open({app:e[0],url:e[1],activity:t.activity,relaunch:t.relaunch,saveScript:t.saveScript,noRecord:t.noRecord,...eA(t)});return t.json&&el({success:!0,data:A(i)}),!0},close:async({positionals:e,flags:t,client:s})=>{let i=e[0]?await s.apps.close({app:e[0],shutdown:t.shutdown}):await s.sessions.close({shutdown:t.shutdown});return t.json&&el({success:!0,data:x(i)}),!0},snapshot:async({flags:e,client:t})=>{let s=L(await t.capture.snapshot({...eA(e),interactiveOnly:e.snapshotInteractiveOnly,compact:e.snapshotCompact,depth:e.snapshotDepth,scope:e.snapshotScope,raw:e.snapshotRaw}));return e.json?el({success:!0,data:s}):process.stdout.write(ep(s,{raw:e.snapshotRaw,flatten:e.snapshotInteractiveOnly})),!0},screenshot:async({positionals:e,flags:t,client:s})=>{let i=await s.capture.screenshot({path:e[0]??t.out}),a={path:i.path};return t.json?el({success:!0,data:a}):process.stdout.write(`${i.path}
+`),!0},diff:async({positionals:e,flags:t,client:s})=>{let a;if("screenshot"!==e[0])return!1;let r=t.baseline;if(!r||"string"!=typeof r)throw new y("INVALID_ARGS","diff screenshot requires --baseline <path>");let o=d(r),l="string"==typeof t.out?d(t.out):void 0,p=.1;if(null!=t.threshold&&""!==t.threshold&&(Number.isNaN(p=Number(t.threshold))||p<0||p>1))throw new y("INVALID_ARGS","--threshold must be a number between 0 and 1");let u=w.mkdtempSync(n.join(v.tmpdir(),"agent-device-diff-current-")),c=n.join(u,`current-${Date.now()}.png`),g=(await s.capture.screenshot({path:c})).path;try{a=await ef(o,g,{threshold:p,outputPath:l})}finally{try{w.unlinkSync(g)}catch{}try{w.rmSync(u,{recursive:!0,force:!0})}catch{}}return t.json?el({success:!0,data:a}):process.stdout.write(function(e){var t,s;let a=ec(),r=!0===e.match,o=eu(e.differentPixels),l=eu(e.totalPixels),d=eu(e.mismatchPercentage),p=e.diffPath,u=e.dimensionMismatch,c=[];if(r){let e=a?i("green","✓"):"✓";c.push(`${e} Screenshots match.`)}else if(u){let e=a?i("red","✗"):"✗",t=u.expected,s=u.actual;c.push(`${e} Screenshots have different dimensions: expected ${t?.width}x${t?.height}, got ${s?.width}x${s?.height}`)}else{let e=a?i("red","✗"):"✗",t=0===d&&o>0?"<0.01":String(d);c.push(`${e} ${t}% pixels differ`)}if(p&&!r){let e,s,r=(t=p,e=process.cwd(),""!==(s=n.relative(e,t))&&(s.startsWith("..")||n.isAbsolute(s))?t:""===s?".":`.${n.sep}${s}`),o=a?i("dim","Diff image:"):"Diff image:",l=a?i("green",r):r;c.push(`  ${o} ${l}`)}if(!r&&!u){let e=a?(s=String(o),i("red",s)):String(o);c.push(`  ${e} different / ${l} total pixels`)}return`${c.join("\n")}
+`}(a)),!0}};async function eb(e,t,s,i){let a=t[0],r=t[1];if(!a||!r)throw new y("INVALID_ARGS",`${e} requires: ${e} <app> <path-to-app-binary>`);let o={app:a,appPath:r,...eA(s)};return"install"===e?await i.apps.install(o):await i.apps.reinstall(o)}async function e$(e,t,s){let i=e[0]?.trim();if(!i)throw new y("INVALID_ARGS","install-from-source requires: install-from-source <url>");if(e.length>1)throw new y("INVALID_ARGS","install-from-source accepts exactly one positional argument: <url>");return await s.apps.installFromSource({...eA(t),retainPaths:t.retainPaths,retentionMs:t.retentionMs,source:{kind:"url",url:i,headers:function(e){if(!e||0===e.length)return;let t={};for(let s of e){let e=s.indexOf(":");if(e<=0)throw new y("INVALID_ARGS",`Invalid --header value "${s}". Expected "name:value".`);let i=s.slice(0,e).trim(),a=s.slice(e+1).trim();if(!i)throw new y("INVALID_ARGS",`Invalid --header value "${s}". Header name cannot be empty.`);t[i]=a}return t}(t.header)}})}function ek(e,t){let s=N(e);t.json?el({success:!0,data:s}):e.configured?process.stdout.write(`${JSON.stringify(e.runtime??{},null,2)}
+`):process.stdout.write("No runtime hints configured\n")}function eA(e){return{platform:e.platform,target:e.target,device:e.device,udid:e.udid,serial:e.serial,iosSimulatorDeviceSet:e.iosSimulatorDeviceSet,androidDeviceAllowlist:e.androidDeviceAllowlist}}function eS(e){let t=e.kind?` ${e.kind}`:"",s=e.target?` target=${e.target}`:"",i="boolean"==typeof e.booted?` booted=${e.booted}`:"";return`${e.name} (${e.platform}${t}${s})${i}`}function eD(e,t={}){let s=eI(t),i={...e};return s.defaultPlatform&&void 0===i.platform&&(i.platform=s.defaultPlatform),i}function eI(e){var t,s,i,a;let r,o=e.env??process.env,n=e.inheritedPlatform??e.configuredPlatform??function(e){if(void 0===e)return;let t=e.trim().toLowerCase();if(t){if("ios"===t||"android"===t||"apple"===t)return t;throw new y("INVALID_ARGS",`Invalid AGENT_DEVICE_PLATFORM: ${e}. Use ios, android, or apple.`)}}(o.AGENT_DEVICE_PLATFORM),l="string"==typeof(t=e.configuredSession??o.AGENT_DEVICE_SESSION)&&t.trim().length>0;return{defaultPlatform:n,lockPolicy:(s=e.policyOverrides,i=o,a=l,(r=s?.sessionLock??s?.sessionLockConflicts??eL(i.AGENT_DEVICE_SESSION_LOCK)??eL(i.AGENT_DEVICE_SESSION_LOCK_CONFLICTS))||(s?.sessionLocked===!0||function(e){if(!e)return!1;switch(e.trim().toLowerCase()){case"1":case"true":case"yes":case"on":return!0;default:return!1}}(i.AGENT_DEVICE_SESSION_LOCKED)||a?"reject":void 0))}}function eL(e){if(void 0===e)return;let t=e.trim().toLowerCase();if(t){if("reject"===t||"strip"===t)return t;throw new y("INVALID_ARGS",`Invalid session lock mode: ${e}. Use reject or strip.`)}}function ex(e,t){for(let[s,i]of Object.entries(t))void 0!==i&&(e[s]=i);return e}let eN={sendToDaemon:S};async function eO(e,t=eN){let s=o(),r=e.includes("--debug")||e.includes("--verbose")||e.includes("-v"),g=e.includes("--json"),h=function(e){for(let t=0;t<e.length;t+=1){let s=e[t];if(s.startsWith("--session=")){let e=s.slice(10).trim();return e.length>0?e:null}if("--session"===s){let s=e[t+1]?.trim();if(s&&!s.startsWith("-"))return s;break}}return null}(e)??process.env.AGENT_DEVICE_SESSION??"default";await b({session:h,requestId:s,command:e[0],debug:r},async()=>{var o,h,v,b,A,S,D,I,L,x,N;let O;try{let t,s,i,a,r,l,p;o={cwd:process.cwd(),env:process.env},t=function(e){let t={json:!1,help:!1,version:!1},s=null,i=[],a=[],r=!0;for(let o=0;o<e.length;o+=1){let n=e[o];if(r&&"--"===n){r=!1;continue}if(!r){s?i.push(n):s=eo(n);continue}let l=n.startsWith("--"),d=n.startsWith("-")&&n.length>1;if(!l&&!d){s?i.push(n):s=eo(n);continue}let[p,u]=l?ei(n):[n,void 0],c=T.get(p);if(!c){if(function(e,t,s){var i;if(i=s,!/^-\d+(\.\d+)?$/.test(i)||!e)return!1;let a=G(e);return!a||!!a.allowsExtraPositionals||0!==a.positionalArgs.length&&(t.length<a.positionalArgs.length||a.positionalArgs.some(e=>e.includes("?")))}(s,i,n)){s?i.push(n):s=n;continue}throw new y("INVALID_ARGS",`Unknown flag: ${p}`)}let g=function(e,t,s,i){if(void 0!==e.setValue){if(void 0!==s)throw new y("INVALID_ARGS",`Flag ${t} does not take a value.`);return{value:e.setValue,consumeNext:!1}}if("boolean"===e.type){if(void 0!==s)throw new y("INVALID_ARGS",`Flag ${t} does not take a value.`);return{value:!0,consumeNext:!1}}if("booleanOrString"===e.type){if(void 0!==s){if(0===s.trim().length)throw new y("INVALID_ARGS",`Flag ${t} requires a non-empty value when provided.`);return{value:s,consumeNext:!1}}return void 0===i||er(i)||!function(e){let t=e.trim();return!(!t||/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//.test(t))&&!!(t.startsWith("./")||t.startsWith("../")||t.startsWith("~/")||t.startsWith("/")||t.includes("/")||t.includes("\\"))}(i)?{value:!0,consumeNext:!1}:{value:i,consumeNext:!0}}let a=s??i;if(void 0===a||void 0===s&&er(a))throw new y("INVALID_ARGS",`Flag ${t} requires a value.`);if("string"===e.type)return{value:a,consumeNext:void 0===s};if("enum"===e.type){if(!e.enumValues?.includes(a))throw new y("INVALID_ARGS",`Invalid ${ea(t)}: ${a}`);return{value:a,consumeNext:void 0===s}}let r=Number(a);if(!Number.isFinite(r)||"number"==typeof e.min&&r<e.min||"number"==typeof e.max&&r>e.max)throw new y("INVALID_ARGS",`Invalid ${ea(t)}: ${a}`);return{value:Math.floor(r),consumeNext:void 0===s}}(c,p,u,e[o+1]);g.consumeNext&&(o+=1);let f=t[c.key];if(c.multiple){let e=Array.isArray(f)?[...f,g.value]:void 0===f?[g.value]:[f,g.value];t[c.key]=e}else t[c.key]=g.value;a.push({key:c.key,token:p})}return{command:s,positionals:i,flags:t,warnings:[],providedFlags:a}}(e),s=o?.env??process.env,i=o?.cwd??process.cwd(),a=(h={command:t.command,cwd:i,cliFlags:t.flags,env:s}).env??process.env,r=ex({},function(e){let t={};for(let s of e)ex(t,function(e,t){let s,i;if(!w.existsSync(e)){if(t)throw new y("INVALID_ARGS",`Config file not found: ${e}`);return{}}try{s=w.readFileSync(e,"utf8")}catch(t){throw new y("INVALID_ARGS",`Failed to read config file: ${e}`,{cause:t instanceof Error?t.message:String(t)})}try{i=JSON.parse(s)}catch(t){throw new y("INVALID_ARGS",`Invalid JSON in config file: ${e}`,{cause:t instanceof Error?t.message:String(t)})}if(!i||"object"!=typeof i||Array.isArray(i))throw new y("INVALID_ARGS",`Config file must contain a JSON object: ${e}`);return function(e,t){let s={};for(let[i,a]of Object.entries(e)){let e=Q.get(i);if(!e)throw new y("INVALID_ARGS",`Unknown config key "${i}" in ${t}.`);if(!e.config.enabled)throw new y("INVALID_ARGS",`Unsupported config key "${i}" in ${t}.`);s[i]=et(e,a,t,i)}return s}(i,`config file ${e}`)}(s.path,s.required));return t}((v=h.cwd,b=h.cliFlags.config,A=a,(p=b??A.AGENT_DEVICE_CONFIG)?[{path:(S=p,D=v,I=A,d(S,{cwd:D,env:I})),required:!0}]:[{path:(L=A,n.join(m("~",{env:L}),".agent-device","config.json")),required:!1},{path:n.resolve(v,"agent-device.json"),required:!1}]))),l=ex(r,function(e,t){let s={};for(let i of Y.filter(e=>e.config.enabled&&e.supportsCommand(t))){let t=i.env.names.map(t=>({name:t,value:e[t]})).find(e=>"string"==typeof e.value&&e.value.trim().length>0);t&&(s[i.key]=et(i,t.value,`environment variable ${t.name}`,t.name))}return s}(a,h.command)),O=function(e,t){let s=t?.strictFlags??function(e){if(!e)return!1;let t=e.trim().toLowerCase();return"1"===t||"true"===t||"yes"===t||"on"===t}(process.env.AGENT_DEVICE_STRICT_FLAGS),i=[...e.warnings],a=en({json:!1,help:!1,version:!1},t?.defaultFlags??{});en(a,e.flags);let r=G(e.command),o=e.providedFlags.filter(t=>!ee(t.key,e.command));if(o.length>0){var n,l;let t=o.map(e=>e.token),r=(n=e.command,l=t,n?1===l.length?`Flag ${l[0]} is not supported for command ${n}.`:`Flags ${l.join(", ")} are not supported for command ${n}.`:1===l.length?`Flag ${l[0]} requires a command that supports it.`:`Flags ${l.join(", ")} require a command that supports them.`);if(s)throw new y("INVALID_ARGS",r);for(let e of(i.push(`${r} Enable AGENT_DEVICE_STRICT_FLAGS=1 to fail fast.`),o))delete a[e.key]}for(let t of Object.keys(a))void 0!==a[t]&&(ee(t,e.command)||delete a[t]);if(r?.defaults)for(let[e,t]of Object.entries(r.defaults))void 0===a[e]&&(a[e]=t);if("batch"===e.command&&1!=+!!a.steps+ +!!a.stepsFile)throw new y("INVALID_ARGS","batch requires exactly one step source: --steps or --steps-file.");return{command:e.command,positionals:e.positionals,flags:a,warnings:i}}(t,{strictFlags:o?.strictFlags,defaultFlags:l})}catch(t){c({level:"error",phase:"cli_parse_failed",data:{error:t instanceof Error?t.message:String(t)}});let e=l(t,{diagnosticId:u().diagnosticId,logPath:$({force:!0})??void 0});g?el({success:!1,error:e}):ed(e,{showDetails:r}),process.exit(1);return}for(let e of O.warnings)process.stderr.write(`Warning: ${e}
 `);O.flags.version&&(process.stdout.write(`${p()}
-`),process.exit(0));let _="help"===O.command,E=O.flags.help;if(_||E){_&&O.positionals.length>1&&(el(new y("INVALID_ARGS","help accepts at most one command.")),process.exit(1));let e=_?O.positionals[0]:O.command;e||(process.stdout.write(`${q}
-`),process.exit(0));let t=function(e){let t=M(e);if(!t)return null;let s=B(e,t),i=J(new Set(t.allowedFlags)),o=J(P),a=[];return i.length>0&&a.push(W("Command flags:",i)),a.push(W("Global flags:",o)),`agent-device ${s}
+`),process.exit(0));let F="help"===O.command,_=O.flags.help;if(F||_){F&&O.positionals.length>1&&(ed(new y("INVALID_ARGS","help accepts at most one command.")),process.exit(1));let e=F?O.positionals[0]:O.command;e||(process.stdout.write(`${J}
+`),process.exit(0));let t=function(e){let t=G(e);if(!t)return null;let s=q(e,t),i=W(new Set(t.allowedFlags)),a=W(j),r=[];return i.length>0&&r.push(z("Command flags:",i)),r.push(z("Global flags:",a)),`agent-device ${s}
 
 ${t.description}
 
 Usage:
   agent-device ${s}
 
-${a.join("\n\n")}
-`}(ea(e));t&&(process.stdout.write(t),process.exit(0)),el(new y("INVALID_ARGS",`Unknown command: ${e}`)),process.stdout.write(`${q}
-`),process.exit(1)}O.command||(process.stdout.write(`${q}
-`),process.exit(1));let{command:C,positionals:j}=O,R=eA({policyOverrides:O.flags,configuredPlatform:O.flags.platform,configuredSession:O.flags.session}),T=R.lockPolicy?{...O.flags}:eS(O.flags,{policyOverrides:O.flags,configuredPlatform:O.flags.platform,configuredSession:O.flags.session}),G=function(e){let{json:t,config:s,help:i,version:o,sessionLock:a,sessionLocked:r,sessionLockConflicts:n,...l}=e;return l}(T),U=k(T.stateDir),z=T.session??"default",H=T.daemonBaseUrl,K=!T.verbose||T.json||H?null:function(e){try{let t=0,s=!1,i=setInterval(()=>{if(!s&&w.existsSync(e))try{let s=w.statSync(e);if(s.size<t&&(t=0),s.size<=t)return;let i=w.openSync(e,"r");try{let e=Buffer.alloc(s.size-t);w.readSync(i,e,0,e.length,t),t=s.size,e.length>0&&process.stdout.write(e.toString("utf8"))}finally{w.closeSync(i)}}catch{}},200);return()=>{s=!0,clearInterval(i)}}catch{return null}}(U.logPath),Z=F({session:z,requestId:s,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,lockPolicy:R.lockPolicy,lockPlatform:R.defaultPlatform,cwd:process.cwd(),debug:!!T.verbose},{transport:t.sendToDaemon}),et=async e=>await t.sendToDaemon({session:z,command:e.command,positionals:e.positionals,flags:e.flags,meta:{requestId:s,debug:!!T.verbose,cwd:process.cwd(),tenantId:T.tenant,runId:T.runId,leaseId:T.leaseId,sessionIsolation:T.sessionIsolation,lockPolicy:R.lockPolicy,lockPlatform:R.defaultPlatform}});try{if("batch"===C){let e,t,s;if(j.length>0)throw new y("INVALID_ARGS","batch does not accept positional arguments.");let i=(function(e){let t="";if(e.steps)t=e.steps;else if(e.stepsFile)try{t=w.readFileSync(e.stepsFile,"utf8")}catch(s){let t=s instanceof Error?s.message:String(s);throw new y("INVALID_ARGS",`Failed to read --steps-file ${e.stepsFile}: ${t}`)}return o(t)})(T).map((e,t)=>({...e,flags:R.lockPolicy&&void 0===T.platform?{...e.flags??{}}:eS(e.flags??{},{policyOverrides:T,configuredPlatform:T.platform,configuredSession:T.session,inheritedPlatform:T.platform})})),a={...G,batchSteps:i};delete a.steps,delete a.stepsFile;let r=await et({command:"batch",positionals:j,flags:a});if(!r.ok)throw new y(r.error.code,r.error.message,{...r.error.details??{},hint:r.error.hint,diagnosticId:r.error.diagnosticId,logPath:r.error.logPath});T.json?en({success:!0,data:r.data??{}}):(x=r.data??{},e="number"==typeof x.total?x.total:0,t="number"==typeof x.executed?x.executed:0,s="number"==typeof x.totalDurationMs?x.totalDurationMs:void 0,process.stdout.write(`Batch completed: ${t}/${e} steps${void 0!==s?` in ${s}ms`:""}
-`)),K&&K();return}if(await ey({command:C,positionals:j,flags:T,client:Z})){K&&K();return}let e=await et({command:C,positionals:j,flags:G});if(e.ok){if(T.json){en({success:!0,data:e.data??{}}),K&&K();return}if("snapshot"===C){process.stdout.write(ed(e.data??{},{raw:T.snapshotRaw,flatten:T.snapshotInteractiveOnly})),K&&K();return}if("diff"===C&&"snapshot"===j[0]){process.stdout.write(function(e){var t,s,o,a;let r=!0===e.baselineInitialized,n=e.summary??{},l=ep(n.additions),d=ep(n.removals),p=ep(n.unchanged),u=eu();if(r)return`Baseline initialized (${p} lines).
-`;let c=(function(e,t){if(0===e.length)return e;let s=e.map((e,t)=>({index:t,kind:e.kind})).filter(e=>"added"===e.kind||"removed"===e.kind).map(e=>e.index);if(0===s.length)return e;let i=Array(e.length).fill(!1);for(let t of s){let s=Math.max(0,t-1),o=Math.min(e.length-1,t+1);for(let e=s;e<=o;e+=1)i[e]=!0}return e.filter((e,t)=>i[t])})(Array.isArray(e.lines)?e.lines:[],1).map(e=>{var t,s,o,a;let r="string"==typeof e.text?e.text:"";if("added"===e.kind){let e=r.startsWith(" ")?`+${r}`:`+ ${r}`;return u?(t=e,s="green",i(s,t)):e}if("removed"===e.kind){let e=r.startsWith(" ")?`-${r}`:`- ${r}`;return u?(o=e,i("red",o)):e}return u?(a=r,i("dim",a)):r}),g=c.length>0?`${c.join("\n")}
+${r.join("\n\n")}
+`}(eo(e));t&&(process.stdout.write(t),process.exit(0)),ed(new y("INVALID_ARGS",`Unknown command: ${e}`)),process.stdout.write(`${J}
+`),process.exit(1)}O.command||(process.stdout.write(`${J}
+`),process.exit(1));let{command:P,positionals:R}=O,C=eI({policyOverrides:O.flags,configuredPlatform:O.flags.platform,configuredSession:O.flags.session}),V=C.lockPolicy?{...O.flags}:eD(O.flags,{policyOverrides:O.flags,configuredPlatform:O.flags.platform,configuredSession:O.flags.session}),M=function(e){let{json:t,config:s,help:i,version:a,sessionLock:r,sessionLocked:o,sessionLockConflicts:n,...l}=e;return l}(V),U=k(V.stateDir),B=V.session??"default",H=V.daemonBaseUrl,K=!V.verbose||V.json||H?null:function(e){try{let t=0,s=!1,i=setInterval(()=>{if(!s&&w.existsSync(e))try{let s=w.statSync(e);if(s.size<t&&(t=0),s.size<=t)return;let i=w.openSync(e,"r");try{let e=Buffer.alloc(s.size-t);w.readSync(i,e,0,e.length,t),t=s.size,e.length>0&&process.stdout.write(e.toString("utf8"))}finally{w.closeSync(i)}}catch{}},200);return()=>{s=!0,clearInterval(i)}}catch{return null}}(U.logPath),Z=E({session:B,requestId:s,stateDir:V.stateDir,daemonBaseUrl:V.daemonBaseUrl,daemonAuthToken:V.daemonAuthToken,daemonTransport:V.daemonTransport,daemonServerMode:V.daemonServerMode,tenant:V.tenant,sessionIsolation:V.sessionIsolation,runId:V.runId,leaseId:V.leaseId,lockPolicy:C.lockPolicy,lockPlatform:C.defaultPlatform,cwd:process.cwd(),debug:!!V.verbose},{transport:t.sendToDaemon}),X=async e=>await t.sendToDaemon({session:B,command:e.command,positionals:e.positionals,flags:e.flags,meta:{requestId:s,debug:!!V.verbose,cwd:process.cwd(),tenantId:V.tenant,runId:V.runId,leaseId:V.leaseId,sessionIsolation:V.sessionIsolation,lockPolicy:C.lockPolicy,lockPlatform:C.defaultPlatform}});try{if("batch"===P){let e,t,s;if(R.length>0)throw new y("INVALID_ARGS","batch does not accept positional arguments.");let i=(function(e){let t="";if(e.steps)t=e.steps;else if(e.stepsFile)try{t=w.readFileSync(e.stepsFile,"utf8")}catch(s){let t=s instanceof Error?s.message:String(s);throw new y("INVALID_ARGS",`Failed to read --steps-file ${e.stepsFile}: ${t}`)}return a(t)})(V).map((e,t)=>({...e,flags:C.lockPolicy&&void 0===V.platform?{...e.flags??{}}:eD(e.flags??{},{policyOverrides:V,configuredPlatform:V.platform,configuredSession:V.session,inheritedPlatform:V.platform})})),r={...M,batchSteps:i};delete r.steps,delete r.stepsFile;let o=await X({command:"batch",positionals:R,flags:r});if(!o.ok)throw new y(o.error.code,o.error.message,{...o.error.details??{},hint:o.error.hint,diagnosticId:o.error.diagnosticId,logPath:o.error.logPath});V.json?el({success:!0,data:o.data??{}}):(x=o.data??{},e="number"==typeof x.total?x.total:0,t="number"==typeof x.executed?x.executed:0,s="number"==typeof x.totalDurationMs?x.totalDurationMs:void 0,process.stdout.write(`Batch completed: ${t}/${e} steps${void 0!==s?` in ${s}ms`:""}
+`)),K&&K();return}if(await ew({command:P,positionals:R,flags:V,client:Z})){K&&K();return}let e=await X({command:P,positionals:R,flags:M});if(e.ok){if(V.json){el({success:!0,data:e.data??{}}),K&&K();return}if("snapshot"===P){process.stdout.write(ep(e.data??{},{raw:V.snapshotRaw,flatten:V.snapshotInteractiveOnly})),K&&K();return}if("diff"===P&&"snapshot"===R[0]){process.stdout.write(function(e){var t,s,a,r;let o=!0===e.baselineInitialized,n=e.summary??{},l=eu(n.additions),d=eu(n.removals),p=eu(n.unchanged),u=ec();if(o)return`Baseline initialized (${p} lines).
+`;let c=(function(e,t){if(0===e.length)return e;let s=e.map((e,t)=>({index:t,kind:e.kind})).filter(e=>"added"===e.kind||"removed"===e.kind).map(e=>e.index);if(0===s.length)return e;let i=Array(e.length).fill(!1);for(let t of s){let s=Math.max(0,t-1),a=Math.min(e.length-1,t+1);for(let e=s;e<=a;e+=1)i[e]=!0}return e.filter((e,t)=>i[t])})(Array.isArray(e.lines)?e.lines:[],1).map(e=>{var t,s,a,r;let o="string"==typeof e.text?e.text:"";if("added"===e.kind){let e=o.startsWith(" ")?`+${o}`:`+ ${o}`;return u?(t=e,s="green",i(s,t)):e}if("removed"===e.kind){let e=o.startsWith(" ")?`-${o}`:`- ${o}`;return u?(a=e,i("red",a)):e}return u?(r=o,i("dim",r)):o}),g=c.length>0?`${c.join("\n")}
 `:"";if(!u)return`${g}${l} additions, ${d} removals, ${p} unchanged
-`;let f=`${(t=String(l),s="green",i(s,t))} additions, ${(o=String(d),i("red",o))} removals, ${(a=String(p),i("dim",a))} unchanged`;return`${g}${f}
-`}(e.data??{})),K&&K();return}if("get"===C){let t=j[0];if("text"===t){let t=e.data?.text??"";process.stdout.write(`${t}
+`;let f=`${(t=String(l),s="green",i(s,t))} additions, ${(a=String(d),i("red",a))} removals, ${(r=String(p),i("dim",r))} unchanged`;return`${g}${f}
+`}(e.data??{})),K&&K();return}if("get"===P){let t=R[0];if("text"===t){let t=e.data?.text??"";process.stdout.write(`${t}
 `),K&&K();return}if("attrs"===t){let t=e.data?.node??{};process.stdout.write(`${JSON.stringify(t,null,2)}
-`),K&&K();return}}if("find"===C){let t=e.data;if("string"==typeof t?.text){process.stdout.write(`${t.text}
+`),K&&K();return}}if("find"===P){let t=e.data;if("string"==typeof t?.text){process.stdout.write(`${t.text}
 `),K&&K();return}if("boolean"==typeof t?.found){process.stdout.write(`Found: ${t.found}
 `),K&&K();return}if(t?.node){process.stdout.write(`${JSON.stringify(t.node,null,2)}
-`),K&&K();return}}if("is"===C){let t=e.data?.predicate??"assertion";process.stdout.write(`Passed: is ${t}
-`),K&&K();return}if("boot"===C){let t=e.data?.platform??"unknown",s=e.data?.device??e.data?.id??"unknown";process.stdout.write(`Boot ready: ${s} (${t})
-`),K&&K();return}if("ensure-simulator"===C){let t=e.data,s="string"==typeof t?.udid?t.udid:"unknown",i="string"==typeof t?.device?t.device:"unknown",o="string"==typeof t?.runtime?t.runtime:"",a=t?.created===!0,r=t?.booted===!0;process.stdout.write(`${a?"Created":"Reused"}: ${i} ${s}${r?" (booted)":""}
-`),o&&process.stdout.write(`Runtime: ${o}
-`),K&&K();return}if("runtime"===C){let t=e.data,s=t?.cleared===!0,i=t?.configured===!0;if(s){process.stdout.write("Runtime hints cleared\n"),K&&K();return}if(!i){process.stdout.write("No runtime hints configured\n"),K&&K();return}process.stdout.write(`${JSON.stringify(t?.runtime??{},null,2)}
-`),K&&K();return}if("screenshot"===C){let t="string"==typeof e.data?.path?e.data.path:"";t&&process.stdout.write(`${t}
-`),K&&K();return}if("record"===C){let t=e.data,s="string"==typeof t?.outPath?t.outPath:"";s&&process.stdout.write(`${s}
-`),K&&K();return}if("logs"===C){let t=e.data,s="string"==typeof t?.path?t.path:"";if(s){process.stdout.write(`${s}
-`);let e="boolean"==typeof t?.active?t.active:void 0,i="string"==typeof t?.state?t.state:void 0,o="string"==typeof t?.backend?t.backend:void 0,a="number"==typeof t?.sizeBytes?t.sizeBytes:void 0,r=t?.started===!0,n=t?.stopped===!0,l=t?.marked===!0,d=t?.cleared===!0,p=t?.restarted===!0,u="number"==typeof t?.removedRotatedFiles?t.removedRotatedFiles:void 0;if(!T.json&&(void 0!==e||i||o||void 0!==a)){let t=[void 0!==e?`active=${e}`:"",i?`state=${i}`:"",o?`backend=${o}`:"",void 0!==a?`sizeBytes=${a}`:""].filter(Boolean).join(" ");t&&process.stderr.write(`${t}
-`)}if(!T.json&&(r||n||l||d||p||void 0!==u)){let e=[r?"started=true":"",n?"stopped=true":"",l?"marked=true":"",d?"cleared=true":"",p?"restarted=true":"",void 0!==u?`removedRotatedFiles=${u}`:""].filter(Boolean).join(" ");e&&process.stderr.write(`${e}
-`)}if(t?.hint&&!T.json&&process.stderr.write(`${t.hint}
-`),Array.isArray(t?.notes)&&!T.json)for(let e of t.notes)"string"==typeof e&&e.length>0&&process.stderr.write(`${e}
-`)}K&&K();return}if("clipboard"===C){let t=e.data,s=(j[0]??("string"==typeof t?.action?t.action:"")).toLowerCase();if("read"===s){let e="string"==typeof t?.text?t.text:"";process.stdout.write(`${e}
-`),K&&K();return}if("write"===s){process.stdout.write("Clipboard updated\n"),K&&K();return}}if("network"===C){let t=e.data,s="string"==typeof t?.path?t.path:"";s&&process.stdout.write(`${s}
-`);let i=Array.isArray(t?.entries)?t.entries:[];if(0===i.length)process.stdout.write("No recent HTTP(s) entries found.\n");else for(let e of i){let t="string"==typeof e.method?e.method:"HTTP",s="string"==typeof e.url?e.url:"<unknown-url>",i="number"==typeof e.status?` status=${e.status}`:"",o="string"==typeof e.timestamp?`${e.timestamp} `:"";process.stdout.write(`${o}${t} ${s}${i}
+`),K&&K();return}}if("is"===P){let t=e.data?.predicate??"assertion";process.stdout.write(`Passed: is ${t}
+`),K&&K();return}if("boot"===P){let t=e.data?.platform??"unknown",s=e.data?.device??e.data?.id??"unknown";process.stdout.write(`Boot ready: ${s} (${t})
+`),K&&K();return}if("ensure-simulator"===P){let t=e.data,s="string"==typeof t?.udid?t.udid:"unknown",i="string"==typeof t?.device?t.device:"unknown",a="string"==typeof t?.runtime?t.runtime:"",r=t?.created===!0,o=t?.booted===!0;process.stdout.write(`${r?"Created":"Reused"}: ${i} ${s}${o?" (booted)":""}
+`),a&&process.stdout.write(`Runtime: ${a}
+`),K&&K();return}if("runtime"===P){let t=e.data,s=t?.cleared===!0,i=t?.configured===!0;if(s){process.stdout.write("Runtime hints cleared\n"),K&&K();return}if(!i){process.stdout.write("No runtime hints configured\n"),K&&K();return}process.stdout.write(`${JSON.stringify(t?.runtime??{},null,2)}
+`),K&&K();return}if("screenshot"===P){let t="string"==typeof e.data?.path?e.data.path:"";t&&process.stdout.write(`${t}
+`),K&&K();return}if("record"===P){let t=e.data,s="string"==typeof t?.outPath?t.outPath:"";s&&process.stdout.write(`${s}
+`),K&&K();return}if("logs"===P){let t=e.data,s="string"==typeof t?.path?t.path:"";if(s){process.stdout.write(`${s}
+`);let e="boolean"==typeof t?.active?t.active:void 0,i="string"==typeof t?.state?t.state:void 0,a="string"==typeof t?.backend?t.backend:void 0,r="number"==typeof t?.sizeBytes?t.sizeBytes:void 0,o=t?.started===!0,n=t?.stopped===!0,l=t?.marked===!0,d=t?.cleared===!0,p=t?.restarted===!0,u="number"==typeof t?.removedRotatedFiles?t.removedRotatedFiles:void 0;if(!V.json&&(void 0!==e||i||a||void 0!==r)){let t=[void 0!==e?`active=${e}`:"",i?`state=${i}`:"",a?`backend=${a}`:"",void 0!==r?`sizeBytes=${r}`:""].filter(Boolean).join(" ");t&&process.stderr.write(`${t}
+`)}if(!V.json&&(o||n||l||d||p||void 0!==u)){let e=[o?"started=true":"",n?"stopped=true":"",l?"marked=true":"",d?"cleared=true":"",p?"restarted=true":"",void 0!==u?`removedRotatedFiles=${u}`:""].filter(Boolean).join(" ");e&&process.stderr.write(`${e}
+`)}if(t?.hint&&!V.json&&process.stderr.write(`${t.hint}
+`),Array.isArray(t?.notes)&&!V.json)for(let e of t.notes)"string"==typeof e&&e.length>0&&process.stderr.write(`${e}
+`)}K&&K();return}if("clipboard"===P){let t=e.data,s=(R[0]??("string"==typeof t?.action?t.action:"")).toLowerCase();if("read"===s){let e="string"==typeof t?.text?t.text:"";process.stdout.write(`${e}
+`),K&&K();return}if("write"===s){process.stdout.write("Clipboard updated\n"),K&&K();return}}if("network"===P){let t=e.data,s="string"==typeof t?.path?t.path:"";s&&process.stdout.write(`${s}
+`);let i=Array.isArray(t?.entries)?t.entries:[];if(0===i.length)process.stdout.write("No recent HTTP(s) entries found.\n");else for(let e of i){let t="string"==typeof e.method?e.method:"HTTP",s="string"==typeof e.url?e.url:"<unknown-url>",i="number"==typeof e.status?` status=${e.status}`:"",a="string"==typeof e.timestamp?`${e.timestamp} `:"";process.stdout.write(`${a}${t} ${s}${i}
 `),"string"==typeof e.headers&&process.stdout.write(`  headers: ${e.headers}
 `),"string"==typeof e.requestBody&&process.stdout.write(`  request: ${e.requestBody}
 `),"string"==typeof e.responseBody&&process.stdout.write(`  response: ${e.responseBody}
-`)}let o="boolean"==typeof t?.active?t.active:void 0,a="string"==typeof t?.state?t.state:void 0,r="string"==typeof t?.backend?t.backend:void 0,n="number"==typeof t?.scannedLines?t.scannedLines:void 0,l="number"==typeof t?.matchedLines?t.matchedLines:void 0,d="string"==typeof t?.include?t.include:void 0,p=[void 0!==o?`active=${o}`:"",a?`state=${a}`:"",r?`backend=${r}`:"",d?`include=${d}`:"",void 0!==n?`scannedLines=${n}`:"",void 0!==l?`matchedLines=${l}`:""].filter(Boolean).join(" ");if(p&&process.stderr.write(`${p}
+`)}let a="boolean"==typeof t?.active?t.active:void 0,r="string"==typeof t?.state?t.state:void 0,o="string"==typeof t?.backend?t.backend:void 0,n="number"==typeof t?.scannedLines?t.scannedLines:void 0,l="number"==typeof t?.matchedLines?t.matchedLines:void 0,d="string"==typeof t?.include?t.include:void 0,p=[void 0!==a?`active=${a}`:"",r?`state=${r}`:"",o?`backend=${o}`:"",d?`include=${d}`:"",void 0!==n?`scannedLines=${n}`:"",void 0!==l?`matchedLines=${l}`:""].filter(Boolean).join(" ");if(p&&process.stderr.write(`${p}
 `),Array.isArray(t?.notes))for(let e of t.notes)"string"==typeof e&&e.length>0&&process.stderr.write(`${e}
-`);K&&K();return}if("click"===C||"press"===C){let t=e.data?.ref??"",s=e.data?.x,i=e.data?.y;t&&"number"==typeof s&&"number"==typeof i&&process.stdout.write(`Tapped @${t} (${s}, ${i})
-`),K&&K();return}if(e.data&&"object"==typeof e.data){let t=e.data;if("devices"===C){let e=(Array.isArray(t.devices)?t.devices:[]).map(e=>{let t=e?.name??e?.id??"unknown",s=e?.platform??"unknown",i=e?.kind?` ${e.kind}`:"",o=e?.target?` target=${e.target}`:"",a="boolean"==typeof e?.booted?` booted=${e.booted}`:"";return`${t} (${s}${i}${o})${a}`});process.stdout.write(`${e.join("\n")}
-`),K&&K();return}if("apps"===C){let e=(Array.isArray(t.apps)?t.apps:[]).map(e=>{if("string"==typeof e)return e;if(e&&"object"==typeof e){let t=e.bundleId??e.package,s=e.name??e.label;return s&&t?`${s} (${t})`:t?String(t):JSON.stringify(e)}return String(e)});process.stdout.write(`${e.join("\n")}
-`),K&&K();return}if("appstate"===C){let e=t?.platform,s=t?.appBundleId,i=t?.appName,o=t?.source,a=t?.package,r=t?.activity;if("ios"===e){process.stdout.write(`Foreground app: ${i??s??"unknown"}
+`);K&&K();return}if("click"===P||"press"===P){let t=e.data?.ref??"",s=e.data?.x,i=e.data?.y;t&&"number"==typeof s&&"number"==typeof i&&process.stdout.write(`Tapped @${t} (${s}, ${i})
+`),K&&K();return}if(e.data&&"object"==typeof e.data){let t=e.data;if("devices"===P){let e=(Array.isArray(t.devices)?t.devices:[]).map(e=>{let t=e?.name??e?.id??"unknown",s=e?.platform??"unknown",i=e?.kind?` ${e.kind}`:"",a=e?.target?` target=${e.target}`:"",r="boolean"==typeof e?.booted?` booted=${e.booted}`:"";return`${t} (${s}${i}${a})${r}`});process.stdout.write(`${e.join("\n")}
+`),K&&K();return}if("apps"===P){let e=(Array.isArray(t.apps)?t.apps:[]).map(e=>{if("string"==typeof e)return e;if(e&&"object"==typeof e){let t=e.bundleId??e.package,s=e.name??e.label;return s&&t?`${s} (${t})`:t?String(t):JSON.stringify(e)}return String(e)});process.stdout.write(`${e.join("\n")}
+`),K&&K();return}if("appstate"===P){let e=t?.platform,s=t?.appBundleId,i=t?.appName,a=t?.source,r=t?.package,o=t?.activity;if("ios"===e){process.stdout.write(`Foreground app: ${i??s??"unknown"}
 `),s&&process.stdout.write(`Bundle: ${s}
-`),o&&process.stdout.write(`Source: ${o}
-`),K&&K();return}if("android"===e){process.stdout.write(`Foreground app: ${a??"unknown"}
-`),r&&process.stdout.write(`Activity: ${r}
-`),K&&K();return}}if("perf"===C){process.stdout.write(`${JSON.stringify(t,null,2)}
-`),K&&K();return}}K&&K();return}throw new y(e.error.code,e.error.message,{...e.error.details??{},hint:e.error.hint,diagnosticId:e.error.diagnosticId,logPath:e.error.logPath})}catch(s){let e=f(s),t=l(e,{diagnosticId:u().diagnosticId,logPath:$({force:!0})??void 0});if("close"===C&&"COMMAND_FAILED"===(N=e).code&&(N.details?.kind==="daemon_startup_failed"||N.message.toLowerCase().includes("failed to start daemon")&&("string"==typeof N.details?.infoPath||"string"==typeof N.details?.lockPath))){T.json&&en({success:!0,data:{closed:"session",source:"no-daemon"}}),K&&K();return}if(T.json)en({success:!1,error:t});else if(el(t,{showDetails:T.verbose}),T.verbose)try{let e=U.logPath;if(w.existsSync(e)){let t=w.readFileSync(e,"utf8").split("\n"),s=t.slice(Math.max(0,t.length-200)).join("\n");s.trim().length>0&&process.stderr.write(`
+`),a&&process.stdout.write(`Source: ${a}
+`),K&&K();return}if("android"===e){process.stdout.write(`Foreground app: ${r??"unknown"}
+`),o&&process.stdout.write(`Activity: ${o}
+`),K&&K();return}}if("perf"===P){process.stdout.write(`${JSON.stringify(t,null,2)}
+`),K&&K();return}}K&&K();return}throw new y(e.error.code,e.error.message,{...e.error.details??{},hint:e.error.hint,diagnosticId:e.error.diagnosticId,logPath:e.error.logPath})}catch(s){let e=f(s),t=l(e,{diagnosticId:u().diagnosticId,logPath:$({force:!0})??void 0});if("close"===P&&"COMMAND_FAILED"===(N=e).code&&(N.details?.kind==="daemon_startup_failed"||N.message.toLowerCase().includes("failed to start daemon")&&("string"==typeof N.details?.infoPath||"string"==typeof N.details?.lockPath))){V.json&&el({success:!0,data:{closed:"session",source:"no-daemon"}}),K&&K();return}if(V.json)el({success:!1,error:t});else if(ed(t,{showDetails:V.verbose}),V.verbose)try{let e=U.logPath;if(w.existsSync(e)){let t=w.readFileSync(e,"utf8").split("\n"),s=t.slice(Math.max(0,t.length-200)).join("\n");s.trim().length>0&&process.stderr.write(`
 [daemon log]
 ${s}
-`)}}catch{}K&&K(),process.exit(1)}})}h(process.argv[1]??"").href===import.meta.url&&ex(process.argv.slice(2)).catch(e=>{el(l(f(e)),{showDetails:!0}),process.exit(1)}),ex(process.argv.slice(2));
+`)}}catch{}K&&K(),process.exit(1)}})}h(process.argv[1]??"").href===import.meta.url&&eO(process.argv.slice(2)).catch(e=>{ed(l(f(e)),{showDetails:!0}),process.exit(1)}),eO(process.argv.slice(2));

package/dist/src/client-shared.d.ts

@@ -1,4 +1,4 @@
-import type { AgentDeviceDevice, AgentDeviceIdentifiers, AgentDeviceSession, AgentDeviceSessionDevice, AppCloseResult, AppDeployResult, AppOpenResult, CaptureSnapshotResult, EnsureSimulatorResult, RuntimeResult, SessionCloseResult } from './client-types.ts';
+import type { AgentDeviceDevice, AgentDeviceIdentifiers, AgentDeviceSession, AgentDeviceSessionDevice, AppCloseResult, AppDeployResult, AppInstallFromSourceResult, AppOpenResult, CaptureSnapshotResult, EnsureSimulatorResult, RuntimeResult, SessionCloseResult } from './client-types.ts';
 import type { Platform } from './utils/device.ts';
 export declare function buildAppIdentifiers(params: {
     session?: string;
@@ -15,6 +15,7 @@ export declare function serializeDevice(device: AgentDeviceDevice): Record<strin
 export declare function serializeEnsureSimulatorResult(result: EnsureSimulatorResult): Record<string, unknown>;
 export declare function serializeRuntimeResult(result: RuntimeResult): Record<string, unknown>;
 export declare function serializeDeployResult(result: AppDeployResult): Record<string, unknown>;
+export declare function serializeInstallFromSourceResult(result: AppInstallFromSourceResult): Record<string, unknown>;
 export declare function serializeOpenResult(result: AppOpenResult): Record<string, unknown>;
 export declare function serializeCloseResult(result: SessionCloseResult | AppCloseResult): Record<string, unknown>;
 export declare function serializeSnapshotResult(result: CaptureSnapshotResult): Record<string, unknown>;

package/dist/src/daemon.js

@@ -27,7 +27,7 @@ ${a.stderr}`.toLowerCase()))throw new w("COMMAND_FAILED",`simctl uninstall faile
 `,"utf8"),await nt(e,["push",e.id,t,n])}finally{await L.rm(a,{recursive:!0,force:!0})}}async function nm(e,t,r,a,i){iL(e,"settings"),await iM(e);let n=t.toLowerCase();switch(n){case"wifi":{let t=ng(r);await nt(e,["status_bar",e.id,"override","--wifiMode",t?"active":"failed"]);return}case"airplane":return void(ng(r)?await nt(e,["status_bar",e.id,"override","--dataNetwork","hide","--wifiMode","failed","--wifiBars","0","--cellularMode","failed","--cellularBars","0","--operatorName",""]):await nt(e,["status_bar",e.id,"clear"]));case"location":{let t=ng(r);if(!a)throw new w("INVALID_ARGS","location setting requires an active app in session");await nt(e,["privacy",e.id,t?"grant":"revoke","location",a]);return}case"faceid":case"touchid":{let t=nA[n],a=function(e,t){let r=e.trim().toLowerCase();if("match"===r)return"match";if("nonmatch"===r)return"nonmatch";if("enroll"===r)return"enroll";if("unenroll"===r)return"unenroll";throw new w("INVALID_ARGS",`Invalid ${t} state: ${e}. Use match|nonmatch|enroll|unenroll.`)}(r,n);await nN(e,a,{settingName:n,label:t.label,modalityAliases:t.modalityAliases});return}case"appearance":{let t=await nI(e,r);await nt(e,["ui",e.id,"appearance",t]);return}case"permission":{var o;if(!a)throw new w("INVALID_ARGS","permission setting requires an active app in session");let t="deny"===(o=a5(r))?"revoke":o,n=function(e,t){let r=a6(e);if("photos"!==r&&t?.trim())throw new w("INVALID_ARGS",`Permission mode is only supported for photos. Received: ${t}.`);if("camera"===r)return"camera";if("microphone"===r)return"microphone";if("contacts"===r)return"contacts";if("contacts-limited"===r)return"contacts-limited";if("notifications"===r)return"notifications";if("calendar"===r)return"calendar";if("location"===r)return"location";if("location-always"===r)return"location-always";if("media-library"===r)return"media-library";if("motion"===r)return"motion";if("reminders"===r)return"reminders";if("siri"===r)return"siri";if("photos"===r){let e=t?.trim().toLowerCase();if(!e||"full"===e)return"photos";if("limited"===e)return"photos-add";throw new w("INVALID_ARGS",`Invalid photos mode: ${t}. Use full|limited.`)}throw new w("INVALID_ARGS",`Unsupported permission target: ${e}. Use camera|microphone|photos|contacts|contacts-limited|notifications|calendar|location|location-always|media-library|motion|reminders|siri.`)}(i?.permissionTarget,i?.permissionMode);await nv(e,t,n,a);return}default:throw new w("INVALID_ARGS",`Unsupported setting: ${t}`)}}async function nh(e,t="all"){var r;return"simulator"===e.kind?(r=await nw(e),"user-installed"===t?r.filter(e=>!e.bundleId.startsWith("com.apple.")):r):await iN(e,t)}async function nw(e){let t=(await nt(e,["listapps",e.id],{allowFailure:!0})).stdout.trim();if(!t)return[];let r=null;if(t.startsWith("{"))try{r=JSON.parse(t)}catch{r=null}if(!r&&t.startsWith("{"))try{let e=await c("plutil",["-convert","json","-o","-","-"],{allowFailure:!0,stdin:t});0===e.exitCode&&e.stdout.trim().startsWith("{")&&(r=JSON.parse(e.stdout))}catch{r=null}return r?Object.entries(r).map(([e,t])=>({bundleId:e,name:t.CFBundleDisplayName??t.CFBundleName??e})):[]}function ng(e){let t=e.toLowerCase();if("on"===t||"true"===t||"1"===t)return!0;if("off"===t||"false"===t||"0"===t)return!1;throw new w("INVALID_ARGS",`Invalid setting state: ${e}`)}async function nI(e,t){let r=a9(t);if("toggle"!==r)return r;let a=await nt(e,["ui",e.id,"appearance"],{allowFailure:!0});if(0!==a.exitCode)throw new w("COMMAND_FAILED","Failed to read current iOS appearance",{stdout:a.stdout,stderr:a.stderr,exitCode:a.exitCode});let i=function(e,t){let r=/\b(light|dark|unsupported|unknown)\b/i.exec(`${e}
 ${t}`);if(!r)return null;let a=r[1].toLowerCase();return"dark"===a?"dark":"light"===a?"light":null}(a.stdout,a.stderr);if(!i)throw new w("COMMAND_FAILED","Unable to determine current iOS appearance for toggle",{stdout:a.stdout,stderr:a.stderr});return"dark"===i?"light":"dark"}let nA={faceid:{label:"Face ID",modalityAliases:["face"]},touchid:{label:"Touch ID",modalityAliases:["finger","touch"]}};async function nv(e,t,r,a){let i=await nb(e);if(!i.has(r))throw new w("UNSUPPORTED_OPERATION",`iOS simctl privacy does not support service "${r}" on this runtime.`,{deviceId:e.id,appBundleId:a,hint:`Supported services: ${Array.from(i).sort().join(", ")}`});let n=["privacy",e.id,t,r,a],o="notifications"===r;if(!("reset"===t&&o))try{await nt(e,n);return}catch(t){if(!(o&&ny(t)))throw t;throw new w("UNSUPPORTED_OPERATION","iOS simulator does not support setting notifications permission via simctl privacy on this runtime.",{deviceId:e.id,appBundleId:a,hint:"Use reset notifications for reprompt behavior, or toggle notifications manually in Settings."})}try{await nt(e,n);return}catch(e){if(!ny(e))throw e}try{await nt(e,["privacy",e.id,"reset","all",a])}catch(t){throw new w("COMMAND_FAILED","iOS simulator blocked direct notifications reset. Fallback reset-all also failed.",{deviceId:e.id,appBundleId:a,hint:"Use reinstall to force a fresh notifications prompt, or reset simulator content and settings."},t instanceof Error?t:void 0)}}function ny(e){if(!(e instanceof w)||"COMMAND_FAILED"!==e.code)return!1;let t=String(e.details?.stderr??"").toLowerCase();return(t.includes("failed to grant access")||t.includes("failed to revoke access")||t.includes("failed to reset access"))&&t.includes("operation not permitted")}async function nb(e){let r=eD(e.simulatorSetPath),a=`${process.env.PATH??""}::${r??""}`;if(ne&&t===a)return ne;let i=await nt(e,["privacy","help"],{allowFailure:!0}),n=function(e){let t=new Set,r=!1;for(let a of e.split("\n")){let e=a.trim();if(!e)continue;if("service"===e){r=!0;continue}if(!r)continue;if(e.startsWith("bundle identifier"))break;let i=/^([a-z-]+)\s+-\s+/.exec(e);i&&t.add(i[1])}return t}(`${i.stdout}
 ${i.stderr}`);if(0===n.size)throw new w("COMMAND_FAILED","Unable to determine supported simctl privacy services",{stdout:i.stdout,stderr:i.stderr,exitCode:i.exitCode,hint:"Run `xcrun simctl privacy help` manually to verify available services for this runtime."});return ne=n,t=a,n}async function nN(e,t,r){let a=function(e,t,r){let a=r.length>0?r:["face"];switch(t){case"match":return a.flatMap(t=>[["biometric",e,"match",t],["biometric","match",e,t]]);case"nonmatch":return a.flatMap(t=>[["biometric",e,"nonmatch",t],["biometric",e,"nomatch",t],["biometric","nonmatch",e,t],["biometric","nomatch",e,t]]);case"enroll":return[["biometric",e,"enroll","yes"],["biometric",e,"enroll","1"],["biometric","enroll",e,"yes"],["biometric","enroll",e,"1"]];case"unenroll":return[["biometric",e,"enroll","no"],["biometric",e,"enroll","0"],["biometric","enroll",e,"no"],["biometric","enroll",e,"0"]]}}(e.id,t,r.modalityAliases),i=[];for(let t of a){let r=eO(e,t),a=await c("xcrun",r,{allowFailure:!0});if(0===a.exitCode)return;i.push({args:r,stderr:a.stderr,stdout:a.stdout,exitCode:a.exitCode})}let n=i.map(e=>({args:e.args.join(" "),exitCode:e.exitCode,stderr:e.stderr.slice(0,400)}));if(i.length>0&&i.every(e=>{var t,r;let a;return t=e.stdout,r=e.stderr,(a=`${t}
-${r}`.toLowerCase()).includes("unrecognized subcommand")||a.includes("unknown subcommand")||a.includes("not supported")||a.includes("unavailable")||a.includes("biometric")&&a.includes("invalid")}))throw new w("UNSUPPORTED_OPERATION",`${r.label} simulation is not supported on this simulator runtime.`,{deviceId:e.id,action:t,setting:r.settingName,attempts:n});throw new w("COMMAND_FAILED",`Failed to simulate ${r.settingName}.`,{deviceId:e.id,action:t,setting:r.settingName,attempts:n})}async function n_(e,t){await iM(e),await iO();let r=0,a=Q.fromTimeoutMs(ig);try{await ee(async({deadline:r})=>{var a;if(r?.isExpired())throw new w("COMMAND_FAILED","App launch deadline exceeded",{timeoutMs:ig});let i=(a=["launch",e.id,t],eO(e,a)),n=await c("xcrun",i,{allowFailure:!0});if(0!==n.exitCode)throw new w("COMMAND_FAILED",`xcrun exited with code ${n.exitCode}`,{cmd:"xcrun",args:i,stdout:n.stdout,stderr:n.stderr,exitCode:n.exitCode})},{maxAttempts:10,baseDelayMs:1e3,maxDelayMs:5e3,jitter:.2,shouldRetry:e=>!!iE(e)&&(r+=1)<3},{deadline:a})}catch(r){if(iE(r)){var i;let a=(i=await ik(e,t)).installed?!1===i.simulatorCompatible?"ARCH_MISMATCH":"PERSISTENT_LAUNCH_FAIL":"APP_NOT_INSTALLED";r.details={...r.details,hint:function(e){switch(e){case"ARCH_MISMATCH":return"The app binary was not built for the simulator platform. Rebuild with a simulator destination or use a physical device.";case"APP_NOT_INSTALLED":return"The app bundle is not installed on this simulator. Run install before open.";case"PERSISTENT_LAUNCH_FAIL":return"The simulator repeatedly refused to launch the app. Inspect crash logs in Console.app or ~/Library/Logs/DiagnosticReports/ and consider reinstalling the app.";default:return"The simulator failed to launch the app. Retry with --debug and inspect diagnostics log for details."}}(a)}}throw r}}async function nS(e,t,r){let a=["device","process","launch","--device",e.id,t];r?.payloadUrl&&a.push("--payload-url",r.payloadUrl),await ib(a,{action:"launch iOS app",deviceId:e.id})}let nD=/^[A-Za-z0-9_.:-]{1,64}$/,nE=[[0,0],[1,0],[0,1],[-1,0],[0,-1],[1,1],[-1,1],[1,-1],[-1,-1]];function nk(e,t,r,a){if(!Number.isFinite(e)||!Number.isInteger(e)||e<r||e>a)throw new w("INVALID_ARGS",`${t} must be an integer between ${r} and ${a}`);return e}async function nL(e,t,r){for(let a=0;a<e;a+=1)await r(a),a<e-1&&t>0&&await nO(t)}async function nO(e){await new Promise(t=>setTimeout(t,e))}function nM(e,t){let r,a=t?.subject??"Payload",i=e.trim();if(!i)throw new w("INVALID_ARGS",`${a} cannot be empty`);let n=t?.expandPath?t.expandPath(i,t.cwd):i;try{if(!C.statSync(n).isFile())throw new w("INVALID_ARGS",`${a} path is not a file: ${n}`);return{kind:"file",path:n}}catch(t){if(t instanceof w)throw t;let e=t.code;if("EACCES"===e||"EPERM"===e)throw new w("INVALID_ARGS",`${a} file is not readable: ${n}`);if(e&&"ENOENT"!==e)throw new w("COMMAND_FAILED",`Unable to read ${a} file: ${n}`,{cause:String(t)})}if((r=i.trim()).startsWith("{")&&r.endsWith("}")||r.startsWith("[")&&r.endsWith("]"))return{kind:"inline",text:i};throw new w("INVALID_ARGS",`${a} file not found: ${n}`)}async function nx(e){let t=nM(e,{subject:"Push payload"}),r="inline"===t.kind?t.text:await nC(t.path);try{let e=JSON.parse(r);if(!e||"object"!=typeof e||Array.isArray(e))throw new w("INVALID_ARGS","push payload must be a JSON object");return e}catch(t){if(t instanceof w)throw t;throw new w("INVALID_ARGS",`Invalid push payload JSON: ${e}`)}}async function nC(e){try{return await L.readFile(e,"utf8")}catch(r){let t=r.code;if("ENOENT"===t)throw new w("INVALID_ARGS",`Push payload file not found: ${e}`);if("EISDIR"===t)throw new w("INVALID_ARGS",`Push payload path is not a file: ${e}`);if("EACCES"===t||"EPERM"===t)throw new w("INVALID_ARGS",`Push payload file is not readable: ${e}`);throw new w("COMMAND_FAILED",`Unable to read push payload file: ${e}`,{cause:String(r)})}}let nR=ey(process.env.AGENT_DEVICE_IOS_DEVICECTL_LIST_TIMEOUT_MS,8e3,500),nT=/^(iphone|ipad|ipod|appletv)/i,nP=/^appletv/i,n$=["apple tv","appletv","tvos"];function nU(e){return(e??"").trim().toLowerCase()}function nF(e){return nU(e.hardwareProperties?.platform)}function nV(e){return e.includes("tvos")}function nG(e){return nV(nU(e))?"tv":"mobile"}function nB(e){let t=nU(e);return t.includes("ios")||t.includes("tvos")}function nj(e){let t=nU(e);return n$.some(e=>t.includes(e))}function nq(e){return[e.name??"",e.deviceProperties?.name??"",e.deviceProperties?.deviceType??""]}function nH(e){return e.hardwareProperties?.productType??e.deviceProperties?.productType??""}async function nW(e={}){let t,r,a=eD(e.simulatorSetPath),i=e.target;try{t=await c("xcrun",eL(["list","devices","-j"],{simulatorSetPath:a}))}catch{return null}try{r=JSON.parse(t.stdout)}catch{return null}let n=null,o=null,s=null;for(let[e,t]of Object.entries(r.devices)){if(!nB(e))continue;let r=nG(e);if(!i||r===i)for(let e of t){if(!e.isAvailable)continue;let t={platform:"ios",id:e.udid,name:e.name,kind:"simulator",target:r,booted:"Booted"===e.state,...a?{simulatorSetPath:a}:{}};t.booted&&(n=n??t),"mobile"===r&&(o=o??t),s=s??t}}return n??o??s}async function nz(e={}){if("darwin"!==process.platform)throw new w("UNSUPPORTED_PLATFORM","iOS tools are only available on macOS");if(!await I("xcrun"))throw new w("TOOL_MISSING","xcrun not found in PATH");let t=[],r=eD(e.simulatorSetPath),a=await c("xcrun",eL(["list","devices","-j"],{simulatorSetPath:r}));try{let e=JSON.parse(a.stdout);for(let[a,i]of Object.entries(e.devices))if(nB(a))for(let e of i)e.isAvailable&&t.push({platform:"ios",id:e.udid,name:e.name,kind:"simulator",target:nG(a),booted:"Booted"===e.state,...r?{simulatorSetPath:r}:{}})}catch(e){throw new w("COMMAND_FAILED","Failed to parse simctl devices JSON",void 0,e)}if(r)return t;let n=null;try{n=i.join(T.tmpdir(),`agent-device-devicectl-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}.json`);let e=await c("xcrun",["devicectl","list","devices","--json-output",n],{allowFailure:!0,timeoutMs:nR});if(0!==e.exitCode)return t;let r=await L.readFile(n,"utf8"),a=JSON.parse(r);for(let e of a.result?.devices??[])if(function(e){var t;let r=nF(e);return!!(r.includes("ios")||r.includes("tvos"))||(t=nH(e),!!nT.test(t.trim())||nq(e).some(nj))}(e)){let r=e.hardwareProperties?.udid??e.identifier??"",a=e.name??e.deviceProperties?.name??r;if(!r)continue;t.push({platform:"ios",id:r,name:a,kind:"device",target:function(e){var t;return nV(nF(e))?"tv":(t=nH(e),nP.test(t.trim())||nq(e).some(nj))?"tv":"mobile"}(e),booted:!0})}}catch{}finally{n&&await L.rm(n,{force:!0}).catch(()=>{})}return t}async function nJ(e,t,r,a){let i,n=!!(t.udid||t.serial||t.deviceName);try{i=await a.resolveDevice(e,t,r)}catch(e){if(n||!(e instanceof w)||"DEVICE_NOT_FOUND"!==e.code)throw e}if(!n&&(!i||"device"===i.kind)){let e=await a.findBootableSimulator({simulatorSetPath:r.simulatorSetPath,target:t.target});if(e)return e}if(i)return i;throw new w("DEVICE_NOT_FOUND","No devices found",{selector:t})}async function nK(e){let t=eJ(e.platform),r=eD(e.iosSimulatorDeviceSet),a=ek(e.androidDeviceAllowlist);return await E("resolve_target_device",async()=>{let i={platform:t,target:e.target,deviceName:e.device,udid:e.udid,serial:e.serial};if(i.target&&!i.platform)throw new w("INVALID_ARGS","Device target selector requires --platform. Use --platform ios|android|apple with --target mobile|tv.");if("android"===i.platform){await rd();let e=await rS({serialAllowlist:a});return await eK(e,i)}if("ios"===i.platform){let e=await nz({simulatorSetPath:r});return await nJ(e,i,{simulatorSetPath:r},{resolveDevice:eK,findBootableSimulator:nW})}let n=[];try{n.push(...await rS({serialAllowlist:a}))}catch{}try{n.push(...await nz({simulatorSetPath:r}))}catch{}return await eK(n,i,{simulatorSetPath:r})},{platform:t,target:e.target})}async function nX(e,t,r,a,n){let o=function(e,t){switch(e.platform){case"android":return{open:(t,r)=>as(e,t,r?.activity),openDevice:()=>ac(e),close:t=>ap(e,t),tap:(t,r)=>aP(e,t,r),doubleTap:async(t,r)=>{await aP(e,t,r),await aP(e,t,r)},swipe:(t,r,a,i,n)=>a$(e,t,r,a,i,n),longPress:(t,r,a)=>aG(e,t,r,a),focus:(t,r)=>aj(e,t,r),type:t=>aB(e,t),fill:(t,r,a)=>aq(e,t,r,a),scroll:(t,r)=>aH(e,t,r),scrollIntoView:t=>aW(e,t),screenshot:(t,r)=>iu(e,t),back:()=>aU(e),home:()=>aF(e),appSwitcher:()=>aV(e),readClipboard:()=>a2(e),writeClipboard:t=>a3(e,t),setSetting:(t,r,a,i)=>a7(e,t,r,a,i)};case"ios":{var r,a;let i,n,{overrides:o,runnerOpts:s}=(r=e,i={verbose:(a=t).verbose,logPath:a.logPath,traceLogPath:a.traceLogPath,requestId:a.requestId},n=()=>{if(ec(a.requestId))throw ef()},{runnerOpts:i,overrides:{tap:async(e,t)=>{await tu(r,{command:"tap",x:e,y:t,appBundleId:a.appBundleId},i)},doubleTap:async(e,t)=>{await tu(r,{command:"tapSeries",x:e,y:t,count:1,intervalMs:0,doubleTap:!0,appBundleId:a.appBundleId},i)},swipe:async(e,t,n,o,s)=>{await tu(r,{command:"drag",x:e,y:t,x2:n,y2:o,durationMs:s,appBundleId:a.appBundleId},i)},longPress:async(e,t,n)=>{await tu(r,{command:"longPress",x:e,y:t,durationMs:n,appBundleId:a.appBundleId},i)},focus:async(e,t)=>{await tu(r,{command:"tap",x:e,y:t,appBundleId:a.appBundleId},i)},type:async e=>{await tu(r,{command:"type",text:e,appBundleId:a.appBundleId},i)},fill:async(e,t,n)=>{await tu(r,{command:"tap",x:e,y:t,appBundleId:a.appBundleId},i),await tu(r,{command:"type",text:n,clearFirst:!0,appBundleId:a.appBundleId},i)},scroll:async(e,t)=>{if(!["up","down","left","right"].includes(e))throw new w("INVALID_ARGS",`Unknown direction: ${e}`);let n=function(e){switch(e){case"up":return"down";case"down":return"up";case"left":return"right";case"right":return"left"}}(e);await tu(r,{command:"swipe",direction:n,appBundleId:a.appBundleId},i)},scrollIntoView:async e=>{let t=await tu(r,{command:"findText",text:e,appBundleId:a.appBundleId},i);if(t?.found)return{attempts:1};for(let t=0;t<12;t+=1){for(let e=0;e<4;e+=1)n(),await tu(r,{command:"swipe",direction:"up",appBundleId:a.appBundleId},i),await new Promise(e=>setTimeout(e,80));n();let o=await tu(r,{command:"findText",text:e,appBundleId:a.appBundleId},i);if(o?.found)return{attempts:t+2}}throw new w("COMMAND_FAILED",`scrollintoview could not find text: ${e}`)}}});return{open:(t,r)=>ni(e,t,{appBundleId:r?.appBundleId,url:r?.url}),openDevice:()=>nn(e),close:t=>no(e,t),screenshot:(t,r)=>iY(e,t,r),back:async()=>{await tu(e,{command:"back",appBundleId:t.appBundleId},s)},home:async()=>{await tu(e,{command:"home",appBundleId:t.appBundleId},s)},appSwitcher:async()=>{await tu(e,{command:"appSwitcher",appBundleId:t.appBundleId},s)},readClipboard:()=>nc(e),writeClipboard:t=>np(e,t),setSetting:(t,r,a,i)=>nm(e,t,r,a,i),...o}}default:throw new w("UNSUPPORTED_PLATFORM",`Unsupported platform: ${e.platform}`)}}(e,{requestId:n?.requestId,appBundleId:n?.appBundleId,verbose:n?.verbose,logPath:n?.logPath,traceLogPath:n?.traceLogPath});return k({level:"debug",phase:"platform_command_prepare",data:{command:t,platform:e.platform,kind:e.kind}}),await E("platform_command",async()=>{switch(t){case"open":{let t=r[0],a=r[1];if(r.length>2)throw new w("INVALID_ARGS","open accepts at most two arguments: <app|url> [url]");if(!t)return await o.openDevice(),{app:null};if(void 0!==a){if("ios"!==e.platform)throw new w("INVALID_ARGS","open <app> <url> is supported only on iOS");if(rp(t))throw new w("INVALID_ARGS","open <app> <url> requires an app target as the first argument");if(!rp(a))throw new w("INVALID_ARGS","open <app> <url> requires a valid URL target");return await o.open(t,{activity:n?.activity,appBundleId:n?.appBundleId,url:a}),{app:t,url:a}}return await o.open(t,{activity:n?.activity,appBundleId:n?.appBundleId}),{app:t}}case"close":{let e=r[0];if(!e)return{closed:"session"};return await o.close(e),{app:e}}case"press":{let[t,a]=r.map(Number);if(Number.isNaN(t)||Number.isNaN(a))throw new w("INVALID_ARGS","press requires x y");let i=nk(n?.count??1,"count",1,200),s=nk(n?.intervalMs??0,"interval-ms",0,1e4),l=nk(n?.holdMs??0,"hold-ms",0,1e4),d=nk(n?.jitterPx??0,"jitter-px",0,100),u=n?.doubleTap===!0;if(u&&l>0)throw new w("INVALID_ARGS","double-tap cannot be combined with hold-ms");if(u&&d>0)throw new w("INVALID_ARGS","double-tap cannot be combined with jitter-px");if("ios"===e.platform&&i>1&&0===l&&0===d)return await tu(e,{command:"tapSeries",x:t,y:a,count:i,intervalMs:s,doubleTap:u,appBundleId:n?.appBundleId},{verbose:n?.verbose,logPath:n?.logPath,traceLogPath:n?.traceLogPath,requestId:n?.requestId}),{x:t,y:a,count:i,intervalMs:s,holdMs:l,jitterPx:d,doubleTap:u,timingMode:"runner-series"};return await nL(i,s,async e=>{let[r,i]=function(e,t){if(t<=0)return[0,0];let[r,a]=nE[e%nE.length];return[r*t,a*t]}(e,d),n=t+r,s=a+i;u?await o.doubleTap(n,s):l>0?await o.longPress(n,s,l):await o.tap(n,s)}),{x:t,y:a,count:i,intervalMs:s,holdMs:l,jitterPx:d,doubleTap:u}}case"swipe":{let t=Number(r[0]),a=Number(r[1]),i=Number(r[2]),s=Number(r[3]);if([t,a,i,s].some(Number.isNaN))throw new w("INVALID_ARGS","swipe requires x1 y1 x2 y2 [durationMs]");let l=nk(r[4]?Number(r[4]):250,"durationMs",16,1e4),d="ios"===e.platform?Math.min(60,Math.max(16,Math.round(l))):l,u=nk(n?.count??1,"count",1,200),c=nk(n?.pauseMs??0,"pause-ms",0,1e4),p=n?.pattern??"one-way";if("one-way"!==p&&"ping-pong"!==p)throw new w("INVALID_ARGS",`Invalid pattern: ${p}`);if("ios"===e.platform&&u>1)return await tu(e,{command:"dragSeries",x:t,y:a,x2:i,y2:s,durationMs:d,count:u,pauseMs:c,pattern:p,appBundleId:n?.appBundleId},{verbose:n?.verbose,logPath:n?.logPath,traceLogPath:n?.traceLogPath,requestId:n?.requestId}),{x1:t,y1:a,x2:i,y2:s,durationMs:l,effectiveDurationMs:d,timingMode:"runner-series",count:u,pauseMs:c,pattern:p};return await nL(u,c,async e=>{"ping-pong"===p&&e%2==1?await o.swipe(i,s,t,a,d):await o.swipe(t,a,i,s,d)}),{x1:t,y1:a,x2:i,y2:s,durationMs:l,effectiveDurationMs:d,timingMode:"ios"===e.platform?"safe-normalized":"direct",count:u,pauseMs:c,pattern:p}}case"longpress":{let e=Number(r[0]),t=Number(r[1]),a=r[2]?Number(r[2]):void 0;if(Number.isNaN(e)||Number.isNaN(t))throw new w("INVALID_ARGS","longpress requires x y [durationMs]");return await o.longPress(e,t,a),{x:e,y:t,durationMs:a}}case"focus":{let[e,t]=r.map(Number);if(Number.isNaN(e)||Number.isNaN(t))throw new w("INVALID_ARGS","focus requires x y");return await o.focus(e,t),{x:e,y:t}}case"type":{let e=r.join(" ");if(!e)throw new w("INVALID_ARGS","type requires text");return await o.type(e),{text:e}}case"fill":{let e=Number(r[0]),t=Number(r[1]),a=r.slice(2).join(" ");if(Number.isNaN(e)||Number.isNaN(t)||!a)throw new w("INVALID_ARGS","fill requires x y text");return await o.fill(e,t,a),{x:e,y:t,text:a}}case"scroll":{let e=r[0],t=r[1]?Number(r[1]):void 0;if(!e)throw new w("INVALID_ARGS","scroll requires direction");return await o.scroll(e,t),{direction:e,amount:t}}case"scrollintoview":{let e=r.join(" ").trim();if(!e)throw new w("INVALID_ARGS","scrollintoview requires text");let t=await o.scrollIntoView(e);if(t?.attempts)return{text:e,attempts:t.attempts};return{text:e}}case"pinch":{if("android"===e.platform)throw new w("UNSUPPORTED_OPERATION","Android pinch is not supported in current adb backend; requires instrumentation-based backend.");let t=Number(r[0]),a=r[1]?Number(r[1]):void 0,i=r[2]?Number(r[2]):void 0;if(Number.isNaN(t)||t<=0)throw new w("INVALID_ARGS","pinch requires scale > 0");return await tu(e,{command:"pinch",scale:t,x:a,y:i,appBundleId:n?.appBundleId},{verbose:n?.verbose,logPath:n?.logPath,traceLogPath:n?.traceLogPath,requestId:n?.requestId}),{scale:t,x:a,y:i}}case"trigger-app-event":{let{eventName:t,payload:a}=function(e){let t=e[0]?.trim(),r=e[1]?.trim();if(!t)throw new w("INVALID_ARGS","trigger-app-event requires <event> [payloadJson]");if(!nD.test(t))throw new w("INVALID_ARGS",`Invalid trigger-app-event event name: ${t}`,{hint:"Use 1-64 chars: letters, numbers, underscore, dot, colon, or dash."});if(e.length>2)throw new w("INVALID_ARGS","trigger-app-event accepts at most two arguments: <event> [payloadJson]");let a=function(e,t){if(e)try{let r=JSON.parse(e);if(!r||"object"!=typeof r||Array.isArray(r))throw new w("INVALID_ARGS",`trigger-app-event payload for "${t}" must be a JSON object`);let a=JSON.stringify(r);if(Buffer.byteLength(a,"utf8")>8192)throw new w("INVALID_ARGS",`trigger-app-event payload for "${t}" exceeds 8192 bytes`);return r}catch(t){if(t instanceof w)throw t;throw new w("INVALID_ARGS",`Invalid trigger-app-event payload JSON: ${e}`)}}(r,t);return{eventName:t,payload:a}}(r),i=function(e,t,r){let a,i=(a=("ios"===e?process.env.AGENT_DEVICE_IOS_APP_EVENT_URL_TEMPLATE:process.env.AGENT_DEVICE_ANDROID_APP_EVENT_URL_TEMPLATE)??process.env.AGENT_DEVICE_APP_EVENT_URL_TEMPLATE,a?.trim()||void 0);if(!i)throw new w("UNSUPPORTED_OPERATION",`No app event URL template configured for ${e}.`,{hint:`Set AGENT_DEVICE_${e.toUpperCase()}_APP_EVENT_URL_TEMPLATE or AGENT_DEVICE_APP_EVENT_URL_TEMPLATE, for example "myapp://agent-device/event?name={event}&payload={payload}".`});let n=r?JSON.stringify(r):"",o=i.replaceAll("{event}",encodeURIComponent(t)).replaceAll("{payload}",encodeURIComponent(n)).replaceAll("{platform}",encodeURIComponent(e));if(o.length>4096)throw new w("INVALID_ARGS","trigger-app-event URL exceeds maximum supported length",{hint:"Reduce payload size or shorten AGENT_DEVICE_*_APP_EVENT_URL_TEMPLATE.",length:o.length,maxLength:4096});return o}(e.platform,t,a);return await o.open(i,{appBundleId:n?.appBundleId}),{event:t,eventUrl:i,transport:"deep-link"}}case"screenshot":{let e=r[0]??a??`./screenshot-${Date.now()}.png`;return await L.mkdir(i.dirname(e),{recursive:!0}),await o.screenshot(e,n?.appBundleId),{path:e}}case"back":return await o.back(),{action:"back"};case"home":return await o.home(),{action:"home"};case"app-switcher":return await o.appSwitcher(),{action:"app-switcher"};case"clipboard":{let e=(r[0]??"").toLowerCase();if("read"!==e&&"write"!==e)throw new w("INVALID_ARGS","clipboard requires a subcommand: read or write");if("read"===e){if(1!==r.length)throw new w("INVALID_ARGS","clipboard read does not accept additional arguments");return{action:e,text:await o.readClipboard()}}if(r.length<2)throw new w("INVALID_ARGS",'clipboard write requires text (use "" to clear clipboard)');let t=r.slice(1).join(" ");return await o.writeClipboard(t),{action:e,textLength:Array.from(t).length}}case"keyboard":{if("android"!==e.platform)throw new w("UNSUPPORTED_OPERATION","keyboard is currently supported only on Android");let t=(r[0]??"status").toLowerCase();if("status"!==t&&"get"!==t&&"dismiss"!==t)throw new w("INVALID_ARGS","keyboard requires a subcommand: status, get, or dismiss");if(r.length>1)throw new w("INVALID_ARGS","keyboard accepts at most one subcommand argument");if("dismiss"===t){let t=await a1(e);return{platform:"android",action:"dismiss",attempts:t.attempts,wasVisible:t.wasVisible,dismissed:t.dismissed,visible:t.visible,inputType:t.inputType,type:t.type}}let a=await a0(e);return{platform:"android",action:"status",visible:a.visible,inputType:a.inputType,type:a.type}}case"settings":{let[t,a,i,s,l]=r,d="permission"===t?{permissionTarget:i,permissionMode:s}:void 0;return k({level:"debug",phase:"settings_apply",data:{setting:t,state:a,target:i,mode:s,platform:e.platform}}),await o.setSetting(t,a,l??n?.appBundleId,d),{setting:t,state:a}}case"push":{let t=r[0]?.trim(),a=r[1]?.trim();if(!t||!a)throw new w("INVALID_ARGS","push requires <bundle|package> <payload.json|inline-json>");let i=await nx(a);if("ios"===e.platform)return await nf(e,t,i),{platform:"ios",bundleId:t};let n=await is(e,t,i);return{platform:"android",package:t,action:n.action,extrasCount:n.extrasCount}}case"snapshot":{if("ios"===e.platform){let t=await E("snapshot_capture",async()=>await tu(e,{command:"snapshot",appBundleId:n?.appBundleId,interactiveOnly:n?.snapshotInteractiveOnly,compact:n?.snapshotCompact,depth:n?.snapshotDepth,scope:n?.snapshotScope,raw:n?.snapshotRaw},{verbose:n?.verbose,logPath:n?.logPath,traceLogPath:n?.traceLogPath,requestId:n?.requestId}),{backend:"xctest"}),r=t.nodes??[];if(0===r.length&&"simulator"===e.kind)throw new w("COMMAND_FAILED","XCTest snapshot returned 0 nodes on iOS simulator.");return{nodes:r,truncated:t.truncated??!1,backend:"xctest"}}let t=await E("snapshot_capture",async()=>await aM(e,{interactiveOnly:n?.snapshotInteractiveOnly,compact:n?.snapshotCompact,depth:n?.snapshotDepth,scope:n?.snapshotScope,raw:n?.snapshotRaw}),{backend:"android"});return{nodes:t.nodes??[],truncated:t.truncated??!1,backend:"android"}}default:throw new w("INVALID_ARGS",`Unknown command: ${t}`)}},{command:t,platform:e.platform})}let nZ={alert:{ios:{simulator:!0},android:{}},pinch:{ios:{simulator:!0},android:{}},"app-switcher":{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},apps:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},back:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},boot:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},click:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},clipboard:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},keyboard:{ios:{},android:{emulator:!0,device:!0,unknown:!0}},close:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},fill:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},diff:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},find:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},focus:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},get:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},is:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},home:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},logs:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},network:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},longpress:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},open:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},perf:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},install:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},reinstall:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},press:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},push:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},record:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},screenshot:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},scroll:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},scrollintoview:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},swipe:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},settings:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},snapshot:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},"trigger-app-event":{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},type:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},wait:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}}};function nY(e,t){let r=nZ[e];if(!r)return!0;let a=r[t.platform];return!!a&&!0===a[t.kind??"unknown"]}function nQ(e,t,r,a,i){return{requestId:i??S().requestId,appBundleId:r,activity:t?.activity,verbose:t?.verbose,logPath:e,traceLogPath:a,snapshotInteractiveOnly:t?.snapshotInteractiveOnly,snapshotCompact:t?.snapshotCompact,snapshotDepth:t?.snapshotDepth,snapshotScope:t?.snapshotScope,snapshotRaw:t?.snapshotRaw,count:t?.count,intervalMs:t?.intervalMs,holdMs:t?.holdMs,jitterPx:t?.jitterPx,doubleTap:t?.doubleTap,pauseMs:t?.pauseMs,pattern:t?.pattern}}let n0=ey(process.env.AGENT_DEVICE_IOS_DEVICE_READY_TIMEOUT_MS,15e3,1e3);async function n1(e){if("ios"===e.platform){if("simulator"===e.kind){let{ensureBootedSimulator:t}=await Promise.resolve().then(()=>({ensureBootedSimulator:iM}));await t(e);return}if("device"===e.kind)return void await n2(e.id)}if("android"===e.platform){let{waitForAndroidBoot:t}=await Promise.resolve().then(()=>({waitForAndroidBoot:rx}));await t(e.id)}}async function n2(e){let t=i.join(T.tmpdir(),`agent-device-ready-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}.json`),r=Math.max(1,Math.ceil(n0/1e3));try{let a=await c("xcrun",["devicectl","device","info","details","--device",e,"--json-output",t,"--timeout",String(r)],{allowFailure:!0,timeoutMs:n0+3e3}),i=String(a.stdout??""),n=String(a.stderr??""),o=await n3(t);if(0===a.exitCode){if(!o.parsed)throw new w("COMMAND_FAILED","iOS device readiness probe failed",{kind:"probe_inconclusive",deviceId:e,stdout:i,stderr:n,hint:"CoreDevice returned success but readiness JSON output was missing or invalid. Retry; if it persists restart Xcode and the iOS device."});let t=o?.tunnelState?.toLowerCase();if("connecting"===t)throw new w("COMMAND_FAILED","iOS device is not ready for automation",{kind:"not_ready",deviceId:e,tunnelState:t,hint:"Device tunnel is still connecting. Keep the device unlocked and connected by cable until it is fully available in Xcode Devices, then retry."});return}throw new w("COMMAND_FAILED","iOS device is not ready for automation",{kind:"not_ready",deviceId:e,stdout:i,stderr:n,exitCode:a.exitCode,tunnelState:o?.tunnelState,hint:n4(i,n)})}catch(t){if(t instanceof w&&"COMMAND_FAILED"===t.code){if("not_ready"===("string"==typeof t.details?.kind?t.details.kind:""))throw t;let r=t.details??{},a=String(r.stdout??""),i=String(r.stderr??""),n=Number(r.timeoutMs??n0),o=`CoreDevice did not respond within ${n}ms. Keep the device unlocked and trusted, then retry; if it persists restart Xcode and the iOS device.`;throw new w("COMMAND_FAILED","iOS device readiness probe failed",{deviceId:e,cause:t.message,timeoutMs:n,stdout:a,stderr:i,hint:a||i?n4(a,i):o},t)}throw new w("COMMAND_FAILED","iOS device readiness probe failed",{deviceId:e,hint:"Reconnect the device, keep it unlocked, and retry."},t instanceof Error?t:void 0)}finally{await L.rm(t,{force:!0}).catch(()=>{})}}async function n3(e){try{let t=await L.readFile(e,"utf8"),r=JSON.parse(t),a=function(e){let t=e?.result;if(!t||"object"!=typeof t)return{};let r=t.connectionProperties?.tunnelState,a=t.device?.connectionProperties?.tunnelState,i="string"==typeof r?r:"string"==typeof a?a:void 0;return i?{tunnelState:i}:{}}(r);return{parsed:!0,tunnelState:a.tunnelState}}catch{return{parsed:!1}}}function n4(e,t){let r=iD(e,t);return r||(`${e}
+${r}`.toLowerCase()).includes("unrecognized subcommand")||a.includes("unknown subcommand")||a.includes("not supported")||a.includes("unavailable")||a.includes("biometric")&&a.includes("invalid")}))throw new w("UNSUPPORTED_OPERATION",`${r.label} simulation is not supported on this simulator runtime.`,{deviceId:e.id,action:t,setting:r.settingName,attempts:n});throw new w("COMMAND_FAILED",`Failed to simulate ${r.settingName}.`,{deviceId:e.id,action:t,setting:r.settingName,attempts:n})}async function n_(e,t){await iM(e),await iO();let r=0,a=Q.fromTimeoutMs(ig);try{await ee(async({deadline:r})=>{var a;if(r?.isExpired())throw new w("COMMAND_FAILED","App launch deadline exceeded",{timeoutMs:ig});let i=(a=["launch",e.id,t],eO(e,a)),n=await c("xcrun",i,{allowFailure:!0});if(0!==n.exitCode)throw new w("COMMAND_FAILED",`xcrun exited with code ${n.exitCode}`,{cmd:"xcrun",args:i,stdout:n.stdout,stderr:n.stderr,exitCode:n.exitCode})},{maxAttempts:10,baseDelayMs:1e3,maxDelayMs:5e3,jitter:.2,shouldRetry:e=>!!iE(e)&&(r+=1)<3},{deadline:a})}catch(r){if(iE(r)){var i;let a=(i=await ik(e,t)).installed?!1===i.simulatorCompatible?"ARCH_MISMATCH":"PERSISTENT_LAUNCH_FAIL":"APP_NOT_INSTALLED";r.details={...r.details,hint:function(e){switch(e){case"ARCH_MISMATCH":return"The app binary was not built for the simulator platform. Rebuild with a simulator destination or use a physical device.";case"APP_NOT_INSTALLED":return"The app bundle is not installed on this simulator. Run install before open.";case"PERSISTENT_LAUNCH_FAIL":return"The simulator repeatedly refused to launch the app. Inspect crash logs in Console.app or ~/Library/Logs/DiagnosticReports/ and consider reinstalling the app.";default:return"The simulator failed to launch the app. Retry with --debug and inspect diagnostics log for details."}}(a)}}throw r}}async function nS(e,t,r){let a=["device","process","launch","--device",e.id,t];r?.payloadUrl&&a.push("--payload-url",r.payloadUrl),await ib(a,{action:"launch iOS app",deviceId:e.id})}let nD=/^[A-Za-z0-9_.:-]{1,64}$/,nE=[[0,0],[1,0],[0,1],[-1,0],[0,-1],[1,1],[-1,1],[1,-1],[-1,-1]];function nk(e,t,r,a){if(!Number.isFinite(e)||!Number.isInteger(e)||e<r||e>a)throw new w("INVALID_ARGS",`${t} must be an integer between ${r} and ${a}`);return e}async function nL(e,t,r){for(let a=0;a<e;a+=1)await r(a),a<e-1&&t>0&&await nO(t)}async function nO(e){await new Promise(t=>setTimeout(t,e))}function nM(e,t){let r,a=t?.subject??"Payload",i=e.trim();if(!i)throw new w("INVALID_ARGS",`${a} cannot be empty`);let n=t?.expandPath?t.expandPath(i,t.cwd):i;try{if(!C.statSync(n).isFile())throw new w("INVALID_ARGS",`${a} path is not a file: ${n}`);return{kind:"file",path:n}}catch(t){if(t instanceof w)throw t;let e=t.code;if("EACCES"===e||"EPERM"===e)throw new w("INVALID_ARGS",`${a} file is not readable: ${n}`);if(e&&"ENOENT"!==e)throw new w("COMMAND_FAILED",`Unable to read ${a} file: ${n}`,{cause:String(t)})}if((r=i.trim()).startsWith("{")&&r.endsWith("}")||r.startsWith("[")&&r.endsWith("]"))return{kind:"inline",text:i};throw new w("INVALID_ARGS",`${a} file not found: ${n}`)}async function nx(e){let t=nM(e,{subject:"Push payload"}),r="inline"===t.kind?t.text:await nC(t.path);try{let e=JSON.parse(r);if(!e||"object"!=typeof e||Array.isArray(e))throw new w("INVALID_ARGS","push payload must be a JSON object");return e}catch(t){if(t instanceof w)throw t;throw new w("INVALID_ARGS",`Invalid push payload JSON: ${e}`)}}async function nC(e){try{return await L.readFile(e,"utf8")}catch(r){let t=r.code;if("ENOENT"===t)throw new w("INVALID_ARGS",`Push payload file not found: ${e}`);if("EISDIR"===t)throw new w("INVALID_ARGS",`Push payload path is not a file: ${e}`);if("EACCES"===t||"EPERM"===t)throw new w("INVALID_ARGS",`Push payload file is not readable: ${e}`);throw new w("COMMAND_FAILED",`Unable to read push payload file: ${e}`,{cause:String(r)})}}let nR=ey(process.env.AGENT_DEVICE_IOS_DEVICECTL_LIST_TIMEOUT_MS,8e3,500),nT=/^(iphone|ipad|ipod|appletv)/i,nP=/^appletv/i,n$=["apple tv","appletv","tvos"];function nU(e){return(e??"").trim().toLowerCase()}function nF(e){return nU(e.hardwareProperties?.platform)}function nV(e){return e.includes("tvos")}function nG(e){return nV(nU(e))?"tv":"mobile"}function nB(e){let t=nU(e);return t.includes("ios")||t.includes("tvos")}function nj(e){let t=nU(e);return n$.some(e=>t.includes(e))}function nq(e){return[e.name??"",e.deviceProperties?.name??"",e.deviceProperties?.deviceType??""]}function nH(e){return e.hardwareProperties?.productType??e.deviceProperties?.productType??""}async function nW(e={}){let t,r,a=eD(e.simulatorSetPath),i=e.target;try{t=await c("xcrun",eL(["list","devices","-j"],{simulatorSetPath:a}))}catch{return null}try{r=JSON.parse(t.stdout)}catch{return null}let n=null,o=null,s=null;for(let[e,t]of Object.entries(r.devices)){if(!nB(e))continue;let r=nG(e);if(!i||r===i)for(let e of t){if(!e.isAvailable)continue;let t={platform:"ios",id:e.udid,name:e.name,kind:"simulator",target:r,booted:"Booted"===e.state,...a?{simulatorSetPath:a}:{}};t.booted&&(n=n??t),"mobile"===r&&(o=o??t),s=s??t}}return n??o??s}async function nz(e={}){if("darwin"!==process.platform)throw new w("UNSUPPORTED_PLATFORM","iOS tools are only available on macOS");if(!await I("xcrun"))throw new w("TOOL_MISSING","xcrun not found in PATH");let t=[],r=eD(e.simulatorSetPath),a=await c("xcrun",eL(["list","devices","-j"],{simulatorSetPath:r}));try{let e=JSON.parse(a.stdout);for(let[a,i]of Object.entries(e.devices))if(nB(a))for(let e of i)e.isAvailable&&t.push({platform:"ios",id:e.udid,name:e.name,kind:"simulator",target:nG(a),booted:"Booted"===e.state,...r?{simulatorSetPath:r}:{}})}catch(e){throw new w("COMMAND_FAILED","Failed to parse simctl devices JSON",void 0,e)}if(r)return t;let n=null;try{n=i.join(T.tmpdir(),`agent-device-devicectl-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}.json`);let e=await c("xcrun",["devicectl","list","devices","--json-output",n],{allowFailure:!0,timeoutMs:nR});if(0!==e.exitCode)return t;let r=await L.readFile(n,"utf8"),a=JSON.parse(r);for(let e of a.result?.devices??[])if(function(e){var t;let r=nF(e);return!!(r.includes("ios")||r.includes("tvos"))||(t=nH(e),!!nT.test(t.trim())||nq(e).some(nj))}(e)){let r=e.hardwareProperties?.udid??e.identifier??"",a=e.name??e.deviceProperties?.name??r;if(!r)continue;t.push({platform:"ios",id:r,name:a,kind:"device",target:function(e){var t;return nV(nF(e))?"tv":(t=nH(e),nP.test(t.trim())||nq(e).some(nj))?"tv":"mobile"}(e),booted:!0})}}catch{}finally{n&&await L.rm(n,{force:!0}).catch(()=>{})}return t}async function nJ(e,t,r,a){let i,n=!!(t.udid||t.serial||t.deviceName);try{i=await a.resolveDevice(e,t,r)}catch(e){if(n||!(e instanceof w)||"DEVICE_NOT_FOUND"!==e.code)throw e}if(!n&&(!i||"device"===i.kind)){let e=await a.findBootableSimulator({simulatorSetPath:r.simulatorSetPath,target:t.target});if(e)return e}if(i)return i;throw new w("DEVICE_NOT_FOUND","No devices found",{selector:t})}async function nK(e){let t=eJ(e.platform),r=eD(e.iosSimulatorDeviceSet),a=ek(e.androidDeviceAllowlist);return await E("resolve_target_device",async()=>{let i={platform:t,target:e.target,deviceName:e.device,udid:e.udid,serial:e.serial};if(i.target&&!i.platform)throw new w("INVALID_ARGS","Device target selector requires --platform. Use --platform ios|android|apple with --target mobile|tv.");if("android"===i.platform){await rd();let e=await rS({serialAllowlist:a});return await eK(e,i)}if("ios"===i.platform){let e=await nz({simulatorSetPath:r});return await nJ(e,i,{simulatorSetPath:r},{resolveDevice:eK,findBootableSimulator:nW})}let n=[];try{n.push(...await rS({serialAllowlist:a}))}catch{}try{n.push(...await nz({simulatorSetPath:r}))}catch{}return await eK(n,i,{simulatorSetPath:r})},{platform:t,target:e.target})}async function nX(e,t,r,a,n){let o=function(e,t){switch(e.platform){case"android":return{open:(t,r)=>as(e,t,r?.activity),openDevice:()=>ac(e),close:t=>ap(e,t),tap:(t,r)=>aP(e,t,r),doubleTap:async(t,r)=>{await aP(e,t,r),await aP(e,t,r)},swipe:(t,r,a,i,n)=>a$(e,t,r,a,i,n),longPress:(t,r,a)=>aG(e,t,r,a),focus:(t,r)=>aj(e,t,r),type:t=>aB(e,t),fill:(t,r,a)=>aq(e,t,r,a),scroll:(t,r)=>aH(e,t,r),scrollIntoView:t=>aW(e,t),screenshot:(t,r)=>iu(e,t),back:()=>aU(e),home:()=>aF(e),appSwitcher:()=>aV(e),readClipboard:()=>a2(e),writeClipboard:t=>a3(e,t),setSetting:(t,r,a,i)=>a7(e,t,r,a,i)};case"ios":{var r,a;let i,n,{overrides:o,runnerOpts:s}=(r=e,i={verbose:(a=t).verbose,logPath:a.logPath,traceLogPath:a.traceLogPath,requestId:a.requestId},n=()=>{if(ec(a.requestId))throw ef()},{runnerOpts:i,overrides:{tap:async(e,t)=>{await tu(r,{command:"tap",x:e,y:t,appBundleId:a.appBundleId},i)},doubleTap:async(e,t)=>{await tu(r,{command:"tapSeries",x:e,y:t,count:1,intervalMs:0,doubleTap:!0,appBundleId:a.appBundleId},i)},swipe:async(e,t,n,o,s)=>{await tu(r,{command:"drag",x:e,y:t,x2:n,y2:o,durationMs:s,appBundleId:a.appBundleId},i)},longPress:async(e,t,n)=>{await tu(r,{command:"longPress",x:e,y:t,durationMs:n,appBundleId:a.appBundleId},i)},focus:async(e,t)=>{await tu(r,{command:"tap",x:e,y:t,appBundleId:a.appBundleId},i)},type:async e=>{await tu(r,{command:"type",text:e,appBundleId:a.appBundleId},i)},fill:async(e,t,n)=>{await tu(r,{command:"tap",x:e,y:t,appBundleId:a.appBundleId},i),await tu(r,{command:"type",text:n,clearFirst:!0,appBundleId:a.appBundleId},i)},scroll:async(e,t)=>{if(!["up","down","left","right"].includes(e))throw new w("INVALID_ARGS",`Unknown direction: ${e}`);let n=function(e){switch(e){case"up":return"down";case"down":return"up";case"left":return"right";case"right":return"left"}}(e);await tu(r,{command:"swipe",direction:n,appBundleId:a.appBundleId},i)},scrollIntoView:async e=>{let t=await tu(r,{command:"findText",text:e,appBundleId:a.appBundleId},i);if(t?.found)return{attempts:1};for(let t=0;t<12;t+=1){for(let e=0;e<4;e+=1)n(),await tu(r,{command:"swipe",direction:"up",appBundleId:a.appBundleId},i),await new Promise(e=>setTimeout(e,80));n();let o=await tu(r,{command:"findText",text:e,appBundleId:a.appBundleId},i);if(o?.found)return{attempts:t+2}}throw new w("COMMAND_FAILED",`scrollintoview could not find text: ${e}`)}}});return{open:(t,r)=>ni(e,t,{appBundleId:r?.appBundleId,url:r?.url}),openDevice:()=>nn(e),close:t=>no(e,t),screenshot:(t,r)=>iY(e,t,r),back:async()=>{await tu(e,{command:"back",appBundleId:t.appBundleId},s)},home:async()=>{await tu(e,{command:"home",appBundleId:t.appBundleId},s)},appSwitcher:async()=>{await tu(e,{command:"appSwitcher",appBundleId:t.appBundleId},s)},readClipboard:()=>nc(e),writeClipboard:t=>np(e,t),setSetting:(t,r,a,i)=>nm(e,t,r,a,i),...o}}default:throw new w("UNSUPPORTED_PLATFORM",`Unsupported platform: ${e.platform}`)}}(e,{requestId:n?.requestId,appBundleId:n?.appBundleId,verbose:n?.verbose,logPath:n?.logPath,traceLogPath:n?.traceLogPath});return k({level:"debug",phase:"platform_command_prepare",data:{command:t,platform:e.platform,kind:e.kind}}),await E("platform_command",async()=>{switch(t){case"open":{let t=r[0],a=r[1];if(r.length>2)throw new w("INVALID_ARGS","open accepts at most two arguments: <app|url> [url]");if(!t)return await o.openDevice(),{app:null};if(void 0!==a){if("ios"!==e.platform)throw new w("INVALID_ARGS","open <app> <url> is supported only on iOS");if(rp(t))throw new w("INVALID_ARGS","open <app> <url> requires an app target as the first argument");if(!rp(a))throw new w("INVALID_ARGS","open <app> <url> requires a valid URL target");return await o.open(t,{activity:n?.activity,appBundleId:n?.appBundleId,url:a}),{app:t,url:a}}return await o.open(t,{activity:n?.activity,appBundleId:n?.appBundleId}),{app:t}}case"close":{let e=r[0];if(!e)return{closed:"session"};return await o.close(e),{app:e}}case"press":{let[t,a]=r.map(Number);if(Number.isNaN(t)||Number.isNaN(a))throw new w("INVALID_ARGS","press requires x y");let i=nk(n?.count??1,"count",1,200),s=nk(n?.intervalMs??0,"interval-ms",0,1e4),l=nk(n?.holdMs??0,"hold-ms",0,1e4),d=nk(n?.jitterPx??0,"jitter-px",0,100),u=n?.doubleTap===!0;if(u&&l>0)throw new w("INVALID_ARGS","double-tap cannot be combined with hold-ms");if(u&&d>0)throw new w("INVALID_ARGS","double-tap cannot be combined with jitter-px");if("ios"===e.platform&&i>1&&0===l&&0===d)return await tu(e,{command:"tapSeries",x:t,y:a,count:i,intervalMs:s,doubleTap:u,appBundleId:n?.appBundleId},{verbose:n?.verbose,logPath:n?.logPath,traceLogPath:n?.traceLogPath,requestId:n?.requestId}),{x:t,y:a,count:i,intervalMs:s,holdMs:l,jitterPx:d,doubleTap:u,timingMode:"runner-series"};return await nL(i,s,async e=>{let[r,i]=function(e,t){if(t<=0)return[0,0];let[r,a]=nE[e%nE.length];return[r*t,a*t]}(e,d),n=t+r,s=a+i;u?await o.doubleTap(n,s):l>0?await o.longPress(n,s,l):await o.tap(n,s)}),{x:t,y:a,count:i,intervalMs:s,holdMs:l,jitterPx:d,doubleTap:u}}case"swipe":{let t=Number(r[0]),a=Number(r[1]),i=Number(r[2]),s=Number(r[3]);if([t,a,i,s].some(Number.isNaN))throw new w("INVALID_ARGS","swipe requires x1 y1 x2 y2 [durationMs]");let l=nk(r[4]?Number(r[4]):250,"durationMs",16,1e4),d="ios"===e.platform?Math.min(60,Math.max(16,Math.round(l))):l,u=nk(n?.count??1,"count",1,200),c=nk(n?.pauseMs??0,"pause-ms",0,1e4),p=n?.pattern??"one-way";if("one-way"!==p&&"ping-pong"!==p)throw new w("INVALID_ARGS",`Invalid pattern: ${p}`);if("ios"===e.platform&&u>1)return await tu(e,{command:"dragSeries",x:t,y:a,x2:i,y2:s,durationMs:d,count:u,pauseMs:c,pattern:p,appBundleId:n?.appBundleId},{verbose:n?.verbose,logPath:n?.logPath,traceLogPath:n?.traceLogPath,requestId:n?.requestId}),{x1:t,y1:a,x2:i,y2:s,durationMs:l,effectiveDurationMs:d,timingMode:"runner-series",count:u,pauseMs:c,pattern:p};return await nL(u,c,async e=>{"ping-pong"===p&&e%2==1?await o.swipe(i,s,t,a,d):await o.swipe(t,a,i,s,d)}),{x1:t,y1:a,x2:i,y2:s,durationMs:l,effectiveDurationMs:d,timingMode:"ios"===e.platform?"safe-normalized":"direct",count:u,pauseMs:c,pattern:p}}case"longpress":{let e=Number(r[0]),t=Number(r[1]),a=r[2]?Number(r[2]):void 0;if(Number.isNaN(e)||Number.isNaN(t))throw new w("INVALID_ARGS","longpress requires x y [durationMs]");return await o.longPress(e,t,a),{x:e,y:t,durationMs:a}}case"focus":{let[e,t]=r.map(Number);if(Number.isNaN(e)||Number.isNaN(t))throw new w("INVALID_ARGS","focus requires x y");return await o.focus(e,t),{x:e,y:t}}case"type":{let e=r.join(" ");if(!e)throw new w("INVALID_ARGS","type requires text");return await o.type(e),{text:e}}case"fill":{let e=Number(r[0]),t=Number(r[1]),a=r.slice(2).join(" ");if(Number.isNaN(e)||Number.isNaN(t)||!a)throw new w("INVALID_ARGS","fill requires x y text");return await o.fill(e,t,a),{x:e,y:t,text:a}}case"scroll":{let e=r[0],t=r[1]?Number(r[1]):void 0;if(!e)throw new w("INVALID_ARGS","scroll requires direction");return await o.scroll(e,t),{direction:e,amount:t}}case"scrollintoview":{let e=r.join(" ").trim();if(!e)throw new w("INVALID_ARGS","scrollintoview requires text");let t=await o.scrollIntoView(e);if(t?.attempts)return{text:e,attempts:t.attempts};return{text:e}}case"pinch":{if("android"===e.platform)throw new w("UNSUPPORTED_OPERATION","Android pinch is not supported in current adb backend; requires instrumentation-based backend.");let t=Number(r[0]),a=r[1]?Number(r[1]):void 0,i=r[2]?Number(r[2]):void 0;if(Number.isNaN(t)||t<=0)throw new w("INVALID_ARGS","pinch requires scale > 0");return await tu(e,{command:"pinch",scale:t,x:a,y:i,appBundleId:n?.appBundleId},{verbose:n?.verbose,logPath:n?.logPath,traceLogPath:n?.traceLogPath,requestId:n?.requestId}),{scale:t,x:a,y:i}}case"trigger-app-event":{let{eventName:t,payload:a}=function(e){let t=e[0]?.trim(),r=e[1]?.trim();if(!t)throw new w("INVALID_ARGS","trigger-app-event requires <event> [payloadJson]");if(!nD.test(t))throw new w("INVALID_ARGS",`Invalid trigger-app-event event name: ${t}`,{hint:"Use 1-64 chars: letters, numbers, underscore, dot, colon, or dash."});if(e.length>2)throw new w("INVALID_ARGS","trigger-app-event accepts at most two arguments: <event> [payloadJson]");let a=function(e,t){if(e)try{let r=JSON.parse(e);if(!r||"object"!=typeof r||Array.isArray(r))throw new w("INVALID_ARGS",`trigger-app-event payload for "${t}" must be a JSON object`);let a=JSON.stringify(r);if(Buffer.byteLength(a,"utf8")>8192)throw new w("INVALID_ARGS",`trigger-app-event payload for "${t}" exceeds 8192 bytes`);return r}catch(t){if(t instanceof w)throw t;throw new w("INVALID_ARGS",`Invalid trigger-app-event payload JSON: ${e}`)}}(r,t);return{eventName:t,payload:a}}(r),i=function(e,t,r){let a,i=(a=("ios"===e?process.env.AGENT_DEVICE_IOS_APP_EVENT_URL_TEMPLATE:process.env.AGENT_DEVICE_ANDROID_APP_EVENT_URL_TEMPLATE)??process.env.AGENT_DEVICE_APP_EVENT_URL_TEMPLATE,a?.trim()||void 0);if(!i)throw new w("UNSUPPORTED_OPERATION",`No app event URL template configured for ${e}.`,{hint:`Set AGENT_DEVICE_${e.toUpperCase()}_APP_EVENT_URL_TEMPLATE or AGENT_DEVICE_APP_EVENT_URL_TEMPLATE, for example "myapp://agent-device/event?name={event}&payload={payload}".`});let n=r?JSON.stringify(r):"",o=i.replaceAll("{event}",encodeURIComponent(t)).replaceAll("{payload}",encodeURIComponent(n)).replaceAll("{platform}",encodeURIComponent(e));if(o.length>4096)throw new w("INVALID_ARGS","trigger-app-event URL exceeds maximum supported length",{hint:"Reduce payload size or shorten AGENT_DEVICE_*_APP_EVENT_URL_TEMPLATE.",length:o.length,maxLength:4096});return o}(e.platform,t,a);return await o.open(i,{appBundleId:n?.appBundleId}),{event:t,eventUrl:i,transport:"deep-link"}}case"screenshot":{let e=r[0]??a??`./screenshot-${Date.now()}.png`;return await L.mkdir(i.dirname(e),{recursive:!0}),await o.screenshot(e,n?.appBundleId),{path:e}}case"back":return await o.back(),{action:"back"};case"home":return await o.home(),{action:"home"};case"app-switcher":return await o.appSwitcher(),{action:"app-switcher"};case"clipboard":{let e=(r[0]??"").toLowerCase();if("read"!==e&&"write"!==e)throw new w("INVALID_ARGS","clipboard requires a subcommand: read or write");if("read"===e){if(1!==r.length)throw new w("INVALID_ARGS","clipboard read does not accept additional arguments");return{action:e,text:await o.readClipboard()}}if(r.length<2)throw new w("INVALID_ARGS",'clipboard write requires text (use "" to clear clipboard)');let t=r.slice(1).join(" ");return await o.writeClipboard(t),{action:e,textLength:Array.from(t).length}}case"keyboard":{if("android"!==e.platform)throw new w("UNSUPPORTED_OPERATION","keyboard is currently supported only on Android");let t=(r[0]??"status").toLowerCase();if("status"!==t&&"get"!==t&&"dismiss"!==t)throw new w("INVALID_ARGS","keyboard requires a subcommand: status, get, or dismiss");if(r.length>1)throw new w("INVALID_ARGS","keyboard accepts at most one subcommand argument");if("dismiss"===t){let t=await a1(e);return{platform:"android",action:"dismiss",attempts:t.attempts,wasVisible:t.wasVisible,dismissed:t.dismissed,visible:t.visible,inputType:t.inputType,type:t.type}}let a=await a0(e);return{platform:"android",action:"status",visible:a.visible,inputType:a.inputType,type:a.type}}case"settings":{let[t,a,i,s,l]=r,d="permission"===t?{permissionTarget:i,permissionMode:s}:void 0;return k({level:"debug",phase:"settings_apply",data:{setting:t,state:a,target:i,mode:s,platform:e.platform}}),await o.setSetting(t,a,l??n?.appBundleId,d),{setting:t,state:a}}case"push":{let t=r[0]?.trim(),a=r[1]?.trim();if(!t||!a)throw new w("INVALID_ARGS","push requires <bundle|package> <payload.json|inline-json>");let i=await nx(a);if("ios"===e.platform)return await nf(e,t,i),{platform:"ios",bundleId:t};let n=await is(e,t,i);return{platform:"android",package:t,action:n.action,extrasCount:n.extrasCount}}case"snapshot":{if("ios"===e.platform){let t=await E("snapshot_capture",async()=>await tu(e,{command:"snapshot",appBundleId:n?.appBundleId,interactiveOnly:n?.snapshotInteractiveOnly,compact:n?.snapshotCompact,depth:n?.snapshotDepth,scope:n?.snapshotScope,raw:n?.snapshotRaw},{verbose:n?.verbose,logPath:n?.logPath,traceLogPath:n?.traceLogPath,requestId:n?.requestId}),{backend:"xctest"}),r=t.nodes??[];if(0===r.length&&"simulator"===e.kind)throw new w("COMMAND_FAILED","XCTest snapshot returned 0 nodes on iOS simulator.");return{nodes:r,truncated:t.truncated??!1,backend:"xctest"}}let t=await E("snapshot_capture",async()=>await aM(e,{interactiveOnly:n?.snapshotInteractiveOnly,compact:n?.snapshotCompact,depth:n?.snapshotDepth,scope:n?.snapshotScope,raw:n?.snapshotRaw}),{backend:"android"});return{nodes:t.nodes??[],truncated:t.truncated??!1,backend:"android"}}default:throw new w("INVALID_ARGS",`Unknown command: ${t}`)}},{command:t,platform:e.platform})}let nZ={alert:{ios:{simulator:!0},android:{}},pinch:{ios:{simulator:!0},android:{}},"app-switcher":{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},apps:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},back:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},boot:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},click:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},clipboard:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},keyboard:{ios:{},android:{emulator:!0,device:!0,unknown:!0}},close:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},fill:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},diff:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},find:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},focus:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},get:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},is:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},home:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},logs:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},network:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},longpress:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},open:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},perf:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},install:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},"install-from-source":{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},reinstall:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},press:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},push:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},record:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},screenshot:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},scroll:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},scrollintoview:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},swipe:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},settings:{ios:{simulator:!0},android:{emulator:!0,device:!0,unknown:!0}},snapshot:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},"trigger-app-event":{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},type:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}},wait:{ios:{simulator:!0,device:!0},android:{emulator:!0,device:!0,unknown:!0}}};function nY(e,t){let r=nZ[e];if(!r)return!0;let a=r[t.platform];return!!a&&!0===a[t.kind??"unknown"]}function nQ(e,t,r,a,i){return{requestId:i??S().requestId,appBundleId:r,activity:t?.activity,verbose:t?.verbose,logPath:e,traceLogPath:a,snapshotInteractiveOnly:t?.snapshotInteractiveOnly,snapshotCompact:t?.snapshotCompact,snapshotDepth:t?.snapshotDepth,snapshotScope:t?.snapshotScope,snapshotRaw:t?.snapshotRaw,count:t?.count,intervalMs:t?.intervalMs,holdMs:t?.holdMs,jitterPx:t?.jitterPx,doubleTap:t?.doubleTap,pauseMs:t?.pauseMs,pattern:t?.pattern}}let n0=ey(process.env.AGENT_DEVICE_IOS_DEVICE_READY_TIMEOUT_MS,15e3,1e3);async function n1(e){if("ios"===e.platform){if("simulator"===e.kind){let{ensureBootedSimulator:t}=await Promise.resolve().then(()=>({ensureBootedSimulator:iM}));await t(e);return}if("device"===e.kind)return void await n2(e.id)}if("android"===e.platform){let{waitForAndroidBoot:t}=await Promise.resolve().then(()=>({waitForAndroidBoot:rx}));await t(e.id)}}async function n2(e){let t=i.join(T.tmpdir(),`agent-device-ready-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2)}.json`),r=Math.max(1,Math.ceil(n0/1e3));try{let a=await c("xcrun",["devicectl","device","info","details","--device",e,"--json-output",t,"--timeout",String(r)],{allowFailure:!0,timeoutMs:n0+3e3}),i=String(a.stdout??""),n=String(a.stderr??""),o=await n3(t);if(0===a.exitCode){if(!o.parsed)throw new w("COMMAND_FAILED","iOS device readiness probe failed",{kind:"probe_inconclusive",deviceId:e,stdout:i,stderr:n,hint:"CoreDevice returned success but readiness JSON output was missing or invalid. Retry; if it persists restart Xcode and the iOS device."});let t=o?.tunnelState?.toLowerCase();if("connecting"===t)throw new w("COMMAND_FAILED","iOS device is not ready for automation",{kind:"not_ready",deviceId:e,tunnelState:t,hint:"Device tunnel is still connecting. Keep the device unlocked and connected by cable until it is fully available in Xcode Devices, then retry."});return}throw new w("COMMAND_FAILED","iOS device is not ready for automation",{kind:"not_ready",deviceId:e,stdout:i,stderr:n,exitCode:a.exitCode,tunnelState:o?.tunnelState,hint:n4(i,n)})}catch(t){if(t instanceof w&&"COMMAND_FAILED"===t.code){if("not_ready"===("string"==typeof t.details?.kind?t.details.kind:""))throw t;let r=t.details??{},a=String(r.stdout??""),i=String(r.stderr??""),n=Number(r.timeoutMs??n0),o=`CoreDevice did not respond within ${n}ms. Keep the device unlocked and trusted, then retry; if it persists restart Xcode and the iOS device.`;throw new w("COMMAND_FAILED","iOS device readiness probe failed",{deviceId:e,cause:t.message,timeoutMs:n,stdout:a,stderr:i,hint:a||i?n4(a,i):o},t)}throw new w("COMMAND_FAILED","iOS device readiness probe failed",{deviceId:e,hint:"Reconnect the device, keep it unlocked, and retry."},t instanceof Error?t:void 0)}finally{await L.rm(t,{force:!0}).catch(()=>{})}}async function n3(e){try{let t=await L.readFile(e,"utf8"),r=JSON.parse(t),a=function(e){let t=e?.result;if(!t||"object"!=typeof t)return{};let r=t.connectionProperties?.tunnelState,a=t.device?.connectionProperties?.tunnelState,i="string"==typeof r?r:"string"==typeof a?a:void 0;return i?{tunnelState:i}:{}}(r);return{parsed:!0,tunnelState:a.tunnelState}}catch{return{parsed:!1}}}function n4(e,t){let r=iD(e,t);return r||(`${e}
 ${t}`.toLowerCase().includes("timed out waiting for all destinations")?"Xcode destination did not become available in time. Keep device unlocked and retry.":iS)}function n8(e){return e.map((e,t)=>({...e,ref:`e${t+1}`}))}function n5(e){let t=e.trim();return t.startsWith("@")?t.slice(1)||null:t.startsWith("e")?t:null}function n6(e,t){return e.find(e=>e.ref===t)??null}function n9(e){return{x:Math.round(e.x+e.width/2),y:Math.round(e.y+e.height/2)}}function n7(e,t){let r=t.toLowerCase();return e.find(e=>{let t=(e.label??"").toLowerCase(),a=(e.value??"").toLowerCase(),i=(e.identifier??"").toLowerCase();return t.includes(r)||a.includes(r)||i.includes(r)})??null}function oe(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&&ot(r)?r:function(e,t){if(!e.rect)return;let r=e.rect.y+e.rect.height/2,a=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||!ot(t))continue;let i=Math.abs(e.rect.y+e.rect.height/2-r);(!a||i<a.distance)&&(a={label:t,distance:i})}return a?.label}(e,t)??(r&&ot(r)?r:void 0)}function ot(e){let t=e.trim();return!(!t||/^(true|false)$/i.test(t)||/^\d+$/.test(t))}function or(e){let t=[],r=[];for(let a of e){let e=a.depth??0;for(;t.length>0&&e<=t[t.length-1];)t.pop();let i=oa(a.type??""),n=[a.label,a.value,a.identifier].map(e=>"string"==typeof e?e.trim():"").find(e=>e&&e.length>0),o=!!n&&ot(n);if(("group"===i||"ioscontentgroup"===i)&&!o){t.push(e);continue}let s=Math.max(0,e-t.length);r.push({...a,depth:s})}return r}function oa(e){let t=e.trim().replace(/XCUIElementType/gi,"").toLowerCase(),r=Math.max(t.lastIndexOf("."),t.lastIndexOf("/"));return -1!==r&&(t=t.slice(r+1)),t}function oi(e,t){let r=oa(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 on(e){return[e.label,e.value,e.identifier].map(e=>"string"==typeof e?e.trim():"").filter(e=>e.length>0)[0]??""}let oo=new Set(["id","role","text","label","value"]),os=new Set(["visible","hidden","editable","selected","enabled","hittable"]),ol=new Set([...oo,...os]);function od(e){let t=e.trim();if(!t)throw new w("INVALID_ARGS","Selector expression cannot be empty");let r=function(e){let t=[],r="",a=null;for(let i=0;i<e.length;i+=1){let n=e[i];if(('"'===n||"'"===n)&&!oh(e,i)){a?a===n&&(a=null):a=n,r+=n;continue}if(!a&&"|"===n&&"|"===e[i+1]){let a=r.trim();if(!a)throw new w("INVALID_ARGS",`Invalid selector fallback expression: ${e}`);t.push(a),r="",i+=1;continue}r+=n}let i=r.trim();if(!i)throw new w("INVALID_ARGS",`Invalid selector fallback expression: ${e}`);return t.push(i),t}(t);if(0===r.length)throw new w("INVALID_ARGS","Selector expression cannot be empty");return{raw:t,selectors:r.map(e=>(function(e){let t=e.trim();if(!t)throw new w("INVALID_ARGS","Selector segment cannot be empty");let r=function(e){let t=[],r="",a=null;for(let i=0;i<e.length;i+=1){let n=e[i];if(('"'===n||"'"===n)&&!oh(e,i)){a?a===n&&(a=null):a=n,r+=n;continue}if(!a&&/\s/.test(n)){r.trim().length>0&&t.push(r.trim()),r="";continue}r+=n}if(a)throw new w("INVALID_ARGS",`Unclosed quote in selector: ${e}`);return r.trim().length>0&&t.push(r.trim()),t}(t);if(0===r.length)throw new w("INVALID_ARGS",`Invalid selector segment: ${e}`);return{raw:t,terms:r.map(of)}})(e))}}function ou(e){try{return od(e)}catch{return null}}function oc(e,t={}){if(0===e.length)return null;let r=t.preferTrailingValue??!1,a=0,i=[];for(;a<e.length&&function(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 ol.has(e)}return ol.has(t.toLowerCase())}(e[a]);){a+=1;let t=e.slice(0,a).join(" ").trim();t&&ou(t)&&i.push(a)}if(0===i.length)return null;let n=i[i.length-1];if(r){for(let t=i.length-1;t>=0;t-=1)if(i[t]<e.length){n=i[t];break}}let o=e.slice(0,n).join(" ").trim();return o?{selectorExpression:o,rest:e.slice(n)}:null}function op(e){let t=e[0]??"",r=oc(e.slice(1),{preferTrailingValue:"text"===t});return{predicate:t,split:r}}function of(e){let t=e.trim();if(!t)throw new w("INVALID_ARGS","Empty selector term");let r=t.indexOf("=");if(-1===r){let r=t.toLowerCase();if(!os.has(r))throw new w("INVALID_ARGS",`Invalid selector term "${e}", expected key=value`);return{key:r,value:!0}}let a=t.slice(0,r).trim().toLowerCase(),i=t.slice(r+1).trim();if(!ol.has(a))throw new w("INVALID_ARGS",`Unknown selector key: ${a}`);if(!i)throw new w("INVALID_ARGS",`Missing selector value for key: ${a}`);if(os.has(a)){let e,t="true"===(e=om(i).toLowerCase())||"false"!==e&&null;if(null===t)throw new w("INVALID_ARGS",`Invalid boolean value for ${a}: ${i}`);return{key:a,value:t}}return{key:a,value:om(i)}}function om(e){let t=e.trim();return t.startsWith('"')&&t.endsWith('"')||t.startsWith("'")&&t.endsWith("'")?t.slice(1,-1).replace(/\\(["'])/g,"$1"):t}function oh(e,t){let r=0;for(let a=t-1;a>=0&&"\\"===e[a];a-=1)r+=1;return r%2==1}function ow(e,t,r){return t.terms.every(t=>(function(e,t,r){switch(t.key){case"id":return oA(e.identifier,String(t.value));case"role":var a,i;return a=e.type,i=String(t.value),function(e){return oa(e)}(a??"")===function(e){return oa(e)}(i);case"label":return oA(e.label,String(t.value));case"value":return oA(e.value,String(t.value));case"text":{let r=ov(String(t.value));return ov(on(e))===r}case"visible":return og(e)===!!t.value;case"hidden":return!og(e)==!!t.value;case"editable":return oI(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 og(e){return!0===e.hittable||!!e.rect&&e.rect.width>0&&e.rect.height>0}function oI(e,t){return oi(e.type??"",t)&&!1!==e.enabled}function oA(e,t){return ov(e??"")===ov(t)}function ov(e){return e.trim().toLowerCase().replace(/\s+/g," ")}function oy(e,t,r){let a=r.requireRect??!1,i=r.requireUnique??!0,n=r.disambiguateAmbiguous??!1,o=[];for(let s=0;s<t.selectors.length;s+=1){let l=t.selectors[s],d=function(e,t,r){let a=0,i=null,n=null,o=!1;for(let s of e){if(r.requireRect&&!s.rect||!ow(s,t,r.platform))continue;if(a+=1,i||(i=s),!n){n=s;continue}let e=function(e,t){let r=e.depth??0,a=t.depth??0;if(r!==a)return r>a?1:-1;let i=o_(e),n=o_(t);return i!==n?i<n?1:-1:0}(s,n);if(e>0){n=s,o=!1;continue}0===e&&(o=!0)}return{count:a,firstNode:i,disambiguated:o?null:n}}(e,l,{platform:r.platform,requireRect:a});if(o.push({selector:l.raw,matches:d.count}),0!==d.count&&d.firstNode){if(i&&1!==d.count){if(!n)continue;let e=d.disambiguated;if(!e)continue;return{node:e,selector:l,selectorIndex:s,matches:d.count,diagnostics:o}}return{node:d.firstNode,selector:l,selectorIndex:s,matches:d.count,diagnostics:o}}}return null}function ob(e,t,r){let a=r.requireRect??!1,i=[];for(let n=0;n<t.selectors.length;n+=1){let o=t.selectors[n],s=function(e,t,r){let a=0;for(let i of e)(!r.requireRect||i.rect)&&ow(i,t,r.platform)&&(a+=1);return a}(e,o,{platform:r.platform,requireRect:a});if(i.push({selector:o.raw,matches:s}),s>0)return{selectorIndex:n,selector:o,matches:s,diagnostics:i}}return null}function oN(e,t,r){let a=r.unique??!0;if(0===t.length)return`Selector did not match: ${e.raw}`;let i=t.map(e=>`${e.selector} -> ${e.matches}`).join(", ");return a?`Selector did not resolve uniquely (${i})`:`Selector did not match (${i})`}function o_(e){return e.rect?e.rect.width*e.rect.height:1/0}function oS(e,t,r={}){let a=[],i=oa(e.type??""),n=oE(e.identifier),o=oE(e.label),s=oE(e.value),l=oE(on(e)),d="fill"===r.action;n&&a.push(`id=${oD(n)}`),i&&o&&a.push(d?`role=${oD(i)} label=${oD(o)} editable=true`:`role=${oD(i)} label=${oD(o)}`),o&&a.push(d?`label=${oD(o)} editable=true`:`label=${oD(o)}`),s&&a.push(d?`value=${oD(s)} editable=true`:`value=${oD(s)}`),l&&l!==o&&l!==s&&a.push(d?`text=${oD(l)} editable=true`:`text=${oD(l)}`),i&&d&&!a.some(e=>e.includes("editable=true"))&&a.push(`role=${oD(i)} editable=true`);let u=tf(a);return 0===u.length&&i&&u.push(d?`role=${oD(i)} editable=true`:`role=${oD(i)}`),0===u.length&&og(e)&&u.push("visible=true"),u}function oD(e){return JSON.stringify(e)}function oE(e){if(!e)return null;let t=e.trim();return t||null}let ok=RegExp("\\b(GET|POST|PUT|PATCH|DELETE|HEAD|OPTIONS)\\b","i"),oL=/https?:\/\/[^\s"'<>\])]+/i,oO=[/\bstatus(?:Code)?["'=: ]+([1-5]\d{2})\b/i,/\bresponse(?:\s+code)?["'=: ]+([1-5]\d{2})\b/i,/\bHTTP\/[0-9.]+\s+([1-5]\d{2})\b/i];function oM(e,t){if(e)for(let r of t){let t=e[r];if("string"==typeof t&&t.trim().length>0)return t.trim()}}function ox(e,t,r){if(t){for(let e of r)if(void 0!==t[e])return oC(t[e])}for(let t of r){let r=t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),a=RegExp(`\\b${r}["'=: ]+(.+)$`,"i").exec(e);if(a?.[1])return a[1].trim()}}function oC(e){if("string"==typeof e)return e;try{return JSON.stringify(e)}catch{return String(e)}}function oR(e,t){return e.length<=t?e:`${e.slice(0,t)}...<truncated>`}function oT(e,t,r,a){return void 0!==e&&Number.isInteger(e)?Math.max(r,Math.min(a,e)):t}let oP="shared_prefs/ReactNativeDevPrefs.xml",o$="debug_http_host",oU="dev_server_https",oF="RCT_jsLocation",oV="RCT_packager_scheme",oG="React Native runtime hints require adb run-as access to the app sandbox. Verify the app is debuggable and the selected package/device are correct.",oB='<?xml version="1.0" encoding="utf-8" standalone="yes" ?>\n<map>\n</map>\n';function oj(e){return void 0!==oq(e)}function oq(e){if(!e)return;let t=o2(e.metroHost),r=o4(e.metroPort),a="http",i=o2(e.bundleUrl);if(i){var n;let e;try{e=new g(i)}catch(e){throw new w("INVALID_ARGS",`Invalid runtime bundle URL: ${i}`,{},e)}("http:"===e.protocol||"https:"===e.protocol)&&(t??=o2(e.hostname),r??=o4(e.port.length>0?Number(e.port):"https:"===(n=e.protocol)?443:"http:"===n?80:void 0),a="https:"===e.protocol?"https":"http")}if(t&&r)return{host:t,port:r,scheme:a}}async function oH(e){let{device:t,appId:r,runtime:a}=e;if(!r)return;let i=oq(a);if(i){if("android"===t.platform)return void await oz(t,r,i);"ios"===t.platform&&"simulator"===t.kind&&await oZ(t,r,i)}}async function oW(e){let{device:t,appId:r}=e;if(r){if("android"===t.platform)return void await oJ(t,r);"ios"===t.platform&&"simulator"===t.kind&&await oY(t,r)}}async function oz(e,t,r){var a,i,n,o,s,l;let d,u;o3(t);let c=(a=await oK(e,t),i=o$,n=`${r.host}:${r.port}`,d=`  <string name="${o8(i)}">${o8(n)}</string>`,o0(o1(a,i),d));o=c,s=oU,l="https"===r.scheme,u=`  <boolean name="${o8(s)}" value="${l?"true":"false"}" />`,c=o0(o1(o,s),u),await oX(e,t,c)}async function oJ(e,t){o3(t);let r=await oK(e,t),a=o1(r,o$),i=o1(a,oU);i!==r&&await oX(e,t,i)}async function oK(e,t){let r=await c("adb",rl(e,["shell","run-as",t,"cat",oP]),{allowFailure:!0});return 0!==r.exitCode?oB:oQ(r.stdout)}async function oX(e,t,r){let a=rl(e,["shell","run-as",t,"id"]),i=await c("adb",a,{allowFailure:!0});if(0!==i.exitCode){let e=o5(i.stdout,i.stderr);throw new w("COMMAND_FAILED",e?`Failed to access Android app sandbox for ${t}`:`Failed to probe Android app sandbox for ${t}`,{package:t,cmd:"adb",args:a,stdout:i.stdout,stderr:i.stderr,exitCode:i.exitCode,hint:e?oG:"adb shell run-as probe failed. Check adb connectivity and that the device is reachable. Inspect stderr/details for more information."})}try{await c("adb",rl(e,["shell","run-as",t,"mkdir","-p","shared_prefs"])),await c("adb",rl(e,["shell","run-as",t,"tee",oP]),{stdin:r.trimEnd()})}catch(a){let e=f(a);if("TOOL_MISSING"===e.code)throw e;let r=o5("string"==typeof e.details?.stdout?e.details.stdout:"","string"==typeof e.details?.stderr?e.details.stderr:"");throw new w("COMMAND_FAILED",r?`Failed to access Android app sandbox for ${t}`:`Failed to write Android runtime hints for ${t}`,{...e.details??{},package:t,cmd:"adb",phase:"write-runtime-hints",hint:r?oG:"adb run-as succeeded, but writing ReactNativeDevPrefs.xml failed. Inspect stderr/details for the failing shell command."},e)}}async function oZ(e,t,r){await c("xcrun",eO(e,["spawn",e.id,"defaults","write",t,oF,"-string",`${r.host}:${r.port}`])),await c("xcrun",eO(e,["spawn",e.id,"defaults","write",t,oV,"-string",r.scheme]))}async function oY(e,t){await c("xcrun",eO(e,["spawn",e.id,"defaults","delete",t,oF]),{allowFailure:!0}),await c("xcrun",eO(e,["spawn",e.id,"defaults","delete",t,oV]),{allowFailure:!0})}function oQ(e){let t=e.trim();return t.includes("<map")&&t.includes("</map>")?`${t}
 `:oB}function o0(e,t){return oQ(e).replace("</map>",`${t}
 </map>`)}function o1(e,t){let r=t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&");return oQ(e).replace(RegExp(`^\\s*<string name="${r}">[\\s\\S]*?<\\/string>\\n?`,"m"),"").replace(RegExp(`^\\s*<boolean name="${r}" value="(?:true|false)"\\s*\\/?>\\n?`,"m"),"")}function o2(e){let t=e?.trim();return t&&t.length>0?t:void 0}function o3(e){if("binary"!==rT(e))return;let t=rP(e);throw new w("INVALID_ARGS",t,{package:e,hint:t})}function o4(e){if(Number.isInteger(e)&&!(e<=0)&&!(e>65535))return e}function o8(e){return e.replaceAll("&","&amp;").replaceAll("<","&lt;").replaceAll(">","&gt;").replaceAll('"',"&quot;").replaceAll("'","&apos;")}function o5(e,t){let r=`${e}

package/dist/src/utils/command-schema.d.ts

@@ -47,12 +47,15 @@ export type CliFlags = {
     pauseMs?: number;
     pattern?: 'one-way' | 'ping-pong';
     activity?: string;
+    header?: string[];
     saveScript?: boolean | string;
     shutdown?: boolean;
     relaunch?: boolean;
     headless?: boolean;
     restart?: boolean;
     noRecord?: boolean;
+    retainPaths?: boolean;
+    retentionMs?: number;
     replayUpdate?: boolean;
     steps?: string;
     stepsFile?: string;
@@ -72,6 +75,7 @@ export type FlagDefinition = {
     key: FlagKey;
     names: readonly string[];
     type: FlagType;
+    multiple?: boolean;
     enumValues?: readonly string[];
     min?: number;
     max?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-device",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "description": "Unified control plane for physical and virtual devices via an agent-driven CLI.",
   "license": "MIT",
   "author": "Callstack",

package/skills/agent-device/SKILL.md

@@ -174,6 +174,7 @@ agent-device open [app|url] [url]
 agent-device open [app] --relaunch
 agent-device close [app]
 agent-device install <app> <path-to-binary>
+agent-device install-from-source <url> [--header "name:value"]
 agent-device reinstall <app> <path-to-binary>
 agent-device session list
 ```