@swmansion/argent 0.25.3-next.2 → 0.25.3-next.4

package/dist/cli-cmds.mjs

@@ -2342,6 +2342,11 @@ var FAILURE_CODES = {
   IOS_SETTINGS_PERMISSION_FAILED: "IOS_SETTINGS_PERMISSION_FAILED",
   IOS_SHAKE_FAILED: "IOS_SHAKE_FAILED",
   ANDROID_SHAKE_FAILED: "ANDROID_SHAKE_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.
+  IOS_FOLD_FAILED: "IOS_FOLD_FAILED",
+  IOS_FOLD_UNSUPPORTED: "IOS_FOLD_UNSUPPORTED",
   PASTE_CLIPBOARD_SET_FAILED: "PASTE_CLIPBOARD_SET_FAILED",
   PASTE_CLIPBOARD_UNSUPPORTED: "PASTE_CLIPBOARD_UNSUPPORTED",
   SETTINGS_PERMISSION_UNSUPPORTED: "SETTINGS_PERMISSION_UNSUPPORTED",
@@ -21872,7 +21877,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID2 = randomUUID5();
 function readCliVersion() {
   if (true) {
-    return "0.25.3-next.2";
+    return "0.25.3-next.4";
   }
   return "0.0.0";
 }
@@ -23214,13 +23219,14 @@ 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
-warning, and each script step's output), then its outcome, then a final flow
-summary; --recursive walks subdirectories too (dot-directories and node_modules
-are skipped). A flow that fails its steps keeps the batch running, as does one
-the server rejects up front \u2014 an invalid 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 flows
-skipped.
+warning, and each script step's output), then its outcome. After the last flow
+it lists every failed flow with its reason and a command that re-runs that flow
+alone, then a final flow summary; --recursive walks subdirectories too
+(dot-directories and node_modules are skipped). A flow that fails its steps
+keeps the batch running, as does one the server rejects up front \u2014 an invalid
+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 flows skipped.
 
 Runs require the auto-started local tool server;
 ARGENT_TOOLS_URL and \`argent link\` routing are not supported.
@@ -23306,13 +23312,15 @@ function renderEchoLine(s) {
   }
   return `  ${indent}\u203A ${s.message}`;
 }
-function renderStepLine(s, n2, topFlow) {
+function stepLabel(s, topFlow) {
   const where = s.flow && s.flow !== topFlow ? ` [${s.flow}]` : "";
   const what = s.tool ?? s.target;
-  const label = what ? `${s.kind} ${what}` : s.kind;
+  return `${what ? `${s.kind} ${what}` : s.kind}${where}`;
+}
+function renderStepLine(s, n2, topFlow) {
   const reason = s.reason ? ` \u2014 ${s.reason}` : "";
   const glyph = s.status === "pass" && s.warning ? "\u26A0" : STATUS_GLYPH[s.status];
-  return `  ${glyph} ${String(n2).padStart(2)} ${stepIndent(s.depth)}${label}${where}${durationSuffix(s.durationMs)}${reason}`;
+  return `  ${glyph} ${String(n2).padStart(2)} ${stepIndent(s.depth)}${stepLabel(s, topFlow)}${durationSuffix(s.durationMs)}${reason}`;
 }
 function renderUnderStepLine(s, n2, text2) {
   return `${" ".repeat(5 + Math.max(2, String(n2).length))}${stepIndent(s.depth)}${text2}`;
@@ -23376,6 +23384,35 @@ function renderFailedSteps(report) {
 function renderBatchSummary(counts, durationMs) {
   return `${counts.failed === 0 ? "PASS" : "FAIL"} \u2014 ${counts.total} flow${counts.total === 1 ? "" : "s"}: ${counts.passed} passed, ${counts.failed} failed, ${counts.skipped} skipped${durationSuffix(durationMs)}`;
 }
+function summarizeFailure(report) {
+  let n2 = 0;
+  for (const s of report.steps) {
+    if (s.kind === "echo") continue;
+    n2++;
+    if (s.status === "fail" || s.status === "error") {
+      const detail = s.reason ? String(s.reason) : void 0;
+      return { headline: `step ${n2} ${stepLabel(s, report.flow)}`, detail };
+    }
+  }
+  return { headline: "failed with no failing step" };
+}
+function renderFailedFlow(f) {
+  const lines = [`  ${STATUS_GLYPH.fail} ${f.path ? `${f.path} \u203A ` : ""}${f.headline}`];
+  for (const line of f.detail?.split("\n") ?? []) if (line) lines.push(`    ${line}`);
+  if (f.rerun) lines.push(`    re-run: ${f.rerun}`);
+  return lines;
+}
+function renderSingleFailure(report) {
+  return report.ok ? [] : ["", ...renderFailedFlow(summarizeFailure(report))];
+}
+function renderFailedFlows(failed) {
+  if (failed.length === 0) return [];
+  return [
+    "",
+    `Failed flows (${failed.length})`,
+    ...failed.flatMap((f) => ["", ...renderFailedFlow(f)])
+  ];
+}
 var SAFE_ARTIFACT_NAME = FLOW_NAME_PATTERN;
 var SAFE_FLOW_NAME = FLOW_NAME_PATTERN;
 var FLOWS_DIR = path14.join(".argent", "flows");
@@ -23384,6 +23421,17 @@ function shellQuoteArg(arg) {
   if (SHELL_SAFE_ARG.test(arg)) return arg;
   return `'${arg.replaceAll("'", "'\\''")}'`;
 }
+function rerunCommand(flowPath, rel, projectRoot, args) {
+  const pathArg = (p) => shellQuoteArg(p.startsWith("-") ? `.${path14.sep}${p}` : p);
+  const fromCwd = path14.relative(projectRoot, flowPath);
+  const shown = path14.isAbsolute(fromCwd) || fromCwd.split(/[\\/]+/).includes("..") ? flowPath : fromCwd;
+  const parts = ["argent flow run", pathArg(shown)];
+  if (args.device) parts.push("--device", shellQuoteArg(args.device));
+  if (args.platform) parts.push("--platform", shellQuoteArg(args.platform));
+  if (args.updateBaselines) parts.push("--update-baselines");
+  if (args.output) parts.push("--output", pathArg(path14.join(args.output, path14.dirname(rel))));
+  return parts.join(" ");
+}
 var EXPORT_SOURCE_MARKER = ".argent-flow-source";
 var MARKER_READ_RETRIES = 4;
 var MARKER_READ_DELAY_MS = 5;
@@ -23541,6 +23589,7 @@ function renderReport(report) {
       }
     }
   }
+  lines.push(...renderSingleFailure(report));
   lines.push(`
 ${renderSummary(report)}`);
   return lines.join("\n");
@@ -23689,6 +23738,7 @@ async function runFlowDirectory(dir, args, projectRoot, options) {
   const { callTool, baseUrl } = createToolsClient({ paths: options.paths });
   const outputBase = args.output ? path14.resolve(args.output) : void 0;
   const results = [];
+  const failures = [];
   const batchStartedAt = Date.now();
   let stopped = false;
   for (const [i2, rel] of flows.entries()) {
@@ -23698,42 +23748,42 @@ async function runFlowDirectory(dir, args, projectRoot, options) {
       if (!args.json) console.log(`  ${STATUS_GLYPH.skip} not run (batch stopped)`);
       continue;
     }
+    const flowPath = path14.join(dir, rel);
+    const rerun = rerunCommand(flowPath, rel, projectRoot, args);
     let report;
     try {
-      const resp = await callTool(
-        "flow-execute",
-        buildRunPayload(path14.join(dir, rel), projectRoot, args)
-      );
+      const resp = await callTool("flow-execute", buildRunPayload(flowPath, projectRoot, args));
       if (isFlowReport(resp.data)) report = resp.data;
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
       const toolErr = err instanceof ToolInvocationError ? err : void 0;
       const rejectedThisFlowOnly = toolErr?.errorKind === "validation";
-      if (!args.json) {
-        console.log(
-          `  ${STATUS_GLYPH.error} ` + (rejectedThisFlowOnly ? rejectionVerdict(toolErr?.errorCode) : "did not finish (run error)")
-        );
-      }
+      const verdict = rejectedThisFlowOnly ? rejectionVerdict(toolErr?.errorCode) : "did not finish (run error)";
+      if (!args.json) console.log(`  ${STATUS_GLYPH.error} ${verdict}`);
       console.error(message);
       results.push({ path: rel, status: "fail", error: message, ...failureSignal2(err) });
+      failures.push({ path: rel, headline: verdict, detail: message, rerun });
       if (!rejectedThisFlowOnly) stopped = true;
       continue;
     }
     if (!report) {
       const message = `"${rel}" did not produce a run report.`;
-      if (!args.json) console.log(`  ${STATUS_GLYPH.error} did not finish (no run report)`);
+      const verdict = "did not finish (no run report)";
+      if (!args.json) console.log(`  ${STATUS_GLYPH.error} ${verdict}`);
       console.error(message);
       results.push({ path: rel, status: "fail", error: message });
+      failures.push({ path: rel, headline: verdict, detail: message, rerun });
       stopped = true;
       continue;
     }
     await exportAndResolveArtifacts(
       report,
       outputBase ? path14.join(outputBase, path14.dirname(rel)) : void 0,
-      path14.join(dir, rel),
+      flowPath,
       baseUrl
     );
     results.push({ path: rel, status: report.ok ? "pass" : "fail", report });
+    if (!report.ok) failures.push({ path: rel, ...summarizeFailure(report), rerun });
     if (!args.json) {
       for (const line of renderFailedSteps(report)) console.log(line);
       console.log(`  ${renderSummary(report, { withDevice: true })}`);
@@ -23751,6 +23801,7 @@ async function runFlowDirectory(dir, args, projectRoot, options) {
       JSON.stringify({ ok: counts.failed === 0, ...counts, durationMs, flows: results }, null, 2)
     );
   } else {
+    for (const line of renderFailedFlows(failures)) console.log(line);
     console.log(`
 ${renderBatchSummary(counts, durationMs)}`);
   }
@@ -23983,6 +24034,7 @@ ${recovery}`,
   } else if (liveSteps > 0) {
     if (report.executionPrerequisite) console.log(`  assumes: ${report.executionPrerequisite}`);
     for (const line of renderArtifactLines(report)) console.log(line);
+    for (const line of renderSingleFailure(report)) console.log(line);
     console.log(`
 ${renderSummary(report, { withDevice: true })}`);
   } else {

package/dist/installer.mjs

@@ -15727,6 +15727,11 @@ var FAILURE_CODES = {
   IOS_SETTINGS_PERMISSION_FAILED: "IOS_SETTINGS_PERMISSION_FAILED",
   IOS_SHAKE_FAILED: "IOS_SHAKE_FAILED",
   ANDROID_SHAKE_FAILED: "ANDROID_SHAKE_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.
+  IOS_FOLD_FAILED: "IOS_FOLD_FAILED",
+  IOS_FOLD_UNSUPPORTED: "IOS_FOLD_UNSUPPORTED",
   PASTE_CLIPBOARD_SET_FAILED: "PASTE_CLIPBOARD_SET_FAILED",
   PASTE_CLIPBOARD_UNSUPPORTED: "PASTE_CLIPBOARD_UNSUPPORTED",
   SETTINGS_PERMISSION_UNSUPPORTED: "SETTINGS_PERMISSION_UNSUPPORTED",
@@ -16725,7 +16730,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID = randomUUID4();
 function readCliVersion() {
   if (true) {
-    return "0.25.3-next.2";
+    return "0.25.3-next.4";
   }
   return "0.0.0";
 }

package/dist/mcp-server.mjs

@@ -16522,6 +16522,11 @@ var FAILURE_CODES = {
   IOS_SETTINGS_PERMISSION_FAILED: "IOS_SETTINGS_PERMISSION_FAILED",
   IOS_SHAKE_FAILED: "IOS_SHAKE_FAILED",
   ANDROID_SHAKE_FAILED: "ANDROID_SHAKE_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.
+  IOS_FOLD_FAILED: "IOS_FOLD_FAILED",
+  IOS_FOLD_UNSUPPORTED: "IOS_FOLD_UNSUPPORTED",
   PASTE_CLIPBOARD_SET_FAILED: "PASTE_CLIPBOARD_SET_FAILED",
   PASTE_CLIPBOARD_UNSUPPORTED: "PASTE_CLIPBOARD_UNSUPPORTED",
   SETTINGS_PERMISSION_UNSUPPORTED: "SETTINGS_PERMISSION_UNSUPPORTED",
@@ -18639,6 +18644,7 @@ var AUTO_SCREENSHOT_TOOLS = /* @__PURE__ */ new Set([
   "keyboard",
   "paste",
   "rotate",
+  "fold",
   "launch-app",
   "restart-app",
   "open-url",
@@ -18659,6 +18665,9 @@ var AUTO_SCREENSHOT_DELAY_MS_BY_TOOL = {
   "run-sequence": 15e3,
   "button": 1500,
   "rotate": 1e3,
+  // The fold tool already waits for the panel hand-over; the cap covers the
+  // repaint after it.
+  "fold": 1500,
   "keyboard": 300,
   "paste": 300,
   "describe": 100
@@ -18679,6 +18688,7 @@ var AUTO_DESCRIBE_TOOLS = /* @__PURE__ */ new Set([
   "keyboard",
   "paste",
   "rotate",
+  "fold",
   "launch-app",
   "restart-app",
   "open-url",

package/dist/preview-ui/index.html

@@ -1976,6 +1976,16 @@
       let ws = null;
       let wsOpen = false;
       let currentUdid = null;
+      // A foldable's panel: the CoreSimulator screen id its stream shows and
+      // its touches name (1 the cover panel, 3 the inner one on the iPhone
+      // Duo). null for a device with one panel, where commands name none.
+      // This page's touches and wheels go to the simulator-server directly and
+      // name this value, which the panel poll below refreshes every 1.5 s: for
+      // up to that long after a fold, a preview touch can go to the panel that
+      // went dark. An accepted limitation of the manual preview; the agent
+      // tools resolve the panel on every touch.
+      let activeScreen = null;
+      let panelPollTimer = null;
       let img = null;
       let stage = null;
       // Auto-reconnect bookkeeping (see scheduleReconnect): the simulator-server
@@ -2021,7 +2031,14 @@
         // While the element-comment inspector is active the stream is a
         // read-only annotation surface — never drive the device.
         if (typeof vp !== "undefined" && vp.inspect) return;
-        ws.send(JSON.stringify({ id: nextCmdId(), ...obj }));
+        const payload = { id: nextCmdId(), ...obj };
+        // simulator-server captures every panel of a foldable and follows
+        // none: a touch or wheel that names no screen goes to the cover panel,
+        // black once the device is open.
+        if (activeScreen !== null && (obj.cmd === "touch" || obj.cmd === "wheel")) {
+          payload.screen = activeScreen;
+        }
+        ws.send(JSON.stringify(payload));
         // Every command (touch/scroll/key) likely moved the screen — wake the
         // describe loop *now* so connectors/pins track interaction, not just
         // the fixed cadence. Only when something is actually anchored to the
@@ -2311,6 +2328,8 @@
         // /preview/describe/<oldUdid> after teardown.
         setDeviceIndicator(null);
         currentUdid = null;
+        stopPanelPoll();
+        activeScreen = null;
         describeWarmupPending = false;
         // Explicitly clear the img src — otherwise the browser keeps the MJPEG
         // HTTP connection open after the element is detached, and re-selecting
@@ -2338,6 +2357,46 @@
       // route) heals it instead of stranding the user on a refresh. The
       // reconnectTimer guard collapses the simultaneous img.onerror + ws.onclose
       // into a single attempt; backoff resets on a successful ws.onopen.
+      // A foldable's stream URL already carries `?screen=<id>`.
+      function withCacheBuster(url) {
+        return `${url}${url.includes("?") ? "&" : "?"}t=${Date.now()}`;
+      }
+
+      function stopPanelPoll() {
+        if (panelPollTimer) {
+          clearInterval(panelPollTimer);
+          panelPollTimer = null;
+        }
+      }
+
+      // Follow a foldable across folds: re-ask the tool-server which panel the
+      // device renders to, and move the stream and the touches when it changes.
+      function startPanelPoll(udid) {
+        stopPanelPoll();
+        let inFlight = false;
+        panelPollTimer = setInterval(async () => {
+          if (inFlight || currentUdid !== udid || !img) return;
+          inFlight = true;
+          try {
+            const res = await fetch(
+              `${TOOL_SERVER}/preview/simulator-server/${encodeURIComponent(udid)}`
+            );
+            if (!res.ok) return;
+            const info = await res.json();
+            if (currentUdid !== udid || !img || !info.foldable) return;
+            if (info.activeScreen !== activeScreen) {
+              activeScreen = info.activeScreen;
+              img.src = withCacheBuster(info.streamUrl);
+              setStatus("");
+            }
+          } catch {
+            /* transient; the next tick asks again */
+          } finally {
+            inFlight = false;
+          }
+        }, 1500);
+      }
+
       function scheduleReconnect(udid) {
         if (currentUdid !== udid || reconnectTimer) return;
         const delay = Math.min(1000 * 2 ** reconnectAttempts, 8000);
@@ -2428,7 +2487,9 @@
         img.alt = `Simulator ${udid.slice(0, 8)}`;
         img.draggable = false;
         // Append a cache-buster so re-connects don't reuse a stale MJPEG stream.
-        img.src = `${info.streamUrl}?t=${Date.now()}`;
+        img.src = withCacheBuster(info.streamUrl);
+        activeScreen = info.foldable ? info.activeScreen : null;
+        if (info.foldable) startPanelPoll(udid);
         img.onerror = () => {
           setStatus("stream error", "error");
           scheduleReconnect(udid);