frameworc-mcp 0.2.0 → 0.4.0

package/dist/api-client.js

@@ -28,56 +28,168 @@ class ApiClient {
         }
         if (!res.ok) {
             const msg = json && typeof json === "object" && json.errors
-                ? `HTTP ${res.status}: ${JSON.stringify(json.errors)}`
+                ? `HTTP ${res.status}: ${json.message ?? ""} ${JSON.stringify(json.errors)}`
                 : `HTTP ${res.status}: ${typeof json === "string" ? json : JSON.stringify(json)}`;
-            throw new Error(msg);
+            throw new Error(msg.trim());
         }
         return json;
     }
-    listPages() {
-        return this.request("/pages");
+    /** Appends the effective CMS site id to a query string. */
+    q(path, siteId) {
+        const id = siteId ?? this.session.getSiteId();
+        if (id === null || id === undefined)
+            return path;
+        return path + (path.includes("?") ? "&" : "?") + `site_id=${id}`;
     }
-    getPage(id) {
-        return this.request(`/pages/${id}`);
+    /** Merges the effective CMS site id into a JSON body. */
+    b(body, siteId) {
+        const id = siteId ?? this.session.getSiteId();
+        const merged = { ...(body ?? {}) };
+        if (id !== null && id !== undefined && merged.site_id === undefined) {
+            merged.site_id = id;
+        }
+        return JSON.stringify(merged);
+    }
+    // --- sites & schema ---------------------------------------------------
+    listCmsSites() {
+        return this.request("/sites");
+    }
+    listBlocks() {
+        return this.request("/blocks");
+    }
+    getBlockSchema(name) {
+        return this.request(`/blocks/${encodeURIComponent(name)}`);
+    }
+    // --- pages ------------------------------------------------------------
+    listPages(siteId) {
+        return this.request(this.q("/pages", siteId));
     }
-    createPage(payload) {
-        return this.request("/pages", { method: "POST", body: JSON.stringify(payload) });
+    getPage(id, siteId) {
+        return this.request(this.q(`/pages/${id}`, siteId));
     }
-    updatePage(id, payload) {
-        return this.request(`/pages/${id}`, { method: "PATCH", body: JSON.stringify(payload) });
+    createPage(payload, siteId) {
+        return this.request("/pages", { method: "POST", body: this.b(payload, siteId) });
+    }
+    updatePage(id, payload, siteId) {
+        return this.request(`/pages/${id}`, { method: "PATCH", body: this.b(payload, siteId) });
+    }
+    deletePage(id, siteId) {
+        return this.request(this.q(`/pages/${id}`, siteId), { method: "DELETE" });
+    }
+    createTranslation(id, targetSiteId, payload, sourceSiteId) {
+        const body = { ...(payload ?? {}), site_id: targetSiteId };
+        const source = sourceSiteId ?? this.session.getSiteId();
+        if (source !== null && source !== undefined) {
+            body.source_site_id = source;
+        }
+        return this.request(`/pages/${id}/translations`, { method: "POST", body: JSON.stringify(body) });
     }
-    deletePage(id) {
-        return this.request(`/pages/${id}`, { method: "DELETE" });
+    // --- blocks (per page or per prefill) ---------------------------------
+    blockBase(host) {
+        return host.type === "prefill" ? `/prefills/${host.id}` : `/pages/${host.id}`;
     }
-    addBlock(pageId, block, position) {
-        return this.request(`/pages/${pageId}/blocks`, {
+    addBlock(host, block, position, siteId) {
+        return this.request(`${this.blockBase(host)}/blocks`, {
             method: "POST",
-            body: JSON.stringify({ block, position }),
+            body: this.b({ block, position }, siteId),
         });
     }
-    updateBlock(pageId, blockId, block) {
-        return this.request(`/pages/${pageId}/blocks/${blockId}`, {
+    updateBlock(host, blockId, block, siteId) {
+        return this.request(`${this.blockBase(host)}/blocks/${blockId}`, {
             method: "PATCH",
-            body: JSON.stringify(block),
+            body: this.b(block, siteId),
         });
     }
-    removeBlock(pageId, blockId) {
-        return this.request(`/pages/${pageId}/blocks/${blockId}`, { method: "DELETE" });
+    removeBlock(host, blockId, siteId) {
+        return this.request(this.q(`${this.blockBase(host)}/blocks/${blockId}`, siteId), { method: "DELETE" });
     }
-    reorderBlocks(pageId, order) {
-        return this.request(`/pages/${pageId}/blocks/order`, {
+    reorderBlocks(host, order, siteId) {
+        return this.request(`${this.blockBase(host)}/blocks/order`, {
             method: "POST",
-            body: JSON.stringify({ order }),
+            body: this.b({ order }, siteId),
         });
     }
-    listForms() {
-        return this.request("/forms");
+    extractBlockToPrefill(pageId, blockId, title, siteId) {
+        return this.request(`/pages/${pageId}/blocks/${blockId}/extract-to-prefill`, {
+            method: "POST",
+            body: this.b({ title }, siteId),
+        });
+    }
+    // --- forms --------------------------------------------------------------
+    listForms(siteId) {
+        return this.request(this.q("/forms", siteId));
+    }
+    getFormSchema() {
+        return this.request("/forms/schema");
+    }
+    getForm(id, siteId) {
+        return this.request(this.q(`/forms/${id}`, siteId));
+    }
+    createForm(payload, siteId) {
+        return this.request("/forms", { method: "POST", body: this.b(payload, siteId) });
+    }
+    updateForm(id, payload, siteId) {
+        return this.request(`/forms/${id}`, { method: "PATCH", body: this.b(payload, siteId) });
+    }
+    deleteForm(id, force, siteId) {
+        return this.request(this.q(`/forms/${id}${force ? "?force=1" : ""}`, siteId), { method: "DELETE" });
     }
-    listMenus() {
-        return this.request("/menus");
+    // --- menus --------------------------------------------------------------
+    listMenus(siteId) {
+        return this.request(this.q("/menus", siteId));
     }
-    listPrefills() {
-        return this.request("/prefills");
+    getMenu(id, siteId) {
+        return this.request(this.q(`/menus/${id}`, siteId));
+    }
+    createMenu(payload, siteId) {
+        return this.request("/menus", { method: "POST", body: this.b(payload, siteId) });
+    }
+    updateMenu(id, payload, siteId) {
+        return this.request(`/menus/${id}`, { method: "PATCH", body: this.b(payload, siteId) });
+    }
+    deleteMenu(id, force, siteId) {
+        return this.request(this.q(`/menus/${id}${force ? "?force=1" : ""}`, siteId), { method: "DELETE" });
+    }
+    // --- prefills -----------------------------------------------------------
+    listPrefills(siteId) {
+        return this.request(this.q("/prefills", siteId));
+    }
+    getPrefill(id, siteId) {
+        return this.request(this.q(`/prefills/${id}`, siteId));
+    }
+    createPrefill(payload, siteId) {
+        return this.request("/prefills", { method: "POST", body: this.b(payload, siteId) });
+    }
+    updatePrefill(id, payload, siteId) {
+        return this.request(`/prefills/${id}`, { method: "PATCH", body: this.b(payload, siteId) });
+    }
+    deletePrefill(id, force, siteId) {
+        return this.request(this.q(`/prefills/${id}${force ? "?force=1" : ""}`, siteId), { method: "DELETE" });
+    }
+    createPrefillTranslation(id, targetSiteId, payload, sourceSiteId) {
+        const body = { ...(payload ?? {}), site_id: targetSiteId };
+        const source = sourceSiteId ?? this.session.getSiteId();
+        if (source !== null && source !== undefined) {
+            body.source_site_id = source;
+        }
+        return this.request(`/prefills/${id}/translations`, { method: "POST", body: JSON.stringify(body) });
+    }
+    // --- FrameworC settings (global) ---------------------------------------
+    getSettings() {
+        return this.request("/settings");
+    }
+    updateSettings(fields) {
+        return this.request("/settings", { method: "PATCH", body: JSON.stringify({ fields }) });
+    }
+    // --- singles ----------------------------------------------------------
+    getSingle(handle, siteId) {
+        return this.request(this.q(`/singles/${encodeURIComponent(handle)}`, siteId));
+    }
+    updateSingle(handle, fields, siteId) {
+        return this.request(`/singles/${encodeURIComponent(handle)}`, {
+            method: "PATCH",
+            body: this.b(fields, siteId),
+        });
     }
 }
 exports.ApiClient = ApiClient;

package/dist/catalogue.js

@@ -83,10 +83,10 @@ exports.BLOCKS = [
         content_group: "Tiles",
         name: "Tiles (grid of cards)",
         description: "Grid of cards (icon + headline + rich text + button each).",
-        whenToUse: "Feature lists, service grids, 'value proposition' card rows,ething lists of related items.",
+        whenToUse: "Feature lists, service grids, 'value proposition' card rows, or any list of related items.",
         base: baseBlock,
         content: [
-            { name: "tiles", type: "taglist", comment: "Array of tile items, each {headline, image, text, buttonLabel1, buttonVariant1, buttonContrast1, buttonLink1, buttonIcon1, buttonBlank1, buttonLabel2, ...}. Use this to list the tiles." },
+            { name: "tiles", type: "repeater", comment: "Array of tile items, each {headline, image, text, buttonLabel1, buttonVariant1, buttonContrast1, buttonLink1, buttonIcon1, buttonBlank1, buttonLabel2, ...}. Use this to list the tiles." },
             { name: "tileLink", type: "switch", default: false, comment: "Whole tile acts as a link." },
             { name: "tileIcon", type: "switch", default: false, comment: "Display icon-only tiles." },
             { name: "contrastHover", type: "switch", default: false },
@@ -116,7 +116,7 @@ exports.BLOCKS = [
         whenToUse: "Image-heavy content that benefits from sequential browsing — testimonials, step-by-step walkthroughs, gallery-like rows.",
         base: baseBlock,
         content: [
-            { name: "slides", type: "taglist", comment: "Array of slide items, each {image, headline, text, buttonLabel1, buttonVariant1, ...}." },
+            { name: "slides", type: "repeater", comment: "Array of slide items, each {image, headline, text, buttonLabel1, buttonVariant1, ...}." },
             { name: "gallery", type: "switch", default: false, comment: "Clicking a slide opens the gallery lightbox." },
             { name: "loop", type: "switch", default: false, comment: "Infinite loop playback." },
             { name: "autoWidth", type: "switch", default: false, comment: "Slide width matches image width." },
@@ -149,7 +149,7 @@ exports.BLOCKS = [
         whenToUse: "Long content split into topic tabs (e.g. 'What we do' / 'Who we are' / 'Contact'). Don't use if there are only 1–2 logical sections — use Section instead.",
         base: baseBlock,
         content: [
-            { name: "slides", type: "taglist", comment: "Array of tab items, each {image, headline, text, buttonLabel1, ...}." },
+            { name: "slides", type: "repeater", comment: "Array of tab items, each {image, headline, text, buttonLabel1, ...}." },
             { name: "gallery", type: "switch", default: false },
             { name: "variant", type: "dropdown", enum: ["tabs-horizontal", "tabs-vertical"], default: "tabs-horizontal" },
         ],
@@ -173,7 +173,7 @@ exports.BLOCKS = [
         whenToUse: "FAQs, 'Common questions', or any content the user wants collapsed by default. Each item has a headline + rich text.",
         base: baseBlock,
         content: [
-            { name: "items", type: "taglist", comment: "Array of items, each {headline, text}." },
+            { name: "items", type: "repeater", comment: "Array of items, each {headline, text}." },
             { name: "variant", type: "dropdown", enum: ["default", "outline", "shadow"], default: "default" },
             { name: "firstItemOpen", type: "switch", default: false, comment: "First item is expanded on load." },
             { name: "singleMode", type: "switch", default: false, comment: "Only one item open at a time." },
@@ -194,12 +194,12 @@ exports.BLOCKS = [
         content_group: "Form",
         name: "Form",
         description: "Contact / inquiry form wired to a separately-defined Form Tailor entry.",
-        whenToUse: "Only when a contact form is needed AND the referenced Form entry already exists. Get the form_entry id via the `list_forms` tool. The actual form fields live on the linked Form entry, not on this block.",
+        whenToUse: "Only when a contact form is needed AND the referenced Form entry already exists. Set the block-level `form` key to the entry id from the `list_forms` tool. The actual form fields live on the linked Form entry, not on this block.",
         base: baseBlock,
         content: [
             { name: "variant", type: "dropdown", enum: ["default", "outline", "card"], default: "default" },
         ],
-        referencing: { kind: "form", location: "block", jsonKey: "form_entry", column: "form_id" },
+        referencing: { kind: "form", location: "block", jsonKey: "form", column: "form_id" },
     },
     {
         content_group: "Gallery",
@@ -245,7 +245,7 @@ exports.BLOCKS = [
                 description: "One repeater item per column. Each column has {blockId, builder: [...blocks]} where builder is a full Builder array.",
                 items: [
                     { name: "blockId", type: "text", comment: "Optional column anchor id (used for the column wrapper)." },
-                    { name: "builder", type: "taglist", comment: "Array of block objects (same shape as top-level 'builder' in a page). You can nest any block here, including another Columns (avoid deep nesting)." },
+                    { name: "builder", type: "repeater", comment: "Array of block objects (same shape as top-level 'builder' in a page). You can nest any block here, including another Columns (avoid deep nesting)." },
                 ],
             },
         ],
@@ -254,10 +254,10 @@ exports.BLOCKS = [
         content_group: "Prefill",
         name: "Prefill (reusable block template)",
         description: "References a Prefill Tailor entry whose builder content is shared across pages — edit once, updates everywhere it is used.",
-        whenToUse: "For shared/global blocks like a newsletter CTA, a contact form snippet, or a footer-style band that should appear the same on many pages. The actual block content lives on the Prefill entry — get its id via `list_prefills`. Don't use this for one-off content.",
+        whenToUse: "For shared/global blocks like a newsletter CTA, a contact form snippet, or a footer-style band that should appear the same on many pages. The actual block content lives on the Prefill entry — get its id via `list_prefills`. Whenever the same section would appear on more than one page, do NOT copy it: keep it in one Prefill (create_prefill, or extract_block_to_prefill for an existing page block) and insert this block on every page that needs it. Don't use this for one-off content.",
         base: baseBlock,
         content: [],
-        referencing: { kind: "prefill", location: "content", jsonKey: "prefill_entry", column: "block_id" },
+        referencing: { kind: "prefill", location: "content", jsonKey: "block", column: "block_id" },
     },
     {
         content_group: "BlogList",
@@ -276,10 +276,10 @@ exports.BLOCKS = [
         content_group: "MenuBlock",
         name: "Menu block",
         description: "Renders an existing Menu Tailor entry inline in the page body (flattened to 2 levels).",
-        whenToUse: "When you need to embed navigation as content (e.g. an on-page section that lists links). Get the menu_entry id via `list_menus`.",
+        whenToUse: "When you need to embed navigation as content (e.g. an on-page section that lists links). Set `content.menu` to the entry id from `list_menus`.",
         base: baseBlock,
         content: [],
-        referencing: { kind: "menu", location: "content", jsonKey: "menu_entry", column: "menu_id" },
+        referencing: { kind: "menu", location: "content", jsonKey: "menu", column: "menu_id" },
     },
     {
         content_group: "ImageStrip",