@swmansion/argent 0.25.1-next.31 → 0.25.1-next.33

package/dist/cli-cmds.mjs

@@ -21857,7 +21857,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID2 = randomUUID5();
 function readCliVersion() {
   if (true) {
-    return "0.25.1-next.31";
+    return "0.25.1-next.33";
   }
   return "0.0.0";
 }
@@ -23461,7 +23461,10 @@ async function exportFailureArtifacts(report, outputDir, flowPath, ctx) {
         if (dirName === null) return;
         dir = path14.join(outputDir, dirName);
       }
-      const dest = path14.join(dir, `${key}-${role}.png`);
+      const dest = path14.join(
+        dir,
+        `${key}${s.snapshotRemote === true ? "-remote" : ""}-${role}.png`
+      );
       const rel = path14.relative(outputDir, dest);
       if (rel.startsWith("..") || path14.isAbsolute(rel)) continue;
       try {

package/dist/installer.mjs

@@ -16710,7 +16710,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID = randomUUID4();
 function readCliVersion() {
   if (true) {
-    return "0.25.1-next.31";
+    return "0.25.1-next.33";
   }
   return "0.0.0";
 }

package/dist/tool-server.cjs

@@ -94704,7 +94704,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID = (0, import_node_crypto3.randomUUID)();
 function readCliVersion() {
   if (true) {
-    return "0.25.1-next.31";
+    return "0.25.1-next.33";
   }
   return "0.0.0";
 }
@@ -96676,8 +96676,8 @@ async function run(args, options) {
     throw new Error(`sim-remote ${args.join(" ")} failed: ${suffix}`, { cause: err });
   }
 }
-async function simctlListDevices() {
-  const { stdout } = await run(["simctl", "list", "devices", "--json"]);
+async function simctlListDevices(options) {
+  const { stdout } = await run(["simctl", "list", "devices", "--json"], options);
   try {
     return JSON.parse(stdout);
   } catch (err) {
@@ -96688,12 +96688,12 @@ async function simctlListDevices() {
   }
 }
 var remoteRuntimeKindCache = /* @__PURE__ */ new Map();
-async function isRemoteTvOsSimulator(udid) {
+async function isRemoteTvOsSimulator(udid, options) {
   const id = stripRemotePrefix(udid);
   const cached3 = remoteRuntimeKindCache.get(id);
   if (cached3) return cached3 === "tv";
   try {
-    const { devices } = await simctlListDevices();
+    const { devices } = await simctlListDevices(options);
     for (const [runtime, entries] of Object.entries(devices)) {
       if (!entries.some((d) => d.udid === id)) continue;
       const kind = runtime.includes("tvOS") ? "tv" : "mobile";
@@ -96735,6 +96735,9 @@ async function simctlOpenUrl(udid, url2) {
 async function simctlPrivacy(udid, action, service, bundleId) {
   await run(["simctl", "privacy", stripRemotePrefix(udid), action, service, bundleId]);
 }
+async function simctlStatusBar(udid, args, options) {
+  await run(["simctl", "status_bar", stripRemotePrefix(udid), ...args], options);
+}
 async function simctlPbcopy(udid, text) {
   await run(["simctl", "pbcopy", stripRemotePrefix(udid)], { stdin: text });
 }
@@ -125765,7 +125768,7 @@ init_adb();
 
 // ../tool-server/src/utils/poll-describe-tree.ts
 async function pollDescribeTree(args) {
-  const { fetchTree: fetchTree2, timeoutMs, pollIntervalMs, signal, onSample } = args;
+  const { fetchTree, timeoutMs, pollIntervalMs, signal, onSample } = args;
   const start2 = Date.now();
   const deadline = start2 + timeoutMs;
   let polls = 0;
@@ -125784,7 +125787,7 @@ async function pollDescribeTree(args) {
   for (; ; ) {
     if (signal?.aborted) return outcome(void 0, true);
     const remaining = Math.max(0, deadline - Date.now());
-    const settled = await settleWithin(fetchTree2(), remaining, signal);
+    const settled = await settleWithin(fetchTree(), remaining, signal);
     polls += 1;
     if (settled.type === "aborted") return outcome(void 0, true);
     lastAttemptSettled = settled.type !== "timeout";
@@ -131945,23 +131948,6 @@ function deriveSelector(node) {
   if (node.role && !GENERIC_ROLES.has(node.role.toLowerCase())) return { role: node.role };
   return null;
 }
-async function fetchTree(registry2, device, opts = {}) {
-  if (device.platform === "ios" || device.platform === "ios-remote") {
-    return describeIos(registry2, device, { bundleId: opts.bundleId });
-  }
-  if (device.platform === "android") {
-    return describeAndroid(registry2, device.id);
-  }
-  if (device.platform === "chromium") {
-    const ref = chromiumCdpRef(device);
-    const api = await registry2.resolveService(ref.urn, ref.options);
-    return describeChromium(api);
-  }
-  if (device.platform === "vega") {
-    return describeVega(device.id);
-  }
-  throw new Error(`ui-tree matching is not supported on platform "${device.platform}"`);
-}
 
 // ../tool-server/src/tools/await-ui-element/index.ts
 var AWAIT_UI_ELEMENT_TOOL_ID = "await-ui-element";
@@ -132076,7 +132062,7 @@ function timeoutNote(params, lastTree, fetchError, lastData) {
   return appendDiagnostics(base, lastData);
 }
 function createAwaitUiElementTool(registry2) {
-  async function fetchTree2(device, params, services, isTvOs, androidIsTv) {
+  async function fetchTree(device, params, services, isTvOs, androidIsTv) {
     if (device.platform === "ios" || device.platform === "ios-remote") {
       if (device.kind === "device") {
         return describeIosDevice(registry2, device);
@@ -132158,7 +132144,7 @@ tap/navigation to wait for the next screen, or before tapping an element that ap
       let everMatched = false;
       let lastTrustedReadAt;
       const poll = await pollDescribeTree({
-        fetchTree: () => fetchTree2(device, params, services, isTvOs, androidIsTv),
+        fetchTree: () => fetchTree(device, params, services, isTvOs, androidIsTv),
         timeoutMs,
         pollIntervalMs,
         signal,
@@ -134831,7 +134817,7 @@ function treeSignature(root) {
   return parts2.join("\n");
 }
 function createAwaitScreenIdleTool(registry2) {
-  function fetchTree2(device, services, isTvOs, androidIsTv) {
+  function fetchTree(device, services, isTvOs, androidIsTv) {
     if (device.platform === "ios" || device.platform === "ios-remote") {
       if (device.kind === "device") {
         return describeIosDevice(registry2, device);
@@ -134879,7 +134865,7 @@ still before the timeout. Use after a launch/navigation to wait for the UI to re
       let stableSignature;
       let stableSince = 0;
       const poll = await pollDescribeTree({
-        fetchTree: () => fetchTree2(device, services, isTvOs, androidIsTv),
+        fetchTree: () => fetchTree(device, services, isTvOs, androidIsTv),
         timeoutMs: params.timeoutMs ?? DEFAULT_TIMEOUT_MS4,
         pollIntervalMs: params.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS2,
         signal: ctx?.signal,
@@ -148174,9 +148160,7 @@ async function queryVegaTree(device) {
 
 // ../tool-server/src/tools/flows/flow-tree.ts
 async function fetchFlowTree(registry2, device, target) {
-  const source = FLOW_TREE_SOURCES[device.platform];
-  if (!source) return fetchTree(registry2, device);
-  return source(registry2, device, target);
+  return FLOW_TREE_SOURCES[device.platform](registry2, device, target);
 }
 var FLOW_TREE_SOURCES = {
   // Simulator iOS uses the injected hierarchy and an optional target.
@@ -148192,9 +148176,6 @@ var FLOW_TREE_SOURCES = {
   "chromium": (registry2, device) => queryChromiumTree(registry2, device),
   "vega": (_registry, device) => queryVegaTree(device)
 };
-function supportsFlowTree(platform) {
-  return FLOW_TREE_SOURCES[platform] !== void 0;
-}
 
 // ../tool-server/src/tools/flows/flow-pixels.ts
 var fs53 = __toESM(require("node:fs/promises"));
@@ -148225,10 +148206,14 @@ var FIRST_CAPTURE_COMPLETION_MARGIN_MS = 500;
 var FIRST_PIXEL_CAPTURE_TIMEOUT_MS = FIRST_FRAME_WAIT_MS + FIRST_CAPTURE_COMPLETION_MARGIN_MS;
 var PIXEL_CAPTURE_TIMEOUT_MS = 2e3;
 var IOS_DEVICE_PIXEL_CAPTURE_TIMEOUT_MS = 4e3;
+var REMOTE_PIXEL_CAPTURE_TIMEOUT_MS = 4e3;
 function pixelCaptureTimeoutMs(device, firstCapture) {
   if (isIosPhysicalDevice(device)) {
     return IOS_DEVICE_PIXEL_CAPTURE_TIMEOUT_MS;
   }
+  if (device.platform === "ios-remote" && !firstCapture) {
+    return REMOTE_PIXEL_CAPTURE_TIMEOUT_MS;
+  }
   const warmFromTheStart = device.platform === "chromium" || device.platform === "vega";
   return firstCapture && !warmFromTheStart ? FIRST_PIXEL_CAPTURE_TIMEOUT_MS : PIXEL_CAPTURE_TIMEOUT_MS;
 }
@@ -148638,12 +148623,10 @@ async function runDirective(env, step) {
 }
 async function settleForGesture(env) {
   let warning;
-  if (supportsFlowTree(env.device.platform)) {
-    try {
-      await settleTree(env, { skipProvenOutage: true });
-    } catch (err) {
-      warning = unsettledGestureWarning(err);
-    }
+  try {
+    await settleTree(env, { skipProvenOutage: true });
+  } catch (err) {
+    warning = unsettledGestureWarning(err);
   }
   if (env.signal?.aborted) return { aborted: true };
   return warning !== void 0 ? { warning } : {};
@@ -149526,9 +149509,6 @@ function fallbackSourceWarning(source, platform) {
 function platformOf(udid) {
   return typeof udid === "string" ? authoringPlatform(resolveDevice(udid).platform) : void 0;
 }
-function hasRunnerTree(udid) {
-  return typeof udid === "string" && supportsFlowTree(resolveDevice(udid).platform);
-}
 var UNSUPPORTED_PLATFORM = {
   divergence: "The recorder and the runner read different projections of the screen.",
   read: "No read-only tool is known to report the runner's projection on this platform \u2014 keep the step raw"
@@ -149602,7 +149582,6 @@ function unmetWaitWarningFor(cause) {
 }
 function indeterminateReasonCaveat(udid) {
   if (platformOf(udid) !== "ios") return "";
-  if (!hasRunnerTree(udid)) return "";
   return ". One thing that reason cannot see is this step: the probe predicts an `await:`/`assert:` directive, and no directive takes a bundleId, so neither this probe nor the runner accepts one (the `bundleId` on this step reached the live wait only)";
 }
 var CANCELLED_PROBE_WARNING = "recorded, but the re-probe against the tree the RUNNER reads was cancelled before it answered. The step itself ran and is written to the flow; only the verdict is missing, so whether it would convert to `await:`/`assert:` is UNKNOWN, not known-bad \u2014 record the wait again, uncancelled, before trusting the conversion";
@@ -149667,9 +149646,8 @@ async function probeAgainstRunnerTree(registry2, ctx, args) {
       // The reason is quoted whole rather than through `cappedReason`; see
       // {@link MAX_PROBE_REASON_CHARS}.
       warning: `this check could not be re-verified against the tree the RUNNER reads (${outcome.reason ?? "no reason given"}), so it passed against the tree \`${AWAIT_UI_ELEMENT_TOOL_ID}\` reads and nothing else. Whether it would convert to \`await:\`/\`assert:\` is UNKNOWN, not known-bad \u2014 ` + // A timeout and an outage need different next moves: "once that tree
-      // source is back" is nonsense for a source that never left, and for one
-      // that never existed.
-      (timedOut2 ? `re-record this step when the device is quieter, or settle the conversion directly by putting the directive in a flow and running \`flow-execute\`, which has no such ceiling` : (hasRunnerTree(args.udid) ? `re-probe once that tree source is back before trusting the conversion` : `this platform's runner has no tree to probe, so the conversion stays unverified`) + indeterminateReasonCaveat(args.udid))
+      // source is back" is nonsense for a source that never left.
+      (timedOut2 ? `re-record this step when the device is quieter, or settle the conversion directly by putting the directive in a flow and running \`flow-execute\`, which has no such ceiling` : `re-probe once that tree source is back before trusting the conversion` + indeterminateReasonCaveat(args.udid))
     };
   }
   return {
@@ -153885,7 +153863,7 @@ async function runSnapshot(env, opts) {
   });
   const { w, h } = await pngDimensions(shot.image.hostPath);
   const cropSuffix = opts.cropOn === void 0 ? "" : `-crop-${(0, import_node_crypto12.createHash)("sha256").update(cropIdentity(opts.cropOn)).digest("hex").slice(0, 8)}`;
-  const snapshotKey = `${opts.name}__${env.device.platform}-${w}x${h}${cropSuffix}`;
+  const snapshotKey = `${opts.name}__${authoringPlatform(env.device.platform)}-${w}x${h}${cropSuffix}`;
   const key2 = `${snapshotKey}.png`;
   const dir = baselineDir(opts.flowsDir, opts.flowName);
   const baselinePath = path44.join(dir, key2);
@@ -153936,9 +153914,10 @@ async function runSnapshot(env, opts) {
         kind: "screenshot",
         mimeType: "image/png"
       });
+      const source = env.device.platform === "ios-remote" ? " from a remote simulator" : "";
       return {
         status: "pass",
-        reason: exists2 ? `baseline updated (${key2})` : `baseline written (${key2})`,
+        reason: exists2 ? `baseline updated${source} (${key2})` : `baseline written${source} (${key2})`,
         snapshotKey,
         artifacts: { baseline }
       };
@@ -154024,30 +154003,41 @@ init_adb();
 init_device_info();
 var execFileAsync27 = (0, import_node_util25.promisify)(import_node_child_process35.execFile);
 var DEMO_BROADCAST = "am broadcast -a com.android.systemui.demo";
-async function pinStatusBar(device) {
+var IOS_STATUS_BAR_OVERRIDE = [
+  "override",
+  "--time",
+  "9:37",
+  "--batteryState",
+  "charged",
+  "--batteryLevel",
+  "100",
+  "--wifiBars",
+  "3",
+  "--cellularBars",
+  "4"
+];
+var REMOTE_STATUS_BAR_TIMEOUT_MS = 5e3;
+function isRemoteTvOs(device) {
+  return isRemoteTvOsSimulator(device.id, { timeoutMs: REMOTE_STATUS_BAR_TIMEOUT_MS });
+}
+async function pinStatusBar(device, signal) {
+  if (signal?.aborted) return false;
   if (isIosPhysicalDevice(device)) return false;
   try {
     if (device.platform === "ios") {
       await execFileAsync27(
         "xcrun",
-        await simctlArgsForUdid(device.id, [
-          "status_bar",
-          device.id,
-          "override",
-          "--time",
-          "9:37",
-          "--batteryState",
-          "charged",
-          "--batteryLevel",
-          "100",
-          "--wifiBars",
-          "3",
-          "--cellularBars",
-          "4"
-        ])
+        await simctlArgsForUdid(device.id, ["status_bar", device.id, ...IOS_STATUS_BAR_OVERRIDE])
       );
       return true;
     }
+    if (device.platform === "ios-remote") {
+      if (await isRemoteTvOs(device)) return false;
+      await simctlStatusBar(device.id, IOS_STATUS_BAR_OVERRIDE, {
+        timeoutMs: REMOTE_STATUS_BAR_TIMEOUT_MS
+      });
+      return true;
+    }
     if (device.platform === "android") {
       await adbShell(device.id, "settings put global sysui_demo_allowed 1");
       await adbShell(device.id, `${DEMO_BROADCAST} -e command enter`);
@@ -154065,7 +154055,7 @@ async function pinStatusBar(device) {
     return false;
   } catch {
     const restored = await restoreStatusBar(device);
-    return device.platform === "android" && !restored;
+    return (device.platform === "android" || device.platform === "ios-remote") && !restored;
   }
 }
 async function restoreStatusBar(device) {
@@ -154075,6 +154065,10 @@ async function restoreStatusBar(device) {
         "xcrun",
         await simctlArgsForUdid(device.id, ["status_bar", device.id, "clear"])
       );
+    } else if (device.platform === "ios-remote") {
+      if (!await isRemoteTvOs(device)) {
+        await simctlStatusBar(device.id, ["clear"], { timeoutMs: REMOTE_STATUS_BAR_TIMEOUT_MS });
+      }
     } else if (device.platform === "android") {
       try {
         await adbShell(device.id, `${DEMO_BROADCAST} -e command exit`);
@@ -154583,7 +154577,7 @@ Returns a per-step report: the first failure stops the run and the rest report a
         viaUpload
       );
       const device = resolved.device;
-      const statusBarPinned = device !== null && await pinStatusBar(device);
+      const statusBarPinned = device !== null && await pinStatusBar(device, signal);
       if (device?.platform === "chromium") await frontChromiumPage(registry2, device);
       const state3 = {
         registry: registry2,
@@ -155109,6 +155103,7 @@ async function execLeafStep(state3, step, index, scope) {
           status: r.status,
           reason: r.reason,
           snapshotKey: r.snapshotKey,
+          ...r.snapshotKey !== void 0 && state3.device?.platform === "ios-remote" ? { snapshotRemote: true } : {},
           artifacts: r.artifacts
         };
       } catch (err) {

package/package.json

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

package/skills/argent-create-flow/references/flow-yaml.md

@@ -255,7 +255,7 @@ A screenshot is human evidence. A `snapshot:` is executable visual verification.
 
 Do not use a snapshot as the only proof of navigation, persistence, data, accessibility state, logs, or network behavior. Avoid unstable timestamps, live data, ads, animation, and device drift. First establish deterministic state, identity, and readiness.
 
-Baselines live under `.argent/flows/__baselines__/<flow>/` and are keyed by platform and full-capture geometry; `cropOn` also contributes its selector. Seed from a known-good state with `--update-baselines`. Inspect every baseline and require user review. Do not commit it yourself. Baseline creation or update is not a test pass. Never update a baseline only to make a diff pass. The default `maxMismatch` is 0.5 percent.
+Baselines live under `.argent/flows/__baselines__/<flow>/` and are keyed by platform and full-capture geometry; `cropOn` also contributes its selector. A run on a remote simulator uses `ios` in the key, so it uses the same baseline as a local iOS run with the same capture geometry. Seed from a known-good state with `--update-baselines`. A run on a remote simulator with `--update-baselines` rewrites the same baseline file that a local run uses, and its step reason says that a remote simulator wrote it. Inspect every baseline and require user review. Do not commit it yourself. Baseline creation or update is not a test pass. Never update a baseline only to make a diff pass. The default `maxMismatch` is 0.5 percent.
 
 Pin `--platform` and `--device` for iOS, Android, or Vega. For Chromium the device class is the window's own pixel size, which the app sets and no launch argument changes: pass `--platform chromium` and omit `--device` so the runner boots the declared app path instead of attaching to a running window of another size. A window sized from host or session state produces a key CI cannot reproduce, and the step fails for a missing baseline. The runner pins mobile status bars during visual runs. `--output <dir>` writes failed baseline, current, and diff images under `<dir>/<flow>/` for CI artifact upload.