@swmansion/argent 0.32.1-next.21 → 0.32.1-next.22

package/dist/cli-cmds.mjs

@@ -9484,7 +9484,8 @@ var FLAG_REGISTRY = [
   },
   {
     name: "macos-apps",
-    description: "Drive native Mac apps (AppKit, SwiftUI, react-native-macos) from inside the app. Adds the macos platform to list-devices and boot-device, and the file-panel and menu-bar tools. Off by default."
+    description: "Drive native Mac apps (AppKit, SwiftUI, react-native-macos) from inside the app. Adds the macos platform to list-devices and boot-device, and the file-panel and menu-bar tools. On by default; turn it off with `argent disable macos-apps`.",
+    defaultEnabled: true
   }
 ];
 function getFlagDefinition(name, registry2 = FLAG_REGISTRY) {
@@ -35871,7 +35872,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID2 = randomUUID5();
 function readCliVersion() {
   if (true) {
-    return "0.32.1-next.21";
+    return "0.32.1-next.22";
   }
   return "0.0.0";
 }
@@ -36905,8 +36906,18 @@ function durationSuffix(ms) {
   const seconds = Math.round(ms / 1e3);
   return ` (${Math.floor(seconds / 60)}m ${seconds % 60}s)`;
 }
-function printHelp(toStderr = false) {
+async function offersMacosPlatform() {
+  if (!isFeatureEnabled("macos-apps")) return false;
+  if (process.platform === "darwin") return true;
+  try {
+    return (await getResolvedToolsUrl()).url !== null;
+  } catch {
+    return false;
+  }
+}
+async function printHelp(toStderr = false) {
   const print = toStderr ? console.error : console.log;
+  const macos = await offersMacosPlatform() ? " macos |" : "";
   print(`Usage: argent e2e <subcommand> [options]
 
 Run a YAML e2e test without an LLM in the loop. \`run\` takes any of these forms:
@@ -36977,7 +36988,7 @@ Subcommands:
 
 Options (run):
   --device <id>          Device id to run against (auto-detected when omitted)
-  --platform <p>         ios | android | chromium | vega |${isFlagEnabled("macos-apps") ? " macos |" : ""} ios-remote \u2014 narrow
+  --platform <p>         ios | android | chromium | vega |${macos} ios-remote \u2014 narrow
                          auto-detection (ios never picks a remote simulator)
   --update-baselines     Write/refresh screenshot baselines instead of diffing,
                          also those of tests that tool: e2e-execute steps run,
@@ -37684,7 +37695,7 @@ ${renderBatchSummary(counts, durationMs)}`);
 async function e2e(argv, options) {
   const [sub, ...rest] = argv;
   if (!sub || sub === "--help" || sub === "-h") {
-    printHelp();
+    await printHelp();
     return;
   }
   if (sub === "list") {
@@ -37735,17 +37746,17 @@ async function e2e(argv, options) {
   const jsonStream = flagGiven("--json-stream");
   const json2 = !jsonStream && flagGiven("--json");
   if (rest.includes("--help") || rest.includes("-h")) {
-    printHelp(jsonStream);
+    await printHelp(jsonStream);
     return;
   }
-  const usageError = (message, prose) => {
+  const usageError = async (message, prose) => {
     if (json2) {
       console.error(JSON.stringify(errorRecord(message)));
       return exitAfterFlush(2);
     }
     if (jsonStream) writeJsonStreamError(message);
     console.error(prose);
-    printHelp(jsonStream);
+    await printHelp(jsonStream);
     return exitAfterFlush(2);
   };
   let args;
@@ -39890,8 +39901,17 @@ function runToggle(argv, command, registry2) {
   } else {
     console.log(`Disabled flag "${parsed.name}" (${parsed.scope}).`);
   }
+  const shadow = projectShadowNote(parsed.name, parsed.scope, command);
+  if (shadow) console.log(import_picocolors2.default.yellow(shadow));
   return parsed.name;
 }
+function projectShadowNote(name, scope, command) {
+  if (scope !== "global") return void 0;
+  const wanted = command === "enable";
+  const project = readFlags("project");
+  if (!Object.hasOwn(project, name) || project[name] === wanted) return void 0;
+  return `The project flags file ${getFlagsPath("project")} sets "${name}" to ${project[name]}, which overrides the global value, so the flag stays ${wanted ? "off" : "on"} in this project. Run: argent ${command} ${name} --scope project`;
+}
 function enable(argv, registry2 = FLAG_REGISTRY) {
   if (runToggle(argv, "enable", registry2) !== "forward-secrets") return;
   return linkedSecretsNote().then((note) => {

package/dist/client.js

@@ -7805,7 +7805,8 @@ var FLAG_REGISTRY = [
   },
   {
     name: "macos-apps",
-    description: "Drive native Mac apps (AppKit, SwiftUI, react-native-macos) from inside the app. Adds the macos platform to list-devices and boot-device, and the file-panel and menu-bar tools. Off by default."
+    description: "Drive native Mac apps (AppKit, SwiftUI, react-native-macos) from inside the app. Adds the macos platform to list-devices and boot-device, and the file-panel and menu-bar tools. On by default; turn it off with `argent disable macos-apps`.",
+    defaultEnabled: true
   }
 ];
 function getFlagDefinition(name, registry = FLAG_REGISTRY) {

package/dist/installer.mjs

@@ -16981,7 +16981,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID = randomUUID4();
 function readCliVersion() {
   if (true) {
-    return "0.32.1-next.21";
+    return "0.32.1-next.22";
   }
   return "0.0.0";
 }

package/dist/mcp-server.mjs

@@ -24946,7 +24946,8 @@ var FLAG_REGISTRY = [
   },
   {
     name: "macos-apps",
-    description: "Drive native Mac apps (AppKit, SwiftUI, react-native-macos) from inside the app. Adds the macos platform to list-devices and boot-device, and the file-panel and menu-bar tools. Off by default."
+    description: "Drive native Mac apps (AppKit, SwiftUI, react-native-macos) from inside the app. Adds the macos platform to list-devices and boot-device, and the file-panel and menu-bar tools. On by default; turn it off with `argent disable macos-apps`.",
+    defaultEnabled: true
   }
 ];
 function getFlagDefinition(name, registry2 = FLAG_REGISTRY) {

package/dist/tool-server.cjs

@@ -157,7 +157,8 @@ var init_flags = __esm({
       },
       {
         name: "macos-apps",
-        description: "Drive native Mac apps (AppKit, SwiftUI, react-native-macos) from inside the app. Adds the macos platform to list-devices and boot-device, and the file-panel and menu-bar tools. Off by default."
+        description: "Drive native Mac apps (AppKit, SwiftUI, react-native-macos) from inside the app. Adds the macos platform to list-devices and boot-device, and the file-panel and menu-bar tools. On by default; turn it off with `argent disable macos-apps`.",
+        defaultEnabled: true
       }
     ];
     PROJECT_MARKERS = [".argent", ".git", "package.json"];
@@ -79539,10 +79540,14 @@ function platformMatrix(platform, capability41) {
   }
 }
 function macosAppsUnavailableReason() {
-  if (!isFlagEnabled(MACOS_APPS_FLAG)) return MACOS_APPS_FLAG_OFF_REASON;
+  if (!isFeatureEnabled(MACOS_APPS_FLAG)) return MACOS_APPS_FLAG_OFF_REASON;
   if (process.platform !== "darwin") return "native Mac apps can only be driven on macOS";
   return null;
 }
+function isFlagOffered(flag) {
+  if (flag === MACOS_APPS_FLAG) return macosAppsUnavailableReason() === null;
+  return isFeatureEnabled(flag);
+}
 function assertSupported(toolId, capability41, device) {
   if (!capability41) return;
   if (device.platform === "harmony" && !isHarmonyEnabled()) {
@@ -101256,7 +101261,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID = (0, import_node_crypto3.randomUUID)();
 function readCliVersion() {
   if (true) {
-    return "0.32.1-next.21";
+    return "0.32.1-next.22";
   }
   return "0.0.0";
 }
@@ -125697,7 +125702,7 @@ init_capability();
 init_device_info();
 var execFileAsync16 = (0, import_node_util16.promisify)(import_node_child_process20.execFile);
 function isMacosAppsEnabled() {
-  return isFlagEnabled(MACOS_APPS_FLAG);
+  return isFeatureEnabled(MACOS_APPS_FLAG);
 }
 function assertMacosAppsEnabled(toolId, device) {
   const reason2 = macosAppsUnavailableReason();
@@ -141369,7 +141374,7 @@ function scaleDecodedPng(src, scale) {
 // ../tool-server/src/utils/macos-input.ts
 var sleep2 = (ms) => new Promise((r) => setTimeout(r, ms));
 function macosAppServices(device) {
-  return isMacosAppsEnabled() ? { macosApp: macosAppRef(device) } : {};
+  return macosAppsUnavailableReason() === null ? { macosApp: macosAppRef(device) } : {};
 }
 function requireMacosApp(services, toolId, device) {
   assertMacosAppsEnabled(toolId, device);
@@ -143569,10 +143574,6 @@ function isToolExposed(def) {
   if (def.hideWhen?.()) return false;
   return true;
 }
-function isFlagOffered(flag) {
-  if (flag === MACOS_APPS_FLAG) return macosAppsUnavailableReason() === null;
-  return isFlagEnabled(flag);
-}
 function findDependencyMissing(err) {
   return findErrorInCauseChain(err, DependencyMissingError);
 }
@@ -151401,7 +151402,7 @@ HarmonyOS hands the instance to DevEco Studio's Emulator manager, then waits for
         throw new InvalidToolInputError(
           renderFlagGated(
             "Provide exactly one of `udid` (iOS), `avdName` (Android), `vvdImage` (Vega VVD), <flag:harmonyos>`harmonyInstance` (HarmonyOS), </flag:harmonyos><flag:macos-apps>`macosAppPath` (Mac app), </flag:macos-apps>or `electronAppPath` (Electron).",
-            isFlagEnabled
+            isFlagOffered
           ),
           {
             error_code: FAILURE_CODES.BOOT_DEVICE_TARGET_SELECTION_INVALID,
@@ -154039,7 +154040,6 @@ async function assertChromiumWindowVisible(chromium, action) {
 
 // ../tool-server/src/tools/gesture-tap/index.ts
 init_device_info();
-init_src();
 init_capability();
 var sleep4 = (ms) => new Promise((r) => setTimeout(r, ms));
 function tapDescription(params, tense) {
@@ -154159,7 +154159,7 @@ Before tapping, take the coordinates from \`describe\` on every platform (on Chr
       throw new InvalidToolInputError(
         renderFlagGated(
           `gesture-tap button "right" is a mouse right-click${refusal}`,
-          isFlagEnabled
+          isFlagOffered
         )
       );
     }
@@ -174602,7 +174602,7 @@ function isIdleCondition(raw, kind) {
 }
 var LAUNCH_PLATFORMS = ["ios", "android", "chromium", "vega", "macos"];
 function namedLaunchPlatforms() {
-  return LAUNCH_PLATFORMS.filter((p) => p !== "macos" || isFlagEnabled(MACOS_APPS_FLAG));
+  return LAUNCH_PLATFORMS.filter((p) => p !== "macos" || isFlagOffered(MACOS_APPS_FLAG));
 }
 var SELECTABLE_PLATFORMS = [...LAUNCH_PLATFORMS, "ios-remote"];
 function authoringPlatform(platform) {
@@ -174721,7 +174721,7 @@ function parseLaunch(raw) {
   }
   return badEntry(
     { launch: raw },
-    `launch needs an app id (bare string) or a per-platform map ({ native | ${namedLaunchPlatforms().filter((p) => p !== "chromium").join(" | ")}: <app id>, ios${isFlagEnabled(MACOS_APPS_FLAG) ? " | macos" : ""}: { app, args }, chromium: <app path> | { path, args } })`
+    `launch needs an app id (bare string) or a per-platform map ({ native | ${namedLaunchPlatforms().filter((p) => p !== "chromium").join(" | ")}: <app id>, ios${isFlagOffered(MACOS_APPS_FLAG) ? " | macos" : ""}: { app, args }, chromium: <app path> | { path, args } })`
   );
 }
 var STEP_DIRECTIVE_KEYS = [
@@ -176024,8 +176024,8 @@ var path52 = __toESM(require("node:path"));
 init_src2();
 
 // ../tool-server/src/tools/flows/flow-actions.ts
-init_src();
 init_device_info();
+init_capability();
 
 // ../tool-server/src/tools/flows/flow-device.ts
 init_src2();
@@ -176073,8 +176073,9 @@ function macosAppHint(devices, platform) {
   return " A Mac app is picked only with --platform macos or --device.";
 }
 function macosFlagHint(platform) {
-  if (platform !== "macos" || isMacosAppsEnabled()) return "";
-  return " The macos-apps flag is off, so no Mac app is listed. Run: argent enable macos-apps.";
+  const reason2 = platform === "macos" ? macosAppsUnavailableReason() : null;
+  if (!reason2) return "";
+  return reason2 === MACOS_APPS_FLAG_OFF_REASON ? " The macos-apps flag is off, so no Mac app is listed. Run: argent enable macos-apps." : ` No Mac app is listed: ${reason2}.`;
 }
 function describeDevice(d) {
   return `${deviceEntryId(d) ?? "?"} (${d.platform}${d.state ? `, ${d.state}` : ""})`;
@@ -176171,9 +176172,8 @@ async function candidateRuntimeKind(d) {
 async function resolveFlowDevice(registry2, ctx, opts) {
   if (opts.device) {
     const device = resolveDevice(opts.device);
-    if (device.platform === "macos" && !isMacosAppsEnabled()) {
-      throw deviceResolutionError(`Cannot run on ${device.id}: ${MACOS_APPS_FLAG_OFF_REASON}`);
-    }
+    const macosRefusal = device.platform === "macos" ? macosAppsUnavailableReason() : null;
+    if (macosRefusal) throw deviceResolutionError(`Cannot run on ${device.id}: ${macosRefusal}`);
     return device;
   }
   const { devices } = await invokeSubTool(registry2, ctx, "list-devices", {});
@@ -177323,7 +177323,7 @@ async function runDirective(env, step) {
       reason: renderFlagGated(
         platform === "chromium" ? `tap with button: right is a mouse right-click<flag:macos-apps>, which argent sends only to a Mac app</flag:macos-apps>; argent does not support it on chromium yet` : `tap with button: right is a mouse right-click<flag:macos-apps>, which only a Mac app takes</flag:macos-apps>; ${platform} takes none` + // HarmonyOS refuses long-press too.
         (platform === "harmony" ? "" : ". On a touch screen, open a context menu with long-press"),
-        isFlagEnabled
+        isFlagOffered
       )
     };
   }
@@ -178653,7 +178653,6 @@ function stepAnchor(step) {
 // ../tool-server/src/tools/flows/flow-add-step.ts
 init_device_info();
 init_capability();
-init_src();
 var REPLAY_TREE_SOURCES = {
   ios: "native-devtools",
   android: "android-devtools",
@@ -178967,7 +178966,7 @@ function directiveCommandHint(command) {
   if (command === "swipe") {
     return renderFlagGated(
       `"swipe" is an e2e test directive, not a tool. Record the movement by calling \`gesture-swipe\` (\`gesture-drag\` on chromium<flag:macos-apps> and macOS</flag:macos-apps>, where gesture-swipe is not supported) through e2e-add-step. It is stored as the raw \`tool:\` step for whichever one you called; converting it to \`swipe:\` is part of the polish pass.`,
-      isFlagEnabled
+      isFlagOffered
     );
   }
   if (command === "echo") {
@@ -178985,7 +178984,7 @@ function directiveCommandHint(command) {
   if (command === "scroll-to") {
     return renderFlagGated(
       `"scroll-to" is an e2e test directive, not a tool, and no tool records one \u2014 it SEARCHES, scrolling until the target is visible, which no single recorded gesture reproduces. Record the movement with \`gesture-swipe\` (\`gesture-scroll\` on chromium<flag:macos-apps> and macOS</flag:macos-apps>) if the path needs it, then add the \`scroll-to:\` step by hand during polish and prove it with the replay.`,
-      isFlagEnabled
+      isFlagOffered
     );
   }
   if (command === "snapshot") {
@@ -186891,7 +186890,7 @@ Fails if no item matches (the error lists the titles at that level), if the item
 // ../tool-server/src/utils/setup-registry.ts
 init_device_info();
 function createRegistry() {
-  const registry2 = new Registry({ isFlagEnabled: (flag) => isFlagEnabled(flag) });
+  const registry2 = new Registry({ isFlagEnabled: (flag) => isFeatureEnabled(flag) });
   setLivePanelSourceProvider((udid) => {
     const ref = axServiceRef(resolveDevice(udid));
     return registry2.resolveService(ref.urn, ref.options);
@@ -187546,7 +187545,7 @@ function getAvailableTools() {
     const def = registry2.getTool(id);
     return renderFlagGated(
       { id: def.id, description: def.description, inputSchema: def.inputSchema },
-      isFlagEnabled
+      isFeatureEnabled
     );
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swmansion/argent",
-  "version": "0.32.1-next.21",
+  "version": "0.32.1-next.22",
   "mcpName": "io.github.software-mansion/argent",
   "description": "MCP server for iOS Simulator, Android Emulator, Chromium app and Mac app control",
   "license": "Apache-2.0",

package/skills/argent-macos-app-interact/SKILL.md

@@ -7,7 +7,7 @@ description: Drive a native Mac app (AppKit, SwiftUI, react-native-macos) throug
 
 ## Contract
 
-- Needs the `macos-apps` flag. When a tool says it is off, tell the user to run the command it names. Do not change the flag yourself.
+- Needs the `macos-apps` flag, which is on by default. When a tool says it is off, tell the user to run the command it names. Do not change the flag yourself.
 - One app is one device. `list-devices` shows only apps argent started that still run, also those of other sessions: never pick one unless the user named that app or this session started it.
 - Start an app with `boot-device {macosAppPath: "<abs path>.app"}`, never with `open` or Xcode. Use `launch-app` only for an app argent already started: with no recorded path it takes whichever copy Spotlight finds.
 - Build the `.app` without starting it: `xcodebuild ... build`, then take the bundle from `BUILT_PRODUCTS_DIR` (`xcodebuild -showBuildSettings`). Xcode Run and `react-native run-macos` start a copy without the argent library: `boot-device` then fails with `already running ... without the argent library`. Retry with `force: true`, but ask the user first when they may have work open in that copy.