@mengine/medeo-tool 1.0.1-alpha.2 → 1.2.1-alpha.7

package/dist/sandbox-api.d.mts

@@ -3,7 +3,7 @@
  * @generated by gen:sandbox-dts — DO NOT EDIT MANUALLY
  *
  * Schema version: video-document/v0
- * Semantic ops: 18
+ * Semantic ops: 20
  *
  * Boundary: zod `superRefine` / custom refine rules are NOT introspectable and
  * do not appear here. Business mutual-exclusion rules surface via runtime
@@ -192,6 +192,40 @@ interface MoveVideoClipsInput {
     new_track_id?: string;
   }[];
 }
+/**
+ * Reorder a set of main-track clips relative to a reference clip.
+ */
+interface MoveVideoClipsByAnchorInput {
+  /**
+   * Clips to move as one block, keeping their relative order. Need not be contiguous on the track.
+   * @constraint minLength(1)
+   */
+  clip_ids: string[];
+  /**
+   * Where the moved block lands: before/after a reference clip, or at the head of the track
+   */
+  anchor: {
+    position: 'before';
+    /**
+     * The moved block lands immediately before this clip
+     * @constraint minLength(1)
+     */
+    clip_id: string;
+  } | {
+    position: 'after';
+    /**
+     * The moved block lands immediately after this clip
+     * @constraint minLength(1)
+     */
+    clip_id: string;
+  } | {
+    position: 'track_start';
+  };
+  /**
+   * What happens to speeches anchored to the moved clips (required — see the policy doc)
+   */
+  on_anchored: 'follow' | 'keep_absolute';
+}
 interface DeleteVideoClipsInput {
   /**
    * List of video clip part IDs to delete from the main track
@@ -384,6 +418,49 @@ interface ReplaceVideoClipContentInput {
     volume: number;
   }[];
 }
+/**
+ * Replace a contiguous run of main-track clips with a new run.
+ */
+interface ReplaceVideoClipSequenceInput {
+  /**
+   * The clips being replaced: a contiguous main-track run, listed in timeline order
+   * @constraint minLength(1)
+   */
+  old_clip_ids: string[];
+  /**
+   * The replacement clips, in the order they take on the track
+   * @constraint minLength(1)
+   */
+  new_clips: {
+    /**
+     * The replacement media asset ID. Omit to create an empty placeholder clip.
+     * @constraint minLength(1)
+     */
+    media_id?: string;
+    /**
+     * The source media's intrinsic full length in ms
+     * @constraint int
+     * @constraint positive
+     */
+    media_duration_ms: number;
+    /**
+     * Trim window start in the media (default 0)
+     * @constraint int
+     * @constraint min(0)
+     */
+    play_in?: number;
+    /**
+     * Trim window end in the media (default media_duration_ms)
+     * @constraint int
+     * @constraint positive
+     */
+    play_out?: number;
+  }[];
+  /**
+   * What happens to speeches anchored to the replaced clips (required — see the policy doc)
+   */
+  on_anchored: 'remap' | 'cascade';
+}
 /**
  * Re-trim existing video clips (the user-facing "adjust duration" gesture is a trim of the source window).
  */
@@ -586,6 +663,8 @@ interface AdjustBgmVolumeInput {
 /** Agent write surface — one method per SemanticOp kind. */
 interface EditApi {
   moveVideoClips(input: MoveVideoClipsInput): Promise<void>;
+  /** Reorder a set of main-track clips relative to a reference clip. */
+  moveVideoClipsByAnchor(input: MoveVideoClipsByAnchorInput): Promise<void>;
   deleteVideoClips(input: DeleteVideoClipsInput): Promise<void>;
   /** Add video clips to a track. */
   addVideoClips(input: AddVideoClipsInput): Promise<void>;
@@ -594,6 +673,8 @@ interface EditApi {
   setVideoClipSpeedShift(input: SetVideoClipSpeedShiftInput): Promise<void>;
   /** Replace the media backing existing video clips. */
   replaceVideoClipContent(input: ReplaceVideoClipContentInput): Promise<void>;
+  /** Replace a contiguous run of main-track clips with a new run. */
+  replaceVideoClipSequence(input: ReplaceVideoClipSequenceInput): Promise<void>;
   /** Re-trim existing video clips (the user-facing "adjust duration" gesture is a trim of the source window). */
   adjustVideoClipDuration(input: AdjustVideoClipDurationInput): Promise<void>;
   /** Add speeches (and their captions). */
@@ -616,6 +697,169 @@ interface EditApi {
   deleteBgm(input: DeleteBgmInput): Promise<void>;
   adjustBgmVolume(input: AdjustBgmVolumeInput): Promise<void>;
 }
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+interface JsonObject {
+  [key: string]: JsonValue;
+}
+type KnownEntityKind = 'axvideo' | 'timeline' | 'track' | 'clip' | 'asset' | 'video' | 'audio' | 'voice' | 'image' | 'sequence-marker' | 'viewport' | 'audio-script' | 'phonetic-script' | 'caption';
+type KnownRelationKind = 'timeline-track' | 'track-clip' | 'clip-marker' | 'marker-content' | 'axvideo-marker' | 'marker-timeline' | 'physical-asset' | 'generated' | 'phonetic-script-provenance' | 'caption-provenance' | 'caption-alignment';
+interface BoundedNativeSequencePayload extends JsonObject {
+  /** Use factual recalled coordinates; never invent an end or 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;
+}
+type ScriptTextSegment = JsonObject & {
+  segmentId: string;
+  text: string;
+  language?: string;
+};
+interface EntityPayloadByKind {
+  axvideo: BoundedDerivedSequencePayload;
+  timeline: JsonObject;
+  track: JsonObject & {
+    hidden?: boolean;
+    role?: string;
+  };
+  clip: JsonObject;
+  asset: JsonObject;
+  video: BoundedNativeSequencePayload;
+  audio: BoundedNativeSequencePayload;
+  voice: BoundedNativeSequencePayload;
+  image: UnboundedConstantSequencePayload;
+  'sequence-marker': JsonObject & {
+    sourceRange: {
+      start: number;
+      end: number;
+    };
+    targetRange?: {
+      start: number;
+      end: number;
+    };
+    duration: {
+      mode: 'from-source';
+    } | {
+      mode: 'fixed';
+      value: number;
+    };
+    timeRemapping?: JsonValue;
+  };
+  viewport: JsonObject;
+  'audio-script': JsonObject & {
+    segments: ScriptTextSegment[];
+  };
+  'phonetic-script': JsonObject & {
+    segments: ScriptTextSegment[];
+  };
+  caption: BoundedNativeSequencePayload;
+}
+type CreateEntityInput = { [K in KnownEntityKind]: {
+  entity_id?: string;
+  entity_kind: K;
+  payload: EntityPayloadByKind[K];
+} }[KnownEntityKind];
+interface ImportAssetInput {
+  asset_id: string;
+  entity_id?: string;
+  payload?: JsonObject;
+}
+interface SandboxEntity<K extends KnownEntityKind = KnownEntityKind> {
+  entity_id: string;
+  entity_kind: K;
+  payload: EntityPayloadByKind[K];
+}
+interface SandboxRelation {
+  relation_id: string;
+  relation_kind: KnownRelationKind;
+  endpoint_0_entity_id: string;
+  endpoint_1_entity_id: string;
+  metadata: JsonObject;
+  trace: JsonObject;
+}
+type EmptyRelationKind = 'timeline-track' | 'track-clip' | 'clip-marker' | 'marker-content' | 'axvideo-marker' | 'marker-timeline';
+type LinkRelationInput = {
+  relation_id?: string;
+  relation_kind: EmptyRelationKind;
+  endpoint_0_entity_id: string;
+  endpoint_1_entity_id: string;
+  metadata?: {
+    [key: string]: never;
+  };
+  trace?: JsonObject;
+} | {
+  relation_id?: string;
+  relation_kind: 'physical-asset'; /** Canonical endpoint 0 is sequence media; endpoint 1 is Asset. */
+  endpoint_0_entity_id: string;
+  endpoint_1_entity_id: string;
+  metadata?: JsonObject;
+  trace?: JsonObject;
+} | {
+  relation_id?: string;
+  relation_kind: 'phonetic-script-provenance' | 'caption-provenance';
+  endpoint_0_entity_id: string;
+  endpoint_1_entity_id: string;
+  metadata: JsonObject & {
+    segmentAlignment: JsonValue;
+  };
+  trace?: JsonObject;
+} | {
+  relation_id?: string;
+  relation_kind: 'caption-alignment';
+  endpoint_0_entity_id: string;
+  endpoint_1_entity_id: string;
+  metadata: JsonObject & {
+    alignment: JsonValue;
+  };
+  trace?: JsonObject;
+};
+interface LinkGeneratedRelationInput {
+  relation_id?: string;
+  /** Generated output media Entity; persisted as endpoint 0. */
+  output_entity_id: string;
+  /** Input media Entity used to generate the output; persisted as endpoint 1. */
+  input_entity_id: string;
+  trace?: JsonObject;
+}
+/** Explicit Entity authoring. Assets and media Entities are not one-to-one. */
+interface EntityApi {
+  list(): SandboxEntity[];
+  get(entityId: string): SandboxEntity | null;
+  /** Call before importAsset; inspect every match and decide whether to reuse one. */
+  findByAssetId(assetId: string): SandboxEntity<'asset'>[];
+  create(input: CreateEntityInput): string;
+  /** Create only an Asset Entity when no existing match should be reused; this does not infer media. */
+  importAsset(input: ImportAssetInput): string;
+}
+/** Incident reads ignore endpoint position; relation semantics preserve it. */
+interface RelationApi {
+  list(): SandboxRelation[];
+  of(entityId: string, relationKind?: KnownRelationKind): SandboxRelation[];
+  link(input: LinkRelationInput): string;
+  /** Author ordered generated(output,input). */
+  linkGenerated(input: LinkGeneratedRelationInput): string;
+}
 /** Clip hit from `clipsInRange`. */
 interface TimelineClipDescriptor {
   id: string;
@@ -658,12 +902,14 @@ interface SandboxCheckpoint {
 }
 declare const edit: EditApi;
 declare const timeline: TimelineApi;
+declare const entities: EntityApi;
+declare const relations: RelationApi;
 /** Capture a rollback point. */
 declare function checkpoint(): SandboxCheckpoint;
 /** Roll the sandbox document back to a prior checkpoint. */
 declare function rollbackTo(cp: SandboxCheckpoint): void;
-/** Host-injected script arguments (opaque). */
-declare const inputs: unknown;
+/** Host-injected, pre-materialized facts. Validate each field before use. */
+declare const inputs: Readonly<Record<string, unknown>>;
 //#endregion
-export type { AddSpeechesInput, AddVideoClipsInput, AdjustBgmVolumeInput, AdjustSpeechVolumeInput, AdjustVideoClipDurationInput, AdjustVideoClipVolumeInput, ChangeSpeechScriptInput, ChangeSpeechVoiceInput, DeleteBgmInput, DeleteSpeechesInput, DeleteVideoClipsInput, EditApi, MoveSpeechesInput, MoveVideoClipsInput, ReplaceVideoClipContentInput, SandboxCheckpoint, SetBgmInput, SetCaptionStyleInput, SetCaptionVisibilityInput, SetVideoClipSpeedShiftInput, SpeechAssets, SpeedShift, TimelineApi, TimelineClipDescriptor, TimelinePartDescriptor, VideoDraftProjection, Voice, checkpoint, edit, inputs, rollbackTo, timeline };
+export type { AddSpeechesInput, AddVideoClipsInput, AdjustBgmVolumeInput, AdjustSpeechVolumeInput, AdjustVideoClipDurationInput, AdjustVideoClipVolumeInput, BoundedDerivedSequencePayload, BoundedNativeSequencePayload, ChangeSpeechScriptInput, ChangeSpeechVoiceInput, CreateEntityInput, DeleteBgmInput, DeleteSpeechesInput, DeleteVideoClipsInput, EditApi, EmptyRelationKind, EntityApi, EntityPayloadByKind, ImportAssetInput, JsonObject, JsonPrimitive, JsonValue, KnownEntityKind, KnownRelationKind, LinkGeneratedRelationInput, LinkRelationInput, MoveSpeechesInput, MoveVideoClipsByAnchorInput, MoveVideoClipsInput, RelationApi, ReplaceVideoClipContentInput, ReplaceVideoClipSequenceInput, SandboxCheckpoint, SandboxEntity, SandboxRelation, ScriptTextSegment, SetBgmInput, SetCaptionStyleInput, SetCaptionVisibilityInput, SetVideoClipSpeedShiftInput, SpeechAssets, SpeedShift, TimelineApi, TimelineClipDescriptor, TimelinePartDescriptor, UnboundedConstantSequencePayload, VideoDraftProjection, Voice, checkpoint, edit, entities, inputs, relations, rollbackTo, timeline };
 //# sourceMappingURL=sandbox-api.d.mts.map