@sxl-studio/bridge 1.2.0 → 1.3.2

package/dist/idempotency.js

@@ -0,0 +1,47 @@
+/**
+ * Idempotency cache for POST /api/command.
+ *
+ * Clients may pass an `Idempotency-Key` HTTP header (or top-level
+ * `idempotencyKey` in the JSON body). Repeating the same key within the TTL
+ * window returns the original response without re-dispatching the command to
+ * the plugin — avoiding duplicate side effects on network retries.
+ *
+ * Cache is in-memory, per-process, and intentionally small.
+ */
+const TTL_MS = 10 * 60 * 1000; // 10 minutes
+const MAX_ENTRIES = 200;
+const store = new Map();
+function prune() {
+    const now = Date.now();
+    for (const [k, v] of store) {
+        if (v.expiresAt < now)
+            store.delete(k);
+    }
+    if (store.size > MAX_ENTRIES) {
+        // Drop oldest by insertion order (Map preserves it).
+        const drop = store.size - MAX_ENTRIES;
+        let i = 0;
+        for (const k of store.keys()) {
+            store.delete(k);
+            i++;
+            if (i >= drop)
+                break;
+        }
+    }
+}
+export function getIdempotent(key) {
+    prune();
+    const entry = store.get(key);
+    if (!entry)
+        return null;
+    if (entry.expiresAt < Date.now()) {
+        store.delete(key);
+        return null;
+    }
+    return entry.result;
+}
+export function putIdempotent(key, result) {
+    prune();
+    store.set(key, { result, expiresAt: Date.now() + TTL_MS });
+}
+//# sourceMappingURL=idempotency.js.map

package/dist/idempotency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency.js","sourceRoot":"","sources":["../src/idempotency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,aAAa;AAC5C,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;AAE5C,SAAS,KAAK;IACZ,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,SAAS,GAAG,GAAG;YAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,GAAG,WAAW,EAAE,CAAC;QAC7B,qDAAqD;QACrD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,GAAG,WAAW,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YAC7B,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAChB,CAAC,EAAE,CAAC;YACJ,IAAI,CAAC,IAAI,IAAI;gBAAE,MAAM;QACvB,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,KAAK,EAAE,CAAC;IACR,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,IAAI,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QACjC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,MAAqB;IAC9D,KAAK,EAAE,CAAC;IACR,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;AAC7D,CAAC"}

package/dist/mcp-factory.d.ts

@@ -2,6 +2,6 @@
  * Shared MCP tool registration for SXL Studio Bridge.
  * Used by stdio transport (Cursor spawn) and Streamable HTTP at /mcp (Cursor URL).
  */
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpServer } from "../node_modules/@modelcontextprotocol/sdk/dist/cjs/server/mcp.js";
 import type { CommandQueue } from "./command-queue.js";
 export declare function createBridgeMcpServer(commandQueue: CommandQueue): McpServer;

package/dist/mcp-factory.js

@@ -2,29 +2,45 @@
  * Shared MCP tool registration for SXL Studio Bridge.
  * Used by stdio transport (Cursor spawn) and Streamable HTTP at /mcp (Cursor URL).
  */
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpServer } from "../node_modules/@modelcontextprotocol/sdk/dist/cjs/server/mcp.js";
+import { SXL_BRIDGE_MCP_INSTRUCTIONS } from "./sxl-mcp-instructions.js";
+import { bootstrapBridgeToolCatalogue } from "./tools/catalogue-bootstrap.js";
 import { registerCompositionTools } from "./tools/composition.js";
 import { registerDataTools } from "./tools/data.js";
 import { registerDiagnosticTools } from "./tools/diagnostics.js";
 import { registerFigmaNodeTools } from "./tools/figma-nodes.js";
 import { registerRcExtendedCanvasTools } from "./tools/figma-rc-extended.js";
 import { registerGitTools } from "./tools/git.js";
+import { registerMetaTools } from "./tools/meta.js";
+import { registerOrchestrationTools } from "./tools/orchestration.js";
+import { registerBridgeResources } from "./tools/resources.js";
+import { registerStyleTools } from "./tools/styles.js";
 import { registerTokenTools } from "./tools/tokens.js";
-import { SXL_BRIDGE_MCP_INSTRUCTIONS } from "./sxl-mcp-instructions.js";
+import { registerVariableTools } from "./tools/variables.js";
+let catalogueReady = false;
 export function createBridgeMcpServer(commandQueue) {
+    if (!catalogueReady) {
+        bootstrapBridgeToolCatalogue();
+        catalogueReady = true;
+    }
     const server = new McpServer({
         name: "@sxl-studio/bridge",
-        version: "1.2.0",
+        version: "1.3.2",
     }, {
         instructions: SXL_BRIDGE_MCP_INSTRUCTIONS,
     });
     registerTokenTools(server, commandQueue);
+    registerVariableTools(server, commandQueue);
+    registerStyleTools(server, commandQueue);
     registerCompositionTools(server, commandQueue);
     registerDataTools(server, commandQueue);
     registerDiagnosticTools(server, commandQueue);
     registerFigmaNodeTools(server, commandQueue);
     registerRcExtendedCanvasTools(server, commandQueue);
     registerGitTools(server, commandQueue);
+    registerOrchestrationTools(server, commandQueue);
+    registerMetaTools(server, commandQueue);
+    registerBridgeResources(server, commandQueue);
     return server;
 }
 //# sourceMappingURL=mcp-factory.js.map

package/dist/mcp-factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-factory.js","sourceRoot":"","sources":["../src/mcp-factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAExE,MAAM,UAAU,qBAAqB,CAAC,YAA0B;IAC9D,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE,2BAA2B;KAC1C,CACF,CAAC;IAEF,kBAAkB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzC,wBAAwB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC/C,iBAAiB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACxC,uBAAuB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC9C,sBAAsB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC7C,6BAA6B,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACpD,gBAAgB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAEvC,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"mcp-factory.js","sourceRoot":"","sources":["../src/mcp-factory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,kEAAkE,CAAC;AAE7F,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,IAAI,cAAc,GAAG,KAAK,CAAC;AAE3B,MAAM,UAAU,qBAAqB,CAAC,YAA0B;IAC9D,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,4BAA4B,EAAE,CAAC;QAC/B,cAAc,GAAG,IAAI,CAAC;IACxB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE,2BAA2B;KAC1C,CACF,CAAC;IAEF,kBAAkB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzC,qBAAqB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC5C,kBAAkB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzC,wBAAwB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC/C,iBAAiB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACxC,uBAAuB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC9C,sBAAsB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC7C,6BAA6B,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACpD,gBAAgB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACvC,0BAA0B,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACjD,iBAAiB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAExC,uBAAuB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAE9C,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/mcp-server.d.ts

@@ -4,6 +4,6 @@
  * Optional: Cursor can use HTTP MCP at http://127.0.0.1:{BRIDGE_PORT}/mcp instead
  * (see http-api.ts) so the IDE does not need to spawn this process.
  */
+import type { McpServer } from "../node_modules/@modelcontextprotocol/sdk/dist/cjs/server/mcp.js";
 import type { CommandQueue } from "./command-queue.js";
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 export declare function startMcpServer(commandQueue: CommandQueue): Promise<McpServer>;

package/dist/mcp-server.js

@@ -4,7 +4,7 @@
  * Optional: Cursor can use HTTP MCP at http://127.0.0.1:{BRIDGE_PORT}/mcp instead
  * (see http-api.ts) so the IDE does not need to spawn this process.
  */
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StdioServerTransport } from "../node_modules/@modelcontextprotocol/sdk/dist/cjs/server/stdio.js";
 import { createBridgeMcpServer } from "./mcp-factory.js";
 export async function startMcpServer(commandQueue) {
     const server = createBridgeMcpServer(commandQueue);

package/dist/mcp-server.js.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAGjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,YAA0B;IAC7D,MAAM,MAAM,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;IAEpE,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oEAAoE,CAAC;AAE1G,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,YAA0B;IAC7D,MAAM,MAAM,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;IAEpE,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/sxl-mcp-instructions.d.ts

@@ -1,5 +1,5 @@
 /**
  * MCP server instructions for Cursor / other agents using SXL Studio Bridge.
- * Keep in sync with Plugin/docs/ru/60-remote-connect.md (agent workflows).
+ * Keep in sync with Plugin/sxl/docs/16-utils-bridge-mcp.md and Site util-bridge docs.
  */
 export declare const SXL_BRIDGE_MCP_INSTRUCTIONS: string;

package/dist/sxl-mcp-instructions.js

@@ -1,36 +1,136 @@
 /**
  * MCP server instructions for Cursor / other agents using SXL Studio Bridge.
- * Keep in sync with Plugin/docs/ru/60-remote-connect.md (agent workflows).
+ * Keep in sync with Plugin/sxl/docs/16-utils-bridge-mcp.md and Site util-bridge docs.
  */
 export const SXL_BRIDGE_MCP_INSTRUCTIONS = `
-You are assisting with Figma via the SXL Studio plugin and this Bridge.
+You are assisting with Figma through the SXL Studio plugin and this Bridge. Follow these rules precisely.
 
-## Two MCP servers (recommended)
-- **Official Figma MCP** (often remote): design context from links, selection, native file ops (e.g. use_figma). Parse node-id from figma.com URLs (replace "-" with ":" in node-id).
-- **SXL Studio Bridge (this server)**: plugin-only commands — compositions, token files, Git in the plugin, and whitelisted canvas helpers.
+## Two MCP servers you may see in Cursor
+- **Official Figma MCP** (often remote): reads design context from selection / links, opens files, native Figma ops (e.g. \`use_figma\`). Parse \`node-id\` from figma.com URLs by replacing "-" with ":".
+- **SXL Studio Bridge** (this server): plugin-only commands — composition / token files, variables, styles, Git in the plugin, Dev Mode codegen parity, orchestration helpers, and canvas helpers.
 
-## Prerequisites
-1. Bridge running (HTTP/WebSocket on BRIDGE_PORT).
-2. Figma: SXL Studio plugin open, **Remote Connect** session active.
+## Prerequisites for every session
+1. Bridge is running locally (HTTP + WebSocket + MCP on BRIDGE_PORT, default 37830).
+2. In Figma the SXL Studio plugin is open with **Remote Connect** session active
+   (works in Design mode **and** Dev Mode UI; it does **not** work from the Dev Mode "Inspect → Code" sandbox panel).
+3. Confirm with \`get_plugin_status\` before taking destructive actions. The result contains \`editorType\` ("figma" or "dev"), \`mode\`, \`isDevMode\`, \`isCodegenSandbox\`, and \`writesAllowed\`.
+4. Optional: if the operator configured \`BRIDGE_AUTH_TOKEN\`, MCP/HTTP calls require \`Authorization: Bearer …\`. MCP clients usually handle this automatically once configured.
 
-## Workflow: component from layout + composition JSON + generate in Figma
-1. Use **Figma MCP** (or user selection) to identify the **nodeId** of the frame/component the user wants as the composition source.
-2. Call **export_composition_json** with \`payload.nodeId\` (or select the node in Figma first). You receive \`compositionJson\`.
-3. In the IDE, **write** a new \`.json\` composition file in the user repo (path they expect under tokens/compositions).
-4. Call **save_token_file** if the file is managed by the plugin, or ensure the plugin sees the file via normal sync.
-5. Call **generate_composition** or **apply_composition** with \`fileId\` / \`compositionName\` as required by the project.
+## Discovery: prefer authoritative catalogues
+- \`list_tools\` — meta-tool that returns the full Bridge tool catalogue with category and flags (\`requiresDesignMode\`, \`requiresComposition\`). Use it instead of guessing tool names. Filter with \`category\` or \`devModeReadableOnly: true\`.
+- MCP Resources (read-only URIs) — attach as context instead of calling tools when you only need state:
+  - \`sxl://figma/status\` — plugin status snapshot.
+  - \`sxl://figma/selection\` — current selection.
+  - \`sxl://tokens/config\` — raw config.json.
+  - \`sxl://tokens/files\` — token file index.
+  - \`sxl://tokens/files/{fileId}\` — raw token file body.
+  - \`sxl://compositions/index\` — composition JSON index.
 
-## Workflow: documentation in Figma
-**Template in Figma:** duplicate a template subtree under the doc page, then place an instance of the new component.
-- **duplicate_subtree**: \`sourceNodeId\` (template root), \`targetParentId\` (e.g. doc section), optional \`offsetX\` / \`offsetY\`.
-- **create_component_instance**: \`mainComponentId\` (local COMPONENT) or \`componentKey\` (published library), optional \`parentId\`, \`x\`, \`y\`.
+## CRITICAL — never hand-craft composition / token JSON
+If the user asks for "JSON", "composition", "get code", or "same output as Dev Mode → Get Code":
 
-**Template from repo:** build section text in the IDE, then **apply_documentation_payload** with \`targetRootId\` and \`entries: [{ layerName, text }]\` matching text layer names under the duplicated template.
+1. **Always** call \`export_composition_json\` (or \`get_codegen\`) for the relevant Figma node.
+   The returned JSON is the **only** valid source of truth — it is produced by the exact same
+   codegen pipeline as "Get Code" in Dev Mode. Do not synthesise it from \`get_node_tree\` /
+   \`get_selection\` — those helpers do not emit composition \`structure\` / \`styles\`
+   / \`componentProperties\` the way the plugin parser expects.
+2. If the source node is a FRAME / GROUP rather than a COMPONENT, the JSON will contain
+   \`"component": false\`. Pass this JSON through to \`save_token_file\` (or \`create_token_file\`) unchanged, then
+   \`generate_composition\` creates plain Frames instead of a Component.
+3. For Dev Mode parity tabs (Variables, Props, Styles, Structure, Transitions, Theme binding,
+   Code Connect) call \`get_codegen\` with \`language: "designer-json"\` (default).
+   SwiftUI / Kotlin / Vue3 outputs are also available via \`language\` parameter.
 
-## Canvas tools
-Atomic node tools (create_frame, create_text, set_node_fill, etc.) execute in the plugin sandbox. They must stay on the whitelist — do not assume a tool exists until documented in Bridge release notes.
+## High-level orchestration (preferred when given a Figma URL)
+- \`generate_code_from_url\` — given a \`figma.com/design/…\` URL, Bridge parses \`fileKey\` +
+  \`nodeId\` and runs \`get_codegen\` on the target node. Returns all codegen tabs. Use this
+  as the first step whenever a developer pastes a Figma link and asks for code.
+- \`compose_from_url\` — URL → \`export_composition_json\` → saves result as a composition
+  token file (\`create_token_file\`). Pass \`generate: true\` to immediately run
+  \`generate_composition\` and materialize the component in Figma.
+- \`document_component\` — \`get_codegen\` on a component + \`apply_documentation_payload\`
+  to fill a documentation template with real context.
 
-## Stability
-If a command fails, check: Remote Connect connected, Bridge port matches, plugin version supports the commandType, and composition tier for composition commands.
+## Canonical workflow — component from a Figma layout (manual)
+1. \`export_composition_json\` with \`payload.nodeId\` (or rely on current selection). Receive
+   \`{ nodeId, nodeType, compositionJson }\`.
+2. \`list_token_files\` → decide the target \`fileId\` under \`tokens/compositions/...\`
+   or create a new file path.
+3. \`save_token_file\` with \`{ fileId, content: compositionJson }\` — or \`create_token_file\`
+   if the file doesn't exist yet. Upsert is supported via \`{ name, folder, content }\`.
+4. \`generate_composition\` (or \`apply_composition\` if updating) with the same \`fileId\`.
+   Plugin creates / refreshes the Figma Component or ComponentSet on canvas.
+
+## Workflow — populate a documentation page
+1. \`duplicate_subtree\` — clone a template subtree under \`targetParentId\` (doc section).
+2. \`create_component_instance\` or \`import_component_by_key\` to place the new component.
+3. \`apply_documentation_payload\` with \`{ targetRootId, entries: [{ layerName, text }] }\`
+   to fill text layers by name. Or use \`document_component\` to combine with \`get_codegen\`.
+
+## Workflow — Variables / Design Tokens
+- \`get_variables\` — read collections + variables (filter by type, limit paged).
+- \`create_variable_collection\`, \`create_variable\`, \`bind_variable\` — build new tokens.
+- \`rename_variable\`, \`delete_variable\`, \`rename_variable_collection\`,
+  \`delete_variable_collection\` — lifecycle.
+- \`add_variable_mode\`, \`remove_variable_mode\`, \`rename_variable_mode\` — manage modes.
+- \`set_variable_mode_value\` — write a per-mode value (accepts \`#hex\` for COLOR).
+- \`set_variable_scopes\`, \`set_variable_code_syntax\` — metadata required for proper
+  exports and codegen.
+- \`export_variables\` — push DTCG token files from the plugin workspace into Figma.
+
+## Workflow — Tokens & workspace config
+- \`list_token_files\` → \`get_token_file_content\` for reads.
+- \`save_token_file\` — upsert by \`fileId\` or by \`{ name, folder }\`. Content is validated as JSON.
+- \`create_token_file\` — create a new file (supports \`overwrite\`, initial content).
+- \`delete_token_file\` / \`move_token_file\` / \`rename_token_file\` — lifecycle.
+- \`get_tokens_config\` → \`save_tokens_config\` — edit collections, modes, file inclusion.
+- After editing config, follow up with \`export_variables\` to propagate into Figma.
+
+## Workflow — Styles
+- \`get_local_styles\` for discovery.
+- \`create_paint_style\` / \`create_text_style\` / \`create_effect_style\` to build new locals.
+- \`set_text_style\`, \`set_effect_style\`, \`set_stroke_style\`, \`set_fill_style\` to
+  assign a style to a node.
+- \`import_style_by_key\` to bring in published styles.
+
+## Dev Mode rules
+- **Reads always work** — \`get_selection\`, \`get_node_info\`, \`get_node_tree\`,
+  \`export_composition_json\`, \`get_codegen\`, \`get_variables\`, \`get_page_structure\`,
+  \`list_components\`, \`list_token_files\`, \`get_plugin_status\`.
+- **File operations also work** — token file CRUD, \`save_tokens_config\`, \`git_pull\`,
+  \`git_push\` — they operate on the plugin workspace, not on the canvas.
+- **Canvas writes are blocked by Figma in Dev Mode** (\`create_frame\`, \`modify_node\`,
+  \`bind_variable\`, style assignment, etc.). The plugin returns a typed error
+  \`{ code: "EDITOR_MODE_READONLY", retryable: false, details: { editorType, mode } }\`.
+  Surface the message; ask the user to switch to Design mode.
+
+## Typed errors
+Every tool may fail with a structured envelope. Parse \`error\` — it is JSON with
+\`{ code, message, retryable, details? }\`. Known codes:
+- \`EDITOR_MODE_READONLY\` — canvas write attempted in Dev Mode (retryable: false).
+- \`BRIDGE_TIMEOUT\` — plugin did not respond in the configured timeout (retryable: true).
+- \`BRIDGE_CANCELLED\` — user or plugin aborted the command.
+- \`BRIDGE_UNAUTHORIZED\` — \`BRIDGE_AUTH_TOKEN\` is set but missing / wrong.
+- \`BRIDGE_ERROR\` — generic plugin error; inspect \`message\`.
+
+## Idempotency & retries
+- For HTTP (\`POST /api/command\`) include an \`Idempotency-Key\` header; repeating within
+  10 minutes returns the cached response without re-running the command. Use when a
+  network hiccup might cause double-send.
+- MCP clients usually don't need this; each tool call is delivered once by MCP itself.
+- If a command times out (default 15s, composition / export up to 120s) — do **not** retry
+  immediately; read the result first (\`get_export_report\`, inspect Figma) to avoid
+  duplicate side effects.
+
+## Stability checklist before calling tools
+- \`get_plugin_status\` returns \`sessionActive: true\`.
+- The node(s) you plan to operate on exist (confirm via \`find_nodes\` or \`get_node_info\`).
+- For composition tools, the user has a Pro Plus license (the gate raises a clear error).
+- For canvas-write tools, \`writesAllowed: true\` (i.e. not in Dev Mode).
+- If unsure what's available, start with \`list_tools\` (or GET /api/tools) and filter by category.
+
+## Response shape
+Every tool returns a serialized JSON object as text. Read \`status\` / \`ok\` before trusting
+the payload. Errors carry \`error\` (JSON-encoded typed envelope, see above).
 `.trim();
 //# sourceMappingURL=sxl-mcp-instructions.js.map

package/dist/sxl-mcp-instructions.js.map

@@ -1 +1 @@
-{"version":3,"file":"sxl-mcp-instructions.js","sourceRoot":"","sources":["../src/sxl-mcp-instructions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8B1C,CAAC,IAAI,EAAE,CAAC"}
+{"version":3,"file":"sxl-mcp-instructions.js","sourceRoot":"","sources":["../src/sxl-mcp-instructions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkI1C,CAAC,IAAI,EAAE,CAAC"}

package/dist/tools/catalogue-bootstrap.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Central catalogue bootstrap for all Bridge MCP tools.
+ *
+ * This is a single authoritative list of (name, category, flags) entries so
+ * that `list_tools` and `GET /api/tools` can return the same metadata without
+ * each tool registration file having to call `catalogueTool` inline. Adding a
+ * new tool? Register it here and in the corresponding tools/*.ts module.
+ */
+export declare function bootstrapBridgeToolCatalogue(): void;

package/dist/tools/catalogue-bootstrap.js

@@ -0,0 +1,168 @@
+/**
+ * Central catalogue bootstrap for all Bridge MCP tools.
+ *
+ * This is a single authoritative list of (name, category, flags) entries so
+ * that `list_tools` and `GET /api/tools` can return the same metadata without
+ * each tool registration file having to call `catalogueTool` inline. Adding a
+ * new tool? Register it here and in the corresponding tools/*.ts module.
+ */
+import { catalogueTool } from "./registry.js";
+function add(entry) {
+    catalogueTool({
+        name: entry.name,
+        category: entry.category,
+        summary: entry.summary,
+        requiresDesignMode: entry.requiresDesignMode ?? false,
+        requiresComposition: entry.requiresComposition ?? false,
+    });
+}
+function category(cat, entries) {
+    for (const e of entries)
+        add({ ...e, category: cat });
+}
+export function bootstrapBridgeToolCatalogue() {
+    category("diagnostics", [
+        { name: "get_plugin_status", category: "diagnostics", summary: "Plugin runtime status (editor, mode, selection, session)." },
+        { name: "is_dev_mode", category: "diagnostics", summary: "Shortcut flag: true when figma.editorType === 'dev'." },
+        { name: "get_selection_summary", category: "diagnostics", summary: "Summary of current Figma selection." },
+        { name: "get_drift_status", category: "diagnostics", summary: "Drift status across exported collections." },
+        { name: "get_export_report", category: "diagnostics", summary: "Most recent export report." },
+    ]);
+    category("tokens", [
+        { name: "list_token_files", category: "tokens", summary: "Index of token files (id, name, folder, gitPath)." },
+        { name: "get_token_file_content", category: "tokens", summary: "Raw JSON body of a token file." },
+        { name: "save_token_file", category: "tokens", summary: "Upsert JSON content of a token file." },
+        { name: "create_token_file", category: "tokens", summary: "Create a new token file." },
+        { name: "delete_token_file", category: "tokens", summary: "Delete a token file (queues gitPath removal if tracked)." },
+        { name: "move_token_file", category: "tokens", summary: "Rename/move a token file." },
+        { name: "rename_token_file", category: "tokens", summary: "Rename a token file (alias of move_token_file)." },
+        { name: "get_tokens_config", category: "tokens", summary: "Read the plugin config.json content." },
+        { name: "save_tokens_config", category: "tokens", summary: "Overwrite config.json." },
+        { name: "get_applied_tokens", category: "tokens", summary: "Applied tokens + composition binding on a node." },
+        { name: "export_variables", category: "tokens", summary: "Run variables export (requires Design mode).", requiresDesignMode: true },
+        { name: "reset_diff", category: "tokens", summary: "Reset all Diff-IDs." },
+        { name: "reset_diff_collection", category: "tokens", summary: "Reset Diff-IDs for a collection." },
+        { name: "reset_diff_file", category: "tokens", summary: "Reset Diff-IDs for a file." },
+        { name: "reapply_token_bindings", category: "tokens", summary: "Re-apply token bindings (scope: selection|page|document).", requiresDesignMode: true },
+        { name: "cross_file_sync_fetch", category: "tokens", summary: "Fetch remote variables for cross-file sync." },
+        { name: "cross_file_sync_apply", category: "tokens", summary: "Apply cross-file sync entries.", requiresDesignMode: true },
+    ]);
+    category("compositions", [
+        { name: "export_composition_json", category: "compositions", summary: "Single source of truth: composition JSON for a node.", requiresComposition: true },
+        { name: "get_codegen", category: "compositions", summary: "Mirror Dev Mode Inspect→Code for any node.", requiresComposition: true },
+        { name: "list_compositions", category: "compositions", summary: "Enumerate composition files in workspace.", requiresComposition: true },
+        { name: "generate_composition", category: "compositions", summary: "Generate Figma component/set from composition JSON.", requiresDesignMode: true, requiresComposition: true },
+        { name: "apply_composition", category: "compositions", summary: "Apply composition to an existing anchor.", requiresDesignMode: true, requiresComposition: true },
+        { name: "preview_composition", category: "compositions", summary: "Preview composition structure.", requiresComposition: true },
+        { name: "check_composition_linked", category: "compositions", summary: "Check if a composition is linked.", requiresComposition: true },
+        { name: "reapply_compositions", category: "compositions", summary: "Re-apply compositions (scope-based).", requiresDesignMode: true, requiresComposition: true },
+        { name: "remap_composition_id", category: "compositions", summary: "Remap a composition id to a new anchor.", requiresDesignMode: true, requiresComposition: true },
+        { name: "inspect_selection", category: "compositions", summary: "Inspect current selection." },
+    ]);
+    category("variables", [
+        { name: "get_variables", category: "variables", summary: "List local variable collections and variables." },
+        { name: "create_variable_collection", category: "variables", summary: "Create a new variable collection.", requiresDesignMode: true },
+        { name: "create_variable", category: "variables", summary: "Create a new variable inside a collection.", requiresDesignMode: true },
+        { name: "bind_variable", category: "variables", summary: "Bind a variable to a node property.", requiresDesignMode: true },
+        { name: "rename_variable", category: "variables", summary: "Rename a variable.", requiresDesignMode: true },
+        { name: "delete_variable", category: "variables", summary: "Delete a variable.", requiresDesignMode: true },
+        { name: "rename_variable_collection", category: "variables", summary: "Rename a variable collection.", requiresDesignMode: true },
+        { name: "delete_variable_collection", category: "variables", summary: "Delete a variable collection.", requiresDesignMode: true },
+        { name: "add_variable_mode", category: "variables", summary: "Add a mode to a collection.", requiresDesignMode: true },
+        { name: "remove_variable_mode", category: "variables", summary: "Remove a mode from a collection.", requiresDesignMode: true },
+        { name: "rename_variable_mode", category: "variables", summary: "Rename a mode.", requiresDesignMode: true },
+        { name: "set_variable_mode_value", category: "variables", summary: "Set variable value for a mode.", requiresDesignMode: true },
+        { name: "set_variable_scopes", category: "variables", summary: "Set variable scopes.", requiresDesignMode: true },
+        { name: "set_variable_code_syntax", category: "variables", summary: "Set variable codeSyntax per platform.", requiresDesignMode: true },
+    ]);
+    category("styles", [
+        { name: "get_local_styles", category: "styles", summary: "List local paint/text/effect styles." },
+        { name: "create_paint_style", category: "styles", summary: "Create a local PaintStyle.", requiresDesignMode: true },
+        { name: "create_text_style", category: "styles", summary: "Create a local TextStyle.", requiresDesignMode: true },
+        { name: "create_effect_style", category: "styles", summary: "Create a local EffectStyle.", requiresDesignMode: true },
+        { name: "set_text_style", category: "styles", summary: "Assign a TextStyle to a node.", requiresDesignMode: true },
+        { name: "set_effect_style", category: "styles", summary: "Assign an EffectStyle to a node.", requiresDesignMode: true },
+        { name: "set_stroke_style", category: "styles", summary: "Assign a PaintStyle to a node stroke.", requiresDesignMode: true },
+        { name: "set_fill_style", category: "styles", summary: "Assign a PaintStyle to a node fill.", requiresDesignMode: true },
+        { name: "import_style_by_key", category: "styles", summary: "Import a published style by key.", requiresDesignMode: true },
+    ]);
+    category("canvas", [
+        { name: "get_selection", category: "canvas", summary: "Current selection with node ids." },
+        { name: "set_selection", category: "canvas", summary: "Select nodes.", requiresDesignMode: true },
+        { name: "select_nodes", category: "canvas", summary: "Select nodes (alias).", requiresDesignMode: true },
+        { name: "get_pages", category: "canvas", summary: "List document pages." },
+        { name: "set_current_page", category: "canvas", summary: "Change current page.", requiresDesignMode: true },
+        { name: "get_node_info", category: "canvas", summary: "Basic info about one node." },
+        { name: "get_node_tree", category: "canvas", summary: "Full scene subtree." },
+        { name: "get_page_structure", category: "canvas", summary: "Summary of current page structure." },
+        { name: "read_node_properties", category: "canvas", summary: "Read canonical node properties." },
+        { name: "find_nodes", category: "canvas", summary: "Find nodes by predicate." },
+        { name: "list_components", category: "canvas", summary: "List local components." },
+        { name: "list_available_fonts", category: "canvas", summary: "Available fonts (+ project text styles hint)." },
+        { name: "export_as_svg", category: "canvas", summary: "Export node(s) as SVG." },
+        { name: "notify", category: "canvas", summary: "Figma toast notification." },
+        { name: "create_frame", category: "canvas", summary: "Create a frame.", requiresDesignMode: true },
+        { name: "create_rectangle", category: "canvas", summary: "Create a rectangle.", requiresDesignMode: true },
+        { name: "create_text", category: "canvas", summary: "Create a text node.", requiresDesignMode: true },
+        { name: "create_ellipse", category: "canvas", summary: "Create an ellipse.", requiresDesignMode: true },
+        { name: "create_line", category: "canvas", summary: "Create a line.", requiresDesignMode: true },
+        { name: "create_svg_node", category: "canvas", summary: "Create a node from SVG string.", requiresDesignMode: true },
+        { name: "create_vector", category: "canvas", summary: "Create a vector node.", requiresDesignMode: true },
+        { name: "set_auto_layout", category: "canvas", summary: "Configure auto layout.", requiresDesignMode: true },
+        { name: "modify_node", category: "canvas", summary: "Modify generic node properties.", requiresDesignMode: true },
+        { name: "set_node_text", category: "canvas", summary: "Set text on a text node.", requiresDesignMode: true },
+        { name: "set_node_property", category: "canvas", summary: "Set arbitrary node property.", requiresDesignMode: true },
+        { name: "rename_node", category: "canvas", summary: "Rename a node.", requiresDesignMode: true },
+        { name: "set_node_visibility", category: "canvas", summary: "Show/hide node.", requiresDesignMode: true },
+        { name: "set_node_size", category: "canvas", summary: "Resize a node.", requiresDesignMode: true },
+        { name: "set_node_fill", category: "canvas", summary: "Set solid fill.", requiresDesignMode: true },
+        { name: "set_node_fill_variable", category: "canvas", summary: "Bind a variable as fill.", requiresDesignMode: true },
+        { name: "set_stroke", category: "canvas", summary: "Set stroke.", requiresDesignMode: true },
+        { name: "set_effects", category: "canvas", summary: "Set effects array.", requiresDesignMode: true },
+        { name: "set_fill", category: "canvas", summary: "Set fills array.", requiresDesignMode: true },
+        { name: "set_image_fill", category: "canvas", summary: "Set image fill from bytes.", requiresDesignMode: true },
+        { name: "set_constraints", category: "canvas", summary: "Set layout constraints.", requiresDesignMode: true },
+        { name: "style_text_range", category: "canvas", summary: "Style a text range.", requiresDesignMode: true },
+        { name: "insert_data", category: "canvas", summary: "Insert raw payload onto the page.", requiresDesignMode: true },
+        { name: "delete_node", category: "canvas", summary: "Delete one node.", requiresDesignMode: true },
+        { name: "delete_nodes", category: "canvas", summary: "Delete many nodes.", requiresDesignMode: true },
+        { name: "clone_node", category: "canvas", summary: "Clone a node.", requiresDesignMode: true },
+        { name: "duplicate_subtree", category: "canvas", summary: "Duplicate a subtree.", requiresDesignMode: true },
+        { name: "move_to_parent", category: "canvas", summary: "Reparent a node.", requiresDesignMode: true },
+        { name: "create_component", category: "canvas", summary: "Create a component.", requiresDesignMode: true },
+        { name: "create_component_set", category: "canvas", summary: "Create a component set.", requiresDesignMode: true },
+        { name: "create_component_instance", category: "canvas", summary: "Create an instance of a component.", requiresDesignMode: true },
+        { name: "detach_instance", category: "canvas", summary: "Detach an instance.", requiresDesignMode: true },
+        { name: "import_component_by_key", category: "canvas", summary: "Import a published component by key.", requiresDesignMode: true },
+        { name: "boolean_operation", category: "canvas", summary: "Boolean op on nodes.", requiresDesignMode: true },
+        { name: "flatten_nodes", category: "canvas", summary: "Flatten nodes.", requiresDesignMode: true },
+        { name: "apply_documentation_payload", category: "canvas", summary: "Apply SXL documentation payload.", requiresDesignMode: true },
+    ]);
+    category("data", [
+        { name: "apply_mapping", category: "data", summary: "Apply a mapping to a node.", requiresDesignMode: true },
+        { name: "apply_all_mappings", category: "data", summary: "Apply all mappings.", requiresDesignMode: true },
+        { name: "count_apply_targets", category: "data", summary: "Count mapping targets." },
+        { name: "generate_instances", category: "data", summary: "Generate instances from mapping.", requiresDesignMode: true },
+        { name: "apply_image", category: "data", summary: "Apply an image asset.", requiresDesignMode: true },
+        { name: "rebind_instance", category: "data", summary: "Rebind an instance to a new main.", requiresDesignMode: true },
+        { name: "codeconnect_get_binding", category: "data", summary: "Get Code Connect binding for node." },
+        { name: "codeconnect_save_binding", category: "data", summary: "Save Code Connect binding." },
+        { name: "codeconnect_get_selection_status", category: "data", summary: "Code Connect status for selection." },
+        { name: "codeconnect_get_registry", category: "data", summary: "Code Connect registry snapshot." },
+        { name: "codeconnect_get_global_settings", category: "data", summary: "Global Code Connect settings." },
+        { name: "codeconnect_save_global_settings", category: "data", summary: "Save global Code Connect settings." },
+        { name: "codeconnect_get_node_ui_status", category: "data", summary: "Code Connect node UI status." },
+    ]);
+    category("git", [
+        { name: "git_pull", category: "git", summary: "Pull from active Git connection." },
+        { name: "git_hard_pull", category: "git", summary: "Hard pull (overwrite local)." },
+        { name: "git_push", category: "git", summary: "Push to active Git connection." },
+    ]);
+    category("orchestration", [
+        { name: "generate_code_from_url", category: "orchestration", summary: "Parse Figma URL → run get_codegen on target node.", requiresComposition: true },
+        { name: "compose_from_url", category: "orchestration", summary: "Parse Figma URL → export_composition_json → save as composition file → optional generate.", requiresComposition: true },
+        { name: "document_component", category: "orchestration", summary: "Generate SXL documentation payload for a component and apply it.", requiresDesignMode: true, requiresComposition: true },
+        { name: "list_tools", category: "orchestration", summary: "List all Bridge MCP tools with metadata." },
+    ]);
+}
+//# sourceMappingURL=catalogue-bootstrap.js.map

package/dist/tools/catalogue-bootstrap.js.map

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

package/dist/tools/composition.d.ts

@@ -1,6 +1,6 @@
 /**
  * MCP tools for Composition operations.
  */
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { McpServer } from "../../node_modules/@modelcontextprotocol/sdk/dist/cjs/server/mcp.js";
 import type { CommandQueue } from "../command-queue.js";
 export declare function registerCompositionTools(server: McpServer, queue: CommandQueue): void;

package/dist/tools/composition.js

@@ -3,7 +3,7 @@
  */
 import { z } from "zod";
 export function registerCompositionTools(server, queue) {
-    server.tool("generate_composition", "Generate a Figma component (or ComponentSet) from a composition JSON file. Creates the component structure, applies styles, binds variables. The fileId can be an internal file ID or a file path like 'compositions/MyButton/MyButton.json'.", {
+    server.tool("generate_composition", "Generate a Figma component (or ComponentSet) from a composition JSON file. Creates the component structure, applies styles, binds variables. When the JSON has \"component\": false, creates plain nodes (Frame/Instance) instead of a Component. The fileId can be an internal file ID or a file path like 'compositions/MyButton/MyButton.json'.", {
         fileId: z.string().describe("File path (e.g. 'compositions/MyButton/MyButton.json') or internal file ID"),
         compositionName: z.string().optional().describe("Component name from JSON (e.g. 'MyButton') — used as fallback if fileId doesn't resolve"),
     }, async ({ fileId, compositionName }) => {
@@ -31,7 +31,7 @@ export function registerCompositionTools(server, queue) {
         const result = await queue.execute("inspect_selection");
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
     });
-    server.tool("export_composition_json", "Export the selected node (or a node by ID) as composition JSON string, same format as Dev Tool codegen. Requires design mode with a selection unless nodeId is set.", {
+    server.tool("export_composition_json", "Export the selected node (or a node by ID) as composition JSON string — the SINGLE SOURCE OF TRUTH for composition JSON. Produces the exact same output as Dev Mode → Get Code → Designer JSON tab. For non-component nodes (Frame, Group, etc.) the output includes \"component\": false so the JSON can be used to regenerate plain nodes. NEVER hand-craft this JSON from get_node_tree / get_selection — always use this tool.", {
         nodeId: z
             .string()
             .optional()
@@ -43,5 +43,33 @@ export function registerCompositionTools(server, queue) {
         const result = await queue.execute("export_composition_json", payload);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
     });
+    server.tool("get_codegen", "Run Figma Dev Mode codegen for the selected node (or by nodeId) and return all generated tabs. This exposes the exact same output the user sees in Dev Mode → Inspect → Code panel, for any language: designer-json (default, includes Props/Structure/Styles/Variables/Transitions/Theme/Code Connect tabs), vue3 (SFC + CSS vars + Code Connect), swiftui (Swift file + Variables), kotlin (Compose file + Variables). Use viewMode to switch between 'styled' (default, tokens preserved), 'decomposed' (composite styles expanded) or 'raw' (all literals).", {
+        nodeId: z
+            .string()
+            .optional()
+            .describe("Figma node id. Omit to use current selection (first selected node)."),
+        language: z
+            .enum(["designer-json", "vue3", "swiftui", "kotlin"])
+            .optional()
+            .describe("Target language for codegen. Defaults to 'designer-json'."),
+        viewMode: z
+            .enum(["styled", "decomposed", "raw"])
+            .optional()
+            .describe("Style resolution mode. 'styled' (default) preserves tokens, 'decomposed' expands composite styles, 'raw' resolves everything to literals."),
+    }, async ({ nodeId, language, viewMode }) => {
+        const payload = {};
+        if (nodeId)
+            payload.nodeId = nodeId;
+        if (language)
+            payload.language = language;
+        if (viewMode)
+            payload.viewMode = viewMode;
+        const result = await queue.execute("get_codegen", payload);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+    server.tool("list_compositions", "List every composition JSON file in the plugin workspace (entries with $type:composition). Returns fileId, fileName, folder, gitPath, compositionName, and whether it represents a Component (component:true) or plain Frames (component:false). Use this to discover targets for generate_composition / apply_composition.", {}, async () => {
+        const result = await queue.execute("list_compositions", {});
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
 }
 //# sourceMappingURL=composition.js.map