@elytracms/studio 0.0.101 → 0.0.102

package/dist/lib/ai/tools.js

@@ -32,13 +32,13 @@
  * with the hand-rolled orchestrator (EC-334 slice 2).
  */
 import { z } from 'zod';
-import { isSingleton, resolveDocumentTitle } from '@elytracms/core/cms-core';
+import { isSingleton } from '@elytracms/core/cms-core';
 import { applyContentWithShape } from './apply-content.js';
-import { describeComponentProps, lockedPositionsOf } from './chat-context.js';
+import { describeComponentProps, readOnlyPositionsOf } from './chat-context.js';
 import { assetCandidatesOf, relationCandidatesOf } from './leash.js';
 import { translateDocument } from './translate-document.js';
 import { buildUpdateProposal } from './update-fields.js';
-import { componentIdsOf, toWriterDocument } from './writer-form.js';
+import { componentIdsOf, modelFacingTitle, toWriterDocument } from './writer-form.js';
 import { aiProvenance } from './provenance.js';
 /** Per-search result cap (protects the wire — results become model context). */
 export const DEFAULT_SEARCH_LIMIT = 20;
@@ -83,7 +83,9 @@ export const chatToolDefinitions = {
             'at any depth — are returned as markdown strings where faithfully expressible. ' +
             '`components` lists, for every component on the document, the props you may change ' +
             'with updateFields and the rules each value must satisfy. `readOnly` lists the ' +
-            'positions you can read but never change.',
+            'positions you can read but never change. Content the project withholds from the ' +
+            'assistant is left out of the read; a change that would clear or remove it — or any ' +
+            'read-only content — is refused.',
         inputSchema: z.object({
             collection: z
                 .string()
@@ -231,7 +233,9 @@ export function describeTranslateSkip(skip) {
         ? 'the stored value is not readable as its type'
         : skip.reason === 'not-returned'
             ? 'the provider returned no text'
-            : 'the translation did not keep its formatting, links or embeds, so the original was kept';
+            : skip.reason === 'locked'
+                ? 'it holds content no studio writer may change, shaped differently from the source, so it was left as it is'
+                : 'the translation did not keep its formatting, links or embeds, so the original was kept';
     return `${where}${component} (${skip.locale}): ${why}`;
 }
 /**
@@ -268,20 +272,25 @@ function issueSummary(issues) {
  * read off the same declarations the validator judges (`lookupManifest`). Applies to
  * the TOOL OUTPUT only; the proposal/apply paths always read the raw stored document.
  *
- * `readOnly` (EC-716) lists every writer-locked position the collection declares
+ * `readOnly` (EC-716) lists every READ-ONLY position the collection declares
  * (`views`, `meta.locked`): the values stay in the output — the read context keeps them —
  * and the list says they are read, never written.
+ *
+ * EC-741: the read is THE model-read projection ({@link toWriterDocument}): an
+ * `ai.exclude` position and everything below it is absent at every depth — a field, a
+ * sub-field, a repeater item's sub-field, a component prop in a composition, a slot or
+ * typography content — and is neither listed in `readOnly` nor counted for `components`
+ * (the prop catalog is read off the projected document). It used to be the whole document
+ * with the excluded positions listed as `readOnly`.
  */
 export function modelFacingDocument(document, collection, validateOptions = {}) {
     const lookupManifest = validateOptions.lookupManifest;
-    const locked = lockedPositionsOf(collection.fields);
-    const read = {
-        ...toWriterDocument(collection, document, lookupManifest ? { lookupManifest } : {}),
-        ...(locked.length > 0 ? { readOnly: locked } : {}),
-    };
+    const readOnly = readOnlyPositionsOf(collection.fields);
+    const projected = toWriterDocument(collection, document, lookupManifest ? { lookupManifest } : {});
+    const read = { ...projected, ...(readOnly.length > 0 ? { readOnly } : {}) };
     if (!lookupManifest)
         return read;
-    const ids = componentIdsOf(collection, document, lookupManifest);
+    const ids = componentIdsOf(collection, projected, lookupManifest);
     if (ids.length === 0)
         return read;
     return {
@@ -353,8 +362,16 @@ export function createChatToolExecutor(options) {
             };
         }
         // EC-379/EC-593: the model reads (and re-authors) every value in its writer form.
+        // EC-741: through the model-read projection — a document of a collection outside the
+        // catalog is an error, never the raw document (nothing would project it).
         const collection = collectionById(target.ref.collection);
-        return { ok: true, output: collection ? modelFacingDocument(document, collection, validateOptions) : document };
+        if (!collection) {
+            return {
+                ok: false,
+                errorText: `Unknown collection "${target.ref.collection}" — use a collection id from the catalog.`,
+            };
+        }
+        return { ok: true, output: modelFacingDocument(document, collection, validateOptions) };
     }
     /** EC-378 — the edit-flow terminal tool: current doc + model-authored changes → validated proposal. */
     async function updateFields(toolCallId, input) {
@@ -427,7 +444,8 @@ export function createChatToolExecutor(options) {
                 status: 'proposed',
                 collection: collection.id,
                 documentId: document.id,
-                title: resolveDocumentTitle(collection, titleValues, document.id),
+                // EC-741: the title from the projected values (an excluded field is never one).
+                title: modelFacingTitle(collection, titleValues, document.id, validateOptions),
                 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.',
             },
@@ -498,7 +516,7 @@ export function createChatToolExecutor(options) {
                 status: 'proposed',
                 collection: collection.id,
                 documentId,
-                title: resolveDocumentTitle(collection, titleValues, documentId),
+                title: modelFacingTitle(collection, titleValues, documentId, validateOptions),
                 ...(unfilled.length > 0 ? { unfilled } : {}),
                 note: unfilled.length > 0
                     ? 'Draft proposal created; the editor reviews and applies it in the studio. Summarize briefly — do not repeat the content — and tell the user which fields were left empty (unfilled).'

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 *     `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 { isSingleton, 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 { applyContentWithShape } from './apply-content'\nimport { describeComponentProps, lockedPositionsOf } from './chat-context'\nimport { assetCandidatesOf, relationCandidatesOf } from './leash'\nimport type { SearchedAsset, SearchedDocument } from './leash'\nimport { translateDocument } from './translate-document'\nimport type { TranslateSkip } from './translate-document'\nimport { buildUpdateProposal } from './update-fields'\nimport type { UpdateFieldChange } from './update-fields'\nimport { componentIdsOf, toWriterDocument } from './writer-form'\nimport { aiProvenance } from './provenance'\nimport type { ChatProposal } from './chat-state'\nimport type { AiProvider, ResolvedKnowledge, UnfilledPosition, WriterLeash } from './types'\n\n/** A document the model may reference as a relation target (from a `searchDocuments` read). */\nexport type DocumentSearchResult = SearchedDocument\n\n/**\n * An asset the model may reference (from a `listAssets` read). EC-588: it carries the\n * two facts a field's `accept` is judged on, so each asset position's candidates can be\n * filtered to what that position takes — and the model can see what each asset is.\n */\nexport type AssetSearchResult = SearchedAsset\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   * EC-647 — the revision a document {@link getDocument} returned was read at (the\n   * returned value is the token). An update or a translation records it on its proposal:\n   * applying the proposal writes AT that revision, so a change made since on one of its\n   * positions is refused, never overwritten. Optional: absent, a proposal names no\n   * revision and its apply is refused.\n   */\n  revisionOf?(document: CmsDocument): number | undefined\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, contentType, filename } summaries; an asset ' +\n      'field only takes the kinds it accepts.',\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 + component ids) by collection and ' +\n      'id. Omit both to read the document currently open in the editor. Rich-text values — ' +\n      'at any depth — are returned as markdown strings where faithfully expressible. ' +\n      '`components` lists, for every component on the document, the props you may change ' +\n      'with updateFields and the rules each value must satisfy. `readOnly` lists the ' +\n      'positions you can read but never change.',\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 component ids), then pass ONLY the fields that change. A component ' +\n      'prop (e.g. a Hero headline) — at any depth: a top-level block, a child inside a ' +\n      'section, a component embedded in rich text — is addressed as field + blockId + ' +\n      'prop. Components are never added, moved or removed by the assistant (that is done ' +\n      'on the canvas). Omit collection and id to target the document currently open in ' +\n      'the editor. A rich-text value takes the FULL new value as a MARKDOWN string ' +\n      '(headings, lists, links, bold/italic, 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\n              .string()\n              .describe(\n                'Field name from the collection schema. The catalog in the system context ' +\n                  'lists every field with its type and the rules its value must satisfy.',\n              ),\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(\n                'To change a component prop: the component id (from getDocument) — any depth.',\n              ),\n            prop: z\n              .string()\n              .optional()\n              .describe('With blockId: the component prop to change (from getDocument `components`).'),\n            value: z\n              .unknown()\n              .optional()\n              .describe(\n                'The new value (a rich-text field takes a markdown string). null clears the ' +\n                  \"field/prop. It MUST satisfy that field's rules as listed in the catalog \" +\n                  '(length bounds, format, allowed values, date range…); the studio validates ' +\n                  'the merged document and rejects the proposal with the failing rules if it ' +\n                  'does not. Where the catalog says further rules apply, keep the value ' +\n                  'conventional and plausible.',\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 collection, every `listAssets` result into one flat library pool (EC-381), and\n * the terminal tools may only reference the ids gathered here. The store IS the\n * {@link WriterLeash} the engines ask per position (EC-593): a relation by its target\n * collection, an asset by its declaration's `accept` (EC-588) — so a nested relation, a\n * component's asset prop and a top-level field are leashed by the same two questions\n * (the create enum + drop, the update loud refusal). Held by the panel per\n * conversation — a new conversation (EC-380 clear) starts an empty store.\n */\nexport interface ChatCandidateStore extends WriterLeash {\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}\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    relationCandidates(target) {\n      return relationCandidatesOf(searched.get(target)?.values() ?? [])\n    },\n    // EC-588 (A4): a position's enum is the pool filtered by ITS `accept` — an image\n    // field is never offered a PDF. The validator re-run at apply is the guarantee\n    // (`findAsset` checks the record); this keeps the model from spending its repair\n    // budget on a mismatch the leash can rule out up front.\n    assetCandidates(field) {\n      return assetCandidatesOf(field, searchedAssets.values())\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  /** Target locale for localized fields. */\n  locale?: string\n  /** Locale config — required for `translateDocument`. */\n  localeConfig?: LocaleConfig\n  /**\n   * THE validation option bag (EC-497) — the CMS session's\n   * `gateValidateOptions(...)`, forwarded whole to every engine below. EC-473\n   * made the assistant's gate the editor's gate; passing one bag instead of five\n   * keys makes it stay that way, because a key can no longer be dropped by being\n   * forgotten at one of the three call sites this replaced. Its `lookupManifest` is\n   * also how the writer-form converter and the read form reach component props\n   * (EC-593) — the props the validator judges, no second component source.\n   */\n  validateOptions?: ValidateDocumentOptions\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\n/** A translate skip as one model-facing phrase: `menu[1].label (de): the provider returned no text`. */\nexport function describeTranslateSkip(skip: TranslateSkip): string {\n  const where = skip.at.reduce<string>(\n    (out, key) => (typeof key === 'number' ? `${out}[${key}]` : `${out}.${key}`),\n    skip.field,\n  )\n  const component = skip.component ? ` in ${skip.component.componentId} \"${skip.component.nodeId}\"` : ''\n  const why =\n    skip.reason === 'unreadable'\n      ? 'the stored value is not readable as its type'\n      : skip.reason === 'not-returned'\n        ? 'the provider returned no text'\n        : 'the translation did not keep its formatting, links or embeds, so the original was kept'\n  return `${where}${component} (${skip.locale}): ${why}`\n}\n\n/**\n * An unfilled position as one model-facing phrase (EC-715): `cover (no searched library\n * asset fits it)`, `card.image (an id outside the search results was dropped)`.\n */\nexport function describeUnfilled(position: UnfilledPosition): string {\n  const where = position.at.reduce<string>(\n    (out, key) => (typeof key === 'number' ? `${out}[${key}]` : `${out}.${key}`),\n    position.field,\n  )\n  const why =\n    position.reason === 'dropped'\n      ? 'an id outside the search results was dropped'\n      : position.reason === 'no-candidates'\n        ? 'nothing searched fits it'\n        : 'left empty'\n  return `${where} (${why})`\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 `getDocument` output (EC-379 → EC-593): the document in the form the model reads\n * — the ONE converter's read side (`toWriterDocument`), so rich text is a markdown\n * string at EVERY depth where the engine's loss-guarded inverse can express it\n * faithfully (a top-level field, an object sub-field, a repeater item, a component's\n * rich-text prop), and keeps its stored `{ version: 2, content }` value otherwise (embeds,\n * internal `ref` links, out-of-subset marks), so nothing the model later echoes back can\n * silently lose structure. It used to project TOP-LEVEL rich text only (SHAPES #29: a\n * nested value read as v2 while every writer was told markdown).\n *\n * `components` is the catalog's prop half (RULES F3d): for every component on the\n * document, the props `updateFields` may change and the rules each value must satisfy,\n * read off the same declarations the validator judges (`lookupManifest`). Applies to\n * the TOOL OUTPUT only; the proposal/apply paths always read the raw stored document.\n *\n * `readOnly` (EC-716) lists every writer-locked position the collection declares\n * (`views`, `meta.locked`): the values stay in the output — the read context keeps them —\n * and the list says they are read, never written.\n */\nexport function modelFacingDocument(\n  document: CmsDocument,\n  collection: CollectionDef,\n  validateOptions: ValidateDocumentOptions = {},\n): CmsDocument & { components?: Record<string, string[]>; readOnly?: string[] } {\n  const lookupManifest = validateOptions.lookupManifest\n  const locked = lockedPositionsOf(collection.fields)\n  const read = {\n    ...toWriterDocument(collection, document, lookupManifest ? { lookupManifest } : {}),\n    ...(locked.length > 0 ? { readOnly: locked } : {}),\n  }\n  if (!lookupManifest) return read\n  const ids = componentIdsOf(collection, document, lookupManifest)\n  if (ids.length === 0) return read\n  return {\n    ...read,\n    components: Object.fromEntries(ids.map((id) => [id, describeComponentProps(lookupManifest(id) ?? {})])),\n  }\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  /**\n   * EC-497 — the ONE bag every engine below is handed, assembled in exactly one\n   * place instead of at each of the three former call sites.\n   *\n   * The executor's own `localeConfig` is a FLOOR, never an override: the session's\n   * bag wins wherever it speaks, but a bag that omits the project's locales must\n   * not be able to make the gate locale-blind — a localized bound would then go\n   * unchecked, which is precisely the class of hole this task closed.\n   */\n  const validateOptions: ValidateDocumentOptions = {\n    ...(options.localeConfig ? { localeConfig: options.localeConfig } : {}),\n    ...(options.validateOptions ?? {}),\n  }\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/EC-593: the model reads (and re-authors) every value in its writer form.\n    const collection = collectionById(target.ref.collection)\n    return { ok: true, output: collection ? modelFacingDocument(document, collection, validateOptions) : 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      // EC-381 → EC-593: the store IS the leash, asked per position.\n      leash: options.candidates,\n      ...(options.locale ? { locale: options.locale } : {}),\n      validateOptions,\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    const revision = options.readers.revisionOf?.(document)\n    options.onProposal(toolCallId, {\n      origin: 'update',\n      collection: collection.id,\n      documentId: document.id,\n      patch: result.patch,\n      patches: result.patches,\n      ...(revision !== undefined ? { revision } : {}),\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    // EC-715: a singleton has its one document; the media library holds uploads. Neither\n    // takes a create — refused here, not proposed for the editor to discover on apply.\n    if (isSingleton(collection)) {\n      return {\n        ok: false,\n        errorText: `\"${collection.id}\" is a singleton — it has exactly one document, which is changed with updateFields, never created.`,\n      }\n    }\n    if (collection.kind === 'asset') {\n      return {\n        ok: false,\n        errorText: `\"${collection.id}\" is the media library — assets are uploaded by people, never created by the assistant.`,\n      }\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      // EC-381 → EC-593: relation and asset positions — at every depth — are leashed\n      // to what was searched (the store IS the leash).\n      leash: options.candidates,\n      ...(options.locale ? { locale: options.locale } : {}),\n      validateOptions,\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      ...(result.unfilled.length > 0 ? { unfilled: result.unfilled } : {}),\n    })\n    // Compact summary only — the full patch goes to the review UI, not the model.\n    const unfilled = result.unfilled.map(describeUnfilled)\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,\n        title: resolveDocumentTitle(collection, titleValues, documentId),\n        ...(unfilled.length > 0 ? { unfilled } : {}),\n        note:\n          unfilled.length > 0\n            ? 'Draft proposal created; the editor reviews and applies it in the studio. Summarize briefly — do not repeat the content — and tell the user which fields were left empty (unfilled).'\n            : '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      // EC-497: the engine gates its own output; both callers hand it the session\n      // registry + THE bag so its verdict is the editor's verdict.\n      registry: options.registry,\n      validateOptions,\n    })\n    // EC-593 (ratified 4e): what could not be translated is REPORTED — to the model\n    // (it tells the user) and on the proposal the editor reviews — never skipped silently.\n    const skipped = result.skipped.map(describeTranslateSkip)\n    if (result.total === 0 && skipped.length === 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 {\n        ok: false,\n        errorText:\n          skipped.length > 0\n            ? `The translation did not produce any content. Not translated: ${skipped.slice(0, 5).join('; ')}`\n            : 'The translation did not produce any content.',\n      }\n    }\n    // EC-473 established that a translated draft is validated before it is proposed\n    // (this path once proposed unvalidated content). EC-497 moved the gate INTO the\n    // engine so the detail-editor's header action — the other caller — inherits it\n    // instead of writing model output straight to the document. Only errors the\n    // translation INTRODUCED block it; pre-existing brokenness is not the\n    // assistant's doing.\n    if (result.introducedErrors.length > 0) {\n      return {\n        ok: false,\n        errorText: `The translation did not pass validation: ${issueSummary(result.introducedErrors)}`,\n      }\n    }\n    const revision = options.readers.revisionOf?.(document)\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      patches: result.patches,\n      ...(revision !== undefined ? { revision } : {}),\n      provenance: result.provenance,\n      attempts: 1,\n      // Warnings ride onto the proposal like every other path's (EC-496 renders them).\n      issues: [...result.issues],\n      ...(result.skipped.length > 0 ? { skipped: [...result.skipped] } : {}),\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        ...(skipped.length > 0 ? { notTranslated: skipped } : {}),\n        note:\n          skipped.length > 0\n            ? 'Translation proposal created; the editor reviews and applies it in the studio. Tell the user which positions were NOT translated (notTranslated).'\n            : '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"]}
+{"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 { isSingleton } 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 { applyContentWithShape } from './apply-content'\nimport { describeComponentProps, readOnlyPositionsOf } from './chat-context'\nimport { assetCandidatesOf, relationCandidatesOf } from './leash'\nimport type { SearchedAsset, SearchedDocument } from './leash'\nimport { translateDocument } from './translate-document'\nimport type { TranslateSkip } from './translate-document'\nimport { buildUpdateProposal } from './update-fields'\nimport type { UpdateFieldChange } from './update-fields'\nimport { componentIdsOf, modelFacingTitle, toWriterDocument } from './writer-form'\nimport { aiProvenance } from './provenance'\nimport type { ChatProposal } from './chat-state'\nimport type { AiProvider, ResolvedKnowledge, UnfilledPosition, WriterLeash } from './types'\n\n/** A document the model may reference as a relation target (from a `searchDocuments` read). */\nexport type DocumentSearchResult = SearchedDocument\n\n/**\n * An asset the model may reference (from a `listAssets` read). EC-588: it carries the\n * two facts a field's `accept` is judged on, so each asset position's candidates can be\n * filtered to what that position takes — and the model can see what each asset is.\n */\nexport type AssetSearchResult = SearchedAsset\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   * EC-647 — the revision a document {@link getDocument} returned was read at (the\n   * returned value is the token). An update or a translation records it on its proposal:\n   * applying the proposal writes AT that revision, so a change made since on one of its\n   * positions is refused, never overwritten. Optional: absent, a proposal names no\n   * revision and its apply is refused.\n   */\n  revisionOf?(document: CmsDocument): number | undefined\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, contentType, filename } summaries; an asset ' +\n      'field only takes the kinds it accepts.',\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 + component ids) by collection and ' +\n      'id. Omit both to read the document currently open in the editor. Rich-text values — ' +\n      'at any depth — are returned as markdown strings where faithfully expressible. ' +\n      '`components` lists, for every component on the document, the props you may change ' +\n      'with updateFields and the rules each value must satisfy. `readOnly` lists the ' +\n      'positions you can read but never change. Content the project withholds from the ' +\n      'assistant is left out of the read; a change that would clear or remove it — or any ' +\n      'read-only content — is refused.',\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 component ids), then pass ONLY the fields that change. A component ' +\n      'prop (e.g. a Hero headline) — at any depth: a top-level block, a child inside a ' +\n      'section, a component embedded in rich text — is addressed as field + blockId + ' +\n      'prop. Components are never added, moved or removed by the assistant (that is done ' +\n      'on the canvas). Omit collection and id to target the document currently open in ' +\n      'the editor. A rich-text value takes the FULL new value as a MARKDOWN string ' +\n      '(headings, lists, links, bold/italic, 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\n              .string()\n              .describe(\n                'Field name from the collection schema. The catalog in the system context ' +\n                  'lists every field with its type and the rules its value must satisfy.',\n              ),\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(\n                'To change a component prop: the component id (from getDocument) — any depth.',\n              ),\n            prop: z\n              .string()\n              .optional()\n              .describe('With blockId: the component prop to change (from getDocument `components`).'),\n            value: z\n              .unknown()\n              .optional()\n              .describe(\n                'The new value (a rich-text field takes a markdown string). null clears the ' +\n                  \"field/prop. It MUST satisfy that field's rules as listed in the catalog \" +\n                  '(length bounds, format, allowed values, date range…); the studio validates ' +\n                  'the merged document and rejects the proposal with the failing rules if it ' +\n                  'does not. Where the catalog says further rules apply, keep the value ' +\n                  'conventional and plausible.',\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 collection, every `listAssets` result into one flat library pool (EC-381), and\n * the terminal tools may only reference the ids gathered here. The store IS the\n * {@link WriterLeash} the engines ask per position (EC-593): a relation by its target\n * collection, an asset by its declaration's `accept` (EC-588) — so a nested relation, a\n * component's asset prop and a top-level field are leashed by the same two questions\n * (the create enum + drop, the update loud refusal). Held by the panel per\n * conversation — a new conversation (EC-380 clear) starts an empty store.\n */\nexport interface ChatCandidateStore extends WriterLeash {\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}\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    relationCandidates(target) {\n      return relationCandidatesOf(searched.get(target)?.values() ?? [])\n    },\n    // EC-588 (A4): a position's enum is the pool filtered by ITS `accept` — an image\n    // field is never offered a PDF. The validator re-run at apply is the guarantee\n    // (`findAsset` checks the record); this keeps the model from spending its repair\n    // budget on a mismatch the leash can rule out up front.\n    assetCandidates(field) {\n      return assetCandidatesOf(field, searchedAssets.values())\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  /** Target locale for localized fields. */\n  locale?: string\n  /** Locale config — required for `translateDocument`. */\n  localeConfig?: LocaleConfig\n  /**\n   * THE validation option bag (EC-497) — the CMS session's\n   * `gateValidateOptions(...)`, forwarded whole to every engine below. EC-473\n   * made the assistant's gate the editor's gate; passing one bag instead of five\n   * keys makes it stay that way, because a key can no longer be dropped by being\n   * forgotten at one of the three call sites this replaced. Its `lookupManifest` is\n   * also how the writer-form converter and the read form reach component props\n   * (EC-593) — the props the validator judges, no second component source.\n   */\n  validateOptions?: ValidateDocumentOptions\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\n/** A translate skip as one model-facing phrase: `menu[1].label (de): the provider returned no text`. */\nexport function describeTranslateSkip(skip: TranslateSkip): string {\n  const where = skip.at.reduce<string>(\n    (out, key) => (typeof key === 'number' ? `${out}[${key}]` : `${out}.${key}`),\n    skip.field,\n  )\n  const component = skip.component ? ` in ${skip.component.componentId} \"${skip.component.nodeId}\"` : ''\n  const why =\n    skip.reason === 'unreadable'\n      ? 'the stored value is not readable as its type'\n      : skip.reason === 'not-returned'\n        ? 'the provider returned no text'\n        : skip.reason === 'locked'\n          ? 'it holds content no studio writer may change, shaped differently from the source, so it was left as it is'\n          : 'the translation did not keep its formatting, links or embeds, so the original was kept'\n  return `${where}${component} (${skip.locale}): ${why}`\n}\n\n/**\n * An unfilled position as one model-facing phrase (EC-715): `cover (no searched library\n * asset fits it)`, `card.image (an id outside the search results was dropped)`.\n */\nexport function describeUnfilled(position: UnfilledPosition): string {\n  const where = position.at.reduce<string>(\n    (out, key) => (typeof key === 'number' ? `${out}[${key}]` : `${out}.${key}`),\n    position.field,\n  )\n  const why =\n    position.reason === 'dropped'\n      ? 'an id outside the search results was dropped'\n      : position.reason === 'no-candidates'\n        ? 'nothing searched fits it'\n        : 'left empty'\n  return `${where} (${why})`\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 `getDocument` output (EC-379 → EC-593): the document in the form the model reads\n * — the ONE converter's read side (`toWriterDocument`), so rich text is a markdown\n * string at EVERY depth where the engine's loss-guarded inverse can express it\n * faithfully (a top-level field, an object sub-field, a repeater item, a component's\n * rich-text prop), and keeps its stored `{ version: 2, content }` value otherwise (embeds,\n * internal `ref` links, out-of-subset marks), so nothing the model later echoes back can\n * silently lose structure. It used to project TOP-LEVEL rich text only (SHAPES #29: a\n * nested value read as v2 while every writer was told markdown).\n *\n * `components` is the catalog's prop half (RULES F3d): for every component on the\n * document, the props `updateFields` may change and the rules each value must satisfy,\n * read off the same declarations the validator judges (`lookupManifest`). Applies to\n * the TOOL OUTPUT only; the proposal/apply paths always read the raw stored document.\n *\n * `readOnly` (EC-716) lists every READ-ONLY position the collection declares\n * (`views`, `meta.locked`): the values stay in the output — the read context keeps them —\n * and the list says they are read, never written.\n *\n * EC-741: the read is THE model-read projection ({@link toWriterDocument}): an\n * `ai.exclude` position and everything below it is absent at every depth — a field, a\n * sub-field, a repeater item's sub-field, a component prop in a composition, a slot or\n * typography content — and is neither listed in `readOnly` nor counted for `components`\n * (the prop catalog is read off the projected document). It used to be the whole document\n * with the excluded positions listed as `readOnly`.\n */\nexport function modelFacingDocument(\n  document: CmsDocument,\n  collection: CollectionDef,\n  validateOptions: ValidateDocumentOptions = {},\n): CmsDocument & { components?: Record<string, string[]>; readOnly?: string[] } {\n  const lookupManifest = validateOptions.lookupManifest\n  const readOnly = readOnlyPositionsOf(collection.fields)\n  const projected = toWriterDocument(collection, document, lookupManifest ? { lookupManifest } : {})\n  const read = { ...projected, ...(readOnly.length > 0 ? { readOnly } : {}) }\n  if (!lookupManifest) return read\n  const ids = componentIdsOf(collection, projected, lookupManifest)\n  if (ids.length === 0) return read\n  return {\n    ...read,\n    components: Object.fromEntries(ids.map((id) => [id, describeComponentProps(lookupManifest(id) ?? {})])),\n  }\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  /**\n   * EC-497 — the ONE bag every engine below is handed, assembled in exactly one\n   * place instead of at each of the three former call sites.\n   *\n   * The executor's own `localeConfig` is a FLOOR, never an override: the session's\n   * bag wins wherever it speaks, but a bag that omits the project's locales must\n   * not be able to make the gate locale-blind — a localized bound would then go\n   * unchecked, which is precisely the class of hole this task closed.\n   */\n  const validateOptions: ValidateDocumentOptions = {\n    ...(options.localeConfig ? { localeConfig: options.localeConfig } : {}),\n    ...(options.validateOptions ?? {}),\n  }\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/EC-593: the model reads (and re-authors) every value in its writer form.\n    // EC-741: through the model-read projection — a document of a collection outside the\n    // catalog is an error, never the raw document (nothing would project it).\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    return { ok: true, output: modelFacingDocument(document, collection, validateOptions) }\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      // EC-381 → EC-593: the store IS the leash, asked per position.\n      leash: options.candidates,\n      ...(options.locale ? { locale: options.locale } : {}),\n      validateOptions,\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    const revision = options.readers.revisionOf?.(document)\n    options.onProposal(toolCallId, {\n      origin: 'update',\n      collection: collection.id,\n      documentId: document.id,\n      patch: result.patch,\n      patches: result.patches,\n      ...(revision !== undefined ? { revision } : {}),\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        // EC-741: the title from the projected values (an excluded field is never one).\n        title: modelFacingTitle(collection, titleValues, document.id, validateOptions),\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    // EC-715: a singleton has its one document; the media library holds uploads. Neither\n    // takes a create — refused here, not proposed for the editor to discover on apply.\n    if (isSingleton(collection)) {\n      return {\n        ok: false,\n        errorText: `\"${collection.id}\" is a singleton — it has exactly one document, which is changed with updateFields, never created.`,\n      }\n    }\n    if (collection.kind === 'asset') {\n      return {\n        ok: false,\n        errorText: `\"${collection.id}\" is the media library — assets are uploaded by people, never created by the assistant.`,\n      }\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      // EC-381 → EC-593: relation and asset positions — at every depth — are leashed\n      // to what was searched (the store IS the leash).\n      leash: options.candidates,\n      ...(options.locale ? { locale: options.locale } : {}),\n      validateOptions,\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      ...(result.unfilled.length > 0 ? { unfilled: result.unfilled } : {}),\n    })\n    // Compact summary only — the full patch goes to the review UI, not the model.\n    const unfilled = result.unfilled.map(describeUnfilled)\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,\n        title: modelFacingTitle(collection, titleValues, documentId, validateOptions),\n        ...(unfilled.length > 0 ? { unfilled } : {}),\n        note:\n          unfilled.length > 0\n            ? 'Draft proposal created; the editor reviews and applies it in the studio. Summarize briefly — do not repeat the content — and tell the user which fields were left empty (unfilled).'\n            : '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      // EC-497: the engine gates its own output; both callers hand it the session\n      // registry + THE bag so its verdict is the editor's verdict.\n      registry: options.registry,\n      validateOptions,\n    })\n    // EC-593 (ratified 4e): what could not be translated is REPORTED — to the model\n    // (it tells the user) and on the proposal the editor reviews — never skipped silently.\n    const skipped = result.skipped.map(describeTranslateSkip)\n    if (result.total === 0 && skipped.length === 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 {\n        ok: false,\n        errorText:\n          skipped.length > 0\n            ? `The translation did not produce any content. Not translated: ${skipped.slice(0, 5).join('; ')}`\n            : 'The translation did not produce any content.',\n      }\n    }\n    // EC-473 established that a translated draft is validated before it is proposed\n    // (this path once proposed unvalidated content). EC-497 moved the gate INTO the\n    // engine so the detail-editor's header action — the other caller — inherits it\n    // instead of writing model output straight to the document. Only errors the\n    // translation INTRODUCED block it; pre-existing brokenness is not the\n    // assistant's doing.\n    if (result.introducedErrors.length > 0) {\n      return {\n        ok: false,\n        errorText: `The translation did not pass validation: ${issueSummary(result.introducedErrors)}`,\n      }\n    }\n    const revision = options.readers.revisionOf?.(document)\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      patches: result.patches,\n      ...(revision !== undefined ? { revision } : {}),\n      provenance: result.provenance,\n      attempts: 1,\n      // Warnings ride onto the proposal like every other path's (EC-496 renders them).\n      issues: [...result.issues],\n      ...(result.skipped.length > 0 ? { skipped: [...result.skipped] } : {}),\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        ...(skipped.length > 0 ? { notTranslated: skipped } : {}),\n        note:\n          skipped.length > 0\n            ? 'Translation proposal created; the editor reviews and applies it in the studio. Tell the user which positions were NOT translated (notTranslated).'\n            : '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/translate-document.d.ts

@@ -57,7 +57,14 @@ export type TranslateSkipReason =
 /** The provider returned no (or empty) text for the unit. */
  | 'not-returned'
 /** The translation did not keep the formatting / link / embed tokens; the original was kept. */
- | 'structure-changed';
+ | 'structure-changed'
+/**
+ * EC-738: the bucket's locked content (`form.readOnly` / `ai.exclude`) differs in shape
+ * from the source's — writing the translation would lose a locked value the target holds or
+ * add one it does not (a repeater with more or fewer items, a composition with other
+ * nodes). The whole bucket was left as it is: only code, a seed or an import changes it.
+ */
+ | 'locked';
 /**
  * One text position the run could NOT translate (EC-593, ratified 4e): reported in the
  * result and shown in the dialog — never a silent skip.

package/dist/lib/ai/translate-document.js

@@ -39,14 +39,14 @@
  * translates with cross-block context. Bounded concurrency (default 6) keeps a realistic
  * document well under the route's per-minute rate limit.
  */
-import { autoDeriveSlug, createCollectionRegistry, fieldValuePosition, isFieldLocalized, isWriterLocked, slugFieldOf, validateDocument, valuesInLocale, writeField, } from '@elytracms/core/cms-core';
+import { autoDeriveSlug, createCollectionRegistry, fieldValuePosition, isFieldLocalized, isWriterLocked, resolveField, slugFieldOf, validateDocument, valuesInLocale, writeField, } from '@elytracms/core/cms-core';
 import { introducedErrors, warningsOf } from './proposal-validation.js';
 import { fieldWritePatch } from '../cms/field-patch.js';
 import { fieldConnection, hasLocaleVariant } from '../locale/index.js';
 import { assembleKnowledgeBlock } from './knowledge.js';
 import { aiProvenance } from './provenance.js';
 import { extractRichTextUnits, rebuildRichTextReport } from './rich-text-translate.js';
-import { rebuildTextPositions, textPositionsOf } from './writer-form.js';
+import { lockedChanges, rebuildTextPositions, textPositionsOf, withLockedFrom } from './writer-form.js';
 /** Default translatable units per `generate` call. */
 export const DEFAULT_TRANSLATE_BATCH_SIZE = 12;
 /** Default number of `generate` calls in flight at once (mirrors the precedent's limiter of 6). */
@@ -235,6 +235,20 @@ export async function translateDocument(input) {
             const eligible = mode === 'retranslate-all' ? conn.canFillFromBase : conn.connected && conn.canFillFromBase;
             if (!eligible)
                 continue;
+            // EC-738: the target keeps its locked content. The translation is the base value with
+            // its text replaced, and every locked position then taken from the target's DISPLAYED
+            // value by key; a bucket where that still loses or creates a locked value (the two
+            // differ in shape around it) is not written. Judged here, before any unit is sent:
+            // the text replacement changes neither the locked positions nor the shape around them.
+            // Fill-empty is unchanged by construction — a connected bucket displays the base.
+            const current = resolveField(collection, document, field.name, locale, localeConfig).value;
+            const root = fieldValuePosition(field, conn.baseValue, { locale: base });
+            const kept = withLockedFrom(root, current, positionCtx);
+            const changes = lockedChanges(fieldValuePosition(field, current, { locale }), kept, positionCtx);
+            if (changes.lost.length > 0 || changes.created.length > 0) {
+                skip(field.name, locale, root, 'locked');
+                continue;
+            }
             const before = units.length;
             // EC-593: every text position of the base value — the converter module's fold
             // over core's ONE value-position traversal.
@@ -272,7 +286,7 @@ export async function translateDocument(input) {
                 }
             }
             if (units.length > before)
-                pending.push({ field, locale, base: conn.baseValue });
+                pending.push({ field, locale, base: conn.baseValue, current });
         }
     }
     const total = units.length;
@@ -343,7 +357,7 @@ export async function translateDocument(input) {
         'content',
         ...blockId.split('.').map(Number),
     ];
-    for (const { field, locale, base: baseValue } of pending) {
+    for (const { field, locale, base: baseValue, current } of pending) {
         let applied = 0;
         // EC-593: the base value with each translated text position replaced — the
         // converter module's writing fold; every other value is carried from the base.
@@ -386,7 +400,8 @@ export async function translateDocument(input) {
         });
         if (applied === 0)
             continue; // nothing landed — the bucket stays connected to base
-        write(field.name, locale, value);
+        // EC-738: the target's locked positions, by key (judged in step 1).
+        write(field.name, locale, withLockedFrom(fieldValuePosition(field, value, { locale }), current, positionCtx));
         bump(locale, applied);
     }
     // 4. Slugs: derive each empty per-locale slug from the (now translated) source. Never