@nextblock-cms/cortex 0.17.6 → 0.17.8

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

@@ -1,7 +1,8 @@
-import { availableCortexAiBlockTypes as b, createCortexGlobalAgentTools as y } from "./ai-global-agent-tools.es.js";
+import { createCortexGlobalAgentTools as b } from "./ai-global-agent-tools.es.js";
+import { availableCortexAiBlockTypes as y } from "./block-content-schemas.es.js";
 import "./zod-config.es.js";
-import { z as k } from "zod";
-const i = {
+import { z as w } from "zod";
+const o = {
   create_cms_page: "write",
   create_cms_post: "write",
   create_cms_product: "write",
@@ -14,6 +15,8 @@ const i = {
   execute_database_mutation: "write",
   fetch_ecommerce_stats: "read",
   fetch_url_content: "read",
+  finish_site_build: "write",
+  get_site_overview: "read",
   insert_content_block: "write",
   list_custom_blocks: "read",
   list_media: "read",
@@ -30,11 +33,14 @@ const i = {
   publish_content_draft: "write",
   read_current_cms_item: "read",
   read_database_records: "read",
+  reset_site_content: "write",
   revert_site_script: "write",
   rewrite_page_draft: "write",
+  save_site_brief: "write",
   search_documentation: "read",
   search_stock_photos: "read",
   set_content_images: "write",
+  start_site_build: "write",
   translate_content_bulk: "write",
   translate_page: "write",
   update_cms_item_field: "write",
@@ -45,7 +51,8 @@ const i = {
   update_footer: "write",
   update_global_css: "write",
   update_navigation_bar: "write",
-  update_section_column_block: "write"
+  update_section_column_block: "write",
+  update_site_identity: "write"
 }, u = {
   generate_jsonb_layout: {
     canonical: "rewrite_page_draft",
@@ -73,74 +80,74 @@ const i = {
     title: "Update site navigation"
   }
 };
-function h(e) {
-  return e in u ? u[e].canonical : e in i ? e : null;
+function _(e) {
+  return e in u ? u[e].canonical : e in o ? e : null;
 }
-function w(e) {
-  const t = h(e);
-  return t ? i[t] : null;
+function k(e) {
+  const t = _(e);
+  return t ? o[t] : null;
 }
 function d(e, t) {
-  const r = w(t);
-  return r ? r === "read" ? e.length > 0 : e.includes("write") : !1;
+  const a = k(t);
+  return a ? a === "read" ? e.length > 0 : e.includes("write") : !1;
 }
 function p(e) {
-  return e.split("_").map((r, o) => o === 0 ? r.charAt(0).toUpperCase() + r.slice(1) : r).join(" ");
+  return e.split("_").map((a, r) => r === 0 ? a.charAt(0).toUpperCase() + a.slice(1) : a).join(" ");
 }
-function g(e) {
+function h(e) {
   const t = { additionalProperties: !1, type: "object" };
   if (!e || typeof e != "object")
     return t;
   try {
-    const r = k.toJSONSchema(e, {
+    const a = w.toJSONSchema(e, {
       cycles: "ref",
       io: "input",
       reused: "inline",
       target: "draft-2020-12",
       unrepresentable: "any"
     });
-    return delete r.$schema, r.type === "object" ? r : t;
+    return delete a.$schema, a.type === "object" ? a : t;
   } catch {
     return t;
   }
 }
 function s(e) {
-  return y(e);
+  return b(e);
 }
-function j(e) {
-  const t = Object.keys(s(e)), r = Object.keys(i);
+function M(e) {
+  const t = Object.keys(s(e)), a = Object.keys(o);
   return {
-    missingFromRegistry: r.filter((o) => !t.includes(o)),
-    unclassified: t.filter((o) => !r.includes(o))
+    missingFromRegistry: a.filter((r) => !t.includes(r)),
+    unclassified: t.filter((r) => !a.includes(r))
   };
 }
-function O(e) {
-  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)
+function N(e) {
+  const t = s(e.context), a = [];
+  for (const [r, n] of Object.entries(t))
+    !(r in o) || !d(e.scopes, r) || a.push({
+      description: n.description ?? `Cortex AI ${p(r)} tool.`,
+      inputSchema: h(n.inputSchema),
+      name: r,
+      title: p(r)
     });
-  for (const [o, n] of Object.entries(u)) {
-    const a = t[n.canonical];
-    !a || !d(e.scopes, o) || r.push({
+  for (const [r, n] of Object.entries(u)) {
+    const i = t[n.canonical];
+    !i || !d(e.scopes, r) || a.push({
       description: n.description,
-      inputSchema: g(a.inputSchema),
-      name: o,
+      inputSchema: h(i.inputSchema),
+      name: r,
       title: n.title
     });
   }
-  return r.sort((o, n) => o.name.localeCompare(n.name));
+  return a.sort((r, n) => r.name.localeCompare(n.name));
 }
-function m(e, t) {
+function g(e, t) {
   return { content: [{ text: e, type: "text" }], isError: t };
 }
 function x(e) {
   return e.issues.map((t) => `${t.path.length > 0 ? t.path.join(".") : "(root)"}: ${t.message}`).join("; ");
 }
-class _ extends Error {
+class m extends Error {
   constructor(t) {
     super(`Unknown tool: ${t}`), this.name = "CortexMcpUnknownToolError";
   }
@@ -152,34 +159,34 @@ class v extends Error {
     ), this.name = "CortexMcpForbiddenToolError";
   }
 }
-async function N(e) {
-  const t = h(e.name);
+async function O(e) {
+  const t = _(e.name);
   if (!t)
-    throw new _(e.name);
+    throw new m(e.name);
   if (!d(e.scopes, e.name))
     throw new v(e.name);
-  const o = s(e.context)[t];
-  if (!o || typeof o.execute != "function")
-    throw new _(e.name);
+  const r = s(e.context)[t];
+  if (!r || typeof r.execute != "function")
+    throw new m(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)}`,
+  if (r.inputSchema && typeof r.inputSchema.safeParse == "function") {
+    const i = r.inputSchema.safeParse(n);
+    if (!i.success)
+      return g(
+        `Invalid arguments for "${e.name}": ${x(i.error)}`,
         !0
       );
   }
   try {
-    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;
+    const i = await r.execute(n), c = JSON.stringify(i ?? { success: !0 }, null, 2), l = i && typeof i == "object" && !Array.isArray(i) ? i : null, f = l?.success === !1;
     return {
       content: [{ text: c, type: "text" }],
       isError: f,
       ...l ? { structuredContent: l } : {}
     };
-  } catch (a) {
-    const c = a instanceof Error ? a.message : String(a);
-    return m(`Tool "${e.name}" failed: ${c}`, !0);
+  } catch (i) {
+    const c = i instanceof Error ? i.message : String(i);
+    return g(`Tool "${e.name}" failed: ${c}`, !0);
   }
 }
 const A = [
@@ -205,33 +212,45 @@ const A = [
     uri: "cortex://schema/custom-blocks"
   }
 ];
-async function B(e) {
+async function P(e) {
   const t = s(e.context);
   if (e.uri === "cortex://schema/database") {
-    const r = await t.describe_database_schema?.execute?.({ includeReadOnly: !0 });
+    const a = await t.describe_database_schema?.execute?.({ includeReadOnly: !0 });
     return {
       mimeType: "application/json",
-      text: JSON.stringify(r ?? {}, null, 2),
+      text: JSON.stringify(a ?? {}, null, 2),
       uri: e.uri
     };
   }
   if (e.uri === "cortex://schema/blocks")
     return {
       mimeType: "application/json",
-      text: JSON.stringify({ blockTypes: b }, null, 2),
+      text: JSON.stringify({ blockTypes: y }, null, 2),
       uri: e.uri
     };
   if (e.uri === "cortex://schema/custom-blocks") {
-    const r = await t.list_custom_blocks?.execute?.({});
+    const a = await t.list_custom_blocks?.execute?.({});
     return {
       mimeType: "application/json",
-      text: JSON.stringify(r ?? {}, null, 2),
+      text: JSON.stringify(a ?? {}, null, 2),
       uri: e.uri
     };
   }
   return null;
 }
 const C = [
+  {
+    arguments: [
+      {
+        description: 'Everything known about the client and the site they want: business, audience, goals, pages (or "one landing page"), languages, brand, contact details. Leave blank to be asked.',
+        name: "brief",
+        required: !1
+      }
+    ],
+    description: "Build (or rebuild) the whole NextBlock site from a brief: remove the sample content, set the identity and theme, create and publish every page, the menus, the footer, and the translations.",
+    name: "build-site",
+    title: "Build the whole site"
+  },
   {
     arguments: [
       { description: "What the page is for, and any brand or tone notes.", name: "brief", required: !0 },
@@ -260,6 +279,20 @@ const C = [
     title: "Translate a page or post"
   }
 ], S = {
+  "build-site": (e) => [
+    "Build the whole NextBlock site for this client.",
+    "",
+    e.brief?.trim() ? `Brief:
+${e.brief}` : "No brief was given: first ask, in one short numbered list, about the business and what it does, the audience and the one action visitors should take, the site shape (one landing page or which pages), the languages, brand colours and tone, contact details, and whether existing content is kept.",
+    "",
+    "Process:",
+    "1. Call get_site_overview to see what exists, the active languages, and whether the NextBlock demo content is still present. Record what you know with save_site_brief.",
+    "2. Present the plan (what is removed, every page with its sections, menus, footer, theme, languages) and call start_site_build with `summary`, `brief`, and `reset` (keepLanguages = the languages wanted) unless existing content is kept. Over MCP the host approves the call; there is no chat confirmation.",
+    '3. Build: update_site_identity; manage_language as needed; manage_site_theme with the brand colours; search_stock_media for imagery when available; rewrite the empty "home" page with generate_jsonb_layout then publish_content_draft; create_cms_page (status "published") for every other page; update_site_navigation (mode "replace") and update_footer for every language; translate_content_bulk for each extra language.',
+    "4. Call finish_site_build with a summary, then report every page with its URL.",
+    "Write real copy from the brief, never placeholders. Every page must exist in every active language."
+  ].join(`
+`),
   "build-page": (e) => [
     `Build the NextBlock page with slug "${e.slug ?? "<slug>"}" from this brief:`,
     "",
@@ -288,12 +321,12 @@ const C = [
   ].join(`
 `)
 };
-function P(e) {
-  const t = C.find((o) => o.name === e.name), r = S[e.name];
-  return !t || !r ? null : {
+function E(e) {
+  const t = C.find((r) => r.name === e.name), a = S[e.name];
+  return !t || !a ? null : {
     description: t.description,
     messages: [
-      { content: { text: r(e.args ?? {}), type: "text" }, role: "user" }
+      { content: { text: a(e.args ?? {}), type: "text" }, role: "user" }
     ]
   };
 }
@@ -301,15 +334,15 @@ export {
   C as CORTEX_MCP_PROMPTS,
   A as CORTEX_MCP_RESOURCES,
   u as CORTEX_MCP_TOOL_ALIASES,
-  i as CORTEX_MCP_TOOL_KINDS,
+  o as CORTEX_MCP_TOOL_KINDS,
   v as CortexMcpForbiddenToolError,
-  _ as CortexMcpUnknownToolError,
-  j as assertCortexMcpToolCoverage,
-  O as buildCortexMcpToolDefinitions,
-  N as callCortexMcpTool,
+  m as CortexMcpUnknownToolError,
+  M as assertCortexMcpToolCoverage,
+  N as buildCortexMcpToolDefinitions,
+  O as callCortexMcpTool,
   d as cortexMcpScopesAllow,
-  P as getCortexMcpPrompt,
-  w as getCortexMcpToolKind,
-  B as readCortexMcpResource,
-  h as resolveCortexMcpToolName
+  E as getCortexMcpPrompt,
+  k as getCortexMcpToolKind,
+  P as readCortexMcpResource,
+  _ as resolveCortexMcpToolName
 };

package/lib/site-brief.cjs.js

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});require("./zod-config.cjs.js");const e=require("zod"),c="cortex_ai_site_brief",m="cortex_ai_build_session",l=e.z.string().trim().min(2).max(10),p=e.z.strictObject({purpose:e.z.string().trim().max(600).optional().describe("What this page is for and what a visitor should do there."),sections:e.z.array(e.z.string().trim().min(1).max(200)).max(20).optional().describe('Planned sections, top to bottom, e.g. ["hero", "services", "testimonials", "contact form"].'),slug:e.z.string().trim().min(1).max(120).describe('URL slug in the primary language, e.g. "home", "services", "contact".'),title:e.z.string().trim().min(1).max(200)}),u=e.z.strictObject({accent_color:e.z.string().trim().max(40).optional(),color_scheme:e.z.enum(["light","dark"]).optional().describe("Overall look the client prefers."),font_style:e.z.string().trim().max(120).optional().describe('e.g. "clean sans-serif", "elegant serif".'),logo_notes:e.z.string().trim().max(600).optional().describe("Whether they have a logo, where it is, or what to do meanwhile."),primary_color:e.z.string().trim().max(40).optional().describe('Hex or plain colour name, e.g. "#1e6f5c" or "forest green".'),secondary_color:e.z.string().trim().max(40).optional(),style_keywords:e.z.array(e.z.string().trim().min(1).max(60)).max(12).optional().describe('e.g. ["minimal", "warm", "premium"].'),tone:e.z.string().trim().max(200).optional().describe('Voice for the copy, e.g. "friendly and plain-spoken".')}).partial(),d=e.z.strictObject({address:e.z.string().trim().max(400).optional(),email:e.z.string().trim().max(200).optional(),hours:e.z.string().trim().max(400).optional(),phone:e.z.string().trim().max(60).optional(),social:e.z.array(e.z.strictObject({platform:e.z.string().trim().min(1).max(60),url:e.z.string().trim().min(1).max(2048)})).max(12).optional()}).partial(),r=e.z.strictObject({audience:e.z.string().trim().max(1e3).optional().describe("Who the site is for."),brand:u.optional(),business_name:e.z.string().trim().min(1).max(160),contact:d.optional(),description:e.z.string().trim().max(3e3).optional().describe("What the business does, in the client's own words where possible."),ecommerce:e.z.strictObject({enabled:e.z.boolean().default(!1),products_summary:e.z.string().trim().max(1e3).optional()}).optional(),goals:e.z.array(e.z.string().trim().min(1).max(300)).max(10).optional().describe('What the site must achieve, e.g. ["get quote requests", "show the menu"].'),keep_existing_content:e.z.boolean().default(!1).describe("true when the client wants existing pages/posts kept rather than replaced."),languages:e.z.array(l).min(1).max(10).default(["en"]).describe("Locale codes the public site must offer, primary first."),notes:e.z.string().trim().max(4e3).optional().describe("Anything else the client said that matters."),pages:e.z.array(p).max(30).default([]).describe('The pages to build. A one-page landing site is a single "home" entry.'),primary_language:l.default("en"),site_type:e.z.enum(["landing-page","multi-page","blog","store","portfolio","other"]).default("multi-page"),status:e.z.enum(["draft","confirmed","built"]).default("draft").describe("draft while interviewing, confirmed once the client approved the plan, built when the build finished."),tagline:e.z.string().trim().max(200).optional(),updated_at:e.z.string().max(80).optional()}),g=r.partial(),h=e.z.strictObject({actorUserId:e.z.string().min(1),createdAt:e.z.string().min(1),expiresAt:e.z.string().min(1),id:e.z.string().min(1),summary:e.z.string().max(4e3)});function _(t){const o=r.safeParse(t);return o.success?o.data:null}function x(t,o){if(!t||!o.actorUserId||t.actorUserId!==o.actorUserId)return!1;const i=Date.parse(t.expiresAt),s=(o.now??new Date).getTime();return Number.isFinite(i)&&i>s}function f(t){const o=[`Business: ${t.business_name}${t.tagline?` — ${t.tagline}`:""}`];t.description&&o.push(`What they do: ${t.description}`),t.audience&&o.push(`Audience: ${t.audience}`),t.goals?.length&&o.push(`Goals: ${t.goals.join("; ")}`),o.push(`Site type: ${t.site_type}. Languages: ${t.languages.join(", ")} (primary ${t.primary_language}).`),t.pages.length>0&&o.push(`Pages: ${t.pages.map(n=>`${n.title} (/${n.slug})${n.purpose?` — ${n.purpose}`:""}`).join("; ")}`);const i=t.brand;if(i&&Object.keys(i).length>0){const n=[i.primary_color?`primary ${i.primary_color}`:null,i.secondary_color?`secondary ${i.secondary_color}`:null,i.accent_color?`accent ${i.accent_color}`:null,i.color_scheme?`${i.color_scheme} scheme`:null,i.font_style?`fonts: ${i.font_style}`:null,i.tone?`tone: ${i.tone}`:null,i.style_keywords?.length?`style: ${i.style_keywords.join(", ")}`:null,i.logo_notes?`logo: ${i.logo_notes}`:null].filter(Boolean);n.length>0&&o.push(`Brand: ${n.join("; ")}`)}const s=t.contact;if(s&&Object.keys(s).length>0){const n=[s.email?`email ${s.email}`:null,s.phone?`phone ${s.phone}`:null,s.address?`address ${s.address}`:null,s.hours?`hours ${s.hours}`:null,s.social?.length?`social: ${s.social.map(a=>`${a.platform} ${a.url}`).join(", ")}`:null].filter(Boolean);n.length>0&&o.push(`Contact: ${n.join("; ")}`)}return t.ecommerce?.enabled&&o.push(`Ecommerce: yes${t.ecommerce.products_summary?` — ${t.ecommerce.products_summary}`:""}`),t.keep_existing_content&&o.push("Keep existing content: yes (do not wipe pages or posts)."),t.notes&&o.push(`Notes: ${t.notes}`),o.push(`Brief status: ${t.status}.`),o.join(`
+`)}exports.CORTEX_AI_BUILD_SESSION_SETTING_KEY=m;exports.CORTEX_AI_SITE_BRIEF_SETTING_KEY=c;exports.cortexBuildSessionSchema=h;exports.cortexSiteBriefInputSchema=g;exports.cortexSiteBriefSchema=r;exports.formatCortexSiteBriefForPrompt=f;exports.isCortexBuildSessionUsable=x;exports.safeParseCortexSiteBrief=_;

package/lib/site-brief.d.ts

@@ -0,0 +1,159 @@
+import { z } from './zod-config';
+/**
+ * The site brief: what the client wants their website to be.
+ *
+ * Cortex fills this in during the site-builder interview and persists it in
+ * `site_settings` so that every later conversation — dashboard chat, MCP client,
+ * a follow-up "make the whole site feel warmer" prompt weeks later — starts from
+ * the same understanding of the business instead of re-asking. It is plain,
+ * non-secret JSON: readable by any admin session and by every tool context.
+ */
+export declare const CORTEX_AI_SITE_BRIEF_SETTING_KEY = "cortex_ai_site_brief";
+/**
+ * A time-boxed authorisation for Cortex to apply an approved build plan without a
+ * confirmation click per tool call. Written only by `start_site_build` after the
+ * operator confirms the plan; the chat route honours it for the actor who opened it
+ * and only until `expiresAt`.
+ */
+export declare const CORTEX_AI_BUILD_SESSION_SETTING_KEY = "cortex_ai_build_session";
+/** The complete brief as stored. Every field a build step may need has a default. */
+export declare const cortexSiteBriefSchema: z.ZodObject<{
+    audience: z.ZodOptional<z.ZodString>;
+    brand: z.ZodOptional<z.ZodObject<{
+        accent_color: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        color_scheme: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+        }>>>;
+        font_style: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        logo_notes: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        primary_color: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        secondary_color: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        style_keywords: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        tone: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strict>>;
+    business_name: z.ZodString;
+    contact: z.ZodOptional<z.ZodObject<{
+        address: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        email: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        hours: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        phone: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        social: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            platform: z.ZodString;
+            url: z.ZodString;
+        }, z.core.$strict>>>>;
+    }, z.core.$strict>>;
+    description: z.ZodOptional<z.ZodString>;
+    ecommerce: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        products_summary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    goals: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    keep_existing_content: z.ZodDefault<z.ZodBoolean>;
+    languages: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    notes: z.ZodOptional<z.ZodString>;
+    pages: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        purpose: z.ZodOptional<z.ZodString>;
+        sections: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        slug: z.ZodString;
+        title: z.ZodString;
+    }, z.core.$strict>>>;
+    primary_language: z.ZodDefault<z.ZodString>;
+    site_type: z.ZodDefault<z.ZodEnum<{
+        other: "other";
+        "landing-page": "landing-page";
+        "multi-page": "multi-page";
+        blog: "blog";
+        store: "store";
+        portfolio: "portfolio";
+    }>>;
+    status: z.ZodDefault<z.ZodEnum<{
+        draft: "draft";
+        confirmed: "confirmed";
+        built: "built";
+    }>>;
+    tagline: z.ZodOptional<z.ZodString>;
+    updated_at: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type CortexSiteBrief = z.infer<typeof cortexSiteBriefSchema>;
+/** What a tool may pass to save or merge: every field optional. */
+export declare const cortexSiteBriefInputSchema: z.ZodObject<{
+    audience: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    brand: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+        accent_color: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        color_scheme: z.ZodOptional<z.ZodOptional<z.ZodEnum<{
+            light: "light";
+            dark: "dark";
+        }>>>;
+        font_style: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        logo_notes: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        primary_color: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        secondary_color: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        style_keywords: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        tone: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strict>>>;
+    business_name: z.ZodOptional<z.ZodString>;
+    contact: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+        address: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        email: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        hours: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        phone: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        social: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            platform: z.ZodString;
+            url: z.ZodString;
+        }, z.core.$strict>>>>;
+    }, z.core.$strict>>>;
+    description: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    ecommerce: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        products_summary: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    goals: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+    keep_existing_content: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    languages: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString>>>;
+    notes: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    pages: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodObject<{
+        purpose: z.ZodOptional<z.ZodString>;
+        sections: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        slug: z.ZodString;
+        title: z.ZodString;
+    }, z.core.$strict>>>>;
+    primary_language: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    site_type: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        other: "other";
+        "landing-page": "landing-page";
+        "multi-page": "multi-page";
+        blog: "blog";
+        store: "store";
+        portfolio: "portfolio";
+    }>>>;
+    status: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        draft: "draft";
+        confirmed: "confirmed";
+        built: "built";
+    }>>>;
+    tagline: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+    updated_at: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+}, z.core.$strict>;
+export type CortexSiteBriefInput = z.infer<typeof cortexSiteBriefInputSchema>;
+export declare const cortexBuildSessionSchema: z.ZodObject<{
+    actorUserId: z.ZodString;
+    createdAt: z.ZodString;
+    expiresAt: z.ZodString;
+    id: z.ZodString;
+    summary: z.ZodString;
+}, z.core.$strict>;
+export type CortexBuildSession = z.infer<typeof cortexBuildSessionSchema>;
+/** Parse a stored brief leniently: an unreadable row is treated as "no brief". */
+export declare function safeParseCortexSiteBrief(value: unknown): CortexSiteBrief | null;
+/** A build session is only usable by the admin who opened it, and only until it expires. */
+export declare function isCortexBuildSessionUsable(session: CortexBuildSession | null | undefined, params: {
+    actorUserId: string | null | undefined;
+    now?: Date;
+}): session is CortexBuildSession;
+/**
+ * Compact, prompt-ready rendering of the brief. The model reads this at the top of
+ * every conversation once a brief exists, so it is deliberately short: facts, not
+ * prose, and never the raw JSON (which wastes tokens on braces and quotes).
+ */
+export declare function formatCortexSiteBriefForPrompt(brief: CortexSiteBrief): string;

package/lib/site-brief.es.js

@@ -0,0 +1,109 @@
+import "./zod-config.es.js";
+import { z as e } from "zod";
+const d = "cortex_ai_site_brief", h = "cortex_ai_build_session", r = e.string().trim().min(2).max(10), c = e.strictObject({
+  purpose: e.string().trim().max(600).optional().describe("What this page is for and what a visitor should do there."),
+  sections: e.array(e.string().trim().min(1).max(200)).max(20).optional().describe('Planned sections, top to bottom, e.g. ["hero", "services", "testimonials", "contact form"].'),
+  slug: e.string().trim().min(1).max(120).describe('URL slug in the primary language, e.g. "home", "services", "contact".'),
+  title: e.string().trim().min(1).max(200)
+}), m = e.strictObject({
+  accent_color: e.string().trim().max(40).optional(),
+  color_scheme: e.enum(["light", "dark"]).optional().describe("Overall look the client prefers."),
+  font_style: e.string().trim().max(120).optional().describe('e.g. "clean sans-serif", "elegant serif".'),
+  logo_notes: e.string().trim().max(600).optional().describe("Whether they have a logo, where it is, or what to do meanwhile."),
+  primary_color: e.string().trim().max(40).optional().describe('Hex or plain colour name, e.g. "#1e6f5c" or "forest green".'),
+  secondary_color: e.string().trim().max(40).optional(),
+  style_keywords: e.array(e.string().trim().min(1).max(60)).max(12).optional().describe('e.g. ["minimal", "warm", "premium"].'),
+  tone: e.string().trim().max(200).optional().describe('Voice for the copy, e.g. "friendly and plain-spoken".')
+}).partial(), p = e.strictObject({
+  address: e.string().trim().max(400).optional(),
+  email: e.string().trim().max(200).optional(),
+  hours: e.string().trim().max(400).optional(),
+  phone: e.string().trim().max(60).optional(),
+  social: e.array(
+    e.strictObject({
+      platform: e.string().trim().min(1).max(60),
+      url: e.string().trim().min(1).max(2048)
+    })
+  ).max(12).optional()
+}).partial(), l = e.strictObject({
+  audience: e.string().trim().max(1e3).optional().describe("Who the site is for."),
+  brand: m.optional(),
+  business_name: e.string().trim().min(1).max(160),
+  contact: p.optional(),
+  description: e.string().trim().max(3e3).optional().describe("What the business does, in the client's own words where possible."),
+  ecommerce: e.strictObject({
+    enabled: e.boolean().default(!1),
+    products_summary: e.string().trim().max(1e3).optional()
+  }).optional(),
+  goals: e.array(e.string().trim().min(1).max(300)).max(10).optional().describe('What the site must achieve, e.g. ["get quote requests", "show the menu"].'),
+  keep_existing_content: e.boolean().default(!1).describe("true when the client wants existing pages/posts kept rather than replaced."),
+  languages: e.array(r).min(1).max(10).default(["en"]).describe("Locale codes the public site must offer, primary first."),
+  notes: e.string().trim().max(4e3).optional().describe("Anything else the client said that matters."),
+  pages: e.array(c).max(30).default([]).describe('The pages to build. A one-page landing site is a single "home" entry.'),
+  primary_language: r.default("en"),
+  site_type: e.enum(["landing-page", "multi-page", "blog", "store", "portfolio", "other"]).default("multi-page"),
+  status: e.enum(["draft", "confirmed", "built"]).default("draft").describe("draft while interviewing, confirmed once the client approved the plan, built when the build finished."),
+  tagline: e.string().trim().max(200).optional(),
+  updated_at: e.string().max(80).optional()
+}), _ = l.partial(), x = e.strictObject({
+  actorUserId: e.string().min(1),
+  createdAt: e.string().min(1),
+  expiresAt: e.string().min(1),
+  id: e.string().min(1),
+  summary: e.string().max(4e3)
+});
+function y(t) {
+  const o = l.safeParse(t);
+  return o.success ? o.data : null;
+}
+function f(t, o) {
+  if (!t || !o.actorUserId || t.actorUserId !== o.actorUserId)
+    return !1;
+  const i = Date.parse(t.expiresAt), n = (o.now ?? /* @__PURE__ */ new Date()).getTime();
+  return Number.isFinite(i) && i > n;
+}
+function $(t) {
+  const o = [
+    `Business: ${t.business_name}${t.tagline ? ` — ${t.tagline}` : ""}`
+  ];
+  t.description && o.push(`What they do: ${t.description}`), t.audience && o.push(`Audience: ${t.audience}`), t.goals?.length && o.push(`Goals: ${t.goals.join("; ")}`), o.push(`Site type: ${t.site_type}. Languages: ${t.languages.join(", ")} (primary ${t.primary_language}).`), t.pages.length > 0 && o.push(
+    `Pages: ${t.pages.map((s) => `${s.title} (/${s.slug})${s.purpose ? ` — ${s.purpose}` : ""}`).join("; ")}`
+  );
+  const i = t.brand;
+  if (i && Object.keys(i).length > 0) {
+    const s = [
+      i.primary_color ? `primary ${i.primary_color}` : null,
+      i.secondary_color ? `secondary ${i.secondary_color}` : null,
+      i.accent_color ? `accent ${i.accent_color}` : null,
+      i.color_scheme ? `${i.color_scheme} scheme` : null,
+      i.font_style ? `fonts: ${i.font_style}` : null,
+      i.tone ? `tone: ${i.tone}` : null,
+      i.style_keywords?.length ? `style: ${i.style_keywords.join(", ")}` : null,
+      i.logo_notes ? `logo: ${i.logo_notes}` : null
+    ].filter(Boolean);
+    s.length > 0 && o.push(`Brand: ${s.join("; ")}`);
+  }
+  const n = t.contact;
+  if (n && Object.keys(n).length > 0) {
+    const s = [
+      n.email ? `email ${n.email}` : null,
+      n.phone ? `phone ${n.phone}` : null,
+      n.address ? `address ${n.address}` : null,
+      n.hours ? `hours ${n.hours}` : null,
+      n.social?.length ? `social: ${n.social.map((a) => `${a.platform} ${a.url}`).join(", ")}` : null
+    ].filter(Boolean);
+    s.length > 0 && o.push(`Contact: ${s.join("; ")}`);
+  }
+  return t.ecommerce?.enabled && o.push(`Ecommerce: yes${t.ecommerce.products_summary ? ` — ${t.ecommerce.products_summary}` : ""}`), t.keep_existing_content && o.push("Keep existing content: yes (do not wipe pages or posts)."), t.notes && o.push(`Notes: ${t.notes}`), o.push(`Brief status: ${t.status}.`), o.join(`
+`);
+}
+export {
+  h as CORTEX_AI_BUILD_SESSION_SETTING_KEY,
+  d as CORTEX_AI_SITE_BRIEF_SETTING_KEY,
+  x as cortexBuildSessionSchema,
+  _ as cortexSiteBriefInputSchema,
+  l as cortexSiteBriefSchema,
+  $ as formatCortexSiteBriefForPrompt,
+  f as isCortexBuildSessionUsable,
+  y as safeParseCortexSiteBrief
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextblock-cms/cortex",
-  "version": "0.17.6",
+  "version": "0.17.8",
   "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.17.6",
-    "@nextblock-cms/ecommerce": "npm:@nextblock-cms/ecom@^0.17.6",
-    "@nextblock-cms/utils": "^0.17.6",
+    "@nextblock-cms/db": "^0.17.8",
+    "@nextblock-cms/ecommerce": "npm:@nextblock-cms/ecom@^0.17.8",
+    "@nextblock-cms/utils": "^0.17.8",
     "ai": "^6.0.170",
     "zod": "^4.3.6"
   },