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

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

@@ -1,182 +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 { PercyClient } from "../../../lib/percy-api/client.js";
-export async function percyManageIgnoredRegions(args, config) {
-    const { comparison_id, action = "list", region_id, type, coordinates, selector, } = args;
-    const client = new PercyClient(config);
-    // ---- List ----
-    if (action === "list") {
-        if (!comparison_id) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "comparison_id is required for the 'list' action.",
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const response = await client.get("/region-revisions", {
-            comparison_id,
-        });
-        const regions = Array.isArray(response?.data) ? response.data : [];
-        if (regions.length === 0) {
-            return {
-                content: [
-                    { type: "text", text: "_No ignored regions for this comparison._" },
-                ],
-            };
-        }
-        const lines = [];
-        lines.push(`## Ignored Regions (Comparison: ${comparison_id})`);
-        lines.push("");
-        lines.push("| ID | Type | Selector / Coordinates |");
-        lines.push("|----|------|------------------------|");
-        for (const region of regions) {
-            const attrs = region.attributes ?? region;
-            const rType = attrs.type ?? attrs["region-type"] ?? "unknown";
-            const rSelector = attrs.selector ?? "";
-            const rCoords = attrs.coordinates
-                ? JSON.stringify(attrs.coordinates)
-                : "";
-            const display = rSelector || rCoords || "—";
-            lines.push(`| ${region.id ?? "?"} | ${rType} | ${display} |`);
-        }
-        return { content: [{ type: "text", text: lines.join("\n") }] };
-    }
-    // ---- Create ----
-    if (action === "create") {
-        if (!comparison_id) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "comparison_id is required for the 'create' action.",
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const attrs = {};
-        if (type)
-            attrs["region-type"] = type;
-        if (selector)
-            attrs.selector = selector;
-        if (coordinates) {
-            try {
-                attrs.coordinates = JSON.parse(coordinates);
-            }
-            catch {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: 'Invalid coordinates JSON. Expected format: {"x":0,"y":0,"width":100,"height":100}',
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-        }
-        const body = {
-            data: {
-                type: "region-revisions",
-                attributes: attrs,
-                relationships: {
-                    comparison: {
-                        data: { type: "comparisons", id: comparison_id },
-                    },
-                },
-            },
-        };
-        try {
-            const result = (await client.post("/region-revisions", body));
-            const id = result?.data?.id ?? "?";
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `Ignored region created (ID: ${id}, type: ${type ?? "raw"}).`,
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return {
-                content: [
-                    { type: "text", text: `Failed to create ignored region: ${message}` },
-                ],
-                isError: true,
-            };
-        }
-    }
-    // ---- Save (bulk) ----
-    if (action === "save") {
-        try {
-            await client.patch("/region-revisions/bulk-save", {});
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "Ignored regions saved (bulk save completed).",
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return {
-                content: [
-                    { type: "text", text: `Failed to bulk-save regions: ${message}` },
-                ],
-                isError: true,
-            };
-        }
-    }
-    // ---- Delete ----
-    if (action === "delete") {
-        if (!region_id) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "region_id is required for the 'delete' action.",
-                    },
-                ],
-                isError: true,
-            };
-        }
-        try {
-            await client.del(`/region-revisions/${region_id}`);
-            return {
-                content: [
-                    { type: "text", text: `Ignored region ${region_id} deleted.` },
-                ],
-            };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return {
-                content: [
-                    { type: "text", text: `Failed to delete region: ${message}` },
-                ],
-                isError: true,
-            };
-        }
-    }
-    return {
-        content: [
-            {
-                type: "text",
-                text: `Invalid action "${action}". Valid actions: list, create, save, delete`,
-            },
-        ],
-        isError: true,
-    };
-}

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

@@ -1,16 +0,0 @@
-/**
- * percy_manage_project_settings — View or update Percy project settings.
- *
- * GET /projects/{project_id} to read current settings.
- * PATCH /projects/{project_id} with JSON:API body to update.
- * High-risk attributes require confirm_destructive=true.
- */
-import { BrowserStackConfig } from "../../../lib/types.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-interface ManageProjectSettingsArgs {
-    project_id: string;
-    settings?: string;
-    confirm_destructive?: boolean;
-}
-export declare function percyManageProjectSettings(args: ManageProjectSettingsArgs, config: BrowserStackConfig): Promise<CallToolResult>;
-export {};

package/dist/tools/percy-mcp/management/manage-project-settings.js

@@ -1,97 +0,0 @@
-/**
- * percy_manage_project_settings — View or update Percy project settings.
- *
- * GET /projects/{project_id} to read current settings.
- * PATCH /projects/{project_id} with JSON:API body to update.
- * High-risk attributes require confirm_destructive=true.
- */
-import { PercyClient } from "../../../lib/percy-api/client.js";
-// ---------------------------------------------------------------------------
-// Constants
-// ---------------------------------------------------------------------------
-const HIGH_RISK_ATTRIBUTES = [
-    "auto-approve-branch-filter",
-    "approval-required-branch-filter",
-];
-export async function percyManageProjectSettings(args, config) {
-    const { project_id, settings, confirm_destructive } = args;
-    const client = new PercyClient(config);
-    // ---- Read current settings ----
-    const current = (await client.get(`/projects/${project_id}`));
-    if (!settings) {
-        // Read-only mode — return current settings
-        const attrs = current?.data?.attributes ?? current?.data ?? {};
-        const lines = [];
-        lines.push(`## Project Settings (ID: ${project_id})`);
-        lines.push("");
-        lines.push("| Setting | Value |");
-        lines.push("|---------|-------|");
-        for (const [key, value] of Object.entries(attrs)) {
-            lines.push(`| ${key} | ${JSON.stringify(value)} |`);
-        }
-        return { content: [{ type: "text", text: lines.join("\n") }] };
-    }
-    // ---- Update mode ----
-    let parsed;
-    try {
-        parsed = JSON.parse(settings);
-    }
-    catch {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: "Invalid settings JSON. Provide a valid JSON object of attributes to update.",
-                },
-            ],
-            isError: true,
-        };
-    }
-    // Check for high-risk attributes
-    const highRiskKeys = Object.keys(parsed).filter((key) => HIGH_RISK_ATTRIBUTES.includes(key));
-    if (highRiskKeys.length > 0 && !confirm_destructive) {
-        const lines = [];
-        lines.push("## Warning: High-Risk Settings Change");
-        lines.push("");
-        lines.push("The following settings can significantly affect your workflow:");
-        lines.push("");
-        for (const key of highRiskKeys) {
-            lines.push(`- **${key}**: \`${JSON.stringify(parsed[key])}\``);
-        }
-        lines.push("");
-        lines.push("Set `confirm_destructive=true` to apply these changes.");
-        return { content: [{ type: "text", text: lines.join("\n") }] };
-    }
-    // Build JSON:API PATCH body
-    const body = {
-        data: {
-            type: "projects",
-            id: project_id,
-            attributes: parsed,
-        },
-    };
-    try {
-        const result = (await client.patch(`/projects/${project_id}`, body));
-        const updatedAttrs = result?.data?.attributes ?? result?.data ?? {};
-        const lines = [];
-        lines.push(`## Project Settings Updated (ID: ${project_id})`);
-        lines.push("");
-        lines.push("**Updated attributes:**");
-        for (const key of Object.keys(parsed)) {
-            lines.push(`- **${key}**: ${JSON.stringify(updatedAttrs[key] ?? parsed[key])}`);
-        }
-        return { content: [{ type: "text", text: lines.join("\n") }] };
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Failed to update project settings: ${message}`,
-                },
-            ],
-            isError: true,
-        };
-    }
-}

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

@@ -1,14 +0,0 @@
-/**
- * percy_manage_tokens — List or rotate Percy project tokens.
- *
- * Token values are masked — only the last 4 characters are shown.
- */
-import { BrowserStackConfig } from "../../../lib/types.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-interface ManageTokensArgs {
-    project_id: string;
-    action?: string;
-    role?: string;
-}
-export declare function percyManageTokens(args: ManageTokensArgs, config: BrowserStackConfig): Promise<CallToolResult>;
-export {};

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

@@ -1,90 +0,0 @@
-/**
- * percy_manage_tokens — List or rotate Percy project tokens.
- *
- * Token values are masked — only the last 4 characters are shown.
- */
-import { PercyClient } from "../../../lib/percy-api/client.js";
-export async function percyManageTokens(args, config) {
-    const { project_id, action = "list", role } = args;
-    const client = new PercyClient(config);
-    // ---- List ----
-    if (action === "list") {
-        const response = await client.get(`/projects/${project_id}/tokens`);
-        const tokens = Array.isArray(response?.data) ? response.data : [];
-        if (tokens.length === 0) {
-            return {
-                content: [
-                    { type: "text", text: "_No tokens found for this project._" },
-                ],
-            };
-        }
-        const lines = [];
-        lines.push(`## Tokens for Project ${project_id}`);
-        lines.push("");
-        lines.push("| Role | Token (masked) | ID |");
-        lines.push("|------|---------------|----|");
-        for (const token of tokens) {
-            const attrs = token.attributes ?? token;
-            const tokenRole = attrs.role ?? attrs["token-role"] ?? "unknown";
-            const tokenValue = attrs.token ?? attrs["token-value"] ?? "";
-            const masked = tokenValue.length > 4 ? `****${tokenValue.slice(-4)}` : "****";
-            lines.push(`| ${tokenRole} | ${masked} | ${token.id ?? "?"} |`);
-        }
-        lines.push("");
-        lines.push("_Token values are masked for security. Use action='rotate' to generate a new token._");
-        return { content: [{ type: "text", text: lines.join("\n") }] };
-    }
-    // ---- Rotate ----
-    if (action === "rotate") {
-        if (!role) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "role is required for the 'rotate' action (e.g., 'write', 'read').",
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const body = {
-            data: {
-                type: "tokens",
-                attributes: {
-                    "project-id": parseInt(project_id, 10),
-                    role,
-                },
-            },
-        };
-        try {
-            const result = (await client.patch("/tokens/rotate", body));
-            const attrs = result?.data?.attributes ?? result?.data ?? {};
-            const newToken = attrs.token ?? attrs["token-value"] ?? "";
-            const masked = newToken.length > 4 ? `****${newToken.slice(-4)}` : "****";
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `## Token Rotated\n\n**Role:** ${role}\n**New token (masked):** ${masked}\n\n_The full token was returned by the API. Store it securely — it cannot be retrieved again._`,
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return {
-                content: [{ type: "text", text: `Failed to rotate token: ${message}` }],
-                isError: true,
-            };
-        }
-    }
-    return {
-        content: [
-            {
-                type: "text",
-                text: `Invalid action "${action}". Valid actions: list, rotate`,
-            },
-        ],
-        isError: true,
-    };
-}

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

@@ -1,15 +0,0 @@
-/**
- * percy_manage_webhooks — Create, update, list, or delete webhooks for Percy build events.
- */
-import { BrowserStackConfig } from "../../../lib/types.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-interface ManageWebhooksArgs {
-    project_id: string;
-    action?: string;
-    webhook_id?: string;
-    url?: string;
-    events?: string;
-    description?: string;
-}
-export declare function percyManageWebhooks(args: ManageWebhooksArgs, config: BrowserStackConfig): Promise<CallToolResult>;
-export {};

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

@@ -1,180 +0,0 @@
-/**
- * percy_manage_webhooks — Create, update, list, or delete webhooks for Percy build events.
- */
-import { PercyClient } from "../../../lib/percy-api/client.js";
-export async function percyManageWebhooks(args, config) {
-    const { project_id, action = "list", webhook_id, url, events, description, } = args;
-    const client = new PercyClient(config);
-    // ---- List ----
-    if (action === "list") {
-        const response = await client.get(`/webhook-configs`, {
-            "filter[project-id]": project_id,
-        });
-        const webhooks = Array.isArray(response?.data) ? response.data : [];
-        if (webhooks.length === 0) {
-            return {
-                content: [
-                    { type: "text", text: "_No webhooks configured for this project._" },
-                ],
-            };
-        }
-        const lines = [];
-        lines.push(`## Webhooks for Project ${project_id}`);
-        lines.push("");
-        lines.push("| ID | URL | Events | Description |");
-        lines.push("|----|-----|--------|-------------|");
-        for (const webhook of webhooks) {
-            const attrs = webhook.attributes ?? webhook;
-            const wUrl = attrs.url ?? "?";
-            const wEvents = Array.isArray(attrs.events)
-                ? attrs.events.join(", ")
-                : (attrs.events ?? "?");
-            const wDesc = attrs.description ?? "";
-            lines.push(`| ${webhook.id ?? "?"} | ${wUrl} | ${wEvents} | ${wDesc} |`);
-        }
-        return { content: [{ type: "text", text: lines.join("\n") }] };
-    }
-    // ---- Create ----
-    if (action === "create") {
-        if (!url) {
-            return {
-                content: [
-                    { type: "text", text: "url is required for the 'create' action." },
-                ],
-                isError: true,
-            };
-        }
-        const eventArray = events
-            ? events
-                .split(",")
-                .map((e) => e.trim())
-                .filter(Boolean)
-            : [];
-        const body = {
-            data: {
-                type: "webhook-configs",
-                attributes: {
-                    url,
-                    events: eventArray,
-                    ...(description ? { description } : {}),
-                },
-                relationships: {
-                    project: { data: { type: "projects", id: project_id } },
-                },
-            },
-        };
-        try {
-            const result = (await client.post("/webhook-configs", body));
-            const id = result?.data?.id ?? "?";
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `## Webhook Created\n\n**ID:** ${id}\n**URL:** ${url}\n**Events:** ${eventArray.join(", ") || "all"}\n${description ? `**Description:** ${description}` : ""}`,
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return {
-                content: [
-                    { type: "text", text: `Failed to create webhook: ${message}` },
-                ],
-                isError: true,
-            };
-        }
-    }
-    // ---- Update ----
-    if (action === "update") {
-        if (!webhook_id) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "webhook_id is required for the 'update' action.",
-                    },
-                ],
-                isError: true,
-            };
-        }
-        const attrs = {};
-        if (url)
-            attrs.url = url;
-        if (events) {
-            attrs.events = events
-                .split(",")
-                .map((e) => e.trim())
-                .filter(Boolean);
-        }
-        if (description)
-            attrs.description = description;
-        const body = {
-            data: {
-                type: "webhook-configs",
-                id: webhook_id,
-                attributes: attrs,
-            },
-        };
-        try {
-            await client.patch(`/webhook-configs/${webhook_id}`, body);
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `Webhook ${webhook_id} updated successfully.`,
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return {
-                content: [
-                    { type: "text", text: `Failed to update webhook: ${message}` },
-                ],
-                isError: true,
-            };
-        }
-    }
-    // ---- Delete ----
-    if (action === "delete") {
-        if (!webhook_id) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "webhook_id is required for the 'delete' action.",
-                    },
-                ],
-                isError: true,
-            };
-        }
-        try {
-            await client.del(`/webhook-configs/${webhook_id}`);
-            return {
-                content: [
-                    { type: "text", text: `Webhook ${webhook_id} deleted successfully.` },
-                ],
-            };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return {
-                content: [
-                    { type: "text", text: `Failed to delete webhook: ${message}` },
-                ],
-                isError: true,
-            };
-        }
-    }
-    return {
-        content: [
-            {
-                type: "text",
-                text: `Invalid action "${action}". Valid actions: list, create, update, delete`,
-            },
-        ],
-        isError: true,
-    };
-}

package/dist/tools/percy-mcp/v2/auth-status.d.ts

@@ -1,3 +0,0 @@
-import { BrowserStackConfig } from "../../../lib/types.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-export declare function percyAuthStatusV2(_args: Record<string, never>, config: BrowserStackConfig): Promise<CallToolResult>;

package/dist/tools/percy-mcp/v2/auth-status.js

@@ -1,80 +0,0 @@
-import { percyGet } from "../../../lib/percy-api/percy-auth.js";
-import { getSession, formatActiveProject, formatActiveBuild, } from "../../../lib/percy-api/percy-session.js";
-export async function percyAuthStatusV2(_args, config) {
-    let output = `## Percy Auth Status\n\n`;
-    const hasCreds = !!(config["browserstack-username"] && config["browserstack-access-key"]);
-    output += `| Credential | Status |\n|---|---|\n`;
-    output += `| BrowserStack Username | ${hasCreds ? config["browserstack-username"] : "Not set"} |\n`;
-    output += `| BrowserStack Access Key | ${hasCreds ? "Set" : "Not set"} |\n`;
-    output += "\n";
-    // Note about PERCY_TOKEN — it's per-project, not global
-    output += `> **Note:** PERCY_TOKEN is set per-project, not globally. Use \`percy_create_project\` to get a project token — it will be activated automatically for subsequent calls.\n\n`;
-    if (hasCreds) {
-        output += `### Validation\n\n`;
-        // Test BrowserStack API by checking user info (lightweight, won't 500)
-        const bsAuth = Buffer.from(`${config["browserstack-username"]}:${config["browserstack-access-key"]}`).toString("base64");
-        try {
-            const response = await fetch("https://api.browserstack.com/api/app_percy/user", { headers: { Authorization: `Basic ${bsAuth}` } });
-            if (response.ok) {
-                const userData = await response.json();
-                const orgName = userData?.organizations?.[0]?.name;
-                const orgId = userData?.organizations?.[0]?.id;
-                output += `**BrowserStack API:** Connected\n`;
-                if (orgName)
-                    output += `**Organization:** ${orgName}`;
-                if (orgId)
-                    output += ` (ID: ${orgId})`;
-                output += `\n`;
-            }
-            else {
-                output += `**BrowserStack API:** ${response.status} ${response.statusText}\n`;
-            }
-        }
-        catch (e) {
-            output += `**BrowserStack API:** Failed — ${e.message}\n`;
-        }
-        // Test Percy API read access (use a lightweight endpoint)
-        try {
-            await percyGet("/organizations", config, { "page[limit]": "1" });
-            output += `**Percy API (Basic Auth):** Connected\n`;
-        }
-        catch (e) {
-            // If /organizations fails, try a simpler endpoint
-            try {
-                await percyGet("/user", config);
-                output += `**Percy API (Basic Auth):** Connected\n`;
-            }
-            catch {
-                output += `**Percy API (Basic Auth):** Limited — ${e.message}\n`;
-                output += `This is OK. All project-scoped tools work via BrowserStack API.\n`;
-            }
-        }
-    }
-    output += "\n### Capabilities\n\n";
-    if (hasCreds) {
-        output += `All Percy MCP tools are available:\n`;
-        output += `- Create/manage projects and tokens\n`;
-        output += `- Create builds (URL, screenshot, app BYOS)\n`;
-        output += `- Read builds, snapshots, comparisons\n`;
-        output += `- AI analysis, RCA, insights\n`;
-        output += `- Clone builds, Figma integration\n`;
-    }
-    else {
-        output += `No BrowserStack credentials found.\n\n`;
-        output += `Set your credentials in MCP server config or environment:\n`;
-        output += `\`\`\`bash\nexport BROWSERSTACK_USERNAME="your_username"\nexport BROWSERSTACK_ACCESS_KEY="your_key"\n\`\`\`\n`;
-    }
-    // Show active session context
-    const session = getSession();
-    if (session.projectName || session.buildId) {
-        output += `\n### Active Session\n`;
-        output += formatActiveProject();
-        output += formatActiveBuild();
-    }
-    output += `\n### Getting Started\n\n`;
-    output += `1. \`percy_create_project\` — Create/access a project (sets active token)\n`;
-    output += `2. \`percy_create_build\` — Create a web build with URLs or screenshots\n`;
-    output += `3. \`percy_create_app_build\` — Create an app BYOS build (works with sample data)\n`;
-    output += `4. \`percy_get_projects\` — List all projects in your org\n`;
-    return { content: [{ type: "text", text: output }] };
-}