@swmansion/argent 0.32.1-next.13 → 0.32.1-next.15

package/README.md

@@ -7,7 +7,7 @@
 [![Ad](https://swm-delivery.com/www/images/zone-gh-argent-2?n=1)](https://swm-delivery.com/www/delivery/ck-slug.php?zoneid=zone-gh-argent-2&n=1)
 [![Ad](https://swm-delivery.com/www/images/zone-gh-argent-3?n=1)](https://swm-delivery.com/www/delivery/ck-slug.php?zoneid=zone-gh-argent-3&n=1)
 
-**[Argent](https://argent.swmansion.com)** gives your AI assistant direct control of iOS simulators, Android emulators and devices, TVs (Apple TV, Android TV, Fire TV) and Electron/Chromium apps. Tap a button, profile a screen, reproduce a bug - without leaving the CLI.
+**[Argent](https://argent.swmansion.com)** gives your AI assistant direct control of iOS simulators, Android emulators and devices, TVs (Apple TV, Android TV, Fire TV), Electron/Chromium apps and native Mac apps. Tap a button, profile a screen, reproduce a bug - without leaving the CLI.
 
 ```bash
 npx @swmansion/argent@latest init  # pnpm: pnpm dlx @swmansion/argent@latest init

package/dist/cli-cmds.mjs

@@ -9481,6 +9481,10 @@ var FLAG_REGISTRY = [
     name: "video-watermark",
     description: "Overlay the argent corner watermark on recorded screen videos. On by default; turn it off with `argent disable video-watermark`.",
     defaultEnabled: true
+  },
+  {
+    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."
   }
 ];
 function getFlagDefinition(name, registry2 = FLAG_REGISTRY) {
@@ -10666,6 +10670,8 @@ var FAILURE_CODES = {
   REACT_PROFILER_START_FAILED: "REACT_PROFILER_START_FAILED",
   REACT_PROFILER_START_VERIFY_FAILED: "REACT_PROFILER_START_VERIFY_FAILED",
   REACT_PROFILER_SESSION_TORN_DOWN: "REACT_PROFILER_SESSION_TORN_DOWN",
+  REACT_PROFILER_SESSION_TAKEN_OVER: "REACT_PROFILER_SESSION_TAKEN_OVER",
+  REACT_PROFILER_STOP_IN_PROGRESS: "REACT_PROFILER_STOP_IN_PROGRESS",
   REACT_PROFILER_HOOK_ERROR: "REACT_PROFILER_HOOK_ERROR",
   REACT_PROFILER_ANALYZE_NO_DATA: "REACT_PROFILER_ANALYZE_NO_DATA",
   NATIVE_PROFILER_FACTORY_OPTIONS_MISSING: "NATIVE_PROFILER_FACTORY_OPTIONS_MISSING",
@@ -10744,6 +10750,32 @@ var FAILURE_CODES = {
   CHROMIUM_ELECTRON_SPAWN_FAILED: "CHROMIUM_ELECTRON_SPAWN_FAILED",
   CHROMIUM_ELECTRON_CDP_TIMEOUT: "CHROMIUM_ELECTRON_CDP_TIMEOUT",
   CHROMIUM_ELECTRON_EXITED_BEFORE_READY: "CHROMIUM_ELECTRON_EXITED_BEFORE_READY",
+  /**
+   * Native Mac apps (the `macos-apps` flag)
+   * @see [macos-app.ts](../../tool-server/src/blueprints/macos-app.ts)
+   */
+  MACOS_APP_UNSUPPORTED_HOST: "MACOS_APP_UNSUPPORTED_HOST",
+  MACOS_APP_PATH_INVALID: "MACOS_APP_PATH_INVALID",
+  MACOS_APP_BUNDLE_INVALID: "MACOS_APP_BUNDLE_INVALID",
+  MACOS_APP_NOT_FOUND: "MACOS_APP_NOT_FOUND",
+  MACOS_APP_HARDENED_RUNTIME: "MACOS_APP_HARDENED_RUNTIME",
+  MACOS_APP_LIBRARY_MISSING: "MACOS_APP_LIBRARY_MISSING",
+  MACOS_APP_LIBRARY_STAGE_FAILED: "MACOS_APP_LIBRARY_STAGE_FAILED",
+  MACOS_APP_ALREADY_RUNNING: "MACOS_APP_ALREADY_RUNNING",
+  MACOS_APP_SPAWN_FAILED: "MACOS_APP_SPAWN_FAILED",
+  MACOS_APP_EXITED_BEFORE_READY: "MACOS_APP_EXITED_BEFORE_READY",
+  MACOS_APP_HANDSHAKE_TIMEOUT: "MACOS_APP_HANDSHAKE_TIMEOUT",
+  MACOS_APP_HANDSHAKE_INVALID: "MACOS_APP_HANDSHAKE_INVALID",
+  MACOS_APP_NOT_RUNNING: "MACOS_APP_NOT_RUNNING",
+  MACOS_APP_NOT_CONNECTED: "MACOS_APP_NOT_CONNECTED",
+  MACOS_APP_CONNECTION_LOST: "MACOS_APP_CONNECTION_LOST",
+  MACOS_APP_CONNECTION_CLOSED: "MACOS_APP_CONNECTION_CLOSED",
+  MACOS_APP_RPC_TIMEOUT: "MACOS_APP_RPC_TIMEOUT",
+  MACOS_APP_RPC_ERROR: "MACOS_APP_RPC_ERROR",
+  MACOS_APP_TERMINATE_FAILED: "MACOS_APP_TERMINATE_FAILED",
+  MACOS_APP_BUNDLE_ID_MISMATCH: "MACOS_APP_BUNDLE_ID_MISMATCH",
+  MACOS_APP_OPEN_URL_FAILED: "MACOS_APP_OPEN_URL_FAILED",
+  MACOS_APP_FILE_ACCESS_FAILED: "MACOS_APP_FILE_ACCESS_FAILED",
   KEYBOARD_KEY_UNSUPPORTED: "KEYBOARD_KEY_UNSUPPORTED",
   KEYBOARD_CHARACTER_UNSUPPORTED: "KEYBOARD_CHARACTER_UNSUPPORTED",
   KEYBOARD_TEXT_AND_KEY_COMBINED: "KEYBOARD_TEXT_AND_KEY_COMBINED",
@@ -35083,7 +35115,8 @@ var PLATFORMS = [
   "vega",
   "harmony",
   "tvos",
-  "android-tv"
+  "android-tv",
+  "macos"
 ];
 var DEVICE_KINDS = [
   "simulator",
@@ -35838,7 +35871,7 @@ var _CI_VENDOR_COUNT_FOR_TEST = vendors_default.length;
 var SESSION_ID2 = randomUUID5();
 function readCliVersion() {
   if (true) {
-    return "0.32.1-next.13";
+    return "0.32.1-next.15";
   }
   return "0.0.0";
 }
@@ -36944,7 +36977,7 @@ Subcommands:
 
 Options (run):
   --device <id>          Device id to run against (auto-detected when omitted)
-  --platform <p>         ios | android | chromium | vega | ios-remote \u2014 narrow
+  --platform <p>         ios | android | chromium | vega |${isFlagEnabled("macos-apps") ? " 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,

package/dist/client.js

@@ -7802,6 +7802,10 @@ var FLAG_REGISTRY = [
     name: "video-watermark",
     description: "Overlay the argent corner watermark on recorded screen videos. On by default; turn it off with `argent disable video-watermark`.",
     defaultEnabled: true
+  },
+  {
+    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."
   }
 ];
 function getFlagDefinition(name, registry = FLAG_REGISTRY) {
@@ -9239,6 +9243,8 @@ var FAILURE_CODES = {
   REACT_PROFILER_START_FAILED: "REACT_PROFILER_START_FAILED",
   REACT_PROFILER_START_VERIFY_FAILED: "REACT_PROFILER_START_VERIFY_FAILED",
   REACT_PROFILER_SESSION_TORN_DOWN: "REACT_PROFILER_SESSION_TORN_DOWN",
+  REACT_PROFILER_SESSION_TAKEN_OVER: "REACT_PROFILER_SESSION_TAKEN_OVER",
+  REACT_PROFILER_STOP_IN_PROGRESS: "REACT_PROFILER_STOP_IN_PROGRESS",
   REACT_PROFILER_HOOK_ERROR: "REACT_PROFILER_HOOK_ERROR",
   REACT_PROFILER_ANALYZE_NO_DATA: "REACT_PROFILER_ANALYZE_NO_DATA",
   NATIVE_PROFILER_FACTORY_OPTIONS_MISSING: "NATIVE_PROFILER_FACTORY_OPTIONS_MISSING",
@@ -9317,6 +9323,32 @@ var FAILURE_CODES = {
   CHROMIUM_ELECTRON_SPAWN_FAILED: "CHROMIUM_ELECTRON_SPAWN_FAILED",
   CHROMIUM_ELECTRON_CDP_TIMEOUT: "CHROMIUM_ELECTRON_CDP_TIMEOUT",
   CHROMIUM_ELECTRON_EXITED_BEFORE_READY: "CHROMIUM_ELECTRON_EXITED_BEFORE_READY",
+  /**
+   * Native Mac apps (the `macos-apps` flag)
+   * @see [macos-app.ts](../../tool-server/src/blueprints/macos-app.ts)
+   */
+  MACOS_APP_UNSUPPORTED_HOST: "MACOS_APP_UNSUPPORTED_HOST",
+  MACOS_APP_PATH_INVALID: "MACOS_APP_PATH_INVALID",
+  MACOS_APP_BUNDLE_INVALID: "MACOS_APP_BUNDLE_INVALID",
+  MACOS_APP_NOT_FOUND: "MACOS_APP_NOT_FOUND",
+  MACOS_APP_HARDENED_RUNTIME: "MACOS_APP_HARDENED_RUNTIME",
+  MACOS_APP_LIBRARY_MISSING: "MACOS_APP_LIBRARY_MISSING",
+  MACOS_APP_LIBRARY_STAGE_FAILED: "MACOS_APP_LIBRARY_STAGE_FAILED",
+  MACOS_APP_ALREADY_RUNNING: "MACOS_APP_ALREADY_RUNNING",
+  MACOS_APP_SPAWN_FAILED: "MACOS_APP_SPAWN_FAILED",
+  MACOS_APP_EXITED_BEFORE_READY: "MACOS_APP_EXITED_BEFORE_READY",
+  MACOS_APP_HANDSHAKE_TIMEOUT: "MACOS_APP_HANDSHAKE_TIMEOUT",
+  MACOS_APP_HANDSHAKE_INVALID: "MACOS_APP_HANDSHAKE_INVALID",
+  MACOS_APP_NOT_RUNNING: "MACOS_APP_NOT_RUNNING",
+  MACOS_APP_NOT_CONNECTED: "MACOS_APP_NOT_CONNECTED",
+  MACOS_APP_CONNECTION_LOST: "MACOS_APP_CONNECTION_LOST",
+  MACOS_APP_CONNECTION_CLOSED: "MACOS_APP_CONNECTION_CLOSED",
+  MACOS_APP_RPC_TIMEOUT: "MACOS_APP_RPC_TIMEOUT",
+  MACOS_APP_RPC_ERROR: "MACOS_APP_RPC_ERROR",
+  MACOS_APP_TERMINATE_FAILED: "MACOS_APP_TERMINATE_FAILED",
+  MACOS_APP_BUNDLE_ID_MISMATCH: "MACOS_APP_BUNDLE_ID_MISMATCH",
+  MACOS_APP_OPEN_URL_FAILED: "MACOS_APP_OPEN_URL_FAILED",
+  MACOS_APP_FILE_ACCESS_FAILED: "MACOS_APP_FILE_ACCESS_FAILED",
   KEYBOARD_KEY_UNSUPPORTED: "KEYBOARD_KEY_UNSUPPORTED",
   KEYBOARD_CHARACTER_UNSUPPORTED: "KEYBOARD_CHARACTER_UNSUPPORTED",
   KEYBOARD_TEXT_AND_KEY_COMBINED: "KEYBOARD_TEXT_AND_KEY_COMBINED",

package/dist/installer.mjs

@@ -16003,6 +16003,8 @@ var FAILURE_CODES = {
   REACT_PROFILER_START_FAILED: "REACT_PROFILER_START_FAILED",
   REACT_PROFILER_START_VERIFY_FAILED: "REACT_PROFILER_START_VERIFY_FAILED",
   REACT_PROFILER_SESSION_TORN_DOWN: "REACT_PROFILER_SESSION_TORN_DOWN",
+  REACT_PROFILER_SESSION_TAKEN_OVER: "REACT_PROFILER_SESSION_TAKEN_OVER",
+  REACT_PROFILER_STOP_IN_PROGRESS: "REACT_PROFILER_STOP_IN_PROGRESS",
   REACT_PROFILER_HOOK_ERROR: "REACT_PROFILER_HOOK_ERROR",
   REACT_PROFILER_ANALYZE_NO_DATA: "REACT_PROFILER_ANALYZE_NO_DATA",
   NATIVE_PROFILER_FACTORY_OPTIONS_MISSING: "NATIVE_PROFILER_FACTORY_OPTIONS_MISSING",
@@ -16081,6 +16083,32 @@ var FAILURE_CODES = {
   CHROMIUM_ELECTRON_SPAWN_FAILED: "CHROMIUM_ELECTRON_SPAWN_FAILED",
   CHROMIUM_ELECTRON_CDP_TIMEOUT: "CHROMIUM_ELECTRON_CDP_TIMEOUT",
   CHROMIUM_ELECTRON_EXITED_BEFORE_READY: "CHROMIUM_ELECTRON_EXITED_BEFORE_READY",
+  /**
+   * Native Mac apps (the `macos-apps` flag)
+   * @see [macos-app.ts](../../tool-server/src/blueprints/macos-app.ts)
+   */
+  MACOS_APP_UNSUPPORTED_HOST: "MACOS_APP_UNSUPPORTED_HOST",
+  MACOS_APP_PATH_INVALID: "MACOS_APP_PATH_INVALID",
+  MACOS_APP_BUNDLE_INVALID: "MACOS_APP_BUNDLE_INVALID",
+  MACOS_APP_NOT_FOUND: "MACOS_APP_NOT_FOUND",
+  MACOS_APP_HARDENED_RUNTIME: "MACOS_APP_HARDENED_RUNTIME",
+  MACOS_APP_LIBRARY_MISSING: "MACOS_APP_LIBRARY_MISSING",
+  MACOS_APP_LIBRARY_STAGE_FAILED: "MACOS_APP_LIBRARY_STAGE_FAILED",
+  MACOS_APP_ALREADY_RUNNING: "MACOS_APP_ALREADY_RUNNING",
+  MACOS_APP_SPAWN_FAILED: "MACOS_APP_SPAWN_FAILED",
+  MACOS_APP_EXITED_BEFORE_READY: "MACOS_APP_EXITED_BEFORE_READY",
+  MACOS_APP_HANDSHAKE_TIMEOUT: "MACOS_APP_HANDSHAKE_TIMEOUT",
+  MACOS_APP_HANDSHAKE_INVALID: "MACOS_APP_HANDSHAKE_INVALID",
+  MACOS_APP_NOT_RUNNING: "MACOS_APP_NOT_RUNNING",
+  MACOS_APP_NOT_CONNECTED: "MACOS_APP_NOT_CONNECTED",
+  MACOS_APP_CONNECTION_LOST: "MACOS_APP_CONNECTION_LOST",
+  MACOS_APP_CONNECTION_CLOSED: "MACOS_APP_CONNECTION_CLOSED",
+  MACOS_APP_RPC_TIMEOUT: "MACOS_APP_RPC_TIMEOUT",
+  MACOS_APP_RPC_ERROR: "MACOS_APP_RPC_ERROR",
+  MACOS_APP_TERMINATE_FAILED: "MACOS_APP_TERMINATE_FAILED",
+  MACOS_APP_BUNDLE_ID_MISMATCH: "MACOS_APP_BUNDLE_ID_MISMATCH",
+  MACOS_APP_OPEN_URL_FAILED: "MACOS_APP_OPEN_URL_FAILED",
+  MACOS_APP_FILE_ACCESS_FAILED: "MACOS_APP_FILE_ACCESS_FAILED",
   KEYBOARD_KEY_UNSUPPORTED: "KEYBOARD_KEY_UNSUPPORTED",
   KEYBOARD_CHARACTER_UNSUPPORTED: "KEYBOARD_CHARACTER_UNSUPPORTED",
   KEYBOARD_TEXT_AND_KEY_COMBINED: "KEYBOARD_TEXT_AND_KEY_COMBINED",
@@ -16197,7 +16225,8 @@ var PLATFORMS = [
   "vega",
   "harmony",
   "tvos",
-  "android-tv"
+  "android-tv",
+  "macos"
 ];
 var DEVICE_KINDS = [
   "simulator",
@@ -16952,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.13";
+    return "0.32.1-next.15";
   }
   return "0.0.0";
 }

package/dist/mcp-server.mjs

@@ -24943,6 +24943,10 @@ var FLAG_REGISTRY = [
     name: "video-watermark",
     description: "Overlay the argent corner watermark on recorded screen videos. On by default; turn it off with `argent disable video-watermark`.",
     defaultEnabled: true
+  },
+  {
+    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."
   }
 ];
 function getFlagDefinition(name, registry2 = FLAG_REGISTRY) {
@@ -25949,6 +25953,8 @@ var FAILURE_CODES = {
   REACT_PROFILER_START_FAILED: "REACT_PROFILER_START_FAILED",
   REACT_PROFILER_START_VERIFY_FAILED: "REACT_PROFILER_START_VERIFY_FAILED",
   REACT_PROFILER_SESSION_TORN_DOWN: "REACT_PROFILER_SESSION_TORN_DOWN",
+  REACT_PROFILER_SESSION_TAKEN_OVER: "REACT_PROFILER_SESSION_TAKEN_OVER",
+  REACT_PROFILER_STOP_IN_PROGRESS: "REACT_PROFILER_STOP_IN_PROGRESS",
   REACT_PROFILER_HOOK_ERROR: "REACT_PROFILER_HOOK_ERROR",
   REACT_PROFILER_ANALYZE_NO_DATA: "REACT_PROFILER_ANALYZE_NO_DATA",
   NATIVE_PROFILER_FACTORY_OPTIONS_MISSING: "NATIVE_PROFILER_FACTORY_OPTIONS_MISSING",
@@ -26027,6 +26033,32 @@ var FAILURE_CODES = {
   CHROMIUM_ELECTRON_SPAWN_FAILED: "CHROMIUM_ELECTRON_SPAWN_FAILED",
   CHROMIUM_ELECTRON_CDP_TIMEOUT: "CHROMIUM_ELECTRON_CDP_TIMEOUT",
   CHROMIUM_ELECTRON_EXITED_BEFORE_READY: "CHROMIUM_ELECTRON_EXITED_BEFORE_READY",
+  /**
+   * Native Mac apps (the `macos-apps` flag)
+   * @see [macos-app.ts](../../tool-server/src/blueprints/macos-app.ts)
+   */
+  MACOS_APP_UNSUPPORTED_HOST: "MACOS_APP_UNSUPPORTED_HOST",
+  MACOS_APP_PATH_INVALID: "MACOS_APP_PATH_INVALID",
+  MACOS_APP_BUNDLE_INVALID: "MACOS_APP_BUNDLE_INVALID",
+  MACOS_APP_NOT_FOUND: "MACOS_APP_NOT_FOUND",
+  MACOS_APP_HARDENED_RUNTIME: "MACOS_APP_HARDENED_RUNTIME",
+  MACOS_APP_LIBRARY_MISSING: "MACOS_APP_LIBRARY_MISSING",
+  MACOS_APP_LIBRARY_STAGE_FAILED: "MACOS_APP_LIBRARY_STAGE_FAILED",
+  MACOS_APP_ALREADY_RUNNING: "MACOS_APP_ALREADY_RUNNING",
+  MACOS_APP_SPAWN_FAILED: "MACOS_APP_SPAWN_FAILED",
+  MACOS_APP_EXITED_BEFORE_READY: "MACOS_APP_EXITED_BEFORE_READY",
+  MACOS_APP_HANDSHAKE_TIMEOUT: "MACOS_APP_HANDSHAKE_TIMEOUT",
+  MACOS_APP_HANDSHAKE_INVALID: "MACOS_APP_HANDSHAKE_INVALID",
+  MACOS_APP_NOT_RUNNING: "MACOS_APP_NOT_RUNNING",
+  MACOS_APP_NOT_CONNECTED: "MACOS_APP_NOT_CONNECTED",
+  MACOS_APP_CONNECTION_LOST: "MACOS_APP_CONNECTION_LOST",
+  MACOS_APP_CONNECTION_CLOSED: "MACOS_APP_CONNECTION_CLOSED",
+  MACOS_APP_RPC_TIMEOUT: "MACOS_APP_RPC_TIMEOUT",
+  MACOS_APP_RPC_ERROR: "MACOS_APP_RPC_ERROR",
+  MACOS_APP_TERMINATE_FAILED: "MACOS_APP_TERMINATE_FAILED",
+  MACOS_APP_BUNDLE_ID_MISMATCH: "MACOS_APP_BUNDLE_ID_MISMATCH",
+  MACOS_APP_OPEN_URL_FAILED: "MACOS_APP_OPEN_URL_FAILED",
+  MACOS_APP_FILE_ACCESS_FAILED: "MACOS_APP_FILE_ACCESS_FAILED",
   KEYBOARD_KEY_UNSUPPORTED: "KEYBOARD_KEY_UNSUPPORTED",
   KEYBOARD_CHARACTER_UNSUPPORTED: "KEYBOARD_CHARACTER_UNSUPPORTED",
   KEYBOARD_TEXT_AND_KEY_COMBINED: "KEYBOARD_TEXT_AND_KEY_COMBINED",
@@ -27812,7 +27844,8 @@ var PLATFORMS = [
   "vega",
   "harmony",
   "tvos",
-  "android-tv"
+  "android-tv",
+  "macos"
 ];
 var DEVICE_KINDS = [
   "simulator",
@@ -28873,7 +28906,9 @@ var AUTO_SCREENSHOT_TOOLS = /* @__PURE__ */ new Set([
   "describe",
   "run-sequence",
   // A wait is almost always followed by a look at the screen it waited for.
-  "await-ui-element"
+  "await-ui-element",
+  "file-panel",
+  "menu-bar"
 ]);
 var AUTO_SCREENSHOT_DELAY_MS_BY_TOOL = {
   "launch-app": 3e3,
@@ -28921,15 +28956,18 @@ var AUTO_DESCRIBE_TOOLS = /* @__PURE__ */ new Set([
   "restart-app",
   "open-url",
   "run-sequence",
-  "await-ui-element"
+  "await-ui-element",
+  "file-panel",
+  "menu-bar"
 ]);
 function autoDescribeEnabled(options) {
   return !isFlagEnabled("disable-auto-describe", options);
 }
 var PROFILING_CAPTURE_SKIPPED_NOTE = "Auto-screenshot and element tree skipped while a profiler is recording on this device. Call screenshot or describe if you need to see the screen.";
 var AUTO_DESCRIBE_HEADER = "--- Elements after action (describe) ---";
-function shouldAutoDescribe(toolName) {
-  return AUTO_DESCRIBE_TOOLS.has(normalizeToolName(toolName));
+function shouldAutoDescribe(toolName, args) {
+  const canonical = normalizeToolName(toolName);
+  return AUTO_DESCRIBE_TOOLS.has(canonical) && !isListCall(canonical, args);
 }
 var SECRET_PLACEHOLDER_MARKER = "{{secret:";
 function containsSecretPlaceholder(args) {
@@ -28949,9 +28987,12 @@ function normalizeToolName(name) {
   const idx = name.lastIndexOf("__");
   return idx === -1 ? name : name.slice(idx + 2);
 }
-function shouldAutoScreenshot(toolName) {
+function shouldAutoScreenshot(toolName, args) {
   const canonical = normalizeToolName(toolName);
-  return canonical !== "screenshot" && AUTO_SCREENSHOT_TOOLS.has(canonical);
+  return canonical !== "screenshot" && AUTO_SCREENSHOT_TOOLS.has(canonical) && !isListCall(canonical, args);
+}
+function isListCall(canonical, args) {
+  return (canonical === "menu-bar" || canonical === "file-panel") && args?.action === "list";
 }
 function getAutoScreenshotDelayMs(toolName) {
   const canonical = normalizeToolName(toolName);
@@ -29366,7 +29407,7 @@ async function startMcpServer(options) {
     const t1 = Date.now();
     try {
       const d = await callTool("describe", { udid }, { signal });
-      const desc = d.result?.description;
+      const { description: desc, hint } = d.result ?? {};
       await spyLog({
         ts: (/* @__PURE__ */ new Date()).toISOString(),
         event: "auto_describe",
@@ -29375,8 +29416,10 @@ async function startMcpServer(options) {
         chars: typeof desc === "string" ? desc.length : 0
       });
       if (typeof desc !== "string" || desc.length === 0) return [];
+      const hintLine = typeof hint === "string" && hint && !desc.includes(hint) ? `Hint: ${hint}
+` : "";
       return [{ type: "text", text: `${AUTO_DESCRIBE_HEADER}
-${desc}` }];
+${hintLine}${desc}` }];
     } catch (e) {
       await spyLog({
         ts: (/* @__PURE__ */ new Date()).toISOString(),
@@ -29446,8 +29489,8 @@ ${desc}` }];
         content = await toMcpContent(result, outputHint, ctx, params.arguments);
       }
       const udid = getUdidFromArgs(params.arguments);
-      const wantScreenshot = autoScreenshotOn && shouldAutoScreenshot(params.name);
-      const wantTree = autoDescribeOn && shouldAutoDescribe(params.name);
+      const wantScreenshot = autoScreenshotOn && shouldAutoScreenshot(params.name, params.arguments);
+      const wantTree = autoDescribeOn && shouldAutoDescribe(params.name, params.arguments);
       if (udid && (wantScreenshot || wantTree) && containsSecretPlaceholder(params.arguments)) {
         content = [
           ...content,