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

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.30";
+    return "0.25.1-next.32";
   }
   return "0.0.0";
 }

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.30";
+    return "0.25.1-next.32";
   }
   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.30";
+    return "0.25.1-next.32";
   }
   return "0.0.0";
 }
@@ -125765,7 +125765,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 +125784,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 +131945,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") {
-    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 +132059,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 +132141,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 +134814,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 +134862,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,
@@ -147517,6 +147500,7 @@ function bindDeviceArgs(registry2, toolName, deviceId, args, deviceIsExplicit =
 
 // ../tool-server/src/tools/flows/flow-ios-tree.ts
 init_src();
+init_device_info();
 
 // ../tool-server/src/tools/flows/flow-tree-flatten.ts
 function intersectClip(rect, clip3) {
@@ -147891,6 +147875,9 @@ Flow selector steps auto-target and cannot provide a bundleId. Bring that app to
   );
 }
 async function terminateCommand(device) {
+  if (device.platform === "ios-remote") {
+    return `sim-remote simctl terminate ${stripRemotePrefix(device.id)} <bundleId>`;
+  }
   try {
     const { prefix } = await simctlTargetForUdid(device.id);
     return `xcrun ${prefix.join(" ")} terminate <udid> <bundleId>`;
@@ -148170,21 +148157,22 @@ 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.
   // Physical devices use the XCUITest runner tree.
-  ios: (registry2, device, target) => device.kind === "device" ? queryIosDeviceFlowTree(registry2, device) : queryFullHierarchyTree(registry2, device, target),
-  android: (registry2, device) => queryAndroidFullHierarchy(registry2, device),
-  chromium: (registry2, device) => queryChromiumTree(registry2, device),
-  vega: (_registry, device) => queryVegaTree(device)
+  "ios": (registry2, device, target) => device.kind === "device" ? queryIosDeviceFlowTree(registry2, device) : queryFullHierarchyTree(registry2, device, target),
+  // A remote sim is an iOS simulator reached over the sim-remote tunnel, and
+  // the native-devtools blueprint routes `getFullHierarchy` over TCP for one.
+  // So it is the local simulator source with no `kind === "device"` arm:
+  // `ios-remote` is always kind "simulator" (utils/device-info.ts) and has no
+  // physical-device variant.
+  "ios-remote": (registry2, device, target) => queryFullHierarchyTree(registry2, device, target),
+  "android": (registry2, device) => queryAndroidFullHierarchy(registry2, device),
+  "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"));
@@ -148628,12 +148616,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 } : {};
@@ -149516,9 +149502,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"
@@ -149592,7 +149575,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";
@@ -149657,9 +149639,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 {
@@ -154212,7 +154193,7 @@ async function treeSourceGate(registry2, device, bundleId, signal) {
       return `the on-device XCUITest runner did not become ready for ${device.id}: ${err instanceof Error ? err.message : String(err)}`;
     }
   }
-  if (device.platform === "ios" && !signal?.aborted) {
+  if ((device.platform === "ios" || device.platform === "ios-remote") && !signal?.aborted) {
     const reason = await waitForNativeDevtools(registry2, device, bundleId, signal);
     if (reason !== null && !signal?.aborted) {
       return `could not connect to native devtools. ${reason}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swmansion/argent",
-  "version": "0.25.1-next.30",
+  "version": "0.25.1-next.32",
   "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

@@ -111,7 +111,7 @@ Scopes can combine and nest, with at most six scope keys. Use strict selectors f
 
 Directives stop the flow on failure and skip later steps. The available directives are `launch`, `tap`, `long-press`, `swipe`, `type`, `scroll-to`, `pinch`, `rotate`, `await`, `assert`, `wait`, `snapshot`, `run`, `script`, `when`, `echo`, and `tool`.
 
-Use the launch map for cross-platform flows. A bare launch applies everywhere and becomes an app path on Chromium. The map takes `native:`, `ios:`, `android:`, `vega:`, and `chromium:`. `native:` is one id shared by iOS, Android, and Vega, and a per-platform key overrides it for that platform. `chromium:` accepts a relative or absolute app path. A launch that declares no id for the run's platform is an error, not a cue to switch platforms. On iOS, a successful launch also pins later tree reads to that app until the next raw `tool:` step, so read [The runner tree is not the discovery tree](#the-runner-tree-is-not-the-discovery-tree) when a read describes the wrong screen.
+Use the launch map for cross-platform flows. A bare launch applies everywhere and becomes an app path on Chromium. The map takes `native:`, `ios:`, `android:`, `vega:`, and `chromium:`. `native:` is one id shared by iOS, Android, and Vega, and a per-platform key overrides it for that platform. `chromium:` accepts a relative or absolute app path. A launch that declares no id for the run's platform is an error, not a cue to switch platforms. A run on a remote simulator uses the `ios:` id, or the `native:` id when the map has no `ios:` key, so no flow needs a key for a remote run. On iOS, a successful launch also pins later tree reads to that app until the next raw `tool:` step, so read [The runner tree is not the discovery tree](#the-runner-tree-is-not-the-discovery-tree) when a read describes the wrong screen.
 
 ```yaml
 - launch: { native: com.acme.app, chromium: ../../app }
@@ -219,7 +219,7 @@ Use `when:` only for optional setup or an interstitial that reconverges:
     - tap: { text: Got it }
 ```
 
-The guard accepts one `exists`, `visible`, `hidden`, or `text` condition, or `{ platform: ios|android|chromium|vega }`. UI guards use the short assert grace and reject `timeout`. There is no `else` or per-step `optional`. Put separate behavioral paths in separate flows. Never place a required acceptance check inside `when:`.
+The guard accepts one `exists`, `visible`, `hidden`, or `text` condition, or `{ platform: ios|android|chromium|vega }`. A run on a remote simulator matches `ios`. UI guards use the short assert grace and reject `timeout`. There is no `else` or per-step `optional`. Put separate behavioral paths in separate flows. Never place a required acceptance check inside `when:`.
 
 ## Composition and platform limits
 
@@ -249,7 +249,7 @@ If a script fails, check its changes before you retry.
 
 ## Snapshots and standalone runs
 
-`argent flow run <name> [--device <id>] [--platform ios|android|chromium|vega] [--update-baselines] [--output <dir>] [--json]` runs without an LLM and exits non-zero on failure.
+`argent flow run <name> [--device <id>] [--platform ios|android|chromium|vega|ios-remote] [--update-baselines] [--output <dir>] [--json]` runs without an LLM and exits non-zero on failure.
 
 A screenshot is human evidence. A `snapshot:` is executable visual verification. A missing baseline or excessive mismatch fails. A `cropOn` size change also fails. Use snapshots for color, layout, size, spacing, typography, clipping, overflow, images, icons, or stable component appearance. Use full screen for global changes and `cropOn` for one component.