youtube-knowledge-mcp 3.0.0 → 3.0.2

package/dist/utils/video-stats.d.ts

@@ -1,4 +1,8 @@
 import { z } from 'zod';
+import { videoStatsRowSchema, type MusicCredits, type VideoFormat } from './video-stats-schema.js';
+export { videoStatsRowSchema } from './video-stats-schema.js';
+export { CATALOG_DESCRIPTION_PREVIEW_CHARS, MAX_DETAIL_JSON_BYTES, STRIPPED_KEYS, stripForStorage, } from './video-stats-storage.js';
+export type { MusicCredits, VideoFormat } from './video-stats-schema.js';
 /**
  * One full read of a video, serving every caller that needs part of it.
  *
@@ -13,129 +17,6 @@ import { z } from 'zod';
  * the record. Stripped, a video is 4,785 bytes. Storing the raw object would
  * cost 6.4GB per 10,000 videos instead of 48MB.
  */
-/** A stored snapshot must stay small enough that a catalogue is not mostly URLs. */
-export declare const MAX_DETAIL_JSON_BYTES = 32768;
-/** Keys dropped before storage: expiring URLs and bulk we can re-fetch. */
-export declare const STRIPPED_KEYS: readonly ["formats", "requested_formats", "automatic_captions", "subtitles", "thumbnails", "comments", "heatmap"];
-export declare const videoStatsRowSchema: z.ZodObject<{
-    id: z.ZodString;
-    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    channel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    channel_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    channel_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    channel_follower_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    upload_date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    duration: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    view_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    like_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    comment_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    concurrent_view_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    categories: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
-    tags: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
-    age_limit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-    availability: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    live_status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    was_live: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
-    is_live: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
-    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    thumbnail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    chapters: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
-        title: z.ZodString;
-        start_time: z.ZodNumber;
-        end_time: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        title: string;
-        start_time: number;
-        end_time: number;
-    }, {
-        title: string;
-        start_time: number;
-        end_time: number;
-    }>, "many">>>;
-    heatmap: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
-        start_time: z.ZodNumber;
-        end_time: z.ZodNumber;
-        value: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        value: number;
-        start_time: number;
-        end_time: number;
-    }, {
-        value: number;
-        start_time: number;
-        end_time: number;
-    }>, "many">>>;
-    automatic_captions: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-    subtitles: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-}, "strip", z.ZodTypeAny, {
-    id: string;
-    title?: string | null | undefined;
-    channel?: string | null | undefined;
-    description?: string | null | undefined;
-    tags?: string[] | null | undefined;
-    duration?: number | null | undefined;
-    upload_date?: string | null | undefined;
-    thumbnail?: string | null | undefined;
-    view_count?: number | null | undefined;
-    like_count?: number | null | undefined;
-    comment_count?: number | null | undefined;
-    availability?: string | null | undefined;
-    live_status?: string | null | undefined;
-    chapters?: {
-        title: string;
-        start_time: number;
-        end_time: number;
-    }[] | null | undefined;
-    subtitles?: Record<string, unknown> | null | undefined;
-    automatic_captions?: Record<string, unknown> | null | undefined;
-    channel_id?: string | null | undefined;
-    channel_url?: string | null | undefined;
-    channel_follower_count?: number | null | undefined;
-    heatmap?: {
-        value: number;
-        start_time: number;
-        end_time: number;
-    }[] | null | undefined;
-    concurrent_view_count?: number | null | undefined;
-    categories?: string[] | null | undefined;
-    age_limit?: number | null | undefined;
-    was_live?: boolean | null | undefined;
-    is_live?: boolean | null | undefined;
-}, {
-    id: string;
-    title?: string | null | undefined;
-    channel?: string | null | undefined;
-    description?: string | null | undefined;
-    tags?: string[] | null | undefined;
-    duration?: number | null | undefined;
-    upload_date?: string | null | undefined;
-    thumbnail?: string | null | undefined;
-    view_count?: number | null | undefined;
-    like_count?: number | null | undefined;
-    comment_count?: number | null | undefined;
-    availability?: string | null | undefined;
-    live_status?: string | null | undefined;
-    chapters?: {
-        title: string;
-        start_time: number;
-        end_time: number;
-    }[] | null | undefined;
-    subtitles?: Record<string, unknown> | null | undefined;
-    automatic_captions?: Record<string, unknown> | null | undefined;
-    channel_id?: string | null | undefined;
-    channel_url?: string | null | undefined;
-    channel_follower_count?: number | null | undefined;
-    heatmap?: {
-        value: number;
-        start_time: number;
-        end_time: number;
-    }[] | null | undefined;
-    concurrent_view_count?: number | null | undefined;
-    categories?: string[] | null | undefined;
-    age_limit?: number | null | undefined;
-    was_live?: boolean | null | undefined;
-    is_live?: boolean | null | undefined;
-}>;
 export interface VideoStats {
     id: string;
     title: string;
@@ -175,12 +56,27 @@ export interface VideoStats {
     descriptionChars: number;
     description: string;
     thumbnailUrl?: string;
+    channelUrl?: string;
+    uploader?: string;
+    license?: string;
+    language?: string;
+    /** yt-dlp's own label, such as `video`, `short` or `livestream`. */
+    mediaType?: string;
+    playableInEmbed?: boolean;
+    /** Unix seconds a premiere or scheduled video goes live. */
+    releaseTimestamp?: number;
+    music?: MusicCredits;
+    video?: VideoFormat;
 }
-export declare const CATALOG_DESCRIPTION_PREVIEW_CHARS = 500;
-/** Drops the bulk keys, so what is stored is the record rather than its attachments. */
-export declare function stripForStorage(raw: Record<string, unknown>): Record<string, unknown>;
 export declare function toVideoStats(row: z.infer<typeof videoStatsRowSchema>): VideoStats;
 /** One `-j` read, serving info, details, chapters, captions and the heatmap. */
-export declare function fetchVideoStatsRow(urlOrId: string): Promise<z.infer<typeof videoStatsRowSchema>>;
+export declare function fetchVideoStatsRow(urlOrId: string, options?: {
+    /**
+     * Have yt-dlp return a video YouTube refuses to serve as a row, with `availability`
+     * filled in, instead of failing. Without it a private video fails with a message that
+     * asks to sign in, which reads as a session problem rather than as that one video.
+     */
+    tolerateRefusal?: boolean;
+}): Promise<z.infer<typeof videoStatsRowSchema>>;
 export declare function getVideoStats(urlOrId: string): Promise<VideoStats>;
 //# sourceMappingURL=video-stats.d.ts.map

package/dist/utils/video-stats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"video-stats.d.ts","sourceRoot":"","sources":["../../src/utils/video-stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;;;;;;;;;;;GAaG;AAEH,oFAAoF;AACpF,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAE5C,2EAA2E;AAC3E,eAAO,MAAM,aAAa,mHAQhB,CAAC;AAQX,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4B9B,CAAC;AAEH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClE,+EAA+E;IAC/E,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACpD,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACxE,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,eAAO,MAAM,iCAAiC,MAAM,CAAC;AAErD,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAcrF;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,GAAG,UAAU,CA0EjF;AAED,gFAAgF;AAChF,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAS9C;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAExE"}
+{"version":3,"file":"video-stats.d.ts","sourceRoot":"","sources":["../../src/utils/video-stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAAE,mBAAmB,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEnG,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EACL,iCAAiC,EACjC,qBAAqB,EACrB,aAAa,EACb,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEzE;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClE,+EAA+E;IAC/E,QAAQ,EAAE;QAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IACpD,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACxE,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AASD,wBAAgB,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,GAAG,UAAU,CA+EjF;AAED,gFAAgF;AAChF,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CACtB,GACL,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAY9C;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAExE"}

package/dist/utils/video-stats.js

@@ -1,82 +1,15 @@
-import { z } from 'zod';
 import { TIMEOUTS, parseYtDlpJson, runYtDlp } from './ytdlp.js';
 import { extractVideoId, formatDuration, watchUrl } from './youtube-url.js';
 import { classifyPlayability } from './errors.js';
-/**
- * One full read of a video, serving every caller that needs part of it.
- *
- * `getVideoInfo` ran a narrow `--print` and `getVideoDetails` ran a full `-j`
- * and discarded all but three fields, so a single video cost two spawns for
- * data one already had. Requests to YouTube are the thing that gets a client
- * throttled, so halving them is the cheapest reliability win available.
- *
- * What is NOT kept matters as much as what is. Measured on a 637KB payload:
- * `automatic_captions` is 460,965 bytes (72%) of URLs that expire, `formats`
- * another 113,601 (18%), and `heatmap` 6,589 — larger than the whole rest of
- * the record. Stripped, a video is 4,785 bytes. Storing the raw object would
- * cost 6.4GB per 10,000 videos instead of 48MB.
- */
-/** A stored snapshot must stay small enough that a catalogue is not mostly URLs. */
-export const MAX_DETAIL_JSON_BYTES = 32_768;
-/** Keys dropped before storage: expiring URLs and bulk we can re-fetch. */
-export const STRIPPED_KEYS = [
-    'formats',
-    'requested_formats',
-    'automatic_captions',
-    'subtitles',
-    'thumbnails',
-    'comments',
-    'heatmap',
-];
-const heatmapEntrySchema = z.object({
-    start_time: z.number(),
-    end_time: z.number(),
-    value: z.number(),
-});
-export const videoStatsRowSchema = z.object({
-    id: z.string(),
-    title: z.string().nullish(),
-    channel: z.string().nullish(),
-    channel_id: z.string().nullish(),
-    channel_url: z.string().nullish(),
-    channel_follower_count: z.number().nullish(),
-    upload_date: z.string().nullish(),
-    duration: z.number().nullish(),
-    view_count: z.number().nullish(),
-    like_count: z.number().nullish(),
-    comment_count: z.number().nullish(),
-    concurrent_view_count: z.number().nullish(),
-    categories: z.array(z.string()).nullish(),
-    tags: z.array(z.string()).nullish(),
-    age_limit: z.number().nullish(),
-    availability: z.string().nullish(),
-    live_status: z.string().nullish(),
-    was_live: z.boolean().nullish(),
-    is_live: z.boolean().nullish(),
-    description: z.string().nullish(),
-    thumbnail: z.string().nullish(),
-    chapters: z
-        .array(z.object({ title: z.string(), start_time: z.number(), end_time: z.number() }))
-        .nullish(),
-    heatmap: z.array(heatmapEntrySchema).nullish(),
-    automatic_captions: z.record(z.string(), z.unknown()).nullish(),
-    subtitles: z.record(z.string(), z.unknown()).nullish(),
-});
-export const CATALOG_DESCRIPTION_PREVIEW_CHARS = 500;
-/** Drops the bulk keys, so what is stored is the record rather than its attachments. */
-export function stripForStorage(raw) {
-    const kept = {};
-    for (const [key, value] of Object.entries(raw)) {
-        if (STRIPPED_KEYS.some((stripped) => stripped === key))
-            continue;
-        kept[key] = value;
-    }
-    const description = kept.description;
-    if (typeof description === 'string' && description.length > CATALOG_DESCRIPTION_PREVIEW_CHARS) {
-        kept.description = description.slice(0, CATALOG_DESCRIPTION_PREVIEW_CHARS);
-        kept.description_truncated = true;
-    }
-    return kept;
+import { videoStatsRowSchema } from './video-stats-schema.js';
+export { videoStatsRowSchema } from './video-stats-schema.js';
+export { CATALOG_DESCRIPTION_PREVIEW_CHARS, MAX_DETAIL_JSON_BYTES, STRIPPED_KEYS, stripForStorage, } from './video-stats-storage.js';
+/** `{ [key]: value }` when yt-dlp told us something, `{}` when it said null or nothing. */
+function present(key, value) {
+    const field = {};
+    if (value !== null && value !== undefined)
+        field[key] = value;
+    return field;
 }
 export function toVideoStats(row) {
     // classifyPlayability RETURNS the error rather than throwing it, so ignoring
@@ -91,38 +24,44 @@ export function toVideoStats(row) {
     const duration = row.duration ?? 0;
     const heatmap = row.heatmap ?? undefined;
     const description = row.description ?? '';
+    const music = {
+        ...present('track', row.track),
+        ...present('artist', row.artist),
+        ...present('album', row.album),
+        ...present('releaseYear', row.release_year),
+    };
+    const format = {
+        ...present('width', row.width),
+        ...present('height', row.height),
+        ...present('fps', row.fps),
+    };
     return {
         id: row.id,
         title: row.title ?? 'Unknown',
         url: watchUrl(row.id),
         channel: row.channel ?? 'Unknown',
-        ...(row.channel_id === null || row.channel_id === undefined
-            ? {}
-            : { channelId: row.channel_id }),
-        ...(row.channel_follower_count === null || row.channel_follower_count === undefined
-            ? {}
-            : { channelFollowerCount: row.channel_follower_count }),
+        ...present('channelId', row.channel_id),
+        ...present('channelFollowerCount', row.channel_follower_count),
+        ...present('channelUrl', row.channel_url),
+        ...present('uploader', row.uploader),
         uploadDate: row.upload_date ?? '',
         durationSeconds: duration,
         durationFormatted: formatDuration(Math.floor(duration)),
-        ...(row.view_count === null || row.view_count === undefined
-            ? {}
-            : { viewCount: row.view_count }),
-        ...(row.like_count === null || row.like_count === undefined
-            ? {}
-            : { likeCount: row.like_count }),
-        ...(row.comment_count === null || row.comment_count === undefined
-            ? {}
-            : { commentCount: row.comment_count }),
+        ...present('viewCount', row.view_count),
+        ...present('likeCount', row.like_count),
+        ...present('commentCount', row.comment_count),
         categories: row.categories ?? [],
         tags: row.tags ?? [],
         ageLimit: row.age_limit ?? 0,
-        ...(row.availability === null || row.availability === undefined
-            ? {}
-            : { availability: row.availability }),
-        ...(row.live_status === null || row.live_status === undefined
-            ? {}
-            : { liveStatus: row.live_status }),
+        ...present('availability', row.availability),
+        ...present('liveStatus', row.live_status),
+        ...present('license', row.license),
+        ...present('language', row.language),
+        ...present('mediaType', row.media_type),
+        ...present('playableInEmbed', row.playable_in_embed),
+        ...present('releaseTimestamp', row.release_timestamp),
+        ...(Object.keys(music).length === 0 ? {} : { music }),
+        ...(Object.keys(format).length === 0 ? {} : { video: format }),
         wasLive: row.was_live ?? false,
         chapters: (row.chapters ?? []).map((chapter) => ({
             title: chapter.title,
@@ -147,15 +86,16 @@ export function toVideoStats(row) {
             }),
         descriptionChars: description.length,
         description,
-        ...(row.thumbnail === null || row.thumbnail === undefined
-            ? {}
-            : { thumbnailUrl: row.thumbnail }),
+        ...present('thumbnailUrl', row.thumbnail),
     };
 }
 /** One `-j` read, serving info, details, chapters, captions and the heatmap. */
-export async function fetchVideoStatsRow(urlOrId) {
+export async function fetchVideoStatsRow(urlOrId, options = {}) {
     const videoId = extractVideoId(urlOrId);
-    const stdout = await runYtDlp(['-j', '--skip-download'], {
+    const args = ['-j', '--skip-download'];
+    if (options.tolerateRefusal === true)
+        args.push('--ignore-no-formats-error');
+    const stdout = await runYtDlp(args, {
         label: 'get_video_stats',
         timeoutMs: TIMEOUTS.metadata,
         target: watchUrl(videoId),

package/dist/utils/video-stats.js.map

@@ -1 +1 @@
-{"version":3,"file":"video-stats.js","sourceRoot":"","sources":["../../src/utils/video-stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;;;;GAaG;AAEH,oFAAoF;AACpF,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAE5C,2EAA2E;AAC3E,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,SAAS;IACT,mBAAmB;IACnB,oBAAoB;IACpB,WAAW;IACX,YAAY;IACZ,UAAU;IACV,SAAS;CACD,CAAC;AAEX,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IAC7B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IAChC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IACjC,sBAAsB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IAC9B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IAChC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IAChC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IACnC,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IAC3C,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;IACzC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE;IACnC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IAC/B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IAClC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IACjC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE;IAC/B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE;IAC9B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IACjC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IAC/B,QAAQ,EAAE,CAAC;SACR,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;SACpF,OAAO,EAAE;IACZ,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,OAAO,EAAE;IAC9C,kBAAkB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IAC/D,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACvD,CAAC,CAAC;AAgCH,MAAM,CAAC,MAAM,iCAAiC,GAAG,GAAG,CAAC;AAErD,wFAAwF;AACxF,MAAM,UAAU,eAAe,CAAC,GAA4B;IAC1D,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,GAAG,CAAC;YAAE,SAAS;QACjE,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACpB,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IACrC,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,MAAM,GAAG,iCAAiC,EAAE,CAAC;QAC9F,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,iCAAiC,CAAC,CAAC;QAC3E,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC;IACpC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAwC;IACnE,6EAA6E;IAC7E,qEAAqE;IACrE,sBAAsB;IACtB,MAAM,UAAU,GAAG,mBAAmB,CAAC;QACrC,YAAY,EAAE,GAAG,CAAC,YAAY,IAAI,SAAS;QAC3C,UAAU,EAAE,GAAG,CAAC,WAAW,IAAI,SAAS;KACzC,CAAC,CAAC;IACH,IAAI,UAAU,KAAK,SAAS;QAAE,MAAM,UAAU,CAAC;IAE/C,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,SAAS,CAAC;IACzC,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;IAE1C,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,SAAS;QAC7B,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,SAAS;QACjC,GAAG,CAAC,GAAG,CAAC,UAAU,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS;YACzD,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC;QAClC,GAAG,CAAC,GAAG,CAAC,sBAAsB,KAAK,IAAI,IAAI,GAAG,CAAC,sBAAsB,KAAK,SAAS;YACjF,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,oBAAoB,EAAE,GAAG,CAAC,sBAAsB,EAAE,CAAC;QACzD,UAAU,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE;QACjC,eAAe,EAAE,QAAQ;QACzB,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACvD,GAAG,CAAC,GAAG,CAAC,UAAU,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS;YACzD,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC;QAClC,GAAG,CAAC,GAAG,CAAC,UAAU,KAAK,IAAI,IAAI,GAAG,CAAC,UAAU,KAAK,SAAS;YACzD,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC;QAClC,GAAG,CAAC,GAAG,CAAC,aAAa,KAAK,IAAI,IAAI,GAAG,CAAC,aAAa,KAAK,SAAS;YAC/D,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,CAAC,aAAa,EAAE,CAAC;QACxC,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,EAAE;QAChC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE;QACpB,QAAQ,EAAE,GAAG,CAAC,SAAS,IAAI,CAAC;QAC5B,GAAG,CAAC,GAAG,CAAC,YAAY,KAAK,IAAI,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS;YAC7D,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,CAAC;QACvC,GAAG,CAAC,GAAG,CAAC,WAAW,KAAK,IAAI,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS;YAC3D,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC;QACpC,OAAO,EAAE,GAAG,CAAC,QAAQ,IAAI,KAAK;QAC9B,QAAQ,EAAE,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC/C,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,SAAS,EAAE,OAAO,CAAC,UAAU;YAC7B,OAAO,EAAE,OAAO,CAAC,QAAQ;SAC1B,CAAC,CAAC;QACH,0EAA0E;QAC1E,qCAAqC;QACrC,QAAQ,EAAE;YACR,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC;YACxC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE,CAAC;SACrD;QACD,UAAU,EAAE,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QACvD,GAAG,CAAC,OAAO,KAAK,SAAS;YACvB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBAC/B,YAAY,EAAE,KAAK,CAAC,UAAU;oBAC9B,UAAU,EAAE,KAAK,CAAC,QAAQ;oBAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;iBACnB,CAAC,CAAC;aACJ,CAAC;QACN,gBAAgB,EAAE,WAAW,CAAC,MAAM;QACpC,WAAW;QACX,GAAG,CAAC,GAAG,CAAC,SAAS,KAAK,IAAI,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS;YACvD,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC;KACrC,CAAC;AACJ,CAAC;AAED,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAe;IAEf,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,CAAC,IAAI,EAAE,iBAAiB,CAAC,EAAE;QACvD,KAAK,EAAE,iBAAiB;QACxB,SAAS,EAAE,QAAQ,CAAC,QAAQ;QAC5B,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC;KAC1B,CAAC,CAAC;IAEH,OAAO,cAAc,CAAC,MAAM,EAAE,mBAAmB,EAAE,aAAa,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe;IACjD,OAAO,YAAY,CAAC,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;AACzD,CAAC"}
+{"version":3,"file":"video-stats.js","sourceRoot":"","sources":["../../src/utils/video-stats.ts"],"names":[],"mappings":"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"}

package/dist/utils/video-stream.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Handing a video's stream to ffmpeg without downloading the file.
+ *
+ * Every tool that looks at pixels (a still, a contact sheet, scene cuts) needs the
+ * same two guarantees, so they live in one place: the media URL really is an https
+ * URL, and ffmpeg is told it may open nothing else.
+ */
+/** Up to 1080p: enough to read small text in a still. */
+export declare const DETAIL_STREAM_SELECTOR = "bestvideo[height<=1080]/best";
+/** Up to 720p: plenty for frames shrunk to fit a model's context. */
+export declare const PREVIEW_STREAM_SELECTOR = "bestvideo[height<=720]/best[height<=720]/best";
+/** The lightest stream that still shows a cut: scene detection reads every frame. */
+export declare const SCAN_STREAM_SELECTOR = "bestvideo[height<=360]/worst";
+/**
+ * ffmpeg accepts file:, pipe:, concat: and more as inputs. The only thing yt-dlp
+ * should have resolved is an https media URL, and this allowlist makes ffmpeg refuse
+ * anything else even if it had. A per-input option, so it must precede `-i`.
+ */
+export declare const FFMPEG_NETWORK_INPUT_ARGS: string[];
+export declare function resolveStreamUrl(videoId: string, selector: string, label: string): Promise<string>;
+//# sourceMappingURL=video-stream.d.ts.map

package/dist/utils/video-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-stream.d.ts","sourceRoot":"","sources":["../../src/utils/video-stream.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AAEH,yDAAyD;AACzD,eAAO,MAAM,sBAAsB,iCAAiC,CAAC;AACrE,qEAAqE;AACrE,eAAO,MAAM,uBAAuB,kDAAkD,CAAC;AACvF,qFAAqF;AACrF,eAAO,MAAM,oBAAoB,iCAAiC,CAAC;AAEnE;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,UAAkD,CAAC;AAEzF,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,CAAC,CAiBjB"}

package/dist/utils/video-stream.js

@@ -0,0 +1,36 @@
+import { YouTubeError } from './errors.js';
+import { runYtDlp } from './ytdlp.js';
+/**
+ * Handing a video's stream to ffmpeg without downloading the file.
+ *
+ * Every tool that looks at pixels (a still, a contact sheet, scene cuts) needs the
+ * same two guarantees, so they live in one place: the media URL really is an https
+ * URL, and ffmpeg is told it may open nothing else.
+ */
+/** Up to 1080p: enough to read small text in a still. */
+export const DETAIL_STREAM_SELECTOR = 'bestvideo[height<=1080]/best';
+/** Up to 720p: plenty for frames shrunk to fit a model's context. */
+export const PREVIEW_STREAM_SELECTOR = 'bestvideo[height<=720]/best[height<=720]/best';
+/** The lightest stream that still shows a cut: scene detection reads every frame. */
+export const SCAN_STREAM_SELECTOR = 'bestvideo[height<=360]/worst';
+/**
+ * ffmpeg accepts file:, pipe:, concat: and more as inputs. The only thing yt-dlp
+ * should have resolved is an https media URL, and this allowlist makes ffmpeg refuse
+ * anything else even if it had. A per-input option, so it must precede `-i`.
+ */
+export const FFMPEG_NETWORK_INPUT_ARGS = ['-protocol_whitelist', 'https,tls,tcp,crypto'];
+export async function resolveStreamUrl(videoId, selector, label) {
+    const mediaUrl = (await runYtDlp(['-f', selector, '--get-url', '--no-playlist'], {
+        label: `${label} (resolve)`,
+        target: `https://www.youtube.com/watch?v=${videoId}`,
+    }))
+        .trim()
+        .split('\n')[0];
+    if (!mediaUrl?.startsWith('https://')) {
+        throw new YouTubeError('YTDLP_FAILED', 'Could not resolve a video stream for this video.', {
+            nextStep: 'Check the video is playable, or call check_health.',
+        });
+    }
+    return mediaUrl;
+}
+//# sourceMappingURL=video-stream.js.map

package/dist/utils/video-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-stream.js","sourceRoot":"","sources":["../../src/utils/video-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;GAMG;AAEH,yDAAyD;AACzD,MAAM,CAAC,MAAM,sBAAsB,GAAG,8BAA8B,CAAC;AACrE,qEAAqE;AACrE,MAAM,CAAC,MAAM,uBAAuB,GAAG,+CAA+C,CAAC;AACvF,qFAAqF;AACrF,MAAM,CAAC,MAAM,oBAAoB,GAAG,8BAA8B,CAAC;AAEnE;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,qBAAqB,EAAE,sBAAsB,CAAC,CAAC;AAEzF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAe,EACf,QAAgB,EAChB,KAAa;IAEb,MAAM,QAAQ,GAAG,CACf,MAAM,QAAQ,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,eAAe,CAAC,EAAE;QAC7D,KAAK,EAAE,GAAG,KAAK,YAAY;QAC3B,MAAM,EAAE,mCAAmC,OAAO,EAAE;KACrD,CAAC,CACH;SACE,IAAI,EAAE;SACN,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAElB,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,YAAY,CAAC,cAAc,EAAE,kDAAkD,EAAE;YACzF,QAAQ,EAAE,oDAAoD;SAC/D,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/utils/whisper.d.ts

@@ -0,0 +1,39 @@
+import type { TranscriptSegment } from './transcript.js';
+/**
+ * Transcribing audio on this machine, with whisper.cpp.
+ *
+ * For a video with no captions this is the only way to get words out of it. It is
+ * strictly optional, like ffmpeg: nothing here runs unless a person asks for a local
+ * transcription, and no model is downloaded for them. The model is a file they point
+ * `YOUTUBE_MCP_WHISPER_MODEL` at, because which one to run is a trade between speed,
+ * disk and accuracy that this server cannot make for them.
+ */
+/** The executable's name since whisper.cpp 1.7; earlier releases called it `main`. */
+export declare const WHISPER_BINARY = "whisper-cli";
+export interface WhisperStatus {
+    installed: boolean;
+    version?: string;
+    /** The path the person configured, whether or not a file is there. */
+    modelPath?: string;
+    modelFound: boolean;
+}
+export declare function probeWhisper(): Promise<WhisperStatus>;
+/** The model to run, or the typed reason there is nothing to run. */
+export declare function requireWhisper(operation: string): Promise<string>;
+/** whisper.cpp's JSON as segments in seconds; the silence marker is dropped. */
+export declare function parseWhisperJson(raw: string): TranscriptSegment[];
+/**
+ * The language as whisper.cpp names it: the primary subtag, lower-case.
+ *
+ * Callers pass BCP-47 tags such as `pt-BR` or `zh-Hans`, and whisper.cpp knows only `pt`
+ * and `zh` and exits on anything else (measured against whisper.cpp 1.9.5).
+ */
+export declare function whisperLanguage(tag: string): string;
+/**
+ * Transcribe one audio file.
+ *
+ * The language is always explicit: left to auto-detect, a small model took English
+ * speech for French, and a transcript in the wrong language is worse than none.
+ */
+export declare function runWhisper(audioPath: string, language: string, modelPath: string, outputBase: string): Promise<TranscriptSegment[]>;
+//# sourceMappingURL=whisper.d.ts.map

package/dist/utils/whisper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whisper.d.ts","sourceRoot":"","sources":["../../src/utils/whisper.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD;;;;;;;;GAQG;AAEH,sFAAsF;AACtF,eAAO,MAAM,cAAc,gBAAgB,CAAC;AAM5C,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;CACrB;AAuBD,wBAAsB,YAAY,IAAI,OAAO,CAAC,aAAa,CAAC,CAY3D;AAED,qEAAqE;AACrE,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkCvE;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,EAAE,CA0BjE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA8B9B"}

package/dist/utils/whisper.js

@@ -0,0 +1,137 @@
+import { execa } from 'execa';
+import { readFile, rm, stat } from 'node:fs/promises';
+import { z } from 'zod';
+import { currentContext } from './context.js';
+import { envString } from './env.js';
+import { YouTubeError } from './errors.js';
+import { MILLISECONDS_PER_SECOND } from './seconds.js';
+/**
+ * Transcribing audio on this machine, with whisper.cpp.
+ *
+ * For a video with no captions this is the only way to get words out of it. It is
+ * strictly optional, like ffmpeg: nothing here runs unless a person asks for a local
+ * transcription, and no model is downloaded for them. The model is a file they point
+ * `YOUTUBE_MCP_WHISPER_MODEL` at, because which one to run is a trade between speed,
+ * disk and accuracy that this server cannot make for them.
+ */
+/** The executable's name since whisper.cpp 1.7; earlier releases called it `main`. */
+export const WHISPER_BINARY = 'whisper-cli';
+const PROBE_TIMEOUT_MS = 5_000;
+/** whisper.cpp writes this for a stretch with no speech; it is not part of what was said. */
+const SILENCE_MARKER = '[BLANK_AUDIO]';
+const whisperOutputSchema = z.object({
+    transcription: z.array(z.object({
+        offsets: z.object({ from: z.number(), to: z.number() }),
+        text: z.string(),
+    })),
+});
+function configuredModel() {
+    return envString('YOUTUBE_MCP_WHISPER_MODEL');
+}
+async function isFile(path) {
+    try {
+        return (await stat(path)).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+export async function probeWhisper() {
+    const modelPath = configuredModel();
+    const modelFound = modelPath !== undefined && (await isFile(modelPath));
+    const model = modelPath === undefined ? {} : { modelPath };
+    try {
+        const { stdout } = await execa(WHISPER_BINARY, ['--version'], { timeout: PROBE_TIMEOUT_MS });
+        const version = /version:\s*(\S+)/.exec(stdout)?.[1] ?? 'unknown';
+        return { installed: true, version, ...model, modelFound };
+    }
+    catch {
+        return { installed: false, ...model, modelFound };
+    }
+}
+/** The model to run, or the typed reason there is nothing to run. */
+export async function requireWhisper(operation) {
+    const status = await probeWhisper();
+    if (!status.installed) {
+        throw new YouTubeError('WHISPER_MISSING', `${operation} requires whisper.cpp, which is not installed.`, {
+            nextStep: 'Install whisper.cpp (macOS: `brew install whisper.cpp`; elsewhere build it from https://github.com/ggml-org/whisper.cpp) so that `whisper-cli` is on PATH, then call check_health.',
+        });
+    }
+    if (status.modelPath === undefined) {
+        throw new YouTubeError('WHISPER_MISSING', `${operation} needs a whisper model, and none is configured.`, {
+            nextStep: 'Download a ggml model file (for example ggml-base.bin from https://huggingface.co/ggerganov/whisper.cpp) and set YOUTUBE_MCP_WHISPER_MODEL to its path.',
+        });
+    }
+    if (!status.modelFound) {
+        throw new YouTubeError('WHISPER_MISSING', `The whisper model at ${status.modelPath} is not a readable file.`, { nextStep: 'Fix the path in YOUTUBE_MCP_WHISPER_MODEL, then call check_health.' });
+    }
+    return status.modelPath;
+}
+/** whisper.cpp's JSON as segments in seconds; the silence marker is dropped. */
+export function parseWhisperJson(raw) {
+    let json;
+    try {
+        json = JSON.parse(raw);
+    }
+    catch (error) {
+        throw new YouTubeError('MALFORMED_RESPONSE', 'whisper.cpp wrote output that is not JSON.', {
+            cause: error,
+        });
+    }
+    const parsed = whisperOutputSchema.safeParse(json);
+    if (!parsed.success) {
+        throw new YouTubeError('MALFORMED_RESPONSE', 'whisper.cpp wrote JSON without a transcription.', { cause: parsed.error });
+    }
+    return parsed.data.transcription
+        .map(({ offsets, text }) => ({
+        start: offsets.from / MILLISECONDS_PER_SECOND,
+        end: offsets.to / MILLISECONDS_PER_SECOND,
+        text: text.trim(),
+    }))
+        .filter((segment) => segment.text !== '' && segment.text !== SILENCE_MARKER);
+}
+/**
+ * The language as whisper.cpp names it: the primary subtag, lower-case.
+ *
+ * Callers pass BCP-47 tags such as `pt-BR` or `zh-Hans`, and whisper.cpp knows only `pt`
+ * and `zh` and exits on anything else (measured against whisper.cpp 1.9.5).
+ */
+export function whisperLanguage(tag) {
+    return (tag.split('-')[0] ?? tag).toLowerCase();
+}
+/**
+ * Transcribe one audio file.
+ *
+ * The language is always explicit: left to auto-detect, a small model took English
+ * speech for French, and a transcript in the wrong language is worse than none.
+ */
+export async function runWhisper(audioPath, language, modelPath, outputBase) {
+    const outputPath = `${outputBase}.json`;
+    try {
+        await execa(WHISPER_BINARY, [
+            '-m',
+            modelPath,
+            '-f',
+            audioPath,
+            '-l',
+            whisperLanguage(language),
+            '-oj',
+            '-of',
+            outputBase,
+            '-np',
+        ], { cancelSignal: currentContext().signal });
+        return parseWhisperJson(await readFile(outputPath, 'utf-8'));
+    }
+    catch (error) {
+        if (error instanceof YouTubeError)
+            throw error;
+        throw new YouTubeError('YTDLP_FAILED', 'whisper.cpp could not transcribe this audio.', {
+            nextStep: 'Check that the model file is a valid ggml model, or call check_health.',
+            cause: error,
+        });
+    }
+    finally {
+        await rm(outputPath, { force: true });
+    }
+}
+//# sourceMappingURL=whisper.js.map