@kaeawc/auto-mobile 0.0.91 → 0.0.92

package/dist/src/chunk-2e6s75qv.js

@@ -0,0 +1,78 @@
+// @bun
+import{Oo,sS,bt,Ff,Lf}from"./chunk-nwm2pq5v.js";import{i,si,e}from"./chunk-z8t0v07j.js";import{g}from"./chunk-mf9spd4g.js";import{cL,dw,yW,Kc,ru,Xu,kw,Zu,jh,Os,M,yi}from"./chunk-h3n4adc6.js";import{JN}from"./chunk-a2sc4jm0.js";import{WE,Fr}from"./chunk-qwye1958.js";import{L,Nt,_i,vi}from"./chunk-32jpxz2y.js";import"./chunk-ggtd5x5a.js";import"./chunk-79q5xsdc.js";import"./chunk-6d3mmqxt.js";import"./chunk-4fgdhcwx.js";import{Tb,cP,sM,s1,N,Qg,ey,ty,VE}from"./chunk-3jmvqygr.js";import"./chunk-hmke8nhx.js";import"./chunk-z04jrpjy.js";import{fe}from"./chunk-8cghfzb2.js";import"./chunk-tyazf3sk.js";import{t7}from"./chunk-44bt78m9.js";import"./chunk-jhnbfj19.js";import"./chunk-0e4gm1kj.js";import"./chunk-mqc1d0eb.js";import"./chunk-vefd8qee.js";import"./chunk-4xd6zs3y.js";import"./chunk-pm06b05d.js";import"./chunk-rn84t3sf.js";import"./chunk-vs9r72ta.js";import"./chunk-0rjm4nx7.js";import{hb,NO}from"./chunk-z916af47.js";import"./chunk-kbjq0qvb.js";import"./chunk-0w1spptt.js";import"./chunk-6hyt398x.js";import"./chunk-w7zsh13a.js";import"./chunk-ympy4fdz.js";import"./chunk-f9s1kkhx.js";import"./chunk-r20pe1nv.js";import"./chunk-cxyf04jc.js";import"./chunk-jdqvcq0a.js";import"./chunk-t4dr5c8v.js";import"./chunk-9y5bcy28.js";import"./chunk-zd9vmkzn.js";import"./chunk-c9nk1r78.js";import"./chunk-a4k9rt7z.js";import"./chunk-sjn0nj4p.js";import"./chunk-bn64x5z5.js";import"./chunk-sns0c35v.js";import"./chunk-zg67wjkh.js";import{r,t}from"./chunk-9rkfyt6q.js";function x(n,o,s={}){let a=cP(n);if(a&&/Unknown tool\b/i.test(o))return a;let l=o.replace(/[.]+$/,""),c=!s.gated&&/Unknown tool\b/i.test(o)?" Try: auto-mobile --daemon restart":"";return`Error calling daemon: ${l}.${c}`}function T(){hb(),NO({daemonMode:!0,includeDoctor:!0,includeToolSelection:!1})}function E(n){try{return{parsed:!0,value:JSON.parse(n)}}catch(o){return e.debug(`[cli] value is not JSON, treating as a raw token: ${n} (${o})`),{parsed:!1,value:n}}}function _(n,o){let s=()=>E(n).value;if(o?.nullable&&n==="null")return null;switch(o?.type){case"string":case"enum":return ie(n);case"number":case"bigint":return se(n);case"boolean":if(n==="true")return!0;if(n==="false")return!1;return s();default:return s()}}function ie(n){let{parsed:o,value:s}=E(n);return o&&typeof s==="string"?s:n}function se(n){let{parsed:o,value:s}=E(n);return o&&typeof s==="number"&&Number.isFinite(s)?s:n}var k=new Set(["optional","nullable","default","readonly","catch","branded","lazy"]);function A(n){let o=n?._def?.typeName??n?._def?.type??"unknown";return String(o).replace(/^Zod/,"").toLowerCase()}function U(n){let o=n?._def;return o?.innerType??o?.type??o?.schema??null}function ae(n){let o=n?._def?.options;if(!Array.isArray(o))return!1;let s=o.map((d)=>R(d).type),a=s.some((d)=>d==="number"||d==="bigint"),c=o.filter((d,u)=>s[u]==="string").every((d)=>{let u=d;for(let f=0;f<10&&u;f++){let m=A(u);if(m==="literal")return typeof(u._def?.value??u._def?.values?.[0])==="string";if(!k.has(m))return!1;u=U(u)}return!1});if(a&&c)return!1;return s.includes("string")&&s.every((d)=>["string","number","boolean","bigint"].includes(d))}function R(n){let o=n,s=!1;for(let a=0;a<10&&o;a++){let l=A(o);if(l==="nullable")s=!0;if(l==="literal")return{type:typeof(o._def?.value??o._def?.values?.[0]),nullable:s};if(l==="union"&&ae(o))return{type:"string",nullable:s};if(!k.has(l))return{type:l,nullable:s};o=U(o)}return{type:"unknown",nullable:s}}function C(n){let o=n?._def;if(!o)return[];if(o.shape)return[o.shape];let s=o.options??o.out?._def?.options;if(Array.isArray(s))return s.flatMap((a)=>C(a));return o.out?C(o.out):[]}function F(n){T();let o=N.getRegisteredTool(n);if(!o)return null;let s=C(o.schema);if(s.length===0)return null;let a=new Map;for(let l of s)for(let[c,d]of Object.entries(l)){let u=R(d),f=a.get(c)??{types:new Set,nullable:!1};f.types.add(u.type),f.nullable=f.nullable||u.nullable,a.set(c,f)}return Object.fromEntries([...a.entries()].filter(([,l])=>l.types.size===1).map(([l,c])=>[l,{type:[...c.types][0],nullable:c.nullable}]))}import le from"fs";var ce=65536,ue="CliToolResult";function B(n,o){let s=o.maxBytes??ce,a;try{a=JSON.stringify(n,null,2)}catch(c){return v(o.tool,0,`result is not JSON-serializable: ${r(c)}`)}if(a===void 0)return v(o.tool,0,"tool returned a value with no JSON representation");let l=Buffer.byteLength(a,"utf8");if(l<=s)return a;if(!o.artifactWriter)return v(o.tool,l,"no tool-output directory is available to spill the payload to");try{let c=o.artifactWriter.writeJsonArtifact({tool:o.tool,payload:ue,data:n,serialized:a});return JSON.stringify({truncated:!1,bytes:l,artifact:{...c.artifact,resourceUri:void 0},note:`Tool output was ${l} bytes, over the ${s}-byte CLI inline limit. The complete JSON result is in artifact.path.`},null,2)}catch(c){return e.debug(`[cli] failed to spill oversized tool output: ${r(c)}`),v(o.tool,l,r(c))}}function v(n,o,s){return JSON.stringify({truncated:!0,tool:n,bytes:o,reason:s,recovery:"Re-run with AUTOMOBILE_TOOL_OUTPUTS_DIR set to a writable directory, or narrow the request (for example observe with a scope) so the result fits inline."},null,2)}var H={write:(n)=>W(1,n)},j={write:(n)=>W(2,n)},de={writeSync:(n,o,s,a)=>le.writeSync(n,o,s,a),sleepSync:(n)=>{Atomics.wait(new Int32Array(new SharedArrayBuffer(4)),0,0,n)}},pe=1000;function me(n,o,s){let a=o+1;if(s.sleepSync(1),a>=pe)throw Error(`Zero-progress write to fd ${n} after ${a} attempts; refusing to spin`);return a}function W(n,o,s=de){let a=Buffer.from(o,"utf8"),l=0,c=0;while(l<a.length)try{let d=s.writeSync(n,a,l,a.length-l);if(d===0){c=me(n,c,s);continue}c=0,l+=d}catch(d){let u=d.code;if(u==="EAGAIN"){s.sleepSync(1);continue}if(u==="EPIPE"){e.debug(`[cli] output stream closed before the write completed (fd ${n})`);return}throw d}}function ge(n){if(!n||typeof n!=="object")return;let o=n,s=o.failure;if(s&&typeof s==="object")return s.code;let a=o.error;return o.code??(a&&typeof a==="object"?a.code:void 0)}function y(n){return n&&typeof n==="object"?n:void 0}function ye(n){return y(y(n)?.error)?.reason}function P(n){if(n<60000){let s=Math.round(n/1000*10)/10;return`${s} ${s===1?"second":"seconds"}`}let o=Math.round(n/60000*10)/10;return`${o} ${o===1?"minute":"minutes"}`}function he(n){let o=y(y(n)?.error)?.idleTimeoutMs;return typeof o==="number"&&Number.isFinite(o)&&o>0?o:void 0}var Se=`(reads do not count), so its session UUID cannot be used again. Acquire a new session with getAndroid, getApple or startDevice. To keep a session across longer gaps, set ${g.CLI_SESSION_IDLE_TIMEOUT_MS.name} (milliseconds, at most ${P(dw)}) in the environment of every --cli call.`;function be(n){let o=he(n);return`Hint: this --cli session went longer than ${o===void 0?`its idle timeout (${P(cL)} by default)`:`its idle timeout of ${P(o)} (${o} ms)`} without a control call ${Se}`}function we(n){let o=y(n)?.candidates;if(!Array.isArray(o))return[];return o.flatMap((s)=>{let a=y(s);if(typeof a?.deviceId!=="string")return[];return[typeof a.platform==="string"?`${a.deviceId} (${a.platform})`:a.deviceId]})}function Te(n){let o=we(n);return`Hint: more than one device matches this call. Re-run with --deviceId <id> to pick one, or with --session-uuid <uuid> to use a device your session holds.${o.length>0?` Candidates: ${o.join(", ")}.`:""}`}var ve=new Map([[Kc,"Hint: the device's previous session is still finishing its cleanup. Re-run the command after the retryAfterMs in the error has passed; nothing else needs to change."],[Xu,"Hint: the device is being shut down. Re-run the command after the retryAfterMs in the error has passed, once the shutdown has finished."],[Zu,"Hint: this session is being released because its device is being shut down, so its session UUID cannot be used again. Retrying with the same --session-uuid will not succeed; acquire the device again under a new session instead."],[jh,"Hint: the device's session is moving to another device. Re-run the command after the retryAfterMs in the error has passed, once the rebind has settled."],[kw,"Hint: the session no longer holds this device; it was rebound or released. Check who holds the device now with --daemon active-sessions before re-running the command."],[ru,"Hint: another AutoMobile daemon on this host is using the device. Re-run after it releases the device, or pass another deviceId."]]);function J(n,o){let s=ge(n);if(s===Oo&&ye(n)==="cli-idle-timeout")return be(n);if(s===sS)return Te(n);let a=typeof s==="string"?ve.get(s):void 0;if(a!==void 0)return a;if(s!==yW)return;if(Fr(o))return`Hint: another session holds the device, and ${o} cannot join it: acquisition tools mint their own session and the CLI ignores --session-uuid for them. If that session is yours, skip re-acquiring and pass --session-uuid <uuid> to your follow-up calls; to see who holds the device, run --daemon active-sessions (releasing a session that is not yours can break another agent's work); otherwise wait for the holder to release it.`;return`Hint: a device a session holds takes calls only from that session. Re-run with --session-uuid <uuid>, the sessionUuid that getAndroid, getApple or startDevice returned when the device was acquired, or wait for the holder to release it.${t7(o,"force")?" To stop it anyway, pass --force true.":""}`}import p from"fs";import q from"path";var Oe="tool-selection-profile",Ce=3000,Ee=50,_e=L.next(),Pe;function O(n){return q.join(si("cli",n),Oe)}function Ie(n){return`${O(n)}.lock`}async function I(n,o=process.env){let s=De(o,Pe??{});if(!await s.acquire())return!1;try{await n()}finally{s.release()}return!0}function De(n,o){let s=o.timer??i,a=Math.max(1,o.pollIntervalMs??Ee),l=o.timeoutMs??Ce,c=Ie(n),d=o.pid??process.pid,u=o.ownerToken??_e,f=s.now()+l;return{acquire:async()=>{try{for(;;){if(_i(c,{pid:d,isProcessRunning:o.isProcessRunning,ownerGeneration:o.ownerGeneration??Nt,reclaimOwnPid:!0,ownerToken:u}))return!0;if(s.now()>=f)return!1;await s.sleep(Math.min(a,f-s.now()))}}catch(m){return e.debug(`Unable to acquire CLI tool-selection profile lock: ${r(m)}`),!1}},release:()=>{vi(c,d,u)}}}function h(n=process.env){try{let o=p.readFileSync(O(n),"utf8").trim();if(o.length===0)return;if(!/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(o)){e.debug("Ignoring persisted CLI tool-selection profile because the file content is not a valid UUID");return}return o}catch(o){e.debug(`Unable to load the persisted CLI tool-selection profile: ${r(o)}`);return}}function V(n=process.env){let o=O(n),s=q.dirname(o);try{if(p.accessSync(s,p.constants.W_OK),p.existsSync(o)){if(!p.statSync(o).isFile())throw Error("profile path is not a regular file");p.accessSync(o,p.constants.W_OK)}}catch(a){throw new t(`CLI tool-selection profile store is not writable: ${o}. Fix its permissions or set AUTOMOBILE_DATA_DIR/AUTO_MOBILE_DATA_DIR to a writable directory so the CLI can persist a stable tool-selection profile across invocations.`,{cause:a})}}function G(n,o=process.env){let s=n.trim();if(s.length===0)return;let a;try{let l=O(o);if(a=`${l}.${process.pid}.${L.next()}.tmp`,p.writeFileSync(a,s,{encoding:"utf8",mode:384}),process.platform!=="win32")p.chmodSync(a,384);if(p.renameSync(a,l),a=void 0,process.platform!=="win32")p.chmodSync(l,384)}catch(l){if(e.debug(`Unable to persist the CLI tool-selection profile: ${r(l)}`),a)try{p.unlinkSync(a)}catch(c){e.debug(`Unable to remove incomplete CLI tool-selection profile: ${r(c)}`)}}}function xe(n){let o=n/60000;return`${o} ${o===1?"minute":"minutes"}`}function Z(n){if(typeof n==="string"&&n.trim()==="")throw new t("--session-uuid requires a non-empty value")}function ke(n){let o=yi(n[0]);if(o.flag!=="--session-uuid")return{sessionUuid:void 0,toolNameIndex:0};let s=o.inlineValue!==void 0,a=s?o.inlineValue:n[1],l=s?1:2;if(n.length<=l)throw new t("--session-uuid requires a value and a tool name");return Z(a),{sessionUuid:a,toolNameIndex:l}}function Ae(n){return K(n,F)}function z(n,o){return n&&Object.hasOwn(n,o)?n[o]:void 0}function K(n,o){if(n.length===0)throw new t("No tool name provided. Usage: --cli [--session-uuid <uuid>] <tool-name> [--param value ...]");let{sessionUuid:s,toolNameIndex:a}=ke(n),l=n[a],c=new Map,d=o(l);for(let u=a+1;u<n.length;u++){let f=n[u];if(!f.startsWith("--"))throw new t(`Invalid parameter format: ${f}. Parameters must start with --`);let{flag:m,inlineValue:D}=yi(f),b=m.slice(2).replace(/-([a-z])/g,(Qe,re)=>re.toUpperCase());if(D!==void 0){c.set(b,_(D,z(d,b)));continue}let w=n[u+1],oe=w!==void 0&&/^---(?:\s|$)/.test(w);if(w===void 0||w.startsWith("--")&&!oe)c.set(b,!0);else u++,c.set(b,_(w,z(d,b)))}return Z(c.get("sessionUuid")),{toolName:l,sessionUuid:s,params:Object.fromEntries(c)}}var Le=(n)=>new VE(n);async function $e(n,o){if(o===bt)return;if(N.getTool(o)?.hidden)return;let s=h();if(!s){await Me(n,o);return}await Ue(n,o,s)}async function Ue(n,o,s){let a;try{n.setToolSelectionProfileUuid?.(s),a=await n.callTool(bt,{toolName:o,enabled:!0,sessionUuid:s})}catch(f){e.debug(`CLI pre-enable of ${o} did not apply: ${r(f)}`);return}let l=Ff(a);if(!(a?.isError===!0||l===void 0||l!==s))return;if(n.setToolSelectionProfileUuid?.(void 0),e.debug(`CLI tool-selection profile ${s} is stale; re-minting a profile`),await I(async()=>{let f=h();if(f&&f!==s){if(await X(n,o,f))return;n.setToolSelectionProfileUuid?.(void 0)}await Q(n,o)}))return;let u=h();e.debug(`CLI pre-enable of ${o} skipped after a contended profile-lock timeout; ${u?"a profile is now persisted for the next invocation":"the next invocation will retry"}, and the tool call will surface any gate error.`)}async function Me(n,o){if(!await I(async()=>{let a=h();if(a){if(await X(n,o,a))return;n.setToolSelectionProfileUuid?.(void 0)}await Q(n,o)})){let a=h();e.debug(`CLI pre-enable of ${o} skipped after a contended profile-lock timeout; ${a?"a profile is now persisted for the next invocation":"the next invocation will retry"}, and the tool call will surface any gate error.`)}}async function X(n,o,s){try{n.setToolSelectionProfileUuid?.(s);let a=await n.callTool(bt,{toolName:o,enabled:!0,sessionUuid:s}),l=Ff(a);return a?.isError!==!0&&l!==void 0&&l===s}catch(a){return e.debug(`CLI pre-enable of ${o} did not apply: ${r(a)}`),!0}}async function Q(n,o){V();try{let s=await n.callTool(bt,{toolName:o,enabled:!0}),a=Ff(s);G(a??"")}catch(s){e.debug(`CLI pre-enable of ${o} did not apply: ${r(s)}`)}}async function Ne(n,o,s){let a=Le({daemonOptions:s,oneShotCli:!0,lifecycleNamespaceEnv:process.env});try{await $e(a,n);let l=await a.callTool(n,o);if(l===null)throw new t(`Daemon returned null result. This may indicate a daemon connectivity issue. Try: bunx ${Os()} --daemon restart`);return l}catch(l){if(l instanceof Qg||l instanceof ey||l instanceof ty)throw new t(`Daemon preflight failed; no device operation started. ${l.message}`);if(l instanceof fe)throw new t(`Daemon became unavailable during tool execution: ${l.message}. Try: auto-mobile --daemon restart`);if(l instanceof t)throw l;let c=r(l);throw new t(x(n,c,{gated:JN(l)}))}finally{if(n!=="listDevices")await a.adoptCliSessionLiveness();await a.close()}}function Re(){return`Usage: auto-mobile --cli doctor [options]
+
+Status: status-only and read-only diagnostics.
+
+Options:
+  --android  Filter to Android checks
+  --ios      Filter to iOS checks
+  --json     Machine-readable JSON output
+  --help     Print this help
+
+The universal --session-uuid option is accepted and ignored.`}function ee(n){if(Object.hasOwn(n,"repair")||Object.hasOwn(n,"timeoutMs"))return"doctor is status-only; --repair and --timeout-ms were removed. Use --daemon restart to recover the daemon; --daemon diagnose only gathers further diagnostics.";let o=["android","ios","json","help","sessionUuid"],s=Object.keys(n).filter((a)=>!o.includes(a)).map((a)=>`--${a.replace(/[A-Z]/g,(l)=>`-${l.toLowerCase()}`)}`);if(s.length>0)return`Unknown doctor flags: ${s.join(", ")}. Supported flags: --android, --ios, --json, --help (the universal --session-uuid option is accepted and ignored).`;return}function Fe(n){let o=ee(n);if(o!==void 0)throw new t(o)}function rn(n){let o;try{o=K(n,()=>null)}catch(s){return e.debug(`CLI bootstrap routing kept the normal path: ${r(s)}`),!1}if(o.toolName!=="doctor")return!1;return ee(o.params)!==void 0||Boolean(o.params.help)}async function Be(n,o={}){if(Fe(n),n.help){(o.writeOutput??console.log)(Re());return}let s=await import("./chunk-z2xznczw.js"),a=await(o.runDoctor??s.runDoctor)({android:n.android,ios:n.ios});if(n.json===!0)ne(a,"doctor");else(o.writeOutput??console.log)((o.formatConsoleOutput??s.formatConsoleOutput)(a,process.stdout.isTTY??!0));if(a.summary.failed>0)(o.exit??process.exit)(1);return}function te(n){let o=n;if(n&&typeof n==="object"&&"content"in n&&Array.isArray(n.content)){if(n.content.length>0&&n.content[0].type==="text")try{o=JSON.parse(n.content[0].text)}catch(s){e.debug(`CLI tool result is not JSON: ${r(s)}`),o=n}}return o}function He(n){return n?.isError===!0||te(n)?.success===!1}var je={stdout:H,stderr:j};function We(){try{return new sM({outputDirectory:M.getToolOutputsDir()??Lf(),retention:s1})}catch(n){e.debug(`[cli] no tool-output artifact writer available: ${r(n)}`);return}}function ne(n,o){je.stdout.write(B(n,{tool:o,artifactWriter:We()})+`
+`)}function Je(n){if(!n||typeof n!=="object")return n;let{message:o,nextAction:s}=n;if(typeof o!=="string")return n;return typeof s==="string"?`${o}
+Next: ${s}`:o}function qe(n,o){ne(n,o);let s=te(n);if(He(n)){if(s&&typeof s==="object"&&s.error)console.error(Je(s.error));else if(n?.isError===!0&&Array.isArray(n.content)&&n.content[0]?.type==="text")console.error(n.content[0].text);Ve(s,o);let a=J(s,o);if(a)console.error(a);process.exit(1)}}function Ve(n,o){if(o==="executePlan"&&n&&typeof n==="object"&&typeof n.executedSteps==="number"&&typeof n.totalSteps==="number"){if(console.error(`Executed ${n.executedSteps} of ${n.totalSteps} steps`),n.failedStep)console.error(`Failed at step ${n.failedStep.stepIndex+1}: ${n.failedStep.tool}`),console.error(`Step error: ${n.failedStep.error}`)}}async function sn(n,o,s=console){try{if(n.length===0){T(),Y(s);return}if(n[0]==="help"||n[0]==="--help"||n[0]==="-h"){if(T(),n.length>1)Ge(n[1],s);else Y(s);return}let{toolName:a,sessionUuid:l,params:c}=Ae(n);if(l)if(Fr(a))e.debug(`Ignoring session UUID for acquisition tool ${a}: it mints its own`);else c.sessionUuid=l,e.debug(`Using session UUID: ${l}`);if(a==="doctor")return await Be(c);e.debug(`Executing tool via daemon: ${a}`);let d=await Ne(a,c,o);qe(d,a)}catch(a){if(a instanceof t)e.error(`CLI Error: ${a.message}`),console.error(`Error: ${a.message}`);else e.error(`Unexpected CLI Error: ${a}`),console.error(`Unexpected error: ${a}`);process.exit(1)}}function Y(n){let o=N.getAllTools(),s=Os();n.log(`
+AutoMobile CLI - Android Device Automation
+
+Usage:
+  bunx ${s} --cli [--session-uuid <uuid>] <tool-name> [--param value ...]
+  bunx ${s} --cli help [tool-name]
+  bunx ${s} --ios-templates build --runtime <identifier> --device-type <identifier>
+  bunx ${s} --ios-templates clean (--all | --stale | --runtime <identifier> [--device-type <identifier>]) [--force]
+
+Examples:
+  bunx ${s} --cli listDeviceImages
+  bunx ${s} --cli observe
+  bunx ${s} --cli tapOn --selector '{"text":"Submit"}'
+  bunx ${s} --cli getAndroid --avd-name "pixel_7_api_34"
+  bunx ${s} --cli getApple --udid "SIMULATOR-UDID"
+  bunx ${s} --cli --session-uuid abc-123-uuid observe
+  bunx ${s} --cli --session-uuid $SESSION_UUID tapOn --selector '{"text":"Submit"}'
+
+Options:
+  help [tool-name]              Show help for a specific tool
+  --session-uuid <uuid>         Associate tool execution with a session (optional).
+                                The CLI omits it for acquisition tools
+                                (${WE.join(", ")}), which mint
+                                their own session. For other tools, an undeclared
+                                sessionUuid is removed before strict validation.
+
+Parameters:
+  Parameters are passed as --key value pairs
+  Values are converted using the tool's declared parameter type
+  Strings: --text 12345 stays the string "12345"
+  Boolean values: --flag true or --flag false
+  Numbers: --count 5
+  Objects: --options '{"key": "value"}'
+  Unknown tools or parameters fall back to JSON-if-possible, otherwise string
+
+Session-based Execution:
+  When using --session-uuid, the tool will be executed on the device assigned to that session.
+  This allows multiple tool calls to target the same device in parallel.
+  A session acquired or used from the CLI is held on a wall-clock idle timeout
+  (${xe(cL)} by default; override with
+  AUTOMOBILE_CLI_SESSION_IDLE_TIMEOUT_MS) rather than the
+  heartbeat contract a long-running MCP connection keeps, so it survives the gap
+  between one-shot invocations. Every control call refreshes it; reads do not.
+
+Device ownership:
+  A device a session holds takes control calls only from that session. A control
+  call without --session-uuid (or with another session's) on a held device is
+  refused with code device_owned_by_other_session. Pass the sessionUuid that
+  getAndroid, getApple or startDevice returned, or wait for the holder to release
+  the device. Reads need no session and are allowed on any device: observe, hitTest,
+  identifyInteractions, listApps, getDeviceState, a read-only sqlQuery, and the read
+  forms of keyboard, clipboard, displayConfig, accessibility and prototype. A read
+  never counts as use. killDevice and deleteDevice also accept --force true to stop
+  a held device.
+`);let a=new Map,l=["setActiveDevice","listDevices","listDeviceImages","getAndroid","getApple","killDevice","checkRunningDevices"],c=["changeLocalization"];o.forEach((d)=>{let u="General";if(c.includes(d.name))u="System Configuration";else if(l.includes(d.name))u="Device Management";else if(d.name.includes("App")||d.name.includes("app"))u="App Management";else if(d.name.startsWith("assert"))u="Assertions";else if(d.name.includes("observe"))u="Observation";else if(d.name.includes("Plan")||d.name.includes("plan"))u="Plan Management";else u="Interactions";if(!a.has(u))a.set(u,[]);a.get(u).push(d)}),n.log(`
+Available Tools:`),n.log("================"),a.forEach((d,u)=>{n.log(`
+${u}:`),d.forEach((f)=>{n.log(`  ${f.name.padEnd(25)} - ${f.description}`)})}),n.log(`
+Total: ${o.length} tools available`),n.log(`
+Use 'bunx ${s} --cli help <tool-name>' for detailed information about a specific tool.`)}function Ge(n,o){let s=Os(),a=N.getTool(n);if(!a){o.error(`Unknown tool: ${n}`),o.log(`
+Use 'bunx ${s} --cli help' to see available tools.`);return}if(o.log(`
+Tool: ${a.name}`),o.log("=".repeat(a.name.length+6)),o.log(`Description: ${a.description}`),a.supportsProgress)o.log("Supports: Progress notifications");o.log(`
+Parameters:`),o.log(`  Pass objects and arrays as JSON, e.g. --selector '{"text":"Submit"}'.`);try{let l=ze(a.schema);if(l)Object.entries(l).forEach(([c,d])=>{let u=Ye(d);if(o.log(`  --${c} ${u.isOptional?"(optional)":"(required)"}`),o.log(`    Type: ${u.typeName}`),u.description)o.log(`    Description: ${u.description}`)});else o.log("  No parameters required")}catch(l){e.debug(`CLI parameter schema help unavailable: ${r(l)}`),o.log("  Could not parse parameter schema")}o.log(`
+Example usage:`),o.log(`  bunx ${s} --cli ${n} [parameters...]`)}function ze(n){let o=n?._def;if(!o)return;if(o.shape)return o.shape;if(o.type==="pipe"&&o.out?._def?.shape)return o.out._def.shape;return}function Ye(n){let o=Ze(n),s=o?n?._def?.innerType??n:n,a=s?._def?.typeName??s?._def?.type??"unknown",l=String(a).replace(/^Zod/,"").toLowerCase(),c=["union","intersection","object","record","array","enum","literal","nullable"].includes(l)?S(Tb(s,{io:"input"})):l;return{isOptional:o,typeName:c,description:Ke(n,s)}}function Ze(n){return typeof n?.isOptional==="function"?n.isOptional():n?._def?.typeName==="ZodOptional"}function Ke(n,o){return n?.description??o?.description??o?._def?.description}function S(n){if(n.not&&Object.keys(n.not).length===0)return"never";if(n.allOf)return n.allOf.map((s)=>"("+S(s)+")").join(" & ");let o=n.anyOf??n.oneOf;if(o)return o.map((s)=>S(s)).join(" | ");if("const"in n)return JSON.stringify(n.const);if(n.enum)return n.enum.map((s)=>JSON.stringify(s)).join(" | ");if(n.type==="object")return Xe(n);if(n.type==="array")return"("+S(n.items??{})+")[] (JSON)";return n.type??"any"}function Xe(n){let o=Object.entries(n.properties??{}).map(([s,a])=>JSON.stringify(s)+(n.required?.includes(s)?"":"?")+": "+S(a));if(n.additionalProperties){let s=n.additionalProperties===!0?"any":S(n.additionalProperties);o.push("[key: string]: "+s)}return"JSON { "+o.join(", ")+" }"}export{rn as cliCommandSkipsServerBootstrap,sn as runCliCommand};
+
+//# debugId=55AD7D69952A9F9864756E2164756E21

package/dist/src/chunk-2v7tw1nj.js

@@ -0,0 +1,5 @@
+// @bun
+var d=Object.create;var{getPrototypeOf:a,defineProperty:s,getOwnPropertyNames:T}=Object;var l=Object.prototype.hasOwnProperty;function f(n){return this[n]}var y,m,Lt=(n,r,e)=>{var o=n!=null&&typeof n==="object";if(o){var u=r?y??=new WeakMap:m??=new WeakMap,c=u.get(n);if(c)return c}e=n!=null?d(a(n)):{};let t=r||!n||!n.__esModule||!l.call(n,"default")?s(e,"default",{value:n,enumerable:!0}):e;if(n&&typeof n==="object"||typeof n==="function"){for(let i of T(n))if(!l.call(t,i))s(t,i,{get:f.bind(n,i),enumerable:!0})}if(o)u.set(n,t);return t};var O=(n,r)=>()=>(r||n((r={exports:{}}).exports,r),r.exports);var x=(n)=>n;function g(n,r){this[n]=x.bind(null,r)}var de=(n,r)=>{for(var e in r)s(n,e,{get:r[e],enumerable:!0,configurable:!0,set:g.bind(r,e)})};var vt=import.meta.require;function UY(n){let r=n.findIndex((o)=>o==="--cli"||o==="--daemon"),e=r>=0?n.slice(0,r):n;return e.includes("--version")||e.includes("-v")}function aoe(n,r){return UY(n)?r:void 0}function Pl(n,r){try{return n()}catch(e){return r(e)}}async function coe(n,r){try{return await n()}catch(e){return r(e)}}
+export{Lt,O,de,vt,UY,aoe,Pl,coe};
+
+//# debugId=428AE3BC4E8FE3BA64756E2164756E21