@mengine/medeo-tool 1.2.1-alpha.7 → 1.2.1-alpha.9

package/dist/{script-session-BF44uKv_.mjs → script-session-CHyIUBkO.mjs}

@@ -196,11 +196,15 @@ function validateEntityRelationSet(entityRefs, index, options) {
 			}));
 			issues.push(...validateMarkerSourceBounds(marker, index, (left, right) => options.compareMarkerPoints(marker, "source", left, right)));
 		}
-		if (current.entityKind === "clip") issues.push(...validateClipAdmission(entity, index));
+		if (current.entityKind === "clip") {
+			issues.push(...validateClipAdmission(entity, index));
+			issues.push(...validateClipPlacement(entity, index));
+		}
 		if (current.entityKind === "axvideo") issues.push(...validateAXVideoAdmission(entity, index));
 		if (current.entityKind === "caption") issues.push(...validateCaptionAsset(entity, index));
 		issues.push(...validateSequenceComposition(entity));
 	}
+	issues.push(...validateClipAnchorCycles(entities, index));
 	return issues;
 }
 function validateMarkerUse(marker, index) {
@@ -269,13 +273,84 @@ function validateAXVideoAdmission(axVideo, index) {
 	}];
 }
 function validateCaptionAsset(caption, index) {
-	if (ofKind([...index.relationsOf(caption)], "physical-asset").some((relation) => relation.other(caption)?.deref()?.current().entityKind === "asset")) return [];
+	const assets = ofKind([...index.relationsOf(caption)], "physical-asset").map((relation) => relation.other(caption)?.deref()?.current()).filter((entity) => entity?.entityKind === "asset");
+	if (assets.length > 0) {
+		const captionText = caption.current().text;
+		if (!assets.some((asset) => {
+			const inline = asset.inline;
+			return isRecord(inline) && inline.mediaType === "text/plain" && inline.text !== captionText;
+		})) return [];
+		return [{
+			code: "caption_inline_asset_mismatch",
+			entityId: caption.entityId,
+			message: "Caption text must match the text/plain inline Physical Asset"
+		}];
+	}
 	return [{
 		code: "caption_asset_required",
 		entityId: caption.entityId,
 		message: "Caption must have a Physical Asset Relation"
 	}];
 }
+function validateClipPlacement(clip, index) {
+	const marker = ofKind([...index.relationsOf(clip)], "clip-marker")[0]?.other(clip)?.deref();
+	if (marker?.current().entityKind !== "sequence-marker") return [];
+	const markerValue = marker.current();
+	const anchors = ofKind([...index.relationsOf(clip)], "clip-anchor").filter((relation) => relation.endpoints[0].deref() === clip);
+	const hasOrder = clip.current().order !== void 0;
+	const hasTarget = markerValue.targetRange !== void 0;
+	const hasAnchorOffset = markerValue.anchorOffset !== void 0;
+	const issues = [];
+	if (anchors.length > 1) issues.push({
+		code: "clip_anchor_cardinality",
+		entityId: clip.entityId,
+		message: "A Clip may follow at most one host Clip"
+	});
+	const hasAnchor = anchors.length === 1;
+	if (hasAnchor && (!hasAnchorOffset || hasOrder || hasTarget) || !hasAnchor && (hasAnchorOffset || Number(hasOrder) + Number(hasTarget) !== 1)) issues.push({
+		code: "clip_placement_invalid",
+		entityId: clip.entityId,
+		message: "Clip placement must be exactly one of Clip.order, Marker.targetRange, or clip-anchor with Marker.anchorOffset"
+	});
+	if (markerValue.durationPolicy === "timeline") {
+		const content = ofKind([...index.relationsOf(marker)], "marker-content")[0]?.other(marker)?.deref()?.current();
+		const track = ofKind([...index.relationsOf(clip)], "track-clip")[0]?.other(clip)?.deref()?.current();
+		const trackRole = track?.entityKind === "track" ? track.role : void 0;
+		if (content?.entityKind !== "audio" || trackRole !== "bgm" || !hasOrder) issues.push({
+			code: "timeline_duration_policy_invalid",
+			entityId: marker.entityId,
+			message: "Marker durationPolicy \"timeline\" is only valid for ordered Audio Clips on the bgm Track"
+		});
+	}
+	return issues;
+}
+function validateClipAnchorCycles(entities, index) {
+	const hostByChild = /* @__PURE__ */ new Map();
+	for (const entity of entities) {
+		if (entity.current().entityKind !== "clip") continue;
+		for (const relation of ofKind([...index.relationsOf(entity)], "clip-anchor")) {
+			if (relation.endpoints[0].deref() !== entity) continue;
+			const host = relation.endpoints[1].deref();
+			if (host != null) hostByChild.set(entity.entityId, host.entityId);
+		}
+	}
+	const issues = [];
+	for (const child of hostByChild.keys()) {
+		const seen = /* @__PURE__ */ new Set();
+		let current = child;
+		while (current !== void 0 && !seen.has(current)) {
+			seen.add(current);
+			current = hostByChild.get(current);
+		}
+		if (current === void 0) continue;
+		issues.push({
+			code: "clip_anchor_cycle",
+			entityId: child,
+			message: "clip-anchor Relations must form an acyclic dependency graph"
+		});
+	}
+	return issues;
+}
 function validateMarkerRanges(marker, compare) {
 	const current = marker.current();
 	const issues = [];
@@ -330,7 +405,7 @@ function validateEntity(entity, entityIds = /* @__PURE__ */ new Set()) {
 		entityId: current.entityId,
 		message: `Entity "${current.entityKind}" ${problem}`
 	});
-	const peerIdPaths = [...collectPeerEntityIdPaths(current, current.entityKind), ...collectPeerEntityValuePaths(current, current.entityId, entityIds)];
+	const peerIdPaths = [...collectPeerEntityIdPaths(current, current.entityKind), ...collectPeerEntityValuePaths(current, current.entityKind, current.entityId, entityIds)];
 	const uniquePeerIdPaths = [...new Set(peerIdPaths)].sort();
 	if (uniquePeerIdPaths.length > 0) issues.push({
 		code: "peer_entity_id_field",
@@ -347,12 +422,15 @@ function validateKnownEntityPayload(entity) {
 		case "track":
 			validateOptionalField(value, "hidden", "boolean", problems);
 			validateOptionalField(value, "role", "string", problems);
+			validateOptionalFiniteNumber(value, "order", problems);
 			break;
 		case "video":
 		case "audio":
 		case "voice":
 		case "caption":
 			validateSequencePayload(value, "bounded", "native", problems);
+			if (entity.entityKind === "voice") validateVoicePayload(value, problems);
+			if (entity.entityKind === "caption") validateCaptionPayload(value, problems);
 			break;
 		case "image":
 			validateSequencePayload(value, "unbounded", "constant", problems);
@@ -368,9 +446,15 @@ function validateKnownEntityPayload(entity) {
 			validateScriptPayload(value, problems);
 			break;
 		case "timeline":
+		case "viewport": break;
 		case "clip":
+			validateOptionalFiniteNumber(value, "order", problems);
+			validateOptionalFiniteNumber(value, "volume", problems);
+			if (typeof value.volume === "number" && (value.volume < -60 || value.volume > 20)) problems.push("volume must be decibels between -60 and 20");
+			break;
 		case "asset":
-		case "viewport": break;
+			validateAssetPayload(value, problems);
+			break;
 		default: break;
 	}
 	return problems;
@@ -395,6 +479,63 @@ function validateMarkerPayload(value, problems) {
 	else if (duration.mode === "fixed") {
 		if (!Object.hasOwn(duration, "value") || duration.value === void 0) problems.push("duration.value is required when duration.mode is \"fixed\"");
 	} else if (duration.mode !== "from-source") problems.push("duration.mode must be \"from-source\" or \"fixed\"");
+	if (value.anchorOffset === void 0 && Object.hasOwn(value, "anchorOffset")) problems.push("anchorOffset cannot be undefined when present");
+	if (value.durationPolicy !== void 0 && value.durationPolicy !== "timeline") problems.push("durationPolicy must be \"timeline\" when present");
+}
+function validateAssetPayload(value, problems) {
+	const external = value.external;
+	if (external !== void 0) if (!isRecord(external)) problems.push("external must be an object when present");
+	else {
+		if (external.system !== "memota" && external.system !== "memota-speech") problems.push("external.system must be \"memota\" or \"memota-speech\"");
+		if (typeof external.key !== "string" || external.key.trim() === "") problems.push("external.key must be a non-empty string");
+	}
+	if (value.storageKey !== void 0 && (typeof value.storageKey !== "string" || value.storageKey.trim() === "")) problems.push("storageKey must be a non-empty string when present");
+	const inline = value.inline;
+	if (inline !== void 0) if (!isRecord(inline)) problems.push("inline must be an object when present");
+	else {
+		if (inline.mediaType !== "text/plain") problems.push("inline.mediaType must be \"text/plain\"");
+		if (typeof inline.text !== "string") problems.push("inline.text must be a string");
+	}
+	if (external !== void 0 && inline !== void 0) problems.push("Asset must not combine external and inline physical locations");
+}
+function validateVoicePayload(value, problems) {
+	const voice = value.voice;
+	if (voice === void 0) return;
+	if (!isRecord(voice)) {
+		problems.push("voice must be an object when present");
+		return;
+	}
+	if (voice.system !== "voice-library") problems.push("voice.system must be \"voice-library\"");
+	if (typeof voice.key !== "string" || voice.key.trim() === "") problems.push("voice.key must be a non-empty string");
+	if (voice.name !== void 0 && typeof voice.name !== "string") problems.push("voice.name must be a string when present");
+}
+function validateCaptionPayload(value, problems) {
+	if (value.text !== void 0 && typeof value.text !== "string") problems.push("text must be a string when present");
+	const style = value.style;
+	if (style === void 0) return;
+	if (!isRecord(style)) {
+		problems.push("style must be an object when present");
+		return;
+	}
+	const font = style.font;
+	if (font !== void 0) if (!isRecord(font)) problems.push("style.font must be an object when present");
+	else {
+		if (font.system !== "font-library") problems.push("style.font.system must be \"font-library\"");
+		if (typeof font.key !== "string" || font.key.trim() === "") problems.push("style.font.key must be a non-empty string");
+	}
+	for (const key of [
+		"fontSize",
+		"fontWeight",
+		"entranceAnimationDurationMs",
+		"strokeWidth",
+		"positionX",
+		"positionY"
+	]) validateOptionalFiniteNumber(style, key, problems, `style.${key}`);
+	for (const key of [
+		"fontColor",
+		"entranceAnimation",
+		"strokeColor"
+	]) if (style[key] !== void 0 && typeof style[key] !== "string") problems.push(`style.${key} must be a string`);
 }
 function validateRange(value, path, required, problems) {
 	if (!isRecord(value)) {
@@ -422,6 +563,9 @@ function validateScriptPayload(value, problems) {
 function validateOptionalField(value, key, expectedType, problems) {
 	if (value[key] !== void 0 && typeof value[key] !== expectedType) problems.push(`${key} must be a ${expectedType} when present`);
 }
+function validateOptionalFiniteNumber(value, key, problems, label = key) {
+	if (value[key] !== void 0 && (typeof value[key] !== "number" || !Number.isFinite(value[key]))) problems.push(`${label} must be a finite number when present`);
+}
 function collectPeerEntityIdPaths(value, entityKind) {
 	const paths = [];
 	visitPeerEntityIdPaths(value, entityKind, "", /* @__PURE__ */ new Set(), paths);
@@ -439,25 +583,42 @@ function visitPeerEntityIdPaths(value, entityKind, parentPath, ancestors, paths)
 	}
 	ancestors.delete(value);
 }
-function collectPeerEntityValuePaths(value, ownEntityId, entityIds) {
+function collectPeerEntityValuePaths(value, entityKind, ownEntityId, entityIds) {
 	const paths = [];
-	visitPeerEntityValues(value, ownEntityId, entityIds, "", /* @__PURE__ */ new Set(), paths);
+	visitPeerEntityValues(value, entityKind, ownEntityId, entityIds, "", /* @__PURE__ */ new Set(), paths);
 	return paths;
 }
-function visitPeerEntityValues(value, ownEntityId, entityIds, path, ancestors, paths) {
+function visitPeerEntityValues(value, entityKind, ownEntityId, entityIds, path, ancestors, paths) {
 	if (typeof value === "string") {
-		if (value !== ownEntityId && entityIds.has(value)) paths.push(path);
+		if (value !== ownEntityId && entityIds.has(value) && !isOwnedLocalEntityValuePath(entityKind, path)) paths.push(path);
 		return;
 	}
 	if (typeof value !== "object" || value == null || ancestors.has(value)) return;
 	ancestors.add(value);
-	if (Array.isArray(value)) for (const [index, item] of value.entries()) visitPeerEntityValues(item, ownEntityId, entityIds, `${path}[${index}]`, ancestors, paths);
+	if (Array.isArray(value)) for (const [index, item] of value.entries()) visitPeerEntityValues(item, entityKind, ownEntityId, entityIds, `${path}[${index}]`, ancestors, paths);
 	else for (const [key, child] of Object.entries(value)) {
 		if (path.length === 0 && (key === "entityId" || key === "entityKind")) continue;
-		visitPeerEntityValues(child, ownEntityId, entityIds, path.length === 0 ? key : `${path}.${key}`, ancestors, paths);
+		visitPeerEntityValues(child, entityKind, ownEntityId, entityIds, path.length === 0 ? key : `${path}.${key}`, ancestors, paths);
 	}
 	ancestors.delete(value);
 }
+function isOwnedLocalEntityValuePath(entityKind, path) {
+	if (entityKind === "track" && path === "role") return true;
+	if ([
+		"video",
+		"audio",
+		"voice",
+		"image",
+		"caption",
+		"axvideo"
+	].includes(entityKind) && /^(?:sampling|coordinateSpace|coordinateSpace\.unit|extent\.kind)$/.test(path)) return true;
+	if (entityKind === "sequence-marker" && /^(?:durationPolicy|duration\.mode|timeRemapping\.(?:kind|mode))$/.test(path)) return true;
+	if (entityKind === "asset" && /^(?:external\.(?:system|key)|storageKey|inline\.(?:mediaType|text))$/.test(path)) return true;
+	if (entityKind === "voice" && /^voice\.(?:system|key|name)$/.test(path)) return true;
+	if (entityKind === "caption" && (path === "text" || path.startsWith("style."))) return true;
+	if ((entityKind === "audio-script" || entityKind === "phonetic-script") && /^segments\[\d+\]\.(?:segmentId|text|language)$/.test(path)) return true;
+	return false;
+}
 function isOwnedLocalIdPath(entityKind, path) {
 	if (path === "lifecycle.actorId") return true;
 	if ((entityKind === "audio-script" || entityKind === "phonetic-script") && /^segments\[\d+\]\.segmentId$/.test(path)) return true;
@@ -516,6 +677,7 @@ function ofKind(relations, kind) {
 }
 //#endregion
 //#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;
 }
@@ -523,14 +685,25 @@ function isJsonValue(value, ancestors) {
 	if (value === null || typeof value === "string" || typeof value === "boolean") return true;
 	if (typeof value === "number") return Number.isFinite(value);
 	if (typeof value !== "object") return false;
-	const prototype = Object.getPrototypeOf(value);
-	if (!Array.isArray(value) && prototype !== Object.prototype && prototype !== null) return false;
+	if (!Array.isArray(value) && !isPlainObject(value)) return false;
 	if (ancestors.has(value)) return false;
 	ancestors.add(value);
 	const valid = Array.isArray(value) ? value.every((item) => isJsonValue(item, ancestors)) : Object.values(value).every((item) => isJsonValue(item, ancestors));
 	ancestors.delete(value);
 	return valid;
 }
+/** Recognize an ordinary object from any VM realm without admitting class instances. */
+function isPlainObject(value) {
+	try {
+		const prototype = Object.getPrototypeOf(value);
+		if (prototype === null) return true;
+		if (Object.getPrototypeOf(prototype) !== null) return false;
+		const constructor = Object.getOwnPropertyDescriptor(prototype, "constructor")?.value;
+		return typeof constructor === "function" && constructor.prototype === prototype && Function.prototype.toString.call(constructor) === nativeObjectConstructorSource;
+	} catch {
+		return false;
+	}
+}
 //#endregion
 //#region ../medeo-dsl/src/relation-specs.ts
 const timelineTrackRelationSpec = emptySpec("timeline-track", "timeline", "track");
@@ -561,6 +734,21 @@ const captionAlignmentRelationSpec = Object.freeze({
 	validateEndpoints: (endpoints) => hasKinds(endpoints, new Set(["caption"]), new Set(["audio", "voice"])),
 	validateMetadata: isCaptionAlignmentMetadata
 });
+/** `clip-anchor(child, host)` means endpoint 0 follows endpoint 1. */
+const clipAnchorRelationSpec = Object.freeze({
+	kind: "clip-anchor",
+	validateEndpoints: (endpoints) => endpoints[0].current().entityKind === "clip" && endpoints[1].current().entityKind === "clip",
+	validateMetadata: isEmptyMetadata
+});
+/** `audio-script-render(output, script)` means endpoint 0 was rendered from endpoint 1. */
+const audioScriptRenderRelationSpec = Object.freeze({
+	kind: "audio-script-render",
+	validateEndpoints: (endpoints) => {
+		const outputKind = endpoints[0].current().entityKind;
+		return (outputKind === "audio" || outputKind === "voice") && endpoints[1].current().entityKind === "audio-script";
+	},
+	validateMetadata: isEmptyMetadata
+});
 /** Built-in kinds are reserved; callers may add specs only under new names. */
 const builtInRelationSpecs = Object.freeze([
 	timelineTrackRelationSpec,
@@ -573,7 +761,9 @@ const builtInRelationSpecs = Object.freeze([
 	generatedRelationSpec,
 	phoneticScriptProvenanceRelationSpec,
 	captionProvenanceRelationSpec,
-	captionAlignmentRelationSpec
+	captionAlignmentRelationSpec,
+	clipAnchorRelationSpec,
+	audioScriptRenderRelationSpec
 ]);
 function emptySpec(kind, a, b) {
 	return metadataSpec(kind, a, b, isEmptyMetadata);
@@ -670,6 +860,7 @@ var BiRelationIndex = class {
 	byRelationId = /* @__PURE__ */ new Map();
 	link(input) {
 		if (input.spec.kind === "generated") throw new Error("Author generated Relations with linkGenerated({ output, input })");
+		if (input.spec.kind === "clip-anchor" || input.spec.kind === "audio-script-render") throw new Error(`Author ordered ${input.spec.kind} Relations with the dedicated role-named method`);
 		return this.linkValidated(input);
 	}
 	/** Author `generated(output, input)` without exposing positional arguments. */
@@ -682,6 +873,26 @@ var BiRelationIndex = class {
 			trace: input.trace
 		});
 	}
+	/** Author `clip-anchor(child, host)` without exposing positional arguments. */
+	linkClipAnchor(input) {
+		return this.linkValidated({
+			relationId: input.relationId,
+			spec: clipAnchorRelationSpec,
+			endpoints: [input.child, input.host],
+			metadata: {},
+			trace: input.trace
+		});
+	}
+	/** Author `audio-script-render(output, script)` without exposing positional arguments. */
+	linkAudioScriptRender(input) {
+		return this.linkValidated({
+			relationId: input.relationId,
+			spec: audioScriptRenderRelationSpec,
+			endpoints: [input.output, input.script],
+			metadata: {},
+			trace: input.trace
+		});
+	}
 	/**
 	* Rehydrate a persisted row after resolving its spec and endpoint refs.
 	*
@@ -955,17 +1166,36 @@ var EntitySandbox = class {
 	}
 	buildPlan() {
 		decodeEntityRelationRows(toDslRows(this.state), numericMarkerComparators);
+		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 {
 			base_revision: this.original.revision,
 			commands: this.commands.slice(),
-			rows: cloneSnapshot(this.state)
+			rows: cloneSnapshot(this.state),
+			deleted_entity_ids: this.original.entities.map((entity) => entity.entity_id).filter((entityId) => !currentEntityIds.has(entityId)).sort(),
+			deleted_relation_ids: this.original.relations.map((relation) => relation.relation_id).filter((relationId) => !currentRelationIds.has(relationId)).sort()
 		};
 	}
 	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) if (command.kind === "create-entity") lines.push(`+ entity ${command.entity.entity_id} kind=${command.entity.entity_kind}`);
-		else if (command.relation.relation_kind === "generated") lines.push(`+ relation ${command.relation.relation_id} generated(output=${command.relation.endpoint_0_entity_id}, input=${command.relation.endpoint_1_entity_id})`);
-		else lines.push(`+ relation ${command.relation.relation_id} kind=${command.relation.relation_kind} endpoints=${command.relation.endpoint_0_entity_id},${command.relation.endpoint_1_entity_id}`);
+		for (const command of this.commands) switch (command.kind) {
+			case "create-entity":
+				lines.push(`+ entity ${command.entity.entity_id} kind=${command.entity.entity_kind}`);
+				break;
+			case "update-entity":
+				lines.push(`~ entity ${command.entity_id} payload`);
+				break;
+			case "delete-entity":
+				lines.push(`- entity ${command.entity_id}`);
+				break;
+			case "unlink-relation":
+				lines.push(`- relation ${command.relation_id}`);
+				break;
+			case "link-relation":
+				if (command.relation.relation_kind === "generated") lines.push(`+ relation ${command.relation.relation_id} generated(output=${command.relation.endpoint_0_entity_id}, input=${command.relation.endpoint_1_entity_id})`);
+				else lines.push(`+ relation ${command.relation.relation_id} kind=${command.relation.relation_kind} endpoints=${command.relation.endpoint_0_entity_id},${command.relation.endpoint_1_entity_id}`);
+				break;
+		}
 		return lines.join("\n");
 	}
 	buildEntityFacade() {
@@ -980,6 +1210,8 @@ var EntitySandbox = class {
 				return clone(this.state.entities.filter((entity) => entity.entity_kind === "asset" && isImportedMemotaAsset(entity.payload, assetId)));
 			},
 			create: (input) => this.createEntity(input),
+			update: (input) => this.updateEntity(input),
+			delete: (input) => this.deleteEntity(input),
 			importAsset: (input) => this.importAsset(input)
 		};
 	}
@@ -992,7 +1224,10 @@ var EntitySandbox = class {
 				return clone(this.state.relations.filter((relation) => (relation.endpoint_0_entity_id === entityId || relation.endpoint_1_entity_id === entityId) && (relationKind === void 0 || relation.relation_kind === relationKind)));
 			},
 			link: (input) => this.link(input),
-			linkGenerated: (input) => this.linkGenerated(input)
+			linkGenerated: (input) => this.linkGenerated(input),
+			linkClipAnchor: (input) => this.linkClipAnchor(input),
+			linkAudioScriptRender: (input) => this.linkAudioScriptRender(input),
+			unlink: (input) => this.unlinkRelation(input)
 		};
 	}
 	createEntity(input) {
@@ -1017,6 +1252,23 @@ var EntitySandbox = class {
 		});
 		return entityId;
 	}
+	updateEntity(input) {
+		assertTrimmed(input.entity_id, "entity_id");
+		const payload = clone(input.payload);
+		if (!isJsonObject(payload)) throw new Error("Entity payload must contain only JSON values");
+		this.record({
+			kind: "update-entity",
+			entity_id: input.entity_id,
+			payload
+		});
+	}
+	deleteEntity(input) {
+		assertTrimmed(input.entity_id, "entity_id");
+		this.record({
+			kind: "delete-entity",
+			entity_id: input.entity_id
+		});
+	}
 	importAsset(input) {
 		assertTrimmed(input.asset_id, "asset_id");
 		const payload = input.payload === void 0 ? {} : clone(input.payload);
@@ -1073,6 +1325,55 @@ var EntitySandbox = class {
 		});
 		return relation.relation_id;
 	}
+	linkClipAnchor(input) {
+		const relation = this.relationFromInput({
+			...input.relation_id !== void 0 ? { relation_id: input.relation_id } : {},
+			endpoint_0_entity_id: input.child_clip_entity_id,
+			endpoint_1_entity_id: input.host_clip_entity_id,
+			metadata: {},
+			...input.trace !== void 0 ? { trace: input.trace } : {}
+		}, "clip-anchor");
+		const [child, host] = this.refsFor(relation);
+		new BiRelationIndex().linkClipAnchor({
+			relationId: createRelationId(relation.relation_id),
+			child,
+			host,
+			trace: relation.trace
+		});
+		this.record({
+			kind: "link-relation",
+			relation
+		});
+		return relation.relation_id;
+	}
+	linkAudioScriptRender(input) {
+		const relation = this.relationFromInput({
+			...input.relation_id !== void 0 ? { relation_id: input.relation_id } : {},
+			endpoint_0_entity_id: input.output_entity_id,
+			endpoint_1_entity_id: input.script_entity_id,
+			metadata: {},
+			...input.trace !== void 0 ? { trace: input.trace } : {}
+		}, "audio-script-render");
+		const [output, script] = this.refsFor(relation);
+		new BiRelationIndex().linkAudioScriptRender({
+			relationId: createRelationId(relation.relation_id),
+			output,
+			script,
+			trace: relation.trace
+		});
+		this.record({
+			kind: "link-relation",
+			relation
+		});
+		return relation.relation_id;
+	}
+	unlinkRelation(input) {
+		assertTrimmed(input.relation_id, "relation_id");
+		this.record({
+			kind: "unlink-relation",
+			relation_id: input.relation_id
+		});
+	}
 	relationFromInput(input, relationKind) {
 		const relationId = input.relation_id ?? this.idFactory("relation");
 		assertTrimmed(relationId, "relation_id");
@@ -1105,13 +1406,48 @@ var EntitySandbox = class {
 		this.onCommand?.(clone(command));
 	}
 	apply(command, enforceIdentity) {
-		if (command.kind === "create-entity") {
-			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`);
-			this.state.entities.push(clone(command.entity));
-			return;
+		switch (command.kind) {
+			case "create-entity": {
+				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));
+				return;
+			}
+			case "update-entity": {
+				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 current = this.state.entities[index];
+				if (current == null) throw new Error(`Entity id "${command.entity_id}" does not exist`);
+				this.state.entities[index] = {
+					...current,
+					payload: clone(command.payload)
+				};
+				return;
+			}
+			case "delete-entity": {
+				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();
+				if (incidentRelationIds.length > 0) throw new Error(`Entity id "${command.entity_id}" still has incident Relation id(s): ${incidentRelationIds.join(", ")}`);
+				this.state.entities.splice(index, 1);
+				return;
+			}
+			case "link-relation":
+				if (enforceIdentity && this.state.relations.some((relation) => relation.relation_id === command.relation.relation_id)) throw new Error(`Relation id "${command.relation.relation_id}" already exists`);
+				if (enforceIdentity) {
+					const original = this.original.relations.find((relation) => relation.relation_id === command.relation.relation_id);
+					if (original != null && (original.relation_kind !== command.relation.relation_kind || original.endpoint_0_entity_id !== command.relation.endpoint_0_entity_id || original.endpoint_1_entity_id !== command.relation.endpoint_1_entity_id)) throw new Error(`Relation id "${command.relation.relation_id}" cannot change its kind or persisted endpoint positions`);
+				}
+				this.state.relations.push(clone(command.relation));
+				return;
+			case "unlink-relation": {
+				const index = this.state.relations.findIndex((relation) => relation.relation_id === command.relation_id);
+				if (index < 0) throw new Error(`Relation id "${command.relation_id}" does not exist`);
+				this.state.relations.splice(index, 1);
+				return;
+			}
 		}
-		if (enforceIdentity && this.state.relations.some((relation) => relation.relation_id === command.relation.relation_id)) throw new Error(`Relation id "${command.relation.relation_id}" already exists`);
-		this.state.relations.push(clone(command.relation));
 	}
 };
 function isImportedMemotaAsset(payload, assetId) {
@@ -1230,6 +1566,10 @@ var EditSandboxSession = class {
 			entity_base_revision: entityPlan.base_revision,
 			entity_commands: entityPlan.commands,
 			...planKind === "entities" ? { entity_rows: entityPlan.rows } : {},
+			...planKind === "entities" ? {
+				deleted_entity_ids: entityPlan.deleted_entity_ids,
+				deleted_relation_ids: entityPlan.deleted_relation_ids
+			} : {},
 			preview: planKind === "entities" ? this.entitySandbox.renderPreview() : renderPreview(this.current.adapter.snapshot(), this.entries),
 			logs: this.logs.slice()
 		};
@@ -1496,6 +1836,6 @@ function replayJournalSync(adapter, journal) {
 	}
 }
 //#endregion
-export { renderCompactProjection as i, collectAffectedPartIds as n, renderPreview as r, EditSandboxSession as t };
+export { collectAffectedPartIds as a, createRelationId as i, EntitySandbox as n, renderPreview as o, createEntityId as r, renderCompactProjection as s, EditSandboxSession as t };
 
-//# sourceMappingURL=script-session-BF44uKv_.mjs.map
+//# sourceMappingURL=script-session-CHyIUBkO.mjs.map