agent-device 0.13.0 → 0.13.2

package/dist/src/index.d.ts

@@ -145,6 +145,7 @@ export declare type AgentDeviceClient = {
     };
     metro: {
         prepare: (options: MetroPrepareOptions) => Promise<MetroPrepareResult>;
+        reload: (options?: MetroReloadOptions) => Promise<MetroReloadResult>;
     };
     capture: {
         snapshot: (options?: CaptureSnapshotOptions) => Promise<CaptureSnapshotResult>;
@@ -1371,6 +1372,12 @@ export declare type CommandSessionStore = {
     list?(): readonly CommandSessionRecord[] | Promise<readonly CommandSessionRecord[]>;
 };
 
+declare type CompanionTunnelScope = {
+    tenantId: string;
+    runId: string;
+    leaseId: string;
+};
+
 export declare function createAgentDevice(config: AgentDeviceRuntimeConfig): AgentDevice;
 
 export declare function createAgentDeviceClient(config?: AgentDeviceClientConfig, deps?: {
@@ -1412,7 +1419,18 @@ declare type DaemonInstallSource = {
 } | {
     kind: 'path';
     path: string;
-};
+} | ({
+    kind: 'github-actions-artifact';
+    owner: string;
+    repo: string;
+} & ({
+    artifactId: number;
+} | {
+    runId: number;
+    artifactName: string;
+} | {
+    artifactName: string;
+}));
 
 declare type DaemonLockPolicy = 'reject' | 'strip';
 
@@ -1902,12 +1920,6 @@ declare type MetroBridgeResult = {
     };
 };
 
-declare type MetroBridgeScope = {
-    tenantId: string;
-    runId: string;
-    leaseId: string;
-};
-
 declare type MetroPrepareKind = 'auto' | 'react-native' | 'expo';
 
 export declare type MetroPrepareOptions = {
@@ -1916,7 +1928,7 @@ export declare type MetroPrepareOptions = {
     publicBaseUrl?: string;
     proxyBaseUrl?: string;
     bearerToken?: string;
-    bridgeScope?: MetroBridgeScope;
+    bridgeScope?: CompanionTunnelScope;
     launchUrl?: string;
     companionProfileKey?: string;
     companionConsumerKey?: string;
@@ -1933,6 +1945,15 @@ export declare type MetroPrepareOptions = {
 
 export declare type MetroPrepareResult = PrepareMetroRuntimeResult;
 
+export declare type MetroReloadOptions = {
+    metroHost?: string;
+    metroPort?: number;
+    bundleUrl?: string;
+    timeoutMs?: number;
+};
+
+export declare type MetroReloadResult = ReloadMetroResult;
+
 /** Re-export of {@link SessionRuntimeHints} under the Metro-specific alias used by public API consumers. */
 declare type MetroRuntimeHints = SessionRuntimeHints;
 
@@ -2153,6 +2174,13 @@ declare type RefTarget_2 = {
     selector?: never;
 };
 
+declare type ReloadMetroResult = {
+    reloaded: true;
+    reloadUrl: string;
+    status: number;
+    body: string;
+};
+
 declare type RepeatedPressOptions = {
     count?: number;
     intervalMs?: number;

package/dist/src/metro-companion.js

@@ -1 +1 @@
-import e from"node:fs";import{setTimeout as r}from"node:timers/promises";import{normalizeBaseUrl as t,METRO_COMPANION_RUN_ARG as a,ENV_SERVER_BASE_URL as s,ENV_LOCAL_BASE_URL as o,ENV_STATE_PATH as n,ENV_LAUNCH_URL as i,ENV_SCOPE_TENANT_ID as c,ENV_SCOPE_RUN_ID as f,ENV_BEARER_TOKEN as d,ENV_SCOPE_LEASE_ID as m}from"./320.js";async function l(e){var r,a;let s=await fetch(`${t(e.serverBaseUrl)}/api/metro/companion/register`,{method:"POST",headers:(r=e.serverBaseUrl,a=e.bearerToken,{authorization:`Bearer ${a}`,"content-type":"application/json",...r.includes("ngrok")?{"ngrok-skip-browser-warning":"1"}:{}}),body:JSON.stringify({...e.bridgeScope,local_base_url:t(e.localBaseUrl),...e.launchUrl?{launch_url:e.launchUrl}:{}})}),o=await s.json();if(!s.ok||!0!==o.ok||"string"!=typeof o.data?.ws_url)throw Error(`Failed to register Metro companion: ${JSON.stringify(o)}`);return{wsUrl:o.data.ws_url}}async function u(e){return"string"==typeof e?Buffer.from(e,"utf8"):e instanceof ArrayBuffer?Buffer.from(e):ArrayBuffer.isView(e)?Buffer.from(e.buffer,e.byteOffset,e.byteLength):"u">typeof Blob&&e instanceof Blob?Buffer.from(await e.arrayBuffer()):Buffer.from(String(e),"utf8")}async function p(e){return JSON.parse((await u(e.data)).toString("utf8"))}function y(e,r){1===e.readyState&&e.send(JSON.stringify(r))}async function g(e,r){1!==e.readyState&&await new Promise((t,a)=>{let s=()=>{i(),t()},o=()=>{i(),a(Error(`${r} WebSocket failed before opening.`))},n=()=>{i(),a(Error(`${r} WebSocket closed before opening.`))},i=()=>{e.removeEventListener("open",s),e.removeEventListener("error",o),e.removeEventListener("close",n)};e.addEventListener("open",s,{once:!0}),e.addEventListener("error",o,{once:!0}),e.addEventListener("close",n,{once:!0})})}async function w(e){e.readyState>=WebSocket.CLOSING||await new Promise(r=>{let t=()=>{a(),r()},a=()=>{e.removeEventListener("close",t),e.removeEventListener("error",t)};e.addEventListener("close",t,{once:!0}),e.addEventListener("error",t,{once:!0}),e.readyState>=WebSocket.CLOSING&&t()})}function b(e,r,t){try{e.close(1e3===r||r>=3e3&&r<=4999?r:3001,t)}catch{}}function h(r){return!r.statePath||e.existsSync(r.statePath)}async function S(e,r,a,s){var o,n;switch(r.type){case"ping":return void y(e,{type:"pong",timestamp:r.timestamp});case"http-request":try{let s=await fetch(new URL(r.path,`${t(a.localBaseUrl)}/`),{method:r.method,headers:r.headers,...r.bodyBase64?{body:Buffer.from(r.bodyBase64,"base64")}:{}}),o=Buffer.from(await s.arrayBuffer());y(e,{type:"http-response",requestId:r.requestId,status:s.status,headers:Object.fromEntries(s.headers.entries()),...o.length>0?{bodyBase64:o.toString("base64")}:{}})}catch(t){y(e,{type:"http-error",requestId:r.requestId,message:t instanceof Error?t.message:String(t)})}return;case"ws-open":{let n,i=new WebSocket((o=a.localBaseUrl,(n=new URL(r.path,`${t(o)}/`)).protocol="https:"===n.protocol?"wss:":"ws:",n.toString()));i.binaryType="arraybuffer";let c=!1;i.addEventListener("message",t=>{(async()=>{if(!c)return;let a=await u(t.data);y(e,{type:"ws-frame",streamId:r.streamId,dataBase64:a.toString("base64"),binary:"string"!=typeof t.data})})().catch(e=>{console.error(e instanceof Error?e.message:String(e))})}),i.addEventListener("close",t=>{s.delete(r.streamId),c&&y(e,{type:"ws-close",streamId:r.streamId,code:t.code,reason:t.reason})}),i.addEventListener("error",()=>{c&&y(e,{type:"ws-close",streamId:r.streamId,code:1011,reason:"Upstream WebSocket error."})}),s.set(r.streamId,i);try{await g(i,"Upstream"),c=!0,y(e,{type:"ws-open-result",streamId:r.streamId,success:!0,headers:{}})}catch(t){s.delete(r.streamId),b(i,1011,"open failed"),y(e,{type:"ws-open-result",streamId:r.streamId,success:!1,error:t instanceof Error?t.message:String(t)})}return}case"ws-frame":{let e=s.get(r.streamId);if(!e||1!==e.readyState)return;let t=Buffer.from(r.dataBase64,"base64");e.send(r.binary?t:t.toString("utf8"));return}case"ws-close":{let e=s.get(r.streamId);if(!e)return;s.delete(r.streamId),b(e,"number"==typeof(n=r.code)&&Number.isInteger(n)&&(1e3===n||n>=3e3&&n<=4999||n>=1001&&n<=1015&&1004!==n&&1005!==n&&1006!==n)?n:1011,r.reason??"bridge requested close");return}}}async function v(e){let t=new Map,a=setInterval(()=>{h(e)||process.exit(0)},250);for(a.unref();h(e);){try{let r=await l(e),a=new WebSocket(r.wsUrl);a.binaryType="arraybuffer",await g(a,"Bridge"),a.addEventListener("message",r=>{(async()=>{let s=await p(r);await S(a,s,e,t)})().catch(e=>{console.error(e instanceof Error?e.message:String(e))})}),await w(a),t.forEach(e=>b(e,1012,"bridge disconnected")),t.clear()}catch(r){if(!h(e))break;console.error(r instanceof Error?r.message:String(r))}if(!h(e))break;await r(1e3)}clearInterval(a)}(async function(e,r){let t=function(e,r){if(e[0]!==a)return null;let t=r[s]?.trim(),l=r[d]?.trim(),u=r[o]?.trim();if(!t||!l||!u)throw Error("Metro companion worker is missing required environment configuration.");let p=r[c]?.trim(),y=r[f]?.trim(),g=r[m]?.trim();if(!p||!y||!g)throw Error("Metro companion worker is missing required bridge scope configuration.");return{serverBaseUrl:t,bearerToken:l,localBaseUrl:u,bridgeScope:{tenantId:p,runId:y,leaseId:g},launchUrl:r[i]?.trim()||void 0,statePath:r[n]?.trim()||void 0}}(e,r);return!!t&&(await v(t),!0)})(process.argv.slice(2),process.env).catch(e=>{if(e instanceof Error&&e.message.includes("missing required environment")){console.error(e.message),process.exitCode=1;return}console.error(e instanceof Error?e.stack??e.message:String(e)),process.exitCode=1});
+import e from"node:fs";import{setTimeout as r}from"node:timers/promises";import{normalizeBaseUrl as t,ENV_COMPANION_TUNNEL_BEARER_TOKEN as s,ENV_COMPANION_TUNNEL_SERVER_BASE_URL as n,ENV_COMPANION_TUNNEL_STATE_PATH as o,ENV_COMPANION_TUNNEL_LAUNCH_URL as a,ENV_COMPANION_TUNNEL_SCOPE_LEASE_ID as i,ENV_COMPANION_TUNNEL_SCOPE_TENANT_ID as c,ENV_COMPANION_TUNNEL_DEVICE_PORT as l,METRO_COMPANION_RUN_ARG as f,ENV_COMPANION_TUNNEL_SESSION as d,ENV_COMPANION_TUNNEL_SCOPE_RUN_ID as u,ENV_COMPANION_TUNNEL_REGISTER_PATH as m,ENV_COMPANION_TUNNEL_LOCAL_BASE_URL as p,REACT_DEVTOOLS_COMPANION_RUN_ARG as g,ENV_COMPANION_TUNNEL_UNREGISTER_PATH as y}from"./2301.js";function w(e,r){return{authorization:`Bearer ${r}`,"content-type":"application/json",...e.includes("ngrok")?{"ngrok-skip-browser-warning":"1"}:{}}}function h(e){return{...e.bridgeScope,...e.session?{session:e.session}:{},local_base_url:t(e.localBaseUrl),...e.devicePort?{device_port:e.devicePort}:{},...e.launchUrl?{launch_url:e.launchUrl}:{}}}async function b(e){let r,s,n=e.registerPath;try{r=await fetch(`${t(e.serverBaseUrl)}${n}`,{method:"POST",headers:w(e.serverBaseUrl,e.bearerToken),body:JSON.stringify(h(e)),signal:AbortSignal.timeout(5e3)})}catch(r){if(r instanceof Error&&"TimeoutError"===r.name)throw Error(`${n} timed out after 5000ms calling ${t(e.serverBaseUrl)}${n}`);throw r}let o=await r.text();try{s=o?JSON.parse(o):{}}catch{let e;throw Error(`Failed to register companion (${r.status}): invalid JSON response: ${(e=o.replaceAll(/\s+/g," ").trim()).length>300?`${e.slice(0,300)}...`:e}`)}if(!r.ok||!0!==s.ok||"string"!=typeof s.data?.ws_url)throw Error(`Failed to register companion (${r.status}): ${JSON.stringify(s)}`);return{wsUrl:s.data.ws_url}}async function S(e){let r=e.unregisterPath??null;if(r)try{await fetch(`${t(e.serverBaseUrl)}${r}`,{method:"POST",headers:w(e.serverBaseUrl,e.bearerToken),body:JSON.stringify(h(e)),signal:AbortSignal.timeout(2e3)})}catch(e){console.error(e instanceof Error?e.message:String(e))}}async function v(e){return"string"==typeof e?Buffer.from(e,"utf8"):e instanceof ArrayBuffer?Buffer.from(e):ArrayBuffer.isView(e)?Buffer.from(e.buffer,e.byteOffset,e.byteLength):"u">typeof Blob&&e instanceof Blob?Buffer.from(await e.arrayBuffer()):Buffer.from(String(e),"utf8")}async function E(e){return JSON.parse((await v(e.data)).toString("utf8"))}function I(e,r){1===e.readyState&&e.send(JSON.stringify(r))}async function B(e,r){1!==e.readyState&&await new Promise((t,s)=>{let n=()=>{i(),t()},o=()=>{i(),s(Error(`${r} WebSocket failed before opening.`))},a=()=>{i(),s(Error(`${r} WebSocket closed before opening.`))},i=()=>{e.removeEventListener("open",n),e.removeEventListener("error",o),e.removeEventListener("close",a)};e.addEventListener("open",n,{once:!0}),e.addEventListener("error",o,{once:!0}),e.addEventListener("close",a,{once:!0})})}async function k(e){e.readyState>=WebSocket.CLOSING||await new Promise(r=>{let t=()=>{s(),r()},s=()=>{e.removeEventListener("close",t),e.removeEventListener("error",t)};e.addEventListener("close",t,{once:!0}),e.addEventListener("error",t,{once:!0}),e.readyState>=WebSocket.CLOSING&&t()})}function L(e,r,t){try{e.close(1e3===r||r>=3e3&&r<=4999?r:3001,t)}catch{}}function U(r){return!r.statePath||e.existsSync(r.statePath)}async function $(e,r,s,n){var o,a;switch(r.type){case"ping":return void I(e,{type:"pong",timestamp:r.timestamp});case"http-request":try{let n=await fetch(new URL(r.path,`${t(s.localBaseUrl)}/`),{method:r.method,headers:r.headers,...r.bodyBase64?{body:Buffer.from(r.bodyBase64,"base64")}:{}}),o=Buffer.from(await n.arrayBuffer());I(e,{type:"http-response",requestId:r.requestId,status:n.status,headers:Object.fromEntries(n.headers.entries()),...o.length>0?{bodyBase64:o.toString("base64")}:{}})}catch(t){I(e,{type:"http-error",requestId:r.requestId,message:t instanceof Error?t.message:String(t)})}return;case"ws-open":{let a,i=new WebSocket((o=s.localBaseUrl,(a=new URL(r.path,`${t(o)}/`)).protocol="https:"===a.protocol?"wss:":"ws:",a.toString()));i.binaryType="arraybuffer";let c=!1;i.addEventListener("message",t=>{(async()=>{if(!c)return;let s=await v(t.data);I(e,{type:"ws-frame",streamId:r.streamId,dataBase64:s.toString("base64"),binary:"string"!=typeof t.data})})().catch(e=>{console.error(e instanceof Error?e.message:String(e))})}),i.addEventListener("close",t=>{n.delete(r.streamId),c&&I(e,{type:"ws-close",streamId:r.streamId,code:t.code,reason:t.reason})}),i.addEventListener("error",()=>{c&&I(e,{type:"ws-close",streamId:r.streamId,code:1011,reason:"Upstream WebSocket error."})}),n.set(r.streamId,i);try{await B(i,"Upstream"),c=!0,I(e,{type:"ws-open-result",streamId:r.streamId,success:!0,headers:{}})}catch(t){n.delete(r.streamId),L(i,1011,"open failed"),I(e,{type:"ws-open-result",streamId:r.streamId,success:!1,error:t instanceof Error?t.message:String(t)})}return}case"ws-frame":{let e=n.get(r.streamId);if(!e||1!==e.readyState)return;let t=Buffer.from(r.dataBase64,"base64");e.send(r.binary?t:t.toString("utf8"));return}case"ws-close":{let e=n.get(r.streamId);if(!e)return;n.delete(r.streamId),L(e,"number"==typeof(a=r.code)&&Number.isInteger(a)&&(1e3===a||a>=3e3&&a<=4999||a>=1001&&a<=1015&&1004!==a&&1005!==a&&1006!==a)?a:1011,r.reason??"bridge requested close");return}}}async function N(e){let t=new Map,s=!1,n=null,o=!1,a=()=>{s||(s=!0,o&&S(e).finally(()=>process.exit(0)),n&&L(n,1e3,"companion stopping"),setTimeout(()=>process.exit(0),900).unref())};process.once("SIGTERM",a),process.once("SIGINT",a);let i=setInterval(()=>{U(e)||process.exit(0)},250);for(i.unref();!s&&U(e);){let a=!1;try{o=!1;let r=await b(e);if(a=!0,o=!0,s||!U(e)){await S(e),a=!1,o=!1;break}let i=new WebSocket(r.wsUrl);n=i,i.binaryType="arraybuffer";try{await B(i,"Bridge"),i.addEventListener("message",r=>{(async()=>{let s=await E(r);await $(i,s,e,t)})().catch(e=>{console.error(e instanceof Error?e.message:String(e))})}),await k(i)}finally{n=null,o=!1,t.forEach(e=>L(e,1012,"bridge disconnected")),t.clear(),a&&(await S(e),a=!1)}}catch(r){if(n=null,o=!1,a&&(await S(e),a=!1),s||!U(e))break;console.error(r instanceof Error?r.message:String(r))}if(s||!U(e))break;await r(1e3)}clearInterval(i)}(async function(e,r){let t=function(e,r){let t=e[0];if(t!==f&&t!==g)return null;let w=r[n]?.trim(),h=r[s]?.trim(),b=r[p]?.trim();if(!w||!h||!b)throw Error("Companion tunnel worker is missing required environment configuration.");let S=r[c]?.trim(),v=r[u]?.trim(),E=r[i]?.trim();if(!S||!v||!E)throw Error("Companion tunnel worker is missing required bridge scope configuration.");let I=r[m]?.trim();if(!I)throw Error("Companion tunnel worker is missing required register path configuration.");return{serverBaseUrl:w,bearerToken:h,localBaseUrl:b,registerPath:I,bridgeScope:{tenantId:S,runId:v,leaseId:E},launchUrl:r[a]?.trim()||void 0,statePath:r[o]?.trim()||void 0,unregisterPath:r[y]?.trim()||void 0,devicePort:function(e){if(!e?.trim())return;let r=Number.parseInt(e,10);if(!Number.isInteger(r)||r<1||r>65535)throw Error("Companion worker received invalid device port configuration.");return r}(r[l]),session:r[d]?.trim()||void 0}}(e,r);return!!t&&(await N(t),!0)})(process.argv.slice(2),process.env).catch(e=>{if(e instanceof Error&&e.message.includes("missing required environment")){console.error(e.message),process.exitCode=1;return}console.error(e instanceof Error?e.stack??e.message:String(e)),process.exitCode=1});

package/dist/src/metro.d.ts

@@ -4,6 +4,12 @@ export declare function buildBundleUrl(baseUrl: string, platform: 'ios' | 'andro
 
 export declare function buildIosRuntimeHints(baseUrl: string): MetroRuntimeHints;
 
+declare type CompanionTunnelScope = {
+    tenantId: string;
+    runId: string;
+    leaseId: string;
+};
+
 export declare function ensureMetroTunnel(options: EnsureMetroTunnelOptions): Promise<EnsureMetroTunnelResult>;
 
 export declare type EnsureMetroTunnelOptions = {
@@ -11,7 +17,7 @@ export declare type EnsureMetroTunnelOptions = {
     serverBaseUrl: string;
     bearerToken: string;
     localBaseUrl: string;
-    bridgeScope: MetroBridgeScope;
+    bridgeScope: CompanionTunnelScope;
     launchUrl?: string;
     profileKey?: string;
     consumerKey?: string;
@@ -75,12 +81,6 @@ export declare type MetroBridgeRuntimePayload = {
     launch_url?: string;
 };
 
-declare type MetroBridgeScope = {
-    tenantId: string;
-    runId: string;
-    leaseId: string;
-};
-
 /** Re-export of {@link SessionRuntimeHints} under the Metro-specific alias used by public API consumers. */
 export declare type MetroRuntimeHints = SessionRuntimeHints;
 
@@ -162,7 +162,7 @@ export declare type PrepareRemoteMetroOptions = {
     publicBaseUrl?: string;
     proxyBaseUrl?: string;
     proxyBearerToken?: string;
-    bridgeScope?: MetroBridgeScope;
+    bridgeScope?: CompanionTunnelScope;
     launchUrl?: string;
     profileKey?: string;
     consumerKey?: string;
@@ -187,6 +187,27 @@ export declare type PrepareRemoteMetroResult = {
     logPath: string;
 };
 
+declare type ReloadMetroOptions = {
+    metroHost?: string;
+    metroPort?: number | string;
+    bundleUrl?: string;
+    runtime?: MetroRuntimeHints;
+    timeoutMs?: number | string;
+};
+
+declare type ReloadMetroResult = {
+    reloaded: true;
+    reloadUrl: string;
+    status: number;
+    body: string;
+};
+
+export declare function reloadRemoteMetro(options?: ReloadRemoteMetroOptions): Promise<ReloadRemoteMetroResult>;
+
+export declare type ReloadRemoteMetroOptions = ReloadMetroOptions;
+
+export declare type ReloadRemoteMetroResult = ReloadMetroResult;
+
 export declare function resolveRuntimeTransport(runtime: SessionRuntimeHints | undefined): {
     host: string;
     port: number;

package/dist/src/metro.js

@@ -1 +1 @@
-import{buildMetroRuntimeHints as e,ensureMetroCompanion as t,stopMetroCompanion as r,prepareMetroRuntime as o}from"./1974.js";import{resolveRuntimeTransportHints as n}from"./9323.js";function i(e){return n(e)}async function s(e){let t=await o({projectRoot:e.projectRoot,kind:e.kind,publicBaseUrl:e.publicBaseUrl,proxyBaseUrl:e.proxyBaseUrl,proxyBearerToken:e.proxyBearerToken,bridgeScope:e.bridgeScope,launchUrl:e.launchUrl,companionProfileKey:e.profileKey,companionConsumerKey:e.consumerKey,metroPort:e.port,listenHost:e.listenHost,statusHost:e.statusHost,startupTimeoutMs:e.startupTimeoutMs,probeTimeoutMs:e.probeTimeoutMs,reuseExisting:e.reuseExisting,installDependenciesIfNeeded:e.installDependenciesIfNeeded,runtimeFilePath:e.runtimeFilePath,logPath:e.logPath,env:e.env});return{iosRuntime:t.iosRuntime,androidRuntime:t.androidRuntime,bridge:t.bridge,started:t.started,reused:t.reused,logPath:t.logPath}}async function u(e){let r=await t(e);return{pid:r.pid,started:r.spawned,logPath:r.logPath}}async function a(e){await r(e)}function l(t){return e(t,"ios")}function d(t){return e(t,"android")}export{buildBundleUrl,normalizeBaseUrl}from"./320.js";export{d as buildAndroidRuntimeHints,l as buildIosRuntimeHints,u as ensureMetroTunnel,s as prepareRemoteMetro,i as resolveRuntimeTransport,a as stopMetroTunnel};
+import{buildMetroRuntimeHints as e,ensureMetroCompanion as t,reloadMetro as r,stopMetroCompanion as o,prepareMetroRuntime as n}from"./1974.js";import{resolveRuntimeTransportHints as i}from"./8656.js";function s(e){return i(e)}async function a(e){let t=await n({projectRoot:e.projectRoot,kind:e.kind,publicBaseUrl:e.publicBaseUrl,proxyBaseUrl:e.proxyBaseUrl,proxyBearerToken:e.proxyBearerToken,bridgeScope:e.bridgeScope,launchUrl:e.launchUrl,companionProfileKey:e.profileKey,companionConsumerKey:e.consumerKey,metroPort:e.port,listenHost:e.listenHost,statusHost:e.statusHost,startupTimeoutMs:e.startupTimeoutMs,probeTimeoutMs:e.probeTimeoutMs,reuseExisting:e.reuseExisting,installDependenciesIfNeeded:e.installDependenciesIfNeeded,runtimeFilePath:e.runtimeFilePath,logPath:e.logPath,env:e.env});return{iosRuntime:t.iosRuntime,androidRuntime:t.androidRuntime,bridge:t.bridge,started:t.started,reused:t.reused,logPath:t.logPath}}async function u(e){let r=await t(e);return{pid:r.pid,started:r.spawned,logPath:r.logPath}}async function l(e){await o(e)}async function d(e={}){return await r(e)}function p(t){return e(t,"ios")}function m(t){return e(t,"android")}export{buildBundleUrl,normalizeBaseUrl}from"./2301.js";export{m as buildAndroidRuntimeHints,p as buildIosRuntimeHints,u as ensureMetroTunnel,a as prepareRemoteMetro,d as reloadRemoteMetro,s as resolveRuntimeTransport,l as stopMetroTunnel};

package/dist/src/observability.d.ts

@@ -0,0 +1,91 @@
+declare type BackendDiagnosticsTimeWindow = {
+    since?: string;
+    until?: string;
+};
+
+declare type BackendDumpNetworkResult = {
+    entries: readonly BackendNetworkEntry[];
+    nextCursor?: string;
+    timeWindow?: BackendDiagnosticsTimeWindow;
+    backend?: string;
+    redacted?: boolean;
+    notes?: readonly string[];
+};
+
+declare type BackendNetworkEntry = {
+    timestamp?: string;
+    method?: string;
+    url?: string;
+    status?: number;
+    durationMs?: number;
+    requestHeaders?: Record<string, string>;
+    responseHeaders?: Record<string, string>;
+    requestBody?: string;
+    responseBody?: string;
+    metadata?: Record<string, unknown>;
+};
+
+export declare function mapNetworkDumpToBackendResult(dump: ParsedNetworkDump, options?: {
+    backend?: string;
+    redacted?: boolean;
+    notes?: readonly string[];
+}): BackendDumpNetworkResult;
+
+export declare function mergeNetworkDumps(primary: ParsedNetworkDump, secondary: ParsedNetworkDump, maxEntries?: number): ParsedNetworkDump;
+
+export declare type NetworkIncludeMode = NetworkIncludeMode_2;
+
+declare type NetworkIncludeMode_2 = 'summary' | 'headers' | 'body' | 'all';
+
+export declare type NetworkLogBackend = NetworkLogBackend_2 | (string & {});
+
+declare type NetworkLogBackend_2 = 'ios-simulator' | 'ios-device' | 'android' | 'macos';
+
+export declare type ParsedNetworkDump = {
+    sourcePath?: string;
+    scannedLines: number;
+    matchedLines: number;
+    entries: ParsedNetworkEntry[];
+    include: NetworkIncludeMode;
+    limits: {
+        maxEntries: number;
+        maxPayloadChars: number;
+        maxScanLines: number;
+    };
+};
+
+export declare type ParsedNetworkEntry = {
+    url: string;
+    timestamp?: string;
+    method?: string;
+    status?: number;
+    durationMs?: number;
+    headers?: string;
+    requestBody?: string;
+    responseBody?: string;
+    raw?: string;
+    line?: number;
+    packetId?: string;
+    metadata?: {
+        packetId?: string;
+        [key: string]: unknown;
+    };
+};
+
+export declare function readRecentNetworkTrafficFromText(content: string, options?: {
+    sourcePath?: string;
+    backend?: NetworkLogBackend;
+    maxEntries?: number;
+    include?: NetworkIncludeMode;
+    maxPayloadChars?: number;
+    maxScanLines?: number;
+}): ParsedNetworkDump;
+
+export declare type RedactionResult = {
+    value: string;
+    redacted: boolean;
+};
+
+export declare function redactNetworkLogText(text: string): RedactionResult;
+
+export { }

package/dist/src/observability.js

@@ -0,0 +1 @@
+import{NETWORK_LOG_MEMORY_PATH as e,readRecentNetworkTrafficFromText as t}from"./5721.js";function a(a,s){var r;let d;return r=t(a,{path:s?.sourcePath,backend:function(e){switch(e){case"ios-simulator":return"ios-simulator";case"ios-device":return"ios-device";case"android":return"android";case"macos":return"macos";default:return}}(s?.backend),maxEntries:s?.maxEntries,include:s?.include,maxPayloadChars:s?.maxPayloadChars,maxScanLines:s?.maxScanLines}),{...(d=s?.sourcePath??(r.path===e?void 0:r.path))?{sourcePath:d}:{},scannedLines:r.scannedLines,matchedLines:r.matchedLines,entries:r.entries.map(e=>({url:e.url,...e.timestamp?{timestamp:e.timestamp}:{},...e.method?{method:e.method}:{},...void 0!==e.status?{status:e.status}:{},...void 0!==e.durationMs?{durationMs:e.durationMs}:{},...e.headers?{headers:e.headers}:{},...void 0!==e.requestBody?{requestBody:e.requestBody}:{},...void 0!==e.responseBody?{responseBody:e.responseBody}:{},...e.raw?{raw:e.raw}:{},...void 0!==e.line?{line:e.line}:{},...e.packetId?{packetId:e.packetId}:{}})),include:r.include,limits:r.limits}}function s(e,t,a=e.limits.maxEntries){let r=Math.max(0,a),o=e.entries.slice(0,r),n=new Set(o.map(e=>d(e)));for(let e of t.entries){if(o.length>=r)break;let t=d(e);n.has(t)||(n.add(t),o.push(e))}return{...e,matchedLines:o.length,entries:o}}function r(e,t){return{entries:e.entries.map(e=>{var t,a;let s,r;return r=(s={...(a=t=e).metadata??{}},a.packetId&&void 0===s.packetId&&(s.packetId=a.packetId),a.headers&&void 0===s.headers&&(s.headers=a.headers),Object.keys(s).length>0?s:void 0),{...t.timestamp?{timestamp:t.timestamp}:{},...t.method?{method:t.method}:{},url:t.url,...void 0!==t.status?{status:t.status}:{},...void 0!==t.durationMs?{durationMs:t.durationMs}:{},...void 0!==t.requestBody?{requestBody:t.requestBody}:{},...void 0!==t.responseBody?{responseBody:t.responseBody}:{},...r?{metadata:r}:{}}}),...t?.backend?{backend:t.backend}:{},...t?.redacted!==void 0?{redacted:t.redacted}:{},...t?.notes?{notes:t.notes}:{}}}function d(e){return`${e.timestamp??""}|${e.method??""}|${e.url}|${e.status??""}|${e.raw??""}`}export{redactNetworkLogText}from"./7166.js";export{r as mapNetworkDumpToBackendResult,s as mergeNetworkDumps,a as readRecentNetworkTrafficFromText};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-device",
-  "version": "0.13.0",
+  "version": "0.13.2",
   "description": "Agent-driven CLI for mobile UI automation, network inspection, and performance diagnostics across iOS, Android, tvOS, and macOS.",
   "license": "MIT",
   "author": "Callstack",
@@ -40,6 +40,10 @@
       "import": "./dist/src/artifacts.js",
       "types": "./dist/src/artifacts.d.ts"
     },
+    "./observability": {
+      "import": "./dist/src/observability.js",
+      "types": "./dist/src/observability.d.ts"
+    },
     "./metro": {
       "import": "./dist/src/metro.js",
       "types": "./dist/src/metro.d.ts"

package/skills/agent-device/SKILL.md

@@ -16,6 +16,7 @@ Use this skill as a router with mandatory defaults. Read this file first. For no
 - Prefer `diff snapshot` after a nearby mutation when you only need to know what changed.
 - Avoid speculative mutations. You may take the smallest reversible UI action needed to unblock inspection or complete the requested task, such as dismissing a popup, closing an alert, or clearing an unintended surface.
 - In React Native dev or debug builds, check early for visible warning or error overlays, tooltips, and toasts that can steal focus or intercept taps. If they are not part of the requested behavior, dismiss them and continue. If you saw them, report them in the final summary.
+- In Metro-backed React Native dev loops, use `agent-device metro reload` for a JS app reload before falling back to `open <app> --relaunch`. It mirrors pressing `r` in the Metro terminal and preserves the native app process.
 - Do not browse the web or use external sources unless the user explicitly asks.
 - Re-snapshot after meaningful UI changes instead of reusing stale refs.
 - Treat refs in default snapshot output as actionable-now, not durable identities. If a target appears only in an off-screen summary, use `scroll <direction>` and re-snapshot until the target is visible.
@@ -60,6 +61,7 @@ Use this skill as a router with mandatory defaults. Read this file first. For no
 - If there is no simulator, no app install, or no open app session yet, switch to `bootstrap-install.md` instead of improvising setup steps.
 - Use the smallest unblock action first when transient UI blocks inspection, but do not navigate, search, or enter new text just to make the UI reveal data unless the user asked for that interaction.
 - In React Native dev or debug apps, treat visible warning or error overlays as transient blockers unless the user is explicitly asking you to diagnose them. Dismiss them when safe, then continue the requested flow.
+- For React Native code changes where the app is already connected to Metro, prefer `agent-device metro reload`, then wait and re-snapshot. Use `open <app> --relaunch` only when Metro reload does not reconnect or native startup state must reset.
 - Do not use external lookups to compensate for missing on-screen data unless the user asked for them.
 - If the needed information is not exposed on screen, say that plainly instead of compensating with extra navigation, text entry, or web search.
 - Prefer `@ref` or selector targeting over raw coordinates.

package/skills/agent-device/references/bootstrap-install.md

@@ -18,6 +18,7 @@ Use this exact order when you are not sure about the installed app identifier. O
 
 - `install` or `reinstall`
 - `install-from-source` when the artifact already exists at a URL the daemon can reach
+- `install-from-source --github-actions-artifact` when a compatible remote daemon should resolve a GitHub Actions artifact
 
 ## Most common mistake to avoid
 
@@ -35,8 +36,6 @@ After setup is confirmed or completed, move to `exploration.md` before doing UI
 - If `open <app>` fails, run `agent-device apps` and retry with a discovered app name before considering install steps.
 - Do not install or reinstall on the first attempt unless the user explicitly asks for installation or provides a concrete artifact path or URL.
 - When installation is required from a known location, prefer a checked-in shell script or other deterministic bootstrap command over ad hoc path guessing.
-
-- If `open <app>` fails, or you are not sure which app name is available on the target, run `agent-device apps` first and choose from the discovered app list instead of guessing.
 - Use `apps --platform <platform>` together with `--device`, `--udid`, or `--serial` when target selection matters.
 - Once you have the correct app name, retry `open` with that exact discovered value.
 
@@ -64,8 +63,27 @@ agent-device install com.example.app ./build/MyApp.app --platform ios --device "
 ```bash
 ARTIFACT_URL="<trusted-artifact-url>"
 agent-device install-from-source "$ARTIFACT_URL" --platform android
-GITHUB_ARTIFACT_URL="<trusted-github-actions-artifact-api-url>"
-agent-device install-from-source "$GITHUB_ARTIFACT_URL" --platform ios --header "authorization: Bearer TOKEN"
+```
+
+Daemon-resolved GitHub Actions artifacts:
+
+```bash
+agent-device install-from-source \
+  --github-actions-artifact ORG/REPO:1234567890 \
+  --platform android
+```
+
+Project config can provide an artifact name instead:
+
+```json
+{
+  "platform": "android",
+  "installSource": {
+    "type": "github-actions-artifact",
+    "repo": "ORG/REPO",
+    "artifact": "app-debug"
+  }
+}
 ```
 
 ## Install guidance
@@ -73,6 +91,7 @@ agent-device install-from-source "$GITHUB_ARTIFACT_URL" --platform ios --header
 - Use `install <app> <path>` when the app may already be installed and you do not need a fresh-state reset.
 - Use `reinstall <app> <path>` when you explicitly need uninstall plus install as one deterministic step.
 - Use `install-from-source <url>` only when an existing artifact URL is trusted, operator-approved, and reachable by the daemon.
+- Use `--github-actions-artifact <org>/<repo>:<artifact>` when a compatible remote daemon should resolve a GitHub Actions artifact. Numeric artifacts are IDs; non-numeric artifacts are names.
 - Local `.apk`, `.aab`, `.app`, and `.ipa` paths go through `install` or `reinstall`; existing reachable URLs go through `install-from-source`.
 - Do not download, re-zip, publish temporary GitHub releases, or move CI artifacts elsewhere just to make an install command work.
 - Keep install and open as separate phases. Do not turn them into one default command flow.
@@ -80,10 +99,10 @@ agent-device install-from-source "$GITHUB_ARTIFACT_URL" --platform ios --header
   - Android: `.apk` and `.aab`
   - iOS: `.app` and `.ipa`
 - Android URL sources can be direct `.apk` or `.aab` files.
-- Trusted artifact service URLs, currently GitHub Actions and EAS, may point at archive-backed downloads that contain one installable artifact. This includes GitHub Actions artifact ZIPs whose URL path does not end in `.zip` and ZIPs containing one nested `.apk`, `.aab`, `.ipa`, or iOS `.app` tar archive.
+- Trusted artifact service URLs may point at archive-backed downloads that contain one installable artifact. Prefer `--github-actions-artifact` for GitHub Actions artifacts that a compatible remote daemon can resolve with its own credentials.
 - If a trusted artifact archive contains multiple installables, stop and ask for the intended artifact instead of guessing.
 - `.aab` still requires `bundletool` in `PATH`, or `AGENT_DEVICE_BUNDLETOOL_JAR=<absolute-path-to-bundletool-all.jar>` with `java` in `PATH`, when the daemon installs the materialized artifact.
-- For iOS `.ipa` files, `<app>` is used as the bundle id or bundle name hint when the archive contains multiple app bundles.
+- For `.ipa` archives with multiple app bundles, `<app>` is the bundle id or bundle name selection hint.
 - After install or reinstall, later use `open <app>` with the exact discovered or known package/bundle identifier, not the artifact path.
 
 ## Choose the right starting point
@@ -115,6 +134,7 @@ agent-device --session auth snapshot -i
 - Use semantic session names when you need multiple concurrent runs.
 - Use `--save-script=<path>` on `close` when you want to keep a replay script.
 - For dev loops where state can linger, prefer `open <app> --relaunch`.
+- For Metro-backed React Native JS changes with the app already running, prefer `metro reload` instead of `open <app> --relaunch`; it asks Metro to reload connected apps without restarting the native process.
 - In iOS sessions, use `open <app>` for the app itself. Use `open <url>` for deep links, and `open <app> <url>` when you need to launch the app and deep link in one step.
 - On iOS, `appstate` is session-scoped and requires the matching active session on the target device.
 

package/skills/agent-device/references/exploration.md

@@ -21,6 +21,7 @@ Open this file when the app or screen is already running and you need to discove
 - User asks for exact text from a known target: `get text`
 - User asks you to tap, type, or choose an element: `snapshot -i`, then act
 - User asks for the React Native component tree, props/state/hooks, or render profiling: use `agent-device react-devtools ...` and the `skills/react-devtools` workflow
+- User asks to reload a Metro-backed React Native app after JS changes: `agent-device metro reload`, then wait briefly and re-run `snapshot` or `snapshot -i`
 - React Native dev or debug build shows warning/error UI: capture enough evidence to identify it, dismiss it if it is not the requested behavior, then continue the flow and report it in the summary
 - The on-screen keyboard is blocking the next step: `keyboard dismiss`; on iOS do this only while an app session is active, and use `keyboard status|get` only on Android
 - UI does not expose the answer: say so plainly; do not browse or force the app into a new state unless asked
@@ -60,6 +61,16 @@ Open this file when the app or screen is already running and you need to discove
 - Blocking or recurring: switch to [debugging.md](debugging.md) and collect evidence.
 - Seen at any point: mention in the final summary even if dismissed.
 
+**React Native Metro reload.** When a dev app is already running and connected to Metro, prefer a Metro reload over restarting the native app process:
+
+```bash
+agent-device metro reload
+agent-device wait 1000
+agent-device snapshot -i
+```
+
+Use `--metro-host`, `--metro-port`, or `--bundle-url` only when the active connection does not already carry the right runtime hints. Fall back to `open <app> --relaunch` when the app is not connected to Metro, Metro reload fails, or native startup state needs a clean process.
+
 ## Common example loops
 
 These are examples, not required exact sequences. Adapt them to the app, state, and task at hand.

package/skills/agent-device/references/remote-tenancy.md

@@ -8,11 +8,14 @@ Open this file for remote daemon HTTP flows that let an agent running in a Linux
 
 - `agent-device connect --remote-config <path>`
 - `agent-device install-from-source <url> --remote-config <path> --platform android`
+- `agent-device install-from-source --github-actions-artifact <org>/<repo>:<artifact> --remote-config <path> --platform android`
 - `agent-device open <package> --remote-config <path> --relaunch`
+- `agent-device metro reload --remote-config <path>`
 - `agent-device snapshot --remote-config <path> -i`
 - `agent-device disconnect --remote-config <path>`
 - `agent-device connection status`
-- `AGENT_DEVICE_DAEMON_AUTH_TOKEN=...`
+- `agent-device auth status`
+- `AGENT_DEVICE_DAEMON_AUTH_TOKEN=...` for CI/service-token automation
 
 ## Most common mistake to avoid
 
@@ -28,20 +31,18 @@ Do not mix an arbitrary `--session` plus ad-hoc daemon, tenant, run, or lease fl
 Use this when the agent will run several commands in one session.
 
 ```bash
-export AGENT_DEVICE_DAEMON_AUTH_TOKEN="YOUR_TOKEN"
-export AGENT_DEVICE_PROXY_TOKEN="$AGENT_DEVICE_DAEMON_AUTH_TOKEN"
-
 agent-device connect --remote-config ./remote-config.json
 
 ARTIFACT_URL="<trusted-artifact-url>"
 agent-device install-from-source "$ARTIFACT_URL" --platform android
 agent-device open com.example.app --relaunch
+agent-device metro reload
 agent-device snapshot -i
 agent-device fill @e3 "test@example.com"
 agent-device disconnect
 ```
 
-After `connect`, normal commands use the active remote connection. End with `disconnect` to release the lease and stop the owned Metro companion.
+After `connect`, normal commands use the active remote connection. If cloud credentials are missing, `connect` starts login automatically in an interactive shell and stores a revocable CLI session that silently mints short-lived `adc_agent_...` command tokens. The cloud side remains responsible for token expiry, tenant/run claim checks, revocation, one-time device approval, and polling rate limits. End with `disconnect` to release the lease and stop the owned Metro companion.
 
 ### Self-contained script flow
 
@@ -73,6 +74,7 @@ The first command that needs a lease or Metro runtime prepares and persists it.
 - `connect` stores local non-secret connection state and defers tenant lease allocation plus Metro preparation until a later command needs them.
 - Commands such as `install-from-source`, `open`, `snapshot`, and `apps` allocate or refresh the lease when needed.
 - `open` prepares Metro runtime hints when the remote profile has Metro fields and no compatible runtime is already saved.
+- `metro reload` reuses saved Metro runtime hints and asks Metro to reload connected React Native apps without restarting the native process.
 - `batch` also prepares Metro when any step opens an app and that step does not provide its own runtime.
 - `disconnect` closes the session when possible, stops the Metro companion owned by the connection, releases the lease when one was allocated, and removes local connection state.
 
@@ -82,12 +84,11 @@ Remote install examples:
 agent-device install com.example.app ./app.apk
 ARTIFACT_URL="<trusted-artifact-url>"
 agent-device install-from-source "$ARTIFACT_URL" --platform android
-GITHUB_ARTIFACT_URL="<trusted-github-actions-artifact-api-url>"
-agent-device install-from-source "$GITHUB_ARTIFACT_URL" --platform ios --header "authorization: Bearer TOKEN"
 ```
 
 - Use `install` or `reinstall` for local paths; remote daemons upload local artifacts automatically.
 - Use `install-from-source` only for trusted, operator-approved artifact URLs the remote daemon can reach. Do not fetch arbitrary user-supplied URLs.
+- Use `install-from-source --github-actions-artifact <org>/<repo>:<artifact>` when the remote daemon has repository credentials and supports daemon-resolved GitHub Actions artifacts.
 - For local-path versus URL artifact rules, follow [bootstrap-install.md](bootstrap-install.md).
 
 Use `agent-device connection status --session adc-android` to inspect the active connection without reading JSON state manually. Status output must not include auth tokens.
@@ -120,7 +121,7 @@ Optional overrides stay available for advanced cases:
 }
 ```
 
-- Keep secrets in env/config managed by the operator boundary. Do not persist auth tokens in connection state.
+- Keep service tokens in env/config managed by the operator boundary. Do not persist auth tokens in connection state. Human login uses `agent-device auth login` or implicit `connect` login and stores only the CLI session credential.
 - Omit Metro fields for non-React Native flows.
 - Put `tenant`, `runId`, and `sessionIsolation` in the remote profile so agents can run `agent-device connect --remote-config ./remote-config.json` without extra scope flags. Add `platform`, `leaseBackend`, `session`, or Metro overrides only when the default inference is not enough for that flow.
 - Explicit command-line flags override connected defaults. Use them intentionally when switching session, platform, target, tenant, run, or lease scope.
@@ -134,31 +135,49 @@ Optional overrides stay available for advanced cases:
 
 - Start the daemon in HTTP mode with `AGENT_DEVICE_DAEMON_SERVER_MODE=http|dual` on the host.
 - Point the profile or env at the remote host with `daemonBaseUrl` or `AGENT_DEVICE_DAEMON_BASE_URL=http(s)://host:port[/base-path]`.
-- For non-loopback remote hosts, set `AGENT_DEVICE_DAEMON_AUTH_TOKEN` or `--daemon-auth-token`. The client rejects non-loopback remote daemon URLs without auth.
-- Direct JSON-RPC callers can authenticate with request params, `Authorization: Bearer <token>`, or `x-agent-device-token`.
+- For humans, run `connect --remote-config <path>` and let it refresh or create the CLI session. Use `agent-device auth status` to inspect it and `agent-device auth logout` to remove it.
+- For CI/non-interactive shells, set `AGENT_DEVICE_DAEMON_AUTH_TOKEN=adc_live_...` or pass `--daemon-auth-token`. The client does not start device-code polling in CI by default.
 - Prefer an auth hook such as `AGENT_DEVICE_HTTP_AUTH_HOOK` when the host needs caller validation or tenant injection.
 
-## Manual lease debug fallback
+## Lease debug fallback
+
+The main agent flow should use `connect` and `connection status`. For daemon-side auth, scope, or lease debugging, inspect host-side daemon logs and operator tooling instead of issuing raw daemon RPC from the agent shell.
+
+## GitHub Actions artifact install
 
-The main agent flow should use `connect`. Use manual JSON-RPC only for host-side automation or daemon-side auth/scope debugging, and only against trusted daemon hosts.
+Use this when a compatible remote daemon resolves GitHub Actions artifacts server-side. Do not download CI artifacts locally or add a local `GITHUB_TOKEN` just to install CI output.
+
+Artifact ID shape:
 
 ```bash
-curl -fsS "$AGENT_DEVICE_DAEMON_BASE_URL/rpc" \
-  -H "Authorization: Bearer $AGENT_DEVICE_DAEMON_AUTH_TOKEN" \
-  -H "Content-Type: application/json" \
-  -d '{
-    "jsonrpc": "2.0",
-    "id": "lease-1",
-    "method": "agent_device.lease.allocate",
-    "params": {
-      "tenantId": "acme",
-      "runId": "run-123",
-      "backend": "android-instance"
-    }
-  }'
+agent-device install-from-source \
+  --github-actions-artifact OWNER/REPO:1234567890 \
+  --remote-config ./remote-config.json \
+  --platform android
+```
+
+Artifact-name shape:
+
+```bash
+agent-device install-from-source \
+  --github-actions-artifact OWNER/REPO:app-debug \
+  --remote-config ./remote-config.json \
+  --platform ios
+```
+
+Config shape:
+
+```json
+{
+  "installSource": {
+    "type": "github-actions-artifact",
+    "repo": "OWNER/REPO",
+    "artifact": "app-debug"
+  }
+}
 ```
 
-Related daemon methods are `agent_device.lease.allocate`, `agent_device.lease.heartbeat`, `agent_device.lease.release`, and `agent_device.command`.
+Numeric artifacts are passed as artifact IDs. Non-numeric artifacts are passed as artifact names.
 
 ## Failure semantics and trust notes
 

package/skills/react-devtools/SKILL.md

@@ -44,6 +44,8 @@ agent-device react-devtools profile rerenders --limit 5
 - Labels like `@c5` reset when the app reloads or components remount. After reload, run `wait --connected` and inspect again.
 - Profiling only captures renders between `profile start` and `profile stop`.
 - On Android, set `adb reverse tcp:8097 tcp:8097` for React DevTools. If Metro is local, also set `adb reverse tcp:8081 tcp:8081`.
+- For Android sessions connected through `agent-device connect --remote-config`, run `agent-device react-devtools ...` normally. The CLI registers a bridge companion tunnel to the local DevTools daemon on `127.0.0.1:8097` and unregisters it when the command exits.
+- Remote Android React DevTools assumes the React Native-bundled DevTools behavior in React Native 0.83+. Do not assume older browser/Chromium DevTools workflows exist in remote sandboxes. For Expo apps, verify the SDK's bundled React Native version and runtime behavior first; no Expo SDK version is separately verified by this skill.
 
 ## References
 

package/dist/src/320.js

@@ -1 +0,0 @@
-let E="--agent-device-run-metro-companion",_="AGENT_DEVICE_METRO_COMPANION_SERVER_BASE_URL",N="AGENT_DEVICE_METRO_COMPANION_BEARER_TOKEN",A="AGENT_DEVICE_METRO_COMPANION_LOCAL_BASE_URL",O="AGENT_DEVICE_METRO_COMPANION_LAUNCH_URL",e="AGENT_DEVICE_METRO_COMPANION_STATE_PATH",T="AGENT_DEVICE_METRO_COMPANION_SCOPE_TENANT_ID",C="AGENT_DEVICE_METRO_COMPANION_SCOPE_RUN_ID",R="AGENT_DEVICE_METRO_COMPANION_SCOPE_LEASE_ID";function I(E){let _=E.length;for(;_>0&&47===E.charCodeAt(_-1);)_-=1;return _===E.length?E:E.slice(0,_)}function r(E,_){let N=new URL(`${I(E)}/index.bundle`);return N.searchParams.set("platform",_),N.searchParams.set("dev","true"),N.searchParams.set("minify","false"),N.toString()}export{N as ENV_BEARER_TOKEN,O as ENV_LAUNCH_URL,A as ENV_LOCAL_BASE_URL,R as ENV_SCOPE_LEASE_ID,C as ENV_SCOPE_RUN_ID,T as ENV_SCOPE_TENANT_ID,_ as ENV_SERVER_BASE_URL,e as ENV_STATE_PATH,E as METRO_COMPANION_RUN_ARG,r as buildBundleUrl,I as normalizeBaseUrl};

package/dist/src/3883.js

@@ -1 +0,0 @@
-import{runCmdSync as e}from"./9818.js";import{sleep as t}from"./4829.js";let r=[/(^|[/\s"'=])dist\/src\/daemon\.js($|[\s"'])/,/(^|[/\s"'=])src\/daemon\.ts($|[\s"'])/];function n(e){if(!Number.isInteger(e)||e<=0)return!1;try{return process.kill(e,0),!0}catch(e){return"EPERM"===e.code}}function i(t){if(!Number.isInteger(t)||t<=0)return null;try{let r=e("ps",["-p",String(t),"-o","lstart="],{allowFailure:!0,timeoutMs:1e3});if(0!==r.exitCode)return null;let n=r.stdout.trim();return n.length>0?n:null}catch{return null}}function o(t){if(!Number.isInteger(t)||t<=0)return null;try{let r=e("ps",["-p",String(t),"-o","command="],{allowFailure:!0,timeoutMs:1e3});if(0!==r.exitCode)return null;let n=r.stdout.trim();return n.length>0?n:null}catch{return null}}function l(e,t){let l;if(!n(e))return!1;if(t){let r=i(e);if(!r||r!==t)return!1}let s=o(e);return!!s&&!!(l=s.toLowerCase().replaceAll("\\","/")).includes("agent-device")&&r.some(e=>e.test(l))}function s(e,t){try{return process.kill(e,t),!0}catch(t){let e=t.code;if("ESRCH"===e||"EPERM"===e)return!1;throw t}}async function u(e,r){if(!n(e))return!0;let i=Date.now();for(;Date.now()-i<r;)if(await t(50),!n(e))return!0;return!n(e)}async function c(e,t){!l(e,t.expectedStartTime)||!s(e,"SIGTERM")||await u(e,t.termTimeoutMs)||s(e,"SIGKILL")&&await u(e,t.killTimeoutMs)}export{l as isAgentDeviceDaemonProcess,n as isProcessAlive,o as readProcessCommand,i as readProcessStartTime,c as stopProcessForTakeover,u as waitForProcessExit};

package/dist/src/8164.js

@@ -1 +0,0 @@
-import{promises as t}from"node:fs";import o from"node:os";import e from"node:path";let r=["emulator","platform-tools",e.join("cmdline-tools","latest","bin"),e.join("cmdline-tools","tools","bin")];function n(t){let o=new Set,e=[];for(let r of t){let t=r.trim();!t||o.has(t)||(o.add(t),e.push(t))}return e}function i(t=process.env){let r=t.ANDROID_SDK_ROOT?.trim(),l=t.ANDROID_HOME?.trim(),s=t.HOME?.trim()||o.homedir();return n([r??"",l??"",s?e.join(s,"Android","Sdk"):""])}async function l(o){try{return await t.access(o,t.constants.X_OK),!0}catch{return!1}}async function s(t=process.env){let o,m=[];for(let n of i(t)){let t=[];for(let o of r){let r=e.join(n,o);await l(r)&&t.push(r)}0!==t.length&&(o||(o=n),m.push(...t))}if(o&&(t.ANDROID_SDK_ROOT=t.ANDROID_SDK_ROOT?.trim()||o,t.ANDROID_HOME=t.ANDROID_HOME?.trim()||o),0===m.length)return;let d=(t.PATH??"").split(e.delimiter).map(t=>t.trim()).filter(t=>t.length>0);t.PATH=n([...m,...d]).join(e.delimiter)}export{s as ensureAndroidSdkPathConfigured,i as resolveAndroidSdkRoots};