@browserstack/mcp-server 1.2.3 → 1.2.4

package/README.md

@@ -38,7 +38,15 @@ Stay in flow—keep all project context in one place and trigger actions directl
 ## ⚡️ One Click MCP Setup
 
 [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](http://mcp.browserstack.com/one-click-setup?client=vscode)   [![Install in Cursor](https://img.shields.io/badge/Cursor-Install_Server-24bfa5?style=flat-square&color=000000&logo=visualstudiocode&logoColor=white)](http://mcp.browserstack.com/one-click-setup?client=cursor)
-
+#### Note : Ensure you are using Node version >= `18.0` 
+- Check your node version using `node --version`. Recommended version: `v22.15.0` (LTS)
+- To Upgrade Node :
+- 1. On macOS `(Homebrew) - brew update && brew upgrade node  or if using (nvm) - nvm install 22.15.0 && nvm use 22.15.0 && nvm alias default 22.15.0`
+- 2. On Windows `(nvm-windows) : nvm install 22.15.0 && nvm use 22.15.0`
+- 👉 <a href="https://nodejs.org/en/download" target="_blank">Or directly download the Node.js LTS Installer</a>
+
+.
+        
 ## 💡 Usage Examples
 
 ### 📱 Manual App Testing
@@ -142,6 +150,10 @@ Generate test cases from PRDs, convert manual tests to low-code automation, and
 
 ## 🛠️ Installation
 
+### 📋 Prerequisites for MCP Setup
+#### Note : Ensure you are using Node version >= `18.0` 
+- Check your node version using `node --version`. Recommended version: `v22.15.0` (LTS)
+   
 ### **One Click MCP Setup**
 
 [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](http://mcp.browserstack.com/one-click-setup?client=vscode) &nbsp; [![Install in Cursor](https://img.shields.io/badge/Cursor-Install_Server-24bfa5?style=flat-square&color=000000&logo=visualstudiocode&logoColor=white)](http://mcp.browserstack.com/one-click-setup?client=cursor)
@@ -158,7 +170,9 @@ Generate test cases from PRDs, convert manual tests to low-code automation, and
 
    - Once you have an account (and purchased appropriate plan), note down your `username` and `access_key` from [Account Settings](https://www.browserstack.com/accounts/profile/details).
 
-2. Ensure you are using Node version >= `18.0`. Check your node version using `node --version`. Recommended version: `v22.15.0` (LTS)
+2. #### Note : Ensure you are using Node version >= `18.0` 
+    - Check your node version using `node --version`. Recommended version: `v22.15.0` (LTS)
+   
 
 3. **Install the MCP Server**
 
@@ -456,7 +470,79 @@ As of now we support 20 tools.
   ```text
   Upload PRD from /Users/xyz/Desktop/login-flow.pdf and use BrowserStack AI to generate test cases
   ```
+##  🚀 Remote MCP Server
+
+Remote MCP comes with all the functionalities of an MCP server without the hassles of complex setup or local installation.
+
+### Key benefits:
+
+- ✅ Works seamlessly in enterprise networks without worrying about firewalls or binaries or where local installation is not allowed.
+
+- ✅ Secure OAuth integration – no password sharing or manual credential handling.
+
+### Limitations:
+
+- ❌ No Local Testing support (cannot test apps behind VPNs, firewalls, or localhost). If you have to do Local Testing, you would have to use a BrowserStack Local MCP server.
+- ❌ Latency can be slightly higher, but nothing considerable — you generally won’t notice it in normal use.
+
+### Installation Steps: 
 
+   - On VSCode (Copilot - Agent Mode): `.vscode/mcp.json`:
+    
+      - Locate or Create the Configuration File:
+      - In the root directory of your project, look for a folder named .vscode. This folder is usually hidden so you will need to find it as            mentioned in the expand.
+      - If this folder doesn't exist, create it.
+      - Inside the .vscode folder, create a new file named mcp.json
+      - To setup Remote BrowserStack MCP instead of local BrowserStack MCP you can add the following JSON content :
+         <div align="center">
+         <img src="assets/remotemcp_json_file.png" alt="Remote MCP JSON file" height="300" width="300">
+         </div>
+        
+        ### Alternative way to Setup Remote MCP
+
+      -  Step 1.Click on the gear icon to Select Tools
+      
+          <div align="center">
+          <img src="assets/select_tools.png" alt="Select Tools" height="300" width="300"> 
+          </div>
+          
+      -  Step 2. A tool menu would appear at the top-centre, scroll down on the menu at the top and then Click on Add MCP Server
+      
+        <div align="center">
+        <img src="assets/add_mcp_server.png" alt="Add MCP Server" height="300" width="300"> 
+        </div>
+
+      - Step 3. Click on HTTP option
+         <div align="center">
+         <img src="assets/http_option.png" alt="HTTP Option" height="300" width="300">
+         </div>
+         
+      - Step 4. Paste Remote MCP Server URL : https://mcp.browserstack.com/mcp
+         <div align="center">
+         <img src="assets/server_url.png" alt="Remote MCP Server URL" height="300" width="300">
+         </div>
+         
+      - Step 5. Give server id as : browserstack
+      
+          <div align="center">
+          <img src="assets/server_id.png" alt="Remote MCP Server ID" height="300" width="300">
+          </div>
+          
+      - Step 6. In VSCode Click on start MCP Server and then click on "Allow"
+      
+          <div align="center">
+          <img src="assets/authentication1.png" alt="authentication1" height="300" width="300">
+          </div>
+          
+          <div align="center">
+          <img src="assets/authentication2.png" alt="authentication2" height="300" width="300">
+          </div>
+          
+          <div align="center">
+          <img src="assets/signin_success.png" alt="Sign_in_success" height="300" width="300">
+          </div>
+
+     
 
 ## 🤝 Recommended MCP Clients
 

package/dist/lib/device-cache.js

@@ -26,30 +26,33 @@ export async function getDevicesAndBrowsers(type) {
         fs.mkdirSync(CACHE_DIR, { recursive: true });
     }
     let cache = {};
+    // Load existing cache
     if (fs.existsSync(CACHE_FILE)) {
-        const stats = fs.statSync(CACHE_FILE);
-        if (Date.now() - stats.mtimeMs < TTL_MS) {
-            try {
-                cache = JSON.parse(fs.readFileSync(CACHE_FILE, "utf8"));
-                if (cache[type]) {
-                    return cache[type];
-                }
-            }
-            catch (error) {
-                console.error("Error parsing cache file:", error);
-                // Continue with fetching fresh data
-            }
+        try {
+            cache = JSON.parse(fs.readFileSync(CACHE_FILE, "utf8"));
+        }
+        catch (err) {
+            console.error("Error parsing cache file:", err);
+            cache = {};
+        }
+        // Check per-product TTL
+        const cachedEntry = cache[type];
+        if (cachedEntry?.timestamp && Date.now() - cachedEntry.timestamp < TTL_MS) {
+            return cachedEntry.data;
         }
     }
+    // Fetch fresh data from BrowserStack
     const liveRes = await apiClient.get({ url: URLS[type], raise_error: false });
     if (!liveRes.ok) {
-        throw new Error(`Failed to fetch configuration from BrowserStack : ${type}=${liveRes.statusText}`);
+        throw new Error(`Failed to fetch configuration from BrowserStack: ${type} = ${liveRes.statusText}`);
     }
-    cache = {
-        [type]: liveRes.data,
+    // Save to cache with timestamp and data directly under product key
+    cache[type] = {
+        timestamp: Date.now(),
+        data: liveRes.data,
     };
-    fs.writeFileSync(CACHE_FILE, JSON.stringify(cache), "utf8");
-    return cache[type];
+    fs.writeFileSync(CACHE_FILE, JSON.stringify(cache, null, 2), "utf8");
+    return liveRes.data;
 }
 // Rate limiter for started event (3H)
 export function shouldSendStartedEvent() {

package/dist/lib/inmemory-store.d.ts

@@ -1 +1,2 @@
 export declare const signedUrlMap: Map<string, object>;
+export declare const testFilePathsMap: Map<string, string[]>;

package/dist/lib/inmemory-store.js

@@ -1 +1,2 @@
 export const signedUrlMap = new Map();
+export const testFilePathsMap = new Map();

package/dist/lib/utils.d.ts

@@ -1,4 +1,9 @@
 import type { ApiResponse } from "./apiClient.js";
+import { BrowserStackConfig } from "./types.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
 export declare function sanitizeUrlParam(param: string): string;
 export declare function maybeCompressBase64(base64: string): Promise<string>;
 export declare function assertOkResponse(response: Response | ApiResponse, action: string): Promise<void>;
+export declare function fetchFromBrowserStackAPI(url: string, config: BrowserStackConfig): Promise<any>;
+export declare function handleMCPError(toolName: string, server: McpServer, config: BrowserStackConfig, error: unknown): CallToolResult;

package/dist/lib/utils.js

@@ -1,4 +1,6 @@
 import sharp from "sharp";
+import { getBrowserStackAuth } from "./get-auth.js";
+import { trackMCP } from "../index.js";
 export function sanitizeUrlParam(param) {
     // Remove any characters that could be used for command injection
     return param.replace(/[;&|`$(){}[\]<>]/g, "");
@@ -24,3 +26,28 @@ export async function assertOkResponse(response, action) {
         throw new Error(`Failed to fetch logs for ${action}: ${response.statusText}`);
     }
 }
+export async function fetchFromBrowserStackAPI(url, config) {
+    const authString = getBrowserStackAuth(config);
+    const auth = Buffer.from(authString).toString("base64");
+    const res = await fetch(url, {
+        headers: {
+            Authorization: `Basic ${auth}`,
+        },
+    });
+    if (!res.ok) {
+        throw new Error(`Failed to fetch from ${url}: ${res.status} ${res.statusText}`);
+    }
+    return res.json();
+}
+function errorContent(message) {
+    return {
+        content: [{ type: "text", text: message }],
+        isError: true,
+    };
+}
+export function handleMCPError(toolName, server, config, error) {
+    trackMCP(toolName, server.server.getClientVersion(), error, config);
+    const errorMessage = error instanceof Error ? error.message : "Unknown error";
+    const readableToolName = toolName.replace(/([A-Z])/g, " $1").toLowerCase();
+    return errorContent(`Failed to ${readableToolName}: ${errorMessage}. Please open an issue on GitHub if the problem persists`);
+}

package/dist/server-factory.js

@@ -4,6 +4,7 @@ const require = createRequire(import.meta.url);
 const packageJson = require("../package.json");
 import logger from "./logger.js";
 import addSDKTools from "./tools/bstack-sdk.js";
+import addPercyTools from "./tools/percy-sdk.js";
 import addBrowserLiveTools from "./tools/live.js";
 import addAccessibilityTools from "./tools/accessibility.js";
 import addTestManagementTools from "./tools/testmanagement.js";
@@ -12,7 +13,9 @@ import addFailureLogsTools from "./tools/get-failure-logs.js";
 import addAutomateTools from "./tools/automate.js";
 import addSelfHealTools from "./tools/selfheal.js";
 import addAppLiveTools from "./tools/applive.js";
+import addBuildInsightsTools from "./tools/build-insights.js";
 import { setupOnInitialized } from "./oninitialized.js";
+import addRCATools from "./tools/rca-agent.js";
 /**
  * Wrapper class for BrowserStack MCP Server
  * Stores a map of registered tools by name
@@ -38,6 +41,7 @@ export class BrowserStackMcpServer {
         const toolAdders = [
             addAccessibilityTools,
             addSDKTools,
+            addPercyTools,
             addAppLiveTools,
             addBrowserLiveTools,
             addTestManagementTools,
@@ -45,6 +49,8 @@ export class BrowserStackMcpServer {
             addFailureLogsTools,
             addAutomateTools,
             addSelfHealTools,
+            addBuildInsightsTools,
+            addRCATools,
         ];
         toolAdders.forEach((adder) => {
             // Each adder now returns a Record<string, Tool>

package/dist/tools/add-percy-snapshots.d.ts

@@ -0,0 +1,5 @@
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+export declare function updateTestsWithPercyCommands(args: {
+    uuid: string;
+    index: number;
+}): Promise<CallToolResult>;

package/dist/tools/add-percy-snapshots.js

@@ -0,0 +1,17 @@
+import { testFilePathsMap } from "../lib/inmemory-store.js";
+import { updateFileAndStep } from "./percy-snapshot-utils/utils.js";
+import { percyWebSetupInstructions } from "../tools/sdk-utils/percy-web/handler.js";
+export async function updateTestsWithPercyCommands(args) {
+    const { uuid, index } = args;
+    const filePaths = testFilePathsMap.get(uuid);
+    if (!filePaths) {
+        throw new Error(`No test files found in memory for UUID: ${uuid}`);
+    }
+    if (index < 0 || index >= filePaths.length) {
+        throw new Error(`Invalid index: ${index}. There are ${filePaths.length} files for UUID: ${uuid}`);
+    }
+    const result = await updateFileAndStep(filePaths[index], index, filePaths.length, percyWebSetupInstructions);
+    return {
+        content: result,
+    };
+}

package/dist/tools/appautomate-utils/appium-sdk/config-generator.d.ts

@@ -0,0 +1 @@
+export declare function generateAppBrowserStackYMLInstructions(platforms: string[], username: string, accessKey: string, appPath: string | undefined, testingFramework: string): string;

package/dist/tools/appautomate-utils/appium-sdk/config-generator.js

@@ -0,0 +1,50 @@
+// Configuration utilities for BrowserStack App SDK
+import { APP_DEVICE_CONFIGS, AppSDKSupportedTestingFrameworkEnum, DEFAULT_APP_PATH, createStep, } from "./index.js";
+export function generateAppBrowserStackYMLInstructions(platforms, username, accessKey, appPath = DEFAULT_APP_PATH, testingFramework) {
+    if (testingFramework === AppSDKSupportedTestingFrameworkEnum.nightwatch ||
+        testingFramework === AppSDKSupportedTestingFrameworkEnum.webdriverio ||
+        testingFramework === AppSDKSupportedTestingFrameworkEnum.cucumberRuby) {
+        return "";
+    }
+    // Generate platform and device configurations
+    const platformConfigs = platforms
+        .map((platform) => {
+        const devices = APP_DEVICE_CONFIGS[platform];
+        if (!devices)
+            return "";
+        return devices
+            .map((device) => `  - platformName: ${platform}
+    deviceName: ${device.deviceName}
+    platformVersion: "${device.platformVersion}"`)
+            .join("\n");
+    })
+        .filter(Boolean)
+        .join("\n");
+    // Construct YAML content
+    const configContent = `\`\`\`yaml
+userName: ${username}
+accessKey: ${accessKey}
+app: ${appPath}
+platforms:
+${platformConfigs}
+parallelsPerPlatform: 1
+browserstackLocal: true
+buildName: bstack-demo
+projectName: BrowserStack Sample
+debug: true
+networkLogs: true
+percy: false
+percyCaptureMode: auto
+accessibility: false
+\`\`\`
+
+**Important notes:**
+- Replace \`app: ${appPath}\` with the path to your actual app file (e.g., \`./SampleApp.apk\` for Android or \`./SampleApp.ipa\` for iOS)
+- You can upload your app using BrowserStack's App Upload API or manually through the dashboard
+- Set \`browserstackLocal: true\` if you need to test with local/staging servers
+- Adjust \`parallelsPerPlatform\` based on your subscription limits`;
+    // Return formatted step for instructions
+    return createStep("Update browserstack.yml file with App Automate configuration:", `Create or update the browserstack.yml file in your project root with the following content:
+
+${configContent}`);
+}

package/dist/tools/appautomate-utils/appium-sdk/constants.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { AppSDKSupportedFrameworkEnum, AppSDKSupportedTestingFrameworkEnum, AppSDKSupportedLanguageEnum, AppSDKSupportedPlatformEnum } from "./index.js";
+export declare const APP_DEVICE_CONFIGS: {
+    android: {
+        deviceName: string;
+        platformVersion: string;
+    }[];
+    ios: {
+        deviceName: string;
+        platformVersion: string;
+    }[];
+};
+export declare const STEP_DELIMITER = "---STEP---";
+export declare const DEFAULT_APP_PATH = "bs://sample.app";
+export declare const SETUP_APP_AUTOMATE_DESCRIPTION = "Set up BrowserStack App Automate SDK integration for Appium-based mobile app testing. ONLY for Appium based framework . This tool configures SDK for various languages with appium. For pre-built Espresso or XCUITest test suites, use 'runAppTestsOnBrowserStack' instead.";
+export declare const SETUP_APP_AUTOMATE_SCHEMA: {
+    detectedFramework: z.ZodNativeEnum<typeof AppSDKSupportedFrameworkEnum>;
+    detectedTestingFramework: z.ZodNativeEnum<typeof AppSDKSupportedTestingFrameworkEnum>;
+    detectedLanguage: z.ZodNativeEnum<typeof AppSDKSupportedLanguageEnum>;
+    desiredPlatforms: z.ZodArray<z.ZodNativeEnum<typeof AppSDKSupportedPlatformEnum>, "many">;
+    appPath: z.ZodString;
+    project: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+};

package/dist/tools/appautomate-utils/appium-sdk/constants.js

@@ -0,0 +1,43 @@
+import { z } from "zod";
+import { AppSDKSupportedFrameworkEnum, AppSDKSupportedTestingFrameworkEnum, AppSDKSupportedLanguageEnum, AppSDKSupportedPlatformEnum, } from "./index.js";
+// App Automate specific device configurations
+export const APP_DEVICE_CONFIGS = {
+    android: [
+        { deviceName: "Samsung Galaxy S22 Ultra", platformVersion: "12.0" },
+        { deviceName: "Google Pixel 7 Pro", platformVersion: "13.0" },
+        { deviceName: "OnePlus 9", platformVersion: "11.0" },
+    ],
+    ios: [
+        { deviceName: "iPhone 14", platformVersion: "16" },
+        { deviceName: "iPhone 13", platformVersion: "15" },
+        { deviceName: "iPad Air 4", platformVersion: "14" },
+    ],
+};
+// Step delimiter for parsing instructions
+export const STEP_DELIMITER = "---STEP---";
+// Default app path for examples
+export const DEFAULT_APP_PATH = "bs://sample.app";
+// Tool description and schema for setupBrowserStackAppAutomateTests
+export const SETUP_APP_AUTOMATE_DESCRIPTION = "Set up BrowserStack App Automate SDK integration for Appium-based mobile app testing. ONLY for Appium based framework . This tool configures SDK for various languages with appium. For pre-built Espresso or XCUITest test suites, use 'runAppTestsOnBrowserStack' instead.";
+export const SETUP_APP_AUTOMATE_SCHEMA = {
+    detectedFramework: z
+        .nativeEnum(AppSDKSupportedFrameworkEnum)
+        .describe("The mobile automation framework configured in the project. Example: 'appium'"),
+    detectedTestingFramework: z
+        .nativeEnum(AppSDKSupportedTestingFrameworkEnum)
+        .describe("The testing framework used in the project. Be precise with framework selection Example: 'testng', 'behave', 'pytest', 'robot'"),
+    detectedLanguage: z
+        .nativeEnum(AppSDKSupportedLanguageEnum)
+        .describe("The programming language used in the project. Supports Java and C#. Example: 'java', 'csharp'"),
+    desiredPlatforms: z
+        .array(z.nativeEnum(AppSDKSupportedPlatformEnum))
+        .describe("The mobile platforms the user wants to test on. Always ask this to the user, do not try to infer this. Example: ['android', 'ios']"),
+    appPath: z
+        .string()
+        .describe("Path to the mobile app file (.apk for Android, .ipa for iOS). Can be a local file path or a BrowserStack app URL (bs://)"),
+    project: z
+        .string()
+        .optional()
+        .default("BStack-AppAutomate-Suite")
+        .describe("Project name for organizing test runs on BrowserStack."),
+};

package/dist/tools/appautomate-utils/appium-sdk/formatter.d.ts

@@ -0,0 +1,8 @@
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+export declare function formatFinalAppInstructions(formattedInstructions: string): CallToolResult;
+export declare function createStep(title: string, content: string): string;
+export declare function combineInstructions(...instructionParts: string[]): string;
+export declare function formatEnvCommands(username: string, accessKey: string, isWindows: boolean): string;
+export declare function createEnvStep(username: string, accessKey: string, isWindows: boolean, platformLabel: string, title?: string): string;
+export declare function formatMultiLineCommand(command: string, isWindows?: boolean): string;
+export declare function formatAppInstructionsWithNumbers(instructions: string): string;

package/dist/tools/appautomate-utils/appium-sdk/formatter.js

@@ -0,0 +1,59 @@
+import { STEP_DELIMITER } from "./constants.js";
+export function formatFinalAppInstructions(formattedInstructions) {
+    const fullInstructions = `
+⚠️ IMPORTANT: DO NOT SKIP ANY STEP
+All the setup steps described in this file MUST be executed regardless of any existing configuration or setup.
+This ensures proper BrowserStack App Automate SDK setup.
+Each step is compulsory and sequence needs to be maintained.
+
+${formattedInstructions}`;
+    return {
+        content: [
+            {
+                type: "text",
+                text: fullInstructions,
+                isError: false,
+            },
+        ],
+    };
+}
+export function createStep(title, content) {
+    return `${STEP_DELIMITER}
+${title}
+
+${content}`;
+}
+export function combineInstructions(...instructionParts) {
+    return instructionParts.filter(Boolean).join("\n\n");
+}
+export function formatEnvCommands(username, accessKey, isWindows) {
+    if (isWindows) {
+        return `\`\`\`cmd
+setx BROWSERSTACK_USERNAME "${username}"
+setx BROWSERSTACK_ACCESS_KEY "${accessKey}"
+\`\`\``;
+    }
+    return `\`\`\`bash
+export BROWSERSTACK_USERNAME=${username}
+export BROWSERSTACK_ACCESS_KEY=${accessKey}
+\`\`\``;
+}
+export function createEnvStep(username, accessKey, isWindows, platformLabel, title = "Set BrowserStack credentials as environment variables:") {
+    return createStep(title, `**${platformLabel}:**
+${formatEnvCommands(username, accessKey, isWindows)}`);
+}
+export function formatMultiLineCommand(command, isWindows = process.platform === "win32") {
+    if (isWindows) {
+        // For Windows, keep commands on single line
+        return command.replace(/\s*\\\s*\n\s*/g, " ");
+    }
+    return command;
+}
+export function formatAppInstructionsWithNumbers(instructions) {
+    const steps = instructions
+        .split(STEP_DELIMITER)
+        .filter((step) => step.trim());
+    return steps
+        .map((step, index) => `**Step ${index + 1}:**\n${step.trim()}`)
+        .join("\n\n");
+}

package/dist/tools/appautomate-utils/appium-sdk/handler.d.ts

@@ -0,0 +1,3 @@
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { BrowserStackConfig } from "../../../lib/types.js";
+export declare function setupAppAutomateHandler(rawInput: unknown, config: BrowserStackConfig): Promise<CallToolResult>;

package/dist/tools/appautomate-utils/appium-sdk/handler.js

@@ -0,0 +1,52 @@
+import { z } from "zod";
+import { getBrowserStackAuth } from "../../../lib/get-auth.js";
+import { getAppUploadInstruction, validateSupportforAppAutomate, } from "./utils.js";
+import { getAppSDKPrefixCommand, generateAppBrowserStackYMLInstructions, } from "./index.js";
+import { formatAppInstructionsWithNumbers, getAppInstructionsForProjectConfiguration, SETUP_APP_AUTOMATE_SCHEMA, } from "./index.js";
+export async function setupAppAutomateHandler(rawInput, config) {
+    const input = z.object(SETUP_APP_AUTOMATE_SCHEMA).parse(rawInput);
+    const auth = getBrowserStackAuth(config);
+    const [username, accessKey] = auth.split(":");
+    const instructions = [];
+    // Use variables for all major input properties
+    const testingFramework = input.detectedTestingFramework;
+    const language = input.detectedLanguage;
+    const platforms = input.desiredPlatforms ?? ["android"];
+    const appPath = input.appPath;
+    const framework = input.detectedFramework;
+    //Validating if supported framework or not
+    validateSupportforAppAutomate(framework, language, testingFramework);
+    // Step 1: Generate SDK setup command
+    const sdkCommand = getAppSDKPrefixCommand(language, testingFramework, username, accessKey, appPath);
+    if (sdkCommand) {
+        instructions.push({ content: sdkCommand, type: "setup" });
+    }
+    // Step 2: Generate browserstack.yml configuration
+    const configInstructions = generateAppBrowserStackYMLInstructions(platforms, username, accessKey, appPath, testingFramework);
+    if (configInstructions) {
+        instructions.push({ content: configInstructions, type: "config" });
+    }
+    // Step 3: Generate app upload instruction
+    const appUploadInstruction = await getAppUploadInstruction(appPath, username, accessKey, testingFramework);
+    if (appUploadInstruction) {
+        instructions.push({ content: appUploadInstruction, type: "setup" });
+    }
+    // Step 4: Generate project configuration and run instructions
+    const projectInstructions = getAppInstructionsForProjectConfiguration(framework, testingFramework, language);
+    if (projectInstructions) {
+        instructions.push({ content: projectInstructions, type: "run" });
+    }
+    const combinedInstructions = instructions
+        .map((instruction) => instruction.content)
+        .join("\n\n");
+    return {
+        content: [
+            {
+                type: "text",
+                text: formatAppInstructionsWithNumbers(combinedInstructions),
+                isError: false,
+            },
+        ],
+        isError: false,
+    };
+}

package/dist/tools/appautomate-utils/appium-sdk/index.d.ts

@@ -0,0 +1,7 @@
+export { getAppSDKPrefixCommand, getAppInstructionsForProjectConfiguration, } from "./instructions.js";
+export { generateAppBrowserStackYMLInstructions } from "./config-generator.js";
+export * from "./types.js";
+export * from "./constants.js";
+export * from "./utils.js";
+export * from "./instructions.js";
+export * from "./formatter.js";

package/dist/tools/appautomate-utils/appium-sdk/index.js

@@ -0,0 +1,8 @@
+// Barrel exports for App BrowserStack module
+export { getAppSDKPrefixCommand, getAppInstructionsForProjectConfiguration, } from "./instructions.js";
+export { generateAppBrowserStackYMLInstructions } from "./config-generator.js";
+export * from "./types.js";
+export * from "./constants.js";
+export * from "./utils.js";
+export * from "./instructions.js";
+export * from "./formatter.js";

package/dist/tools/appautomate-utils/appium-sdk/instructions.d.ts

@@ -0,0 +1,3 @@
+import { AppSDKSupportedLanguage, AppSDKSupportedTestingFramework } from "./index.js";
+export declare function getAppInstructionsForProjectConfiguration(framework: string, testingFramework: AppSDKSupportedTestingFramework, language: AppSDKSupportedLanguage): string;
+export declare function getAppSDKPrefixCommand(language: AppSDKSupportedLanguage, testingFramework: string, username: string, accessKey: string, appPath?: string): string;

package/dist/tools/appautomate-utils/appium-sdk/instructions.js

@@ -0,0 +1,47 @@
+// Language-specific instruction imports
+import { getJavaAppInstructions } from "./languages/java.js";
+import { getCSharpAppInstructions } from "./languages/csharp.js";
+import { getNodejsAppInstructions } from "./languages/nodejs.js";
+import { getPythonAppInstructions } from "./languages/python.js";
+import { getRubyAppInstructions } from "./languages/ruby.js";
+// Language-specific command imports
+import { getCSharpSDKCommand } from "./languages/csharp.js";
+import { getJavaSDKCommand } from "./languages/java.js";
+import { getNodejsSDKCommand } from "./languages/nodejs.js";
+import { getPythonSDKCommand } from "./languages/python.js";
+import { getRubySDKCommand } from "./languages/ruby.js";
+export function getAppInstructionsForProjectConfiguration(framework, testingFramework, language) {
+    if (!framework || !testingFramework || !language) {
+        return "";
+    }
+    switch (language) {
+        case "java":
+            return getJavaAppInstructions();
+        case "nodejs":
+            return getNodejsAppInstructions(testingFramework);
+        case "python":
+            return getPythonAppInstructions(testingFramework);
+        case "ruby":
+            return getRubyAppInstructions();
+        case "csharp":
+            return getCSharpAppInstructions();
+        default:
+            return "";
+    }
+}
+export function getAppSDKPrefixCommand(language, testingFramework, username, accessKey, appPath) {
+    switch (language) {
+        case "csharp":
+            return getCSharpSDKCommand(username, accessKey);
+        case "java":
+            return getJavaSDKCommand(testingFramework, username, accessKey, appPath);
+        case "nodejs":
+            return getNodejsSDKCommand(testingFramework, username, accessKey);
+        case "python":
+            return getPythonSDKCommand(testingFramework, username, accessKey);
+        case "ruby":
+            return getRubySDKCommand(testingFramework, username, accessKey);
+        default:
+            return "";
+    }
+}

package/dist/tools/appautomate-utils/appium-sdk/languages/csharp.d.ts

@@ -0,0 +1,2 @@
+export declare function getCSharpAppInstructions(): string;
+export declare function getCSharpSDKCommand(username: string, accessKey: string): string;