@appetize/cli 0.26.0 → 0.28.0

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @appetize/cli
 
+## 0.28.0
+
+### Minor Changes
+
+- feat(screenshot): `--select-*` captures only the matched element
+
+### Patch Changes
+
+- docs: describe element and position selectors in `--help`
+
+## 0.27.0
+
+### Minor Changes
+
+- feat: `biometry authenticate` answers the app's biometric prompt
+- feat: `settings set` changes appearance, font size and location, and `biometry enroll` toggles enrollment, mid-session
+
 ## 0.26.0
 
 ### Minor Changes

package/cli.js

@@ -1,12 +1,32 @@
 #!/usr/bin/env node
-import Ye from"sade";import{p as u,a as h,f as R,U as a,d as z,b as Qe,i as et,c as tt,e as nt,r as oe,g as k,h as I,j as ot,D as it,s as st,k as rt,l as ie,m as se,S as U,n as j,o as re,q as F,t as T,u as ae,v as ce,w as pe,x as at,y as ct,z as de,A as pt,B as le,C as dt,E as lt,F as ut,G as ft,H as ue,I as fe,J as mt,K as ht,L as gt,M as wt,N as yt,O as vt}from"./stream-C_BND5fe.js";import{existsSync as me,openAsBlob as xt,openSync as St,closeSync as bt}from"node:fs";import{basename as C,extname as Et,resolve as he,dirname as Ot,join as x,relative as At}from"node:path";import{writeFile as ge,stat as Pt,rm as kt,cp as It}from"node:fs/promises";import{spawn as Tt}from"node:child_process";import{fileURLToPath as we}from"node:url";import{humanId as $t}from"human-id";import{homedir as Lt}from"node:os";import Dt from"debug";import Nt from"yocto-spinner";import _t from"cli-table3";import"json-rpc-2.0";import"zod/mini";import"stream";import"module";import"node:net";const M=["closed","fullyOpen","partiallyOpen"],ye=["back","menu","unlock","volumeDown","volumeUp"],ve=["home","lock"],xe=[...ve,...ye],B=["down","left","right","up"],Se=[{header:"Target",key:"id"},{header:"App",key:"appId"},{header:"Platform",key:"platform"},{header:"Version",key:"versionName"},{header:"Build",key:"buildNumber"},{header:"Uploaded",key:"created"}];function q({appId:e,buildNumber:t,created:n,id:o,platform:i,versionName:s}){return{appId:e,buildNumber:t,created:n,id:o,platform:i,versionName:s}}const Rt=["app"],zt=10,Ut=[{fields:Se,key:"builds"},{header:"Total",key:"total"},{header:"Next page",key:"nextPage"}];async function jt({options:e,signal:t}){const n=u(e.app,"--app"),o=h(e.limit,"--limit")??zt,i=h(e.page,"--page"),s={limit:String(o)};n!==void 0&&(s.appId=n),i!==void 0&&(s.page=String(i));const r=await R("/api/v2/builds",{commandOptions:e,query:s,signal:t});return{builds:r.builds.map(q),nextPage:r.nextPage,total:r.total}}const Ft=["note","tags"],be=12e4,Ct=2e3,G=[".apk",".apks",".zip",".tar.gz",".tgz"],Mt={".apk":"android",".apks":"android",".tar.gz":"ios",".tgz":"ios",".zip":"ios"},Bt=Se;async function qt({options:e,positionals:[t],progress:n,signal:o}){const i=Zt(t),s=C(t);n.status(`Uploading ${s}`);const r=await Vt(t,i,e,o);if(e.wait!==!0)return n.status(`Uploaded ${s}`),q(r);n.step(`Uploaded ${s}`),n.status("Waiting for build metadata");const p=await Gt(r.id,e,o);return n.status(`Processed ${s}`),q(p)}async function Gt(e,t,n){const o=h(t.timeout,"--timeout")??be,i=Date.now()+o;for(;;){const s=await R(`/api/v2/builds/${e}`,{commandOptions:t,signal:n});if(s.appId!==void 0)return s;if(Date.now()>=i)throw new Error(`Build ${e} is still being processed after ${String(o)}ms; find it with 'appetize build list'`);await z(Ct,n)}}async function Kt(e){if(!me(e))throw new Error(`No build file at ${e}`);return await xt(e)}function Zt(e){const t=e.toLowerCase(),n=G.find(o=>t.endsWith(o));if(n===void 0)throw new a(`Cannot tell the platform of ${C(e)}; upload a ${G.join(", ")} file`);return Mt[n]}async function Vt(e,t,n,o){const i=new FormData;i.set("platform",t);const s=u(n.note,"--note");s!==void 0&&i.set("note",s);const r=u(n.tags,"--tags");return r!==void 0&&i.set("tags",r),i.set("file",await Kt(e),C(e)),await R("/api/v2/builds",{body:i,commandOptions:n,method:"POST",signal:o})}const Wt=["platform"],Xt=[{fields:[{header:"ID",key:"id"},{header:"Name",key:"name"},{header:"Platform",key:"platform"},{header:"OS versions",key:"osVersions"}],key:"devices"}];async function Ht({options:e,signal:t}){const n=Jt(e.platform);return{devices:(await Qe(e,t)).filter(i=>n===void 0||i.platform===n).map(Yt)}}function Jt(e){const t=u(e,"--platform");if(t!==void 0){if(!et(t))throw new a(`--platform expects one of: ${tt.join(", ")}`);return t}}function Yt({id:e,name:t,osVersions:n,platform:o}){return{id:e,name:t,osVersions:n,platform:o}}const Qt="cli-fold",en=async({device:e,positionals:[t]})=>{if(!tn(t))throw new a(`Hinge must be one of: ${M.join(", ")}`);await e.fold(t)};function tn(e){return M.some(t=>t===e)}const nn=async({device:e,options:t,positionals:[n]})=>{await e.gesture(sn(n),on(t))};function on(e){const t=h(e.timeout,"--timeout");return t===void 0?void 0:{timeout:t}}function sn(e){let t;try{t=nt(e)}catch(n){throw n instanceof SyntaxError?new a(n.message):n}if(t.length===0)throw new a("Expected at least one gesture step");return t}const rn="APPETIZE_OUTPUT";function an(e,t,n){return{format:cn(e,t),progress:pn(e,n)}}function K(e,{extension:t,strict:n=!1}){const o=Et(e);if(o==="")return`${e}${t}`;if(n&&o!==t)throw new a(`The output must be a path ending in ${t}`);return e}function cn(e,t){if(e.json===!0)return"json";if(e.json===!1)return"text";const n=process.env[rn]?.trim();return n==="json"||n==="text"?n:t.isTTY===!0?"text":"json"}function pn(e,t){return e.quiet===!0?"silent":t.isTTY===!0&&process.env.TERM!=="dumb"&&!("CI"in process.env)?"interactive":"silent"}const S=["text","testId"],g="select",E={testId:{help:"Test id to match by exact string",suffix:"test-id"},text:{help:'Text to match by exact string or regex (e.g., "Sign in" or "/sign in/i")',suffix:"text"}},Z="index",$="position",V="x",W="y";function Ee(e,{prefix:t=g}={}){return S.reduce((n,o)=>{const{help:i,suffix:s}=E[o];return n.option(`--${d(t,s)}`,i)},e).option(`--${d(t,Z)}`,"Which match when multiple (0-based)")}function X(e,t={}){const{prefix:n=g}=t;return Ee(e,t).option(`--${d(n,$)}`,"Screen position to use as x,y (0-1), e.g., 0.5,0.75").option(`--${d(n,V)}`,"Horizontal position within the element (0-1, outside allowed)").option(`--${d(n,W)}`,"Vertical position within the element (0-1, outside allowed)")}function Oe(e,{prefix:t=g}={}){const n=J(e,t);if(n.length===0)throw new a(`A selector is required: pass one of ${D(S,t)}`);if(n.length>1)throw new a(`Only one selector may be given, got ${D(n,t)}`);const[o]=n,i=$e(e,d(t,E[o].suffix)),s=h(e[d(t,Z)],`--${d(t,Z)}`);switch(o){case"testId":return{by:"testId",index:s,testId:i};case"text":return{by:"text",index:s,text:un(i)}}}function Ae(e){const t=h(e.timeout,"--timeout");return t===void 0?void 0:{timeout:t}}function dn(e,{prefix:t=g}={}){return Ie(e,t)?Oe(e,{prefix:t}):void 0}function L(e,{prefix:t=g}={}){return Ie(e,t)?Pe(e,{prefix:t}):void 0}function Pe(e,{prefix:t=g}={}){const n=d(t,$),o=e[n],i=Te(e,d(t,V)),s=Te(e,d(t,W));if(o===void 0){if(J(e,t).length===0)throw new a(`A selector is required: pass one of ${O({prefix:t})}`);return{...Oe(e,{prefix:t}),x:i,y:s}}if(J(e,t).length>0)throw new a(`--${n} may not be combined with ${D(S,t)}`);if(i!==void 0||s!==void 0)throw new a(`--${n} may not be combined with --${d(t,V)} or --${d(t,W)}`);return ln($e(e,n),n)}function O(e={}){const{prefix:t=g}=e;return`${D(S,t)}, --${d(t,$)}`}function H(e={}){const{prefix:t=g}=e;return[...ke(e),d(t,$)]}function ke({prefix:e=g}={}){return S.map(t=>d(e,E[t].suffix))}function J(e,t){return S.filter(n=>e[d(t,E[n].suffix)]!==void 0)}function d(...e){return e.filter(Boolean).join("-")}function D(e,t){return e.map(n=>`--${d(t,E[n].suffix)}`).join(", ")}function Ie(e,t){return Object.entries(e).some(([n,o])=>o!==void 0&&n.startsWith(`${t}-`))}function Te(e,t){return h(e[t],`--${t}`)}function ln(e,t){const n=e.split(",");if(n.length!==2)throw new a(`--${t} expects x,y (0-1), e.g., 0.5,0.75`);const[o,i]=n.map(s=>Number(s.trim()));return{by:"position",x:oe(o,`--${t}`),y:oe(i,`--${t}`)}}function un(e){const t=/^\/(.*)\/([a-z]*)$/s.exec(e);return t?new RegExp(t[1],t[2]):e}function $e(e,t){return k(e[t],`--${t}`)}const fn=ke(),mn=async({device:e,options:t,positionals:[n]})=>{const o=hn(n),i=dn(t),s=await e.inspect(i,Ae(t)),r=gn(s,t.pretty===!0);await ge(o,r);const p=Buffer.byteLength(r),c=Le(s.roots);return i?{bytes:p,matches:s.roots.length,nodes:c,output:o}:{bytes:p,nodes:c,output:o}};function Le(e){return e.reduce((t,n)=>t+1+Le(n.children),0)}function hn(e="inspect"){return K(e,{extension:".json"})}function gn(e,t){return`${JSON.stringify(e,null,t?2:void 0)}
-`}const wn=async({device:e})=>{await e.settings.clearKeychain()},yn=async({device:e,positionals:[t]})=>{await e.open(vn(t))};function vn(e){if(typeof e=="string")try{return new URL(e),e}catch{throw new a("<url> expects a URL, e.g., myapp://orders/42")}throw new a("<url> expects a URL, e.g., myapp://orders/42")}const xn=new Set(xe),Sn=async({device:e,positionals:[t]})=>{if(!bn(t))throw new a(`Button must be one of: ${xe.join(", ")}`);await e.press(t)};function bn(e){return typeof e=="string"&&xn.has(e)}const En=async({control:e,options:t,positionals:[n]})=>{const{path:o}=await e.recordStart({force:t.force===!0,path:An(n)});return{path:o}},On=async({control:e})=>{const{path:t}=await e.recordStop();return{path:t}};function An(e){const t=he(K(e,{extension:".mp4",strict:!0})),n=Ot(t);if(!me(n))throw new a(`No such directory: ${n}`);return t}const Pn=async({device:e,positionals:[t]})=>{if(!kn(t))throw new a(`Orientation must be one of: ${I.join(", ")}`);await e.rotate(t)};function kn(e){return I.some(t=>t===e)}const In=async({device:e,positionals:[t]})=>{const n=await e.screenshot(),o=$n(n.mimeType,t);return await ge(o,n.data),{bytes:n.data.byteLength,output:o}};function Tn(e){const t=e.split("/").at(1);return`.${t==="jpeg"?"jpg":t??"png"}`}function $n(e,t="screenshot"){return K(t,{extension:Tn(e)})}function Ln(e){const t=we(new URL("./daemon.js",import.meta.url)),n=St(ot(e.sessionId),"a"),o=Tt(process.execPath,[t],{detached:!0,env:{...process.env,[it]:st(e),DEBUG:Dn(process.env.DEBUG)},stdio:["ignore",n,n]});if(bt(n),o.unref(),o.pid===void 0)throw new Error("Failed to spawn the session daemon");return o.pid}function Dn(e){return e?`${e},appetize:daemon`:"appetize:daemon"}const Nn=/^[a-z0-9](?:[a-z0-9._-]{0,62}[a-z0-9])?$/i;function _n(){return $t({capitalize:!1,separator:"-"})}function Rn(e){if(!Nn.test(e))throw new a('--session-id must use letters, digits, ".", "-" or "_"');return e}const De=1e4;function Ne(e){if(!rt(e))return!1;try{process.kill(e.pid,"SIGTERM")}catch{}return!0}async function _e(e,t){(Ne(e)||Un(e))&&await zn(e,t)}async function zn({pid:e,sessionId:t},n){const o=se(e);try{await z(De,AbortSignal.any([n,o]))}catch(i){if(o.aborted||!ie(e))return;throw i}throw new U(`Session ${t} did not stop in time`,{sessionId:t})}function Un({endedAt:e,pid:t}){return e!==void 0&&Date.now()-Date.parse(e)<De&&ie(t)}const jn=["device-android-shell","device-appearance","device-font-size","device-ios-keyboards","device-locale","device-location","device-orientation","device-os-version","device-timezone"];function Fn(e,t){const n=j({shell:u(e["device-android-shell"],"--device-android-shell"),softKeyboard:re(e["device-android-soft-keyboard"],{defaultValue:!0})}),o=j({autocorrect:re(e["device-ios-autocorrect"],{defaultValue:!0}),keyboards:F(e["device-ios-keyboards"],"--device-ios-keyboards")});return{android:n,appearance:T(e["device-appearance"],ce,"--device-appearance"),fontSize:T(e["device-font-size"],ae,"--device-font-size"),id:t,ios:o,locale:u(e["device-locale"],"--device-locale"),location:Mn(e["device-location"]),orientation:T(e["device-orientation"],I,"--device-orientation"),osVersion:u(e["device-os-version"],"--device-os-version"),timezone:u(e["device-timezone"],"--device-timezone")}}function Cn(e){return e!==""&&Number.isFinite(Number(e))}function Mn(e){const t=u(e,"--device-location");if(t===void 0)return;const n=t.split(",").map(s=>s.trim());if(n.length!==2||!n.every(Cn))throw new a("--device-location expects <lat>,<lng>, e.g., 43.65,-79.38");const[o,i]=n.map(Number);return{latitude:o,longitude:i}}const Bn=["launch-app","launch-ios-args","launch-params","launch-permissions","launch-url","open"];function qn(e){const t=F(e["launch-ios-args"],"--launch-ios-args");return j({app:Gn(e["launch-app"]),ios:t===void 0?void 0:{args:t},params:Kn(e["launch-params"]),permissions:T(e["launch-permissions"],pe,"--launch-permissions"),url:u(e["launch-url"],"--launch-url")??u(e.open,"--open")})}function Gn(e){return e===!1?!1:u(e,"--launch-app")}function Kn(e){const t=F(e,"--launch-params");if(t!==void 0)return Object.fromEntries(t.map(Zn))}function Zn(e){const t=e.indexOf("=");if(t<1)throw new a("--launch-params expects key=value, e.g., --launch-params debug=true");return[e.slice(0,t),Vn(e.slice(t+1))]}function Vn(e){try{return JSON.parse(e)}catch{return e}}const Re={"device.id":"<device>","device.location.latitude":"--device-location latitude","device.location.longitude":"--device-location longitude"};function Wn(e,{endpointFromEnv:t=!1}={}){const n=t?{...Re,endpoint:"APPETIZE_ENDPOINT"}:Re;try{at(e)}catch(o){throw o instanceof ct?new a(o.issues.map(i=>Xn(i,n)).join(`
-`)):o}}function Xn({code:e,message:t,path:n},o){const i=Hn(n,o);switch(e){case"invalidValue":return`${i} ${t.replace(/^expected /,"expects ")}`;case"needsLaunchApp":return`${i} has no effect without --target, or with --no-launch-app`;case"needsTarget":return`${i} has no effect without --target`}}function Hn(e,t){return t[e]??`--${e.split(".").filter(n=>!/^\d+$/.test(n)).map(n=>n.replaceAll(/([A-Z])/g,"-$1").toLowerCase()).join("-")}`}const Jn=[...jn,...Bn,"proxy","target"],Yn=150,Qn={downloadingApp:"Downloading the app",installingApp:"Installing the app",launchingApp:"Launching the app",queued:"Queued",ready:"Device ready",requesting:"Requesting a device",starting:"Starting the device"},eo=[{header:"Session ID",key:"sessionId"},{header:"Web view",key:"viewerUrl"},{format:e=>`adb connect ${e}`,header:"adb",key:"adbSerial"},{header:"Host",key:"baseUrl"},{fields:[{header:"Device",key:"device"},{header:"Daemon",key:"daemon"},{header:"Network",key:"network"}],header:"Logs",key:"logs"},{hidden:!0,key:"controlSocket"}];async function to(e,{onPhase:t,signal:n}){let o;for(;;){const i=le(e),s=i?.state?.phase;if(s&&s!==o&&(o=s,t?.(s)),i&&s==="ready"&&i.controlSocket!==void 0)return{...i,controlSocket:i.controlSocket};if(s==="error")throw new Error(i?.endedReason??"The session failed to start");if(s==="ended")throw new Error(i?.endedReason??"The session ended");await z(Yn,n)}}function no(e){if(!(e===void 0||e===!1)){if(e===""||e==="intercept")return"intercept";if(typeof e!="string"||!io(e))throw new a("--proxy expects 'intercept' or an http:// url, e.g., http://proxy:8080");return e}}async function oo({options:e,positionals:t,progress:n,signal:o}){const[i]=t,s=u(e.target,"--target")??ro(e);if(s===void 0&&!process.env.APPETIZE_API_TOKEN)throw new a("APPETIZE_API_TOKEN must be set without a target",["Set APPETIZE_API_TOKEN, or pass --target"]);const r=u(e["session-id"],"--session-id"),p=e.force===!0;if(p&&r===void 0)throw new a("--force needs --session-id");const c=r===void 0?_n():Rn(r),l={device:Fn(e,i),endpoint:pt(e),featureFlags:de(),launch:qn(e),proxy:no(e.proxy),sessionId:c,target:s};Wn(l,{endpointFromEnv:e.endpoint===void 0});const f=le(c);if(f!==void 0){if(!p)throw new dt(c);n.status(`Replacing session ${c}`),await _e(f,o),lt(c)}Ln(l),n.step(`Session ${c}`);const v=ut(c,l.proxy);if(e.wait===!1)return{logs:v,sessionId:c};const A=await to(c,{onPhase:P=>{so(P)&&n.status(Qn[P]??"Starting the session")},signal:o}).catch(P=>{throw U.wrap(P,c)});return{adbSerial:A.adbSerial,baseUrl:A.baseUrl,controlSocket:A.controlSocket,logs:v,sessionId:c,viewerUrl:A.viewerUrl}}function io(e){return e.startsWith("http://")}function so(e){return e!=="ended"&&e!=="error"}function ro(e){const t=e._;return Array.isArray(t)&&typeof t[0]=="string"?t[0]:void 0}const ao=async({options:e,progress:t,record:n,signal:o})=>(e.wait===!1?Ne(n):(t.status(`Stopping session ${n.sessionId}`),await _e(n,o)),{sessionId:n.sessionId}),co=async({device:e})=>{await e.shake()},ze="appetize",po=we(new URL(`./skills/${ze}/`,import.meta.url)),Y=["agents","claude","codex","copilot","cursor"],Ue=["project","user"],lo={agents:".agents",claude:".claude",codex:".codex",copilot:".copilot",cursor:".cursor"},uo=x(".agents","skills"),fo=["claude","agents"];function mo(e){return Y.some(t=>t===e)}function ho(e){return Ue.some(t=>t===e)}async function go(e){const t=e.agents??await wo(e),n=await Promise.all(t.map(o=>je(o,e)));return[...new Set(n.flat())]}async function je(e,t){const n=Fe(e,t);if(e==="claude")return[x(n,"skills")];const o=x(t.root,uo);return t.scope==="project"?[o]:await Ce(n)?[o,x(n,"skills")]:[o]}function Fe(e,t){if(e==="claude"&&t.scope==="user"){const n=process.env.CLAUDE_CONFIG_DIR?.trim();if(n)return he(n)}return x(t.root,lo[e])}async function wo(e){const n=(await Promise.all(Y.map(async o=>await yo(o,e)?o:void 0))).filter(o=>o!==void 0);return n.length>0?n:fo}async function yo(e,t){const n=[Fe(e,t),...await je(e,t)];return(await Promise.all(n.map(i=>Ce(i)))).includes(!0)}async function Ce(e){try{return(await Pt(e)).isDirectory()}catch{return!1}}const vo=["agent","scope"];async function xo({options:e,signal:t}){const n=Eo(e.scope),o=bo(e.agent),i=n==="user"?Lt():process.cwd(),s=await go({agents:o,root:i,scope:n}),r=[];for(const p of s){t.throwIfAborted();const c=x(p,ze);await kt(c,{force:!0,recursive:!0}),await It(po,c,{recursive:!0}),r.push(n==="user"?c:At(i,c))}return{installed:r}}function So(e){const t=k(e,"--agent");if(!mo(t))throw new a(`--agent expects one of ${Y.join(", ")}`);return t}function bo(e){return e===void 0?void 0:(Array.isArray(e)?e:[e]).map(n=>So(n))}function Eo(e){if(e===void 0)return"project";const t=k(e,"--scope");if(!ho(t))throw new a(`--scope expects one of ${Ue.join(", ")}`);return t}const w="from",y="to",Oo=[...H({prefix:w}),...H({prefix:y})],Ao=async({device:e,options:t})=>{await e.swipe(To(t),Lo(t))};function Po(e){return B.some(t=>t===e)}function ko(e){if(e===void 0)return;const t=k(e,"--direction");if(!Po(t))throw new a(`--direction expects one of ${B.join(", ")}`);return t}function Io(e,t){const n=ft(e.distance,"--distance");if(L(e,{prefix:y})!==void 0)throw new a(`--direction may not be combined with --${y}-*`);return{direction:t,distance:n,from:L(e,{prefix:w})}}function To(e){const t=ko(e.direction);return t===void 0?$o(e):Io(e,t)}function $o(e){if(e.distance!==void 0)throw new a("--distance is only valid with --direction");return{from:Me(L(e,{prefix:w}),w),to:Me(L(e,{prefix:y}),y)}}function Lo(e){const t=h(e.duration,"--duration"),n=h(e.timeout,"--timeout");return t===void 0&&n===void 0?void 0:{duration:t,timeout:n}}function Me(e,t){if(e===void 0)throw new a(`A swipe needs --direction, or both endpoints: pass one of ${O({prefix:t})}`);return e}const Do=H(),No=async({device:e,options:t})=>{const n=Pe(t);await e.tap(n,Ae(t))},_o=async({device:e,options:t,positionals:[n]})=>{await e.type(n,Ro(t))};function Ro(e){const t=h(e.delay,"--delay");return t===void 0?void 0:{delay:t}}const Q=Dt("appetize:cli"),zo={fail:()=>{},status:()=>{},step:()=>{},succeed:()=>{}};function Uo(e,t,n){return e==="interactive"?jo(t,n):zo}function jo(e,t){const n=Nt({handleSignals:!1,stream:e});let o=0;const i=()=>{n.stop()};t.addEventListener("abort",i,{once:!0});const s=()=>(process.off("exit",i),n.isSpinning);return{fail:()=>{s()&&n.stop()},status:r=>{if(!t.aborted){if(n.isSpinning){n.text=r;return}o=Date.now(),process.once("exit",i),n.start(r)}},step:r=>{e.write(`\u25B8 ${r}
-`)},succeed:()=>{if(!s())return;const r=Math.round((Date.now()-o)/1e3);n.success(`${n.text} (${String(r)}s)`)}}}const Fo=new Set(["adb","api","apk","id","os","url"]),Co={bottom:"","bottom-left":"","bottom-mid":"","bottom-right":"",left:"","left-mid":"",mid:"","mid-mid":"",middle:" ",right:"","right-mid":"",top:"","top-left":"","top-mid":"","top-right":""},Be=2,Mo=10;function Bo(e){return e.split(/(?=[A-Z])/).map((t,n)=>{const o=t.toLowerCase();return Fo.has(o)?o.toUpperCase():n===0?o.charAt(0).toUpperCase()+o.slice(1):o}).join(" ")}function qo(e,t,n){return te(e)?We(e,t,n):N(e,{fields:t,key:""},n)}function Go(e,t){const n=[];for(let o=0;o<e.length;o+=t)n.push(e.slice(o,o+t));return n.length===0?[e]:n}function qe(e){return new _t({chars:Co,head:e,style:{border:[],head:[],"padding-left":0,"padding-right":Be}})}function Ge(e,t){return e.find(n=>n.key===t)}function Ke(e,t){return t?.header??Bo(e)}function ee(e){return e!=null}function te(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function Ze(e){return["boolean","number","string"].includes(typeof e)}function Ve(e,t){const n=new Set(t),o=e.map(s=>s.key).filter(s=>n.has(s)),i=new Set(e.filter(s=>s.hidden).map(s=>s.key));return[...new Set([...o,...t])].filter(s=>!i.has(s))}function We(e,t,n){const o=new Map(Object.entries(e)),i=Ve(t,[...o.keys()]).filter(f=>ee(o.get(f))),s=i.map(f=>Ge(t,f)),r=i.map((f,v)=>Ke(f,s[v])),p=Math.max(0,...r.map(f=>f.length))+Be,c=n===void 0?void 0:n-p-1,l=qe();return l.push(...i.map((f,v)=>[r[v],N(o.get(f),s[v],c)])),Xe(l.toString())}function Ko(e,t){const n=e.map(r=>new Map(Object.entries(r))),o=Ve(t,n.flatMap(r=>[...r.keys()])),i=o.map(r=>Ge(t,r)),s=qe(o.map((r,p)=>Ke(r,i[p])));for(const r of n)s.push(o.map((p,c)=>{const l=r.get(p);return ee(l)?N(l,i[c]):""}));return Xe(s.toString())}function N(e,t,n){if(t?.format)return _(t.format(e),n);if(Ze(e))return _(ue(e),n);if(Array.isArray(e)){const o=e.filter(ee);return o.every(Ze)?_(ue(o),n):o.every(te)?Ko(o,t?.fields??[]):o.map(i=>N(i,t,n)).join(`
-`)}return te(e)?We(e,t?.fields??[],n):_(String(e),n)}function Xe(e){return e.split(`
+import et from"sade";import{p as U,a as f,b as h,f as j,U as a,d as F,c as tt,i as nt,e as ot,g as it,r as pe,h as I,j as $,k as st,D as rt,s as at,l as ct,m as le,n as de,S as C,o as M,q as B,t as x,u as T,v as L,w as ue,x as pt,y as lt,z as fe,A as dt,B as me,C as ut,E as ft,F as mt,G as ht,H as he,I as ge,J as gt,K as wt,L as yt,M as vt,N as xt,O as bt}from"./stream-X6gIBNIh.js";import{existsSync as we,openAsBlob as St,openSync as Et,closeSync as Ot}from"node:fs";import{basename as q,extname as At,resolve as ye,dirname as Pt,join as b,relative as kt}from"node:path";import{writeFile as ve,stat as It,rm as $t,cp as Tt}from"node:fs/promises";import{spawn as Lt}from"node:child_process";import{fileURLToPath as xe}from"node:url";import{humanId as Dt}from"human-id";import{homedir as Nt}from"node:os";import _t from"debug";import zt from"yocto-spinner";import Rt from"cli-table3";import"json-rpc-2.0";import"zod/mini";import"stream";import"module";import"node:net";const G=["closed","fullyOpen","partiallyOpen"],be=["back","menu","unlock","volumeDown","volumeUp"],Se=["home","lock"],Ee=[...Se,...be],K=["down","left","right","up"],Ut=async({device:e,options:t})=>{await e.authenticateBiometry({match:t.match!==!1})},jt=async({device:e,options:t})=>{const n=U(t.unenroll)??!1;await e.settings.setBiometryEnrolled(!n)},Oe=[{header:"Target",key:"id"},{header:"App",key:"appId"},{header:"Platform",key:"platform"},{header:"Version",key:"versionName"},{header:"Build",key:"buildNumber"},{header:"Uploaded",key:"created"}];function Z({appId:e,buildNumber:t,created:n,id:o,platform:i,versionName:s}){return{appId:e,buildNumber:t,created:n,id:o,platform:i,versionName:s}}const Ft=["app"],Ct=10,Mt=[{fields:Oe,key:"builds"},{header:"Total",key:"total"},{header:"Next page",key:"nextPage"}];async function Bt({options:e,signal:t}){const n=f(e.app,"--app"),o=h(e.limit,"--limit")??Ct,i=h(e.page,"--page"),s={limit:String(o)};n!==void 0&&(s.appId=n),i!==void 0&&(s.page=String(i));const r=await j("/api/v2/builds",{commandOptions:e,query:s,signal:t});return{builds:r.builds.map(Z),nextPage:r.nextPage,total:r.total}}const qt=["note","tags"],Ae=12e4,Gt=2e3,V=[".apk",".apks",".zip",".tar.gz",".tgz"],Kt={".apk":"android",".apks":"android",".tar.gz":"ios",".tgz":"ios",".zip":"ios"},Zt=Oe;async function Vt({options:e,positionals:[t],progress:n,signal:o}){const i=Xt(t),s=q(t);n.status(`Uploading ${s}`);const r=await Jt(t,i,e,o);if(e.wait!==!0)return n.status(`Uploaded ${s}`),Z(r);n.step(`Uploaded ${s}`),n.status("Waiting for build metadata");const p=await Wt(r.id,e,o);return n.status(`Processed ${s}`),Z(p)}async function Wt(e,t,n){const o=h(t.timeout,"--timeout")??Ae,i=Date.now()+o;for(;;){const s=await j(`/api/v2/builds/${e}`,{commandOptions:t,signal:n});if(s.appId!==void 0)return s;if(Date.now()>=i)throw new Error(`Build ${e} is still being processed after ${String(o)}ms; find it with 'appetize build list'`);await F(Gt,n)}}async function Ht(e){if(!we(e))throw new Error(`No build file at ${e}`);return await St(e)}function Xt(e){const t=e.toLowerCase(),n=V.find(o=>t.endsWith(o));if(n===void 0)throw new a(`Cannot tell the platform of ${q(e)}; upload a ${V.join(", ")} file`);return Kt[n]}async function Jt(e,t,n,o){const i=new FormData;i.set("platform",t);const s=f(n.note,"--note");s!==void 0&&i.set("note",s);const r=f(n.tags,"--tags");return r!==void 0&&i.set("tags",r),i.set("file",await Ht(e),q(e)),await j("/api/v2/builds",{body:i,commandOptions:n,method:"POST",signal:o})}const Yt=["platform"],Qt=[{fields:[{header:"ID",key:"id"},{header:"Name",key:"name"},{header:"Platform",key:"platform"},{header:"OS versions",key:"osVersions"}],key:"devices"}];async function en({options:e,signal:t}){const n=tn(e.platform);return{devices:(await tt(e,t)).filter(i=>n===void 0||i.platform===n).map(nn)}}function tn(e){const t=f(e,"--platform");if(t!==void 0){if(!nt(t))throw new a(`--platform expects one of: ${ot.join(", ")}`);return t}}function nn({id:e,name:t,osVersions:n,platform:o}){return{id:e,name:t,osVersions:n,platform:o}}const on="cli-fold",sn=async({device:e,positionals:[t]})=>{if(!rn(t))throw new a(`Hinge must be one of: ${G.join(", ")}`);await e.fold(t)};function rn(e){return G.some(t=>t===e)}const an=async({device:e,options:t,positionals:[n]})=>{await e.gesture(pn(n),cn(t))};function cn(e){const t=h(e.timeout,"--timeout");return t===void 0?void 0:{timeout:t}}function pn(e){let t;try{t=it(e)}catch(n){throw n instanceof SyntaxError?new a(n.message):n}if(t.length===0)throw new a("Expected at least one gesture step");return t}const ln="APPETIZE_OUTPUT";function dn(e,t,n){return{format:un(e,t),progress:fn(e,n)}}function W(e,{extension:t,strict:n=!1}){const o=At(e);if(o==="")return`${e}${t}`;if(n&&o!==t)throw new a(`The output must be a path ending in ${t}`);return e}function un(e,t){if(e.json===!0)return"json";if(e.json===!1)return"text";const n=process.env[ln]?.trim();return n==="json"||n==="text"?n:t.isTTY===!0?"text":"json"}function fn(e,t){return e.quiet===!0?"silent":t.isTTY===!0&&process.env.TERM!=="dumb"&&!("CI"in process.env)?"interactive":"silent"}const S=["text","testId"],g="select",O={testId:{help:"Test id to match by exact string",suffix:"test-id"},text:{help:'Text to match by exact string or regex (e.g., "Sign in" or "/sign in/i")',suffix:"text"}},mn=`  Element selectors
+    Commands that act on UI elements (e.g., inspect) can take one or more
+    element selectors, as flags ending in one of:
+
+    -text        Exact string or /regex/flags, matched against
+                   Android: text, content-desc, hintText
+                   iOS: title (or value when empty), label, placeholderValue
+    -test-id     Exact id
+                   Android: resource-id, whole or after its last /
+                   iOS: accessibilityIdentifier
+    -index       Which match when multiple (0-based)
+
+  Position selectors
+    Commands that act on a screen position (e.g., tap) take position
+    selectors. Every element selector is a position selector, at the
+    element's center by default.
+
+    -position    Screen position x,y (0-1)
+    -x, -y       Position within the element (0-1, outside allowed)
+
+`,H="index",D="position",X="x",J="y";function Y(e,{prefix:t=g}={}){return S.reduce((n,o)=>{const{help:i,suffix:s}=O[o];return n.option(`--${l(t,s)}`,i)},e).option(`--${l(t,H)}`,"Which match when multiple (0-based)")}function Q(e,t={}){const{prefix:n=g}=t;return Y(e,t).option(`--${l(n,D)}`,"Screen position to use as x,y (0-1), e.g., 0.5,0.75").option(`--${l(n,X)}`,"Horizontal position within the element (0-1, outside allowed)").option(`--${l(n,J)}`,"Vertical position within the element (0-1, outside allowed)")}function Pe(e,{prefix:t=g}={}){const n=oe(e,t);if(n.length===0)throw new a(`A selector is required: pass one of ${_(S,t)}`);if(n.length>1)throw new a(`Only one selector may be given, got ${_(n,t)}`);const[o]=n,i=Le(e,l(t,O[o].suffix)),s=h(e[l(t,H)],`--${l(t,H)}`);switch(o){case"testId":return{by:"testId",index:s,testId:i};case"text":return{by:"text",index:s,text:gn(i)}}}function ee(e){const t=h(e.timeout,"--timeout");return t===void 0?void 0:{timeout:t}}function ke(e,{prefix:t=g}={}){return $e(e,t)?Pe(e,{prefix:t}):void 0}function N(e,{prefix:t=g}={}){return $e(e,t)?Ie(e,{prefix:t}):void 0}function Ie(e,{prefix:t=g}={}){const n=l(t,D),o=e[n],i=Te(e,l(t,X)),s=Te(e,l(t,J));if(o===void 0){if(oe(e,t).length===0)throw new a(`A selector is required: pass one of ${A({prefix:t})}`);return{...Pe(e,{prefix:t}),x:i,y:s}}if(oe(e,t).length>0)throw new a(`--${n} may not be combined with ${_(S,t)}`);if(i!==void 0||s!==void 0)throw new a(`--${n} may not be combined with --${l(t,X)} or --${l(t,J)}`);return hn(Le(e,n),n)}function A(e={}){const{prefix:t=g}=e;return`${_(S,t)}, --${l(t,D)}`}function te(e={}){const{prefix:t=g}=e;return[...ne(e),l(t,D)]}function ne({prefix:e=g}={}){return S.map(t=>l(e,O[t].suffix))}function oe(e,t){return S.filter(n=>e[l(t,O[n].suffix)]!==void 0)}function l(...e){return e.filter(Boolean).join("-")}function _(e,t){return e.map(n=>`--${l(t,O[n].suffix)}`).join(", ")}function $e(e,t){return Object.entries(e).some(([n,o])=>o!==void 0&&n.startsWith(`${t}-`))}function Te(e,t){return h(e[t],`--${t}`)}function hn(e,t){const n=e.split(",");if(n.length!==2)throw new a(`--${t} expects x,y (0-1), e.g., 0.5,0.75`);const[o,i]=n.map(s=>Number(s.trim()));return{by:"position",x:pe(o,`--${t}`),y:pe(i,`--${t}`)}}function gn(e){const t=/^\/(.*)\/([a-z]*)$/s.exec(e);return t?new RegExp(t[1],t[2]):e}function Le(e,t){return I(e[t],`--${t}`)}const wn=ne(),yn=async({device:e,options:t,positionals:[n]})=>{const o=vn(n),i=ke(t),s=await e.inspect(i,ee(t)),r=xn(s,t.pretty===!0);await ve(o,r);const p=Buffer.byteLength(r),c=De(s.roots);return i?{bytes:p,matches:s.roots.length,nodes:c,output:o}:{bytes:p,nodes:c,output:o}};function De(e){return e.reduce((t,n)=>t+1+De(n.children),0)}function vn(e="inspect"){return W(e,{extension:".json"})}function xn(e,t){return`${JSON.stringify(e,null,t?2:void 0)}
+`}const bn=async({device:e})=>{await e.settings.clearKeychain()},Sn=async({device:e,positionals:[t]})=>{await e.open(En(t))};function En(e){if(typeof e=="string")try{return new URL(e),e}catch{throw new a("<url> expects a URL, e.g., myapp://orders/42")}throw new a("<url> expects a URL, e.g., myapp://orders/42")}const On=new Set(Ee),An=async({device:e,positionals:[t]})=>{if(!Pn(t))throw new a(`Button must be one of: ${Ee.join(", ")}`);await e.press(t)};function Pn(e){return typeof e=="string"&&On.has(e)}const kn=async({control:e,options:t,positionals:[n]})=>{const{path:o}=await e.recordStart({force:t.force===!0,path:$n(n)});return{path:o}},In=async({control:e})=>{const{path:t}=await e.recordStop();return{path:t}};function $n(e){const t=ye(W(e,{extension:".mp4",strict:!0})),n=Pt(t);if(!we(n))throw new a(`No such directory: ${n}`);return t}const Tn=async({device:e,positionals:[t]})=>{if(!Ln(t))throw new a(`Orientation must be one of: ${$.join(", ")}`);await e.rotate(t)};function Ln(e){return $.some(t=>t===e)}const Dn=ne(),Nn=async({device:e,options:t,positionals:[n]})=>{const o=await e.screenshot(ke(t),ee(t)),i=zn(o.mimeType,n);return await ve(i,o.data),{bytes:o.data.byteLength,output:i}};function _n(e){const t=e.split("/").at(1);return`.${t==="jpeg"?"jpg":t??"png"}`}function zn(e,t="screenshot"){return W(t,{extension:_n(e)})}function Rn(e){const t=xe(new URL("./daemon.js",import.meta.url)),n=Et(st(e.sessionId),"a"),o=Lt(process.execPath,[t],{detached:!0,env:{...process.env,[rt]:at(e),DEBUG:Un(process.env.DEBUG)},stdio:["ignore",n,n]});if(Ot(n),o.unref(),o.pid===void 0)throw new Error("Failed to spawn the session daemon");return o.pid}function Un(e){return e?`${e},appetize:daemon`:"appetize:daemon"}const jn=/^[a-z0-9](?:[a-z0-9._-]{0,62}[a-z0-9])?$/i;function Fn(){return Dt({capitalize:!1,separator:"-"})}function Cn(e){if(!jn.test(e))throw new a('--session-id must use letters, digits, ".", "-" or "_"');return e}const Ne=1e4;function _e(e){if(!ct(e))return!1;try{process.kill(e.pid,"SIGTERM")}catch{}return!0}async function ze(e,t){(_e(e)||Bn(e))&&await Mn(e,t)}async function Mn({pid:e,sessionId:t},n){const o=de(e);try{await F(Ne,AbortSignal.any([n,o]))}catch(i){if(o.aborted||!le(e))return;throw i}throw new C(`Session ${t} did not stop in time`,{sessionId:t})}function Bn({endedAt:e,pid:t}){return e!==void 0&&Date.now()-Date.parse(e)<Ne&&le(t)}const qn=["device-android-shell","device-appearance","device-font-size","device-ios-keyboards","device-locale","device-location","device-orientation","device-os-version","device-timezone"];function Gn(e,t){const n=M({shell:f(e["device-android-shell"],"--device-android-shell"),softKeyboard:U(e["device-android-soft-keyboard"],{defaultValue:!0})}),o=M({autocorrect:U(e["device-ios-autocorrect"],{defaultValue:!0}),keyboards:B(e["device-ios-keyboards"],"--device-ios-keyboards")});return{android:n,appearance:x(e["device-appearance"],L,"--device-appearance"),fontSize:x(e["device-font-size"],T,"--device-font-size"),id:t,ios:o,locale:f(e["device-locale"],"--device-locale"),location:Re(e["device-location"],"--device-location"),orientation:x(e["device-orientation"],$,"--device-orientation"),osVersion:f(e["device-os-version"],"--device-os-version"),timezone:f(e["device-timezone"],"--device-timezone")}}function Re(e,t){const n=f(e,t);if(n===void 0)return;const o=n.split(",").map(r=>r.trim());if(o.length!==2||!o.every(Kn))throw new a(`${t} expects <lat>,<lng>, e.g., ${t}=-43.65,79.38`);const[i,s]=o.map(Number);if(Math.abs(i)>90||Math.abs(s)>180)throw new a(`${t} expects latitude within \xB190 and longitude within \xB1180`);return{latitude:i,longitude:s}}function Kn(e){return e!==""&&Number.isFinite(Number(e))}const Zn=["launch-app","launch-ios-args","launch-params","launch-permissions","launch-url","open"];function Vn(e){const t=B(e["launch-ios-args"],"--launch-ios-args");return M({app:Wn(e["launch-app"]),ios:t===void 0?void 0:{args:t},params:Hn(e["launch-params"]),permissions:x(e["launch-permissions"],ue,"--launch-permissions"),url:f(e["launch-url"],"--launch-url")??f(e.open,"--open")})}function Wn(e){return e===!1?!1:f(e,"--launch-app")}function Hn(e){const t=B(e,"--launch-params");if(t!==void 0)return Object.fromEntries(t.map(Xn))}function Xn(e){const t=e.indexOf("=");if(t<1)throw new a("--launch-params expects key=value, e.g., --launch-params debug=true");return[e.slice(0,t),Jn(e.slice(t+1))]}function Jn(e){try{return JSON.parse(e)}catch{return e}}const Ue={"device.id":"<device>","device.location.latitude":"--device-location latitude","device.location.longitude":"--device-location longitude"};function Yn(e,{endpointFromEnv:t=!1}={}){const n=t?{...Ue,endpoint:"APPETIZE_ENDPOINT"}:Ue;try{pt(e)}catch(o){throw o instanceof lt?new a(o.issues.map(i=>Qn(i,n)).join(`
+`)):o}}function Qn({code:e,message:t,path:n},o){const i=eo(n,o);switch(e){case"invalidValue":return`${i} ${t.replace(/^expected /,"expects ")}`;case"needsLaunchApp":return`${i} has no effect without --target, or with --no-launch-app`;case"needsTarget":return`${i} has no effect without --target`}}function eo(e,t){return t[e]??`--${e.split(".").filter(n=>!/^\d+$/.test(n)).map(n=>n.replaceAll(/([A-Z])/g,"-$1").toLowerCase()).join("-")}`}const to=[...qn,...Zn,"proxy","target"],no=150,oo={downloadingApp:"Downloading the app",installingApp:"Installing the app",launchingApp:"Launching the app",queued:"Queued",ready:"Device ready",requesting:"Requesting a device",starting:"Starting the device"},io=[{header:"Session ID",key:"sessionId"},{header:"Web view",key:"viewerUrl"},{format:e=>`adb connect ${e}`,header:"adb",key:"adbSerial"},{header:"Host",key:"baseUrl"},{fields:[{header:"Device",key:"device"},{header:"Daemon",key:"daemon"},{header:"Network",key:"network"}],header:"Logs",key:"logs"},{hidden:!0,key:"controlSocket"}];async function so(e,{onPhase:t,signal:n}){let o;for(;;){const i=me(e),s=i?.state?.phase;if(s&&s!==o&&(o=s,t?.(s)),i&&s==="ready"&&i.controlSocket!==void 0)return{...i,controlSocket:i.controlSocket};if(s==="error")throw new Error(i?.endedReason??"The session failed to start");if(s==="ended")throw new Error(i?.endedReason??"The session ended");await F(no,n)}}function ro(e){if(!(e===void 0||e===!1)){if(e===""||e==="intercept")return"intercept";if(typeof e!="string"||!co(e))throw new a("--proxy expects 'intercept' or an http:// url, e.g., http://proxy:8080");return e}}async function ao({options:e,positionals:t,progress:n,signal:o}){const[i]=t,s=f(e.target,"--target")??lo(e);if(s===void 0&&!process.env.APPETIZE_API_TOKEN)throw new a("APPETIZE_API_TOKEN must be set without a target",["Set APPETIZE_API_TOKEN, or pass --target"]);const r=f(e["session-id"],"--session-id"),p=e.force===!0;if(p&&r===void 0)throw new a("--force needs --session-id");const c=r===void 0?Fn():Cn(r),d={device:Gn(e,i),endpoint:dt(e),featureFlags:fe(),launch:Vn(e),proxy:ro(e.proxy),sessionId:c,target:s};Yn(d,{endpointFromEnv:e.endpoint===void 0});const m=me(c);if(m!==void 0){if(!p)throw new ut(c);n.status(`Replacing session ${c}`),await ze(m,o),ft(c)}Rn(d),n.step(`Session ${c}`);const v=mt(c,d.proxy);if(e.wait===!1)return{logs:v,sessionId:c};const P=await so(c,{onPhase:k=>{po(k)&&n.status(oo[k]??"Starting the session")},signal:o}).catch(k=>{throw C.wrap(k,c)});return{adbSerial:P.adbSerial,baseUrl:P.baseUrl,controlSocket:P.controlSocket,logs:v,sessionId:c,viewerUrl:P.viewerUrl}}function co(e){return e.startsWith("http://")}function po(e){return e!=="ended"&&e!=="error"}function lo(e){const t=e._;return Array.isArray(t)&&typeof t[0]=="string"?t[0]:void 0}const uo=async({options:e,progress:t,record:n,signal:o})=>(e.wait===!1?_e(n):(t.status(`Stopping session ${n.sessionId}`),await ze(n,o)),{sessionId:n.sessionId}),fo=["appearance","font-size","location"],mo=async({device:e,options:t})=>{const n=x(t.appearance,L,"--appearance"),o=x(t["font-size"],T,"--font-size"),i=Re(t.location,"--location");if(!n&&!o&&!i)throw new a("Pass at least one of --appearance, --font-size or --location");n&&await e.settings.setAppearance(n),o&&await e.settings.setFontSize(o),i&&await e.settings.setLocation(i)},ho=async({device:e})=>{await e.shake()},je="appetize",go=xe(new URL(`./skills/${je}/`,import.meta.url)),ie=["agents","claude","codex","copilot","cursor"],Fe=["project","user"],wo={agents:".agents",claude:".claude",codex:".codex",copilot:".copilot",cursor:".cursor"},yo=b(".agents","skills"),vo=["claude","agents"];function xo(e){return ie.some(t=>t===e)}function bo(e){return Fe.some(t=>t===e)}async function So(e){const t=e.agents??await Eo(e),n=await Promise.all(t.map(o=>Ce(o,e)));return[...new Set(n.flat())]}async function Ce(e,t){const n=Me(e,t);if(e==="claude")return[b(n,"skills")];const o=b(t.root,yo);return t.scope==="project"?[o]:await Be(n)?[o,b(n,"skills")]:[o]}function Me(e,t){if(e==="claude"&&t.scope==="user"){const n=process.env.CLAUDE_CONFIG_DIR?.trim();if(n)return ye(n)}return b(t.root,wo[e])}async function Eo(e){const n=(await Promise.all(ie.map(async o=>await Oo(o,e)?o:void 0))).filter(o=>o!==void 0);return n.length>0?n:vo}async function Oo(e,t){const n=[Me(e,t),...await Ce(e,t)];return(await Promise.all(n.map(i=>Be(i)))).includes(!0)}async function Be(e){try{return(await It(e)).isDirectory()}catch{return!1}}const Ao=["agent","scope"];async function Po({options:e,signal:t}){const n=$o(e.scope),o=Io(e.agent),i=n==="user"?Nt():process.cwd(),s=await So({agents:o,root:i,scope:n}),r=[];for(const p of s){t.throwIfAborted();const c=b(p,je);await $t(c,{force:!0,recursive:!0}),await Tt(go,c,{recursive:!0}),r.push(n==="user"?c:kt(i,c))}return{installed:r}}function ko(e){const t=I(e,"--agent");if(!xo(t))throw new a(`--agent expects one of ${ie.join(", ")}`);return t}function Io(e){return e===void 0?void 0:(Array.isArray(e)?e:[e]).map(n=>ko(n))}function $o(e){if(e===void 0)return"project";const t=I(e,"--scope");if(!bo(t))throw new a(`--scope expects one of ${Fe.join(", ")}`);return t}const w="from",y="to",To=[...te({prefix:w}),...te({prefix:y})],Lo=async({device:e,options:t})=>{await e.swipe(zo(t),Uo(t))};function Do(e){return K.some(t=>t===e)}function No(e){if(e===void 0)return;const t=I(e,"--direction");if(!Do(t))throw new a(`--direction expects one of ${K.join(", ")}`);return t}function _o(e,t){const n=ht(e.distance,"--distance");if(N(e,{prefix:y})!==void 0)throw new a(`--direction may not be combined with --${y}-*`);return{direction:t,distance:n,from:N(e,{prefix:w})}}function zo(e){const t=No(e.direction);return t===void 0?Ro(e):_o(e,t)}function Ro(e){if(e.distance!==void 0)throw new a("--distance is only valid with --direction");return{from:qe(N(e,{prefix:w}),w),to:qe(N(e,{prefix:y}),y)}}function Uo(e){const t=h(e.duration,"--duration"),n=h(e.timeout,"--timeout");return t===void 0&&n===void 0?void 0:{duration:t,timeout:n}}function qe(e,t){if(e===void 0)throw new a(`A swipe needs --direction, or both endpoints: pass one of ${A({prefix:t})}`);return e}const jo=te(),Fo=async({device:e,options:t})=>{const n=Ie(t);await e.tap(n,ee(t))},Co=async({device:e,options:t,positionals:[n]})=>{await e.type(n,Mo(t))};function Mo(e){const t=h(e.delay,"--delay");return t===void 0?void 0:{delay:t}}const se=_t("appetize:cli"),Bo={fail:()=>{},status:()=>{},step:()=>{},succeed:()=>{}};function qo(e,t,n){return e==="interactive"?Go(t,n):Bo}function Go(e,t){const n=zt({handleSignals:!1,stream:e});let o=0;const i=()=>{n.stop()};t.addEventListener("abort",i,{once:!0});const s=()=>(process.off("exit",i),n.isSpinning);return{fail:()=>{s()&&n.stop()},status:r=>{if(!t.aborted){if(n.isSpinning){n.text=r;return}o=Date.now(),process.once("exit",i),n.start(r)}},step:r=>{e.write(`\u25B8 ${r}
+`)},succeed:()=>{if(!s())return;const r=Math.round((Date.now()-o)/1e3);n.success(`${n.text} (${String(r)}s)`)}}}const Ko=new Set(["adb","api","apk","id","os","url"]),Zo={bottom:"","bottom-left":"","bottom-mid":"","bottom-right":"",left:"","left-mid":"",mid:"","mid-mid":"",middle:" ",right:"","right-mid":"",top:"","top-left":"","top-mid":"","top-right":""},Ge=2,Vo=10;function Wo(e){return e.split(/(?=[A-Z])/).map((t,n)=>{const o=t.toLowerCase();return Ko.has(o)?o.toUpperCase():n===0?o.charAt(0).toUpperCase()+o.slice(1):o}).join(" ")}function Ho(e,t,n){return ae(e)?Xe(e,t,n):z(e,{fields:t,key:""},n)}function Xo(e,t){const n=[];for(let o=0;o<e.length;o+=t)n.push(e.slice(o,o+t));return n.length===0?[e]:n}function Ke(e){return new Rt({chars:Zo,head:e,style:{border:[],head:[],"padding-left":0,"padding-right":Ge}})}function Ze(e,t){return e.find(n=>n.key===t)}function Ve(e,t){return t?.header??Wo(e)}function re(e){return e!=null}function ae(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function We(e){return["boolean","number","string"].includes(typeof e)}function He(e,t){const n=new Set(t),o=e.map(s=>s.key).filter(s=>n.has(s)),i=new Set(e.filter(s=>s.hidden).map(s=>s.key));return[...new Set([...o,...t])].filter(s=>!i.has(s))}function Xe(e,t,n){const o=new Map(Object.entries(e)),i=He(t,[...o.keys()]).filter(m=>re(o.get(m))),s=i.map(m=>Ze(t,m)),r=i.map((m,v)=>Ve(m,s[v])),p=Math.max(0,...r.map(m=>m.length))+Ge,c=n===void 0?void 0:n-p-1,d=Ke();return d.push(...i.map((m,v)=>[r[v],z(o.get(m),s[v],c)])),Je(d.toString())}function Jo(e,t){const n=e.map(r=>new Map(Object.entries(r))),o=He(t,n.flatMap(r=>[...r.keys()])),i=o.map(r=>Ze(t,r)),s=Ke(o.map((r,p)=>Ve(r,i[p])));for(const r of n)s.push(o.map((p,c)=>{const d=r.get(p);return re(d)?z(d,i[c]):""}));return Je(s.toString())}function z(e,t,n){if(t?.format)return R(t.format(e),n);if(We(e))return R(he(e),n);if(Array.isArray(e)){const o=e.filter(re);return o.every(We)?R(he(o),n):o.every(ae)?Jo(o,t?.fields??[]):o.map(i=>z(i,t,n)).join(`
+`)}return ae(e)?Xe(e,t?.fields??[],n):R(String(e),n)}function Je(e){return e.split(`
 `).map(t=>t.trimEnd()).join(`
-`)}function _(e,t){return t===void 0||t<Mo?e:e.split(`
-`).flatMap(n=>Zo(n,t)).join(`
-`)}function Zo(e,t){const n=[];let o="";for(const i of e.split(" ").flatMap(s=>Go(s,t)))o===""?o=i:o.length+1+i.length<=t?o=`${o} ${i}`:(n.push(o),o=i);return n.push(o),n}async function Vo(e,t={}){const n=await fe(e,{signal:t.signal});return new mt(n,{...t,onClose:()=>{n.close(),t.onClose?.()}})}function Wo(e,t){if(e.controlSocket===void 0)throw new Error("Session is not ready");return Vo(e.controlSocket,{baseUrl:e.baseUrl,signal:t})}async function Xo(e,t){if(e.controlSocket===void 0)throw new Error("Session is not ready");const n=await fe(e.controlSocket,{signal:t}),{client:o}=ht(n,{});return{close:()=>{n.close()},recordStart:async i=>await o.request("appetizeio.cli.record.start",i),recordStop:async()=>await o.request("appetizeio.cli.record.stop")}}function Ho(e){return async({options:t,positionals:n,progress:o,signal:i})=>{const s=t["session-id"],r=gt(typeof s=="string"?s:void 0);try{return await e({options:t,positionals:n,progress:o,record:r,signal:AbortSignal.any([i,se(r.pid)])})}catch(p){throw U.wrap(p,r.sessionId)}}}function Jo(e){return async({options:t,positionals:n,progress:o,record:i,signal:s})=>{const r=await Wo(i,s);try{return await e({device:r,options:t,positionals:n,progress:o,signal:s})}finally{r.close()}}}function Yo(e){return async({options:t,positionals:n,progress:o,record:i,signal:s})=>{const r=await Xo(i,s);try{return await e({control:r,options:t,positionals:n,progress:o,signal:s})}finally{r.close()}}}const Qo=["session-id",...Rt,...Ft,...Wt,...fn,...vo,...Jn,...Oo,...Do],ei=["json","quiet"];function ti(e){const t=Ye("appetize").version(e).option("--json","Print the result as JSON").option("--quiet","Hide progress");return b(t,"session start <device>",n=>n.describe(["Start a device session and wait until it is ready","","Environment variables:","APPETIZE_API_TOKEN: Authorizes private APIs and targets; required with no target","APPETIZE_ENDPOINT: Appetize URL used when --endpoint is omitted"]).option("--device-android-shell","Android only: adb shell command run at start; needs --target").option("--device-appearance",`Device appearance: ${ce.join(" or ")}`).option("--device-font-size",`Device font size: ${ae.join(", ")}`).option("--device-ios-keyboards","iOS only: keyboard layout (e.g., en_US@sw=QWERTY); repeatable").option("--device-locale","Device locale as a BCP 47 tag (e.g., fr-CA)").option("--device-location","Device location as <lat>,<lng>; use = if latitude is negative").option("--device-orientation",`Initial orientation: ${I.join(", ")}`).option("--device-os-version","Device OS version (e.g., 17 for iOS, 14 for Android)").option("--device-timezone","Device IANA timezone (e.g., America/Toronto)").option("--endpoint","Appetize URL (e.g., https://appetize.io); overrides APPETIZE_ENDPOINT").option("--force","Replace a session with the same id",!1).option("--launch-app","App id to launch instead of the target app; needs --target").option("--launch-ios-args","iOS only: app launch argument, joined with = if it starts with -; repeatable; needs --target").option("--launch-params","App launch parameter as key=value, JSON when valid; repeatable; needs --target").option("--launch-permissions",`Grant app permissions: ${pe.join(", ")}; needs --target`).option("--launch-url","URL opened once the session is ready").option("--no-device-android-soft-keyboard","Android only: hide the on-screen keyboard").option("--no-device-ios-autocorrect","iOS only: keep autocorrect off, its default").option("--no-launch-app","Skip launching the app; needs --target").option("--no-wait","Return without waiting for the device session to be ready").option("--proxy","Route traffic through a proxy: 'intercept' to capture it, or an http url").option("--session-id","Session id; defaults to a generated 3-word id").option("--target","App, build or app group id to run").example("session start iphone15pro --target app_a1b2c3").example("session start iphone15pro").example("session start pixel7 --target app_a1b2c3 --device-os-version 14").example("session start iphone15pro --target app_a1b2c3 --launch-url myapp://orders/42").example("session start iphone15pro --target app_a1b2c3 --launch-params debug=true --launch-params retries=3").example(`session start iphone15pro --target app_a1b2c3 --launch-params 'zip="90210"'`).example(`session start iphone15pro --target app_a1b2c3 --launch-params 'tags=["beta","qa"]'`).example("session start iphone15pro --device-orientation landscapeLeft --device-appearance dark").example("session start pixel7 --device-locale fr-CA --device-timezone America/Toronto").example("session start iphone15pro --target app_a1b2c3 --session-id demo --force"),oo,{fields:eo}),ne(t,"session stop",n=>n.describe("Stop a device session and await its exit").option("--no-wait","Return without waiting for the session to exit").example("session stop --no-wait"),ao),b(t,"build list",n=>n.describe(["List uploaded builds, printing session start targets","","Environment variables:","APPETIZE_API_TOKEN: Authorizes the listing request","APPETIZE_ENDPOINT: Appetize URL used when --endpoint is omitted"]).option("--app","App id to filter by (bundle or package id)").option("--endpoint","Appetize URL (e.g., https://appetize.io); overrides APPETIZE_ENDPOINT").option("--limit","Builds per page (default 10, max 200)").option("--page","Page of results to fetch (default 1)").example("build list").example("build list --app com.example.app").example("build list --app com.example.app --page 2"),jt,{fields:Ut}),b(t,"build upload <file>",n=>n.describe([`Upload a build (${G.join(", ")}) as a session start target`,"","Environment variables:","APPETIZE_API_TOKEN: Authorizes the upload","APPETIZE_ENDPOINT: Appetize URL used when --endpoint is omitted"]).option("--endpoint","Appetize URL (e.g., https://appetize.io); overrides APPETIZE_ENDPOINT").option("--note","Note to store with the build").option("--tags","Comma separated tags to store with the build").option("--timeout",`Milliseconds to wait with --wait (default ${String(be)})`).option("--wait","Wait for the app id and version metadata to resolve").example("build upload ./app.apk").example("build upload ./app.zip").example("build upload ./app.apk --wait").example('build upload ./app.apk --tags beta,latest --note "PR 42"'),qt,{fields:Bt}),b(t,"device list",n=>n.describe(["List device models and their supported OS versions","","Environment variables:","APPETIZE_ENDPOINT: Appetize URL used when --endpoint is omitted"]).option("--endpoint","Appetize URL (e.g., https://appetize.io); overrides APPETIZE_ENDPOINT").option("--platform","Platform to filter by: ios or android").example("device list").example("device list --platform ios"),Ht,{fields:Xt}),m(t,"press <button>",n=>n.describe(`Press a device button: ${ve.join(", ")}; Android only: ${ye.join(", ")}`).example("press home").example("press volumeUp"),Sn),m(t,"rotate <orientation>",n=>n.describe("Rotate the device to an orientation: portrait, landscapeLeft, landscapeRight or upsideDown").example("rotate portrait").example("rotate landscapeLeft"),Pn),Qt in de()&&m(t,"fold <hinge>",n=>n.describe(`Fold a foldable device: ${M.join(", ")}`).example("fold closed").example("fold fullyOpen"),en),m(t,"open <url>",n=>n.describe("Open a URL or deep link on the device").example("open myapp://orders/42").example("open https://example.com"),yn),m(t,"keychain clear",n=>n.describe("Clear the entire device keychain (iOS only)").example("keychain clear"),wn),m(t,"shake",n=>n.describe("Shake the device").example("shake"),co),m(t,"screenshot [output]",n=>n.describe("Take a screenshot of the current device screen").example("screenshot").example("screenshot home-screen").example("screenshot ./shots/checkout.png"),In),m(t,"tap",n=>X(n.describe(["Tap an element matched by a selector, or a screen position","",`Pick one of: ${O()}`])).option("--timeout","Milliseconds to wait for the element").example("tap --select-text 'Log in'").example("tap --select-test-id save").example("tap --select-text '/^Item \\d+/i' --select-index 2").example("tap --select-position 0.5,0.75").example("tap --select-test-id slider --select-x 0.9").example("tap --select-test-id dialog --select-x=-0.1").example("tap --select-test-id row --select-y=1.2"),No),m(t,"swipe",n=>X(X(n.describe(["Swipe in a direction, or along a path between two points","",`Pick a --direction with an optional --${w} starting point,`,`or both a --${w}-* and a --${y}-* point to form a path`,"",`Pick one per point: ${O({prefix:w})}`,`                    ${O({prefix:y})}`]).option("--direction",`Direction to travel: ${B.join(", ")}`).option("--distance","Travel as a fraction of the screen (0-1)"),{prefix:w}),{prefix:y}).option("--duration","Milliseconds the gesture travels for").option("--timeout",`Milliseconds to wait for any --${w}/--${y} elements`).example("swipe --direction up").example("swipe --direction up --distance 0.25").example("swipe --direction left --from-test-id card --from-index 1").example("swipe --from-position 0.5,0.75 --to-position 0.5,0.3").example("swipe --from-text 'Drag me' --from-y 0.9 --to-test-id drop-zone"),Ao),m(t,"gesture <syntax>",n=>n.describe(["Play a single-pointer gesture","","  >                    press the pointer down","  /                    lift it","  {wait}               pause 400 ms","  {wait=ms}            pause ms","  {...}                move the pointer:","    byText=Photo         to the element with exactly that text","    byText=/photo/i      to the element matching the regex",'    byText="My photos"   quote values with spaces',"    byTestId=card        to the element with that test id","    index=1              to the second match, from 0","    x=0 y=0              to a point in it; 0-1 spans it","    0.5,0.6              to a screen position, each 0-1","    x=0.5 y=0.6          the same screen position","    duration=ms          glide time while down; default 400","","Single-quote the gesture. A pointer still down at the end lifts.","Double taps need {wait=100} between taps; Android drops faster ones."]).option("--timeout","Milliseconds to wait for any elements").example("gesture '{byText=Photo}>/'  # tap").example("gesture '{byText=Photo}>{wait=800}/'  # long-press").example("gesture '{0.5,0.5}>/{wait=100}>/'  # double tap").example("gesture '{byTestId=card}>{byTestId=drop-zone duration=600}/'  # drag").example(`gesture '{byText="My photos" x=0 y=0}>{wait}/'  # top-left corner`).example("gesture '{byText=/photo/i index=1}>{wait=800}/'  # 2nd match").example("gesture '{byTestId=slider x=0}>{byTestId=slider x=1 duration=1000}/'  # slide").example("gesture '{0.5,0.8}>{0.5,0.6}{0.8,0.6}{0.8,0.2}/'  # path").example("gesture '{0.2,0.4}>{0.5,0.6 duration=300}/{0.2,0.7}>{0.8,0.7}/'  # 2 strokes").example("gesture '{byTestId=card}>{wait=800}/' --timeout 5000  # wait for card"),nn),m(t,"inspect [output]",n=>Ee(n.describe("Capture the view hierarchy of the screen, or of every element a selector matches")).option("--timeout","Milliseconds to wait for a match").option("--pretty","Pretty-print the JSON",!1).example("inspect").example("inspect --select-text 'Log in'").example("inspect hierarchy.json --pretty"),mn),m(t,"type <text>",n=>n.describe(`Type text; {...} presses a named key: ${vt.join(", ")}`).option("--delay","Milliseconds to wait between steps").example("type 'hello{Enter}'").example("type '{Backspace>16/}'").example("type 'user@example.com{Tab}hunter2{Enter}' --delay 50"),_o),He(t,"recording start <output>",n=>n.describe("Start recording the device video to an mp4 file").option("--force","Overwrite the file if it already exists",!1).example("recording start login-flow").example("recording start ./captures/checkout.mp4").example("recording start login-flow --force"),En),He(t,"recording stop",n=>n.describe("Stop recording the device video and close the file").example("recording stop"),On),b(t,"skill install",n=>n.describe("Install the Appetize agent skill for coding agents").option("--agent","Agent to install for, repeatable; defaults to the agents detected").option("--scope","Install for the project (default) or the user").example("skill install").example("skill install --scope user").example("skill install --agent claude --agent cursor"),xo),t}function b(e,t,n,o,{fields:i}={}){const s=t.split(" ").filter(r=>!/^[<[]/.test(r)).join(" ");return n(e.command(t)).action(ii({action:o,fields:i,name:s}))}function ne(e,t,n,o){return b(e,t,i=>n(i).option("--session-id","Target session id; defaults to the sole active session"),Ho(o))}function m(e,t,n,o){return ne(e,t,n,Jo(o))}function He(e,t,n,o){return ne(e,t,n,Yo(o))}function Je(e){return`${String(Date.now()-e)}ms`}function ni(e,t,n){if(e==="json")return JSON.stringify(t===void 0?{}:t,null,2);const o=t===void 0?"":qo(t,n,process.stdout.columns);return o===""?void 0:o}async function oi({action:e,fields:t=[],name:n},o){const i=Date.now();Q(`invoked: ${process.argv.slice(2).join(" ")}`);const s=wt(o),{format:r,progress:p}=an(s.options,process.stdout,process.stderr),c=Uo(p,process.stderr,s.signal);try{const l=ni(r,await e({...s,progress:c}),t);c.succeed(),l!==void 0&&process.stdout.write(`${l}
-`),Q(`ok in ${Je(i)}`)}catch(l){c.fail(),process.stderr.write(`${yt(r,l,{command:n})}
-`),Q(`failed after ${Je(i)}:`,l),process.exitCode=1}}function ii(e){return(...t)=>{oi(e,t)}}ti("0.26.0").parse(process.argv,{boolean:ei,string:Qo});
+`)}function R(e,t){return t===void 0||t<Vo?e:e.split(`
+`).flatMap(n=>Yo(n,t)).join(`
+`)}function Yo(e,t){const n=[];let o="";for(const i of e.split(" ").flatMap(s=>Xo(s,t)))o===""?o=i:o.length+1+i.length<=t?o=`${o} ${i}`:(n.push(o),o=i);return n.push(o),n}async function Qo(e,t={}){const n=await ge(e,{signal:t.signal});return new gt(n,{...t,onClose:()=>{n.close(),t.onClose?.()}})}function ei(e,t){if(e.controlSocket===void 0)throw new Error("Session is not ready");return Qo(e.controlSocket,{baseUrl:e.baseUrl,signal:t})}async function ti(e,t){if(e.controlSocket===void 0)throw new Error("Session is not ready");const n=await ge(e.controlSocket,{signal:t}),{client:o}=wt(n,{});return{close:()=>{n.close()},recordStart:async i=>await o.request("appetizeio.cli.record.start",i),recordStop:async()=>await o.request("appetizeio.cli.record.stop")}}function ni(e){return async({options:t,positionals:n,progress:o,signal:i})=>{const s=t["session-id"],r=yt(typeof s=="string"?s:void 0);try{return await e({options:t,positionals:n,progress:o,record:r,signal:AbortSignal.any([i,de(r.pid)])})}catch(p){throw C.wrap(p,r.sessionId)}}}function oi(e){return async({options:t,positionals:n,progress:o,record:i,signal:s})=>{const r=await ei(i,s);try{return await e({device:r,options:t,positionals:n,progress:o,signal:s})}finally{r.close()}}}function ii(e){return async({options:t,positionals:n,progress:o,record:i,signal:s})=>{const r=await ti(i,s);try{return await e({control:r,options:t,positionals:n,progress:o,signal:s})}finally{r.close()}}}const si=["session-id",...Ft,...qt,...Yt,...wn,...Dn,...Ao,...to,...fo,...To,...jo],ri=["json","quiet"];function ai(e){const t=et("appetize").version(e).option("--json","Print the result as JSON").option("--quiet","Hide progress");return E(t,"session start <device>",n=>n.describe(["Start a device session and wait until it is ready","","Environment variables:","APPETIZE_API_TOKEN: Authorizes private APIs and targets; required with no target","APPETIZE_ENDPOINT: Appetize URL used when --endpoint is omitted"]).option("--device-android-shell","Android only: adb shell command run at start; needs --target").option("--device-appearance",`Device appearance: ${L.join(" or ")}`).option("--device-font-size",`Device font size: ${T.join(", ")}`).option("--device-ios-keyboards","iOS only: keyboard layout (e.g., en_US@sw=QWERTY); repeatable").option("--device-locale","Device locale as a BCP 47 tag (e.g., fr-CA)").option("--device-location","Device location as <lat>,<lng>; use = if latitude is negative").option("--device-orientation",`Initial orientation: ${$.join(", ")}`).option("--device-os-version","Device OS version (e.g., 17 for iOS, 14 for Android)").option("--device-timezone","Device IANA timezone (e.g., America/Toronto)").option("--endpoint","Appetize URL (e.g., https://appetize.io); overrides APPETIZE_ENDPOINT").option("--force","Replace a session with the same id",!1).option("--launch-app","App id to launch instead of the target app; needs --target").option("--launch-ios-args","iOS only: app launch argument, joined with = if it starts with -; repeatable; needs --target").option("--launch-params","App launch parameter as key=value, JSON when valid; repeatable; needs --target").option("--launch-permissions",`Grant app permissions: ${ue.join(", ")}; needs --target`).option("--launch-url","URL opened once the session is ready").option("--no-device-android-soft-keyboard","Android only: hide the on-screen keyboard").option("--no-device-ios-autocorrect","iOS only: keep autocorrect off, its default").option("--no-launch-app","Skip launching the app; needs --target").option("--no-wait","Return without waiting for the device session to be ready").option("--proxy","Route traffic through a proxy: 'intercept' to capture it, or an http url").option("--session-id","Session id; defaults to a generated 3-word id").option("--target","App, build or app group id to run").example("session start iphone15pro --target app_a1b2c3").example("session start iphone15pro").example("session start pixel7 --target app_a1b2c3 --device-os-version 14").example("session start iphone15pro --target app_a1b2c3 --launch-url myapp://orders/42").example("session start iphone15pro --target app_a1b2c3 --launch-params debug=true --launch-params retries=3").example(`session start iphone15pro --target app_a1b2c3 --launch-params 'zip="90210"'`).example(`session start iphone15pro --target app_a1b2c3 --launch-params 'tags=["beta","qa"]'`).example("session start iphone15pro --device-orientation landscapeLeft --device-appearance dark").example("session start pixel7 --device-locale fr-CA --device-timezone America/Toronto").example("session start iphone15pro --target app_a1b2c3 --session-id demo --force"),ao,{fields:io}),ce(t,"session stop",n=>n.describe("Stop a device session and await its exit").option("--no-wait","Return without waiting for the session to exit").example("session stop --no-wait"),uo),u(t,"biometry authenticate",n=>n.describe("Answer the app's biometric prompt").option("--no-match","Answer with a non-match").example("biometry authenticate").example("biometry authenticate --no-match"),Ut),u(t,"biometry enroll",n=>n.describe("Enroll biometry (iOS only)").option("--unenroll","Unenroll instead",!1).example("biometry enroll").example("biometry enroll --unenroll"),jt),E(t,"build list",n=>n.describe(["List uploaded builds, printing session start targets","","Environment variables:","APPETIZE_API_TOKEN: Authorizes the listing request","APPETIZE_ENDPOINT: Appetize URL used when --endpoint is omitted"]).option("--app","App id to filter by (bundle or package id)").option("--endpoint","Appetize URL (e.g., https://appetize.io); overrides APPETIZE_ENDPOINT").option("--limit","Builds per page (default 10, max 200)").option("--page","Page of results to fetch (default 1)").example("build list").example("build list --app com.example.app").example("build list --app com.example.app --page 2"),Bt,{fields:Mt}),E(t,"build upload <file>",n=>n.describe([`Upload a build (${V.join(", ")}) as a session start target`,"","Environment variables:","APPETIZE_API_TOKEN: Authorizes the upload","APPETIZE_ENDPOINT: Appetize URL used when --endpoint is omitted"]).option("--endpoint","Appetize URL (e.g., https://appetize.io); overrides APPETIZE_ENDPOINT").option("--note","Note to store with the build").option("--tags","Comma separated tags to store with the build").option("--timeout",`Milliseconds to wait with --wait (default ${String(Ae)})`).option("--wait","Wait for the app id and version metadata to resolve").example("build upload ./app.apk").example("build upload ./app.zip").example("build upload ./app.apk --wait").example('build upload ./app.apk --tags beta,latest --note "PR 42"'),Vt,{fields:Zt}),E(t,"device list",n=>n.describe(["List device models and their supported OS versions","","Environment variables:","APPETIZE_ENDPOINT: Appetize URL used when --endpoint is omitted"]).option("--endpoint","Appetize URL (e.g., https://appetize.io); overrides APPETIZE_ENDPOINT").option("--platform","Platform to filter by: ios or android").example("device list").example("device list --platform ios"),en,{fields:Qt}),on in fe()&&u(t,"fold <hinge>",n=>n.describe(`Fold a foldable device: ${G.join(", ")}`).example("fold closed").example("fold fullyOpen"),sn),u(t,"gesture <syntax>",n=>n.describe(["Play a single-pointer gesture","","  >                    press the pointer down","  /                    lift it","  {wait}               pause 400 ms","  {wait=ms}            pause ms","  {...}                move the pointer:","    byText=Photo         to the element with exactly that text","    byText=/photo/i      to the element matching the regex",'    byText="My photos"   quote values with spaces',"    byTestId=card        to the element with that test id","    index=1              to the second match, from 0","    x=0 y=0              to a point in it; 0-1 spans it","    0.5,0.6              to a screen position, each 0-1","    x=0.5 y=0.6          the same screen position","    duration=ms          glide time while down; default 400","","Single-quote the gesture. A pointer still down at the end lifts.","Double taps need {wait=100} between taps; Android drops faster ones."]).option("--timeout","Milliseconds to wait for any elements").example("gesture '{byText=Photo}>/'  # tap").example("gesture '{byText=Photo}>{wait=800}/'  # long-press").example("gesture '{0.5,0.5}>/{wait=100}>/'  # double tap").example("gesture '{byTestId=card}>{byTestId=drop-zone duration=600}/'  # drag").example(`gesture '{byText="My photos" x=0 y=0}>{wait}/'  # top-left corner`).example("gesture '{byText=/photo/i index=1}>{wait=800}/'  # 2nd match").example("gesture '{byTestId=slider x=0}>{byTestId=slider x=1 duration=1000}/'  # slide").example("gesture '{0.5,0.8}>{0.5,0.6}{0.8,0.6}{0.8,0.2}/'  # path").example("gesture '{0.2,0.4}>{0.5,0.6 duration=300}/{0.2,0.7}>{0.8,0.7}/'  # 2 strokes").example("gesture '{byTestId=card}>{wait=800}/' --timeout 5000  # wait for card"),an),u(t,"inspect [output]",n=>Y(n.describe("Capture the view hierarchy of the screen, or of every element a selector matches")).option("--timeout","Milliseconds to wait for a match").option("--pretty","Pretty-print the JSON",!1).example("inspect").example("inspect --select-text 'Log in'").example("inspect hierarchy.json --pretty"),yn),u(t,"keychain clear",n=>n.describe("Clear the entire device keychain (iOS only)").example("keychain clear"),bn),u(t,"open <url>",n=>n.describe("Open a URL or deep link on the device").example("open myapp://orders/42").example("open https://example.com"),Sn),u(t,"press <button>",n=>n.describe(`Press a device button: ${Se.join(", ")}; Android only: ${be.join(", ")}`).example("press home").example("press volumeUp"),An),Ye(t,"recording start <output>",n=>n.describe("Start recording the device video to an mp4 file").option("--force","Overwrite the file if it already exists",!1).example("recording start login-flow").example("recording start ./captures/checkout.mp4").example("recording start login-flow --force"),kn),Ye(t,"recording stop",n=>n.describe("Stop recording the device video and close the file").example("recording stop"),In),u(t,"rotate <orientation>",n=>n.describe("Rotate the device to an orientation: portrait, landscapeLeft, landscapeRight or upsideDown").example("rotate portrait").example("rotate landscapeLeft"),Tn),u(t,"screenshot [output]",n=>Y(n.describe("Take a screenshot of the screen, or of one element")).option("--timeout","Milliseconds to wait for a match").example("screenshot").example("screenshot home-screen").example("screenshot ./shots/checkout.png").example("screenshot card --select-test-id card"),Nn),u(t,"settings set",n=>n.describe("Change device settings; pass at least one flag").option("--appearance",`Device appearance: ${L.join(" or ")}`).option("--font-size",`Device font size: ${T.join(", ")}`).option("--location","Device location as <lat>,<lng>").example("settings set --appearance dark").example("settings set --font-size xl --location 43.65,-79.38").example("settings set --location=-33.87,151.21"),mo),u(t,"shake",n=>n.describe("Shake the device").example("shake"),ho),E(t,"skill install",n=>n.describe("Install the Appetize agent skill for coding agents").option("--agent","Agent to install for, repeatable; defaults to the agents detected").option("--scope","Install for the project (default) or the user").example("skill install").example("skill install --scope user").example("skill install --agent claude --agent cursor"),Po),u(t,"swipe",n=>Q(Q(n.describe(["Swipe in a direction, or along a path between two points","",`Pick a --direction with an optional --${w} starting point,`,`or both a --${w}-* and a --${y}-* point to form a path`,"",`Pick one per point: ${A({prefix:w})}`,`                    ${A({prefix:y})}`]).option("--direction",`Direction to travel: ${K.join(", ")}`).option("--distance","Travel as a fraction of the screen (0-1)"),{prefix:w}),{prefix:y}).option("--duration","Milliseconds the gesture travels for").option("--timeout",`Milliseconds to wait for any --${w}/--${y} elements`).example("swipe --direction up").example("swipe --direction up --distance 0.25").example("swipe --direction left --from-test-id card --from-index 1").example("swipe --from-position 0.5,0.75 --to-position 0.5,0.3").example("swipe --from-text 'Drag me' --from-y 0.9 --to-test-id drop-zone"),Lo),u(t,"tap",n=>Q(n.describe(["Tap an element matched by a selector, or a screen position","",`Pick one of: ${A()}`])).option("--timeout","Milliseconds to wait for the element").example("tap --select-text 'Log in'").example("tap --select-test-id save").example("tap --select-text '/^Item \\d+/i' --select-index 2").example("tap --select-position 0.5,0.75").example("tap --select-test-id slider --select-x 0.9").example("tap --select-test-id dialog --select-x=-0.1").example("tap --select-test-id row --select-y=1.2"),Fo),u(t,"type <text>",n=>n.describe(`Type text; {...} presses a named key: ${bt.join(", ")}`).option("--delay","Milliseconds to wait between steps").example("type 'hello{Enter}'").example("type '{Backspace>16/}'").example("type 'user@example.com{Tab}hunter2{Enter}' --delay 50"),Co),ci(t,mn)}function ci(e,t){const n=e.help.bind(e);return e.help=o=>{n(o),o||process.stdout.write(t)},e}function E(e,t,n,o,{fields:i}={}){const s=t.split(" ").filter(r=>!/^[<[]/.test(r)).join(" ");return n(e.command(t)).action(di({action:o,fields:i,name:s}))}function ce(e,t,n,o){return E(e,t,i=>n(i).option("--session-id","Target session id; defaults to the sole active session"),ni(o))}function u(e,t,n,o){return ce(e,t,n,oi(o))}function Ye(e,t,n,o){return ce(e,t,n,ii(o))}function Qe(e){return`${String(Date.now()-e)}ms`}function pi(e,t,n){if(e==="json")return JSON.stringify(t===void 0?{}:t,null,2);const o=t===void 0?"":Ho(t,n,process.stdout.columns);return o===""?void 0:o}async function li({action:e,fields:t=[],name:n},o){const i=Date.now();se(`invoked: ${process.argv.slice(2).join(" ")}`);const s=vt(o),{format:r,progress:p}=dn(s.options,process.stdout,process.stderr),c=qo(p,process.stderr,s.signal);try{const d=pi(r,await e({...s,progress:c}),t);c.succeed(),d!==void 0&&process.stdout.write(`${d}
+`),se(`ok in ${Qe(i)}`)}catch(d){c.fail(),process.stderr.write(`${xt(r,d,{command:n})}
+`),se(`failed after ${Qe(i)}:`,d),process.exitCode=1}}function di(e){return(...t)=>{li(e,t)}}ai("0.28.0").parse(process.argv,{boolean:ri,string:si});

package/daemon.js

@@ -1,2 +1,2 @@
-import{T as _,P as A,Q as F,R as T,V as z,J as V,W as j,y as v,X as N,x as H,Y as Q,Z as J,_ as $,$ as G,a0 as K,F as Z,a1 as X,a2 as Y,a3 as B,a4 as ee}from"./stream-C_BND5fe.js";import b from"debug";import{createServer as R}from"node:net";import{pipeline as P}from"node:stream";import{rm as te}from"node:fs/promises";import{readFileSync as ne,createWriteStream as oe,existsSync as re,rmSync as se}from"node:fs";import{createServer as ie}from"node:http";import{WebSocketServer as ae}from"ws";import{pipeline as ce}from"node:stream/promises";import{EncodedVideoPacketSource as de,Output as ue,Mp4OutputFormat as le,EncodedPacket as fe,FilePathTarget as pe}from"mediabunny";import"json-rpc-2.0";import"zod/mini";import"node:path";import"node:os";import"stream";import"module";const he=b("appetize.io:transport:ws-ping"),we=3e4;function ge(e){let t=!0;const n=()=>{t=!0};e.on("pong",n);const o=setInterval(()=>{if(!t){clearInterval(o),he("liveness ping went unanswered, terminating"),e.terminate();return}e.readyState===e.OPEN&&(t=!1,e.ping())},we);return{destroy(){clearInterval(o),e.off("pong",n)},pong:n}}const w=b("appetize.io:trace:transport:websocket");class L extends _{constructor(t,{signal:n}={}){super(async r=>{this.#e.send(A(r))},{signal:n}),this.wsOrUrl=t,typeof t=="string"?(this.#e=new WebSocket(t),this.#e.binaryType="arraybuffer"):this.#e=t;const o=this.#e;if(o instanceof WebSocket?(o.addEventListener("open",this.#s),o.addEventListener("message",this.#r),o.addEventListener("error",this.#o),o.addEventListener("close",this.#n),this.#t.push(()=>{o.removeEventListener("open",this.#s),o.removeEventListener("message",this.#r),o.removeEventListener("error",this.#o),o.removeEventListener("close",this.#n)})):(o.addEventListener("open",this.#s),o.addEventListener("message",this.#r),o.addEventListener("error",this.#o),o.addEventListener("close",this.#n),this.#t.push(()=>{o.removeEventListener("open",this.#s),o.removeEventListener("message",this.#r),o.removeEventListener("error",this.#o),o.removeEventListener("close",this.#n)})),this.send=o.send.bind(o),"ping"in o){const{destroy:r,pong:s}=ge(o);this.#c=s,this.#t.push(r)}}wsOrUrl;onclose;onerror;onmessage;onopen;send;get bufferedAmount(){return this.#e.bufferedAmount}get readyState(){return this.#e.readyState}#t=[];#i=!1;#a=!1;#c;#e;close({destroyWs:t=!1,...n}={}){this.closed||(this.#i=t,super.close(n))}handleClose(t){w("close()");for(const n of this.#t.splice(0))n();if((typeof this.wsOrUrl=="string"||this.#i)&&(this.#e.close(t.code,t.reason),"terminate"in this.#e)){const n=this.#e;setTimeout(()=>{n.terminate()},100)}this.#d(),super.handleClose(t)}#d(t){this.#a||(this.#a=!0,this.onclose?.(t))}#n=t=>{w("handleWebSocketClose()",t);try{this.#d(t)}finally{this.close()}};#o=t=>{w("handleWebSocketError()",t),this.onerror?.(t)};#r=async t=>{w("handleWebSocketMessage()",t),this.#c?.();const n=this.#u(t);if(!n){w("handleWebSocketMessage() -> legacy"),this.onmessage?.(t);return}w("handleWebSocketMessage() -> jsonrpc",n),this[F].dispatchMessage(n)};#s=t=>{w("handleWebSocketOpen()",t),this.onopen?.(t)};#u(t){try{const n=T(new Uint8Array(t.data));return z(n)?n:null}catch{return null}}}function S(e){return typeof e=="object"&&e!==null}function I(e){try{const t=T(new Uint8Array(e.data));if(S(t)&&typeof t.name=="string")return{name:t.name,payload:"payload"in t?t.payload:void 0}}catch{}}async function ve(e,t={}){const n=t.baseUrl??(typeof e=="string"?new URL(e).origin:void 0),o=typeof e=="string"?new L(e,{signal:t.signal}):e,r=new V(o,{...t,baseUrl:n});return typeof e=="string"&&await ye(o,r,t),r}function ye(e,t,n){const o=j(n)?.onLegacyMessage;return new Promise((r,s)=>{e.onopen=()=>{r()},e.onclose=()=>{t.close(),n.signal?.aborted?s(n.signal.reason):s(new Error("The websocket was closed before the device connection was established"))},e.onerror=s,e.onmessage=i=>{const c=I(i);c&&o?.(c)}})}const me=b("appetize:client:render-video-to-mp4"),k=30;async function be(e,t){await e.pipeTo(Ee(t))}function Se(e){return{decoderConfig:{codec:"avc1.640028",codedHeight:e.height,codedWidth:e.width}}}function Ee(e){let t;const n=async()=>{await t?.output.finalize()};return new WritableStream({abort:n,close:n,write:async o=>{if(o.data.byteLength!==0)try{t??=await Te(ke(o),e()),Le(t,o),await Ae(t,o)}catch(r){throw await t?.output.cancel(),r}}})}async function Te(e,t){const n=new de("avc"),o=new ue({format:new le({fastStart:"fragmented"}),target:t});return o.addVideoTrack(n,{frameRate:k}),await o.start(),{frame:0,output:o,seen:{height:e.height,width:e.width},size:{height:e.height,width:e.width},source:n}}function Le(e,t){if(t.type!=="key")return;const{seen:n,size:o}=e;t.width===n.width&&t.height===n.height||(e.seen={height:t.height,width:t.width},me(`video resized to ${String(t.width)}x${String(t.height)}; keeping ${String(o.width)}x${String(o.height)}`))}function ke(e){if(e.type!=="key")throw new Error("Video stream started without a key chunk");return e}async function Ae(e,t){const n=new fe(t.data,t.type,e.frame/k,1/k);e.frame+=1,await e.source.add(n,Se(e.size))}async function $e(e,{onStateChange:t,signal:n}){n?.throwIfAborted(),t?.({phase:"starting"}),await new Promise((o,r)=>{const s=()=>{i(),r(n?.reason)},i=()=>{e.onmessage=void 0,e.onclose=void 0,n?.removeEventListener("abort",s)};e.onmessage=c=>{const a=Re(I(c));a&&(t?.(a),a.phase==="ready"&&(i(),o()))},e.onclose=()=>{i(),r(new Error("The device closed before it was ready"))},n?.addEventListener("abort",s,{once:!0})})}function Re(e){if(!e)return;if(e.name==="ready")return{phase:"ready"};if(e.name!=="launchStatus")return;switch(S(e.payload)&&typeof e.payload.status=="string"?e.payload.status:void 0){case"downloadingApp":return{phase:"downloadingApp"};case"installingApp":return{phase:"installingApp"};case"launchingApp":return{phase:"launchingApp"};default:return}}function Pe(){return typeof process>"u"?void 0:process}function Ie(e){return e==="intercept"?"interceptOnDemand":e}function We(e,{onClose:t,onEvent:n,signal:o}={}){return new Promise((r,s)=>{const i=new WebSocket(e);i.binaryType="arraybuffer",i.onopen=()=>{W(i,{capabilities:{},t:"handshake"})},i.onmessage=c=>{Ue(i,c,{onEvent:n,onHandshake:a=>{r({close:()=>{i.close()},id:a})}})},i.onclose=()=>{s(new v("disconnected",`The connection to ${e} closed`)),t?.()},o?.addEventListener("abort",()=>{s(o.reason),i.close()},{once:!0})})}function Ue(e,t,n){const o=T(new Uint8Array(t.data));S(o)&&(o.t==="handshake"&&typeof o.id=="string"?n.onHandshake(o.id):o.name==="ping"?W(e,{name:"pong"}):typeof o.name=="string"&&n.onEvent?.(o.name,o.payload))}function W(e,t){e.send(A(t))}async function Ce(e,t,{apiToken:n,onQueue:o,signal:r}={}){const s=N();s.promise.catch(()=>{}),Oe(s.reject,r);const i=await We(xe(e),{onClose:()=>{s.reject(De())},onEvent:(c,a)=>{Me(c,a,s,o)},signal:r});return qe(e,{apiToken:n,data:t,socketid:i.id},r).catch(s.reject),await s.promise.finally(()=>{i.close()})}function De(){return new v("disconnected","The webserver connection closed before a session was granted")}function U(e,t){return S(e)?e[t]:void 0}function Me(e,t,n,o){if(e==="queue"||e==="concurrentQueue"){const r=e==="queue"?Fe(t):ze(t);r&&o?.(r)}else e==="newSession"?_e(n,t):e==="userError"&&n.reject(new v("denied",Ve(t)))}function C(e,t){const n=U(e,t);return typeof n=="number"?n:void 0}function y(e,t){const n=U(e,t);return typeof n=="string"?n:void 0}async function qe(e,t,n){const o=await fetch(new URL("/api/session/request",e),{body:JSON.stringify(t),headers:{"content-type":"application/json"},method:"POST",signal:n});if(!o.ok)throw new v("denied",await je(o))}function Oe(e,t){t?.addEventListener("abort",()=>{e(t.reason)},{once:!0})}function xe(e){const t=new URL("/client",e);return t.protocol=t.protocol==="http:"?"ws:":"wss:",t.href}function _e(e,t){const n=y(t,"path"),o=y(t,"sessionToken");n!==void 0&&o!==void 0?e.resolve({path:n,sessionToken:o}):e.reject(new v("denied","The granted session is missing its address"))}function Fe(e){const t=C(e,"position");return t===void 0?void 0:{position:t,reason:"capacity"}}function ze(e){const t=C(e,"position");if(t!==void 0)return{limit:y(e,"name")??"Queue",position:t,reason:"concurrency"}}function Ve(e){return y(e,"message")??"The session request was denied"}async function je(e){const t=`The webserver rejected the session request (${String(e.status)})`,n=await e.json().catch(()=>{}),o=y(n,"message");return o?`${t}: ${o}`:t}async function Ne({apiToken:e=He(),codec:t="h264",device:n,endpoint:o="https://appetize.io",launch:r,onStateChange:s,proxy:i,signal:c,target:a}){c?.throwIfAborted(),H({apiToken:e,codec:t,device:n,endpoint:o,launch:r,proxy:i,target:a}),s?.({phase:"requesting"});const d=await Ce(o,{codec:t,noVideo:!0,proxy:Ie(i),publicKey:a,...J(n),...Q(r)},{apiToken:e,onQueue:h=>{s?.({phase:"queued",queue:h})},signal:c});return{baseUrl:new URL(d.path).origin,sessionToken:d.sessionToken,url:Qe(d)}}function He(){return Pe()?.env.APPETIZE_API_TOKEN}function Qe(e){const t=new URL("/client",e.path);return t.protocol=t.protocol==="http:"?"ws:":"wss:",t.searchParams.set("sessionToken",e.sessionToken),t.href}async function Je(e,t){await be(e,()=>new pe(t,{chunked:!1}))}async function Ge(e,{host:t="127.0.0.1",onError:n,port:o=0,signal:r}={}){r?.throwIfAborted();let s;const i=()=>{const u=s;s=void 0,u&&(u.tunnel?.close(),u.socket.destroy())},c=async u=>{const{socket:l}=u;try{const f=await e.debug.createAdbTunnel();if(l.destroyed){f.close();return}u.tunnel=f,f.closed.catch(E=>{n?.(E)}),Ke(l,f)}catch(f){l.destroyed||n?.(f),l.destroy()}},a=R(u=>{i();const l={socket:u};s=l,u.once("close",()=>{s===l&&(s=void 0)}),c(l)}),d=()=>{r?.removeEventListener("abort",d),i(),a.close()};r?.addEventListener("abort",d,{once:!0});const h=await Ze(a,t,o);return{close:d,url:new URL(`adb://${h.address}:${String(h.port)}`)}}function Ke(e,t){P(t.readable,e,D),P(e,async n=>{const o=t.writable.getWriter();try{for await(const r of n)await o.write(r);await o.close()}catch(r){throw await o.abort(r),r}},D)}function D(){}function Ze(e,t,n){return new Promise((o,r)=>{e.once("error",r),e.listen({host:t,port:n},()=>{e.off("error",r);const s=e.address();if(s===null||typeof s=="string"){r(new Error("The listener has no tcp address"));return}o(s)})})}async function Xe(e,{methods:t={},path:n,signal:o}){o?.throwIfAborted(),await te(n,{force:!0});const r=new Set,s=R(c=>{r.add(c),c.once("close",()=>{r.delete(c)}),$(new G(c),e,{leftEffects:()=>t})}),i=()=>{o?.removeEventListener("abort",i);for(const c of r)c.destroy();s.close()};return await Ye(s,n),o?.aborted&&(i(),o.throwIfAborted()),o?.addEventListener("abort",i,{once:!0}),{close:i,path:n}}function Ye(e,t){return new Promise((n,o)=>{e.once("error",o),e.listen(t,()=>{e.off("error",o),n()})})}const Be=b("appetize:daemon");function p(e){Be(e)}function et(e,{message:t="The operation timed out"}={}){const n=new AbortController,o=setTimeout(()=>{n.abort(new Error(t))},e),r=()=>{clearTimeout(o)};return{cancel:r,signal:n.signal,[Symbol.dispose]:r}}var tt=(e,t)=>(t=Symbol[e])?t:Symbol.for("Symbol."+e),M=e=>{throw TypeError(e)},nt=(e,t,n)=>{if(t!=null){typeof t!="object"&&typeof t!="function"&&M("Object expected");var o,r;o===void 0&&(o=t[tt("dispose")]),typeof o!="function"&&M("Object not disposable"),r&&(o=function(){try{r.call(this)}catch(s){return Promise.reject(s)}}),e.push([n,o,t])}return t},ot=(e,t,n)=>{var o=typeof SuppressedError=="function"?SuppressedError:function(i,c,a,d){return d=Error(a),d.name="SuppressedError",d.error=i,d.suppressed=c,d},r=i=>t=n?new o(i,t,"An error was suppressed during disposal"):(n=!0,i),s=i=>{for(;i=e.pop();)try{var c=i[1]&&i[1].call(i[2]);if(i[0])return Promise.resolve(c).then(s,a=>(r(a),s()))}catch(a){r(a)}if(n)throw t};return s()};const rt=1e4;async function st(e,t,{onClose:n,signal:o}={}){var r=[];try{const c=nt(r,et(rt,{message:"Timed out waiting for session request state"})),a=AbortSignal.any([o,c.signal].filter(g=>!!g)),d=g=>{t.save({state:g}),p(g.phase),g.phase!=="requesting"&&c.cancel()},{featureFlags:h,sessionId:u,...l}=e,{baseUrl:f,url:E}=await Ne({...l,onStateChange:d,signal:a});t.save({baseUrl:f});const m=new L(E,{signal:a});return await $e(m,{onStateChange:d,signal:a}),m.onclose=()=>{n?.("The device connection closed")},{device:await ve(m,{baseUrl:f,signal:a}),transport:m}}catch(c){var s=c,i=!0}finally{ot(r,s,i)}}function it(){const e=K(),t=Z(e.sessionId,e.proxy),n=X({device:e.device,endpoint:e.endpoint,open:e.launch?.url,pid:process.pid,proxy:e.proxy,sessionId:e.sessionId,startedAt:new Date().toISOString(),target:e.target});return n.save({logs:t}),{config:e,logs:t,store:n}}async function at(e,t,n,{signal:o}={}){try{if(!await ct(t))return;const r=await Ge(e,{onError:s=>{p(`adb endpoint error: ${q(s)}`)},signal:o});n.save({adbSerial:r.url.host}),p(`adb endpoint listening at ${r.url.host}`)}catch(r){p(`adb endpoint unavailable: ${q(r)}`)}}async function ct(e){return await Y(e.device.id,{endpoint:e.endpoint})==="android"}function q(e){return e instanceof Error?e.message:String(e)}async function dt(e,t,n,{recorder:o,signal:r}){const{path:s}=await Xe(e,{methods:{"appetizeio.cli.record.start":async i=>await o.start(i),"appetizeio.cli.record.stop":async()=>await o.stop()},path:B(n),signal:r});return t.save({controlSocket:s}),s}const O="127.0.0.1";async function ut(e,t,n={}){try{const o=await lt(e,n);return t.save({viewerUrl:o.url.href}),p(`web endpoint listening at ${o.url.href}`),o}catch(o){p(`web endpoint unavailable: ${gt(o)}`);return}}async function lt(e,{port:t=0,signal:n,viewerHtml:o=ne(new URL("./viewer.html",import.meta.url),"utf8")}){n?.throwIfAborted();const r=ie((u,l)=>{pt(u,l,o)}),s=new Set,i=new ae({noServer:!0,perMessageDeflate:!1});let c;i.on("connection",u=>{if(s.size>0){u.close(1013,"Viewer already connected");return}s.add(u);const l=new L(u);$(l,e),u.once("close",()=>{s.delete(u)})}),r.on("upgrade",(u,l,f)=>{ht(i,u,l,f)});const a=()=>(c??=new Promise((u,l)=>{n?.removeEventListener("abort",d);for(const f of s)ft(f);i.close(),r.close(f=>{f?l(f):u()})}),c),d=()=>{a()};await wt(r,t),n?.addEventListener("abort",d,{once:!0});const h=r.address();if(!h||typeof h=="string")throw await a(),new Error("Web address unavailable");return{close:a,url:new URL(`http://${O}:${String(h.port)}/`)}}function ft(e){e.close(1001)}function pt(e,t,n){if(e.method==="GET"&&e.url==="/"){t.writeHead(200,{"Cache-Control":"no-store","Content-Type":"text/html; charset=utf-8"}),t.end(n);return}t.writeHead(404).end()}function ht(e,t,n,o){if(t.url!=="/ws"){n.destroy();return}e.handleUpgrade(t,n,o,r=>{e.emit("connection",r,t)})}function wt(e,t){return new Promise((n,o)=>{const r=s=>{o(s)};e.once("error",r),e.listen(t,O,()=>{e.removeListener("error",r),n()})})}function gt(e){return e instanceof Error?e.message:String(e)}function vt(e){const t=new AbortController,n=yt(e,t),o=ee();return o.addEventListener("abort",()=>{const{reason:r}=o;n(r instanceof Error?r.message:String(r))},{once:!0}),{shutdown:n,signal:t.signal}}function yt(e,t){let n=!1;return o=>{n||(n=!0,e.save({endedAt:new Date().toISOString(),endedReason:o,state:{phase:"ended"}}),p(o),t.abort())}}async function x(e,t,{label:n,signal:o}){try{const r=await e();await ce(r.readable.pipeThrough(mt()),oe(t,{flags:"a"}))}catch(r){if(o?.aborted)return;const s=r instanceof Error?r.message:String(r);p(`${n} ended with an error: ${s}`)}}function mt(){return new TransformStream({transform:(e,t)=>{t.enqueue(`${JSON.stringify(e)}
+import{T as _,P as A,Q as F,R as T,V as z,J as V,W as j,y as v,X as N,x as H,Y as Q,Z as J,_ as $,$ as G,a0 as K,F as Z,a1 as X,a2 as Y,a3 as B,a4 as ee}from"./stream-X6gIBNIh.js";import b from"debug";import{createServer as R}from"node:net";import{pipeline as P}from"node:stream";import{rm as te}from"node:fs/promises";import{readFileSync as ne,createWriteStream as oe,existsSync as re,rmSync as se}from"node:fs";import{createServer as ie}from"node:http";import{WebSocketServer as ae}from"ws";import{pipeline as ce}from"node:stream/promises";import{EncodedVideoPacketSource as de,Output as ue,Mp4OutputFormat as le,EncodedPacket as fe,FilePathTarget as pe}from"mediabunny";import"json-rpc-2.0";import"zod/mini";import"node:path";import"node:os";import"stream";import"module";const he=b("appetize.io:transport:ws-ping"),we=3e4;function ge(e){let t=!0;const n=()=>{t=!0};e.on("pong",n);const o=setInterval(()=>{if(!t){clearInterval(o),he("liveness ping went unanswered, terminating"),e.terminate();return}e.readyState===e.OPEN&&(t=!1,e.ping())},we);return{destroy(){clearInterval(o),e.off("pong",n)},pong:n}}const w=b("appetize.io:trace:transport:websocket");class L extends _{constructor(t,{signal:n}={}){super(async r=>{this.#e.send(A(r))},{signal:n}),this.wsOrUrl=t,typeof t=="string"?(this.#e=new WebSocket(t),this.#e.binaryType="arraybuffer"):this.#e=t;const o=this.#e;if(o instanceof WebSocket?(o.addEventListener("open",this.#s),o.addEventListener("message",this.#r),o.addEventListener("error",this.#o),o.addEventListener("close",this.#n),this.#t.push(()=>{o.removeEventListener("open",this.#s),o.removeEventListener("message",this.#r),o.removeEventListener("error",this.#o),o.removeEventListener("close",this.#n)})):(o.addEventListener("open",this.#s),o.addEventListener("message",this.#r),o.addEventListener("error",this.#o),o.addEventListener("close",this.#n),this.#t.push(()=>{o.removeEventListener("open",this.#s),o.removeEventListener("message",this.#r),o.removeEventListener("error",this.#o),o.removeEventListener("close",this.#n)})),this.send=o.send.bind(o),"ping"in o){const{destroy:r,pong:s}=ge(o);this.#c=s,this.#t.push(r)}}wsOrUrl;onclose;onerror;onmessage;onopen;send;get bufferedAmount(){return this.#e.bufferedAmount}get readyState(){return this.#e.readyState}#t=[];#i=!1;#a=!1;#c;#e;close({destroyWs:t=!1,...n}={}){this.closed||(this.#i=t,super.close(n))}handleClose(t){w("close()");for(const n of this.#t.splice(0))n();if((typeof this.wsOrUrl=="string"||this.#i)&&(this.#e.close(t.code,t.reason),"terminate"in this.#e)){const n=this.#e;setTimeout(()=>{n.terminate()},100)}this.#d(),super.handleClose(t)}#d(t){this.#a||(this.#a=!0,this.onclose?.(t))}#n=t=>{w("handleWebSocketClose()",t);try{this.#d(t)}finally{this.close()}};#o=t=>{w("handleWebSocketError()",t),this.onerror?.(t)};#r=async t=>{w("handleWebSocketMessage()",t),this.#c?.();const n=this.#u(t);if(!n){w("handleWebSocketMessage() -> legacy"),this.onmessage?.(t);return}w("handleWebSocketMessage() -> jsonrpc",n),this[F].dispatchMessage(n)};#s=t=>{w("handleWebSocketOpen()",t),this.onopen?.(t)};#u(t){try{const n=T(new Uint8Array(t.data));return z(n)?n:null}catch{return null}}}function S(e){return typeof e=="object"&&e!==null}function I(e){try{const t=T(new Uint8Array(e.data));if(S(t)&&typeof t.name=="string")return{name:t.name,payload:"payload"in t?t.payload:void 0}}catch{}}async function ve(e,t={}){const n=t.baseUrl??(typeof e=="string"?new URL(e).origin:void 0),o=typeof e=="string"?new L(e,{signal:t.signal}):e,r=new V(o,{...t,baseUrl:n});return typeof e=="string"&&await ye(o,r,t),r}function ye(e,t,n){const o=j(n)?.onLegacyMessage;return new Promise((r,s)=>{e.onopen=()=>{r()},e.onclose=()=>{t.close(),n.signal?.aborted?s(n.signal.reason):s(new Error("The websocket was closed before the device connection was established"))},e.onerror=s,e.onmessage=i=>{const c=I(i);c&&o?.(c)}})}const me=b("appetize:client:render-video-to-mp4"),k=30;async function be(e,t){await e.pipeTo(Ee(t))}function Se(e){return{decoderConfig:{codec:"avc1.640028",codedHeight:e.height,codedWidth:e.width}}}function Ee(e){let t;const n=async()=>{await t?.output.finalize()};return new WritableStream({abort:n,close:n,write:async o=>{if(o.data.byteLength!==0)try{t??=await Te(ke(o),e()),Le(t,o),await Ae(t,o)}catch(r){throw await t?.output.cancel(),r}}})}async function Te(e,t){const n=new de("avc"),o=new ue({format:new le({fastStart:"fragmented"}),target:t});return o.addVideoTrack(n,{frameRate:k}),await o.start(),{frame:0,output:o,seen:{height:e.height,width:e.width},size:{height:e.height,width:e.width},source:n}}function Le(e,t){if(t.type!=="key")return;const{seen:n,size:o}=e;t.width===n.width&&t.height===n.height||(e.seen={height:t.height,width:t.width},me(`video resized to ${String(t.width)}x${String(t.height)}; keeping ${String(o.width)}x${String(o.height)}`))}function ke(e){if(e.type!=="key")throw new Error("Video stream started without a key chunk");return e}async function Ae(e,t){const n=new fe(t.data,t.type,e.frame/k,1/k);e.frame+=1,await e.source.add(n,Se(e.size))}async function $e(e,{onStateChange:t,signal:n}){n?.throwIfAborted(),t?.({phase:"starting"}),await new Promise((o,r)=>{const s=()=>{i(),r(n?.reason)},i=()=>{e.onmessage=void 0,e.onclose=void 0,n?.removeEventListener("abort",s)};e.onmessage=c=>{const a=Re(I(c));a&&(t?.(a),a.phase==="ready"&&(i(),o()))},e.onclose=()=>{i(),r(new Error("The device closed before it was ready"))},n?.addEventListener("abort",s,{once:!0})})}function Re(e){if(!e)return;if(e.name==="ready")return{phase:"ready"};if(e.name!=="launchStatus")return;switch(S(e.payload)&&typeof e.payload.status=="string"?e.payload.status:void 0){case"downloadingApp":return{phase:"downloadingApp"};case"installingApp":return{phase:"installingApp"};case"launchingApp":return{phase:"launchingApp"};default:return}}function Pe(){return typeof process>"u"?void 0:process}function Ie(e){return e==="intercept"?"interceptOnDemand":e}function We(e,{onClose:t,onEvent:n,signal:o}={}){return new Promise((r,s)=>{const i=new WebSocket(e);i.binaryType="arraybuffer",i.onopen=()=>{W(i,{capabilities:{},t:"handshake"})},i.onmessage=c=>{Ue(i,c,{onEvent:n,onHandshake:a=>{r({close:()=>{i.close()},id:a})}})},i.onclose=()=>{s(new v("disconnected",`The connection to ${e} closed`)),t?.()},o?.addEventListener("abort",()=>{s(o.reason),i.close()},{once:!0})})}function Ue(e,t,n){const o=T(new Uint8Array(t.data));S(o)&&(o.t==="handshake"&&typeof o.id=="string"?n.onHandshake(o.id):o.name==="ping"?W(e,{name:"pong"}):typeof o.name=="string"&&n.onEvent?.(o.name,o.payload))}function W(e,t){e.send(A(t))}async function Ce(e,t,{apiToken:n,onQueue:o,signal:r}={}){const s=N();s.promise.catch(()=>{}),Oe(s.reject,r);const i=await We(xe(e),{onClose:()=>{s.reject(De())},onEvent:(c,a)=>{Me(c,a,s,o)},signal:r});return qe(e,{apiToken:n,data:t,socketid:i.id},r).catch(s.reject),await s.promise.finally(()=>{i.close()})}function De(){return new v("disconnected","The webserver connection closed before a session was granted")}function U(e,t){return S(e)?e[t]:void 0}function Me(e,t,n,o){if(e==="queue"||e==="concurrentQueue"){const r=e==="queue"?Fe(t):ze(t);r&&o?.(r)}else e==="newSession"?_e(n,t):e==="userError"&&n.reject(new v("denied",Ve(t)))}function C(e,t){const n=U(e,t);return typeof n=="number"?n:void 0}function y(e,t){const n=U(e,t);return typeof n=="string"?n:void 0}async function qe(e,t,n){const o=await fetch(new URL("/api/session/request",e),{body:JSON.stringify(t),headers:{"content-type":"application/json"},method:"POST",signal:n});if(!o.ok)throw new v("denied",await je(o))}function Oe(e,t){t?.addEventListener("abort",()=>{e(t.reason)},{once:!0})}function xe(e){const t=new URL("/client",e);return t.protocol=t.protocol==="http:"?"ws:":"wss:",t.href}function _e(e,t){const n=y(t,"path"),o=y(t,"sessionToken");n!==void 0&&o!==void 0?e.resolve({path:n,sessionToken:o}):e.reject(new v("denied","The granted session is missing its address"))}function Fe(e){const t=C(e,"position");return t===void 0?void 0:{position:t,reason:"capacity"}}function ze(e){const t=C(e,"position");if(t!==void 0)return{limit:y(e,"name")??"Queue",position:t,reason:"concurrency"}}function Ve(e){return y(e,"message")??"The session request was denied"}async function je(e){const t=`The webserver rejected the session request (${String(e.status)})`,n=await e.json().catch(()=>{}),o=y(n,"message");return o?`${t}: ${o}`:t}async function Ne({apiToken:e=He(),codec:t="h264",device:n,endpoint:o="https://appetize.io",launch:r,onStateChange:s,proxy:i,signal:c,target:a}){c?.throwIfAborted(),H({apiToken:e,codec:t,device:n,endpoint:o,launch:r,proxy:i,target:a}),s?.({phase:"requesting"});const d=await Ce(o,{codec:t,noVideo:!0,proxy:Ie(i),publicKey:a,...J(n),...Q(r)},{apiToken:e,onQueue:h=>{s?.({phase:"queued",queue:h})},signal:c});return{baseUrl:new URL(d.path).origin,sessionToken:d.sessionToken,url:Qe(d)}}function He(){return Pe()?.env.APPETIZE_API_TOKEN}function Qe(e){const t=new URL("/client",e.path);return t.protocol=t.protocol==="http:"?"ws:":"wss:",t.searchParams.set("sessionToken",e.sessionToken),t.href}async function Je(e,t){await be(e,()=>new pe(t,{chunked:!1}))}async function Ge(e,{host:t="127.0.0.1",onError:n,port:o=0,signal:r}={}){r?.throwIfAborted();let s;const i=()=>{const u=s;s=void 0,u&&(u.tunnel?.close(),u.socket.destroy())},c=async u=>{const{socket:l}=u;try{const f=await e.debug.createAdbTunnel();if(l.destroyed){f.close();return}u.tunnel=f,f.closed.catch(E=>{n?.(E)}),Ke(l,f)}catch(f){l.destroyed||n?.(f),l.destroy()}},a=R(u=>{i();const l={socket:u};s=l,u.once("close",()=>{s===l&&(s=void 0)}),c(l)}),d=()=>{r?.removeEventListener("abort",d),i(),a.close()};r?.addEventListener("abort",d,{once:!0});const h=await Ze(a,t,o);return{close:d,url:new URL(`adb://${h.address}:${String(h.port)}`)}}function Ke(e,t){P(t.readable,e,D),P(e,async n=>{const o=t.writable.getWriter();try{for await(const r of n)await o.write(r);await o.close()}catch(r){throw await o.abort(r),r}},D)}function D(){}function Ze(e,t,n){return new Promise((o,r)=>{e.once("error",r),e.listen({host:t,port:n},()=>{e.off("error",r);const s=e.address();if(s===null||typeof s=="string"){r(new Error("The listener has no tcp address"));return}o(s)})})}async function Xe(e,{methods:t={},path:n,signal:o}){o?.throwIfAborted(),await te(n,{force:!0});const r=new Set,s=R(c=>{r.add(c),c.once("close",()=>{r.delete(c)}),$(new G(c),e,{leftEffects:()=>t})}),i=()=>{o?.removeEventListener("abort",i);for(const c of r)c.destroy();s.close()};return await Ye(s,n),o?.aborted&&(i(),o.throwIfAborted()),o?.addEventListener("abort",i,{once:!0}),{close:i,path:n}}function Ye(e,t){return new Promise((n,o)=>{e.once("error",o),e.listen(t,()=>{e.off("error",o),n()})})}const Be=b("appetize:daemon");function p(e){Be(e)}function et(e,{message:t="The operation timed out"}={}){const n=new AbortController,o=setTimeout(()=>{n.abort(new Error(t))},e),r=()=>{clearTimeout(o)};return{cancel:r,signal:n.signal,[Symbol.dispose]:r}}var tt=(e,t)=>(t=Symbol[e])?t:Symbol.for("Symbol."+e),M=e=>{throw TypeError(e)},nt=(e,t,n)=>{if(t!=null){typeof t!="object"&&typeof t!="function"&&M("Object expected");var o,r;o===void 0&&(o=t[tt("dispose")]),typeof o!="function"&&M("Object not disposable"),r&&(o=function(){try{r.call(this)}catch(s){return Promise.reject(s)}}),e.push([n,o,t])}return t},ot=(e,t,n)=>{var o=typeof SuppressedError=="function"?SuppressedError:function(i,c,a,d){return d=Error(a),d.name="SuppressedError",d.error=i,d.suppressed=c,d},r=i=>t=n?new o(i,t,"An error was suppressed during disposal"):(n=!0,i),s=i=>{for(;i=e.pop();)try{var c=i[1]&&i[1].call(i[2]);if(i[0])return Promise.resolve(c).then(s,a=>(r(a),s()))}catch(a){r(a)}if(n)throw t};return s()};const rt=1e4;async function st(e,t,{onClose:n,signal:o}={}){var r=[];try{const c=nt(r,et(rt,{message:"Timed out waiting for session request state"})),a=AbortSignal.any([o,c.signal].filter(g=>!!g)),d=g=>{t.save({state:g}),p(g.phase),g.phase!=="requesting"&&c.cancel()},{featureFlags:h,sessionId:u,...l}=e,{baseUrl:f,url:E}=await Ne({...l,onStateChange:d,signal:a});t.save({baseUrl:f});const m=new L(E,{signal:a});return await $e(m,{onStateChange:d,signal:a}),m.onclose=()=>{n?.("The device connection closed")},{device:await ve(m,{baseUrl:f,signal:a}),transport:m}}catch(c){var s=c,i=!0}finally{ot(r,s,i)}}function it(){const e=K(),t=Z(e.sessionId,e.proxy),n=X({device:e.device,endpoint:e.endpoint,open:e.launch?.url,pid:process.pid,proxy:e.proxy,sessionId:e.sessionId,startedAt:new Date().toISOString(),target:e.target});return n.save({logs:t}),{config:e,logs:t,store:n}}async function at(e,t,n,{signal:o}={}){try{if(!await ct(t))return;const r=await Ge(e,{onError:s=>{p(`adb endpoint error: ${q(s)}`)},signal:o});n.save({adbSerial:r.url.host}),p(`adb endpoint listening at ${r.url.host}`)}catch(r){p(`adb endpoint unavailable: ${q(r)}`)}}async function ct(e){return await Y(e.device.id,{endpoint:e.endpoint})==="android"}function q(e){return e instanceof Error?e.message:String(e)}async function dt(e,t,n,{recorder:o,signal:r}){const{path:s}=await Xe(e,{methods:{"appetizeio.cli.record.start":async i=>await o.start(i),"appetizeio.cli.record.stop":async()=>await o.stop()},path:B(n),signal:r});return t.save({controlSocket:s}),s}const O="127.0.0.1";async function ut(e,t,n={}){try{const o=await lt(e,n);return t.save({viewerUrl:o.url.href}),p(`web endpoint listening at ${o.url.href}`),o}catch(o){p(`web endpoint unavailable: ${gt(o)}`);return}}async function lt(e,{port:t=0,signal:n,viewerHtml:o=ne(new URL("./viewer.html",import.meta.url),"utf8")}){n?.throwIfAborted();const r=ie((u,l)=>{pt(u,l,o)}),s=new Set,i=new ae({noServer:!0,perMessageDeflate:!1});let c;i.on("connection",u=>{if(s.size>0){u.close(1013,"Viewer already connected");return}s.add(u);const l=new L(u);$(l,e),u.once("close",()=>{s.delete(u)})}),r.on("upgrade",(u,l,f)=>{ht(i,u,l,f)});const a=()=>(c??=new Promise((u,l)=>{n?.removeEventListener("abort",d);for(const f of s)ft(f);i.close(),r.close(f=>{f?l(f):u()})}),c),d=()=>{a()};await wt(r,t),n?.addEventListener("abort",d,{once:!0});const h=r.address();if(!h||typeof h=="string")throw await a(),new Error("Web address unavailable");return{close:a,url:new URL(`http://${O}:${String(h.port)}/`)}}function ft(e){e.close(1001)}function pt(e,t,n){if(e.method==="GET"&&e.url==="/"){t.writeHead(200,{"Cache-Control":"no-store","Content-Type":"text/html; charset=utf-8"}),t.end(n);return}t.writeHead(404).end()}function ht(e,t,n,o){if(t.url!=="/ws"){n.destroy();return}e.handleUpgrade(t,n,o,r=>{e.emit("connection",r,t)})}function wt(e,t){return new Promise((n,o)=>{const r=s=>{o(s)};e.once("error",r),e.listen(t,O,()=>{e.removeListener("error",r),n()})})}function gt(e){return e instanceof Error?e.message:String(e)}function vt(e){const t=new AbortController,n=yt(e,t),o=ee();return o.addEventListener("abort",()=>{const{reason:r}=o;n(r instanceof Error?r.message:String(r))},{once:!0}),{shutdown:n,signal:t.signal}}function yt(e,t){let n=!1;return o=>{n||(n=!0,e.save({endedAt:new Date().toISOString(),endedReason:o,state:{phase:"ended"}}),p(o),t.abort())}}async function x(e,t,{label:n,signal:o}){try{const r=await e();await ce(r.readable.pipeThrough(mt()),oe(t,{flags:"a"}))}catch(r){if(o?.aborted)return;const s=r instanceof Error?r.message:String(r);p(`${n} ended with an error: ${s}`)}}function mt(){return new TransformStream({transform:(e,t)=>{t.enqueue(`${JSON.stringify(e)}
 `)}})}async function bt(e,t,{signal:n}={}){await x(async()=>await e.debug.createLogStream({signal:n}),t,{label:"log capture",signal:n})}async function St(e,t,{signal:n}={}){await x(async()=>await e.debug.createProxyInterceptStream({signal:n}),t,{label:"network capture",signal:n})}function Et(e,t,{signal:n}={}){let o,r;const s=async(a,{force:d=!1}={})=>{if(re(a)){if(!d)throw new Error(`A recording already exists at ${a}; pass --force to overwrite`);se(a)}const h=await e.video.createStream({signal:n});return o={done:Tt(h,a),path:a,stream:h},t.save({video:{path:a,recording:!0}}),p(`recording video to ${a}`),{path:a}},i=async a=>{a.stream.close();try{await a.done,t.save({video:{path:a.path,recording:!1}})}finally{o=void 0,r=void 0}},c=async()=>{if(!o)return;const{path:a}=o;await i(o),p(`closed the video recording: ${a}`)};return n?.addEventListener("abort",()=>{c()},{once:!0}),{start:async({force:a=!1,path:d})=>{const h=o?.path??r;if(h!==void 0)throw new Error(`Already recording to ${h}`);r=d;try{return await s(d,{force:a})}finally{r=void 0}},stop:async()=>{if(!o)throw new Error("No video recording in progress");const{path:a}=o;return await i(o),{path:a}}}}async function Tt(e,t){try{await Je(e.readable,t)}catch(n){p(`video capture ended with an error: ${String(n)}`)}}async function Lt(){const{config:e,logs:t,store:n}=it();p(`recording to ${n.path}`);const{shutdown:o,signal:r}=vt(n);try{const{device:s,transport:i}=await st(e,n,{onClose:o,signal:r}),c=Et(s,n,{signal:r});await at(s,e,n,{signal:r}),await ut(i,n,{signal:r});const a=await dt(i,n,e.sessionId,{recorder:c,signal:r});p(`control socket listening at ${a}`),bt(s,t.device,{signal:r}),p(`recording device logs to ${t.device}`),t.network&&(St(s,t.network,{signal:r}),p(`recording network events to ${t.network}`))}catch(s){if(r.aborted)return;const i=s instanceof Error?s.message:String(s);n.save({endedAt:new Date().toISOString(),endedReason:i,state:{message:i,phase:"error"}}),p(`error: ${i}`),process.exitCode=1}}Lt();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appetize/cli",
-  "version": "0.26.0",
+  "version": "0.28.0",
   "description": "Run, inspect and control iOS and Android apps on Appetize cloud devices",
   "license": "SEE LICENSE IN LICENSE",
   "homepage": "https://appetize.io",
@@ -32,7 +32,7 @@
     "debug": "^4.4.3",
     "human-id": "^4.2.2",
     "json-rpc-2.0": "^1.8.1",
-    "mediabunny": "^1.62.0",
+    "mediabunny": "^1.62.1",
     "sade": "^1.8.1",
     "ws": "^8.22.0",
     "yocto-spinner": "^1.2.2",

package/skills/appetize/SKILL.md

@@ -10,7 +10,7 @@ description: >-
   or answering what is currently on screen — even if Appetize is not mentioned
   by name.
 metadata:
-  cli-version: '0.26.0'
+  cli-version: '0.28.0'
 ---
 
 # Appetize
@@ -117,7 +117,7 @@ appetize screenshot after-login --json
 
 Screenshot after each meaningful step. A tap that "succeeded" only means the
 gesture was delivered — the app may have shown an error, stayed put, or
-navigated somewhere unexpected.
+navigated somewhere unexpected. Add `--select-*` to capture one element.
 
 ### 4. Wait by inspecting, not by sleeping
 
@@ -208,6 +208,20 @@ destination with `inspect --timeout`. A custom scheme needs its app installed.
 On iOS, `appetize keychain clear` clears the keychain without restarting the
 session.
 
+## Device settings
+
+Change settings mid-session instead of restarting:
+
+```bash
+appetize settings set --appearance dark --font-size xl --json
+appetize biometry enroll --json
+```
+
+## Biometry
+
+`appetize biometry authenticate` answers the app's biometric prompt with a
+match; `--no-match` answers with a non-match.
+
 ## Shake
 
 `appetize shake` shakes the device.

package/skills/appetize/references/commands.md

@@ -48,6 +48,14 @@ Session directories live under `~/.appetize/cli/sessions/`, or
 Waits for the daemon to exit, so logs are complete; `--no-wait` only signals
 it. Safe to call twice.
 
+## biometry authenticate
+
+Fails when the device has no biometry enrolled.
+
+## biometry enroll
+
+iOS only. `--unenroll` removes enrollment.
+
 ## build list
 
 Newest first. Pass a non-null `nextPage` back as `--page` to continue.
@@ -103,6 +111,12 @@ last second. A write failure is reported here, not when it happens.
 Playback is a constant 30fps, so it does not track real time. A rotation keeps
 the original dimensions.
 
+## settings set
+
+Takes the values `session start`'s `--device-*` flags accept. Applies
+appearance, font size, then location, stopping at the first failure; earlier
+ones stay applied. Write a negative latitude as `--location=-33.87,151.21`.
+
 ## shake
 
 Returns once the shake finishes, about a second on Android.
@@ -114,11 +128,15 @@ Claude Code, `.agents/skills` for the others — and into both when none is.
 
 ## Selectors
 
-`inspect --select-*`, `tap --select-*` and `swipe --from-*`/`--to-*` share the
-same suffixes. `-text` is an exact string or `/regex/flags`; `-index` is
-0-based. `-test-id` is an exact match: on Android the whole `resource-id` or the
-part after its last `/`, on iOS the `accessibilityIdentifier`.
+Element selectors are flags ending in:
+
+- `-text`: an exact string or `/regex/flags`.
+- `-test-id`: an exact id; on Android the whole `resource-id` or the part after
+  its last `/`, on iOS the `accessibilityIdentifier`.
+- `-index`: which match when several, 0-based.
+
+Every element selector is also a position selector, at the element's center by
+default:
 
-Only `tap` and `swipe` take positions. `-position` is a screen `x,y`, each 0-1;
-`-x` and `-y` place the point within the matched element, beyond its edge when
-outside 0-1.
+- `-position`: a screen `x,y`, each 0-1.
+- `-x` and `-y`: the point within the element, beyond its edge outside 0-1.