@bettercms-ai/mcp 0.50.0 → 0.51.0

package/dist/index.js

@@ -2730,7 +2730,12 @@ function buildToolDefs(deps) {
       max: z.number().optional().describe("'number' fields only \u2014 inclusive ceiling"),
       phoneFormat: z.enum(["any", "e164"]).optional().describe("'phone' fields only"),
       pattern: z.string().optional().describe("'text' / 'textarea' / 'url' fields only \u2014 a regex")
-    }).optional().describe("per-field rules the API enforces on submit; each key is only valid on the field types listed")
+    }).optional().describe("per-field rules the API enforces on submit; each key is only valid on the field types listed"),
+    ui: z.strictObject({
+      countryPicker: z.boolean().optional().describe("'phone' fields only \u2014 render a country picker; the value is stored as E.164"),
+      defaultCountry: z.string().optional().describe("'phone' fields only \u2014 uppercase ISO 3166-1 alpha-2 the picker starts on; requires countryPicker"),
+      showFlags: z.boolean().optional().describe("'phone' fields only \u2014 show the country flag beside the dial code; requires countryPicker")
+    }).optional().describe("per-field presentation options; each key is only valid on the field types listed")
   });
   const formSettingsShape = {
     description: z.string().optional(),
@@ -3440,7 +3445,7 @@ ${d.outline}` : "Proposed Content structure.", d);
       def(
         "list_content_models",
         "List content models",
-        "List the content models (reusable schemas for dynamic collections like Blog/Products) in the connected project.",
+        "List the content models (reusable schemas for dynamic collections like Blog/Products) in the connected project. A project-scoped connection sees its own project's models plus workspace-level ones, which it can read but not change.",
         z.object({}).shape,
         async (c) => ok("Content models.", await data(c, "GET", `/management/content/models`))
       ),
@@ -3477,7 +3482,7 @@ ${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). 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. STRUCTURED DATA is native SEO, never a field: leave it out and the page gets Automatic JSON-LD from its content (WebSite on the home page, Blog/CollectionPage on a collection's list page, WebPage otherwise); `schemaType` picks an explicit schema.org type whose properties are filled from the content; `schema` is pasted JSON-LD and wins over both (null clears it). " + PAGE_HEAD_NOTE + " " + SECTION_DOCTRINE,
+        "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). A `blockJson` that swaps a component block to another component comes back with `warnings` (COMPONENT_SWAP_DROPS_OVERRIDES) naming the overrides the new component does not render; they stay on the block, so swapping back restores them. 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. STRUCTURED DATA is native SEO, never a field: leave it out and the page gets Automatic JSON-LD from its content (WebSite on the home page, Blog/CollectionPage on a collection's list page, WebPage otherwise); `schemaType` picks an explicit schema.org type whose properties are filled from the content; `schema` is pasted JSON-LD and wins over both (null clears it). " + 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), 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", "WebPage", "AboutPage", "ContactPage", "CollectionPage", "Blog", "BlogPosting", "Article", "Product", "FAQPage", "Event", "Organization", "LocalBusiness"]).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() }).shape,
         async (c, a) => {
           const res = await c.fetchJSON(
@@ -3488,10 +3493,9 @@ ${d.outline}` : "Proposed Content structure.", d);
             }
           );
           const note = res.redirectNote;
-          return ok(
-            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.",
-            res.data
-          );
+          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.";
+          return ok(res.warnings?.length ? `${summary}
+${res.warnings.join("\n")}` : summary, res.data);
         }
       ),
       // ── Code + deploy (parity with remote /mcp; needs artifact:write) ──
@@ -3945,9 +3949,11 @@ ${d.outline}` : "Proposed Content structure.", d);
             ...args.slug !== void 0 ? { slug: args.slug } : {},
             ...args.data !== void 0 ? { data: args.data } : {}
           });
-          const entry = args.status !== void 0 && args.status !== "draft" ? await client.updateEntry(created.id, { status: args.status }) : created;
+          const published = args.status !== void 0 && args.status !== "draft" ? await client.updateEntry(created.id, { status: args.status }) : created;
+          const { warnings, ...entry } = published;
+          const notes = [.../* @__PURE__ */ new Set([...created.warnings ?? [], ...warnings ?? []])];
           return ok(
-            `Created entry '${entry.slug}' (id ${entry.id}, status ${entry.status}).`,
+            [`Created entry '${entry.slug}' (id ${entry.id}, status ${entry.status}).`, ...notes].join("\n"),
             entry
           );
         })
@@ -3977,7 +3983,7 @@ ${d.outline}` : "Proposed Content structure.", d);
       name: "list_content_entries",
       config: {
         title: "List content entries (incl. drafts)",
-        description: "List content entries \u2014 including drafts \u2014 filtered by model and/or page. Use it to SEE existing content before editing. For a singleton page, pass its pageId to get its single entry.",
+        description: "List content entries \u2014 including drafts \u2014 filtered by model and/or page. Use it to SEE existing content before editing. For a singleton page, pass its pageId to get its single entry. A project-scoped connection sees its own project's entries plus workspace-level ones, which it can read but not change.",
         inputSchema: listEntriesInput.shape
       },
       handler: guard(
@@ -4014,13 +4020,13 @@ ${d.outline}` : "Proposed Content structure.", d);
       },
       handler: guard(
         async (args) => withClient(async (client) => {
-          const entry = await client.updateEntry(args.entryId, {
+          const { warnings, ...entry } = await client.updateEntry(args.entryId, {
             ...args.data !== void 0 ? { data: args.data } : {},
             ...args.status !== void 0 ? { status: args.status } : {},
             ...args.slug !== void 0 ? { slug: args.slug } : {},
             ...args.meta !== void 0 ? { meta: args.meta } : {}
           });
-          return ok(`Updated entry '${entry.slug}' (id ${entry.id}, status ${entry.status}).`, entry);
+          return ok([`Updated entry '${entry.slug}' (id ${entry.id}, status ${entry.status}).`, ...warnings ?? []].join("\n"), entry);
         })
       )
     },
@@ -5553,7 +5559,9 @@ Author a form (then the user embeds it with \`<BcmsForm form={getForm('Name')} /
    \`options\`), radio (needs \`options\`), number, phone, date, url, consent, hidden. Optional per
    field: required?, placeholder?, helpText? (shown under the input), defaultValue?,
    \`validation\` (\`emailPolicy\` on email, \`min\`/\`max\` on number, \`phoneFormat\` on phone,
-   \`pattern\` on text/textarea/url \u2014 a rule on any other type is a 400), and
+   \`pattern\` on text/textarea/url \u2014 a rule on any other type is a 400),
+   \`ui\` (\`countryPicker\` + \`defaultCountry\` on phone \u2014 renders a country picker and stores
+   E.164; \`defaultCountry\` without \`countryPicker\` is a 400), and
    \`showIf: { field, equals }\` for conditional display.
 3. **Settings** \u2014 name (used by getForm('Name')), submitLabel?, successMessage?, redirectUrl?.
 4. **Confirm**, then \`create_form\` { name, fields, ... } (returns the new id), or