@mp3wizard/figma-console-mcp 1.22.5 → 1.23.1

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

@@ -33,26 +33,32 @@ export class WebSocketConnector {
         return this.wsServer.sendCommand('GET_VARIABLES_DATA', {}, 10000, fileKey);
     }
     async getVariables(fileKey) {
-        // Execute the same variables-fetching code in the plugin worker context
+        // Execute the same variables-fetching code in the plugin worker context.
+        //
+        // IMPORTANT: Do NOT wrap this in an inner `(async () => { ... })()` IIFE.
+        // figma-desktop-bridge/code.js already wraps every EXECUTE_CODE payload in
+        // `(async function() { <code> })()`. An inner IIFE turns `return X` into a
+        // statement-expression that builds (but doesn't return) a Promise — the
+        // outer async returns undefined, and the result is silently dropped. See
+        // issue #68. The bare try/catch with top-level `return` is the contract
+        // code.js expects.
         const code = `
-      (async () => {
-        try {
-          if (typeof figma === 'undefined') {
-            throw new Error('Figma API not available in this context');
-          }
-          const variables = await figma.variables.getLocalVariablesAsync();
-          const collections = await figma.variables.getLocalVariableCollectionsAsync();
-          return {
-            success: true,
-            timestamp: Date.now(),
-            fileMetadata: { fileName: figma.root.name, fileKey: figma.fileKey || null },
-            variables: variables.map(function(v) { return { id: v.id, name: v.name, key: v.key, resolvedType: v.resolvedType, valuesByMode: v.valuesByMode, variableCollectionId: v.variableCollectionId, scopes: v.scopes, description: v.description, hiddenFromPublishing: v.hiddenFromPublishing }; }),
-            variableCollections: collections.map(function(c) { return { id: c.id, name: c.name, key: c.key, modes: c.modes, defaultModeId: c.defaultModeId, variableIds: c.variableIds }; })
-          };
-        } catch (error) {
-          return { success: false, error: error.message };
+      try {
+        if (typeof figma === 'undefined') {
+          throw new Error('Figma API not available in this context');
         }
-      })()
+        const variables = await figma.variables.getLocalVariablesAsync();
+        const collections = await figma.variables.getLocalVariableCollectionsAsync();
+        return {
+          success: true,
+          timestamp: Date.now(),
+          fileMetadata: { fileName: figma.root.name, fileKey: figma.fileKey || null },
+          variables: variables.map(function(v) { return { id: v.id, name: v.name, key: v.key, resolvedType: v.resolvedType, valuesByMode: v.valuesByMode, variableCollectionId: v.variableCollectionId, scopes: v.scopes, description: v.description, hiddenFromPublishing: v.hiddenFromPublishing }; }),
+          variableCollections: collections.map(function(c) { return { id: c.id, name: c.name, key: c.key, modes: c.modes, defaultModeId: c.defaultModeId, variableIds: c.variableIds }; })
+        };
+      } catch (error) {
+        return { success: false, error: error.message };
+      }
     `;
         return this.wsServer.sendCommand('EXECUTE_CODE', { code, timeout: 30000 }, 32000, fileKey);
     }

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.0",
+            version: "1.23.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.0",
+                version: "1.23.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.0",
+                version: "1.23.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));
@@ -2180,7 +2154,11 @@ const codeSpecSchema = z.object({
         semanticElement: z.string().optional().describe("Semantic HTML element (e.g., 'button', 'a', 'input')"),
         supportsDisabled: z.boolean().optional().describe("Whether code supports disabled/aria-disabled state"),
         supportsError: z.boolean().optional().describe("Whether code supports aria-invalid/error state"),
-        renderedSize: z.tuple([z.number(), z.number()]).optional().describe("Rendered size [width, height] in px"),
+        // NOTE: Use array-with-length, NOT z.tuple — tuples emit JSON Schema `items: [...]`
+        // (array of schemas), which Gemini's stricter Function Calling validator rejects with
+        // "is not of type 'object', 'boolean'". See issue #64. A constrained array emits
+        // `items: { type: 'number' }` which all major MCP clients accept.
+        renderedSize: z.array(z.number()).min(2).max(2).optional().describe("Rendered size [width, height] in px"),
     }).optional().describe("Accessibility properties from code. Tip: use figma_scan_code_accessibility with mapToCodeSpec:true to auto-generate this from component HTML."),
     metadata: z.object({
         name: z.string().optional(),
@@ -2350,16 +2328,22 @@ export function registerDesignCodeTools(server, getFigmaAPI, getCurrentUrl, vari
                     logger.warn("Enrichment failed, proceeding without token data");
                 }
             }
+            // Cast to the structural CodeSpec interface. The Zod schema infers
+            // `accessibility.renderedSize` as `number[]` (post-#64 fix uses
+            // `z.array(z.number()).min(2).max(2)` for Gemini compat), but at runtime
+            // the validator guarantees exactly two numbers, matching CodeSpec's
+            // `[number, number]`. TypeScript can't bridge the inference gap.
+            const codeSpecTyped = codeSpec;
             // Run all comparators (use nodeForVisual for design properties, nodeForAPI for component API)
             const discrepancies = [];
-            compareVisual(nodeForVisual, codeSpec, discrepancies);
-            compareSpacing(nodeForVisual, codeSpec, discrepancies);
-            compareTypography(nodeForVisual, codeSpec, discrepancies);
-            compareTokens(enrichedData, codeSpec, discrepancies);
-            compareComponentAPI(nodeForAPI, codeSpec, discrepancies);
-            compareAccessibility(node, codeSpec, discrepancies);
-            compareNaming(node, codeSpec, discrepancies);
-            compareMetadata(node, componentMeta, codeSpec, discrepancies);
+            compareVisual(nodeForVisual, codeSpecTyped, discrepancies);
+            compareSpacing(nodeForVisual, codeSpecTyped, discrepancies);
+            compareTypography(nodeForVisual, codeSpecTyped, discrepancies);
+            compareTokens(enrichedData, codeSpecTyped, discrepancies);
+            compareComponentAPI(nodeForAPI, codeSpecTyped, discrepancies);
+            compareAccessibility(node, codeSpecTyped, discrepancies);
+            compareNaming(node, codeSpecTyped, discrepancies);
+            compareMetadata(node, componentMeta, codeSpecTyped, discrepancies);
             // Sort by severity
             const severityOrder = {
                 critical: 0,
@@ -2410,7 +2394,7 @@ export function registerDesignCodeTools(server, getFigmaAPI, getCurrentUrl, vari
                         : [],
                     tokenCoverage: enrichedData?.token_coverage,
                 },
-                codeData: codeSpec,
+                codeData: codeSpecTyped,
             };
             return {
                 content: [{ type: "text", text: JSON.stringify(result) }],