@mp3wizard/figma-console-mcp 1.17.3 → 1.19.2

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

@@ -134,6 +134,24 @@ export class WebSocketConnector {
     async setNodeDescription(nodeId, description, descriptionMarkdown) {
         return this.wsServer.sendCommand('SET_NODE_DESCRIPTION', { nodeId, description, descriptionMarkdown });
     }
+    // ============================================================================
+    // Annotation operations
+    // ============================================================================
+    async getAnnotations(nodeId, includeChildren, depth) {
+        return this.wsServer.sendCommand('GET_ANNOTATIONS', { nodeId, includeChildren, depth }, 10000);
+    }
+    async setAnnotations(nodeId, annotations, mode) {
+        return this.wsServer.sendCommand('SET_ANNOTATIONS', { nodeId, annotations, mode: mode || 'replace' });
+    }
+    async getAnnotationCategories() {
+        return this.wsServer.sendCommand('GET_ANNOTATION_CATEGORIES', {}, 5000);
+    }
+    async deepGetComponent(nodeId, depth) {
+        return this.wsServer.sendCommand('DEEP_GET_COMPONENT', { nodeId, depth: depth || 10 }, 30000);
+    }
+    async analyzeComponentSet(nodeId) {
+        return this.wsServer.sendCommand('ANALYZE_COMPONENT_SET', { nodeId }, 30000);
+    }
     async addComponentProperty(nodeId, propertyName, type, defaultValue, options) {
         const params = { nodeId, propertyName, propertyType: type, defaultValue };
         if (options?.preferredValues)
@@ -248,6 +266,81 @@ export class WebSocketConnector {
         return this.wsServer.sendCommand('LINT_DESIGN', params, 120000);
     }
     // ============================================================================
+    // FigJam operations
+    // ============================================================================
+    async createSticky(params) {
+        return this.wsServer.sendCommand('CREATE_STICKY', params);
+    }
+    async createStickies(params) {
+        return this.wsServer.sendCommand('CREATE_STICKIES', params, 30000);
+    }
+    async createConnector(params) {
+        return this.wsServer.sendCommand('CREATE_CONNECTOR', params);
+    }
+    async createShapeWithText(params) {
+        return this.wsServer.sendCommand('CREATE_SHAPE_WITH_TEXT', params);
+    }
+    async createTable(params) {
+        return this.wsServer.sendCommand('CREATE_TABLE', params, 30000);
+    }
+    async createCodeBlock(params) {
+        return this.wsServer.sendCommand('CREATE_CODE_BLOCK', params);
+    }
+    async getBoardContents(params) {
+        return this.wsServer.sendCommand('GET_BOARD_CONTENTS', params, 30000);
+    }
+    async getConnections() {
+        return this.wsServer.sendCommand('GET_CONNECTIONS', {}, 15000);
+    }
+    // ============================================================================
+    // Slides operations
+    // ============================================================================
+    async listSlides() {
+        return this.wsServer.sendCommand('LIST_SLIDES', {}, 10000);
+    }
+    async getSlideContent(params) {
+        return this.wsServer.sendCommand('GET_SLIDE_CONTENT', params, 10000);
+    }
+    async createSlide(params) {
+        return this.wsServer.sendCommand('CREATE_SLIDE', params, 10000);
+    }
+    async deleteSlide(params) {
+        return this.wsServer.sendCommand('DELETE_SLIDE', params, 5000);
+    }
+    async duplicateSlide(params) {
+        return this.wsServer.sendCommand('DUPLICATE_SLIDE', params, 5000);
+    }
+    async getSlideGrid() {
+        return this.wsServer.sendCommand('GET_SLIDE_GRID', {}, 10000);
+    }
+    async reorderSlides(params) {
+        return this.wsServer.sendCommand('REORDER_SLIDES', params, 15000);
+    }
+    async setSlideTransition(params) {
+        return this.wsServer.sendCommand('SET_SLIDE_TRANSITION', params, 5000);
+    }
+    async getSlideTransition(params) {
+        return this.wsServer.sendCommand('GET_SLIDE_TRANSITION', params, 5000);
+    }
+    async setSlidesViewMode(params) {
+        return this.wsServer.sendCommand('SET_SLIDES_VIEW_MODE', params, 5000);
+    }
+    async getFocusedSlide() {
+        return this.wsServer.sendCommand('GET_FOCUSED_SLIDE', {}, 5000);
+    }
+    async focusSlide(params) {
+        return this.wsServer.sendCommand('FOCUS_SLIDE', params, 5000);
+    }
+    async skipSlide(params) {
+        return this.wsServer.sendCommand('SKIP_SLIDE', params, 5000);
+    }
+    async addTextToSlide(params) {
+        return this.wsServer.sendCommand('ADD_TEXT_TO_SLIDE', params, 10000);
+    }
+    async addShapeToSlide(params) {
+        return this.wsServer.sendCommand('ADD_SHAPE_TO_SLIDE', params, 5000);
+    }
+    // ============================================================================
     // Cache management (no-op for WebSocket — no frame cache)
     // ============================================================================
     clearFrameCache() {

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

@@ -18,12 +18,12 @@ import { createServer as createHttpServer } from 'http';
 import { readFileSync, existsSync } from 'fs';
 import { join } from 'path';
 import { createChildLogger } from './logger.js';
-// Read version from package.json
-// Uses __dirname in CJS/Jest context, falls back to process.cwd() in ESM runtime
+import { PACKAGE_ROOT } from './resolve-package-root.js';
+// Read version from package.json using the resolved package root.
+// PACKAGE_ROOT uses import.meta.url in ESM (production) and __dirname in CJS (Jest).
 let SERVER_VERSION = '0.0.0';
 try {
-    const base = typeof __dirname !== 'undefined' ? join(__dirname, '..', '..') : process.cwd();
-    SERVER_VERSION = JSON.parse(readFileSync(join(base, 'package.json'), 'utf-8')).version;
+    SERVER_VERSION = JSON.parse(readFileSync(join(PACKAGE_ROOT, 'package.json'), 'utf-8')).version;
 }
 catch {
     // Non-critical — version will show as 0.0.0
@@ -34,11 +34,9 @@ catch {
  */
 function loadPluginUIContent() {
     const candidates = [
-        // ESM runtime: dist/core/ → ../../figma-desktop-bridge/
-        typeof __dirname !== 'undefined'
-            ? join(__dirname, '..', '..', 'figma-desktop-bridge', 'ui-full.html')
-            : join(process.cwd(), 'figma-desktop-bridge', 'ui-full.html'),
-        // Direct from project root
+        // 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) {
@@ -415,6 +413,7 @@ export class FigmaWebSocketServer extends EventEmitter {
                 fileKey,
                 currentPage: data.currentPage,
                 currentPageId: data.currentPageId || null,
+                editorType: data.editorType || 'figma',
                 connectedAt: Date.now(),
             },
             selection: existing?.selection || null,
@@ -707,6 +706,16 @@ export class FigmaWebSocketServer extends EventEmitter {
     getActiveFileKey() {
         return this._activeFileKey;
     }
+    /**
+     * Get the editor type of the currently active file.
+     * Returns 'figma' if no file is connected or editorType wasn't reported.
+     */
+    getEditorType() {
+        if (!this._activeFileKey)
+            return 'figma';
+        const client = this.clients.get(this._activeFileKey);
+        return client?.fileInfo?.editorType || 'figma';
+    }
     // ============================================================================
     // Cleanup
     // ============================================================================

package/dist/cloudflare/index.js

@@ -20,15 +20,45 @@ 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 { registerAnnotationTools } from "./core/annotation-tools.js";
+import { registerDeepComponentTools } from "./core/deep-component-tools.js";
 import { registerDesignSystemTools } from "./core/design-system-tools.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 { 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
 export { PluginRelayDO } from "./core/cloud-websocket-relay.js";
 // Note: MCP Apps (Token Browser, Dashboard) are only available in local mode
 // They require Node.js file system APIs for serving HTML that don't work in Cloudflare Workers
 const logger = createChildLogger({ component: "mcp-server" });
+/**
+ * Validate a Figma Personal Access Token (PAT) by calling the Figma API.
+ * PATs start with 'figd_' and require the X-Figma-Token header (not Bearer).
+ * Returns the user info if valid, null if invalid/expired.
+ */
+async function validateFigmaPAT(token) {
+    try {
+        const response = await fetch("https://api.figma.com/v1/me", {
+            headers: { "X-Figma-Token": token },
+        });
+        if (!response.ok)
+            return null;
+        const data = await response.json();
+        return data?.id ? data : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if a token is a Figma Personal Access Token.
+ * PATs start with 'figd_' — OAuth tokens start with 'figu_'.
+ */
+function isFigmaPAT(token) {
+    return token.startsWith("figd_");
+}
 /**
  * Figma Console MCP Agent
  * Extends McpAgent to provide Figma-specific debugging tools
@@ -38,7 +68,7 @@ export class FigmaConsoleMCPv3 extends McpAgent {
         super(...arguments);
         this.server = new McpServer({
             name: "Figma Console MCP",
-            version: "1.15.5",
+            version: "1.19.1",
         });
         this.browserManager = null;
         this.consoleMonitor = null;
@@ -745,6 +775,14 @@ export class FigmaConsoleMCPv3 extends McpAgent {
         };
         // Register all write/manipulation tools via shared function
         registerWriteTools(this.server, getCloudDesktopConnector);
+        // Register FigJam-specific tools (sticky notes, connectors, tables, etc.)
+        registerFigJamTools(this.server, getCloudDesktopConnector);
+        // Register Annotation tools (read/write design annotations via Desktop Bridge)
+        registerAnnotationTools(this.server, getCloudDesktopConnector);
+        // Register Deep Component tools (Plugin API tree extraction for code generation)
+        registerDeepComponentTools(this.server, getCloudDesktopConnector);
+        // Register Figma Slides tools (slide management, transitions, content)
+        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
@@ -829,6 +867,38 @@ export default {
                 });
             }
             const bearerToken = authHeader.substring(7); // Remove "Bearer " prefix
+            // PAT support: Figma Personal Access Tokens (figd_*) are passed as Bearer
+            // tokens by MCP clients like Lovable, but they aren't stored in our OAuth KV.
+            // Validate them directly against Figma's API instead.
+            if (isFigmaPAT(bearerToken)) {
+                logger.info({ pathname: url.pathname }, "SSE request with Figma PAT — validating against Figma API");
+                const patUser = await validateFigmaPAT(bearerToken);
+                if (!patUser) {
+                    logger.warn({ pathname: url.pathname }, "SSE request with invalid Figma PAT");
+                    const resourceMetadataUrl = `${url.origin}/.well-known/oauth-protected-resource`;
+                    return new Response(JSON.stringify({
+                        error: "invalid_token",
+                        error_description: "Figma Personal Access Token is invalid or expired"
+                    }), {
+                        status: 401,
+                        headers: {
+                            "Content-Type": "application/json",
+                            "WWW-Authenticate": `Bearer resource_metadata="${resourceMetadataUrl}", error="invalid_token"`
+                        }
+                    });
+                }
+                // Store PAT in KV so the Durable Object's getFigmaAPI() can retrieve it
+                const patSessionId = "figma-console-mcp-default-session";
+                const patTokenKey = `oauth_token:${patSessionId}`;
+                await env.OAUTH_TOKENS.put(patTokenKey, JSON.stringify({
+                    accessToken: bearerToken,
+                    expiresAt: Date.now() + 3600_000, // 1-hour TTL for PAT session
+                }), { expirationTtl: 3600 });
+                logger.info({ pathname: url.pathname, user: patUser.handle }, "SSE request authenticated via Figma PAT");
+                // Proceed with SSE connection
+                return FigmaConsoleMCPv3.serveSSE("/sse").fetch(request, env, ctx);
+            }
+            // OAuth token path: look up in KV store
             const bearerKey = `bearer_token:${bearerToken}`;
             try {
                 const tokenDataJson = await env.OAUTH_TOKENS.get(bearerKey);
@@ -897,15 +967,18 @@ export default {
                 });
             }
             const bearerToken = authHeader.substring(7);
-            const bearerKey = `bearer_token:${bearerToken}`;
-            try {
-                const tokenDataJson = await env.OAUTH_TOKENS.get(bearerKey);
-                if (!tokenDataJson) {
-                    logger.warn({ pathname: url.pathname }, "MCP request with invalid Bearer token");
+            // PAT support: Figma Personal Access Tokens (figd_*) are passed as Bearer
+            // tokens by MCP clients like Lovable, v0, and Replit. They bypass OAuth
+            // and aren't stored in KV — validate directly against Figma's API.
+            if (isFigmaPAT(bearerToken)) {
+                logger.info({ pathname: url.pathname }, "MCP request with Figma PAT — validating against Figma API");
+                const patUser = await validateFigmaPAT(bearerToken);
+                if (!patUser) {
+                    logger.warn({ pathname: url.pathname }, "MCP request with invalid Figma PAT");
                     const resourceMetadataUrl = `${url.origin}/.well-known/oauth-protected-resource`;
                     return new Response(JSON.stringify({
                         error: "invalid_token",
-                        error_description: "Bearer token is invalid or expired"
+                        error_description: "Figma Personal Access Token is invalid or expired. Ensure your PAT (figd_...) is valid and has not been revoked."
                     }), {
                         status: 401,
                         headers: {
@@ -914,35 +987,58 @@ export default {
                         }
                     });
                 }
-                const tokenData = JSON.parse(tokenDataJson);
-                if (tokenData.expiresAt < Date.now()) {
-                    logger.warn({ pathname: url.pathname, sessionId: tokenData.sessionId }, "MCP request with expired Bearer token");
-                    const resourceMetadataUrl = `${url.origin}/.well-known/oauth-protected-resource`;
+                logger.info({ pathname: url.pathname, user: patUser.handle }, "MCP request authenticated via Figma PAT");
+            }
+            else {
+                // OAuth token path: look up in KV store
+                const bearerKey = `bearer_token:${bearerToken}`;
+                try {
+                    const tokenDataJson = await env.OAUTH_TOKENS.get(bearerKey);
+                    if (!tokenDataJson) {
+                        logger.warn({ pathname: url.pathname }, "MCP request with invalid Bearer token");
+                        const resourceMetadataUrl = `${url.origin}/.well-known/oauth-protected-resource`;
+                        return new Response(JSON.stringify({
+                            error: "invalid_token",
+                            error_description: "Bearer token is invalid or expired"
+                        }), {
+                            status: 401,
+                            headers: {
+                                "Content-Type": "application/json",
+                                "WWW-Authenticate": `Bearer resource_metadata="${resourceMetadataUrl}", error="invalid_token"`
+                            }
+                        });
+                    }
+                    const tokenData = JSON.parse(tokenDataJson);
+                    if (tokenData.expiresAt < Date.now()) {
+                        logger.warn({ pathname: url.pathname, sessionId: tokenData.sessionId }, "MCP request with expired Bearer token");
+                        const resourceMetadataUrl = `${url.origin}/.well-known/oauth-protected-resource`;
+                        return new Response(JSON.stringify({
+                            error: "invalid_token",
+                            error_description: "Bearer token has expired"
+                        }), {
+                            status: 401,
+                            headers: {
+                                "Content-Type": "application/json",
+                                "WWW-Authenticate": `Bearer resource_metadata="${resourceMetadataUrl}", error="invalid_token"`
+                            }
+                        });
+                    }
+                    logger.info({ pathname: url.pathname, sessionId: tokenData.sessionId }, "MCP request authenticated successfully");
+                }
+                catch (error) {
+                    logger.error({ error, pathname: url.pathname }, "Error validating Bearer token for MCP endpoint");
                     return new Response(JSON.stringify({
-                        error: "invalid_token",
-                        error_description: "Bearer token has expired"
+                        error: "server_error",
+                        error_description: "Failed to validate authorization"
                     }), {
-                        status: 401,
-                        headers: {
-                            "Content-Type": "application/json",
-                            "WWW-Authenticate": `Bearer resource_metadata="${resourceMetadataUrl}", error="invalid_token"`
-                        }
+                        status: 500,
+                        headers: { "Content-Type": "application/json" }
                     });
                 }
-                logger.info({ pathname: url.pathname, sessionId: tokenData.sessionId }, "MCP request authenticated successfully");
-            }
-            catch (error) {
-                logger.error({ error, pathname: url.pathname }, "Error validating Bearer token for MCP endpoint");
-                return new Response(JSON.stringify({
-                    error: "server_error",
-                    error_description: "Failed to validate authorization"
-                }), {
-                    status: 500,
-                    headers: { "Content-Type": "application/json" }
-                });
             }
             // Token is valid — use stateless transport (no Durable Objects)
             // The Bearer token IS the Figma access token, so we use it directly
+            // FigmaAPI handles PAT vs OAuth header selection internally
             const figmaAccessToken = bearerToken;
             const statelessApi = new FigmaAPI({ accessToken: figmaAccessToken });
             const transport = new WebStandardStreamableHTTPServerTransport({
@@ -950,7 +1046,7 @@ export default {
             });
             const statelessServer = new McpServer({
                 name: "Figma Console MCP",
-                version: "1.15.5",
+                version: "1.19.1",
             });
             // ================================================================
             // Cloud Write Relay — Pairing Tool (stateless /mcp path)
@@ -1029,6 +1125,14 @@ export default {
             }
             // Register all write/manipulation tools via shared function
             registerWriteTools(statelessServer, getCloudDesktopConnector);
+            // Register FigJam-specific tools
+            registerFigJamTools(statelessServer, getCloudDesktopConnector);
+            // Register Annotation tools
+            registerAnnotationTools(statelessServer, getCloudDesktopConnector);
+            // Register Deep Component tools
+            registerDeepComponentTools(statelessServer, getCloudDesktopConnector);
+            // 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
@@ -1579,7 +1683,7 @@ export default {
             return new Response(JSON.stringify({
                 status: "healthy",
                 service: "Figma Console MCP",
-                version: "1.15.5",
+                version: "1.19.1",
                 endpoints: {
                     mcp: ["/sse", "/mcp"],
                     oauth_mcp_spec: ["/.well-known/oauth-authorization-server", "/authorize", "/token", "/oauth/register"],
@@ -1625,13 +1729,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. 63+ 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. 89+ 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. 63+ 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. 89+ 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">
@@ -1639,7 +1743,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. 63+ 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. 89+ 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">
@@ -1918,20 +2022,20 @@ export default {
 		}
 
 		.capability-list {
-			display: flex;
-			flex-direction: column;
-			gap: 12px;
+			display: grid;
+			grid-template-columns: 1fr 1fr;
+			gap: 10px;
 		}
 
 		.capability-item {
 			display: flex;
 			align-items: center;
-			gap: 12px;
-			padding: 12px 16px;
+			gap: 10px;
+			padding: 10px 14px;
 			background: var(--color-bg-elevated);
 			border: 1px solid var(--color-border);
 			border-radius: var(--radius-md);
-			font-size: 14px;
+			font-size: 13px;
 			color: var(--color-text-secondary);
 			transition: all var(--transition);
 		}
@@ -2406,6 +2510,9 @@ export default {
 			.showcase-cell {
 				padding-top: 32px;
 			}
+			.capability-list {
+				grid-template-columns: 1fr;
+			}
 			.capability-card {
 				grid-column: span 12;
 				padding: 0 !important;
@@ -2523,7 +2630,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">59+</span>
+					<span class="number">87+</span>
 					<span class="label">MCP tools for Figma</span>
 				</div>
 				<div class="capability-list">
@@ -2551,6 +2658,14 @@ export default {
 						<svg fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24"><path d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"/><path d="M2.458 12C3.732 7.943 7.523 5 12 5c4.478 0 8.268 2.943 9.542 7-1.274 4.057-5.064 7-9.542 7-4.477 0-8.268-2.943-9.542-7z"/></svg>
 						<span>Visual debugging and screenshots</span>
 					</div>
+					<div class="capability-item">
+						<svg fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24"><path d="M7 8h10M7 12h4m1 8l-4-4H5a2 2 0 01-2-2V6a2 2 0 012-2h14a2 2 0 012 2v8a2 2 0 01-2 2h-3l-4 4z"/></svg>
+						<span>Design annotations and dev specs</span>
+					</div>
+					<div class="capability-item">
+						<svg fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24"><rect x="2" y="3" width="20" height="4" rx="1"/><rect x="2" y="9" width="9" height="4" rx="1"/><rect x="13" y="9" width="9" height="4" rx="1"/><rect x="2" y="15" width="20" height="4" rx="1"/></svg>
+						<span>FigJam boards and Slides presentations</span>
+					</div>
 				</div>
 			</div>
 		</div>
@@ -2634,6 +2749,14 @@ export default {
 						<svg fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24"><path d="M5 12h14M12 5l7 7-7 7"/></svg>
 						<span>"Connect to my Figma plugin and create a card component"</span>
 					</div>
+					<div class="prompt-item">
+						<svg fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24"><path d="M5 12h14M12 5l7 7-7 7"/></svg>
+						<span>"Create a retrospective board with colored stickies on FigJam"</span>
+					</div>
+					<div class="prompt-item">
+						<svg fill="none" stroke="currentColor" stroke-width="2" viewBox="0 0 24 24"><path d="M5 12h14M12 5l7 7-7 7"/></svg>
+						<span>"List my slides and set a dissolve transition on each one"</span>
+					</div>
 				</div>
 			</div>
 

package/dist/core/annotation-tools.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Figma Annotations MCP Tools
+ * Tools for reading, writing, and managing design annotations on Figma nodes.
+ * Annotations are a Plugin API feature — requires Desktop Bridge plugin connection.
+ *
+ * Annotations are distinct from comments: they are node-level design specs that
+ * can pin specific properties (fills, width, typography, etc.) and support
+ * markdown-formatted labels. Designers use them to communicate animation timings,
+ * accessibility requirements, interaction specs, and other implementation details
+ * that don't fit in the description field.
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerAnnotationTools(server: McpServer, getDesktopConnector: () => Promise<any>): void;
+//# sourceMappingURL=annotation-tools.d.ts.map

package/dist/core/annotation-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation-tools.d.ts","sourceRoot":"","sources":["../../src/core/annotation-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4EzE,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,SAAS,EACjB,mBAAmB,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GACrC,IAAI,CA0LN"}