@nextblock-cms/cortex 0.17.7 → 0.17.8

package/lib/block-content-schemas.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("./zod-config.cjs.js");const t=require("zod"),u=["text","heading","image","button","posts_grid","video_embed","section","form","testimonial","product_grid","featured_product","cart","checkout","product_details"],z=t.z.enum(u),d=t.z.object({direction:t.z.string().optional(),stops:t.z.array(t.z.object({color:t.z.string(),position:t.z.number()})),type:t.z.enum(["linear","radial"])}),y=t.z.object({gradient:d.optional(),image:t.z.object({alt_text:t.z.string().optional(),blur_data_url:t.z.string().optional(),external_url:t.z.string().optional(),height:t.z.number().optional(),media_id:t.z.string().optional(),object_key:t.z.string().optional(),overlay:t.z.object({gradient:d,type:t.z.literal("gradient")}).optional(),position:t.z.enum(["center","top","bottom","left","right"]),quality:t.z.number().nullable().optional(),size:t.z.enum(["cover","contain"]),width:t.z.number().optional()}).optional(),min_height:t.z.string().optional(),solid_color:t.z.string().optional(),theme:t.z.enum(["primary","secondary","muted","accent","destructive"]).optional(),type:t.z.enum(["none","theme","solid","gradient","image"])}),g=t.z.string().regex(/^[a-z][a-z0-9-]*$/),h=t.z.object({block_type:t.z.union([z,g]),content:t.z.record(t.z.string(),t.z.any()),temp_id:t.z.string().optional()}),p=t.z.object({background:y,column_blocks:t.z.array(t.z.array(h)),column_gap:t.z.enum(["none","sm","md","lg","xl"]),container_type:t.z.enum(["full-width","container","container-sm","container-lg","container-xl"]),padding:t.z.object({bottom:t.z.enum(["none","sm","md","lg","xl"]),top:t.z.enum(["none","sm","md","lg","xl"])}),responsive_columns:t.z.object({desktop:t.z.union([t.z.literal(1),t.z.literal(2),t.z.literal(3),t.z.literal(4)]),mobile:t.z.union([t.z.literal(1),t.z.literal(2)]),tablet:t.z.union([t.z.literal(1),t.z.literal(2),t.z.literal(3)])}),vertical_alignment:t.z.enum(["start","center","end","stretch"]).optional()}),b={button:t.z.object({position:t.z.enum(["left","center","right"]).optional(),size:t.z.enum(["default","sm","lg","full"]).optional(),text:t.z.string(),url:t.z.string(),variant:t.z.enum(["default","outline","secondary","ghost","link"]).optional()}),cart:t.z.object({}),checkout:t.z.object({}),featured_product:t.z.object({imagePosition:t.z.enum(["left","right"]).default("left"),productId:t.z.string().min(1),showBackground:t.z.boolean().default(!1)}),form:t.z.object({fields:t.z.array(t.z.object({field_type:t.z.enum(["text","email","textarea","select","radio","checkbox"]),is_required:t.z.boolean(),label:t.z.string(),options:t.z.array(t.z.object({label:t.z.string(),value:t.z.string()})).optional(),placeholder:t.z.string().optional(),temp_id:t.z.string()})),form_key:t.z.string().optional(),recipient_email:t.z.string().email().optional(),submit_button_text:t.z.string(),success_message:t.z.string()}),heading:t.z.object({level:t.z.union([t.z.literal(1),t.z.literal(2),t.z.literal(3),t.z.literal(4),t.z.literal(5),t.z.literal(6)]),textAlign:t.z.enum(["left","center","right","justify"]).optional(),textColor:t.z.union([t.z.enum(["foreground","primary","secondary","accent","muted","destructive","background"]),t.z.string().regex(/^(#(?:[0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})|rgba?\([^)]+\)|hsla?\([^)]+\))$/i,"Must be a hex, rgb(a) or hsl(a) colour")]).optional().describe("Prefer a theme token so the heading adapts to dark mode; use a CSS colour only when the brand requires an exact value"),text_content:t.z.string()}),image:t.z.object({alt_text:t.z.string().optional(),caption:t.z.string().optional(),external_url:t.z.string().nullable().optional(),height:t.z.number().nullable().optional(),media_id:t.z.string().nullable().optional(),object_key:t.z.string().nullable().optional(),width:t.z.number().nullable().optional()}),posts_grid:t.z.object({columns:t.z.number().min(1).max(6),postsPerPage:t.z.number().min(1).max(50),showPagination:t.z.boolean(),title:t.z.string().optional()}),product_details:t.z.object({}),product_grid:t.z.object({categoryId:t.z.string().optional(),categoryIds:t.z.array(t.z.string()).max(20).optional(),limit:t.z.number().min(0).max(48).default(6),productIds:t.z.array(t.z.string()).max(24).optional(),showPagination:t.z.boolean().default(!1),title:t.z.string().optional(),type:t.z.enum(["latest","category","manual"]).default("latest")}),section:p,testimonial:t.z.object({author_name:t.z.string().min(1),author_title:t.z.string().optional(),image_url:t.z.string().url().optional().or(t.z.literal("")),quote:t.z.string().min(1)}),text:t.z.object({html_content:t.z.string()}),video_embed:t.z.object({autoplay:t.z.boolean().optional(),controls:t.z.boolean().optional(),title:t.z.string().optional(),url:t.z.string()})};function k(o){return u.includes(o)}function _(o){return typeof o?.validateBlockContent=="function"?o.validateBlockContent:null}function j(o,n,r){const l=_(r);if(l)return l(o,n);const i=b[o].safeParse(n);return i.success?{errors:[],isValid:!0,warnings:[]}:{errors:i.error.issues.map(s=>{const e=s.path.join(".");return e?`${e}: ${s.message}`:s.message}),isValid:!1,warnings:[]}}function f(o){return Array.isArray(o.fields)?o.fields.filter(n=>!!n&&typeof n=="object"&&typeof n.key=="string"&&typeof n.type=="string"):[]}function x(o){return o==null||typeof o=="string"&&o.trim()===""||Array.isArray(o)&&o.length===0}function B(o,n){if(!n||typeof n!="object"||Array.isArray(n))return{errors:["content must be a JSON object of { field_key: value } pairs."],isValid:!1,warnings:[]};const r=f(o),l=new Set(r.map(e=>e.key)),i=[],s=[];for(const e of Object.keys(n))l.has(e)||i.push(`Unknown field "${e}" for custom block "${o.slug}". Known fields: ${[...l].join(", ")||"(none)"}.`);for(const e of r){const a=n[e.key];if(x(a)){e.required&&i.push(`Field "${e.key}" is required.`);continue}if(e.type==="text"||e.type==="rich-text"){if(typeof a!="string"){i.push(`Field "${e.key}" must be a string${e.type==="rich-text"?" of HTML":""}.`);continue}typeof e.max_length=="number"&&a.length>e.max_length&&i.push(`Field "${e.key}" exceeds its ${e.max_length}-character limit.`),typeof e.min_length=="number"&&a.length<e.min_length&&i.push(`Field "${e.key}" is shorter than its ${e.min_length}-character minimum.`);continue}if(e.type==="image_r2"){const c=a;(typeof a!="object"||Array.isArray(a)||typeof c.object_key!="string"||typeof c.url!="string")&&i.push(`Field "${e.key}" must be an uploaded image object with object_key and url (upload it with upload_media first) or null.`);continue}if(e.type==="db_relation"){const c=m=>typeof m=="string"||typeof m=="number";e.multiple?(!Array.isArray(a)||!a.every(c))&&i.push(`Field "${e.key}" must be an array of related record ids.`):c(a)||i.push(`Field "${e.key}" must be a single related record id.`);continue}s.push(`Field "${e.key}" has an unrecognised type "${String(e.type)}"; it was not validated.`)}return{errors:i,isValid:i.length===0,warnings:s}}async function C(o){const{data:n,error:r}=await o.from("custom_block_definitions").select("slug, name, fields");if(r)throw new Error(`Could not read the custom block definitions: ${typeof r=="object"&&r&&"message"in r?String(r.message):String(r)}`);return(Array.isArray(n)?n:[]).filter(l=>!!l&&typeof l.slug=="string")}exports.availableCortexAiBlockTypes=u;exports.cortexAiBlockTypeSchema=z;exports.customBlockSlugPatternSchema=g;exports.fallbackBlockSchemas=b;exports.isValidBlockType=k;exports.loadCustomBlockDefinitions=C;exports.readCustomBlockFields=f;exports.sectionBlockFallbackSchema=p;exports.validateCortexBlockContent=j;exports.validateCustomBlockInstanceContent=B;

package/lib/block-content-schemas.d.ts

@@ -0,0 +1,216 @@
+import { z } from './zod-config';
+/**
+ * The block vocabulary Cortex AI can write, and the schemas that guard it.
+ *
+ * Two validators exist for the same JSONB, on purpose:
+ *
+ *   1. The app's own `validateBlockContent` (apps/nextblock/lib/blocks/blockRegistry.ts)
+ *      holds the authoritative Zod schemas. Both the dashboard chat route and the MCP
+ *      route inject it into the tool context, so every block Cortex writes through a
+ *      typed tool is checked against the exact schema the editor and renderer use.
+ *   2. `fallbackBlockSchemas` below mirrors those schemas for the cases where the app
+ *      is not around: unit tests, the CLI verifier, a future headless runner. libs/*
+ *      cannot import from the app, so the mirror is restated here; keep it in sync
+ *      when a block type gains a field.
+ *
+ * This module is deliberately free of tool-execution concerns so that the generic
+ * database tools (`execute_database_mutation` on `blocks`) can reuse the same
+ * validation the typed content tools apply, instead of writing unvalidated JSONB.
+ */
+export declare const availableCortexAiBlockTypes: readonly ["text", "heading", "image", "button", "posts_grid", "video_embed", "section", "form", "testimonial", "product_grid", "featured_product", "cart", "checkout", "product_details"];
+export type BlockType = (typeof availableCortexAiBlockTypes)[number];
+export type BlockValidationResult = {
+    errors: string[];
+    isValid: boolean;
+    warnings: string[];
+};
+export type BlockContentValidator = (blockType: BlockType, content: Record<string, any>) => BlockValidationResult;
+/** The slice of a tool context the validators care about. */
+export type BlockValidationContext = {
+    validateBlockContent?: BlockContentValidator;
+};
+export declare const cortexAiBlockTypeSchema: z.ZodEnum<{
+    text: "text";
+    section: "section";
+    heading: "heading";
+    image: "image";
+    button: "button";
+    posts_grid: "posts_grid";
+    video_embed: "video_embed";
+    form: "form";
+    testimonial: "testimonial";
+    product_grid: "product_grid";
+    featured_product: "featured_product";
+    cart: "cart";
+    checkout: "checkout";
+    product_details: "product_details";
+}>;
+export declare const customBlockSlugPatternSchema: z.ZodString;
+export declare const sectionBlockFallbackSchema: z.ZodObject<{
+    background: z.ZodObject<{
+        gradient: z.ZodOptional<z.ZodObject<{
+            direction: z.ZodOptional<z.ZodString>;
+            stops: z.ZodArray<z.ZodObject<{
+                color: z.ZodString;
+                position: z.ZodNumber;
+            }, z.core.$strip>>;
+            type: z.ZodEnum<{
+                linear: "linear";
+                radial: "radial";
+            }>;
+        }, z.core.$strip>>;
+        image: z.ZodOptional<z.ZodObject<{
+            alt_text: z.ZodOptional<z.ZodString>;
+            blur_data_url: z.ZodOptional<z.ZodString>;
+            external_url: z.ZodOptional<z.ZodString>;
+            height: z.ZodOptional<z.ZodNumber>;
+            media_id: z.ZodOptional<z.ZodString>;
+            object_key: z.ZodOptional<z.ZodString>;
+            overlay: z.ZodOptional<z.ZodObject<{
+                gradient: z.ZodObject<{
+                    direction: z.ZodOptional<z.ZodString>;
+                    stops: z.ZodArray<z.ZodObject<{
+                        color: z.ZodString;
+                        position: z.ZodNumber;
+                    }, z.core.$strip>>;
+                    type: z.ZodEnum<{
+                        linear: "linear";
+                        radial: "radial";
+                    }>;
+                }, z.core.$strip>;
+                type: z.ZodLiteral<"gradient">;
+            }, z.core.$strip>>;
+            position: z.ZodEnum<{
+                center: "center";
+                top: "top";
+                bottom: "bottom";
+                left: "left";
+                right: "right";
+            }>;
+            quality: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            size: z.ZodEnum<{
+                cover: "cover";
+                contain: "contain";
+            }>;
+            width: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        min_height: z.ZodOptional<z.ZodString>;
+        solid_color: z.ZodOptional<z.ZodString>;
+        theme: z.ZodOptional<z.ZodEnum<{
+            primary: "primary";
+            secondary: "secondary";
+            muted: "muted";
+            accent: "accent";
+            destructive: "destructive";
+        }>>;
+        type: z.ZodEnum<{
+            none: "none";
+            image: "image";
+            gradient: "gradient";
+            theme: "theme";
+            solid: "solid";
+        }>;
+    }, z.core.$strip>;
+    column_blocks: z.ZodArray<z.ZodArray<z.ZodObject<{
+        block_type: z.ZodUnion<readonly [z.ZodEnum<{
+            text: "text";
+            section: "section";
+            heading: "heading";
+            image: "image";
+            button: "button";
+            posts_grid: "posts_grid";
+            video_embed: "video_embed";
+            form: "form";
+            testimonial: "testimonial";
+            product_grid: "product_grid";
+            featured_product: "featured_product";
+            cart: "cart";
+            checkout: "checkout";
+            product_details: "product_details";
+        }>, z.ZodString]>;
+        content: z.ZodRecord<z.ZodString, z.ZodAny>;
+        temp_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    column_gap: z.ZodEnum<{
+        none: "none";
+        sm: "sm";
+        md: "md";
+        lg: "lg";
+        xl: "xl";
+    }>;
+    container_type: z.ZodEnum<{
+        container: "container";
+        "full-width": "full-width";
+        "container-sm": "container-sm";
+        "container-lg": "container-lg";
+        "container-xl": "container-xl";
+    }>;
+    padding: z.ZodObject<{
+        bottom: z.ZodEnum<{
+            none: "none";
+            sm: "sm";
+            md: "md";
+            lg: "lg";
+            xl: "xl";
+        }>;
+        top: z.ZodEnum<{
+            none: "none";
+            sm: "sm";
+            md: "md";
+            lg: "lg";
+            xl: "xl";
+        }>;
+    }, z.core.$strip>;
+    responsive_columns: z.ZodObject<{
+        desktop: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>;
+        mobile: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>;
+        tablet: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
+    }, z.core.$strip>;
+    vertical_alignment: z.ZodOptional<z.ZodEnum<{
+        start: "start";
+        center: "center";
+        end: "end";
+        stretch: "stretch";
+    }>>;
+}, z.core.$strip>;
+export declare const fallbackBlockSchemas: Record<BlockType, z.ZodTypeAny>;
+export declare function isValidBlockType(blockType: string): blockType is BlockType;
+export declare function validateCortexBlockContent(blockType: BlockType, content: Record<string, unknown>, context?: BlockValidationContext): BlockValidationResult;
+/**
+ * A block whose `block_type` is a `custom_block_definitions.slug` rather than a
+ * built-in type. Its `content` is the flat `{ field_key: value }` map the
+ * DynamicLayoutEngine renders from the definition's `fields`.
+ *
+ * Only the pieces of the definition the validator needs; the row carries more.
+ */
+export type CustomBlockDefinitionLike = {
+    fields?: unknown;
+    name?: string | null;
+    slug: string;
+};
+type CustomBlockFieldLike = {
+    key: string;
+    max_length?: number;
+    min_length?: number;
+    multiple?: boolean;
+    required?: boolean;
+    type: 'db_relation' | 'image_r2' | 'rich-text' | 'text';
+};
+export declare function readCustomBlockFields(definition: CustomBlockDefinitionLike): CustomBlockFieldLike[];
+/**
+ * Validate the `{ field_key: value }` content of a custom block instance against
+ * its definition. Mirrors what the block editor lets an author save:
+ *
+ *   text / rich-text  -> string (rich-text is HTML), honouring min/max length
+ *   image_r2          -> null or { object_key, url, ... } as the uploader stores it
+ *   db_relation       -> null, an id, or an array of ids when `multiple`
+ *
+ * Unknown keys are rejected rather than stripped, so a model that guesses a field
+ * name gets an error naming the real keys instead of silently losing its copy.
+ */
+export declare function validateCustomBlockInstanceContent(definition: CustomBlockDefinitionLike, content: unknown): BlockValidationResult;
+/** Load the custom block definitions a `block_type` slug may resolve to. */
+export declare function loadCustomBlockDefinitions(supabase: {
+    from: (table: string) => any;
+}): Promise<CustomBlockDefinitionLike[]>;
+export {};

package/lib/block-content-schemas.es.js

@@ -0,0 +1,246 @@
+import "./zod-config.es.js";
+import { z as t } from "zod";
+const g = [
+  "text",
+  "heading",
+  "image",
+  "button",
+  "posts_grid",
+  "video_embed",
+  "section",
+  "form",
+  "testimonial",
+  "product_grid",
+  "featured_product",
+  "cart",
+  "checkout",
+  "product_details"
+], d = t.enum(g), m = t.object({
+  direction: t.string().optional(),
+  stops: t.array(t.object({ color: t.string(), position: t.number() })),
+  type: t.enum(["linear", "radial"])
+}), p = t.object({
+  gradient: m.optional(),
+  image: t.object({
+    alt_text: t.string().optional(),
+    blur_data_url: t.string().optional(),
+    external_url: t.string().optional(),
+    height: t.number().optional(),
+    media_id: t.string().optional(),
+    object_key: t.string().optional(),
+    overlay: t.object({
+      gradient: m,
+      type: t.literal("gradient")
+    }).optional(),
+    position: t.enum(["center", "top", "bottom", "left", "right"]),
+    quality: t.number().nullable().optional(),
+    size: t.enum(["cover", "contain"]),
+    width: t.number().optional()
+  }).optional(),
+  min_height: t.string().optional(),
+  solid_color: t.string().optional(),
+  theme: t.enum(["primary", "secondary", "muted", "accent", "destructive"]).optional(),
+  type: t.enum(["none", "theme", "solid", "gradient", "image"])
+}), b = t.string().regex(/^[a-z][a-z0-9-]*$/), f = t.object({
+  block_type: t.union([d, b]),
+  content: t.record(t.string(), t.any()),
+  temp_id: t.string().optional()
+}), y = t.object({
+  background: p,
+  column_blocks: t.array(t.array(f)),
+  column_gap: t.enum(["none", "sm", "md", "lg", "xl"]),
+  container_type: t.enum(["full-width", "container", "container-sm", "container-lg", "container-xl"]),
+  padding: t.object({
+    bottom: t.enum(["none", "sm", "md", "lg", "xl"]),
+    top: t.enum(["none", "sm", "md", "lg", "xl"])
+  }),
+  responsive_columns: t.object({
+    desktop: t.union([t.literal(1), t.literal(2), t.literal(3), t.literal(4)]),
+    mobile: t.union([t.literal(1), t.literal(2)]),
+    tablet: t.union([t.literal(1), t.literal(2), t.literal(3)])
+  }),
+  vertical_alignment: t.enum(["start", "center", "end", "stretch"]).optional()
+}), h = {
+  button: t.object({
+    position: t.enum(["left", "center", "right"]).optional(),
+    size: t.enum(["default", "sm", "lg", "full"]).optional(),
+    text: t.string(),
+    url: t.string(),
+    variant: t.enum(["default", "outline", "secondary", "ghost", "link"]).optional()
+  }),
+  cart: t.object({}),
+  checkout: t.object({}),
+  featured_product: t.object({
+    imagePosition: t.enum(["left", "right"]).default("left"),
+    productId: t.string().min(1),
+    showBackground: t.boolean().default(!1)
+  }),
+  form: t.object({
+    fields: t.array(
+      t.object({
+        field_type: t.enum(["text", "email", "textarea", "select", "radio", "checkbox"]),
+        is_required: t.boolean(),
+        label: t.string(),
+        options: t.array(t.object({ label: t.string(), value: t.string() })).optional(),
+        placeholder: t.string().optional(),
+        temp_id: t.string()
+      })
+    ),
+    // Opaque handle into form_endpoints, which holds the destination server-side.
+    form_key: t.string().optional(),
+    // Legacy. Migration 27 moved every address out of block content; kept optional so
+    // an older payload still validates, and stripped before the block reaches a browser.
+    recipient_email: t.string().email().optional(),
+    submit_button_text: t.string(),
+    success_message: t.string()
+  }),
+  heading: t.object({
+    level: t.union([t.literal(1), t.literal(2), t.literal(3), t.literal(4), t.literal(5), t.literal(6)]),
+    textAlign: t.enum(["left", "center", "right", "justify"]).optional(),
+    // Mirrors TextColorSchema in apps/nextblock/lib/blocks/blockRegistry.ts —
+    // a theme token, or a literal CSS colour from the block editor's picker.
+    // libs/* cannot import from the app, so the union is restated here.
+    textColor: t.union([
+      t.enum(["foreground", "primary", "secondary", "accent", "muted", "destructive", "background"]),
+      t.string().regex(
+        /^(#(?:[0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})|rgba?\([^)]+\)|hsla?\([^)]+\))$/i,
+        "Must be a hex, rgb(a) or hsl(a) colour"
+      )
+    ]).optional().describe("Prefer a theme token so the heading adapts to dark mode; use a CSS colour only when the brand requires an exact value"),
+    text_content: t.string()
+  }),
+  image: t.object({
+    alt_text: t.string().optional(),
+    caption: t.string().optional(),
+    external_url: t.string().nullable().optional(),
+    height: t.number().nullable().optional(),
+    media_id: t.string().nullable().optional(),
+    object_key: t.string().nullable().optional(),
+    width: t.number().nullable().optional()
+  }),
+  posts_grid: t.object({
+    columns: t.number().min(1).max(6),
+    postsPerPage: t.number().min(1).max(50),
+    showPagination: t.boolean(),
+    title: t.string().optional()
+  }),
+  product_details: t.object({}),
+  product_grid: t.object({
+    categoryId: t.string().optional(),
+    categoryIds: t.array(t.string()).max(20).optional(),
+    // 0 = unlimited (every match on one page).
+    limit: t.number().min(0).max(48).default(6),
+    productIds: t.array(t.string()).max(24).optional(),
+    showPagination: t.boolean().default(!1),
+    title: t.string().optional(),
+    type: t.enum(["latest", "category", "manual"]).default("latest")
+  }),
+  section: y,
+  testimonial: t.object({
+    author_name: t.string().min(1),
+    author_title: t.string().optional(),
+    image_url: t.string().url().optional().or(t.literal("")),
+    quote: t.string().min(1)
+  }),
+  text: t.object({
+    html_content: t.string()
+  }),
+  video_embed: t.object({
+    autoplay: t.boolean().optional(),
+    controls: t.boolean().optional(),
+    title: t.string().optional(),
+    url: t.string()
+  })
+};
+function $(o) {
+  return g.includes(o);
+}
+function _(o) {
+  return typeof o?.validateBlockContent == "function" ? o.validateBlockContent : null;
+}
+function v(o, n, r) {
+  const l = _(r);
+  if (l)
+    return l(o, n);
+  const i = h[o].safeParse(n);
+  return i.success ? { errors: [], isValid: !0, warnings: [] } : {
+    errors: i.error.issues.map((s) => {
+      const e = s.path.join(".");
+      return e ? `${e}: ${s.message}` : s.message;
+    }),
+    isValid: !1,
+    warnings: []
+  };
+}
+function k(o) {
+  return Array.isArray(o.fields) ? o.fields.filter(
+    (n) => !!n && typeof n == "object" && typeof n.key == "string" && typeof n.type == "string"
+  ) : [];
+}
+function j(o) {
+  return o == null || typeof o == "string" && o.trim() === "" || Array.isArray(o) && o.length === 0;
+}
+function B(o, n) {
+  if (!n || typeof n != "object" || Array.isArray(n))
+    return {
+      errors: ["content must be a JSON object of { field_key: value } pairs."],
+      isValid: !1,
+      warnings: []
+    };
+  const r = k(o), l = new Set(r.map((e) => e.key)), i = [], s = [];
+  for (const e of Object.keys(n))
+    l.has(e) || i.push(
+      `Unknown field "${e}" for custom block "${o.slug}". Known fields: ${[...l].join(", ") || "(none)"}.`
+    );
+  for (const e of r) {
+    const a = n[e.key];
+    if (j(a)) {
+      e.required && i.push(`Field "${e.key}" is required.`);
+      continue;
+    }
+    if (e.type === "text" || e.type === "rich-text") {
+      if (typeof a != "string") {
+        i.push(`Field "${e.key}" must be a string${e.type === "rich-text" ? " of HTML" : ""}.`);
+        continue;
+      }
+      typeof e.max_length == "number" && a.length > e.max_length && i.push(`Field "${e.key}" exceeds its ${e.max_length}-character limit.`), typeof e.min_length == "number" && a.length < e.min_length && i.push(`Field "${e.key}" is shorter than its ${e.min_length}-character minimum.`);
+      continue;
+    }
+    if (e.type === "image_r2") {
+      const c = a;
+      (typeof a != "object" || Array.isArray(a) || typeof c.object_key != "string" || typeof c.url != "string") && i.push(
+        `Field "${e.key}" must be an uploaded image object with object_key and url (upload it with upload_media first) or null.`
+      );
+      continue;
+    }
+    if (e.type === "db_relation") {
+      const c = (u) => typeof u == "string" || typeof u == "number";
+      e.multiple ? (!Array.isArray(a) || !a.every(c)) && i.push(`Field "${e.key}" must be an array of related record ids.`) : c(a) || i.push(`Field "${e.key}" must be a single related record id.`);
+      continue;
+    }
+    s.push(`Field "${e.key}" has an unrecognised type "${String(e.type)}"; it was not validated.`);
+  }
+  return { errors: i, isValid: i.length === 0, warnings: s };
+}
+async function A(o) {
+  const { data: n, error: r } = await o.from("custom_block_definitions").select("slug, name, fields");
+  if (r)
+    throw new Error(
+      `Could not read the custom block definitions: ${typeof r == "object" && r && "message" in r ? String(r.message) : String(r)}`
+    );
+  return (Array.isArray(n) ? n : []).filter(
+    (l) => !!l && typeof l.slug == "string"
+  );
+}
+export {
+  g as availableCortexAiBlockTypes,
+  d as cortexAiBlockTypeSchema,
+  b as customBlockSlugPatternSchema,
+  h as fallbackBlockSchemas,
+  $ as isValidBlockType,
+  A as loadCustomBlockDefinitions,
+  k as readCustomBlockFields,
+  y as sectionBlockFallbackSchema,
+  v as validateCortexBlockContent,
+  B as validateCustomBlockInstanceContent
+};

package/lib/mcp-tool-registry.cjs.js

@@ -1,4 +1,6 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const f=require("./ai-global-agent-tools.cjs.js");require("./zod-config.cjs.js");const w=require("zod"),i={create_cms_page:"write",create_cms_post:"write",create_cms_product:"write",create_custom_block:"write",delete_cms_item:"write",delete_custom_block:"write",describe_database_schema:"read",execute_cms_action_plan:"write",execute_database_action_plan:"write",execute_database_mutation:"write",fetch_ecommerce_stats:"read",fetch_url_content:"read",insert_content_block:"write",list_custom_blocks:"read",list_media:"read",list_product_categories:"read",list_site_script_revisions:"read",list_site_scripts:"read",list_site_themes:"read",manage_language:"write",manage_product_category:"write",manage_product_variants:"write",manage_site_script:"write",manage_site_theme:"write",prepare_delete_cms_item:"read",publish_content_draft:"write",read_current_cms_item:"read",read_database_records:"read",revert_site_script:"write",rewrite_page_draft:"write",search_documentation:"read",search_stock_photos:"read",set_content_images:"write",translate_content_bulk:"write",translate_page:"write",update_cms_item_field:"write",upload_media:"write",update_content_block:"write",update_current_cms_fields:"write",update_custom_block:"write",update_footer:"write",update_global_css:"write",update_navigation_bar:"write",update_section_column_block:"write"},s={generate_jsonb_layout:{canonical:"rewrite_page_draft",description:"Generate a complete, strictly-validated JSONB block layout and write it into a target page or post. Blocks are normalized and validated against the NextBlock block schema, then staged as a Live Draft on the target record — nothing goes live until an editor publishes the draft, and publishing snapshots a revision so the change is reversible. Use for whole-page builds and redesigns. Alias of `rewrite_page_draft`.",title:"Generate JSONB layout"},get_database_schema:{canonical:"describe_database_schema",description:"Return the current CMS database structure: every table Cortex AI may read or mutate, its columns, primary keys, and whether it is read-only. Pair with `list_custom_blocks` for the active data-defined block definitions and with the `cortex://schema/blocks` resource for the built-in block types. Read-only. Alias of `describe_database_schema`.",title:"Get database schema"},query_site_analytics:{canonical:"fetch_ecommerce_stats",description:"Query quantitative site analytics: revenue, order counts, order-status breakdowns, and top-selling products over a time range. Read-only. For inventory levels and post/page metrics that this report does not cover, use `read_database_records` against the `products`, `product_variants`, `posts`, or `pages` tables. Alias of `fetch_ecommerce_stats`.",title:"Query site analytics"},search_stock_media:{canonical:"search_stock_photos",description:"Search free stock media (Pexels, then Unsplash) for contextually relevant imagery, returning direct image URLs with dimensions, alt text, and photographer attribution. Drop a returned `url` straight into an image block's `external_url` or a section background. Read-only and zero cost. Requires a stock provider key in CMS Settings → Cortex AI. Alias of `search_stock_photos`.",title:"Search stock media"},update_site_navigation:{canonical:"update_navigation_bar",description:'Alter the public site navigation: header menu items and their nested child hierarchy, per locale. Use mode "append" to add links while preserving the existing menu, "update" to rename or re-point one link, and "replace" only when rebuilding the whole menu. For footer links and copyright use `update_footer`. Alias of `update_navigation_bar`.',title:"Update site navigation"}};function g(e){return e in s?s[e].canonical:e in i?e:null}function b(e){const t=g(e);return t?i[t]:null}function c(e,t){const r=b(t);return r?r==="read"?e.length>0:e.includes("write"):!1}function _(e){return e.split("_").map((r,o)=>o===0?r.charAt(0).toUpperCase()+r.slice(1):r).join(" ")}function m(e){const t={additionalProperties:!1,type:"object"};if(!e||typeof e!="object")return t;try{const r=w.z.toJSONSchema(e,{cycles:"ref",io:"input",reused:"inline",target:"draft-2020-12",unrepresentable:"any"});return delete r.$schema,r.type==="object"?r:t}catch{return t}}function l(e){return f.createCortexGlobalAgentTools(e)}function C(e){const t=Object.keys(l(e)),r=Object.keys(i);return{missingFromRegistry:r.filter(o=>!t.includes(o)),unclassified:t.filter(o=>!r.includes(o))}}function T(e){const t=l(e.context),r=[];for(const[o,n]of Object.entries(t))!(o in i)||!c(e.scopes,o)||r.push({description:n.description??`Cortex AI ${_(o)} tool.`,inputSchema:m(n.inputSchema),name:o,title:_(o)});for(const[o,n]of Object.entries(s)){const a=t[n.canonical];!a||!c(e.scopes,o)||r.push({description:n.description,inputSchema:m(a.inputSchema),name:o,title:n.title})}return r.sort((o,n)=>o.name.localeCompare(n.name))}function h(e,t){return{content:[{text:e,type:"text"}],isError:t}}function v(e){return e.issues.map(t=>`${t.path.length>0?t.path.join("."):"(root)"}: ${t.message}`).join("; ")}class p extends Error{constructor(t){super(`Unknown tool: ${t}`),this.name="CortexMcpUnknownToolError"}}class y extends Error{constructor(t){super(`Tool "${t}" requires the "write" scope. This MCP token is read-only — mint a read+write token in CMS Settings → Cortex AI.`),this.name="CortexMcpForbiddenToolError"}}async function S(e){const t=g(e.name);if(!t)throw new p(e.name);if(!c(e.scopes,e.name))throw new y(e.name);const o=l(e.context)[t];if(!o||typeof o.execute!="function")throw new p(e.name);const n=e.args&&typeof e.args=="object"?e.args:{};if(o.inputSchema&&typeof o.inputSchema.safeParse=="function"){const a=o.inputSchema.safeParse(n);if(!a.success)return h(`Invalid arguments for "${e.name}": ${v(a.error)}`,!0)}try{const a=await o.execute(n),u=JSON.stringify(a??{success:!0},null,2),d=a&&typeof a=="object"&&!Array.isArray(a)?a:null,k=d?.success===!1;return{content:[{text:u,type:"text"}],isError:k,...d?{structuredContent:d}:{}}}catch(a){const u=a instanceof Error?a.message:String(a);return h(`Tool "${e.name}" failed: ${u}`,!0)}}const M=[{description:"The CMS database structure Cortex AI can read and mutate: tables, columns, primary keys, and read-only flags.",mimeType:"application/json",name:"database-schema",title:"NextBlock database schema",uri:"cortex://schema/database"},{description:"The built-in NextBlock block types available when composing page, post, and product layouts.",mimeType:"application/json",name:"block-types",title:"NextBlock block types",uri:"cortex://schema/blocks"},{description:"Data-defined custom block definitions registered in this workspace, keyed by the slug used as a block instance `block_type`.",mimeType:"application/json",name:"custom-blocks",title:"NextBlock custom block definitions",uri:"cortex://schema/custom-blocks"}];async function O(e){const t=l(e.context);if(e.uri==="cortex://schema/database"){const r=await t.describe_database_schema?.execute?.({includeReadOnly:!0});return{mimeType:"application/json",text:JSON.stringify(r??{},null,2),uri:e.uri}}if(e.uri==="cortex://schema/blocks")return{mimeType:"application/json",text:JSON.stringify({blockTypes:f.availableCortexAiBlockTypes},null,2),uri:e.uri};if(e.uri==="cortex://schema/custom-blocks"){const r=await t.list_custom_blocks?.execute?.({});return{mimeType:"application/json",text:JSON.stringify(r??{},null,2),uri:e.uri}}return null}const x=[{arguments:[{description:"What the page is for, and any brand or tone notes.",name:"brief",required:!0},{description:'Slug of the page or post to rewrite, e.g. "home".',name:"slug",required:!0}],description:"Build or redesign a NextBlock page from a brief, following the section-based layout recipe, and stage it as a reviewable Live Draft.",name:"build-page",title:"Build a NextBlock page"},{arguments:[{description:"Source URL to draw structure and copy from.",name:"url",required:!0},{description:"Slug of the page to write the result into.",name:"slug",required:!0}],description:"Read an external page and rebuild an equivalent NextBlock page from it, reusing its imagery where available.",name:"clone-from-url",title:"Rebuild a page from a URL"},{arguments:[{description:'Target language code, e.g. "fr".',name:"languageCode",required:!0},{description:"Slug of the page or post to translate.",name:"slug",required:!0}],description:"Translate an existing page or post into another language, preserving its layout and imagery.",name:"translate-content",title:"Translate a page or post"}],R={"build-page":e=>[`Build the NextBlock page with slug "${e.slug??"<slug>"}" from this brief:`,"",e.brief??"<brief>","","Process:","1. Call get_database_schema and read_current_cms_item (or read_database_records on `pages`) to ground yourself in what exists.",'2. Compose the page from `section` blocks: one column entry per grid track, the first section a hero, alternating none / theme:"muted" / theme:"primary" backgrounds for rhythm. Use discrete heading blocks rather than <h2> inside text HTML.',"3. Call search_stock_media for real photography; copy each photo's attribution fields onto the image block.","4. Write the result with generate_jsonb_layout. It stages a Live Draft — tell the user to preview and publish it."].join(`
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const k=require("./ai-global-agent-tools.cjs.js"),x=require("./block-content-schemas.cjs.js");require("./zod-config.cjs.js");const v=require("zod"),n={create_cms_page:"write",create_cms_post:"write",create_cms_product:"write",create_custom_block:"write",delete_cms_item:"write",delete_custom_block:"write",describe_database_schema:"read",execute_cms_action_plan:"write",execute_database_action_plan:"write",execute_database_mutation:"write",fetch_ecommerce_stats:"read",fetch_url_content:"read",finish_site_build:"write",get_site_overview:"read",insert_content_block:"write",list_custom_blocks:"read",list_media:"read",list_product_categories:"read",list_site_script_revisions:"read",list_site_scripts:"read",list_site_themes:"read",manage_language:"write",manage_product_category:"write",manage_product_variants:"write",manage_site_script:"write",manage_site_theme:"write",prepare_delete_cms_item:"read",publish_content_draft:"write",read_current_cms_item:"read",read_database_records:"read",reset_site_content:"write",revert_site_script:"write",rewrite_page_draft:"write",save_site_brief:"write",search_documentation:"read",search_stock_photos:"read",set_content_images:"write",start_site_build:"write",translate_content_bulk:"write",translate_page:"write",update_cms_item_field:"write",upload_media:"write",update_content_block:"write",update_current_cms_fields:"write",update_custom_block:"write",update_footer:"write",update_global_css:"write",update_navigation_bar:"write",update_section_column_block:"write",update_site_identity:"write"},s={generate_jsonb_layout:{canonical:"rewrite_page_draft",description:"Generate a complete, strictly-validated JSONB block layout and write it into a target page or post. Blocks are normalized and validated against the NextBlock block schema, then staged as a Live Draft on the target record — nothing goes live until an editor publishes the draft, and publishing snapshots a revision so the change is reversible. Use for whole-page builds and redesigns. Alias of `rewrite_page_draft`.",title:"Generate JSONB layout"},get_database_schema:{canonical:"describe_database_schema",description:"Return the current CMS database structure: every table Cortex AI may read or mutate, its columns, primary keys, and whether it is read-only. Pair with `list_custom_blocks` for the active data-defined block definitions and with the `cortex://schema/blocks` resource for the built-in block types. Read-only. Alias of `describe_database_schema`.",title:"Get database schema"},query_site_analytics:{canonical:"fetch_ecommerce_stats",description:"Query quantitative site analytics: revenue, order counts, order-status breakdowns, and top-selling products over a time range. Read-only. For inventory levels and post/page metrics that this report does not cover, use `read_database_records` against the `products`, `product_variants`, `posts`, or `pages` tables. Alias of `fetch_ecommerce_stats`.",title:"Query site analytics"},search_stock_media:{canonical:"search_stock_photos",description:"Search free stock media (Pexels, then Unsplash) for contextually relevant imagery, returning direct image URLs with dimensions, alt text, and photographer attribution. Drop a returned `url` straight into an image block's `external_url` or a section background. Read-only and zero cost. Requires a stock provider key in CMS Settings → Cortex AI. Alias of `search_stock_photos`.",title:"Search stock media"},update_site_navigation:{canonical:"update_navigation_bar",description:'Alter the public site navigation: header menu items and their nested child hierarchy, per locale. Use mode "append" to add links while preserving the existing menu, "update" to rename or re-point one link, and "replace" only when rebuilding the whole menu. For footer links and copyright use `update_footer`. Alias of `update_navigation_bar`.',title:"Update site navigation"}};function h(e){return e in s?s[e].canonical:e in n?e:null}function b(e){const t=h(e);return t?n[t]:null}function c(e,t){const r=b(t);return r?r==="read"?e.length>0:e.includes("write"):!1}function g(e){return e.split("_").map((r,a)=>a===0?r.charAt(0).toUpperCase()+r.slice(1):r).join(" ")}function _(e){const t={additionalProperties:!1,type:"object"};if(!e||typeof e!="object")return t;try{const r=v.z.toJSONSchema(e,{cycles:"ref",io:"input",reused:"inline",target:"draft-2020-12",unrepresentable:"any"});return delete r.$schema,r.type==="object"?r:t}catch{return t}}function l(e){return k.createCortexGlobalAgentTools(e)}function C(e){const t=Object.keys(l(e)),r=Object.keys(n);return{missingFromRegistry:r.filter(a=>!t.includes(a)),unclassified:t.filter(a=>!r.includes(a))}}function T(e){const t=l(e.context),r=[];for(const[a,i]of Object.entries(t))!(a in n)||!c(e.scopes,a)||r.push({description:i.description??`Cortex AI ${g(a)} tool.`,inputSchema:_(i.inputSchema),name:a,title:g(a)});for(const[a,i]of Object.entries(s)){const o=t[i.canonical];!o||!c(e.scopes,a)||r.push({description:i.description,inputSchema:_(o.inputSchema),name:a,title:i.title})}return r.sort((a,i)=>a.name.localeCompare(i.name))}function m(e,t){return{content:[{text:e,type:"text"}],isError:t}}function S(e){return e.issues.map(t=>`${t.path.length>0?t.path.join("."):"(root)"}: ${t.message}`).join("; ")}class p extends Error{constructor(t){super(`Unknown tool: ${t}`),this.name="CortexMcpUnknownToolError"}}class f extends Error{constructor(t){super(`Tool "${t}" requires the "write" scope. This MCP token is read-only — mint a read+write token in CMS Settings → Cortex AI.`),this.name="CortexMcpForbiddenToolError"}}async function M(e){const t=h(e.name);if(!t)throw new p(e.name);if(!c(e.scopes,e.name))throw new f(e.name);const a=l(e.context)[t];if(!a||typeof a.execute!="function")throw new p(e.name);const i=e.args&&typeof e.args=="object"?e.args:{};if(a.inputSchema&&typeof a.inputSchema.safeParse=="function"){const o=a.inputSchema.safeParse(i);if(!o.success)return m(`Invalid arguments for "${e.name}": ${S(o.error)}`,!0)}try{const o=await a.execute(i),u=JSON.stringify(o??{success:!0},null,2),d=o&&typeof o=="object"&&!Array.isArray(o)?o:null,w=d?.success===!1;return{content:[{text:u,type:"text"}],isError:w,...d?{structuredContent:d}:{}}}catch(o){const u=o instanceof Error?o.message:String(o);return m(`Tool "${e.name}" failed: ${u}`,!0)}}const O=[{description:"The CMS database structure Cortex AI can read and mutate: tables, columns, primary keys, and read-only flags.",mimeType:"application/json",name:"database-schema",title:"NextBlock database schema",uri:"cortex://schema/database"},{description:"The built-in NextBlock block types available when composing page, post, and product layouts.",mimeType:"application/json",name:"block-types",title:"NextBlock block types",uri:"cortex://schema/blocks"},{description:"Data-defined custom block definitions registered in this workspace, keyed by the slug used as a block instance `block_type`.",mimeType:"application/json",name:"custom-blocks",title:"NextBlock custom block definitions",uri:"cortex://schema/custom-blocks"}];async function R(e){const t=l(e.context);if(e.uri==="cortex://schema/database"){const r=await t.describe_database_schema?.execute?.({includeReadOnly:!0});return{mimeType:"application/json",text:JSON.stringify(r??{},null,2),uri:e.uri}}if(e.uri==="cortex://schema/blocks")return{mimeType:"application/json",text:JSON.stringify({blockTypes:x.availableCortexAiBlockTypes},null,2),uri:e.uri};if(e.uri==="cortex://schema/custom-blocks"){const r=await t.list_custom_blocks?.execute?.({});return{mimeType:"application/json",text:JSON.stringify(r??{},null,2),uri:e.uri}}return null}const y=[{arguments:[{description:'Everything known about the client and the site they want: business, audience, goals, pages (or "one landing page"), languages, brand, contact details. Leave blank to be asked.',name:"brief",required:!1}],description:"Build (or rebuild) the whole NextBlock site from a brief: remove the sample content, set the identity and theme, create and publish every page, the menus, the footer, and the translations.",name:"build-site",title:"Build the whole site"},{arguments:[{description:"What the page is for, and any brand or tone notes.",name:"brief",required:!0},{description:'Slug of the page or post to rewrite, e.g. "home".',name:"slug",required:!0}],description:"Build or redesign a NextBlock page from a brief, following the section-based layout recipe, and stage it as a reviewable Live Draft.",name:"build-page",title:"Build a NextBlock page"},{arguments:[{description:"Source URL to draw structure and copy from.",name:"url",required:!0},{description:"Slug of the page to write the result into.",name:"slug",required:!0}],description:"Read an external page and rebuild an equivalent NextBlock page from it, reusing its imagery where available.",name:"clone-from-url",title:"Rebuild a page from a URL"},{arguments:[{description:'Target language code, e.g. "fr".',name:"languageCode",required:!0},{description:"Slug of the page or post to translate.",name:"slug",required:!0}],description:"Translate an existing page or post into another language, preserving its layout and imagery.",name:"translate-content",title:"Translate a page or post"}],N={"build-site":e=>["Build the whole NextBlock site for this client.","",e.brief?.trim()?`Brief:
+${e.brief}`:"No brief was given: first ask, in one short numbered list, about the business and what it does, the audience and the one action visitors should take, the site shape (one landing page or which pages), the languages, brand colours and tone, contact details, and whether existing content is kept.","","Process:","1. Call get_site_overview to see what exists, the active languages, and whether the NextBlock demo content is still present. Record what you know with save_site_brief.","2. Present the plan (what is removed, every page with its sections, menus, footer, theme, languages) and call start_site_build with `summary`, `brief`, and `reset` (keepLanguages = the languages wanted) unless existing content is kept. Over MCP the host approves the call; there is no chat confirmation.",'3. Build: update_site_identity; manage_language as needed; manage_site_theme with the brand colours; search_stock_media for imagery when available; rewrite the empty "home" page with generate_jsonb_layout then publish_content_draft; create_cms_page (status "published") for every other page; update_site_navigation (mode "replace") and update_footer for every language; translate_content_bulk for each extra language.',"4. Call finish_site_build with a summary, then report every page with its URL.","Write real copy from the brief, never placeholders. Every page must exist in every active language."].join(`
+`),"build-page":e=>[`Build the NextBlock page with slug "${e.slug??"<slug>"}" from this brief:`,"",e.brief??"<brief>","","Process:","1. Call get_database_schema and read_current_cms_item (or read_database_records on `pages`) to ground yourself in what exists.",'2. Compose the page from `section` blocks: one column entry per grid track, the first section a hero, alternating none / theme:"muted" / theme:"primary" backgrounds for rhythm. Use discrete heading blocks rather than <h2> inside text HTML.',"3. Call search_stock_media for real photography; copy each photo's attribution fields onto the image block.","4. Write the result with generate_jsonb_layout. It stages a Live Draft — tell the user to preview and publish it."].join(`
 `),"clone-from-url":e=>[`Rebuild the NextBlock page "${e.slug??"<slug>"}" based on ${e.url??"<url>"}.`,"","Process:","1. Call fetch_url_content on the URL first. Use its headings, text, and mainImage — never invent an image URL.","2. Map the source structure onto NextBlock `section` blocks; do not copy its markup verbatim.","3. Write the result with generate_jsonb_layout so it lands as a reviewable Live Draft."].join(`
 `),"translate-content":e=>[`Translate the page or post "${e.slug??"<slug>"}" into "${e.languageCode??"<languageCode>"}".`,"","Use the translate_page tool: it copies layout, structure, and imagery automatically and links the copy to the original translation group. Supply only the text translations — every visible string, including headings, paragraph text, button labels, image alt text, and captions. Do not rebuild the layout and do not search for new imagery."].join(`
-`)};function j(e){const t=x.find(o=>o.name===e.name),r=R[e.name];return!t||!r?null:{description:t.description,messages:[{content:{text:r(e.args??{}),type:"text"},role:"user"}]}}exports.CORTEX_MCP_PROMPTS=x;exports.CORTEX_MCP_RESOURCES=M;exports.CORTEX_MCP_TOOL_ALIASES=s;exports.CORTEX_MCP_TOOL_KINDS=i;exports.CortexMcpForbiddenToolError=y;exports.CortexMcpUnknownToolError=p;exports.assertCortexMcpToolCoverage=C;exports.buildCortexMcpToolDefinitions=T;exports.callCortexMcpTool=S;exports.cortexMcpScopesAllow=c;exports.getCortexMcpPrompt=j;exports.getCortexMcpToolKind=b;exports.readCortexMcpResource=O;exports.resolveCortexMcpToolName=g;
+`)};function j(e){const t=y.find(a=>a.name===e.name),r=N[e.name];return!t||!r?null:{description:t.description,messages:[{content:{text:r(e.args??{}),type:"text"},role:"user"}]}}exports.CORTEX_MCP_PROMPTS=y;exports.CORTEX_MCP_RESOURCES=O;exports.CORTEX_MCP_TOOL_ALIASES=s;exports.CORTEX_MCP_TOOL_KINDS=n;exports.CortexMcpForbiddenToolError=f;exports.CortexMcpUnknownToolError=p;exports.assertCortexMcpToolCoverage=C;exports.buildCortexMcpToolDefinitions=T;exports.callCortexMcpTool=M;exports.cortexMcpScopesAllow=c;exports.getCortexMcpPrompt=j;exports.getCortexMcpToolKind=b;exports.readCortexMcpResource=R;exports.resolveCortexMcpToolName=h;

package/lib/mcp-tool-registry.d.ts

@@ -39,6 +39,8 @@ export declare const CORTEX_MCP_TOOL_KINDS: {
     readonly execute_database_mutation: "write";
     readonly fetch_ecommerce_stats: "read";
     readonly fetch_url_content: "read";
+    readonly finish_site_build: "write";
+    readonly get_site_overview: "read";
     readonly insert_content_block: "write";
     readonly list_custom_blocks: "read";
     readonly list_media: "read";
@@ -55,11 +57,14 @@ export declare const CORTEX_MCP_TOOL_KINDS: {
     readonly publish_content_draft: "write";
     readonly read_current_cms_item: "read";
     readonly read_database_records: "read";
+    readonly reset_site_content: "write";
     readonly revert_site_script: "write";
     readonly rewrite_page_draft: "write";
+    readonly save_site_brief: "write";
     readonly search_documentation: "read";
     readonly search_stock_photos: "read";
     readonly set_content_images: "write";
+    readonly start_site_build: "write";
     readonly translate_content_bulk: "write";
     readonly translate_page: "write";
     readonly update_cms_item_field: "write";
@@ -71,6 +76,7 @@ export declare const CORTEX_MCP_TOOL_KINDS: {
     readonly update_global_css: "write";
     readonly update_navigation_bar: "write";
     readonly update_section_column_block: "write";
+    readonly update_site_identity: "write";
 };
 export type CortexMcpCanonicalToolName = keyof typeof CORTEX_MCP_TOOL_KINDS;
 /**
@@ -195,6 +201,15 @@ export declare function readCortexMcpResource(params: {
     uri: string;
 } | null>;
 export declare const CORTEX_MCP_PROMPTS: readonly [{
+    readonly arguments: readonly [{
+        readonly description: "Everything known about the client and the site they want: business, audience, goals, pages (or \"one landing page\"), languages, brand, contact details. Leave blank to be asked.";
+        readonly name: "brief";
+        readonly required: false;
+    }];
+    readonly description: "Build (or rebuild) the whole NextBlock site from a brief: remove the sample content, set the identity and theme, create and publish every page, the menus, the footer, and the translations.";
+    readonly name: "build-site";
+    readonly title: "Build the whole site";
+}, {
     readonly arguments: readonly [{
         readonly description: "What the page is for, and any brand or tone notes.";
         readonly name: "brief";