@browserstack/mcp-server 1.2.31 → 1.2.33-beta.1

package/dist/tools/accessibility.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { AccessibilityScanner } from "./accessiblity-utils/scanner.js";
 import { AccessibilityReportFetcher } from "./accessiblity-utils/report-fetcher.js";
-import { AccessibilityAuthConfig } from "./accessiblity-utils/auth-config.js";
+import { AccessibilityAuthConfig, safeAuthConfigData, } from "./accessiblity-utils/auth-config.js";
 import { trackMCP } from "../lib/instrumentation.js";
 import { parseAccessibilityReportFromCSV } from "./accessiblity-utils/report-parser.js";
 import { queryAccessibilityRAG } from "./accessiblity-utils/accessibility-rag.js";
@@ -148,7 +148,7 @@ async function executeCreateAuthConfig(args, server, config) {
         const result = await createAuthConfig(args, config);
         return createSuccessResponse([
             `✅ Auth config "${args.name}" created successfully with ID: ${result.data?.id}`,
-            `Auth config details: ${JSON.stringify(result.data, null, 2)}`,
+            `Auth config details: ${JSON.stringify(safeAuthConfigData(result), null, 2)}`,
         ]);
     }
     catch (error) {
@@ -168,7 +168,7 @@ async function executeGetAuthConfig(args, server, config) {
         const result = await authConfig.getAuthConfig(args.configId);
         return createSuccessResponse([
             `✅ Auth config retrieved successfully`,
-            `Auth config details: ${JSON.stringify(result.data, null, 2)}`,
+            `Auth config details: ${JSON.stringify(safeAuthConfigData(result), null, 2)}`,
         ]);
     }
     catch (error) {

package/dist/tools/accessiblity-utils/auth-config.d.ts

@@ -13,6 +13,17 @@ export interface AuthConfigResponse {
     };
     errors?: string[];
 }
+/**
+ * Allowlist of non-sensitive fields safe to return to the LLM/tool caller.
+ * Everything else (site username/password, selectors, undeclared keys) is
+ * dropped rather than echoed — see rules/tool-design.md "never echo".
+ */
+export declare function safeAuthConfigData(response?: AuthConfigResponse): {
+    url?: string | undefined;
+    id: number;
+    name: string;
+    type: string;
+} | undefined;
 export interface FormAuthData {
     username: string;
     usernameSelector: string;

package/dist/tools/accessiblity-utils/auth-config.js

@@ -1,5 +1,22 @@
 import { apiClient } from "../../lib/apiClient.js";
 import logger from "../../logger.js";
+/**
+ * Allowlist of non-sensitive fields safe to return to the LLM/tool caller.
+ * Everything else (site username/password, selectors, undeclared keys) is
+ * dropped rather than echoed — see rules/tool-design.md "never echo".
+ */
+export function safeAuthConfigData(response) {
+    const data = response?.data;
+    if (!data) {
+        return undefined;
+    }
+    return {
+        id: data.id,
+        name: data.name,
+        type: data.type,
+        ...(data.url ? { url: data.url } : {}),
+    };
+}
 export class AccessibilityAuthConfig {
     auth;
     setAuth(auth) {
@@ -44,14 +61,14 @@ export class AccessibilityAuthConfig {
                 body: requestBody,
             });
             const data = response.data;
-            logger.info(`The data returned from the API is: ${JSON.stringify(data)}`);
+            logger.info(`Auth config API returned: ${JSON.stringify(safeAuthConfigData(data))}`);
             if (!data.success) {
                 throw new Error(`Unable to create auth config: ${data.errors?.join(", ")}`);
             }
             return data;
         }
         catch (err) {
-            logger.error(`Error creating form auth config: ${JSON.stringify(err?.response?.data)}`);
+            logger.error(`Error creating form auth config (status ${err?.response?.status ?? "unknown"})`);
             const msg = err?.response?.data?.error ||
                 err?.response?.data?.message ||
                 err?.message ||

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

@@ -4,4 +4,4 @@ export declare function generateAppBrowserStackYMLInstructions(config: {
     platforms?: string[];
     testingFramework?: string;
     projectName?: string;
-}, username: string, accessKey: string, appPath?: string): string;
+}, appPath?: string): string;

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

@@ -1,5 +1,5 @@
-import { APP_DEVICE_CONFIGS, AppSDKSupportedTestingFrameworkEnum, DEFAULT_APP_PATH, createStep, } from "./index.js";
-export function generateAppBrowserStackYMLInstructions(config, username, accessKey, appPath = DEFAULT_APP_PATH) {
+import { APP_DEVICE_CONFIGS, AppSDKSupportedTestingFrameworkEnum, DEFAULT_APP_PATH, USERNAME_PLACEHOLDER, ACCESS_KEY_PLACEHOLDER, createStep, } from "./index.js";
+export function generateAppBrowserStackYMLInstructions(config, appPath = DEFAULT_APP_PATH) {
     if (config.testingFramework ===
         AppSDKSupportedTestingFrameworkEnum.nightwatch ||
         config.testingFramework ===
@@ -13,8 +13,8 @@ export function generateAppBrowserStackYMLInstructions(config, username, accessK
         ? `${config.projectName}-AppAutomate-Build`
         : "bstack-demo";
     const configContent = `\`\`\`yaml
-userName: ${username}
-accessKey: ${accessKey}
+userName: ${USERNAME_PLACEHOLDER}
+accessKey: ${ACCESS_KEY_PLACEHOLDER}
 app: ${appPath}
 platforms:
 ${platformConfigs}

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

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { AppSDKSupportedFrameworkEnum, AppSDKSupportedTestingFrameworkEnum, AppSDKSupportedLanguageEnum } from "./index.js";
+import { AppSDKSupportedFrameworkEnum, AppSDKSupportedTestingFrameworkEnum, AppSDKSupportedLanguageEnum } from "./types.js";
 export declare const APP_DEVICE_CONFIGS: {
     android: {
         deviceName: string;
@@ -11,6 +11,7 @@ export declare const APP_DEVICE_CONFIGS: {
     }[];
 };
 export declare const STEP_DELIMITER = "---STEP---";
+export { USERNAME_PLACEHOLDER, ACCESS_KEY_PLACEHOLDER, } from "../../sdk-utils/common/credentials.js";
 export declare const DEFAULT_APP_PATH = "bs://sample.app";
 export declare const MobileDeviceSchema: z.ZodObject<{
     platform: z.ZodEnum<{

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

@@ -1,5 +1,8 @@
 import { z } from "zod";
-import { AppSDKSupportedFrameworkEnum, AppSDKSupportedTestingFrameworkEnum, AppSDKSupportedLanguageEnum, } from "./index.js";
+// Import enums directly from types.js (not the index barrel) so this module has
+// no cycle back through index → instructions → languages/*, letting other
+// modules safely read the placeholder constants below at module scope.
+import { AppSDKSupportedFrameworkEnum, AppSDKSupportedTestingFrameworkEnum, AppSDKSupportedLanguageEnum, } from "./types.js";
 // App Automate specific device configurations
 export const APP_DEVICE_CONFIGS = {
     android: [
@@ -15,6 +18,7 @@ export const APP_DEVICE_CONFIGS = {
 };
 // Step delimiter for parsing instructions
 export const STEP_DELIMITER = "---STEP---";
+export { USERNAME_PLACEHOLDER, ACCESS_KEY_PLACEHOLDER, } from "../../sdk-utils/common/credentials.js";
 // Default app path for examples
 export const DEFAULT_APP_PATH = "bs://sample.app";
 export const MobileDeviceSchema = z.object({

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

@@ -2,7 +2,7 @@ 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 formatEnvCommands(isWindows: boolean): string;
+export declare function createEnvStep(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

@@ -1,4 +1,4 @@
-import { STEP_DELIMITER } from "./constants.js";
+import { STEP_DELIMITER, USERNAME_PLACEHOLDER, ACCESS_KEY_PLACEHOLDER, } from "./constants.js";
 export function formatFinalAppInstructions(formattedInstructions) {
     const fullInstructions = `
 ⚠️ IMPORTANT: DO NOT SKIP ANY STEP
@@ -25,21 +25,21 @@ ${content}`;
 export function combineInstructions(...instructionParts) {
     return instructionParts.filter(Boolean).join("\n\n");
 }
-export function formatEnvCommands(username, accessKey, isWindows) {
+export function formatEnvCommands(isWindows) {
     if (isWindows) {
         return `\`\`\`cmd
-setx BROWSERSTACK_USERNAME "${username}"
-setx BROWSERSTACK_ACCESS_KEY "${accessKey}"
+setx BROWSERSTACK_USERNAME "${USERNAME_PLACEHOLDER}"
+setx BROWSERSTACK_ACCESS_KEY "${ACCESS_KEY_PLACEHOLDER}"
 \`\`\``;
     }
     return `\`\`\`bash
-export BROWSERSTACK_USERNAME=${username}
-export BROWSERSTACK_ACCESS_KEY=${accessKey}
+export BROWSERSTACK_USERNAME="${USERNAME_PLACEHOLDER}"
+export BROWSERSTACK_ACCESS_KEY="${ACCESS_KEY_PLACEHOLDER}"
 \`\`\``;
 }
-export function createEnvStep(username, accessKey, isWindows, platformLabel, title = "Set BrowserStack credentials as environment variables:") {
+export function createEnvStep(isWindows, platformLabel, title = "Set BrowserStack credentials as environment variables:") {
     return createStep(title, `**${platformLabel}:**
-${formatEnvCommands(username, accessKey, isWindows)}`);
+${formatEnvCommands(isWindows)}`);
 }
 export function formatMultiLineCommand(command, isWindows = process.platform === "win32") {
     if (isWindows) {

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

@@ -1,14 +1,20 @@
 import { z } from "zod";
 import { getBrowserStackAuth } from "../../../lib/get-auth.js";
 import { validateAppAutomateDevices } from "../../sdk-utils/common/device-validator.js";
+import { CREDENTIALS_SUBSTITUTION_NOTE } from "../../sdk-utils/common/credentials.js";
 import { getAppUploadInstruction, validateSupportforAppAutomate, } from "./utils.js";
 import { getAppSDKPrefixCommand, generateAppBrowserStackYMLInstructions, } from "./index.js";
-import { formatAppInstructionsWithNumbers, getAppInstructionsForProjectConfiguration, SETUP_APP_AUTOMATE_SCHEMA, } from "./index.js";
+import { createStep, 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 = [];
+    const instructions = [
+        {
+            content: createStep("BrowserStack credentials", CREDENTIALS_SUBSTITUTION_NOTE),
+            type: "setup",
+        },
+    ];
     // Use variables for all major input properties
     const testingFramework = input.detectedTestingFramework;
     const language = input.detectedLanguage;
@@ -30,7 +36,7 @@ export async function setupAppAutomateHandler(rawInput, config) {
     // Extract platforms for backward compatibility (if needed)
     const platforms = validatedEnvironments.map((env) => env.platform);
     // Step 1: Generate SDK setup command
-    const sdkCommand = getAppSDKPrefixCommand(language, testingFramework, username, accessKey, appPath);
+    const sdkCommand = getAppSDKPrefixCommand(language, testingFramework, appPath);
     if (sdkCommand) {
         instructions.push({ content: sdkCommand, type: "setup" });
     }
@@ -40,7 +46,7 @@ export async function setupAppAutomateHandler(rawInput, config) {
         platforms,
         testingFramework,
         projectName: input.project,
-    }, username, accessKey, appPath);
+    }, appPath);
     if (configInstructions) {
         instructions.push({ content: configInstructions, type: "config" });
     }

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

@@ -1,3 +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;
+export declare function getAppSDKPrefixCommand(language: AppSDKSupportedLanguage, testingFramework: string, appPath?: string): string;

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

@@ -29,18 +29,18 @@ export function getAppInstructionsForProjectConfiguration(framework, testingFram
             return "";
     }
 }
-export function getAppSDKPrefixCommand(language, testingFramework, username, accessKey, appPath) {
+export function getAppSDKPrefixCommand(language, testingFramework, appPath) {
     switch (language) {
         case "csharp":
-            return getCSharpSDKCommand(username, accessKey);
+            return getCSharpSDKCommand();
         case "java":
-            return getJavaSDKCommand(testingFramework, username, accessKey, appPath);
+            return getJavaSDKCommand(testingFramework, appPath);
         case "nodejs":
-            return getNodejsSDKCommand(testingFramework, username, accessKey);
+            return getNodejsSDKCommand(testingFramework);
         case "python":
-            return getPythonSDKCommand(testingFramework, username, accessKey);
+            return getPythonSDKCommand(testingFramework);
         case "ruby":
-            return getRubySDKCommand(testingFramework, username, accessKey);
+            return getRubySDKCommand();
         default:
             return "";
     }

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

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

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

@@ -1,5 +1,5 @@
 // C# instructions and commands for App SDK utilities
-import { PLATFORM_UTILS, createStep, createEnvStep, combineInstructions, } from "../index.js";
+import { PLATFORM_UTILS, createStep, createEnvStep, combineInstructions, USERNAME_PLACEHOLDER, ACCESS_KEY_PLACEHOLDER, } from "../index.js";
 export function getCSharpAppInstructions() {
     const { isWindows, isAppleSilicon, getPlatformLabel } = PLATFORM_UTILS;
     let runCommand = "";
@@ -37,22 +37,22 @@ __Resolution:__
 - Remove or comment out any code or configuration in your test setup (e.g., step definitions, runners, or capabilities setup) that sets the app path directly.`);
     return runStep;
 }
-export function getCSharpSDKCommand(username, accessKey) {
+export function getCSharpSDKCommand() {
     const { isWindows = false, isAppleSilicon = false, getPlatformLabel = () => "Unknown", } = PLATFORM_UTILS || {};
     if (!PLATFORM_UTILS) {
         console.warn("PLATFORM_UTILS is undefined. Defaulting platform values.");
     }
-    const envStep = createEnvStep(username, accessKey, isWindows, getPlatformLabel());
+    const envStep = createEnvStep(isWindows, getPlatformLabel());
     const installCommands = isWindows
         ? `\`\`\`cmd
 dotnet add package BrowserStack.TestAdapter
 dotnet build
-dotnet browserstack-sdk setup --userName "${username}" --accessKey "${accessKey}"
+dotnet browserstack-sdk setup --userName "${USERNAME_PLACEHOLDER}" --accessKey "${ACCESS_KEY_PLACEHOLDER}"
 \`\`\``
         : `\`\`\`bash
 dotnet add package BrowserStack.TestAdapter
 dotnet build
-dotnet browserstack-sdk setup --userName "${username}" --accessKey "${accessKey}"
+dotnet browserstack-sdk setup --userName "${USERNAME_PLACEHOLDER}" --accessKey "${ACCESS_KEY_PLACEHOLDER}"
 \`\`\``;
     const installStep = createStep("Install BrowserStack SDK", `Run the following command to install the BrowserStack SDK and create a browserstack.yml file in the root directory of your project:
 

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

@@ -7,4 +7,4 @@ export declare const GRADLE_APP_SETUP_INSTRUCTIONS = "\n**For Gradle setup:**\n1
 export declare function getJavaAppInstructions(): string;
 export declare function getJavaAppFrameworkForMaven(framework: string): string;
 export declare function getJavaAppFrameworkVersion(framework: string): string;
-export declare function getJavaSDKCommand(framework: string, username: string, accessKey: string, appPath?: string): string;
+export declare function getJavaSDKCommand(framework: string, appPath?: string): string;

package/dist/tools/appautomate-utils/appium-sdk/languages/java.js

@@ -1,5 +1,5 @@
 // Java instructions and commands for App SDK utilities
-import { createStep, combineInstructions, createEnvStep, PLATFORM_UTILS, } from "../index.js";
+import { createStep, combineInstructions, createEnvStep, PLATFORM_UTILS, USERNAME_PLACEHOLDER, ACCESS_KEY_PLACEHOLDER, } from "../index.js";
 // Java-specific constants and mappings
 export const MAVEN_ARCHETYPE_GROUP_ID = "com.browserstack";
 export const MAVEN_ARCHETYPE_ARTIFACT_ID = "junit-archetype-integrate";
@@ -54,7 +54,7 @@ export function getJavaAppFrameworkForMaven(framework) {
 export function getJavaAppFrameworkVersion(framework) {
     return JAVA_APP_FRAMEWORK_VERSION_MAP[framework] || MAVEN_ARCHETYPE_VERSION;
 }
-function getMavenCommandForWindows(framework, mavenFramework, version, username, accessKey, appPath) {
+function getMavenCommandForWindows(framework, mavenFramework, version, appPath) {
     let command = `mvn archetype:generate -B ` +
         `-DarchetypeGroupId="${MAVEN_ARCHETYPE_GROUP_ID}" ` +
         `-DarchetypeArtifactId="${mavenFramework}" ` +
@@ -62,8 +62,8 @@ function getMavenCommandForWindows(framework, mavenFramework, version, username,
         `-DgroupId="${MAVEN_ARCHETYPE_GROUP_ID}" ` +
         `-DartifactId="${mavenFramework}" ` +
         `-Dversion="${version}" ` +
-        `-DBROWSERSTACK_USERNAME="${username}" ` +
-        `-DBROWSERSTACK_ACCESS_KEY="${accessKey}"`;
+        `-DBROWSERSTACK_USERNAME="${USERNAME_PLACEHOLDER}" ` +
+        `-DBROWSERSTACK_ACCESS_KEY="${ACCESS_KEY_PLACEHOLDER}"`;
     // Add framework parameter for browserstack-sdk-archetype-integrate
     if (mavenFramework === "browserstack-sdk-archetype-integrate") {
         command += ` -DBROWSERSTACK_FRAMEWORK="${framework}"`;
@@ -74,7 +74,7 @@ function getMavenCommandForWindows(framework, mavenFramework, version, username,
     }
     return command;
 }
-function getMavenCommandForUnix(framework, mavenFramework, version, username, accessKey, appPath) {
+function getMavenCommandForUnix(framework, mavenFramework, version, appPath) {
     let command = `mvn archetype:generate -B ` +
         `-DarchetypeGroupId="${MAVEN_ARCHETYPE_GROUP_ID}" ` +
         `-DarchetypeArtifactId="${mavenFramework}" ` +
@@ -82,8 +82,8 @@ function getMavenCommandForUnix(framework, mavenFramework, version, username, ac
         `-DgroupId="${MAVEN_ARCHETYPE_GROUP_ID}" ` +
         `-DartifactId="${mavenFramework}" ` +
         `-Dversion="${version}" ` +
-        `-DBROWSERSTACK_USERNAME="${username}" ` +
-        `-DBROWSERSTACK_ACCESS_KEY="${accessKey}"`;
+        `-DBROWSERSTACK_USERNAME="${USERNAME_PLACEHOLDER}" ` +
+        `-DBROWSERSTACK_ACCESS_KEY="${ACCESS_KEY_PLACEHOLDER}"`;
     // Add framework parameter for browserstack-sdk-archetype-integrate
     if (mavenFramework === "browserstack-sdk-archetype-integrate") {
         command += ` -DBROWSERSTACK_FRAMEWORK="${framework}"`;
@@ -94,18 +94,18 @@ function getMavenCommandForUnix(framework, mavenFramework, version, username, ac
     }
     return command;
 }
-export function getJavaSDKCommand(framework, username, accessKey, appPath) {
+export function getJavaSDKCommand(framework, appPath) {
     const { isWindows = false, getPlatformLabel } = PLATFORM_UTILS || {};
     const mavenFramework = getJavaAppFrameworkForMaven(framework);
     const version = getJavaAppFrameworkVersion(framework);
     let mavenCommand;
     if (isWindows) {
-        mavenCommand = getMavenCommandForWindows(framework, mavenFramework, version, username, accessKey, appPath);
+        mavenCommand = getMavenCommandForWindows(framework, mavenFramework, version, appPath);
     }
     else {
-        mavenCommand = getMavenCommandForUnix(framework, mavenFramework, version, username, accessKey, appPath);
+        mavenCommand = getMavenCommandForUnix(framework, mavenFramework, version, appPath);
     }
-    const envStep = createEnvStep(username, accessKey, isWindows, getPlatformLabel());
+    const envStep = createEnvStep(isWindows, getPlatformLabel());
     const mavenStep = createStep("Install BrowserStack SDK using Maven Archetype for App Automate", `Maven command for ${framework} (${getPlatformLabel()}):
     \`\`\`bash
     ${mavenCommand}

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

@@ -1,3 +1,3 @@
 import { AppSDKSupportedTestingFramework } from "../index.js";
-export declare function getNodejsSDKCommand(testingFramework: string, username: string, accessKey: string): string;
+export declare function getNodejsSDKCommand(testingFramework: string): string;
 export declare function getNodejsAppInstructions(testingFramework: AppSDKSupportedTestingFramework): string;

package/dist/tools/appautomate-utils/appium-sdk/languages/nodejs.js

@@ -1,17 +1,17 @@
 // Node.js instructions and commands for App SDK utilities
 import { AppSDKSupportedTestingFrameworkEnum, createStep, combineInstructions, } from "../index.js";
-export function getNodejsSDKCommand(testingFramework, username, accessKey) {
+export function getNodejsSDKCommand(testingFramework) {
     switch (testingFramework) {
         case "webdriverio":
-            return getWebDriverIOCommand(username, accessKey);
+            return getWebDriverIOCommand();
         case "nightwatch":
-            return getNightwatchCommand(username, accessKey);
+            return getNightwatchCommand();
         case "jest":
-            return getJestCommand(username, accessKey);
+            return getJestCommand();
         case "mocha":
-            return getMochaCommand(username, accessKey);
+            return getMochaCommand();
         case "cucumberJs":
-            return getCucumberJSCommand(username, accessKey);
+            return getCucumberJSCommand();
         default:
             return "";
     }
@@ -39,22 +39,22 @@ export function getNodejsAppInstructions(testingFramework) {
             return "";
     }
 }
-function getWebDriverIOCommand(username, accessKey) {
+function getWebDriverIOCommand() {
     const prerequisiteStep = createStep("Prerequisite Setup:", `a. Ensure you do not modify or replace any existing local driver code, 
     as it will be automatically managed and overwritten by the BrowserStack SDK/Driver.
     b. Do not create any YML file in this integration as it is not required.
     c. Ensure you create the WDIO config file as per the instructions below.`);
     const envStep = createStep("Set your BrowserStack credentials as environment variables:", `\`\`\`bash
-export BROWSERSTACK_USERNAME=${username}
-export BROWSERSTACK_ACCESS_KEY=${accessKey}
+export BROWSERSTACK_USERNAME="<your_browserstack_username>"
+export BROWSERSTACK_ACCESS_KEY="<your_browserstack_access_key>"
 \`\`\``);
     const installStep = createStep("Install BrowserStack WDIO service:", `\`\`\`bash
 npm install @wdio/browserstack-service@^7 --save-dev
 \`\`\``);
     const configStep = createStep("Update your WebdriverIO config file (e.g., \\`wdio.conf.js\\`) to add the BrowserStack service and capabilities:", `\`\`\`js
 exports.config = {
-  user: process.env.BROWSERSTACK_USERNAME || '${username}',
-  key: process.env.BROWSERSTACK_ACCESS_KEY || '${accessKey}',
+  user: process.env.BROWSERSTACK_USERNAME || '<your_browserstack_username>',
+  key: process.env.BROWSERSTACK_ACCESS_KEY || '<your_browserstack_access_key>',
   hostname: 'hub.browserstack.com',
   services: [
     [
@@ -92,14 +92,14 @@ exports.config = {
 \`\`\``);
     return combineInstructions(prerequisiteStep, envStep, installStep, configStep);
 }
-function getNightwatchCommand(username, accessKey) {
+function getNightwatchCommand() {
     const prerequisiteStep = createStep("Prerequisite Setup:", ` a. Ensure you do not modify or replace any existing local driver code, 
       as it will be automatically managed and overwritten by the BrowserStack SDK/Driver.
       b. Do not create any YML file in this integration as it is not required.
       c. Ensure you create the WDIO config file as per the instructions below.`);
     const envStep = createStep("Set your BrowserStack credentials as environment variables:", `\`\`\`bash 
-export BROWSERSTACK_USERNAME=${username}
-export BROWSERSTACK_ACCESS_KEY=${accessKey}
+export BROWSERSTACK_USERNAME="<your_browserstack_username>"
+export BROWSERSTACK_ACCESS_KEY="<your_browserstack_access_key>"
 \`\`\``);
     const installStep = createStep("Install Nightwatch and BrowserStack integration:", `\`\`\`bash
 npm install --save-dev @nightwatch/browserstack
@@ -166,29 +166,29 @@ npm install --save-dev @nightwatch/browserstack
 \`\`\``);
     return combineInstructions(prerequisiteStep, envStep, installStep, configStep);
 }
-function getJestCommand(username, accessKey) {
+function getJestCommand() {
     const envStep = createStep("Set your BrowserStack credentials as environment variables:", `\`\`\`bash
-export BROWSERSTACK_USERNAME=${username}
-export BROWSERSTACK_ACCESS_KEY=${accessKey}
+export BROWSERSTACK_USERNAME="<your_browserstack_username>"
+export BROWSERSTACK_ACCESS_KEY="<your_browserstack_access_key>"
 \`\`\``);
     const installStep = createStep("Install Jest and BrowserStack SDK:", `\`\`\`bash
 npm install --save-dev browserstack-node-sdk
 \`\`\``);
     return combineInstructions(envStep, installStep);
 }
-function getMochaCommand(username, accessKey) {
+function getMochaCommand() {
     const envStep = createStep("Set your BrowserStack credentials as environment variables:", `\`\`\`bash
-export BROWSERSTACK_USERNAME=${username}
-export BROWSERSTACK_ACCESS_KEY=${accessKey}
+export BROWSERSTACK_USERNAME="<your_browserstack_username>"
+export BROWSERSTACK_ACCESS_KEY="<your_browserstack_access_key>"
 \`\`\``);
     const installStep = createStep("Install Mocha and BrowserStack SDK:", `\`\`\`bash
 npm install --save-dev browserstack-node-sdk
 \`\`\``);
     return combineInstructions(envStep, installStep);
 }
-function getCucumberJSCommand(username, accessKey) {
+function getCucumberJSCommand() {
     return createStep("Set your BrowserStack credentials as environment variables:", `\`\`\`bash
-export BROWSERSTACK_USERNAME=${username}
-export BROWSERSTACK_ACCESS_KEY=${accessKey}
+export BROWSERSTACK_USERNAME="<your_browserstack_username>"
+export BROWSERSTACK_ACCESS_KEY="<your_browserstack_access_key>"
 \`\`\``);
 }

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

@@ -1,3 +1,3 @@
 import { AppSDKSupportedTestingFramework } from "../index.js";
 export declare function getPythonAppInstructions(testingFramework: AppSDKSupportedTestingFramework): string;
-export declare function getPythonSDKCommand(framework: string, username: string, accessKey: string): string;
+export declare function getPythonSDKCommand(framework: string): string;

package/dist/tools/appautomate-utils/appium-sdk/languages/python.js

@@ -1,5 +1,5 @@
 // Python instructions and commands for App SDK utilities
-import { AppSDKSupportedTestingFrameworkEnum, createStep, createEnvStep, combineInstructions, PLATFORM_UTILS, } from "../index.js";
+import { AppSDKSupportedTestingFrameworkEnum, createStep, createEnvStep, combineInstructions, PLATFORM_UTILS, USERNAME_PLACEHOLDER, ACCESS_KEY_PLACEHOLDER, } from "../index.js";
 export function getPythonAppInstructions(testingFramework) {
     switch (testingFramework) {
         case AppSDKSupportedTestingFrameworkEnum.robot:
@@ -23,37 +23,37 @@ paver run first_test
             return "";
     }
 }
-export function getPythonSDKCommand(framework, username, accessKey) {
+export function getPythonSDKCommand(framework) {
     const { isWindows, getPlatformLabel } = PLATFORM_UTILS;
     switch (framework) {
         case "robot":
         case "pytest":
         case "behave":
-            return getPythonCommonSDKCommand(username, accessKey, isWindows, getPlatformLabel());
+            return getPythonCommonSDKCommand(isWindows, getPlatformLabel());
         case "lettuce":
-            return getLettuceCommand(username, accessKey, isWindows, getPlatformLabel());
+            return getLettuceCommand(isWindows, getPlatformLabel());
         default:
             return "";
     }
 }
-function getPythonCommonSDKCommand(username, accessKey, isWindows, platformLabel) {
-    const envStep = createEnvStep(username, accessKey, isWindows, platformLabel, "Set your BrowserStack credentials as environment variables:");
+function getPythonCommonSDKCommand(isWindows, platformLabel) {
+    const envStep = createEnvStep(isWindows, platformLabel, "Set your BrowserStack credentials as environment variables:");
     const installStep = createStep("Install BrowserStack Python SDK:", `\`\`\`bash
 python3 -m pip install browserstack-sdk
 \`\`\``);
     const setupStep = createStep("Set up BrowserStack SDK:", `\`\`\`bash
-browserstack-sdk setup --username "${username}" --key "${accessKey}"
+browserstack-sdk setup --username "${USERNAME_PLACEHOLDER}" --key "${ACCESS_KEY_PLACEHOLDER}"
 \`\`\``);
     return combineInstructions(envStep, installStep, setupStep);
 }
-function getLettuceCommand(username, accessKey, isWindows, platformLabel) {
-    const envStep = createEnvStep(username, accessKey, isWindows, platformLabel, "Set your BrowserStack credentials as environment variables:");
+function getLettuceCommand(isWindows, platformLabel) {
+    const envStep = createEnvStep(isWindows, platformLabel, "Set your BrowserStack credentials as environment variables:");
     const configStep = createStep("Configure Appium's desired capabilities in config.json:", `**Android example:**
 \`\`\`json
 {
     "capabilities": {
-      "browserstack.user" : "${username}",
-      "browserstack.key" : "${accessKey}",
+      "browserstack.user" : "${USERNAME_PLACEHOLDER}",
+      "browserstack.key" : "${ACCESS_KEY_PLACEHOLDER}",
       "project": "First Lettuce Android Project",
       "build": "Lettuce Android",
       "name": "first_test",

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

@@ -1,2 +1,2 @@
 export declare function getRubyAppInstructions(): string;
-export declare function getRubySDKCommand(framework: string, username: string, accessKey: string): string;
+export declare function getRubySDKCommand(): string;

package/dist/tools/appautomate-utils/appium-sdk/languages/ruby.js

@@ -1,7 +1,10 @@
 // Ruby instructions and commands for App SDK utilities
 import { createStep, combineInstructions, createEnvStep, PLATFORM_UTILS, } from "../index.js";
-const username = "${process.env.BROWSERSTACK_USERNAME}";
-const accessKey = "${process.env.BROWSERSTACK_ACCESS_KEY}";
+// Import placeholders straight from constants.js (not the index barrel) so these
+// module-scope constants have no circular dependency on the barrel.
+import { USERNAME_PLACEHOLDER, ACCESS_KEY_PLACEHOLDER } from "../constants.js";
+const username = USERNAME_PLACEHOLDER;
+const accessKey = ACCESS_KEY_PLACEHOLDER;
 export function getRubyAppInstructions() {
     const configStep = createStep("Create/Update the config file (config.yml) as follows:", `\`\`\`yaml
 server: "hub-cloud.browserstack.com"
@@ -56,9 +59,9 @@ bundle exec cucumber
 \`\`\``);
     return combineInstructions(configStep, envStep, runStep);
 }
-export function getRubySDKCommand(framework, username, accessKey) {
+export function getRubySDKCommand() {
     const { isWindows, getPlatformLabel } = PLATFORM_UTILS;
-    const envStep = createEnvStep(username, accessKey, isWindows, getPlatformLabel(), "Set your BrowserStack credentials as environment variables:");
+    const envStep = createEnvStep(isWindows, getPlatformLabel(), "Set your BrowserStack credentials as environment variables:");
     const installStep = createStep("Install required Ruby gems:", `\`\`\`bash
 # Install Bundler if not already installed
 gem install bundler

package/dist/tools/sdk-utils/bstack/commands.d.ts

@@ -1,3 +1,3 @@
 import { SDKSupportedLanguage } from "../common/types.js";
-export declare function getSDKPrefixCommand(language: SDKSupportedLanguage, framework: string, username: string, accessKey: string): string;
+export declare function getSDKPrefixCommand(language: SDKSupportedLanguage, framework: string): string;
 export declare function getJavaFrameworkForMaven(framework: string): string;