@elytracms/studio 0.0.57 → 0.0.58

package/dist/lib/ai/tools.js

@@ -14,21 +14,30 @@
  *     a write path; apply is a separate, human-gated draft write.
  *  3. {@link createChatToolExecutor} — the client executor map `useChat`'s
  *     `onToolCall` dispatches into. Readers pass through; the terminal tools run
- *     the deterministic engines (`applyContentWithShape` / `translateDocument`)
- *     through the route's kept `generate` branch and return a COMPACT proposal
- *     summary as the tool output — the full proposal goes to the review UI via
+ *     the deterministic engines (`applyContentWithShape` / `translateDocument` /
+ *     `buildUpdateProposal`) and return a COMPACT proposal summary as the tool
+ *     output — the full proposal goes to the review UI via
  *     `onProposal(toolCallId, …)`, never to the model.
  *
- * EC-378 adds `updateFields` as one more definition + one more executor case —
- * the map's shape leaves that slot open.
+ * EC-378: `updateFields` is the edit-flow terminal tool — the model authors
+ * per-field changes directly (it has `getDocument` output + the conversation as
+ * context); the executor reads the CURRENT document, builds a validated update
+ * proposal (`buildUpdateProposal`), and hands it to the review sink. Its target
+ * (and `getDocument`'s) may be omitted to mean the document currently open in
+ * the editor — resolved via the {@link ChatToolExecutorOptions.currentDocument}
+ * seam ({@link resolveDocumentTarget}); the context block the panel injects is
+ * ADVISORY, the resolution here is what makes "this document" deterministic.
  *
  * The EC-199 planner enum/schema (`plannerSchema` / `parsePlannerAction`) retired
  * with the hand-rolled orchestrator (EC-334 slice 2).
  */
 import { z } from 'zod';
 import { resolveDocumentTitle } from '@elytracms/core/cms-core';
+import { parseRichTextValue, richTextValueToMarkdownProse } from '@elytracms/core/rich-text';
 import { applyContentWithShape } from './apply-content.js';
 import { translateDocument } from './translate-document.js';
+import { buildUpdateProposal } from './update-fields.js';
+import { aiProvenance } from './provenance.js';
 /** Per-search result cap (protects the wire — results become model context). */
 export const DEFAULT_SEARCH_LIMIT = 20;
 /**
@@ -66,10 +75,18 @@ export const chatToolDefinitions = {
         }),
     },
     getDocument: {
-        description: 'Fetch one full document (values + localized values) by collection and id.',
+        description: 'Fetch one full document (values + localized values + block ids) by collection and ' +
+            'id. Omit both to read the document currently open in the editor. Rich-text field ' +
+            'values are returned as markdown strings where faithfully expressible.',
         inputSchema: z.object({
-            collection: z.string().describe('Collection id.'),
-            id: z.string().describe('Document id (from a searchDocuments result).'),
+            collection: z
+                .string()
+                .optional()
+                .describe('Collection id. Omit to target the currently open document.'),
+            id: z
+                .string()
+                .optional()
+                .describe('Document id (from a searchDocuments result). Omit to target the currently open document.'),
         }),
     },
     createDocument: {
@@ -81,9 +98,52 @@ export const chatToolDefinitions = {
             instruction: z.string().describe('What to write, refining the user request.'),
         }),
     },
+    updateFields: {
+        description: 'Change specific fields of an EXISTING document as a reviewable proposal — THE ' +
+            'tool for every edit request (change / fix / remove / replace / rewrite wording, ' +
+            'values, or a page-builder element). Call getDocument first to see the current ' +
+            'values (and block ids), then pass ONLY the fields that change. A block prop ' +
+            '(e.g. a Hero headline) is addressed as field + blockId + prop. Omit collection ' +
+            'and id to target the document currently open in the editor. A rich-text field ' +
+            'takes the FULL new value as a MARKDOWN string (headings, lists, links, bold/italic, ' +
+            'blockquotes — no images, code, tables, or HTML).',
+        inputSchema: z.object({
+            collection: z
+                .string()
+                .optional()
+                .describe('Collection id. Omit to target the currently open document.'),
+            id: z
+                .string()
+                .optional()
+                .describe('Document id. Omit to target the currently open document.'),
+            changes: z
+                .array(z.object({
+                field: z.string().describe('Field name from the collection schema.'),
+                locale: z
+                    .string()
+                    .optional()
+                    .describe("Locale of a LOCALIZED field (defaults to the editor's working locale)."),
+                blockId: z
+                    .string()
+                    .optional()
+                    .describe('For a blocks field: the id of the block to change (from getDocument).'),
+                prop: z
+                    .string()
+                    .optional()
+                    .describe('With blockId: the component prop to change.'),
+                value: z
+                    .unknown()
+                    .optional()
+                    .describe('The new value (a rich-text field takes a markdown string). null clears the field/prop.'),
+            }))
+                .min(1)
+                .describe('The field changes — only what changes, never the whole document.'),
+        }),
+    },
     translateDocument: {
-        description: 'Fill the empty locale values of an EXISTING document (search for it first to ' +
-            'get its id). Returns a compact proposal summary.',
+        description: 'Fill the EMPTY locale values of an existing document (search for it first to ' +
+            'get its id). Only for translation requests — never for edits (use updateFields ' +
+            'to change existing content). Returns a compact proposal summary.',
         inputSchema: z.object({
             collection: z.string().describe('Collection id.'),
             id: z.string().describe('Document id (from a searchDocuments result).'),
@@ -91,8 +151,39 @@ export const chatToolDefinitions = {
         }),
     },
 };
+/**
+ * Resolve a tool call's target document from its (optional) input coordinates
+ * and the current-document seam (EC-378). Deterministic:
+ *
+ *  - both given → use them verbatim;
+ *  - both omitted → the currently open document (error when none is open);
+ *  - `collection` given with `id` omitted → the open document ONLY when the
+ *    collections match — a named collection must never silently cross onto a
+ *    different open document.
+ *
+ * Pure — tested directly; `getDocument` and `updateFields` share it.
+ */
+export function resolveDocumentTarget(input, current) {
+    if (input.collection !== undefined && input.id !== undefined) {
+        return { ok: true, ref: { collection: input.collection, id: input.id } };
+    }
+    if (!current) {
+        return {
+            ok: false,
+            errorText: 'No target document — pass collection and id, or ask the user to open the document in the editor.',
+        };
+    }
+    if (input.collection !== undefined && input.collection !== current.collection) {
+        return {
+            ok: false,
+            errorText: `The open document is in collection "${current.collection}", not "${input.collection}" — pass the document id explicitly.`,
+        };
+    }
+    return { ok: true, ref: { collection: current.collection, id: input.id ?? current.id } };
+}
 export function createChatCandidateStore() {
     const searched = new Map();
+    const searchedAssets = new Map();
     return {
         record(collection, results) {
             const byId = searched.get(collection) ?? new Map();
@@ -100,6 +191,10 @@ export function createChatCandidateStore() {
                 byId.set(result.id, result);
             searched.set(collection, byId);
         },
+        recordAssets(results) {
+            for (const result of results)
+                searchedAssets.set(result.id, result);
+        },
         candidatesFor(collection) {
             const candidates = {};
             for (const field of collection.fields) {
@@ -112,6 +207,18 @@ export function createChatCandidateStore() {
             }
             return candidates;
         },
+        assetCandidatesFor(collection) {
+            const candidates = {};
+            if (searchedAssets.size === 0)
+                return candidates;
+            const pool = [...searchedAssets.values()].map((a) => ({ id: a.id, ...(a.title ? { label: a.title } : {}) }));
+            for (const field of collection.fields) {
+                if (field.type !== 'asset')
+                    continue;
+                candidates[field.name] = pool;
+            }
+            return candidates;
+        },
     };
 }
 function issueSummary(issues) {
@@ -120,6 +227,45 @@ function issueSummary(issues) {
         .map((issue) => issue.message)
         .join('; ');
 }
+/**
+ * The MODEL-facing view of a document (EC-379): rich-text field values are
+ * projected to markdown strings — but ONLY when the engine's loss-guarded
+ * inverse can express them faithfully (subset-only content, round-trip proven).
+ * A document carrying embeds, internal `ref` links, or out-of-subset marks keeps
+ * its `{ version, doc }` envelope, so nothing the model later echoes back can
+ * silently lose structure. Applies to the `getDocument` TOOL OUTPUT only; the
+ * proposal/apply paths always read the raw stored document.
+ */
+export function projectRichTextAsMarkdown(document, collection) {
+    const richTextFields = collection.fields
+        .filter((field) => field.type === 'richText')
+        .map((field) => field.name);
+    if (richTextFields.length === 0)
+        return document;
+    const mapBucket = (bucket) => {
+        let next = bucket;
+        for (const name of richTextFields) {
+            const value = next[name];
+            if (value === undefined || value === null)
+                continue;
+            const parsed = parseRichTextValue(value);
+            if (!parsed.ok)
+                continue;
+            const markdown = richTextValueToMarkdownProse(parsed.value);
+            if (markdown === undefined)
+                continue; // not faithfully expressible → keep the envelope
+            if (next === bucket)
+                next = { ...bucket };
+            next[name] = markdown;
+        }
+        return next;
+    };
+    const values = mapBucket(document.values);
+    const localized = document.localized
+        ? Object.fromEntries(Object.entries(document.localized).map(([locale, bucket]) => [locale, mapBucket(bucket)]))
+        : undefined;
+    return { ...document, values, ...(localized ? { localized } : {}) };
+}
 /**
  * Build the client executor map. Every entry validates its input against
  * {@link chatToolDefinitions}' zod schema (the route validates UIMessages only
@@ -151,17 +297,107 @@ export function createChatToolExecutor(options) {
             ...(input.query ? { query: input.query } : {}),
             limit,
         })).slice(0, limit);
+        // EC-381 — leash asset fields to what the model actually searched, exactly as
+        // searchDocuments feeds the relation store.
+        options.candidates.recordAssets(results);
         return { ok: true, output: results };
     }
     async function getDocument(input) {
         if (!options.readers.getDocument) {
             return { ok: false, errorText: 'Reading documents is not available here.' };
         }
-        const document = await options.readers.getDocument(input);
+        const target = resolveDocumentTarget(input, options.currentDocument?.());
+        if (!target.ok)
+            return { ok: false, errorText: target.errorText };
+        const document = await options.readers.getDocument(target.ref);
         if (!document) {
-            return { ok: false, errorText: `Document "${input.collection}/${input.id}" was not found.` };
+            return {
+                ok: false,
+                errorText: `Document "${target.ref.collection}/${target.ref.id}" was not found.`,
+            };
         }
-        return { ok: true, output: document };
+        // EC-379: the model reads (and re-authors) rich text as markdown.
+        const collection = collectionById(target.ref.collection);
+        return { ok: true, output: collection ? projectRichTextAsMarkdown(document, collection) : document };
+    }
+    /** EC-378 — the edit-flow terminal tool: current doc + model-authored changes → validated proposal. */
+    async function updateFields(toolCallId, input) {
+        if (!options.readers.getDocument) {
+            return { ok: false, errorText: 'Reading documents is not available here.' };
+        }
+        const target = resolveDocumentTarget(input, options.currentDocument?.());
+        if (!target.ok)
+            return { ok: false, errorText: target.errorText };
+        const collection = collectionById(target.ref.collection);
+        if (!collection) {
+            return {
+                ok: false,
+                errorText: `Unknown collection "${target.ref.collection}" — use a collection id from the catalog.`,
+            };
+        }
+        const document = await options.readers.getDocument(target.ref);
+        if (!document) {
+            return {
+                ok: false,
+                errorText: `Document "${target.ref.collection}/${target.ref.id}" was not found.`,
+            };
+        }
+        const result = buildUpdateProposal({
+            registry: options.registry,
+            collection,
+            document,
+            changes: input.changes,
+            candidates: options.candidates.candidatesFor(collection),
+            assetCandidates: options.candidates.assetCandidatesFor(collection),
+            ...(options.locale ? { locale: options.locale } : {}),
+            ...(options.localeConfig ? { localeConfig: options.localeConfig } : {}),
+            ...(options.validateRichTextEmbeds
+                ? { validateRichTextEmbeds: options.validateRichTextEmbeds }
+                : {}),
+            ...(options.validateComposition ? { validateComposition: options.validateComposition } : {}),
+            ...(options.store ? { store: options.store } : {}),
+        });
+        if (!result.ok) {
+            return {
+                ok: false,
+                errorText: `The proposed changes did not pass validation: ${issueSummary(result.issues)}`,
+            };
+        }
+        if (result.kind === 'no-change') {
+            return {
+                ok: true,
+                output: {
+                    status: 'no-change',
+                    note: 'The requested change matches the current values — there is nothing to update.',
+                },
+            };
+        }
+        options.onProposal(toolCallId, {
+            origin: 'update',
+            collection: collection.id,
+            documentId: document.id,
+            patch: result.patch,
+            provenance: aiProvenance(options.provider),
+            attempts: 1,
+            issues: result.issues,
+            before: result.before,
+        });
+        // Compact summary only — the full patch goes to the review UI, not the model.
+        const titleValues = {
+            ...result.patch.values,
+            ...(options.locale ? result.patch.localized?.[options.locale] : {}),
+        };
+        return {
+            ok: true,
+            output: {
+                status: 'proposed',
+                collection: collection.id,
+                documentId: document.id,
+                title: resolveDocumentTitle(collection, titleValues, document.id),
+                changedFields: result.changedFields,
+                note: 'Update proposal created; the editor reviews and applies it in the studio. Summarize the change briefly — do not repeat the content.',
+            },
+        };
     }
     async function createDocument(toolCallId, input) {
         const collection = collectionById(input.collection);
@@ -179,6 +415,8 @@ export function createChatToolExecutor(options) {
             ...(knowledge ? { knowledge } : {}),
             ...(options.components ? { components: options.components } : {}),
             candidates: options.candidates.candidatesFor(collection),
+            // EC-381 — asset/image fields are leashed to searched library assets.
+            assetCandidates: options.candidates.assetCandidatesFor(collection),
             ...(options.locale ? { locale: options.locale } : {}),
             ...(options.validateRichTextEmbeds
                 ? { validateRichTextEmbeds: options.validateRichTextEmbeds }
@@ -301,9 +539,10 @@ export function createChatToolExecutor(options) {
                         return await getDocument(parsed.data);
                     case 'createDocument':
                         return await createDocument(call.toolCallId, parsed.data);
+                    case 'updateFields':
+                        return await updateFields(call.toolCallId, parsed.data);
                     case 'translateDocument':
                         return await translate(call.toolCallId, parsed.data);
-                    // EC-378: case 'updateFields' lands here (leashed field-update proposals).
                     default:
                         return { ok: false, errorText: `Unknown tool "${call.toolName}".` };
                 }

package/dist/lib/ai/tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/lib/ai/tools.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The narrow tool set the assistant works against (EC-199, reshaped by EC-334).\n *\n * Per the ratified AD, tools execute CLIENT-side against the operations layer with\n * the user's own session. This module carries the three pieces of that contract:\n *\n *  1. {@link chatToolDefinitions} — the SDK-native tool DEFINITIONS the route's\n *     chat branch declares in `streamText`, deliberately WITHOUT `execute`, so the\n *     SDK forwards every call to the client (the route stays a zero-data-access\n *     proxy). Plain `{ description, inputSchema }` objects with zod schemas —\n *     structurally the SDK's `FunctionTool`, with no SDK import (bundle discipline).\n *  2. {@link ChatToolReaders} — the operations-backed read interface the studio\n *     binds client-side (search / list / get). Reads only — the engine never gains\n *     a write path; apply is a separate, human-gated draft write.\n *  3. {@link createChatToolExecutor} — the client executor map `useChat`'s\n *     `onToolCall` dispatches into. Readers pass through; the terminal tools run\n *     the deterministic engines (`applyContentWithShape` / `translateDocument`)\n *     through the route's kept `generate` branch and return a COMPACT proposal\n *     summary as the tool output — the full proposal goes to the review UI via\n *     `onProposal(toolCallId, …)`, never to the model.\n *\n * EC-378 adds `updateFields` as one more definition + one more executor case —\n * the map's shape leaves that slot open.\n *\n * The EC-199 planner enum/schema (`plannerSchema` / `parsePlannerAction`) retired\n * with the hand-rolled orchestrator (EC-334 slice 2).\n */\nimport { z } from 'zod'\nimport { resolveDocumentTitle } from '@elytracms/core/cms-core'\nimport type {\n  CmsDocument,\n  CollectionDef,\n  CollectionRegistry,\n  CmsValidationIssue,\n  LocaleConfig,\n  ValidateDocumentOptions,\n} from '@elytracms/core/cms-core'\nimport type { ComponentManifest } from '@elytracms/core/component-registry'\nimport { applyContentWithShape } from './apply-content'\nimport { translateDocument } from './translate-document'\nimport type { ChatProposal } from './chat-state'\nimport type {\n  AiProvider,\n  RelationCandidate,\n  RelationCandidates,\n  ResolvedKnowledge,\n} from './types'\n\n/** A document the model may reference as a relation target (from a `searchDocuments` read). */\nexport interface DocumentSearchResult {\n  id: string\n  title?: string\n}\n\n/** An asset the model may reference (from a `listAssets` read). */\nexport interface AssetSearchResult {\n  id: string\n  title?: string\n}\n\n/**\n * The client-side, operations-backed readers the executor calls. The studio binds\n * these to the user's authenticated operations client; tests bind an in-memory fake.\n * Reads only — there is no write tool (apply is a separate, human-gated draft write).\n */\nexport interface ChatToolReaders {\n  searchDocuments(input: {\n    collection: string\n    query?: string\n    limit?: number\n  }): Promise<DocumentSearchResult[]>\n  listAssets(input: { query?: string; limit?: number }): Promise<AssetSearchResult[]>\n  /**\n   * Fetch a full document (values + localized) — the translate flow and the model's\n   * `getDocument` tool. Optional: a studio that only wires create can omit it.\n   */\n  getDocument?(input: { collection: string; id: string }): Promise<CmsDocument | null>\n}\n\n/** Per-search result cap (protects the wire — results become model context). */\nexport const DEFAULT_SEARCH_LIMIT = 20\n\n// --- SDK-native chat tool definitions (EC-334) --------------------------------------\n\n/**\n * One model-facing tool definition for the route's `streamText` call. Structurally\n * the SDK's `FunctionTool` WITHOUT `execute` (execution is client-side, always) —\n * typed locally so this module needs no SDK import.\n */\nexport interface ChatToolDefinition {\n  description: string\n  /** Zod input schema (the AI SDK accepts zod schemas as `inputSchema` directly). */\n  inputSchema: z.ZodType\n}\n\n/**\n * The tool set the native chat branch declares (EC-334). No `execute` on any entry:\n * the SDK forwards each call to the client, which executes reads against the\n * operations layer with the user's session and posts the result back; the terminal\n * tools (`createDocument` / `translateDocument`) run the deterministic engines\n * client-side and return a compact proposal summary as the tool output. The route\n * itself never executes anything.\n *\n * Collections are NOT enum-leashed here — the route has zero data access, so it has\n * no catalog; the catalog reaches the model through the request `context` (system\n * prompt), and every id a proposal references must come from a tool RESULT\n * (client-validated; `applyContentWithShape` still enum-leashes relation ids).\n */\nexport const chatToolDefinitions = {\n  searchDocuments: {\n    description:\n      'Search documents in a collection. Use it to find the REAL ids a relation may ' +\n      'reference, or to locate an existing document — never invent an id. Returns ' +\n      '{ id, title } summaries.',\n    inputSchema: z.object({\n      collection: z\n        .string()\n        .describe('Target collection id (from the catalog in the system context).'),\n      query: z.string().optional().describe('Optional search text (title match).'),\n      limit: z.number().int().positive().optional().describe('Max results.'),\n    }),\n  },\n  listAssets: {\n    description:\n      'List or search assets (images, files). Use it to find REAL asset ids — never ' +\n      'invent one. Returns { id, title } summaries.',\n    inputSchema: z.object({\n      query: z.string().optional().describe('Optional search text.'),\n      limit: z.number().int().positive().optional().describe('Max results.'),\n    }),\n  },\n  getDocument: {\n    description: 'Fetch one full document (values + localized values) by collection and id.',\n    inputSchema: z.object({\n      collection: z.string().describe('Collection id.'),\n      id: z.string().describe('Document id (from a searchDocuments result).'),\n    }),\n  },\n  createDocument: {\n    description:\n      'Author a NEW document in a collection as a reviewable draft proposal. Terminal ' +\n      'step of a creation request — call it once you have gathered the real ids you ' +\n      'need. Returns a compact proposal summary.',\n    inputSchema: z.object({\n      collection: z.string().describe('Target collection id.'),\n      instruction: z.string().describe('What to write, refining the user request.'),\n    }),\n  },\n  translateDocument: {\n    description:\n      'Fill the empty locale values of an EXISTING document (search for it first to ' +\n      'get its id). Returns a compact proposal summary.',\n    inputSchema: z.object({\n      collection: z.string().describe('Collection id.'),\n      id: z.string().describe('Document id (from a searchDocuments result).'),\n      locale: z.string().optional().describe('Target locale (defaults to the active one).'),\n    }),\n  },\n} satisfies Record<string, ChatToolDefinition>\n\n// --- Client executor map (EC-334) ----------------------------------------------------\n\n/** One forwarded tool call, as `useChat`'s `onToolCall` receives it. */\nexport interface ChatToolCall {\n  toolCallId: string\n  toolName: string\n  input: unknown\n}\n\n/**\n * A tool execution outcome: an `output` posted back as the tool result, or an\n * `errorText` posted as an `output-error` part (the model sees the failure and\n * can react — never a thrown exception into the stream).\n */\nexport type ChatToolOutcome = { ok: true; output: unknown } | { ok: false; errorText: string }\n\n/**\n * The per-conversation relation-candidate store: every `searchDocuments` result\n * is recorded per collection, and `createDocument` may only reference the ids\n * gathered here (the `applyContentWithShape` enum leash makes a hallucinated id\n * structurally unrepresentable). Held by the panel per conversation — a new\n * conversation (EC-380 clear) starts an empty store.\n */\nexport interface ChatCandidateStore {\n  record(collection: string, results: readonly DocumentSearchResult[]): void\n  /** Candidates for a target collection's relation fields, keyed by field name. */\n  candidatesFor(collection: CollectionDef): RelationCandidates\n}\n\nexport function createChatCandidateStore(): ChatCandidateStore {\n  const searched = new Map<string, Map<string, DocumentSearchResult>>()\n  return {\n    record(collection, results) {\n      const byId = searched.get(collection) ?? new Map<string, DocumentSearchResult>()\n      for (const result of results) byId.set(result.id, result)\n      searched.set(collection, byId)\n    },\n    candidatesFor(collection) {\n      const candidates: RelationCandidates = {}\n      for (const field of collection.fields) {\n        if (field.type !== 'relation') continue\n        const found = searched.get(field.target)\n        if (!found || found.size === 0) continue\n        candidates[field.name] = [...found.values()].map(\n          (r): RelationCandidate => ({ id: r.id, ...(r.title ? { label: r.title } : {}) }),\n        )\n      }\n      return candidates\n    },\n  }\n}\n\nexport interface ChatToolExecutorOptions {\n  /** The (route) provider the terminal engines proxy their model calls through. */\n  provider: AiProvider\n  registry: CollectionRegistry\n  /** The collections the assistant may target (unknown ids fail loud). */\n  collections: readonly CollectionDef[]\n  /** Operations-backed readers (client-side, user's session). */\n  readers: ChatToolReaders\n  /** Mint a fresh document id for a new draft (studio: the CMS store's minter). */\n  mintDocumentId: (collectionId: string) => string\n  /** Per-conversation relation-candidate store (see {@link createChatCandidateStore}). */\n  candidates: ChatCandidateStore\n  /**\n   * Full proposal sink, keyed by `toolCallId` — the review UI's entry point.\n   * The tool OUTPUT stays a compact summary; the patch never reaches the model.\n   */\n  onProposal: (toolCallId: string, proposal: ChatProposal) => void\n  /** Current knowledge snapshot (thunk — the body thunk refreshes it per request). */\n  knowledge?: () => ResolvedKnowledge | undefined\n  /** Component manifests — context for `allow`-leashed richText/blocks fields. */\n  components?: readonly ComponentManifest[]\n  /** Target locale for localized fields. */\n  locale?: string\n  /** Locale config — required for `translateDocument`. */\n  localeConfig?: LocaleConfig\n  /** Injected leashes / store for `applyContentWithShape`'s validation. */\n  validateRichTextEmbeds?: ValidateDocumentOptions['validateRichTextEmbeds']\n  validateComposition?: ValidateDocumentOptions['validateComposition']\n  store?: ValidateDocumentOptions['store']\n  /** Max repair attempts inside `applyContentWithShape`. */\n  maxRepairAttempts?: number\n  /** Per-search result cap (default {@link DEFAULT_SEARCH_LIMIT}). */\n  searchLimit?: number\n}\n\n/** The executor `useChat`'s `onToolCall` dispatches into. */\nexport interface ChatToolExecutor {\n  execute(call: ChatToolCall): Promise<ChatToolOutcome>\n}\n\nfunction issueSummary(issues: readonly CmsValidationIssue[]): string {\n  return issues\n    .slice(0, 5)\n    .map((issue) => issue.message)\n    .join('; ')\n}\n\n/**\n * Build the client executor map. Every entry validates its input against\n * {@link chatToolDefinitions}' zod schema (the route validates UIMessages only\n * structurally — deep input validation is the client's), executes with the\n * user's session, and returns a JSON-safe outcome. EC-378's `updateFields`\n * lands as one more case in this dispatch.\n */\nexport function createChatToolExecutor(options: ChatToolExecutorOptions): ChatToolExecutor {\n  const searchLimit = options.searchLimit ?? DEFAULT_SEARCH_LIMIT\n\n  function collectionById(id: string): CollectionDef | undefined {\n    return options.collections.find((c) => c.id === id)\n  }\n\n  async function searchDocuments(input: {\n    collection: string\n    query?: string\n    limit?: number\n  }): Promise<ChatToolOutcome> {\n    if (!collectionById(input.collection)) {\n      return { ok: false, errorText: `Unknown collection \"${input.collection}\" — use a collection id from the catalog.` }\n    }\n    const limit = Math.min(input.limit ?? searchLimit, searchLimit)\n    const results = (\n      await options.readers.searchDocuments({\n        collection: input.collection,\n        ...(input.query ? { query: input.query } : {}),\n        limit,\n      })\n    ).slice(0, limit)\n    options.candidates.record(input.collection, results)\n    return { ok: true, output: results }\n  }\n\n  async function listAssets(input: { query?: string; limit?: number }): Promise<ChatToolOutcome> {\n    const limit = Math.min(input.limit ?? searchLimit, searchLimit)\n    const results = (\n      await options.readers.listAssets({\n        ...(input.query ? { query: input.query } : {}),\n        limit,\n      })\n    ).slice(0, limit)\n    return { ok: true, output: results }\n  }\n\n  async function getDocument(input: { collection: string; id: string }): Promise<ChatToolOutcome> {\n    if (!options.readers.getDocument) {\n      return { ok: false, errorText: 'Reading documents is not available here.' }\n    }\n    const document = await options.readers.getDocument(input)\n    if (!document) {\n      return { ok: false, errorText: `Document \"${input.collection}/${input.id}\" was not found.` }\n    }\n    return { ok: true, output: document }\n  }\n\n  async function createDocument(\n    toolCallId: string,\n    input: { collection: string; instruction: string },\n  ): Promise<ChatToolOutcome> {\n    const collection = collectionById(input.collection)\n    if (!collection) {\n      return { ok: false, errorText: `Unknown collection \"${input.collection}\" — use a collection id from the catalog.` }\n    }\n    const documentId = options.mintDocumentId(collection.id)\n    const knowledge = options.knowledge?.()\n    const result = await applyContentWithShape({\n      provider: options.provider,\n      registry: options.registry,\n      collection,\n      documentId,\n      instruction: input.instruction,\n      ...(knowledge ? { knowledge } : {}),\n      ...(options.components ? { components: options.components } : {}),\n      candidates: options.candidates.candidatesFor(collection),\n      ...(options.locale ? { locale: options.locale } : {}),\n      ...(options.validateRichTextEmbeds\n        ? { validateRichTextEmbeds: options.validateRichTextEmbeds }\n        : {}),\n      ...(options.validateComposition ? { validateComposition: options.validateComposition } : {}),\n      ...(options.store ? { store: options.store } : {}),\n      ...(options.maxRepairAttempts !== undefined\n        ? { maxRepairAttempts: options.maxRepairAttempts }\n        : {}),\n    })\n    if (!result.ok) {\n      return {\n        ok: false,\n        errorText: `The drafted ${collection.id} did not pass validation: ${issueSummary(result.issues)}`,\n      }\n    }\n    options.onProposal(toolCallId, {\n      origin: 'create',\n      collection: collection.id,\n      documentId,\n      patch: result.patch,\n      provenance: result.provenance,\n      attempts: result.attempts,\n      issues: result.issues,\n    })\n    // Compact summary only — the full patch goes to the review UI, not the model.\n    return {\n      ok: true,\n      output: {\n        status: 'proposed',\n        collection: collection.id,\n        documentId,\n        title: resolveDocumentTitle(collection, result.patch.values, documentId),\n        note: 'Draft proposal created; the editor reviews and applies it in the studio. Summarize briefly — do not repeat the content.',\n      },\n    }\n  }\n\n  async function translate(\n    toolCallId: string,\n    input: { collection: string; id: string; locale?: string },\n  ): Promise<ChatToolOutcome> {\n    const collection = collectionById(input.collection)\n    if (!collection) {\n      return { ok: false, errorText: `Unknown collection \"${input.collection}\" — use a collection id from the catalog.` }\n    }\n    if (!options.readers.getDocument || !options.localeConfig) {\n      return { ok: false, errorText: 'Translation is not available here.' }\n    }\n    const document = await options.readers.getDocument({\n      collection: input.collection,\n      id: input.id,\n    })\n    if (!document) {\n      return { ok: false, errorText: `Document \"${input.collection}/${input.id}\" was not found.` }\n    }\n    const knowledge = options.knowledge?.()\n    const result = await translateDocument({\n      provider: options.provider,\n      collection,\n      document,\n      localeConfig: options.localeConfig,\n      ...(input.locale ? { targetLocales: [input.locale] } : {}),\n      ...(knowledge ? { knowledge } : {}),\n    })\n    if (result.total === 0) {\n      return {\n        ok: true,\n        output: {\n          status: 'nothing-to-translate',\n          note: 'Every locale value is already filled — there is nothing to translate.',\n        },\n      }\n    }\n    if (result.translated === 0) {\n      return { ok: false, errorText: 'The translation did not produce any content.' }\n    }\n    options.onProposal(toolCallId, {\n      origin: 'translate',\n      collection: collection.id,\n      documentId: document.id,\n      patch: {\n        collection: collection.id,\n        id: document.id,\n        values: result.document.values,\n        ...(result.document.localized ? { localized: result.document.localized } : {}),\n      },\n      provenance: result.provenance,\n      attempts: 1,\n      issues: [],\n      before: {\n        values: document.values,\n        ...(document.localized ? { localized: document.localized } : {}),\n      },\n    })\n    return {\n      ok: true,\n      output: {\n        status: 'proposed',\n        collection: collection.id,\n        documentId: document.id,\n        translatedUnits: result.translated,\n        note: 'Translation proposal created; the editor reviews and applies it in the studio.',\n      },\n    }\n  }\n\n  return {\n    async execute(call: ChatToolCall): Promise<ChatToolOutcome> {\n      const definition = (chatToolDefinitions as Record<string, ChatToolDefinition>)[call.toolName]\n      if (!definition) {\n        return { ok: false, errorText: `Unknown tool \"${call.toolName}\".` }\n      }\n      const parsed = definition.inputSchema.safeParse(call.input)\n      if (!parsed.success) {\n        return { ok: false, errorText: `Invalid ${call.toolName} input: ${parsed.error.message}` }\n      }\n      try {\n        switch (call.toolName) {\n          case 'searchDocuments':\n            return await searchDocuments(parsed.data as { collection: string; query?: string; limit?: number })\n          case 'listAssets':\n            return await listAssets(parsed.data as { query?: string; limit?: number })\n          case 'getDocument':\n            return await getDocument(parsed.data as { collection: string; id: string })\n          case 'createDocument':\n            return await createDocument(\n              call.toolCallId,\n              parsed.data as { collection: string; instruction: string },\n            )\n          case 'translateDocument':\n            return await translate(\n              call.toolCallId,\n              parsed.data as { collection: string; id: string; locale?: string },\n            )\n          // EC-378: case 'updateFields' lands here (leashed field-update proposals).\n          default:\n            return { ok: false, errorText: `Unknown tool \"${call.toolName}\".` }\n        }\n      } catch (error) {\n        return {\n          ok: false,\n          errorText: `The ${call.toolName} step failed: ${error instanceof Error ? error.message : 'unknown error'}`,\n        }\n      }\n    },\n  }\n}\n"]}
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/lib/ai/tools.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The narrow tool set the assistant works against (EC-199, reshaped by EC-334).\n *\n * Per the ratified AD, tools execute CLIENT-side against the operations layer with\n * the user's own session. This module carries the three pieces of that contract:\n *\n *  1. {@link chatToolDefinitions} — the SDK-native tool DEFINITIONS the route's\n *     chat branch declares in `streamText`, deliberately WITHOUT `execute`, so the\n *     SDK forwards every call to the client (the route stays a zero-data-access\n *     proxy). Plain `{ description, inputSchema }` objects with zod schemas —\n *     structurally the SDK's `FunctionTool`, with no SDK import (bundle discipline).\n *  2. {@link ChatToolReaders} — the operations-backed read interface the studio\n *     binds client-side (search / list / get). Reads only — the engine never gains\n *     a write path; apply is a separate, human-gated draft write.\n *  3. {@link createChatToolExecutor} — the client executor map `useChat`'s\n *     `onToolCall` dispatches into. Readers pass through; the terminal tools run\n *     the deterministic engines (`applyContentWithShape` / `translateDocument` /\n *     `buildUpdateProposal`) and return a COMPACT proposal summary as the tool\n *     output — the full proposal goes to the review UI via\n *     `onProposal(toolCallId, …)`, never to the model.\n *\n * EC-378: `updateFields` is the edit-flow terminal tool — the model authors\n * per-field changes directly (it has `getDocument` output + the conversation as\n * context); the executor reads the CURRENT document, builds a validated update\n * proposal (`buildUpdateProposal`), and hands it to the review sink. Its target\n * (and `getDocument`'s) may be omitted to mean the document currently open in\n * the editor — resolved via the {@link ChatToolExecutorOptions.currentDocument}\n * seam ({@link resolveDocumentTarget}); the context block the panel injects is\n * ADVISORY, the resolution here is what makes \"this document\" deterministic.\n *\n * The EC-199 planner enum/schema (`plannerSchema` / `parsePlannerAction`) retired\n * with the hand-rolled orchestrator (EC-334 slice 2).\n */\nimport { z } from 'zod'\nimport { resolveDocumentTitle } from '@elytracms/core/cms-core'\nimport type {\n  CmsDocument,\n  CollectionDef,\n  CollectionRegistry,\n  CmsValidationIssue,\n  FieldValues,\n  LocaleConfig,\n  ValidateDocumentOptions,\n} from '@elytracms/core/cms-core'\nimport { parseRichTextValue, richTextValueToMarkdownProse } from '@elytracms/core/rich-text'\nimport type { ComponentManifest } from '@elytracms/core/component-registry'\nimport { applyContentWithShape } from './apply-content'\nimport { translateDocument } from './translate-document'\nimport { buildUpdateProposal } from './update-fields'\nimport type { UpdateFieldChange } from './update-fields'\nimport { aiProvenance } from './provenance'\nimport type { ChatProposal } from './chat-state'\nimport type {\n  AiProvider,\n  AssetCandidate,\n  AssetCandidates,\n  RelationCandidate,\n  RelationCandidates,\n  ResolvedKnowledge,\n} from './types'\n\n/** A document the model may reference as a relation target (from a `searchDocuments` read). */\nexport interface DocumentSearchResult {\n  id: string\n  title?: string\n}\n\n/** An asset the model may reference (from a `listAssets` read). */\nexport interface AssetSearchResult {\n  id: string\n  title?: string\n}\n\n/**\n * The client-side, operations-backed readers the executor calls. The studio binds\n * these to the user's authenticated operations client; tests bind an in-memory fake.\n * Reads only — there is no write tool (apply is a separate, human-gated draft write).\n */\nexport interface ChatToolReaders {\n  searchDocuments(input: {\n    collection: string\n    query?: string\n    limit?: number\n  }): Promise<DocumentSearchResult[]>\n  listAssets(input: { query?: string; limit?: number }): Promise<AssetSearchResult[]>\n  /**\n   * Fetch a full document (values + localized) — the translate flow and the model's\n   * `getDocument` tool. Optional: a studio that only wires create can omit it.\n   */\n  getDocument?(input: { collection: string; id: string }): Promise<CmsDocument | null>\n}\n\n/** Per-search result cap (protects the wire — results become model context). */\nexport const DEFAULT_SEARCH_LIMIT = 20\n\n// --- SDK-native chat tool definitions (EC-334) --------------------------------------\n\n/**\n * One model-facing tool definition for the route's `streamText` call. Structurally\n * the SDK's `FunctionTool` WITHOUT `execute` (execution is client-side, always) —\n * typed locally so this module needs no SDK import.\n */\nexport interface ChatToolDefinition {\n  description: string\n  /** Zod input schema (the AI SDK accepts zod schemas as `inputSchema` directly). */\n  inputSchema: z.ZodType\n}\n\n/**\n * The tool set the native chat branch declares (EC-334). No `execute` on any entry:\n * the SDK forwards each call to the client, which executes reads against the\n * operations layer with the user's session and posts the result back; the terminal\n * tools (`createDocument` / `translateDocument`) run the deterministic engines\n * client-side and return a compact proposal summary as the tool output. The route\n * itself never executes anything.\n *\n * Collections are NOT enum-leashed here — the route has zero data access, so it has\n * no catalog; the catalog reaches the model through the request `context` (system\n * prompt), and every id a proposal references must come from a tool RESULT\n * (client-validated; `applyContentWithShape` still enum-leashes relation ids).\n */\nexport const chatToolDefinitions = {\n  searchDocuments: {\n    description:\n      'Search documents in a collection. Use it to find the REAL ids a relation may ' +\n      'reference, or to locate an existing document — never invent an id. Returns ' +\n      '{ id, title } summaries.',\n    inputSchema: z.object({\n      collection: z\n        .string()\n        .describe('Target collection id (from the catalog in the system context).'),\n      query: z.string().optional().describe('Optional search text (title match).'),\n      limit: z.number().int().positive().optional().describe('Max results.'),\n    }),\n  },\n  listAssets: {\n    description:\n      'List or search assets (images, files). Use it to find REAL asset ids — never ' +\n      'invent one. Returns { id, title } summaries.',\n    inputSchema: z.object({\n      query: z.string().optional().describe('Optional search text.'),\n      limit: z.number().int().positive().optional().describe('Max results.'),\n    }),\n  },\n  getDocument: {\n    description:\n      'Fetch one full document (values + localized values + block ids) by collection and ' +\n      'id. Omit both to read the document currently open in the editor. Rich-text field ' +\n      'values are returned as markdown strings where faithfully expressible.',\n    inputSchema: z.object({\n      collection: z\n        .string()\n        .optional()\n        .describe('Collection id. Omit to target the currently open document.'),\n      id: z\n        .string()\n        .optional()\n        .describe(\n          'Document id (from a searchDocuments result). Omit to target the currently open document.',\n        ),\n    }),\n  },\n  createDocument: {\n    description:\n      'Author a NEW document in a collection as a reviewable draft proposal. Terminal ' +\n      'step of a creation request — call it once you have gathered the real ids you ' +\n      'need. Returns a compact proposal summary.',\n    inputSchema: z.object({\n      collection: z.string().describe('Target collection id.'),\n      instruction: z.string().describe('What to write, refining the user request.'),\n    }),\n  },\n  updateFields: {\n    description:\n      'Change specific fields of an EXISTING document as a reviewable proposal — THE ' +\n      'tool for every edit request (change / fix / remove / replace / rewrite wording, ' +\n      'values, or a page-builder element). Call getDocument first to see the current ' +\n      'values (and block ids), then pass ONLY the fields that change. A block prop ' +\n      '(e.g. a Hero headline) is addressed as field + blockId + prop. Omit collection ' +\n      'and id to target the document currently open in the editor. A rich-text field ' +\n      'takes the FULL new value as a MARKDOWN string (headings, lists, links, bold/italic, ' +\n      'blockquotes — no images, code, tables, or HTML).',\n    inputSchema: z.object({\n      collection: z\n        .string()\n        .optional()\n        .describe('Collection id. Omit to target the currently open document.'),\n      id: z\n        .string()\n        .optional()\n        .describe('Document id. Omit to target the currently open document.'),\n      changes: z\n        .array(\n          z.object({\n            field: z.string().describe('Field name from the collection schema.'),\n            locale: z\n              .string()\n              .optional()\n              .describe(\n                \"Locale of a LOCALIZED field (defaults to the editor's working locale).\",\n              ),\n            blockId: z\n              .string()\n              .optional()\n              .describe('For a blocks field: the id of the block to change (from getDocument).'),\n            prop: z\n              .string()\n              .optional()\n              .describe('With blockId: the component prop to change.'),\n            value: z\n              .unknown()\n              .optional()\n              .describe(\n                'The new value (a rich-text field takes a markdown string). null clears the field/prop.',\n              ),\n          }),\n        )\n        .min(1)\n        .describe('The field changes — only what changes, never the whole document.'),\n    }),\n  },\n  translateDocument: {\n    description:\n      'Fill the EMPTY locale values of an existing document (search for it first to ' +\n      'get its id). Only for translation requests — never for edits (use updateFields ' +\n      'to change existing content). Returns a compact proposal summary.',\n    inputSchema: z.object({\n      collection: z.string().describe('Collection id.'),\n      id: z.string().describe('Document id (from a searchDocuments result).'),\n      locale: z.string().optional().describe('Target locale (defaults to the active one).'),\n    }),\n  },\n} satisfies Record<string, ChatToolDefinition>\n\n// --- Client executor map (EC-334) ----------------------------------------------------\n\n/** One forwarded tool call, as `useChat`'s `onToolCall` receives it. */\nexport interface ChatToolCall {\n  toolCallId: string\n  toolName: string\n  input: unknown\n}\n\n/** The coordinates of the document currently open in the editor (EC-378 seam). */\nexport interface CurrentDocumentRef {\n  collection: string\n  id: string\n}\n\n/**\n * Resolve a tool call's target document from its (optional) input coordinates\n * and the current-document seam (EC-378). Deterministic:\n *\n *  - both given → use them verbatim;\n *  - both omitted → the currently open document (error when none is open);\n *  - `collection` given with `id` omitted → the open document ONLY when the\n *    collections match — a named collection must never silently cross onto a\n *    different open document.\n *\n * Pure — tested directly; `getDocument` and `updateFields` share it.\n */\nexport function resolveDocumentTarget(\n  input: { collection?: string; id?: string },\n  current: CurrentDocumentRef | null | undefined,\n): { ok: true; ref: CurrentDocumentRef } | { ok: false; errorText: string } {\n  if (input.collection !== undefined && input.id !== undefined) {\n    return { ok: true, ref: { collection: input.collection, id: input.id } }\n  }\n  if (!current) {\n    return {\n      ok: false,\n      errorText:\n        'No target document — pass collection and id, or ask the user to open the document in the editor.',\n    }\n  }\n  if (input.collection !== undefined && input.collection !== current.collection) {\n    return {\n      ok: false,\n      errorText: `The open document is in collection \"${current.collection}\", not \"${input.collection}\" — pass the document id explicitly.`,\n    }\n  }\n  return { ok: true, ref: { collection: current.collection, id: input.id ?? current.id } }\n}\n\n/**\n * A tool execution outcome: an `output` posted back as the tool result, or an\n * `errorText` posted as an `output-error` part (the model sees the failure and\n * can react — never a thrown exception into the stream).\n */\nexport type ChatToolOutcome = { ok: true; output: unknown } | { ok: false; errorText: string }\n\n/**\n * The per-conversation candidate store: every `searchDocuments` result is recorded\n * per relation target collection, every `listAssets` result into one flat library\n * pool (EC-381), and the terminal tools may only reference the ids gathered here\n * (the `applyContentWithShape` / `buildUpdateProposal` enum + drop/loud leash makes\n * a hallucinated relation OR asset id structurally unrepresentable / fail loud).\n * Held by the panel per conversation — a new conversation (EC-380 clear) starts an\n * empty store.\n */\nexport interface ChatCandidateStore {\n  record(collection: string, results: readonly DocumentSearchResult[]): void\n  /** Record every `listAssets` result into the flat library pool (EC-381). */\n  recordAssets(results: readonly AssetSearchResult[]): void\n  /** Candidates for a target collection's relation fields, keyed by field name. */\n  candidatesFor(collection: CollectionDef): RelationCandidates\n  /**\n   * Candidates for a target collection's asset/image fields (EC-381), keyed by\n   * field name — every asset field shares the one flat searched-asset pool\n   * (`listAssets` has no field dimension). Empty when nothing was searched, so the\n   * asset field is then omitted from the shape (empty beats wrong).\n   */\n  assetCandidatesFor(collection: CollectionDef): AssetCandidates\n}\n\nexport function createChatCandidateStore(): ChatCandidateStore {\n  const searched = new Map<string, Map<string, DocumentSearchResult>>()\n  const searchedAssets = new Map<string, AssetSearchResult>()\n  return {\n    record(collection, results) {\n      const byId = searched.get(collection) ?? new Map<string, DocumentSearchResult>()\n      for (const result of results) byId.set(result.id, result)\n      searched.set(collection, byId)\n    },\n    recordAssets(results) {\n      for (const result of results) searchedAssets.set(result.id, result)\n    },\n    candidatesFor(collection) {\n      const candidates: RelationCandidates = {}\n      for (const field of collection.fields) {\n        if (field.type !== 'relation') continue\n        const found = searched.get(field.target)\n        if (!found || found.size === 0) continue\n        candidates[field.name] = [...found.values()].map(\n          (r): RelationCandidate => ({ id: r.id, ...(r.title ? { label: r.title } : {}) }),\n        )\n      }\n      return candidates\n    },\n    assetCandidatesFor(collection) {\n      const candidates: AssetCandidates = {}\n      if (searchedAssets.size === 0) return candidates\n      const pool = [...searchedAssets.values()].map(\n        (a): AssetCandidate => ({ id: a.id, ...(a.title ? { label: a.title } : {}) }),\n      )\n      for (const field of collection.fields) {\n        if (field.type !== 'asset') continue\n        candidates[field.name] = pool\n      }\n      return candidates\n    },\n  }\n}\n\nexport interface ChatToolExecutorOptions {\n  /** The (route) provider the terminal engines proxy their model calls through. */\n  provider: AiProvider\n  registry: CollectionRegistry\n  /** The collections the assistant may target (unknown ids fail loud). */\n  collections: readonly CollectionDef[]\n  /** Operations-backed readers (client-side, user's session). */\n  readers: ChatToolReaders\n  /** Mint a fresh document id for a new draft (studio: the CMS store's minter). */\n  mintDocumentId: (collectionId: string) => string\n  /** Per-conversation relation-candidate store (see {@link createChatCandidateStore}). */\n  candidates: ChatCandidateStore\n  /**\n   * Full proposal sink, keyed by `toolCallId` — the review UI's entry point.\n   * The tool OUTPUT stays a compact summary; the patch never reaches the model.\n   */\n  onProposal: (toolCallId: string, proposal: ChatProposal) => void\n  /**\n   * The document currently open in the editor (EC-378 seam) — a thunk read at\n   * EXECUTION time, so \"this document\" resolves against what is open NOW.\n   * `getDocument` / `updateFields` fall back to it when the model omits the\n   * target (see {@link resolveDocumentTarget}).\n   */\n  currentDocument?: () => CurrentDocumentRef | null | undefined\n  /** Current knowledge snapshot (thunk — the body thunk refreshes it per request). */\n  knowledge?: () => ResolvedKnowledge | undefined\n  /** Component manifests — context for `allow`-leashed richText/blocks fields. */\n  components?: readonly ComponentManifest[]\n  /** Target locale for localized fields. */\n  locale?: string\n  /** Locale config — required for `translateDocument`. */\n  localeConfig?: LocaleConfig\n  /** Injected leashes / store for `applyContentWithShape`'s validation. */\n  validateRichTextEmbeds?: ValidateDocumentOptions['validateRichTextEmbeds']\n  validateComposition?: ValidateDocumentOptions['validateComposition']\n  store?: ValidateDocumentOptions['store']\n  /** Max repair attempts inside `applyContentWithShape`. */\n  maxRepairAttempts?: number\n  /** Per-search result cap (default {@link DEFAULT_SEARCH_LIMIT}). */\n  searchLimit?: number\n}\n\n/** The executor `useChat`'s `onToolCall` dispatches into. */\nexport interface ChatToolExecutor {\n  execute(call: ChatToolCall): Promise<ChatToolOutcome>\n}\n\nfunction issueSummary(issues: readonly CmsValidationIssue[]): string {\n  return issues\n    .slice(0, 5)\n    .map((issue) => issue.message)\n    .join('; ')\n}\n\n/**\n * The MODEL-facing view of a document (EC-379): rich-text field values are\n * projected to markdown strings — but ONLY when the engine's loss-guarded\n * inverse can express them faithfully (subset-only content, round-trip proven).\n * A document carrying embeds, internal `ref` links, or out-of-subset marks keeps\n * its `{ version, doc }` envelope, so nothing the model later echoes back can\n * silently lose structure. Applies to the `getDocument` TOOL OUTPUT only; the\n * proposal/apply paths always read the raw stored document.\n */\nexport function projectRichTextAsMarkdown(\n  document: CmsDocument,\n  collection: CollectionDef,\n): CmsDocument {\n  const richTextFields = collection.fields\n    .filter((field) => field.type === 'richText')\n    .map((field) => field.name)\n  if (richTextFields.length === 0) return document\n  const mapBucket = (bucket: FieldValues): FieldValues => {\n    let next = bucket\n    for (const name of richTextFields) {\n      const value = next[name]\n      if (value === undefined || value === null) continue\n      const parsed = parseRichTextValue(value)\n      if (!parsed.ok) continue\n      const markdown = richTextValueToMarkdownProse(parsed.value)\n      if (markdown === undefined) continue // not faithfully expressible → keep the envelope\n      if (next === bucket) next = { ...bucket }\n      next[name] = markdown\n    }\n    return next\n  }\n  const values = mapBucket(document.values)\n  const localized = document.localized\n    ? Object.fromEntries(\n        Object.entries(document.localized).map(([locale, bucket]) => [locale, mapBucket(bucket)]),\n      )\n    : undefined\n  return { ...document, values, ...(localized ? { localized } : {}) }\n}\n\n/**\n * Build the client executor map. Every entry validates its input against\n * {@link chatToolDefinitions}' zod schema (the route validates UIMessages only\n * structurally — deep input validation is the client's), executes with the\n * user's session, and returns a JSON-safe outcome. EC-378's `updateFields`\n * lands as one more case in this dispatch.\n */\nexport function createChatToolExecutor(options: ChatToolExecutorOptions): ChatToolExecutor {\n  const searchLimit = options.searchLimit ?? DEFAULT_SEARCH_LIMIT\n\n  function collectionById(id: string): CollectionDef | undefined {\n    return options.collections.find((c) => c.id === id)\n  }\n\n  async function searchDocuments(input: {\n    collection: string\n    query?: string\n    limit?: number\n  }): Promise<ChatToolOutcome> {\n    if (!collectionById(input.collection)) {\n      return { ok: false, errorText: `Unknown collection \"${input.collection}\" — use a collection id from the catalog.` }\n    }\n    const limit = Math.min(input.limit ?? searchLimit, searchLimit)\n    const results = (\n      await options.readers.searchDocuments({\n        collection: input.collection,\n        ...(input.query ? { query: input.query } : {}),\n        limit,\n      })\n    ).slice(0, limit)\n    options.candidates.record(input.collection, results)\n    return { ok: true, output: results }\n  }\n\n  async function listAssets(input: { query?: string; limit?: number }): Promise<ChatToolOutcome> {\n    const limit = Math.min(input.limit ?? searchLimit, searchLimit)\n    const results = (\n      await options.readers.listAssets({\n        ...(input.query ? { query: input.query } : {}),\n        limit,\n      })\n    ).slice(0, limit)\n    // EC-381 — leash asset fields to what the model actually searched, exactly as\n    // searchDocuments feeds the relation store.\n    options.candidates.recordAssets(results)\n    return { ok: true, output: results }\n  }\n\n  async function getDocument(input: {\n    collection?: string\n    id?: string\n  }): Promise<ChatToolOutcome> {\n    if (!options.readers.getDocument) {\n      return { ok: false, errorText: 'Reading documents is not available here.' }\n    }\n    const target = resolveDocumentTarget(input, options.currentDocument?.())\n    if (!target.ok) return { ok: false, errorText: target.errorText }\n    const document = await options.readers.getDocument(target.ref)\n    if (!document) {\n      return {\n        ok: false,\n        errorText: `Document \"${target.ref.collection}/${target.ref.id}\" was not found.`,\n      }\n    }\n    // EC-379: the model reads (and re-authors) rich text as markdown.\n    const collection = collectionById(target.ref.collection)\n    return { ok: true, output: collection ? projectRichTextAsMarkdown(document, collection) : document }\n  }\n\n  /** EC-378 — the edit-flow terminal tool: current doc + model-authored changes → validated proposal. */\n  async function updateFields(\n    toolCallId: string,\n    input: { collection?: string; id?: string; changes: UpdateFieldChange[] },\n  ): Promise<ChatToolOutcome> {\n    if (!options.readers.getDocument) {\n      return { ok: false, errorText: 'Reading documents is not available here.' }\n    }\n    const target = resolveDocumentTarget(input, options.currentDocument?.())\n    if (!target.ok) return { ok: false, errorText: target.errorText }\n    const collection = collectionById(target.ref.collection)\n    if (!collection) {\n      return {\n        ok: false,\n        errorText: `Unknown collection \"${target.ref.collection}\" — use a collection id from the catalog.`,\n      }\n    }\n    const document = await options.readers.getDocument(target.ref)\n    if (!document) {\n      return {\n        ok: false,\n        errorText: `Document \"${target.ref.collection}/${target.ref.id}\" was not found.`,\n      }\n    }\n    const result = buildUpdateProposal({\n      registry: options.registry,\n      collection,\n      document,\n      changes: input.changes,\n      candidates: options.candidates.candidatesFor(collection),\n      assetCandidates: options.candidates.assetCandidatesFor(collection),\n      ...(options.locale ? { locale: options.locale } : {}),\n      ...(options.localeConfig ? { localeConfig: options.localeConfig } : {}),\n      ...(options.validateRichTextEmbeds\n        ? { validateRichTextEmbeds: options.validateRichTextEmbeds }\n        : {}),\n      ...(options.validateComposition ? { validateComposition: options.validateComposition } : {}),\n      ...(options.store ? { store: options.store } : {}),\n    })\n    if (!result.ok) {\n      return {\n        ok: false,\n        errorText: `The proposed changes did not pass validation: ${issueSummary(result.issues)}`,\n      }\n    }\n    if (result.kind === 'no-change') {\n      return {\n        ok: true,\n        output: {\n          status: 'no-change',\n          note: 'The requested change matches the current values — there is nothing to update.',\n        },\n      }\n    }\n    options.onProposal(toolCallId, {\n      origin: 'update',\n      collection: collection.id,\n      documentId: document.id,\n      patch: result.patch,\n      provenance: aiProvenance(options.provider),\n      attempts: 1,\n      issues: result.issues,\n      before: result.before,\n    })\n    // Compact summary only — the full patch goes to the review UI, not the model.\n    const titleValues = {\n      ...result.patch.values,\n      ...(options.locale ? result.patch.localized?.[options.locale] : {}),\n    }\n    return {\n      ok: true,\n      output: {\n        status: 'proposed',\n        collection: collection.id,\n        documentId: document.id,\n        title: resolveDocumentTitle(collection, titleValues, document.id),\n        changedFields: result.changedFields,\n        note: 'Update proposal created; the editor reviews and applies it in the studio. Summarize the change briefly — do not repeat the content.',\n      },\n    }\n  }\n\n  async function createDocument(\n    toolCallId: string,\n    input: { collection: string; instruction: string },\n  ): Promise<ChatToolOutcome> {\n    const collection = collectionById(input.collection)\n    if (!collection) {\n      return { ok: false, errorText: `Unknown collection \"${input.collection}\" — use a collection id from the catalog.` }\n    }\n    const documentId = options.mintDocumentId(collection.id)\n    const knowledge = options.knowledge?.()\n    const result = await applyContentWithShape({\n      provider: options.provider,\n      registry: options.registry,\n      collection,\n      documentId,\n      instruction: input.instruction,\n      ...(knowledge ? { knowledge } : {}),\n      ...(options.components ? { components: options.components } : {}),\n      candidates: options.candidates.candidatesFor(collection),\n      // EC-381 — asset/image fields are leashed to searched library assets.\n      assetCandidates: options.candidates.assetCandidatesFor(collection),\n      ...(options.locale ? { locale: options.locale } : {}),\n      ...(options.validateRichTextEmbeds\n        ? { validateRichTextEmbeds: options.validateRichTextEmbeds }\n        : {}),\n      ...(options.validateComposition ? { validateComposition: options.validateComposition } : {}),\n      ...(options.store ? { store: options.store } : {}),\n      ...(options.maxRepairAttempts !== undefined\n        ? { maxRepairAttempts: options.maxRepairAttempts }\n        : {}),\n    })\n    if (!result.ok) {\n      return {\n        ok: false,\n        errorText: `The drafted ${collection.id} did not pass validation: ${issueSummary(result.issues)}`,\n      }\n    }\n    options.onProposal(toolCallId, {\n      origin: 'create',\n      collection: collection.id,\n      documentId,\n      patch: result.patch,\n      provenance: result.provenance,\n      attempts: result.attempts,\n      issues: result.issues,\n    })\n    // Compact summary only — the full patch goes to the review UI, not the model.\n    return {\n      ok: true,\n      output: {\n        status: 'proposed',\n        collection: collection.id,\n        documentId,\n        title: resolveDocumentTitle(collection, result.patch.values, documentId),\n        note: 'Draft proposal created; the editor reviews and applies it in the studio. Summarize briefly — do not repeat the content.',\n      },\n    }\n  }\n\n  async function translate(\n    toolCallId: string,\n    input: { collection: string; id: string; locale?: string },\n  ): Promise<ChatToolOutcome> {\n    const collection = collectionById(input.collection)\n    if (!collection) {\n      return { ok: false, errorText: `Unknown collection \"${input.collection}\" — use a collection id from the catalog.` }\n    }\n    if (!options.readers.getDocument || !options.localeConfig) {\n      return { ok: false, errorText: 'Translation is not available here.' }\n    }\n    const document = await options.readers.getDocument({\n      collection: input.collection,\n      id: input.id,\n    })\n    if (!document) {\n      return { ok: false, errorText: `Document \"${input.collection}/${input.id}\" was not found.` }\n    }\n    const knowledge = options.knowledge?.()\n    const result = await translateDocument({\n      provider: options.provider,\n      collection,\n      document,\n      localeConfig: options.localeConfig,\n      ...(input.locale ? { targetLocales: [input.locale] } : {}),\n      ...(knowledge ? { knowledge } : {}),\n    })\n    if (result.total === 0) {\n      return {\n        ok: true,\n        output: {\n          status: 'nothing-to-translate',\n          note: 'Every locale value is already filled — there is nothing to translate.',\n        },\n      }\n    }\n    if (result.translated === 0) {\n      return { ok: false, errorText: 'The translation did not produce any content.' }\n    }\n    options.onProposal(toolCallId, {\n      origin: 'translate',\n      collection: collection.id,\n      documentId: document.id,\n      patch: {\n        collection: collection.id,\n        id: document.id,\n        values: result.document.values,\n        ...(result.document.localized ? { localized: result.document.localized } : {}),\n      },\n      provenance: result.provenance,\n      attempts: 1,\n      issues: [],\n      before: {\n        values: document.values,\n        ...(document.localized ? { localized: document.localized } : {}),\n      },\n    })\n    return {\n      ok: true,\n      output: {\n        status: 'proposed',\n        collection: collection.id,\n        documentId: document.id,\n        translatedUnits: result.translated,\n        note: 'Translation proposal created; the editor reviews and applies it in the studio.',\n      },\n    }\n  }\n\n  return {\n    async execute(call: ChatToolCall): Promise<ChatToolOutcome> {\n      const definition = (chatToolDefinitions as Record<string, ChatToolDefinition>)[call.toolName]\n      if (!definition) {\n        return { ok: false, errorText: `Unknown tool \"${call.toolName}\".` }\n      }\n      const parsed = definition.inputSchema.safeParse(call.input)\n      if (!parsed.success) {\n        return { ok: false, errorText: `Invalid ${call.toolName} input: ${parsed.error.message}` }\n      }\n      try {\n        switch (call.toolName) {\n          case 'searchDocuments':\n            return await searchDocuments(parsed.data as { collection: string; query?: string; limit?: number })\n          case 'listAssets':\n            return await listAssets(parsed.data as { query?: string; limit?: number })\n          case 'getDocument':\n            return await getDocument(parsed.data as { collection?: string; id?: string })\n          case 'createDocument':\n            return await createDocument(\n              call.toolCallId,\n              parsed.data as { collection: string; instruction: string },\n            )\n          case 'updateFields':\n            return await updateFields(\n              call.toolCallId,\n              parsed.data as { collection?: string; id?: string; changes: UpdateFieldChange[] },\n            )\n          case 'translateDocument':\n            return await translate(\n              call.toolCallId,\n              parsed.data as { collection: string; id: string; locale?: string },\n            )\n          default:\n            return { ok: false, errorText: `Unknown tool \"${call.toolName}\".` }\n        }\n      } catch (error) {\n        return {\n          ok: false,\n          errorText: `The ${call.toolName} step failed: ${error instanceof Error ? error.message : 'unknown error'}`,\n        }\n      }\n    },\n  }\n}\n"]}

package/dist/lib/ai/types.d.ts

@@ -136,6 +136,20 @@ export interface RelationCandidate {
 }
 /** Relation candidate ids keyed by field name. A field absent here is omitted from the shape. */
 export type RelationCandidates = Record<string, RelationCandidate[]>;
+/**
+ * An asset candidate id (from a `listAssets` tool result). Asset/image fields may
+ * ONLY use ids present here — the target shape emits them as an enum, so a
+ * hallucinated (or invented / "to-be-uploaded") asset id is not even representable
+ * as valid structured output. From the EXISTING media library ONLY (EC-381): the
+ * assistant never generates or uploads an asset; empty beats wrong.
+ */
+export interface AssetCandidate {
+    id: string;
+    /** Human label (title / filename) for the model to choose against. */
+    label?: string;
+}
+/** Asset candidate ids keyed by field name. A field absent here is omitted from the shape. */
+export type AssetCandidates = Record<string, AssetCandidate[]>;
 /** The typed draft-values patch the engine emits — applied by the draft-write path. */
 export interface ContentPatch {
     collection: string;
@@ -169,6 +183,12 @@ export interface ApplyContentInput {
     components?: readonly ComponentManifest[];
     /** Relation candidate ids by field — the ONLY ids a relation field may use. */
     candidates?: RelationCandidates;
+    /**
+     * Asset candidate ids by field — the ONLY ids an asset/image field may use
+     * (EC-381). Emitted as an enum; an asset field with none is omitted from the
+     * shape (so a create proposal simply leaves it empty — empty beats wrong).
+     */
+    assetCandidates?: AssetCandidates;
     /** Existing draft values (updates): the model output merges over these before validation. */
     existing?: FieldValues;
     /** Target locale for localized fields (their values land under `localized[locale]`). */