@bettercms-ai/mcp 0.71.0 → 0.72.0

package/dist/index.js

@@ -15,7 +15,7 @@ import { AsyncLocalStorage } from "async_hooks";
 import { z } from "zod";
 
 // ../types/src/component.ts
-var SECTION_DOCTRINE = "STRUCTURE (separate from schema): a page is composed of SECTIONS. NEVER build a page out of loose top-level heading/text/image/button/spacer blocks \u2014 they cannot be moved, duplicated or swapped as a unit, the visual editor cannot outline or name them, and every one of them becomes its own section in the editor. A hero of a headline, a lede and two CTAs is ONE section, not four. TWO SHAPES, and the choice is about REUSE. (1) A band that appears on more than one page, or that needs layout variants, is a COMPONENT with a `sectionType` \u2014 see create_component. Components sharing a `sectionType` are that section's VARIANTS (one Hero: 'Centered' for the home page and 'Two-column' for about, same prop keys so a swap keeps the content). This is also the only shape the editor's 'Add a section' picker can insert, and the only one that gets a family name and a variant switcher. (2) A genuinely one-off band on a single page is a `section` BLOCK whose `props.children` hold its blocks. THE TRADEOFF, stated in the present tense because it is real today: inside a component, ONLY the leaves a declared prop TARGETS are click-to-edit on the canvas \u2014 each declared prop's `target` is re-keyed to that PLACEMENT's own override address, so editing it changes this page and not the shared definition. A prop with no `target` still SHOWS as a dock control, but its override reaches no rendered slot, so editing it changes nothing on the page. Copy that no prop points at is worse still: no binding and no control, unreachable from click-to-edit AND from the dock, changeable only by editing the component definition, which rewrites every page that places it. A `section` block's children stay click-to-edit unconditionally. So when you choose a component, DECLARE A PROP \u2014 WITH A `target` \u2014 for every string, link and image a marketer will ever touch; a component with un-propped editable copy is the defect, not the component. In the dock an unset prop shows EMPTY and inherits the definition's default, so set props explicitly when you want the current copy visible there. An IMPORTED site's components are its own (read the repo); its nav, footer and modals are the Layout. On a blank site, do not hand-write a band's JSON: start from a built-in section blueprint (list_components returns locked `builtin:*` blueprints with no projectId \u2014 hero-centered, hero-split, feature-grid-three, cta-banner and nine more), each already rooted in a `section` block with its editable leaves declared as props. INLINE its blockJson as a `section` block for a one-off band; for a recurring band, materialize the blueprint with create_component so it becomes project-scoped before implementation validation, Output or publication. Direct `builtin:*` component references exist only for legacy delivery compatibility. Two consecutive call-to-action buttons are two sibling `button` blocks inside the same section \u2014 never a `columns` block, which is a `repeat(N,1fr)` grid and would stretch each CTA to half the container. Buttons are inline-level and flow side by side on their own.";
+var SECTION_DOCTRINE = "STRUCTURE (separate from schema): a page is composed of SECTIONS. NEVER build a page out of loose top-level heading/text/image/button/spacer blocks \u2014 they cannot be moved, duplicated or swapped as a unit, the visual editor cannot outline or name them, and every one of them becomes its own section in the editor. A hero of a headline, a lede and two CTAs is ONE section, not four. TWO SHAPES, and the choice is about REUSE. (1) A band that appears on more than one page, or that needs layout variants, is a COMPONENT with a `sectionType` \u2014 see create_component. Components sharing a `sectionType` are that section's VARIANTS (one Hero: 'Centered' for the home page and 'Two-column' for about, same prop keys so a swap keeps the content). This is also the only shape the editor's 'Add a section' picker can insert, and the only one that gets a family name and a variant switcher. (2) A genuinely one-off band on a single page is a `section` BLOCK whose `props.children` hold its blocks. THE TRADEOFF, stated in the present tense because it is real today: inside a component, ONLY the leaves a declared prop TARGETS are click-to-edit on the canvas \u2014 each declared prop's `target` is re-keyed to that PLACEMENT's own override address, so editing it changes this page and not the shared definition. A prop with no `target` still SHOWS as a dock control, but its override reaches no rendered slot, so editing it changes nothing on the page. Copy that no prop points at is worse still: no binding and no control, unreachable from click-to-edit AND from the dock, changeable only by editing the component definition, which rewrites every page that places it. A `section` block's children stay click-to-edit unconditionally. So when you choose a component, DECLARE A PROP \u2014 WITH A `target` \u2014 for every string, link and image a marketer will ever touch; a component with un-propped editable copy is the defect, not the component. In the dock an unset prop shows EMPTY and inherits the definition's default, so set props explicitly when you want the current copy visible there. An IMPORTED site's components are its own (read the repo); its nav, footer and modals are the Layout. On a blank site, do not hand-write a band's JSON: start from a built-in section blueprint (list_components returns locked `builtin:*` blueprints with no projectId \u2014 hero-centered, hero-split, feature-grid-three, cta-banner and more), each already rooted in a `section` block with its editable leaves declared as props. INLINE its blockJson as a `section` block for a one-off band; for a recurring band, materialize it with create_component `from` so it becomes project-scoped before implementation validation, Output or publication. Direct `builtin:*` component references exist only for legacy delivery compatibility. Two consecutive call-to-action buttons are two sibling `button` blocks inside the same section \u2014 never a `columns` block, which is a `repeat(N,1fr)` grid and would stretch each CTA to half the container. Buttons are inline-level and flow side by side on their own.";
 var COMPONENT_PROP_TYPES = [
   "text",
   "richtext",
@@ -56,7 +56,12 @@ var COMPONENT_PROP_TYPES = [
   // CMS items, as the same-named content-model FIELDS store them: an entry id (or a polymorphic
   // `{ entryId, modelSlug }`), and a list of them. Delivery hydrates them like an entry's.
   "reference",
-  "multi-reference"
+  "multi-reference",
+  // V2 chrome types, each storing what the same-named content-model FIELD stores: a video value,
+  // a primitive list (`config.itemType`), and multi-line text (the field lane's V2 `text`).
+  "video",
+  "array",
+  "longtext"
 ];
 
 // ../types/src/layout-lucide-icons.ts
@@ -2023,6 +2028,7 @@ var LAYOUT_SECTION_ICON_SET = new Set(LAYOUT_SECTION_ICONS);
 
 // ../types/src/dock-icon-names.ts
 var DOCK_ICON_NAMES = [
+  "abc",
   "access-denied",
   "activity",
   "add",
@@ -2030,14 +2036,40 @@ var DOCK_ICON_NAMES = [
   "add-comment",
   "add-document",
   "add-user",
+  "address-book",
+  "adjustments",
+  "adjustments-horizontal",
+  "alarm",
+  "alert-triangle",
+  "align-left",
   "api",
+  "app-window",
+  "apple",
+  "apps",
   "archive",
+  "arrow-back-up",
   "arrow-down",
+  "arrow-guide",
   "arrow-left",
   "arrow-right",
   "arrow-top-right",
   "arrow-up",
+  "arrows-diagonal",
+  "arrows-down",
+  "arrows-exchange",
+  "arrows-horizontal",
+  "arrows-left-right",
+  "arrows-shuffle",
+  "arrows-sort",
+  "article",
+  "aspect-ratio",
   "asterisk",
+  "award",
+  "axis-x",
+  "backpack",
+  "badge",
+  "badge-cc",
+  "badges",
   "bar-chart",
   "basket",
   "bell",
@@ -2049,25 +2081,76 @@ var DOCK_ICON_NAMES = [
   "bold",
   "bolt",
   "book",
+  "book-2",
   "bookmark",
   "bookmark-filled",
+  "books",
   "bottle",
+  "box",
+  "brand-dribbble",
+  "brand-facebook",
+  "brand-instagram",
+  "brand-linkedin",
+  "brand-pinterest",
+  "brand-tiktok",
+  "brand-x",
+  "brand-youtube",
+  "briefcase",
+  "broadcast",
+  "browser",
   "bug",
+  "building",
+  "building-skyscraper",
+  "building-store",
   "bulb-filled",
   "bulb-outline",
+  "calculator",
   "calendar",
+  "calendar-dollar",
+  "calendar-event",
+  "calendar-exclamation",
+  "calendar-off",
+  "calendar-plus",
+  "calendar-star",
+  "calendar-time",
+  "camera",
+  "campfire",
+  "carousel-horizontal",
   "case",
+  "cash",
+  "category",
+  "category-2",
+  "chart-area",
+  "chart-arrows",
+  "chart-bar",
+  "chart-bar-popular",
+  "chart-donut",
+  "chart-dots",
+  "chart-line",
   "chart-upward",
+  "check",
+  "checkbox",
+  "checklist",
   "checkmark",
   "checkmark-circle",
+  "chef-hat",
   "chevron-down",
   "chevron-left",
   "chevron-right",
   "chevron-up",
+  "chevrons-right",
   "circle",
+  "circle-check",
+  "circle-dot",
+  "circle-number-1",
+  "circle-plus",
+  "click",
   "clipboard",
   "clipboard-image",
+  "clipboard-text",
   "clock",
+  "clock-check",
+  "clock-hour-4",
   "close",
   "close-circle",
   "code",
@@ -2075,20 +2158,31 @@ var DOCK_ICON_NAMES = [
   "cog",
   "collapse",
   "color-wheel",
+  "columns",
+  "columns-2",
+  "columns-3",
   "comment",
   "component",
   "compose",
   "compose-sparkles",
   "confetti",
   "controls",
+  "cookie",
   "copy",
   "credit-card",
   "crop",
   "cube",
+  "currency-dollar",
   "dashboard",
   "database",
+  "database-search",
   "desktop",
+  "device-desktop",
+  "device-mobile",
+  "device-tablet",
+  "devices",
   "diamond",
+  "discount",
   "document",
   "document-pdf",
   "document-remove",
@@ -2098,6 +2192,7 @@ var DOCK_ICON_NAMES = [
   "document-word",
   "document-zip",
   "documents",
+  "door-exit",
   "dot",
   "double-chevron-down",
   "double-chevron-left",
@@ -2107,9 +2202,12 @@ var DOCK_ICON_NAMES = [
   "download",
   "drag-handle",
   "drop",
+  "droplet",
+  "droplet-half",
   "earth-americas",
   "earth-globe",
   "edit",
+  "egg",
   "ellipsis-horizontal",
   "ellipsis-vertical",
   "empty",
@@ -2122,77 +2220,169 @@ var DOCK_ICON_NAMES = [
   "error-screen",
   "expand",
   "eye-closed",
+  "eye-off",
   "eye-open",
   "face-happy",
   "face-indifferent",
   "face-sad",
+  "feather",
   "feedback",
+  "file",
+  "file-certificate",
+  "file-code",
+  "file-download",
+  "file-text",
   "filter",
+  "flag",
+  "flame",
+  "flask",
+  "focus-2",
   "folder",
+  "folders",
+  "forms",
+  "frame",
   "generate",
+  "gift",
+  "git-branch",
   "github",
+  "grid-dots",
   "groq",
+  "hammer",
+  "hand-finger",
+  "hanger",
   "hash",
+  "headphones",
+  "headset",
   "heart",
   "heart-filled",
+  "heart-handshake",
   "help-circle",
   "highlight",
+  "history",
   "home",
+  "hourglass",
   "ice-cream",
+  "id-badge",
+  "id-badge-2",
   "image",
   "image-remove",
   "images",
   "inbox",
+  "infinity",
+  "info-circle",
   "info-filled",
   "info-outline",
+  "info-square-rounded",
   "inline",
   "inline-element",
+  "input-search",
   "insert-above",
   "insert-below",
   "italic",
   "joystick",
   "json",
+  "language",
   "launch",
+  "layout",
+  "layout-align-center",
+  "layout-board",
+  "layout-board-split",
+  "layout-bottombar",
+  "layout-bottombar-expand",
+  "layout-cards",
+  "layout-columns",
+  "layout-dashboard",
+  "layout-grid",
+  "layout-list",
+  "layout-navbar",
+  "layout-rows",
+  "layout-sidebar",
+  "layout-sidebar-right",
+  "leaf",
   "leave",
   "lemon",
+  "library-photo",
+  "lifebuoy",
   "link",
   "link-removed",
   "linkedin",
   "list",
+  "list-check",
+  "list-details",
+  "list-numbers",
+  "list-tree",
   "lock",
   "logo-js",
   "logo-ts",
+  "mail",
+  "map-2",
+  "map-pin",
+  "map-pins",
   "marker",
   "marker-removed",
   "master-detail",
+  "math-function",
+  "meat",
   "menu",
+  "message",
+  "message-2",
+  "message-check",
+  "message-circle",
+  "message-circle-2",
+  "message-plus",
+  "message-star",
   "microphone",
   "microphone-slash",
   "mobile-device",
+  "mood-empty",
   "moon",
+  "movie",
+  "news",
+  "notes",
   "number",
   "ok-hand",
   "olist",
   "overage",
   "package",
+  "packages",
+  "palette",
   "panel-left",
   "panel-right",
+  "paperclip",
   "pause",
+  "pencil",
+  "phone",
+  "photo",
+  "photo-scan",
+  "photo-search",
+  "pig-money",
   "pin",
   "pin-filled",
   "pin-removed",
   "play",
+  "player-play",
+  "player-track-next",
+  "playlist-add",
   "plug",
+  "plug-connected",
+  "plus-minus",
+  "point",
   "presentation",
+  "printer",
   "progress-50",
   "progress-75",
   "projects",
   "publish",
+  "qrcode",
+  "quote",
   "read-only",
+  "receipt",
+  "recycle",
   "redo",
   "refresh",
   "remove",
   "remove-circle",
+  "repeat",
   "reset",
   "restore",
   "retrieve",
@@ -2200,49 +2390,90 @@ var DOCK_ICON_NAMES = [
   "revert",
   "robot",
   "rocket",
+  "rosette",
+  "route",
+  "ruler",
+  "ruler-measure",
+  "salad",
+  "scale",
   "schema",
+  "school",
   "search",
+  "section",
   "select",
+  "send",
+  "server",
+  "settings",
   "share",
+  "shield-check",
+  "shield-lock",
+  "shopping-bag",
+  "shopping-cart",
+  "shopping-cart-plus",
+  "signature",
+  "sitemap",
+  "slideshow",
   "sort",
+  "sort-descending",
+  "spacing-vertical",
   "sparkle",
   "sparkles",
+  "speakerphone",
   "spinner",
   "split-horizontal",
   "split-vertical",
   "square",
   "stack",
+  "stack-2",
   "stack-compact",
+  "stairs",
+  "stairs-up",
   "star",
   "star-filled",
+  "stars",
   "stop",
   "strikethrough",
   "string",
+  "subtask",
   "sun",
+  "superscript",
   "sync",
+  "table",
+  "table-options",
   "tablet-device",
   "tag",
   "tags",
   "target",
   "task",
+  "template",
+  "tent",
   "terminal",
+  "terminal-2",
   "text",
   "th-large",
   "th-list",
+  "thumb-up",
   "thumbs-down",
   "thumbs-up",
+  "ticket",
   "tiers",
   "timeline",
   "toggle-arrow-right",
+  "toggle-right",
   "token",
+  "tool",
+  "tools-kitchen-2",
   "transfer",
   "translate",
   "trash",
   "trend-upward",
   "triangle-outline",
   "trolley",
+  "truck",
+  "truck-delivery",
   "truncate",
   "twitter",
+  "typography",
   "ulist",
   "unarchive",
   "underline",
@@ -2253,12 +2484,22 @@ var DOCK_ICON_NAMES = [
   "unpublish",
   "upload",
   "user",
+  "user-circle",
+  "user-plus",
+  "user-search",
+  "user-star",
   "users",
+  "users-group",
   "versions",
   "video",
+  "vocabulary",
+  "vs",
   "warning-filled",
   "warning-outline",
-  "wrench"
+  "weight",
+  "world",
+  "wrench",
+  "zoom-question"
 ];
 var DOCK_ICON_NAME_SET = new Set(DOCK_ICON_NAMES);
 
@@ -2284,6 +2525,8 @@ never carries an icon.
 Two vocabularies, on purpose: Layout section icons (update_layout \`add-section\`) stay Lucide names.
 A name from one list is not valid in the other.
 
+The list includes the V2 kit's line-icon names (\`building\`, \`settings\`, \`layout-grid\`, \u2026) as themselves.
+
 ${DOCK_ICON_NAMES.length} names:
 
 ${DOCK_ICON_NAMES.join(", ")}
@@ -2297,8 +2540,8 @@ var STRUCTURE_PLAYBOOK_URI = "bettercms://playbook/structure";
 var STRUCTURE_DEFAULT_INSTRUCTION = `After you create collections or pages, organise them per the structure playbook: read ${STRUCTURE_PLAYBOOK_URI}, call suggest_content_structure (read-only), show the user its outline, then apply it with set_content_structure and the version it returned (the If-Match). A project that already has a structure keeps it: file only what you created, with move_to_folder, unless the user asks for a full re-organisation.`;
 var SKILLS_ROUTING_INSTRUCTION = "Before writing code in a repo that uses BetterCMS, explore the repo, then read the installed `bettercms` skill (`npx @bettercms-ai/install --project -y` adds it if missing): its table turns what you found into the one reference the task needs \u2014 read only that. Without the skill installed, read the same files as resources: bettercms://skill/bettercms, then bettercms://skill/<reference>.";
 var DOCK_UI_ROUTING_INSTRUCTION = "How fields and props look in the editor (groups, tabs, rows, icons, item names) is playbook \xA714 or the `field-ui` prompt: write it with update_content_model field* or update_component prop* plus ifMatch, read it back, and finish when get_next_steps reports no dock-* step.";
-var RECEIPT_FIRST_INSTRUCTION = "Start every project with get_next_steps: its `receipt` lists what is already done (`done`), what is still missing (`missing`, each item citing the count it reacted to) and the one `nextAction`. Work from that receipt instead of re-reading the site, call get_next_steps again after each batch of edits, and before you tell the user you are finished. On an imported site you are finished only when `receipt.complete` is true: work `receipt.gate.blocking` in order, and record a gap you cannot close with editor_setup `exempt` (an allowed reason and a note), never in prose.";
-var NEXT_STEPS_DESCRIPTION = `Call this FIRST on a project. Returns \`receipt\` \u2014 \`done\` (live release, bound elements, conversion coverage, composed pages, published components and Layout), \`missing\`, \`nextAction\` and \`notes\` (unjudged: unknown, not done) \u2014 plus \`data\`, the unfinished items: missing meta descriptions, drafts, empty collections, unnotified forms, writes awaiting approval, unstamped bindings or sections, \`authoring-undecided\` and the Layout lane (\`layout-write-blocked\`, \`layout-field-unread\`, \`layout-locator-stale\`, \`layout-rebuild-required\`, \`chrome-duplicated\`). Each item cites its count and may carry \`payload\` {rows, total}, at most 20 rows. \`receipt.complete\` is the setup gate's verdict and \`receipt.gate\` its numbers: per built route the page, text, image and link coverage, \`blocking\` first, each with its \`fix\`. Call it again after each batch; you are finished only when \`complete\` is true. \`organise-content\`: pages and collections are in no folder \u2014 read ${STRUCTURE_PLAYBOOK_URI}, call suggest_content_structure and, once the user agrees, set_content_structure.`;
+var RECEIPT_FIRST_INSTRUCTION = "Start every project with get_next_steps: its `receipt` lists what is already done (`done`), what is still missing (`missing`, each item citing the count it reacted to) and the one `nextAction`. Work from that receipt instead of re-reading the site, call get_next_steps again after each batch of edits, and before you tell the user you are finished. On an imported site the gate is the definition of done: run `receipt.gate.nextAction`, read again, and repeat until `receipt.complete` is true. Record a gap you cannot close with editor_setup `exempt` only for an allowed reason that is true, with a note, never in prose.";
+var NEXT_STEPS_DESCRIPTION = `Call this FIRST on a project. Returns \`receipt\` \u2014 \`done\` (live release, bound elements, conversion coverage, composed pages, published components and Layout), \`missing\`, \`nextAction\` and \`notes\` (unjudged: unknown, not done) \u2014 plus \`data\`, the unfinished items by \`ruleId\` (skill finish-site lists them). Each item cites its count and may carry \`payload\` {rows, total}, at most 20 rows. \`receipt.complete\` is the setup gate's verdict and \`receipt.gate\` its numbers per built route. Run \`receipt.gate.nextAction\`, call it again after each batch; you are finished only when \`complete\` is true. \`organise-content\`: pages and collections are in no folder \u2014 read ${STRUCTURE_PLAYBOOK_URI}, call suggest_content_structure and, once the user agrees, set_content_structure.`;
 var LAYOUT_CHROME_INSTRUCTION = 'When the user asks to make the navigation, footer or other site chrome editable, or get_next_steps lists a `layout-*` or `chrome-duplicated` item: this is playbook \xA711 item 3. Chrome is the project Layout, never page fields: in the source, wrap each Section in `data-bcms-layout-section` (the slot, its base slug) and mark each value `data-bcms-layout-field="layout:<sections[slug].id>:<fieldId>"`, never `data-bcms-field` inside it, then push; the strip removes the page copies, never delete them by hand. On a site BetterCMS serves, publish_layout writes Layout VALUES into the live pages; a structure change waits for a Rebuild. Never place nav, footer or modal blocks or fields on a page: the Layout (or the site\'s own layout) draws chrome, so a page copy either duplicates it or renders nowhere (get_componentize_plan reports one as LAYOUT_CHROME).';
 var CTA_BUTTON_INSTRUCTION = "A call to action is ONE `button` field (value {label, href, variant?, size?, arrow?, icon?, newTab?}), rendered with BcmsButton from @bettercms-ai/astro or @bettercms-ai/next: never a text field beside a link field. A page that already holds such a pair (primaryCtaText + primaryCtaHref) becomes one button with update_field `mergeHref`. Inside a component a CTA is a `button` block whose text and href two props target.";
 var STRUCTURE_EXAMPLE_PAYLOAD = {
@@ -2539,7 +2782,7 @@ function allKeys(fields) {
     })
   ]);
 }
-var CLEARABLE = ["helpText", "showIf", "ui", "placement", "readOnly", "lockReason", "helpMore", "advanced", "recommendedMax", "openMode"];
+var CLEARABLE = ["helpText", "showIf", "ui", "placement", "readOnly", "lockReason", "helpMore", "advanced", "recommendedMax", "openMode", "localized"];
 var SETTABLE = ["label", "required", ...CLEARABLE];
 function mergeConfig(current, patch) {
   const out = { ...current ?? {} };
@@ -2577,7 +2820,7 @@ function planFieldEdit(model, edit, callerIfMatch) {
   }
   const changes = SETTABLE.filter((k) => edit[k] !== void 0);
   if (!retype && rename === void 0 && edit.config === void 0 && changes.length === 0) {
-    return { ok: false, error: "Nothing to change: pass label, helpText, required, config, showIf, ui, placement, readOnly, lockReason, helpMore, advanced, recommendedMax, openMode, type or key." };
+    return { ok: false, error: "Nothing to change: pass label, helpText, required, config, showIf, ui, placement, readOnly, lockReason, helpMore, advanced, recommendedMax, openMode, localized, type or key." };
   }
   const echo = helpTextEcho(edit.helpText, { label: edit.label ?? current.label, defaultValue: current.defaultValue });
   if (echo) return { ok: false, error: echo };
@@ -2748,11 +2991,12 @@ var PARAM_TEXT = {
   editorSetupForce: "re-run a setup already ready for the live build",
   editorSetupCheck: "true = only report the state; starts nothing",
   editorSetupExempt: "instead of running: record setup-gate exceptions [{ route, check, reason, note }]; reason null removes one. Reasons: get_next_steps `receipt.gate`",
+  pageBlockJson: "an ARRAY REPLACES the page's block composition (a `component` block per section). An OBJECT edits ONE section of the stored page instead: `insertSection` adds a component (its id, or a builtin:* id: copied into the project once) at index `at`, or `before` / `after` a section's block id (none = last), with its `style` and `overrides`; `sectionStyle` sets a section's block style (a key replaces the stored one, null unsets it). `section` in the answer names the block (skill publishing)",
   pageDynamic: "a dynamic (collection template) page only",
   previewPath: "its route pattern, e.g. /blog/{slug}; null clears",
   pageModelId: "an existing collection this page lists (when it has no model yet)",
   formIgnored: "true = not one of the site's forms (a search box, a widget); false restores it",
-  componentizeCodemod: "true = componentize nothing; run the section-order codemod (`--componentize`) in the connected repo on its own Actions, which commits `<Sections>` templates for the next build. After the components and pages are published. `skipped` = no repo to commit to: run the codemod yourself",
+  componentizeCodemod: "true = componentize nothing; run the section-order codemod in the connected repo on its own Actions, which commits for the next build. After the components and pages are published. `skipped` = no repo to commit to: run `convert --sections` in a checkout (skill componentize)",
   where: "field filters: {field: value} is equality, {field: {op: value}} with op eq|ne|gt|gte|lt|lte|contains|in, and an array means `in`. System fields slug, status, publishedAt, locale work anywhere; a data field needs modelId. Compares the served copy (live for published, working for draft)",
   sort: "comma list, a leading - sorts descending, e.g. '-publishedAt,title'",
   page: "1-based page of `limit` rows; the response's meta says totalPages",
@@ -2784,7 +3028,7 @@ var SEO_KEY_TEXT = {
 var VARIANT_GROUP_NOTE = "When the component belongs to a family of looks, `variantGroup` names the family and lists its looks.";
 var UNPROPPED_COPY_NOTE = "A `warnings` entry UNPROPPED_COPY names copy no prop targets, which nobody can edit: add a prop with a `target` for each leaf it lists.";
 var UPDATE_PAGE_IF_MATCH_NOTE = "get_page's `optimisticVersion`: the write applies only at that version, and a 409 means the page changed since, so read it again. Send it whenever you pass blockJson, which REPLACES the whole composition.";
-var SLOT_MULTIPLE_NOTE = "'slot' with config.multiple holds a list [{componentId, overrides?}] (config.maxItems, default 12, at most 50): target.path 'props.children' on a section.";
+var SLOT_MULTIPLE_NOTE = "'slot' with config.multiple holds a list [{componentId, overrides?}] (config.maxItems, default 12, at most 50): target.path 'props.children' on a section. V2 slots, 'table' mode 'types': playbook \xA75.";
 var PROP_V2_NOTE = "Props take the fields' V2 keys (\xA714): 'object' = ONE {child: value} from config.fields, \u226410 levels (field_depth_exceeded); datetime|slug|email|phone|json|location|tags|rating|code|reference|multi-reference as that field (a reference names contentModelId, or polymorphic + allowedModelSlugs; page reads hydrate its entries); helpMore, advanced, recommendedMax, openMode, config.scale, ui.layout rows|chips|gallery, ui.preview.fallback, showIf notEmpty|empty.";
 var LAYOUT_LOCK_NOTE = "A Global field with `overridable:false` + `lockReason` (add-field `field`, update-field `patch`) refuses page overrides (LAYOUT_FIELD_NOT_OVERRIDABLE); get_layout scope page lists stored ones as `shadowed`.";
 
@@ -2956,20 +3200,25 @@ var fieldType = z.enum([
   // V2 leaves: a taxonomy string[], a rating number, a code value. The pass-through branch carries their config.
   "tags",
   "rating",
-  "code"
+  "code",
+  "video",
+  "table",
+  "slot"
 ]);
 var OPEN_MODE_INVALID = "openMode_invalid: openMode must be one of 'inline', 'drill', 'popover', 'dialog'";
 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, underscores, and hyphens only");
+var dockIconArg = z.string().min(1).max(40).refine((v) => DOCK_ICON_SET.has(v), `not a dock icon, see ${DOCK_ICONS_URI}`);
 var uiObject = z.strictObject({
   collapsed: z.boolean().optional().describe("start this panel collapsed. Use it for long optional sections."),
   preview: z.strictObject({
     title: z.string().min(1).optional().describe("CHILD KEY whose value titles a collapsed row"),
     subtitle: z.string().min(1).optional().describe("CHILD KEY whose value is the row's second line (e.g. 'level' \u2192 'Heading \xB7 h2')"),
     media: z.string().min(1).optional().describe("CHILD KEY whose value is the row's thumbnail (image/file/url all work)"),
-    fallback: z.string().min(1).max(60).optional().describe("a literal row label while the title child is empty ('Untitled question'), not a key")
+    fallback: z.string().min(1).max(60).optional().describe("a literal row label while the title child is empty ('Untitled question'), not a key"),
+    icon: dockIconArg.optional().describe("the row's icon while it has no media, a dock icon name")
   }).optional().describe(
-    "how ONE ITEM summarises itself when collapsed. Every slot names a CHILD KEY of THIS field/prop \u2014 not a value, not a dotted path. Without it a repeater of testimonials reads 'Item 1, Item 2, Item 3'; with {title:'author', media:'avatar'} it reads the names with their faces."
+    "how ONE ITEM summarises itself when collapsed. Every slot names a CHILD KEY of THIS field/prop (a dotted path reads into it: 'author.name'). Without it a repeater of testimonials reads 'Item 1, Item 2, Item 3'; with {title:'author', media:'avatar'} it reads the names with their faces."
   ),
   layout: z.enum(["list", "grid", "table", "rows", "chips", "gallery"]).optional().describe(
     "how the ITEMS are arranged. Omit (\u2261 'list') for rows of text; 'grid' for items whose thumbnail is the thing you scan \u2014 a gallery, a logo wall, a team; 'table' for up to 3 scalar columns. Same placement rule as `preview`. V2 'rows' | 'chips' | 'gallery' are also valid on a primitive array."
@@ -2977,13 +3226,21 @@ var uiObject = z.strictObject({
   reorderable: z.boolean().optional().describe(
     "omit (\u2261 true) unless the order is PART OF THE MEANING. `false` LOCKS the list \u2014 a 'three steps' band that must stay three steps in that order, a nav whose order is semantic, a timeline. Valid only where there is a list to lock."
   ),
-  control: z.enum(["segmented", "slider", "rating"]).optional().describe(
-    "editor control for a LEAF. Omit for the default. 'segmented' on a select with a few short options (alignment, theme, size); 'slider' on a number that has config.min < config.max (opacity, columns); 'rating' on a number with config.min, max and step. Anything else is refused with the rule named."
+  control: z.enum(["segmented", "slider", "rating", "dropdown", "radio", "cards", "grid", "switch", "checkbox"]).optional().describe(
+    "editor control for a LEAF. Omit for the default. 'segmented' on a select with a few short options (alignment, theme, size); 'slider' on a number that has config.min < config.max (opacity, columns); 'rating' on a number with config.min, max and step; 'dropdown'/'radio'/'grid'/'cards' on a select ('cards' also a multiselect); 'switch'/'checkbox' on a boolean ('checkbox' also a multiselect). Anything else is refused with the rule named."
   ),
-  // A refine, not an enum: 236 names inlined into every schema that carries `ui` would be paid on
-  // every tools/list. The layoutIcon precedent; the server's z.enum is the guard.
-  icon: z.string().min(1).max(40).refine((v) => DOCK_ICON_SET.has(v), `not a dock icon, see ${DOCK_ICONS_URI}`).optional().describe(`the branch row's icon, a name from ${DOCK_ICONS_URI}. Nesting fields only.`),
-  itemLabel: z.string().min(1).max(24).optional().describe("what ONE item is called ('Slide'): the add button, crumbs and empty state. Nesting fields only. V2 itemNoun goes here."),
+  icon: dockIconArg.optional().describe(`the branch row's icon, a name from ${DOCK_ICONS_URI}. Nesting fields only.`),
+  itemLabel: z.string().min(1).max(24).optional().describe("what ONE item is called ('Slide'): the add button, crumbs and empty state. Nesting fields and lists. V2 itemNoun goes here."),
+  // V2 chrome keys (the server's fieldUiSchema): editor-only, each refused with a named code where it means nothing.
+  itemName: z.string().max(64).optional().describe("a list's item type name (an identifier). Lists only."),
+  itemTitle: z.string().min(1).max(60).optional().describe("a list's item type title. Lists only."),
+  rows: z.number().int().min(1).max(40).optional().describe("the lines a text box opens with. text / longtext only."),
+  placeholder: z.string().min(1).max(120).optional().describe("ghost text, a field of any type. A prop uses its own `placeholder`."),
+  synced: z.strictObject({ from: z.string().min(1).max(64) }).optional().describe("the value comes from this global; edits apply everywhere."),
+  valueShape: z.enum(["string", "object"]).optional().describe("a link / image / button writes a plain string or the object."),
+  access: z.strictObject({ view: z.literal("schema.view").optional(), edit: z.literal("schema.manage").optional() }).optional().describe("who sees (view: developer-only) and who changes (edit) it, gated in the editor. The enforced lock is readOnly:'developer'."),
+  hidden: z.boolean().optional().describe("true: never shown in the form (a system value). A conditional hide is showIf."),
+  blocks: z.record(z.string(), z.strictObject({ icon: dockIconArg.optional(), preview: z.record(z.string(), z.string()).optional() })).optional().describe("modular only: per block slug, {icon?, preview?} for its rows."),
   input: z.object({
     name: z.string().regex(/^[a-z][a-z0-9-]{0,47}$/),
     writes: z.array(z.string().min(1).max(64)).max(16).optional()
@@ -2997,8 +3254,13 @@ var propUiObject = uiObject.extend({
     label: z.string().min(1).max(32).optional(),
     kind: z.enum(["group", "row"]).optional(),
     icon: uiObject.shape.icon,
-    collapsed: z.boolean().optional()
-  }).optional().describe("the group this prop sits in. The FIRST prop of a group defines {id, label, kind?, icon?, collapsed?}; later props send only {id}.")
+    collapsed: z.boolean().optional(),
+    description: z.string().min(1).max(200).optional(),
+    columns: z.union([z.literal(1), z.literal(2)]).optional(),
+    collapsible: z.boolean().optional(),
+    layout: z.enum(["stack", "breakpoints"]).optional(),
+    order: z.number().int().min(0).max(99).optional()
+  }).optional().describe("the group this prop (or sub-field) sits in. The FIRST member defines {id, label, kind?, icon?, collapsed?, description?, columns?, collapsible?, layout?, order?}; later ones send only {id}.")
 });
 var choiceOption = z.union([z.string(), z.object({ label: z.string(), value: z.string(), icon: z.string().optional(), description: z.string().optional() })]);
 var fieldShape = {
@@ -3017,7 +3279,7 @@ var fieldShape = {
     "choices when type is 'select'. A plain string, or {label, value, icon?, description?} when the stored value differs from what the editor shows (e.g. {label:'Sold out', value:'soldOut'}); icon a dock name, description one line \u2264140."
   ),
   config: z.record(z.string(), z.unknown()).optional().describe(
-    "per-type config: reference {contentModelId}, multi-reference {contentModelId,min,max}, array {itemType: 'text'|'number'|'date'}, date {includeTime, timezone}, modular {blockSlugs: ['quote','gallery'], minItems?, maxItems?} \u2014 blockSlugs is REQUIRED, non-empty, and each slug must name an existing kind:'block' model; richtext {inline:true, hostTag:'h2', accept:['h2','p','b','i','u','link'], features:['bold','italic','underline','link','headings'], allowMultipleParagraphs:false} \u2014 for a field bound to ONE element on the page: `hostTag` is that element's tag and `accept` must name it, so the editor's block-style control opens already showing 'Heading 2' instead of 'Paragraph'. Name exactly ONE heading level: publish refuses an <h3> value bound to an <h2> rather than nesting one heading inside the other. Keep 'p' in `accept` or the sanitiser strips a block demoted to Paragraph; limits: text/longtext {minLength,maxLength,pattern,patternMessage}, richtext {minLength,maxLength}, number {validation:{min,max}}, array {minItems,maxItems}, tags {min,max}, rating {min,max,step}"
+    "per-type config: reference {contentModelId}, multi-reference {contentModelId,min,max}, array {itemType: text|number|date|image|link|richtext}, date {includeTime, timezone}, modular|slot {blockSlugs: ['quote','gallery'], minItems?, maxItems?} (slot: playbook \xA75) \u2014 blockSlugs is REQUIRED, non-empty, and each slug must name an existing kind:'block' model; richtext {inline:true, hostTag:'h2', accept:['h2','p','b','i','u','link'], features:['bold','italic','underline','link','headings'], allowMultipleParagraphs:false} \u2014 for a field bound to ONE element on the page: `hostTag` is that element's tag and `accept` must name it, so the editor's block-style control opens already showing 'Heading 2' instead of 'Paragraph'. Name exactly ONE heading level: publish refuses an <h3> value bound to an <h2> rather than nesting one heading inside the other. Keep 'p' in `accept` or the sanitiser strips a block demoted to Paragraph; limits: text/longtext {minLength,maxLength,pattern,patternMessage}, richtext {minLength,maxLength}, number {validation:{min,max}}, array {minItems,maxItems}, tags {min,max}, rating {min,max,step}"
   ),
   fields: z.array(z.lazy(() => fieldObject)).optional().describe(
     "NESTED child fields \u2014 REQUIRED for type 'group' (one nested object, a Non-Repeatable Zone like blog_hero \u2192 heading, description, hero_image) and type 'repeater' (a repeatable array of such objects, a Repeatable Zone / section-list like testimonials \u2192 quote, author). A section with repeating items is a 'repeater'; a fixed grouped block is a 'group'. Recurse to any depth \u2014 do NOT flatten zones into separate top-level fields."
@@ -3061,7 +3323,8 @@ var fieldShape = {
   helpMore: z.string().max(2e3).optional().describe(PARAM_TEXT.helpMore),
   advanced: z.boolean().optional().describe(PARAM_TEXT.advanced),
   recommendedMax: z.number().int().positive().optional().describe(PARAM_TEXT.recommendedMax),
-  openMode: z.enum(["inline", "drill", "popover", "dialog"], { error: OPEN_MODE_INVALID }).optional().describe(PARAM_TEXT.openMode)
+  openMode: z.enum(["inline", "drill", "popover", "dialog"], { error: OPEN_MODE_INVALID }).optional().describe(PARAM_TEXT.openMode),
+  localized: z.boolean().optional()
 };
 var fieldObject = z.object(fieldShape);
 var urlPatternArg = z.string().nullable().optional().describe(
@@ -3098,8 +3361,9 @@ var seoPatchShape = {
     metaDescription: z.string().max(500).optional(),
     ogImage: z.string().url().max(2e3).nullable().optional(),
     twitterHandle: z.string().max(255).nullable().optional(),
-    og: z.object({ image: z.string().max(2048).optional(), type: z.string().max(50).optional() }).optional(),
+    og: z.object({ image: z.string().max(2048).optional(), type: z.string().max(50).optional(), siteName: z.string().max(255).optional(), locale: z.string().max(20).optional() }).optional(),
     twitter: z.object({ card: z.string().max(50).optional() }).optional(),
+    feeds: z.array(z.object({ type: z.string().max(100), href: z.string().max(2048), title: z.string().max(255).optional() })).max(10).optional(),
     collectionSchemaTypes: z.record(z.string().min(1).max(64), z.enum(SCHEMA_ORG_TYPES)).optional()
   }).optional().describe(SEO_KEY_TEXT.seoDefaults),
   siteSchema: z.union([jsonObject, z.array(jsonObject)]).optional().describe(SEO_KEY_TEXT.siteSchema),
@@ -3172,6 +3436,7 @@ function toField(f) {
     // The developer lock: stripped here, an agent writing a model back would unlock every field.
     ...f.readOnly !== void 0 ? { readOnly: f.readOnly } : {},
     ...f.lockReason !== void 0 ? { lockReason: f.lockReason } : {},
+    ...f.localized !== void 0 ? { localized: f.localized } : {},
     // V2 editor keys: on `base` so the group/repeater rebuild cannot drop them.
     ...f.helpMore !== void 0 ? { helpMore: f.helpMore } : {},
     ...f.advanced !== void 0 ? { advanced: f.advanced } : {},
@@ -3266,6 +3531,26 @@ var HOSTING_TEXT = {
   deploy_to_host: "Deploy this project to the user's own Vercel or Netlify account through their connection. BetterCMS builds the site and the host serves that build (skill publishing). The first call creates the site on the host and makes it the project's host; a later call for the same provider redeploys that site (`redeployed: true`). `connectionId` (from list_hosting_connections) defaults to the newest working one, `siteName` to the project's handle. A refusal carries a `code` and a `fixUrl` (not_connected, reconnect, pick_existing_site, grant_required, ADMIN_REQUIRED): each is fixed by the user at `fixUrl`, so relay it and stop. `deploymentQueued: false` means the project has no live build yet: deploy_project first, and that release reaches the host on its own. Never run the Vercel or Netlify CLI while a connection exists. Then poll get_host_deploy_status. Needs artifact:write, like deploy_project.",
   get_host_deploy_status: "The connected project's recent deployments to Vercel, Netlify or Cloudflare, newest first: state (queued|deploying|live|failed), providerUrl, error, sha and targetName. Poll it after deploy_to_host until the newest one is `live`, whose `providerUrl` is the live URL to hand the user, or `failed`, whose `error` you read back to them."
 };
+async function builtinCopyId(client, builtinId) {
+  const listed = await client.fetchJSON(client.url(`/management/components?select=summary`));
+  const copy = (listed.data ?? []).find((row) => row.sourceKey === builtinId && !row.builtin);
+  if (copy) return copy.id;
+  const made = await client.fetchJSON(client.url(`/management/components`), { method: "POST", body: JSON.stringify({ from: builtinId }) });
+  return made.data.id;
+}
+function publishedLines(outcome, summary) {
+  if (!outcome) return [summary];
+  if (outcome.notLive.length > 0) {
+    const values = outcome.notLive.map((v) => `${v.route} ${v.address}: ${v.reason ?? "not live"} (${v.action?.label ?? "no action"})`).join("; ");
+    if (outcome.next && outcome.notLive.every((v) => v.reason === "NOT_CHECKED")) {
+      return [`PENDING: ${values}. Read ${outcome.next} \`publishes\` until each reads live or held; do not report it as live before.`, summary];
+    }
+    return [`NOT LIVE: ${outcome.summary ?? outcome.status}. ${values}. Take each action, then read get_deploy_status \`publishes\`.`, summary];
+  }
+  if (outcome.next) return [`${summary} Published, and not judged yet: nothing has looked at the served page. Read ${outcome.next} \`publishes\` before saying it is live.`];
+  if (outcome.status !== "live") return [`${summary} Publish status: ${outcome.status}.`];
+  return [`${summary} Published: ${outcome.live > 0 ? `${outcome.live} ${outcome.live === 1 ? "value" : "values"} live on the served page` : "live"}.`];
+}
 function ok(summary, data) {
   return {
     content: [
@@ -3690,6 +3975,7 @@ function buildToolDefs(deps) {
     // Stored markers on a prop: nothing refuses a prop value for them. Declared so an echo keeps them.
     readOnly: z.union([z.literal(true), z.literal("developer")]).optional(),
     lockReason: z.string().max(200).optional(),
+    localized: z.boolean().optional(),
     showIf: z.object({
       match: z.enum(["all", "any"]),
       rules: z.array(z.object({
@@ -4466,22 +4752,27 @@ ${d.outline}` : "Proposed Content structure.", d);
       def(
         "update_page",
         "Edit a page",
-        "Edit a page: title, slug, SEO metaTitle/metaDescription, structured data (`schemaType`, `schema`), publish status (draft|published), and `blockJson` (its block composition \u2014 passing it REPLACES the whole array, so read get_page first and send its `optimisticVersion` as `ifMatch`). A `blockJson` that swaps a component block to another component comes back with `warnings` (COMPONENT_SWAP_DROPS_OVERRIDES: skill components). A section change the live page cannot show comes back in `holds`: saved as a draft, not live until each `action` is taken (skill publishing). It does NOT change the field SCHEMA \u2014 use add_field (pageId) / set_page_content for that. Renaming the slug keeps content intact. Publishing copies the draft blocks live in the same call \u2014 and on a singleton it publishes the page's content entry too; if that is refused, the page still goes live and `warnings` carries ENTRY_STILL_DRAFT (skill publishing). STRUCTURED DATA is native SEO, never a field: Automatic JSON-LD from the content, unless `schemaType` picks a schema.org type or pasted `schema` (wins over both, null clears it) is set (skill seo). " + PAGE_HEAD_NOTE + " " + SECTION_DOCTRINE,
-        z.object({ ...headPatchShape, noindex: z.boolean().optional().describe("hide this page from search engines and site search"), pageId: z.string().min(1).describe(PARAM_TEXT.pageRef), 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(), schemaType: z.enum(["auto", ...SCHEMA_ORG_TYPES]).optional().describe("structured data type; 'auto' (the default) derives it from the content"), schema: z.union([z.record(z.string(), z.unknown()), z.array(z.record(z.string(), z.unknown()))]).nullable().optional().describe("custom JSON-LD; wins over schemaType; null clears it"), status: z.enum(["draft", "published"]).optional(), scheduledAt: z.string().datetime().nullable().optional().describe(PARAM_TEXT.pageScheduledAt), unpublishAt: z.string().datetime().nullable().optional().describe(PARAM_TEXT.pageUnpublishAt), locale: z.string().nullable().optional().describe(PARAM_TEXT.locale), translationOf: z.string().nullable().optional().describe(PARAM_TEXT.translationOf), ifMatch: z.number().int().min(0).optional().describe(UPDATE_PAGE_IF_MATCH_NOTE), dynamic: z.object({ previewPath: z.string().nullable().optional().describe(PARAM_TEXT.previewPath), modelId: z.string().min(1).optional().describe(PARAM_TEXT.pageModelId) }).optional().describe(PARAM_TEXT.pageDynamic) }).shape,
+        "Edit a page: title, slug, SEO metaTitle/metaDescription, structured data (`schemaType`, `schema`), publish status (draft|published), and `blockJson` (its block composition \u2014 passing an array REPLACES the whole array, so read get_page first and send its `optimisticVersion` as `ifMatch`; an object adds or styles ONE section). An answer that starts with `held` is a draft the live page will NOT show until each of `holds` has its `action` taken, and a publish answers with `outcome`: `partial` lists the values not live. Never report either as done (skill publishing). `warnings`: COMPONENT_SWAP_DROPS_OVERRIDES (skill components), ENTRY_STILL_DRAFT and COMPONENT_DRAFT (skill publishing). It does NOT change the field SCHEMA \u2014 use add_field (pageId) / set_page_content for that. Renaming the slug keeps content intact. Publishing copies the draft blocks live in the same call, and a singleton's content entry with them. STRUCTURED DATA is native SEO, never a field: Automatic JSON-LD from the content, unless `schemaType` picks a schema.org type or pasted `schema` (wins over both, null clears it) is set (skill seo). " + PAGE_HEAD_NOTE + " " + SECTION_DOCTRINE,
+        z.object({ ...headPatchShape, noindex: z.boolean().optional().describe("hide this page from search engines and site search"), pageId: z.string().min(1).describe(PARAM_TEXT.pageRef), title: z.string().optional(), slug: z.string().optional(), blockJson: z.union([z.array(blockObject), z.object({ insertSection: z.object({ componentId: z.string().min(1), at: z.number().int().min(0).optional(), before: z.string().optional(), after: z.string().optional(), style: z.record(z.string(), z.unknown()).optional(), overrides: z.record(z.string(), z.unknown()).optional() }).strict().optional(), sectionStyle: z.object({ blockId: z.string().min(1), style: z.record(z.string(), z.unknown()) }).strict().optional() }).strict()]).optional().describe(PARAM_TEXT.pageBlockJson), metaTitle: z.string().optional(), metaDescription: z.string().optional(), schemaType: z.enum(["auto", ...SCHEMA_ORG_TYPES]).optional().describe("structured data type; 'auto' (the default) derives it from the content"), schema: z.union([z.record(z.string(), z.unknown()), z.array(z.record(z.string(), z.unknown()))]).nullable().optional().describe("custom JSON-LD; wins over schemaType; null clears it"), status: z.enum(["draft", "published"]).optional(), scheduledAt: z.string().datetime().nullable().optional().describe(PARAM_TEXT.pageScheduledAt), unpublishAt: z.string().datetime().nullable().optional().describe(PARAM_TEXT.pageUnpublishAt), locale: z.string().nullable().optional().describe(PARAM_TEXT.locale), translationOf: z.string().nullable().optional().describe(PARAM_TEXT.translationOf), ifMatch: z.number().int().min(0).optional().describe(UPDATE_PAGE_IF_MATCH_NOTE), dynamic: z.object({ previewPath: z.string().nullable().optional().describe(PARAM_TEXT.previewPath), modelId: z.string().min(1).optional().describe(PARAM_TEXT.pageModelId) }).optional().describe(PARAM_TEXT.pageDynamic) }).shape,
         async (c, a) => {
+          const edit = Array.isArray(a.blockJson) ? void 0 : a.blockJson;
+          const insert = edit?.insertSection;
+          const insertSection = insert?.componentId.startsWith("builtin:") ? { ...insert, componentId: await builtinCopyId(c, insert.componentId) } : insert;
           const res = await c.fetchJSON(
             c.url(`/management/pages/${s(a.pageId)}/meta`),
             {
               method: "PATCH",
               ...a.ifMatch !== void 0 ? { headers: { "If-Match": `W/"${a.ifMatch}"` } } : {},
-              body: JSON.stringify({ title: a.title, slug: a.slug, blockJson: a.blockJson, metaTitle: a.metaTitle, metaDescription: a.metaDescription, schemaType: a.schemaType, schema: a.schema, status: a.status, noindex: a.noindex, canonical: a.canonical, og: a.og, twitter: a.twitter, scheduledAt: a.scheduledAt, unpublishAt: a.unpublishAt, locale: a.locale, translationOf: a.translationOf, ...a.dynamic })
+              body: JSON.stringify({ title: a.title, slug: a.slug, blockJson: Array.isArray(a.blockJson) ? a.blockJson : void 0, insertSection, sectionStyle: edit?.sectionStyle, metaTitle: a.metaTitle, metaDescription: a.metaDescription, schemaType: a.schemaType, schema: a.schema, status: a.status, noindex: a.noindex, canonical: a.canonical, og: a.og, twitter: a.twitter, scheduledAt: a.scheduledAt, unpublishAt: a.unpublishAt, locale: a.locale, translationOf: a.translationOf, ...a.dynamic })
             }
           );
           const note = res.redirectNote;
-          const summary = note ? `Updated page. An existing redirect from ${note.source} already points to ${note.existingDestination}; it wasn't changed, so the old address does not redirect to the new one.` : "Updated page.";
-          const held = (res.holds ?? []).map((h) => `HELD ${h.reason}: ${h.message} Action: ${h.action.label}.`);
-          const lines = [summary, ...res.warnings ?? [], ...held].join("\n");
-          return ok(lines, res.holds?.length ? { ...res.data, holds: res.holds } : res.data);
+          const edited = res.section ? insertSection ? `Added section ${res.section.id} at position ${res.section.index + 1} of the draft.` : `Set the style of section ${res.section.id} in the draft.` : null;
+          const saved = res.held ? `${edited ? `${edited} ` : ""}The draft is saved; the live page is unchanged.` : edited ?? "Updated page.";
+          const summary = note ? `${saved} An existing redirect from ${note.source} already points to ${note.existingDestination}; it wasn't changed, so the old address does not redirect to the new one.` : saved;
+          const lines = [...res.held ? [res.held] : [], ...publishedLines(res.outcome, summary), ...res.warnings ?? []].join("\n");
+          const extra = { ...res.holds?.length ? { holds: res.holds } : {}, ...res.outcome ? { outcome: res.outcome } : {}, ...res.section ? { section: res.section } : {} };
+          return ok(lines, Object.keys(extra).length ? { ...res.data, ...extra } : res.data);
         }
       ),
       // ── Code + deploy (parity with remote /mcp; needs artifact:write) ──
@@ -4632,6 +4923,7 @@ ${d.outline}` : "Proposed Content structure.", d);
           advanced: z.boolean().nullable().optional().describe(PARAM_TEXT.advanced),
           recommendedMax: z.number().int().positive().nullable().optional().describe(PARAM_TEXT.recommendedMax),
           openMode: z.enum(["inline", "drill", "popover", "dialog"], { error: OPEN_MODE_INVALID }).nullable().optional().describe(PARAM_TEXT.openMode),
+          localized: z.boolean().nullable().optional(),
           type: fieldType.optional().describe("a new type; needs allowRetype"),
           key: fieldKey.optional().describe("a new key (flat namespace, unique in the schema)"),
           allowRetype: z.boolean().optional().describe("confirm a type change, once the user has agreed"),
@@ -4734,7 +5026,11 @@ ${d.outline}` : "Proposed Content structure.", d);
           entryIds: z.array(z.string().min(1)).max(100).optional().describe("entry ids (from list_content_entries)"),
           pageIds: z.array(z.string().min(1)).max(100).optional().describe("page ids (from list_pages); publish only")
         }).shape,
-        async (c, a) => ok(a.action === "publish" ? "Publish receipt." : "Unpublish receipt.", await data(c, "POST", `/management/publish`, { action: a.action, entryIds: a.entryIds, pageIds: a.pageIds }))
+        async (c, a) => {
+          const receipt = await data(c, "POST", `/management/publish`, { action: a.action, entryIds: a.entryIds, pageIds: a.pageIds });
+          const outcome = receipt?.outcome;
+          return ok(a.action === "publish" ? publishedLines(outcome, "Publish receipt.").join("\n") : "Unpublish receipt.", receipt);
+        }
       ),
       def(
         "create_content_entries",
@@ -4898,7 +5194,7 @@ ${d.outline}` : "Proposed Content structure.", d);
         "Get the plan for turning this site's sections into components",
         "What this site's SECTIONS would become as components \u2014 a proposal that creates nothing and is computed live. For a site whose pages were DERIVED at import, each top-level field GROUP is one section: `hero-*` and `faq-*` keys, and the repeaters the import folded (`group-*`). Per page: each section's `groupKey`, `sectionType` family, leaf `fields` with their CMS values, `shapeHash`, and either the component already rendering it (`reuse.componentId`) or the proposed one (`reuse.proposedSlug`). Under `components`, a NEW one carries the exact `props` and `blockJson` create_component would take; an EXISTING one only `componentId`, `slug` and `name` (nothing is written for it). `pending` says why a group is not offered (its codes: see `summary`). Per-page components, collection templates and chrome (never a section): skill componentize. READ `summary: true` FIRST \u2014 the full plan runs to hundreds of KB; `paged` pages it (409 PLAN_CHANGED = start again); the unpaged full read is what `--plan plan.json` takes. Keep the `digest` \u2014 componentize_sections refuses any other.",
         z.object({
-          summary: z.boolean().optional().describe("true = no values: each section's groupKey, family, pending and component slug. Read this first. `pending` codes: `NO_GROUP_ROOT` (keys are still derive-lane names like `h1-welcome` \u2014 rename them into families first), `NOT_A_SECTION` (a lone scalar or the page's own metadata; `detail: ENTRY_METADATA` = collection-template frontmatter, `detail: DECLINED` = declined with componentize_sections `decline`), `IMAGE_AS_TEXT` (a text field holding an image path \u2014 make it an image field), `ALREADY_COMPONENTIZED`, `EMPTY_GROUP`, `NESTED_REPEATER` (three deep; two levels become a nested `table` sub-field), `PAGE_NOT_EMPTY` (blocks this lane does not own and will not overwrite)."),
+          summary: z.boolean().optional().describe("true = no values: each section's groupKey, family, pending and component slug. Read this first. `pending` codes (each explained in skill componentize): `NO_GROUP_ROOT`, `NOT_A_SECTION` (`detail`: `ENTRY_METADATA`, `DECLINED`), `IMAGE_AS_TEXT`, `ALREADY_COMPONENTIZED`, `EMPTY_GROUP`, `NESTED_REPEATER`, `PAGE_NOT_EMPTY`."),
           paged: z.boolean().optional().describe("true = 10 pages at a time; the response carries `page`, `pageCount` and a `cursor` for the next."),
           cursor: z.string().optional().describe("The `cursor` from the previous page. Implies paged. A 409 `PLAN_CHANGED` means start again with no cursor.")
         }).shape,
@@ -4907,15 +5203,15 @@ ${d.outline}` : "Proposed Content structure.", d);
       def(
         "componentize_sections",
         "Turn this site's derived sections into components",
-        "Turn this site's derived sections into components. CONFIRM WITH THE USER FIRST: show them get_componentize_plan's sections, how many components it will create and which pages it will rewrite; `dryRun` first. It creates each proposed component as a DRAFT and replaces each page's DRAFT blocks with ordered `component` instances, one per group, each carrying `props.bind: \"<groupKey>\"` \u2014 the page field group that already holds the copy. Nothing is copied or moved: the page keeps its `fields`, values and bindings (`copy: \"instance\"` moves the words onto each placement instead \u2014 see `copy`). Pass the plan's `digest`; a 409 `stale-plan` means the site changed: read the plan again, show the user what changed and confirm again. Read `components.wouldDuplicate` first (skill components). Re-running is safe: a placed group returns as ALREADY_COMPONENTIZED. DRAFTS ONLY \u2014 an unpublished component renders as an EMPTY STRING on the live site, so publish_component each one and publish the pages, then call it again with `codemod: true` (or run `npx @bettercms-ai/convert --componentize` in the repo) so its templates render these sections from `pages[].blocks`. When the user says a proposed group is NOT a section, pass `decline: true` with those `sections` (and `pageIds`): nothing is componentized and the plan stops proposing them (skill componentize).",
+        "Turn this site's derived sections into components. CONFIRM WITH THE USER FIRST: show them get_componentize_plan's sections, how many components it will create and which pages it will rewrite; `dryRun` first. It creates each proposed component as a DRAFT and replaces each page's DRAFT blocks with ordered `component` instances, one per group. The page keeps its `fields`, values and bindings (see `copy`). Pass the plan's `digest`; a 409 `stale-plan` means the site changed: read the plan again, show the user what changed and confirm again. Read `components.wouldDuplicate` first (skill components). Re-running is safe: a placed group returns as ALREADY_COMPONENTIZED. DRAFTS ONLY \u2014 an unpublished component renders as an EMPTY STRING on the live site, so publish_component each one and publish the pages, then call it again with `codemod: true` for the repository half (skill componentize). A group the user says is NOT a section: `decline: true` with those `sections` (skill componentize).",
         z.object({
           digest: z.string().min(1).describe("The `digest` get_componentize_plan returned. A different one is refused with 409 stale-plan."),
           pageIds: z.array(z.string().min(1)).optional().describe("Componentize only these pages (ids from the plan). Omit for every page the plan lists."),
           pages: z.array(z.string().min(1)).optional().describe("The same page filter under the name the dashboard uses. Unioned with pageIds; an EMPTY list is refused rather than treated as every page."),
           sections: z.array(z.string().min(1)).optional().describe("Act only on these section groupKeys (from the plan); every other section keeps its placement."),
-          copy: z.enum(["bind", "instance"]).optional().describe("Who owns each section's copy. 'bind' (default) leaves it in the page fields. 'instance' is the page-builder model: each placement takes that group's CURRENT draft values into its own `props.overrides` (a repeater becomes one table prop holding every row), records which page path each came from in `props.source`, and drops `props.bind`; the page's fields are KEPT and marked `origin: \"componentized\"`."),
+          copy: z.enum(["bind", "instance"]).optional().describe("Who owns each section's copy. 'bind' (default) leaves it in the page fields. 'instance' moves it onto each placement; the page's fields are KEPT and marked `origin: \"componentized\"` (skill componentize)."),
           dryRun: z.boolean().optional().describe("true = return the receipt without writing anything. Do this first."),
-          group: z.string().min(1).max(100).optional().describe("File the components this run creates into this Component Group (a folder of the dashboard's Components tab; by NAME, created when missing), else its section family: nav, header, footer or menu \u2192 Layout, an unnamed section \u2192 Sections, otherwise the family name (Hero, FAQ). A reused component keeps its Group; the receipt's `components.groups` lists the Groups filed into."),
+          group: z.string().min(1).max(100).optional().describe("File the components this run creates into this Component Group (by NAME, created when missing), else its section family (skill componentize). A reused component keeps its Group; the receipt's `components.groups` lists the Groups filed into."),
           decline: z.boolean().optional().describe("true = record `sections` as NOT sections (nothing is componentized; the plan stops proposing them). false = offer them again. Needs `sections`."),
           joinTwins: z.boolean().optional().describe("true = move each locale copy (`/fr`) still on its own component onto its twin's (`bindPaths` keeps its fields). A dry run lists each in `joins`. Whole plan only."),
           codemod: z.boolean().optional().describe(PARAM_TEXT.componentizeCodemod)
@@ -5836,7 +6132,7 @@ ${notes.join("\n")}` : summary, created);
                 client.url(`/management/pages/${pageId}/meta`),
                 { method: "PATCH", body: JSON.stringify({ blockJson: page.blockJson, ...args.dryRun ? { dryRun: true } : {} }) }
               );
-              results.push({ ok: true, ...args.dryRun ? { status: "would-update" } : {}, pageId, slug: written.data?.slug ?? page.slug, path: written.data?.path, blocks: page.blockJson.length, ...written.holds?.length ? { holds: written.holds } : {} });
+              results.push({ ok: true, ...args.dryRun ? { status: "would-update" } : {}, pageId, slug: written.data?.slug ?? page.slug, path: written.data?.path, blocks: page.blockJson.length, ...written.held ? { held: written.held } : {}, ...written.holds?.length ? { holds: written.holds } : {} });
             } catch (err) {
               results.push({ ok: false, pageId, slug: page.slug, error: errorText(err) });
             }
@@ -5845,8 +6141,11 @@ ${notes.join("\n")}` : summary, created);
           if (args.dryRun) {
             return ok(DRY_RUN_SUMMARY, { dryRun: true, results, wouldCompose: results.length - failed, failed });
           }
+          const held = results.filter((r) => typeof r.held === "string");
+          const lead = held.length ? `HELD on ${held.length} of ${args.pages.length} page(s). ${held.map((r) => `${String(r.slug ?? r.pageId)}: ${String(r.held)}`).join(" ")}
+` : "";
           return ok(
-            `Composed ${results.length - failed} of ${args.pages.length} page(s)${failed ? `; ${failed} failed \u2014 see the per-item errors` : ""}. These are page DRAFTS: publish each with update_page status:'published'. Then call get_site_composition for the receipt.`,
+            `${lead}Composed ${results.length - failed} of ${args.pages.length} page(s)${failed ? `; ${failed} failed \u2014 see the per-item errors` : ""}. These are page DRAFTS: publish each with update_page status:'published'. Then call get_site_composition for the receipt.`,
             results
           );
         })
@@ -6241,6 +6540,15 @@ model's \`modular\` field. Create the blocks FIRST, then name their slugs (not i
 \`config.blockSlugs\`. This is the page-builder shape: one \`sections\` field holding an
 ordered list of typed blocks.
 
+A \`slot\` field (V2 blocks inside a block) takes the same \`config.blockSlugs\` (plus
+\`minItems\`, \`maxItems\` and \`slotSettings\`, leaf fields each child's \`_settings\` holds),
+but stores each child INLINE: \`[{ _key, _type: '<block slug>', _variant?, _settings?, ...values }]\`,
+its values judged by its block's fields. A component's \`slot\` prop with \`config.multiple\`
+takes the same child shape with \`_type\` the COMPONENT id (no \`_variant\`: a variant is its own
+component). A list of several item shapes on a component is a \`table\` prop with
+\`config.mode: 'types'\` and \`config.itemTypes: [{ name, label?, fields }]\`, rows
+\`[{ _key?, _type: '<name>', ...values }]\`.
+
 ## 5b. NEVER MODEL SEO. It is native.
 
 Do not create \`seoTitle\`, \`metaTitle\`, \`metaDescription\`, \`ogImage\`, \`canonicalUrl\`,
@@ -6568,7 +6876,8 @@ not carry falls back always (a static build has no file to frame).
 but a code-built site ships only what its own templates draw:
 - An added or moved section reaches the live site only when the site renders the page's block list
   itself, in order, each section root stamped \`data-bcms-block="<blockId>"\`. \`npx @bettercms-ai/convert
-  --componentize\` writes that loop (\`src/lib/bcms-sections.ts\`) and the stamps. Until it ships, the canvas
+  --sections\` wraps a page's sections in \`<BcmsSections>\`, which is that loop and the stamps
+  (\`--componentize\` lifts them into components first, where a plan exists). Until it ships, the canvas
   only ARRANGES the static build to match the draft (a section the build never rendered is stood in for
   by a server render); the editor still saves added, moved and swapped sections but says the live site
   keeps its own order, and offers "Let BetterCMS control section order" (that same codemod, committed
@@ -6576,6 +6885,15 @@ but a code-built site ships only what its own templates draw:
   with a \`SECTIONS_UNSTAMPED\` row, so \`complete\` stays false. Never hard-code a page's bands, or
   literal \`data-bcms-block\` ids, in a template whose order the CMS owns: a release measures whether
   the stamped roots come out in the CMS order (\`ordered\` on the binding report's structure row).
+- To add ONE section or set ONE section's spacing, send \`update_page\` an OBJECT \`blockJson\`:
+  \`{ insertSection: { componentId, at | before | after, style?, overrides? } }\` or
+  \`{ sectionStyle: { blockId, style } }\`. The server edits the stored page, so nothing else is
+  resent. An answer that begins with \`held\` is a saved draft this site's code will not show:
+  take the hold's action first. A publish answers with \`outcome\`; \`partial\` names each value
+  that is not live and its action. Neither is ever "done". \`get_next_steps\` keeps them listed
+  (\`publish-held\`), and its gate fails a route on \`sections\` or \`style\` until the build draws
+  the page's sections from the CMS and marks every root for style, or the release writes them in
+  place. Each failing row's \`fixCode\` says which: the project's switch, the wrap, or a rebuild.
 - A placement the site never renders (a leftover nav, footer or modal its layout draws) moves
   nothing: the editor counts section moves in RENDERED sections only and locks that row. Remove
   such placements; do not reorder around them.
@@ -6955,8 +7273,9 @@ conversion is yours to write.
 **The finish line is \`receipt.complete\`.** \`get_next_steps\` answers it from the setup gate
 (\`receipt.gate\`): every route of the live build has a published page (or entry), one page only,
 at most 2% of its visible text unowned, every image a field's and 95% of its links. \`blocking\`
-lists what fails, worst route first, each with the \`fix\` call to run; a null \`fix\` is the
-user's to decide. A gap left on purpose is RECORDED, \`editor_setup { exempt: [{ route, check,
+lists what fails, worst route first, each with the \`fix\` call to run, and \`nextAction\` is the
+one to run now (the fix that closes the most rows): run it, read again after each batch, repeat
+until \`complete\`. A null \`fix\` is the user's to decide. A gap left on purpose is RECORDED, \`editor_setup { exempt: [{ route, check,
 reason, note }] }\`, with a reason \`allowedExceptions\` lists for that check. Running out of time,
 context or patience is in \`neverExceptions\`: it is refused, and telling the user why instead
 leaves the gate incomplete. \`bettercms init\` reads the same gate when you exit and prints it.
@@ -7244,7 +7563,7 @@ Do not stop at the plan or at a partial receipt \u2014 finish the whole site, ne
    \`data-bcms-style=""\` plus \`style={...}\` from \`block.style\`. For \`upgrade-element-styles\` (field width, spacing, text handles)
    do the same with \`npx @bettercms-ai/convert@latest --upgrade-element-styles --root . --dry-run\`. Run \`--verify-styles\` again
    and restore what it lists (the marker, and the inline style from \`block.style\` or \`fieldAttrs\`, are allowed; changing a class
-   or an existing style is not). Deploy, poll, call \`get_next_steps\` again, tell me what it still lists. Not listed: say so; invent no work.
+   or an existing style is not). Deploy, poll, call \`get_next_steps\` again and run \`receipt.gate.nextAction\` until \`receipt.complete\` is true; what else it lists, tell me by name. Not listed: say so; invent no work. Its \`receipt.gate\` fails a route on \`sections\` or \`style\` while I could not add a section to that page, reorder it or space it: run each such row's \`fix\` too. A write that answers \`held\`, or a publish whose \`outcome\` is \`partial\`, is not done until its action is taken.
 11. Ask me whether to commit and push to my repository, commit only, or leave it uncommitted (unpushed, the
    next rebuild from my repo drops it). Touch git only as I answer.`;
 var FIELD_UI_PROMPT = {
@@ -7357,7 +7676,7 @@ error-prone, so go slow and confirm. Never guess the layout.
    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|number|select|group|table|slot|form|link|button|date|color|file|icon|multiselect|object|datetime|slug|email|phone|json|location|tags|rating|code|reference|multi-reference }.
+   type: text|richtext|image|url|boolean|number|select|group|table|slot|form|link|button|date|color|file|icon|multiselect|object|datetime|slug|email|phone|json|location|tags|rating|code|reference|multi-reference|video|array|longtext }.
    'select'/'multiselect' need config.options; 'group'/'table'/'object' need config.fields; a 'button'
    is ONE prop on a button block's 'props', never a label prop plus a url prop; 'slot' holds ONE nested component (a list with config.multiple);
    'form' holds ONE Form document \u2014 point target.path at 'props' on an empty form block and set
@@ -7818,9 +8137,9 @@ Read bettercms://playbook/schema section 11 first, then work this order:
    redeploy, or structural draft previews render in a generic theme, not this site's design.
 5. VERIFY \u2014 call get_next_steps and fix what it lists (it knows about missing manifests,
    a setup that has not run, and placed-but-unpublished components). You are finished only
-   when its receipt.complete is true: work receipt.gate.blocking top down, and record an item
-   you cannot close with editor_setup { exempt } under an allowed reason. Telling me why is
-   not an exception.
+   when its receipt.complete is true: run receipt.gate.nextAction, read it again after each
+   batch, and record an item you cannot close with editor_setup { exempt } only under an allowed
+   reason that is true. Telling me why is not an exception.
 
 On 401/403, the MCP key needs (re)authorizing.`
           }