browser-devtools-mcp 0.0.3 → 0.1.1

package/dist/tools/content/take-screenshot.js

@@ -7,6 +7,8 @@ exports.TakeScreenshot = exports.ScreenshotType = void 0;
 const utils_1 = require("../../utils");
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
+const jpeg_js_1 = __importDefault(require("jpeg-js"));
+const pngjs_1 = require("pngjs");
 const zod_1 = require("zod");
 var ScreenshotType;
 (function (ScreenshotType) {
@@ -15,6 +17,7 @@ var ScreenshotType;
 })(ScreenshotType || (exports.ScreenshotType = ScreenshotType = {}));
 const DEFAULT_SCREENSHOT_NAME = 'screenshot';
 const DEFAULT_SCREENSHOT_TYPE = ScreenshotType.PNG;
+const DEFAULT_SCREENSHOT_QUALITY = 100;
 class TakeScreenshot {
     name() {
         return 'content_take-screenshot';
@@ -51,6 +54,13 @@ class TakeScreenshot {
                 .describe(`Page format. Valid values are: ${(0, utils_1.getEnumKeyTuples)(ScreenshotType)}`)
                 .optional()
                 .default(DEFAULT_SCREENSHOT_TYPE),
+            quality: zod_1.z
+                .number()
+                .int()
+                .min(0)
+                .max(DEFAULT_SCREENSHOT_QUALITY)
+                .describe('The quality of the image, between 0-100. Not applicable to png images.')
+                .optional(),
         };
     }
     outputSchema() {
@@ -60,14 +70,186 @@ class TakeScreenshot {
                 .describe('Full path of the saved screenshot file.'),
         };
     }
+    // Imported and adapter from Playwright:
+    // https://github.com/microsoft/playwright/blob/342d6aa843f0c4470d71ba1671dacfdedc57ef79/packages/playwright-core/src/server/utils/imageUtils.ts#L43
+    _scaleImageToSize(image, size) {
+        const { data: src, width: w1, height: h1 } = image;
+        const w2 = Math.max(1, Math.floor(size.width));
+        const h2 = Math.max(1, Math.floor(size.height));
+        if (w1 === w2 && h1 === h2) {
+            return image;
+        }
+        if (w1 <= 0 || h1 <= 0) {
+            throw new Error('Invalid input image');
+        }
+        if (size.width <= 0 ||
+            size.height <= 0 ||
+            !isFinite(size.width) ||
+            !isFinite(size.height)) {
+            throw new Error('Invalid output dimensions');
+        }
+        const clamp = (v, lo, hi) => v < lo ? lo : v > hi ? hi : v;
+        // Catmull–Rom weights
+        const weights = (t, o) => {
+            const t2 = t * t, t3 = t2 * t;
+            o[0] = -0.5 * t + 1.0 * t2 - 0.5 * t3;
+            o[1] = 1.0 - 2.5 * t2 + 1.5 * t3;
+            o[2] = 0.5 * t + 2.0 * t2 - 1.5 * t3;
+            o[3] = -0.5 * t2 + 0.5 * t3;
+        };
+        const srcRowStride = w1 * 4;
+        const dstRowStride = w2 * 4;
+        // Precompute X: indices, weights, and byte offsets (idx*4)
+        const xOff = new Int32Array(w2 * 4); // byte offsets = xIdx*4
+        const xW = new Float32Array(w2 * 4);
+        const wx = new Float32Array(4);
+        const xScale = w1 / w2;
+        for (let x = 0; x < w2; x++) {
+            const sx = (x + 0.5) * xScale - 0.5;
+            const sxi = Math.floor(sx);
+            const t = sx - sxi;
+            weights(t, wx);
+            const b = x * 4;
+            const i0 = clamp(sxi - 1, 0, w1 - 1);
+            const i1 = clamp(sxi + 0, 0, w1 - 1);
+            const i2 = clamp(sxi + 1, 0, w1 - 1);
+            const i3 = clamp(sxi + 2, 0, w1 - 1);
+            xOff[b + 0] = i0 << 2;
+            xOff[b + 1] = i1 << 2;
+            xOff[b + 2] = i2 << 2;
+            xOff[b + 3] = i3 << 2;
+            xW[b + 0] = wx[0];
+            xW[b + 1] = wx[1];
+            xW[b + 2] = wx[2];
+            xW[b + 3] = wx[3];
+        }
+        // Precompute Y: indices, weights, and row-base byte offsets (y*rowStride)
+        const yRow = new Int32Array(h2 * 4); // row base in bytes
+        const yW = new Float32Array(h2 * 4);
+        const wy = new Float32Array(4);
+        const yScale = h1 / h2;
+        for (let y = 0; y < h2; y++) {
+            const sy = (y + 0.5) * yScale - 0.5;
+            const syi = Math.floor(sy);
+            const t = sy - syi;
+            weights(t, wy);
+            const b = y * 4;
+            const j0 = clamp(syi - 1, 0, h1 - 1);
+            const j1 = clamp(syi + 0, 0, h1 - 1);
+            const j2 = clamp(syi + 1, 0, h1 - 1);
+            const j3 = clamp(syi + 2, 0, h1 - 1);
+            yRow[b + 0] = j0 * srcRowStride;
+            yRow[b + 1] = j1 * srcRowStride;
+            yRow[b + 2] = j2 * srcRowStride;
+            yRow[b + 3] = j3 * srcRowStride;
+            yW[b + 0] = wy[0];
+            yW[b + 1] = wy[1];
+            yW[b + 2] = wy[2];
+            yW[b + 3] = wy[3];
+        }
+        const dst = new Uint8Array(w2 * h2 * 4);
+        for (let y = 0; y < h2; y++) {
+            const yb = y * 4;
+            const rb0 = yRow[yb + 0], rb1 = yRow[yb + 1], rb2 = yRow[yb + 2], rb3 = yRow[yb + 3];
+            const wy0 = yW[yb + 0], wy1 = yW[yb + 1], wy2 = yW[yb + 2], wy3 = yW[yb + 3];
+            const dstBase = y * dstRowStride;
+            for (let x = 0; x < w2; x++) {
+                const xb = x * 4;
+                const xo0 = xOff[xb + 0], xo1 = xOff[xb + 1], xo2 = xOff[xb + 2], xo3 = xOff[xb + 3];
+                const wx0 = xW[xb + 0], wx1 = xW[xb + 1], wx2 = xW[xb + 2], wx3 = xW[xb + 3];
+                const di = dstBase + (x << 2);
+                // unrolled RGBA
+                for (let c = 0; c < 4; c++) {
+                    const r0 = src[rb0 + xo0 + c] * wx0 +
+                        src[rb0 + xo1 + c] * wx1 +
+                        src[rb0 + xo2 + c] * wx2 +
+                        src[rb0 + xo3 + c] * wx3;
+                    const r1 = src[rb1 + xo0 + c] * wx0 +
+                        src[rb1 + xo1 + c] * wx1 +
+                        src[rb1 + xo2 + c] * wx2 +
+                        src[rb1 + xo3 + c] * wx3;
+                    const r2 = src[rb2 + xo0 + c] * wx0 +
+                        src[rb2 + xo1 + c] * wx1 +
+                        src[rb2 + xo2 + c] * wx2 +
+                        src[rb2 + xo3 + c] * wx3;
+                    const r3 = src[rb3 + xo0 + c] * wx0 +
+                        src[rb3 + xo1 + c] * wx1 +
+                        src[rb3 + xo2 + c] * wx2 +
+                        src[rb3 + xo3 + c] * wx3;
+                    const v = r0 * wy0 + r1 * wy1 + r2 * wy2 + r3 * wy3;
+                    dst[di + c] = v < 0 ? 0 : v > 255 ? 255 : v | 0;
+                }
+            }
+        }
+        return { data: Buffer.from(dst.buffer), width: w2, height: h2 };
+    }
+    // Imported and adapter from Playwright:
+    // https://github.com/microsoft/playwright/blob/391081ed1dac7ee1ebb1ccb88c31e7e3c3dd32ba/packages/playwright/src/mcp/browser/tools/screenshot.ts#L86
+    _scaleImageToFitMessage(buffer, screenshotType) {
+        // https://docs.claude.com/en/docs/build-with-claude/vision#evaluate-image-size
+        // Not more than 1.15 megapixel, linear size not more than 1568.
+        // Additionally, we aim for max ~800KB buffer size to stay well under 1MB limit.
+        const MAX_BUFFER_SIZE = 800 * 1024; // 800KB target
+        const MAX_PIXELS = 1.15 * 1024 * 1024; // 1.15 megapixel
+        const MAX_LINEAR_SIZE = 1568;
+        const image = screenshotType === ScreenshotType.PNG
+            ? pngjs_1.PNG.sync.read(buffer)
+            : jpeg_js_1.default.decode(buffer, { maxMemoryUsageInMB: 512 });
+        const pixels = image.width * image.height;
+        // Initial shrink based on Claude's limits
+        let shrink = Math.min(MAX_LINEAR_SIZE / image.width, MAX_LINEAR_SIZE / image.height, Math.sqrt(MAX_PIXELS / pixels));
+        // If already within limits, check buffer size
+        if (shrink > 1) {
+            shrink = 1;
+        }
+        let width = (image.width * shrink) | 0;
+        let height = (image.height * shrink) | 0;
+        let scaledImage = this._scaleImageToSize(image, {
+            width,
+            height,
+        });
+        // Convert PNG to JPEG for better compression, or use lower quality JPEG
+        let result;
+        let currentType = screenshotType;
+        let quality = screenshotType === ScreenshotType.PNG ? 75 : 70;
+        if (screenshotType === ScreenshotType.PNG) {
+            // Convert PNG to JPEG for better compression (smaller file size)
+            result = jpeg_js_1.default.encode(scaledImage, quality).data;
+            currentType = ScreenshotType.JPEG;
+        }
+        else {
+            result = jpeg_js_1.default.encode(scaledImage, quality).data;
+        }
+        // Buffer size check - if still too large, apply more aggressive scaling
+        let iterations = 0;
+        const MAX_ITERATIONS = 5;
+        while (result.length > MAX_BUFFER_SIZE && iterations < MAX_ITERATIONS) {
+            // Reduce quality
+            quality = Math.max(50, quality - 10);
+            // If reducing quality is not enough, increase scaling
+            if (quality <= 50 && result.length > MAX_BUFFER_SIZE) {
+                shrink *= 0.85; // Scale down by 15%
+                width = Math.max(200, (image.width * shrink) | 0);
+                height = Math.max(200, (image.height * shrink) | 0);
+                scaledImage = this._scaleImageToSize(image, { width, height });
+            }
+            result = jpeg_js_1.default.encode(scaledImage, quality).data;
+            iterations++;
+        }
+        return result;
+    }
     async handle(context, args) {
         const screenshotType = args.type || DEFAULT_SCREENSHOT_TYPE;
         const filename = `${args.name || DEFAULT_SCREENSHOT_NAME}-${(0, utils_1.formattedTimeForFilename)()}.${screenshotType}`;
         const filePath = path_1.default.resolve(args.outputPath, filename);
+        const quality = screenshotType === ScreenshotType.PNG
+            ? undefined
+            : (args.quality ?? DEFAULT_SCREENSHOT_QUALITY);
         const options = {
             path: filePath,
             type: screenshotType,
             fullPage: !!args.fullPage,
+            quality,
         };
         if (args.selector) {
             const element = await context.page.$(args.selector);
@@ -80,7 +262,7 @@ class TakeScreenshot {
         return {
             filePath,
             image: {
-                data: screenshot,
+                data: this._scaleImageToFitMessage(screenshot, screenshotType),
                 mimeType: `image/${screenshotType}`,
             },
         };

package/dist/tools/content/take-screenshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"take-screenshot.js","sourceRoot":"","sources":["../../../src/tools/content/take-screenshot.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"take-screenshot.js","sourceRoot":"","sources":["../../../src/tools/content/take-screenshot.ts"],"names":[],"mappings":"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"}

package/dist/tools/figma/compare/compare-image-embedding.js

@@ -0,0 +1,159 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compare = compare;
+const config_1 = require("../../../config");
+const vector_1 = require("./vector");
+const client_bedrock_runtime_1 = require("@aws-sdk/client-bedrock-runtime");
+const credential_providers_1 = require("@aws-sdk/credential-providers");
+const sharp_1 = __importDefault(require("sharp"));
+/**
+ * -----------------------------------------------------------------------------
+ * Constants
+ * -----------------------------------------------------------------------------
+ */
+const DEFAULT_MAX_DIMENSION = 1024;
+const DEFAULT_JPEG_QUALITY = 90;
+const DEFAULT_AMAZON_BEDROCK_TITAN_OUTPUT_EMBEDDING_LENGTH = 1024;
+/**
+ * -----------------------------------------------------------------------------
+ * Helpers
+ * -----------------------------------------------------------------------------
+ */
+async function _prepareImage(buf, imageType, opt) {
+    let img = (0, sharp_1.default)(buf);
+    const maxDim = opt?.maxDim || DEFAULT_MAX_DIMENSION;
+    img = img.resize({
+        width: maxDim,
+        height: maxDim,
+        fit: 'inside',
+        withoutEnlargement: true,
+    });
+    if (imageType === 'png') {
+        return await img.png().toBuffer();
+    }
+    const jpegQuality = opt?.jpegQuality || DEFAULT_JPEG_QUALITY;
+    return await img.jpeg({ quality: jpegQuality }).toBuffer();
+}
+/**
+ * -----------------------------------------------------------------------------
+ * Amazon Bedrock specific embedding implementations
+ * -----------------------------------------------------------------------------
+ */
+////////////////////////////////////////////////////////////////////////////////
+const SUPPORTED_AMAZON_BEDROCK_IMAGE_EMBED_MODEL_IDS = new Set([
+    'amazon.titan-embed-image-v1',
+]);
+const DEFAULT_AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID = 'amazon.titan-embed-image-v1';
+// Cache Bedrock client so we don't re-create it for every compare call.
+let _bedrockClient = undefined;
+function _isAwsBedrockActive() {
+    // Minimal "is Bedrock usable?" check:
+    // - Amazon Bedrock must be enabled
+    // - Region must exist
+    // - Credentials are resolved by AWS SDK default chain or AWS_PROFILE
+    return config_1.AMAZON_BEDROCK_ENABLE && Boolean(config_1.AWS_REGION);
+}
+function _getOrCreateBedrockClient() {
+    if (_bedrockClient) {
+        return _bedrockClient;
+    }
+    const region = config_1.AWS_REGION;
+    if (!region) {
+        return undefined;
+    }
+    const profile = config_1.AWS_PROFILE;
+    if (profile) {
+        _bedrockClient = new client_bedrock_runtime_1.BedrockRuntimeClient({
+            region,
+            credentials: (0, credential_providers_1.fromIni)({ profile }),
+        });
+        return _bedrockClient;
+    }
+    _bedrockClient = new client_bedrock_runtime_1.BedrockRuntimeClient({ region });
+    return _bedrockClient;
+}
+async function _embedImageWithAmazonBedrockTitan(ss, client, opt, modelId) {
+    const image = await _prepareImage(ss.image, ss.type, opt);
+    const bodyObj = {
+        inputImage: image.toString('base64'),
+        // Optional but recommended: control embedding length
+        embeddingConfig: {
+            outputEmbeddingLength: DEFAULT_AMAZON_BEDROCK_TITAN_OUTPUT_EMBEDDING_LENGTH,
+        },
+    };
+    const cmd = new client_bedrock_runtime_1.InvokeModelCommand({
+        modelId, // should be 'amazon.titan-embed-image-v1' (or with :0 if your account uses that)
+        contentType: 'application/json',
+        accept: 'application/json',
+        body: Buffer.from(JSON.stringify(bodyObj), 'utf-8'),
+    });
+    const resp = await client.send(cmd);
+    const raw = resp?.body instanceof Uint8Array
+        ? resp.body
+        : new Uint8Array(resp?.body ?? []);
+    const text = Buffer.from(raw).toString('utf-8');
+    let parsed;
+    try {
+        parsed = text ? JSON.parse(text) : {};
+    }
+    catch (e) {
+        throw new Error(`Amazon Bedrock Titan returned non-JSON response for embeddings: ${text.slice(0, 300)}`);
+    }
+    const emb = parsed?.embedding ??
+        parsed?.embeddings?.[0] ??
+        parsed?.outputEmbedding ??
+        parsed?.vector;
+    if (!Array.isArray(emb) || emb.length === 0 || typeof emb[0] !== 'number') {
+        throw new Error(`Unexpected Amazon Bedrock Titan image embedding response format: ${text.slice(0, 500)}`);
+    }
+    return emb;
+}
+async function _embedImageWithAmazonBedrock(ss, opt, client) {
+    const modelId = opt?.modelId ??
+        config_1.AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID ??
+        DEFAULT_AMAZON_BEDROCK_IMAGE_EMBED_MODEL_ID;
+    if (!SUPPORTED_AMAZON_BEDROCK_IMAGE_EMBED_MODEL_IDS.has(modelId)) {
+        throw new Error(`Unsupported Amazon Bedrock image embedding model id: ${modelId}`);
+    }
+    return await _embedImageWithAmazonBedrockTitan(ss, client, opt, modelId);
+}
+////////////////////////////////////////////////////////////////////////////////
+/**
+ * -----------------------------------------------------------------------------
+ * Routing (LLM-agnostic)
+ * -----------------------------------------------------------------------------
+ */
+async function _embedImage(ss, opt) {
+    // Provider A: Amazon Bedrock
+    if (_isAwsBedrockActive()) {
+        const client = _getOrCreateBedrockClient();
+        if (!client) {
+            return undefined;
+        }
+        return _embedImageWithAmazonBedrock(ss, opt, client);
+    }
+    // No providers active
+    return undefined;
+}
+/**
+ * -----------------------------------------------------------------------------
+ * Public API
+ * -----------------------------------------------------------------------------
+ */
+async function compare(page, figma, options) {
+    const normalize = typeof options?.normalize === 'boolean' ? options.normalize : true;
+    const figmaVec = await _embedImage(figma, options);
+    if (!figmaVec) {
+        return undefined;
+    }
+    const pageVec = await _embedImage(page, options);
+    if (!pageVec) {
+        return undefined;
+    }
+    const score = (0, vector_1.cosineSimilarity)(figmaVec, pageVec, normalize);
+    return { score };
+}
+//# sourceMappingURL=compare-image-embedding.js.map

package/dist/tools/figma/compare/compare-image-embedding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-image-embedding.js","sourceRoot":"","sources":["../../../../src/tools/figma/compare/compare-image-embedding.ts"],"names":[],"mappings":"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"}

package/dist/tools/figma/compare/compare-mssim.js

@@ -0,0 +1,98 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compare = compare;
+const sharp_1 = __importDefault(require("sharp"));
+const ssim_js_1 = __importDefault(require("ssim.js"));
+const DEFAULT_GRAYSCALE = false;
+const DEFAULT_BLUR = 10;
+function _clamp01(v) {
+    if (!Number.isFinite(v)) {
+        return 0;
+    }
+    return Math.max(0, Math.min(1, v));
+}
+/**
+ * Loads an image buffer and normalizes it into the SAME CANVAS SIZE using fit='contain'
+ * (no stretching). This matters a lot for UI screenshots:
+ * stretching (fit='fill') can destroy SSIM even when layouts are similar.
+ *
+ * Modes:
+ * - raw:    normalize only (contain + padding), then raw RGBA
+ * - semantic: normalize + downscale + grayscale + blur(1) to suppress data/text noise
+ */
+async function _loadNormalized(input, canvasWidth, canvasHeight, mode) {
+    let img;
+    if (mode === 'semantic') {
+        img = (0, sharp_1.default)(input).resize(canvasWidth, canvasHeight, {
+            fit: 'cover',
+            position: 'centre',
+        });
+        const w = Math.max(1, Math.floor(canvasWidth / 2));
+        const h = Math.max(1, Math.floor(canvasHeight / 2));
+        img = img
+            .resize(w, h, {
+            fit: 'cover',
+            position: 'centre',
+        })
+            // Enabling grayscale increases false positives
+            .grayscale(DEFAULT_GRAYSCALE)
+            .blur(DEFAULT_BLUR);
+    }
+    else {
+        img = (0, sharp_1.default)(input).resize(canvasWidth, canvasHeight, {
+            fit: 'cover',
+            position: 'centre',
+        });
+    }
+    const out = await img
+        .ensureAlpha()
+        .raw()
+        .toBuffer({ resolveWithObject: true });
+    const clamped = new Uint8ClampedArray(out.data.buffer, out.data.byteOffset, out.data.byteLength);
+    return {
+        data: clamped,
+        width: out.info.width,
+        height: out.info.height,
+    };
+}
+function _computeSsim(a, b) {
+    const details = (0, ssim_js_1.default)({ data: a.data, width: a.width, height: a.height }, { data: b.data, width: b.width, height: b.height });
+    // Some builds expose `mssim`, some `ssim`.
+    const rawScore = Number(details.mssim ?? details.ssim ?? 0);
+    return _clamp01(rawScore);
+}
+/**
+ * Compares a page screenshot against a Figma design screenshot using MSSIM.
+ *
+ * Notes:
+ * - Uses Figma dimensions as the reference canvas by default (unless overridden).
+ * - Normalizes both images into the same canvas using contain+padding (no stretching).
+ * - 'semantic' mode suppresses data/text noise and focuses more on layout structure.
+ */
+async function compare(page, figma, options) {
+    const mode = options?.mode ?? 'semantic';
+    let canvasWidth = options?.canvasWidth;
+    let canvasHeight = options?.canvasHeight;
+    if (typeof canvasWidth !== 'number' ||
+        !Number.isFinite(canvasWidth) ||
+        canvasWidth <= 0 ||
+        typeof canvasHeight !== 'number' ||
+        !Number.isFinite(canvasHeight) ||
+        canvasHeight <= 0) {
+        // Use the Figma image dimensions as the reference canvas.
+        const figmaMeta = await (0, sharp_1.default)(figma.image).metadata();
+        canvasWidth = figmaMeta.width ?? 0;
+        canvasHeight = figmaMeta.height ?? 0;
+        if (canvasWidth <= 0 || canvasHeight <= 0) {
+            throw new Error('Failed to read Figma image dimensions.');
+        }
+    }
+    const figmaImg = await _loadNormalized(figma.image, canvasWidth, canvasHeight, mode);
+    const pageImg = await _loadNormalized(page.image, canvasWidth, canvasHeight, mode);
+    const score = _computeSsim(figmaImg, pageImg);
+    return { score };
+}
+//# sourceMappingURL=compare-mssim.js.map

package/dist/tools/figma/compare/compare-mssim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-mssim.js","sourceRoot":"","sources":["../../../../src/tools/figma/compare/compare-mssim.ts"],"names":[],"mappings":"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"}