@elytracms/studio 0.0.92 → 0.0.93

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

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/ai/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * `@elytracms/studio/lib/ai` — headless AI platform seam types (EC-331, phase 1).\n *\n * Pure types only: this module imports nothing at runtime (every import is\n * `import type`), so referencing `StudioAiConfig` from the studio-config type does\n * NOT pull the `ai` / `@ai-sdk/*` runtime onto the critical path. The runtime lives\n * in the sibling modules (`config`, `anthropic-provider`, `fake-provider`,\n * `knowledge`, `shape`, `apply-content`, `route`, `provenance`), reached only when\n * the `ai` block is configured and the AI subsystem actually boots. The Anthropic\n * provider additionally loads `ai`/`@ai-sdk/anthropic` via dynamic `import()`, so\n * even importing this barrel never eagerly loads the SDK.\n */\nimport type {\n  CollectionDef,\n  CollectionRegistry,\n  CmsValidationIssue,\n  FieldValues,\n  JsonSchema,\n  ValidateDocumentOptions,\n} from '@elytracms/core/cms-core'\nimport type { ComponentManifest } from '@elytracms/core/component-registry'\n// Type-only on purpose (erased at compile; `verbatimModuleSyntax`): referencing the\n// SDK's `LanguageModel` here creates NO runtime edge — pinned in `bundle.test.ts`.\nimport type { LanguageModel } from 'ai'\n\n// --- Provider seam ----------------------------------------------------------------\n\n/**\n * The capabilities the engine requires of a provider. Both must be `true` — the\n * capability gate (`resolveAiConfig`) fails loud otherwise (tool-calling +\n * structured output are the non-negotiable floor for schema-guaranteed authoring).\n */\nexport interface AiProviderCapabilities {\n  /** The provider can call tools (function/tool calling). */\n  toolCalling: boolean\n  /** The provider can return schema-constrained structured output. */\n  structuredOutput: boolean\n}\n\n/** A request for one schema-constrained structured object — the engine's core primitive. */\nexport interface GenerateStructuredRequest {\n  /** System prompt: rules, injection stance, closed-world constraints. */\n  system?: string\n  /** The task prompt plus assembled context (knowledge, existing values, prior issues). */\n  prompt: string\n  /** The target shape as a JSON Schema (draft 2020-12 subset) the output must satisfy. */\n  schema: JsonSchema\n  /** A short name for the schema (some providers surface it as the tool/output name). */\n  schemaName?: string\n  /** A one-line description of what the schema represents. */\n  schemaDescription?: string\n}\n\n/** Token usage a provider may report (best-effort; recorded for soft spend counters). */\nexport interface AiUsage {\n  inputTokens?: number\n  outputTokens?: number\n}\n\nexport interface GenerateStructuredResult {\n  /** The structured object the provider produced (best-effort match to the request schema). */\n  object: unknown\n  usage?: AiUsage\n}\n\n/**\n * A provider adapter over a tool-calling, structured-output model. Anthropic (or\n * the Vercel AI Gateway) in production, {@link FakeProvider} (deterministic,\n * keyless) in tests/playground — all implement this identical surface so the whole\n * loop runs without a key.\n */\nexport interface AiProvider {\n  /** Stable provider id (e.g. `anthropic`, `fake`); recorded in provenance. */\n  readonly id: string\n  /** The model id the provider targets, when fixed; recorded in provenance. */\n  readonly model?: string\n  /** The provider's capabilities — validated by the capability gate at config load. */\n  capabilities(): AiProviderCapabilities\n  /** Produce a single schema-constrained structured object. */\n  generateStructured(request: GenerateStructuredRequest): Promise<GenerateStructuredResult>\n  /**\n   * The AI-SDK `LanguageModel` behind this provider — the seam the route's native\n   * chat branch consumes (EC-334: `streamText` over UIMessages, tools declared\n   * without `execute` so they forward to the client). Optional: a pure structured\n   * proxy (the client-side route provider) exposes none — the route answers 501\n   * for chat requests then.\n   */\n  languageModel?(): Promise<LanguageModel>\n}\n\n// --- Config seam ------------------------------------------------------------------\n\n/** Soft, advisory limits for the route counter and the engine repair loop. */\nexport interface AiLimits {\n  /** Soft per-project ceiling on route requests per minute (advisory; route-enforced). */\n  maxRequestsPerMinute?: number\n  /** Cap on repair attempts after the first generation (engine default when omitted). */\n  maxRepairAttempts?: number\n}\n\n/**\n * The `ai` block of `defineStudio({ ai })` (EC-331). Studio-only live code — like\n * `fieldRenderers` / `i18n`, it never reaches the delivery bundle. The block's\n * ABSENCE means the feature is fully absent (no AI UI, no AI deps on the critical\n * path); `enabled: false` is a temporary kill-switch that keeps the config.\n */\nexport interface StudioAiConfig {\n  /**\n   * Temporary kill-switch. Presence of the whole `ai` block enables the feature;\n   * `enabled: false` disables it without removing the config. Omitted ⇒ enabled.\n   */\n  enabled?: boolean\n  /** The provider adapter (live code): Anthropic in production, FakeProvider in tests/playground. */\n  provider: AiProvider\n  /** Project knowledge sources assembled into the model's context. */\n  knowledge?: KnowledgeSource[]\n  /** Soft rate / repair limits. */\n  limits?: AiLimits\n}\n\n// --- Knowledge seam ---------------------------------------------------------------\n\n/** An inline knowledge literal (markdown prose versioned with the repo). */\nexport interface KnowledgeItem {\n  title?: string\n  content: string\n}\n\n/**\n * A `fromCollection('<id>')` source: studio-editable knowledge whose *content* is\n * prose held in the DB (data), while the mechanism stays code. Resolved by a\n * caller-supplied collection reader (starter-kit / studio wires it to operations).\n */\nexport interface KnowledgeCollectionSource {\n  readonly kind: 'collection'\n  /** Collection id whose documents supply editable knowledge prose. */\n  readonly collectionId: string\n  /** Field carrying the prose; when omitted the reader picks the collection's title/first text field. */\n  readonly field?: string\n}\n\n/** An async (or sync) function producing knowledge items at resolve time. */\nexport type KnowledgeFn = () =>\n  | KnowledgeItem\n  | KnowledgeItem[]\n  | Promise<KnowledgeItem | KnowledgeItem[]>\n\n/** A knowledge source: inline literal, async function, or `fromCollection(...)` sugar. */\nexport type KnowledgeSource = KnowledgeItem | KnowledgeFn | KnowledgeCollectionSource\n\n/** The assembled knowledge context — a flat, deterministic list of resolved items. */\nexport interface ResolvedKnowledge {\n  items: KnowledgeItem[]\n}\n\n/** Reads knowledge prose out of a `fromCollection` source (wired to the operations layer). */\nexport type KnowledgeCollectionReader = (\n  source: KnowledgeCollectionSource,\n) => KnowledgeItem[] | Promise<KnowledgeItem[]>\n\n// --- Engine seam ------------------------------------------------------------------\n\n/**\n * A relation candidate id (from a `searchDocuments`/tool result). Relation fields may\n * ONLY use ids present here — the target shape emits them as an enum, so a\n * hallucinated id is not even representable as valid structured output.\n */\nexport interface RelationCandidate {\n  id: string\n  /** Human label (title) for the model to choose against. */\n  label?: string\n}\n\n/** Relation candidate ids keyed by field name. A field absent here is omitted from the shape. */\nexport type RelationCandidates = Record<string, RelationCandidate[]>\n\n/**\n * An asset candidate id (from a `listAssets` tool result). Asset/image fields may\n * ONLY use ids present here — the target shape emits them as an enum, so a\n * hallucinated (or invented / \"to-be-uploaded\") asset id is not even representable\n * as valid structured output. From the EXISTING media library ONLY (EC-381): the\n * assistant never generates or uploads an asset; empty beats wrong.\n */\nexport interface AssetCandidate {\n  id: string\n  /** Human label (title / filename) for the model to choose against. */\n  label?: string\n}\n\n/** Asset candidate ids keyed by field name. A field absent here is omitted from the shape. */\nexport type AssetCandidates = Record<string, AssetCandidate[]>\n\n/** The typed draft-values patch the engine emits — applied by the draft-write path. */\nexport interface ContentPatch {\n  collection: string\n  id: string\n  /** Non-localized field values. */\n  values: FieldValues\n  /** Per-locale field values (localized fields, under the target locale). */\n  localized?: Record<string, FieldValues>\n}\n\n/** Origin marker the draft-write path records so an AI-authored draft is attributable. */\nexport interface AiProvenance {\n  origin: 'assistant'\n  /** Provider id (e.g. `anthropic`, `fake`). */\n  provider: string\n  /** Model id, when the provider fixes one. */\n  model?: string\n  /** ISO timestamp when the content was generated. */\n  at: string\n}\n\nexport interface ApplyContentInput {\n  provider: AiProvider\n  registry: CollectionRegistry\n  collection: CollectionDef\n  /** Document id the patch targets (an existing doc for updates, or a fresh id for creation). */\n  documentId: string\n  /** The author's instruction / prompt. */\n  instruction: string\n  /** Assembled knowledge context (from `resolveKnowledge`). */\n  knowledge?: ResolvedKnowledge\n  /** Component manifests — context for `allow`-leashed richText/blocks fields. */\n  components?: readonly ComponentManifest[]\n  /** Relation candidate ids by field — the ONLY ids a relation field may use. */\n  candidates?: RelationCandidates\n  /**\n   * Asset candidate ids by field — the ONLY ids an asset/image field may use\n   * (EC-381). Emitted as an enum; an asset field with none is omitted from the\n   * shape (so a create proposal simply leaves it empty — empty beats wrong).\n   */\n  assetCandidates?: AssetCandidates\n  /** Existing draft values (updates): the model output merges over these before validation. */\n  existing?: FieldValues\n  /**\n   * Target locale for localized fields (their values land under `localized[locale]`);\n   * absent → the project's default locale (`validateOptions.localeConfig.default`).\n   */\n  locale?: string\n  /**\n   * THE validation option bag (EC-497) — the studio session's\n   * `gateValidateOptions(...)`, passed WHOLE rather than reassembled from\n   * individual keys here. EC-473 had already established that the assistant must\n   * judge its output by the editor's rules; this makes that structural: there is\n   * one bag, and a surface cannot quietly take a subset of it. EC-580 removed the\n   * one deviation it used to carry (a per-generation `{ default: locale }` config):\n   * a create in a non-default locale is judged by the project's own config, so a\n   * required localized field needs its default-locale value here exactly as at\n   * publish.\n   */\n  validateOptions?: ValidateDocumentOptions\n  /** Max repair attempts after the first generation (default {@link DEFAULT_MAX_REPAIR_ATTEMPTS}). */\n  maxRepairAttempts?: number\n}\n\n/** The engine's outcome: a valid, leash-compliant patch, or the blocking issues. */\nexport type ApplyContentResult =\n  | {\n      ok: true\n      patch: ContentPatch\n      provenance: AiProvenance\n      /** Total generation attempts made (1 = happy path, >1 = repaired). */\n      attempts: number\n      /** Non-error issues surfaced by the accepted document (e.g. warnings). */\n      issues: CmsValidationIssue[]\n    }\n  | {\n      ok: false\n      /** The error-severity issues from the final failed attempt. */\n      issues: CmsValidationIssue[]\n      attempts: number\n      provenance: AiProvenance\n    }\n\n// --- Route seam -------------------------------------------------------------------\n\n/** A validated studio session, from the host-wired `getSession`. Opaque beyond `userId`. */\nexport interface AiSession {\n  /** Authenticated principal id. */\n  userId: string\n  [key: string]: unknown\n}\n\nexport interface AiRouteHandlerOptions {\n  /** The provider (holds the host-env key). The route is a thin proxy over it. */\n  provider: AiProvider\n  /**\n   * Server-side session check (reject anonymous callers). Returns a session for an\n   * authenticated caller, `null` otherwise. Wired by the host to its own auth — the\n   * route consumes it, never re-implements it.\n   */\n  getSession: (request: Request) => AiSession | null | Promise<AiSession | null>\n  /** Soft per-project rate limit (advisory spend guard). */\n  limits?: AiLimits\n  /** Derive the per-project rate-bucket key from a request (default: one global bucket). */\n  projectKey?: (request: Request) => string\n  /**\n   * Millisecond clock the rate window is decided against (default `Date.now`).\n   * Injected so the 60 s boundary is testable with a fixed clock (EC-602, the\n   * AGENTS.md §4 determinism rule). Milliseconds rather than the house ISO\n   * `Clock` (`@elytracms/core/determinism`): that one stamps records; this one\n   * does window arithmetic.\n   */\n  now?: () => number\n}\n\n/** The mounted route handler: a framework-agnostic Web `Request → Response`. */\nexport type AiRouteHandler = (request: Request) => Promise<Response>\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/lib/ai/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * `@elytracms/studio/lib/ai` — headless AI platform seam types (EC-331, phase 1).\n *\n * Pure types only: this module imports nothing at runtime (every import is\n * `import type`), so referencing `StudioAiConfig` from the studio-config type does\n * NOT pull the `ai` / `@ai-sdk/*` runtime onto the critical path. The runtime lives\n * in the sibling modules (`config`, `anthropic-provider`, `fake-provider`,\n * `knowledge`, `shape`, `apply-content`, `route`, `provenance`), reached only when\n * the `ai` block is configured and the AI subsystem actually boots. The Anthropic\n * provider additionally loads `ai`/`@ai-sdk/anthropic` via dynamic `import()`, so\n * even importing this barrel never eagerly loads the SDK.\n */\nimport type {\n  AssetFieldDef,\n  CollectionDef,\n  CollectionRegistry,\n  CmsValidationIssue,\n  FieldValues,\n  JsonSchema,\n  ValidateDocumentOptions,\n} from '@elytracms/core/cms-core'\n// Type-only on purpose (erased at compile; `verbatimModuleSyntax`): referencing the\n// SDK's `LanguageModel` here creates NO runtime edge — pinned in `bundle.test.ts`.\nimport type { LanguageModel } from 'ai'\n\n// --- Provider seam ----------------------------------------------------------------\n\n/**\n * The capabilities the engine requires of a provider. Both must be `true` — the\n * capability gate (`resolveAiConfig`) fails loud otherwise (tool-calling +\n * structured output are the non-negotiable floor for schema-guaranteed authoring).\n */\nexport interface AiProviderCapabilities {\n  /** The provider can call tools (function/tool calling). */\n  toolCalling: boolean\n  /** The provider can return schema-constrained structured output. */\n  structuredOutput: boolean\n}\n\n/** A request for one schema-constrained structured object — the engine's core primitive. */\nexport interface GenerateStructuredRequest {\n  /** System prompt: rules, injection stance, closed-world constraints. */\n  system?: string\n  /** The task prompt plus assembled context (knowledge, existing values, prior issues). */\n  prompt: string\n  /** The target shape as a JSON Schema (draft 2020-12 subset) the output must satisfy. */\n  schema: JsonSchema\n  /** A short name for the schema (some providers surface it as the tool/output name). */\n  schemaName?: string\n  /** A one-line description of what the schema represents. */\n  schemaDescription?: string\n}\n\n/** Token usage a provider may report (best-effort; recorded for soft spend counters). */\nexport interface AiUsage {\n  inputTokens?: number\n  outputTokens?: number\n}\n\nexport interface GenerateStructuredResult {\n  /** The structured object the provider produced (best-effort match to the request schema). */\n  object: unknown\n  usage?: AiUsage\n}\n\n/**\n * A provider adapter over a tool-calling, structured-output model. Anthropic (or\n * the Vercel AI Gateway) in production, {@link FakeProvider} (deterministic,\n * keyless) in tests/playground — all implement this identical surface so the whole\n * loop runs without a key.\n */\nexport interface AiProvider {\n  /** Stable provider id (e.g. `anthropic`, `fake`); recorded in provenance. */\n  readonly id: string\n  /** The model id the provider targets, when fixed; recorded in provenance. */\n  readonly model?: string\n  /** The provider's capabilities — validated by the capability gate at config load. */\n  capabilities(): AiProviderCapabilities\n  /** Produce a single schema-constrained structured object. */\n  generateStructured(request: GenerateStructuredRequest): Promise<GenerateStructuredResult>\n  /**\n   * The AI-SDK `LanguageModel` behind this provider — the seam the route's native\n   * chat branch consumes (EC-334: `streamText` over UIMessages, tools declared\n   * without `execute` so they forward to the client). Optional: a pure structured\n   * proxy (the client-side route provider) exposes none — the route answers 501\n   * for chat requests then.\n   */\n  languageModel?(): Promise<LanguageModel>\n}\n\n// --- Config seam ------------------------------------------------------------------\n\n/** Soft, advisory limits for the route counter and the engine repair loop. */\nexport interface AiLimits {\n  /** Soft per-project ceiling on route requests per minute (advisory; route-enforced). */\n  maxRequestsPerMinute?: number\n  /** Cap on repair attempts after the first generation (engine default when omitted). */\n  maxRepairAttempts?: number\n}\n\n/**\n * The `ai` block of `defineStudio({ ai })` (EC-331). Studio-only live code — like\n * `fieldRenderers` / `i18n`, it never reaches the delivery bundle. The block's\n * ABSENCE means the feature is fully absent (no AI UI, no AI deps on the critical\n * path); `enabled: false` is a temporary kill-switch that keeps the config.\n */\nexport interface StudioAiConfig {\n  /**\n   * Temporary kill-switch. Presence of the whole `ai` block enables the feature;\n   * `enabled: false` disables it without removing the config. Omitted ⇒ enabled.\n   */\n  enabled?: boolean\n  /** The provider adapter (live code): Anthropic in production, FakeProvider in tests/playground. */\n  provider: AiProvider\n  /** Project knowledge sources assembled into the model's context. */\n  knowledge?: KnowledgeSource[]\n  /** Soft rate / repair limits. */\n  limits?: AiLimits\n}\n\n// --- Knowledge seam ---------------------------------------------------------------\n\n/** An inline knowledge literal (markdown prose versioned with the repo). */\nexport interface KnowledgeItem {\n  title?: string\n  content: string\n}\n\n/**\n * A `fromCollection('<id>')` source: studio-editable knowledge whose *content* is\n * prose held in the DB (data), while the mechanism stays code. Resolved by a\n * caller-supplied collection reader (starter-kit / studio wires it to operations).\n */\nexport interface KnowledgeCollectionSource {\n  readonly kind: 'collection'\n  /** Collection id whose documents supply editable knowledge prose. */\n  readonly collectionId: string\n  /** Field carrying the prose; when omitted the reader picks the collection's title/first text field. */\n  readonly field?: string\n}\n\n/** An async (or sync) function producing knowledge items at resolve time. */\nexport type KnowledgeFn = () =>\n  | KnowledgeItem\n  | KnowledgeItem[]\n  | Promise<KnowledgeItem | KnowledgeItem[]>\n\n/** A knowledge source: inline literal, async function, or `fromCollection(...)` sugar. */\nexport type KnowledgeSource = KnowledgeItem | KnowledgeFn | KnowledgeCollectionSource\n\n/** The assembled knowledge context — a flat, deterministic list of resolved items. */\nexport interface ResolvedKnowledge {\n  items: KnowledgeItem[]\n}\n\n/** Reads knowledge prose out of a `fromCollection` source (wired to the operations layer). */\nexport type KnowledgeCollectionReader = (\n  source: KnowledgeCollectionSource,\n) => KnowledgeItem[] | Promise<KnowledgeItem[]>\n\n// --- Engine seam ------------------------------------------------------------------\n\n/**\n * A relation candidate id (from a `searchDocuments` tool result). A relation may ONLY\n * use a searched id, or one the document already references — at every position\n * (EC-593): the create shape emits them as an enum, so a hallucinated id is not even\n * representable as valid structured output, and the writer-form converter refuses (edit)\n * or drops (create) any other.\n */\nexport interface RelationCandidate {\n  id: string\n  /** Human label (title) for the model to choose against. */\n  label?: string\n}\n\n/**\n * An asset candidate id (from a `listAssets` tool result). An asset position may ONLY\n * hold a searched library asset that fits its `accept` (EC-588), or one the document\n * already references — at every position (EC-593). From the EXISTING media library ONLY\n * (EC-381): the assistant never generates or uploads an asset; empty beats wrong.\n */\nexport interface AssetCandidate {\n  id: string\n  /** Human label (title / filename) for the model to choose against. */\n  label?: string\n}\n\n/**\n * THE id leash (EC-381, at every position since EC-593): what the model searched this\n * conversation, asked per POSITION rather than per top-level field name — a relation by\n * its target collection, an asset by its declaration (its `accept`). A nested relation\n * in an object, an asset prop of a component inside a composition and a top-level field\n * are judged by the same two questions. The chat's per-conversation candidate store is\n * one (`createChatCandidateStore`); `writerLeash` builds one from plain search results.\n */\nexport interface WriterLeash {\n  /** The searched documents a reference to `target` may use. */\n  relationCandidates(target: string): readonly RelationCandidate[]\n  /** The searched library assets an asset position declared by `field` may hold (its `accept` applied). */\n  assetCandidates(field: AssetFieldDef): readonly AssetCandidate[]\n}\n\n/** The typed draft-values patch the engine emits — applied by the draft-write path. */\nexport interface ContentPatch {\n  collection: string\n  id: string\n  /** Non-localized field values. */\n  values: FieldValues\n  /** Per-locale field values (localized fields, under the target locale). */\n  localized?: Record<string, FieldValues>\n}\n\n/** Origin marker the draft-write path records so an AI-authored draft is attributable. */\nexport interface AiProvenance {\n  origin: 'assistant'\n  /** Provider id (e.g. `anthropic`, `fake`). */\n  provider: string\n  /** Model id, when the provider fixes one. */\n  model?: string\n  /** ISO timestamp when the content was generated. */\n  at: string\n}\n\nexport interface ApplyContentInput {\n  provider: AiProvider\n  registry: CollectionRegistry\n  collection: CollectionDef\n  /** Document id the patch targets (an existing doc for updates, or a fresh id for creation). */\n  documentId: string\n  /** The author's instruction / prompt. */\n  instruction: string\n  /** Assembled knowledge context (from `resolveKnowledge`). */\n  knowledge?: ResolvedKnowledge\n  /**\n   * THE id leash at every position (EC-381 → EC-593): the ONLY ids a relation or an\n   * asset may use, wherever it sits. Emitted as an enum on the shape; a position with\n   * none is omitted (so a create proposal simply leaves it empty — empty beats wrong),\n   * and an id outside it is dropped and reported as a warning. Absent → no ids at all.\n   */\n  leash?: WriterLeash\n  /**\n   * Existing draft values (updates): the model output merges over these before\n   * validation, and an asset position carries its placement sub-fields from the value\n   * here (EC-570 #3 — the one carry rule, `carryAssetPlacements`).\n   */\n  existing?: FieldValues\n  /**\n   * Target locale for localized fields (their values land under `localized[locale]`);\n   * absent → the project's default locale (`validateOptions.localeConfig.default`).\n   */\n  locale?: string\n  /**\n   * THE validation option bag (EC-497) — the studio session's\n   * `gateValidateOptions(...)`, passed WHOLE rather than reassembled from\n   * individual keys here. EC-473 had already established that the assistant must\n   * judge its output by the editor's rules; this makes that structural: there is\n   * one bag, and a surface cannot quietly take a subset of it. EC-580 removed the\n   * one deviation it used to carry (a per-generation `{ default: locale }` config):\n   * a create in a non-default locale is judged by the project's own config, so a\n   * required localized field needs its default-locale value here exactly as at\n   * publish.\n   */\n  validateOptions?: ValidateDocumentOptions\n  /** Max repair attempts after the first generation (default {@link DEFAULT_MAX_REPAIR_ATTEMPTS}). */\n  maxRepairAttempts?: number\n}\n\n/** The engine's outcome: a valid, leash-compliant patch, or the blocking issues. */\nexport type ApplyContentResult =\n  | {\n      ok: true\n      patch: ContentPatch\n      provenance: AiProvenance\n      /** Total generation attempts made (1 = happy path, >1 = repaired). */\n      attempts: number\n      /** Non-error issues surfaced by the accepted document (e.g. warnings). */\n      issues: CmsValidationIssue[]\n    }\n  | {\n      ok: false\n      /** The error-severity issues from the final failed attempt. */\n      issues: CmsValidationIssue[]\n      attempts: number\n      provenance: AiProvenance\n    }\n\n// --- Route seam -------------------------------------------------------------------\n\n/** A validated studio session, from the host-wired `getSession`. Opaque beyond `userId`. */\nexport interface AiSession {\n  /** Authenticated principal id. */\n  userId: string\n  [key: string]: unknown\n}\n\nexport interface AiRouteHandlerOptions {\n  /** The provider (holds the host-env key). The route is a thin proxy over it. */\n  provider: AiProvider\n  /**\n   * Server-side session check (reject anonymous callers). Returns a session for an\n   * authenticated caller, `null` otherwise. Wired by the host to its own auth — the\n   * route consumes it, never re-implements it.\n   */\n  getSession: (request: Request) => AiSession | null | Promise<AiSession | null>\n  /** Soft per-project rate limit (advisory spend guard). */\n  limits?: AiLimits\n  /** Derive the per-project rate-bucket key from a request (default: one global bucket). */\n  projectKey?: (request: Request) => string\n  /**\n   * Millisecond clock the rate window is decided against (default `Date.now`).\n   * Injected so the 60 s boundary is testable with a fixed clock (EC-602, the\n   * AGENTS.md §4 determinism rule). Milliseconds rather than the house ISO\n   * `Clock` (`@elytracms/core/determinism`): that one stamps records; this one\n   * does window arithmetic.\n   */\n  now?: () => number\n}\n\n/** The mounted route handler: a framework-agnostic Web `Request → Response`. */\nexport type AiRouteHandler = (request: Request) => Promise<Response>\n"]}

package/dist/lib/ai/update-fields.d.ts

@@ -1,17 +1,17 @@
 import type { CmsDocument, CmsValidationIssue, CollectionDef, CollectionRegistry, DocumentPatch, FieldValues, ValidateDocumentOptions } from '@elytracms/core/cms-core';
-import type { AssetCandidates, ContentPatch, RelationCandidates } from './types.js';
+import type { ContentPatch, WriterLeash } from './types.js';
 /**
  * One field change of an `updateFields` proposal, addressed with the engine's
  * existing conventions (diff / restore-scope): `field` (+ `locale` bucket for a
- * localized field), and for a `blocks` field optionally `blockId` + `prop` to
- * change one component prop of one root block. `value` is the new value
- * (`null`/omitted clears the field or prop).
+ * localized field), and for a component inside a composition optionally
+ * `blockId` + `prop` to change one prop of that component — at any depth.
+ * `value` is the new value (`null`/omitted clears the field or prop).
  */
 export interface UpdateFieldChange {
     field: string;
     /** Locale bucket for a LOCALIZED field (defaults to the editor's working locale). */
     locale?: string;
-    /** For a `blocks` field: the root block's stable node id (from `getDocument`). */
+    /** A component's stable node id (from `getDocument`) — at any depth: slots, rich-text embeds. */
     blockId?: string;
     /** With `blockId`: the component prop to change. */
     prop?: string;
@@ -26,15 +26,18 @@ export interface BuildUpdateProposalInput {
     changes: readonly UpdateFieldChange[];
     /** The editor's working locale — the default bucket for localized fields. */
     locale?: string;
-    /** Relation candidates (searched ids) keyed by field name — the id leash. */
-    candidates?: RelationCandidates;
-    /** Asset candidates (searched library ids) keyed by field name — the asset id leash (EC-381). */
-    assetCandidates?: AssetCandidates;
+    /**
+     * THE id leash at every position (EC-381 → EC-593): what the model searched this
+     * conversation. An id that is neither searched nor already on the document fails.
+     */
+    leash?: WriterLeash;
     /**
      * THE validation option bag (EC-497) — the studio session's
      * `gateValidateOptions(...)`, whole. It also carries the project's
-     * `localeConfig`, which is what the unknown-locale targeting check reads: one
-     * source for "which locales exist", not two that can disagree.
+     * `localeConfig` — what the unknown-locale targeting check and the displayed-value
+     * carry read — and the `lookupManifest` the converter reaches component props
+     * through: one source for "which locales exist" and "which props a component
+     * declares", not two that can disagree.
      */
     validateOptions?: ValidateDocumentOptions;
 }
@@ -50,7 +53,7 @@ export type BuildUpdateProposalResult = {
     patch: ContentPatch;
     /**
      * EC-595 A2 — the proposal as the positions it changes (a field's bucket, or one
-     * block prop by node id): what an accepted proposal persists, so applying it
+     * component prop by node path): what an accepted proposal persists, so applying it
      * never overwrites a change made to any other position since it was built.
      */
     patches: DocumentPatch[];

package/dist/lib/ai/update-fields.js

@@ -11,15 +11,25 @@
  *    never a whole-document rewrite; the patch is the merged document, the diff
  *    (`diffDocuments`) is what the editor reviews (changed fields only).
  *  - **targeting is addressed with the engine's existing conventions** — field
- *    name + optional locale bucket (the diff / `RestoreScope` shape) and, inside
- *    a `blocks` field, `blockId` + `prop` (the `BlockChange`/`PropChange` shape,
- *    root blocks by stable node id). No new path grammar.
+ *    name + optional locale bucket (the diff / `RestoreScope` shape) and, for a
+ *    component inside a composition, `blockId` + `prop`: the component's node id
+ *    at ANY depth the value-position traversal reaches (a top-level block, a child
+ *    in a slot, a component embedded in rich text — EC-593). No new path grammar.
+ *  - **one converter** (EC-593, closes EC-571): every value goes from its writer
+ *    form to its stored form through `writer-form.ts` — the same fold create,
+ *    translate and the read form use — so a nested markdown sub-field, a nested
+ *    asset swap and a block's asset prop are converted, carried and leashed exactly
+ *    as a top-level field is.
  *  - **leashes hold, loudly**: `ai.exclude` fields are untouchable; relation AND
  *    asset ids (EC-381) must come from searched candidates (`searchDocuments` /
- *    `listAssets`) or already be on the document; every targeting failure is an
- *    explicit issue — never a silent drop (unlike the create shape, which makes bad
- *    ids structurally unrepresentable, an update change is imperative — so it FAILS
- *    instead of being filtered).
+ *    `listAssets`) or already be on the document — at every position; every
+ *    targeting failure is an explicit issue — never a silent drop (unlike the
+ *    create shape, which makes bad ids structurally unrepresentable, an update
+ *    change is imperative — so it FAILS instead of being filtered).
+ *  - **content, never structure** (ratified 4c): a composition's components are
+ *    never added, removed or moved by the assistant — a whole-value write of a
+ *    `blocks` field is refused with the way to change a prop instead, and a
+ *    rich-text value must keep the components embedded in it.
  *  - **validation parity**: the merged document runs through `validateDocument`
  *    with the studio's injected leashes. Only errors the change INTRODUCES block
  *    the proposal — pre-existing brokenness on the document is not the
@@ -28,19 +38,21 @@
  *
  * Locale-awareness: a localized field's change lands in the change's `locale`,
  * defaulting to the editor's working locale (`input.locale`). Non-localized
- * fields reject a `locale` loudly.
+ * fields reject a `locale` loudly. The value a change replaces is the DISPLAYED
+ * value of that bucket (ratified 2c): a new locale bucket carries its placement
+ * sub-fields — and a component prop change its whole composition — from the
+ * fallback, exactly as the pickers do.
  *
  * Pure and deterministic — no provider, no I/O; the executor (`tools.ts`) wires
  * it to `getDocument` + the candidate store and hands the result to the review
  * sink.
  */
-import { cmsIssue, isFieldLocalized, nodePropPath, readAssetId, referenceNode, validateDocument, walkReferences, writeField, } from '@elytracms/core/cms-core';
-import { blockRootsOf, editBlockRoots, staticProp } from '@elytracms/core/project-graph';
+import { cmsIssue, isFieldLocalized, isSequenceValue, resolveField, validateDocument, writeField, } from '@elytracms/core/cms-core';
+import { editBlockRoots } from '@elytracms/core/project-graph';
 import { diffDocuments } from '@elytracms/core/content';
-import { carryAssetPlacements } from '../assets/asset-placements.js';
 import { introducedErrors, warningsOf } from './proposal-validation.js';
 import { fieldWritePatch } from '../cms/field-patch.js';
-import { richTextValueFromModelInput } from './rich-text-input.js';
+import { fromWriterFieldValue, fromWriterFormAtNode, heldReferencesOf } from './writer-form.js';
 function isNonEmptyString(value) {
     return typeof value === 'string' && value.length > 0;
 }
@@ -49,175 +61,34 @@ function isNonEmptyString(value) {
 // imported)", MODE F5b.bkt). The locale is resolved per change below: a localized
 // field always arrives with one (a missing one is an explicit issue first).
 /**
- * The read twin of core's `writeField`: the field's value in the resolved
- * `locale` bucket, or in the shared `values` for a non-localized field. The exact
- * bucket only, with no default-locale fallback, because that bucket is the one the
- * write replaces.
+ * The value a change REPLACES (ratified 2c, EC-593): the DISPLAYED value of the field in
+ * the resolved bucket — core's `resolveField`, the rule every editor surface reads — so a
+ * new locale bucket carries its placement sub-fields (and a component prop change its
+ * composition) from the fallback, as the pickers do. It used to be the exact bucket only.
+ * Without a locale config there is no fallback to display: the bucket itself.
  */
-function readFieldValue(doc, fieldName, locale) {
-    return locale !== undefined ? doc.localized?.[locale]?.[fieldName] : doc.values[fieldName];
+function displayedFieldValue(input, doc, fieldName, locale) {
+    if (locale === undefined)
+        return doc.values[fieldName];
+    const config = input.validateOptions?.localeConfig;
+    return config
+        ? resolveField(input.collection, doc, fieldName, locale, config).value
+        : doc.localized?.[locale]?.[fieldName];
 }
-/**
- * Relation ids CURRENTLY on the document for a field (any locale bucket) — re-usable
- * without a search. EC-589: read off THE reference walk — the hits AT the field's own
- * position (the field, or one item of a list-valued field), never one nested deeper.
- */
-function currentRelationIds(doc, fieldName) {
-    const ids = new Set();
-    walkReferences(doc, (hit) => {
-        if (hit.kind !== 'relation-field' || hit.target.type !== 'document')
-            return;
-        const [field, second] = hit.position;
-        if (field?.kind !== 'field' || field.name !== fieldName)
-            return;
-        if (hit.position.length > (second?.kind === 'locale' ? 2 : 1))
-            return;
-        if (hit.within.some((key) => typeof key === 'string'))
-            return;
-        ids.add(hit.target.ref.id);
-    });
-    return ids;
-}
-/** Asset ids CURRENTLY on the document for a field (any bucket) — re-usable without a search (EC-381). */
-function currentAssetIds(doc, fieldName) {
-    const ids = new Set();
-    const collect = (value) => {
-        for (const entry of Array.isArray(value) ? value : [value]) {
-            const id = readAssetId(entry);
-            if (id)
-                ids.add(id);
-        }
-    };
-    collect(doc.values[fieldName]);
-    for (const bucket of Object.values(doc.localized ?? {}))
-        collect(bucket[fieldName]);
-    return ids;
-}
-/**
- * Map a change's raw value into the stored value shape (envelopes; loud leash).
- * `document` is the ORIGINAL document, which is what the id leash reads. `current`
- * is the value this change replaces, taken from the resolved locale bucket of the
- * working copy. The asset sub-field carry reads it (EC-558).
- */
-function mapUpdateValue(field, change, document, current, input, issue) {
-    const raw = change.value;
-    if (raw === undefined || raw === null)
-        return { value: undefined }; // clear
-    switch (field.type) {
-        case 'relation': {
-            const ids = Array.isArray(raw) ? raw : [raw];
-            if (!ids.every(isNonEmptyString)) {
-                return issue('invalid-field-value', `Relation "${field.name}" takes document id string(s) from searchDocuments results.`);
-            }
-            // The id leash (same stance as the create enum, but LOUD): only searched
-            // candidate ids or ids already on the document are usable.
-            const allowed = new Set([
-                ...(input.candidates?.[field.name] ?? []).map((c) => c.id),
-                ...currentRelationIds(document, field.name),
-            ]);
-            const unknown = ids.filter((id) => !allowed.has(id));
-            if (unknown.length > 0) {
-                return issue('unknown-relation-target', `Relation "${field.name}" may only use ids from searchDocuments results — search "${field.target}" first (got: ${unknown.join(', ')}).`);
-            }
-            if (!field.multiple && ids.length > 1) {
-                return issue('invalid-field-value', `Field "${field.name}" holds a single reference — pass one id.`);
-            }
-            const refs = ids.map((id) => referenceNode({ collection: field.target, id }));
-            return { value: field.multiple ? refs : refs[0] };
-        }
-        case 'asset': {
-            const ids = Array.isArray(raw) ? raw : [raw];
-            if (!ids.every(isNonEmptyString)) {
-                return issue('invalid-field-value', `Asset field "${field.name}" takes asset id string(s) from listAssets results.`);
-            }
-            // EC-381 — the asset id leash (same stance as relations, but LOUD): only
-            // searched library candidate ids or ids already on the document are usable;
-            // the assistant never invents or uploads an asset.
-            const allowed = new Set([
-                ...(input.assetCandidates?.[field.name] ?? []).map((c) => c.id),
-                ...currentAssetIds(document, field.name),
-            ]);
-            const unknown = ids.filter((id) => !allowed.has(id));
-            if (unknown.length > 0) {
-                return issue('unknown-asset', `Asset field "${field.name}" may only use ids from listAssets results — search the media library first (got: ${unknown.join(', ')}).`);
-            }
-            if (!field.multiple && ids.length > 1) {
-                return issue('invalid-field-value', `Field "${field.name}" holds a single asset — pass one id.`);
-            }
-            // EC-558: replace-with-list through the one carry rule. A held id keeps its
-            // placement's per-use sub-fields (a caption, say), a single swap carries
-            // them to the new image, and a NEW id is an envelope (EC-381). Data about
-            // the image itself (alt, an AI flag) belongs on the asset's `meta`.
-            return {
-                value: carryAssetPlacements(current, field.multiple ? { multiple: true, ids } : { multiple: false, id: ids[0] ?? null }),
-            };
-        }
-        case 'richText': {
-            // EC-379: a string value is MARKDOWN, converted through the engine's strict
-            // subset converter; out-of-subset constructs fail LOUD (the model retries
-            // in-conversation). A `{ version, doc }` envelope object stays accepted for
-            // robustness (getDocument may have shown one) — see rich-text-input.ts.
-            const converted = richTextValueFromModelInput(raw);
-            if (!converted.ok) {
-                return issue('invalid-field-value', `Field "${field.name}": ${converted.problems.join(' ')}`);
-            }
-            return { value: converted.value };
-        }
-        default:
-            // text / number / boolean / date / select / object / blocks: as sent. The
-            // write below (`writeField`) canonicalises it (EC-586: a date into one UTC
-            // instant, a multi-select scalar into a list, an empty list absent), and the
-            // merged document's validateDocument run is the shape leash.
-            return { value: raw };
-    }
-}
-/** Change one component prop of one root block (the `BlockChange`/`PropChange` address). */
-function applyBlockPropChange(collection, doc, field, change, locale, issue) {
-    if (field.type !== 'blocks') {
-        return issue('invalid-field-value', `"${change.field}" is not a blocks field — omit "blockId"/"prop" (set the field value directly).`);
-    }
-    if (!isNonEmptyString(change.blockId)) {
-        return issue('invalid-field-value', `Changing a block on "${change.field}" needs "blockId" — block ids come from getDocument.`);
-    }
-    if (!isNonEmptyString(change.prop)) {
-        return issue('invalid-field-value', `Changing block "${change.blockId}" needs "prop" — the component property to change.`);
-    }
-    const original = readFieldValue(doc, change.field, locale);
-    const blocks = blockRootsOf(original);
-    const index = blocks.findIndex((block) => block.id === change.blockId);
-    if (index < 0) {
-        return issue('invalid-field-value', `Block "${change.blockId}" was not found on "${change.field}" — read the document first; block ids come from getDocument.`);
-    }
-    const block = blocks[index];
-    const props = { ...(block.props ?? {}) };
-    if (change.value === undefined || change.value === null)
-        delete props[change.prop];
-    else
-        props[change.prop] = staticProp(change.value);
-    const nextBlock = { ...block, props };
-    // EC-576: through the core write path — the other roots and every typography
-    // item keep their place, and the write is the v2 sequence. (`blocks` is
-    // `editBlockRoots`' own root list, so `index` addresses the same root.)
-    const value = editBlockRoots(original, (roots) => roots.map((b, i) => (i === index ? nextBlock : b)));
-    // EC-595 A2: one block prop, by node id — the position this change wrote.
-    const path = nodePropPath(change.field, locale, change.blockId, change.prop);
-    const patch = change.value === undefined || change.value === null
-        ? { op: 'unset', path }
-        : { op: 'set', path, value: change.value };
-    return { doc: writeField(collection, doc, change.field, locale, value), patch };
-}
-/** Apply ONE change to a (copy of the) document, or report the targeting issue. */
-function applyOneChange(input, doc, change) {
+/** Apply ONE change to a (copy of the) document, or report the targeting issues. */
+function applyOneChange(input, ctx, doc, change) {
     const { collection } = input;
-    const issue = (code, message) => ({
-        issue: cmsIssue({
-            code,
-            message,
-            path: ['documents', `${collection.id}:${doc.id}`, 'values', change.field],
-            collectionId: collection.id,
-            documentId: doc.id,
-            meta: { field: change.field, ...(change.locale !== undefined ? { locale: change.locale } : {}) },
-        }),
+    const issueAt = (code, message, at = []) => cmsIssue({
+        code,
+        message,
+        path: ['documents', `${collection.id}:${doc.id}`, 'values', change.field, ...at],
+        collectionId: collection.id,
+        documentId: doc.id,
+        meta: { field: change.field, ...(change.locale !== undefined ? { locale: change.locale } : {}) },
+    });
+    const issue = (code, message) => ({ issues: [issueAt(code, message)] });
+    const fromProblems = (problems) => ({
+        issues: problems.map((problem) => issueAt(problem.code, problem.message, problem.at)),
     });
     const field = collection.fields.find((f) => f.name === change.field);
     if (!field) {
@@ -239,15 +110,61 @@ function applyOneChange(input, doc, change) {
     if (localized && locale === undefined) {
         return issue('missing-localized-value', `Field "${change.field}" is localized — provide "locale".`);
     }
+    const displayed = displayedFieldValue(input, doc, change.field, locale);
+    // The converter already wrote every value it changed in its stored form. The write
+    // does not re-canonicalise component props (no manifest lookup): that would rewrite
+    // the prop wrappers of every UNTOUCHED node too, and a proposal must change only what
+    // it changes (the persister canonicalises on save, as for every editor write).
+    const write = (value) => {
+        const written = writeField(collection, doc, change.field, locale, value);
+        return { doc: written, patch: fieldWritePatch(collection, written, change.field, locale) };
+    };
     if (change.blockId !== undefined || change.prop !== undefined) {
-        return applyBlockPropChange(collection, doc, field, change, locale, issue);
+        // A bucket that does not hold the field yet is written whole (from its displayed
+        // fallback): a node path into it would address a node that is not there.
+        const ownsBucket = locale === undefined || change.field in (doc.localized?.[locale] ?? {});
+        return applyNodePropChange(field, change, displayed, locale, ownsBucket, ctx, issue, fromProblems, write);
     }
-    const current = readFieldValue(doc, change.field, locale);
-    const mapped = mapUpdateValue(field, change, input.document, current, input, issue);
-    if ('issue' in mapped)
-        return mapped;
-    const written = writeField(collection, doc, change.field, locale, mapped.value);
-    return { doc: written, patch: fieldWritePatch(collection, written, change.field, locale) };
+    // EC-593: the ONE writer-form converter, at every depth (EC-571: this path used to
+    // convert top-level rich text only and store a nested markdown string raw).
+    const converted = fromWriterFieldValue(field, change.value, displayed, ctx, locale);
+    if (converted.problems.length > 0)
+        return fromProblems(converted.problems);
+    return write(converted.value);
+}
+/**
+ * Change one component prop, addressed by node id at any depth (EC-593: it used to be a
+ * ROOT block of a `blocks` field only, written verbatim — no carry, no leash, no
+ * markdown conversion, and the persisted patch carried the RAW model value).
+ */
+function applyNodePropChange(field, change, displayed, locale, ownsBucket, ctx, issue, fromProblems, write) {
+    if (!isNonEmptyString(change.blockId)) {
+        return issue('invalid-field-value', `Changing a component on "${change.field}" needs "blockId" — component ids come from getDocument.`);
+    }
+    if (!isNonEmptyString(change.prop)) {
+        return issue('invalid-field-value', `Changing component "${change.blockId}" needs "prop" — the component property to change.`);
+    }
+    // EC-576 tolerant read (reseed gate, EC-576 step 4 deletes it with the other legacy
+    // blocks readers): a pre-0.0.84 bare node / node list is lifted into the v2 sequence
+    // the traversal reads — and the write is that sequence (no writer re-emits the bare shape).
+    const composition = field.type === 'blocks' && displayed !== undefined && !isSequenceValue(displayed)
+        ? editBlockRoots(displayed, (roots) => roots)
+        : displayed;
+    const result = fromWriterFormAtNode(field, composition, change.blockId, change.prop, change.value, ctx, locale);
+    if (!result.ok)
+        return issue('invalid-field-value', result.message);
+    if (result.problems.length > 0)
+        return fromProblems(result.problems);
+    const written = write(result.value);
+    // EC-595 A2: the position this change wrote — the prop by its node path, or (where the
+    // grammar does not reach the node, the bucket is new, or a legacy value was lifted)
+    // the field bucket, whole: a coarser path, never a wrong one.
+    if (!result.exact || !ownsBucket || composition !== displayed)
+        return written;
+    const patch = result.propValue === undefined
+        ? { op: 'unset', path: result.path }
+        : { op: 'set', path: result.path, value: result.propValue };
+    return { doc: written.doc, patch };
 }
 /**
  * Build the reviewable update proposal: apply every change over a copy of the
@@ -260,10 +177,17 @@ export function buildUpdateProposal(input) {
     let next = structuredClone(document);
     const targetingIssues = [];
     const patches = [];
+    // EC-593: one converter context for every change — the validator's own prop lookup,
+    // the conversation's leash, and the ids the ORIGINAL document already references.
+    const ctx = {
+        ...(input.validateOptions?.lookupManifest ? { lookupManifest: input.validateOptions.lookupManifest } : {}),
+        ...(input.leash ? { leash: input.leash } : {}),
+        held: heldReferencesOf(document),
+    };
     for (const change of input.changes) {
-        const outcome = applyOneChange(input, next, change);
-        if ('issue' in outcome)
-            targetingIssues.push(outcome.issue);
+        const outcome = applyOneChange(input, ctx, next, change);
+        if ('issues' in outcome)
+            targetingIssues.push(...outcome.issues);
         else {
             next = outcome.doc;
             patches.push(outcome.patch);

package/dist/lib/ai/update-fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-fields.js","sourceRoot":"","sources":["../../../src/lib/ai/update-fields.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `buildUpdateProposal` — the EC-378 update-proposal builder (the edit-flow\n * counterpart of `applyContentWithShape`, minus the generation step).\n *\n * The MODEL authors the field changes directly in the `updateFields` tool input\n * (it has the conversation + `getDocument` output as context); this module turns\n * those changes into a reviewable proposal with the SAME engine discipline the\n * create flow has:\n *\n *  - **merge semantics**: changes apply per field over the EXISTING document —\n *    never a whole-document rewrite; the patch is the merged document, the diff\n *    (`diffDocuments`) is what the editor reviews (changed fields only).\n *  - **targeting is addressed with the engine's existing conventions** — field\n *    name + optional locale bucket (the diff / `RestoreScope` shape) and, inside\n *    a `blocks` field, `blockId` + `prop` (the `BlockChange`/`PropChange` shape,\n *    root blocks by stable node id). No new path grammar.\n *  - **leashes hold, loudly**: `ai.exclude` fields are untouchable; relation AND\n *    asset ids (EC-381) must come from searched candidates (`searchDocuments` /\n *    `listAssets`) or already be on the document; every targeting failure is an\n *    explicit issue — never a silent drop (unlike the create shape, which makes bad\n *    ids structurally unrepresentable, an update change is imperative — so it FAILS\n *    instead of being filtered).\n *  - **validation parity**: the merged document runs through `validateDocument`\n *    with the studio's injected leashes. Only errors the change INTRODUCES block\n *    the proposal — pre-existing brokenness on the document is not the\n *    assistant's doing and must not force a whole-document repair (the editor's\n *    own save path tolerates it the same way; errors gate publish, not drafts).\n *\n * Locale-awareness: a localized field's change lands in the change's `locale`,\n * defaulting to the editor's working locale (`input.locale`). Non-localized\n * fields reject a `locale` loudly.\n *\n * Pure and deterministic — no provider, no I/O; the executor (`tools.ts`) wires\n * it to `getDocument` + the candidate store and hands the result to the review\n * sink.\n */\nimport {\n  cmsIssue,\n  isFieldLocalized,\n  nodePropPath,\n  readAssetId,\n  referenceNode,\n  validateDocument,\n  walkReferences,\n  writeField,\n} from '@elytracms/core/cms-core'\nimport type {\n  CmsDocument,\n  CmsValidationIssue,\n  CollectionDef,\n  CollectionRegistry,\n  DocumentPatch,\n  FieldDef,\n  FieldValues,\n  ValidateDocumentOptions,\n} from '@elytracms/core/cms-core'\nimport { blockRootsOf, editBlockRoots, staticProp } from '@elytracms/core/project-graph'\nimport type { ComponentNode, JsonValue } from '@elytracms/core/project-graph'\nimport { diffDocuments } from '@elytracms/core/content'\nimport { carryAssetPlacements } from '../assets/asset-placements'\nimport { introducedErrors, warningsOf } from './proposal-validation'\nimport { fieldWritePatch } from '../cms/field-patch'\nimport { richTextValueFromModelInput } from './rich-text-input'\nimport type { AssetCandidates, ContentPatch, RelationCandidates } from './types'\n\n/**\n * One field change of an `updateFields` proposal, addressed with the engine's\n * existing conventions (diff / restore-scope): `field` (+ `locale` bucket for a\n * localized field), and for a `blocks` field optionally `blockId` + `prop` to\n * change one component prop of one root block. `value` is the new value\n * (`null`/omitted clears the field or prop).\n */\nexport interface UpdateFieldChange {\n  field: string\n  /** Locale bucket for a LOCALIZED field (defaults to the editor's working locale). */\n  locale?: string\n  /** For a `blocks` field: the root block's stable node id (from `getDocument`). */\n  blockId?: string\n  /** With `blockId`: the component prop to change. */\n  prop?: string\n  /** The new value; `null` / omitted clears the field or prop. */\n  value?: unknown\n}\n\nexport interface BuildUpdateProposalInput {\n  registry: CollectionRegistry\n  collection: CollectionDef\n  /** The CURRENT document — the proposal's \"before\" side. Never mutated. */\n  document: CmsDocument\n  changes: readonly UpdateFieldChange[]\n  /** The editor's working locale — the default bucket for localized fields. */\n  locale?: string\n  /** Relation candidates (searched ids) keyed by field name — the id leash. */\n  candidates?: RelationCandidates\n  /** Asset candidates (searched library ids) keyed by field name — the asset id leash (EC-381). */\n  assetCandidates?: AssetCandidates\n  /**\n   * THE validation option bag (EC-497) — the studio session's\n   * `gateValidateOptions(...)`, whole. It also carries the project's\n   * `localeConfig`, which is what the unknown-locale targeting check reads: one\n   * source for \"which locales exist\", not two that can disagree.\n   */\n  validateOptions?: ValidateDocumentOptions\n}\n\n/** The `before` snapshot the review diff renders against. */\nexport interface UpdateBeforeSnapshot {\n  values: FieldValues\n  localized?: Record<string, FieldValues>\n}\n\nexport type BuildUpdateProposalResult =\n  | {\n      ok: true\n      kind: 'proposal'\n      /** The MERGED document as a patch (full values; the diff shows changed fields only). */\n      patch: ContentPatch\n      /**\n       * EC-595 A2 — the proposal as the positions it changes (a field's bucket, or one\n       * block prop by node id): what an accepted proposal persists, so applying it\n       * never overwrites a change made to any other position since it was built.\n       */\n      patches: DocumentPatch[]\n      before: UpdateBeforeSnapshot\n      /** Human-readable descriptors of the changed fields (e.g. `title (de)`). */\n      changedFields: string[]\n      /** Non-error issues on the accepted result (warnings). */\n      issues: CmsValidationIssue[]\n    }\n  | {\n      /** Every change resolved to the current values — nothing to propose. */\n      ok: true\n      kind: 'no-change'\n    }\n  | { ok: false; issues: CmsValidationIssue[] }\n\ntype ChangeIssue = { issue: CmsValidationIssue }\ntype ChangeOutcome = { doc: CmsDocument; patch: DocumentPatch } | ChangeIssue\n\nfunction isNonEmptyString(value: unknown): value is string {\n  return typeof value === 'string' && value.length > 0\n}\n\n// The present/absent-key field write is core's `writeField` (EC-580) — this module\n// used to carry a local copy of the editor's `setFieldValue` (\"Local here (not\n// imported)\", MODE F5b.bkt). The locale is resolved per change below: a localized\n// field always arrives with one (a missing one is an explicit issue first).\n\n/**\n * The read twin of core's `writeField`: the field's value in the resolved\n * `locale` bucket, or in the shared `values` for a non-localized field. The exact\n * bucket only, with no default-locale fallback, because that bucket is the one the\n * write replaces.\n */\nfunction readFieldValue(doc: CmsDocument, fieldName: string, locale: string | undefined): unknown {\n  return locale !== undefined ? doc.localized?.[locale]?.[fieldName] : doc.values[fieldName]\n}\n\n/**\n * Relation ids CURRENTLY on the document for a field (any locale bucket) — re-usable\n * without a search. EC-589: read off THE reference walk — the hits AT the field's own\n * position (the field, or one item of a list-valued field), never one nested deeper.\n */\nfunction currentRelationIds(doc: CmsDocument, fieldName: string): Set<string> {\n  const ids = new Set<string>()\n  walkReferences(doc, (hit) => {\n    if (hit.kind !== 'relation-field' || hit.target.type !== 'document') return\n    const [field, second] = hit.position\n    if (field?.kind !== 'field' || field.name !== fieldName) return\n    if (hit.position.length > (second?.kind === 'locale' ? 2 : 1)) return\n    if (hit.within.some((key) => typeof key === 'string')) return\n    ids.add(hit.target.ref.id)\n  })\n  return ids\n}\n\n/** Asset ids CURRENTLY on the document for a field (any bucket) — re-usable without a search (EC-381). */\nfunction currentAssetIds(doc: CmsDocument, fieldName: string): Set<string> {\n  const ids = new Set<string>()\n  const collect = (value: unknown) => {\n    for (const entry of Array.isArray(value) ? value : [value]) {\n      const id = readAssetId(entry)\n      if (id) ids.add(id)\n    }\n  }\n  collect(doc.values[fieldName])\n  for (const bucket of Object.values(doc.localized ?? {})) collect(bucket[fieldName])\n  return ids\n}\n\n/**\n * Map a change's raw value into the stored value shape (envelopes; loud leash).\n * `document` is the ORIGINAL document, which is what the id leash reads. `current`\n * is the value this change replaces, taken from the resolved locale bucket of the\n * working copy. The asset sub-field carry reads it (EC-558).\n */\nfunction mapUpdateValue(\n  field: FieldDef,\n  change: UpdateFieldChange,\n  document: CmsDocument,\n  current: unknown,\n  input: BuildUpdateProposalInput,\n  issue: (code: Parameters<typeof cmsIssue>[0]['code'], message: string) => ChangeIssue,\n): { value: unknown } | ChangeIssue {\n  const raw = change.value\n  if (raw === undefined || raw === null) return { value: undefined } // clear\n  switch (field.type) {\n    case 'relation': {\n      const ids = Array.isArray(raw) ? raw : [raw]\n      if (!ids.every(isNonEmptyString)) {\n        return issue(\n          'invalid-field-value',\n          `Relation \"${field.name}\" takes document id string(s) from searchDocuments results.`,\n        )\n      }\n      // The id leash (same stance as the create enum, but LOUD): only searched\n      // candidate ids or ids already on the document are usable.\n      const allowed = new Set([\n        ...(input.candidates?.[field.name] ?? []).map((c) => c.id),\n        ...currentRelationIds(document, field.name),\n      ])\n      const unknown = ids.filter((id) => !allowed.has(id))\n      if (unknown.length > 0) {\n        return issue(\n          'unknown-relation-target',\n          `Relation \"${field.name}\" may only use ids from searchDocuments results — search \"${field.target}\" first (got: ${unknown.join(', ')}).`,\n        )\n      }\n      if (!field.multiple && ids.length > 1) {\n        return issue('invalid-field-value', `Field \"${field.name}\" holds a single reference — pass one id.`)\n      }\n      const refs = ids.map((id) => referenceNode({ collection: field.target, id }))\n      return { value: field.multiple ? refs : refs[0] }\n    }\n    case 'asset': {\n      const ids = Array.isArray(raw) ? raw : [raw]\n      if (!ids.every(isNonEmptyString)) {\n        return issue(\n          'invalid-field-value',\n          `Asset field \"${field.name}\" takes asset id string(s) from listAssets results.`,\n        )\n      }\n      // EC-381 — the asset id leash (same stance as relations, but LOUD): only\n      // searched library candidate ids or ids already on the document are usable;\n      // the assistant never invents or uploads an asset.\n      const allowed = new Set([\n        ...(input.assetCandidates?.[field.name] ?? []).map((c) => c.id),\n        ...currentAssetIds(document, field.name),\n      ])\n      const unknown = ids.filter((id) => !allowed.has(id))\n      if (unknown.length > 0) {\n        return issue(\n          'unknown-asset',\n          `Asset field \"${field.name}\" may only use ids from listAssets results — search the media library first (got: ${unknown.join(', ')}).`,\n        )\n      }\n      if (!field.multiple && ids.length > 1) {\n        return issue('invalid-field-value', `Field \"${field.name}\" holds a single asset — pass one id.`)\n      }\n      // EC-558: replace-with-list through the one carry rule. A held id keeps its\n      // placement's per-use sub-fields (a caption, say), a single swap carries\n      // them to the new image, and a NEW id is an envelope (EC-381). Data about\n      // the image itself (alt, an AI flag) belongs on the asset's `meta`.\n      return {\n        value: carryAssetPlacements(\n          current,\n          field.multiple ? { multiple: true, ids } : { multiple: false, id: ids[0] ?? null },\n        ),\n      }\n    }\n    case 'richText': {\n      // EC-379: a string value is MARKDOWN, converted through the engine's strict\n      // subset converter; out-of-subset constructs fail LOUD (the model retries\n      // in-conversation). A `{ version, doc }` envelope object stays accepted for\n      // robustness (getDocument may have shown one) — see rich-text-input.ts.\n      const converted = richTextValueFromModelInput(raw)\n      if (!converted.ok) {\n        return issue('invalid-field-value', `Field \"${field.name}\": ${converted.problems.join(' ')}`)\n      }\n      return { value: converted.value }\n    }\n    default:\n      // text / number / boolean / date / select / object / blocks: as sent. The\n      // write below (`writeField`) canonicalises it (EC-586: a date into one UTC\n      // instant, a multi-select scalar into a list, an empty list absent), and the\n      // merged document's validateDocument run is the shape leash.\n      return { value: raw }\n  }\n}\n\n/** Change one component prop of one root block (the `BlockChange`/`PropChange` address). */\nfunction applyBlockPropChange(\n  collection: CollectionDef,\n  doc: CmsDocument,\n  field: FieldDef,\n  change: UpdateFieldChange,\n  locale: string | undefined,\n  issue: (code: Parameters<typeof cmsIssue>[0]['code'], message: string) => ChangeIssue,\n): ChangeOutcome {\n  if (field.type !== 'blocks') {\n    return issue(\n      'invalid-field-value',\n      `\"${change.field}\" is not a blocks field — omit \"blockId\"/\"prop\" (set the field value directly).`,\n    )\n  }\n  if (!isNonEmptyString(change.blockId)) {\n    return issue(\n      'invalid-field-value',\n      `Changing a block on \"${change.field}\" needs \"blockId\" — block ids come from getDocument.`,\n    )\n  }\n  if (!isNonEmptyString(change.prop)) {\n    return issue(\n      'invalid-field-value',\n      `Changing block \"${change.blockId}\" needs \"prop\" — the component property to change.`,\n    )\n  }\n  const original = readFieldValue(doc, change.field, locale)\n  const blocks = blockRootsOf(original)\n  const index = blocks.findIndex((block) => block.id === change.blockId)\n  if (index < 0) {\n    return issue(\n      'invalid-field-value',\n      `Block \"${change.blockId}\" was not found on \"${change.field}\" — read the document first; block ids come from getDocument.`,\n    )\n  }\n  const block = blocks[index]!\n  const props = { ...(block.props ?? {}) }\n  if (change.value === undefined || change.value === null) delete props[change.prop]\n  else props[change.prop] = staticProp(change.value as JsonValue)\n  const nextBlock: ComponentNode = { ...block, props }\n  // EC-576: through the core write path — the other roots and every typography\n  // item keep their place, and the write is the v2 sequence. (`blocks` is\n  // `editBlockRoots`' own root list, so `index` addresses the same root.)\n  const value = editBlockRoots(original, (roots) => roots.map((b, i) => (i === index ? nextBlock : b)))\n  // EC-595 A2: one block prop, by node id — the position this change wrote.\n  const path = nodePropPath(change.field, locale, change.blockId, change.prop)\n  const patch: DocumentPatch =\n    change.value === undefined || change.value === null\n      ? { op: 'unset', path }\n      : { op: 'set', path, value: change.value }\n  return { doc: writeField(collection, doc, change.field, locale, value), patch }\n}\n\n/** Apply ONE change to a (copy of the) document, or report the targeting issue. */\nfunction applyOneChange(\n  input: BuildUpdateProposalInput,\n  doc: CmsDocument,\n  change: UpdateFieldChange,\n): ChangeOutcome {\n  const { collection } = input\n  const issue = (\n    code: Parameters<typeof cmsIssue>[0]['code'],\n    message: string,\n  ): ChangeIssue => ({\n    issue: cmsIssue({\n      code,\n      message,\n      path: ['documents', `${collection.id}:${doc.id}`, 'values', change.field],\n      collectionId: collection.id,\n      documentId: doc.id,\n      meta: { field: change.field, ...(change.locale !== undefined ? { locale: change.locale } : {}) },\n    }),\n  })\n\n  const field = collection.fields.find((f) => f.name === change.field)\n  if (!field) {\n    return issue(\n      'invalid-field-value',\n      `Unknown field \"${change.field}\" on collection \"${collection.id}\" — use a field name from the schema.`,\n    )\n  }\n  if (field.ai?.exclude) {\n    return issue('invalid-field-value', `Field \"${change.field}\" must not be edited by the assistant.`)\n  }\n\n  const localized = isFieldLocalized(collection, change.field)\n  if (!localized && change.locale !== undefined) {\n    return issue('unknown-locale', `Field \"${change.field}\" is not localized — omit \"locale\".`)\n  }\n  if (\n    change.locale !== undefined &&\n    input.validateOptions?.localeConfig &&\n    !input.validateOptions.localeConfig.locales.includes(change.locale)\n  ) {\n    return issue(\n      'unknown-locale',\n      `Unknown locale \"${change.locale}\" — this project has: ${input.validateOptions?.localeConfig?.locales.join(', ')}.`,\n    )\n  }\n  const locale = localized ? change.locale ?? input.locale : undefined\n  if (localized && locale === undefined) {\n    return issue('missing-localized-value', `Field \"${change.field}\" is localized — provide \"locale\".`)\n  }\n\n  if (change.blockId !== undefined || change.prop !== undefined) {\n    return applyBlockPropChange(collection, doc, field, change, locale, issue)\n  }\n\n  const current = readFieldValue(doc, change.field, locale)\n  const mapped = mapUpdateValue(field, change, input.document, current, input, issue)\n  if ('issue' in mapped) return mapped\n  const written = writeField(collection, doc, change.field, locale, mapped.value)\n  return { doc: written, patch: fieldWritePatch(collection, written, change.field, locale) }\n}\n\n\n/**\n * Build the reviewable update proposal: apply every change over a copy of the\n * document (loud targeting), validate the merged result with the injected\n * leashes (only errors the change INTRODUCES block), and report the semantic\n * diff. `no-change` when the changes resolve to the current values.\n */\nexport function buildUpdateProposal(input: BuildUpdateProposalInput): BuildUpdateProposalResult {\n  const { registry, collection, document } = input\n\n  let next: CmsDocument = structuredClone(document)\n  const targetingIssues: CmsValidationIssue[] = []\n  const patches: DocumentPatch[] = []\n  for (const change of input.changes) {\n    const outcome = applyOneChange(input, next, change)\n    if ('issue' in outcome) targetingIssues.push(outcome.issue)\n    else {\n      next = outcome.doc\n      patches.push(outcome.patch)\n    }\n  }\n  if (targetingIssues.length > 0) return { ok: false, issues: targetingIssues }\n\n  // EC-497: THE bag, whole — no per-call-site reassembly.\n  const validateOptions: ValidateDocumentOptions = input.validateOptions ?? {}\n  const before = validateDocument(registry, document, validateOptions)\n  const issues = validateDocument(registry, next, validateOptions)\n  const introduced = introducedErrors(before, issues)\n  if (introduced.length > 0) return { ok: false, issues: introduced }\n\n  const diff = diffDocuments(collection, document, next)\n  if (diff.changes.length === 0) return { ok: true, kind: 'no-change' }\n\n  return {\n    ok: true,\n    kind: 'proposal',\n    patch: {\n      collection: collection.id,\n      id: document.id,\n      values: next.values,\n      ...(next.localized && Object.keys(next.localized).length > 0\n        ? { localized: next.localized }\n        : {}),\n    },\n    patches,\n    before: {\n      values: document.values,\n      ...(document.localized ? { localized: document.localized } : {}),\n    },\n    changedFields: diff.changes.map((change) =>\n      change.locale !== undefined ? `${change.field} (${change.locale})` : change.field,\n    ),\n    issues: warningsOf(issues),\n  }\n}\n"]}
+{"version":3,"file":"update-fields.js","sourceRoot":"","sources":["../../../src/lib/ai/update-fields.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `buildUpdateProposal` — the EC-378 update-proposal builder (the edit-flow\n * counterpart of `applyContentWithShape`, minus the generation step).\n *\n * The MODEL authors the field changes directly in the `updateFields` tool input\n * (it has the conversation + `getDocument` output as context); this module turns\n * those changes into a reviewable proposal with the SAME engine discipline the\n * create flow has:\n *\n *  - **merge semantics**: changes apply per field over the EXISTING document —\n *    never a whole-document rewrite; the patch is the merged document, the diff\n *    (`diffDocuments`) is what the editor reviews (changed fields only).\n *  - **targeting is addressed with the engine's existing conventions** — field\n *    name + optional locale bucket (the diff / `RestoreScope` shape) and, for a\n *    component inside a composition, `blockId` + `prop`: the component's node id\n *    at ANY depth the value-position traversal reaches (a top-level block, a child\n *    in a slot, a component embedded in rich text — EC-593). No new path grammar.\n *  - **one converter** (EC-593, closes EC-571): every value goes from its writer\n *    form to its stored form through `writer-form.ts` — the same fold create,\n *    translate and the read form use — so a nested markdown sub-field, a nested\n *    asset swap and a block's asset prop are converted, carried and leashed exactly\n *    as a top-level field is.\n *  - **leashes hold, loudly**: `ai.exclude` fields are untouchable; relation AND\n *    asset ids (EC-381) must come from searched candidates (`searchDocuments` /\n *    `listAssets`) or already be on the document — at every position; every\n *    targeting failure is an explicit issue — never a silent drop (unlike the\n *    create shape, which makes bad ids structurally unrepresentable, an update\n *    change is imperative — so it FAILS instead of being filtered).\n *  - **content, never structure** (ratified 4c): a composition's components are\n *    never added, removed or moved by the assistant — a whole-value write of a\n *    `blocks` field is refused with the way to change a prop instead, and a\n *    rich-text value must keep the components embedded in it.\n *  - **validation parity**: the merged document runs through `validateDocument`\n *    with the studio's injected leashes. Only errors the change INTRODUCES block\n *    the proposal — pre-existing brokenness on the document is not the\n *    assistant's doing and must not force a whole-document repair (the editor's\n *    own save path tolerates it the same way; errors gate publish, not drafts).\n *\n * Locale-awareness: a localized field's change lands in the change's `locale`,\n * defaulting to the editor's working locale (`input.locale`). Non-localized\n * fields reject a `locale` loudly. The value a change replaces is the DISPLAYED\n * value of that bucket (ratified 2c): a new locale bucket carries its placement\n * sub-fields — and a component prop change its whole composition — from the\n * fallback, exactly as the pickers do.\n *\n * Pure and deterministic — no provider, no I/O; the executor (`tools.ts`) wires\n * it to `getDocument` + the candidate store and hands the result to the review\n * sink.\n */\nimport {\n  cmsIssue,\n  isFieldLocalized,\n  isSequenceValue,\n  resolveField,\n  validateDocument,\n  writeField,\n} from '@elytracms/core/cms-core'\nimport { editBlockRoots } from '@elytracms/core/project-graph'\nimport type {\n  CmsDocument,\n  CmsValidationIssue,\n  CollectionDef,\n  CollectionRegistry,\n  DocumentPatch,\n  FieldDef,\n  FieldValues,\n  ValidateDocumentOptions,\n} from '@elytracms/core/cms-core'\nimport { diffDocuments } from '@elytracms/core/content'\nimport { introducedErrors, warningsOf } from './proposal-validation'\nimport { fieldWritePatch } from '../cms/field-patch'\nimport { fromWriterFieldValue, fromWriterFormAtNode, heldReferencesOf } from './writer-form'\nimport type { WriterFormContext, WriterFormProblem } from './writer-form'\nimport type { ContentPatch, WriterLeash } from './types'\n\n/**\n * One field change of an `updateFields` proposal, addressed with the engine's\n * existing conventions (diff / restore-scope): `field` (+ `locale` bucket for a\n * localized field), and for a component inside a composition optionally\n * `blockId` + `prop` to change one prop of that component — at any depth.\n * `value` is the new value (`null`/omitted clears the field or prop).\n */\nexport interface UpdateFieldChange {\n  field: string\n  /** Locale bucket for a LOCALIZED field (defaults to the editor's working locale). */\n  locale?: string\n  /** A component's stable node id (from `getDocument`) — at any depth: slots, rich-text embeds. */\n  blockId?: string\n  /** With `blockId`: the component prop to change. */\n  prop?: string\n  /** The new value; `null` / omitted clears the field or prop. */\n  value?: unknown\n}\n\nexport interface BuildUpdateProposalInput {\n  registry: CollectionRegistry\n  collection: CollectionDef\n  /** The CURRENT document — the proposal's \"before\" side. Never mutated. */\n  document: CmsDocument\n  changes: readonly UpdateFieldChange[]\n  /** The editor's working locale — the default bucket for localized fields. */\n  locale?: string\n  /**\n   * THE id leash at every position (EC-381 → EC-593): what the model searched this\n   * conversation. An id that is neither searched nor already on the document fails.\n   */\n  leash?: WriterLeash\n  /**\n   * THE validation option bag (EC-497) — the studio session's\n   * `gateValidateOptions(...)`, whole. It also carries the project's\n   * `localeConfig` — what the unknown-locale targeting check and the displayed-value\n   * carry read — and the `lookupManifest` the converter reaches component props\n   * through: one source for \"which locales exist\" and \"which props a component\n   * declares\", not two that can disagree.\n   */\n  validateOptions?: ValidateDocumentOptions\n}\n\n/** The `before` snapshot the review diff renders against. */\nexport interface UpdateBeforeSnapshot {\n  values: FieldValues\n  localized?: Record<string, FieldValues>\n}\n\nexport type BuildUpdateProposalResult =\n  | {\n      ok: true\n      kind: 'proposal'\n      /** The MERGED document as a patch (full values; the diff shows changed fields only). */\n      patch: ContentPatch\n      /**\n       * EC-595 A2 — the proposal as the positions it changes (a field's bucket, or one\n       * component prop by node path): what an accepted proposal persists, so applying it\n       * never overwrites a change made to any other position since it was built.\n       */\n      patches: DocumentPatch[]\n      before: UpdateBeforeSnapshot\n      /** Human-readable descriptors of the changed fields (e.g. `title (de)`). */\n      changedFields: string[]\n      /** Non-error issues on the accepted result (warnings). */\n      issues: CmsValidationIssue[]\n    }\n  | {\n      /** Every change resolved to the current values — nothing to propose. */\n      ok: true\n      kind: 'no-change'\n    }\n  | { ok: false; issues: CmsValidationIssue[] }\n\ntype ChangeIssues = { issues: CmsValidationIssue[] }\ntype ChangeOutcome = { doc: CmsDocument; patch: DocumentPatch } | ChangeIssues\ntype IssueCode = Parameters<typeof cmsIssue>[0]['code']\n\nfunction isNonEmptyString(value: unknown): value is string {\n  return typeof value === 'string' && value.length > 0\n}\n\n// The present/absent-key field write is core's `writeField` (EC-580) — this module\n// used to carry a local copy of the editor's `setFieldValue` (\"Local here (not\n// imported)\", MODE F5b.bkt). The locale is resolved per change below: a localized\n// field always arrives with one (a missing one is an explicit issue first).\n\n/**\n * The value a change REPLACES (ratified 2c, EC-593): the DISPLAYED value of the field in\n * the resolved bucket — core's `resolveField`, the rule every editor surface reads — so a\n * new locale bucket carries its placement sub-fields (and a component prop change its\n * composition) from the fallback, as the pickers do. It used to be the exact bucket only.\n * Without a locale config there is no fallback to display: the bucket itself.\n */\nfunction displayedFieldValue(\n  input: BuildUpdateProposalInput,\n  doc: CmsDocument,\n  fieldName: string,\n  locale: string | undefined,\n): unknown {\n  if (locale === undefined) return doc.values[fieldName]\n  const config = input.validateOptions?.localeConfig\n  return config\n    ? resolveField(input.collection, doc, fieldName, locale, config).value\n    : doc.localized?.[locale]?.[fieldName]\n}\n\n/** Apply ONE change to a (copy of the) document, or report the targeting issues. */\nfunction applyOneChange(\n  input: BuildUpdateProposalInput,\n  ctx: WriterFormContext,\n  doc: CmsDocument,\n  change: UpdateFieldChange,\n): ChangeOutcome {\n  const { collection } = input\n  const issueAt = (code: IssueCode, message: string, at: readonly (string | number)[] = []): CmsValidationIssue =>\n    cmsIssue({\n      code,\n      message,\n      path: ['documents', `${collection.id}:${doc.id}`, 'values', change.field, ...at],\n      collectionId: collection.id,\n      documentId: doc.id,\n      meta: { field: change.field, ...(change.locale !== undefined ? { locale: change.locale } : {}) },\n    })\n  const issue = (code: IssueCode, message: string): ChangeIssues => ({ issues: [issueAt(code, message)] })\n  const fromProblems = (problems: readonly WriterFormProblem[]): ChangeIssues => ({\n    issues: problems.map((problem) => issueAt(problem.code, problem.message, problem.at)),\n  })\n\n  const field = collection.fields.find((f) => f.name === change.field)\n  if (!field) {\n    return issue(\n      'invalid-field-value',\n      `Unknown field \"${change.field}\" on collection \"${collection.id}\" — use a field name from the schema.`,\n    )\n  }\n  if (field.ai?.exclude) {\n    return issue('invalid-field-value', `Field \"${change.field}\" must not be edited by the assistant.`)\n  }\n\n  const localized = isFieldLocalized(collection, change.field)\n  if (!localized && change.locale !== undefined) {\n    return issue('unknown-locale', `Field \"${change.field}\" is not localized — omit \"locale\".`)\n  }\n  if (\n    change.locale !== undefined &&\n    input.validateOptions?.localeConfig &&\n    !input.validateOptions.localeConfig.locales.includes(change.locale)\n  ) {\n    return issue(\n      'unknown-locale',\n      `Unknown locale \"${change.locale}\" — this project has: ${input.validateOptions?.localeConfig?.locales.join(', ')}.`,\n    )\n  }\n  const locale = localized ? change.locale ?? input.locale : undefined\n  if (localized && locale === undefined) {\n    return issue('missing-localized-value', `Field \"${change.field}\" is localized — provide \"locale\".`)\n  }\n\n  const displayed = displayedFieldValue(input, doc, change.field, locale)\n  // The converter already wrote every value it changed in its stored form. The write\n  // does not re-canonicalise component props (no manifest lookup): that would rewrite\n  // the prop wrappers of every UNTOUCHED node too, and a proposal must change only what\n  // it changes (the persister canonicalises on save, as for every editor write).\n  const write = (value: unknown): { doc: CmsDocument; patch: DocumentPatch } => {\n    const written = writeField(collection, doc, change.field, locale, value)\n    return { doc: written, patch: fieldWritePatch(collection, written, change.field, locale) }\n  }\n\n  if (change.blockId !== undefined || change.prop !== undefined) {\n    // A bucket that does not hold the field yet is written whole (from its displayed\n    // fallback): a node path into it would address a node that is not there.\n    const ownsBucket = locale === undefined || change.field in (doc.localized?.[locale] ?? {})\n    return applyNodePropChange(field, change, displayed, locale, ownsBucket, ctx, issue, fromProblems, write)\n  }\n\n  // EC-593: the ONE writer-form converter, at every depth (EC-571: this path used to\n  // convert top-level rich text only and store a nested markdown string raw).\n  const converted = fromWriterFieldValue(field, change.value, displayed, ctx, locale)\n  if (converted.problems.length > 0) return fromProblems(converted.problems)\n  return write(converted.value)\n}\n\n/**\n * Change one component prop, addressed by node id at any depth (EC-593: it used to be a\n * ROOT block of a `blocks` field only, written verbatim — no carry, no leash, no\n * markdown conversion, and the persisted patch carried the RAW model value).\n */\nfunction applyNodePropChange(\n  field: FieldDef,\n  change: UpdateFieldChange,\n  displayed: unknown,\n  locale: string | undefined,\n  ownsBucket: boolean,\n  ctx: WriterFormContext,\n  issue: (code: IssueCode, message: string) => ChangeIssues,\n  fromProblems: (problems: readonly WriterFormProblem[]) => ChangeIssues,\n  write: (value: unknown) => { doc: CmsDocument; patch: DocumentPatch },\n): ChangeOutcome {\n  if (!isNonEmptyString(change.blockId)) {\n    return issue(\n      'invalid-field-value',\n      `Changing a component on \"${change.field}\" needs \"blockId\" — component ids come from getDocument.`,\n    )\n  }\n  if (!isNonEmptyString(change.prop)) {\n    return issue(\n      'invalid-field-value',\n      `Changing component \"${change.blockId}\" needs \"prop\" — the component property to change.`,\n    )\n  }\n  // EC-576 tolerant read (reseed gate, EC-576 step 4 deletes it with the other legacy\n  // blocks readers): a pre-0.0.84 bare node / node list is lifted into the v2 sequence\n  // the traversal reads — and the write is that sequence (no writer re-emits the bare shape).\n  const composition =\n    field.type === 'blocks' && displayed !== undefined && !isSequenceValue(displayed)\n      ? editBlockRoots(displayed, (roots) => roots)\n      : displayed\n  const result = fromWriterFormAtNode(field, composition, change.blockId, change.prop, change.value, ctx, locale)\n  if (!result.ok) return issue('invalid-field-value', result.message)\n  if (result.problems.length > 0) return fromProblems(result.problems)\n  const written = write(result.value)\n  // EC-595 A2: the position this change wrote — the prop by its node path, or (where the\n  // grammar does not reach the node, the bucket is new, or a legacy value was lifted)\n  // the field bucket, whole: a coarser path, never a wrong one.\n  if (!result.exact || !ownsBucket || composition !== displayed) return written\n  const patch: DocumentPatch =\n    result.propValue === undefined\n      ? { op: 'unset', path: result.path }\n      : { op: 'set', path: result.path, value: result.propValue }\n  return { doc: written.doc, patch }\n}\n\n/**\n * Build the reviewable update proposal: apply every change over a copy of the\n * document (loud targeting), validate the merged result with the injected\n * leashes (only errors the change INTRODUCES block), and report the semantic\n * diff. `no-change` when the changes resolve to the current values.\n */\nexport function buildUpdateProposal(input: BuildUpdateProposalInput): BuildUpdateProposalResult {\n  const { registry, collection, document } = input\n\n  let next: CmsDocument = structuredClone(document)\n  const targetingIssues: CmsValidationIssue[] = []\n  const patches: DocumentPatch[] = []\n  // EC-593: one converter context for every change — the validator's own prop lookup,\n  // the conversation's leash, and the ids the ORIGINAL document already references.\n  const ctx: WriterFormContext = {\n    ...(input.validateOptions?.lookupManifest ? { lookupManifest: input.validateOptions.lookupManifest } : {}),\n    ...(input.leash ? { leash: input.leash } : {}),\n    held: heldReferencesOf(document),\n  }\n  for (const change of input.changes) {\n    const outcome = applyOneChange(input, ctx, next, change)\n    if ('issues' in outcome) targetingIssues.push(...outcome.issues)\n    else {\n      next = outcome.doc\n      patches.push(outcome.patch)\n    }\n  }\n  if (targetingIssues.length > 0) return { ok: false, issues: targetingIssues }\n\n  // EC-497: THE bag, whole — no per-call-site reassembly.\n  const validateOptions: ValidateDocumentOptions = input.validateOptions ?? {}\n  const before = validateDocument(registry, document, validateOptions)\n  const issues = validateDocument(registry, next, validateOptions)\n  const introduced = introducedErrors(before, issues)\n  if (introduced.length > 0) return { ok: false, issues: introduced }\n\n  const diff = diffDocuments(collection, document, next)\n  if (diff.changes.length === 0) return { ok: true, kind: 'no-change' }\n\n  return {\n    ok: true,\n    kind: 'proposal',\n    patch: {\n      collection: collection.id,\n      id: document.id,\n      values: next.values,\n      ...(next.localized && Object.keys(next.localized).length > 0\n        ? { localized: next.localized }\n        : {}),\n    },\n    patches,\n    before: {\n      values: document.values,\n      ...(document.localized ? { localized: document.localized } : {}),\n    },\n    changedFields: diff.changes.map((change) =>\n      change.locale !== undefined ? `${change.field} (${change.locale})` : change.field,\n    ),\n    issues: warningsOf(issues),\n  }\n}\n"]}