@browserstack/mcp-server 1.2.5 → 1.2.6

package/dist/index.d.ts

@@ -3,3 +3,4 @@ import "dotenv/config";
 export { setLogger } from "./logger.js";
 export { BrowserStackMcpServer } from "./server-factory.js";
 export { trackMCP } from "./lib/instrumentation.js";
+export declare const PackageJsonVersion: any;

package/dist/index.js

@@ -36,3 +36,4 @@ process.on("exit", () => {
 export { setLogger } from "./logger.js";
 export { BrowserStackMcpServer } from "./server-factory.js";
 export { trackMCP } from "./lib/instrumentation.js";
+export const PackageJsonVersion = packageJson.version;

package/dist/lib/apiClient.d.ts

@@ -5,6 +5,7 @@ type RequestOptions = {
     params?: Record<string, string | number>;
     body?: any;
     timeout?: number;
+    responseType?: AxiosRequestConfig["responseType"];
     raise_error?: boolean;
 };
 declare class ApiResponse<T = any> {
@@ -23,7 +24,7 @@ declare class ApiClient {
     private get axiosAgent();
     private validateUrl;
     private requestWrapper;
-    get<T = any>({ url, headers, params, timeout, raise_error, }: RequestOptions): Promise<ApiResponse<T>>;
+    get<T = any>({ url, headers, params, timeout, responseType, raise_error, }: RequestOptions): Promise<ApiResponse<T>>;
     post<T = any>({ url, headers, body, timeout, raise_error, }: RequestOptions): Promise<ApiResponse<T>>;
     put<T = any>({ url, headers, body, timeout, raise_error, }: RequestOptions): Promise<ApiResponse<T>>;
     patch<T = any>({ url, headers, body, timeout, raise_error, }: RequestOptions): Promise<ApiResponse<T>>;

package/dist/lib/apiClient.js

@@ -120,11 +120,12 @@ class ApiClient {
             throw error;
         }
     }
-    async get({ url, headers, params, timeout, raise_error = true, }) {
+    async get({ url, headers, params, timeout, responseType, raise_error = true, }) {
         const config = {
             headers,
             params,
             timeout,
+            responseType,
             httpsAgent: this.axiosAgent,
         };
         return this.requestWrapper(() => this.instance.get(url, config), url, config, raise_error);

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

@@ -1,2 +1,6 @@
 export declare const signedUrlMap: Map<string, object>;
-export declare const testFilePathsMap: Map<string, string[]>;
+export declare const storedPercyResults: {
+    get: () => any;
+    set: (value: any) => void;
+    clear: () => void;
+};

package/dist/lib/inmemory-store.js

@@ -1,2 +1,11 @@
 export const signedUrlMap = new Map();
-export const testFilePathsMap = new Map();
+let _storedPercyResults = null;
+export const storedPercyResults = {
+    get: () => _storedPercyResults,
+    set: (value) => {
+        _storedPercyResults = value;
+    },
+    clear: () => {
+        _storedPercyResults = null;
+    },
+};

package/dist/lib/version-resolver.js

@@ -24,6 +24,10 @@ export function resolveVersion(requested, available) {
     if (uniq.includes(requested)) {
         return requested;
     }
+    const caseInsensitiveMatch = uniq.find((v) => v.toLowerCase() === requested.toLowerCase());
+    if (caseInsensitiveMatch) {
+        return caseInsensitiveMatch;
+    }
     // Try major version matching (e.g., "14" matches "14.0", "14.1", etc.)
     const reqNum = parseFloat(requested);
     if (!isNaN(reqNum)) {

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

@@ -1,5 +1,4 @@
 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

@@ -1,16 +1,21 @@
-import { testFilePathsMap } from "../lib/inmemory-store.js";
+import { storedPercyResults } 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}`);
+    const { index } = args;
+    const stored = storedPercyResults.get();
+    if (!stored || !stored.testFiles) {
+        throw new Error(`No test files found in memory. Please call listTestFiles first.`);
     }
+    const fileStatusMap = stored.testFiles;
+    const filePaths = Object.keys(fileStatusMap);
     if (index < 0 || index >= filePaths.length) {
-        throw new Error(`Invalid index: ${index}. There are ${filePaths.length} files for UUID: ${uuid}`);
+        throw new Error(`Invalid index: ${index}. There are ${filePaths.length} files available.`);
     }
     const result = await updateFileAndStep(filePaths[index], index, filePaths.length, percyWebSetupInstructions);
+    const updatedStored = { ...stored };
+    updatedStored.testFiles[filePaths[index]] = true; // true = updated
+    storedPercyResults.set(updatedStored);
     return {
         content: result,
     };

package/dist/tools/automate-utils/fetch-screenshots.js

@@ -39,7 +39,10 @@ async function extractScreenshotUrls(sessionId, sessionType, config) {
 //Converts screenshot URLs to base64 encoded images
 async function convertUrlsToBase64(urls) {
     const screenshots = await Promise.all(urls.map(async (url) => {
-        const response = await apiClient.get({ url });
+        const response = await apiClient.get({
+            url,
+            responseType: "arraybuffer",
+        });
         // Axios returns response.data as a Buffer for binary data
         const base64 = Buffer.from(response.data).toString("base64");
         // Compress the base64 image if needed

package/dist/tools/list-test-files.d.ts

@@ -1,2 +1,2 @@
 import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-export declare function addListTestFiles(args: any): Promise<CallToolResult>;
+export declare function addListTestFiles(): Promise<CallToolResult>;

package/dist/tools/list-test-files.js

@@ -1,35 +1,59 @@
 import { listTestFiles } from "./percy-snapshot-utils/detect-test-files.js";
-import { testFilePathsMap } from "../lib/inmemory-store.js";
-import crypto from "crypto";
-export async function addListTestFiles(args) {
-    const { dirs, language, framework } = args;
-    let testFiles = [];
-    if (!dirs || dirs.length === 0) {
-        throw new Error("No directories provided to add the test files. Please provide test directories to add percy snapshot commands.");
+import { storedPercyResults } from "../lib/inmemory-store.js";
+import { updateFileAndStep } from "./percy-snapshot-utils/utils.js";
+import { percyWebSetupInstructions } from "./sdk-utils/percy-web/handler.js";
+export async function addListTestFiles() {
+    const storedResults = storedPercyResults.get();
+    if (!storedResults) {
+        throw new Error("No Framework details found. Please call expandPercyVisualTesting first to fetch the framework details.");
     }
-    for (const dir of dirs) {
-        const files = await listTestFiles({
-            language,
-            framework,
-            baseDir: dir,
-        });
+    const language = storedResults.detectedLanguage;
+    const framework = storedResults.detectedTestingFramework;
+    // Use stored paths from setUpPercy
+    const dirs = storedResults.folderPaths;
+    const files = storedResults.filePaths;
+    let testFiles = [];
+    if (files && files.length > 0) {
         testFiles = testFiles.concat(files);
     }
+    if (dirs && dirs.length > 0) {
+        for (const dir of dirs) {
+            const discoveredFiles = await listTestFiles({
+                language,
+                framework,
+                baseDir: dir,
+            });
+            testFiles = testFiles.concat(discoveredFiles);
+        }
+    }
+    // Validate that we have at least one test file
     if (testFiles.length === 0) {
-        throw new Error("No test files found");
+        throw new Error("No test files found. Please provide either specific file paths (files) or directory paths (dirs) containing test files.");
+    }
+    if (testFiles.length === 1) {
+        const result = await updateFileAndStep(testFiles[0], 0, 1, percyWebSetupInstructions);
+        return {
+            content: result,
+        };
     }
-    // Generate a UUID and store the test files in memory
-    const uuid = crypto.randomUUID();
-    testFilePathsMap.set(uuid, testFiles);
+    // For multiple files, store directly in testFiles
+    const fileStatusMap = {};
+    testFiles.forEach((file) => {
+        fileStatusMap[file] = false; // false = not updated, true = updated
+    });
+    // Update storedPercyResults with test files
+    const updatedStored = { ...storedResults };
+    updatedStored.testFiles = fileStatusMap;
+    storedPercyResults.set(updatedStored);
     return {
         content: [
             {
                 type: "text",
-                text: `The Test files are stored in memory with id ${uuid} and the total number of tests files found is ${testFiles.length}. You can use this UUID to retrieve the tests file paths later.`,
+                text: `The Test files are stored in memory and the total number of tests files found is ${testFiles.length}.`,
             },
             {
                 type: "text",
-                text: `You can now use the tool addPercySnapshotCommands to update the test file with Percy commands for visual testing with the UUID ${uuid}`,
+                text: `You can now use the tool addPercySnapshotCommands to update the test file with Percy commands for visual testing.`,
             },
         ],
     };

package/dist/tools/percy-sdk.js

@@ -8,7 +8,7 @@ import { approveOrDeclinePercyBuild } from "./review-agent-utils/percy-approve-r
 import { setUpPercyHandler, simulatePercyChangeHandler, } from "./sdk-utils/handler.js";
 import { z } from "zod";
 import { SETUP_PERCY_DESCRIPTION, LIST_TEST_FILES_DESCRIPTION, PERCY_SNAPSHOT_COMMANDS_DESCRIPTION, SIMULATE_PERCY_CHANGE_DESCRIPTION, } from "./sdk-utils/common/constants.js";
-import { ListTestFilesParamsShape, UpdateTestFileWithInstructionsParams, } from "./percy-snapshot-utils/constants.js";
+import { UpdateTestFileWithInstructionsParams } from "./percy-snapshot-utils/constants.js";
 import { RunPercyScanParamsShape, FetchPercyChangesParamsShape, ManagePercyBuildApprovalParamsShape, } from "./sdk-utils/common/schema.js";
 import { handleMCPError } from "../lib/utils.js";
 export function registerPercyTools(server, config) {
@@ -57,10 +57,10 @@ export function registerPercyTools(server, config) {
             return handleMCPError("addPercySnapshotCommands", server, config, error);
         }
     });
-    tools.listTestFiles = server.tool("listTestFiles", LIST_TEST_FILES_DESCRIPTION, ListTestFilesParamsShape, async (args) => {
+    tools.listTestFiles = server.tool("listTestFiles", LIST_TEST_FILES_DESCRIPTION, {}, async () => {
         try {
             trackMCP("listTestFiles", server.server.getClientVersion(), config);
-            return addListTestFiles(args);
+            return addListTestFiles();
         }
         catch (error) {
             return handleMCPError("listTestFiles", server, config, error);

package/dist/tools/percy-snapshot-utils/constants.d.ts

@@ -2,14 +2,8 @@ import { z } from "zod";
 import { SDKSupportedLanguage } from "../sdk-utils/common/types.js";
 import { DetectionConfig } from "./types.js";
 export declare const UpdateTestFileWithInstructionsParams: {
-    uuid: z.ZodString;
     index: z.ZodNumber;
 };
-export declare const ListTestFilesParamsShape: {
-    dirs: z.ZodArray<z.ZodString, "many">;
-    language: z.ZodEnum<[string, ...string[]]>;
-    framework: z.ZodEnum<[string, ...string[]]>;
-};
 export declare const TEST_FILE_DETECTION: Record<SDKSupportedLanguage, DetectionConfig>;
 export declare const EXCLUDED_DIRS: Set<string>;
 export declare const backendIndicators: RegExp[];

package/dist/tools/percy-snapshot-utils/constants.js

@@ -1,22 +1,7 @@
 import { z } from "zod";
-import { SDKSupportedLanguages, SDKSupportedTestingFrameworks, } from "../sdk-utils/common/types.js";
 export const UpdateTestFileWithInstructionsParams = {
-    uuid: z
-        .string()
-        .describe("UUID referencing the in-memory array of test file paths"),
     index: z.number().describe("Index of the test file to update"),
 };
-export const ListTestFilesParamsShape = {
-    dirs: z
-        .array(z.string())
-        .describe("Array of directory paths to search for test files"),
-    language: z
-        .enum(SDKSupportedLanguages)
-        .describe("Programming language"),
-    framework: z
-        .enum(SDKSupportedTestingFrameworks)
-        .describe("Testing framework (optional)"),
-};
 export const TEST_FILE_DETECTION = {
     java: {
         extensions: [".java"],

package/dist/tools/rca-agent-utils/constants.d.ts

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { TestStatus } from "./types.js";
 export declare const FETCH_RCA_PARAMS: {
-    testId: z.ZodArray<z.ZodString, "many">;
+    testId: z.ZodArray<z.ZodNumber, "many">;
 };
 export declare const GET_BUILD_ID_PARAMS: {
     browserStackProjectName: z.ZodString;

package/dist/tools/rca-agent-utils/constants.js

@@ -2,9 +2,9 @@ import { z } from "zod";
 import { TestStatus } from "./types.js";
 export const FETCH_RCA_PARAMS = {
     testId: z
-        .array(z.string())
+        .array(z.number().int())
         .max(3)
-        .describe("Array of test IDs to fetch RCA data for (maximum 3 IDs). If not provided, use the listTestIds tool get all failed testcases. If more than 3 IDs are provided, only the first 3 will be processed."),
+        .describe("Array of integer test IDs to fetch RCA data for (maximum 3 IDs). These must be numeric test IDs, not session IDs or strings. If not provided, use the listTestIds tool to get all failed testcases. If more than 3 IDs are provided, only the first 3 will be processed."),
 };
 export const GET_BUILD_ID_PARAMS = {
     browserStackProjectName: z

package/dist/tools/rca-agent-utils/rca-data.d.ts

@@ -5,5 +5,5 @@ interface ScanProgressContext {
         progressToken?: string | number;
     };
 }
-export declare function getRCAData(testIds: string[], authString: string, context?: ScanProgressContext): Promise<RCAResponse>;
+export declare function getRCAData(testIds: number[], authString: string, context?: ScanProgressContext): Promise<RCAResponse>;
 export {};

package/dist/tools/rca-agent-utils/rca-data.js

@@ -66,7 +66,7 @@ async function updateProgress(context, testCases, message) {
         : calculateProgress(resolvedCount, testCases.length));
 }
 async function fetchInitialRCA(testId, headers, baseUrl) {
-    const url = baseUrl.replace("{testId}", testId);
+    const url = baseUrl.replace("{testId}", testId.toString());
     try {
         const response = await fetch(url, { headers });
         if (!response.ok) {
@@ -125,7 +125,7 @@ async function pollRCAResults(testCases, headers, baseUrl, context, pollInterval
             }
             await Promise.allSettled(inProgressCases.map(async (tc) => {
                 try {
-                    const pollUrl = baseUrl.replace("{testId}", tc.id);
+                    const pollUrl = baseUrl.replace("{testId}", tc.id.toString());
                     const response = await fetch(pollUrl, { headers });
                     if (!response.ok) {
                         const errorText = await response.text();

package/dist/tools/rca-agent-utils/types.d.ts

@@ -18,7 +18,7 @@ export interface TestRun {
     };
 }
 export interface FailedTestInfo {
-    test_id: string;
+    test_id: number;
     test_name: string;
 }
 export declare enum RCAState {
@@ -34,8 +34,8 @@ export declare enum RCAState {
     TIMEOUT = "TIMEOUT"
 }
 export interface RCATestCase {
-    id: string;
-    testRunId: string;
+    id: number;
+    testRunId: number;
     state: RCAState;
     rcaData?: any;
 }

package/dist/tools/rca-agent.d.ts

@@ -5,7 +5,7 @@ import { TestStatus } from "./rca-agent-utils/types.js";
 import { BuildIdArgs } from "./rca-agent-utils/types.js";
 export declare function getBuildIdTool(args: BuildIdArgs, config: BrowserStackConfig): Promise<CallToolResult>;
 export declare function fetchRCADataTool(args: {
-    testId: string[];
+    testId: number[];
 }, config: BrowserStackConfig): Promise<CallToolResult>;
 export declare function listTestIdsTool(args: {
     buildId: string;

package/dist/tools/run-percy-scan.js

@@ -1,21 +1,28 @@
 import { getBrowserStackAuth } from "../lib/get-auth.js";
 import { fetchPercyToken } from "./sdk-utils/percy-web/fetchPercyToken.js";
+import { storedPercyResults } from "../lib/inmemory-store.js";
+import { getFrameworkTestCommand, PERCY_FALLBACK_STEPS, } from "./sdk-utils/percy-web/constants.js";
+import path from "path";
 export async function runPercyScan(args, config) {
     const { projectName, integrationType, instruction } = args;
     const authorization = getBrowserStackAuth(config);
     const percyToken = await fetchPercyToken(projectName, authorization, {
         type: integrationType,
     });
-    const steps = [generatePercyTokenInstructions(percyToken)];
-    if (instruction) {
-        steps.push(`Use the provided test command with Percy:\n${instruction}`, `If this command fails or is incorrect, fall back to the default approach below.`);
-    }
-    steps.push(`Attempt to infer the project's test command from context (high confidence commands first):
-    - Java → mvn test
-    - Python → pytest
-    - Node.js → npm test or yarn test
-    - Cypress → cypress run
-    or from package.json scripts`, `Wrap the inferred command with Percy along with label: \nnpx percy exec --labels=mcp -- <test command>`, `If the test command cannot be inferred confidently, ask the user directly for the correct test command.`);
+    // Check if we have stored data and project matches
+    const stored = storedPercyResults.get();
+    // Compute if we have updated files to run
+    const hasUpdatedFiles = checkForUpdatedFiles(stored, projectName);
+    const updatedFiles = hasUpdatedFiles ? getUpdatedFiles(stored) : [];
+    // Build steps array with conditional spread
+    const steps = [
+        generatePercyTokenInstructions(percyToken),
+        ...(hasUpdatedFiles ? generateUpdatedFilesSteps(stored, updatedFiles) : []),
+        ...(instruction && !hasUpdatedFiles
+            ? generateInstructionSteps(instruction)
+            : []),
+        ...(!hasUpdatedFiles ? PERCY_FALLBACK_STEPS : []),
+    ];
     const instructionContext = steps
         .map((step, index) => `${index + 1}. ${step}`)
         .join("\n\n");
@@ -35,3 +42,37 @@ export PERCY_TOKEN="${percyToken}"
 
 (For Windows: use 'setx PERCY_TOKEN "${percyToken}"' or 'set PERCY_TOKEN=${percyToken}' as appropriate.)`;
 }
+const toAbs = (p) => p ? path.resolve(p) : undefined;
+function checkForUpdatedFiles(stored, // storedPercyResults structure
+projectName) {
+    const projectMatches = stored?.projectName === projectName;
+    return (projectMatches &&
+        stored?.testFiles &&
+        Object.values(stored.testFiles).some((status) => status === true));
+}
+function getUpdatedFiles(stored) {
+    const updatedFiles = [];
+    const fileStatusMap = stored.testFiles;
+    Object.entries(fileStatusMap).forEach(([filePath, status]) => {
+        if (status === true) {
+            updatedFiles.push(filePath);
+        }
+    });
+    return updatedFiles;
+}
+function generateUpdatedFilesSteps(stored, updatedFiles) {
+    const filesToRun = updatedFiles.map(toAbs).filter(Boolean);
+    const { detectedLanguage, detectedTestingFramework } = stored;
+    const exampleCommand = getFrameworkTestCommand(detectedLanguage, detectedTestingFramework);
+    return [
+        `Run only the updated files with Percy:\n` +
+            `Example: ${exampleCommand} <file1> <file2> ...`,
+        `Updated files to run:\n${filesToRun.join("\n")}`,
+    ];
+}
+function generateInstructionSteps(instruction) {
+    return [
+        `Use the provided test command with Percy:\n${instruction}`,
+        `If this command fails or is incorrect, fall back to the default approach below.`,
+    ];
+}

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

@@ -1,7 +1,8 @@
 import { ValidatedEnvironment } from "../common/device-validator.js";
+import { BrowserStackConfig } from "../../../lib/types.js";
 export declare function generateBrowserStackYMLInstructions(config: {
     validatedEnvironments?: ValidatedEnvironment[];
     platforms?: string[];
     enablePercy?: boolean;
     projectName: string;
-}): string;
+}, browserStackConfig: BrowserStackConfig): string;

package/dist/tools/sdk-utils/bstack/configUtils.js

@@ -1,15 +1,22 @@
-export function generateBrowserStackYMLInstructions(config) {
+import { getBrowserStackAuth } from "../../../lib/get-auth.js";
+export function generateBrowserStackYMLInstructions(config, browserStackConfig) {
     const enablePercy = config.enablePercy || false;
     const projectName = config.projectName || "BrowserStack Automate Build";
+    // Get credentials from config
+    const authString = getBrowserStackAuth(browserStackConfig);
+    const [username, accessKey] = authString.split(":");
     // Generate platform configurations using the utility function
     const platformConfigs = generatePlatformConfigs(config);
-    const stepTitle = "Create a browserstack.yml file in the project root with your validated device configurations:";
+    const stepTitle = "Create a browserstack.yml file in the project root with your validated device configurations:If already exists, update it with the following content for devices and project details.";
     const buildName = `${projectName}-Build`;
     let ymlContent = `
 # ======================
 # BrowserStack Reporting
 # ======================
 
+userName: ${username}
+accessKey: ${accessKey}
+
 # TODO: Replace these sample values with your actual project details
 projectName: ${projectName}
 buildName: ${buildName}

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

@@ -2,7 +2,7 @@ import { ConfigMapping } from "../common/types.js";
 /**
  * ---------- PYTHON INSTRUCTIONS ----------
  */
-export declare const pythonInstructions: (username: string, accessKey: string) => {
+export declare const pythonInstructions: () => {
     setup: string;
     run: string;
 };

package/dist/tools/sdk-utils/bstack/constants.js

@@ -1,7 +1,7 @@
 /**
  * ---------- PYTHON INSTRUCTIONS ----------
  */
-export const pythonInstructions = (username, accessKey) => {
+export const pythonInstructions = () => {
     const setup = `
 ---STEP---
 
@@ -9,20 +9,18 @@ Install the BrowserStack SDK:
 \`\`\`bash
 python3 -m pip install browserstack-sdk
 \`\`\`
-
----STEP---
-
-Setup the BrowserStack SDK with your credentials:
-\`\`\`bash
-browserstack-sdk setup --username "${username}" --key "${accessKey}"
-\`\`\`
 `;
     const run = `
 ---STEP---
 
 Run your tests on BrowserStack:
 \`\`\`bash
-browserstack-sdk python <path-to-test-file>
+browserstack-sdk pytest -s tests/<example_test>.py
+\`\`\`
+
+Or run all tests in a directory:
+\`\`\`bash
+browserstack-sdk pytest <path-to-test-directory>
 \`\`\`
 `;
     return { setup, run };

package/dist/tools/sdk-utils/bstack/sdkHandler.js

@@ -45,11 +45,21 @@ export async function runBstackSDKOnly(input, config, isPercyAutomate = false) {
             content: sdkSetupCommand,
         });
     }
+    const frameworkInstructions = getInstructionsForProjectConfiguration(input.detectedBrowserAutomationFramework, input.detectedTestingFramework, input.detectedLanguage, username, accessKey);
+    if (frameworkInstructions) {
+        if (frameworkInstructions.setup) {
+            steps.push({
+                type: "instruction",
+                title: "Framework-Specific Setup",
+                content: frameworkInstructions.setup,
+            });
+        }
+    }
     const ymlInstructions = generateBrowserStackYMLInstructions({
         validatedEnvironments,
         enablePercy: false,
         projectName: input.projectName,
-    });
+    }, config);
     if (ymlInstructions) {
         steps.push({
             type: "instruction",
@@ -57,15 +67,7 @@ export async function runBstackSDKOnly(input, config, isPercyAutomate = false) {
             content: ymlInstructions,
         });
     }
-    const frameworkInstructions = getInstructionsForProjectConfiguration(input.detectedBrowserAutomationFramework, input.detectedTestingFramework, input.detectedLanguage, username, accessKey);
     if (frameworkInstructions) {
-        if (frameworkInstructions.setup) {
-            steps.push({
-                type: "instruction",
-                title: "Framework-Specific Setup",
-                content: frameworkInstructions.setup,
-            });
-        }
         if (frameworkInstructions.run && !isPercyAutomate) {
             steps.push({
                 type: "instruction",

package/dist/tools/sdk-utils/common/constants.d.ts

@@ -5,7 +5,7 @@ export declare const PERCY_SNAPSHOT_COMMANDS_DESCRIPTION = "Adds Percy snapshot
 export declare const RUN_ON_BROWSERSTACK_DESCRIPTION = "Set up and run automated web-based tests on BrowserStack using the BrowserStack SDK. Use this tool for functional or integration test setup on BrowserStack only. For any visual testing or Percy integration, use the dedicated Percy setup tool. Example prompts: run this test on browserstack; set up this project for browserstack.";
 export declare const SIMULATE_PERCY_CHANGE_DESCRIPTION = "Integrate Percy visual testing into new projects and demonstrate visual change detection through a step-by-step simulation. This tool handles initial Percy integration, setup, and creates a working demonstration for new users. Primary tool for prompts like: \"Integrate percy for this project\", \"Integrate percy in this project {project_name}\"";
 export declare const PERCY_REPLACE_REGEX: RegExp;
-export declare const PERCY_SNAPSHOT_INSTRUCTION = "\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n";
+export declare const PERCY_SNAPSHOT_INSTRUCTION = "\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n";
 export declare const PERCY_SIMULATE_INSTRUCTION = "\nMANDATORY: Aggressive, Accurate Percy Snapshots Integration\n\nPrerequisite: Before making any code changes in the user's repository, create and switch to a new branch named browserstack-simulation. Stage all changes but do not commit them. If the repository has not been initialized yet, run git init first.\n\nYou MUST follow these steps with NO EXCEPTIONS:\n1. Identify 4-5 key test files in the project that are critical for visual testing.\n2. For EACH identified test file, analyze the code to find EVERY location where a Percy snapshot should be called (e.g., after each navigation, UI change, or significant state in tests).\n3. Insert snapshot calls at ALL such points, not just the first or most obvious one.\n\nIteratively update every selected test file with percy snapshot calls at all identified points, ensuring comprehensive coverage of visual changes.";
 export declare const PERCY_SIMULATION_DRIVER_INSTRUCTION = "\nMANDATORY: Step-by-Step Percy Visual Change Simulation\nYou MUST follow these steps with NO EXCEPTIONS:\n\nSTEP 1: At this case we have added Percy snapshot commands to the test files at the appropriate locations (e.g., after navigation, UI change, or significant state). \n- Use ONLY existing snapshot names.\n- Do NOT add any popup injection or visual changes yet.\n- Do NOT run any Percy builds at this stage.\n\nSTEP 2: Run ONE comprehensive baseline Percy build that executes ALL tests containing Percy snapshots in a SINGLE build. This creates one baseline build with all snapshots for comparison. Use a command like: npx percy exec --label=mcp -- python -m pytest tests/ -k 'test_name1 or test_name2 or test_name3' -v to run multiple specific tests in one build.\"\n\nSTEP 3: Modify your test to inject a visible UI change (such as a popup) IMMEDIATELY BEFORE an EXISTING snapshot command (e.g., before percy_snapshot(self.driver, \"screenshot name\")).\n- Do NOT add a new snapshot name for the popup.\n- The popup must appear in an existing snapshot, not a new one.\n- Add this popup code in some test files before the percy_snapshot command you've added, to display the visual changes.\n\n```Javascript\npopup_script = `\nvar popup = document.createElement('div');\npopup.id = 'percy-test-popup';\npopup.style.cssText = popup.style.cssText = `\n  /* TODO: Add styles to make the popup large, centered, and visually noticeable.\n     Suggested properties: position: fixed; top/left; transform; background; color; font-size; padding; z-index; animation, etc. */\n`;\npopup.innerHTML = 'PERCY TEST<br>VISUAL CHANGE<br>DETECTED!';\ndocument.body.appendChild(popup);\n`;\n\n# Insert this just before the EXISTING snapshot command:\ndriver.execute_script(popup_script)\npercy_snapshot(self.driver, \"Before Adding to Cart\")  # (Do NOT change the snapshot name, keep existing one)\n```\n\nSTEP 4: Run a second Percy build with same label and same test command as the baseline.\n- The snapshot names must remain the same as in the baseline.\n- The visual change should now appear in the same snapshot as before.\n- Use the same build command you ran for the baseline.\n\nSTEP 5: Compare the two Percy builds to see the detected visual difference.\n\nSTEP 6: Now ask user if they want to expand percy for other testcases? If yes, call the \"expandPercyVisualTesting\" tool to enable complete coverage for the entire project.\n\nCONSTRAINTS:\n- Do NOT run any builds until explicitly instructed in the steps.\n- Do NOT add new snapshot names\u2014only use existing ones.\n- Do NOT add popup injection until the baseline is established.\n- Visual changes must appear in EXISTING snapshots, not new ones.\n\nVALIDATION CHECKPOINTS (before proceeding to the next step):\n- Are you adding only snapshot commands (not running builds)?\n- Are you reusing existing snapshot names (not creating new ones)?\n- Have you established the baseline first (before adding visual changes)\n\nCRITICAL: \nDo NOT run tests separately or create multiple builds during baseline establishment. The goal is to have exactly TWO builds total: (1) baseline build with all original snapshots, (2) modified build with the same tests but visual changes injected.\n";
 export declare const PERCY_VERIFICATION_REGEX: RegExp;

package/dist/tools/sdk-utils/common/constants.js

@@ -6,7 +6,7 @@ export const RUN_ON_BROWSERSTACK_DESCRIPTION = "Set up and run automated web-bas
 export const SIMULATE_PERCY_CHANGE_DESCRIPTION = `Integrate Percy visual testing into new projects and demonstrate visual change detection through a step-by-step simulation. This tool handles initial Percy integration, setup, and creates a working demonstration for new users. Primary tool for prompts like: "Integrate percy for this project", "Integrate percy in this project {project_name}"`;
 export const PERCY_REPLACE_REGEX = /Invoke listTestFiles\(\) with the provided directories[\s\S]*?- DO NOT STOP until you add commands in all the files or you reach end of the files\./;
 export const PERCY_SNAPSHOT_INSTRUCTION = `
-Invoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---
+Invoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---
 Process files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:
 - Start with index 0
 - Then index 1  

package/dist/tools/sdk-utils/common/device-validator.js

@@ -167,6 +167,13 @@ export async function validateDevices(devices, framework) {
         }
         validatedEnvironments.push(validatedEnv);
     }
+    if (framework === SDKSupportedBrowserAutomationFrameworkEnum.playwright) {
+        validatedEnvironments.forEach((env) => {
+            if (env.browser) {
+                env.browser = env.browser.toLowerCase();
+            }
+        });
+    }
     return validatedEnvironments;
 }
 // Optimized desktop validation using nested indexed maps for O(1) lookups

package/dist/tools/sdk-utils/common/schema.d.ts

@@ -19,7 +19,8 @@ export declare const SetUpPercyParamsShape: {
     detectedBrowserAutomationFramework: z.ZodNativeEnum<typeof SDKSupportedBrowserAutomationFrameworkEnum>;
     detectedTestingFramework: z.ZodNativeEnum<typeof SDKSupportedTestingFrameworkEnum>;
     integrationType: z.ZodNativeEnum<typeof PercyIntegrationTypeEnum>;
-    folderPaths: z.ZodArray<z.ZodString, "many">;
+    folderPaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    filePaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 };
 export declare const RunTestsOnBrowserStackParamsShape: {
     projectName: z.ZodString;
@@ -38,21 +39,24 @@ export declare const SetUpPercySchema: z.ZodObject<{
     detectedBrowserAutomationFramework: z.ZodNativeEnum<typeof SDKSupportedBrowserAutomationFrameworkEnum>;
     detectedTestingFramework: z.ZodNativeEnum<typeof SDKSupportedTestingFrameworkEnum>;
     integrationType: z.ZodNativeEnum<typeof PercyIntegrationTypeEnum>;
-    folderPaths: z.ZodArray<z.ZodString, "many">;
+    folderPaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    filePaths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strip", z.ZodTypeAny, {
     projectName: string;
     detectedLanguage: SDKSupportedLanguageEnum;
     detectedBrowserAutomationFramework: SDKSupportedBrowserAutomationFrameworkEnum;
     detectedTestingFramework: SDKSupportedTestingFrameworkEnum;
     integrationType: PercyIntegrationTypeEnum;
-    folderPaths: string[];
+    folderPaths?: string[] | undefined;
+    filePaths?: string[] | undefined;
 }, {
     projectName: string;
     detectedLanguage: SDKSupportedLanguageEnum;
     detectedBrowserAutomationFramework: SDKSupportedBrowserAutomationFrameworkEnum;
     detectedTestingFramework: SDKSupportedTestingFrameworkEnum;
     integrationType: PercyIntegrationTypeEnum;
-    folderPaths: string[];
+    folderPaths?: string[] | undefined;
+    filePaths?: string[] | undefined;
 }>;
 export declare const RunTestsOnBrowserStackSchema: z.ZodObject<{
     projectName: z.ZodString;

package/dist/tools/sdk-utils/common/schema.js

@@ -24,7 +24,12 @@ export const SetUpPercyParamsShape = {
         .describe("Specify the Percy integration type: web (Percy Web) or automate (Percy Automate). If not provided, always prompt the user with: 'Please specify the Percy integration type.' Do not proceed without an explicit selection. Never use a default."),
     folderPaths: z
         .array(z.string())
+        .optional()
         .describe("An array of absolute folder paths containing UI test files. If not provided, analyze codebase for UI test folders by scanning for test patterns which contain UI test cases as per framework. Return empty array if none found."),
+    filePaths: z
+        .array(z.string())
+        .optional()
+        .describe("An array of absolute file paths to specific UI test files. Use this when you want to target specific test files rather than entire folders. If not provided, will use folderPaths instead."),
 };
 export const RunTestsOnBrowserStackParamsShape = {
     projectName: z

package/dist/tools/sdk-utils/common/utils.d.ts

@@ -18,8 +18,8 @@ export declare function getPercyAutomateNotImplementedMessage(type: PercyAutomat
 export declare function getBootstrapFailedMessage(error: unknown, context: {
     config: unknown;
     percyMode?: string;
-    sdkVersion?: string;
 }): string;
 export declare function percyUnsupportedResult(integrationType: PercyIntegrationTypeEnum, supportCheck?: {
     errorMessage?: string;
 }): CallToolResult;
+export declare function validatePercyPathandFolders(input: any): void;

package/dist/tools/sdk-utils/common/utils.js

@@ -4,6 +4,7 @@ import { isPercyWebFrameworkSupported } from "../percy-web/frameworks.js";
 import { formatInstructionsWithNumbers, generateVerificationMessage, } from "./formatUtils.js";
 import { PercyAutomateNotImplementedType, } from "./types.js";
 import { IMPORTANT_SETUP_WARNING } from "./index.js";
+import { PackageJsonVersion } from "../../../index.js";
 export function checkPercyIntegrationSupport(input) {
     if (input.integrationType === PercyIntegrationTypeEnum.AUTOMATE) {
         const isSupported = isPercyAutomateFrameworkSupported(input.detectedLanguage, input.detectedBrowserAutomationFramework || "", input.detectedTestingFramework || "");
@@ -73,7 +74,7 @@ export function getBootstrapFailedMessage(error, context) {
     return `Failed to bootstrap project with BrowserStack SDK.
 Error: ${error_message}
 Percy Mode: ${context.percyMode ?? "automate"}
-SDK Version: ${context.sdkVersion ?? "N/A"}
+MCP Version: ${PackageJsonVersion}
 Please open an issue on GitHub if the problem persists.`;
 }
 export function percyUnsupportedResult(integrationType, supportCheck) {
@@ -89,3 +90,13 @@ export function percyUnsupportedResult(integrationType, supportCheck) {
         shouldSkipFormatting: true,
     };
 }
+export function validatePercyPathandFolders(input) {
+    const hasFolderPaths = input.folderPaths && input.folderPaths.length > 0;
+    const hasFilePaths = input.filePaths && input.filePaths.length > 0;
+    if (!hasFolderPaths && !hasFilePaths) {
+        throw new Error("Please provide either:\n" +
+            "• folderPaths: Array of directory paths containing test files\n" +
+            "• filePaths: Array of specific test file paths\n\n" +
+            "Example: { filePaths: ['/path/to/test.spec.js'] }");
+    }
+}

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

@@ -6,8 +6,9 @@ import { runPercyWeb } from "./percy-web/handler.js";
 import { runPercyAutomateOnly } from "./percy-automate/handler.js";
 import { runBstackSDKOnly } from "./bstack/sdkHandler.js";
 import { runPercyWithBrowserstackSDK } from "./percy-bstack/handler.js";
-import { checkPercyIntegrationSupport } from "./common/utils.js";
+import { checkPercyIntegrationSupport, validatePercyPathandFolders, } from "./common/utils.js";
 import { SetUpPercySchema, RunTestsOnBrowserStackSchema, } from "./common/schema.js";
+import { storedPercyResults } from "../../lib/inmemory-store.js";
 import { getBootstrapFailedMessage, percyUnsupportedResult, } from "./common/utils.js";
 import { PERCY_SIMULATE_INSTRUCTION, PERCY_REPLACE_REGEX, PERCY_SIMULATION_DRIVER_INSTRUCTION, PERCY_VERIFICATION_REGEX, } from "./common/constants.js";
 export async function runTestsOnBrowserStackHandler(rawInput, config) {
@@ -18,14 +19,30 @@ export async function runTestsOnBrowserStackHandler(rawInput, config) {
 export async function setUpPercyHandler(rawInput, config) {
     try {
         const input = SetUpPercySchema.parse(rawInput);
+        validatePercyPathandFolders(input);
+        // Clear any previous Percy results for a fresh start
+        storedPercyResults.clear();
+        storedPercyResults.set({
+            projectName: input.projectName,
+            detectedLanguage: input.detectedLanguage,
+            detectedBrowserAutomationFramework: input.detectedBrowserAutomationFramework,
+            detectedTestingFramework: input.detectedTestingFramework,
+            integrationType: input.integrationType,
+            folderPaths: input.folderPaths || [],
+            filePaths: input.filePaths || [],
+            testFiles: {},
+        });
         const authorization = getBrowserStackAuth(config);
+        const folderPaths = input.folderPaths || [];
+        const filePaths = input.filePaths || [];
         const percyInput = {
             projectName: input.projectName,
             detectedLanguage: input.detectedLanguage,
             detectedBrowserAutomationFramework: input.detectedBrowserAutomationFramework,
             detectedTestingFramework: input.detectedTestingFramework,
             integrationType: input.integrationType,
-            folderPaths: input.folderPaths || [],
+            folderPaths,
+            filePaths,
         };
         // Check for Percy Web integration support
         if (input.integrationType === PercyIntegrationTypeEnum.WEB) {

package/dist/tools/sdk-utils/percy-automate/constants.d.ts

@@ -1,11 +1,11 @@
 export declare const percyAutomateReviewSnapshotsStep = "\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n";
-export declare const pythonPytestSeleniumInstructions = "\nInstall Percy Automate dependencies\n  - Install Percy CLI:\n    npm install --save-dev @percy/cli\n  - Install Percy Python SDK for Automate:\n    pip install percy-selenium\n\n---STEP---\nUpdate your Pytest test script  \n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n  - Import the Percy snapshot helper:\n    from percy import percy_screenshot\n  - In your test, take snapshots at key points:\n    percy_screenshot(driver, \"Your snapshot name\")\n\nExample:\n```python\nimport pytest\nfrom selenium import webdriver\nfrom percy import percy_screenshot\n\n@pytest.fixture\ndef driver():\n    driver = webdriver.Chrome()\n    yield driver\n    driver.quit()\n\ndef test_homepage(driver):\n    driver.get(\"http://localhost:8000\")\n    percy_screenshot(driver, \"Home page\")\n    # ... more test steps ...\n    percy_screenshot(driver, \"After login\")\n```\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- browserstack-sdk pytest').\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
-export declare const pythonPytestPlaywrightInstructions = "\nInstall Percy Automate dependencies\n  - Install Percy CLI:\n    npm install --save @percy/cli\n  - Install Percy Playwright SDK for Automate:\n    pip install percy-playwright\n\n---STEP---\nUpdate your Playwright test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n  - Import the Percy screenshot helper:\n    from percy import percy_screenshot\n  - In your test, take snapshots at key points:\n    percy_screenshot(page, name=\"Your snapshot name\")\n    # You can pass `options`:\n    percy_screenshot(page, name=\"Your snapshot name\", options={ \"full_page\": True })\n\nExample:\n```python\nfrom playwright.sync_api import sync_playwright\nfrom percy import percy_screenshot\n\ndef test_visual_regression():\n    with sync_playwright() as p:\n        browser = p.chromium.launch()\n        page = browser.new_page()\n        page.goto(\"http://localhost:8000\")\n        percy_screenshot(page, name=\"Home page\")\n        # ... more test steps ...\n        percy_screenshot(page, name=\"After login\", options={ \"full_page\": True })\n        browser.close()\n```\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- <command to run the script file>').\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
-export declare const jsCypressPercyAutomateInstructions = "\nInstall Percy Automate dependencies\n  - Install Percy CLI:\n    npm install --save-dev @percy/cli\n  - Install Percy Cypress SDK:\n    npm install --save-dev @percy/cypress\n\n---STEP---\nUpdate your Cypress test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n  - Import and initialize Percy in your cypress/support/index.js:\n    import '@percy/cypress';\n  - In your test, take snapshots at key points:\n    cy.percySnapshot('Your snapshot name');\n\nExample:\n```javascript\ndescribe('Percy Automate Cypress Example', () => {\n  it('should take Percy snapshots', () => {\n    cy.visit('http://localhost:8000');\n    cy.percySnapshot('Home page');\n    // ... more test steps ...\n    cy.percySnapshot('After login');\n  });\n});\n```  \n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- cypress run').\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const pythonPytestSeleniumInstructions = "\nInstall Percy Automate dependencies\n  - Install Percy CLI:\n    npm install --save-dev @percy/cli\n  - Install Percy Python SDK for Automate:\n    pip install percy-selenium\n\n---STEP---\nUpdate your Pytest test script  \n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n  - Import the Percy snapshot helper:\n    from percy import percy_screenshot\n  - In your test, take snapshots at key points:\n    percy_screenshot(driver, \"Your snapshot name\")\n\nExample:\n```python\nimport pytest\nfrom selenium import webdriver\nfrom percy import percy_screenshot\n\n@pytest.fixture\ndef driver():\n    driver = webdriver.Chrome()\n    yield driver\n    driver.quit()\n\ndef test_homepage(driver):\n    driver.get(\"http://localhost:8000\")\n    percy_screenshot(driver, \"Home page\")\n    # ... more test steps ...\n    percy_screenshot(driver, \"After login\")\n```\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- browserstack-sdk pytest').\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const pythonPytestPlaywrightInstructions = "\nInstall Percy Automate dependencies\n  - Install Percy CLI:\n    npm install --save @percy/cli\n  - Install Percy Playwright SDK for Automate:\n    pip install percy-playwright\n\n---STEP---\nUpdate your Playwright test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n  - Import the Percy screenshot helper:\n    from percy import percy_screenshot\n  - In your test, take snapshots at key points:\n    percy_screenshot(page, name=\"Your snapshot name\")\n    # You can pass `options`:\n    percy_screenshot(page, name=\"Your snapshot name\", options={ \"full_page\": True })\n\nExample:\n```python\nfrom playwright.sync_api import sync_playwright\nfrom percy import percy_screenshot\n\ndef test_visual_regression():\n    with sync_playwright() as p:\n        browser = p.chromium.launch()\n        page = browser.new_page()\n        page.goto(\"http://localhost:8000\")\n        percy_screenshot(page, name=\"Home page\")\n        # ... more test steps ...\n        percy_screenshot(page, name=\"After login\", options={ \"full_page\": True })\n        browser.close()\n```\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- <command to run the script file>').\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const jsCypressPercyAutomateInstructions = "\nInstall Percy Automate dependencies\n  - Install Percy CLI:\n    npm install --save-dev @percy/cli\n  - Install Percy Cypress SDK:\n    npm install --save-dev @percy/cypress\n\n---STEP---\nUpdate your Cypress test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n  - Import and initialize Percy in your cypress/support/index.js:\n    import '@percy/cypress';\n  - In your test, take snapshots at key points:\n    cy.percySnapshot('Your snapshot name');\n\nExample:\n```javascript\ndescribe('Percy Automate Cypress Example', () => {\n  it('should take Percy snapshots', () => {\n    cy.visit('http://localhost:8000');\n    cy.percySnapshot('Home page');\n    // ... more test steps ...\n    cy.percySnapshot('After login');\n  });\n});\n```  \n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- cypress run').\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
 export declare const mochaPercyAutomateInstructions = "\nInstall Percy Automate dependencies\n  - Install Percy CLI:\n    npm install --save @percy/cli\n  - Install Percy Selenium SDK:\n    npm install @percy/selenium-webdriver@2.0.1\n\n---STEP---\nUpdate your Mocha Automate test script\n  - Import the Percy screenshot helper:\n    const { percyScreenshot } = require('@percy/selenium-webdriver');\n  - Use the Percy screenshot command to take required screenshots in your Automate session:\n    await percyScreenshot(driver, 'Screenshot 1');\n    options = { percyCSS: 'h1{color:red;}' };\n    await percyScreenshot(driver, 'Screenshot 2', options);\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- mocha').\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
 export declare const mochaPercyPlaywrightInstructions = "\nInstall Percy Automate dependencies\n  - Install the latest Percy CLI:\n    npm install --save @percy/cli\n  - Install the Percy Playwright SDK:\n    npm install @percy/playwright\n\n---STEP---\nUpdate your Mocha Playwright test script\n  - Import the Percy screenshot helper:\n    const { percyScreenshot } = require(\"@percy/playwright\");\n  - Use the Percy screenshot command to take required screenshots in your Automate session.\n\nExample:\n```javascript\nconst { percyScreenshot } = require(\"@percy/playwright\");\nawait percyScreenshot(page, \"Screenshot 1\");\n// With options\nawait percyScreenshot(page, \"Screenshot 2\", { percyCSS: \"h1{color:green;}\" });\n```\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- <command to run the tests>').\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
 export declare const jestPercyAutomateInstructions = "\nInstall or upgrade the BrowserStack SDK:\n  - Install the SDK:\n    npm i -D browserstack-node-sdk@latest\n  - Run the setup:\n    npx setup --username \"YOUR_USERNAME\" --key \"YOUR_ACCESS_KEY\"\n\n---STEP---\nManually capture screenshots:\n  1. Import the BrowserStack Percy SDK in your test script:\n     const { percy } = require('browserstack-node-sdk');\n  2. Use `percy.screenshot(driver, name)` at desired points in your test.\n\nExample:\n```javascript\nconst { percy } = require('browserstack-node-sdk');\ndescribe(\"JestJS test\", () => {\n  let driver;\n  const caps = require(\"../\" + conf_file).capabilities;\n\n  beforeAll(() => {\n    driver = new Builder()\n      .usingServer(\"http://example-servername/hub\")\n      .withCapabilities(caps)\n      .build();\n  });\n\n  test(\"my test\", async () => {\n    // ...\n    await percy.screenshot(driver, \"My Screenshot\");\n    // ...\n  });\n});\n```\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npm run [your-test-script-name]-browserstack').\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
 export declare const webdriverioPercyAutomateInstructions = "\nInstall or upgrade BrowserStack SDK\n  - Install the BrowserStack SDK:\n    npm i -D @wdio/browserstack-service\n\n---STEP---\nUpdate your WebdriverIO config file\n  1. Set `percy: true`\n  2. Set a `projectName`\n  3. Set `percyCaptureMode: auto` (or another mode as needed)\n\nExample WebdriverIO config:\n```js\nexports.config = {\n  user: process.env.BROWSERSTACK_USERNAME || 'YOUR_USERNAME',\n  key: process.env.BROWSERSTACK_ACCESS_KEY || 'YOUR_ACCESS_KEY',\n  hostname: 'hub.browserstack.com',\n  services: [\n    [\n      'browserstack',\n      { browserstackLocal: true, opts: { forcelocal: false }, percy: true, percyCaptureMode: 'auto' }\n    ],\n  ],\n  // add path to the test file\n}\n```\n\n---STEP---\n(Optional) Manually capture screenshots\n  1. Import the BrowserStack Percy SDK in your test script:\n    const { percy } = require('browserstack-node-sdk');\n  2. Add the `await percy.screenshot(driver, name)` method at required points in your test script.\n\nExample:\n```javascript\n    const { percy } = require('browserstack-node-sdk');\n  2. Add the `await percy.screenshot(driver, name)` method at required points in your test script.\n\nExample:\n```javascript\nconst { percy } = require('browserstack-node-sdk');\ndescribe(\"WebdriverIO Test\", () => {\n  it(\"my test\", async () => {\n    // ....\n    await percy.screenshot(driver, \"My Screenshot\")\n    // ....\n  });\n});\n```\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command as defined in your package.json file.\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
-export declare const testcafePercyAutomateInstructions = "\nInstall Percy dependencies\n  - Install the required dependencies:\n    npm install --save-dev @percy/cli @percy/testcafe\n\n---STEP---\nUpdate your test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n  - Import the Percy library and use the percySnapshot function to take screenshots.\n\nExample:\n```javascript\nimport percySnapshot from '@percy/testcafe';\nfixture('MyFixture')\n  .page('https://devexpress.github.io/testcafe/example/');\ntest('Test1', async t => {\n  await t.typeText('#developer-name', 'John Doe');\n  await percySnapshot(t, 'TestCafe Example');\n});\n```\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- testcafe chrome:headless tests').\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const testcafePercyAutomateInstructions = "\nInstall Percy dependencies\n  - Install the required dependencies:\n    npm install --save-dev @percy/cli @percy/testcafe\n\n---STEP---\nUpdate your test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n  - Import the Percy library and use the percySnapshot function to take screenshots.\n\nExample:\n```javascript\nimport percySnapshot from '@percy/testcafe';\nfixture('MyFixture')\n  .page('https://devexpress.github.io/testcafe/example/');\ntest('Test1', async t => {\n  await t.typeText('#developer-name', 'John Doe');\n  await percySnapshot(t, 'TestCafe Example');\n});\n```\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- testcafe chrome:headless tests').\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
 export declare const javaPlaywrightJunitInstructions = "\nInstall Percy Automate dependencies\n  - Install the latest Percy CLI:\n    npm install --save @percy/cli\n  - Add the Percy Playwright Java SDK to your pom.xml:\n```xml\n<dependency>\n  <groupId>io.percy</groupId>\n  <artifactId>percy-playwright-java</artifactId>\n  <version>1.0.0</version>\n</dependency>\n```\n\n---STEP---\nUpdate your Automate test script\n  - Import the Percy library:\n    import io.percy.playwright.Percy;\n  - Use the Percy screenshot command to take required screenshots in your Automate session.\n\nExample:\n```java\nPercy percy = new Percy(page);\npercy.screenshot(\"screenshot_1\");\n// With options\npercy.screenshot(\"screenshot_2\", options);\n```\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- <command to run the automate script file>').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
 export declare const csharpPlaywrightNunitInstructions = "\nInstall Percy Automate dependencies\n  - Install the latest Percy CLI:\n    npm install --save @percy/cli\n  - Add the Percy Playwright SDK to your .csproj file:\n```xml\n<PackageReference Include=\"PercyIO.Playwright\" Version=\"1.0.0\" />\n```\n\n---STEP---\nUpdate your NUnit Playwright test script\n  - Import the Percy library:\n    using PercyIO.Playwright;\n  - Use the Percy screenshot command to take required screenshots in your Automate session.\n\nExample:\n```csharp\nusing PercyIO.Playwright;\nPercy.Screenshot(page, \"example_screenshot_1\");\n// With options\nPercy.Screenshot(page, \"example_screenshot_2\", options);\n```\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- <command to run the automate script file>').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";

package/dist/tools/sdk-utils/percy-bstack/constants.d.ts

@@ -1,4 +1,4 @@
-export declare const javaSeleniumInstructions = "\nImport the BrowserStack Percy SDK in your test script:\nAdd the Percy import to your test file.\n\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\nAdd screenshot capture method at required points:\nUse the `PercySDK.screenshot(driver, name)` method at points in your test script where you want to capture screenshots.\n\nHere's an example:\n\n```java\n// ...imports\nimport com.browserstack.PercySDK;\n\npublic class YourTestClass extends YourBaseTest {\n    @Test\n    public void test() throws Exception {\n         // your test logic\n         // ...\n         \n         // Capture a Percy screenshot\n         PercySDK.screenshot(driver, \"My Screenshot Name\");\n         \n         // ...\n         // more test logic\n    }\n}\n```\n";
-export declare const nodejsSeleniumInstructions = "\nImport the BrowserStack Percy SDK in your test script:\nAdd the Percy import to your test file.\n\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n---STEP---\n\nAdd screenshot capture method at required points:\nUse the `percy.snapshot(driver, name)` method at points in your test script where you want to capture screenshots.\n\n```javascript\nconst { percy } = require('browserstack-node-sdk');\ndescribe(\"sample Test\", () => {\n  // ... other imports and setup\n  \n  test(\"my test\", async () => {\n    // ....\n    await percy.screenshot(driver, \"My Snapshot\")\n    // ....\n  });\n})\n```\n";
-export declare const webdriverioPercyInstructions = "\nEnable Percy in `wdio.conf.js`:\nIn your WebdriverIO configuration file, modify the 'browserstack' service options to enable Percy.\n\n- Set `percy: true`.\n- Set a `projectName`. This is required and will be used for both your Automate and Percy projects.\n- Set `percyCaptureMode`. The default `manual` as we are adding screenshot commands manually.\n\nHere's how to modify the service configuration:\n```javascript\n// in wdio.conf.js\n\nexports.config = {\n  // ... other configs\n  services: [\n    [\n      'browserstack',\n      { \n        // ... other service options\n        percy: true,\n        percyCaptureMode: 'manual' // or 'auto', etc.\n      },\n    ],\n  ],\n\n  commonCapabilities: {\n    'bstack:options': {\n      projectName: \"My Percy Project\", // This is required for Percy\n      // ... other common capabilities\n    }\n  },\n  // ... rest of your config\n};\n```\n\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n---STEP---\n\nManually Capturing Screenshots (Optional):\nIf you set `percyCaptureMode: 'manual'` or want to take extra screenshots in `auto` mode, you need to add screenshot commands to your tests.\n\nFirst, install `browserstack-node-sdk`:\n```bash\nnpm install browserstack-node-sdk\n```\n\nThen, in your test script, import `percy` and use it to take a snapshot:\n```javascript\n// your_test_file.js\nconst { percy } = require('browserstack-node-sdk');\n\ndescribe(\"My WebdriverIO Test\", () => {\n  it(\"should take a percy snapshot\", async () => {\n    // ... your test logic (e.g., browser.url('https://example.com'))\n    \n    // Capture a Percy screenshot\n    await percy.screenshot(driver, \"My Snapshot Name\");\n    \n    // ... more test logic\n  });\n});\n```\n";
-export declare const csharpSeleniumInstructions = "\nImport the BrowserStack Percy SDK in your test script:\nAdd the Percy import to your test file.\n\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\nAdd screenshot capture method at required points:\nUse the `PercySDK.Screenshot(driver, name)` method at points in your test script where you want to capture screenshots.\n\nHere's an example:\n\n```csharp\nusing BrowserStackSDK.Percy;\nnamespace Tests;\n\npublic class MyTest\n{\n    [Test]\n    public void SampleTest()\n    {\n        // your test logic\n        // ...\n        \n        // Capture a Percy screenshot\n        PercySDK.Screenshot(driver, \"Screenshot name\");\n        \n        // ...\n        // more test logic\n    }\n}\n```\n";
+export declare const javaSeleniumInstructions = "\nImport the BrowserStack Percy SDK in your test script:\nAdd the Percy import to your test file.\n\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\nAdd screenshot capture method at required points:\nUse the `PercySDK.screenshot(driver, name)` method at points in your test script where you want to capture screenshots.\n\nHere's an example:\n\n```java\n// ...imports\nimport com.browserstack.PercySDK;\n\npublic class YourTestClass extends YourBaseTest {\n    @Test\n    public void test() throws Exception {\n         // your test logic\n         // ...\n         \n         // Capture a Percy screenshot\n         PercySDK.screenshot(driver, \"My Screenshot Name\");\n         \n         // ...\n         // more test logic\n    }\n}\n```\n";
+export declare const nodejsSeleniumInstructions = "\nImport the BrowserStack Percy SDK in your test script:\nAdd the Percy import to your test file.\n\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n---STEP---\n\nAdd screenshot capture method at required points:\nUse the `percy.snapshot(driver, name)` method at points in your test script where you want to capture screenshots.\n\n```javascript\nconst { percy } = require('browserstack-node-sdk');\ndescribe(\"sample Test\", () => {\n  // ... other imports and setup\n  \n  test(\"my test\", async () => {\n    // ....\n    await percy.screenshot(driver, \"My Snapshot\")\n    // ....\n  });\n})\n```\n";
+export declare const webdriverioPercyInstructions = "\nEnable Percy in `wdio.conf.js`:\nIn your WebdriverIO configuration file, modify the 'browserstack' service options to enable Percy.\n\n- Set `percy: true`.\n- Set a `projectName`. This is required and will be used for both your Automate and Percy projects.\n- Set `percyCaptureMode`. The default `manual` as we are adding screenshot commands manually.\n\nHere's how to modify the service configuration:\n```javascript\n// in wdio.conf.js\n\nexports.config = {\n  // ... other configs\n  services: [\n    [\n      'browserstack',\n      { \n        // ... other service options\n        percy: true,\n        percyCaptureMode: 'manual' // or 'auto', etc.\n      },\n    ],\n  ],\n\n  commonCapabilities: {\n    'bstack:options': {\n      projectName: \"My Percy Project\", // This is required for Percy\n      // ... other common capabilities\n    }\n  },\n  // ... rest of your config\n};\n```\n\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n---STEP---\n\nManually Capturing Screenshots (Optional):\nIf you set `percyCaptureMode: 'manual'` or want to take extra screenshots in `auto` mode, you need to add screenshot commands to your tests.\n\nFirst, install `browserstack-node-sdk`:\n```bash\nnpm install browserstack-node-sdk\n```\n\nThen, in your test script, import `percy` and use it to take a snapshot:\n```javascript\n// your_test_file.js\nconst { percy } = require('browserstack-node-sdk');\n\ndescribe(\"My WebdriverIO Test\", () => {\n  it(\"should take a percy snapshot\", async () => {\n    // ... your test logic (e.g., browser.url('https://example.com'))\n    \n    // Capture a Percy screenshot\n    await percy.screenshot(driver, \"My Snapshot Name\");\n    \n    // ... more test logic\n  });\n});\n```\n";
+export declare const csharpSeleniumInstructions = "\nImport the BrowserStack Percy SDK in your test script:\nAdd the Percy import to your test file.\n\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\nAdd screenshot capture method at required points:\nUse the `PercySDK.Screenshot(driver, name)` method at points in your test script where you want to capture screenshots.\n\nHere's an example:\n\n```csharp\nusing BrowserStackSDK.Percy;\nnamespace Tests;\n\npublic class MyTest\n{\n    [Test]\n    public void SampleTest()\n    {\n        // your test logic\n        // ...\n        \n        // Capture a Percy screenshot\n        PercySDK.Screenshot(driver, \"Screenshot name\");\n        \n        // ...\n        // more test logic\n    }\n}\n```\n";

package/dist/tools/sdk-utils/percy-bstack/handler.js

@@ -67,7 +67,7 @@ export function runPercyWithBrowserstackSDK(input, config) {
         platforms: input.devices?.map((t) => t.join(" ")) || [],
         enablePercy: true,
         projectName: input.projectName,
-    });
+    }, config);
     if (ymlInstructions) {
         steps.push({
             type: "instruction",

package/dist/tools/sdk-utils/percy-web/constants.d.ts

@@ -19,23 +19,25 @@ export declare const nodejsGatsbyInstructionsSnapshot = "\n  - Add the Percy plu
 export declare const nodejsStorybookInstructionsSnapshot = "\n  - Add Percy parameters to your stories to customize snapshots:\n```js\nMyStory.parameters = {\n  percy: {\n    name: 'My snapshot',\n    additionalSnapshots: [\n      { prefix: '[Dark mode] ', args: { colorScheme: 'dark' } },\n      { suffix: ' with globals', globals: { textDirection: 'rtl' } },\n      { name: 'Search snapshot', queryParams: { search: 'foobar' } }\n    ]\n  }\n};\n```\n  - Use argument names and values defined in your codebase.\n";
 export declare const pythonPlaywrightInstructionsSnapshot = "\n  - Import the Percy snapshot helper and use the snapshot method:\n    percy_snapshot(page, name=\"Your snapshot name\")\n  - You can also use:\n    percy_screenshot(page, name=\"Your snapshot name\", options={})\n\nExample:\n```python\nfrom playwright.sync_api import sync_playwright\nfrom percy import percy_snapshot\n\nwith sync_playwright() as p:\n    browser = p.chromium.launch()\n    page = browser.new_page()\n    page.goto(\"http://localhost:8000\")\n    percy_snapshot(page, name=\"Home page\")\n\n    # ... more test steps ...\n    percy_snapshot(page, name=\"After login\")\n\n    browser.close()\n```\n";
 export declare const csharpPlaywrightInstructionsSnapshot = "\n  - Import the Percy snapshot helper and use the snapshot method:\n    Percy.Snapshot(page, \"Your snapshot name\");\n  - You can also pass options:\n    Percy.Snapshot(page, \"Your snapshot name\", options);\n\nExample:\n```csharp\nusing Microsoft.Playwright;\nusing PercyIO.Playwright;\n\nclass PercyPlaywrightExample\n{\n    public static async Task Main()\n    {\n        using var playwright = await Playwright.CreateAsync();\n        var browser = await playwright.Chromium.LaunchAsync();\n        var page = await browser.NewPageAsync();\n\n        await page.GotoAsync(\"http://localhost:8000\");\n        Percy.Snapshot(page, \"Home page\");\n\n        // ... more test steps ...\n        Percy.Snapshot(page, \"After login\");\n\n        await browser.CloseAsync();\n    }\n}\n```\n";
-export declare const pythonInstructions = "\nInstall Percy dependencies\n  - Install Percy CLI:\n    npm install --save-dev @percy/cli\n  - Install Percy Selenium Python package:\n    pip install percy-selenium\nIf faced any issue create a virtual environment and proceed.\nUpdate your Python Selenium script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\nExample:\n```python\n- Import the Percy snapshot helper:\nfrom selenium import webdriver\nfrom percy import percy_snapshot\n\ndriver = webdriver.Chrome()\ndriver.get('http://localhost:8000')\npercy_snapshot(driver, 'Home page')\n# ... more test steps ...\npercy_snapshot(driver, 'After login')\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- python tests.py').\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
-export declare const nodejsInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI:\n    npm install --save-dev @percy/cli\n  - Install Percy SDK for Node.js:\n    npm install @percy/selenium-webdriver\n---STEP---\nUpdate your Node.js Selenium script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n- Import the Percy snapshot helper:\n    const { percySnapshot } = require('@percy/selenium-js');\n  - In your test, take snapshots like this:\n    await percySnapshot(driver, \"Your snapshot name\");\n\nExample:\n```javascript\nconst { Builder } = require('selenium-webdriver');\nconst percySnapshot = require('@percy/selenium-webdriver');\n\nconst driver = await new Builder().forBrowser('chrome').build();\nawait driver.get('http://localhost:8000');\nawait percySnapshot(driver, 'Home page');\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- node script.js').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
-export declare const javaInstructions = "\n---STEP---\nAdd Percy dependencies to your project\n  - For Maven, add to your pom.xml:\n    <dependency>\n      <groupId>io.percy</groupId>\n      <artifactId>percy-java-selenium</artifactId>\n      <version>1.0.0</version>\n    </dependency>\n  - For Gradle, add to your build.gradle:\n    implementation 'io.percy:percy-java-selenium:1.0.0'\n  - For CLI usage, install Percy CLI:\n    npm install --save-dev @percy/cli\n\n---STEP---\nUpdate your Java Selenium test\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    import io.percy.selenium.Percy;\n  - In your test, take snapshots like this:\n    Percy percy = new Percy(driver);\n    percy.snapshot(\"Your snapshot name\");\n  Example:\n```java\nimport org.openqa.selenium.WebDriver;\nimport org.openqa.selenium.chrome.ChromeDriver;\nimport io.percy.selenium.Percy;\n\npublic class PercyExample {\n  public static void main(String[] args) {\n    WebDriver driver = new ChromeDriver();\n    driver.get(\"http://localhost:8000\");\n    Percy percy = new Percy(driver);\n    percy.snapshot(\"Home page\");\n    driver.quit();\n  }\n}\n```\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- mvn test').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
-export declare const rubyInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI:\n    npm install --save-dev @percy/cli\n  - Install Percy Ruby Selenium gem:\n    gem install percy-selenium\n\n---STEP---\nUpdate your Ruby Selenium test\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Require the Percy snapshot helper:\n    require 'percy'\n  - In your test, take snapshots like this:\n    Percy.snapshot(page, 'Your snapshot name')\n\nExample:\n```ruby\nrequire 'selenium-webdriver'\nrequire 'percy'\n\ndriver = Selenium::WebDriver.for :chrome\ndriver.get('http://localhost:8000')\nPercy.snapshot(driver, 'Your snapshot name')\ndriver.quit\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- bundle exec rspec').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
-export declare const rubyCapybaraInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI:\n    npm install --save-dev @percy/cli\n  - Install Percy Capybara gem:\n    gem install percy-capybara\n\n---STEP---\nUpdate your Capybara or Rails test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - In your test setup file, require percy/capybara:\n    require 'percy/capybara'\n  - In your test, take snapshots like this:\n    page.percy_snapshot('Capybara snapshot')\n\nExample:\n```ruby\nrequire 'percy/capybara'\n\ndescribe 'my feature', type: :feature do\n  it 'renders the page' do\n    visit 'https://example.com'\n    page.percy_snapshot('Capybara snapshot')\n  end\nend\n```\n\n  - The snapshot method arguments are:\n    page.percy_snapshot(name[, options])\n    name - The snapshot name; must be unique to each snapshot; defaults to the test title\n    options - See per-snapshot configuration options\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- bundle exec rspec').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
-export declare const csharpInstructions = "\nInstall Percy CLI by running the following command:\nnpm install --save-dev @percy/cli\n\n---STEP---\nAdd Percy dependencies to your project\n  - Add the Percy .NET Selenium NuGet package:\n    dotnet add package PercyIO.Selenium\n\n---STEP---\nUpdate your C# Selenium test\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    using PercyIO.Selenium;\n  - In your test, take snapshots like this:\n    Percy.Snapshot(driver,\"Your snapshot name\");\n\nExample:\n```csharp\nusing OpenQA.Selenium;\nusing OpenQA.Selenium.Chrome;\nusing PercyIO.Selenium;\n\nclass PercyExample\n{\n    static void Main()\n    {\n        IWebDriver driver = new ChromeDriver();\n        driver.Navigate().GoToUrl(\"http://localhost:8000\");\n        Percy.Snapshot(driver,\"Empty Todo State\");\n        driver.Quit();\n    }\n}\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- dotnet test').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
-export declare const javaPlaywrightInstructions = "\nInstall Percy dependencies\n  - For Maven, add to your pom.xml:\n    <dependency>\n      <groupId>io.percy</groupId>\n      <artifactId>percy-playwright-java</artifactId>\n      <version>1.0.0</version>\n    </dependency>\n\n---STEP---\nUpdate your Java Playwright test\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy library and use the snapshot method:\n    percy.snapshot(\"snapshot_1\");\n  - You can also pass options:\n    Map<String, Object> options = new HashMap<>();\n    options.put(\"testCase\", \"Should add product to cart\");\n    percy.snapshot(\"snapshot_2\", options);\n\nExample:\n```java\nimport com.microsoft.playwright.*;\nimport io.percy.playwright.*;\n\npublic class PercyPlaywrightExample {\n  public static void main(String[] args) {\n    try (Playwright playwright = Playwright.create()) {\n      Browser browser = playwright.chromium().launch();\n      Page page = browser.newPage();\n      Percy percy = new Percy(page);\n\n      page.navigate(\"http://localhost:8000\");\n      percy.snapshot(\"Home page\");\n\n      // ... more test steps ...\n      percy.snapshot(\"After login\");\n\n      browser.close();\n    }\n  }\n}\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g. npx percy exec -- <command to run the test script file>).\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
-export declare const nodejsPlaywrightInstructions = "\nInstall Percy dependencies\n  - Install Percy Playwright SDK:\n    npm install @percy/playwright\n\n---STEP---\nUpdate your Playwright JavaScript test\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    const percySnapshot = require('@percy/playwright');\n  - In your test, take snapshots like this:\n    await percySnapshot(page, \"Your snapshot name\");\n\nExample:\n```javascript\nconst { chromium } = require('playwright');\nconst percySnapshot = require('@percy/playwright');\n\n(async () => {\n  const browser = await chromium.launch();\n  const page = await browser.newPage();\n  await page.goto('http://example.com/', { waitUntil: 'networkidle' });\n  await percySnapshot(page, 'Example Site');\n  await browser.close();\n})();\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., npx percy exec -- <command to run the test script file>).\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
-export declare const nodejsWebdriverioInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI:\n    npm install --save-dev @percy/cli\n  - Install Percy Selenium Webdriver package:\n    npm install --save-dev @percy/selenium-webdriver\n\n---STEP---\nUpdate your WebdriverIO test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    const percySnapshot = require('@percy/selenium-webdriver');\n  - In your test, take snapshots like this:\n    await percySnapshot(driver, \"Your snapshot name\");\n\nExample:\n```javascript\nconst { remote } = require('webdriverio');\nconst percySnapshot = require('@percy/selenium-webdriver');\n\n(async () => {\n  const browser = await remote({\n    logLevel: 'error',\n    capabilities: { browserName: 'chrome' }\n  });\n\n  await browser.url('https://example.com');\n  await percySnapshot(browser, 'WebdriverIO example');\n  await browser.deleteSession();\n})();\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- wdio run wdio.conf.js').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
-export declare const nodejsEmberInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and Ember SDK:\n    npm install --save-dev @percy/cli @percy/ember\n\n---STEP---\nUpdate your Ember test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    import percySnapshot from '@percy/ember';\n  - In your test, take snapshots like this:\n    await percySnapshot('My Snapshot');\n\nExample:\n```javascript\nimport percySnapshot from '@percy/ember';\ndescribe('My ppp', () => {\n  // ...app setup\n  it('about page should look good', async () => {\n    await visit('/about');\n    await percySnapshot('My Snapshot');\n  });\n});\n```\n\n  - The snapshot method arguments are:\n    percySnapshot(name[, options])\n    name - The snapshot name; must be unique to each snapshot; defaults to the test title\n    options - See per-snapshot configuration options\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- ember test').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
-export declare const nodejsCypressInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and Cypress SDK:\n    npm install --save-dev @percy/cli @percy/cypress\n\n---STEP---\nUpdate your Cypress test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper in your cypress/support/e2e.js file:\n    import '@percy/cypress';\n  - If you\u2019re using TypeScript, include \"types\": [\"cypress\", \"@percy/cypress\"] in your tsconfig.json file.\n  - In your test, take snapshots like this:\n    cy.percySnapshot();\n\nExample:\n```javascript\nimport '@percy/cypress';\n\ndescribe('Integration test with visual testing', function() {\n  it('Loads the homepage', function() {\n    // Load the page or perform any other interactions with the app.\n    cy.visit('<URL under test>');\n    // Take a snapshot for visual diffing\n    cy.percySnapshot();\n  });\n});\n```\n\n  - The snapshot method arguments are:\n    cy.percySnapshot([name][, options])\n    name - The snapshot name; must be unique to each snapshot; defaults to the test title\n    options - See per-snapshot configuration options\n\n  - For example:\n    cy.percySnapshot();\n    cy.percySnapshot('Homepage test');\n    cy.percySnapshot('Homepage responsive test', { widths: [768, 992, 1200] });\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- cypress run').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
-export declare const nodejsPuppeteerInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and Puppeteer SDK:\n    npm install --save-dev @percy/cli @percy/puppeteer\n\n---STEP---\nUpdate your Puppeteer test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    const percySnapshot = require('@percy/puppeteer');\n  - In your test, take snapshots like this:\n    await percySnapshot(page, 'Snapshot name');\n\nExample:\n```javascript\nconst puppeteer = require('puppeteer');\nconst percySnapshot = require('@percy/puppeteer');\n\ndescribe('Integration test with visual testing', function() {\n  it('Loads the homepage', async function() {\n    const browser = await puppeteer.launch();\n    const page = await browser.newPage();\n    await page.goto('https://example.com');\n    await percySnapshot(page, this.test.fullTitle());\n    await browser.close();\n  });\n});\n```\n\n  - The snapshot method arguments are:\n    percySnapshot(page, name[, options])\n    page (required) - A puppeteer page instance\n    name (required) - The snapshot name; must be unique to each snapshot\n    options - See per-snapshot configuration options\n\n  - For example:\n    percySnapshot(page, 'Homepage test');\n    percySnapshot(page, 'Homepage responsive test', { widths: [768, 992, 1200] });\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- <command to run the test script file>').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
-export declare const nodejsNightmareInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and Nightmare SDK:\n    npm install --save-dev @percy/cli @percy/nightmare\n\n---STEP---\nUpdate your Nightmare test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    const Nightmare = require('nightmare');\n    const percySnapshot = require('@percy/nightmare');\n  - In your test, take snapshots like this:\n    .use(percySnapshot('Snapshot name'))\n\nExample:\n```javascript\nconst Nightmare = require('nightmare');\nconst percySnapshot = require('@percy/nightmare');\n\nNightmare()\n  .goto('http://example.com')\n  // ... other actions ...\n  .use(percySnapshot('Example Snapshot'))\n  // ... more actions ...\n  .end()\n  .then(() => {\n    // ...\n  });\n```\n\n  - The snapshot method arguments are:\n    percySnapshot(name[, options])\n    name (required) - The snapshot name; must be unique to each snapshot\n    options - See per-snapshot configuration options\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- node script.js').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
-export declare const nodejsNightwatchInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and Nightwatch SDK:\n    npm install --save-dev @percy/cli @percy/nightwatch\n\n---STEP---\nUpdate your Nightwatch configuration and test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy library and add the path exported by @percy/nightwatch to your Nightwatch configuration\u2019s custom_commands_path property:\n    const percy = require('@percy/nightwatch');\n    module.exports = {\n      // ...\n      custom_commands_path: [percy.path],\n      // ...\n    };\n  - In your test, take snapshots like this:\n    browser.percySnapshot('Snapshot name');\n\nExample:\n```javascript\nconst percy = require('@percy/nightwatch');\nmodule.exports = {\n  // ...\n  custom_commands_path: [percy.path],\n  // ...\n};\n\n// Example test\nmodule.exports = {\n  'Snapshots pages': function(browser) {\n    browser\n      .url('http://example.com')\n      .assert.containsText('h1', 'Example Domain')\n      .percySnapshot('Example snapshot');\n    browser\n      .url('http://google.com')\n      .assert.elementPresent('img[alt=\"Google\"]')\n      .percySnapshot('Google homepage');\n    browser.end();\n  }\n};\n```\n\n  - The snapshot method arguments are:\n    percySnapshot([name][, options])\n    name (required) - The snapshot name; must be unique to each snapshot\n    options - See per-snapshot configuration options\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- nightwatch').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
-export declare const nodejsProtractorInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and Protractor SDK:\n    npm install --save-dev @percy/cli @percy/protractor\n\n---STEP---\nUpdate your Protractor test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    import percySnapshot from '@percy/protractor';\n  - In your test, take snapshots like this:\n    await percySnapshot('Snapshot name');\n    // or\n    await percySnapshot(browser, 'Snapshot name');\n\nExample:\n```javascript\nimport percySnapshot from '@percy/protractor';\ndescribe('angularjs homepage', function() {\n  it('should greet the named user', async function() {\n    await browser.get('https://www.angularjs.org');\n    await percySnapshot('AngularJS homepage');\n    await element(by.model('yourName')).sendKeys('Percy');\n    var greeting = element(by.binding('yourName'));\n    expect(await greeting.getText()).toEqual('Hello Percy!');\n    await percySnapshot('AngularJS homepage greeting');\n  });\n});\n```\n\n  - The snapshot method arguments are:\n    percySnapshot(name[, options])\n    Standalone mode:\n    percySnapshot(browser, name[, options])\n    browser (required) - The Protractor browser object\n    name (required) - The snapshot name; must be unique to each snapshot\n    options - See per-snapshot configuration options\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- protractor conf.js').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
-export declare const nodejsTestcafeInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and TestCafe SDK:\n    npm install --save-dev @percy/cli @percy/testcafe\n\n---STEP---\nUpdate your TestCafe test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    import percySnapshot from '@percy/testcafe';\n  - In your test, take snapshots like this:\n    await percySnapshot(t, 'Snapshot name');\n\nExample:\n```javascript\nimport percySnapshot from '@percy/testcafe';\nfixture('MyFixture')\n  .page('https://devexpress.github.io/testcafe/example');\ntest('Test1', async t => {\n  await t.typeText('#developer-name', 'John Doe');\n  await percySnapshot(t, 'TestCafe Example');\n});\n```\n\n  - The snapshot method arguments are:\n    percySnapshot(t, name[, options])\n    t (required) - The test controller instance passed from test\n    name (required) - The snapshot name; must be unique to each snapshot\n    options - See per-snapshot configuration options\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- testcafe chrome:headless tests').\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
-export declare const nodejsGatsbyInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and Gatsby plugin:\n    npm install --save @percy/cli gatsby-plugin-percy\n\n---STEP---\nUpdate your Gatsby configuration\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Add the Percy plugin to your gatsby-config.js file:\n    module.exports = {\n      plugins: [`gatsby-plugin-percy`]\n    }\n\n  - The plugin will take snapshots of discovered pages during the build process.\n\n  - Example gatsby-config.js with options:\n```javascript\nmodule.exports = {\n  plugins: [{\n    resolve: `gatsby-plugin-percy`,\n    options: {\n      // gatsby specific options\n      query: `{\n        allSitePage { nodes { path } }\n        allOtherPage { nodes { path } }\n      }`,\n      resolvePages: ({\n        allSitePage: { nodes: allPages },\n        allOtherPage: { nodes: otherPages }\n      }) => {\n        return [...allPages, ...otherPages]\n          .map(({ path }) => path);\n      },\n      // percy static snapshot options\n      exclude: [\n        '/dev-404-page/',\n        '/offline-plugin-app-shell-fallback/'\n      ],\n      overrides: [{\n        include: '/foobar/',\n        waitForSelector: '.done-loading',\n        additionalSnapshots: [{\n          suffix: ' - after btn click',\n          execute: () => document.querySelector('.btn').click()\n        }]\n      }]\n    }\n  }]\n}\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- gatsby build').\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
-export declare const nodejsStorybookInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and Storybook SDK:\n    npm install --save-dev @percy/cli @percy/storybook\n\n---STEP---\nUpdate your Storybook stories\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Add Percy parameters to your stories to customize snapshots:\n```js\nMyStory.parameters = {\n  percy: {\n    name: 'My snapshot',\n    additionalSnapshots: [\n      { prefix: '[Dark mode] ', args: { colorScheme: 'dark' } },\n      { suffix: ' with globals', globals: { textDirection: 'rtl' } },\n      { name: 'Search snapshot', queryParams: { search: 'foobar' } }\n    ]\n  }\n};\n```\n  - Use argument names and values defined in your codebase.\n\n\n---STEP---\nRun Percy with your Storybook\n  - With a static Storybook build:\n    percy storybook ./storybook-build\n  - With a local or live Storybook URL:\n    percy storybook http://localhost:9009\n    percy storybook https://storybook.foobar.com\n  - Automatically run start-storybook:\n    Run this scan using tool runPercyScan with 'npx percy exec -- percy storybook:start --port=9009'.\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
-export declare const pythonPlaywrightInstructions = "\n---STEP---\nCreate a Percy project\n  - Sign in to Percy and create a project of type \"Web\". Name the project and note the generated token.\n\n---STEP---\nSet the project token as an environment variable\n  - On macOS/Linux:\n    export PERCY_TOKEN=\"<your token here>\"\n  - On Windows PowerShell:\n    $env:PERCY_TOKEN=\"<your token here>\"\n  - On Windows CMD:\n    set PERCY_TOKEN=<your token here>\n\n---STEP---\nInstall Percy dependencies\n  - Install Percy Playwright SDK:\n    pip install percy-playwright\n\n---STEP---\nUpdate your Playwright Python test\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper and use the snapshot method:\n    percy_snapshot(page, name=\"Your snapshot name\")\n  - You can also use:\n    percy_screenshot(page, name=\"Your snapshot name\", options={})\n\nExample:\n```python\nfrom playwright.sync_api import sync_playwright\nfrom percy import percy_snapshot\n\nwith sync_playwright() as p:\n    browser = p.chromium.launch()\n    page = browser.new_page()\n    page.goto(\"http://localhost:8000\")\n    percy_snapshot(page, name=\"Home page\")\n\n    # ... more test steps ...\n    percy_snapshot(page, name=\"After login\")\n\n    browser.close()\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g. npx percy exec -- <command to run the test script file>).\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
-export declare const csharpPlaywrightInstructions = "\nInstall Percy dependencies\n  - Add the Percy Playwright NuGet package:\n    <PackageReference Include=\"PercyIO.Playwright\" Version=\"1.0.0\" />\n\n---STEP---\nUpdate your Playwright .NET test\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory and obtain the generated UUID ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper and use the snapshot method:\n    Percy.Snapshot(page, \"Your snapshot name\");\n  - You can also pass options:\n    Percy.Snapshot(page, \"Your snapshot name\", options);\n\nExample:\n```csharp\nusing Microsoft.Playwright;\nusing PercyIO.Playwright;\n\nclass PercyPlaywrightExample\n{\n    public static async Task Main()\n    {\n        using var playwright = await Playwright.CreateAsync();\n        var browser = await playwright.Chromium.LaunchAsync();\n        var page = await browser.NewPageAsync();\n\n        await page.GotoAsync(\"http://localhost:8000\");\n        Percy.Snapshot(page, \"Home page\");\n\n        // ... more test steps ...\n        Percy.Snapshot(page, \"After login\");\n\n        await browser.CloseAsync();\n    }\n}\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g. npx percy exec -- <command to run the test script file>).\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const pythonInstructions = "\nInstall Percy dependencies\n  - Install Percy CLI:\n    npm install --save-dev @percy/cli\n  - Install Percy Selenium Python package:\n    pip install percy-selenium\nIf faced any issue create a virtual environment and proceed.\nUpdate your Python Selenium script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\nExample:\n```python\n- Import the Percy snapshot helper:\nfrom selenium import webdriver\nfrom percy import percy_snapshot\n\ndriver = webdriver.Chrome()\ndriver.get('http://localhost:8000')\npercy_snapshot(driver, 'Home page')\n# ... more test steps ...\npercy_snapshot(driver, 'After login')\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- python tests.py').\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const nodejsInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI:\n    npm install --save-dev @percy/cli\n  - Install Percy SDK for Node.js:\n    npm install @percy/selenium-webdriver\n---STEP---\nUpdate your Node.js Selenium script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n- Import the Percy snapshot helper:\n    const { percySnapshot } = require('@percy/selenium-js');\n  - In your test, take snapshots like this:\n    await percySnapshot(driver, \"Your snapshot name\");\n\nExample:\n```javascript\nconst { Builder } = require('selenium-webdriver');\nconst percySnapshot = require('@percy/selenium-webdriver');\n\nconst driver = await new Builder().forBrowser('chrome').build();\nawait driver.get('http://localhost:8000');\nawait percySnapshot(driver, 'Home page');\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- node script.js').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const javaInstructions = "\n---STEP---\nAdd Percy dependencies to your project\n  - For Maven, add to your pom.xml:\n    <dependency>\n      <groupId>io.percy</groupId>\n      <artifactId>percy-java-selenium</artifactId>\n      <version>1.0.0</version>\n    </dependency>\n  - For Gradle, add to your build.gradle:\n    implementation 'io.percy:percy-java-selenium:1.0.0'\n  - For CLI usage, install Percy CLI:\n    npm install --save-dev @percy/cli\n\n---STEP---\nUpdate your Java Selenium test\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    import io.percy.selenium.Percy;\n  - In your test, take snapshots like this:\n    Percy percy = new Percy(driver);\n    percy.snapshot(\"Your snapshot name\");\n  Example:\n```java\nimport org.openqa.selenium.WebDriver;\nimport org.openqa.selenium.chrome.ChromeDriver;\nimport io.percy.selenium.Percy;\n\npublic class PercyExample {\n  public static void main(String[] args) {\n    WebDriver driver = new ChromeDriver();\n    driver.get(\"http://localhost:8000\");\n    Percy percy = new Percy(driver);\n    percy.snapshot(\"Home page\");\n    driver.quit();\n  }\n}\n```\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- mvn test').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const rubyInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI:\n    npm install --save-dev @percy/cli\n  - Install Percy Ruby Selenium gem:\n    gem install percy-selenium\n\n---STEP---\nUpdate your Ruby Selenium test\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Require the Percy snapshot helper:\n    require 'percy'\n  - In your test, take snapshots like this:\n    Percy.snapshot(page, 'Your snapshot name')\n\nExample:\n```ruby\nrequire 'selenium-webdriver'\nrequire 'percy'\n\ndriver = Selenium::WebDriver.for :chrome\ndriver.get('http://localhost:8000')\nPercy.snapshot(driver, 'Your snapshot name')\ndriver.quit\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- bundle exec rspec').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const rubyCapybaraInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI:\n    npm install --save-dev @percy/cli\n  - Install Percy Capybara gem:\n    gem install percy-capybara\n\n---STEP---\nUpdate your Capybara or Rails test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - In your test setup file, require percy/capybara:\n    require 'percy/capybara'\n  - In your test, take snapshots like this:\n    page.percy_snapshot('Capybara snapshot')\n\nExample:\n```ruby\nrequire 'percy/capybara'\n\ndescribe 'my feature', type: :feature do\n  it 'renders the page' do\n    visit 'https://example.com'\n    page.percy_snapshot('Capybara snapshot')\n  end\nend\n```\n\n  - The snapshot method arguments are:\n    page.percy_snapshot(name[, options])\n    name - The snapshot name; must be unique to each snapshot; defaults to the test title\n    options - See per-snapshot configuration options\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- bundle exec rspec').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const csharpInstructions = "\nInstall Percy CLI by running the following command:\nnpm install --save-dev @percy/cli\n\n---STEP---\nAdd Percy dependencies to your project\n  - Add the Percy .NET Selenium NuGet package:\n    dotnet add package PercyIO.Selenium\n\n---STEP---\nUpdate your C# Selenium test\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    using PercyIO.Selenium;\n  - In your test, take snapshots like this:\n    Percy.Snapshot(driver,\"Your snapshot name\");\n\nExample:\n```csharp\nusing OpenQA.Selenium;\nusing OpenQA.Selenium.Chrome;\nusing PercyIO.Selenium;\n\nclass PercyExample\n{\n    static void Main()\n    {\n        IWebDriver driver = new ChromeDriver();\n        driver.Navigate().GoToUrl(\"http://localhost:8000\");\n        Percy.Snapshot(driver,\"Empty Todo State\");\n        driver.Quit();\n    }\n}\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- dotnet test').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const javaPlaywrightInstructions = "\nInstall Percy dependencies\n  - For Maven, add to your pom.xml:\n    <dependency>\n      <groupId>io.percy</groupId>\n      <artifactId>percy-playwright-java</artifactId>\n      <version>1.0.0</version>\n    </dependency>\n\n---STEP---\nUpdate your Java Playwright test\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy library and use the snapshot method:\n    percy.snapshot(\"snapshot_1\");\n  - You can also pass options:\n    Map<String, Object> options = new HashMap<>();\n    options.put(\"testCase\", \"Should add product to cart\");\n    percy.snapshot(\"snapshot_2\", options);\n\nExample:\n```java\nimport com.microsoft.playwright.*;\nimport io.percy.playwright.*;\n\npublic class PercyPlaywrightExample {\n  public static void main(String[] args) {\n    try (Playwright playwright = Playwright.create()) {\n      Browser browser = playwright.chromium().launch();\n      Page page = browser.newPage();\n      Percy percy = new Percy(page);\n\n      page.navigate(\"http://localhost:8000\");\n      percy.snapshot(\"Home page\");\n\n      // ... more test steps ...\n      percy.snapshot(\"After login\");\n\n      browser.close();\n    }\n  }\n}\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g. npx percy exec -- <command to run the test script file>).\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const nodejsPlaywrightInstructions = "\nInstall Percy dependencies\n  - Install Percy Playwright SDK:\n    npm install @percy/playwright\n\n---STEP---\nUpdate your Playwright JavaScript test\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    const percySnapshot = require('@percy/playwright');\n  - In your test, take snapshots like this:\n    await percySnapshot(page, \"Your snapshot name\");\n\nExample:\n```javascript\nconst { chromium } = require('playwright');\nconst percySnapshot = require('@percy/playwright');\n\n(async () => {\n  const browser = await chromium.launch();\n  const page = await browser.newPage();\n  await page.goto('http://example.com/', { waitUntil: 'networkidle' });\n  await percySnapshot(page, 'Example Site');\n  await browser.close();\n})();\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., npx percy exec -- <command to run the test script file>).\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const nodejsWebdriverioInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI:\n    npm install --save-dev @percy/cli\n  - Install Percy Selenium Webdriver package:\n    npm install --save-dev @percy/selenium-webdriver\n\n---STEP---\nUpdate your WebdriverIO test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    const percySnapshot = require('@percy/selenium-webdriver');\n  - In your test, take snapshots like this:\n    await percySnapshot(driver, \"Your snapshot name\");\n\nExample:\n```javascript\nconst { remote } = require('webdriverio');\nconst percySnapshot = require('@percy/selenium-webdriver');\n\n(async () => {\n  const browser = await remote({\n    logLevel: 'error',\n    capabilities: { browserName: 'chrome' }\n  });\n\n  await browser.url('https://example.com');\n  await percySnapshot(browser, 'WebdriverIO example');\n  await browser.deleteSession();\n})();\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- wdio run wdio.conf.js').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const nodejsEmberInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and Ember SDK:\n    npm install --save-dev @percy/cli @percy/ember\n\n---STEP---\nUpdate your Ember test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    import percySnapshot from '@percy/ember';\n  - In your test, take snapshots like this:\n    await percySnapshot('My Snapshot');\n\nExample:\n```javascript\nimport percySnapshot from '@percy/ember';\ndescribe('My ppp', () => {\n  // ...app setup\n  it('about page should look good', async () => {\n    await visit('/about');\n    await percySnapshot('My Snapshot');\n  });\n});\n```\n\n  - The snapshot method arguments are:\n    percySnapshot(name[, options])\n    name - The snapshot name; must be unique to each snapshot; defaults to the test title\n    options - See per-snapshot configuration options\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- ember test').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const nodejsCypressInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and Cypress SDK:\n    npm install --save-dev @percy/cli @percy/cypress\n\n---STEP---\nUpdate your Cypress test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper in your cypress/support/e2e.js file:\n    import '@percy/cypress';\n  - If you\u2019re using TypeScript, include \"types\": [\"cypress\", \"@percy/cypress\"] in your tsconfig.json file.\n  - In your test, take snapshots like this:\n    cy.percySnapshot();\n\nExample:\n```javascript\nimport '@percy/cypress';\n\ndescribe('Integration test with visual testing', function() {\n  it('Loads the homepage', function() {\n    // Load the page or perform any other interactions with the app.\n    cy.visit('<URL under test>');\n    // Take a snapshot for visual diffing\n    cy.percySnapshot();\n  });\n});\n```\n\n  - The snapshot method arguments are:\n    cy.percySnapshot([name][, options])\n    name - The snapshot name; must be unique to each snapshot; defaults to the test title\n    options - See per-snapshot configuration options\n\n  - For example:\n    cy.percySnapshot();\n    cy.percySnapshot('Homepage test');\n    cy.percySnapshot('Homepage responsive test', { widths: [768, 992, 1200] });\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- cypress run').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const nodejsPuppeteerInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and Puppeteer SDK:\n    npm install --save-dev @percy/cli @percy/puppeteer\n\n---STEP---\nUpdate your Puppeteer test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    const percySnapshot = require('@percy/puppeteer');\n  - In your test, take snapshots like this:\n    await percySnapshot(page, 'Snapshot name');\n\nExample:\n```javascript\nconst puppeteer = require('puppeteer');\nconst percySnapshot = require('@percy/puppeteer');\n\ndescribe('Integration test with visual testing', function() {\n  it('Loads the homepage', async function() {\n    const browser = await puppeteer.launch();\n    const page = await browser.newPage();\n    await page.goto('https://example.com');\n    await percySnapshot(page, this.test.fullTitle());\n    await browser.close();\n  });\n});\n```\n\n  - The snapshot method arguments are:\n    percySnapshot(page, name[, options])\n    page (required) - A puppeteer page instance\n    name (required) - The snapshot name; must be unique to each snapshot\n    options - See per-snapshot configuration options\n\n  - For example:\n    percySnapshot(page, 'Homepage test');\n    percySnapshot(page, 'Homepage responsive test', { widths: [768, 992, 1200] });\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- <command to run the test script file>').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const nodejsNightmareInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and Nightmare SDK:\n    npm install --save-dev @percy/cli @percy/nightmare\n\n---STEP---\nUpdate your Nightmare test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    const Nightmare = require('nightmare');\n    const percySnapshot = require('@percy/nightmare');\n  - In your test, take snapshots like this:\n    .use(percySnapshot('Snapshot name'))\n\nExample:\n```javascript\nconst Nightmare = require('nightmare');\nconst percySnapshot = require('@percy/nightmare');\n\nNightmare()\n  .goto('http://example.com')\n  // ... other actions ...\n  .use(percySnapshot('Example Snapshot'))\n  // ... more actions ...\n  .end()\n  .then(() => {\n    // ...\n  });\n```\n\n  - The snapshot method arguments are:\n    percySnapshot(name[, options])\n    name (required) - The snapshot name; must be unique to each snapshot\n    options - See per-snapshot configuration options\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- node script.js').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const nodejsNightwatchInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and Nightwatch SDK:\n    npm install --save-dev @percy/cli @percy/nightwatch\n\n---STEP---\nUpdate your Nightwatch configuration and test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy library and add the path exported by @percy/nightwatch to your Nightwatch configuration\u2019s custom_commands_path property:\n    const percy = require('@percy/nightwatch');\n    module.exports = {\n      // ...\n      custom_commands_path: [percy.path],\n      // ...\n    };\n  - In your test, take snapshots like this:\n    browser.percySnapshot('Snapshot name');\n\nExample:\n```javascript\nconst percy = require('@percy/nightwatch');\nmodule.exports = {\n  // ...\n  custom_commands_path: [percy.path],\n  // ...\n};\n\n// Example test\nmodule.exports = {\n  'Snapshots pages': function(browser) {\n    browser\n      .url('http://example.com')\n      .assert.containsText('h1', 'Example Domain')\n      .percySnapshot('Example snapshot');\n    browser\n      .url('http://google.com')\n      .assert.elementPresent('img[alt=\"Google\"]')\n      .percySnapshot('Google homepage');\n    browser.end();\n  }\n};\n```\n\n  - The snapshot method arguments are:\n    percySnapshot([name][, options])\n    name (required) - The snapshot name; must be unique to each snapshot\n    options - See per-snapshot configuration options\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- nightwatch').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const nodejsProtractorInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and Protractor SDK:\n    npm install --save-dev @percy/cli @percy/protractor\n\n---STEP---\nUpdate your Protractor test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    import percySnapshot from '@percy/protractor';\n  - In your test, take snapshots like this:\n    await percySnapshot('Snapshot name');\n    // or\n    await percySnapshot(browser, 'Snapshot name');\n\nExample:\n```javascript\nimport percySnapshot from '@percy/protractor';\ndescribe('angularjs homepage', function() {\n  it('should greet the named user', async function() {\n    await browser.get('https://www.angularjs.org');\n    await percySnapshot('AngularJS homepage');\n    await element(by.model('yourName')).sendKeys('Percy');\n    var greeting = element(by.binding('yourName'));\n    expect(await greeting.getText()).toEqual('Hello Percy!');\n    await percySnapshot('AngularJS homepage greeting');\n  });\n});\n```\n\n  - The snapshot method arguments are:\n    percySnapshot(name[, options])\n    Standalone mode:\n    percySnapshot(browser, name[, options])\n    browser (required) - The Protractor browser object\n    name (required) - The snapshot name; must be unique to each snapshot\n    options - See per-snapshot configuration options\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- protractor conf.js').\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const nodejsTestcafeInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and TestCafe SDK:\n    npm install --save-dev @percy/cli @percy/testcafe\n\n---STEP---\nUpdate your TestCafe test script\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper:\n    import percySnapshot from '@percy/testcafe';\n  - In your test, take snapshots like this:\n    await percySnapshot(t, 'Snapshot name');\n\nExample:\n```javascript\nimport percySnapshot from '@percy/testcafe';\nfixture('MyFixture')\n  .page('https://devexpress.github.io/testcafe/example');\ntest('Test1', async t => {\n  await t.typeText('#developer-name', 'John Doe');\n  await percySnapshot(t, 'TestCafe Example');\n});\n```\n\n  - The snapshot method arguments are:\n    percySnapshot(t, name[, options])\n    t (required) - The test controller instance passed from test\n    name (required) - The snapshot name; must be unique to each snapshot\n    options - See per-snapshot configuration options\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- testcafe chrome:headless tests').\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const nodejsGatsbyInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and Gatsby plugin:\n    npm install --save @percy/cli gatsby-plugin-percy\n\n---STEP---\nUpdate your Gatsby configuration\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Add the Percy plugin to your gatsby-config.js file:\n    module.exports = {\n      plugins: [`gatsby-plugin-percy`]\n    }\n\n  - The plugin will take snapshots of discovered pages during the build process.\n\n  - Example gatsby-config.js with options:\n```javascript\nmodule.exports = {\n  plugins: [{\n    resolve: `gatsby-plugin-percy`,\n    options: {\n      // gatsby specific options\n      query: `{\n        allSitePage { nodes { path } }\n        allOtherPage { nodes { path } }\n      }`,\n      resolvePages: ({\n        allSitePage: { nodes: allPages },\n        allOtherPage: { nodes: otherPages }\n      }) => {\n        return [...allPages, ...otherPages]\n          .map(({ path }) => path);\n      },\n      // percy static snapshot options\n      exclude: [\n        '/dev-404-page/',\n        '/offline-plugin-app-shell-fallback/'\n      ],\n      overrides: [{\n        include: '/foobar/',\n        waitForSelector: '.done-loading',\n        additionalSnapshots: [{\n          suffix: ' - after btn click',\n          execute: () => document.querySelector('.btn').click()\n        }]\n      }]\n    }\n  }]\n}\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g., 'npx percy exec -- gatsby build').\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const nodejsStorybookInstructions = "\n---STEP---\nInstall Percy dependencies\n  - Install Percy CLI and Storybook SDK:\n    npm install --save-dev @percy/cli @percy/storybook\n\n---STEP---\nUpdate your Storybook stories\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Add Percy parameters to your stories to customize snapshots:\n```js\nMyStory.parameters = {\n  percy: {\n    name: 'My snapshot',\n    additionalSnapshots: [\n      { prefix: '[Dark mode] ', args: { colorScheme: 'dark' } },\n      { suffix: ' with globals', globals: { textDirection: 'rtl' } },\n      { name: 'Search snapshot', queryParams: { search: 'foobar' } }\n    ]\n  }\n};\n```\n  - Use argument names and values defined in your codebase.\n\n\n---STEP---\nRun Percy with your Storybook\n  - With a static Storybook build:\n    percy storybook ./storybook-build\n  - With a local or live Storybook URL:\n    percy storybook http://localhost:9009\n    percy storybook https://storybook.foobar.com\n  - Automatically run start-storybook:\n    Run this scan using tool runPercyScan with 'npx percy exec -- percy storybook:start --port=9009'.\n\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const pythonPlaywrightInstructions = "\n---STEP---\nCreate a Percy project\n  - Sign in to Percy and create a project of type \"Web\". Name the project and note the generated token.\n\n---STEP---\nSet the project token as an environment variable\n  - On macOS/Linux:\n    export PERCY_TOKEN=\"<your token here>\"\n  - On Windows PowerShell:\n    $env:PERCY_TOKEN=\"<your token here>\"\n  - On Windows CMD:\n    set PERCY_TOKEN=<your token here>\n\n---STEP---\nInstall Percy dependencies\n  - Install Percy Playwright SDK:\n    pip install percy-playwright\n\n---STEP---\nUpdate your Playwright Python test\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper and use the snapshot method:\n    percy_snapshot(page, name=\"Your snapshot name\")\n  - You can also use:\n    percy_screenshot(page, name=\"Your snapshot name\", options={})\n\nExample:\n```python\nfrom playwright.sync_api import sync_playwright\nfrom percy import percy_snapshot\n\nwith sync_playwright() as p:\n    browser = p.chromium.launch()\n    page = browser.new_page()\n    page.goto(\"http://localhost:8000\")\n    percy_snapshot(page, name=\"Home page\")\n\n    # ... more test steps ...\n    percy_snapshot(page, name=\"After login\")\n\n    browser.close()\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g. npx percy exec -- <command to run the test script file>).\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare const csharpPlaywrightInstructions = "\nInstall Percy dependencies\n  - Add the Percy Playwright NuGet package:\n    <PackageReference Include=\"PercyIO.Playwright\" Version=\"1.0.0\" />\n\n---STEP---\nUpdate your Playwright .NET test\n\nInvoke listTestFiles() with the provided directories from user to gather all test files in memory ---STEP---\nProcess files in STRICT sequential order using tool addPercySnapshotCommands() with below instructions:\n- Start with index 0\n- Then index 1  \n- Then index 2\n- Continue sequentially until the last index\n- DO NOT skip any index numbers\n- DO NOT jump to random indices like 10, 20, 30\n- DO NOT worry about time consuming and any constraints.\n- DO NOT STOP until you add commands in all the files or you reach end of the files.\n\n\n  - Import the Percy snapshot helper and use the snapshot method:\n    Percy.Snapshot(page, \"Your snapshot name\");\n  - You can also pass options:\n    Percy.Snapshot(page, \"Your snapshot name\", options);\n\nExample:\n```csharp\nusing Microsoft.Playwright;\nusing PercyIO.Playwright;\n\nclass PercyPlaywrightExample\n{\n    public static async Task Main()\n    {\n        using var playwright = await Playwright.CreateAsync();\n        var browser = await playwright.Chromium.LaunchAsync();\n        var page = await browser.NewPageAsync();\n\n        await page.GotoAsync(\"http://localhost:8000\");\n        Percy.Snapshot(page, \"Home page\");\n\n        // ... more test steps ...\n        Percy.Snapshot(page, \"After login\");\n\n        await browser.CloseAsync();\n    }\n}\n```\n\n\n---STEP---\nTo run the Percy build, call the tool runPercyScan with the appropriate test command (e.g. npx percy exec -- <command to run the test script file>).\n\n---STEP---\nReview the snapshots\n  - Go to your Percy project on https://percy.io to review snapshots and approve/reject any visual changes.\n\n";
+export declare function getFrameworkTestCommand(language: string, framework: string): string;
+export declare const PERCY_FALLBACK_STEPS: string[];

package/dist/tools/sdk-utils/percy-web/constants.js

@@ -881,3 +881,42 @@ ${csharpPlaywrightInstructionsSnapshot}
 To run the Percy build, call the tool runPercyScan with the appropriate test command (e.g. npx percy exec -- <command to run the test script file>).
 ${percyReviewSnapshotsStep}
 `;
+export function getFrameworkTestCommand(language, framework) {
+    const percyPrefix = "npx percy exec --labels=mcp --";
+    const nodeCommands = {
+        cypress: "cypress run",
+        playwright: "playwright test",
+        webdriverio: "wdio",
+        puppeteer: "node",
+        testcafe: "testcafe",
+        nightwatch: "nightwatch",
+        protractor: "protractor",
+        gatsby: "gatsby build",
+        storybook: "storybook build",
+        ember: "ember test",
+        default: "npm test",
+    };
+    const languageMap = {
+        python: "python -m pytest",
+        java: "mvn test",
+        ruby: "bundle exec rspec",
+        csharp: "dotnet test",
+    };
+    if (language === "nodejs") {
+        const cmd = nodeCommands[framework] ?? nodeCommands.default;
+        return `${percyPrefix} ${cmd}`;
+    }
+    const cmd = languageMap[language];
+    return cmd ? `${percyPrefix} ${cmd}` : `${percyPrefix} <test-runner>`;
+}
+export const PERCY_FALLBACK_STEPS = [
+    `Attempt to infer the project's test command from context (high confidence commands first):
+- Node.js: npm test, cypress run, npx playwright test, npx wdio, npx testcafe, npx nightwatch, npx protractor, ember test, npx gatsby build, npx storybook build
+- Python: python -m pytest
+- Java: mvn test
+- Ruby: bundle exec rspec
+- C#: dotnet test
+or from package.json scripts`,
+    `Wrap the inferred command with Percy along with label: \nnpx percy exec --labels=mcp -- <test command>`,
+    `If the test command cannot be inferred confidently, ask the user directly for the correct test command.`,
+];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@browserstack/mcp-server",
-  "version": "1.2.5",
+  "version": "1.2.6",
   "description": "BrowserStack's Official MCP Server",
   "mcpName": "io.github.browserstack/mcp-server",
   "main": "dist/index.js",