@elytracms/studio 0.0.85 → 0.0.87

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  /** Target locale for localized fields (their values land under `localized[locale]`). */\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. `localeConfig` is\n   * overridden per generation (a create targets ONE locale), which is the single\n   * documented deviation and is written at the override, not implied by an\n   * omission.\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\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  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  /** Target locale for localized fields (their values land under `localized[locale]`). */\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. `localeConfig` is\n   * overridden per generation (a create targets ONE locale), which is the single\n   * documented deviation and is written at the override, not implied by an\n   * omission.\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.js

@@ -34,9 +34,10 @@
  * it to `getDocument` + the candidate store and hands the result to the review
  * sink.
  */
-import { assetNode, cmsIssue, isFieldLocalized, readAssetId, readDocumentRef, referenceNode, validateDocument, } from '@elytracms/core/cms-core';
-import { blockRootsOf, staticProp } from '@elytracms/core/project-graph';
+import { cmsIssue, isFieldLocalized, readAssetId, readDocumentRef, referenceNode, validateDocument, } from '@elytracms/core/cms-core';
+import { blockRootsOf, editBlockRoots, staticProp } 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 { richTextValueFromModelInput } from './rich-text-input.js';
 function isNonEmptyString(value) {
@@ -65,6 +66,15 @@ function writeFieldValue(doc, fieldName, locale, value) {
         values[fieldName] = value;
     return { ...doc, values };
 }
+/**
+ * The read twin of {@link writeFieldValue}: 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.
+ */
+function readFieldValue(doc, fieldName, locale) {
+    return locale !== undefined ? doc.localized?.[locale]?.[fieldName] : doc.values[fieldName];
+}
 /** Relation ids CURRENTLY on the document for a field (any bucket) — re-usable without a search. */
 function currentRelationIds(doc, fieldName) {
     const ids = new Set();
@@ -95,8 +105,13 @@ function currentAssetIds(doc, fieldName) {
         collect(bucket[fieldName]);
     return ids;
 }
-/** Map a change's raw value into the stored value shape (envelopes; loud leash). */
-function mapUpdateValue(field, change, document, input, issue) {
+/**
+ * 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
@@ -141,8 +156,13 @@ function mapUpdateValue(field, change, document, input, issue) {
             if (!field.multiple && ids.length > 1) {
                 return issue('invalid-field-value', `Field "${field.name}" holds a single asset — pass one id.`);
             }
-            const nodes = ids.map((id) => assetNode(id));
-            return { value: field.multiple ? nodes : nodes[0] };
+            // 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 }, 'envelope'),
+            };
         }
         case 'richText': {
             // EC-379: a string value is MARKDOWN, converted through the engine's strict
@@ -172,8 +192,7 @@ function applyBlockPropChange(doc, field, change, locale, issue) {
     if (!isNonEmptyString(change.prop)) {
         return issue('invalid-field-value', `Changing block "${change.blockId}" needs "prop" — the component property to change.`);
     }
-    const bucket = locale !== undefined ? doc.localized?.[locale] : doc.values;
-    const original = bucket?.[change.field];
+    const original = readFieldValue(doc, change.field, locale);
     const blocks = blockRootsOf(original);
     const index = blocks.findIndex((block) => block.id === change.blockId);
     if (index < 0) {
@@ -186,9 +205,10 @@ function applyBlockPropChange(doc, field, change, locale, issue) {
     else
         props[change.prop] = staticProp(change.value);
     const nextBlock = { ...block, props };
-    const nextBlocks = blocks.map((b, i) => (i === index ? nextBlock : b));
-    // Preserve the stored shape: an array for a `multiple` composition, a bare node otherwise.
-    const value = Array.isArray(original) ? nextBlocks : nextBlocks[0];
+    // 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)));
     return { doc: writeFieldValue(doc, change.field, locale, value) };
 }
 /** Apply ONE change to a (copy of the) document, or report the targeting issue. */
@@ -227,7 +247,8 @@ function applyOneChange(input, doc, change) {
     if (change.blockId !== undefined || change.prop !== undefined) {
         return applyBlockPropChange(doc, field, change, locale, issue);
     }
-    const mapped = mapUpdateValue(field, change, input.document, input, issue);
+    const current = readFieldValue(doc, change.field, locale);
+    const mapped = mapUpdateValue(field, change, input.document, current, input, issue);
     if ('issue' in mapped)
         return mapped;
     return { doc: writeFieldValue(doc, change.field, locale, mapped.value) };

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  assetNode,\n  cmsIssue,\n  isFieldLocalized,\n  readAssetId,\n  readDocumentRef,\n  referenceNode,\n  validateDocument,\n} from '@elytracms/core/cms-core'\nimport type {\n  CmsDocument,\n  CmsValidationIssue,\n  CollectionDef,\n  CollectionRegistry,\n  FieldDef,\n  FieldValues,\n  ValidateDocumentOptions,\n} from '@elytracms/core/cms-core'\nimport { blockRootsOf, staticProp } from '@elytracms/core/project-graph'\nimport type { ComponentNode, JsonValue } from '@elytracms/core/project-graph'\nimport { diffDocuments } from '@elytracms/core/content'\nimport { introducedErrors, warningsOf } from './proposal-validation'\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      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 } | ChangeIssue\n\nfunction isNonEmptyString(value: unknown): value is string {\n  return typeof value === 'string' && value.length > 0\n}\n\n/**\n * The present/absent-key field write — the same semantics as the editor's\n * single-sourced `setFieldValue` (`lib/locale/fallback`): a resolved `locale`\n * writes the `localized[locale]` bucket, clearing DELETES the key. Local here\n * (not imported) because this module takes the locale as an already-resolved\n * argument per change; the semantics are pinned by tests on both sides.\n */\nfunction writeFieldValue(\n  doc: CmsDocument,\n  fieldName: string,\n  locale: string | undefined,\n  value: unknown,\n): CmsDocument {\n  if (locale !== undefined) {\n    const perLocale = { ...(doc.localized?.[locale] ?? {}) }\n    if (value === undefined) delete perLocale[fieldName]\n    else perLocale[fieldName] = value\n    return { ...doc, localized: { ...doc.localized, [locale]: perLocale } }\n  }\n  const values = { ...doc.values }\n  if (value === undefined) delete values[fieldName]\n  else values[fieldName] = value\n  return { ...doc, values }\n}\n\n/** Relation ids CURRENTLY on the document for a field (any bucket) — re-usable without a search. */\nfunction currentRelationIds(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 ref = readDocumentRef(entry)\n      if (ref) ids.add(ref.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/** 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/** Map a change's raw value into the stored value shape (envelopes; loud leash). */\nfunction mapUpdateValue(\n  field: FieldDef,\n  change: UpdateFieldChange,\n  document: CmsDocument,\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      const nodes = ids.map((id) => assetNode(id))\n      return { value: field.multiple ? nodes : nodes[0] }\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-is\n      // (the 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  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 bucket = locale !== undefined ? doc.localized?.[locale] : doc.values\n  const original = bucket?.[change.field]\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  const nextBlocks = blocks.map((b, i) => (i === index ? nextBlock : b))\n  // Preserve the stored shape: an array for a `multiple` composition, a bare node otherwise.\n  const value = Array.isArray(original) ? nextBlocks : nextBlocks[0]\n  return { doc: writeFieldValue(doc, change.field, locale, value) }\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(doc, field, change, locale, issue)\n  }\n\n  const mapped = mapUpdateValue(field, change, input.document, input, issue)\n  if ('issue' in mapped) return mapped\n  return { doc: writeFieldValue(doc, change.field, locale, mapped.value) }\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  for (const change of input.changes) {\n    const outcome = applyOneChange(input, next, change)\n    if ('issue' in outcome) targetingIssues.push(outcome.issue)\n    else next = outcome.doc\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    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, 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  readAssetId,\n  readDocumentRef,\n  referenceNode,\n  validateDocument,\n} from '@elytracms/core/cms-core'\nimport type {\n  CmsDocument,\n  CmsValidationIssue,\n  CollectionDef,\n  CollectionRegistry,\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 { 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      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 } | ChangeIssue\n\nfunction isNonEmptyString(value: unknown): value is string {\n  return typeof value === 'string' && value.length > 0\n}\n\n/**\n * The present/absent-key field write — the same semantics as the editor's\n * single-sourced `setFieldValue` (`lib/locale/fallback`): a resolved `locale`\n * writes the `localized[locale]` bucket, clearing DELETES the key. Local here\n * (not imported) because this module takes the locale as an already-resolved\n * argument per change; the semantics are pinned by tests on both sides.\n */\nfunction writeFieldValue(\n  doc: CmsDocument,\n  fieldName: string,\n  locale: string | undefined,\n  value: unknown,\n): CmsDocument {\n  if (locale !== undefined) {\n    const perLocale = { ...(doc.localized?.[locale] ?? {}) }\n    if (value === undefined) delete perLocale[fieldName]\n    else perLocale[fieldName] = value\n    return { ...doc, localized: { ...doc.localized, [locale]: perLocale } }\n  }\n  const values = { ...doc.values }\n  if (value === undefined) delete values[fieldName]\n  else values[fieldName] = value\n  return { ...doc, values }\n}\n\n/**\n * The read twin of {@link writeFieldValue}: 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/** Relation ids CURRENTLY on the document for a field (any bucket) — re-usable without a search. */\nfunction currentRelationIds(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 ref = readDocumentRef(entry)\n      if (ref) ids.add(ref.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/** 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          'envelope',\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-is\n      // (the 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  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  return { doc: writeFieldValue(doc, change.field, locale, value) }\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(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  return { doc: writeFieldValue(doc, change.field, locale, mapped.value) }\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  for (const change of input.changes) {\n    const outcome = applyOneChange(input, next, change)\n    if ('issue' in outcome) targetingIssues.push(outcome.issue)\n    else next = outcome.doc\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    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"]}

package/dist/lib/assets/asset-placements.d.ts

@@ -0,0 +1,35 @@
+/**
+ * How a writer spells a BRAND-NEW placement, which has no sub-fields yet. This is
+ * the caller's choice, not part of the carry rule. The detail editor and the table
+ * cell use `'bare'` on a field without sub-fields and `'envelope'` on one with them
+ * (`assetPickForm`). AI always uses `'envelope'` (EC-381).
+ */
+export type NewPlacementForm = 'bare' | 'envelope';
+/** The ids the field should hold next. The shape follows the field's cardinality. */
+export type AssetPlacementTarget = {
+    multiple: false;
+    id: string | null;
+} | {
+    multiple: true;
+    ids: readonly string[];
+};
+/**
+ * Return the field's next value with every placement's per-use sub-fields kept.
+ *
+ * - **Single field.** The placement's sub-fields carry over to whatever id now fills
+ *   it, so swapping the image keeps the caption. Re-picking the same id is a no-op,
+ *   and `null` clears the field (`undefined`).
+ * - **Multiple field.** An id the value already held keeps its entry verbatim, with
+ *   its sub-fields and its form (a bare id stays bare). Entries are matched in order,
+ *   so an image placed twice keeps both placements. An id the value did not hold
+ *   becomes a new placement in `form`. A held entry whose id is not in `ids` is
+ *   removed.
+ *
+ * The rule carries every key except `type`/`id`, the same set that `assetSubfieldsOf`
+ * reads. That includes keys the config no longer declares (AD-14: the schema is a
+ * lens, so a writer never deletes what the lens does not show).
+ *
+ * When nothing changes it returns `current` itself (the same reference), so a caller
+ * can skip the write.
+ */
+export declare function carryAssetPlacements(current: unknown, next: AssetPlacementTarget, form: NewPlacementForm): unknown;

package/dist/lib/assets/asset-placements.js

@@ -0,0 +1,74 @@
+/**
+ * The per-use sub-field carry rule for an asset field's value (EC-558).
+ *
+ * An asset field that declares per-use sub-fields (EC-301) stores envelopes such as
+ * `{ type: 'asset', id, caption }`. Those sub-fields are PLACEMENT data: they
+ * describe this use of the image, not the image itself (owner ruling 2026-09-26;
+ * data that describes the image belongs on the asset record's `meta`). A writer
+ * that changes which image a placement shows must therefore keep the placement's
+ * sub-fields. Before EC-558 only the detail editor did that. The table cell and AI
+ * `updateFields` rebuilt the value from bare ids and lost them.
+ *
+ * {@link carryAssetPlacements} is the one declaration of that rule. Two operations
+ * go through it:
+ *  - **append / pick**: the table cell and the detail editor
+ *    (`applyAssetSelection` / `appendAssetSelections` in
+ *    `components/assets/asset-selection.ts`). The next list is the held list plus
+ *    the picked ids, and a single field swaps its one placement's image.
+ *  - **replace-with-list**: AI `updateFields` (`lib/ai/update-fields.ts`). The next
+ *    list is the list the model sent.
+ *
+ * It lives in `lib/` because `lib/ai` may not import from `components/`, and both
+ * sides need it. Its only dependency is `@elytracms/core/cms-core`, so the AI host
+ * route pulls in nothing from the browser. Its natural home is next to `assetNode`
+ * in `core/cms-core/envelopes.ts`. Move it there if a writer outside the studio
+ * (import, CLI, MCP) appears.
+ */
+import { assetNode, assetSubfieldsOf, readAssetId } from '@elytracms/core/cms-core';
+function newPlacement(id, form) {
+    return form === 'envelope' ? assetNode(id) : id;
+}
+/**
+ * Return the field's next value with every placement's per-use sub-fields kept.
+ *
+ * - **Single field.** The placement's sub-fields carry over to whatever id now fills
+ *   it, so swapping the image keeps the caption. Re-picking the same id is a no-op,
+ *   and `null` clears the field (`undefined`).
+ * - **Multiple field.** An id the value already held keeps its entry verbatim, with
+ *   its sub-fields and its form (a bare id stays bare). Entries are matched in order,
+ *   so an image placed twice keeps both placements. An id the value did not hold
+ *   becomes a new placement in `form`. A held entry whose id is not in `ids` is
+ *   removed.
+ *
+ * The rule carries every key except `type`/`id`, the same set that `assetSubfieldsOf`
+ * reads. That includes keys the config no longer declares (AD-14: the schema is a
+ * lens, so a writer never deletes what the lens does not show).
+ *
+ * When nothing changes it returns `current` itself (the same reference), so a caller
+ * can skip the write.
+ */
+export function carryAssetPlacements(current, next, form) {
+    if (!next.multiple) {
+        if (next.id === null)
+            return undefined;
+        // `singleAssetIdOf` tolerates a legacy one-item array on a single field, so read
+        // its placement the same way.
+        const held = Array.isArray(current) ? current[0] : current;
+        if (readAssetId(held) === next.id)
+            return current;
+        const subfields = assetSubfieldsOf(held);
+        return Object.keys(subfields).length > 0 ? assetNode(next.id, subfields) : newPlacement(next.id, form);
+    }
+    const held = Array.isArray(current) ? current : [];
+    const used = new Set();
+    const out = next.ids.map((id) => {
+        const index = held.findIndex((entry, i) => !used.has(i) && readAssetId(entry) === id);
+        if (index < 0)
+            return newPlacement(id, form);
+        used.add(index);
+        return held[index];
+    });
+    const unchanged = out.length === held.length && out.every((entry, i) => entry === held[i]);
+    return unchanged && Array.isArray(current) ? current : out;
+}
+//# sourceMappingURL=asset-placements.js.map

package/dist/lib/assets/asset-placements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-placements.js","sourceRoot":"","sources":["../../../src/lib/assets/asset-placements.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAenF,SAAS,YAAY,CAAC,EAAU,EAAE,IAAsB;IACtD,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AACjD,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAgB,EAChB,IAA0B,EAC1B,IAAsB;IAEtB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnB,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI;YAAE,OAAO,SAAS,CAAA;QACtC,iFAAiF;QACjF,8BAA8B;QAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;QAC1D,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE;YAAE,OAAO,OAAO,CAAA;QACjD,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAA;QACxC,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;IACxG,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAE,OAAqB,CAAC,CAAC,CAAC,EAAE,CAAA;IACjE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA;QACrF,IAAI,KAAK,GAAG,CAAC;YAAE,OAAO,YAAY,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;QAC5C,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QACf,OAAO,IAAI,CAAC,KAAK,CAAC,CAAA;IACpB,CAAC,CAAC,CAAA;IACF,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;IAC1F,OAAO,SAAS,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAA;AAC5D,CAAC","sourcesContent":["/**\n * The per-use sub-field carry rule for an asset field's value (EC-558).\n *\n * An asset field that declares per-use sub-fields (EC-301) stores envelopes such as\n * `{ type: 'asset', id, caption }`. Those sub-fields are PLACEMENT data: they\n * describe this use of the image, not the image itself (owner ruling 2026-09-26;\n * data that describes the image belongs on the asset record's `meta`). A writer\n * that changes which image a placement shows must therefore keep the placement's\n * sub-fields. Before EC-558 only the detail editor did that. The table cell and AI\n * `updateFields` rebuilt the value from bare ids and lost them.\n *\n * {@link carryAssetPlacements} is the one declaration of that rule. Two operations\n * go through it:\n *  - **append / pick**: the table cell and the detail editor\n *    (`applyAssetSelection` / `appendAssetSelections` in\n *    `components/assets/asset-selection.ts`). The next list is the held list plus\n *    the picked ids, and a single field swaps its one placement's image.\n *  - **replace-with-list**: AI `updateFields` (`lib/ai/update-fields.ts`). The next\n *    list is the list the model sent.\n *\n * It lives in `lib/` because `lib/ai` may not import from `components/`, and both\n * sides need it. Its only dependency is `@elytracms/core/cms-core`, so the AI host\n * route pulls in nothing from the browser. Its natural home is next to `assetNode`\n * in `core/cms-core/envelopes.ts`. Move it there if a writer outside the studio\n * (import, CLI, MCP) appears.\n */\nimport { assetNode, assetSubfieldsOf, readAssetId } from '@elytracms/core/cms-core'\n\n/**\n * How a writer spells a BRAND-NEW placement, which has no sub-fields yet. This is\n * the caller's choice, not part of the carry rule. The detail editor and the table\n * cell use `'bare'` on a field without sub-fields and `'envelope'` on one with them\n * (`assetPickForm`). AI always uses `'envelope'` (EC-381).\n */\nexport type NewPlacementForm = 'bare' | 'envelope'\n\n/** The ids the field should hold next. The shape follows the field's cardinality. */\nexport type AssetPlacementTarget =\n  | { multiple: false; id: string | null }\n  | { multiple: true; ids: readonly string[] }\n\nfunction newPlacement(id: string, form: NewPlacementForm): unknown {\n  return form === 'envelope' ? assetNode(id) : id\n}\n\n/**\n * Return the field's next value with every placement's per-use sub-fields kept.\n *\n * - **Single field.** The placement's sub-fields carry over to whatever id now fills\n *   it, so swapping the image keeps the caption. Re-picking the same id is a no-op,\n *   and `null` clears the field (`undefined`).\n * - **Multiple field.** An id the value already held keeps its entry verbatim, with\n *   its sub-fields and its form (a bare id stays bare). Entries are matched in order,\n *   so an image placed twice keeps both placements. An id the value did not hold\n *   becomes a new placement in `form`. A held entry whose id is not in `ids` is\n *   removed.\n *\n * The rule carries every key except `type`/`id`, the same set that `assetSubfieldsOf`\n * reads. That includes keys the config no longer declares (AD-14: the schema is a\n * lens, so a writer never deletes what the lens does not show).\n *\n * When nothing changes it returns `current` itself (the same reference), so a caller\n * can skip the write.\n */\nexport function carryAssetPlacements(\n  current: unknown,\n  next: AssetPlacementTarget,\n  form: NewPlacementForm,\n): unknown {\n  if (!next.multiple) {\n    if (next.id === null) return undefined\n    // `singleAssetIdOf` tolerates a legacy one-item array on a single field, so read\n    // its placement the same way.\n    const held = Array.isArray(current) ? current[0] : current\n    if (readAssetId(held) === next.id) return current\n    const subfields = assetSubfieldsOf(held)\n    return Object.keys(subfields).length > 0 ? assetNode(next.id, subfields) : newPlacement(next.id, form)\n  }\n\n  const held = Array.isArray(current) ? (current as unknown[]) : []\n  const used = new Set<number>()\n  const out = next.ids.map((id) => {\n    const index = held.findIndex((entry, i) => !used.has(i) && readAssetId(entry) === id)\n    if (index < 0) return newPlacement(id, form)\n    used.add(index)\n    return held[index]\n  })\n  const unchanged = out.length === held.length && out.every((entry, i) => entry === held[i])\n  return unchanged && Array.isArray(current) ? current : out\n}\n"]}

package/dist/lib/assets/backfill-thumbs.d.ts

@@ -1,4 +1,4 @@
-import type { AssetRecord, AssetRepository, BlobStorageAdapter, NewAssetInput } from '@elytracms/core/persistence';
+import type { AssetRecord, AssetRepository, AssetWriteInput, BlobStorageAdapter } from '@elytracms/core/persistence';
 import type { GeneratedVariants, ThumbSource, VariantWant } from './thumbnail.js';
 /**
  * The assets that still need at least one variant (pure, node-tested idempotence
@@ -10,14 +10,15 @@ export declare function assetsNeedingVariants(assets: readonly AssetRecord[]): A
 /** The variants an asset is missing — what the per-variant backfill asks the encoder for. */
 export declare function variantWantFor(asset: AssetRecord): VariantWant;
 /**
- * The full upsert input that re-states an existing record with freshly generated
- * variants attached — the targeted patch path for the backfill, within the
- * existing repository/`assets.upsert` contract (EC-400 AD-4 / EC-420). Mirrors
- * `assetMetadataUpsertInput`: every current column is restated so the full-replace
- * upsert preserves it. A newly generated variant overlays; a variant the record
- * ALREADY had (the other half of a per-variant fill) is preserved from `current`.
+ * The asset write for a backfill result (EC-400 AD-4 / EC-420, EC-577): ONLY the
+ * variants just generated. Every other column is absent, so it keeps its stored
+ * value — including a variant the record already had (the other half of a
+ * per-variant fill) and any metadata an editor saved while the run was going. The
+ * restate this replaced wrote the whole listed record back, which overwrote such
+ * a concurrent edit with the stale listing — and re-created an asset deleted
+ * mid-run; now a write for a vanished asset is refused and counted `failed`.
  */
-export declare function assetVariantUpsertInput(current: AssetRecord, variants: GeneratedVariants): NewAssetInput;
+export declare function assetVariantWrite(assetId: string, variants: GeneratedVariants): AssetWriteInput;
 /** Live tally the "Generate previews" UI renders (EC-400 AD-1). */
 export interface BackfillProgress {
     /** How many assets need at least one variant (the candidate set size). */

package/dist/lib/assets/backfill-thumbs.js

@@ -14,7 +14,7 @@ import { generateVariants, planLqip, planThumb } from './thumbnail.js';
  * The write goes through the injected {@link AssetRepository} — in the studio the
  * EC-141 operations facade — so the patch flows through the one operations layer /
  * TanStack Query cache (AD-5 / AD-17), never a direct backend client. The pure
- * cores ({@link assetsNeedingVariants}, {@link assetVariantUpsertInput}) are
+ * cores ({@link assetsNeedingVariants}, {@link assetVariantWrite}) are
  * node-tested; the byte fetch + canvas encode stay in the injectable shell.
  */
 /** An image record still missing a thumb whose {@link planThumb} decision is `encode`. */
@@ -39,31 +39,19 @@ export function variantWantFor(asset) {
     return { thumb: needsThumb(asset), lqip: needsLqip(asset) };
 }
 /**
- * The full upsert input that re-states an existing record with freshly generated
- * variants attached — the targeted patch path for the backfill, within the
- * existing repository/`assets.upsert` contract (EC-400 AD-4 / EC-420). Mirrors
- * `assetMetadataUpsertInput`: every current column is restated so the full-replace
- * upsert preserves it. A newly generated variant overlays; a variant the record
- * ALREADY had (the other half of a per-variant fill) is preserved from `current`.
+ * The asset write for a backfill result (EC-400 AD-4 / EC-420, EC-577): ONLY the
+ * variants just generated. Every other column is absent, so it keeps its stored
+ * value — including a variant the record already had (the other half of a
+ * per-variant fill) and any metadata an editor saved while the run was going. The
+ * restate this replaced wrote the whole listed record back, which overwrote such
+ * a concurrent edit with the stale listing — and re-created an asset deleted
+ * mid-run; now a write for a vanished asset is refused and counted `failed`.
  */
-export function assetVariantUpsertInput(current, variants) {
-    const thumb = variants.thumb ?? current.thumb;
-    const lqip = variants.lqip ?? current.lqip;
+export function assetVariantWrite(assetId, variants) {
     return {
-        id: current.id,
-        filename: current.filename,
-        contentType: current.contentType,
-        byteSize: current.byteSize,
-        storageKey: current.storageKey,
-        ...(current.width !== undefined ? { width: current.width } : {}),
-        ...(current.height !== undefined ? { height: current.height } : {}),
-        ...(current.url !== undefined ? { url: current.url } : {}),
-        ...(current.alt !== undefined ? { alt: current.alt } : {}),
-        ...(current.title !== undefined ? { title: current.title } : {}),
-        ...(current.focalPoint !== undefined ? { focalPoint: current.focalPoint } : {}),
-        ...(current.meta !== undefined ? { meta: current.meta } : {}),
-        ...(thumb !== undefined ? { thumb } : {}),
-        ...(lqip !== undefined ? { lqip } : {}),
+        id: assetId,
+        ...(variants.thumb !== undefined ? { thumb: variants.thumb } : {}),
+        ...(variants.lqip !== undefined ? { lqip: variants.lqip } : {}),
     };
 }
 /**
@@ -102,7 +90,7 @@ export async function runVariantBackfill(deps, projectId) {
                     progress.skipped += 1;
                 }
                 else {
-                    const patched = await deps.assets.upsertAsset(projectId, assetVariantUpsertInput(asset, variants));
+                    const patched = await deps.assets.upsertAsset(projectId, assetVariantWrite(asset.id, variants));
                     deps.onGenerated?.(patched);
                     progress.generated += 1;
                 }

package/dist/lib/assets/backfill-thumbs.js.map

@@ -1 +1 @@
-{"version":3,"file":"backfill-thumbs.js","sourceRoot":"","sources":["../../../src/lib/assets/backfill-thumbs.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  AssetRecord,\n  AssetRepository,\n  BlobStorageAdapter,\n  NewAssetInput,\n} from '@elytracms/core/persistence'\nimport { generateVariants, planLqip, planThumb } from './thumbnail'\nimport type { GeneratedVariants, ThumbSource, VariantWant } from './thumbnail'\n\n/**\n * The assets-rail \"Generate previews\" backfill (EC-400 AD-1 + EC-420 AD-4).\n * Existing libraries predate the upload-time previews, so an explicit,\n * deterministic maintenance action fetches each original ONCE, runs the SAME\n * decode path as upload, and patches the record. It is idempotent PER VARIANT\n * (EC-420 AD-4): an asset needing only the lqip gets one fetch of the original\n * and fills just what's missing; an asset that already has both is skipped;\n * non-images / SVGs / (for the thumb) already-small images never qualify. The run\n * is sequential with visible progress and cancellable. Opportunistic per-open\n * generation was REJECTED (it hides egress in random editor sessions and is\n * untestable).\n *\n * The write goes through the injected {@link AssetRepository} — in the studio the\n * EC-141 operations facade — so the patch flows through the one operations layer /\n * TanStack Query cache (AD-5 / AD-17), never a direct backend client. The pure\n * cores ({@link assetsNeedingVariants}, {@link assetVariantUpsertInput}) are\n * node-tested; the byte fetch + canvas encode stay in the injectable shell.\n */\n\n/** An image record still missing a thumb whose {@link planThumb} decision is `encode`. */\nfunction needsThumb(asset: AssetRecord): boolean {\n  return asset.thumb === undefined && planThumb(asset).kind === 'encode'\n}\n\n/** An image record still missing an lqip whose {@link planLqip} decision is `encode`. */\nfunction needsLqip(asset: AssetRecord): boolean {\n  return asset.lqip === undefined && planLqip(asset).kind === 'encode'\n}\n\n/**\n * The assets that still need at least one variant (pure, node-tested idempotence\n * core, EC-420 AD-4): an image record missing a needed thumb OR a needed lqip.\n * Records already carrying both, non-images, SVGs, and (for the thumb) already-\n * small images are silently excluded — re-running on a done library is a no-op.\n */\nexport function assetsNeedingVariants(assets: readonly AssetRecord[]): AssetRecord[] {\n  return assets.filter((asset) => needsThumb(asset) || needsLqip(asset))\n}\n\n/** The variants an asset is missing — what the per-variant backfill asks the encoder for. */\nexport function variantWantFor(asset: AssetRecord): VariantWant {\n  return { thumb: needsThumb(asset), lqip: needsLqip(asset) }\n}\n\n/**\n * The full upsert input that re-states an existing record with freshly generated\n * variants attached — the targeted patch path for the backfill, within the\n * existing repository/`assets.upsert` contract (EC-400 AD-4 / EC-420). Mirrors\n * `assetMetadataUpsertInput`: every current column is restated so the full-replace\n * upsert preserves it. A newly generated variant overlays; a variant the record\n * ALREADY had (the other half of a per-variant fill) is preserved from `current`.\n */\nexport function assetVariantUpsertInput(\n  current: AssetRecord,\n  variants: GeneratedVariants,\n): NewAssetInput {\n  const thumb = variants.thumb ?? current.thumb\n  const lqip = variants.lqip ?? current.lqip\n  return {\n    id: current.id,\n    filename: current.filename,\n    contentType: current.contentType,\n    byteSize: current.byteSize,\n    storageKey: current.storageKey,\n    ...(current.width !== undefined ? { width: current.width } : {}),\n    ...(current.height !== undefined ? { height: current.height } : {}),\n    ...(current.url !== undefined ? { url: current.url } : {}),\n    ...(current.alt !== undefined ? { alt: current.alt } : {}),\n    ...(current.title !== undefined ? { title: current.title } : {}),\n    ...(current.focalPoint !== undefined ? { focalPoint: current.focalPoint } : {}),\n    ...(current.meta !== undefined ? { meta: current.meta } : {}),\n    ...(thumb !== undefined ? { thumb } : {}),\n    ...(lqip !== undefined ? { lqip } : {}),\n  }\n}\n\n/** Live tally the \"Generate previews\" UI renders (EC-400 AD-1). */\nexport interface BackfillProgress {\n  /** How many assets need at least one variant (the candidate set size). */\n  total: number\n  /** How many candidates have been processed (generated + skipped + failed). */\n  done: number\n  /** How many candidates had at least one variant generated and patched in. */\n  generated: number\n  /** Candidates the re-plan/encode declined (e.g. undecodable) — silent, valid. */\n  skipped: number\n  /** Candidates whose fetch/encode/patch errored — surfaced, not fatal. */\n  failed: number\n  /** Filename of the asset currently in flight (for the progress label). */\n  current?: string\n  /** Set once the run stops early because the caller cancelled. */\n  cancelled?: boolean\n}\n\n/** A mutable cancellation flag the UI flips to stop the sequential run (AD-1). */\nexport interface BackfillSignal {\n  cancelled: boolean\n}\n\nexport interface BackfillDeps {\n  /** Metadata reads + the variant patch write (the operations facade in the studio). */\n  assets: AssetRepository\n  /** Blob boundary: fetch each original's bytes, store the thumb variant. */\n  blobs: BlobStorageAdapter\n  /**\n   * Injectable variant producer; defaults to {@link generateVariants} over `blobs`.\n   * Receives the per-asset `want` so it produces ONLY the missing variants. Tests\n   * pass a deterministic fake so the iterator runs in node.\n   */\n  generate?: (source: Blob, meta: ThumbSource, want: VariantWant) => Promise<GeneratedVariants>\n  /** Fired with each patched record so the caller can update its cache in place. */\n  onGenerated?: (asset: AssetRecord) => void\n  /** Fired after each candidate (and once at the end) to drive the progress UI. */\n  onProgress?: (progress: BackfillProgress) => void\n  /** Cooperative cancellation — checked before each candidate (AD-1). */\n  signal?: BackfillSignal\n}\n\n/**\n * Run the backfill sequentially over a project's images that still need a variant.\n * Resolves with the final tally; never throws (per-asset failures are counted, not\n * fatal). One fetch per candidate serves both variants; only the missing ones are\n * (re)generated (EC-420 AD-4), so an asset with a thumb but no lqip is patched with\n * just the lqip and its existing thumb blob is left untouched.\n */\nexport async function runVariantBackfill(\n  deps: BackfillDeps,\n  projectId: string,\n): Promise<BackfillProgress> {\n  const all = await deps.assets.listAssets(projectId)\n  const candidates = assetsNeedingVariants(all)\n  const generate =\n    deps.generate ??\n    ((source: Blob, meta: ThumbSource, want: VariantWant) =>\n      generateVariants({ blobs: deps.blobs }, source, meta, want))\n\n  const progress: BackfillProgress = { total: candidates.length, done: 0, generated: 0, skipped: 0, failed: 0 }\n  deps.onProgress?.({ ...progress })\n\n  for (const asset of candidates) {\n    if (deps.signal?.cancelled) {\n      progress.cancelled = true\n      break\n    }\n    deps.onProgress?.({ ...progress, current: asset.filename })\n    try {\n      const bytes = await deps.blobs.get(asset.storageKey)\n      if (!bytes) {\n        progress.failed += 1\n      } else {\n        const source = new Blob([bytes as BlobPart], { type: asset.contentType })\n        const variants = await generate(\n          source,\n          {\n            contentType: asset.contentType,\n            ...(asset.width !== undefined ? { width: asset.width } : {}),\n            ...(asset.height !== undefined ? { height: asset.height } : {}),\n          },\n          variantWantFor(asset),\n        )\n        if (variants.thumb === undefined && variants.lqip === undefined) {\n          progress.skipped += 1\n        } else {\n          const patched = await deps.assets.upsertAsset(projectId, assetVariantUpsertInput(asset, variants))\n          deps.onGenerated?.(patched)\n          progress.generated += 1\n        }\n      }\n    } catch {\n      progress.failed += 1\n    }\n    progress.done += 1\n    deps.onProgress?.({ ...progress })\n  }\n\n  deps.onProgress?.({ ...progress })\n  return progress\n}\n"]}
+{"version":3,"file":"backfill-thumbs.js","sourceRoot":"","sources":["../../../src/lib/assets/backfill-thumbs.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  AssetRecord,\n  AssetRepository,\n  AssetWriteInput,\n  BlobStorageAdapter,\n} from '@elytracms/core/persistence'\nimport { generateVariants, planLqip, planThumb } from './thumbnail'\nimport type { GeneratedVariants, ThumbSource, VariantWant } from './thumbnail'\n\n/**\n * The assets-rail \"Generate previews\" backfill (EC-400 AD-1 + EC-420 AD-4).\n * Existing libraries predate the upload-time previews, so an explicit,\n * deterministic maintenance action fetches each original ONCE, runs the SAME\n * decode path as upload, and patches the record. It is idempotent PER VARIANT\n * (EC-420 AD-4): an asset needing only the lqip gets one fetch of the original\n * and fills just what's missing; an asset that already has both is skipped;\n * non-images / SVGs / (for the thumb) already-small images never qualify. The run\n * is sequential with visible progress and cancellable. Opportunistic per-open\n * generation was REJECTED (it hides egress in random editor sessions and is\n * untestable).\n *\n * The write goes through the injected {@link AssetRepository} — in the studio the\n * EC-141 operations facade — so the patch flows through the one operations layer /\n * TanStack Query cache (AD-5 / AD-17), never a direct backend client. The pure\n * cores ({@link assetsNeedingVariants}, {@link assetVariantWrite}) are\n * node-tested; the byte fetch + canvas encode stay in the injectable shell.\n */\n\n/** An image record still missing a thumb whose {@link planThumb} decision is `encode`. */\nfunction needsThumb(asset: AssetRecord): boolean {\n  return asset.thumb === undefined && planThumb(asset).kind === 'encode'\n}\n\n/** An image record still missing an lqip whose {@link planLqip} decision is `encode`. */\nfunction needsLqip(asset: AssetRecord): boolean {\n  return asset.lqip === undefined && planLqip(asset).kind === 'encode'\n}\n\n/**\n * The assets that still need at least one variant (pure, node-tested idempotence\n * core, EC-420 AD-4): an image record missing a needed thumb OR a needed lqip.\n * Records already carrying both, non-images, SVGs, and (for the thumb) already-\n * small images are silently excluded — re-running on a done library is a no-op.\n */\nexport function assetsNeedingVariants(assets: readonly AssetRecord[]): AssetRecord[] {\n  return assets.filter((asset) => needsThumb(asset) || needsLqip(asset))\n}\n\n/** The variants an asset is missing — what the per-variant backfill asks the encoder for. */\nexport function variantWantFor(asset: AssetRecord): VariantWant {\n  return { thumb: needsThumb(asset), lqip: needsLqip(asset) }\n}\n\n/**\n * The asset write for a backfill result (EC-400 AD-4 / EC-420, EC-577): ONLY the\n * variants just generated. Every other column is absent, so it keeps its stored\n * value — including a variant the record already had (the other half of a\n * per-variant fill) and any metadata an editor saved while the run was going. The\n * restate this replaced wrote the whole listed record back, which overwrote such\n * a concurrent edit with the stale listing — and re-created an asset deleted\n * mid-run; now a write for a vanished asset is refused and counted `failed`.\n */\nexport function assetVariantWrite(assetId: string, variants: GeneratedVariants): AssetWriteInput {\n  return {\n    id: assetId,\n    ...(variants.thumb !== undefined ? { thumb: variants.thumb } : {}),\n    ...(variants.lqip !== undefined ? { lqip: variants.lqip } : {}),\n  }\n}\n\n/** Live tally the \"Generate previews\" UI renders (EC-400 AD-1). */\nexport interface BackfillProgress {\n  /** How many assets need at least one variant (the candidate set size). */\n  total: number\n  /** How many candidates have been processed (generated + skipped + failed). */\n  done: number\n  /** How many candidates had at least one variant generated and patched in. */\n  generated: number\n  /** Candidates the re-plan/encode declined (e.g. undecodable) — silent, valid. */\n  skipped: number\n  /** Candidates whose fetch/encode/patch errored — surfaced, not fatal. */\n  failed: number\n  /** Filename of the asset currently in flight (for the progress label). */\n  current?: string\n  /** Set once the run stops early because the caller cancelled. */\n  cancelled?: boolean\n}\n\n/** A mutable cancellation flag the UI flips to stop the sequential run (AD-1). */\nexport interface BackfillSignal {\n  cancelled: boolean\n}\n\nexport interface BackfillDeps {\n  /** Metadata reads + the variant patch write (the operations facade in the studio). */\n  assets: AssetRepository\n  /** Blob boundary: fetch each original's bytes, store the thumb variant. */\n  blobs: BlobStorageAdapter\n  /**\n   * Injectable variant producer; defaults to {@link generateVariants} over `blobs`.\n   * Receives the per-asset `want` so it produces ONLY the missing variants. Tests\n   * pass a deterministic fake so the iterator runs in node.\n   */\n  generate?: (source: Blob, meta: ThumbSource, want: VariantWant) => Promise<GeneratedVariants>\n  /** Fired with each patched record so the caller can update its cache in place. */\n  onGenerated?: (asset: AssetRecord) => void\n  /** Fired after each candidate (and once at the end) to drive the progress UI. */\n  onProgress?: (progress: BackfillProgress) => void\n  /** Cooperative cancellation — checked before each candidate (AD-1). */\n  signal?: BackfillSignal\n}\n\n/**\n * Run the backfill sequentially over a project's images that still need a variant.\n * Resolves with the final tally; never throws (per-asset failures are counted, not\n * fatal). One fetch per candidate serves both variants; only the missing ones are\n * (re)generated (EC-420 AD-4), so an asset with a thumb but no lqip is patched with\n * just the lqip and its existing thumb blob is left untouched.\n */\nexport async function runVariantBackfill(\n  deps: BackfillDeps,\n  projectId: string,\n): Promise<BackfillProgress> {\n  const all = await deps.assets.listAssets(projectId)\n  const candidates = assetsNeedingVariants(all)\n  const generate =\n    deps.generate ??\n    ((source: Blob, meta: ThumbSource, want: VariantWant) =>\n      generateVariants({ blobs: deps.blobs }, source, meta, want))\n\n  const progress: BackfillProgress = { total: candidates.length, done: 0, generated: 0, skipped: 0, failed: 0 }\n  deps.onProgress?.({ ...progress })\n\n  for (const asset of candidates) {\n    if (deps.signal?.cancelled) {\n      progress.cancelled = true\n      break\n    }\n    deps.onProgress?.({ ...progress, current: asset.filename })\n    try {\n      const bytes = await deps.blobs.get(asset.storageKey)\n      if (!bytes) {\n        progress.failed += 1\n      } else {\n        const source = new Blob([bytes as BlobPart], { type: asset.contentType })\n        const variants = await generate(\n          source,\n          {\n            contentType: asset.contentType,\n            ...(asset.width !== undefined ? { width: asset.width } : {}),\n            ...(asset.height !== undefined ? { height: asset.height } : {}),\n          },\n          variantWantFor(asset),\n        )\n        if (variants.thumb === undefined && variants.lqip === undefined) {\n          progress.skipped += 1\n        } else {\n          const patched = await deps.assets.upsertAsset(projectId, assetVariantWrite(asset.id, variants))\n          deps.onGenerated?.(patched)\n          progress.generated += 1\n        }\n      }\n    } catch {\n      progress.failed += 1\n    }\n    progress.done += 1\n    deps.onProgress?.({ ...progress })\n  }\n\n  deps.onProgress?.({ ...progress })\n  return progress\n}\n"]}