@mengine/medeo-tool 1.4.1-alpha.1 → 1.4.1-alpha.3

package/dist/index.d.mts

@@ -1,6 +1,5 @@
-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-DHasvrhq.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";
+import { C as UpdateEntityInput, S as UnlinkRelationInput, _ as LinkRelationInput, a as DeleteEntityInput, b as SandboxEntity, c as EntitySandboxCheckpoint, d as JsonObject, f as JsonPrimitive, g as LinkGeneratedRelationInput, h as KnownRelationKind, i as CreateEntityInput, l as EntityStoreSnapshot, m as KnownEntityKind, n as BusinessEntityFacade, o as EntityCommand, p as JsonValue, r as BusinessRelationFacade, s as EntityPlanState, t as AuthorableRelationKind, u as EntityUpdateInput, v as RelationUpdateInput, x as SandboxRelation, y as ResourceEntityKind } from "./entity-contract-DQ56Ihrh.mjs";
+import { JournalEntry, ManualSyncDoc, MediaAssetFact, PartIdFactory, SemanticOpName, VideoDocument, VideoDraft } from "@mengine/medeo-client";
 
 //#region src/document/compact-projection.d.ts
 /**
@@ -33,21 +32,19 @@ declare function collectAffectedPartIds(journal: readonly JournalEntry[]): Set<s
  */
 declare function renderPreview(document: VideoDocument, journal: readonly JournalEntry[]): string;
 //#endregion
+//#region src/entity/entity-asset.d.ts
+/** Immutable resource content resolved by the host for a document Entity. */
+interface EntityAssetContent {
+  assetId: string;
+  content: JsonValue;
+}
+/** Host-only I/O. The sandbox supplies an Entity, never an arbitrary Asset query. */
+type EntityAssetLoader = (docId: string, entity: SandboxEntity) => Promise<EntityAssetContent>;
+//#endregion
 //#region src/entity/entity-sandbox.d.ts
 type DomainIdFactory = (prefix: 'entity' | 'relation') => string;
 //#endregion
 //#region src/sandbox/script-session.d.ts
-/**
- * Runtime-neutral edit-sandbox session: `edit.*` / `timeline.*` / checkpoint
- * facade over a forked `VideoDocument`, self-maintained journal, and console
- * log buffer. No `node:*` imports — host/worker layers inject this into vm.
- *
- * Known gap (not solved here): `Math.random` / `Date.now` remain reachable in
- * the vm; purity is by convention.
- */
-interface SandboxCheckpoint {
-  readonly index: number;
-}
 interface ChangePlan {
   /** Native operations compiled against the causal sandbox baseline. */
   loro_update?: string;
@@ -74,88 +71,6 @@ interface EditSandboxSessionOptions {
   onEntityCommand?: (command: EntityCommand) => void;
   onEntityTruncate?: (index: number) => void;
 }
-interface TimelineClipDescriptor {
-  id: string;
-  start_ms: number;
-  end_ms: number;
-  duration_ms: number;
-  speed_shift: unknown;
-  volume: number | undefined;
-  media_id: string | undefined;
-}
-interface TimelinePartDescriptor {
-  id: string;
-  kind: string;
-  lane: string;
-  start_ms: number;
-  end_ms: number;
-  duration_ms: number;
-  part: unknown;
-}
-/** Session core for one forked document; globals stay identity-stable across rollback. */
-declare class EditSandboxSession {
-  private readonly original;
-  private readonly idFactory;
-  private readonly onEntry;
-  private readonly onLog;
-  private readonly onTruncate;
-  private readonly entitySandbox;
-  private current;
-  /** Adapter journal length already accounted for — new slices are real commits. */
-  private adapterJournalSeen;
-  private readonly entries;
-  private readonly logs;
-  private logBytes;
-  private logCapped;
-  readonly edit: EditFacade;
-  readonly timeline: TimelineFacade;
-  readonly entities: EntityFacade;
-  readonly relations: RelationFacade;
-  readonly console: ConsoleShim;
-  readonly checkpoint: () => SandboxCheckpoint;
-  readonly rollbackTo: (cp: SandboxCheckpoint) => void;
-  constructor(document: VideoDocument, options?: EditSandboxSessionOptions);
-  /** Assemble a ChangePlan from the self-maintained journal + current preview. */
-  buildPlan(baseVersion: string): ChangePlan;
-  getEntries(): readonly JournalEntry[];
-  getLogs(): readonly string[];
-  private boot;
-  private doRollbackTo;
-  private captureNewEntries;
-  private appendLog;
-  private buildConsoleShim;
-  private buildEditFacade;
-  private buildTimelineFacade;
-  private clipsInRange;
-  private part;
-}
-interface EditFacade {
-  addSpeeches: (input: AddSpeechesInput) => Promise<void>;
-  addVideoClips: (input: AddVideoClipsInput) => Promise<void>;
-  adjustBgmVolume: (input: AdjustBgmVolumeInput) => Promise<void>;
-  adjustSpeechVolume: (input: AdjustSpeechVolumeInput) => Promise<void>;
-  adjustVideoClipDuration: (input: AdjustVideoClipDurationInput) => Promise<void>;
-  adjustVideoClipVolume: (input: AdjustVideoClipVolumeInput) => Promise<void>;
-  changeSpeechScript: (input: ChangeSpeechScriptInput) => Promise<void>;
-  changeSpeechVoice: (input: ChangeSpeechVoiceInput) => Promise<void>;
-  deleteBgm: (input: DeleteBgmInput) => Promise<void>;
-  deleteSpeeches: (input: DeleteSpeechesInput) => Promise<void>;
-  deleteVideoClips: (input: DeleteVideoClipsInput) => Promise<void>;
-  moveSpeeches: (input: MoveSpeechesInput) => Promise<void>;
-  moveVideoClips: (input: MoveVideoClipsInput) => Promise<void>;
-  moveVideoClipsByAnchor: (input: MoveVideoClipsByAnchorInput) => Promise<void>;
-  replaceVideoClipContent: (input: ReplaceVideoClipContentInput) => Promise<void>;
-  replaceVideoClipSequence: (input: ReplaceVideoClipSequenceInput) => Promise<void>;
-  setBgm: (input: SetBgmInput) => Promise<void>;
-  setCaptionStyle: (input: SetCaptionStyleInput) => Promise<void>;
-  setCaptionVisibility: (input: SetCaptionVisibilityInput) => Promise<void>;
-  setVideoClipSpeedShift: (input: SetVideoClipSpeedShiftInput) => Promise<void>;
-}
-interface TimelineFacade {
-  snapshot: () => ReturnType<typeof fromVideoDocument>;
-  clipsInRange: (startMs: number, endMs: number) => TimelineClipDescriptor[];
-  part: (id: string) => TimelinePartDescriptor | null;
-}
 interface ConsoleShim {
   log: (...args: unknown[]) => void;
   info: (...args: unknown[]) => void;
@@ -172,6 +87,7 @@ interface ConsoleShim {
  * injects loaders that break worker boot.
  */
 interface RunEditScriptOptions {
+  loadEntityAsset?: (entity: SandboxEntity) => Promise<EntityAssetContent>;
   document: VideoDocument;
   baseVersion: string;
   script: string;
@@ -180,8 +96,6 @@ interface RunEditScriptOptions {
   entityState?: EntityStoreSnapshot;
   /** Deterministic id mint label for tests; omit to use the default ULID factory. */
   idLabel?: string;
-  /** @internal Select the graph-native Entity session used by the production host. */
-  entityOnly?: boolean;
   /** Hard wall-clock timeout; default 2000 ms. */
   timeoutMs?: number;
   /** V8 old-generation ceiling for the worker; default 256 MB. */
@@ -480,6 +394,7 @@ interface CreateMedeoToolOptions {
   loadGenerationFacts?: GenerationFactsLoader;
   /** Assemble optional Caption artifacts by immutable entity ID; never exposed to scripts. */
   loadCaptionAssets?: CaptionAssetsLoader;
+  loadEntityAsset?: EntityAssetLoader;
   fetchImpl?: typeof fetch;
   /** @deprecated ManualSyncDoc has no SSE or reconnect loop. */
   sseReconnectDelayMs?: number;
@@ -652,5 +567,5 @@ declare function materializeResources(options: EntityHttpClientOptions & {
   loadGenerationFacts?: GenerationFactsLoader;
 }, resources: readonly GeneratedResource[]): Promise<readonly string[]>;
 //#endregion
-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 GeneratedResource, 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, materializeResources, renderCompactProjection, renderPreview, runEditScript };
+export { type AssetGenerationFact, type AuthorableRelationKind, type BusinessEntityFacade, type BusinessRelationFacade, 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 EditSandboxSessionOptions, type EditScriptResult, type EntityAssetContent, type EntityAssetLoader, type EntityCommand, type EntityCommitResult, type EntityPlanState, type EntitySandboxCheckpoint, type EntityStoreSnapshot, type EntityUpdateInput, type GeneratedResource, 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 RelationUpdateInput, type ResourceEntityKind, type RunEditScriptOptions, type SandboxEntity, type SandboxRelation, type UnlinkRelationInput, type UpdateEntityInput, collectAffectedPartIds, commitPlan, createMedeoTool, materializeResources, renderCompactProjection, renderPreview, runEditScript };
 //# sourceMappingURL=index.d.mts.map