@mengine/medeo-client 2.1.0 → 2.1.1-dsl.0

package/dist/index-CnZ9l3rb.d.ts

@@ -1,2077 +0,0 @@
-import { InferInputType } from "loro-mirror";
-import { z } from "zod";
-import { LoroDoc, PeerID } from "loro-crdt";
-
-//#region src/document/generated/video-draft-idl.d.ts
-/**
- * @generated by @mengine/idl-codegen — DO NOT EDIT MANUALLY.
- *
- * VideoDraft read-view types extracted from the Smithy IDL
- * (medeo-v2-design-materials). Re-run `vp run @mengine/idl-codegen#sync`.
- * Source IDL commit: 902e82e3fec1e94b36e14ef671de91abd210dc86
- *
- * WHY EVERY FIELD IS `T | undefined`:
- * AWS `smithy-typescript-codegen` widens every structure member to
- * `T | undefined` regardless of the Smithy `@required` trait — it favours
- * deserialization robustness (a peer may omit a field on the wire) over
- * encoding requiredness in the static type. So these generated types are NOT
- * the source of truth for which fields are required: the Smithy `.smithy`
- * model is. Many fields here (e.g. `VideoClipPart.play_in` / `play_out` /
- * `volume` / `origin_media_id`) are `@required` in the contract.
- *
- * Requiredness is restored at the write-time gate, not here: see the part
- * schemas in `../zod-schema.ts`, which re-mark the `@required` fields as
- * mandatory before a VideoDocument is committed to Loro. Do not assume a
- * field is optional just because its type is `| undefined`.
- */
-/**
- * @public
- * @enum
- */
-declare const PartKind$1: {
-  readonly BGM: 'bgm';
-  readonly CAPTION: 'caption';
-  readonly SPEECH: 'speech';
-  readonly VIDEO_CLIP: 'video_clip';
-};
-/**
- * @public
- */
-type PartKind$1 = (typeof PartKind$1)[keyof typeof PartKind$1];
-/**
- * @public
- */
-interface VoiceSummary {
-  name: string | undefined;
-  id: string | undefined;
-}
-/**
- * @public
- */
-interface SpeechPart$1 {
-  id: string | undefined;
-  duration_ms: number | undefined;
-  /**
-   * Types of parts that can be contained in tracks
-   * @public
-   */
-  kind: PartKind$1 | undefined;
-  audio_script: string | undefined;
-  volume: number | undefined;
-  audio_storage_key: string | undefined;
-  origin_speech_id: string | undefined;
-  voice: VoiceSummary | undefined;
-  caption_ids: string[] | undefined;
-}
-/**
- * Caption visual style configuration
- * @public
- */
-interface CaptionStyle {
-  /**
-   * Font ID referencing a font from the font library. Defaults to system font if not provided
-   * @public
-   */
-  font_id?: string | undefined;
-  /**
-   * Font size in points
-   * @public
-   */
-  font_size?: number | undefined;
-  /**
-   * Font color as hex string (e.g. "#FFFFFF")
-   * @public
-   */
-  font_color?: string | undefined;
-  /**
-   * Numeric font weight, e.g. 400 for regular or 700 for bold
-   * @public
-   */
-  font_weight?: number | undefined;
-  /**
-   * Caption entrance animation preset ID, e.g. "fade", "slideUp", or "none"
-   * @public
-   */
-  entrance_animation?: string | undefined;
-  /**
-   * Caption entrance animation duration in milliseconds
-   * @public
-   */
-  entrance_animation_duration_ms?: number | undefined;
-  /**
-   * Caption outline/stroke color as hex string (e.g. "#000000")
-   * @public
-   */
-  stroke_color?: string | undefined;
-  /**
-   * Caption outline/stroke width in pixels
-   * @public
-   */
-  stroke_width?: number | undefined;
-  /**
-   * Caption center X position as a percentage (0.0 to 1.0)
-   * @public
-   */
-  position_x?: number | undefined;
-  /**
-   * Caption center Y position as a percentage (0.0 to 1.0)
-   * @public
-   */
-  position_y?: number | undefined;
-}
-/**
- * @public
- */
-interface CaptionPart$1 {
-  id: string | undefined;
-  duration_ms: number | undefined;
-  /**
-   * Types of parts that can be contained in tracks
-   * @public
-   */
-  kind: PartKind$1 | undefined;
-  speech_part_id: string | undefined;
-  text: string | undefined;
-  start_ms: number | undefined;
-  /**
-   * Caption visual style (font, size, color, weight, animation, outline). Uses default style if not provided
-   * @public
-   */
-  style?: CaptionStyle | undefined;
-}
-/**
- * @public
- * @enum
- */
-declare const AspectRatio: {
-  readonly RATIO_16_9: '16:9';
-  readonly RATIO_9_16: '9:16';
-};
-/**
- * @public
- */
-type AspectRatio = (typeof AspectRatio)[keyof typeof AspectRatio];
-/**
- * @public
- * @enum
- */
-declare const AssetSource: {
-  readonly AI_IMAGES: 'ai_images';
-  readonly AI_VIDEOS: 'ai_videos';
-  readonly MY_UPLOADED_ASSETS: 'my_uploaded_assets';
-  readonly STOCK_VIDEOS: 'stock_videos';
-};
-/**
- * @public
- */
-type AssetSource = (typeof AssetSource)[keyof typeof AssetSource];
-/**
- * An extra aspect ratio variant with independent storage keys for thumbnail,
- * preview video, and highlight video. Stored inside video_settings JSONB.
- * @public
- */
-interface RatioVariant {
-  aspect_ratio: string | undefined;
-  thumb_storage_key: string | undefined;
-  video_storage_key: string | undefined;
-  highlight_video_storage_key?: string | undefined;
-}
-/**
- * @public
- */
-interface VideoCreationSettings$1 {
-  voice_id?: string | undefined;
-  duration_ms?: number | undefined;
-  aspect_ratio?: AspectRatio | undefined;
-  video_style_id?: string | undefined;
-  asset_sources?: AssetSource[] | undefined;
-  recipe_id?: string | undefined;
-  enable_high_cost_confirm?: boolean | undefined;
-  user_confirm_cost_threshold?: number | undefined;
-  /**
-   * Extra aspect ratio variants with independent storage keys.
-   * Each variant carries its own thumbnail, preview video, and optional highlight video.
-   * Used when a recipe supports multiple aspect ratios (e.g. both 16:9 and 9:16).
-   * @public
-   */
-  extra_ratios?: RatioVariant[] | undefined;
-}
-/**
- * @public
- */
-interface TrackItem$1 {
-  abs_time_position: number | undefined;
-  part_id: string | undefined;
-}
-/**
- * @public
- */
-interface Track$1 {
-  id: string | undefined;
-  /**
-   * Types of parts that can be contained in tracks
-   * @public
-   */
-  parts_kind: PartKind$1 | undefined;
-  is_hidden: boolean | undefined;
-  items: TrackItem$1[] | undefined;
-}
-/**
- * @public
- */
-interface Attachment {
-  part_id: string | undefined;
-  relative_time_position: number | undefined;
-}
-/**
- * @public
- */
-interface PartAggregation {
-  body_part_id: string | undefined;
-  attachments: Attachment[] | undefined;
-}
-/**
- * @public
- */
-interface BgmPart$1 {
-  id: string | undefined;
-  duration_ms: number | undefined;
-  /**
-   * Types of parts that can be contained in tracks
-   * @public
-   */
-  kind: PartKind$1 | undefined;
-  audio_storage_key: string | undefined;
-  volume: number | undefined;
-  origin_media_id: string | undefined;
-}
-/**
- * @public
- * @enum
- */
-declare const SpeedShiftCategory: {
-  /**
-   * Variable speed controlled by Bezier keyframes
-   */
-  readonly CURVE: 'curve';
-  /**
-   * Constant speed multiplier across the entire clip
-   */
-  readonly LINEAR: 'linear';
-};
-/**
- * @public
- */
-type SpeedShiftCategory = (typeof SpeedShiftCategory)[keyof typeof SpeedShiftCategory];
-/**
- * @public
- */
-interface TangentHandle {
-  x: number | undefined;
-  y: number | undefined;
-}
-/**
- * @public
- */
-interface SpeedKeyframe {
-  position: number | undefined;
-  rate: number | undefined;
-  in_tangent?: TangentHandle | undefined;
-  out_tangent?: TangentHandle | undefined;
-}
-/**
- * @public
- */
-interface CurveConfig {
-  keyframes: SpeedKeyframe[] | undefined;
-}
-/**
- * @public
- */
-interface LinearConfig {
-  speed: number | undefined;
-}
-/**
- * @public
- */
-type SpeedShiftConfigUnion = SpeedShiftConfigUnion.CurveMember | SpeedShiftConfigUnion.LinearMember | SpeedShiftConfigUnion.$UnknownMember;
-/**
- * @public
- */
-declare namespace SpeedShiftConfigUnion {
-  interface LinearMember {
-    linear: LinearConfig;
-    curve?: never;
-    $unknown?: never;
-  }
-  interface CurveMember {
-    linear?: never;
-    curve: CurveConfig;
-    $unknown?: never;
-  }
-  /**
-   * @public
-   */
-  interface $UnknownMember {
-    linear?: never;
-    curve?: never;
-    $unknown: [string, any];
-  }
-  interface Visitor<T> {
-    linear: (value: LinearConfig) => T;
-    curve: (value: CurveConfig) => T;
-    _: (name: string, value: any) => T;
-  }
-  const visit: <T>(value: SpeedShiftConfigUnion, visitor: Visitor<T>) => T;
-}
-/**
- * @public
- */
-interface SpeedShift {
-  category: SpeedShiftCategory | undefined;
-  mode: string | undefined;
-  config: SpeedShiftConfigUnion | undefined;
-}
-/**
- * @public
- */
-interface VideoClipPart$1 {
-  id: string | undefined;
-  duration_ms: number | undefined;
-  /**
-   * Types of parts that can be contained in tracks
-   * @public
-   */
-  kind: PartKind$1 | undefined;
-  play_in: number | undefined;
-  play_out: number | undefined;
-  volume: number | undefined;
-  origin_media_id: string | undefined;
-  speed_shift?: SpeedShift | undefined;
-}
-/**
- * @public
- */
-type PartUnion$1 = PartUnion$1.BgmMember | PartUnion$1.CaptionMember | PartUnion$1.SpeechMember | PartUnion$1.Video_clipMember | PartUnion$1.$UnknownMember;
-/**
- * @public
- */
-declare namespace PartUnion$1 {
-  interface Video_clipMember {
-    video_clip: VideoClipPart$1;
-    bgm?: never;
-    speech?: never;
-    caption?: never;
-    $unknown?: never;
-  }
-  interface BgmMember {
-    video_clip?: never;
-    bgm: BgmPart$1;
-    speech?: never;
-    caption?: never;
-    $unknown?: never;
-  }
-  interface SpeechMember {
-    video_clip?: never;
-    bgm?: never;
-    speech: SpeechPart$1;
-    caption?: never;
-    $unknown?: never;
-  }
-  interface CaptionMember {
-    video_clip?: never;
-    bgm?: never;
-    speech?: never;
-    caption: CaptionPart$1;
-    $unknown?: never;
-  }
-  /**
-   * @public
-   */
-  interface $UnknownMember {
-    video_clip?: never;
-    bgm?: never;
-    speech?: never;
-    caption?: never;
-    $unknown: [string, any];
-  }
-  interface Visitor<T> {
-    video_clip: (value: VideoClipPart$1) => T;
-    bgm: (value: BgmPart$1) => T;
-    speech: (value: SpeechPart$1) => T;
-    caption: (value: CaptionPart$1) => T;
-    _: (name: string, value: any) => T;
-  }
-  const visit: <T>(value: PartUnion$1, visitor: Visitor<T>) => T;
-}
-/**
- * Timeline configuration for video editing
- * @public
- */
-interface Timeline$1 {
-  duration_ms: number | undefined;
-  unit_time_ms: number | undefined;
-}
-/**
- * Complete video draft information with timeline and tracks
- * @public
- */
-interface VideoDraft$1 {
-  id?: string | undefined;
-  project_id: string | undefined;
-  owner_id: string | undefined;
-  /**
-   * for-code-gen: property value may be empty string ("")
-   * @public
-   */
-  thumbnail_storage_key: string | undefined;
-  /**
-   * Timeline configuration for video editing
-   * @public
-   */
-  timeline?: Timeline$1 | undefined;
-  video_creation_settings?: VideoCreationSettings$1 | undefined;
-  chat_session_id: string | undefined;
-  main_track?: Track$1 | undefined;
-  above_main_tracks: Track$1[] | undefined;
-  below_main_tracks: Track$1[] | undefined;
-  part_aggregations: PartAggregation[] | undefined;
-  part_library: Record<string, PartUnion$1> | undefined;
-  version: number | undefined;
-}
-//#endregion
-//#region src/document/types.d.ts
-type PartKind = 'video_clip' | 'speech' | 'caption' | 'bgm';
-/**
- * Project-level creation settings. Mirrors the IDL, but keeps the two fields the
- * upstream (Director / FE) sends as an explicit `null` nullable — the IDL models
- * "absent" only as `undefined`, whereas these arrive as `null` to mean
- * "explicitly cleared". Relaxing the type here avoids forcing every caller to
- * map `null` → `undefined`.
- */
-type VideoCreationSettings = Omit<VideoCreationSettings$1, 'video_style_id' | 'duration_ms'> & {
-  video_style_id?: string | null | undefined;
-  duration_ms?: number | null | undefined;
-};
-/**
- * Video clip part. `duration_ms` is dropped from the authoritative type
- * (reference/17 §5): it is the derived effective length and is re-derived into
- * the read-view by the projection. `play_in` / `play_out` are required (smithy
- * `@required`), so the timeline length is always the trim window over the speed
- * multiplier — no need to store the media's intrinsic length either. `speed_shift`
- * is the IDL type. See `effectiveVideoClipDurationMs`.
- */
-type VideoClipPart = Omit<VideoClipPart$1, 'duration_ms'>;
-/**
- * Speech part. `duration_ms` is dropped from the authoritative type
- * (reference/17 §5) in favour of the engine-only `media_duration_ms`: a speech
- * cannot be trimmed or speed-shifted, so its effective timeline duration equals
- * the TTS audio's intrinsic length. The read-view `duration_ms` is re-derived
- * from it by the projection.
- */
-type SpeechPart = Omit<SpeechPart$1, 'duration_ms'> & {
-  media_duration_ms?: number | undefined;
-};
-/**
- * Authoritative caption part. The IDL `CaptionPart` carries `duration_ms` (the
- * effective display length, a derived read-view value); the authoritative store
- * instead keeps `initial_duration_ms` — the caption's length at generation time,
- * parsed from the voiceover, a resource-intrinsic fact that does not change
- * (reference/17 §5; onscreen-caption plan). The effective `duration_ms` is
- * re-derived into the `VideoDraft` read-view by the projection.
- *
- * `speech_part_id` / `start_ms` are kept as resource-intrinsic facts (which
- * speech it was split from, and its offset in that source) — reference/17
- * principle 4.
- */
-type CaptionPart = Omit<CaptionPart$1, 'duration_ms'> & {
-  initial_duration_ms?: number | undefined;
-};
-/**
- * Background music. The IDL marks `duration_ms` required (via its part mixin),
- * but a bgm has no authoritative duration — its effective length is always the
- * whole timeline, derived on read (RFC 02 §0b). The engine therefore keeps it
- * optional rather than carrying the IDL's required field into storage.
- */
-type BgmPart = Omit<BgmPart$1, 'duration_ms'> & {
-  duration_ms?: number | undefined;
-};
-/**
- * How a `TrackItem`'s start is determined — the authoritative positioning fact
- * (RFC 02 §4, reference/17 §3). The absolute time is never stored; it is solved
- * by the cascade at projection time. The three modes express "where the start
- * comes from": `sequential` follows the track's flow order, `anchored` hangs off
- * another part plus an offset, `absolute` pins to the timeline origin.
- * `anchorPartId` points at another item's `part_id` (a part is placed at most
- * once per lane, so `part_id` is the placement identity).
- *
- * `time_position` carries only the real editing intent (mode + anchor + offset),
- * so it is a single last-writer-wins unit safe to overwrite wholesale. The
- * derived fallback snapshot lives outside it on `TrackItem.fallback_abs_ms`.
- */
-type TrackItemTimePosition = {
-  mode: 'sequential';
-} | {
-  mode: 'anchored';
-  anchorPartId: string;
-  offsetMs: number;
-} | {
-  mode: 'absolute';
-  offsetMs: number;
-};
-/**
- * Authoritative track item: only facts. Absolute time is derived, not stored.
- *
- * `fallback_abs_ms` is the one deliberately-retained derived snapshot in
- * authoritative state: the `relative` item's absolute landing, so that when its
- * anchor is concurrently deleted (orphan, RFC 02 §11.1), the item can be put
- * back on the timeline and re-parented to the nearest video — orphan handling
- * needs an absolute anchor and cannot guess one.
- *
- * It is written by the write-side ops that create or move a `relative` item:
- * each resolves the item's absolute landing from its anchor once (add/change
- * speech from the host clip's start + offset; `moveSpeeches` from the requested
- * start; §9.1 reparent from the preserved abs) and stamps it here. The read-side
- * projection never writes it back — the authoritative model stays write-derived,
- * not read-derived. It is a field of its own (not inside `time_position`) so the
- * two are separate LWW units: a fallback refresh can never clobber a concurrent
- * `offsetMs` edit, since they carry unequal business value. When the anchor's
- * absolute position cannot be resolved at write time it is left undefined. Only
- * meaningful for `anchored` items.
- */
-interface TrackItem {
-  part_id: string;
-  time_position: TrackItemTimePosition;
-  fallback_abs_ms?: number | undefined;
-}
-interface Track {
-  id: string | undefined;
-  parts_kind: PartKind | undefined;
-  is_hidden: boolean | undefined;
-  items: TrackItem[] | undefined;
-}
-/**
- * Authoritative part union: a flat discriminated union over the four part kinds.
- * Deliberately *not* the IDL's namespace union (no `$unknown` / `visit`): engine
- * storage rejects unknown kinds, and projection / validation read parts by plain
- * `part.video_clip` / `part.speech` property access, which this shape supports.
- */
-type PartUnion = {
-  video_clip: VideoClipPart;
-  speech?: never;
-  caption?: never;
-  bgm?: never;
-} | {
-  video_clip?: never;
-  speech: SpeechPart;
-  caption?: never;
-  bgm?: never;
-} | {
-  video_clip?: never;
-  speech?: never;
-  caption: CaptionPart;
-  bgm?: never;
-} | {
-  video_clip?: never;
-  speech?: never;
-  caption?: never;
-  bgm: BgmPart;
-};
-/**
- * Read-view part union for the derived `VideoDraft` (reference/17 §5/§7). The
- * authoritative parts drop their derived durations; the projection re-injects an
- * effective `duration_ms` for downstream compatibility — for a video clip it is
- * `(play_out - play_in) / speed`, for a speech it is `media_duration_ms`, for a
- * caption it is `initial_duration_ms`, for a bgm it is the timeline total. Each
- * read-view part is therefore the authoritative part plus a derived `duration_ms`.
- */
-type VideoDraftPartUnion = {
-  video_clip: VideoClipPart & {
-    duration_ms?: number;
-  };
-  speech?: never;
-  caption?: never;
-  bgm?: never;
-} | {
-  video_clip?: never;
-  speech: SpeechPart & {
-    duration_ms?: number;
-  };
-  caption?: never;
-  bgm?: never;
-} | {
-  video_clip?: never;
-  speech?: never;
-  caption: CaptionPart & {
-    duration_ms?: number;
-  };
-  bgm?: never;
-} | {
-  video_clip?: never;
-  speech?: never;
-  caption?: never;
-  bgm: BgmPart & {
-    duration_ms?: number;
-  };
-};
-/**
- * Legacy Draft import shape. It allows omitted durations and engine extensions
- * so existing fixtures and migrations can state only the facts they have.
- * Projection returns the narrower `VideoDraftContent` contract instead.
- */
-type VideoDraft = Omit<VideoDraft$1, 'part_library' | 'video_creation_settings'> & {
-  part_library: Record<string, VideoDraftPartUnion> | undefined;
-  video_creation_settings?: VideoCreationSettings | undefined;
-};
-/**
- * The complete content read model produced by the shared projection. Business
- * identity, settings, thumbnail and revision counters are assembled by Director;
- * keeping an explicit field list prevents new business DTO fields entering here.
- */
-type VideoDraftContent = Pick<VideoDraft, 'timeline' | 'main_track' | 'above_main_tracks' | 'below_main_tracks' | 'part_aggregations'> & {
-  part_library: Record<string, VideoDraftContentPartUnion> | undefined;
-};
-/** Projection always states the duration field; legacy imports may omit it. */
-type VideoDraftContentPartUnion = {
-  video_clip: VideoClipPart & {
-    duration_ms: number | undefined;
-  };
-  speech?: never;
-  caption?: never;
-  bgm?: never;
-} | {
-  video_clip?: never;
-  speech: SpeechPart & {
-    duration_ms: number | undefined;
-  };
-  caption?: never;
-  bgm?: never;
-} | {
-  video_clip?: never;
-  speech?: never;
-  caption: CaptionPart & {
-    duration_ms: number | undefined;
-  };
-  bgm?: never;
-} | {
-  video_clip?: never;
-  speech?: never;
-  caption?: never;
-  bgm: BgmPart & {
-    duration_ms: number | undefined;
-  };
-};
-/** Authoritative timeline: `duration_ms` is derived (= longest track), not stored. */
-interface Timeline {
-  unit_time_ms: number | undefined;
-}
-/**
- * The `timeline.unit_time_ms` the read-view states when the document states none.
- *
- * One frame at 30fps. A document legitimately has no such fact (display
- * granularity is the editor's, not the timeline's), but the read-view IDL marks
- * the field `@required`, so the projection has to name a value. This one is a
- * usable granularity; `0` — which a downstream consumer had been defaulting to —
- * is not, and passes any `>= 0` guard on its way to an editor that cannot use it.
- */
-declare const DEFAULT_UNIT_TIME_MS = 33.333;
-/**
- * Authoritative collaborative document: only facts. Positioning lives on each
- * `TrackItem.time_position`; absolute time, `part_aggregations`, and total
- * duration are derived in the `VideoDraft` projection, not stored here (RFC 02 §6).
- *
- * The content mirrors Loro storage: timeline, part library, and a single
- * ordered `tracks` list (reference/17 §4). Business metadata stays in Director. A
- * track's lane is expressed by its `parts_kind`, not by which container it lives
- * in — the `main` / `above` / `below` three-pane view is reconstructed at
- * projection time. Order is the list order itself, so there is no `lane` /
- * `lane_order` field to diverge under concurrent edits.
- */
-interface VideoDocument {
-  timeline: Timeline | undefined;
-  tracks: Track[] | undefined;
-  part_library: Record<string, PartUnion> | undefined;
-}
-type VideoDocumentValidationIssueCode = 'invalid_schema' | 'duplicate_track_item_identity' | 'duplicate_lane_track' | 'unknown_part_kind' | 'part_kind_mismatch' | 'missing_part_reference' | 'track_kind_mismatch' | 'main_track_non_video_clip' | 'invalid_part_value' | 'invalid_speech_caption_reference' | 'invalid_position_anchor';
-/**
- * Issue severity (RFC 02 §11.1). `error` is a hard reject — the document is not
- * a legal `VideoDocument` and must not be projected. `recoverable` marks a
- * business inconsistency the projection is designed to heal on read (currently
- * only a dangling `anchorPartId`: the orphan condition, recovered via the item's
- * `fallback_abs_ms` snapshot + cascade reassign), so it is surfaced for
- * observability but does NOT block projection. Absent `severity` means `error`.
- */
-type VideoDocumentValidationIssueSeverity = 'error' | 'recoverable';
-interface VideoDocumentValidationIssue {
-  code: VideoDocumentValidationIssueCode;
-  path: string;
-  message: string;
-  severity?: VideoDocumentValidationIssueSeverity;
-}
-//#endregion
-//#region src/document/projection.d.ts
-/**
- * Projection between authoritative `VideoDocument` and compatible content
- * layouts (RFC 02 §5/§7). Both directions live here:
- *
- * - `toVideoDocument` ingests a `VideoDraft`, deriving each item's `position`
- *   from the legacy absolute layout + aggregations; derived values (abs time,
- *   `part_aggregations`, total duration) are dropped.
- * - `fromVideoDocument` solves a `VideoDocument` into `VideoDraftContent` via the
- *   timeline-core cascade, re-deriving exactly those values.
- *
- * Business validation lives in `validation.ts`; `fromVideoDocument` asserts a
- * valid document before solving.
- */
-/**
- * Ingest the legacy `VideoDraft` into the authoritative `VideoDocument`,
- * deriving each item's `time_position` from the legacy absolute layout +
- * aggregations (RFC 02 §4/§5). Absolute time, `part_aggregations`, and total
- * duration are dropped — they are re-derived by the projection.
- */
-declare function toVideoDocument(draft: Pick<VideoDraft, keyof VideoDraftContent>): VideoDocument;
-/** speech/attachment part_id → its host video part_id + relative offset. */
-type SpeechHostMap = Map<string, {
-  hostPartId: string;
-  offsetMs: number;
-}>;
-/**
- * Build a speech-host map from a part_aggregations list. Used by
- * `toVideoDocument` (legacy VideoDraft → VideoDocument) to recover each speech's
- * host video clip and relative offset. Aggregation items with null ids are
- * skipped (malformed input tolerance).
- */
-declare function buildSpeechHostMap(aggregations: Array<{
-  body_part_id?: string | null;
-  attachments?: Array<{
-    part_id?: string | null;
-    relative_time_position?: number | null;
-  }> | null;
-}> | null | undefined): SpeechHostMap;
-/** The derived time position + orphan-recovery snapshot for one item. */
-interface DerivedItemPosition {
-  timePosition: TrackItemTimePosition;
-  /** Present only for `anchored` items (RFC 02 §11.1). */
-  fallbackAbsMs?: number;
-}
-/**
- * Derive `time_position` (and `fallbackAbsMs` for anchored items) from a legacy
- * absolute time + pre-built speech-host map + part library. The three-branch
- * rule (RFC 02 §4/§5, reference/17 §3):
- *
- *   1. main-track → `sequential`
- *   2. speech/attachment (part_id in speechHost) → `anchored(host, offsetMs)`
- *   3. caption (part has `speech_part_id`) → `anchored(speech, start_ms)`
- *   4. everything else → `absolute(abs)`
- *
- * `partLibrary` values may be `PartUnion | string | undefined` (draft raw
- * form); only object-typed entries are inspected for `caption`.
- */
-declare function derivePositionFromAbs(partId: string, abs: number, isMain: boolean, speechHost: SpeechHostMap, partLibrary: Record<string, PartUnion | string | undefined>): DerivedItemPosition;
-/**
- * Project `VideoDocument` into `VideoDraftContent`, solving each item's
- * absolute position, the `part_aggregations`, and
- * the total duration via the timeline-core cascade.
- *
- * The read-view is a compatibility contract, and the IDL declares
- * `Timeline.unit_time_ms` and `Track.is_hidden` `@required`
- * (`video_draft_comp.smithy`) — so a projection that omitted them handed every
- * consumer a payload that violated the shape it claims to satisfy, leaving each
- * one to invent its own default. Two already had, and they disagreed: the agent
- * harness used `unit_time_ms: 0`, director used a frame at 30fps. Defaulting here
- * makes the contract true at the one place that produces it.
- *
- * These two are defaultable because the projection knows their values on its own:
- * absent `unit_time_ms` means "no display granularity was ever stated" and absent
- * `is_hidden` means "this track was never hidden". `version` is NOT defaultable
- * here — it belongs to Director assembly using the server envelope update_seq.
- * Neither business metadata nor a revision counter belongs in content projection.
- */
-declare function fromVideoDocument(document: VideoDocument): VideoDraftContent;
-//#endregion
-//#region src/document/initial-document.d.ts
-/**
- * Build the `VideoDocument` a newly created project starts from: the caller's
- * no parts and one empty track per lane. Business facts remain in Director.
- *
- * The empty lane tracks are the reason this function exists rather than callers
- * assembling a document inline. Lane tracks are otherwise minted lazily by the
- * first op that needs one (`ensureLaneTrack`), which is find-then-mint over a
- * CRDT list — so if the Agent's first generation and a user edit race on an
- * empty document, each mints its own copy of the same lane and the merge keeps
- * both. Two video_clip tracks violate the at-most-one-main-track rule, and the
- * merged document becomes unprojectable for *every* reader (editor, render,
- * share) with no winning replica to fall back on. Seeding all four lanes up
- * front means `ensureLaneTrack` only ever finds, never mints, so the race cannot
- * happen on a document created here.
- *
- * All four, not just the main lane: the secondary lanes fail less loudly (a
- * duplicate pane rather than an unreadable document), but they fail by the same
- * mechanism, and covering only the fatal one would leave three live races.
- *
- * `timeline` is left absent: `unit_time_ms` is a display concern the editor
- * supplies, and total duration is derived on read (RFC 02 §6), so a new document
- * has no timeline fact to state.
- */
-declare function buildInitialVideoDocument(): VideoDocument;
-//#endregion
-//#region src/document/validation.d.ts
-/**
- * Business-level schema guard for `VideoDocument` (RFC 03 §9). It is the gate
- * that decides whether an arbitrary value is a *legal* `VideoDocument` before it
- * is written into Loro — distinct from two neighbours:
- *
- * - `zod-schema.ts` (`videoDocumentSchema`) checks structure/shape only; this
- *   file layers the business rules on top (part-kind match, reference integrity,
- *   `position.anchorPartId` targets, value ranges, identity uniqueness).
- * - loro-mirror's own `validateSchema` (run on every `setState`) only checks the
- *   storage structure, never these business invariants.
- *
- * Projection (`projection.ts`) calls `assertValidVideoDocument` before solving a
- * document into the legacy `VideoDraft`.
- */
-declare class VideoDocumentValidationError extends Error {
-  readonly issues: VideoDocumentValidationIssue[];
-  constructor(issues: VideoDocumentValidationIssue[]);
-}
-/**
- * Assert the document is legal enough to project. Only `error`-severity issues
- * hard-reject; `recoverable` ones (dangling anchor / orphan, RFC 02 §11.1) are
- * left for the projection to heal on read and do NOT throw. Use
- * `validateVideoDocument` directly to inspect recoverable issues too.
- */
-declare function assertValidVideoDocument(document: unknown): asserts document is VideoDocument;
-declare function validateVideoDocument(document: unknown): VideoDocumentValidationIssue[];
-//#endregion
-//#region src/document/mirror-schema.d.ts
-declare const videoDocumentMirrorSchema: import("loro-mirror").RootSchemaType<{
-  timeline: import("loro-mirror").LoroMapSchema<{
-    unit_time_ms: /*elided*/any;
-  }> & {
-    options: {};
-  } & {
-    catchall: <C extends import("loro-mirror").SchemaType>(catchallSchema: C) => import("loro-mirror").LoroMapSchemaWithCatchall<{
-      unit_time_ms: /*elided*/any;
-    }, C>;
-  };
-  tracks: import("loro-mirror").LoroMovableListSchema<import("loro-mirror").LoroMapSchema<{
-    id: /*elided*/any;
-    parts_kind: /*elided*/any;
-    is_hidden: /*elided*/any;
-    items: /*elided*/any;
-  }> & {
-    options: {};
-  } & {
-    catchall: <C extends import("loro-mirror").SchemaType>(catchallSchema: C) => import("loro-mirror").LoroMapSchemaWithCatchall<{
-      id: /*elided*/any;
-      parts_kind: /*elided*/any;
-      is_hidden: /*elided*/any;
-      items: /*elided*/any;
-    }, C>;
-  }> & {
-    options: {};
-  };
-  part_library: import("loro-mirror").LoroMapSchemaWithCatchall<{}, import("loro-mirror").LoroMapSchema<{
-    video_clip: /*elided*/any;
-    speech: /*elided*/any;
-    caption: /*elided*/any;
-    bgm: /*elided*/any;
-  }> & {
-    options: {};
-  } & {
-    catchall: <C extends import("loro-mirror").SchemaType>(catchallSchema: C) => import("loro-mirror").LoroMapSchemaWithCatchall<{
-      video_clip: /*elided*/any;
-      speech: /*elided*/any;
-      caption: /*elided*/any;
-      bgm: /*elided*/any;
-    }, C>;
-  }> & {
-    options: {};
-  };
-}> & {
-  options: {};
-};
-type VideoDocumentMirrorSchema = typeof videoDocumentMirrorSchema;
-/**
- * The mutable draft an op's `transact` callback edits, inferred from the schema.
- *
- * `InferInputType` is the schema's *input* shape: the declared business fields
- * with the `$cid` container ids (which mirror injects into its output
- * `InferType`) made optional, so ops assign plain objects without supplying
- * `$cid`. Deriving it from the schema keeps draft and storage in lockstep — a
- * schema change is a compile error at every edit site, not a silent drift.
- * Reorders within `items` still diff to real Loro `move` ops because the schema
- * keys items by `part_id`.
- */
-type VideoDocumentDraft = InferInputType<VideoDocumentMirrorSchema>;
-/** Track value as it appears in a draft. Derived from the single `tracks` movable list. */
-type TrackDraft = NonNullable<NonNullable<VideoDocumentDraft['tracks']>[number]>;
-/** A single track item in a draft. */
-type TrackItemDraft = NonNullable<NonNullable<TrackDraft['items']>[number]>;
-//#endregion
-//#region src/editor/schemas/add-speeches.d.ts
-/**
- * Add speeches (and their captions). TTS runs upstream; the stable speech /
- * caption parts arrive materialized (see `speech-assets.ts`). The op writes the
- * parts and each speech's `{ mode:'anchored', anchorPartId, offsetMs }` fact
- * verbatim — no write-time host-picking, no cascade (RFC 02 §4). The projection
- * derives absolute positions on read.
- */
-declare const addSpeechesInputSchema: z.ZodObject<{
-  speeches: z.ZodArray<z.ZodObject<{
-    speech_id: z.ZodString;
-    anchor_part_id: z.ZodString;
-    offset_ms: z.ZodNumber;
-    audio_storage_key: z.ZodString;
-    duration_ms: z.ZodNumber;
-    audio_script: z.ZodString;
-    volume: z.ZodNumber;
-    voice: z.ZodObject<{
-      id: z.ZodString;
-      name: z.ZodString;
-    }, z.core.$strip>;
-    origin_speech_id: z.ZodString;
-    caption_ids: z.ZodArray<z.ZodString>;
-  }, z.core.$strip>>;
-  captions: z.ZodArray<z.ZodObject<{
-    caption_id: z.ZodString;
-    speech_part_id: z.ZodString;
-    text: z.ZodString;
-    start_ms: z.ZodNumber;
-    duration_ms: z.ZodNumber;
-  }, z.core.$strip>>;
-}, z.core.$strip>;
-type AddSpeechesInput = z.infer<typeof addSpeechesInputSchema>;
-//#endregion
-//#region src/editor/schemas/add-video-clips.d.ts
-/**
- * Add video clips to a track. Each clip's duration facts are separated so a
- * single number is never overloaded (RFC 02 / `reference/16` §0b):
- *
- * - `media_duration_ms` is the source media's intrinsic full length (a resource
- *   fact, written to the part);
- * - `play_in` / `play_out` are the optional trim window into that media; when
- *   omitted the whole media is used (`play_in=0`, `play_out=media_duration_ms`).
- *
- * The clip's effective timeline duration is derived by the projection from the
- * trim window and `speed_shift` — it is never an input here.
- */
-declare const addVideoClipsInputSchema: z.ZodObject<{
-  clips: z.ZodArray<z.ZodObject<{
-    media_id: z.ZodString;
-    start_ms: z.ZodOptional<z.ZodNumber>;
-    media_duration_ms: z.ZodNumber;
-    play_in: z.ZodOptional<z.ZodNumber>;
-    play_out: z.ZodOptional<z.ZodNumber>;
-    track_id: z.ZodOptional<z.ZodString>;
-  }, z.core.$strip>>;
-  before_clip_id: z.ZodOptional<z.ZodString>;
-  after_clip_id: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-type AddVideoClipsInput = z.infer<typeof addVideoClipsInputSchema>;
-//#endregion
-//#region src/editor/schemas/adjust-bgm-volume.d.ts
-declare const adjustBgmVolumeInputSchema: z.ZodObject<{
-  bgm: z.ZodArray<z.ZodObject<{
-    bgm_id: z.ZodString;
-    volume: z.ZodNumber;
-  }, z.core.$strip>>;
-}, z.core.$strip>;
-type AdjustBgmVolumeInput = z.infer<typeof adjustBgmVolumeInputSchema>;
-//#endregion
-//#region src/editor/schemas/adjust-speech-volume.d.ts
-declare const adjustSpeechVolumeInputSchema: z.ZodObject<{
-  speeches: z.ZodArray<z.ZodObject<{
-    speech_id: z.ZodString;
-    volume: z.ZodNumber;
-  }, z.core.$strip>>;
-}, z.core.$strip>;
-type AdjustSpeechVolumeInput = z.infer<typeof adjustSpeechVolumeInputSchema>;
-//#endregion
-//#region src/editor/schemas/adjust-video-clip-duration.d.ts
-/**
- * Re-trim existing video clips (the user-facing "adjust duration" gesture is a
- * trim of the source window). The new `play_in` / `play_out` are the facts; the
- * effective timeline duration is derived from them and the clip's `speed_shift`,
- * and the change reflows downstream clips, speeches, and the timeline inside the
- * op's transaction (no caller-materialized cascade).
- */
-declare const adjustVideoClipDurationInputSchema: z.ZodObject<{
-  clips: z.ZodArray<z.ZodObject<{
-    clip_id: z.ZodString;
-    play_in: z.ZodNumber;
-    play_out: z.ZodNumber;
-  }, z.core.$strip>>;
-}, z.core.$strip>;
-type AdjustVideoClipDurationInput = z.infer<typeof adjustVideoClipDurationInputSchema>;
-//#endregion
-//#region src/editor/schemas/adjust-video-clip-volume.d.ts
-declare const adjustVideoClipVolumeInputSchema: z.ZodObject<{
-  clips: z.ZodArray<z.ZodObject<{
-    clip_id: z.ZodString;
-    volume: z.ZodNumber;
-  }, z.core.$strip>>;
-}, z.core.$strip>;
-type AdjustVideoClipVolumeInput = z.infer<typeof adjustVideoClipVolumeInputSchema>;
-//#endregion
-//#region src/editor/schemas/change-speech.d.ts
-/**
- * Change a speech's script or voice. Both re-run TTS upstream and return the
- * regenerated speech / caption parts in the same materialized shape as
- * `AddSpeeches` (`speech-assets.ts`); the op upserts them by id (the speech part
- * id is preserved across a re-TTS), re-seats at `start_ms`, and reflows. Old
- * caption parts no longer owned by the speech are removed via `caption_ids`.
- */
-declare const changeSpeechScriptInputSchema: z.ZodObject<{
-  speeches: z.ZodArray<z.ZodObject<{
-    speech_id: z.ZodString;
-    anchor_part_id: z.ZodString;
-    offset_ms: z.ZodNumber;
-    audio_storage_key: z.ZodString;
-    duration_ms: z.ZodNumber;
-    audio_script: z.ZodString;
-    volume: z.ZodNumber;
-    voice: z.ZodObject<{
-      id: z.ZodString;
-      name: z.ZodString;
-    }, z.core.$strip>;
-    origin_speech_id: z.ZodString;
-    caption_ids: z.ZodArray<z.ZodString>;
-  }, z.core.$strip>>;
-  captions: z.ZodArray<z.ZodObject<{
-    caption_id: z.ZodString;
-    speech_part_id: z.ZodString;
-    text: z.ZodString;
-    start_ms: z.ZodNumber;
-    duration_ms: z.ZodNumber;
-  }, z.core.$strip>>;
-}, z.core.$strip>;
-declare const changeSpeechVoiceInputSchema: z.ZodObject<{
-  speeches: z.ZodArray<z.ZodObject<{
-    speech_id: z.ZodString;
-    anchor_part_id: z.ZodString;
-    offset_ms: z.ZodNumber;
-    audio_storage_key: z.ZodString;
-    duration_ms: z.ZodNumber;
-    audio_script: z.ZodString;
-    volume: z.ZodNumber;
-    voice: z.ZodObject<{
-      id: z.ZodString;
-      name: z.ZodString;
-    }, z.core.$strip>;
-    origin_speech_id: z.ZodString;
-    caption_ids: z.ZodArray<z.ZodString>;
-  }, z.core.$strip>>;
-  captions: z.ZodArray<z.ZodObject<{
-    caption_id: z.ZodString;
-    speech_part_id: z.ZodString;
-    text: z.ZodString;
-    start_ms: z.ZodNumber;
-    duration_ms: z.ZodNumber;
-  }, z.core.$strip>>;
-}, z.core.$strip>;
-type ChangeSpeechScriptInput = z.infer<typeof changeSpeechScriptInputSchema>;
-type ChangeSpeechVoiceInput = z.infer<typeof changeSpeechVoiceInputSchema>;
-//#endregion
-//#region src/editor/schemas/delete-bgm.d.ts
-/**
- * Remove the document BGM. Pure document edit: clears the bgm lane and removes
- * the bgm part. Takes no input (a document holds at most one bgm); an empty
- * object keeps the op signature uniform with the rest.
- */
-declare const deleteBgmInputSchema: z.ZodObject<{}, z.core.$strip>;
-type DeleteBgmInput = z.infer<typeof deleteBgmInputSchema>;
-//#endregion
-//#region src/editor/schemas/delete-speeches.d.ts
-/**
- * Delete speeches with their captions. Pure document edit (no side effect): the
- * op removes each speech part, cascade-deletes the captions it owns (via
- * `caption_ids` / `speech_part_id`), drops their track items, and reflows.
- */
-declare const deleteSpeechesInputSchema: z.ZodObject<{
-  speech_ids: z.ZodArray<z.ZodString>;
-}, z.core.$strip>;
-type DeleteSpeechesInput = z.infer<typeof deleteSpeechesInputSchema>;
-//#endregion
-//#region src/editor/schemas/delete-video-clips.d.ts
-/**
- * How a delete handles the anchored subtree (speeches anchored to a deleted clip,
- * and their captions) — a delete-op policy, not a data-model field (reference/17
- * §6). `cascade` (default) removes the subtree; `detach` keeps the direct
- * anchored children, re-pinning them to `absolute` so they stay on the timeline.
- */
-declare const anchoredDeletePolicySchema: z.ZodEnum<{
-  cascade: "cascade";
-  detach: "detach";
-}>;
-type AnchoredDeletePolicy = z.infer<typeof anchoredDeletePolicySchema>;
-declare const deleteVideoClipsInputSchema: z.ZodObject<{
-  clip_ids: z.ZodArray<z.ZodString>;
-  on_anchored: z.ZodOptional<z.ZodEnum<{
-    cascade: "cascade";
-    detach: "detach";
-  }>>;
-}, z.core.$strip>;
-type DeleteVideoClipsInput = z.infer<typeof deleteVideoClipsInputSchema>;
-//#endregion
-//#region src/editor/schemas/move-speeches.d.ts
-/**
- * Move speeches in time. Pure document edit: the op re-seats each speech at its
- * new absolute `start_ms`; the cascade reassigns it to the host video clip,
- * resolves overlaps, and reflows. Captions follow their speech.
- */
-declare const moveSpeechesInputSchema: z.ZodObject<{
-  speeches: z.ZodArray<z.ZodObject<{
-    speech_id: z.ZodString;
-    new_start_ms: z.ZodNumber;
-  }, z.core.$strip>>;
-}, z.core.$strip>;
-type MoveSpeechesInput = z.infer<typeof moveSpeechesInputSchema>;
-//#endregion
-//#region src/editor/schemas/move-video-clips-by-anchor.d.ts
-/**
- * Where the moved block lands on the main track.
- *
- * A discriminated union rather than two optional `before_clip_id` /
- * `after_clip_id` fields (the shape `addVideoClips` had to use, because there the
- * two modes share a whole clip description): here the alternatives carry nothing
- * in common, so making them mutually exclusive *by type* removes three runtime
- * `superRefine` checks that would otherwise have to be written and tested.
- *
- * `track_start` is an explicit member, not the absence of an anchor. The
- * agent-harness mutation this maps from treats "neither anchor given" as
- * "move to the front" (`applyBatchMoveVideoClips` falls back to `insertIndex = 0`),
- * which is a default buried in a tool description. Requiring the caller to name
- * that intent keeps a forgotten field from silently reordering the timeline.
- */
-declare const moveAnchorSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-  position: z.ZodLiteral<"before">;
-  clip_id: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-  position: z.ZodLiteral<"after">;
-  clip_id: z.ZodString;
-}, z.core.$strip>, z.ZodObject<{
-  position: z.ZodLiteral<"track_start">;
-}, z.core.$strip>], "position">;
-/**
- * What happens to the speeches anchored to the clips being moved.
- *
- * - `follow` keeps each speech anchored where it is, so it travels with its clip
- *   to the new position. In the anchored model this is the *no-op* branch: a
- *   speech's authoritative fact is `{ anchorPartId, offsetMs }` and its absolute
- *   time is derived on read from the host's position, so moving the host moves
- *   the speech with no write to the speech at all.
- * - `keep_absolute` preserves each speech's current absolute landing instead, then
- *   re-anchors it to whichever clip now covers that time (RFC 02 §9.1/§11.1). This
- *   is the branch that costs an extra pass, and the one the FE timeline uses.
- *
- * **Required, with no default**, matching `deleteVideoClips` and
- * `replaceVideoClipSequence`. The two branches decide which picture the user's
- * narration ends up over, which is too consequential to infer from a missing
- * field — and neither branch is "safe enough" to be the implicit one.
- */
-declare const movedClipAnchoredPolicySchema: z.ZodEnum<{
-  follow: "follow";
-  keep_absolute: "keep_absolute";
-}>;
-/**
- * Reorder a set of main-track clips relative to a reference clip.
- *
- * Distinct from `moveVideoClips`, which positions clips by absolute time
- * (`new_start_ms`) and is what the FE timeline dispatches after a drag. Main-track
- * clips are `sequential`-positioned, so absolute time is not authoritative state
- * there (RFC 02 §4/§7): `moveVideoClips` has to *guess* an index back out of the
- * time it was handed, whereas an anchor already is the ordinal fact being changed.
- * Keeping them separate also isolates blast radius — this method can diverge on
- * speech policy without touching the FE path.
- *
- * `clip_ids` need not be contiguous. They move as one block, keeping their
- * relative order, which is the agent-harness `batch_move_video_clips` contract.
- */
-declare const moveVideoClipsByAnchorInputSchema: z.ZodObject<{
-  clip_ids: z.ZodArray<z.ZodString>;
-  anchor: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    position: z.ZodLiteral<"before">;
-    clip_id: z.ZodString;
-  }, z.core.$strip>, z.ZodObject<{
-    position: z.ZodLiteral<"after">;
-    clip_id: z.ZodString;
-  }, z.core.$strip>, z.ZodObject<{
-    position: z.ZodLiteral<"track_start">;
-  }, z.core.$strip>], "position">;
-  on_anchored: z.ZodEnum<{
-    follow: "follow";
-    keep_absolute: "keep_absolute";
-  }>;
-}, z.core.$strip>;
-type MoveAnchor = z.infer<typeof moveAnchorSchema>;
-type MovedClipAnchoredPolicy = z.infer<typeof movedClipAnchoredPolicySchema>;
-type MoveVideoClipsByAnchorInput = z.infer<typeof moveVideoClipsByAnchorInputSchema>;
-//#endregion
-//#region src/editor/schemas/move-video-clips.d.ts
-declare const moveVideoClipsInputSchema: z.ZodObject<{
-  clips: z.ZodArray<z.ZodObject<{
-    clip_id: z.ZodString;
-    new_start_ms: z.ZodNumber;
-    new_track_id: z.ZodOptional<z.ZodString>;
-  }, z.core.$strip>>;
-}, z.core.$strip>;
-type MoveVideoClipsInput = z.infer<typeof moveVideoClipsInputSchema>;
-//#endregion
-//#region src/editor/schemas/replace-video-clip-content.d.ts
-/**
- * Replace the media backing existing video clips. The media import runs upstream
- * (Director); its stable result — the new media id, intrinsic length, and the
- * reset trim window — arrives materialized (see
- * `results/phase-4-side-effect-payload-contract.md` §4). Director resets
- * `play_in=0` / `play_out=media_duration_ms` and clears `speed_shift` on
- * replacement. The clip `part_id`s (hence their track items) are unchanged; the
- * editor reflows the main track from the new effective durations.
- */
-declare const replaceVideoClipContentInputSchema: z.ZodObject<{
-  clips: z.ZodArray<z.ZodObject<{
-    clip_id: z.ZodString;
-    origin_media_id: z.ZodString;
-    media_duration_ms: z.ZodNumber;
-    play_in: z.ZodNumber;
-    play_out: z.ZodNumber;
-    volume: z.ZodNumber;
-  }, z.core.$strip>>;
-}, z.core.$strip>;
-type ReplaceVideoClipContentInput = z.infer<typeof replaceVideoClipContentInputSchema>;
-//#endregion
-//#region src/editor/schemas/replace-video-clip-sequence.d.ts
-/**
- * What happens to the speeches anchored to the clips being replaced.
- *
- * - `remap` re-anchors each surviving speech to the new clip in the SAME POSITION
- *   of the sequence, keeping its offset — old[i]'s children become new[i]'s
- *   children. An old clip with no counterpart (fewer new clips than old) has its
- *   subtree deleted, because there is nothing left to anchor to.
- * - `cascade` deletes every anchored speech (and its captions) outright, like
- *   `deleteVideoClips`.
- *
- * **Required, with no default.** The two branches differ in whether the user's
- * narration survives, and the agent tool that drives this op makes its
- * `preserve_speeches` flag required for that reason. A default here would let a
- * caller that forgot the field silently delete speech.
- */
-declare const anchoredReplacePolicySchema: z.ZodEnum<{
-  cascade: "cascade";
-  remap: "remap";
-}>;
-type AnchoredReplacePolicy = z.infer<typeof anchoredReplacePolicySchema>;
-/**
- * Replace a contiguous run of main-track clips with a new run.
- *
- * A composite of delete + insert that cannot be expressed as the two ops in
- * sequence, because the anchored speeches have to survive *across* the swap: with
- * `remap` they are re-anchored positionally, which needs both the old and the new
- * ids in the same transaction (ADR 0009 — the cascade stays in the editor, callers
- * never re-wire anchors themselves).
- *
- * Duration facts follow `addVideoClips`: `media_duration_ms` is the source's
- * intrinsic length and the trim window defaults to the whole media. The effective
- * timeline duration is derived by the projection, never an input.
- *
- * `media_id` is optional: omitting it creates a **deliberate empty placeholder
- * clip** (`origin_media_id: ''`) — structure with no picture. This is the only op
- * that can produce one, and it is authoritative state, unlike the gap fillers the
- * read-side solve mints (which never enter the document).
- */
-declare const replaceVideoClipSequenceInputSchema: z.ZodObject<{
-  old_clip_ids: z.ZodArray<z.ZodString>;
-  new_clips: z.ZodArray<z.ZodObject<{
-    media_id: z.ZodOptional<z.ZodString>;
-    media_duration_ms: z.ZodNumber;
-    play_in: z.ZodOptional<z.ZodNumber>;
-    play_out: z.ZodOptional<z.ZodNumber>;
-  }, z.core.$strip>>;
-  on_anchored: z.ZodEnum<{
-    cascade: "cascade";
-    remap: "remap";
-  }>;
-}, z.core.$strip>;
-type ReplaceVideoClipSequenceInput = z.infer<typeof replaceVideoClipSequenceInputSchema>;
-//#endregion
-//#region src/editor/schemas/set-bgm.d.ts
-/**
- * Set the document BGM. The media's stable result (storage key) arrives
- * materialized from upstream (see
- * `results/phase-4-side-effect-payload-contract.md` §3). The op upserts the bgm
- * part and seats it on the bgm lane; its effective length is always the whole
- * timeline, derived by the projection on read — so there is no `duration_ms`
- * input or fact (RFC 02 / `reference/16` §0b). A `bgm_id` lets the op replace an
- * existing bgm part by id.
- */
-declare const setBgmInputSchema: z.ZodObject<{
-  bgm_id: z.ZodString;
-  audio_storage_key: z.ZodString;
-  origin_media_id: z.ZodString;
-  volume: z.ZodNumber;
-}, z.core.$strip>;
-type SetBgmInput = z.infer<typeof setBgmInputSchema>;
-//#endregion
-//#region src/editor/schemas/set-caption-style.d.ts
-/**
- * Set the caption visual style. GLOBAL by design: the style applies to every
- * caption part in the document — it carries NO `caption_id`. This mirrors the FE,
- * whose caption-style store (`caption-style.ts:persistCaptionStylePatch`) iterates
- * ALL captions and writes the same normalized style to each; the product has a
- * single document-wide caption style, not per-caption styling.
- *
- * Every field is optional and maps to a `CaptionStyle` attribute (snake_case
- * IDL). A field present in the input is written to every caption; a field ABSENT
- * from the input is left untouched on each caption (the editor merges the patch
- * onto each caption's existing style — this is a value edit, not a full-style
- * replace, so a partial patch such as "recolor only" does not wipe font size).
- *
- * Pure document edit, no cascade — captions keep their positions; only the style
- * sub-map of each caption part changes.
- */
-declare const setCaptionStyleInputSchema: z.ZodObject<{
-  font_id: z.ZodOptional<z.ZodString>;
-  font_size: z.ZodOptional<z.ZodNumber>;
-  font_color: z.ZodOptional<z.ZodString>;
-  font_weight: z.ZodOptional<z.ZodNumber>;
-  entrance_animation: z.ZodOptional<z.ZodString>;
-  entrance_animation_duration_ms: z.ZodOptional<z.ZodNumber>;
-  stroke_color: z.ZodOptional<z.ZodString>;
-  stroke_width: z.ZodOptional<z.ZodNumber>;
-  position_x: z.ZodOptional<z.ZodNumber>;
-  position_y: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-type SetCaptionStyleInput = z.infer<typeof setCaptionStyleInputSchema>;
-//#endregion
-//#region src/editor/schemas/set-caption-visibility.d.ts
-/**
- * Toggle caption visibility (the caption track's `is_hidden` flag). Pure
- * document edit, no cascade — captions keep their positions; only the lane's
- * hidden flag changes.
- */
-declare const setCaptionVisibilityInputSchema: z.ZodObject<{
-  is_hidden: z.ZodBoolean;
-}, z.core.$strip>;
-type SetCaptionVisibilityInput = z.infer<typeof setCaptionVisibilityInputSchema>;
-//#endregion
-//#region src/editor/schemas/set-video-clip-speed-shift.d.ts
-/**
- * Set the playback speed of existing video clips. Per the speed-shift decision
- * (`reference/16` §0): the op writes only the `speed_shift` fact — it does NOT
- * store an effective `duration_ms` (projection derives it from the trim window /
- * speed) and does NOT scale anchored speeches' relative offsets (offsets stay
- * put; the cascade reflows absolute positions). A `null` speed_shift clears the
- * speed back to original (1×).
- */
-declare const setVideoClipSpeedShiftInputSchema: z.ZodObject<{
-  clips: z.ZodArray<z.ZodObject<{
-    clip_id: z.ZodString;
-    speed_shift: z.ZodNullable<z.ZodObject<{
-      category: z.ZodEnum<{
-        curve: "curve";
-        linear: "linear";
-      }>;
-      mode: z.ZodString;
-      config: z.ZodUnion<readonly [z.ZodObject<{
-        linear: z.ZodObject<{
-          speed: z.ZodNumber;
-        }, z.core.$strip>;
-      }, z.core.$strip>, z.ZodObject<{
-        curve: z.ZodObject<{
-          keyframes: z.ZodArray<z.ZodObject<{
-            position: z.ZodNumber;
-            rate: z.ZodNumber;
-            in_tangent: z.ZodOptional<z.ZodObject<{
-              x: z.ZodNumber;
-              y: z.ZodNumber;
-            }, z.core.$strip>>;
-            out_tangent: z.ZodOptional<z.ZodObject<{
-              x: z.ZodNumber;
-              y: z.ZodNumber;
-            }, z.core.$strip>>;
-          }, z.core.$strip>>;
-        }, z.core.$strip>;
-      }, z.core.$strip>]>;
-    }, z.core.$strip>>;
-  }, z.core.$strip>>;
-}, z.core.$strip>;
-type SetVideoClipSpeedShiftInput = z.infer<typeof setVideoClipSpeedShiftInputSchema>;
-//#endregion
-//#region src/editor/schemas/shared.d.ts
-declare const clipIdSchema: z.ZodString;
-declare const clipIdsSchema: z.ZodArray<z.ZodString>;
-declare const mediaIdSchema: z.ZodString;
-declare const speechIdSchema: z.ZodString;
-declare const timelineMsSchema: z.ZodNumber;
-declare const positiveMsSchema: z.ZodNumber;
-declare const volumeSchema: z.ZodNumber;
-declare const speechIdsSchema: z.ZodArray<z.ZodString>;
-/**
- * A clip's playback-speed fact, the only thing `SetVideoClipSpeedShift` writes.
- * Mirrors the IDL `SpeedShift`: `category` is `linear` | `curve`, and `config`
- * is a discriminated union — `{ linear: { speed } }` for a constant multiplier
- * (the multiplier projection reads at `config.linear.speed`) or `{ curve: {
- * keyframes } }` for a Bezier-controlled variable speed (RFC 02 / `reference/16`
- * §0). Exactly one of `linear` / `curve` is present.
- */
-declare const speedShiftSchema: z.ZodObject<{
-  category: z.ZodEnum<{
-    curve: "curve";
-    linear: "linear";
-  }>;
-  mode: z.ZodString;
-  config: z.ZodUnion<readonly [z.ZodObject<{
-    linear: z.ZodObject<{
-      speed: z.ZodNumber;
-    }, z.core.$strip>;
-  }, z.core.$strip>, z.ZodObject<{
-    curve: z.ZodObject<{
-      keyframes: z.ZodArray<z.ZodObject<{
-        position: z.ZodNumber;
-        rate: z.ZodNumber;
-        in_tangent: z.ZodOptional<z.ZodObject<{
-          x: z.ZodNumber;
-          y: z.ZodNumber;
-        }, z.core.$strip>>;
-        out_tangent: z.ZodOptional<z.ZodObject<{
-          x: z.ZodNumber;
-          y: z.ZodNumber;
-        }, z.core.$strip>>;
-      }, z.core.$strip>>;
-    }, z.core.$strip>;
-  }, z.core.$strip>]>;
-}, z.core.$strip>;
-declare const voiceSchema: z.ZodObject<{
-  id: z.ZodString;
-  name: z.ZodString;
-}, z.core.$strip>;
-//#endregion
-//#region src/editor/schemas/speech-assets.d.ts
-/**
- * The materialized TTS result shared by `AddSpeeches` / `ChangeSpeechScript` /
- * `ChangeSpeechVoice` (see `results/phase-4-side-effect-payload-contract.md`
- * §1/§2). The side effect (TTS/ASR + billing) runs upstream; the op receives the
- * stable speech + caption parts and writes them as authoritative facts. No
- * cascade runs on write — the projection derives absolute positions on read.
- *
- * Each speech carries the anchoring fact directly (RFC 02 §4): the host video
- * clip `anchor_part_id` and the `offset_ms` within it. The upstream caller
- * already knows which clip a speech attaches to, so the op writes
- * `{ mode:'anchored', anchorPartId, offsetMs }` verbatim — no write-time
- * host-picking. Captions anchor to their speech via the caption part's
- * `start_ms` (offset within the speech).
- */
-declare const speechAssetSchema: z.ZodObject<{
-  speech_id: z.ZodString;
-  anchor_part_id: z.ZodString;
-  offset_ms: z.ZodNumber;
-  audio_storage_key: z.ZodString;
-  duration_ms: z.ZodNumber;
-  audio_script: z.ZodString;
-  volume: z.ZodNumber;
-  voice: z.ZodObject<{
-    id: z.ZodString;
-    name: z.ZodString;
-  }, z.core.$strip>;
-  origin_speech_id: z.ZodString;
-  caption_ids: z.ZodArray<z.ZodString>;
-}, z.core.$strip>;
-declare const captionAssetSchema: z.ZodObject<{
-  caption_id: z.ZodString;
-  speech_part_id: z.ZodString;
-  text: z.ZodString;
-  start_ms: z.ZodNumber;
-  duration_ms: z.ZodNumber;
-}, z.core.$strip>;
-/** A materialized speech-subtree write (speeches + their captions). */
-declare const speechAssetsSchema: z.ZodObject<{
-  speeches: z.ZodArray<z.ZodObject<{
-    speech_id: z.ZodString;
-    anchor_part_id: z.ZodString;
-    offset_ms: z.ZodNumber;
-    audio_storage_key: z.ZodString;
-    duration_ms: z.ZodNumber;
-    audio_script: z.ZodString;
-    volume: z.ZodNumber;
-    voice: z.ZodObject<{
-      id: z.ZodString;
-      name: z.ZodString;
-    }, z.core.$strip>;
-    origin_speech_id: z.ZodString;
-    caption_ids: z.ZodArray<z.ZodString>;
-  }, z.core.$strip>>;
-  captions: z.ZodArray<z.ZodObject<{
-    caption_id: z.ZodString;
-    speech_part_id: z.ZodString;
-    text: z.ZodString;
-    start_ms: z.ZodNumber;
-    duration_ms: z.ZodNumber;
-  }, z.core.$strip>>;
-}, z.core.$strip>;
-type SpeechAsset = z.infer<typeof speechAssetSchema>;
-type CaptionAsset = z.infer<typeof captionAssetSchema>;
-type SpeechAssets = z.infer<typeof speechAssetsSchema>;
-declare namespace index_d_exports {
-  export { AddSpeechesInput, AddVideoClipsInput, AdjustBgmVolumeInput, AdjustSpeechVolumeInput, AdjustVideoClipDurationInput, AdjustVideoClipVolumeInput, AnchoredDeletePolicy, AnchoredReplacePolicy, CaptionAsset, ChangeSpeechScriptInput, ChangeSpeechVoiceInput, DeleteBgmInput, DeleteSpeechesInput, DeleteVideoClipsInput, MoveAnchor, MoveSpeechesInput, MoveVideoClipsByAnchorInput, MoveVideoClipsInput, MovedClipAnchoredPolicy, ReplaceVideoClipContentInput, ReplaceVideoClipSequenceInput, SetBgmInput, SetCaptionStyleInput, SetCaptionVisibilityInput, SetVideoClipSpeedShiftInput, SpeechAsset, SpeechAssets, addSpeechesInputSchema, addVideoClipsInputSchema, adjustBgmVolumeInputSchema, adjustSpeechVolumeInputSchema, adjustVideoClipDurationInputSchema, adjustVideoClipVolumeInputSchema, anchoredDeletePolicySchema, anchoredReplacePolicySchema, changeSpeechScriptInputSchema, changeSpeechVoiceInputSchema, clipIdSchema, clipIdsSchema, deleteBgmInputSchema, deleteSpeechesInputSchema, deleteVideoClipsInputSchema, mediaIdSchema, moveAnchorSchema, moveSpeechesInputSchema, moveVideoClipsByAnchorInputSchema, moveVideoClipsInputSchema, movedClipAnchoredPolicySchema, positiveMsSchema, replaceVideoClipContentInputSchema, replaceVideoClipSequenceInputSchema, setBgmInputSchema, setCaptionStyleInputSchema, setCaptionVisibilityInputSchema, setVideoClipSpeedShiftInputSchema, speechAssetsSchema, speechIdSchema, speechIdsSchema, speedShiftSchema, timelineMsSchema, voiceSchema, volumeSchema };
-}
-//#endregion
-//#region src/editor/schema-validator.d.ts
-interface SnapshotReadable {
-  snapshot(): VideoDocument;
-}
-declare class ValidationError extends Error {
-  readonly code: string;
-  readonly context?: Record<string, unknown>;
-  constructor(code: string, message: string, context?: Record<string, unknown>);
-}
-declare class SchemaValidator {
-  validateMoveVideoClips(input: MoveVideoClipsInput, doc: SnapshotReadable): void;
-  /**
-   * The anchor must not be one of the clips being moved. Unlike the schema's
-   * mutual exclusions this needs the input read as a whole, so it stays here.
-   *
-   * Rejected rather than normalized: "put this block before itself" has no
-   * defensible outcome — treating it as a no-op hides a caller bug behind a
-   * success, and picking any surviving neighbour invents an intent. The legacy
-   * `applyBatchMoveVideoClips` omits this check (a self-anchor there silently
-   * lands the block at its own pre-move index); director's original move tool
-   * did enforce it (`_validate_position`: "不是被移动的clips"), and that is the
-   * behaviour worth keeping.
-   */
-  validateMoveVideoClipsByAnchor(input: MoveVideoClipsByAnchorInput, doc: SnapshotReadable): void;
-  validateDeleteVideoClips(input: DeleteVideoClipsInput, doc: SnapshotReadable): void;
-  validateAddVideoClips(input: AddVideoClipsInput, doc: SnapshotReadable): void;
-  validateAdjustVideoClipVolume(input: AdjustVideoClipVolumeInput, doc: SnapshotReadable): void;
-  validateSetVideoClipSpeedShift(input: SetVideoClipSpeedShiftInput, doc: SnapshotReadable): void;
-  validateReplaceVideoClipContent(input: ReplaceVideoClipContentInput, doc: SnapshotReadable): void;
-  /**
-   * `old_clip_ids` must name a **contiguous run of the main track, in track
-   * order**. A sparse or reordered selection is rejected rather than normalized:
-   * a sparse selection has no single stretch to swap, so the insert index, the
-   * positional speech remap, and the resulting order would each need a different
-   * arbitrary choice. Mirrors the agent tool's own contract ("must be a
-   * contiguous main-track sequence listed in timeline order").
-   */
-  validateReplaceVideoClipSequence(input: ReplaceVideoClipSequenceInput, doc: SnapshotReadable): void;
-  validateAdjustVideoClipDuration(input: AdjustVideoClipDurationInput, doc: SnapshotReadable): void;
-  validateAdjustSpeechVolume(input: AdjustSpeechVolumeInput, doc: SnapshotReadable): void;
-  validateAdjustBgmVolume(input: AdjustBgmVolumeInput, doc: SnapshotReadable): void;
-  validateAddSpeeches(input: AddSpeechesInput, doc: SnapshotReadable): void;
-  validateChangeSpeechScript(input: ChangeSpeechScriptInput, doc: SnapshotReadable): void;
-  validateChangeSpeechVoice(input: ChangeSpeechVoiceInput, doc: SnapshotReadable): void;
-  validateDeleteSpeeches(input: DeleteSpeechesInput, doc: SnapshotReadable): void;
-  validateMoveSpeeches(input: MoveSpeechesInput, doc: SnapshotReadable): void;
-  validateSetBgm(input: SetBgmInput, _doc: SnapshotReadable): void;
-  validateDeleteBgm(input: DeleteBgmInput, _doc: SnapshotReadable): void;
-  validateSetCaptionVisibility(input: SetCaptionVisibilityInput, _doc: SnapshotReadable): void;
-  validateSetCaptionStyle(input: SetCaptionStyleInput, _doc: SnapshotReadable): void;
-  private parse;
-  private mainTrackIds;
-  /** Every caption a speech declares in `caption_ids` must be supplied in `captions`. */
-  private assertCaptionsOwned;
-  /** Each regenerated speech (re-TTS) must already exist in the document. */
-  private assertSpeechesExist;
-  /**
-   * Each speech's `anchor_part_id` must point at a video clip that already
-   * exists. A relative speech anchored to a missing clip cannot be positioned
-   * by the projection and has no host to recover to (RFC 02 §4/§11.1), so the
-   * write must be rejected rather than landing a dangling reference. (Restores
-   * the dangling-reference guard the old `validateMaterializedPatch` carried;
-   * ADR 0009.)
-   */
-  private assertAnchorsExist;
-  private assertPartKind;
-}
-//#endregion
-//#region src/editor/types.d.ts
-/**
- * `SemanticOp` contract surface — the frozen catalogue of business write
- * operations the collaborative editor recognises.
- *
- * This is the single source of truth; `SemanticEditor` derives its method set
- * (`SemanticOpName`) from `ImplementedSemanticOpKind`, so adding a method
- * without listing it here (or vice versa) is a type error.
- *
- * Mapping of each kind to UI Operation / agent tool / side-effect routing is
- * maintained in
- * `docs/projects/medeo-integration/reference/operation-semantic-matrix.md`; the
- * frozen contract narrative lives in
- * `docs/projects/medeo-integration/results/phase-4-semantic-op-contract.md`.
- */
-/**
- * Operations implemented by `SemanticEditor`. FROZEN: each entry has a
- * `SemanticEditor` method, a narrow zod input schema (business intent +
- * materialized side-effect assets, never a document slice), and validation. The
- * editor runs the timeline-core cascade in-transaction to derive every position
- * (ADR 0009 — no caller-materialized layout).
- *
- * Effectful ops (TTS for `AddSpeeches` / `ChangeSpeechScript` /
- * `ChangeSpeechVoice`, media import for `ReplaceVideoClipContent`, BGM for
- * `SetBgm`) receive their stable side-effect result already materialized — the
- * editor only writes the document; it never performs the side effect. See the
- * side-effect payload contract in
- * `docs/projects/medeo-integration/results/phase-4-side-effect-payload-contract.md`.
- */
-type ImplementedSemanticOpKind = 'MoveVideoClips' | 'MoveVideoClipsByAnchor' | 'DeleteVideoClips' | 'AddVideoClips' | 'AdjustVideoClipVolume' | 'SetVideoClipSpeedShift' | 'ReplaceVideoClipContent' | 'ReplaceVideoClipSequence' | 'AdjustVideoClipDuration' | 'AddSpeeches' | 'DeleteSpeeches' | 'MoveSpeeches' | 'ChangeSpeechScript' | 'ChangeSpeechVoice' | 'AdjustSpeechVolume' | 'SetCaptionVisibility' | 'SetCaptionStyle' | 'SetBgm' | 'DeleteBgm' | 'AdjustBgmVolume';
-/**
- * Operations on the roadmap but NOT yet implemented by `SemanticEditor`. Empty:
- * Phase 4 covers every op with a real entry point. Kept as a named type so the
- * contract surface stays explicit and re-expanding the roadmap is a typed edit.
- * To re-add planned kinds, list them here and add them back to the
- * `SemanticOpKind` union below.
- */
-type PlannedSemanticOpKind = never;
-/**
- * Every SemanticOp kind. Currently equals `ImplementedSemanticOpKind` because
- * `PlannedSemanticOpKind` is empty; re-add `| PlannedSemanticOpKind` when the
- * roadmap is re-expanded.
- */
-type SemanticOpKind = ImplementedSemanticOpKind;
-/** Runtime list of the frozen, implemented kinds (for guards / introspection). */
-declare const IMPLEMENTED_SEMANTIC_OP_KINDS: readonly ImplementedSemanticOpKind[];
-declare function isImplementedSemanticOpKind(kind: string): kind is ImplementedSemanticOpKind;
-//#endregion
-//#region src/editor/semantic-editor.d.ts
-/**
- * Who authored an op, recorded in the commit message alongside `semantic_op`.
- *
- * Rides the Loro commit message rather than a wire field or a storage column,
- * for the same reason the semantic metadata does (`rfc/05 §5`): the message
- * travels inside the update bytes, so attribution cannot disagree with the ops
- * it describes, and it survives log truncation — a normal snapshot carries the
- * full history, so folding and deleting update rows keeps every Change's message
- * readable. A per-row column would lose the attribution at the first re-snapshot
- * and could only record one author per push, while one push may carry several
- * Changes.
- *
- * `role` deliberately mirrors the legacy `video_draft_op_records.operator_role`
- * enum (`'user' | 'agent'`) so the two engines answer "was this a person or the
- * agent" with the same vocabulary. It is declared rather than inferred from the
- * Loro peer id: peer ranges separate the writers today, but that is an audit aid
- * by convention, not an enforced fact, and peer ids are deliberately NOT derived
- * from identity (`PeerId != userid`, adr/0012).
- *
- * A deliberately narrow shape: no client/platform field. That is telemetry, and
- * document history is permanent and undeletable — the wrong place for it. Adding
- * one later costs nothing (the message is JSON; older Changes simply lack the
- * key), so the omission does not close the door.
- *
- * **Self-reported.** The client writes this and no server verifies it. The
- * authorization principal is the `medeo-user-id` header, which mengine-server
- * owner-checks; this field is the author, which it does not. The two hold the
- * same value today but answer different questions — see the harness's mengine
- * repository for why they are passed separately.
- */
-interface OpActor {
-  user_id: string;
-  role: 'user' | 'agent';
-}
-interface CommitOptions {
-  intent?: {
-    kind: string;
-    payload: unknown;
-  };
-  /** Author of this op; omitted for writes with no acting user (bootstrap, repair). */
-  actor?: OpActor;
-}
-type SemanticOpInput = MoveVideoClipsInput | MoveVideoClipsByAnchorInput | DeleteVideoClipsInput | AddVideoClipsInput | AdjustVideoClipVolumeInput | AdjustSpeechVolumeInput | AdjustBgmVolumeInput | SetVideoClipSpeedShiftInput | ReplaceVideoClipContentInput | ReplaceVideoClipSequenceInput | AdjustVideoClipDurationInput | AddSpeechesInput | DeleteSpeechesInput | MoveSpeechesInput | SetCaptionVisibilityInput | SetCaptionStyleInput | SetBgmInput | DeleteBgmInput;
-type SemanticOpName = ImplementedSemanticOpKind;
-/** Audit metadata committed alongside an op's writes. */
-interface TransactAudit {
-  kind: SemanticOpName;
-  payload: unknown;
-  intent?: unknown;
-  actor?: OpActor;
-}
-/**
- * Narrow write surface the `SemanticEditor` drives (ADR 0008 / 0009). It stays
- * off raw Loro: every op runs its document mutations inside a single `transact`
- * callback, which the storage adapter applies as one CRDT transaction + commit
- * carrying the audit message.
- *
- * The callback edits a `VideoDocumentDraft` — an immer draft of the whole
- * document state. A throw inside it discards the draft and never touches Loro,
- * so partial writes roll back naturally (no `commit`/`rollback` machinery). The
- * adapter's declarative diff turns the edited draft into minimal CRDT ops,
- * including real `move`s for reordered track items (keyed by `part_id`), so
- * per-item identity survives on every lane.
- *
- * Each op takes a narrow business input (intent + materialized side-effect
- * assets, never a document slice); the editor applies the authoritative facts
- * and runs the timeline-core cascade inside the callback to derive every
- * position. The caller never materializes a layout (ADR 0009).
- */
-interface SemanticDocumentAdapter extends SnapshotReadable {
-  /**
-   * Apply one op's domain mutation in a single synchronous transaction. `edit`
-   * must finish before returning; async callbacks/await are unsupported. The
-   * adapter diffs the resulting draft and commits once with `audit`.
-   * A throw in `edit` rolls back (the draft is discarded, Loro untouched). An
-   * edit that changes nothing produces no domain commit (no phantom undo step).
-   */
-  transact(edit: (draft: VideoDocumentDraft) => void, audit: TransactAudit): void;
-}
-declare class SemanticEditor {
-  private readonly doc;
-  private readonly validator;
-  constructor(doc: SemanticDocumentAdapter, validator?: SchemaValidator);
-  moveVideoClips(input: MoveVideoClipsInput, options?: CommitOptions): Promise<void>;
-  /**
-   * Reorder main-track clips relative to an anchor clip, moving them as one block.
-   *
-   * The ordinal sibling of `moveVideoClips`: main-track clips are
-   * `sequential`-positioned, so their order is the authoritative fact and absolute
-   * time is derived on read (RFC 02 §4/§7). A caller that already knows "put these
-   * after that one" should say so, instead of computing a timeline offset that this
-   * editor would only have to resolve back into an index.
-   *
-   * `on_anchored` decides the speech treatment and is required. Note the asymmetry
-   * in cost: `follow` writes nothing to the speeches (their `{ anchorPartId,
-   * offsetMs }` facts stay valid and the derived absolute time moves with the host),
-   * while `keep_absolute` runs the extra re-parent pass that preserves each
-   * speech's absolute landing. `moveVideoClips` is permanently `keep_absolute`,
-   * matching the FE timeline it serves.
-   */
-  moveVideoClipsByAnchor(input: MoveVideoClipsByAnchorInput, options?: CommitOptions): Promise<void>;
-  deleteVideoClips(input: DeleteVideoClipsInput, options?: CommitOptions): Promise<void>;
-  addVideoClips(input: AddVideoClipsInput, options?: CommitOptions): Promise<void>;
-  /**
-   * Swap a contiguous run of main-track clips for a new run, in one transaction.
-   *
-   * Composite by necessity, not convenience: with `on_anchored: 'remap'` each
-   * surviving speech is re-anchored to the new clip in the **same position of the
-   * sequence** (old[i] → new[i]), which needs both id sets live at once. Splitting
-   * it into `deleteVideoClips` + `addVideoClips` would leave the caller holding the
-   * anchor re-wiring — the cascade-in-the-caller mistake ADR 0009 retires.
-   *
-   * Positional pairing, not by count: when there are fewer new clips than old, the
-   * unmatched old clips have no counterpart, so their anchored subtrees are deleted
-   * (there is nothing to anchor to). When there are more new clips than old, the
-   * extra ones simply arrive with no children.
-   *
-   * The new clips are inserted where the run started, so surrounding order is
-   * preserved. Every position is derived on read (RFC 02 §7) — this writes only the
-   * facts: track order, the trim windows, and the surviving anchors.
-   */
-  replaceVideoClipSequence(input: ReplaceVideoClipSequenceInput, options?: CommitOptions): Promise<void>;
-  adjustVideoClipVolume(input: AdjustVideoClipVolumeInput, options?: CommitOptions): Promise<void>;
-  setVideoClipSpeedShift(input: SetVideoClipSpeedShiftInput, options?: CommitOptions): Promise<void>;
-  adjustSpeechVolume(input: AdjustSpeechVolumeInput, options?: CommitOptions): Promise<void>;
-  adjustBgmVolume(input: AdjustBgmVolumeInput, options?: CommitOptions): Promise<void>;
-  /**
-   * Replace the media backing existing video clips. The new media's stable
-   * result (new media id, intrinsic length, reset trim window) is materialized
-   * upstream; the clip ids and their track items are unchanged. Only the part
-   * facts change — effective duration and downstream positions are derived by
-   * the projection on read.
-   */
-  replaceVideoClipContent(input: ReplaceVideoClipContentInput, options?: CommitOptions): Promise<void>;
-  /**
-   * Re-trim clips. Only the `play_in` / `play_out` facts change; the new
-   * effective duration and the resulting downstream reflow are derived by the
-   * projection on read (anchored speeches follow their host clip automatically).
-   */
-  adjustVideoClipDuration(input: AdjustVideoClipDurationInput, options?: CommitOptions): Promise<void>;
-  /**
-   * Add speeches (and their captions). TTS runs upstream; the materialized
-   * speech / caption parts arrive in `input`, each carrying its host clip
-   * `anchor_part_id` + `offset_ms`. The editor writes the parts and their
-   * `anchored` `time_position` facts verbatim — no write-time host-picking, no
-   * cascade. The projection derives absolute positions on read.
-   */
-  addSpeeches(input: AddSpeechesInput, options?: CommitOptions): Promise<void>;
-  /** Delete speeches with their captions; the subtree is removed (§9.2). Surviving lanes keep their facts. */
-  deleteSpeeches(input: DeleteSpeechesInput, options?: CommitOptions): Promise<void>;
-  /**
-   * Move speeches in time (§9.1). One forward positioning pass: anchor each
-   * speech to the main-track clip its new absolute start lands in and write the
-   * resulting `anchored` `time_position` fact. No cascade — the projection
-   * derives absolute positions on read.
-   */
-  moveSpeeches(input: MoveSpeechesInput, options?: CommitOptions): Promise<void>;
-  /** Change a speech's script. Re-TTS runs upstream; the regenerated parts arrive materialized (no cascade). */
-  changeSpeechScript(input: ChangeSpeechScriptInput, options?: CommitOptions): Promise<void>;
-  /** Change a speech's voice. Re-TTS runs upstream; the regenerated parts arrive materialized (no cascade). */
-  changeSpeechVoice(input: ChangeSpeechVoiceInput, options?: CommitOptions): Promise<void>;
-  /**
-   * Set the document BGM. The media's stable result arrives materialized.
-   *
-   * KNOWN GAP (non-blocking, FE callers only): a public-library BGM also needs
-   * project-level media ownership registered, or it plays but never appears in
-   * the project's media library. This editor deliberately does not do it — the
-   * document edit is complete and correct, and ownership is a side effect owned
-   * by whoever holds the authoritative media data (memota), not by a CRDT write.
-   *
-   * Who is affected, as of 2026-08-13: the agent harness registers it on BOTH
-   * its legacy and mengine paths (shared `resolveMutation` calls memota
-   * `attachMedia` directly), and FE's legacy REST path gets it from Director.
-   * Only FE's mengine path is missing it. FE cannot call memota directly:
-   * `attachMedia` is exposed on memota's internal contract only, so the fix is a
-   * Director proxy route — NOT a new Director business endpoint, since Director
-   * stopped owning media ownership entirely (`a2951355`, 2026-08-05).
-   *
-   * Tracked as a Phase 7 gate (it must land before "new documents default to
-   * mengine" makes public-library BGM a routine operation). See
-   * `docs/projects/medeo-integration/results/phase-6-m4-legacy-refresh-isolation.md`.
-   */
-  setBgm(input: SetBgmInput, options?: CommitOptions): Promise<void>;
-  /** Remove the document BGM; clears the bgm lane and removes the part. */
-  deleteBgm(input: DeleteBgmInput, options?: CommitOptions): Promise<void>;
-  /** Toggle caption visibility (caption track `is_hidden`). */
-  setCaptionVisibility(input: SetCaptionVisibilityInput, options?: CommitOptions): Promise<void>;
-  /**
-   * Set the document-wide caption style. GLOBAL (no `caption_id`): the patch is
-   * merged onto EVERY caption part's `style`, mirroring the FE, which applies a
-   * single style to all captions (`caption-style.ts:persistCaptionStylePatch`).
-   *
-   * Merge, not replace: only the fields present in the input overwrite the
-   * caption's existing style; absent fields are carried forward. So a partial
-   * patch ("recolor only") keeps the caption's font size. Pure document edit, no
-   * cascade — positions are untouched.
-   */
-  setCaptionStyle(input: SetCaptionStyleInput, options?: CommitOptions): Promise<void>;
-  /**
-   * Resolve the main-track sequential layout from `source`. Callers inside a
-   * `transact` MUST pass the live `draft` so item order reflects in-progress
-   * mutations; the default `this.doc.snapshot()` is only committed state and is
-   * correct for read-only callers outside a transaction. `readMainTrackItems` /
-   * `readPartDurationMs` accept both an immer draft and a raw snapshot.
-   */
-  private computeMainTrackLayout;
-  private indexForStartMs;
-  private computeAddInsertIndex;
-}
-//#endregion
-//#region src/document/document-mutation-guard.d.ts
-/**
- * @internal
- * Shared by synchronous mutation entry points for one document. The session
- * closes it before teardown callbacks can attempt another write.
- */
-declare class DocumentMutationGuard {
-  private running;
-  private closed;
-  run<T>(mutation: () => T): T;
-  close(): void;
-}
-//#endregion
-//#region src/document/mirror-adapter.d.ts
-interface MirrorVideoDocumentOptions {
-  peerId?: PeerID;
-  origin?: string;
-}
-/**
- * Storage-layer adapter that backs a `VideoDocument` with `loro-mirror` (ADR
- * 0008). The mirror holds an in-memory immutable state synced to the `LoroDoc`
- * by declarative diff, replacing the hand-rolled `@mengine/schema` adapter:
- *
- * - `snapshot()` projects the mirror's in-memory state to the read model — no
- *   per-call `toJSON()` FFI rebuild.
- * - `transact(edit, audit)` runs the whole op in one `mirror.setState` callback:
- *   one diff, one `doc.commit` carrying the audit message. The callback edits an
- *   immer draft, so a throw inside it discards the draft and never touches Loro
- *   (natural rollback) without a document checkout or compensating commit.
- * - mirror's `idSelector` (track items keyed by `part_id`) diffs reorders to
- *   real Loro `move` ops on every lane, so per-item CRDT identity survives on
- *   main and secondary tracks alike.
- */
-declare class MirrorVideoDocumentAdapter implements SemanticDocumentAdapter {
-  readonly doc: LoroDoc;
-  private readonly mutationGuard;
-  private readonly mirror;
-  private disposed;
-  constructor(doc: LoroDoc, mutationGuard?: DocumentMutationGuard);
-  snapshot(): VideoDocument;
-  /**
-   * Release mirror subscriptions; do not reuse this adapter afterwards.
-   * The caller still owns the borrowed LoroDoc.
-   */
-  dispose(): void;
-  /**
-   * Apply one op as a single transaction. `edit` mutates the immer draft; mirror
-   * diffs the result and commits once with the audit `message`. A throw in `edit`
-   * discards the draft (Loro untouched). When `edit` produces no change, mirror
-   * skips the commit — matching the prior "empty op leaves no audit" behavior.
-   */
-  transact(edit: (draft: VideoDocumentDraft) => void, audit: TransactAudit): void;
-  private assertActive;
-}
-/** Build a fresh Loro doc seeded with `document` through the mirror. */
-declare function createMirrorVideoDocument(document: VideoDocument, options?: MirrorVideoDocumentOptions): LoroDoc;
-/** Build a `MirrorVideoDocumentAdapter` over a fresh doc seeded with `document`. */
-declare function createMirrorVideoDocumentAdapter(document: VideoDocument, options?: MirrorVideoDocumentOptions): MirrorVideoDocumentAdapter;
-//#endregion
-//#region src/document/mirror-read.d.ts
-/**
- * Project the mirror state (`VideoDocumentDraft`) into the authoritative
- * `VideoDocument`. The storage shape is isomorphic to the domain shape (RFC 03
- * §4, reference/17 §4: timeline + a single `tracks` list + part_library), so this
- * is a near-identity — it reads `time_position` / `fallback_abs_ms` JSON blobs
- * back into structured values and selects content fields. Legacy meta is ignored.
- *
- * It maps only authoritative facts (RFC 02 §6): `part_id` + `time_position`. The
- * projection-derived `VideoDraft` read-view (absolute time, `part_aggregations`,
- * total duration) is solved separately by the cascade, not here.
- *
- * It reads in-memory mirror state (O(n) over the document), not a Loro
- * `toJSON()` FFI rebuild — the cost the prior schema adapter paid on every
- * `snapshot()`.
- */
-declare function readVideoDocumentFromDraft(draft: VideoDocumentDraft): VideoDocument;
-//#endregion
-//#region src/document/zod-schema.d.ts
-declare const partUnionSchema: z.ZodUnion<readonly [z.ZodObject<{
-  video_clip: z.ZodObject<{
-    id: z.ZodOptional<z.ZodString>;
-    kind: z.ZodLiteral<"video_clip">;
-    duration_ms: z.ZodOptional<z.ZodNumber>;
-    play_in: z.ZodNumber;
-    play_out: z.ZodNumber;
-    volume: z.ZodNumber;
-    origin_media_id: z.ZodString;
-    speed_shift: z.ZodOptional<z.ZodObject<{
-      category: z.ZodOptional<z.ZodString>;
-      mode: z.ZodOptional<z.ZodString>;
-      config: z.ZodOptional<z.ZodObject<{
-        linear: z.ZodOptional<z.ZodObject<{
-          speed: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$loose>>;
-      }, z.core.$loose>>;
-    }, z.core.$loose>>;
-  }, z.core.$loose>;
-}, z.core.$loose>, z.ZodObject<{
-  speech: z.ZodObject<{
-    id: z.ZodOptional<z.ZodString>;
-    kind: z.ZodLiteral<"speech">;
-    media_duration_ms: z.ZodNumber;
-    duration_ms: z.ZodOptional<z.ZodNumber>;
-    audio_script: z.ZodString;
-    volume: z.ZodNumber;
-    audio_storage_key: z.ZodString;
-    origin_speech_id: z.ZodString;
-    voice: z.ZodUnknown;
-    caption_ids: z.ZodArray<z.ZodString>;
-  }, z.core.$loose>;
-}, z.core.$loose>, z.ZodObject<{
-  caption: z.ZodObject<{
-    id: z.ZodOptional<z.ZodString>;
-    kind: z.ZodLiteral<"caption">;
-    initial_duration_ms: z.ZodNumber;
-    speech_part_id: z.ZodString;
-    text: z.ZodString;
-    start_ms: z.ZodNumber;
-    style: z.ZodOptional<z.ZodObject<{
-      font_id: z.ZodOptional<z.ZodString>;
-      font_size: z.ZodOptional<z.ZodNumber>;
-      font_color: z.ZodOptional<z.ZodString>;
-      font_weight: z.ZodOptional<z.ZodNumber>;
-      entrance_animation: z.ZodOptional<z.ZodString>;
-      entrance_animation_duration_ms: z.ZodOptional<z.ZodNumber>;
-      stroke_color: z.ZodOptional<z.ZodString>;
-      stroke_width: z.ZodOptional<z.ZodNumber>;
-      position_x: z.ZodOptional<z.ZodNumber>;
-      position_y: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$loose>>;
-  }, z.core.$loose>;
-}, z.core.$loose>, z.ZodObject<{
-  bgm: z.ZodObject<{
-    id: z.ZodOptional<z.ZodString>;
-    kind: z.ZodLiteral<"bgm">;
-    audio_storage_key: z.ZodString;
-    volume: z.ZodNumber;
-    origin_media_id: z.ZodString;
-  }, z.core.$loose>;
-}, z.core.$loose>]>;
-declare const videoDocumentSchema: z.ZodObject<{
-  timeline: z.ZodOptional<z.ZodObject<{
-    unit_time_ms: z.ZodOptional<z.ZodNumber>;
-  }, z.core.$loose>>;
-  tracks: z.ZodOptional<z.ZodArray<z.ZodObject<{
-    id: z.ZodOptional<z.ZodString>;
-    parts_kind: z.ZodOptional<z.ZodEnum<{
-      bgm: "bgm";
-      caption: "caption";
-      speech: "speech";
-      video_clip: "video_clip";
-    }>>;
-    is_hidden: z.ZodOptional<z.ZodBoolean>;
-    items: z.ZodOptional<z.ZodArray<z.ZodObject<{
-      part_id: z.ZodString;
-      time_position: z.ZodDiscriminatedUnion<[z.ZodObject<{
-        mode: z.ZodLiteral<"sequential">;
-      }, z.core.$loose>, z.ZodObject<{
-        mode: z.ZodLiteral<"anchored">;
-        anchorPartId: z.ZodString;
-        offsetMs: z.ZodNumber;
-      }, z.core.$loose>, z.ZodObject<{
-        mode: z.ZodLiteral<"absolute">;
-        offsetMs: z.ZodNumber;
-      }, z.core.$loose>], "mode">;
-      fallback_abs_ms: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$loose>>>;
-  }, z.core.$loose>>>;
-  part_library: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
-    video_clip: z.ZodObject<{
-      id: z.ZodOptional<z.ZodString>;
-      kind: z.ZodLiteral<"video_clip">;
-      duration_ms: z.ZodOptional<z.ZodNumber>;
-      play_in: z.ZodNumber;
-      play_out: z.ZodNumber;
-      volume: z.ZodNumber;
-      origin_media_id: z.ZodString;
-      speed_shift: z.ZodOptional<z.ZodObject<{
-        category: z.ZodOptional<z.ZodString>;
-        mode: z.ZodOptional<z.ZodString>;
-        config: z.ZodOptional<z.ZodObject<{
-          linear: z.ZodOptional<z.ZodObject<{
-            speed: z.ZodOptional<z.ZodNumber>;
-          }, z.core.$loose>>;
-        }, z.core.$loose>>;
-      }, z.core.$loose>>;
-    }, z.core.$loose>;
-  }, z.core.$loose>, z.ZodObject<{
-    speech: z.ZodObject<{
-      id: z.ZodOptional<z.ZodString>;
-      kind: z.ZodLiteral<"speech">;
-      media_duration_ms: z.ZodNumber;
-      duration_ms: z.ZodOptional<z.ZodNumber>;
-      audio_script: z.ZodString;
-      volume: z.ZodNumber;
-      audio_storage_key: z.ZodString;
-      origin_speech_id: z.ZodString;
-      voice: z.ZodUnknown;
-      caption_ids: z.ZodArray<z.ZodString>;
-    }, z.core.$loose>;
-  }, z.core.$loose>, z.ZodObject<{
-    caption: z.ZodObject<{
-      id: z.ZodOptional<z.ZodString>;
-      kind: z.ZodLiteral<"caption">;
-      initial_duration_ms: z.ZodNumber;
-      speech_part_id: z.ZodString;
-      text: z.ZodString;
-      start_ms: z.ZodNumber;
-      style: z.ZodOptional<z.ZodObject<{
-        font_id: z.ZodOptional<z.ZodString>;
-        font_size: z.ZodOptional<z.ZodNumber>;
-        font_color: z.ZodOptional<z.ZodString>;
-        font_weight: z.ZodOptional<z.ZodNumber>;
-        entrance_animation: z.ZodOptional<z.ZodString>;
-        entrance_animation_duration_ms: z.ZodOptional<z.ZodNumber>;
-        stroke_color: z.ZodOptional<z.ZodString>;
-        stroke_width: z.ZodOptional<z.ZodNumber>;
-        position_x: z.ZodOptional<z.ZodNumber>;
-        position_y: z.ZodOptional<z.ZodNumber>;
-      }, z.core.$loose>>;
-    }, z.core.$loose>;
-  }, z.core.$loose>, z.ZodObject<{
-    bgm: z.ZodObject<{
-      id: z.ZodOptional<z.ZodString>;
-      kind: z.ZodLiteral<"bgm">;
-      audio_storage_key: z.ZodString;
-      volume: z.ZodNumber;
-      origin_media_id: z.ZodString;
-    }, z.core.$loose>;
-  }, z.core.$loose>]>>>;
-}, z.core.$loose>;
-//#endregion
-export { VideoDraft as $, assertValidVideoDocument as A, CaptionPart as B, index_d_exports as C, VideoDocumentMirrorSchema as D, VideoDocumentDraft as E, buildSpeechHostMap as F, Timeline as G, PartKind as H, derivePositionFromAbs as I, TrackItemTimePosition as J, Track as K, fromVideoDocument as L, buildInitialVideoDocument as M, DerivedItemPosition as N, videoDocumentMirrorSchema as O, SpeechHostMap as P, VideoDocumentValidationIssueCode as Q, toVideoDocument as R, ValidationError as S, TrackItemDraft as T, PartUnion as U, DEFAULT_UNIT_TIME_MS as V, SpeechPart as W, VideoDocument as X, VideoClipPart as Y, VideoDocumentValidationIssue as Z, PlannedSemanticOpKind as _, MirrorVideoDocumentOptions as a, PartAggregation as at, SchemaValidator as b, CommitOptions as c, Track$1 as ct, SemanticEditor as d, VideoDraftContent as et, SemanticOpInput as f, ImplementedSemanticOpKind as g, IMPLEMENTED_SEMANTIC_OP_KINDS as h, MirrorVideoDocumentAdapter as i, CaptionStyle as it, validateVideoDocument as j, VideoDocumentValidationError as k, OpActor as l, TrackItem$1 as lt, TransactAudit as m, videoDocumentSchema as n, Attachment as nt, createMirrorVideoDocument as o, SpeedShift as ot, SemanticOpName as p, TrackItem as q, readVideoDocumentFromDraft as r, CaptionPart$1 as rt, createMirrorVideoDocumentAdapter as s, Timeline$1 as st, partUnionSchema as t, VideoDraftPartUnion as tt, SemanticDocumentAdapter as u, SemanticOpKind as v, TrackDraft as w, SnapshotReadable as x, isImplementedSemanticOpKind as y, BgmPart as z };