@mux/ai 0.45.0 → 0.47.0

package/dist/{shots-B7G0IIF1.d.ts → shots-BwpjZDpr.d.ts}

@@ -1,4 +1,4 @@
-import Mux from '@mux/mux-node';
+import Mux from '@mux/ts';
 
 /**
  * Workflow Crypto
@@ -171,7 +171,7 @@ type WorkflowCredentialsInput = WorkflowCredentials | Encrypted<WorkflowCredenti
 type ToneType = "neutral" | "playful" | "professional";
 /** Common transport for image-based workflows. */
 type ImageSubmissionMode = "url" | "base64";
-/** Result of calling mux-node's asset retrieval helper. */
+/** Result of calling the Mux SDK asset retrieval helper. */
 type MuxAsset = Awaited<ReturnType<Mux["video"]["assets"]["retrieve"]>>;
 /** Single ready track extracted from a Mux asset. */
 type AssetTextTrack = NonNullable<MuxAsset["tracks"]>[number];
@@ -294,7 +294,7 @@ interface HotspotOptions {
     limit?: number;
     /** Sort order: 'asc' or 'desc' (default: 'desc') */
     orderDirection?: "asc" | "desc";
-    /** Order by field (default: 'score') */
+    /** @deprecated The API always orders by score; this option is ignored. */
     orderBy?: "score";
     /** Time window for results, e.g., '7:days' (default: '7:days') */
     timeframe?: string;

package/dist/workflows/index.d.ts

@@ -1,8 +1,8 @@
-export { E as ASK_QUESTIONS_DEFAULT_MAX_ANSWER_OPTION_LENGTH, F as ASK_QUESTIONS_DEFAULT_MAX_FREE_FORM_ANSWER_LENGTH, G as ASK_QUESTIONS_MAX_QUESTIONS_PER_CALL, H as ASK_QUESTIONS_MAX_QUESTION_LENGTH, J as AskQuestionsOptions, K as AskQuestionsResult, N as AskQuestionsType, O as AudioTranslationOptions, P as AudioTranslationResult, Q as AutoCensorProfanityOptions, U as BurnedInCaptionsAnalysis, V as BurnedInCaptionsOptions, W as BurnedInCaptionsPromptOverrides, X as BurnedInCaptionsPromptSections, Y as BurnedInCaptionsResult, Z as CaptionReplacement, _ as CensorMode, $ as Chapter, a0 as ChapterSystemPromptSections, a1 as ChaptersOptions, a2 as ChaptersPromptOverrides, a3 as ChaptersPromptSections, a4 as ChaptersResult, a5 as ChaptersType, a6 as EditCaptionsOptions, a7 as EditCaptionsResult, a8 as EmbeddingsOptions, a9 as EmbeddingsResult, aa as EngagementInsightsOptions, ab as EngagementInsightsResult, ac as GENERATE_TEXT_CALLS_TO_ACTION, ad as GENERATE_TEXT_CHANNELS, ae as GENERATE_TEXT_CHANNEL_CEILINGS, af as GENERATE_TEXT_FORMATS, ag as GENERATE_TEXT_LENGTH_BOUNDS, ah as GENERATE_TEXT_MAX_ARTIFACTS, ai as GENERATE_TEXT_MAX_AUDIENCE_CHARS, aj as GENERATE_TEXT_MAX_BRAND_TERMS, ak as GENERATE_TEXT_MAX_BRAND_TERMS_TOTAL_CHARS, al as GENERATE_TEXT_MAX_BRAND_TERM_CHARS, am as GENERATE_TEXT_MAX_CONCURRENT_GENERATIONS, an as GENERATE_TEXT_MAX_INSTRUCTIONS_CHARS, ao as GENERATE_TEXT_MAX_SHOT_FRAMES, ap as GENERATE_TEXT_MAX_VARIANTS, aq as GENERATE_TEXT_VOICES, ar as GOOGLE_VISION_LIKELIHOOD_TO_SCORE, as as GenerateTextArtifact, at as GenerateTextCallToAction, au as GenerateTextChannel, av as GenerateTextFormat, aw as GenerateTextKeyedItem, ax as GenerateTextLengthLimit, ay as GenerateTextOptions, az as GenerateTextResult, aA as GenerateTextVariant, aB as GenerateTextVoice, aC as GeneratedTextArtifact, aD as GeneratedTextVariant, aE as HIVE_SEXUAL_CATEGORIES, aF as HIVE_VIOLENCE_CATEGORIES, aG as HiveModerationOutput, aH as HiveModerationSource, aI as ModerationOptions, aJ as ModerationProvider, aK as ModerationResult, aL as MomentInsight, aM as OverallInsight, aN as ProfanityDetectionPayload, aO as Question, aP as QuestionAnswer, aQ as QuestionAnswerType, aR as ReplacementRecord, aS as SpeakerReplacement, aT as StaticRenditionCleanupOutcome, aU as SummarizationOptions, aV as SummarizationPromptOverrides, aW as SummarizationPromptSections, aX as SummaryAndTagsResult, aY as SummaryType, aZ as ThumbnailModerationScore, a_ as TranslationChunkingOptions, a$ as TranslationOptions, b0 as TranslationPayload, b1 as TranslationResult, b2 as aggregateTokenUsage, b3 as applyOverrideLists, b4 as applyReplacements, b5 as applySpeakerReplacements, b6 as askQuestions, b7 as buildReplacementRegex, b8 as burnedInCaptionsSchema, b9 as censorVttContent, ba as chapterSchema, bb as chaptersSchema, bc as createReplacer, bd as editCaptions, be as extractTranscriptSegmentsForHotspots, bf as findGenerateTextLengthViolation, bg as generateChapters, bh as generateEmbeddings, bi as generateEngagementInsights, bj as generateText, bk as generateVideoEmbeddings, bl as getModerationScores, bm as getSummaryAndTags, bn as hasBurnedInCaptions, bo as mapShotsToHotspots, bp as measureGenerateTextLength, bq as normalizeTranslatedVtt, br as profanityDetectionSchema, bs as questionAnswerSchema, bt as resolveGenerateTextLengthLimit, bu as resolveGenerateTextLengthLimits, bv as resolveGenerateTextOptions, bw as selectGenerateTextShotFrames, bx as shouldSplitChunkTranslationError, by as summarySchema, bz as transformCueText, bA as translateAudio, bB as translateCaptions, bC as translationSchema, bD as validateNeverTranslateTerms, bE as verifyNeverTranslateTerms } from '../index-BD4acrwt.js';
+export { J as ASK_QUESTIONS_DEFAULT_MAX_ANSWER_OPTION_LENGTH, K as ASK_QUESTIONS_DEFAULT_MAX_FREE_FORM_ANSWER_LENGTH, N as ASK_QUESTIONS_MAX_QUESTIONS_PER_CALL, O as ASK_QUESTIONS_MAX_QUESTION_LENGTH, P as AskQuestionsOptions, Q as AskQuestionsResult, U as AskQuestionsType, V as AudioTranslationOptions, W as AudioTranslationResult, X as AutoCensorProfanityOptions, Y as BurnedInCaptionsAnalysis, Z as BurnedInCaptionsOptions, _ as BurnedInCaptionsPromptOverrides, $ as BurnedInCaptionsPromptSections, a0 as BurnedInCaptionsResult, a1 as CaptionReplacement, a2 as CensorMode, a3 as Chapter, a4 as ChapterSystemPromptSections, a5 as ChaptersOptions, a6 as ChaptersPromptOverrides, a7 as ChaptersPromptSections, a8 as ChaptersResult, a9 as ChaptersType, aa as EditCaptionsOptions, ab as EditCaptionsResult, ac as EmbeddingsOptions, ad as EmbeddingsResult, ae as EngagementInsightsOptions, af as EngagementInsightsResult, ag as GENERATE_TEXT_CALLS_TO_ACTION, ah as GENERATE_TEXT_CHANNELS, ai as GENERATE_TEXT_CHANNEL_CEILINGS, aj as GENERATE_TEXT_FORMATS, ak as GENERATE_TEXT_LENGTH_BOUNDS, al as GENERATE_TEXT_MAX_ARTIFACTS, am as GENERATE_TEXT_MAX_AUDIENCE_CHARS, an as GENERATE_TEXT_MAX_BRAND_TERMS, ao as GENERATE_TEXT_MAX_BRAND_TERMS_TOTAL_CHARS, ap as GENERATE_TEXT_MAX_BRAND_TERM_CHARS, aq as GENERATE_TEXT_MAX_CONCURRENT_GENERATIONS, ar as GENERATE_TEXT_MAX_INSTRUCTIONS_CHARS, as as GENERATE_TEXT_MAX_SHOT_FRAMES, at as GENERATE_TEXT_MAX_VARIANTS, au as GENERATE_TEXT_VOICES, av as GOOGLE_VISION_LIKELIHOOD_TO_SCORE, aw as GenerateTextArtifact, ax as GenerateTextCallToAction, ay as GenerateTextChannel, az as GenerateTextFormat, aA as GenerateTextKeyedItem, aB as GenerateTextLengthLimit, aC as GenerateTextOptions, aD as GenerateTextResult, aE as GenerateTextVariant, aF as GenerateTextVoice, aG as GeneratedTextArtifact, aH as GeneratedTextVariant, aI as HIVE_SEXUAL_CATEGORIES, aJ as HIVE_VIOLENCE_CATEGORIES, aK as HiveModerationOutput, aL as HiveModerationSource, aM as ModerationOptions, aN as ModerationProvider, aO as ModerationResult, aP as MomentInsight, aQ as OverallInsight, aR as ProfanityDetectionPayload, aS as Question, aT as QuestionAnswer, aU as QuestionAnswerType, aV as ReplacementRecord, aW as SpeakerReplacement, aX as StaticRenditionCleanupOutcome, aY as SummarizationOptions, aZ as SummarizationPromptOverrides, a_ as SummarizationPromptSections, a$ as SummaryAndTagsResult, b0 as SummaryType, b1 as ThumbnailModerationScore, b2 as TranslationChunkingOptions, b3 as TranslationOptions, b4 as TranslationPayload, b5 as TranslationResult, b6 as aggregateTokenUsage, b7 as applyOverrideLists, b8 as applyReplacements, b9 as applySpeakerReplacements, ba as askQuestions, bb as buildReplacementRegex, bc as burnedInCaptionsSchema, bd as censorVttContent, be as chapterSchema, bf as chaptersSchema, bg as createReplacer, bh as editCaptions, bi as extractTranscriptSegmentsForHotspots, bj as findGenerateTextLengthViolation, bk as generateChapters, bl as generateEmbeddings, bm as generateEngagementInsights, bn as generateText, bo as generateVideoEmbeddings, bp as getModerationScores, bq as getSummaryAndTags, br as hasBurnedInCaptions, bs as mapShotsToHotspots, bt as measureGenerateTextLength, bu as normalizeTranslatedVtt, bv as profanityDetectionSchema, bw as questionAnswerSchema, bx as resolveGenerateTextLengthLimit, by as resolveGenerateTextLengthLimits, bz as resolveGenerateTextOptions, bA as selectGenerateTextShotFrames, bB as shouldSplitChunkTranslationError, bC as summarySchema, bD as transformCueText, bE as translateAudio, bF as translateCaptions, bG as translationSchema, bH as validateNeverTranslateTerms, bI as verifyNeverTranslateTerms } from '../index-DxAt9Jq8.js';
 export { D as DEFAULT_DESCRIPTION_LENGTH, a as DEFAULT_SUMMARY_KEYWORD_LIMIT, b as DEFAULT_TITLE_LENGTH } from '../summarization-BFmhXeAu.js';
 import 'zod';
 import '@ai-sdk/anthropic';
 import '@ai-sdk/google';
 import '@ai-sdk/openai';
-import '../shots-B7G0IIF1.js';
-import '@mux/mux-node';
+import '../shots-BwpjZDpr.js';
+import '@mux/ts';

package/dist/workflows/index.js

@@ -1173,7 +1173,7 @@ function resolveDirectMuxCredentials(record) {
 function createWorkflowMuxClient(options) {
   return {
     async createClient() {
-      const { default: MuxClient } = await import("@mux/mux-node");
+      const { default: MuxClient } = await import("@mux/ts");
       return new MuxClient({
         tokenId: options.tokenId,
         tokenSecret: options.tokenSecret,
@@ -1913,12 +1913,8 @@ async function getMuxThumbnailBaseUrl(playbackId, credentials) {
 
 // src/lib/url-signing.ts
 async function createSigningClient(context) {
-  const { default: MuxClient } = await import("@mux/mux-node");
+  const { default: MuxClient } = await import("@mux/ts");
   return new MuxClient({
-    // These are not needed for signing, but the SDK requires them
-    // Using empty strings as we only need the jwt functionality
-    tokenId: env_default.MUX_TOKEN_ID || "",
-    tokenSecret: env_default.MUX_TOKEN_SECRET || "",
     jwtSigningKey: context.keyId,
     jwtPrivateKey: context.keySecret
   });
@@ -3979,17 +3975,24 @@ function findNameCollisionTextTracks(asset, target) {
   }
   return listTracks(asset, targetType(target)).filter((track) => normalizeTrackName(track.name) === targetName);
 }
+function countTracks(tracks, label, singularVerb, pluralVerb) {
+  const kind = label.toLowerCase();
+  if (tracks.length === 1) {
+    return `${kind === "audio" ? "An" : "A"} ${kind} track ${singularVerb}`;
+  }
+  return `${tracks.length} ${kind} tracks ${pluralVerb}`;
+}
+function itOrThem(tracks) {
+  return tracks.length === 1 ? "it" : "them";
+}
 function describeTracks(tracks) {
   return tracks.map((track) => `${track.name ?? "(unnamed)"} [${track.language_code ?? "?"}, ${track.type === "audio" ? track.primary ? "primary audio" : "audio" : track.text_source ?? "unknown source"}, ${track.status ?? "ready"}]`).join("; ");
 }
-function planTextTrackReplacement(asset, target, policy, options = {}) {
+function planTextTrackReplacement(asset, target, policy) {
   const label = targetType(target) === "audio" ? "Audio" : "Text";
-  const keep = new Set(options.keepTrackIds ?? []);
   const conflicts = /* @__PURE__ */ new Map();
   for (const track of [...findSameLanguageTextTracks(asset, target), ...findNameCollisionTextTracks(asset, target)]) {
-    if (!keep.has(track.id)) {
-      conflicts.set(track.id, track);
-    }
+    conflicts.set(track.id, track);
   }
   const conflicting = [...conflicts.values()];
   if (conflicting.length === 0) {
@@ -3998,7 +4001,7 @@ function planTextTrackReplacement(asset, target, policy, options = {}) {
   if (policy === "fail") {
     return {
       kind: "blocked",
-      reason: `${label} track(s) already exist for language '${target.languageCode}' or name '${target.name}': ${describeTracks(conflicting)}. Set replaceExistingTracks to replace them.`,
+      reason: `${countTracks(conflicting, label, "already exists", "already exist")} for language '${target.languageCode}' or name '${target.name}': ${describeTracks(conflicting)}. Set replaceExistingTracks to replace ${itOrThem(conflicting)}.`,
       tracks: conflicting.map(summarizeTextTrack)
     };
   }
@@ -4015,13 +4018,26 @@ function planTextTrackReplacement(asset, target, policy, options = {}) {
     if (notGenerated.length > 0) {
       return {
         kind: "blocked",
-        reason: `${label} track(s) that are not Mux-generated exist for language '${target.languageCode}' or name '${target.name}': ${describeTracks(notGenerated)}. Use replaceExistingTracks: "replace_all" to replace them.`,
+        reason: `${countTracks(notGenerated, label, "that is not Mux-generated exists", "that are not Mux-generated exist")} for language '${target.languageCode}' or name '${target.name}': ${describeTracks(notGenerated)}. Use replaceExistingTracks: "replace_all" to replace ${itOrThem(notGenerated)}.`,
         tracks: notGenerated.map(summarizeTextTrack)
       };
     }
   }
   return { kind: "replace", toDelete: conflicting.map(summarizeTextTrack) };
 }
+function planSourceTrackReplacement(asset, sourceTrackId, target, policy) {
+  const colliding = findNameCollisionTextTracks(asset, target);
+  const blocking = policy === "fail" ? colliding : colliding.filter((track) => track.id !== sourceTrackId);
+  if (blocking.length > 0) {
+    return {
+      kind: "blocked",
+      reason: `${countTracks(blocking, "Text", "already has", "already have")} the name '${target.name}': ${describeTracks(blocking)}. Choose a different trackName.`,
+      tracks: blocking.map(summarizeTextTrack)
+    };
+  }
+  const source = policy === "replace" ? listTracks(asset, targetType(target)).find((track) => track.id === sourceTrackId) : void 0;
+  return source ? { kind: "replace", toDelete: [summarizeTextTrack(source)] } : { kind: "clear" };
+}
 function isDuplicateTrackNameError(error) {
   if (typeof error !== "object" || error === null) {
     return false;
@@ -4077,6 +4093,14 @@ async function createTextTrackOnMux(assetId, languageCode, trackName, presignedU
 }
 async function replaceAndCreateTrack(input) {
   "use step";
+  return writeTrack(input, (asset) => planTextTrackReplacement(asset, input.target, input.policy));
+}
+async function replaceSourceTrack(input) {
+  "use step";
+  const target = { ...input.target, type: "text" };
+  return writeTrack({ ...input, target }, (asset) => planSourceTrackReplacement(asset, input.sourceTrackId, target, input.policy));
+}
+async function writeTrack(input, plan) {
   const muxClient = await resolveMuxClient(input.credentials);
   const mux = await muxClient.createClient();
   const type = targetType(input.target);
@@ -4096,12 +4120,12 @@ async function replaceAndCreateTrack(input) {
       }
       return failed(error);
     }
-    const plan = planTextTrackReplacement(asset, input.target, input.policy, { keepTrackIds: input.keepTrackIds });
-    if (plan.kind === "blocked") {
-      return { ...plan, deleted };
+    const planned = plan(asset);
+    if (planned.kind === "blocked") {
+      return { ...planned, deleted };
     }
-    if (plan.kind === "replace") {
-      for (const track of plan.toDelete) {
+    if (planned.kind === "replace") {
+      for (const track of planned.toDelete) {
         try {
           await mux.video.assets.deleteTrack(input.assetId, track.id);
           deleted.push(track);
@@ -4725,7 +4749,13 @@ async function editCaptionsInternal(assetId, trackId, options, collectedUsage) {
       { type: "validation_error" }
     );
   }
-  const replaceExistingTracks = replaceExistingTracksOption ?? "replace_all";
+  if (replaceExistingTracksOption !== void 0 && replaceExistingTracksOption !== "replace" && replaceExistingTracksOption !== "fail") {
+    throw new MuxAiError(
+      `replaceExistingTracks must be "replace" or "fail" for editCaptions (received "${String(replaceExistingTracksOption)}").`,
+      { type: "validation_error" }
+    );
+  }
+  const replaceExistingTracks = replaceExistingTracksOption ?? "replace";
   if (!legacyTrackNaming && replaceExistingTracks === "fail" && !providedTrackName) {
     throw new MuxAiError(
       `trackName is required when replaceExistingTracks is "fail": the edited track cannot reuse the source track's name while the source is kept.`,
@@ -4781,15 +4811,14 @@ async function editCaptionsInternal(assetId, trackId, options, collectedUsage) {
     languageCode: sourceLanguageCode,
     name: providedTrackName ?? sourceName
   };
-  const keepTrackIds = replaceExistingTracks === "fail" ? [trackId] : [];
   if (replaceExistingTracks === "fail" && normalizeTrackName(outputTrack.name) === normalizeTrackName(sourceName)) {
     throw new MuxAiError(
-      `trackName "${outputTrack.name}" matches the source track's name. Mux track names must be unique; choose a different trackName or use replaceExistingTracks: "replace_all" to replace the source.`,
+      `trackName "${outputTrack.name}" matches the source track's name. Mux track names must be unique; choose a different trackName or use replaceExistingTracks: "replace" to replace the source.`,
       { type: "validation_error" }
     );
   }
   if (uploadToMux && !legacyTrackNaming) {
-    const plan = planTextTrackReplacement(assetData, outputTrack, replaceExistingTracks, { keepTrackIds });
+    const plan = planSourceTrackReplacement(assetData, trackId, outputTrack, replaceExistingTracks);
     if (plan.kind === "blocked") {
       throw new MuxAiError(plan.reason, { type: "validation_error" });
     }
@@ -4911,14 +4940,14 @@ async function editCaptionsInternal(assetId, trackId, options, collectedUsage) {
     } else if (uploadToMux) {
       let outcome;
       try {
-        outcome = await replaceAndCreateTextTrack({
+        outcome = await replaceSourceTrack({
           assetId,
+          sourceTrackId: trackId,
           target: outputTrack,
           policy: replaceExistingTracks,
           presignedUrl,
           closedCaptions: sourceTrack.closed_captions,
           passthrough: trackPassthrough,
-          keepTrackIds,
           credentials
         });
       } catch (error) {
@@ -5389,25 +5418,22 @@ async function getHeatmapForAsset(assetId, options = {}) {
   "use step";
   return fetchHeatmap("assets", assetId, options);
 }
-function transformHeatmapResponse(response) {
-  return {
-    assetId: response.data.asset_id,
-    videoId: response.data.video_id,
-    playbackId: response.data.playback_id,
-    heatmap: response.data.heatmap,
-    timeframe: response.timeframe
-  };
-}
 async function fetchHeatmap(identifierType, id, options) {
   "use step";
   const { timeframe = "7:days", credentials } = options;
   const muxClient = await getMuxClientFromEnv(credentials);
   const mux = await muxClient.createClient();
-  const queryParams = new URLSearchParams();
-  queryParams.append("timeframe[]", timeframe);
-  const path = `/data/v1/engagement/${identifierType}/${id}/heatmap?${queryParams.toString()}`;
-  const response = await mux.get(path);
-  return transformHeatmapResponse(response);
+  const query = { timeframe: [timeframe] };
+  const resource = identifierType === "playback-ids" ? mux.data.engagement.playbackIds : mux.data.engagement[identifierType];
+  const response = await resource.heatmap(id, query);
+  const { data } = response;
+  return {
+    assetId: data.asset_id ?? (identifierType === "assets" ? id : void 0),
+    videoId: data.video_id ?? (identifierType === "videos" ? id : void 0),
+    playbackId: data.playback_id ?? (identifierType === "playback-ids" ? id : void 0),
+    heatmap: data.heatmap,
+    timeframe: response.timeframe
+  };
 }
 
 // src/primitives/hotspots.ts
@@ -5416,43 +5442,37 @@ async function getHotspotsForAsset(assetId, options = {}) {
   const response = await fetchHotspots("assets", assetId, options);
   return response.hotspots;
 }
-function transformHotspotResponse(response) {
-  return {
-    assetId: response.data.asset_id,
-    videoId: response.data.video_id,
-    playbackId: response.data.playback_id,
-    hotspots: response.data.hotspots.map((h) => ({
-      startMs: h.start_ms,
-      endMs: h.end_ms,
-      score: h.score
-    }))
-  };
-}
 async function fetchHotspots(identifierType, id, options) {
   "use step";
   const {
     limit = 5,
     orderDirection = "desc",
-    orderBy = "score",
     timeframe = "7:days",
     credentials
   } = options;
   const muxClient = await getMuxClientFromEnv(credentials);
   const mux = await muxClient.createClient();
-  const queryParams = new URLSearchParams();
-  queryParams.append("limit", String(limit));
-  queryParams.append("order_direction", orderDirection);
-  queryParams.append("order_by", orderBy);
-  queryParams.append("timeframe[]", timeframe);
-  const path = `/data/v1/engagement/${identifierType}/${id}/hotspots?${queryParams.toString()}`;
-  const response = await mux.get(path);
-  return transformHotspotResponse(response);
+  const query = {
+    limit,
+    order_direction: orderDirection,
+    timeframe: [timeframe]
+  };
+  const resource = identifierType === "playback-ids" ? mux.data.engagement.playbackIds : mux.data.engagement[identifierType];
+  const response = await resource.hotspots(id, query);
+  const { data } = response;
+  return {
+    assetId: data.asset_id ?? (identifierType === "assets" ? id : void 0),
+    videoId: data.video_id ?? (identifierType === "videos" ? id : void 0),
+    playbackId: data.playback_id ?? (identifierType === "playback-ids" ? id : void 0),
+    hotspots: data.hotspots.map((h) => ({
+      startMs: h.start_ms,
+      endMs: h.end_ms,
+      score: h.score
+    }))
+  };
 }
 
 // src/primitives/shots.ts
-function getShotsPath(assetId) {
-  return `/video/v1/assets/${assetId}/shots`;
-}
 function mapManifestShots(shots) {
   let usedDeprecatedField = false;
   const mapped = shots.map((shot, index) => {
@@ -5492,29 +5512,35 @@ async function fetchShotsFromManifest(shotsManifestUrl) {
   }
   return mapManifestShots(manifest.shots);
 }
-async function transformShotsResponse(response) {
-  switch (response.data.status) {
+async function transformShotsResponse(data) {
+  switch (data.status) {
     case "pending":
       return {
         status: "pending",
-        createdAt: response.data.created_at
+        createdAt: data.created_at
       };
-    case "errored":
+    case "errored": {
+      const details = data.errors ?? data.error;
       return {
         status: "errored",
-        createdAt: response.data.created_at,
-        error: response.data.error
+        createdAt: data.created_at,
+        error: {
+          type: details?.type ?? "unknown",
+          messages: details?.messages ?? []
+        }
       };
+    }
     case "completed":
+      if (!data.shots_manifest_url) {
+        throw new Error("Completed shots response is missing shots_manifest_url");
+      }
       return {
         status: "completed",
-        createdAt: response.data.created_at,
-        shots: await fetchShotsFromManifest(response.data.shots_manifest_url)
+        createdAt: data.created_at,
+        shots: await fetchShotsFromManifest(data.shots_manifest_url)
       };
-    default: {
-      const exhaustiveCheck = response.data;
-      throw new Error(`Unsupported shots response: ${JSON.stringify(exhaustiveCheck)}`);
-    }
+    default:
+      throw new Error(`Unsupported shots status '${data.status}'`);
   }
 }
 async function getShotsForAsset(assetId, options = {}) {
@@ -5522,10 +5548,8 @@ async function getShotsForAsset(assetId, options = {}) {
   const { credentials } = options;
   const muxClient = await getMuxClientFromEnv(credentials);
   const mux = await muxClient.createClient();
-  const response = await mux.get(
-    getShotsPath(assetId)
-  );
-  return await transformShotsResponse(response);
+  const data = await mux.video.assets.retrieveShots(assetId);
+  return await transformShotsResponse(data);
 }
 
 // src/workflows/engagement-insights.ts