agent-device 0.3.1 → 0.3.2

package/README.md

@@ -14,7 +14,7 @@ The project is in early development and considered experimental. Pull requests a
 
 ## Features
 - Platforms: iOS (simulator + limited device support) and Android (emulator + device).
-- Core commands: `open`, `back`, `home`, `app-switcher`, `press`, `long-press`, `focus`, `type`, `fill`, `scroll`, `scrollintoview`, `wait`, `alert`, `screenshot`, `close`.
+- Core commands: `open`, `back`, `home`, `app-switcher`, `press`, `long-press`, `focus`, `type`, `fill`, `scroll`, `scrollintoview`, `wait`, `alert`, `screenshot`, `close`, `reinstall`.
 - Inspection commands: `snapshot` (accessibility tree).
 - Device tooling: `adb` (Android), `simctl`/`devicectl` (iOS via Xcode).
 - Minimal dependencies; TypeScript executed directly on Node 22+ (no build step).
@@ -75,7 +75,7 @@ Coordinates:
 - X increases to the right, Y increases downward.
 
 ## Command Index
-- `open`, `close`, `home`, `back`, `app-switcher`
+- `boot`, `open`, `close`, `reinstall`, `home`, `back`, `app-switcher`
 - `snapshot`, `find`, `get`
 - `click`, `focus`, `type`, `fill`, `press`, `long-press`, `scroll`, `scrollintoview`, `is`
 - `alert`, `wait`, `screenshot`
@@ -123,6 +123,13 @@ Sessions:
 - Session scripts are written to `~/.agent-device/sessions/<session>-<timestamp>.ad` when recording is enabled with `--save-script`.
 - Deterministic replay is `.ad`-based; use `replay --update` (`-u`) to update selector drift and rewrite the replay file in place.
 
+Navigation helpers:
+- `boot --platform ios|android` ensures the target is ready without launching an app.
+- Use `boot` mainly when starting a new session and `open` fails because no booted simulator/emulator is available.
+- `open [app]` already boots/activates the selected target when needed.
+- `reinstall <app> <path>` uninstalls and installs the app binary in one command (Android + iOS simulator in v1).
+- `reinstall` accepts package/bundle id style app names and supports `~` in paths.
+
 Find (semantic):
 - `find <text> <action> [value]` finds by any text (label/value/identifier) using a scoped snapshot.
 - `find text|label|value|role|id <value> <action> [value]` for specific locators.
@@ -186,8 +193,10 @@ App state:
 
 Boot diagnostics:
 - Boot failures include normalized reason codes in `error.details.reason` (JSON mode) and verbose logs.
-- Reason codes: `BOOT_TIMEOUT`, `DEVICE_UNAVAILABLE`, `DEVICE_OFFLINE`, `PERMISSION_DENIED`, `TOOL_MISSING`, `BOOT_COMMAND_FAILED`, `UNKNOWN`.
+- Reason codes: `IOS_BOOT_TIMEOUT`, `IOS_RUNNER_CONNECT_TIMEOUT`, `ANDROID_BOOT_TIMEOUT`, `ADB_TRANSPORT_UNAVAILABLE`, `CI_RESOURCE_STARVATION_SUSPECTED`, `BOOT_COMMAND_FAILED`, `UNKNOWN`.
 - Android boot waits fail fast for permission/tooling issues and do not always collapse into timeout errors.
+- Use `agent-device boot --platform ios|android` when starting a new session only if `open` cannot find/connect to an available target.
+- Set `AGENT_DEVICE_RETRY_LOGS=1` to print structured retry telemetry (attempt, phase, delay, elapsed/remaining deadline, reason).
 
 ## App resolution
 - Bundle/package identifiers are accepted directly (e.g., `com.apple.Preferences`).

package/dist/src/274.js

@@ -1 +1 @@
-import e,{promises as t}from"node:fs";import n from"node:path";import{fileURLToPath as o,pathToFileURL as r}from"node:url";import{spawn as i}from"node:child_process";function d(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}class s extends Error{constructor(e,t,n,o){super(t),d(this,"code",void 0),d(this,"details",void 0),d(this,"cause",void 0),this.code=e,this.details=n,this.cause=o}}function a(e){return e instanceof s?e:e instanceof Error?new s("UNKNOWN",e.message,void 0,e):new s("UNKNOWN","Unknown error",{err:e})}function u(){try{let t=c();return JSON.parse(e.readFileSync(n.join(t,"package.json"),"utf8")).version??"0.0.0"}catch{return"0.0.0"}}function c(){let t=n.dirname(o(import.meta.url)),r=t;for(let t=0;t<6;t+=1){let t=n.join(r,"package.json");if(e.existsSync(t))return r;r=n.dirname(r)}return t}async function f(e,t,n={}){return new Promise((o,r)=>{let d=i(e,t,{cwd:n.cwd,env:n.env,stdio:["pipe","pipe","pipe"]}),a="",u=n.binaryStdout?Buffer.alloc(0):void 0,c="";n.binaryStdout||d.stdout.setEncoding("utf8"),d.stderr.setEncoding("utf8"),void 0!==n.stdin&&d.stdin.write(n.stdin),d.stdin.end(),d.stdout.on("data",e=>{n.binaryStdout?u=Buffer.concat([u??Buffer.alloc(0),Buffer.isBuffer(e)?e:Buffer.from(e)]):a+=e}),d.stderr.on("data",e=>{c+=e}),d.on("error",n=>{"ENOENT"===n.code?r(new s("TOOL_MISSING",`${e} not found in PATH`,{cmd:e},n)):r(new s("COMMAND_FAILED",`Failed to run ${e}`,{cmd:e,args:t},n))}),d.on("close",i=>{let d=i??1;0===d||n.allowFailure?o({stdout:a,stderr:c,exitCode:d,stdoutBuffer:u}):r(new s("COMMAND_FAILED",`${e} exited with code ${d}`,{cmd:e,args:t,stdout:a,stderr:c,exitCode:d}))})})}async function l(e){try{var t;let{shell:n,args:o}=(t=e,"win32"===process.platform?{shell:"cmd.exe",args:["/c","where",t]}:{shell:"bash",args:["-lc",`command -v ${t}`]}),r=await f(n,o,{allowFailure:!0});return 0===r.exitCode&&r.stdout.trim().length>0}catch{return!1}}function p(e,t,n={}){i(e,t,{cwd:n.cwd,env:n.env,stdio:"ignore",detached:!0}).unref()}async function w(e,t,n={}){return new Promise((o,r)=>{let d=i(e,t,{cwd:n.cwd,env:n.env,stdio:["pipe","pipe","pipe"]}),a="",u="",c=n.binaryStdout?Buffer.alloc(0):void 0;n.binaryStdout||d.stdout.setEncoding("utf8"),d.stderr.setEncoding("utf8"),void 0!==n.stdin&&d.stdin.write(n.stdin),d.stdin.end(),d.stdout.on("data",e=>{if(n.binaryStdout){c=Buffer.concat([c??Buffer.alloc(0),Buffer.isBuffer(e)?e:Buffer.from(e)]);return}let t=String(e);a+=t,n.onStdoutChunk?.(t)}),d.stderr.on("data",e=>{let t=String(e);u+=t,n.onStderrChunk?.(t)}),d.on("error",n=>{"ENOENT"===n.code?r(new s("TOOL_MISSING",`${e} not found in PATH`,{cmd:e},n)):r(new s("COMMAND_FAILED",`Failed to run ${e}`,{cmd:e,args:t},n))}),d.on("close",i=>{let d=i??1;0===d||n.allowFailure?o({stdout:a,stderr:u,exitCode:d,stdoutBuffer:c}):r(new s("COMMAND_FAILED",`${e} exited with code ${d}`,{cmd:e,args:t,stdout:a,stderr:u,exitCode:d}))})})}function m(e,t,n={}){let o=i(e,t,{cwd:n.cwd,env:n.env,stdio:["ignore","pipe","pipe"]}),r="",d="";o.stdout.setEncoding("utf8"),o.stderr.setEncoding("utf8"),o.stdout.on("data",e=>{r+=e}),o.stderr.on("data",e=>{d+=e});let a=new Promise((i,a)=>{o.on("error",n=>{"ENOENT"===n.code?a(new s("TOOL_MISSING",`${e} not found in PATH`,{cmd:e},n)):a(new s("COMMAND_FAILED",`Failed to run ${e}`,{cmd:e,args:t},n))}),o.on("close",o=>{let u=o??1;0===u||n.allowFailure?i({stdout:r,stderr:d,exitCode:u}):a(new s("COMMAND_FAILED",`${e} exited with code ${u}`,{cmd:e,args:t,stdout:r,stderr:d,exitCode:u}))})});return{child:o,wait:a}}export{default as node_net}from"node:net";export{default as node_os}from"node:os";export{a as asAppError,s as errors_AppError,o as fileURLToPath,c as findProjectRoot,e as node_fs,n as node_path,r as pathToFileURL,t as promises,u as readVersion,f as runCmd,m as runCmdBackground,p as runCmdDetached,w as runCmdStreaming,l as whichCmd};
+import e,{promises as t}from"node:fs";import n from"node:path";import{fileURLToPath as o,pathToFileURL as r}from"node:url";import{spawn as i}from"node:child_process";function d(e,t,n){return t in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}class u extends Error{constructor(e,t,n,o){super(t),d(this,"code",void 0),d(this,"details",void 0),d(this,"cause",void 0),this.code=e,this.details=n,this.cause=o}}function s(e){return e instanceof u?e:e instanceof Error?new u("UNKNOWN",e.message,void 0,e):new u("UNKNOWN","Unknown error",{err:e})}function a(){try{let t=c();return JSON.parse(e.readFileSync(n.join(t,"package.json"),"utf8")).version??"0.0.0"}catch{return"0.0.0"}}function c(){let t=n.dirname(o(import.meta.url)),r=t;for(let t=0;t<6;t+=1){let t=n.join(r,"package.json");if(e.existsSync(t))return r;r=n.dirname(r)}return t}async function f(e,t,n={}){return new Promise((o,r)=>{let d=i(e,t,{cwd:n.cwd,env:n.env,stdio:["pipe","pipe","pipe"]}),s="",a=n.binaryStdout?Buffer.alloc(0):void 0,c="",f=!1,l=function(e){if(!Number.isFinite(e))return;let t=Math.floor(e);if(!(t<=0))return t}(n.timeoutMs),m=l?setTimeout(()=>{f=!0,d.kill("SIGKILL")},l):null;n.binaryStdout||d.stdout.setEncoding("utf8"),d.stderr.setEncoding("utf8"),void 0!==n.stdin&&d.stdin.write(n.stdin),d.stdin.end(),d.stdout.on("data",e=>{n.binaryStdout?a=Buffer.concat([a??Buffer.alloc(0),Buffer.isBuffer(e)?e:Buffer.from(e)]):s+=e}),d.stderr.on("data",e=>{c+=e}),d.on("error",n=>{(m&&clearTimeout(m),"ENOENT"===n.code)?r(new u("TOOL_MISSING",`${e} not found in PATH`,{cmd:e},n)):r(new u("COMMAND_FAILED",`Failed to run ${e}`,{cmd:e,args:t},n))}),d.on("close",i=>{m&&clearTimeout(m);let d=i??1;f&&l?r(new u("COMMAND_FAILED",`${e} timed out after ${l}ms`,{cmd:e,args:t,stdout:s,stderr:c,exitCode:d,timeoutMs:l})):0===d||n.allowFailure?o({stdout:s,stderr:c,exitCode:d,stdoutBuffer:a}):r(new u("COMMAND_FAILED",`${e} exited with code ${d}`,{cmd:e,args:t,stdout:s,stderr:c,exitCode:d}))})})}async function l(e){try{var t;let{shell:n,args:o}=(t=e,"win32"===process.platform?{shell:"cmd.exe",args:["/c","where",t]}:{shell:"bash",args:["-lc",`command -v ${t}`]}),r=await f(n,o,{allowFailure:!0});return 0===r.exitCode&&r.stdout.trim().length>0}catch{return!1}}function m(e,t,n={}){i(e,t,{cwd:n.cwd,env:n.env,stdio:"ignore",detached:!0}).unref()}async function p(e,t,n={}){return new Promise((o,r)=>{let d=i(e,t,{cwd:n.cwd,env:n.env,stdio:["pipe","pipe","pipe"]}),s="",a="",c=n.binaryStdout?Buffer.alloc(0):void 0;n.binaryStdout||d.stdout.setEncoding("utf8"),d.stderr.setEncoding("utf8"),void 0!==n.stdin&&d.stdin.write(n.stdin),d.stdin.end(),d.stdout.on("data",e=>{if(n.binaryStdout){c=Buffer.concat([c??Buffer.alloc(0),Buffer.isBuffer(e)?e:Buffer.from(e)]);return}let t=String(e);s+=t,n.onStdoutChunk?.(t)}),d.stderr.on("data",e=>{let t=String(e);a+=t,n.onStderrChunk?.(t)}),d.on("error",n=>{"ENOENT"===n.code?r(new u("TOOL_MISSING",`${e} not found in PATH`,{cmd:e},n)):r(new u("COMMAND_FAILED",`Failed to run ${e}`,{cmd:e,args:t},n))}),d.on("close",i=>{let d=i??1;0===d||n.allowFailure?o({stdout:s,stderr:a,exitCode:d,stdoutBuffer:c}):r(new u("COMMAND_FAILED",`${e} exited with code ${d}`,{cmd:e,args:t,stdout:s,stderr:a,exitCode:d}))})})}function w(e,t,n={}){let o=i(e,t,{cwd:n.cwd,env:n.env,stdio:["ignore","pipe","pipe"]}),r="",d="";o.stdout.setEncoding("utf8"),o.stderr.setEncoding("utf8"),o.stdout.on("data",e=>{r+=e}),o.stderr.on("data",e=>{d+=e});let s=new Promise((i,s)=>{o.on("error",n=>{"ENOENT"===n.code?s(new u("TOOL_MISSING",`${e} not found in PATH`,{cmd:e},n)):s(new u("COMMAND_FAILED",`Failed to run ${e}`,{cmd:e,args:t},n))}),o.on("close",o=>{let a=o??1;0===a||n.allowFailure?i({stdout:r,stderr:d,exitCode:a}):s(new u("COMMAND_FAILED",`${e} exited with code ${a}`,{cmd:e,args:t,stdout:r,stderr:d,exitCode:a}))})});return{child:o,wait:s}}export{default as node_net}from"node:net";export{default as node_os}from"node:os";export{s as asAppError,u as errors_AppError,o as fileURLToPath,c as findProjectRoot,e as node_fs,n as node_path,r as pathToFileURL,t as promises,a as readVersion,f as runCmd,w as runCmdBackground,m as runCmdDetached,p as runCmdStreaming,l as whichCmd};

package/dist/src/bin.js

@@ -1,15 +1,17 @@
-import{node_path as e,asAppError as t,pathToFileURL as r,runCmdDetached as i,node_fs as n,node_os as s,node_net as a,errors_AppError as o,readVersion as l,findProjectRoot as c}from"./274.js";function d(e){process.stdout.write(`${JSON.stringify(e,null,2)}
+import{node_path as e,asAppError as t,pathToFileURL as r,runCmdDetached as n,node_fs as a,node_os as i,node_net as s,errors_AppError as o,readVersion as l,findProjectRoot as c}from"./274.js";function d(e){process.stdout.write(`${JSON.stringify(e,null,2)}
 `)}function u(e){let t=e.details?`
 ${JSON.stringify(e.details,null,2)}`:"";process.stderr.write(`Error (${e.code}): ${e.message}${t}
-`)}function p(e,t,r){let i=f(e.type??"Element"),n=function(e,t){var r,i;let n=e.label?.trim(),s=e.value?.trim();if("text-field"===(r=t)||"text-view"===r||"search"===r){if(s)return s;if(n)return n}else if(n)return n;if(s)return s;let a=e.identifier?.trim();return!a||(i=a,/^[\w.]+:id\/[\w.-]+$/i.test(i)&&("group"===t||"image"===t||"list"===t||"collection"===t))?"":a}(e,i),s="  ".repeat(t),a=e.ref?`@${e.ref}`:"",o=[!1===e.enabled?"disabled":null].filter(Boolean).join(", "),l=o?` [${o}]`:"",c=n?` "${n}"`:"";return r?`${s}${a} [${i}]${l}`.trimEnd():`${s}${a} [${i}]${c}${l}`.trimEnd()}function f(e){let t=e.replace(/XCUIElementType/gi,"").toLowerCase(),r=e.includes(".")&&(e.startsWith("android.")||e.startsWith("androidx.")||e.startsWith("com."));switch(t.startsWith("ax")&&(t=t.replace(/^ax/,"")),t.includes(".")&&(t=t.replace(/^android\.widget\./,"").replace(/^android\.view\./,"").replace(/^android\.webkit\./,"").replace(/^androidx\./,"").replace(/^com\.google\.android\./,"").replace(/^com\.android\./,"")),t){case"application":return"application";case"navigationbar":return"navigation-bar";case"tabbar":return"tab-bar";case"button":case"imagebutton":return"button";case"link":return"link";case"cell":return"cell";case"statictext":case"checkedtextview":return"text";case"textfield":case"edittext":return"text-field";case"textview":return r?"text":"text-view";case"textarea":return"text-view";case"switch":return"switch";case"slider":return"slider";case"image":case"imageview":return"image";case"webview":return"webview";case"framelayout":case"linearlayout":case"relativelayout":case"constraintlayout":case"viewgroup":case"view":case"group":return"group";case"listview":case"recyclerview":return"list";case"collectionview":return"collection";case"searchfield":return"search";case"segmentedcontrol":return"segmented-control";case"window":return"window";case"checkbox":return"checkbox";case"radio":return"radio";case"menuitem":return"menu-item";case"toolbar":return"toolbar";case"scrollarea":case"scrollview":case"nestedscrollview":return"scroll-area";case"table":return"table";default:return t||"element"}}let m=e.join(s.homedir(),".agent-device"),h=e.join(m,"daemon.json"),w=function(){let e=process.env.AGENT_DEVICE_DAEMON_TIMEOUT_MS;if(!e)return 6e4;let t=Number(e);return Number.isFinite(t)?Math.max(1e3,Math.floor(t)):6e4}();async function y(e){let t=await v(),r={...e,token:t.token};return await $(t,r)}async function v(){let e=g(),t=l();if(e&&e.version===t&&await b(e))return e;e&&(e.version!==t||!await b(e))&&n.existsSync(h)&&n.unlinkSync(h),await x();let r=Date.now();for(;Date.now()-r<5e3;){let e=g();if(e&&await b(e))return e;await new Promise(e=>setTimeout(e,100))}throw new o("COMMAND_FAILED","Failed to start daemon",{infoPath:h,hint:"Run pnpm build, or delete ~/.agent-device/daemon.json if stale."})}function g(){if(!n.existsSync(h))return null;try{let e=JSON.parse(n.readFileSync(h,"utf8"));if(!e.port||!e.token)return null;return e}catch{return null}}async function b(e){return new Promise(t=>{let r=a.createConnection({host:"127.0.0.1",port:e.port},()=>{r.destroy(),t(!0)});r.on("error",()=>{t(!1)})})}async function x(){let t=c(),r=e.join(t,"dist","src","daemon.js"),s=e.join(t,"src","daemon.ts"),a=n.existsSync(r);if(!a&&!n.existsSync(s))throw new o("COMMAND_FAILED","Daemon entry not found",{distPath:r,srcPath:s});let l=a?[r]:["--experimental-strip-types",s];i(process.execPath,l)}async function $(e,t){return new Promise((r,i)=>{let n=a.createConnection({host:"127.0.0.1",port:e.port},()=>{n.write(`${JSON.stringify(t)}
-`)}),s=setTimeout(()=>{n.destroy(),i(new o("COMMAND_FAILED","Daemon request timed out",{timeoutMs:w}))},w),l="";n.setEncoding("utf8"),n.on("data",e=>{let t=(l+=e).indexOf("\n");if(-1===t)return;let a=l.slice(0,t).trim();if(a)try{let e=JSON.parse(a);n.end(),clearTimeout(s),r(e)}catch(e){clearTimeout(s),i(e)}}),n.on("error",e=>{clearTimeout(s),i(e)})})}async function S(r){let i=function(e){let t={json:!1,help:!1,version:!1},r=[];for(let i=0;i<e.length;i+=1){let n=e[i];if("--json"===n){t.json=!0;continue}if("--help"===n||"-h"===n){t.help=!0;continue}if("--version"===n||"-V"===n){t.version=!0;continue}if("--verbose"===n||"-v"===n){t.verbose=!0;continue}if("-i"===n){t.snapshotInteractiveOnly=!0;continue}if("-c"===n){t.snapshotCompact=!0;continue}if("--raw"===n){t.snapshotRaw=!0;continue}if("--no-record"===n){t.noRecord=!0;continue}if("--save-script"===n){t.saveScript=!0;continue}if("--update"===n||"-u"===n){t.replayUpdate=!0;continue}if("--user-installed"===n){t.appsFilter="user-installed";continue}if("--all"===n){t.appsFilter="all";continue}if("--metadata"===n){t.appsMetadata=!0;continue}if(n.startsWith("--backend")){let r=n.includes("=")?n.split("=")[1]:e[i+1];if(n.includes("=")||(i+=1),"ax"!==r&&"xctest"!==r)throw new o("INVALID_ARGS",`Invalid backend: ${r}`);t.snapshotBackend=r;continue}if(n.startsWith("--")){let[r,s]=n.split("="),a=s??e[i+1];switch(!s&&(i+=1),r){case"--platform":if("ios"!==a&&"android"!==a)throw new o("INVALID_ARGS",`Invalid platform: ${a}`);t.platform=a;break;case"--depth":{let e=Number(a);if(!Number.isFinite(e)||e<0)throw new o("INVALID_ARGS",`Invalid depth: ${a}`);t.snapshotDepth=Math.floor(e);break}case"--scope":t.snapshotScope=a;break;case"--device":t.device=a;break;case"--udid":t.udid=a;break;case"--serial":t.serial=a;break;case"--out":t.out=a;break;case"--session":t.session=a;break;case"--activity":t.activity=a;break;default:throw new o("INVALID_ARGS",`Unknown flag: ${r}`)}continue}if("-d"===n){let r=e[i+1];i+=1;let n=Number(r);if(!Number.isFinite(n)||n<0)throw new o("INVALID_ARGS",`Invalid depth: ${r}`);t.snapshotDepth=Math.floor(n);continue}if("-s"===n){let r=e[i+1];i+=1,t.snapshotScope=r;continue}r.push(n)}return{command:r.shift()??null,positionals:r,flags:t}}(r);i.flags.version&&(process.stdout.write(`${l()}
-`),process.exit(0)),(i.flags.help||!i.command)&&(process.stdout.write(`agent-device <command> [args] [--json]
+`)}function p(e,t,r){let n=f(e.type??"Element"),a=function(e,t){var r,n;let a=e.label?.trim(),i=e.value?.trim();if("text-field"===(r=t)||"text-view"===r||"search"===r){if(i)return i;if(a)return a}else if(a)return a;if(i)return i;let s=e.identifier?.trim();return!s||(n=s,/^[\w.]+:id\/[\w.-]+$/i.test(n)&&("group"===t||"image"===t||"list"===t||"collection"===t))?"":s}(e,n),i="  ".repeat(t),s=e.ref?`@${e.ref}`:"",o=[!1===e.enabled?"disabled":null].filter(Boolean).join(", "),l=o?` [${o}]`:"",c=a?` "${a}"`:"";return r?`${i}${s} [${n}]${l}`.trimEnd():`${i}${s} [${n}]${c}${l}`.trimEnd()}function f(e){let t=e.replace(/XCUIElementType/gi,"").toLowerCase(),r=e.includes(".")&&(e.startsWith("android.")||e.startsWith("androidx.")||e.startsWith("com."));switch(t.startsWith("ax")&&(t=t.replace(/^ax/,"")),t.includes(".")&&(t=t.replace(/^android\.widget\./,"").replace(/^android\.view\./,"").replace(/^android\.webkit\./,"").replace(/^androidx\./,"").replace(/^com\.google\.android\./,"").replace(/^com\.android\./,"")),t){case"application":return"application";case"navigationbar":return"navigation-bar";case"tabbar":return"tab-bar";case"button":case"imagebutton":return"button";case"link":return"link";case"cell":return"cell";case"statictext":case"checkedtextview":return"text";case"textfield":case"edittext":return"text-field";case"textview":return r?"text":"text-view";case"textarea":return"text-view";case"switch":return"switch";case"slider":return"slider";case"image":case"imageview":return"image";case"webview":return"webview";case"framelayout":case"linearlayout":case"relativelayout":case"constraintlayout":case"viewgroup":case"view":case"group":return"group";case"listview":case"recyclerview":return"list";case"collectionview":return"collection";case"searchfield":return"search";case"segmentedcontrol":return"segmented-control";case"window":return"window";case"checkbox":return"checkbox";case"radio":return"radio";case"menuitem":return"menu-item";case"toolbar":return"toolbar";case"scrollarea":case"scrollview":case"nestedscrollview":return"scroll-area";case"table":return"table";default:return t||"element"}}let m=e.join(i.homedir(),".agent-device"),h=e.join(m,"daemon.json"),w=function(){let e=process.env.AGENT_DEVICE_DAEMON_TIMEOUT_MS;if(!e)return 6e4;let t=Number(e);return Number.isFinite(t)?Math.max(1e3,Math.floor(t)):6e4}();async function y(e){let t=await v(),r={...e,token:t.token};return await $(t,r)}async function v(){let e=g(),t=l();if(e&&e.version===t&&await b(e))return e;e&&(e.version!==t||!await b(e))&&a.existsSync(h)&&a.unlinkSync(h),await x();let r=Date.now();for(;Date.now()-r<5e3;){let e=g();if(e&&await b(e))return e;await new Promise(e=>setTimeout(e,100))}throw new o("COMMAND_FAILED","Failed to start daemon",{infoPath:h,hint:"Run pnpm build, or delete ~/.agent-device/daemon.json if stale."})}function g(){if(!a.existsSync(h))return null;try{let e=JSON.parse(a.readFileSync(h,"utf8"));if(!e.port||!e.token)return null;return e}catch{return null}}async function b(e){return new Promise(t=>{let r=s.createConnection({host:"127.0.0.1",port:e.port},()=>{r.destroy(),t(!0)});r.on("error",()=>{t(!1)})})}async function x(){let t=c(),r=e.join(t,"dist","src","daemon.js"),i=e.join(t,"src","daemon.ts"),s=a.existsSync(r);if(!s&&!a.existsSync(i))throw new o("COMMAND_FAILED","Daemon entry not found",{distPath:r,srcPath:i});let l=s?[r]:["--experimental-strip-types",i];n(process.execPath,l)}async function $(e,t){return new Promise((r,n)=>{let a=s.createConnection({host:"127.0.0.1",port:e.port},()=>{a.write(`${JSON.stringify(t)}
+`)}),i=setTimeout(()=>{a.destroy(),n(new o("COMMAND_FAILED","Daemon request timed out",{timeoutMs:w}))},w),l="";a.setEncoding("utf8"),a.on("data",e=>{let t=(l+=e).indexOf("\n");if(-1===t)return;let s=l.slice(0,t).trim();if(s)try{let e=JSON.parse(s);a.end(),clearTimeout(i),r(e)}catch(e){clearTimeout(i),n(e)}}),a.on("error",e=>{clearTimeout(i),n(e)})})}async function S(r){let n=function(e){let t={json:!1,help:!1,version:!1},r=[];for(let n=0;n<e.length;n+=1){let a=e[n];if("--json"===a){t.json=!0;continue}if("--help"===a||"-h"===a){t.help=!0;continue}if("--version"===a||"-V"===a){t.version=!0;continue}if("--verbose"===a||"-v"===a){t.verbose=!0;continue}if("-i"===a){t.snapshotInteractiveOnly=!0;continue}if("-c"===a){t.snapshotCompact=!0;continue}if("--raw"===a){t.snapshotRaw=!0;continue}if("--no-record"===a){t.noRecord=!0;continue}if("--save-script"===a){t.saveScript=!0;continue}if("--update"===a||"-u"===a){t.replayUpdate=!0;continue}if("--user-installed"===a){t.appsFilter="user-installed";continue}if("--all"===a){t.appsFilter="all";continue}if("--metadata"===a){t.appsMetadata=!0;continue}if(a.startsWith("--backend")){let r=a.includes("=")?a.split("=")[1]:e[n+1];if(a.includes("=")||(n+=1),"ax"!==r&&"xctest"!==r)throw new o("INVALID_ARGS",`Invalid backend: ${r}`);t.snapshotBackend=r;continue}if(a.startsWith("--")){let[r,i]=a.split("="),s=i??e[n+1];switch(!i&&(n+=1),r){case"--platform":if("ios"!==s&&"android"!==s)throw new o("INVALID_ARGS",`Invalid platform: ${s}`);t.platform=s;break;case"--depth":{let e=Number(s);if(!Number.isFinite(e)||e<0)throw new o("INVALID_ARGS",`Invalid depth: ${s}`);t.snapshotDepth=Math.floor(e);break}case"--scope":t.snapshotScope=s;break;case"--device":t.device=s;break;case"--udid":t.udid=s;break;case"--serial":t.serial=s;break;case"--out":t.out=s;break;case"--session":t.session=s;break;case"--activity":t.activity=s;break;default:throw new o("INVALID_ARGS",`Unknown flag: ${r}`)}continue}if("-d"===a){let r=e[n+1];n+=1;let a=Number(r);if(!Number.isFinite(a)||a<0)throw new o("INVALID_ARGS",`Invalid depth: ${r}`);t.snapshotDepth=Math.floor(a);continue}if("-s"===a){let r=e[n+1];n+=1,t.snapshotScope=r;continue}r.push(a)}return{command:r.shift()??null,positionals:r,flags:t}}(r);n.flags.version&&(process.stdout.write(`${l()}
+`),process.exit(0)),(n.flags.help||!n.command)&&(process.stdout.write(`agent-device <command> [args] [--json]
 
 CLI to control iOS and Android devices for AI agents.
 
 Commands:
+  boot                                      Ensure target device/simulator is booted and ready
   open [app]                                 Boot device/simulator; optionally launch app
   close [app]                                Close app or just end session
+  reinstall <app> <path>                     Uninstall + install app from binary path
   snapshot [-i] [-c] [-d <depth>] [-s <scope>] [--raw] [--backend ax|xctest]
                                              Capture accessibility tree
     -i                                       Interactive elements only
@@ -71,30 +73,31 @@ Flags:
   --all                                      Apps: list all packages (Android only)
   --version, -V                              Print version and exit
 
-`),process.exit(+!i.flags.help));let{command:a,positionals:c,flags:m}=i,h=m.session??process.env.AGENT_DEVICE_SESSION??"default",w=m.verbose&&!m.json?function(){try{let t=e.join(s.homedir(),".agent-device","daemon.log"),r=0,i=!1,a=setInterval(()=>{if(i||!n.existsSync(t))return;let e=n.statSync(t);if(e.size<=r)return;let s=n.openSync(t,"r"),a=Buffer.alloc(e.size-r);n.readSync(s,a,0,a.length,r),n.closeSync(s),r=e.size,a.length>0&&process.stdout.write(a.toString("utf8"))},200);return()=>{i=!0,clearInterval(a)}}catch{return null}}():null;try{if("session"===a){let e=c[0]??"list";if("list"!==e)throw new o("INVALID_ARGS","session only supports list");let t=await y({session:h,command:"session_list",positionals:[],flags:{}});if(!t.ok)throw new o(t.error.code,t.error.message);m.json?d({success:!0,data:t.data??{}}):process.stdout.write(`${JSON.stringify(t.data??{},null,2)}
-`),w&&w();return}let e=await y({session:h,command:a,positionals:c,flags:m});if(e.ok){if(m.json){d({success:!0,data:e.data??{}}),w&&w();return}if("snapshot"===a){process.stdout.write(function(e,t={}){let r=e.nodes,i=Array.isArray(r)?r:[],n=!!e.truncated,s="string"==typeof e.appName?e.appName:void 0,a="string"==typeof e.appBundleId?e.appBundleId:void 0,o=[];s&&o.push(`Page: ${s}`),a&&o.push(`App: ${a}`);let l=`Snapshot: ${i.length} nodes${n?" (truncated)":""}`,c=o.length>0?`${o.join("\n")}
-`:"";if(0===i.length)return`${c}${l}
-`;if(t.raw){let e=i.map(e=>JSON.stringify(e));return`${c}${l}
+`),process.exit(+!n.flags.help));let{command:s,positionals:c,flags:m}=n,h=m.session??process.env.AGENT_DEVICE_SESSION??"default",w=m.verbose&&!m.json?function(){try{let t=e.join(i.homedir(),".agent-device","daemon.log"),r=0,n=!1,s=setInterval(()=>{if(n||!a.existsSync(t))return;let e=a.statSync(t);if(e.size<=r)return;let i=a.openSync(t,"r"),s=Buffer.alloc(e.size-r);a.readSync(i,s,0,s.length,r),a.closeSync(i),r=e.size,s.length>0&&process.stdout.write(s.toString("utf8"))},200);return()=>{n=!0,clearInterval(s)}}catch{return null}}():null;try{if("session"===s){let e=c[0]??"list";if("list"!==e)throw new o("INVALID_ARGS","session only supports list");let t=await y({session:h,command:"session_list",positionals:[],flags:{}});if(!t.ok)throw new o(t.error.code,t.error.message);m.json?d({success:!0,data:t.data??{}}):process.stdout.write(`${JSON.stringify(t.data??{},null,2)}
+`),w&&w();return}let e=await y({session:h,command:s,positionals:c,flags:m});if(e.ok){if(m.json){d({success:!0,data:e.data??{}}),w&&w();return}if("snapshot"===s){process.stdout.write(function(e,t={}){let r=e.nodes,n=Array.isArray(r)?r:[],a=!!e.truncated,i="string"==typeof e.appName?e.appName:void 0,s="string"==typeof e.appBundleId?e.appBundleId:void 0,o=[];i&&o.push(`Page: ${i}`),s&&o.push(`App: ${s}`);let l=`Snapshot: ${n.length} nodes${a?" (truncated)":""}`,c=o.length>0?`${o.join("\n")}
+`:"";if(0===n.length)return`${c}${l}
+`;if(t.raw){let e=n.map(e=>JSON.stringify(e));return`${c}${l}
 ${e.join("\n")}
-`}if(t.flatten){let e=i.map(e=>p(e,0,!1));return`${c}${l}
+`}if(t.flatten){let e=n.map(e=>p(e,0,!1));return`${c}${l}
 ${e.join("\n")}
-`}let d=[],u=[];for(let e of i){let t=e.depth??0;for(;d.length>0&&t<=d[d.length-1];)d.pop();let r=e.label?.trim()||e.value?.trim()||e.identifier?.trim()||"",i="group"===f(e.type??"Element")&&!r;i&&d.push(t);let n=i?t:Math.max(0,t-d.length);u.push(p(e,n,i))}return`${c}${l}
+`}let d=[],u=[];for(let e of n){let t=e.depth??0;for(;d.length>0&&t<=d[d.length-1];)d.pop();let r=e.label?.trim()||e.value?.trim()||e.identifier?.trim()||"",n="group"===f(e.type??"Element")&&!r;n&&d.push(t);let a=n?t:Math.max(0,t-d.length);u.push(p(e,a,n))}return`${c}${l}
 ${u.join("\n")}
-`}(e.data??{},{raw:m.snapshotRaw,flatten:m.snapshotInteractiveOnly})),w&&w();return}if("get"===a){let t=c[0];if("text"===t){let t=e.data?.text??"";process.stdout.write(`${t}
+`}(e.data??{},{raw:m.snapshotRaw,flatten:m.snapshotInteractiveOnly})),w&&w();return}if("get"===s){let t=c[0];if("text"===t){let t=e.data?.text??"";process.stdout.write(`${t}
 `),w&&w();return}if("attrs"===t){let t=e.data?.node??{};process.stdout.write(`${JSON.stringify(t,null,2)}
-`),w&&w();return}}if("find"===a){let t=e.data;if("string"==typeof t?.text){process.stdout.write(`${t.text}
+`),w&&w();return}}if("find"===s){let t=e.data;if("string"==typeof t?.text){process.stdout.write(`${t.text}
 `),w&&w();return}if("boolean"==typeof t?.found){process.stdout.write(`Found: ${t.found}
 `),w&&w();return}if(t?.node){process.stdout.write(`${JSON.stringify(t.node,null,2)}
-`),w&&w();return}}if("is"===a){let t=e.data?.predicate??"assertion";process.stdout.write(`Passed: is ${t}
-`),w&&w();return}if("click"===a){let t=e.data?.ref??"",r=e.data?.x,i=e.data?.y;t&&"number"==typeof r&&"number"==typeof i&&process.stdout.write(`Clicked @${t} (${r}, ${i})
-`),w&&w();return}if(e.data&&"object"==typeof e.data){let t=e.data;if("devices"===a){let e=(Array.isArray(t.devices)?t.devices:[]).map(e=>{let t=e?.name??e?.id??"unknown",r=e?.platform??"unknown",i=e?.kind?` ${e.kind}`:"",n="boolean"==typeof e?.booted?` booted=${e.booted}`:"";return`${t} (${r}${i})${n}`});process.stdout.write(`${e.join("\n")}
-`),w&&w();return}if("apps"===a){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,r=e.name??e.label;return r&&t?`${r} (${t})`:t&&"boolean"==typeof e.launchable?`${t} (launchable=${e.launchable})`:t?String(t):JSON.stringify(e)}return String(e)});process.stdout.write(`${e.join("\n")}
-`),w&&w();return}if("appstate"===a){let e=t?.platform,r=t?.appBundleId,i=t?.appName,n=t?.source,s=t?.package,a=t?.activity;if("ios"===e){process.stdout.write(`Foreground app: ${i??r}
+`),w&&w();return}}if("is"===s){let t=e.data?.predicate??"assertion";process.stdout.write(`Passed: is ${t}
+`),w&&w();return}if("boot"===s){let t=e.data?.platform??"unknown",r=e.data?.device??e.data?.id??"unknown";process.stdout.write(`Boot ready: ${r} (${t})
+`),w&&w();return}if("click"===s){let t=e.data?.ref??"",r=e.data?.x,n=e.data?.y;t&&"number"==typeof r&&"number"==typeof n&&process.stdout.write(`Clicked @${t} (${r}, ${n})
+`),w&&w();return}if(e.data&&"object"==typeof e.data){let t=e.data;if("devices"===s){let e=(Array.isArray(t.devices)?t.devices:[]).map(e=>{let t=e?.name??e?.id??"unknown",r=e?.platform??"unknown",n=e?.kind?` ${e.kind}`:"",a="boolean"==typeof e?.booted?` booted=${e.booted}`:"";return`${t} (${r}${n})${a}`});process.stdout.write(`${e.join("\n")}
+`),w&&w();return}if("apps"===s){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,r=e.name??e.label;return r&&t?`${r} (${t})`:t&&"boolean"==typeof e.launchable?`${t} (launchable=${e.launchable})`:t?String(t):JSON.stringify(e)}return String(e)});process.stdout.write(`${e.join("\n")}
+`),w&&w();return}if("appstate"===s){let e=t?.platform,r=t?.appBundleId,n=t?.appName,a=t?.source,i=t?.package,s=t?.activity;if("ios"===e){process.stdout.write(`Foreground app: ${n??r}
 `),r&&process.stdout.write(`Bundle: ${r}
-`),n&&process.stdout.write(`Source: ${n}
-`),w&&w();return}if("android"===e){process.stdout.write(`Foreground app: ${s??"unknown"}
-`),a&&process.stdout.write(`Activity: ${a}
-`),w&&w();return}}}w&&w();return}throw new o(e.error.code,e.error.message,e.error.details)}catch(r){let e=t(r);if(m.json)d({success:!1,error:{code:e.code,message:e.message,details:e.details}});else if(u(e),m.verbose)try{let e=await import("node:fs"),t=await import("node:os"),r=(await import("node:path")).join(t.homedir(),".agent-device","daemon.log");if(e.existsSync(r)){let t=e.readFileSync(r,"utf8").split("\n"),i=t.slice(Math.max(0,t.length-200)).join("\n");i.trim().length>0&&process.stderr.write(`
+`),a&&process.stdout.write(`Source: ${a}
+`),w&&w();return}if("android"===e){process.stdout.write(`Foreground app: ${i??"unknown"}
+`),s&&process.stdout.write(`Activity: ${s}
+`),w&&w();return}}}w&&w();return}throw new o(e.error.code,e.error.message,e.error.details)}catch(r){let e=t(r);if(m.json)d({success:!1,error:{code:e.code,message:e.message,details:e.details}});else if(u(e),m.verbose)try{let e=await import("node:fs"),t=await import("node:os"),r=(await import("node:path")).join(t.homedir(),".agent-device","daemon.log");if(e.existsSync(r)){let t=e.readFileSync(r,"utf8").split("\n"),n=t.slice(Math.max(0,t.length-200)).join("\n");n.trim().length>0&&process.stderr.write(`
 [daemon log]
-${i}
+${n}
 `)}}catch{}w&&w(),process.exit(1)}}r(process.argv[1]??"").href===import.meta.url&&S(process.argv.slice(2)).catch(e=>{u(t(e)),process.exit(1)}),S(process.argv.slice(2));