@mux/ai 0.8.2 → 0.9.0

package/dist/{index-DP02N3iR.d.ts → index-CkJStzYO.d.ts}

@@ -334,6 +334,12 @@ interface ChaptersOptions extends MuxAIOptions {
      * Defaults to 8.
      */
     maxChaptersPerHour?: number;
+    /**
+     * BCP 47 language code for chapter titles (e.g. "en", "fr", "ja").
+     * When omitted, auto-detects from the transcript track's language.
+     * Falls back to unconstrained (LLM decides) if no language metadata is available.
+     */
+    outputLanguageCode?: string;
 }
 /**
  * Sections of the chaptering system prompt that can be overridden.
@@ -529,6 +535,12 @@ interface SummarizationOptions extends MuxAIOptions {
     descriptionLength?: number;
     /** Desired number of tags. */
     tagCount?: number;
+    /**
+     * BCP 47 language code for the output (e.g. "en", "fr", "ja").
+     * When omitted, auto-detects from the transcript track's language.
+     * Falls back to unconstrained (LLM decides) if no language metadata is available.
+     */
+    outputLanguageCode?: string;
 }
 declare function getSummaryAndTags(assetId: string, options?: SummarizationOptions): Promise<SummaryAndTagsResult>;
 

package/dist/index.d.ts

@@ -2,14 +2,14 @@ import { W as WorkflowCredentials, S as StoragePutObjectInput, a as StoragePresi
 export { A as AssetTextTrack, C as ChunkEmbedding, b as ChunkingStrategy, E as Encrypted, c as EncryptedPayload, I as ImageSubmissionMode, M as MuxAIOptions, d as MuxAsset, P as PlaybackAsset, e as PlaybackPolicy, f as StorageAdapter, T as TextChunk, g as TokenChunkingConfig, h as TokenUsage, i as ToneType, U as UsageMetadata, V as VTTChunkingConfig, j as VideoEmbeddingsResult, k as WorkflowCredentialsInput, l as WorkflowMuxClient, m as decryptFromWorkflow, n as encryptForWorkflow } from './types-BRbaGW3t.js';
 import { WORKFLOW_SERIALIZE, WORKFLOW_DESERIALIZE } from '@workflow/serde';
 export { i as primitives } from './index-Nxf6BaBO.js';
-export { i as workflows } from './index-DP02N3iR.js';
+export { i as workflows } from './index-CkJStzYO.js';
 import '@mux/mux-node';
 import 'zod';
 import '@ai-sdk/anthropic';
 import '@ai-sdk/google';
 import '@ai-sdk/openai';
 
-var version = "0.8.2";
+var version = "0.9.0";
 
 /**
  * A function that returns workflow credentials, either synchronously or asynchronously.

package/dist/index.js

@@ -5,7 +5,7 @@ var __export = (target, all) => {
 };
 
 // package.json
-var version = "0.8.2";
+var version = "0.9.0";
 
 // src/env.ts
 import { z } from "zod";
@@ -1718,6 +1718,12 @@ function createToneSection(instruction) {
     content: instruction
   };
 }
+function createLanguageSection(languageName) {
+  return {
+    tag: "language",
+    content: `All output (title, description, keywords, chapter titles) MUST be written in ${languageName}.`
+  };
+}
 
 // src/lib/retry.ts
 var DEFAULT_RETRY_OPTIONS = {
@@ -1828,6 +1834,7 @@ var SYSTEM_PROMPT = dedent`
     - Only describe observable evidence from frames or transcript
     - Do not fabricate details or make unsupported assumptions
     - Return structured data matching the requested schema exactly
+    - Provide reasoning in the same language as the question
   </constraints>
 
   <language_guidelines>
@@ -2228,6 +2235,166 @@ async function hasBurnedInCaptions(assetId, options = {}) {
 import { generateText as generateText3, Output as Output3 } from "ai";
 import dedent3 from "dedent";
 import { z as z4 } from "zod";
+
+// src/lib/language-codes.ts
+var ISO639_1_TO_3 = {
+  // Major world languages
+  en: "eng",
+  // English
+  es: "spa",
+  // Spanish
+  fr: "fra",
+  // French
+  de: "deu",
+  // German
+  it: "ita",
+  // Italian
+  pt: "por",
+  // Portuguese
+  ru: "rus",
+  // Russian
+  zh: "zho",
+  // Chinese
+  ja: "jpn",
+  // Japanese
+  ko: "kor",
+  // Korean
+  ar: "ara",
+  // Arabic
+  hi: "hin",
+  // Hindi
+  // European languages
+  nl: "nld",
+  // Dutch
+  pl: "pol",
+  // Polish
+  sv: "swe",
+  // Swedish
+  da: "dan",
+  // Danish
+  no: "nor",
+  // Norwegian
+  fi: "fin",
+  // Finnish
+  el: "ell",
+  // Greek
+  cs: "ces",
+  // Czech
+  hu: "hun",
+  // Hungarian
+  ro: "ron",
+  // Romanian
+  bg: "bul",
+  // Bulgarian
+  hr: "hrv",
+  // Croatian
+  sk: "slk",
+  // Slovak
+  sl: "slv",
+  // Slovenian
+  uk: "ukr",
+  // Ukrainian
+  tr: "tur",
+  // Turkish
+  // Asian languages
+  th: "tha",
+  // Thai
+  vi: "vie",
+  // Vietnamese
+  id: "ind",
+  // Indonesian
+  ms: "msa",
+  // Malay
+  tl: "tgl",
+  // Tagalog/Filipino
+  // Other languages
+  he: "heb",
+  // Hebrew
+  fa: "fas",
+  // Persian/Farsi
+  bn: "ben",
+  // Bengali
+  ta: "tam",
+  // Tamil
+  te: "tel",
+  // Telugu
+  mr: "mar",
+  // Marathi
+  gu: "guj",
+  // Gujarati
+  kn: "kan",
+  // Kannada
+  ml: "mal",
+  // Malayalam
+  pa: "pan",
+  // Punjabi
+  ur: "urd",
+  // Urdu
+  sw: "swa",
+  // Swahili
+  af: "afr",
+  // Afrikaans
+  ca: "cat",
+  // Catalan
+  eu: "eus",
+  // Basque
+  gl: "glg",
+  // Galician
+  is: "isl",
+  // Icelandic
+  et: "est",
+  // Estonian
+  lv: "lav",
+  // Latvian
+  lt: "lit"
+  // Lithuanian
+};
+var ISO639_3_TO_1 = Object.fromEntries(
+  Object.entries(ISO639_1_TO_3).map(([iso1, iso3]) => [iso3, iso1])
+);
+function toISO639_3(code) {
+  const normalized = code.toLowerCase().trim();
+  if (normalized.length === 3) {
+    return normalized;
+  }
+  return ISO639_1_TO_3[normalized] ?? normalized;
+}
+function toISO639_1(code) {
+  const normalized = code.toLowerCase().trim();
+  if (normalized.length === 2) {
+    return normalized;
+  }
+  return ISO639_3_TO_1[normalized] ?? normalized;
+}
+function getLanguageCodePair(code) {
+  const normalized = code.toLowerCase().trim();
+  if (normalized.length === 2) {
+    return {
+      iso639_1: normalized,
+      iso639_3: toISO639_3(normalized)
+    };
+  } else if (normalized.length === 3) {
+    return {
+      iso639_1: toISO639_1(normalized),
+      iso639_3: normalized
+    };
+  }
+  return {
+    iso639_1: normalized,
+    iso639_3: normalized
+  };
+}
+function getLanguageName(code) {
+  const iso639_1 = toISO639_1(code);
+  try {
+    const displayNames = new Intl.DisplayNames(["en"], { type: "language" });
+    return displayNames.of(iso639_1) ?? code.toUpperCase();
+  } catch {
+    return code.toUpperCase();
+  }
+}
+
+// src/workflows/chapters.ts
 var chapterSchema = z4.object({
   startTime: z4.number(),
   title: z4.string()
@@ -2288,7 +2455,8 @@ var chapterSystemPromptBuilder = createPromptBuilder({
       content: dedent3`
         - Only use information present in the transcript
         - Return structured data that matches the requested JSON schema
-        - Do not add commentary or extra text outside the JSON`
+        - Do not add commentary or extra text outside the JSON
+        - When a <language> section is provided, all chapter titles MUST be written in that language`
     },
     qualityGuidelines: {
       tag: "quality_guidelines",
@@ -2336,7 +2504,7 @@ var chaptersPromptBuilder = createPromptBuilder({
       content: dedent3`
         - Keep titles concise and descriptive
         - Avoid filler or generic labels like "Chapter 1"
-        - Use the transcript's language and terminology`
+        - Use the transcript's terminology`
     }
   },
   sectionOrder: ["task", "outputFormat", "chapterGuidelines", "titleGuidelines"]
@@ -2345,7 +2513,8 @@ function buildUserPrompt3({
   timestampedTranscript,
   promptOverrides,
   minChaptersPerHour = 3,
-  maxChaptersPerHour = 8
+  maxChaptersPerHour = 8,
+  languageName
 }) {
   const contextSections = [
     {
@@ -2354,6 +2523,9 @@ function buildUserPrompt3({
       attributes: { format: "seconds" }
     }
   ];
+  if (languageName) {
+    contextSections.push(createLanguageSection(languageName));
+  }
   const dynamicChapterGuidelines = dedent3`
     - Create at least ${minChaptersPerHour} and at most ${maxChaptersPerHour} chapters per hour of content
     - Use start times in seconds (not HH:MM:SS)
@@ -2373,7 +2545,8 @@ async function generateChapters(assetId, languageCode, options = {}) {
     promptOverrides,
     minChaptersPerHour,
     maxChaptersPerHour,
-    credentials
+    credentials,
+    outputLanguageCode
   } = options;
   const modelConfig = resolveLanguageModelConfig({
     ...options,
@@ -2417,11 +2590,14 @@ async function generateChapters(assetId, languageCode, options = {}) {
     const contentLabel = isAudioOnly ? "transcript" : "caption track";
     throw new Error(`No usable content found in ${contentLabel}`);
   }
+  const resolvedLanguageCode = outputLanguageCode && outputLanguageCode !== "auto" ? outputLanguageCode : transcriptResult.track?.language_code ?? languageCode;
+  const languageName = resolvedLanguageCode ? getLanguageName(resolvedLanguageCode) : void 0;
   const userPrompt = buildUserPrompt3({
     timestampedTranscript,
     promptOverrides,
     minChaptersPerHour,
-    maxChaptersPerHour
+    maxChaptersPerHour,
+    languageName
   });
   let chaptersData = null;
   try {
@@ -3256,6 +3432,7 @@ var SYSTEM_PROMPT3 = dedent4`
     - Do not fabricate details or make unsupported assumptions
     - Return structured data matching the requested schema
     - Output only the JSON object; no markdown or extra text
+    - When a <language> section is provided, all output text MUST be written in that language
   </constraints>
 
   <tone_guidance>
@@ -3310,6 +3487,7 @@ var AUDIO_ONLY_SYSTEM_PROMPT = dedent4`
     - Return structured data matching the requested schema
     - Focus entirely on audio/spoken content - there are no visual elements
     - Output only the JSON object; no markdown or extra text
+    - When a <language> section is provided, all output text MUST be written in that language
   </constraints>
 
   <tone_guidance>
@@ -3340,9 +3518,13 @@ function buildUserPrompt4({
   isAudioOnly = false,
   titleLength,
   descriptionLength,
-  tagCount
+  tagCount,
+  languageName
 }) {
   const contextSections = [createToneSection(TONE_INSTRUCTIONS[tone])];
+  if (languageName) {
+    contextSections.push(createLanguageSection(languageName));
+  }
   if (transcriptText) {
     const format = isCleanTranscript ? "plain text" : "WebVTT";
     contextSections.push(createTranscriptSection(transcriptText, format));
@@ -3455,7 +3637,8 @@ async function getSummaryAndTags(assetId, options) {
     credentials,
     titleLength,
     descriptionLength,
-    tagCount
+    tagCount,
+    outputLanguageCode
   } = options ?? {};
   if (!VALID_TONES.includes(tone)) {
     throw new Error(
@@ -3482,12 +3665,15 @@ async function getSummaryAndTags(assetId, options) {
       "Signed playback ID requires signing credentials. Set MUX_SIGNING_KEY and MUX_PRIVATE_KEY environment variables."
     );
   }
-  const transcriptText = includeTranscript ? (await fetchTranscriptForAsset(assetData, playbackId, {
+  const transcriptResult = includeTranscript ? await fetchTranscriptForAsset(assetData, playbackId, {
     cleanTranscript,
     shouldSign: policy === "signed",
     credentials: workflowCredentials,
     required: isAudioOnly
-  })).transcriptText : "";
+  }) : void 0;
+  const transcriptText = transcriptResult?.transcriptText ?? "";
+  const resolvedLanguageCode = outputLanguageCode && outputLanguageCode !== "auto" ? outputLanguageCode : transcriptResult?.track?.language_code ?? getReadyTextTracks(assetData)[0]?.language_code;
+  const languageName = resolvedLanguageCode ? getLanguageName(resolvedLanguageCode) : void 0;
   const userPrompt = buildUserPrompt4({
     tone,
     transcriptText,
@@ -3496,7 +3682,8 @@ async function getSummaryAndTags(assetId, options) {
     isAudioOnly,
     titleLength,
     descriptionLength,
-    tagCount
+    tagCount,
+    languageName
   });
   let analysisResponse;
   let imageUrl;
@@ -3566,164 +3753,6 @@ async function getSummaryAndTags(assetId, options) {
   };
 }
 
-// src/lib/language-codes.ts
-var ISO639_1_TO_3 = {
-  // Major world languages
-  en: "eng",
-  // English
-  es: "spa",
-  // Spanish
-  fr: "fra",
-  // French
-  de: "deu",
-  // German
-  it: "ita",
-  // Italian
-  pt: "por",
-  // Portuguese
-  ru: "rus",
-  // Russian
-  zh: "zho",
-  // Chinese
-  ja: "jpn",
-  // Japanese
-  ko: "kor",
-  // Korean
-  ar: "ara",
-  // Arabic
-  hi: "hin",
-  // Hindi
-  // European languages
-  nl: "nld",
-  // Dutch
-  pl: "pol",
-  // Polish
-  sv: "swe",
-  // Swedish
-  da: "dan",
-  // Danish
-  no: "nor",
-  // Norwegian
-  fi: "fin",
-  // Finnish
-  el: "ell",
-  // Greek
-  cs: "ces",
-  // Czech
-  hu: "hun",
-  // Hungarian
-  ro: "ron",
-  // Romanian
-  bg: "bul",
-  // Bulgarian
-  hr: "hrv",
-  // Croatian
-  sk: "slk",
-  // Slovak
-  sl: "slv",
-  // Slovenian
-  uk: "ukr",
-  // Ukrainian
-  tr: "tur",
-  // Turkish
-  // Asian languages
-  th: "tha",
-  // Thai
-  vi: "vie",
-  // Vietnamese
-  id: "ind",
-  // Indonesian
-  ms: "msa",
-  // Malay
-  tl: "tgl",
-  // Tagalog/Filipino
-  // Other languages
-  he: "heb",
-  // Hebrew
-  fa: "fas",
-  // Persian/Farsi
-  bn: "ben",
-  // Bengali
-  ta: "tam",
-  // Tamil
-  te: "tel",
-  // Telugu
-  mr: "mar",
-  // Marathi
-  gu: "guj",
-  // Gujarati
-  kn: "kan",
-  // Kannada
-  ml: "mal",
-  // Malayalam
-  pa: "pan",
-  // Punjabi
-  ur: "urd",
-  // Urdu
-  sw: "swa",
-  // Swahili
-  af: "afr",
-  // Afrikaans
-  ca: "cat",
-  // Catalan
-  eu: "eus",
-  // Basque
-  gl: "glg",
-  // Galician
-  is: "isl",
-  // Icelandic
-  et: "est",
-  // Estonian
-  lv: "lav",
-  // Latvian
-  lt: "lit"
-  // Lithuanian
-};
-var ISO639_3_TO_1 = Object.fromEntries(
-  Object.entries(ISO639_1_TO_3).map(([iso1, iso3]) => [iso3, iso1])
-);
-function toISO639_3(code) {
-  const normalized = code.toLowerCase().trim();
-  if (normalized.length === 3) {
-    return normalized;
-  }
-  return ISO639_1_TO_3[normalized] ?? normalized;
-}
-function toISO639_1(code) {
-  const normalized = code.toLowerCase().trim();
-  if (normalized.length === 2) {
-    return normalized;
-  }
-  return ISO639_3_TO_1[normalized] ?? normalized;
-}
-function getLanguageCodePair(code) {
-  const normalized = code.toLowerCase().trim();
-  if (normalized.length === 2) {
-    return {
-      iso639_1: normalized,
-      iso639_3: toISO639_3(normalized)
-    };
-  } else if (normalized.length === 3) {
-    return {
-      iso639_1: toISO639_1(normalized),
-      iso639_3: normalized
-    };
-  }
-  return {
-    iso639_1: normalized,
-    iso639_3: normalized
-  };
-}
-function getLanguageName(code) {
-  const iso639_1 = toISO639_1(code);
-  try {
-    const displayNames = new Intl.DisplayNames(["en"], { type: "language" });
-    return displayNames.of(iso639_1) ?? code.toUpperCase();
-  } catch {
-    return code.toUpperCase();
-  }
-}
-
 // src/lib/storage-adapter.ts
 function requireCredentials(accessKeyId, secretAccessKey) {
   if (!accessKeyId || !secretAccessKey) {