@mengine/medeo-tool 1.4.1-alpha.5 → 2.0.1-alpha.11

package/README.md

@@ -84,6 +84,15 @@ Resource-free Caption composition from AudioScript is also supported. Each
 on-screen placement has its own Clip and display SequenceMarker, connected by
 ordinary relations; intrinsic Caption timing remains independent.
 
+Voice resources use `external: {system: 'memota-speech', key: speechId}`.
+Await `rgetAssetFromEntity(voiceId)` before constructing placement relations: the
+host supplies `storageKey`, the full millisecond `extent`, and the optional TTS
+`voice` locator. The loader returns `{assetId, content: {storageKey, durationMs,
+voice?}}` from a project-scoped Speech lookup. Recorded speech omits `voice`;
+TTS retains its explicit PhoneticScript relation. Resource reads do not create
+script text or display markers. New or changed Speech references are also
+resolved before commit, and failed reads publish no partial edits.
+
 `materializeResources` and generation/resource loaders are host APIs. The model
 never receives these capabilities. Project initialization and historical data
 migration also remain outside script execution. Retrying an unconfirmed commit

package/dist/{entity-contract-DlmUSouB.d.mts → entity-contract-Cf3AiSe7.d.mts}

@@ -8,47 +8,39 @@ interface JsonObject {
 }
 type KnownEntityKind = 'axvideo' | 'timeline' | 'track' | 'clip' | 'asset' | 'video' | 'audio' | 'voice' | 'image' | 'sequence-marker' | 'viewport' | 'audio-script' | 'phonetic-script' | 'caption';
 /** Asset identity, either an old physical-only row or a directly composed media variant. */
-type ResourceEntityKind = 'image' | 'video' | 'audio' | 'voice';
-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 ResourceEntityKind = 'image' | 'video' | 'audio';
+type KnownRelationKind = 'timeline-track' | 'track-clip' | 'clip-marker' | 'marker-content' | 'axvideo-marker' | 'marker-timeline' | 'from-asset' | 'generated' | 'caption-alignment' | 'clip-anchor' | 'phonetic-script-render' | 'voice-timbre' | 'audio-script-source' | 'audio-script-marker';
 type AuthorableRelationKind = KnownRelationKind;
-interface BoundedNativeSequencePayload extends JsonObject {
-  /** Factual coordinates from recalled media metadata; never invent an end/duration. */
-  extent: {
-    kind: 'bounded';
-    start: number;
-    end: number;
-  };
-  sampling: 'native';
-  coordinateSpace: JsonValue;
-}
-interface UnboundedConstantSequencePayload extends JsonObject {
-  extent: {
-    kind: 'unbounded';
-    start: number;
-  };
-  sampling: 'constant';
-  coordinateSpace: JsonValue;
-}
-interface BoundedDerivedSequencePayload extends JsonObject {
-  extent: {
-    kind: 'bounded';
-    start: number;
-    end: number;
-  };
-  sampling: 'derived';
-  coordinateSpace: JsonValue;
+/**
+ * Content states how long it runs and nothing else: where it is taken from and
+ * where it lands both belong to its Sequence Marker.
+ */
+interface OwnDurationPayload extends JsonObject {
+  /** Factual whole milliseconds from recalled media metadata; never invented. */
+  durationMs: number;
+}
+/** A still frame runs for as long as its use asks, so it states no length. */
+interface NoDurationPayload extends JsonObject {
+  durationMs: null;
 }
 type ScriptTextSegment = JsonObject & {
   segmentId: string;
   text: string;
   language?: string;
 };
-type MediaAssetPayload = JsonObject & {
-  external: {
-    system: 'memota' | 'memota-speech';
+/** Only an Asset entity states where bytes live; everything else links to one. */
+type AssetPayload = JsonObject & {
+  system: 'memota' | 'memota-speech';
+  key: string;
+  storageKey?: string;
+};
+/** The voice-library timbre a synthesized Audio was rendered with. */
+type VoiceIdentityPayload = JsonObject & {
+  voice: {
+    system: 'voice-library';
     key: string;
+    name?: string;
   };
-  storageKey?: string;
 };
 type CaptionTextSelection = JsonObject & {
   segmentId: string; /** Half-open Unicode code-point range within the selected source segment. */
@@ -58,19 +50,22 @@ type CaptionTextSelection = JsonObject & {
   };
 };
 interface EntityPayloadByKind {
-  axvideo: BoundedDerivedSequencePayload;
+  /** Its Timeline decides how long it runs, so it stores no length. */
+  axvideo: JsonObject;
   timeline: JsonObject;
   track: JsonObject & {
     hidden?: boolean;
     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;
+  /** Where the bytes live. Reached from other entities by from-asset. */
+  asset: AssetPayload;
+  video: OwnDurationPayload;
+  /** Every playable sound, including video original audio and synthesized voiceovers. */
+  audio: OwnDurationPayload;
+  /** A timbre identity, never playable content; the rendered take is an `audio` entity. */
+  voice: VoiceIdentityPayload;
+  image: NoDurationPayload;
   'sequence-marker': JsonObject & {
     sourceRange: {
       start: number;
@@ -104,7 +99,7 @@ interface EntityPayloadByKind {
     phonemeScript?: string;
     prosody?: JsonObject;
   };
-  caption: BoundedNativeSequencePayload & {
+  caption: OwnDurationPayload & {
     baseEntityIds: string[];
     selection: CaptionTextSelection;
     style?: JsonObject;
@@ -115,8 +110,15 @@ interface EntityPayloadByKind {
     }[];
   };
 }
-/** Stored own fields; a variant may obtain required content fields from its declared bases. */
-type StoredEntityPayload<K extends KnownEntityKind> = EntityPayloadByKind[K] | (K extends 'caption' ? JsonObject & Pick<MediaAssetPayload, 'external'> : never) | (JsonObject & Partial<EntityPayloadByKind[K]> & {
+/**
+ * Stored own fields; a variant may obtain required content fields from its
+ * declared bases.
+ *
+ * Caption and Audio may also be declared resource-only: the ASR transcript and
+ * the synthesized voiceover are attached by the host, which then fills in the
+ * remaining factual fields.
+ */
+type StoredEntityPayload<K extends KnownEntityKind> = EntityPayloadByKind[K] | (K extends 'caption' | 'audio' ? Record<string, never> : never) | (JsonObject & Partial<EntityPayloadByKind[K]> & {
   baseEntityIds: string[];
 });
 interface SandboxEntity<K extends KnownEntityKind = KnownEntityKind> {
@@ -238,4 +240,4 @@ interface BusinessRelationFacade {
 }
 //#endregion
 export { UpdateEntityInput as C, UnlinkRelationInput as S, LinkRelationInput as _, DeleteEntityInput as a, SandboxEntity as b, EntitySandboxCheckpoint as c, JsonObject as d, JsonPrimitive as f, LinkGeneratedRelationInput as g, KnownRelationKind as h, CreateEntityInput as i, EntityStoreSnapshot as l, KnownEntityKind as m, BusinessEntityFacade as n, EntityCommand as o, JsonValue as p, BusinessRelationFacade as r, EntityPlanState as s, AuthorableRelationKind as t, EntityUpdateInput as u, RelationUpdateInput as v, SandboxRelation as x, ResourceEntityKind as y };
-//# sourceMappingURL=entity-contract-DlmUSouB.d.mts.map
+//# sourceMappingURL=entity-contract-Cf3AiSe7.d.mts.map