@mp3wizard/figma-console-mcp 1.22.6 → 1.25.1

package/dist/cloudflare/core/websocket-server.js

@@ -335,6 +335,34 @@ export class FigmaWebSocketServer extends EventEmitter {
                 }
                 this.emit('documentChange', { fileKey: found?.fileKey ?? null, ...message.data });
             }
+            // v1.25.0: buffer description/annotation changes for the specific file.
+            // These are the diff-engine blind spots that Figma REST doesn't expose;
+            // the diff engine consults this buffer when correlating to a version
+            // range, so changes made while the plugin was connected become visible.
+            if (message.type === 'METADATA_CHANGE' && message.data) {
+                const found = this.findClientByWs(ws);
+                if (found) {
+                    const changes = Array.isArray(message.data.changes) ? message.data.changes : [];
+                    for (const c of changes) {
+                        if (!c || typeof c.node_id !== 'string' || !c.field)
+                            continue;
+                        const entry = {
+                            node_id: c.node_id,
+                            node_name: c.node_name ?? null,
+                            node_type: c.node_type ?? null,
+                            field: c.field === 'annotations' ? 'annotations' : 'description',
+                            new_value: c.new_value,
+                            timestamp: typeof c.timestamp === 'number' ? c.timestamp : Date.now(),
+                        };
+                        found.client.metadataChanges.push(entry);
+                        if (found.client.metadataChanges.length > this.documentChangeBufferSize) {
+                            found.client.metadataChanges.shift();
+                        }
+                    }
+                    found.client.lastActivity = Date.now();
+                }
+                this.emit('metadataChange', { fileKey: found?.fileKey ?? null, changes: message.data.changes });
+            }
             // Track selection changes — user interaction makes this the active file
             if (message.type === 'SELECTION_CHANGE' && message.data) {
                 const found = this.findClientByWs(ws);
@@ -436,6 +464,7 @@ export class FigmaWebSocketServer extends EventEmitter {
             },
             selection: existing?.selection || null,
             documentChanges: existing?.documentChanges || [],
+            metadataChanges: existing?.metadataChanges || [],
             consoleLogs: existing?.consoleLogs || [],
             lastActivity: Date.now(),
             lastPongAt: Date.now(),
@@ -661,6 +690,49 @@ export class FigmaWebSocketServer extends EventEmitter {
         client.documentChanges = [];
         return count;
     }
+    /**
+     * v1.25.0: Get buffered description/annotation change events for a file.
+     *
+     * Used by `figma_diff_versions` to surface changes that Figma REST doesn't
+     * expose. The diff engine passes a time window (from-version → to-version
+     * `last_modified` timestamps converted to Unix ms) and optional scoping by
+     * node IDs.
+     *
+     * Defaults to the active file if `fileKey` is omitted.
+     */
+    getMetadataChanges(options) {
+        const fileKey = options?.fileKey ?? this._activeFileKey;
+        if (!fileKey)
+            return [];
+        const client = this.clients.get(fileKey);
+        if (!client)
+            return [];
+        let filtered = [...client.metadataChanges];
+        if (options?.since !== undefined) {
+            filtered = filtered.filter((e) => e.timestamp >= options.since);
+        }
+        if (options?.until !== undefined) {
+            filtered = filtered.filter((e) => e.timestamp <= options.until);
+        }
+        if (options?.nodeIds && options.nodeIds.length > 0) {
+            const set = new Set(options.nodeIds);
+            filtered = filtered.filter((e) => set.has(e.node_id));
+        }
+        return filtered;
+    }
+    /**
+     * v1.25.0: Clear metadata-change buffer for the active file.
+     */
+    clearMetadataChanges() {
+        if (!this._activeFileKey)
+            return 0;
+        const client = this.clients.get(this._activeFileKey);
+        if (!client)
+            return 0;
+        const count = client.metadataChanges.length;
+        client.metadataChanges = [];
+        return count;
+    }
     /**
      * Get console logs from the active file with optional filtering
      */

package/dist/cloudflare/index.js

@@ -20,6 +20,7 @@ import { FigmaAPI, extractFileKey } from "./core/figma-api.js";
 import { registerFigmaAPITools } from "./core/figma-tools.js";
 import { registerDesignCodeTools } from "./core/design-code-tools.js";
 import { registerCommentTools } from "./core/comment-tools.js";
+import { registerVersionTools } from "./core/version-tools.js";
 import { registerAnnotationTools } from "./core/annotation-tools.js";
 import { registerDeepComponentTools } from "./core/deep-component-tools.js";
 import { registerDesignSystemTools } from "./core/design-system-tools.js";
@@ -69,7 +70,7 @@ export class FigmaConsoleMCPv3 extends McpAgent {
         super(...arguments);
         this.server = new McpServer({
             name: "Figma Console MCP",
-            version: "1.22.4",
+            version: "1.25.0",
         });
         this.browserManager = null;
         this.consoleMonitor = null;
@@ -793,6 +794,8 @@ export class FigmaConsoleMCPv3 extends McpAgent {
         { isRemoteMode: true }, getCloudDesktopConnector);
         // Register Comment tools
         registerCommentTools(this.server, async () => await this.getFigmaAPI(), () => this.browserManager?.getCurrentUrl() || null, { isRemoteMode: true });
+        // Register Version History tools
+        registerVersionTools(this.server, async () => await this.getFigmaAPI(), () => this.browserManager?.getCurrentUrl() || null, { isRemoteMode: true });
         // Register Design System Kit tool
         registerDesignSystemTools(this.server, async () => await this.getFigmaAPI(), () => this.browserManager?.getCurrentUrl() || null, undefined, // variablesCache
         { isRemoteMode: true });
@@ -1055,7 +1058,7 @@ export default {
             });
             const statelessServer = new McpServer({
                 name: "Figma Console MCP",
-                version: "1.22.4",
+                version: "1.25.0",
             });
             // ================================================================
             // Cloud Write Relay — Pairing Tool (stateless /mcp path)
@@ -1151,6 +1154,7 @@ export default {
             registerDesignCodeTools(statelessServer, async () => statelessApi, getCloudFileUrl, new Map(), // Fresh variables cache per request
             { isRemoteMode: true }, getCloudDesktopConnector);
             registerCommentTools(statelessServer, async () => statelessApi, getCloudFileUrl);
+            registerVersionTools(statelessServer, async () => statelessApi, getCloudFileUrl);
             registerDesignSystemTools(statelessServer, async () => statelessApi, getCloudFileUrl, new Map(), // Fresh variables cache per request
             { isRemoteMode: true });
             await statelessServer.connect(transport);
@@ -1172,7 +1176,7 @@ export default {
             const metadata = {
                 resource: url.origin,
                 authorization_servers: [`${url.origin}/`],
-                scopes_supported: ["file_content:read", "file_variables:read", "library_content:read"],
+                scopes_supported: ["file_content:read", "file_versions:read", "file_variables:read", "file_comments:read", "file_comments:write", "library_content:read"],
                 bearer_methods_supported: ["header"],
                 resource_signing_alg_values_supported: ["RS256"]
             };
@@ -1191,7 +1195,7 @@ export default {
                 authorization_endpoint: `${url.origin}/authorize`,
                 token_endpoint: `${url.origin}/token`,
                 registration_endpoint: `${url.origin}/oauth/register`,
-                scopes_supported: ["file_content:read", "file_variables:read", "library_content:read"],
+                scopes_supported: ["file_content:read", "file_versions:read", "file_variables:read", "file_comments:read", "file_comments:write", "library_content:read"],
                 response_types_supported: ["code"],
                 grant_types_supported: ["authorization_code", "refresh_token"],
                 token_endpoint_auth_methods_supported: ["client_secret_basic", "client_secret_post"],
@@ -1254,7 +1258,7 @@ export default {
             const figmaAuthUrl = new URL("https://www.figma.com/oauth");
             figmaAuthUrl.searchParams.set("client_id", env.FIGMA_OAUTH_CLIENT_ID);
             figmaAuthUrl.searchParams.set("redirect_uri", `${oauthOrigin}/oauth/callback`);
-            figmaAuthUrl.searchParams.set("scope", "file_content:read,file_variables:read,library_content:read");
+            figmaAuthUrl.searchParams.set("scope", "file_content:read,file_versions:read,file_variables:read,file_comments:read,file_comments:write,library_content:read");
             figmaAuthUrl.searchParams.set("state", stateToken);
             figmaAuthUrl.searchParams.set("response_type", "code");
             return Response.redirect(figmaAuthUrl.toString(), 302);
@@ -1295,7 +1299,7 @@ export default {
                         token_type: "Bearer",
                         expires_in: Math.max(0, Math.floor((tokenData.expiresAt - Date.now()) / 1000)),
                         refresh_token: tokenData.refreshToken,
-                        scope: "file_content:read file_variables:read library_content:read"
+                        scope: "file_content:read file_versions:read file_variables:read file_comments:read file_comments:write library_content:read"
                     }), {
                         headers: {
                             "Content-Type": "application/json",
@@ -1372,7 +1376,7 @@ export default {
                     token_type: "Bearer",
                     expires_in: tokenData.expires_in,
                     refresh_token: tokenData.refresh_token || refreshToken,
-                    scope: "file_content:read file_variables:read library_content:read"
+                    scope: "file_content:read file_versions:read file_variables:read file_comments:read file_comments:write library_content:read"
                 }), {
                     headers: {
                         "Content-Type": "application/json",
@@ -1444,7 +1448,7 @@ export default {
             const figmaAuthUrl = new URL("https://www.figma.com/oauth");
             figmaAuthUrl.searchParams.set("client_id", env.FIGMA_OAUTH_CLIENT_ID);
             figmaAuthUrl.searchParams.set("redirect_uri", redirectUri);
-            figmaAuthUrl.searchParams.set("scope", "file_content:read,file_variables:read,library_content:read");
+            figmaAuthUrl.searchParams.set("scope", "file_content:read,file_versions:read,file_variables:read,file_comments:read,file_comments:write,library_content:read");
             figmaAuthUrl.searchParams.set("state", stateToken);
             figmaAuthUrl.searchParams.set("response_type", "code");
             return Response.redirect(figmaAuthUrl.toString(), 302);
@@ -1690,7 +1694,7 @@ export default {
             return new Response(JSON.stringify({
                 status: "healthy",
                 service: "Figma Console MCP",
-                version: "1.22.4",
+                version: "1.25.0",
                 endpoints: {
                     mcp: ["/sse", "/mcp"],
                     oauth_mcp_spec: ["/.well-known/oauth-authorization-server", "/authorize", "/token", "/oauth/register"],
@@ -1736,13 +1740,13 @@ export default {
 	<meta name="viewport" content="width=device-width, initial-scale=1.0">
 	<title>Figma Console MCP - The Most Comprehensive MCP Server for Figma</title>
 	<link rel="icon" type="image/svg+xml" href="https://docs.figma-console-mcp.southleft.com/favicon.svg">
-	<meta name="description" content="Turn your Figma design system into a living API. 94+ tools give AI assistants deep access to design tokens, component specs, variables, and programmatic design creation.">
+	<meta name="description" content="Turn your Figma design system into a living API. 100+ tools give AI assistants deep access to design tokens, component specs, variables, and programmatic design creation.">
 
 	<!-- Open Graph -->
 	<meta property="og:type" content="website">
 	<meta property="og:url" content="https://figma-console-mcp.southleft.com">
 	<meta property="og:title" content="Figma Console MCP - Turn Your Design System Into a Living API">
-	<meta property="og:description" content="The most comprehensive MCP server for Figma. 94+ tools give AI assistants deep access to design tokens, components, variables, and programmatic design creation.">
+	<meta property="og:description" content="The most comprehensive MCP server for Figma. 100+ tools give AI assistants deep access to design tokens, components, variables, and programmatic design creation.">
 	<meta property="og:image" content="https://docs.figma-console-mcp.southleft.com/images/og-image.jpg">
 	<meta property="og:image:width" content="1200">
 	<meta property="og:image:height" content="630">
@@ -1750,7 +1754,7 @@ export default {
 	<!-- Twitter -->
 	<meta name="twitter:card" content="summary_large_image">
 	<meta name="twitter:title" content="Figma Console MCP - Turn Your Design System Into a Living API">
-	<meta name="twitter:description" content="The most comprehensive MCP server for Figma. 94+ tools give AI assistants deep access to design tokens, components, variables, and programmatic design creation.">
+	<meta name="twitter:description" content="The most comprehensive MCP server for Figma. 100+ tools give AI assistants deep access to design tokens, components, variables, and programmatic design creation.">
 	<meta name="twitter:image" content="https://docs.figma-console-mcp.southleft.com/images/og-image.jpg">
 
 	<meta name="theme-color" content="#0D9488">
@@ -2637,7 +2641,7 @@ export default {
 			<div class="grid-cell showcase-cell rule-left">
 				<div class="showcase-label">What AI Can Access</div>
 				<div class="showcase-stat">
-					<span class="number">94+</span>
+					<span class="number">100+</span>
 					<span class="label">MCP tools for Figma</span>
 				</div>
 				<div class="capability-list">

package/dist/core/design-code-tools.d.ts

@@ -6,17 +6,7 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { FigmaAPI } from "./figma-api.js";
 import type { CompanyDocsContentEntry } from "./types/design-code.js";
-/** Convert Figma RGBA (0-1 floats) to hex string */
-export declare function figmaRGBAToHex(color: {
-    r: number;
-    g: number;
-    b: number;
-    a?: number;
-}): string;
-/** Normalize a color string for comparison (uppercase hex without alpha if fully opaque) */
-export declare function normalizeColor(color: string): string;
-/** Compare numeric values with a tolerance */
-export declare function numericClose(a: number, b: number, tolerance?: number): boolean;
+export { figmaRGBAToHex, normalizeColor, numericClose } from "./diff/property-compare.js";
 /** Calculate parity score from discrepancy counts */
 export declare function calculateParityScore(critical: number, major: number, minor: number, info: number): number;
 /** Split markdown by H2 headers for platforms that need chunking */
@@ -123,5 +113,4 @@ export declare function registerDesignCodeTools(server: McpServer, getFigmaAPI:
 }>, options?: {
     isRemoteMode?: boolean;
 }, getDesktopConnector?: () => Promise<any>): void;
-export {};
 //# sourceMappingURL=design-code-tools.d.ts.map

package/dist/core/design-code-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"design-code-tools.d.ts","sourceRoot":"","sources":["../../src/core/design-code-tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"design-code-tools.d.ts","sourceRoot":"","sources":["../../src/core/design-code-tools.ts"],"names":[],"mappings":"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"}

package/dist/core/design-code-tools.js

@@ -12,35 +12,9 @@ const enrichmentService = new EnrichmentService(logger);
 // ============================================================================
 // Shared Helpers
 // ============================================================================
-/** Convert Figma RGBA (0-1 floats) to hex string */
-export function figmaRGBAToHex(color) {
-    const r = Math.round(color.r * 255);
-    const g = Math.round(color.g * 255);
-    const b = Math.round(color.b * 255);
-    const hex = `#${r.toString(16).padStart(2, "0")}${g.toString(16).padStart(2, "0")}${b.toString(16).padStart(2, "0")}`.toUpperCase();
-    if (color.a !== undefined && color.a < 1) {
-        const a = Math.round(color.a * 255);
-        return `${hex}${a.toString(16).padStart(2, "0")}`;
-    }
-    return hex;
-}
-/** Normalize a color string for comparison (uppercase hex without alpha if fully opaque) */
-export function normalizeColor(color) {
-    let c = color.trim().toUpperCase();
-    // Strip alpha if fully opaque (FF)
-    if (c.length === 9 && c.endsWith("FF")) {
-        c = c.slice(0, 7);
-    }
-    // Expand shorthand (#RGB -> #RRGGBB)
-    if (/^#[0-9A-F]{3}$/.test(c)) {
-        c = `#${c[1]}${c[1]}${c[2]}${c[2]}${c[3]}${c[3]}`;
-    }
-    return c;
-}
-/** Compare numeric values with a tolerance */
-export function numericClose(a, b, tolerance = 1) {
-    return Math.abs(a - b) <= tolerance;
-}
+// Re-exported from the shared diff module so existing imports continue to work.
+export { figmaRGBAToHex, normalizeColor, numericClose } from "./diff/property-compare.js";
+import { figmaRGBAToHex, normalizeColor, numericClose } from "./diff/property-compare.js";
 /** Calculate parity score from discrepancy counts */
 export function calculateParityScore(critical, major, minor, info) {
     return Math.max(0, 100 - (critical * 15 + major * 8 + minor * 3 + info * 1));