@ufira/vibma 1.0.0-rc5 → 1.0.0-rc6

package/dist/mcp.cjs

@@ -98,9 +98,9 @@ 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 + optional node tree for structural inspection [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// Adding variants: clone an existing variant into the set with a new name. See guidelines(topic:"component-structure") for workflow.\n\nUse components(method: "help", topic: "<method>") for method details.',
+    "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 + optional node tree for structural inspection [read]\n  create               Create components [create]\n  commit               Commit a staged component \u2014 unwraps from [STAGED] container into the original target location. [edit]\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// Adding variants: clone an existing variant into the set with a new name. See guidelines(topic:"component-structure") for workflow.\n\nUse components(method: "help", topic: "<method>") for method details.',
     "methods": {
-      "clone": "# components.clone\nDuplicate nodes\n\nParams:\n    id (string, optional) \u2014 Node ID\n    name (string, optional) \u2014 Rename the clone (set before appending to parent \u2014 required when cloning a variant into its component set to avoid duplicate names)\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    items (array, optional) \u2014 Batch: [{id, name?, parentId?, x?, y?}, ...]. Alternative to single-item params.\n      id (string, required) \u2014 Node ID to clone\n      name (string, optional) \u2014 Rename the clone\n      parentId (string, optional) \u2014 Target parent\n      x (number, optional)\n      y (number, optional)\n    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.",
+      "clone": "# components.clone\nDuplicate nodes\n\nParams:\n    id (string, optional) \u2014 Node ID\n    name (string, optional) \u2014 Rename the clone (set before appending to parent \u2014 required when cloning a variant into its component set to avoid duplicate names)\n    parentId (string, optional) \u2014 Parent node ID. Omit to place at current page root.\n    x (number, optional) \u2014 X position (default: 0)\n    y (number, optional) \u2014 Y position (default: 0)\n    items (array, optional) \u2014 Batch: [{id, name?, parentId?, x?, y?}, ...]. Alternative to single-item params.\n      id (string, required) \u2014 Node ID to clone\n      name (string, optional) \u2014 Rename the clone\n      parentId (string, optional) \u2014 Target parent\n      x (number, optional)\n      y (number, optional)\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
 Run lint on a node \u2014 returns severity-ranked findings
 
@@ -123,7 +123,7 @@ 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.
+    parentId (string, optional) \u2014 Parent node ID. Omit to place at current page root.
     x (number, optional) \u2014 X position (default: 0)
     y (number, optional) \u2014 Y position (default: 0)
     width (number, optional) \u2014 Width in px (omit to shrink-to-content via HUG)
@@ -174,6 +174,8 @@ Discriminant: type (component | from_node | variant_set)
     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 \u2014 build nested trees in one call. Types: text: {type:"text", text, componentPropertyName?, fontFamily?, fontSize?, fontWeight?, fontStyle?, fontColor?, layoutSizingHorizontal?}. frame: {type:"frame", name?, layoutMode?, fillColor?, width?, layoutSizingHorizontal?, children?}. instance: {type:"instance", componentId, componentPropertyName?, variantProperties?, properties?}. component: {type:"component", name, children?}. All params from text/frame endpoints are supported on their respective types. componentPropertyName auto-creates and binds a TEXT (text) or INSTANCE_SWAP (instance) property. Always set layoutSizingHorizontal + layoutSizingVertical on children inside auto-layout parents (FILL, HUG, or FIXED). Example: children:[{type:"text", text:"Label", componentPropertyName:"Label", fontSize:14, fontColorVariableName:"text/primary", layoutSizingHorizontal:"FILL", layoutSizingVertical:"HUG"}, {type:"frame", name:"Actions", layoutMode:"HORIZONTAL", layoutSizingHorizontal:"FILL", layoutSizingVertical:"HUG", itemSpacing:8, children:[{type:"instance", componentId:"1:2", componentPropertyName:"Action", layoutSizingHorizontal:"FILL", layoutSizingVertical:"HUG"}]}]
+
     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
@@ -182,11 +184,12 @@ Discriminant: type (component | from_node | variant_set)
 
   ## 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
+    name (string, optional) \u2014 Rename the component (default: keeps the node's current name)
     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.
+    parentId (string, optional) \u2014 Parent node ID. Omit to place at current page root.
     x (number, optional) \u2014 X position (default: 0)
     y (number, optional) \u2014 Y position (default: 0)
     width (number, optional) \u2014 Width in px (omit to shrink-to-content via HUG)
@@ -237,7 +240,9 @@ Discriminant: type (component | from_node | variant_set)
     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[], optional) \u2014 Existing component IDs to combine (min 2). Alternative to children.
-    variantPropertyName (string, optional) \u2014 Rename the auto-generated variant property (default: 'Property 1')`,
+    variantPropertyName (string, optional) \u2014 Rename the auto-generated variant property (default: 'Property 1')
+    children (array, optional) \u2014 Inline variant components. Each must be {type:"component", name, children?, ...frame_params}. All variants must share the same child structure. Alternative to componentIds \u2014 do not combine both.`,
+      "commit": '# components.commit\nCommit a staged component \u2014 unwraps from [STAGED] container into the original target location.\n\nExample: components(method:"commit", id:"1:234")\n\nParams:\n    id (string, required) \u2014 Staged node ID to commit',
       "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"
     }
@@ -268,7 +273,7 @@ Discriminant: type (component | from_node | variant_set)
     }
   },
   "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.',
+    "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  commit               Commit a staged node \u2014 unwraps from [STAGED] container into the original target location. [edit]\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)',
@@ -351,7 +356,7 @@ Params:
       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, optional) \u2014 Node ID\n    name (string, optional) \u2014 Rename the clone (set before appending to parent \u2014 required when cloning a variant into its component set to avoid duplicate names)\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    items (array, optional) \u2014 Batch: [{id, name?, parentId?, x?, y?}, ...]. Alternative to single-item params.\n      id (string, required) \u2014 Node ID to clone\n      name (string, optional) \u2014 Rename the clone\n      parentId (string, optional) \u2014 Target parent\n      x (number, optional)\n      y (number, optional)\n    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.",
+      "clone": "# frames.clone\nDuplicate nodes\n\nParams:\n    id (string, optional) \u2014 Node ID\n    name (string, optional) \u2014 Rename the clone (set before appending to parent \u2014 required when cloning a variant into its component set to avoid duplicate names)\n    parentId (string, optional) \u2014 Parent node ID. Omit to place at current page root.\n    x (number, optional) \u2014 X position (default: 0)\n    y (number, optional) \u2014 Y position (default: 0)\n    items (array, optional) \u2014 Batch: [{id, name?, parentId?, x?, y?}, ...]. Alternative to single-item params.\n      id (string, required) \u2014 Node ID to clone\n      name (string, optional) \u2014 Rename the clone\n      parentId (string, optional) \u2014 Target parent\n      x (number, optional)\n      y (number, optional)\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
 Run lint on a node \u2014 returns severity-ranked findings
 
@@ -372,7 +377,7 @@ Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line |
 
   ## frame \u2014 General-purpose frame \u2014 shrinks to content by default, static when width+height given
     name (string, optional) \u2014 Node name
-    parentId (string, optional) \u2014 Parent node ID. Omit to place on current page.
+    parentId (string, optional) \u2014 Parent node ID. Omit to place at current page root.
     x (number, optional) \u2014 X position (default: 0)
     y (number, optional) \u2014 Y position (default: 0)
     width (number, optional) \u2014 Width in px (omit to shrink-to-content via HUG)
@@ -423,10 +428,12 @@ Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line |
     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)
+    children (array, optional) \u2014 Inline child nodes \u2014 build nested trees in one call. Types: text: {type:"text", text, fontFamily?, fontSize?, fontWeight?, fontStyle?, fontColor?, layoutSizingHorizontal?}. frame: {type:"frame", name?, layoutMode?, fillColor?, width?, layoutSizingHorizontal?, children?}. instance: {type:"instance", componentId, variantProperties?, properties?}. component: {type:"component", name, children?}. All params from text/frame endpoints are supported on their respective types. Always set layoutSizingHorizontal + layoutSizingVertical on children inside auto-layout parents (FILL, HUG, or FIXED). Example: children:[{type:"text", text:"Title", fontSize:20, layoutSizingHorizontal:"FILL", layoutSizingVertical:"HUG"}, {type:"frame", name:"Row", layoutMode:"HORIZONTAL", layoutSizingHorizontal:"FILL", layoutSizingVertical:"HUG", itemSpacing:8, children:[{type:"instance", componentId:"1:2", layoutSizingHorizontal:"FILL", layoutSizingVertical:"HUG"}]}] Inside components: add componentPropertyName to auto-bind TEXT or INSTANCE_SWAP properties.
+
 
   ## 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.
+    parentId (string, optional) \u2014 Parent node ID. Omit to place at current page root.
     x (number, optional) \u2014 X position (default: 0)
     y (number, optional) \u2014 Y position (default: 0)
     width (number, optional) \u2014 Width in px (omit to shrink-to-content via HUG)
@@ -478,10 +485,12 @@ Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line |
     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
+    children (array, optional) \u2014 Inline child nodes \u2014 build nested trees in one call. Types: text: {type:"text", text, fontFamily?, fontSize?, fontWeight?, fontStyle?, fontColor?, layoutSizingHorizontal?}. frame: {type:"frame", name?, layoutMode?, fillColor?, width?, layoutSizingHorizontal?, children?}. instance: {type:"instance", componentId, variantProperties?, properties?}. component: {type:"component", name, children?}. All params from text/frame endpoints are supported on their respective types. Always set layoutSizingHorizontal + layoutSizingVertical on children inside auto-layout parents (FILL, HUG, or FIXED). Example: children:[{type:"text", text:"Title", fontSize:20, layoutSizingHorizontal:"FILL", layoutSizingVertical:"HUG"}, {type:"frame", name:"Row", layoutMode:"HORIZONTAL", layoutSizingHorizontal:"FILL", layoutSizingVertical:"HUG", itemSpacing:8, children:[{type:"instance", componentId:"1:2", layoutSizingHorizontal:"FILL", layoutSizingVertical:"HUG"}]}] Inside components: add componentPropertyName to auto-bind TEXT or INSTANCE_SWAP properties.
+
 
   ## 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.
+    parentId (string, optional) \u2014 Parent node ID. Omit to place at current page root.
     x (number, optional) \u2014 X position (default: 0)
     y (number, optional) \u2014 Y position (default: 0)
     width (number, optional) \u2014 Width (default: 500)
@@ -493,7 +502,7 @@ Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line |
 
   ## 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.
+    parentId (string, optional) \u2014 Parent node ID. Omit to place at current page root.
     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)
@@ -517,7 +526,7 @@ Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line |
 
   ## 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.
+    parentId (string, optional) \u2014 Parent node ID. Omit to place at current page root.
     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)
@@ -536,7 +545,7 @@ Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line |
 
   ## 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.
+    parentId (string, optional) \u2014 Parent node ID. Omit to place at current page root.
     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)
@@ -551,24 +560,25 @@ Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line |
   ## 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.
+    parentId (string, optional) \u2014 Parent node ID. Omit to place at current page root.
 
   ## 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.
+    parentId (string, optional) \u2014 Parent node ID. Omit to place at current page root.
 
   ## 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.
+    parentId (string, optional) \u2014 Parent node ID. Omit to place at current page root.
     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`,
+      "commit": '# frames.commit\nCommit a staged node \u2014 unwraps from [STAGED] container into the original target location.\n\nExample: frames(method:"commit", id:"1:234")\n\nParams:\n    id (string, required) \u2014 Staged node ID to commit',
       "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)"
     }
   },
@@ -577,7 +587,7 @@ Discriminant: type (frame | auto_layout | section | rectangle | ellipse | line |
     "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, optional) \u2014 Node ID\n    name (string, optional) \u2014 Rename the clone (set before appending to parent \u2014 required when cloning a variant into its component set to avoid duplicate names)\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    items (array, optional) \u2014 Batch: [{id, name?, parentId?, x?, y?}, ...]. Alternative to single-item params.\n      id (string, required) \u2014 Node ID to clone\n      name (string, optional) \u2014 Rename the clone\n      parentId (string, optional) \u2014 Target parent\n      x (number, optional)\n      y (number, optional)\n    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.",
+      "clone": "# instances.clone\nDuplicate nodes\n\nParams:\n    id (string, optional) \u2014 Node ID\n    name (string, optional) \u2014 Rename the clone (set before appending to parent \u2014 required when cloning a variant into its component set to avoid duplicate names)\n    parentId (string, optional) \u2014 Parent node ID. Omit to place at current page root.\n    x (number, optional) \u2014 X position (default: 0)\n    y (number, optional) \u2014 Y position (default: 0)\n    items (array, optional) \u2014 Batch: [{id, name?, parentId?, x?, y?}, ...]. Alternative to single-item params.\n      id (string, required) \u2014 Node ID to clone\n      name (string, optional) \u2014 Rename the clone\n      parentId (string, optional) \u2014 Target parent\n      x (number, optional)\n      y (number, optional)\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
 Run lint on a node \u2014 returns severity-ranked findings
 
@@ -618,7 +628,7 @@ Params:
       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.
+      parentId (string, optional) \u2014 Parent node ID. Omit to place at current page root.
     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
@@ -877,7 +887,7 @@ Params:
       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, optional) \u2014 Node ID\n    name (string, optional) \u2014 Rename the clone (set before appending to parent \u2014 required when cloning a variant into its component set to avoid duplicate names)\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    items (array, optional) \u2014 Batch: [{id, name?, parentId?, x?, y?}, ...]. Alternative to single-item params.\n      id (string, required) \u2014 Node ID to clone\n      name (string, optional) \u2014 Rename the clone\n      parentId (string, optional) \u2014 Target parent\n      x (number, optional)\n      y (number, optional)\n    depth (number, optional) \u2014 Response detail: omit for id+name only. 0=properties + child stubs. N=recurse N levels. -1=unlimited.",
+      "clone": "# text.clone\nDuplicate nodes\n\nParams:\n    id (string, optional) \u2014 Node ID\n    name (string, optional) \u2014 Rename the clone (set before appending to parent \u2014 required when cloning a variant into its component set to avoid duplicate names)\n    parentId (string, optional) \u2014 Parent node ID. Omit to place at current page root.\n    x (number, optional) \u2014 X position (default: 0)\n    y (number, optional) \u2014 Y position (default: 0)\n    items (array, optional) \u2014 Batch: [{id, name?, parentId?, x?, y?}, ...]. Alternative to single-item params.\n      id (string, required) \u2014 Node ID to clone\n      name (string, optional) \u2014 Rename the clone\n      parentId (string, optional) \u2014 Target parent\n      x (number, optional)\n      y (number, optional)\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
 Run lint on a node \u2014 returns severity-ranked findings
 
@@ -901,7 +911,7 @@ Params:
       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.
+      parentId (string, optional) \u2014 Parent node ID. Omit to place at current page root.
       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)
@@ -1043,6 +1053,7 @@ function registerTools(server2, sendCommand, caps2, tools2) {
         }
         if (tool.validate) tool.validate(params);
         const command = resolveCommand(tool, params);
+        params._caps = caps2;
         const result = await sendCommand(command, params, timeout);
         const format = tool.methodFormatters?.[params.method] ?? defaultFormat;
         return format(result);
@@ -1162,12 +1173,12 @@ function filterMethodsByTier(schema, caps2, methodTiers) {
 var tools = [
   {
     name: "components",
-    description: '/** Create and manage reusable components and variant sets. Use method "help" for detailed parameter docs. */\n  clone     (id?, name?, parentId?, x?, y?, items?: { id: string; name?: string; parentId?: string; x?: number; y?: number }[], depth?) \u2192 { results: {id}[] }  // Duplicate nodes\n  audit     (id, rules?, maxDepth?, maxFindings?, minSeverity?: error|unsafe|heuristic|style|verbose, skipInstances?) \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?, depth?, verbose?) \u2192 { results, _truncated? }  // Get component detail \u2014 property definitions + optional node tree for structural inspection\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).',
+    description: '/** Create and manage reusable components and variant sets. Use method "help" for detailed parameter docs. */\n  clone     (id?, name?, parentId?, x?, y?, items?: { id: string; name?: string; parentId?: string; x?: number; y?: number }[], depth?) \u2192 { results: {id}[] }  // Duplicate nodes\n  audit     (id, rules?, maxDepth?, maxFindings?, minSeverity?: error|unsafe|heuristic|style|verbose, skipInstances?) \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?, depth?, verbose?) \u2192 { results, _truncated? }  // Get component detail \u2014 property definitions + optional node tree for structural inspection\n  create    (type: component|from_node|variant_set, items: (ComponentItem | FromNodeItem | VariantSetItem)[]) \u2192 { results: {id}[] }  // Create components\n  commit    (id) \u2192 { results: {id}[] }  // Commit a staged component \u2014 unwraps from [STAGED] container into the original target location.\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"]),
+      method: import_zod4.z.enum(["clone", "audit", "reparent", "list", "get", "create", "commit", "update", "delete", "help"]),
       id: import_zod4.z.string().optional().describe("Node ID"),
       name: import_zod4.z.string().optional().describe("Rename the clone (set before appending to parent \u2014 required when cloning a variant into its component set to avoid duplicate names)"),
-      parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place on current page."),
+      parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place at current page root."),
       x: import_zod4.z.coerce.number().optional().describe("X position (default: 0)"),
       y: import_zod4.z.coerce.number().optional().describe("Y position (default: 0)"),
       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 clone/reparent/update"),
@@ -1184,10 +1195,13 @@ var tools = [
       verbose: import_zod4.z.boolean().optional().describe("Include all properties (bounding box, constraints, text style details). Default false \u2014 returns slim, actionable output."),
       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" }),
+    }, caps2, { "clone": "create", "audit": "read", "reparent": "edit", "list": "read", "get": "read", "create": "create", "commit": "edit", "update": "edit", "delete": "edit", "help": "read" }),
     tier: "read",
     validate: (params) => {
       const m = params.method;
+      if (m === "commit") {
+        if (params.id === void 0) throw new Error('commit requires "id"');
+      }
       if (m === "delete") {
         if (params.id === void 0) throw new Error('delete requires "id"');
       }
@@ -1204,7 +1218,7 @@ var tools = [
         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."),
+            parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place at current page root."),
             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 (omit to shrink-to-content via HUG)"),
@@ -1255,15 +1269,17 @@ var tools = [
             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 \u2014 build nested trees in one call. Types: text: {type:"text", text, componentPropertyName?, fontFamily?, fontSize?, fontWeight?, fontStyle?, fontColor?, layoutSizingHorizontal?}. frame: {type:"frame", name?, layoutMode?, fillColor?, width?, layoutSizingHorizontal?, children?}. instance: {type:"instance", componentId, componentPropertyName?, variantProperties?, properties?}. component: {type:"component", name, children?}. All params from text/frame endpoints are supported on their respective types. componentPropertyName auto-creates and binds a TEXT (text) or INSTANCE_SWAP (instance) property. Always set layoutSizingHorizontal + layoutSizingVertical on children inside auto-layout parents (FILL, HUG, or FIXED). Example: children:[{type:"text", text:"Label", componentPropertyName:"Label", fontSize:14, fontColorVariableName:"text/primary", layoutSizingHorizontal:"FILL", layoutSizingVertical:"HUG"}, {type:"frame", name:"Actions", layoutMode:"HORIZONTAL", layoutSizingHorizontal:"FILL", layoutSizingVertical:"HUG", itemSpacing:8, children:[{type:"instance", componentId:"1:2", componentPropertyName:"Action", layoutSizingHorizontal:"FILL", layoutSizingVertical:"HUG"}]}]\n'),
             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"),
+            name: import_zod4.z.string().optional().describe("Rename the component (default: keeps the node's current name)"),
             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."),
+            parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place at current page root."),
             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 (omit to shrink-to-content via HUG)"),
@@ -1314,7 +1330,8 @@ var tools = [
             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())).optional().describe("Existing component IDs to combine (min 2). Alternative to children."),
-            variantPropertyName: import_zod4.z.string().optional().describe("Rename the auto-generated variant property (default: 'Property 1')")
+            variantPropertyName: import_zod4.z.string().optional().describe("Rename the auto-generated variant property (default: 'Property 1')"),
+            children: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).optional().describe('Inline variant components. Each must be {type:"component", name, children?, ...frame_params}. All variants must share the same child structure. Alternative to componentIds \u2014 do not combine both.')
           }).passthrough()
         };
         const s = params.type && schemas[params.type];
@@ -1359,7 +1376,7 @@ var tools = [
         }
       }
     },
-    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" }
+    commandMap: { "clone": "components.clone", "audit": "components.audit", "reparent": "components.reparent", "list": "components.list", "get": "components.get", "create": "components.create", "commit": "components.commit", "update": "components.update", "delete": "components.delete" }
   },
   {
     name: "connection",
@@ -1409,9 +1426,9 @@ var tools = [
   },
   {
     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?, name?, parentId?, x?, y?, items?: { id: string; name?: string; parentId?: string; x?: number; y?: number }[], depth?) \u2192 { results: {id}[] }  // Duplicate nodes\n  audit     (id, rules?, maxDepth?, maxFindings?, minSeverity?: error|unsafe|heuristic|style|verbose, skipInstances?) \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).',
+    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?, name?, parentId?, x?, y?, items?: { id: string; name?: string; parentId?: string; x?: number; y?: number }[], depth?) \u2192 { results: {id}[] }  // Duplicate nodes\n  audit     (id, rules?, maxDepth?, maxFindings?, minSeverity?: error|unsafe|heuristic|style|verbose, skipInstances?) \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  commit    (id) \u2192 { results: {id}[] }  // Commit a staged node \u2014 unwraps from [STAGED] container into the original target location.\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"]),
+      method: import_zod4.z.enum(["get", "list", "update", "delete", "clone", "audit", "reparent", "create", "commit", "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."),
@@ -1434,10 +1451,13 @@ var tools = [
       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" }),
+    }, caps2, { "get": "read", "list": "read", "update": "edit", "delete": "edit", "clone": "create", "audit": "read", "reparent": "edit", "create": "create", "commit": "edit", "export": "read", "help": "read" }),
     tier: "read",
     validate: (params) => {
       const m = params.method;
+      if (m === "commit") {
+        if (params.id === void 0) throw new Error('commit requires "id"');
+      }
       if (m === "export") {
         if (params.id === void 0) throw new Error('export requires "id"');
       }
@@ -1446,7 +1466,7 @@ var tools = [
         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."),
+            parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place at current page root."),
             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 (omit to shrink-to-content via HUG)"),
@@ -1496,11 +1516,12 @@ var tools = [
             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()
+            clipsContent: flexBool(import_zod4.z.boolean()).optional(),
+            children: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).optional().describe('Inline child nodes \u2014 build nested trees in one call. Types: text: {type:"text", text, fontFamily?, fontSize?, fontWeight?, fontStyle?, fontColor?, layoutSizingHorizontal?}. frame: {type:"frame", name?, layoutMode?, fillColor?, width?, layoutSizingHorizontal?, children?}. instance: {type:"instance", componentId, variantProperties?, properties?}. component: {type:"component", name, children?}. All params from text/frame endpoints are supported on their respective types. Always set layoutSizingHorizontal + layoutSizingVertical on children inside auto-layout parents (FILL, HUG, or FIXED). Example: children:[{type:"text", text:"Title", fontSize:20, layoutSizingHorizontal:"FILL", layoutSizingVertical:"HUG"}, {type:"frame", name:"Row", layoutMode:"HORIZONTAL", layoutSizingHorizontal:"FILL", layoutSizingVertical:"HUG", itemSpacing:8, children:[{type:"instance", componentId:"1:2", layoutSizingHorizontal:"FILL", layoutSizingVertical:"HUG"}]}] Inside components: add componentPropertyName to auto-bind TEXT or INSTANCE_SWAP properties.\n')
           }).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."),
+            parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place at current page root."),
             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 (omit to shrink-to-content via HUG)"),
@@ -1551,11 +1572,12 @@ var tools = [
             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")
+            nodeIds: flexJson(import_zod4.z.array(import_zod4.z.string())).optional().describe("Existing node IDs to wrap into auto-layout"),
+            children: flexJson(import_zod4.z.array(import_zod4.z.record(import_zod4.z.string(), import_zod4.z.unknown()))).optional().describe('Inline child nodes \u2014 build nested trees in one call. Types: text: {type:"text", text, fontFamily?, fontSize?, fontWeight?, fontStyle?, fontColor?, layoutSizingHorizontal?}. frame: {type:"frame", name?, layoutMode?, fillColor?, width?, layoutSizingHorizontal?, children?}. instance: {type:"instance", componentId, variantProperties?, properties?}. component: {type:"component", name, children?}. All params from text/frame endpoints are supported on their respective types. Always set layoutSizingHorizontal + layoutSizingVertical on children inside auto-layout parents (FILL, HUG, or FIXED). Example: children:[{type:"text", text:"Title", fontSize:20, layoutSizingHorizontal:"FILL", layoutSizingVertical:"HUG"}, {type:"frame", name:"Row", layoutMode:"HORIZONTAL", layoutSizingHorizontal:"FILL", layoutSizingVertical:"HUG", itemSpacing:8, children:[{type:"instance", componentId:"1:2", layoutSizingHorizontal:"FILL", layoutSizingVertical:"HUG"}]}] Inside components: add componentPropertyName to auto-bind TEXT or INSTANCE_SWAP properties.\n')
           }).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."),
+            parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place at current page root."),
             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)"),
@@ -1567,7 +1589,7 @@ var tools = [
           }).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."),
+            parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place at current page root."),
             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)"),
@@ -1591,7 +1613,7 @@ var tools = [
           }).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."),
+            parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place at current page root."),
             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)"),
@@ -1610,7 +1632,7 @@ var tools = [
           }).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."),
+            parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place at current page root."),
             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)"),
@@ -1625,18 +1647,18 @@ var tools = [
           "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.")
+            parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place at current page root.")
           }).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.")
+            parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place at current page root.")
           }).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."),
+            parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place at current page root."),
             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"),
@@ -1663,7 +1685,7 @@ var tools = [
         }
       }
     },
-    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" }
+    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", "commit": "frames.commit", "export": "frames.export" }
   },
   {
     name: "instances",
@@ -1726,7 +1748,7 @@ var tools = [
           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.")
+          parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place at current page root.")
         }).passthrough();
         try {
           params.items = import_zod4.z.array(itemSchema).parse(params.items);
@@ -2169,7 +2191,7 @@ var tools = [
           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."),
+          parentId: import_zod4.z.string().optional().describe("Parent node ID. Omit to place at current page root."),
           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)"),
@@ -2521,7 +2543,7 @@ var guidelinesList = [
   }
 ];
 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- 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### Adding Variants to an Existing Set\n\nClone an existing variant into the same set with a new name. The `name` param is required \u2014 without it, the duplicate name corrupts the set.\n\n**Add a new value to an existing dimension** (e.g. State=Hover):\n```\ncomponents(method:"clone", id:"<variant_id>", name:"Style=Primary, State=Hover", parentId:"<set_id>")\n```\nClone one variant per combination. For a Style\xD7State set, adding State=Hover requires two clones (one per Style). Use batch `items` for efficiency:\n```\ncomponents(method:"clone", items:[\n  {id:"<Primary/Default>", name:"Style=Primary, State=Hover", parentId:"<set_id>"},\n  {id:"<Secondary/Default>", name:"Style=Secondary, State=Hover", parentId:"<set_id>"}\n])\n```\nThen patch the new variants: `frames(method:"update", items:[{id:"<new>", fillVariableName:"color/hover"}])`\n\n**Add a new dimension** (e.g. Size=sm to a Style\xD7State set):\n1. Batch rename existing variants to include the new dimension: `frames(method:"update", items:[{id:"<each>", name:"..., Size=md"}])`\n2. Batch clone all variants with the new value: `components(method:"clone", items:[{id:"<each>", name:"..., Size=sm", parentId:"<set_id>"}])`\n3. Batch patch the new variants: `frames(method:"update", items:[{id:"<each>", padding:8, minHeight:32}])`\n\nProperty bindings (TEXT, INSTANCE_SWAP) are preserved on cloned variants.\n\n## Checking\n\nRun `components(method:"audit", id)` \u2014 checks both lint rules and property bindings in one call.',
+  "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- 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### Adding Variants to an Existing Set\n\nClone an existing variant into the same set with a new name. The `name` param is required \u2014 without it, the duplicate name corrupts the set.\n\n**Add a new value to an existing dimension** (e.g. State=Hover):\n```\ncomponents(method:"clone", id:"<variant_id>", name:"Style=Primary, State=Hover", parentId:"<set_id>")\n```\nClone one variant per combination. For a Style\xD7State set, adding State=Hover requires two clones (one per Style). Use batch `items` for efficiency:\n```\ncomponents(method:"clone", items:[\n  {id:"<Primary/Default>", name:"Style=Primary, State=Hover", parentId:"<set_id>"},\n  {id:"<Secondary/Default>", name:"Style=Secondary, State=Hover", parentId:"<set_id>"}\n])\n```\nThen patch the new variants: `frames(method:"update", items:[{id:"<new>", fillVariableName:"color/hover"}])`\n\n**Add a new dimension** (e.g. Size=sm to a Style\xD7State set):\n1. Batch rename existing variants to include the new dimension: `frames(method:"update", items:[{id:"<each>", name:"..., Size=md"}])`\n2. Batch clone all variants with the new value: `components(method:"clone", items:[{id:"<each>", name:"..., Size=sm", parentId:"<set_id>"}])`\n3. Batch patch the new variants: `frames(method:"update", items:[{id:"<each>", padding:8, minHeight:32}])`\n\nProperty bindings (TEXT, INSTANCE_SWAP) are preserved on cloned variants.\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## Workflow: Top-Down Sizing\n\nBuild layouts from the outside in:\n\n1. **Set the container first.** Every container needs an explicit width \u2014 either `width` + `layoutSizingHorizontal:"FIXED"` for shells and bounded panels, or `layoutSizingHorizontal:"FILL"` inside an auto-layout parent. Set `layoutMode` (VERTICAL or HORIZONTAL) and spacing/padding.\n2. **Children fill the container.** Use `layoutSizingHorizontal:"FILL"` on children so they stretch to the available space. Use `layoutSizingVertical:"HUG"` so height follows content.\n3. **Only leaves use HUG on both axes.** Buttons, badges, icons \u2014 elements with short, predictable content that should shrink-wrap.\n\nThis ensures every level of the tree has a clear width constraint. Text wraps, FILL children stretch, and the layout adapts when the container resizes.\n\nAlways set BOTH axes explicitly on every node. Omitting sizing leads to unintended defaults.\n\n## FIXED / FILL / HUG\n\n- **FIXED** \u2014 explicit bounded widths: page shell, sidebar, modal max-width, specimen frames\n- **FILL** \u2014 children that adapt to parent: cards, rows, panels, nav stacks, text that should wrap. Use `minWidth`/`maxWidth` for responsive constraints.\n- **HUG** \u2014 content-sized leaves only: icons, badges, pills, button labels\n\n## Anti-patterns: HUG/HUG\n\nHUG on both axes is the most common cause of broken layouts. It means "shrink to fit my content on both axes" \u2014 the container has no opinion about its own size and collapses to whatever its children measure.\n\n**Why HUG/HUG breaks designs:**\n\n1. **Text never wraps.** A HUG-width container grows to fit the longest text line. Body text becomes a single very long line instead of wrapping at a readable width. The design looks correct with short placeholder text but breaks with real content.\n\n2. **Layouts don\'t adapt.** HUG/HUG containers ignore their parent\'s width. A card inside a responsive column won\'t stretch to fill available space \u2014 it stays at its content width, leaving gaps or overflowing.\n\n3. **FILL children become under-constrained.** A child with `layoutSizingHorizontal:"FILL"` inside a HUG-width parent has no space to fill \u2014 the parent defers its width to its children, but the FILL child defers its width to the parent. The result is under-constrained sizing that produces unpredictable or collapsed layouts.\n\n4. **Cascading failures.** One HUG/HUG container at the top of a tree forces every child to resolve its own width. The entire layout becomes rigid and content-dependent instead of responsive.\n\n**HUG/HUG is only correct for:**\n- Buttons, pills, badges, chips \u2014 intrinsically-sized leaf elements with short, predictable content\n- Icon containers with fixed-size children\n- Inline tags and status indicators\n\n**For everything else, set at least one axis to FIXED or FILL:**\n- Cards, panels, list rows \u2192 `layoutSizingHorizontal:"FILL"`, vertical `HUG`. Add `minWidth`/`maxWidth` for responsive bounds.\n- Shells, sidebars, modals \u2192 `width` + `layoutSizingHorizontal:"FIXED"`, vertical `FILL` or `HUG`\n- Full-width sections \u2192 `layoutSizingHorizontal:"FILL"`, `layoutSizingVertical:"HUG"`\n\n## Component Sizing\n\nComponent roots use `FILL` when placed in a parent \u2014 they adapt to context, not a fixed specimen width. Use `FIXED` only for the specimen (the component definition itself when it needs a specific preview 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: prefer `FILL` width, `HUG` height (auto-wraps)\n- Single-line labels: prefer `FILL` horizontal (truncates if needed)\n- Standalone headings: `HUG` is fine\n\nInside auto-layout parents, target `layoutSizingHorizontal:"FILL"` + `layoutSizingVertical:"HUG"` + `textAutoResize:"HEIGHT"` for text that should wrap. These are not auto-applied \u2014 set them explicitly on text.create or text.update.\n\n## Checklist\n\nBefore finalizing a layout, verify:\n1. No container with text has HUG on the horizontal axis (unless it\'s a button/badge)\n2. Children use FILL on the axis that should absorb available space \u2014 not blindly on both axes. Compact controls in horizontal rows often stay HUG vertically.\n3. Top-level containers have an explicit width (FIXED) or stretch to their parent (FILL)\n4. Run `lint(method:"check", nodeId:"<rootId>", rules:["composition"])` to catch overflow-parent, unbounded-hug, and fixed-in-autolayout issues',
   "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.',