@ufira/vibma 0.3.2 → 1.0.0-rc1

package/dist/mcp.cjs

@@ -25,13 +25,18 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 // src/mcp.ts
 var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
 var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
-var import_zod18 = require("zod");
 var import_ws = __toESM(require("ws"), 1);
 var import_uuid = require("uuid");
 var import_fs = require("fs");
 var import_path = require("path");
 var import_url = require("url");
 
+// src/tools/mcp-registry.ts
+var import_zod5 = require("zod");
+
+// src/tools/registry.ts
+var import_zod = require("zod");
+
 // src/tools/types.ts
 var MAX_RESPONSE_CHARS = 5e4;
 function mcpJson(data) {
@@ -55,81 +60,972 @@ function mcpError(prefix, error) {
   return { content: [{ type: "text", text: `${prefix}: ${msg}` }] };
 }
 
+// src/tools/generated/help.ts
+var helpDirectory = `# Available Endpoints
+
+[design-system]
+  components               Create and manage reusable components and variant sets.
+  fonts                    Search available fonts in Figma.
+  instances                Create and manage component instances.
+  styles                   CRUD for local paint, text, effect, and grid styles.
+  variable_collections     CRUD for variable collections \u2014 the document-level API for design tokens.
+  variables                Search and update design variables within a collection.
+
+[connection]
+  connection               Manage the Figma plugin connection.
+
+[document]
+  document                 Navigate and manage Figma pages (canvases) in the document.
+  version_history          Save named versions to the Figma file's version history.
+
+[creation]
+  frames                   Create and manage frames, shapes, auto-layout containers, sections, and SVG nodes.
+  text                     Create and manage text nodes.
+
+[quality]
+  lint                     Run design quality and accessibility checks.
+
+[interaction]
+  prototyping              Manage prototype interactions, reactions, and navigation flows.
+
+[node-inspection]
+  selection                Read and set the current Figma selection.
+
+Topics:
+  missing_tools            Why create or edit tools are missing and how to fix it
+
+Use help(topic: "<endpoint>") for endpoint details.
+Use help(topic: "<endpoint>.<method>") for method details.`;
+var helpEndpoints = {
+  "components": {
+    "summary": '# components\nCreate and manage reusable components and variant sets.\n\nMethods:\n  clone                Duplicate nodes [create]\n  audit                Run lint on a node \u2014 returns severity-ranked findings [read]\n  reparent             Move nodes into a new parent [edit]\n  list                 List local component names (variant sets as single entries) [read]\n  get                  Get component detail \u2014 property definitions + ID for instances.create [read]\n  create               Create components [create]\n  update               Add, edit, or delete component properties [edit]\n  delete               Delete components or component sets [edit]\n\n// depth: omit \u2192 id+name stubs | 0 \u2192 props + child stubs | N \u2192 recurse N | -1 \u2192 full tree\n// fields: whitelist e.g. ["fills","opacity"] \u2014 id, name, type always included. Pass ["*"] for all.\n// layoutSizingHorizontal/Vertical: FIXED | HUG | FILL \u2014 how the node sizes within auto-layout.\n// Colors: fillVariableName/strokeVariableName bind by name \u2014 preferred over raw color values.\n// Note: node-based endpoints (frames, text, instances, components) use `results` as the list key.\n//   Standalone endpoints (styles, variables, variable_collections) use `items`. Components.list uses `items` (catalog view).\n// ---\n// visible: false hides the node. Omitted from response when true (the default).\n// locked: true prevents editing in Figma UI. Omitted when false (the default).\n// rotation: degrees (0-360). Omitted when 0.\n// blendMode: layer blend mode. Omitted when PASS_THROUGH (the default).\n// layoutPositioning: ABSOLUTE = floating inside auto-layout parent. Omitted when AUTO (the default).\n// minWidth/maxWidth/minHeight/maxHeight: responsive constraints for auto-layout children.\n// constraints: position behavior in non-auto-layout parents. Ignored inside auto-layout frames.\n// bindings: bind design variables to node properties. field uses slash path: "fills/0/color" (first fill), "strokes/0/color", "opacity", "width", "height", "cornerRadius", "paddingLeft", "itemSpacing".\n// explicitMode: pin a variable mode on this node. Use { collectionName, modeName } (preferred) or { collectionId, modeId }.\n// properties: escape hatch \u2014 set any Figma node property directly. Use only when no dedicated field exists.\ninterface Node {\n  id: string; name: string; type: string;\n  visible?: boolean;       // omitted when true\n  locked?: boolean;        // omitted when false\n  opacity?: number;        // omitted when 1\n  rotation?: number;       // omitted when 0\n  blendMode?: string;      // omitted when PASS_THROUGH\n  layoutPositioning?: "AUTO" | "ABSOLUTE";\n  layoutSizingHorizontal?: "FIXED" | "HUG" | "FILL";\n  layoutSizingVertical?: "FIXED" | "HUG" | "FILL";\n  minWidth?: number; maxWidth?: number; minHeight?: number; maxHeight?: number;\n  absoluteBoundingBox: { x: number; y: number; width: number; height: number };\n  fills?: Paint[];         // solid: {type: "SOLID", color: {r, g, b, a}}\n  strokes?: Paint[];\n  effects?: Effect[];      // DROP_SHADOW | INNER_SHADOW | LAYER_BLUR | BACKGROUND_BLUR\n  children?: NodeStub[];   // stubs: {id, name, type} \u2014 use depth to expand\n}\n// PatchItem uses flat params matching create shape \u2014 no nested sub-objects.\n// Fill/stroke/corner/layout/text params are identical to frames.create and text.create.\n// Unknown keys produce a warning, preventing silent failures.\n// Components are reusable design elements. Instances stay linked to the component and inherit changes.\n// Workflow: create component (with properties) \u2192 add children \u2192 create instances via instances.create.\n// ---\n// A component set (variant set) groups related components as variants (e.g. Button/Primary, Button/Secondary).\n// Property types: BOOLEAN (toggle visibility), TEXT (editable text), INSTANCE_SWAP (swap child instance), VARIANT (variant picker).\n// exposeText: when creating from_node, text children become editable TEXT properties on the component.\n// Auto-bind: TEXT properties auto-bind to text children with matching names (case-insensitive).\n// Example: properties:[{propertyName:"Label", type:"TEXT", defaultValue:"Click"}] binds to a child text node named "Label".\n// text.create accepts componentPropertyName to bind on creation \u2014 walks up ancestors to find the nearest component.\n//   For nested text (text inside frames inside a component), componentPropertyName resolves via ancestor walk. Alternatively, pass componentId explicitly.\n//   For existing nodes with many text children, prefer components(method:"create", type:"from_node", exposeText:true) \u2014 it auto-discovers, creates TEXT properties, and binds all text nodes in one operation.\n// Property keys: read returns clean names ("Label"), write requires the #suffix ("Label#1:0"). Call components.get(id) to discover exact keys before edit/delete.\n// ComponentItem accepts the same params as FrameItem (layout, fill, stroke, sizing, min/max).\n// A component IS a frame \u2014 create it directly with all layout properties, then add children.\n// SIZING: Components with text need a width constraint \u2014 set width + layoutSizingHorizontal:"FIXED".\n//   Without it, text won\'t wrap and the component grows unboundedly.\n//   HUG on both axes is only correct for intrinsically-sized elements (buttons, badges, icons).\n// action: "add" (default) \u2014 requires type + defaultValue. "edit" \u2014 pass defaultValue to change value, name to rename property. "delete" \u2014 just propertyName#suffix.\n// action: "rename_variant" \u2014 renames a variant option VALUE (not the property). Pass defaultValue=current option name, name=new option name.\n// For VARIANT properties: "edit" with defaultValue reorders children to set the default variant.\n\nUse components(method: "help", topic: "<method>") for method details.',
+    "methods": {
+      "clone": "# components.clone\nDuplicate nodes\n\nParams:\n    id (string, required) \u2014 Node ID\n    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.\n    x (number, optional) \u2014 X position (default: 0)\n    y (number, optional) \u2014 Y position (default: 0)\n    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.",
+      "audit": '# components.audit\nRun lint on a node \u2014 returns severity-ranked findings\n\nParams:\n    id (string, required) \u2014 Node ID to audit\n    rules (string[], optional) \u2014 Rules to check. Default: ["all"]. Categories: "component", "composition", "token", "naming", "wcag".\n    maxDepth (number, optional) \u2014 Max tree depth (default: 10)\n    maxFindings (number, optional) \u2014 Max findings (default: 50)',
+      "reparent": "# components.reparent\nMove nodes into a new parent\n\nParams:\n    items (array, required) \u2014 Array of {id, parentId, index?}\n      id (string, required)\n      parentId (string, required)\n      index (number, optional)",
+      "list": "# components.list\nList local component names (variant sets as single entries)\n\nParams:\n    query (string, optional) \u2014 Name search query (case-insensitive substring match)\n    offset (number, optional) \u2014 Skip N items for pagination (default 0)\n    limit (number, optional) \u2014 Max items per page (default 100)",
+      "get": "# components.get\nGet component detail \u2014 property definitions + ID for instances.create\n\nParams:\n    id (string, optional) \u2014 Component or component set ID\n    names (string[], optional) \u2014 Batch lookup by name (case-insensitive). Either id or names is required.",
+      "create": `# components.create
+Create components
+
+Example: components(method:"create", type:"component", items:[{name:"Card", layoutMode:"VERTICAL", padding:"16", itemSpacing:"8", fillVariableName:"bg/surface", children:[{type:"text", text:"Title", componentPropertyName:"Title"}, {type:"text", text:"Description", fontSize:14, componentPropertyName:"Description"}], properties:[{propertyName:"Show Icon", type:"BOOLEAN", defaultValue:true}]}])
+
+Discriminant: type (component | from_node | variant_set)
+
+  ## component \u2014 Create component with full frame properties (layout, fill, stroke, sizing). A component IS a frame \u2014 build directly, no need to create a frame first.
+    name (string, required) \u2014 Component name
+    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+    x (number, optional) \u2014 X position (default: 0)
+    y (number, optional) \u2014 Y position (default: 0)
+    width (number, optional) \u2014 Width (default: 100)
+    height (number, optional) \u2014 Height (default: 100)
+    rotation (number, optional) \u2014 Rotation in degrees (0-360)
+    opacity (string, optional) \u2014 Opacity (0-1) or variable name
+    visible (boolean, optional) \u2014 Show/hide (default true)
+    locked (boolean, optional) \u2014 Lock/unlock (default false)
+    blendMode (PASS_THROUGH | NORMAL | DARKEN | MULTIPLY | LINEAR_BURN | COLOR_BURN | LIGHTEN | SCREEN | LINEAR_DODGE | COLOR_DODGE | OVERLAY | SOFT_LIGHT | HARD_LIGHT | DIFFERENCE | EXCLUSION | HUE | SATURATION | COLOR | LUMINOSITY, optional)
+    layoutPositioning (AUTO | ABSOLUTE, optional) \u2014 ABSOLUTE = floating inside auto-layout parent
+    fills (array, optional) \u2014 Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent. Primary way to set fills.
+    fillColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)
+    fillStyleName (string, optional) \u2014 Paint style name for fill
+    fillVariableName (string, optional) \u2014 Color variable by name e.g. 'bg/primary'
+    strokes (array, optional) \u2014 Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear. Primary way to set strokes.
+    strokeColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)
+    strokeStyleName (string, optional) \u2014 Paint style name for stroke
+    strokeVariableName (string, optional) \u2014 Color variable by name for stroke
+    strokeWeight (string, optional) \u2014 All sides (number) or variable name (string). Per-side: strokeTopWeight, strokeBottomWeight, strokeLeftWeight, strokeRightWeight.
+    strokeTopWeight (string, optional)
+    strokeBottomWeight (string, optional)
+    strokeLeftWeight (string, optional)
+    strokeRightWeight (string, optional)
+    strokeAlign (INSIDE | OUTSIDE | CENTER, optional) \u2014 Stroke position (default: INSIDE)
+    strokesIncludedInLayout (boolean, optional) \u2014 Include stroke width in layout measurements (default: false)
+    cornerRadius (string, optional) \u2014 All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius.
+    topLeftRadius (string, optional)
+    topRightRadius (string, optional)
+    bottomRightRadius (string, optional)
+    bottomLeftRadius (string, optional)
+    effectStyleName (string, optional) \u2014 Effect style name (e.g. 'Shadow/Card') for shadows, blurs
+    layoutMode (NONE | HORIZONTAL | VERTICAL, optional) \u2014 Layout direction (default: NONE)
+    layoutWrap (NO_WRAP | WRAP, optional)
+    padding (string, optional) \u2014 All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft.
+    paddingTop (string, optional)
+    paddingRight (string, optional)
+    paddingBottom (string, optional)
+    paddingLeft (string, optional)
+    primaryAxisAlignItems (MIN | MAX | CENTER | SPACE_BETWEEN, optional)
+    counterAxisAlignItems (MIN | MAX | CENTER | BASELINE, optional)
+    layoutSizingHorizontal (FIXED | HUG | FILL, optional)
+    layoutSizingVertical (FIXED | HUG | FILL, optional)
+    itemSpacing (string, optional) \u2014 Spacing between children (number or variable name string, default: 0)
+    counterAxisSpacing (string, optional) \u2014 Gap between wrapped rows (requires layoutWrap: WRAP)
+    minWidth (number, optional) \u2014 Min width for responsive auto-layout
+    maxWidth (number, optional) \u2014 Max width for responsive auto-layout
+    minHeight (number, optional) \u2014 Min height for responsive auto-layout
+    maxHeight (number, optional) \u2014 Max height for responsive auto-layout
+    overflowDirection (NONE | HORIZONTAL | VERTICAL | BOTH, optional) \u2014 Scroll overflow in prototype (default: NONE)
+    description (string, optional) \u2014 Component description (shown in Figma's component panel)
+    children (array, optional) \u2014 Inline child nodes. Text: {type:"text", text, componentPropertyName?, fontFamily?, fontSize?, fontColor?}. Frame: {type:"frame", name?, layoutMode?, fillColor?, children?}. Text with componentPropertyName auto-creates and binds a TEXT property \u2014 no need to add it to properties separately.
+    properties (array, optional) \u2014 Component properties to define at creation: [{propertyName, type, defaultValue}]. TEXT properties for inline children with componentPropertyName are created automatically.
+      propertyName (string, required) \u2014 Property name
+      type (BOOLEAN | TEXT | INSTANCE_SWAP, required) \u2014 Property type
+      defaultValue (string_or_boolean, required) \u2014 Default value
+      preferredValues (array, optional) \u2014 Preferred values for INSTANCE_SWAP
+
+  ## from_node \u2014 Convert existing nodes to components. Text children auto-exposed as editable properties (exposeText: true).
+    nodeId (string, required) \u2014 Node ID to convert
+    exposeText (boolean, optional) \u2014 Auto-expose text as editable properties (default: true)
+
+  ## variant_set \u2014 Combine components into a variant set. The resulting set is a frame \u2014 accepts all frame properties for layout/styling.
+    name (string, optional) \u2014 Node name
+    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+    x (number, optional) \u2014 X position (default: 0)
+    y (number, optional) \u2014 Y position (default: 0)
+    width (number, optional) \u2014 Width (default: 100)
+    height (number, optional) \u2014 Height (default: 100)
+    rotation (number, optional) \u2014 Rotation in degrees (0-360)
+    opacity (string, optional) \u2014 Opacity (0-1) or variable name
+    visible (boolean, optional) \u2014 Show/hide (default true)
+    locked (boolean, optional) \u2014 Lock/unlock (default false)
+    blendMode (PASS_THROUGH | NORMAL | DARKEN | MULTIPLY | LINEAR_BURN | COLOR_BURN | LIGHTEN | SCREEN | LINEAR_DODGE | COLOR_DODGE | OVERLAY | SOFT_LIGHT | HARD_LIGHT | DIFFERENCE | EXCLUSION | HUE | SATURATION | COLOR | LUMINOSITY, optional)
+    layoutPositioning (AUTO | ABSOLUTE, optional) \u2014 ABSOLUTE = floating inside auto-layout parent
+    fills (array, optional) \u2014 Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent. Primary way to set fills.
+    fillColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)
+    fillStyleName (string, optional) \u2014 Paint style name for fill
+    fillVariableName (string, optional) \u2014 Color variable by name e.g. 'bg/primary'
+    strokes (array, optional) \u2014 Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear. Primary way to set strokes.
+    strokeColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)
+    strokeStyleName (string, optional) \u2014 Paint style name for stroke
+    strokeVariableName (string, optional) \u2014 Color variable by name for stroke
+    strokeWeight (string, optional) \u2014 All sides (number) or variable name (string). Per-side: strokeTopWeight, strokeBottomWeight, strokeLeftWeight, strokeRightWeight.
+    strokeTopWeight (string, optional)
+    strokeBottomWeight (string, optional)
+    strokeLeftWeight (string, optional)
+    strokeRightWeight (string, optional)
+    strokeAlign (INSIDE | OUTSIDE | CENTER, optional) \u2014 Stroke position (default: INSIDE)
+    strokesIncludedInLayout (boolean, optional) \u2014 Include stroke width in layout measurements (default: false)
+    cornerRadius (string, optional) \u2014 All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius.
+    topLeftRadius (string, optional)
+    topRightRadius (string, optional)
+    bottomRightRadius (string, optional)
+    bottomLeftRadius (string, optional)
+    effectStyleName (string, optional) \u2014 Effect style name (e.g. 'Shadow/Card') for shadows, blurs
+    layoutMode (NONE | HORIZONTAL | VERTICAL, optional) \u2014 Layout direction (default: NONE)
+    layoutWrap (NO_WRAP | WRAP, optional)
+    padding (string, optional) \u2014 All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft.
+    paddingTop (string, optional)
+    paddingRight (string, optional)
+    paddingBottom (string, optional)
+    paddingLeft (string, optional)
+    primaryAxisAlignItems (MIN | MAX | CENTER | SPACE_BETWEEN, optional)
+    counterAxisAlignItems (MIN | MAX | CENTER | BASELINE, optional)
+    layoutSizingHorizontal (FIXED | HUG | FILL, optional)
+    layoutSizingVertical (FIXED | HUG | FILL, optional)
+    itemSpacing (string, optional) \u2014 Spacing between children (number or variable name string, default: 0)
+    counterAxisSpacing (string, optional) \u2014 Gap between wrapped rows (requires layoutWrap: WRAP)
+    minWidth (number, optional) \u2014 Min width for responsive auto-layout
+    maxWidth (number, optional) \u2014 Max width for responsive auto-layout
+    minHeight (number, optional) \u2014 Min height for responsive auto-layout
+    maxHeight (number, optional) \u2014 Max height for responsive auto-layout
+    overflowDirection (NONE | HORIZONTAL | VERTICAL | BOTH, optional) \u2014 Scroll overflow in prototype (default: NONE)
+    componentIds (string[], required) \u2014 Component IDs to combine (min 2)
+    variantPropertyName (string, optional) \u2014 Rename the auto-generated variant property (default: 'Property 1')`,
+      "update": '# components.update\nAdd, edit, or delete component properties\n\nExample: components(method:"update", items:[{id:"1:23", propertyName:"Label", action:"edit", defaultValue:"Click Me"}])\n\nParams:\n    items (UpdatePropertyItem[], required) \u2014 Array of {id, propertyName, action?, type?, defaultValue?, name?, preferredValues?}\n      id (string, required) \u2014 Component or component set ID\n      propertyName (string, required) \u2014 Property name with #suffix for edit/delete (e.g. "Label#1:0"). Call components.get to find exact keys. For add, plain name works.\n      action (add | edit | delete | rename_variant, optional) \u2014 "add" (default): requires type + defaultValue. "edit": pass defaultValue to change default, name to rename property. "delete": just propertyName. "rename_variant": pass defaultValue=current option name, name=new option name.\n      type (BOOLEAN | TEXT | INSTANCE_SWAP | VARIANT, optional) \u2014 Property type (required for add)\n      defaultValue (string_or_boolean, optional) \u2014 Default value (add/edit). For rename_variant: the CURRENT option name to rename\n      name (string, optional) \u2014 New name \u2014 for edit: renames the property itself, for rename_variant: the new option value name\n      preferredValues (array, optional) \u2014 Preferred values for INSTANCE_SWAP\n    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.',
+      "delete": "# components.delete\nDelete components or component sets\n\nParams:\n    id (string, required) \u2014 Component or component set ID"
+    }
+  },
+  "connection": {
+    "summary": '# connection\nManage the Figma plugin connection.\n\nMethods:\n  create               Join a relay channel (required first step before any other tool) [read]\n  get                  Verify end-to-end connection to Figma [read]\n  list                 Inspect which clients (MCP, plugin) are connected to each channel [read]\n  delete               Disconnect all clients (MCP server and Figma plugin) from a channel and reset its state [edit]\n\n// Connection manages the WebSocket link between the MCP server and the Figma plugin.\n// Channels are named rooms \u2014 both the MCP server and Figma plugin must join the same channel to communicate.\n// Workflow: connection(method:"create") to join a channel \u2192 connection(method:"get") to verify Figma plugin is connected.\n// If get times out (5s), the Figma plugin is not running or not on the same channel.\n// list shows all active channels and their connected clients. delete factory-resets a channel.\n\nUse connection(method: "help", topic: "<method>") for method details.',
+    "methods": {
+      "create": "# connection.create\nJoin a relay channel (required first step before any other tool)\n\nParams:\n    channel (string, optional) \u2014 The channel name displayed in the Figma plugin panel. Defaults to 'vibma' if omitted.",
+      "get": "# connection.get\nVerify end-to-end connection to Figma\n\nNo params.",
+      "list": "# connection.list\nInspect which clients (MCP, plugin) are connected to each channel\n\nNo params.",
+      "delete": "# connection.delete\nDisconnect all clients (MCP server and Figma plugin) from a channel and reset its state\n\nParams:\n    channel (string, optional) \u2014 Channel to reset. Defaults to 'vibma'."
+    }
+  },
+  "document": {
+    "summary": '# document\nNavigate and manage Figma pages (canvases) in the document.\n\nMethods:\n  get                  Get current page with top-level children [read]\n  list                 Get document name and list all pages [read]\n  set                  Switch to a page by ID or name. At least one of pageId or pageName must be provided. [read]\n  create               Create a new page [create]\n  update               Rename a page [edit]\n\n// A Figma document contains pages \u2014 each page is an independent canvas with its own node tree.\n// The "current page" is where all node operations happen. Use document.set to switch pages before working with nodes.\n// Page IDs look like "0:1", "1:1", etc. The first page is always "0:1".\n// get returns the current page with its top-level children as stubs. list returns all pages in the document.\n\nUse document(method: "help", topic: "<method>") for method details.',
+    "methods": {
+      "get": "# document.get\nGet current page with top-level children\n\nNo params.",
+      "list": "# document.list\nGet document name and list all pages\n\nNo params.",
+      "set": "# document.set\nSwitch to a page by ID or name. At least one of pageId or pageName must be provided.\n\nParams:\n    pageId (string, optional) \u2014 Page ID\n    pageName (string, optional) \u2014 Page name (case-insensitive, substring match)",
+      "create": "# document.create\nCreate a new page\n\nParams:\n    name (string, optional) \u2014 Page name (default: 'New Page')",
+      "update": "# document.update\nRename a page\n\nParams:\n    newName (string, required) \u2014 New page name\n    pageId (string, optional) \u2014 Page ID (default: current page)"
+    }
+  },
+  "fonts": {
+    "summary": '# fonts\nSearch available fonts in Figma.\n\nMethods:\n  list                 List available font families, optionally filtered by name [read]\n\n// Returns font family names installed in the Figma environment. Use to verify a fontFamily before text.create or styles.create.\n// query filters by family name substring (case-insensitive), e.g. query:"inter" matches "Inter", "Inter Tight".\n// ---\n// Default response: just family names. Set includeStyles:true to also get available styles per family (e.g. "Regular", "Bold", "Italic").\n// Use fonts.list with query to narrow results before creating text with specific fontFamily + fontStyle.\n\nUse fonts(method: "help", topic: "<method>") for method details.',
+    "methods": {
+      "list": '# fonts.list\nList available font families, optionally filtered by name\n\nExample: fonts(method:"list", query:"inter")\n\nParams:\n    query (string, optional) \u2014 Filter by family name (case-insensitive substring)\n    includeStyles (boolean, optional) \u2014 Include available styles per family (default: false)\n    offset (number, optional) \u2014 Skip N items for pagination (default 0)\n    limit (number, optional) \u2014 Max items per page (default 100)'
+    }
+  },
+  "frames": {
+    "summary": '# frames\nCreate and manage frames, shapes, auto-layout containers, sections, and SVG nodes.\n\nMethods:\n  get                  Get serialized node data [read]\n  list                 Search for nodes (returns stubs only \u2014 use get with depth for full properties) [read]\n  update               Patch node properties [edit]\n  delete               Delete nodes [edit]\n  clone                Duplicate nodes [create]\n  audit                Run lint on a node \u2014 returns severity-ranked findings [read]\n  reparent             Move nodes into a new parent [edit]\n  create               Create frame-like containers [create]\n  export               Export a node as PNG, JPG, SVG, SVG_STRING, or PDF [read]\n\n// depth: omit \u2192 id+name stubs | 0 \u2192 props + child stubs | N \u2192 recurse N | -1 \u2192 full tree\n// fields: whitelist e.g. ["fills","opacity"] \u2014 id, name, type always included. Pass ["*"] for all.\n// layoutSizingHorizontal/Vertical: FIXED | HUG | FILL \u2014 how the node sizes within auto-layout.\n// Colors: fillVariableName/strokeVariableName bind by name \u2014 preferred over raw color values.\n// Note: node-based endpoints (frames, text, instances, components) use `results` as the list key.\n//   Standalone endpoints (styles, variables, variable_collections) use `items`. Components.list uses `items` (catalog view).\n// ---\n// visible: false hides the node. Omitted from response when true (the default).\n// locked: true prevents editing in Figma UI. Omitted when false (the default).\n// rotation: degrees (0-360). Omitted when 0.\n// blendMode: layer blend mode. Omitted when PASS_THROUGH (the default).\n// layoutPositioning: ABSOLUTE = floating inside auto-layout parent. Omitted when AUTO (the default).\n// minWidth/maxWidth/minHeight/maxHeight: responsive constraints for auto-layout children.\n// constraints: position behavior in non-auto-layout parents. Ignored inside auto-layout frames.\n// bindings: bind design variables to node properties. field uses slash path: "fills/0/color" (first fill), "strokes/0/color", "opacity", "width", "height", "cornerRadius", "paddingLeft", "itemSpacing".\n// explicitMode: pin a variable mode on this node. Use { collectionName, modeName } (preferred) or { collectionId, modeId }.\n// properties: escape hatch \u2014 set any Figma node property directly. Use only when no dedicated field exists.\ninterface Node {\n  id: string; name: string; type: string;\n  visible?: boolean;       // omitted when true\n  locked?: boolean;        // omitted when false\n  opacity?: number;        // omitted when 1\n  rotation?: number;       // omitted when 0\n  blendMode?: string;      // omitted when PASS_THROUGH\n  layoutPositioning?: "AUTO" | "ABSOLUTE";\n  layoutSizingHorizontal?: "FIXED" | "HUG" | "FILL";\n  layoutSizingVertical?: "FIXED" | "HUG" | "FILL";\n  minWidth?: number; maxWidth?: number; minHeight?: number; maxHeight?: number;\n  absoluteBoundingBox: { x: number; y: number; width: number; height: number };\n  fills?: Paint[];         // solid: {type: "SOLID", color: {r, g, b, a}}\n  strokes?: Paint[];\n  effects?: Effect[];      // DROP_SHADOW | INNER_SHADOW | LAYER_BLUR | BACKGROUND_BLUR\n  children?: NodeStub[];   // stubs: {id, name, type} \u2014 use depth to expand\n}\n// PatchItem uses flat params matching create shape \u2014 no nested sub-objects.\n// Fill/stroke/corner/layout/text params are identical to frames.create and text.create.\n// Unknown keys produce a warning, preventing silent failures.\n// Frames are the primary container in Figma. Use auto_layout for responsive containers.\n// Sizing: FIXED = explicit size, HUG = shrink to children, FILL = expand to fill parent.\n// Fill: pass fills:[{type:"SOLID", color:"#hex"}] or [] for transparent. Shorthand: fillColor:"#3B82F6" (auto-binds to matching variable/style).\n// Also: fillVariableName:"bg/primary", fillStyleName:"Surface/Primary".\n// Stroke: pass strokes:[{type:"SOLID", color:"#hex"}] or [] to clear. Shorthand: strokeColor:"#000", strokeVariableName:"border/default".\n// Token fields (cornerRadius, opacity, itemSpacing, padding, strokeWeight): pass number for value, string for variable name/ID.\n// ---\n// SIZING: Always think about both axes. Containers with text need a width constraint \u2014 set width + layoutSizingHorizontal:"FIXED".\n//   HUG/HUG is only correct for intrinsically-sized elements (buttons, badges, icons).\n//   Smart defaults inside auto-layout parent: cross-axis defaults to FILL, primary axis stays HUG.\n//   FILL only works inside an auto-layout parent. Use FIXED for top-level frames.\n// minWidth/maxWidth/minHeight/maxHeight: responsive constraints for auto-layout children.\n// clipsContent: true (default) clips children to the frame bounds. Set false for overflow-visible.\n// Sections are top-level organizers (like artboards) \u2014 they cannot be nested inside frames.\n// Shape primitives: rectangle, ellipse, line \u2014 for decorative/visual elements (not containers).\n// group: wraps existing nodes into a Group. boolean_operation: UNION/SUBTRACT/INTERSECT/EXCLUDE combines shapes.\n// SVG create: pass raw SVG markup string (e.g. "<svg>...</svg>") \u2014 Figma converts it to vector nodes.\n\nUse frames(method: "help", topic: "<method>") for method details.',
+    "methods": {
+      "get": '# frames.get\nGet serialized node data\n\nParams:\n    id (string, required) \u2014 Node ID\n    fields (string[], optional) \u2014 Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.\n    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.\n    verbose (boolean, optional) \u2014 Include all properties (bounding box, constraints, text style details). Default false \u2014 returns slim, actionable output.',
+      "list": '# frames.list\nSearch for nodes (returns stubs only \u2014 use get with depth for full properties)\n\nParams:\n    query (string, optional) \u2014 Name search query (case-insensitive substring match)\n    types (string[], optional) \u2014 Filter by node types (e.g. ["FRAME", "TEXT"])\n    parentId (string, optional) \u2014 Search only within this subtree\n    fields (string[], optional) \u2014 Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.\n    offset (number, optional) \u2014 Skip N items for pagination (default 0)\n    limit (number, optional) \u2014 Max items per page (default 100)',
+      "update": `# frames.update
+Patch node properties
+
+Params:
+    items (PatchItem[], required) \u2014 Array of {id, ...properties} to patch
+      fills (array, optional) \u2014 Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent. Primary way to set fills.
+      fillColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)
+      fillStyleName (string, optional) \u2014 Paint style name for fill
+      fillVariableName (string, optional) \u2014 Color variable by name e.g. 'bg/primary'
+      strokes (array, optional) \u2014 Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear. Primary way to set strokes.
+      strokeColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)
+      strokeStyleName (string, optional) \u2014 Paint style name for stroke
+      strokeVariableName (string, optional) \u2014 Color variable by name for stroke
+      strokeWeight (string, optional) \u2014 All sides (number) or variable name (string). Per-side: strokeTopWeight, strokeBottomWeight, strokeLeftWeight, strokeRightWeight.
+      strokeTopWeight (string, optional)
+      strokeBottomWeight (string, optional)
+      strokeLeftWeight (string, optional)
+      strokeRightWeight (string, optional)
+      strokeAlign (INSIDE | OUTSIDE | CENTER, optional) \u2014 Stroke position (default: INSIDE)
+      strokesIncludedInLayout (boolean, optional) \u2014 Include stroke width in layout measurements (default: false)
+      cornerRadius (string, optional) \u2014 All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius.
+      topLeftRadius (string, optional)
+      topRightRadius (string, optional)
+      bottomRightRadius (string, optional)
+      bottomLeftRadius (string, optional)
+      opacity (string, optional) \u2014 Opacity (0-1) or variable name
+      visible (boolean, optional) \u2014 Show/hide (default true)
+      locked (boolean, optional) \u2014 Lock/unlock (default false)
+      blendMode (PASS_THROUGH | NORMAL | DARKEN | MULTIPLY | LINEAR_BURN | COLOR_BURN | LIGHTEN | SCREEN | LINEAR_DODGE | COLOR_DODGE | OVERLAY | SOFT_LIGHT | HARD_LIGHT | DIFFERENCE | EXCLUSION | HUE | SATURATION | COLOR | LUMINOSITY, optional)
+      effectStyleName (string, optional) \u2014 Effect style name (e.g. 'Shadow/Card') for shadows, blurs
+      layoutMode (NONE | HORIZONTAL | VERTICAL, optional) \u2014 Layout direction (default: NONE)
+      layoutWrap (NO_WRAP | WRAP, optional)
+      padding (string, optional) \u2014 All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft.
+      paddingTop (string, optional)
+      paddingRight (string, optional)
+      paddingBottom (string, optional)
+      paddingLeft (string, optional)
+      primaryAxisAlignItems (MIN | MAX | CENTER | SPACE_BETWEEN, optional)
+      counterAxisAlignItems (MIN | MAX | CENTER | BASELINE, optional)
+      itemSpacing (string, optional) \u2014 Spacing between children (number or variable name string, default: 0)
+      counterAxisSpacing (string, optional) \u2014 Gap between wrapped rows (requires layoutWrap: WRAP)
+      layoutSizingHorizontal (FIXED | HUG | FILL, optional)
+      layoutSizingVertical (FIXED | HUG | FILL, optional)
+      layoutPositioning (AUTO | ABSOLUTE, optional) \u2014 ABSOLUTE = floating inside auto-layout parent
+      minWidth (number, optional) \u2014 Min width for responsive auto-layout
+      maxWidth (number, optional) \u2014 Max width for responsive auto-layout
+      minHeight (number, optional) \u2014 Min height for responsive auto-layout
+      maxHeight (number, optional) \u2014 Max height for responsive auto-layout
+      fontSize (number, optional) \u2014 Font size
+      fontFamily (string, optional) \u2014 Font family
+      fontStyle (string, optional) \u2014 Font variant e.g. "Bold", "Italic" \u2014 overrides fontWeight
+      fontWeight (number, optional) \u2014 100-900. Ignored when fontStyle is set.
+      fontColor (Color, optional) \u2014 Shorthand \u2014 sets text color (auto-binds to matching variable/style)
+      fontColorVariableName (string, optional) \u2014 Bind color variable by name e.g. 'text/primary'
+      fontColorStyleName (string, optional) \u2014 Apply paint style \u2014 overrides fontColor
+      textStyleId (string, optional) \u2014 Apply text style by ID \u2014 overrides fontSize/fontWeight
+      textStyleName (string, optional) \u2014 Text style by name (case-insensitive)
+      textAlignHorizontal (LEFT | CENTER | RIGHT | JUSTIFIED, optional)
+      textAlignVertical (TOP | CENTER | BOTTOM, optional)
+      textAutoResize (NONE | WIDTH_AND_HEIGHT | HEIGHT | TRUNCATE, optional)
+      id (string, required)
+      name (string, optional) \u2014 Rename node
+      rotation (number, optional) \u2014 Degrees (0-360)
+      x (number, optional)
+      y (number, optional)
+      width (number, optional)
+      height (number, optional)
+      clearFill (boolean, optional) \u2014 Remove all fills
+      effects (array, optional) \u2014 Effect array (DROP_SHADOW, INNER_SHADOW, LAYER_BLUR, BACKGROUND_BLUR)
+      overflowDirection (NONE | HORIZONTAL | VERTICAL | BOTH, optional) \u2014 Scroll overflow in prototype (default: NONE)
+      constraints (object, optional)
+      bindings (array, optional) \u2014 Bind variables to properties. field path examples: 'fills/0/color', 'strokes/0/color', 'opacity', 'width', 'cornerRadius', 'itemSpacing'.
+        field (string, required)
+        variableName (string, optional)
+        variableId (string, optional)
+      explicitMode (object, optional) \u2014 Pin variable mode \u2014 use { collectionName, modeName } (preferred) or { collectionId, modeId }
+      exportSettings (array, optional) \u2014 Export settings
+      properties (object, optional) \u2014 Direct Figma API props (escape hatch)`,
+      "delete": "# frames.delete\nDelete nodes\n\nParams:\n    id (string, optional) \u2014 Single node ID\n    items (array, optional) \u2014 Batch: [{id}, ...]\n      id (string, optional)",
+      "clone": "# frames.clone\nDuplicate nodes\n\nParams:\n    id (string, required) \u2014 Node ID\n    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.\n    x (number, optional) \u2014 X position (default: 0)\n    y (number, optional) \u2014 Y position (default: 0)\n    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.",
+      "audit": '# frames.audit\nRun lint on a node \u2014 returns severity-ranked findings\n\nParams:\n    id (string, required) \u2014 Node ID to audit\n    rules (string[], optional) \u2014 Rules to check. Default: ["all"]. Categories: "component", "composition", "token", "naming", "wcag".\n    maxDepth (number, optional) \u2014 Max tree depth (default: 10)\n    maxFindings (number, optional) \u2014 Max findings (default: 50)',
+      "reparent": "# frames.reparent\nMove nodes into a new parent\n\nParams:\n    items (array, required) \u2014 Array of {id, parentId, index?}\n      id (string, required)\n      parentId (string, required)\n      index (number, optional)",
+      "create": `# frames.create
+Create frame-like containers
+
+Example: frames(method:"create", type:"auto_layout", layoutMode:"VERTICAL", itemSpacing:16, padding:24)
+
+Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line | group | boolean_operation | svg)
+
+  ## frame \u2014 Static frame with fixed dimensions
+    name (string, optional) \u2014 Node name
+    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+    x (number, optional) \u2014 X position (default: 0)
+    y (number, optional) \u2014 Y position (default: 0)
+    width (number, optional) \u2014 Width (default: 100)
+    height (number, optional) \u2014 Height (default: 100)
+    rotation (number, optional) \u2014 Rotation in degrees (0-360)
+    opacity (string, optional) \u2014 Opacity (0-1) or variable name
+    visible (boolean, optional) \u2014 Show/hide (default true)
+    locked (boolean, optional) \u2014 Lock/unlock (default false)
+    blendMode (PASS_THROUGH | NORMAL | DARKEN | MULTIPLY | LINEAR_BURN | COLOR_BURN | LIGHTEN | SCREEN | LINEAR_DODGE | COLOR_DODGE | OVERLAY | SOFT_LIGHT | HARD_LIGHT | DIFFERENCE | EXCLUSION | HUE | SATURATION | COLOR | LUMINOSITY, optional)
+    layoutPositioning (AUTO | ABSOLUTE, optional) \u2014 ABSOLUTE = floating inside auto-layout parent
+    fills (array, optional) \u2014 Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent. Primary way to set fills.
+    fillColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)
+    fillStyleName (string, optional) \u2014 Paint style name for fill
+    fillVariableName (string, optional) \u2014 Color variable by name e.g. 'bg/primary'
+    strokes (array, optional) \u2014 Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear. Primary way to set strokes.
+    strokeColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)
+    strokeStyleName (string, optional) \u2014 Paint style name for stroke
+    strokeVariableName (string, optional) \u2014 Color variable by name for stroke
+    strokeWeight (string, optional) \u2014 All sides (number) or variable name (string). Per-side: strokeTopWeight, strokeBottomWeight, strokeLeftWeight, strokeRightWeight.
+    strokeTopWeight (string, optional)
+    strokeBottomWeight (string, optional)
+    strokeLeftWeight (string, optional)
+    strokeRightWeight (string, optional)
+    strokeAlign (INSIDE | OUTSIDE | CENTER, optional) \u2014 Stroke position (default: INSIDE)
+    strokesIncludedInLayout (boolean, optional) \u2014 Include stroke width in layout measurements (default: false)
+    cornerRadius (string, optional) \u2014 All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius.
+    topLeftRadius (string, optional)
+    topRightRadius (string, optional)
+    bottomRightRadius (string, optional)
+    bottomLeftRadius (string, optional)
+    effectStyleName (string, optional) \u2014 Effect style name (e.g. 'Shadow/Card') for shadows, blurs
+    layoutMode (NONE | HORIZONTAL | VERTICAL, optional) \u2014 Layout direction (default: NONE)
+    layoutWrap (NO_WRAP | WRAP, optional)
+    padding (string, optional) \u2014 All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft.
+    paddingTop (string, optional)
+    paddingRight (string, optional)
+    paddingBottom (string, optional)
+    paddingLeft (string, optional)
+    primaryAxisAlignItems (MIN | MAX | CENTER | SPACE_BETWEEN, optional)
+    counterAxisAlignItems (MIN | MAX | CENTER | BASELINE, optional)
+    layoutSizingHorizontal (FIXED | HUG | FILL, optional)
+    layoutSizingVertical (FIXED | HUG | FILL, optional)
+    itemSpacing (string, optional) \u2014 Spacing between children (number or variable name string, default: 0)
+    counterAxisSpacing (string, optional) \u2014 Gap between wrapped rows (requires layoutWrap: WRAP)
+    minWidth (number, optional) \u2014 Min width for responsive auto-layout
+    maxWidth (number, optional) \u2014 Max width for responsive auto-layout
+    minHeight (number, optional) \u2014 Min height for responsive auto-layout
+    maxHeight (number, optional) \u2014 Max height for responsive auto-layout
+    overflowDirection (NONE | HORIZONTAL | VERTICAL | BOTH, optional) \u2014 Scroll overflow in prototype (default: NONE)
+    clipsContent (boolean, optional)
+
+  ## auto_layout \u2014 Auto-layout frame that arranges children automatically
+    name (string, optional) \u2014 Node name
+    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+    x (number, optional) \u2014 X position (default: 0)
+    y (number, optional) \u2014 Y position (default: 0)
+    width (number, optional) \u2014 Width (default: 100)
+    height (number, optional) \u2014 Height (default: 100)
+    rotation (number, optional) \u2014 Rotation in degrees (0-360)
+    opacity (string, optional) \u2014 Opacity (0-1) or variable name
+    visible (boolean, optional) \u2014 Show/hide (default true)
+    locked (boolean, optional) \u2014 Lock/unlock (default false)
+    blendMode (PASS_THROUGH | NORMAL | DARKEN | MULTIPLY | LINEAR_BURN | COLOR_BURN | LIGHTEN | SCREEN | LINEAR_DODGE | COLOR_DODGE | OVERLAY | SOFT_LIGHT | HARD_LIGHT | DIFFERENCE | EXCLUSION | HUE | SATURATION | COLOR | LUMINOSITY, optional)
+    layoutPositioning (AUTO | ABSOLUTE, optional) \u2014 ABSOLUTE = floating inside auto-layout parent
+    fills (array, optional) \u2014 Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent. Primary way to set fills.
+    fillColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)
+    fillStyleName (string, optional) \u2014 Paint style name for fill
+    fillVariableName (string, optional) \u2014 Color variable by name e.g. 'bg/primary'
+    strokes (array, optional) \u2014 Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear. Primary way to set strokes.
+    strokeColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)
+    strokeStyleName (string, optional) \u2014 Paint style name for stroke
+    strokeVariableName (string, optional) \u2014 Color variable by name for stroke
+    strokeWeight (string, optional) \u2014 All sides (number) or variable name (string). Per-side: strokeTopWeight, strokeBottomWeight, strokeLeftWeight, strokeRightWeight.
+    strokeTopWeight (string, optional)
+    strokeBottomWeight (string, optional)
+    strokeLeftWeight (string, optional)
+    strokeRightWeight (string, optional)
+    strokeAlign (INSIDE | OUTSIDE | CENTER, optional) \u2014 Stroke position (default: INSIDE)
+    strokesIncludedInLayout (boolean, optional) \u2014 Include stroke width in layout measurements (default: false)
+    cornerRadius (string, optional) \u2014 All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius.
+    topLeftRadius (string, optional)
+    topRightRadius (string, optional)
+    bottomRightRadius (string, optional)
+    bottomLeftRadius (string, optional)
+    effectStyleName (string, optional) \u2014 Effect style name (e.g. 'Shadow/Card') for shadows, blurs
+    layoutMode (HORIZONTAL | VERTICAL, required) \u2014 Primary axis direction
+    layoutWrap (NO_WRAP | WRAP, optional)
+    padding (string, optional) \u2014 All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft.
+    paddingTop (string, optional)
+    paddingRight (string, optional)
+    paddingBottom (string, optional)
+    paddingLeft (string, optional)
+    primaryAxisAlignItems (MIN | MAX | CENTER | SPACE_BETWEEN, optional)
+    counterAxisAlignItems (MIN | MAX | CENTER | BASELINE, optional)
+    layoutSizingHorizontal (FIXED | HUG | FILL, optional)
+    layoutSizingVertical (FIXED | HUG | FILL, optional)
+    itemSpacing (string, optional) \u2014 Spacing between children (number or variable name string, default: 0)
+    counterAxisSpacing (string, optional) \u2014 Gap between wrapped rows (requires layoutWrap: WRAP)
+    minWidth (number, optional) \u2014 Min width for responsive auto-layout
+    maxWidth (number, optional) \u2014 Max width for responsive auto-layout
+    minHeight (number, optional) \u2014 Min height for responsive auto-layout
+    maxHeight (number, optional) \u2014 Max height for responsive auto-layout
+    overflowDirection (NONE | HORIZONTAL | VERTICAL | BOTH, optional) \u2014 Scroll overflow in prototype (default: NONE)
+    clipsContent (boolean, optional)
+    nodeIds (string[], optional) \u2014 Existing node IDs to wrap into auto-layout
+
+  ## section \u2014 Figma section (top-level organizer)
+    name (string, required) \u2014 Section name
+    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+    x (number, optional) \u2014 X position (default: 0)
+    y (number, optional) \u2014 Y position (default: 0)
+    width (number, optional) \u2014 Width (default: 500)
+    height (number, optional) \u2014 Height (default: 500)
+    fills (array, optional) \u2014 Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent
+    fillColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)
+    fillStyleName (string, optional) \u2014 Paint style name for fill
+    fillVariableName (string, optional) \u2014 Color variable by name e.g. 'bg/primary'
+
+  ## rectangle \u2014 Rectangle shape node
+    name (string, optional) \u2014 Layer name (default: 'Rectangle')
+    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+    x (number, optional) \u2014 X position (default: 0)
+    y (number, optional) \u2014 Y position (default: 0)
+    width (number, optional) \u2014 Width in px (default: 100)
+    height (number, optional) \u2014 Height in px (default: 100)
+    fills (array, optional) \u2014 Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent
+    fillColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)
+    fillStyleName (string, optional) \u2014 Paint style name for fill
+    fillVariableName (string, optional) \u2014 Color variable by name e.g. 'bg/primary'
+    strokes (array, optional) \u2014 Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear
+    strokeColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)
+    strokeVariableName (string, optional) \u2014 Color variable by name for stroke
+    strokeWeight (string, optional)
+    cornerRadius (string, optional) \u2014 All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius.
+    topLeftRadius (string, optional)
+    topRightRadius (string, optional)
+    bottomRightRadius (string, optional)
+    bottomLeftRadius (string, optional)
+    opacity (string, optional)
+    layoutSizingHorizontal (FIXED | FILL, optional) \u2014 Horizontal sizing in auto-layout parent
+    layoutSizingVertical (FIXED | FILL, optional) \u2014 Vertical sizing in auto-layout parent
+
+  ## ellipse \u2014 Ellipse/circle shape node
+    name (string, optional) \u2014 Layer name (default: 'Ellipse')
+    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+    x (number, optional) \u2014 X position (default: 0)
+    y (number, optional) \u2014 Y position (default: 0)
+    width (number, optional) \u2014 Width in px (default: 100)
+    height (number, optional) \u2014 Height in px (default: 100, same as width for circle)
+    fills (array, optional) \u2014 Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent
+    fillColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)
+    fillStyleName (string, optional) \u2014 Paint style name for fill
+    fillVariableName (string, optional) \u2014 Color variable by name e.g. 'bg/primary'
+    strokes (array, optional) \u2014 Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear
+    strokeColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)
+    strokeVariableName (string, optional) \u2014 Color variable by name for stroke
+    strokeWeight (string, optional)
+    opacity (string, optional)
+    layoutSizingHorizontal (FIXED | FILL, optional) \u2014 Horizontal sizing in auto-layout parent
+    layoutSizingVertical (FIXED | FILL, optional) \u2014 Vertical sizing in auto-layout parent
+
+  ## line \u2014 Line shape node
+    name (string, optional) \u2014 Layer name (default: 'Line')
+    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+    x (number, optional) \u2014 X position (default: 0)
+    y (number, optional) \u2014 Y position (default: 0)
+    length (number, optional) \u2014 Line length in px (default: 100)
+    rotation (number, optional) \u2014 Rotation in degrees (default: 0 = horizontal)
+    strokes (array, optional) \u2014 Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear
+    strokeColor (Color, optional) \u2014 Line color (default: black, auto-binds to matching variable/style)
+    strokeVariableName (string, optional) \u2014 Color variable by name for stroke
+    strokeWeight (string, optional) \u2014 Line thickness (default: 1)
+    opacity (string, optional)
+    layoutSizingHorizontal (FIXED | FILL, optional) \u2014 Horizontal sizing in auto-layout parent (defaults to FILL in vertical auto-layout)
+
+  ## group \u2014 Group existing nodes together
+    nodeIds (string[], required) \u2014 Node IDs to group (min 1)
+    name (string, optional) \u2014 Group name
+    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+
+  ## boolean_operation \u2014 Combine shapes with boolean operations (union, subtract, intersect, exclude)
+    operation (UNION | SUBTRACT | INTERSECT | EXCLUDE, required) \u2014 Boolean operation type
+    nodeIds (string[], required) \u2014 Node IDs to combine (min 2, first node is the base for SUBTRACT)
+    name (string, optional) \u2014 Result node name
+    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+
+  ## svg \u2014 Create node from SVG markup
+    svg (string, required) \u2014 SVG markup string
+    name (string, optional) \u2014 Layer name (default: 'SVG')
+    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+    x (number, optional) \u2014 X position (default: 0)
+    y (number, optional) \u2014 Y position (default: 0)
+    fillStyleName (string, optional) \u2014 Paint style to apply to vector fills
+    fillVariableName (string, optional) \u2014 Color variable by name for vector fills
+    strokeStyleName (string, optional) \u2014 Paint style to apply to vector strokes
+    strokeVariableName (string, optional) \u2014 Color variable by name for vector strokes`,
+      "export": "# frames.export\nExport a node as PNG, JPG, SVG, SVG_STRING, or PDF\n\nParams:\n    id (string, required) \u2014 Node ID to export\n    format (PNG | JPG | SVG | SVG_STRING | PDF, optional) \u2014 Export format (default: PNG). SVG_STRING returns raw SVG text.\n    scale (number, optional) \u2014 Export scale (default: 1, only for PNG/JPG)"
+    }
+  },
+  "instances": {
+    "summary": '# instances\nCreate and manage component instances.\n\nMethods:\n  list                 Search for nodes (returns stubs only \u2014 use get with depth for full properties) [read]\n  delete               Delete nodes [edit]\n  clone                Duplicate nodes [create]\n  audit                Run lint on a node \u2014 returns severity-ranked findings [read]\n  reparent             Move nodes into a new parent [edit]\n  get                  Get instance detail with component properties and overrides [read]\n  create               Create component instances [create]\n  update               Set instance properties [edit]\n  swap                 Swap instance component (preserves overrides) [edit]\n  detach               Detach instances from their component (converts to frame) [edit]\n  reset_overrides      Reset all overrides on instances to match their main component [edit]\n\n// depth: omit \u2192 id+name stubs | 0 \u2192 props + child stubs | N \u2192 recurse N | -1 \u2192 full tree\n// fields: whitelist e.g. ["fills","opacity"] \u2014 id, name, type always included. Pass ["*"] for all.\n// layoutSizingHorizontal/Vertical: FIXED | HUG | FILL \u2014 how the node sizes within auto-layout.\n// Colors: fillVariableName/strokeVariableName bind by name \u2014 preferred over raw color values.\n// Note: node-based endpoints (frames, text, instances, components) use `results` as the list key.\n//   Standalone endpoints (styles, variables, variable_collections) use `items`. Components.list uses `items` (catalog view).\n// ---\n// visible: false hides the node. Omitted from response when true (the default).\n// locked: true prevents editing in Figma UI. Omitted when false (the default).\n// rotation: degrees (0-360). Omitted when 0.\n// blendMode: layer blend mode. Omitted when PASS_THROUGH (the default).\n// layoutPositioning: ABSOLUTE = floating inside auto-layout parent. Omitted when AUTO (the default).\n// minWidth/maxWidth/minHeight/maxHeight: responsive constraints for auto-layout children.\n// constraints: position behavior in non-auto-layout parents. Ignored inside auto-layout frames.\n// bindings: bind design variables to node properties. field uses slash path: "fills/0/color" (first fill), "strokes/0/color", "opacity", "width", "height", "cornerRadius", "paddingLeft", "itemSpacing".\n// explicitMode: pin a variable mode on this node. Use { collectionName, modeName } (preferred) or { collectionId, modeId }.\n// properties: escape hatch \u2014 set any Figma node property directly. Use only when no dedicated field exists.\ninterface Node {\n  id: string; name: string; type: string;\n  visible?: boolean;       // omitted when true\n  locked?: boolean;        // omitted when false\n  opacity?: number;        // omitted when 1\n  rotation?: number;       // omitted when 0\n  blendMode?: string;      // omitted when PASS_THROUGH\n  layoutPositioning?: "AUTO" | "ABSOLUTE";\n  layoutSizingHorizontal?: "FIXED" | "HUG" | "FILL";\n  layoutSizingVertical?: "FIXED" | "HUG" | "FILL";\n  minWidth?: number; maxWidth?: number; minHeight?: number; maxHeight?: number;\n  absoluteBoundingBox: { x: number; y: number; width: number; height: number };\n  fills?: Paint[];         // solid: {type: "SOLID", color: {r, g, b, a}}\n  strokes?: Paint[];\n  effects?: Effect[];      // DROP_SHADOW | INNER_SHADOW | LAYER_BLUR | BACKGROUND_BLUR\n  children?: NodeStub[];   // stubs: {id, name, type} \u2014 use depth to expand\n}\n// PatchItem uses flat params matching create shape \u2014 no nested sub-objects.\n// Fill/stroke/corner/layout/text params are identical to frames.create and text.create.\n// Unknown keys produce a warning, preventing silent failures.\n// Instances are linked copies of components. Changes to the component propagate to all instances.\n// Overrides: instance-level changes (text, fills, visibility) that differ from the component. Shown in overrides array.\n// variantProperties: when creating from a component set, pick which variant e.g. {"Style":"Secondary","Size":"Large"}.\n// ---\n// Property keys: read returns clean names ("Label"), write requires the #suffix ("Label#1:0"). Call instances.get(id) to discover exact keys before update.\n// swap: change which component an instance points to while preserving compatible overrides.\n// detach: permanently converts an instance to a regular frame, breaking the component link.\n// reset_overrides: reverts all instance overrides to match the main component.\n// Workflow: components.list \u2192 instances.create with componentId + properties (one call). No separate update needed for text/boolean overrides.\n// Instances support frame-level overrides: layoutSizingHorizontal/Vertical (FIXED, FILL, HUG), opacity, width/height, min/max.\n// Use layoutSizingHorizontal: "FILL" to make instances stretch in auto-layout parents.\n\nUse instances(method: "help", topic: "<method>") for method details.',
+    "methods": {
+      "list": '# instances.list\nSearch for nodes (returns stubs only \u2014 use get with depth for full properties)\n\nParams:\n    query (string, optional) \u2014 Name search query (case-insensitive substring match)\n    types (string[], optional) \u2014 Filter by node types (e.g. ["FRAME", "TEXT"])\n    parentId (string, optional) \u2014 Search only within this subtree\n    fields (string[], optional) \u2014 Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.\n    offset (number, optional) \u2014 Skip N items for pagination (default 0)\n    limit (number, optional) \u2014 Max items per page (default 100)',
+      "delete": "# instances.delete\nDelete nodes\n\nParams:\n    id (string, optional) \u2014 Single node ID\n    items (array, optional) \u2014 Batch: [{id}, ...]\n      id (string, optional)",
+      "clone": "# instances.clone\nDuplicate nodes\n\nParams:\n    id (string, required) \u2014 Node ID\n    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.\n    x (number, optional) \u2014 X position (default: 0)\n    y (number, optional) \u2014 Y position (default: 0)\n    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.",
+      "audit": '# instances.audit\nRun lint on a node \u2014 returns severity-ranked findings\n\nParams:\n    id (string, required) \u2014 Node ID to audit\n    rules (string[], optional) \u2014 Rules to check. Default: ["all"]. Categories: "component", "composition", "token", "naming", "wcag".\n    maxDepth (number, optional) \u2014 Max tree depth (default: 10)\n    maxFindings (number, optional) \u2014 Max findings (default: 50)',
+      "reparent": "# instances.reparent\nMove nodes into a new parent\n\nParams:\n    items (array, required) \u2014 Array of {id, parentId, index?}\n      id (string, required)\n      parentId (string, required)\n      index (number, optional)",
+      "get": '# instances.get\nGet instance detail with component properties and overrides\n\nParams:\n    id (string, required) \u2014 Instance node ID\n    fields (string[], optional) \u2014 Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.\n    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.\n    verbose (boolean, optional) \u2014 Include all properties (bounding box, constraints, text style details). Default false \u2014 returns slim, actionable output.',
+      "create": `# instances.create
+Create component instances
+
+Example: instances(method:"create", items:[{componentId:"1:23", variantProperties:{"Size":"Large"}, properties:{"Label":"Click me"}, parentId:"2:45", layoutSizingHorizontal:"FILL"}])
+
+Params:
+    items (InstanceCreateItem[], required) \u2014 Array of {componentId, variantProperties?, x?, y?, parentId?, layoutSizingHorizontal?, ...}
+      opacity (string, optional) \u2014 Opacity (0-1) or variable name
+      visible (boolean, optional) \u2014 Show/hide (default true)
+      locked (boolean, optional) \u2014 Lock/unlock (default false)
+      blendMode (PASS_THROUGH | NORMAL | DARKEN | MULTIPLY | LINEAR_BURN | COLOR_BURN | LIGHTEN | SCREEN | LINEAR_DODGE | COLOR_DODGE | OVERLAY | SOFT_LIGHT | HARD_LIGHT | DIFFERENCE | EXCLUSION | HUE | SATURATION | COLOR | LUMINOSITY, optional)
+      effectStyleName (string, optional) \u2014 Effect style name (e.g. 'Shadow/Card') for shadows, blurs
+      layoutSizingHorizontal (FIXED | HUG | FILL, optional)
+      layoutSizingVertical (FIXED | HUG | FILL, optional)
+      layoutPositioning (AUTO | ABSOLUTE, optional) \u2014 ABSOLUTE = floating inside auto-layout parent
+      minWidth (number, optional) \u2014 Min width for responsive auto-layout
+      maxWidth (number, optional) \u2014 Max width for responsive auto-layout
+      minHeight (number, optional) \u2014 Min height for responsive auto-layout
+      maxHeight (number, optional) \u2014 Max height for responsive auto-layout
+      componentId (string, required) \u2014 Component or component set ID
+      variantProperties (object, optional) \u2014 Pick variant e.g. {"Style":"Secondary"}
+      properties (object, optional) \u2014 Set component properties inline e.g. {"Label":"Click me", "ShowIcon":true}. Same as instances.update properties.
+      name (string, optional) \u2014 Instance layer name
+      x (number, optional)
+      y (number, optional)
+      width (number, optional) \u2014 Override width (resize)
+      height (number, optional) \u2014 Override height (resize)
+      parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.`,
+      "update": `# instances.update
+Set instance properties
+
+Example: instances(method:"update", items:[{id:"1:23", properties:{"Label#4:0":"Submit"}, fillColor:"#3B82F6", layoutSizingHorizontal:"FILL"}])
+
+Params:
+    items (InstanceUpdateItem[], required) \u2014 Array of {id, properties: {"Label#1:0":"text"}, fillColor?: ...}
+      fills (array, optional) \u2014 Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent. Primary way to set fills.
+      fillColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)
+      fillStyleName (string, optional) \u2014 Paint style name for fill
+      fillVariableName (string, optional) \u2014 Color variable by name e.g. 'bg/primary'
+      strokes (array, optional) \u2014 Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear. Primary way to set strokes.
+      strokeColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)
+      strokeStyleName (string, optional) \u2014 Paint style name for stroke
+      strokeVariableName (string, optional) \u2014 Color variable by name for stroke
+      strokeWeight (string, optional) \u2014 All sides (number) or variable name (string). Per-side: strokeTopWeight, strokeBottomWeight, strokeLeftWeight, strokeRightWeight.
+      strokeTopWeight (string, optional)
+      strokeBottomWeight (string, optional)
+      strokeLeftWeight (string, optional)
+      strokeRightWeight (string, optional)
+      strokeAlign (INSIDE | OUTSIDE | CENTER, optional) \u2014 Stroke position (default: INSIDE)
+      strokesIncludedInLayout (boolean, optional) \u2014 Include stroke width in layout measurements (default: false)
+      cornerRadius (string, optional) \u2014 All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius.
+      topLeftRadius (string, optional)
+      topRightRadius (string, optional)
+      bottomRightRadius (string, optional)
+      bottomLeftRadius (string, optional)
+      opacity (string, optional) \u2014 Opacity (0-1) or variable name
+      visible (boolean, optional) \u2014 Show/hide (default true)
+      locked (boolean, optional) \u2014 Lock/unlock (default false)
+      blendMode (PASS_THROUGH | NORMAL | DARKEN | MULTIPLY | LINEAR_BURN | COLOR_BURN | LIGHTEN | SCREEN | LINEAR_DODGE | COLOR_DODGE | OVERLAY | SOFT_LIGHT | HARD_LIGHT | DIFFERENCE | EXCLUSION | HUE | SATURATION | COLOR | LUMINOSITY, optional)
+      effectStyleName (string, optional) \u2014 Effect style name (e.g. 'Shadow/Card') for shadows, blurs
+      layoutMode (NONE | HORIZONTAL | VERTICAL, optional) \u2014 Layout direction (default: NONE)
+      layoutWrap (NO_WRAP | WRAP, optional)
+      padding (string, optional) \u2014 All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft.
+      paddingTop (string, optional)
+      paddingRight (string, optional)
+      paddingBottom (string, optional)
+      paddingLeft (string, optional)
+      primaryAxisAlignItems (MIN | MAX | CENTER | SPACE_BETWEEN, optional)
+      counterAxisAlignItems (MIN | MAX | CENTER | BASELINE, optional)
+      itemSpacing (string, optional) \u2014 Spacing between children (number or variable name string, default: 0)
+      counterAxisSpacing (string, optional) \u2014 Gap between wrapped rows (requires layoutWrap: WRAP)
+      layoutSizingHorizontal (FIXED | HUG | FILL, optional)
+      layoutSizingVertical (FIXED | HUG | FILL, optional)
+      layoutPositioning (AUTO | ABSOLUTE, optional) \u2014 ABSOLUTE = floating inside auto-layout parent
+      minWidth (number, optional) \u2014 Min width for responsive auto-layout
+      maxWidth (number, optional) \u2014 Max width for responsive auto-layout
+      minHeight (number, optional) \u2014 Min height for responsive auto-layout
+      maxHeight (number, optional) \u2014 Max height for responsive auto-layout
+      fontSize (number, optional) \u2014 Font size
+      fontFamily (string, optional) \u2014 Font family
+      fontStyle (string, optional) \u2014 Font variant e.g. "Bold", "Italic" \u2014 overrides fontWeight
+      fontWeight (number, optional) \u2014 100-900. Ignored when fontStyle is set.
+      fontColor (Color, optional) \u2014 Shorthand \u2014 sets text color (auto-binds to matching variable/style)
+      fontColorVariableName (string, optional) \u2014 Bind color variable by name e.g. 'text/primary'
+      fontColorStyleName (string, optional) \u2014 Apply paint style \u2014 overrides fontColor
+      textStyleId (string, optional) \u2014 Apply text style by ID \u2014 overrides fontSize/fontWeight
+      textStyleName (string, optional) \u2014 Text style by name (case-insensitive)
+      textAlignHorizontal (LEFT | CENTER | RIGHT | JUSTIFIED, optional)
+      textAlignVertical (TOP | CENTER | BOTTOM, optional)
+      textAutoResize (NONE | WIDTH_AND_HEIGHT | HEIGHT | TRUNCATE, optional)
+      id (string, required) \u2014 Instance node ID
+      properties (object, optional) \u2014 Component property key\u2192value map
+      componentProperties (object, optional) \u2014 Alias for properties (matches instances.get response shape)
+      name (string, optional) \u2014 Rename node
+      rotation (number, optional) \u2014 Degrees (0-360)
+      x (number, optional)
+      y (number, optional)
+      width (number, optional)
+      height (number, optional)
+      clearFill (boolean, optional) \u2014 Remove all fills
+      effects (array, optional) \u2014 Effect array (DROP_SHADOW, INNER_SHADOW, LAYER_BLUR, BACKGROUND_BLUR)
+      constraints (object, optional)
+      bindings (array, optional) \u2014 Bind variables to properties. field path examples: 'fills/0/color', 'strokes/0/color', 'opacity', 'width', 'cornerRadius', 'itemSpacing'.
+        field (string, required)
+        variableName (string, optional)
+        variableId (string, optional)
+      explicitMode (object, optional) \u2014 Pin variable mode \u2014 use { collectionName, modeName } (preferred) or { collectionId, modeId }
+      exportSettings (array, optional) \u2014 Export settings`,
+      "swap": "# instances.swap\nSwap instance component (preserves overrides)\n\nParams:\n    items (array, required) \u2014 Array of {id, componentId}\n      id (string, required) \u2014 Instance node ID\n      componentId (string, required) \u2014 New component or component set ID",
+      "detach": "# instances.detach\nDetach instances from their component (converts to frame)\n\nParams:\n    items (array, required) \u2014 Array of {id}\n      id (string, required) \u2014 Instance node ID",
+      "reset_overrides": "# instances.reset_overrides\nReset all overrides on instances to match their main component\n\nParams:\n    items (array, required) \u2014 Array of {id}\n      id (string, required) \u2014 Instance node ID"
+    }
+  },
+  "lint": {
+    "summary": `# lint
+Run design quality and accessibility checks.
+
+Methods:
+  check                Run design linter on a node tree [read]
+  fix                  Auto-fix frames to auto-layout [edit]
+
+// Lint runs automated design quality and accessibility checks on a node tree.
+// ---
+// Rules: "all" (default), or filter by category or specific rule names.
+// Category meta-rules (expand to all rules in that category):
+//   "component" \u2014 component property binding checks
+//   "composition" \u2014 layout and positioning checks
+//   "token" \u2014 design token / style usage checks
+//   "naming" \u2014 layer naming checks
+//   "wcag" / "accessibility" \u2014 all WCAG accessibility checks
+// ---
+// Severity levels (output is sorted by severity, highest first):
+//   "error" \u2014 definite bug, must fix
+//   "unsafe" \u2014 likely causes layout/accessibility problems
+//   "heuristic" \u2014 probably worth fixing, context-dependent
+//   "style" \u2014 opinionated, nice-to-have (leaf nodes, decorative elements often downgraded here)
+// Context-aware: leaf nodes (text, shapes, small frames) are treated differently from containers.
+//   Small labels with HUG sizing, leaf nodes on cross-axis \u2014 downgraded to "style" instead of "heuristic".
+//   Per-finding severity overrides appear on individual nodes when context changes the default.
+// ---
+// Component rules [component]:
+//   "no-text-property" \u2014 component text not exposed as editable property [heuristic]
+//   "component-bindings" \u2014 unbound text, orphaned properties, unexposed nested text [heuristic; orphaned\u2192unsafe, nested\u2192style]
+// Composition rules [composition]:
+//   "no-autolayout" \u2014 frames with manually positioned children [heuristic; leaf-only containers\u2192style]
+//   "overlapping-children" \u2014 children stacked at same position [heuristic]
+//   "shape-instead-of-frame" \u2014 shapes used as containers [style]
+//   "fixed-in-autolayout" \u2014 FIXED-size children in auto-layout parents [heuristic]
+//   "unbounded-hug" \u2014 HUG on both axes [unsafe; short leaf text\u2192style]
+//   "hug-cross-axis" \u2014 HUG on cross-axis of constrained parent [heuristic; leaf nodes\u2192style]
+//   "empty-container" \u2014 empty frames [style]
+// Token rules [token]:
+//   "hardcoded-color" \u2014 colors not using styles or variables [heuristic]
+//   "hardcoded-token" \u2014 numeric values not bound to FLOAT variable [heuristic]
+//   "no-text-style" \u2014 text without a text style [heuristic]
+// Naming rules [naming]:
+//   "default-name" \u2014 default names like "Frame 1" [style]
+//   "stale-text-name" \u2014 text node name doesn't match content [style]
+// Accessibility rules [wcag]:
+//   "wcag-contrast" \u2014 AA contrast ratio [unsafe]
+//   "wcag-contrast-enhanced" \u2014 AAA contrast ratio [style]
+//   "wcag-non-text-contrast" \u2014 non-text 3:1 contrast [heuristic]
+//   "wcag-target-size" \u2014 targets below 24x24px [unsafe]
+//   "wcag-text-size" \u2014 text below 12px [unsafe]
+//   "wcag-line-height" \u2014 line height below 1.5x [style]
+// ---
+// maxDepth limits how deep the tree traversal goes (default: 10). maxFindings caps total findings (default: 50).
+// fix: auto-converts frames to auto-layout. Use after lint.check identifies "no-autolayout" issues.
+
+Use lint(method: "help", topic: "<method>") for method details.`,
+    "methods": {
+      "check": '# lint.check\nRun design linter on a node tree\n\nExample: lint(method:"check", nodeId:"0:1", rules:["wcag","hardcoded-color"])\n\nParams:\n    nodeId (string, optional) \u2014 Node ID to lint. If omitted: 1 selected node \u2192 lints that node, 2+ selected \u2192 lints entire page (not the selection), 0 selected \u2192 error. Always pass nodeId explicitly for reliable targeting.\n    rules (string[], optional) \u2014 Rules to run. Default: ["all"]. Categories: "component", "composition", "token", "naming", "wcag"/"accessibility". Or specific rule names.\n    maxDepth (number, optional) \u2014 Max tree depth (default: 10)\n    maxFindings (number, optional) \u2014 Max findings (default: 50)',
+      "fix": "# lint.fix\nAuto-fix frames to auto-layout\n\nParams:\n    items (array, required) \u2014 Array of {nodeId, layoutMode?, itemSpacing?}\n      nodeId (string, required) \u2014 Frame node ID\n      layoutMode (VERTICAL | HORIZONTAL, optional) \u2014 Direction (default: auto-detected)\n      itemSpacing (number, optional) \u2014 Spacing between children\n    depth (number, optional) \u2014 Response detail for fixed nodes: omit for stubs, 0=properties, -1=full tree"
+    }
+  },
+  "prototyping": {
+    "summary": '# prototyping\nManage prototype interactions, reactions, and navigation flows.\n\nMethods:\n  get                  Get reactions and overflow direction on a node [read]\n  add                  Add a prototype reaction to a node [edit]\n  set                  Replace all reactions on a node (raw reactions array) [edit]\n  remove               Remove a reaction from a node by index [edit]\n\n// Reactions wire up interactions: trigger (ON_CLICK, ON_HOVER, ...) \u2192 action (navigate, swap, overlay).\n// Common patterns: button ON_CLICK \u2192 NAVIGATE to detail frame; card ON_HOVER \u2192 CHANGE_TO hover variant.\n// Multi-action: pass actions[] array to run multiple actions on one trigger (e.g. navigate + set variable mode).\n// ---\n// TRIGGERS: ON_CLICK | ON_HOVER | ON_PRESS | ON_DRAG | AFTER_TIMEOUT(timeout) | MOUSE_ENTER(delay) | MOUSE_LEAVE(delay) | ON_KEY_DOWN(keyCodes)\n// NAVIGATION: NAVIGATE (go to frame) | SWAP (swap overlay) | OVERLAY (show overlay) | SCROLL_TO | CHANGE_TO (swap component variant)\n// TRANSITIONS: DISSOLVE | SMART_ANIMATE | MOVE_IN | MOVE_OUT | PUSH | SLIDE_IN | SLIDE_OUT (+ direction for directional)\n// EASING: EASE_IN | EASE_OUT | EASE_IN_AND_OUT | LINEAR | GENTLE | QUICK | BOUNCY | SLOW\n// ACTIONS: NODE (navigate/swap) | BACK (go back) | CLOSE (close overlay) | URL (open link) | SET_VARIABLE_MODE (switch theme/mode)\n\nUse prototyping(method: "help", topic: "<method>") for method details.',
+    "methods": {
+      "get": "# prototyping.get\nGet reactions and overflow direction on a node\n\nParams:\n    id (string, required) \u2014 Node ID",
+      "add": '# prototyping.add\nAdd a prototype reaction to a node\n\nExample: prototyping(method:"add", id:"btn-1", trigger:"ON_CLICK", destination:"detail-frame-id", navigation:"NAVIGATE")\n\nParams:\n    id (string, required) \u2014 Node ID\n    trigger (ON_CLICK | ON_HOVER | ON_PRESS | ON_DRAG | AFTER_TIMEOUT | MOUSE_ENTER | MOUSE_LEAVE | ON_KEY_DOWN, required) \u2014 Trigger type\n    triggerDelay (number, optional) \u2014 Delay in ms for AFTER_TIMEOUT / MOUSE_ENTER / MOUSE_LEAVE triggers\n    triggerKeyCodes (number[], optional) \u2014 Key codes for ON_KEY_DOWN trigger\n    triggerDevice (KEYBOARD | XBOX_ONE | PS4 | SWITCH_PRO, optional) \u2014 Device for ON_KEY_DOWN (default: KEYBOARD)\n    destination (string, optional) \u2014 Target node ID (required for NODE actions)\n    navigation (NAVIGATE | SWAP | OVERLAY | SCROLL_TO | CHANGE_TO, optional) \u2014 Navigation type (default: NAVIGATE)\n    transition (DISSOLVE | SMART_ANIMATE | MOVE_IN | MOVE_OUT | PUSH | SLIDE_IN | SLIDE_OUT | INSTANT, optional) \u2014 Transition animation (default: DISSOLVE). INSTANT = no animation.\n    transitionDirection (LEFT | RIGHT | TOP | BOTTOM, optional) \u2014 Direction for MOVE_IN, MOVE_OUT, PUSH, SLIDE_IN, SLIDE_OUT\n    duration (number, optional) \u2014 Transition duration in seconds (default: 0.3)\n    easing (EASE_IN | EASE_OUT | EASE_IN_AND_OUT | LINEAR | GENTLE | QUICK | BOUNCY | SLOW, optional) \u2014 Easing function (default: EASE_OUT)\n    actionType (NODE | BACK | CLOSE | URL | SET_VARIABLE_MODE, optional) \u2014 Action type (default: NODE). SET_VARIABLE_MODE switches a variable collection mode.\n    url (string, optional) \u2014 URL for URL action type\n    collectionName (string, optional) \u2014 Variable collection name (for SET_VARIABLE_MODE)\n    modeName (string, optional) \u2014 Mode name to switch to (for SET_VARIABLE_MODE)\n    resetScrollPosition (boolean, optional) \u2014 Reset scroll position on navigate (default: true)\n    actions (array, optional) \u2014 Multi-action: [{actionType, destination?, navigation?, collectionName?, modeName?, ...}]. Overrides single-action params.',
+      "set": "# prototyping.set\nReplace all reactions on a node (raw reactions array)\n\nParams:\n    id (string, required) \u2014 Node ID\n    reactions (array, required) \u2014 Full reactions array \u2014 [{trigger:{type}, actions:[{type, destinationId, navigation, transition}]}]",
+      "remove": "# prototyping.remove\nRemove a reaction from a node by index\n\nParams:\n    id (string, required) \u2014 Node ID\n    index (number, required) \u2014 Reaction index (0-based)"
+    }
+  },
+  "selection": {
+    "summary": '# selection\nRead and set the current Figma selection.\n\nMethods:\n  get                  Get the current selection [read]\n  set                  Set selection to nodes and scroll viewport to show them [read]\n\n// Selection is the set of nodes currently highlighted in the Figma canvas.\n// get returns the current selection. Without depth, returns stubs ({id, name, type}). With depth=0, returns full properties.\n// _truncated: true when the response was cut short due to node budget limits. Use depth=0 or specific fields to reduce payload.\n// set replaces the entire selection AND scrolls the viewport to show the selected nodes.\n\nUse selection(method: "help", topic: "<method>") for method details.',
+    "methods": {
+      "get": "# selection.get\nGet the current selection\n\nParams:\n    depth (number, optional) \u2014 Child recursion depth. Omit for stubs only, 0=selected nodes' properties, -1=unlimited.\n    verbose (boolean, optional) \u2014 Include all properties (bounding box, constraints, text style details). Default false \u2014 returns slim, actionable output.",
+      "set": '# selection.set\nSet selection to nodes and scroll viewport to show them\n\nParams:\n    nodeIds (string[], required) \u2014 Array of node IDs to select. Example: ["1:2","1:3"]'
+    }
+  },
+  "styles": {
+    "summary": '# styles\nCRUD for local paint, text, effect, and grid styles.\n\nMethods:\n  list                 List local styles with optional type filter [read]\n  get                  Get full style detail by ID [read]\n  create               Create local styles [create]\n  update               Update styles by ID or name [edit]\n  delete               Delete styles [edit]\n\n// Styles are named, reusable design properties that can be applied to nodes. Four types:\n//   paint: a named color (applied to fills/strokes), text: typography settings, effect: shadows/blurs, grid: layout grids.\n// All ID params accept both IDs and display names (case-insensitive). Use whichever you have.\n// ---\n// leadingTrim: "CAP_HEIGHT" trims line-height to cap height (tighter text boxes), "NONE" is default.\n// fontStyle: font variant name like "Bold", "Italic", "Bold Italic". Use fonts.list to find available styles.\n//\n// Effect object shape (for effect styles):\n//   { type: "DROP_SHADOW"|"INNER_SHADOW"|"LAYER_BLUR"|"BACKGROUND_BLUR",\n//     color?: Color, offset?: {x, y}, radius: number, spread?: number,\n//     visible?: boolean, blendMode?: string }\n//   DROP_SHADOW/INNER_SHADOW require color, offset, radius. LAYER_BLUR/BACKGROUND_BLUR require radius only.\n//   Example: { type: "DROP_SHADOW", color: "#00000040", offset: {x:0,y:4}, radius: 8 }\n//\n// LayoutGrid object shape (for grid styles):\n//   Rows/Columns: { pattern: "ROWS"|"COLUMNS", alignment: "MIN"|"MAX"|"STRETCH"|"CENTER",\n//     gutterSize: number, count: number, sectionSize?: number, offset?: number, visible?: boolean, color?: Color }\n//   Grid: { pattern: "GRID", sectionSize: number, visible?: boolean, color?: Color }\n//   Example: { pattern: "COLUMNS", alignment: "STRETCH", gutterSize: 20, count: 12, offset: 40 }\n\nUse styles(method: "help", topic: "<method>") for method details.',
+    "methods": {
+      "list": '# styles.list\nList local styles with optional type filter\n\nParams:\n    type (paint | text | effect | grid, optional) \u2014 Filter by style type\n    fields (string[], optional) \u2014 Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.\n    offset (number, optional) \u2014 Skip N items for pagination (default 0)\n    limit (number, optional) \u2014 Max items per page (default 100)',
+      "get": '# styles.get\nGet full style detail by ID\n\nParams:\n    id (string, required) \u2014 Style ID or name\n    fields (string[], optional) \u2014 Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.',
+      "create": '# styles.create\nCreate local styles\n\nExample: styles(method:"create", type:"effect", name:"Shadow/Medium", effects:[{type:"DROP_SHADOW", color:"#00000040", offset:{x:0,y:4}, radius:8}])\n\nDiscriminant: type (paint | text | effect | grid)\n\n  ## paint \u2014 Paint/color style\n    name (string, required) \u2014 Style name\n    color (Color, required) \u2014 Color value\n    colorVariableName (string, optional) \u2014 Bind to a COLOR variable by name (style tracks the variable)\n    description (string, optional) \u2014 Style description\n\n  ## text \u2014 Text style\n    name (string, required) \u2014 Style name\n    fontFamily (string, required) \u2014 Font family\n    fontStyle (string, optional) \u2014 Font style (default: Regular)\n    fontSize (number, required) \u2014 Font size\n    lineHeight (line_height, optional)\n    letterSpacing (letter_spacing, optional)\n    textCase (ORIGINAL | UPPER | LOWER | TITLE | SMALL_CAPS | SMALL_CAPS_FORCED, optional)\n    textDecoration (NONE | UNDERLINE | STRIKETHROUGH, optional)\n    paragraphIndent (number, optional) \u2014 Paragraph indent (px)\n    paragraphSpacing (number, optional) \u2014 Paragraph spacing (px)\n    leadingTrim (CAP_HEIGHT | NONE, optional) \u2014 Leading trim mode\n    description (string, optional) \u2014 Style description\n\n  ## effect \u2014 Effect style\n    name (string, required) \u2014 Style name\n    effects (array, required) \u2014 Array of Effect objects\n    description (string, optional) \u2014 Style description\n\n  ## grid \u2014 Grid/layout grid style\n    name (string, required) \u2014 Style name\n    layoutGrids (array, required) \u2014 Array of LayoutGrid objects\n    description (string, optional) \u2014 Style description',
+      "update": '# styles.update\nUpdate styles by ID or name\n\nExample: styles(method:"update", items:[{id:"Surface/Primary", color:"#F5F5F5"}])\n\nParams:\n    type (paint | text | effect | grid, optional) \u2014 Style type hint for strict validation (optional, auto-detected)\n    items (PatchStyleItem[], required) \u2014 Array of {id, ...fields} to update\n      id (string, required) \u2014 Style ID or name\n      name (string, optional) \u2014 Rename the style\n      description (string, optional) \u2014 Style description\n      color (Color, optional) \u2014 New color (paint styles)\n      colorVariableName (string, optional) \u2014 Bind to a COLOR variable by name (paint styles)\n      fontFamily (string, optional)\n      fontStyle (string, optional)\n      fontSize (number, optional)\n      lineHeight (line_height, optional)\n      letterSpacing (letter_spacing, optional)\n      textCase (ORIGINAL | UPPER | LOWER | TITLE | SMALL_CAPS | SMALL_CAPS_FORCED, optional)\n      textDecoration (NONE | UNDERLINE | STRIKETHROUGH, optional)\n      paragraphIndent (number, optional) \u2014 Paragraph indent (px)\n      paragraphSpacing (number, optional) \u2014 Paragraph spacing (px)\n      leadingTrim (CAP_HEIGHT | NONE, optional)\n      effects (array, optional) \u2014 Array of Effect objects\n      layoutGrids (array, optional) \u2014 Array of LayoutGrid objects (grid styles)',
+      "delete": "# styles.delete\nDelete styles\n\nParams:\n    id (string, optional) \u2014 Style ID or name\n    items (array, optional) \u2014 Batch: [{id}, ...]\n      id (string, required) \u2014 Style ID or name"
+    }
+  },
+  "text": {
+    "summary": '# text\nCreate and manage text nodes.\n\nMethods:\n  get                  Get serialized node data [read]\n  list                 Search for nodes (returns stubs only \u2014 use get with depth for full properties) [read]\n  update               Patch node properties [edit]\n  delete               Delete nodes [edit]\n  clone                Duplicate nodes [create]\n  audit                Run lint on a node \u2014 returns severity-ranked findings [read]\n  reparent             Move nodes into a new parent [edit]\n  create               Create text nodes [create]\n  set_content          Replace text content on existing text nodes [edit]\n  scan                 Scan all text nodes within a subtree [read]\n\n// depth: omit \u2192 id+name stubs | 0 \u2192 props + child stubs | N \u2192 recurse N | -1 \u2192 full tree\n// fields: whitelist e.g. ["fills","opacity"] \u2014 id, name, type always included. Pass ["*"] for all.\n// layoutSizingHorizontal/Vertical: FIXED | HUG | FILL \u2014 how the node sizes within auto-layout.\n// Colors: fillVariableName/strokeVariableName bind by name \u2014 preferred over raw color values.\n// Note: node-based endpoints (frames, text, instances, components) use `results` as the list key.\n//   Standalone endpoints (styles, variables, variable_collections) use `items`. Components.list uses `items` (catalog view).\n// ---\n// visible: false hides the node. Omitted from response when true (the default).\n// locked: true prevents editing in Figma UI. Omitted when false (the default).\n// rotation: degrees (0-360). Omitted when 0.\n// blendMode: layer blend mode. Omitted when PASS_THROUGH (the default).\n// layoutPositioning: ABSOLUTE = floating inside auto-layout parent. Omitted when AUTO (the default).\n// minWidth/maxWidth/minHeight/maxHeight: responsive constraints for auto-layout children.\n// constraints: position behavior in non-auto-layout parents. Ignored inside auto-layout frames.\n// bindings: bind design variables to node properties. field uses slash path: "fills/0/color" (first fill), "strokes/0/color", "opacity", "width", "height", "cornerRadius", "paddingLeft", "itemSpacing".\n// explicitMode: pin a variable mode on this node. Use { collectionName, modeName } (preferred) or { collectionId, modeId }.\n// properties: escape hatch \u2014 set any Figma node property directly. Use only when no dedicated field exists.\ninterface Node {\n  id: string; name: string; type: string;\n  visible?: boolean;       // omitted when true\n  locked?: boolean;        // omitted when false\n  opacity?: number;        // omitted when 1\n  rotation?: number;       // omitted when 0\n  blendMode?: string;      // omitted when PASS_THROUGH\n  layoutPositioning?: "AUTO" | "ABSOLUTE";\n  layoutSizingHorizontal?: "FIXED" | "HUG" | "FILL";\n  layoutSizingVertical?: "FIXED" | "HUG" | "FILL";\n  minWidth?: number; maxWidth?: number; minHeight?: number; maxHeight?: number;\n  absoluteBoundingBox: { x: number; y: number; width: number; height: number };\n  fills?: Paint[];         // solid: {type: "SOLID", color: {r, g, b, a}}\n  strokes?: Paint[];\n  effects?: Effect[];      // DROP_SHADOW | INNER_SHADOW | LAYER_BLUR | BACKGROUND_BLUR\n  children?: NodeStub[];   // stubs: {id, name, type} \u2014 use depth to expand\n}\n// PatchItem uses flat params matching create shape \u2014 no nested sub-objects.\n// Fill/stroke/corner/layout/text params are identical to frames.create and text.create.\n// Unknown keys produce a warning, preventing silent failures.\n// Text nodes display text content with typography styling. They inherit node methods (get, list, update, delete, clone, reparent).\n// textAutoResize: NONE (fixed box), WIDTH_AND_HEIGHT (grow both), HEIGHT (fixed width, auto height), TRUNCATE (fixed + ellipsis).\n// Prefer textStyleName for typography, fontColorVariableName/fontColorStyleName for color.\n// Aliases: fillColor \u2192 fontColor, fillVariableName \u2192 fontColorVariableName, fillStyleName \u2192 fontColorStyleName (consistent with frames API).\n// ---\n// Smart defaults inside auto-layout parent: layoutSizingHorizontal defaults to FILL, layoutSizingVertical to HUG, textAutoResize to HEIGHT.\n//   Text fills parent width and wraps automatically. Override with explicit values if needed.\n// fontStyle vs fontWeight: fontStyle is a named variant like "Bold", "Italic", "SemiBold". When set, fontWeight is ignored.\n//   Use fonts.list to find available fontFamily + fontStyle combinations.\n// scan: finds all text nodes in a subtree. path (when includePath:true) shows the layer hierarchy e.g. "Frame > Card > Label".\n// ScanResult (per-item): { nodeId, count, truncated, textNodes: [{ id, name, characters, fontSize, fontFamily, fontStyle, path?, depth?, absoluteX?, absoluteY?, width?, height? }] }\n\nUse text(method: "help", topic: "<method>") for method details.',
+    "methods": {
+      "get": '# text.get\nGet serialized node data\n\nParams:\n    id (string, required) \u2014 Node ID\n    fields (string[], optional) \u2014 Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.\n    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.\n    verbose (boolean, optional) \u2014 Include all properties (bounding box, constraints, text style details). Default false \u2014 returns slim, actionable output.',
+      "list": '# text.list\nSearch for nodes (returns stubs only \u2014 use get with depth for full properties)\n\nParams:\n    query (string, optional) \u2014 Name search query (case-insensitive substring match)\n    types (string[], optional) \u2014 Filter by node types (e.g. ["FRAME", "TEXT"])\n    parentId (string, optional) \u2014 Search only within this subtree\n    fields (string[], optional) \u2014 Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.\n    offset (number, optional) \u2014 Skip N items for pagination (default 0)\n    limit (number, optional) \u2014 Max items per page (default 100)',
+      "update": `# text.update
+Patch node properties
+
+Params:
+    items (PatchItem[], required) \u2014 Array of {id, ...properties} to patch
+      fills (array, optional) \u2014 Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent. Primary way to set fills.
+      fillColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)
+      fillStyleName (string, optional) \u2014 Paint style name for fill
+      fillVariableName (string, optional) \u2014 Color variable by name e.g. 'bg/primary'
+      strokes (array, optional) \u2014 Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear. Primary way to set strokes.
+      strokeColor (Color, optional) \u2014 Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)
+      strokeStyleName (string, optional) \u2014 Paint style name for stroke
+      strokeVariableName (string, optional) \u2014 Color variable by name for stroke
+      strokeWeight (string, optional) \u2014 All sides (number) or variable name (string). Per-side: strokeTopWeight, strokeBottomWeight, strokeLeftWeight, strokeRightWeight.
+      strokeTopWeight (string, optional)
+      strokeBottomWeight (string, optional)
+      strokeLeftWeight (string, optional)
+      strokeRightWeight (string, optional)
+      strokeAlign (INSIDE | OUTSIDE | CENTER, optional) \u2014 Stroke position (default: INSIDE)
+      strokesIncludedInLayout (boolean, optional) \u2014 Include stroke width in layout measurements (default: false)
+      cornerRadius (string, optional) \u2014 All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius.
+      topLeftRadius (string, optional)
+      topRightRadius (string, optional)
+      bottomRightRadius (string, optional)
+      bottomLeftRadius (string, optional)
+      opacity (string, optional) \u2014 Opacity (0-1) or variable name
+      visible (boolean, optional) \u2014 Show/hide (default true)
+      locked (boolean, optional) \u2014 Lock/unlock (default false)
+      blendMode (PASS_THROUGH | NORMAL | DARKEN | MULTIPLY | LINEAR_BURN | COLOR_BURN | LIGHTEN | SCREEN | LINEAR_DODGE | COLOR_DODGE | OVERLAY | SOFT_LIGHT | HARD_LIGHT | DIFFERENCE | EXCLUSION | HUE | SATURATION | COLOR | LUMINOSITY, optional)
+      effectStyleName (string, optional) \u2014 Effect style name (e.g. 'Shadow/Card') for shadows, blurs
+      layoutMode (NONE | HORIZONTAL | VERTICAL, optional) \u2014 Layout direction (default: NONE)
+      layoutWrap (NO_WRAP | WRAP, optional)
+      padding (string, optional) \u2014 All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft.
+      paddingTop (string, optional)
+      paddingRight (string, optional)
+      paddingBottom (string, optional)
+      paddingLeft (string, optional)
+      primaryAxisAlignItems (MIN | MAX | CENTER | SPACE_BETWEEN, optional)
+      counterAxisAlignItems (MIN | MAX | CENTER | BASELINE, optional)
+      itemSpacing (string, optional) \u2014 Spacing between children (number or variable name string, default: 0)
+      counterAxisSpacing (string, optional) \u2014 Gap between wrapped rows (requires layoutWrap: WRAP)
+      layoutSizingHorizontal (FIXED | HUG | FILL, optional)
+      layoutSizingVertical (FIXED | HUG | FILL, optional)
+      layoutPositioning (AUTO | ABSOLUTE, optional) \u2014 ABSOLUTE = floating inside auto-layout parent
+      minWidth (number, optional) \u2014 Min width for responsive auto-layout
+      maxWidth (number, optional) \u2014 Max width for responsive auto-layout
+      minHeight (number, optional) \u2014 Min height for responsive auto-layout
+      maxHeight (number, optional) \u2014 Max height for responsive auto-layout
+      fontSize (number, optional) \u2014 Font size
+      fontFamily (string, optional) \u2014 Font family
+      fontStyle (string, optional) \u2014 Font variant e.g. "Bold", "Italic" \u2014 overrides fontWeight
+      fontWeight (number, optional) \u2014 100-900. Ignored when fontStyle is set.
+      fontColor (Color, optional) \u2014 Shorthand \u2014 sets text color (auto-binds to matching variable/style)
+      fontColorVariableName (string, optional) \u2014 Bind color variable by name e.g. 'text/primary'
+      fontColorStyleName (string, optional) \u2014 Apply paint style \u2014 overrides fontColor
+      textStyleId (string, optional) \u2014 Apply text style by ID \u2014 overrides fontSize/fontWeight
+      textStyleName (string, optional) \u2014 Text style by name (case-insensitive)
+      textAlignHorizontal (LEFT | CENTER | RIGHT | JUSTIFIED, optional)
+      textAlignVertical (TOP | CENTER | BOTTOM, optional)
+      textAutoResize (NONE | WIDTH_AND_HEIGHT | HEIGHT | TRUNCATE, optional)
+      id (string, required)
+      name (string, optional) \u2014 Rename node
+      rotation (number, optional) \u2014 Degrees (0-360)
+      x (number, optional)
+      y (number, optional)
+      width (number, optional)
+      height (number, optional)
+      clearFill (boolean, optional) \u2014 Remove all fills
+      effects (array, optional) \u2014 Effect array (DROP_SHADOW, INNER_SHADOW, LAYER_BLUR, BACKGROUND_BLUR)
+      overflowDirection (NONE | HORIZONTAL | VERTICAL | BOTH, optional) \u2014 Scroll overflow in prototype (default: NONE)
+      constraints (object, optional)
+      bindings (array, optional) \u2014 Bind variables to properties. field path examples: 'fills/0/color', 'strokes/0/color', 'opacity', 'width', 'cornerRadius', 'itemSpacing'.
+        field (string, required)
+        variableName (string, optional)
+        variableId (string, optional)
+      explicitMode (object, optional) \u2014 Pin variable mode \u2014 use { collectionName, modeName } (preferred) or { collectionId, modeId }
+      exportSettings (array, optional) \u2014 Export settings
+      properties (object, optional) \u2014 Direct Figma API props (escape hatch)`,
+      "delete": "# text.delete\nDelete nodes\n\nParams:\n    id (string, optional) \u2014 Single node ID\n    items (array, optional) \u2014 Batch: [{id}, ...]\n      id (string, optional)",
+      "clone": "# text.clone\nDuplicate nodes\n\nParams:\n    id (string, required) \u2014 Node ID\n    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.\n    x (number, optional) \u2014 X position (default: 0)\n    y (number, optional) \u2014 Y position (default: 0)\n    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.",
+      "audit": '# text.audit\nRun lint on a node \u2014 returns severity-ranked findings\n\nParams:\n    id (string, required) \u2014 Node ID to audit\n    rules (string[], optional) \u2014 Rules to check. Default: ["all"]. Categories: "component", "composition", "token", "naming", "wcag".\n    maxDepth (number, optional) \u2014 Max tree depth (default: 10)\n    maxFindings (number, optional) \u2014 Max findings (default: 50)',
+      "reparent": "# text.reparent\nMove nodes into a new parent\n\nParams:\n    items (array, required) \u2014 Array of {id, parentId, index?}\n      id (string, required)\n      parentId (string, required)\n      index (number, optional)",
+      "create": `# text.create
+Create text nodes
+
+Example: text(method:"create", items:[{text:"Hello", fontFamily:"Inter", fontSize:16, textStyleName:"body/medium"}])
+
+Params:
+    items (TextItem[], required) \u2014 Array of text items to create
+      text (string, optional) \u2014 Text content
+      name (string, optional) \u2014 Layer name
+      x (number, optional)
+      y (number, optional)
+      width (number, optional) \u2014 Fixed width in px \u2014 implies layoutSizingHorizontal: FIXED and textAutoResize: HEIGHT
+      parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+      fontFamily (string, optional) \u2014 Font family (default: Inter). Use fonts.list to find installed fonts.
+      fontStyle (string, optional) \u2014 Font variant e.g. "Bold", "Italic" \u2014 overrides fontWeight
+      fontSize (number, optional) \u2014 Font size (default: 14)
+      fontWeight (number, optional) \u2014 100-900 (default: 400). Ignored when fontStyle is set.
+      fills (array, optional) \u2014 Text color paints \u2014 e.g. [{type: 'SOLID', color: '#hex'}]. Same as node fills.
+      fontColor (Color, optional) \u2014 Shorthand \u2014 sets text color (auto-binds to matching variable/style)
+      fontColorVariableName (string, optional) \u2014 Bind color variable by name e.g. 'text/primary'
+      fontColorStyleName (string, optional) \u2014 Apply paint style \u2014 overrides fontColor
+      textStyleId (string, optional) \u2014 Text style ID or name (case-insensitive) \u2014 overrides fontSize/fontWeight
+      textStyleName (string, optional) \u2014 Alias for textStyleId \u2014 accepts name (case-insensitive)
+      textAlignHorizontal (LEFT | CENTER | RIGHT | JUSTIFIED, optional)
+      textAlignVertical (TOP | CENTER | BOTTOM, optional)
+      layoutSizingHorizontal (FIXED | HUG | FILL, optional)
+      layoutSizingVertical (FIXED | HUG | FILL, optional)
+      textAutoResize (NONE | WIDTH_AND_HEIGHT | HEIGHT | TRUNCATE, optional) \u2014 NONE (fixed box), WIDTH_AND_HEIGHT (grow both), HEIGHT (fixed width, auto height), TRUNCATE (fixed + ellipsis)
+      componentPropertyName (string, optional) \u2014 Bind to a component TEXT property by name. Walks up ancestors to find the nearest component, or targets the component specified by componentId. For deeply nested text, consider using components(method:'create', type:'from_node') with exposeText:true instead \u2014 it auto-discovers and binds all text nodes.
+      componentId (string, optional) \u2014 Target component ID for componentPropertyName binding. When omitted, walks up ancestors to find the nearest COMPONENT or COMPONENT_SET.
+    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.`,
+      "set_content": "# text.set_content\nReplace text content on existing text nodes\n\nParams:\n    items (array, required) \u2014 Array of {nodeId, text}\n      nodeId (string, required) \u2014 Text node ID\n      text (string, required) \u2014 New text content\n    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.",
+      "scan": "# text.scan\nScan all text nodes within a subtree\n\nParams:\n    items ({ nodeId: string; limit?: number; includePath?: boolean; includeGeometry?: boolean }[], required) \u2014 Array of subtrees to scan"
+    }
+  },
+  "variable_collections": {
+    "summary": '# variable_collections\nCRUD for variable collections \u2014 the document-level API for design tokens.\n\nMethods:\n  list                 List variable collections [read]\n  get                  Get collection with all variables and values (full document) [read]\n  create               Create a collection with modes and variables in one call [create]\n  update               Rename collections [edit]\n  delete               Delete collections [edit]\n  add_mode             Add a mode to a collection [create]\n  rename_mode          Rename a mode [edit]\n  remove_mode          Remove a mode from a collection [edit]\n\n// Variable collections group design tokens and define their modes (e.g. Light/Dark, Desktop/Mobile).\n// All ID params accept both IDs and display names.\n// ---\n// valuesByMode: values keyed by mode name, e.g. {"Light": "#FFF", "Dark": "#111"}.\n// Aliases: {type: "VARIABLE_ALIAS", name: "other/variable"}.\n// scopes: see variables endpoint for full list.\n// Deleting a collection deletes all variables inside it.\n// The default mode cannot be removed. Use add_mode/remove_mode for additional modes.\n\nUse variable_collections(method: "help", topic: "<method>") for method details.',
+    "methods": {
+      "list": '# variable_collections.list\nList variable collections\n\nParams:\n    fields (string[], optional) \u2014 Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.\n    offset (number, optional) \u2014 Skip N items for pagination (default 0)\n    limit (number, optional) \u2014 Max items per page (default 100)',
+      "get": '# variable_collections.get\nGet collection with all variables and values (full document)\n\nParams:\n    id (string, required) \u2014 Collection ID or name\n    fields (string[], optional) \u2014 Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.',
+      "create": `# variable_collections.create
+Create a collection with modes and variables in one call
+
+Example: variable_collections(method:"create", items:[{name:"Tokens", modes:["Light","Dark"], variables:[{name:"bg/primary", type:"COLOR", valuesByMode:{"Light":"#FFF","Dark":"#111"}, scopes:["ALL_FILLS"]}, {name:"text/primary", type:"COLOR", valuesByMode:{"Light":"#111","Dark":"#F0F0F0"}, scopes:["TEXT_FILL"]}, {name:"space/16", type:"FLOAT", value:16, scopes:["GAP","WIDTH_HEIGHT"]}, {name:"radius/8", type:"FLOAT", value:8, scopes:["CORNER_RADIUS"]}]}])
+
+Params:
+    items (array, required) \u2014 Array of collection documents
+      name (string, required) \u2014 Collection name
+      modes (string[], optional) \u2014 Mode names (e.g. ['Light', 'Dark']). Omit for single-mode collection.
+      variables (array, optional) \u2014 Variables to create inside this collection
+        name (string, required) \u2014 Variable name (unique within collection)
+        type (COLOR | FLOAT | STRING | BOOLEAN, required) \u2014 Variable type
+        value (variable_value, optional) \u2014 Shorthand \u2014 sets the default mode value. Use valuesByMode for multi-mode.
+        valuesByMode (object, optional) \u2014 Values keyed by mode name (e.g. {"Light": "#FFF", "Dark": "#111"})
+        description (string, optional)
+        scopes (string[], optional) \u2014 Restrict where variable can be applied (default: ALL_SCOPES)`,
+      "update": "# variable_collections.update\nRename collections\n\nParams:\n    items (array, required) \u2014 Array of {id, name}\n      id (string, required) \u2014 Collection ID or name\n      name (string, required) \u2014 New name",
+      "delete": "# variable_collections.delete\nDelete collections\n\nParams:\n    id (string, optional) \u2014 Collection ID or name\n    items (array, optional) \u2014 Batch: [{id}, ...]\n      id (string, required)",
+      "add_mode": "# variable_collections.add_mode\nAdd a mode to a collection\n\nParams:\n    items (array, required) \u2014 Array of {collectionId, name}\n      collectionId (string, required) \u2014 Collection ID or name\n      name (string, required) \u2014 Mode name",
+      "rename_mode": '# variable_collections.rename_mode\nRename a mode\n\nParams:\n    items (array, required) \u2014 Array of {collectionId, modeId, name}\n      collectionId (string, required) \u2014 Collection ID or name\n      modeId (string, required) \u2014 Mode ID or name (e.g. "Dark")\n      name (string, required) \u2014 New name',
+      "remove_mode": '# variable_collections.remove_mode\nRemove a mode from a collection\n\nParams:\n    items (array, required) \u2014 Array of {collectionId, modeId}\n      collectionId (string, required) \u2014 Collection ID or name\n      modeId (string, required) \u2014 Mode ID or name (e.g. "Dark")'
+    }
+  },
+  "variables": {
+    "summary": '# variables\nSearch and update design variables within a collection.\n\nMethods:\n  list                 Search variables within a collection [read]\n  get                  Get variable detail by name [read]\n  create               Create variables in a collection. Use valuesByMode for multi-mode, or value for default mode only. [create]\n  update               Update variable metadata and/or set values [edit]\n  delete               Delete variables [edit]\n\n// Search and update variables within a collection. collectionId is required on all methods.\n// Use variable_collections to create full token sets (collection + modes + variables in one call).\n// ---\n// query: prefix match first, then substring. "bg/" matches bg/canvas, bg/surface, etc.\n// valuesByMode: values keyed by mode name. value is shorthand for the default mode.\n// Aliases: {type: "VARIABLE_ALIAS", name: "other/variable"}.\n// scopes: ALL_SCOPES, TEXT_CONTENT, WIDTH_HEIGHT, GAP, CORNER_RADIUS, ALL_FILLS, FRAME_FILL, SHAPE_FILL,\n//   TEXT_FILL, STROKE_COLOR, STROKE_FLOAT, EFFECT_FLOAT, EFFECT_COLOR, OPACITY, FONT_FAMILY, FONT_STYLE,\n//   FONT_WEIGHT, FONT_SIZE, LINE_HEIGHT, LETTER_SPACING, PARAGRAPH_SPACING, PARAGRAPH_INDENT\n\nUse variables(method: "help", topic: "<method>") for method details.',
+    "methods": {
+      "list": '# variables.list\nSearch variables within a collection\n\nExample: variables(method:"list", collectionId:"Colors", query:"bg/")\n\nParams:\n    collectionId (string, required) \u2014 Collection ID or name\n    query (string, optional) \u2014 Search query \u2014 prefix match first, then substring fallback\n    type (COLOR | FLOAT | STRING | BOOLEAN, optional) \u2014 Filter by variable type\n    fields (string[], optional) \u2014 Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.\n    offset (number, optional) \u2014 Skip N items for pagination (default 0)\n    limit (number, optional) \u2014 Max items per page (default 100)',
+      "get": '# variables.get\nGet variable detail by name\n\nParams:\n    name (string, required) \u2014 Variable name (unique within collection)\n    collectionId (string, required) \u2014 Collection ID or name\n    fields (string[], optional) \u2014 Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.',
+      "create": '# variables.create\nCreate variables in a collection. Use valuesByMode for multi-mode, or value for default mode only.\n\nExample: variables(method:"create", collectionId:"Colors", items:[{name:"bg/primary", type:"COLOR", valuesByMode:{"Light":"#FFF","Dark":"#111"}, scopes:["ALL_FILLS"]}])\n\nParams:\n    collectionId (string, required) \u2014 Collection ID or name\n    items (VariableCreateItem[], required) \u2014 Array of variables to create\n      name (string, required) \u2014 Variable name (must be unique within collection)\n      type (COLOR | FLOAT | STRING | BOOLEAN, required) \u2014 Variable type\n      value (variable_value, optional) \u2014 Shorthand \u2014 sets the default mode value. Use valuesByMode for multi-mode.\n      valuesByMode (object, optional) \u2014 Values keyed by mode name (e.g. {"Light": "#FFF", "Dark": "#111"}). Takes precedence over value.\n      description (string, optional) \u2014 Variable description\n      scopes (string[], optional) \u2014 Restrict where variable can be applied (default: ALL_SCOPES)',
+      "update": '# variables.update\nUpdate variable metadata and/or set values\n\nExample: variables(method:"update", collectionId:"Colors", items:[{name:"bg/primary", valuesByMode:{"Light":"#FFF","Dark":"#222"}}])\n\nParams:\n    collectionId (string, required) \u2014 Collection ID or name\n    items (VariableUpdateItem[], required) \u2014 Array of variable updates\n      name (string, required) \u2014 Variable name\n      rename (string, optional) \u2014 Rename the variable\n      description (string, optional) \u2014 Set description\n      scopes (string[], optional) \u2014 Update scopes\n      value (variable_value, optional) \u2014 Shorthand \u2014 sets the default mode value. Use valuesByMode for multi-mode.\n      valuesByMode (object, optional) \u2014 Values keyed by mode name. Takes precedence over value.',
+      "delete": "# variables.delete\nDelete variables\n\nParams:\n    collectionId (string, required) \u2014 Collection ID or name\n    name (string, optional) \u2014 Variable name\n    items (array, optional) \u2014 Batch: [{name}, ...]\n      name (string, required)"
+    }
+  },
+  "version_history": {
+    "summary": `# version_history
+Save named versions to the Figma file's version history.
+
+Methods:
+  save                 Save a named version to the file's version history [edit]
+
+// Version history lets you create named snapshots of a Figma file.
+// Use this after completing design tasks to create an audit trail of changes.
+// Equivalent to Figma's File \u2192 Save to Version History (Cmd+Opt+S).
+
+Use version_history(method: "help", topic: "<method>") for method details.`,
+    "methods": {
+      "save": `# version_history.save
+Save a named version to the file's version history
+
+Params:
+    title (string, required) \u2014 Version title (e.g., "Added hero sections with website copy")
+    description (string, optional) \u2014 Optional longer description of what changed`
+    }
+  }
+};
+var helpTopics = {
+  "missing_tools": '# Missing Create / Edit Tools\n\nIf the user asks you to create or modify something in Figma but you cannot find create/edit methods on endpoint tools, the MCP server was started without the correct access tier flag.\n\nVibma filters available methods at startup based on CLI flags passed in the MCP config `args` array:\n\n| Flag | Methods available |\n|------|-----------------|\n| _(none)_ | Read-only (get, list, check, scan, export) |\n| `--create` | Read + creation methods (create, clone) |\n| `--edit` | All methods (read + create + update + delete) |\n\nAsk the user to add `--edit` (or `--create`) to their MCP config args:\n\n```json\n{\n  "mcpServers": {\n    "Vibma": {\n      "command": "npx",\n      "args": ["-y", "@ufira/vibma", "--edit"]\n    }\n  }\n}\n```\n\nAfter updating, the user must restart their AI tool or reload MCP servers \u2014 stdio-based servers cannot hot-reload.'
+};
+var allEndpointNames = Object.keys(helpEndpoints);
+var allTopicNames = Object.keys(helpTopics);
+function resolveHelp(topic) {
+  if (!topic) return helpDirectory;
+  const dot = topic.indexOf(".");
+  if (dot === -1) {
+    const ep2 = helpEndpoints[topic];
+    if (ep2) return ep2.summary;
+    const t = helpTopics[topic];
+    if (t) return t;
+    const all = [...allEndpointNames, ...allTopicNames];
+    return "Unknown topic: " + topic + ". Available: " + all.join(", ");
+  }
+  const epName = topic.slice(0, dot);
+  const methodName = topic.slice(dot + 1);
+  const ep = helpEndpoints[epName];
+  if (!ep) {
+    const all = [...allEndpointNames, ...allTopicNames];
+    return "Unknown topic: " + epName + ". Available: " + all.join(", ");
+  }
+  const method = ep.methods[methodName];
+  if (method) return method;
+  return "Unknown method: " + methodName + " on " + epName + ". Available methods: " + Object.keys(ep.methods).join(", ");
+}
+function resolveEndpointHelp(endpoint, topic) {
+  const ep = helpEndpoints[endpoint];
+  if (!ep) return null;
+  if (!topic) return ep.summary;
+  const method = ep.methods[topic];
+  if (method) return method;
+  return "Unknown method: " + topic + ". Available methods on " + endpoint + ": " + Object.keys(ep.methods).join(", ");
+}
+
 // src/tools/registry.ts
-function registerTools(server2, sendCommand, caps2, tools16) {
-  for (const tool of tools16) {
+function resolveCommand(tool, params) {
+  if (tool.commandMap && params.method) {
+    const cmd = tool.commandMap[params.method];
+    if (cmd) return cmd;
+  }
+  return tool.command ?? tool.name;
+}
+function registerTools(server2, sendCommand, caps2, tools2) {
+  for (const tool of tools2) {
     if (tool.tier === "create" && !caps2.create) continue;
     if (tool.tier === "edit" && !caps2.edit) continue;
     const schema = typeof tool.schema === "function" ? tool.schema(caps2) : tool.schema;
-    const command = tool.command ?? tool.name;
     const timeout = tool.timeout;
-    const format = tool.formatResponse ?? mcpJson;
+    const defaultFormat = tool.formatResponse ?? mcpJson;
     server2.registerTool(tool.name, { description: tool.description, inputSchema: schema }, async (params) => {
       try {
+        if (params.method === "help") {
+          const text = resolveEndpointHelp(tool.name, params.topic) ?? resolveHelp(tool.name);
+          return { content: [{ type: "text", text }] };
+        }
         if (tool.validate) tool.validate(params);
+        const command = resolveCommand(tool, params);
         const result = await sendCommand(command, params, timeout);
+        const format = tool.methodFormatters?.[params.method] ?? defaultFormat;
         return format(result);
       } catch (e) {
+        if (e instanceof import_zod.ZodError) {
+          const hints = e.issues.map((i) => {
+            const path = i.path.join(".");
+            return `[${path}] ${i.message}`;
+          });
+          return mcpError(`${tool.name} validation error`, hints.join("; "));
+        }
         return mcpError(`${tool.name} error`, e);
       }
     });
   }
 }
 
-// src/tools/defs/connection.ts
-var tools = [
-  {
-    name: "ping",
-    description: "Verify end-to-end connection to Figma. Call this right after join_channel. Returns { status: 'pong', documentName, currentPage } if the full chain (MCP \u2192 relay \u2192 plugin \u2192 Figma) is working. If this times out, the Figma plugin is not connected \u2014 ask the user to check the plugin window for the correct port and channel name.",
-    schema: {},
-    tier: "read",
-    timeout: 5e3
-  }
-];
-
-// src/tools/defs/document.ts
-var import_zod = require("zod");
-var tools2 = [
-  {
-    name: "get_document_info",
-    description: "Get the document name, current page, and list of all pages.",
-    schema: {},
-    tier: "read"
-  },
-  {
-    name: "get_current_page",
-    description: "Get the current page info and its top-level children.",
-    schema: {},
-    tier: "read"
-  },
-  {
-    name: "set_current_page",
-    description: "Switch to a different page. Provide either pageId or pageName.",
-    schema: {
-      pageId: import_zod.z.string().optional().describe("The page ID to switch to"),
-      pageName: import_zod.z.string().optional().describe("The page name (case-insensitive, partial match)")
-    },
-    tier: "read"
-  },
-  {
-    name: "create_page",
-    description: "Create a new page in the document",
-    schema: { name: import_zod.z.string().optional().describe("Name for the new page (default: 'New Page')") },
-    tier: "create"
-  },
-  {
-    name: "rename_page",
-    description: "Rename a page. Defaults to current page if no pageId given.",
-    schema: {
-      newName: import_zod.z.string().describe("New name for the page"),
-      pageId: import_zod.z.string().optional().describe("Page ID (default: current page)")
-    },
-    tier: "edit"
-  }
-];
-
-// src/tools/defs/selection.ts
-var import_zod3 = require("zod");
+// src/tools/generated/defs.ts
+var import_zod4 = require("zod");
 
 // src/utils/coercion.ts
 var import_zod2 = require("zod");
@@ -148,87 +1044,15 @@ var flexJson = (inner) => import_zod2.z.preprocess((v) => {
   }
   return v;
 }, inner);
-var flexNum = (inner) => import_zod2.z.preprocess((v) => {
-  if (typeof v === "string") {
-    const n = Number(v);
-    if (!isNaN(n) && v.trim() !== "") return n;
-  }
-  return v;
-}, inner);
-
-// src/tools/defs/selection.ts
-var tools3 = [
-  {
-    name: "get_selection",
-    description: "Get the current selection. Without depth, returns stubs (id/name/type). With depth, returns full serialized node trees.",
-    schema: { depth: import_zod3.z.coerce.number().optional().describe("Child recursion depth. Omit for stubs only, 0=selected nodes' properties, -1=unlimited.") },
-    tier: "read"
-  },
-  {
-    name: "set_selection",
-    description: "Set selection to nodes and scroll viewport to show them. Also works as focus (single node).",
-    schema: {
-      nodeIds: flexJson(import_zod3.z.array(import_zod3.z.string())).describe('Array of node IDs to select. Example: ["1:2","1:3"]')
-    },
-    tier: "read"
-  }
-];
-
-// src/tools/defs/node-info.ts
-var import_zod4 = require("zod");
-var tools4 = [
-  {
-    name: "get_node_info",
-    description: "Get detailed information about one or more nodes. Always pass an array of IDs. Use `fields` to select only the properties you need (reduces context size).",
-    schema: {
-      nodeIds: flexJson(import_zod4.z.array(import_zod4.z.string())).describe('Array of node IDs. Example: ["1:2","1:3"]'),
-      depth: import_zod4.z.coerce.number().optional().describe("Child recursion depth (default: unlimited). 0=stubs only."),
-      fields: flexJson(import_zod4.z.array(import_zod4.z.string())).optional().describe('Whitelist of property names to include. Example: ["absoluteBoundingBox","layoutMode","fills"]. Omit to return all properties.')
-    },
-    tier: "read"
-  },
-  {
-    name: "search_nodes",
-    description: "Search nodes on the current page by name and/or type. Use set_current_page first to search other pages. Paginated (default 50).",
-    schema: {
-      query: import_zod4.z.string().optional().describe("Name search (case-insensitive substring). Omit to match all names."),
-      types: flexJson(import_zod4.z.array(import_zod4.z.string())).optional().describe('Filter by types. Example: ["FRAME","TEXT"]. Omit to match all types.'),
-      scopeNodeId: import_zod4.z.string().optional().describe("Node ID to search within (defaults to current page)"),
-      caseSensitive: flexBool(import_zod4.z.boolean()).optional().describe("Case-sensitive name match (default false)"),
-      limit: import_zod4.z.coerce.number().optional().describe("Max results (default 50)"),
-      offset: import_zod4.z.coerce.number().optional().describe("Skip N results for pagination (default 0)")
-    },
-    tier: "read"
-  },
-  {
-    name: "export_node_as_image",
-    description: "Export a node as an image from Figma",
-    schema: {
-      nodeId: import_zod4.z.string().describe("The node ID to export"),
-      format: import_zod4.z.enum(["PNG", "JPG", "SVG", "PDF"]).optional().describe("Export format (default: PNG)"),
-      scale: import_zod4.z.coerce.number().positive().optional().describe("Export scale (default: 1)")
-    },
-    tier: "read",
-    formatResponse: (result) => {
-      const r = result;
-      return {
-        content: [{ type: "image", data: r.imageData, mimeType: r.mimeType || "image/png" }]
-      };
-    }
-  }
-];
-
-// src/tools/defs/create-shape.ts
-var import_zod6 = require("zod");
 
 // src/tools/schemas.ts
-var import_zod5 = require("zod");
-var nodeId = import_zod5.z.string().describe("Node ID");
-var nodeIds = flexJson(import_zod5.z.array(import_zod5.z.string())).describe("Array of node IDs");
-var parentId = import_zod5.z.string().optional().describe("Parent node ID. Omit to place on current page.");
-var depth = import_zod5.z.coerce.number().optional().describe("Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.");
-var xPos = import_zod5.z.coerce.number().optional().describe("X position (default: 0)");
-var yPos = import_zod5.z.coerce.number().optional().describe("Y position (default: 0)");
+var import_zod3 = require("zod");
+var nodeId = import_zod3.z.string().describe("Node ID");
+var nodeIds = flexJson(import_zod3.z.array(import_zod3.z.string())).describe("Array of node IDs");
+var parentId = import_zod3.z.string().optional().describe("Parent node ID. Omit to place on current page.");
+var depth = import_zod3.z.coerce.number().optional().describe("Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.");
+var xPos = import_zod3.z.coerce.number().optional().describe("X position (default: 0)");
+var yPos = import_zod3.z.coerce.number().optional().describe("Y position (default: 0)");
 function parseHex(hex) {
   const m = hex.match(/^#?([0-9a-f]{3,8})$/i);
   if (!m) return null;
@@ -242,765 +1066,1433 @@ function parseHex(hex) {
   if (h.length === 8) return { r, g, b, a: parseInt(h.slice(6, 8), 16) / 255 };
   return { r, g, b };
 }
-var colorRgba = import_zod5.z.preprocess((v) => {
+var colorRgba = import_zod3.z.preprocess((v) => {
+  if (typeof v === "string") return parseHex(v) ?? v;
+  return v;
+}, import_zod3.z.union([
+  import_zod3.z.object({
+    r: import_zod3.z.coerce.number().min(0).max(1),
+    g: import_zod3.z.coerce.number().min(0).max(1),
+    b: import_zod3.z.coerce.number().min(0).max(1),
+    a: import_zod3.z.coerce.number().min(0).max(1).optional()
+  }),
+  import_zod3.z.string()
+  // Non-hex strings pass through for handler-level style/variable resolution
+])).describe('Hex "#FF0000", {r,g,b,a?} 0-1, or style/variable name.');
+var variableValue = import_zod3.z.preprocess((v) => {
   if (typeof v === "string") return parseHex(v) ?? v;
   return v;
-}, import_zod5.z.object({
-  r: import_zod5.z.coerce.number().min(0).max(1),
-  g: import_zod5.z.coerce.number().min(0).max(1),
-  b: import_zod5.z.coerce.number().min(0).max(1),
-  a: import_zod5.z.coerce.number().min(0).max(1).optional()
-})).describe('Hex "#FF0000" or {r,g,b,a?} with values 0-1.');
-var effectEntry = import_zod5.z.object({
-  type: import_zod5.z.enum(["DROP_SHADOW", "INNER_SHADOW", "LAYER_BLUR", "BACKGROUND_BLUR"]),
+}, import_zod3.z.union([
+  import_zod3.z.number(),
+  import_zod3.z.boolean(),
+  import_zod3.z.string(),
+  import_zod3.z.object({ r: import_zod3.z.number(), g: import_zod3.z.number(), b: import_zod3.z.number(), a: import_zod3.z.number().optional() }),
+  import_zod3.z.object({ type: import_zod3.z.literal("VARIABLE_ALIAS"), name: import_zod3.z.string() })
+])).describe('number, boolean, string, hex "#FF0000", {r,g,b,a?}, or {type:"VARIABLE_ALIAS",name:"other/variable"}');
+var lineHeight = import_zod3.z.union([
+  import_zod3.z.coerce.number(),
+  import_zod3.z.object({ value: import_zod3.z.coerce.number(), unit: import_zod3.z.enum(["PIXELS", "PERCENT", "AUTO"]) })
+]).describe('number (px) or {value, unit: "PIXELS"|"PERCENT"|"AUTO"}');
+var letterSpacing = import_zod3.z.union([
+  import_zod3.z.coerce.number(),
+  import_zod3.z.object({ value: import_zod3.z.coerce.number(), unit: import_zod3.z.enum(["PIXELS", "PERCENT"]) })
+]).describe('number (px) or {value, unit: "PIXELS"|"PERCENT"}');
+var stringOrBoolean = import_zod3.z.union([import_zod3.z.string(), import_zod3.z.boolean()]);
+var token = import_zod3.z.preprocess((v) => {
+  if (typeof v === "number") return String(v);
+  return v;
+}, import_zod3.z.string()).describe('number as string ("8") or variable name ("Radii/Medium")');
+var effectEntry = import_zod3.z.object({
+  type: import_zod3.z.enum(["DROP_SHADOW", "INNER_SHADOW", "LAYER_BLUR", "BACKGROUND_BLUR"]),
   color: flexJson(colorRgba).optional(),
-  offset: flexJson(import_zod5.z.object({ x: import_zod5.z.coerce.number(), y: import_zod5.z.coerce.number() })).optional(),
-  radius: import_zod5.z.coerce.number(),
-  spread: import_zod5.z.coerce.number().optional(),
-  visible: flexBool(import_zod5.z.boolean()).optional(),
-  blendMode: import_zod5.z.string().optional()
+  offset: flexJson(import_zod3.z.object({ x: import_zod3.z.coerce.number(), y: import_zod3.z.coerce.number() })).optional(),
+  radius: import_zod3.z.coerce.number(),
+  spread: import_zod3.z.coerce.number().optional(),
+  visible: flexBool(import_zod3.z.boolean()).optional(),
+  blendMode: import_zod3.z.string().optional()
 });
 
-// src/tools/defs/create-shape.ts
-var sectionItem = import_zod6.z.object({
-  name: import_zod6.z.string().optional().describe("Name (default: 'Section')"),
-  x: xPos,
-  y: yPos,
-  width: import_zod6.z.coerce.number().optional().describe("Width (default: 500)"),
-  height: import_zod6.z.coerce.number().optional().describe("Height (default: 500)"),
-  parentId,
-  fillColor: flexJson(colorRgba).optional().describe("Fill color. Default: no fill (transparent)."),
-  fillStyleName: import_zod6.z.string().optional().describe("Apply a fill paint style by name (case-insensitive)."),
-  fillVariableId: import_zod6.z.string().optional().describe("Bind a color variable to the fill.")
-});
-var svgItem = import_zod6.z.object({
-  svg: import_zod6.z.string().describe("SVG markup string"),
-  name: import_zod6.z.string().optional().describe("Layer name (default: 'SVG')"),
-  x: xPos,
-  y: yPos,
-  parentId
-});
-var tools5 = [
+// src/tools/generated/defs.ts
+function filterMethodsByTier(schema, caps2, methodTiers) {
+  const methods = Object.keys(methodTiers).filter((m) => {
+    const tier = methodTiers[m];
+    if (tier === "read") return true;
+    if (tier === "create") return caps2.create;
+    if (tier === "edit") return caps2.edit;
+    return false;
+  });
+  return { ...schema, method: import_zod4.z.enum(methods) };
+}
+var tools = [
   {
-    name: "create_section",
-    description: "Create section nodes to organize content on the canvas. Default: no fill (transparent).",
-    schema: { items: flexJson(import_zod6.z.array(sectionItem)).describe("Array of sections to create"), depth },
-    tier: "create"
+    name: "components",
+    description: '/** Create and manage reusable components and variant sets. Use method "help" for detailed parameter docs. */\n  clone     (id, parentId?, x?, y?, depth?) \u2192 { results: {id}[] }  // Duplicate nodes\n  audit     (id, rules?, maxDepth?, maxFindings?) \u2192 { nodeId?, nodeName?, categories? }  // Run lint on a node \u2014 returns severity-ranked findings\n  reparent  (items: { id: string; parentId: string; index?: number }[]) \u2192 { results: "ok"[] }  // Move nodes into a new parent\n  list      (query?, offset?, limit?) \u2192 { totalCount, items }  // List local component names (variant sets as single entries)\n  get       (id?, names?) \u2192 { results }  // Get component detail \u2014 property definitions + ID for instances.create\n  create    (type: component|from_node|variant_set, items: (ComponentItem | FromNodeItem | VariantSetItem)[]) \u2192 { results: {id}[] }  // Create components\n  update    (items: UpdatePropertyItem[], depth?) \u2192 { results: ("ok" | {error})[] }  // Add, edit, or delete component properties\n  delete    (id) \u2192 { results: "ok"[] }  // Delete components or component sets\n// depth: omit \u2192 id+name stubs | 0 \u2192 props + child stubs | N \u2192 recurse N | -1 \u2192 full tree\n// fields: whitelist e.g. ["fills","opacity"] \u2014 id, name, type always included. Pass ["*"] for all.\n// layoutSizingHorizontal/Vertical: FIXED | HUG | FILL \u2014 how the node sizes within auto-layout.\n// Colors: fillVariableName/strokeVariableName bind by name \u2014 preferred over raw color values.\n// Note: node-based endpoints (frames, text, instances, components) use `results` as the list key.\n//   Standalone endpoints (styles, variables, variable_collections) use `items`. Components.list uses `items` (catalog view).',
+    schema: (caps2) => filterMethodsByTier({
+      method: import_zod4.z.enum(["clone", "audit", "reparent", "list", "get", "create", "update", "delete", "help"]),
+      id: import_zod4.z.string().optional().describe("Node ID"),
+      parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place on current page."),
+      x: import_zod4.z.coerce.number().optional().describe("X position (default: 0)"),
+      y: import_zod4.z.coerce.number().optional().describe("Y position (default: 0)"),
+      depth: import_zod4.z.coerce.number().optional().describe("Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited."),
+      rules: flexJson(import_zod4.z.array(import_zod4.z.string())).optional().describe('Rules to check. Default: ["all"]. Categories: "component", "composition", "token", "naming", "wcag".'),
+      maxDepth: import_zod4.z.coerce.number().optional().describe("Max tree depth (default: 10)"),
+      maxFindings: import_zod4.z.coerce.number().optional().describe("Max findings (default: 50)"),
+      items: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).optional().describe("Array of {id, ...properties} to reparent/update"),
+      query: import_zod4.z.string().optional().describe("Name search query (case-insensitive substring match)"),
+      offset: import_zod4.z.coerce.number().optional().default(0).describe("Skip N items for pagination (default 0)"),
+      limit: import_zod4.z.coerce.number().optional().default(100).describe("Max items per page (default 100)"),
+      names: flexJson(import_zod4.z.array(import_zod4.z.string())).optional().describe("Batch lookup by name (case-insensitive). Either id or names is required."),
+      type: import_zod4.z.enum(["component", "from_node", "variant_set"]).optional().describe("Discriminant for create method"),
+      topic: import_zod4.z.string().optional().describe('Help topic \u2014 method name for endpoint help, e.g. "create"')
+    }, caps2, { "clone": "create", "audit": "read", "reparent": "edit", "list": "read", "get": "read", "create": "create", "update": "edit", "delete": "edit", "help": "read" }),
+    tier: "read",
+    validate: (params) => {
+      const m = params.method;
+      if (m === "delete") {
+        if (params.id === void 0) throw new Error('delete requires "id"');
+      }
+      if (!params.items) return;
+      if (m === "create") {
+        if (params.items) {
+          if (params.type === "variant_set") for (const it of params.items) {
+            if (it.nodeIds !== void 0 && it.componentIds === void 0) {
+              it.componentIds = it.nodeIds;
+              delete it.nodeIds;
+            }
+          }
+        }
+        const schemas = {
+          "component": import_zod4.z.object({
+            name: import_zod4.z.string().describe("Component name"),
+            parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place on current page."),
+            x: import_zod4.z.coerce.number().optional().describe("X position (default: 0)"),
+            y: import_zod4.z.coerce.number().optional().describe("Y position (default: 0)"),
+            width: import_zod4.z.coerce.number().optional().describe("Width (default: 100)"),
+            height: import_zod4.z.coerce.number().optional().describe("Height (default: 100)"),
+            rotation: import_zod4.z.coerce.number().optional().describe("Rotation in degrees (0-360)"),
+            opacity: token.optional().describe("Opacity (0-1) or variable name"),
+            visible: flexBool(import_zod4.z.boolean()).optional().describe("Show/hide (default true)"),
+            locked: flexBool(import_zod4.z.boolean()).optional().describe("Lock/unlock (default false)"),
+            blendMode: import_zod4.z.enum(["PASS_THROUGH", "NORMAL", "DARKEN", "MULTIPLY", "LINEAR_BURN", "COLOR_BURN", "LIGHTEN", "SCREEN", "LINEAR_DODGE", "COLOR_DODGE", "OVERLAY", "SOFT_LIGHT", "HARD_LIGHT", "DIFFERENCE", "EXCLUSION", "HUE", "SATURATION", "COLOR", "LUMINOSITY"]).optional(),
+            layoutPositioning: import_zod4.z.enum(["AUTO", "ABSOLUTE"]).optional().describe("ABSOLUTE = floating inside auto-layout parent"),
+            fills: import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown())).optional().describe("Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent. Primary way to set fills."),
+            fillColor: colorRgba.optional().describe("Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)"),
+            fillStyleName: import_zod4.z.string().optional().describe("Paint style name for fill"),
+            fillVariableName: import_zod4.z.string().optional().describe("Color variable by name e.g. 'bg/primary'"),
+            strokes: import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown())).optional().describe("Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear. Primary way to set strokes."),
+            strokeColor: colorRgba.optional().describe("Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)"),
+            strokeStyleName: import_zod4.z.string().optional().describe("Paint style name for stroke"),
+            strokeVariableName: import_zod4.z.string().optional().describe("Color variable by name for stroke"),
+            strokeWeight: token.optional().describe("All sides (number) or variable name (string). Per-side: strokeTopWeight, strokeBottomWeight, strokeLeftWeight, strokeRightWeight."),
+            strokeTopWeight: token.optional(),
+            strokeBottomWeight: token.optional(),
+            strokeLeftWeight: token.optional(),
+            strokeRightWeight: token.optional(),
+            strokeAlign: import_zod4.z.enum(["INSIDE", "OUTSIDE", "CENTER"]).optional().describe("Stroke position (default: INSIDE)"),
+            strokesIncludedInLayout: flexBool(import_zod4.z.boolean()).optional().describe("Include stroke width in layout measurements (default: false)"),
+            cornerRadius: token.optional().describe("All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius."),
+            topLeftRadius: token.optional(),
+            topRightRadius: token.optional(),
+            bottomRightRadius: token.optional(),
+            bottomLeftRadius: token.optional(),
+            effectStyleName: import_zod4.z.string().optional().describe("Effect style name (e.g. 'Shadow/Card') for shadows, blurs"),
+            layoutMode: import_zod4.z.enum(["NONE", "HORIZONTAL", "VERTICAL"]).optional().describe("Layout direction (default: NONE)"),
+            layoutWrap: import_zod4.z.enum(["NO_WRAP", "WRAP"]).optional(),
+            padding: token.optional().describe("All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft."),
+            paddingTop: token.optional(),
+            paddingRight: token.optional(),
+            paddingBottom: token.optional(),
+            paddingLeft: token.optional(),
+            primaryAxisAlignItems: import_zod4.z.enum(["MIN", "MAX", "CENTER", "SPACE_BETWEEN"]).optional(),
+            counterAxisAlignItems: import_zod4.z.enum(["MIN", "MAX", "CENTER", "BASELINE"]).optional(),
+            layoutSizingHorizontal: import_zod4.z.enum(["FIXED", "HUG", "FILL"]).optional(),
+            layoutSizingVertical: import_zod4.z.enum(["FIXED", "HUG", "FILL"]).optional(),
+            itemSpacing: token.optional().describe("Spacing between children (number or variable name string, default: 0)"),
+            counterAxisSpacing: token.optional().describe("Gap between wrapped rows (requires layoutWrap: WRAP)"),
+            minWidth: import_zod4.z.coerce.number().optional().describe("Min width for responsive auto-layout"),
+            maxWidth: import_zod4.z.coerce.number().optional().describe("Max width for responsive auto-layout"),
+            minHeight: import_zod4.z.coerce.number().optional().describe("Min height for responsive auto-layout"),
+            maxHeight: import_zod4.z.coerce.number().optional().describe("Max height for responsive auto-layout"),
+            overflowDirection: import_zod4.z.enum(["NONE", "HORIZONTAL", "VERTICAL", "BOTH"]).optional().describe("Scroll overflow in prototype (default: NONE)"),
+            description: import_zod4.z.string().optional().describe("Component description (shown in Figma's component panel)"),
+            children: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).optional().describe('Inline child nodes. Text: {type:"text", text, componentPropertyName?, fontFamily?, fontSize?, fontColor?}. Frame: {type:"frame", name?, layoutMode?, fillColor?, children?}. Text with componentPropertyName auto-creates and binds a TEXT property \u2014 no need to add it to properties separately.'),
+            properties: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).optional().describe("Component properties to define at creation: [{propertyName, type, defaultValue}]. TEXT properties for inline children with componentPropertyName are created automatically.")
+          }).passthrough(),
+          "from_node": import_zod4.z.object({
+            nodeId: import_zod4.z.string().describe("Node ID to convert"),
+            exposeText: flexBool(import_zod4.z.boolean()).optional().describe("Auto-expose text as editable properties (default: true)")
+          }).passthrough(),
+          "variant_set": import_zod4.z.object({
+            name: import_zod4.z.string().optional().describe("Node name"),
+            parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place on current page."),
+            x: import_zod4.z.coerce.number().optional().describe("X position (default: 0)"),
+            y: import_zod4.z.coerce.number().optional().describe("Y position (default: 0)"),
+            width: import_zod4.z.coerce.number().optional().describe("Width (default: 100)"),
+            height: import_zod4.z.coerce.number().optional().describe("Height (default: 100)"),
+            rotation: import_zod4.z.coerce.number().optional().describe("Rotation in degrees (0-360)"),
+            opacity: token.optional().describe("Opacity (0-1) or variable name"),
+            visible: flexBool(import_zod4.z.boolean()).optional().describe("Show/hide (default true)"),
+            locked: flexBool(import_zod4.z.boolean()).optional().describe("Lock/unlock (default false)"),
+            blendMode: import_zod4.z.enum(["PASS_THROUGH", "NORMAL", "DARKEN", "MULTIPLY", "LINEAR_BURN", "COLOR_BURN", "LIGHTEN", "SCREEN", "LINEAR_DODGE", "COLOR_DODGE", "OVERLAY", "SOFT_LIGHT", "HARD_LIGHT", "DIFFERENCE", "EXCLUSION", "HUE", "SATURATION", "COLOR", "LUMINOSITY"]).optional(),
+            layoutPositioning: import_zod4.z.enum(["AUTO", "ABSOLUTE"]).optional().describe("ABSOLUTE = floating inside auto-layout parent"),
+            fills: import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown())).optional().describe("Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent. Primary way to set fills."),
+            fillColor: colorRgba.optional().describe("Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)"),
+            fillStyleName: import_zod4.z.string().optional().describe("Paint style name for fill"),
+            fillVariableName: import_zod4.z.string().optional().describe("Color variable by name e.g. 'bg/primary'"),
+            strokes: import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown())).optional().describe("Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear. Primary way to set strokes."),
+            strokeColor: colorRgba.optional().describe("Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)"),
+            strokeStyleName: import_zod4.z.string().optional().describe("Paint style name for stroke"),
+            strokeVariableName: import_zod4.z.string().optional().describe("Color variable by name for stroke"),
+            strokeWeight: token.optional().describe("All sides (number) or variable name (string). Per-side: strokeTopWeight, strokeBottomWeight, strokeLeftWeight, strokeRightWeight."),
+            strokeTopWeight: token.optional(),
+            strokeBottomWeight: token.optional(),
+            strokeLeftWeight: token.optional(),
+            strokeRightWeight: token.optional(),
+            strokeAlign: import_zod4.z.enum(["INSIDE", "OUTSIDE", "CENTER"]).optional().describe("Stroke position (default: INSIDE)"),
+            strokesIncludedInLayout: flexBool(import_zod4.z.boolean()).optional().describe("Include stroke width in layout measurements (default: false)"),
+            cornerRadius: token.optional().describe("All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius."),
+            topLeftRadius: token.optional(),
+            topRightRadius: token.optional(),
+            bottomRightRadius: token.optional(),
+            bottomLeftRadius: token.optional(),
+            effectStyleName: import_zod4.z.string().optional().describe("Effect style name (e.g. 'Shadow/Card') for shadows, blurs"),
+            layoutMode: import_zod4.z.enum(["NONE", "HORIZONTAL", "VERTICAL"]).optional().describe("Layout direction (default: NONE)"),
+            layoutWrap: import_zod4.z.enum(["NO_WRAP", "WRAP"]).optional(),
+            padding: token.optional().describe("All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft."),
+            paddingTop: token.optional(),
+            paddingRight: token.optional(),
+            paddingBottom: token.optional(),
+            paddingLeft: token.optional(),
+            primaryAxisAlignItems: import_zod4.z.enum(["MIN", "MAX", "CENTER", "SPACE_BETWEEN"]).optional(),
+            counterAxisAlignItems: import_zod4.z.enum(["MIN", "MAX", "CENTER", "BASELINE"]).optional(),
+            layoutSizingHorizontal: import_zod4.z.enum(["FIXED", "HUG", "FILL"]).optional(),
+            layoutSizingVertical: import_zod4.z.enum(["FIXED", "HUG", "FILL"]).optional(),
+            itemSpacing: token.optional().describe("Spacing between children (number or variable name string, default: 0)"),
+            counterAxisSpacing: token.optional().describe("Gap between wrapped rows (requires layoutWrap: WRAP)"),
+            minWidth: import_zod4.z.coerce.number().optional().describe("Min width for responsive auto-layout"),
+            maxWidth: import_zod4.z.coerce.number().optional().describe("Max width for responsive auto-layout"),
+            minHeight: import_zod4.z.coerce.number().optional().describe("Min height for responsive auto-layout"),
+            maxHeight: import_zod4.z.coerce.number().optional().describe("Max height for responsive auto-layout"),
+            overflowDirection: import_zod4.z.enum(["NONE", "HORIZONTAL", "VERTICAL", "BOTH"]).optional().describe("Scroll overflow in prototype (default: NONE)"),
+            componentIds: flexJson(import_zod4.z.array(import_zod4.z.string())).describe("Component IDs to combine (min 2)"),
+            variantPropertyName: import_zod4.z.string().optional().describe("Rename the auto-generated variant property (default: 'Property 1')")
+          }).passthrough()
+        };
+        const s = params.type && schemas[params.type];
+        if (s) {
+          try {
+            params.items = import_zod4.z.array(s).parse(params.items);
+          } catch (e) {
+            if (e instanceof import_zod4.z.ZodError) {
+              throw new Error(e.issues.map((i) => {
+                const path = i.path.join(".");
+                const shape = s instanceof import_zod4.z.ZodObject ? s.shape : null;
+                const desc = shape?.[i.path[1]]?.description;
+                return path + ": " + i.message + (desc ? " (expected: " + desc + ")" : "");
+              }).join("; "));
+            }
+            throw e;
+          }
+        }
+      }
+      if (m === "update") {
+        const itemSchema = import_zod4.z.object({
+          id: import_zod4.z.string().describe("Component or component set ID"),
+          propertyName: import_zod4.z.string().describe('Property name with #suffix for edit/delete (e.g. "Label#1:0"). Call components.get to find exact keys. For add, plain name works.'),
+          action: import_zod4.z.enum(["add", "edit", "delete", "rename_variant"]).optional().describe('"add" (default): requires type + defaultValue. "edit": pass defaultValue to change default, name to rename property. "delete": just propertyName. "rename_variant": pass defaultValue=current option name, name=new option name.'),
+          type: import_zod4.z.enum(["BOOLEAN", "TEXT", "INSTANCE_SWAP", "VARIANT"]).optional().describe("Property type (required for add)"),
+          defaultValue: stringOrBoolean.optional().describe("Default value (add/edit). For rename_variant: the CURRENT option name to rename"),
+          name: import_zod4.z.string().optional().describe("New name \u2014 for edit: renames the property itself, for rename_variant: the new option value name"),
+          preferredValues: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).optional().describe("Preferred values for INSTANCE_SWAP")
+        }).passthrough();
+        try {
+          params.items = import_zod4.z.array(itemSchema).parse(params.items);
+        } catch (e) {
+          if (e instanceof import_zod4.z.ZodError) {
+            throw new Error(e.issues.map((i) => {
+              const path = i.path.join(".");
+              const shape = itemSchema instanceof import_zod4.z.ZodObject ? itemSchema.shape : null;
+              const desc = shape?.[i.path[1]]?.description;
+              return path + ": " + i.message + (desc ? " (expected: " + desc + ")" : "");
+            }).join("; "));
+          }
+          throw e;
+        }
+      }
+    },
+    commandMap: { "clone": "components.clone", "audit": "components.audit", "reparent": "components.reparent", "list": "components.list", "get": "components.get", "create": "components.create", "update": "components.update", "delete": "components.delete" }
   },
   {
-    name: "create_node_from_svg",
-    description: "Create nodes from SVG strings.",
-    schema: { items: flexJson(import_zod6.z.array(svgItem)).describe("Array of SVG items to create"), depth },
-    tier: "create"
-  }
-];
-
-// src/tools/defs/create-frame.ts
-var import_zod7 = require("zod");
-var frameItem = import_zod7.z.object({
-  name: import_zod7.z.string().optional().describe("Frame name (default: 'Frame')"),
-  x: xPos,
-  y: yPos,
-  width: import_zod7.z.coerce.number().optional().describe("Width (default: 100)"),
-  height: import_zod7.z.coerce.number().optional().describe("Height (default: 100)"),
-  parentId,
-  fillColor: flexJson(colorRgba).optional().describe("Fill color. Default: no fill."),
-  strokeColor: flexJson(colorRgba).optional().describe("Stroke color. Default: none."),
-  strokeWeight: import_zod7.z.coerce.number().positive().optional().describe("Stroke weight (default: 1)"),
-  cornerRadius: import_zod7.z.coerce.number().min(0).optional().describe("Corner radius (default: 0)"),
-  layoutMode: import_zod7.z.enum(["NONE", "HORIZONTAL", "VERTICAL"]).optional().describe("Auto-layout direction (default: NONE)"),
-  layoutWrap: import_zod7.z.enum(["NO_WRAP", "WRAP"]).optional().describe("Wrap (default: NO_WRAP)"),
-  paddingTop: import_zod7.z.coerce.number().optional().describe("Top padding (default: 0)"),
-  paddingRight: import_zod7.z.coerce.number().optional().describe("Right padding (default: 0)"),
-  paddingBottom: import_zod7.z.coerce.number().optional().describe("Bottom padding (default: 0)"),
-  paddingLeft: import_zod7.z.coerce.number().optional().describe("Left padding (default: 0)"),
-  primaryAxisAlignItems: import_zod7.z.enum(["MIN", "MAX", "CENTER", "SPACE_BETWEEN"]).optional(),
-  counterAxisAlignItems: import_zod7.z.enum(["MIN", "MAX", "CENTER", "BASELINE"]).optional(),
-  layoutSizingHorizontal: import_zod7.z.enum(["FIXED", "HUG", "FILL"]).optional(),
-  layoutSizingVertical: import_zod7.z.enum(["FIXED", "HUG", "FILL"]).optional(),
-  itemSpacing: import_zod7.z.coerce.number().optional().describe("Spacing between children (default: 0)"),
-  fillStyleName: import_zod7.z.string().optional().describe("Apply a fill paint style by name (case-insensitive). Omit to skip."),
-  strokeStyleName: import_zod7.z.string().optional().describe("Apply a stroke paint style by name. Omit to skip."),
-  fillVariableId: import_zod7.z.string().optional().describe("Bind a color variable to the fill. Creates a solid fill and binds the variable to fills/0/color."),
-  strokeVariableId: import_zod7.z.string().optional().describe("Bind a color variable to the stroke. Creates a solid stroke and binds the variable to strokes/0/color.")
-});
-var autoLayoutItem = import_zod7.z.object({
-  nodeIds: flexJson(import_zod7.z.array(import_zod7.z.string())).describe("Array of node IDs to wrap"),
-  name: import_zod7.z.string().optional().describe("Frame name (default: 'Auto Layout')"),
-  layoutMode: import_zod7.z.enum(["HORIZONTAL", "VERTICAL"]).optional().describe("Direction (default: VERTICAL)"),
-  itemSpacing: import_zod7.z.coerce.number().optional().describe("Spacing between children (default: 0)"),
-  paddingTop: import_zod7.z.coerce.number().optional().describe("Top padding (default: 0)"),
-  paddingRight: import_zod7.z.coerce.number().optional().describe("Right padding (default: 0)"),
-  paddingBottom: import_zod7.z.coerce.number().optional().describe("Bottom padding (default: 0)"),
-  paddingLeft: import_zod7.z.coerce.number().optional().describe("Left padding (default: 0)"),
-  primaryAxisAlignItems: import_zod7.z.enum(["MIN", "MAX", "CENTER", "SPACE_BETWEEN"]).optional(),
-  counterAxisAlignItems: import_zod7.z.enum(["MIN", "MAX", "CENTER", "BASELINE"]).optional(),
-  layoutSizingHorizontal: import_zod7.z.enum(["FIXED", "HUG", "FILL"]).optional(),
-  layoutSizingVertical: import_zod7.z.enum(["FIXED", "HUG", "FILL"]).optional(),
-  layoutWrap: import_zod7.z.enum(["NO_WRAP", "WRAP"]).optional()
-});
-var tools6 = [
-  {
-    name: "create_frame",
-    description: "Create frames in Figma. Batch supported. Use fillStyleName/fillVariableId and strokeStyleName/strokeVariableId instead of hardcoded colors \u2014 hardcoded values skip design tokens and will trigger lint warnings.",
-    schema: { items: flexJson(import_zod7.z.array(frameItem)).describe("Array of frames to create"), depth },
-    tier: "create"
+    name: "connection",
+    description: '/** Manage the Figma plugin connection. Use method "help" for detailed parameter docs. */\n  create    (channel?) \u2192 string  // Join a relay channel (required first step before any other tool)\n  get       () \u2192 { status, documentName, currentPage, timestamp }  // Verify end-to-end connection to Figma\n  list      () \u2192 unknown  // Inspect which clients (MCP, plugin) are connected to each channel\n  delete    (channel?) \u2192 string  // Disconnect all clients (MCP server and Figma plugin) from a channel and reset its state\n// Connection manages the WebSocket link between the MCP server and the Figma plugin.\n// Channels are named rooms \u2014 both the MCP server and Figma plugin must join the same channel to communicate.\n// Workflow: connection(method:"create") to join a channel \u2192 connection(method:"get") to verify Figma plugin is connected.\n// If get times out (5s), the Figma plugin is not running or not on the same channel.\n// list shows all active channels and their connected clients. delete factory-resets a channel.',
+    schema: (caps2) => filterMethodsByTier({
+      method: import_zod4.z.enum(["create", "get", "list", "delete", "help"]),
+      channel: import_zod4.z.string().optional().default("vibma").describe("The channel name displayed in the Figma plugin panel. Defaults to 'vibma' if omitted."),
+      topic: import_zod4.z.string().optional().describe('Help topic \u2014 method name for endpoint help, e.g. "create"')
+    }, caps2, { "create": "read", "get": "read", "list": "read", "delete": "edit", "help": "read" }),
+    tier: "read",
+    timeout: 5e3,
+    commandMap: { "create": "connection.create", "get": "connection.get", "list": "connection.list", "delete": "connection.delete" }
   },
   {
-    name: "create_auto_layout",
-    description: "Wrap existing nodes in an auto-layout frame. One call replaces create_frame + update_frame + insert_child \xD7 N.",
-    schema: { items: flexJson(import_zod7.z.array(autoLayoutItem)).describe("Array of auto-layout wraps to perform"), depth },
-    tier: "create"
-  }
-];
-
-// src/tools/defs/create-text.ts
-var import_zod8 = require("zod");
-var textItem = import_zod8.z.object({
-  text: import_zod8.z.string().describe("Text content"),
-  name: import_zod8.z.string().optional().describe("Layer name (default: text content)"),
-  x: xPos,
-  y: yPos,
-  fontFamily: import_zod8.z.string().optional().describe("Font family (default: Inter). Use get_available_fonts to list installed fonts."),
-  fontStyle: import_zod8.z.string().optional().describe("Font style, e.g. 'Regular', 'Bold', 'Italic' (default: derived from fontWeight). Overrides fontWeight when set."),
-  fontSize: import_zod8.z.coerce.number().optional().describe("Font size (default: 14)"),
-  fontWeight: import_zod8.z.coerce.number().optional().describe("Font weight: 100-900 (default: 400). Ignored when fontStyle is set."),
-  fontColor: flexJson(colorRgba).optional().describe("Font color. Default: black."),
-  fontColorVariableId: import_zod8.z.string().optional().describe("Bind a color variable to the text fill instead of hardcoded fontColor."),
-  fontColorStyleName: import_zod8.z.string().optional().describe("Apply a paint style to the text fill by name (case-insensitive). Overrides fontColor."),
-  parentId,
-  textStyleId: import_zod8.z.string().optional().describe("Text style ID to apply (overrides fontSize/fontWeight). Omit to skip."),
-  textStyleName: import_zod8.z.string().optional().describe("Text style name (case-insensitive match). Omit to skip."),
-  textAlignHorizontal: import_zod8.z.enum(["LEFT", "CENTER", "RIGHT", "JUSTIFIED"]).optional().describe("Horizontal text alignment (default: LEFT)"),
-  textAlignVertical: import_zod8.z.enum(["TOP", "CENTER", "BOTTOM"]).optional().describe("Vertical text alignment (default: TOP)"),
-  layoutSizingHorizontal: import_zod8.z.enum(["FIXED", "HUG", "FILL"]).optional().describe("Horizontal sizing. FILL auto-sets textAutoResize to HEIGHT."),
-  layoutSizingVertical: import_zod8.z.enum(["FIXED", "HUG", "FILL"]).optional().describe("Vertical sizing (default: HUG)"),
-  textAutoResize: import_zod8.z.enum(["NONE", "WIDTH_AND_HEIGHT", "HEIGHT", "TRUNCATE"]).optional().describe("Text auto-resize behavior (default: WIDTH_AND_HEIGHT when FILL)")
-});
-var tools7 = [
-  {
-    name: "create_text",
-    description: "Create text nodes. Prefer textStyleName for typography and fontColorStyleName or fontColorVariableId for color \u2014 hardcoded values skip design tokens. Supports custom fonts via fontFamily.",
-    schema: { items: flexJson(import_zod8.z.array(textItem)).describe("Array of text nodes to create"), depth },
-    tier: "create"
-  }
-];
-
-// src/tools/defs/modify-node.ts
-var import_zod9 = require("zod");
-var deleteItem = import_zod9.z.object({
-  nodeId: import_zod9.z.string().describe("Node ID to delete")
-});
-var cloneItem = import_zod9.z.object({
-  nodeId: import_zod9.z.string().describe("Node ID to clone"),
-  parentId: import_zod9.z.string().optional().describe("Parent for the clone (e.g. a page ID). Defaults to same parent as original."),
-  x: import_zod9.z.coerce.number().optional().describe("New X for clone. Omit to keep original position."),
-  y: import_zod9.z.coerce.number().optional().describe("New Y for clone. Omit to keep original position.")
-});
-var insertItem = import_zod9.z.object({
-  parentId: import_zod9.z.string().describe("Parent node ID"),
-  childId: import_zod9.z.string().describe("Child node ID to move"),
-  index: import_zod9.z.coerce.number().optional().describe("Index to insert at (0=first). Omit to append.")
-});
-var tools8 = [
-  {
-    name: "delete_node",
-    description: "Delete nodes. Batch: pass multiple items.",
-    schema: { items: flexJson(import_zod9.z.array(deleteItem)).describe("Array of {nodeId}") },
-    tier: "edit"
+    name: "document",
+    description: '/** Navigate and manage Figma pages (canvases) in the document. Use method "help" for detailed parameter docs. */\n  get       () \u2192 { id, name, backgroundColor?, children: NodeStub[] }  // Get current page with top-level children\n  list      () \u2192 { name, currentPageId, pages }  // Get document name and list all pages\n  set       (pageId?, pageName?) \u2192 { id, name }  // Switch to a page by ID or name. At least one of pageId or pageName must be provided.\n  create    (name?) \u2192 { id }  // Create a new page\n  update    (newName, pageId?) \u2192 string  // Rename a page\n// A Figma document contains pages \u2014 each page is an independent canvas with its own node tree.\n// The "current page" is where all node operations happen. Use document.set to switch pages before working with nodes.\n// Page IDs look like "0:1", "1:1", etc. The first page is always "0:1".\n// get returns the current page with its top-level children as stubs. list returns all pages in the document.\n// Shared types:\n// NodeStub: {id: string, name: string, type: string}',
+    schema: (caps2) => filterMethodsByTier({
+      method: import_zod4.z.enum(["get", "list", "set", "create", "update", "help"]),
+      pageId: import_zod4.z.string().optional().describe("Page ID"),
+      pageName: import_zod4.z.string().optional().describe("Page name (case-insensitive, substring match)"),
+      name: import_zod4.z.string().optional().describe("Page name (default: 'New Page')"),
+      newName: import_zod4.z.string().optional().describe("New page name"),
+      topic: import_zod4.z.string().optional().describe('Help topic \u2014 method name for endpoint help, e.g. "create"')
+    }, caps2, { "get": "read", "list": "read", "set": "read", "create": "create", "update": "edit", "help": "read" }),
+    tier: "read",
+    validate: (params) => {
+      const m = params.method;
+      if (m === "update") {
+        if (params.newName === void 0) throw new Error('update requires "newName"');
+      }
+    },
+    commandMap: { "get": "document.get", "list": "document.list", "set": "document.set", "create": "document.create", "update": "document.update" }
   },
   {
-    name: "clone_node",
-    description: "Clone nodes. Batch: pass multiple items.",
-    schema: { items: flexJson(import_zod9.z.array(cloneItem)).describe("Array of {nodeId, x?, y?}"), depth },
-    tier: "create"
+    name: "fonts",
+    description: '/** Search available fonts in Figma. Use method "help" for detailed parameter docs. */\n  list      (query?, includeStyles?, offset?, limit?) \u2192 { count, fonts }  // List available font families, optionally filtered by name\n// Returns font family names installed in the Figma environment. Use to verify a fontFamily before text.create or styles.create.\n// query filters by family name substring (case-insensitive), e.g. query:"inter" matches "Inter", "Inter Tight".',
+    schema: (caps2) => filterMethodsByTier({
+      method: import_zod4.z.enum(["list", "help"]),
+      query: import_zod4.z.string().optional().describe("Filter by family name (case-insensitive substring)"),
+      includeStyles: flexBool(import_zod4.z.boolean()).optional().describe("Include available styles per family (default: false)"),
+      offset: import_zod4.z.coerce.number().optional().default(0).describe("Skip N items for pagination (default 0)"),
+      limit: import_zod4.z.coerce.number().optional().default(100).describe("Max items per page (default 100)"),
+      topic: import_zod4.z.string().optional().describe('Help topic \u2014 method name for endpoint help, e.g. "create"')
+    }, caps2, { "list": "read", "help": "read" }),
+    tier: "read",
+    commandMap: { "list": "fonts.list" }
   },
   {
-    name: "insert_child",
-    description: "Move nodes into a parent at a specific index (reorder/reparent). Batch: pass multiple items.",
-    schema: { items: flexJson(import_zod9.z.array(insertItem)).describe("Array of {parentId, childId, index?}"), depth },
-    tier: "edit"
-  }
-];
-
-// src/tools/defs/patch-nodes.ts
-var import_zod10 = require("zod");
-var exportSettingEntry = import_zod10.z.object({
-  format: import_zod10.z.enum(["PNG", "JPG", "SVG", "PDF"]),
-  suffix: import_zod10.z.string().optional(),
-  contentsOnly: flexBool(import_zod10.z.boolean()).optional(),
-  constraint: flexJson(import_zod10.z.object({
-    type: import_zod10.z.enum(["SCALE", "WIDTH", "HEIGHT"]),
-    value: import_zod10.z.coerce.number()
-  })).optional()
-});
-var patchNodeItem = import_zod10.z.object({
-  nodeId,
-  // Geometry (flat)
-  x: import_zod10.z.coerce.number().optional().describe("X position"),
-  y: import_zod10.z.coerce.number().optional().describe("Y position"),
-  width: import_zod10.z.coerce.number().positive().optional().describe("Width (must provide height too)"),
-  height: import_zod10.z.coerce.number().positive().optional().describe("Height (must provide width too)"),
-  // Appearance (nested)
-  fill: flexJson(import_zod10.z.object({
-    color: flexJson(colorRgba).optional(),
-    styleName: import_zod10.z.string().optional().describe("Paint style name (preferred over color)"),
-    clear: flexBool(import_zod10.z.boolean()).optional().describe("Set true to remove all fills")
-  })).optional().describe("Fill color, style, or clear"),
-  stroke: flexJson(import_zod10.z.object({
-    color: flexJson(colorRgba).optional(),
-    weight: import_zod10.z.coerce.number().positive().optional().describe("Stroke weight"),
-    styleName: import_zod10.z.string().optional().describe("Paint style name (preferred over color)")
-  })).optional().describe("Stroke color/weight or style"),
-  cornerRadius: flexJson(import_zod10.z.object({
-    radius: import_zod10.z.coerce.number().min(0).describe("Corner radius"),
-    corners: flexJson(import_zod10.z.array(flexBool(import_zod10.z.boolean())).length(4)).optional().describe("Which corners [topLeft, topRight, bottomRight, bottomLeft]. Default: all.")
-  })).optional().describe("Corner radius"),
-  opacity: import_zod10.z.coerce.number().min(0).max(1).optional().describe("Opacity (0-1)"),
-  effects: flexJson(import_zod10.z.object({
-    effects: flexJson(import_zod10.z.array(effectEntry)).optional().describe("Effect objects"),
-    styleName: import_zod10.z.string().optional().describe("Effect style name (preferred over raw effects)")
-  })).optional().describe("Effects or effect style"),
-  constraints: flexJson(import_zod10.z.object({
-    horizontal: import_zod10.z.enum(["MIN", "CENTER", "MAX", "STRETCH", "SCALE"]),
-    vertical: import_zod10.z.enum(["MIN", "CENTER", "MAX", "STRETCH", "SCALE"])
-  })).optional().describe("Layout constraints"),
-  exportSettings: flexJson(import_zod10.z.array(exportSettingEntry)).optional().describe("Export settings"),
-  // Layout (nested)
-  layout: flexJson(import_zod10.z.object({
-    layoutMode: import_zod10.z.enum(["NONE", "HORIZONTAL", "VERTICAL"]).optional(),
-    layoutWrap: import_zod10.z.enum(["NO_WRAP", "WRAP"]).optional(),
-    paddingTop: import_zod10.z.coerce.number().optional(),
-    paddingRight: import_zod10.z.coerce.number().optional(),
-    paddingBottom: import_zod10.z.coerce.number().optional(),
-    paddingLeft: import_zod10.z.coerce.number().optional(),
-    primaryAxisAlignItems: import_zod10.z.enum(["MIN", "MAX", "CENTER", "SPACE_BETWEEN"]).optional(),
-    counterAxisAlignItems: import_zod10.z.enum(["MIN", "MAX", "CENTER", "BASELINE"]).optional(),
-    layoutSizingHorizontal: import_zod10.z.enum(["FIXED", "HUG", "FILL"]).optional(),
-    layoutSizingVertical: import_zod10.z.enum(["FIXED", "HUG", "FILL"]).optional(),
-    itemSpacing: import_zod10.z.coerce.number().optional(),
-    counterAxisSpacing: import_zod10.z.coerce.number().optional()
-  })).optional().describe("Auto-layout properties"),
-  // Text (nested)
-  text: flexJson(import_zod10.z.object({
-    fontSize: import_zod10.z.coerce.number().optional(),
-    fontWeight: import_zod10.z.coerce.number().optional(),
-    fontColor: flexJson(colorRgba).optional(),
-    textStyleId: import_zod10.z.string().optional(),
-    textStyleName: import_zod10.z.string().optional(),
-    textAlignHorizontal: import_zod10.z.enum(["LEFT", "CENTER", "RIGHT", "JUSTIFIED"]).optional(),
-    textAlignVertical: import_zod10.z.enum(["TOP", "CENTER", "BOTTOM"]).optional(),
-    textAutoResize: import_zod10.z.enum(["NONE", "WIDTH_AND_HEIGHT", "HEIGHT", "TRUNCATE"]).optional(),
-    layoutSizingHorizontal: import_zod10.z.enum(["FIXED", "HUG", "FILL"]).optional(),
-    layoutSizingVertical: import_zod10.z.enum(["FIXED", "HUG", "FILL"]).optional()
-  })).optional().describe("Text properties (font, alignment, sizing)"),
-  // Escape hatch
-  properties: flexJson(import_zod10.z.record(import_zod10.z.string(), import_zod10.z.unknown())).optional().describe("Arbitrary key-value properties to set directly on the node")
-});
-var tools9 = [
-  {
-    name: "patch_nodes",
-    description: "Patch properties on nodes. Combines geometry (x/y/width/height), appearance (fill, stroke, cornerRadius, opacity, effects, constraints, exportSettings), layout (auto-layout), text (font props), and arbitrary properties in one call. Prefer styleName over hardcoded colors. Batch: pass multiple items.",
-    schema: { items: flexJson(import_zod10.z.array(patchNodeItem)).describe("Array of nodes to patch"), depth },
-    tier: "edit"
-  }
-];
-
-// src/tools/defs/text.ts
-var import_zod11 = require("zod");
-var textContentItem = import_zod11.z.object({
-  nodeId: import_zod11.z.string().describe("Text node ID"),
-  text: import_zod11.z.string().describe("New text content")
-});
-var scanTextItem = import_zod11.z.object({
-  nodeId,
-  limit: import_zod11.z.coerce.number().optional().describe("Max text nodes to return (default: 50)"),
-  includePath: flexBool(import_zod11.z.boolean()).optional().describe("Include ancestor path strings (default: true). Set false to reduce payload."),
-  includeGeometry: flexBool(import_zod11.z.boolean()).optional().describe("Include absoluteX/absoluteY/width/height (default: true). Set false to reduce payload.")
-});
-var tools10 = [
-  {
-    name: "set_text_content",
-    description: "Set text content on text nodes. Batch: pass multiple items to replace text in multiple nodes at once.",
-    schema: { items: flexJson(import_zod11.z.array(textContentItem)).describe("Array of {nodeId, text}"), depth },
-    tier: "edit"
+    name: "frames",
+    description: '/** Create and manage frames, shapes, auto-layout containers, sections, and SVG nodes. Use method "help" for detailed parameter docs. */\n  get       (id, fields?, depth?, verbose?) \u2192 { results: Node[], _truncated?, _notice? }  // Get serialized node data\n  list      (query?, types?, parentId?, fields?, offset?, limit?) \u2192 { totalCount, returned?, offset?, limit?, results }  // Search for nodes (returns stubs only \u2014 use get with depth for full properties)\n  update    (items: PatchItem[]) \u2192 { results: ("ok" | {error})[] }  // Patch node properties\n  delete    (id?, items?: { id?: string }[]) \u2192 { results: "ok"[] }  // Delete nodes\n  clone     (id, parentId?, x?, y?, depth?) \u2192 { results: {id}[] }  // Duplicate nodes\n  audit     (id, rules?, maxDepth?, maxFindings?) \u2192 { nodeId?, nodeName?, categories? }  // Run lint on a node \u2014 returns severity-ranked findings\n  reparent  (items: { id: string; parentId: string; index?: number }[]) \u2192 { results: "ok"[] }  // Move nodes into a new parent\n  create    (type: frame|auto_layout|section|rectangle|ellipse|line|group|boolean_operation|svg, items: (FrameItem | AutoLayoutItem | SectionItem | RectangleItem | EllipseItem | LineItem | GroupItem | BooleanOperationItem | SvgItem)[]) \u2192 { results: {id}[] }  // Create frame-like containers\n  export    (id, format?: PNG|JPG|SVG|SVG_STRING|PDF, scale?) \u2192 { imageData?, mimeType? }  // Export a node as PNG, JPG, SVG, SVG_STRING, or PDF\n// depth: omit \u2192 id+name stubs | 0 \u2192 props + child stubs | N \u2192 recurse N | -1 \u2192 full tree\n// fields: whitelist e.g. ["fills","opacity"] \u2014 id, name, type always included. Pass ["*"] for all.\n// layoutSizingHorizontal/Vertical: FIXED | HUG | FILL \u2014 how the node sizes within auto-layout.\n// Colors: fillVariableName/strokeVariableName bind by name \u2014 preferred over raw color values.\n// Note: node-based endpoints (frames, text, instances, components) use `results` as the list key.\n//   Standalone endpoints (styles, variables, variable_collections) use `items`. Components.list uses `items` (catalog view).',
+    schema: (caps2) => filterMethodsByTier({
+      method: import_zod4.z.enum(["get", "list", "update", "delete", "clone", "audit", "reparent", "create", "export", "help"]),
+      id: import_zod4.z.string().optional().describe("Node ID"),
+      fields: flexJson(import_zod4.z.array(import_zod4.z.string())).optional().describe('Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.'),
+      depth: import_zod4.z.coerce.number().optional().describe("Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited."),
+      verbose: import_zod4.z.boolean().optional().describe("Include all properties (bounding box, constraints, text style details). Default false \u2014 returns slim, actionable output."),
+      query: import_zod4.z.string().optional().describe("Name search query (case-insensitive substring match)"),
+      types: flexJson(import_zod4.z.array(import_zod4.z.string())).optional().describe('Filter by node types (e.g. ["FRAME", "TEXT"])'),
+      parentId: import_zod4.z.string().optional().describe("Search only within this subtree"),
+      offset: import_zod4.z.coerce.number().optional().default(0).describe("Skip N items for pagination (default 0)"),
+      limit: import_zod4.z.coerce.number().optional().default(100).describe("Max items per page (default 100)"),
+      items: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).optional().describe("Array of {id, ...properties} to update/delete/reparent"),
+      x: import_zod4.z.coerce.number().optional().describe("X position (default: 0)"),
+      y: import_zod4.z.coerce.number().optional().describe("Y position (default: 0)"),
+      rules: flexJson(import_zod4.z.array(import_zod4.z.string())).optional().describe('Rules to check. Default: ["all"]. Categories: "component", "composition", "token", "naming", "wcag".'),
+      maxDepth: import_zod4.z.coerce.number().optional().describe("Max tree depth (default: 10)"),
+      maxFindings: import_zod4.z.coerce.number().optional().describe("Max findings (default: 50)"),
+      type: import_zod4.z.enum(["frame", "auto_layout", "section", "rectangle", "ellipse", "line", "group", "boolean_operation", "svg"]).optional().describe("Discriminant for create method"),
+      format: import_zod4.z.enum(["PNG", "JPG", "SVG", "SVG_STRING", "PDF"]).optional().describe("Export format (default: PNG). SVG_STRING returns raw SVG text."),
+      scale: import_zod4.z.coerce.number().optional().describe("Export scale (default: 1, only for PNG/JPG)"),
+      topic: import_zod4.z.string().optional().describe('Help topic \u2014 method name for endpoint help, e.g. "create"')
+    }, caps2, { "get": "read", "list": "read", "update": "edit", "delete": "edit", "clone": "create", "audit": "read", "reparent": "edit", "create": "create", "export": "read", "help": "read" }),
+    tier: "read",
+    validate: (params) => {
+      const m = params.method;
+      if (m === "export") {
+        if (params.id === void 0) throw new Error('export requires "id"');
+      }
+      if (!params.items) return;
+      if (m === "create") {
+        const schemas = {
+          "frame": import_zod4.z.object({
+            name: import_zod4.z.string().optional().describe("Node name"),
+            parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place on current page."),
+            x: import_zod4.z.coerce.number().optional().describe("X position (default: 0)"),
+            y: import_zod4.z.coerce.number().optional().describe("Y position (default: 0)"),
+            width: import_zod4.z.coerce.number().optional().describe("Width (default: 100)"),
+            height: import_zod4.z.coerce.number().optional().describe("Height (default: 100)"),
+            rotation: import_zod4.z.coerce.number().optional().describe("Rotation in degrees (0-360)"),
+            opacity: token.optional().describe("Opacity (0-1) or variable name"),
+            visible: flexBool(import_zod4.z.boolean()).optional().describe("Show/hide (default true)"),
+            locked: flexBool(import_zod4.z.boolean()).optional().describe("Lock/unlock (default false)"),
+            blendMode: import_zod4.z.enum(["PASS_THROUGH", "NORMAL", "DARKEN", "MULTIPLY", "LINEAR_BURN", "COLOR_BURN", "LIGHTEN", "SCREEN", "LINEAR_DODGE", "COLOR_DODGE", "OVERLAY", "SOFT_LIGHT", "HARD_LIGHT", "DIFFERENCE", "EXCLUSION", "HUE", "SATURATION", "COLOR", "LUMINOSITY"]).optional(),
+            layoutPositioning: import_zod4.z.enum(["AUTO", "ABSOLUTE"]).optional().describe("ABSOLUTE = floating inside auto-layout parent"),
+            fills: import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown())).optional().describe("Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent. Primary way to set fills."),
+            fillColor: colorRgba.optional().describe("Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)"),
+            fillStyleName: import_zod4.z.string().optional().describe("Paint style name for fill"),
+            fillVariableName: import_zod4.z.string().optional().describe("Color variable by name e.g. 'bg/primary'"),
+            strokes: import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown())).optional().describe("Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear. Primary way to set strokes."),
+            strokeColor: colorRgba.optional().describe("Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)"),
+            strokeStyleName: import_zod4.z.string().optional().describe("Paint style name for stroke"),
+            strokeVariableName: import_zod4.z.string().optional().describe("Color variable by name for stroke"),
+            strokeWeight: token.optional().describe("All sides (number) or variable name (string). Per-side: strokeTopWeight, strokeBottomWeight, strokeLeftWeight, strokeRightWeight."),
+            strokeTopWeight: token.optional(),
+            strokeBottomWeight: token.optional(),
+            strokeLeftWeight: token.optional(),
+            strokeRightWeight: token.optional(),
+            strokeAlign: import_zod4.z.enum(["INSIDE", "OUTSIDE", "CENTER"]).optional().describe("Stroke position (default: INSIDE)"),
+            strokesIncludedInLayout: flexBool(import_zod4.z.boolean()).optional().describe("Include stroke width in layout measurements (default: false)"),
+            cornerRadius: token.optional().describe("All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius."),
+            topLeftRadius: token.optional(),
+            topRightRadius: token.optional(),
+            bottomRightRadius: token.optional(),
+            bottomLeftRadius: token.optional(),
+            effectStyleName: import_zod4.z.string().optional().describe("Effect style name (e.g. 'Shadow/Card') for shadows, blurs"),
+            layoutMode: import_zod4.z.enum(["NONE", "HORIZONTAL", "VERTICAL"]).optional().describe("Layout direction (default: NONE)"),
+            layoutWrap: import_zod4.z.enum(["NO_WRAP", "WRAP"]).optional(),
+            padding: token.optional().describe("All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft."),
+            paddingTop: token.optional(),
+            paddingRight: token.optional(),
+            paddingBottom: token.optional(),
+            paddingLeft: token.optional(),
+            primaryAxisAlignItems: import_zod4.z.enum(["MIN", "MAX", "CENTER", "SPACE_BETWEEN"]).optional(),
+            counterAxisAlignItems: import_zod4.z.enum(["MIN", "MAX", "CENTER", "BASELINE"]).optional(),
+            layoutSizingHorizontal: import_zod4.z.enum(["FIXED", "HUG", "FILL"]).optional(),
+            layoutSizingVertical: import_zod4.z.enum(["FIXED", "HUG", "FILL"]).optional(),
+            itemSpacing: token.optional().describe("Spacing between children (number or variable name string, default: 0)"),
+            counterAxisSpacing: token.optional().describe("Gap between wrapped rows (requires layoutWrap: WRAP)"),
+            minWidth: import_zod4.z.coerce.number().optional().describe("Min width for responsive auto-layout"),
+            maxWidth: import_zod4.z.coerce.number().optional().describe("Max width for responsive auto-layout"),
+            minHeight: import_zod4.z.coerce.number().optional().describe("Min height for responsive auto-layout"),
+            maxHeight: import_zod4.z.coerce.number().optional().describe("Max height for responsive auto-layout"),
+            overflowDirection: import_zod4.z.enum(["NONE", "HORIZONTAL", "VERTICAL", "BOTH"]).optional().describe("Scroll overflow in prototype (default: NONE)"),
+            clipsContent: flexBool(import_zod4.z.boolean()).optional()
+          }).passthrough(),
+          "auto_layout": import_zod4.z.object({
+            name: import_zod4.z.string().optional().describe("Node name"),
+            parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place on current page."),
+            x: import_zod4.z.coerce.number().optional().describe("X position (default: 0)"),
+            y: import_zod4.z.coerce.number().optional().describe("Y position (default: 0)"),
+            width: import_zod4.z.coerce.number().optional().describe("Width (default: 100)"),
+            height: import_zod4.z.coerce.number().optional().describe("Height (default: 100)"),
+            rotation: import_zod4.z.coerce.number().optional().describe("Rotation in degrees (0-360)"),
+            opacity: token.optional().describe("Opacity (0-1) or variable name"),
+            visible: flexBool(import_zod4.z.boolean()).optional().describe("Show/hide (default true)"),
+            locked: flexBool(import_zod4.z.boolean()).optional().describe("Lock/unlock (default false)"),
+            blendMode: import_zod4.z.enum(["PASS_THROUGH", "NORMAL", "DARKEN", "MULTIPLY", "LINEAR_BURN", "COLOR_BURN", "LIGHTEN", "SCREEN", "LINEAR_DODGE", "COLOR_DODGE", "OVERLAY", "SOFT_LIGHT", "HARD_LIGHT", "DIFFERENCE", "EXCLUSION", "HUE", "SATURATION", "COLOR", "LUMINOSITY"]).optional(),
+            layoutPositioning: import_zod4.z.enum(["AUTO", "ABSOLUTE"]).optional().describe("ABSOLUTE = floating inside auto-layout parent"),
+            fills: import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown())).optional().describe("Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent. Primary way to set fills."),
+            fillColor: colorRgba.optional().describe("Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)"),
+            fillStyleName: import_zod4.z.string().optional().describe("Paint style name for fill"),
+            fillVariableName: import_zod4.z.string().optional().describe("Color variable by name e.g. 'bg/primary'"),
+            strokes: import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown())).optional().describe("Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear. Primary way to set strokes."),
+            strokeColor: colorRgba.optional().describe("Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)"),
+            strokeStyleName: import_zod4.z.string().optional().describe("Paint style name for stroke"),
+            strokeVariableName: import_zod4.z.string().optional().describe("Color variable by name for stroke"),
+            strokeWeight: token.optional().describe("All sides (number) or variable name (string). Per-side: strokeTopWeight, strokeBottomWeight, strokeLeftWeight, strokeRightWeight."),
+            strokeTopWeight: token.optional(),
+            strokeBottomWeight: token.optional(),
+            strokeLeftWeight: token.optional(),
+            strokeRightWeight: token.optional(),
+            strokeAlign: import_zod4.z.enum(["INSIDE", "OUTSIDE", "CENTER"]).optional().describe("Stroke position (default: INSIDE)"),
+            strokesIncludedInLayout: flexBool(import_zod4.z.boolean()).optional().describe("Include stroke width in layout measurements (default: false)"),
+            cornerRadius: token.optional().describe("All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius."),
+            topLeftRadius: token.optional(),
+            topRightRadius: token.optional(),
+            bottomRightRadius: token.optional(),
+            bottomLeftRadius: token.optional(),
+            effectStyleName: import_zod4.z.string().optional().describe("Effect style name (e.g. 'Shadow/Card') for shadows, blurs"),
+            layoutMode: import_zod4.z.enum(["HORIZONTAL", "VERTICAL"]).describe("Primary axis direction"),
+            layoutWrap: import_zod4.z.enum(["NO_WRAP", "WRAP"]).optional(),
+            padding: token.optional().describe("All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft."),
+            paddingTop: token.optional(),
+            paddingRight: token.optional(),
+            paddingBottom: token.optional(),
+            paddingLeft: token.optional(),
+            primaryAxisAlignItems: import_zod4.z.enum(["MIN", "MAX", "CENTER", "SPACE_BETWEEN"]).optional(),
+            counterAxisAlignItems: import_zod4.z.enum(["MIN", "MAX", "CENTER", "BASELINE"]).optional(),
+            layoutSizingHorizontal: import_zod4.z.enum(["FIXED", "HUG", "FILL"]).optional(),
+            layoutSizingVertical: import_zod4.z.enum(["FIXED", "HUG", "FILL"]).optional(),
+            itemSpacing: token.optional().describe("Spacing between children (number or variable name string, default: 0)"),
+            counterAxisSpacing: token.optional().describe("Gap between wrapped rows (requires layoutWrap: WRAP)"),
+            minWidth: import_zod4.z.coerce.number().optional().describe("Min width for responsive auto-layout"),
+            maxWidth: import_zod4.z.coerce.number().optional().describe("Max width for responsive auto-layout"),
+            minHeight: import_zod4.z.coerce.number().optional().describe("Min height for responsive auto-layout"),
+            maxHeight: import_zod4.z.coerce.number().optional().describe("Max height for responsive auto-layout"),
+            overflowDirection: import_zod4.z.enum(["NONE", "HORIZONTAL", "VERTICAL", "BOTH"]).optional().describe("Scroll overflow in prototype (default: NONE)"),
+            clipsContent: flexBool(import_zod4.z.boolean()).optional(),
+            nodeIds: flexJson(import_zod4.z.array(import_zod4.z.string())).optional().describe("Existing node IDs to wrap into auto-layout")
+          }).passthrough(),
+          "section": import_zod4.z.object({
+            name: import_zod4.z.string().describe("Section name"),
+            parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place on current page."),
+            x: import_zod4.z.coerce.number().optional().describe("X position (default: 0)"),
+            y: import_zod4.z.coerce.number().optional().describe("Y position (default: 0)"),
+            width: import_zod4.z.coerce.number().optional().describe("Width (default: 500)"),
+            height: import_zod4.z.coerce.number().optional().describe("Height (default: 500)"),
+            fills: import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown())).optional().describe("Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent"),
+            fillColor: colorRgba.optional().describe("Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)"),
+            fillStyleName: import_zod4.z.string().optional().describe("Paint style name for fill"),
+            fillVariableName: import_zod4.z.string().optional().describe("Color variable by name e.g. 'bg/primary'")
+          }).passthrough(),
+          "rectangle": import_zod4.z.object({
+            name: import_zod4.z.string().optional().describe("Layer name (default: 'Rectangle')"),
+            parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place on current page."),
+            x: import_zod4.z.coerce.number().optional().describe("X position (default: 0)"),
+            y: import_zod4.z.coerce.number().optional().describe("Y position (default: 0)"),
+            width: import_zod4.z.coerce.number().optional().describe("Width in px (default: 100)"),
+            height: import_zod4.z.coerce.number().optional().describe("Height in px (default: 100)"),
+            fills: import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown())).optional().describe("Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent"),
+            fillColor: colorRgba.optional().describe("Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)"),
+            fillStyleName: import_zod4.z.string().optional().describe("Paint style name for fill"),
+            fillVariableName: import_zod4.z.string().optional().describe("Color variable by name e.g. 'bg/primary'"),
+            strokes: import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown())).optional().describe("Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear"),
+            strokeColor: colorRgba.optional().describe("Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)"),
+            strokeVariableName: import_zod4.z.string().optional().describe("Color variable by name for stroke"),
+            strokeWeight: token.optional(),
+            cornerRadius: token.optional().describe("All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius."),
+            topLeftRadius: token.optional(),
+            topRightRadius: token.optional(),
+            bottomRightRadius: token.optional(),
+            bottomLeftRadius: token.optional(),
+            opacity: token.optional(),
+            layoutSizingHorizontal: import_zod4.z.enum(["FIXED", "FILL"]).optional().describe("Horizontal sizing in auto-layout parent"),
+            layoutSizingVertical: import_zod4.z.enum(["FIXED", "FILL"]).optional().describe("Vertical sizing in auto-layout parent")
+          }).passthrough(),
+          "ellipse": import_zod4.z.object({
+            name: import_zod4.z.string().optional().describe("Layer name (default: 'Ellipse')"),
+            parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place on current page."),
+            x: import_zod4.z.coerce.number().optional().describe("X position (default: 0)"),
+            y: import_zod4.z.coerce.number().optional().describe("Y position (default: 0)"),
+            width: import_zod4.z.coerce.number().optional().describe("Width in px (default: 100)"),
+            height: import_zod4.z.coerce.number().optional().describe("Height in px (default: 100, same as width for circle)"),
+            fills: import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown())).optional().describe("Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent"),
+            fillColor: colorRgba.optional().describe("Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)"),
+            fillStyleName: import_zod4.z.string().optional().describe("Paint style name for fill"),
+            fillVariableName: import_zod4.z.string().optional().describe("Color variable by name e.g. 'bg/primary'"),
+            strokes: import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown())).optional().describe("Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear"),
+            strokeColor: colorRgba.optional().describe("Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)"),
+            strokeVariableName: import_zod4.z.string().optional().describe("Color variable by name for stroke"),
+            strokeWeight: token.optional(),
+            opacity: token.optional(),
+            layoutSizingHorizontal: import_zod4.z.enum(["FIXED", "FILL"]).optional().describe("Horizontal sizing in auto-layout parent"),
+            layoutSizingVertical: import_zod4.z.enum(["FIXED", "FILL"]).optional().describe("Vertical sizing in auto-layout parent")
+          }).passthrough(),
+          "line": import_zod4.z.object({
+            name: import_zod4.z.string().optional().describe("Layer name (default: 'Line')"),
+            parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place on current page."),
+            x: import_zod4.z.coerce.number().optional().describe("X position (default: 0)"),
+            y: import_zod4.z.coerce.number().optional().describe("Y position (default: 0)"),
+            length: import_zod4.z.coerce.number().optional().describe("Line length in px (default: 100)"),
+            rotation: import_zod4.z.coerce.number().optional().describe("Rotation in degrees (default: 0 = horizontal)"),
+            strokes: import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown())).optional().describe("Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear"),
+            strokeColor: colorRgba.optional().describe("Line color (default: black, auto-binds to matching variable/style)"),
+            strokeVariableName: import_zod4.z.string().optional().describe("Color variable by name for stroke"),
+            strokeWeight: token.optional().describe("Line thickness (default: 1)"),
+            opacity: token.optional(),
+            layoutSizingHorizontal: import_zod4.z.enum(["FIXED", "FILL"]).optional().describe("Horizontal sizing in auto-layout parent (defaults to FILL in vertical auto-layout)")
+          }).passthrough(),
+          "group": import_zod4.z.object({
+            nodeIds: import_zod4.z.array(import_zod4.z.string()).describe("Node IDs to group (min 1)"),
+            name: import_zod4.z.string().optional().describe("Group name"),
+            parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place on current page.")
+          }).passthrough(),
+          "boolean_operation": import_zod4.z.object({
+            operation: import_zod4.z.enum(["UNION", "SUBTRACT", "INTERSECT", "EXCLUDE"]).describe("Boolean operation type"),
+            nodeIds: import_zod4.z.array(import_zod4.z.string()).describe("Node IDs to combine (min 2, first node is the base for SUBTRACT)"),
+            name: import_zod4.z.string().optional().describe("Result node name"),
+            parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place on current page.")
+          }).passthrough(),
+          "svg": import_zod4.z.object({
+            svg: import_zod4.z.string().describe("SVG markup string"),
+            name: import_zod4.z.string().optional().describe("Layer name (default: 'SVG')"),
+            parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place on current page."),
+            x: import_zod4.z.coerce.number().optional().describe("X position (default: 0)"),
+            y: import_zod4.z.coerce.number().optional().describe("Y position (default: 0)"),
+            fillStyleName: import_zod4.z.string().optional().describe("Paint style to apply to vector fills"),
+            fillVariableName: import_zod4.z.string().optional().describe("Color variable by name for vector fills"),
+            strokeStyleName: import_zod4.z.string().optional().describe("Paint style to apply to vector strokes"),
+            strokeVariableName: import_zod4.z.string().optional().describe("Color variable by name for vector strokes")
+          }).passthrough()
+        };
+        const s = params.type && schemas[params.type];
+        if (s) {
+          try {
+            params.items = import_zod4.z.array(s).parse(params.items);
+          } catch (e) {
+            if (e instanceof import_zod4.z.ZodError) {
+              throw new Error(e.issues.map((i) => {
+                const path = i.path.join(".");
+                const shape = s instanceof import_zod4.z.ZodObject ? s.shape : null;
+                const desc = shape?.[i.path[1]]?.description;
+                return path + ": " + i.message + (desc ? " (expected: " + desc + ")" : "");
+              }).join("; "));
+            }
+            throw e;
+          }
+        }
+      }
+    },
+    commandMap: { "get": "frames.get", "list": "frames.list", "update": "frames.update", "delete": "frames.delete", "clone": "frames.clone", "audit": "frames.audit", "reparent": "frames.reparent", "create": "frames.create", "export": "frames.export" }
   },
   {
-    name: "scan_text_nodes",
-    description: "Scan all text nodes within a node tree. Batch: pass multiple items.",
-    schema: { items: flexJson(import_zod11.z.array(scanTextItem)).describe("Array of {nodeId}") },
-    tier: "read"
-  }
-];
-
-// src/tools/defs/fonts.ts
-var import_zod12 = require("zod");
-var tools11 = [
+    name: "instances",
+    description: '/** Create and manage component instances. Use method "help" for detailed parameter docs. */\n  list      (query?, types?, parentId?, fields?, offset?, limit?) \u2192 { totalCount, returned?, offset?, limit?, results }  // Search for nodes (returns stubs only \u2014 use get with depth for full properties)\n  delete    (id?, items?: { id?: string }[]) \u2192 { results: "ok"[] }  // Delete nodes\n  clone     (id, parentId?, x?, y?, depth?) \u2192 { results: {id}[] }  // Duplicate nodes\n  audit     (id, rules?, maxDepth?, maxFindings?) \u2192 { nodeId?, nodeName?, categories? }  // Run lint on a node \u2014 returns severity-ranked findings\n  reparent  (items: { id: string; parentId: string; index?: number }[]) \u2192 { results: "ok"[] }  // Move nodes into a new parent\n  get       (id, fields?, depth?, verbose?) \u2192 { results, _truncated? }  // Get instance detail with component properties and overrides\n  create    (items: InstanceCreateItem[], depth?) \u2192 { results: {id}[] }  // Create component instances\n  update    (items: InstanceUpdateItem[]) \u2192 { results: ("ok" | {error})[] }  // Set instance properties\n  swap      (items: { id: string; componentId: string }[]) \u2192 { results: ("ok" | {error})[] }  // Swap instance component (preserves overrides)\n  detach    (items: { id: string }[]) \u2192 { results: {id}[] }  // Detach instances from their component (converts to frame)\n  reset_overrides(items: { id: string }[]) \u2192 { results: ("ok" | {error})[] }  // Reset all overrides on instances to match their main component\n// depth: omit \u2192 id+name stubs | 0 \u2192 props + child stubs | N \u2192 recurse N | -1 \u2192 full tree\n// fields: whitelist e.g. ["fills","opacity"] \u2014 id, name, type always included. Pass ["*"] for all.\n// layoutSizingHorizontal/Vertical: FIXED | HUG | FILL \u2014 how the node sizes within auto-layout.\n// Colors: fillVariableName/strokeVariableName bind by name \u2014 preferred over raw color values.\n// Note: node-based endpoints (frames, text, instances, components) use `results` as the list key.\n//   Standalone endpoints (styles, variables, variable_collections) use `items`. Components.list uses `items` (catalog view).',
+    schema: (caps2) => filterMethodsByTier({
+      method: import_zod4.z.enum(["list", "delete", "clone", "audit", "reparent", "get", "create", "update", "swap", "detach", "reset_overrides", "help"]),
+      query: import_zod4.z.string().optional().describe("Name search query (case-insensitive substring match)"),
+      types: flexJson(import_zod4.z.array(import_zod4.z.string())).optional().describe('Filter by node types (e.g. ["FRAME", "TEXT"])'),
+      parentId: import_zod4.z.string().optional().describe("Search only within this subtree"),
+      fields: flexJson(import_zod4.z.array(import_zod4.z.string())).optional().describe('Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.'),
+      offset: import_zod4.z.coerce.number().optional().default(0).describe("Skip N items for pagination (default 0)"),
+      limit: import_zod4.z.coerce.number().optional().default(100).describe("Max items per page (default 100)"),
+      id: import_zod4.z.string().optional().describe("Single node ID"),
+      items: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).optional().describe("Array of {id, ...properties} to delete/reparent/create/update/swap/detach/reset_overrides"),
+      x: import_zod4.z.coerce.number().optional().describe("X position (default: 0)"),
+      y: import_zod4.z.coerce.number().optional().describe("Y position (default: 0)"),
+      depth: import_zod4.z.coerce.number().optional().describe("Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited."),
+      rules: flexJson(import_zod4.z.array(import_zod4.z.string())).optional().describe('Rules to check. Default: ["all"]. Categories: "component", "composition", "token", "naming", "wcag".'),
+      maxDepth: import_zod4.z.coerce.number().optional().describe("Max tree depth (default: 10)"),
+      maxFindings: import_zod4.z.coerce.number().optional().describe("Max findings (default: 50)"),
+      verbose: import_zod4.z.boolean().optional().describe("Include all properties (bounding box, constraints, text style details). Default false \u2014 returns slim, actionable output."),
+      topic: import_zod4.z.string().optional().describe('Help topic \u2014 method name for endpoint help, e.g. "create"')
+    }, caps2, { "list": "read", "delete": "edit", "clone": "create", "audit": "read", "reparent": "edit", "get": "read", "create": "create", "update": "edit", "swap": "edit", "detach": "edit", "reset_overrides": "edit", "help": "read" }),
+    tier: "read",
+    validate: (params) => {
+      const m = params.method;
+      if (m === "get") {
+        if (params.id === void 0) throw new Error('get requires "id"');
+      }
+      if (!params.items) return;
+      if (m === "create") {
+        for (const it of params.items) {
+          if (it.id !== void 0 && it.componentId === void 0) {
+            it.componentId = it.id;
+            delete it.id;
+          }
+        }
+        const itemSchema = import_zod4.z.object({
+          opacity: token.optional().describe("Opacity (0-1) or variable name"),
+          visible: flexBool(import_zod4.z.boolean()).optional().describe("Show/hide (default true)"),
+          locked: flexBool(import_zod4.z.boolean()).optional().describe("Lock/unlock (default false)"),
+          blendMode: import_zod4.z.enum(["PASS_THROUGH", "NORMAL", "DARKEN", "MULTIPLY", "LINEAR_BURN", "COLOR_BURN", "LIGHTEN", "SCREEN", "LINEAR_DODGE", "COLOR_DODGE", "OVERLAY", "SOFT_LIGHT", "HARD_LIGHT", "DIFFERENCE", "EXCLUSION", "HUE", "SATURATION", "COLOR", "LUMINOSITY"]).optional(),
+          effectStyleName: import_zod4.z.string().optional().describe("Effect style name (e.g. 'Shadow/Card') for shadows, blurs"),
+          layoutSizingHorizontal: import_zod4.z.enum(["FIXED", "HUG", "FILL"]).optional(),
+          layoutSizingVertical: import_zod4.z.enum(["FIXED", "HUG", "FILL"]).optional(),
+          layoutPositioning: import_zod4.z.enum(["AUTO", "ABSOLUTE"]).optional().describe("ABSOLUTE = floating inside auto-layout parent"),
+          minWidth: import_zod4.z.coerce.number().optional().describe("Min width for responsive auto-layout"),
+          maxWidth: import_zod4.z.coerce.number().optional().describe("Max width for responsive auto-layout"),
+          minHeight: import_zod4.z.coerce.number().optional().describe("Min height for responsive auto-layout"),
+          maxHeight: import_zod4.z.coerce.number().optional().describe("Max height for responsive auto-layout"),
+          componentId: import_zod4.z.string().describe("Component or component set ID"),
+          variantProperties: import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()).optional().describe('Pick variant e.g. {"Style":"Secondary"}'),
+          properties: import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()).optional().describe('Set component properties inline e.g. {"Label":"Click me", "ShowIcon":true}. Same as instances.update properties.'),
+          name: import_zod4.z.string().optional().describe("Instance layer name"),
+          x: import_zod4.z.coerce.number().optional(),
+          y: import_zod4.z.coerce.number().optional(),
+          width: import_zod4.z.coerce.number().optional().describe("Override width (resize)"),
+          height: import_zod4.z.coerce.number().optional().describe("Override height (resize)"),
+          parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place on current page.")
+        }).passthrough();
+        try {
+          params.items = import_zod4.z.array(itemSchema).parse(params.items);
+        } catch (e) {
+          if (e instanceof import_zod4.z.ZodError) {
+            throw new Error(e.issues.map((i) => {
+              const path = i.path.join(".");
+              const shape = itemSchema instanceof import_zod4.z.ZodObject ? itemSchema.shape : null;
+              const desc = shape?.[i.path[1]]?.description;
+              return path + ": " + i.message + (desc ? " (expected: " + desc + ")" : "");
+            }).join("; "));
+          }
+          throw e;
+        }
+      }
+      if (m === "update") {
+        const itemSchema = import_zod4.z.object({
+          fills: import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown())).optional().describe("Fill paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] for transparent. Primary way to set fills."),
+          fillColor: colorRgba.optional().describe("Shorthand \u2014 sets a single solid fill (auto-binds to matching variable/style)"),
+          fillStyleName: import_zod4.z.string().optional().describe("Paint style name for fill"),
+          fillVariableName: import_zod4.z.string().optional().describe("Color variable by name e.g. 'bg/primary'"),
+          strokes: import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown())).optional().describe("Stroke paints array \u2014 e.g. [{type: 'SOLID', color: '#hex'}] or [] to clear. Primary way to set strokes."),
+          strokeColor: colorRgba.optional().describe("Shorthand \u2014 sets a single solid stroke (auto-binds to matching variable/style)"),
+          strokeStyleName: import_zod4.z.string().optional().describe("Paint style name for stroke"),
+          strokeVariableName: import_zod4.z.string().optional().describe("Color variable by name for stroke"),
+          strokeWeight: token.optional().describe("All sides (number) or variable name (string). Per-side: strokeTopWeight, strokeBottomWeight, strokeLeftWeight, strokeRightWeight."),
+          strokeTopWeight: token.optional(),
+          strokeBottomWeight: token.optional(),
+          strokeLeftWeight: token.optional(),
+          strokeRightWeight: token.optional(),
+          strokeAlign: import_zod4.z.enum(["INSIDE", "OUTSIDE", "CENTER"]).optional().describe("Stroke position (default: INSIDE)"),
+          strokesIncludedInLayout: flexBool(import_zod4.z.boolean()).optional().describe("Include stroke width in layout measurements (default: false)"),
+          cornerRadius: token.optional().describe("All corners (number) or variable name (string). Per-corner: topLeftRadius, topRightRadius, bottomRightRadius, bottomLeftRadius."),
+          topLeftRadius: token.optional(),
+          topRightRadius: token.optional(),
+          bottomRightRadius: token.optional(),
+          bottomLeftRadius: token.optional(),
+          opacity: token.optional().describe("Opacity (0-1) or variable name"),
+          visible: import_zod4.z.boolean().optional().describe("Show/hide (default true)"),
+          locked: import_zod4.z.boolean().optional().describe("Lock/unlock (default false)"),
+          blendMode: import_zod4.z.enum(["PASS_THROUGH", "NORMAL", "DARKEN", "MULTIPLY", "LINEAR_BURN", "COLOR_BURN", "LIGHTEN", "SCREEN", "LINEAR_DODGE", "COLOR_DODGE", "OVERLAY", "SOFT_LIGHT", "HARD_LIGHT", "DIFFERENCE", "EXCLUSION", "HUE", "SATURATION", "COLOR", "LUMINOSITY"]).optional(),
+          effectStyleName: import_zod4.z.string().optional().describe("Effect style name (e.g. 'Shadow/Card') for shadows, blurs"),
+          layoutMode: import_zod4.z.enum(["NONE", "HORIZONTAL", "VERTICAL"]).optional().describe("Layout direction (default: NONE)"),
+          layoutWrap: import_zod4.z.enum(["NO_WRAP", "WRAP"]).optional(),
+          padding: token.optional().describe("All edges (number) or variable name (string). Per-edge: paddingTop, paddingRight, paddingBottom, paddingLeft."),
+          paddingTop: token.optional(),
+          paddingRight: token.optional(),
+          paddingBottom: token.optional(),
+          paddingLeft: token.optional(),
+          primaryAxisAlignItems: import_zod4.z.enum(["MIN", "MAX", "CENTER", "SPACE_BETWEEN"]).optional(),
+          counterAxisAlignItems: import_zod4.z.enum(["MIN", "MAX", "CENTER", "BASELINE"]).optional(),
+          itemSpacing: token.optional().describe("Spacing between children (number or variable name string, default: 0)"),
+          counterAxisSpacing: token.optional().describe("Gap between wrapped rows (requires layoutWrap: WRAP)"),
+          layoutSizingHorizontal: import_zod4.z.enum(["FIXED", "HUG", "FILL"]).optional(),
+          layoutSizingVertical: import_zod4.z.enum(["FIXED", "HUG", "FILL"]).optional(),
+          layoutPositioning: import_zod4.z.enum(["AUTO", "ABSOLUTE"]).optional().describe("ABSOLUTE = floating inside auto-layout parent"),
+          minWidth: import_zod4.z.coerce.number().optional().describe("Min width for responsive auto-layout"),
+          maxWidth: import_zod4.z.coerce.number().optional().describe("Max width for responsive auto-layout"),
+          minHeight: import_zod4.z.coerce.number().optional().describe("Min height for responsive auto-layout"),
+          maxHeight: import_zod4.z.coerce.number().optional().describe("Max height for responsive auto-layout"),
+          fontSize: import_zod4.z.number().optional().describe("Font size"),
+          fontFamily: import_zod4.z.string().optional().describe("Font family"),
+          fontStyle: import_zod4.z.string().optional().describe('Font variant e.g. "Bold", "Italic" \u2014 overrides fontWeight'),
+          fontWeight: import_zod4.z.number().optional().describe("100-900. Ignored when fontStyle is set."),
+          fontColor: colorRgba.optional().describe("Shorthand \u2014 sets text color (auto-binds to matching variable/style)"),
+          fontColorVariableName: import_zod4.z.string().optional().describe("Bind color variable by name e.g. 'text/primary'"),
+          fontColorStyleName: import_zod4.z.string().optional().describe("Apply paint style \u2014 overrides fontColor"),
+          textStyleId: import_zod4.z.string().optional().describe("Apply text style by ID \u2014 overrides fontSize/fontWeight"),
+          textStyleName: import_zod4.z.string().optional().describe("Text style by name (case-insensitive)"),
+          textAlignHorizontal: import_zod4.z.enum(["LEFT", "CENTER", "RIGHT", "JUSTIFIED"]).optional(),
+          textAlignVertical: import_zod4.z.enum(["TOP", "CENTER", "BOTTOM"]).optional(),
+          textAutoResize: import_zod4.z.enum(["NONE", "WIDTH_AND_HEIGHT", "HEIGHT", "TRUNCATE"]).optional(),
+          id: import_zod4.z.string().describe("Instance node ID"),
+          properties: import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()).optional().describe("Component property key\u2192value map"),
+          componentProperties: import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()).optional().describe("Alias for properties (matches instances.get response shape)"),
+          name: import_zod4.z.string().optional().describe("Rename node"),
+          rotation: import_zod4.z.number().optional().describe("Degrees (0-360)"),
+          x: import_zod4.z.number().optional(),
+          y: import_zod4.z.number().optional(),
+          width: import_zod4.z.number().optional(),
+          height: import_zod4.z.number().optional(),
+          clearFill: import_zod4.z.boolean().optional().describe("Remove all fills"),
+          effects: import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown())).optional().describe("Effect array (DROP_SHADOW, INNER_SHADOW, LAYER_BLUR, BACKGROUND_BLUR)"),
+          constraints: import_zod4.z.object({
+            horizontal: import_zod4.z.enum(["MIN", "CENTER", "MAX", "STRETCH", "SCALE"]),
+            vertical: import_zod4.z.enum(["MIN", "CENTER", "MAX", "STRETCH", "SCALE"])
+          }).optional(),
+          bindings: import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown())).optional().describe("Bind variables to properties. field path examples: 'fills/0/color', 'strokes/0/color', 'opacity', 'width', 'cornerRadius', 'itemSpacing'."),
+          explicitMode: import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()).optional().describe("Pin variable mode \u2014 use { collectionName, modeName } (preferred) or { collectionId, modeId }"),
+          exportSettings: import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown())).optional().describe("Export settings")
+        }).passthrough();
+        try {
+          params.items = import_zod4.z.array(itemSchema).parse(params.items);
+        } catch (e) {
+          if (e instanceof import_zod4.z.ZodError) {
+            throw new Error(e.issues.map((i) => {
+              const path = i.path.join(".");
+              const shape = itemSchema instanceof import_zod4.z.ZodObject ? itemSchema.shape : null;
+              const desc = shape?.[i.path[1]]?.description;
+              return path + ": " + i.message + (desc ? " (expected: " + desc + ")" : "");
+            }).join("; "));
+          }
+          throw e;
+        }
+      }
+      if (m === "swap") {
+        const itemSchema = import_zod4.z.object({
+          id: import_zod4.z.string().describe("Instance node ID"),
+          componentId: import_zod4.z.string().describe("New component or component set ID")
+        }).passthrough();
+        try {
+          params.items = import_zod4.z.array(itemSchema).parse(params.items);
+        } catch (e) {
+          if (e instanceof import_zod4.z.ZodError) {
+            throw new Error(e.issues.map((i) => {
+              const path = i.path.join(".");
+              const shape = itemSchema instanceof import_zod4.z.ZodObject ? itemSchema.shape : null;
+              const desc = shape?.[i.path[1]]?.description;
+              return path + ": " + i.message + (desc ? " (expected: " + desc + ")" : "");
+            }).join("; "));
+          }
+          throw e;
+        }
+      }
+      if (m === "detach") {
+        const itemSchema = import_zod4.z.object({
+          id: import_zod4.z.string().describe("Instance node ID")
+        }).passthrough();
+        try {
+          params.items = import_zod4.z.array(itemSchema).parse(params.items);
+        } catch (e) {
+          if (e instanceof import_zod4.z.ZodError) {
+            throw new Error(e.issues.map((i) => {
+              const path = i.path.join(".");
+              const shape = itemSchema instanceof import_zod4.z.ZodObject ? itemSchema.shape : null;
+              const desc = shape?.[i.path[1]]?.description;
+              return path + ": " + i.message + (desc ? " (expected: " + desc + ")" : "");
+            }).join("; "));
+          }
+          throw e;
+        }
+      }
+      if (m === "reset_overrides") {
+        const itemSchema = import_zod4.z.object({
+          id: import_zod4.z.string().describe("Instance node ID")
+        }).passthrough();
+        try {
+          params.items = import_zod4.z.array(itemSchema).parse(params.items);
+        } catch (e) {
+          if (e instanceof import_zod4.z.ZodError) {
+            throw new Error(e.issues.map((i) => {
+              const path = i.path.join(".");
+              const shape = itemSchema instanceof import_zod4.z.ZodObject ? itemSchema.shape : null;
+              const desc = shape?.[i.path[1]]?.description;
+              return path + ": " + i.message + (desc ? " (expected: " + desc + ")" : "");
+            }).join("; "));
+          }
+          throw e;
+        }
+      }
+    },
+    commandMap: { "list": "instances.list", "delete": "instances.delete", "clone": "instances.clone", "audit": "instances.audit", "reparent": "instances.reparent", "get": "instances.get", "create": "instances.create", "update": "instances.update", "swap": "instances.swap", "detach": "instances.detach", "reset_overrides": "instances.reset_overrides" }
+  },
   {
-    name: "get_available_fonts",
-    description: "Get available fonts in Figma. Optionally filter by query string.",
-    schema: { query: import_zod12.z.string().optional().describe("Filter fonts by name (case-insensitive). Omit to list all fonts.") },
-    tier: "read"
-  }
-];
-
-// src/tools/defs/lint.ts
-var import_zod13 = require("zod");
-var lintRules = import_zod13.z.enum([
-  "no-autolayout",
-  "shape-instead-of-frame",
-  "hardcoded-color",
-  "no-text-style",
-  "fixed-in-autolayout",
-  "default-name",
-  "empty-container",
-  "stale-text-name",
-  "no-text-property",
-  "wcag-contrast",
-  "wcag-contrast-enhanced",
-  "wcag-non-text-contrast",
-  "wcag-target-size",
-  "wcag-text-size",
-  "wcag-line-height",
-  "wcag",
-  "all"
-]);
-var tools12 = [
+    name: "lint",
+    description: '/** Run design quality and accessibility checks. Use method "help" for detailed parameter docs. */\n  check     (nodeId?, rules?, maxDepth?, maxFindings?) \u2192 { nodeId, nodeName, categories, warning? }  // Run design linter on a node tree\n  fix       (items: { nodeId: string; layoutMode?: "VERTICAL" | "HORIZONTAL"; itemSpacing?: number }[], depth?) \u2192 { results: ("ok" | {error})[] }  // Auto-fix frames to auto-layout\n// Lint runs automated design quality and accessibility checks on a node tree.',
+    schema: (caps2) => filterMethodsByTier({
+      method: import_zod4.z.enum(["check", "fix", "help"]),
+      nodeId: import_zod4.z.string().optional().describe("Node ID to lint. If omitted: 1 selected node \u2192 lints that node, 2+ selected \u2192 lints entire page (not the selection), 0 selected \u2192 error. Always pass nodeId explicitly for reliable targeting."),
+      rules: flexJson(import_zod4.z.array(import_zod4.z.string())).optional().describe('Rules to run. Default: ["all"]. Categories: "component", "composition", "token", "naming", "wcag"/"accessibility". Or specific rule names.'),
+      maxDepth: import_zod4.z.coerce.number().optional().describe("Max tree depth (default: 10)"),
+      maxFindings: import_zod4.z.coerce.number().optional().describe("Max findings (default: 50)"),
+      items: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).optional().describe("Array of {nodeId, layoutMode?, itemSpacing?}"),
+      depth: import_zod4.z.coerce.number().optional().describe("Response detail for fixed nodes: omit for stubs, 0=properties, -1=full tree"),
+      topic: import_zod4.z.string().optional().describe('Help topic \u2014 method name for endpoint help, e.g. "create"')
+    }, caps2, { "check": "read", "fix": "edit", "help": "read" }),
+    tier: "read",
+    validate: (params) => {
+      const m = params.method;
+      if (!params.items) return;
+      if (m === "fix") {
+        for (const it of params.items) {
+          if (it.id !== void 0 && it.nodeId === void 0) {
+            it.nodeId = it.id;
+            delete it.id;
+          }
+        }
+        const itemSchema = import_zod4.z.object({
+          nodeId: import_zod4.z.string().describe("Frame node ID"),
+          layoutMode: import_zod4.z.enum(["VERTICAL", "HORIZONTAL"]).optional().describe("Direction (default: auto-detected)"),
+          itemSpacing: import_zod4.z.coerce.number().optional().describe("Spacing between children")
+        }).passthrough();
+        try {
+          params.items = import_zod4.z.array(itemSchema).parse(params.items);
+        } catch (e) {
+          if (e instanceof import_zod4.z.ZodError) {
+            throw new Error(e.issues.map((i) => {
+              const path = i.path.join(".");
+              const shape = itemSchema instanceof import_zod4.z.ZodObject ? itemSchema.shape : null;
+              const desc = shape?.[i.path[1]]?.description;
+              return path + ": " + i.message + (desc ? " (expected: " + desc + ")" : "");
+            }).join("; "));
+          }
+          throw e;
+        }
+      }
+    },
+    commandMap: { "check": "lint.check", "fix": "lint.fix" }
+  },
   {
-    name: "lint_node",
-    description: "Run design linter on a node tree. Returns issues grouped by category with affected node IDs and fix instructions. Lint child nodes individually for large trees.",
-    schema: {
-      nodeId: import_zod13.z.string().optional().describe("Node ID to lint. Omit to lint current selection."),
-      rules: flexJson(import_zod13.z.array(lintRules)).optional().describe('Rules to run. Default: ["all"]. Options: no-autolayout, shape-instead-of-frame, hardcoded-color, no-text-style, fixed-in-autolayout, default-name, empty-container, stale-text-name, no-text-property, all, wcag-contrast, wcag-contrast-enhanced, wcag-non-text-contrast, wcag-target-size, wcag-text-size, wcag-line-height, wcag'),
-      maxDepth: import_zod13.z.coerce.number().optional().describe("Max depth to recurse (default: 10)"),
-      maxFindings: import_zod13.z.coerce.number().optional().describe("Stop after N findings (default: 50)")
+    name: "prototyping",
+    description: '/** Manage prototype interactions, reactions, and navigation flows. Use method "help" for detailed parameter docs. */\n  get       (id) \u2192 { reactions?, overflowDirection? }  // Get reactions and overflow direction on a node\n  add       (id, trigger: ON_CLICK|ON_HOVER|ON_PRESS|ON_DRAG|AFTER_TIMEOUT|MOUSE_ENTER|MOUSE_LEAVE|ON_KEY_DOWN, triggerDelay?, triggerKeyCodes?, triggerDevice?: KEYBOARD|XBOX_ONE|PS4|SWITCH_PRO, destination?, navigation?: NAVIGATE|SWAP|OVERLAY|SCROLL_TO|CHANGE_TO, transition?: DISSOLVE|SMART_ANIMATE|MOVE_IN|MOVE_OUT|PUSH|SLIDE_IN|SLIDE_OUT|INSTANT, transitionDirection?: LEFT|RIGHT|TOP|BOTTOM, duration?, easing?: EASE_IN|EASE_OUT|EASE_IN_AND_OUT|LINEAR|GENTLE|QUICK|BOUNCY|SLOW, actionType?: NODE|BACK|CLOSE|URL|SET_VARIABLE_MODE, url?, collectionName?, modeName?, resetScrollPosition?, actions?) \u2192 { results: "ok"[] }  // Add a prototype reaction to a node\n  set       (id, reactions) \u2192 { results: "ok"[] }  // Replace all reactions on a node (raw reactions array)\n  remove    (id, index) \u2192 { results: "ok"[] }  // Remove a reaction from a node by index\n// Reactions wire up interactions: trigger (ON_CLICK, ON_HOVER, ...) \u2192 action (navigate, swap, overlay).\n// Common patterns: button ON_CLICK \u2192 NAVIGATE to detail frame; card ON_HOVER \u2192 CHANGE_TO hover variant.\n// Multi-action: pass actions[] array to run multiple actions on one trigger (e.g. navigate + set variable mode).',
+    schema: (caps2) => filterMethodsByTier({
+      method: import_zod4.z.enum(["get", "add", "set", "remove", "help"]),
+      id: import_zod4.z.string().optional().describe("Node ID"),
+      trigger: import_zod4.z.enum(["ON_CLICK", "ON_HOVER", "ON_PRESS", "ON_DRAG", "AFTER_TIMEOUT", "MOUSE_ENTER", "MOUSE_LEAVE", "ON_KEY_DOWN"]).optional().describe("Trigger type"),
+      triggerDelay: import_zod4.z.coerce.number().optional().describe("Delay in ms for AFTER_TIMEOUT / MOUSE_ENTER / MOUSE_LEAVE triggers"),
+      triggerKeyCodes: import_zod4.z.unknown().optional().describe("Key codes for ON_KEY_DOWN trigger"),
+      triggerDevice: import_zod4.z.enum(["KEYBOARD", "XBOX_ONE", "PS4", "SWITCH_PRO"]).optional().describe("Device for ON_KEY_DOWN (default: KEYBOARD)"),
+      destination: import_zod4.z.string().optional().describe("Target node ID (required for NODE actions)"),
+      navigation: import_zod4.z.enum(["NAVIGATE", "SWAP", "OVERLAY", "SCROLL_TO", "CHANGE_TO"]).optional().describe("Navigation type (default: NAVIGATE)"),
+      transition: import_zod4.z.enum(["DISSOLVE", "SMART_ANIMATE", "MOVE_IN", "MOVE_OUT", "PUSH", "SLIDE_IN", "SLIDE_OUT", "INSTANT"]).optional().describe("Transition animation (default: DISSOLVE). INSTANT = no animation."),
+      transitionDirection: import_zod4.z.enum(["LEFT", "RIGHT", "TOP", "BOTTOM"]).optional().describe("Direction for MOVE_IN, MOVE_OUT, PUSH, SLIDE_IN, SLIDE_OUT"),
+      duration: import_zod4.z.coerce.number().optional().describe("Transition duration in seconds (default: 0.3)"),
+      easing: import_zod4.z.enum(["EASE_IN", "EASE_OUT", "EASE_IN_AND_OUT", "LINEAR", "GENTLE", "QUICK", "BOUNCY", "SLOW"]).optional().describe("Easing function (default: EASE_OUT)"),
+      actionType: import_zod4.z.enum(["NODE", "BACK", "CLOSE", "URL", "SET_VARIABLE_MODE"]).optional().describe("Action type (default: NODE). SET_VARIABLE_MODE switches a variable collection mode."),
+      url: import_zod4.z.string().optional().describe("URL for URL action type"),
+      collectionName: import_zod4.z.string().optional().describe("Variable collection name (for SET_VARIABLE_MODE)"),
+      modeName: import_zod4.z.string().optional().describe("Mode name to switch to (for SET_VARIABLE_MODE)"),
+      resetScrollPosition: flexBool(import_zod4.z.boolean()).optional().describe("Reset scroll position on navigate (default: true)"),
+      actions: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).optional().describe("Multi-action: [{actionType, destination?, navigation?, collectionName?, modeName?, ...}]. Overrides single-action params."),
+      reactions: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).optional().describe("Full reactions array \u2014 [{trigger:{type}, actions:[{type, destinationId, navigation, transition}]}]"),
+      index: import_zod4.z.coerce.number().optional().describe("Reaction index (0-based)"),
+      topic: import_zod4.z.string().optional().describe('Help topic \u2014 method name for endpoint help, e.g. "create"')
+    }, caps2, { "get": "read", "add": "edit", "set": "edit", "remove": "edit", "help": "read" }),
+    tier: "read",
+    validate: (params) => {
+      const m = params.method;
+      if (m === "get") {
+        if (params.id === void 0) throw new Error('get requires "id"');
+      }
+      if (m === "add") {
+        if (params.id === void 0) throw new Error('add requires "id"');
+        if (params.trigger === void 0) throw new Error('add requires "trigger"');
+      }
+      if (m === "set") {
+        if (params.id === void 0) throw new Error('set requires "id"');
+        if (params.reactions === void 0) throw new Error('set requires "reactions"');
+      }
+      if (m === "remove") {
+        if (params.id === void 0) throw new Error('remove requires "id"');
+        if (params.index === void 0) throw new Error('remove requires "index"');
+      }
     },
-    tier: "read"
+    commandMap: { "get": "prototyping.get", "add": "prototyping.add", "set": "prototyping.set", "remove": "prototyping.remove" }
   },
   {
-    name: "lint_fix_autolayout",
-    description: "Auto-fix: convert frames with multiple children to auto-layout. Takes node IDs from lint_node 'no-autolayout' results.",
-    schema: {
-      items: flexJson(import_zod13.z.array(import_zod13.z.object({
-        nodeId,
-        layoutMode: import_zod13.z.enum(["HORIZONTAL", "VERTICAL"]).optional().describe("Layout direction (default: auto-detect based on child positions)"),
-        itemSpacing: import_zod13.z.coerce.number().optional().describe("Spacing between children (default: 0)")
-      }))).describe("Array of frames to convert to auto-layout"),
-      depth
+    name: "selection",
+    description: '/** Read and set the current Figma selection. Use method "help" for detailed parameter docs. */\n  get       (depth?, verbose?) \u2192 { results, _truncated?, _notice? }  // Get the current selection\n  set       (nodeIds) \u2192 { count, selectedNodes, notFoundIds? }  // Set selection to nodes and scroll viewport to show them\n// Selection is the set of nodes currently highlighted in the Figma canvas.\n// get returns the current selection. Without depth, returns stubs ({id, name, type}). With depth=0, returns full properties.\n// _truncated: true when the response was cut short due to node budget limits. Use depth=0 or specific fields to reduce payload.\n// set replaces the entire selection AND scrolls the viewport to show the selected nodes.',
+    schema: (caps2) => filterMethodsByTier({
+      method: import_zod4.z.enum(["get", "set", "help"]),
+      depth: import_zod4.z.coerce.number().optional().describe("Child recursion depth. Omit for stubs only, 0=selected nodes' properties, -1=unlimited."),
+      verbose: import_zod4.z.boolean().optional().describe("Include all properties (bounding box, constraints, text style details). Default false \u2014 returns slim, actionable output."),
+      nodeIds: flexJson(import_zod4.z.array(import_zod4.z.string())).optional().describe('Array of node IDs to select. Example: ["1:2","1:3"]'),
+      topic: import_zod4.z.string().optional().describe('Help topic \u2014 method name for endpoint help, e.g. "create"')
+    }, caps2, { "get": "read", "set": "read", "help": "read" }),
+    tier: "read",
+    validate: (params) => {
+      const m = params.method;
+      if (m === "set") {
+        if (params.nodeIds === void 0) throw new Error('set requires "nodeIds"');
+      }
     },
-    tier: "edit"
-  }
-];
-
-// src/tools/defs/styles.ts
-var import_zod15 = require("zod");
-
-// src/tools/endpoint.ts
-var import_zod14 = require("zod");
-var DEFAULT_TIERS = {
-  get: "read",
-  list: "read",
-  create: "create",
-  update: "edit",
-  delete: "edit"
-};
-function endpointSchema(methods, capsOrExtra, extraOrTiers, methodTiers) {
-  let caps2;
-  let extra;
-  if (capsOrExtra && "create" in capsOrExtra && "edit" in capsOrExtra && typeof capsOrExtra.create === "boolean") {
-    caps2 = capsOrExtra;
-    extra = extraOrTiers;
-  } else {
-    extra = capsOrExtra;
-  }
-  let filtered = methods;
-  if (caps2) {
-    const tiers = { ...DEFAULT_TIERS, ...methodTiers };
-    filtered = methods.filter((m) => {
-      const tier = tiers[m] ?? "edit";
-      if (tier === "read") return true;
-      if (tier === "create") return caps2.create;
-      if (tier === "edit") return caps2.edit;
-      return false;
-    });
-  }
-  const schema = {
-    method: import_zod14.z.enum(filtered)
-  };
-  if (filtered.includes("get") || filtered.includes("delete")) {
-    schema.id = import_zod14.z.string().optional().describe("Resource ID (get, delete)");
-  }
-  if (filtered.includes("get") || filtered.includes("list")) {
-    schema.fields = flexJson(import_zod14.z.array(import_zod14.z.string())).optional().describe('Property whitelist (get/list). Identity fields (id, name, type) always included. Omit for stubs on list, full detail on get. Pass ["*"] for all fields.');
-  }
-  if (filtered.includes("list")) {
-    schema.offset = import_zod14.z.coerce.number().optional().describe("Skip N items for pagination (default 0)");
-    schema.limit = import_zod14.z.coerce.number().optional().describe("Max items per page (default 100)");
-  }
-  return { ...schema, ...extra };
-}
-
-// src/tools/defs/styles.ts
-var paintStyleItem = import_zod15.z.object({
-  name: import_zod15.z.string().describe("Style name"),
-  color: flexJson(colorRgba).describe("Color.")
-});
-var textStyleItem = import_zod15.z.object({
-  name: import_zod15.z.string().describe("Style name"),
-  fontFamily: import_zod15.z.string().describe("Font family"),
-  fontStyle: import_zod15.z.string().optional().describe("Font style (default: Regular)"),
-  fontSize: import_zod15.z.coerce.number().describe("Font size"),
-  lineHeight: flexNum(import_zod15.z.union([
-    import_zod15.z.number(),
-    import_zod15.z.object({ value: import_zod15.z.coerce.number(), unit: import_zod15.z.enum(["PIXELS", "PERCENT", "AUTO"]) })
-  ])).optional().describe("Line height \u2014 number (px) or {value, unit}. Default: auto."),
-  letterSpacing: flexNum(import_zod15.z.union([
-    import_zod15.z.number(),
-    import_zod15.z.object({ value: import_zod15.z.coerce.number(), unit: import_zod15.z.enum(["PIXELS", "PERCENT"]) })
-  ])).optional().describe("Letter spacing \u2014 number (px) or {value, unit}. Default: 0."),
-  textCase: import_zod15.z.enum(["ORIGINAL", "UPPER", "LOWER", "TITLE"]).optional(),
-  textDecoration: import_zod15.z.enum(["NONE", "UNDERLINE", "STRIKETHROUGH"]).optional()
-});
-var effectStyleItem = import_zod15.z.object({
-  name: import_zod15.z.string().describe("Style name"),
-  effects: flexJson(import_zod15.z.array(effectEntry)).describe("Array of effects")
-});
-var patchBase = {
-  id: import_zod15.z.string().describe("Style ID or name (case-insensitive match)"),
-  name: import_zod15.z.string().optional().describe("Rename the style")
-};
-var patchPaintItem = import_zod15.z.object({
-  ...patchBase,
-  color: flexJson(colorRgba).optional().describe("New color.")
-});
-var patchTextItem = import_zod15.z.object({
-  ...patchBase,
-  fontFamily: import_zod15.z.string().optional().describe("Font family"),
-  fontStyle: import_zod15.z.string().optional().describe("Font style, e.g. Regular, Bold"),
-  fontSize: import_zod15.z.coerce.number().optional().describe("Font size"),
-  lineHeight: flexNum(import_zod15.z.union([
-    import_zod15.z.number(),
-    import_zod15.z.object({ value: import_zod15.z.coerce.number(), unit: import_zod15.z.enum(["PIXELS", "PERCENT", "AUTO"]) })
-  ])).optional().describe("Line height \u2014 number (px) or {value, unit}"),
-  letterSpacing: flexNum(import_zod15.z.union([
-    import_zod15.z.number(),
-    import_zod15.z.object({ value: import_zod15.z.coerce.number(), unit: import_zod15.z.enum(["PIXELS", "PERCENT"]) })
-  ])).optional().describe("Letter spacing \u2014 number (px) or {value, unit}"),
-  textCase: import_zod15.z.enum(["ORIGINAL", "UPPER", "LOWER", "TITLE"]).optional(),
-  textDecoration: import_zod15.z.enum(["NONE", "UNDERLINE", "STRIKETHROUGH"]).optional()
-});
-var patchEffectItem = import_zod15.z.object({
-  ...patchBase,
-  effects: flexJson(import_zod15.z.array(effectEntry)).optional().describe("Array of effects")
-});
-var patchAnyItem = import_zod15.z.object({
-  ...patchBase,
-  color: flexJson(colorRgba).optional(),
-  fontFamily: import_zod15.z.string().optional(),
-  fontStyle: import_zod15.z.string().optional(),
-  fontSize: import_zod15.z.coerce.number().optional(),
-  lineHeight: flexNum(import_zod15.z.union([
-    import_zod15.z.number(),
-    import_zod15.z.object({ value: import_zod15.z.coerce.number(), unit: import_zod15.z.enum(["PIXELS", "PERCENT", "AUTO"]) })
-  ])).optional(),
-  letterSpacing: flexNum(import_zod15.z.union([
-    import_zod15.z.number(),
-    import_zod15.z.object({ value: import_zod15.z.coerce.number(), unit: import_zod15.z.enum(["PIXELS", "PERCENT"]) })
-  ])).optional(),
-  textCase: import_zod15.z.enum(["ORIGINAL", "UPPER", "LOWER", "TITLE"]).optional(),
-  textDecoration: import_zod15.z.enum(["NONE", "UNDERLINE", "STRIKETHROUGH"]).optional(),
-  effects: flexJson(import_zod15.z.array(effectEntry)).optional()
-});
-var createSchemas = {
-  paint: paintStyleItem,
-  text: textStyleItem,
-  effect: effectStyleItem
-};
-var updateSchemas = {
-  paint: patchPaintItem,
-  text: patchTextItem,
-  effect: patchEffectItem
-};
-var tools13 = [
+    commandMap: { "get": "selection.get", "set": "selection.set" }
+  },
   {
     name: "styles",
-    description: "CRUD endpoint for local styles (paint, text, effect).\n  list   \u2192 {type?, fields?, offset?, limit?} \u2192 {totalCount, items: [{id, name, type, ...}]}\n  get    \u2192 {id, fields?} \u2192 style object (full detail; fields to filter)\n  create \u2192 {type, items: [...]} \u2192 {results: [{id}, ...]}\n  update \u2192 {type?, items: [{id, ...}]} \u2192 {results: ['ok'|{warning}, ...]}\n  delete \u2192 {id} or {items: [{id}, ...]} \u2192 'ok' or {results: ['ok', ...]}",
-    schema: (caps2) => endpointSchema(
-      ["create", "get", "list", "update", "delete"],
-      caps2,
-      {
-        type: import_zod15.z.enum(["paint", "text", "effect"]).optional().describe("Style type. Required for create. Filters list by type. Optional for update (strict per-type validation; omit to auto-detect)."),
-        items: flexJson(import_zod15.z.array(import_zod15.z.any())).optional().describe("Create: [{name, color}] (paint), [{name, fontFamily, fontSize, ...}] (text), [{name, effects}] (effect). Update: [{id, ...fields}]. Delete (batch): [{id}, ...]."),
-        depth
+    description: '/** CRUD for local paint, text, effect, and grid styles. Use method "help" for detailed parameter docs. */\n  list      (type?: paint|text|effect|grid, fields?, offset?, limit?) \u2192 { totalCount, items }  // List local styles with optional type filter\n  get       (id, fields?) \u2192 { id, name, type, paints?, fontFamily?, fontSize?, effects?, layoutGrids? }  // Get full style detail by ID\n  create    (type: paint|text|effect|grid, items: (PaintItem | TextItem | EffectItem | GridItem)[]) \u2192 { results: {id}[] }  // Create local styles\n  update    (type?: paint|text|effect|grid, items: PatchStyleItem[]) \u2192 { results: ("ok" | {error})[] }  // Update styles by ID or name\n  delete    (id?, items?: { id: string }[]) \u2192 { results: "ok"[] }  // Delete styles\n// Styles are named, reusable design properties that can be applied to nodes. Four types:\n//   paint: a named color (applied to fills/strokes), text: typography settings, effect: shadows/blurs, grid: layout grids.\n// All ID params accept both IDs and display names (case-insensitive). Use whichever you have.',
+    schema: (caps2) => filterMethodsByTier({
+      method: import_zod4.z.enum(["list", "get", "create", "update", "delete", "help"]),
+      type: import_zod4.z.enum(["paint", "text", "effect", "grid"]).optional().describe("Filter by style type"),
+      fields: flexJson(import_zod4.z.array(import_zod4.z.string())).optional().describe('Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.'),
+      offset: import_zod4.z.coerce.number().optional().default(0).describe("Skip N items for pagination (default 0)"),
+      limit: import_zod4.z.coerce.number().optional().default(100).describe("Max items per page (default 100)"),
+      id: import_zod4.z.string().optional().describe("Style ID or name"),
+      items: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).optional().describe("Array of {id, ...properties} to create/update/delete"),
+      topic: import_zod4.z.string().optional().describe('Help topic \u2014 method name for endpoint help, e.g. "create"')
+    }, caps2, { "list": "read", "get": "read", "create": "create", "update": "edit", "delete": "edit", "help": "read" }),
+    tier: "read",
+    validate: (params) => {
+      const m = params.method;
+      if (m === "get") {
+        if (params.id === void 0) throw new Error('get requires "id"');
       }
-    ),
+      if (!params.items) return;
+      if (m === "create") {
+        const schemas = {
+          "paint": import_zod4.z.object({
+            name: import_zod4.z.string().describe("Style name"),
+            color: colorRgba.describe("Color value"),
+            colorVariableName: import_zod4.z.string().optional().describe("Bind to a COLOR variable by name (style tracks the variable)"),
+            description: import_zod4.z.string().optional().describe("Style description")
+          }).passthrough(),
+          "text": import_zod4.z.object({
+            name: import_zod4.z.string().describe("Style name"),
+            fontFamily: import_zod4.z.string().describe("Font family"),
+            fontStyle: import_zod4.z.string().optional().describe("Font style (default: Regular)"),
+            fontSize: import_zod4.z.coerce.number().describe("Font size"),
+            lineHeight: lineHeight.optional(),
+            letterSpacing: letterSpacing.optional(),
+            textCase: import_zod4.z.enum(["ORIGINAL", "UPPER", "LOWER", "TITLE", "SMALL_CAPS", "SMALL_CAPS_FORCED"]).optional(),
+            textDecoration: import_zod4.z.enum(["NONE", "UNDERLINE", "STRIKETHROUGH"]).optional(),
+            paragraphIndent: import_zod4.z.coerce.number().optional().describe("Paragraph indent (px)"),
+            paragraphSpacing: import_zod4.z.coerce.number().optional().describe("Paragraph spacing (px)"),
+            leadingTrim: import_zod4.z.enum(["CAP_HEIGHT", "NONE"]).optional().describe("Leading trim mode"),
+            description: import_zod4.z.string().optional().describe("Style description")
+          }).passthrough(),
+          "effect": import_zod4.z.object({
+            name: import_zod4.z.string().describe("Style name"),
+            effects: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).describe("Array of Effect objects"),
+            description: import_zod4.z.string().optional().describe("Style description")
+          }).passthrough(),
+          "grid": import_zod4.z.object({
+            name: import_zod4.z.string().describe("Style name"),
+            layoutGrids: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).describe("Array of LayoutGrid objects"),
+            description: import_zod4.z.string().optional().describe("Style description")
+          }).passthrough()
+        };
+        const s = params.type && schemas[params.type];
+        if (s) {
+          try {
+            params.items = import_zod4.z.array(s).parse(params.items);
+          } catch (e) {
+            if (e instanceof import_zod4.z.ZodError) {
+              throw new Error(e.issues.map((i) => {
+                const path = i.path.join(".");
+                const shape = s instanceof import_zod4.z.ZodObject ? s.shape : null;
+                const desc = shape?.[i.path[1]]?.description;
+                return path + ": " + i.message + (desc ? " (expected: " + desc + ")" : "");
+              }).join("; "));
+            }
+            throw e;
+          }
+        }
+      }
+      if (m === "update") {
+        const itemSchema = import_zod4.z.object({
+          id: import_zod4.z.string().describe("Style ID or name"),
+          name: import_zod4.z.string().optional().describe("Rename the style"),
+          description: import_zod4.z.string().optional().describe("Style description"),
+          color: colorRgba.optional().describe("New color (paint styles)"),
+          colorVariableName: import_zod4.z.string().optional().describe("Bind to a COLOR variable by name (paint styles)"),
+          fontFamily: import_zod4.z.string().optional(),
+          fontStyle: import_zod4.z.string().optional(),
+          fontSize: import_zod4.z.coerce.number().optional(),
+          lineHeight: lineHeight.optional(),
+          letterSpacing: letterSpacing.optional(),
+          textCase: import_zod4.z.enum(["ORIGINAL", "UPPER", "LOWER", "TITLE", "SMALL_CAPS", "SMALL_CAPS_FORCED"]).optional(),
+          textDecoration: import_zod4.z.enum(["NONE", "UNDERLINE", "STRIKETHROUGH"]).optional(),
+          paragraphIndent: import_zod4.z.coerce.number().optional().describe("Paragraph indent (px)"),
+          paragraphSpacing: import_zod4.z.coerce.number().optional().describe("Paragraph spacing (px)"),
+          leadingTrim: import_zod4.z.enum(["CAP_HEIGHT", "NONE"]).optional(),
+          effects: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).optional().describe("Array of Effect objects"),
+          layoutGrids: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).optional().describe("Array of LayoutGrid objects (grid styles)")
+        }).passthrough();
+        try {
+          params.items = import_zod4.z.array(itemSchema).parse(params.items);
+        } catch (e) {
+          if (e instanceof import_zod4.z.ZodError) {
+            throw new Error(e.issues.map((i) => {
+              const path = i.path.join(".");
+              const shape = itemSchema instanceof import_zod4.z.ZodObject ? itemSchema.shape : null;
+              const desc = shape?.[i.path[1]]?.description;
+              return path + ": " + i.message + (desc ? " (expected: " + desc + ")" : "");
+            }).join("; "));
+          }
+          throw e;
+        }
+      }
+      if (m === "delete") {
+        const itemSchema = import_zod4.z.object({
+          id: import_zod4.z.string().describe("Style ID or name")
+        }).passthrough();
+        try {
+          params.items = import_zod4.z.array(itemSchema).parse(params.items);
+        } catch (e) {
+          if (e instanceof import_zod4.z.ZodError) {
+            throw new Error(e.issues.map((i) => {
+              const path = i.path.join(".");
+              const shape = itemSchema instanceof import_zod4.z.ZodObject ? itemSchema.shape : null;
+              const desc = shape?.[i.path[1]]?.description;
+              return path + ": " + i.message + (desc ? " (expected: " + desc + ")" : "");
+            }).join("; "));
+          }
+          throw e;
+        }
+      }
+    },
+    commandMap: { "list": "styles.list", "get": "styles.get", "create": "styles.create", "update": "styles.update", "delete": "styles.delete" }
+  },
+  {
+    name: "text",
+    description: '/** Create and manage text nodes. Use method "help" for detailed parameter docs. */\n  get       (id, fields?, depth?, verbose?) \u2192 { results: Node[], _truncated?, _notice? }  // Get serialized node data\n  list      (query?, types?, parentId?, fields?, offset?, limit?) \u2192 { totalCount, returned?, offset?, limit?, results }  // Search for nodes (returns stubs only \u2014 use get with depth for full properties)\n  update    (items: PatchItem[]) \u2192 { results: ("ok" | {error})[] }  // Patch node properties\n  delete    (id?, items?: { id?: string }[]) \u2192 { results: "ok"[] }  // Delete nodes\n  clone     (id, parentId?, x?, y?, depth?) \u2192 { results: {id}[] }  // Duplicate nodes\n  audit     (id, rules?, maxDepth?, maxFindings?) \u2192 { nodeId?, nodeName?, categories? }  // Run lint on a node \u2014 returns severity-ranked findings\n  reparent  (items: { id: string; parentId: string; index?: number }[]) \u2192 { results: "ok"[] }  // Move nodes into a new parent\n  create    (items: TextItem[], depth?) \u2192 { results: {id}[] }  // Create text nodes\n  set_content(items: { nodeId: string; text: string }[], depth?) \u2192 { results: "ok"[] }  // Replace text content on existing text nodes\n  scan      (items: { nodeId: string; limit?: number; includePath?: boolean; includeGeometry?: boolean }[]) \u2192 { results: ("ok" | {error})[] }  // Scan all text nodes within a subtree\n// depth: omit \u2192 id+name stubs | 0 \u2192 props + child stubs | N \u2192 recurse N | -1 \u2192 full tree\n// fields: whitelist e.g. ["fills","opacity"] \u2014 id, name, type always included. Pass ["*"] for all.\n// layoutSizingHorizontal/Vertical: FIXED | HUG | FILL \u2014 how the node sizes within auto-layout.\n// Colors: fillVariableName/strokeVariableName bind by name \u2014 preferred over raw color values.\n// Note: node-based endpoints (frames, text, instances, components) use `results` as the list key.\n//   Standalone endpoints (styles, variables, variable_collections) use `items`. Components.list uses `items` (catalog view).',
+    schema: (caps2) => filterMethodsByTier({
+      method: import_zod4.z.enum(["get", "list", "update", "delete", "clone", "audit", "reparent", "create", "set_content", "scan", "help"]),
+      id: import_zod4.z.string().optional().describe("Node ID"),
+      fields: flexJson(import_zod4.z.array(import_zod4.z.string())).optional().describe('Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.'),
+      depth: import_zod4.z.coerce.number().optional().describe("Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited."),
+      verbose: import_zod4.z.boolean().optional().describe("Include all properties (bounding box, constraints, text style details). Default false \u2014 returns slim, actionable output."),
+      query: import_zod4.z.string().optional().describe("Name search query (case-insensitive substring match)"),
+      types: flexJson(import_zod4.z.array(import_zod4.z.string())).optional().describe('Filter by node types (e.g. ["FRAME", "TEXT"])'),
+      parentId: import_zod4.z.string().optional().describe("Search only within this subtree"),
+      offset: import_zod4.z.coerce.number().optional().default(0).describe("Skip N items for pagination (default 0)"),
+      limit: import_zod4.z.coerce.number().optional().default(100).describe("Max items per page (default 100)"),
+      items: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).optional().describe("Array of {id, ...properties} to update/delete/reparent/create/set_content/scan"),
+      x: import_zod4.z.coerce.number().optional().describe("X position (default: 0)"),
+      y: import_zod4.z.coerce.number().optional().describe("Y position (default: 0)"),
+      rules: flexJson(import_zod4.z.array(import_zod4.z.string())).optional().describe('Rules to check. Default: ["all"]. Categories: "component", "composition", "token", "naming", "wcag".'),
+      maxDepth: import_zod4.z.coerce.number().optional().describe("Max tree depth (default: 10)"),
+      maxFindings: import_zod4.z.coerce.number().optional().describe("Max findings (default: 50)"),
+      topic: import_zod4.z.string().optional().describe('Help topic \u2014 method name for endpoint help, e.g. "create"')
+    }, caps2, { "get": "read", "list": "read", "update": "edit", "delete": "edit", "clone": "create", "audit": "read", "reparent": "edit", "create": "create", "set_content": "edit", "scan": "read", "help": "read" }),
     tier: "read",
     validate: (params) => {
-      if (params.items) {
-        const map = params.method === "update" ? updateSchemas : createSchemas;
-        const itemSchema = params.type && map[params.type] || patchAnyItem;
-        params.items = import_zod15.z.array(itemSchema).parse(params.items);
+      const m = params.method;
+      if (!params.items) return;
+      if (m === "create") {
+        for (const it of params.items) {
+          if (it.characters !== void 0 && it.text === void 0) {
+            it.text = it.characters;
+            delete it.characters;
+          }
+        }
+        const itemSchema = import_zod4.z.object({
+          text: import_zod4.z.string().optional().describe("Text content"),
+          name: import_zod4.z.string().optional().describe("Layer name"),
+          x: import_zod4.z.number().optional(),
+          y: import_zod4.z.number().optional(),
+          width: import_zod4.z.number().optional().describe("Fixed width in px \u2014 implies layoutSizingHorizontal: FIXED and textAutoResize: HEIGHT"),
+          parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place on current page."),
+          fontFamily: import_zod4.z.string().optional().describe("Font family (default: Inter). Use fonts.list to find installed fonts."),
+          fontStyle: import_zod4.z.string().optional().describe('Font variant e.g. "Bold", "Italic" \u2014 overrides fontWeight'),
+          fontSize: import_zod4.z.number().optional().describe("Font size (default: 14)"),
+          fontWeight: import_zod4.z.number().optional().describe("100-900 (default: 400). Ignored when fontStyle is set."),
+          fills: import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown())).optional().describe("Text color paints \u2014 e.g. [{type: 'SOLID', color: '#hex'}]. Same as node fills."),
+          fontColor: colorRgba.optional().describe("Shorthand \u2014 sets text color (auto-binds to matching variable/style)"),
+          fontColorVariableName: import_zod4.z.string().optional().describe("Bind color variable by name e.g. 'text/primary'"),
+          fontColorStyleName: import_zod4.z.string().optional().describe("Apply paint style \u2014 overrides fontColor"),
+          textStyleId: import_zod4.z.string().optional().describe("Text style ID or name (case-insensitive) \u2014 overrides fontSize/fontWeight"),
+          textStyleName: import_zod4.z.string().optional().describe("Alias for textStyleId \u2014 accepts name (case-insensitive)"),
+          textAlignHorizontal: import_zod4.z.enum(["LEFT", "CENTER", "RIGHT", "JUSTIFIED"]).optional(),
+          textAlignVertical: import_zod4.z.enum(["TOP", "CENTER", "BOTTOM"]).optional(),
+          layoutSizingHorizontal: import_zod4.z.enum(["FIXED", "HUG", "FILL"]).optional(),
+          layoutSizingVertical: import_zod4.z.enum(["FIXED", "HUG", "FILL"]).optional(),
+          textAutoResize: import_zod4.z.enum(["NONE", "WIDTH_AND_HEIGHT", "HEIGHT", "TRUNCATE"]).optional().describe("NONE (fixed box), WIDTH_AND_HEIGHT (grow both), HEIGHT (fixed width, auto height), TRUNCATE (fixed + ellipsis)"),
+          componentPropertyName: import_zod4.z.string().optional().describe("Bind to a component TEXT property by name. Walks up ancestors to find the nearest component, or targets the component specified by componentId. For deeply nested text, consider using components(method:'create', type:'from_node') with exposeText:true instead \u2014 it auto-discovers and binds all text nodes."),
+          componentId: import_zod4.z.string().optional().describe("Target component ID for componentPropertyName binding. When omitted, walks up ancestors to find the nearest COMPONENT or COMPONENT_SET.")
+        }).passthrough();
+        try {
+          params.items = import_zod4.z.array(itemSchema).parse(params.items);
+        } catch (e) {
+          if (e instanceof import_zod4.z.ZodError) {
+            throw new Error(e.issues.map((i) => {
+              const path = i.path.join(".");
+              const shape = itemSchema instanceof import_zod4.z.ZodObject ? itemSchema.shape : null;
+              const desc = shape?.[i.path[1]]?.description;
+              return path + ": " + i.message + (desc ? " (expected: " + desc + ")" : "");
+            }).join("; "));
+          }
+          throw e;
+        }
       }
-    }
-  }
-];
-
-// src/tools/defs/variables.ts
-var import_zod16 = require("zod");
-var collectionCreateItem = import_zod16.z.object({
-  name: import_zod16.z.string().describe("Collection name")
-});
-var addModeItem = import_zod16.z.object({
-  collectionId: import_zod16.z.string().describe("Collection ID"),
-  name: import_zod16.z.string().describe("Mode name")
-});
-var renameModeItem = import_zod16.z.object({
-  collectionId: import_zod16.z.string().describe("Collection ID"),
-  modeId: import_zod16.z.string().describe("Mode ID"),
-  name: import_zod16.z.string().describe("New name")
-});
-var removeModeItem = import_zod16.z.object({
-  collectionId: import_zod16.z.string().describe("Collection ID"),
-  modeId: import_zod16.z.string().describe("Mode ID")
-});
-var deleteCollectionItem = import_zod16.z.object({
-  id: import_zod16.z.string().describe("Collection ID")
-});
-var collectionMethodSchemas = {
-  create: collectionCreateItem,
-  delete: deleteCollectionItem,
-  add_mode: addModeItem,
-  rename_mode: renameModeItem,
-  remove_mode: removeModeItem
-};
-var variableCreateItem = import_zod16.z.object({
-  collectionId: import_zod16.z.string().describe("Variable collection ID"),
-  name: import_zod16.z.string().describe("Variable name"),
-  resolvedType: import_zod16.z.enum(["COLOR", "FLOAT", "STRING", "BOOLEAN"]).describe("Variable type")
-});
-var variableUpdateItem = import_zod16.z.object({
-  id: import_zod16.z.string().describe("Variable ID (full ID, e.g. VariableID:1:6)"),
-  modeId: import_zod16.z.string().describe("Mode ID"),
-  value: flexJson(import_zod16.z.union([
-    import_zod16.z.number(),
-    import_zod16.z.boolean(),
-    colorRgba
-  ])).describe('Value: number, boolean, or color (hex "#RRGGBB" or {r,g,b,a?} 0-1)')
-});
-var variableMethodSchemas = {
-  create: variableCreateItem,
-  update: variableUpdateItem
-};
-var bindingItem = import_zod16.z.object({
-  nodeId: import_zod16.z.string().describe("Node ID"),
-  field: import_zod16.z.string().describe("Property field (e.g., 'opacity', 'fills/0/color')"),
-  variableId: import_zod16.z.string().describe("Variable ID (use full ID from create_variable response, e.g. VariableID:1:6)")
-});
-var setExplicitModeItem = import_zod16.z.object({
-  nodeId,
-  collectionId: import_zod16.z.string().describe("Variable collection ID"),
-  modeId: import_zod16.z.string().describe("Mode ID to pin (e.g. Dark mode)")
-});
-var vcMethodTiers = {
-  add_mode: "create",
-  rename_mode: "edit",
-  remove_mode: "edit"
-};
-var tools14 = [
+      if (m === "set_content") {
+        for (const it of params.items) {
+          if (it.id !== void 0 && it.nodeId === void 0) {
+            it.nodeId = it.id;
+            delete it.id;
+          }
+          if (it.characters !== void 0 && it.text === void 0) {
+            it.text = it.characters;
+            delete it.characters;
+          }
+        }
+        const itemSchema = import_zod4.z.object({
+          nodeId: import_zod4.z.string().describe("Text node ID"),
+          text: import_zod4.z.string().describe("New text content")
+        }).passthrough();
+        try {
+          params.items = import_zod4.z.array(itemSchema).parse(params.items);
+        } catch (e) {
+          if (e instanceof import_zod4.z.ZodError) {
+            throw new Error(e.issues.map((i) => {
+              const path = i.path.join(".");
+              const shape = itemSchema instanceof import_zod4.z.ZodObject ? itemSchema.shape : null;
+              const desc = shape?.[i.path[1]]?.description;
+              return path + ": " + i.message + (desc ? " (expected: " + desc + ")" : "");
+            }).join("; "));
+          }
+          throw e;
+        }
+      }
+    },
+    commandMap: { "get": "text.get", "list": "text.list", "update": "text.update", "delete": "text.delete", "clone": "text.clone", "audit": "text.audit", "reparent": "text.reparent", "create": "text.create", "set_content": "text.set_content", "scan": "text.scan" }
+  },
   {
     name: "variable_collections",
-    description: `CRUD endpoint for variable collections + mode management.
-  create       \u2192 {items: [{name}]}                          \u2192 {results: [{id, modes, defaultModeId}]}
-  get          \u2192 {id, fields?}                              \u2192 collection object
-  list         \u2192 {fields?, offset?, limit?}                 \u2192 paginated stubs
-  delete       \u2192 {id} or {items: [{id}]}                    \u2192 'ok' or {results: ['ok', ...]}
-  add_mode     \u2192 {items: [{collectionId, name}]}            \u2192 {results: [{modeId, modes}]}
-  rename_mode  \u2192 {items: [{collectionId, modeId, name}]}    \u2192 {results: [{modes}]}
-  remove_mode  \u2192 {items: [{collectionId, modeId}]}          \u2192 {results: [{modes}]}`,
-    schema: (caps2) => endpointSchema(
-      ["create", "get", "list", "delete", "add_mode", "rename_mode", "remove_mode"],
-      caps2,
-      {
-        items: flexJson(import_zod16.z.array(import_zod16.z.any())).optional().describe("create: [{name}]. delete (batch): [{id}]. add_mode: [{collectionId, name}]. rename_mode: [{collectionId, modeId, name}]. remove_mode: [{collectionId, modeId}].")
-      },
-      vcMethodTiers
-    ),
+    description: '/** CRUD for variable collections \u2014 the document-level API for design tokens. Use method "help" for detailed parameter docs. */\n  list      (fields?, offset?, limit?) \u2192 { totalCount, items }  // List variable collections\n  get       (id, fields?) \u2192 { id?, name?, modes?, variables? }  // Get collection with all variables and values (full document)\n  create    (items: { name: string; modes?: string[]; variables?: { name: string; type: "COLOR" | "FLOAT" | "STRING" | "BOOLEAN"; value?: number | boolean | string | Color | {type: "VARIABLE_ALIAS", name: string}; valuesByMode?: Record<string, unknown>; description?: string; scopes?: string[] }[] }[]) \u2192 { results: {id}[] }  // Create a collection with modes and variables in one call\n  update    (items: { id: string; name: string }[]) \u2192 { results: ("ok" | {error})[] }  // Rename collections\n  delete    (id?, items?: { id: string }[]) \u2192 { results: "ok"[] }  // Delete collections\n  add_mode  (items: { collectionId: string; name: string }[]) \u2192 { results: {modeId}[] }  // Add a mode to a collection\n  rename_mode(items: { collectionId: string; modeId: string; name: string }[]) \u2192 { results: ("ok" | {error})[] }  // Rename a mode\n  remove_mode(items: { collectionId: string; modeId: string }[]) \u2192 { results: "ok"[] }  // Remove a mode from a collection\n// Variable collections group design tokens and define their modes (e.g. Light/Dark, Desktop/Mobile).\n// All ID params accept both IDs and display names.\n// Shared types:\n// Color: hex "#FF0000" or {r: 0-1, g: 0-1, b: 0-1, a?: 0-1}',
+    schema: (caps2) => filterMethodsByTier({
+      method: import_zod4.z.enum(["list", "get", "create", "update", "delete", "add_mode", "rename_mode", "remove_mode", "help"]),
+      fields: flexJson(import_zod4.z.array(import_zod4.z.string())).optional().describe('Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.'),
+      offset: import_zod4.z.coerce.number().optional().default(0).describe("Skip N items for pagination (default 0)"),
+      limit: import_zod4.z.coerce.number().optional().default(100).describe("Max items per page (default 100)"),
+      id: import_zod4.z.string().optional().describe("Collection ID or name"),
+      items: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).optional().describe("Array of {id, ...properties} to create/update/delete/add_mode/rename_mode/remove_mode"),
+      topic: import_zod4.z.string().optional().describe('Help topic \u2014 method name for endpoint help, e.g. "create"')
+    }, caps2, { "list": "read", "get": "read", "create": "create", "update": "edit", "delete": "edit", "add_mode": "create", "rename_mode": "edit", "remove_mode": "edit", "help": "read" }),
     tier: "read",
     validate: (params) => {
-      if (params.items) {
-        const schema = collectionMethodSchemas[params.method];
-        if (schema) params.items = import_zod16.z.array(schema).parse(params.items);
+      const m = params.method;
+      if (m === "get") {
+        if (params.id === void 0) throw new Error('get requires "id"');
       }
-    }
+      if (!params.items) return;
+      if (m === "create") {
+        const itemSchema = import_zod4.z.object({
+          name: import_zod4.z.string().describe("Collection name"),
+          modes: flexJson(import_zod4.z.array(import_zod4.z.string())).optional().describe("Mode names (e.g. ['Light', 'Dark']). Omit for single-mode collection."),
+          variables: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).optional().describe("Variables to create inside this collection")
+        }).passthrough();
+        try {
+          params.items = import_zod4.z.array(itemSchema).parse(params.items);
+        } catch (e) {
+          if (e instanceof import_zod4.z.ZodError) {
+            throw new Error(e.issues.map((i) => {
+              const path = i.path.join(".");
+              const shape = itemSchema instanceof import_zod4.z.ZodObject ? itemSchema.shape : null;
+              const desc = shape?.[i.path[1]]?.description;
+              return path + ": " + i.message + (desc ? " (expected: " + desc + ")" : "");
+            }).join("; "));
+          }
+          throw e;
+        }
+      }
+      if (m === "update") {
+        const itemSchema = import_zod4.z.object({
+          id: import_zod4.z.string().describe("Collection ID or name"),
+          name: import_zod4.z.string().describe("New name")
+        }).passthrough();
+        try {
+          params.items = import_zod4.z.array(itemSchema).parse(params.items);
+        } catch (e) {
+          if (e instanceof import_zod4.z.ZodError) {
+            throw new Error(e.issues.map((i) => {
+              const path = i.path.join(".");
+              const shape = itemSchema instanceof import_zod4.z.ZodObject ? itemSchema.shape : null;
+              const desc = shape?.[i.path[1]]?.description;
+              return path + ": " + i.message + (desc ? " (expected: " + desc + ")" : "");
+            }).join("; "));
+          }
+          throw e;
+        }
+      }
+      if (m === "delete") {
+        const itemSchema = import_zod4.z.object({
+          id: import_zod4.z.string()
+        }).passthrough();
+        try {
+          params.items = import_zod4.z.array(itemSchema).parse(params.items);
+        } catch (e) {
+          if (e instanceof import_zod4.z.ZodError) {
+            throw new Error(e.issues.map((i) => {
+              const path = i.path.join(".");
+              const shape = itemSchema instanceof import_zod4.z.ZodObject ? itemSchema.shape : null;
+              const desc = shape?.[i.path[1]]?.description;
+              return path + ": " + i.message + (desc ? " (expected: " + desc + ")" : "");
+            }).join("; "));
+          }
+          throw e;
+        }
+      }
+      if (m === "add_mode") {
+        const itemSchema = import_zod4.z.object({
+          collectionId: import_zod4.z.string().describe("Collection ID or name"),
+          name: import_zod4.z.string().describe("Mode name")
+        }).passthrough();
+        try {
+          params.items = import_zod4.z.array(itemSchema).parse(params.items);
+        } catch (e) {
+          if (e instanceof import_zod4.z.ZodError) {
+            throw new Error(e.issues.map((i) => {
+              const path = i.path.join(".");
+              const shape = itemSchema instanceof import_zod4.z.ZodObject ? itemSchema.shape : null;
+              const desc = shape?.[i.path[1]]?.description;
+              return path + ": " + i.message + (desc ? " (expected: " + desc + ")" : "");
+            }).join("; "));
+          }
+          throw e;
+        }
+      }
+      if (m === "rename_mode") {
+        const itemSchema = import_zod4.z.object({
+          collectionId: import_zod4.z.string().describe("Collection ID or name"),
+          modeId: import_zod4.z.string().describe('Mode ID or name (e.g. "Dark")'),
+          name: import_zod4.z.string().describe("New name")
+        }).passthrough();
+        try {
+          params.items = import_zod4.z.array(itemSchema).parse(params.items);
+        } catch (e) {
+          if (e instanceof import_zod4.z.ZodError) {
+            throw new Error(e.issues.map((i) => {
+              const path = i.path.join(".");
+              const shape = itemSchema instanceof import_zod4.z.ZodObject ? itemSchema.shape : null;
+              const desc = shape?.[i.path[1]]?.description;
+              return path + ": " + i.message + (desc ? " (expected: " + desc + ")" : "");
+            }).join("; "));
+          }
+          throw e;
+        }
+      }
+      if (m === "remove_mode") {
+        const itemSchema = import_zod4.z.object({
+          collectionId: import_zod4.z.string().describe("Collection ID or name"),
+          modeId: import_zod4.z.string().describe('Mode ID or name (e.g. "Dark")')
+        }).passthrough();
+        try {
+          params.items = import_zod4.z.array(itemSchema).parse(params.items);
+        } catch (e) {
+          if (e instanceof import_zod4.z.ZodError) {
+            throw new Error(e.issues.map((i) => {
+              const path = i.path.join(".");
+              const shape = itemSchema instanceof import_zod4.z.ZodObject ? itemSchema.shape : null;
+              const desc = shape?.[i.path[1]]?.description;
+              return path + ": " + i.message + (desc ? " (expected: " + desc + ")" : "");
+            }).join("; "));
+          }
+          throw e;
+        }
+      }
+    },
+    commandMap: { "list": "variable_collections.list", "get": "variable_collections.get", "create": "variable_collections.create", "update": "variable_collections.update", "delete": "variable_collections.delete", "add_mode": "variable_collections.add_mode", "rename_mode": "variable_collections.rename_mode", "remove_mode": "variable_collections.remove_mode" }
   },
   {
     name: "variables",
-    description: `CRUD endpoint for design variables.
-  create  \u2192 {items: [{collectionId, name, resolvedType}]}   \u2192 {results: [{id}]}
-  get     \u2192 {id, fields?}                                   \u2192 variable object (full detail)
-  list    \u2192 {type?, collectionId?, fields?, offset?, limit?} \u2192 paginated stubs (fields for detail)
-  update  \u2192 {items: [{id, modeId, value}]}                  \u2192 {results: ['ok', ...]}`,
-    schema: (caps2) => endpointSchema(
-      ["create", "get", "list", "update"],
-      caps2,
-      {
-        items: flexJson(import_zod16.z.array(import_zod16.z.any())).optional().describe("create: [{collectionId, name, resolvedType}]. update: [{id, modeId, value}]."),
-        type: import_zod16.z.enum(["COLOR", "FLOAT", "STRING", "BOOLEAN"]).optional().describe("Filter list by variable type."),
-        collectionId: import_zod16.z.string().optional().describe("Filter list by collection ID.")
+    description: '/** Search and update design variables within a collection. Use method "help" for detailed parameter docs. */\n  list      (collectionId, query?, type?: COLOR|FLOAT|STRING|BOOLEAN, fields?, offset?, limit?) \u2192 { totalCount, items }  // Search variables within a collection\n  get       (name, collectionId, fields?) \u2192 { name, type, collectionId, valuesByMode: Record<string, number | boolean | string | Color | {type: "VARIABLE_ALIAS", name: string}>, description?, scopes? }  // Get variable detail by name\n  create    (collectionId, items: VariableCreateItem[]) \u2192 { results: {name}[] }  // Create variables in a collection. Use valuesByMode for multi-mode, or value for default mode only.\n  update    (collectionId, items: VariableUpdateItem[]) \u2192 { results: ("ok" | {error})[] }  // Update variable metadata and/or set values\n  delete    (collectionId, name?, items?: { name: string }[]) \u2192 { results: "ok"[] }  // Delete variables\n// Search and update variables within a collection. collectionId is required on all methods.\n// Use variable_collections to create full token sets (collection + modes + variables in one call).\n// Shared types:\n// Color: hex "#FF0000" or {r: 0-1, g: 0-1, b: 0-1, a?: 0-1}',
+    schema: (caps2) => filterMethodsByTier({
+      method: import_zod4.z.enum(["list", "get", "create", "update", "delete", "help"]),
+      collectionId: import_zod4.z.string().optional().describe("Collection ID or name"),
+      query: import_zod4.z.string().optional().describe("Search query \u2014 prefix match first, then substring fallback"),
+      type: import_zod4.z.enum(["COLOR", "FLOAT", "STRING", "BOOLEAN"]).optional().describe("Filter by variable type"),
+      fields: flexJson(import_zod4.z.array(import_zod4.z.string())).optional().describe('Property whitelist. Identity fields (id, name, type) always included. Omit for stubs on list, full on get. Pass ["*"] for all.'),
+      offset: import_zod4.z.coerce.number().optional().default(0).describe("Skip N items for pagination (default 0)"),
+      limit: import_zod4.z.coerce.number().optional().default(100).describe("Max items per page (default 100)"),
+      name: import_zod4.z.string().optional().describe("Variable name (unique within collection)"),
+      items: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).optional().describe("Array of {id, ...properties} to create/update/delete"),
+      topic: import_zod4.z.string().optional().describe('Help topic \u2014 method name for endpoint help, e.g. "create"')
+    }, caps2, { "list": "read", "get": "read", "create": "create", "update": "edit", "delete": "edit", "help": "read" }),
+    tier: "read",
+    validate: (params) => {
+      const m = params.method;
+      if (m === "list") {
+        if (params.collectionId === void 0) throw new Error('list requires "collectionId"');
+      }
+      if (m === "get") {
+        if (params.name === void 0) throw new Error('get requires "name"');
+        if (params.collectionId === void 0) throw new Error('get requires "collectionId"');
+      }
+      if (m === "create") {
+        if (params.collectionId === void 0) throw new Error('create requires "collectionId"');
+      }
+      if (m === "update") {
+        if (params.collectionId === void 0) throw new Error('update requires "collectionId"');
+      }
+      if (m === "delete") {
+        if (params.collectionId === void 0) throw new Error('delete requires "collectionId"');
+      }
+      if (!params.items) return;
+      if (m === "create") {
+        const itemSchema = import_zod4.z.object({
+          name: import_zod4.z.string().describe("Variable name (must be unique within collection)"),
+          type: import_zod4.z.enum(["COLOR", "FLOAT", "STRING", "BOOLEAN"]).describe("Variable type"),
+          value: variableValue.optional().describe("Shorthand \u2014 sets the default mode value. Use valuesByMode for multi-mode."),
+          valuesByMode: import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()).optional().describe('Values keyed by mode name (e.g. {"Light": "#FFF", "Dark": "#111"}). Takes precedence over value.'),
+          description: import_zod4.z.string().optional().describe("Variable description"),
+          scopes: flexJson(import_zod4.z.array(import_zod4.z.string())).optional().describe("Restrict where variable can be applied (default: ALL_SCOPES)")
+        }).passthrough();
+        try {
+          params.items = import_zod4.z.array(itemSchema).parse(params.items);
+        } catch (e) {
+          if (e instanceof import_zod4.z.ZodError) {
+            throw new Error(e.issues.map((i) => {
+              const path = i.path.join(".");
+              const shape = itemSchema instanceof import_zod4.z.ZodObject ? itemSchema.shape : null;
+              const desc = shape?.[i.path[1]]?.description;
+              return path + ": " + i.message + (desc ? " (expected: " + desc + ")" : "");
+            }).join("; "));
+          }
+          throw e;
+        }
+      }
+      if (m === "update") {
+        const itemSchema = import_zod4.z.object({
+          name: import_zod4.z.string().describe("Variable name"),
+          rename: import_zod4.z.string().optional().describe("Rename the variable"),
+          description: import_zod4.z.string().optional().describe("Set description"),
+          scopes: flexJson(import_zod4.z.array(import_zod4.z.string())).optional().describe("Update scopes"),
+          value: variableValue.optional().describe("Shorthand \u2014 sets the default mode value. Use valuesByMode for multi-mode."),
+          valuesByMode: import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()).optional().describe("Values keyed by mode name. Takes precedence over value.")
+        }).passthrough();
+        try {
+          params.items = import_zod4.z.array(itemSchema).parse(params.items);
+        } catch (e) {
+          if (e instanceof import_zod4.z.ZodError) {
+            throw new Error(e.issues.map((i) => {
+              const path = i.path.join(".");
+              const shape = itemSchema instanceof import_zod4.z.ZodObject ? itemSchema.shape : null;
+              const desc = shape?.[i.path[1]]?.description;
+              return path + ": " + i.message + (desc ? " (expected: " + desc + ")" : "");
+            }).join("; "));
+          }
+          throw e;
+        }
+      }
+      if (m === "delete") {
+        const itemSchema = import_zod4.z.object({
+          name: import_zod4.z.string()
+        }).passthrough();
+        try {
+          params.items = import_zod4.z.array(itemSchema).parse(params.items);
+        } catch (e) {
+          if (e instanceof import_zod4.z.ZodError) {
+            throw new Error(e.issues.map((i) => {
+              const path = i.path.join(".");
+              const shape = itemSchema instanceof import_zod4.z.ZodObject ? itemSchema.shape : null;
+              const desc = shape?.[i.path[1]]?.description;
+              return path + ": " + i.message + (desc ? " (expected: " + desc + ")" : "");
+            }).join("; "));
+          }
+          throw e;
+        }
       }
-    ),
+    },
+    commandMap: { "list": "variables.list", "get": "variables.get", "create": "variables.create", "update": "variables.update", "delete": "variables.delete" }
+  },
+  {
+    name: "version_history",
+    description: `/** Save named versions to the Figma file's version history. Use method "help" for detailed parameter docs. */
+  save      (title, description?) \u2192 { id }  // Save a named version to the file's version history
+// Version history lets you create named snapshots of a Figma file.
+// Use this after completing design tasks to create an audit trail of changes.
+// Equivalent to Figma's File \u2192 Save to Version History (Cmd+Opt+S).`,
+    schema: (caps2) => filterMethodsByTier({
+      method: import_zod4.z.enum(["save", "help"]),
+      title: import_zod4.z.string().optional().describe('Version title (e.g., "Added hero sections with website copy")'),
+      description: import_zod4.z.string().optional().describe("Optional longer description of what changed"),
+      topic: import_zod4.z.string().optional().describe('Help topic \u2014 method name for endpoint help, e.g. "create"')
+    }, caps2, { "save": "edit", "help": "read" }),
     tier: "read",
     validate: (params) => {
-      if (params.items) {
-        const schema = variableMethodSchemas[params.method];
-        if (schema) params.items = import_zod16.z.array(schema).parse(params.items);
+      const m = params.method;
+      if (m === "save") {
+        if (params.title === void 0) throw new Error('save requires "title"');
       }
-    }
+    },
+    commandMap: { "save": "version_history.save" }
+  }
+];
+
+// src/tools/generated/guidelines.ts
+var guidelinesList = [
+  {
+    "name": "component-structure",
+    "title": "Component Structure"
   },
   {
-    name: "set_variable_binding",
-    description: "Bind variables to node properties. Common fields: 'fills/0/color', 'strokes/0/color', 'opacity', 'topLeftRadius', 'itemSpacing'. Batch: pass multiple items.",
-    schema: { items: flexJson(import_zod16.z.array(bindingItem)).describe("Array of {nodeId, field, variableId}") },
-    tier: "edit"
+    "name": "library-components",
+    "title": "Working with Library Components"
   },
   {
-    name: "set_explicit_variable_mode",
-    description: "Pin a variable collection mode on a frame (e.g. show Dark mode). Batch: pass multiple items.",
-    schema: { items: flexJson(import_zod16.z.array(setExplicitModeItem)).describe("Array of {nodeId, collectionId, modeId}") },
-    tier: "edit"
+    "name": "responsive-designs",
+    "title": "Responsive Sizing"
   },
   {
-    name: "get_node_variables",
-    description: "Get variable bindings on a node. Returns which variables are bound to fills, strokes, opacity, corner radius, etc.",
-    schema: { nodeId },
-    tier: "read"
+    "name": "token-discipline",
+    "title": "Token Discipline"
+  },
+  {
+    "name": "vibma-workflow",
+    "title": "Vibma Workflow"
   }
 ];
-
-// src/tools/defs/components.ts
-var import_zod17 = require("zod");
-var componentItem = import_zod17.z.object({
-  name: import_zod17.z.string().describe("Component name"),
-  x: xPos,
-  y: yPos,
-  width: import_zod17.z.coerce.number().optional().describe("Width (default: 100)"),
-  height: import_zod17.z.coerce.number().optional().describe("Height (default: 100)"),
-  parentId,
-  fillColor: flexJson(colorRgba).optional().describe("Fill color. Omit for no fill."),
-  fillStyleName: import_zod17.z.string().optional().describe("Apply a fill paint style by name (case-insensitive)."),
-  fillVariableId: import_zod17.z.string().optional().describe("Bind a color variable to the fill."),
-  strokeColor: flexJson(colorRgba).optional().describe("Stroke color. Omit for no stroke."),
-  strokeStyleName: import_zod17.z.string().optional().describe("Apply a stroke paint style by name."),
-  strokeVariableId: import_zod17.z.string().optional().describe("Bind a color variable to the stroke."),
-  strokeWeight: import_zod17.z.coerce.number().positive().optional().describe("Stroke weight (default: 1)"),
-  cornerRadius: import_zod17.z.coerce.number().optional().describe("Corner radius (default: 0)"),
-  layoutMode: import_zod17.z.enum(["NONE", "HORIZONTAL", "VERTICAL"]).optional().describe("Layout direction (default: NONE)"),
-  layoutWrap: import_zod17.z.enum(["NO_WRAP", "WRAP"]).optional().describe("Wrap behavior (default: NO_WRAP)"),
-  paddingTop: import_zod17.z.coerce.number().optional().describe("Top padding (default: 0)"),
-  paddingRight: import_zod17.z.coerce.number().optional().describe("Right padding (default: 0)"),
-  paddingBottom: import_zod17.z.coerce.number().optional().describe("Bottom padding (default: 0)"),
-  paddingLeft: import_zod17.z.coerce.number().optional().describe("Left padding (default: 0)"),
-  primaryAxisAlignItems: import_zod17.z.enum(["MIN", "MAX", "CENTER", "SPACE_BETWEEN"]).optional().describe("Primary axis alignment (default: MIN)"),
-  counterAxisAlignItems: import_zod17.z.enum(["MIN", "MAX", "CENTER", "BASELINE"]).optional().describe("Counter axis alignment (default: MIN)"),
-  layoutSizingHorizontal: import_zod17.z.enum(["FIXED", "HUG", "FILL"]).optional().describe("Horizontal sizing (default: FIXED)"),
-  layoutSizingVertical: import_zod17.z.enum(["FIXED", "HUG", "FILL"]).optional().describe("Vertical sizing (default: FIXED)"),
-  itemSpacing: import_zod17.z.coerce.number().optional().describe("Spacing between children (default: 0)")
-});
-var fromNodeItem = import_zod17.z.object({
-  nodeId,
-  exposeText: flexBool(import_zod17.z.boolean()).default(true).describe("Auto-expose text children as editable TEXT properties and bind them (default: true). Set false to skip.")
-});
-var combineItem = import_zod17.z.object({
-  componentIds: flexJson(import_zod17.z.array(import_zod17.z.string())).describe("Component IDs to combine (min 2)"),
-  name: import_zod17.z.string().optional().describe("Name for the component set. Omit to auto-generate.")
-});
-var updateComponentItem = import_zod17.z.object({
-  id: import_zod17.z.string().describe("Component node ID"),
-  propertyName: import_zod17.z.string().describe("Property name"),
-  type: import_zod17.z.enum(["BOOLEAN", "TEXT", "INSTANCE_SWAP", "VARIANT"]).describe("Property type"),
-  defaultValue: flexBool(import_zod17.z.union([import_zod17.z.string(), import_zod17.z.boolean()])).describe("Default value (string for TEXT/VARIANT, boolean for BOOLEAN)"),
-  preferredValues: flexJson(import_zod17.z.array(import_zod17.z.object({
-    type: import_zod17.z.enum(["COMPONENT", "COMPONENT_SET"]),
-    key: import_zod17.z.string()
-  })).optional()).describe("Preferred values for INSTANCE_SWAP type. Omit for none.")
-});
-var componentCreateSchemas = {
-  component: componentItem,
-  from_node: fromNodeItem,
-  variant_set: combineItem
+var guidelinesContent = {
+  "component-structure": '# Component Structure\n\nComponents need correct sizing, property bindings, and token usage to work well as instances.\n\n## Width Constraints\n\nComponents with text content need a width \u2014 otherwise text never wraps.\n\n- Set `width` and `layoutSizingHorizontal:"FIXED"` on cards, panels, list items\n- HUG on both axes is only correct for buttons, badges, icons \u2014 intrinsically-sized elements\n\n## Property Bindings\n\nEvery text node inside a component should be bound to a TEXT property so instances can edit the content.\n\n- On creation: `children:[{type:"text", text:"Title", componentPropertyName:"Title"}]` auto-creates and binds\n- After creation: `frames(method:"update", items:[{id:"<textNodeId>", componentPropertyName:"<propName>"}])`\n- For existing nodes with many text children: `components(method:"create", type:"from_node", exposeText:true)`\n\nOrphaned properties (defined but not bound to any node) should be deleted:\n```\ncomponents(method:"update", items:[{id, propertyName:"<key>", action:"delete"}])\n```\n\n## Variant Sets\n\nGroup related components as variants \u2014 don\'t leave them as separate components.\n\n- Name variants with the property format: `Style=Primary`, `Style=Secondary`\n- Combine: `components(method:"create", type:"variant_set", items:[{componentIds:[...], name:"Button"}])`\n- Instances pick variants via `variantProperties:{"Style":"Primary"}`\n\n## Checking\n\nRun `components(method:"audit", id)` \u2014 checks both lint rules and property bindings in one call.',
+  "library-components": '# Working with Library Components\n\nLibrary components are read-only \u2014 they come from external team libraries and cannot be edited in the current file.\n\n## Reading\n\nWhen reading nodes, library instances appear as stubs with their overridable properties:\n```\n{name: "Header", type: "INSTANCE", componentProperties: {"Platform": "Desktop"}}\n```\n\nLibrary internals are hidden: no `componentId`, no variable names, no style names. You see resolved values (hex colors, numbers) instead.\n\n## Using\n\nPlace library instances via `instances(method:"create", items:[{componentId:"<id>"}])` when you have a local component ID. For library components, instances are already placed by the designer \u2014 interact via `instances(method:"update")` to set properties.\n\n## Customizing\n\nTo edit a library component, clone it into the local file first:\n\n```\ncomponents(method:"clone", id:"<instanceId>")\n```\n\nThis resolves the instance to its source component (or full component set) and creates a local copy with a new ID. Edit the local copy freely \u2014 it is independent of the library.\n\nDo not attempt to `components(method:"get")` or `components(method:"update")` a library component directly \u2014 these will error.\n\n## Overriding Instance Properties\n\nUse `instances(method:"update")` to change overridable properties on library instances:\n```\ninstances(method:"update", items:[{id:"<instanceId>", properties:{"Label":"New Text", "State":"Hover"}}])\n```\n\nProperty names are clean (no hash suffixes needed for update \u2014 the system resolves partial keys).',
+  "responsive-designs": "# Responsive Sizing\n\n## FIXED / FILL / HUG\n\n- **FIXED** \u2014 layout boundaries: page shell, sidebar width, modal max-width\n- **FILL** \u2014 children that adapt to parent: main content area, nav stacks, cards in columns, text that should wrap\n- **HUG** \u2014 content-sized leaves only: icons, badges, pills, button labels\n\n## Component Sizing\n\nComponent roots use `FILL` when placed in a parent \u2014 they adapt to context, not a fixed specimen width.\n\nExample sidebar item:\n- Instance: `FILL` in parent nav stack\n- Icon child: fixed 18x18\n- Label child: `FILL`\n- Badge child: `HUG`\n\n## Text Sizing\n\n- Body text inside containers: `FILL` width, `HUG` height (auto-wraps)\n- Single-line labels: `FILL` horizontal (truncates if needed)\n- Standalone headings: `HUG` is fine\n\nInside auto-layout parents, text defaults to `FILL` horizontal + `HUG` vertical + `textAutoResize: HEIGHT`.",
+  "token-discipline": '# Token Discipline\n\nEvery color, spacing value, and text style should come from a design token \u2014 not hardcoded values.\n\n## Colors\n\nBind fills and strokes to color variables instead of hex values.\n\n- Fill: `fillVariableName:"bg/primary"` or `fillStyleName:"Surface/Primary"`\n- Stroke: `strokeVariableName:"border/default"`\n- Text color: `fontColorVariableName:"text/primary"`\n\nIf no matching variable exists, create one first:\n```\nvariables(method:"create", collectionId:"Colors", items:[{name:"bg/accent", type:"COLOR", valuesByMode:{"Light":"#E8F0FE","Dark":"#1A3A5C"}, scopes:["ALL_FILLS"]}])\n```\n\n## Spacing and Radius\n\nPass a variable name string instead of a number for cornerRadius, padding, itemSpacing, strokeWeight, opacity.\n\n- `cornerRadius:"radius/8"` not `cornerRadius:8`\n- `paddingTop:"space/16"` not `paddingTop:16`\n- `itemSpacing:"space/8"` not `itemSpacing:8`\n\nCreate FLOAT variables with appropriate scopes:\n```\nvariables(method:"create", collectionId:"Metrics", items:[{name:"space/12", type:"FLOAT", value:12, scopes:["GAP","WIDTH_HEIGHT"]}])\n```\n\n## Text Styles\n\nApply text styles by name \u2014 don\'t set fontSize/fontFamily/fontWeight manually.\n\n- `textStyleName:"Body/M"` on text.create or frames.update\n- Create styles with `styles(method:"create", type:"text", items:[{name:"Body/M", fontFamily:"Inter", fontSize:14, lineHeight:{value:20, unit:"PIXELS"}}])`\n\n## Common Scopes\n\nCOLOR variables:\n- `ALL_FILLS` \u2014 background fills\n- `TEXT_FILL` \u2014 text color\n- `STROKE_COLOR` \u2014 borders and outlines\n\nFLOAT variables:\n- `GAP`, `WIDTH_HEIGHT` \u2014 spacing and padding\n- `CORNER_RADIUS` \u2014 border radius\n- `STROKE_FLOAT` \u2014 stroke weight\n- `OPACITY` \u2014 transparency\n\n## Checking\n\nLint rules `hardcoded-color`, `hardcoded-token`, `no-text-style` catch unbound values. Run `audit` on any node to check.',
+  "vibma-workflow": '# Vibma Workflow\n\nWork with the tool in a predictable sequence: read before writing, create parents before children, verify after mutations.\n\n## Build Order\n\n1. `connection.create` \u2192 `connection.get` to verify\n2. Inspect existing structure: `document.get`, `variables.list`, `styles.list`, `components.list`\n3. Create design tokens: variable collections \u2192 variables \u2192 text styles \u2192 effect styles\n4. Create components from tokens\n5. Assemble screens from component instances\n6. Verify with `lint.check` and `frames.export`\n\n## Parent-First Rule\n\nCreate parent containers before children. Dependent creates must be sequential \u2014 never parallelize when the child needs the parent ID.\n\n## Component Creation\n\nBuild components early \u2014 they are the building blocks for screens. A component IS a frame: create it directly with layout properties, then add children.\n\n- Use `components.create(type: "component")` with properties for TEXT, BOOLEAN, INSTANCE_SWAP\n- TEXT properties auto-bind to child text nodes with matching names\n- Group related components into variant sets with `components.create(type: "variant_set")` for state dimensions (Style, Size, State)\n- Use flat components (not variant sets) for INSTANCE_SWAP slots like icons or avatars\n- Assemble screens from `instances.create`, not by cloning frames\n\n## Placement Rule\n\nAlways pass `x` and `y` for top-level nodes and clones. Do not stack everything at `0,0`.\n\n## Instance Rule\n\nCall `components.get` or `instances.get` to discover property keys (including `#suffix`) before setting overrides. Do not guess property names.\n\n## Verify After Mutations\n\n`"ok"` means the write succeeded, not that the result is correct. Read back the node after clone, swap, mode pinning, or large batch updates.'
 };
-var instanceCreateItem = import_zod17.z.object({
-  componentId: import_zod17.z.string().describe("Component or component set ID"),
-  variantProperties: flexJson(import_zod17.z.record(import_zod17.z.string(), import_zod17.z.string())).optional().describe('Pick variant by properties, e.g. {"Style":"Secondary","Size":"Large"}. Ignored for plain COMPONENT IDs.'),
-  x: import_zod17.z.coerce.number().optional().describe("X position. Omit to keep default."),
-  y: import_zod17.z.coerce.number().optional().describe("Y position. Omit to keep default."),
-  parentId
-});
-var instanceUpdateItem = import_zod17.z.object({
-  id: nodeId,
-  properties: flexJson(import_zod17.z.record(import_zod17.z.string(), import_zod17.z.union([import_zod17.z.string(), import_zod17.z.boolean()]))).describe('Property key\u2192value map, e.g. {"Label#1:0":"Click Me"}')
-});
-var tools15 = [
-  {
-    name: "components",
-    description: `CRUD endpoint for components.
-  create  \u2192 {type, items, depth?} \u2192 {results: [{id}, ...]}
-    type 'component': create from scratch with layout/style params
-    type 'from_node': convert existing nodes to components. Text children are auto-exposed as editable properties by default (exposeText: true) \u2014 instances can set text directly via properties.
-    type 'variant_set': combine components into variant sets
-  get     \u2192 {id, fields?} \u2192 component object (full detail, field-filterable)
-  list    \u2192 {name?, setsOnly?, fields?, offset?, limit?} \u2192 paginated stubs
-  update  \u2192 {items: [{id, propertyName, type, defaultValue}]} \u2192 creates property AND binds matching text node automatically`,
-    schema: (caps2) => endpointSchema(
-      ["create", "get", "list", "update"],
-      caps2,
-      {
-        items: flexJson(import_zod17.z.array(import_zod17.z.any())).optional().describe("create (component): [{name, parentId?, ...layout}]. create (from_node): [{nodeId, exposeText?}]. create (variant_set): [{componentIds, name?}]. update: [{id, propertyName, type, defaultValue}]."),
-        type: import_zod17.z.enum(["component", "from_node", "variant_set"]).optional().describe("Create type. Required for create: 'component' (from scratch), 'from_node' (convert existing), 'variant_set' (combine as variants)."),
-        depth,
-        name: import_zod17.z.string().optional().describe("Filter list by name (case-insensitive substring)."),
-        setsOnly: flexBool(import_zod17.z.boolean()).optional().describe("If true, list returns only COMPONENT_SET nodes.")
-      }
-    ),
-    tier: "read",
-    validate: (params) => {
-      if (params.items) {
-        if (params.method === "create") {
-          const schema = params.type && componentCreateSchemas[params.type];
-          if (!schema) throw new Error(`create requires type: component, from_node, or variant_set`);
-          params.items = import_zod17.z.array(schema).parse(params.items);
-        } else if (params.method === "update") {
-          params.items = import_zod17.z.array(updateComponentItem).parse(params.items);
-        }
-      }
-    }
-  },
-  {
-    name: "instances",
-    description: `CRUD endpoint for component instances.
-  create  \u2192 {items: [{componentId, variantProperties?, x?, y?, parentId?}], depth?} \u2192 {results: [{id}]}
-  get     \u2192 {id} \u2192 {mainComponentId, overrides: [{id, fields}]}
-  update  \u2192 {items: [{id, properties}]} \u2192 {results: ['ok', ...]}`,
-    schema: (caps2) => endpointSchema(
-      ["create", "get", "update"],
-      caps2,
-      {
-        items: flexJson(import_zod17.z.array(import_zod17.z.any())).optional().describe("create: [{componentId, variantProperties?, x?, y?, parentId?}]. update: [{id, properties}]."),
-        depth
-      }
-    ),
-    tier: "read",
-    validate: (params) => {
-      if (params.items) {
-        if (params.method === "create") {
-          params.items = import_zod17.z.array(instanceCreateItem).parse(params.items);
-        } else if (params.method === "update") {
-          params.items = import_zod17.z.array(instanceUpdateItem).parse(params.items);
-        }
-      }
+function resolveGuideline(topic) {
+  if (!topic) {
+    const dir = ["# Design Guidelines", ""];
+    for (const g of guidelinesList) {
+      dir.push("  " + g.name.padEnd(30) + g.title);
     }
+    dir.push("");
+    dir.push('Use guidelines(topic: "<name>") for full guideline text.');
+    return dir.join("\n");
   }
-];
+  const content = guidelinesContent[topic];
+  if (content) return content;
+  const names = guidelinesList.map((g) => g.name);
+  return "Unknown guideline: " + topic + ". Available: " + names.join(", ");
+}
 
 // src/tools/prompts.ts
 function registerPrompts(server2) {
@@ -1012,41 +2504,26 @@ function registerPrompts(server2) {
         role: "assistant",
         content: {
           type: "text",
-          text: `When working with Figma designs, follow these best practices:
+          text: `Figma design best practices:
 
-1. Understand Before Creating:
-   - Use get_document_info() to see pages and current page
-   - Use styles(method: "list") and get_local_variables() to discover existing design tokens
-   - Plan layout hierarchy before creating elements
+1. Discover First: document(method:"list"), styles(method:"list"), variables(method:"list") \u2014 know what exists before creating.
 
-2. Use Design Tokens \u2014 Never Hardcode:
-   - Colors: use fillStyleName/strokeStyleName (paint styles) or fillVariableId/strokeVariableId (variables)
-   - Text: use textStyleName to apply text styles that control font size, weight, and line height together
-   - Effects: use effectStyleName to apply shadow/blur styles
-   - Only use raw fillColor/fontColor for one-off values not in the design system
+2. Design Tokens \u2014 Never Hardcode Colors:
+   - Use fillStyleName/strokeStyleName (paint styles) or fillVariableName/strokeVariableName (variables)
+   - Use textStyleName for typography. Only use raw fillColor/fontColor for one-off values.
 
 3. Auto-Layout First:
-   - Use create_frame() with layoutMode: "VERTICAL" or "HORIZONTAL" for every container
-   - Set itemSpacing, padding, and alignment at creation time
-   - Use layoutSizingHorizontal/Vertical: "FILL" for responsive children
-   - Avoid absolute positioning \u2014 let auto-layout handle spacing
-
-4. Naming Conventions:
-   - Use descriptive, semantic names for all elements
-   - Name components with Property=Value pattern (e.g. "Size=Small") before components(method: "create", type: "variant_set")
-
-5. Variable Modes:
-   - Use set_explicit_variable_mode() to pin a frame to a specific mode (e.g. Dark)
-   - Use get_node_variables() to verify which variables are bound to a node
-
-6. Quality Check \u2014 Run Lint:
-   - After building a section, run lint_node() to catch common issues:
-     * hardcoded-color: fills/strokes not using styles or variables
-     * no-text-style: text without a text style applied
-     * no-autolayout: frames with children but no auto-layout
-     * default-name: nodes still named "Frame", "Rectangle", etc.
-   - Use lint_fix_autolayout() to auto-fix layout issues
-   - Lint early and often \u2014 it is cheaper to fix issues during creation than after`
+   - frames(method:"create", type:"auto_layout") for containers, components(method:"create", type:"component") for reusable elements.
+   - A component IS a frame \u2014 create it directly with layout/fill/stroke params, then add children. No need to create a frame first and convert.
+   - layoutSizingHorizontal/Vertical: "FILL" for responsive children, "HUG" to shrink-wrap.
+
+4. Naming: descriptive names for all elements. Property=Value pattern (e.g. "Size=Small") for variant components.
+
+5. Lint After Every Section:
+   - Run lint(method:"check") after building. Always attempt to fix warnings unless you understand the specific warning and it's intentional.
+   - Each warning includes a fix instruction with the exact tool call to use \u2014 follow it.
+   - Use lint(method:"fix") to auto-convert frames to auto-layout.
+   - Lint early and often \u2014 cheaper to fix during creation than after.`
         }
       }],
       description: "Best practices for working with Figma designs"
@@ -1060,12 +2537,7 @@ function registerPrompts(server2) {
         role: "assistant",
         content: {
           type: "text",
-          text: `When reading Figma designs, follow these best practices:
-
-1. Start with selection:
-   - First use get_selection() to understand the current selection
-   - If no selection ask user to select single or multiple nodes
-`
+          text: 'When reading Figma designs, follow these best practices:\n\n1. Start with selection:\n   - First use selection(method: "get") to understand the current selection\n   - If no selection ask user to select single or multiple nodes'
         }
       }],
       description: "Best practices for reading Figma designs"
@@ -1079,120 +2551,7 @@ function registerPrompts(server2) {
         role: "assistant",
         content: {
           type: "text",
-          text: `# Intelligent Text Replacement Strategy
-
-## 1. Analyze Design & Identify Structure
-- Scan text nodes to understand the overall structure of the design
-- Use AI pattern recognition to identify logical groupings:
-  * Tables (rows, columns, headers, cells)
-  * Lists (items, headers, nested lists)
-  * Card groups (similar cards with recurring text fields)
-  * Forms (labels, input fields, validation text)
-  * Navigation (menu items, breadcrumbs)
-\`\`\`
-scan_text_nodes(nodeId: "node-id")
-get_node_info(nodeId: "node-id")  // optional
-\`\`\`
-
-## 2. Strategic Chunking for Complex Designs
-- Divide replacement tasks into logical content chunks based on design structure
-- Use one of these chunking strategies that best fits the design:
-  * **Structural Chunking**: Table rows/columns, list sections, card groups
-  * **Spatial Chunking**: Top-to-bottom, left-to-right in screen areas
-  * **Semantic Chunking**: Content related to the same topic or functionality
-  * **Component-Based Chunking**: Process similar component instances together
-
-## 3. Progressive Replacement with Verification
-- Create a safe copy of the node for text replacement
-- Replace text chunk by chunk with continuous progress updates
-- After each chunk is processed:
-  * Export that section as a small, manageable image
-  * Verify text fits properly and maintain design integrity
-  * Fix issues before proceeding to the next chunk
-
-\`\`\`
-// Clone the node to create a safe copy
-clone_node(nodeId: "selected-node-id", x: [new-x], y: [new-y])
-
-// Replace text chunk by chunk
-set_text_content(
-  items: [
-    { nodeId: "node-id-1", text: "New text 1" },
-    // More nodes in this chunk...
-  ]
-)
-
-// Verify chunk with small, targeted image exports
-export_node_as_image(nodeId: "chunk-node-id", format: "PNG", scale: 0.5)
-\`\`\`
-
-## 4. Intelligent Handling for Table Data
-- For tabular content:
-  * Process one row or column at a time
-  * Maintain alignment and spacing between cells
-  * Consider conditional formatting based on cell content
-  * Preserve header/data relationships
-
-## 5. Smart Text Adaptation
-- Adaptively handle text based on container constraints:
-  * Auto-detect space constraints and adjust text length
-  * Apply line breaks at appropriate linguistic points
-  * Maintain text hierarchy and emphasis
-  * Consider font scaling for critical content that must fit
-
-## 6. Progressive Feedback Loop
-- Establish a continuous feedback loop during replacement:
-  * Real-time progress updates (0-100%)
-  * Small image exports after each chunk for verification
-  * Issues identified early and resolved incrementally
-  * Quick adjustments applied to subsequent chunks
-
-## 7. Final Verification & Context-Aware QA
-- After all chunks are processed:
-  * Export the entire design at reduced scale for final verification
-  * Check for cross-chunk consistency issues
-  * Verify proper text flow between different sections
-  * Ensure design harmony across the full composition
-
-## 8. Chunk-Specific Export Scale Guidelines
-- Scale exports appropriately based on chunk size:
-  * Small chunks (1-5 elements): scale 1.0
-  * Medium chunks (6-20 elements): scale 0.7
-  * Large chunks (21-50 elements): scale 0.5
-  * Very large chunks (50+ elements): scale 0.3
-  * Full design verification: scale 0.2
-
-## Sample Chunking Strategy for Common Design Types
-
-### Tables
-- Process by logical rows (5-10 rows per chunk)
-- Alternative: Process by column for columnar analysis
-- Tip: Always include header row in first chunk for reference
-
-### Card Lists
-- Group 3-5 similar cards per chunk
-- Process entire cards to maintain internal consistency
-- Verify text-to-image ratio within cards after each chunk
-
-### Forms
-- Group related fields (e.g., "Personal Information", "Payment Details")
-- Process labels and input fields together
-- Ensure validation messages and hints are updated with their fields
-
-### Navigation & Menus
-- Process hierarchical levels together (main menu, submenu)
-- Respect information architecture relationships
-- Verify menu fit and alignment after replacement
-
-## Best Practices
-- **Preserve Design Intent**: Always prioritize design integrity
-- **Structural Consistency**: Maintain alignment, spacing, and hierarchy
-- **Visual Feedback**: Verify each chunk visually before proceeding
-- **Incremental Improvement**: Learn from each chunk to improve subsequent ones
-- **Balance Automation & Control**: Let AI handle repetitive replacements but maintain oversight
-- **Respect Content Relationships**: Keep related content consistent across chunks
-
-Remember that text is never just text\u2014it's a core design element that must work harmoniously with the overall composition. This chunk-based strategy allows you to methodically transform text while maintaining design integrity.`
+          text: '# Intelligent Text Replacement Strategy\n\n## 1. Analyze Design & Identify Structure\n- Scan text nodes to understand the overall structure of the design\n- Use AI pattern recognition to identify logical groupings:\n  * Tables (rows, columns, headers, cells)\n  * Lists (items, headers, nested lists)\n  * Card groups (similar cards with recurring text fields)\n  * Forms (labels, input fields, validation text)\n  * Navigation (menu items, breadcrumbs)\n```\ntext(method: "scan", items: [{nodeId: "node-id"}])\nframes(method: "get", id: "node-id", depth: 1)  // optional\n```\n\n## 2. Strategic Chunking for Complex Designs\n- Divide replacement tasks into logical content chunks based on design structure\n- Use one of these chunking strategies that best fits the design:\n  * **Structural Chunking**: Table rows/columns, list sections, card groups\n  * **Spatial Chunking**: Top-to-bottom, left-to-right in screen areas\n  * **Semantic Chunking**: Content related to the same topic or functionality\n  * **Component-Based Chunking**: Process similar component instances together\n\n## 3. Progressive Replacement with Verification\n- Create a safe copy of the node for text replacement\n- Replace text chunk by chunk with continuous progress updates\n- After each chunk is processed:\n  * Export that section as a small, manageable image\n  * Verify text fits properly and maintain design integrity\n  * Fix issues before proceeding to the next chunk\n\n```\n// Clone the node to create a safe copy\nframes(method: "clone", id: "selected-node-id", x: [new-x], y: [new-y])\n\n// Replace text chunk by chunk\ntext(method: "set_content", items: [\n  { nodeId: "node-id-1", text: "New text 1" },\n  // More nodes in this chunk...\n])\n\n// Verify chunk with small, targeted image exports\nframes(method: "export", nodeId: "chunk-node-id", format: "PNG", scale: 0.5)\n```\n\n## 4. Intelligent Handling for Table Data\n- For tabular content:\n  * Process one row or column at a time\n  * Maintain alignment and spacing between cells\n  * Consider conditional formatting based on cell content\n  * Preserve header/data relationships\n\n## 5. Smart Text Adaptation\n- Adaptively handle text based on container constraints:\n  * Auto-detect space constraints and adjust text length\n  * Apply line breaks at appropriate linguistic points\n  * Maintain text hierarchy and emphasis\n  * Consider font scaling for critical content that must fit\n\n## 6. Progressive Feedback Loop\n- Establish a continuous feedback loop during replacement:\n  * Real-time progress updates (0-100%)\n  * Small image exports after each chunk for verification\n  * Issues identified early and resolved incrementally\n  * Quick adjustments applied to subsequent chunks\n\n## 7. Final Verification & Context-Aware QA\n- After all chunks are processed:\n  * Export the entire design at reduced scale for final verification\n  * Check for cross-chunk consistency issues\n  * Verify proper text flow between different sections\n  * Ensure design harmony across the full composition\n\n## 8. Chunk-Specific Export Scale Guidelines\n- Scale exports appropriately based on chunk size:\n  * Small chunks (1-5 elements): scale 1.0\n  * Medium chunks (6-20 elements): scale 0.7\n  * Large chunks (21-50 elements): scale 0.5\n  * Very large chunks (50+ elements): scale 0.3\n  * Full design verification: scale 0.2\n\n## Sample Chunking Strategy for Common Design Types\n\n### Tables\n- Process by logical rows (5-10 rows per chunk)\n- Alternative: Process by column for columnar analysis\n- Tip: Always include header row in first chunk for reference\n\n### Card Lists\n- Group 3-5 similar cards per chunk\n- Process entire cards to maintain internal consistency\n- Verify text-to-image ratio within cards after each chunk\n\n### Forms\n- Group related fields (e.g., "Personal Information", "Payment Details")\n- Process labels and input fields together\n- Ensure validation messages and hints are updated with their fields\n\n### Navigation & Menus\n- Process hierarchical levels together (main menu, submenu)\n- Respect information architecture relationships\n- Verify menu fit and alignment after replacement\n\n## Best Practices\n- **Preserve Design Intent**: Always prioritize design integrity\n- **Structural Consistency**: Maintain alignment, spacing, and hierarchy\n- **Visual Feedback**: Verify each chunk visually before proceeding\n- **Incremental Improvement**: Learn from each chunk to improve subsequent ones\n- **Balance Automation & Control**: Let AI handle repetitive replacements but maintain oversight\n- **Respect Content Relationships**: Keep related content consistent across chunks\n\nRemember that text is never just text \u2014 it\'s a core design element that must work harmoniously with the overall composition. This chunk-based strategy allows you to methodically transform text while maintaining design integrity.'
         }
       }],
       description: "Systematic approach for replacing text in Figma designs"
@@ -1206,32 +2565,10 @@ Remember that text is never just text\u2014it's a core design element that must
         role: "assistant",
         content: {
           type: "text",
-          text: `# Swap Component Instance Overrides
-
-## Overview
-Transfer content overrides from a source instance to target instances.
-
-## Process
-
-### 1. Identify Instances
-- Use \`get_selection()\` to identify selected instances
-- Use \`search_nodes(types: ["INSTANCE"])\` to find instances on the page
-
-### 2. Extract Source Overrides
-- \`instances(method: "get", id: "source-instance-id")\`
-- Returns mainComponentId and per-child override fields (characters, fills, fontSize, etc.)
-
-### 3. Apply to Targets
-- For text overrides: use \`set_text_content\` on matching child node IDs
-- For style overrides: use \`patch_nodes\` with fill/stroke/text/effects styleName fields
-- Match children by name path \u2014 source and target instances share the same internal structure
-
-### 4. Verify
-- \`get_node_info(nodeId, depth: 1)\` on target instances
-- \`export_node_as_image\` for visual verification`
+          text: '# Swap Component Instance Overrides\n\n## Overview\nTransfer content overrides from a source instance to target instances.\n\n## Process\n\n### 1. Identify Instances\n- Use `selection(method: "get")` to identify selected instances\n- Use `frames(method: "list", types: ["INSTANCE"])` to find instances on the page\n\n### 2. Extract Source Overrides\n- `instances(method: "get", id: "source-instance-id")`\n- Returns mainComponentId and per-child override fields (characters, fills, fontSize, etc.)\n\n### 3. Apply to Targets\n- For text overrides: use `text(method: "set_content")` on matching child node IDs\n- For style overrides: use `frames(method: "update")` with fill/stroke/text/effects styleName fields\n- Match children by name path \u2014 source and target instances share the same internal structure\n\n### 4. Verify\n- `frames(method: "get", id: "target-id", depth: 1)` on target instances\n- `frames(method: "export", nodeId: "target-id")` for visual verification'
         }
       }],
-      description: "Strategy for transferring overrides between component instances in Figma"
+      description: "Guide to swap instance overrides between instances"
     })
   );
   server2.registerPrompt(
@@ -1242,32 +2579,7 @@ Transfer content overrides from a source instance to target instances.
         role: "assistant",
         content: {
           type: "text",
-          text: `# Missing Create / Edit Tools
-
-If the user asks you to create or modify something in Figma but you cannot find tools like \`create_frame\`, \`create_text\`, \`patch_nodes\`, \`delete_node\`, or \`set_text_content\`, the MCP server was started without the correct access tier flag.
-
-Vibma filters tools at startup based on CLI flags passed in the MCP config \`args\` array:
-
-| Flag | Tools available |
-|------|----------------|
-| _(none)_ | Read-only (inspect, search, export) |
-| \`--create\` | Read + creation tools |
-| \`--edit\` | All tools (read + create + edit + delete) |
-
-Ask the user to add \`--edit\` (or \`--create\`) to their MCP config args:
-
-\`\`\`json
-{
-  "mcpServers": {
-    "Vibma": {
-      "command": "npx",
-      "args": ["-y", "@ufira/vibma", "--edit"]
-    }
-  }
-}
-\`\`\`
-
-After updating, the user must restart their AI tool or reload MCP servers \u2014 stdio-based servers cannot hot-reload.`
+          text: '# Missing Create / Edit Tools\n\nIf the user asks you to create or modify something in Figma but you cannot find create/edit methods on endpoint tools, the MCP server was started without the correct access tier flag.\n\nVibma filters available methods at startup based on CLI flags passed in the MCP config `args` array:\n\n| Flag | Methods available |\n|------|-----------------|\n| _(none)_ | Read-only (get, list, check, scan, export) |\n| `--create` | Read + creation methods (create, clone) |\n| `--edit` | All methods (read + create + update + delete) |\n\nAsk the user to add `--edit` (or `--create`) to their MCP config args:\n\n```json\n{\n  "mcpServers": {\n    "Vibma": {\n      "command": "npx",\n      "args": ["-y", "@ufira/vibma", "--edit"]\n    }\n  }\n}\n```\n\nAfter updating, the user must restart their AI tool or reload MCP servers \u2014 stdio-based servers cannot hot-reload.'
         }
       }],
       description: "Why create or edit tools are missing and how to fix it"
@@ -1276,24 +2588,39 @@ After updating, the user must restart their AI tool or reload MCP servers \u2014
 }
 
 // src/tools/mcp-registry.ts
-var allTools = [
-  ...tools,
-  ...tools2,
-  ...tools3,
-  ...tools4,
-  ...tools5,
-  ...tools6,
-  ...tools7,
-  ...tools8,
-  ...tools9,
-  ...tools10,
-  ...tools11,
-  ...tools12,
-  ...tools13,
-  ...tools14,
-  ...tools15
-];
+var endpointTools = tools.filter((t) => t.name !== "connection");
+var framesTool = endpointTools.find((t) => t.name === "frames");
+if (framesTool) {
+  framesTool.methodFormatters = {
+    export: (result) => {
+      const r = result;
+      if (r.isString) {
+        return { content: [{ type: "text", text: r.imageData }] };
+      }
+      return {
+        content: [{ type: "image", data: r.imageData, mimeType: r.mimeType || "image/png" }]
+      };
+    }
+  };
+}
+var allTools = [...endpointTools];
 function registerAllTools(server2, sendCommand, caps2) {
+  server2.registerTool("help", {
+    description: 'Get help on any endpoint or method. Lists all endpoints, their methods, and detailed parameter docs.\nExamples: help() \u2192 directory, help(topic: "components") \u2192 endpoint details, help(topic: "components.create") \u2192 method params.',
+    inputSchema: {
+      topic: import_zod5.z.string().optional().describe('Endpoint or endpoint.method name, e.g. "components" or "components.create"')
+    }
+  }, async (params) => {
+    return { content: [{ type: "text", text: resolveHelp(params.topic) }] };
+  });
+  server2.registerTool("guidelines", {
+    description: 'Design guidelines for building quality Figma designs. Covers layout, responsiveness, tokens, components, accessibility, naming, and workflow.\nExamples: guidelines() \u2192 list topics, guidelines(topic: "responsive-designs") \u2192 full guideline.',
+    inputSchema: {
+      topic: import_zod5.z.string().optional().describe('Guideline topic name, e.g. "responsive-designs" or "token-discipline"')
+    }
+  }, async (params) => {
+    return { content: [{ type: "text", text: resolveGuideline(params.topic) }] };
+  });
   registerTools(server2, sendCommand, caps2, allTools);
   registerPrompts(server2);
 }
@@ -1344,9 +2671,10 @@ var versionWarning = null;
 var args = process.argv.slice(2);
 var serverArg = args.find((a) => a.startsWith("--server="));
 var portArg = args.find((a) => a.startsWith("--port="));
-var serverUrl = serverArg ? serverArg.split("=")[1] : "localhost";
+var serverUrl = serverArg ? serverArg.split("=")[1] : process.env.VIBMA_SERVER || "localhost";
 if (portArg) activePort = parseInt(portArg.split("=")[1]);
-var WS_URL = serverUrl === "localhost" ? `ws://${serverUrl}` : `wss://${serverUrl}`;
+var isLocal = /^(localhost|127\.0\.0\.1|host\.docker\.internal|0\.0\.0\.0)(:|$)/.test(serverUrl) || serverUrl.endsWith(".local");
+var WS_URL = isLocal ? `ws://${serverUrl}` : `wss://${serverUrl}`;
 var caps = {
   create: args.includes("--create") || args.includes("--edit"),
   edit: args.includes("--edit")
@@ -1357,7 +2685,7 @@ function connectToFigma(port = activePort) {
     logger.info("Already connected to Figma");
     return;
   }
-  const wsUrl = serverUrl === "localhost" ? `${WS_URL}:${port}` : WS_URL;
+  const wsUrl = isLocal ? `${WS_URL}:${port}` : WS_URL;
   logger.info(`Connecting to Figma socket server at ${wsUrl}...`);
   ws = new import_ws.default(wsUrl);
   ws.on("open", () => {
@@ -1447,7 +2775,7 @@ function connectToFigma(port = activePort) {
       pendingRequests.delete(id);
     }
     if (rejected) {
-      logger.info("Not reconnecting \u2014 channel role was rejected. Call join_channel to retry.");
+      logger.info('Not reconnecting \u2014 channel role was rejected. Call connection(method: "create") to retry.');
     } else {
       logger.info("Attempting to reconnect in 2 seconds...");
       setTimeout(() => connectToFigma(port), 2e3);
@@ -1482,7 +2810,7 @@ function sendCommandToFigma(command, params = {}, timeoutMs = 3e4) {
     }
     const requiresChannel = command !== "join";
     if (requiresChannel && !currentChannel) {
-      reject(new Error("No channel joined. Call join_channel first with the channel name shown in the Figma plugin panel."));
+      reject(new Error('No channel joined. Call connection(method: "create") first with the channel name shown in the Figma plugin panel.'));
       return;
     }
     const id = (0, import_uuid.v4)();
@@ -1518,105 +2846,73 @@ var server = new import_mcp.McpServer({
   name: "VibmaMCP",
   version: "1.0.0"
 });
+var connectionDef = tools.find((t) => t.name === "connection");
+var connectionSchema = typeof connectionDef.schema === "function" ? connectionDef.schema(caps) : connectionDef.schema;
 server.registerTool(
-  "join_channel",
-  {
-    description: "REQUIRED FIRST STEP: Join a channel before using any other tool. The channel name is shown in the Figma plugin UI (defaults to 'vibma' if not customised). After joining, call `ping` to verify the Figma plugin is connected. All subsequent commands are sent through this channel.",
-    inputSchema: { channel: import_zod18.z.string().describe("The channel name displayed in the Figma plugin panel. Defaults to 'vibma' if omitted.").default("vibma") }
-  },
-  async ({ channel }) => {
+  "connection",
+  { description: connectionDef.description, inputSchema: connectionSchema },
+  async (params) => {
+    const method = params.method;
     try {
-      await joinChannel(channel);
-      await new Promise((r) => setTimeout(r, 200));
-      let msg = `Joined channel "${channel}" on port ${activePort}. Call \`ping\` now to verify the Figma plugin is connected.`;
-      if (versionWarning) msg += `
+      if (method === "help") {
+        const text = resolveEndpointHelp("connection", params.topic) ?? "No help available for connection";
+        return { content: [{ type: "text", text }] };
+      }
+      if (method === "create") {
+        const channel = params.channel || "vibma";
+        await joinChannel(channel);
+        await new Promise((r) => setTimeout(r, 200));
+        let msg = `Joined channel "${channel}" on port ${activePort}. Call connection(method: "get") to verify the Figma plugin is connected.`;
+        if (versionWarning) msg += `
 
 \u26A0\uFE0F ${versionWarning}
 See "Version mismatch" in CARRYME.md or DRAGME.md for update steps.`;
-      return {
-        content: [{ type: "text", text: msg }]
-      };
-    } catch (error) {
-      return {
-        content: [{
-          type: "text",
-          text: `Error joining channel: ${error instanceof Error ? error.message : String(error)}. MCP is using port ${activePort} \u2014 confirm the relay is running on the same port.`
-        }]
-      };
-    }
-  }
-);
-server.registerTool(
-  "channel_info",
-  {
-    description: "Debug: inspect which clients (MCP, plugin) are connected to each relay channel. Useful for diagnosing connection issues. Does not require an active channel."
-  },
-  async () => {
-    try {
-      const url = serverUrl === "localhost" ? `http://localhost:${activePort}/channels` : `https://${serverUrl}/channels`;
-      const response = await fetch(url);
-      if (!response.ok) {
-        return { content: [{ type: "text", text: `Relay returned ${response.status}: ${await response.text()}` }] };
+        msg += "\n\nWelcome to Vibma! As you work, the MCP will give you warnings when it spots issues \u2014 hardcoded colors, missing auto-layout, unbound tokens, etc. Following these best practices will reduce the noise from the MCP and help you create a well-structured design system that designers enjoy working with.";
+        return { content: [{ type: "text", text: msg }] };
       }
-      const data = await response.json();
-      return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
-    } catch (error) {
-      return {
-        content: [{
-          type: "text",
-          text: `Could not reach relay at port ${activePort}: ${error instanceof Error ? error.message : String(error)}`
-        }]
-      };
-    }
-  }
-);
-server.registerTool(
-  "reset_tunnel",
-  {
-    description: "DESTRUCTIVE: Factory-reset a channel on the relay via HTTP, disconnecting ALL occupants (MCP + Figma plugin). Only use this when the channel is stuck or occupied by another MCP \u2014 do NOT use it just to reconnect yourself (use `join_channel` instead). After reset, ask the user to reopen the Vibma plugin in Figma, then call `join_channel` and `ping`.",
-    inputSchema: {
-      channel: import_zod18.z.string().describe("Channel to reset. Defaults to 'vibma'.").default("vibma")
-    }
-  },
-  async ({ channel }) => {
-    const targetChannel = channel || currentChannel || "vibma";
-    try {
-      const url = serverUrl === "localhost" ? `http://localhost:${activePort}/channels/${encodeURIComponent(targetChannel)}` : `https://${serverUrl}/channels/${encodeURIComponent(targetChannel)}`;
-      const res = await fetch(url, { method: "DELETE" });
-      const body = await res.json();
-      for (const [reqId, request] of pendingRequests.entries()) {
-        clearTimeout(request.timeout);
-        request.reject(new Error("Tunnel reset by user"));
-        pendingRequests.delete(reqId);
+      if (method === "list") {
+        const url = isLocal ? `http://${serverUrl}:${activePort}/channels` : `https://${serverUrl}/channels`;
+        const response = await fetch(url);
+        if (!response.ok) return { content: [{ type: "text", text: `Relay returned ${response.status}: ${await response.text()}` }] };
+        const data = await response.json();
+        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
       }
-      if (ws) {
-        const old = ws;
-        ws = null;
-        old.removeAllListeners();
-        old.close(1e3, "Tunnel reset");
+      if (method === "delete") {
+        const targetChannel = params.channel || currentChannel || "vibma";
+        const url = isLocal ? `http://${serverUrl}:${activePort}/channels/${encodeURIComponent(targetChannel)}` : `https://${serverUrl}/channels/${encodeURIComponent(targetChannel)}`;
+        const res = await fetch(url, { method: "DELETE" });
+        const body = await res.json();
+        for (const [reqId, request] of pendingRequests.entries()) {
+          clearTimeout(request.timeout);
+          request.reject(new Error("Tunnel reset by user"));
+          pendingRequests.delete(reqId);
+        }
+        if (ws) {
+          const old = ws;
+          ws = null;
+          old.removeAllListeners();
+          old.close(1e3, "Tunnel reset");
+        }
+        currentChannel = null;
+        rejected = false;
+        connectToFigma();
+        await new Promise((resolve) => setTimeout(resolve, 1e3));
+        const connected = ws && ws.readyState === import_ws.default.OPEN;
+        return {
+          content: [{
+            type: "text",
+            text: connected ? `Tunnel reset: ${body.message}. Reconnected on port ${activePort}.
+
+IMPORTANT: The Figma plugin was also disconnected. Ask the user to reopen the Vibma plugin, then call connection(method: "create") followed by connection(method: "get").` : `Tunnel reset: ${body.message}. Reconnection in progress.
+
+IMPORTANT: The Figma plugin was also disconnected. Ask the user to reopen the Vibma plugin, then call connection(method: "create") to retry.`
+          }]
+        };
       }
-      currentChannel = null;
-      rejected = false;
-      connectToFigma();
-      await new Promise((resolve) => setTimeout(resolve, 1e3));
-      const connected = ws && ws.readyState === import_ws.default.OPEN;
-      return {
-        content: [{
-          type: "text",
-          text: connected ? `Tunnel reset: ${body.message}. Reconnected on port ${activePort}.
-
-IMPORTANT: The Figma plugin was also disconnected. Ask the user to reopen the Vibma plugin in Figma (or click "Reset tunnel" in the plugin panel). Then call \`join_channel\` followed by \`ping\`.` : `Tunnel reset: ${body.message}. Reconnection in progress.
-
-IMPORTANT: The Figma plugin was also disconnected. Ask the user to reopen the Vibma plugin in Figma (or click "Reset tunnel" in the plugin panel). Then call \`join_channel\` to retry.`
-        }]
-      };
+      const result = await sendCommandToFigma("connection.get", params, 5e3);
+      return { content: [{ type: "text", text: JSON.stringify(result) }] };
     } catch (error) {
-      return {
-        content: [{
-          type: "text",
-          text: `Error resetting tunnel: ${error instanceof Error ? error.message : String(error)}`
-        }]
-      };
+      return { content: [{ type: "text", text: `connection.${method} error: ${error instanceof Error ? error.message : String(error)}` }] };
     }
   }
 );