@swmansion/argent 0.28.1-next.10 → 0.28.1-next.11

package/dist/cli-cmds.mjs

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

package/dist/client.d.ts

@@ -81,6 +81,15 @@ export interface UiTree {
      */
     unsupportedFields: string[];
 }
+/** The `foreground-app` result: which app is in front, as `UiTree.foregroundApp` reports it. */
+export interface ForegroundApp {
+    /** iOS bundle id or Android package of the app in front; under a system alert, the app it covers. Unset when unknown. */
+    bundleId?: string;
+    /** iOS: the app's display name. */
+    name?: string;
+    /** A system alert or dialog covers the app. Unset when unknown. */
+    alertVisible?: boolean;
+}
 export interface CallToolOptions {
     /** Receive progress events while a long-running tool works. */
     onProgress?: (event: unknown) => void;

package/dist/installer.mjs

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

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

@@ -268,6 +268,10 @@ export interface ArgentToolArgs {
         /** The hinge angle in degrees, 0 (closed) to 180 (open). Exactly one of `posture` and `angle`. */
         angle?: number;
     };
+    "foreground-app": {
+        /** Target device id from `list-devices`. */
+        udid: string;
+    };
     "gather-workspace-data": {
         /** Absolute path to the project root directory to inspect (e.g. /Users/dev/MyApp) */
         workspacePath: string;

package/dist/tool-server.cjs

@@ -13223,8 +13223,8 @@ function finalize(ctx, schema) {
   const root = ctx.seen.get(schema);
   if (!root)
     throw new Error("Unprocessed schema. This is a bug in Zod.");
-  const flattenRef = (zodSchema80) => {
-    const seen = ctx.seen.get(zodSchema80);
+  const flattenRef = (zodSchema81) => {
+    const seen = ctx.seen.get(zodSchema81);
     if (seen.ref === null)
       return;
     const schema2 = seen.def ?? seen.schema;
@@ -13242,7 +13242,7 @@ function finalize(ctx, schema) {
         Object.assign(schema2, refSchema);
       }
       Object.assign(schema2, _cached);
-      const isParentRef = zodSchema80._zod.parent === ref;
+      const isParentRef = zodSchema81._zod.parent === ref;
       if (isParentRef) {
         for (const key2 in schema2) {
           if (key2 === "$ref" || key2 === "allOf")
@@ -13262,7 +13262,7 @@ function finalize(ctx, schema) {
         }
       }
     }
-    const parent = zodSchema80._zod.parent;
+    const parent = zodSchema81._zod.parent;
     if (parent && parent !== ref) {
       flattenRef(parent);
       const parentSeen = ctx.seen.get(parent);
@@ -13280,7 +13280,7 @@ function finalize(ctx, schema) {
       }
     }
     ctx.override({
-      zodSchema: zodSchema80,
+      zodSchema: zodSchema81,
       jsonSchema: schema2,
       path: seen.path ?? []
     });
@@ -16081,10 +16081,10 @@ function convertBaseSchema(schema, ctx) {
     }
     ctx.processing.add(refPath);
     const resolved = resolveRef(refPath, ctx);
-    const zodSchema81 = convertSchema(resolved, ctx);
-    ctx.refs.set(refPath, zodSchema81);
+    const zodSchema82 = convertSchema(resolved, ctx);
+    ctx.refs.set(refPath, zodSchema82);
     ctx.processing.delete(refPath);
-    return zodSchema81;
+    return zodSchema82;
   }
   if (schema.enum !== void 0) {
     const enumValues = schema.enum;
@@ -16126,7 +16126,7 @@ function convertBaseSchema(schema, ctx) {
   if (!type) {
     return z.any();
   }
-  let zodSchema80;
+  let zodSchema81;
   switch (type) {
     case "string": {
       let stringSchema = z.string();
@@ -16189,7 +16189,7 @@ function convertBaseSchema(schema, ctx) {
       if (schema.pattern) {
         stringSchema = stringSchema.regex(new RegExp(schema.pattern));
       }
-      zodSchema80 = stringSchema;
+      zodSchema81 = stringSchema;
       break;
     }
     case "number":
@@ -16214,15 +16214,15 @@ function convertBaseSchema(schema, ctx) {
       if (typeof schema.multipleOf === "number") {
         numberSchema = numberSchema.multipleOf(schema.multipleOf);
       }
-      zodSchema80 = numberSchema;
+      zodSchema81 = numberSchema;
       break;
     }
     case "boolean": {
-      zodSchema80 = z.boolean();
+      zodSchema81 = z.boolean();
       break;
     }
     case "null": {
-      zodSchema80 = z.null();
+      zodSchema81 = z.null();
       break;
     }
     case "object": {
@@ -16237,12 +16237,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) {
-          zodSchema80 = z.record(keySchema, valueSchema);
+          zodSchema81 = z.record(keySchema, valueSchema);
           break;
         }
         const objectSchema2 = z.object(shape).passthrough();
         const recordSchema = z.looseRecord(keySchema, valueSchema);
-        zodSchema80 = z.intersection(objectSchema2, recordSchema);
+        zodSchema81 = z.intersection(objectSchema2, recordSchema);
         break;
       }
       if (schema.patternProperties) {
@@ -16260,25 +16260,25 @@ function convertBaseSchema(schema, ctx) {
         }
         schemasToIntersect.push(...looseRecords);
         if (schemasToIntersect.length === 0) {
-          zodSchema80 = z.object({}).passthrough();
+          zodSchema81 = z.object({}).passthrough();
         } else if (schemasToIntersect.length === 1) {
-          zodSchema80 = schemasToIntersect[0];
+          zodSchema81 = 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]);
           }
-          zodSchema80 = result;
+          zodSchema81 = result;
         }
         break;
       }
       const objectSchema = z.object(shape);
       if (schema.additionalProperties === false) {
-        zodSchema80 = objectSchema.strict();
+        zodSchema81 = objectSchema.strict();
       } else if (typeof schema.additionalProperties === "object") {
-        zodSchema80 = objectSchema.catchall(convertSchema(schema.additionalProperties, ctx));
+        zodSchema81 = objectSchema.catchall(convertSchema(schema.additionalProperties, ctx));
       } else {
-        zodSchema80 = objectSchema.passthrough();
+        zodSchema81 = objectSchema.passthrough();
       }
       break;
     }
@@ -16289,29 +16289,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) {
-          zodSchema80 = z.tuple(tupleItems).rest(rest);
+          zodSchema81 = z.tuple(tupleItems).rest(rest);
         } else {
-          zodSchema80 = z.tuple(tupleItems);
+          zodSchema81 = z.tuple(tupleItems);
         }
         if (typeof schema.minItems === "number") {
-          zodSchema80 = zodSchema80.check(z.minLength(schema.minItems));
+          zodSchema81 = zodSchema81.check(z.minLength(schema.minItems));
         }
         if (typeof schema.maxItems === "number") {
-          zodSchema80 = zodSchema80.check(z.maxLength(schema.maxItems));
+          zodSchema81 = zodSchema81.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) {
-          zodSchema80 = z.tuple(tupleItems).rest(rest);
+          zodSchema81 = z.tuple(tupleItems).rest(rest);
         } else {
-          zodSchema80 = z.tuple(tupleItems);
+          zodSchema81 = z.tuple(tupleItems);
         }
         if (typeof schema.minItems === "number") {
-          zodSchema80 = zodSchema80.check(z.minLength(schema.minItems));
+          zodSchema81 = zodSchema81.check(z.minLength(schema.minItems));
         }
         if (typeof schema.maxItems === "number") {
-          zodSchema80 = zodSchema80.check(z.maxLength(schema.maxItems));
+          zodSchema81 = zodSchema81.check(z.maxLength(schema.maxItems));
         }
       } else if (items !== void 0) {
         const element = convertSchema(items, ctx);
@@ -16322,16 +16322,16 @@ function convertBaseSchema(schema, ctx) {
         if (typeof schema.maxItems === "number") {
           arraySchema = arraySchema.max(schema.maxItems);
         }
-        zodSchema80 = arraySchema;
+        zodSchema81 = arraySchema;
       } else {
-        zodSchema80 = z.array(z.any());
+        zodSchema81 = z.array(z.any());
       }
       break;
     }
     default:
       throw new Error(`Unsupported type: ${type}`);
   }
-  return zodSchema80;
+  return zodSchema81;
 }
 function convertSchema(schema, ctx) {
   if (typeof schema === "boolean") {
@@ -73655,16 +73655,16 @@ function lookupExternalDeviceNow(id) {
   }
   return device;
 }
-async function assertExternalCapability(namespace, device, capability37) {
-  assertExternalCapabilitySync(namespace, device, capability37);
+async function assertExternalCapability(namespace, device, capability38) {
+  assertExternalCapabilitySync(namespace, device, capability38);
 }
-function assertExternalCapabilitySync(namespace, device, capability37) {
+function assertExternalCapabilitySync(namespace, device, capability38) {
   const id = typeof device === "string" ? device : device.id;
   const externalDevice = isExternalId(id) ? lookupExternalDeviceNow(id) : externalClaimForNativeId(id);
   if (!externalDevice) return;
-  if (externalDevice.capabilities.has(capability37)) return;
+  if (externalDevice.capabilities.has(capability38)) return;
   throw new FailureError(
-    `${namespace} is not available on '${externalDevice.name}': ${externalDevice.provider.name} did not grant the '${capability37}' capability for this device.`,
+    `${namespace} is not available on '${externalDevice.name}': ${externalDevice.provider.name} did not grant the '${capability38}' capability for this device.`,
     {
       error_code: FAILURE_CODES.EXTERNAL_DEVICE_CAPABILITY_DENIED,
       error_kind: "unsupported",
@@ -94920,7 +94920,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID = (0, import_node_crypto3.randomUUID)();
 function readCliVersion() {
   if (true) {
-    return "0.28.1-next.10";
+    return "0.28.1-next.11";
   }
   return "0.0.0";
 }
@@ -96694,8 +96694,8 @@ async function simctlArgsForUdid(udid, args, options) {
   return [...simctlPrefix(await deviceSetForUdid(udid)), ...nativeArgs(udid, args)];
 }
 function assertSimctlEntitlement(udid, options) {
-  const capability37 = options?.granted ?? "simctl";
-  assertExternalCapabilitySync(capability37, udid, capability37);
+  const capability38 = options?.granted ?? "simctl";
+  assertExternalCapabilitySync(capability38, udid, capability38);
 }
 async function simctlTargetForUdid(udid, options) {
   assertSimctlEntitlement(udid, options);
@@ -97760,6 +97760,9 @@ var axServiceBlueprint = {
           treeVersion: result.treeVersion
         };
       },
+      async foregroundApp() {
+        return await query("foreground_app");
+      },
       async livePanel() {
         const result = await query("live_panel", LIVE_PANEL_TIMEOUT_MS);
         if (result.error) {
@@ -97869,23 +97872,23 @@ var InvalidToolInputError = class extends Error {
     });
   }
 };
-function platformMatrix(platform, capability37) {
+function platformMatrix(platform, capability38) {
   switch (platform) {
     case "ios":
-      return capability37.apple;
+      return capability38.apple;
     case "ios-remote":
-      return capability37.appleRemote;
+      return capability38.appleRemote;
     case "android":
-      return capability37.android;
+      return capability38.android;
     case "chromium":
-      return capability37.chromium;
+      return capability38.chromium;
     case "vega":
-      return capability37.vega;
+      return capability38.vega;
   }
 }
-function assertSupported(toolId, capability37, device) {
-  if (!capability37) return;
-  const matrix = platformMatrix(device.platform, capability37);
+function assertSupported(toolId, capability38, device) {
+  if (!capability38) return;
+  const matrix = platformMatrix(device.platform, capability38);
   if (!matrix) {
     throw new UnsupportedOperationError(toolId, device, `no ${device.platform} support declared`);
   }
@@ -97893,7 +97896,7 @@ function assertSupported(toolId, capability37, device) {
   if (!supported) {
     throw new UnsupportedOperationError(toolId, device, `kind '${device.kind}' not supported`);
   }
-  if (capability37.supports && !capability37.supports(device)) {
+  if (capability38.supports && !capability38.supports(device)) {
     throw new UnsupportedOperationError(toolId, device, "supports() refiner rejected device");
   }
 }
@@ -127262,9 +127265,9 @@ async function invokeSubTool(registry2, ctx, toolId, args, extra) {
 }
 function describeNestedParamError(registry2, err, toolId, dispatchedArgs, authoredArgs) {
   if (getFailureSignal(err)?.error_code !== FAILURE_CODES.TOOL_INPUT_INVALID) return void 0;
-  const zodSchema80 = registry2.getTool(toolId)?.zodSchema;
-  if (!zodSchema80) return void 0;
-  const parsed = zodSchema80.safeParse(dispatchedArgs ?? {});
+  const zodSchema81 = registry2.getTool(toolId)?.zodSchema;
+  if (!zodSchema81) return void 0;
+  const parsed = zodSchema81.safeParse(dispatchedArgs ?? {});
   if (parsed.success) return void 0;
   return `Invalid params for tool "${toolId}": ${describeParamIssues(parsed.error, authoredArgs)}`;
 }
@@ -137042,6 +137045,73 @@ Fails if the iOS ax-service predates the tree command; update argent.`,
   };
 }
 
+// ../tool-server/src/tools/foreground-app/index.ts
+init_zod();
+var zodSchema42 = external_exports.object({
+  udid: external_exports.string().min(1).describe("Target device id from `list-devices`.")
+});
+var capability27 = {
+  apple: { simulator: true },
+  appleRemote: { simulator: true },
+  android: { emulator: true, device: true, unknown: true }
+};
+async function readIosForegroundApp(registry2, device) {
+  const ref = axServiceRef(device);
+  const ax = await registry2.resolveService(ref.urn, ref.options);
+  const { bundleId, name, alertVisible } = await ax.foregroundApp();
+  return { bundleId, name, alertVisible };
+}
+async function readAndroidForegroundApp(registry2, device) {
+  const ref = androidDevtoolsRef(device);
+  const devtools = await registry2.resolveService(ref.urn, ref.options);
+  const [capture, size] = await Promise.all([
+    // The default settle, as ui-tree: free on a settled screen, and it keeps a
+    // mid-transition window list (right after home or a launch) from naming the old app.
+    devtools.getHierarchy({ maxDepth: 0, clearCache: true }),
+    devtools.getScreenSize()
+  ]);
+  const tree = adaptAndroidTree({ ...capture, truncated: false }, size);
+  return { bundleId: tree.foregroundApp, alertVisible: tree.alertVisible };
+}
+function createForegroundAppTool(registry2) {
+  return {
+    id: "foreground-app",
+    interaction: {
+      startedMsg: () => "Reading foreground app",
+      completedMsg: () => "Read foreground app",
+      failedMsg: ({ failureSignal: failureSignal2 }) => `Failed to read foreground app: ${failureSignal2.error_code}`
+    },
+    description: `Read which app is in front, for SDK callers.
+Returns { bundleId, name, alertVisible }; under a system alert, bundleId is the app it covers.
+A field is unset when it is unknown.`,
+    hideFromMcp: true,
+    zodSchema: zodSchema42,
+    capability: capability27,
+    services: () => ({}),
+    execute: dispatchByPlatform({
+      toolId: "foreground-app",
+      capability: capability27,
+      ios: {
+        requires: iosRequires,
+        handler: async (_services, _params, device) => {
+          if (await isTvOsSimulator(device.id)) {
+            throw new UnsupportedOperationError("foreground-app", device, "tvOS");
+          }
+          return readIosForegroundApp(registry2, device);
+        }
+      },
+      iosRemote: {
+        requires: ["sim-remote"],
+        handler: async (_services, _params, device) => readIosForegroundApp(registry2, device)
+      },
+      android: {
+        requires: androidRequires,
+        handler: async (_services, _params, device) => readAndroidForegroundApp(registry2, device)
+      }
+    })
+  };
+}
+
 // ../tool-server/src/tools/await-screen-idle/index.ts
 init_zod();
 init_device_info();
@@ -137050,7 +137120,7 @@ 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 zodSchema42 = external_exports.object({
+var zodSchema43 = 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}).`
@@ -137060,7 +137130,7 @@ var zodSchema42 = external_exports.object({
     `The screen must hold the same content for at least this long to count as settled (default ${DEFAULT_MIN_STABLE_MS}).`
   )
 }).strict();
-var capability27 = {
+var capability28 = {
   apple: { simulator: true, device: true },
   appleRemote: { simulator: true },
   android: { emulator: true, device: true, unknown: true },
@@ -137107,8 +137177,8 @@ ${DEFAULT_TIMEOUT_MS4}ms) is reached. Returns { settled, waitedMs, polls } \u201
 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: zodSchema42,
-    capability: capability27,
+    zodSchema: zodSchema43,
+    capability: capability28,
     services: (params) => {
       const device = resolveDevice(params.udid);
       if (device.platform === "chromium") {
@@ -137118,7 +137188,7 @@ still before the timeout. Use after a launch/navigation to wait for the UI to re
     },
     async execute(services, params, ctx) {
       const device = resolveDevice(params.udid);
-      assertSupported(AWAIT_SCREEN_IDLE_TOOL_ID, capability27, device);
+      assertSupported(AWAIT_SCREEN_IDLE_TOOL_ID, capability28, device);
       if (device.platform === "ios") await ensureDeps(iosRequires);
       else if (device.platform === "ios-remote") await ensureDeps(["sim-remote"]);
       else if (device.platform === "android") await ensureDeps(androidRequires);
@@ -137205,7 +137275,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 zodSchema43 = external_exports.object({
+var zodSchema44 = external_exports.object({
   port: metroPortField,
   device_id: external_exports.string().describe(
     "Device id from list-devices \u2014 the SAME id you passed to debugger-connect (iOS simulator UDID or Android serial)."
@@ -137237,7 +137307,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: zodSchema43,
+    zodSchema: zodSchema44,
     capability: RN_ONLY_TOOL_CAPABILITY,
     services: () => ({}),
     async execute(_services, params) {
@@ -137508,7 +137578,7 @@ async function readCommitTree(path53) {
 }
 
 // ../tool-server/src/tools/profiler/react/react-profiler-stop.ts
-var zodSchema44 = external_exports.object({
+var zodSchema45 = external_exports.object({
   port: metroPortField,
   device_id: external_exports.string().describe(
     "Device id from list-devices \u2014 the SAME id you passed to debugger-connect (iOS simulator UDID or Android serial)."
@@ -137597,7 +137667,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: zodSchema44,
+    zodSchema: zodSchema45,
     capability: RN_ONLY_TOOL_CAPABILITY,
     services: () => ({}),
     async execute(_services, params) {
@@ -137822,7 +137892,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 zodSchema45 = external_exports.object({
+var zodSchema46 = external_exports.object({
   port: metroPortField,
   device_id: external_exports.string().describe(
     "Device logicalDeviceId from debugger-connect (iOS simulator UDID or Android logicalDeviceId)."
@@ -137837,7 +137907,7 @@ function createReactProfilerStatusTool(registry2) {
       failedMsg: ({ failureSignal: failureSignal2 }) => `Failed to check React profiler: ${failureSignal2.error_code}`
     },
     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: zodSchema45,
+    zodSchema: zodSchema46,
     // RN-only: companion to react-profiler-start.
     capability: RN_ONLY_TOOL_CAPABILITY,
     services: () => ({}),
@@ -139451,7 +139521,7 @@ var annotationSchema = external_exports.object({
   ),
   label: external_exports.string().describe("Description of the action performed")
 });
-var zodSchema46 = external_exports.object({
+var zodSchema47 = external_exports.object({
   port: metroPortField,
   device_id: external_exports.string().describe(
     "Device logicalDeviceId from debugger-connect (iOS simulator UDID or Android logicalDeviceId)."
@@ -139484,7 +139554,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: zodSchema46,
+  zodSchema: zodSchema47,
   // RN-only: reads commit data captured via the React DevTools backend, which
   // Chromium does not have.
   capability: RN_ONLY_TOOL_CAPABILITY,
@@ -139621,7 +139691,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 zodSchema47 = external_exports.object({
+var zodSchema48 = 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")
 });
@@ -139639,7 +139709,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: zodSchema47,
+  zodSchema: zodSchema48,
   // Declared so the tool catalogue groups this with the other react-profiler-*
   // tools; the HTTP gate itself is a no-op here, as there is no device arg to
   // inspect.
@@ -139695,7 +139765,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_src2();
-var zodSchema48 = external_exports.object({
+var zodSchema49 = external_exports.object({
   port: metroPortField,
   device_id: external_exports.string().describe(
     "Device logicalDeviceId from debugger-connect (iOS simulator UDID or Android logicalDeviceId)."
@@ -139777,7 +139847,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: zodSchema48,
+  zodSchema: zodSchema49,
   // RN-only: reads a Hermes CPU profile; Chromium's V8 sample format differs.
   capability: RN_ONLY_TOOL_CAPABILITY,
   services: () => ({}),
@@ -139873,7 +139943,7 @@ function renderMarkdownTable2(entries) {
   );
   return [header, sep5, ...rows].join("\n");
 }
-var zodSchema49 = external_exports.object({
+var zodSchema50 = external_exports.object({
   port: metroPortField,
   device_id: external_exports.string().describe(
     "Device logicalDeviceId from debugger-connect (iOS simulator UDID or Android logicalDeviceId)."
@@ -139891,7 +139961,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: zodSchema49,
+  zodSchema: zodSchema50,
   // RN-only: queries the React DevTools backend hook on the live runtime.
   capability: RN_ONLY_TOOL_CAPABILITY,
   services: (params) => ({
@@ -140048,7 +140118,7 @@ function buildFiberTreeScript(maxDepth, filter) {
   }
 })()`;
 }
-var zodSchema50 = external_exports.object({
+var zodSchema51 = external_exports.object({
   port: metroPortField,
   device_id: external_exports.string().describe(
     "Device logicalDeviceId from debugger-connect (iOS simulator UDID or Android logicalDeviceId)."
@@ -140067,7 +140137,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: zodSchema50,
+  zodSchema: zodSchema51,
   // RN-only: walks the fiber tree via the React DevTools backend hook.
   capability: RN_ONLY_TOOL_CAPABILITY,
   services: (params) => ({
@@ -143865,7 +143935,7 @@ function metroDeviceIdParam(description) {
 }
 
 // ../tool-server/src/tools/profiler/native-profiler/native-profiler-start.ts
-var zodSchema51 = external_exports.object({
+var zodSchema52 = external_exports.object({
   device_id: metroDeviceIdParam(
     "Target device id from `list-devices` (iOS UDID or Android serial)."
   ),
@@ -143879,7 +143949,7 @@ var zodSchema51 = external_exports.object({
     "iOS-only. When true, cold-launches the app under the profiler with Malloc Stack Logging enabled so memory leaks carry an allocation backtrace (responsible frame + library). Without it, leaks are still detected but unattributable \u2014 Instruments reports '<Call stack limit reached>'. Trade-offs: this RESTARTS the app (current state is lost), adds memory/CPU overhead, and makes the app noticeably slow to launch (every startup allocation records a backtrace), so leave it off for pure CPU/hang profiling. Requires a non-degraded Xcode: on Xcode 26.4 and later the cold-launch path is broken, so the call is rejected up front (re-run without the flag, or set ARGENT_IOS_CAPTURE=device to override if the device path works on your host). ARGENT_IOS_CAPTURE=all-processes \u2014 e.g. exported globally for the normal capture path \u2014 also rejects this flag up front, since that fallback cannot cold-launch; unset it (or set it to device) first. Ignored on Android."
   )
 });
-var capability28 = {
+var capability29 = {
   apple: { simulator: true },
   android: { emulator: true, device: true, unknown: true }
 };
@@ -143890,21 +143960,21 @@ var nativeProfilerStartTool = {
     completedMsg: () => "Started native profiler",
     failedMsg: ({ failureSignal: failureSignal2 }) => `Failed to start native profiler: ${failureSignal2.error_code}`
   },
-  capability: capability28,
+  capability: capability29,
   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: zodSchema51,
+  zodSchema: zodSchema52,
   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", capability28, device);
+    assertSupported("native-profiler-start", capability29, device);
     if (api.platform === "ios") {
       await ensureDeps(["xcrun"]);
       return startNativeProfilerIos(api, params);
@@ -143917,12 +143987,12 @@ 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();
 init_device_info();
-var zodSchema52 = external_exports.object({
+var zodSchema53 = external_exports.object({
   device_id: metroDeviceIdParam(
     "Target device id from `list-devices` (iOS UDID or Android serial)."
   )
 });
-var capability29 = {
+var capability30 = {
   apple: { simulator: true },
   android: { emulator: true, device: true, unknown: true }
 };
@@ -143950,7 +144020,7 @@ var nativeProfilerStopTool = {
     completedMsg: ({ result }) => `Saved native profile ${result.traceFile.filename}`,
     failedMsg: ({ failureSignal: failureSignal2 }) => `Failed to stop native profiler: ${failureSignal2.error_code}`
   },
-  capability: capability29,
+  capability: capability30,
   // Packaging plus the export passes routinely exceed the 30s MCP fetch timeout.
   longRunning: true,
   description: `Stop native profiling and export trace data.
@@ -143960,14 +144030,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: zodSchema52,
+  zodSchema: zodSchema53,
   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", capability29, device);
+    assertSupported("native-profiler-stop", capability30, device);
     if (api.platform === "ios") {
       await ensureDeps(["xcrun"]);
       const ios = await stopNativeProfilerIos(api);
@@ -143995,12 +144065,12 @@ 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();
 init_device_info();
-var zodSchema53 = external_exports.object({
+var zodSchema54 = external_exports.object({
   device_id: metroDeviceIdParam(
     "Target device id from `list-devices` (iOS UDID or Android serial)."
   )
 });
-var capability30 = {
+var capability31 = {
   apple: { simulator: true },
   android: { emulator: true, device: true, unknown: true }
 };
@@ -144011,7 +144081,7 @@ var nativeProfilerAnalyzeTool = {
     completedMsg: () => "Analyzed native profile",
     failedMsg: ({ failureSignal: failureSignal2 }) => `Failed to analyze native profile: ${failureSignal2.error_code}`
   },
-  capability: capability30,
+  capability: capability31,
   // Parsing a trace from a recording up to RECORDING_CAP_MS long routinely exceeds
   // the 30s MCP fetch timeout, and an aborted call is replayed, not cancelled.
   longRunning: true,
@@ -144024,14 +144094,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: zodSchema53,
+  zodSchema: zodSchema54,
   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", capability30, device);
+    assertSupported("native-profiler-analyze", capability31, device);
     let result;
     if (api.platform === "ios") {
       await ensureDeps(["xcrun"]);
@@ -145094,7 +145164,7 @@ var DEFAULT_TIME_LIMIT_SECONDS = 180;
 var MAX_TIME_LIMIT_SECONDS = 600;
 var POINTER_TRAIL_LENGTH = 8;
 var POINTER_REQUEST_TIMEOUT_MS = 2e3;
-var zodSchema54 = external_exports.object({
+var zodSchema55 = external_exports.object({
   udid: external_exports.string().describe("Target device id from `list-devices` (iOS Simulator UDID or Android serial)."),
   timeLimitSeconds: external_exports.number().int().min(1).max(MAX_TIME_LIMIT_SECONDS).optional().describe(
     `Auto-stop cap in seconds (default ${DEFAULT_TIME_LIMIT_SECONDS}, max ${MAX_TIME_LIMIT_SECONDS}). Set it to slightly more than the interaction you plan to capture.`
@@ -145106,7 +145176,7 @@ var zodSchema54 = external_exports.object({
     "Default true. Draw simulator-server's touch visualizer into the recording: a pulse marks each tap, a comet trail follows swipes and drags, and paired markers show two-finger pinch/rotate, so the video makes clear where every interaction landed. Set false to record the raw screen with no overlay."
   )
 });
-var capability31 = {
+var capability32 = {
   apple: { simulator: true },
   android: { emulator: true, device: true, unknown: true }
 };
@@ -145118,7 +145188,7 @@ function createScreenRecordingStartTool(registry2) {
       completedMsg: () => "Started screen recording",
       failedMsg: ({ failureSignal: failureSignal2 }) => `Failed to start screen recording: ${failureSignal2.error_code}`
     },
-    capability: capability31,
+    capability: capability32,
     description: `Start recording the device screen to a video file (h264 mp4, 30fps at the device's native resolution).
 By default stretches where the screen does not change are trimmed out (see trimStatic), so a long session with only brief activity comes back as a short clip instead of minutes of dead air.
 By default every tap, swipe, drag, pinch and rotate is drawn into the video as an on-screen touch marker (see showTouches), so the recording shows where each interaction landed.
@@ -145127,7 +145197,7 @@ Use when the user wants a video of an interaction, animation, or app behavior \u
 Returns { status: "recording", timeLimitSeconds, outputFile } \u2014 the video is retrieved later by \`screen-recording-stop\`, not by reading outputFile directly.
 Fails if a recording is already running on the device, the device is not booted, ffmpeg is not installed, or the platform cannot be recorded (tvOS, Chromium, Vega and remote simulators are unsupported).`,
     searchHint: "record video screen capture movie mp4 start filming screencast",
-    zodSchema: zodSchema54,
+    zodSchema: zodSchema55,
     // Resolved inside execute, not declared eagerly: a tvOS udid classifies as
     // iOS by shape, so an eager service would spawn simulator-server for a
     // device it cannot drive and hang on its ready timeout (as in `screenshot`).
@@ -145137,7 +145207,7 @@ Fails if a recording is already running on the device, the device is not booted,
     async execute(services, params) {
       const api = services.session;
       const device = resolveDevice(params.udid);
-      assertSupported("screen-recording-start", capability31, device);
+      assertSupported("screen-recording-start", capability32, device);
       if (device.platform === "ios" && await isTvOsSimulator(params.udid)) {
         throw new FailureError(
           `Screen recording is not supported on tvOS simulators (device ${params.udid}).`,
@@ -145226,11 +145296,11 @@ function makePointerControl(simulator) {
 var import_node_path22 = require("node:path");
 init_zod();
 init_device_info();
-var zodSchema55 = external_exports.object({
+var zodSchema56 = external_exports.object({
   udid: external_exports.string().describe("Target device id from `list-devices` (iOS Simulator UDID or Android serial).")
 });
 var RECORDINGS_DIR = ".argent/recordings";
-var capability32 = {
+var capability33 = {
   apple: { simulator: true },
   android: { emulator: true, device: true, unknown: true }
 };
@@ -145241,21 +145311,21 @@ var screenRecordingStopTool = {
     completedMsg: ({ result }) => `Saved screen recording ${result.video.filename}`,
     failedMsg: ({ failureSignal: failureSignal2 }) => `Failed to stop screen recording: ${failureSignal2.error_code}`
   },
-  capability: capability32,
+  capability: capability33,
   description: `Stop the screen recording started by \`screen-recording-start\` and retrieve the video: frame capture ends and ffmpeg finalizes the mp4.
 Also retrieves the video when the recording already ended on its own (time limit reached, capture process died) \u2014 call it even after the cap fired.
 Use when the interaction being captured is finished, or a tool-result note reminds you a recording is still running.
 Returns { video, durationMs, wallClockMs?, trimmedMs?, panelSwitches?, warning? }; video is a downloadable artifact materialized to a local path. When static-frame trimming removed dead air, durationMs is the trimmed video length and wallClockMs/trimmedMs report the real duration and how much was cut. On a foldable simulator, the recording follows the panel that shows the UI. panelSwitches gives the number of panel changes. The video keeps the size of the first panel. warning is set when argent could not find that panel during the recording.
 Fails if no recording (running or finished-but-unretrieved) exists for the given udid.`,
   searchHint: "stop end finish screen recording video capture save retrieve",
-  zodSchema: zodSchema55,
+  zodSchema: zodSchema56,
   services: (params) => ({
     session: screenRecordingSessionRef(resolveDevice(params.udid))
   }),
   async execute(services, params, ctx) {
     const api = services.session;
     const device = resolveDevice(params.udid);
-    assertSupported("screen-recording-stop", capability32, device);
+    assertSupported("screen-recording-stop", capability33, device);
     const stopped = await stopCapture(api);
     const artifacts = requireArtifacts(ctx);
     const video = await artifacts.register({
@@ -145287,7 +145357,7 @@ var timeWindowSchema = external_exports.object({
     "End of window in ms since profiling started \u2014 the same clock profiler-commit-query prints"
   )
 });
-var zodSchema56 = external_exports.object({
+var zodSchema57 = external_exports.object({
   port: metroPortField,
   device_id: metroDeviceIdParam(
     "Device logicalDeviceId from debugger-connect (iOS simulator UDID or Android logicalDeviceId)."
@@ -145576,7 +145646,7 @@ Every table states how many samples it covers and how much of that was idle.
 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: zodSchema56,
+  zodSchema: zodSchema57,
   // RN-only: reads Hermes-format CPU profiles; Chromium's V8 sample format differs.
   capability: RN_ONLY_TOOL_CAPABILITY,
   services: () => ({}),
@@ -145662,7 +145732,7 @@ var timeRangeSchema = external_exports.object({
     "End of range in ms since profiling started \u2014 the same clock profiler-commit-query prints"
   )
 });
-var zodSchema57 = external_exports.object({
+var zodSchema58 = external_exports.object({
   port: metroPortField,
   device_id: metroDeviceIdParam(
     "Device logicalDeviceId from debugger-connect (iOS simulator UDID or Android logicalDeviceId)."
@@ -145935,7 +146005,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: zodSchema57,
+  zodSchema: zodSchema58,
   // Reads React commit data captured via the React DevTools backend.
   capability: RN_ONLY_TOOL_CAPABILITY,
   services: () => ({}),
@@ -146006,7 +146076,7 @@ Fails if react-profiler-stop has not been called or no commit data is stored.`,
 init_zod();
 init_src2();
 init_device_info();
-var zodSchema58 = external_exports.object({
+var zodSchema59 = external_exports.object({
   device_id: metroDeviceIdParam("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)"
@@ -146324,7 +146394,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: zodSchema58,
+  zodSchema: zodSchema59,
   // No chromium entry: it has no native trace capture.
   capability: {
     apple: { simulator: true },
@@ -146394,7 +146464,7 @@ function buildPerfettoAnchor(wallClockStartMs) {
 }
 
 // ../tool-server/src/tools/profiler/combined/profiler-combined-report.ts
-var zodSchema59 = external_exports.object({
+var zodSchema60 = external_exports.object({
   port: metroPortField,
   device_id: metroDeviceIdParam("iOS Simulator/device UDID or Android serial")
 });
@@ -146411,7 +146481,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: zodSchema59,
+  zodSchema: zodSchema60,
   // iOS reads xctrace output; Android re-queries the Perfetto .pftrace via
   // loadAndroidCombinedData. Chromium has no native trace capture.
   capability: {
@@ -146735,7 +146805,7 @@ function assertSafeSessionId(sessionId) {
     );
   }
 }
-var zodSchema60 = external_exports.object({
+var zodSchema61 = 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."
   ),
@@ -147096,7 +147166,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: zodSchema60,
+  zodSchema: zodSchema61,
   // The Hermes, xctrace and perfetto formats this loads have no Chromium
   // equivalent; the gate fails at the call site, not inside the trace parser.
   capability: RN_ONLY_TOOL_CAPABILITY,
@@ -147225,7 +147295,7 @@ function unnameableSessionUrns(urns) {
 }
 
 // ../tool-server/src/tools/simulator/stop-simulator-server.ts
-var zodSchema61 = external_exports.object({
+var zodSchema62 = external_exports.object({
   udid: external_exports.string().describe(
     "Target device id (iOS UDID, Android serial, or Chromium id) whose transport session to stop"
   )
@@ -147239,7 +147309,7 @@ function createStopSimulatorServerTool(registry2) {
       failedMsg: ({ params, failureSignal: failureSignal2 }) => `Failed to stop simulator server for ${params.udid}: ${failureSignal2.error_code}`
     },
     description: `Stop the transport session for a specific device (iOS simulator / Android: simulator-server process; physical iOS: the on-device runner; Chromium: CDP WebSocket) and free its resources; on a TV target it also reaps that device's TV-control daemons. Use when you are done interacting with one device but want to keep others running, or to restart a wedged transport. On iOS / Android / TV it deliberately leaves this device's native-devtools, accessibility, profiler and debugger services running - to drain those as well, use stop-all-simulator-servers with \`devices\`. On CHROMIUM that does not hold: the JS-runtime debugger declares the CDP session as a dependency, so stopping the transport cascades to it and its captured console history goes with it - reconnect with debugger-connect afterwards. Returns { stopped, udid }. Fails silently if no session is open for the given id.`,
-    zodSchema: zodSchema61,
+    zodSchema: zodSchema62,
     services: () => ({}),
     async execute(_services, params) {
       const udid = params.udid;
@@ -147270,7 +147340,7 @@ function createStopSimulatorServerTool(registry2) {
 init_zod();
 init_src2();
 init_external_devices();
-var zodSchema62 = external_exports.object({
+var zodSchema63 = external_exports.object({
   devices: external_exports.array(external_exports.string()).optional().describe(
     "Device ids (iOS UDID / Android serial / Chromium id) to scope the teardown to \u2014 pass the devices THIS session actually used. Omit only for a deliberate machine-wide cleanup: one tool-server serves every agent using this argent install, so an unscoped stop also kills devices another agent is mid-session on."
   )
@@ -147309,7 +147379,7 @@ function createStopAllSimulatorServersTool(registry2) {
 PASS \`devices\` with the device ids this session used \u2014 one tool-server serves every agent, subagent and CLI call using this argent install, and an unscoped call tears down THEIR devices too (a mid-recording devtools teardown degrades another agent's flow to brittle coordinate taps; that agent is warned, but its recorded steps are already the worse kind). Omit \`devices\` only when a machine-wide cleanup is what you actually want. Passing an EMPTY array scopes to nothing and stops nothing - it is not a way to ask for the machine-wide sweep.
 A JS-runtime debugger session is keyed by the id you called \`debugger-connect\` with. On a Metro serving two or more devices that id is not a udid or serial - connect refuses those and tells you to re-target with the \`logicalDeviceId\` it returns - so a scope built from \`list-devices\` ids cannot reach that session. Pass any such \`logicalDeviceId\` in \`devices\` ALONGSIDE the device id; { left_running } names the ones you missed.
 Returns { stopped } - the URNs of the services that were actually live and got shut down; an ERROR node is disposed too but never appears there, so an empty \`stopped\` only means nothing was still running. { unmatched } lists supplied ids that own no service here, so a mistyped id - or a device NAME passed where an id was expected - does not read as a clean machine. It is NOT proof the id is wrong: a Vega device is driven through CLI/adb shell-outs, so one you only booted and drove with the remote registers no service and always lands here \u2014 as does a real device of any platform this session never started anything on. Present ONLY when \`devices\` was supplied AND at least one id matched nothing - absent on an unscoped call and when every id matched. Stopping the same device twice does not report it unmatched: ownership counts regardless of service state. { left_running } lists live debugger sessions (and the network inspectors / React profiler sessions riding on them) whose id no device scope can name - re-call with that id to reap them. { aborted: true } means the caller cancelled the request part-way, so the rest of the machine was left untouched and neither of the other two fields was computed. Past the schema - which rejects an unknown key outright, so the \`udids\` slip is an error rather than a silent machine-wide sweep - the call always succeeds; reaping nothing is a result, not a failure.`,
-    zodSchema: zodSchema62,
+    zodSchema: zodSchema63,
     services: () => ({}),
     async execute(_services, params, ctx) {
       const devices = params.devices;
@@ -147389,7 +147459,7 @@ function listeningPids(port) {
   if (!output) return [];
   return output.split("\n").map((s) => parseInt(s.trim(), 10)).filter((n) => !Number.isNaN(n));
 }
-var zodSchema63 = external_exports.object({
+var zodSchema64 = 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 = {
@@ -147400,7 +147470,7 @@ var stopMetroTool = {
     failedMsg: ({ params, failureSignal: failureSignal2 }) => `Failed to stop Metro on port ${params.port}: ${failureSignal2.error_code}`
   },
   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: zodSchema63,
+  zodSchema: zodSchema64,
   services: () => ({}),
   async execute(_services, params) {
     const port = params.port;
@@ -149744,7 +149814,7 @@ async function appendStepToFlow(session, step) {
 }
 
 // ../tool-server/src/tools/flows/flow-start-recording.ts
-var zodSchema64 = external_exports.object({
+var zodSchema65 = external_exports.object({
   name: external_exports.string().describe(
     'Name for this flow (e.g. "settings-explore") \u2014 letters, digits, underscore and hyphen only.'
   ),
@@ -149801,7 +149871,7 @@ recording. Over a link, the next recorded step writes over your edit.
 Without a link, the recorder reads the file again before each step, but an
 edit that renumbers the steps drops the warnings that flow-finish-recording
 reports for those steps.`,
-  zodSchema: zodSchema64,
+  zodSchema: zodSchema65,
   fileInputs: fileInputs2,
   services: () => ({}),
   async execute(_services, params, ctx) {
@@ -152301,7 +152371,7 @@ function stepAnchor(step) {
 
 // ../tool-server/src/tools/flows/flow-add-step.ts
 init_device_info();
-var zodSchema65 = external_exports.object({
+var zodSchema66 = external_exports.object({
   name: external_exports.string().describe("Name of the flow being recorded \u2014 the one passed to flow-start-recording."),
   project_root: external_exports.string().describe(
     "Absolute path to the project root of the flow being recorded \u2014 the same value passed to flow-start-recording. Together with `name` it identifies which recording this step belongs to."
@@ -152760,7 +152830,7 @@ Returns { message, stepCount, recorded, savedTo }; \`recorded\`, not the status,
     // more times — and every retry re-runs the action and appends another step,
     // because an aborted request still appends its first.
     longRunning: true,
-    zodSchema: zodSchema65,
+    zodSchema: zodSchema66,
     fileInputs: fileInputs3,
     services: () => ({}),
     async execute(_services, params, ctx) {
@@ -152949,7 +153019,7 @@ Returns { message, stepCount, recorded, savedTo }; \`recorded\`, not the status,
 
 // ../tool-server/src/tools/flows/flow-insert-echo.ts
 init_zod();
-var zodSchema66 = external_exports.object({
+var zodSchema67 = external_exports.object({
   name: external_exports.string().describe("Name of the flow being recorded \u2014 the one passed to flow-start-recording."),
   project_root: external_exports.string().describe(
     "Absolute path to the project root of the flow being recorded \u2014 the same value passed to flow-start-recording. Together with `name` it identifies which recording this echo belongs to."
@@ -152967,7 +153037,7 @@ var flowInsertEchoTool = {
   description: `Record an echo step in the flow named by \`name\` + \`project_root\`. 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, stepCount, savedTo }. Fails if that flow has no recording in progress.`,
-  zodSchema: zodSchema66,
+  zodSchema: zodSchema67,
   services: () => ({}),
   async execute(_services, params) {
     const session = await requireRecordingSession(params.project_root, params.name);
@@ -154270,7 +154340,7 @@ function errMsg3(err) {
 
 // ../tool-server/src/tools/flows/flow-add-script.ts
 var OUTPUT_RENDER_LIMIT_BYTES = 64 * 1024;
-var zodSchema67 = external_exports.object({
+var zodSchema68 = external_exports.object({
   name: external_exports.string().describe("Flow name passed to flow-start-recording."),
   project_root: external_exports.string().describe("Absolute project root passed to flow-start-recording."),
   path: external_exports.string().describe(
@@ -154327,7 +154397,7 @@ var flowAddScriptTool = {
   // The flag only skips the adapter's own abort timer; its retry loop is
   // untouched, so a call that fails some other way is still re-POSTed.
   longRunning: true,
-  zodSchema: zodSchema67,
+  zodSchema: zodSchema68,
   services: () => ({}),
   async execute(_services, params, ctx) {
     const session = await requireRecordingSession(params.project_root, params.name);
@@ -154417,7 +154487,7 @@ var flowAddScriptTool = {
 // ../tool-server/src/tools/flows/flow-finish-recording.ts
 init_zod();
 var fs60 = __toESM(require("node:fs/promises"));
-var zodSchema68 = external_exports.object({
+var zodSchema69 = external_exports.object({
   name: external_exports.string().describe("Name of the flow being recorded \u2014 the one passed to flow-start-recording."),
   project_root: external_exports.string().describe(
     "Absolute path to the project root of the flow being recorded \u2014 the same value passed to flow-start-recording. Together with `name` it identifies which recording to finish."
@@ -154476,7 +154546,7 @@ var flowFinishRecordingTool = {
   description: `Finish recording the flow named by \`name\` + \`project_root\`, leaving recordings under any other key untouched. Returns { message, path, executionPrerequisite, steps, summary, flowFile, savedTo } - a summary of all recorded steps plus the final YAML. Use when you have added all desired steps and want to finalize the flow file. Fails if that flow has no recording in progress.
 A warning flow-add-step raised on a recorded \`await-ui-element\` is repeated in \`summary\` as a \`warning:\` line of its own, right below the step it judges, and \`message\` counts them by kind. A warning is repeated only while the step it judges is still identifiable by its number: hand-editing the .yaml during the recording moves the steps, so those warnings are DROPPED rather than pinned on whichever step inherited the number, and \`message\` says how many were dropped. A step that carries a cross-tree warning was re-probed against the runner's tree: read it before converting that wait to \`await:\`/\`assert:\`, which is what the verdict is about and what this moment is for. A step that recorded a wait which did not pass was never probed at all, and its own warning names the CAUSE, because only one of them judges the condition: an unmet wait was read and found false, and it stops the run at replay; a wait whose tree source could not be read, or one that was cancelled, observed nothing and leaves the condition UNKNOWN rather than known-bad. Read those before replaying.
 You can still edit the .yaml file directly afterwards to remove or reorder steps.`,
-  zodSchema: zodSchema68,
+  zodSchema: zodSchema69,
   services: () => ({}),
   async execute(_services, params) {
     const { filePath, flowFile, savedTo, flow, summary, headline } = await withFlowFileLock(
@@ -156954,7 +157024,7 @@ async function restoreStatusBar(device) {
 }
 
 // ../tool-server/src/tools/flows/flow-run.ts
-var zodSchema69 = external_exports.object({
+var zodSchema70 = external_exports.object({
   name: external_exports.string().optional().describe(
     'Name of a saved flow to run from `.argent/flows` (e.g. "settings-explore"). Omit when flow_path is set.'
   ),
@@ -157461,7 +157531,7 @@ one-off interaction use the gesture tools instead, and to author a flow use flow
 exactly one flow source: name (under project_root) or flow_path.
 Returns a per-step report: the first failure stops the run and the rest report as skipped.`,
     longRunning: true,
-    zodSchema: zodSchema69,
+    zodSchema: zodSchema70,
     fileInputs: fileInputs4,
     services: () => ({}),
     async execute(_services, params, ctx) {
@@ -158438,7 +158508,7 @@ async function resolveFlowSource(params, fileInput, flowPathInput) {
 // ../tool-server/src/tools/flows/flow-read-prerequisite.ts
 init_zod();
 var fs64 = __toESM(require("node:fs/promises"));
-var zodSchema70 = external_exports.object({
+var zodSchema71 = external_exports.object({
   name: external_exports.string().optional().describe(
     'Name of a saved flow to inspect from `.argent/flows` (e.g. "settings-explore"). Omit when flow_path is set.'
   ),
@@ -158494,7 +158564,7 @@ Touches no device: nothing is launched, tapped, dispatched or torn down, and no
 needs booting, so calling this costs nothing but a file read.
 Fails if the flow file does not exist.
 Address the flow exactly as you will address it in flow-execute: name or flow_path, one and only one; supplying both or neither is rejected. The name goes in \`name\`, which resolves <project_root>/.argent/flows/<name>.yaml.`,
-  zodSchema: zodSchema70,
+  zodSchema: zodSchema71,
   fileInputs: fileInputs5,
   services: () => ({}),
   async execute(_services, params, ctx) {
@@ -158810,7 +158880,7 @@ async function readWorkspaceSnapshot(workspacePath) {
 }
 
 // ../tool-server/src/tools/workspace/gather-workspace-data.ts
-var zodSchema71 = external_exports.object({
+var zodSchema72 = external_exports.object({
   workspacePath: external_exports.string().describe("Absolute path to the project root directory to inspect (e.g. /Users/dev/MyApp)")
 });
 var fileInputs6 = [
@@ -158841,7 +158911,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: zodSchema71,
+  zodSchema: zodSchema72,
   fileInputs: fileInputs6,
   services: () => ({}),
   async execute(_services, params) {
@@ -158915,7 +158985,7 @@ function targetFlagsFor(target) {
   if (target === "both") return ["--global", "--local"];
   return [`--${target}`];
 }
-var zodSchema72 = external_exports.object({
+var zodSchema73 = external_exports.object({
   target: external_exports.enum(["auto", "global", "local", "both"]).optional().describe(
     "Which install to update. 'auto' (default) updates the install serving this session \u2014 the global PATH install or this project's local devDependency, whichever this server runs from. Pass 'global' / 'local' to force one, or 'both' when the user has both and wants each updated."
   )
@@ -158929,7 +158999,7 @@ var updateArgentTool = {
     failedMsg: ({ failureSignal: failureSignal2 }) => `Failed to update Argent: ${failureSignal2.error_code}`
   },
   description: "Apply a pending Argent update. Only call this tool when the user has explicitly consented to updating Argent in this conversation. Use when an update notification indicates a new version is available and the user agrees to update. By default updates the install serving this session; pass `target` to choose global/local/both. Returns { message } with the update status and version info. The tool server will restart automatically after the update. Fails if no update is available or an update is already in progress.",
-  zodSchema: zodSchema72,
+  zodSchema: zodSchema73,
   services: () => ({}),
   async execute(_services, params, _options) {
     const { updateAvailable, updateInstallable, currentVersion, installableVersion } = getUpdateState();
@@ -159014,7 +159084,7 @@ var updateArgentTool = {
 
 // ../tool-server/src/tools/system/dismiss-update.ts
 init_zod();
-var zodSchema73 = external_exports.object({
+var zodSchema74 = external_exports.object({
   hours: external_exports.number().min(0).describe("Number of hours to suppress the update notification")
 });
 var dismissUpdateTool = {
@@ -159025,7 +159095,7 @@ var dismissUpdateTool = {
     failedMsg: ({ failureSignal: failureSignal2 }) => `Failed to dismiss Argent update: ${failureSignal2.error_code}`
   },
   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: zodSchema73,
+  zodSchema: zodSchema74,
   services: () => ({}),
   async execute(_services, params, _options) {
     const durationMs = params.hours * 60 * 60 * 1e3;
@@ -159044,7 +159114,7 @@ var import_path8 = __toESM(require("path"));
 init_zod();
 init_src2();
 init_device_info();
-var zodSchema74 = external_exports.object({
+var zodSchema75 = 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)."),
@@ -159061,7 +159131,7 @@ var zodSchema74 = 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 capability33 = {
+var capability34 = {
   apple: { simulator: true, device: true },
   android: { emulator: true, device: true, unknown: true }
 };
@@ -159086,8 +159156,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: zodSchema74,
-  capability: capability33,
+  zodSchema: zodSchema75,
+  capability: capability34,
   fileInputs: fileInputs7,
   services: (params) => {
     if (params.captureBaseline || params.captureCurrent) {
@@ -159400,7 +159470,7 @@ async function captureElementFrame(registry2, udid, match, opts = {}) {
 }
 
 // ../tool-server/src/tools/variants/propose-variant.ts
-var zodSchema75 = external_exports.object({
+var zodSchema76 = 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.'
   ),
@@ -159460,7 +159530,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: zodSchema75,
+    zodSchema: zodSchema76,
     services: () => ({}),
     async execute(_services, params) {
       let frame = params.variant.frame;
@@ -159484,7 +159554,7 @@ it does not wait for the user.`,
 
 // ../tool-server/src/tools/variants/await-user-selection.ts
 init_zod();
-var zodSchema76 = external_exports.object({
+var zodSchema77 = 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."
   )
@@ -159525,7 +159595,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: zodSchema76,
+  zodSchema: zodSchema77,
   services: () => ({}),
   async execute(_services, params, options) {
     const timeoutMs = (params.timeoutSeconds ?? 1800) * 1e3;
@@ -159540,7 +159610,7 @@ disconnects (aborts cleanly).`,
 init_zod();
 init_src2();
 init_device_info();
-var zodSchema77 = external_exports.object({
+var zodSchema78 = 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."
@@ -159573,7 +159643,7 @@ var tabAction = {
     failure: "close"
   }
 };
-var capability34 = {
+var capability35 = {
   chromium: { app: true }
 };
 var chromiumTabsTool = {
@@ -159591,8 +159661,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: zodSchema77,
-  capability: capability34,
+  zodSchema: zodSchema78,
+  capability: capability35,
   services: (params) => {
     const device = resolveDevice(params.udid);
     if (device.platform === "chromium") {
@@ -159693,7 +159763,7 @@ async function clearStorage(cdp, type) {
 }
 
 // ../tool-server/src/tools/chromium-cookies/index.ts
-var zodSchema78 = external_exports.object({
+var zodSchema79 = 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."
@@ -159716,7 +159786,7 @@ var cookieAction = {
   delete: { started: "Deleting", completed: "Deleted", failure: "delete" },
   clear: { started: "Clearing", completed: "Cleared", failure: "clear" }
 };
-var capability35 = {
+var capability36 = {
   chromium: { app: true }
 };
 var chromiumCookiesTool = {
@@ -159734,8 +159804,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: zodSchema78,
-  capability: capability35,
+  zodSchema: zodSchema79,
+  capability: capability36,
   services: (params) => {
     const device = resolveDevice(params.udid);
     if (device.platform === "chromium") {
@@ -159800,7 +159870,7 @@ Returns { cookies, count } for get, or a small status object ({ set } / { delete
 init_zod();
 init_src2();
 init_device_info();
-var zodSchema79 = external_exports.object({
+var zodSchema80 = 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(
@@ -159815,7 +159885,7 @@ var storageAction = {
   remove: { started: "Removing from", completed: "Removed from", failure: "remove from" },
   clear: { started: "Clearing", completed: "Cleared", failure: "clear" }
 };
-var capability36 = {
+var capability37 = {
   chromium: { app: true }
 };
 var chromiumStorageTool = {
@@ -159834,8 +159904,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: zodSchema79,
-  capability: capability36,
+  zodSchema: zodSchema80,
+  capability: capability37,
   services: (params) => {
     const device = resolveDevice(params.udid);
     if (device.platform === "chromium") {
@@ -159947,6 +160017,7 @@ function createRegistry() {
   registry2.registerTool(networkRequestTool);
   registry2.registerTool(createDescribeTool(registry2));
   registry2.registerTool(createUiTreeTool(registry2));
+  registry2.registerTool(createForegroundAppTool(registry2));
   registry2.registerTool(createAwaitUiElementTool(registry2));
   registry2.registerTool(createAwaitScreenIdleTool(registry2));
   registry2.registerTool(createReactProfilerStartTool(registry2));

package/package.json

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