@swmansion/argent 0.30.2-next.9 → 0.31.0

package/dist/cli-cmds.mjs

@@ -9085,6 +9085,7 @@ function spawnToolsServer(paths, port, options = {}) {
       stdio: ["ignore", "pipe", logFd],
       env: buildToolsServerEnv(paths, port, process.env, options)
     });
+    fs.closeSync(logFd);
     child.unref();
     const pid = child.pid;
     if (!pid) {
@@ -9854,6 +9855,7 @@ var FAILURE_CODES = {
   REACT_PROFILER_DEVTOOLS_RENDERER_MISSING: "REACT_PROFILER_DEVTOOLS_RENDERER_MISSING",
   REACT_PROFILER_START_FAILED: "REACT_PROFILER_START_FAILED",
   REACT_PROFILER_START_VERIFY_FAILED: "REACT_PROFILER_START_VERIFY_FAILED",
+  REACT_PROFILER_SESSION_TORN_DOWN: "REACT_PROFILER_SESSION_TORN_DOWN",
   REACT_PROFILER_HOOK_ERROR: "REACT_PROFILER_HOOK_ERROR",
   REACT_PROFILER_ANALYZE_NO_DATA: "REACT_PROFILER_ANALYZE_NO_DATA",
   NATIVE_PROFILER_FACTORY_OPTIONS_MISSING: "NATIVE_PROFILER_FACTORY_OPTIONS_MISSING",
@@ -30809,8 +30811,13 @@ async function consumeToolStream(name, body, onProgress, signal) {
     if (msg.event === "progress") {
       progress++;
       onProgress(msg.data);
-    } else if (msg.event === "result") final = { data: msg.data, note: msg.note };
-    else if (msg.event === "error") {
+    } else if (msg.event === "result") {
+      final = {
+        data: msg.data,
+        note: msg.note,
+        ...msg.profiling === true ? { profiling: true } : {}
+      };
+    } else if (msg.event === "error") {
       throw new ToolInvocationError(msg.error ?? "tool invocation failed", {
         errorCode: msg.error_code,
         errorKind: msg.error_kind
@@ -30857,7 +30864,11 @@ async function consumeToolStream(name, body, onProgress, signal) {
   if (!final) {
     throw brokenStream(name, "the stream ended without a result", progress);
   }
-  return { data: final.data, note: final.note };
+  return {
+    data: final.data,
+    note: final.note,
+    ...final.profiling ? { profiling: true } : {}
+  };
 }
 function errorBodyMessage(body) {
   if (Array.isArray(body.issues) && typeof body.message === "string") return body.message;
@@ -31030,7 +31041,8 @@ function createToolsClient(options = {}) {
       return {
         data: await settle2(streamed.data),
         note: streamed.note,
-        outputHint: meta3?.outputHint
+        outputHint: meta3?.outputHint,
+        ...streamed.profiling ? { profiling: true } : {}
       };
     }
     let json2;
@@ -31055,7 +31067,12 @@ function createToolsClient(options = {}) {
       });
     }
     opts?.signal?.throwIfAborted();
-    return { data: await settle2(json2.data), note: json2.note, outputHint: meta3?.outputHint };
+    return {
+      data: await settle2(json2.data),
+      note: json2.note,
+      outputHint: meta3?.outputHint,
+      ...json2.profiling === true ? { profiling: true } : {}
+    };
   }
   return { fetchTools, fetchTool, callTool, baseUrl };
 }
@@ -35577,7 +35594,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID2 = randomUUID5();
 function readCliVersion() {
   if (true) {
-    return "0.30.2-next.9";
+    return "0.31.0";
   }
   return "0.0.0";
 }
@@ -38102,7 +38119,7 @@ function parseStartFlags(argv) {
   }
   return {
     port: options.port === void 0 ? null : parsePort(options.port),
-    host: options.host ?? "127.0.0.1",
+    host: options.host?.trim() || "127.0.0.1",
     idleTimeoutMinutes: options["idle-timeout"] === void 0 ? 0 : parseIdle(options["idle-timeout"]),
     detach: options.detach === true,
     force: options.force === true,
@@ -38159,7 +38176,7 @@ function isLoopback(host) {
   return host === "127.0.0.1" || host === "localhost" || host === "::1";
 }
 function isWildcard(host) {
-  return host === "0.0.0.0" || host === "::" || host === "::0" || host === "";
+  return host === "0.0.0.0" || host === "::" || host === "::0";
 }
 function primaryLanIPv4() {
   const ifaces = networkInterfaces();

package/dist/client.js

@@ -8301,6 +8301,7 @@ function spawnToolsServer(paths, port, options = {}) {
       stdio: ["ignore", "pipe", logFd],
       env: buildToolsServerEnv(paths, port, process.env, options)
     });
+    fs4.closeSync(logFd);
     child.unref();
     const pid = child.pid;
     if (!pid) {
@@ -9058,6 +9059,7 @@ var FAILURE_CODES = {
   REACT_PROFILER_DEVTOOLS_RENDERER_MISSING: "REACT_PROFILER_DEVTOOLS_RENDERER_MISSING",
   REACT_PROFILER_START_FAILED: "REACT_PROFILER_START_FAILED",
   REACT_PROFILER_START_VERIFY_FAILED: "REACT_PROFILER_START_VERIFY_FAILED",
+  REACT_PROFILER_SESSION_TORN_DOWN: "REACT_PROFILER_SESSION_TORN_DOWN",
   REACT_PROFILER_HOOK_ERROR: "REACT_PROFILER_HOOK_ERROR",
   REACT_PROFILER_ANALYZE_NO_DATA: "REACT_PROFILER_ANALYZE_NO_DATA",
   NATIVE_PROFILER_FACTORY_OPTIONS_MISSING: "NATIVE_PROFILER_FACTORY_OPTIONS_MISSING",
@@ -10189,8 +10191,13 @@ async function consumeToolStream(name, body, onProgress, signal) {
     if (msg.event === "progress") {
       progress++;
       onProgress(msg.data);
-    } else if (msg.event === "result") final = { data: msg.data, note: msg.note };
-    else if (msg.event === "error") {
+    } else if (msg.event === "result") {
+      final = {
+        data: msg.data,
+        note: msg.note,
+        ...msg.profiling === true ? { profiling: true } : {}
+      };
+    } else if (msg.event === "error") {
       throw new ToolInvocationError(msg.error ?? "tool invocation failed", {
         errorCode: msg.error_code,
         errorKind: msg.error_kind
@@ -10237,7 +10244,11 @@ async function consumeToolStream(name, body, onProgress, signal) {
   if (!final) {
     throw brokenStream(name, "the stream ended without a result", progress);
   }
-  return { data: final.data, note: final.note };
+  return {
+    data: final.data,
+    note: final.note,
+    ...final.profiling ? { profiling: true } : {}
+  };
 }
 function errorBodyMessage(body) {
   if (Array.isArray(body.issues) && typeof body.message === "string") return body.message;
@@ -10410,7 +10421,8 @@ function createToolsClient(options = {}) {
       return {
         data: await settle(streamed.data),
         note: streamed.note,
-        outputHint: meta?.outputHint
+        outputHint: meta?.outputHint,
+        ...streamed.profiling ? { profiling: true } : {}
       };
     }
     let json;
@@ -10435,7 +10447,12 @@ function createToolsClient(options = {}) {
       });
     }
     opts?.signal?.throwIfAborted();
-    return { data: await settle(json.data), note: json.note, outputHint: meta?.outputHint };
+    return {
+      data: await settle(json.data),
+      note: json.note,
+      outputHint: meta?.outputHint,
+      ...json.profiling === true ? { profiling: true } : {}
+    };
   }
   return { fetchTools, fetchTool, callTool, baseUrl };
 }

package/dist/installer.mjs

@@ -15962,6 +15962,7 @@ var FAILURE_CODES = {
   REACT_PROFILER_DEVTOOLS_RENDERER_MISSING: "REACT_PROFILER_DEVTOOLS_RENDERER_MISSING",
   REACT_PROFILER_START_FAILED: "REACT_PROFILER_START_FAILED",
   REACT_PROFILER_START_VERIFY_FAILED: "REACT_PROFILER_START_VERIFY_FAILED",
+  REACT_PROFILER_SESSION_TORN_DOWN: "REACT_PROFILER_SESSION_TORN_DOWN",
   REACT_PROFILER_HOOK_ERROR: "REACT_PROFILER_HOOK_ERROR",
   REACT_PROFILER_ANALYZE_NO_DATA: "REACT_PROFILER_ANALYZE_NO_DATA",
   NATIVE_PROFILER_FACTORY_OPTIONS_MISSING: "NATIVE_PROFILER_FACTORY_OPTIONS_MISSING",
@@ -16899,7 +16900,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID = randomUUID4();
 function readCliVersion() {
   if (true) {
-    return "0.30.2-next.9";
+    return "0.31.0";
   }
   return "0.0.0";
 }

package/dist/mcp-server.mjs

@@ -24566,6 +24566,7 @@ function spawnToolsServer(paths, port, options = {}) {
       stdio: ["ignore", "pipe", logFd],
       env: buildToolsServerEnv(paths, port, process.env, options)
     });
+    fs.closeSync(logFd);
     child.unref();
     const pid = child.pid;
     if (!pid) {
@@ -25313,6 +25314,7 @@ var FAILURE_CODES = {
   REACT_PROFILER_DEVTOOLS_RENDERER_MISSING: "REACT_PROFILER_DEVTOOLS_RENDERER_MISSING",
   REACT_PROFILER_START_FAILED: "REACT_PROFILER_START_FAILED",
   REACT_PROFILER_START_VERIFY_FAILED: "REACT_PROFILER_START_VERIFY_FAILED",
+  REACT_PROFILER_SESSION_TORN_DOWN: "REACT_PROFILER_SESSION_TORN_DOWN",
   REACT_PROFILER_HOOK_ERROR: "REACT_PROFILER_HOOK_ERROR",
   REACT_PROFILER_ANALYZE_NO_DATA: "REACT_PROFILER_ANALYZE_NO_DATA",
   NATIVE_PROFILER_FACTORY_OPTIONS_MISSING: "NATIVE_PROFILER_FACTORY_OPTIONS_MISSING",
@@ -26485,8 +26487,13 @@ async function consumeToolStream(name, body, onProgress, signal) {
     if (msg.event === "progress") {
       progress++;
       onProgress(msg.data);
-    } else if (msg.event === "result") final = { data: msg.data, note: msg.note };
-    else if (msg.event === "error") {
+    } else if (msg.event === "result") {
+      final = {
+        data: msg.data,
+        note: msg.note,
+        ...msg.profiling === true ? { profiling: true } : {}
+      };
+    } else if (msg.event === "error") {
       throw new ToolInvocationError(msg.error ?? "tool invocation failed", {
         errorCode: msg.error_code,
         errorKind: msg.error_kind
@@ -26533,7 +26540,11 @@ async function consumeToolStream(name, body, onProgress, signal) {
   if (!final) {
     throw brokenStream(name, "the stream ended without a result", progress);
   }
-  return { data: final.data, note: final.note };
+  return {
+    data: final.data,
+    note: final.note,
+    ...final.profiling ? { profiling: true } : {}
+  };
 }
 function errorBodyMessage(body) {
   if (Array.isArray(body.issues) && typeof body.message === "string") return body.message;
@@ -26706,7 +26717,8 @@ function createToolsClient(options = {}) {
       return {
         data: await settle2(streamed.data),
         note: streamed.note,
-        outputHint: meta2?.outputHint
+        outputHint: meta2?.outputHint,
+        ...streamed.profiling ? { profiling: true } : {}
       };
     }
     let json;
@@ -26731,7 +26743,12 @@ function createToolsClient(options = {}) {
       });
     }
     opts?.signal?.throwIfAborted();
-    return { data: await settle2(json.data), note: json.note, outputHint: meta2?.outputHint };
+    return {
+      data: await settle2(json.data),
+      note: json.note,
+      outputHint: meta2?.outputHint,
+      ...json.profiling === true ? { profiling: true } : {}
+    };
   }
   return { fetchTools, fetchTool, callTool, baseUrl };
 }
@@ -28514,6 +28531,7 @@ var AUTO_SCREENSHOT_DELAY_MS_BY_TOOL = {
   "await-ui-element": 1500
 };
 var DEFAULT_DELAY_MS = 1400;
+var CAPTURE_TIMEOUT_MS = 15e3;
 function autoScreenshotEnabled(options) {
   return !isFlagEnabled("disable-auto-screenshot", options);
 }
@@ -28539,6 +28557,7 @@ var AUTO_DESCRIBE_TOOLS = /* @__PURE__ */ new Set([
 function autoDescribeEnabled(options) {
   return !isFlagEnabled("disable-auto-describe", options);
 }
+var PROFILING_CAPTURE_SKIPPED_NOTE = "Auto-screenshot and element tree skipped while a profiler is recording on this device. Call screenshot or describe if you need to see the screen.";
 var AUTO_DESCRIBE_HEADER = "--- Elements after action (describe) ---";
 function shouldAutoDescribe(toolName) {
   return AUTO_DESCRIBE_TOOLS.has(normalizeToolName(toolName));
@@ -28594,6 +28613,7 @@ function toMcpTool(t) {
     name: t.name,
     description: t.description,
     inputSchema: { type: "object", ...withoutRetiredParams(t.inputSchema) },
+    ...t.readOnly ? { annotations: { readOnlyHint: true } } : {},
     ...Object.keys(meta2).length > 0 ? { _meta: meta2 } : {}
   };
 }
@@ -28629,22 +28649,50 @@ async function fetchWithReconnect(getUrl, reconnect, config2) {
   for (let attempt = 0; attempt <= maxRetries; attempt++) {
     const controller = new AbortController();
     const timer = fetchTimeoutMs !== null ? setTimeout(() => controller.abort(), fetchTimeoutMs) : void 0;
+    let callerSignal;
     try {
       const attemptInit = typeof init === "function" ? init() : init;
-      return await fetch(getUrl(), { ...attemptInit, signal: controller.signal });
+      callerSignal = attemptInit?.signal;
+      const signal = callerSignal ? AbortSignal.any([controller.signal, callerSignal]) : controller.signal;
+      return await fetch(getUrl(), { ...attemptInit, signal });
     } catch (err) {
       lastError = err;
-      if (attempt === maxRetries) break;
-      if (attempt === 0) {
-        await reconnect();
+      if (callerSignal?.aborted || attempt === maxRetries) break;
+      const pause = (async () => {
+        if (attempt === 0) {
+          await reconnect();
+        }
+        await new Promise((r) => setTimeout(r, expBackoffBase * Math.pow(2, attempt)));
+      })();
+      await untilAborted(pause, callerSignal);
+      if (callerSignal?.aborted) {
+        lastError = callerSignal.reason;
+        break;
       }
-      await new Promise((r) => setTimeout(r, expBackoffBase * Math.pow(2, attempt)));
     } finally {
       clearTimeout(timer);
     }
   }
   throw lastError;
 }
+async function untilAborted(work, signal) {
+  if (!signal) {
+    await work;
+    return;
+  }
+  let onAbort = () => {
+  };
+  const aborted2 = new Promise((resolve10) => {
+    onAbort = resolve10;
+    if (signal.aborted) resolve10();
+    else signal.addEventListener("abort", onAbort, { once: true });
+  });
+  try {
+    await Promise.race([work, aborted2]);
+  } finally {
+    signal.removeEventListener("abort", onAbort);
+  }
+}
 function parseUrl(url) {
   let parsed;
   try {
@@ -28689,9 +28737,9 @@ function createToolCaller(deps) {
   });
   return {
     fetchTools: client.fetchTools,
-    async callTool(name, args) {
-      const { data, note, outputHint } = await client.callTool(name, args);
-      return { result: data, outputHint, note };
+    async callTool(name, args, opts) {
+      const { data, note, outputHint, profiling } = await client.callTool(name, args, opts);
+      return { result: data, outputHint, note, ...profiling ? { profiling } : {} };
     }
   };
 }
@@ -28705,6 +28753,7 @@ async function startMcpServer(options) {
   }
   const autoScreenshotOn = autoScreenshotEnabled();
   const autoDescribeOn = autoDescribeEnabled();
+  const captureTimeoutMs = options.captureTimeoutMs ?? CAPTURE_TIMEOUT_MS;
   let TOOLS_URL;
   let AUTH_TOKEN;
   const resolved = await getResolvedToolsUrl();
@@ -28767,8 +28816,14 @@ async function startMcpServer(options) {
   async function awaitScreenSettled(udid, toolName) {
     const maxWaitMs = getAutoScreenshotDelayMs(toolName);
     if (maxWaitMs === 0) return true;
+    const started = Date.now();
     try {
-      const idle = await callTool("await-screen-idle", { udid, timeoutMs: maxWaitMs });
+      const idle = await callTool(
+        "await-screen-idle",
+        { udid, timeoutMs: maxWaitMs },
+        // The tool bounds its poll to maxWaitMs; the rest covers its setup.
+        { signal: AbortSignal.timeout(maxWaitMs + captureTimeoutMs) }
+      );
       await spyLog({
         ts: (/* @__PURE__ */ new Date()).toISOString(),
         event: "auto_screenshot_readiness",
@@ -28778,13 +28833,13 @@ async function startMcpServer(options) {
       });
       return idle.result?.settled === true;
     } catch {
-      await new Promise((r) => setTimeout(r, maxWaitMs));
+      await new Promise((r) => setTimeout(r, Math.max(0, maxWaitMs - (Date.now() - started))));
       return false;
     }
   }
-  async function captureScreenshotBlocks(udid) {
+  async function captureScreenshotBlocks(udid, signal) {
     try {
-      const { result } = await callTool("screenshot", { udid });
+      const { result } = await callTool("screenshot", { udid }, { signal });
       const blocks = await toMcpContent(result, "image", {
         toolsUrl: TOOLS_URL,
         authToken: AUTH_TOKEN,
@@ -28796,10 +28851,10 @@ async function startMcpServer(options) {
       return [];
     }
   }
-  async function captureTreeBlocks(udid, toolName) {
+  async function captureTreeBlocks(udid, toolName, signal) {
     const t1 = Date.now();
     try {
-      const d = await callTool("describe", { udid });
+      const d = await callTool("describe", { udid }, { signal });
       const desc = d.result?.description;
       await spyLog({
         ts: (/* @__PURE__ */ new Date()).toISOString(),
@@ -28855,7 +28910,7 @@ ${desc}` }];
       args: params.arguments
     });
     try {
-      const { result, outputHint, note } = await callTool(params.name, params.arguments);
+      const { result, outputHint, note, profiling } = await callTool(params.name, params.arguments);
       await spyLog({
         ts: (/* @__PURE__ */ new Date()).toISOString(),
         event: "tool_result",
@@ -28888,11 +28943,17 @@ ${desc}` }];
             text: "Auto-screenshot and element tree skipped: the input contains a {{secret:\u2026}} placeholder, and a capture of this screen could reveal the typed secret. The secret is already typed \u2014 do not send the typing step again, or the field will hold two copies of it. Submit or navigate away, then verify the resulting screen as usual. Only this call is covered: the next call is captured normally, and shows the secret if the field is still on screen. To cover the submit as well, put the typing and the submit in ONE `run-sequence` the next time you type a secret."
           }
         ];
+      } else if (udid && (wantScreenshot || wantTree) && profiling) {
+        if (params.name !== "describe") {
+          await awaitScreenSettled(udid, params.name);
+          content = [...content, { type: "text", text: PROFILING_CAPTURE_SKIPPED_NOTE }];
+        }
       } else if (udid && (wantScreenshot || wantTree)) {
         const screenSettled = await awaitScreenSettled(udid, params.name);
-        const screenshot = wantScreenshot ? captureScreenshotBlocks(udid) : Promise.resolve([]);
+        const signal = AbortSignal.timeout(captureTimeoutMs);
+        const screenshot = wantScreenshot ? captureScreenshotBlocks(udid, signal) : Promise.resolve([]);
         if (!screenSettled) await screenshot;
-        const tree = wantTree ? captureTreeBlocks(udid, params.name) : Promise.resolve([]);
+        const tree = wantTree ? captureTreeBlocks(udid, params.name, signal) : Promise.resolve([]);
         content = [...content, ...await screenshot, ...await tree];
       }
       if (note) {

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

@@ -53,6 +53,8 @@ export interface ArgentToolArgs {
         force?: boolean;
         /** Android only: boot the emulator with audio output enabled. Defaults to false: argent boots emulators MUTED so several agent-driven devices don't all play sound on the host machine; pass `true` when the task involves playing, hearing, or testing audio. Takes effect at boot: if the emulator is already running muted, add `force: true` to reboot it with sound. A boot snapshot saved in the other audio mode can't be reused, so the first boot after toggling is a slower cold boot. The `boot-sound` argent flag flips this default to true. Ignored on iOS/Vega/HarmonyOS/Electron, which argent never mutes. */
         sound?: boolean;
+        /** Android on a macOS host only: boot the emulator with guest Vulkan. Defaults to false: guest Vulkan crashes Chrome's GPU process, which breaks Chrome and Custom Tab sign-in flows. Without it apps find no Vulkan device, although the guest still lists the Vulkan features, so a Vulkan-only renderer such as WebGPU (react-native-wgpu) draws nothing; pass `true` to test one. Takes effect at boot: an emulator already running in the other mode is reused with a `note`, and `force: true` reboots it. A boot snapshot saved in the other mode can't be reused, so the first boot after toggling is a slower cold boot. The `ARGENT_EMULATOR_GUEST_VULKAN` env var flips this default to true. Ignored on other hosts and platforms. */
+        guestVulkan?: boolean;
         /** iOS only: boot the simulator core WITHOUT opening its GUI window (Simulator.app, or Device Hub on Xcode 27+). The device still streams via simulator-server; used by Argent Lens. Set the `ARGENT_SIMULATOR_NO_WINDOW` env var (1/true/yes) to force this host-wide without passing the flag per call (the iOS analog of `ARGENT_EMULATOR_NO_WINDOW`). Ignored on Android/Vega/HarmonyOS/Electron, which have no equivalent GUI step. */
         headless?: boolean;
         /** Electron: path to the Electron app to launch. Either a packaged .app bundle / executable, or a project directory whose package.json points the Electron binary at the entry script. Provide exactly one of `udid`, `avdName`, `vvdImage`, `harmonyInstance`, or `electronAppPath`. */