@mengine/medeo-tool 1.3.1-alpha.6 → 1.3.1-alpha.9

package/dist/{entity-contract-hKZbJSRP.d.mts → entity-contract-SQdOaLm-.d.mts}

@@ -139,6 +139,8 @@ interface SandboxRelation {
 }
 interface EntityStoreSnapshot {
   revision: number;
+  /** Fixed identity outlet of the project's one AudioScript; null only before initialization (revision 0). */
+  audioScriptEntityId: string | null;
   entities: SandboxEntity[];
   relations: SandboxRelation[];
 }
@@ -269,4 +271,4 @@ interface RelationFacade {
 }
 //#endregion
 export { SandboxEntity as _, EntityFacade as a, UpdateEntityInput as b, JsonObject as c, KnownEntityKind as d, KnownRelationKind as f, ResourceEntityKind as g, RelationFacade as h, EntityCommand as i, JsonPrimitive as l, LinkRelationInput as m, CreateEntityInput as n, EntityPlanState as o, LinkGeneratedRelationInput as p, DeleteEntityInput as r, EntityStoreSnapshot as s, AuthorableRelationKind as t, JsonValue as u, SandboxRelation as v, UnlinkRelationInput as y };
-//# sourceMappingURL=entity-contract-hKZbJSRP.d.mts.map
+//# sourceMappingURL=entity-contract-SQdOaLm-.d.mts.map

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { _ as SandboxEntity, a as EntityFacade, b as UpdateEntityInput, c as JsonObject, d as KnownEntityKind, f as KnownRelationKind, g as ResourceEntityKind, h as RelationFacade, i as EntityCommand, l as JsonPrimitive, m as LinkRelationInput, n as CreateEntityInput, o as EntityPlanState, p as LinkGeneratedRelationInput, r as DeleteEntityInput, s as EntityStoreSnapshot, t as AuthorableRelationKind, u as JsonValue, v as SandboxRelation, y as UnlinkRelationInput } from "./entity-contract-hKZbJSRP.mjs";
+import { _ as SandboxEntity, a as EntityFacade, b as UpdateEntityInput, c as JsonObject, d as KnownEntityKind, f as KnownRelationKind, g as ResourceEntityKind, h as RelationFacade, i as EntityCommand, l as JsonPrimitive, m as LinkRelationInput, n as CreateEntityInput, o as EntityPlanState, p as LinkGeneratedRelationInput, r as DeleteEntityInput, s as EntityStoreSnapshot, t as AuthorableRelationKind, u as JsonValue, v as SandboxRelation, y as UnlinkRelationInput } from "./entity-contract-SQdOaLm-.mjs";
 import { JournalEntry, ManualSyncDoc, MediaAssetFact, PartIdFactory, SemanticOpName, VideoDocument, VideoDraft, fromVideoDocument } from "@mengine/medeo-client";
 import { AddSpeechesInput, AddVideoClipsInput, AdjustBgmVolumeInput, AdjustSpeechVolumeInput, AdjustVideoClipDurationInput, AdjustVideoClipVolumeInput, ChangeSpeechScriptInput, ChangeSpeechVoiceInput, DeleteBgmInput, DeleteSpeechesInput, DeleteVideoClipsInput, MoveSpeechesInput, MoveVideoClipsByAnchorInput, MoveVideoClipsInput, ReplaceVideoClipContentInput, ReplaceVideoClipSequenceInput, SetBgmInput, SetCaptionStyleInput, SetCaptionVisibilityInput, SetVideoClipSpeedShiftInput } from "@mengine/medeo-client/schemas";
 

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { c as renderPreview, l as renderCompactProjection, n as EntitySandbox, o as isMediaAssetVariantKind, r as toDslRows, s as collectAffectedPartIds, t as EditSandboxSession } from "./script-session-1eqBGegp.mjs";
+import { c as renderPreview, l as renderCompactProjection, n as EntitySandbox, o as isMediaAssetVariantKind, r as toDslRows, s as collectAffectedPartIds, t as EditSandboxSession } from "./script-session-B2UQ1W_y.mjs";
 import { EntityGraphHttpClient, ManualSyncDoc, MengineHttpClient, MengineHttpRequestError, ValidationError, createMirrorVideoDocument, createPlainMemoryAdapter, decodeDocVersionMark, encodeDocVersionMark, migrateLegacyTimelineToEntities, replayJournal, toVideoDocument } from "@mengine/medeo-client";
 import { Worker } from "node:worker_threads";
 import { randomUUID } from "node:crypto";
@@ -279,9 +279,14 @@ function toSnapshot(value, expectedDocId) {
 	if (!isRecord$2(value) || typeof value.doc_id !== "string" || !isNonNegativeInteger(value.revision)) throw new Error("invalid entity-state response envelope");
 	if (value.doc_id !== expectedDocId) throw new Error(`entity-state response doc_id mismatch: expected "${expectedDocId}"`);
 	if (!isRecord$2(value.rows) || !Array.isArray(value.rows.entities) || !Array.isArray(value.rows.relations)) throw new Error("invalid entity-state response rows");
+	if (value.audio_script_entity_id === null) {
+		if (value.revision !== 0) throw new Error("Document AudioScript is not initialized");
+	} else if (!isTrimmed(value.audio_script_entity_id)) throw new Error("invalid document AudioScript identity");
 	const response = value;
+	if (response.audio_script_entity_id !== null && !response.rows.entities.some((entity) => entity.entity_id === response.audio_script_entity_id && entity.entity_kind === "audio-script")) throw new Error("Document AudioScript must name the project AudioScript");
 	return {
 		revision: response.revision,
+		audioScriptEntityId: response.audio_script_entity_id,
 		entities: response.rows.entities.map(parseEntity),
 		relations: response.rows.relations.map(parseRelation)
 	};
@@ -790,6 +795,8 @@ const ENTITY_EDIT_SANDBOX_API_DTS = [
 	"}",
 	"export interface EntityStoreSnapshot {",
 	"  revision: number;",
+	"  /** Fixed identity outlet of the project's one AudioScript; null only before initialization (revision 0). */",
+	"  audioScriptEntityId: string | null;",
 	"  entities: SandboxEntity[];",
 	"  relations: SandboxRelation[];",
 	"}",
@@ -1219,7 +1226,9 @@ const ENTITY_EDIT_SANDBOX_API_DTS = [
 	"  insertCaptionClip(input: InsertCaptionClipInput): ClipEntityId;",
 	"}",
 	"export interface TimelineApi {",
-	"  snapshot(): EntityStoreSnapshot;",
+	"  snapshot(): EntityStoreSnapshot & {",
+	"    audioScriptEntityId: string;",
+	"  };",
 	"}",
 	"export interface SandboxCheckpoint {",
 	"  readonly index: number;",
@@ -1259,7 +1268,7 @@ The compatibility reader supports the existing four Track roles: video_clip (Ima
 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.
 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. The host initializes one Timeline and four fixed Tracks before editing; inspect and reuse their IDs from timeline.snapshot(), never create another Timeline or Track for each operation. If snapshot reports legacy migration is required, recall the listed asset facts and call migrate-legacy first. Missing facts, unsupported layouts, and version conflicts fail closed; never fall back to an old timeline method or raw update endpoint.
+Create only the known entity kinds. The host initializes one Timeline, four fixed Tracks, and the project's single AudioScript (initially segments:[]) before editing; inspect and reuse their IDs from timeline.snapshot(), never create another Timeline, Track, or AudioScript for each operation. The AudioScript identity is fixed for the project: edit its segments in place via entities.update, never delete or re-create it. If snapshot reports legacy migration is required, recall the listed asset facts and call migrate-legacy first. Missing facts, unsupported layouts, and version conflicts fail closed; never fall back to an old timeline method or raw update endpoint.
 Use only the globals and methods declared by the following TypeScript interface. Values not declared here are unavailable.
 `.trim();
 /** Render the complete MEngine-owned context injected before one model call. */
@@ -1614,7 +1623,7 @@ function renderEntitySnapshot(state) {
 	const rows = [...state.entities.map((entity) => JSON.stringify(entity)), ...state.relations.map((relation) => JSON.stringify(relation))];
 	const shown = rows.slice(0, 200);
 	return [
-		`Entity revision=${state.revision} entities=${state.entities.length} relations=${state.relations.length}`,
+		`Entity revision=${state.revision} audioScriptEntityId=${JSON.stringify(state.audioScriptEntityId)} entities=${state.entities.length} relations=${state.relations.length}`,
 		...shown,
 		...shown.length < rows.length ? ["[truncated; inspect entities/relations in the sandbox]"] : []
 	].join("\n");
@@ -1706,6 +1715,7 @@ function commitWarnings(result) {
 }
 function entityRowsEquivalent(left, right) {
 	const normalize = (state) => ({
+		audioScriptEntityId: state.audioScriptEntityId,
 		entities: [...state.entities].sort((a, b) => a.entity_id.localeCompare(b.entity_id)).map((entity) => canonicalJson(entity)),
 		relations: [...state.relations].sort((a, b) => a.relation_id.localeCompare(b.relation_id)).map((relation) => canonicalJson(relation))
 	});
@@ -2055,23 +2065,26 @@ function createMedeoTool(options) {
 	async function migrate(input) {
 		return runExclusive(input.doc_id, async (doc) => {
 			assertNoPendingPush(input.doc_id);
-			const client = getGraphClient(input.doc_id);
-			const base = await client.fetchState();
-			if (base.rows.entities.some((row) => row.entityKind === "timeline")) return {
+			const snapshotState = await getEntityClient(input.doc_id).fetchState();
+			if (snapshotState.entities.some((row) => row.entity_kind === "timeline")) return {
 				ok: true,
 				op: "migrate-legacy",
 				doc_id: input.doc_id,
 				migration_status: "already_entity",
-				entity_revision: base.revision,
+				entity_revision: snapshotState.revision,
 				next_action: "snapshot"
 			};
 			const pull = await doc.pull();
 			if (!pull.ok) throw new Error(`Migration requires a fresh canonical snapshot: ${pull.error.message}`);
 			const migrationBaseVv = encodeDocVersionMark(doc.versionMark());
-			const nextRows = migrateLegacyTimelineToEntities(doc.snapshot(), input.asset_facts, base.rows);
+			const baseRows = toDslRows(snapshotState);
+			const nextRows = migrateLegacyTimelineToEntities(doc.snapshot(), input.asset_facts, baseRows);
 			let revision;
 			try {
-				revision = (await client.commit(base, nextRows, { migrationBaseVv })).revision;
+				revision = (await getGraphClient(input.doc_id).commit({
+					revision: snapshotState.revision,
+					rows: baseRows
+				}, nextRows, { migrationBaseVv })).revision;
 			} catch (error) {
 				if (error instanceof MengineHttpRequestError) throw new Error(`Migration rejected (HTTP ${error.status}): ${entityHttpErrorMessage(error.payload)}; take a fresh snapshot before retrying`);
 				throw new Error("Migration submission is unconfirmed; take a fresh snapshot and retry migrate-legacy to inspect whether the Entity timeline already exists");