@nextblock-cms/cortex 0.20.0 → 0.20.3

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

@@ -1,8 +1,8 @@
-import { createCortexGlobalAgentTools as f } from "./ai-global-agent-tools.es.js";
-import { availableCortexAiBlockTypes as y } from "./block-content-schemas.es.js";
+import { createCortexGlobalAgentTools as y } from "./ai-global-agent-tools.es.js";
+import { availableCortexAiBlockTypes as v } from "./block-content-schemas.es.js";
 import "./zod-config.es.js";
 import { z as w } from "zod";
-const n = {
+const s = {
   create_cms_page: "write",
   create_cms_post: "write",
   create_cms_product: "write",
@@ -53,7 +53,53 @@ const n = {
   update_navigation_bar: "write",
   update_section_column_block: "write",
   update_site_identity: "write"
-}, u = {
+}, k = {
+  create_cms_page: { destructive: !1, idempotent: !0, openWorld: !0 },
+  create_cms_post: { destructive: !1, idempotent: !0, openWorld: !0 },
+  create_cms_product: { destructive: !1, idempotent: !0, openWorld: !0 },
+  create_custom_block: { destructive: !1, idempotent: !1, openWorld: !1 },
+  delete_cms_item: { destructive: !0, idempotent: !0, openWorld: !1 },
+  delete_custom_block: { destructive: !0, idempotent: !0, openWorld: !1 },
+  // A plan can carry delete_cms_item, insert_content_block and set_content_images, so it
+  // inherits the worst of each.
+  execute_cms_action_plan: { destructive: !0, idempotent: !1, openWorld: !0 },
+  execute_database_action_plan: { destructive: !0, idempotent: !1, openWorld: !1 },
+  execute_database_mutation: { destructive: !0, idempotent: !1, openWorld: !1 },
+  finish_site_build: { destructive: !1, idempotent: !0, openWorld: !1 },
+  insert_content_block: { destructive: !1, idempotent: !1, openWorld: !1 },
+  manage_language: { destructive: !1, idempotent: !0, openWorld: !1 },
+  manage_product_category: { destructive: !0, idempotent: !0, openWorld: !1 },
+  manage_product_variants: { destructive: !0, idempotent: !1, openWorld: !1 },
+  manage_site_script: { destructive: !0, idempotent: !0, openWorld: !1 },
+  manage_site_theme: { destructive: !1, idempotent: !0, openWorld: !1 },
+  // Overwrites the live blocks, but snapshots a revision first and consumes the draft,
+  // so a second call finds nothing to publish.
+  publish_content_draft: { destructive: !1, idempotent: !0, openWorld: !1 },
+  reset_site_content: { destructive: !0, idempotent: !0, openWorld: !1 },
+  // Logged as a new revision; the rollback can itself be rolled back.
+  revert_site_script: { destructive: !1, idempotent: !0, openWorld: !1 },
+  rewrite_page_draft: { destructive: !1, idempotent: !0, openWorld: !1 },
+  save_site_brief: { destructive: !0, idempotent: !0, openWorld: !1 },
+  set_content_images: { destructive: !0, idempotent: !1, openWorld: !0 },
+  // Runs the reset, and each call (re)opens the time-boxed build session.
+  start_site_build: { destructive: !0, idempotent: !1, openWorld: !1 },
+  translate_content_bulk: { destructive: !1, idempotent: !0, openWorld: !1 },
+  translate_page: { destructive: !1, idempotent: !0, openWorld: !1 },
+  update_cms_item_field: { destructive: !1, idempotent: !0, openWorld: !1 },
+  upload_media: { destructive: !1, idempotent: !1, openWorld: !0 },
+  update_content_block: { destructive: !1, idempotent: !0, openWorld: !1 },
+  update_current_cms_fields: { destructive: !1, idempotent: !0, openWorld: !1 },
+  // Regenerates the whole definition from a description; nothing keeps the old layout.
+  update_custom_block: { destructive: !0, idempotent: !1, openWorld: !1 },
+  update_footer: { destructive: !0, idempotent: !0, openWorld: !1 },
+  update_global_css: { destructive: !0, idempotent: !1, openWorld: !1 },
+  update_navigation_bar: { destructive: !0, idempotent: !0, openWorld: !1 },
+  update_section_column_block: { destructive: !1, idempotent: !0, openWorld: !1 },
+  update_site_identity: { destructive: !1, idempotent: !0, openWorld: !1 }
+}, x = /* @__PURE__ */ new Set([
+  "fetch_url_content",
+  "search_stock_photos"
+]), d = {
   create_page_layout: {
     canonical: "create_cms_page",
     description: 'Create a new page from a slug, a title and a strictly typed block layout in one call. Every block is normalized and validated against the NextBlock block schema (built-in types from the `cortex://schema/blocks` resource, or a custom block slug from `list_custom_blocks`) before anything is written; an invalid block rejects the whole call. Pass `status: "published"` to go live immediately, or leave the default draft and publish later. To rewrite an existing page instead, use `generate_jsonb_layout`. Alias of `create_cms_page`.',
@@ -85,18 +131,37 @@ const n = {
     title: "Update site navigation"
   }
 };
-function _(e) {
-  return e in u ? u[e].canonical : e in n ? e : null;
+function p(e) {
+  return e in d ? d[e].canonical : e in s ? e : null;
 }
-function k(e) {
-  const t = _(e);
-  return t ? n[t] : null;
+function C(e) {
+  const t = p(e);
+  return t ? s[t] : null;
 }
-function d(e, t) {
-  const a = k(t);
+function _(e) {
+  const t = p(e);
+  if (!t)
+    return null;
+  if (s[t] === "read")
+    return {
+      destructiveHint: !1,
+      idempotentHint: !0,
+      openWorldHint: x.has(t),
+      readOnlyHint: !0
+    };
+  const a = k[t];
+  return {
+    destructiveHint: a.destructive,
+    idempotentHint: a.idempotent,
+    openWorldHint: a.openWorld,
+    readOnlyHint: !1
+  };
+}
+function u(e, t) {
+  const a = C(t);
   return a ? a === "read" ? e.length > 0 : e.includes("write") : !1;
 }
-function p(e) {
+function m(e) {
   return e.split("_").map((a, r) => r === 0 ? a.charAt(0).toUpperCase() + a.slice(1) : a).join(" ");
 }
 function h(e) {
@@ -116,85 +181,94 @@ function h(e) {
     return t;
   }
 }
-function s(e) {
-  return f(e);
+function c(e) {
+  return y(e);
 }
 function N(e) {
-  const t = Object.keys(s(e)), a = Object.keys(n);
+  const t = Object.keys(c(e)), a = Object.keys(s);
   return {
     missingFromRegistry: a.filter((r) => !t.includes(r)),
     unclassified: t.filter((r) => !a.includes(r))
   };
 }
-function M(e) {
-  const t = s(e.context), a = [];
-  for (const [r, o] of Object.entries(t))
-    !(r in n) || !d(e.scopes, r) || a.push({
-      description: o.description ?? `Cortex AI ${p(r)} tool.`,
-      inputSchema: h(o.inputSchema),
+function E(e) {
+  const t = c(e.context), a = [];
+  for (const [r, i] of Object.entries(t)) {
+    if (!(r in s) || !u(e.scopes, r))
+      continue;
+    const o = _(r);
+    o && a.push({
+      annotations: o,
+      description: i.description ?? `Cortex AI ${m(r)} tool.`,
+      inputSchema: h(i.inputSchema),
       name: r,
-      title: p(r)
+      title: m(r)
     });
-  for (const [r, o] of Object.entries(u)) {
-    const i = t[o.canonical];
-    !i || !d(e.scopes, r) || a.push({
-      description: o.description,
-      inputSchema: h(i.inputSchema),
+  }
+  for (const [r, i] of Object.entries(d)) {
+    const o = t[i.canonical];
+    if (!o || !u(e.scopes, r))
+      continue;
+    const n = _(r);
+    n && a.push({
+      annotations: n,
+      description: i.description,
+      inputSchema: h(o.inputSchema),
       name: r,
-      title: o.title
+      title: i.title
     });
   }
-  return a.sort((r, o) => r.name.localeCompare(o.name));
+  return a.sort((r, i) => r.name.localeCompare(i.name));
 }
 function g(e, t) {
   return { content: [{ text: e, type: "text" }], isError: t };
 }
-function v(e) {
+function W(e) {
   return e.issues.map((t) => `${t.path.length > 0 ? t.path.join(".") : "(root)"}: ${t.message}`).join("; ");
 }
-class m extends Error {
+class f extends Error {
   constructor(t) {
     super(`Unknown tool: ${t}`), this.name = "CortexMcpUnknownToolError";
   }
 }
-class x extends Error {
+class T 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 O(e) {
-  const t = _(e.name);
+async function A(e) {
+  const t = p(e.name);
   if (!t)
-    throw new m(e.name);
-  if (!d(e.scopes, e.name))
-    throw new x(e.name);
-  const r = s(e.context)[t];
+    throw new f(e.name);
+  if (!u(e.scopes, e.name))
+    throw new T(e.name);
+  const r = c(e.context)[t];
   if (!r || typeof r.execute != "function")
-    throw new m(e.name);
-  const o = e.args && typeof e.args == "object" ? e.args : {};
+    throw new f(e.name);
+  const i = e.args && typeof e.args == "object" ? e.args : {};
   if (r.inputSchema && typeof r.inputSchema.safeParse == "function") {
-    const i = r.inputSchema.safeParse(o);
-    if (!i.success)
+    const o = r.inputSchema.safeParse(i);
+    if (!o.success)
       return g(
-        `Invalid arguments for "${e.name}": ${v(i.error)}`,
+        `Invalid arguments for "${e.name}": ${W(o.error)}`,
         !0
       );
   }
   try {
-    const i = await r.execute(o), c = JSON.stringify(i ?? { success: !0 }, null, 2), l = i && typeof i == "object" && !Array.isArray(i) ? i : null, b = l?.success === !1;
+    const o = await r.execute(i), n = JSON.stringify(o ?? { success: !0 }, null, 2), l = o && typeof o == "object" && !Array.isArray(o) ? o : null, b = l?.success === !1;
     return {
-      content: [{ text: c, type: "text" }],
+      content: [{ text: n, type: "text" }],
       isError: b,
       ...l ? { structuredContent: l } : {}
     };
-  } catch (i) {
-    const c = i instanceof Error ? i.message : String(i);
-    return g(`Tool "${e.name}" failed: ${c}`, !0);
+  } catch (o) {
+    const n = o instanceof Error ? o.message : String(o);
+    return g(`Tool "${e.name}" failed: ${n}`, !0);
   }
 }
-const A = [
+const P = [
   {
     description: "The CMS database structure Cortex AI can read and mutate: tables, columns, primary keys, and read-only flags.",
     mimeType: "application/json",
@@ -217,8 +291,8 @@ const A = [
     uri: "cortex://schema/custom-blocks"
   }
 ];
-async function E(e) {
-  const t = s(e.context);
+async function L(e) {
+  const t = c(e.context);
   if (e.uri === "cortex://schema/database") {
     const a = await t.describe_database_schema?.execute?.({ includeReadOnly: !0 });
     return {
@@ -230,7 +304,7 @@ async function E(e) {
   if (e.uri === "cortex://schema/blocks")
     return {
       mimeType: "application/json",
-      text: JSON.stringify({ blockTypes: y }, null, 2),
+      text: JSON.stringify({ blockTypes: v }, null, 2),
       uri: e.uri
     };
   if (e.uri === "cortex://schema/custom-blocks") {
@@ -243,7 +317,7 @@ async function E(e) {
   }
   return null;
 }
-const C = [
+const S = [
   {
     arguments: [
       {
@@ -283,7 +357,7 @@ const C = [
     name: "translate-content",
     title: "Translate a page or post"
   }
-], S = {
+], O = {
   "build-site": (e) => [
     "Build the whole NextBlock site for this client.",
     "",
@@ -327,8 +401,8 @@ ${e.brief}` : "A site brief may already be saved (get_site_overview returns it u
   ].join(`
 `)
 };
-function P(e) {
-  const t = C.find((r) => r.name === e.name), a = S[e.name];
+function U(e) {
+  const t = S.find((r) => r.name === e.name), a = O[e.name];
   return !t || !a ? null : {
     description: t.description,
     messages: [
@@ -337,18 +411,20 @@ function P(e) {
   };
 }
 export {
-  C as CORTEX_MCP_PROMPTS,
-  A as CORTEX_MCP_RESOURCES,
-  u as CORTEX_MCP_TOOL_ALIASES,
-  n as CORTEX_MCP_TOOL_KINDS,
-  x as CortexMcpForbiddenToolError,
-  m as CortexMcpUnknownToolError,
+  S as CORTEX_MCP_PROMPTS,
+  P as CORTEX_MCP_RESOURCES,
+  d as CORTEX_MCP_TOOL_ALIASES,
+  s as CORTEX_MCP_TOOL_KINDS,
+  k as CORTEX_MCP_WRITE_TOOL_BEHAVIOURS,
+  T as CortexMcpForbiddenToolError,
+  f as CortexMcpUnknownToolError,
   N as assertCortexMcpToolCoverage,
-  M as buildCortexMcpToolDefinitions,
-  O as callCortexMcpTool,
-  d as cortexMcpScopesAllow,
-  P as getCortexMcpPrompt,
-  k as getCortexMcpToolKind,
-  E as readCortexMcpResource,
-  _ as resolveCortexMcpToolName
+  E as buildCortexMcpToolDefinitions,
+  A as callCortexMcpTool,
+  u as cortexMcpScopesAllow,
+  U as getCortexMcpPrompt,
+  _ as getCortexMcpToolAnnotations,
+  C as getCortexMcpToolKind,
+  L as readCortexMcpResource,
+  p as resolveCortexMcpToolName
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextblock-cms/cortex",
-  "version": "0.20.0",
+  "version": "0.20.3",
   "license": "AGPL-3.0-or-later",
   "publishConfig": {
     "access": "public"
@@ -28,9 +28,9 @@
   },
   "dependencies": {
     "@ai-sdk/openai-compatible": "^2.0.42",
-    "@nextblock-cms/db": "^0.20.0",
-    "@nextblock-cms/ecommerce": "npm:@nextblock-cms/ecom@^0.20.0",
-    "@nextblock-cms/utils": "^0.20.0",
+    "@nextblock-cms/db": "^0.20.3",
+    "@nextblock-cms/ecommerce": "npm:@nextblock-cms/ecom@^0.20.3",
+    "@nextblock-cms/utils": "^0.20.3",
     "ai": "^6.0.170",
     "zod": "^4.3.6"
   },