@swmansion/argent 0.25.1-next.32 → 0.25.1-next.34

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.32";
+    return "0.25.1-next.34";
   }
   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.32";
+    return "0.25.1-next.34";
   }
   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.32";
+    return "0.25.1-next.34";
   }
   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 });
 }
@@ -107261,6 +107264,7 @@ async function openMoqClient(udid) {
 async function openMoqClientFromInfo(info) {
   await installNodeWebTransport();
   const session = new MoqDeviceSession(await connectMoq(info), { publishPath: PUBLISH_PATH });
+  disposeWhenTransportDies(session);
   return {
     sendControl: (payload) => session.sendControl(payload),
     async screenshot(opts) {
@@ -107271,6 +107275,15 @@ async function openMoqClientFromInfo(info) {
     }
   };
 }
+function disposeWhenTransportDies(session) {
+  const dispose = () => {
+    try {
+      session.close();
+    } catch {
+    }
+  };
+  void session.closed.then(dispose, dispose);
+}
 
 // ../tool-server/src/utils/simulator-client.ts
 init_wrapper();
@@ -107339,17 +107352,26 @@ function failAllPending(conn, makeError) {
   conn.pending.clear();
   for (const entry of entries) entry.settle(makeError(entry.cmd));
 }
+var COMMAND_TRANSPORT_FAILURE = {
+  error_code: FAILURE_CODES.SIMULATOR_COMMAND_TRANSPORT_FAILED,
+  failure_stage: "simulator_command_transport",
+  failure_area: "tool_server",
+  error_kind: "network",
+  network_failure: "connection_reset",
+  failure_command: "simulator_server"
+};
 function transportError(cmd, apiUrl, detail) {
   return new FailureError(
     `simulator-server did not accept the '${cmd}' command: ${detail}. The command was NOT delivered to the device. Check that the simulator is still booted and the simulator-server for ${apiUrl} is running.`,
-    {
-      error_code: FAILURE_CODES.SIMULATOR_COMMAND_TRANSPORT_FAILED,
-      failure_stage: "simulator_command_transport",
-      failure_area: "tool_server",
-      error_kind: "network",
-      network_failure: "connection_reset",
-      failure_command: "simulator_server"
-    }
+    COMMAND_TRANSPORT_FAILURE
+  );
+}
+function remoteTransportError(cmd, cause) {
+  const detail = cause instanceof Error ? cause.message : String(cause);
+  return wrapFailure(
+    cause,
+    COMMAND_TRANSPORT_FAILURE,
+    `The remote simulator did not accept the '${cmd}' command: ${detail}. The command was NOT delivered to the device. Call stop-simulator-server for this device and retry - the next call opens a new cloud session. If the machine itself was released, acquire one again before retrying.`
   );
 }
 function getOrCreateConnection(api) {
@@ -107405,13 +107427,10 @@ function getOrCreateConnection(api) {
   return conn;
 }
 function sendCommand(api, cmd) {
-  if (api.transport) {
-    routeViaTransport(api.transport, cmd);
-    return Promise.resolve();
-  }
+  const cmdName = typeof cmd.cmd === "string" ? cmd.cmd : "unknown";
+  if (api.transport) return sendViaTransport(api.transport, cmd, cmdName);
   const conn = getOrCreateConnection(api);
   const id = String(++cmdId);
-  const cmdName = typeof cmd.cmd === "string" ? cmd.cmd : "unknown";
   const payload = JSON.stringify({ id, ...cmd });
   return new Promise((resolve14, reject) => {
     let done = false;
@@ -107613,32 +107632,36 @@ async function httpScreenshot(api, rotation, signal, scale) {
     );
   }
 }
+async function sendViaTransport(transport, cmd, cmdName) {
+  const sent = routeViaTransport(transport, cmd);
+  try {
+    await sent;
+  } catch (cause) {
+    throw remoteTransportError(cmdName, cause);
+  }
+}
 function routeViaTransport(transport, cmd) {
   switch (cmd.cmd) {
     case "touch": {
       const sx = cmd.second_x ?? cmd.secondX;
       const sy = cmd.second_y ?? cmd.secondY;
-      transport.touch({
+      return transport.touch({
         type: cmd.type,
         x: cmd.x,
         y: cmd.y,
         secondX: sx == null ? void 0 : sx,
         secondY: sy == null ? void 0 : sy
       });
-      return;
     }
     case "button":
-      transport.button({
+      return transport.button({
         direction: cmd.direction,
         button: cmd.button
       });
-      return;
     case "rotate":
-      transport.rotate(cmd.direction);
-      return;
+      return transport.rotate(cmd.direction);
     case "key":
-      transport.pressKey(cmd.direction, cmd.code);
-      return;
+      return transport.pressKey(cmd.direction, cmd.code);
     default:
       throw new Error(`MoQ transport does not implement sendCommand cmd '${String(cmd.cmd)}'`);
   }
@@ -107652,8 +107675,8 @@ function createMoqTransport(moq, options) {
     return { url: (0, import_node_url.pathToFileURL)(file2).toString(), path: file2 };
   };
   return {
-    touch(opts) {
-      void moq.sendControl(
+    async touch(opts) {
+      await moq.sendControl(
         encodeTouch({
           action: opts.type,
           x: opts.x,
@@ -107663,17 +107686,17 @@ function createMoqTransport(moq, options) {
         })
       );
     },
-    button(opts) {
-      void moq.sendControl(encodeButton({ action: opts.direction, button: opts.button }));
+    async button(opts) {
+      await moq.sendControl(encodeButton({ action: opts.direction, button: opts.button }));
     },
-    rotate(direction) {
-      void moq.sendControl(encodeRotate(direction));
+    async rotate(direction) {
+      await moq.sendControl(encodeRotate(direction));
     },
     async paste(text) {
       await options.pasteText(text);
     },
-    pressKey(direction, keyCode) {
-      void moq.sendControl(encodeKey({ action: direction, code: keyCode }));
+    async pressKey(direction, keyCode) {
+      await moq.sendControl(encodeKey({ action: direction, code: keyCode }));
     },
     async screenshot(opts) {
       const scale = opts?.scale ?? getScreenshotScale();
@@ -107706,17 +107729,20 @@ async function buildRemoteInstance(device) {
       await simctlPbcopy(device.id, text);
       const CMD = 227;
       const V = 25;
-      await moq.sendControl(encodeKey({ action: "Down", code: CMD }));
-      await moq.sendControl(encodeKey({ action: "Down", code: V }));
-      await moq.sendControl(encodeKey({ action: "Up", code: V }));
-      await moq.sendControl(encodeKey({ action: "Up", code: CMD }));
+      await api.pressKey("Down", CMD);
+      await api.pressKey("Down", V);
+      await api.pressKey("Up", V);
+      await api.pressKey("Up", CMD);
     }
   });
   const stubUrl = `moq+remote://${device.id}`;
   const api = {
     apiUrl: stubUrl,
     streamUrl: stubUrl,
-    pressKey: (direction, keyCode) => moq.sendControl(encodeKey({ action: direction, code: keyCode })),
+    // Through `sendCommand`, as the attached instance below does, so a key the
+    // session refuses reports the same failure as a refused touch instead of a
+    // bare SDK error the caller cannot classify.
+    pressKey: (direction, keyCode) => sendCommand(api, { cmd: "key", code: keyCode, direction }),
     transport
   };
   return {
@@ -148203,10 +148229,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;
 }
@@ -153856,7 +153886,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);
@@ -153907,9 +153937,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 }
       };
@@ -153995,30 +154026,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`);
@@ -154036,7 +154078,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) {
@@ -154046,6 +154088,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`);
@@ -154554,7 +154600,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,
@@ -155080,6 +155126,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.32",
+  "version": "0.25.1-next.34",
   "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.