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

package/dist/tools/percy-mcp/creation/create-snapshot.js

@@ -1,99 +0,0 @@
-/**
- * percy_create_snapshot — Create a snapshot in a Percy build with DOM resources.
- *
- * POST /builds/{build_id}/snapshots with JSON:API body.
- * Returns snapshot ID and list of missing resources for upload.
- */
-import { PercyClient } from "../../../lib/percy-api/client.js";
-export async function percyCreateSnapshot(args, config) {
-    const { build_id, name, widths, enable_javascript, resources } = args;
-    // Parse widths from comma-separated string to int array
-    const parsedWidths = widths
-        ? widths
-            .split(",")
-            .map((w) => parseInt(w.trim(), 10))
-            .filter((w) => !isNaN(w))
-        : undefined;
-    // Parse resources from JSON string
-    let parsedResources;
-    if (resources) {
-        try {
-            parsedResources = JSON.parse(resources);
-        }
-        catch {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `Invalid resources JSON: could not parse the provided string.`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-    }
-    const attributes = { name };
-    if (parsedWidths) {
-        attributes.widths = parsedWidths;
-    }
-    if (enable_javascript !== undefined) {
-        attributes["enable-javascript"] = enable_javascript;
-    }
-    const body = {
-        data: {
-            type: "snapshots",
-            attributes,
-            relationships: {
-                ...(parsedResources
-                    ? {
-                        resources: {
-                            data: parsedResources.map((r) => ({
-                                type: "resources",
-                                id: r.id,
-                                attributes: {
-                                    "resource-url": r["resource-url"],
-                                    "is-root": r["is-root"] ?? false,
-                                },
-                            })),
-                        },
-                    }
-                    : {}),
-            },
-        },
-    };
-    try {
-        const client = new PercyClient(config);
-        const result = (await client.post(`/builds/${build_id}/snapshots`, body));
-        const snapshotId = result?.data?.id ?? "unknown";
-        // Extract missing resources from relationships
-        const missingResources = result?.data?.missingResources ?? [];
-        const missingCount = Array.isArray(missingResources)
-            ? missingResources.length
-            : 0;
-        const missingShas = Array.isArray(missingResources)
-            ? missingResources.map((r) => r.id ?? r).join(", ")
-            : "";
-        const lines = [
-            `Snapshot '${name}' created (ID: ${snapshotId}). Missing resources: ${missingCount}.`,
-        ];
-        if (missingCount > 0) {
-            lines.push(`Upload them with percy_upload_resource.`);
-            lines.push(`Missing SHAs: ${missingShas}`);
-        }
-        return {
-            content: [{ type: "text", text: lines.join(" ") }],
-        };
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Failed to create snapshot '${name}' in build ${build_id}: ${message}`,
-                },
-            ],
-            isError: true,
-        };
-    }
-}

package/dist/tools/percy-mcp/creation/finalize-build.d.ts

@@ -1,12 +0,0 @@
-/**
- * percy_finalize_build — Finalize a Percy build after all snapshots are complete.
- *
- * POST /builds/{build_id}/finalize — triggers processing.
- */
-import { BrowserStackConfig } from "../../../lib/types.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-interface FinalizeBuildArgs {
-    build_id: string;
-}
-export declare function percyFinalizeBuild(args: FinalizeBuildArgs, config: BrowserStackConfig): Promise<CallToolResult>;
-export {};

package/dist/tools/percy-mcp/creation/finalize-build.js

@@ -1,33 +0,0 @@
-/**
- * percy_finalize_build — Finalize a Percy build after all snapshots are complete.
- *
- * POST /builds/{build_id}/finalize — triggers processing.
- */
-import { PercyClient } from "../../../lib/percy-api/client.js";
-export async function percyFinalizeBuild(args, config) {
-    const { build_id } = args;
-    try {
-        const client = new PercyClient(config);
-        await client.post(`/builds/${build_id}/finalize`);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Build ${build_id} finalized. Processing will begin.`,
-                },
-            ],
-        };
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Failed to finalize build ${build_id}: ${message}`,
-                },
-            ],
-            isError: true,
-        };
-    }
-}

package/dist/tools/percy-mcp/creation/finalize-comparison.d.ts

@@ -1,10 +0,0 @@
-/**
- * percy_finalize_comparison — Finalize a Percy comparison after all tiles are uploaded.
- */
-import { BrowserStackConfig } from "../../../lib/types.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-interface FinalizeComparisonArgs {
-    comparison_id: string;
-}
-export declare function percyFinalizeComparison(args: FinalizeComparisonArgs, config: BrowserStackConfig): Promise<CallToolResult>;
-export {};

package/dist/tools/percy-mcp/creation/finalize-comparison.js

@@ -1,16 +0,0 @@
-/**
- * percy_finalize_comparison — Finalize a Percy comparison after all tiles are uploaded.
- */
-import { PercyClient } from "../../../lib/percy-api/client.js";
-export async function percyFinalizeComparison(args, config) {
-    const client = new PercyClient(config, { scope: "auto" });
-    await client.post(`/comparisons/${args.comparison_id}/finalize`);
-    return {
-        content: [
-            {
-                type: "text",
-                text: `Comparison ${args.comparison_id} finalized. Diff processing will begin.`,
-            },
-        ],
-    };
-}

package/dist/tools/percy-mcp/creation/finalize-snapshot.d.ts

@@ -1,12 +0,0 @@
-/**
- * percy_finalize_snapshot — Finalize a Percy snapshot after all resources are uploaded.
- *
- * POST /snapshots/{snapshot_id}/finalize — triggers rendering.
- */
-import { BrowserStackConfig } from "../../../lib/types.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-interface FinalizeSnapshotArgs {
-    snapshot_id: string;
-}
-export declare function percyFinalizeSnapshot(args: FinalizeSnapshotArgs, config: BrowserStackConfig): Promise<CallToolResult>;
-export {};

package/dist/tools/percy-mcp/creation/finalize-snapshot.js

@@ -1,33 +0,0 @@
-/**
- * percy_finalize_snapshot — Finalize a Percy snapshot after all resources are uploaded.
- *
- * POST /snapshots/{snapshot_id}/finalize — triggers rendering.
- */
-import { PercyClient } from "../../../lib/percy-api/client.js";
-export async function percyFinalizeSnapshot(args, config) {
-    const { snapshot_id } = args;
-    try {
-        const client = new PercyClient(config);
-        await client.post(`/snapshots/${snapshot_id}/finalize`);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Snapshot ${snapshot_id} finalized. Rendering will begin.`,
-                },
-            ],
-        };
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Failed to finalize snapshot ${snapshot_id}: ${message}`,
-                },
-            ],
-            isError: true,
-        };
-    }
-}

package/dist/tools/percy-mcp/creation/upload-resource.d.ts

@@ -1,15 +0,0 @@
-/**
- * percy_upload_resource — Upload a resource to a Percy build.
- *
- * POST /builds/{build_id}/resources with JSON:API body.
- * Percy API validates SHA matches content server-side.
- */
-import { BrowserStackConfig } from "../../../lib/types.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-interface UploadResourceArgs {
-    build_id: string;
-    sha: string;
-    base64_content: string;
-}
-export declare function percyUploadResource(args: UploadResourceArgs, config: BrowserStackConfig): Promise<CallToolResult>;
-export {};

package/dist/tools/percy-mcp/creation/upload-resource.js

@@ -1,43 +0,0 @@
-/**
- * percy_upload_resource — Upload a resource to a Percy build.
- *
- * POST /builds/{build_id}/resources with JSON:API body.
- * Percy API validates SHA matches content server-side.
- */
-import { PercyClient } from "../../../lib/percy-api/client.js";
-export async function percyUploadResource(args, config) {
-    const { build_id, sha, base64_content } = args;
-    const body = {
-        data: {
-            type: "resources",
-            id: sha,
-            attributes: {
-                "base64-content": base64_content,
-            },
-        },
-    };
-    try {
-        const client = new PercyClient(config);
-        await client.post(`/builds/${build_id}/resources`, body);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Resource ${sha} uploaded successfully.`,
-                },
-            ],
-        };
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `Failed to upload resource ${sha} to build ${build_id}: ${message}`,
-                },
-            ],
-            isError: true,
-        };
-    }
-}

package/dist/tools/percy-mcp/creation/upload-tile.d.ts

@@ -1,11 +0,0 @@
-/**
- * percy_upload_tile — Upload a screenshot tile (PNG or JPEG) to a Percy comparison.
- */
-import { BrowserStackConfig } from "../../../lib/types.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-interface UploadTileArgs {
-    comparison_id: string;
-    base64_content: string;
-}
-export declare function percyUploadTile(args: UploadTileArgs, config: BrowserStackConfig): Promise<CallToolResult>;
-export {};

package/dist/tools/percy-mcp/creation/upload-tile.js

@@ -1,53 +0,0 @@
-/**
- * percy_upload_tile — Upload a screenshot tile (PNG or JPEG) to a Percy comparison.
- */
-import { PercyClient } from "../../../lib/percy-api/client.js";
-// PNG magic bytes: 0x89 0x50 0x4E 0x47
-const PNG_MAGIC = [0x89, 0x50, 0x4e, 0x47];
-// JPEG magic bytes: 0xFF 0xD8 0xFF
-const JPEG_MAGIC = [0xff, 0xd8, 0xff];
-function isValidImage(base64) {
-    try {
-        const buffer = Buffer.from(base64, "base64");
-        if (buffer.length < 4)
-            return false;
-        const isPng = PNG_MAGIC.every((byte, i) => buffer[i] === byte);
-        const isJpeg = JPEG_MAGIC.every((byte, i) => buffer[i] === byte);
-        return isPng || isJpeg;
-    }
-    catch {
-        return false;
-    }
-}
-export async function percyUploadTile(args, config) {
-    // Validate image format
-    if (!isValidImage(args.base64_content)) {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: "Only PNG and JPEG images are supported",
-                },
-            ],
-            isError: true,
-        };
-    }
-    const client = new PercyClient(config, { scope: "auto" });
-    const body = {
-        data: {
-            type: "tiles",
-            attributes: {
-                "base64-content": args.base64_content,
-            },
-        },
-    };
-    await client.post(`/comparisons/${args.comparison_id}/tiles`, body);
-    return {
-        content: [
-            {
-                type: "text",
-                text: `Tile uploaded to comparison ${args.comparison_id}.`,
-            },
-        ],
-    };
-}

package/dist/tools/percy-mcp/diagnostics/analyze-logs-realtime.d.ts

@@ -1,13 +0,0 @@
-/**
- * percy_analyze_logs_realtime — Analyze raw log data in real-time.
- *
- * Accepts a JSON array of log entries, sends them to Percy's suggestion
- * engine, and returns instant diagnostics with fix suggestions.
- */
-import { BrowserStackConfig } from "../../../lib/types.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-interface AnalyzeLogsRealtimeArgs {
-    logs: string;
-}
-export declare function percyAnalyzeLogsRealtime(args: AnalyzeLogsRealtimeArgs, config: BrowserStackConfig): Promise<CallToolResult>;
-export {};

package/dist/tools/percy-mcp/diagnostics/analyze-logs-realtime.js

@@ -1,65 +0,0 @@
-/**
- * percy_analyze_logs_realtime — Analyze raw log data in real-time.
- *
- * Accepts a JSON array of log entries, sends them to Percy's suggestion
- * engine, and returns instant diagnostics with fix suggestions.
- */
-import { PercyClient } from "../../../lib/percy-api/client.js";
-import { formatSuggestions } from "../../../lib/percy-api/formatter.js";
-export async function percyAnalyzeLogsRealtime(args, config) {
-    const client = new PercyClient(config);
-    let logEntries;
-    try {
-        logEntries = JSON.parse(args.logs);
-        if (!Array.isArray(logEntries)) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "logs must be a JSON array of log entries.",
-                    },
-                ],
-                isError: true,
-            };
-        }
-    }
-    catch {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: "Invalid JSON in logs parameter. Provide a JSON array of log entries.",
-                },
-            ],
-            isError: true,
-        };
-    }
-    const body = {
-        data: {
-            logs: logEntries,
-        },
-    };
-    try {
-        const result = await client.post("/suggestions/from_logs", body);
-        if (!result || (Array.isArray(result) && result.length === 0)) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: "No issues detected in the provided logs.",
-                    },
-                ],
-            };
-        }
-        const suggestions = Array.isArray(result) ? result : [result];
-        const output = "## Real-Time Log Analysis\n\n" + formatSuggestions(suggestions);
-        return { content: [{ type: "text", text: output }] };
-    }
-    catch (e) {
-        const message = e instanceof Error ? e.message : String(e);
-        return {
-            content: [{ type: "text", text: `Log analysis failed: ${message}` }],
-            isError: true,
-        };
-    }
-}

package/dist/tools/percy-mcp/diagnostics/get-build-logs.d.ts

@@ -1,17 +0,0 @@
-/**
- * percy_get_build_logs — Download and filter Percy build logs.
- *
- * Retrieves logs for a build, optionally filtered by service (cli, renderer,
- * jackproxy), reference scope, and log level.
- */
-import { BrowserStackConfig } from "../../../lib/types.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-interface GetBuildLogsArgs {
-    build_id: string;
-    service?: string;
-    reference_type?: string;
-    reference_id?: string;
-    level?: string;
-}
-export declare function percyGetBuildLogs(args: GetBuildLogsArgs, config: BrowserStackConfig): Promise<CallToolResult>;
-export {};

package/dist/tools/percy-mcp/diagnostics/get-build-logs.js

@@ -1,74 +0,0 @@
-/**
- * percy_get_build_logs — Download and filter Percy build logs.
- *
- * Retrieves logs for a build, optionally filtered by service (cli, renderer,
- * jackproxy), reference scope, and log level.
- */
-import { PercyClient } from "../../../lib/percy-api/client.js";
-export async function percyGetBuildLogs(args, config) {
-    const client = new PercyClient(config);
-    const params = { build_id: args.build_id };
-    if (args.service)
-        params.service_name = args.service;
-    if (args.reference_type && args.reference_id) {
-        params.reference_id = `${args.reference_type}_${args.reference_id}`;
-    }
-    let data;
-    try {
-        data = await client.get("/logs", params);
-    }
-    catch (e) {
-        const message = e instanceof Error ? e.message : String(e);
-        return {
-            content: [{ type: "text", text: `Failed to fetch logs: ${message}` }],
-            isError: true,
-        };
-    }
-    if (!data) {
-        return {
-            content: [{ type: "text", text: "No logs available for this build." }],
-        };
-    }
-    let output = `## Build Logs — #${args.build_id}\n\n`;
-    if (args.service)
-        output += `**Service:** ${args.service}\n`;
-    if (args.level)
-        output += `**Level filter:** ${args.level}\n`;
-    output += "\n";
-    // Parse log data — format depends on service
-    const record = data;
-    const rendererLogs = record?.renderer;
-    const rawLogs = Array.isArray(data)
-        ? data
-        : record?.logs ||
-            record?.clilogs ||
-            rendererLogs?.logs ||
-            [];
-    const logs = Array.isArray(rawLogs) ? rawLogs : [];
-    if (logs.length > 0) {
-        const filtered = args.level
-            ? logs.filter((l) => {
-                const entry = l;
-                return entry.level === args.level || entry.debug === args.level;
-            })
-            : logs;
-        output += "```\n";
-        filtered.slice(0, 100).forEach((log) => {
-            const entry = log;
-            const ts = entry.timestamp ? `[${entry.timestamp}] ` : "";
-            const level = (entry.level || entry.debug || "");
-            const msg = entry.message ||
-                entry.msg ||
-                JSON.stringify(entry);
-            output += `${ts}${level ? level.toUpperCase() + " " : ""}${msg}\n`;
-        });
-        if (filtered.length > 100) {
-            output += `\n... (${filtered.length - 100} more log entries)\n`;
-        }
-        output += "```\n";
-    }
-    else {
-        output += "No log entries found matching filters.\n";
-    }
-    return { content: [{ type: "text", text: output }] };
-}

package/dist/tools/percy-mcp/diagnostics/get-network-logs.d.ts

@@ -1,5 +0,0 @@
-import { BrowserStackConfig } from "../../../lib/types.js";
-import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
-export declare function percyGetNetworkLogs(args: {
-    comparison_id: string;
-}, config: BrowserStackConfig): Promise<CallToolResult>;

package/dist/tools/percy-mcp/diagnostics/get-network-logs.js

@@ -1,21 +0,0 @@
-import { PercyClient } from "../../../lib/percy-api/client.js";
-import { formatNetworkLogs } from "../../../lib/percy-api/formatter.js";
-export async function percyGetNetworkLogs(args, config) {
-    const client = new PercyClient(config);
-    const data = await client.get("/network-logs", {
-        comparison_id: args.comparison_id,
-    });
-    if (!data || (Array.isArray(data) && data.length === 0)) {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: "No network requests recorded for this comparison.",
-                },
-            ],
-        };
-    }
-    const logs = Array.isArray(data) ? data : Object.values(data);
-    const output = formatNetworkLogs(logs);
-    return { content: [{ type: "text", text: output }] };
-}

package/dist/tools/percy-mcp/diagnostics/get-suggestions.d.ts

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

package/dist/tools/percy-mcp/diagnostics/get-suggestions.js

@@ -1,24 +0,0 @@
-import { PercyClient } from "../../../lib/percy-api/client.js";
-import { formatSuggestions } from "../../../lib/percy-api/formatter.js";
-export async function percyGetSuggestions(args, config) {
-    const client = new PercyClient(config);
-    const params = { build_id: args.build_id };
-    if (args.reference_type)
-        params.reference_type = args.reference_type;
-    if (args.reference_id)
-        params.reference_id = args.reference_id;
-    const data = await client.get("/suggestions", params);
-    if (!data || (Array.isArray(data) && data.length === 0)) {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: "No diagnostic suggestions available for this build.",
-                },
-            ],
-        };
-    }
-    const suggestions = Array.isArray(data) ? data : [data];
-    const output = formatSuggestions(suggestions);
-    return { content: [{ type: "text", text: output }] };
-}

package/dist/tools/percy-mcp/index.d.ts

@@ -1,36 +0,0 @@
-/**
- * Percy MCP tools — CRUD-organized tools for Percy visual testing.
- *
- * Registers 41 tools organized by CRUD action:
- *
- * === CREATE (6) ===
- *   percy_create_project, percy_create_percy_build, percy_create_build,
- *   percy_create_snapshot, percy_create_app_snapshot, percy_create_comparison
- *
- * === READ (17) ===
- *   percy_list_projects, percy_list_builds, percy_get_build,
- *   percy_get_build_items, percy_get_snapshot, percy_get_comparison,
- *   percy_get_ai_analysis, percy_get_build_summary, percy_get_ai_quota,
- *   percy_get_rca, percy_get_suggestions, percy_get_network_logs,
- *   percy_get_build_logs, percy_get_usage_stats, percy_auth_status
- *
- * === UPDATE (12) ===
- *   percy_approve_build, percy_manage_project_settings,
- *   percy_manage_browser_targets, percy_manage_tokens,
- *   percy_manage_webhooks, percy_manage_ignored_regions,
- *   percy_manage_comments, percy_manage_variants,
- *   percy_manage_visual_monitoring, percy_trigger_ai_recompute,
- *   percy_suggest_prompt, percy_branchline_operations
- *
- * === FINALIZE / UPLOAD (6) ===
- *   percy_finalize_build, percy_finalize_snapshot, percy_finalize_comparison,
- *   percy_upload_resource, percy_upload_tile, percy_analyze_logs_realtime
- *
- * === WORKFLOWS (4) ===
- *   percy_pr_visual_report, percy_auto_triage,
- *   percy_debug_failed_build, percy_diff_explain
- */
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { BrowserStackConfig } from "../../lib/types.js";
-export declare function registerPercyMcpTools(server: McpServer, config: BrowserStackConfig): Record<string, any>;
-export default registerPercyMcpTools;