@bettercms-ai/mcp 0.46.0 → 0.47.0

package/dist/index.js

@@ -2102,6 +2102,19 @@ ${JSON.stringify(STRUCTURE_EXAMPLE_PAYLOAD, null, 2)}
 `;
 
 // src/tools.ts
+async function askHuman(deps, q) {
+  if (!deps.elicit) return { prompt: q.prompt };
+  try {
+    const res = await deps.elicit({
+      message: q.message,
+      requestedSchema: { type: "object", properties: { [q.key]: q.property }, required: [q.key] }
+    });
+    const picked = res.action === "accept" ? res.content?.[q.key] : void 0;
+    if (q.accept(picked)) return { value: picked };
+  } catch {
+  }
+  return { prompt: q.prompt };
+}
 var FRAMEWORK_CHOICES = ["astro", "next", "react-ts", "other"];
 var FRAMEWORK_LABELS = {
   astro: "Astro \u2014 recommended default, static by default and fastest to publish",
@@ -2115,32 +2128,20 @@ var FRAMEWORK_PROMPT = [
   "",
   "Do not choose on their behalf. Sites cannot be built as plain HTML/CSS \u2014 every project is backed by one of these starters, which is what keeps its content editable in the CMS."
 ].join("\n");
-async function askFramework(deps) {
-  if (!deps.elicit) return { prompt: FRAMEWORK_PROMPT };
-  try {
-    const res = await deps.elicit({
-      message: "Which technology should this site be built with?",
-      requestedSchema: {
-        type: "object",
-        properties: {
-          framework: {
-            type: "string",
-            title: "Technology",
-            description: "The frontend stack this project's starter is based on.",
-            enum: [...FRAMEWORK_CHOICES],
-            enumNames: FRAMEWORK_CHOICES.map((c) => FRAMEWORK_LABELS[c])
-          }
-        },
-        required: ["framework"]
-      }
-    });
-    const picked = res.action === "accept" ? res.content?.framework : void 0;
-    if (typeof picked === "string" && FRAMEWORK_CHOICES.includes(picked)) {
-      return { framework: picked };
-    }
-  } catch {
-  }
-  return { prompt: FRAMEWORK_PROMPT };
+function askFramework(deps) {
+  return askHuman(deps, {
+    key: "framework",
+    message: "Which technology should this site be built with?",
+    property: {
+      type: "string",
+      title: "Technology",
+      description: "The frontend stack this project's starter is based on.",
+      enum: [...FRAMEWORK_CHOICES],
+      enumNames: FRAMEWORK_CHOICES.map((c) => FRAMEWORK_LABELS[c])
+    },
+    accept: (v) => typeof v === "string" && FRAMEWORK_CHOICES.includes(v),
+    prompt: FRAMEWORK_PROMPT
+  });
 }
 var AUTHORING_CHOICES = ["components", "fields"];
 var AUTHORING_LABELS = {
@@ -2156,32 +2157,41 @@ var AUTHORING_PROMPT = [
   "Recommend components unless the user says the site is schema-first.",
   "Do not choose on their behalf. This is asked once per project."
 ].join("\n");
-async function askAuthoring(deps) {
-  if (!deps.elicit) return { prompt: AUTHORING_PROMPT };
-  try {
-    const res = await deps.elicit({
-      message: "Which authoring architecture should this site use? Components is recommended for a marketing site.",
-      requestedSchema: {
-        type: "object",
-        properties: {
-          preference: {
-            type: "string",
-            title: "Authoring architecture",
-            description: "How this site's pages are composed. Components is recommended unless this is a schema-first site (a blog, catalogue or directory). Asked once per project.",
-            enum: [...AUTHORING_CHOICES],
-            enumNames: AUTHORING_CHOICES.map((c) => AUTHORING_LABELS[c])
-          }
-        },
-        required: ["preference"]
-      }
-    });
-    const picked = res.action === "accept" ? res.content?.preference : void 0;
-    if (typeof picked === "string" && AUTHORING_CHOICES.includes(picked)) {
-      return { preference: picked };
-    }
-  } catch {
-  }
-  return { prompt: AUTHORING_PROMPT };
+function askAuthoring(deps) {
+  return askHuman(deps, {
+    key: "preference",
+    message: "Which authoring architecture should this site use? Components is recommended for a marketing site.",
+    property: {
+      type: "string",
+      title: "Authoring architecture",
+      description: "How this site's pages are composed. Components is recommended unless this is a schema-first site (a blog, catalogue or directory). Asked once per project.",
+      enum: [...AUTHORING_CHOICES],
+      enumNames: AUTHORING_CHOICES.map((c) => AUTHORING_LABELS[c])
+    },
+    accept: (v) => typeof v === "string" && AUTHORING_CHOICES.includes(v),
+    prompt: AUTHORING_PROMPT
+  });
+}
+var USE_CDN_PROMPT = [
+  "Ask the user where this site's media should be served from, then call set_media_delivery again with their answer as `useCdn`:",
+  "  1. true  \u2014 the BetterCMS CDN (recommended, and the default). Media URLs are minted on the CDN host, or on the project's own CDN base if it stores media in its own bucket.",
+  "  2. false \u2014 the API origin. Media URLs are minted on the API host instead. Same bytes, same service; only the hostname differs.",
+  "",
+  "This applies to URLs minted FROM NOW ON. Already-published content keeps the URLs it has, and they keep working."
+].join("\n");
+function askMediaDelivery(deps) {
+  return askHuman(deps, {
+    key: "useCdn",
+    message: "Serve this site's media from the BetterCMS CDN (recommended), or from the API origin?",
+    property: {
+      type: "boolean",
+      title: "Use the CDN",
+      description: "On (default): media URLs are minted on the CDN \u2014 or on this project's own CDN base if it uses its own bucket. Off: they are minted on the API origin instead. Same bytes either way; only the host changes, and only for URLs minted from now on.",
+      default: true
+    },
+    accept: (v) => typeof v === "boolean",
+    prompt: USE_CDN_PROMPT
+  });
 }
 var fieldType = z.enum([
   "text",
@@ -3299,7 +3309,7 @@ ${d.outline}` : "Proposed Content structure.", d);
           if (framework === void 0) {
             const asked = await askFramework(deps);
             if ("prompt" in asked) return fail(asked.prompt);
-            framework = asked.framework;
+            framework = asked.value;
           }
           return ok("Created project.", await data(c, "POST", `/management/projects`, { ...a, framework }));
         }
@@ -3318,7 +3328,7 @@ ${d.outline}` : "Proposed Content structure.", d);
           if (preference === void 0) {
             const asked = await askAuthoring(deps);
             if ("prompt" in asked) return fail(asked.prompt);
-            preference = asked.preference;
+            preference = asked.value;
           }
           return ok("Recorded the authoring architecture.", await data(c, "PATCH", `/management/projects/current/authoring-preference`, { preference }));
         }
@@ -3330,6 +3340,24 @@ ${d.outline}` : "Proposed Content structure.", d);
         z.object({ declaredBindings: z.boolean().describe("true = trust the template's declared bindings; false = text-match (the default)") }).shape,
         async (c, a) => ok("Recorded the binding mode.", await data(c, "PATCH", `/management/projects/current/binding-mode`, { declaredBindings: a.declaredBindings }))
       ),
+      def(
+        "set_media_delivery",
+        "Choose where this site's media is served from",
+        "Record whether this project's media (images, video, files) is served from the BetterCMS CDN or from the API origin. `useCdn: true` is the DEFAULT and the recommendation: URLs are minted on the CDN host, or on the project's own CDN base when it stores media in its own bucket (BYOK). `useCdn: false` mints them on the API origin instead \u2014 the same service serving the same bytes, only under a different hostname. ASK THE USER; do not pick for them. Called without `useCdn`, this tool asks them directly (or hands you the question to ask). \u{1F534} IT APPLIES TO URLs MINTED FROM NOW ON \u2014 new uploads, entry saves, get_media. It does NOT rewrite URLs already stored in published content, and it does not need to: the old URLs keep resolving. To move an existing image, re-save the field that holds it. \u{1F534} IT IS THE BACKEND HALF ONLY. A deployed frontend builds its own transform URLs with @bettercms-ai/image-url, which has its own media host \u2014 set `PUBLIC_BCMS_MEDIA_URL` (or the integration's `mediaUrl` option) to match, or that site's resized images stay on the CDN while everything else moves. Read the current answer from get_project (`useCdn`). Re-callable; the last answer wins.",
+        // Optional in the schema for the same reason `framework` and `preference` are: a
+        // required arg is rejected by the SDK before the handler runs, which would kill the
+        // elicitation below and leave the model guessing.
+        z.object({ useCdn: z.boolean().optional().describe("REQUIRED in effect \u2014 the USER's answer. true = CDN (the default), false = API origin. Ask them; never default it.") }).shape,
+        async (c, a) => {
+          let useCdn = a.useCdn;
+          if (useCdn === void 0) {
+            const asked = await askMediaDelivery(deps);
+            if ("prompt" in asked) return fail(asked.prompt);
+            useCdn = asked.value;
+          }
+          return ok("Recorded the media delivery origin.", await data(c, "PATCH", `/management/projects/current/media-delivery`, { useCdn }));
+        }
+      ),
       def(
         "submit_conversion_receipt",
         "Record what the conversion codemod could and could not do",
@@ -6007,7 +6035,7 @@ and \`ui\` only changes editor chrome, so there is nothing to flip.`
 
 // src/server.ts
 var SERVER_NAME = "bettercms";
-var SERVER_VERSION = "1.4.0";
+var SERVER_VERSION = "1.5.0";
 var SERVER_DISPLAY = {
   title: "BetterCMS",
   websiteUrl: "https://bettercms.ai",