@swmansion/argent 0.16.2-next.9 → 0.17.1-next.0

package/dist/tool-server.cjs

@@ -109,7 +109,9 @@ var init_artifacts = __esm({
       ".xml": "application/xml",
       ".txt": "text/plain",
       ".md": "text/markdown",
-      ".html": "text/html"
+      ".html": "text/html",
+      ".mp4": "video/mp4",
+      ".mov": "video/quicktime"
     };
     ArtifactStore = class {
       entries = /* @__PURE__ */ new Map();
@@ -138,6 +140,7 @@ var init_artifacts = __esm({
         };
         if (mtimeMs != null) handle.mtimeMs = mtimeMs;
         if (isDirectory2) handle.archive = "tar.gz";
+        if (opts?.saveDir) handle.saveDir = opts.saveDir;
         return handle;
       }
       get(id) {
@@ -382,6 +385,7 @@ var init_failure_codes = __esm({
       SCREEN_RECORDING_NO_ACTIVE_SESSION: "SCREEN_RECORDING_NO_ACTIVE_SESSION",
       SCREEN_RECORDING_STOP_IN_PROGRESS: "SCREEN_RECORDING_STOP_IN_PROGRESS",
       SCREEN_RECORDING_START_EXITED: "SCREEN_RECORDING_START_EXITED",
+      SCREEN_RECORDING_START_TIMEOUT: "SCREEN_RECORDING_START_TIMEOUT",
       SCREEN_RECORDING_PROCESS_ERROR: "SCREEN_RECORDING_PROCESS_ERROR",
       SCREEN_RECORDING_OUTPUT_MISSING: "SCREEN_RECORDING_OUTPUT_MISSING",
       SCREEN_RECORDING_SERVER_SHUTTING_DOWN: "SCREEN_RECORDING_SERVER_SHUTTING_DOWN",
@@ -34931,7 +34935,7 @@ var require_view = __commonJS({
     var path38 = require("node:path");
     var fs50 = require("node:fs");
     var dirname14 = path38.dirname;
-    var basename9 = path38.basename;
+    var basename10 = path38.basename;
     var extname4 = path38.extname;
     var join46 = path38.join;
     var resolve7 = path38.resolve;
@@ -34970,7 +34974,7 @@ var require_view = __commonJS({
         var root2 = roots[i];
         var loc = resolve7(root2, name);
         var dir = dirname14(loc);
-        var file2 = basename9(loc);
+        var file2 = basename10(loc);
         path39 = this.resolve(dir, file2);
       }
       return path39;
@@ -35000,7 +35004,7 @@ var require_view = __commonJS({
       if (stat4 && stat4.isFile()) {
         return path39;
       }
-      path39 = join46(dir, basename9(file2, ext), "index" + ext);
+      path39 = join46(dir, basename10(file2, ext), "index" + ext);
       stat4 = tryStat(path39);
       if (stat4 && stat4.isFile()) {
         return path39;
@@ -57445,9 +57449,9 @@ var require_content_disposition = __commonJS({
       if (typeof fallback === "string" && NON_LATIN1_REGEXP.test(fallback)) {
         throw new TypeError("fallback must be ISO-8859-1 string");
       }
-      var name = basename9(filename);
+      var name = basename10(filename);
       var isQuotedString = TEXT_REGEXP.test(name);
-      var fallbackName = typeof fallback !== "string" ? fallback && getlatin1(name) : basename9(fallback);
+      var fallbackName = typeof fallback !== "string" ? fallback && getlatin1(name) : basename10(fallback);
       var hasFallback = typeof fallbackName === "string" && fallbackName !== name;
       if (hasFallback || !isQuotedString || hasHexEscape(name)) {
         params["filename*"] = name;
@@ -57567,7 +57571,7 @@ var require_content_disposition = __commonJS({
       this.type = type;
       this.parameters = parameters;
     }
-    function basename9(path38) {
+    function basename10(path38) {
       const normalized = path38.replaceAll("\\", "/");
       let end = normalized.length;
       while (end > 0 && normalized[end - 1] === "/") {
@@ -104489,7 +104493,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID = (0, import_node_crypto3.randomUUID)();
 function readCliVersion() {
   if (true) {
-    return "0.16.1";
+    return "0.17.0";
   }
   return "0.0.0";
 }
@@ -105877,7 +105881,7 @@ var import_node_path5 = __toESM(require("node:path"));
 var import_semver = __toESM(require_semver2());
 
 // ../tool-server/package.json
-var version3 = "0.16.1";
+var version3 = "0.17.0";
 
 // ../tool-server/src/utils/update-checker.ts
 var import_update_core = __toESM(require_dist4());
@@ -114038,6 +114042,27 @@ function sendCommand(api, cmd) {
     ws.once("open", () => ws.send(payload));
   }
 }
+function setPointerVisible(api, show, signal) {
+  return pointerPost(api, { show }, signal);
+}
+function setPointerTrail(api, trail, signal) {
+  return pointerPost(api, { trail }, signal);
+}
+async function pointerPost(api, body, signal) {
+  try {
+    const res = await fetch(`${api.apiUrl}/api/pointer`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body),
+      signal
+    });
+    if (!res.ok) return false;
+    const parsed = await res.json().catch(() => null);
+    return parsed?.status === "ok";
+  } catch {
+    return false;
+  }
+}
 async function simulatorPost(toolLabel, api, endpoint, reqBody, signal, fallbackHint) {
   let res;
   try {
@@ -126869,6 +126894,7 @@ Use when you need to zoom in or out on a map, image, or zoomable view. Returns {
 
 // ../tool-server/src/tools/gesture-rotate/index.ts
 init_zod();
+init_src();
 var zodSchema22 = external_exports.object({
   udid: external_exports.string().describe("Target device id from `list-devices` (iOS UDID or Android serial)."),
   centerX: external_exports.number().describe(
@@ -126877,13 +126903,33 @@ var zodSchema22 = external_exports.object({
   centerY: external_exports.number().describe(
     "Center of rotation, vertical: normalized 0.0\u20131.0 (fraction of screen height, not pixels)"
   ),
-  radius: external_exports.number().describe(
-    "Distance from center to each finger: normalized 0.0\u20131.0 (fraction of screen, not pixels). E.g. 0.15 = fingers placed 15% of screen away from center."
+  radius: external_exports.number().optional().describe(
+    "Distance from center to each finger: normalized 0.0\u20131.0 (fraction of screen, not pixels). E.g. 0.15 = fingers placed 15% of screen away from center. One value for both axes, so on a non-square screen the orbit is a physical ellipse \u2014 pass radiusX+radiusY instead for a true circle. Required unless radiusX and radiusY are given."
+  ),
+  radiusX: external_exports.number().optional().describe(
+    "Per-axis finger distance, horizontal: normalized 0.0\u20131.0 fraction of screen WIDTH. Give both radiusX and radiusY (they override radius) with radiusX\xB7screenWidth = radiusY\xB7screenHeight for a physically circular orbit \u2014 constant finger separation, no pinch coupled into the turn."
+  ),
+  radiusY: external_exports.number().optional().describe(
+    "Per-axis finger distance, vertical: normalized 0.0\u20131.0 fraction of screen HEIGHT. Always paired with radiusX \u2014 see radiusX."
   ),
   startAngle: external_exports.number().describe("Starting angle in degrees (0 = right, 90 = down)"),
   endAngle: external_exports.number().describe("Ending angle in degrees. endAngle > startAngle = clockwise."),
   durationMs: external_exports.number().optional().describe("Total gesture duration in milliseconds (default 300)")
-});
+}).refine((p) => p.radiusX === void 0 === (p.radiusY === void 0), {
+  message: "radiusX and radiusY must be given together (one physical radius, two normalizations)"
+}).refine((p) => p.radius !== void 0 || p.radiusX !== void 0, {
+  message: "Pass radius, or both radiusX and radiusY."
+});
+var inputSchema = {
+  ...zodObjectToJsonSchema(zodSchema22),
+  anyOf: [
+    { required: ["radiusX", "radiusY"] },
+    {
+      required: ["radius"],
+      not: { anyOf: [{ required: ["radiusX"] }, { required: ["radiusY"] }] }
+    }
+  ]
+};
 var capability14 = {
   apple: { simulator: true, device: true },
   appleRemote: { simulator: true },
@@ -126891,32 +126937,51 @@ var capability14 = {
 };
 var gestureRotateTool = {
   id: "gesture-rotate",
-  description: `Send a two-finger circular arc gesture to rotate on-screen content by a specified angle. Two fingers are placed opposite each other at a fixed radius from the center, then swept from startAngle to endAngle degrees. All positions and radius are normalized 0.0\u20131.0 (fractions of screen width/height, not pixels)\u2014same coordinate space as gesture-tap and gesture-swipe.
-endAngle > startAngle = clockwise rotation. Typical values: radius 0.15, startAngle 0, endAngle 90 for a 90\xB0 clockwise turn.
+  description: `Send a two-finger circular arc gesture to rotate on-screen content by a specified angle. Two fingers are placed opposite each other at a fixed radius from the center, then swept from startAngle to endAngle degrees. All positions and radii are normalized 0.0\u20131.0 (fractions of screen width/height, not pixels)\u2014same coordinate space as gesture-tap and gesture-swipe.
+endAngle > startAngle = clockwise rotation. Typical values: radius 0.15, startAngle 0, endAngle 90 for a 90\xB0 clockwise turn. A single radius applies to both axes, so on a non-square screen it traces a physical ellipse (finger separation varies through the turn); pass radiusX+radiusY (fractions of width/height with radiusX\xB7width = radiusY\xB7height) for a physically circular orbit instead.
 Auto-generates interpolated frames at ~60fps.
 Unlike gesture-pinch which moves fingers linearly to zoom, this orbits fingers in an arc to change orientation.
 Use when you need to rotate a map, image picker, or any rotateable UI element. Returns { rotated: true, timestampMs }. Fails if the simulator-server / emulator backend is not reachable for the given device.`,
   zodSchema: zodSchema22,
+  inputSchema,
   capability: capability14,
   services: (params) => ({
     simulatorServer: simulatorServerRef(resolveDevice(params.udid))
   }),
-  async execute(services, params) {
+  async execute(services, params, ctx) {
     const api = services.simulatorServer;
     const duration3 = params.durationMs ?? 300;
     const steps = Math.max(1, Math.round(duration3 / 16));
+    const radiusX = params.radiusX ?? params.radius;
+    const radiusY = params.radiusY ?? params.radius;
     let timestampMs = 0;
+    let lastX1 = 0;
+    let lastY1 = 0;
+    let lastX2 = 0;
+    let lastY2 = 0;
     for (let i = 0; i <= steps; i++) {
+      if (ctx?.signal?.aborted) {
+        if (i > 0) sendTouchEvent(api, "Up", lastX1, lastY1, lastX2, lastY2);
+        const err = new Error(
+          `gesture-rotate aborted \u2014 cancelled mid-gesture after ${i} of ${steps + 1} frames`
+        );
+        err.name = "AbortError";
+        throw err;
+      }
       const t = i / steps;
       const angleDeg = params.startAngle + (params.endAngle - params.startAngle) * t;
       const angleRad = angleDeg * Math.PI / 180;
-      const x1 = params.centerX + params.radius * Math.cos(angleRad);
-      const y1 = params.centerY + params.radius * Math.sin(angleRad);
-      const x2 = params.centerX - params.radius * Math.cos(angleRad);
-      const y2 = params.centerY - params.radius * Math.sin(angleRad);
+      const x1 = params.centerX + radiusX * Math.cos(angleRad);
+      const y1 = params.centerY + radiusY * Math.sin(angleRad);
+      const x2 = params.centerX - radiusX * Math.cos(angleRad);
+      const y2 = params.centerY - radiusY * Math.sin(angleRad);
       const type = i === 0 ? "Down" : i === steps ? "Up" : "Move";
       if (i === 0) timestampMs = Date.now();
       sendTouchEvent(api, type, x1, y1, x2, y2);
+      lastX1 = x1;
+      lastY1 = y1;
+      lastX2 = x2;
+      lastY2 = y2;
       if (i < steps) await sleep(16);
     }
     return { rotated: true, timestampMs };
@@ -133994,7 +134059,7 @@ Allowed tools and their args (udid is auto-injected, do NOT include it in args):
   gesture-drag:   { fromX: number, fromY: number, toX: number, toY: number, durationMs?: number }                       [chromium only]
   gesture-custom: { events: [{ type: "Down"|"Move"|"Up", x: number, y: number, x2?: number, y2?: number, delayMs?: number }], interpolate?: number }  [ios/android]
   gesture-pinch:  { centerX: number, centerY: number, startDistance: number, endDistance: number, endCenterX?: number, endCenterY?: number, angle?: number, durationMs?: number }  [ios/android]
-  gesture-rotate: { centerX: number, centerY: number, radius: number, startAngle: number, endAngle: number, durationMs?: number }                    [ios/android]
+  gesture-rotate: { centerX: number, centerY: number, radius?: number, radiusX?: number, radiusY?: number, startAngle: number, endAngle: number, durationMs?: number }  [ios/android]
   button:         { button: "home"|"back"|"power"|"volumeUp"|"volumeDown"|"appSwitch"|"actionButton" }                  [ios/android]
   keyboard:       { text?: string, key?: string, delayMs?: number }  (key pressed after text; TV: text only)            [ios/android/chromium/vega/tv]
                   text supports {{secret:<NAME>}} placeholders, resolved server-side from ARGENT_SECRET_<NAME> env vars (prefix mandatory) \u2014 credentials never enter agent context
@@ -142986,6 +143051,8 @@ function clearLiveState2(state3) {
   state3.pendingChild = null;
   state3.frameStream = null;
   state3.lastFrameStreamError = null;
+  state3.pointerDisable = null;
+  state3.pointerFailed = false;
   state3.recordingTimedOut = false;
   state3.recordingExitedUnexpectedly = false;
   state3.lastExitInfo = null;
@@ -143039,6 +143106,8 @@ var screenRecordingSessionBlueprint = {
       trimStatic: true,
       framesWritten: 0,
       trimmedAnyFrames: false,
+      pointerDisable: null,
+      pointerFailed: false,
       wallClockStartMs: null,
       wallClockEndMs: null,
       timeLimitSeconds: null,
@@ -143061,6 +143130,12 @@ var screenRecordingSessionBlueprint = {
           state3.pumpTimer = null;
         }
         state3.frameStream?.close();
+        if (state3.pointerDisable) {
+          const disable = state3.pointerDisable;
+          state3.pointerDisable = null;
+          await disable().catch(() => {
+          });
+        }
         if (state3.pendingChild) {
           try {
             state3.pendingChild.kill("SIGKILL");
@@ -143593,6 +143668,12 @@ function startPump(api, stream) {
     }
   }, FRAME_INTERVAL_MS);
 }
+async function disablePointer(api) {
+  const disable = api.pointerDisable;
+  api.pointerDisable = null;
+  if (disable) await disable().catch(() => {
+  });
+}
 function stopPump(api) {
   if (api.pumpTimer) {
     clearInterval(api.pumpTimer);
@@ -143687,6 +143768,7 @@ async function startCaptureLocked(api, params) {
   api.recordingTimedOut = false;
   api.recordingExitedUnexpectedly = false;
   api.pendingRetrieval = false;
+  api.pointerFailed = false;
   api.lastExitInfo = null;
   api.lastFrameStreamError = null;
   api.outputFile = outputFile;
@@ -143702,16 +143784,6 @@ async function startCaptureLocked(api, params) {
   api.timeLimitSeconds = params.timeLimitSeconds;
   registerActiveScreenRecording(api.deviceId, api.wallClockStartMs, params.timeLimitSeconds);
   startPump(api, stream);
-  api.recordingTimeout = setTimeout(() => {
-    api.recordingTimeout = null;
-    if (api.captureProcess !== child) return;
-    api.recordingTimedOut = true;
-    api.recordingActive = false;
-    api.wallClockEndMs = Date.now();
-    api.pendingRetrieval = true;
-    markScreenRecordingFinalized(api.deviceId, `it hit its ${params.timeLimitSeconds}s time limit`);
-    finalizeCapture(api);
-  }, params.timeLimitSeconds * 1e3);
   child.on("exit", (code, signal) => {
     if (api.captureProcess !== child) return;
     api.lastExitInfo = { code, signal };
@@ -143726,9 +143798,25 @@ async function startCaptureLocked(api, params) {
       api.wallClockEndMs = Date.now();
       api.pendingRetrieval = true;
       stopPump(api);
+      void disablePointer(api);
       markScreenRecordingFinalized(api.deviceId, "the recording process exited unexpectedly");
     }
   });
+  if (params.pointer) {
+    api.pointerDisable = params.pointer.disable;
+    api.pointerFailed = !await params.pointer.enable();
+  }
+  api.recordingTimeout = setTimeout(() => {
+    api.recordingTimeout = null;
+    if (api.captureProcess !== child) return;
+    api.recordingTimedOut = true;
+    api.recordingActive = false;
+    api.wallClockEndMs = Date.now();
+    api.pendingRetrieval = true;
+    markScreenRecordingFinalized(api.deviceId, `it hit its ${params.timeLimitSeconds}s time limit`);
+    finalizeCapture(api);
+    void disablePointer(api);
+  }, params.timeLimitSeconds * 1e3);
   return {
     status: "recording",
     timeLimitSeconds: params.timeLimitSeconds,
@@ -143795,6 +143883,7 @@ async function stopCapture(api) {
   const endedEarly = api.recordingTimedOut || api.recordingExitedUnexpectedly;
   const streamError = api.frameStream?.error ?? api.lastFrameStreamError ?? null;
   const watermarkSkipped = api.watermarkSkipped;
+  const pointerFailed = api.pointerFailed;
   let warning;
   try {
     const child = api.captureProcess;
@@ -143828,6 +143917,12 @@ async function stopCapture(api) {
     if (watermarkSkipped) {
       warning = [warning, `The watermark was not applied (${watermarkSkipped}).`].filter(Boolean).join(" ");
     }
+    if (pointerFailed) {
+      warning = [
+        warning,
+        "The touch visualizer could not be enabled on simulator-server, so touches are not shown in this video."
+      ].filter(Boolean).join(" ");
+    }
     const size = await statNonEmptyOutput(outputFile, "screen_recording_stop");
     const wallClockMs = startedAtMs === null ? null : (api.wallClockEndMs ?? Date.now()) - startedAtMs;
     const durationMs = trimStatic ? Math.round(api.framesWritten / OUTPUT_FPS2 * 1e3) : wallClockMs;
@@ -143846,6 +143941,7 @@ async function stopCapture(api) {
     throw err;
   } finally {
     stopPump(api);
+    await disablePointer(api);
     api.recordingActive = false;
     api.stopPending = false;
     api.pendingRetrieval = false;
@@ -143853,6 +143949,7 @@ async function stopCapture(api) {
     api.outputFile = null;
     api.logoFile = null;
     api.watermarkSkipped = null;
+    api.pointerFailed = false;
     api.framesWritten = 0;
     api.trimmedAnyFrames = false;
     api.wallClockStartMs = null;
@@ -143871,6 +143968,8 @@ async function stopCapture(api) {
 // ../tool-server/src/tools/screen-recording/screen-recording-start.ts
 var DEFAULT_TIME_LIMIT_SECONDS = 180;
 var MAX_TIME_LIMIT_SECONDS = 600;
+var POINTER_TRAIL_LENGTH = 8;
+var POINTER_REQUEST_TIMEOUT_MS = 2e3;
 var zodSchema51 = external_exports.object({
   udid: external_exports.string().describe("Target device id from `list-devices` (iOS Simulator UDID or Android serial)."),
   timeLimitSeconds: external_exports.number().int().min(1).max(MAX_TIME_LIMIT_SECONDS).optional().describe(
@@ -143878,6 +143977,9 @@ var zodSchema51 = external_exports.object({
   ),
   trimStatic: external_exports.boolean().optional().describe(
     "Default true. Collapse stretches where the screen does not change: the first second of each still stretch is kept, then unchanged frames are dropped until something moves again, so a long recording with brief activity comes back short instead of full of dead air. The returned durationMs is the trimmed length; wallClockMs/trimmedMs report what was removed. Set false to keep a faithful real-time recording."
+  ),
+  showTouches: external_exports.boolean().optional().describe(
+    "Default true. Draw simulator-server's touch visualizer into the recording: a pulse marks each tap, a comet trail follows swipes and drags, and paired markers show two-finger pinch/rotate, so the video makes clear where every interaction landed. Set false to record the raw screen with no overlay."
   )
 });
 var capability26 = {
@@ -143890,6 +143992,7 @@ function createScreenRecordingStartTool(registry2) {
     capability: capability26,
     description: `Start recording the device screen to a video file (h264 mp4, 30fps at the device's native resolution).
 By default stretches where the screen does not change are trimmed out (see trimStatic), so a long session with only brief activity comes back as a short clip instead of minutes of dead air.
+By default every tap, swipe, drag, pinch and rotate is drawn into the video as an on-screen touch marker (see showTouches), so the recording shows where each interaction landed.
 The recording keeps running across other tool calls (every result carries a reminder) until \`screen-recording-stop\` is called or timeLimitSeconds elapses \u2014 immediately after starting, set yourself a reminder/wakeup for the expected end of the recording so it is never left running.
 Use when the user wants a video of an interaction, animation, or app behavior \u2014 for a single still frame use \`screenshot\` instead.
 Returns { status: "recording", timeLimitSeconds, outputFile } \u2014 the video is retrieved later by \`screen-recording-stop\`, not by reading outputFile directly.
@@ -143934,21 +144037,53 @@ Fails if a recording is already running on the device, the device is not booted,
           }
         );
       }
+      const showTouches = params.showTouches ?? true;
+      const pointer = showTouches ? makePointerControl(simulator) : void 0;
       return startCapture(api, {
         streamUrl,
         timeLimitSeconds,
         watermark: isFeatureEnabled("video-watermark"),
-        trimStatic: params.trimStatic ?? true
+        trimStatic: params.trimStatic ?? true,
+        pointer
       });
     }
   };
 }
+function makePointerControl(simulator) {
+  let enabling = null;
+  return {
+    async enable() {
+      const run2 = (async () => {
+        await setPointerTrail(
+          simulator,
+          POINTER_TRAIL_LENGTH,
+          AbortSignal.timeout(POINTER_REQUEST_TIMEOUT_MS)
+        );
+        return setPointerVisible(simulator, true, AbortSignal.timeout(POINTER_REQUEST_TIMEOUT_MS));
+      })();
+      enabling = run2;
+      try {
+        return await run2;
+      } finally {
+        if (enabling === run2) enabling = null;
+      }
+    },
+    async disable() {
+      const pending = enabling;
+      if (pending) await pending.catch(() => {
+      });
+      await setPointerVisible(simulator, false, AbortSignal.timeout(POINTER_REQUEST_TIMEOUT_MS));
+    }
+  };
+}
 
 // ../tool-server/src/tools/screen-recording/screen-recording-stop.ts
+var import_node_path20 = require("node:path");
 init_zod();
 var zodSchema52 = external_exports.object({
   udid: external_exports.string().describe("Target device id from `list-devices` (iOS Simulator UDID or Android serial).")
 });
+var RECORDINGS_DIR = ".argent/recordings";
 var capability27 = {
   apple: { simulator: true },
   android: { emulator: true, device: true, unknown: true }
@@ -143972,7 +144107,13 @@ Fails if no recording (running or finished-but-unretrieved) exists for the given
     assertSupported("screen-recording-stop", capability27, device);
     const stopped = await stopCapture(api);
     const artifacts = requireArtifacts(ctx);
-    const video = await artifacts.register(stopped.outputFile, { mimeType: "video/mp4" });
+    const video = await artifacts.register(stopped.outputFile, {
+      mimeType: "video/mp4",
+      // Drop the internal `argent-` temp prefix so the saved file reads cleanly
+      // as `.argent/recordings/screen-recording-<device>-<ts>.mp4`.
+      filename: (0, import_node_path20.basename)(stopped.outputFile).replace(/^argent-/, ""),
+      saveDir: RECORDINGS_DIR
+    });
     const result = { video, durationMs: stopped.durationMs };
     if (stopped.wallClockMs !== void 0) result.wallClockMs = stopped.wallClockMs;
     if (stopped.trimmedMs !== void 0) result.trimmedMs = stopped.trimmedMs;
@@ -145848,6 +145989,123 @@ var fs39 = __toESM(require("node:fs/promises"));
 init_src();
 var import_yaml = __toESM(require_dist5());
 init_src();
+
+// ../tool-server/src/tools/flows/flow-pinch-geometry.ts
+var PINCH_RATIO_PER_GESTURE = 4;
+var PINCH_SETTLE_MS = 250;
+var TARGET_START_FRACTION = 0.82;
+var SCREEN_EDGE_INSET = 0.02;
+var MIN_VIABLE_TRAVEL = 0.03;
+function systemEdgeGuards(device) {
+  return device.platform === "android" ? { left: 0.13, right: 0.13, top: 0.08, bottom: 0.08 } : { left: 0.08, right: 0.08, top: 0.08, bottom: 0.08 };
+}
+function decomposePinch(scale) {
+  const n = Math.max(
+    1,
+    Math.ceil(Math.abs(Math.log(scale)) / Math.log(PINCH_RATIO_PER_GESTURE) - 1e-9)
+  );
+  return { n, per: scale ** (1 / n) };
+}
+function clamp2(v, lo, hi) {
+  return v < lo ? lo : v > hi ? hi : v;
+}
+function buildAxisCandidate(input) {
+  const { angle, center, targetSpan, per, guards } = input;
+  const c = angle === 0 ? center.x : center.y;
+  const gLow = angle === 0 ? guards.left : guards.top;
+  const gHigh = angle === 0 ? guards.right : guards.bottom;
+  const p = angle === 0 ? center.y : center.x;
+  const pLow = angle === 0 ? guards.top : guards.left;
+  const pHigh = angle === 0 ? guards.bottom : guards.right;
+  const screenEndSpan = 1 - 2 * SCREEN_EDGE_INSET;
+  const edgeSafeStartSpan = 2 * Math.max(0, Math.min(c - gLow, 1 - gHigh - c));
+  const insetStartSpan = 2 * Math.max(0, Math.min(c - SCREEN_EDGE_INSET, 1 - SCREEN_EDGE_INSET - c));
+  const screenStartLimit = edgeSafeStartSpan > 0 ? Math.min(screenEndSpan, edgeSafeStartSpan) : Math.min(screenEndSpan, insetStartSpan);
+  const startLimit = targetSpan !== void 0 ? Math.min(screenStartLimit, targetSpan * TARGET_START_FRACTION) : screenStartLimit;
+  const start2 = per > 1 ? Math.min(startLimit, screenEndSpan / per) : startLimit;
+  const end = Math.min(screenEndSpan, start2 * per);
+  const travel = Math.abs(end - start2);
+  if (!(travel > 0)) return void 0;
+  const endCenter = clamp2(c, SCREEN_EDGE_INSET + end / 2, 1 - SCREEN_EDGE_INSET - end / 2);
+  const downLow = c - start2 / 2;
+  const downHigh = c + start2 / 2;
+  const axisSafe = downLow >= gLow && downHigh <= 1 - gHigh;
+  const perpSafe = p >= pLow && p <= 1 - pHigh;
+  const clearance = Math.min(downLow - gLow, 1 - gHigh - downHigh, p - pLow, 1 - pHigh - p);
+  return {
+    angle,
+    start: start2,
+    end,
+    endCenter,
+    travel,
+    viable: travel >= MIN_VIABLE_TRAVEL,
+    axisSafe,
+    fullyEdgeSafe: axisSafe && perpSafe,
+    clearance
+  };
+}
+function selectPinchCandidate(candidates) {
+  if (candidates.length === 0) return void 0;
+  const rank2 = (c) => c.fullyEdgeSafe ? 0 : c.axisSafe ? 1 : 2;
+  return [...candidates].sort((a, b) => {
+    const byViable = Number(b.viable) - Number(a.viable);
+    if (byViable !== 0) return byViable;
+    const byRank = rank2(a) - rank2(b);
+    if (byRank !== 0) return byRank;
+    if (a.fullyEdgeSafe && b.fullyEdgeSafe) return b.travel - a.travel;
+    return b.clearance - a.clearance || b.travel - a.travel;
+  })[0];
+}
+
+// ../tool-server/src/tools/flows/flow-rotate-geometry.ts
+var ROTATE_MS_PER_90_DEG = 300;
+var MAX_DERIVED_ROTATE_MS = 1e4;
+var MAX_ROTATE_BY_DEG = MAX_DERIVED_ROTATE_MS / ROTATE_MS_PER_90_DEG * 90;
+function deriveRotateDurationMs(by) {
+  return Math.round(ROTATE_MS_PER_90_DEG * Math.max(1, Math.abs(by) / 90));
+}
+function buildRotateCandidate(input) {
+  const { startAngle, center, targetSpan, guards, aspect } = input;
+  const xClear = Math.min(center.x - SCREEN_EDGE_INSET, 1 - SCREEN_EDGE_INSET - center.x);
+  const yClear = Math.min(center.y - SCREEN_EDGE_INSET, 1 - SCREEN_EDGE_INSET - center.y);
+  const screenRx = Math.min(xClear, yClear / aspect);
+  const targetRx = targetSpan === void 0 ? Infinity : startAngle === 0 ? targetSpan * TARGET_START_FRACTION / 2 : targetSpan * TARGET_START_FRACTION / 2 / aspect;
+  const radiusX = Math.min(screenRx, targetRx);
+  if (!(radiusX > 0)) return void 0;
+  const radiusY = radiusX * aspect;
+  const c = startAngle === 0 ? center.x : center.y;
+  const half = startAngle === 0 ? radiusX : radiusY;
+  const gLow = startAngle === 0 ? guards.left : guards.top;
+  const gHigh = startAngle === 0 ? guards.right : guards.bottom;
+  const p = startAngle === 0 ? center.y : center.x;
+  const pLow = startAngle === 0 ? guards.top : guards.left;
+  const pHigh = startAngle === 0 ? guards.bottom : guards.right;
+  const downLow = c - half;
+  const downHigh = c + half;
+  const axisSafe = downLow >= gLow && downHigh <= 1 - gHigh;
+  const perpSafe = p >= pLow && p <= 1 - pHigh;
+  const clearance = Math.min(downLow - gLow, 1 - gHigh - downHigh, p - pLow, 1 - pHigh - p);
+  return {
+    startAngle,
+    radiusX,
+    radiusY,
+    axisSafe,
+    fullyEdgeSafe: axisSafe && perpSafe,
+    clearance
+  };
+}
+function selectRotateCandidate(candidates) {
+  if (candidates.length === 0) return void 0;
+  const rank2 = (c) => c.fullyEdgeSafe ? 0 : c.axisSafe ? 1 : 2;
+  return [...candidates].sort((a, b) => {
+    const byRank = rank2(a) - rank2(b);
+    if (byRank !== 0) return byRank;
+    if (a.fullyEdgeSafe && b.fullyEdgeSafe) return b.radiusX - a.radiusX;
+    return b.clearance - a.clearance || b.radiusX - a.radiusX;
+  })[0];
+}
+
+// ../tool-server/src/tools/flows/flow-utils.ts
 var FLOWS_DIR_NAME = path29.join(".argent", "flows");
 var activeFlowName = null;
 var activeProjectRoot = null;
@@ -146157,6 +146415,10 @@ function toYamlStep(step) {
       return {
         pinch: step.selector ? { on: selectorToYaml(step.selector), scale: step.scale } : { scale: step.scale }
       };
+    case "rotate":
+      return {
+        rotate: step.selector ? { on: selectorToYaml(step.selector), by: step.by } : { by: step.by }
+      };
     case "snapshot":
       return step.maxMismatch === void 0 ? { snapshot: step.name } : { snapshot: { name: step.name, maxMismatch: step.maxMismatch } };
     case "tool":
@@ -146430,6 +146692,7 @@ var STEP_DIRECTIVE_KEYS = [
   "wait",
   "scroll-to",
   "pinch",
+  "rotate",
   "snapshot"
 ];
 function parseTapTimes(raw, entry) {
@@ -146548,6 +146811,31 @@ function parsePinch(body, entry) {
   if (obj.on !== void 0) step.selector = parseSelector(obj.on, "pinch.on");
   return step;
 }
+function parseRotate(body, entry) {
+  if (body === null || typeof body !== "object") {
+    badEntry(
+      entry,
+      'rotate takes an options map \u2014 e.g. rotate: { on: "Map", by: 90 } (an angle is required)'
+    );
+  }
+  const obj = body;
+  if (obj.text !== void 0 || obj.id !== void 0 || obj.identifier !== void 0 || obj.role !== void 0) {
+    badEntry(entry, 'rotate takes a nested selector \u2014 e.g. rotate: { on: "Map", by: 90 }');
+  }
+  rejectUnknownKeys(entry, obj, ["on", "by"], "rotate");
+  if (typeof obj.by !== "number" || !Number.isFinite(obj.by) || obj.by === 0) {
+    badEntry(entry, "rotate.by must be a finite non-zero number of degrees (+CW, \u2212CCW)");
+  }
+  if (Math.abs(obj.by) > MAX_ROTATE_BY_DEG) {
+    badEntry(
+      entry,
+      `rotate.by must be within \xB1${MAX_ROTATE_BY_DEG}\xB0 \u2014 one continuous gesture at ~300\xB0/s (10 s max)`
+    );
+  }
+  const step = { kind: "rotate", by: obj.by };
+  if (obj.on !== void 0) step.selector = parseSelector(obj.on, "rotate.on");
+  return step;
+}
 function parseWhenCondition(raw) {
   const conditionKeys = `${WAIT_CONDITIONS.join(", ")}, platform`;
   if (raw === null || typeof raw !== "object") {
@@ -146716,6 +147004,7 @@ function fromYamlStep(raw, whenDepth = 0) {
     return step;
   }
   if ("pinch" in raw) return parsePinch(raw.pinch, raw);
+  if ("rotate" in raw) return parseRotate(raw.rotate, raw);
   if ("snapshot" in raw) {
     const body = raw.snapshot;
     if (body !== null && typeof body === "object" && !Array.isArray(body)) {
@@ -147120,7 +147409,7 @@ function projectIosNode(node, screenW, screenH) {
     scrolls: role === "AXScrollArea"
   };
 }
-function adaptFullHierarchyToDescribeResult(raw) {
+function adaptFullHierarchy(raw) {
   const windows = typeof raw === "object" && raw !== null && Array.isArray(raw.windows) ? raw.windows.map(asViewNode).filter((n) => n !== null) : [];
   let screenW = 0;
   let screenH = 0;
@@ -147137,11 +147426,12 @@ function adaptFullHierarchyToDescribeResult(raw) {
       flattenHoisting(win, (n) => projectIosNode(n, screenW, screenH), children);
     }
   }
-  return parseDescribeResult({
+  const tree = parseDescribeResult({
     role: "AXGroup",
     frame: { x: 0, y: 0, width: 1, height: 1 },
     children
   });
+  return screenW > 0 && screenH > 0 ? { tree, screen: { width: screenW, height: screenH } } : { tree };
 }
 var FULL_HIERARCHY_FIELDS = [
   "className",
@@ -147183,7 +147473,8 @@ async function queryFullHierarchyTree(registry2, device) {
   if (rawResult.error) {
     throw new Error(`getFullHierarchy failed for ${target.bundleId}: ${rawResult.error}`);
   }
-  return { tree: adaptFullHierarchyToDescribeResult(rawResult), source: "native-devtools" };
+  const { tree, screen } = adaptFullHierarchy(rawResult);
+  return { tree, source: "native-devtools", ...screen ? { screen } : {} };
 }
 function errMsg(err) {
   return err instanceof Error ? err.message : String(err);
@@ -147306,7 +147597,11 @@ async function queryAndroidFullHierarchy(registry2, device) {
     devtools.getScreenSize()
   ]);
   const tree = adaptFullAndroidHierarchyToDescribeResult(xml, size.width, size.height);
-  return { tree, source: "android-devtools" };
+  return {
+    tree,
+    source: "android-devtools",
+    ...size.width > 0 && size.height > 0 ? { screen: { width: size.width, height: size.height } } : {}
+  };
 }
 
 // ../tool-server/src/tools/flows/flow-chromium-tree.ts
@@ -147614,6 +147909,8 @@ You can still edit the .yaml file directly afterwards to remove or reorder steps
           return `${n}. scroll-to: ${selectorLabel(step.target)} (${step.direction})`;
         case "pinch":
           return `${n}. pinch: scale ${step.scale}${step.selector ? ` on ${selectorLabel(step.selector)}` : ""}`;
+        case "rotate":
+          return `${n}. rotate: by ${step.by}\xB0${step.selector ? ` on ${selectorLabel(step.selector)}` : ""}`;
         case "snapshot":
           return `${n}. snapshot: ${step.name}`;
         case "tool":
@@ -147640,73 +147937,6 @@ var fs45 = __toESM(require("node:fs/promises"));
 var path33 = __toESM(require("node:path"));
 init_src();
 
-// ../tool-server/src/tools/flows/flow-pinch-geometry.ts
-var PINCH_RATIO_PER_GESTURE = 4;
-var PINCH_SETTLE_MS = 250;
-var TARGET_START_FRACTION = 0.82;
-var SCREEN_EDGE_INSET = 0.02;
-var MIN_VIABLE_TRAVEL = 0.03;
-function systemEdgeGuards(device) {
-  return device.platform === "android" ? { left: 0.13, right: 0.13, top: 0.08, bottom: 0.08 } : { left: 0.08, right: 0.08, top: 0.08, bottom: 0.08 };
-}
-function decomposePinch(scale) {
-  const n = Math.max(
-    1,
-    Math.ceil(Math.abs(Math.log(scale)) / Math.log(PINCH_RATIO_PER_GESTURE) - 1e-9)
-  );
-  return { n, per: scale ** (1 / n) };
-}
-function clamp2(v, lo, hi) {
-  return v < lo ? lo : v > hi ? hi : v;
-}
-function buildAxisCandidate(input) {
-  const { angle, center, targetSpan, per, guards } = input;
-  const c = angle === 0 ? center.x : center.y;
-  const gLow = angle === 0 ? guards.left : guards.top;
-  const gHigh = angle === 0 ? guards.right : guards.bottom;
-  const p = angle === 0 ? center.y : center.x;
-  const pLow = angle === 0 ? guards.top : guards.left;
-  const pHigh = angle === 0 ? guards.bottom : guards.right;
-  const screenEndSpan = 1 - 2 * SCREEN_EDGE_INSET;
-  const edgeSafeStartSpan = 2 * Math.max(0, Math.min(c - gLow, 1 - gHigh - c));
-  const insetStartSpan = 2 * Math.max(0, Math.min(c - SCREEN_EDGE_INSET, 1 - SCREEN_EDGE_INSET - c));
-  const screenStartLimit = edgeSafeStartSpan > 0 ? Math.min(screenEndSpan, edgeSafeStartSpan) : Math.min(screenEndSpan, insetStartSpan);
-  const startLimit = targetSpan !== void 0 ? Math.min(screenStartLimit, targetSpan * TARGET_START_FRACTION) : screenStartLimit;
-  const start2 = per > 1 ? Math.min(startLimit, screenEndSpan / per) : startLimit;
-  const end = Math.min(screenEndSpan, start2 * per);
-  const travel = Math.abs(end - start2);
-  if (!(travel > 0)) return void 0;
-  const endCenter = clamp2(c, SCREEN_EDGE_INSET + end / 2, 1 - SCREEN_EDGE_INSET - end / 2);
-  const downLow = c - start2 / 2;
-  const downHigh = c + start2 / 2;
-  const axisSafe = downLow >= gLow && downHigh <= 1 - gHigh;
-  const perpSafe = p >= pLow && p <= 1 - pHigh;
-  const clearance = Math.min(downLow - gLow, 1 - gHigh - downHigh, p - pLow, 1 - pHigh - p);
-  return {
-    angle,
-    start: start2,
-    end,
-    endCenter,
-    travel,
-    viable: travel >= MIN_VIABLE_TRAVEL,
-    axisSafe,
-    fullyEdgeSafe: axisSafe && perpSafe,
-    clearance
-  };
-}
-function selectPinchCandidate(candidates) {
-  if (candidates.length === 0) return void 0;
-  const rank2 = (c) => c.fullyEdgeSafe ? 0 : c.axisSafe ? 1 : 2;
-  return [...candidates].sort((a, b) => {
-    const byViable = Number(b.viable) - Number(a.viable);
-    if (byViable !== 0) return byViable;
-    const byRank = rank2(a) - rank2(b);
-    if (byRank !== 0) return byRank;
-    if (a.fullyEdgeSafe && b.fullyEdgeSafe) return b.travel - a.travel;
-    return b.clearance - a.clearance || b.travel - a.travel;
-  })[0];
-}
-
 // ../tool-server/src/tools/flows/flow-actions.ts
 var ABORTED_OUTCOME = {
   ok: false,
@@ -147920,16 +148150,16 @@ function offscreenHint(sel) {
   return `no visible element matched selector ${describeSelector(sel)} \u2014 if it is off-screen, add a scroll-to step before this one`;
 }
 async function runDirective(env, step) {
-  if (env.device.platform === "vega" && (step.kind === "tap" || step.kind === "long-press" || step.kind === "type" || step.kind === "scroll-to" || step.kind === "pinch")) {
+  if (env.device.platform === "vega" && (step.kind === "tap" || step.kind === "long-press" || step.kind === "type" || step.kind === "scroll-to" || step.kind === "pinch" || step.kind === "rotate")) {
     return {
       ok: false,
       reason: `${step.kind} is a touch directive and Vega is remote-driven \u2014 move focus with \`tool: tv-remote\` steps (and type via \`tool: keyboard\`) instead`
     };
   }
-  if (step.kind === "pinch" && env.device.platform === "chromium") {
+  if ((step.kind === "pinch" || step.kind === "rotate") && env.device.platform === "chromium") {
     return {
       ok: false,
-      reason: "pinch is unsupported on chromium \u2014 desktop apps have no uniform pinch-zoom mapping (they zoom via ctrl+wheel or their own controls); drive the app's zoom UI with tap/keyboard instead"
+      reason: step.kind === "pinch" ? "pinch is unsupported on chromium \u2014 desktop apps have no uniform pinch-zoom mapping (they zoom via ctrl+wheel or their own controls); drive the app's zoom UI with tap/keyboard instead" : "rotate is unsupported on chromium \u2014 desktop apps have no rotate-gesture idiom; drive the app's rotate controls with tap/keyboard instead"
     };
   }
   switch (step.kind) {
@@ -147950,6 +148180,8 @@ async function runDirective(env, step) {
     }
     case "pinch":
       return runPinch(env, step);
+    case "rotate":
+      return runRotate(env, step);
   }
 }
 async function resolveTargetPoint(env, target) {
@@ -148039,6 +148271,66 @@ async function runPinch(env, step) {
   }
   return { ok: true };
 }
+async function fetchScreenAspect(env) {
+  try {
+    const { screen } = await fetchFlowTree(env.registry, env.device);
+    return screen && screen.width > 0 && screen.height > 0 ? screen.width / screen.height : void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function runRotate(env, step) {
+  let center = { x: 0.5, y: 0.5 };
+  let frame;
+  if (step.selector) {
+    const resolved = await waitForFrame(env, step.selector);
+    if (resolved === "aborted") return ABORTED_OUTCOME;
+    if (!resolved) return { ok: false, reason: offscreenHint(step.selector) };
+    frame = resolved;
+    center = getDescribeTapPoint(resolved);
+  }
+  const aspect = await fetchScreenAspect(env);
+  const guards = systemEdgeGuards(env.device);
+  const candidates = [
+    buildRotateCandidate({
+      startAngle: 0,
+      center,
+      targetSpan: frame?.width,
+      guards,
+      aspect: aspect ?? 1
+    }),
+    buildRotateCandidate({
+      startAngle: 90,
+      center,
+      targetSpan: frame?.height,
+      guards,
+      aspect: aspect ?? 1
+    })
+  ].filter((c) => c !== void 0);
+  const selected = selectRotateCandidate(candidates);
+  if (!selected) {
+    return {
+      ok: false,
+      reason: `rotate found no on-screen orbit radius around (${center.x}, ${center.y})`
+    };
+  }
+  if (env.signal?.aborted) return ABORTED_OUTCOME;
+  try {
+    await invokeOnDevice(env, "gesture-rotate", {
+      centerX: center.x,
+      centerY: center.y,
+      ...aspect === void 0 ? { radius: selected.radiusX } : { radiusX: selected.radiusX, radiusY: selected.radiusY },
+      startAngle: selected.startAngle,
+      // endAngle > startAngle = clockwise in the tool, matching +by.
+      endAngle: selected.startAngle + step.by,
+      durationMs: deriveRotateDurationMs(step.by)
+    });
+  } catch (err) {
+    if (env.signal?.aborted) return ABORTED_OUTCOME;
+    throw err;
+  }
+  return { ok: true };
+}
 async function runType(env, step) {
   const frame = await waitForFrame(env, step.into);
   if (frame === "aborted") return ABORTED_OUTCOME;
@@ -150499,7 +150791,9 @@ ready; \`tool\` calls dispatch through the registry; \`tap\`/\`long-press\`/\`ty
 element and act on it (\`tap: { on, times: 2 }\` double-taps; \`long-press: { on, duration }\` presses and
 holds; \`tap\`/\`long-press\` alternatively take a raw normalized point \u2014 bare \`{ x, y }\` or \`on: { x, y }\`);
 \`scroll-to\` scrolls (momentum-free) until a target is visible; \`pinch\` zooms
-(\`pinch: { on?, scale }\` \u2014 scale > 1 in, < 1 out; screen center when \`on\` is omitted); \`await\` waits
+(\`pinch: { on?, scale }\` \u2014 scale > 1 in, < 1 out; screen center when \`on\` is omitted); \`rotate\` is the
+two-finger rotation gesture (\`rotate: { on?, by }\` \u2014 degrees, + clockwise, within \xB13000\xB0; screen center
+when \`on\` is omitted; distinct from the \`rotate\` tool, which changes device orientation); \`await\` waits
 for a UI condition; \`wait\` pauses for a fixed number of milliseconds; \`assert\` checks one now; \`snapshot\`
 diffs a screenshot against a stored baseline (a missing baseline fails the step \u2014 set updateBaselines
 to adopt the current screen); \`echo\` annotates; \`run\` executes a referenced fragment inline.
@@ -150688,6 +150982,10 @@ function stepTarget(step) {
       const scale = `scale ${step.scale}`;
       return step.selector ? `${selectorLabel2(step.selector)} (${scale})` : scale;
     }
+    case "rotate": {
+      const by = `by ${step.by}\xB0`;
+      return step.selector ? `${selectorLabel2(step.selector)} (${by})` : by;
+    }
     case "snapshot":
       return `"${step.name}"`;
     default:
@@ -150870,7 +151168,8 @@ async function execLeafStep(state3, step, index, scope) {
     case "await":
     case "assert":
     case "scroll-to":
-    case "pinch": {
+    case "pinch":
+    case "rotate": {
       try {
         const r = await runDirective(state3, step);
         if (r.aborted) return { ...base, status: "skip", reason: r.reason };
@@ -150994,7 +151293,7 @@ init_zod();
 
 // ../tool-server/src/utils/workspace-reader.ts
 var import_promises12 = require("node:fs/promises");
-var import_node_path20 = require("node:path");
+var import_node_path21 = require("node:path");
 var import_node_child_process27 = require("node:child_process");
 var import_dotenv = __toESM(require_main());
 async function exists(path38) {
@@ -151082,7 +151381,7 @@ async function detectLockfile(workspacePath) {
   const checks = await Promise.all(
     LOCKFILES.map(async (name) => ({
       name,
-      exists: await exists((0, import_node_path20.join)(workspacePath, name))
+      exists: await exists((0, import_node_path21.join)(workspacePath, name))
     }))
   );
   return checks.find((c) => c.exists)?.name ?? null;
@@ -151101,7 +151400,7 @@ var CI_CONFIGS = [
 ];
 async function detectCiConfig(workspacePath) {
   for (const ci of CI_CONFIGS) {
-    if (await exists((0, import_node_path20.join)(workspacePath, ci.path))) return ci.label;
+    if (await exists((0, import_node_path21.join)(workspacePath, ci.path))) return ci.label;
   }
   return null;
 }
@@ -151122,7 +151421,7 @@ async function detectLintStagedConfig(workspacePath, packageJson) {
     return packageJson["lint-staged"];
   }
   for (const file2 of LINT_STAGED_FILES) {
-    const full = (0, import_node_path20.join)(workspacePath, file2);
+    const full = (0, import_node_path21.join)(workspacePath, file2);
     if (await exists(full)) {
       if (file2.endsWith(".json") || file2 === ".lintstagedrc") {
         return readJsonFile(full);
@@ -151164,7 +151463,7 @@ var CONFIG_FILES = [
 async function detectConfigFiles(workspacePath) {
   const results = await Promise.allSettled(
     CONFIG_FILES.map(async (file2) => {
-      if (await exists((0, import_node_path20.join)(workspacePath, file2))) return file2;
+      if (await exists((0, import_node_path21.join)(workspacePath, file2))) return file2;
       return null;
     })
   );
@@ -151203,7 +151502,7 @@ async function detectEnvFiles(workspacePath) {
   const envFileNames = entries.filter((e) => e === ".env" || e.startsWith(".env."));
   const results = await Promise.all(
     envFileNames.map(async (name) => {
-      const content = await readTextFile((0, import_node_path20.join)(workspacePath, name));
+      const content = await readTextFile((0, import_node_path21.join)(workspacePath, name));
       return {
         name,
         keys: content ? extractEnvKeys(content) : []
@@ -151230,34 +151529,34 @@ async function readWorkspaceSnapshot(workspacePath) {
     ciConfig,
     configFilesFound
   ] = await Promise.all([
-    readJsonFile((0, import_node_path20.join)(workspacePath, "package.json")),
-    readJsonFile((0, import_node_path20.join)(workspacePath, "app.json")),
-    readJsonFile((0, import_node_path20.join)(workspacePath, "eas.json")),
-    readJsonFile((0, import_node_path20.join)(workspacePath, "tsconfig.json")),
-    readTextFile((0, import_node_path20.join)(workspacePath, "metro.config.js")).then(
-      (r) => r ?? readTextFile((0, import_node_path20.join)(workspacePath, "metro.config.ts"))
+    readJsonFile((0, import_node_path21.join)(workspacePath, "package.json")),
+    readJsonFile((0, import_node_path21.join)(workspacePath, "app.json")),
+    readJsonFile((0, import_node_path21.join)(workspacePath, "eas.json")),
+    readJsonFile((0, import_node_path21.join)(workspacePath, "tsconfig.json")),
+    readTextFile((0, import_node_path21.join)(workspacePath, "metro.config.js")).then(
+      (r) => r ?? readTextFile((0, import_node_path21.join)(workspacePath, "metro.config.ts"))
     ),
-    readTextFile((0, import_node_path20.join)(workspacePath, "babel.config.js")).then(
-      (r) => r ?? readTextFile((0, import_node_path20.join)(workspacePath, "babel.config.cjs"))
+    readTextFile((0, import_node_path21.join)(workspacePath, "babel.config.js")).then(
+      (r) => r ?? readTextFile((0, import_node_path21.join)(workspacePath, "babel.config.cjs"))
     ),
-    isDirectory((0, import_node_path20.join)(workspacePath, "ios")),
-    isDirectory((0, import_node_path20.join)(workspacePath, "android")),
+    isDirectory((0, import_node_path21.join)(workspacePath, "ios")),
+    isDirectory((0, import_node_path21.join)(workspacePath, "android")),
     detectLockfile(workspacePath),
     detectEnvFiles(workspacePath),
     detectToolVersions(workspacePath),
-    listDir((0, import_node_path20.join)(workspacePath, "scripts")),
-    listDir((0, import_node_path20.join)(workspacePath, ".husky")),
+    listDir((0, import_node_path21.join)(workspacePath, "scripts")),
+    listDir((0, import_node_path21.join)(workspacePath, ".husky")),
     detectCiConfig(workspacePath),
     detectConfigFiles(workspacePath)
   ]);
-  const iosDir = (0, import_node_path20.join)(workspacePath, "ios");
-  const androidDir = (0, import_node_path20.join)(workspacePath, "android");
+  const iosDir = (0, import_node_path21.join)(workspacePath, "ios");
+  const androidDir = (0, import_node_path21.join)(workspacePath, "android");
   const [iosWorkspace, iosHasPodfile, makefileText, lintStagedConfig, androidHasGradle] = await Promise.all([
     hasIosDir ? findIosWorkspace(iosDir) : Promise.resolve(null),
-    exists((0, import_node_path20.join)(workspacePath, "ios", "Podfile")),
-    readTextFile((0, import_node_path20.join)(workspacePath, "Makefile")),
+    exists((0, import_node_path21.join)(workspacePath, "ios", "Podfile")),
+    readTextFile((0, import_node_path21.join)(workspacePath, "Makefile")),
     detectLintStagedConfig(workspacePath, packageJson),
-    hasAndroidDir ? exists((0, import_node_path20.join)(androidDir, "gradlew")) : Promise.resolve(false)
+    hasAndroidDir ? exists((0, import_node_path21.join)(androidDir, "gradlew")) : Promise.resolve(false)
   ]);
   const metroPort = metroConfigRaw ? extractMetroPort(metroConfigRaw) : null;
   const makefileTargets = makefileText ? extractMakefileTargets(makefileText) : null;