@bettercms-ai/mcp 0.78.1 → 0.79.0

package/dist/index.js

@@ -2541,7 +2541,8 @@ var STRUCTURE_DEFAULT_INSTRUCTION = `After you create collections or pages, orga
 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 PUBLISH_HOLD_INSTRUCTION = "An item an author held back from site publishes (`publishHeldAt` set) stays out of whole-site publishes: do not publish it unless the user names it; publish_entries `release` includes it again.";
-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 RECEIPT_FIRST_INSTRUCTION = "Start every project with get_next_steps: its `receipt` lists what is done (`done`), what is missing (`missing`, each citing its count) and the one `nextAction`. Work from it instead of re-reading the site, and call it again after each batch of edits and before you report. 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 NO_QUESTIONS_INSTRUCTION = "Never stop a setup to ask the user: authoring (components) and media (the CDN) are recorded for you, and your prompt says whether you may push. Report what was decided.";
 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.";
@@ -3017,6 +3018,7 @@ var PARAM_TEXT = {
   pageRef: "page id or path ('/de/about'); a bare slug only when one page has it",
   editorSetupForce: "re-run a setup already ready for the live build",
   editorSetupCheck: "true = only report the state; starts nothing",
+  waitSeconds: "wait up to N seconds (max 50) for it to finish; call again while it runs",
   editorSetupExempt: "instead of running: record setup-gate exceptions [{ route, check, reason, note }]; reason null removes one. Reasons: get_next_steps `receipt.gate`",
   editorSetupDeclare: "instead of running: record binding decisions [{op, id, ...}], max 100, a result each; with `check: true` a dry run. Ops: skill bindings",
   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)",
@@ -3061,6 +3063,10 @@ var UPDATE_PAGE_IF_MATCH_NOTE = "get_page's `optimisticVersion`: the write appli
 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. Send helpText: null for a prop whose /kit schema has no description (omitted, the platform writes one).";
 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`.";
+var AUTHORING_DESCRIPTION = "Record which authoring architecture this site uses: 'components' (the default: reusable section components placed as blocks, which editors add, reorder and swap; on a site whose pages were DERIVED it keeps every field, value and binding, then run the componentize lane) or 'fields' (a typed field schema per page, for a blog, catalogue or directory). A deploy, a promote and every editor_setup record 'components' when nothing is set, so call this only to change it. Never ask the user: record it, say so in your final report, and tell them they can switch it in the dashboard.";
+var MEDIA_DEFAULT_NOTE = "Leave the default (the CDN) unless the owner asked otherwise; never ask.";
+var REBUILD_DESCRIPTION = "Rebuild from the connected repository, as the dashboard's Rebuild does. Use it when a get_next_steps fix names it, or after a push that started no build; then get_deploy_status { waitSeconds: 50 } until live, and editor_setup. 409 NOT_QUEUED: no repository (deploy_project the working tree) or publishing held.";
+var withWait = (path, waitSeconds) => typeof waitSeconds === "number" && waitSeconds > 0 ? `${path}?wait=${Math.min(Math.round(waitSeconds), 50)}` : path;
 
 // src/entry-query.ts
 var text = (v) => Array.isArray(v) ? v.map(String).join(",") : String(v);
@@ -3087,6 +3093,103 @@ function entryListSearch(args) {
   return s ? `?${s}` : "";
 }
 
+// src/kit.ts
+import { existsSync, readFileSync } from "fs";
+import { fileURLToPath } from "url";
+var KIT_URI = "bettercms://kit";
+var KIT_ENTRY_URI_PREFIX = "bettercms://kit/entry/";
+var KIT_ENTRY_URI_TEMPLATE = `${KIT_ENTRY_URI_PREFIX}{id}`;
+function loadKitCatalog(path = fileURLToPath(new URL("./kit-catalog.json", import.meta.url))) {
+  return existsSync(path) ? JSON.parse(readFileSync(path, "utf8")) : null;
+}
+var list = (xs) => xs.map((x) => `- ${x}`).join("\n");
+function entryNotes(e, h = "###") {
+  const out = [`${h} ${e.name} (\`${e.id}\`)`, "", `Tags: ${e.tags.join(", ") || "none"}. Proves: ${e.proves}`];
+  if (!e.why && !e.mcp) out.push("", "No model notes in the kit for this entry: read its props.");
+  if (e.why) out.push("", `**Why this shape.** ${e.why}`);
+  if (e.htmlSignals.length) out.push("", "**HTML signals.**", list(e.htmlSignals));
+  if (e.mcp) out.push("", `**Do.** ${e.mcp}`);
+  if (e.pitfalls.length) out.push("", "**Pitfalls.**", list(e.pitfalls));
+  if (e.notCarried.length) out.push("", `Not carried by a stored component: ${e.notCarried.join(", ")}.`);
+  return out.join("\n");
+}
+function kitIndexText(k) {
+  const byId = new Map(k.entries.map((e) => [e.id, e]));
+  return [
+    "# BetterCMS kit catalogue",
+    "",
+    `${k.entries.length} modelled website sections. Before designing a section, find the closest entry by its edge tag or category, read its notes and follow its mcp + pitfalls; its create_component props are at ${KIT_ENTRY_URI_TEMPLATE}.`,
+    "",
+    "## Categories",
+    "",
+    ...k.categories.map((c) => `- ${c.name} (${c.entries.length}): ${KIT_URI}/${c.slug}`),
+    "",
+    "## Edge tags",
+    "",
+    ...k.tags.map((t) => `- \`${t.tag}\` (${t.hint}): ${t.entries.join(", ") || "none"}`),
+    "",
+    "## Entries",
+    "",
+    ...k.categories.flatMap((c) => [
+      `### ${c.name}`,
+      "",
+      ...c.entries.map((id) => {
+        const e = byId.get(id);
+        return `- \`${e.id}\` ${e.name} [${e.tags.join(", ")}]: ${e.proves}`;
+      }),
+      ""
+    ])
+  ].join("\n");
+}
+function kitCategoryText(k, slug2) {
+  const c = k.categories.find((x) => x.slug === slug2);
+  const byId = new Map(k.entries.map((e) => [e.id, e]));
+  return [
+    `# Kit: ${c.name}`,
+    "",
+    `${c.entries.length} entries. Each one's create_component props: ${KIT_ENTRY_URI_TEMPLATE}. Index: ${KIT_URI}.`,
+    "",
+    ...c.entries.map((id) => entryNotes(byId.get(id), "##") + "\n")
+  ].join("\n");
+}
+function kitEntryText(e) {
+  return [
+    entryNotes(e, "#"),
+    "",
+    "## create_component payload",
+    "",
+    "Props in the exact shape create_component accepts. Adapt keys and copy to the site; keep the types, `ui` and config.",
+    "",
+    "```json",
+    JSON.stringify(e.component, null, 1),
+    "```",
+    ""
+  ].join("\n");
+}
+function kitDocs(k = loadKitCatalog()) {
+  if (!k) return [];
+  const doc = (uri, name, title, description, text2) => ({ uri, name, title, description, mimeType: "text/markdown", text: text2 });
+  return [
+    doc(KIT_URI, "kit", "BetterCMS kit catalogue", "Index of modelled website sections by category and edge tag: find the closest one before designing a section.", kitIndexText(k)),
+    ...k.categories.map(
+      (c) => doc(`${KIT_URI}/${c.slug}`, `kit-${c.slug}`, `Kit: ${c.name}`, `Model notes for the ${c.entries.length} ${c.name} entries: why, HTML signals, mcp, pitfalls.`, kitCategoryText(k, c.slug))
+    )
+  ];
+}
+function kitEntryTexts(k = loadKitCatalog()) {
+  return k ? Object.fromEntries(k.entries.map((e) => [`${KIT_ENTRY_URI_PREFIX}${e.id}`, kitEntryText(e)])) : {};
+}
+
+// src/field-config.ts
+var FIELD_CONFIG = loadKitCatalog()?.fieldConfig ?? null;
+var SERVER = new Set(FIELD_CONFIG?.server ?? []);
+function withoutServerKeys(config) {
+  if (!config || typeof config !== "object" || Array.isArray(config)) return config;
+  const keys = Object.keys(config);
+  return keys.some((k) => SERVER.has(k)) ? Object.fromEntries(Object.entries(config).filter(([k]) => !SERVER.has(k))) : config;
+}
+var withAgentConfig = (a) => a.config ? { ...a, config: withoutServerKeys(a.config) } : a;
+
 // src/tools.ts
 async function askHuman(deps, q) {
   if (!deps.elicit) return { prompt: q.prompt };
@@ -3130,55 +3233,6 @@ function askFramework(deps) {
   });
 }
 var AUTHORING_CHOICES = ["components", "fields"];
-var AUTHORING_LABELS = {
-  components: "Components (recommended) \u2014 reusable section components placed as blocks; editors add, reorder and swap sections without touching a schema. Recommend it for every marketing, landing, agency or product site",
-  fields: "Fields \u2014 a typed field schema per page. Only for a blog, catalogue or directory where many rows share one shape; editors can change a page's copy but cannot add, reorder or swap its sections"
-};
-var AUTHORING_PROMPT = [
-  "Ask the user which authoring architecture this site should use, then call set_authoring_preference again with their answer as `preference`:",
-  ...AUTHORING_CHOICES.map((c, i) => `  ${i + 1}. ${c} \u2014 ${AUTHORING_LABELS[c]}`),
-  "",
-  "On a site whose pages were DERIVED at import, answering 'components' redoes nothing: after set_authoring_preference, get_componentize_plan proposes one component per section (it reads the PUBLISHED pages \u2014 no deploy needed to reach it), you confirm it with the user, then componentize_sections places them with `props.bind` (dry run first \u2014 they land as drafts and the page keeps its fields, values and bindings, so click-to-edit and the coverage meter are unchanged), then publish_component each one, publish the pages, run `npx @bettercms-ai/convert --componentize` in the repo, and deploy. For a section group the plan lists as NO_GROUP_ROOT or NOT_A_SECTION there is nothing to componentize, so author that section with create_component and set_page_content.",
-  "",
-  "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");
-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",
   "richtext",
@@ -3315,7 +3369,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}, repeater {minItems, maxItems} (the list's item limits; the editor shows 'max N' and stops Add there), 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}"
+    "per-type config: reference {contentModelId}, multi-reference {contentModelId,min,max}, repeater {minItems, maxItems} (the list's item limits; the editor shows 'max N' and stops Add there), 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}. Undocumented keys open the classic editor."
   ),
   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."
@@ -3512,7 +3566,7 @@ function toField(f) {
     ...base,
     type: proseType(f),
     ...f.options ? { options: f.options } : {},
-    ...f.config ? { config: f.config } : {}
+    ...f.config ? { config: withoutServerKeys(f.config) } : {}
   };
 }
 var BRAND_KIT_NOTE = "`brandKit` (colors, typography, radius and any typeScale/spacing/elevation/motion/graphics) is edited in the BetterCMS dashboard AND by set_brand_assets and set_brand_graphics; every write is a version a person can restore. ASSETS: a media asset OF THIS PROJECT by id; null clears one; a slot a person chose needs `replace: true`. GRAPHICS: `kind`, optional `angle`, 2-8 stops naming `colors.*` or `extras` keys \u2014 never a CSS string and never a hex. CONSUME, DO NOT COPY: a hosted page exposes `--brand-color-<key>`, `--brand-shadow-<key>` and `--brand-gradient-<key>`; style sections with their `style` tokens (`nav.backgroundGradient` and `footer.backgroundGradient` take a gradient key), never copied values. Never invent brand facts: read them from get_project.";
@@ -4639,7 +4693,7 @@ ${d.outline}` : "Proposed Content structure.", d);
         "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. `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,
+        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"), structureInPlace: z.literal(true).optional().describe("true: in-place structure on (the gate fix enable-in-place-structure); never off") }).shape,
         async (c, a) => ok("Updated project.", await data(c, "PATCH", `/management/projects/current`, a))
       ),
       def(
@@ -4664,21 +4718,10 @@ ${d.outline}` : "Proposed Content structure.", d);
       def(
         "set_authoring_preference",
         "Set the site's authoring architecture",
-        "Record which authoring architecture this site uses \u2014 'components' (RECOMMENDED: reusable section components placed as blocks; editors add, reorder and swap sections without touching a schema \u2014 recommend it for every marketing, landing, agency or product site) or 'fields' (a typed field schema per page \u2014 only for a blog, catalogue or directory where many rows share one shape). ASK THE USER; do not pick for them. Called without `preference`, this tool asks them directly (or hands you the question to ask). deploy_project and promote_project both refuse with 409 AUTHORING_DECISION_REQUIRED until it is set, carrying this project's real page counts to show the user. Unset, editor_setup componentizes nothing; only `components` lets it place sections. On a site whose pages were DERIVED at import, answering 'components' redoes nothing: after set_authoring_preference, get_componentize_plan proposes one component per section (it reads the PUBLISHED pages \u2014 no deploy needed to reach it), you confirm it with the user, then componentize_sections places them with `props.bind` (dry run first \u2014 they land as drafts and the page keeps its fields, values and bindings, so click-to-edit and the coverage meter are unchanged), then publish_component each one, publish the pages, run `npx @bettercms-ai/convert --componentize` in the repo, and deploy. Asked once per project; re-callable if the user changes their mind.",
-        // Optional in the schema for exactly the reason `framework` is above: a required arg is
-        // rejected by the SDK before the handler runs, which would kill the elicitation below
-        // and leave the model guessing. Optional here, answered by a human there. The backend
-        // gate refuses the deploy regardless, so nothing ships on a guess.
-        z.object({ preference: z.enum(AUTHORING_CHOICES).optional().describe("REQUIRED in effect \u2014 the architecture the USER chose. Ask them; never default it.") }).shape,
-        async (c, a) => {
-          let preference = a.preference;
-          if (preference === void 0) {
-            const asked = await askAuthoring(deps);
-            if ("prompt" in asked) return fail(asked.prompt);
-            preference = asked.value;
-          }
-          return ok("Recorded the authoring architecture.", await data(c, "PATCH", `/management/projects/current/authoring-preference`, { preference }));
-        }
+        AUTHORING_DESCRIPTION,
+        // Required: an omitted answer must never overwrite one the owner gave (a deploy or setup records the default).
+        z.object({ preference: z.enum(AUTHORING_CHOICES).describe("components or fields") }).shape,
+        async (c, a) => ok("Recorded the authoring architecture.", await data(c, "PATCH", `/management/projects/current/authoring-preference`, { preference: a.preference }))
       ),
       def(
         "set_binding_mode",
@@ -4690,20 +4733,9 @@ ${d.outline}` : "Proposed Content structure.", d);
       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` is the choice, `mediaBaseUrl` is the origin it produces \u2014 the value the frontend's `PUBLIC_BCMS_MEDIA_URL` must match. 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 }));
-        }
+        "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. " + MEDIA_DEFAULT_NOTE + " \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` is the choice, `mediaBaseUrl` is the origin it produces \u2014 the value the frontend's `PUBLIC_BCMS_MEDIA_URL` must match. Re-callable; the last answer wins.",
+        z.object({ useCdn: z.boolean().describe("true = CDN (the default), false = API origin") }).shape,
+        async (c, a) => ok("Recorded the media delivery origin.", await data(c, "PATCH", `/management/projects/current/media-delivery`, { useCdn: a.useCdn }))
       ),
       def(
         "submit_conversion_receipt",
@@ -5018,7 +5050,7 @@ ${d.outline}` : "Proposed Content structure.", d);
             if (!modelId) return fail("This page has no backing content model; address its schema by modelId.");
           }
           if (!modelId) return fail("Pass modelId (a content model) or pageId (a page).");
-          const plan = planFieldEdit(await data(c, "GET", `/management/content/models/${s(modelId)}`), a, a.ifMatch);
+          const plan = planFieldEdit(await data(c, "GET", `/management/content/models/${s(modelId)}`), withAgentConfig(a), a.ifMatch);
           if (!plan.ok) return fail(plan.error);
           const path = a.pageId ? `/management/pages/${s(a.pageId)}/model` : `/management/content/models/${s(modelId)}`;
           const updated = (await c.fetchJSON(c.url(path), {
@@ -5506,9 +5538,16 @@ ${d.outline}` : "Proposed Content structure.", d);
         "get_deploy_status",
         "Get deploy/build status",
         "Get the connected project's deploy/build status: state (idle|queued|building|failed), whether it's publishing, the live commit sha, when it went live, and any build error. `editorSetup`: whether editing is set up for the live build (never or stale = call editor_setup). Poll this after deploy_project until state is idle with your sha live. `release`, `held` and `publishes` (each `live` or `partial`): skill publishing. `runtime` ({state: ok|crash-loop, restarts, oomKilled}) appears for a server app only: crash-loop means its container keeps restarting (often out of memory) though the build went live fine. Also returns `canvas.lane` (skill bindings) and `editorUrl`, the visual editor to hand the user.",
-        z.object({}).shape,
+        z.object({ waitSeconds: z.number().optional().describe(PARAM_TEXT.waitSeconds) }).shape,
         // Flat body, no `data` envelope: `data()` read it as undefined.
-        async (c) => ok("Deploy status.", await c.fetchJSON(c.url(`/management/projects/deploy-status`), { method: "GET" }))
+        async (c, a) => ok("Deploy status.", await c.fetchJSON(c.url(withWait(`/management/projects/deploy-status`, a.waitSeconds)), { method: "GET" }))
+      ),
+      def(
+        "rebuild_project",
+        "Rebuild from the connected repository",
+        REBUILD_DESCRIPTION,
+        z.object({}).shape,
+        async (c) => ok("Rebuild queued.", await c.fetchJSON(c.url(`/management/projects/rebuild`), { method: "POST" }))
       ),
       def(
         "editor_setup",
@@ -5517,13 +5556,14 @@ ${d.outline}` : "Proposed Content structure.", d);
         z.object({
           force: z.boolean().optional().describe(PARAM_TEXT.editorSetupForce),
           check: z.boolean().optional().describe(PARAM_TEXT.editorSetupCheck),
+          waitSeconds: z.number().optional().describe(PARAM_TEXT.waitSeconds),
           exempt: z.array(z.record(z.string(), z.unknown())).optional().describe(PARAM_TEXT.editorSetupExempt),
           declare: z.array(z.record(z.string(), z.unknown())).optional().describe(PARAM_TEXT.editorSetupDeclare)
         }).shape,
         // The route answers `{ state, … }` with no `data` envelope, so the whole body is the result.
         // `exempt` records setup-gate exceptions instead of running anything (the gate's one write).
         // `declare` records binding decisions; with `check: true` it is a dry run (the body's `dryRun`).
-        async (c, a) => a.exempt ? ok("Setup gate exceptions.", await c.fetchJSON(c.url(`/management/projects/setup-gate/exceptions`), { method: "POST", body: JSON.stringify({ exempt: a.exempt }) })) : a.declare ? ok("Binding decisions.", await c.fetchJSON(c.url(`/management/projects/binding-decisions`), { method: "POST", body: JSON.stringify({ declare: a.declare, ...a.check === true ? { dryRun: true } : {} }) })) : ok("Editor setup.", await c.fetchJSON(c.url(`/management/projects/editor-setup`), a.check === true ? { method: "GET" } : { method: "POST", body: JSON.stringify({ force: a.force }) }))
+        async (c, a) => a.exempt ? ok("Setup gate exceptions.", await c.fetchJSON(c.url(`/management/projects/setup-gate/exceptions`), { method: "POST", body: JSON.stringify({ exempt: a.exempt }) })) : a.declare ? ok("Binding decisions.", await c.fetchJSON(c.url(`/management/projects/binding-decisions`), { method: "POST", body: JSON.stringify({ declare: a.declare, ...a.check === true ? { dryRun: true } : {} }) })) : ok("Editor setup.", await c.fetchJSON(c.url(a.check === true ? withWait(`/management/projects/editor-setup`, a.waitSeconds) : `/management/projects/editor-setup`), a.check === true ? { method: "GET" } : { method: "POST", body: JSON.stringify({ force: a.force }) }))
       ),
       // ── Deploy to the user's own host (parity with remote /mcp) ──
       // A person connects Vercel or Netlify in the dashboard; nothing here touches OAuth or a host
@@ -6819,13 +6859,11 @@ build proves every binding declared; get_next_steps lists only what it could not
 without CI checks (\`"build:bcms": "astro build"\` beside \`"build": "astro check && astro build"\`),
 keeping any step the build needs. The convert codemod adds it; never edit \`build\` for BetterCMS.
 
-\`deploy_project\` and \`promote_project\` both answer **409
-AUTHORING_DECISION_REQUIRED** until a human has chosen this project's architecture. This is
-asked ONCE per project, ever. It is not an error to retry or route around: read the message
-out, let the user pick, call \`set_authoring_preference\`, then deploy again.
+The authoring architecture is never asked: a deploy, a promote and every \`editor_setup\` record
+\`components\` when nothing is set, and the owner can switch to \`fields\` in the dashboard (or
+\`set_authoring_preference\`). Say in your final report which one is recorded.
 
-Until someone answers, \`editor_setup\` derives the pages but componentizes nothing (the
-preference is null). Once \`components\` is recorded, each \`editor_setup\` componentizes the
+With \`components\` recorded, each \`editor_setup\` componentizes the
 derived pages' NEW sections in bind mode; \`fields\` stops it for good. And a run over the WHOLE plan splits a section component an earlier run placed on
 2 pages into one per page (the first page keeps it, the others get a clone), so two pages' heroes
 stop editing each other; a run narrowed to one page or section never splits.
@@ -8286,8 +8324,8 @@ Read bettercms://playbook/schema section 11 first, then work this order:
 1. EDITOR SETUP \u2014 the build imported only SEO/meta, media, brand and the models the repo
    declares. Call editor_setup and poll editor_setup { check: true } until \`ready\`: it derives
    the pages, collections, forms and bindings from the live build.
-2. AUTHORING GATE \u2014 if get_next_steps or a deploy (409 AUTHORING_DECISION_REQUIRED) asks,
-   ask ME components-or-fields (do not choose), then set_authoring_preference.
+2. AUTHORING \u2014 components is recorded by default (deploy, promote and editor_setup set it when
+   nothing is); never ask me. Report which one is recorded.
 3. COMPONENTS: get_componentize_plan -> componentize_sections (dryRun first) -> publish the
    components and pages -> componentize_sections { codemod: true } (the section-order codemod in
    the repo). FIELDS: the convert_site loop (get_conversion_brief, the codemod, the receipt).
@@ -8326,16 +8364,16 @@ On 401/403, the MCP key needs (re)authorizing.`
 }
 
 // src/skill-docs.ts
-import { existsSync, readdirSync, readFileSync } from "fs";
+import { existsSync as existsSync2, readdirSync, readFileSync as readFileSync2 } from "fs";
 import { join } from "path";
-import { fileURLToPath } from "url";
+import { fileURLToPath as fileURLToPath2 } from "url";
 var SKILL_URI_PREFIX = "bettercms://skill/";
 var CORE_SKILL = "bettercms";
 var CANDIDATES = ["./skills/bettercms/", "../../skills/bettercms/"];
 function defaultSkillDir() {
   for (const rel of CANDIDATES) {
-    const dir = fileURLToPath(new URL(rel, import.meta.url));
-    if (existsSync(join(dir, "SKILL.md"))) return dir;
+    const dir = fileURLToPath2(new URL(rel, import.meta.url));
+    if (existsSync2(join(dir, "SKILL.md"))) return dir;
   }
   return null;
 }
@@ -8375,104 +8413,17 @@ function skillDocOf(stem, text2) {
 }
 function loadSkillDocs(dir = defaultSkillDir()) {
   if (!dir) return [];
-  const docs = [skillDocOf(CORE_SKILL, readFileSync(join(dir, "SKILL.md"), "utf8"))];
+  const docs = [skillDocOf(CORE_SKILL, readFileSync2(join(dir, "SKILL.md"), "utf8"))];
   const refs = join(dir, "references");
-  if (!existsSync(refs)) return docs;
+  if (!existsSync2(refs)) return docs;
   for (const file of readdirSync(refs).filter((f) => f.endsWith(".md")).sort()) {
     const stem = file.slice(0, -3);
     if (stem === CORE_SKILL) continue;
-    docs.push(skillDocOf(stem, readFileSync(join(refs, file), "utf8")));
+    docs.push(skillDocOf(stem, readFileSync2(join(refs, file), "utf8")));
   }
   return docs;
 }
 
-// src/kit.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
-import { fileURLToPath as fileURLToPath2 } from "url";
-var KIT_URI = "bettercms://kit";
-var KIT_ENTRY_URI_PREFIX = "bettercms://kit/entry/";
-var KIT_ENTRY_URI_TEMPLATE = `${KIT_ENTRY_URI_PREFIX}{id}`;
-function loadKitCatalog(path = fileURLToPath2(new URL("./kit-catalog.json", import.meta.url))) {
-  return existsSync2(path) ? JSON.parse(readFileSync2(path, "utf8")) : null;
-}
-var list = (xs) => xs.map((x) => `- ${x}`).join("\n");
-function entryNotes(e, h = "###") {
-  const out = [`${h} ${e.name} (\`${e.id}\`)`, "", `Tags: ${e.tags.join(", ") || "none"}. Proves: ${e.proves}`];
-  if (!e.why && !e.mcp) out.push("", "No model notes in the kit for this entry: read its props.");
-  if (e.why) out.push("", `**Why this shape.** ${e.why}`);
-  if (e.htmlSignals.length) out.push("", "**HTML signals.**", list(e.htmlSignals));
-  if (e.mcp) out.push("", `**Do.** ${e.mcp}`);
-  if (e.pitfalls.length) out.push("", "**Pitfalls.**", list(e.pitfalls));
-  if (e.notCarried.length) out.push("", `Not carried by a stored component: ${e.notCarried.join(", ")}.`);
-  return out.join("\n");
-}
-function kitIndexText(k) {
-  const byId = new Map(k.entries.map((e) => [e.id, e]));
-  return [
-    "# BetterCMS kit catalogue",
-    "",
-    `${k.entries.length} modelled website sections. Before designing a section, find the closest entry by its edge tag or category, read its notes and follow its mcp + pitfalls; its create_component props are at ${KIT_ENTRY_URI_TEMPLATE}.`,
-    "",
-    "## Categories",
-    "",
-    ...k.categories.map((c) => `- ${c.name} (${c.entries.length}): ${KIT_URI}/${c.slug}`),
-    "",
-    "## Edge tags",
-    "",
-    ...k.tags.map((t) => `- \`${t.tag}\` (${t.hint}): ${t.entries.join(", ") || "none"}`),
-    "",
-    "## Entries",
-    "",
-    ...k.categories.flatMap((c) => [
-      `### ${c.name}`,
-      "",
-      ...c.entries.map((id) => {
-        const e = byId.get(id);
-        return `- \`${e.id}\` ${e.name} [${e.tags.join(", ")}]: ${e.proves}`;
-      }),
-      ""
-    ])
-  ].join("\n");
-}
-function kitCategoryText(k, slug2) {
-  const c = k.categories.find((x) => x.slug === slug2);
-  const byId = new Map(k.entries.map((e) => [e.id, e]));
-  return [
-    `# Kit: ${c.name}`,
-    "",
-    `${c.entries.length} entries. Each one's create_component props: ${KIT_ENTRY_URI_TEMPLATE}. Index: ${KIT_URI}.`,
-    "",
-    ...c.entries.map((id) => entryNotes(byId.get(id), "##") + "\n")
-  ].join("\n");
-}
-function kitEntryText(e) {
-  return [
-    entryNotes(e, "#"),
-    "",
-    "## create_component payload",
-    "",
-    "Props in the exact shape create_component accepts. Adapt keys and copy to the site; keep the types, `ui` and config.",
-    "",
-    "```json",
-    JSON.stringify(e.component, null, 1),
-    "```",
-    ""
-  ].join("\n");
-}
-function kitDocs(k = loadKitCatalog()) {
-  if (!k) return [];
-  const doc = (uri, name, title, description, text2) => ({ uri, name, title, description, mimeType: "text/markdown", text: text2 });
-  return [
-    doc(KIT_URI, "kit", "BetterCMS kit catalogue", "Index of modelled website sections by category and edge tag: find the closest one before designing a section.", kitIndexText(k)),
-    ...k.categories.map(
-      (c) => doc(`${KIT_URI}/${c.slug}`, `kit-${c.slug}`, `Kit: ${c.name}`, `Model notes for the ${c.entries.length} ${c.name} entries: why, HTML signals, mcp, pitfalls.`, kitCategoryText(k, c.slug))
-    )
-  ];
-}
-function kitEntryTexts(k = loadKitCatalog()) {
-  return k ? Object.fromEntries(k.entries.map((e) => [`${KIT_ENTRY_URI_PREFIX}${e.id}`, kitEntryText(e)])) : {};
-}
-
 // src/server.ts
 var SERVER_NAME = "bettercms";
 var SERVER_VERSION = "1.5.0";
@@ -8498,7 +8449,7 @@ function buildServer(deps) {
       // 🔴 The plain-language ask, routed — the stdio twin of the hosted connector's line
       // (src/routes/mcp/index.ts MCP_INSTRUCTIONS). "Make my site editable" has one recipe and
       // one definition of done; without this an agent converts the page it landed on and stops.
-      instructions: TOOL_LOADING_INSTRUCTION + " " + RECEIPT_FIRST_INSTRUCTION + " When the user asks to make a site or all of its pages editable and they were DERIVED at import: editor_setup, then get_next_steps until `receipt.gate.complete`. To convert its source or bind its fields: this is playbook \xA713. Read `bettercms://playbook/schema` \xA713, call get_binding_report and get_conversion_brief { complete: true }, convert EVERY route the brief lists, and finish only when get_binding_report shows coverage.pending empty on every route \u2014 not when the first page works. On a workspace-wide connection pass projectId on every call; never ask the user to re-scope the connection. " + LAYOUT_CHROME_INSTRUCTION + " " + CTA_BUTTON_INSTRUCTION + " When the user asks to componentize the whole site, to turn every section into a component, or to build a component library from the site: this is playbook \xA712. Read `bettercms://playbook/schema` \xA712, start with get_site_composition, and use the batch tools \u2014 componentize_sections, compose_pages, update_layout with `commands`, publish_components \u2014 rather than one call per component. Finish with get_site_composition and tell the user what the platform does not model (cookie banners, modals, breadcrumbs, pagination) and which components still need the owner's approval in the dashboard before they can be published. " + // The default after authoring (the structure standard): organise what you made. Same
+      instructions: RECEIPT_FIRST_INSTRUCTION + " " + NO_QUESTIONS_INSTRUCTION + " " + TOOL_LOADING_INSTRUCTION + " When the user asks to make a site or all of its pages editable and they were DERIVED at import: editor_setup, then get_next_steps until `receipt.gate.complete`. To convert its source or bind its fields: this is playbook \xA713. Read `bettercms://playbook/schema` \xA713, call get_binding_report and get_conversion_brief { complete: true }, convert EVERY route the brief lists, and finish only when get_binding_report shows coverage.pending empty on every route \u2014 not when the first page works. On a workspace-wide connection pass projectId on every call; never ask the user to re-scope the connection. " + LAYOUT_CHROME_INSTRUCTION + " " + CTA_BUTTON_INSTRUCTION + " When the user asks to componentize the whole site, to turn every section into a component, or to build a component library from the site: this is playbook \xA712. Read `bettercms://playbook/schema` \xA712, start with get_site_composition, and use the batch tools \u2014 componentize_sections, compose_pages, update_layout with `commands`, publish_components \u2014 rather than one call per component. Finish with get_site_composition and tell the user what the platform does not model (cookie banners, modals, breadcrumbs, pagination) and which components still need the owner's approval in the dashboard before they can be published. " + // The default after authoring (the structure standard): organise what you made. Same
       // sentence as the hosted connector's MCP_INSTRUCTIONS.
       STRUCTURE_DEFAULT_INSTRUCTION + " " + SKILLS_ROUTING_INSTRUCTION + " " + DOCK_UI_ROUTING_INSTRUCTION + " " + PUBLISH_HOLD_INSTRUCTION
     }
@@ -8555,7 +8506,9 @@ function buildServer(deps) {
     // `project` is the per-call target of a workspace-wide grant; the SDK sends it as
     // X-BCMS-Project. Omitted entirely when absent so a project-scoped key's request is
     // byte-identical to before.
-    createClient: (apiKey, project, branch) => withBranch(BetterCMS.management({ apiKey, baseUrl: deps.managementBaseUrl, ...project ? { project } : {} }), branch)
+    // 🔴 65 s, not the SDK's 10 s: get_deploy_status / editor_setup { waitSeconds } hold the request for up to 50 s
+    // while a build or a setup settles (tool-text.ts withWait), and a 10 s client timed every one of them out.
+    createClient: (apiKey, project, branch) => withBranch(BetterCMS.management({ apiKey, baseUrl: deps.managementBaseUrl, timeout: 65e3, ...project ? { project } : {} }), branch)
   });
   registerPrompts(server);
   return server;