@blinkk/root-cms 3.0.1-beta.2 → 3.0.1-beta.4

package/dist/{chunk-ATPWU3CU.js → chunk-MVS2NLZM.js}

@@ -1,3 +1,10 @@
+import {
+  SearchIndexService
+} from "./chunk-C245C557.js";
+import {
+  normalizeSlug
+} from "./chunk-2BSW7SIH.js";
+
 // core/ai.ts
 import crypto from "crypto";
 import { promises as fs } from "fs";
@@ -18,6 +25,40 @@ import { Timestamp } from "firebase-admin/firestore";
 // core/ai-tools.ts
 import { tool } from "ai";
 import { z } from "zod";
+
+// shared/marshal.ts
+function isArrayObject(data) {
+  return data !== null && typeof data === "object" && !Array.isArray(data) && Array.isArray(data._array);
+}
+function unmarshalData(data, options) {
+  if (data === null || data === void 0) {
+    return data;
+  }
+  if (typeof data !== "object") {
+    return data;
+  }
+  if (Array.isArray(data)) {
+    return data.map((item) => unmarshalData(item, options));
+  }
+  if (options?.isTimestamp?.(data)) {
+    return options.timestampToValue ? options.timestampToValue(data) : data;
+  }
+  if (typeof data.toMillis === "function") {
+    return data.toMillis();
+  }
+  if (isArrayObject(data)) {
+    return data._array.map(
+      (key) => unmarshalData(data[key] ?? {}, options)
+    );
+  }
+  const out = {};
+  for (const [k, v] of Object.entries(data)) {
+    out[k] = unmarshalData(v, options);
+  }
+  return out;
+}
+
+// core/ai-tools.ts
 var READ_ONLY_CMS_TOOL_NAMES = [
   "collections_list",
   "docs_list",
@@ -27,8 +68,8 @@ var READ_ONLY_CMS_TOOL_NAMES = [
   "doc_listVersions",
   "schema_get"
 ];
-function createReadOnlyCmsTools() {
-  const all = createCmsTools();
+function createReadOnlyCmsTools(ctx) {
+  const all = createCmsTools(ctx);
   const out = {};
   for (const name of READ_ONLY_CMS_TOOL_NAMES) {
     if (all[name]) {
@@ -37,11 +78,21 @@ function createReadOnlyCmsTools() {
   }
   return out;
 }
-function createCmsTools() {
+function createCmsTools(ctx) {
   return {
     collections_list: tool({
       description: "List all CMS collections defined in the project. Returns each collection id along with optional name/description metadata.",
-      inputSchema: z.object({})
+      inputSchema: z.object({}),
+      execute: async () => {
+        const collections = await ctx.loadAllCollections();
+        return {
+          collections: Object.entries(collections).map(([id, meta]) => ({
+            id,
+            name: meta.name,
+            description: meta.description
+          }))
+        };
+      }
     }),
     docs_list: tool({
       description: "List documents inside a CMS collection. Returns up to `limit` docs (default 25, max 100). Use this to explore content before reading individual docs.",
@@ -49,14 +100,32 @@ function createCmsTools() {
         collectionId: z.string().describe('Collection id, e.g. "Pages" or "BlogPosts".'),
         mode: z.enum(["draft", "published"]).default("draft").describe("Whether to read draft or published versions."),
         limit: z.number().int().min(1).max(100).default(25)
-      })
+      }),
+      execute: async ({ collectionId, mode = "draft", limit = 25 }) => {
+        const max = clampInt(limit, 1, 100, 25);
+        const result = await ctx.cmsClient.listDocs(collectionId, {
+          mode,
+          limit: max
+        });
+        return {
+          docs: result.docs.map((d) => ({
+            id: d.id,
+            slug: d.slug,
+            sys: unmarshalSys(d.sys)
+          }))
+        };
+      }
     }),
     docs_search: tool({
       description: "Run a full-text search across all indexed CMS docs. Returns the top matching doc ids ordered by relevance.",
       inputSchema: z.object({
         query: z.string().min(1),
         limit: z.number().int().min(1).max(50).default(10)
-      })
+      }),
+      execute: async ({ query, limit = 10 }) => {
+        const max = clampInt(limit, 1, 50, 10);
+        return await ctx.search(query, { limit: max });
+      }
     }),
     doc_get: tool({
       description: "Read a single CMS document. Returns the doc fields plus system metadata. Use this when you need the full content of a doc.",
@@ -65,7 +134,24 @@ function createCmsTools() {
           'Full doc id in the form "Collection/slug" (e.g. "Pages/home").'
         ),
         mode: z.enum(["draft", "published"]).default("draft")
-      })
+      }),
+      execute: async ({ docId, mode = "draft" }) => {
+        const { collection, slug } = parseDocId(docId);
+        const raw = await ctx.cmsClient.getRawDoc(collection, slug, { mode });
+        if (!raw) {
+          return { found: false };
+        }
+        return {
+          found: true,
+          doc: {
+            id: raw.id,
+            collection: raw.collection,
+            slug: raw.slug,
+            sys: unmarshalSys(raw.sys),
+            fields: unmarshalFields(raw.fields)
+          }
+        };
+      }
     }),
     doc_getVersion: tool({
       description: 'Read a specific version of a CMS document. Use versionId "draft" or "published" for the current draft/published state, or a numeric timestamp for a historical version (from `doc_listVersions`).',
@@ -76,7 +162,33 @@ function createCmsTools() {
         versionId: z.string().describe(
           'Version identifier: "draft", "published", or a numeric timestamp.'
         )
-      })
+      }),
+      execute: async ({ docId, versionId }) => {
+        const { collection, slug } = parseDocId(docId);
+        let path2;
+        if (versionId === "draft") {
+          path2 = `Projects/${ctx.cmsClient.projectId}/Collections/${collection}/Drafts/${slug}`;
+        } else if (versionId === "published") {
+          path2 = `Projects/${ctx.cmsClient.projectId}/Collections/${collection}/Published/${slug}`;
+        } else {
+          path2 = `Projects/${ctx.cmsClient.projectId}/Collections/${collection}/Drafts/${slug}/Versions/${versionId}`;
+        }
+        const snap = await ctx.cmsClient.db.doc(path2).get();
+        if (!snap.exists) {
+          return { found: false };
+        }
+        const raw = snap.data();
+        return {
+          found: true,
+          doc: {
+            id: raw.id,
+            collection: raw.collection,
+            slug: raw.slug,
+            sys: unmarshalSys(raw.sys),
+            fields: unmarshalFields(raw.fields)
+          }
+        };
+      }
     }),
     doc_set: tool({
       description: "Replace the entire draft fields payload of a CMS document. Pass the full JSON object that should become the new draft contents \u2014 any fields omitted will be removed. The payload is validated against the collection schema and the call is rejected on validation errors. Prefer `doc_updateField` for targeted edits. Only writes the draft version; users must publish separately. Always confirm with the user before calling.",
@@ -99,10 +211,12 @@ function createCmsTools() {
       })
     }),
     doc_updateField: tool({
-      description: 'Update a single field on a draft CMS document by JSON path. Use dotted paths (e.g. "hero.title") and array indices (e.g. "sections.0.heading"). The value is validated against the field schema and the call is rejected if the shape is wrong (e.g. passing a string to a richtext field). Only updates the draft version; users must publish separately. Always confirm with the user before calling.',
+      description: 'Update a single field on a draft CMS document by JSON path. Paths are relative to the doc fields object; do not prefix them with "fields.". Use dotted paths (e.g. "hero.title") and zero-based array indices. For example, update the first module title with path "content.modules.0.title". To append or remove array items, first read the current doc, then set the whole array path (e.g. "content.modules") to the updated array. The value is validated against the field schema and the call is rejected if the shape is wrong (e.g. passing a string to a richtext field). Only updates the draft version; users must publish separately. Always confirm with the user before calling.',
       inputSchema: z.object({
         docId: z.string(),
-        path: z.string().describe("Dotted JSON path within the fields object."),
+        path: z.string().describe(
+          'Dotted JSON path within the fields object, e.g. "content.modules.0.title".'
+        ),
         value: z.any().describe("JSON value to set at the path.")
       })
     }),
@@ -126,7 +240,24 @@ function createCmsTools() {
           'Full doc id in the form "Collection/slug" (e.g. "Pages/home").'
         ),
         limit: z.number().int().min(1).max(50).default(10)
-      })
+      }),
+      execute: async ({ docId, limit = 10 }) => {
+        const { collection, slug } = parseDocId(docId);
+        const max = clampInt(limit, 1, 50, 10);
+        const path2 = `Projects/${ctx.cmsClient.projectId}/Collections/${collection}/Drafts/${slug}/Versions`;
+        const snap = await ctx.cmsClient.db.collection(path2).orderBy("sys.modifiedAt", "desc").limit(max).get();
+        return {
+          versions: snap.docs.map((d) => {
+            const data = d.data();
+            return {
+              versionId: d.id,
+              sys: unmarshalSys(data.sys),
+              tags: data.tags || [],
+              publishMessage: data.publishMessage
+            };
+          })
+        };
+      }
     }),
     doc_translateField: tool({
       description: "Translate a text value into one or more target locales using AI. Returns the translated strings keyed by locale. Use this to help with localization workflows.",
@@ -144,10 +275,63 @@ function createCmsTools() {
       description: "Get the field schema for a CMS collection. Returns the full field definitions including types, labels, and validation rules. Use this to understand what fields a collection supports before creating or editing docs.",
       inputSchema: z.object({
         collectionId: z.string().describe('Collection id, e.g. "Pages" or "BlogPosts".')
-      })
+      }),
+      execute: async ({ collectionId }) => {
+        const schema = await ctx.loadCollection(collectionId);
+        if (!schema) {
+          return { found: false, collectionId };
+        }
+        return {
+          found: true,
+          collectionId,
+          fields: simplifyFields(schema.fields || [])
+        };
+      }
     })
   };
 }
+function parseDocId(docId) {
+  const idx = docId.indexOf("/");
+  if (idx <= 0 || idx === docId.length - 1) {
+    throw new Error(`invalid docId: "${docId}" (expected "Collection/slug")`);
+  }
+  return {
+    collection: docId.slice(0, idx),
+    slug: normalizeSlug(docId.slice(idx + 1))
+  };
+}
+function clampInt(value, min, max, fallback) {
+  const n = Number.isFinite(value) ? Math.trunc(value) : fallback;
+  return Math.min(Math.max(n, min), max);
+}
+function unmarshalSys(sys) {
+  return unmarshalData(sys ?? {});
+}
+function unmarshalFields(fields) {
+  return unmarshalData(fields ?? {});
+}
+function simplifyFields(fields) {
+  return fields.map((f) => {
+    const out = { id: f.id, type: f.type };
+    if (f.label) out.label = f.label;
+    if (f.description) out.description = f.description;
+    if (f.required) out.required = true;
+    if (f.translate) out.translate = true;
+    if (f.options) out.options = f.options;
+    if (f.type === "object" && f.fields) {
+      out.fields = simplifyFields(f.fields);
+    }
+    if (f.type === "array" && f.of) {
+      out.of = simplifyFields([f.of])[0];
+    }
+    if (f.type === "oneof" && f.types) {
+      out.types = f.types.map(
+        (t) => typeof t === "string" ? t : { id: t.id, fields: simplifyFields(t.fields || []) }
+      );
+    }
+    return out;
+  });
+}
 
 // core/ai.ts
 var ROOT_MD_FILENAME = "ROOT.md";
@@ -272,6 +456,12 @@ function findImageModel(config, modelId) {
   const defaultId = config.defaultImageModel || imageModels[0]?.id;
   return imageModels.find((m) => m.id === defaultId) || null;
 }
+function normalizeExecutionMode(value) {
+  if (value === "read" || value === "suggest" || value === "approve" || value === "auto") {
+    return value;
+  }
+  return "approve";
+}
 function requireDefaultModel(rootConfig) {
   const config = getAiConfig(rootConfig);
   if (!config) {
@@ -416,10 +606,87 @@ async function generateChatTitle(model, messages) {
   }
   return fallback;
 }
+function buildCmsToolContext(options) {
+  let searchService = null;
+  return {
+    rootConfig: options.rootConfig,
+    cmsClient: options.cmsClient,
+    user: options.user,
+    loadCollection: options.loadCollection,
+    loadAllCollections: options.loadAllCollections,
+    search: async (query, opts) => {
+      if (!searchService) {
+        searchService = new SearchIndexService(
+          options.rootConfig,
+          options.loadCollection
+        );
+      }
+      return await searchService.search(query, opts);
+    }
+  };
+}
+function buildExecutionModePrompt(mode) {
+  const common = [
+    "Root AI execution workflow:",
+    "- For content-changing tasks, first gather the relevant context with read tools.",
+    "- Before the first write, briefly state a plan that names the target docs, fields, intended changes, assumptions, and validation checks.",
+    "- Never claim a draft change was applied until the matching tool output reports success.",
+    "- After write tools finish, provide a short receipt with changed docs, changed fields, validation result, and a reminder that publishing remains manual."
+  ];
+  if (mode === "read") {
+    common.push(
+      "",
+      "Current execution mode: Read only.",
+      "- You only have read-only CMS tools.",
+      "- Do not propose tool writes or ask for approval to write. Answer from the context you can read."
+    );
+  } else if (mode === "suggest") {
+    common.push(
+      "",
+      "Current execution mode: Suggest changes.",
+      "- You only have read-only CMS tools.",
+      "- Do not call write tools. Provide proposed edits, field paths, and rationale for the user to review."
+    );
+  } else if (mode === "approve") {
+    common.push(
+      "",
+      "Current execution mode: Ask before writing.",
+      "- Write tools are available, but the UI will pause each draft write for user approval with a diff.",
+      "- Call write tools only after you have enough context to make a specific, reviewable change.",
+      "- If the user rejects a write, revise the plan instead of retrying the same write."
+    );
+  } else {
+    common.push(
+      "",
+      "Current execution mode: Auto-apply draft edits.",
+      "- Draft-only write tools may run without an approval pause.",
+      "- Keep edits narrowly scoped to the user request and summarize the exact draft changes afterward."
+    );
+  }
+  return common.join("\n");
+}
 async function runChatStream(options) {
-  const { rootConfig, model, config, messages, cmsClient, user, chatId } = options;
+  const {
+    rootConfig,
+    model,
+    config,
+    messages,
+    cmsClient,
+    user,
+    chatId,
+    executionMode = "approve",
+    loadCollection,
+    loadAllCollections
+  } = options;
   const languageModel = resolveLanguageModel(model);
-  const tools = model.capabilities?.tools === false ? {} : createCmsTools();
+  const toolContext = buildCmsToolContext({
+    rootConfig,
+    cmsClient,
+    user,
+    loadCollection,
+    loadAllCollections
+  });
+  const tools = model.capabilities?.tools === false ? {} : executionMode === "read" || executionMode === "suggest" ? createReadOnlyCmsTools(toolContext) : createCmsTools(toolContext);
   const basePrompt = config.systemPrompt || [
     "You are an assistant embedded in the Root CMS admin UI.",
     "Help the user explore and edit content, answer questions about",
@@ -427,7 +694,10 @@ async function runChatStream(options) {
     "Be concise and use markdown for rich responses."
   ].join(" ");
   const rootMd = await readRootMd(rootConfig.rootDir);
-  const systemPrompt = buildSystemPrompt(basePrompt, rootMd);
+  const systemPrompt = buildSystemPrompt(
+    [basePrompt, "", buildExecutionModePrompt(executionMode)].join("\n"),
+    rootMd
+  );
   const modelMessages = await convertToModelMessages(messages, { tools });
   const result = streamText({
     model: languageModel,
@@ -459,9 +729,26 @@ async function runChatStream(options) {
   });
 }
 async function runEditObjectStream(options) {
-  const { rootConfig, model, config, messages, editData } = options;
+  const {
+    rootConfig,
+    cmsClient,
+    user,
+    model,
+    config,
+    messages,
+    editData,
+    loadCollection,
+    loadAllCollections
+  } = options;
   const languageModel = resolveLanguageModel(model);
-  const tools = model.capabilities?.tools === false ? {} : createReadOnlyCmsTools();
+  const toolContext = buildCmsToolContext({
+    rootConfig,
+    cmsClient,
+    user,
+    loadCollection,
+    loadAllCollections
+  });
+  const tools = model.capabilities?.tools === false ? {} : createReadOnlyCmsTools(toolContext);
   const editPromptText = (await import("./edit-XX3LAGK6.js")).default;
   const promptParts = [
     stripLegacyEditOutputSpec(editPromptText),
@@ -716,7 +1003,7 @@ function extractJsonFromResponse(responseText) {
 // package.json
 var package_default = {
   name: "@blinkk/root-cms",
-  version: "3.0.1-beta.2",
+  version: "3.0.1-beta.4",
   author: "s@blinkk.com",
   license: "MIT",
   engines: {
@@ -885,7 +1172,7 @@ var package_default = {
     yjs: "13.6.27"
   },
   peerDependencies: {
-    "@blinkk/root": "3.0.1-beta.2",
+    "@blinkk/root": "3.0.1-beta.4",
     "firebase-admin": ">=11",
     "firebase-functions": ">=4"
   },
@@ -909,6 +1196,7 @@ export {
   serializeAiConfig,
   getAiConfig,
   findModel,
+  normalizeExecutionMode,
   ChatStore,
   runChatStream,
   runEditObjectStream,

package/dist/cli.js

@@ -5,8 +5,7 @@ import {
   RootCMSClient,
   getCmsPlugin,
   unmarshalData
-} from "./chunk-F4SODS5S.js";
-import "./chunk-CRK7N6RR.js";
+} from "./chunk-2BSW7SIH.js";
 import "./chunk-MLKGABMK.js";
 
 // cli/cli.ts

package/dist/client.js

@@ -12,8 +12,7 @@ import {
   translationsForLocale,
   unmarshalArray,
   unmarshalData
-} from "./chunk-F4SODS5S.js";
-import "./chunk-CRK7N6RR.js";
+} from "./chunk-2BSW7SIH.js";
 import "./chunk-MLKGABMK.js";
 export {
   BatchRequest,

package/dist/core.js

@@ -16,8 +16,7 @@ import {
   translationsForLocale,
   unmarshalArray,
   unmarshalData
-} from "./chunk-F4SODS5S.js";
-import "./chunk-CRK7N6RR.js";
+} from "./chunk-2BSW7SIH.js";
 import {
   __export
 } from "./chunk-MLKGABMK.js";

package/dist/functions.js

@@ -1,8 +1,8 @@
 import {
   runCronJobs
-} from "./chunk-TRM4MQHU.js";
-import "./chunk-F4SODS5S.js";
-import "./chunk-CRK7N6RR.js";
+} from "./chunk-BGTUWIV6.js";
+import "./chunk-C245C557.js";
+import "./chunk-2BSW7SIH.js";
 import "./chunk-MLKGABMK.js";
 
 // core/functions.ts

package/dist/plugin.js

@@ -6,22 +6,24 @@ import {
   generatePublishMessage,
   getAiConfig,
   getServerVersion,
+  normalizeExecutionMode,
   runChatStream,
   runEditObjectStream,
   serializeAiConfig,
   summarizeDiff,
   translateString
-} from "./chunk-ATPWU3CU.js";
+} from "./chunk-MVS2NLZM.js";
 import {
-  SearchIndexService,
   runCronJobs
-} from "./chunk-TRM4MQHU.js";
+} from "./chunk-BGTUWIV6.js";
+import {
+  SearchIndexService
+} from "./chunk-C245C557.js";
 import {
   RootCMSClient,
   parseDocId,
   unmarshalData
-} from "./chunk-F4SODS5S.js";
-import "./chunk-CRK7N6RR.js";
+} from "./chunk-2BSW7SIH.js";
 import "./chunk-MLKGABMK.js";
 
 // core/plugin.ts
@@ -545,24 +547,22 @@ function api(server, options) {
       return;
     }
     const body = req.body || {};
-    const messages = body.messages || [];
-    if (!Array.isArray(messages) || messages.length === 0) {
-      res.status(400).json({ success: false, error: "MISSING_MESSAGES" });
-      return;
-    }
     const model = findModel(aiConfig, body.modelId);
     if (!model) {
       res.status(400).json({ success: false, error: "UNKNOWN_MODEL" });
       return;
     }
+    const executionMode = normalizeExecutionMode(body.executionMode);
     const cmsClient = new RootCMSClient(req.rootConfig);
     const store = new ChatStore(cmsClient, req.user.email);
     const requestedChatId = typeof body.chatId === "string" ? body.chatId.trim() : "";
     let chatId = "";
+    let storedMessages = [];
     if (requestedChatId) {
       const existing = await store.getChat(requestedChatId);
       if (existing) {
         chatId = existing.id;
+        storedMessages = existing.messages || [];
       } else {
         const created = await store.createChat({
           id: requestedChatId,
@@ -574,6 +574,15 @@ function api(server, options) {
       const created = await store.createChat({ modelId: model.id });
       chatId = created.id;
     }
+    let messages;
+    if (body.message && typeof body.message === "object") {
+      messages = [...storedMessages, body.message];
+    } else if (Array.isArray(body.messages) && body.messages.length > 0) {
+      messages = body.messages;
+    } else {
+      res.status(400).json({ success: false, error: "MISSING_MESSAGES" });
+      return;
+    }
     try {
       const streamResponse = await runChatStream({
         rootConfig: req.rootConfig,
@@ -582,7 +591,10 @@ function api(server, options) {
         model,
         messages,
         chatId,
-        user: req.user.email
+        user: req.user.email,
+        executionMode,
+        loadCollection: (collectionId) => getCollectionSchema(req, collectionId),
+        loadAllCollections: async () => (await options.getRenderer(req)).getCollections()
       });
       streamResponse.headers.set("x-root-cms-chat-id", chatId);
       await pipeWebResponse(streamResponse, res);
@@ -625,10 +637,14 @@ function api(server, options) {
       try {
         const streamResponse = await runEditObjectStream({
           rootConfig: req.rootConfig,
+          cmsClient: new RootCMSClient(req.rootConfig),
+          user: req.user.email,
           config: aiConfig,
           model,
           messages,
-          editData: body.editData
+          editData: body.editData,
+          loadCollection: (collectionId) => getCollectionSchema(req, collectionId),
+          loadAllCollections: async () => (await options.getRenderer(req)).getCollections()
         });
         await pipeWebResponse(streamResponse, res);
       } catch (err) {
@@ -1439,6 +1455,10 @@ function cmsPlugin(options) {
      * Attaches CMS-specific middleware to the Root.js server.
      */
     configureServer: async (server, serverOptions) => {
+      server.use(
+        ["/cms/api/ai.chat", "/cms/api/ai.edit_object"],
+        bodyParser.json({ limit: "4mb" })
+      );
       server.use(bodyParser.json());
       server.use(
         (err, req, res, next) => {