@swmansion/argent 0.32.1-next.1 → 0.32.1-next.10

package/dist/cli-cmds.mjs

@@ -10550,15 +10550,21 @@ var FAILURE_CODES = {
   ANDROID_LAUNCH_AM_START_FAILED: "ANDROID_LAUNCH_AM_START_FAILED",
   ANDROID_OPEN_URL_FAILED: "ANDROID_OPEN_URL_FAILED",
   ANDROID_REINSTALL_INSTALL_FAILED: "ANDROID_REINSTALL_INSTALL_FAILED",
+  ANDROID_REINSTALL_UNINSTALL_FAILED: "ANDROID_REINSTALL_UNINSTALL_FAILED",
   ANDROID_RESTART_FAILED: "ANDROID_RESTART_FAILED",
   ANDROID_SETTINGS_PERMISSION_FAILED: "ANDROID_SETTINGS_PERMISSION_FAILED",
   IOS_LAUNCH_SIMCTL_FAILED: "IOS_LAUNCH_SIMCTL_FAILED",
   IOS_OPEN_URL_FAILED: "IOS_OPEN_URL_FAILED",
   IOS_REINSTALL_INSTALL_FAILED: "IOS_REINSTALL_INSTALL_FAILED",
+  IOS_REINSTALL_UNINSTALL_FAILED: "IOS_REINSTALL_UNINSTALL_FAILED",
   IOS_RESTART_LAUNCH_FAILED: "IOS_RESTART_LAUNCH_FAILED",
+  IOS_RESTART_TERMINATE_FAILED: "IOS_RESTART_TERMINATE_FAILED",
+  IOS_TERMINATE_APP_FAILED: "IOS_TERMINATE_APP_FAILED",
   IOS_SETTINGS_PERMISSION_FAILED: "IOS_SETTINGS_PERMISSION_FAILED",
   IOS_SHAKE_FAILED: "IOS_SHAKE_FAILED",
   ANDROID_SHAKE_FAILED: "ANDROID_SHAKE_FAILED",
+  STOP_METRO_PORT_PROBE_FAILED: "STOP_METRO_PORT_PROBE_FAILED",
+  STOP_METRO_SIGNAL_FAILED: "STOP_METRO_SIGNAL_FAILED",
   // The hinge of a foldable iOS simulator: the server refused the request on a
   // foldable (a bad angle, a hinge that would not move) vs. nothing to fold —
   // a device that is not foldable, no hinge route, a remote simulator.
@@ -10704,10 +10710,13 @@ var FAILURE_CODES = {
   FLOW_NAME_INVALID: "FLOW_NAME_INVALID",
   FLOW_NO_ACTIVE_RECORDING: "FLOW_NO_ACTIVE_RECORDING",
   FLOW_FILE_INVALID: "FLOW_FILE_INVALID",
+  FLOW_FILE_NEWER_VERSION: "FLOW_FILE_NEWER_VERSION",
   FLOW_FILE_WRITE_FAILED: "FLOW_FILE_WRITE_FAILED",
   FLOW_ENTRY_UNRECOGNIZED: "FLOW_ENTRY_UNRECOGNIZED",
   FLOW_E2E_HAS_PREREQUISITE: "FLOW_E2E_HAS_PREREQUISITE",
   FLOW_DEVICE_RESOLUTION: "FLOW_DEVICE_RESOLUTION",
+  // The target does not satisfy the test's `requires:` block; a directory run skips it.
+  FLOW_REQUIREMENTS_UNMET: "FLOW_REQUIREMENTS_UNMET",
   PROFILER_QUERY_MODE_INVALID: "PROFILER_QUERY_MODE_INVALID",
   PROFILER_QUERY_REQUIRED_PARAM_MISSING: "PROFILER_QUERY_REQUIRED_PARAM_MISSING",
   PROFILER_DATA_NOT_LOADED: "PROFILER_DATA_NOT_LOADED",
@@ -10726,6 +10735,7 @@ var FAILURE_CODES = {
   CHROMIUM_STORAGE_EVAL_FAILED: "CHROMIUM_STORAGE_EVAL_FAILED",
   CHROMIUM_TAB_NOT_FOUND: "CHROMIUM_TAB_NOT_FOUND",
   CHROMIUM_TAB_OPEN_FAILED: "CHROMIUM_TAB_OPEN_FAILED",
+  CHROMIUM_NAVIGATE_FAILED: "CHROMIUM_NAVIGATE_FAILED",
   CHROMIUM_DESCRIBE_FAILED: "CHROMIUM_DESCRIBE_FAILED",
   CHROMIUM_ELECTRON_APP_PATH_INVALID: "CHROMIUM_ELECTRON_APP_PATH_INVALID",
   CHROMIUM_ELECTRON_SPAWN_FAILED: "CHROMIUM_ELECTRON_SPAWN_FAILED",
@@ -10742,6 +10752,8 @@ var FAILURE_CODES = {
   SCREENSHOT_DIFF_INPUT_INVALID: "SCREENSHOT_DIFF_INPUT_INVALID",
   BOOT_DEVICE_TARGET_SELECTION_INVALID: "BOOT_DEVICE_TARGET_SELECTION_INVALID",
   BOOT_IOS_UNSUPPORTED_HOST: "BOOT_IOS_UNSUPPORTED_HOST",
+  BOOT_IOS_SIMCTL_LIST_TIMEOUT: "BOOT_IOS_SIMCTL_LIST_TIMEOUT",
+  BOOT_IOS_SIMCTL_TIMEOUT: "BOOT_IOS_SIMCTL_TIMEOUT",
   BOOT_ANDROID_NO_AVDS: "BOOT_ANDROID_NO_AVDS",
   BOOT_ANDROID_AVD_NOT_FOUND: "BOOT_ANDROID_AVD_NOT_FOUND",
   BOOT_ANDROID_ADB_UNAVAILABLE: "BOOT_ANDROID_ADB_UNAVAILABLE",
@@ -35809,7 +35821,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID2 = randomUUID5();
 function readCliVersion() {
   if (true) {
-    return "0.32.1-next.0";
+    return "0.32.1-next.10";
   }
   return "0.0.0";
 }
@@ -37150,8 +37162,9 @@ contain only letters, numbers, "_", or "-" \u2014 the same charset a name must
 match. A test is standalone when its first non-\`echo\`/\`script\` step is \`launch\`.
 Other tests are fragments and use the device's current state. Exception: a fragment whose first step \`run:\`s a chromium standalone
 test boots that test's app before step 1 \u2014 when that launch is unambiguously
-chromium (a lone \`{ chromium: ... }\` target, or --platform chromium); a
-multi-platform launch auto-detects a device instead. Pass --device to attach to
+chromium (a lone \`{ chromium: ... }\` target, --platform chromium, or a
+\`requires:\` block that allows only chromium); a multi-platform launch
+auto-detects a device instead. Pass --device to attach to
 a running instance.
 
 A directory run prints only the steps that need attention (each failure, each
@@ -37164,6 +37177,12 @@ file, or a device it cannot resolve. A transport failure, a rejection the server
 does not mark as validation, or a reply that is not a report stops the batch and
 counts the remaining tests skipped.
 
+A test can declare a \`requires:\` block (platform, runtimeKind) that names the
+targets it supports. A directory run skips each test whose requirements the
+target does not meet, so the same directory runs on each platform without a
+separate list of tests. A single-test run fails instead. A directory run where
+no test ran exits 2.
+
 The CLI sends a run to its tool-server: the local one that starts
 automatically, or the one that \`argent link\` or ARGENT_TOOLS_URL names. Over
 a link, the CLI uploads these files and writes the new baselines that the run
@@ -37346,7 +37365,8 @@ function renderFailedSteps(report) {
   return lines;
 }
 function renderBatchSummary(counts, durationMs) {
-  return `${counts.failed === 0 ? "PASS" : "FAIL"} \u2014 ${counts.total} e2e test${counts.total === 1 ? "" : "s"}: ${counts.passed} passed, ${counts.failed} failed, ${counts.skipped} skipped${durationSuffix(durationMs)}`;
+  const verdict = counts.failed > 0 ? "FAIL" : counts.passed === 0 ? "NONE RAN" : "PASS";
+  return `${verdict} \u2014 ${counts.total} e2e test${counts.total === 1 ? "" : "s"}: ${counts.passed} passed, ${counts.failed} failed, ${counts.skipped} skipped${durationSuffix(durationMs)}`;
 }
 function summarizeFailure(report) {
   let n3 = 0;
@@ -37732,8 +37752,12 @@ function rejectionVerdict(code) {
     case FAILURE_CODES.FLOW_ENTRY_UNRECOGNIZED:
     case FAILURE_CODES.FLOW_E2E_HAS_PREREQUISITE:
       return "not run (invalid e2e test)";
+    case FAILURE_CODES.FLOW_FILE_NEWER_VERSION:
+      return "not run (needs a newer Argent)";
     case FAILURE_CODES.FLOW_DEVICE_RESOLUTION:
       return "not run (no device resolved)";
+    case FAILURE_CODES.FLOW_REQUIREMENTS_UNMET:
+      return "not run (requires not met)";
     case FAILURE_CODES.FILE_INPUT_UPLOAD_FAILED:
       return "not run (upload failed)";
     default:
@@ -37810,6 +37834,14 @@ async function runFlowDirectory(dir, args, projectRoot, options) {
       const err = unreachableErr ?? thrown;
       const message = err instanceof Error ? err.message : String(err);
       const toolErr = err instanceof ToolInvocationError ? err : void 0;
+      if (toolErr?.errorCode === FAILURE_CODES.FLOW_REQUIREMENTS_UNMET) {
+        const reason = message.replace(/^\[Tool:[^\]]+\] /, "");
+        results.push({ path: rel, status: "skip", reason });
+        if (!args.json)
+          console.log(`  ${STATUS_GLYPH.skip} skipped (requires not met)
+    ${reason}`);
+        continue;
+      }
       const rejectedThisFlowOnly = toolErr?.errorKind === "validation";
       const verdict = unreachableErr ? UNREACHABLE_VERDICT : rejectedThisFlowOnly ? rejectionVerdict(toolErr?.errorCode) : "did not finish (run error)";
       if (!args.json) console.log(`  ${STATUS_GLYPH.error} ${verdict}`);
@@ -37860,11 +37892,18 @@ async function runFlowDirectory(dir, args, projectRoot, options) {
     skipped: results.filter((r2) => r2.status === "skip").length
   };
   const durationMs = Date.now() - batchStartedAt;
+  const noneRan = counts.passed === 0 && counts.failed === 0;
   if (args.json) {
     console.log(
       JSON.stringify(
         // `flows` is the deprecated spelling of `e2eTests`.
-        { ok: counts.failed === 0, ...counts, durationMs, e2eTests: results, flows: results },
+        {
+          ok: counts.failed === 0 && !noneRan,
+          ...counts,
+          durationMs,
+          e2eTests: results,
+          flows: results
+        },
         null,
         2
       )
@@ -37873,8 +37912,9 @@ async function runFlowDirectory(dir, args, projectRoot, options) {
     for (const line of renderFailedFlows(failures)) console.log(line);
     console.log(`
 ${renderBatchSummary(counts, durationMs)}`);
+    if (noneRan) console.error(`No e2e test in ${dir} ran on the selected target.`);
   }
-  return exitAfterFlush(unreachable ? 2 : counts.failed === 0 ? 0 : 1);
+  return exitAfterFlush(unreachable || noneRan ? 2 : counts.failed === 0 ? 0 : 1);
 }
 async function e2e(argv, options) {
   const [sub, ...rest] = argv;

package/dist/client.js

@@ -9123,15 +9123,21 @@ var FAILURE_CODES = {
   ANDROID_LAUNCH_AM_START_FAILED: "ANDROID_LAUNCH_AM_START_FAILED",
   ANDROID_OPEN_URL_FAILED: "ANDROID_OPEN_URL_FAILED",
   ANDROID_REINSTALL_INSTALL_FAILED: "ANDROID_REINSTALL_INSTALL_FAILED",
+  ANDROID_REINSTALL_UNINSTALL_FAILED: "ANDROID_REINSTALL_UNINSTALL_FAILED",
   ANDROID_RESTART_FAILED: "ANDROID_RESTART_FAILED",
   ANDROID_SETTINGS_PERMISSION_FAILED: "ANDROID_SETTINGS_PERMISSION_FAILED",
   IOS_LAUNCH_SIMCTL_FAILED: "IOS_LAUNCH_SIMCTL_FAILED",
   IOS_OPEN_URL_FAILED: "IOS_OPEN_URL_FAILED",
   IOS_REINSTALL_INSTALL_FAILED: "IOS_REINSTALL_INSTALL_FAILED",
+  IOS_REINSTALL_UNINSTALL_FAILED: "IOS_REINSTALL_UNINSTALL_FAILED",
   IOS_RESTART_LAUNCH_FAILED: "IOS_RESTART_LAUNCH_FAILED",
+  IOS_RESTART_TERMINATE_FAILED: "IOS_RESTART_TERMINATE_FAILED",
+  IOS_TERMINATE_APP_FAILED: "IOS_TERMINATE_APP_FAILED",
   IOS_SETTINGS_PERMISSION_FAILED: "IOS_SETTINGS_PERMISSION_FAILED",
   IOS_SHAKE_FAILED: "IOS_SHAKE_FAILED",
   ANDROID_SHAKE_FAILED: "ANDROID_SHAKE_FAILED",
+  STOP_METRO_PORT_PROBE_FAILED: "STOP_METRO_PORT_PROBE_FAILED",
+  STOP_METRO_SIGNAL_FAILED: "STOP_METRO_SIGNAL_FAILED",
   // The hinge of a foldable iOS simulator: the server refused the request on a
   // foldable (a bad angle, a hinge that would not move) vs. nothing to fold —
   // a device that is not foldable, no hinge route, a remote simulator.
@@ -9277,10 +9283,13 @@ var FAILURE_CODES = {
   FLOW_NAME_INVALID: "FLOW_NAME_INVALID",
   FLOW_NO_ACTIVE_RECORDING: "FLOW_NO_ACTIVE_RECORDING",
   FLOW_FILE_INVALID: "FLOW_FILE_INVALID",
+  FLOW_FILE_NEWER_VERSION: "FLOW_FILE_NEWER_VERSION",
   FLOW_FILE_WRITE_FAILED: "FLOW_FILE_WRITE_FAILED",
   FLOW_ENTRY_UNRECOGNIZED: "FLOW_ENTRY_UNRECOGNIZED",
   FLOW_E2E_HAS_PREREQUISITE: "FLOW_E2E_HAS_PREREQUISITE",
   FLOW_DEVICE_RESOLUTION: "FLOW_DEVICE_RESOLUTION",
+  // The target does not satisfy the test's `requires:` block; a directory run skips it.
+  FLOW_REQUIREMENTS_UNMET: "FLOW_REQUIREMENTS_UNMET",
   PROFILER_QUERY_MODE_INVALID: "PROFILER_QUERY_MODE_INVALID",
   PROFILER_QUERY_REQUIRED_PARAM_MISSING: "PROFILER_QUERY_REQUIRED_PARAM_MISSING",
   PROFILER_DATA_NOT_LOADED: "PROFILER_DATA_NOT_LOADED",
@@ -9299,6 +9308,7 @@ var FAILURE_CODES = {
   CHROMIUM_STORAGE_EVAL_FAILED: "CHROMIUM_STORAGE_EVAL_FAILED",
   CHROMIUM_TAB_NOT_FOUND: "CHROMIUM_TAB_NOT_FOUND",
   CHROMIUM_TAB_OPEN_FAILED: "CHROMIUM_TAB_OPEN_FAILED",
+  CHROMIUM_NAVIGATE_FAILED: "CHROMIUM_NAVIGATE_FAILED",
   CHROMIUM_DESCRIBE_FAILED: "CHROMIUM_DESCRIBE_FAILED",
   CHROMIUM_ELECTRON_APP_PATH_INVALID: "CHROMIUM_ELECTRON_APP_PATH_INVALID",
   CHROMIUM_ELECTRON_SPAWN_FAILED: "CHROMIUM_ELECTRON_SPAWN_FAILED",
@@ -9315,6 +9325,8 @@ var FAILURE_CODES = {
   SCREENSHOT_DIFF_INPUT_INVALID: "SCREENSHOT_DIFF_INPUT_INVALID",
   BOOT_DEVICE_TARGET_SELECTION_INVALID: "BOOT_DEVICE_TARGET_SELECTION_INVALID",
   BOOT_IOS_UNSUPPORTED_HOST: "BOOT_IOS_UNSUPPORTED_HOST",
+  BOOT_IOS_SIMCTL_LIST_TIMEOUT: "BOOT_IOS_SIMCTL_LIST_TIMEOUT",
+  BOOT_IOS_SIMCTL_TIMEOUT: "BOOT_IOS_SIMCTL_TIMEOUT",
   BOOT_ANDROID_NO_AVDS: "BOOT_ANDROID_NO_AVDS",
   BOOT_ANDROID_AVD_NOT_FOUND: "BOOT_ANDROID_AVD_NOT_FOUND",
   BOOT_ANDROID_ADB_UNAVAILABLE: "BOOT_ANDROID_ADB_UNAVAILABLE",

package/dist/installer.mjs

@@ -15887,15 +15887,21 @@ var FAILURE_CODES = {
   ANDROID_LAUNCH_AM_START_FAILED: "ANDROID_LAUNCH_AM_START_FAILED",
   ANDROID_OPEN_URL_FAILED: "ANDROID_OPEN_URL_FAILED",
   ANDROID_REINSTALL_INSTALL_FAILED: "ANDROID_REINSTALL_INSTALL_FAILED",
+  ANDROID_REINSTALL_UNINSTALL_FAILED: "ANDROID_REINSTALL_UNINSTALL_FAILED",
   ANDROID_RESTART_FAILED: "ANDROID_RESTART_FAILED",
   ANDROID_SETTINGS_PERMISSION_FAILED: "ANDROID_SETTINGS_PERMISSION_FAILED",
   IOS_LAUNCH_SIMCTL_FAILED: "IOS_LAUNCH_SIMCTL_FAILED",
   IOS_OPEN_URL_FAILED: "IOS_OPEN_URL_FAILED",
   IOS_REINSTALL_INSTALL_FAILED: "IOS_REINSTALL_INSTALL_FAILED",
+  IOS_REINSTALL_UNINSTALL_FAILED: "IOS_REINSTALL_UNINSTALL_FAILED",
   IOS_RESTART_LAUNCH_FAILED: "IOS_RESTART_LAUNCH_FAILED",
+  IOS_RESTART_TERMINATE_FAILED: "IOS_RESTART_TERMINATE_FAILED",
+  IOS_TERMINATE_APP_FAILED: "IOS_TERMINATE_APP_FAILED",
   IOS_SETTINGS_PERMISSION_FAILED: "IOS_SETTINGS_PERMISSION_FAILED",
   IOS_SHAKE_FAILED: "IOS_SHAKE_FAILED",
   ANDROID_SHAKE_FAILED: "ANDROID_SHAKE_FAILED",
+  STOP_METRO_PORT_PROBE_FAILED: "STOP_METRO_PORT_PROBE_FAILED",
+  STOP_METRO_SIGNAL_FAILED: "STOP_METRO_SIGNAL_FAILED",
   // The hinge of a foldable iOS simulator: the server refused the request on a
   // foldable (a bad angle, a hinge that would not move) vs. nothing to fold —
   // a device that is not foldable, no hinge route, a remote simulator.
@@ -16041,10 +16047,13 @@ var FAILURE_CODES = {
   FLOW_NAME_INVALID: "FLOW_NAME_INVALID",
   FLOW_NO_ACTIVE_RECORDING: "FLOW_NO_ACTIVE_RECORDING",
   FLOW_FILE_INVALID: "FLOW_FILE_INVALID",
+  FLOW_FILE_NEWER_VERSION: "FLOW_FILE_NEWER_VERSION",
   FLOW_FILE_WRITE_FAILED: "FLOW_FILE_WRITE_FAILED",
   FLOW_ENTRY_UNRECOGNIZED: "FLOW_ENTRY_UNRECOGNIZED",
   FLOW_E2E_HAS_PREREQUISITE: "FLOW_E2E_HAS_PREREQUISITE",
   FLOW_DEVICE_RESOLUTION: "FLOW_DEVICE_RESOLUTION",
+  // The target does not satisfy the test's `requires:` block; a directory run skips it.
+  FLOW_REQUIREMENTS_UNMET: "FLOW_REQUIREMENTS_UNMET",
   PROFILER_QUERY_MODE_INVALID: "PROFILER_QUERY_MODE_INVALID",
   PROFILER_QUERY_REQUIRED_PARAM_MISSING: "PROFILER_QUERY_REQUIRED_PARAM_MISSING",
   PROFILER_DATA_NOT_LOADED: "PROFILER_DATA_NOT_LOADED",
@@ -16063,6 +16072,7 @@ var FAILURE_CODES = {
   CHROMIUM_STORAGE_EVAL_FAILED: "CHROMIUM_STORAGE_EVAL_FAILED",
   CHROMIUM_TAB_NOT_FOUND: "CHROMIUM_TAB_NOT_FOUND",
   CHROMIUM_TAB_OPEN_FAILED: "CHROMIUM_TAB_OPEN_FAILED",
+  CHROMIUM_NAVIGATE_FAILED: "CHROMIUM_NAVIGATE_FAILED",
   CHROMIUM_DESCRIBE_FAILED: "CHROMIUM_DESCRIBE_FAILED",
   CHROMIUM_ELECTRON_APP_PATH_INVALID: "CHROMIUM_ELECTRON_APP_PATH_INVALID",
   CHROMIUM_ELECTRON_SPAWN_FAILED: "CHROMIUM_ELECTRON_SPAWN_FAILED",
@@ -16079,6 +16089,8 @@ var FAILURE_CODES = {
   SCREENSHOT_DIFF_INPUT_INVALID: "SCREENSHOT_DIFF_INPUT_INVALID",
   BOOT_DEVICE_TARGET_SELECTION_INVALID: "BOOT_DEVICE_TARGET_SELECTION_INVALID",
   BOOT_IOS_UNSUPPORTED_HOST: "BOOT_IOS_UNSUPPORTED_HOST",
+  BOOT_IOS_SIMCTL_LIST_TIMEOUT: "BOOT_IOS_SIMCTL_LIST_TIMEOUT",
+  BOOT_IOS_SIMCTL_TIMEOUT: "BOOT_IOS_SIMCTL_TIMEOUT",
   BOOT_ANDROID_NO_AVDS: "BOOT_ANDROID_NO_AVDS",
   BOOT_ANDROID_AVD_NOT_FOUND: "BOOT_ANDROID_AVD_NOT_FOUND",
   BOOT_ANDROID_ADB_UNAVAILABLE: "BOOT_ANDROID_ADB_UNAVAILABLE",
@@ -16934,7 +16946,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID = randomUUID4();
 function readCliVersion() {
   if (true) {
-    return "0.32.1-next.0";
+    return "0.32.1-next.10";
   }
   return "0.0.0";
 }

package/dist/mcp-server.mjs

@@ -25833,15 +25833,21 @@ var FAILURE_CODES = {
   ANDROID_LAUNCH_AM_START_FAILED: "ANDROID_LAUNCH_AM_START_FAILED",
   ANDROID_OPEN_URL_FAILED: "ANDROID_OPEN_URL_FAILED",
   ANDROID_REINSTALL_INSTALL_FAILED: "ANDROID_REINSTALL_INSTALL_FAILED",
+  ANDROID_REINSTALL_UNINSTALL_FAILED: "ANDROID_REINSTALL_UNINSTALL_FAILED",
   ANDROID_RESTART_FAILED: "ANDROID_RESTART_FAILED",
   ANDROID_SETTINGS_PERMISSION_FAILED: "ANDROID_SETTINGS_PERMISSION_FAILED",
   IOS_LAUNCH_SIMCTL_FAILED: "IOS_LAUNCH_SIMCTL_FAILED",
   IOS_OPEN_URL_FAILED: "IOS_OPEN_URL_FAILED",
   IOS_REINSTALL_INSTALL_FAILED: "IOS_REINSTALL_INSTALL_FAILED",
+  IOS_REINSTALL_UNINSTALL_FAILED: "IOS_REINSTALL_UNINSTALL_FAILED",
   IOS_RESTART_LAUNCH_FAILED: "IOS_RESTART_LAUNCH_FAILED",
+  IOS_RESTART_TERMINATE_FAILED: "IOS_RESTART_TERMINATE_FAILED",
+  IOS_TERMINATE_APP_FAILED: "IOS_TERMINATE_APP_FAILED",
   IOS_SETTINGS_PERMISSION_FAILED: "IOS_SETTINGS_PERMISSION_FAILED",
   IOS_SHAKE_FAILED: "IOS_SHAKE_FAILED",
   ANDROID_SHAKE_FAILED: "ANDROID_SHAKE_FAILED",
+  STOP_METRO_PORT_PROBE_FAILED: "STOP_METRO_PORT_PROBE_FAILED",
+  STOP_METRO_SIGNAL_FAILED: "STOP_METRO_SIGNAL_FAILED",
   // The hinge of a foldable iOS simulator: the server refused the request on a
   // foldable (a bad angle, a hinge that would not move) vs. nothing to fold —
   // a device that is not foldable, no hinge route, a remote simulator.
@@ -25987,10 +25993,13 @@ var FAILURE_CODES = {
   FLOW_NAME_INVALID: "FLOW_NAME_INVALID",
   FLOW_NO_ACTIVE_RECORDING: "FLOW_NO_ACTIVE_RECORDING",
   FLOW_FILE_INVALID: "FLOW_FILE_INVALID",
+  FLOW_FILE_NEWER_VERSION: "FLOW_FILE_NEWER_VERSION",
   FLOW_FILE_WRITE_FAILED: "FLOW_FILE_WRITE_FAILED",
   FLOW_ENTRY_UNRECOGNIZED: "FLOW_ENTRY_UNRECOGNIZED",
   FLOW_E2E_HAS_PREREQUISITE: "FLOW_E2E_HAS_PREREQUISITE",
   FLOW_DEVICE_RESOLUTION: "FLOW_DEVICE_RESOLUTION",
+  // The target does not satisfy the test's `requires:` block; a directory run skips it.
+  FLOW_REQUIREMENTS_UNMET: "FLOW_REQUIREMENTS_UNMET",
   PROFILER_QUERY_MODE_INVALID: "PROFILER_QUERY_MODE_INVALID",
   PROFILER_QUERY_REQUIRED_PARAM_MISSING: "PROFILER_QUERY_REQUIRED_PARAM_MISSING",
   PROFILER_DATA_NOT_LOADED: "PROFILER_DATA_NOT_LOADED",
@@ -26009,6 +26018,7 @@ var FAILURE_CODES = {
   CHROMIUM_STORAGE_EVAL_FAILED: "CHROMIUM_STORAGE_EVAL_FAILED",
   CHROMIUM_TAB_NOT_FOUND: "CHROMIUM_TAB_NOT_FOUND",
   CHROMIUM_TAB_OPEN_FAILED: "CHROMIUM_TAB_OPEN_FAILED",
+  CHROMIUM_NAVIGATE_FAILED: "CHROMIUM_NAVIGATE_FAILED",
   CHROMIUM_DESCRIBE_FAILED: "CHROMIUM_DESCRIBE_FAILED",
   CHROMIUM_ELECTRON_APP_PATH_INVALID: "CHROMIUM_ELECTRON_APP_PATH_INVALID",
   CHROMIUM_ELECTRON_SPAWN_FAILED: "CHROMIUM_ELECTRON_SPAWN_FAILED",
@@ -26025,6 +26035,8 @@ var FAILURE_CODES = {
   SCREENSHOT_DIFF_INPUT_INVALID: "SCREENSHOT_DIFF_INPUT_INVALID",
   BOOT_DEVICE_TARGET_SELECTION_INVALID: "BOOT_DEVICE_TARGET_SELECTION_INVALID",
   BOOT_IOS_UNSUPPORTED_HOST: "BOOT_IOS_UNSUPPORTED_HOST",
+  BOOT_IOS_SIMCTL_LIST_TIMEOUT: "BOOT_IOS_SIMCTL_LIST_TIMEOUT",
+  BOOT_IOS_SIMCTL_TIMEOUT: "BOOT_IOS_SIMCTL_TIMEOUT",
   BOOT_ANDROID_NO_AVDS: "BOOT_ANDROID_NO_AVDS",
   BOOT_ANDROID_AVD_NOT_FOUND: "BOOT_ANDROID_AVD_NOT_FOUND",
   BOOT_ANDROID_ADB_UNAVAILABLE: "BOOT_ANDROID_ADB_UNAVAILABLE",

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

@@ -10,7 +10,7 @@ export interface ArgentToolArgs {
         minStableMs?: number;
     };
     "await-ui-element": {
-        /** Target device id from `list-devices` (iOS UDID, Android serial, Vega serial, HarmonyOS id, or Chromium id; not Apple TV, whose tree it cannot read). */
+        /** Target device id from `list-devices` (iOS UDID, Android serial, Vega serial, HarmonyOS id, or Chromium id). */
         udid: string;
         /** What to wait for. `exists`: the selector matches an element anywhere in the tree. `visible`: it matches one with a non-zero on-screen frame. `hidden`: it matches nothing, or only a zero-area element (e.g. a spinner that went away). `text`: the first visible match in reading order (topmost, then leftmost; the first match overall if none is visible) contains expectedText, or equals it with textMatch `equals`. Only that match is checked, so if a loose selector hits several elements, narrow it to the one holding the text. */
         condition: "exists" | "visible" | "hidden" | "text";
@@ -231,9 +231,9 @@ export interface ArgentToolArgs {
         e2e_test_file?: string;
         /** Absolute path to an e2e test .yaml on the client. */
         e2e_test_path?: string;
-        /** Device id to run against (iOS UDID, Android/Vega serial, Chromium id), as list-devices reports it. Auto-detected when omitted, but only when exactly one booted device matches; with several booted the run fails and lists them, so pass this explicitly whenever more than one device is up. */
+        /** Device id to run against (iOS UDID, Android/Vega serial, Chromium id), as list-devices reports it. Auto-detected when omitted, but only when exactly one booted device matches (optionally narrowed by `platform` and the e2e test's `requires:` block); with several booted the run fails and lists them, so pass this explicitly whenever more than one device is up. */
         device?: string;
-        /** Restrict auto-detection to this platform when several devices are booted. `ios` selects local simulators only; `ios-remote` selects a remote one. `chromium` with no `device` also makes the runner boot an Electron instance for a standalone e2e test from its `launch` step's chromium value and tear it down after the run, with no fallback to auto-detection (a single-key `launch: { chromium: … }` map does this on its own; a fragment, or a launch map without a `chromium` key, is still auto-detected). That value must be an Electron app path on the tool-server host: the bare-string `launch:` the recorder writes holds a bundle id, which fails the run with `Electron boot: path does not exist`, so first edit it to `{ chromium: <app path> }`. */
+        /** Restrict auto-detection to this platform when several devices are booted. `ios` selects local simulators only; `ios-remote` selects a remote one. `chromium` with no `device` also makes the runner boot an Electron instance for a standalone e2e test from its `launch` step's chromium value and tear it down after the run, with no fallback to auto-detection (a single-key `launch: { chromium: … }` map, or a `requires:` block that allows only chromium, does this on its own; a fragment, or a launch map without a `chromium` key, is still auto-detected). That value must be an Electron app path on the tool-server host: the bare-string `launch:` the recorder writes holds a bundle id, which fails the run with `Electron boot: path does not exist`, so first edit it to `{ chromium: <app path> }`. */
         platform?: "ios" | "android" | "chromium" | "vega" | "ios-remote";
         /** Write/refresh screenshot baselines for `snapshot` steps instead of diffing against them, also in the e2e tests that tool: e2e-execute steps run, unless such a step sets updateBaselines itself. Over a link, the client writes the new baselines when the run ends. */
         updateBaselines?: boolean;
@@ -271,6 +271,11 @@ export interface ArgentToolArgs {
         project_root: string;
         /** Fragments only: the app/device state assumed on entry (e.g. "Settings app open on General page"). Omit it for a standalone e2e test. restart-app has no chromium support, so a chromium e2e test records as a fragment; add the `launch: { chromium: <app path> }` line to the YAML afterward, deleting the executionPrerequisite line if you passed one, since an e2e test that starts with a launch must not declare it. */
         executionPrerequisite?: string;
+        /** The e2e test's `requires:` block: the targets it supports, ANDed. `platform` is one platform or a list (`ios` also covers a remote simulator); `runtimeKind` is `tv` or `mobile`. Omit it for a test that runs on any target. */
+        requires?: {
+            platform?: "ios" | "android" | "chromium" | "vega" | Array<"ios" | "android" | "chromium" | "vega">;
+            runtimeKind?: "mobile" | "tv";
+        };
     };
     fill: {
         /** Target device id from `list-devices`. */
@@ -428,7 +433,7 @@ export interface ArgentToolArgs {
         bundleId: string;
         /** Android-only: fully-qualified Activity name (e.g. `.MainActivity` or `com.example/com.example.MainActivity`). If omitted, the app's default launcher activity is used. */
         activity?: string;
-        /** Apple simulators and physical iPhones: arguments passed to the app process at launch, e.g. `["-FeatureFlag", "YES"]` to override UserDefaults. A running app is relaunched to apply them. */
+        /** Apple simulators and physical iPhones: arguments passed to the app process at launch, e.g. `["-FeatureFlag", "YES"]` to override UserDefaults. A running app is relaunched to apply them. The call fails, launching nothing, if terminating it does not finish within 15s on a local iOS simulator, or fails for a reason other than the app not running on a remote one. */
         launchArgs?: Array<string>;
     };
     "list-devices": Record<string, never>;