@mengine/medeo-tool 1.3.1-alpha.11 → 1.3.1-alpha.12

package/dist/index.d.mts

@@ -211,6 +211,20 @@ type EditScriptResult = {
 /** Run `script` against a forked document snapshot; always resolves (never rejects). */
 declare function runEditScript(options: RunEditScriptOptions): Promise<EditScriptResult>;
 //#endregion
+//#region src/entity/caption-asset-assembly.d.ts
+/** Optional physical artifact registered for one immutable Caption identity. */
+interface CaptionAssetFact {
+  readonly captionEntityId: string;
+  readonly assetId: string;
+  readonly storageKey: string;
+}
+/** Host-only lookup. Missing facts mean the Caption has no physical artifact. */
+type CaptionAssetsLoader = (docId: string, captionEntityIds: readonly string[]) => Promise<readonly CaptionAssetFact[]>;
+interface CaptionAssetAssemblyOutcome {
+  readonly status: 'applied' | 'current' | 'failed';
+  readonly message?: string;
+}
+//#endregion
 //#region src/entity/generation-sync.d.ts
 /** Factual generation lineage for recalled Memota assets, supplied by the host. */
 interface AssetGenerationFact {
@@ -455,6 +469,8 @@ interface CreateMedeoToolOptions {
    * names entities, relations, or endpoints.
    */
   loadGenerationFacts?: GenerationFactsLoader;
+  /** Assemble optional Caption artifacts by immutable entity ID; never exposed to scripts. */
+  loadCaptionAssets?: CaptionAssetsLoader;
   fetchImpl?: typeof fetch;
   /** @deprecated ManualSyncDoc has no SSE or reconnect loop. */
   sseReconnectDelayMs?: number;
@@ -498,6 +514,9 @@ type MedeoToolInput = {
   validation?: 'preflight';
 };
 type MedeoToolWarning = {
+  kind: 'asset_assembly_failed';
+  message: string;
+} | {
   kind: 'pull_failed';
   message: string;
 } | {
@@ -515,6 +534,7 @@ type EntityCommitResult = {
   collaborated: boolean;
   entity_revision: number; /** Present only when the host supplies loadGenerationFacts. */
   generation_sync?: GenerationSyncOutcome;
+  asset_assembly?: CaptionAssetAssemblyOutcome;
   warnings?: MedeoToolWarning[];
 } | {
   kind: 'unconfirmed';
@@ -601,5 +621,5 @@ type MedeoInitialDraft = VideoDraft;
  */
 declare function createMedeoTool(options: CreateMedeoToolOptions): MedeoTool;
 //#endregion
-export { type AssetGenerationFact, type AuthorableRelationKind, type ChangePlan, type CommitPlan, type CommitPlanOptions, type CommitPlanResult, type CompactProjectionOptions, type ConsoleShim, type CreateEntityInput, type CreateMedeoToolOptions, type DeleteEntityInput, type EditFacade, EditSandboxSession, type EditSandboxSessionOptions, type EditScriptResult, type EntityCommand, type EntityCommitResult, type EntityFacade, type EntityPlanState, type EntityStoreSnapshot, type GenerationFactsLoader, type GenerationSyncOutcome, type JsonObject, type JsonPrimitive, type JsonValue, type KnownEntityKind, type KnownRelationKind, type LinkGeneratedRelationInput, type LinkRelationInput, MEDEO_TOOL_DESCRIPTION, MEDEO_TOOL_NAME, MEDEO_TOOL_PARAMETERS, type MedeoCommitResult, type MedeoInitialDraft, type MedeoModelContext, type MedeoModelContextInput, type MedeoTool, type MedeoToolInput, type MedeoToolOp, type MedeoToolResult, type RelationFacade, type ResourceEntityKind, type RunEditScriptOptions, type SandboxCheckpoint, type SandboxEntity, type SandboxRelation, type TimelineClipDescriptor, type TimelineFacade, type TimelinePartDescriptor, type UnlinkRelationInput, type UpdateEntityInput, collectAffectedPartIds, commitPlan, createMedeoTool, renderCompactProjection, renderPreview, runEditScript };
+export { type AssetGenerationFact, type AuthorableRelationKind, type CaptionAssetAssemblyOutcome, type CaptionAssetFact, type CaptionAssetsLoader, type ChangePlan, type CommitPlan, type CommitPlanOptions, type CommitPlanResult, type CompactProjectionOptions, type ConsoleShim, type CreateEntityInput, type CreateMedeoToolOptions, type DeleteEntityInput, type EditFacade, EditSandboxSession, type EditSandboxSessionOptions, type EditScriptResult, type EntityCommand, type EntityCommitResult, type EntityFacade, type EntityPlanState, type EntityStoreSnapshot, type GenerationFactsLoader, type GenerationSyncOutcome, type JsonObject, type JsonPrimitive, type JsonValue, type KnownEntityKind, type KnownRelationKind, type LinkGeneratedRelationInput, type LinkRelationInput, MEDEO_TOOL_DESCRIPTION, MEDEO_TOOL_NAME, MEDEO_TOOL_PARAMETERS, type MedeoCommitResult, type MedeoInitialDraft, type MedeoModelContext, type MedeoModelContextInput, type MedeoTool, type MedeoToolInput, type MedeoToolOp, type MedeoToolResult, type RelationFacade, type ResourceEntityKind, type RunEditScriptOptions, type SandboxCheckpoint, type SandboxEntity, type SandboxRelation, type TimelineClipDescriptor, type TimelineFacade, type TimelinePartDescriptor, type UnlinkRelationInput, type UpdateEntityInput, collectAffectedPartIds, commitPlan, createMedeoTool, renderCompactProjection, renderPreview, runEditScript };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1,7 +1,7 @@
-import { a as isMediaAssetVariantKind, c as renderCompactProjection, i as createRelationId, o as collectAffectedPartIds, r as createEntityId, s as renderPreview, t as EditSandboxSession } from "./script-session-DLBhoA1R.mjs";
+import { a as isMediaAssetVariantKind, c as renderCompactProjection, i as createRelationId, o as collectAffectedPartIds, r as createEntityId, s as renderPreview, t as EditSandboxSession } from "./script-session-IqAIVBCM.mjs";
 import { LoroEntityDocument, ManualSyncDoc, MengineHttpClient, MengineHttpRequestError, ValidationError, base64ToBytes, bytesToBase64, compileEntityRows, createMirrorVideoDocument, createPlainMemoryAdapter, decodeDocVersionMark, encodeDocVersionMark, ensureEditorFoundation, replayJournal, toVideoDocument } from "@mengine/medeo-client";
 import { Worker } from "node:worker_threads";
-import { randomUUID } from "node:crypto";
+import { createHash, randomUUID } from "node:crypto";
 //#region src/sandbox/node-host.ts
 const DEFAULT_TIMEOUT_MS = 2e3;
 const DEFAULT_MEMORY_MB = 256;
@@ -180,6 +180,78 @@ function runEditScript(options) {
 	});
 }
 //#endregion
+//#region src/entity/caption-asset-assembly.ts
+/** Assemble optional infrastructure after business execution, using exact entity identity. */
+async function assembleCaptionAssets(input) {
+	try {
+		const state = await input.client.fetchState();
+		const candidates = state.entities.filter((entity) => entity.entity_kind === "caption" && !state.relations.some((relation) => relation.relation_kind === "physical-asset" && (relation.endpoint_0_entity_id === entity.entity_id || relation.endpoint_1_entity_id === entity.entity_id)));
+		if (!candidates.length) return { status: "current" };
+		const ids = new Set(candidates.map((entity) => entity.entity_id));
+		const facts = await input.loadAssets(input.docId, [...ids]);
+		const entities = [...state.entities];
+		const relations = [...state.relations];
+		const bound = /* @__PURE__ */ new Map();
+		for (const fact of facts) {
+			if (!ids.has(fact.captionEntityId) || !trimmed(fact.assetId) || !trimmed(fact.storageKey)) throw new Error("Caption Asset fact must identify a requested Caption and a real Asset locator");
+			const previous = bound.get(fact.captionEntityId);
+			if (previous !== void 0) {
+				if (previous !== fact.assetId) throw new Error(`Conflicting Assets for Caption ${fact.captionEntityId}`);
+				continue;
+			}
+			bound.set(fact.captionEntityId, fact.assetId);
+			const matches = entities.filter((entity) => {
+				const external = entity.payload.external;
+				return external !== null && typeof external === "object" && !Array.isArray(external) && external.system === "memota" && external.key === fact.assetId;
+			});
+			if (matches.length > 1 || matches[0] && matches[0].entity_kind !== "asset") throw new Error(`Conflicting resource identity for Caption Asset ${fact.assetId}`);
+			let asset = matches[0];
+			if (asset && asset.payload.storageKey !== fact.storageKey) throw new Error(`Conflicting storage key for Caption Asset ${fact.assetId}`);
+			if (!asset) {
+				asset = {
+					entity_id: stableId("asset", fact.assetId),
+					entity_kind: "asset",
+					payload: {
+						external: {
+							system: "memota",
+							key: fact.assetId
+						},
+						storageKey: fact.storageKey
+					}
+				};
+				if (entities.some((entity) => entity.entity_id === asset.entity_id)) throw new Error("Caption Asset identity collision");
+				entities.push(asset);
+			}
+			relations.push({
+				relation_id: stableId("relation", fact.captionEntityId, asset.entity_id),
+				relation_kind: "physical-asset",
+				endpoint_0_entity_id: fact.captionEntityId,
+				endpoint_1_entity_id: asset.entity_id,
+				metadata: {},
+				trace: {}
+			});
+		}
+		if (!bound.size) return { status: "current" };
+		await input.client.commit(state.revision, {
+			...state,
+			entities,
+			relations
+		});
+		return { status: "applied" };
+	} catch (error) {
+		return {
+			status: "failed",
+			message: error instanceof Error ? error.message : String(error)
+		};
+	}
+}
+function stableId(prefix, ...parts) {
+	return `${prefix}_${createHash("sha256").update(JSON.stringify(parts)).digest("hex")}`;
+}
+function trimmed(value) {
+	return typeof value === "string" && value.length > 0 && value.trim() === value;
+}
+//#endregion
 //#region src/entity/entity-contract.ts
 const KNOWN_ENTITY_KINDS = [
 	"axvideo",
@@ -538,6 +610,45 @@ const ENTITY_EDIT_SANDBOX_API_DTS = [
 	"  sampling: 'native';",
 	"  coordinateSpace: JsonValue;",
 	"}",
+	"/** Business editing surface. Infrastructure Assets are assembled by the host. */",
+	"export interface BusinessEntityFacade {",
+	"  list(): SandboxEntity[];",
+	"  get(entityId: string): SandboxEntity | null;",
+	"  readCaptionContent(entityId: string): ComposedScriptContent;",
+	"  readPhoneticScriptContent(entityId: string): ComposedPhoneticContent;",
+	"  create(",
+	"    input: Exclude<",
+	"      CreateEntityInput,",
+	"      {",
+	"        entity_kind: 'asset';",
+	"      }",
+	"    >,",
+	"  ): string;",
+	"  update(input: UpdateEntityInput): void;",
+	"  declareFields(input: UpdateEntityInput): void;",
+	"  delete(input: DeleteEntityInput): void;",
+	"  ensureMedia(fact: MediaAssetFact): {",
+	"    contentEntityId: string;",
+	"  };",
+	"}",
+	"/** Physical Asset bindings are maintained outside the sandbox. */",
+	"export interface BusinessRelationFacade {",
+	"  list(): SandboxRelation[];",
+	"  of(entityId: string, relationKind?: KnownRelationKind): SandboxRelation[];",
+	"  link(",
+	"    input: Exclude<",
+	"      LinkRelationInput,",
+	"      {",
+	"        relation_kind: 'physical-asset';",
+	"      }",
+	"    >,",
+	"  ): string;",
+	"  linkGenerated(input: LinkGeneratedRelationInput): string;",
+	"  linkClipAnchor(input: LinkClipAnchorRelationInput): string;",
+	"  linkPhoneticScriptRender(input: LinkPhoneticScriptRenderRelationInput): string;",
+	"  linkAudioScriptSource(input: LinkAudioScriptSourceRelationInput): string;",
+	"  unlink(input: UnlinkRelationInput): void;",
+	"}",
 	"export interface CaptionFontDescriptor {",
 	"  readonly system: 'font-library';",
 	"  readonly key: string;",
@@ -640,28 +751,6 @@ const ENTITY_EDIT_SANDBOX_API_DTS = [
 	"  | 'axvideo-marker'",
 	"  | 'marker-timeline'",
 	"  | 'audio-script-marker';",
-	"export interface EntityFacade {",
-	"  /** Read complete assembled fields; returned objects are snapshots. Use update to persist edits. */",
-	"  list(): SandboxEntity[];",
-	"  get(entityId: string): SandboxEntity | null;",
-	"  /** Find document resources by external Memota asset id, including directly composed media variants. */",
-	"  findByAssetId(assetId: string): SandboxEntity<ResourceEntityKind>[];",
-	"  /** Assemble selected Caption text; missing composition is an error. */",
-	"  readCaptionContent(entityId: string): ComposedScriptContent;",
-	"  /** Assemble base text and pronunciation fields before generating Voice. */",
-	"  readPhoneticScriptContent(entityId: string): ComposedPhoneticContent;",
-	"  create(input: CreateEntityInput): string;",
-	"  /** Patch assembled fields, routing inherited fields to their declaring entity. */",
-	"  update(input: UpdateEntityInput): void;",
-	"  /** Explicitly declare own fields, overriding unambiguous bases without modifying them. Ordinary edits use update. */",
-	"  declareFields(input: UpdateEntityInput): void;",
-	"  /** Delete an Entity only after all of its incident Relations have been explicitly unlinked. */",
-	"  delete(input: DeleteEntityInput): void;",
-	"  /** Get or create one typed Asset by factual external id and return its single content identity. Never creates a Clip. */",
-	"  ensureMedia(fact: MediaAssetFact): {",
-	"    contentEntityId: string;",
-	"  };",
-	"}",
 	"export type EntityId = string;",
 	"export interface EntityPayloadByKind {",
 	"  axvideo: BoundedDerivedSequencePayload;",
@@ -735,6 +824,8 @@ const ENTITY_EDIT_SANDBOX_API_DTS = [
 	"}",
 	"export interface InsertCaptionClipInput {",
 	"  readonly timelineEntityId: string;",
+	"  /** Existing generation identity for newly materialized Caption content, distinct from its Clip. */",
+	"  readonly captionEntityId?: string;",
 	"  /** Stable placed caption identity, distinct from the Caption content identity. */",
 	"  readonly captionClipEntityId?: string;",
 	"  /** Existing bases composed by this variant; includes an AudioScript text owner. */",
@@ -915,23 +1006,6 @@ const ENTITY_EDIT_SANDBOX_API_DTS = [
 	"  readonly timelineEntityId: string;",
 	"  readonly style: CaptionStyleFields;",
 	"}",
-	"export interface RelationFacade {",
-	"  list(): SandboxRelation[];",
-	"  /** Incident lookup is endpoint-agnostic; persisted endpoint positions stay unchanged. */",
-	"  of(entityId: string, relationKind?: KnownRelationKind): SandboxRelation[];",
-	"  /** Link existing entities through ordinary associations; variant bases are stored directly on the variant. */",
-	"  link(input: LinkRelationInput): string;",
-	"  /** Author ordered generated(output,input); generic link() deliberately rejects this kind. */",
-	"  linkGenerated(input: LinkGeneratedRelationInput): string;",
-	"  /** Author ordered clip-anchor(child,host) without positional endpoint ambiguity. */",
-	"  linkClipAnchor(input: LinkClipAnchorRelationInput): string;",
-	"  /** Author ordered phonetic-script-render(output,script) without positional endpoint ambiguity. */",
-	"  linkPhoneticScriptRender(input: LinkPhoneticScriptRenderRelationInput): string;",
-	"  /** Author ordered audio-script-source(script,source) without positional endpoint ambiguity. */",
-	"  linkAudioScriptSource(input: LinkAudioScriptSourceRelationInput): string;",
-	"  /** Remove a Relation by identity; endpoint replacement is an explicit unlink plus link. */",
-	"  unlink(input: UnlinkRelationInput): void;",
-	"}",
 	"export interface ReplaceClipContentInput {",
 	"  readonly clipEntityId: string;",
 	"  /** Existing Sequence media Entity id. Asset ids and URLs are not content ids. */",
@@ -958,8 +1032,6 @@ const ENTITY_EDIT_SANDBOX_API_DTS = [
 	"  readonly sourceRange: SequenceRange<number>;",
 	"  readonly volume?: number;",
 	"}",
-	"/** Asset identity, either an old physical-only row or a directly composed media variant. */",
-	"export type ResourceEntityKind = 'image' | 'video' | 'audio' | 'voice';",
 	"export interface SandboxEntity<K extends KnownEntityKind = KnownEntityKind> {",
 	"  entity_id: string;",
 	"  entity_kind: K;",
@@ -1163,8 +1235,8 @@ const ENTITY_EDIT_SANDBOX_API_DTS = [
 	"}",
 	"export declare const edit: EditApi;",
 	"export declare const timeline: TimelineApi;",
-	"export declare const entities: EntityFacade;",
-	"export declare const relations: RelationFacade;",
+	"export declare const entities: BusinessEntityFacade;",
+	"export declare const relations: BusinessRelationFacade;",
 	"export declare function checkpoint(): SandboxCheckpoint;",
 	"export declare function rollbackTo(cp: SandboxCheckpoint): void;",
 	"export declare const inputs: Readonly<Record<string, unknown>>;",
@@ -1188,12 +1260,12 @@ const MEDEO_TOOL_EXECUTION_RULES = `
 The host supplies the current document. Do not ask for, invent, or pass a document id.
 timeline.snapshot() returns the Entity/Relation graph with its revision, not a legacy VideoDraft. Inspect Timeline, Track, Clip, SequenceMarker and their relations to plan edits.
 Generation lineage is not a model input: the host program queries it via loadGenerationFacts and syncs generated Relations after each successful commit. Memota asset facts are host-provided through inputs. Never invent an asset id, Entity kind, or peer Entity id.
-Use entities.ensureMedia(fact) to get or create the canonical typed Asset. Native media placement helpers use the same resolver. findByAssetId includes directly composed media variants, including Voice. Every Image/Video/Audio/Voice must own its external identity; separate Asset+media graphs are invalid. A typed Asset's external identity cannot be removed or rewritten: to replace its source, ensureMedia for the new Asset and replace the Clip's content. Conflicting facts fail closed. Asset generation itself still creates no editor Entities.
+Use entities.ensureMedia(fact) to get or create the canonical typed Asset. Native media placement helpers use the same resolver. Every Image/Video/Audio/Voice must own its external identity; separate Asset+media graphs are invalid. A typed Asset's external identity cannot be removed or rewritten: to replace its source, ensureMedia for the new Asset and replace the Clip's content. Conflicting facts fail closed. Asset generation itself still creates no editor Entities.
 For recalled video/audio/voice, create a bounded/native payload whose extent end comes from factual media duration/coordinates in inputs; never fabricate a duration. Image uses unbounded/constant semantics and has no invented end. If required facts are absent, do not create the media Entity yet.
-Caption content is assembled from AudioScript; never create an inline text Asset for it. Generated media lineage is host-owned; do not author generated Relations yourself. relations.of remains endpoint-agnostic for lookup.
+Caption composes AudioScript text. Asset entities and their physical-asset bindings are optional host infrastructure, assembled by Caption entity ID after execution. Generated media lineage is host-owned; do not author generated Relations yourself. relations.of remains endpoint-agnostic for lookup.
 The editor projection supports the existing four Track roles: video_clip (Image/Video), speech (Voice), caption (Caption), and bgm (Audio), one of each. Clip.volume is decibels (-60 to 20, 0 = original). Marker.sourceRange is the selected source interval; Marker.duration is effective display/playback duration. Coordinates and duration are whole milliseconds for this reader, not a global DSL restriction. Placement is exactly one of Clip.order, Marker.targetRange, or clip-anchor(child,host) plus Marker.anchorOffset. Use the native move/delete/voiceover helpers so placement and cascade decisions are in the same entity plan. Reading the graph never rebinds anchors or invents empty clips. Linear timeRemapping is {kind:'linear',rate:2,mode:'constant'} and agrees with rounded source span divided by rate. Image remains unbounded/constant; an explicit linear rate scales its display window, not an invented media extent. Nonlinear speed and multiple visual overlay tracks are unsupported.
 Entities own fields; ordinary Relations express associations; variants directly hold baseEntityIds and assemble the referenced entities. These foundations are fixed: implementation must follow them, never redefine them. Any entity may compose multiple bases. Equal field names from multiple bases (even equal values) are errors, even when the variant declares that field itself. After validating all base fields are unambiguous, explicitly declared own fields may override base fields without mutating the bases. Base ordering never resolves conflicts. AudioScript owns segmented text. Caption and PhoneticScript persist baseEntityIds including their AudioScript, plus their own fields; no composition Relation exists. Create the real bases before reading or committing a variant. Inside the DSL sandbox, entities.get/list expose complete assembled fields. Consumers read fields without inspecting base IDs or merging bases. entities.update patches supplied fields and routes inherited fields to their declaring entity; omitted fields remain unchanged. entities.declareFields explicitly declares own overrides and is distinct from an ordinary field edit. Persistence keeps owned fields only. entities.readCaptionContent(id) and entities.readPhoneticScriptContent(id) return assembled text. Missing/cyclic bases and field conflicts fail before persistence.
-Use edit.insertCaptionClip with baseEntityIds and selections; each voiceover caption also supplies baseEntityIds. A selection names segmentId and may use a half-open Unicode code-point textRange to split a segment for the screen without rewriting AudioScript. Generate Voice from an existing PhoneticScript, then use phoneticScriptEntityId in the voiceover helper or relations.linkPhoneticScriptRender({output_entity_id,phonetic_script_entity_id}) for its render relation. Caption and Voice have their own Clips; display anchoring is explicit and independent of composition/alignment.
+Use edit.insertCaptionClip with baseEntityIds and selections, plus captionEntityId when generation returned a Caption identity; each voiceover caption also supplies baseEntityIds. A selection names segmentId and may use a half-open Unicode code-point textRange to split a segment for the screen without rewriting AudioScript. Generate Voice from an existing PhoneticScript, then use phoneticScriptEntityId in the voiceover helper or relations.linkPhoneticScriptRender({output_entity_id,phonetic_script_entity_id}) for its render relation. Caption and Voice have their own Clips; display anchoring is explicit and independent of composition/alignment.
 Move or stretch only the Clip's display Marker; preserve Caption intrinsic Sequence, AudioScript text and its annotation Markers. AudioScript cannot enter a Clip and has no intrinsic time. audio-script-source links its ASR source Audio/Video/Voice; audio-script-marker attaches annotation Markers with directly assigned segmentRanges:{segmentId,startMs,endMs} in whole milliseconds. Annotation Markers have no Clip/AXVideo/content/Timeline relations and never refer to other Markers for time. BGM keeps factual source duration with durationPolicy:'timeline'. Never introduce a speech entity kind.
 Create only the known entity kinds. Project creation initializes one current Timeline, four Tracks and an attached AudioScript with segments:[]. Read the current AudioScript ID from timeline.snapshot(); the panel displays this attachment and preserves its segments. Normal edits operate this script, not an unrelated newly created script.
 Immutable updates apply to every entity: editing an owned field creates a new content version ID; changing only a variant's base ID preserves the variant ID. Editing a base through a variant updates the owner, and the compiler advances the affected base links and project attachment. A variant-owned edit creates a new variant version and retains its unchanged bases. Do not manually clone entities or duplicate inherited fields to implement versioning. Versions preserve native text and list editing identities so independent concurrent edits survive. Missing facts, unsupported layouts and composition conflicts are explicit errors; there is no legacy migration or whole-state overwrite path.
@@ -1678,7 +1750,21 @@ function createMedeoTool(options) {
 		if (plan.entity_rows === void 0) throw new Error("entity plan is missing its authoritative rows");
 		const client = getEntityClient(docId);
 		if (options.loadGenerationFacts !== void 0 && baseState === void 0) throw new Error("Generation synchronization is missing the cached causal plan baseline");
-		return await attachGenerationSync(docId, plan, await commitEntityPlan(client, plan), baseState);
+		const synced = await attachGenerationSync(docId, plan, await commitEntityPlan(client, plan), baseState);
+		if (synced.kind !== "committed" || options.loadCaptionAssets === void 0) return synced;
+		const assembly = await assembleCaptionAssets({
+			client,
+			docId,
+			loadAssets: options.loadCaptionAssets
+		});
+		return {
+			...synced,
+			asset_assembly: assembly,
+			...assembly.status === "failed" ? { warnings: [...synced.warnings ?? [], {
+				kind: "asset_assembly_failed",
+				message: assembly.message ?? "Caption Asset assembly failed"
+			}] } : {}
+		};
 	}
 	/**
 	* After a confirmed entity commit, connect fact-matched generated Relations