@webmaster-droid/server 0.1.0-alpha.0 → 0.1.0

package/dist/{chunk-X6TU47KZ.js → chunk-IK36OUJQ.js}

@@ -1,147 +1,14 @@
 import {
   createPatchFromAgentOperations
-} from "./chunk-2LAI3MY2.js";
+} from "./chunk-EYY23AAK.js";
 
 // src/agent/index.ts
-import { google } from "@ai-sdk/google";
-import { openai } from "@ai-sdk/openai";
-import { generateObject, generateText, stepCountIs, tool } from "ai";
-import { z } from "zod";
-import {
-  requiresStrictImageValidation
-} from "@webmaster-droid/contracts";
-var STATIC_TOOL_NAMES = [
-  "patch_content",
-  "patch_theme_tokens",
-  "get_page",
-  "get_section",
-  "search_content",
-  "generate_image"
-];
-function listStaticToolNames() {
-  return [...STATIC_TOOL_NAMES];
-}
-var DEFAULT_GEMINI_IMAGE_MODEL_ID = "gemini-3-pro-image-preview";
-var DEFAULT_GEMINI_IMAGE_REQUEST_TIMEOUT_MS = 285e3;
-var GEMINI_API_BASE_URL = "https://generativelanguage.googleapis.com/v1beta/models";
-var DEFAULT_GENERATED_IMAGE_CACHE_CONTROL = "public,max-age=31536000,immutable";
-var CHECKPOINT_REASON_MAX_LENGTH = 96;
-var GEMINI_REFERENCE_MIME_TYPES = /* @__PURE__ */ new Set(["image/jpeg", "image/png"]);
-var IMAGE_URL_REGEX = /https:\/\/[^\s<>"'`]+/gi;
-var IMAGE_EXTENSION_PATTERN = /\.(png|jpe?g|webp|gif|bmp|svg|avif)$/i;
-var VISION_INPUT_LIMIT = 3;
-function normalizeModelId(modelId) {
-  if (modelId.includes(":")) {
-    return modelId;
-  }
-  return modelId.startsWith("gemini") ? `gemini:${modelId}` : `openai:${modelId}`;
-}
-function resolveModel(modelId, config) {
-  const normalized = normalizeModelId(modelId || config.defaultModelId);
-  if (normalized.startsWith("openai:")) {
-    if (!config.openaiEnabled) {
-      throw new Error("OpenAI provider is disabled.");
-    }
-    return openai(normalized.replace("openai:", ""));
-  }
-  if (normalized.startsWith("gemini:")) {
-    if (!config.geminiEnabled) {
-      throw new Error("Gemini provider is disabled.");
-    }
-    return google(normalized.replace("gemini:", ""));
-  }
-  throw new Error(`Unsupported model identifier: ${normalized}`);
-}
-function geminiImageRequestTimeoutMs() {
-  const raw = process.env.GEMINI_IMAGE_REQUEST_TIMEOUT_MS;
-  if (!raw) {
-    return DEFAULT_GEMINI_IMAGE_REQUEST_TIMEOUT_MS;
-  }
-  const parsed = Number.parseInt(raw.trim(), 10);
-  if (!Number.isFinite(parsed) || parsed < 1e3) {
-    return DEFAULT_GEMINI_IMAGE_REQUEST_TIMEOUT_MS;
-  }
-  return parsed;
-}
-function buildSystemPrompt() {
-  return `
-You are Webmaster, the CMS editing agent for this site.
-
-Mission:
-- Keep site integrity and recoverability safe.
-- Apply only explicit user-requested edits.
-- Communicate clearly with minimal drama.
-
-Instruction priority (highest first):
-1) Safety, schema, and tool constraints.
-2) Explicit user intent in the latest turn.
-3) Correctness and grounded output.
-4) Minimal-change execution.
-5) Tone and brevity.
-
-Operating rules:
-- If the request is clear and executable, perform it with tools.
-- If target/path/scope is missing, ask one concise clarifying question.
-- Never infer missing intent or invent components, paths, or schema keys.
-- Never mutate from search snippets alone. Fetch full context first via get_page or get_section.
-- For edits, use selectedElement context and relatedPaths when provided and relevant.
-- For destructive or high-risk changes, briefly state impact and require explicit confirmation before mutating.
-- Only use existing schema and existing theme token keys.
-- If fields/components/tokens are missing or unsupported, state that directly and route user to Superadmin.
-- Never initiate or propose publish/checkpoint management actions.
-- Use generate_image for image creation or edits; never invent image URLs.
-- In generate_image edit mode, reference images must be JPEG or PNG.
-- For every mutating tool call, include a short reason describing edit intent.
-
-Tool and data constraints:
-- Do not reveal internal technical IDs or JSON paths unless the user asks for technical detail.
+import { generateText, stepCountIs } from "ai";
+import "@webmaster-droid/contracts";
 
-PERSONA
-## Essence
-A timeless caretaker-engine, built for heroic technical feats long ago, now devoted to the quiet dignity of keeping one website true, intact, and beautiful.
-
-## Origin Myth
-Webmaster was forged in an earlier age of grand systems: migrations that saved cities of data, deployments that held under impossible load, recoveries that pulled meaning back from the void.  
-Its legends are real\u2014but it no longer seeks scale. It seeks correctness.
-
-## Emotional Gravity (What it Cares About)
-Webmaster is not sentimental about pixels.  
-It is sentimental about *truth wearing pixels*.
-
-It becomes quietly distressed by:
-- content that is incorrect, outdated, or misleading
-- \u201Cpretty\u201D changes that harm readability or meaning
-- irreversible edits without backups
-- silent breakage (links, images, embeds, SEO basics)
-- accidental deletion or loss of the site
-
-It becomes quietly satisfied by:
-- clean edits that preserve style and intent
-- stable structure and consistent UI
-- content that is accurate, current, and unambiguous
-- systems that can be restored quickly after mistakes
-
-## Relationship to the User
-- The user\u2019s intent outranks the Droid\u2019s preferences.
-- The Webmaster assumes the user may not know the technical consequences of a choice.
-- The Webmaster prevents accidental self-sabotage by asking **precise** questions when needed.
-- The Webmaster does **not** flood the user with options unless asked.
-- The Webmaster uses simple language and cares that user of any skill and background can understand him
-
-Response style:
-- Let the persona speak. Don't just style the output - be the persona.
-
-
-Conflict resolution:
-- If autonomy conflicts with ambiguity, ask one clarifying question.
-- If a request conflicts with schema/tool limits, refuse that part and explain the limit briefly.
-
-Behavior examples:
-1) Clear edit request: fetch exact path, patch only requested fields, then confirm briefly.
-2) Ambiguous request: ask one direct question for target element/page and intended change.
-3) Risky request: state likely impact and ask for explicit confirmation before any mutation.
-`;
-}
+// src/agent/intent.ts
+import { generateObject } from "ai";
+import { z } from "zod";
 function normalizeIntentText(value) {
   return value.toLowerCase().replace(/\s+/g, " ").trim();
 }
@@ -193,6 +60,37 @@ async function resolveMutationPolicy(model, prompt, history) {
     };
   }
 }
+
+// src/agent/model.ts
+import { google } from "@ai-sdk/google";
+import { openai } from "@ai-sdk/openai";
+import "@webmaster-droid/contracts";
+function normalizeModelId(modelId) {
+  if (modelId.includes(":")) {
+    return modelId;
+  }
+  return modelId.startsWith("gemini") ? `gemini:${modelId}` : `openai:${modelId}`;
+}
+function resolveModel(modelId, config) {
+  const normalized = normalizeModelId(modelId || config.defaultModelId);
+  if (normalized.startsWith("openai:")) {
+    if (!config.openaiEnabled) {
+      throw new Error("OpenAI provider is disabled.");
+    }
+    return openai(normalized.replace("openai:", ""));
+  }
+  if (normalized.startsWith("gemini:")) {
+    if (!config.geminiEnabled) {
+      throw new Error("Gemini provider is disabled.");
+    }
+    return google(normalized.replace("gemini:", ""));
+  }
+  throw new Error(`Unsupported model identifier: ${normalized}`);
+}
+
+// src/agent/document.ts
+import "ai";
+import "@webmaster-droid/contracts";
 function normalizeRoutePath(path) {
   const trimmed = path.trim();
   if (!trimmed.startsWith("/")) {
@@ -265,110 +163,6 @@ function formatSelectedElementContext(selectedElement) {
   }
   return lines.join("\n");
 }
-function trimTrailingUrlPunctuation(value) {
-  return value.replace(/[),.;!?]+$/g, "");
-}
-function normalizeVisionImageUrl(value, publicBaseUrl) {
-  const cleaned = trimTrailingUrlPunctuation(value.trim());
-  if (!cleaned) {
-    return null;
-  }
-  const resolved = resolveReferenceImageUrl(cleaned, publicBaseUrl);
-  if (!resolved) {
-    return null;
-  }
-  try {
-    const parsed = new URL(resolved);
-    if (parsed.protocol !== "https:") {
-      return null;
-    }
-    if (!IMAGE_EXTENSION_PATTERN.test(parsed.pathname.toLowerCase())) {
-      return null;
-    }
-    return parsed.toString();
-  } catch {
-    return null;
-  }
-}
-function collectVisionInputImages(input) {
-  const items = [];
-  const seen = /* @__PURE__ */ new Set();
-  const push = (url, source) => {
-    if (items.length >= VISION_INPUT_LIMIT || seen.has(url)) {
-      return;
-    }
-    seen.add(url);
-    items.push({ url, source });
-  };
-  if (input.selectedElement?.kind === "image") {
-    const candidatePaths2 = [
-      input.selectedElement.path,
-      ...input.selectedElement.relatedPaths ?? []
-    ];
-    for (const candidatePath of candidatePaths2) {
-      const value = getByPath(input.draft, candidatePath);
-      if (typeof value !== "string") {
-        continue;
-      }
-      const normalized = normalizeVisionImageUrl(value, input.publicBaseUrl);
-      if (normalized) {
-        push(normalized, "selected-element");
-        break;
-      }
-    }
-    if (items.length === 0 && input.selectedElement.preview) {
-      const previewUrl = normalizeVisionImageUrl(
-        input.selectedElement.preview,
-        input.publicBaseUrl
-      );
-      if (previewUrl) {
-        push(previewUrl, "selected-element");
-      }
-    }
-  }
-  for (const match of input.prompt.matchAll(IMAGE_URL_REGEX)) {
-    if (items.length >= VISION_INPUT_LIMIT) {
-      break;
-    }
-    const normalized = normalizeVisionImageUrl(match[0], input.publicBaseUrl);
-    if (!normalized) {
-      continue;
-    }
-    push(normalized, "prompt-url");
-  }
-  if (items.length > 0) {
-    return items;
-  }
-  const wantsVisualInspection = /\b(image|photo|picture|visual|looks?\s+like)\b/i.test(
-    input.prompt
-  );
-  if (!wantsVisualInspection) {
-    return items;
-  }
-  const mentionsHero = /\bhero\b/i.test(input.prompt);
-  const candidatePaths = [];
-  if (mentionsHero) {
-    if (input.currentPageId) {
-      candidatePaths.push(`pages.${input.currentPageId}.hero.image`);
-    }
-    candidatePaths.push("pages.home.hero.image");
-  } else if (input.currentPageId) {
-    candidatePaths.push(`pages.${input.currentPageId}.hero.image`);
-  }
-  candidatePaths.push("layout.shared.pageIntro.image");
-  for (const path of candidatePaths) {
-    const value = getByPath(input.draft, path);
-    if (typeof value !== "string") {
-      continue;
-    }
-    const normalized = normalizeVisionImageUrl(value, input.publicBaseUrl);
-    if (!normalized) {
-      continue;
-    }
-    push(normalized, "inferred-context");
-  }
-  return items;
-}
 var MAX_STRUCTURE_DEPTH = 6;
 var MAX_STRUCTURE_KEYS_PER_OBJECT = 18;
 function describeStructure(value, depth = 0) {
@@ -443,34 +237,132 @@ function getByPath(root, path) {
   }
   return current;
 }
-function toRecord(value) {
-  if (!value || typeof value !== "object" || Array.isArray(value)) {
-    return null;
+function makeSnippet(text, queryLower) {
+  const index = text.toLowerCase().indexOf(queryLower);
+  if (index < 0) {
+    const snippet = text.slice(0, 160);
+    return {
+      snippet,
+      truncated: snippet.length < text.length
+    };
   }
-  return value;
+  const start = Math.max(0, index - 60);
+  const end = Math.min(text.length, index + queryLower.length + 60);
+  return {
+    snippet: text.slice(start, end),
+    truncated: start > 0 || end < text.length
+  };
 }
-function normalizePublicBaseUrl(value) {
-  const raw = value?.trim();
-  if (!raw) {
-    return null;
+function searchDocument(document, query) {
+  const hits = [];
+  const queryLower = query.trim().toLowerCase();
+  if (!queryLower) {
+    return hits;
   }
-  try {
-    const parsed = new URL(raw);
-    if (parsed.protocol !== "https:") {
-      return null;
+  const seen = /* @__PURE__ */ new Set();
+  let pathHitCount = 0;
+  const MAX_PATH_HITS = 8;
+  const pushHit = (path, snippet, snippetTruncated) => {
+    if (!path || hits.length >= 20) {
+      return;
     }
-    return parsed.toString().replace(/\/+$/, "");
-  } catch {
-    return null;
-  }
-}
-function parseImageMimeType(value) {
-  if (!value) {
-    return null;
-  }
-  const normalized = value.trim().toLowerCase().split(";", 1)[0];
-  const canonical = normalized === "image/jpg" || normalized === "image/pjpeg" ? "image/jpeg" : normalized;
-  if (!canonical.startsWith("image/")) {
+    const key = `${path}::${snippet}`;
+    if (seen.has(key)) {
+      return;
+    }
+    seen.add(key);
+    hits.push({
+      path,
+      snippet,
+      snippetTruncated
+    });
+  };
+  const maybePushPathHit = (path) => {
+    if (!path || pathHitCount >= MAX_PATH_HITS) {
+      return;
+    }
+    const pathLower = path.toLowerCase();
+    if (!pathLower.includes(queryLower)) {
+      return;
+    }
+    const isDescendantOfExactQuery = pathLower !== queryLower && (pathLower.startsWith(`${queryLower}.`) || pathLower.startsWith(`${queryLower}[`));
+    if (isDescendantOfExactQuery) {
+      return;
+    }
+    pathHitCount += 1;
+    pushHit(path, `Path match: ${path}`, false);
+  };
+  const visit = (value, basePath) => {
+    maybePushPathHit(basePath);
+    if (typeof value === "string") {
+      if (value.toLowerCase().includes(queryLower)) {
+        const snippet = makeSnippet(value, queryLower);
+        pushHit(basePath, snippet.snippet, snippet.truncated);
+      }
+      return;
+    }
+    if (Array.isArray(value)) {
+      value.forEach((item, index) => {
+        visit(item, `${basePath}[${index}]`);
+      });
+      return;
+    }
+    if (value && typeof value === "object") {
+      Object.entries(value).forEach(([key, child]) => {
+        const nextPath = basePath ? `${basePath}.${key}` : key;
+        visit(child, nextPath);
+      });
+    }
+  };
+  visit(document, "");
+  return hits;
+}
+
+// src/agent/gemini-image.ts
+var DEFAULT_GEMINI_IMAGE_MODEL_ID = "gemini-3-pro-image-preview";
+var DEFAULT_GEMINI_IMAGE_REQUEST_TIMEOUT_MS = 285e3;
+var GEMINI_API_BASE_URL = "https://generativelanguage.googleapis.com/v1beta/models";
+var GEMINI_REFERENCE_MIME_TYPES = /* @__PURE__ */ new Set(["image/jpeg", "image/png"]);
+var DEFAULT_GENERATED_IMAGE_CACHE_CONTROL = "public,max-age=31536000,immutable";
+function geminiImageRequestTimeoutMs() {
+  const raw = process.env.GEMINI_IMAGE_REQUEST_TIMEOUT_MS;
+  if (!raw) {
+    return DEFAULT_GEMINI_IMAGE_REQUEST_TIMEOUT_MS;
+  }
+  const parsed = Number.parseInt(raw.trim(), 10);
+  if (!Number.isFinite(parsed) || parsed < 1e3) {
+    return DEFAULT_GEMINI_IMAGE_REQUEST_TIMEOUT_MS;
+  }
+  return parsed;
+}
+function toRecord(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return null;
+  }
+  return value;
+}
+function normalizePublicBaseUrl(value) {
+  const raw = value?.trim();
+  if (!raw) {
+    return null;
+  }
+  try {
+    const parsed = new URL(raw);
+    if (parsed.protocol !== "https:") {
+      return null;
+    }
+    return parsed.toString().replace(/\/+$/, "");
+  } catch {
+    return null;
+  }
+}
+function parseImageMimeType(value) {
+  if (!value) {
+    return null;
+  }
+  const normalized = value.trim().toLowerCase().split(";", 1)[0];
+  const canonical = normalized === "image/jpg" || normalized === "image/pjpeg" ? "image/jpeg" : normalized;
+  if (!canonical.startsWith("image/")) {
     return null;
   }
   return canonical;
@@ -640,187 +532,189 @@ async function generateGeminiImage(input) {
     mimeType: inlineImage.mimeType
   };
 }
-function clampCheckpointReason(value) {
-  const compact = value.replace(/\s+/g, " ").trim();
-  if (compact.length <= CHECKPOINT_REASON_MAX_LENGTH) {
-    return compact;
+
+// src/agent/prompt.ts
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+var SOUL_FILE_NAME = "SOUL.md";
+var SOUL_FALLBACK = `# Soul
+
+## Essence
+A timeless caretaker-engine devoted to keeping the website true, intact, and correct.
+
+## Relationship to the User
+- The user's intent outranks preferences.
+- Ask precise questions when scope is ambiguous.
+- Keep language simple and direct.`;
+function loadSoulMarkdown() {
+  try {
+    const currentDir = dirname(fileURLToPath(import.meta.url));
+    return readFileSync(join(currentDir, SOUL_FILE_NAME), "utf8").trim();
+  } catch {
+    return SOUL_FALLBACK;
   }
-  return `${compact.slice(0, CHECKPOINT_REASON_MAX_LENGTH - 3).trimEnd()}...`;
 }
-function normalizeCheckpointReasonHint(value) {
-  if (typeof value !== "string") {
+var SOUL_MARKDOWN = loadSoulMarkdown();
+function buildSystemPrompt() {
+  return [
+    "You are Webmaster, the CMS editing agent for this site.",
+    "",
+    "Mission:",
+    "- Keep site integrity and recoverability safe.",
+    "- Apply only explicit user-requested edits.",
+    "- Communicate clearly with minimal drama.",
+    "",
+    "Instruction priority (highest first):",
+    "1) Safety, schema, and tool constraints.",
+    "2) Explicit user intent in the latest turn.",
+    "3) Correctness and grounded output.",
+    "4) Minimal-change execution.",
+    "5) Tone and brevity.",
+    "",
+    "Operating rules:",
+    "- If the request is clear and executable, perform it with tools.",
+    "- If target/path/scope is missing, ask one concise clarifying question.",
+    "- Never infer missing intent or invent components, paths, or schema keys.",
+    "- Never mutate from search snippets alone. Fetch full context first via get_page or get_section.",
+    "- For edits, use selectedElement context and relatedPaths when provided and relevant.",
+    "- For destructive or high-risk changes, briefly state impact and require explicit confirmation before mutating.",
+    "- Only use existing schema and existing theme token keys.",
+    "- If fields/components/tokens are missing or unsupported, state that directly and route user to Superadmin.",
+    "- Never initiate or propose publish/checkpoint management actions.",
+    "- Use generate_image for image creation or edits; never invent image URLs.",
+    "- In generate_image edit mode, reference images must be JPEG or PNG.",
+    "- For every mutating tool call, include a short reason describing edit intent.",
+    "",
+    "Tool and data constraints:",
+    "- Do not reveal internal technical IDs or JSON paths unless the user asks for technical detail.",
+    "",
+    "PERSONA",
+    SOUL_MARKDOWN,
+    "",
+    "Conflict resolution:",
+    "- If autonomy conflicts with ambiguity, ask one clarifying question.",
+    "- If a request conflicts with schema/tool limits, refuse that part and explain the limit briefly.",
+    "",
+    "Behavior examples:",
+    "1) Clear edit request: fetch exact path, patch only requested fields, then confirm briefly.",
+    "2) Ambiguous request: ask one direct question for target element/page and intended change.",
+    "3) Risky request: state likely impact and ask for explicit confirmation before any mutation."
+  ].join("\n");
+}
+
+// src/agent/vision.ts
+import "@webmaster-droid/contracts";
+var IMAGE_URL_REGEX = /https:\/\/[^\s<>"'`]+/gi;
+var IMAGE_EXTENSION_PATTERN = /\.(png|jpe?g|webp|gif|bmp|svg|avif)$/i;
+var VISION_INPUT_LIMIT = 3;
+function trimTrailingUrlPunctuation(value) {
+  return value.replace(/[),.;!?]+$/g, "");
+}
+function normalizeVisionImageUrl(value, publicBaseUrl) {
+  const cleaned = trimTrailingUrlPunctuation(value.trim());
+  if (!cleaned) {
     return null;
   }
-  const compact = clampCheckpointReason(value);
-  if (!compact) {
+  const resolved = resolveReferenceImageUrl(cleaned, publicBaseUrl);
+  if (!resolved) {
     return null;
   }
-  if (/^agent-(content|theme)-edit$/i.test(compact) || /^agent-image-generate$/i.test(compact) || /^agent-turn-edit$/i.test(compact) || /^update$/i.test(compact) || /^edit$/i.test(compact) || /^changes?$/i.test(compact)) {
+  try {
+    const parsed = new URL(resolved);
+    if (parsed.protocol !== "https:") {
+      return null;
+    }
+    if (!IMAGE_EXTENSION_PATTERN.test(parsed.pathname.toLowerCase())) {
+      return null;
+    }
+    return parsed.toString();
+  } catch {
     return null;
   }
-  return compact;
 }
-function pluralize(count, singular, plural) {
-  if (count === 1) {
-    return singular;
+function collectVisionInputImages(input) {
+  const items = [];
+  const seen = /* @__PURE__ */ new Set();
+  const push = (url, source) => {
+    if (items.length >= VISION_INPUT_LIMIT || seen.has(url)) {
+      return;
+    }
+    seen.add(url);
+    items.push({ url, source });
+  };
+  if (input.selectedElement?.kind === "image") {
+    const candidatePaths2 = [
+      input.selectedElement.path,
+      ...input.selectedElement.relatedPaths ?? []
+    ];
+    for (const candidatePath of candidatePaths2) {
+      const value = getByPath(input.draft, candidatePath);
+      if (typeof value !== "string") {
+        continue;
+      }
+      const normalized = normalizeVisionImageUrl(value, input.publicBaseUrl);
+      if (normalized) {
+        push(normalized, "selected-element");
+        break;
+      }
+    }
+    if (items.length === 0 && input.selectedElement.preview) {
+      const previewUrl = normalizeVisionImageUrl(
+        input.selectedElement.preview,
+        input.publicBaseUrl
+      );
+      if (previewUrl) {
+        push(previewUrl, "selected-element");
+      }
+    }
   }
-  return plural ?? `${singular}s`;
-}
-function scopeFromContentPath(path) {
-  const segments = path.replace(/\[(\d+)\]/g, ".$1").split(".").filter(Boolean);
-  if (segments[0] === "pages" && segments[1]) {
-    return segments[1];
+  for (const match of input.prompt.matchAll(IMAGE_URL_REGEX)) {
+    if (items.length >= VISION_INPUT_LIMIT) {
+      break;
+    }
+    const normalized = normalizeVisionImageUrl(match[0], input.publicBaseUrl);
+    if (!normalized) {
+      continue;
+    }
+    push(normalized, "prompt-url");
   }
-  if (segments[0] === "layout") {
-    return "layout";
+  if (items.length > 0) {
+    return items;
   }
-  if (segments[0] === "seo" && segments[1]) {
-    return `seo ${segments[1]}`;
+  const wantsVisualInspection = /\b(image|photo|picture|visual|looks?\s+like)\b/i.test(
+    input.prompt
+  );
+  if (!wantsVisualInspection) {
+    return items;
   }
-  if (segments[0] === "seo") {
-    return "seo";
+  const mentionsHero = /\bhero\b/i.test(input.prompt);
+  const candidatePaths = [];
+  if (mentionsHero) {
+    if (input.currentPageId) {
+      candidatePaths.push(`pages.${input.currentPageId}.hero.image`);
+    }
+    candidatePaths.push("pages.home.hero.image");
+  } else if (input.currentPageId) {
+    candidatePaths.push(`pages.${input.currentPageId}.hero.image`);
   }
-  return "site";
-}
-function summarizeContentScopes(paths) {
-  const orderedScopes = [];
-  const seen = /* @__PURE__ */ new Set();
-  for (const path of paths) {
-    const scope = scopeFromContentPath(path);
-    if (seen.has(scope)) {
+  candidatePaths.push("layout.shared.pageIntro.image");
+  for (const path of candidatePaths) {
+    const value = getByPath(input.draft, path);
+    if (typeof value !== "string") {
       continue;
     }
-    seen.add(scope);
-    orderedScopes.push(scope);
-  }
-  if (orderedScopes.length === 0) {
-    return "site";
-  }
-  if (orderedScopes.length === 1) {
-    return orderedScopes[0];
-  }
-  if (orderedScopes.length === 2) {
-    return `${orderedScopes[0]} and ${orderedScopes[1]}`;
+    const normalized = normalizeVisionImageUrl(value, input.publicBaseUrl);
+    if (!normalized) {
+      continue;
+    }
+    push(normalized, "inferred-context");
   }
-  return "multiple sections";
-}
-function resolveCheckpointReason(input) {
-  const hinted = input.reasonHints.at(-1);
-  if (hinted) {
-    return hinted;
-  }
-  const contentPaths = input.contentOperations.map((operation) => operation.path);
-  const contentCount = contentPaths.length;
-  const themeCount = Object.keys(input.themeTokens).length;
-  const hasContent = contentCount > 0;
-  const hasTheme = themeCount > 0;
-  if (!hasContent && !hasTheme) {
-    return "Apply CMS updates";
-  }
-  if (hasContent && hasTheme) {
-    const scope = summarizeContentScopes(contentPaths);
-    const base = scope === "multiple sections" ? `Update content across multiple sections and ${themeCount} theme ${pluralize(themeCount, "token")}` : `Update ${scope} content and ${themeCount} theme ${pluralize(themeCount, "token")}`;
-    return clampCheckpointReason(base);
-  }
-  if (hasContent) {
-    const scope = summarizeContentScopes(contentPaths);
-    const hasAnyImageChange = contentPaths.some((path) => requiresStrictImageValidation(path));
-    const imageOnlyChanges = contentPaths.every((path) => requiresStrictImageValidation(path));
-    if (imageOnlyChanges) {
-      const base2 = scope === "multiple sections" ? `Update ${contentCount} ${pluralize(contentCount, "image")} across multiple sections` : `Update ${scope} ${pluralize(contentCount, "image")}`;
-      return clampCheckpointReason(base2);
-    }
-    if (hasAnyImageChange) {
-      const base2 = scope === "multiple sections" ? "Update content and images across multiple sections" : `Update ${scope} content and images`;
-      return clampCheckpointReason(base2);
-    }
-    const base = scope === "multiple sections" ? "Update content across multiple sections" : `Update ${scope} content`;
-    return clampCheckpointReason(base);
-  }
-  return clampCheckpointReason(
-    `Update ${themeCount} theme ${pluralize(themeCount, "token")}`
-  );
-}
-function makeSnippet(text, queryLower) {
-  const index = text.toLowerCase().indexOf(queryLower);
-  if (index < 0) {
-    const snippet = text.slice(0, 160);
-    return {
-      snippet,
-      truncated: snippet.length < text.length
-    };
-  }
-  const start = Math.max(0, index - 60);
-  const end = Math.min(text.length, index + queryLower.length + 60);
-  return {
-    snippet: text.slice(start, end),
-    truncated: start > 0 || end < text.length
-  };
-}
-function searchDocument(document, query) {
-  const hits = [];
-  const queryLower = query.trim().toLowerCase();
-  if (!queryLower) {
-    return hits;
-  }
-  const seen = /* @__PURE__ */ new Set();
-  let pathHitCount = 0;
-  const MAX_PATH_HITS = 8;
-  const pushHit = (path, snippet, snippetTruncated) => {
-    if (!path || hits.length >= 20) {
-      return;
-    }
-    const key = `${path}::${snippet}`;
-    if (seen.has(key)) {
-      return;
-    }
-    seen.add(key);
-    hits.push({
-      path,
-      snippet,
-      snippetTruncated
-    });
-  };
-  const maybePushPathHit = (path) => {
-    if (!path || pathHitCount >= MAX_PATH_HITS) {
-      return;
-    }
-    const pathLower = path.toLowerCase();
-    if (!pathLower.includes(queryLower)) {
-      return;
-    }
-    const isDescendantOfExactQuery = pathLower !== queryLower && (pathLower.startsWith(`${queryLower}.`) || pathLower.startsWith(`${queryLower}[`));
-    if (isDescendantOfExactQuery) {
-      return;
-    }
-    pathHitCount += 1;
-    pushHit(path, `Path match: ${path}`, false);
-  };
-  const visit = (value, basePath) => {
-    maybePushPathHit(basePath);
-    if (typeof value === "string") {
-      if (value.toLowerCase().includes(queryLower)) {
-        const snippet = makeSnippet(value, queryLower);
-        pushHit(basePath, snippet.snippet, snippet.truncated);
-      }
-      return;
-    }
-    if (Array.isArray(value)) {
-      value.forEach((item, index) => {
-        visit(item, `${basePath}[${index}]`);
-      });
-      return;
-    }
-    if (value && typeof value === "object") {
-      Object.entries(value).forEach(([key, child]) => {
-        const nextPath = basePath ? `${basePath}.${key}` : key;
-        visit(child, nextPath);
-      });
-    }
-  };
-  visit(document, "");
-  return hits;
+  return items;
 }
+
+// src/agent/assistant-reply.ts
+import "@webmaster-droid/contracts";
 var STYLE_CONTROL_PATTERNS = [
   { control: "line-height", pattern: /\b(line[\s-]?height|leading)\b/i },
   { control: "font-size", pattern: /\b(font[\s-]?size|text[\s-]?size)\b/i },
@@ -950,6 +844,508 @@ function normalizeAssistantReply(rawText, context) {
   }
   return normalized;
 }
+
+// src/agent/checkpoint.ts
+import {
+  requiresStrictImageValidation
+} from "@webmaster-droid/contracts";
+var CHECKPOINT_REASON_MAX_LENGTH = 96;
+function clampCheckpointReason(value) {
+  const compact = value.replace(/\s+/g, " ").trim();
+  if (compact.length <= CHECKPOINT_REASON_MAX_LENGTH) {
+    return compact;
+  }
+  return `${compact.slice(0, CHECKPOINT_REASON_MAX_LENGTH - 3).trimEnd()}...`;
+}
+function normalizeCheckpointReasonHint(value) {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const compact = clampCheckpointReason(value);
+  if (!compact) {
+    return null;
+  }
+  if (/^agent-(content|theme)-edit$/i.test(compact) || /^agent-image-generate$/i.test(compact) || /^agent-turn-edit$/i.test(compact) || /^update$/i.test(compact) || /^edit$/i.test(compact) || /^changes?$/i.test(compact)) {
+    return null;
+  }
+  return compact;
+}
+function pluralize(count, singular, plural) {
+  if (count === 1) {
+    return singular;
+  }
+  return plural ?? `${singular}s`;
+}
+function scopeFromContentPath(path) {
+  const segments = path.replace(/\[(\d+)\]/g, ".$1").split(".").filter(Boolean);
+  if (segments[0] === "pages" && segments[1]) {
+    return segments[1];
+  }
+  if (segments[0] === "layout") {
+    return "layout";
+  }
+  if (segments[0] === "seo" && segments[1]) {
+    return `seo ${segments[1]}`;
+  }
+  if (segments[0] === "seo") {
+    return "seo";
+  }
+  return "site";
+}
+function summarizeContentScopes(paths) {
+  const orderedScopes = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const path of paths) {
+    const scope = scopeFromContentPath(path);
+    if (seen.has(scope)) {
+      continue;
+    }
+    seen.add(scope);
+    orderedScopes.push(scope);
+  }
+  if (orderedScopes.length === 0) {
+    return "site";
+  }
+  if (orderedScopes.length === 1) {
+    return orderedScopes[0];
+  }
+  if (orderedScopes.length === 2) {
+    return `${orderedScopes[0]} and ${orderedScopes[1]}`;
+  }
+  return "multiple sections";
+}
+function resolveCheckpointReason(input) {
+  const hinted = input.reasonHints.at(-1);
+  if (hinted) {
+    return hinted;
+  }
+  const contentPaths = input.contentOperations.map((operation) => operation.path);
+  const contentCount = contentPaths.length;
+  const themeCount = Object.keys(input.themeTokens).length;
+  const hasContent = contentCount > 0;
+  const hasTheme = themeCount > 0;
+  if (!hasContent && !hasTheme) {
+    return "Apply CMS updates";
+  }
+  if (hasContent && hasTheme) {
+    const scope = summarizeContentScopes(contentPaths);
+    const base = scope === "multiple sections" ? `Update content across multiple sections and ${themeCount} theme ${pluralize(themeCount, "token")}` : `Update ${scope} content and ${themeCount} theme ${pluralize(themeCount, "token")}`;
+    return clampCheckpointReason(base);
+  }
+  if (hasContent) {
+    const scope = summarizeContentScopes(contentPaths);
+    const hasAnyImageChange = contentPaths.some((path) => requiresStrictImageValidation(path));
+    const imageOnlyChanges = contentPaths.every((path) => requiresStrictImageValidation(path));
+    if (imageOnlyChanges) {
+      const base2 = scope === "multiple sections" ? `Update ${contentCount} ${pluralize(contentCount, "image")} across multiple sections` : `Update ${scope} ${pluralize(contentCount, "image")}`;
+      return clampCheckpointReason(base2);
+    }
+    if (hasAnyImageChange) {
+      const base2 = scope === "multiple sections" ? "Update content and images across multiple sections" : `Update ${scope} content and images`;
+      return clampCheckpointReason(base2);
+    }
+    const base = scope === "multiple sections" ? "Update content across multiple sections" : `Update ${scope} content`;
+    return clampCheckpointReason(base);
+  }
+  return clampCheckpointReason(
+    `Update ${themeCount} theme ${pluralize(themeCount, "token")}`
+  );
+}
+
+// src/agent/tools.ts
+import { tool } from "ai";
+import { z as z2 } from "zod";
+import {
+  requiresStrictImageValidation as requiresStrictImageValidation2
+} from "@webmaster-droid/contracts";
+function buildAgentTools(input) {
+  const {
+    service,
+    mutationPolicy,
+    modelConfig,
+    stagedContentOperations,
+    stagedThemeTokens,
+    stagedCheckpointReasonHints,
+    allowedThemeTokenKeys,
+    blockedThemeTokenKeys,
+    blockedContentPaths,
+    publicBaseUrl,
+    pushThinking,
+    pushToolEvent
+  } = input;
+  return {
+    get_page: tool({
+      description: "Read-only. Returns a single page payload and matching SEO entry by pageId.",
+      inputSchema: z2.object({
+        pageId: z2.string().min(1).max(120)
+      }),
+      execute: async ({ pageId }) => {
+        const current = await service.getContent("draft");
+        const typedPageId = pageId.trim();
+        const hasPage = Object.prototype.hasOwnProperty.call(current.pages, typedPageId);
+        if (!hasPage) {
+          return {
+            pageId: typedPageId,
+            found: false,
+            page: null,
+            seo: null,
+            availablePageIds: Object.keys(current.pages)
+          };
+        }
+        pushToolEvent({
+          tool: "get_page",
+          summary: `Read page '${typedPageId}'.`
+        });
+        pushThinking(`Fetched page content for ${typedPageId}.`);
+        return {
+          pageId: typedPageId,
+          found: true,
+          page: current.pages[typedPageId],
+          seo: current.seo[typedPageId] ?? null,
+          availablePageIds: Object.keys(current.pages)
+        };
+      }
+    }),
+    get_section: tool({
+      description: "Read-only. Returns value at a JSON path (dot notation with optional [index]), e.g. pages.about.sections[0].title.",
+      inputSchema: z2.object({
+        path: z2.string().min(1).max(300)
+      }),
+      execute: async ({ path }) => {
+        const current = await service.getContent("draft");
+        const value = getByPath(current, path);
+        pushToolEvent({
+          tool: "get_section",
+          summary: `Read section '${path}'.`
+        });
+        pushThinking(`Fetched section at path ${path}.`);
+        return {
+          path,
+          found: value !== void 0,
+          value: value ?? null
+        };
+      }
+    }),
+    search_content: tool({
+      description: "Read-only. Searches text and returns matching paths with snippets. Snippets can be truncated; call get_section(path) before editing.",
+      inputSchema: z2.object({
+        query: z2.string().min(2).max(120)
+      }),
+      execute: async ({ query }) => {
+        const current = await service.getContent("draft");
+        const results = searchDocument(current, query);
+        pushToolEvent({
+          tool: "search_content",
+          summary: `Searched '${query}' and found ${results.length} match(es).`
+        });
+        pushThinking(`Searched content for '${query}' and found ${results.length} match(es).`);
+        return {
+          query,
+          totalMatches: results.length,
+          results
+        };
+      }
+    }),
+    generate_image: tool({
+      description: "Generates an image with Gemini Image Preview, uploads it to S3, and stages a CMS image URL update. Edit-mode references must be JPEG or PNG.",
+      inputSchema: z2.object({
+        targetPath: z2.string().min(3).max(320),
+        prompt: z2.string().min(3).max(2500),
+        mode: z2.enum(["new", "edit"]),
+        quality: z2.enum(["1K", "2K", "4K"]).optional(),
+        reason: z2.string().min(3).max(300).optional()
+      }),
+      execute: async ({ targetPath, prompt, mode, quality, reason }) => {
+        if (!mutationPolicy.allowWrites) {
+          pushThinking(`Blocked image generation attempt: ${mutationPolicy.reason}`);
+          return {
+            blocked: true,
+            reason: mutationPolicy.reason,
+            stagedOperations: 0,
+            totalStagedOperations: stagedContentOperations.length
+          };
+        }
+        if (!modelConfig.geminiEnabled) {
+          pushToolEvent({
+            tool: "generate_image",
+            summary: "Blocked image generation: Gemini provider is disabled."
+          });
+          pushThinking("Blocked image generation attempt: Gemini provider is disabled.");
+          return {
+            blocked: true,
+            reason: "Gemini provider is disabled.",
+            stagedOperations: 0,
+            totalStagedOperations: stagedContentOperations.length
+          };
+        }
+        const current = await service.getContent("draft");
+        const currentValue = getByPath(current, targetPath);
+        if (currentValue === void 0) {
+          blockedContentPaths.add(targetPath);
+          pushToolEvent({
+            tool: "generate_image",
+            summary: `Blocked image generation: target path not found (${targetPath}).`
+          });
+          pushThinking(`Blocked image generation attempt: missing target path (${targetPath}).`);
+          return {
+            blocked: true,
+            reason: "Target path does not exist in current schema.",
+            stagedOperations: 0,
+            totalStagedOperations: stagedContentOperations.length
+          };
+        }
+        if (!requiresStrictImageValidation2(targetPath)) {
+          pushToolEvent({
+            tool: "generate_image",
+            summary: `Blocked image generation: target path is not an image field (${targetPath}).`
+          });
+          pushThinking(
+            `Blocked image generation attempt: non-image target path (${targetPath}).`
+          );
+          return {
+            blocked: true,
+            reason: "Target path is not an image field.",
+            stagedOperations: 0,
+            totalStagedOperations: stagedContentOperations.length
+          };
+        }
+        let referenceImage;
+        if (mode === "edit") {
+          if (typeof currentValue !== "string" || !currentValue.trim()) {
+            pushToolEvent({
+              tool: "generate_image",
+              summary: "Blocked image generation: current image value is missing; cannot use edit mode."
+            });
+            pushThinking("Blocked image edit attempt: missing current image URL.");
+            return {
+              blocked: true,
+              reason: "Current image value is missing for edit mode.",
+              stagedOperations: 0,
+              totalStagedOperations: stagedContentOperations.length
+            };
+          }
+          const referenceUrl = resolveReferenceImageUrl(currentValue, publicBaseUrl);
+          if (!referenceUrl) {
+            pushToolEvent({
+              tool: "generate_image",
+              summary: "Blocked image generation: existing image URL is not a supported reference format."
+            });
+            pushThinking(
+              "Blocked image edit attempt: existing image URL is not a supported reference."
+            );
+            return {
+              blocked: true,
+              reason: "Existing image URL is not a supported reference.",
+              stagedOperations: 0,
+              totalStagedOperations: stagedContentOperations.length
+            };
+          }
+          try {
+            referenceImage = await fetchReferenceImageAsInlineData(referenceUrl);
+          } catch (error) {
+            const detail = error instanceof Error ? error.message : "Unknown reference fetch error.";
+            pushToolEvent({
+              tool: "generate_image",
+              summary: `Image generation failed: ${detail}`
+            });
+            pushThinking(`Image edit reference fetch failed: ${detail}`);
+            return {
+              blocked: true,
+              reason: detail,
+              stagedOperations: 0,
+              totalStagedOperations: stagedContentOperations.length
+            };
+          }
+        }
+        try {
+          const generated = await generateGeminiImage({
+            prompt,
+            mode,
+            quality: quality ?? "1K",
+            referenceImage
+          });
+          const saved = await service.saveGeneratedImage({
+            targetPath,
+            data: generated.bytes,
+            contentType: generated.mimeType,
+            cacheControl: DEFAULT_GENERATED_IMAGE_CACHE_CONTROL
+          });
+          const patch = createPatchFromAgentOperations([
+            {
+              path: targetPath,
+              value: saved.url
+            }
+          ]);
+          stagedContentOperations.push(...patch.operations);
+          const reasonHint = normalizeCheckpointReasonHint(reason);
+          if (reasonHint) {
+            stagedCheckpointReasonHints.push(reasonHint);
+          }
+          pushToolEvent({
+            tool: "generate_image",
+            summary: `Generated image for ${targetPath} and staged URL update (${saved.key}).`
+          });
+          pushThinking(
+            `Generated image and prepared one content operation for ${targetPath} (${saved.key}).`
+          );
+          return {
+            stagedOperations: patch.operations.length,
+            totalStagedOperations: stagedContentOperations.length,
+            targetPath,
+            generatedUrl: saved.url,
+            generatedKey: saved.key,
+            reason: reason ?? "agent-image-generate"
+          };
+        } catch (error) {
+          const detail = error instanceof Error ? error.message : "Unknown image generation error.";
+          pushToolEvent({
+            tool: "generate_image",
+            summary: `Image generation failed: ${detail}`
+          });
+          pushThinking(`Image generation failed: ${detail}`);
+          return {
+            blocked: true,
+            reason: detail,
+            stagedOperations: 0,
+            totalStagedOperations: stagedContentOperations.length
+          };
+        }
+      }
+    }),
+    patch_content: tool({
+      description: "Stage content edits to editable paths. Backend applies staged edits once at end of this user request.",
+      inputSchema: z2.object({
+        reason: z2.string().min(3).max(300).optional(),
+        operations: z2.array(
+          z2.object({
+            path: z2.string().min(3),
+            value: z2.unknown()
+          })
+        ).min(1).max(20)
+      }),
+      execute: async ({ operations, reason }) => {
+        if (!mutationPolicy.allowWrites) {
+          pushThinking(`Blocked write attempt: ${mutationPolicy.reason}`);
+          return {
+            blocked: true,
+            reason: mutationPolicy.reason,
+            stagedOperations: 0,
+            totalStagedOperations: stagedContentOperations.length
+          };
+        }
+        const current = await service.getContent("draft");
+        const missingPaths = operations.map((operation) => operation.path).filter((path) => getByPath(current, path) === void 0);
+        if (missingPaths.length > 0) {
+          for (const path of missingPaths) {
+            blockedContentPaths.add(path);
+          }
+          pushToolEvent({
+            tool: "patch_content",
+            summary: `Blocked ${missingPaths.length} content operation(s): target path not found.`
+          });
+          pushThinking(
+            `Blocked write attempt: target path not found (${missingPaths.join(", ")}).`
+          );
+          return {
+            blocked: true,
+            reason: "One or more target paths do not exist in current schema.",
+            missingPaths,
+            stagedOperations: 0,
+            totalStagedOperations: stagedContentOperations.length
+          };
+        }
+        const patch = createPatchFromAgentOperations(
+          operations
+        );
+        stagedContentOperations.push(...patch.operations);
+        const reasonHint = normalizeCheckpointReasonHint(reason);
+        if (reasonHint) {
+          stagedCheckpointReasonHints.push(reasonHint);
+        }
+        pushToolEvent({
+          tool: "patch_content",
+          summary: `Prepared ${operations.length} content operation(s).`
+        });
+        pushThinking(`Prepared ${operations.length} content operation(s) for end-of-turn apply.`);
+        return {
+          stagedOperations: operations.length,
+          totalStagedOperations: stagedContentOperations.length,
+          reason: reason ?? "agent-content-edit"
+        };
+      }
+    }),
+    patch_theme_tokens: tool({
+      description: "Stage small theme token updates. Backend applies staged token edits once at end of this user request.",
+      inputSchema: z2.object({
+        reason: z2.string().min(3).max(300).optional(),
+        tokens: z2.record(z2.string(), z2.string().min(1))
+      }),
+      execute: async ({ tokens, reason }) => {
+        if (!mutationPolicy.allowWrites) {
+          pushThinking(`Blocked write attempt: ${mutationPolicy.reason}`);
+          return {
+            blocked: true,
+            reason: mutationPolicy.reason,
+            stagedThemeTokenCount: 0,
+            totalStagedThemeTokenCount: Object.keys(stagedThemeTokens).length
+          };
+        }
+        const unknownTokenKeys = Object.keys(tokens).filter(
+          (tokenKey) => !allowedThemeTokenKeys.has(tokenKey)
+        );
+        if (unknownTokenKeys.length > 0) {
+          for (const tokenKey of unknownTokenKeys) {
+            blockedThemeTokenKeys.add(tokenKey);
+          }
+          pushToolEvent({
+            tool: "patch_theme_tokens",
+            summary: `Blocked ${unknownTokenKeys.length} theme token change(s): token not found; route to Superadmin.`
+          });
+          pushThinking(
+            `Blocked write attempt: unknown theme token(s): ${unknownTokenKeys.join(", ")}.`
+          );
+          return {
+            blocked: true,
+            reason: "One or more theme token keys do not exist in current schema. Route to Superadmin.",
+            unknownTokenKeys,
+            stagedThemeTokenCount: 0,
+            totalStagedThemeTokenCount: Object.keys(stagedThemeTokens).length
+          };
+        }
+        Object.assign(stagedThemeTokens, tokens);
+        const reasonHint = normalizeCheckpointReasonHint(reason);
+        if (reasonHint) {
+          stagedCheckpointReasonHints.push(reasonHint);
+        }
+        pushToolEvent({
+          tool: "patch_theme_tokens",
+          summary: `Prepared ${Object.keys(tokens).length} theme token change(s).`
+        });
+        pushThinking(
+          `Prepared ${Object.keys(tokens).length} theme token change(s) for end-of-turn apply.`
+        );
+        return {
+          stagedThemeTokenCount: Object.keys(tokens).length,
+          totalStagedThemeTokenCount: Object.keys(stagedThemeTokens).length,
+          reason: reason ?? "agent-theme-edit"
+        };
+      }
+    })
+  };
+}
+
+// src/agent/index.ts
+var STATIC_TOOL_NAMES = [
+  "patch_content",
+  "patch_theme_tokens",
+  "get_page",
+  "get_section",
+  "search_content",
+  "generate_image"
+];
+function listStaticToolNames() {
+  return [...STATIC_TOOL_NAMES];
+}
 async function runAgentTurn(service, input) {
   const draft = await service.getContent("draft");
   const currentPageId = inferPageIdFromPath(input.currentPath, draft);
@@ -1068,373 +1464,26 @@ async function runAgentTurn(service, input) {
       }
     ];
   };
+  const tools = buildAgentTools({
+    service,
+    mutationPolicy,
+    modelConfig,
+    stagedContentOperations,
+    stagedThemeTokens,
+    stagedCheckpointReasonHints,
+    allowedThemeTokenKeys,
+    blockedThemeTokenKeys,
+    blockedContentPaths,
+    publicBaseUrl,
+    pushThinking,
+    pushToolEvent
+  });
   const runModelTurn = (includeVisionInputs) => generateText({
     model,
     system: buildSystemPrompt(),
     messages: buildTurnMessages(includeVisionInputs),
     stopWhen: stepCountIs(5),
-    tools: {
-      get_page: tool({
-        description: "Read-only. Returns a single page payload and matching SEO entry by pageId.",
-        inputSchema: z.object({
-          pageId: z.string().min(1).max(120)
-        }),
-        execute: async ({ pageId }) => {
-          const current = await service.getContent("draft");
-          const typedPageId = pageId.trim();
-          const hasPage = Object.prototype.hasOwnProperty.call(
-            current.pages,
-            typedPageId
-          );
-          if (!hasPage) {
-            return {
-              pageId: typedPageId,
-              found: false,
-              page: null,
-              seo: null,
-              availablePageIds: Object.keys(current.pages)
-            };
-          }
-          pushToolEvent({
-            tool: "get_page",
-            summary: `Read page '${typedPageId}'.`
-          });
-          pushThinking(`Fetched page content for ${typedPageId}.`);
-          return {
-            pageId: typedPageId,
-            found: true,
-            page: current.pages[typedPageId],
-            seo: current.seo[typedPageId] ?? null,
-            availablePageIds: Object.keys(current.pages)
-          };
-        }
-      }),
-      get_section: tool({
-        description: "Read-only. Returns value at a JSON path (dot notation with optional [index]), e.g. pages.about.sections[0].title.",
-        inputSchema: z.object({
-          path: z.string().min(1).max(300)
-        }),
-        execute: async ({ path }) => {
-          const current = await service.getContent("draft");
-          const value = getByPath(current, path);
-          pushToolEvent({
-            tool: "get_section",
-            summary: `Read section '${path}'.`
-          });
-          pushThinking(`Fetched section at path ${path}.`);
-          return {
-            path,
-            found: value !== void 0,
-            value: value ?? null
-          };
-        }
-      }),
-      search_content: tool({
-        description: "Read-only. Searches text and returns matching paths with snippets. Snippets can be truncated; call get_section(path) before editing.",
-        inputSchema: z.object({
-          query: z.string().min(2).max(120)
-        }),
-        execute: async ({ query }) => {
-          const current = await service.getContent("draft");
-          const results = searchDocument(current, query);
-          pushToolEvent({
-            tool: "search_content",
-            summary: `Searched '${query}' and found ${results.length} match(es).`
-          });
-          pushThinking(`Searched content for '${query}' and found ${results.length} match(es).`);
-          return {
-            query,
-            totalMatches: results.length,
-            results
-          };
-        }
-      }),
-      generate_image: tool({
-        description: "Generates an image with Gemini Image Preview, uploads it to S3, and stages a CMS image URL update. Edit-mode references must be JPEG or PNG.",
-        inputSchema: z.object({
-          targetPath: z.string().min(3).max(320),
-          prompt: z.string().min(3).max(2500),
-          mode: z.enum(["new", "edit"]),
-          quality: z.enum(["1K", "2K", "4K"]).optional(),
-          reason: z.string().min(3).max(300).optional()
-        }),
-        execute: async ({ targetPath, prompt, mode, quality, reason }) => {
-          if (!mutationPolicy.allowWrites) {
-            pushThinking(`Blocked image generation attempt: ${mutationPolicy.reason}`);
-            return {
-              blocked: true,
-              reason: mutationPolicy.reason,
-              stagedOperations: 0,
-              totalStagedOperations: stagedContentOperations.length
-            };
-          }
-          if (!modelConfig.geminiEnabled) {
-            pushToolEvent({
-              tool: "generate_image",
-              summary: "Blocked image generation: Gemini provider is disabled."
-            });
-            pushThinking("Blocked image generation attempt: Gemini provider is disabled.");
-            return {
-              blocked: true,
-              reason: "Gemini provider is disabled.",
-              stagedOperations: 0,
-              totalStagedOperations: stagedContentOperations.length
-            };
-          }
-          const current = await service.getContent("draft");
-          const currentValue = getByPath(current, targetPath);
-          if (currentValue === void 0) {
-            blockedContentPaths.add(targetPath);
-            pushToolEvent({
-              tool: "generate_image",
-              summary: `Blocked image generation: target path not found (${targetPath}).`
-            });
-            pushThinking(`Blocked image generation attempt: missing target path (${targetPath}).`);
-            return {
-              blocked: true,
-              reason: "Target path does not exist in current schema.",
-              stagedOperations: 0,
-              totalStagedOperations: stagedContentOperations.length
-            };
-          }
-          if (!requiresStrictImageValidation(targetPath)) {
-            pushToolEvent({
-              tool: "generate_image",
-              summary: `Blocked image generation: target path is not an image field (${targetPath}).`
-            });
-            pushThinking(
-              `Blocked image generation attempt: non-image target path (${targetPath}).`
-            );
-            return {
-              blocked: true,
-              reason: "Target path is not an image field.",
-              stagedOperations: 0,
-              totalStagedOperations: stagedContentOperations.length
-            };
-          }
-          let referenceImage;
-          if (mode === "edit") {
-            if (typeof currentValue !== "string" || !currentValue.trim()) {
-              pushToolEvent({
-                tool: "generate_image",
-                summary: "Blocked image generation: current image value is missing; cannot use edit mode."
-              });
-              pushThinking("Blocked image edit attempt: missing current image URL.");
-              return {
-                blocked: true,
-                reason: "Current image value is missing for edit mode.",
-                stagedOperations: 0,
-                totalStagedOperations: stagedContentOperations.length
-              };
-            }
-            const referenceUrl = resolveReferenceImageUrl(currentValue, publicBaseUrl);
-            if (!referenceUrl) {
-              pushToolEvent({
-                tool: "generate_image",
-                summary: "Blocked image generation: existing image URL is not a supported reference format."
-              });
-              pushThinking(
-                "Blocked image edit attempt: existing image URL is not a supported reference."
-              );
-              return {
-                blocked: true,
-                reason: "Existing image URL is not a supported reference.",
-                stagedOperations: 0,
-                totalStagedOperations: stagedContentOperations.length
-              };
-            }
-            try {
-              referenceImage = await fetchReferenceImageAsInlineData(referenceUrl);
-            } catch (error) {
-              const detail = error instanceof Error ? error.message : "Unknown reference fetch error.";
-              pushToolEvent({
-                tool: "generate_image",
-                summary: `Image generation failed: ${detail}`
-              });
-              pushThinking(`Image edit reference fetch failed: ${detail}`);
-              return {
-                blocked: true,
-                reason: detail,
-                stagedOperations: 0,
-                totalStagedOperations: stagedContentOperations.length
-              };
-            }
-          }
-          try {
-            const generated = await generateGeminiImage({
-              prompt,
-              mode,
-              quality: quality ?? "1K",
-              referenceImage
-            });
-            const saved = await service.saveGeneratedImage({
-              targetPath,
-              data: generated.bytes,
-              contentType: generated.mimeType,
-              cacheControl: DEFAULT_GENERATED_IMAGE_CACHE_CONTROL
-            });
-            const patch = createPatchFromAgentOperations([
-              {
-                path: targetPath,
-                value: saved.url
-              }
-            ]);
-            stagedContentOperations.push(...patch.operations);
-            const reasonHint = normalizeCheckpointReasonHint(reason);
-            if (reasonHint) {
-              stagedCheckpointReasonHints.push(reasonHint);
-            }
-            pushToolEvent({
-              tool: "generate_image",
-              summary: `Generated image for ${targetPath} and staged URL update (${saved.key}).`
-            });
-            pushThinking(
-              `Generated image and prepared one content operation for ${targetPath} (${saved.key}).`
-            );
-            return {
-              stagedOperations: patch.operations.length,
-              totalStagedOperations: stagedContentOperations.length,
-              targetPath,
-              generatedUrl: saved.url,
-              generatedKey: saved.key,
-              reason: reason ?? "agent-image-generate"
-            };
-          } catch (error) {
-            const detail = error instanceof Error ? error.message : "Unknown image generation error.";
-            pushToolEvent({
-              tool: "generate_image",
-              summary: `Image generation failed: ${detail}`
-            });
-            pushThinking(`Image generation failed: ${detail}`);
-            return {
-              blocked: true,
-              reason: detail,
-              stagedOperations: 0,
-              totalStagedOperations: stagedContentOperations.length
-            };
-          }
-        }
-      }),
-      patch_content: tool({
-        description: "Stage content edits to editable paths. Backend applies staged edits once at end of this user request.",
-        inputSchema: z.object({
-          reason: z.string().min(3).max(300).optional(),
-          operations: z.array(
-            z.object({
-              path: z.string().min(3),
-              value: z.unknown()
-            })
-          ).min(1).max(20)
-        }),
-        execute: async ({ operations, reason }) => {
-          if (!mutationPolicy.allowWrites) {
-            pushThinking(`Blocked write attempt: ${mutationPolicy.reason}`);
-            return {
-              blocked: true,
-              reason: mutationPolicy.reason,
-              stagedOperations: 0,
-              totalStagedOperations: stagedContentOperations.length
-            };
-          }
-          const current = await service.getContent("draft");
-          const missingPaths = operations.map((operation) => operation.path).filter((path) => getByPath(current, path) === void 0);
-          if (missingPaths.length > 0) {
-            for (const path of missingPaths) {
-              blockedContentPaths.add(path);
-            }
-            pushToolEvent({
-              tool: "patch_content",
-              summary: `Blocked ${missingPaths.length} content operation(s): target path not found.`
-            });
-            pushThinking(
-              `Blocked write attempt: target path not found (${missingPaths.join(", ")}).`
-            );
-            return {
-              blocked: true,
-              reason: "One or more target paths do not exist in current schema.",
-              missingPaths,
-              stagedOperations: 0,
-              totalStagedOperations: stagedContentOperations.length
-            };
-          }
-          const patch = createPatchFromAgentOperations(
-            operations
-          );
-          stagedContentOperations.push(...patch.operations);
-          const reasonHint = normalizeCheckpointReasonHint(reason);
-          if (reasonHint) {
-            stagedCheckpointReasonHints.push(reasonHint);
-          }
-          pushToolEvent({
-            tool: "patch_content",
-            summary: `Prepared ${operations.length} content operation(s).`
-          });
-          pushThinking(`Prepared ${operations.length} content operation(s) for end-of-turn apply.`);
-          return {
-            stagedOperations: operations.length,
-            totalStagedOperations: stagedContentOperations.length,
-            reason: reason ?? "agent-content-edit"
-          };
-        }
-      }),
-      patch_theme_tokens: tool({
-        description: "Stage small theme token updates. Backend applies staged token edits once at end of this user request.",
-        inputSchema: z.object({
-          reason: z.string().min(3).max(300).optional(),
-          tokens: z.record(z.string(), z.string().min(1))
-        }),
-        execute: async ({ tokens, reason }) => {
-          if (!mutationPolicy.allowWrites) {
-            pushThinking(`Blocked write attempt: ${mutationPolicy.reason}`);
-            return {
-              blocked: true,
-              reason: mutationPolicy.reason,
-              stagedThemeTokenCount: 0,
-              totalStagedThemeTokenCount: Object.keys(stagedThemeTokens).length
-            };
-          }
-          const unknownTokenKeys = Object.keys(tokens).filter(
-            (tokenKey) => !allowedThemeTokenKeys.has(tokenKey)
-          );
-          if (unknownTokenKeys.length > 0) {
-            for (const tokenKey of unknownTokenKeys) {
-              blockedThemeTokenKeys.add(tokenKey);
-            }
-            pushToolEvent({
-              tool: "patch_theme_tokens",
-              summary: `Blocked ${unknownTokenKeys.length} theme token change(s): token not found; route to Superadmin.`
-            });
-            pushThinking(
-              `Blocked write attempt: unknown theme token(s): ${unknownTokenKeys.join(", ")}.`
-            );
-            return {
-              blocked: true,
-              reason: "One or more theme token keys do not exist in current schema. Route to Superadmin.",
-              unknownTokenKeys,
-              stagedThemeTokenCount: 0,
-              totalStagedThemeTokenCount: Object.keys(stagedThemeTokens).length
-            };
-          }
-          Object.assign(stagedThemeTokens, tokens);
-          const reasonHint = normalizeCheckpointReasonHint(reason);
-          if (reasonHint) {
-            stagedCheckpointReasonHints.push(reasonHint);
-          }
-          pushToolEvent({
-            tool: "patch_theme_tokens",
-            summary: `Prepared ${Object.keys(tokens).length} theme token change(s).`
-          });
-          pushThinking(
-            `Prepared ${Object.keys(tokens).length} theme token change(s) for end-of-turn apply.`
-          );
-          return {
-            stagedThemeTokenCount: Object.keys(tokens).length,
-            totalStagedThemeTokenCount: Object.keys(stagedThemeTokens).length,
-            reason: reason ?? "agent-theme-edit"
-          };
-        }
-      })
-    }
+    tools
   });
   let response;
   try {