@browserstack/mcp-server 1.2.15-beta.2 → 1.2.16-beta.1

package/dist/tools/percy-mcp/v2/create-build.js

@@ -1,601 +0,0 @@
-import { percyTokenPost, getOrCreateProjectToken, } from "../../../lib/percy-api/percy-auth.js";
-import { setActiveProject, setActiveBuild, } from "../../../lib/percy-api/percy-session.js";
-import { execFile, spawn } from "child_process";
-import { promisify } from "util";
-import { writeFile, readdir, readFile, stat, unlink, mkdtemp, } from "fs/promises";
-import { join, basename, extname } from "path";
-import { tmpdir } from "os";
-import { createHash } from "crypto";
-const execFileAsync = promisify(execFile);
-async function getGitBranch() {
-    try {
-        return ((await execFileAsync("git", ["branch", "--show-current"])).stdout.trim() || "main");
-    }
-    catch {
-        return "main";
-    }
-}
-async function getGitSha() {
-    try {
-        return (await execFileAsync("git", ["rev-parse", "HEAD"])).stdout.trim();
-    }
-    catch {
-        return createHash("sha1").update(Date.now().toString()).digest("hex");
-    }
-}
-async function isPercyCliInstalled() {
-    try {
-        await execFileAsync("npx", ["@percy/cli", "--version"]);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-// ── Main handler ────────────────────────────────────────────────────────────
-export async function percyCreateBuildV2(args, config) {
-    const branch = args.branch || (await getGitBranch());
-    const commitSha = await getGitSha();
-    const widths = args.widths
-        ? args.widths.split(",").map((w) => w.trim())
-        : ["375", "1280"];
-    // Get project token and activate in session
-    let token;
-    try {
-        token = await getOrCreateProjectToken(args.project_name, config, args.type);
-        setActiveProject({ name: args.project_name, token, type: args.type });
-    }
-    catch (e) {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Failed to access project "${args.project_name}": ${e.message}`,
-                },
-            ],
-            isError: true,
-        };
-    }
-    // Parse custom snapshot names and test cases
-    const customNames = args.snapshot_names
-        ? args.snapshot_names.split(",").map((n) => n.trim())
-        : [];
-    // test_case can be single (applies to all) or comma-separated (maps 1:1)
-    const testCases = args.test_case
-        ? args.test_case.split(",").map((t) => t.trim())
-        : [];
-    // Detect mode
-    if (args.urls) {
-        return handleUrlSnapshot(args.project_name, token, args.urls, widths, branch, customNames, testCases);
-    }
-    else if (args.test_command) {
-        return handleTestCommand(args.project_name, token, args.test_command, branch);
-    }
-    else if (args.screenshots_dir || args.screenshot_files) {
-        return handleScreenshotUpload(token, args, branch, commitSha, customNames, testCases);
-    }
-    else {
-        let output = `## Percy Build — ${args.project_name}\n\n`;
-        output += `**Token:** ready (${token.slice(0, 8)}...)\n`;
-        output += `**Branch:** ${branch}\n\n`;
-        output += `Provide one of:\n`;
-        output += `- \`urls\` — URLs to snapshot\n`;
-        output += `- \`test_command\` — test command to wrap\n`;
-        output += `- \`screenshots_dir\` — folder with PNG/JPG files\n`;
-        output += `- \`screenshot_files\` — comma-separated file paths\n`;
-        return { content: [{ type: "text", text: output }] };
-    }
-}
-// ── URL Snapshot ────────────────────────────────────────────────────────────
-async function handleUrlSnapshot(projectName, token, urls, widths, branch, customNames, testCases) {
-    const urlList = urls
-        .split(",")
-        .map((u) => u.trim())
-        .filter(Boolean);
-    const cliInstalled = await isPercyCliInstalled();
-    if (!cliInstalled) {
-        let output = `## Percy CLI Not Installed\n\n`;
-        output += `Install it first:\n\`\`\`bash\nnpm install -g @percy/cli\n\`\`\`\n\n`;
-        output += `Then re-run this command.\n`;
-        return { content: [{ type: "text", text: output }] };
-    }
-    // Build snapshots.yml with names, test cases, and widths
-    // Percy CLI YAML supports: name, url, testCase, widths, waitForTimeout
-    let yamlContent = "";
-    urlList.forEach((url, i) => {
-        const name = customNames[i] ||
-            (urlList.length === 1
-                ? "Homepage"
-                : url
-                    .replace(/^https?:\/\/[^/]+/, "")
-                    .replace(/^\//, "")
-                    .replace(/[/:?&=]/g, "-")
-                    .replace(/-+/g, "-")
-                    .replace(/^-|-$/g, "") || `Page ${i + 1}`);
-        const tc = testCases.length === 1 ? testCases[0] : testCases[i];
-        yamlContent += `- name: "${name}"\n`;
-        yamlContent += `  url: ${url}\n`;
-        yamlContent += `  waitForTimeout: 3000\n`;
-        if (tc) {
-            yamlContent += `  testCase: "${tc}"\n`;
-        }
-        if (widths.length > 0) {
-            yamlContent += `  widths:\n`;
-            widths.forEach((w) => {
-                yamlContent += `    - ${w}\n`;
-            });
-        }
-    });
-    // Write config to temp file
-    const tmpDir = await mkdtemp(join(tmpdir(), "percy-mcp-"));
-    const configPath = join(tmpDir, "snapshots.yml");
-    await writeFile(configPath, yamlContent);
-    // Launch Percy CLI — EXECUTE AUTOMATICALLY
-    const child = spawn("npx", ["@percy/cli", "snapshot", configPath], {
-        env: { ...process.env, PERCY_TOKEN: token },
-        stdio: ["ignore", "pipe", "pipe"],
-        detached: true,
-    });
-    let buildUrl = "";
-    let stdoutData = "";
-    let stderrData = "";
-    child.stdout?.on("data", (d) => {
-        const text = d.toString();
-        stdoutData += text;
-        const match = text.match(/https:\/\/percy\.io\/[^\s]+\/builds\/\d+/);
-        if (match)
-            buildUrl = match[0];
-    });
-    child.stderr?.on("data", (d) => {
-        stderrData += d.toString();
-    });
-    // Wait for build URL or timeout
-    await new Promise((resolve) => {
-        const timeout = setTimeout(resolve, 15000);
-        child.on("close", () => {
-            clearTimeout(timeout);
-            resolve();
-        });
-        const check = setInterval(() => {
-            if (buildUrl) {
-                clearTimeout(timeout);
-                clearInterval(check);
-                resolve();
-            }
-        }, 500);
-    });
-    child.unref();
-    // Cleanup temp file later
-    setTimeout(async () => {
-        try {
-            await unlink(configPath);
-        }
-        catch {
-            /* ignore */
-        }
-    }, 120000);
-    // Extract build ID from URL (format: .../builds/12345)
-    const buildIdMatch = buildUrl.match(/\/builds\/(\d+)/);
-    const buildId = buildIdMatch ? buildIdMatch[1] : "";
-    // Store in session
-    if (buildId || buildUrl) {
-        setActiveBuild({ id: buildId, url: buildUrl, branch });
-    }
-    // Build response
-    let output = `## Percy Build — ${projectName}\n\n`;
-    // Always show build info table
-    output += `| Field | Value |\n|---|---|\n`;
-    output += `| **Project** | ${projectName} |\n`;
-    if (buildId)
-        output += `| **Build ID** | ${buildId} |\n`;
-    output += `| **Branch** | ${branch} |\n`;
-    output += `| **URLs** | ${urlList.length} |\n`;
-    output += `| **Widths** | ${widths.join(", ")}px |\n`;
-    output += `| **Expected Snapshots** | ${urlList.length * widths.length} |\n`;
-    if (buildUrl)
-        output += `| **Build URL** | ${buildUrl} |\n`;
-    output += `| **Token** | \`${token.slice(0, 8)}...${token.slice(-4)}\` |\n`;
-    output += "\n";
-    if (testCases.length > 0) {
-        output += `**Test cases:** ${testCases.join(", ")}\n\n`;
-    }
-    // Show snapshot details
-    output += `**Snapshots:**\n`;
-    urlList.forEach((url, i) => {
-        const name = customNames[i] || (urlList.length === 1 ? "Homepage" : `Page ${i + 1}`);
-        const tc = testCases.length === 1 ? testCases[0] : testCases[i];
-        output += `- **${name}**`;
-        if (tc)
-            output += ` (test: ${tc})`;
-        output += ` → ${url}\n`;
-    });
-    output += "\n";
-    if (buildUrl) {
-        output += `**Build started!** Percy is rendering in the background.\n`;
-        output += `Results ready in 1-3 minutes.\n`;
-    }
-    else {
-        const allOutput = (stdoutData + stderrData).trim();
-        if (allOutput.includes("ECONNREFUSED") || allOutput.includes("not found")) {
-            output += `**Error:** URL not reachable. Make sure your app is running.\n\n`;
-            urlList.forEach((u) => {
-                output += `- ${u}\n`;
-            });
-        }
-        else if (allOutput) {
-            output += `**Percy output:**\n\`\`\`\n${allOutput.slice(0, 500)}\n\`\`\`\n`;
-        }
-        else {
-            output += `Percy launched in background. Check your Percy dashboard for results.\n`;
-        }
-    }
-    // Next steps
-    output += `\n### Next Steps\n\n`;
-    if (buildId) {
-        output += `- \`percy_get_build\` with build_id "${buildId}" — View build details\n`;
-        output += `- \`percy_get_build\` with build_id "${buildId}" and detail "snapshots" — List snapshots\n`;
-        output += `- \`percy_get_build\` with build_id "${buildId}" and detail "ai_summary" — AI analysis\n`;
-    }
-    else {
-        output += `- \`percy_get_builds\` — Find the build ID once processing completes\n`;
-    }
-    return { content: [{ type: "text", text: output }] };
-}
-// ── REMOVED: handleUrlWithTestCases — test cases now handled in YAML directly
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-async function _handleUrlWithTestCases_UNUSED(projectName, token, urlList, widths, branch, customNames, testCases) {
-    // Use @percy/core directly via a generated Node.js script
-    // This is the only way to set testCase on URL-based snapshots
-    const snapshots = urlList.map((url, i) => {
-        const name = customNames[i] ||
-            url
-                .replace(/^https?:\/\/[^/]+/, "")
-                .replace(/^\//, "")
-                .replace(/[/:?&=]/g, "-")
-                .replace(/-+/g, "-")
-                .replace(/^-|-$/g, "") ||
-            `Page ${i + 1}`;
-        const tc = testCases.length === 1 ? testCases[0] : testCases[i];
-        return { url, name, testCase: tc || undefined };
-    });
-    const scriptContent = `
-import Percy from '@percy/core';
-
-const percy = new Percy({
-  token: process.env.PERCY_TOKEN,
-  snapshot: { widths: [${widths.join(",")}] }
-});
-
-await percy.start();
-console.log('[percy-mcp] Percy started');
-
-const snapshots = ${JSON.stringify(snapshots)};
-
-for (const snap of snapshots) {
-  try {
-    await percy.snapshot({
-      url: snap.url,
-      name: snap.name,
-      testCase: snap.testCase,
-      widths: [${widths.join(",")}],
-      waitForTimeout: 3000,
-    });
-    console.log('[percy-mcp] ok ' + snap.name + (snap.testCase ? ' (test: ' + snap.testCase + ')' : ''));
-  } catch (e) {
-    console.error('[percy-mcp] fail ' + snap.name + ': ' + e.message);
-  }
-}
-
-await percy.stop();
-console.log('[percy-mcp] Done');
-`;
-    const tmpDir = await mkdtemp(join(tmpdir(), "percy-mcp-"));
-    const scriptPath = join(tmpDir, "snapshot.mjs");
-    await writeFile(scriptPath, scriptContent);
-    // Run the script in background
-    const child = spawn("node", [scriptPath], {
-        env: { ...process.env, PERCY_TOKEN: token },
-        stdio: ["ignore", "pipe", "pipe"],
-        detached: true,
-    });
-    let buildUrl = "";
-    const stdoutLines = [];
-    child.stdout?.on("data", (d) => {
-        const text = d.toString();
-        stdoutLines.push(text.trim());
-        const match = text.match(/https:\/\/percy\.io\/[^\s]+\/builds\/\d+/);
-        if (match)
-            buildUrl = match[0];
-    });
-    child.stderr?.on("data", (d) => {
-        stdoutLines.push(d.toString().trim());
-    });
-    // Wait for completion (up to 60s — Percy needs to start browser, render, upload)
-    await new Promise((resolve) => {
-        const timeout = setTimeout(resolve, 60000);
-        child.on("close", () => {
-            clearTimeout(timeout);
-            resolve();
-        });
-    });
-    child.unref();
-    setTimeout(async () => {
-        try {
-            await unlink(scriptPath);
-        }
-        catch {
-            /* ignore */
-        }
-    }, 120000);
-    // Build output
-    let output = `## Percy Build — ${projectName}\n\n`;
-    output += `**Branch:** ${branch}\n`;
-    output += `**URLs:** ${urlList.length}\n`;
-    output += `**Widths:** ${widths.join(", ")}px\n\n`;
-    output += `**Snapshots:**\n`;
-    for (const snap of snapshots) {
-        const logLine = stdoutLines.find((l) => l.includes(snap.name));
-        const ok = logLine?.includes("[percy-mcp] ok");
-        output += `- ${ok ? "✓" : "?"} **${snap.name}**`;
-        if (snap.testCase)
-            output += ` (test: ${snap.testCase})`;
-        output += ` → ${snap.url}\n`;
-    }
-    output += "\n";
-    if (buildUrl) {
-        output += `**Build URL:** ${buildUrl}\n\n`;
-        output += `${snapshots.length} snapshot(s) with test cases. Results ready in 1-3 minutes.\n`;
-    }
-    else {
-        const percyOutput = stdoutLines
-            .filter((l) => l.includes("[percy"))
-            .join("\n");
-        if (percyOutput) {
-            output += `**Percy output:**\n\`\`\`\n${percyOutput.slice(0, 500)}\n\`\`\`\n`;
-        }
-        else {
-            output += `Percy is processing. Check dashboard for results.\n`;
-        }
-    }
-    return { content: [{ type: "text", text: output }] };
-}
-// ── Test Command ────────────────────────────────────────────────────────────
-async function handleTestCommand(projectName, token, testCommand, branch) {
-    const cliInstalled = await isPercyCliInstalled();
-    if (!cliInstalled) {
-        let output = `## Percy CLI Not Installed\n\n`;
-        output += `Install it first:\n\`\`\`bash\nnpm install -g @percy/cli\n\`\`\`\n\n`;
-        output += `Then re-run this command.\n`;
-        return { content: [{ type: "text", text: output }] };
-    }
-    const cmdParts = testCommand.split(" ").filter(Boolean);
-    // EXECUTE AUTOMATICALLY
-    const child = spawn("npx", ["@percy/cli", "exec", "--", ...cmdParts], {
-        env: { ...process.env, PERCY_TOKEN: token },
-        stdio: ["ignore", "pipe", "pipe"],
-        detached: true,
-    });
-    let buildUrl = "";
-    let stdoutData = "";
-    child.stdout?.on("data", (d) => {
-        const text = d.toString();
-        stdoutData += text;
-        const match = text.match(/https:\/\/percy\.io\/[^\s]+\/builds\/\d+/);
-        if (match)
-            buildUrl = match[0];
-    });
-    child.stderr?.on("data", (d) => {
-        stdoutData += d.toString();
-    });
-    await new Promise((resolve) => {
-        const timeout = setTimeout(resolve, 15000);
-        child.on("close", () => {
-            clearTimeout(timeout);
-            resolve();
-        });
-        const check = setInterval(() => {
-            if (buildUrl) {
-                clearTimeout(timeout);
-                clearInterval(check);
-                resolve();
-            }
-        }, 500);
-    });
-    child.unref();
-    // Extract build ID from URL
-    const buildIdMatch = buildUrl.match(/\/builds\/(\d+)/);
-    const buildId = buildIdMatch ? buildIdMatch[1] : "";
-    if (buildId || buildUrl) {
-        setActiveBuild({ id: buildId, url: buildUrl, branch });
-    }
-    let output = `## Percy Build — Tests\n\n`;
-    output += `| Field | Value |\n|---|---|\n`;
-    output += `| **Project** | ${projectName} |\n`;
-    if (buildId)
-        output += `| **Build ID** | ${buildId} |\n`;
-    output += `| **Command** | \`${testCommand}\` |\n`;
-    output += `| **Branch** | ${branch} |\n`;
-    output += `| **Token** | \`${token.slice(0, 8)}...${token.slice(-4)}\` |\n`;
-    if (buildUrl)
-        output += `| **Build URL** | ${buildUrl} |\n`;
-    output += "\n";
-    if (buildUrl) {
-        output += `Tests running in background.\n`;
-    }
-    else if (stdoutData.trim()) {
-        output += `**Output:**\n\`\`\`\n${stdoutData.trim().slice(0, 500)}\n\`\`\`\n`;
-    }
-    else {
-        output += `Tests launched in background. Check Percy dashboard.\n`;
-    }
-    // Next steps
-    output += `\n### Next Steps\n\n`;
-    if (buildId) {
-        output += `- \`percy_get_build\` with build_id "${buildId}" — View build details\n`;
-    }
-    else {
-        output += `- \`percy_get_builds\` — Find build once processing completes\n`;
-    }
-    return { content: [{ type: "text", text: output }] };
-}
-// ── Screenshot Upload ───────────────────────────────────────────────────────
-async function handleScreenshotUpload(token, args, branch, commitSha, customNames, testCases) {
-    let files = [];
-    if (args.screenshot_files) {
-        files = args.screenshot_files
-            .split(",")
-            .map((f) => f.trim())
-            .filter(Boolean);
-    }
-    if (args.screenshots_dir) {
-        try {
-            const dirStat = await stat(args.screenshots_dir);
-            if (dirStat.isDirectory()) {
-                const entries = await readdir(args.screenshots_dir);
-                files.push(...entries
-                    .filter((f) => /\.(png|jpg|jpeg|webp)$/i.test(f))
-                    .map((f) => join(args.screenshots_dir, f)));
-            }
-        }
-        catch (e) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `Directory not accessible: ${e.message}`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-    }
-    if (files.length === 0) {
-        return {
-            content: [{ type: "text", text: "No image files found." }],
-            isError: true,
-        };
-    }
-    // Create build
-    const buildResponse = await percyTokenPost("/builds", token, {
-        data: {
-            type: "builds",
-            attributes: { branch, "commit-sha": commitSha },
-            relationships: { resources: { data: [] } },
-        },
-    });
-    const buildId = buildResponse?.data?.id;
-    const buildUrl = buildResponse?.data?.attributes?.["web-url"] || "";
-    if (!buildId) {
-        return {
-            content: [{ type: "text", text: "Failed to create build." }],
-            isError: true,
-        };
-    }
-    // Store in session
-    setActiveBuild({ id: buildId, url: buildUrl, branch });
-    let output = `## Percy Build — Screenshot Upload\n\n`;
-    output += `| Field | Value |\n|---|---|\n`;
-    output += `| **Build ID** | ${buildId} |\n`;
-    output += `| **Project** | ${args.project_name} |\n`;
-    output += `| **Branch** | ${branch} |\n`;
-    output += `| **Files** | ${files.length} |\n`;
-    output += `| **Token** | \`${token.slice(0, 8)}...${token.slice(-4)}\` |\n`;
-    if (buildUrl)
-        output += `| **Build URL** | ${buildUrl} |\n`;
-    output += "\n";
-    let uploaded = 0;
-    for (let i = 0; i < files.length; i++) {
-        const filePath = files[i];
-        // Use custom name, or clean filename
-        const name = customNames[i] ||
-            basename(filePath, extname(filePath)).replace(/[-_]/g, " ");
-        try {
-            const content = await readFile(filePath);
-            const sha = createHash("sha256").update(content).digest("hex");
-            const base64 = content.toString("base64");
-            let width = 1280;
-            let height = 800;
-            if (content[0] === 0x89 && content[1] === 0x50) {
-                width = content.readUInt32BE(16);
-                height = content.readUInt32BE(20);
-            }
-            // Create snapshot with optional test case
-            // If 1 test case provided → applies to all snapshots
-            // If multiple → maps 1:1 with files
-            const snapAttrs = { name };
-            const tc = testCases.length === 1 ? testCases[0] : testCases[i];
-            if (tc)
-                snapAttrs["test-case"] = tc;
-            const snapRes = await percyTokenPost(`/builds/${buildId}/snapshots`, token, { data: { type: "snapshots", attributes: snapAttrs } });
-            const snapId = snapRes?.data?.id;
-            if (!snapId) {
-                output += `- ✗ ${name}: snapshot failed\n`;
-                continue;
-            }
-            // Create comparison
-            const compRes = await percyTokenPost(`/snapshots/${snapId}/comparisons`, token, {
-                data: {
-                    attributes: {
-                        "external-debug-url": null,
-                        "dom-info-sha": null,
-                    },
-                    relationships: {
-                        tag: {
-                            data: {
-                                attributes: {
-                                    name: "Screenshot",
-                                    width,
-                                    height,
-                                    "os-name": "Upload",
-                                    "browser-name": "Screenshot",
-                                },
-                            },
-                        },
-                        tiles: {
-                            data: [
-                                {
-                                    attributes: {
-                                        sha,
-                                        "status-bar-height": 0,
-                                        "nav-bar-height": 0,
-                                    },
-                                },
-                            ],
-                        },
-                    },
-                },
-            });
-            const compId = compRes?.data?.id;
-            if (!compId) {
-                output += `- ✗ ${name}: comparison failed\n`;
-                continue;
-            }
-            // Upload tile
-            await percyTokenPost(`/comparisons/${compId}/tiles`, token, {
-                data: { attributes: { "base64-content": base64 } },
-            });
-            // Finalize comparison
-            await percyTokenPost(`/comparisons/${compId}/finalize`, token, {});
-            uploaded++;
-            output += `- ✓ **${name}** (${width}×${height})\n`;
-        }
-        catch (e) {
-            output += `- ✗ ${name}: ${e.message}\n`;
-        }
-    }
-    // Finalize build
-    try {
-        await percyTokenPost(`/builds/${buildId}/finalize`, token, {});
-        output += `\n**Build finalized.** ${uploaded}/${files.length} uploaded.\n`;
-    }
-    catch (e) {
-        output += `\n**Finalize failed:** ${e.message}\n`;
-    }
-    if (buildUrl)
-        output += `\n**View:** ${buildUrl}\n`;
-    output += `\n### Next Steps\n\n`;
-    output += `- \`percy_get_build\` with build_id "${buildId}" — View build details\n`;
-    output += `- \`percy_get_build\` with build_id "${buildId}" and detail "snapshots" — List snapshots\n`;
-    output += `- \`percy_get_build\` with build_id "${buildId}" and detail "ai_summary" — AI analysis\n`;
-    return { content: [{ type: "text", text: output }] };
-}

package/dist/tools/percy-mcp/v2/create-project.d.ts

@@ -1,8 +0,0 @@
-import { BrowserStackConfig } from "../../../lib/types.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-export declare function percyCreateProjectV2(args: {
-    name: string;
-    type?: string;
-    default_branch?: string;
-    workflow?: string;
-}, config: BrowserStackConfig): Promise<CallToolResult>;

package/dist/tools/percy-mcp/v2/create-project.js

@@ -1,33 +0,0 @@
-import { getOrCreateProjectToken } from "../../../lib/percy-api/percy-auth.js";
-import { setActiveProject } from "../../../lib/percy-api/percy-session.js";
-export async function percyCreateProjectV2(args, config) {
-    const token = await getOrCreateProjectToken(args.name, config, args.type);
-    const tokenPrefix = token.includes("_") ? token.split("_")[0] : "ci";
-    const masked = token.length > 8 ? `${token.slice(0, 8)}...${token.slice(-4)}` : "****";
-    const projectType = args.type || (tokenPrefix === "app" ? "app" : "web");
-    // Store in session — all subsequent calls will use this token
-    setActiveProject({
-        name: args.name,
-        token,
-        type: projectType,
-    });
-    let output = `## Percy Project — ${args.name}\n\n`;
-    output += `| Field | Value |\n|---|---|\n`;
-    output += `| **Name** | ${args.name} |\n`;
-    output += `| **Type** | ${projectType} |\n`;
-    output += `| **Token** | \`${masked}\` (${tokenPrefix}) |\n`;
-    output += `| **Status** | Active — token set for this session |\n`;
-    output += `\n**Full token:**\n\`\`\`\n${token}\n\`\`\`\n`;
-    output += `\n> Token is now **active** for all subsequent Percy commands in this session. No need to set PERCY_TOKEN manually.\n`;
-    output += `\n### Next Steps\n\n`;
-    if (projectType === "app") {
-        output += `- \`percy_create_app_build\` with project_name "${args.name}" — Create app BYOS build\n`;
-        output += `- \`percy_create_app_build\` with project_name "${args.name}" (no resources_dir) — Quick test with sample data\n`;
-    }
-    else {
-        output += `- \`percy_create_build\` with project_name "${args.name}" and urls "http://localhost:3000" — Snapshot URLs\n`;
-        output += `- \`percy_create_build\` with project_name "${args.name}" and screenshots_dir "./screenshots" — Upload screenshots\n`;
-    }
-    output += `- \`percy_get_builds\` — List builds for this project\n`;
-    return { content: [{ type: "text", text: output }] };
-}

package/dist/tools/percy-mcp/v2/discover-urls.d.ts

@@ -1,7 +0,0 @@
-import { BrowserStackConfig } from "../../../lib/types.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-export declare function percyDiscoverUrls(args: {
-    project_id: string;
-    sitemap_url?: string;
-    action?: string;
-}, config: BrowserStackConfig): Promise<CallToolResult>;

package/dist/tools/percy-mcp/v2/discover-urls.js

@@ -1,38 +0,0 @@
-import { percyPost, percyGet } from "../../../lib/percy-api/percy-auth.js";
-export async function percyDiscoverUrls(args, config) {
-    const action = args.action || (args.sitemap_url ? "create" : "list");
-    if (action === "create" && args.sitemap_url) {
-        const result = await percyPost("/sitemaps", config, {
-            data: {
-                type: "sitemaps",
-                attributes: { url: args.sitemap_url, "project-id": args.project_id },
-            },
-        });
-        const urls = result?.included?.filter((i) => i.type === "sitemap-urls") || [];
-        let output = `## URLs Discovered from Sitemap\n\n`;
-        output += `**Sitemap:** ${args.sitemap_url}\n`;
-        output += `**URLs found:** ${urls.length}\n\n`;
-        urls.forEach((u, i) => {
-            output += `${i + 1}. ${u.attributes?.url || u.url || "?"}\n`;
-        });
-        if (urls.length === 0)
-            output += `No URLs found in sitemap. Check the URL.\n`;
-        output += `\nUse these URLs with \`percy_create_build\` to snapshot them.\n`;
-        return { content: [{ type: "text", text: output }] };
-    }
-    // List existing sitemaps
-    const response = await percyGet("/sitemaps", config, {
-        project_id: args.project_id,
-    });
-    const sitemaps = response?.data || [];
-    let output = `## Sitemaps for Project\n\n`;
-    if (!sitemaps.length) {
-        output += `No sitemaps found. Create one with \`sitemap_url\` parameter.\n`;
-    }
-    else {
-        sitemaps.forEach((s, i) => {
-            output += `${i + 1}. ${s.attributes?.url || "?"} (${s.attributes?.state || "?"})\n`;
-        });
-    }
-    return { content: [{ type: "text", text: output }] };
-}