@omniharmonic/openspace-cli 0.1.16 → 0.1.17

package/dist/{chunk-JDVCOOGD.js → chunk-HUS7TQPS.js}

@@ -7579,12 +7579,18 @@ var trimSlashes = (s2) => s2.replace(/^\/+|\/+$/g, "");
 var LinkTargets = class {
   constructor(doc) {
     this.doc = doc;
-    this.slugs = new Set(Object.values(doc.pages).map((p) => p.slug));
+    this.bySlug = new Map(Object.values(doc.pages).map((p) => [p.slug, p]));
+    this.slugs = new Set(this.bySlug.keys());
     this.redirectFroms = new Set((doc.site.redirects ?? []).map((r) => trimSlashes(r.from)));
   }
   doc;
   slugs;
   redirectFroms;
+  bySlug;
+  /** The page at a site-internal path (`/about/#team` → About), if it is one. */
+  pageAt(raw2) {
+    return this.bySlug.get(trimSlashes(raw2.split(/[?#]/)[0] ?? ""));
+  }
   hasCollection(name) {
     return name in this.doc.collections || name in (this.doc.collectionConfigs ?? {});
   }
@@ -7610,8 +7616,34 @@ var isObject = (v) => !!v && typeof v === "object" && !Array.isArray(v);
 function findBrokenLinks(doc) {
   const targets = new LinkTargets(doc);
   const out = [];
+  const fragments = /* @__PURE__ */ new Map();
+  const fragmentsOf = (page) => {
+    let f = fragments.get(page);
+    if (!f) {
+      f = pageFragments(doc, page);
+      fragments.set(page, f);
+    }
+    return f;
+  };
+  const sectionIds = new Set(
+    Object.values(doc.pages).flatMap((p) => p.sections.map((s2) => s2.id))
+  );
   const walk5 = (value, scope, path2, where2) => {
     const add = (kind, target, message, severity = "error") => out.push({ scope, path: path2, ...where2, kind, target, severity, message });
+    const checkAnchor = (o2) => {
+      const ref = anchorRef(o2, targets, scope.kind === "page" ? scope.page : void 0);
+      if (!ref || fragmentsOf(ref.page.id).has(ref.fragment)) return;
+      out.push({
+        scope,
+        path: path2,
+        ...where2,
+        kind: "anchor",
+        target: ref.target,
+        severity: "warning",
+        message: `Link to ${ref.target}: no section on ${pageTitle(ref.page)} is called \u201C${ref.fragment}\u201D`,
+        anchor: { page: ref.page.id, fragment: ref.fragment }
+      });
+    };
     if (typeof value === "string") {
       if (path2[path2.length - 1] === "body")
         for (const m of value.matchAll(MARKDOWN_LINK_RE)) {
@@ -7630,6 +7662,10 @@ function findBrokenLinks(doc) {
     if (o.type === "page" && typeof o.page === "string") {
       if (!(o.page in doc.pages))
         add("page", o.page, `Link to page ${o.page} but no such page exists`);
+      else checkAnchor(o);
+    } else if (o.type === "anchor" && typeof o.section === "string") {
+      if (!sectionIds.has(o.section))
+        add("anchor", o.section, "Link to a section that no longer exists", "warning");
     } else if (o.type === "item" && typeof o.collection === "string" && typeof o.slug === "string") {
       if (!doc.collections[o.collection]?.[o.slug])
         add(
@@ -7647,10 +7683,12 @@ function findBrokenLinks(doc) {
     } else if (o.type === "url" && typeof o.url === "string" && isInternalPath(o.url)) {
       if (!targets.pathResolves(o.url))
         add("url", o.url, `Link to ${o.url} does not lead to any page`);
+      else checkAnchor(o);
     } else if (o.type === "link" && isObject(o.attrs) && typeof o.attrs.href === "string") {
       const href = o.attrs.href;
       if (isInternalPath(href) && !targets.pathResolves(href))
         add("richtext", href, `Text link to ${href} does not lead to any page`, "warning");
+      else checkAnchor(o);
     }
     for (const [k, v] of Object.entries(o)) walk5(v, scope, [...path2, k], where2);
   };
@@ -7788,6 +7826,121 @@ function withPages(doc, pages) {
   for (const p of pages) all[p.id] = p;
   return { ...doc, pages: all };
 }
+var pageTitle = (p) => p.title || (p.slug === "" ? "Home" : p.slug);
+var LANDMARKS = ["main", "top"];
+var TEMPLATE_ID_RE = /\bid\s*=\s*["']([A-Za-z][\w-]*)["']/g;
+function pageFragments(doc, pageId) {
+  const ids = new Set(LANDMARKS);
+  const blocks2 = /* @__PURE__ */ new Set();
+  const page = doc.pages[pageId];
+  for (const s2 of [...page?.sections ?? [], doc.site.footer]) {
+    ids.add(s2.anchor ?? s2.id);
+    for (const b of s2.blocks) {
+      blocks2.add(b.id);
+      const name = /^component\/(.+)$/.exec(b.type)?.[1];
+      const tpl = name ? doc.components?.[name]?.template : void 0;
+      if (tpl) {
+        for (const m of tpl.matchAll(TEMPLATE_ID_RE)) if (m[1]) ids.add(m[1]);
+      }
+    }
+  }
+  return {
+    has: (f) => ids.has(f) || blocks2.has(f) || [...blocks2].some((b) => f.startsWith(`${b}-`))
+  };
+}
+function anchorRef(o, targets, currentPage) {
+  if (o.type === "page" && typeof o.page === "string" && typeof o.anchor === "string") {
+    const page2 = targets.doc.pages[o.page];
+    return page2 ? { page: page2, fragment: o.anchor, target: `${pagePath(page2)}#${o.anchor}` } : void 0;
+  }
+  const href = o.type === "url" && typeof o.url === "string" ? o.url : o.type === "link" && isObject(o.attrs) && typeof o.attrs.href === "string" ? o.attrs.href : void 0;
+  if (!href) return void 0;
+  const hash = /#([^#?]+)$/.exec(href)?.[1];
+  if (!hash) return void 0;
+  if (href.startsWith("#")) {
+    if (o.type !== "link" || !currentPage) return void 0;
+    const page2 = targets.doc.pages[currentPage];
+    return page2 ? { page: page2, fragment: hash, target: href } : void 0;
+  }
+  if (!isInternalPath(href)) return void 0;
+  const page = targets.pageAt(href);
+  return page ? { page, fragment: hash, target: href } : void 0;
+}
+function readableStrings(value, out = []) {
+  if (typeof value === "string") {
+    if (!/^(?:\/|#|https?:|mailto:|tel:|media\/|data:)/.test(value)) out.push(value);
+  } else if (Array.isArray(value)) for (const v of value) readableStrings(v, out);
+  else if (isObject(value)) {
+    for (const [k, v] of Object.entries(value))
+      if (!["type", "id", "src", "url", "href", "page", "variant", "level", "preset"].includes(k))
+        readableStrings(v, out);
+  }
+  return out;
+}
+function linksToAnchor(value, targets, pageId, fragment) {
+  if (Array.isArray(value)) return value.some((v) => linksToAnchor(v, targets, pageId, fragment));
+  if (!isObject(value)) return false;
+  const ref = anchorRef(value, targets, pageId);
+  if (ref && ref.page.id === pageId && ref.fragment === fragment) return true;
+  return Object.values(value).some((v) => linksToAnchor(v, targets, pageId, fragment));
+}
+function suggestAnchorSection(doc, pageId, fragment) {
+  const page = doc.pages[pageId];
+  const wanted = words(fragment);
+  if (!page || !wanted.length) return void 0;
+  const targets = new LinkTargets(doc);
+  const match = (s2) => {
+    const own3 = words(s2);
+    const hits = wanted.filter((w) => own3.some((x) => related(w, x))).length;
+    return hits === wanted.length ? 2 : hits ? 1 : 0;
+  };
+  let best;
+  let bestScore = 0;
+  for (const s2 of page.sections) {
+    if (linksToAnchor(s2.blocks, targets, page.id, fragment)) continue;
+    const name = [
+      s2.label ?? "",
+      s2.anchor ?? "",
+      (s2.preset ?? "").replace(/@\d+$/, ""),
+      ...s2.blocks.map((b) => b.type.replace(/^component\//, ""))
+    ].join(" ");
+    const text7 = readableStrings(s2.blocks.map((b) => b.fields)).reduce((n, t) => n + match(t), 0);
+    const score = match(name) * 4 + Math.min(text7, 4);
+    if (score > bestScore) {
+      best = s2;
+      bestScore = score;
+    }
+  }
+  return bestScore >= 2 ? best : void 0;
+}
+function retargetAnchor(value, doc, pageId, from, to, currentPage) {
+  const targets = new LinkTargets(doc);
+  let changed = 0;
+  const swap = (href) => {
+    const base = href.slice(0, href.length - from.length - 1);
+    if (to) return `${base}#${to}`;
+    return base || "#top";
+  };
+  const fix = (v) => {
+    if (Array.isArray(v)) return v.map(fix);
+    if (!isObject(v)) return v;
+    const ref = anchorRef(v, targets, currentPage);
+    if (ref && ref.page.id === pageId && ref.fragment === from) {
+      changed++;
+      if (v.type === "page") {
+        const { anchor: _a3, ...rest } = v;
+        return to ? { ...rest, anchor: to } : rest;
+      }
+      if (v.type === "url") return { ...v, url: swap(v.url) };
+      const attrs = v.attrs;
+      return { ...v, attrs: { ...attrs, href: swap(attrs.href) } };
+    }
+    const out = {};
+    for (const [k, x] of Object.entries(v)) out[k] = fix(x);
+    return out;
+  };
+  return { value: fix(value), changed };
+}
 
 // ../schema/src/secrets.ts
 function shannonEntropy(value) {
@@ -12385,6 +12538,11 @@ function linkPlace(doc, link2) {
 }
 function describeBrokenLink(doc, link2) {
   const where2 = linkPlace(doc, link2);
+  if (link2.kind === "anchor") {
+    const page = link2.anchor ? doc.pages[link2.anchor.page] : void 0;
+    if (!link2.anchor || !page) return `${where2} links to a section that no longer exists.`;
+    return `${where2} links to \u201C${link2.anchor.fragment}\u201D on ${titleOf(page)}, but no section there is called that.`;
+  }
   switch (link2.kind) {
     case "page":
       return `${where2} links to a page that no longer exists.`;
@@ -12426,10 +12584,73 @@ function linkFix(doc, link2, meta) {
   if (link2.scope.kind === "site" && link2.path[0] === "nav") {
     const { value, changes } = resolveInternalLinks(doc.site.nav, doc);
     if (!changes.length) return void 0;
-    return { label, ops: [{ op: "site.update", ...meta(), set: { nav: value } }] };
+    return { label, ops: [{ op: "nav.update", ...meta(), tree: value }] };
   }
   return void 0;
 }
+function sectionName(section) {
+  if (section.label) return section.label;
+  for (const b of section.blocks) {
+    const t = b.fields.text;
+    if (typeof t === "string" && t.trim()) return t.trim().slice(0, 60);
+  }
+  return "that";
+}
+function retargetOps(doc, link2, from, to, meta) {
+  const anchorPage = link2.anchor?.page;
+  if (!anchorPage) return void 0;
+  if (link2.block && link2.field) {
+    const container2 = link2.container === "footer" ? doc.site.footer : doc.pages[link2.container]?.sections.find((x) => x.id === link2.section);
+    const block4 = container2?.blocks.find((b) => b.id === link2.block);
+    if (!block4) return void 0;
+    const current2 = link2.container === "footer" ? void 0 : link2.container;
+    const r = retargetAnchor(block4.fields[link2.field], doc, anchorPage, from, to, current2);
+    if (!r.changed) return void 0;
+    return [
+      {
+        op: "block.update",
+        ...meta(),
+        page: link2.container,
+        block: block4.id,
+        set: { [link2.field]: r.value }
+      }
+    ];
+  }
+  if (link2.scope.kind === "site" && link2.path[0] === "nav") {
+    const r = retargetAnchor(doc.site.nav, doc, anchorPage, from, to);
+    if (!r.changed) return void 0;
+    return [{ op: "nav.update", ...meta(), tree: r.value }];
+  }
+  return void 0;
+}
+function anchorFix(doc, link2, meta) {
+  if (!link2.anchor) return void 0;
+  const { page: pageId, fragment } = link2.anchor;
+  const page = doc.pages[pageId];
+  if (!page) return void 0;
+  const section = suggestAnchorSection(doc, pageId, fragment);
+  if (!section) {
+    const ops2 = retargetOps(doc, link2, fragment, void 0, meta);
+    return ops2 ? { label: `Link to the top of ${titleOf(page)} instead`, ops: ops2 } : void 0;
+  }
+  const label = `Connect it to the \u201C${sectionName(section)}\u201D section`;
+  const taken = new Set(page.sections.map((s2) => s2.anchor).filter(Boolean));
+  if (!section.anchor && SlugSchema.safeParse(fragment).success && !taken.has(fragment))
+    return {
+      label,
+      ops: [
+        {
+          op: "section.update",
+          ...meta(),
+          page: pageId,
+          section: section.id,
+          set: { anchor: fragment }
+        }
+      ]
+    };
+  const ops = retargetOps(doc, link2, fragment, section.anchor ?? section.id, meta);
+  return ops ? { label, ops } : void 0;
+}
 function linkIssues(doc, pageId, options = {}, meta = opMeta(options)) {
   const out = [];
   for (const link2 of findBrokenLinks(doc)) {
@@ -12437,7 +12658,7 @@ function linkIssues(doc, pageId, options = {}, meta = opMeta(options)) {
     if (pageId && s2.kind === "page" && s2.page !== pageId) continue;
     if (pageId && s2.kind === "item") continue;
     const page = link2.container ?? (s2.kind === "page" ? s2.page : void 0);
-    const autofix = linkFix(doc, link2, meta);
+    const autofix = link2.kind === "anchor" ? anchorFix(doc, link2, meta) : linkFix(doc, link2, meta);
     out.push(
       issue({
         rule: "broken-link",
@@ -12447,7 +12668,7 @@ function linkIssues(doc, pageId, options = {}, meta = opMeta(options)) {
         ...link2.block ? { block: link2.block } : {},
         key: `${s2.kind === "item" ? `${s2.collection}/${s2.slug}:` : ""}${link2.path.join(".")}`,
         message: describeBrokenLink(doc, link2),
-        fix: link2.severity === "error" ? "Point the link at a page that exists, or add the missing page. The site can't be published until then." : "Point the link at a page that exists, or add the missing page.",
+        fix: link2.kind === "anchor" ? "Give the section that name (Section settings \u2192 Link name), or point the link at another section." : link2.severity === "error" ? "Point the link at a page that exists, or add the missing page. The site can't be published until then." : "Point the link at a page that exists, or add the missing page.",
         ...autofix ? { autofix } : {}
       })
     );
@@ -13264,8 +13485,8 @@ function phoneIssuesFromProbe(doc, pageId, results, options = {}) {
       const at = locate(doc, pageId, f);
       if (f.kind === "cta-below-fold" && at.section?.preset && !at.section.preset.startsWith("hero/"))
         continue;
-      const sectionName = at.section && at.page !== FOOTER ? " in this section" : at.page === FOOTER ? " in the footer" : "";
-      const where2 = f.component ? ` in the \u201C${f.component}\u201D component` : sectionName;
+      const sectionName2 = at.section && at.page !== FOOTER ? " in this section" : at.page === FOOTER ? " in the footer" : "";
+      const where2 = f.component ? ` in the \u201C${f.component}\u201D component` : sectionName2;
       const [message, fix] = MESSAGE[f.kind](f, where2);
       const key2 = `${f.kind}:${at.block?.id ?? f.block ?? ""}:${f.kind === "tap-target" || f.kind === "photo-contrast" ? f.text ?? "" : ""}`;
       const i = issue({
@@ -45432,6 +45653,7 @@ Design check flags (custom components too: invalid code, budgets, motion, fixed
 - Styles come from Site Styles tokens (palette, pairing, density, shape, buttons, motion, image treatment). Never write inline CSS; restyle with set_styles or apply_template_look.
 - Section color themes: light, light-accent, dark, dark-accent, brand. The contrast solver keeps text readable in all five.
 - Rich text is Markdown: headings (#\u2013####), **bold**, *italic*, [links](/contact), lists, > quotes; a trailing {.lead} sets a paragraph preset.
+- Menu entries and buttons that jump to a section (one-page sites: "How it works", "Prices", "Join"): give the section a link name (anchor: insert_section / insert_component, or update_section set {"anchor": "how-it-works"}), then link to it \u2014 menu entry {type:"page", page, label, anchor}, button or field link {type:"page", page, anchor}. The same entries serve the desktop menu and the phone menu. design_check warns about links to a section name nothing has.
 - Edits land in the draft. The owner publishes \u2014 call publish only when they ask, with confirm: true.
 `;
 var ITERATION_GUIDANCE = `# Design iteration loop
@@ -46025,9 +46247,807 @@ var positionArg = external_exports.union([
   external_exports.strictObject({ before: external_exports.string() }),
   external_exports.strictObject({ after: external_exports.string() })
 ]).describe('Where: an index, "start", "end", {"before": id} or {"after": id}.');
+var anchorArg = external_exports.string().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, "Use lowercase words joined by hyphens, like how-it-works.").max(60).describe(
+  `The section's link name, so menu entries and buttons can jump to it: lowercase words with hyphens, e.g. "how-it-works". Link to it with {type:"page", page, anchor}.`
+);
 var confirmArg = external_exports.boolean().optional().describe("Must be true. Ask the owner first: this cannot be undone from here.");
 var deviceArg = external_exports.enum(["desktop", "tablet", "mobile"]);
 
+// ../mcp-tools/src/tools/read.ts
+var listSites = defineTool({
+  name: "list_sites",
+  title: "List sites",
+  description: "Sites this connection can edit, with their titles and live addresses. Start here when you don't know the site id.",
+  input: external_exports.object({}),
+  annotations: { readOnlyHint: true },
+  async handler(ctx) {
+    const allowed = new Set(await ctx.allowedSites());
+    const sites = (await ctx.store.listSites()).filter((s2) => allowed.has(s2.id));
+    return { data: { sites, canPublish: ctx.grant.publish && ctx.store.capabilities.canPublish } };
+  }
+});
+function stylesSummary(doc) {
+  const compiled2 = compileStyles(doc.styles);
+  const pairing = getPairing(doc.styles.choices.pairing);
+  return {
+    choices: doc.styles.choices,
+    pairing: pairing ? { id: pairing.id, heading: pairing.heading.family, body: pairing.body.family } : { id: doc.styles.choices.pairing, unknown: true },
+    overrides: doc.styles.overrides ?? null,
+    brand: compiled2.tokens.palette.brand,
+    themes: Object.fromEntries(
+      Object.entries(compiled2.tokens.themes).map(([theme, c]) => [
+        theme,
+        {
+          background: c.background,
+          text: c.text,
+          heading: c.heading,
+          accent: c.accent,
+          "accent-text": c["accent-text"]
+        }
+      ])
+    ),
+    contrast: {
+      mode: compiled2.contrast.mode,
+      adjustedBySolver: compiled2.contrast.adjustments.length,
+      failures: compiled2.contrast.failures.length
+    }
+  };
+}
+function pageSummary(page) {
+  return {
+    id: page.id,
+    title: page.title,
+    slug: page.slug,
+    path: pagePathOf(page),
+    sections: page.sections.length,
+    hidden: page.hidden ?? false
+  };
+}
+var getSite = defineTool({
+  name: "get_site",
+  title: "Get site",
+  description: "Site settings, navigation, header/footer, Site Styles summary, page list and collections. Call before editing to learn page ids and the current look.",
+  input: external_exports.object({ site: siteArg }),
+  annotations: { readOnlyHint: true },
+  async handler(ctx, input) {
+    const siteId = await ctx.siteId(input.site);
+    const doc = await ctx.doc(siteId);
+    const { site: site2 } = doc;
+    return {
+      data: {
+        id: siteId,
+        title: site2.title,
+        tagline: site2.tagline ?? null,
+        template: doc.config.template ?? null,
+        url: doc.config.deploy.customDomain ? `https://${doc.config.deploy.customDomain}` : doc.config.deploy.url,
+        nav: site2.nav,
+        header: site2.header,
+        footer: {
+          sectionId: site2.footer.id,
+          layout: site2.footer.layout.mode,
+          blocks: site2.footer.blocks.map((b) => ({ id: b.id, type: b.type })),
+          note: 'Edit footer blocks with the block tools using page "footer".'
+        },
+        announcement: site2.announcement ?? null,
+        social: site2.social ?? [],
+        seo: site2.seo ?? null,
+        styles: stylesSummary(doc),
+        pages: Object.values(doc.pages).map(pageSummary),
+        collections: Object.entries(doc.collections).map(([name, items]) => ({
+          name,
+          kind: Object.values(items)[0]?.kind ?? doc.collectionConfigs?.[name]?.kind ?? null,
+          items: Object.keys(items).length
+        })),
+        media: Object.keys(doc.media).length,
+        capabilities: {
+          ...ctx.store.capabilities,
+          // Same answer as list_sites: publishing needs both the store and this connection.
+          canPublish: ctx.grant.publish && ctx.store.capabilities.canPublish,
+          grantPublish: ctx.grant.publish
+        }
+      }
+    };
+  }
+});
+function sectionView(ctx, section, detail, doc) {
+  const registry3 = doc ? ctx.registryFor(doc) : ctx.registry;
+  const blocks2 = section.blocks.map((b) => {
+    if (detail === "outline") {
+      const out = {
+        id: b.id,
+        type: b.type,
+        text: blockPreview(registry3, b)
+      };
+      if (b.variant) out.variant = b.variant;
+      if (b.column !== void 0) out.column = b.column;
+      if (b.hidden) out.hidden = true;
+      return out;
+    }
+    return blockToAgent(registry3, b);
+  });
+  const base = {
+    id: section.id,
+    ...section.preset ? { preset: section.preset } : {},
+    ...section.label ? { label: section.label } : {},
+    ...section.hidden ? { hidden: true } : {},
+    ...section.locked ? { locked: true } : {},
+    theme: section.style?.colorTheme ?? "light"
+  };
+  if (detail === "outline") {
+    base.layout = section.layout.mode === "grid" ? "grid" : `stack ${JSON.stringify(section.layout.columns.d)}`;
+    base.blocks = blocks2;
+    return base;
+  }
+  return {
+    ...base,
+    layout: section.layout,
+    style: section.style ?? {},
+    ...section.anchor ? { anchor: section.anchor } : {},
+    blocks: blocks2
+  };
+}
+var getPage2 = defineTool({
+  name: "get_page",
+  title: "Get page",
+  description: `A page's section/block tree with stable ids, fields (rich text as Markdown), layout and style. Use detail "outline" for a compact overview (ids, types, text previews) and "full" before editing fields or grid placements. page "footer" returns the site footer section.`,
+  input: external_exports.object({
+    site: siteArg,
+    page: containerArg,
+    detail: external_exports.enum(["full", "outline"]).optional().describe('Default "full".')
+  }),
+  annotations: { readOnlyHint: true },
+  async handler(ctx, input) {
+    const siteId = await ctx.siteId(input.site);
+    const doc = await ctx.doc(siteId);
+    const detail = input.detail ?? "full";
+    const { id, page } = resolvePage(doc, input.page, { allowFooter: true });
+    if (id === FOOTER || !page)
+      return { data: { page: FOOTER, sections: [sectionView(ctx, doc.site.footer, detail, doc)] } };
+    return {
+      data: {
+        id: page.id,
+        title: page.title,
+        slug: page.slug,
+        path: pagePathOf(page),
+        seo: page.seo ?? {},
+        ...page.header ? { header: page.header } : {},
+        ...page.hidden ? { hidden: true } : {},
+        sections: page.sections.map((s2) => sectionView(ctx, s2, detail, doc))
+      }
+    };
+  }
+});
+function blockMetaView(m, full) {
+  const fields = Object.fromEntries(
+    Object.entries(m.fields).map(([k, f]) => {
+      const v = {
+        kind: f.kind === "richText" ? "richText (Markdown)" : f.kind
+      };
+      if (f.optional) v.optional = true;
+      if (f.label) v.label = f.label;
+      if (full && f.help) v.help = f.help;
+      if (f.ai) v.ai = f.ai;
+      if (f.kind === "select") v.options = f.options.map((o) => o.value);
+      if (f.kind === "text" && f.maxLength) v.maxLength = f.maxLength;
+      if (f.kind === "list")
+        v.itemFields = Object.fromEntries(
+          Object.entries(f.fields).map(([ik, iv]) => [
+            ik,
+            iv.kind === "richText" ? "richText (Markdown)" : iv.kind
+          ])
+        );
+      if (f.kind === "image") v.shape = "{ src, alt, focal? }";
+      if (f.kind === "link") v.allow = f.allow;
+      return [k, v];
+    })
+  );
+  return {
+    type: m.type,
+    label: m.label,
+    category: m.category,
+    description: m.description,
+    variants: m.variants,
+    styleSlots: m.styleSlots,
+    fields,
+    ai: m.ai
+  };
+}
+var listBlocks = defineTool({
+  name: "list_blocks",
+  title: "List blocks",
+  description: "The block catalog: each block's fields (rich text as Markdown), variants, style slots and AI guidance (purpose, whenToUse, avoid). Filter by category or type. Prefer section presets for whole sections; use blocks to add or adjust pieces.",
+  input: external_exports.object({
+    category: external_exports.string().optional(),
+    type: external_exports.string().optional().describe("One block type for full detail.")
+  }),
+  annotations: { readOnlyHint: true },
+  async handler(ctx, input) {
+    let metas = ctx.registry.meta();
+    if (input.type) {
+      metas = metas.filter((m) => m.type === input.type);
+      if (!metas.length)
+        throw new ToolError(
+          `Unknown block type "${input.type}". Types: ${ctx.registry.types().join(", ")}.`,
+          "not_found"
+        );
+    }
+    if (input.category) metas = metas.filter((m) => m.category === input.category);
+    return {
+      data: {
+        blocks: metas.map((m) => blockMetaView(m, Boolean(input.type))),
+        categories: [...new Set(ctx.registry.meta().map((m) => m.category))]
+      }
+    };
+  }
+});
+var getBlockSchema = defineTool({
+  name: "get_block_schema",
+  title: "Get block schema",
+  description: "JSON Schema for one block type's fields (with labels and AI hints). Rich-text fields are shown as ProseMirror JSON but the edit tools also accept a Markdown string for them.",
+  input: external_exports.object({ type: external_exports.string() }),
+  annotations: { readOnlyHint: true },
+  async handler(ctx, input) {
+    const def = ctx.registry.get(input.type);
+    if (!def)
+      throw new ToolError(
+        `Unknown block type "${input.type}". Types: ${ctx.registry.types().join(", ")}.`,
+        "not_found"
+      );
+    return {
+      data: {
+        type: def.type,
+        version: def.version,
+        variants: def.meta.variants,
+        styleSlots: def.meta.styleSlots,
+        fields: blockFieldsJsonSchema(def)
+      }
+    };
+  }
+});
+var listSectionPresets = defineTool({
+  name: "list_section_presets",
+  title: "List section presets",
+  description: "Designed section presets by category (hero, about, services, gallery, testimonials, pricing, faq, team, stats, cta, contact, newsletter, blog, events, products, footer, header) with descriptions, layout, designed-for color themes, copy-length ranges and AI guidance. Compose pages from these with insert_section/create_page.",
+  input: external_exports.object({
+    category: external_exports.enum(PRESET_CATEGORIES).optional(),
+    query: external_exports.string().optional().describe("Words to match in label, description or tags."),
+    detail: external_exports.enum(["brief", "full"]).optional().describe('Default "brief".')
+  }),
+  annotations: { readOnlyHint: true },
+  async handler(_ctx, input) {
+    let list5 = presetCatalog.slice();
+    if (input.category) list5 = list5.filter((p) => p.category === input.category);
+    if (input.query) {
+      const words4 = input.query.toLowerCase().split(/\s+/).filter(Boolean);
+      list5 = list5.filter((p) => {
+        const hay = `${p.id} ${p.label} ${p.description} ${p.tags.join(" ")} ${p.ai.whenToUse}`.toLowerCase();
+        return words4.every((w) => hay.includes(w));
+      });
+    }
+    const full = input.detail === "full";
+    return {
+      data: {
+        presets: list5.map(
+          (p) => full ? p : {
+            id: p.id,
+            label: p.label,
+            description: p.description,
+            target: p.target,
+            layout: p.layout,
+            overlap: p.overlap,
+            themes: p.themes,
+            whenToUse: p.ai.whenToUse
+          }
+        ),
+        categories: PRESET_CATEGORIES
+      }
+    };
+  }
+});
+function findPreset(id) {
+  const exact = getPreset(id);
+  if (exact) return exact;
+  const base = id.replace(/@\d+$/, "");
+  const matches = presetCatalog.filter((p) => p.id.startsWith(`${base}@`)).sort((a, b) => b.version - a.version);
+  const best = matches[0] && getPreset(matches[0].id);
+  if (best) return best;
+  const category = base.split("/")[0] ?? "";
+  const near = presetCatalog.filter((p) => p.category === category).map((p) => p.id);
+  throw new ToolError(
+    `Unknown preset "${id}".${near.length ? ` In ${category}: ${near.join(", ")}.` : " Call list_section_presets."}`,
+    "not_found"
+  );
+}
+
+// ../mcp-tools/src/tools/edit.ts
+var isRecord2 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var themeArg = external_exports.enum(COLOR_THEMES).describe("Section color theme.");
+var blockSummary = (registry3, b) => ({
+  id: b.id,
+  type: b.type,
+  ...b.variant ? { variant: b.variant } : {},
+  ...b.column !== void 0 ? { column: b.column } : {},
+  text: blockPreview(registry3, b)
+});
+function sectionSummary(registry3, s2) {
+  return {
+    id: s2.id,
+    ...s2.preset ? { preset: s2.preset } : {},
+    theme: s2.style?.colorTheme ?? "light",
+    layout: s2.layout.mode,
+    blocks: s2.blocks.map((b) => blockSummary(registry3, b))
+  };
+}
+function container(doc, ref) {
+  return resolvePage(doc, ref, { allowFooter: true }).id;
+}
+function pageOnly(doc, ref) {
+  if (ref === FOOTER)
+    throw new ToolError(
+      "Sections can't be inserted, moved or deleted in the footer; replace it with a footer preset (insert_section with a footer/\u2026 preset) or edit its blocks.",
+      "invalid_arguments"
+    );
+  return resolvePage(doc, ref).id;
+}
+function requireSection2(doc, page, section) {
+  const loc = findSection(doc, page, section);
+  if (!loc) {
+    const ids = page === FOOTER ? [doc.site.footer.id] : doc.pages[page]?.sections.map(
+      (s2) => s2.id
+    ) ?? [];
+    throw new ToolError(
+      `No section ${section} on ${page}. Sections there: ${ids.join(", ") || "none"}.`,
+      "not_found"
+    );
+  }
+  return loc.section;
+}
+function requireBlock(doc, page, block4) {
+  const loc = findBlock(doc, page, block4);
+  if (loc) return { block: loc.block, section: loc.section };
+  const elsewhere = locateBlock(doc, block4);
+  throw new ToolError(
+    elsewhere ? `Block ${block4} is on ${elsewhere.container}, not ${page}.` : `No block ${block4}. Call get_page to see block ids.`,
+    "not_found"
+  );
+}
+function makeBlock2(registry3, input) {
+  const def = registry3.get(input.type);
+  if (!def)
+    throw new ToolError(
+      `Unknown block type "${input.type}". Types: ${registry3.types().join(", ")}.`,
+      "invalid_arguments"
+    );
+  const fields = {};
+  for (const [k, m] of Object.entries(def.meta.fields))
+    if (!m.optional && m.default !== void 0) fields[k] = structuredClone(m.default);
+  Object.assign(fields, fieldsFromAgent(registry3, input.type, input.fields ?? {}));
+  const { type, fields: _f, id, v: _v, ...rest } = input;
+  return {
+    ...rest,
+    id: id ?? newId("blk"),
+    type,
+    v: def.version,
+    fields
+  };
+}
+function makeSection(registry3, raw2) {
+  const blocks2 = Array.isArray(raw2.blocks) ? raw2.blocks : [];
+  return {
+    ...raw2,
+    id: typeof raw2.id === "string" ? raw2.id : newId("sec"),
+    layout: raw2.layout ?? { mode: "stack", columns: { d: [12] } },
+    style: isRecord2(raw2.style) ? raw2.style : { colorTheme: "light" },
+    blocks: blocks2.map((b, i) => {
+      if (!isRecord2(b) || typeof b.type !== "string")
+        throw new ToolError(`section.blocks[${i}] needs a "type".`, "invalid_arguments");
+      return makeBlock2(registry3, b);
+    })
+  };
+}
+function takenAnchor(doc, page, anchor) {
+  const other = doc.pages[page]?.sections.find(
+    (s2) => s2.anchor === anchor
+  );
+  if (other)
+    throw new ToolError(
+      `Another section on this page is already called \u201C${anchor}\u201D (${other.id}).`,
+      "invalid_arguments",
+      [],
+      "Pick another anchor, or link to that section."
+    );
+  return anchor;
+}
+var insertSection = defineTool({
+  name: "insert_section",
+  title: "Insert section",
+  description: "Add a section to a page from a preset id (preferred \u2014 see list_section_presets) or an explicit section. Preset sections arrive with designed demo copy: replace it with the owner's real content using update_block. Header presets restyle the site header and footer presets replace the site footer (page is ignored for those). Returns the new section and block ids.",
+  input: external_exports.object({
+    site: siteArg,
+    page: external_exports.string().optional().describe("Page id/slug/title (not needed for header/footer presets)."),
+    preset: external_exports.string().optional().describe('Preset id, e.g. "hero/split-image@1" (version optional).'),
+    section: external_exports.looseObject({}).optional().describe(
+      "Explicit section ({layout, style, blocks:[{type, fields, variant?, column?}]}); ids are generated when omitted; rich text as Markdown."
+    ),
+    at: positionArg.optional(),
+    colorTheme: themeArg.optional(),
+    primaryLink: external_exports.unknown().optional().describe(
+      "Link for the main call to action ({type:'page', page:'pg_\u2026'} or {type:'url', url})."
+    ),
+    secondaryLink: external_exports.unknown().optional(),
+    collection: external_exports.string().optional().describe("Collection for summary/events/product presets."),
+    label: external_exports.string().max(80).optional().describe("Layers label for the section."),
+    anchor: anchorArg.optional()
+  }),
+  annotations: {},
+  async handler(ctx, input) {
+    const siteId = await ctx.siteId(input.site);
+    const doc = await ctx.doc(siteId);
+    if (!!input.preset === !!input.section)
+      throw new ToolError("Give exactly one of preset or section.", "invalid_arguments");
+    const links = {};
+    for (const k of ["primaryLink", "secondaryLink"]) {
+      if (input[k] === void 0) continue;
+      const r = LinkSchema.safeParse(input[k]);
+      if (!r.success)
+        throw new ToolError(
+          `${k} is not a valid link: ${r.error.issues.map((i) => i.message).join("; ")}`,
+          "invalid_arguments"
+        );
+      links[k] = r.data;
+    }
+    if (input.preset) {
+      const preset = findPreset(input.preset);
+      const opts = { colorTheme: input.colorTheme, collection: input.collection, ...links };
+      const linkNote = (changes2) => changes2.length ? {
+        linksChanged: changes2.map((c) => ({ from: c.from, to: c.to })),
+        linkNote: "Example links that lead nowhere on this site were pointed at existing pages; change them with update_block."
+      } : {};
+      if (preset.target === "header") {
+        const { value: header, changes: changes2 } = resolveInternalLinks(preset.build(opts), doc);
+        await ctx.apply(siteId, [{ op: "site.update", set: { header } }]);
+        return {
+          data: {
+            applied: preset.id,
+            header,
+            note: "The site header now uses this preset.",
+            ...linkNote(changes2)
+          }
+        };
+      }
+      const { value: section2, changes } = resolveInternalLinks(preset.build(opts), doc);
+      if (input.label) section2.label = input.label;
+      if (input.anchor && preset.target !== "footer" && input.page)
+        section2.anchor = takenAnchor(doc, pageOnly(doc, input.page), input.anchor);
+      if (preset.target === "footer") {
+        await ctx.apply(siteId, [{ op: "site.update", set: { footer: section2 } }]);
+        return {
+          data: {
+            replaced: "footer",
+            section: sectionSummary(ctx.registry, section2),
+            note: 'Edit footer blocks with page "footer".',
+            ...linkNote(changes)
+          }
+        };
+      }
+      if (!input.page)
+        throw new ToolError("page is required for page sections.", "invalid_arguments");
+      const page2 = pageOnly(doc, input.page);
+      await ctx.apply(siteId, [
+        { op: "section.insert", page: page2, at: input.at ?? "end", section: section2 }
+      ]);
+      return {
+        data: {
+          page: page2,
+          section: sectionSummary(ctx.registry, section2),
+          copyGuidance: preset.copy.map((c) => `${c.label}: ${c.words[0]}\u2013${c.words[1]} words`),
+          next: "Replace the demo copy with the owner's content (update_block), then run design_check.",
+          ...linkNote(changes)
+        }
+      };
+    }
+    if (!input.page) throw new ToolError("page is required.", "invalid_arguments");
+    const page = pageOnly(doc, input.page);
+    const section = makeSection(ctx.registry, input.section);
+    if (input.colorTheme)
+      section.style = { ...section.style ?? {}, colorTheme: input.colorTheme };
+    if (input.label) section.label = input.label;
+    if (input.anchor) section.anchor = takenAnchor(doc, page, input.anchor);
+    await ctx.apply(siteId, [
+      { op: "section.insert", page, at: input.at ?? "end", section }
+    ]);
+    return { data: { page, section: sectionSummary(ctx.registry, section) } };
+  }
+});
+var updateSection = defineTool({
+  name: "update_section",
+  title: "Update section",
+  description: `Change a section's settings with dot-path patches, e.g. set {"style.colorTheme": "dark", "style.padding": {"d": "xl", "m": "lg"}, "label": "Intro", "anchor": "classes", "hidden": true, "layout": {...}}. Shortcuts: colorTheme. Blocks are edited with the block tools.`,
+  input: external_exports.object({
+    site: siteArg,
+    page: containerArg,
+    section: external_exports.string(),
+    set: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
+    unset: external_exports.array(external_exports.string()).optional(),
+    colorTheme: themeArg.optional()
+  }),
+  annotations: { idempotentHint: true },
+  async handler(ctx, input) {
+    const siteId = await ctx.siteId(input.site);
+    const doc = await ctx.doc(siteId);
+    const page = container(doc, input.page);
+    requireSection2(doc, page, input.section);
+    const set2 = { ...input.set ?? {} };
+    if (input.colorTheme) set2["style.colorTheme"] = input.colorTheme;
+    const body = { op: "section.update", page, section: input.section };
+    if (Object.keys(set2).length) body.set = set2;
+    if (input.unset?.length) body.unset = input.unset;
+    const { doc: next } = await ctx.apply(siteId, [body]);
+    return {
+      data: { section: sectionSummary(ctx.registry, requireSection2(next, page, input.section)) }
+    };
+  }
+});
+var moveSection = defineTool({
+  name: "move_section",
+  title: "Move section",
+  description: "Reorder a section within its page.",
+  input: external_exports.object({ site: siteArg, page: external_exports.string(), section: external_exports.string(), at: positionArg }),
+  annotations: { idempotentHint: true },
+  async handler(ctx, input) {
+    const siteId = await ctx.siteId(input.site);
+    const doc = await ctx.doc(siteId);
+    const page = pageOnly(doc, input.page);
+    requireSection2(doc, page, input.section);
+    const { doc: next } = await ctx.apply(siteId, [
+      { op: "section.move", page, section: input.section, at: input.at }
+    ]);
+    return { data: { order: next.pages[page]?.sections.map((s2) => s2.id) } };
+  }
+});
+var deleteSection = defineTool({
+  name: "delete_section",
+  title: "Delete section",
+  description: "Remove a section and its blocks from a page (recoverable from the session snapshot or discard_draft).",
+  input: external_exports.object({ site: siteArg, page: external_exports.string(), section: external_exports.string() }),
+  annotations: { destructiveHint: true },
+  async handler(ctx, input) {
+    const siteId = await ctx.siteId(input.site);
+    const doc = await ctx.doc(siteId);
+    const page = pageOnly(doc, input.page);
+    requireSection2(doc, page, input.section);
+    await ctx.apply(siteId, [{ op: "section.delete", page, section: input.section }]);
+    return { data: { deleted: input.section } };
+  }
+});
+var gridItemArg = external_exports.looseObject({}).describe(
+  "Grid placement {d:{x,y,w,h,z?,bleed?}, t?, m?}: 24 columns on desktop/tablet, 8 on mobile, 1-based."
+);
+var insertBlock = defineTool({
+  name: "insert_block",
+  title: "Insert block",
+  description: "Add a block to a section. Fields are validated against the block type (see list_blocks); rich text as Markdown. In stack sections pick a column (0-based); in grid sections give place (auto-placed at the bottom otherwise) and then check the mobile layout (auto_mobile_layout).",
+  input: external_exports.object({
+    site: siteArg,
+    page: containerArg,
+    section: external_exports.string(),
+    block: external_exports.looseObject({
+      type: external_exports.string(),
+      fields: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
+      variant: external_exports.string().optional(),
+      style: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
+      column: external_exports.int().min(0).max(3).optional(),
+      label: external_exports.string().optional()
+    }).describe("{type, fields, variant?, style?, column?, label?}"),
+    at: positionArg.optional(),
+    place: gridItemArg.optional()
+  }),
+  annotations: {},
+  async handler(ctx, input) {
+    const siteId = await ctx.siteId(input.site);
+    const doc = await ctx.doc(siteId);
+    const page = container(doc, input.page);
+    requireSection2(doc, page, input.section);
+    const made = makeBlock2(ctx.registryFor(doc), input.block);
+    const block4 = resolveInternalLinks(made, doc).value;
+    for (const k of Object.keys(input.block.fields ?? {}))
+      if (k in made.fields) block4.fields[k] = made.fields[k];
+    const body = {
+      op: "block.insert",
+      page,
+      section: input.section,
+      at: input.at ?? "end",
+      block: block4
+    };
+    if (input.place) body.place = input.place;
+    const { doc: next, warnings } = await ctx.apply(siteId, [body]);
+    const placed = findBlock(next, page, block4.id);
+    return {
+      data: {
+        block: blockSummary(ctx.registryFor(next), placed?.block ?? block4),
+        ...warnings.length ? { warnings } : {}
+      }
+    };
+  }
+});
+var updateBlock = defineTool({
+  name: "update_block",
+  title: "Update block",
+  description: "Edit a block: set replaces whole top-level fields (rich text as Markdown; lists are replaced whole), unset removes optional fields; variant/style/column/label/hidden adjust presentation (null removes). Ids are preserved.",
+  input: external_exports.object({
+    site: siteArg,
+    page: containerArg,
+    block: external_exports.string(),
+    set: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
+    unset: external_exports.array(external_exports.string()).optional(),
+    variant: external_exports.string().nullable().optional(),
+    style: external_exports.record(external_exports.string(), external_exports.unknown()).nullable().optional(),
+    column: external_exports.int().min(0).max(3).nullable().optional(),
+    label: external_exports.string().max(80).nullable().optional(),
+    hidden: external_exports.boolean().nullable().optional()
+  }),
+  annotations: { idempotentHint: true },
+  async handler(ctx, input) {
+    const siteId = await ctx.siteId(input.site);
+    const doc = await ctx.doc(siteId);
+    const page = container(doc, input.page);
+    const { block: block4 } = requireBlock(doc, page, input.block);
+    const body = { op: "block.update", page, block: input.block };
+    if (input.set) body.set = fieldsFromAgent(ctx.registryFor(doc), block4.type, input.set);
+    if (input.unset?.length) body.unset = input.unset;
+    for (const k of ["variant", "style", "column", "label", "hidden"])
+      if (input[k] !== void 0) body[k] = input[k];
+    if (Object.keys(body).length === 3)
+      throw new ToolError(
+        "Nothing to change: give set, unset, variant, style, column, label or hidden.",
+        "invalid_arguments"
+      );
+    const { doc: next } = await ctx.apply(siteId, [body]);
+    const updated = findBlock(next, page, input.block)?.block ?? block4;
+    return { data: { block: blockSummary(ctx.registryFor(next), updated) } };
+  }
+});
+var moveBlock = defineTool({
+  name: "move_block",
+  title: "Move block",
+  description: "Move a block within its page (to another section and/or position). Give column for stack sections and place for grid sections.",
+  input: external_exports.object({
+    site: siteArg,
+    page: containerArg,
+    block: external_exports.string(),
+    to: external_exports.object({
+      section: external_exports.string(),
+      at: positionArg.optional(),
+      column: external_exports.int().min(0).max(3).nullable().optional(),
+      place: gridItemArg.optional()
+    })
+  }),
+  annotations: { idempotentHint: true },
+  async handler(ctx, input) {
+    const siteId = await ctx.siteId(input.site);
+    const doc = await ctx.doc(siteId);
+    const page = container(doc, input.page);
+    requireBlock(doc, page, input.block);
+    requireSection2(doc, page, input.to.section);
+    const to = { section: input.to.section, at: input.to.at ?? "end" };
+    if (input.to.column !== void 0) to.column = input.to.column;
+    if (input.to.place) to.place = input.to.place;
+    await ctx.apply(siteId, [{ op: "block.move", page, block: input.block, to }]);
+    return { data: { moved: input.block, to } };
+  }
+});
+var deleteBlock = defineTool({
+  name: "delete_block",
+  title: "Delete block",
+  description: "Remove a block from its section (recoverable via the session snapshot or discard_draft).",
+  input: external_exports.object({ site: siteArg, page: containerArg, block: external_exports.string() }),
+  annotations: { destructiveHint: true },
+  async handler(ctx, input) {
+    const siteId = await ctx.siteId(input.site);
+    const doc = await ctx.doc(siteId);
+    const page = container(doc, input.page);
+    requireBlock(doc, page, input.block);
+    await ctx.apply(siteId, [{ op: "block.delete", page, block: input.block }]);
+    return { data: { deleted: input.block } };
+  }
+});
+var rectArg = external_exports.looseObject({}).describe(
+  "{x, y, w, h, z?, bleed?: 'left'|'right'|'both'} (1-based; 24 columns desktop/tablet, 8 mobile)"
+);
+var placeInGrid2 = defineTool({
+  name: "place_in_grid",
+  title: "Place in grid",
+  description: "Set a block's grid placement per breakpoint in a grid section. d = desktop (required on first placement), t = tablet override (null removes), m = mobile (null removes; regenerate with auto_mobile_layout). Rows grow automatically. Overlap is allowed (use z) but text must not overlap text.",
+  input: external_exports.object({
+    site: siteArg,
+    page: containerArg,
+    section: external_exports.string(),
+    block: external_exports.string(),
+    d: rectArg.optional(),
+    t: rectArg.nullable().optional(),
+    m: rectArg.nullable().optional()
+  }),
+  annotations: { idempotentHint: true },
+  async handler(ctx, input) {
+    const siteId = await ctx.siteId(input.site);
+    const doc = await ctx.doc(siteId);
+    const page = container(doc, input.page);
+    const section = requireSection2(doc, page, input.section);
+    if (section.layout.mode !== "grid")
+      throw new ToolError(
+        `Section ${section.id} is a stack section; set the block's column with update_block instead.`,
+        "invalid_arguments"
+      );
+    const bodies = [];
+    for (const bp of ["d", "t", "m"]) {
+      const rect = input[bp];
+      if (rect === void 0) continue;
+      bodies.push({
+        op: "grid.place",
+        page,
+        section: section.id,
+        block: input.block,
+        bp,
+        rect
+      });
+    }
+    if (!bodies.length) throw new ToolError("Give at least one of d, t or m.", "invalid_arguments");
+    const { doc: next } = await ctx.apply(siteId, bodies);
+    const after = requireSection2(next, page, section.id);
+    return {
+      data: {
+        placement: after.layout.mode === "grid" ? after.layout.items[input.block] : null,
+        rows: after.layout.mode === "grid" ? after.layout.rows : null,
+        next: input.d && input.m === void 0 ? "Desktop changed: review mobile (auto_mobile_layout or screenshot device mobile)." : void 0
+      }
+    };
+  }
+});
+var autoMobileLayout2 = defineTool({
+  name: "auto_mobile_layout",
+  title: "Auto mobile layout",
+  description: "Generate mobile grid placements for a grid section by visual reading order (top-to-bottom, left-to-right on the desktop grid, layered items kept on their host). Keeps existing mobile placements unless reset is true.",
+  input: external_exports.object({
+    site: siteArg,
+    page: containerArg,
+    section: external_exports.string(),
+    reset: external_exports.boolean().optional()
+  }),
+  annotations: { idempotentHint: true },
+  async handler(ctx, input) {
+    const siteId = await ctx.siteId(input.site);
+    const doc = await ctx.doc(siteId);
+    const page = container(doc, input.page);
+    const section = requireSection2(doc, page, input.section);
+    if (section.layout.mode !== "grid")
+      return { data: { changed: 0, note: "Stack sections stack automatically on mobile." } };
+    const ops = autoMobileLayoutOps(doc, page, section.id, { reset: input.reset });
+    if (!ops.length)
+      return { data: { changed: 0, note: "Mobile placements are already complete." } };
+    const bodies = ops.map(({ id: _i, actor: _a3, ts: _t, ...b }) => b);
+    const { doc: next } = await ctx.apply(siteId, bodies);
+    const after = requireSection2(next, page, section.id);
+    return {
+      data: {
+        changed: ops.length,
+        mobile: after.layout.mode === "grid" ? Object.fromEntries(Object.entries(after.layout.items).map(([id, it]) => [id, it.m])) : null
+      }
+    };
+  }
+});
+var editTools = [
+  insertSection,
+  updateSection,
+  moveSection,
+  deleteSection,
+  insertBlock,
+  updateBlock,
+  moveBlock,
+  deleteBlock,
+  placeInGrid2,
+  autoMobileLayout2
+];
+
 // ../mcp-tools/src/tools/components.ts
 var nameArg = external_exports.string().describe('Component name, lowercase-hyphenated (e.g. "editorial-hero").');
 var GUIDE = "Prefer section presets. Use a component for a bespoke moment presets can't express. Always expose every word, image and link as a field (owners edit fields, never code), always style with theme tokens (var(--os-color-\u2026), var(--os-font-\u2026), var(--os-space-\u2026)), use the 767/768/1199/1200 breakpoints and honour reduced motion.";
@@ -46330,13 +47350,14 @@ ${notes.join("\n")}` : ""}`,
 var insertComponent = defineTool({
   name: "insert_component",
   title: "Insert component",
-  description: "Add a section using a custom component to a page (a site component, or a Designer components library name \u2014 it is added to the site first). fields override the sample content (rich text as Markdown); replace sample copy and photos with the owner's real content. Returns the section and block ids (edit later with update_block).",
+  description: "Add a section using a custom component to a page (a site component, or a Designer components library name \u2014 it is added to the site first). fields override the sample content (rich text as Markdown); replace sample copy and photos with the owner's real content. Give it an anchor when the menu or a button should jump to it. Returns the section and block ids (edit later with update_block).",
   input: external_exports.object({
     site: siteArg,
     page: external_exports.string().describe("Page id/slug/title."),
     name: nameArg,
     fields: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
     theme: external_exports.enum(COLOR_THEMES).optional(),
+    anchor: anchorArg.optional(),
     at: positionArg.optional()
   }),
   annotations: {},
@@ -46361,6 +47382,7 @@ var insertComponent = defineTool({
     ).value;
     const block4 = section.blocks[0];
     block4.fields = { ...block4.fields, ...given };
+    if (input.anchor) section.anchor = takenAnchor(doc, page, input.anchor);
     bodies.push({ op: "section.insert", page, at: input.at ?? "end", section });
     const { doc: next } = await ctx.apply(siteId, bodies);
     const target = next.pages[page];
@@ -46691,17 +47713,17 @@ function builtInTemplates() {
     };
   });
 }
-var isRecord2 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var isRecord3 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 function normaliseTemplate(raw2) {
-  if (!isRecord2(raw2)) return null;
-  const meta = isRecord2(raw2.template) ? { ...raw2, ...raw2.template } : raw2;
+  if (!isRecord3(raw2)) return null;
+  const meta = isRecord3(raw2.template) ? { ...raw2, ...raw2.template } : raw2;
   const id = typeof meta.id === "string" ? meta.id : null;
   if (!id) return null;
   const rawLooks = Array.isArray(meta.looks) ? meta.looks : [];
   const looks = [];
   rawLooks.forEach((l, i) => {
-    if (!isRecord2(l)) return;
-    const candidate = isRecord2(l.choices) ? l.choices : isRecord2(l.styles) && isRecord2(l.styles.choices) ? l.styles.choices : l;
+    if (!isRecord3(l)) return;
+    const candidate = isRecord3(l.choices) ? l.choices : isRecord3(l.styles) && isRecord3(l.styles.choices) ? l.styles.choices : l;
     const parsed = StyleChoicesSchema.safeParse(candidate);
     if (!parsed.success) return;
     const name = typeof l.name === "string" ? l.name : `Look ${i + 1}`;
@@ -46727,12 +47749,12 @@ async function templatesFromModule(mod) {
   let raws = null;
   const cat = mod.templateCatalog;
   if (Array.isArray(cat)) raws = cat;
-  else if (isRecord2(cat) && typeof cat.list === "function")
+  else if (isRecord3(cat) && typeof cat.list === "function")
     raws = await cat.list();
   else if (typeof mod.listTemplates === "function")
     raws = await mod.listTemplates();
   else if (Array.isArray(mod.templates)) raws = mod.templates;
-  else if (isRecord2(mod.templates)) raws = Object.values(mod.templates);
+  else if (isRecord3(mod.templates)) raws = Object.values(mod.templates);
   else if (typeof mod.loadTemplate === "function") {
     const ids = mod.TEMPLATE_IDS ?? mod.templateIds;
     if (Array.isArray(ids))
@@ -46757,312 +47779,6 @@ async function loadTemplates(store, importer = (spec) => import(
   return { source: "built-in", templates: builtInTemplates() };
 }
 
-// ../mcp-tools/src/tools/read.ts
-var listSites = defineTool({
-  name: "list_sites",
-  title: "List sites",
-  description: "Sites this connection can edit, with their titles and live addresses. Start here when you don't know the site id.",
-  input: external_exports.object({}),
-  annotations: { readOnlyHint: true },
-  async handler(ctx) {
-    const allowed = new Set(await ctx.allowedSites());
-    const sites = (await ctx.store.listSites()).filter((s2) => allowed.has(s2.id));
-    return { data: { sites, canPublish: ctx.grant.publish && ctx.store.capabilities.canPublish } };
-  }
-});
-function stylesSummary(doc) {
-  const compiled2 = compileStyles(doc.styles);
-  const pairing = getPairing(doc.styles.choices.pairing);
-  return {
-    choices: doc.styles.choices,
-    pairing: pairing ? { id: pairing.id, heading: pairing.heading.family, body: pairing.body.family } : { id: doc.styles.choices.pairing, unknown: true },
-    overrides: doc.styles.overrides ?? null,
-    brand: compiled2.tokens.palette.brand,
-    themes: Object.fromEntries(
-      Object.entries(compiled2.tokens.themes).map(([theme, c]) => [
-        theme,
-        {
-          background: c.background,
-          text: c.text,
-          heading: c.heading,
-          accent: c.accent,
-          "accent-text": c["accent-text"]
-        }
-      ])
-    ),
-    contrast: {
-      mode: compiled2.contrast.mode,
-      adjustedBySolver: compiled2.contrast.adjustments.length,
-      failures: compiled2.contrast.failures.length
-    }
-  };
-}
-function pageSummary(page) {
-  return {
-    id: page.id,
-    title: page.title,
-    slug: page.slug,
-    path: pagePathOf(page),
-    sections: page.sections.length,
-    hidden: page.hidden ?? false
-  };
-}
-var getSite = defineTool({
-  name: "get_site",
-  title: "Get site",
-  description: "Site settings, navigation, header/footer, Site Styles summary, page list and collections. Call before editing to learn page ids and the current look.",
-  input: external_exports.object({ site: siteArg }),
-  annotations: { readOnlyHint: true },
-  async handler(ctx, input) {
-    const siteId = await ctx.siteId(input.site);
-    const doc = await ctx.doc(siteId);
-    const { site: site2 } = doc;
-    return {
-      data: {
-        id: siteId,
-        title: site2.title,
-        tagline: site2.tagline ?? null,
-        template: doc.config.template ?? null,
-        url: doc.config.deploy.customDomain ? `https://${doc.config.deploy.customDomain}` : doc.config.deploy.url,
-        nav: site2.nav,
-        header: site2.header,
-        footer: {
-          sectionId: site2.footer.id,
-          layout: site2.footer.layout.mode,
-          blocks: site2.footer.blocks.map((b) => ({ id: b.id, type: b.type })),
-          note: 'Edit footer blocks with the block tools using page "footer".'
-        },
-        announcement: site2.announcement ?? null,
-        social: site2.social ?? [],
-        seo: site2.seo ?? null,
-        styles: stylesSummary(doc),
-        pages: Object.values(doc.pages).map(pageSummary),
-        collections: Object.entries(doc.collections).map(([name, items]) => ({
-          name,
-          kind: Object.values(items)[0]?.kind ?? doc.collectionConfigs?.[name]?.kind ?? null,
-          items: Object.keys(items).length
-        })),
-        media: Object.keys(doc.media).length,
-        capabilities: {
-          ...ctx.store.capabilities,
-          // Same answer as list_sites: publishing needs both the store and this connection.
-          canPublish: ctx.grant.publish && ctx.store.capabilities.canPublish,
-          grantPublish: ctx.grant.publish
-        }
-      }
-    };
-  }
-});
-function sectionView(ctx, section, detail, doc) {
-  const registry3 = doc ? ctx.registryFor(doc) : ctx.registry;
-  const blocks2 = section.blocks.map((b) => {
-    if (detail === "outline") {
-      const out = {
-        id: b.id,
-        type: b.type,
-        text: blockPreview(registry3, b)
-      };
-      if (b.variant) out.variant = b.variant;
-      if (b.column !== void 0) out.column = b.column;
-      if (b.hidden) out.hidden = true;
-      return out;
-    }
-    return blockToAgent(registry3, b);
-  });
-  const base = {
-    id: section.id,
-    ...section.preset ? { preset: section.preset } : {},
-    ...section.label ? { label: section.label } : {},
-    ...section.hidden ? { hidden: true } : {},
-    ...section.locked ? { locked: true } : {},
-    theme: section.style?.colorTheme ?? "light"
-  };
-  if (detail === "outline") {
-    base.layout = section.layout.mode === "grid" ? "grid" : `stack ${JSON.stringify(section.layout.columns.d)}`;
-    base.blocks = blocks2;
-    return base;
-  }
-  return {
-    ...base,
-    layout: section.layout,
-    style: section.style ?? {},
-    ...section.anchor ? { anchor: section.anchor } : {},
-    blocks: blocks2
-  };
-}
-var getPage2 = defineTool({
-  name: "get_page",
-  title: "Get page",
-  description: `A page's section/block tree with stable ids, fields (rich text as Markdown), layout and style. Use detail "outline" for a compact overview (ids, types, text previews) and "full" before editing fields or grid placements. page "footer" returns the site footer section.`,
-  input: external_exports.object({
-    site: siteArg,
-    page: containerArg,
-    detail: external_exports.enum(["full", "outline"]).optional().describe('Default "full".')
-  }),
-  annotations: { readOnlyHint: true },
-  async handler(ctx, input) {
-    const siteId = await ctx.siteId(input.site);
-    const doc = await ctx.doc(siteId);
-    const detail = input.detail ?? "full";
-    const { id, page } = resolvePage(doc, input.page, { allowFooter: true });
-    if (id === FOOTER || !page)
-      return { data: { page: FOOTER, sections: [sectionView(ctx, doc.site.footer, detail, doc)] } };
-    return {
-      data: {
-        id: page.id,
-        title: page.title,
-        slug: page.slug,
-        path: pagePathOf(page),
-        seo: page.seo ?? {},
-        ...page.header ? { header: page.header } : {},
-        ...page.hidden ? { hidden: true } : {},
-        sections: page.sections.map((s2) => sectionView(ctx, s2, detail, doc))
-      }
-    };
-  }
-});
-function blockMetaView(m, full) {
-  const fields = Object.fromEntries(
-    Object.entries(m.fields).map(([k, f]) => {
-      const v = {
-        kind: f.kind === "richText" ? "richText (Markdown)" : f.kind
-      };
-      if (f.optional) v.optional = true;
-      if (f.label) v.label = f.label;
-      if (full && f.help) v.help = f.help;
-      if (f.ai) v.ai = f.ai;
-      if (f.kind === "select") v.options = f.options.map((o) => o.value);
-      if (f.kind === "text" && f.maxLength) v.maxLength = f.maxLength;
-      if (f.kind === "list")
-        v.itemFields = Object.fromEntries(
-          Object.entries(f.fields).map(([ik, iv]) => [
-            ik,
-            iv.kind === "richText" ? "richText (Markdown)" : iv.kind
-          ])
-        );
-      if (f.kind === "image") v.shape = "{ src, alt, focal? }";
-      if (f.kind === "link") v.allow = f.allow;
-      return [k, v];
-    })
-  );
-  return {
-    type: m.type,
-    label: m.label,
-    category: m.category,
-    description: m.description,
-    variants: m.variants,
-    styleSlots: m.styleSlots,
-    fields,
-    ai: m.ai
-  };
-}
-var listBlocks = defineTool({
-  name: "list_blocks",
-  title: "List blocks",
-  description: "The block catalog: each block's fields (rich text as Markdown), variants, style slots and AI guidance (purpose, whenToUse, avoid). Filter by category or type. Prefer section presets for whole sections; use blocks to add or adjust pieces.",
-  input: external_exports.object({
-    category: external_exports.string().optional(),
-    type: external_exports.string().optional().describe("One block type for full detail.")
-  }),
-  annotations: { readOnlyHint: true },
-  async handler(ctx, input) {
-    let metas = ctx.registry.meta();
-    if (input.type) {
-      metas = metas.filter((m) => m.type === input.type);
-      if (!metas.length)
-        throw new ToolError(
-          `Unknown block type "${input.type}". Types: ${ctx.registry.types().join(", ")}.`,
-          "not_found"
-        );
-    }
-    if (input.category) metas = metas.filter((m) => m.category === input.category);
-    return {
-      data: {
-        blocks: metas.map((m) => blockMetaView(m, Boolean(input.type))),
-        categories: [...new Set(ctx.registry.meta().map((m) => m.category))]
-      }
-    };
-  }
-});
-var getBlockSchema = defineTool({
-  name: "get_block_schema",
-  title: "Get block schema",
-  description: "JSON Schema for one block type's fields (with labels and AI hints). Rich-text fields are shown as ProseMirror JSON but the edit tools also accept a Markdown string for them.",
-  input: external_exports.object({ type: external_exports.string() }),
-  annotations: { readOnlyHint: true },
-  async handler(ctx, input) {
-    const def = ctx.registry.get(input.type);
-    if (!def)
-      throw new ToolError(
-        `Unknown block type "${input.type}". Types: ${ctx.registry.types().join(", ")}.`,
-        "not_found"
-      );
-    return {
-      data: {
-        type: def.type,
-        version: def.version,
-        variants: def.meta.variants,
-        styleSlots: def.meta.styleSlots,
-        fields: blockFieldsJsonSchema(def)
-      }
-    };
-  }
-});
-var listSectionPresets = defineTool({
-  name: "list_section_presets",
-  title: "List section presets",
-  description: "Designed section presets by category (hero, about, services, gallery, testimonials, pricing, faq, team, stats, cta, contact, newsletter, blog, events, products, footer, header) with descriptions, layout, designed-for color themes, copy-length ranges and AI guidance. Compose pages from these with insert_section/create_page.",
-  input: external_exports.object({
-    category: external_exports.enum(PRESET_CATEGORIES).optional(),
-    query: external_exports.string().optional().describe("Words to match in label, description or tags."),
-    detail: external_exports.enum(["brief", "full"]).optional().describe('Default "brief".')
-  }),
-  annotations: { readOnlyHint: true },
-  async handler(_ctx, input) {
-    let list5 = presetCatalog.slice();
-    if (input.category) list5 = list5.filter((p) => p.category === input.category);
-    if (input.query) {
-      const words4 = input.query.toLowerCase().split(/\s+/).filter(Boolean);
-      list5 = list5.filter((p) => {
-        const hay = `${p.id} ${p.label} ${p.description} ${p.tags.join(" ")} ${p.ai.whenToUse}`.toLowerCase();
-        return words4.every((w) => hay.includes(w));
-      });
-    }
-    const full = input.detail === "full";
-    return {
-      data: {
-        presets: list5.map(
-          (p) => full ? p : {
-            id: p.id,
-            label: p.label,
-            description: p.description,
-            target: p.target,
-            layout: p.layout,
-            overlap: p.overlap,
-            themes: p.themes,
-            whenToUse: p.ai.whenToUse
-          }
-        ),
-        categories: PRESET_CATEGORIES
-      }
-    };
-  }
-});
-function findPreset(id) {
-  const exact = getPreset(id);
-  if (exact) return exact;
-  const base = id.replace(/@\d+$/, "");
-  const matches = presetCatalog.filter((p) => p.id.startsWith(`${base}@`)).sort((a, b) => b.version - a.version);
-  const best = matches[0] && getPreset(matches[0].id);
-  if (best) return best;
-  const category = base.split("/")[0] ?? "";
-  const near = presetCatalog.filter((p) => p.category === category).map((p) => p.id);
-  throw new ToolError(
-    `Unknown preset "${id}".${near.length ? ` In ${category}: ${near.join(", ")}.` : " Call list_section_presets."}`,
-    "not_found"
-  );
-}
-
 // ../mcp-tools/src/tools/design.ts
 var stripMeta = (op2) => {
   const { id: _i, actor: _a3, ts: _t, ...body } = op2;
@@ -47207,7 +47923,7 @@ ${(adjusted.ok ? left.map((i) => `- ${i.message}`) : issueLines(adjusted.errors)
     solverNotes
   };
 }
-var isRecord3 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var isRecord4 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 var setStyles = defineTool({
   name: "set_styles",
   title: "Set Site Styles",
@@ -47258,8 +47974,8 @@ var setStyles = defineTool({
     for (const [k, v] of Object.entries(c.layout ?? {}))
       if (v !== void 0) set2[`choices.layout.${k}`] = v;
     for (const [path2, v] of Object.entries(input.overrides?.set ?? {})) {
-      const token = isRecord3(v) && "$value" in v ? v : { $value: v };
-      if (path2.startsWith("color.") && isRecord3(token) && token.$type === void 0)
+      const token = isRecord4(v) && "$value" in v ? v : { $value: v };
+      if (path2.startsWith("color.") && isRecord4(token) && token.$type === void 0)
         token.$type = "color";
       set2[`overrides.${path2}`] = token;
     }
@@ -47700,478 +48416,6 @@ var updateDesignSystem = defineTool({
 });
 var designSystemTools = [getDesignSystem, updateDesignSystem];
 
-// ../mcp-tools/src/tools/edit.ts
-var isRecord4 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
-var themeArg = external_exports.enum(COLOR_THEMES).describe("Section color theme.");
-var blockSummary = (registry3, b) => ({
-  id: b.id,
-  type: b.type,
-  ...b.variant ? { variant: b.variant } : {},
-  ...b.column !== void 0 ? { column: b.column } : {},
-  text: blockPreview(registry3, b)
-});
-function sectionSummary(registry3, s2) {
-  return {
-    id: s2.id,
-    ...s2.preset ? { preset: s2.preset } : {},
-    theme: s2.style?.colorTheme ?? "light",
-    layout: s2.layout.mode,
-    blocks: s2.blocks.map((b) => blockSummary(registry3, b))
-  };
-}
-function container(doc, ref) {
-  return resolvePage(doc, ref, { allowFooter: true }).id;
-}
-function pageOnly(doc, ref) {
-  if (ref === FOOTER)
-    throw new ToolError(
-      "Sections can't be inserted, moved or deleted in the footer; replace it with a footer preset (insert_section with a footer/\u2026 preset) or edit its blocks.",
-      "invalid_arguments"
-    );
-  return resolvePage(doc, ref).id;
-}
-function requireSection2(doc, page, section) {
-  const loc = findSection(doc, page, section);
-  if (!loc) {
-    const ids = page === FOOTER ? [doc.site.footer.id] : doc.pages[page]?.sections.map(
-      (s2) => s2.id
-    ) ?? [];
-    throw new ToolError(
-      `No section ${section} on ${page}. Sections there: ${ids.join(", ") || "none"}.`,
-      "not_found"
-    );
-  }
-  return loc.section;
-}
-function requireBlock(doc, page, block4) {
-  const loc = findBlock(doc, page, block4);
-  if (loc) return { block: loc.block, section: loc.section };
-  const elsewhere = locateBlock(doc, block4);
-  throw new ToolError(
-    elsewhere ? `Block ${block4} is on ${elsewhere.container}, not ${page}.` : `No block ${block4}. Call get_page to see block ids.`,
-    "not_found"
-  );
-}
-function makeBlock2(registry3, input) {
-  const def = registry3.get(input.type);
-  if (!def)
-    throw new ToolError(
-      `Unknown block type "${input.type}". Types: ${registry3.types().join(", ")}.`,
-      "invalid_arguments"
-    );
-  const fields = {};
-  for (const [k, m] of Object.entries(def.meta.fields))
-    if (!m.optional && m.default !== void 0) fields[k] = structuredClone(m.default);
-  Object.assign(fields, fieldsFromAgent(registry3, input.type, input.fields ?? {}));
-  const { type, fields: _f, id, v: _v, ...rest } = input;
-  return {
-    ...rest,
-    id: id ?? newId("blk"),
-    type,
-    v: def.version,
-    fields
-  };
-}
-function makeSection(registry3, raw2) {
-  const blocks2 = Array.isArray(raw2.blocks) ? raw2.blocks : [];
-  return {
-    ...raw2,
-    id: typeof raw2.id === "string" ? raw2.id : newId("sec"),
-    layout: raw2.layout ?? { mode: "stack", columns: { d: [12] } },
-    style: isRecord4(raw2.style) ? raw2.style : { colorTheme: "light" },
-    blocks: blocks2.map((b, i) => {
-      if (!isRecord4(b) || typeof b.type !== "string")
-        throw new ToolError(`section.blocks[${i}] needs a "type".`, "invalid_arguments");
-      return makeBlock2(registry3, b);
-    })
-  };
-}
-var insertSection = defineTool({
-  name: "insert_section",
-  title: "Insert section",
-  description: "Add a section to a page from a preset id (preferred \u2014 see list_section_presets) or an explicit section. Preset sections arrive with designed demo copy: replace it with the owner's real content using update_block. Header presets restyle the site header and footer presets replace the site footer (page is ignored for those). Returns the new section and block ids.",
-  input: external_exports.object({
-    site: siteArg,
-    page: external_exports.string().optional().describe("Page id/slug/title (not needed for header/footer presets)."),
-    preset: external_exports.string().optional().describe('Preset id, e.g. "hero/split-image@1" (version optional).'),
-    section: external_exports.looseObject({}).optional().describe(
-      "Explicit section ({layout, style, blocks:[{type, fields, variant?, column?}]}); ids are generated when omitted; rich text as Markdown."
-    ),
-    at: positionArg.optional(),
-    colorTheme: themeArg.optional(),
-    primaryLink: external_exports.unknown().optional().describe(
-      "Link for the main call to action ({type:'page', page:'pg_\u2026'} or {type:'url', url})."
-    ),
-    secondaryLink: external_exports.unknown().optional(),
-    collection: external_exports.string().optional().describe("Collection for summary/events/product presets."),
-    label: external_exports.string().max(80).optional().describe("Layers label for the section.")
-  }),
-  annotations: {},
-  async handler(ctx, input) {
-    const siteId = await ctx.siteId(input.site);
-    const doc = await ctx.doc(siteId);
-    if (!!input.preset === !!input.section)
-      throw new ToolError("Give exactly one of preset or section.", "invalid_arguments");
-    const links = {};
-    for (const k of ["primaryLink", "secondaryLink"]) {
-      if (input[k] === void 0) continue;
-      const r = LinkSchema.safeParse(input[k]);
-      if (!r.success)
-        throw new ToolError(
-          `${k} is not a valid link: ${r.error.issues.map((i) => i.message).join("; ")}`,
-          "invalid_arguments"
-        );
-      links[k] = r.data;
-    }
-    if (input.preset) {
-      const preset = findPreset(input.preset);
-      const opts = { colorTheme: input.colorTheme, collection: input.collection, ...links };
-      const linkNote = (changes2) => changes2.length ? {
-        linksChanged: changes2.map((c) => ({ from: c.from, to: c.to })),
-        linkNote: "Example links that lead nowhere on this site were pointed at existing pages; change them with update_block."
-      } : {};
-      if (preset.target === "header") {
-        const { value: header, changes: changes2 } = resolveInternalLinks(preset.build(opts), doc);
-        await ctx.apply(siteId, [{ op: "site.update", set: { header } }]);
-        return {
-          data: {
-            applied: preset.id,
-            header,
-            note: "The site header now uses this preset.",
-            ...linkNote(changes2)
-          }
-        };
-      }
-      const { value: section2, changes } = resolveInternalLinks(preset.build(opts), doc);
-      if (input.label) section2.label = input.label;
-      if (preset.target === "footer") {
-        await ctx.apply(siteId, [{ op: "site.update", set: { footer: section2 } }]);
-        return {
-          data: {
-            replaced: "footer",
-            section: sectionSummary(ctx.registry, section2),
-            note: 'Edit footer blocks with page "footer".',
-            ...linkNote(changes)
-          }
-        };
-      }
-      if (!input.page)
-        throw new ToolError("page is required for page sections.", "invalid_arguments");
-      const page2 = pageOnly(doc, input.page);
-      await ctx.apply(siteId, [
-        { op: "section.insert", page: page2, at: input.at ?? "end", section: section2 }
-      ]);
-      return {
-        data: {
-          page: page2,
-          section: sectionSummary(ctx.registry, section2),
-          copyGuidance: preset.copy.map((c) => `${c.label}: ${c.words[0]}\u2013${c.words[1]} words`),
-          next: "Replace the demo copy with the owner's content (update_block), then run design_check.",
-          ...linkNote(changes)
-        }
-      };
-    }
-    if (!input.page) throw new ToolError("page is required.", "invalid_arguments");
-    const page = pageOnly(doc, input.page);
-    const section = makeSection(ctx.registry, input.section);
-    if (input.colorTheme)
-      section.style = { ...section.style ?? {}, colorTheme: input.colorTheme };
-    if (input.label) section.label = input.label;
-    await ctx.apply(siteId, [
-      { op: "section.insert", page, at: input.at ?? "end", section }
-    ]);
-    return { data: { page, section: sectionSummary(ctx.registry, section) } };
-  }
-});
-var updateSection = defineTool({
-  name: "update_section",
-  title: "Update section",
-  description: `Change a section's settings with dot-path patches, e.g. set {"style.colorTheme": "dark", "style.padding": {"d": "xl", "m": "lg"}, "label": "Intro", "anchor": "classes", "hidden": true, "layout": {...}}. Shortcuts: colorTheme. Blocks are edited with the block tools.`,
-  input: external_exports.object({
-    site: siteArg,
-    page: containerArg,
-    section: external_exports.string(),
-    set: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
-    unset: external_exports.array(external_exports.string()).optional(),
-    colorTheme: themeArg.optional()
-  }),
-  annotations: { idempotentHint: true },
-  async handler(ctx, input) {
-    const siteId = await ctx.siteId(input.site);
-    const doc = await ctx.doc(siteId);
-    const page = container(doc, input.page);
-    requireSection2(doc, page, input.section);
-    const set2 = { ...input.set ?? {} };
-    if (input.colorTheme) set2["style.colorTheme"] = input.colorTheme;
-    const body = { op: "section.update", page, section: input.section };
-    if (Object.keys(set2).length) body.set = set2;
-    if (input.unset?.length) body.unset = input.unset;
-    const { doc: next } = await ctx.apply(siteId, [body]);
-    return {
-      data: { section: sectionSummary(ctx.registry, requireSection2(next, page, input.section)) }
-    };
-  }
-});
-var moveSection = defineTool({
-  name: "move_section",
-  title: "Move section",
-  description: "Reorder a section within its page.",
-  input: external_exports.object({ site: siteArg, page: external_exports.string(), section: external_exports.string(), at: positionArg }),
-  annotations: { idempotentHint: true },
-  async handler(ctx, input) {
-    const siteId = await ctx.siteId(input.site);
-    const doc = await ctx.doc(siteId);
-    const page = pageOnly(doc, input.page);
-    requireSection2(doc, page, input.section);
-    const { doc: next } = await ctx.apply(siteId, [
-      { op: "section.move", page, section: input.section, at: input.at }
-    ]);
-    return { data: { order: next.pages[page]?.sections.map((s2) => s2.id) } };
-  }
-});
-var deleteSection = defineTool({
-  name: "delete_section",
-  title: "Delete section",
-  description: "Remove a section and its blocks from a page (recoverable from the session snapshot or discard_draft).",
-  input: external_exports.object({ site: siteArg, page: external_exports.string(), section: external_exports.string() }),
-  annotations: { destructiveHint: true },
-  async handler(ctx, input) {
-    const siteId = await ctx.siteId(input.site);
-    const doc = await ctx.doc(siteId);
-    const page = pageOnly(doc, input.page);
-    requireSection2(doc, page, input.section);
-    await ctx.apply(siteId, [{ op: "section.delete", page, section: input.section }]);
-    return { data: { deleted: input.section } };
-  }
-});
-var gridItemArg = external_exports.looseObject({}).describe(
-  "Grid placement {d:{x,y,w,h,z?,bleed?}, t?, m?}: 24 columns on desktop/tablet, 8 on mobile, 1-based."
-);
-var insertBlock = defineTool({
-  name: "insert_block",
-  title: "Insert block",
-  description: "Add a block to a section. Fields are validated against the block type (see list_blocks); rich text as Markdown. In stack sections pick a column (0-based); in grid sections give place (auto-placed at the bottom otherwise) and then check the mobile layout (auto_mobile_layout).",
-  input: external_exports.object({
-    site: siteArg,
-    page: containerArg,
-    section: external_exports.string(),
-    block: external_exports.looseObject({
-      type: external_exports.string(),
-      fields: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
-      variant: external_exports.string().optional(),
-      style: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
-      column: external_exports.int().min(0).max(3).optional(),
-      label: external_exports.string().optional()
-    }).describe("{type, fields, variant?, style?, column?, label?}"),
-    at: positionArg.optional(),
-    place: gridItemArg.optional()
-  }),
-  annotations: {},
-  async handler(ctx, input) {
-    const siteId = await ctx.siteId(input.site);
-    const doc = await ctx.doc(siteId);
-    const page = container(doc, input.page);
-    requireSection2(doc, page, input.section);
-    const made = makeBlock2(ctx.registryFor(doc), input.block);
-    const block4 = resolveInternalLinks(made, doc).value;
-    for (const k of Object.keys(input.block.fields ?? {}))
-      if (k in made.fields) block4.fields[k] = made.fields[k];
-    const body = {
-      op: "block.insert",
-      page,
-      section: input.section,
-      at: input.at ?? "end",
-      block: block4
-    };
-    if (input.place) body.place = input.place;
-    const { doc: next, warnings } = await ctx.apply(siteId, [body]);
-    const placed = findBlock(next, page, block4.id);
-    return {
-      data: {
-        block: blockSummary(ctx.registryFor(next), placed?.block ?? block4),
-        ...warnings.length ? { warnings } : {}
-      }
-    };
-  }
-});
-var updateBlock = defineTool({
-  name: "update_block",
-  title: "Update block",
-  description: "Edit a block: set replaces whole top-level fields (rich text as Markdown; lists are replaced whole), unset removes optional fields; variant/style/column/label/hidden adjust presentation (null removes). Ids are preserved.",
-  input: external_exports.object({
-    site: siteArg,
-    page: containerArg,
-    block: external_exports.string(),
-    set: external_exports.record(external_exports.string(), external_exports.unknown()).optional(),
-    unset: external_exports.array(external_exports.string()).optional(),
-    variant: external_exports.string().nullable().optional(),
-    style: external_exports.record(external_exports.string(), external_exports.unknown()).nullable().optional(),
-    column: external_exports.int().min(0).max(3).nullable().optional(),
-    label: external_exports.string().max(80).nullable().optional(),
-    hidden: external_exports.boolean().nullable().optional()
-  }),
-  annotations: { idempotentHint: true },
-  async handler(ctx, input) {
-    const siteId = await ctx.siteId(input.site);
-    const doc = await ctx.doc(siteId);
-    const page = container(doc, input.page);
-    const { block: block4 } = requireBlock(doc, page, input.block);
-    const body = { op: "block.update", page, block: input.block };
-    if (input.set) body.set = fieldsFromAgent(ctx.registryFor(doc), block4.type, input.set);
-    if (input.unset?.length) body.unset = input.unset;
-    for (const k of ["variant", "style", "column", "label", "hidden"])
-      if (input[k] !== void 0) body[k] = input[k];
-    if (Object.keys(body).length === 3)
-      throw new ToolError(
-        "Nothing to change: give set, unset, variant, style, column, label or hidden.",
-        "invalid_arguments"
-      );
-    const { doc: next } = await ctx.apply(siteId, [body]);
-    const updated = findBlock(next, page, input.block)?.block ?? block4;
-    return { data: { block: blockSummary(ctx.registryFor(next), updated) } };
-  }
-});
-var moveBlock = defineTool({
-  name: "move_block",
-  title: "Move block",
-  description: "Move a block within its page (to another section and/or position). Give column for stack sections and place for grid sections.",
-  input: external_exports.object({
-    site: siteArg,
-    page: containerArg,
-    block: external_exports.string(),
-    to: external_exports.object({
-      section: external_exports.string(),
-      at: positionArg.optional(),
-      column: external_exports.int().min(0).max(3).nullable().optional(),
-      place: gridItemArg.optional()
-    })
-  }),
-  annotations: { idempotentHint: true },
-  async handler(ctx, input) {
-    const siteId = await ctx.siteId(input.site);
-    const doc = await ctx.doc(siteId);
-    const page = container(doc, input.page);
-    requireBlock(doc, page, input.block);
-    requireSection2(doc, page, input.to.section);
-    const to = { section: input.to.section, at: input.to.at ?? "end" };
-    if (input.to.column !== void 0) to.column = input.to.column;
-    if (input.to.place) to.place = input.to.place;
-    await ctx.apply(siteId, [{ op: "block.move", page, block: input.block, to }]);
-    return { data: { moved: input.block, to } };
-  }
-});
-var deleteBlock = defineTool({
-  name: "delete_block",
-  title: "Delete block",
-  description: "Remove a block from its section (recoverable via the session snapshot or discard_draft).",
-  input: external_exports.object({ site: siteArg, page: containerArg, block: external_exports.string() }),
-  annotations: { destructiveHint: true },
-  async handler(ctx, input) {
-    const siteId = await ctx.siteId(input.site);
-    const doc = await ctx.doc(siteId);
-    const page = container(doc, input.page);
-    requireBlock(doc, page, input.block);
-    await ctx.apply(siteId, [{ op: "block.delete", page, block: input.block }]);
-    return { data: { deleted: input.block } };
-  }
-});
-var rectArg = external_exports.looseObject({}).describe(
-  "{x, y, w, h, z?, bleed?: 'left'|'right'|'both'} (1-based; 24 columns desktop/tablet, 8 mobile)"
-);
-var placeInGrid2 = defineTool({
-  name: "place_in_grid",
-  title: "Place in grid",
-  description: "Set a block's grid placement per breakpoint in a grid section. d = desktop (required on first placement), t = tablet override (null removes), m = mobile (null removes; regenerate with auto_mobile_layout). Rows grow automatically. Overlap is allowed (use z) but text must not overlap text.",
-  input: external_exports.object({
-    site: siteArg,
-    page: containerArg,
-    section: external_exports.string(),
-    block: external_exports.string(),
-    d: rectArg.optional(),
-    t: rectArg.nullable().optional(),
-    m: rectArg.nullable().optional()
-  }),
-  annotations: { idempotentHint: true },
-  async handler(ctx, input) {
-    const siteId = await ctx.siteId(input.site);
-    const doc = await ctx.doc(siteId);
-    const page = container(doc, input.page);
-    const section = requireSection2(doc, page, input.section);
-    if (section.layout.mode !== "grid")
-      throw new ToolError(
-        `Section ${section.id} is a stack section; set the block's column with update_block instead.`,
-        "invalid_arguments"
-      );
-    const bodies = [];
-    for (const bp of ["d", "t", "m"]) {
-      const rect = input[bp];
-      if (rect === void 0) continue;
-      bodies.push({
-        op: "grid.place",
-        page,
-        section: section.id,
-        block: input.block,
-        bp,
-        rect
-      });
-    }
-    if (!bodies.length) throw new ToolError("Give at least one of d, t or m.", "invalid_arguments");
-    const { doc: next } = await ctx.apply(siteId, bodies);
-    const after = requireSection2(next, page, section.id);
-    return {
-      data: {
-        placement: after.layout.mode === "grid" ? after.layout.items[input.block] : null,
-        rows: after.layout.mode === "grid" ? after.layout.rows : null,
-        next: input.d && input.m === void 0 ? "Desktop changed: review mobile (auto_mobile_layout or screenshot device mobile)." : void 0
-      }
-    };
-  }
-});
-var autoMobileLayout2 = defineTool({
-  name: "auto_mobile_layout",
-  title: "Auto mobile layout",
-  description: "Generate mobile grid placements for a grid section by visual reading order (top-to-bottom, left-to-right on the desktop grid, layered items kept on their host). Keeps existing mobile placements unless reset is true.",
-  input: external_exports.object({
-    site: siteArg,
-    page: containerArg,
-    section: external_exports.string(),
-    reset: external_exports.boolean().optional()
-  }),
-  annotations: { idempotentHint: true },
-  async handler(ctx, input) {
-    const siteId = await ctx.siteId(input.site);
-    const doc = await ctx.doc(siteId);
-    const page = container(doc, input.page);
-    const section = requireSection2(doc, page, input.section);
-    if (section.layout.mode !== "grid")
-      return { data: { changed: 0, note: "Stack sections stack automatically on mobile." } };
-    const ops = autoMobileLayoutOps(doc, page, section.id, { reset: input.reset });
-    if (!ops.length)
-      return { data: { changed: 0, note: "Mobile placements are already complete." } };
-    const bodies = ops.map(({ id: _i, actor: _a3, ts: _t, ...b }) => b);
-    const { doc: next } = await ctx.apply(siteId, bodies);
-    const after = requireSection2(next, page, section.id);
-    return {
-      data: {
-        changed: ops.length,
-        mobile: after.layout.mode === "grid" ? Object.fromEntries(Object.entries(after.layout.items).map(([id, it]) => [id, it.m])) : null
-      }
-    };
-  }
-});
-var editTools = [
-  insertSection,
-  updateSection,
-  moveSection,
-  deleteSection,
-  insertBlock,
-  updateBlock,
-  moveBlock,
-  deleteBlock,
-  placeInGrid2,
-  autoMobileLayout2
-];
-
 // ../mcp-tools/src/tools/pages.ts
 function requireConfirm(confirm, what) {
   if (confirm !== true)
@@ -48308,16 +48552,59 @@ var deletePage = defineTool({
     };
   }
 });
+function connectSections(doc, tree) {
+  const view = { ...doc, site: { ...doc.site, nav: tree } };
+  const bodies = [];
+  const connected = [];
+  const warnings = [];
+  const claimed = /* @__PURE__ */ new Map();
+  for (const l of findBrokenLinks(view)) {
+    if (l.kind !== "anchor" || l.scope.kind !== "site" || l.path[0] !== "nav") continue;
+    if (!l.anchor) {
+      warnings.push(`${l.message}.`);
+      continue;
+    }
+    const { page, fragment } = l.anchor;
+    const key2 = `${page}#${fragment}`;
+    if (claimed.has(key2)) continue;
+    const section = suggestAnchorSection(view, page, fragment);
+    const free = section && !section.anchor && ![...claimed.values()].includes(section.id) && SlugSchema.safeParse(fragment).success;
+    if (section && free) {
+      claimed.set(key2, section.id);
+      bodies.push({ op: "section.update", page, section: section.id, set: { anchor: fragment } });
+      connected.push({
+        anchor: fragment,
+        section: section.id,
+        sectionLabel: section.label ?? section.preset ?? section.blocks[0]?.type ?? "section"
+      });
+    } else
+      warnings.push(
+        `The menu links to \u201C${fragment}\u201D, but no section on that page is called that. Name the section it should jump to with update_section (page, section, set {"anchor": "${fragment}"}), or change the entry.`
+      );
+  }
+  return { bodies, connected, warnings };
+}
 var updateNavigation = defineTool({
   name: "update_navigation",
   title: "Update navigation",
-  description: 'Replace the navigation tree. Items: {type:"page", page:"pg_\u2026", label?}, {type:"collection", collection, label}, {type:"link", label, href, newTab?}, {type:"button", label, link, style:"primary"|"secondary"|"tertiary"}, {type:"folder", label, page?, items:[\u2026one level\u2026]}. Keep one button at most (the header call to action).',
+  description: `Replace the navigation tree. Items: {type:"page", page:"pg_\u2026", label?, anchor?}, {type:"collection", collection, label}, {type:"link", label, href, newTab?}, {type:"button", label, link, style:"primary"|"secondary"|"tertiary"}, {type:"folder", label, page?, items:[\u2026one level\u2026]}. Keep one button at most (the header call to action). A menu entry that scrolls to a section of a page (a one-page site's "How it works", "Prices") is {type:"page", page, label, anchor:"how-it-works"} and a button to one has link {type:"page", page, anchor}; the anchor is that section's link name \u2014 set it when you add the section (insert_section / insert_component anchor) or with update_section set {"anchor": \u2026}. Entries whose anchor no section has yet are connected to the section they most likely mean (listed in connected \u2014 check them); the rest come back in warnings.`,
   input: external_exports.object({ site: siteArg, tree: external_exports.array(external_exports.looseObject({})) }),
   annotations: { idempotentHint: true },
   async handler(ctx, input) {
     const siteId = await ctx.siteId(input.site);
-    const { doc } = await ctx.apply(siteId, [{ op: "nav.update", tree: input.tree }]);
-    return { data: { nav: doc.site.nav } };
+    const before = await ctx.doc(siteId);
+    const { bodies, connected, warnings } = connectSections(before, input.tree);
+    const { doc } = await ctx.apply(siteId, [
+      { op: "nav.update", tree: input.tree },
+      ...bodies
+    ]);
+    return {
+      data: {
+        nav: doc.site.nav,
+        ...connected.length ? { connected } : {},
+        ...warnings.length ? { warnings } : {}
+      }
+    };
   }
 });
 var SITE_FORBIDDEN = ["nav", "customCss", "headInjection", "footerInjection"];
@@ -51559,10 +51846,10 @@ function setRole(doc, theme, role, value) {
   doc.styles.overrides = overrides;
   return true;
 }
-function sectionLabel(heading2, blueprint, pageTitle, n) {
+function sectionLabel(heading2, blueprint, pageTitle2, n) {
   const first2 = heading2?.trim() || blueprint?.find((i) => i.kind === "heading" && i.text?.trim())?.text || blueprint?.find((i) => i.kind === "text" && i.text?.trim())?.text;
   const words4 = (first2 ?? "").replace(/\s+/g, " ").trim();
-  if (!words4) return `${pageTitle} section ${n}`.slice(0, 60);
+  if (!words4) return `${pageTitle2} section ${n}`.slice(0, 60);
   const short = words4.length > 40 ? `${words4.slice(0, 40).replace(/\s+\S*$/, "")}\u2026` : words4;
   const cased = /[a-z]/.test(short) ? short : short.charAt(0) + short.slice(1).toLowerCase();
   return cased.slice(0, 60);
@@ -59666,6 +59953,24 @@ function sectionElements(main, skip) {
   }
   return [];
 }
+function linkedFragments(pages) {
+  const out = /* @__PURE__ */ new Set();
+  for (const p of pages)
+    for (const a of findAll(p.root, (e) => e.tagName === "a")) {
+      const id = slugId(/#([^#?]+)$/.exec(attr(a, "href") ?? "")?.[1]);
+      if (id) out.add(id);
+    }
+  return out;
+}
+function sectionAnchor(el, linked) {
+  const own3 = slugId(attr(el, "id"));
+  if (own3 && linked.has(own3)) return own3;
+  const inner = find(el, (e) => {
+    const id = slugId(attr(e, "id"));
+    return !!id && linked.has(id);
+  });
+  return (inner ? slugId(attr(inner, "id")) : void 0) ?? own3;
+}
 var ROOT_SEL = /^(?::root|html|body|:root\s*,\s*html|html\s*,\s*body|:host)$/i;
 function serializeNodes(nodes) {
   return nodes.map(
@@ -60075,6 +60380,7 @@ ${await r.text()}`;
   const siteTitle = ((wordmark && wordmark.length <= 60 ? titleCase(wordmark) : void 0) ?? opts.title ?? homePage.siteName ?? (docTitle.split(/\s+[|·—–-]\s+/)[0] || "My site")).slice(0, 120);
   const logoImg = brand ? find(brand, (e) => e.tagName === "img") : void 0;
   const logoRef = logoImg ? resolveRef(bundle, attr(logoImg, "src") ?? "", home.path) : void 0;
+  const linked = linkedFragments(pages);
   const segsByPage = /* @__PURE__ */ new Map();
   const sqPages = [];
   const takenNames = /* @__PURE__ */ new Set();
@@ -60106,6 +60412,7 @@ ${await r.text()}`;
     const segs = [];
     const sqSections = [];
     for (const el of p.sections) {
+      const anchor = sectionAnchor(el, linked);
       const name = uniqueName(componentNameFor(el, p.sitePath), takenNames);
       const label2 = componentLabelFor(el);
       const dry = await new SectionConverter(el, dryCtx(p)).convert(name, label2);
@@ -60116,13 +60423,13 @@ ${await r.text()}`;
           if (i === 0) s2.id = m2;
           sqSections.push(s2);
         });
-        segs.push({ kind: "preset", marker: m2, reason: dry.error });
+        segs.push({ kind: "preset", marker: m2, reason: dry.error, ...anchor ? { anchor } : {} });
         presets.push({ page: p.sitePath, reason: dry.error });
         continue;
       }
       takenNames.add(name);
       const m = marker();
-      segs.push({ kind: "component", el, marker: m, name, label: label2 });
+      segs.push({ kind: "component", el, marker: m, name, label: label2, ...anchor ? { anchor } : {} });
       const blocks2 = [];
       for (const f of dry.forms) {
         const form = formFromHtml(f);
@@ -60318,6 +60625,11 @@ ${await r.text()}`;
         return rest;
       });
       if (seg.kind === "preset") {
+        const first2 = group[0];
+        if (first2 && seg.anchor && !anchors.has(seg.anchor)) {
+          first2.anchor = seg.anchor;
+          anchors.add(seg.anchor);
+        }
         out.push(...group);
         continue;
       }
@@ -60333,9 +60645,10 @@ ${await r.text()}`;
       components[r.def.name] = r.def;
       const section = componentSection(r.def, { fields: r.fields, colorTheme: "light" });
       section.label = seg.label;
-      if (r.anchor && !anchors.has(r.anchor)) {
-        section.anchor = r.anchor;
-        anchors.add(r.anchor);
+      const anchor = seg.anchor ?? r.anchor;
+      if (anchor && !anchors.has(anchor)) {
+        section.anchor = anchor;
+        anchors.add(anchor);
       }
       section.style = { ...section.style, colorTheme: "light", padding: { d: "none" } };
       out.push(section);
@@ -62249,4 +62562,4 @@ export {
   createProgram,
   run
 };
-//# sourceMappingURL=chunk-JDVCOOGD.js.map
+//# sourceMappingURL=chunk-HUS7TQPS.js.map