@swmansion/argent 0.32.1-next.19 → 0.32.1-next.20

package/assets/manifest.json

@@ -1,7 +1,7 @@
 {
   "packageName": "com.argent.androiddevtools",
   "instrumentationRunner": "com.argent.androiddevtools/.SnapshotInstrumentation",
-  "versionName": "0.3.0",
-  "versionCode": 3,
+  "versionName": "0.4.0",
+  "versionCode": 4,
   "installFlags": ["-r", "-t"]
 }

package/dist/cli-cmds.mjs

@@ -35871,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.18";
+    return "0.32.1-next.20";
   }
   return "0.0.0";
 }

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.18";
+    return "0.32.1-next.20";
   }
   return "0.0.0";
 }

package/dist/tool-server.cjs

@@ -79538,14 +79538,18 @@ function platformMatrix(platform, capability41) {
       return capability41.macos;
   }
 }
+function macosAppsUnavailableReason() {
+  if (!isFlagEnabled(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 assertSupported(toolId, capability41, device) {
   if (!capability41) return;
   if (device.platform === "harmony" && !isHarmonyEnabled()) {
     throw new UnsupportedOperationError(toolId, device, HARMONY_DISABLED_REASON);
   }
-  if (device.platform === "macos" && !isFlagEnabled(MACOS_APPS_FLAG)) {
-    throw new UnsupportedOperationError(toolId, device, MACOS_APPS_FLAG_OFF_REASON);
-  }
+  const macosRefusal = device.platform === "macos" ? macosAppsUnavailableReason() : null;
+  if (macosRefusal) throw new UnsupportedOperationError(toolId, device, macosRefusal);
   const matrix = platformMatrix(device.platform, capability41);
   if (!matrix) {
     const reason2 = (device.platform === "macos" ? MACOS_REFUSAL_REASONS[toolId] : void 0) ?? `no ${device.platform} support declared`;
@@ -101252,7 +101256,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.18";
+    return "0.32.1-next.20";
   }
   return "0.0.0";
 }
@@ -125696,11 +125700,12 @@ function isMacosAppsEnabled() {
   return isFlagEnabled(MACOS_APPS_FLAG);
 }
 function assertMacosAppsEnabled(toolId, device) {
-  if (isMacosAppsEnabled()) return;
+  const reason2 = macosAppsUnavailableReason();
+  if (!reason2) return;
   throw new UnsupportedOperationError(
     toolId,
     device ?? { id: MACOS_APP_ID_PREFIX, platform: "macos", kind: "app" },
-    MACOS_APPS_FLAG_OFF_REASON
+    reason2
   );
 }
 function macosFailure(message, error_code, failure_stage, error_kind, cause) {
@@ -143560,10 +143565,14 @@ function extractBearerToken(authHeader) {
 }
 function isToolExposed(def) {
   if (!def) return false;
-  if (def.featureFlag && !isFlagEnabled(def.featureFlag)) return false;
+  if (def.featureFlag && !isFlagOffered(def.featureFlag)) return false;
   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);
 }
@@ -143896,18 +143905,18 @@ function createHttpApp(registry2, options) {
     const tools = snapshot.tools.map((id) => registry2.getTool(id)).filter((def) => isToolExposed(def)).flatMap((def) => {
       const entry = {
         name: def.id,
-        description: renderFlagGated(def.description ?? "", isFlagEnabled),
+        description: renderFlagGated(def.description ?? "", isFlagOffered),
         inputSchema: renderFlagGated(
           def.inputSchema ?? { type: "object", properties: {} },
-          isFlagEnabled
+          isFlagOffered
         )
       };
-      if (def.outputHint) entry.outputHint = renderFlagGated(def.outputHint, isFlagEnabled);
+      if (def.outputHint) entry.outputHint = renderFlagGated(def.outputHint, isFlagOffered);
       if (def.fileInputs && def.fileInputs.length > 0) {
         entry.fileInputs = withFormerParamSpecs(def.id, def.fileInputs);
       }
       if (def.alwaysLoad) entry.alwaysLoad = true;
-      if (def.searchHint) entry.searchHint = renderFlagGated(def.searchHint, isFlagEnabled);
+      if (def.searchHint) entry.searchHint = renderFlagGated(def.searchHint, isFlagOffered);
       if (def.longRunning) entry.longRunning = true;
       if (def.hideFromMcp) entry.hideFromMcp = true;
       if (def.readOnly) entry.readOnly = true;
@@ -146507,6 +146516,8 @@ function toRequestLine(record2) {
 // ../tool-server/src/tools/native-devtools/native-find-views.ts
 init_zod();
 init_src2();
+init_device_info();
+var MACOS_NO_MATCH_NOTE = "No NSView matched. SwiftUI sets a control's identifier and label on an accessibility element, not on an NSView, so this search does not find SwiftUI controls: describe lists them with their identifiers and frames.";
 var zodSchema5 = external_exports.object({
   ...nativeAppTarget,
   className: external_exports.string().optional().describe("UIView class name to match (exact, e.g. UIButton)"),
@@ -146525,7 +146536,7 @@ var nativeFindViewsTool = {
   description: `Search for specific UIViews in the running app by class name, accessibility identifier, accessibility label, tag or React Native nativeID; at least one of these params is required.
 Use when you need to locate a specific view by its properties without dumping the entire native-full-hierarchy.
 Returns { status: "ok", matches }: the matching views with their frames, properties, optional ancestors and optional children. Frames are in points. frame and center are relative to the superview, and windowFrame turns with the UI. To tap a view, divide the centre of its screenFrame by the screen size in points, which native-full-hierarchy returns as screen (maxDepth: 1 is enough), and pass the result to gesture-tap. Matches are not filtered for visibility. Before tapping, call native-user-interactable-view-at-point at that centre with skipClasses ["UITextEffectsWindow"]. If it does not return the match or a descendant, check a screenshot.
-<flag:macos-apps>On a Mac app it searches the NSViews of every visible window: className is the NSView class, and identifier matches the accessibility identifier or the view identifier. The tap recipe above and the statuses below are iOS only.
+<flag:macos-apps>On a Mac app it searches the NSViews of every visible window: className is the NSView class, and identifier matches the accessibility identifier or the view identifier. SwiftUI sets a control's identifier and label on an accessibility element, not on an NSView, so an identifier or label search does not find SwiftUI controls: describe lists them with their identifiers and frames. The tap recipe above and the statuses below are iOS only.
 </flag:macos-apps>If status is restart_required: follow the message (usually restart-app), then retry. If status is service_stale: the app is already injected, so restarting it cannot help. Restart the tool-server (\`argent server stop && argent server start --detach\`) and retry. If the same status comes back after that restart, stop restarting: follow the message, which names the terminal fallback. If status is connect_pending: the app is injected and still connecting. Do not restart it, wait a few seconds and retry. If status is init_failed: follow the message (re-boot the simulator) rather than retrying.
 An Apple system app is rejected outright (terminal: never retry it).`,
   zodSchema: zodSchema5,
@@ -146544,17 +146555,24 @@ An Apple system app is rejected outright (terminal: never retry it).`,
     macos: { app: true }
   },
   services: nativeAppServices,
-  execute: (services, params) => queryViewHierarchyFor(
-    services,
-    params,
-    "native-find-views",
-    "ViewHierarchy.findViews",
-    FAILURE_CODES.NATIVE_DEVTOOLS_FIND_VIEWS_ERROR,
-    (result) => ({
-      status: "ok",
-      matches: result.matches ?? []
-    })
-  )
+  execute: (services, params) => {
+    const noteOnEmpty = resolveDevice(params.udid).platform === "macos" && (params.identifier !== void 0 || params.label !== void 0);
+    return queryViewHierarchyFor(
+      services,
+      params,
+      "native-find-views",
+      "ViewHierarchy.findViews",
+      FAILURE_CODES.NATIVE_DEVTOOLS_FIND_VIEWS_ERROR,
+      (result) => {
+        const matches2 = result.matches ?? [];
+        return {
+          status: "ok",
+          matches: matches2,
+          ...noteOnEmpty && matches2.length === 0 ? { note: MACOS_NO_MATCH_NOTE } : {}
+        };
+      }
+    );
+  }
 };
 
 // ../tool-server/src/tools/native-devtools/native-full-hierarchy.ts

package/package.json

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