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

package/dist/app.js

@@ -1,7 +1,7 @@
 import {
   getServerVersion,
   serializeAiConfig
-} from "./chunk-ATPWU3CU.js";
+} from "./chunk-NXEXOHBD.js";
 import "./chunk-CRK7N6RR.js";
 import {
   getCollectionSchema,

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

@@ -99,10 +99,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.")
       })
     }),
@@ -272,6 +274,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 +424,59 @@ async function generateChatTitle(model, messages) {
   }
   return fallback;
 }
+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"
+  } = options;
   const languageModel = resolveLanguageModel(model);
-  const tools = model.capabilities?.tools === false ? {} : createCmsTools();
+  const tools = model.capabilities?.tools === false ? {} : executionMode === "read" || executionMode === "suggest" ? createReadOnlyCmsTools() : createCmsTools();
   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 +484,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,
@@ -716,7 +776,7 @@ function extractJsonFromResponse(responseText) {
 // package.json
 var package_default = {
   name: "@blinkk/root-cms",
-  version: "3.0.1-beta.2",
+  version: "3.0.1-beta.3",
   author: "s@blinkk.com",
   license: "MIT",
   engines: {
@@ -885,7 +945,7 @@ var package_default = {
     yjs: "13.6.27"
   },
   peerDependencies: {
-    "@blinkk/root": "3.0.1-beta.2",
+    "@blinkk/root": "3.0.1-beta.3",
     "firebase-admin": ">=11",
     "firebase-functions": ">=4"
   },
@@ -909,6 +969,7 @@ export {
   serializeAiConfig,
   getAiConfig,
   findModel,
+  normalizeExecutionMode,
   ChatStore,
   runChatStream,
   runEditObjectStream,

package/dist/plugin.js

@@ -6,12 +6,13 @@ import {
   generatePublishMessage,
   getAiConfig,
   getServerVersion,
+  normalizeExecutionMode,
   runChatStream,
   runEditObjectStream,
   serializeAiConfig,
   summarizeDiff,
   translateString
-} from "./chunk-ATPWU3CU.js";
+} from "./chunk-NXEXOHBD.js";
 import {
   SearchIndexService,
   runCronJobs
@@ -555,6 +556,7 @@ function api(server, options) {
       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() : "";
@@ -582,7 +584,8 @@ function api(server, options) {
         model,
         messages,
         chatId,
-        user: req.user.email
+        user: req.user.email,
+        executionMode
       });
       streamResponse.headers.set("x-root-cms-chat-id", chatId);
       await pipeWebResponse(streamResponse, res);