@mux/ai 0.52.0 → 0.53.0

package/dist/{index-sqJ9PpHw.d.ts → index-BbxJ0X25.d.ts}

@@ -1,5 +1,5 @@
 import { LanguageModel, generateText as generateText$1 } from 'ai';
-import { l as WorkflowCredentialsInput, M as MuxAsset, A as AssetTextTrack, i as TokenUsage, f as ScopedMuxAIOptions, I as ImageSubmissionMode, d as MuxAIOptions, b as ChunkingStrategy, k as VideoEmbeddingsResult, H as Hotspot, v as Shot, j as ToneType, g as StorageAdapter } from './shots-3wmvZnUV.js';
+import { l as WorkflowCredentialsInput, M as MuxAsset, A as AssetTextTrack, i as TokenUsage, f as ScopedMuxAIOptions, I as ImageSubmissionMode, d as MuxAIOptions, b as ChunkingStrategy, k as VideoEmbeddingsResult, H as Hotspot, y as Shot, q as VTTCue, j as ToneType, g as StorageAdapter } from './transcripts-BCtzC8hZ.js';
 import { z } from 'zod';
 import { S as SafetyReport, e as PromptOverrides, h as SceneContextItemV1, D as DEFAULT_DESCRIPTION_LENGTH, a as DEFAULT_SUMMARY_KEYWORD_LIMIT, b as DEFAULT_TITLE_LENGTH } from './summarization-BFmhXeAu.js';
 import { createAnthropic } from '@ai-sdk/anthropic';
@@ -1428,24 +1428,95 @@ declare function selectGenerateTextShotFrames(shots: readonly Shot[], assetDurat
  */
 declare function generateText(assetId: string, options: GenerateTextOptions): Promise<GenerateTextResult>;
 
-/** Per-thumbnail moderation result returned from `getModerationScores`. */
+/** Per-thumbnail (image) moderation result returned from `getModerationScores`. */
 interface ThumbnailModerationScore {
     url: string;
-    /** Time in seconds of the thumbnail within the video. Absent for transcript moderation entries. */
+    /** Time in seconds of the thumbnail within the video. */
     time?: number;
     sexual: number;
     violence: number;
     error: boolean;
     errorMessage?: string;
 }
+/** Per-time-window transcript moderation result returned from `getModerationScores`. */
+interface TranscriptModerationScore {
+    /** Seconds — start of the moderated time window (first cue's start time). */
+    startTime: number;
+    /** Seconds — end of the moderated time window (last cue's end time). */
+    endTime: number;
+    sexual: number;
+    violence: number;
+    error: boolean;
+    errorMessage?: string;
+}
+/**
+ * Outcome of moderating one surface (thumbnails or transcript) of an asset.
+ * Lets callers audit whether a surface was moderated or skipped (and why),
+ * instead of inferring it from an empty scores array.
+ */
+interface ModerationSurfaceStatus<Reason extends string> {
+    /**
+     * - `"completed"` — moderation ran and at least one item was scored
+     *   (individual items may still carry a per-item `error`).
+     * - `"skipped"` — nothing could be moderated on this surface;
+     *   see {@link skipReason} / {@link skipMessage}.
+     * - `"failed"` — moderation ran but every item errored, so this surface
+     *   contributed no scores; see {@link errorMessage}. The result is still
+     *   returned when the other surface succeeded, with
+     *   `coverage.isLowConfidence` set.
+     */
+    status: "completed" | "skipped" | "failed";
+    /** Present only when `status === "skipped"`. Machine-readable reason. */
+    skipReason?: Reason;
+    /** Present only when `status === "skipped"`. Human-readable explanation. */
+    skipMessage?: string;
+    /** Present only when `status === "failed"`. Summarizes the per-item errors. */
+    errorMessage?: string;
+}
+/**
+ * Why thumbnail moderation was skipped:
+ * - `"no_video_track"` — the asset has no video track, so there are no thumbnails.
+ * - `"no_video_in_scope"` — the asset has a video track, but the requested
+ *   `scope` lies entirely past its end (trailing non-video media).
+ */
+type ThumbnailModerationSkipReason = "no_video_track" | "no_video_in_scope";
+/**
+ * Why transcript moderation was skipped:
+ * - `"no_ready_text_track"` — no ready caption/subtitle track (or none
+ *   matching `languageCode`).
+ * - `"no_cues"` — a track exists but produced nothing to moderate: the VTT
+ *   body was empty, had no parseable cues, or no cue fell inside `scope`.
+ *   Treated as valid-but-empty, not as an error.
+ * - `"unsupported_provider"` — the selected provider is image-only.
+ */
+type TranscriptModerationSkipReason = "no_ready_text_track" | "no_cues" | "unsupported_provider";
+type ThumbnailModerationStatus = ModerationSurfaceStatus<ThumbnailModerationSkipReason>;
+type TranscriptModerationStatus = ModerationSurfaceStatus<TranscriptModerationSkipReason>;
 /** Aggregated moderation payload returned from `getModerationScores`. */
 interface ModerationResult {
     assetId: string;
-    /** Whether moderation ran on thumbnails (video) or transcript text (audio-only). */
-    mode: "thumbnails" | "transcript";
-    /** Convenience flag so callers can understand why `thumbnailScores` may contain a transcript entry. */
+    /**
+     * Which surfaces were actually moderated (derived from `thumbnailModeration`
+     * and `transcriptModeration`):
+     * - `"thumbnails"`: only image thumbnails.
+     * - `"transcript"`: only transcript text.
+     * - `"combined"`: both.
+     */
+    mode: "thumbnails" | "transcript" | "combined";
+    /** Convenience flag indicating the asset has no video track. */
     isAudioOnly: boolean;
+    /** Image (thumbnail) moderation results. Empty unless `thumbnailModeration.status` is `"completed"`. */
     thumbnailScores: ThumbnailModerationScore[];
+    /**
+     * Transcript moderation results, one entry per moderated time window
+     * (each carries `startTime`/`endTime`). Empty unless
+     * `transcriptModeration.status` is `"completed"`.
+     */
+    transcriptScores: TranscriptModerationScore[];
+    /** Audit trail for the thumbnail surface: completed, skipped (and why), or failed (and why). */
+    thumbnailModeration: ThumbnailModerationStatus;
+    /** Audit trail for the transcript surface: completed, skipped (and why), or failed (and why). */
+    transcriptModeration: TranscriptModerationStatus;
     /** Coverage metadata describing how many requested moderation samples actually succeeded. */
     coverage: {
         requestedSampleCount: number;
@@ -1453,12 +1524,15 @@ interface ModerationResult {
         failedSampleCount: number;
         /** Fraction of requested samples that produced a usable moderation result. */
         sampleCoverage: number;
-        /** True when at least one sample failed but the workflow still returned a result. */
+        /**
+         * True when at least one thumbnail or transcript window failed but the
+         * workflow still returned a result.
+         */
         isPartial: boolean;
         /**
-         * True when threshold interpretation should be treated cautiously.
-         * For thumbnail moderation, this means we either covered less than half of planned samples
-         * or ended up with fewer than 3 successful thumbnails.
+         * True when threshold interpretation should be treated cautiously: fewer
+         * than half of the planned thumbnails (or fewer than 3) succeeded, or a
+         * surface that ran failed entirely.
          */
         isLowConfidence: boolean;
     };
@@ -1497,8 +1571,8 @@ interface ModerationOptions extends ScopedMuxAIOptions {
     /** OpenAI moderation model identifier (defaults to 'omni-moderation-latest'). */
     model?: string;
     /**
-     * Optional transcript language code used when moderating audio-only assets.
-     * If omitted, the first ready text track will be used.
+     * Language code of the caption track to moderate. If omitted, an English
+     * subtitles track is preferred and otherwise the first ready text track is used.
      */
     languageCode?: string;
     /** Override the default sexual/violence thresholds (0-1). */
@@ -1519,6 +1593,25 @@ interface ModerationOptions extends ScopedMuxAIOptions {
     /** Download tuning used when `imageSubmissionMode` === 'base64'. */
     imageDownloadOptions?: ImageDownloadOptions;
 }
+/**
+ * Default tuning for transcript time-windowing. Window SIZE scales with the
+ * asset's duration and consecutive windows OVERLAP so abuse straddling a
+ * boundary is still scored intact in at least one window:
+ *
+ *   windowSeconds  = clamp(duration / targetWindowCount, minWindowSeconds, maxWindowSeconds)
+ *   overlapSeconds = max(minOverlapSeconds, windowSeconds * overlapFraction)
+ *   stride         = max(windowSeconds - overlapSeconds, 1)
+ *
+ * Exported so callers can approximate window count from duration alone (e.g. for a
+ * pre-flight cost estimate before fetching/parsing the real transcript).
+ */
+declare const DEFAULT_TRANSCRIPT_WINDOWING: {
+    readonly targetWindowCount: 40;
+    readonly minWindowSeconds: 20;
+    readonly maxWindowSeconds: 120;
+    readonly overlapFraction: 0.15;
+    readonly minOverlapSeconds: 5;
+};
 /**
  * Linear mapping of Google Vision SafeSearch `Likelihood` enum (UNKNOWN..VERY_LIKELY)
  * onto a 0..1 score. This mapping may change in future versions of `@mux/ai`.
@@ -1526,10 +1619,46 @@ interface ModerationOptions extends ScopedMuxAIOptions {
 declare const GOOGLE_VISION_LIKELIHOOD_TO_SCORE: Record<string, number>;
 declare const HIVE_SEXUAL_CATEGORIES: string[];
 declare const HIVE_VIOLENCE_CATEGORIES: string[];
+/** A time-bounded window of transcript text built from caption cues. */
+interface TranscriptWindow {
+    startTime: number;
+    endTime: number;
+    text: string;
+}
+/**
+ * Build DYNAMIC, OVERLAPPING transcript windows from timestamped caption cues.
+ *
+ * Window SIZE scales with the asset's `duration` and consecutive windows
+ * OVERLAP so abuse straddling a window boundary is still scored intact in at
+ * least one window:
+ *
+ *   windowSeconds  = clamp(duration / targetWindowCount, minWindowSeconds, maxWindowSeconds)
+ *   overlapSeconds = max(minOverlapSeconds, windowSeconds * overlapFraction)
+ *   stride         = max(windowSeconds - overlapSeconds, 1)   // never <= 0
+ *
+ * Window k covers the time interval `[k*stride, k*stride + windowSeconds]`. A
+ * cue belongs to window k when it intersects that interval, so boundary cues
+ * appear in both neighbouring windows. Empty windows (gaps of silence) are
+ * skipped, and two consecutive windows containing the exact same cue set are
+ * deduped to avoid a redundant request. A window whose joined text would exceed
+ * {@link TRANSCRIPT_WINDOW_MAX_UTF16_CODE_UNITS} is split into sub-windows under
+ * the cap as a rare safety guard.
+ *
+ * NOTE: because windows overlap by design, consecutive windows' reported
+ * `[startTime, endTime]` ranges may overlap by ~`overlapSeconds`.
+ *
+ * Exported for direct unit testing without network access.
+ */
+declare function buildTranscriptWindows(cues: VTTCue[], duration: number): TranscriptWindow[];
 /**
- * Moderate a Mux asset.
- * - Video assets: moderates storyboard thumbnails (image moderation)
- * - Audio-only assets: moderates transcript text (text moderation)
+ * Moderate a Mux asset. By default both surfaces are moderated where available:
+ * - Thumbnails: sampled storyboard frames (image moderation). Skipped for audio-only assets.
+ * - Transcript: caption text in time windows (text moderation). Skipped when no
+ *   usable caption track exists or the provider is image-only.
+ *
+ * Each surface reports its outcome in `thumbnailModeration` / `transcriptModeration`.
+ * Throws when neither surface can be moderated, since a result with nothing
+ * scored would read as "clean".
  *
  * Provider notes:
  * - provider 'openai' uses OpenAI's hosted moderation endpoint (requires OPENAI_API_KEY)
@@ -1986,6 +2115,7 @@ type index_ChaptersType = ChaptersType;
 declare const index_DEFAULT_DESCRIPTION_LENGTH: typeof DEFAULT_DESCRIPTION_LENGTH;
 declare const index_DEFAULT_SUMMARY_KEYWORD_LIMIT: typeof DEFAULT_SUMMARY_KEYWORD_LIMIT;
 declare const index_DEFAULT_TITLE_LENGTH: typeof DEFAULT_TITLE_LENGTH;
+declare const index_DEFAULT_TRANSCRIPT_WINDOWING: typeof DEFAULT_TRANSCRIPT_WINDOWING;
 type index_EditCaptionsOptions<P extends SupportedProvider = SupportedProvider> = EditCaptionsOptions<P>;
 type index_EditCaptionsResult = EditCaptionsResult;
 type index_EmbeddingsOptions = EmbeddingsOptions;
@@ -2027,6 +2157,7 @@ type index_HiveModerationSource = HiveModerationSource;
 type index_ModerationOptions = ModerationOptions;
 type index_ModerationProvider = ModerationProvider;
 type index_ModerationResult = ModerationResult;
+type index_ModerationSurfaceStatus<Reason extends string> = ModerationSurfaceStatus<Reason>;
 type index_MomentInsight = MomentInsight;
 type index_OverallInsight = OverallInsight;
 type index_ProfanityDetectionPayload = ProfanityDetectionPayload;
@@ -2050,6 +2181,11 @@ type index_SummaryType = SummaryType;
 type index_TextLengthLimit = TextLengthLimit;
 type index_TextRepairModelOptions = TextRepairModelOptions;
 type index_ThumbnailModerationScore = ThumbnailModerationScore;
+type index_ThumbnailModerationSkipReason = ThumbnailModerationSkipReason;
+type index_ThumbnailModerationStatus = ThumbnailModerationStatus;
+type index_TranscriptModerationScore = TranscriptModerationScore;
+type index_TranscriptModerationSkipReason = TranscriptModerationSkipReason;
+type index_TranscriptModerationStatus = TranscriptModerationStatus;
 type index_TranslationChunkingOptions = TranslationChunkingOptions;
 type index_TranslationOptions<P extends SupportedProvider = SupportedProvider> = TranslationOptions<P>;
 type index_TranslationPayload = TranslationPayload;
@@ -2061,6 +2197,7 @@ declare const index_applySpeakerReplacements: typeof applySpeakerReplacements;
 declare const index_applyTextRepair: typeof applyTextRepair;
 declare const index_askQuestions: typeof askQuestions;
 declare const index_buildReplacementRegex: typeof buildReplacementRegex;
+declare const index_buildTranscriptWindows: typeof buildTranscriptWindows;
 declare const index_burnedInCaptionsSchema: typeof burnedInCaptionsSchema;
 declare const index_censorVttContent: typeof censorVttContent;
 declare const index_chapterSchema: typeof chapterSchema;
@@ -2100,7 +2237,7 @@ declare const index_translationSchema: typeof translationSchema;
 declare const index_validateNeverTranslateTerms: typeof validateNeverTranslateTerms;
 declare const index_verifyNeverTranslateTerms: typeof verifyNeverTranslateTerms;
 declare namespace index {
-  export { index_ASK_QUESTIONS_DEFAULT_MAX_ANSWER_OPTION_LENGTH as ASK_QUESTIONS_DEFAULT_MAX_ANSWER_OPTION_LENGTH, index_ASK_QUESTIONS_DEFAULT_MAX_FREE_FORM_ANSWER_LENGTH as ASK_QUESTIONS_DEFAULT_MAX_FREE_FORM_ANSWER_LENGTH, index_ASK_QUESTIONS_MAX_QUESTIONS_PER_CALL as ASK_QUESTIONS_MAX_QUESTIONS_PER_CALL, index_ASK_QUESTIONS_MAX_QUESTION_LENGTH as ASK_QUESTIONS_MAX_QUESTION_LENGTH, type index_AskQuestionsOptions as AskQuestionsOptions, type index_AskQuestionsResult as AskQuestionsResult, type index_AskQuestionsType as AskQuestionsType, type index_AudioTranslationOptions as AudioTranslationOptions, type index_AudioTranslationResult as AudioTranslationResult, type index_AutoCensorProfanityOptions as AutoCensorProfanityOptions, type index_BurnedInCaptionsAnalysis as BurnedInCaptionsAnalysis, type index_BurnedInCaptionsOptions as BurnedInCaptionsOptions, type index_BurnedInCaptionsPromptOverrides as BurnedInCaptionsPromptOverrides, type index_BurnedInCaptionsPromptSections as BurnedInCaptionsPromptSections, type index_BurnedInCaptionsResult as BurnedInCaptionsResult, type index_CaptionReplacement as CaptionReplacement, type index_CensorMode as CensorMode, type index_Chapter as Chapter, type index_ChapterSystemPromptSections as ChapterSystemPromptSections, type index_ChaptersOptions as ChaptersOptions, type index_ChaptersPromptOverrides as ChaptersPromptOverrides, type index_ChaptersPromptSections as ChaptersPromptSections, type index_ChaptersResult as ChaptersResult, type index_ChaptersType as ChaptersType, index_DEFAULT_DESCRIPTION_LENGTH as DEFAULT_DESCRIPTION_LENGTH, index_DEFAULT_SUMMARY_KEYWORD_LIMIT as DEFAULT_SUMMARY_KEYWORD_LIMIT, index_DEFAULT_TITLE_LENGTH as DEFAULT_TITLE_LENGTH, type index_EditCaptionsOptions as EditCaptionsOptions, type index_EditCaptionsResult as EditCaptionsResult, type index_EmbeddingsOptions as EmbeddingsOptions, type index_EmbeddingsResult as EmbeddingsResult, type index_EngagementInsightsOptions as EngagementInsightsOptions, type index_EngagementInsightsResult as EngagementInsightsResult, index_GENERATE_TEXT_CALLS_TO_ACTION as GENERATE_TEXT_CALLS_TO_ACTION, index_GENERATE_TEXT_CHANNELS as GENERATE_TEXT_CHANNELS, index_GENERATE_TEXT_CHANNEL_CEILINGS as GENERATE_TEXT_CHANNEL_CEILINGS, index_GENERATE_TEXT_FORMATS as GENERATE_TEXT_FORMATS, index_GENERATE_TEXT_LENGTH_BOUNDS as GENERATE_TEXT_LENGTH_BOUNDS, index_GENERATE_TEXT_MAX_ARTIFACTS as GENERATE_TEXT_MAX_ARTIFACTS, index_GENERATE_TEXT_MAX_AUDIENCE_CHARS as GENERATE_TEXT_MAX_AUDIENCE_CHARS, index_GENERATE_TEXT_MAX_BRAND_TERMS as GENERATE_TEXT_MAX_BRAND_TERMS, index_GENERATE_TEXT_MAX_BRAND_TERMS_TOTAL_CHARS as GENERATE_TEXT_MAX_BRAND_TERMS_TOTAL_CHARS, index_GENERATE_TEXT_MAX_BRAND_TERM_CHARS as GENERATE_TEXT_MAX_BRAND_TERM_CHARS, index_GENERATE_TEXT_MAX_CONCURRENT_GENERATIONS as GENERATE_TEXT_MAX_CONCURRENT_GENERATIONS, index_GENERATE_TEXT_MAX_INSTRUCTIONS_CHARS as GENERATE_TEXT_MAX_INSTRUCTIONS_CHARS, index_GENERATE_TEXT_MAX_SHOT_FRAMES as GENERATE_TEXT_MAX_SHOT_FRAMES, index_GENERATE_TEXT_MAX_VARIANTS as GENERATE_TEXT_MAX_VARIANTS, index_GENERATE_TEXT_VOICES as GENERATE_TEXT_VOICES, index_GOOGLE_VISION_LIKELIHOOD_TO_SCORE as GOOGLE_VISION_LIKELIHOOD_TO_SCORE, type index_GenerateTextArtifact as GenerateTextArtifact, type index_GenerateTextCallToAction as GenerateTextCallToAction, type index_GenerateTextChannel as GenerateTextChannel, type index_GenerateTextFormat as GenerateTextFormat, type index_GenerateTextKeyedItem as GenerateTextKeyedItem, type index_GenerateTextLengthLimit as GenerateTextLengthLimit, type index_GenerateTextOptions as GenerateTextOptions, type index_GenerateTextResult as GenerateTextResult, type index_GenerateTextVariant as GenerateTextVariant, type index_GenerateTextVoice as GenerateTextVoice, type index_GeneratedTextArtifact as GeneratedTextArtifact, type index_GeneratedTextVariant as GeneratedTextVariant, index_HIVE_SEXUAL_CATEGORIES as HIVE_SEXUAL_CATEGORIES, index_HIVE_VIOLENCE_CATEGORIES as HIVE_VIOLENCE_CATEGORIES, type index_HiveModerationOutput as HiveModerationOutput, type index_HiveModerationSource as HiveModerationSource, type index_ModerationOptions as ModerationOptions, type index_ModerationProvider as ModerationProvider, type index_ModerationResult as ModerationResult, type index_MomentInsight as MomentInsight, type index_OverallInsight as OverallInsight, type index_ProfanityDetectionPayload as ProfanityDetectionPayload, type index_Question as Question, type index_QuestionAnswer as QuestionAnswer, type index_QuestionAnswerType as QuestionAnswerType, type index_RepairAttempt as RepairAttempt, type index_RepairCall as RepairCall, type index_RepairOptions as RepairOptions, type index_RepairPlan as RepairPlan, type index_RepairResult as RepairResult, type index_RepairSpan as RepairSpan, type index_ReplacementRecord as ReplacementRecord, type index_SpeakerReplacement as SpeakerReplacement, type index_StaticRenditionCleanupOutcome as StaticRenditionCleanupOutcome, type index_SummarizationOptions as SummarizationOptions, type index_SummarizationPromptOverrides as SummarizationPromptOverrides, type index_SummarizationPromptSections as SummarizationPromptSections, type index_SummaryAndTagsResult as SummaryAndTagsResult, type index_SummaryType as SummaryType, type index_TextLengthLimit as TextLengthLimit, type index_TextRepairModelOptions as TextRepairModelOptions, type index_ThumbnailModerationScore as ThumbnailModerationScore, type index_TranslationChunkingOptions as TranslationChunkingOptions, type index_TranslationOptions as TranslationOptions, type index_TranslationPayload as TranslationPayload, type index_TranslationResult as TranslationResult, index_aggregateTokenUsage as aggregateTokenUsage, index_applyOverrideLists as applyOverrideLists, index_applyReplacements as applyReplacements, index_applySpeakerReplacements as applySpeakerReplacements, index_applyTextRepair as applyTextRepair, index_askQuestions as askQuestions, index_buildReplacementRegex as buildReplacementRegex, index_burnedInCaptionsSchema as burnedInCaptionsSchema, index_censorVttContent as censorVttContent, index_chapterSchema as chapterSchema, index_chaptersSchema as chaptersSchema, index_createReplacer as createReplacer, index_createTextRepairGenerator as createTextRepairGenerator, index_editCaptions as editCaptions, index_extractTranscriptSegmentsForHotspots as extractTranscriptSegmentsForHotspots, index_findGenerateTextLengthViolation as findGenerateTextLengthViolation, index_generateChapters as generateChapters, index_generateEmbeddings as generateEmbeddings, index_generateEngagementInsights as generateEngagementInsights, index_generateText as generateText, index_generateVideoEmbeddings as generateVideoEmbeddings, index_getModerationScores as getModerationScores, index_getSummaryAndTags as getSummaryAndTags, index_hasBurnedInCaptions as hasBurnedInCaptions, index_mapShotsToHotspots as mapShotsToHotspots, index_measureGenerateTextLength as measureGenerateTextLength, index_normalizeTranslatedVtt as normalizeTranslatedVtt, index_planTextRepair as planTextRepair, index_profanityDetectionSchema as profanityDetectionSchema, index_questionAnswerSchema as questionAnswerSchema, index_repairJsonSchema as repairJsonSchema, index_repairText as repairText, index_resolveGenerateTextLengthLimit as resolveGenerateTextLengthLimit, index_resolveGenerateTextLengthLimits as resolveGenerateTextLengthLimits, index_resolveGenerateTextOptions as resolveGenerateTextOptions, index_runTextRepairLoop as runTextRepairLoop, index_selectGenerateTextShotFrames as selectGenerateTextShotFrames, index_shouldSplitChunkTranslationError as shouldSplitChunkTranslationError, index_summarySchema as summarySchema, index_transformCueText as transformCueText, index_translateAudio as translateAudio, index_translateCaptions as translateCaptions, index_translationSchema as translationSchema, index_validateNeverTranslateTerms as validateNeverTranslateTerms, index_verifyNeverTranslateTerms as verifyNeverTranslateTerms };
+  export { index_ASK_QUESTIONS_DEFAULT_MAX_ANSWER_OPTION_LENGTH as ASK_QUESTIONS_DEFAULT_MAX_ANSWER_OPTION_LENGTH, index_ASK_QUESTIONS_DEFAULT_MAX_FREE_FORM_ANSWER_LENGTH as ASK_QUESTIONS_DEFAULT_MAX_FREE_FORM_ANSWER_LENGTH, index_ASK_QUESTIONS_MAX_QUESTIONS_PER_CALL as ASK_QUESTIONS_MAX_QUESTIONS_PER_CALL, index_ASK_QUESTIONS_MAX_QUESTION_LENGTH as ASK_QUESTIONS_MAX_QUESTION_LENGTH, type index_AskQuestionsOptions as AskQuestionsOptions, type index_AskQuestionsResult as AskQuestionsResult, type index_AskQuestionsType as AskQuestionsType, type index_AudioTranslationOptions as AudioTranslationOptions, type index_AudioTranslationResult as AudioTranslationResult, type index_AutoCensorProfanityOptions as AutoCensorProfanityOptions, type index_BurnedInCaptionsAnalysis as BurnedInCaptionsAnalysis, type index_BurnedInCaptionsOptions as BurnedInCaptionsOptions, type index_BurnedInCaptionsPromptOverrides as BurnedInCaptionsPromptOverrides, type index_BurnedInCaptionsPromptSections as BurnedInCaptionsPromptSections, type index_BurnedInCaptionsResult as BurnedInCaptionsResult, type index_CaptionReplacement as CaptionReplacement, type index_CensorMode as CensorMode, type index_Chapter as Chapter, type index_ChapterSystemPromptSections as ChapterSystemPromptSections, type index_ChaptersOptions as ChaptersOptions, type index_ChaptersPromptOverrides as ChaptersPromptOverrides, type index_ChaptersPromptSections as ChaptersPromptSections, type index_ChaptersResult as ChaptersResult, type index_ChaptersType as ChaptersType, index_DEFAULT_DESCRIPTION_LENGTH as DEFAULT_DESCRIPTION_LENGTH, index_DEFAULT_SUMMARY_KEYWORD_LIMIT as DEFAULT_SUMMARY_KEYWORD_LIMIT, index_DEFAULT_TITLE_LENGTH as DEFAULT_TITLE_LENGTH, index_DEFAULT_TRANSCRIPT_WINDOWING as DEFAULT_TRANSCRIPT_WINDOWING, type index_EditCaptionsOptions as EditCaptionsOptions, type index_EditCaptionsResult as EditCaptionsResult, type index_EmbeddingsOptions as EmbeddingsOptions, type index_EmbeddingsResult as EmbeddingsResult, type index_EngagementInsightsOptions as EngagementInsightsOptions, type index_EngagementInsightsResult as EngagementInsightsResult, index_GENERATE_TEXT_CALLS_TO_ACTION as GENERATE_TEXT_CALLS_TO_ACTION, index_GENERATE_TEXT_CHANNELS as GENERATE_TEXT_CHANNELS, index_GENERATE_TEXT_CHANNEL_CEILINGS as GENERATE_TEXT_CHANNEL_CEILINGS, index_GENERATE_TEXT_FORMATS as GENERATE_TEXT_FORMATS, index_GENERATE_TEXT_LENGTH_BOUNDS as GENERATE_TEXT_LENGTH_BOUNDS, index_GENERATE_TEXT_MAX_ARTIFACTS as GENERATE_TEXT_MAX_ARTIFACTS, index_GENERATE_TEXT_MAX_AUDIENCE_CHARS as GENERATE_TEXT_MAX_AUDIENCE_CHARS, index_GENERATE_TEXT_MAX_BRAND_TERMS as GENERATE_TEXT_MAX_BRAND_TERMS, index_GENERATE_TEXT_MAX_BRAND_TERMS_TOTAL_CHARS as GENERATE_TEXT_MAX_BRAND_TERMS_TOTAL_CHARS, index_GENERATE_TEXT_MAX_BRAND_TERM_CHARS as GENERATE_TEXT_MAX_BRAND_TERM_CHARS, index_GENERATE_TEXT_MAX_CONCURRENT_GENERATIONS as GENERATE_TEXT_MAX_CONCURRENT_GENERATIONS, index_GENERATE_TEXT_MAX_INSTRUCTIONS_CHARS as GENERATE_TEXT_MAX_INSTRUCTIONS_CHARS, index_GENERATE_TEXT_MAX_SHOT_FRAMES as GENERATE_TEXT_MAX_SHOT_FRAMES, index_GENERATE_TEXT_MAX_VARIANTS as GENERATE_TEXT_MAX_VARIANTS, index_GENERATE_TEXT_VOICES as GENERATE_TEXT_VOICES, index_GOOGLE_VISION_LIKELIHOOD_TO_SCORE as GOOGLE_VISION_LIKELIHOOD_TO_SCORE, type index_GenerateTextArtifact as GenerateTextArtifact, type index_GenerateTextCallToAction as GenerateTextCallToAction, type index_GenerateTextChannel as GenerateTextChannel, type index_GenerateTextFormat as GenerateTextFormat, type index_GenerateTextKeyedItem as GenerateTextKeyedItem, type index_GenerateTextLengthLimit as GenerateTextLengthLimit, type index_GenerateTextOptions as GenerateTextOptions, type index_GenerateTextResult as GenerateTextResult, type index_GenerateTextVariant as GenerateTextVariant, type index_GenerateTextVoice as GenerateTextVoice, type index_GeneratedTextArtifact as GeneratedTextArtifact, type index_GeneratedTextVariant as GeneratedTextVariant, index_HIVE_SEXUAL_CATEGORIES as HIVE_SEXUAL_CATEGORIES, index_HIVE_VIOLENCE_CATEGORIES as HIVE_VIOLENCE_CATEGORIES, type index_HiveModerationOutput as HiveModerationOutput, type index_HiveModerationSource as HiveModerationSource, type index_ModerationOptions as ModerationOptions, type index_ModerationProvider as ModerationProvider, type index_ModerationResult as ModerationResult, type index_ModerationSurfaceStatus as ModerationSurfaceStatus, type index_MomentInsight as MomentInsight, type index_OverallInsight as OverallInsight, type index_ProfanityDetectionPayload as ProfanityDetectionPayload, type index_Question as Question, type index_QuestionAnswer as QuestionAnswer, type index_QuestionAnswerType as QuestionAnswerType, type index_RepairAttempt as RepairAttempt, type index_RepairCall as RepairCall, type index_RepairOptions as RepairOptions, type index_RepairPlan as RepairPlan, type index_RepairResult as RepairResult, type index_RepairSpan as RepairSpan, type index_ReplacementRecord as ReplacementRecord, type index_SpeakerReplacement as SpeakerReplacement, type index_StaticRenditionCleanupOutcome as StaticRenditionCleanupOutcome, type index_SummarizationOptions as SummarizationOptions, type index_SummarizationPromptOverrides as SummarizationPromptOverrides, type index_SummarizationPromptSections as SummarizationPromptSections, type index_SummaryAndTagsResult as SummaryAndTagsResult, type index_SummaryType as SummaryType, type index_TextLengthLimit as TextLengthLimit, type index_TextRepairModelOptions as TextRepairModelOptions, type index_ThumbnailModerationScore as ThumbnailModerationScore, type index_ThumbnailModerationSkipReason as ThumbnailModerationSkipReason, type index_ThumbnailModerationStatus as ThumbnailModerationStatus, type index_TranscriptModerationScore as TranscriptModerationScore, type index_TranscriptModerationSkipReason as TranscriptModerationSkipReason, type index_TranscriptModerationStatus as TranscriptModerationStatus, type index_TranslationChunkingOptions as TranslationChunkingOptions, type index_TranslationOptions as TranslationOptions, type index_TranslationPayload as TranslationPayload, type index_TranslationResult as TranslationResult, index_aggregateTokenUsage as aggregateTokenUsage, index_applyOverrideLists as applyOverrideLists, index_applyReplacements as applyReplacements, index_applySpeakerReplacements as applySpeakerReplacements, index_applyTextRepair as applyTextRepair, index_askQuestions as askQuestions, index_buildReplacementRegex as buildReplacementRegex, index_buildTranscriptWindows as buildTranscriptWindows, index_burnedInCaptionsSchema as burnedInCaptionsSchema, index_censorVttContent as censorVttContent, index_chapterSchema as chapterSchema, index_chaptersSchema as chaptersSchema, index_createReplacer as createReplacer, index_createTextRepairGenerator as createTextRepairGenerator, index_editCaptions as editCaptions, index_extractTranscriptSegmentsForHotspots as extractTranscriptSegmentsForHotspots, index_findGenerateTextLengthViolation as findGenerateTextLengthViolation, index_generateChapters as generateChapters, index_generateEmbeddings as generateEmbeddings, index_generateEngagementInsights as generateEngagementInsights, index_generateText as generateText, index_generateVideoEmbeddings as generateVideoEmbeddings, index_getModerationScores as getModerationScores, index_getSummaryAndTags as getSummaryAndTags, index_hasBurnedInCaptions as hasBurnedInCaptions, index_mapShotsToHotspots as mapShotsToHotspots, index_measureGenerateTextLength as measureGenerateTextLength, index_normalizeTranslatedVtt as normalizeTranslatedVtt, index_planTextRepair as planTextRepair, index_profanityDetectionSchema as profanityDetectionSchema, index_questionAnswerSchema as questionAnswerSchema, index_repairJsonSchema as repairJsonSchema, index_repairText as repairText, index_resolveGenerateTextLengthLimit as resolveGenerateTextLengthLimit, index_resolveGenerateTextLengthLimits as resolveGenerateTextLengthLimits, index_resolveGenerateTextOptions as resolveGenerateTextOptions, index_runTextRepairLoop as runTextRepairLoop, index_selectGenerateTextShotFrames as selectGenerateTextShotFrames, index_shouldSplitChunkTranslationError as shouldSplitChunkTranslationError, index_summarySchema as summarySchema, index_transformCueText as transformCueText, index_translateAudio as translateAudio, index_translateCaptions as translateCaptions, index_translationSchema as translationSchema, index_validateNeverTranslateTerms as validateNeverTranslateTerms, index_verifyNeverTranslateTerms as verifyNeverTranslateTerms };
 }
 
-export { type BurnedInCaptionsPromptSections as $, replaceAndCreateTextTrack as A, replaceAndCreateTrack as B, replaceSourceTrack as C, summarizeTextTrack as D, toISO639_1 as E, toISO639_3 as F, validateTrackPassthrough as G, index as H, type ISO639_1 as I, ASK_QUESTIONS_DEFAULT_MAX_ANSWER_OPTION_LENGTH as J, ASK_QUESTIONS_DEFAULT_MAX_FREE_FORM_ANSWER_LENGTH as K, type LanguageCodePair as L, MUX_TRACK_PASSTHROUGH_MAX_CHARS as M, ASK_QUESTIONS_MAX_QUESTIONS_PER_CALL as N, ASK_QUESTIONS_MAX_QUESTION_LENGTH as O, type AskQuestionsOptions as P, type AskQuestionsResult as Q, type ReplaceAndCreateTextTrackInput as R, type SourceTrackReplacementPolicy as S, type TextTrackReplacementPlan as T, type AskQuestionsType as U, type AudioTranslationOptions as V, type AudioTranslationResult as W, type AutoCensorProfanityOptions as X, type BurnedInCaptionsAnalysis as Y, type BurnedInCaptionsOptions as Z, type BurnedInCaptionsPromptOverrides as _, type ISO639_3 as a, type ReplacementRecord as a$, type BurnedInCaptionsResult as a0, type CaptionReplacement as a1, type CensorMode as a2, type Chapter as a3, type ChapterSystemPromptSections as a4, type ChaptersOptions as a5, type ChaptersPromptOverrides as a6, type ChaptersPromptSections as a7, type ChaptersResult as a8, type ChaptersType as a9, type GenerateTextKeyedItem as aA, type GenerateTextLengthLimit as aB, type GenerateTextOptions as aC, type GenerateTextResult as aD, type GenerateTextVariant as aE, type GenerateTextVoice as aF, type GeneratedTextArtifact as aG, type GeneratedTextVariant as aH, HIVE_SEXUAL_CATEGORIES as aI, HIVE_VIOLENCE_CATEGORIES as aJ, type HiveModerationOutput as aK, type HiveModerationSource as aL, type ModerationOptions as aM, type ModerationProvider as aN, type ModerationResult as aO, type MomentInsight as aP, type OverallInsight as aQ, type ProfanityDetectionPayload as aR, type Question as aS, type QuestionAnswer as aT, type QuestionAnswerType as aU, type RepairAttempt as aV, type RepairCall as aW, type RepairOptions as aX, type RepairPlan as aY, type RepairResult as aZ, type RepairSpan as a_, type EditCaptionsOptions as aa, type EditCaptionsResult as ab, type EmbeddingsOptions as ac, type EmbeddingsResult as ad, type EngagementInsightsOptions as ae, type EngagementInsightsResult as af, GENERATE_TEXT_CALLS_TO_ACTION as ag, GENERATE_TEXT_CHANNELS as ah, GENERATE_TEXT_CHANNEL_CEILINGS as ai, GENERATE_TEXT_FORMATS as aj, GENERATE_TEXT_LENGTH_BOUNDS as ak, GENERATE_TEXT_MAX_ARTIFACTS as al, GENERATE_TEXT_MAX_AUDIENCE_CHARS as am, GENERATE_TEXT_MAX_BRAND_TERMS as an, GENERATE_TEXT_MAX_BRAND_TERMS_TOTAL_CHARS as ao, GENERATE_TEXT_MAX_BRAND_TERM_CHARS as ap, GENERATE_TEXT_MAX_CONCURRENT_GENERATIONS as aq, GENERATE_TEXT_MAX_INSTRUCTIONS_CHARS as ar, GENERATE_TEXT_MAX_SHOT_FRAMES as as, GENERATE_TEXT_MAX_VARIANTS as at, GENERATE_TEXT_VOICES as au, GOOGLE_VISION_LIKELIHOOD_TO_SCORE as av, type GenerateTextArtifact as aw, type GenerateTextCallToAction as ax, type GenerateTextChannel as ay, type GenerateTextFormat as az, type ReplaceAndCreateTextTrackResult as b, type SpeakerReplacement as b0, type StaticRenditionCleanupOutcome as b1, type SummarizationOptions as b2, type SummarizationPromptOverrides as b3, type SummarizationPromptSections as b4, type SummaryAndTagsResult as b5, type SummaryType as b6, type TextLengthLimit as b7, type TextRepairModelOptions as b8, type ThumbnailModerationScore as b9, getSummaryAndTags as bA, hasBurnedInCaptions as bB, mapShotsToHotspots as bC, measureGenerateTextLength as bD, normalizeTranslatedVtt as bE, planTextRepair as bF, profanityDetectionSchema as bG, questionAnswerSchema as bH, repairJsonSchema as bI, repairText as bJ, resolveGenerateTextLengthLimit as bK, resolveGenerateTextLengthLimits as bL, resolveGenerateTextOptions as bM, runTextRepairLoop as bN, selectGenerateTextShotFrames as bO, shouldSplitChunkTranslationError as bP, summarySchema as bQ, transformCueText as bR, translateAudio as bS, translateCaptions as bT, translationSchema as bU, validateNeverTranslateTerms as bV, verifyNeverTranslateTerms as bW, type TranslationChunkingOptions as ba, type TranslationOptions as bb, type TranslationPayload as bc, type TranslationResult as bd, aggregateTokenUsage as be, applyOverrideLists as bf, applyReplacements as bg, applySpeakerReplacements as bh, applyTextRepair as bi, askQuestions as bj, buildReplacementRegex as bk, burnedInCaptionsSchema as bl, censorVttContent as bm, chapterSchema as bn, chaptersSchema as bo, createReplacer as bp, createTextRepairGenerator as bq, editCaptions as br, extractTranscriptSegmentsForHotspots as bs, findGenerateTextLengthViolation as bt, generateChapters as bu, generateEmbeddings as bv, generateEngagementInsights as bw, generateText as bx, generateVideoEmbeddings as by, getModerationScores as bz, type ReplaceAndCreateTrackInput as c, type ReplaceExistingTracksPolicy as d, type ReplaceSourceTrackInput as e, type ReplaceableTrackType as f, type SupportedISO639_1 as g, type SupportedISO639_3 as h, type TextTrackSummary as i, type TextTrackTarget as j, type TrackSummary as k, type TrackTarget as l, buildMuxAiTrackPassthrough as m, findNameCollisionTextTracks as n, findSameLanguageTextTracks as o, getLanguageCodePair as p, getLanguageName as q, isDuplicateTrackNameError as r, isMuxGeneratedTextTrack as s, isUndeterminedLanguageCode as t, isValidISO639_1 as u, isValidISO639_3 as v, normalizeTrackLanguageCode as w, normalizeTrackName as x, planSourceTrackReplacement as y, planTextTrackReplacement as z };
+export { type BurnedInCaptionsPromptSections as $, replaceAndCreateTextTrack as A, replaceAndCreateTrack as B, replaceSourceTrack as C, summarizeTextTrack as D, toISO639_1 as E, toISO639_3 as F, validateTrackPassthrough as G, index as H, type ISO639_1 as I, ASK_QUESTIONS_DEFAULT_MAX_ANSWER_OPTION_LENGTH as J, ASK_QUESTIONS_DEFAULT_MAX_FREE_FORM_ANSWER_LENGTH as K, type LanguageCodePair as L, MUX_TRACK_PASSTHROUGH_MAX_CHARS as M, ASK_QUESTIONS_MAX_QUESTIONS_PER_CALL as N, ASK_QUESTIONS_MAX_QUESTION_LENGTH as O, type AskQuestionsOptions as P, type AskQuestionsResult as Q, type ReplaceAndCreateTextTrackInput as R, type SourceTrackReplacementPolicy as S, type TextTrackReplacementPlan as T, type AskQuestionsType as U, type AudioTranslationOptions as V, type AudioTranslationResult as W, type AutoCensorProfanityOptions as X, type BurnedInCaptionsAnalysis as Y, type BurnedInCaptionsOptions as Z, type BurnedInCaptionsPromptOverrides as _, type ISO639_3 as a, type RepairResult as a$, type BurnedInCaptionsResult as a0, type CaptionReplacement as a1, type CensorMode as a2, type Chapter as a3, type ChapterSystemPromptSections as a4, type ChaptersOptions as a5, type ChaptersPromptOverrides as a6, type ChaptersPromptSections as a7, type ChaptersResult as a8, type ChaptersType as a9, type GenerateTextFormat as aA, type GenerateTextKeyedItem as aB, type GenerateTextLengthLimit as aC, type GenerateTextOptions as aD, type GenerateTextResult as aE, type GenerateTextVariant as aF, type GenerateTextVoice as aG, type GeneratedTextArtifact as aH, type GeneratedTextVariant as aI, HIVE_SEXUAL_CATEGORIES as aJ, HIVE_VIOLENCE_CATEGORIES as aK, type HiveModerationOutput as aL, type HiveModerationSource as aM, type ModerationOptions as aN, type ModerationProvider as aO, type ModerationResult as aP, type ModerationSurfaceStatus as aQ, type MomentInsight as aR, type OverallInsight as aS, type ProfanityDetectionPayload as aT, type Question as aU, type QuestionAnswer as aV, type QuestionAnswerType as aW, type RepairAttempt as aX, type RepairCall as aY, type RepairOptions as aZ, type RepairPlan as a_, DEFAULT_TRANSCRIPT_WINDOWING as aa, type EditCaptionsOptions as ab, type EditCaptionsResult as ac, type EmbeddingsOptions as ad, type EmbeddingsResult as ae, type EngagementInsightsOptions as af, type EngagementInsightsResult as ag, GENERATE_TEXT_CALLS_TO_ACTION as ah, GENERATE_TEXT_CHANNELS as ai, GENERATE_TEXT_CHANNEL_CEILINGS as aj, GENERATE_TEXT_FORMATS as ak, GENERATE_TEXT_LENGTH_BOUNDS as al, GENERATE_TEXT_MAX_ARTIFACTS as am, GENERATE_TEXT_MAX_AUDIENCE_CHARS as an, GENERATE_TEXT_MAX_BRAND_TERMS as ao, GENERATE_TEXT_MAX_BRAND_TERMS_TOTAL_CHARS as ap, GENERATE_TEXT_MAX_BRAND_TERM_CHARS as aq, GENERATE_TEXT_MAX_CONCURRENT_GENERATIONS as ar, GENERATE_TEXT_MAX_INSTRUCTIONS_CHARS as as, GENERATE_TEXT_MAX_SHOT_FRAMES as at, GENERATE_TEXT_MAX_VARIANTS as au, GENERATE_TEXT_VOICES as av, GOOGLE_VISION_LIKELIHOOD_TO_SCORE as aw, type GenerateTextArtifact as ax, type GenerateTextCallToAction as ay, type GenerateTextChannel as az, type ReplaceAndCreateTextTrackResult as b, translateCaptions as b$, type RepairSpan as b0, type ReplacementRecord as b1, type SpeakerReplacement as b2, type StaticRenditionCleanupOutcome as b3, type SummarizationOptions as b4, type SummarizationPromptOverrides as b5, type SummarizationPromptSections as b6, type SummaryAndTagsResult as b7, type SummaryType as b8, type TextLengthLimit as b9, extractTranscriptSegmentsForHotspots as bA, findGenerateTextLengthViolation as bB, generateChapters as bC, generateEmbeddings as bD, generateEngagementInsights as bE, generateText as bF, generateVideoEmbeddings as bG, getModerationScores as bH, getSummaryAndTags as bI, hasBurnedInCaptions as bJ, mapShotsToHotspots as bK, measureGenerateTextLength as bL, normalizeTranslatedVtt as bM, planTextRepair as bN, profanityDetectionSchema as bO, questionAnswerSchema as bP, repairJsonSchema as bQ, repairText as bR, resolveGenerateTextLengthLimit as bS, resolveGenerateTextLengthLimits as bT, resolveGenerateTextOptions as bU, runTextRepairLoop as bV, selectGenerateTextShotFrames as bW, shouldSplitChunkTranslationError as bX, summarySchema as bY, transformCueText as bZ, translateAudio as b_, type TextRepairModelOptions as ba, type ThumbnailModerationScore as bb, type ThumbnailModerationSkipReason as bc, type ThumbnailModerationStatus as bd, type TranscriptModerationScore as be, type TranscriptModerationSkipReason as bf, type TranscriptModerationStatus as bg, type TranslationChunkingOptions as bh, type TranslationOptions as bi, type TranslationPayload as bj, type TranslationResult as bk, aggregateTokenUsage as bl, applyOverrideLists as bm, applyReplacements as bn, applySpeakerReplacements as bo, applyTextRepair as bp, askQuestions as bq, buildReplacementRegex as br, buildTranscriptWindows as bs, burnedInCaptionsSchema as bt, censorVttContent as bu, chapterSchema as bv, chaptersSchema as bw, createReplacer as bx, createTextRepairGenerator as by, editCaptions as bz, type ReplaceAndCreateTrackInput as c, translationSchema as c0, validateNeverTranslateTerms as c1, verifyNeverTranslateTerms as c2, type ReplaceExistingTracksPolicy as d, type ReplaceSourceTrackInput as e, type ReplaceableTrackType as f, type SupportedISO639_1 as g, type SupportedISO639_3 as h, type TextTrackSummary as i, type TextTrackTarget as j, type TrackSummary as k, type TrackTarget as l, buildMuxAiTrackPassthrough as m, findNameCollisionTextTracks as n, findSameLanguageTextTracks as o, getLanguageCodePair as p, getLanguageName as q, isDuplicateTrackNameError as r, isMuxGeneratedTextTrack as s, isUndeterminedLanguageCode as t, isValidISO639_1 as u, isValidISO639_3 as v, normalizeTrackLanguageCode as w, normalizeTrackName as x, planSourceTrackReplacement as y, planTextTrackReplacement as z };

package/dist/index-cbaPe-aE.d.ts

@@ -0,0 +1,225 @@
+import { l as WorkflowCredentialsInput, n as WorkflowScope, T as TextChunk, b as ChunkingStrategy, q as VTTCue, r as CompletedShotsResult, D as DeletedShotsResult, s as ErroredShotsResult, H as Hotspot, t as HotspotOptions, u as HotspotResponse, L as LOW_CONFIDENCE_THRESHOLD, v as MAX_CUE_TEXT_CHARS, w as ParseVTTCuesOptions, x as PendingShotsResult, y as Shot, z as ShotRequestOptions, B as ShotsResult, F as SkippedShotsResult, G as TranscriptEmptyReason, J as TranscriptFetchOptions, K as TranscriptFetchStepResult, N as TranscriptResult, O as WaitForShotsOptions, Q as buildTranscriptUrl, R as buildVttFromCueBlocks, X as buildVttFromTranslatedCueBlocks, Y as concatenateVttSegments, Z as extractTextFromVTT, _ as extractTimestampedTranscript, $ as fetchTranscriptDataForUrl, a0 as fetchTranscriptForAsset, a1 as filterVttByScope, a2 as findCaptionTrack, a3 as getHotspotsForAsset, a4 as getHotspotsForPlaybackId, a5 as getHotspotsForVideo, a6 as getReadyTextTracks, a7 as getReliableLanguageCode, a8 as getShotsForAsset, a9 as parseVTTCues, aa as replaceCueText, ab as requestShotsForAsset, ac as sanitizeUntrustedText, ad as secondsToTimestamp, ae as splitVttPreambleAndCueBlocks, af as stripVttMetadataBlocks, ag as vttTimestampToSeconds, ah as waitForShotsForAsset } from './transcripts-BCtzC8hZ.js';
+
+interface HeatmapOptions {
+    /** Time window for results, e.g., '7:days' (default: '7:days') */
+    timeframe?: string;
+    /** Optional workflow credentials */
+    credentials?: WorkflowCredentialsInput;
+}
+interface HeatmapResponse {
+    assetId?: string;
+    videoId?: string;
+    playbackId?: string;
+    /** Engagement values across the video timeline, one per equal slice (currently 100) */
+    heatmap: number[];
+    timeframe: [number, number];
+}
+/**
+ * Fetches engagement heatmap for a Mux asset.
+ * Returns an array where each value represents how many times
+ * that slice of the video was watched.
+ *
+ * @param assetId - The Mux asset ID
+ * @param options - Heatmap query options
+ * @returns Heatmap data with per-bucket engagement values
+ */
+declare function getHeatmapForAsset(assetId: string, options?: HeatmapOptions): Promise<HeatmapResponse>;
+/**
+ * Fetches engagement heatmap for a Mux video ID.
+ * Returns an array where each value represents how many times
+ * that slice of the video was watched.
+ *
+ * @param videoId - The Mux video ID
+ * @param options - Heatmap query options
+ * @returns Heatmap data with per-bucket engagement values
+ */
+declare function getHeatmapForVideo(videoId: string, options?: HeatmapOptions): Promise<HeatmapResponse>;
+/**
+ * Fetches engagement heatmap for a Mux playback ID.
+ * Returns an array where each value represents how many times
+ * that slice of the video was watched.
+ *
+ * @param playbackId - The Mux playback ID
+ * @param options - Heatmap query options
+ * @returns Heatmap data with per-bucket engagement values
+ */
+declare function getHeatmapForPlaybackId(playbackId: string, options?: HeatmapOptions): Promise<HeatmapResponse>;
+
+declare const DEFAULT_STORYBOARD_WIDTH = 640;
+/**
+ * Generates a storyboard URL for the given playback ID.
+ * If shouldSign is true, the URL will be signed with a token using credentials from environment variables.
+ *
+ * @param playbackId - The Mux playback ID
+ * @param width - Width of the storyboard in pixels (default: 640)
+ * @param shouldSign - Flag for whether or not to use signed playback IDs (default: false)
+ * @param credentials - Optional workflow credentials used for signing
+ * @param scope - Optional asset-relative range for storyboard tiles
+ * @returns Storyboard URL (signed if shouldSign is true)
+ */
+declare function getStoryboardUrl(playbackId: string, width?: number, shouldSign?: boolean, credentials?: WorkflowCredentialsInput, scope?: WorkflowScope): Promise<string>;
+
+/**
+ * Generic text-first chunking utilities.
+ *
+ * Reach for this module when the downstream consumer only needs chunk text plus
+ * lightweight metadata such as token count or approximate start/end times.
+ * These helpers are ideal for embeddings, retrieval, summarization inputs, or
+ * other workflows where preserving the original document format is not required.
+ *
+ * This module also includes cue-preserving chunk planners for VTT workflows.
+ * Those helpers still operate at the chunk-planning layer; if you need to split
+ * or rebuild full VTT documents, use the VTT structure helpers from
+ * `@mux/ai/primitives/transcripts`.
+ */
+interface VTTDurationChunkingOptions {
+    targetChunkDurationSeconds: number;
+    maxChunkDurationSeconds: number;
+    minChunkDurationSeconds?: number;
+    boundaryLookaheadCues?: number;
+    boundaryPauseSeconds?: number;
+}
+interface VTTCueBudgetChunkingOptions {
+    maxCuesPerChunk: number;
+    maxTextTokensPerChunk?: number;
+}
+interface VTTDurationChunk {
+    id: string;
+    cueStartIndex: number;
+    cueEndIndex: number;
+    cueCount: number;
+    startTime: number;
+    endTime: number;
+}
+/**
+ * Simple token counter that approximates tokens by word count.
+ * For production use with OpenAI, consider using a proper tokenizer like tiktoken.
+ * This approximation is generally close enough for chunking purposes (1 token ≈ 0.75 words).
+ */
+declare function estimateTokenCount(text: string): number;
+/**
+ * Chunks text into overlapping segments based on token count.
+ *
+ * @param text - The text to chunk
+ * @param maxTokens - Maximum tokens per chunk
+ * @param overlapTokens - Number of tokens to overlap between chunks
+ * @returns Array of text chunks with metadata
+ */
+declare function chunkByTokens(text: string, maxTokens: number, overlapTokens?: number): TextChunk[];
+/**
+ * Chunks VTT cues into groups that respect natural cue boundaries.
+ * Splits at cue boundaries rather than mid-sentence, preserving accurate timestamps.
+ *
+ * @param cues - Array of VTT cues to chunk
+ * @param maxTokens - Maximum tokens per chunk
+ * @param overlapCues - Number of cues to overlap between chunks (default: 2)
+ * @returns Array of text chunks with accurate start/end times
+ */
+declare function chunkVTTCues(cues: VTTCue[], maxTokens: number, overlapCues?: number): TextChunk[];
+declare function chunkVTTCuesByBudget(cues: VTTCue[], options: VTTCueBudgetChunkingOptions): VTTDurationChunk[];
+declare function chunkVTTCuesByDuration(cues: VTTCue[], options: VTTDurationChunkingOptions): VTTDurationChunk[];
+/**
+ * Chunks text according to the specified strategy.
+ *
+ * @param text - The text to chunk
+ * @param strategy - The chunking strategy to use
+ * @returns Array of text chunks
+ */
+declare function chunkText(text: string, strategy: ChunkingStrategy): TextChunk[];
+
+interface ThumbnailOptions {
+    /** Interval between thumbnails in seconds (default: 10) */
+    interval?: number;
+    /** Width of the thumbnail in pixels (default: 640) */
+    width?: number;
+    /** Flag for whether or not to use signed playback IDs (default: false) */
+    shouldSign?: boolean;
+    /** Maximum number of thumbnails to generate. When set, samples are evenly distributed with first and last frames pinned. */
+    maxSamples?: number;
+    /** Workflow credentials for signing (optional). */
+    credentials?: WorkflowCredentialsInput;
+    /** Optional asset-relative range from which thumbnails should be sampled. */
+    scope?: WorkflowScope;
+}
+/**
+ * Generates thumbnail URLs at regular intervals based on video duration.
+ * If shouldSign is true, the URLs will be signed with tokens using credentials from environment variables.
+ *
+ * @param playbackId - The Mux playback ID
+ * @param duration - Video duration in seconds
+ * @param options - Thumbnail generation options
+ * @returns Array of objects containing the thumbnail URL and its time in seconds
+ */
+declare function getThumbnailUrls(playbackId: string, duration: number, options?: ThumbnailOptions): Promise<Array<{
+    url: string;
+    time: number;
+}>>;
+
+declare const index_CompletedShotsResult: typeof CompletedShotsResult;
+declare const index_DEFAULT_STORYBOARD_WIDTH: typeof DEFAULT_STORYBOARD_WIDTH;
+declare const index_DeletedShotsResult: typeof DeletedShotsResult;
+declare const index_ErroredShotsResult: typeof ErroredShotsResult;
+type index_HeatmapOptions = HeatmapOptions;
+type index_HeatmapResponse = HeatmapResponse;
+declare const index_Hotspot: typeof Hotspot;
+declare const index_HotspotOptions: typeof HotspotOptions;
+declare const index_HotspotResponse: typeof HotspotResponse;
+declare const index_LOW_CONFIDENCE_THRESHOLD: typeof LOW_CONFIDENCE_THRESHOLD;
+declare const index_MAX_CUE_TEXT_CHARS: typeof MAX_CUE_TEXT_CHARS;
+declare const index_ParseVTTCuesOptions: typeof ParseVTTCuesOptions;
+declare const index_PendingShotsResult: typeof PendingShotsResult;
+declare const index_Shot: typeof Shot;
+declare const index_ShotRequestOptions: typeof ShotRequestOptions;
+declare const index_ShotsResult: typeof ShotsResult;
+declare const index_SkippedShotsResult: typeof SkippedShotsResult;
+type index_ThumbnailOptions = ThumbnailOptions;
+declare const index_TranscriptEmptyReason: typeof TranscriptEmptyReason;
+declare const index_TranscriptFetchOptions: typeof TranscriptFetchOptions;
+declare const index_TranscriptFetchStepResult: typeof TranscriptFetchStepResult;
+declare const index_TranscriptResult: typeof TranscriptResult;
+declare const index_VTTCue: typeof VTTCue;
+type index_VTTCueBudgetChunkingOptions = VTTCueBudgetChunkingOptions;
+type index_VTTDurationChunk = VTTDurationChunk;
+type index_VTTDurationChunkingOptions = VTTDurationChunkingOptions;
+declare const index_WaitForShotsOptions: typeof WaitForShotsOptions;
+declare const index_buildTranscriptUrl: typeof buildTranscriptUrl;
+declare const index_buildVttFromCueBlocks: typeof buildVttFromCueBlocks;
+declare const index_buildVttFromTranslatedCueBlocks: typeof buildVttFromTranslatedCueBlocks;
+declare const index_chunkByTokens: typeof chunkByTokens;
+declare const index_chunkText: typeof chunkText;
+declare const index_chunkVTTCues: typeof chunkVTTCues;
+declare const index_chunkVTTCuesByBudget: typeof chunkVTTCuesByBudget;
+declare const index_chunkVTTCuesByDuration: typeof chunkVTTCuesByDuration;
+declare const index_concatenateVttSegments: typeof concatenateVttSegments;
+declare const index_estimateTokenCount: typeof estimateTokenCount;
+declare const index_extractTextFromVTT: typeof extractTextFromVTT;
+declare const index_extractTimestampedTranscript: typeof extractTimestampedTranscript;
+declare const index_fetchTranscriptDataForUrl: typeof fetchTranscriptDataForUrl;
+declare const index_fetchTranscriptForAsset: typeof fetchTranscriptForAsset;
+declare const index_filterVttByScope: typeof filterVttByScope;
+declare const index_findCaptionTrack: typeof findCaptionTrack;
+declare const index_getHeatmapForAsset: typeof getHeatmapForAsset;
+declare const index_getHeatmapForPlaybackId: typeof getHeatmapForPlaybackId;
+declare const index_getHeatmapForVideo: typeof getHeatmapForVideo;
+declare const index_getHotspotsForAsset: typeof getHotspotsForAsset;
+declare const index_getHotspotsForPlaybackId: typeof getHotspotsForPlaybackId;
+declare const index_getHotspotsForVideo: typeof getHotspotsForVideo;
+declare const index_getReadyTextTracks: typeof getReadyTextTracks;
+declare const index_getReliableLanguageCode: typeof getReliableLanguageCode;
+declare const index_getShotsForAsset: typeof getShotsForAsset;
+declare const index_getStoryboardUrl: typeof getStoryboardUrl;
+declare const index_getThumbnailUrls: typeof getThumbnailUrls;
+declare const index_parseVTTCues: typeof parseVTTCues;
+declare const index_replaceCueText: typeof replaceCueText;
+declare const index_requestShotsForAsset: typeof requestShotsForAsset;
+declare const index_sanitizeUntrustedText: typeof sanitizeUntrustedText;
+declare const index_secondsToTimestamp: typeof secondsToTimestamp;
+declare const index_splitVttPreambleAndCueBlocks: typeof splitVttPreambleAndCueBlocks;
+declare const index_stripVttMetadataBlocks: typeof stripVttMetadataBlocks;
+declare const index_vttTimestampToSeconds: typeof vttTimestampToSeconds;
+declare const index_waitForShotsForAsset: typeof waitForShotsForAsset;
+declare namespace index {
+  export { index_CompletedShotsResult as CompletedShotsResult, index_DEFAULT_STORYBOARD_WIDTH as DEFAULT_STORYBOARD_WIDTH, index_DeletedShotsResult as DeletedShotsResult, index_ErroredShotsResult as ErroredShotsResult, type index_HeatmapOptions as HeatmapOptions, type index_HeatmapResponse as HeatmapResponse, index_Hotspot as Hotspot, index_HotspotOptions as HotspotOptions, index_HotspotResponse as HotspotResponse, index_LOW_CONFIDENCE_THRESHOLD as LOW_CONFIDENCE_THRESHOLD, index_MAX_CUE_TEXT_CHARS as MAX_CUE_TEXT_CHARS, index_ParseVTTCuesOptions as ParseVTTCuesOptions, index_PendingShotsResult as PendingShotsResult, index_Shot as Shot, index_ShotRequestOptions as ShotRequestOptions, index_ShotsResult as ShotsResult, index_SkippedShotsResult as SkippedShotsResult, type index_ThumbnailOptions as ThumbnailOptions, index_TranscriptEmptyReason as TranscriptEmptyReason, index_TranscriptFetchOptions as TranscriptFetchOptions, index_TranscriptFetchStepResult as TranscriptFetchStepResult, index_TranscriptResult as TranscriptResult, index_VTTCue as VTTCue, type index_VTTCueBudgetChunkingOptions as VTTCueBudgetChunkingOptions, type index_VTTDurationChunk as VTTDurationChunk, type index_VTTDurationChunkingOptions as VTTDurationChunkingOptions, index_WaitForShotsOptions as WaitForShotsOptions, index_buildTranscriptUrl as buildTranscriptUrl, index_buildVttFromCueBlocks as buildVttFromCueBlocks, index_buildVttFromTranslatedCueBlocks as buildVttFromTranslatedCueBlocks, index_chunkByTokens as chunkByTokens, index_chunkText as chunkText, index_chunkVTTCues as chunkVTTCues, index_chunkVTTCuesByBudget as chunkVTTCuesByBudget, index_chunkVTTCuesByDuration as chunkVTTCuesByDuration, index_concatenateVttSegments as concatenateVttSegments, index_estimateTokenCount as estimateTokenCount, index_extractTextFromVTT as extractTextFromVTT, index_extractTimestampedTranscript as extractTimestampedTranscript, index_fetchTranscriptDataForUrl as fetchTranscriptDataForUrl, index_fetchTranscriptForAsset as fetchTranscriptForAsset, index_filterVttByScope as filterVttByScope, index_findCaptionTrack as findCaptionTrack, index_getHeatmapForAsset as getHeatmapForAsset, index_getHeatmapForPlaybackId as getHeatmapForPlaybackId, index_getHeatmapForVideo as getHeatmapForVideo, index_getHotspotsForAsset as getHotspotsForAsset, index_getHotspotsForPlaybackId as getHotspotsForPlaybackId, index_getHotspotsForVideo as getHotspotsForVideo, index_getReadyTextTracks as getReadyTextTracks, index_getReliableLanguageCode as getReliableLanguageCode, index_getShotsForAsset as getShotsForAsset, index_getStoryboardUrl as getStoryboardUrl, index_getThumbnailUrls as getThumbnailUrls, index_parseVTTCues as parseVTTCues, index_replaceCueText as replaceCueText, index_requestShotsForAsset as requestShotsForAsset, index_sanitizeUntrustedText as sanitizeUntrustedText, index_secondsToTimestamp as secondsToTimestamp, index_splitVttPreambleAndCueBlocks as splitVttPreambleAndCueBlocks, index_stripVttMetadataBlocks as stripVttMetadataBlocks, index_vttTimestampToSeconds as vttTimestampToSeconds, index_waitForShotsForAsset as waitForShotsForAsset };
+}
+
+export { DEFAULT_STORYBOARD_WIDTH as D, type HeatmapOptions as H, type ThumbnailOptions as T, type VTTCueBudgetChunkingOptions as V, type HeatmapResponse as a, type VTTDurationChunk as b, type VTTDurationChunkingOptions as c, chunkByTokens as d, chunkText as e, chunkVTTCues as f, chunkVTTCuesByBudget as g, chunkVTTCuesByDuration as h, index as i, estimateTokenCount as j, getHeatmapForAsset as k, getHeatmapForPlaybackId as l, getHeatmapForVideo as m, getStoryboardUrl as n, getThumbnailUrls as o };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-export { I as ISO639_1, a as ISO639_3, L as LanguageCodePair, M as MUX_TRACK_PASSTHROUGH_MAX_CHARS, R as ReplaceAndCreateTextTrackInput, b as ReplaceAndCreateTextTrackResult, c as ReplaceAndCreateTrackInput, d as ReplaceExistingTracksPolicy, e as ReplaceSourceTrackInput, f as ReplaceableTrackType, S as SourceTrackReplacementPolicy, g as SupportedISO639_1, h as SupportedISO639_3, T as TextTrackReplacementPlan, i as TextTrackSummary, j as TextTrackTarget, k as TrackSummary, l as TrackTarget, m as buildMuxAiTrackPassthrough, n as findNameCollisionTextTracks, o as findSameLanguageTextTracks, p as getLanguageCodePair, q as getLanguageName, r as isDuplicateTrackNameError, s as isMuxGeneratedTextTrack, t as isUndeterminedLanguageCode, u as isValidISO639_1, v as isValidISO639_3, w as normalizeTrackLanguageCode, x as normalizeTrackName, y as planSourceTrackReplacement, z as planTextTrackReplacement, A as replaceAndCreateTextTrack, B as replaceAndCreateTrack, C as replaceSourceTrack, D as summarizeTextTrack, E as toISO639_1, F as toISO639_3, G as validateTrackPassthrough, H as workflows } from './index-sqJ9PpHw.js';
-import { M as MuxAsset, W as WorkflowCredentials, S as StoragePutObjectInput, a as StoragePresignGetObjectInput } from './shots-3wmvZnUV.js';
-export { A as AssetTextTrack, C as ChunkEmbedding, b as ChunkingStrategy, E as Encrypted, c as EncryptedPayload, I as ImageSubmissionMode, d as MuxAIOptions, P as PlaybackAsset, e as PlaybackPolicy, f as ScopedMuxAIOptions, g as StorageAdapter, T as TextChunk, h as TokenChunkingConfig, i as TokenUsage, j as ToneType, U as UsageMetadata, V as VTTChunkingConfig, k as VideoEmbeddingsResult, l as WorkflowCredentialsInput, m as WorkflowMuxClient, n as WorkflowScope, o as decryptFromWorkflow, p as encryptForWorkflow } from './shots-3wmvZnUV.js';
+export { I as ISO639_1, a as ISO639_3, L as LanguageCodePair, M as MUX_TRACK_PASSTHROUGH_MAX_CHARS, R as ReplaceAndCreateTextTrackInput, b as ReplaceAndCreateTextTrackResult, c as ReplaceAndCreateTrackInput, d as ReplaceExistingTracksPolicy, e as ReplaceSourceTrackInput, f as ReplaceableTrackType, S as SourceTrackReplacementPolicy, g as SupportedISO639_1, h as SupportedISO639_3, T as TextTrackReplacementPlan, i as TextTrackSummary, j as TextTrackTarget, k as TrackSummary, l as TrackTarget, m as buildMuxAiTrackPassthrough, n as findNameCollisionTextTracks, o as findSameLanguageTextTracks, p as getLanguageCodePair, q as getLanguageName, r as isDuplicateTrackNameError, s as isMuxGeneratedTextTrack, t as isUndeterminedLanguageCode, u as isValidISO639_1, v as isValidISO639_3, w as normalizeTrackLanguageCode, x as normalizeTrackName, y as planSourceTrackReplacement, z as planTextTrackReplacement, A as replaceAndCreateTextTrack, B as replaceAndCreateTrack, C as replaceSourceTrack, D as summarizeTextTrack, E as toISO639_1, F as toISO639_3, G as validateTrackPassthrough, H as workflows } from './index-BbxJ0X25.js';
+import { M as MuxAsset, W as WorkflowCredentials, S as StoragePutObjectInput, a as StoragePresignGetObjectInput } from './transcripts-BCtzC8hZ.js';
+export { A as AssetTextTrack, C as ChunkEmbedding, b as ChunkingStrategy, E as Encrypted, c as EncryptedPayload, I as ImageSubmissionMode, d as MuxAIOptions, P as PlaybackAsset, e as PlaybackPolicy, f as ScopedMuxAIOptions, g as StorageAdapter, T as TextChunk, h as TokenChunkingConfig, i as TokenUsage, j as ToneType, U as UsageMetadata, V as VTTChunkingConfig, k as VideoEmbeddingsResult, l as WorkflowCredentialsInput, m as WorkflowMuxClient, n as WorkflowScope, o as decryptFromWorkflow, p as encryptForWorkflow } from './transcripts-BCtzC8hZ.js';
 import { WORKFLOW_SERIALIZE, WORKFLOW_DESERIALIZE } from '@workflow/serde';
-export { i as primitives } from './index-nu1UOAMW.js';
+export { i as primitives } from './index-cbaPe-aE.js';
 import 'ai';
 import 'zod';
 import './summarization-BFmhXeAu.js';
@@ -11,7 +11,7 @@ import '@ai-sdk/google';
 import '@ai-sdk/openai';
 import '@mux/ts';
 
-var version = "0.52.0";
+var version = "0.53.0";
 
 type MuxAiErrorType = "validation_error" | "processing_error" | "timeout_error" | "content_policy_error";
 /**
@@ -36,9 +36,12 @@ declare class MuxAiError extends Error {
     readonly publicMessage: string;
     /** Whether the customer should retry the job. */
     readonly retryable: boolean;
+    /** Internal diagnostic failure; non-enumerable and excluded from JSON. */
+    readonly cause?: unknown;
     constructor(message: string, opts?: {
         type?: MuxAiErrorType;
         retryable?: boolean;
+        cause?: unknown;
     });
     static is(value: unknown): value is MuxAiError;
 }