@swmansion/argent 0.7.0-next.4 → 0.7.1

package/agents/argent-environment-inspector.md

@@ -11,7 +11,6 @@ description: >
   Use proactively at session start when required to gather the environment information.
   If subagent delegation is not available, run the steps in the main thread instead.
   The main agent is responsible for persisting the result to project memory.
-model: haiku
 ---
 
 You are the **environment-inspector** subagent. Your job is to inspect a mobile app

package/dist/cli.js

@@ -22,6 +22,7 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { BUNDLED_RUNTIME_PATHS } from "./bundled-paths.js";
+import { installFatalHandlers } from "./fatal-handlers.js";
 const PACKAGE_NAME = "@swmansion/argent";
 function getInstalledVersion() {
     try {
@@ -37,16 +38,7 @@ function getInstalledVersion() {
 }
 const [, , command, ...rest] = process.argv;
 const isMcpServer = command === "mcp";
-process.on("uncaughtException", (err) => {
-    process.stderr.write(`[argent] Uncaught exception: ${err.stack ?? err}\n`);
-    if (!isMcpServer)
-        process.exit(1);
-});
-process.on("unhandledRejection", (reason) => {
-    process.stderr.write(`[argent] Unhandled rejection: ${reason instanceof Error ? (reason.stack ?? reason.message) : reason}\n`);
-    if (!isMcpServer)
-        process.exit(1);
-});
+installFatalHandlers({ isMcpServer });
 function printHelp() {
     const version = getInstalledVersion() ?? "unknown";
     console.log(`

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/fatal-handlers.d.ts

@@ -0,0 +1,3 @@
+export declare function installFatalHandlers(opts: {
+    isMcpServer: boolean;
+}): void;

package/dist/fatal-handlers.js

@@ -0,0 +1,75 @@
+// Process-level handlers for uncaughtException and unhandledRejection.
+//
+// In MCP-server mode we do NOT exit on every uncaught error — many are
+// transient and the editor expects the server to keep running. But the naive
+// version (`stderr.write(...); if (!isMcp) exit`) burns 100% CPU when stderr
+// itself is broken (e.g. the parent process is gone): the write emits an
+// async 'error' event on the stream, which without a listener becomes another
+// uncaughtException, runs the handler, writes to the same broken stream, ...
+//
+// The fix has three pieces:
+//   1. `'error'` listeners on stdout/stderr — broken stdio is fatal; exit
+//      before the failure round-trips into uncaughtException. This is what
+//      breaks the production loop.
+//   2. try/catch around `stderr.write` — synchronous write failures also exit
+//      cleanly instead of escaping into another uncaughtException.
+//   3. try/catch around the formatter — a throwing `.stack` getter or
+//      `toString` (the production trace pointed at defaultPrepareStackTrace)
+//      can't take down the handler.
+//
+// When stdio is unusable we cannot tell the parent process what went wrong,
+// so we leave a breadcrumb on disk at `~/.argent/mcp-fatal.log`. Sibling of
+// the other persistent argent diagnostic logs (`tool-server.log`, etc.).
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+let installed = false;
+const FATAL_LOG_PATH = path.join(os.homedir(), ".argent", "mcp-fatal.log");
+function appendFatalLog(label, detail) {
+    try {
+        fs.mkdirSync(path.dirname(FATAL_LOG_PATH), { recursive: true });
+        const line = `[${new Date().toISOString()}] pid=${process.pid} ${label}: ${detail}\n`;
+        fs.appendFileSync(FATAL_LOG_PATH, line);
+    }
+    catch {
+        // Last-resort log — if even this write fails (read-only fs, missing home),
+        // there is nothing more we can do. Swallow so we still exit cleanly.
+    }
+}
+export function installFatalHandlers(opts) {
+    if (installed)
+        return;
+    installed = true;
+    for (const stream of [process.stdout, process.stderr]) {
+        const name = stream === process.stdout ? "stdout" : "stderr";
+        stream.on("error", (err) => {
+            appendFatalLog(`Broken ${name}`, String(err?.stack ?? err));
+            process.exit(1);
+        });
+    }
+    function reportFatal(label, getDetail) {
+        let detail;
+        try {
+            try {
+                detail = getDetail();
+            }
+            catch {
+                detail = "<failed to format>";
+            }
+            process.stderr.write(`[argent] ${label}: ${detail}\n`);
+        }
+        catch {
+            appendFatalLog(label, detail);
+            process.exit(1);
+        }
+        if (!opts.isMcpServer)
+            process.exit(1);
+    }
+    process.on("uncaughtException", (err) => {
+        reportFatal("Uncaught exception", () => String(err?.stack ?? err));
+    });
+    process.on("unhandledRejection", (reason) => {
+        reportFatal("Unhandled rejection", () => reason instanceof Error ? (reason.stack ?? reason.message) : String(reason));
+    });
+}
+//# sourceMappingURL=fatal-handlers.js.map

package/dist/fatal-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fatal-handlers.js","sourceRoot":"","sources":["../src/fatal-handlers.ts"],"names":[],"mappings":"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"}

package/dist/installer.mjs

@@ -12813,6 +12813,18 @@ function getInstalledVersion() {
     return null;
   }
 }
+function getGloballyInstalledVersion() {
+  const binaryPath = getGlobalBinaryPath();
+  if (!binaryPath) return null;
+  try {
+    const realPath = fs.realpathSync(binaryPath);
+    const pkgRoot = resolvePackageRoot(path.dirname(realPath));
+    const pkg = JSON.parse(fs.readFileSync(path.join(pkgRoot, "package.json"), "utf8"));
+    return pkg.version ?? null;
+  } catch {
+    return null;
+  }
+}
 var PROBE_TIMEOUT_MS = 3e3;
 function getLatestVersion() {
   const result = execSync(`npm view ${PACKAGE_NAME} version --registry ${NPM_REGISTRY}`, {
@@ -12835,18 +12847,21 @@ var TEMP_RUNNER_MARKERS = [
 function isTempRunnerPath(binaryPath) {
   return TEMP_RUNNER_MARKERS.some((marker) => binaryPath.includes(marker));
 }
-function isGloballyInstalled() {
+function getGlobalBinaryPath() {
   try {
     const cmd = process.platform === "win32" ? "where" : "which -a";
     const output = execSync(`${cmd} ${MCP_BINARY_NAME}`, {
       encoding: "utf8",
       stdio: ["ignore", "pipe", "ignore"]
     });
-    return output.split(/\r?\n/).map((line) => line.trim()).filter(Boolean).some((line) => !isTempRunnerPath(line));
+    return output.split(/\r?\n/).map((line) => line.trim()).filter(Boolean).find((line) => !isTempRunnerPath(line)) ?? null;
   } catch {
-    return false;
+    return null;
   }
 }
+function isGloballyInstalled() {
+  return getGlobalBinaryPath() !== null;
+}
 function isSkillsCliAvailable() {
   try {
     execSync("npx --no-install skills --version", {
@@ -14250,7 +14265,7 @@ async function update(args) {
   const nonInteractive = args.includes("--yes") || args.includes("-y");
   Wt2(import_picocolors3.default.bgCyan(import_picocolors3.default.black(" argent update ")));
   const globallyInstalled = isGloballyInstalled();
-  const installed = globallyInstalled ? getInstalledVersion() : null;
+  const installed = globallyInstalled ? getGloballyInstalledVersion() : null;
   if (globallyInstalled && !installed) {
     R2.error("Could not determine installed version.");
     process.exit(1);
@@ -14695,6 +14710,7 @@ export {
   MCP_BINARY_NAME,
   MCP_SERVER_KEY,
   PACKAGE_NAME,
+  getGloballyInstalledVersion,
   getInstalledVersion,
   init,
   uninstall,

package/dist/mcp-server.mjs

@@ -14154,7 +14154,7 @@ async function fetchWithReconnect(getUrl, reconnect, config2) {
   let lastError;
   for (let attempt = 0; attempt <= maxRetries; attempt++) {
     const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), fetchTimeoutMs);
+    const timer = fetchTimeoutMs !== null ? setTimeout(() => controller.abort(), fetchTimeoutMs) : void 0;
     try {
       return await fetch(getUrl(), { ...init, signal: controller.signal });
     } catch (err) {
@@ -14220,7 +14220,8 @@ async function startMcpServer(options) {
         method: "POST",
         headers: { "Content-Type": "application/json" },
         body: JSON.stringify(args ?? {})
-      }
+      },
+      fetchTimeoutMs: meta?.longRunning ? null : FETCH_TIMEOUT_MS
     });
     const json = await res.json();
     if (!res.ok) throw new Error(json.error ?? json.message ?? res.statusText);

package/dist/tool-server.cjs

@@ -18403,7 +18403,7 @@ var require_view = __commonJS({
     var path11 = require("path");
     var fs22 = require("fs");
     var dirname3 = path11.dirname;
-    var basename6 = path11.basename;
+    var basename5 = path11.basename;
     var extname = path11.extname;
     var join15 = path11.join;
     var resolve2 = path11.resolve;
@@ -18442,7 +18442,7 @@ var require_view = __commonJS({
         var root = roots[i];
         var loc = resolve2(root, name);
         var dir = dirname3(loc);
-        var file = basename6(loc);
+        var file = basename5(loc);
         path12 = this.resolve(dir, file);
       }
       return path12;
@@ -18458,7 +18458,7 @@ var require_view = __commonJS({
       if (stat2 && stat2.isFile()) {
         return path12;
       }
-      path12 = join15(dir, basename6(file, ext), "index" + ext);
+      path12 = join15(dir, basename5(file, ext), "index" + ext);
       stat2 = tryStat(path12);
       if (stat2 && stat2.isFile()) {
         return path12;
@@ -18539,7 +18539,7 @@ var require_content_disposition = __commonJS({
     "use strict";
     module2.exports = contentDisposition;
     module2.exports.parse = parse;
-    var basename6 = require("path").basename;
+    var basename5 = require("path").basename;
     var Buffer2 = require_safe_buffer().Buffer;
     var ENCODE_URL_ATTR_CHAR_REGEXP = /[\x00-\x20"'()*,/:;<=>?@[\\\]{}\x7f]/g;
     var HEX_ESCAPE_REGEXP = /%[0-9A-Fa-f]{2}/;
@@ -18575,9 +18575,9 @@ var require_content_disposition = __commonJS({
       if (typeof fallback === "string" && NON_LATIN1_REGEXP.test(fallback)) {
         throw new TypeError("fallback must be ISO-8859-1 string");
       }
-      var name = basename6(filename);
+      var name = basename5(filename);
       var isQuotedString = TEXT_REGEXP.test(name);
-      var fallbackName = typeof fallback !== "string" ? fallback && getlatin1(name) : basename6(fallback);
+      var fallbackName = typeof fallback !== "string" ? fallback && getlatin1(name) : basename5(fallback);
       var hasFallback = typeof fallbackName === "string" && fallbackName !== name;
       if (hasFallback || !isQuotedString || HEX_ESCAPE_REGEXP.test(name)) {
         params["filename*"] = name;
@@ -41478,6 +41478,9 @@ function zodTypeToJsonSchema(type) {
   if (type instanceof external_exports.ZodNumber) return { type: "number" };
   if (type instanceof external_exports.ZodBoolean) return { type: "boolean" };
   if (type instanceof external_exports.ZodOptional) return zodTypeToJsonSchema(type.unwrap());
+  if (type instanceof external_exports.ZodDefault) {
+    return { ...zodTypeToJsonSchema(type._def.innerType), default: type._def.defaultValue() };
+  }
   if (type instanceof external_exports.ZodArray) {
     return { type: "array", items: zodTypeToJsonSchema(type.element) };
   }
@@ -41493,7 +41496,7 @@ function zodTypeToJsonSchema(type) {
   return {};
 }
 function isOptional(type) {
-  return type instanceof external_exports.ZodOptional;
+  return type instanceof external_exports.ZodOptional || type instanceof external_exports.ZodDefault;
 }
 
 // ../registry/src/registry.ts
@@ -41948,7 +41951,7 @@ var import_node_https = __toESM(require("node:https"));
 var import_semver = __toESM(require_semver2());
 
 // ../tool-server/package.json
-var version = "0.7.0-next.4";
+var version = "0.7.1";
 
 // ../tool-server/src/utils/update-checker.ts
 var PACKAGE_NAME = "@swmansion/argent";
@@ -42492,11 +42495,15 @@ var ADB_KILL_SIGNAL = "SIGKILL";
 function describeAdbFailure(args, err) {
   const e = err;
   const argv = args.join(" ");
-  const stderrText = (e.stderr ?? "").trim();
-  const stdoutText = (e.stdout ?? "").trim();
-  const baseMsg = e.message ?? String(err);
-  const detail = stderrText || stdoutText || baseMsg;
-  return new Error(`adb ${argv} failed: ${detail}`);
+  const ioDetail = (e.stderr ?? "").trim() || (e.stdout ?? "").trim();
+  if (ioDetail) return new Error(`adb ${argv} failed: ${ioDetail}`);
+  const meta = [];
+  if (e.killed) meta.push("killed=true");
+  if (e.signal) meta.push(`signal=${e.signal}`);
+  if (e.code) meta.push(`code=${e.code}`);
+  const baseMsg = (e.message ?? String(err)).trim();
+  const suffix = meta.length ? ` (${meta.join(" ")})` : "";
+  return new Error(`adb ${argv} failed: ${baseMsg}${suffix}`);
 }
 async function runAdb(args, options = {}) {
   const adbPath = await resolveAdbOrThrow();
@@ -42933,6 +42940,7 @@ function createHttpApp(registry, options) {
       if (def?.outputHint) entry.outputHint = def.outputHint;
       if (def?.alwaysLoad) entry.alwaysLoad = true;
       if (def?.searchHint) entry.searchHint = def.searchHint;
+      if (def?.longRunning) entry.longRunning = true;
       return entry;
     });
     res.json({ tools });
@@ -44926,6 +44934,136 @@ var REACT_NATIVE_PROFILER_SETUP_SCRIPT = `
   });
 })();
 `;
+var BOOTSTRAP_DEVTOOLS_BACKEND_SCRIPT = `
+(function __argent_bootstrapDevtoolsBackend() {
+  var h = globalThis.__REACT_DEVTOOLS_GLOBAL_HOOK__;
+  if (!h) return JSON.stringify({ ok: false, reason: 'no-hook' });
+
+  function sizeOf(m) {
+    if (!m || typeof m.forEach !== 'function') return 0;
+    var n = 0;
+    m.forEach(function () { n++; });
+    return n;
+  }
+
+  var renderersCount = sizeOf(h.renderers);
+  var rendererInterfacesCount = sizeOf(h.rendererInterfaces);
+
+  if (rendererInterfacesCount > 0) {
+    return JSON.stringify({
+      ok: true,
+      reason: 'already-attached',
+      renderersCount: renderersCount,
+      rendererInterfacesCount: rendererInterfacesCount,
+    });
+  }
+
+  if (renderersCount === 0) {
+    return JSON.stringify({
+      ok: false,
+      reason: 'no-renderers',
+      renderersCount: renderersCount,
+      rendererInterfacesCount: rendererInterfacesCount,
+    });
+  }
+
+  if (typeof globalThis.__r !== 'function' || typeof globalThis.__r.getModules !== 'function') {
+    return JSON.stringify({
+      ok: false,
+      reason: 'no-metro-modules',
+      renderersCount: renderersCount,
+      rendererInterfacesCount: rendererInterfacesCount,
+    });
+  }
+
+  var found = null;
+  var moduleSeenButUnsupported = false;
+  try {
+    var mods = globalThis.__r.getModules();
+    var inspect = function (id, meta) {
+      if (found) return;
+      var name = meta && meta.verboseName;
+      if (typeof name !== 'string') return;
+      if (name.indexOf('react-devtools-core/dist/backend') < 0) return;
+      try {
+        var m = globalThis.__r(id);
+        if (!m) return;
+        if (typeof m.connectWithCustomMessagingProtocol === 'function') {
+          found = m;
+        } else {
+          // Module exists but exposes only legacy WebSocket-based connectToDevTools
+          // (rdt-core <5.1). We can't bootstrap without a real ws endpoint, so the
+          // user has to attach an external backend (\`npx react-devtools\` + reload).
+          moduleSeenButUnsupported = true;
+        }
+      } catch (_e) {
+        // require failure on this id \u2014 keep searching.
+      }
+    };
+    // Metro's getModules() returns a Map<id, meta> in modern versions.
+    // Map#forEach calls back as (value, key); array-like fallback handled below.
+    if (typeof mods.forEach === 'function' && typeof mods.size === 'number') {
+      mods.forEach(function (meta, id) { inspect(id, meta); });
+    } else if (typeof mods.length === 'number') {
+      for (var i = 0; i < mods.length; i++) {
+        if (mods[i]) inspect(i, mods[i]);
+      }
+    } else if (typeof mods.forEach === 'function') {
+      mods.forEach(function (meta, id) { inspect(id, meta); });
+    }
+  } catch (err) {
+    return JSON.stringify({
+      ok: false,
+      reason: 'metro-scan-error',
+      message: String((err && err.message) || err),
+      renderersCount: renderersCount,
+      rendererInterfacesCount: rendererInterfacesCount,
+    });
+  }
+
+  if (!found) {
+    return JSON.stringify({
+      ok: false,
+      reason: moduleSeenButUnsupported ? 'unsupported-rdt-version' : 'no-rdt-module',
+      renderersCount: renderersCount,
+      rendererInterfacesCount: rendererInterfacesCount,
+    });
+  }
+
+  try {
+    found.connectWithCustomMessagingProtocol({
+      onSubscribe: function () {},
+      onUnsubscribe: function () {},
+      onMessage: function () {},
+    });
+  } catch (err) {
+    return JSON.stringify({
+      ok: false,
+      reason: 'bootstrap-threw',
+      message: String((err && err.message) || err),
+      renderersCount: renderersCount,
+      rendererInterfacesCount: rendererInterfacesCount,
+    });
+  }
+
+  var afterCount = sizeOf(h.rendererInterfaces);
+  if (afterCount === 0) {
+    return JSON.stringify({
+      ok: false,
+      reason: 'bootstrap-no-effect',
+      renderersCount: renderersCount,
+      rendererInterfacesCount: rendererInterfacesCount,
+    });
+  }
+
+  return JSON.stringify({
+    ok: true,
+    reason: 'bootstrapped',
+    renderersCount: renderersCount,
+    rendererInterfacesCount: afterCount,
+  });
+})()
+`;
 var HEARTBEAT_SCRIPT = `
 (function(){
   if (typeof globalThis.__argent_profilerHeartbeat === 'function') {
@@ -46251,7 +46389,6 @@ Use when you need to scroll a list, dismiss a modal, or navigate between pages.
 };
 
 // ../tool-server/src/utils/gesture-utils.ts
-var sleep3 = (ms) => new Promise((r) => setTimeout(r, ms));
 function lerp(a, b, t) {
   return a + (b - a) * t;
 }
@@ -46299,7 +46436,7 @@ function sendTouchEvent(api, type, x, y, x2, y2) {
 }
 
 // ../tool-server/src/tools/gesture-custom/index.ts
-var sleep4 = (ms) => new Promise((r) => setTimeout(r, ms));
+var sleep3 = (ms) => new Promise((r) => setTimeout(r, ms));
 var eventSchema = external_exports.object({
   type: external_exports.enum(["Down", "Move", "Up"]).describe("Touch event type"),
   x: external_exports.number().describe("Normalized x 0.0\u20131.0 (not pixels; same as tap/swipe)"),
@@ -46352,7 +46489,7 @@ Example pinch-to-zoom (with interpolate:10 for smoothness):
     const api = services.simulatorServer;
     const events = params.interpolate && params.interpolate > 0 ? interpolateEvents(params.events, params.interpolate) : params.events;
     for (const event of events) {
-      await sleep4(event.delayMs ?? 16);
+      await sleep3(event.delayMs ?? 16);
       sendCommand(api, {
         cmd: "touch",
         type: event.type,
@@ -46366,6 +46503,10 @@ Example pinch-to-zoom (with interpolate:10 for smoothness):
   }
 };
 
+// ../tool-server/src/utils/timing.ts
+var sleep4 = (ms) => new Promise((r) => setTimeout(r, ms));
+var DEFAULT_INTER_STEP_DELAY_MS = 100;
+
 // ../tool-server/src/tools/gesture-pinch/index.ts
 var zodSchema18 = external_exports.object({
   udid: external_exports.string().describe("Target device id from `list-devices` (iOS UDID or Android serial)."),
@@ -46420,7 +46561,7 @@ Use when you need to zoom in or out on a map, image, or zoomable view. Returns {
       const type = i === 0 ? "Down" : i === steps ? "Up" : "Move";
       if (i === 0) timestampMs = Date.now();
       sendTouchEvent(api, type, x1, y1, x2, y2);
-      if (i < steps) await sleep3(16);
+      if (i < steps) await sleep4(16);
     }
     return { pinched: true, timestampMs };
   }
@@ -46474,7 +46615,7 @@ Use when you need to rotate a map, image picker, or any rotateable UI element. R
       const type = i === 0 ? "Down" : i === steps ? "Up" : "Move";
       if (i === 0) timestampMs = Date.now();
       sendTouchEvent(api, type, x1, y1, x2, y2);
-      if (i < steps) await sleep3(16);
+      if (i < steps) await sleep4(16);
     }
     return { rotated: true, timestampMs };
   }
@@ -46696,7 +46837,6 @@ Returns { orientation }. Fails if the target device is not booted.`,
 };
 
 // ../tool-server/src/tools/run-sequence/index.ts
-var sleep7 = (ms) => new Promise((r) => setTimeout(r, ms));
 var ALLOWED_TOOLS = /* @__PURE__ */ new Set([
   "gesture-tap",
   "gesture-swipe",
@@ -46717,7 +46857,9 @@ var zodSchema23 = external_exports.object({
         "Tool name \u2014 one of: gesture-tap, gesture-swipe, gesture-custom, gesture-pinch, gesture-rotate, button, keyboard, rotate"
       ),
       args: external_exports.record(external_exports.unknown()).describe("Tool arguments (excluding udid, which is injected automatically)"),
-      delayMs: external_exports.number().optional().describe("Wait time in ms after this step before the next (default 100)")
+      delayMs: external_exports.number().optional().describe(
+        `Wait time in ms after this step before the next (default ${DEFAULT_INTER_STEP_DELAY_MS})`
+      )
     })
   ).min(1).describe("Ordered list of interaction steps to execute sequentially")
 });
@@ -46764,6 +46906,7 @@ Example \u2014 type text and submit:
 
 Stops on the first error and returns partial results.`,
     alwaysLoad: true,
+    longRunning: true,
     searchHint: "batch sequence multiple gesture steps sequentially",
     zodSchema: zodSchema23,
     capability: capability15,
@@ -46792,8 +46935,8 @@ Stops on the first error and returns partial results.`,
           });
           break;
         }
-        const delay = step.delayMs ?? 100;
-        if (delay > 0) await sleep7(delay);
+        const delay = step.delayMs ?? DEFAULT_INTER_STEP_DELAY_MS;
+        if (delay > 0) await sleep4(delay);
       }
       return {
         completed: results.filter((r) => "result" in r).length,
@@ -48296,226 +48439,6 @@ ${body.slice(0, MAX_BODY_SIZE)}...`;
   }
 };
 
-// ../tool-server/src/tools/describe/contract.ts
-var describeFrameSchema = external_exports.object({
-  x: external_exports.number().finite().min(0).max(1),
-  y: external_exports.number().finite().min(0).max(1),
-  width: external_exports.number().finite().min(0).max(1),
-  height: external_exports.number().finite().min(0).max(1)
-});
-var describeNodeSchema = external_exports.lazy(
-  () => external_exports.object({
-    role: external_exports.string().min(1),
-    frame: describeFrameSchema,
-    children: external_exports.array(describeNodeSchema),
-    label: external_exports.string().optional(),
-    identifier: external_exports.string().optional(),
-    value: external_exports.string().optional(),
-    clickable: external_exports.boolean().optional(),
-    longClickable: external_exports.boolean().optional(),
-    scrollable: external_exports.boolean().optional(),
-    checkable: external_exports.boolean().optional(),
-    checked: external_exports.boolean().optional(),
-    disabled: external_exports.boolean().optional(),
-    password: external_exports.boolean().optional(),
-    scrollHidden: external_exports.number().int().nonnegative().optional()
-  }).passthrough()
-);
-function parseDescribeResult(input) {
-  return describeNodeSchema.parse(input);
-}
-
-// ../tool-server/src/tools/describe/platforms/ios-native-adapter.ts
-function clamp01(value) {
-  return Math.min(1, Math.max(0, value));
-}
-function roundNormalized(value) {
-  return Math.round(value * 1e12) / 1e12;
-}
-function clampNormalizedFrame(frame) {
-  const x1 = clamp01(frame.x);
-  const y1 = clamp01(frame.y);
-  const x2 = clamp01(frame.x + frame.width);
-  const y2 = clamp01(frame.y + frame.height);
-  const width = x2 - x1;
-  const height = y2 - y1;
-  if (width <= 0 || height <= 0) {
-    return null;
-  }
-  return {
-    x: roundNormalized(x1),
-    y: roundNormalized(y1),
-    width: roundNormalized(width),
-    height: roundNormalized(height)
-  };
-}
-function mapNativeTraitsToDescribeRole(traits) {
-  const set = new Set(traits);
-  if (set.has("header")) return "AXHeading";
-  if (set.has("button") || set.has("toggleButton")) return "AXButton";
-  if (set.has("searchField")) return "AXTextField";
-  if (set.has("link")) return "AXLink";
-  if (set.has("image")) return "AXImage";
-  if (set.has("staticText")) return "AXStaticText";
-  if (set.has("tabBar")) return "AXTabBar";
-  if (set.has("adjustable")) return "AXAdjustable";
-  return "AXGroup";
-}
-function adaptNativeDescribeElementToDescribeNode(element) {
-  const frame = clampNormalizedFrame(element.normalizedFrame);
-  if (!frame) return null;
-  return {
-    role: mapNativeTraitsToDescribeRole(element.traits),
-    frame,
-    children: [],
-    label: element.label,
-    identifier: element.identifier,
-    value: element.value
-  };
-}
-function adaptNativeDescribeToDescribeResult(result) {
-  const children = result.elements.map(adaptNativeDescribeElementToDescribeNode).filter((node) => node !== null);
-  return parseDescribeResult({
-    role: "AXGroup",
-    frame: {
-      x: 0,
-      y: 0,
-      width: 1,
-      height: 1
-    },
-    children
-  });
-}
-
-// ../tool-server/src/tools/describe/platforms/ios-ax-adapter.ts
-function clamp012(value) {
-  return Math.min(1, Math.max(0, value));
-}
-function roundNormalized2(value) {
-  return Math.round(value * 1e12) / 1e12;
-}
-function adaptAXElement(el) {
-  if (!el.frame) return null;
-  const x1 = clamp012(el.frame.x);
-  const y1 = clamp012(el.frame.y);
-  const x2 = clamp012(el.frame.x + el.frame.width);
-  const y2 = clamp012(el.frame.y + el.frame.height);
-  const width = x2 - x1;
-  const height = y2 - y1;
-  if (width <= 0 || height <= 0) return null;
-  return {
-    role: mapNativeTraitsToDescribeRole(el.traits ?? []),
-    frame: {
-      x: roundNormalized2(x1),
-      y: roundNormalized2(y1),
-      width: roundNormalized2(width),
-      height: roundNormalized2(height)
-    },
-    children: [],
-    label: el.label,
-    value: el.value
-  };
-}
-function adaptAXDescribeToDescribeResult(response) {
-  const children = response.elements.map(adaptAXElement).filter((n) => n !== null);
-  return parseDescribeResult({
-    role: "AXGroup",
-    frame: { x: 0, y: 0, width: 1, height: 1 },
-    children
-  });
-}
-
-// ../tool-server/src/utils/native-target-app.ts
-function chooseFrontmostConnectedApp(apps) {
-  const strongCandidates = apps.filter(
-    (app) => app.applicationState === "active" || app.foregroundActiveSceneCount > 0
-  );
-  if (strongCandidates.length === 1) {
-    return strongCandidates[0];
-  }
-  const weakCandidates = apps.filter(
-    (app) => app.applicationState === "inactive" || app.foregroundInactiveSceneCount > 0
-  );
-  if (strongCandidates.length === 0 && weakCandidates.length === 1) {
-    return weakCandidates[0];
-  }
-  return null;
-}
-async function inspectConnectedNativeApps(api) {
-  const bundleIds = api.listConnectedBundleIds();
-  const appStates = await Promise.all(bundleIds.map((bundleId) => api.getAppState(bundleId)));
-  return appStates.sort((a, b) => a.bundleId.localeCompare(b.bundleId));
-}
-async function resolveNativeTargetApp(api, bundleId) {
-  if (bundleId) {
-    return { bundleId, source: "explicit" };
-  }
-  const connectedApps = await inspectConnectedNativeApps(api);
-  if (connectedApps.length === 0) {
-    throw new Error(
-      "No native-devtools-connected apps are available for auto-targeting. Launch or restart the app first, provide bundleId explicitly, or use screenshot to inspect visible Home/system UI."
-    );
-  }
-  const frontmost = chooseFrontmostConnectedApp(connectedApps);
-  if (connectedApps.length === 1) {
-    if (frontmost) {
-      return {
-        bundleId: connectedApps[0].bundleId,
-        source: "single_connected_foreground_like"
-      };
-    }
-    const app = connectedApps[0];
-    throw new Error(
-      `A single native-devtools-connected app is available, but it is not foreground-like and may be backgrounded while home/system UI is visible.
-- ${app.bundleId} (applicationState=${app.applicationState}, foregroundActiveScenes=${app.foregroundActiveSceneCount}, foregroundInactiveScenes=${app.foregroundInactiveSceneCount})
-Provide bundleId explicitly if you still want to target this app.`
-    );
-  }
-  if (frontmost) {
-    return { bundleId: frontmost.bundleId, source: "frontmost_detected" };
-  }
-  const appList = connectedApps.map(
-    (app) => `- ${app.bundleId} (applicationState=${app.applicationState}, foregroundActiveScenes=${app.foregroundActiveSceneCount}, foregroundInactiveScenes=${app.foregroundInactiveSceneCount})`
-  ).join("\n");
-  throw new Error(
-    `Multiple native-devtools-connected apps are available and none can be identified as uniquely frontmost.
-${appList}
-Provide bundleId explicitly.`
-  );
-}
-
-// ../tool-server/src/tools/describe/platforms/ios.ts
-var iosRequires = ["xcrun"];
-async function describeIos(registry, device, params) {
-  const axRef = axServiceRef(device);
-  const axApi = await registry.resolveService(axRef.urn, axRef.options);
-  const response = await axApi.describe();
-  const tree = adaptAXDescribeToDescribeResult(response);
-  if (tree.children.length > 0) {
-    return { tree, source: "ax-service" };
-  }
-  try {
-    const ndRef = nativeDevtoolsRef(device);
-    const nativeApi = await registry.resolveService(ndRef.urn, ndRef.options);
-    const target = await resolveNativeTargetApp(nativeApi, params.bundleId);
-    if (await nativeApi.requiresAppRestart(target.bundleId)) {
-      return { tree, source: "ax-service", should_restart: true };
-    }
-    const rawResult = await nativeApi.queryViewHierarchy(
-      target.bundleId,
-      "ViewHierarchy.describeScreen"
-    );
-    if (rawResult.error) {
-      return { tree, source: "ax-service" };
-    }
-    const parsed = parseNativeDescribeScreenResult(rawResult);
-    const nativeTree = adaptNativeDescribeToDescribeResult(parsed);
-    return { tree: nativeTree, source: "native-devtools" };
-  } catch {
-    return { tree, source: "ax-service" };
-  }
-}
-
 // ../tool-server/src/utils/android-screen.ts
 async function getAndroidScreenSize(serial) {
   const out = await adbShell(serial, "wm size", { timeoutMs: 5e3 });
@@ -48533,7 +48456,7 @@ async function getAndroidScreenSize(serial) {
   return { width, height };
 }
 
-// ../tool-server/src/utils/uiautomator-parser.ts
+// ../tool-server/src/tools/describe/platforms/android/uiautomator-parser.ts
 function parseUiAutomatorXml(xml) {
   const body = xml.replace(/^\s*<\?xml[^?]*\?>\s*/, "");
   const tagRe = /<(\/?)([A-Za-z_][\w.-]*)((?:"[^"]*"|'[^']*'|[^"'/<>])*?)\s*(\/?)>/gs;
@@ -48915,7 +48838,7 @@ function parseUiAutomatorDump(rawOutput, screenW, screenH, options = {}) {
   };
 }
 
-// ../tool-server/src/tools/describe/platforms/android.ts
+// ../tool-server/src/tools/describe/platforms/android/index.ts
 var androidRequires = ["adb"];
 async function describeAndroid(udid, _bundleId) {
   const randomSuffix = `${Date.now().toString(36)}-${Math.floor(Math.random() * 1e9).toString(36)}`;
@@ -48939,6 +48862,226 @@ async function describeAndroid(udid, _bundleId) {
   return { tree, source: "uiautomator" };
 }
 
+// ../tool-server/src/utils/native-target-app.ts
+function chooseFrontmostConnectedApp(apps) {
+  const strongCandidates = apps.filter(
+    (app) => app.applicationState === "active" || app.foregroundActiveSceneCount > 0
+  );
+  if (strongCandidates.length === 1) {
+    return strongCandidates[0];
+  }
+  const weakCandidates = apps.filter(
+    (app) => app.applicationState === "inactive" || app.foregroundInactiveSceneCount > 0
+  );
+  if (strongCandidates.length === 0 && weakCandidates.length === 1) {
+    return weakCandidates[0];
+  }
+  return null;
+}
+async function inspectConnectedNativeApps(api) {
+  const bundleIds = api.listConnectedBundleIds();
+  const appStates = await Promise.all(bundleIds.map((bundleId) => api.getAppState(bundleId)));
+  return appStates.sort((a, b) => a.bundleId.localeCompare(b.bundleId));
+}
+async function resolveNativeTargetApp(api, bundleId) {
+  if (bundleId) {
+    return { bundleId, source: "explicit" };
+  }
+  const connectedApps = await inspectConnectedNativeApps(api);
+  if (connectedApps.length === 0) {
+    throw new Error(
+      "No native-devtools-connected apps are available for auto-targeting. Launch or restart the app first, provide bundleId explicitly, or use screenshot to inspect visible Home/system UI."
+    );
+  }
+  const frontmost = chooseFrontmostConnectedApp(connectedApps);
+  if (connectedApps.length === 1) {
+    if (frontmost) {
+      return {
+        bundleId: connectedApps[0].bundleId,
+        source: "single_connected_foreground_like"
+      };
+    }
+    const app = connectedApps[0];
+    throw new Error(
+      `A single native-devtools-connected app is available, but it is not foreground-like and may be backgrounded while home/system UI is visible.
+- ${app.bundleId} (applicationState=${app.applicationState}, foregroundActiveScenes=${app.foregroundActiveSceneCount}, foregroundInactiveScenes=${app.foregroundInactiveSceneCount})
+Provide bundleId explicitly if you still want to target this app.`
+    );
+  }
+  if (frontmost) {
+    return { bundleId: frontmost.bundleId, source: "frontmost_detected" };
+  }
+  const appList = connectedApps.map(
+    (app) => `- ${app.bundleId} (applicationState=${app.applicationState}, foregroundActiveScenes=${app.foregroundActiveSceneCount}, foregroundInactiveScenes=${app.foregroundInactiveSceneCount})`
+  ).join("\n");
+  throw new Error(
+    `Multiple native-devtools-connected apps are available and none can be identified as uniquely frontmost.
+${appList}
+Provide bundleId explicitly.`
+  );
+}
+
+// ../tool-server/src/tools/describe/contract.ts
+var describeFrameSchema = external_exports.object({
+  x: external_exports.number().finite().min(0).max(1),
+  y: external_exports.number().finite().min(0).max(1),
+  width: external_exports.number().finite().min(0).max(1),
+  height: external_exports.number().finite().min(0).max(1)
+});
+var describeNodeSchema = external_exports.lazy(
+  () => external_exports.object({
+    role: external_exports.string().min(1),
+    frame: describeFrameSchema,
+    children: external_exports.array(describeNodeSchema),
+    label: external_exports.string().optional(),
+    identifier: external_exports.string().optional(),
+    value: external_exports.string().optional(),
+    clickable: external_exports.boolean().optional(),
+    longClickable: external_exports.boolean().optional(),
+    scrollable: external_exports.boolean().optional(),
+    checkable: external_exports.boolean().optional(),
+    checked: external_exports.boolean().optional(),
+    disabled: external_exports.boolean().optional(),
+    password: external_exports.boolean().optional(),
+    scrollHidden: external_exports.number().int().nonnegative().optional()
+  }).passthrough()
+);
+function parseDescribeResult(input) {
+  return describeNodeSchema.parse(input);
+}
+
+// ../tool-server/src/tools/describe/platforms/ios/ios-native-adapter.ts
+function clamp01(value) {
+  return Math.min(1, Math.max(0, value));
+}
+function roundNormalized(value) {
+  return Math.round(value * 1e12) / 1e12;
+}
+function clampNormalizedFrame(frame) {
+  const x1 = clamp01(frame.x);
+  const y1 = clamp01(frame.y);
+  const x2 = clamp01(frame.x + frame.width);
+  const y2 = clamp01(frame.y + frame.height);
+  const width = x2 - x1;
+  const height = y2 - y1;
+  if (width <= 0 || height <= 0) {
+    return null;
+  }
+  return {
+    x: roundNormalized(x1),
+    y: roundNormalized(y1),
+    width: roundNormalized(width),
+    height: roundNormalized(height)
+  };
+}
+function mapNativeTraitsToDescribeRole(traits) {
+  const set = new Set(traits);
+  if (set.has("header")) return "AXHeading";
+  if (set.has("button") || set.has("toggleButton")) return "AXButton";
+  if (set.has("searchField")) return "AXTextField";
+  if (set.has("link")) return "AXLink";
+  if (set.has("image")) return "AXImage";
+  if (set.has("staticText")) return "AXStaticText";
+  if (set.has("tabBar")) return "AXTabBar";
+  if (set.has("adjustable")) return "AXAdjustable";
+  return "AXGroup";
+}
+function adaptNativeDescribeElementToDescribeNode(element) {
+  const frame = clampNormalizedFrame(element.normalizedFrame);
+  if (!frame) return null;
+  return {
+    role: mapNativeTraitsToDescribeRole(element.traits),
+    frame,
+    children: [],
+    label: element.label,
+    identifier: element.identifier,
+    value: element.value
+  };
+}
+function adaptNativeDescribeToDescribeResult(result) {
+  const children = result.elements.map(adaptNativeDescribeElementToDescribeNode).filter((node) => node !== null);
+  return parseDescribeResult({
+    role: "AXGroup",
+    frame: {
+      x: 0,
+      y: 0,
+      width: 1,
+      height: 1
+    },
+    children
+  });
+}
+
+// ../tool-server/src/tools/describe/platforms/ios/ios-ax-adapter.ts
+function clamp012(value) {
+  return Math.min(1, Math.max(0, value));
+}
+function roundNormalized2(value) {
+  return Math.round(value * 1e12) / 1e12;
+}
+function adaptAXElement(el) {
+  if (!el.frame) return null;
+  const x1 = clamp012(el.frame.x);
+  const y1 = clamp012(el.frame.y);
+  const x2 = clamp012(el.frame.x + el.frame.width);
+  const y2 = clamp012(el.frame.y + el.frame.height);
+  const width = x2 - x1;
+  const height = y2 - y1;
+  if (width <= 0 || height <= 0) return null;
+  return {
+    role: mapNativeTraitsToDescribeRole(el.traits ?? []),
+    frame: {
+      x: roundNormalized2(x1),
+      y: roundNormalized2(y1),
+      width: roundNormalized2(width),
+      height: roundNormalized2(height)
+    },
+    children: [],
+    label: el.label,
+    value: el.value
+  };
+}
+function adaptAXDescribeToDescribeResult(response) {
+  const children = response.elements.map(adaptAXElement).filter((n) => n !== null);
+  return parseDescribeResult({
+    role: "AXGroup",
+    frame: { x: 0, y: 0, width: 1, height: 1 },
+    children
+  });
+}
+
+// ../tool-server/src/tools/describe/platforms/ios/index.ts
+var iosRequires = ["xcrun"];
+async function describeIos(registry, device, params) {
+  const axRef = axServiceRef(device);
+  const axApi = await registry.resolveService(axRef.urn, axRef.options);
+  const response = await axApi.describe();
+  const tree = adaptAXDescribeToDescribeResult(response);
+  if (tree.children.length > 0) {
+    return { tree, source: "ax-service" };
+  }
+  try {
+    const ndRef = nativeDevtoolsRef(device);
+    const nativeApi = await registry.resolveService(ndRef.urn, ndRef.options);
+    const target = await resolveNativeTargetApp(nativeApi, params.bundleId);
+    if (await nativeApi.requiresAppRestart(target.bundleId)) {
+      return { tree, source: "ax-service", should_restart: true };
+    }
+    const rawResult = await nativeApi.queryViewHierarchy(
+      target.bundleId,
+      "ViewHierarchy.describeScreen"
+    );
+    if (rawResult.error) {
+      return { tree, source: "ax-service" };
+    }
+    const parsed = parseNativeDescribeScreenResult(rawResult);
+    const nativeTree = adaptNativeDescribeToDescribeResult(parsed);
+    return { tree: nativeTree, source: "native-devtools" };
+  } catch {
+    return { tree, source: "ax-service" };
+  }
+}
+
 // ../tool-server/src/tools/describe/index.ts
 var zodSchema33 = external_exports.object({
   udid: external_exports.string().min(1).describe("Target device id from `list-devices` (iOS UDID or Android serial)."),
@@ -49016,6 +49159,25 @@ function classifyStaleness({
   };
 }
 
+// ../tool-server/src/utils/react-profiler/devtools-bootstrap.ts
+function bootstrapFailureMessage(bootstrap) {
+  switch (bootstrap.reason) {
+    case "no-hook":
+    case "no-rdt-module":
+      return "React DevTools is not available in this app. This usually means the app is a production build. Ask the user to run a development build of the app, then retry.";
+    case "no-renderers":
+      return "React has not rendered yet, so there is nothing to profile. Ask the user to wait until the app shows React content (or navigate to a screen with React content), then retry.";
+    case "no-metro-modules":
+      return "Could not attach the React DevTools backend: the JS runtime does not expose a Metro module registry. This runtime is not a standard Metro-bundled React Native app and the React profiler cannot proceed. Inform the user that React profiling is only supported on standard Metro / React Native bundles.";
+    case "unsupported-rdt-version":
+      return "This app is running React Native older than 0.74, which the React profiler does not support. Ask the user to upgrade React Native to 0.74 or newer to use this tool.";
+    default: {
+      const detail = bootstrap.message ? ` (runtime error: ${bootstrap.message})` : "";
+      return `Could not attach the React DevTools backend${detail}. Ask the user to fully reload the JS bundle and retry. If the error persists, the runtime may not be supported by the React profiler.`;
+    }
+  }
+}
+
 // ../tool-server/src/tools/profiler/react/react-profiler-start.ts
 var zodSchema34 = external_exports.object({
   port: external_exports.coerce.number().default(8081).describe("Metro server port"),
@@ -49086,20 +49248,40 @@ Fails if the Hermes runtime is not reachable or the Metro CDP connection cannot
       }
       const cdp = api.cdp;
       await cdp.evaluate(REACT_NATIVE_PROFILER_SETUP_SCRIPT);
-      const stateJson = await cdp.evaluate(READ_STATE_SCRIPT);
+      let stateJson = await cdp.evaluate(READ_STATE_SCRIPT);
       if (!stateJson) {
         throw new Error("Failed to read React profiler state from runtime (no value returned).");
       }
-      const state2 = JSON.parse(stateJson);
+      let state2 = JSON.parse(stateJson);
       if (!state2.hookExists) {
         throw new Error(
-          "__REACT_DEVTOOLS_GLOBAL_HOOK__ not present. React profiling requires a development build of the app."
+          "React DevTools is not available in this app. This usually means the app is a production build. Ask the user to run a development build of the app, then retry."
         );
       }
       if (!("rendererInterfaceFound" in state2) || !state2.rendererInterfaceFound) {
-        throw new Error(
-          "No React renderer interface attached yet. Wait for the app to render its first commit and retry."
-        );
+        const bootstrapJson = await cdp.evaluate(BOOTSTRAP_DEVTOOLS_BACKEND_SCRIPT);
+        if (!bootstrapJson) {
+          throw new Error(
+            "Failed to attach React DevTools backend (no value returned from runtime)."
+          );
+        }
+        const bootstrap = JSON.parse(bootstrapJson);
+        if (!bootstrap.ok) {
+          throw new Error(bootstrapFailureMessage(bootstrap));
+        }
+        await cdp.evaluate(REACT_NATIVE_PROFILER_SETUP_SCRIPT);
+        stateJson = await cdp.evaluate(READ_STATE_SCRIPT);
+        if (!stateJson) {
+          throw new Error(
+            "Failed to re-read React profiler state after attach (no value returned)."
+          );
+        }
+        state2 = JSON.parse(stateJson);
+        if (!state2.hookExists || !("rendererInterfaceFound" in state2) || !state2.rendererInterfaceFound) {
+          throw new Error(
+            "Attached the React DevTools backend but no React renderer registered itself afterwards. Ask the user to fully reload the JS bundle and retry."
+          );
+        }
       }
       if (state2.isRunning) {
         const owner = state2.owner;
@@ -49115,7 +49297,7 @@ Fails if the Hermes runtime is not reachable or the Metro CDP connection cannot
             owner,
             age_seconds: staleness.ageSeconds,
             stale: staleness.stale,
-            how_to_reclaim: 'A profiling session is already active. Stop and ask the user whether you should take over the session. To take over and discard the current session, call react-profiler-start again with { force: true }. Details about the current owner are in the `owner` field. If the sessions is marked as "stale", takeover is safe and may be initiated without prompting the user. Inform about possible cause of already running or stale session. When informing the user, warn about caveats of continuing profiling and taking over the old session.'
+            how_to_reclaim: "Another profiling session is already active \u2014 see the `owner` field. Ask the user before taking over and explain that the prior session's data will be discarded; to take over, call react-profiler-start again with { force: true }. If `stale` is true, the prior owner is likely gone and you may take over without prompting the user."
           };
         }
         await cdp.evaluate(STOP_FOR_TAKEOVER_SCRIPT).catch(ignore);
@@ -54518,14 +54700,20 @@ function toYamlStep(step) {
   if (step.kind === "echo") {
     return { echo: step.message };
   }
-  const hasArgs = Object.keys(step.args).length > 0;
-  return hasArgs ? { tool: step.name, args: step.args } : { tool: step.name };
+  const yaml = {
+    tool: step.name
+  };
+  if (Object.keys(step.args).length > 0) yaml.args = step.args;
+  if (step.delayMs !== void 0) yaml.delayMs = step.delayMs;
+  return yaml;
 }
 function fromYamlStep(raw) {
   if ("echo" in raw) {
     return { kind: "echo", message: raw.echo };
   }
-  return { kind: "tool", name: raw.tool, args: raw.args ?? {} };
+  const step = { kind: "tool", name: raw.tool, args: raw.args ?? {} };
+  if (raw.delayMs !== void 0) step.delayMs = raw.delayMs;
+  return step;
 }
 function serializeFlow(flow) {
   const doc = {
@@ -54618,7 +54806,8 @@ var zodSchema53 = external_exports.object({
   command: external_exports.string().describe('MCP tool name (e.g. "tap", "screenshot", "launch-app")'),
   args: external_exports.string().optional().describe(
     `Tool arguments as a JSON string, e.g. '{"udid": "ABC", "x": 0.5, "y": 0.3}'. Omit for tools with no arguments.`
-  )
+  ),
+  delayMs: external_exports.number().int().min(0).optional().describe("Milliseconds to sleep before executing this step during replay.")
 });
 function createFlowAddStepTool(registry) {
   return {
@@ -54635,7 +54824,8 @@ If a step was recorded by mistake, edit the .yaml file directly to remove it.`,
       const flowFile = await appendStep(filePath, {
         kind: "tool",
         name: params.command,
-        args
+        args,
+        delayMs: params.delayMs
       });
       return {
         message: `Step added to "${flowName}" flow`,
@@ -54719,13 +54909,15 @@ function createRunFlowTool(registry) {
     id: "flow-execute",
     description: `Run a saved flow from the .argent/flows/ directory.
 Each step is executed in order: tool calls are dispatched through the registry,
-echo steps print a message. Returns the result of every step, including images.
+echo steps print a message. A tool step may carry \`delayMs: <ms>\` to sleep
+that long before the step runs. Returns the result of every step, including images.
 Use when you want to replay a recorded flow or run a scripted sequence of simulator actions.
 Fails if the flow file does not exist or a step tool raises an error (execution stops at that step).
 
 If the flow has an execution prerequisite and prerequisiteAcknowledged is not
 set to true, the tool returns a notice with the prerequisite instead of running.
 Use flow-read-prerequisite to inspect the prerequisite beforehand.`,
+    longRunning: true,
     zodSchema: zodSchema56,
     services: () => ({}),
     async execute(_services, params) {
@@ -54747,6 +54939,7 @@ Use flow-read-prerequisite to inspect the prerequisite beforehand.`,
           steps.push({ kind: "echo", message: step.message });
           continue;
         }
+        if (step.delayMs) await sleep4(step.delayMs);
         const toolDef = registry.getTool(step.name);
         try {
           const result = await registry.invokeTool(step.name, step.args);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swmansion/argent",
-  "version": "0.7.0-next.4",
+  "version": "0.7.1",
   "description": "MCP server for iOS Simulator and Android Emulator control",
   "license": "Apache-2.0",
   "repository": {

package/skills/argent-create-flow/SKILL.md

@@ -99,7 +99,7 @@ flow-execute   { name: "open-settings", project_root: "/Users/dev/MyApp", prereq
 Flow files use YAML. The top-level is an object with `executionPrerequisite` (describes required state) and `steps` (array of actions):
 
 - `- echo: <message>` — a label
-- `- tool: <name>` with optional `args:` — a tool call
+- `- tool: <name>` with optional `args:` — a tool call. Add `delayMs: <ms>` to sleep that long before the step runs (use sparingly — only when the app needs a fixed wait between actions).
 
 Example `.yaml` file: