@swmansion/argent 0.28.1-next.24 → 0.28.1-next.26

package/dist/cli-cmds.mjs

@@ -30095,7 +30095,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID2 = randomUUID5();
 function readCliVersion() {
   if (true) {
-    return "0.28.1-next.24";
+    return "0.28.1-next.25";
   }
   return "0.0.0";
 }

package/dist/installer.mjs

@@ -16739,7 +16739,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID = randomUUID4();
 function readCliVersion() {
   if (true) {
-    return "0.28.1-next.24";
+    return "0.28.1-next.25";
   }
   return "0.0.0";
 }

package/dist/tool-args.generated.d.ts

@@ -802,7 +802,7 @@ export interface ArgentToolArgs {
         udid: string;
         /** Orientation override for the screenshot (rotates the captured image after Page.captureScreenshot on Chromium). On Android the capture already follows the device's rotation. Ignored on physical iPhones. */
         rotation?: "Portrait" | "LandscapeLeft" | "LandscapeRight" | "PortraitUpsideDown";
-        /** Scale factor (0.01-1.0). Defaults to ARGENT_SCREENSHOT_SCALE env var, or 0.25 if unset for iOS/Android. On Chromium the default is 1.0 (no downscale); pass <1 to opt in. Downscaling on Chromium requires the optional `sharp` dependency. */
+        /** Scale factor (0.01-1.0). Defaults to ARGENT_SCREENSHOT_SCALE env var, or 0.25 if unset for iOS/Android. On a local Apple TV simulator, an Android TV or Vega, with neither set, the capture is downscaled to a 576 px long side (0.15 of a 4K capture); an Android TV whose form factor or display size cannot be read in time keeps 0.25. On Chromium the default is 1.0 (no downscale); pass <1 to opt in. Downscaling on Chromium requires the optional `sharp` dependency. */
         scale?: number;
         /** Default true. Set false only when capturing a full-resolution PNG (scale: 1.0) to save as a baseline/current for screenshot-diff. The file is still written, but the image bytes are not attached to the agent context. */
         includeImageInContext?: boolean;

package/dist/tool-server.cjs

@@ -94923,7 +94923,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID = (0, import_node_crypto3.randomUUID)();
 function readCliVersion() {
   if (true) {
-    return "0.28.1-next.24";
+    return "0.28.1-next.25";
   }
   return "0.0.0";
 }
@@ -107957,6 +107957,7 @@ var os5 = __toESM(require("node:os"));
 var import_node_crypto6 = require("node:crypto");
 var import_node_url = require("node:url");
 var DEFAULT_SCREENSHOT_SCALE = 0.25;
+var TV_DEFAULT_LONG_SIDE = 576;
 var NO_IMAGE_ERROR = /no image to export/i;
 var FIRST_FRAME_WAIT_MS = 6e3;
 var FIRST_FRAME_POLL_MS = 250;
@@ -108312,19 +108313,24 @@ async function simulatorPost(toolLabel, api, endpoint, reqBody, signal, fallback
   return { res, body };
 }
 var warnedScaleValue;
-function getScreenshotScale() {
+function getScreenshotScaleOverride() {
   const v = process.env.ARGENT_SCREENSHOT_SCALE;
-  if (v) {
-    const n = parseFloat(v);
-    if (!Number.isNaN(n) && n >= 0.01 && n <= 1) return n;
-    if (v !== warnedScaleValue) {
-      warnedScaleValue = v;
-      console.warn(
-        `[screenshot] Ignoring ARGENT_SCREENSHOT_SCALE=${v}: expected a number between 0.01 and 1.0. Using ${DEFAULT_SCREENSHOT_SCALE}.`
-      );
-    }
+  if (!v) return void 0;
+  const n = parseFloat(v);
+  if (!Number.isNaN(n) && n >= 0.01 && n <= 1) return n;
+  if (v !== warnedScaleValue) {
+    warnedScaleValue = v;
+    console.warn(
+      `[screenshot] Ignoring ARGENT_SCREENSHOT_SCALE=${v}: expected a number between 0.01 and 1.0. Using the default.`
+    );
   }
-  return DEFAULT_SCREENSHOT_SCALE;
+  return void 0;
+}
+function getScreenshotScale() {
+  return getScreenshotScaleOverride() ?? DEFAULT_SCREENSHOT_SCALE;
+}
+function tvDefaultScale(width, height) {
+  return Math.min(1, TV_DEFAULT_LONG_SIDE / Math.max(width, height));
 }
 async function httpScreenshot(api, rotation, signal, scale, screen) {
   if (api.transport) {
@@ -121532,9 +121538,10 @@ async function bootElectronApp(options) {
   }
   const onSpawnError = (err, reject) => {
     const codeSuffix = err.code ? ` (${err.code})` : "";
+    const installHint = launcher.command === "electron" && err.code === "ENOENT" ? ` Make sure 'electron' is installed (npm i electron in the app dir, or globally) and on PATH.` : "";
     reject(
       new FailureError(
-        `Electron boot: failed to launch ${launcher.command}${codeSuffix}: ${err.message}. Make sure 'electron' is installed (npm i electron in the app dir, or globally) and on PATH.`,
+        `Electron boot: failed to launch ${launcher.command}${codeSuffix}: ${err.message}.${installHint}`,
         {
           error_code: FAILURE_CODES.CHROMIUM_ELECTRON_SPAWN_FAILED,
           failure_stage: "electron_spawn_error",
@@ -121555,18 +121562,21 @@ async function bootElectronApp(options) {
   };
   child.once("error", spawnErrorListener);
   if (!child.pid) {
-    child.removeListener("error", spawnErrorListener);
-    spawnErrorReject = null;
-    throw new FailureError(
-      `Electron boot: spawn returned without a pid (binary: ${launcher.command}).`,
-      {
-        error_code: FAILURE_CODES.CHROMIUM_ELECTRON_SPAWN_FAILED,
-        failure_stage: "electron_spawn_no_pid",
-        failure_area: "tool_server",
-        error_kind: "subprocess",
-        failure_command: "electron"
-      }
-    );
+    return Promise.race([
+      spawnError,
+      sleepUnref(1e3).then(() => {
+        throw new FailureError(
+          `Electron boot: spawn returned without a pid (binary: ${launcher.command}).`,
+          {
+            error_code: FAILURE_CODES.CHROMIUM_ELECTRON_SPAWN_FAILED,
+            failure_stage: "electron_spawn_no_pid",
+            failure_area: "tool_server",
+            error_kind: "subprocess",
+            failure_command: "electron"
+          }
+        );
+      })
+    ]);
   }
   child.stderr?.on("data", (chunk) => {
     process.stderr.write(`[chromium-cdp-${port}] ${chunk}`);
@@ -123892,6 +123902,7 @@ var os13 = __toESM(require("node:os"));
 var path29 = __toESM(require("node:path"));
 init_zod();
 init_device_info();
+init_adb();
 
 // ../tool-server/src/utils/device-orientation.ts
 var import_node_fs13 = require("node:fs");
@@ -124443,7 +124454,7 @@ async function captureViaEmulatorConsole(opts) {
   }
 }
 function scalePng(src, scale) {
-  const s = scale ?? getScreenshotScale();
+  const s = scale ?? getScreenshotScaleOverride() ?? tvDefaultScale(src.width, src.height);
   if (s >= 1) return src;
   const outW = Math.max(1, Math.round(src.width * s));
   const outH = Math.max(1, Math.round(src.height * s));
@@ -124468,7 +124479,7 @@ var zodSchema16 = external_exports.object({
     "Orientation override for the screenshot (rotates the captured image after Page.captureScreenshot on Chromium). On Android the capture already follows the device's rotation. Ignored on physical iPhones."
   ),
   scale: external_exports.number().min(0.01).max(1).optional().describe(
-    "Scale factor (0.01-1.0). Defaults to ARGENT_SCREENSHOT_SCALE env var, or 0.25 if unset for iOS/Android. On Chromium the default is 1.0 (no downscale); pass <1 to opt in. Downscaling on Chromium requires the optional `sharp` dependency."
+    "Scale factor (0.01-1.0). Defaults to ARGENT_SCREENSHOT_SCALE env var, or 0.25 if unset for iOS/Android. On a local Apple TV simulator, an Android TV or Vega, with neither set, the capture is downscaled to a 576 px long side (0.15 of a 4K capture); an Android TV whose form factor or display size cannot be read in time keeps 0.25. On Chromium the default is 1.0 (no downscale); pass <1 to opt in. Downscaling on Chromium requires the optional `sharp` dependency."
   ),
   includeImageInContext: external_exports.boolean().optional().default(true).describe(
     "Default true. Set false only when capturing a full-resolution PNG (scale: 1.0) to save as a baseline/current for screenshot-diff. The file is still written, but the image bytes are not attached to the agent context."
@@ -124503,7 +124514,7 @@ async function tvScreenshot(udid, scale, signal) {
   await execFileAsync25("xcrun", await simctlArgsForUdid(udid, ["io", udid, "screenshot", file2]), {
     signal
   });
-  if (scale < 1) {
+  if (scale === void 0 || scale < 1) {
     await execFileAsync25("sips", ["-Z", String(await tvTargetLongSide(file2, scale)), file2], {
       signal
     }).catch(() => {
@@ -124522,7 +124533,28 @@ async function tvTargetLongSide(file2, scale) {
     }
   } catch {
   }
-  return Math.round(longSide * scale);
+  return scale === void 0 ? Math.min(TV_DEFAULT_LONG_SIDE, longSide) : Math.round(longSide * scale);
+}
+var ANDROID_TV_PROBE_BUDGET_MS = 2e3;
+async function androidTvDefaultScale(serial, notBefore) {
+  if (getScreenshotScaleOverride() !== void 0) return void 0;
+  const probe3 = Promise.all([
+    isAndroidTv(serial).catch(() => false),
+    getAndroidScreenSize(serial).catch(() => void 0)
+  ]).then(([isTv, size]) => isTv && size ? tvDefaultScale(size.width, size.height) : void 0);
+  let timer;
+  const budget = new Promise((resolve14) => {
+    timer = setTimeout(resolve14, ANDROID_TV_PROBE_BUDGET_MS);
+  });
+  try {
+    return await Promise.race([
+      probe3,
+      Promise.all([budget, notBefore.catch(() => {
+      })]).then(() => void 0)
+    ]);
+  } finally {
+    clearTimeout(timer);
+  }
 }
 async function downscalePngInPlace(file2, scale, signal) {
   if (scale >= 1) {
@@ -124589,7 +124621,11 @@ Fails if the simulator-server / emulator backend / Chromium CDP is not reachable
         return { image: image2, ...note ? { [RESULT_NOTE_KEY]: note } : {} };
       }
       if (device.platform === "ios" && await isTvOsSimulator(params.udid)) {
-        const pngPath = await tvScreenshot(params.udid, scale, signal);
+        const pngPath = await tvScreenshot(
+          params.udid,
+          params.scale ?? getScreenshotScaleOverride(),
+          signal
+        );
         const image2 = await requireArtifacts(ctx).register({
           hostPath: pngPath,
           kind: "screenshot",
@@ -124615,14 +124651,18 @@ Fails if the simulator-server / emulator backend / Chromium CDP is not reachable
         return { image: image2, ...note ? { [RESULT_NOTE_KEY]: note } : {} };
       }
       const ref = simulatorServerRef(device);
-      const api = await registry2.resolveService(ref.urn, ref.options);
+      const apiReady = registry2.resolveService(ref.urn, ref.options);
+      const [api, androidTvScale] = await Promise.all([
+        apiReady,
+        params.scale === void 0 && device.platform === "android" ? androidTvDefaultScale(device.id, apiReady) : void 0
+      ]);
       const panel = await resolveCapturePanel(api);
       const { path: capturedPath } = await captureScreenshotUpright(
         api,
         device,
         params.rotation,
         signal,
-        params.scale,
+        params.scale ?? androidTvScale,
         panel ? (a, r, s, sc) => httpScreenshot(a, r, s, sc, panel.screen) : void 0,
         androidDevtoolsRotationPeek(registry2, device)
       );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swmansion/argent",
-  "version": "0.28.1-next.24",
+  "version": "0.28.1-next.26",
   "mcpName": "io.github.software-mansion/argent",
   "description": "MCP server for iOS Simulator and Android Emulator control",
   "license": "Apache-2.0",