adb-ready 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -9,6 +9,15 @@ breaking changes.
 
 ## [Unreleased]
 
+## [0.4.1] - 2026-09-16
+
+### Fixed
+
+- Resolve Expo Go and development-client launch URLs through Expo's supported
+  `/_expo/link` redirect without probing an unhandled route that could consume
+  the request timeout, and report distinct timeout, connection, response, and
+  unsafe-redirect failures.
+
 ## [0.4.0] - 2026-09-15
 
 ### Added

package/dist/cli.js

@@ -3304,7 +3304,7 @@ import process13 from "node:process";
 // package.json
 var package_default = {
   name: "adb-ready",
-  version: "0.4.0",
+  version: "0.4.1",
   description: "Agent-ready Android CLI for reliable ADB sessions, app automation, and verified evidence.",
   private: false,
   type: "module",
@@ -39826,9 +39826,6 @@ var MAX_URL_LENGTH = 8 * 1024;
 function aborted4(signal) {
   return signal?.aborted === true;
 }
-function validApplicationId(value) {
-  return typeof value === "string" && /^[A-Za-z][A-Za-z0-9_]*(?:\.[A-Za-z0-9_]+)+$/u.test(value);
-}
 function parseLaunchUrl(value) {
   if (typeof value !== "string" || value.length === 0 || value.length > MAX_URL_LENGTH) {
     return;
@@ -39910,34 +39907,7 @@ async function requestExpo(url4, signal) {
     ...location === undefined ? {} : { location }
   };
 }
-function parseOpenResponse(response, requestedRuntime, devicePort) {
-  if (response.status !== 200)
-    return;
-  let document2;
-  try {
-    document2 = JSON.parse(response.body);
-  } catch {
-    return;
-  }
-  if (typeof document2 !== "object" || document2 === null || Array.isArray(document2)) {
-    return;
-  }
-  const record4 = document2;
-  const runtime = record4.runtime;
-  if (runtime !== requestedRuntime)
-    return;
-  const parsedUrl = parseLaunchUrl(record4.url);
-  if (parsedUrl === undefined)
-    return;
-  const applicationId = record4.appId;
-  return {
-    url: routeThroughReverse(parsedUrl, devicePort).toString(),
-    runtime: requestedRuntime,
-    source: "open",
-    ...validApplicationId(applicationId) ? { applicationId } : {}
-  };
-}
-function parseLegacyResponse(response, runtime, devicePort) {
+function parseLinkResponse(response, runtime, devicePort) {
   if (response.status !== 307)
     return;
   const parsedUrl = parseLaunchUrl(response.location);
@@ -39964,35 +39934,27 @@ async function resolveExpoLaunch(options) {
   options.signal?.addEventListener("abort", abort, { once: true });
   const timer = setTimeout(() => controller.abort(new Error("Expo launch request timed out")), timeoutMs);
   try {
-    const openUrl = new URL("/_expo/open", endpoint);
-    openUrl.searchParams.set("platform", "android");
-    openUrl.searchParams.set("runtime", options.runtime);
-    try {
-      const response = await request(openUrl.toString(), controller.signal);
-      const target = parseOpenResponse(response, options.runtime, options.devicePort);
-      if (target !== undefined)
-        return { status: "resolved", target };
-    } catch {
-      if (aborted4(options.signal))
-        return { status: "aborted" };
-    }
-    const legacyUrl = new URL("/_expo/link", endpoint);
-    legacyUrl.searchParams.set("platform", "android");
+    const linkUrl = new URL("/_expo/link", endpoint);
+    linkUrl.searchParams.set("platform", "android");
     if (options.runtime === "custom")
-      legacyUrl.searchParams.set("choice", "expo-dev-client");
+      linkUrl.searchParams.set("choice", "expo-dev-client");
     try {
-      const response = await request(legacyUrl.toString(), controller.signal);
-      const target = parseLegacyResponse(response, options.runtime, options.devicePort);
+      const response = await request(linkUrl.toString(), controller.signal);
+      const target = parseLinkResponse(response, options.runtime, options.devicePort);
       if (target !== undefined)
         return { status: "resolved", target };
+      return {
+        status: "unavailable",
+        detail: response.status !== 307 ? `Expo /_expo/link returned HTTP ${String(response.status)} instead of a redirect.` : response.location === undefined ? "Expo /_expo/link returned a redirect without a Location header." : "Expo /_expo/link returned an invalid or unsafe Android launch URL."
+      };
     } catch {
       if (aborted4(options.signal))
         return { status: "aborted" };
+      return {
+        status: "unavailable",
+        detail: controller.signal.aborted ? `Expo /_expo/link did not respond within ${String(timeoutMs)}ms.` : "Expo /_expo/link could not be reached."
+      };
     }
-    return {
-      status: "unavailable",
-      detail: "Metro did not provide a valid Android launch URL through /_expo/open or the compatible /_expo/link endpoint."
-    };
   } finally {
     clearTimeout(timer);
     options.signal?.removeEventListener("abort", abort);
@@ -53369,4 +53331,4 @@ try {
   process14.removeListener("SIGTERM", abort);
 }
 
-//# debugId=241ECDA59C347B2F64756E2164756E21
+//# debugId=BE31AB70DE4A62C764756E2164756E21

package/docs/dev-sessions.md

@@ -132,8 +132,8 @@ transport, even when `ANDROID_SERIAL` names one device. ADB Ready therefore
 does not add `--android` to detected Expo commands. After Metro passes
 readiness, ADB Ready:
 
-1. asks Expo's public `/_expo/open` endpoint for the Android deep link, with a
-   bounded `/_expo/link` fallback for Expo 55;
+1. asks Expo's bounded `/_expo/link` redirect endpoint for the Android deep
+   link used by Expo Go or the project development client;
 2. routes local-network Metro URLs through the verified reverse mapping while
    preserving public tunnel URLs;
 3. resolves the installed URL handler on the selected transport; and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adb-ready",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Agent-ready Android CLI for reliable ADB sessions, app automation, and verified evidence.",
   "private": false,
   "type": "module",

package/schema/agent-tools-v1.json

@@ -1,7 +1,7 @@
 {
   "title": "ADB Ready agent tool contract",
   "schemaVersion": 1,
-  "packageVersion": "0.4.0",
+  "packageVersion": "0.4.1",
   "protocolVersion": "2025-11-25",
   "transport": "stdio",
   "tools": [