agent-device 0.16.5 → 0.16.6

package/dist/src/lease.js

@@ -0,0 +1 @@
+import{INTERNAL_COMMANDS as e}from"./5792.js";import{resolveLeaseScope as a}from"./2415.js";let t={[e.leaseAllocate]:!0,[e.leaseHeartbeat]:!0,[e.leaseRelease]:!0};async function l(e){let{req:t,leaseRegistry:l}=e,s=a(t);switch(t.command){case"lease_allocate":return{ok:!0,data:{lease:l.allocateLease({tenantId:s.tenantId??"",runId:s.runId??"",backend:s.leaseBackend,ttlMs:s.leaseTtlMs})}};case"lease_heartbeat":return{ok:!0,data:{lease:l.heartbeatLease({leaseId:s.leaseId??"",tenantId:s.tenantId,runId:s.runId,ttlMs:s.leaseTtlMs})}};case"lease_release":return{ok:!0,data:l.releaseLease({leaseId:s.leaseId??"",tenantId:s.tenantId,runId:s.runId})};default:return null}}export{t as LEASE_COMMAND_HANDLERS,l as handleLeaseCommands};

package/dist/src/linux.js

@@ -0,0 +1 @@
+import{longPressLinux as t,pressLinux as e,typeLinux as n,scrollLinux as o,sendKey as r,fillLinux as a,focusLinux as i,swipeLinux as s,doubleClickLinux as p}from"./input-actions~1.js";import{snapshotLinux as u,resolveLinuxToolProvider as c}from"./2415.js";import{AppError as w}from"./9152.js";import{withDiagnosticTimer as _}from"./7599.js";async function P(t){await c().desktop.openTarget(t)}async function d(t){await c().desktop.closeApp(t)}async function O(){await r("alt+Left",["56:1","105:1","105:0","56:0"])}async function f(){await r("super+d",["125:1","32:1","32:0","125:0"])}async function l(){return await c().clipboard.readText()}async function S(t){await c().clipboard.writeText(t)}async function E(t,e){await c().screenshot.capture(t,e)}function N(){return{open:t=>P(t),openDevice:()=>Promise.resolve(),close:t=>d(t),tap:(t,n)=>e(t,n),doubleTap:(t,e)=>p(t,e),swipe:(t,e,n,o,r)=>s(t,e,n,o,r),pan:(t,e,n,o,r)=>s(t,e,n,o,r),fling:()=>{throw new w("UNSUPPORTED_OPERATION","gesture fling not supported on Linux")},longPress:(e,n,o)=>t(e,n,o),focus:(t,e)=>i(t,e),type:(t,e)=>n(t,e),fill:(t,e,n,o)=>a(t,e,n,o),scroll:(t,e)=>o(t,e),pinch:()=>{throw new w("UNSUPPORTED_OPERATION","gesture pinch not supported on Linux")},screenshot:(t,e)=>E(t,e),snapshot:async t=>{let e=await _("snapshot_capture",async()=>await u(t?.surface),{backend:"linux-atspi"});return{nodes:e.nodes??[],truncated:e.truncated??!1,backend:"linux-atspi"}},back:()=>O(),home:()=>f(),rotate:()=>{throw new w("UNSUPPORTED_OPERATION","rotate not supported on Linux")},rotateGesture:()=>{throw new w("UNSUPPORTED_OPERATION","gesture rotate not supported on Linux")},transformGesture:()=>{throw new w("UNSUPPORTED_OPERATION","gesture transform not supported on Linux")},appSwitcher:()=>{throw new w("UNSUPPORTED_OPERATION","appSwitcher not yet supported on Linux")},readClipboard:()=>l(),writeClipboard:t=>S(t),setSetting:()=>{throw new w("UNSUPPORTED_OPERATION","setSetting not supported on Linux")}}}export{N as createLinuxInteractor};

package/dist/src/notifications.js

@@ -0,0 +1 @@
+import{AppError as e}from"./9152.js";import{runAndroidAdb as r}from"./8806.js";async function t(t,o,i){let n="string"==typeof i.action&&i.action.trim()?i.action.trim():`${o}.TEST_PUSH`,s=["shell","am","broadcast","-a",n,"-p",o],a="string"==typeof i.receiver?i.receiver.trim():"";a&&s.push("-n",a);let p=i.extras;if(void 0!==p&&("object"!=typeof p||null===p||Array.isArray(p)))throw new e("INVALID_ARGS","Android push payload extras must be an object");let u=0;for(let[r,t]of Object.entries(p??{}))r&&(function(r,t,o){if("string"==typeof o)return r.push("--es",t,o);if("boolean"==typeof o)return r.push("--ez",t,o?"true":"false");if("number"==typeof o&&Number.isFinite(o))return Number.isInteger(o)?r.push("--ei",t,String(o)):r.push("--ef",t,String(o));throw new e("INVALID_ARGS",`Unsupported Android broadcast extra type for "${t}". Use string, boolean, or number.`)}(s,r,t),u+=1);return await r(t,s),{action:n,extrasCount:u}}export{t as pushAndroidNotification};

package/dist/src/react-native.js

@@ -0,0 +1 @@
+import{dispatchCommand as e,errorResponse as t,isCommandSupportedOnDevice as i}from"./2415.js";import{PUBLIC_COMMANDS as o}from"./5792.js";import{normalizeError as n}from"./9152.js";import{interaction_snapshot_captureSnapshotForSession as a,readSnapshotNodesReferenceFrame as r,finalizeTouchInteraction as s}from"./9471.js";import{resolveReactNativeOverlayDismissTarget as c,detectReactNativeOverlay as d}from"./9533.js";import{successText as l}from"./1998.js";let _={[o.reactNative]:!0};async function m(e){var r,s;let{req:_,sessionName:m,sessionStore:f}=e;if(_.command!==o.reactNative)return null;let p=1===(r=_.positionals??[]).length&&"dismiss-overlay"===r[0]?{ok:!0}:{ok:!1,response:t("INVALID_ARGS","react-native supports only: dismiss-overlay")};if(!p.ok)return p.response;let u=f.get(m);if(!u)return t("SESSION_NOT_FOUND","No active session. Run open first.");if(!i(o.reactNative,u.device))return t("UNSUPPORTED_OPERATION","react-native dismiss-overlay is not supported on this device");try{let i=await a(u,_.flags,f,e.contextFromFlags,{interactiveOnly:!0}),o=c(i.nodes);if(!o){return s=i,d(s.nodes).detected?t("COMMAND_FAILED","React Native overlay detected, but no safe dismiss target was found",{hint:"Use screenshot --overlay-refs for visual evidence and report the overlay instead of pressing the warning body."}):{ok:!0,data:{action:"dismiss-overlay",detected:!1,dismissed:!1,...l("No React Native overlay detected")}}}return await v(e,u,i,o)}catch(e){return{ok:!1,error:n(e)}}}async function v(t,i,o,n){let{req:a,sessionStore:c}=t,d=Date.now(),_=await e(i.device,"press",[String(n.point.x),String(n.point.y)],a.flags?.out,t.contextFromFlags(a.flags,i.appBundleId,i.trace?.outPath))??{},m=Date.now(),v={...r(o.nodes),..._,action:"dismiss-overlay",overlayAction:n.action,x:n.point.x,y:n.point.y,...n.ref?{ref:n.ref}:{},...n.label?{label:n.label}:{},...n.warning?{warning:n.warning}:{},dismissed:!0,verified:!1,verificationRequired:!0,nextCommand:"agent-device snapshot -i -c",...l("minimize"===n.action?"React Native RedBox minimize action sent; run snapshot -i before continuing":"React Native overlay dismiss action sent; run snapshot -i before continuing")};return s({session:i,sessionStore:c,command:a.command,positionals:a.positionals??[],flags:a.flags,result:v,responseData:v,actionStartedAt:d,actionFinishedAt:m})}export{_ as REACT_NATIVE_COMMAND_HANDLERS,m as handleReactNativeCommands};

package/dist/src/record-trace.js

@@ -0,0 +1,26 @@
+let e,t,r,a;import{__webpack_require__ as i}from"./rslib-runtime.js";import o from"node:fs";import n from"node:path";import{createHash as s}from"node:crypto";import c from"node:os";import{setTimeout as d}from"node:timers/promises";import{fileURLToPath as l}from"node:url";import{AppError as u}from"./9152.js";import{runCmd as m}from"./9818.js";import{sleep as f}from"./4829.js";import{withDiagnosticTimer as p,emitDiagnostic as h}from"./7599.js";import{androidDeviceForSerial as w,runAndroidAdb as g}from"./8806.js";import{pullAndroidAdbFile as y}from"./9639.js";import{runXcrun as _,SessionStore as v,runIosRunnerCommand as P,errorResponse as S,isCommandSupportedOnDevice as A,ensureDeviceReady as C,resolveTargetDevice as b,IOS_RUNNER_CONTAINER_BUNDLE_IDS as M}from"./2415.js";import{resolveRecordingProvider as I}from"./recording-provider.js";import{PUBLIC_COMMANDS as x}from"./5792.js";var D={};function R(e=process.env){let t=$(),r=n.join(t,"home"),a=n.join(t,"module-cache");return o.mkdirSync(r,{recursive:!0}),o.mkdirSync(a,{recursive:!0}),{...e,HOME:r,CLANG_MODULE_CACHE_PATH:a}}async function N(e){let t=o.statSync(e.sourcePath),r=o.readFileSync(e.sourcePath),a=L(e.cacheName??n.basename(e.sourcePath,n.extname(e.sourcePath))),i=T(["2",process.platform,process.arch,n.resolve(e.sourcePath),t.size,r]),s=n.join($(),"bin",`${a}-${i}`);return await F({sourcePath:e.sourcePath,executablePath:s,timeoutMs:e.timeoutMs}),s}async function E(e){let t=L(e.cacheName),r=T(["2",process.platform,process.arch,e.source]),a=n.join($(),"sources",`${t}-${r}.swift`),i=n.join($(),"bin",`${t}-${r}`);return await F({sourcePath:a,executablePath:i,sourceText:e.source,timeoutMs:e.timeoutMs}),i}function $(){let e=process.env.AGENT_DEVICE_SWIFT_CACHE_DIR?.trim();return e?n.resolve(e):n.join(c.tmpdir(),"agent-device-swift-cache")}async function F(e){if(O(e.executablePath))return;let t=n.dirname(e.executablePath);o.mkdirSync(t,{recursive:!0});let r=`${e.executablePath}.lock`;if(!await k(r,e.executablePath,e.timeoutMs??12e4))return;let a=o.mkdtempSync(n.join(t,`.${n.basename(e.executablePath)}.${process.pid}.`)),i=n.join(a,n.basename(e.executablePath));try{if(O(e.executablePath))return;void 0===e.sourceText||o.existsSync(e.sourcePath)||(o.mkdirSync(n.dirname(e.sourcePath),{recursive:!0}),o.writeFileSync(e.sourcePath,e.sourceText)),await m("xcrun",["swiftc",e.sourcePath,"-o",i],{timeoutMs:e.timeoutMs??12e4,env:R()}),o.renameSync(i,e.executablePath)}finally{o.rmSync(a,{recursive:!0,force:!0}),o.rmSync(r,{recursive:!0,force:!0})}}async function k(e,t,r){let a=Date.now()+r;for(;;){if(O(t))return!1;try{return o.mkdirSync(e),!0}catch(t){if("EEXIST"!==t.code)throw t;if(function(e,t){try{return Date.now()-o.statSync(e).mtimeMs>=t}catch{return!1}}(e,r)){o.rmSync(e,{recursive:!0,force:!0});continue}if(Date.now()>=a)throw new u("COMMAND_FAILED",`Timed out waiting for Swift cache lock: ${e} (${r}ms)`,{lockDir:e,timeoutMs:r,hint:`Another agent-device process may still be compiling this Swift helper. Retry shortly; if no agent-device process is active, remove "${e}" and retry.`});await d(25)}}}function O(e){try{return o.accessSync(e,o.constants.X_OK),o.statSync(e).isFile()}catch{return!1}}function L(e){return e.replaceAll(/[^A-Za-z0-9._-]/g,"-").replaceAll(/^-+|-+$/g,"")||"swift-helper"}function T(e){let t=s("sha256");for(let r of e)t.update(Buffer.isBuffer(r)?r:String(r)),t.update("\0");return t.digest("hex").slice(0,16)}i.r(D),i.d(D,{RECORD_TRACE_COMMAND_HANDLERS:()=>eX,handleRecordTraceCommands:()=>eJ});let U=`
+import Foundation
+import AVFoundation
+
+let url = URL(fileURLWithPath: CommandLine.arguments[1])
+let asset = AVURLAsset(url: url)
+let semaphore = DispatchSemaphore(value: 0)
+var exitCode: Int32 = 1
+
+Task {
+  defer { semaphore.signal() }
+  do {
+    let playable = try await asset.load(.isPlayable)
+    let duration = try await asset.load(.duration)
+    if playable && duration.isValid && !duration.isIndefinite && CMTimeGetSeconds(duration) > 0 {
+      exitCode = 0
+    }
+  } catch {
+    exitCode = 1
+  }
+}
+
+semaphore.wait()
+exit(exitCode)
+`.trim();async function K(e,t={}){let r,a=t.pollMs??150,i=t.attempts??12,n=0;for(let t=0;t<i;t+=1){let t=0;try{t=o.statSync(e).size}catch{t=0}if(t>0&&t===r){if((n+=1)>=2)return}else n=0;r=t,await f(a)}}async function z(e){try{let t=await q(),r=await m(t,[e],{allowFailure:!0,timeoutMs:1e4,env:R()});if(0===r.exitCode)return!0;if(G(r.stderr,r.stdout))return H(e);return!1}catch(r){var t;if((t=r)instanceof u&&("TOOL_MISSING"===t.code||G(String(t.details?.stderr??""),String(t.details?.stdout??""))))return H(e);throw r}}async function q(){e??=E({source:U,cacheName:"video-validator",timeoutMs:3e4});try{return await e}catch(t){throw e=void 0,t}}async function V(e,t={}){let r=t.pollMs??150,a=t.attempts??12;for(let t=0;t<a;t+=1){if(await z(e))return;await f(r)}}function G(e,t){let r=`${e}
+${t}`;return/\b(no such module ['"]AVFoundation['"]|unable to find utility ["']swiftc?["']|xcrun: error: unable to find utility ["']swiftc?["'])\b/i.test(r)}function H(e){try{let t=o.statSync(e);if(!t.isFile()||t.size<=0)return!1}catch{return!1}let t=function(e){try{let t=o.openSync(e,"r");try{let e=o.fstatSync(t).size,r=0,a=[];for(;r+8<=e&&a.length<16;){let e=Buffer.alloc(8);if(8>o.readSync(t,e,0,8,r))break;let i=e.readUInt32BE(0),n=e.toString("latin1",4,8);if(a.push(n),1===i){let e=Buffer.alloc(8);if(8>o.readSync(t,e,0,8,r+8))break;i=Number(e.readBigUInt64BE(0))}if(!Number.isFinite(i)||i<=0)break;r+=i}return a}finally{o.closeSync(t)}}catch{return[]}}(e);return t.includes("ftyp")&&t.includes("moov")}function j(e){let t=n.parse(e);return n.join(t.dir,`${t.name}.gesture-telemetry.json`)}function B(e){return[...e].sort((e,t)=>e.tMs-t.tMs)}function W(e){var t,r,a;let i,n,{recording:s,trimStartMs:c}=e,d=(i=j((t={videoPath:s.outPath,events:s.gestureEvents,trimStartMs:c}).videoPath),n={version:1,generatedAt:new Date().toISOString(),events:(r=t.events,(a=t.trimStartMs??0)>0?B(r.flatMap(e=>{let t=e.tMs-a,r="durationMs"in e?e.durationMs:void 0;return("number"==typeof r?t+r:t)<=0?[]:[{...e,tMs:Math.max(0,t)}]})):B(r))},o.writeFileSync(i,JSON.stringify(n,null,2)),i);return s.telemetryPath=d,d}function X(e){let t=n.dirname(l(import.meta.url)),r=[l(new URL(`./${e}`,import.meta.url)),n.resolve(t,`../../ios-runner/AgentDeviceRunner/RecordingScripts/${e}`),n.resolve(t,`../../../ios-runner/AgentDeviceRunner/RecordingScripts/${e}`),n.resolve(process.cwd(),`ios-runner/AgentDeviceRunner/RecordingScripts/${e}`)];for(let e of r)if(o.existsSync(e))return e;throw new u("COMMAND_FAILED",`Missing recording helper script: ${e}`,{hint:"Ensure ios-runner/AgentDeviceRunner/RecordingScripts is present in this checkout or bundled with the package.",scriptName:e,searchedPaths:r})}async function J(e){var t;let r,a,{videoPath:i,scriptPath:s,scriptArgs:c,commandDescription:d}=e;await K(i),await V(i);let l=(t=i,r=n.parse(t),a=`${process.pid}-${Date.now()}-${Math.random().toString(16).slice(2)}`,n.join(r.dir,`.${r.name}.agent-device-${a}${r.ext||".mp4"}`));try{let e=await N({sourcePath:s});await m(e,["--input",i,"--output",l,...c],{timeoutMs:12e4,env:R()}),await V(l),o.renameSync(l,i)}catch(t){let e=t instanceof u?t:new u("COMMAND_FAILED",String(t),void 0,t instanceof Error?t:void 0);throw new u("COMMAND_FAILED",d,{...e.details,videoPath:i,script:s},e)}finally{o.rmSync(l,{force:!0})}}async function Z(e){let{videoPath:t,trimStartMs:a}=e;a>0&&await J({videoPath:t,scriptPath:r??=X("recording-trim.swift"),scriptArgs:["--trim-start-ms",String(a)],commandDescription:"Failed to trim the start of the iOS recording"})}async function Q(e){let{videoPath:r,telemetryPath:a,targetLabel:i="recording"}=e;await J({videoPath:r,scriptPath:t??=X("recording-overlay.swift"),scriptArgs:["--events",a],commandDescription:`Failed to add touch overlays to the ${i}`})}async function Y(e){let{videoPath:t,quality:r,targetLabel:i="recording"}=e;await J({videoPath:t,scriptPath:a??=X("recording-resize.swift"),scriptArgs:["--quality",String(r)],commandDescription:`Failed to resize the ${i}`})}function ee(e){return e instanceof Error?e.message:String(e)}function et(e,t){return e.stderr.trim()||e.stdout.trim()||`${t} exited with code ${e.exitCode}`}async function er(e){let{recording:t,deps:r,trimStartMs:a,targetLabel:i}=e,o=W({recording:t,trimStartMs:a});if(!t.showTouches)return void h({level:"debug",phase:"record_stop_overlay_skipped",data:{reason:"hide_touches"}});if(0===t.gestureEvents.length)return void h({level:"debug",phase:"record_stop_overlay_skipped",data:{reason:"no_gesture_events"}});let n=function(e=process.platform){if("darwin"!==e)return"touch overlay burn-in is only available on macOS hosts; returning raw video plus gesture telemetry"}();if(n){t.overlayWarning??=n;return}try{await p("record_stop_overlay_export",()=>r.overlayRecordingTouches({videoPath:t.outPath,telemetryPath:o,targetLabel:i}),{targetLabel:i,gestureEventCount:t.gestureEvents.length})}catch(e){t.overlayWarning??=`failed to overlay recording touches: ${ee(e)}`}}function ea(e,t){if(1===t)return e;let r=n.parse(e),a=r.ext||".mp4";return n.join(r.dir,`${r.name}.part-${String(t).padStart(3,"0")}${a}`)}function ei(e){return e.chunks??=[{index:1,path:e.outPath,remotePath:e.remotePath}],e.chunks}async function eo(e){let{recording:t,startNextChunk:r,finishCurrentChunk:a}=e;if(t.stopping)return;let i=await a();if(i)throw Error(i);if(t.stopping)return;let o=ei(t),s=o.length+1,c=await r(n.posix.dirname(t.remotePath));t.remotePath=c.remotePath,t.remotePid=c.remotePid,o.push({index:s,path:ea(t.outPath,s),remotePath:c.remotePath}),t.warning??="Android adb screenrecord is capped at 180s, so this recording was split into multiple MP4 chunks."}async function en(e){let{recording:t,deps:r}=e;ei(t).length<=1?await er({recording:t,deps:r,targetLabel:"Android recording"}):(W({recording:t}),t.showTouches&&t.gestureEvents.length>0&&(t.overlayWarning??="touch overlay burn-in is skipped for chunked Android recordings; returning raw chunks plus gesture telemetry"))}async function es(e){for(let t of e.chunks){let r=await ec({deps:e.deps,deviceId:e.deviceId,remotePath:t.remotePath,outPath:t.path});if(r)return`failed to copy recording chunk ${t.index}: ${r}`}}async function ec(e){let t,{deps:r,deviceId:a,remotePath:i,outPath:n}=e;for(let e=0;e<2;e+=1){try{o.rmSync(n,{force:!0})}catch{}let s=w(a),c=await y(i,n,{allowFailure:!0,device:s});if(0!==c.exitCode)t=et(c,"adb pull");else{await r.waitForStableFile(n,{pollMs:250,attempts:20});let t=await r.isPlayableVideo(n);if(h({level:"debug",phase:"record_stop_android_pull_validation",data:{deviceId:a,remotePath:i,outPath:n,attempt:e+1,fileSize:function(e){try{return o.statSync(e).size}catch{return 0}}(n),playable:t}}),t)return;h({level:"warn",phase:"record_stop_android_invalid_video_retry",data:{deviceId:a,remotePath:i,outPath:n,attempt:e+1}})}e<1&&await f(750)}return t?`failed to copy recording from device: ${t}`:"failed to copy recording from device: pulled file is not a playable MP4"}async function ed(e,t,r){return await g(w(e),t,r)}async function el(e,t){let r=await ed(e,["shell","ps","-o","pid=","-p",t],{allowFailure:!0});return 0===r.exitCode&&r.stdout.split(/\s+/).map(e=>e.trim()).includes(t)}async function eu(e,t){for(let r=0;r<40;r+=1){if(!await el(e,t))return!0;await f(250)}return!await el(e,t)}async function em(e,t){let r,a=0;for(let i=0;i<20;i+=1){let i=await ed(e,["shell","stat","-c","%s",t],{allowFailure:!0}),o=0===i.exitCode?i.stdout.trim():"";if(o.length>0&&o===r){if((a+=1)>=4)return}else a=0;r=o,await f(250)}}async function ef(e,t,r){for(let a=0;a<8;a+=1){let i=await ed(e,["shell","stat","-c","%s",t],{allowFailure:!0}),o=0===i.exitCode?Number(i.stdout.trim()):NaN;if(Number.isFinite(o)&&o>0)return!0;if(!await el(e,r))break;if(a+1>=2)return!0;await f(250)}return!1}async function ep(e){let{deviceId:t,quality:r}=e;if(void 0===r||r>=10)return;let a=await ed(t,["shell","wm","size"],{allowFailure:!0}),i=a.stdout.match(/Override size:\s*(\d+)x(\d+)/)??a.stdout.match(/Physical size:\s*(\d+)x(\d+)/);if(0!==a.exitCode||!i)throw Error(`failed to resolve Android screen size for recording quality: ${et(a,"adb shell wm size")}`);return{width:eh(Number(i[1]),r),height:eh(Number(i[2]),r)}}function eh(e,t){return Math.max(2,2*Math.round(e*t/10/2))}async function ew(e,t){await ed(e,["shell","rm","-f",t],{allowFailure:!0})}async function eg(e,t){let r=await ed(e,["shell","kill","-9",t],{allowFailure:!0});return h({level:"warn",phase:"record_stop_android_force_signal",data:{deviceId:e,remotePid:t,exitCode:r.exitCode,stdout:r.stdout.trim(),stderr:r.stderr.trim()}}),!(0!==r.exitCode&&await el(e,t))&&await eu(e,t)}async function ey(e){var t;let r,a,{device:i,recordingSize:o,preferredRemoteDir:n}=e,s="failed to start recording: Android screenrecord did not begin producing frames";for(let e of(t=Date.now(),r=`agent-device-recording-${t}.mp4`,a=["/sdcard","/data/local/tmp"],(n&&a.includes(n)?[n,...a.filter(e=>e!==n)]:a).map(e=>`${e}/${r}`))){let t=await ed(i.id,["shell",function(e,t){let r=["screenrecord"];return t&&r.push("--size",`${t.width}x${t.height}`),r.push(e),`${r.join(" ")} >/dev/null 2>&1 & echo $!`}(e,o)],{allowFailure:!0});if(0!==t.exitCode){s=`failed to start recording: ${et(t,"adb shell screenrecord")}`;continue}let r=t.stdout.split(/\r?\n/).map(e=>e.trim()).filter(e=>/^\d+$/.test(e)).at(-1);if(!r){s="failed to start recording: adb did not return a valid Android screenrecord pid",await ew(i.id,e);continue}if(h({level:"debug",phase:"record_start_android_started",data:{deviceId:i.id,remotePath:e,remotePid:r}}),await ef(i.id,e,r))return{remotePath:e,remotePid:r,startedAt:Date.now()};s="failed to start recording: Android screenrecord did not begin producing frames",await eg(i.id,r),await ew(i.id,e)}return{error:S("COMMAND_FAILED",s)}}async function e_(e){let t,{device:r,recordingBase:a}=e;try{t=await ep({deviceId:r.id,quality:a.quality})}catch(e){return S("COMMAND_FAILED",e instanceof Error?e.message:String(e))}let i=await ey({device:r,recordingSize:t});if("error"in i)return i.error;let o={platform:"android",remotePath:i.remotePath,remotePid:i.remotePid,chunks:[{index:1,path:a.outPath,remotePath:i.remotePath}],...a,startedAt:i.startedAt};return!function e(t){let{recording:r,startNextChunk:a,finishCurrentChunk:i}=t,o=setTimeout(()=>{r.rotationPromise=eo({recording:r,startNextChunk:a,finishCurrentChunk:i}).catch(e=>{r.rotationFailedReason=e instanceof Error?e.message:String(e)}).finally(()=>{r.rotationPromise=void 0,r.stopping||r.rotationFailedReason||e({recording:r,startNextChunk:a,finishCurrentChunk:i})})},17e4);o.unref?.(),r.rotationTimer=o}({recording:o,finishCurrentChunk:async()=>await ev({device:r,recording:o,waitForRemoteFileStability:!1}),startNextChunk:async e=>{let a=await ey({device:r,recordingSize:t,preferredRemoteDir:e});if("error"in a)throw Error(a.error.ok?"failed to start next Android recording chunk":a.error.error.message);return a}}),o}async function ev(e){let{device:t,recording:r,waitForRemoteFileStability:a=!0}=e;await el(t.id,r.remotePid)||(r.warning??=function(e){if(!(Date.now()-e.startedAt<178e3))return"Android adb screenrecord stopped before record stop, likely after reaching the 180s platform limit. The MP4 may be truncated; final interactions after the limit are not in the video."}(r));let i=await ed(t.id,["shell","kill","-2",r.remotePid],{allowFailure:!0});if(h({level:"debug",phase:"record_stop_android_signal",data:{deviceId:t.id,remotePath:r.remotePath,remotePid:r.remotePid,exitCode:i.exitCode,stdout:i.stdout.trim(),stderr:i.stderr.trim()}}),0!==i.exitCode)return await eP(t.id,r.remotePid,i);let o=await eS(t.id,r.remotePid);if(o)return o;a&&await em(t.id,r.remotePath)}async function eP(e,t,r){if(await el(e,t)&&!await eg(e,t))return`failed to stop recording: ${et(r,"adb shell kill")}`}async function eS(e,t){if(!await eu(e,t)&&!await eg(e,t))return`failed to stop recording: Android screenrecord pid ${t} did not exit`}async function eA(e){let t,{deps:r,device:a,recording:i}=e;h({level:"debug",phase:"record_stop_android_enter",data:{deviceId:a.id,remotePath:i.remotePath,remotePid:i.remotePid}}),i.stopping=!0,i.rotationTimer&&(clearTimeout(i.rotationTimer),i.rotationTimer=void 0),await i.rotationPromise;let o=await ev({device:a,recording:i});if(i.rotationFailedReason&&!o&&(i.warning??=`Android recording chunk rotation failed: ${i.rotationFailedReason}`),!o){let e=await es({deps:r,deviceId:a.id,chunks:ei(i)});if(e)return await n(),S("COMMAND_FAILED",e);await en({recording:i,deps:r})}if(await n(),o)return S("COMMAND_FAILED",o);if(t)return S("COMMAND_FAILED",t);return null;async function n(){for(let e of ei(i)){let r=await ed(a.id,["shell","rm","-f",e.remotePath],{allowFailure:!0});h({level:"debug",phase:"record_stop_android_cleanup",data:{deviceId:a.id,remotePath:e.remotePath,exitCode:r.exitCode,stdout:r.stdout.trim(),stderr:r.stderr.trim()}}),0===r.exitCode||o||(t=`failed to clean up remote recording: ${et(r,"adb shell rm")}`)}}}function eC(e){let t=e.appBundleId?.trim();return t&&t.length>0?t:void 0}function eb(e,t,r){return{verbose:e.flags?.verbose,logPath:t,traceLogPath:r.trace?.outPath,requestId:e.meta?.requestId}}async function eM(e){let{req:t,activeSession:r,device:a,logPath:i,deps:o}=e,n=eC(r);try{await o.runIosRunnerCommand(a,{command:"recordStop",appBundleId:n},eb(t,i,r))}catch(e){h({level:"warn",phase:"record_stop_runner_failed",data:{platform:a.platform,kind:a.kind,deviceId:a.id,session:r.name,error:ee(e)}})}}async function eI(e){let{req:t,activeSession:r,device:a,logPath:i,deps:o}=e,n=eC(r);if(n)try{await o.runIosRunnerCommand(a,{command:"snapshot",appBundleId:n,interactiveOnly:!0,compact:!0,depth:1},eb(t,i,r))}catch(e){h({level:"warn",phase:"record_start_simulator_runner_warm_failed",data:{deviceId:a.id,session:r.name,appBundleId:n,error:ee(e)}})}}async function ex(e){let t,r,{req:a,activeSession:i,sessionStore:o,device:n,logPath:s,deps:c,fpsFlag:d,recordingBase:l,appBundleId:u}=e,m=`agent-device-recording-${Date.now()}.mp4`,f=`tmp/${m}`,p=eb(a,s,i),w=async()=>c.runIosRunnerCommand(n,{command:"recordStart",outPath:m,fps:d,quality:l.quality,appBundleId:u},p);try{let e=await w();t="number"==typeof e.recorderStartUptimeMs?e.recorderStartUptimeMs:void 0,r="number"==typeof e.targetAppReadyUptimeMs?e.targetAppReadyUptimeMs:void 0}catch(a){var g,y;if(!ee(a).toLowerCase().includes("recording already in progress"))return S("COMMAND_FAILED",`failed to start recording: ${ee(a)}`);h({level:"warn",phase:"record_start_runner_desynced",data:{platform:n.platform,kind:n.kind,deviceId:n.id,session:i.name,error:ee(a)}});let e=(g=n.id,y=i.name,o.toArray().find(e=>e.name!==y&&"ios"===e.device.platform&&"device"===e.device.kind&&e.device.id===g&&e.recording?.platform==="ios-device-runner"));if(e)return S("COMMAND_FAILED",`failed to start recording: recording already in progress in session '${e.name}'`);try{await c.runIosRunnerCommand(n,{command:"recordStop",appBundleId:u},p)}catch{}try{let e=await w();t="number"==typeof e.recorderStartUptimeMs?e.recorderStartUptimeMs:void 0,r="number"==typeof e.targetAppReadyUptimeMs?e.targetAppReadyUptimeMs:void 0}catch(e){return S("COMMAND_FAILED",`failed to start recording: ${ee(e)}`)}}return{platform:"ios-device-runner",remotePath:f,runnerStartedAtUptimeMs:t,targetAppReadyUptimeMs:r,...l}}async function eD(e){let{req:t,activeSession:r,device:a,logPath:i,deps:o,fpsFlag:n,recordingBase:s,appBundleId:c}=e;try{await o.runIosRunnerCommand(a,{command:"recordStart",outPath:s.outPath,fps:n,quality:s.quality,appBundleId:c},eb(t,i,r))}catch(e){return S("COMMAND_FAILED",`failed to start recording: ${ee(e)}`)}return{platform:"macos-runner",...s}}async function eR(e){let{req:t,activeSession:r,device:a,logPath:i,deps:o,recording:n}=e;await eM({req:t,activeSession:r,device:a,logPath:i,deps:o});let s={stdout:"",stderr:"",exitCode:1};for(let e of M)if(0===(s=await o.runCmd("xcrun",["devicectl","device","copy","from","--device",a.id,"--source",n.remotePath,"--destination",n.outPath,"--domain-type","appDataContainer","--domain-identifier",e],{allowFailure:!0})).exitCode)break;if(0!==s.exitCode){let e=s.stderr.trim()||s.stdout.trim()||`devicectl exited with code ${s.exitCode}`;return S("COMMAND_FAILED",`failed to copy recording from device: ${e}`)}let c="number"!=typeof n.runnerStartedAtUptimeMs||"number"!=typeof n.targetAppReadyUptimeMs?0:Math.max(0,n.targetAppReadyUptimeMs-n.runnerStartedAtUptimeMs);return c>0&&await o.trimRecordingStart({videoPath:n.outPath,trimStartMs:c}),await er({recording:n,deps:o,trimStartMs:c,targetLabel:"iOS recording"}),null}async function eN(e){let{req:t,activeSession:r,device:a,logPath:i,deps:o,recording:n}=e;return await eM({req:t,activeSession:r,device:a,logPath:i,deps:o}),await er({recording:n,deps:o,targetLabel:"macOS recording"}),null}async function eE(e){let{deps:t,recording:r}=e;r.child.kill("SIGINT");let a=await e$(r.wait,5e3);return a||(await eF(t,r,"SIGINT"),(a=await e$(r.wait,2e3))||(r.child.kill("SIGTERM"),await eF(t,r,"SIGTERM"),a=await e$(r.wait,2e3)))?a:(r.child.kill("SIGKILL"),await eF(t,r,"SIGKILL"),await e$(r.wait,2e3))}async function e$(e,t){return await Promise.race([e,f(t).then(()=>null)])}async function eF(e,t,r){await eO(e,t,r)||await ek(e,t.outPath,r)}async function ek(e,t,r){let a,i=`simctl.*recordVideo.*${t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}`;try{a=await e.runCmd("pgrep",["-f",i],{allowFailure:!0})}catch(e){h({level:"warn",phase:"record_stop_ios_simulator_pgrep_failed",data:{outPath:t,signal:r,error:ee(e)}});return}let o=eT(eK(a.stdout)),n=eU(o,r);h({level:n>0?"warn":"debug",phase:"record_stop_ios_simulator_signal_recorders",data:{outPath:t,signal:r,matchedPidCount:o.length,signaled:n,pgrepExitCode:a.exitCode}})}async function eO(e,t,r){let a=t.recorderPid??t.child.pid;if("number"!=typeof a||!Number.isInteger(a)||a<=0)return h({level:"debug",phase:"record_stop_ios_simulator_owned_recorder_unavailable",data:{outPath:t.outPath,signal:r,reason:"missing_recorder_pid"}}),!1;let i=await eL(e,a,t.outPath,r),o=eT([a,...i.pids]),n=eU(o,r);return h({level:n>0?"warn":"debug",phase:"record_stop_ios_simulator_signal_owned_recorder",data:{outPath:t.outPath,signal:r,recorderPid:a,childPidCount:i.pids.length,matchedPidCount:o.length,signaled:n,pgrepExitCode:i.exitCode}}),n>0}async function eL(e,t,r,a){let i;try{i=await e.runCmd("pgrep",["-P",String(t)],{allowFailure:!0})}catch(e){return h({level:"warn",phase:"record_stop_ios_simulator_owned_pgrep_failed",data:{outPath:r,signal:a,parentPid:t,error:ee(e)}}),{pids:[]}}return{pids:eK(i.stdout),exitCode:i.exitCode}}function eT(e){return Array.from(new Set(e)).filter(e=>Number.isInteger(e)&&e>0&&e!==process.pid)}function eU(e,t){let r=0;for(let a of e)try{process.kill(a,t),r+=1}catch{}return r}function eK(e){return e.split(/\s+/).map(e=>Number(e)).filter(e=>Number.isInteger(e)&&e>0)}async function ez(e){"ios"!==e.platform||0!==e.gestureEvents.length&&await f(350)}async function eq(e){for(let t=0;t<2;t+=1){try{if(o.statSync(e).size>0)return Date.now()}catch{}if(t+1>=2)break;await f(250)}return Date.now()}async function eV(e){let t,r,{req:a,activeSession:i,device:o,logPath:n,deps:s,recordingBase:c,resolvedOut:d}=e;c.showTouches&&await eI({req:a,activeSession:i,device:o,logPath:n,deps:s});let{child:l,wait:u}=s.startIosSimulatorRecording({device:o,outPath:d}),m=await eq(d);if(c.showTouches)try{let e=Date.now(),c=await s.runIosRunnerCommand(o,{command:"uptime",appBundleId:eC(i)},eb(a,n,i)),d=Date.now();t=Math.round((e+d)/2),r="number"==typeof c.currentUptimeMs?c.currentUptimeMs:void 0}catch{}return{platform:"ios",child:l,wait:u,...c,recorderPid:l.pid,startedAt:m,gestureClockOriginAtMs:void 0===r?void 0:t,gestureClockOriginUptimeMs:r}}async function eG(e){let t,{req:r,sessionName:a,sessionStore:i,activeSession:s,device:c,logPath:d,deps:l}=e;if(s.recording)return S("INVALID_ARGS","recording already in progress");let u=r.flags?.fps,m=r.flags?.quality;if(void 0!==u&&(!Number.isInteger(u)||u<1||u>120))return S("INVALID_ARGS","fps must be an integer between 1 and 120");if(void 0!==m&&(!Number.isInteger(m)||m<5||m>10))return S("INVALID_ARGS","quality must be an integer between 5 and 10");if(!A("record",c))return S("UNSUPPORTED_OPERATION","record is not supported on this device");let f=r.positionals?.[1]??`./recording-${Date.now()}.mp4`,p=v.expandHome(f,r.meta?.cwd),h={outPath:p,clientOutPath:r.meta?.clientArtifactPaths?.outPath,startedAt:Date.now(),quality:r.flags?.quality,showTouches:r.flags?.hideTouches!==!0,gestureEvents:[]};if(o.mkdirSync(n.dirname(p),{recursive:!0}),o.rmSync(p,{force:!0}),"ios"===c.platform&&"device"===c.kind){let e=eC(s);if(!e)return S("INVALID_ARGS","record on physical iOS devices requires an active app session; run open <app> first");t=await ex({req:r,activeSession:s,sessionStore:i,device:c,logPath:d,deps:l,fpsFlag:u,recordingBase:h,appBundleId:e})}else if("macos"===c.platform){let e=eC(s);if(!e)return S("INVALID_ARGS","record on macOS requires an active app session; run open <app> first");t=await eD({req:r,activeSession:s,device:c,logPath:d,deps:l,fpsFlag:u,recordingBase:h,appBundleId:e})}else t="ios"===c.platform?await eV({req:r,activeSession:s,device:c,logPath:d,deps:l,recordingBase:h,resolvedOut:p}):await e_({device:c,recordingBase:h});return"ok"in t?t:(s.recording=t,i.set(a,s),i.recordAction(s,{command:r.command,positionals:r.positionals??[],flags:r.flags??{},result:{action:"start",showTouches:t.showTouches}}),{ok:!0,data:{recording:"started",outPath:t.clientOutPath??f,showTouches:t.showTouches}})}async function eH(e){let{deps:t,device:r,recording:a}=e;if("android"===a.platform)return await eA({deps:t,device:r,recording:a});await p("record_stop_tail_settle",()=>t.waitForRecordingTail(a),{platform:a.platform,gestureEventCount:a.gestureEvents.length});let i=await p("record_stop_ios_simulator_process",()=>eE({deps:t,recording:a}),{outPath:a.outPath});if(!i)return S("COMMAND_FAILED","failed to stop recording: simctl recordVideo did not exit after 5000ms and forced cleanup");if(0!==i.exitCode)return S("COMMAND_FAILED",`failed to stop recording: ${et(i,"simctl recordVideo")}`);if(await p("record_stop_video_stable",()=>t.waitForStableFile(a.outPath,{pollMs:150,attempts:12}),{outPath:a.outPath}),!await p("record_stop_video_playable_check",()=>t.isPlayableVideo(a.outPath),{outPath:a.outPath}))return S("COMMAND_FAILED",`failed to stop recording: ${a.outPath} was not finalized into a playable video`);if(void 0!==a.quality&&a.quality<10){let e=a.quality;try{await p("record_stop_resize",()=>t.resizeRecording({videoPath:a.outPath,quality:e,targetLabel:"iOS recording"}),{outPath:a.outPath,quality:e})}catch(e){a.overlayWarning=`failed to resize recording: ${ee(e)}`}}return await p("record_stop_finalize_overlay",()=>er({recording:a,deps:t,targetLabel:"iOS recording"}),{outPath:a.outPath,showTouches:a.showTouches,gestureEventCount:a.gestureEvents.length}),null}async function ej(e){var t;let r,a,{req:i,activeSession:o,device:s,logPath:c,deps:d}=e;if(!o.recording)return S("INVALID_ARGS","no active recording");let l=o.recording,u=l.invalidatedReason;o.recording=void 0;let m="ios-device-runner"===l.platform?await eR({req:i,activeSession:o,device:s,logPath:c,deps:d,recording:l}):"macos-runner"===l.platform?await eN({req:i,activeSession:o,device:s,logPath:c,deps:d,recording:l}):await eH({deps:d,device:s,recording:l});if(m)return m;if(u&&"ios"===l.platform&&l.showTouches)l.overlayWarning??=`overlay unavailable: ${u}`;else if(u)return S("COMMAND_FAILED",u);return r="android"===(t=l).platform?t.chunks:void 0,a=[{field:"outPath",path:t.outPath,localPath:t.clientOutPath,fileName:n.basename(t.clientOutPath??t.outPath)}],r&&r.length>1&&a.push(...r.slice(1).map(e=>({field:"chunkPath",path:e.path,localPath:eB(t,e.index),fileName:n.basename(eB(t,e.index)??e.path)}))),t.telemetryPath&&a.push({field:"telemetryPath",path:t.telemetryPath,localPath:function(e){if(e.clientOutPath)return j(e.clientOutPath)}(t),fileName:n.basename(t.telemetryPath)}),{ok:!0,data:{recording:"stopped",outPath:t.outPath,telemetryPath:t.telemetryPath,artifacts:a,showTouches:t.showTouches,warning:t.warning,overlayWarning:t.overlayWarning,chunks:r?.map(e=>({index:e.index,path:eB(t,e.index)??e.path}))}}}function eB(e,t){if("android"===e.platform&&e.clientOutPath)return ea(e.clientOutPath,t)}async function eW(e){let{req:t,sessionName:r,sessionStore:a,logPath:i}=e,o={runCmd:async(e,t,r)=>"xcrun"===e?await _(t,r):await m(e,t,r),startIosSimulatorRecording:e=>I().startIosSimulatorRecording(e),runIosRunnerCommand:P,waitForRecordingTail:ez,waitForStableFile:K,isPlayableVideo:z,trimRecordingStart:Z,resizeRecording:Y,overlayRecordingTouches:Q},n=a.get(r),s=n?.device??await b(t.flags??{});n||await C(s);let c=n??{name:r,device:s,createdAt:Date.now(),actions:[]},d=(t.positionals?.[0]??"").toLowerCase();if(!["start","stop"].includes(d))return S("INVALID_ARGS","record requires start|stop");if("start"===d)return eG({req:t,sessionName:r,sessionStore:a,activeSession:c,device:s,logPath:i,deps:o});let l=await ej({req:t,activeSession:c,device:s,logPath:i,deps:o});return l.ok&&a.recordAction(c,{command:t.command,positionals:t.positionals??[],flags:t.flags??{},result:{action:"stop",outPath:l.data?.outPath,showTouches:l.data?.showTouches}}),l}let eX={[x.record]:!0,[x.trace]:!0};async function eJ(e){let{req:t,sessionName:r,sessionStore:a,logPath:i}=e,s=t.command;if("record"===s)return eW({req:t,sessionName:r,sessionStore:a,logPath:i});if("trace"===s){let e=(t.positionals?.[0]??"").toLowerCase();if(!["start","stop"].includes(e))return S("INVALID_ARGS","trace requires start|stop");let i=a.get(r);if(!i)return S("SESSION_NOT_FOUND","No active session");if("start"===e){if(i.trace)return S("INVALID_ARGS","trace already in progress");let e=t.positionals?.[1]??a.defaultTracePath(i),r=v.expandHome(e);return o.mkdirSync(n.dirname(r),{recursive:!0}),o.appendFileSync(r,""),i.trace={outPath:r,startedAt:Date.now()},a.recordAction(i,{command:s,positionals:t.positionals??[],flags:t.flags??{},result:{action:"start",outPath:r}}),{ok:!0,data:{trace:"started",outPath:r}}}if(!i.trace)return S("INVALID_ARGS","no active trace");let c=i.trace.outPath;if(t.positionals?.[1]){let e=v.expandHome(t.positionals[1]);o.mkdirSync(n.dirname(e),{recursive:!0}),o.existsSync(c)?o.renameSync(c,e):o.appendFileSync(e,""),c=e}return i.trace=void 0,a.recordAction(i,{command:s,positionals:t.positionals??[],flags:t.flags??{},result:{action:"stop",outPath:c}}),{ok:!0,data:{trace:"stopped",outPath:c}}}return null}export{D as record_trace_namespaceObject};

package/dist/src/recording-provider.js

@@ -0,0 +1 @@
+import{createScopedProvider as r,buildSimctlArgsForDevice as o}from"./2415.js";import{runCmdBackground as e}from"./9818.js";let i={startIosSimulatorRecording:({device:r,outPath:i})=>e("xcrun",o(r,["io",r.id,"recordVideo",i]),{allowFailure:!0})},n=r(i,function(r={}){return{...i,...r}});function t(r){return n.resolve(r)}async function u(r,o){return await n.run(r,o)}export{t as resolveRecordingProvider,u as withRecordingProvider};

package/dist/src/selector-runtime.js

@@ -0,0 +1 @@
+import{createDaemonRuntimeSessionStore as e,setSessionSnapshot as t,captureSnapshot as r,dispatchCommand as n,runIosRunnerCommand as s,isCommandSupportedOnDevice as o,errorResponse as i,ensureDeviceReady as a,isApplePlatform as l,stopIosRunnerSession as u,getActiveAndroidSnapshotFreshness as c,resolveTargetDevice as d,context_contextFromFlags as f}from"./2415.js";import{asAppError as p,normalizeError as m,AppError as g}from"./9152.js";import{evaluateIsPredicate as h,isSupportedPredicate as y,localCommandPolicy as w,resolveRectCenter as _,createAgentDevice as S}from"./9533.js";import{emitDiagnostic as x}from"./7599.js";import{tryParseSelectorChain as k,normalizeType as I,extractNodeReadText as v,findNodeByLabel as A,splitIsSelectorArgs as N}from"./940.js";import{getAndroidAppState as P}from"./8806.js";import{parseWaitPositionals as R}from"./6085.js";import{parseFindArgs as b}from"./7556.js";import{buildSnapshotPresentationKey as q,snapshotPresentationOptionsFromFlags as C}from"./4057.js";async function M(e,t,r){let n=e.get(t),s=n?.device??await d(r??{});return n||await a(s),{session:n,device:s}}async function D(e,t,r){let n=!e&&"ios"===t.platform;try{return await r()}finally{n&&await u(t.id)}}function E(e,t,r,n){t&&e.recordAction(t,{command:r.command,positionals:r.positionals??[],flags:r.flags??{},result:n})}function O(e){let{session:t,sessionName:r,device:n,snapshot:s,appBundleId:o}=e;return t?{...t,snapshot:s}:{name:r,device:n,createdAt:Date.now(),appBundleId:o,snapshot:s,actions:[]}}function $(e,t={}){return{artifacts:function(e,t={}){let r=!0===t.plural?"do":"does";return{resolveInput:async()=>{throw new g("UNSUPPORTED_OPERATION",`${e} ${r} not resolve input artifacts`)},reserveOutput:async()=>{throw new g("UNSUPPORTED_OPERATION",`${e} ${r} not reserve output artifacts`)},createTempFile:async()=>{throw new g("UNSUPPORTED_OPERATION",`${e} ${r} not create temporary files`)}}}(e,t),policy:w()}}async function L(e){let{device:t,node:r,flags:s,appBundleId:o,traceOutPath:i,surface:a,contextFromFlags:l}=e,u=v(r),c=_(r.rect);if(!c)return u;try{let e=await n(t,"read",[String(c.x),String(c.y)],void 0,{...l(s,o,i),surface:a}),d=e&&"object"==typeof e?e:void 0,f="string"==typeof d?.text?d.text:"";if(f.trim())return f;return x({level:"warn",phase:"interaction_read_fallback",data:{reason:"empty_backend_text",nodeRef:r.ref,surface:a,platform:t.platform}}),u}catch(e){return x({level:"warn",phase:"interaction_read_fallback",data:{reason:"backend_read_failed",nodeRef:r.ref,surface:a,platform:t.platform,error:e instanceof Error?e.message:String(e)}}),u}}let U=[["snapshotDepth","--depth"],["snapshotScope","--scope"],["snapshotRaw","--raw"]];function K(e,t){let r=function(e){if(!e)return[];let t=[];for(let[r,n]of U)void 0!==e[r]&&t.push(n);return t}(t);return 0===r.length?null:i("INVALID_ARGS",`${e} @ref does not support ${r.join(", ")}.`)}async function T(e,t){let r=await G(e);if(r)throw new g("COMMAND_FAILED",`press ${t} left ${e.appBundleId} and foregrounded ${r.foregroundPackage}. The tap likely escaped the app.`,r)}async function G(e){var t;if("android"!==e.device.platform||!e.appBundleId)return null;let r=await P(e.device),n=r.package?.trim();return n&&n!==e.appBundleId&&("com.android.settings"===(t=n)||"com.android.systemui"===t||"com.google.android.permissioncontroller"===t||t.includes("launcher"))?{expectedPackage:e.appBundleId,foregroundPackage:n,activity:r.activity,hint:"com.google.android.permissioncontroller"===n?"Dismiss or allow the permission prompt, then retry the smoke assertion.":"Use screenshot as visual truth, then take a fresh snapshot -i before retrying."}:null}function V(e){return"COMMAND_FAILED"===e.code&&"string"==typeof e.details?.expectedPackage&&"string"==typeof e.details?.foregroundPackage}function F(e,t){let r=Array.isArray(e.selectorChain)?e.selectorChain:void 0,n=W(e),s=n?.kind==="ref"?z(n.ref):void 0,o=n?.kind==="selector"?n.selector:void 0,i={...s?{ref:s}:{},...o?{selector:o}:{},...r?{selectorChain:r}:{}};if("attrs"===t)return i;let a="string"==typeof e.text?e.text:"";return{...i,text:a,refLabel:function(e){let t=e.trim();if(!(!t||t.length>80||/[\r\n]/.test(t)))return t}(a)}}function B(e){let t=W(e);return{...t?.kind==="ref"?{ref:z(t.ref)}:{},...t?.kind==="selector"?{selector:t.selector}:{},..."string"==typeof e.text?{text:e.text}:{},...e.node&&"object"==typeof e.node?{node:e.node}:{}}}function j(e){let{selectorChain:t,...r}=e;return r}function H(e,t,r,n){let s=e.get(t);s&&e.recordAction(s,{command:r.command,positionals:r.positionals??[],flags:r.flags??{},result:n})}function W(e){let t=e.target;return t&&"object"==typeof t?"ref"===t.kind&&"string"==typeof t.ref?{kind:"ref",ref:t.ref}:"selector"===t.kind&&"string"==typeof t.selector?{kind:"selector",selector:t.selector}:void 0:void 0}function z(e){return e.startsWith("@")?e.slice(1):e}let J=["application","window","tabbar","scrollbar","image"],Q=new Set(["tab bar"]);async function X(e,t){var r;if(t.ok||(r=t.error.message,!/^wait timed out for (?:selector|text): /i.test(r)))return t;let n=await Y(e).catch(()=>null);return n?i(t.error.code,`${t.error.message}. Current surface: ${n.summary}.`,{...t.error.details??{},currentSurface:n.details}):t}async function Y(e){let t=[...(await r({device:e.device,session:e.session,flags:{...e.req.flags,snapshotInteractiveOnly:!0,snapshotCompact:!0},logPath:e.logPath??""})).snapshot.nodes].sort(ee),n=Z(t,6,{includeIdentifiers:!0});if(0===n.length)return null;let s=Z(t.filter(e=>!en(e)),4,{includeIdentifiers:!1}),o=Z(t.filter(es),4,{includeIdentifiers:!0});return{summary:(s.length>0?s:n.slice(0,4)).join(", "),details:{labels:n,...o.length>0?{buttons:o}:{}}}}function Z(e,t,r){let n=new Set,s=[];for(let o of e){let e=er(o,r);if(!(!e||n.has(e))&&(n.add(e),s.push(e),s.length>=t))break}return s}function ee(e,t){var r,n;return et(e)-et(t)||(r=e,n=t,r.rect&&n.rect?r.rect.y-n.rect.y||r.rect.x-n.rect.x:r.rect?-1:n.rect?1:(r.depth??0)-(n.depth??0)||r.index-n.index)}function et(e){let t=!!er(e,{includeIdentifiers:!1});return 2*!!en(e)+ +!t}function er(e,t){let r=(t.includeIdentifiers?[e.label,e.value,e.identifier]:[e.label,e.value]).map(e=>"string"==typeof e?e.trim():"").find(e=>e.length>0);return r?r.replace(/\s+/g," ").slice(0,80):""}function en(e){let t=I(`${e.type??""} ${e.role??""} ${e.subrole??""}`),r=`${e.label??""} ${e.value??""}`.trim().toLowerCase();return J.some(e=>t.includes(e))||Q.has(r)||r.endsWith(".fill")}function es(e){return I(`${e.type??""} ${e.role??""} ${e.subrole??""}`).includes("button")}function eo(e){var t;let{session:r,selectorExpression:n}=e;if(!r||"ios"!==r.device.platform||r.postGestureStabilization)return null;let s=k(n);if(!s||1!==s.selectors.length)return null;let o=s.selectors[0];if(!o||1!==o.terms.length)return null;let i=o.terms[0];return i&&"string"==typeof i.value&&("id"===(t=i.key)||"label"===t||"text"===t||"value"===t)?{key:i.key,value:i.value,raw:o.raw}:null}function ei(e){let t=p(e);if("COMMAND_FAILED"!==t.code)return!1;let r=t.message.toLowerCase();return r.includes("fetch failed")||r.includes("timed out")||r.includes("timeout")||r.includes("runner did not accept connection")||r.includes("invalid runner response")}async function ea(e){var t;let{req:r}=e;if("find"!==r.command)return null;let n=r.positionals??[];if(0===n.length)return i("INVALID_ARGS","find requires a locator or text");let s=b(n);if(!s.query)return i("INVALID_ARGS","find requires a value");if(r.flags?.findFirst&&r.flags?.findLast)return i("INVALID_ARGS","find accepts only one of --first or --last");let o=s.action;if("exists"!==(t=o)&&"wait"!==t&&"get_text"!==t&&"get_attrs"!==t)return null;let a=await e_(e,{requireSession:!1,capability:"find"});return a.ok?await ek(async()=>{let t=await a.runtime.selectors.find({session:e.sessionName,requestId:r.meta?.requestId,locator:s.locator,query:s.query,action:o,timeoutMs:s.timeoutMs});return H(e.sessionStore,e.sessionName,r,function(e,t){if("exists"===t)return{found:!0};if("wait"===t)return{found:!0,waitedMs:e.waitedMs};let r="string"==typeof e.ref?e.ref:void 0;return"get_attrs"===t?{ref:r,action:"get attrs"}:{ref:r,action:"get text",text:"string"==typeof e.text?e.text:""}}(t,o)),"found"===t.kind?{found:!0,..."number"==typeof t.waitedMs?{waitedMs:t.waitedMs}:{}}:{..."string"==typeof t.ref?{ref:t.ref}:{},..."string"==typeof t.text?{text:t.text}:{},...t.node&&"object"==typeof t.node?{node:t.node}:{}}}):a.response}async function el(e){let{req:t}=e;if("get"!==t.command)return null;let r=t.positionals?.[0];if("text"!==r&&"attrs"!==r)return i("INVALID_ARGS","get only supports text or attrs");let n=function(e){let t=e.positionals?.[1]??"";if(t.startsWith("@"))return{ok:!0,target:{kind:"ref",ref:t,fallbackLabel:e.positionals.length>2?e.positionals.slice(2).join(" ").trim():""}};let r=e.positionals?.slice(1).join(" ").trim()??"";return r?{ok:!0,target:{kind:"selector",selector:r}}:{ok:!1,response:i("INVALID_ARGS","get requires @ref or selector expression")}}(t);if(!n.ok)return n.response;if("ref"===n.target.kind){let e=K("get",t.flags);if(e)return e}if("selector"===n.target.kind){let t=await ed(e,r,n.target.selector);if(t)return t}let s=await e_(e,{requireSession:!0,capability:"get"});return s.ok?await ek(async()=>{let o=await s.runtime.selectors.get({session:e.sessionName,requestId:t.meta?.requestId,property:r,target:n.target});return H(e.sessionStore,e.sessionName,t,F(o,r)),B(o)}):s.response}async function eu(e){let{req:t}=e;if("is"!==t.command)return null;let r=(t.positionals?.[0]??"").toLowerCase();if(!y(r))return i("INVALID_ARGS","is requires predicate: visible|hidden|exists|editable|selected|text");let{split:n}=N(t.positionals??[]);if(!n)return i("INVALID_ARGS","is requires a selector expression");let s=n.rest.join(" ").trim();if("text"===r&&!s)return i("INVALID_ARGS","is text requires expected text value");if("text"!==r&&n.rest.length>0)return i("INVALID_ARGS",`is ${r} does not accept trailing values`);let o=await ef(e,r,n.selectorExpression,s);if(o)return o;let a=await e_(e,{requireSession:!0,capability:"is"});if(!a.ok)return a.response;let l=await ek(async()=>{let o=await a.runtime.selectors.is({session:e.sessionName,requestId:t.meta?.requestId,predicate:r,selector:n.selectorExpression,expectedText:s});return H(e.sessionStore,e.sessionName,t,o),j(o)});return await eI(e,l,`is ${r}`)}async function ec(e){let{req:t,sessionName:r,sessionStore:n}=e,s=R(t.positionals??[]);if(!s)return i("INVALID_ARGS","wait requires a duration or text");let{session:a,device:l}=await M(n,r,t.flags);if("sleep"!==s.kind&&!o("wait",l))return i("UNSUPPORTED_OPERATION","wait is not supported on this device");if("selector"===s.kind){let t=await ep({...e,session:a,device:l,selectorExpression:s.selectorExpression,timeoutMs:s.timeoutMs});if(t)return t}let u=async()=>{let o=ew({...e,session:a,device:l}),i=await ek(async()=>{let e=await o.selectors.wait({session:r,requestId:t.meta?.requestId,target:function(e,t){if("sleep"===e.kind)return{kind:"sleep",durationMs:e.durationMs};if("selector"===e.kind)return{kind:"selector",selector:e.selectorExpression,timeoutMs:e.timeoutMs};if("ref"===e.kind){if(!t?.snapshot)throw new g("INVALID_ARGS","Ref wait requires an existing snapshot in session.");return{kind:"ref",ref:e.rawRef,timeoutMs:e.timeoutMs}}if(!e.text)throw new g("INVALID_ARGS","wait requires text");return{kind:"text",text:e.text,timeoutMs:e.timeoutMs}}(s,a)});return H(n,r,t,e),{waitedMs:e.waitedMs,..."string"==typeof e.text?{text:e.text}:{},..."string"==typeof e.selector?{selector:e.selector}:{}}}),u=await X({req:t,logPath:e.logPath,session:a,device:l},i);return await eI(e,u,"wait")};return"sleep"===s.kind?await u():await D(a,l,u)}async function ed(e,t,r){let n=await em(e,r);if(ey(n))return n.response;if(!n)return null;let s=function(e,t,r){if(!r.found||!r.node)return null;let n={target:{kind:"selector",selector:t},node:r.node,selectorChain:[t]};return"attrs"===e?{kind:"attrs",...n}:"string"!=typeof r.text?null:{kind:"text",...n,text:r.text}}(t,n.selector.raw,n.result);return s?(H(e.sessionStore,e.sessionName,e.req,F(s,t)),{ok:!0,data:B(s)}):null}async function ef(e,t,r,n){var s,o,i,a,l;let u;if("hidden"===t)return null;let c=await em(e,r);if(ey(c))return c.response;if(!c?.result.found||!c.result.node)return null;let d="exists"===t?{predicate:t,pass:!0,selector:c.selector.raw,matches:1,selectorChain:[c.selector.raw]}:(s=t,o=n,i=c.selector.raw,a=c.session,u=h({predicate:s,node:l=c.result.node,nodes:[l],expectedText:o,platform:a.device.platform}),{predicate:s,pass:u.pass,selector:i,..."text"===s?{text:u.actualText}:{},selectorChain:[i]});return d?(H(e.sessionStore,e.sessionName,e.req,d),{ok:!0,data:j(d)}):null}async function ep(e){let t=eo({session:e.session,selectorExpression:e.selectorExpression});if(!e.session||!t)return null;let r=Date.now(),n=await eh(e,e.session,t);if(ey(n))return n.response;if(!n?.found)return null;let s={kind:"selector",selector:t.raw,waitedMs:Date.now()-r,selectorChain:[t.raw]};return H(e.sessionStore,e.sessionName,e.req,s),await X({req:e.req,logPath:e.logPath,session:e.session,device:e.device},{ok:!0,data:s})}async function em(e,t){let r=e.sessionStore.get(e.sessionName),n=eo({session:r,selectorExpression:t});if(!r||!n)return null;let s=await eh(e,r,n);return ey(s)?s:s?{session:r,selector:n,result:s}:null}async function eg(e,t,r){let n=await s(t.device,{command:"querySelector",selectorKey:r.key,selectorValue:r.value,appBundleId:t.appBundleId},{verbose:!!e.req.flags?.verbose,logPath:e.logPath,traceLogPath:t.trace?.outPath,requestId:e.req.meta?.requestId}),o=!0===n.found,i=function(e){let t=e.nodes;if(!Array.isArray(t))return;let r=t[0];if(r&&"object"==typeof r)return r}(n);return{found:o,..."string"==typeof n.text?{text:n.text}:{},...i?{node:i}:{}}}async function eh(e,t,r){try{return await eg(e,t,r)}catch(e){if(ei(e))return null;return{kind:"error",response:{ok:!1,error:m(e)}}}}function ey(e){return null!==e&&"kind"in e&&"error"===e.kind}function ew(n){return S({backend:function(e){let n,{req:s,session:o,device:i,logPath:a,sessionName:l,sessionStore:u}=e,d=0;return{platform:i.platform,captureSnapshot:async(e,f)=>{var p;let m,g={...s.flags,...(p=f,m={},p?.interactiveOnly!==void 0&&(m.snapshotInteractiveOnly=p.interactiveOnly),p?.compact!==void 0&&(m.snapshotCompact=p.compact),p?.scope!==void 0&&(m.snapshotScope=p.scope),p?.depth!==void 0&&(m.snapshotDepth=p.depth),p?.raw!==void 0&&(m.snapshotRaw=p.raw),m)},h=f?.scope??s.flags?.snapshotScope,y=Date.now(),w=q(C(g)),_="wait"===s.command||"find"===s.command;if(!_&&n&&y-d<750&&!c(o)&&!o?.postGestureStabilization)return n;if(!_&&o?.snapshot&&y-o.snapshot.createdAt<750&&o.snapshot.presentationKey===w&&!c(o)&&!o.postGestureStabilization)return d=o.snapshot.createdAt,n={snapshot:o.snapshot};let S=await r({device:i,session:o,flags:g,outPath:s.flags?.out,logPath:a??"",snapshotScope:h});return o&&(t(o,S.snapshot),u.set(l,o)),d=y,n={snapshot:S.snapshot}},readText:async(t,r)=>({text:await L({device:i,node:r,flags:s.flags,appBundleId:o?.appBundleId,traceOutPath:o?.trace?.outPath,surface:o?.surface,contextFromFlags:e.contextFromFlags??((e,t,r)=>f(a??"",e,t,r))})}),findText:async(t,r)=>({found:await eS(e,r)})}}(n),...$("selector commands",{plural:!0}),sessions:e({sessionName:n.sessionName,getSession:()=>n.session,recordOptions:{includeSnapshot:!0},setRecord:e=>{n.session&&e.snapshot&&(t(n.session,e.snapshot),n.sessionStore.set(n.sessionName,n.session))}})})}async function e_(e,t){let r=e.sessionStore.get(e.sessionName);if(!r&&t.requireSession)return{ok:!1,response:i("SESSION_NOT_FOUND","No active session. Run open first.")};let n=r?.device??await d(e.req.flags??{});return(r||await a(n),o(t.capability,n))?{ok:!0,runtime:ew({...e,session:r,device:n})}:{ok:!1,response:i("UNSUPPORTED_OPERATION",`${t.capability} is not supported on this device`)}}async function eS(e,t){let{device:r,session:n,req:o,logPath:i}=e;if("macos"===r.platform&&n?.surface&&"app"!==n.surface)return!!A((await ex(e)).nodes,t);if(l(r.platform)&&n?.appBundleId){let e=await s(r,{command:"findText",text:t,appBundleId:n?.appBundleId},{verbose:o.flags?.verbose,logPath:i,traceLogPath:n?.trace?.outPath,requestId:o.meta?.requestId});return e?.found===!0}return!!A((await ex(e)).nodes,t)}async function ex(e){let n=await r({device:e.device,session:e.session,flags:{...e.req.flags,snapshotInteractiveOnly:!1,snapshotCompact:!1},outPath:e.req.flags?.out,logPath:e.logPath??""});return e.session&&(t(e.session,n.snapshot),e.sessionStore.set(e.sessionName,e.session)),n.snapshot}async function ek(e){try{return{ok:!0,data:await e()}}catch(t){let e=p(t);return i(e.code,e.message,e.details)}}async function eI(e,t,r){var n;let s;if(t.ok)return t;let o=e.sessionStore.get(e.sessionName);if(!o)return t;try{s=await G(o)}catch{return t}return s?i(t.error.code,`${r} failed because ${"com.google.android.permissioncontroller"===(n=s).foregroundPackage?`Android permission dialog is blocking ${n.expectedPackage}`:`${n.foregroundPackage} is foreground instead of ${n.expectedPackage}`}.`,{...t.error.details??{},...s,blockedBy:"android_foreground_surface",originalMessage:t.error.message}):t}export{T as assertAndroidPressStayedInApp,O as buildSnapshotSession,$ as createDaemonRuntimePolicy,ea as dispatchFindReadOnlyViaRuntime,el as dispatchGetViaRuntime,eu as dispatchIsViaRuntime,ec as dispatchWaitViaRuntime,V as isAndroidEscapeError,ei as isDirectIosSelectorFallbackError,eo as readSimpleIosSelectorTarget,L as readTextForNode,E as recordIfSession,K as refSnapshotFlagGuardResponse,M as resolveSessionDevice,D as withSessionlessRunnerCleanup};

package/dist/src/selectors.d.ts

@@ -36,6 +36,7 @@ declare type RawSnapshotNode = {
     enabled?: boolean;
     selected?: boolean;
     focused?: boolean;
+    visibleToUser?: boolean;
     hittable?: boolean;
     depth?: number;
     parentIndex?: number;

package/dist/src/server.js

@@ -1,2 +1,2 @@
-import{createAgentDeviceClient as r}from"./9542.js";import{runCommand as e,isCommandName as t,listMcpToolDefinitions as n}from"./89.js";import{readVersion as i}from"./6277.js";let s=function(n={createClient:r,runCommand:e}){return{execute:async(r,e)=>{var i;if(!t(r))throw Error(`Unknown command tool: ${r}`);let s=n.createClient(function(r){if(!r||"object"!=typeof r||Array.isArray(r))return{};let e=r.stateDir;if(void 0===e)return{};if("string"!=typeof e||0===e.length)throw Error("Expected stateDir to be a non-empty string.");return{stateDir:e}}(e)),o=await n.runCommand(s,r,function(r){if(!r||"object"!=typeof r||Array.isArray(r))return r;let{stateDir:e,...t}=r;return t}(e));return{isError:!1,structuredContent:o,content:[{type:"text",text:"string"==typeof(i=o)?i:JSON.stringify(i,null,2)}]}}}}();async function o(r){if("2.0"!==r.jsonrpc||"string"!=typeof r.method)return u(r.id??null,-32600,"Invalid JSON-RPC request.");if(void 0===r.id)return null;try{var e,t;return e=r.id,t=await a(r.method,r.params),{jsonrpc:"2.0",id:e,result:t}}catch(e){if(e instanceof f)return u(r.id,-32601,e.message);return u(r.id,-32602,e instanceof Error?e.message:String(e))}}async function a(r,e){switch(r){case"initialize":return{protocolVersion:"2025-11-25",capabilities:{tools:{}},serverInfo:{name:"agent-device",version:i()}};case"ping":return{};case"tools/list":return{tools:n().map(r=>{var e;return{name:r.name,description:r.description,inputSchema:{...e=r.inputSchema,properties:{...e.properties,stateDir:{type:"string",description:"Agent-device state directory."}}}}})};case"tools/call":return await c(e);default:throw new f(`Unsupported MCP method: ${r}`)}}async function c(r){let e=function(r){if(!r||"object"!=typeof r||Array.isArray(r))throw Error("Expected object parameters.");return r}(r),t=function(r,e){let t=r[e];if("string"!=typeof t||0===t.length)throw Error(`Expected ${e} to be a non-empty string.`);return t}(e,"name");try{return await s.execute(t,e.arguments)}catch(r){return function(r,e=!1){return{isError:e,content:[{type:"text",text:r}]}}(r instanceof Error?r.message:String(r),!0)}}function u(r,e,t){return{jsonrpc:"2.0",id:r,error:{code:e,message:t}}}class f extends Error{}async function l(){let r=function(r={}){let e=r.handlePayload??p,t=r.write??m,n=Promise.resolve();return{push:r=>{var i;let s=Array.isArray(i=r)?1===i.length?i[0]?.id??null:null:i.id??null;n=n.then(async()=>{let n=await e(r);n&&t(n)}).catch(r=>{t({jsonrpc:"2.0",id:s,error:{code:-32603,message:r instanceof Error?r.message:String(r)}})})},idle:async()=>{await n}}}(),e=new y(e=>{r.push(e)});process.stdin.setEncoding("utf8"),process.stdin.on("data",r=>{try{e.push(r)}catch(r){m({jsonrpc:"2.0",id:null,error:{code:-32700,message:r instanceof Error?r.message:String(r)}})}}),await new Promise(r=>{process.stdin.on("end",r),process.stdin.on("close",r),process.stdin.resume()}),await r.idle()}function p(r){return Array.isArray(r)?d(r):o(r)}async function d(r){let e=[];for(let n of r){var t;e.push(...(t=await o(n))?[t]:[])}return e.length>0?e:null}class y{buffer="";sink;constructor(r){this.sink=r}push(r){for(this.buffer+=r;;){let r=this.tryReadLineMessage();if(void 0!==r){this.emit(r);continue}break}}tryReadLineMessage(){let r=this.buffer.indexOf("\n");if(-1===r)return;let e=this.buffer.slice(0,r).trim();return this.buffer=this.buffer.slice(r+1),e.length>0?e:void 0}emit(r){let e=JSON.parse(r);Array.isArray(e),this.sink(e)}}function m(r){process.stdout.write(`${JSON.stringify(r)}
+import{listMcpCommandMetadata as r,isCommandName as t}from"./command-metadata.js";import{readVersion as e}from"./9671.js";let n=function(r={}){return{execute:async(e,n)=>{var o;if(!t(e))throw Error(`Unknown command tool: ${e}`);let a=await i(r,function(r){if(!r||"object"!=typeof r||Array.isArray(r))return{};let t=r.stateDir;if(void 0===t)return{};if("string"!=typeof t||0===t.length)throw Error("Expected stateDir to be a non-empty string.");return{stateDir:t}}(n)),c=await (r.runCommand??s)(a,e,function(r){if(!r||"object"!=typeof r||Array.isArray(r))return r;let{stateDir:t,...e}=r;return e}(n));return{isError:!1,structuredContent:c,content:[{type:"text",text:"string"==typeof(o=c)?o:JSON.stringify(o,null,2)}]}}}}();async function i(r,t){if(r.createClient)return await r.createClient(t);let{createAgentDeviceClient:e}=await import("./9542.js");return e(t)}async function s(r,t,e){let n=await import("./command-surface.js");return await n.runCommand(r,t,e)}async function o(r){if("2.0"!==r.jsonrpc||"string"!=typeof r.method)return u(r.id??null,-32600,"Invalid JSON-RPC request.");if(void 0===r.id)return null;try{var t,e;return t=r.id,e=await a(r.method,r.params),{jsonrpc:"2.0",id:t,result:e}}catch(t){if(t instanceof f)return u(r.id,-32601,t.message);return u(r.id,-32602,t instanceof Error?t.message:String(t))}}async function a(t,n){switch(t){case"initialize":return{protocolVersion:"2025-11-25",capabilities:{tools:{}},serverInfo:{name:"agent-device",version:e()}};case"ping":return{};case"tools/list":return{tools:r().map(r=>{var t;return{name:r.name,description:r.description,inputSchema:{...t=r.inputSchema,properties:{...t.properties,stateDir:{type:"string",description:"Agent-device state directory."}}}}})};case"tools/call":return await c(n);default:throw new f(`Unsupported MCP method: ${t}`)}}async function c(r){let t=function(r){if(!r||"object"!=typeof r||Array.isArray(r))throw Error("Expected object parameters.");return r}(r),e=function(r,t){let e=r[t];if("string"!=typeof e||0===e.length)throw Error(`Expected ${t} to be a non-empty string.`);return e}(t,"name");try{return await n.execute(e,t.arguments)}catch(r){return function(r,t=!1){return{isError:t,content:[{type:"text",text:r}]}}(r instanceof Error?r.message:String(r),!0)}}function u(r,t,e){return{jsonrpc:"2.0",id:r,error:{code:t,message:e}}}class f extends Error{}async function l(){let r=function(r={}){let t=r.handlePayload??p,e=r.write??m,n=Promise.resolve();return{push:r=>{var i;let s=Array.isArray(i=r)?1===i.length?i[0]?.id??null:null:i.id??null;n=n.then(async()=>{let n=await t(r);n&&e(n)}).catch(r=>{e({jsonrpc:"2.0",id:s,error:{code:-32603,message:r instanceof Error?r.message:String(r)}})})},idle:async()=>{await n}}}(),t=new y(t=>{r.push(t)});process.stdin.setEncoding("utf8"),process.stdin.on("data",r=>{try{t.push(r)}catch(r){m({jsonrpc:"2.0",id:null,error:{code:-32700,message:r instanceof Error?r.message:String(r)}})}}),await new Promise(r=>{process.stdin.on("end",r),process.stdin.on("close",r),process.stdin.resume()}),await r.idle()}function p(r){return Array.isArray(r)?d(r):o(r)}async function d(r){let t=[];for(let n of r){var e;t.push(...(e=await o(n))?[e]:[])}return t.length>0?t:null}class y{buffer="";sink;constructor(r){this.sink=r}push(r){for(this.buffer+=r;;){let r=this.tryReadLineMessage();if(void 0!==r){this.emit(r);continue}break}}tryReadLineMessage(){let r=this.buffer.indexOf("\n");if(-1===r)return;let t=this.buffer.slice(0,r).trim();return this.buffer=this.buffer.slice(r+1),t.length>0?t:void 0}emit(r){let t=JSON.parse(r);Array.isArray(t),this.sink(t)}}function m(r){process.stdout.write(`${JSON.stringify(r)}
 `)}export{l as runAgentDeviceMcpServer};