@nextblock-cms/cortex 0.12.2

package/lib/ai-config.d.ts

@@ -0,0 +1,31 @@
+import { EncryptedOpenRouterKeyEnvelope } from './ai-key-crypto';
+export declare const CORTEX_AI_PACKAGE_ID = "cortex-ai";
+export declare const CORTEX_AI_PACKAGE_NAME = "NextBlock Cortex AI";
+export declare const CORTEX_AI_OPENROUTER_SETTING_KEY = "cortex_ai_openrouter_api_key";
+export declare const CORTEX_AI_OPENROUTER_MODEL_SELECTION_SETTING_KEY = "cortex_ai_openrouter_model_selection";
+export declare function getOpenRouterEnvApiKey(): string | null;
+export declare function getCortexAiEnvConfig(): {
+    encryptionKey: string | null;
+    freemiusSandboxKey: string | null;
+    hasEncryptionKey: boolean;
+    hasOpenRouterEnvKey: boolean;
+    openRouterEnvKeyLast4: string | null;
+};
+export declare function encryptStoredOpenRouterApiKey(apiKey: string): EncryptedOpenRouterKeyEnvelope;
+export declare function decryptStoredOpenRouterApiKey(encryptedKey: unknown): string;
+export declare function getStoredOpenRouterKeyStatus(value: unknown): {
+    hasStoredKey: boolean;
+    last4: string | null;
+    maskedKey: string;
+    updatedAt: string | null;
+} | {
+    hasStoredKey: boolean;
+    last4: null;
+    maskedKey: null;
+    updatedAt: null;
+};
+export declare function getEnvOpenRouterKeyStatus(): {
+    hasEnvOpenRouterKey: boolean;
+    maskedEnvOpenRouterKey: string | null;
+};
+export type { EncryptedOpenRouterKeyEnvelope };

package/lib/ai-config.es.js

@@ -0,0 +1,72 @@
+import { encryptOpenRouterApiKey as o, getMaskedOpenRouterKey as E, getOpenRouterKeyEnvelopeStatus as u } from "./ai-key-crypto.es.js";
+import { tryDecryptWithEnvKey as i, hasSecretEncryptionKey as p, resolveSecretEncryptionKey as y } from "@nextblock-cms/db/secrets";
+const c = "Cortex AI configuration can only be imported from server-side code.";
+function n() {
+  if (!(typeof window > "u"))
+    throw new Error(c);
+}
+const a = "cortex-ai", A = "NextBlock Cortex AI", l = "cortex_ai_openrouter_api_key", d = "cortex_ai_openrouter_model_selection";
+function t(e) {
+  return process.env[e]?.trim() || null;
+}
+function _() {
+  return n(), t("OPENROUTER_API_KEY");
+}
+function s() {
+  n();
+  const e = _();
+  return {
+    encryptionKey: t("CORTEX_AI_ENCRYPTION_KEY"),
+    freemiusSandboxKey: t("FREEMIUS_AI_SANDBOX_KEY"),
+    // True when ANY usable key exists: an explicit env key OR the service-role-derived
+    // fallback — so BYOK works on a one-click Vercel deploy with no extra env var.
+    hasEncryptionKey: p(),
+    hasOpenRouterEnvKey: !!e,
+    openRouterEnvKeyLast4: e ? e.slice(-4) : null
+  };
+}
+function R() {
+  n();
+  const e = y();
+  if (!e)
+    throw new Error(
+      "An encryption key (NEXTBLOCK_ENCRYPTION_KEY, CORTEX_AI_ENCRYPTION_KEY, or a Supabase service-role key) is required to manage stored OpenRouter keys."
+    );
+  return e;
+}
+function f(e) {
+  return o({
+    apiKey: e,
+    encryptionSecret: R()
+  });
+}
+function S(e) {
+  n();
+  const r = i(e);
+  if (r === null)
+    throw new Error("Failed to decrypt stored OpenRouter key.");
+  return r;
+}
+function v(e) {
+  return u(e);
+}
+function I() {
+  n();
+  const e = s();
+  return {
+    hasEnvOpenRouterKey: e.hasOpenRouterEnvKey,
+    maskedEnvOpenRouterKey: e.openRouterEnvKeyLast4 ? E(e.openRouterEnvKeyLast4) : null
+  };
+}
+export {
+  d as CORTEX_AI_OPENROUTER_MODEL_SELECTION_SETTING_KEY,
+  l as CORTEX_AI_OPENROUTER_SETTING_KEY,
+  a as CORTEX_AI_PACKAGE_ID,
+  A as CORTEX_AI_PACKAGE_NAME,
+  S as decryptStoredOpenRouterApiKey,
+  f as encryptStoredOpenRouterApiKey,
+  s as getCortexAiEnvConfig,
+  I as getEnvOpenRouterKeyStatus,
+  _ as getOpenRouterEnvApiKey,
+  v as getStoredOpenRouterKeyStatus
+};

package/lib/ai-cortex-widget-builder.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const S=require("ai"),x=require("./ai-client.cjs.js"),o=require("./ai-model-registry.cjs.js"),r=require("./cortex-widget-schema.cjs.js"),f=6e4;function y(e){const t=o.getHttpStatusCode(e);if(t===401||t===402||t===403)return!1;if(o.isOpenRouterRecoverableRoutingError(e)||t&&t>=500)return!0;const n=e instanceof Error?e.message:String(e);return/NoObjectGenerated|No object generated|structured output|schema|validation|Invalid|aborted|abort|timeout|timed out/i.test(n)}async function I(e){const{apiKey:t,fallbackModelIds:n,modelId:c,modelSelection:m,...g}=e,a=r.cortexWidgetBuildRequestSchema.parse(g),i=await x.createCortexAiOpenRouterClient({apiKey:t,modelSelection:m}),d=o.buildCortexAiRoutingPolicy({credentialSource:i.credentialSource,fallbackModelIds:n,requestedModelId:c??a.modelId,selectedModel:i.modelSelection}),l=await o.runWithCortexAiModelFallback({modelIds:d.modelIds,shouldRetry:y,execute:async s=>{const u=new AbortController,p=setTimeout(()=>u.abort(),f);try{const b=o.omitUnsupportedCortexAiModelOptions({abortSignal:u.signal,maxOutputTokens:7e3,maxRetries:0,output:"no-schema",prompt:r.buildCortexWidgetBuilderPrompt(a),system:r.buildCortexWidgetBuilderSystemPrompt(),temperature:.15},{modelId:s,modelSelection:d.modelSelection}),C=await S.generateObject({...b,model:i.model(s)});return r.validateCortexWidgetDefinitionOutput(C.object)}finally{clearTimeout(p)}}});return{attempts:l.attempts,credentialSource:i.credentialSource,definition:l.result,modelId:l.modelId}}exports.generateCortexWidgetDefinition=I;

package/lib/ai-cortex-widget-builder.d.ts

@@ -0,0 +1,14 @@
+import { CortexAiModelAttempt, CortexAiOpenRouterModelId, CortexAiStoredModelSelection } from './ai-model-registry';
+import { CortexWidgetDefinition, CortexWidgetBuildRequest } from './cortex-widget-schema';
+export type GenerateCortexWidgetDefinitionResult = {
+    attempts: readonly CortexAiModelAttempt[];
+    credentialSource: 'env' | 'stored' | 'manual';
+    definition: CortexWidgetDefinition;
+    modelId: CortexAiOpenRouterModelId;
+};
+export declare function generateCortexWidgetDefinition(params: CortexWidgetBuildRequest & {
+    apiKey?: string;
+    fallbackModelIds?: readonly CortexAiOpenRouterModelId[];
+    modelId?: CortexAiOpenRouterModelId;
+    modelSelection?: CortexAiStoredModelSelection | null;
+}): Promise<GenerateCortexWidgetDefinitionResult>;

package/lib/ai-cortex-widget-builder.es.js

@@ -0,0 +1,72 @@
+import { generateObject as b } from "ai";
+import { createCortexAiOpenRouterClient as f } from "./ai-client.es.js";
+import { buildCortexAiRoutingPolicy as C, runWithCortexAiModelFallback as x, omitUnsupportedCortexAiModelOptions as S, getHttpStatusCode as I, isOpenRouterRecoverableRoutingError as y } from "./ai-model-registry.es.js";
+import { cortexWidgetBuildRequestSchema as O, buildCortexWidgetBuilderSystemPrompt as R, buildCortexWidgetBuilderPrompt as T, validateCortexWidgetDefinitionOutput as W } from "./cortex-widget-schema.es.js";
+const E = 6e4;
+function M(e) {
+  const t = I(e);
+  if (t === 401 || t === 402 || t === 403)
+    return !1;
+  if (y(e) || t && t >= 500)
+    return !0;
+  const r = e instanceof Error ? e.message : String(e);
+  return /NoObjectGenerated|No object generated|structured output|schema|validation|Invalid|aborted|abort|timeout|timed out/i.test(
+    r
+  );
+}
+async function B(e) {
+  const { apiKey: t, fallbackModelIds: r, modelId: s, modelSelection: u, ...c } = e, n = O.parse(c), o = await f({ apiKey: t, modelSelection: u }), l = C({
+    credentialSource: o.credentialSource,
+    fallbackModelIds: r,
+    requestedModelId: s ?? n.modelId,
+    selectedModel: o.modelSelection
+  }), i = await x({
+    modelIds: l.modelIds,
+    shouldRetry: M,
+    execute: async (d) => {
+      const a = new AbortController(), m = setTimeout(
+        () => a.abort(),
+        E
+      );
+      try {
+        const p = S(
+          {
+            abortSignal: a.signal,
+            maxOutputTokens: 7e3,
+            maxRetries: 0,
+            // Use JSON mode WITHOUT a provider-side schema. The widget definition
+            // is a recursive, discriminated-union structure; sending it as a
+            // response_format json_schema is rejected by Google Gemini
+            // ("reference to undefined schema", recursion not supported) and by
+            // OpenAI ("'oneOf' is not permitted"). We instead describe the shape
+            // in the prompt and validate the returned JSON with our own Zod
+            // schema below, which works across every OpenRouter model.
+            output: "no-schema",
+            prompt: T(n),
+            system: R(),
+            temperature: 0.15
+          },
+          {
+            modelId: d,
+            modelSelection: l.modelSelection
+          }
+        ), g = await b({
+          ...p,
+          model: o.model(d)
+        });
+        return W(g.object);
+      } finally {
+        clearTimeout(m);
+      }
+    }
+  });
+  return {
+    attempts: i.attempts,
+    credentialSource: o.credentialSource,
+    definition: i.result,
+    modelId: i.modelId
+  };
+}
+export {
+  B as generateCortexWidgetDefinition
+};

package/lib/ai-global-agent-custom-block-tools.cjs.js

@@ -0,0 +1 @@
+"use strict";var z=Object.create;var h=Object.defineProperty;var A=Object.getOwnPropertyDescriptor;var T=Object.getOwnPropertyNames;var U=Object.getPrototypeOf,D=Object.prototype.hasOwnProperty;var I=(e,t,s,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of T(t))!D.call(e,o)&&o!==s&&h(e,o,{get:()=>t[o],enumerable:!(i=A(t,o))||i.enumerable});return e};var L=(e,t,s)=>(s=e!=null?z(U(e)):{},I(t||!e||!e.__esModule?h(s,"default",{value:e,enumerable:!0}):s,e));Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("ai");require("./zod-config.cjs.js");const r=require("zod"),k="id, slug, name, description, fields, layout_schema, is_original",C=r.z.strictObject({context:r.z.string().trim().max(3e3).optional().describe("Optional extra constraints or brand/style guidance for the generated block."),prompt:r.z.string().trim().min(3).max(4e3).describe('Natural-language description of the custom block, including the fields it needs and the visual style. Example: "A product card with a title, image, price, and a button that links to the product page."')}),w=r.z.strictObject({prompt:r.z.string().trim().min(3).max(4e3).describe("Description of the changes to apply. The block is regenerated using its existing definition as context."),slug:r.z.string().trim().min(1).max(120).describe("Slug of the existing custom block to edit.")}),S=r.z.strictObject({slug:r.z.string().trim().min(1).max(120).describe("Slug of the custom block definition to delete.")}),_=r.z.strictObject({query:r.z.string().trim().max(120).optional().describe("Optional text filter on name or slug.")});function l(e){if(!e?.supabase)throw new Error("A Supabase service client is required to manage custom block definitions.");return e.supabase}function g(e){if(!e?.actorUserId)throw new Error("Managing custom block definitions requires an authenticated admin actor.");return e.actorUserId}function y(e){return JSON.parse(JSON.stringify(e))}function f(e){const t=Array.isArray(e?.fields)?e.fields:[];return{fieldCount:t.length,fields:t.map(s=>({key:s?.key,label:s?.label,type:s?.type})),id:e?.id,name:e?.name,slug:e?.slug}}function E(e,t){const s=t?.cortexAiApiKey||void 0;return{apiKey:s,context:e.context,modelSelection:s&&t?.cortexAiModelSelection?t.cortexAiModelSelection:void 0,prompt:e.prompt}}function p(e){try{const{revalidatePath:t,revalidateTag:s}=require("next/cache");s("custom-block-definitions","max"),e?.id&&s(`custom-block-definitions:${e.id}`,"max"),e?.slug&&s(`custom-block-definitions:${e.slug}`,"max"),s("dynamic-layout-engine","max"),t("/cms/custom-blocks"),t("/cms/blocks")}catch{}}function x(e){return(e||"").replace(/\s+/g," ").trim().toUpperCase()}function $(e){return`CONFIRM DELETE CUSTOM BLOCK ${e.toUpperCase()}`}function P(e,t){return e?.skipConfirmation?!0:x(e?.latestUserMessage).includes(x(t))}function m(e){if(e&&typeof e=="object"){const t=e;if(t.code==="23505")return"A custom block with that slug already exists. Choose a different name or edit the existing one.";if(typeof t.message=="string"&&t.message)return t.message}return e instanceof Error?e.message:"Unknown error."}async function B(e,t){try{const s=l(t);g(t);const[{generateCortexWidgetDefinition:i},{insertCortexWidgetDefinition:o}]=await Promise.all([Promise.resolve().then(()=>require("./ai-cortex-widget-builder.cjs.js")),Promise.resolve().then(()=>require("./cortex-widget-registry.cjs.js"))]),a=await i(E(e,t)),n=await o(s,a.definition);return p(n),{definition:f(n),editUrl:`/cms/custom-blocks/${n.id}/edit`,mutationExecuted:!0,success:!0}}catch(s){return{mutationExecuted:!1,message:m(s),success:!1}}}async function q(e,t){try{const s=l(t);g(t);const{data:i}=await s.from("custom_block_definitions").select(k).eq("slug",e.slug).maybeSingle();if(!i)return{mutationExecuted:!1,message:`No custom block found with slug "${e.slug}".`,success:!1};const[{generateCortexWidgetDefinition:o},{customBlockDefinitionCreateSchema:a}]=await Promise.all([Promise.resolve().then(()=>require("./ai-cortex-widget-builder.cjs.js")),import("@nextblock-cms/utils/custom-blocks")]),n=await o(E({context:`You are editing an existing custom block named "${i.name}". Keep its overall purpose and only apply the requested changes. Existing definition: ${JSON.stringify({fields:i.fields,layout_schema:i.layout_schema,name:i.name})}`,prompt:e.prompt},t)),c=a.parse({...n.definition,is_original:i.is_original,slug:i.slug}),{data:d,error:b}=await s.from("custom_block_definitions").update({description:c.description,fields:y(c.fields),layout_schema:y(c.layout_schema),name:c.name}).eq("id",i.id).select(k).single();return b||!d?{mutationExecuted:!1,message:b?.message??"Failed to update custom block.",success:!1}:(p(d),{definition:f(d),editUrl:`/cms/custom-blocks/${i.id}/edit`,mutationExecuted:!0,success:!0})}catch(s){return{mutationExecuted:!1,message:m(s),success:!1}}}async function O(e,t){try{const s=l(t);g(t);const{data:i}=await s.from("custom_block_definitions").select("id, slug, name").eq("slug",e.slug).maybeSingle();if(!i)return{mutationExecuted:!1,message:`No custom block found with slug "${e.slug}".`,success:!1};const o=$(i.slug);if(!P(t,o))return{confirmationPhrase:o,mutationExecuted:!1,preview:{summary:`Delete the custom block "${i.name}" (${i.slug}). Pages still using it will stop rendering it until replaced. This cannot be undone.`},requiresConfirmation:!0,success:!0};const{error:a}=await s.from("custom_block_definitions").delete().eq("id",i.id);return a?{mutationExecuted:!1,message:`Failed to delete custom block: ${a.message}`,success:!1}:(p(i),{deleted:{name:i.name,slug:i.slug},mutationExecuted:!0,success:!0})}catch(s){return{mutationExecuted:!1,message:m(s),success:!1}}}async function v(e,t){try{const s=l(t),{data:i,error:o}=await s.from("custom_block_definitions").select("id, slug, name, description, fields, is_original").order("name",{ascending:!0});if(o)return{message:o.message,success:!1};let a=Array.isArray(i)?i:[];if(e.query){const n=e.query.toLowerCase();a=a.filter(c=>String(c.name||"").toLowerCase().includes(n)||String(c.slug||"").toLowerCase().includes(n))}return{blocks:a.map(n=>f(n)),count:a.length,success:!0}}catch(s){return{message:m(s),success:!1}}}function M(e){return{create_custom_block:u.tool({description:'Create a brand-new reusable custom block definition from a natural-language description (for example "a product card with title, image, price, and a button linking to the product page"). This is a GLOBAL block-library builder and does NOT require an open page, post, or product. It generates the field schema and Tailwind layout and saves it so the block can be added to any page afterward. Additive and reversible; executes immediately without a confirmation phrase.',execute:t=>B(t,e),inputSchema:C,strict:!0}),delete_custom_block:u.tool({description:"Delete a custom block definition by slug. Mutating: first returns a confirmation phrase; only executes after the user replies with the exact phrase. Use list_custom_blocks first if you are unsure of the slug.",execute:t=>O(t,e),inputSchema:S,strict:!0}),list_custom_blocks:u.tool({description:"List the existing custom block definitions (slug, name, and fields). Read-only and does not require page context. Use it to find the slug of a block to edit or delete.",execute:t=>v(t,e),inputSchema:_,strict:!0}),update_custom_block:u.tool({description:"Edit an existing custom block definition (identified by slug) from a new natural-language description. The block is regenerated with its current definition as context and keeps its slug so existing placements keep working. Executes immediately.",execute:t=>q(t,e),inputSchema:w,strict:!0})}}exports.createCortexCustomBlockTools=M;exports.createCustomBlockInputSchema=C;exports.deleteCustomBlockInputSchema=S;exports.executeCreateCustomBlock=B;exports.executeDeleteCustomBlock=O;exports.executeListCustomBlocks=v;exports.executeUpdateCustomBlock=q;exports.listCustomBlocksInputSchema=_;exports.updateCustomBlockInputSchema=w;

package/lib/ai-global-agent-custom-block-tools.d.ts

@@ -0,0 +1,208 @@
+import { z } from './zod-config';
+type CustomBlockToolContext = {
+    actorUserId?: string | null;
+    cortexAiApiKey?: string | null;
+    cortexAiModelSelection?: unknown;
+    latestUserMessage?: string | null;
+    skipConfirmation?: boolean;
+    supabase?: {
+        from: (table: string) => any;
+    };
+};
+export declare const createCustomBlockInputSchema: z.ZodObject<{
+    context: z.ZodOptional<z.ZodString>;
+    prompt: z.ZodString;
+}, z.core.$strict>;
+export declare const updateCustomBlockInputSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    slug: z.ZodString;
+}, z.core.$strict>;
+export declare const deleteCustomBlockInputSchema: z.ZodObject<{
+    slug: z.ZodString;
+}, z.core.$strict>;
+export declare const listCustomBlocksInputSchema: z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export declare function executeCreateCustomBlock(input: z.infer<typeof createCustomBlockInputSchema>, context?: CustomBlockToolContext): Promise<{
+    definition: {
+        fieldCount: any;
+        fields: any;
+        id: any;
+        name: any;
+        slug: any;
+    };
+    editUrl: string;
+    mutationExecuted: boolean;
+    success: boolean;
+    message?: undefined;
+} | {
+    mutationExecuted: boolean;
+    message: string;
+    success: boolean;
+    definition?: undefined;
+    editUrl?: undefined;
+}>;
+export declare function executeUpdateCustomBlock(input: z.infer<typeof updateCustomBlockInputSchema>, context?: CustomBlockToolContext): Promise<{
+    mutationExecuted: boolean;
+    message: any;
+    success: boolean;
+    definition?: undefined;
+    editUrl?: undefined;
+} | {
+    definition: {
+        fieldCount: any;
+        fields: any;
+        id: any;
+        name: any;
+        slug: any;
+    };
+    editUrl: string;
+    mutationExecuted: boolean;
+    success: boolean;
+    message?: undefined;
+}>;
+export declare function executeDeleteCustomBlock(input: z.infer<typeof deleteCustomBlockInputSchema>, context?: CustomBlockToolContext): Promise<{
+    mutationExecuted: boolean;
+    message: string;
+    success: boolean;
+    confirmationPhrase?: undefined;
+    preview?: undefined;
+    requiresConfirmation?: undefined;
+    deleted?: undefined;
+} | {
+    confirmationPhrase: string;
+    mutationExecuted: boolean;
+    preview: {
+        summary: string;
+    };
+    requiresConfirmation: boolean;
+    success: boolean;
+    message?: undefined;
+    deleted?: undefined;
+} | {
+    deleted: {
+        name: any;
+        slug: any;
+    };
+    mutationExecuted: boolean;
+    success: boolean;
+    message?: undefined;
+    confirmationPhrase?: undefined;
+    preview?: undefined;
+    requiresConfirmation?: undefined;
+}>;
+export declare function executeListCustomBlocks(input: z.infer<typeof listCustomBlocksInputSchema>, context?: CustomBlockToolContext): Promise<{
+    message: any;
+    success: boolean;
+    blocks?: undefined;
+    count?: undefined;
+} | {
+    blocks: {
+        fieldCount: any;
+        fields: any;
+        id: any;
+        name: any;
+        slug: any;
+    }[];
+    count: number;
+    success: boolean;
+    message?: undefined;
+}>;
+export declare function createCortexCustomBlockTools(context?: CustomBlockToolContext): {
+    create_custom_block: import('ai').Tool<{
+        prompt: string;
+        context?: string | undefined;
+    }, {
+        definition: {
+            fieldCount: any;
+            fields: any;
+            id: any;
+            name: any;
+            slug: any;
+        };
+        editUrl: string;
+        mutationExecuted: boolean;
+        success: boolean;
+        message?: undefined;
+    } | {
+        mutationExecuted: boolean;
+        message: string;
+        success: boolean;
+        definition?: undefined;
+        editUrl?: undefined;
+    }>;
+    delete_custom_block: import('ai').Tool<{
+        slug: string;
+    }, {
+        mutationExecuted: boolean;
+        message: string;
+        success: boolean;
+        confirmationPhrase?: undefined;
+        preview?: undefined;
+        requiresConfirmation?: undefined;
+        deleted?: undefined;
+    } | {
+        confirmationPhrase: string;
+        mutationExecuted: boolean;
+        preview: {
+            summary: string;
+        };
+        requiresConfirmation: boolean;
+        success: boolean;
+        message?: undefined;
+        deleted?: undefined;
+    } | {
+        deleted: {
+            name: any;
+            slug: any;
+        };
+        mutationExecuted: boolean;
+        success: boolean;
+        message?: undefined;
+        confirmationPhrase?: undefined;
+        preview?: undefined;
+        requiresConfirmation?: undefined;
+    }>;
+    list_custom_blocks: import('ai').Tool<{
+        query?: string | undefined;
+    }, {
+        message: any;
+        success: boolean;
+        blocks?: undefined;
+        count?: undefined;
+    } | {
+        blocks: {
+            fieldCount: any;
+            fields: any;
+            id: any;
+            name: any;
+            slug: any;
+        }[];
+        count: number;
+        success: boolean;
+        message?: undefined;
+    }>;
+    update_custom_block: import('ai').Tool<{
+        prompt: string;
+        slug: string;
+    }, {
+        mutationExecuted: boolean;
+        message: any;
+        success: boolean;
+        definition?: undefined;
+        editUrl?: undefined;
+    } | {
+        definition: {
+            fieldCount: any;
+            fields: any;
+            id: any;
+            name: any;
+            slug: any;
+        };
+        editUrl: string;
+        mutationExecuted: boolean;
+        success: boolean;
+        message?: undefined;
+    }>;
+};
+export {};

package/lib/ai-global-agent-custom-block-tools.es.js

@@ -0,0 +1,220 @@
+import { tool as u } from "ai";
+import "./zod-config.es.js";
+import { z as n } from "zod";
+const h = "id, slug, name, description, fields, layout_schema, is_original", C = n.strictObject({
+  context: n.string().trim().max(3e3).optional().describe("Optional extra constraints or brand/style guidance for the generated block."),
+  prompt: n.string().trim().min(3).max(4e3).describe(
+    'Natural-language description of the custom block, including the fields it needs and the visual style. Example: "A product card with a title, image, price, and a button that links to the product page."'
+  )
+}), w = n.strictObject({
+  prompt: n.string().trim().min(3).max(4e3).describe("Description of the changes to apply. The block is regenerated using its existing definition as context."),
+  slug: n.string().trim().min(1).max(120).describe("Slug of the existing custom block to edit.")
+}), _ = n.strictObject({
+  slug: n.string().trim().min(1).max(120).describe("Slug of the custom block definition to delete.")
+}), S = n.strictObject({
+  query: n.string().trim().max(120).optional().describe("Optional text filter on name or slug.")
+});
+function l(e) {
+  if (!e?.supabase)
+    throw new Error("A Supabase service client is required to manage custom block definitions.");
+  return e.supabase;
+}
+function g(e) {
+  if (!e?.actorUserId)
+    throw new Error("Managing custom block definitions requires an authenticated admin actor.");
+  return e.actorUserId;
+}
+function k(e) {
+  return JSON.parse(JSON.stringify(e));
+}
+function f(e) {
+  const t = Array.isArray(e?.fields) ? e.fields : [];
+  return {
+    fieldCount: t.length,
+    fields: t.map((s) => ({ key: s?.key, label: s?.label, type: s?.type })),
+    id: e?.id,
+    name: e?.name,
+    slug: e?.slug
+  };
+}
+function x(e, t) {
+  const s = t?.cortexAiApiKey || void 0;
+  return {
+    apiKey: s,
+    context: e.context,
+    modelSelection: s && t?.cortexAiModelSelection ? t.cortexAiModelSelection : void 0,
+    prompt: e.prompt
+  };
+}
+function p(e) {
+  try {
+    const { revalidatePath: t, revalidateTag: s } = require("next/cache");
+    s("custom-block-definitions", "max"), e?.id && s(`custom-block-definitions:${e.id}`, "max"), e?.slug && s(`custom-block-definitions:${e.slug}`, "max"), s("dynamic-layout-engine", "max"), t("/cms/custom-blocks"), t("/cms/blocks");
+  } catch {
+  }
+}
+function y(e) {
+  return (e || "").replace(/\s+/g, " ").trim().toUpperCase();
+}
+function E(e) {
+  return `CONFIRM DELETE CUSTOM BLOCK ${e.toUpperCase()}`;
+}
+function q(e, t) {
+  return e?.skipConfirmation ? !0 : y(e?.latestUserMessage).includes(y(t));
+}
+function m(e) {
+  if (e && typeof e == "object") {
+    const t = e;
+    if (t.code === "23505")
+      return "A custom block with that slug already exists. Choose a different name or edit the existing one.";
+    if (typeof t.message == "string" && t.message)
+      return t.message;
+  }
+  return e instanceof Error ? e.message : "Unknown error.";
+}
+async function O(e, t) {
+  try {
+    const s = l(t);
+    g(t);
+    const [{ generateCortexWidgetDefinition: i }, { insertCortexWidgetDefinition: r }] = await Promise.all([
+      import("./ai-cortex-widget-builder.es.js"),
+      import("./cortex-widget-registry.es.js")
+    ]), o = await i(x(e, t)), a = await r(s, o.definition);
+    return p(a), {
+      definition: f(a),
+      editUrl: `/cms/custom-blocks/${a.id}/edit`,
+      mutationExecuted: !0,
+      success: !0
+    };
+  } catch (s) {
+    return { mutationExecuted: !1, message: m(s), success: !1 };
+  }
+}
+async function A(e, t) {
+  try {
+    const s = l(t);
+    g(t);
+    const { data: i } = await s.from("custom_block_definitions").select(h).eq("slug", e.slug).maybeSingle();
+    if (!i)
+      return { mutationExecuted: !1, message: `No custom block found with slug "${e.slug}".`, success: !1 };
+    const [{ generateCortexWidgetDefinition: r }, { customBlockDefinitionCreateSchema: o }] = await Promise.all([
+      import("./ai-cortex-widget-builder.es.js"),
+      import("@nextblock-cms/utils/custom-blocks")
+    ]), a = await r(
+      x(
+        {
+          context: `You are editing an existing custom block named "${i.name}". Keep its overall purpose and only apply the requested changes. Existing definition: ${JSON.stringify(
+            { fields: i.fields, layout_schema: i.layout_schema, name: i.name }
+          )}`,
+          prompt: e.prompt
+        },
+        t
+      )
+    ), c = o.parse({
+      ...a.definition,
+      is_original: i.is_original,
+      slug: i.slug
+    }), { data: d, error: b } = await s.from("custom_block_definitions").update({
+      description: c.description,
+      fields: k(c.fields),
+      layout_schema: k(c.layout_schema),
+      name: c.name
+    }).eq("id", i.id).select(h).single();
+    return b || !d ? { mutationExecuted: !1, message: b?.message ?? "Failed to update custom block.", success: !1 } : (p(d), {
+      definition: f(d),
+      editUrl: `/cms/custom-blocks/${i.id}/edit`,
+      mutationExecuted: !0,
+      success: !0
+    });
+  } catch (s) {
+    return { mutationExecuted: !1, message: m(s), success: !1 };
+  }
+}
+async function B(e, t) {
+  try {
+    const s = l(t);
+    g(t);
+    const { data: i } = await s.from("custom_block_definitions").select("id, slug, name").eq("slug", e.slug).maybeSingle();
+    if (!i)
+      return { mutationExecuted: !1, message: `No custom block found with slug "${e.slug}".`, success: !1 };
+    const r = E(i.slug);
+    if (!q(t, r))
+      return {
+        confirmationPhrase: r,
+        mutationExecuted: !1,
+        preview: {
+          summary: `Delete the custom block "${i.name}" (${i.slug}). Pages still using it will stop rendering it until replaced. This cannot be undone.`
+        },
+        requiresConfirmation: !0,
+        success: !0
+      };
+    const { error: o } = await s.from("custom_block_definitions").delete().eq("id", i.id);
+    return o ? { mutationExecuted: !1, message: `Failed to delete custom block: ${o.message}`, success: !1 } : (p(i), {
+      deleted: { name: i.name, slug: i.slug },
+      mutationExecuted: !0,
+      success: !0
+    });
+  } catch (s) {
+    return { mutationExecuted: !1, message: m(s), success: !1 };
+  }
+}
+async function U(e, t) {
+  try {
+    const s = l(t), { data: i, error: r } = await s.from("custom_block_definitions").select("id, slug, name, description, fields, is_original").order("name", { ascending: !0 });
+    if (r)
+      return { message: r.message, success: !1 };
+    let o = Array.isArray(i) ? i : [];
+    if (e.query) {
+      const a = e.query.toLowerCase();
+      o = o.filter(
+        (c) => String(c.name || "").toLowerCase().includes(a) || String(c.slug || "").toLowerCase().includes(a)
+      );
+    }
+    return {
+      blocks: o.map((a) => f(a)),
+      count: o.length,
+      success: !0
+    };
+  } catch (s) {
+    return { message: m(s), success: !1 };
+  }
+}
+function $(e) {
+  return {
+    create_custom_block: u({
+      description: 'Create a brand-new reusable custom block definition from a natural-language description (for example "a product card with title, image, price, and a button linking to the product page"). This is a GLOBAL block-library builder and does NOT require an open page, post, or product. It generates the field schema and Tailwind layout and saves it so the block can be added to any page afterward. Additive and reversible; executes immediately without a confirmation phrase.',
+      execute: (t) => O(t, e),
+      inputSchema: C,
+      strict: !0
+    }),
+    delete_custom_block: u({
+      description: "Delete a custom block definition by slug. Mutating: first returns a confirmation phrase; only executes after the user replies with the exact phrase. Use list_custom_blocks first if you are unsure of the slug.",
+      execute: (t) => B(t, e),
+      inputSchema: _,
+      strict: !0
+    }),
+    list_custom_blocks: u({
+      description: "List the existing custom block definitions (slug, name, and fields). Read-only and does not require page context. Use it to find the slug of a block to edit or delete.",
+      execute: (t) => U(t, e),
+      inputSchema: S,
+      strict: !0
+    }),
+    update_custom_block: u({
+      description: "Edit an existing custom block definition (identified by slug) from a new natural-language description. The block is regenerated with its current definition as context and keeps its slug so existing placements keep working. Executes immediately.",
+      execute: (t) => A(t, e),
+      inputSchema: w,
+      strict: !0
+    })
+  };
+}
+export {
+  $ as createCortexCustomBlockTools,
+  C as createCustomBlockInputSchema,
+  _ as deleteCustomBlockInputSchema,
+  O as executeCreateCustomBlock,
+  B as executeDeleteCustomBlock,
+  U as executeListCustomBlocks,
+  A as executeUpdateCustomBlock,
+  S as listCustomBlocksInputSchema,
+  w as updateCustomBlockInputSchema
+};