Advancements ++

Author: tech-sushant

src/lib/version-resolver.ts

@@ -3,52 +3,7 @@
  * Else if exact match, returns that
  * Else picks the numerically closest (or first)
  */
-export function resolveVersion(requested: string, available: string[]): string {
-  // strip duplicates & sort
-  const uniq = Array.from(new Set(available));
-  // pick min/max
-  if (requested === "latest" || requested === "oldest") {
-    // try numeric
-    const nums = uniq
-      .map((v) => ({ v, n: parseFloat(v) }))
-      .filter((x) => !isNaN(x.n))
-      .sort((a, b) => a.n - b.n);
-    if (nums.length) {
-      return requested === "latest" ? nums[nums.length - 1].v : nums[0].v;
-    }
-    // fallback lex
-    const lex = uniq.slice().sort();
-    return requested === "latest" ? lex[lex.length - 1] : lex[0];
-  }
-
-  // exact?
-  if (uniq.includes(requested)) {
-    return requested;
-  }
-
-  // try closest numeric
-  const reqNum = parseFloat(requested);
-  const nums = uniq
-    .map((v) => ({ v, n: parseFloat(v) }))
-    .filter((x) => !isNaN(x.n));
-  if (!isNaN(reqNum) && nums.length) {
-    let best = nums[0],
-      bestDiff = Math.abs(nums[0].n - reqNum);
-    for (const x of nums) {
-      const d = Math.abs(x.n - reqNum);
-      if (d < bestDiff) {
-        best = x;
-        bestDiff = d;
-      }
-    }
-    return best.v;
-  }
-
-  // final fallback
-  return uniq[0];
-}
-
-export function resolveVersionWithFuzzy(
+export function resolveVersion(
   requested: string,
   available: string[],
 ): string {

src/tools/appautomate-utils/appium-sdk/constants.ts

@@ -75,11 +75,9 @@ export const SETUP_APP_AUTOMATE_SCHEMA = {
       ]),
     )
     .max(3)
-    .default([
-      [AppSDKSupportedPlatformEnum.android, "Samsung Galaxy S24", "latest"],
-    ])
+    .default([])
     .describe(
-      "Preferred input: 1-3 tuples describing target mobile devices. Example: [['android', 'Samsung Galaxy S24', '14'], ['ios', 'iPhone 15', '17']]",
+      "Tuples describing target mobile devices. Add device only when user asks explicitly for it. Defaults to [] . Example: [['android', 'Samsung Galaxy S24', '14'], ['ios', 'iPhone 15', '17']]",
     ),
 
   appPath: z

src/tools/appautomate-utils/native-execution/constants.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { AppTestPlatform } from "./types.js";
+import { AppSDKSupportedPlatformEnum } from "../appium-sdk/types.js";
 
 export const RUN_APP_AUTOMATE_DESCRIPTION = `Execute pre-built native mobile test suites (Espresso for Android, XCUITest for iOS) by direct upload to BrowserStack. ONLY for compiled .apk/.ipa test files. This is NOT for SDK integration or Appium tests. For Appium-based testing with SDK setup, use 'setupBrowserStackAppAutomateTests' instead.`;
 
@@ -28,10 +29,35 @@ export const RUN_APP_AUTOMATE_SCHEMA = {
         "  zip -r Tests.zip *.xctestrun *-Runner.app\n\n" +
         "If in other directory, provide existing test file path",
     ),
-  devices: z
-    .array(z.array(z.string()))
+    devices: z
+    .array(
+      z.union([
+        // Android: [android, deviceName, osVersion]
+        z.tuple([
+          z
+            .literal(AppSDKSupportedPlatformEnum.android)
+            .describe("Platform identifier: 'android'"),
+          z
+            .string()
+            .describe(
+              "Device name, e.g. 'Samsung Galaxy S24', 'Google Pixel 8'",
+            ),
+          z.string().describe("Android version, e.g. '14', '16', 'latest'"),
+        ]),
+        // iOS: [ios, deviceName, osVersion]
+        z.tuple([
+          z
+            .literal(AppSDKSupportedPlatformEnum.ios)
+            .describe("Platform identifier: 'ios'"),
+          z.string().describe("Device name, e.g. 'iPhone 15', 'iPhone 14 Pro'"),
+          z.string().describe("iOS version, e.g. '17', '16', 'latest'"),
+        ]),
+      ]),
+    )
+    .max(3)
+    .default([])
     .describe(
-      "List of devices to run the test on, e.g., [['android', 'Samsung Galaxy S20', '10.0'], ['ios', 'iPhone 12 Pro', '16.0']].",
+      "Tuples describing target mobile devices. Add device only when user asks explicitly for it. Defaults to [] . Example: [['android', 'Samsung Galaxy S24', '14'], ['ios', 'iPhone 15', '17']]",
     ),
   project: z
     .string()

src/tools/sdk-utils/common/schema.ts

@@ -19,7 +19,6 @@ export const WindowsPlatformEnum = {
 } as const;
 
 export const MacOSPlatformEnum = {
-  MAC: "mac",
   MACOS: "macos",
 } as const;
 
@@ -99,7 +98,7 @@ export const RunTestsOnBrowserStackParamsShape = {
     .max(3)
     .default([])
     .describe(
-      "Preferred input: 1-3 tuples describing target devices.Example: [['windows', '11', 'chrome', 'latest'], ['android', 'Samsung Galaxy S24', '14', 'chrome'], ['ios', 'iPhone 15', '17', 'safari']]",
+      "Preferred tuples of target devices.Add device only when user asks explicitly for it. Defaults to [] . Example: [['windows', '11', 'chrome', 'latest']]",
     ),
 };