@swmansion/argent 0.14.1-next.10 → 0.14.1-next.12

package/dist/mcp-server.mjs

@@ -18810,8 +18810,21 @@ async function startMcpServer(options) {
       }
       const udid = getUdidFromArgs(params.arguments);
       if (autoScreenshotOn && udid && shouldAutoScreenshot(params.name)) {
-        const delayMs = getAutoScreenshotDelayMs(params.name);
-        if (delayMs > 0) await new Promise((r) => setTimeout(r, delayMs));
+        const maxWaitMs = getAutoScreenshotDelayMs(params.name);
+        if (maxWaitMs > 0) {
+          try {
+            const idle = await callTool("await-screen-idle", { udid, timeoutMs: maxWaitMs });
+            await spyLog({
+              ts: (/* @__PURE__ */ new Date()).toISOString(),
+              event: "auto_screenshot_readiness",
+              name: params.name,
+              maxWaitMs,
+              ...idle.result
+            });
+          } catch {
+            await new Promise((r) => setTimeout(r, maxWaitMs));
+          }
+        }
         try {
           const screenshotResult = await callTool("screenshot", { udid });
           const screenshotContent = await toMcpContent(screenshotResult.result, "image", {

package/dist/tool-server.cjs

@@ -12075,8 +12075,8 @@ function finalize(ctx, schema) {
   const root2 = ctx.seen.get(schema);
   if (!root2)
     throw new Error("Unprocessed schema. This is a bug in Zod.");
-  const flattenRef = (zodSchema70) => {
-    const seen = ctx.seen.get(zodSchema70);
+  const flattenRef = (zodSchema71) => {
+    const seen = ctx.seen.get(zodSchema71);
     if (seen.ref === null)
       return;
     const schema2 = seen.def ?? seen.schema;
@@ -12094,7 +12094,7 @@ function finalize(ctx, schema) {
         Object.assign(schema2, refSchema);
       }
       Object.assign(schema2, _cached);
-      const isParentRef = zodSchema70._zod.parent === ref;
+      const isParentRef = zodSchema71._zod.parent === ref;
       if (isParentRef) {
         for (const key in schema2) {
           if (key === "$ref" || key === "allOf")
@@ -12114,7 +12114,7 @@ function finalize(ctx, schema) {
         }
       }
     }
-    const parent = zodSchema70._zod.parent;
+    const parent = zodSchema71._zod.parent;
     if (parent && parent !== ref) {
       flattenRef(parent);
       const parentSeen = ctx.seen.get(parent);
@@ -12132,7 +12132,7 @@ function finalize(ctx, schema) {
       }
     }
     ctx.override({
-      zodSchema: zodSchema70,
+      zodSchema: zodSchema71,
       jsonSchema: schema2,
       path: seen.path ?? []
     });
@@ -14933,10 +14933,10 @@ function convertBaseSchema(schema, ctx) {
     }
     ctx.processing.add(refPath);
     const resolved = resolveRef(refPath, ctx);
-    const zodSchema71 = convertSchema(resolved, ctx);
-    ctx.refs.set(refPath, zodSchema71);
+    const zodSchema72 = convertSchema(resolved, ctx);
+    ctx.refs.set(refPath, zodSchema72);
     ctx.processing.delete(refPath);
-    return zodSchema71;
+    return zodSchema72;
   }
   if (schema.enum !== void 0) {
     const enumValues = schema.enum;
@@ -14978,7 +14978,7 @@ function convertBaseSchema(schema, ctx) {
   if (!type) {
     return z.any();
   }
-  let zodSchema70;
+  let zodSchema71;
   switch (type) {
     case "string": {
       let stringSchema = z.string();
@@ -15041,7 +15041,7 @@ function convertBaseSchema(schema, ctx) {
       if (schema.pattern) {
         stringSchema = stringSchema.regex(new RegExp(schema.pattern));
       }
-      zodSchema70 = stringSchema;
+      zodSchema71 = stringSchema;
       break;
     }
     case "number":
@@ -15066,15 +15066,15 @@ function convertBaseSchema(schema, ctx) {
       if (typeof schema.multipleOf === "number") {
         numberSchema = numberSchema.multipleOf(schema.multipleOf);
       }
-      zodSchema70 = numberSchema;
+      zodSchema71 = numberSchema;
       break;
     }
     case "boolean": {
-      zodSchema70 = z.boolean();
+      zodSchema71 = z.boolean();
       break;
     }
     case "null": {
-      zodSchema70 = z.null();
+      zodSchema71 = z.null();
       break;
     }
     case "object": {
@@ -15089,12 +15089,12 @@ function convertBaseSchema(schema, ctx) {
         const keySchema = convertSchema(schema.propertyNames, ctx);
         const valueSchema = schema.additionalProperties && typeof schema.additionalProperties === "object" ? convertSchema(schema.additionalProperties, ctx) : z.any();
         if (Object.keys(shape).length === 0) {
-          zodSchema70 = z.record(keySchema, valueSchema);
+          zodSchema71 = z.record(keySchema, valueSchema);
           break;
         }
         const objectSchema2 = z.object(shape).passthrough();
         const recordSchema = z.looseRecord(keySchema, valueSchema);
-        zodSchema70 = z.intersection(objectSchema2, recordSchema);
+        zodSchema71 = z.intersection(objectSchema2, recordSchema);
         break;
       }
       if (schema.patternProperties) {
@@ -15112,25 +15112,25 @@ function convertBaseSchema(schema, ctx) {
         }
         schemasToIntersect.push(...looseRecords);
         if (schemasToIntersect.length === 0) {
-          zodSchema70 = z.object({}).passthrough();
+          zodSchema71 = z.object({}).passthrough();
         } else if (schemasToIntersect.length === 1) {
-          zodSchema70 = schemasToIntersect[0];
+          zodSchema71 = schemasToIntersect[0];
         } else {
           let result = z.intersection(schemasToIntersect[0], schemasToIntersect[1]);
           for (let i = 2; i < schemasToIntersect.length; i++) {
             result = z.intersection(result, schemasToIntersect[i]);
           }
-          zodSchema70 = result;
+          zodSchema71 = result;
         }
         break;
       }
       const objectSchema = z.object(shape);
       if (schema.additionalProperties === false) {
-        zodSchema70 = objectSchema.strict();
+        zodSchema71 = objectSchema.strict();
       } else if (typeof schema.additionalProperties === "object") {
-        zodSchema70 = objectSchema.catchall(convertSchema(schema.additionalProperties, ctx));
+        zodSchema71 = objectSchema.catchall(convertSchema(schema.additionalProperties, ctx));
       } else {
-        zodSchema70 = objectSchema.passthrough();
+        zodSchema71 = objectSchema.passthrough();
       }
       break;
     }
@@ -15141,29 +15141,29 @@ function convertBaseSchema(schema, ctx) {
         const tupleItems = prefixItems.map((item) => convertSchema(item, ctx));
         const rest = items && typeof items === "object" && !Array.isArray(items) ? convertSchema(items, ctx) : void 0;
         if (rest) {
-          zodSchema70 = z.tuple(tupleItems).rest(rest);
+          zodSchema71 = z.tuple(tupleItems).rest(rest);
         } else {
-          zodSchema70 = z.tuple(tupleItems);
+          zodSchema71 = z.tuple(tupleItems);
         }
         if (typeof schema.minItems === "number") {
-          zodSchema70 = zodSchema70.check(z.minLength(schema.minItems));
+          zodSchema71 = zodSchema71.check(z.minLength(schema.minItems));
         }
         if (typeof schema.maxItems === "number") {
-          zodSchema70 = zodSchema70.check(z.maxLength(schema.maxItems));
+          zodSchema71 = zodSchema71.check(z.maxLength(schema.maxItems));
         }
       } else if (Array.isArray(items)) {
         const tupleItems = items.map((item) => convertSchema(item, ctx));
         const rest = schema.additionalItems && typeof schema.additionalItems === "object" ? convertSchema(schema.additionalItems, ctx) : void 0;
         if (rest) {
-          zodSchema70 = z.tuple(tupleItems).rest(rest);
+          zodSchema71 = z.tuple(tupleItems).rest(rest);
         } else {
-          zodSchema70 = z.tuple(tupleItems);
+          zodSchema71 = z.tuple(tupleItems);
         }
         if (typeof schema.minItems === "number") {
-          zodSchema70 = zodSchema70.check(z.minLength(schema.minItems));
+          zodSchema71 = zodSchema71.check(z.minLength(schema.minItems));
         }
         if (typeof schema.maxItems === "number") {
-          zodSchema70 = zodSchema70.check(z.maxLength(schema.maxItems));
+          zodSchema71 = zodSchema71.check(z.maxLength(schema.maxItems));
         }
       } else if (items !== void 0) {
         const element = convertSchema(items, ctx);
@@ -15174,16 +15174,16 @@ function convertBaseSchema(schema, ctx) {
         if (typeof schema.maxItems === "number") {
           arraySchema = arraySchema.max(schema.maxItems);
         }
-        zodSchema70 = arraySchema;
+        zodSchema71 = arraySchema;
       } else {
-        zodSchema70 = z.array(z.any());
+        zodSchema71 = z.array(z.any());
       }
       break;
     }
     default:
       throw new Error(`Unsupported type: ${type}`);
   }
-  return zodSchema70;
+  return zodSchema71;
 }
 function convertSchema(schema, ctx) {
   if (typeof schema === "boolean") {
@@ -101494,7 +101494,6 @@ var bootstrapDylibPath = () => {
   return requireDylibIn(DYLIB_DIR, "libArgentInjectionBootstrap.dylib");
 };
 var bootstrapDylibPathTcp = () => {
-  requireDarwin("bootstrapDylibPathTcp");
   return requireDylibIn(DYLIB_TCP_DIR, "libArgentInjectionBootstrap.dylib");
 };
 var bootstrapDylibPathTvos = () => {
@@ -101502,11 +101501,9 @@ var bootstrapDylibPathTvos = () => {
   return requireDylibIn(DYLIB_TVOS_DIR, "libArgentInjectionBootstrap.dylib");
 };
 var nativeDevtoolsDylibPathTcp = () => {
-  requireDarwin("nativeDevtoolsDylibPathTcp");
   return requireDylibIn(DYLIB_TCP_DIR, "libNativeDevtoolsIos.dylib");
 };
 var keyboardPatchDylibPathTcp = () => {
-  requireDarwin("keyboardPatchDylibPathTcp");
   return requireDylibIn(DYLIB_TCP_DIR, "libKeyboardPatch.dylib");
 };
 function tcpInjectionDylibs() {
@@ -101554,7 +101551,6 @@ function axServiceBinaryPath() {
   return requireBinIn(platformBinDir(), "ax-service");
 }
 function axServiceBinaryPathTcp() {
-  requireDarwin("ax-service (tcp)");
   return requireBinIn(platformTcpBinDir(), "ax-service");
 }
 function tvosAxServiceBinaryPath() {
@@ -102451,23 +102447,23 @@ var NotImplementedOnPlatformError = class extends Error {
     });
   }
 };
-function platformMatrix(platform, capability28) {
+function platformMatrix(platform, capability29) {
   switch (platform) {
     case "ios":
-      return capability28.apple;
+      return capability29.apple;
     case "ios-remote":
-      return capability28.appleRemote;
+      return capability29.appleRemote;
     case "android":
-      return capability28.android;
+      return capability29.android;
     case "chromium":
-      return capability28.chromium;
+      return capability29.chromium;
     case "vega":
-      return capability28.vega;
+      return capability29.vega;
   }
 }
-function assertSupported(toolId, capability28, device) {
-  if (!capability28) return;
-  const matrix = platformMatrix(device.platform, capability28);
+function assertSupported(toolId, capability29, device) {
+  if (!capability29) return;
+  const matrix = platformMatrix(device.platform, capability29);
   if (!matrix) {
     throw new UnsupportedOperationError(toolId, device, `no ${device.platform} support declared`);
   }
@@ -102475,7 +102471,7 @@ function assertSupported(toolId, capability28, device) {
   if (!supported) {
     throw new UnsupportedOperationError(toolId, device, `kind '${device.kind}' not supported`);
   }
-  if (capability28.supports && !capability28.supports(device)) {
+  if (capability29.supports && !capability29.supports(device)) {
     throw new UnsupportedOperationError(toolId, device, "supports() refiner rejected device");
   }
 }
@@ -109462,6 +109458,28 @@ function sleepOrAbort(ms, signal) {
     signal?.addEventListener("abort", onAbort, { once: true });
   });
 }
+function settleWithin(p, ms, signal) {
+  return new Promise((resolve5) => {
+    let done = false;
+    const teardown = [];
+    const finish = (r) => {
+      if (done) return;
+      done = true;
+      for (const fn of teardown) fn();
+      resolve5(r);
+    };
+    p.then(
+      (value) => finish({ type: "value", value }),
+      (err) => finish({ type: "error", error: err instanceof Error ? err.message : String(err) })
+    );
+    if (signal?.aborted) return finish({ type: "aborted" });
+    const onAbort = () => finish({ type: "aborted" });
+    signal?.addEventListener("abort", onAbort, { once: true });
+    teardown.push(() => signal?.removeEventListener("abort", onAbort));
+    const timer = setTimeout(() => finish({ type: "timeout" }), Math.max(0, ms));
+    teardown.push(() => clearTimeout(timer));
+  });
+}
 
 // ../tool-server/src/utils/simulator-client.ts
 var fs9 = __toESM(require("node:fs/promises"));
@@ -121351,6 +121369,11 @@ function makeIosImpl3(registry2) {
     handler: async (_services, params, device) => await isTvOsSimulator(device.id) ? typeTv(registry2, device, params) : typeSimulatorServer(registry2, device, params)
   };
 }
+function makeIosRemoteImpl(registry2) {
+  return {
+    handler: async (_services, params, device) => typeSimulatorServer(registry2, device, params)
+  };
+}
 
 // ../tool-server/src/tools/keyboard/platforms/android.ts
 init_adb();
@@ -121664,6 +121687,7 @@ Provide text, key, or both.`,
       toolId: "keyboard",
       capability: capability15,
       ios: makeIosImpl3(registry2),
+      iosRemote: makeIosRemoteImpl(registry2),
       android: makeAndroidImpl(registry2),
       chromium: makeChromiumImpl(registry2),
       vega: vegaImpl4
@@ -121856,6 +121880,49 @@ async function invokeSubTool(registry2, ctx, toolId, args) {
 // ../tool-server/src/tools/await-ui-element/index.ts
 init_zod();
 
+// ../tool-server/src/utils/poll-describe-tree.ts
+async function pollDescribeTree(args) {
+  const { fetchTree, timeoutMs, pollIntervalMs, signal, onSample } = args;
+  const start2 = Date.now();
+  const deadline = start2 + timeoutMs;
+  let polls = 0;
+  let lastData = null;
+  let lastError;
+  const outcome = (result, aborted2) => ({
+    result,
+    aborted: aborted2,
+    polls,
+    elapsedMs: Date.now() - start2,
+    lastData,
+    lastError
+  });
+  for (; ; ) {
+    if (signal?.aborted) return outcome(void 0, true);
+    const remaining = Math.max(0, deadline - Date.now());
+    const settled = await settleWithin(fetchTree(), remaining, signal);
+    polls += 1;
+    if (settled.type === "aborted") return outcome(void 0, true);
+    if (settled.type === "timeout") {
+      if (lastData === null) {
+        lastError ??= `tree fetch did not complete within the ${timeoutMs}ms wait budget`;
+      }
+      break;
+    }
+    if (settled.type === "error") {
+      lastError = settled.error;
+    } else {
+      lastData = settled.value;
+      lastError = void 0;
+      const verdict = onSample(settled.value, Date.now());
+      if (verdict.done) return outcome(verdict.result, false);
+    }
+    if (Date.now() >= deadline) break;
+    const sleepMs = Math.min(pollIntervalMs, Math.max(0, deadline - Date.now()));
+    if (!await sleepOrAbort(sleepMs, signal)) return outcome(void 0, true);
+  }
+  return outcome(void 0, false);
+}
+
 // ../tool-server/src/tools/describe/platforms/chromium.ts
 init_src();
 var DESCRIBE_FAILURE = {
@@ -122443,28 +122510,6 @@ function timeoutNote(params, lastTree, fetchError, lastData) {
   }
   return appendDiagnostics(base, lastData);
 }
-function settleWithin(p, ms, signal) {
-  return new Promise((resolve5) => {
-    let done = false;
-    const teardown = [];
-    const finish = (r) => {
-      if (done) return;
-      done = true;
-      for (const fn of teardown) fn();
-      resolve5(r);
-    };
-    p.then(
-      (value) => finish({ type: "value", value }),
-      (err) => finish({ type: "error", error: err instanceof Error ? err.message : String(err) })
-    );
-    if (signal?.aborted) return finish({ type: "aborted" });
-    const onAbort = () => finish({ type: "aborted" });
-    signal?.addEventListener("abort", onAbort, { once: true });
-    teardown.push(() => signal?.removeEventListener("abort", onAbort));
-    const timer = setTimeout(() => finish({ type: "timeout" }), Math.max(0, ms));
-    teardown.push(() => clearTimeout(timer));
-  });
-}
 function createAwaitUiElementTool(registry2) {
   async function fetchTree(device, params, services, isTvOs) {
     if (device.platform === "ios") {
@@ -122522,34 +122567,14 @@ or before tapping an element that appears asynchronously.`,
       });
       const timeoutMs = params.timeoutMs ?? DEFAULT_TIMEOUT_MS3;
       const pollIntervalMs = params.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
-      const deadline = start2 + timeoutMs;
       const selector = params.selector;
-      let lastTree = null;
-      let lastData = null;
-      let fetchError;
       let everMatched = false;
-      for (; ; ) {
-        if (signal?.aborted) return cancelled();
-        const remaining = Math.max(0, deadline - Date.now());
-        const settled = await settleWithin(
-          fetchTree(device, params, services, isTvOs),
-          remaining,
-          signal
-        );
-        if (settled.type === "aborted") return cancelled();
-        if (settled.type === "timeout") {
-          if (lastTree === null) {
-            fetchError ??= `tree fetch did not complete within the ${timeoutMs}ms wait budget`;
-          }
-          break;
-        }
-        if (settled.type === "error") {
-          fetchError = settled.error;
-        } else {
-          const data = settled.value;
-          lastData = data;
-          lastTree = data.tree;
-          fetchError = void 0;
+      const poll = await pollDescribeTree({
+        fetchTree: () => fetchTree(device, params, services, isTvOs),
+        timeoutMs,
+        pollIntervalMs,
+        signal,
+        onSample: (data) => {
           const matches2 = findAll(data.tree, selector);
           if (matches2.length > 0) everMatched = true;
           const blind = isBlindRead(data, everMatched);
@@ -122558,17 +122583,17 @@ or before tapping an element that appears asynchronously.`,
             if (params.condition === "hidden" && !everMatched) {
               result.note = "condition met immediately \u2014 the selector never matched any element, so it may have already been hidden before the wait, or the selector is wrong";
             }
-            return result;
+            return { done: true, result };
           }
+          return { done: false };
         }
-        if (Date.now() >= deadline) break;
-        const sleepMs = Math.min(pollIntervalMs, Math.max(0, deadline - Date.now()));
-        if (!await sleepOrAbort(sleepMs, signal)) return cancelled();
-      }
+      });
+      if (poll.aborted) return cancelled();
+      if (poll.result) return poll.result;
       return {
         success: false,
         elapsed: Date.now() - start2,
-        note: timeoutNote(params, lastTree, fetchError, lastData)
+        note: timeoutNote(params, poll.lastData?.tree ?? null, poll.lastError, poll.lastData)
       };
     }
   };
@@ -130153,6 +130178,105 @@ back/menu/home), then call describe again to confirm where focus landed.`,
   };
 }
 
+// ../tool-server/src/tools/await-screen-idle/index.ts
+init_zod();
+var AWAIT_SCREEN_IDLE_TOOL_ID = "await-screen-idle";
+var DEFAULT_TIMEOUT_MS4 = 3e3;
+var DEFAULT_POLL_INTERVAL_MS2 = 200;
+var DEFAULT_MIN_STABLE_MS = 250;
+var zodSchema38 = external_exports.object({
+  udid: external_exports.string().min(1).describe("Target device id from `list-devices` (iOS UDID, Android serial, or Chromium id)."),
+  timeoutMs: external_exports.number().int().positive().max(12e4).optional().describe(
+    `Max time to wait for the screen to settle before giving up (default ${DEFAULT_TIMEOUT_MS4}).`
+  ),
+  pollIntervalMs: external_exports.number().int().min(50).max(5e3).optional().describe(`How often to re-read the tree (default ${DEFAULT_POLL_INTERVAL_MS2}).`),
+  minStableMs: external_exports.number().int().min(0).max(1e4).optional().describe(
+    `The screen must hold the same content for at least this long to count as settled (default ${DEFAULT_MIN_STABLE_MS}).`
+  )
+});
+var capability21 = {
+  apple: { simulator: true, device: true },
+  android: { emulator: true, device: true, unknown: true },
+  chromium: { app: true }
+};
+function treeSignature(root2) {
+  const round2 = (n) => Math.round(n * 100) / 100;
+  const parts = [];
+  const walk = (node) => {
+    const f = node.frame;
+    parts.push(
+      `${node.role}|${node.label ?? ""}|${node.value ?? ""}|${round2(f.x)},${round2(f.y)},${round2(f.width)},${round2(f.height)}`
+    );
+    for (const child of node.children) walk(child);
+  };
+  for (const child of root2.children) walk(child);
+  return parts.join("\n");
+}
+function createAwaitScreenIdleTool(registry2) {
+  function fetchTree(device, services, isTvOs) {
+    if (device.platform === "ios") {
+      return describeIos(registry2, device, {}, { isTvOs });
+    }
+    if (device.platform === "android") {
+      return describeAndroid(registry2, device.id);
+    }
+    return describeChromium(services.chromium);
+  }
+  return {
+    id: AWAIT_SCREEN_IDLE_TOOL_ID,
+    description: `Block until the screen has rendered content and stopped changing, or a timeout elapses.
+
+Polls the same accessibility / DOM tree as \`describe\` every pollIntervalMs (default ${DEFAULT_POLL_INTERVAL_MS2}ms) until it
+has content and that content holds identical for minStableMs (default ${DEFAULT_MIN_STABLE_MS}ms), or timeoutMs (default
+${DEFAULT_TIMEOUT_MS4}ms) is reached. Returns { settled, waitedMs, polls } \u2014 settled=false means the screen never went
+still before the timeout. Use after a launch/navigation to wait for the UI to render before screenshotting or tapping.`,
+    searchHint: "wait until screen settles idle stable stops changing animation transition rendered ready before screenshot",
+    longRunning: true,
+    zodSchema: zodSchema38,
+    capability: capability21,
+    services: (params) => {
+      const device = resolveDevice(params.udid);
+      if (device.platform === "chromium") {
+        return { chromium: chromiumCdpRef(device) };
+      }
+      return {};
+    },
+    async execute(services, params, ctx) {
+      const device = resolveDevice(params.udid);
+      assertSupported(AWAIT_SCREEN_IDLE_TOOL_ID, capability21, device);
+      if (device.platform === "ios") await ensureDeps(iosRequires);
+      else if (device.platform === "android") await ensureDeps(androidRequires);
+      const isTvOs = device.platform === "ios" && await isTvOsSimulator(device.id);
+      const minStableMs = params.minStableMs ?? DEFAULT_MIN_STABLE_MS;
+      let stableSignature;
+      let stableSince = 0;
+      const poll = await pollDescribeTree({
+        fetchTree: () => fetchTree(device, services, isTvOs),
+        timeoutMs: params.timeoutMs ?? DEFAULT_TIMEOUT_MS4,
+        pollIntervalMs: params.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS2,
+        signal: ctx?.signal,
+        onSample: (data, nowMs) => {
+          if (data.tree.children.length === 0) {
+            stableSignature = void 0;
+            stableSince = 0;
+            return { done: false };
+          }
+          const signature = treeSignature(data.tree);
+          if (signature === stableSignature) {
+            if (nowMs - stableSince >= minStableMs) return { done: true, result: true };
+          } else {
+            stableSignature = signature;
+            stableSince = nowMs;
+            if (minStableMs === 0) return { done: true, result: true };
+          }
+          return { done: false };
+        }
+      });
+      return { settled: poll.result === true, waitedMs: poll.elapsedMs, polls: poll.polls };
+    }
+  };
+}
+
 // ../tool-server/src/tools/profiler/react/react-profiler-start.ts
 var crypto6 = __toESM(require("node:crypto"));
 init_zod();
@@ -130204,7 +130328,7 @@ function bootstrapFailureMessage(bootstrap) {
 // ../tool-server/src/tools/profiler/react/react-profiler-start.ts
 var NO_DEVTOOLS_HOOK_ERROR = "React DevTools hook (__REACT_DEVTOOLS_GLOBAL_HOOK__) is not present in this app's JavaScript runtime. React profiling requires a development build with React DevTools enabled. Likely causes: (1) the app is a release/production build \u2014 DevTools is stripped to reduce bundle size; (2) you connected to the wrong JS runtime; (3) this isn't a React (Native) app. Fix: rebuild in debug/dev mode (e.g. `npx react-native run-ios` without --configuration Release; for Expo, run a dev client). Once the app is running with DevTools attached, call react-profiler-start again.";
 var NO_RENDERERS_ATTACHED_ERROR = "React DevTools hook is present but no React renderer has registered yet. The hook is loaded but no fiber renderer has attached \u2014 typically because the app has not committed its first render, or the DevTools backend has not been bootstrapped on a bridgeless React Native dev build. Fix: ensure the app has rendered (interact with it once, then retry); if it stays empty, call react-profiler-start first \u2014 it will attempt to attach the DevTools backend automatically.";
-var zodSchema38 = external_exports.object({
+var zodSchema39 = external_exports.object({
   port: external_exports.coerce.number().default(8081).describe("Metro server port"),
   device_id: external_exports.string().describe(
     "Device logicalDeviceId from debugger-connect (iOS simulator UDID or Android logicalDeviceId)."
@@ -130231,7 +130355,7 @@ Before calling this, ask the user if they also want native profiling (native-pro
 After starting, ask the user to perform the interaction to profile, then call react-profiler-stop.
 Returns { started_at, startedAtEpochMs, hermes_version, detected_architecture } on success, or the already_running payload described above.
 Fails if the Hermes runtime is not reachable or the Metro CDP connection cannot be established.`,
-    zodSchema: zodSchema38,
+    zodSchema: zodSchema39,
     // RN-only: bootstraps the React DevTools backend and uses Hermes'
     // Profiler.start. A CDP-direct CPU profile for Chromium is tracked as a
     // follow-up; the React commit recording has no Chromium analog.
@@ -130503,7 +130627,7 @@ async function readCommitTree(path31) {
 }
 
 // ../tool-server/src/tools/profiler/react/react-profiler-stop.ts
-var zodSchema39 = external_exports.object({
+var zodSchema40 = external_exports.object({
   port: external_exports.coerce.number().default(8081).describe("Metro server port"),
   device_id: external_exports.string().describe(
     "Device logicalDeviceId from debugger-connect (iOS simulator UDID or Android logicalDeviceId)."
@@ -130587,7 +130711,7 @@ Call react-profiler-start first, then exercise the app, then call this.
 Returns { duration_ms, sample_count, fiber_renders_captured, total_react_commits, hot_commit_indices } summarizing the session.
 When any commit had fibers whose display name could not be resolved at stop time (typically transient components like modals/tooltips/animations that unmounted before stop), the response also includes { unattributed_ms, unattributed_fiber_count, unattributed_commit_count } \u2014 these quantify how much work is not accounted for in the per-component breakdown (the per-commit duration itself remains correct).
 Fails if no active profiling session exists or the CDP connection was lost during recording.`,
-    zodSchema: zodSchema39,
+    zodSchema: zodSchema40,
     // RN-only: companion to react-profiler-start.
     capability: RN_ONLY_TOOL_CAPABILITY,
     services: () => ({}),
@@ -130815,7 +130939,7 @@ Fails if no active profiling session exists or the CDP connection was lost durin
 
 // ../tool-server/src/tools/profiler/react/react-profiler-status.ts
 init_zod();
-var zodSchema40 = external_exports.object({
+var zodSchema41 = external_exports.object({
   port: external_exports.coerce.number().default(8081).describe("Metro server port"),
   device_id: external_exports.string().describe(
     "Device logicalDeviceId from debugger-connect (iOS simulator UDID or Android logicalDeviceId)."
@@ -130825,7 +130949,7 @@ function createReactProfilerStatusTool(registry2) {
   return {
     id: "react-profiler-status",
     description: `Check the state of the React profiler session without side effects. Use after an interruption (debugger disconnect, unexpected error, agent pause) to decide whether to continue with react-profiler-stop, start a new session, or reconnect the debugger. Ownership is verified server-side against this tool-server's in-memory session \u2014 no token-threading is required. Returns { session_status, is_running, current_owner, \u2026 }. If this tool-server process restarted after react-profiler-start, status will report 'taken_over'; use react-profiler-start { force: true } to reclaim.`,
-    zodSchema: zodSchema40,
+    zodSchema: zodSchema41,
     // RN-only: companion to react-profiler-start.
     capability: RN_ONLY_TOOL_CAPABILITY,
     services: () => ({}),
@@ -132320,7 +132444,7 @@ var annotationSchema = external_exports.object({
   ),
   label: external_exports.string().describe("Description of the action performed")
 });
-var zodSchema41 = external_exports.object({
+var zodSchema42 = external_exports.object({
   port: external_exports.coerce.number().default(8081).describe("Metro server port"),
   device_id: external_exports.string().describe(
     "Device logicalDeviceId from debugger-connect (iOS simulator UDID or Android logicalDeviceId)."
@@ -132348,7 +132472,7 @@ where tapTimestampMs is the timestampMs returned by the tap/swipe tool and start
 is returned by react-profiler-start.
 Use when the profiling session is complete and you need to interpret the collected data.
 Fails if react-profiler-stop has not been called or no profiling data is stored.`,
-  zodSchema: zodSchema41,
+  zodSchema: zodSchema42,
   // RN-only: operates on profiler trace files captured via the React DevTools
   // backend's commit recording, which is not present on Chromium.
   capability: RN_ONLY_TOOL_CAPABILITY,
@@ -132485,7 +132609,7 @@ Fails if react-profiler-stop has not been called or no profiling data is stored.
 // ../tool-server/src/tools/profiler/react/react-profiler-component-source.ts
 init_zod();
 var import_fs6 = require("fs");
-var zodSchema42 = external_exports.object({
+var zodSchema43 = external_exports.object({
   component_name: external_exports.string().describe("Name of the React component to look up"),
   project_root: external_exports.string().describe("Absolute path to the RN project root")
 });
@@ -132498,7 +132622,7 @@ var reactProfilerComponentSourceTool = {
 Call this per-finding after react-profiler-analyze to inspect source before proposing a fix.
 Returns found: false if the component is not found in user-owned code (e.g. lives in node_modules).
 When several files define a component with the same name (e.g. platform variants like List.tsx and List.web.tsx), returns the primary match and lists the rest under otherMatches[] (file/line/col) \u2014 check it before assuming the returned file is the one you meant.`,
-  zodSchema: zodSchema42,
+  zodSchema: zodSchema43,
   // Companion to react-profiler-analyze. Carries the same RN-only capability
   // declaration as the rest of react-profiler-* for intent-clarity, even
   // though the HTTP gate is a no-op here (the tool takes no device_id, so
@@ -132552,7 +132676,7 @@ When several files define a component with the same name (e.g. platform variants
 // ../tool-server/src/tools/profiler/react/react-profiler-cpu-summary.ts
 init_zod();
 init_src();
-var zodSchema43 = external_exports.object({
+var zodSchema44 = external_exports.object({
   port: external_exports.coerce.number().default(8081).describe("Metro server port"),
   device_id: external_exports.string().describe(
     "Device logicalDeviceId from debugger-connect (iOS simulator UDID or Android logicalDeviceId)."
@@ -132629,7 +132753,7 @@ Use when you specifically need to investigate JS CPU hotspots that are NOT tied
 Call react-profiler-stop first. Reads directly from the stored cpuProfile.
 Returns a markdown table of the top hotspot functions with self-time, total-time, and location.
 Fails if react-profiler-stop has not been called or no CPU profile is stored.`,
-  zodSchema: zodSchema43,
+  zodSchema: zodSchema44,
   // RN-only: reads a Hermes CPU profile captured via the React profiler
   // session. Chromium's V8 Profiler emits a different sample format — see the
   // PR description for the follow-up scope.
@@ -132727,7 +132851,7 @@ function renderMarkdownTable2(entries) {
   );
   return [header, sep4, ...rows].join("\n");
 }
-var zodSchema44 = external_exports.object({
+var zodSchema45 = external_exports.object({
   port: external_exports.coerce.number().default(8081).describe("Metro server port"),
   device_id: external_exports.string().describe(
     "Device logicalDeviceId from debugger-connect (iOS simulator UDID or Android logicalDeviceId)."
@@ -132740,7 +132864,7 @@ var reactProfilerRendersTool = {
 Returns a markdown table of the top re-rendering components. No profiling session required \u2014 works on a live connected app.
 Use when you want a quick snapshot of render counts without a full profiling session.
 Fails if the React DevTools hook is not present in the runtime or the app is not connected.`,
-  zodSchema: zodSchema44,
+  zodSchema: zodSchema45,
   // RN-only: queries the React DevTools backend hook on the live runtime.
   capability: RN_ONLY_TOOL_CAPABILITY,
   services: (params) => ({
@@ -132897,7 +133021,7 @@ function buildFiberTreeScript(maxDepth, filter) {
   }
 })()`;
 }
-var zodSchema45 = external_exports.object({
+var zodSchema46 = external_exports.object({
   port: external_exports.coerce.number().default(8081).describe("Metro server port"),
   device_id: external_exports.string().describe(
     "Device logicalDeviceId from debugger-connect (iOS simulator UDID or Android logicalDeviceId)."
@@ -132911,7 +133035,7 @@ var reactProfilerFiberTreeTool = {
 Use when tracing ancestry of a library component or checking for useMemoCache hook (confirms React Compiler is active on a component).
 Returns a nested JSON tree of fiber nodes with name, tag, actualDuration, selfBaseDuration, and children.
 Fails if the React DevTools hook is not present or no fiber roots have been committed yet.`,
-  zodSchema: zodSchema45,
+  zodSchema: zodSchema46,
   // RN-only: walks the fiber tree via the React DevTools backend hook.
   capability: RN_ONLY_TOOL_CAPABILITY,
   services: (params) => ({
@@ -136319,7 +136443,7 @@ async function analyzeNativeProfilerAndroid(api) {
 }
 
 // ../tool-server/src/tools/profiler/native-profiler/native-profiler-start.ts
-var zodSchema46 = external_exports.object({
+var zodSchema47 = external_exports.object({
   device_id: external_exports.string().describe("Target device id from `list-devices` (iOS UDID or Android serial)."),
   app_process: external_exports.string().optional().describe(
     "iOS: the CFBundleExecutable or display name of the app to profile. Android: the app's package name. If omitted, auto-detects the currently running foreground app. Only provide this if auto-detection picks the wrong app."
@@ -136328,27 +136452,27 @@ var zodSchema46 = external_exports.object({
     "iOS-only: path to an Instruments .tracetemplate file (defaults to bundled Argent template). Ignored on Android."
   )
 });
-var capability21 = {
+var capability22 = {
   apple: { simulator: true, device: true },
   android: { emulator: true, device: true, unknown: true }
 };
 var nativeProfilerStartTool = {
   id: "native-profiler-start",
-  capability: capability21,
+  capability: capability22,
   description: `Start native profiling on a booted device. iOS: Instruments via xctrace (CPU, hangs, memory). Android: Perfetto (CPU, jank, RSS-growth weak signal).
 Auto-detects the running app process unless app_process is explicitly provided.
 After starting, let the user interact with the app, then call native-profiler-stop.
 Use when you want to capture native CPU, hang, and memory data for a running app.
 Returns { status, pid, traceFile } confirming the recording has started.
 Fails if no app is running on the device, or the profiler cannot attach to the process.`,
-  zodSchema: zodSchema46,
+  zodSchema: zodSchema47,
   services: (params) => ({
     session: nativeProfilerSessionRef(resolveDevice(params.device_id))
   }),
   async execute(services, params) {
     const api = services.session;
     const device = resolveDevice(params.device_id);
-    assertSupported("native-profiler-start", capability21, device);
+    assertSupported("native-profiler-start", capability22, device);
     if (api.platform === "ios") {
       await ensureDeps(["xcrun"]);
       return startNativeProfilerIos(api, params);
@@ -136360,10 +136484,10 @@ Fails if no app is running on the device, or the profiler cannot attach to the p
 
 // ../tool-server/src/tools/profiler/native-profiler/native-profiler-stop.ts
 init_zod();
-var zodSchema47 = external_exports.object({
+var zodSchema48 = external_exports.object({
   device_id: external_exports.string().describe("Target device id from `list-devices` (iOS UDID or Android serial).")
 });
-var capability22 = {
+var capability23 = {
   apple: { simulator: true, device: true },
   android: { emulator: true, device: true, unknown: true }
 };
@@ -136379,7 +136503,7 @@ function registerTrace(store, traceFile) {
 }
 var nativeProfilerStopTool = {
   id: "native-profiler-stop",
-  capability: capability22,
+  capability: capability23,
   description: `Stop native profiling and export trace data.
 iOS: sends SIGINT to xctrace, waits for packaging, then exports CPU, hangs, and leaks XML.
 Android: sends SIGTERM to the perfetto daemon, polls /proc/<pid>, then \`adb pull\`s the .pftrace.
@@ -136387,14 +136511,14 @@ Call native-profiler-start first.
 Use when the user has finished the interaction to profile and you need to export the trace.
 Returns { traceFile, exportedFiles, exportDiagnostics? }; traceFile is the raw trace bundle and exportedFiles the exports, all downloadable artifacts materialized to local paths.
 Fails if no active native-profiler-start session exists for the given device_id.`,
-  zodSchema: zodSchema47,
+  zodSchema: zodSchema48,
   services: (params) => ({
     session: nativeProfilerSessionRef(resolveDevice(params.device_id))
   }),
   async execute(services, params, ctx) {
     const api = services.session;
     const device = resolveDevice(params.device_id);
-    assertSupported("native-profiler-stop", capability22, device);
+    assertSupported("native-profiler-stop", capability23, device);
     if (api.platform === "ios") {
       await ensureDeps(["xcrun"]);
       const ios = await stopNativeProfilerIos(api);
@@ -136421,16 +136545,16 @@ Fails if no active native-profiler-start session exists for the given device_id.
 
 // ../tool-server/src/tools/profiler/native-profiler/native-profiler-analyze.ts
 init_zod();
-var zodSchema48 = external_exports.object({
+var zodSchema49 = external_exports.object({
   device_id: external_exports.string().describe("Target device id from `list-devices` (iOS UDID or Android serial).")
 });
-var capability23 = {
+var capability24 = {
   apple: { simulator: true, device: true },
   android: { emulator: true, device: true, unknown: true }
 };
 var nativeProfilerAnalyzeTool = {
   id: "native-profiler-analyze",
-  capability: capability23,
+  capability: capability24,
   description: `Analyze exported native trace data and return an LLM-optimized markdown report.
 iOS: parses CPU time profile, UI hangs, and memory leaks from the exported XML files.
 Android: queries the Perfetto .pftrace via the in-process Perfetto trace-processor engine for CPU hotspots, UI hangs with jank reason + main-thread state breakdown, GC annotation, and an RSS-growth weak signal.
@@ -136440,14 +136564,14 @@ profiler-stack-query for hang stacks, CPU context, leak details) or implement fi
 Call native-profiler-stop first to export the trace data.
 Use when you need to interpret a completed native profiling recording.
 Fails if native-profiler-stop has not been called first to export trace data.`,
-  zodSchema: zodSchema48,
+  zodSchema: zodSchema49,
   services: (params) => ({
     session: nativeProfilerSessionRef(resolveDevice(params.device_id))
   }),
   async execute(services, params, ctx) {
     const api = services.session;
     const device = resolveDevice(params.device_id);
-    assertSupported("native-profiler-analyze", capability23, device);
+    assertSupported("native-profiler-analyze", capability24, device);
     let result;
     if (api.platform === "ios") {
       await ensureDeps(["xcrun"]);
@@ -136471,7 +136595,7 @@ var timeWindowSchema = external_exports.object({
   start: external_exports.coerce.number().describe("Start of window in ms (performance.now clock)"),
   end: external_exports.coerce.number().describe("End of window in ms (performance.now clock)")
 });
-var zodSchema49 = external_exports.object({
+var zodSchema50 = external_exports.object({
   port: external_exports.coerce.number().default(8081).describe("Metro server port"),
   device_id: external_exports.string().describe(
     "Device logicalDeviceId from debugger-connect (iOS simulator UDID or Android logicalDeviceId)."
@@ -136707,7 +136831,7 @@ Modes:
 Use when investigating JS CPU hotspots or correlating CPU cost with specific components.
 Returns a markdown table of CPU hotspots, call tree, or per-component CPU breakdown.
 Fails if no CPU profile is stored \u2014 run react-profiler-stop first.`,
-  zodSchema: zodSchema49,
+  zodSchema: zodSchema50,
   // RN-only: reads Hermes-format CPU profiles. Chromium's V8 sample format is
   // different — see the PR description for the follow-up scope.
   capability: RN_ONLY_TOOL_CAPABILITY,
@@ -136790,7 +136914,7 @@ var timeRangeSchema = external_exports.object({
   start: external_exports.coerce.number().describe("Start of range in ms (performance.now clock)"),
   end: external_exports.coerce.number().describe("End of range in ms (performance.now clock)")
 });
-var zodSchema50 = external_exports.object({
+var zodSchema51 = external_exports.object({
   port: external_exports.coerce.number().default(8081).describe("Metro server port"),
   device_id: external_exports.string().describe(
     "Device logicalDeviceId from debugger-connect (iOS simulator UDID or Android logicalDeviceId)."
@@ -137035,7 +137159,7 @@ Modes:
 Use when drilling into specific components or time windows after react-profiler-analyze.
 Returns a markdown table or tree of commit data matching the requested mode.
 Fails if react-profiler-stop has not been called or no commit data is stored.`,
-  zodSchema: zodSchema50,
+  zodSchema: zodSchema51,
   // RN-only: reads React commit data captured via the React DevTools backend.
   capability: RN_ONLY_TOOL_CAPABILITY,
   services: () => ({}),
@@ -137113,7 +137237,7 @@ function formatBytes4(bytes) {
 }
 
 // ../tool-server/src/tools/profiler/query/profiler-stack-query.ts
-var zodSchema51 = external_exports.object({
+var zodSchema52 = external_exports.object({
   device_id: external_exports.string().describe("iOS Simulator UDID or Android serial."),
   mode: external_exports.enum(["hang_stacks", "function_callers", "thread_breakdown", "leak_stacks"]).describe(
     "Query mode: hang_stacks (full CPU context during a hang), function_callers (who calls a native function), thread_breakdown (CPU split by thread), leak_stacks (leak details by object type)"
@@ -137413,7 +137537,7 @@ Modes:
 Use when drilling into native hang stacks, thread CPU breakdown, or memory leaks after native-profiler-analyze.
 Returns a markdown report with native call stacks, thread weights, or leak details for the selected mode.
 Fails if native-profiler-analyze has not been run or no parsed trace data is in memory.`,
-  zodSchema: zodSchema51,
+  zodSchema: zodSchema52,
   // iOS: reads xctrace output. Android: queries the Perfetto .pftrace via the
   // in-process trace-processor engine (see executeAndroid). Chromium has no
   // native trace capture.
@@ -137469,7 +137593,7 @@ function buildPerfettoAnchor(wallClockStartMs) {
 }
 
 // ../tool-server/src/tools/profiler/combined/profiler-combined-report.ts
-var zodSchema52 = external_exports.object({
+var zodSchema53 = external_exports.object({
   port: external_exports.coerce.number().default(8081).describe("Metro server port"),
   device_id: external_exports.string().describe("iOS Simulator/device UDID or Android serial")
 });
@@ -137481,7 +137605,7 @@ Requires both react-profiler-analyze and native-profiler-analyze to have been ca
 Call this tool when both profilers were run in parallel on the same session.
 Returns a markdown report correlating hangs with React commits, memory leaks, and investigation hints.
 Fails if either react-profiler-analyze or native-profiler-analyze has not been called first.`,
-  zodSchema: zodSchema52,
+  zodSchema: zodSchema53,
   // Combines React (Hermes) + native traces. iOS reads xctrace output;
   // Android re-queries the Perfetto .pftrace via loadAndroidCombinedData. The
   // capture half exists on neither platform's Chromium.
@@ -137770,7 +137894,7 @@ function assertSafeSessionId(sessionId) {
     );
   }
 }
-var zodSchema53 = external_exports.object({
+var zodSchema54 = external_exports.object({
   mode: external_exports.enum(["list", "load_react", "load_native"]).describe(
     "list: show available sessions on disk. load_react: load a React profiler session into memory for query tools. load_native: re-parse native profiler XML files (xctrace on iOS) into memory for query tools."
   ),
@@ -138094,7 +138218,7 @@ Modes:
   For Android .pftrace restores, pass app_process for older sessions that do not have a metadata sidecar.
 Returns a summary of the loaded session or a session list for the list mode.
 Fails if the session_id is not found or required XML files are missing from disk.`,
-  zodSchema: zodSchema53,
+  zodSchema: zodSchema54,
   // Loads Hermes-format React traces or iOS xctrace XML — neither maps onto
   // Chromium yet. The gate keeps the error close to the call site instead of
   // letting it surface from inside the trace parser.
@@ -138154,7 +138278,7 @@ Fails if the session_id is not found or required XML files are missing from disk
 // ../tool-server/src/tools/simulator/stop-simulator-server.ts
 init_zod();
 init_src();
-var zodSchema54 = external_exports.object({
+var zodSchema55 = external_exports.object({
   udid: external_exports.string().describe(
     "Target device id (iOS UDID, Android serial, or Chromium id) whose transport session to stop"
   )
@@ -138163,7 +138287,7 @@ function createStopSimulatorServerTool(registry2) {
   return {
     id: "stop-simulator-server",
     description: `Stop the transport session for a specific device (iOS / Android: simulator-server process; Chromium: CDP WebSocket) and free its resources. Use when you are done interacting with one device but want to keep others running. Returns { stopped, udid }. Fails silently if no session is open for the given id.`,
-    zodSchema: zodSchema54,
+    zodSchema: zodSchema55,
     services: () => ({}),
     async execute(_services, params) {
       const udid = params.udid;
@@ -138222,13 +138346,13 @@ function createStopAllSimulatorServersTool(registry2) {
 // ../tool-server/src/tools/simulator/stop-metro.ts
 init_zod();
 var import_node_child_process23 = require("node:child_process");
-var zodSchema55 = external_exports.object({
+var zodSchema56 = external_exports.object({
   port: external_exports.number().int().min(1).max(65535).default(8081).describe("TCP port Metro is listening on (default 8081)")
 });
 var stopMetroTool = {
   id: "stop-metro",
   description: `Stop the Metro bundler process listening on a given port (default 8081). Use when ending a React Native session or when Metro must be restarted. Returns { stopped, port, pids }; stopped=false if no process is found on the port. Fails if the port lookup command times out or the process cannot be killed. This is DESTRUCTIVE \u2014 always ask the user for confirmation before calling this tool.`,
-  zodSchema: zodSchema55,
+  zodSchema: zodSchema56,
   services: () => ({}),
   async execute(_services, params) {
     const port = params.port;
@@ -138455,7 +138579,7 @@ async function appendStepToActiveFlow(step) {
 }
 
 // ../tool-server/src/tools/flows/flow-start-recording.ts
-var zodSchema56 = external_exports.object({
+var zodSchema57 = external_exports.object({
   name: external_exports.string().describe('Name for this flow (e.g. "settings-explore")'),
   project_root: external_exports.string().describe(
     "Absolute path to the project root directory (the directory that contains or should contain `.argent/flows/`). The flow file is created at `<project_root>/.argent/flows/<name>.yaml`."
@@ -138480,7 +138604,7 @@ to add labels. Call flow-finish-recording when done.
 
 If a recorded step turns out to be wrong, you can edit the .yaml file directly
 to remove or reorder steps.`,
-  zodSchema: zodSchema56,
+  zodSchema: zodSchema57,
   fileInputs: fileInputs2,
   services: () => ({}),
   async execute(_services, params, ctx) {
@@ -138518,7 +138642,7 @@ to remove or reorder steps.`,
 
 // ../tool-server/src/tools/flows/flow-add-step.ts
 init_zod();
-var zodSchema57 = external_exports.object({
+var zodSchema58 = 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.`
@@ -138530,7 +138654,7 @@ function createFlowAddStepTool(registry2) {
     id: "flow-add-step",
     description: `Execute a tool call and record it as a step in the active flow. Use when recording a flow with flow-start-recording and you want to run and capture each action. Returns { message, toolResult, flowFile } on success. If it fails an error is returned and nothing is recorded. Error if the tool name is not found in the registry or arguments are invalid JSON.
 If a step was recorded by mistake, edit the .yaml file directly to remove it.`,
-    zodSchema: zodSchema57,
+    zodSchema: zodSchema58,
     services: () => ({}),
     async execute(_services, params, ctx) {
       const flowName = getActiveFlow();
@@ -138554,7 +138678,7 @@ If a step was recorded by mistake, edit the .yaml file directly to remove it.`,
 
 // ../tool-server/src/tools/flows/flow-insert-echo.ts
 init_zod();
-var zodSchema58 = external_exports.object({
+var zodSchema59 = external_exports.object({
   message: external_exports.string().describe("Message to echo when the flow is replayed")
 });
 var flowInsertEchoTool = {
@@ -138562,7 +138686,7 @@ var flowInsertEchoTool = {
   description: `Record an echo step in the active flow. Echo steps print a message when the flow is replayed \u2014 useful as labels between tool calls.
 Use when you want to annotate a recorded flow with a human-readable label or checkpoint message.
 Returns { message, flowFile }. Fails if no active flow recording is in progress.`,
-  zodSchema: zodSchema58,
+  zodSchema: zodSchema59,
   services: () => ({}),
   async execute(_services, params) {
     const flowName = getActiveFlow();
@@ -138581,12 +138705,12 @@ Returns { message, flowFile }. Fails if no active flow recording is in progress.
 // ../tool-server/src/tools/flows/flow-finish-recording.ts
 init_zod();
 var fs37 = __toESM(require("node:fs/promises"));
-var zodSchema59 = external_exports.object({});
+var zodSchema60 = external_exports.object({});
 var flowFinishRecordingTool = {
   id: "flow-finish-recording",
   description: `Finish recording the active flow. Returns a summary of all recorded steps and the final YAML content. Use when you have added all desired steps and want to finalize the flow file. Fails if no active flow recording is in progress.
 You can still edit the .yaml file directly afterwards to remove or reorder steps.`,
-  zodSchema: zodSchema59,
+  zodSchema: zodSchema60,
   services: () => ({}),
   async execute(_services, _params) {
     const flowName = getActiveFlow();
@@ -138624,7 +138748,7 @@ You can still edit the .yaml file directly afterwards to remove or reorder steps
 // ../tool-server/src/tools/flows/flow-run.ts
 init_zod();
 var fs38 = __toESM(require("node:fs/promises"));
-var zodSchema60 = external_exports.object({
+var zodSchema61 = external_exports.object({
   name: external_exports.string().describe('Name of the flow to run (e.g. "settings-explore")'),
   project_root: external_exports.string().describe(
     "Absolute path to the project root directory that contains `.argent/flows/<name>.yaml`."
@@ -138655,7 +138779,7 @@ 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: zodSchema60,
+    zodSchema: zodSchema61,
     fileInputs: fileInputs3,
     services: () => ({}),
     async execute(_services, params, ctx) {
@@ -138722,7 +138846,7 @@ function resolveFlowFilePath(params) {
 // ../tool-server/src/tools/flows/flow-read-prerequisite.ts
 init_zod();
 var fs39 = __toESM(require("node:fs/promises"));
-var zodSchema61 = external_exports.object({
+var zodSchema62 = external_exports.object({
   name: external_exports.string().describe('Name of the flow to inspect (e.g. "settings-explore")'),
   project_root: external_exports.string().describe(
     "Absolute path to the project root directory that contains `.argent/flows/<name>.yaml`."
@@ -138740,7 +138864,7 @@ var flowReadPrerequisiteTool = {
 Returns the prerequisite description so you can verify the required state is met before calling flow-execute.
 Use when you need to check what app/simulator state is required before executing a flow.
 Fails if the flow file does not exist in the .argent/flows/ directory.`,
-  zodSchema: zodSchema61,
+  zodSchema: zodSchema62,
   fileInputs: fileInputs4,
   services: () => ({}),
   async execute(_services, params) {
@@ -139053,7 +139177,7 @@ async function readWorkspaceSnapshot(workspacePath) {
 }
 
 // ../tool-server/src/tools/workspace/gather-workspace-data.ts
-var zodSchema62 = external_exports.object({
+var zodSchema63 = external_exports.object({
   workspacePath: external_exports.string().describe("Absolute path to the project root directory to inspect (e.g. /Users/dev/MyApp)")
 });
 var fileInputs5 = [
@@ -139079,7 +139203,7 @@ exploration of anything the snapshot surfaces.
 Use when you need to inspect project configuration without manually reading multiple files.
 Returns partial data if workspacePath does not exist or is not readable; missing items are represented as null or empty collections.
 Fails if the workspacePath is not an absolute path or the directory cannot be accessed.`,
-  zodSchema: zodSchema62,
+  zodSchema: zodSchema63,
   fileInputs: fileInputs5,
   services: () => ({}),
   async execute(_services, params) {
@@ -139133,13 +139257,13 @@ var updateArgentTool = {
 
 // ../tool-server/src/tools/system/dismiss-update.ts
 init_zod();
-var zodSchema63 = external_exports.object({
+var zodSchema64 = external_exports.object({
   hours: external_exports.number().min(0).describe("Number of hours to suppress the update notification")
 });
 var dismissUpdateTool = {
   id: "dismiss-update",
   description: "Clear the Argent update notification for the given number of hours. Use when the user asks to postpone or silence update reminders. Returns { message } confirming the suppression duration. Fails if the hours value is negative or the suppression state cannot be persisted.",
-  zodSchema: zodSchema63,
+  zodSchema: zodSchema64,
   services: () => ({}),
   async execute(_services, params, _options) {
     const durationMs = params.hours * 60 * 60 * 1e3;
@@ -141194,7 +141318,7 @@ function roundToOne(value) {
 }
 
 // ../tool-server/src/tools/screenshot-diff/index.ts
-var zodSchema64 = external_exports.object({
+var zodSchema65 = external_exports.object({
   baselinePath: external_exports.string().min(1).optional().describe("Path to the baseline PNG file. Required unless captureBaseline is true."),
   currentPath: external_exports.string().min(1).optional().describe("Path to the current PNG file. Required unless captureCurrent is true."),
   udid: external_exports.string().min(1).describe("Target device id from `list-devices` (iOS UDID or Android serial)."),
@@ -141209,7 +141333,7 @@ var zodSchema64 = external_exports.object({
     "Directory where diff artifacts should be written. Optional \u2014 defaults to a temp directory; the diff images are returned in the result either way."
   )
 }).strict();
-var capability24 = {
+var capability25 = {
   apple: { simulator: true, device: true },
   android: { emulator: true, device: true, unknown: true }
 };
@@ -141228,8 +141352,8 @@ Returns { summary, diffPath, contextDiffPath }. The summary uses normalized [0,1
 Ignores the fixed top status-bar band for both pixel and OCR text comparisons.
 Fails if the input sources are invalid, PNG files cannot be read, outputDir cannot be written, or the simulator-server / emulator backend is not reachable.`,
   searchHint: "compare screenshots png diff visual UI changes UI regression visual regression screenshot diff changed regions text ocr live capture",
-  zodSchema: zodSchema64,
-  capability: capability24,
+  zodSchema: zodSchema65,
+  capability: capability25,
   fileInputs: fileInputs6,
   services: (params) => {
     if (params.captureBaseline || params.captureCurrent) {
@@ -141447,7 +141571,7 @@ async function captureElementFrame(registry2, udid, match, opts = {}) {
 }
 
 // ../tool-server/src/tools/variants/propose-variant.ts
-var zodSchema65 = external_exports.object({
+var zodSchema66 = external_exports.object({
   element: external_exports.string().min(1).max(200).describe(
     'Human name of the on-screen element this variant targets, e.g. "Foo button" or "profile header". Repeated calls with the same element accumulate multiple variants on it. Used as the default screen matcher when `match` is omitted.'
   ),
@@ -141502,7 +141626,7 @@ arrives as a follow-up message (this is the case in an \`argent lens\` CLI sessi
 Returns { round, elementId, variantId, element, variantCount, totalElements } \u2014 confirmation only;
 it does not wait for the user.`,
     searchHint: "propose design variant alternative option for element non-blocking ab choice",
-    zodSchema: zodSchema65,
+    zodSchema: zodSchema66,
     services: () => ({}),
     async execute(_services, params) {
       let frame = params.variant.frame;
@@ -141526,7 +141650,7 @@ it does not wait for the user.`,
 
 // ../tool-server/src/tools/variants/await-user-selection.ts
 init_zod();
-var zodSchema66 = external_exports.object({
+var zodSchema67 = external_exports.object({
   timeoutSeconds: external_exports.number().int().min(5).max(86400).optional().describe(
     "Max seconds to block this call before returning a re-awaitable { status: 'pending' } result (default 1800). The user's proposals stay live across timeouts \u2014 on 'pending' just call await_user_selection again. Lower this if your MCP client enforces a short request timeout."
   )
@@ -141563,7 +141687,7 @@ This tool is long-running; it intentionally holds the request open. It honors cl
 disconnects (aborts cleanly).`,
   searchHint: "await wait user selection choice variant blocking confirm picks complete",
   longRunning: true,
-  zodSchema: zodSchema66,
+  zodSchema: zodSchema67,
   services: () => ({}),
   async execute(_services, params, options) {
     const timeoutMs = (params.timeoutSeconds ?? 1800) * 1e3;
@@ -141577,7 +141701,7 @@ disconnects (aborts cleanly).`,
 // ../tool-server/src/tools/chromium-tabs/index.ts
 init_zod();
 init_src();
-var zodSchema67 = external_exports.object({
+var zodSchema68 = external_exports.object({
   udid: external_exports.string().describe("Chromium device id from `list-devices` (e.g. `chromium-cdp-9222`)."),
   action: external_exports.enum(["list", "select", "new", "close"]).describe(
     "list: enumerate tabs/windows. select: make a tab active (every other tool then acts on it). new: open a tab. close: close a tab."
@@ -141588,7 +141712,7 @@ var zodSchema67 = external_exports.object({
   url: external_exports.string().optional().describe("`new` only: URL to open (defaults to about:blank)."),
   label: external_exports.string().optional().describe("`new` only: a memorable label usable interchangeably with the tabId.")
 });
-var capability25 = {
+var capability26 = {
   chromium: { app: true }
 };
 var chromiumTabsTool = {
@@ -141601,8 +141725,8 @@ var chromiumTabsTool = {
 Use when an app exposes multiple windows or tabs and you need to inspect or drive one other than the current page, or to open/close a page during a flow. tabIds are stable for the session and never reused.
 Returns { tabs: [{ tabId, targetId, title, url, active, label? }] }. Fails if the device is not a Chromium (CDP) device, or the requested tabId/label no longer matches a live tab. Chromium-only.`,
   searchHint: "tab tabs window windows switch select close new open multi-tab chromium electron",
-  zodSchema: zodSchema67,
-  capability: capability25,
+  zodSchema: zodSchema68,
+  capability: capability26,
   services: (params) => {
     const device = resolveDevice(params.udid);
     if (device.platform === "chromium") {
@@ -141702,7 +141826,7 @@ async function clearStorage(cdp, type) {
 }
 
 // ../tool-server/src/tools/chromium-cookies/index.ts
-var zodSchema68 = external_exports.object({
+var zodSchema69 = external_exports.object({
   udid: external_exports.string().describe("Chromium device id from `list-devices` (e.g. `chromium-cdp-9222`)."),
   action: external_exports.enum(["get", "set", "delete", "clear"]).describe(
     "get: read cookies. set: create/update a cookie. delete: remove a named cookie. clear: remove all browser cookies."
@@ -141719,7 +141843,7 @@ var zodSchema68 = external_exports.object({
   sameSite: external_exports.enum(["Strict", "Lax", "None"]).optional().describe("set: SameSite policy."),
   expires: external_exports.number().optional().describe("set: expiry as a Unix timestamp (seconds). Omit for a session cookie.")
 });
-var capability26 = {
+var capability27 = {
   chromium: { app: true }
 };
 var chromiumCookiesTool = {
@@ -141732,8 +141856,8 @@ var chromiumCookiesTool = {
 Use when seeding an authenticated session before a flow (set the session cookie, then navigate) or asserting cookie state after one.
 Returns { cookies, count } for get, or a small status object ({ set } / { deleted } / { cleared }) otherwise. Fails if the device is not a Chromium (CDP) device, or set is missing name/value. Chromium-only.`,
   searchHint: "cookies cookie get set delete clear httponly samesite session auth chromium",
-  zodSchema: zodSchema68,
-  capability: capability26,
+  zodSchema: zodSchema69,
+  capability: capability27,
   services: (params) => {
     const device = resolveDevice(params.udid);
     if (device.platform === "chromium") {
@@ -141797,7 +141921,7 @@ Returns { cookies, count } for get, or a small status object ({ set } / { delete
 // ../tool-server/src/tools/chromium-storage/index.ts
 init_zod();
 init_src();
-var zodSchema69 = external_exports.object({
+var zodSchema70 = external_exports.object({
   udid: external_exports.string().describe("Chromium device id from `list-devices` (e.g. `chromium-cdp-9222`)."),
   store: external_exports.enum(["local", "session"]).describe("Which Web Storage area: `local` (localStorage) or `session` (sessionStorage)."),
   action: external_exports.enum(["get", "set", "remove", "clear"]).describe(
@@ -141806,7 +141930,7 @@ var zodSchema69 = external_exports.object({
   key: external_exports.string().optional().describe("get (optional) / set / remove: the storage key."),
   value: external_exports.string().optional().describe("set: the value to store.")
 });
-var capability27 = {
+var capability28 = {
   chromium: { app: true }
 };
 var chromiumStorageTool = {
@@ -141820,8 +141944,8 @@ Set \`store\` to "local" or "session". Storage is per-origin, so it reflects the
 Use when seeding feature flags / auth tokens before a flow or asserting persisted app state after one.
 Returns { value } for a single key, { entries, count } for all, or a status object ({ set } / { removed } / { cleared }) otherwise. Fails if the device is not a Chromium (CDP) device, or set is missing key/value. Chromium-only.`,
   searchHint: "storage localstorage sessionstorage local session get set remove clear key value chromium",
-  zodSchema: zodSchema69,
-  capability: capability27,
+  zodSchema: zodSchema70,
+  capability: capability28,
   services: (params) => {
     const device = resolveDevice(params.udid);
     if (device.platform === "chromium") {
@@ -141919,6 +142043,7 @@ function createRegistry() {
   registry2.registerTool(networkRequestTool);
   registry2.registerTool(createDescribeTool(registry2));
   registry2.registerTool(createAwaitUiElementTool(registry2));
+  registry2.registerTool(createAwaitScreenIdleTool(registry2));
   registry2.registerTool(createReactProfilerStartTool(registry2));
   registry2.registerTool(createReactProfilerStopTool(registry2));
   registry2.registerTool(createReactProfilerStatusTool(registry2));

package/package.json

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