@mp3wizard/figma-console-mcp 1.23.1 → 1.27.2

package/dist/cloudflare/core/version-tools.js

@@ -79,10 +79,15 @@ const MAX_SCAN_PAGES = 20;
 const FIGMA_PAGE_SIZE_MAX = 50;
 // Tool-level cap on max_versions; design brief §4.
 const MAX_VERSIONS_HARD_CAP = 200;
-// ============================================================================
-// Tool Registration
-// ============================================================================
-export function registerVersionTools(server, getFigmaAPI, getCurrentUrl, _options, getCurrentSelectedNodeIds) {
+export function registerVersionTools(server, getFigmaAPI, getCurrentUrl, _options, getCurrentSelectedNodeIds, 
+/**
+ * v1.25.0: optional metadata-change buffer reader. When wired (local mode),
+ * the diff engine consults this to surface description/annotation edits
+ * that Figma REST doesn't expose. In cloud mode (no plugin buffer
+ * available), this stays undefined and the diff just doesn't surface
+ * those edits — but scope_coverage still tells callers about the gap.
+ */
+getMetadataChanges) {
     // Helper: read the current Figma selection as a list of node IDs, or null
     // if no selection getter is wired (cloud mode) or selection is empty.
     const readSelection = () => {
@@ -91,6 +96,13 @@ export function registerVersionTools(server, getFigmaAPI, getCurrentUrl, _option
         const ids = getCurrentSelectedNodeIds();
         return ids && ids.length > 0 ? ids : null;
     };
+    // v1.25.0: convert an ISO8601 timestamp to Unix ms. Tolerates missing input.
+    const toUnixMs = (iso) => {
+        if (!iso)
+            return null;
+        const t = Date.parse(iso);
+        return Number.isFinite(t) ? t : null;
+    };
     // -----------------------------------------------------------------------
     // Tool: figma_get_file_versions
     // -----------------------------------------------------------------------
@@ -435,14 +447,80 @@ export function registerVersionTools(server, getFigmaAPI, getCurrentUrl, _option
             }
             const fromMeta = extractFileMeta(fromFile.data, from_version);
             const toMeta = extractFileMeta(toFile.data, to_version);
+            // v1.25.0: query the plugin metadata buffer for description/annotation
+            // changes within the diff's time window. The buffer is only populated
+            // when the Desktop Bridge plugin was connected during the edit — so
+            // edits made offline (or before this MCP session started) won't appear.
+            // That limit is surfaced in scope_coverage + notes.
+            const fromMs = toUnixMs(fromMeta.last_modified) ?? undefined;
+            const toMs = toUnixMs(toMeta.last_modified) ?? Date.now();
+            let bufferedMetadata = [];
+            let metadataBufferAvailable = false;
+            let unscopedMetadataChanges = [];
+            if (getMetadataChanges) {
+                metadataBufferAvailable = true;
+                try {
+                    bufferedMetadata = getMetadataChanges({
+                        fileKey,
+                        since: fromMs,
+                        until: toMs,
+                    });
+                }
+                catch (e) {
+                    logger.warn({ err: e }, "Metadata buffer lookup failed; continuing without metadata changes");
+                    bufferedMetadata = [];
+                }
+            }
+            // Attach buffer entries to the scoped node diffs whose id matches.
+            // Entries that don't match any scoped id surface separately so the
+            // caller can still see "the buffer has 3 description edits on nodes
+            // you didn't ask about" instead of dropping them on the floor.
+            if (bufferedMetadata.length > 0) {
+                const scopedById = new Map(scoped.map((n) => [n.node_id, n]));
+                const consumed = new Set();
+                for (const entry of bufferedMetadata) {
+                    const target = scopedById.get(entry.node_id);
+                    if (target) {
+                        (target.metadata_changes ??= []).push({
+                            field: entry.field,
+                            new_value: entry.new_value,
+                            timestamp: entry.timestamp,
+                            source: "plugin_buffer",
+                        });
+                        target.change_count += 1;
+                        consumed.add(entry);
+                    }
+                }
+                unscopedMetadataChanges = bufferedMetadata.filter((e) => !consumed.has(e));
+            }
             const notes = [];
-            if (!component_ids || component_ids.length === 0) {
+            const hasScopedNodes = !!(component_ids && component_ids.length > 0);
+            if (!hasScopedNodes) {
                 notes.push("Only page-structure diff returned. Pass component_ids to get per-component analysis (added/removed children, property changes, binding changes), or have a node selected in Figma when you call.");
             }
             if (usedSelection) {
                 notes.push(`Auto-scoped to ${component_ids?.length ?? 0} node(s) from the current Figma selection. Pass component_ids explicitly to override.`);
             }
+            // Always-on coverage warnings — the failure mode we're guarding against is
+            // the user (or an AI client) believing "no changes found" means "nothing
+            // changed," when in fact the change is in a category this tool doesn't
+            // track. Better to be loud about limits than silently miss real edits.
+            if (hasScopedNodes) {
+                notes.push("Component-scoped diff covers the canonical components only. INSTANCES of these components placed elsewhere on the canvas (documentation examples, hero frames, mockups) are NOT diffed. For forensic per-session edits including instance changes, use figma_get_design_changes. To diff a specific instance, pass its node ID explicitly.");
+            }
+            notes.push("Raw layout/visual properties are NOT tracked. This includes layoutSizingHorizontal/Vertical (hug vs. fill), primaryAxisSizingMode/counterAxisSizingMode, raw paddings/widths/cornerRadius when not bound to a variable, and unbound fills/strokes/effects. This tool surfaces structural deltas (children, property defs, name, description) and variable-BINDING deltas only.");
             notes.push("Variable VALUE history is not retrievable from Figma REST API. Variable definition value changes between these versions are not represented; only binding-reference changes on scoped nodes are detected.");
+            // v1.25.0: surface metadata-buffer state. Either "tracked via plugin buffer"
+            // (and any limits) or "not tracked at all" (cloud mode / plugin absent).
+            if (metadataBufferAvailable) {
+                notes.push("Description and annotation changes ARE tracked when the Desktop Bridge plugin was connected during the edit. They appear under each node's metadata_changes[]. Edits made while the plugin was disconnected (or before this MCP session started) WON'T appear in the buffer — the diff will silently miss them.");
+                if (bufferedMetadata.length === 0) {
+                    notes.push("No description or annotation changes were captured by the plugin buffer in this version window. Either no such edits happened, or they occurred while the plugin was disconnected.");
+                }
+            }
+            else {
+                notes.push("Description and annotation changes are NOT being tracked — no metadata buffer is wired (typically cloud mode without an active Desktop Bridge connection). For description/annotation visibility, use local mode with the plugin running.");
+            }
             if (fetchErrors.length > 0) {
                 notes.push(`Failed to fetch ${fetchErrors.length} of ${component_ids?.length ?? 0} requested nodes — see _fetch_errors.`);
             }
@@ -452,7 +530,7 @@ export function registerVersionTools(server, getFigmaAPI, getCurrentUrl, _option
                 from: fromMeta,
                 to: toMeta,
                 page_structure: pageDiff,
-                scoped_nodes: component_ids && component_ids.length > 0 ? scoped : undefined,
+                scoped_nodes: hasScopedNodes ? scoped : undefined,
                 summary: {
                     page_changes: pageDiff.summary.added + pageDiff.summary.removed + pageDiff.summary.renamed,
                     scoped_nodes_requested: component_ids?.length ?? 0,
@@ -462,6 +540,72 @@ export function registerVersionTools(server, getFigmaAPI, getCurrentUrl, _option
                     api_calls_made: apiCalls,
                     cache_hits: cacheHits,
                 },
+                // scope_coverage is an always-on, machine-readable summary of what the
+                // diff DID and DID NOT examine. AI clients should check this before
+                // concluding "nothing else changed." See notes[] for prose warnings.
+                scope_coverage: {
+                    page_structure_diffed: true,
+                    component_ids_diffed: component_ids ?? [],
+                    max_depth: 2,
+                    /**
+                     * v1.25.0: metadata-buffer state. When the plugin is connected
+                     * during edits, description/annotation changes ARE tracked.
+                     * `metadata_buffer.available: false` means the diff is REST-only
+                     * and description/annotation edits are invisible.
+                     */
+                    metadata_buffer: {
+                        available: metadataBufferAvailable,
+                        entries_in_window: bufferedMetadata.length,
+                        entries_matched_to_scoped_nodes: bufferedMetadata.length - unscopedMetadataChanges.length,
+                        entries_outside_scope: unscopedMetadataChanges.length,
+                    },
+                    tracks: [
+                        "page structure (added/removed/renamed pages)",
+                        "component children (added/removed)",
+                        "componentPropertyDefinitions (added/removed/type/default)",
+                        "name and description changes on scoped nodes",
+                        "variable binding references on scoped nodes",
+                        ...(metadataBufferAvailable
+                            ? [
+                                "component descriptions via plugin session buffer (when plugin connected during edit)",
+                                "Dev Mode annotations via plugin session buffer (when plugin connected during edit)",
+                            ]
+                            : []),
+                    ],
+                    does_not_track: [
+                        "instances of components on the canvas (unless passed as component_ids)",
+                        "raw layout properties (layoutSizingHorizontal/Vertical, unbound paddings/widths)",
+                        "raw visual properties (cornerRadius, unbound fills/strokes/effects, opacity)",
+                        "variable VALUE changes (Figma REST does not expose this)",
+                        "style content changes (only style add/remove via component reachability)",
+                        ...(metadataBufferAvailable
+                            ? [
+                                "description/annotation edits made while the Desktop Bridge plugin was disconnected",
+                            ]
+                            : [
+                                "component descriptions (Figma REST omits them; no plugin buffer wired in this mode)",
+                                "Dev Mode annotations (Figma REST omits them; no plugin buffer wired in this mode)",
+                            ]),
+                        "canvas frame edits outside scoped components",
+                    ],
+                    complementary_tools: [
+                        "figma_get_design_changes — forensic per-session edits including raw property changes on instances",
+                        "figma_get_variables — current variable state (no history available)",
+                        "figma_get_styles — current style state",
+                        "figma_get_component — live description and annotation state for a single node",
+                    ],
+                },
+                unscoped_metadata_changes: unscopedMetadataChanges.length > 0
+                    ? unscopedMetadataChanges.map((e) => ({
+                        node_id: e.node_id,
+                        node_name: e.node_name,
+                        node_type: e.node_type,
+                        field: e.field,
+                        new_value: e.new_value,
+                        timestamp: e.timestamp,
+                        source: "plugin_buffer",
+                    }))
+                    : undefined,
                 notes,
                 _fetch_errors: fetchErrors.length > 0 ? fetchErrors : undefined,
             };
@@ -550,7 +694,7 @@ export function registerVersionTools(server, getFigmaAPI, getCurrentUrl, _option
     // -----------------------------------------------------------------------
     // Tool: figma_diff_versions
     // -----------------------------------------------------------------------
-    server.tool("figma_diff_versions", "Diff two versions of a Figma file. Always returns a cheap page-structure diff (added/removed/renamed pages, 2 API calls). Pass component_ids to additionally get per-node deep diffs at depth=2 (added/removed children, name/description changes, componentPropertyDefinitions changes for COMPONENT_SETs, boundVariables deltas) — costs 2 API calls per scoped node. Use 'current' for to_version to diff against HEAD. NOTE: variable VALUE history is not retrievable from Figma REST and is not represented in this diff.", {
+    server.tool("figma_diff_versions", "Diff two versions of a Figma file. Always returns a cheap page-structure diff (added/removed/renamed pages, 2 API calls). Pass component_ids to additionally get per-node deep diffs at depth=2 (added/removed children, name/description changes, componentPropertyDefinitions changes for COMPONENT_SETs, boundVariables deltas) — costs 2 API calls per scoped node. Use 'current' for to_version to diff against HEAD. v1.25.0: when the Desktop Bridge plugin is connected, description and Dev Mode annotation changes are ALSO tracked via a session buffer and surfaced under `scoped_nodes[].metadata_changes[]` and `unscoped_metadata_changes[]` — Figma REST omits these from version snapshots so they're otherwise invisible. STILL NOT tracked: instances of components on the canvas, raw layout properties (layoutSizingHorizontal/Vertical, unbound paddings/widths), raw visual properties (cornerRadius, unbound fills), variable VALUE changes, style content, and metadata edits made while the plugin was disconnected. See `scope_coverage` and `notes[]` for the full coverage map and complementary tools.", {
         fileUrl: z
             .string()
             .url()

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

@@ -15,7 +15,7 @@
 import { WebSocketServer as WSServer, WebSocket } from 'ws';
 import { EventEmitter } from 'events';
 import { createServer as createHttpServer } from 'http';
-import { readFileSync, existsSync } from 'fs';
+import { readFileSync } from 'fs';
 import { join } from 'path';
 import { createChildLogger } from './logger.js';
 import { PACKAGE_ROOT } from './resolve-package-root.js';
@@ -28,29 +28,6 @@ try {
 catch {
     // Non-critical — version will show as 0.0.0
 }
-/**
- * Load the full plugin UI HTML content that gets served to the bootloader.
- * Falls back to a minimal error page if the file isn't found.
- */
-function loadPluginUIContent() {
-    const candidates = [
-        // Primary: relative to package root (works in both CJS and ESM)
-        join(PACKAGE_ROOT, 'figma-desktop-bridge', 'ui-full.html'),
-        // Fallback: relative to cwd (development / monorepo setups)
-        join(process.cwd(), 'figma-desktop-bridge', 'ui-full.html'),
-    ];
-    for (const path of candidates) {
-        try {
-            if (existsSync(path)) {
-                return readFileSync(path, 'utf-8');
-            }
-        }
-        catch {
-            // try next candidate
-        }
-    }
-    return '<html><body><p>Plugin UI not found. Please reinstall figma-console-mcp.</p></body></html>';
-}
 const logger = createChildLogger({ component: 'websocket-server' });
 export class FigmaWebSocketServer extends EventEmitter {
     constructor(options) {
@@ -69,8 +46,6 @@ export class FigmaWebSocketServer extends EventEmitter {
         this._startedAt = Date.now();
         this.consoleBufferSize = 1000;
         this.documentChangeBufferSize = 200;
-        /** Cached plugin UI HTML content — loaded once and served to bootloader requests */
-        this._pluginUIContent = null;
         /** Heartbeat interval for detecting dead connections via ping/pong */
         this._heartbeatInterval = null;
         this.options = options;
@@ -78,7 +53,10 @@ export class FigmaWebSocketServer extends EventEmitter {
     }
     /**
      * Handle HTTP requests on the same port as WebSocket.
-     * Serves plugin UI content for the bootloader and health checks.
+     * Serves a JSON `/health` (also at `/`) endpoint with version and connected-file
+     * info. No plugin-UI route exists — the plugin loads its own `ui.html` from disk
+     * via the Figma plugin runtime; the legacy `/plugin/ui` bootloader endpoint was
+     * removed in the Phase 3 cleanup.
      */
     handleHttpRequest(req, res) {
         // CORS headers for Figma plugin iframe (sandboxed, origin: null)
@@ -91,18 +69,6 @@ export class FigmaWebSocketServer extends EventEmitter {
             return;
         }
         const url = req.url || '/';
-        // Plugin UI endpoint — bootloader redirects here
-        if (url === '/plugin/ui' || url === '/plugin/ui/') {
-            if (!this._pluginUIContent) {
-                this._pluginUIContent = loadPluginUIContent();
-            }
-            res.writeHead(200, {
-                'Content-Type': 'text/html; charset=utf-8',
-                'Cache-Control': 'no-cache, no-store, must-revalidate',
-            });
-            res.end(this._pluginUIContent);
-            return;
-        }
         // Health/version endpoint
         if (url === '/health' || url === '/') {
             const now = Date.now();
@@ -294,22 +260,6 @@ export class FigmaWebSocketServer extends EventEmitter {
             }
             return;
         }
-        // Bootloader request: send the full plugin UI HTML
-        if (message.type === 'GET_PLUGIN_UI') {
-            if (!this._pluginUIContent) {
-                this._pluginUIContent = loadPluginUIContent();
-            }
-            try {
-                ws.send(JSON.stringify({
-                    type: 'PLUGIN_UI_CONTENT',
-                    html: this._pluginUIContent,
-                }));
-            }
-            catch {
-                // Non-critical — bootloader will show error
-            }
-            return;
-        }
         // Unsolicited data from plugin (FILE_INFO, events, forwarded data)
         if (message.type) {
             // FILE_INFO promotes pending clients to named clients
@@ -335,6 +285,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 +414,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 +640,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

@@ -15,7 +15,6 @@ import { BrowserManager } from "./browser-manager.js";
 import { ConsoleMonitor } from "./core/console-monitor.js";
 import { getConfig } from "./core/config.js";
 import { createChildLogger } from "./core/logger.js";
-import { testBrowserRendering } from "./test-browser.js";
 import { FigmaAPI, extractFileKey } from "./core/figma-api.js";
 import { registerFigmaAPITools } from "./core/figma-tools.js";
 import { registerDesignCodeTools } from "./core/design-code-tools.js";
@@ -25,9 +24,12 @@ import { registerAnnotationTools } from "./core/annotation-tools.js";
 import { registerDeepComponentTools } from "./core/deep-component-tools.js";
 import { registerDesignSystemTools } from "./core/design-system-tools.js";
 import { registerAccessibilityTools } from "./core/accessibility-tools.js";
+import { registerDiagnoseTool } from "./core/diagnose-tool.js";
+import { wrapServerForIdentity } from "./core/identity.js";
 import { generatePairingCode } from "./core/cloud-websocket-relay.js";
 import { CloudWebSocketConnector } from "./core/cloud-websocket-connector.js";
 import { registerWriteTools } from "./core/write-tools.js";
+import { registerTokensTools } from "./core/tokens-tools.js";
 import { registerFigJamTools } from "./core/figjam-tools.js";
 import { registerSlidesTools } from "./core/slides-tools.js";
 // Re-export PluginRelayDO so Cloudflare Workers can bind it as a Durable Object
@@ -68,10 +70,16 @@ function isFigmaPAT(token) {
 export class FigmaConsoleMCPv3 extends McpAgent {
     constructor() {
         super(...arguments);
-        this.server = new McpServer({
-            name: "Figma Console MCP",
-            version: "1.23.0",
-        });
+        this.server = (() => {
+            const s = new McpServer({
+                name: "Figma Console MCP",
+                version: "1.27.1",
+            });
+            // Identity wrap — every tool's response and thrown error gets stamped
+            // with our MCP name so cross-MCP attribution is unambiguous.
+            wrapServerForIdentity(s);
+            return s;
+        })();
         this.browserManager = null;
         this.consoleMonitor = null;
         this.figmaAPI = null;
@@ -309,7 +317,7 @@ export class FigmaConsoleMCPv3 extends McpAgent {
     }
     async init() {
         // Tool 1: Get Console Logs
-        this.server.tool("figma_get_console_logs", "Retrieve console logs from Figma. Captures all plugin console output including [Main], [Swapper], etc. prefixes. Call figma_navigate first to initialize browser monitoring.", {
+        this.server.tool("figma_get_console_logs", "Retrieve console logs from a Cloudflare Browser Rendering session opened with figma_navigate. Captures plugin console output ([Main], [Swapper], etc. prefixes) and page-level logs. NOTE: cloud mode does NOT currently capture logs from a paired Desktop Bridge plugin — for plugin sandbox logs, use Local mode. Call figma_navigate first to open the file and start browser monitoring.", {
             count: z.number().optional().default(100).describe("Number of recent logs to retrieve"),
             level: z
                 .enum(["log", "info", "warn", "error", "debug", "all"])
@@ -376,7 +384,7 @@ export class FigmaConsoleMCPv3 extends McpAgent {
             nodeId: z
                 .string()
                 .optional()
-                .describe("Optional node ID to screenshot. If not provided, uses the currently viewed page/frame from the browser URL."),
+                .describe("Optional node ID to screenshot (e.g., '123:456'). If omitted, uses the node-id query param from the Cloudflare Browser Rendering page's current URL."),
             scale: z
                 .number()
                 .min(0.01)
@@ -777,6 +785,8 @@ export class FigmaConsoleMCPv3 extends McpAgent {
         };
         // Register all write/manipulation tools via shared function
         registerWriteTools(this.server, getCloudDesktopConnector);
+        // Register token sync tools — figma_export_tokens and figma_import_tokens.
+        registerTokensTools(this.server, getCloudDesktopConnector, { isRemoteMode: true });
         // Register FigJam-specific tools (sticky notes, connectors, tables, etc.)
         registerFigJamTools(this.server, getCloudDesktopConnector);
         // Register Annotation tools (read/write design annotations via Desktop Bridge)
@@ -787,7 +797,7 @@ export class FigmaConsoleMCPv3 extends McpAgent {
         registerSlidesTools(this.server, getCloudDesktopConnector);
         // Register Figma API tools (Tools 8-14)
         // Pass isRemoteMode: true to suppress Desktop Bridge mentions in tool descriptions
-        registerFigmaAPITools(this.server, async () => await this.getFigmaAPI(), () => this.browserManager?.getCurrentUrl() || null, () => this.consoleMonitor || null, () => this.browserManager || null, () => this.ensureInitialized(), undefined, // variablesCache
+        registerFigmaAPITools(this.server, async () => await this.getFigmaAPI(), () => this.browserManager?.getCurrentUrl() || null, undefined, // variablesCache
         { isRemoteMode: true }, getCloudDesktopConnector);
         // Register Design-Code Parity & Documentation tools
         registerDesignCodeTools(this.server, async () => await this.getFigmaAPI(), () => this.browserManager?.getCurrentUrl() || null, undefined, // variablesCache
@@ -807,6 +817,15 @@ export class FigmaConsoleMCPv3 extends McpAgent {
         catch (e) {
             // Silently skip if axe-core/jsdom not available in Workers environment
         }
+        // Register figma_diagnose for cloud mode. Plugin state isn't directly
+        // observable from here (the paired plugin's WS lives in the relay DO),
+        // so we report mode and let the cross-MCP disclaimer do most of the work.
+        registerDiagnoseTool(this.server, {
+            mode: "cloud",
+            getServerVersion: () => "cloud",
+            getPluginState: () => null,
+            getTokenState: () => ({ hasToken: false }),
+        });
         // Note: MCP Apps (Token Browser, Dashboard) are registered in local.ts only
         // They require Node.js file system APIs that don't work in Cloudflare Workers
     }
@@ -1058,8 +1077,9 @@ export default {
             });
             const statelessServer = new McpServer({
                 name: "Figma Console MCP",
-                version: "1.23.0",
+                version: "1.27.1",
             });
+            wrapServerForIdentity(statelessServer);
             // ================================================================
             // Cloud Write Relay — Pairing Tool (stateless /mcp path)
             // Uses KV keyed by bearer token instead of DO storage
@@ -1137,6 +1157,7 @@ export default {
             }
             // Register all write/manipulation tools via shared function
             registerWriteTools(statelessServer, getCloudDesktopConnector);
+            registerTokensTools(statelessServer, getCloudDesktopConnector, { isRemoteMode: true });
             // Register FigJam-specific tools
             registerFigJamTools(statelessServer, getCloudDesktopConnector);
             // Register Annotation tools
@@ -1146,10 +1167,7 @@ export default {
             // Register Figma Slides tools
             registerSlidesTools(statelessServer, getCloudDesktopConnector);
             // Register REST API tools with the authenticated Figma API
-            registerFigmaAPITools(statelessServer, async () => statelessApi, getCloudFileUrl, () => null, // No console monitor
-            () => null, // No browser manager
-            undefined, // No ensureInitialized
-            new Map(), // Fresh variables cache per request
+            registerFigmaAPITools(statelessServer, async () => statelessApi, getCloudFileUrl, new Map(), // Fresh variables cache per request
             { isRemoteMode: true }, getCloudDesktopConnector);
             registerDesignCodeTools(statelessServer, async () => statelessApi, getCloudFileUrl, new Map(), // Fresh variables cache per request
             { isRemoteMode: true }, getCloudDesktopConnector);
@@ -1694,25 +1712,18 @@ export default {
             return new Response(JSON.stringify({
                 status: "healthy",
                 service: "Figma Console MCP",
-                version: "1.23.0",
+                version: "1.27.1",
                 endpoints: {
                     mcp: ["/sse", "/mcp"],
                     oauth_mcp_spec: ["/.well-known/oauth-authorization-server", "/authorize", "/token", "/oauth/register"],
                     oauth_legacy: ["/oauth/authorize", "/oauth/callback"],
-                    utility: ["/test-browser", "/health"]
+                    utility: ["/health"]
                 },
                 oauth_configured: !!env.FIGMA_OAUTH_CLIENT_ID
             }), {
                 headers: { "Content-Type": "application/json" },
             });
         }
-        // Browser Rendering API test endpoint
-        if (url.pathname === "/test-browser") {
-            const results = await testBrowserRendering(env);
-            return new Response(JSON.stringify(results, null, 2), {
-                headers: { "Content-Type": "application/json" },
-            });
-        }
         // Serve favicon
         if (url.pathname === "/favicon.ico") {
             // Redirect to custom Figma Console icon
@@ -1740,13 +1751,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. 100+ 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. 103+ 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. 100+ 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. 103+ 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">
@@ -1754,7 +1765,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. 100+ 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. 103+ 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">
@@ -2641,7 +2652,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">100+</span>
+					<span class="number">103+</span>
 					<span class="label">MCP tools for Figma</span>
 				</div>
 				<div class="capability-list">

package/dist/core/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAqErD;;GAEG;AACH,wBAAgB,UAAU,IAAI,YAAY,CAqBzC;AA+BD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAkCzD;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,YAAY,CAIxC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAiErD;;GAEG;AACH,wBAAgB,UAAU,IAAI,YAAY,CAqBzC;AA2BD;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAkCzD;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,YAAY,CAIxC"}

package/dist/core/config.js

@@ -48,10 +48,6 @@ const DEFAULT_CONFIG = {
         quality: 90,
         storePath: join(process.env.TMPDIR || '/tmp', 'figma-console-mcp', 'screenshots'),
     },
-    local: {
-        debugHost: process.env.FIGMA_DEBUG_HOST || 'localhost',
-        debugPort: parseInt(process.env.FIGMA_DEBUG_PORT || '9222', 10),
-    },
 };
 /**
  * Possible config file locations (checked in order)
@@ -111,10 +107,6 @@ function mergeConfig(defaults, overrides) {
             ...defaults.screenshots,
             ...(overrides.screenshots || {}),
         },
-        local: {
-            ...defaults.local,
-            ...(overrides.local || {}),
-        },
     };
 }
 /**

package/dist/core/config.js.map

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

package/dist/core/console-monitor.d.ts

@@ -18,8 +18,8 @@ export declare class ConsoleMonitor {
     private lastUrl;
     constructor(config: ConsoleConfig);
     /**
-     * Start monitoring console logs on a page
-     * Accepts any puppeteer Page type (puppeteer-core or @cloudflare/puppeteer)
+     * Start monitoring console logs on a page.
+     * Accepts the @cloudflare/puppeteer Page type (cloud mode only).
      */
     startMonitoring(page: any): Promise<void>;
     /**