@swmansion/argent 0.20.1-next.12 → 0.20.1-next.13

package/dist/cli-cmds.mjs

@@ -1802,6 +1802,10 @@ var FLAG_REGISTRY = [
     name: "tool-server-event-log",
     description: "Write structured tool-server lifecycle events to a JSONL file."
   },
+  {
+    name: "microinteractions",
+    description: "Amplify device actions with matching animations of the host window, so what happens on the guest is also visible on the desktop. Purely cosmetic, macOS only, and never affects whether the underlying action succeeds. Off by default."
+  },
   {
     name: "video-watermark",
     description: "Overlay the argent corner watermark on recorded screen videos. On by default; turn it off with `argent disable video-watermark`.",

package/dist/tool-server.cjs

@@ -85071,7 +85071,7 @@ var require_log = __commonJS({
       if (logLevel === "debug")
         console.log(...messages);
     }
-    function warn(logLevel, warning) {
+    function warn2(logLevel, warning) {
       if (logLevel === "debug" || logLevel === "warn") {
         if (typeof node_process.emitWarning === "function")
           node_process.emitWarning(warning);
@@ -85080,7 +85080,7 @@ var require_log = __commonJS({
       }
     }
     exports2.debug = debug;
-    exports2.warn = warn;
+    exports2.warn = warn2;
   }
 });
 
@@ -90786,6 +90786,10 @@ var FLAG_REGISTRY = [
     name: "tool-server-event-log",
     description: "Write structured tool-server lifecycle events to a JSONL file."
   },
+  {
+    name: "microinteractions",
+    description: "Amplify device actions with matching animations of the host window, so what happens on the guest is also visible on the desktop. Purely cosmetic, macOS only, and never affects whether the underlying action succeeds. Off by default."
+  },
   {
     name: "video-watermark",
     description: "Overlay the argent corner watermark on recorded screen videos. On by default; turn it off with `argent disable video-watermark`.",
@@ -99605,9 +99609,9 @@ ${debugInfo}`);
     this.#dispose.length = 0;
     if (this.#async.length > 0) {
       try {
-        let warn;
+        let warn2;
         const timeout = new Promise((resolve11) => {
-          warn = setTimeout(() => {
+          warn2 = setTimeout(() => {
             if (DEV) {
               console.warn("spawn is still running after 5s; continuing anyway", this.#stack);
             }
@@ -99615,8 +99619,8 @@ ${debugInfo}`);
           }, 5e3);
         });
         await Promise.race([Promise.all(this.#async), timeout]);
-        if (warn)
-          clearTimeout(warn);
+        if (warn2)
+          clearTimeout(warn2);
         this.#async.length = 0;
       } catch (error52) {
         console.error("async effect error", error52);
@@ -119223,6 +119227,18 @@ function readMb(config2, key2) {
   return (m[2] || "M").toLowerCase().startsWith("g") ? n * 1024 : n;
 }
 
+// ../tool-server/src/utils/no-window-env.ts
+var TRUTHY = /* @__PURE__ */ new Set(["1", "true", "yes"]);
+function truthyEnv(name) {
+  return TRUTHY.has((process.env[name] ?? "").trim().toLowerCase());
+}
+function iosHeadlessFromEnv() {
+  return truthyEnv("ARGENT_SIMULATOR_NO_WINDOW");
+}
+function androidHeadlessFromEnv() {
+  return truthyEnv("ARGENT_EMULATOR_NO_WINDOW");
+}
+
 // ../tool-server/src/utils/vega-vvd.ts
 init_src();
 init_adb();
@@ -119765,14 +119781,6 @@ function selectGpuMode() {
   }
   return process.platform === "linux" ? "swiftshader" : "auto";
 }
-function selectExtraEmulatorArgs() {
-  const trimmed = (process.env.ARGENT_EMULATOR_NO_WINDOW ?? "").trim().toLowerCase();
-  return ["1", "true", "yes"].includes(trimmed) ? ["-no-window"] : [];
-}
-function iosHeadlessFromEnv() {
-  const trimmed = (process.env.ARGENT_SIMULATOR_NO_WINDOW ?? "").trim().toLowerCase();
-  return ["1", "true", "yes"].includes(trimmed);
-}
 var BOOT_POLL_INTERVALS_MS = {
   serialByAvd: 1500,
   // findSerialByAvdName: re-scan when >1 new emulator appeared
@@ -120156,7 +120164,7 @@ async function bootAndroidImpl(params) {
   await ensureDep("adb");
   await ensureDep("emulator");
   const gpuMode = selectGpuMode();
-  const extraEmulatorArgs = selectExtraEmulatorArgs();
+  const extraEmulatorArgs = androidHeadlessFromEnv() ? ["-no-window"] : [];
   for (const msg of linuxBootDiagnostics(params.avdName) ?? []) {
     console.warn(`[boot-device:linux] ${msg}`);
   }
@@ -123335,10 +123343,211 @@ var shakeZodSchema = external_exports.object({
 });
 
 // ../tool-server/src/tools/shake/platforms/ios.ts
-var import_node_child_process26 = require("node:child_process");
+var import_node_child_process27 = require("node:child_process");
 var import_node_util20 = require("node:util");
 init_src();
-var execFileAsync20 = (0, import_node_util20.promisify)(import_node_child_process26.execFile);
+
+// ../tool-server/src/utils/window-shake.ts
+var import_node_child_process26 = require("node:child_process");
+var MICROINTERACTIONS_FLAG = "microinteractions";
+var AMPLITUDE = 22;
+var STEPS = 60;
+var OSASCRIPT_TIMEOUT_MS = 5e3;
+var ORIGIN_MARKER = "ARGENT_WINDOW_ORIGIN:";
+function warn(detail) {
+  process.stderr.write(`[shake:window] skipped the window animation: ${detail}
+`);
+}
+function asStringLiteral(value) {
+  return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}
+function titleMatchLookup(procNamesExpr, needles) {
+  return `
+	set win to missing value
+	set needles to {${needles.map(asStringLiteral).join(", ")}}
+	set procNames to ${procNamesExpr}
+	repeat with procRef in procNames
+		set procName to contents of procRef
+		set winTitles to {}
+		try
+			tell process procName to set winTitles to name of every window
+		end try
+		repeat with idx from 1 to (count of winTitles)
+			set winTitle to item idx of winTitles
+			-- A GUI app can carry an unnamed helper window alongside the real one.
+			if winTitle is not missing value then
+				repeat with needle in needles
+					if winTitle contains (contents of needle) then
+						set win to window idx of process procName
+						exit repeat
+					end if
+				end repeat
+			end if
+			if win is not missing value then exit repeat
+		end repeat
+		if win is not missing value then exit repeat
+	end repeat`;
+}
+function windowLookup(needles) {
+  if (needles.length === 0) {
+    return `
+	set win to missing value
+	repeat with procRef in {"Simulator", "Device Hub"}
+		-- A repeat variable is a reference into the list and "process <ref>"
+		-- will not coerce one, so without "contents of" the lookup misses.
+		set procName to contents of procRef
+		if exists (process procName) then
+			tell process procName
+				if (count of windows) > 0 then set win to window 1
+			end tell
+		end if
+		if win is not missing value then exit repeat
+	end repeat`;
+  }
+  return titleMatchLookup(
+    `name of every process whose name is "Simulator" or name is "Device Hub"`,
+    needles
+  );
+}
+var WOBBLE_OFFSETS = Array.from(
+  { length: STEPS + 1 },
+  (_, i) => {
+    const t = i / STEPS;
+    const decay = Math.exp(-4 * t);
+    const phase = 2 * Math.PI * 3.5 * t;
+    return [
+      Math.round(AMPLITUDE * decay * Math.sin(phase)),
+      Math.round(AMPLITUDE / 3 * decay * Math.sin(2 * phase))
+    ];
+  }
+);
+var OFFSETS_LITERAL = WOBBLE_OFFSETS.map(([dx, dy]) => `{${dx}, ${dy}}`).join(", ");
+function animationScript(needles) {
+  return `on run
+	tell application "System Events"${windowLookup(needles)}
+		if win is missing value then error "no matching window"
+		set origin to position of win
+		set ox to item 1 of origin
+		set oy to item 2 of origin
+		log "${ORIGIN_MARKER}" & ox & "," & oy
+
+		set offsets to {${OFFSETS_LITERAL}}
+		repeat with pair in offsets
+			set position of win to {ox + (item 1 of pair), oy + (item 2 of pair)}
+		end repeat
+
+		set position of win to {ox, oy}
+		delay 0.05
+		set position of win to {ox, oy}
+	end tell
+end run
+`;
+}
+function restoreScript(needles, ox, oy) {
+  return `on run
+	tell application "System Events"${windowLookup(needles)}
+		if win is missing value then error "no matching window"
+		set position of win to {${ox}, ${oy}}
+	end tell
+end run
+`;
+}
+function runOsascript(script) {
+  return new Promise((resolve11, reject) => {
+    const child = (0, import_node_child_process26.execFile)(
+      "/usr/bin/osascript",
+      ["-"],
+      { timeout: OSASCRIPT_TIMEOUT_MS },
+      (err, _stdout, stderr) => {
+        if (err) {
+          const raw = String(stderr ?? "");
+          const detail = raw.split("\n").filter((line) => !line.includes(ORIGIN_MARKER)).join("\n").trim() || err.message || "osascript failed";
+          const failure = new Error(detail);
+          failure.wasKilled = Boolean(
+            err.killed || err.signal
+          );
+          failure.rawStderr = raw;
+          reject(failure);
+          return;
+        }
+        resolve11();
+      }
+    );
+    child.on("error", (err) => reject(err));
+    child.stdin?.on("error", () => {
+    });
+    child.stdin?.end(script);
+  });
+}
+async function restoreOriginAfterKill(needles, rawStderr) {
+  const match = rawStderr.match(new RegExp(`${ORIGIN_MARKER}\\s*(-?\\d+)\\s*,\\s*(-?\\d+)`));
+  if (!match) return;
+  try {
+    await runOsascript(restoreScript(needles, Number(match[1]), Number(match[2])));
+  } catch {
+  }
+}
+async function prepareHostWindowShake(target) {
+  const inert = { begin: () => {
+  }, settle: () => Promise.resolve() };
+  try {
+    if (!isFeatureEnabled(MICROINTERACTIONS_FLAG)) return inert;
+    if (process.platform !== "darwin") return inert;
+    if (iosHeadlessFromEnv()) return inert;
+    let deviceSet = null;
+    try {
+      deviceSet = await deviceSetForUdid(target.udid);
+    } catch {
+    }
+    if (deviceSet !== null) return inert;
+    const needles = target.name ? [target.name] : [];
+    const script = animationScript(needles);
+    let inFlight = null;
+    let dead = false;
+    let warned2 = false;
+    const warnOnce = (detail) => {
+      if (warned2) return;
+      warned2 = true;
+      warn(detail);
+    };
+    return {
+      begin() {
+        if (dead || inFlight !== null) return;
+        let run2;
+        try {
+          run2 = runOsascript(script);
+        } catch (err) {
+          dead = true;
+          warnOnce(err instanceof Error ? err.message : String(err));
+          return;
+        }
+        inFlight = run2.then(
+          () => {
+            inFlight = null;
+          },
+          async (err) => {
+            dead = true;
+            const failure = err;
+            if (failure.wasKilled && typeof failure.rawStderr === "string") {
+              await restoreOriginAfterKill(needles, failure.rawStderr);
+            }
+            warnOnce(err instanceof Error ? err.message : String(err));
+            inFlight = null;
+          }
+        );
+      },
+      settle() {
+        return inFlight ?? Promise.resolve();
+      }
+    };
+  } catch (err) {
+    warn(err instanceof Error ? err.message : String(err));
+    return inert;
+  }
+}
+
+// ../tool-server/src/tools/shake/platforms/ios.ts
+var execFileAsync20 = (0, import_node_util20.promisify)(import_node_child_process27.execFile);
 var SHAKE_NOTIFICATION = "com.apple.UIKit.SimulatorShake";
 var SHAKE_INTERVAL_MS = 400;
 var sleep10 = (ms) => new Promise((r) => setTimeout(r, ms));
@@ -123374,8 +123583,10 @@ var iosImpl4 = {
     const count2 = params.count ?? 1;
     if (await isTvOsSimulator(udid)) rejectTv("shake", device);
     const args = await simctlArgsForUdid(udid, ["spawn", udid, ...NOTIFYUTIL_ARGV]);
+    const shaker = await prepareHostWindowShake({ kind: "ios", udid, name: device.name });
     for (let i = 0; i < count2; i++) {
       if (i > 0) await sleep10(SHAKE_INTERVAL_MS);
+      shaker.begin();
       try {
         await execFileAsync20("xcrun", args, { timeout: 15e3 });
       } catch (err) {
@@ -123383,6 +123594,7 @@ var iosImpl4 = {
         throw shakeFailure(udid, error52.message, error52);
       }
     }
+    await shaker.settle();
     return { shaken: true, count: count2 };
   }
 };
@@ -142770,7 +142982,7 @@ Returns { stopped } - the URNs of the services that were actually live and got s
 
 // ../tool-server/src/tools/simulator/stop-metro.ts
 init_zod();
-var import_node_child_process27 = require("node:child_process");
+var import_node_child_process28 = require("node:child_process");
 function parseNetstatListeningPids(netstatOutput, port) {
   const pids = /* @__PURE__ */ new Set();
   for (const line of netstatOutput.split(/\r?\n/)) {
@@ -142786,7 +142998,7 @@ function parseNetstatListeningPids(netstatOutput, port) {
 }
 function listeningPids(port) {
   if (process.platform === "win32") {
-    const output2 = (0, import_node_child_process27.execFileSync)("netstat", ["-ano"], {
+    const output2 = (0, import_node_child_process28.execFileSync)("netstat", ["-ano"], {
       encoding: "utf-8",
       timeout: 5e3,
       // `netstat -ano` dumps every socket on the host; a busy box easily
@@ -142796,7 +143008,7 @@ function listeningPids(port) {
     });
     return parseNetstatListeningPids(output2, port);
   }
-  const output = (0, import_node_child_process27.execFileSync)("lsof", ["-ti", `tcp:${port}`, "-sTCP:LISTEN"], {
+  const output = (0, import_node_child_process28.execFileSync)("lsof", ["-ti", `tcp:${port}`, "-sTCP:LISTEN"], {
     encoding: "utf-8",
     timeout: 5e3
   }).trim();
@@ -148797,10 +149009,10 @@ async function runSnapshot(env, opts) {
 }
 
 // ../tool-server/src/utils/status-bar.ts
-var import_node_child_process28 = require("node:child_process");
+var import_node_child_process29 = require("node:child_process");
 var import_node_util21 = require("node:util");
 init_adb();
-var execFileAsync23 = (0, import_node_util21.promisify)(import_node_child_process28.execFile);
+var execFileAsync23 = (0, import_node_util21.promisify)(import_node_child_process29.execFile);
 var DEMO_BROADCAST = "am broadcast -a com.android.systemui.demo";
 async function pinStatusBar(device) {
   try {
@@ -150152,7 +150364,7 @@ init_zod();
 // ../tool-server/src/utils/workspace-reader.ts
 var import_promises12 = require("node:fs/promises");
 var import_node_path21 = require("node:path");
-var import_node_child_process29 = require("node:child_process");
+var import_node_child_process30 = require("node:child_process");
 var import_dotenv2 = __toESM(require_main());
 async function exists(path40) {
   try {
@@ -150196,7 +150408,7 @@ async function listDir(path40) {
 var COMMAND_TIMEOUT_MS = 3e3;
 function runVersionCommand(cmd, args, cwd) {
   return new Promise((resolve11) => {
-    const child = (0, import_node_child_process29.execFile)(cmd, args, { cwd, timeout: COMMAND_TIMEOUT_MS }, (err, stdout) => {
+    const child = (0, import_node_child_process30.execFile)(cmd, args, { cwd, timeout: COMMAND_TIMEOUT_MS }, (err, stdout) => {
       if (err) {
         resolve11(null);
         return;
@@ -150485,7 +150697,7 @@ Fails if the workspacePath is not an absolute path or the directory cannot be ac
 };
 
 // ../tool-server/src/tools/system/update-argent.ts
-var import_node_child_process30 = require("node:child_process");
+var import_node_child_process31 = require("node:child_process");
 var fs51 = __toESM(require("node:fs"));
 var path36 = __toESM(require("node:path"));
 init_zod();
@@ -150620,7 +150832,7 @@ var updateArgentTool = {
       if (spawnRoot) updateArgs.push("--project-root", spawnRoot);
       const cmd = cliEntry ? process.execPath : "argent";
       const args = cliEntry ? [cliEntry, ...updateArgs] : updateArgs;
-      const child = (0, import_node_child_process30.spawn)(cmd, args, {
+      const child = (0, import_node_child_process31.spawn)(cmd, args, {
         detached: true,
         stdio: "ignore",
         env: { ...process.env, ARGENT_UPDATE_TRIGGER: "mcp_update" }
@@ -151546,9 +151758,9 @@ function probeArgentToolServer(host, port, timeoutMs = 500) {
 
 // ../tool-server/src/utils/simulator-watcher.ts
 var fs53 = __toESM(require("node:fs"));
-var import_node_child_process31 = require("node:child_process");
+var import_node_child_process32 = require("node:child_process");
 var import_node_util22 = require("node:util");
-var execFileAsync24 = (0, import_node_util22.promisify)(import_node_child_process31.execFile);
+var execFileAsync24 = (0, import_node_util22.promisify)(import_node_child_process32.execFile);
 var POLL_INTERVAL_MS2 = 1e4;
 async function getBootedUdidsInSet(deviceSet) {
   const { stdout } = await execFileAsync24("xcrun", [
@@ -151624,7 +151836,7 @@ function startSimulatorWatcher(registry2) {
 }
 
 // ../tool-server/src/utils/preview-window.ts
-var import_node_child_process32 = require("node:child_process");
+var import_node_child_process33 = require("node:child_process");
 var fs54 = __toESM(require("node:fs"));
 var os14 = __toESM(require("node:os"));
 var path38 = __toESM(require("node:path"));
@@ -151656,10 +151868,10 @@ function ensureLensAppBundle(electronBin) {
     fs54.copyFileSync(path38.join(realContents, "Info.plist"), plist);
     const setPlist = (entry, value) => {
       try {
-        (0, import_node_child_process32.execFileSync)("/usr/libexec/PlistBuddy", ["-c", `Set :${entry} ${value}`, plist]);
+        (0, import_node_child_process33.execFileSync)("/usr/libexec/PlistBuddy", ["-c", `Set :${entry} ${value}`, plist]);
       } catch {
         try {
-          (0, import_node_child_process32.execFileSync)("/usr/libexec/PlistBuddy", ["-c", `Add :${entry} string ${value}`, plist]);
+          (0, import_node_child_process33.execFileSync)("/usr/libexec/PlistBuddy", ["-c", `Add :${entry} string ${value}`, plist]);
         } catch {
         }
       }
@@ -151718,7 +151930,7 @@ function createPreviewWindowManager(opts = {}) {
     const wrapperBin = ensureLensAppBundle(electronBin);
     const launchBin = wrapperBin ?? electronBin;
     const launchArgs = wrapperBin ? ["--no-sandbox", mainScript] : [mainScript];
-    const next = (0, import_node_child_process32.spawn)(launchBin, launchArgs, {
+    const next = (0, import_node_child_process33.spawn)(launchBin, launchArgs, {
       // Strip ELECTRON_RUN_AS_NODE so the child boots as a GUI Electron app, not
       // a bare Node runtime (see electronGuiChildEnv). An Electron-based MCP
       // host puts it in our env, and inheriting it makes main.cjs crash at

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swmansion/argent",
-  "version": "0.20.1-next.12",
+  "version": "0.20.1-next.13",
   "mcpName": "io.github.software-mansion/argent",
   "description": "MCP server for iOS Simulator and Android Emulator control",
   "license": "Apache-2.0",