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

package/dist/tools/percy-mcp/workflows/diff-explain.js

@@ -1,147 +0,0 @@
-import { PercyClient } from "../../../lib/percy-api/client.js";
-import { pollUntil } from "../../../lib/percy-api/polling.js";
-export async function percyDiffExplain(args, config) {
-    const client = new PercyClient(config);
-    const depth = args.depth || "detailed"; // summary, detailed, full_rca
-    // Get comparison with AI data
-    const comparison = await client.get(`/comparisons/${args.comparison_id}`, {}, [
-        "head-screenshot.image",
-        "base-screenshot.image",
-        "diff-image",
-        "ai-diff-image",
-        "browser.browser-family",
-        "comparison-tag",
-    ]);
-    if (!comparison) {
-        return {
-            content: [{ type: "text", text: "Comparison not found." }],
-            isError: true,
-        };
-    }
-    let output = `## Visual Diff Explanation — Comparison #${args.comparison_id}\n\n`;
-    // Basic diff info
-    const diffRatio = comparison.diffRatio ?? 0;
-    const aiDiffRatio = comparison.aiDiffRatio;
-    output += `**Diff:** ${(diffRatio * 100).toFixed(1)}%`;
-    if (aiDiffRatio !== null && aiDiffRatio !== undefined) {
-        output += ` | **AI Diff:** ${(aiDiffRatio * 100).toFixed(1)}%`;
-        const reduction = diffRatio > 0 ? ((1 - aiDiffRatio / diffRatio) * 100).toFixed(0) : "0";
-        output += ` (${reduction}% noise filtered)`;
-    }
-    output += "\n\n";
-    // Summary depth: AI descriptions only
-    const regions = comparison.appliedRegions || [];
-    if (regions.length > 0) {
-        output += `### What Changed (${regions.length} regions)\n\n`;
-        regions.forEach((region, i) => {
-            const type = region.change_type || region.changeType || "unknown";
-            const title = region.change_title || region.changeTitle || "Untitled change";
-            const desc = region.change_description || region.changeDescription || "";
-            const reason = region.change_reason || region.changeReason || "";
-            const ignored = region.ignored;
-            output += `${i + 1}. ${ignored ? "~~" : "**"}${title}${ignored ? "~~" : "**"} (${type})`;
-            if (ignored)
-                output += " — *ignored by AI*";
-            output += "\n";
-            if (desc && depth !== "summary")
-                output += `   ${desc}\n`;
-            if (reason && depth !== "summary")
-                output += `   *Reason: ${reason}*\n`;
-            output += "\n";
-        });
-    }
-    else if (diffRatio > 0) {
-        output +=
-            "No AI region data available. Visual diff detected but not yet analyzed by AI.\n\n";
-    }
-    else {
-        output += "No visual differences detected.\n\n";
-    }
-    // Detailed depth: + coordinates
-    if (depth === "detailed" || depth === "full_rca") {
-        const coords = comparison.diffRects || comparison.aiDiffRects || [];
-        if (coords.length > 0) {
-            output += `### Diff Regions (coordinates)\n\n`;
-            coords.forEach((rect, i) => {
-                output += `${i + 1}. (${rect.x || rect.left || 0}, ${rect.y || rect.top || 0}) → (${rect.right || rect.x2 || 0}, ${rect.bottom || rect.y2 || 0})\n`;
-            });
-            output += "\n";
-        }
-    }
-    // Full RCA depth: + DOM/CSS changes
-    if (depth === "full_rca") {
-        output += `### Root Cause Analysis\n\n`;
-        try {
-            // Check if RCA exists, trigger if needed
-            let rcaData;
-            try {
-                rcaData = await client.get("/rca", {
-                    comparison_id: args.comparison_id,
-                });
-            }
-            catch (e) {
-                if (e.statusCode === 404) {
-                    // Trigger RCA
-                    await client.post("/rca", {
-                        data: {
-                            type: "rca",
-                            attributes: { "comparison-id": args.comparison_id },
-                        },
-                    });
-                    // Poll for result (max 30s for inline use)
-                    rcaData = await pollUntil(async () => {
-                        const data = await client.get("/rca", {
-                            comparison_id: args.comparison_id,
-                        });
-                        if (data?.status === "finished" || data?.status === "failed")
-                            return { done: true, result: data };
-                        return { done: false };
-                    }, { maxTimeoutMs: 30000 });
-                }
-                else {
-                    throw e;
-                }
-            }
-            if (rcaData?.status === "finished" && rcaData?.diffNodes) {
-                const nodes = rcaData.diffNodes;
-                const commonDiffs = nodes.common_diffs || [];
-                if (commonDiffs.length > 0) {
-                    commonDiffs.slice(0, 10).forEach((diff, i) => {
-                        const base = diff.base || {};
-                        const head = diff.head || {};
-                        const tag = head.tagName || base.tagName || "element";
-                        const xpath = head.xpath || base.xpath || "";
-                        output += `${i + 1}. **${tag}**`;
-                        if (xpath)
-                            output += ` — \`${xpath}\``;
-                        output += "\n";
-                        const baseAttrs = base.attributes || {};
-                        const headAttrs = head.attributes || {};
-                        for (const key of Object.keys(headAttrs)) {
-                            if (JSON.stringify(baseAttrs[key]) !==
-                                JSON.stringify(headAttrs[key])) {
-                                output += `   ${key}: \`${baseAttrs[key] ?? "none"}\` → \`${headAttrs[key]}\`\n`;
-                            }
-                        }
-                        output += "\n";
-                    });
-                }
-                else {
-                    output += "No DOM-level differences identified by RCA.\n";
-                }
-            }
-            else if (rcaData?.status === "failed") {
-                output +=
-                    "RCA analysis failed — comparison may not have DOM metadata.\n";
-            }
-            else {
-                output +=
-                    "RCA analysis is still processing. Re-run with depth=full_rca later.\n";
-            }
-        }
-        catch (e) {
-            output += `RCA unavailable: ${e.message}. Falling back to AI-only analysis.\n`;
-        }
-    }
-    return { content: [{ type: "text", text: output }] };
-}

package/dist/tools/percy-mcp/workflows/pr-visual-report.d.ts

@@ -1,8 +0,0 @@
-import { BrowserStackConfig } from "../../../lib/types.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-export declare function percyPrVisualReport(args: {
-    project_id?: string;
-    branch?: string;
-    sha?: string;
-    build_id?: string;
-}, config: BrowserStackConfig): Promise<CallToolResult>;

package/dist/tools/percy-mcp/workflows/pr-visual-report.js

@@ -1,184 +0,0 @@
-import { PercyClient } from "../../../lib/percy-api/client.js";
-import { percyCache } from "../../../lib/percy-api/cache.js";
-import { formatBuild } from "../../../lib/percy-api/formatter.js";
-export async function percyPrVisualReport(args, config) {
-    const client = new PercyClient(config);
-    const errors = [];
-    // Step 1: Resolve build
-    let build;
-    try {
-        if (args.build_id) {
-            build = await client.get(`/builds/${args.build_id}`, { "include-metadata": "true" }, ["build-summary", "browsers"]);
-        }
-        else {
-            // Find build by branch or SHA
-            const params = {};
-            if (args.project_id) {
-                // Use project-scoped endpoint
-            }
-            if (args.branch)
-                params["filter[branch]"] = args.branch;
-            if (args.sha)
-                params["filter[sha]"] = args.sha;
-            params["page[limit]"] = "1";
-            const builds = await client.get("/builds", params);
-            const buildList = Array.isArray(builds)
-                ? builds
-                : builds?.data
-                    ? Array.isArray(builds.data)
-                        ? builds.data
-                        : [builds.data]
-                    : [];
-            if (buildList.length === 0) {
-                const identifier = args.branch
-                    ? `branch '${args.branch}'`
-                    : args.sha
-                        ? `SHA '${args.sha}'`
-                        : "the given filters";
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `No Percy build found for ${identifier}. Ensure a Percy build has been created for this branch/commit.`,
-                        },
-                    ],
-                };
-            }
-            const buildId = buildList[0]?.id || buildList[0];
-            build = await client.get(`/builds/${typeof buildId === "object" ? buildId.id : buildId}`, { "include-metadata": "true" }, ["build-summary", "browsers"]);
-        }
-    }
-    catch (e) {
-        return {
-            content: [{ type: "text", text: `Failed to fetch build: ${e.message}` }],
-            isError: true,
-        };
-    }
-    if (!build) {
-        return {
-            content: [{ type: "text", text: "Build not found." }],
-            isError: true,
-        };
-    }
-    // Cache build data for other composite tools
-    percyCache.set(`build:${build.id}`, build);
-    // Step 2: Build header with state awareness
-    let output = "";
-    const state = build.state || "unknown";
-    output += `# Percy Visual Regression Report\n\n`;
-    output += formatBuild(build);
-    // Step 3: Get build summary if available
-    const buildSummary = build.buildSummary;
-    if (buildSummary?.summary) {
-        try {
-            const summaryData = typeof buildSummary.summary === "string"
-                ? JSON.parse(buildSummary.summary)
-                : buildSummary.summary;
-            if (summaryData?.title || summaryData?.items) {
-                output += `\n### AI Build Summary\n\n`;
-                if (summaryData.title)
-                    output += `> ${summaryData.title}\n\n`;
-                if (Array.isArray(summaryData.items)) {
-                    summaryData.items.forEach((item) => {
-                        output += `- ${item.title || item}\n`;
-                    });
-                    output += "\n";
-                }
-            }
-        }
-        catch {
-            // Summary parse failed, skip
-        }
-    }
-    // Step 4: Get changed build items
-    if (state === "finished" || state === "processing") {
-        let items = [];
-        try {
-            const itemsData = await client.get("/build-items", {
-                "filter[build-id]": build.id,
-                "filter[category]": "changed",
-                "page[limit]": "30",
-            });
-            items = Array.isArray(itemsData) ? itemsData : [];
-        }
-        catch (e) {
-            errors.push(`[Failed to load changed snapshots: ${e.message}]`);
-        }
-        if (items.length === 0 && errors.length === 0) {
-            output += `\n### No Visual Changes Detected\n\nAll snapshots match the baseline.\n`;
-        }
-        else if (items.length > 0) {
-            // Step 5: Rank by risk
-            // Critical: AI bug flags > Review: high diff > Expected: content changes > Noise: low diff
-            const critical = [];
-            const review = [];
-            const expected = [];
-            const noise = [];
-            for (const item of items) {
-                const name = item.name || item.snapshotName || "Unknown";
-                const diffRatio = item.diffRatio ?? item.maxDiffRatio ?? 0;
-                const potentialBugs = item.totalPotentialBugs || item.aiDetails?.totalPotentialBugs || 0;
-                const entry = { name, diffRatio, potentialBugs, item };
-                if (potentialBugs > 0) {
-                    critical.push(entry);
-                }
-                else if (diffRatio > 0.15) {
-                    review.push(entry);
-                }
-                else if (diffRatio > 0.005) {
-                    expected.push(entry);
-                }
-                else {
-                    noise.push(entry);
-                }
-            }
-            output += `\n### Changed Snapshots (${items.length})\n\n`;
-            if (critical.length > 0) {
-                output += `**CRITICAL — Potential Bugs (${critical.length}):**\n`;
-                critical.forEach((e, i) => {
-                    output += `${i + 1}. **${e.name}** — ${(e.diffRatio * 100).toFixed(1)}% diff, ${e.potentialBugs} bug(s) flagged\n`;
-                });
-                output += "\n";
-            }
-            if (review.length > 0) {
-                output += `**REVIEW REQUIRED (${review.length}):**\n`;
-                review.forEach((e, i) => {
-                    output += `${i + 1}. **${e.name}** — ${(e.diffRatio * 100).toFixed(1)}% diff\n`;
-                });
-                output += "\n";
-            }
-            if (expected.length > 0) {
-                output += `**EXPECTED CHANGES (${expected.length}):**\n`;
-                expected.forEach((e, i) => {
-                    output += `${i + 1}. ${e.name} — ${(e.diffRatio * 100).toFixed(1)}% diff\n`;
-                });
-                output += "\n";
-            }
-            if (noise.length > 0) {
-                output += `**NOISE (${noise.length}):** ${noise.map((e) => e.name).join(", ")}\n\n`;
-            }
-            // Recommendation
-            output += `### Recommendation\n\n`;
-            if (critical.length > 0) {
-                output += `Review ${critical.length} critical item(s) before approving. `;
-            }
-            if (review.length > 0) {
-                output += `${review.length} item(s) need manual review. `;
-            }
-            if (expected.length + noise.length > 0 &&
-                critical.length === 0 &&
-                review.length === 0) {
-                output += `All changes appear expected or are noise. Safe to approve.`;
-            }
-            output += "\n";
-        }
-    }
-    // Add any sub-call errors
-    if (errors.length > 0) {
-        output += `\n### Partial Results\n\n`;
-        errors.forEach((err) => {
-            output += `- ${err}\n`;
-        });
-    }
-    return { content: [{ type: "text", text: output }] };
-}

package/dist/tools/percy-mcp/workflows/run-tests.d.ts

@@ -1,17 +0,0 @@
-/**
- * percy_run_tests — Execute a test command with Percy visual testing.
- *
- * Wraps any test command with `percy exec` to capture snapshots during tests.
- * Fire-and-forget: launches in background, returns immediately.
- *
- * Requires @percy/cli installed locally.
- */
-import { BrowserStackConfig } from "../../../lib/types.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-interface RunTestsArgs {
-    project_name: string;
-    test_command: string;
-    type?: string;
-}
-export declare function percyRunTests(args: RunTestsArgs, config: BrowserStackConfig): Promise<CallToolResult>;
-export {};

package/dist/tools/percy-mcp/workflows/run-tests.js

@@ -1,107 +0,0 @@
-/**
- * percy_run_tests — Execute a test command with Percy visual testing.
- *
- * Wraps any test command with `percy exec` to capture snapshots during tests.
- * Fire-and-forget: launches in background, returns immediately.
- *
- * Requires @percy/cli installed locally.
- */
-import { execFile, spawn } from "child_process";
-import { promisify } from "util";
-const execFileAsync = promisify(execFile);
-async function getProjectToken(projectName, config) {
-    const authString = `${config["browserstack-username"]}:${config["browserstack-access-key"]}`;
-    const auth = Buffer.from(authString).toString("base64");
-    const url = `https://api.browserstack.com/api/app_percy/get_project_token?name=${encodeURIComponent(projectName)}`;
-    const response = await fetch(url, {
-        headers: { Authorization: `Basic ${auth}` },
-    });
-    if (!response.ok)
-        throw new Error(`Failed to get token for "${projectName}"`);
-    const data = await response.json();
-    if (!data?.token || !data?.success)
-        throw new Error(`No token for "${projectName}"`);
-    return data.token;
-}
-export async function percyRunTests(args, config) {
-    const { project_name, test_command } = args;
-    let output = `## Percy Test Run — Local Execution\n\n`;
-    // Check Percy CLI
-    try {
-        await execFileAsync("npx", ["@percy/cli", "--version"]);
-    }
-    catch {
-        output += `**Percy CLI not found.** Install it:\n\n`;
-        output += `\`\`\`bash\nnpm install -g @percy/cli\n\`\`\`\n`;
-        return { content: [{ type: "text", text: output }] };
-    }
-    // Get token
-    let token;
-    try {
-        token = await getProjectToken(project_name, config);
-    }
-    catch (e) {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Failed to get project token: ${e.message}`,
-                },
-            ],
-            isError: true,
-        };
-    }
-    output += `**Project:** ${project_name}\n`;
-    output += `**Command:** \`${test_command}\`\n\n`;
-    // Parse the test command into args
-    const cmdParts = test_command.split(" ").filter(Boolean);
-    // Spawn: npx @percy/cli exec -- <test_command>
-    const child = spawn("npx", ["@percy/cli", "exec", "--", ...cmdParts], {
-        env: { ...process.env, PERCY_TOKEN: token },
-        stdio: ["ignore", "pipe", "pipe"],
-        detached: true,
-        shell: false,
-    });
-    let stdoutData = "";
-    let buildUrl = "";
-    child.stdout?.on("data", (data) => {
-        const text = data.toString();
-        stdoutData += text;
-        const match = text.match(/https:\/\/percy\.io\/[^\s]+\/builds\/\d+/);
-        if (match)
-            buildUrl = match[0];
-    });
-    child.stderr?.on("data", (data) => {
-        stdoutData += data.toString();
-    });
-    // Wait briefly for build URL
-    await new Promise((resolve) => {
-        const timeout = setTimeout(() => resolve(), 10000);
-        child.on("close", () => {
-            clearTimeout(timeout);
-            resolve();
-        });
-        const check = setInterval(() => {
-            if (buildUrl) {
-                clearTimeout(timeout);
-                clearInterval(check);
-                resolve();
-            }
-        }, 500);
-    });
-    child.unref();
-    if (buildUrl) {
-        output += `**Build started!** Tests are running with Percy in the background.\n\n`;
-        output += `**Build URL:** ${buildUrl}\n\n`;
-        output += `Your tests are executing. Each \`percySnapshot()\` call in your tests captures a visual snapshot.\n`;
-        output += `Results will appear at the build URL when tests complete.\n`;
-    }
-    else {
-        const trimmed = stdoutData.trim().slice(0, 500);
-        if (trimmed) {
-            output += `**Percy output:**\n\`\`\`\n${trimmed}\n\`\`\`\n\n`;
-        }
-        output += `Tests are running in the background with Percy. Check your Percy dashboard for the build.\n`;
-    }
-    return { content: [{ type: "text", text: output }] };
-}

package/dist/tools/percy-mcp/workflows/snapshot-urls.d.ts

@@ -1,18 +0,0 @@
-/**
- * percy_snapshot_urls — Actually runs Percy CLI to snapshot URLs locally.
- *
- * Fire-and-forget: launches percy CLI in background, returns immediately
- * with build URL. User checks Percy dashboard for results.
- *
- * Requires @percy/cli installed locally (npx or global).
- */
-import { BrowserStackConfig } from "../../../lib/types.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-interface SnapshotUrlsArgs {
-    project_name: string;
-    urls: string;
-    widths?: string;
-    type?: string;
-}
-export declare function percySnapshotUrls(args: SnapshotUrlsArgs, config: BrowserStackConfig): Promise<CallToolResult>;
-export {};

package/dist/tools/percy-mcp/workflows/snapshot-urls.js

@@ -1,197 +0,0 @@
-/**
- * percy_snapshot_urls — Actually runs Percy CLI to snapshot URLs locally.
- *
- * Fire-and-forget: launches percy CLI in background, returns immediately
- * with build URL. User checks Percy dashboard for results.
- *
- * Requires @percy/cli installed locally (npx or global).
- */
-import { execFile, spawn } from "child_process";
-import { promisify } from "util";
-import { writeFile, unlink, mkdtemp } from "fs/promises";
-import { join } from "path";
-import { tmpdir } from "os";
-const execFileAsync = promisify(execFile);
-// ── Helpers ─────────────────────────────────────────────────────────────────
-async function getProjectToken(projectName, config, type) {
-    const authString = `${config["browserstack-username"]}:${config["browserstack-access-key"]}`;
-    const auth = Buffer.from(authString).toString("base64");
-    const params = new URLSearchParams({ name: projectName });
-    if (type)
-        params.append("type", type);
-    const url = `https://api.browserstack.com/api/app_percy/get_project_token?${params.toString()}`;
-    const response = await fetch(url, {
-        headers: { Authorization: `Basic ${auth}` },
-    });
-    if (!response.ok)
-        throw new Error(`Failed to get token for "${projectName}"`);
-    const data = await response.json();
-    if (!data?.token || !data?.success)
-        throw new Error(`No token for "${projectName}"`);
-    return data.token;
-}
-async function checkPercyCli() {
-    // Check if @percy/cli is available
-    try {
-        const { stdout } = await execFileAsync("npx", ["@percy/cli", "--version"]);
-        return stdout.trim();
-    }
-    catch {
-        // Try global
-        try {
-            const { stdout } = await execFileAsync("percy", ["--version"]);
-            return stdout.trim();
-        }
-        catch {
-            return null;
-        }
-    }
-}
-export async function percySnapshotUrls(args, config) {
-    const urls = args.urls
-        .split(",")
-        .map((u) => u.trim())
-        .filter(Boolean);
-    const widths = args.widths
-        ? args.widths.split(",").map((w) => w.trim())
-        : ["375", "1280"];
-    if (urls.length === 0) {
-        return {
-            content: [{ type: "text", text: "No URLs provided." }],
-            isError: true,
-        };
-    }
-    let output = `## Percy Snapshot — Local Rendering\n\n`;
-    // Step 1: Check Percy CLI
-    const cliVersion = await checkPercyCli();
-    if (!cliVersion) {
-        output += `**Percy CLI not found.** Install it first:\n\n`;
-        output += `\`\`\`bash\nnpm install -g @percy/cli\n\`\`\`\n\n`;
-        output += `Or install locally: \`npm install --save-dev @percy/cli\`\n`;
-        return { content: [{ type: "text", text: output }] };
-    }
-    output += `**Percy CLI:** ${cliVersion}\n`;
-    // Step 2: Get project token
-    let token;
-    try {
-        token = await getProjectToken(args.project_name, config, args.type);
-    }
-    catch (e) {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Failed to get project token: ${e.message}`,
-                },
-            ],
-            isError: true,
-        };
-    }
-    output += `**Project:** ${args.project_name}\n`;
-    output += `**URLs:** ${urls.length}\n`;
-    output += `**Widths:** ${widths.join(", ")}px\n\n`;
-    // Step 3: Create snapshots.yml config
-    let yamlContent = "";
-    urls.forEach((url, i) => {
-        const name = urls.length === 1
-            ? "Homepage"
-            : url
-                .replace(/^https?:\/\//, "")
-                .replace(/[/:]/g, "-")
-                .replace(/-+/g, "-")
-                .replace(/^-|-$/g, "") || `Page ${i + 1}`;
-        yamlContent += `- name: "${name}"\n`;
-        yamlContent += `  url: ${url}\n`;
-        yamlContent += `  waitForTimeout: 3000\n`;
-        yamlContent += `  additionalSnapshots:\n`;
-        widths.forEach((w) => {
-            yamlContent += `    - width: ${w}\n`;
-        });
-    });
-    // Write temp config file
-    const tmpDir = await mkdtemp(join(tmpdir(), "percy-mcp-"));
-    const configPath = join(tmpDir, "snapshots.yml");
-    await writeFile(configPath, yamlContent, "utf-8");
-    // Step 4: Launch Percy CLI in background
-    output += `### Launching Percy snapshot...\n\n`;
-    const env = {
-        ...process.env,
-        PERCY_TOKEN: token,
-    };
-    // Spawn percy CLI in background (fire and forget)
-    const child = spawn("npx", ["@percy/cli", "snapshot", configPath], {
-        env,
-        stdio: ["ignore", "pipe", "pipe"],
-        detached: true,
-    });
-    // Collect initial output for a few seconds
-    let stdoutData = "";
-    let stderrData = "";
-    let buildUrl = "";
-    child.stdout?.on("data", (data) => {
-        const text = data.toString();
-        stdoutData += text;
-        // Try to extract build URL
-        const match = text.match(/https:\/\/percy\.io\/[^\s]+\/builds\/\d+/);
-        if (match)
-            buildUrl = match[0];
-    });
-    child.stderr?.on("data", (data) => {
-        stderrData += data.toString();
-    });
-    // Wait a few seconds for initial output (build creation)
-    await new Promise((resolve) => {
-        const timeout = setTimeout(() => resolve(), 8000);
-        child.on("close", () => {
-            clearTimeout(timeout);
-            resolve();
-        });
-        // Also resolve if we find the build URL early
-        const checkInterval = setInterval(() => {
-            if (buildUrl) {
-                clearTimeout(timeout);
-                clearInterval(checkInterval);
-                resolve();
-            }
-        }, 500);
-    });
-    // Unref so the process doesn't keep MCP server alive
-    child.unref();
-    // Clean up temp file after a delay
-    setTimeout(async () => {
-        try {
-            await unlink(configPath);
-        }
-        catch {
-            // ignore
-        }
-    }, 120000); // 2 minutes
-    // Step 5: Report results
-    if (buildUrl) {
-        output += `**Build started!** Percy is rendering your pages in the background.\n\n`;
-        output += `**Build URL:** ${buildUrl}\n\n`;
-        output += `Percy is capturing ${urls.length} URL(s) at ${widths.length} width(s) = ${urls.length * widths.length} snapshot(s).\n\n`;
-        output += `Check the build URL above for results (usually ready in 1-3 minutes).\n`;
-    }
-    else if (stdoutData || stderrData) {
-        // No build URL found yet — show what we have
-        const allOutput = (stdoutData + stderrData).trim();
-        // Check for common errors
-        if (allOutput.includes("not found") || allOutput.includes("ECONNREFUSED")) {
-            output += `**Error:** The URL may not be reachable.\n\n`;
-            output += `Make sure your app is running at the specified URL(s):\n`;
-            urls.forEach((u) => {
-                output += `- ${u}\n`;
-            });
-            output += `\n`;
-        }
-        output += `**Percy CLI output:**\n\`\`\`\n${allOutput.slice(0, 500)}\n\`\`\`\n\n`;
-        output += `Percy is running in the background. If a build was created, check your Percy dashboard.\n`;
-    }
-    else {
-        output += `**Percy CLI launched in background.** No output yet.\n\n`;
-        output += `The build should appear in your Percy dashboard shortly.\n`;
-        output += `Check: https://percy.io\n`;
-    }
-    return { content: [{ type: "text", text: output }] };
-}