@bettercms-ai/mcp 0.18.0 → 0.20.0

package/dist/index.js

@@ -315,6 +315,1970 @@ import { BetterCMS } from "@bettercms-ai/sdk";
 // src/tools.ts
 import { z } from "zod";
 import { BetterCMSError } from "@bettercms-ai/sdk";
+
+// ../types/src/layout-lucide-icons.ts
+var LAYOUT_SECTION_ICONS = Object.freeze([
+  "LayoutPanelTop",
+  "PanelTop",
+  "PanelBottom",
+  "Menu",
+  "Navigation",
+  "Megaphone",
+  "GalleryHorizontal",
+  "Rows3",
+  "Grid2X2",
+  "FileText",
+  "Link",
+  "Contact",
+  "BadgeInfo",
+  "Sparkles",
+  "a-arrow-down",
+  "a-arrow-up",
+  "a-large-small",
+  "accessibility",
+  "activity",
+  "air-vent",
+  "airplay",
+  "alarm-clock-check",
+  "alarm-check",
+  "alarm-clock-minus",
+  "alarm-minus",
+  "alarm-clock-off",
+  "alarm-clock-plus",
+  "alarm-plus",
+  "alarm-clock",
+  "alarm-smoke",
+  "album",
+  "align-center-horizontal",
+  "align-center-vertical",
+  "align-end-horizontal",
+  "align-end-vertical",
+  "align-horizontal-distribute-center",
+  "align-horizontal-distribute-end",
+  "align-horizontal-distribute-start",
+  "align-horizontal-justify-center",
+  "align-horizontal-justify-end",
+  "align-horizontal-justify-start",
+  "align-horizontal-space-around",
+  "align-horizontal-space-between",
+  "align-start-horizontal",
+  "align-start-vertical",
+  "align-vertical-distribute-center",
+  "align-vertical-distribute-end",
+  "align-vertical-distribute-start",
+  "align-vertical-justify-center",
+  "align-vertical-justify-end",
+  "align-vertical-justify-start",
+  "align-vertical-space-around",
+  "align-vertical-space-between",
+  "ambulance",
+  "ampersand",
+  "ampersands",
+  "amphora",
+  "anchor",
+  "angry",
+  "annoyed",
+  "antenna",
+  "anvil",
+  "aperture",
+  "app-window-mac",
+  "app-window",
+  "apple",
+  "archive-restore",
+  "archive-x",
+  "archive",
+  "armchair",
+  "arrow-big-down-dash",
+  "arrow-big-down",
+  "arrow-big-left-dash",
+  "arrow-big-left",
+  "arrow-big-right-dash",
+  "arrow-big-right",
+  "arrow-big-up-dash",
+  "arrow-big-up",
+  "arrow-down-0-1",
+  "arrow-down-01",
+  "arrow-down-1-0",
+  "arrow-down-10",
+  "arrow-down-a-z",
+  "arrow-down-az",
+  "arrow-down-from-line",
+  "arrow-down-left",
+  "arrow-down-narrow-wide",
+  "arrow-down-right",
+  "arrow-down-to-dot",
+  "arrow-down-to-line",
+  "arrow-down-up",
+  "arrow-down-wide-narrow",
+  "sort-desc",
+  "arrow-down-z-a",
+  "arrow-down-za",
+  "arrow-down",
+  "arrow-left-from-line",
+  "arrow-left-right",
+  "arrow-left-to-line",
+  "arrow-left",
+  "arrow-right-from-line",
+  "arrow-right-left",
+  "arrow-right-to-line",
+  "arrow-right",
+  "arrow-up-0-1",
+  "arrow-up-01",
+  "arrow-up-1-0",
+  "arrow-up-10",
+  "arrow-up-a-z",
+  "arrow-up-az",
+  "arrow-up-down",
+  "arrow-up-from-dot",
+  "arrow-up-from-line",
+  "arrow-up-left",
+  "arrow-up-narrow-wide",
+  "sort-asc",
+  "arrow-up-right",
+  "arrow-up-to-line",
+  "arrow-up-wide-narrow",
+  "arrow-up-z-a",
+  "arrow-up-za",
+  "arrow-up",
+  "arrows-up-from-line",
+  "asterisk",
+  "at-sign",
+  "atom",
+  "audio-lines",
+  "audio-waveform",
+  "award",
+  "axe",
+  "axis-3d",
+  "axis-3-d",
+  "baby",
+  "backpack",
+  "badge-alert",
+  "badge-cent",
+  "badge-check",
+  "verified",
+  "badge-dollar-sign",
+  "badge-euro",
+  "badge-indian-rupee",
+  "badge-info",
+  "badge-japanese-yen",
+  "badge-minus",
+  "badge-percent",
+  "badge-plus",
+  "badge-pound-sterling",
+  "badge-question-mark",
+  "badge-help",
+  "badge-russian-ruble",
+  "badge-swiss-franc",
+  "badge-turkish-lira",
+  "badge-x",
+  "badge",
+  "baggage-claim",
+  "balloon",
+  "ban",
+  "banana",
+  "bandage",
+  "banknote-arrow-down",
+  "banknote-arrow-up",
+  "banknote-x",
+  "banknote",
+  "barcode",
+  "barrel",
+  "baseline",
+  "bath",
+  "battery-charging",
+  "battery-full",
+  "battery-low",
+  "battery-medium",
+  "battery-plus",
+  "battery-warning",
+  "battery",
+  "beaker",
+  "bean-off",
+  "bean",
+  "bed-double",
+  "bed-single",
+  "bed",
+  "beef-off",
+  "beef",
+  "beer-off",
+  "beer",
+  "bell-dot",
+  "bell-electric",
+  "bell-minus",
+  "bell-off",
+  "bell-plus",
+  "bell-ring",
+  "bell",
+  "between-horizontal-end",
+  "between-horizonal-end",
+  "between-horizontal-start",
+  "between-horizonal-start",
+  "between-vertical-end",
+  "between-vertical-start",
+  "biceps-flexed",
+  "bike",
+  "binary",
+  "binoculars",
+  "biohazard",
+  "bird",
+  "birdhouse",
+  "bitcoin",
+  "blend",
+  "blinds",
+  "blocks",
+  "bluetooth-connected",
+  "bluetooth-off",
+  "bluetooth-searching",
+  "bluetooth",
+  "bold",
+  "bolt",
+  "bomb",
+  "bone",
+  "book-a",
+  "book-alert",
+  "book-audio",
+  "book-check",
+  "book-copy",
+  "book-dashed",
+  "book-template",
+  "book-down",
+  "book-headphones",
+  "book-heart",
+  "book-image",
+  "book-key",
+  "book-lock",
+  "book-marked",
+  "book-minus",
+  "book-open-check",
+  "book-open-text",
+  "book-open",
+  "book-plus",
+  "book-search",
+  "book-text",
+  "book-type",
+  "book-up-2",
+  "book-up",
+  "book-user",
+  "book-x",
+  "book",
+  "bookmark-check",
+  "bookmark-minus",
+  "bookmark-off",
+  "bookmark-plus",
+  "bookmark-x",
+  "bookmark",
+  "boom-box",
+  "bot-message-square",
+  "bot-off",
+  "bot",
+  "bottle-wine",
+  "bow-arrow",
+  "box",
+  "boxes",
+  "braces",
+  "curly-braces",
+  "brackets",
+  "brain-circuit",
+  "brain-cog",
+  "brain",
+  "brick-wall-fire",
+  "brick-wall-shield",
+  "brick-wall",
+  "briefcase-business",
+  "briefcase-conveyor-belt",
+  "briefcase-medical",
+  "briefcase",
+  "bring-to-front",
+  "brush-cleaning",
+  "brush",
+  "bubbles",
+  "bug-off",
+  "bug-play",
+  "bug",
+  "building-2",
+  "building",
+  "bus-front",
+  "bus",
+  "cable-car",
+  "cable",
+  "cake-slice",
+  "cake",
+  "calculator",
+  "calendar-1",
+  "calendar-arrow-down",
+  "calendar-arrow-up",
+  "calendar-check-2",
+  "calendar-check",
+  "calendar-clock",
+  "calendar-cog",
+  "calendar-days",
+  "calendar-fold",
+  "calendar-heart",
+  "calendar-minus-2",
+  "calendar-minus",
+  "calendar-off",
+  "calendar-plus-2",
+  "calendar-plus",
+  "calendar-range",
+  "calendar-search",
+  "calendar-sync",
+  "calendar-x-2",
+  "calendar-x",
+  "calendar",
+  "calendars",
+  "camera-off",
+  "camera",
+  "candy-cane",
+  "candy-off",
+  "candy",
+  "cannabis-off",
+  "cannabis",
+  "captions-off",
+  "captions",
+  "subtitles",
+  "car-front",
+  "car-taxi-front",
+  "car",
+  "caravan",
+  "card-sim",
+  "carrot",
+  "case-lower",
+  "case-sensitive",
+  "case-upper",
+  "cassette-tape",
+  "cast",
+  "castle",
+  "cat",
+  "cctv-off",
+  "cctv",
+  "chart-area",
+  "area-chart",
+  "chart-bar-big",
+  "bar-chart-horizontal-big",
+  "chart-bar-decreasing",
+  "chart-bar-increasing",
+  "chart-bar-stacked",
+  "chart-bar",
+  "bar-chart-horizontal",
+  "chart-candlestick",
+  "candlestick-chart",
+  "chart-column-big",
+  "bar-chart-big",
+  "chart-column-decreasing",
+  "chart-column-increasing",
+  "bar-chart-4",
+  "chart-column-stacked",
+  "chart-column",
+  "bar-chart-3",
+  "chart-gantt",
+  "chart-line",
+  "line-chart",
+  "chart-network",
+  "chart-no-axes-column-decreasing",
+  "chart-no-axes-column-increasing",
+  "bar-chart",
+  "chart-no-axes-column",
+  "bar-chart-2",
+  "chart-no-axes-combined",
+  "chart-no-axes-gantt",
+  "gantt-chart",
+  "chart-pie",
+  "pie-chart",
+  "chart-scatter",
+  "scatter-chart",
+  "chart-spline",
+  "check-check",
+  "check-line",
+  "check",
+  "chef-hat",
+  "cherry",
+  "chess-bishop",
+  "chess-king",
+  "chess-knight",
+  "chess-pawn",
+  "chess-queen",
+  "chess-rook",
+  "chevron-down",
+  "chevron-first",
+  "chevron-last",
+  "chevron-left",
+  "chevron-right",
+  "chevron-up",
+  "chevrons-down-up",
+  "chevrons-down",
+  "chevrons-left-right-ellipsis",
+  "chevrons-left-right",
+  "chevrons-left",
+  "chevrons-right-left",
+  "chevrons-right",
+  "chevrons-up-down",
+  "chevrons-up",
+  "church",
+  "cigarette-off",
+  "cigarette",
+  "circle-alert",
+  "alert-circle",
+  "circle-arrow-down",
+  "arrow-down-circle",
+  "circle-arrow-left",
+  "arrow-left-circle",
+  "circle-arrow-out-down-left",
+  "arrow-down-left-from-circle",
+  "circle-arrow-out-down-right",
+  "arrow-down-right-from-circle",
+  "circle-arrow-out-up-left",
+  "arrow-up-left-from-circle",
+  "circle-arrow-out-up-right",
+  "arrow-up-right-from-circle",
+  "circle-arrow-right",
+  "arrow-right-circle",
+  "circle-arrow-up",
+  "arrow-up-circle",
+  "circle-check-big",
+  "check-circle",
+  "circle-check",
+  "check-circle-2",
+  "circle-chevron-down",
+  "chevron-down-circle",
+  "circle-chevron-left",
+  "chevron-left-circle",
+  "circle-chevron-right",
+  "chevron-right-circle",
+  "circle-chevron-up",
+  "chevron-up-circle",
+  "circle-dashed",
+  "circle-divide",
+  "divide-circle",
+  "circle-dollar-sign",
+  "circle-dot-dashed",
+  "circle-dot",
+  "circle-ellipsis",
+  "circle-equal",
+  "circle-fading-arrow-up",
+  "circle-fading-plus",
+  "circle-gauge",
+  "gauge-circle",
+  "circle-minus",
+  "minus-circle",
+  "circle-off",
+  "circle-parking-off",
+  "parking-circle-off",
+  "circle-parking",
+  "parking-circle",
+  "circle-pause",
+  "pause-circle",
+  "circle-percent",
+  "percent-circle",
+  "circle-pile",
+  "circle-play",
+  "play-circle",
+  "circle-plus",
+  "plus-circle",
+  "circle-pound-sterling",
+  "circle-power",
+  "power-circle",
+  "circle-question-mark",
+  "help-circle",
+  "circle-help",
+  "circle-slash-2",
+  "circle-slashed",
+  "circle-slash",
+  "circle-small",
+  "circle-star",
+  "circle-stop",
+  "stop-circle",
+  "circle-user-round",
+  "user-circle-2",
+  "circle-user",
+  "user-circle",
+  "circle-x",
+  "x-circle",
+  "circle",
+  "circuit-board",
+  "citrus",
+  "clapperboard",
+  "clipboard-check",
+  "clipboard-clock",
+  "clipboard-copy",
+  "clipboard-list",
+  "clipboard-minus",
+  "clipboard-paste",
+  "clipboard-pen-line",
+  "clipboard-signature",
+  "clipboard-pen",
+  "clipboard-edit",
+  "clipboard-plus",
+  "clipboard-type",
+  "clipboard-x",
+  "clipboard",
+  "clock-1",
+  "clock-10",
+  "clock-11",
+  "clock-12",
+  "clock-2",
+  "clock-3",
+  "clock-4",
+  "clock-5",
+  "clock-6",
+  "clock-7",
+  "clock-8",
+  "clock-9",
+  "clock-alert",
+  "clock-arrow-down",
+  "clock-arrow-up",
+  "clock-check",
+  "clock-fading",
+  "clock-plus",
+  "clock",
+  "closed-caption",
+  "cloud-alert",
+  "cloud-backup",
+  "cloud-check",
+  "cloud-cog",
+  "cloud-download",
+  "download-cloud",
+  "cloud-drizzle",
+  "cloud-fog",
+  "cloud-hail",
+  "cloud-lightning",
+  "cloud-moon-rain",
+  "cloud-moon",
+  "cloud-off",
+  "cloud-rain-wind",
+  "cloud-rain",
+  "cloud-snow",
+  "cloud-sun-rain",
+  "cloud-sun",
+  "cloud-sync",
+  "cloud-upload",
+  "upload-cloud",
+  "cloud",
+  "cloudy",
+  "clover",
+  "club",
+  "code-xml",
+  "code-2",
+  "code",
+  "coffee",
+  "cog",
+  "coins",
+  "columns-2",
+  "columns",
+  "columns-3-cog",
+  "columns-settings",
+  "table-config",
+  "columns-3",
+  "panels-left-right",
+  "columns-4",
+  "combine",
+  "command",
+  "compass",
+  "component",
+  "computer",
+  "concierge-bell",
+  "cone",
+  "construction",
+  "contact-round",
+  "contact-2",
+  "contact",
+  "container",
+  "contrast",
+  "cookie",
+  "cooking-pot",
+  "copy-check",
+  "copy-minus",
+  "copy-plus",
+  "copy-slash",
+  "copy-x",
+  "copy",
+  "copyleft",
+  "copyright",
+  "corner-down-left",
+  "corner-down-right",
+  "corner-left-down",
+  "corner-left-up",
+  "corner-right-down",
+  "corner-right-up",
+  "corner-up-left",
+  "corner-up-right",
+  "cpu",
+  "creative-commons",
+  "credit-card",
+  "croissant",
+  "crop",
+  "cross",
+  "crosshair",
+  "crown",
+  "cuboid",
+  "cup-soda",
+  "currency",
+  "cylinder",
+  "dam",
+  "database-backup",
+  "database-search",
+  "database-zap",
+  "database",
+  "decimals-arrow-left",
+  "decimals-arrow-right",
+  "delete",
+  "dessert",
+  "diameter",
+  "diamond-minus",
+  "diamond-percent",
+  "percent-diamond",
+  "diamond-plus",
+  "diamond",
+  "dice-1",
+  "dice-2",
+  "dice-3",
+  "dice-4",
+  "dice-5",
+  "dice-6",
+  "dices",
+  "diff",
+  "disc-2",
+  "disc-3",
+  "disc-album",
+  "disc",
+  "divide",
+  "dna-off",
+  "dna",
+  "dock",
+  "dog",
+  "dollar-sign",
+  "donut",
+  "door-closed-locked",
+  "door-closed",
+  "door-open",
+  "dot",
+  "download",
+  "drafting-compass",
+  "drama",
+  "drill",
+  "drone",
+  "droplet-off",
+  "droplet",
+  "droplets",
+  "drum",
+  "drumstick",
+  "dumbbell",
+  "ear-off",
+  "ear",
+  "earth-lock",
+  "earth",
+  "globe-2",
+  "eclipse",
+  "egg-fried",
+  "egg-off",
+  "egg",
+  "ellipse",
+  "ellipsis-vertical",
+  "more-vertical",
+  "ellipsis",
+  "more-horizontal",
+  "equal-approximately",
+  "equal-not",
+  "equal",
+  "eraser",
+  "ethernet-port",
+  "euro",
+  "ev-charger",
+  "expand",
+  "external-link",
+  "eye-closed",
+  "eye-off",
+  "eye",
+  "factory",
+  "fan",
+  "fast-forward",
+  "feather",
+  "fence",
+  "ferris-wheel",
+  "file-archive",
+  "file-axis-3d",
+  "file-axis-3-d",
+  "file-badge",
+  "file-badge-2",
+  "file-box",
+  "file-braces-corner",
+  "file-json-2",
+  "file-braces",
+  "file-json",
+  "file-chart-column-increasing",
+  "file-bar-chart",
+  "file-chart-column",
+  "file-bar-chart-2",
+  "file-chart-line",
+  "file-line-chart",
+  "file-chart-pie",
+  "file-pie-chart",
+  "file-check-corner",
+  "file-check-2",
+  "file-check",
+  "file-clock",
+  "file-code-corner",
+  "file-code-2",
+  "file-code",
+  "file-cog",
+  "file-cog-2",
+  "file-diff",
+  "file-digit",
+  "file-down",
+  "file-exclamation-point",
+  "file-warning",
+  "file-headphone",
+  "file-audio",
+  "file-audio-2",
+  "file-heart",
+  "file-image",
+  "file-input",
+  "file-key",
+  "file-key-2",
+  "file-lock",
+  "file-lock-2",
+  "file-minus-corner",
+  "file-minus-2",
+  "file-minus",
+  "file-music",
+  "file-output",
+  "file-pen-line",
+  "file-signature",
+  "file-pen",
+  "file-edit",
+  "file-play",
+  "file-video",
+  "file-plus-corner",
+  "file-plus-2",
+  "file-plus",
+  "file-question-mark",
+  "file-question",
+  "file-scan",
+  "file-search-corner",
+  "file-search-2",
+  "file-search",
+  "file-signal",
+  "file-volume-2",
+  "file-sliders",
+  "file-spreadsheet",
+  "file-stack",
+  "file-symlink",
+  "file-terminal",
+  "file-text",
+  "file-type-corner",
+  "file-type-2",
+  "file-type",
+  "file-up",
+  "file-user",
+  "file-video-camera",
+  "file-video-2",
+  "file-volume",
+  "file-x-corner",
+  "file-x-2",
+  "file-x",
+  "file",
+  "files",
+  "film",
+  "fingerprint-pattern",
+  "fingerprint",
+  "fire-extinguisher",
+  "fish-off",
+  "fish-symbol",
+  "fish",
+  "fishing-hook",
+  "fishing-rod",
+  "flag-off",
+  "flag-triangle-left",
+  "flag-triangle-right",
+  "flag",
+  "flame-kindling",
+  "flame",
+  "flashlight-off",
+  "flashlight",
+  "flask-conical-off",
+  "flask-conical",
+  "flask-round",
+  "flip-horizontal-2",
+  "flip-vertical-2",
+  "flower-2",
+  "flower",
+  "focus",
+  "fold-horizontal",
+  "fold-vertical",
+  "folder-archive",
+  "folder-check",
+  "folder-clock",
+  "folder-closed",
+  "folder-code",
+  "folder-cog",
+  "folder-cog-2",
+  "folder-dot",
+  "folder-down",
+  "folder-git-2",
+  "folder-git",
+  "folder-heart",
+  "folder-input",
+  "folder-kanban",
+  "folder-key",
+  "folder-lock",
+  "folder-minus",
+  "folder-open-dot",
+  "folder-open",
+  "folder-output",
+  "folder-pen",
+  "folder-edit",
+  "folder-plus",
+  "folder-root",
+  "folder-search-2",
+  "folder-search",
+  "folder-symlink",
+  "folder-sync",
+  "folder-tree",
+  "folder-up",
+  "folder-x",
+  "folder",
+  "folders",
+  "footprints",
+  "forklift",
+  "form",
+  "forward",
+  "frame",
+  "frown",
+  "fuel",
+  "fullscreen",
+  "funnel-plus",
+  "funnel-x",
+  "filter-x",
+  "funnel",
+  "filter",
+  "gallery-horizontal-end",
+  "gallery-horizontal",
+  "gallery-thumbnails",
+  "gallery-vertical-end",
+  "gallery-vertical",
+  "gamepad-2",
+  "gamepad-directional",
+  "gamepad",
+  "gauge",
+  "gavel",
+  "gem",
+  "georgian-lari",
+  "ghost",
+  "gift",
+  "git-branch-minus",
+  "git-branch-plus",
+  "git-branch",
+  "git-commit-horizontal",
+  "git-commit",
+  "git-commit-vertical",
+  "git-compare-arrows",
+  "git-compare",
+  "git-fork",
+  "git-graph",
+  "git-merge-conflict",
+  "git-merge",
+  "git-pull-request-arrow",
+  "git-pull-request-closed",
+  "git-pull-request-create-arrow",
+  "git-pull-request-create",
+  "git-pull-request-draft",
+  "git-pull-request",
+  "glass-water",
+  "glasses",
+  "globe-lock",
+  "globe-off",
+  "globe-x",
+  "globe",
+  "goal",
+  "gpu",
+  "graduation-cap",
+  "grape",
+  "grid-2x2-check",
+  "grid-2-x-2-check",
+  "grid-2x2-plus",
+  "grid-2-x-2-plus",
+  "grid-2x2-x",
+  "grid-2-x-2-x",
+  "grid-2x2",
+  "grid-2-x-2",
+  "grid-3x2",
+  "grid-3x3",
+  "grid",
+  "grid-3-x-3",
+  "grip-horizontal",
+  "grip-vertical",
+  "grip",
+  "group",
+  "guitar",
+  "ham",
+  "hamburger",
+  "hammer",
+  "hand-coins",
+  "hand-fist",
+  "hand-grab",
+  "grab",
+  "hand-heart",
+  "hand-helping",
+  "helping-hand",
+  "hand-metal",
+  "hand-platter",
+  "hand",
+  "handbag",
+  "handshake",
+  "hard-drive-download",
+  "hard-drive-upload",
+  "hard-drive",
+  "hard-hat",
+  "hash",
+  "hat-glasses",
+  "haze",
+  "hd",
+  "hdmi-port",
+  "heading-1",
+  "heading-2",
+  "heading-3",
+  "heading-4",
+  "heading-5",
+  "heading-6",
+  "heading",
+  "headphone-off",
+  "headphones",
+  "headset",
+  "heart-crack",
+  "heart-handshake",
+  "heart-minus",
+  "heart-off",
+  "heart-plus",
+  "heart-pulse",
+  "heart",
+  "heater",
+  "helicopter",
+  "hexagon",
+  "highlighter",
+  "history",
+  "hop-off",
+  "hop",
+  "hospital",
+  "hotel",
+  "hourglass",
+  "house-heart",
+  "house-plug",
+  "house-plus",
+  "house-wifi",
+  "house",
+  "home",
+  "ice-cream-bowl",
+  "ice-cream-2",
+  "ice-cream-cone",
+  "ice-cream",
+  "id-card-lanyard",
+  "id-card",
+  "image-down",
+  "image-minus",
+  "image-off",
+  "image-play",
+  "image-plus",
+  "image-up",
+  "image-upscale",
+  "image",
+  "images",
+  "import",
+  "inbox",
+  "indian-rupee",
+  "infinity",
+  "info",
+  "inspection-panel",
+  "italic",
+  "iteration-ccw",
+  "iteration-cw",
+  "japanese-yen",
+  "joystick",
+  "kanban",
+  "kayak",
+  "key-round",
+  "key-square",
+  "key",
+  "keyboard-music",
+  "keyboard-off",
+  "keyboard",
+  "lamp-ceiling",
+  "lamp-desk",
+  "lamp-floor",
+  "lamp-wall-down",
+  "lamp-wall-up",
+  "lamp",
+  "land-plot",
+  "landmark",
+  "languages",
+  "laptop-minimal-check",
+  "laptop-minimal",
+  "laptop-2",
+  "laptop",
+  "lasso-select",
+  "lasso",
+  "laugh",
+  "layers-2",
+  "layers-plus",
+  "layers",
+  "layers-3",
+  "layout-dashboard",
+  "layout-grid",
+  "layout-list",
+  "layout-panel-left",
+  "layout-panel-top",
+  "layout-template",
+  "leaf",
+  "leafy-green",
+  "lectern",
+  "lens-concave",
+  "lens-convex",
+  "library-big",
+  "library",
+  "life-buoy",
+  "ligature",
+  "lightbulb-off",
+  "lightbulb",
+  "line-dot-right-horizontal",
+  "line-squiggle",
+  "line-style",
+  "link-2-off",
+  "link-2",
+  "link",
+  "list-check",
+  "list-checks",
+  "list-chevrons-down-up",
+  "list-chevrons-up-down",
+  "list-collapse",
+  "list-end",
+  "list-filter-plus",
+  "list-filter",
+  "list-indent-decrease",
+  "outdent",
+  "indent-decrease",
+  "list-indent-increase",
+  "indent",
+  "indent-increase",
+  "list-minus",
+  "list-music",
+  "list-ordered",
+  "list-plus",
+  "list-restart",
+  "list-start",
+  "list-todo",
+  "list-tree",
+  "list-video",
+  "list-x",
+  "list",
+  "loader-circle",
+  "loader-2",
+  "loader-pinwheel",
+  "loader",
+  "locate-fixed",
+  "locate-off",
+  "locate",
+  "lock-keyhole-open",
+  "unlock-keyhole",
+  "lock-keyhole",
+  "lock-open",
+  "unlock",
+  "lock",
+  "log-in",
+  "log-out",
+  "logs",
+  "lollipop",
+  "luggage",
+  "magnet",
+  "mail-check",
+  "mail-minus",
+  "mail-open",
+  "mail-plus",
+  "mail-question-mark",
+  "mail-question",
+  "mail-search",
+  "mail-warning",
+  "mail-x",
+  "mail",
+  "mailbox",
+  "mails",
+  "map-minus",
+  "map-pin-check-inside",
+  "map-pin-check",
+  "map-pin-house",
+  "map-pin-minus-inside",
+  "map-pin-minus",
+  "map-pin-off",
+  "map-pin-pen",
+  "location-edit",
+  "map-pin-plus-inside",
+  "map-pin-plus",
+  "map-pin-search",
+  "map-pin-x-inside",
+  "map-pin-x",
+  "map-pin",
+  "map-pinned",
+  "map-plus",
+  "map",
+  "mars-stroke",
+  "mars",
+  "martini",
+  "maximize-2",
+  "maximize",
+  "medal",
+  "megaphone-off",
+  "megaphone",
+  "meh",
+  "memory-stick",
+  "menu",
+  "merge",
+  "message-circle-check",
+  "message-circle-code",
+  "message-circle-dashed",
+  "message-circle-heart",
+  "message-circle-more",
+  "message-circle-off",
+  "message-circle-plus",
+  "message-circle-question-mark",
+  "message-circle-question",
+  "message-circle-reply",
+  "message-circle-warning",
+  "message-circle-x",
+  "message-circle",
+  "message-square-check",
+  "message-square-code",
+  "message-square-dashed",
+  "message-square-diff",
+  "message-square-dot",
+  "message-square-heart",
+  "message-square-lock",
+  "message-square-more",
+  "message-square-off",
+  "message-square-plus",
+  "message-square-quote",
+  "message-square-reply",
+  "message-square-share",
+  "message-square-text",
+  "message-square-warning",
+  "message-square-x",
+  "message-square",
+  "messages-square",
+  "metronome",
+  "mic-off",
+  "mic-vocal",
+  "mic-2",
+  "mic",
+  "microchip",
+  "microscope",
+  "microwave",
+  "milestone",
+  "milk-off",
+  "milk",
+  "minimize-2",
+  "minimize",
+  "minus",
+  "mirror-rectangular",
+  "mirror-round",
+  "monitor-check",
+  "monitor-cloud",
+  "monitor-cog",
+  "monitor-dot",
+  "monitor-down",
+  "monitor-off",
+  "monitor-pause",
+  "monitor-play",
+  "monitor-smartphone",
+  "monitor-speaker",
+  "monitor-stop",
+  "monitor-up",
+  "monitor-x",
+  "monitor",
+  "moon-star",
+  "moon",
+  "motorbike",
+  "mountain-snow",
+  "mountain",
+  "mouse-left",
+  "mouse-off",
+  "mouse-pointer-2-off",
+  "mouse-pointer-2",
+  "mouse-pointer-ban",
+  "mouse-pointer-click",
+  "mouse-pointer",
+  "mouse-right",
+  "mouse",
+  "move-3d",
+  "move-3-d",
+  "move-diagonal-2",
+  "move-diagonal",
+  "move-down-left",
+  "move-down-right",
+  "move-down",
+  "move-horizontal",
+  "move-left",
+  "move-right",
+  "move-up-left",
+  "move-up-right",
+  "move-up",
+  "move-vertical",
+  "move",
+  "music-2",
+  "music-3",
+  "music-4",
+  "music",
+  "navigation-2-off",
+  "navigation-2",
+  "navigation-off",
+  "navigation",
+  "network",
+  "newspaper",
+  "nfc",
+  "non-binary",
+  "notebook-pen",
+  "notebook-tabs",
+  "notebook-text",
+  "notebook",
+  "notepad-text-dashed",
+  "notepad-text",
+  "nut-off",
+  "nut",
+  "octagon-alert",
+  "alert-octagon",
+  "octagon-minus",
+  "octagon-pause",
+  "pause-octagon",
+  "octagon-x",
+  "x-octagon",
+  "octagon",
+  "omega",
+  "option",
+  "orbit",
+  "origami",
+  "package-2",
+  "package-check",
+  "package-minus",
+  "package-open",
+  "package-plus",
+  "package-search",
+  "package-x",
+  "package",
+  "paint-bucket",
+  "paint-roller",
+  "paintbrush-vertical",
+  "paintbrush-2",
+  "paintbrush",
+  "palette",
+  "panda",
+  "panel-bottom-close",
+  "panel-bottom-dashed",
+  "panel-bottom-inactive",
+  "panel-bottom-open",
+  "panel-bottom",
+  "panel-left-close",
+  "sidebar-close",
+  "panel-left-dashed",
+  "panel-left-inactive",
+  "panel-left-open",
+  "sidebar-open",
+  "panel-left-right-dashed",
+  "panel-left",
+  "sidebar",
+  "panel-right-close",
+  "panel-right-dashed",
+  "panel-right-inactive",
+  "panel-right-open",
+  "panel-right",
+  "panel-top-bottom-dashed",
+  "panel-top-close",
+  "panel-top-dashed",
+  "panel-top-inactive",
+  "panel-top-open",
+  "panel-top",
+  "panels-left-bottom",
+  "panels-right-bottom",
+  "panels-top-left",
+  "layout",
+  "paperclip",
+  "parentheses",
+  "parking-meter",
+  "party-popper",
+  "pause",
+  "paw-print",
+  "pc-case",
+  "pen-line",
+  "edit-3",
+  "pen-off",
+  "pen-tool",
+  "pen",
+  "edit-2",
+  "pencil-line",
+  "pencil-off",
+  "pencil-ruler",
+  "pencil",
+  "pentagon",
+  "percent",
+  "person-standing",
+  "philippine-peso",
+  "phone-call",
+  "phone-forwarded",
+  "phone-incoming",
+  "phone-missed",
+  "phone-off",
+  "phone-outgoing",
+  "phone",
+  "pi",
+  "piano",
+  "pickaxe",
+  "picture-in-picture-2",
+  "picture-in-picture",
+  "piggy-bank",
+  "pilcrow-left",
+  "pilcrow-right",
+  "pilcrow",
+  "pill-bottle",
+  "pill",
+  "pin-off",
+  "pin",
+  "pipette",
+  "pizza",
+  "plane-landing",
+  "plane-takeoff",
+  "plane",
+  "play",
+  "plug-2",
+  "plug-zap",
+  "plug-zap-2",
+  "plug",
+  "plus",
+  "pocket-knife",
+  "podcast",
+  "pointer-off",
+  "pointer",
+  "popcorn",
+  "popsicle",
+  "pound-sterling",
+  "power-off",
+  "power",
+  "presentation",
+  "printer-check",
+  "printer-x",
+  "printer",
+  "projector",
+  "proportions",
+  "puzzle",
+  "pyramid",
+  "qr-code",
+  "quote",
+  "rabbit",
+  "radar",
+  "radiation",
+  "radical",
+  "radio-off",
+  "radio-receiver",
+  "radio-tower",
+  "radio",
+  "radius",
+  "rainbow",
+  "rat",
+  "ratio",
+  "receipt-cent",
+  "receipt-euro",
+  "receipt-indian-rupee",
+  "receipt-japanese-yen",
+  "receipt-pound-sterling",
+  "receipt-russian-ruble",
+  "receipt-swiss-franc",
+  "receipt-text",
+  "receipt-turkish-lira",
+  "receipt",
+  "rectangle-circle",
+  "rectangle-ellipsis",
+  "form-input",
+  "rectangle-goggles",
+  "rectangle-horizontal",
+  "rectangle-vertical",
+  "recycle",
+  "redo-2",
+  "redo-dot",
+  "redo",
+  "refresh-ccw-dot",
+  "refresh-ccw",
+  "refresh-cw-off",
+  "refresh-cw",
+  "refrigerator",
+  "regex",
+  "remove-formatting",
+  "repeat-1",
+  "repeat-2",
+  "repeat",
+  "replace-all",
+  "replace",
+  "reply-all",
+  "reply",
+  "rewind",
+  "ribbon",
+  "road",
+  "rocket",
+  "rocking-chair",
+  "roller-coaster",
+  "rose",
+  "rotate-3d",
+  "rotate-3-d",
+  "rotate-ccw-key",
+  "rotate-ccw-square",
+  "rotate-ccw",
+  "rotate-cw-square",
+  "rotate-cw",
+  "route-off",
+  "route",
+  "router",
+  "rows-2",
+  "rows",
+  "rows-3",
+  "panels-top-bottom",
+  "rows-4",
+  "rss",
+  "ruler-dimension-line",
+  "ruler",
+  "russian-ruble",
+  "sailboat",
+  "salad",
+  "sandwich",
+  "satellite-dish",
+  "satellite",
+  "saudi-riyal",
+  "save-all",
+  "save-off",
+  "save",
+  "scale-3d",
+  "scale-3-d",
+  "scale",
+  "scaling",
+  "scan-barcode",
+  "scan-eye",
+  "scan-face",
+  "scan-heart",
+  "scan-line",
+  "scan-qr-code",
+  "scan-search",
+  "scan-text",
+  "scan",
+  "school",
+  "scissors-line-dashed",
+  "scissors",
+  "scooter",
+  "screen-share-off",
+  "screen-share",
+  "scroll-text",
+  "scroll",
+  "search-alert",
+  "search-check",
+  "search-code",
+  "search-slash",
+  "search-x",
+  "search",
+  "section",
+  "send-horizontal",
+  "send-horizonal",
+  "send-to-back",
+  "send",
+  "separator-horizontal",
+  "separator-vertical",
+  "server-cog",
+  "server-crash",
+  "server-off",
+  "server",
+  "settings-2",
+  "settings",
+  "shapes",
+  "share-2",
+  "share",
+  "sheet",
+  "shell",
+  "shelving-unit",
+  "shield-alert",
+  "shield-ban",
+  "shield-check",
+  "shield-cog-corner",
+  "shield-cog",
+  "shield-ellipsis",
+  "shield-half",
+  "shield-minus",
+  "shield-off",
+  "shield-plus",
+  "shield-question-mark",
+  "shield-question",
+  "shield-user",
+  "shield-x",
+  "shield-close",
+  "shield",
+  "ship-wheel",
+  "ship",
+  "shirt",
+  "shopping-bag",
+  "shopping-basket",
+  "shopping-cart",
+  "shovel",
+  "shower-head",
+  "shredder",
+  "shrimp",
+  "shrink",
+  "shrub",
+  "shuffle",
+  "sigma",
+  "signal-high",
+  "signal-low",
+  "signal-medium",
+  "signal-zero",
+  "signal",
+  "signature",
+  "signpost-big",
+  "signpost",
+  "siren",
+  "skip-back",
+  "skip-forward",
+  "skull",
+  "slash",
+  "slice",
+  "sliders-horizontal",
+  "sliders-vertical",
+  "sliders",
+  "smartphone-charging",
+  "smartphone-nfc",
+  "smartphone",
+  "smile-plus",
+  "smile",
+  "snail",
+  "snowflake",
+  "soap-dispenser-droplet",
+  "sofa",
+  "solar-panel",
+  "soup",
+  "space",
+  "spade",
+  "sparkle",
+  "sparkles",
+  "stars",
+  "speaker",
+  "speech",
+  "spell-check-2",
+  "spell-check",
+  "spline-pointer",
+  "spline",
+  "split",
+  "spool",
+  "sport-shoe",
+  "spotlight",
+  "spray-can",
+  "sprout",
+  "square-activity",
+  "activity-square",
+  "square-arrow-down-left",
+  "arrow-down-left-square",
+  "square-arrow-down-right",
+  "arrow-down-right-square",
+  "square-arrow-down",
+  "arrow-down-square",
+  "square-arrow-left",
+  "arrow-left-square",
+  "square-arrow-out-down-left",
+  "arrow-down-left-from-square",
+  "square-arrow-out-down-right",
+  "arrow-down-right-from-square",
+  "square-arrow-out-up-left",
+  "arrow-up-left-from-square",
+  "square-arrow-out-up-right",
+  "arrow-up-right-from-square",
+  "square-arrow-right-enter",
+  "square-arrow-right-exit",
+  "square-arrow-right",
+  "arrow-right-square",
+  "square-arrow-up-left",
+  "arrow-up-left-square",
+  "square-arrow-up-right",
+  "arrow-up-right-square",
+  "square-arrow-up",
+  "arrow-up-square",
+  "square-asterisk",
+  "asterisk-square",
+  "square-bottom-dashed-scissors",
+  "scissors-square-dashed-bottom",
+  "square-centerline-dashed-horizontal",
+  "flip-horizontal",
+  "square-centerline-dashed-vertical",
+  "flip-vertical",
+  "square-chart-gantt",
+  "gantt-chart-square",
+  "square-gantt-chart",
+  "square-check-big",
+  "check-square",
+  "square-check",
+  "check-square-2",
+  "square-chevron-down",
+  "chevron-down-square",
+  "square-chevron-left",
+  "chevron-left-square",
+  "square-chevron-right",
+  "chevron-right-square",
+  "square-chevron-up",
+  "chevron-up-square",
+  "square-code",
+  "code-square",
+  "square-dashed-bottom-code",
+  "square-dashed-bottom",
+  "square-dashed-kanban",
+  "kanban-square-dashed",
+  "square-dashed-mouse-pointer",
+  "mouse-pointer-square-dashed",
+  "square-dashed-text",
+  "text-selection",
+  "text-select",
+  "square-dashed-top-solid",
+  "square-dashed",
+  "box-select",
+  "square-divide",
+  "divide-square",
+  "square-dot",
+  "dot-square",
+  "square-equal",
+  "equal-square",
+  "square-function",
+  "function-square",
+  "square-kanban",
+  "kanban-square",
+  "square-library",
+  "library-square",
+  "square-m",
+  "m-square",
+  "square-menu",
+  "menu-square",
+  "square-minus",
+  "minus-square",
+  "square-mouse-pointer",
+  "inspect",
+  "square-parking-off",
+  "parking-square-off",
+  "square-parking",
+  "parking-square",
+  "square-pause",
+  "square-pen",
+  "pen-box",
+  "edit",
+  "pen-square",
+  "square-percent",
+  "percent-square",
+  "square-pi",
+  "pi-square",
+  "square-pilcrow",
+  "pilcrow-square",
+  "square-play",
+  "play-square",
+  "square-plus",
+  "plus-square",
+  "square-power",
+  "power-square",
+  "square-radical",
+  "square-round-corner",
+  "square-scissors",
+  "scissors-square",
+  "square-sigma",
+  "sigma-square",
+  "square-slash",
+  "slash-square",
+  "square-split-horizontal",
+  "split-square-horizontal",
+  "square-split-vertical",
+  "split-square-vertical",
+  "square-square",
+  "square-stack",
+  "square-star",
+  "square-stop",
+  "square-terminal",
+  "terminal-square",
+  "square-user-round",
+  "user-square-2",
+  "square-user",
+  "user-square",
+  "square-x",
+  "x-square",
+  "square",
+  "squares-exclude",
+  "squares-intersect",
+  "squares-subtract",
+  "squares-unite",
+  "squircle-dashed",
+  "squircle",
+  "squirrel",
+  "stamp",
+  "star-half",
+  "star-off",
+  "star",
+  "step-back",
+  "step-forward",
+  "stethoscope",
+  "sticker",
+  "sticky-note",
+  "stone",
+  "store",
+  "stretch-horizontal",
+  "stretch-vertical",
+  "strikethrough",
+  "subscript",
+  "sun-dim",
+  "sun-medium",
+  "sun-moon",
+  "sun-snow",
+  "sun",
+  "sunrise",
+  "sunset",
+  "superscript",
+  "swatch-book",
+  "swiss-franc",
+  "switch-camera",
+  "sword",
+  "swords",
+  "syringe",
+  "table-2",
+  "table-cells-merge",
+  "table-cells-split",
+  "table-columns-split",
+  "table-of-contents",
+  "table-properties",
+  "table-rows-split",
+  "table",
+  "tablet-smartphone",
+  "tablet",
+  "tablets",
+  "tag",
+  "tags",
+  "tally-1",
+  "tally-2",
+  "tally-3",
+  "tally-4",
+  "tally-5",
+  "tangent",
+  "target",
+  "telescope",
+  "tent-tree",
+  "tent",
+  "terminal",
+  "test-tube-diagonal",
+  "test-tube-2",
+  "test-tube",
+  "test-tubes",
+  "text-align-center",
+  "align-center",
+  "text-align-end",
+  "align-right",
+  "text-align-justify",
+  "align-justify",
+  "text-align-start",
+  "text",
+  "align-left",
+  "text-cursor-input",
+  "text-cursor",
+  "text-initial",
+  "letter-text",
+  "text-quote",
+  "text-search",
+  "text-wrap",
+  "wrap-text",
+  "theater",
+  "thermometer-snowflake",
+  "thermometer-sun",
+  "thermometer",
+  "thumbs-down",
+  "thumbs-up",
+  "ticket-check",
+  "ticket-minus",
+  "ticket-percent",
+  "ticket-plus",
+  "ticket-slash",
+  "ticket-x",
+  "ticket",
+  "tickets-plane",
+  "tickets",
+  "timer-off",
+  "timer-reset",
+  "timer",
+  "toggle-left",
+  "toggle-right",
+  "toilet",
+  "tool-case",
+  "toolbox",
+  "tornado",
+  "torus",
+  "touchpad-off",
+  "touchpad",
+  "towel-rack",
+  "tower-control",
+  "toy-brick",
+  "tractor",
+  "traffic-cone",
+  "train-front-tunnel",
+  "train-front",
+  "train-track",
+  "tram-front",
+  "train",
+  "transgender",
+  "trash-2",
+  "trash",
+  "tree-deciduous",
+  "tree-palm",
+  "palmtree",
+  "tree-pine",
+  "trees",
+  "trending-down",
+  "trending-up-down",
+  "trending-up",
+  "triangle-alert",
+  "alert-triangle",
+  "triangle-dashed",
+  "triangle-right",
+  "triangle",
+  "trophy",
+  "truck-electric",
+  "truck",
+  "turkish-lira",
+  "turntable",
+  "turtle",
+  "tv-minimal-play",
+  "tv-minimal",
+  "tv-2",
+  "tv",
+  "type-outline",
+  "type",
+  "umbrella-off",
+  "umbrella",
+  "underline",
+  "undo-2",
+  "undo-dot",
+  "undo",
+  "unfold-horizontal",
+  "unfold-vertical",
+  "ungroup",
+  "university",
+  "school-2",
+  "unlink-2",
+  "unlink",
+  "unplug",
+  "upload",
+  "usb",
+  "user-check",
+  "user-cog",
+  "user-key",
+  "user-lock",
+  "user-minus",
+  "user-pen",
+  "user-plus",
+  "user-round-check",
+  "user-check-2",
+  "user-round-cog",
+  "user-cog-2",
+  "user-round-key",
+  "user-round-minus",
+  "user-minus-2",
+  "user-round-pen",
+  "user-round-plus",
+  "user-plus-2",
+  "user-round-search",
+  "user-round-x",
+  "user-x-2",
+  "user-round",
+  "user-2",
+  "user-search",
+  "user-star",
+  "user-x",
+  "user",
+  "users-round",
+  "users-2",
+  "users",
+  "utensils-crossed",
+  "fork-knife-crossed",
+  "utensils",
+  "fork-knife",
+  "utility-pole",
+  "van",
+  "variable",
+  "vault",
+  "vector-square",
+  "vegan",
+  "venetian-mask",
+  "venus-and-mars",
+  "venus",
+  "vibrate-off",
+  "vibrate",
+  "video-off",
+  "video",
+  "videotape",
+  "view",
+  "voicemail",
+  "volleyball",
+  "volume-1",
+  "volume-2",
+  "volume-off",
+  "volume-x",
+  "volume",
+  "vote",
+  "wallet-cards",
+  "wallet-minimal",
+  "wallet-2",
+  "wallet",
+  "wallpaper",
+  "wand-sparkles",
+  "wand-2",
+  "wand",
+  "warehouse",
+  "washing-machine",
+  "watch",
+  "waves-arrow-down",
+  "waves-arrow-up",
+  "waves-ladder",
+  "waves",
+  "waypoints",
+  "webcam",
+  "webhook-off",
+  "webhook",
+  "weight-tilde",
+  "weight",
+  "wheat-off",
+  "wheat",
+  "whole-word",
+  "wifi-cog",
+  "wifi-high",
+  "wifi-low",
+  "wifi-off",
+  "wifi-pen",
+  "wifi-sync",
+  "wifi-zero",
+  "wifi",
+  "wind-arrow-down",
+  "wind",
+  "wine-off",
+  "wine",
+  "workflow",
+  "worm",
+  "wrench",
+  "x-line-top",
+  "x",
+  "zap-off",
+  "zap",
+  "zodiac-aquarius",
+  "zodiac-aries",
+  "zodiac-cancer",
+  "zodiac-capricorn",
+  "zodiac-gemini",
+  "zodiac-leo",
+  "zodiac-libra",
+  "zodiac-ophiuchus",
+  "zodiac-pisces",
+  "zodiac-sagittarius",
+  "zodiac-scorpio",
+  "zodiac-taurus",
+  "zodiac-virgo",
+  "zoom-in",
+  "zoom-out"
+]);
+var LAYOUT_SECTION_ICON_SET = new Set(LAYOUT_SECTION_ICONS);
+
+// src/tools.ts
 var FRAMEWORK_CHOICES = ["astro", "next", "react-ts", "other"];
 var FRAMEWORK_LABELS = {
   astro: "Astro \u2014 recommended default, static by default and fastest to publish",
@@ -381,7 +2345,22 @@ var fieldType = z.enum([
   // `config` verbatim — which is what the warning above demands before adding a type here.
   // `modular` needs config.blockSlugs; `location` takes no config.
   "modular",
-  "location"
+  "location",
+  // All LEAF types, so the pass-through branch above covers them. `document` is THE article
+  // body — the rich document canvas, collections only, at most one per model, top level
+  // only. It was the conspicuous omission: the dashboard shipped an editor for it while no
+  // agent could create the field. `sections` is a page-section zone composed in the Visual
+  // Editor, so it has no inline control.
+  "document",
+  "longtext",
+  "slug",
+  "email",
+  "phone",
+  "link",
+  "color",
+  "json",
+  "file",
+  "sections"
 ]);
 var slug = z.string().regex(/^[a-z0-9-]+$/, "lowercase letters, numbers, and hyphens only");
 var fieldKey = z.string().regex(/^[a-zA-Z0-9_]+$/, "letters, numbers, and underscores only");
@@ -493,12 +2472,42 @@ function buildToolDefs(deps) {
       }
     };
   }
+  const blockObject = z.object({
+    type: z.enum([
+      "heading",
+      "text",
+      "richtext",
+      "image",
+      "button",
+      "spacer",
+      "video",
+      "columns",
+      "section",
+      "slider",
+      "tabs",
+      "navbar",
+      "footer",
+      "form",
+      "component",
+      "collection"
+    ]).describe("block type; section/slider/tabs/columns nest child blocks"),
+    id: z.string().min(1).describe("stable unique block id"),
+    props: z.record(z.string(), z.unknown()).describe(
+      "per-type props: heading {text, level}; text/richtext {html} (NOT {text}); image {src, alt}; button {text, href}; spacer {height}; video {url}; form {formId}; component {componentId, overrides?}; navbar {links:[{label,href}], logo?, cta?}; footer {columns, copyright?}; section {children: block[]}; columns {columns: block[][], gap} \u2014 a column may NOT hold columns/section/slider/tabs; slider {slides:[{id,children}]}; tabs {tabs:[{id,label,children}]}; collection {cardComponentId?, detailComponentId?, titleField?, excerptField?, limit?, order?, emptyText?} \u2014 lists this page's published entries as cards, and renders ONE entry on /<page>/<entrySlug>"
+    ),
+    style: z.record(z.string(), z.unknown()).optional().describe(
+      "design tokens: theme, bg (none|surface|muted|accent|dark|custom), bgCustom hex, paddingTop/paddingBottom/paddingSides px, contentWidth (narrow|default|wide|full), align, corner, shadow, borderTop/borderBottom. A real marketing band is a `section` block carrying bg + padding + contentWidth."
+    )
+  });
   const createPageInput = z.object({
     title: z.string().min(1).describe("display title of the page, e.g. 'Home'"),
     slug: slug.describe("URL-safe path segment, unique per project, e.g. 'home'"),
     pageType: z.enum(["singleton", "dynamic"]).default("singleton").describe(
       "'singleton' = exactly one entry (Home, About, Contact); 'dynamic' = many entries sharing this schema (Blog posts, Products). Defaults to singleton."
     ),
+    blockJson: z.array(blockObject).optional().describe(
+      "the page's VISUAL composition \u2014 how a components-first page is built. Place one `component` block per section: {type:'component', id:'<stable>', props:{componentId:'<id from create_component>'}}. The component must be PUBLISHED (publish_component) or it renders as nothing on the live site. Independent of `fields`, which is a typed schema for a site's own code to read."
+    ),
     fields: z.array(fieldObject).optional().describe("the page's typed schema fields"),
     metaTitle: z.string().optional().describe("SEO meta title"),
     metaDescription: z.string().optional().describe("SEO meta description")
@@ -629,20 +2638,53 @@ function buildToolDefs(deps) {
     fields: z.array(formFieldObject).optional().describe("REPLACES the field array \u2014 include all fields to keep"),
     ...formSettingsShape
   });
-  const blockObject = z.object({
-    type: z.enum(["heading", "text", "image", "button", "spacer", "video", "columns"]).describe("block type; 'columns' nests child blocks in props.columns"),
-    id: z.string().min(1).describe("stable unique block id"),
-    props: z.record(z.string(), z.unknown()).describe(
-      "per-type props: heading {text, level}; text {text}; image {src, alt}; button {text, href}; spacer {height}; video {url}; columns {columns: block[][], gap}"
-    )
-  });
   const componentPropObject = z.object({
     key: z.string().min(1),
     label: z.string().min(1),
     target: z.object({ blockId: z.string().min(1), path: z.string().min(1) }),
-    type: z.enum(["text", "richtext", "image", "url", "boolean"]),
+    type: z.enum(["text", "richtext", "image", "url", "boolean", "slot"]),
+    // 'slot' holds ONE nested component instance; config.componentIds restricts what may
+    // fill it. Absent here until now, so a slot allowlist was unreachable from stdio even
+    // once the enum allowed the type.
+    config: z.object({ componentIds: z.array(z.string()).optional() }).optional(),
     defaultValue: z.unknown().optional()
   });
+  const getLayoutInput = z.object({
+    scope: z.enum(["global", "page"]).default("global"),
+    pageId: z.string().min(1).optional().describe("page id or slug; required for page scope"),
+    projectId: z.string().min(1).optional().describe("required only for a workspace-scoped grant")
+  });
+  const layoutBinding = z.object({ inputId: z.string().min(1), fieldId: z.string().min(1) });
+  const layoutIcon = z.string().min(1).max(80).regex(/^(?:[a-z0-9]+(?:-[a-z0-9]+)*|[A-Z][A-Za-z0-9]+)$/).refine((value) => LAYOUT_SECTION_ICON_SET.has(value), "Select a supported Lucide icon").describe("Lucide icon name in canonical kebab-case; legacy CamelCase Layout icon names remain accepted");
+  const sectionTarget = { sectionId: z.string().min(1) };
+  const layoutCommand = z.discriminatedUnion("type", [
+    z.object({ type: z.literal("set-section-values"), ...sectionTarget, values: z.record(z.string(), z.unknown()) }),
+    z.object({ type: z.literal("set-field-value"), ...sectionTarget, fieldId: z.string().min(1), value: z.unknown() }),
+    z.object({ type: z.literal("add-component"), ...sectionTarget, componentId: z.string().min(1), variantGroupId: z.string().min(1).optional(), bindings: z.array(layoutBinding).optional(), literalValues: z.record(z.string(), z.unknown()).optional() }),
+    z.object({ type: z.literal("remove-item"), ...sectionTarget, itemId: z.string().min(1) }),
+    z.object({ type: z.literal("move-component"), ...sectionTarget, itemId: z.string().min(1), index: z.number().int().nonnegative() }),
+    z.object({ type: z.literal("move-item"), ...sectionTarget, itemId: z.string().min(1), index: z.number().int().nonnegative() }),
+    z.object({ type: z.literal("swap-component-variant"), ...sectionTarget, itemId: z.string().min(1), componentId: z.string().min(1) }),
+    z.object({ type: z.literal("set-page-state"), ...sectionTarget, state: z.enum(["inherit", "override-content", "customize-structure", "disable", "reset"]) }),
+    z.object({ type: z.literal("set-section-state"), ...sectionTarget, state: z.enum(["inherit", "override-content", "customize-structure", "disable", "reset"]) }),
+    z.object({ type: z.literal("add-section"), name: z.string().min(1), icon: layoutIcon, zone: z.enum(["before_page", "after_page"]) }),
+    z.object({ type: z.literal("restore-section"), section: z.object({ id: z.string().min(1) }).passthrough(), data: z.object({ fields: z.record(z.string(), z.unknown()) }), placement: z.object({ zone: z.enum(["above-page-content", "below-page-content"]), localOrderKey: z.string().min(1), afterSectionId: z.string().optional(), beforeSectionId: z.string().optional() }).optional() }),
+    z.object({ type: z.literal("update-section"), ...sectionTarget, name: z.string().min(1).optional(), icon: layoutIcon.optional(), slug: z.string().min(1).optional(), zone: z.enum(["above-page-content", "below-page-content"]).optional(), orderKey: z.string().min(1).optional() }),
+    z.object({ type: z.literal("remove-section"), ...sectionTarget }),
+    z.object({ type: z.literal("move-section"), ...sectionTarget, afterId: z.string().nullable().optional(), beforeId: z.string().nullable().optional() }),
+    z.object({ type: z.literal("add-field"), ...sectionTarget, parentFieldId: z.string().optional(), fieldType: z.enum(["text", "longtext", "richtext", "number", "toggle", "date", "image", "file", "link", "email", "phone", "select", "color", "json", "reference", "multi-reference", "group", "repeater"]).optional(), field: z.object({ id: z.string(), slug: z.string(), label: z.string(), type: z.string() }).passthrough().optional() }),
+    z.object({ type: z.literal("update-field"), ...sectionTarget, fieldId: z.string().min(1), patch: z.object({}).passthrough() }),
+    z.object({ type: z.literal("remove-field"), ...sectionTarget, fieldId: z.string().min(1) }),
+    z.object({ type: z.literal("move-field"), ...sectionTarget, itemId: z.string().min(1), index: z.number().int().nonnegative() }),
+    z.object({ type: z.literal("set-bindings"), ...sectionTarget, itemId: z.string().min(1), bindings: z.array(layoutBinding), literalValues: z.record(z.string(), z.unknown()).optional() })
+  ]);
+  const commandLayoutInput = z.object({
+    scope: z.enum(["global", "page"]).default("global"),
+    pageId: z.string().min(1).optional(),
+    projectId: z.string().min(1).optional().describe("required only for a workspace-scoped grant"),
+    command: layoutCommand.describe("one canonical discriminated Layout command; authority is derived from type"),
+    ifMatch: z.number().int().nonnegative().describe("revision returned by get_layout")
+  });
   const componentCategory = z.enum([
     "navbar",
     "footer",
@@ -988,10 +3030,10 @@ function buildToolDefs(deps) {
       // ── Pages (metadata edit; parity with remote /mcp) ──
       def(
         "update_page",
-        "Edit a page's metadata",
-        "Edit a page's metadata \u2014 title, slug, SEO metaTitle/metaDescription, and publish status (draft|published). This is the slug/title/SEO editor (it does NOT change the field schema or content \u2014 use add_page_field / set_page_content for those). Renaming the slug keeps the page's content intact. Provide pageId plus the fields to change.",
-        z.object({ pageId: z.string().min(1), title: z.string().optional(), slug: z.string().optional(), metaTitle: z.string().optional(), metaDescription: z.string().optional(), status: z.enum(["draft", "published"]).optional() }).shape,
-        async (c, a) => ok("Updated page.", await data(c, "PATCH", `/management/pages/${s(a.pageId)}/meta`, { title: a.title, slug: a.slug, metaTitle: a.metaTitle, metaDescription: a.metaDescription, status: a.status }))
+        "Edit a page",
+        "Edit a page: title, slug, SEO metaTitle/metaDescription, publish status (draft|published), and `blockJson` (its block composition \u2014 passing it REPLACES the whole array, so read get_page first). It does NOT change the field SCHEMA \u2014 use add_page_field / set_page_content for that. Renaming the slug keeps content intact. Publishing copies the draft blocks live in the same call.",
+        z.object({ pageId: z.string().min(1), title: z.string().optional(), slug: z.string().optional(), blockJson: z.array(blockObject).optional().describe("REPLACES the page's block composition"), metaTitle: z.string().optional(), metaDescription: z.string().optional(), status: z.enum(["draft", "published"]).optional() }).shape,
+        async (c, a) => ok("Updated page.", await data(c, "PATCH", `/management/pages/${s(a.pageId)}/meta`, { title: a.title, slug: a.slug, blockJson: a.blockJson, metaTitle: a.metaTitle, metaDescription: a.metaDescription, status: a.status }))
       ),
       // ── Code + deploy (parity with remote /mcp; needs artifact:write) ──
       def(
@@ -1037,6 +3079,13 @@ function buildToolDefs(deps) {
         z.object({ since: z.string().datetime(), limit: z.number().int().min(1).max(100).optional() }).shape,
         async (c, a) => ok("Project changes.", await data(c, "GET", `/management/insights/activity${q({ since: a.since, limit: a.limit ?? 100 })}`))
       ),
+      def(
+        "get_next_steps",
+        "Get what to do next",
+        "What is still unfinished in the connected project, as the platform sees it \u2014 pages you created without a meta description, drafts never published, collections with no entries, forms nobody is notified about, writes waiting for human approval. Each item cites the count it reacted to. Call it AFTER a batch of edits to catch what you left behind, and before telling the user you are done.",
+        z.object({}).shape,
+        async (c) => ok("Next steps.", await data(c, "GET", `/management/insights/next-steps`))
+      ),
       def(
         "get_analytics_overview",
         "Get traffic overview",
@@ -1170,6 +3219,7 @@ function buildToolDefs(deps) {
             title: args.title,
             slug: args.slug,
             pageType: args.pageType ?? "singleton",
+            ...args.blockJson ? { blockJson: args.blockJson } : {},
             ...args.fields ? { fields: args.fields.map(toField) } : {},
             ...args.metaTitle !== void 0 ? { metaTitle: args.metaTitle } : {},
             ...args.metaDescription !== void 0 ? { metaDescription: args.metaDescription } : {}
@@ -1456,6 +3506,31 @@ function buildToolDefs(deps) {
         })
       )
     },
+    // ── Project/page Layout (draft-only; publish remains dashboard-gated) ──
+    {
+      name: "get_layout",
+      config: {
+        title: "Get the project or page Layout draft",
+        description: "Read the Global Layout or one page's Layout override, including its optimistic revision. Always read this before update_layout.",
+        inputSchema: getLayoutInput.shape
+      },
+      handler: guard(async (args) => withClient(async (client) => {
+        const layout = await client.getManagedLayout(args);
+        return ok(`${layout.scope === "global" ? "Global" : `Page ${layout.pageSlug}`} Layout draft at revision ${layout.revision}.`, layout);
+      }))
+    },
+    {
+      name: "update_layout",
+      config: {
+        title: "Apply one Layout draft command",
+        description: "Apply one permission-shaped values/composition/schema command to the Global Layout or a page override. Draft-only: this never publishes. Pass the revision from get_layout as ifMatch.",
+        inputSchema: commandLayoutInput.shape
+      },
+      handler: guard(async (args) => withClient(async (client) => {
+        const layout = await client.commandManagedLayout({ ...args, command: args.command });
+        return ok(`Updated ${layout.scope === "global" ? "Global" : `Page ${layout.pageSlug}`} Layout draft to revision ${layout.revision}.`, layout);
+      }))
+    },
     // ── Components (discover + author reusable symbols) ──
     {
       name: "list_components",
@@ -1555,6 +3630,23 @@ ${lines.join("\n")}`, found);
         })
       )
     },
+    {
+      name: "publish_component",
+      config: {
+        title: "Publish a component",
+        description: "Publish a component: copy its DRAFT definition to the live copy and re-bake every published page that embeds it. This is the ONLY way a component reaches the live site \u2014 create_component and update_component write drafts, and an unpublished component renders as NOTHING on the live site, with no error. Publish every component you place on a page. 403 PUBLISH_NOT_GRANTED means this connection may author but not publish: say so and let the user publish from the dashboard. 422 means publishing would break a Layout that uses it \u2014 the response names which.",
+        inputSchema: getComponentInput.shape
+      },
+      handler: guard(
+        async (args) => withClient(async (client) => {
+          const res = await client.fetchJSON(
+            client.url(`/management/components/${args.componentId}/publish`),
+            { method: "POST" }
+          );
+          return ok("Published component.", res.data);
+        })
+      )
+    },
     // ── AI content + SEO actions (Option B) ────────────────────────────────────
     {
       name: "write_content",
@@ -1604,29 +3696,144 @@ function registerTools(server, deps) {
 
 // src/prompts.ts
 import { z as z2 } from "zod";
-var SCHEMA_PROPOSAL_FLOW = `### Whole-project schema design (declarative, confirm-first) \u2192 \`create_page\` / \`add_field\`
-Design the WHOLE project's content schema from its code, and **confirm the
-shape with the user BEFORE creating anything**. Never silently guess.
-1. **Read the project's code** \u2014 the connected git repo OR, for an uploaded project,
-   its source in your current working directory (same thing: pages/routes and their
-   components). For each page, identify the editable regions and how they're structured.
-2. **Destructure every page into a tree**, do NOT flatten. Map each region to:
-   - a plain field (text/richtext/image/number/boolean/select/date/datetime/reference),
-   - a **group** (Non-Repeatable Zone \u2014 a fixed grouped block, e.g. a hero with
-     heading + subheading + image), or
-   - a **repeater** (Repeatable Zone / section-list \u2014 a repeating list of items
-     such as feature cards, testimonials, FAQs, pricing tiers), each carrying its
-     own child \`fields\`. Use \`array\` only for primitive lists (tags, bullet strings).
-   Decide pageType per page: singleton (Home/About/Contact) vs dynamic (Blog/Products).
-3. **Present the proposal for confirmation (REQUIRED gate).** Show the full tree \u2014
-   page \u2192 zones \u2192 nested fields, with each zone labelled group vs repeater \u2014 and ask
-   the user (AskUserQuestion) to confirm or adjust: which zones repeat, what fields
-   each holds, singleton vs dynamic, any missing/extra pages. Iterate until they
-   approve. Do NOT call create_page / add_field before this approval.
-4. **Build it** \u2014 once approved, call \`create_page\` once per page with the full
-   nested \`fields\` tree; use \`add_field\`/\`add_page_field\` only to extend later.
-   Keep field keys stable and human-readable. Schema only \u2014 no content yet.
-Field object: { key, label, type, required?, options?, config?, fields? }.`;
+
+// src/playbook.ts
+var SCHEMA_PLAYBOOK = `# Designing a BetterCMS project
+
+Read this BEFORE creating anything. Confirm the shape with the user before you build it.
+
+## 1. Pick the architecture first
+
+**Components-first** \u2014 a marketing site. A library of reusable *components*, each a
+section, and thin pages that place them. Editors add, reorder and swap sections without
+touching a schema. This is what \`create_component\` + \`create_page(blockJson)\` are for.
+
+**Schema-first** \u2014 a blog, a product catalogue, a directory: many rows sharing one shape.
+A collection (\`create_content_model\`) plus entries.
+
+Most real sites are both: components for the marketing pages, a collection for the blog.
+Decide before your first call; converting later means rewriting content.
+
+## 2. The decision tree
+
+    Repeated visual region on a page?      -> a COMPONENT with sectionType (a Section)
+      ...and it comes in more than one look? -> siblings sharing that sectionType = VARIANTS
+    A stack of mixed, reorderable content? -> kind:'block' models + a \`modular\` field
+    A row in a list (post, author, tier)?  -> a collection (kind:'model')
+    The one body of an article?            -> type:'document'  (exactly one, top level)
+    A fixed cluster of fields?             -> group     (never a 1-item repeater)
+    A repeating cluster?                   -> repeater
+    A list of plain strings?               -> array     (never a repeater of one text)
+    Site-wide nav/footer?                  -> place the project's provisioned components
+
+## 3. Anatomy of a real section component
+
+A component that is only headings and text renders as an unstyled stack. Every section the
+product ships looks like this \u2014 a \`section\` block carrying \`style\`, with content nested in
+\`props.children\`:
+
+    {
+      type: "section", id: "root",
+      style: { bg: "surface", paddingTop: 96, paddingBottom: 96, contentWidth: "default", align: "center" },
+      props: { children: [
+        { type: "heading", id: "h",   props: { text: "Headline", level: 2 } },
+        { type: "text",    id: "sub", props: { html: "<p>Supporting copy.</p>" } },
+        { type: "button",  id: "cta", props: { text: "Get started", href: "/signup", variant: "primary" } }
+      ] }
+    }
+
+Then declare what an editor may change, via \`props\`:
+
+    props: [
+      { key: "headline", label: "Headline", target: { blockId: "h",   path: "props.text" }, type: "text" },
+      { key: "body",     label: "Body",     target: { blockId: "sub", path: "props.html" }, type: "richtext" },
+      { key: "ctaHref",  label: "CTA link", target: { blockId: "cta", path: "props.href" }, type: "url" }
+    ]
+
+Declare props only for what should really be editable. Every prop is a decision an editor
+has to make.
+
+## 4. Variants
+
+Components sharing a \`sectionType\` are swappable layouts of one section family \u2014 "Hero
+centered" and "Hero split" both with \`sectionType: "Hero"\`. Swapping is one write and
+keeps content, because overrides are keyed by prop KEY.
+
+So **use the same prop keys across a family**. A variant that calls it \`title\` where its
+sibling calls it \`headline\` silently drops that content on the swap.
+
+Pair \`sectionType\` with a library \`category\` (hero, content, social-proof, conversion) or
+the component never appears in the editor's "Add a section" picker.
+
+## 5. Blocks and modular fields
+
+A \`kind:'block'\` model holds no entries of its own; it exists to be stacked inside another
+model's \`modular\` field. Create the blocks FIRST, then name their slugs (not ids) in
+\`config.blockSlugs\`. This is the page-builder shape: one \`sections\` field holding an
+ordered list of typed blocks.
+
+## 6. Blogs
+
+    author     collection: name, avatar, bio
+    blog-post  collection: title, slug, excerpt, cover (image),
+               body (document), author (reference -> author)
+
+\`document\` is THE article body: a rich document canvas, **collections only**, at most one
+per model, top level only (never inside a group or repeater). A page's body is its block
+content, so \`document\` on a page is rejected. Use \`richtext\` for a short formatted field,
+\`longtext\` for multi-line plain text.
+
+Then the pages:
+
+    create_page slug:"blog" pageType:"dynamic" fields:[...the post schema...]
+      blockJson: [ nav, heading, { type:"collection", id:"list", props:{} }, footer ]
+
+    create_content_entry per post, with pageId set to that page
+
+The \`collection\` block is lane-aware: on \`/blog\` it renders a card per entry, and on
+\`/blog/<slug>\` it renders THAT entry. One page, both jobs. Every OTHER block in the array
+is interpolated per entry with \`{{fieldKey}}\` placeholders \u2014 \`{{title}}\`, \`{{cover.url}}\`,
+\`{{body.html}}\`. Note that richtext and document bind to \`.html\` only, never the bare name.
+
+## 7. Order of operations
+
+    1. blocks       create_content_model kind:'block'   (before anything references them)
+    2. collections  create_content_model
+    3. components   create_component                     (they land as DRAFTS)
+    4. publish      publish_component  <- every component you intend to place
+    5. pages        create_page with blockJson placing those components
+    6. content      create_content_entry / set_page_content
+    7. publish      update_page status:'published'
+    8. check        get_next_steps, and fix what it lists
+
+## 8. Two ways to ship a blank site
+
+**An unpublished component renders as an empty string.** Not an error, not a placeholder \u2014
+nothing, on a page that returns 200. If a section is missing from the live site, check
+\`publish_component\` before anything else.
+
+**A workspace-level component (\`projectId: null\`) never reaches a live site.** It resolves
+in preview and is blank in production. Always pass the project's id.
+`;
+
+// src/prompts.ts
+var SCHEMA_PROPOSAL_FLOW = `### Whole-project design (confirm-first) \u2192 \`create_component\` / \`create_page\` / \`create_content_model\`
+Design the WHOLE project from its brief or its code, and **confirm the shape with the user
+BEFORE creating anything**. Never silently guess.
+
+1. **Read the source** \u2014 the connected repo, or the uploaded project in your working
+   directory. For each page, identify the repeated visual regions and the list-shaped data.
+2. **Classify every part** using the decision tree in the playbook below. The two mistakes
+   that matter: flattening a marketing page into loose page fields when its sections should
+   be COMPONENTS, and giving a blog a \`richtext\` field when its body should be \`document\`.
+3. **Present the proposal (REQUIRED gate).** Show the component library (with each section's
+   family and variants), the collections and their fields, and the pages that place them.
+   Ask the user (AskUserQuestion) to confirm or adjust. Do not create anything before this.
+4. **Build it in the playbook's order** \u2014 blocks, collections, components, PUBLISH the
+   components, pages, content, publish. Skipping the publish step ships a blank site.
+
+${SCHEMA_PLAYBOOK}
+`;
 var PAGE_FLOW = `### Page authoring \u2192 \`create_page\` tool
 Author a page (the page-first schema). Ask, in order, via AskUserQuestion:
 1. **Page type** \u2014 singleton (exactly one entry: Home, About, Contact) vs dynamic
@@ -1669,20 +3876,36 @@ Author a form (then the user embeds it with \`<BcmsForm form={getForm('Name')} /
 4. **Confirm**, then \`create_form\` { name, fields, ... } (returns the new id), or
    \`update_form\` { formId, ... } to edit (passing \`fields\` REPLACES the array \u2014 include all).
 5. Offer to wire \`<BcmsForm>\` into the page/component where the user wants it.`;
-var COMPONENT_FLOW = `### Component authoring \u2192 \`create_component\` / \`update_component\` tools
-Author a reusable component (Webflow-style symbol) the user renders with \`<BcmsBlocks>\`.
-blockJson is the visual definition; authoring it blind is error-prone, so go slow and
-confirm. Never guess the layout.
+var COMPONENT_FLOW = `### Component authoring \u2192 \`create_component\` / \`publish_component\`
+Author a reusable section. blockJson is the visual definition; authoring it blind is
+error-prone, so go slow and confirm. Never guess the layout.
 1. **Discover** \u2014 \`list_components\` / \`get_component\` (read before update; keep existing blocks).
-2. **Design the blockJson tree** \u2014 an array of blocks, each { type, id, props }. Types:
-   heading {text, level 1-6}, text {text}, image {src, alt}, button {text, href}, spacer
-   {height}, video {url}, and **columns** {columns: array of arrays of blocks, gap} which
-   NESTS child blocks. Give every block a stable unique id.
-3. **Props (optional)** \u2014 declare overridable fields: { key, label, target: { blockId, path },
-   type: text|richtext|image|url|boolean, defaultValue? } so instances can be customized.
-4. **Confirm the structure** (AskUserQuestion: show the block tree), then \`create_component\`
-   { name, slug, category?, blockJson, props? } (returns the id), or \`update_component\`
-   { componentId, ... } \u2014 note updating re-bakes every page that embeds it.`;
+2. **Design the tree** \u2014 wrap the section in a \`section\` block carrying \`style\`
+   (bg + paddingTop/paddingBottom + contentWidth) and nest content in props.children. See
+   "Anatomy of a real section component" in the playbook. Give every block a stable id.
+3. **sectionType + category** \u2014 set both, or the component never appears in the editor's
+   "Add a section" picker. Components sharing a sectionType are swappable VARIANTS, so reuse
+   the same prop keys across a family or a swap drops content.
+4. **Props** \u2014 declare only what should really be editable:
+   { key, label, target: { blockId, path }, type: text|richtext|image|url|boolean|slot }.
+5. **Confirm the structure** (AskUserQuestion: show the block tree), then \`create_component\`.
+6. **\`publish_component\`.** It lands as a DRAFT, and a draft component renders as NOTHING on
+   the live site \u2014 no error, no placeholder. This step is not optional.
+`;
+var LAYOUT_FLOW = `### Project/page Layout authoring \u2192 \`get_layout\` / \`update_layout\`
+Edit the project's draft Global Layout or one page's draft override. Layout publishing stays
+in the dashboard; these tools never change the live site.
+1. **Read first** \u2014 call \`get_layout\` with scope \`global\`, or scope \`page\` + pageId.
+   Keep the returned \`revision\`; every write must pass it as \`ifMatch\`.
+2. **Choose one discriminated command type** \u2014 the server derives its authority family;
+   callers cannot claim a weaker family for a schema or composition mutation.
+3. **Apply one canonical command** with \`update_layout\`, then use the returned revision for
+   the next command. A 409 means somebody else edited it: re-read; never blindly retry.
+4. Direct fields are headless data. Only Component items render markup. Navigation/Footer
+   are reserved Sections and cannot be deleted or moved; page overrides may inherit,
+   override content, customize structure, or disable them.
+5. Read Component/Variant identities before attaching or swapping. Required values and
+   bindings must be complete before a human publishes from the dashboard.`;
 var BUILD_SITE_FLOW = `### Build a whole site (schema \u2192 pages \u2192 AI copy) \u2192 composes the flows below
 End-to-end authoring from a repo or a brief. Confirm-first at every stage.
 1. **Schema** \u2014 run the whole-project schema design above: propose the page/zone/field tree,
@@ -1754,6 +3977,8 @@ ${FORM_FLOW}
 
 ${COMPONENT_FLOW}
 
+${LAYOUT_FLOW}
+
 ${BUILD_SITE_FLOW}
 
 ${LANDING_PAGES_FLOW}
@@ -1767,6 +3992,29 @@ here \u2014 route to it the same way.`
       ]
     })
   );
+  server.registerPrompt(
+    "edit_layout",
+    {
+      title: "Edit project or page Layout (guided)",
+      description: "Safely edit a draft Global Layout or page override with optimistic locking. Publishing remains in the dashboard.",
+      argsSchema: {
+        request: z2.string().optional().describe("what to change, e.g. 'disable the footer on the pricing page'")
+      }
+    },
+    ({ request }) => ({
+      messages: [{
+        role: "user",
+        content: {
+          type: "text",
+          text: `Edit the BetterCMS Layout draft.${request ? ` The user wants: "${request}".` : ""}
+
+${LAYOUT_FLOW}
+
+Report which scope changed and the new revision. Remind the user that publishing is a separate dashboard action.`
+        }
+      }]
+    })
+  );
   server.registerPrompt(
     "propose_schema",
     {