@nextblock-cms/cortex 0.14.6 → 0.15.0

package/lib/cortex-widget-schema.cjs.js

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("@nextblock-cms/utils/custom-blocks");require("./zod-config.cjs.js");const e=require("zod"),r=["pages","posts","products","media","categories","profiles","languages"],d=e.z.enum(["article","aside","blockquote","div","figure","figcaption","h2","h3","img","p","section","span"]).describe("A safe semantic element supported by the dynamic layout renderer."),c=e.z.string().trim().max(4e3).describe("Tailwind utility classes only. Do not include CSS, style tags, or JavaScript."),l=e.z.strictObject({description:e.z.string().trim().max(500).optional(),key:o.customBlockFieldKeySchema.describe("Lowercase snake_case field key."),label:e.z.string().trim().min(1).max(120),required:e.z.boolean().default(!1)}),m=l.extend({default_value:e.z.string().max(5e3).optional(),max_length:e.z.number().int().positive().max(1e4).optional(),min_length:e.z.number().int().min(0).max(1e4).optional(),placeholder:e.z.string().max(250).optional(),type:e.z.literal("text")}),u=l.extend({default_value:e.z.string().max(5e4).optional(),placeholder:e.z.string().max(250).optional(),type:e.z.literal("rich-text")}),p=l.extend({accept:e.z.array(e.z.string().trim().min(1).max(120)).max(20).optional(),default_value:e.z.strictObject({alt:e.z.string().max(300).optional(),file_name:e.z.string().trim().min(1).max(255).optional(),file_type:e.z.string().trim().min(1).max(120).optional(),height:e.z.number().int().positive().optional(),object_key:e.z.string().trim().min(1).max(1024),size_bytes:e.z.number().int().positive().optional(),url:e.z.string().trim().min(1).max(2048),width:e.z.number().int().positive().optional()}).optional(),max_bytes:e.z.number().int().positive().max(50*1024*1024).optional(),type:e.z.literal("image_r2")}),f=l.extend({default_value:e.z.union([e.z.string(),e.z.array(e.z.string()),e.z.null()]).optional(),display_column:e.z.string().trim().min(1).max(80).default("title"),filters:e.z.record(e.z.string(),e.z.unknown()).optional(),multiple:e.z.boolean().default(!1),table:e.z.enum(r),type:e.z.literal("db_relation"),value_column:e.z.string().trim().min(1).max(80).default("id")}),y=e.z.discriminatedUnion("type",[m,u,p,f]).describe("A NextBlock custom block field. Allowed types: text, rich-text, image_r2, db_relation."),s=e.z.lazy(()=>e.z.discriminatedUnion("type",[e.z.strictObject({as:d.optional(),children:e.z.array(s).max(200).default([]),className:c.optional(),type:e.z.literal("container")}),e.z.strictObject({as:d.optional(),className:c.optional(),column:e.z.string().trim().min(1).max(80).optional().describe("For a db_relation field, the related record column to display (e.g. title, price)."),emptyFallback:e.z.string().max(300).optional(),field_key:o.customBlockFieldKeySchema,type:e.z.literal("field_render")})])),_=e.z.strictObject({context:e.z.string().trim().max(3e3).optional(),modelId:e.z.string().trim().min(1).max(200).optional(),prompt:e.z.string().trim().min(3).max(4e3)});function g(t){return t.type==="field_render"?[t.field_key]:t.children.flatMap(i=>g(i))}function k(t,i){const n=new Set;t.fields.forEach((a,b)=>{n.has(a.key)&&i.addIssue({code:"custom",message:`Duplicate field key "${a.key}".`,path:["fields",b,"key"]}),n.add(a.key)});for(const a of g(t.layout_schema))n.has(a)||i.addIssue({code:"custom",message:`Layout references unknown field "${a}".`,path:["layout_schema"]})}const h=e.z.strictObject({description:e.z.string().trim().max(1e3).default(""),fields:e.z.array(y).min(1).max(80),is_original:e.z.boolean().default(!0),layout_schema:s,name:e.z.string().trim().min(1).max(160),slug:o.customBlockSlugSchema.describe("Lowercase kebab-case slug.")}).superRefine(k).describe("A complete NextBlock custom block definition stored as database JSONB.");function x(t){const i=h.parse(t);return o.customBlockDefinitionCreateSchema.parse({...i,is_original:!0})}function z(){return["You are NextBlock Cortex, an expert web platform engineer building database-rendered custom CMS widgets.","Return ONLY one clean raw JSON object with the exact structure described in the user message. Do not include markdown fences, comments, prose, or explanatory text.","Never emit TSX, JSX, React components, JavaScript, CSS blocks, style attributes, script tags, or runtime code.","Use only these field types: text, rich-text, image_r2, db_relation.",`Use db_relation.table only from this allowlist: ${r.join(", ")}.`,"Use lowercase kebab-case for slug and lowercase snake_case for field keys.","Build layout_schema as a self-referential tree: container nodes may contain nested container or field_render nodes to any needed depth.","Use Tailwind utility classes in className strings. Use responsive utilities where helpful.",'The "as" property of any node MUST be exactly one of: article, aside, blockquote, div, figure, figcaption, h2, h3, img, p, section, span. Never use a, button, ul, ol, li, table, or any other tag. For a call-to-action or "more info" button, use a span or p styled with button-like Tailwind classes (rounded, padded, colored background).',"Every field_render.field_key must match one field key exactly.","For relation fields, set value_column to id and set display_column to a column that actually exists on the chosen table: use title for pages, posts, and products; sku for product_variants; full_name for profiles; name for categories and languages; file_name for media. Do not invent display columns.",`Entity images: when a block displays an image that belongs to a related product, page, or post (for example a product card photo or a post thumbnail), do NOT add an image_r2 upload field for it. Instead add a single db_relation field to that table (products, product_variants, pages, or posts) and add a field_render node that references it with "as": "img". The renderer automatically resolves the related record's primary image — a product or variant main_image/object_key, or a page/post feature image — so keep the table's normal display_column (for example title for a products relation).`,'You may reference the same db_relation field from more than one field_render node: for example one node with "as": "img" for the image and another text node for its title, plus the relation value to drive a "more info" link. This builds a product/page/post card from a single relation field.',`To display a SPECIFIC column of a related record (its title, price, sku, etc.), set the field_render node's "column" property to that column name. The "column" overrides the field display_column for that one node, so a single product relation can show its image (as "img"), title (column "title"), and price (column "price") from three field_render nodes.`,'Available record columns by table — only reference these in a node "column": products: title, sku, price, sale_price, stock, short_description, slug, status; product_variants: sku, price, sale_price, stock_quantity; pages: title, slug, status; posts: title, slug, excerpt, subtitle; profiles: full_name; categories: name, slug, description; media: file_name; languages: name, code. Use "as": "img" (no column) to show a record image.','Do NOT create a standalone text field for data that lives on a related record. For example, a product price must come from a products db_relation field rendered with column "price" — never a separate "text" field the editor types by hand.',"Monetary columns (price, sale_price, price_adjustment) are stored in integer cents and are automatically formatted as currency on display, so reference them directly; never multiply, divide, or add currency symbols yourself.","Only use image_r2 for standalone images uploaded directly by the editor that are not tied to any database record (for example a decorative banner or icon). Only use text or rich-text fields for free-form copy the editor writes, not for values that exist on a related record."].join(" ")}function v(t){return["Create a NextBlock custom block definition for this request:",t.prompt,t.context?`Additional CMS context:
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("@nextblock-cms/utils/custom-blocks");require("./zod-config.cjs.js");const e=require("zod"),r=["pages","posts","products","media","categories","profiles","languages"],d=e.z.enum(["article","aside","blockquote","div","figure","figcaption","h2","h3","img","p","section","span"]).describe("A safe semantic element supported by the dynamic layout renderer."),c=e.z.string().trim().max(4e3).describe("Tailwind utility classes only. Do not include CSS, style tags, or JavaScript."),l=e.z.strictObject({description:e.z.string().trim().max(500).optional(),key:o.customBlockFieldKeySchema.describe("Lowercase snake_case field key."),label:e.z.string().trim().min(1).max(120),required:e.z.boolean().default(!1)}),m=l.extend({default_value:e.z.string().max(5e3).optional(),max_length:e.z.number().int().positive().max(1e4).optional(),min_length:e.z.number().int().min(0).max(1e4).optional(),placeholder:e.z.string().max(250).optional(),type:e.z.literal("text")}),u=l.extend({default_value:e.z.string().max(5e4).optional(),placeholder:e.z.string().max(250).optional(),type:e.z.literal("rich-text")}),p=l.extend({accept:e.z.array(e.z.string().trim().min(1).max(120)).max(20).optional(),default_value:e.z.strictObject({alt:e.z.string().max(300).optional(),file_name:e.z.string().trim().min(1).max(255).optional(),file_type:e.z.string().trim().min(1).max(120).optional(),height:e.z.number().int().positive().optional(),object_key:e.z.string().trim().min(1).max(1024),size_bytes:e.z.number().int().positive().optional(),url:e.z.string().trim().min(1).max(2048),width:e.z.number().int().positive().optional()}).optional(),max_bytes:e.z.number().int().positive().max(50*1024*1024).optional(),type:e.z.literal("image_r2")}),f=l.extend({default_value:e.z.union([e.z.string(),e.z.array(e.z.string()),e.z.null()]).optional(),display_column:e.z.string().trim().min(1).max(80).default("title"),filters:e.z.record(e.z.string(),e.z.unknown()).optional(),multiple:e.z.boolean().default(!1),table:e.z.enum(r),type:e.z.literal("db_relation"),value_column:e.z.string().trim().min(1).max(80).default("id")}),y=e.z.discriminatedUnion("type",[m,u,p,f]).describe("A NextBlock custom block field. Allowed types: text, rich-text, image_r2, db_relation."),s=e.z.lazy(()=>e.z.discriminatedUnion("type",[e.z.strictObject({as:d.optional(),children:e.z.array(s).max(200).default([]),className:c.optional(),type:e.z.literal("container")}),e.z.strictObject({as:d.optional(),className:c.optional(),column:e.z.string().trim().min(1).max(80).optional().describe("For a db_relation field, the related record column to display (e.g. title, price)."),emptyFallback:e.z.string().max(300).optional(),field_key:o.customBlockFieldKeySchema,type:e.z.literal("field_render")})])),_=e.z.strictObject({context:e.z.string().trim().max(24e3).optional(),modelId:e.z.string().trim().min(1).max(200).optional(),prompt:e.z.string().trim().min(3).max(4e3)});function g(t){return t.type==="field_render"?[t.field_key]:t.children.flatMap(i=>g(i))}function k(t,i){const n=new Set;t.fields.forEach((a,b)=>{n.has(a.key)&&i.addIssue({code:"custom",message:`Duplicate field key "${a.key}".`,path:["fields",b,"key"]}),n.add(a.key)});for(const a of g(t.layout_schema))n.has(a)||i.addIssue({code:"custom",message:`Layout references unknown field "${a}".`,path:["layout_schema"]})}const h=e.z.strictObject({description:e.z.string().trim().max(1e3).default(""),fields:e.z.array(y).min(1).max(80),is_original:e.z.boolean().default(!0),layout_schema:s,name:e.z.string().trim().min(1).max(160),slug:o.customBlockSlugSchema.describe("Lowercase kebab-case slug.")}).superRefine(k).describe("A complete NextBlock custom block definition stored as database JSONB.");function x(t){const i=h.parse(t);return o.customBlockDefinitionCreateSchema.parse({...i,is_original:!0})}function z(){return["You are NextBlock Cortex, an expert web platform engineer building database-rendered custom CMS widgets.","Return ONLY one clean raw JSON object with the exact structure described in the user message. Do not include markdown fences, comments, prose, or explanatory text.","Never emit TSX, JSX, React components, JavaScript, CSS blocks, style attributes, script tags, or runtime code.","Use only these field types: text, rich-text, image_r2, db_relation.",`Use db_relation.table only from this allowlist: ${r.join(", ")}.`,"Use lowercase kebab-case for slug and lowercase snake_case for field keys.","Build layout_schema as a self-referential tree: container nodes may contain nested container or field_render nodes to any needed depth.","Use Tailwind utility classes in className strings. Use responsive utilities where helpful.",'The "as" property of any node MUST be exactly one of: article, aside, blockquote, div, figure, figcaption, h2, h3, img, p, section, span. Never use a, button, ul, ol, li, table, or any other tag. For a call-to-action or "more info" button, use a span or p styled with button-like Tailwind classes (rounded, padded, colored background).',"Every field_render.field_key must match one field key exactly.","For relation fields, set value_column to id and set display_column to a column that actually exists on the chosen table: use title for pages, posts, and products; sku for product_variants; full_name for profiles; name for categories and languages; file_name for media. Do not invent display columns.",`Entity images: when a block displays an image that belongs to a related product, page, or post (for example a product card photo or a post thumbnail), do NOT add an image_r2 upload field for it. Instead add a single db_relation field to that table (products, product_variants, pages, or posts) and add a field_render node that references it with "as": "img". The renderer automatically resolves the related record's primary image — a product or variant main_image/object_key, or a page/post feature image — so keep the table's normal display_column (for example title for a products relation).`,'You may reference the same db_relation field from more than one field_render node: for example one node with "as": "img" for the image and another text node for its title, plus the relation value to drive a "more info" link. This builds a product/page/post card from a single relation field.',`To display a SPECIFIC column of a related record (its title, price, sku, etc.), set the field_render node's "column" property to that column name. The "column" overrides the field display_column for that one node, so a single product relation can show its image (as "img"), title (column "title"), and price (column "price") from three field_render nodes.`,'Available record columns by table — only reference these in a node "column": products: title, sku, price, sale_price, stock, short_description, slug, status; product_variants: sku, price, sale_price, stock_quantity; pages: title, slug, status; posts: title, slug, excerpt, subtitle; profiles: full_name; categories: name, slug, description; media: file_name; languages: name, code. Use "as": "img" (no column) to show a record image.','Do NOT create a standalone text field for data that lives on a related record. For example, a product price must come from a products db_relation field rendered with column "price" — never a separate "text" field the editor types by hand.',"Monetary columns (price, sale_price, price_adjustment) are stored in integer cents and are automatically formatted as currency on display, so reference them directly; never multiply, divide, or add currency symbols yourself.","Only use image_r2 for standalone images uploaded directly by the editor that are not tied to any database record (for example a decorative banner or icon). Only use text or rich-text fields for free-form copy the editor writes, not for values that exist on a related record."].join(" ")}function v(t){return["Create a NextBlock custom block definition for this request:",t.prompt,t.context?`Additional CMS context:
 ${t.context}`:null,["Return ONLY a JSON object with EXACTLY these top-level keys:",'- "name": string (human-friendly block name).','- "slug": lowercase kebab-case string.','- "description": short string.','- "is_original": true.','- "fields": a non-empty array of field objects. Each field is { "key": lowercase snake_case string, "label": string, "required": boolean, "type": one of "text" | "rich-text" | "image_r2" | "db_relation" }.',`    For "db_relation" fields also include "table" (one of: ${r.join(", ")}), "display_column" (e.g. title, name, full_name, file_name, code), "value_column": "id", and "multiple": boolean.`,'- "layout_schema": a single root layout node (a tree). Every node is one of:','    container: { "type": "container", "as": an HTML tag like div/section/article/figure, "className": Tailwind utility classes, "children": array of nodes }.','    field render: { "type": "field_render", "field_key": one of the field keys above, "as": an HTML tag like p/span/img/h2/h3/div, "className": Tailwind utility classes, "emptyFallback": optional placeholder string }.','    Containers may nest other containers to any depth. Every field_render.field_key MUST match one of the fields. Render image_r2 fields with "as": "img".'].join(`
 `)].filter(Boolean).join(`
 

package/lib/cortex-widget-schema.d.ts

@@ -146,6 +146,16 @@ export type CortexWidgetLayoutNode = {
     type: 'field_render';
 };
 export declare const cortexWidgetLayoutNodeSchema: z.ZodType<CortexWidgetLayoutNode>;
+/**
+ * `context` is sized for a serialized block definition, not just a style note.
+ *
+ * `update_custom_block` regenerates a block by feeding the *existing* definition
+ * back in as context, and a definition with a dozen fields plus its layout schema
+ * runs well past a few thousand characters — the old 3000 cap made editing any
+ * non-trivial block fail validation before it ever reached the model. The route
+ * that accepts this is ADMIN/WRITER-gated, so the cap is a sanity bound rather
+ * than an abuse control; `prompt` still carries the tighter limit.
+ */
 export declare const cortexWidgetBuildRequestSchema: z.ZodObject<{
     context: z.ZodOptional<z.ZodString>;
     modelId: z.ZodOptional<z.ZodString>;

package/lib/cortex-widget-schema.es.js

@@ -82,7 +82,7 @@ const l = [
     })
   ])
 ), T = e.strictObject({
-  context: e.string().trim().max(3e3).optional(),
+  context: e.string().trim().max(24e3).optional(),
   modelId: e.string().trim().min(1).max(200).optional(),
   prompt: e.string().trim().min(3).max(4e3)
 });

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

@@ -1,4 +1,4 @@
-"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",prepare_delete_cms_item:"read",read_current_cms_item:"read",read_database_records:"read",rewrite_page_draft:"write",search_documentation:"read",search_stock_photos:"read",set_content_images:"write",translate_page:"write",update_cms_item_field:"write",update_content_block:"write",update_current_cms_fields:"write",update_custom_block:"write",update_footer:"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 o=b(t);return o?o==="read"?e.length>0:e.includes("write"):!1}function m(e){return e.split("_").map((o,r)=>r===0?o.charAt(0).toUpperCase()+o.slice(1):o).join(" ")}function h(e){const t={additionalProperties:!1,type:"object"};if(!e||typeof e!="object")return t;try{const o=w.z.toJSONSchema(e,{cycles:"ref",io:"input",reused:"inline",target:"draft-2020-12",unrepresentable:"any"});return delete o.$schema,o.type==="object"?o:t}catch{return t}}function l(e){return f.createCortexGlobalAgentTools(e)}function C(e){const t=Object.keys(l(e)),o=Object.keys(i);return{missingFromRegistry:o.filter(r=>!t.includes(r)),unclassified:t.filter(r=>!o.includes(r))}}function T(e){const t=l(e.context),o=[];for(const[r,a]of Object.entries(t))!(r in i)||!c(e.scopes,r)||o.push({description:a.description??`Cortex AI ${m(r)} tool.`,inputSchema:h(a.inputSchema),name:r,title:m(r)});for(const[r,a]of Object.entries(s)){const n=t[a.canonical];!n||!c(e.scopes,r)||o.push({description:a.description,inputSchema:h(n.inputSchema),name:r,title:a.title})}return o.sort((r,a)=>r.name.localeCompare(a.name))}function _(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 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 v(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 r=l(e.context)[t];if(!r||typeof r.execute!="function")throw new p(e.name);const a=e.args&&typeof e.args=="object"?e.args:{};if(r.inputSchema&&typeof r.inputSchema.safeParse=="function"){const n=r.inputSchema.safeParse(a);if(!n.success)return _(`Invalid arguments for "${e.name}": ${S(n.error)}`,!0)}try{const n=await r.execute(a),u=JSON.stringify(n??{success:!0},null,2),d=n&&typeof n=="object"&&!Array.isArray(n)?n:null,k=d?.success===!1;return{content:[{text:u,type:"text"}],isError:k,...d?{structuredContent:d}:{}}}catch(n){const u=n instanceof Error?n.message:String(n);return _(`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 o=await t.describe_database_schema?.execute?.({includeReadOnly:!0});return{mimeType:"application/json",text:JSON.stringify(o??{},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 o=await t.list_custom_blocks?.execute?.({});return{mimeType:"application/json",text:JSON.stringify(o??{},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 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(`
 `),"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(r=>r.name===e.name),o=R[e.name];return!t||!o?null:{description:t.description,messages:[{content:{text:o(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=v;exports.cortexMcpScopesAllow=c;exports.getCortexMcpPrompt=j;exports.getCortexMcpToolKind=b;exports.readCortexMcpResource=O;exports.resolveCortexMcpToolName=g;
+`)};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;

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

@@ -41,19 +41,34 @@ export declare const CORTEX_MCP_TOOL_KINDS: {
     readonly fetch_url_content: "read";
     readonly insert_content_block: "write";
     readonly list_custom_blocks: "read";
+    readonly list_media: "read";
+    readonly list_product_categories: "read";
+    readonly list_site_script_revisions: "read";
+    readonly list_site_scripts: "read";
+    readonly list_site_themes: "read";
+    readonly manage_language: "write";
+    readonly manage_product_category: "write";
+    readonly manage_product_variants: "write";
+    readonly manage_site_script: "write";
+    readonly manage_site_theme: "write";
     readonly prepare_delete_cms_item: "read";
+    readonly publish_content_draft: "write";
     readonly read_current_cms_item: "read";
     readonly read_database_records: "read";
+    readonly revert_site_script: "write";
     readonly rewrite_page_draft: "write";
     readonly search_documentation: "read";
     readonly search_stock_photos: "read";
     readonly set_content_images: "write";
+    readonly translate_content_bulk: "write";
     readonly translate_page: "write";
     readonly update_cms_item_field: "write";
+    readonly upload_media: "write";
     readonly update_content_block: "write";
     readonly update_current_cms_fields: "write";
     readonly update_custom_block: "write";
     readonly update_footer: "write";
+    readonly update_global_css: "write";
     readonly update_navigation_bar: "write";
     readonly update_section_column_block: "write";
 };

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

@@ -16,19 +16,34 @@ const i = {
   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"
 }, u = {
@@ -58,33 +73,33 @@ const i = {
     title: "Update site navigation"
   }
 };
-function _(e) {
+function h(e) {
   return e in u ? u[e].canonical : e in i ? e : null;
 }
-function x(e) {
-  const t = _(e);
+function w(e) {
+  const t = h(e);
   return t ? i[t] : null;
 }
 function d(e, t) {
-  const o = x(t);
-  return o ? o === "read" ? e.length > 0 : e.includes("write") : !1;
+  const r = w(t);
+  return r ? r === "read" ? e.length > 0 : e.includes("write") : !1;
 }
 function p(e) {
-  return e.split("_").map((o, r) => r === 0 ? o.charAt(0).toUpperCase() + o.slice(1) : o).join(" ");
+  return e.split("_").map((r, o) => o === 0 ? r.charAt(0).toUpperCase() + r.slice(1) : r).join(" ");
 }
-function m(e) {
+function g(e) {
   const t = { additionalProperties: !1, type: "object" };
   if (!e || typeof e != "object")
     return t;
   try {
-    const o = k.toJSONSchema(e, {
+    const r = k.toJSONSchema(e, {
       cycles: "ref",
       io: "input",
       reused: "inline",
       target: "draft-2020-12",
       unrepresentable: "any"
     });
-    return delete o.$schema, o.type === "object" ? o : t;
+    return delete r.$schema, r.type === "object" ? r : t;
   } catch {
     return t;
   }
@@ -93,39 +108,39 @@ function s(e) {
   return y(e);
 }
 function j(e) {
-  const t = Object.keys(s(e)), o = Object.keys(i);
+  const t = Object.keys(s(e)), r = Object.keys(i);
   return {
-    missingFromRegistry: o.filter((r) => !t.includes(r)),
-    unclassified: t.filter((r) => !o.includes(r))
+    missingFromRegistry: r.filter((o) => !t.includes(o)),
+    unclassified: t.filter((o) => !r.includes(o))
   };
 }
 function O(e) {
-  const t = s(e.context), o = [];
-  for (const [r, a] of Object.entries(t))
-    !(r in i) || !d(e.scopes, r) || o.push({
-      description: a.description ?? `Cortex AI ${p(r)} tool.`,
-      inputSchema: m(a.inputSchema),
-      name: r,
-      title: p(r)
+  const t = s(e.context), r = [];
+  for (const [o, n] of Object.entries(t))
+    !(o in i) || !d(e.scopes, o) || r.push({
+      description: n.description ?? `Cortex AI ${p(o)} tool.`,
+      inputSchema: g(n.inputSchema),
+      name: o,
+      title: p(o)
     });
-  for (const [r, a] of Object.entries(u)) {
-    const n = t[a.canonical];
-    !n || !d(e.scopes, r) || o.push({
-      description: a.description,
-      inputSchema: m(n.inputSchema),
-      name: r,
-      title: a.title
+  for (const [o, n] of Object.entries(u)) {
+    const a = t[n.canonical];
+    !a || !d(e.scopes, o) || r.push({
+      description: n.description,
+      inputSchema: g(a.inputSchema),
+      name: o,
+      title: n.title
     });
   }
-  return o.sort((r, a) => r.name.localeCompare(a.name));
+  return r.sort((o, n) => o.name.localeCompare(n.name));
 }
-function g(e, t) {
+function m(e, t) {
   return { content: [{ text: e, type: "text" }], isError: t };
 }
-function w(e) {
+function x(e) {
   return e.issues.map((t) => `${t.path.length > 0 ? t.path.join(".") : "(root)"}: ${t.message}`).join("; ");
 }
-class h extends Error {
+class _ extends Error {
   constructor(t) {
     super(`Unknown tool: ${t}`), this.name = "CortexMcpUnknownToolError";
   }
@@ -138,33 +153,33 @@ class v extends Error {
   }
 }
 async function N(e) {
-  const t = _(e.name);
+  const t = h(e.name);
   if (!t)
-    throw new h(e.name);
+    throw new _(e.name);
   if (!d(e.scopes, e.name))
     throw new v(e.name);
-  const r = s(e.context)[t];
-  if (!r || typeof r.execute != "function")
-    throw new h(e.name);
-  const a = e.args && typeof e.args == "object" ? e.args : {};
-  if (r.inputSchema && typeof r.inputSchema.safeParse == "function") {
-    const n = r.inputSchema.safeParse(a);
-    if (!n.success)
-      return g(
-        `Invalid arguments for "${e.name}": ${w(n.error)}`,
+  const o = s(e.context)[t];
+  if (!o || typeof o.execute != "function")
+    throw new _(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 m(
+        `Invalid arguments for "${e.name}": ${x(a.error)}`,
         !0
       );
   }
   try {
-    const n = await r.execute(a), c = JSON.stringify(n ?? { success: !0 }, null, 2), l = n && typeof n == "object" && !Array.isArray(n) ? n : null, f = l?.success === !1;
+    const a = await o.execute(n), c = JSON.stringify(a ?? { success: !0 }, null, 2), l = a && typeof a == "object" && !Array.isArray(a) ? a : null, f = l?.success === !1;
     return {
       content: [{ text: c, type: "text" }],
       isError: f,
       ...l ? { structuredContent: l } : {}
     };
-  } catch (n) {
-    const c = n instanceof Error ? n.message : String(n);
-    return g(`Tool "${e.name}" failed: ${c}`, !0);
+  } catch (a) {
+    const c = a instanceof Error ? a.message : String(a);
+    return m(`Tool "${e.name}" failed: ${c}`, !0);
   }
 }
 const A = [
@@ -193,10 +208,10 @@ const A = [
 async function B(e) {
   const t = s(e.context);
   if (e.uri === "cortex://schema/database") {
-    const o = await t.describe_database_schema?.execute?.({ includeReadOnly: !0 });
+    const r = await t.describe_database_schema?.execute?.({ includeReadOnly: !0 });
     return {
       mimeType: "application/json",
-      text: JSON.stringify(o ?? {}, null, 2),
+      text: JSON.stringify(r ?? {}, null, 2),
       uri: e.uri
     };
   }
@@ -207,10 +222,10 @@ async function B(e) {
       uri: e.uri
     };
   if (e.uri === "cortex://schema/custom-blocks") {
-    const o = await t.list_custom_blocks?.execute?.({});
+    const r = await t.list_custom_blocks?.execute?.({});
     return {
       mimeType: "application/json",
-      text: JSON.stringify(o ?? {}, null, 2),
+      text: JSON.stringify(r ?? {}, null, 2),
       uri: e.uri
     };
   }
@@ -274,11 +289,11 @@ const C = [
 `)
 };
 function P(e) {
-  const t = C.find((r) => r.name === e.name), o = S[e.name];
-  return !t || !o ? null : {
+  const t = C.find((o) => o.name === e.name), r = S[e.name];
+  return !t || !r ? null : {
     description: t.description,
     messages: [
-      { content: { text: o(e.args ?? {}), type: "text" }, role: "user" }
+      { content: { text: r(e.args ?? {}), type: "text" }, role: "user" }
     ]
   };
 }
@@ -288,13 +303,13 @@ export {
   u as CORTEX_MCP_TOOL_ALIASES,
   i as CORTEX_MCP_TOOL_KINDS,
   v as CortexMcpForbiddenToolError,
-  h as CortexMcpUnknownToolError,
+  _ as CortexMcpUnknownToolError,
   j as assertCortexMcpToolCoverage,
   O as buildCortexMcpToolDefinitions,
   N as callCortexMcpTool,
   d as cortexMcpScopesAllow,
   P as getCortexMcpPrompt,
-  x as getCortexMcpToolKind,
+  w as getCortexMcpToolKind,
   B as readCortexMcpResource,
-  _ as resolveCortexMcpToolName
+  h as resolveCortexMcpToolName
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextblock-cms/cortex",
-  "version": "0.14.6",
+  "version": "0.15.0",
   "publishConfig": {
     "access": "public"
   },
@@ -27,9 +27,9 @@
   },
   "dependencies": {
     "@ai-sdk/openai-compatible": "^2.0.42",
-    "@nextblock-cms/db": "^0.14.6",
-    "@nextblock-cms/ecommerce": "npm:@nextblock-cms/ecom@^0.14.6",
-    "@nextblock-cms/utils": "^0.14.6",
+    "@nextblock-cms/db": "^0.15.0",
+    "@nextblock-cms/ecommerce": "npm:@nextblock-cms/ecom@^0.15.0",
+    "@nextblock-cms/utils": "^0.15.0",
     "ai": "^6.0.170",
     "zod": "^4.3.6"
   },