@bettercms-ai/mcp 0.76.6 → 0.78.0

package/dist/index.js

@@ -2697,6 +2697,7 @@ ${JSON.stringify(STRUCTURE_EXAMPLE_PAYLOAD, null, 2)}
 `;
 
 // src/entry-merge.ts
+var mergesEntry = (args) => args.merge !== false && args.data !== void 0;
 function planEntryMerge(stored, patch, callerIfMatch) {
   const data = { ...stored.data ?? {}, ...patch };
   const ifMatch = callerIfMatch ?? (typeof stored.optimisticVersion === "number" ? stored.optimisticVersion : void 0);
@@ -2831,6 +2832,11 @@ function planFieldEdit(model, edit, callerIfMatch) {
       if (edit[k] === null && CLEARABLE.includes(k)) delete out[k];
       else out[k] = edit[k];
     }
+    if (edit.ui && typeof edit.ui === "object") {
+      const ui = mergeConfig(f.ui, edit.ui);
+      if (Object.keys(ui).length > 0) out.ui = ui;
+      else delete out.ui;
+    }
     if (edit.config && typeof edit.config === "object") out = { ...out, config: mergeConfig(f.config, edit.config) };
     if (retype) out.type = edit.type;
     if (rename !== void 0) out.key = rename;
@@ -3532,7 +3538,7 @@ var MODEL_UPDATE_KEYS = [
   "override"
 ];
 var ENTRY_META_NOTE = "SEO is native: set this entry's metaTitle, metaDescription, noindex, canonical, og, twitter, schemaType or schema in `meta` (never as model fields). `meta` MERGES into what is stored: a key you leave out is kept, null or an empty string clears it.";
-var ENTRY_MERGE_NOTE = "true = keep the fields you leave out: the entry is read, `data` is laid over its stored data by top-level key (a group or repeater value replaces that whole key) and written at the version read. Default false: `data` REPLACES the whole object.";
+var ENTRY_MERGE_NOTE = "Default true: keep the fields you leave out. The entry is read, `data` is laid over its stored data by top-level key (a group or repeater value replaces that whole key) and written at the version read. false = `data` REPLACES the whole object, deleting every field you leave out.";
 var ENTRY_IF_MATCH_NOTE = "optimisticVersion from get_content_entry: the write applies only at that version, and a 409 means it changed since: read it again and re-apply. With merge it defaults to the version merge read.";
 var ENTRY_SCHEDULED_AT_NOTE = "ISO datetime to publish this draft at (needs publish permission); null cancels. An edit that omits scheduledAt CANCELS a pending publish schedule, so send it again with every edit made before it fires.";
 var ENTRY_UNPUBLISH_AT_NOTE = "ISO datetime at which the published entry returns to draft; null cancels. Omitting it never cancels it.";
@@ -4632,8 +4638,8 @@ ${d.outline}` : "Proposed Content structure.", d);
       def(
         "update_project",
         "Update the connected project",
-        "Update the connected project's settings \u2014 rename it, change its slug/description, SEO defaults, visibility, or `presentation`. Only the provided fields change. `presentation` themes the platform's OWN renderer (the one serving a site built in the CMS with no deployed build, and previewing structural drafts everywhere) with the same closed knobs as bcms-presentation.json \u2014 DTCG { $type, $value } tokens keyed like 'page.maxWidth', 'nav.background'. Without it that renderer is a generic 768px document theme. An invalid manifest is 422 PRESENTATION_INVALID.",
-        z.object({ name: z.string().optional(), slug: z.string().optional(), description: z.string().optional(), visibility: z.string().optional(), seoDefaults: z.record(z.string(), z.unknown()).optional(), presentation: z.record(z.string(), z.unknown()).optional().describe("theme knobs for the platform renderer, keyed like bcms-presentation.json") }).shape,
+        "Update the connected project's settings \u2014 rename it, change its slug/description, SEO defaults, visibility, or `presentation`. Only the provided fields change. `subdomainAlias` renames the staging URL: 'astronapp' serves the site at astronapp.bettercms.site (3\u201355 lowercase letters, numbers, hyphens; 409 when taken; null goes back to the original). The original <handle>.bettercms.site keeps working; a replaced name is released. `presentation` themes the platform's OWN renderer (the one serving a site built in the CMS with no deployed build, and previewing structural drafts everywhere) with the same closed knobs as bcms-presentation.json \u2014 DTCG { $type, $value } tokens keyed like 'page.maxWidth', 'nav.background'. Without it that renderer is a generic 768px document theme. An invalid manifest is 422 PRESENTATION_INVALID.",
+        z.object({ name: z.string().optional(), slug: z.string().optional(), description: z.string().optional(), visibility: z.string().optional(), seoDefaults: z.record(z.string(), z.unknown()).optional(), presentation: z.record(z.string(), z.unknown()).optional().describe("theme knobs for the platform renderer, keyed like bcms-presentation.json"), subdomainAlias: z.string().nullable().optional().describe("the staging name: 'astronapp' \u2192 astronapp.bettercms.site; null = back to the original") }).shape,
         async (c, a) => ok("Updated project.", await data(c, "PATCH", `/management/projects/current`, a))
       ),
       def(
@@ -4975,7 +4981,7 @@ ${d.outline}` : "Proposed Content structure.", d);
           required: z.boolean().optional(),
           config: z.record(z.string(), z.unknown()).optional().describe("per-type validation/config keys, merged into the stored config; null deletes a key"),
           showIf: z.record(z.string(), z.unknown()).nullable().optional().describe("same shape as on add_field; null clears it"),
-          ui: z.record(z.string(), z.unknown()).nullable().optional().describe("same vocabulary as on add_field; null clears it"),
+          ui: z.record(z.string(), z.unknown()).nullable().optional().describe("same vocabulary as on add_field; merged per key, a null key or ui:null clears"),
           placement: z.enum(["cover", "title", "excerpt", "body", "inline", "panel"]).nullable().optional(),
           readOnly: z.union([z.literal(true), z.literal("developer")]).nullable().optional().describe(PARAM_TEXT.lockClears),
           lockReason: z.string().max(200).nullable().optional().describe(PARAM_TEXT.lockClears),
@@ -5822,12 +5828,12 @@ ${notes.join("\n")}` : summary, created);
       name: "update_content_entry",
       config: {
         title: "Update a content entry's values",
-        description: "Update a content entry's `data` (field values) and/or status by id. `data` is keyed by field key; a nested 'array' (zone) value is an object { nonRepeatable: {\u2026}, repeatable: [{\u2026}] }, a primitive 'array' is a plain list; an image value may carry this placement's focal {x,y} and crop {top,right,bottom,left} (0\u20131). Use this to edit an existing entry; for a singleton page prefer set_page_content. \u{1F534} `data` REPLACES the entry's whole value object: an optional field you leave out is DELETED, and a required one you leave out fails the whole write. To change one field, pass merge:true, or read the entry (get_content_entry), change that key and send the whole object back. " + FIELD_LOCKED_NOTE + " " + ENTRY_META_NOTE,
+        description: "Update a content entry's `data` (field values) and/or status by id. `data` is keyed by field key; a nested 'array' (zone) value is an object { nonRepeatable: {\u2026}, repeatable: [{\u2026}] }, a primitive 'array' is a plain list; an image value may carry this placement's focal {x,y} and crop {top,right,bottom,left} (0\u20131). Use this to edit an existing entry; for a singleton page prefer set_page_content. `data` MERGES into the stored values by top-level key: a field you leave out is kept, null clears one, and a group or repeater value replaces that whole key. \u{1F534} merge:false REPLACES the whole value object instead: an optional field you leave out is DELETED, and a required one you leave out fails the whole write. " + FIELD_LOCKED_NOTE + " " + ENTRY_META_NOTE,
         inputSchema: updateEntryInput.shape
       },
       handler: guard(
         async (args) => withClient(async (client) => {
-          const write = args.merge === true && args.data !== void 0 ? planEntryMerge(await client.getEntry(args.entryId), args.data, args.ifMatch) : { data: args.data, ifMatch: args.ifMatch };
+          const write = mergesEntry(args) ? planEntryMerge(await client.getEntry(args.entryId), args.data, args.ifMatch) : { data: args.data, ifMatch: args.ifMatch };
           const input = {
             ...write.data !== void 0 ? { data: write.data } : {},
             ...args.status !== void 0 ? { status: args.status } : {},
@@ -7861,8 +7867,8 @@ Read \`bettercms://playbook/schema\` \xA712 first \u2014 this is the short form
    Use Global, Navigation, Actions, Content, Forms, Media, Sections, Page-specific. \`category\`
    is the separate picker TAB.
 4. **Fields** = \`props\`: text, richtext, image, url, boolean, number, select, group, table, slot.
-   Always a \`defaultValue\`; \`required\` / \`helpText\` / \`placeholder\` are editor hints, not write
-   -time enforcement. \`select\` for styling-only variants, a separate component when the markup
+   Always a \`defaultValue\`; \`helpText\` / \`placeholder\` are editor hints. A placement you SET empty on a
+   \`required\` prop is refused (\`required_value\`). \`select\` for styling-only variants, a separate component when the markup
    differs. Nesting goes up to 10 levels; a \`table\` row may hold a data table or a polymorphic list.
 5. **Quality.** The componentize lane and \`npx @bettercms-ai/convert --componentize\` move markup
    VERBATIM \u2014 classes, responsive utilities, aria attributes, alt text all survive. Never