@sxl-studio/bridge 1.7.2 → 1.7.3

package/dist/tools/variable-defs.js

@@ -0,0 +1,338 @@
+import { z } from "zod";
+import { figmaRestGet, fileKeyFromArgs, FigmaRestError, } from "../figma-rest.js";
+import { largeDataResponseArgs, normalizeLargeDataResult } from "./large-data.js";
+import { err, executePluginCommand, ok } from "./shared.js";
+const variableDefsModeZod = z.enum(["auto", "selection", "local", "enabled-libraries", "rest"]);
+const variableResolvedTypeZod = z.enum(["COLOR", "FLOAT", "STRING", "BOOLEAN"]);
+const restScopeZod = z.enum(["local", "published", "both"]);
+const authModeZod = z.enum(["bearer", "x-figma-token"]);
+const tokenEnvZod = z
+    .string()
+    .regex(/^[A-Z0-9_]+$/)
+    .optional()
+    .describe("Environment variable containing the Figma REST token. Default: FIGMA_TOKEN, FIGMA_ACCESS_TOKEN, or FIGMA_REST_TOKEN.");
+function normalizeNodeIds(args) {
+    const ids = new Set();
+    if (args.nodeId?.trim())
+        ids.add(args.nodeId.trim());
+    for (const id of args.nodeIds ?? []) {
+        if (typeof id === "string" && id.trim())
+            ids.add(id.trim());
+    }
+    return Array.from(ids);
+}
+function pluginRetryable(error) {
+    return /No plugin connected|Session disconnected/i.test(error instanceof Error ? error.message : String(error));
+}
+function pluginErrorResponse(error, code) {
+    return err(error instanceof Error ? error.message : String(error), {
+        code,
+        retryable: pluginRetryable(error),
+    });
+}
+function restErrorResponse(error) {
+    if (error instanceof FigmaRestError) {
+        return err(error.message, {
+            code: "FIGMA_REST_ERROR",
+            status: error.status,
+            endpoint: error.endpoint,
+            body: error.body,
+            retryable: error.status === 429 || error.status >= 500,
+        });
+    }
+    return err(error instanceof Error ? error.message : String(error), {
+        code: "GET_VARIABLE_DEFS_REST_ERROR",
+        retryable: false,
+    });
+}
+function selectionNodeIds(summary) {
+    if (!summary || typeof summary !== "object")
+        return [];
+    const record = summary;
+    const nodes = Array.isArray(record.nodes)
+        ? record.nodes
+        : Array.isArray(record.selection)
+            ? record.selection
+            : [];
+    return nodes
+        .filter((node) => typeof node === "object" && node !== null)
+        .map((node) => typeof node.id === "string" ? node.id : "")
+        .filter(Boolean);
+}
+function resolvedTypes(args) {
+    const values = new Set();
+    if (args.resolvedType)
+        values.add(args.resolvedType);
+    for (const type of args.resolvedTypes ?? [])
+        values.add(type);
+    return Array.from(values);
+}
+async function getLocalDefs(queue, args) {
+    const includeVariables = args.includeLocalVariables !== false;
+    const includeStyles = args.includeLocalStyles !== false;
+    const local = {
+        ok: true,
+        source: "plugin-local-definitions",
+    };
+    if (includeVariables) {
+        const types = resolvedTypes(args);
+        if (types.length <= 1) {
+            local.variables = await executePluginCommand(queue, "get_variables", {
+                ...(types[0] ? { type: types[0] } : {}),
+                limit: args.limit,
+            });
+        }
+        else {
+            local.variables = {
+                ok: true,
+                source: "plugin-local-definitions-by-type",
+                types,
+                results: await Promise.all(types.map((type) => executePluginCommand(queue, "get_variables", {
+                    type,
+                    limit: args.limit,
+                }))),
+            };
+        }
+    }
+    if (includeStyles) {
+        local.styles = await executePluginCommand(queue, "get_local_styles");
+    }
+    return local;
+}
+async function getSelectionDefs(queue, args) {
+    const warnings = [];
+    const result = {
+        ok: true,
+        source: "plugin-selection-variable-defs",
+    };
+    let summary;
+    if (args.includeSelectionSummary !== false) {
+        summary = await executePluginCommand(queue, "get_selection_summary");
+        result.selectionSummary = summary;
+    }
+    let ids = normalizeNodeIds(args);
+    if (ids.length === 0)
+        ids = selectionNodeIds(summary);
+    const maxSelectionNodes = Math.max(1, Math.min(200, args.maxSelectionNodes ?? 50));
+    const scannedIds = ids.slice(0, maxSelectionNodes);
+    result.nodeIds = scannedIds;
+    result.truncatedSelection = ids.length > scannedIds.length;
+    if (args.includeNativeSelectionDefs !== false) {
+        try {
+            result.native = await executePluginCommand(queue, "get_selection_variable_defs", {
+                nodeIds: scannedIds.length > 0 ? scannedIds : undefined,
+                includeTextSegments: args.includeTextSegments,
+                includeResolvedValues: args.includeResolvedValues,
+                includeStyleBoundVariables: args.includeStyleBoundVariables,
+                maxNodes: args.maxNodes,
+                maxUsages: args.maxUsages,
+                maxTextSegments: args.maxTextSegments,
+                maxDefinitions: args.maxDefinitions,
+            });
+        }
+        catch (error) {
+            warnings.push(`native selection variable definitions failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    if (args.includeAppliedTokens !== false) {
+        const appliedTokens = [];
+        const tokenTargets = scannedIds.length > 0 ? scannedIds : [undefined];
+        for (const nodeId of tokenTargets) {
+            try {
+                appliedTokens.push(await executePluginCommand(queue, "get_applied_tokens", nodeId ? { nodeId } : {}));
+            }
+            catch (error) {
+                warnings.push(`get_applied_tokens${nodeId ? ` for ${nodeId}` : ""} failed: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        result.appliedTokens = appliedTokens;
+    }
+    if (args.includeLocalContext !== false) {
+        try {
+            result.local = await getLocalDefs(queue, args);
+        }
+        catch (error) {
+            warnings.push(`local definitions failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    if (warnings.length > 0)
+        result.warnings = warnings;
+    return result;
+}
+function hasEnabledLibraryFilter(args) {
+    return Boolean(args.collectionKey ||
+        args.collectionName ||
+        args.libraryName ||
+        (Array.isArray(args.collectionKeys) && args.collectionKeys.length > 0));
+}
+async function getEnabledLibraryDefs(queue, args) {
+    const includeDescriptors = args.includeEnabledLibraryDescriptors !== false;
+    const includeVariables = args.includeEnabledLibraryVariables !== false;
+    const result = {
+        ok: true,
+        source: "plugin-enabled-library-definitions",
+    };
+    const warnings = [];
+    if (includeDescriptors) {
+        result.descriptors = await executePluginCommand(queue, "inspect_enabled_libraries", {
+            query: args.query,
+            limitPerKind: args.limit,
+            includeVariableCollections: true,
+            includeStyles: true,
+            includeComponents: true,
+        });
+    }
+    if (includeVariables) {
+        result.variables = await executePluginCommand(queue, "list_enabled_library_variables", {
+            collectionKey: args.collectionKey,
+            collectionKeys: args.collectionKeys,
+            collectionName: args.collectionName,
+            libraryName: args.libraryName,
+            includeAllCollections: args.includeAllCollections ?? !hasEnabledLibraryFilter(args),
+            resolvedTypes: resolvedTypes(args),
+            query: args.query,
+            limit: args.limit,
+        });
+    }
+    if (warnings.length > 0)
+        result.warnings = warnings;
+    return result;
+}
+async function getRestDefs(args) {
+    const fileKey = fileKeyFromArgs(args);
+    const scope = args.restScope ?? "local";
+    const scopes = scope === "both"
+        ? ["local", "published"]
+        : [scope === "published" ? "published" : "local"];
+    const rest = {
+        ok: true,
+        source: "figma-rest-variable-definitions",
+        fileKey,
+        scope,
+    };
+    const errors = [];
+    for (const item of scopes) {
+        const endpoint = `/v1/files/${fileKey}/variables/${item}`;
+        try {
+            rest[item] = await figmaRestGet(endpoint, {
+                tokenEnv: args.tokenEnv,
+                authMode: args.authMode,
+                apiBaseUrl: args.apiBaseUrl,
+            });
+        }
+        catch (error) {
+            errors.push({
+                scope: item,
+                message: error instanceof Error ? error.message : String(error),
+                status: error instanceof FigmaRestError ? error.status : undefined,
+                endpoint: error instanceof FigmaRestError ? error.endpoint : endpoint,
+            });
+        }
+    }
+    if (errors.length > 0) {
+        rest.errors = errors;
+        if (errors.length === scopes.length) {
+            throw new FigmaRestError({
+                status: errors[0]?.status ?? 500,
+                endpoint: errors[0]?.endpoint ?? `/v1/files/${fileKey}/variables/${scope}`,
+                message: errors[0]?.message ?? "Figma REST variable definitions failed",
+                body: errors,
+            });
+        }
+    }
+    return rest;
+}
+function autoMode(args) {
+    if (args.fileKey || args.url)
+        return "rest";
+    if (args.includeEnabledLibraryVariables === true || args.includeEnabledLibraryDescriptors === true) {
+        return "enabled-libraries";
+    }
+    return "selection";
+}
+function limitations(mode) {
+    const base = [
+        "Official Figma MCP get_variable_defs is selection-oriented; Bridge also exposes local, enabled-library, and REST definition modes for SXL workflows.",
+    ];
+    if (mode === "selection") {
+        base.push("Selection mode prefers native Figma boundVariables/styleId graph via Remote Connect; SXL applied token metadata and local definitions are included as compatibility context.", "Consumer-specific resolved values and text segment bindings are bounded and best-effort to keep Remote Connect responsive.");
+    }
+    if (mode === "enabled-libraries") {
+        base.push("Enabled-library mode only sees libraries already enabled in the active Figma file; the Figma Plugin API cannot enable or discover arbitrary organization/community libraries.");
+    }
+    if (mode === "rest") {
+        base.push("REST mode requires a configured Figma REST token and file_variables:read permission; it reads file-level variable endpoints, not the current desktop selection.");
+    }
+    return base;
+}
+export function registerVariableDefTools(server, queue) {
+    server.tool("get_variable_defs", "Bridge variable-definition orchestration. Selection mode approximates official Figma MCP get_variable_defs for the active Figma Design selection; local, enabled-libraries, and rest modes expose SXL/local-library/known-file definitions for broader workflows.", {
+        mode: variableDefsModeZod.optional(),
+        nodeId: z.string().optional(),
+        nodeIds: z.array(z.string()).optional(),
+        maxSelectionNodes: z.number().int().positive().max(200).optional(),
+        maxNodes: z.number().int().positive().max(100_000).optional().describe("Selection mode native graph: maximum scene nodes to scan."),
+        maxUsages: z.number().int().positive().max(50_000).optional().describe("Selection mode native graph: maximum usage rows to return."),
+        maxTextSegments: z.number().int().positive().max(50_000).optional().describe("Selection mode native graph: maximum text segments to inspect."),
+        maxDefinitions: z.number().int().positive().max(10_000).optional().describe("Selection/local graph: maximum variable/style definitions to resolve."),
+        includeSelectionSummary: z.boolean().optional(),
+        includeAppliedTokens: z.boolean().optional(),
+        includeNativeSelectionDefs: z.boolean().optional(),
+        includeTextSegments: z.boolean().optional(),
+        includeResolvedValues: z.boolean().optional(),
+        includeStyleBoundVariables: z.boolean().optional(),
+        includeLocalContext: z.boolean().optional(),
+        includeLocalVariables: z.boolean().optional(),
+        includeLocalStyles: z.boolean().optional(),
+        includeEnabledLibraryDescriptors: z.boolean().optional(),
+        includeEnabledLibraryVariables: z.boolean().optional(),
+        collectionKey: z.string().optional(),
+        collectionKeys: z.array(z.string()).optional(),
+        collectionName: z.string().optional(),
+        libraryName: z.string().optional(),
+        includeAllCollections: z.boolean().optional(),
+        resolvedType: variableResolvedTypeZod.optional(),
+        resolvedTypes: z.array(variableResolvedTypeZod).optional(),
+        query: z.string().optional(),
+        limit: z.number().int().positive().max(10_000).optional(),
+        restScope: restScopeZod.optional(),
+        fileKey: z.string().optional().describe("Figma file key for REST variable definitions. Provide this or url for rest mode."),
+        url: z.string().url().optional().describe("Figma file/node URL. Used to extract fileKey when fileKey is omitted."),
+        tokenEnv: tokenEnvZod,
+        authMode: authModeZod.optional().describe("Figma REST auth header mode. Default: FIGMA_AUTH_MODE or x-figma-token."),
+        apiBaseUrl: z.string().url().optional().describe("Figma REST API base URL. Default: https://api.figma.com."),
+        ...largeDataResponseArgs,
+    }, async (rawArgs) => {
+        const args = rawArgs;
+        const mode = args.mode ?? "auto";
+        const resolvedMode = mode === "auto" ? autoMode(args) : mode;
+        const result = {
+            ok: true,
+            tool: "get_variable_defs",
+            requestedMode: mode,
+            mode: resolvedMode,
+            limitations: limitations(resolvedMode),
+        };
+        try {
+            if (resolvedMode === "selection") {
+                result.selection = await getSelectionDefs(queue, args);
+            }
+            else if (resolvedMode === "local") {
+                result.local = await getLocalDefs(queue, args);
+            }
+            else if (resolvedMode === "enabled-libraries") {
+                result.enabledLibraries = await getEnabledLibraryDefs(queue, args);
+            }
+            else {
+                result.rest = await getRestDefs(args);
+            }
+            return ok(normalizeLargeDataResult("get_variable_defs", args, result));
+        }
+        catch (error) {
+            if (resolvedMode === "rest")
+                return restErrorResponse(error);
+            return pluginErrorResponse(error, "GET_VARIABLE_DEFS_PLUGIN_ERROR");
+        }
+    });
+}
+//# sourceMappingURL=variable-defs.js.map

package/dist/tools/variable-defs.js.map

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

package/dist/tools/variables-orchestration.js

@@ -16,7 +16,7 @@
  *     `dryRun: false` to commit.
  */
 import { z } from "zod";
-import { callPluginCommand } from "./shared.js";
+import { callPluginCommand, callPluginWriteCommand } from "./shared.js";
 const variableValueLiteralZod = z.union([
     z.number(),
     z.string(),
@@ -79,7 +79,9 @@ const dedupeStrategyZod = z.enum(["byName", "byDefaultModeValue"]);
 export function registerVariablesOrchestrationTools(server, queue) {
     server.tool("import_variable_spec", "Idempotent bulk-create / update of Variables from a single declarative spec. Creates collections + modes + variables, applies per-mode literal values, then resolves aliases in a second pass so cross-collection references work. Errors are collected per-item without aborting the run. Pass `dryRun: true` for a preview (returns the diff and skips Figma writes). CANVAS WRITE in apply mode — blocked in Dev Mode.", {
         spec: variableSpecZod.describe("Top-level spec. `collections[]` is required; each collection identifies itself by `collectionId` (existing) or `collectionName` (resolves existing or creates new). Variable values support `{ value }` literals (hex strings auto-coerce for COLOR), `{ alias: { variableId | variableName } }`, or `{ rawAlias }` passthrough."),
-    }, async ({ spec }) => callPluginCommand(queue, "import_variable_spec", { spec }));
+    }, async ({ spec }) => callPluginWriteCommand(queue, "import_variable_spec", { spec }, {
+        okFalseErrorCode: "SXL_VARIABLE_WRITE_FAILED",
+    }));
     server.tool("analyze_variable_order", "READ-ONLY: produce a recommended order of variables inside a collection. Returns `moves[]` describing every position that would change. Strategies: `alphabetical`, `byPath` (with optional separator), `explicit` (caller-supplied list). Figma Plugin API does not expose a stable `move` primitive, so this command stays diff-only — use it to drive a manual reorder in the Variables panel.", {
         collectionId: z.string().describe("Variable collection id (VariableCollectionId:...)"),
         strategy: reorderStrategyZod,
@@ -91,7 +93,9 @@ export function registerVariablesOrchestrationTools(server, queue) {
             .string()
             .optional()
             .describe("Restrict the scan to a single collection. Default: scan all local variables."),
-    }, async (args) => callPluginCommand(queue, "dedupe_variables", args));
+    }, async (args) => callPluginWriteCommand(queue, "dedupe_variables", args, {
+        okFalseErrorCode: "SXL_VARIABLE_WRITE_FAILED",
+    }));
     server.tool("rebind_variable_aliases", "Bulk rewrite alias targets inside Variable collections. Each `{ fromVariableId, toVariableId }` pair redirects every `valuesByMode` entry that aliases the source so it points at the target. Read-only nodes / bindings are NOT touched (use `apply_coverage_suggestions` for that). Pass `dryRun: true` to count rewrites without writing.", {
         mappings: z
             .array(z.object({
@@ -100,7 +104,9 @@ export function registerVariablesOrchestrationTools(server, queue) {
         }))
             .min(1),
         dryRun: z.boolean().optional().describe("When true, count rewrites without applying. Default: false."),
-    }, async (args) => callPluginCommand(queue, "rebind_variable_aliases", args));
+    }, async (args) => callPluginWriteCommand(queue, "rebind_variable_aliases", args, {
+        okFalseErrorCode: "SXL_VARIABLE_WRITE_FAILED",
+    }));
     server.tool("apply_coverage_suggestions", "Apply the `suggestion` entries from `audit_variable_coverage` / `find_variable_coverage_misses`. Translates property paths like `fills[0].color`, `effects[2].color`, `cornerRadius` etc. into Figma `setBoundVariableForPaint` / `setBoundVariableForEffect` / `setBoundVariable` writes. Default mode is dry-run — agent receives a `preview[]` it can show the user. Set `dryRun: false` to commit. CANVAS WRITE only when `dryRun: false`.", {
         suggestions: z
             .array(z.object({
@@ -111,6 +117,8 @@ export function registerVariablesOrchestrationTools(server, queue) {
         }))
             .min(1),
         dryRun: z.boolean().optional().describe("Default: true. Pass false to actually wire bindings."),
-    }, async (args) => callPluginCommand(queue, "apply_coverage_suggestions", args));
+    }, async (args) => callPluginWriteCommand(queue, "apply_coverage_suggestions", args, {
+        okFalseErrorCode: "SXL_VARIABLE_WRITE_FAILED",
+    }));
 }
 //# sourceMappingURL=variables-orchestration.js.map

package/dist/tools/variables-orchestration.js.map

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

package/dist/tools/variables.js

@@ -7,46 +7,48 @@
  * typed EDITOR_MODE_READONLY error in Dev Mode).
  */
 import { z } from "zod";
-import { callPluginCommand } from "./shared.js";
+import { callPluginWriteCommand } from "./shared.js";
+import { destructiveConfirmationArgs, withDestructiveConfirmation } from "./destructive-confirmation.js";
 const CODE_SYNTAX_PLATFORMS = ["WEB", "iOS", "ANDROID"];
 export function registerVariableTools(server, queue) {
     server.tool("rename_variable", "Rename a Figma local variable.", {
         variableId: z.string().describe("Variable id (VariableID:...)"),
         name: z.string().describe("New variable name"),
-    }, async ({ variableId, name }) => callPluginCommand(queue, "rename_variable", { variableId, name }));
-    server.tool("delete_variable", "Delete a Figma local variable.", { variableId: z.string().describe("Variable id") }, async ({ variableId }) => callPluginCommand(queue, "delete_variable", { variableId }));
+    }, async ({ variableId, name }) => callPluginWriteCommand(queue, "rename_variable", { variableId, name }));
+    server.tool("delete_variable", "Delete a Figma local variable.", { variableId: z.string().describe("Variable id"), ...destructiveConfirmationArgs }, async ({ variableId, confirmDestructive, destructiveReason }) => callPluginWriteCommand(queue, "delete_variable", withDestructiveConfirmation({ variableId }, { confirmDestructive, destructiveReason })));
     server.tool("rename_variable_collection", "Rename a Figma local variable collection.", {
         collectionId: z.string().describe("Collection id (VariableCollectionId:...)"),
         name: z.string().describe("New collection name"),
-    }, async ({ collectionId, name }) => callPluginCommand(queue, "rename_variable_collection", { collectionId, name }));
-    server.tool("delete_variable_collection", "Delete a Figma local variable collection (and all variables inside it).", { collectionId: z.string().describe("Collection id") }, async ({ collectionId }) => callPluginCommand(queue, "delete_variable_collection", { collectionId }));
+    }, async ({ collectionId, name }) => callPluginWriteCommand(queue, "rename_variable_collection", { collectionId, name }));
+    server.tool("delete_variable_collection", "Delete a Figma local variable collection (and all variables inside it).", { collectionId: z.string().describe("Collection id"), ...destructiveConfirmationArgs }, async ({ collectionId, confirmDestructive, destructiveReason }) => callPluginWriteCommand(queue, "delete_variable_collection", withDestructiveConfirmation({ collectionId }, { confirmDestructive, destructiveReason })));
     server.tool("add_variable_mode", "Add a new mode to a variable collection.", {
         collectionId: z.string().describe("Collection id"),
         modeName: z.string().describe("Mode display name"),
-    }, async ({ collectionId, modeName }) => callPluginCommand(queue, "add_variable_mode", { collectionId, modeName }));
+    }, async ({ collectionId, modeName }) => callPluginWriteCommand(queue, "add_variable_mode", { collectionId, modeName }));
     server.tool("remove_variable_mode", "Remove a mode from a variable collection.", {
         collectionId: z.string().describe("Collection id"),
         modeId: z.string().describe("Mode id to remove"),
-    }, async ({ collectionId, modeId }) => callPluginCommand(queue, "remove_variable_mode", { collectionId, modeId }));
+        ...destructiveConfirmationArgs,
+    }, async ({ collectionId, modeId, confirmDestructive, destructiveReason }) => callPluginWriteCommand(queue, "remove_variable_mode", withDestructiveConfirmation({ collectionId, modeId }, { confirmDestructive, destructiveReason })));
     server.tool("rename_variable_mode", "Rename a mode inside a variable collection.", {
         collectionId: z.string().describe("Collection id"),
         modeId: z.string().describe("Mode id"),
         name: z.string().describe("New mode name"),
-    }, async ({ collectionId, modeId, name }) => callPluginCommand(queue, "rename_variable_mode", { collectionId, modeId, name }));
+    }, async ({ collectionId, modeId, name }) => callPluginWriteCommand(queue, "rename_variable_mode", { collectionId, modeId, name }));
     server.tool("set_variable_mode_value", "Set a variable's value for a specific mode. For COLOR variables, value can be a hex string (e.g. '#ff0000' or '#ff0000ff') or an RGBA object. For other types, forward a native value (number / string / boolean / VariableAlias).", {
         variableId: z.string().describe("Variable id"),
         modeId: z.string().describe("Mode id"),
         value: z.unknown().describe("Value to set (type depends on variable.resolvedType)"),
-    }, async ({ variableId, modeId, value }) => callPluginCommand(queue, "set_variable_mode_value", { variableId, modeId, value }));
+    }, async ({ variableId, modeId, value }) => callPluginWriteCommand(queue, "set_variable_mode_value", { variableId, modeId, value }));
     server.tool("set_variable_scopes", "Set the Variable.scopes array. Pass an array of scope names accepted by Figma (e.g. ['ALL_SCOPES'], ['CORNER_RADIUS','STROKE_FLOAT']).", {
         variableId: z.string().describe("Variable id"),
         scopes: z.array(z.string()).describe("Array of VariableScope values"),
-    }, async ({ variableId, scopes }) => callPluginCommand(queue, "set_variable_scopes", { variableId, scopes }));
+    }, async ({ variableId, scopes }) => callPluginWriteCommand(queue, "set_variable_scopes", { variableId, scopes }));
     server.tool("set_variable_code_syntax", "Set (or remove) codeSyntax for a specific platform on a variable.", {
         variableId: z.string().describe("Variable id"),
         platform: z.enum(CODE_SYNTAX_PLATFORMS).describe("Platform: WEB | iOS | ANDROID"),
         value: z.string().nullable().optional().describe("New codeSyntax value. Pass null/empty to remove."),
-    }, async ({ variableId, platform, value }) => callPluginCommand(queue, "set_variable_code_syntax", {
+    }, async ({ variableId, platform, value }) => callPluginWriteCommand(queue, "set_variable_code_syntax", {
         variableId,
         platform,
         value: value ?? null,
@@ -79,7 +81,7 @@ export function registerVariableTools(server, queue) {
         }))
             .min(1)
             .describe("Variables to create in order"),
-    }, async ({ collectionId, variables }) => callPluginCommand(queue, "batch_create_variables", { collectionId, variables }));
+    }, async ({ collectionId, variables }) => callPluginWriteCommand(queue, "batch_create_variables", { collectionId, variables }));
     server.tool("batch_set_variable_values", "Set values for multiple (variableId, modeId, value) tuples in a single round-trip. Far more efficient than N set_variable_mode_value calls when populating or migrating a design system. Errors are per-entry without aborting the batch. Requires Design mode.", {
         values: z
             .array(z.object({
@@ -91,13 +93,14 @@ export function registerVariableTools(server, queue) {
         }))
             .min(1)
             .describe("(variableId, modeId, value) tuples"),
-    }, async ({ values }) => callPluginCommand(queue, "batch_set_variable_values", { values }));
+    }, async ({ values }) => callPluginWriteCommand(queue, "batch_set_variable_values", { values }));
     server.tool("batch_delete_variables", "Delete multiple Figma local variables at once. Errors are per-variable without aborting the batch. Use this instead of N delete_variable calls when clearing a collection or removing an entire token tier. Requires Design mode.", {
         variableIds: z
             .array(z.string())
             .min(1)
             .describe("Variable ids to delete (VariableID:...)"),
-    }, async ({ variableIds }) => callPluginCommand(queue, "batch_delete_variables", { variableIds }));
+        ...destructiveConfirmationArgs,
+    }, async ({ variableIds, confirmDestructive, destructiveReason }) => callPluginWriteCommand(queue, "batch_delete_variables", withDestructiveConfirmation({ variableIds }, { confirmDestructive, destructiveReason })));
     server.tool("batch_bind_variables", "Bind multiple Figma nodes to local variables in a single round-trip. Each entry maps a nodeId + field to a variableId. Errors are per-binding without aborting the batch. Use this after generate_composition or after creating nodes to wire variable bindings all at once. Requires Design mode.\n\nCommon field values: 'fills' (paint fill), 'strokes' (stroke fill), 'cornerRadius', 'topLeftRadius', 'topRightRadius', 'bottomLeftRadius', 'bottomRightRadius', 'paddingLeft', 'paddingRight', 'paddingTop', 'paddingBottom', 'itemSpacing', 'counterAxisSpacing', 'width', 'height', 'opacity', 'characters' (text content), 'fontSize', 'letterSpacing', 'lineHeight', 'paragraphSpacing', 'paragraphIndent', 'visible'.", {
         bindings: z
             .array(z.object({
@@ -109,6 +112,6 @@ export function registerVariableTools(server, queue) {
         }))
             .min(1)
             .describe("Bindings to apply"),
-    }, async ({ bindings }) => callPluginCommand(queue, "batch_bind_variables", { bindings }));
+    }, async ({ bindings }) => callPluginWriteCommand(queue, "batch_bind_variables", { bindings }));
 }
 //# sourceMappingURL=variables.js.map

package/dist/tools/variables.js.map

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

package/dist/types.d.ts

@@ -24,12 +24,56 @@ export type CommandResult = {
     events?: unknown[];
     durationMs?: number;
 };
+export type CommandTelemetrySource = "bridge" | "plugin";
+export type CommandTelemetryEvent = {
+    eventId: string;
+    at: number;
+    source: CommandTelemetrySource;
+    phase: string;
+    commandId: string | null;
+    commandType: string | null;
+    status: CommandStatus | null;
+    durationMs: number | null;
+    message: string | null;
+    payloadKeys: string[];
+    detailKeys: string[];
+};
+export type CommandTelemetrySummary = {
+    eventsBuffered: number;
+    bridgeEventsBuffered: number;
+    pluginEventsBuffered: number;
+    failuresBuffered: number;
+    timeoutsBuffered: number;
+    lastEventAt: number | null;
+    lastEventAgeMs: number | null;
+    lastFailureAt: number | null;
+    lastFailureAgeMs: number | null;
+    lastFailureCommandType: string | null;
+    lastFailureMessage: string | null;
+};
+export type CommandQueueItemSnapshot = {
+    commandId: string;
+    commandType: string;
+    status: CommandStatus;
+    createdAt: number;
+    startedAt: number | null;
+    completedAt: number | null;
+    ageMs: number;
+    runningMs: number | null;
+    payloadKeys: string[];
+};
+export type CommandQueueSnapshot = {
+    current: CommandQueueItemSnapshot | null;
+    queued: CommandQueueItemSnapshot[];
+    immediate: CommandQueueItemSnapshot[];
+};
 export type SessionInfo = {
     connected: boolean;
     pluginName: string | null;
     connectedAt: number | null;
     lastHeartbeat: number | null;
 };
+export type BridgeRuntimeHealth = "ready" | "busy" | "degraded" | "disconnected";
 export type BridgeStatus = {
     /** Single port: plugin WebSocket, HTTP REST, and MCP `/mcp` (same numeric value twice for older clients). */
     ports: {
@@ -41,4 +85,13 @@ export type BridgeStatus = {
     session: SessionInfo;
     queueLength: number;
     currentCommand: string | null;
+    queue: CommandQueueSnapshot;
+    runtime: {
+        startedAt: number;
+        uptimeMs: number;
+        health: BridgeRuntimeHealth;
+        issues: string[];
+    };
+    telemetry: CommandTelemetrySummary;
+    authEnabled: boolean;
 };