@blitzreels/sdk 0.1.3 → 0.1.5

package/dist/index.d.ts

@@ -1,3 +1,6 @@
+import { type AiEditResource } from "./resources/ai-edit.js";
+import { type CaptionsResource } from "./resources/captions.js";
+import { type TimelineResource } from "./resources/timeline.js";
 export type HttpMethod = "GET" | "POST" | "PATCH" | "DELETE";
 export type JsonObject = Record<string, unknown>;
 export type QueryValue = string | number | boolean | null | undefined;
@@ -20,11 +23,16 @@ export type BlitzReelsErrorOptions = {
     status: number;
     requestId: string | null;
     body: unknown;
+    code?: BlitzReelsErrorCode;
+    retryable?: boolean;
 };
+export type BlitzReelsErrorCode = "api_error" | "auth_error" | "not_found" | "conflict" | "validation_error" | "rate_limited" | "timeout" | "server_error";
 export declare class BlitzReelsError extends Error {
     status: number;
     requestId: string | null;
     body: unknown;
+    code: BlitzReelsErrorCode;
+    retryable: boolean;
     constructor(options: BlitzReelsErrorOptions);
 }
 export type AuthValidation = {
@@ -43,9 +51,22 @@ export type AuthValidation = {
     };
 };
 export type ProjectContextMode = "summary" | "assets" | "timeline" | "transcript" | "full";
+export type ProjectContextCollectionBounds = {
+    name: string;
+    offset: number;
+    limit: number;
+    total: number;
+    returned: number;
+    hasMore: boolean;
+    truncated: boolean;
+};
+export type ProjectContextBounds = {
+    collections: ProjectContextCollectionBounds[];
+};
 export type ProjectContext = {
     mode: ProjectContextMode;
     data: unknown;
+    bounds: ProjectContextBounds;
 };
 export type Project = {
     id: string;
@@ -170,6 +191,8 @@ export type MediaAttachResult = {
         timeline_item_id: string | null;
         message: string | null;
         animation_applied: string | null;
+        layer_index: number | null;
+        warnings?: string[];
     }>;
     summary: {
         total: number;
@@ -177,8 +200,92 @@ export type MediaAttachResult = {
         already_in_timeline: number;
         failed: number;
     };
+    warnings?: string[];
     message: string;
 };
+export type MediaShortSuggestionList = {
+    saved: JsonObject[];
+    drafts: JsonObject[];
+};
+export type GenerateMediaShortSuggestionsOptions = {
+    assetId: string;
+    contentProfile: "auto" | "podcast" | "tutorial" | "generic" | undefined;
+    autoTrimSilence: boolean | undefined;
+};
+export type ApplyMediaShortSuggestionOptions = {
+    assetId: string;
+    suggestionId: string;
+    projectId: string;
+    captionStyleId: string | null | undefined;
+    markSaved: boolean | undefined;
+    allowUnverifiedExport: boolean | undefined;
+    automaticLayout: JsonObject | undefined;
+};
+export type ApplyMediaShortSuggestionResult = {
+    success: boolean;
+    project_id: string;
+    asset_id: string;
+    suggestion_id: string;
+    timeline_item_id: string;
+    [key: string]: unknown;
+};
+export type ClipSelectionMode = "auto_best" | "suggestion" | "time_range";
+export type ClipLayoutMode = "auto" | "prefer_split" | "prefer_focus";
+export type ClipContentTypeHint = "auto" | "podcast" | "tutorial" | "generic";
+export type ClipQaMode = "required" | "permissive";
+export type ClipTargetOptions = {
+    minDurationSeconds: number | null | undefined;
+    maxDurationSeconds: number;
+};
+export type CreateClipOptions = {
+    projectName: string | null | undefined;
+    source: {
+        sourceType: "asset" | "youtube";
+        assetId: string | null | undefined;
+        youtubeUrl: string | null | undefined;
+    };
+    selection: {
+        mode: ClipSelectionMode;
+        suggestionId: string | null | undefined;
+        startSeconds: number | null | undefined;
+        endSeconds: number | null | undefined;
+    };
+    target: ClipTargetOptions & {
+        aspectRatio: "9:16";
+    };
+    layout: {
+        mode: ClipLayoutMode;
+        contentTypeHint: ClipContentTypeHint | undefined;
+    };
+    captions: {
+        enabled: boolean;
+        styleId: string | null | undefined;
+    };
+    qa: {
+        mode: ClipQaMode;
+    };
+    export: {
+        autoExport: boolean;
+    };
+};
+export type ReselectClipOptions = {
+    clipId: string;
+    selection: CreateClipOptions["selection"];
+    target: ClipTargetOptions | null | undefined;
+};
+export type RepairClipOptions = {
+    clipId: string;
+    repairMode: "auto" | "prefer_split" | "prefer_focus" | "prefer_tutorial" | "move_captions_off_faces";
+};
+export type ExportClipOptions = {
+    clipId: string;
+    resolution: "720p" | "1080p";
+    format: "mp4" | "mov";
+    allowBlockingQaBypass: boolean;
+};
+export type ClipEnvelope = {
+    clip: JsonObject;
+};
 export type MediaAssetDetails = {
     asset: {
         id: string;
@@ -192,6 +299,26 @@ export type MediaAssetDetails = {
         aiMood: string | null;
         aiCameraMovement: string | null;
         fileSizeBytes: number;
+        processingStatus: string | null | undefined;
+        processingSubstage: string | null;
+        processingError: string | null;
+        processingErrors: JsonObject;
+        processingAttempts: number | null;
+        retryable: boolean;
+        providerRequestIds: {
+            processJobRunId: string | null;
+            transcribeJobRunId: string | null;
+            providerRequestId: string | null;
+        };
+        processing_substage: string | null;
+        processing_error: string | null;
+        processing_errors: JsonObject;
+        processing_attempts: number | null;
+        provider_request_ids: {
+            process_job_run_id: string | null;
+            transcribe_job_run_id: string | null;
+            provider_request_id: string | null;
+        };
         durationSeconds: number | null;
         dimensionsWidth: number | null;
         dimensionsHeight: number | null;
@@ -257,6 +384,24 @@ export type InsertAudioResult = {
     };
     txid: number | null;
 };
+export type UpdateAudioResult = {
+    success: boolean;
+    timeline_item_id: string;
+    duration_seconds: number;
+    volume: number;
+    fade_in_seconds: number;
+    fade_out_seconds: number;
+    txid: number | null;
+};
+export type UpdateMediaOverlayResult = {
+    success: boolean;
+    timelineItemId: string;
+    updated: JsonObject;
+    animationApplied: string | null;
+    keyframeCount: number;
+    warnings?: string[];
+    message: string;
+};
 export type TimelineEditResult = {
     action: string;
     result: unknown;
@@ -281,6 +426,51 @@ export type TimelineDeleteOptions = {
     timelineItemIds: string[];
     autoPack: boolean | undefined;
 };
+export type TimelineSplitOptions = {
+    projectId: string;
+    timelineItemId: string;
+    splitAtSeconds: number;
+    snapToFrame: boolean | undefined;
+};
+export type TimelineTrimOptions = {
+    projectId: string;
+    timelineItemId: string;
+    trimStartDeltaSeconds: number | undefined;
+    trimEndDeltaSeconds: number | undefined;
+    snapToFrame: boolean | undefined;
+};
+export type TimelineBatchMoveOptions = {
+    projectId: string;
+    items: Array<{
+        timelineItemId: string;
+        newStartSeconds: number;
+        newLayerIndex: number | undefined;
+    }>;
+};
+export type TimelineBatchTrimOptions = {
+    projectId: string;
+    items: Array<{
+        timelineItemId: string;
+        trimStartDeltaSeconds: number | undefined;
+        trimEndDeltaSeconds: number | undefined;
+    }>;
+    snapToFrame: boolean | undefined;
+};
+export type TimelineBatchTransformOptions = {
+    projectId: string;
+    items: Array<Omit<TimelineTransformOptions, "projectId">>;
+};
+export type TimelineCutOptions = {
+    projectId: string;
+    timelineItemId: string;
+    cuts: Array<{
+        startSeconds: number;
+        endSeconds: number;
+        trimFollowingSeconds: number | undefined;
+    }>;
+    snapToFrame: boolean | undefined;
+    ripple: boolean | undefined;
+};
 export type TimelineItemDeleteResult = {
     success: boolean;
     deleted_item_id: string;
@@ -312,6 +502,7 @@ export type CaptionWordBatchTextResult = {
 export type CaptionWordCountResult = {
     success: boolean;
     updated_count: number;
+    updated_word_ids: string[] | undefined;
     emphasis: boolean | undefined;
     message: string | undefined;
 };
@@ -325,10 +516,54 @@ export type CaptionWordMutationResult = {
     words: JsonObject[];
     message: string;
 };
+export type CaptionTrackSelectorOptions = {
+    projectId: string;
+    all: boolean | undefined;
+    captionId: string | undefined;
+    timelineItemId: string | undefined;
+    fromSeconds: number | undefined;
+    toSeconds: number | undefined;
+};
+export type CaptionTrackMutationResult = {
+    success: boolean;
+    action: "delete" | "hide" | "show";
+    affected_count: number;
+    caption_ids: string[];
+    timeline_item_ids: string[];
+    message: string;
+};
 export type CaptionThemeList = {
     themes: JsonObject[];
     total: number;
 };
+export type CaptionTheme = JsonObject;
+export type CaptionPresetList = {
+    presets: JsonObject[];
+    total: number;
+};
+export type CaptionLookList = {
+    looks: JsonObject[];
+    total: number;
+};
+export type CaptionStyle = {
+    success: boolean;
+    settings: JsonObject;
+    hint: string | undefined;
+};
+export type UpdateCaptionStyleOptions = {
+    projectId: string;
+    lookId: string | undefined;
+    presetId: string | undefined;
+    clearWordOverrides: boolean | undefined;
+    style: JsonObject;
+};
+export type CaptionStyleUpdateResult = {
+    success: boolean;
+    updated_properties: string[];
+    look_id: string | null | undefined;
+    preset_id: string | null | undefined;
+    message: string | undefined;
+};
 export type CaptionThemePreview = {
     preview_url: string;
     expires_at: string;
@@ -340,12 +575,198 @@ export type ExportStartResult = {
     job_id: string;
     status: string;
 };
+export type AiEditStyleId = "mirage-black" | "clean-founder";
+export type AiEditQualityTarget = "fast" | "premium" | "frontier";
+export type AiEditControllerKind = "api" | "cli" | "codex" | "claude_code" | "platform" | "unknown";
+export type AiEditRunStatus = "queued" | "understanding" | "planning" | "applying" | "rendering" | "critiquing" | "repairing" | "completed" | "failed" | "needs_review";
+export type AiEditStylesList = {
+    styles: Array<{
+        id: AiEditStyleId;
+        name: string;
+        description: string;
+        preview_image_path: string;
+        manual_skill: {
+            type: "local_skill";
+            path: string;
+            style_json_path: string;
+        };
+        spec: JsonObject;
+    }>;
+    total: number;
+};
+export type AiEditRunEnvelope = {
+    run: {
+        id: string;
+        project_id: string;
+        organization_id: string;
+        user_id: string;
+        api_key_id: string | null;
+        execution_mode: "external_controller" | "hosted_agent";
+        credit_mode: "external" | "platform_credits" | "byok";
+        controller_kind: AiEditControllerKind;
+        status: AiEditRunStatus;
+        style_id: AiEditStyleId;
+        quality_target: AiEditQualityTarget;
+        run_config: JsonObject;
+        budget_receipt: JsonObject;
+        summary: string | null;
+        failure_message: string | null;
+        completed_at: string | null;
+        created_at: string;
+        updated_at: string;
+    };
+    context: JsonObject;
+};
+export type AiEditRunLog = {
+    id: string;
+    run_id: string;
+    organization_id: string;
+    project_id: string;
+    kind: string;
+    status: string;
+    input: JsonObject;
+    output: JsonObject;
+    error_message: string | null;
+    created_at: string;
+};
+export type AiEditRunArtifact = {
+    id: string;
+    run_id: string;
+    organization_id: string;
+    project_id: string;
+    artifact_type: string;
+    time_seconds: number | null;
+    url: string | null;
+    storage_key: string | null;
+    metadata: JsonObject;
+    created_at: string;
+};
+export type AiEditRunLogsOptions = {
+    runId: string;
+    limit: number | undefined;
+    offset: number | undefined;
+};
+export type AiEditRunLogsEnvelope = {
+    run_id: string;
+    project_id: string;
+    logs: AiEditRunLog[];
+    artifacts: AiEditRunArtifact[];
+    bounds: {
+        logs: {
+            offset: number;
+            limit: number;
+            returned: number;
+            truncated: boolean;
+        };
+    };
+};
+export type AiEditAppendRunLogOptions = {
+    runId: string;
+    kind: string;
+    status: "queued" | "running" | "completed" | "failed" | "skipped";
+    message: string;
+    metadata: JsonObject;
+    dryRun: boolean | undefined;
+};
+export type AiEditAppendRunLogResult = {
+    success: true;
+    dry_run: boolean;
+    run_id: string;
+    log: AiEditRunLog | null;
+};
+export type AiEditCreateRunOptions = {
+    projectId: string;
+    styleId: AiEditStyleId;
+    qualityTarget: AiEditQualityTarget | undefined;
+    controllerKind: AiEditControllerKind | undefined;
+    dryRun: boolean | undefined;
+};
+export type AiEditApplyStyleOptions = {
+    runId: string;
+    dryRun: boolean | undefined;
+    titleText: string | null | undefined;
+};
+export type AiEditApplyStyleResult = {
+    success: true;
+    dry_run: boolean;
+    run_id: string;
+    project_id: string;
+    style_id: AiEditStyleId;
+    receipts: Array<{
+        action: string;
+        target_id: string;
+        dry_run: boolean;
+        changes: JsonObject;
+    }>;
+    txid: number | null;
+};
+export type AiEditSnapshotTime = "start" | "hook" | "middle" | "end";
+export type AiEditRenderSnapshotsOptions = {
+    runId: string;
+    dryRun: boolean | undefined;
+    times: Array<number | AiEditSnapshotTime> | undefined;
+    targetWidth: number | undefined;
+    imageFormat: "jpeg" | "png" | undefined;
+};
+export type AiEditSnapshotsResult = {
+    success: true;
+    dry_run: boolean;
+    run_id: string;
+    project_id: string;
+    snapshots: Array<{
+        artifact_id: string | null;
+        preview_url: string | null;
+        storage_key: string | null;
+        frame: number | null;
+        time_seconds: number;
+        width: number | null;
+        height: number | null;
+        image_format: "jpeg" | "png";
+    }>;
+};
+export type AiEditValidateOptions = {
+    runId: string;
+    dryRun: boolean | undefined;
+};
+export type AiEditValidationResult = {
+    success: true;
+    dry_run: boolean;
+    run_id: string;
+    project_id: string;
+    passed: boolean;
+    checks: Array<{
+        rule: string;
+        passed: boolean;
+        message: string;
+    }>;
+};
+export type AiEditCompleteOptions = {
+    runId: string;
+    status: "completed" | "needs_review" | "failed";
+    summary: string;
+    dryRun: boolean | undefined;
+};
+export type AiEditCompleteResult = {
+    success: true;
+    dry_run: boolean;
+    run_id: string;
+    status: "completed" | "needs_review" | "failed";
+    summary: string;
+};
 export type ExportStatus = {
     export_id: string;
     status: string;
     download_url: string | null;
     short_download_url: string | null;
     thumbnail_url: string | null;
+    thumbnail: {
+        url: string | null;
+        frame: number | null;
+        frame_seconds: number | null;
+        selection_mode: string | null;
+        rationale: string | null;
+    } | null;
+    platform_metadata: JsonObject | null;
     expires_at: string | null;
     file_size_bytes: number | null;
     duration_seconds: number | null;
@@ -381,6 +802,19 @@ export type SnapshotBatchOptions = {
 export type InspectProjectOptions = {
     projectId: string;
     mode: ProjectContextMode;
+    assetLimit?: number;
+    assetOffset?: number;
+    timelineLimit?: number;
+    timelineOffset?: number;
+    transcriptLimit?: number;
+    transcriptOffset?: number;
+    captionWordLimit?: number;
+    captionWordOffset?: number;
+};
+export type ProjectTimelineOptions = {
+    projectId: string;
+    limit?: number;
+    offset?: number;
 };
 export type ListProjectsOptions = {
     limit: number | undefined;
@@ -466,6 +900,7 @@ export type AttachMediaToProjectOptions = {
     positionY: number | undefined;
     widthPx: number | undefined;
     heightPx: number | undefined;
+    keepAspectRatio: boolean | undefined;
     scale: number | undefined;
     opacity: number | undefined;
     animationPreset: MediaAnimationPreset | undefined;
@@ -501,6 +936,7 @@ export type UpdateTextOptions = {
     text: string | undefined;
     name: string | undefined;
     spec: JsonObject | undefined;
+    durationSeconds: number | undefined;
 };
 export type RemoveTextOptions = {
     projectId: string;
@@ -516,14 +952,217 @@ export type AddAudioOptions = {
     fadeOutSeconds: number | undefined;
     loop: boolean | undefined;
 };
-export type MediaPositionPreset = "center" | "top-left" | "top-right" | "bottom-left" | "bottom-right" | "full-screen";
-export type MediaAnimationPreset = "none" | "fadeIn" | "fadeOut" | "zoomIn" | "slideIn" | "popIn" | "bounce" | "spin";
+export type UpdateAudioOptions = {
+    projectId: string;
+    timelineItemId: string;
+    durationSeconds: number | undefined;
+    volume: number | undefined;
+    fadeInSeconds: number | undefined;
+    fadeOutSeconds: number | undefined;
+};
+export type AudioLibraryProvider = "openverse" | "freesound" | "wikimedia";
+export type AudioLibraryProviderFilter = AudioLibraryProvider | "all";
+export type AudioLibraryLicenseFilter = "cc0" | "public_domain" | "attribution" | "all";
+export type AudioLibraryTypeFilter = "music" | "sound_effect" | "ambient" | "other";
+export type StockMediaProvider = "pexels" | "freesound";
+export type StockMediaAssetType = "image" | "video" | "audio";
+export type StockMediaOrientation = "landscape" | "portrait" | "square";
+export type StockAudioType = "sound_effect" | "ambient" | "background_music" | "other";
+export type GlobalBrollLibraryAssetType = "image" | "video" | "audio";
+export type GlobalBrollLibraryAudioType = "music" | "sound_effect" | "ambient" | "background_music" | "other";
+export type AudioLibraryItem = {
+    provider: AudioLibraryProvider;
+    external_id: string;
+    title: string;
+    creator_name: string | null;
+    creator_url: string | null;
+    source_url: string;
+    preview_url: string | null;
+    download_url: string | null;
+    duration_seconds: number | null;
+    license_code: string;
+    license_url: string | null;
+    requires_attribution: boolean;
+    attribution_text: string | null;
+    commercial_use_allowed: boolean;
+    tags: string[];
+};
+export type SearchAudioLibraryOptions = {
+    query: string;
+    provider: AudioLibraryProviderFilter | undefined;
+    license: AudioLibraryLicenseFilter | undefined;
+    audioType: AudioLibraryTypeFilter | undefined;
+    minDurationSeconds: number | null | undefined;
+    maxDurationSeconds: number | null | undefined;
+    limit: number | undefined;
+    page: number | undefined;
+};
+export type SearchAudioLibraryResult = {
+    items: AudioLibraryItem[];
+    warnings: string[];
+    providers: AudioLibraryProvider[];
+};
+export type ImportAudioLibraryAssetOptions = {
+    provider: AudioLibraryProvider;
+    externalId: string;
+    folderId: string | null | undefined;
+    projectId: string | null | undefined;
+    startSeconds: number | undefined;
+    durationSeconds: number | null | undefined;
+    volume: number | undefined;
+    fadeInSeconds: number | undefined;
+    fadeOutSeconds: number | undefined;
+    loop: boolean | undefined;
+    audioType: AudioLibraryTypeFilter | undefined;
+};
+export type ImportAudioLibraryAssetResult = {
+    asset: {
+        id: string;
+        name: string;
+        asset_type: "audio";
+        audio_type: string;
+        duration_seconds: number | null;
+        source_url: string;
+        license_code: string;
+        license_url: string | null;
+        attribution_text: string | null;
+    };
+    imported: boolean;
+    deduped: boolean;
+    timeline_item_id: string | null;
+    txid: number | null;
+};
+export type StockMediaVariant = {
+    id: string;
+    label: string;
+    url: string;
+    mime_type: string;
+    width: number | null;
+    height: number | null;
+    quality: string | null;
+};
+export type StockMediaItem = {
+    provider: StockMediaProvider;
+    provider_asset_id: string;
+    asset_type: StockMediaAssetType;
+    title: string;
+    preview_url: string | null;
+    thumbnail_url: string | null;
+    source_url: string;
+    author_name: string | null;
+    author_url: string | null;
+    license_code: string;
+    license_url: string | null;
+    requires_attribution: boolean;
+    width: number | null;
+    height: number | null;
+    duration_seconds: number | null;
+    variants: StockMediaVariant[];
+};
+export type SearchStockMediaOptions = {
+    query: string;
+    assetType: StockMediaAssetType;
+    provider: StockMediaProvider | null | undefined;
+    orientation: StockMediaOrientation | null | undefined;
+    page: number | undefined;
+    limit: number | undefined;
+};
+export type SearchStockMediaResult = {
+    items: StockMediaItem[];
+    warnings: string[];
+};
+export type ImportStockMediaOptions = {
+    provider: StockMediaProvider;
+    providerAssetId: string;
+    assetType: StockMediaAssetType;
+    variantId: string | null | undefined;
+    folderId: string | null | undefined;
+    audioType: StockAudioType | undefined;
+};
+export type ImportStockMediaResult = {
+    asset: {
+        id: string;
+        name: string;
+        asset_type: StockMediaAssetType;
+        processing_status: string;
+        source_url: string;
+        license_code: string;
+        license_url: string | null;
+    };
+    imported: boolean;
+    deduped: boolean;
+};
+export type GlobalBrollLibraryItem = {
+    id: string;
+    asset_type: GlobalBrollLibraryAssetType;
+    title: string;
+    description: string;
+    tags: string[];
+    preview_url: string | null;
+    thumbnail_url: string | null;
+    mime_type: string;
+    file_size_bytes: number;
+    duration_seconds: number | null;
+    width: number | null;
+    height: number | null;
+    audio_type: GlobalBrollLibraryAudioType;
+    license_code: string;
+    license_url: string | null;
+    requires_attribution: boolean;
+    attribution_text: string | null;
+    source_url: string | null;
+};
+export type SearchGlobalBrollLibraryOptions = {
+    query: string | null | undefined;
+    assetType: GlobalBrollLibraryAssetType | null | undefined;
+    audioType: GlobalBrollLibraryAudioType | null | undefined;
+    limit: number | undefined;
+    offset: number | undefined;
+};
+export type SearchGlobalBrollLibraryResult = {
+    items: GlobalBrollLibraryItem[];
+};
+export type ImportGlobalBrollLibraryAssetOptions = {
+    libraryAssetId: string;
+    folderId: string | null | undefined;
+};
+export type ImportGlobalBrollLibraryAssetResult = {
+    asset: {
+        id: string;
+        name: string;
+        asset_type: GlobalBrollLibraryAssetType;
+        processing_status: string;
+        library_asset_id: string;
+    };
+    imported: boolean;
+    deduped: boolean;
+};
+export type MediaPositionPreset = "center" | "top-left" | "top-right" | "bottom-left" | "bottom-right" | "fullscreen" | "full-screen";
+export type MediaAnimationPreset = "none" | "fadeIn" | "fadeOut" | "zoomIn" | "zoomOut" | "slideIn" | "slideLeft" | "slideRight" | "slideUp" | "slideDown" | "popIn" | "bounce" | "spin";
+export type UpdateMediaOverlayOptions = {
+    projectId: string;
+    timelineItemId: string;
+    positionPreset: MediaPositionPreset | undefined;
+    positionX: number | undefined;
+    positionY: number | undefined;
+    widthPx: number | undefined;
+    heightPx: number | undefined;
+    keepAspectRatio: boolean | undefined;
+    scale: number | undefined;
+    opacity: number | undefined;
+    animationPreset: MediaAnimationPreset | undefined;
+    removeAnimations: boolean | undefined;
+    blurredBackground: boolean | undefined;
+};
 export type CaptionWordSelectorOptions = {
     projectId: string;
     wordIds: string[] | undefined;
     matchText: string | undefined;
     matchPattern: "numbers" | "caps" | "exclamations" | undefined;
     timelineItemId: string | undefined;
+    all: boolean | undefined;
+    fromSeconds: number | undefined;
+    toSeconds: number | undefined;
 };
 export type ListCaptionWordsOptions = {
     projectId: string;
@@ -553,7 +1192,11 @@ export type SetCaptionWordEmphasisOptions = CaptionWordSelectorOptions & {
 };
 export type DeleteCaptionWordsOptions = {
     projectId: string;
-    wordIds: string[];
+    wordIds: string[] | undefined;
+    timelineItemId: string | undefined;
+    all: boolean | undefined;
+    fromSeconds: number | undefined;
+    toSeconds: number | undefined;
 };
 export type MergeCaptionWordsOptions = {
     projectId: string;
@@ -572,11 +1215,17 @@ export type PreviewCaptionThemeOptions = {
     targetWidth: number | undefined;
     imageFormat: "png" | "jpeg" | undefined;
 };
+export type UpdateCaptionThemeOptions = {
+    themeId: string;
+    name: string | undefined;
+    description: string | undefined;
+    settings: JsonObject | undefined;
+};
 export type StartExportOptions = {
     projectId: string;
     resolution: string | undefined;
     format: string | undefined;
-    includeCaptions: boolean | undefined;
+    coverFrameSeconds?: number | null;
 };
 export type WaitExportOptions = {
     exportId: string;
@@ -585,7 +1234,9 @@ export type WaitExportOptions = {
 };
 export type SilencePlanOptions = {
     projectId: string;
-    timelineItemId: string;
+    timelineItemId: string | undefined;
+    allMediaItems: boolean | undefined;
+    strategy: "audio" | "caption-gaps" | undefined;
     paddingMs: number | undefined;
     silenceThresholdDb: number | undefined;
     minSilenceDurationSeconds: number | undefined;
@@ -595,6 +1246,11 @@ export type SilencePlanOptions = {
 export type SilenceApplyOptions = SilencePlanOptions & {
     deleteSilentClips: boolean | undefined;
     manualSegmentOverrides: Record<string, "keep" | "cut"> | undefined;
+    segments: Array<{
+        timelineItemId: string | undefined;
+        startSeconds: number;
+        endSeconds: number;
+    }> | undefined;
     previewConfirmed: true;
 };
 export type MistakePlanOptions = {
@@ -607,6 +1263,63 @@ export type MistakeApplyOptions = MistakePlanOptions & {
     deleteMistakes: boolean | undefined;
     previewConfirmed: true;
 };
+export type EffectEasing = "linear" | "easeIn" | "easeOut" | "easeInOut";
+export type ZoomEffectSettings = {
+    scale: {
+        start: number;
+        end: number;
+    } | undefined;
+    translate: {
+        start: {
+            x: number;
+            y: number;
+        };
+        end: {
+            x: number;
+            y: number;
+        };
+    } | undefined;
+    anchor: {
+        x: number;
+        y: number;
+    } | undefined;
+    style: "transition" | "hard" | undefined;
+    phase: "in" | "out" | "both" | "none" | undefined;
+    inDurationSeconds: number | undefined;
+    outDurationSeconds: number | null | undefined;
+    outScale: number | null | undefined;
+};
+export type MaskEffectSettings = JsonObject;
+export type ColorGradeEffectSettings = JsonObject;
+export type AddEffectOptions<TSettings> = {
+    projectId: string;
+    timelineItemId: string | undefined;
+    contentItemId: string | undefined;
+    effectId: string | undefined;
+    name: string | undefined;
+    startTimeSeconds: number | undefined;
+    durationSeconds: number | undefined;
+    easing: EffectEasing | undefined;
+    layerIndex: number | undefined;
+    orderIndex: number | undefined;
+    settings: TSettings | undefined;
+};
+export type UpdateEffectOptions<TSettings> = {
+    projectId: string;
+    timelineItemId: string;
+    durationSeconds: number | undefined;
+    easing: EffectEasing | undefined;
+    settings: TSettings | undefined;
+};
+export type EffectMutationResult = {
+    success: true;
+    project_id: string;
+    timeline_item_id: string;
+    content_item_id: string;
+    effect_id: string;
+    effect_type: "zoom" | "mask" | "colorgrade";
+    txid: number | null;
+};
 export declare class BlitzReelsClient {
     private apiKey;
     private baseUrl;
@@ -628,20 +1341,24 @@ export declare class BlitzReelsClient {
             success: true;
         }>;
         inspect: (options: InspectProjectOptions) => Promise<ProjectContext>;
-        timeline: (options: {
-            projectId: string;
-        }) => Promise<ProjectContext>;
+        timeline: (options: ProjectTimelineOptions) => Promise<ProjectContext>;
         renderSnapshot: (options: SnapshotOptions) => Promise<PreviewFrame>;
         renderSnapshots: (options: SnapshotBatchOptions) => Promise<PreviewFrames>;
     };
-    timeline: {
-        transform: (options: TimelineTransformOptions) => Promise<TimelineEditResult>;
-        move: (options: TimelineMoveOptions) => Promise<TimelineEditResult>;
-        delete: (options: TimelineDeleteOptions) => Promise<TimelineEditResult>;
-        deleteItem: (options: {
-            projectId: string;
-            timelineItemId: string;
-        }) => Promise<TimelineItemDeleteResult>;
+    timeline: TimelineResource;
+    effects: {
+        zoom: {
+            add: (options: AddEffectOptions<ZoomEffectSettings>) => Promise<EffectMutationResult>;
+            update: (options: UpdateEffectOptions<ZoomEffectSettings>) => Promise<EffectMutationResult>;
+        };
+        mask: {
+            add: (options: AddEffectOptions<MaskEffectSettings>) => Promise<EffectMutationResult>;
+            update: (options: UpdateEffectOptions<MaskEffectSettings>) => Promise<EffectMutationResult>;
+        };
+        colorgrade: {
+            add: (options: AddEffectOptions<ColorGradeEffectSettings>) => Promise<EffectMutationResult>;
+            update: (options: UpdateEffectOptions<ColorGradeEffectSettings>) => Promise<EffectMutationResult>;
+        };
     };
     workspace: {
         getSettings: () => Promise<WorkspaceSettings>;
@@ -652,6 +1369,10 @@ export declare class BlitzReelsClient {
         get: (options: {
             assetId: string;
         }) => Promise<MediaAssetDetails>;
+        clippingStatus: (options: {
+            assetId: string;
+            projectId: string | undefined;
+        }) => Promise<JsonObject>;
         delete: (options: {
             assetId: string;
         }) => Promise<{
@@ -663,6 +1384,16 @@ export declare class BlitzReelsClient {
         update: (options: UpdateMediaOptions) => Promise<MediaAssetUpdateResult>;
         move: (options: MoveMediaOptions) => Promise<MediaMoveResult>;
         attachToProject: (options: AttachMediaToProjectOptions) => Promise<MediaAttachResult>;
+        updateOverlay: (options: UpdateMediaOverlayOptions) => Promise<UpdateMediaOverlayResult>;
+        shorts: {
+            list: (options: {
+                assetId: string;
+            }) => Promise<MediaShortSuggestionList>;
+            generate: (options: GenerateMediaShortSuggestionsOptions) => Promise<{
+                run_id: string;
+            }>;
+            apply: (options: ApplyMediaShortSuggestionOptions) => Promise<ApplyMediaShortSuggestionResult>;
+        };
         folders: {
             list: (options: ListMediaFoldersOptions) => Promise<MediaFoldersList>;
             create: (options: CreateMediaFolderOptions) => Promise<{
@@ -681,6 +1412,15 @@ export declare class BlitzReelsClient {
             }>;
         };
     };
+    clips: {
+        create: (options: CreateClipOptions) => Promise<ClipEnvelope>;
+        get: (options: {
+            clipId: string;
+        }) => Promise<ClipEnvelope>;
+        reselect: (options: ReselectClipOptions) => Promise<ClipEnvelope>;
+        repair: (options: RepairClipOptions) => Promise<ClipEnvelope>;
+        export: (options: ExportClipOptions) => Promise<ClipEnvelope>;
+    };
     text: {
         add: (options: AddTextOptions) => Promise<CreateContentItemResult>;
         list: (options: {
@@ -695,6 +1435,19 @@ export declare class BlitzReelsClient {
     };
     audio: {
         add: (options: AddAudioOptions) => Promise<InsertAudioResult>;
+        update: (options: UpdateAudioOptions) => Promise<UpdateAudioResult>;
+    };
+    audioLibrary: {
+        search: (options: SearchAudioLibraryOptions) => Promise<SearchAudioLibraryResult>;
+        importAsset: (options: ImportAudioLibraryAssetOptions) => Promise<ImportAudioLibraryAssetResult>;
+    };
+    stockMedia: {
+        search: (options: SearchStockMediaOptions) => Promise<SearchStockMediaResult>;
+        importAsset: (options: ImportStockMediaOptions) => Promise<ImportStockMediaResult>;
+    };
+    library: {
+        search: (options: SearchGlobalBrollLibraryOptions) => Promise<SearchGlobalBrollLibraryResult>;
+        importAsset: (options: ImportGlobalBrollLibraryAssetOptions) => Promise<ImportGlobalBrollLibraryAssetResult>;
     };
     silence: {
         plan: (options: SilencePlanOptions) => Promise<unknown>;
@@ -704,30 +1457,8 @@ export declare class BlitzReelsClient {
         plan: (options: MistakePlanOptions) => Promise<unknown>;
         apply: (options: MistakeApplyOptions) => Promise<unknown>;
     };
-    captions: {
-        listWords: (options: ListCaptionWordsOptions) => Promise<CaptionWordsList>;
-        updateWordText: (options: UpdateCaptionWordTextOptions) => Promise<CaptionWordTextResult>;
-        batchUpdateWordText: (options: BatchUpdateCaptionWordTextOptions) => Promise<CaptionWordBatchTextResult>;
-        setWordStyle: (options: SetCaptionWordStyleOptions) => Promise<CaptionWordCountResult>;
-        setWordEmphasis: (options: SetCaptionWordEmphasisOptions) => Promise<CaptionWordCountResult>;
-        deleteWords: (options: DeleteCaptionWordsOptions) => Promise<CaptionWordMutationResult>;
-        mergeWords: (options: MergeCaptionWordsOptions) => Promise<CaptionWordMutationResult>;
-        splitWord: (options: SplitCaptionWordOptions) => Promise<CaptionWordMutationResult>;
-        listThemes: () => Promise<CaptionThemeList>;
-        setDefaultTheme: (options: {
-            themeId: string;
-        }) => Promise<{
-            success: boolean;
-        }>;
-        setProjectTheme: (options: {
-            projectId: string;
-            themeId: string;
-        }) => Promise<{
-            success: boolean;
-            theme_id: string;
-        }>;
-        previewTheme: (options: PreviewCaptionThemeOptions) => Promise<CaptionThemePreview>;
-    };
+    aiEdit: AiEditResource;
+    captions: CaptionsResource;
     exports: {
         start: (options: StartExportOptions) => Promise<ExportStartResult>;
         get: (options: {