@mengine/medeo-tool 2.0.1-alpha.5 → 2.0.1-alpha.7

package/dist/index.d.mts

@@ -11,6 +11,14 @@ import { JournalEntry, ManualSyncDoc, MediaAssetFact, PartIdFactory, SemanticOpN
  * `fromVideoDocument`.
  */
 interface CompactProjectionOptions {
+  /**
+   * Document identity for the header. Stated by the caller: the document
+   * content no longer carries its own id or revision (business metadata left
+   * the CRDT), and the model needs to know which draft this summary describes.
+   * Omitted values keep the header's fixed shape with the historical blanks.
+   */
+  docId?: string;
+  revision?: number;
   /** Only render these parts (header still reports the full timeline total). Default = all. */
   onlyPartIds?: ReadonlySet<string>;
   /** Caption text preview truncation length. Default 24. */
@@ -30,7 +38,10 @@ declare function collectAffectedPartIds(journal: readonly JournalEntry[]): Set<s
  * Render a ChangePlan preview: header + rows for journal-affected parts only.
  * Empty journal → empty `onlyPartIds` (header alone), matching the T2 contract.
  */
-declare function renderPreview(document: VideoDocument, journal: readonly JournalEntry[]): string;
+declare function renderPreview(document: VideoDocument, journal: readonly JournalEntry[], identity?: {
+  docId?: string;
+  revision?: number;
+}): string;
 //#endregion
 //#region src/entity/entity-asset.d.ts
 /** Immutable resource content resolved by the host for a document Entity. */
@@ -63,6 +74,12 @@ interface ChangePlan {
   logs: string[];
 }
 interface EditSandboxSessionOptions {
+  /**
+   * Document this session edits. Stated by the host: the document content no
+   * longer carries its own identity (business metadata left the CRDT), and a
+   * plan must name the document it will be committed against.
+   */
+  docId?: string;
   idFactory?: PartIdFactory;
   onEntry?: (entry: JournalEntry) => void;
   onLog?: (line: string) => void;
@@ -89,6 +106,8 @@ interface ConsoleShim {
  * injects loaders that break worker boot.
  */
 interface RunEditScriptOptions {
+  /** Document the plan will be committed against; stated by the host. */
+  docId: string;
   loadEntityAsset?: (entity: SandboxEntity) => Promise<EntityAssetContent>;
   writeEntityAsset?: (entity: SandboxEntity, content: EntityAssetContent['content']) => Promise<EntityAssetContent>;
   document: VideoDocument;
@@ -379,13 +398,6 @@ interface CreateMedeoToolOptions {
   userId?: ContextualValue<string>;
   /** Stable agent peer id. Supply a host-scoped value so audit provenance is durable. */
   peerId?: ContextualValue<string>;
-  /**
-   * Load the authoritative legacy draft used to create a missing Mengine
-   * document. The tool owns the get-or-create flow: it first probes Mengine,
-   * converts this draft into a VideoDocument only on a 404, bootstraps the
-   * snapshot, and tolerates a concurrent creator winning the race.
-   */
-  loadInitialDraft?: (docId: string) => Promise<VideoDraft>;
   /**
    * Resolve factual generation lineage by external asset id after a confirmed
    * entity commit. Return every known generation record involving the given

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { c as isMediaAssetVariantKind, i as businessState, o as createEntityId, s as createRelationId, t as EntitySandbox } from "./entity-sandbox-DSFbfybl.mjs";
-import { LoroEntityDocument, ManualSyncDoc, MengineHttpClient, MengineHttpRequestError, ValidationError, base64ToBytes, bytesToBase64, compileEntityRows, createMirrorVideoDocument, createPlainMemoryAdapter, decodeDocVersionMark, effectiveVideoClipDurationMs, encodeDocVersionMark, ensureEditorFoundation, replayJournal, solveVideoDocument, speedOf, toVideoDocument } from "@mengine/medeo-client";
+import { ManualSyncDoc, MengineHttpClient, ValidationError, base64ToBytes, bytesToBase64, compileEntityRows, createPlainMemoryAdapter, decodeDocVersionMark, effectiveVideoClipDurationMs, encodeDocVersionMark, replayJournal, solveVideoDocument, speedOf } from "@mengine/medeo-client";
 import { Worker } from "node:worker_threads";
 import { createHash, randomUUID } from "node:crypto";
 //#region src/document/compact-projection.ts
@@ -79,7 +79,7 @@ function renderCompactProjection(document, options) {
 			rows.push(`${tag} ${partId} ${lane} [${abs},${abs + dur}) ${attrs}`);
 		}
 	}
-	return [`# draft=${document.meta.draft_id ?? ""} v=${document.meta.version ?? 0} duration=${solved.durationMs} parts=${totalParts} shown=${rows.length}`, ...rows].join("\n");
+	return [`# draft=${options?.docId ?? ""} v=${options?.revision ?? 0} duration=${solved.durationMs} parts=${totalParts} shown=${rows.length}`, ...rows].join("\n");
 }
 //#endregion
 //#region src/sandbox/preview.ts
@@ -132,8 +132,12 @@ function collectFromValue(value, ids) {
 * Render a ChangePlan preview: header + rows for journal-affected parts only.
 * Empty journal → empty `onlyPartIds` (header alone), matching the T2 contract.
 */
-function renderPreview(document, journal) {
-	return renderCompactProjection(document, { onlyPartIds: journal.length === 0 ? /* @__PURE__ */ new Set() : collectAffectedPartIds(journal) });
+function renderPreview(document, journal, identity) {
+	const onlyPartIds = journal.length === 0 ? /* @__PURE__ */ new Set() : collectAffectedPartIds(journal);
+	return renderCompactProjection(document, {
+		...identity,
+		onlyPartIds
+	});
 }
 //#endregion
 //#region src/sandbox/node-host.ts
@@ -165,6 +169,7 @@ function runEditScript(options) {
 		let timer;
 		const worker = new Worker(workerEntryUrl, {
 			workerData: {
+				docId: options.docId,
 				document: options.document,
 				script: options.script,
 				inputs: options.inputs,
@@ -275,7 +280,7 @@ function runEditScript(options) {
 					ok: true,
 					plan: {
 						plan_kind: message.planKind,
-						doc_id: options.document.meta.draft_id ?? "",
+						doc_id: options.docId,
 						base_version: options.baseVersion,
 						ops: ops.slice(),
 						...message.loroUpdate ? { loro_update: message.loroUpdate } : {},
@@ -1218,7 +1223,7 @@ async function commitPlan(doc, plan, options) {
 * integrity throws are not wrapped.
 */
 async function commitPlanPreflight(doc, plan) {
-	const scratch = createPlainMemoryAdapter(doc.snapshot());
+	const scratch = createPlainMemoryAdapter(doc.snapshot(), { readOnly: doc.isEntityDocument() });
 	for (let index = 0; index < plan.ops.length; index++) {
 		const entry = plan.ops[index];
 		if (entry == null) continue;
@@ -1410,13 +1415,13 @@ function createMedeoTool(options) {
 		const existing = documents.get(docId);
 		if (existing != null) return await existing;
 		const created = (async () => {
-			return await getOrCreateDocument(new MengineHttpClient({
+			return await openDocument(new MengineHttpClient({
 				docId,
 				httpOrigin: requiredContext(options.httpOrigin, docId, "httpOrigin"),
 				...options.authToken !== void 0 ? { authToken: () => optionalContext(options.authToken, docId) } : {},
 				...options.userId !== void 0 ? { userId: () => optionalContext(options.userId, docId) } : {},
 				...options.fetchImpl !== void 0 ? { fetchImpl: options.fetchImpl } : {}
-			}), docId, optionalContext(options.peerId, docId));
+			}), optionalContext(options.peerId, docId));
 		})();
 		documents.set(docId, created);
 		try {
@@ -1456,36 +1461,14 @@ function createMedeoTool(options) {
 			if (documentTails.get(docId) === tail) documentTails.delete(docId);
 		}
 	}
-	async function getOrCreateDocument(client, docId, peerId) {
-		try {
-			return await ManualSyncDoc.open({
-				client,
-				...peerId !== void 0 ? { peerId } : {}
-			});
-		} catch (error) {
-			if (!(error instanceof MengineHttpRequestError) || error.status !== 404) throw error;
-			if (options.loadInitialDraft === void 0) throw error;
-		}
-		const document = toVideoDocument(await options.loadInitialDraft(docId));
-		if (Object.keys(document.part_library ?? {}).length > 0) throw new Error("Legacy content cannot bootstrap a Loro entity project");
-		const seed = createMirrorVideoDocument(document, {
-			...peerId !== void 0 ? { peerId } : {},
-			origin: "mengine.medeo_tool.bootstrap"
-		});
-		const foundation = ensureEditorFoundation({
-			entities: [],
-			relations: []
-		});
-		const entities = LoroEntityDocument.create(foundation.rows, {
-			timelineEntityId: foundation.timelineEntityId,
-			audioScriptEntityId: foundation.audioScriptEntityId
-		});
-		seed.import(entities.doc.export({ mode: "snapshot" }));
-		try {
-			await client.bootstrapSnapshot(seed.export({ mode: "snapshot" }));
-		} catch (error) {
-			if (!(error instanceof MengineHttpRequestError) || error.status !== 400) throw error;
-		}
+	/**
+	* Open an existing Mengine document. Creation belongs to Director, which
+	* initializes every project's document (`POST .../initialize`) before any
+	* agent edit; Mengine's `bootstrap` is the internal Legacy-migration route
+	* and is deliberately absent from the client SDK. A 404 here is a real
+	* missing document, not something this tool may paper over.
+	*/
+	async function openDocument(client, peerId) {
 		return await ManualSyncDoc.open({
 			client,
 			...peerId !== void 0 ? { peerId } : {}
@@ -1657,6 +1640,7 @@ function createMedeoTool(options) {
 			const document = doc.snapshot();
 			const baseVersion = encodeDocVersionMark(doc.versionMark());
 			const result = await runEditScript({
+				docId: input.doc_id,
 				document,
 				baseVersion,
 				entityState,