@swmansion/argent 0.16.0 → 0.16.1-next.1

package/dist/tool-server.cjs

@@ -145980,12 +145980,7 @@ async function captureRunTarget(session, args) {
   try {
     assertSafeFlowName(name);
     const fragPath = path28.join(path28.dirname(session.filePath), `${name}.yaml`);
-    const fragment = parseFlow(await fs37.readFile(fragPath, "utf8"));
-    if (isE2eFlow(fragment)) {
-      return {
-        warning: `"${name}" is an e2e flow (starts with a launch step); only fragments compose via run: \u2014 kept the raw flow-execute step`
-      };
-    }
+    parseFlow(await fs37.readFile(fragPath, "utf8"));
     return { flow: name };
   } catch (err) {
     return {
@@ -148093,7 +148088,7 @@ var HORIZONTAL_TEXT_MERGE_MIN_GAP = 32;
 var HORIZONTAL_TEXT_MERGE_MAX_GAP = 120;
 var UNIFORM_BRIGHTNESS_DELTA_TOLERANCE = 4;
 async function diffPngFiles(options) {
-  const settings = resolveDiffSettings();
+  const settings = resolveDiffSettings(options.topMask ?? "status-bar");
   const [decodedBaseline, decodedCurrent] = await Promise.all([
     decodePngFile(options.baselinePath),
     decodePngFile(options.currentPath)
@@ -148154,10 +148149,10 @@ async function diffPngFiles(options) {
     textAnalysis
   });
 }
-function resolveDiffSettings() {
+function resolveDiffSettings(topMask) {
   return {
     thresholdSquared: DEFAULT_THRESHOLD * DEFAULT_THRESHOLD * MAX_RGB_DISTANCE_SQUARED,
-    ignoreTopNormalizedY: DEFAULT_IGNORE_TOP_NORMALIZED_Y,
+    ignoreTopNormalizedY: topMask === "none" ? 0 : DEFAULT_IGNORE_TOP_NORMALIZED_Y,
     joinGapPixels: DEFAULT_REGION_MERGE_DISTANCE,
     contextDiffScale: DEFAULT_CONTEXT_DIFF_SCALE
   };
@@ -148830,6 +148825,13 @@ async function treeSourceGate(registry2, device, bundleId, signal) {
 async function runLaunch(state3, app) {
   const { registry: registry2, device, signal } = state3;
   if (device.platform === "chromium") {
+    if (state3.chromiumLaunched) {
+      return {
+        ok: false,
+        reason: `chromium launches only the top-level flow's app, once per run \u2014 a nested launch can't boot its own instance and would run against the already-launched app. Nested chromium e2e flows aren't supported: run this flow at the top level, or drop its launch step to make it a fragment.`
+      };
+    }
+    state3.chromiumLaunched = true;
     if (state3.chromiumBooted) {
       if (!await sleepOrAbort(POST_LAUNCH_SETTLE_MS, signal)) return ABORTED_OUTCOME;
       return { ok: true };
@@ -148920,6 +148922,7 @@ returns a notice with the prerequisite instead of running.`,
         stopped: false,
         pinned: statusBarPinned,
         chromiumBooted: resolved.booted !== null,
+        chromiumLaunched: false,
         ...ctx?.emitProgress ? { onStepReport: ctx.emitProgress } : {}
       };
       try {
@@ -149109,11 +149112,6 @@ async function execRunStep(state3, step, runStack) {
   } catch (err) {
     return fail(`could not load fragment "${target}": ${errMsg2(err)}`);
   }
-  if (isE2eFlow(fragment)) {
-    return fail(
-      `"${target}" is an e2e flow (starts with a launch step); only fragments can be run from another flow`
-    );
-  }
   pushReport(state3, { index, kind: "run", status: "pass", flow: target });
   await execSteps(state3, fragment.steps, target, [...runStack, target]);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swmansion/argent",
-  "version": "0.16.0",
+  "version": "0.16.1-next.1",
   "description": "MCP server for iOS Simulator and Android Emulator control",
   "license": "Apache-2.0",
   "repository": {

package/skills/argent-create-flow/SKILL.md

@@ -11,7 +11,7 @@ Flows store **no device id**: the runner binds a device (the single booted one,
 
 **Two flow types**
 
-- **e2e** — begins with a `launch:` step, which starts that app from scratch (terminate + relaunch), so the flow controls its own start state. No `executionPrerequisite`. May `run:` fragments; cannot itself be a `run:` target. Record one by adding a `restart-app` of the app under test as the **first** step — it is captured as the `launch` step.
+- **e2e** — begins with a `launch:` step, which starts that app from scratch (terminate + relaunch), so the flow controls its own start state. No `executionPrerequisite`. May `run:` other flows, and (on iOS/Android) may itself be a `run:` target — when nested, its `launch` runs inline, restarting the app for that sub-scenario. **Chromium is the exception:** the runner boots one Electron app per run (the top-level flow's), so a nested chromium e2e flow's `launch` can't boot its own instance and fails the run — keep chromium e2e flows top-level. Record one by adding a `restart-app` of the app under test as the **first** step — it is captured as the `launch` step.
 - **fragment** — doesn't begin with a launch; runs against the device's current state. May declare an `executionPrerequisite` (a documented entry-state contract). Invoked from other flows via a `run:` step, or directly by you at any time.
 
 Both run via `argent flow run <name>` — a fragment simply runs against whatever is on screen (its prerequisite is printed as a reminder). Only e2e flows are meaningful CI/suite entries, since only they give a deterministic verdict from a clean start.
@@ -31,7 +31,7 @@ Beyond raw `tool:` steps and `echo:`, flows support declarative directives inter
 | `wait`       | `- wait: 500`                                                                                            | pause for a fixed number of milliseconds (last resort — prefer `await`) |
 | `assert`     | `- assert: { visible: Welcome }`                                                                         | check a condition, hard-fail if it never holds                          |
 | `snapshot`   | `- snapshot: home` or `- snapshot: { name: home, maxMismatch: 0.5 }`                                     | diff a screenshot against a stored baseline                             |
-| `run`        | `- run: login`                                                                                           | execute a fragment's steps inline                                       |
+| `run`        | `- run: login`                                                                                           | execute another flow's steps inline (fragment or e2e)                   |
 
 ### Selectors