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

package/dist/tools/percy-mcp/intelligence/trigger-ai-recompute.js

@@ -1,64 +0,0 @@
-/**
- * percy_trigger_ai_recompute — Re-run Percy AI analysis with a custom prompt.
- *
- * Sends a recompute request for a build or single comparison, optionally
- * with a user-supplied prompt and ignore/unignore mode.
- */
-import { PercyClient } from "../../../lib/percy-api/client.js";
-export async function percyTriggerAiRecompute(args, config) {
-    const client = new PercyClient(config);
-    if (!args.build_id && !args.comparison_id) {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: "Either build_id or comparison_id is required.",
-                },
-            ],
-            isError: true,
-        };
-    }
-    const body = {
-        data: {
-            type: "ai-recompute",
-            attributes: {
-                ...(args.prompt && { "user-prompt": args.prompt }),
-                ...(args.mode && { mode: args.mode }),
-                ...(args.comparison_id && {
-                    "comparison-id": parseInt(args.comparison_id, 10),
-                }),
-                ...(args.build_id && {
-                    "build-id": parseInt(args.build_id, 10),
-                }),
-            },
-        },
-    };
-    try {
-        await client.post("/ai-recompute", body);
-        let output = "## AI Recompute Triggered\n\n";
-        output += `**Mode:** ${args.mode || "ignore"}\n`;
-        if (args.prompt)
-            output += `**Prompt:** ${args.prompt}\n`;
-        output += `**Status:** Processing\n\n`;
-        output +=
-            "The AI will re-analyze the visual diffs with your custom prompt. ";
-        output +=
-            "Use `percy_get_ai_analysis` to check results after processing completes (typically 30-60 seconds).\n";
-        return { content: [{ type: "text", text: output }] };
-    }
-    catch (e) {
-        const message = e instanceof Error ? e.message : String(e);
-        if (message.includes("quota")) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "AI recompute quota exceeded for today. Try again tomorrow or upgrade your plan.",
-                    },
-                ],
-                isError: true,
-            };
-        }
-        throw e;
-    }
-}

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

@@ -1,14 +0,0 @@
-import { BrowserStackConfig } from "../../../lib/types.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-/**
- * Creates a Percy project using the BrowserStack API.
- *
- * Uses `api.browserstack.com/api/app_percy/get_project_token` which:
- * - Creates the project if it doesn't exist
- * - Returns a project token for the project
- * - Requires BrowserStack Basic Auth (username + access key)
- */
-export declare function percyCreateProject(args: {
-    name: string;
-    type?: string;
-}, config: BrowserStackConfig): Promise<CallToolResult>;

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

@@ -1,52 +0,0 @@
-import { getBrowserStackAuth } from "../../../lib/get-auth.js";
-/**
- * Creates a Percy project using the BrowserStack API.
- *
- * Uses `api.browserstack.com/api/app_percy/get_project_token` which:
- * - Creates the project if it doesn't exist
- * - Returns a project token for the project
- * - Requires BrowserStack Basic Auth (username + access key)
- */
-export async function percyCreateProject(args, config) {
-    const authString = getBrowserStackAuth(config);
-    const auth = Buffer.from(authString).toString("base64");
-    const params = new URLSearchParams({ name: args.name });
-    if (args.type) {
-        params.append("type", args.type);
-    }
-    const url = `https://api.browserstack.com/api/app_percy/get_project_token?${params.toString()}`;
-    const response = await fetch(url, {
-        headers: {
-            Authorization: `Basic ${auth}`,
-            "Content-Type": "application/json",
-        },
-    });
-    if (!response.ok) {
-        const errorText = await response.text().catch(() => "");
-        throw new Error(`Failed to create Percy project (${response.status}): ${errorText || response.statusText}`);
-    }
-    const data = await response.json();
-    if (!data?.success) {
-        throw new Error(data?.message ||
-            "Project creation failed — check the project name and type.");
-    }
-    const token = data.token || "unknown";
-    const tokenPrefix = token.split("_")[0] || "unknown";
-    const maskedToken = token.length > 8 ? `${token.slice(0, 8)}...${token.slice(-4)}` : "****";
-    let output = `## Percy Project Created\n\n`;
-    output += `| Field | Value |\n`;
-    output += `|-------|-------|\n`;
-    output += `| **Name** | ${args.name} |\n`;
-    output += `| **Type** | ${args.type || "auto (default)"} |\n`;
-    output += `| **Token** | \`${maskedToken}\` |\n`;
-    output += `| **Token type** | ${tokenPrefix} |\n`;
-    output += `| **Capture mode** | ${data.percy_capture_mode || "auto"} |\n`;
-    output += `\n### Project Token\n\n`;
-    output += `\`\`\`\n${token}\n\`\`\`\n\n`;
-    output += `> Save this token — set it as \`PERCY_TOKEN\` env var to use with other Percy tools.\n\n`;
-    output += `### Next Steps\n\n`;
-    output += `1. Set the token: \`export PERCY_TOKEN=${token}\`\n`;
-    output += `2. Create a build: \`percy_create_build\` with project_id from Percy dashboard\n`;
-    output += `3. Or run Percy CLI: \`percy exec -- your-test-command\`\n`;
-    return { content: [{ type: "text", text: output }] };
-}

package/dist/tools/percy-mcp/management/get-usage-stats.d.ts

@@ -1,12 +0,0 @@
-/**
- * percy_get_usage_stats — Get Percy screenshot usage, quota limits, and AI comparison
- * counts for an organization.
- */
-import { BrowserStackConfig } from "../../../lib/types.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-interface GetUsageStatsArgs {
-    org_id: string;
-    product?: string;
-}
-export declare function percyGetUsageStats(args: GetUsageStatsArgs, config: BrowserStackConfig): Promise<CallToolResult>;
-export {};

package/dist/tools/percy-mcp/management/get-usage-stats.js

@@ -1,61 +0,0 @@
-/**
- * percy_get_usage_stats — Get Percy screenshot usage, quota limits, and AI comparison
- * counts for an organization.
- */
-import { PercyClient } from "../../../lib/percy-api/client.js";
-export async function percyGetUsageStats(args, config) {
-    const { org_id, product } = args;
-    const client = new PercyClient(config);
-    const params = {
-        "filter[organization-id]": org_id,
-    };
-    if (product) {
-        params["filter[product]"] = product;
-    }
-    const response = await client.get("/usage-stats", params);
-    const data = response?.data;
-    const entries = Array.isArray(data) ? data : data ? [data] : [];
-    if (entries.length === 0) {
-        return {
-            content: [
-                { type: "text", text: "_No usage data found for this organization._" },
-            ],
-        };
-    }
-    const lines = [];
-    lines.push(`## Percy Usage Stats (Org: ${org_id})`);
-    lines.push("");
-    for (const entry of entries) {
-        const attrs = entry.attributes ?? entry;
-        const entryProduct = attrs.product ?? attrs["product-type"] ?? "percy";
-        lines.push(`### ${entryProduct}`);
-        lines.push("");
-        lines.push("| Metric | Value |");
-        lines.push("|--------|-------|");
-        const currentUsage = attrs.currentUsage ?? attrs["current-usage"] ?? attrs.usage ?? "?";
-        const quota = attrs.quota ?? attrs["screenshot-quota"] ?? "?";
-        const aiComparisons = attrs.aiComparisons ?? attrs["ai-comparisons"] ?? "N/A";
-        const planType = attrs.planType ?? attrs["plan-type"] ?? "N/A";
-        lines.push(`| Current Usage | ${currentUsage} |`);
-        lines.push(`| Quota | ${quota} |`);
-        lines.push(`| AI Comparisons | ${aiComparisons} |`);
-        lines.push(`| Plan Type | ${planType} |`);
-        // Include any additional numeric attrs
-        for (const [key, value] of Object.entries(attrs)) {
-            if (typeof value === "number" &&
-                ![
-                    "currentUsage",
-                    "current-usage",
-                    "usage",
-                    "quota",
-                    "screenshot-quota",
-                    "aiComparisons",
-                    "ai-comparisons",
-                ].includes(key)) {
-                lines.push(`| ${key} | ${value} |`);
-            }
-        }
-        lines.push("");
-    }
-    return { content: [{ type: "text", text: lines.join("\n") }] };
-}

package/dist/tools/percy-mcp/management/manage-browser-targets.d.ts

@@ -1,12 +0,0 @@
-/**
- * percy_manage_browser_targets — List, add, or remove browser targets for a project.
- */
-import { BrowserStackConfig } from "../../../lib/types.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-interface ManageBrowserTargetsArgs {
-    project_id: string;
-    action?: string;
-    browser_family?: string;
-}
-export declare function percyManageBrowserTargets(args: ManageBrowserTargetsArgs, config: BrowserStackConfig): Promise<CallToolResult>;
-export {};

package/dist/tools/percy-mcp/management/manage-browser-targets.js

@@ -1,136 +0,0 @@
-/**
- * percy_manage_browser_targets — List, add, or remove browser targets for a project.
- */
-import { PercyClient } from "../../../lib/percy-api/client.js";
-export async function percyManageBrowserTargets(args, config) {
-    const { project_id, action = "list", browser_family } = args;
-    const client = new PercyClient(config);
-    // ---- List ----
-    if (action === "list") {
-        const [families, targets] = await Promise.all([
-            client.get("/browser-families"),
-            client.get(`/projects/${project_id}/project-browser-targets`),
-        ]);
-        const familyList = Array.isArray(families?.data) ? families.data : [];
-        const targetList = Array.isArray(targets?.data) ? targets.data : [];
-        const lines = [];
-        lines.push(`## Browser Targets for Project ${project_id}`);
-        lines.push("");
-        if (targetList.length === 0) {
-            lines.push("_No browser targets configured. Using defaults._");
-        }
-        else {
-            lines.push("### Active Targets");
-            lines.push("");
-            lines.push("| Browser Family | ID |");
-            lines.push("|---------------|-----|");
-            for (const target of targetList) {
-                const attrs = target.attributes ?? target;
-                const name = attrs.browserFamilySlug ??
-                    attrs["browser-family-slug"] ??
-                    attrs.name ??
-                    "unknown";
-                lines.push(`| ${name} | ${target.id ?? "?"} |`);
-            }
-        }
-        if (familyList.length > 0) {
-            lines.push("");
-            lines.push("### Available Browser Families");
-            lines.push("");
-            for (const family of familyList) {
-                const attrs = family.attributes ?? family;
-                const name = attrs.name ?? attrs.slug ?? "unknown";
-                lines.push(`- ${name} (ID: ${family.id ?? "?"})`);
-            }
-        }
-        return { content: [{ type: "text", text: lines.join("\n") }] };
-    }
-    // ---- Add ----
-    if (action === "add") {
-        if (!browser_family) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "browser_family is required for the 'add' action. Use action='list' to see available families.",
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const body = {
-            data: {
-                type: "project-browser-targets",
-                relationships: {
-                    project: { data: { type: "projects", id: project_id } },
-                    "browser-family": {
-                        data: { type: "browser-families", id: browser_family },
-                    },
-                },
-            },
-        };
-        try {
-            await client.post("/project-browser-targets", body);
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `Browser family ${browser_family} added to project ${project_id}.`,
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return {
-                content: [
-                    { type: "text", text: `Failed to add browser target: ${message}` },
-                ],
-                isError: true,
-            };
-        }
-    }
-    // ---- Remove ----
-    if (action === "remove") {
-        if (!browser_family) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "browser_family (target ID) is required for the 'remove' action.",
-                    },
-                ],
-                isError: true,
-            };
-        }
-        try {
-            await client.del(`/project-browser-targets/${browser_family}`);
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `Browser target ${browser_family} removed from project ${project_id}.`,
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return {
-                content: [
-                    { type: "text", text: `Failed to remove browser target: ${message}` },
-                ],
-                isError: true,
-            };
-        }
-    }
-    return {
-        content: [
-            {
-                type: "text",
-                text: `Invalid action "${action}". Valid actions: list, add, remove`,
-            },
-        ],
-        isError: true,
-    };
-}

package/dist/tools/percy-mcp/management/manage-comments.d.ts

@@ -1,14 +0,0 @@
-/**
- * percy_manage_comments — List, create, or close comment threads on Percy snapshots.
- */
-import { BrowserStackConfig } from "../../../lib/types.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-interface ManageCommentsArgs {
-    build_id?: string;
-    snapshot_id?: string;
-    action?: string;
-    thread_id?: string;
-    body?: string;
-}
-export declare function percyManageComments(args: ManageCommentsArgs, config: BrowserStackConfig): Promise<CallToolResult>;
-export {};

package/dist/tools/percy-mcp/management/manage-comments.js

@@ -1,147 +0,0 @@
-/**
- * percy_manage_comments — List, create, or close comment threads on Percy snapshots.
- */
-import { PercyClient } from "../../../lib/percy-api/client.js";
-export async function percyManageComments(args, config) {
-    const { build_id, snapshot_id, action = "list", thread_id, body } = args;
-    const client = new PercyClient(config);
-    // ---- List ----
-    if (action === "list") {
-        if (!build_id) {
-            return {
-                content: [
-                    { type: "text", text: "build_id is required for the 'list' action." },
-                ],
-                isError: true,
-            };
-        }
-        const response = await client.get(`/builds/${build_id}/comment_threads`);
-        const threads = Array.isArray(response?.data) ? response.data : [];
-        if (threads.length === 0) {
-            return {
-                content: [
-                    { type: "text", text: "_No comment threads for this build._" },
-                ],
-            };
-        }
-        const lines = [];
-        lines.push(`## Comment Threads (Build: ${build_id})`);
-        lines.push("");
-        for (const thread of threads) {
-            const attrs = thread.attributes ?? thread;
-            const id = thread.id ?? "?";
-            const closed = attrs.closedAt ?? attrs["closed-at"];
-            const status = closed ? "Closed" : "Open";
-            const commentCount = attrs.commentsCount ?? attrs["comments-count"] ?? "?";
-            lines.push(`### Thread #${id} (${status}, ${commentCount} comments)`);
-            lines.push("");
-        }
-        return { content: [{ type: "text", text: lines.join("\n") }] };
-    }
-    // ---- Create ----
-    if (action === "create") {
-        if (!snapshot_id) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "snapshot_id is required for the 'create' action.",
-                    },
-                ],
-                isError: true,
-            };
-        }
-        if (!body) {
-            return {
-                content: [
-                    { type: "text", text: "body is required for the 'create' action." },
-                ],
-                isError: true,
-            };
-        }
-        const requestBody = {
-            data: {
-                type: "comments",
-                attributes: {
-                    body,
-                },
-                relationships: {
-                    snapshot: {
-                        data: { type: "snapshots", id: snapshot_id },
-                    },
-                },
-            },
-        };
-        try {
-            const result = (await client.post("/comments", requestBody));
-            const id = result?.data?.id ?? "?";
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `Comment created (ID: ${id}) on snapshot ${snapshot_id}.`,
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return {
-                content: [
-                    { type: "text", text: `Failed to create comment: ${message}` },
-                ],
-                isError: true,
-            };
-        }
-    }
-    // ---- Close ----
-    if (action === "close") {
-        if (!thread_id) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "thread_id is required for the 'close' action.",
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const requestBody = {
-            data: {
-                type: "comment-threads",
-                id: thread_id,
-                attributes: {
-                    "closed-at": new Date().toISOString(),
-                },
-            },
-        };
-        try {
-            await client.patch(`/comment-threads/${thread_id}`, requestBody);
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `Comment thread ${thread_id} closed.`,
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return {
-                content: [{ type: "text", text: `Failed to close thread: ${message}` }],
-                isError: true,
-            };
-        }
-    }
-    return {
-        content: [
-            {
-                type: "text",
-                text: `Invalid action "${action}". Valid actions: list, create, close`,
-            },
-        ],
-        isError: true,
-    };
-}

package/dist/tools/percy-mcp/management/manage-ignored-regions.d.ts

@@ -1,18 +0,0 @@
-/**
- * percy_manage_ignored_regions — Create, list, save, or delete ignored regions
- * on Percy comparisons.
- *
- * Supports bounding box (raw), XPath, CSS selector, and fullpage types.
- */
-import { BrowserStackConfig } from "../../../lib/types.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-interface ManageIgnoredRegionsArgs {
-    comparison_id?: string;
-    action?: string;
-    region_id?: string;
-    type?: string;
-    coordinates?: string;
-    selector?: string;
-}
-export declare function percyManageIgnoredRegions(args: ManageIgnoredRegionsArgs, config: BrowserStackConfig): Promise<CallToolResult>;
-export {};