@mengine/medeo-tool 1.3.1-alpha.8 → 1.4.1-alpha.0

package/dist/sandbox-api.d.mts

@@ -1,11 +1,5 @@
 //#region src/sandbox/generated/entity-edit-sandbox-api.d.ts
 /** @generated by gen:sandbox-dts. Entity-native editor contract; DO NOT EDIT. */
-interface AudioMediaAssetFact {
-  readonly assetId: string;
-  readonly kind: 'audio';
-  readonly durationMs: number;
-  readonly storageKey: string;
-}
 interface BoundedDerivedSequencePayload extends JsonObject {
   extent: {
     kind: 'bounded';
@@ -25,6 +19,32 @@ interface BoundedNativeSequencePayload extends JsonObject {
   sampling: 'native';
   coordinateSpace: JsonValue;
 }
+/** Business editing surface. Infrastructure Assets are assembled by the host. */
+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;
+}
+/** Physical Asset bindings are maintained outside the sandbox. */
+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;
+}
 interface CaptionFontDescriptor {
   readonly system: 'font-library';
   readonly key: string;
@@ -114,28 +134,6 @@ interface DeleteVoiceoverInput {
   readonly voiceoverClipEntityIds: readonly string[];
 }
 type EmptyRelationKind = 'timeline-track' | 'track-clip' | 'clip-marker' | 'marker-content' | 'axvideo-marker' | 'marker-timeline' | 'audio-script-marker';
-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;
-  };
-}
 type EntityId = string;
 interface EntityPayloadByKind {
   axvideo: BoundedDerivedSequencePayload;
@@ -145,12 +143,10 @@ interface EntityPayloadByKind {
     role?: string;
   };
   clip: JsonObject;
-  /** Physical resource fields; never a copy of Caption content. */
-  asset: JsonObject;
-  video: BoundedNativeSequencePayload & MediaAssetPayload;
-  audio: BoundedNativeSequencePayload & MediaAssetPayload;
-  voice: BoundedNativeSequencePayload & MediaAssetPayload;
-  image: UnboundedConstantSequencePayload & MediaAssetPayload;
+  video: BoundedNativeSequencePayload;
+  audio: BoundedNativeSequencePayload;
+  voice: BoundedNativeSequencePayload;
+  image: UnboundedConstantSequencePayload;
   'sequence-marker': JsonObject & {
     sourceRange: {
       start: number;
@@ -191,18 +187,18 @@ interface EntityPayloadByKind {
   };
 }
 interface EntityStoreSnapshot {
+  /** Causal compiler baseline; required for publishing edits. */
+  loroSnapshot?: string;
   revision: number;
+  /** Current AudioScript version attached to the project; initialized projects always attach a script, possibly empty. */
   audioScriptEntityId: string | null;
   entities: SandboxEntity[];
   relations: SandboxRelation[];
 }
-interface ImageMediaAssetFact {
-  readonly assetId: string;
-  readonly kind: 'image';
-  readonly storageKey?: string;
-}
 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. */
@@ -223,21 +219,6 @@ interface InsertClipInput {
   readonly targetRange?: SequenceRange<number>;
   readonly clipPayload?: JsonObject;
 }
-interface InsertMediaClipInput {
-  readonly timelineEntityId: string;
-  readonly clipEntityId?: string;
-  readonly media: VisualMediaAssetFact;
-  /** Source/display window in whole milliseconds. Images use this as their finite display span. */
-  readonly sourceRange: SequenceRange<number>;
-  readonly placement: ClipPlacement;
-  readonly volume?: number;
-}
-interface InsertMediaClipsInput {
-  readonly timelineEntityId: string;
-  readonly clips: readonly ReplacementMediaClipInput[];
-  /** One placement decision for the whole input-ordered block. */
-  readonly insertion: MediaClipInsertion;
-}
 interface InsertPlacedClipInput {
   readonly trackEntityId: string;
   readonly contentEntityId: string;
@@ -253,8 +234,8 @@ interface JsonObject {
 }
 type JsonPrimitive = string | number | boolean | null;
 type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
-type KnownEntityKind = 'axvideo' | 'timeline' | 'track' | 'clip' | 'asset' | 'video' | 'audio' | 'voice' | 'image' | 'sequence-marker' | 'viewport' | 'audio-script' | 'phonetic-script' | 'caption';
-type KnownRelationKind = 'timeline-track' | 'track-clip' | 'clip-marker' | 'marker-content' | 'axvideo-marker' | 'marker-timeline' | 'physical-asset' | 'generated' | 'caption-alignment' | 'clip-anchor' | 'phonetic-script-render' | 'audio-script-source' | 'audio-script-marker';
+type KnownEntityKind = 'axvideo' | 'timeline' | 'track' | 'clip' | 'video' | 'audio' | 'voice' | 'image' | 'sequence-marker' | 'viewport' | 'audio-script' | 'phonetic-script' | 'caption';
+type KnownRelationKind = 'timeline-track' | 'track-clip' | 'clip-marker' | 'marker-content' | 'axvideo-marker' | 'marker-timeline' | 'generated' | 'caption-alignment' | 'clip-anchor' | 'phonetic-script-render' | 'audio-script-source' | 'audio-script-marker';
 interface LinearClipSpeed {
   readonly kind: 'linear';
   readonly rate: number;
@@ -305,25 +286,6 @@ type LinkRelationInput = (LinkRelationBase & {
     alignment: JsonValue;
   };
 });
-/** Facts resolved from media storage. A trim window never substitutes for intrinsic duration. */
-type MediaAssetFact = ImageMediaAssetFact | VideoMediaAssetFact | AudioMediaAssetFact | VoiceMediaAssetFact;
-type MediaAssetPayload = JsonObject & {
-  external: {
-    system: 'memota' | 'memota-speech';
-    key: string;
-  };
-  storageKey?: string;
-};
-type MediaClipInsertion = {
-  readonly kind: 'before';
-  readonly clipEntityId: string;
-} | {
-  readonly kind: 'after';
-  readonly clipEntityId: string;
-} | {
-  readonly kind: 'firstStart';
-  readonly startMs: number;
-};
 interface MoveClipInput {
   readonly clipEntityId: string;
   readonly trackEntityId: string;
@@ -350,23 +312,6 @@ interface PatchCaptionStyleInput {
   readonly timelineEntityId: string;
   readonly style: CaptionStyleFields;
 }
-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;
-}
 interface ReplaceClipContentInput {
   readonly clipEntityId: string;
   /** Existing Sequence media Entity id. Asset ids and URLs are not content ids. */
@@ -376,25 +321,6 @@ interface ReplaceClipContentInput {
   readonly targetRange?: SequenceRange<number>;
   readonly timeRemapping?: JsonValue;
 }
-interface ReplaceMediaClipInput {
-  readonly clipEntityId: string;
-  readonly media: VisualMediaAssetFact;
-  readonly sourceRange: SequenceRange<number>;
-}
-interface ReplaceSequentialClipsInput {
-  readonly timelineEntityId: string;
-  readonly oldClipEntityIds: readonly string[];
-  readonly newClips: readonly ReplacementMediaClipInput[];
-  readonly onAnchored: 'remap' | 'cascade';
-}
-interface ReplacementMediaClipInput {
-  readonly clipEntityId?: string;
-  readonly media: VisualMediaAssetFact;
-  readonly sourceRange: SequenceRange<number>;
-  readonly volume?: number;
-}
-/** Asset identity, either an old physical-only row or a directly composed media variant. */
-type ResourceEntityKind = 'image' | 'video' | 'audio' | 'voice';
 interface SandboxEntity<K extends KnownEntityKind = KnownEntityKind> {
   entity_id: string;
   entity_kind: K;
@@ -429,12 +355,6 @@ type SequentialClipAnchor = {
 } | {
   readonly position: 'trackStart';
 };
-interface SetBgmInput {
-  readonly timelineEntityId: string;
-  readonly bgmClipEntityId: string;
-  readonly media: AudioMediaAssetFact;
-  readonly volume: number;
-}
 interface SetCaptionVisibilityInput {
   readonly timelineEntityId: string;
   readonly hidden: boolean;
@@ -490,67 +410,8 @@ interface UpdateEntityInput {
   entity_id: string;
   payload: JsonObject;
 }
-interface VideoMediaAssetFact {
-  readonly assetId: string;
-  readonly kind: 'video';
-  readonly durationMs: number;
-  readonly storageKey?: string;
-}
-type VisualMediaAssetFact = ImageMediaAssetFact | VideoMediaAssetFact;
-interface VoiceDescriptor {
-  readonly system: 'voice-library';
-  readonly key: string;
-  readonly name?: string;
-}
-interface VoiceMediaAssetFact {
-  /** Stable external speech result id, independent of the placed Clip id. */
-  readonly assetId: string;
-  readonly kind: 'voice';
-  readonly durationMs: number;
-  readonly storageKey: string;
-  /** Present for synthesized voice, absent for original recorded audio. */
-  readonly voice?: VoiceDescriptor;
-}
-interface VoiceoverCaptionFact {
-  /** Stable placed caption identity supplied by the materialized side effect. */
-  readonly captionClipEntityId: string;
-  /** Directly held bases; includes the AudioScript used by the Voice. */
-  readonly baseEntityIds: readonly string[];
-  /** Ordered selection of AudioScript segments; caption text is never passed inline. */
-  readonly selections: readonly CaptionSegmentSelection[];
-  readonly startMs: number;
-  readonly durationMs: number;
-  readonly style?: CaptionStyleFields;
-}
-type VoiceoverTakeInput = {
-  readonly timelineEntityId: string; /** Stable placed speech identity, distinct from media.assetId. */
-  readonly voiceoverClipEntityId: string;
-  readonly media: VoiceMediaAssetFact; /** Existing pronunciation variant; its composed AudioScript stays the text owner. */
-  readonly phoneticScriptEntityId: string;
-  readonly volume: number;
-  readonly captions: readonly VoiceoverCaptionFact[];
-} & ({
-  readonly placement: ClipPlacement;
-  readonly hostClipEntityId?: never;
-  readonly anchorOffset?: never;
-} | {
-  readonly placement?: never;
-  readonly hostClipEntityId: string;
-  readonly anchorOffset: number;
-});
-interface VoiceoverTakeResult {
-  readonly voiceoverClipEntityId: string;
-  readonly voiceEntityId: string;
-  /** The pronunciation variant the Voice was rendered from. */
-  readonly phoneticScriptEntityId: string;
-  /** The base-text owner resolved from the PhoneticScript baseEntityIds. */
-  readonly audioScriptEntityId: string;
-  readonly captionClipEntityIds: readonly string[];
-}
 /** Timeline writes accept existing media Entity ids, never Memota asset ids or URLs. */
 interface EditApi {
-  /** Select the document AudioScript, or clear the optional association with null. */
-  setDocumentAudioScript(entityId: string | null): void;
   insertClip(input: InsertClipInput): ClipEntityId;
   insertPlacedClip(input: InsertPlacedClipInput): ClipEntityId;
   updateClipMarker(input: UpdateClipMarkerInput): void;
@@ -558,39 +419,35 @@ interface EditApi {
   moveSequentialClips(input: MoveSequentialClipsInput): void;
   moveClip(input: MoveClipInput): void;
   replaceClipContent(input: ReplaceClipContentInput): void;
-  insertMediaClip(input: InsertMediaClipInput): ClipEntityId;
-  insertMediaClips(input: InsertMediaClipsInput): readonly ClipEntityId[];
-  replaceMediaClip(input: ReplaceMediaClipInput): void;
   setClipVolume(input: SetClipVolumeInput): void;
   setClipSpeed(input: SetClipSpeedInput): void;
   trimClip(input: TrimClipInput): void;
-  replaceSequentialClips(input: ReplaceSequentialClipsInput): readonly ClipEntityId[];
   deleteClip(input: DeleteClipInput): void;
   deleteClipTree(input: DeleteClipTreeInput): void;
   updateClip(input: UpdateClipInput): void;
-  upsertVoiceoverTake(input: VoiceoverTakeInput): VoiceoverTakeResult;
   moveVoiceover(input: MoveVoiceoverInput): void;
   moveClipsToStarts(input: MoveClipsToStartsInput): void;
   deleteVoiceover(input: DeleteVoiceoverInput): void;
-  setBgm(input: SetBgmInput): ClipEntityId;
   deleteBgm(input: DeleteBgmInput): void;
   setCaptionVisibility(input: SetCaptionVisibilityInput): void;
   patchCaptionStyle(input: PatchCaptionStyleInput): void;
   insertCaptionClip(input: InsertCaptionClipInput): ClipEntityId;
 }
 interface TimelineApi {
-  snapshot(): EntityStoreSnapshot;
+  snapshot(): EntityStoreSnapshot & {
+    audioScriptEntityId: string;
+  };
 }
 interface SandboxCheckpoint {
   readonly index: number;
 }
 declare const edit: EditApi;
 declare const timeline: TimelineApi;
-declare const entities: EntityFacade;
-declare const relations: RelationFacade;
+declare const entities: BusinessEntityFacade;
+declare const relations: BusinessRelationFacade;
 declare function checkpoint(): SandboxCheckpoint;
 declare function rollbackTo(cp: SandboxCheckpoint): void;
 declare const inputs: Readonly<Record<string, unknown>>;
 //#endregion
-export type { AudioMediaAssetFact, BoundedDerivedSequencePayload, BoundedNativeSequencePayload, CaptionFontDescriptor, CaptionSegmentSelection, CaptionStyleFields, CaptionTextRange, CaptionTextSelection, ClipEntityId, ClipPlacement, ComposedPhoneticContent, ComposedScriptContent, CreateEntityInput, DeleteBgmInput, DeleteClipInput, DeleteClipTreeInput, DeleteEntityInput, DeleteVoiceoverInput, EditApi, EmptyRelationKind, EntityFacade, EntityId, EntityPayloadByKind, EntityStoreSnapshot, ImageMediaAssetFact, InsertCaptionClipInput, InsertClipInput, InsertMediaClipInput, InsertMediaClipsInput, InsertPlacedClipInput, JsonObject, JsonPrimitive, JsonValue, KnownEntityKind, KnownRelationKind, LinearClipSpeed, LinkAudioScriptSourceRelationInput, LinkClipAnchorRelationInput, LinkGeneratedRelationInput, LinkPhoneticScriptRenderRelationInput, LinkRelationInput, MediaAssetFact, MediaAssetPayload, MediaClipInsertion, MoveClipInput, MoveClipsToStartsInput, MoveSequentialClipsInput, MoveVoiceoverInput, PatchCaptionStyleInput, RelationFacade, ReplaceClipContentInput, ReplaceMediaClipInput, ReplaceSequentialClipsInput, ReplacementMediaClipInput, ResourceEntityKind, SandboxCheckpoint, SandboxEntity, SandboxRelation, ScriptTextSegment, SequenceDuration, SequenceRange, SequentialClipAnchor, SetBgmInput, SetCaptionVisibilityInput, SetClipPlacementInput, SetClipSpeedInput, SetClipVolumeInput, StoredEntityPayload, TimelineApi, TrimClipInput, UnboundedConstantSequencePayload, UnlinkRelationInput, UpdateClipInput, UpdateClipMarkerInput, UpdateEntityInput, VideoMediaAssetFact, VisualMediaAssetFact, VoiceDescriptor, VoiceMediaAssetFact, VoiceoverCaptionFact, VoiceoverTakeInput, VoiceoverTakeResult, checkpoint, edit, entities, inputs, relations, rollbackTo, timeline };
+export type { BoundedDerivedSequencePayload, BoundedNativeSequencePayload, BusinessEntityFacade, BusinessRelationFacade, CaptionFontDescriptor, CaptionSegmentSelection, CaptionStyleFields, CaptionTextRange, CaptionTextSelection, ClipEntityId, ClipPlacement, ComposedPhoneticContent, ComposedScriptContent, CreateEntityInput, DeleteBgmInput, DeleteClipInput, DeleteClipTreeInput, DeleteEntityInput, DeleteVoiceoverInput, EditApi, EmptyRelationKind, EntityId, EntityPayloadByKind, EntityStoreSnapshot, InsertCaptionClipInput, InsertClipInput, InsertPlacedClipInput, JsonObject, JsonPrimitive, JsonValue, KnownEntityKind, KnownRelationKind, LinearClipSpeed, LinkAudioScriptSourceRelationInput, LinkClipAnchorRelationInput, LinkGeneratedRelationInput, LinkPhoneticScriptRenderRelationInput, LinkRelationInput, MoveClipInput, MoveClipsToStartsInput, MoveSequentialClipsInput, MoveVoiceoverInput, PatchCaptionStyleInput, ReplaceClipContentInput, SandboxCheckpoint, SandboxEntity, SandboxRelation, ScriptTextSegment, SequenceDuration, SequenceRange, SequentialClipAnchor, SetCaptionVisibilityInput, SetClipPlacementInput, SetClipSpeedInput, SetClipVolumeInput, StoredEntityPayload, TimelineApi, TrimClipInput, UnboundedConstantSequencePayload, UnlinkRelationInput, UpdateClipInput, UpdateClipMarkerInput, UpdateEntityInput, checkpoint, edit, entities, inputs, relations, rollbackTo, timeline };
 //# sourceMappingURL=sandbox-api.d.mts.map

package/dist/{script-session-C2uQHYt4.mjs → script-session-DTq_VPEA.mjs}

@@ -183,7 +183,7 @@ function createId(value, label) {
 //#region ../medeo-dsl/src/json-values.ts
 const nativeObjectConstructorSource = Function.prototype.toString.call(Object);
 function isJsonObject(value) {
-	return isJsonValue(value, /* @__PURE__ */ new Set()) && !Array.isArray(value) && value !== null;
+	return typeof value === "object" && value !== null && !Array.isArray(value) && isJsonValue(value, /* @__PURE__ */ new Set());
 }
 function isJsonValue(value, ancestors) {
 	if (value === null || typeof value === "string" || typeof value === "boolean") return true;
@@ -422,9 +422,8 @@ function entityToRow(entity) {
 //#region ../medeo-dsl/src/invariants.ts
 /**
 * Media variants own their Asset identity directly: a `physical-asset`
-* Relation may not bind them. Caption text is composed domain content, so
-* Captions do not bind Physical Assets either; the Relation vocabulary stays
-* open for future physical pipeline semantics.
+* Relation may not bind them. Caption may associate with a physical text Asset
+* independently of its AudioScript composition.
 */
 function validateMediaAssetIdentity(entity, index) {
 	return [...index.relationsOf(entity)].filter((relation) => relation.kind === "physical-asset").map(() => ({
@@ -583,11 +582,6 @@ function validatePhoneticComposition(phonetic, index, entities = []) {
 }
 function validateVariantComposition(variant, index, entities, kind) {
 	const issues = [];
-	if (kind === "caption" && ofKind([...index.relationsOf(variant)], "physical-asset").length > 0) issues.push({
-		code: "caption_physical_asset_forbidden",
-		entityId: variant.entityId,
-		message: "Caption text is composed from its AudioScript; Caption must not bind a Physical Asset"
-	});
 	const rows = {
 		entities: collectRelatedEntities([...entities, variant], index).entities.map((ref) => entityToRow(ref.current())),
 		relations: []
@@ -1523,6 +1517,98 @@ function errorMessage(error) {
 	return error instanceof Error ? error.message : String(error);
 }
 //#endregion
+//#region src/sandbox/business-facades.ts
+/** Resource locators are host-owned even when stored on a typed media entity. */
+const infrastructureFields = new Set(["external", "storageKey"]);
+function businessEntity(entity) {
+	return {
+		...entity,
+		payload: Object.fromEntries(Object.entries(entity.payload).filter(([key]) => !infrastructureFields.has(key)))
+	};
+}
+function businessState(state) {
+	const assets = new Set(state.entities.filter((row) => row.entity_kind === "asset").map((row) => row.entity_id));
+	return {
+		revision: state.revision,
+		audioScriptEntityId: state.audioScriptEntityId,
+		entities: state.entities.filter((row) => !assets.has(row.entity_id)).map(businessEntity),
+		relations: state.relations.filter((row) => row.relation_kind !== "physical-asset" && !assets.has(row.endpoint_0_entity_id) && !assets.has(row.endpoint_1_entity_id))
+	};
+}
+/** Keep infrastructure rows available to assembly without exposing their management to scripts. */
+function businessFacades(entities, relations) {
+	const isAsset = (id) => entities.get(id)?.entity_kind === "asset";
+	const assertBusiness = (id) => {
+		if (isAsset(id)) throw new Error("Asset entities are managed by host assembly");
+	};
+	const assertBusinessPayload = (payload) => {
+		for (const field of infrastructureFields) if (Object.hasOwn(payload, field)) throw new Error(`Field ${field} is managed by host assembly`);
+		if (Array.isArray(payload.baseEntityIds)) {
+			for (const id of payload.baseEntityIds) if (typeof id === "string") assertBusiness(id);
+		}
+	};
+	const visibleRelation = (relation) => relation.relation_kind !== "physical-asset" && !isAsset(relation.endpoint_0_entity_id) && !isAsset(relation.endpoint_1_entity_id);
+	return {
+		entities: {
+			list: () => entities.list().filter((entity) => entity.entity_kind !== "asset").map(businessEntity),
+			get: (id) => {
+				const entity = entities.get(id);
+				return entity && !isAsset(id) ? businessEntity(entity) : null;
+			},
+			create: (input) => {
+				if (input.entity_kind === "asset") throw new Error("Asset entities are managed by host assembly");
+				assertBusinessPayload(input.payload);
+				return entities.create(input);
+			},
+			update: (input) => {
+				assertBusiness(input.entity_id);
+				assertBusinessPayload(input.payload);
+				entities.update(input);
+			},
+			declareFields: (input) => {
+				assertBusiness(input.entity_id);
+				assertBusinessPayload(input.payload);
+				entities.declareFields(input);
+			},
+			delete: (input) => {
+				assertBusiness(input.entity_id);
+				const incident = relations.of(input.entity_id);
+				if (incident.some(visibleRelation)) {
+					entities.delete(input);
+					return;
+				}
+				for (const relation of incident) relations.unlink({ relation_id: relation.relation_id });
+				entities.delete(input);
+			},
+			readCaptionContent: (input) => entities.readCaptionContent(input),
+			readPhoneticScriptContent: (input) => entities.readPhoneticScriptContent(input)
+		},
+		relations: {
+			list: () => relations.list().filter(visibleRelation),
+			of: (id, kind) => relations.of(id, kind).filter(visibleRelation),
+			link: (input) => {
+				if (input.relation_kind === "physical-asset") throw new Error("Asset bindings are managed by host assembly");
+				assertBusiness(input.endpoint_0_entity_id);
+				assertBusiness(input.endpoint_1_entity_id);
+				return relations.link(input);
+			},
+			unlink: (input) => {
+				const relation = relations.list().find((row) => row.relation_id === input.relation_id);
+				if (relation && !visibleRelation(relation)) throw new Error("Asset bindings are managed by host assembly");
+				relations.unlink(input);
+			},
+			linkGenerated: (input) => {
+				assertBusiness(input.output_entity_id);
+				assertBusiness(input.input_entity_id);
+				return relations.linkGenerated(input);
+			},
+			linkClipAnchor: (input) => relations.linkClipAnchor(input),
+			linkPhoneticScriptRender: (input) => relations.linkPhoneticScriptRender(input),
+			linkAudioScriptSource: (input) => relations.linkAudioScriptSource(input)
+		}
+	};
+}
+//#endregion
 //#region src/entity/entity-sandbox.ts
 const ASSET_SOURCE_KEY = "external";
 const MEMOTA_SYSTEM = "memota";
@@ -1560,16 +1646,11 @@ var EntitySandbox = class {
 	ensureFoundation(timelinePayload = {}) {
 		const foundation = ensureEditorFoundation(toDslRows(this.state), this.idFactory, timelinePayload);
 		this.appendResourceRows(foundation.rows);
+		if (this.state.audioScriptEntityId === null) this.state.audioScriptEntityId = foundation.audioScriptEntityId;
 	}
 	get audioScriptEntityId() {
 		return this.state.audioScriptEntityId;
 	}
-	setDocumentAudioScript(audioScriptEntityId) {
-		this.record({
-			kind: "set-document-audio-script",
-			audioScriptEntityId
-		});
-	}
 	rollbackTo(index) {
 		if (!Number.isInteger(index) || index < 0 || index > this.commands.length) throw new Error(`rollbackTo: entity checkpoint index ${index} is past journal length ${this.commands.length}`);
 		const prefix = this.commands.slice(0, index);
@@ -1582,11 +1663,13 @@ var EntitySandbox = class {
 	buildPlan() {
 		const rows = toDslRows(this.state);
 		decodeEntityRelationRows(rows, numericMarkerComparators);
-		assertCanonicalEditorResources(rows);
-		readDocumentAudioScript({
-			rows,
-			audioScriptEntityId: this.state.audioScriptEntityId
-		});
+		if (this.state.revision !== 0 || rows.entities.length !== 0 || this.commands.length !== 0) {
+			assertCanonicalEditorResources(rows);
+			readDocumentAudioScript({
+				rows,
+				audioScriptEntityId: this.state.audioScriptEntityId
+			});
+		}
 		const currentEntityIds = new Set(this.state.entities.map((entity) => entity.entity_id));
 		const currentRelationIds = new Set(this.state.relations.map((relation) => relation.relation_id));
 		return {
@@ -1600,9 +1683,6 @@ var EntitySandbox = class {
 	renderPreview() {
 		const lines = [`Entity plan: base_revision=${this.original.revision} commands=${this.commands.length} entities=${this.state.entities.length} relations=${this.state.relations.length}`];
 		for (const command of this.commands) switch (command.kind) {
-			case "set-document-audio-script":
-				lines.push(`~ document audioScriptEntityId=${command.audioScriptEntityId}`);
-				break;
 			case "create-entity":
 				lines.push(`+ entity ${command.entity.entity_id} kind=${command.entity.entity_kind}`);
 				break;
@@ -1722,6 +1802,10 @@ var EntitySandbox = class {
 		}
 		const entityId = input.entity_id ?? this.idFactory("entity");
 		assertTrimmed(entityId, "entity_id");
+		if (input.entity_kind === "audio-script") {
+			const existing = this.state.entities.find((entity) => entity.entity_kind === "audio-script");
+			if (existing !== void 0 && existing.entity_id !== entityId) throw new Error(`Editor requires exactly one AudioScript; edit ${existing.entity_id} instead of creating ${entityId}`);
+		}
 		const entity = {
 			entity_id: entityId,
 			entity_kind: input.entity_kind,
@@ -1949,18 +2033,13 @@ var EntitySandbox = class {
 	}
 	apply(command, enforceIdentity) {
 		switch (command.kind) {
-			case "set-document-audio-script":
-				readDocumentAudioScript({
-					rows: toDslRows(this.state),
-					audioScriptEntityId: command.audioScriptEntityId
-				});
-				this.state.audioScriptEntityId = command.audioScriptEntityId;
-				return;
 			case "create-entity": {
+				if (command.entity.entity_kind === "audio-script" && this.state.entities.some((entity) => entity.entity_kind === "audio-script")) throw new Error("The project AudioScript already exists; edit its segments instead");
 				if (enforceIdentity && this.state.entities.some((entity) => entity.entity_id === command.entity.entity_id)) throw new Error(`Entity id "${command.entity.entity_id}" already exists`);
 				const original = this.original.entities.find((entity) => entity.entity_id === command.entity.entity_id);
 				if (enforceIdentity && original != null && original.entity_kind !== command.entity.entity_kind) throw new Error(`Entity id "${command.entity.entity_id}" was originally kind "${original.entity_kind}" and cannot be recreated as "${command.entity.entity_kind}"`);
 				this.state.entities.push(clone(command.entity));
+				if (command.entity.entity_kind === "audio-script" && this.state.audioScriptEntityId === null) this.state.audioScriptEntityId = command.entity.entity_id;
 				return;
 			}
 			case "update-entity": {
@@ -1975,7 +2054,7 @@ var EntitySandbox = class {
 				return;
 			}
 			case "delete-entity": {
-				if (this.state.audioScriptEntityId === command.entity_id) throw new Error("Clear or switch the document AudioScript association before deleting its entity");
+				if (this.state.entities.find((entity) => entity.entity_id === command.entity_id)?.entity_kind === "audio-script") throw new Error("The document AudioScript is a fixed project identity and cannot be deleted");
 				const index = this.state.entities.findIndex((entity) => entity.entity_id === command.entity_id);
 				if (index < 0) throw new Error(`Entity id "${command.entity_id}" does not exist`);
 				const incidentRelationIds = this.state.relations.filter((relation) => relation.endpoint_0_entity_id === command.entity_id || relation.endpoint_1_entity_id === command.entity_id).map((relation) => relation.relation_id).sort();
@@ -2393,6 +2472,6 @@ function replayJournalSync(adapter, journal) {
 	}
 }
 //#endregion
-export { createRelationId as a, renderPreview as c, createEntityId as i, renderCompactProjection as l, EntitySandbox as n, isMediaAssetVariantKind as o, toDslRows as r, collectAffectedPartIds as s, EditSandboxSession as t };
+export { createEntityId as a, collectAffectedPartIds as c, businessState as i, renderPreview as l, EntitySandbox as n, createRelationId as o, businessFacades as r, isMediaAssetVariantKind as s, EditSandboxSession as t, renderCompactProjection as u };
 
-//# sourceMappingURL=script-session-C2uQHYt4.mjs.map
+//# sourceMappingURL=script-session-DTq_VPEA.mjs.map