youtube-knowledge-mcp 3.0.0 → 3.0.2

package/dist/tools/search-channels.d.ts

@@ -20,6 +20,8 @@ export declare const searchChannelsOutputSchema: {
         description: z.ZodString;
         avatarUrl: z.ZodOptional<z.ZodString>;
         bannerUrl: z.ZodOptional<z.ZodString>;
+        isVerified: z.ZodOptional<z.ZodBoolean>;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
         description: string;
         name: string;
@@ -27,8 +29,10 @@ export declare const searchChannelsOutputSchema: {
         handle: string;
         subscriberCount: number;
         channelUrl: string;
+        tags?: string[] | undefined;
         avatarUrl?: string | undefined;
         bannerUrl?: string | undefined;
+        isVerified?: boolean | undefined;
     }, {
         description: string;
         name: string;
@@ -36,8 +40,10 @@ export declare const searchChannelsOutputSchema: {
         handle: string;
         subscriberCount: number;
         channelUrl: string;
+        tags?: string[] | undefined;
         avatarUrl?: string | undefined;
         bannerUrl?: string | undefined;
+        isVerified?: boolean | undefined;
     }>, "many">;
 };
 export declare function searchChannelsHandler({ query, limit, }: {

package/dist/tools/search-channels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-channels.d.ts","sourceRoot":"","sources":["../../src/tools/search-channels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,oBAAoB;;;CAUhC,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAItC,CAAC;AAEF,wBAAsB,qBAAqB,CAAC,EAC1C,KAAK,EACL,KAAK,GACN,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,cAAc,CAAC,CA4B1B"}
+{"version":3,"file":"search-channels.d.ts","sourceRoot":"","sources":["../../src/tools/search-channels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,oBAAoB;;;CAUhC,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAItC,CAAC;AAEF,wBAAsB,qBAAqB,CAAC,EAC1C,KAAK,EACL,KAAK,GACN,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,cAAc,CAAC,CA4B1B"}

package/dist/tools/transcribe-video.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Transcribing a video's audio on this machine, for the videos YouTube has no
+ * captions for. What it writes is read back by get_transcript, search_transcript,
+ * export_subtitles and the channel brains, exactly like captions.
+ */
+export declare const transcribeVideoSchema: {
+    video: z.ZodString;
+    language: z.ZodDefault<z.ZodString>;
+    refresh: z.ZodDefault<z.ZodBoolean>;
+};
+export declare const transcribeVideoOutputSchema: {
+    videoId: z.ZodString;
+    language: z.ZodString;
+    source: z.ZodLiteral<"local-asr">;
+    segmentCount: z.ZodNumber;
+    wordCount: z.ZodNumber;
+    durationSeconds: z.ZodNumber;
+    cached: z.ZodBoolean;
+};
+export interface TranscribeVideoArgs {
+    video: string;
+    language: string;
+    refresh: boolean;
+}
+export declare function transcribeVideoHandler(args: TranscribeVideoArgs): Promise<CallToolResult>;
+//# sourceMappingURL=transcribe-video.d.ts.map

package/dist/tools/transcribe-video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcribe-video.d.ts","sourceRoot":"","sources":["../../src/tools/transcribe-video.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAKzE;;;;GAIG;AAEH,eAAO,MAAM,qBAAqB;;;;CAYjC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;CAQvC,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAwB/F"}

package/dist/tools/transcribe-video.js

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+import { toolResult } from '../utils/format.js';
+import { transcribeLocally } from '../utils/local-transcription.js';
+import { formatTimestamp } from '../utils/transcript.js';
+/**
+ * Transcribing a video's audio on this machine, for the videos YouTube has no
+ * captions for. What it writes is read back by get_transcript, search_transcript,
+ * export_subtitles and the channel brains, exactly like captions.
+ */
+export const transcribeVideoSchema = {
+    video: z.string().describe('YouTube video ID (e.g., dQw4w9WgXcQ) or full URL'),
+    language: z
+        .string()
+        .default('en')
+        .describe('The language spoken in the video, as a tag such as en, fr or pt-BR. Always set it explicitly: guessing the language from the audio is unreliable. Default: en'),
+    refresh: z
+        .boolean()
+        .default(false)
+        .describe('Transcribe again even if a transcription was already kept. Default: false'),
+};
+export const transcribeVideoOutputSchema = {
+    videoId: z.string(),
+    language: z.string(),
+    source: z.literal('local-asr'),
+    segmentCount: z.number().int(),
+    wordCount: z.number().int(),
+    durationSeconds: z.number().describe('Where the last transcribed segment ends'),
+    cached: z.boolean().describe('True when a kept transcription was returned without redoing it'),
+};
+export async function transcribeVideoHandler(args) {
+    const { video, language, refresh } = args;
+    const result = await transcribeLocally(video, { language, refresh });
+    const wordCount = result.transcript.split(/\s+/).filter(Boolean).length;
+    const durationSeconds = result.segments.at(-1)?.end ?? 0;
+    const lines = [
+        result.cached ? '✓ Already transcribed locally' : '✓ Transcribed locally',
+        '',
+        `${result.segments.length.toLocaleString()} segments, ${wordCount.toLocaleString()} words, ${formatTimestamp(durationSeconds)} (${result.language})`,
+        '',
+        'This is a machine transcription, not YouTube captions. Read it with get_transcript, find a phrase with search_transcript, or export it with export_subtitles.',
+    ];
+    return toolResult(lines.join('\n'), {
+        videoId: result.videoId,
+        language: result.language,
+        source: result.source,
+        segmentCount: result.segments.length,
+        wordCount,
+        durationSeconds,
+        cached: result.cached,
+    });
+}
+//# sourceMappingURL=transcribe-video.js.map

package/dist/tools/transcribe-video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcribe-video.js","sourceRoot":"","sources":["../../src/tools/transcribe-video.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;;;GAIG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IAC9E,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CACP,+JAA+J,CAChK;IACH,OAAO,EAAE,CAAC;SACP,OAAO,EAAE;SACT,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,2EAA2E,CAAC;CACzF,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IAC9B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC3B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;IAC/E,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;CAC/F,CAAC;AAQF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAyB;IACpE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC1C,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;IAErE,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IACxE,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAEzD,MAAM,KAAK,GAAG;QACZ,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,uBAAuB;QACzE,EAAE;QACF,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,cAAc,SAAS,CAAC,cAAc,EAAE,WAAW,eAAe,CAAC,eAAe,CAAC,KAAK,MAAM,CAAC,QAAQ,GAAG;QACpJ,EAAE;QACF,+JAA+J;KAChK,CAAC;IAEF,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAClC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,YAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;QACpC,SAAS;QACT,eAAe;QACf,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/brain-fusion.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Merging the results of searching several corpora.
+ *
+ * A BM25 score depends on the corpus it came from: the same word is rare in one
+ * channel and common in another, so a 90 from one and a 3 from another say nothing
+ * about which passage answers better. Comparing them would quietly let the channel
+ * with the most distinctive vocabulary win every query. Rank is the one thing the
+ * lists share, so results are interleaved by rank, best of every list first.
+ */
+export interface RankedList<T> {
+    /** What the list came from, carried onto each of its results. */
+    source: string;
+    /** Best first, as the corpus's own search returned them. */
+    items: T[];
+}
+export interface Interleaved<T> {
+    source: string;
+    item: T;
+}
+/** Up to `limit` results: by rank, then the higher score, then the earlier list. */
+export declare function interleaveByRank<T extends {
+    score: number;
+}>(lists: RankedList<T>[], limit: number): Interleaved<T>[];
+//# sourceMappingURL=brain-fusion.d.ts.map

package/dist/utils/brain-fusion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-fusion.d.ts","sourceRoot":"","sources":["../../src/utils/brain-fusion.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,KAAK,EAAE,CAAC,EAAE,CAAC;CACZ;AAED,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,CAAC,CAAC;CACT;AAOD,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,CAAC,SAAS;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAC1D,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,EACtB,KAAK,EAAE,MAAM,GACZ,WAAW,CAAC,CAAC,CAAC,EAAE,CASlB"}

package/dist/utils/brain-fusion.js

@@ -0,0 +1,18 @@
+/**
+ * Merging the results of searching several corpora.
+ *
+ * A BM25 score depends on the corpus it came from: the same word is rare in one
+ * channel and common in another, so a 90 from one and a 3 from another say nothing
+ * about which passage answers better. Comparing them would quietly let the channel
+ * with the most distinctive vocabulary win every query. Rank is the one thing the
+ * lists share, so results are interleaved by rank, best of every list first.
+ */
+/** Up to `limit` results: by rank, then the higher score, then the earlier list. */
+export function interleaveByRank(lists, limit) {
+    const candidates = lists.flatMap((list, order) => list.items.map((item, rank) => ({ source: list.source, item, rank, order })));
+    return candidates
+        .sort((a, b) => a.rank - b.rank || b.item.score - a.item.score || a.order - b.order)
+        .slice(0, limit)
+        .map(({ source, item }) => ({ source, item }));
+}
+//# sourceMappingURL=brain-fusion.js.map

package/dist/utils/brain-fusion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-fusion.js","sourceRoot":"","sources":["../../src/utils/brain-fusion.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmBH,oFAAoF;AACpF,MAAM,UAAU,gBAAgB,CAC9B,KAAsB,EACtB,KAAa;IAEb,MAAM,UAAU,GAAmB,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAC/D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAC7E,CAAC;IAEF,OAAO,UAAU;SACd,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;SACnF,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;SACf,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/utils/channel-playlists.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The playlists a channel has published, from its playlists tab.
+ *
+ * Verified against yt-dlp 2026.07.04 on a real channel: a flat entry carries the
+ * playlist's id, title and url, and no video count, so none is promised here.
+ */
+export declare const MAX_CHANNEL_PLAYLISTS = 200;
+export interface ChannelPlaylist {
+    id: string;
+    title: string;
+    url: string;
+}
+export interface ChannelPlaylists {
+    channelId: string;
+    channelName: string;
+    playlists: ChannelPlaylist[];
+    /** True when the limit was reached, so the channel may have more. */
+    mayHaveMore: boolean;
+}
+export declare function listChannelPlaylists(channel: string, limit: number): Promise<ChannelPlaylists>;
+//# sourceMappingURL=channel-playlists.d.ts.map

package/dist/utils/channel-playlists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-playlists.d.ts","sourceRoot":"","sources":["../../src/utils/channel-playlists.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AAEH,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAUzC,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,qEAAqE;IACrE,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,gBAAgB,CAAC,CAuC3B"}

package/dist/utils/channel-playlists.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+import { TIMEOUTS, parseYtDlpJsonLines, runYtDlp } from './ytdlp.js';
+import { isAbsentTab } from './harvest-catalog.js';
+import { getChannelInfo } from './youtube-channel.js';
+import { resolveListTarget } from './youtube-url.js';
+/**
+ * The playlists a channel has published, from its playlists tab.
+ *
+ * Verified against yt-dlp 2026.07.04 on a real channel: a flat entry carries the
+ * playlist's id, title and url, and no video count, so none is promised here.
+ */
+export const MAX_CHANNEL_PLAYLISTS = 200;
+const PLAYLIST_PRINT_TEMPLATE = '%(.{id,title,url})j';
+const playlistEntrySchema = z.object({
+    id: z.string(),
+    title: z.string().nullish(),
+    url: z.string().nullish(),
+});
+export async function listChannelPlaylists(channel, limit) {
+    const info = await getChannelInfo(channel);
+    let stdout;
+    try {
+        stdout = await runYtDlp([
+            '--skip-download',
+            '--flat-playlist',
+            '--lazy-playlist',
+            '--print',
+            PLAYLIST_PRINT_TEMPLATE,
+            '--playlist-items',
+            `1:${String(limit)}`,
+        ], {
+            label: 'list_channel_playlists',
+            timeoutMs: TIMEOUTS.transcript,
+            target: resolveListTarget(`${info.channelUrl}/playlists`),
+        });
+    }
+    catch (error) {
+        // A channel without a playlists tab has no playlists: an answer, not a failure.
+        if (isAbsentTab(error))
+            stdout = '';
+        else
+            throw error;
+    }
+    const playlists = parseYtDlpJsonLines(stdout, playlistEntrySchema).map((entry) => ({
+        id: entry.id,
+        title: entry.title ?? 'Untitled',
+        url: entry.url ?? `https://www.youtube.com/playlist?list=${entry.id}`,
+    }));
+    return {
+        channelId: info.channelId,
+        channelName: info.name,
+        playlists,
+        mayHaveMore: playlists.length >= limit,
+    };
+}
+//# sourceMappingURL=channel-playlists.js.map

package/dist/utils/channel-playlists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-playlists.js","sourceRoot":"","sources":["../../src/utils/channel-playlists.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AAEtD,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;IAC3B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE;CAC1B,CAAC,CAAC;AAgBH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAe,EACf,KAAa;IAEb,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IAE3C,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,QAAQ,CACrB;YACE,iBAAiB;YACjB,iBAAiB;YACjB,iBAAiB;YACjB,SAAS;YACT,uBAAuB;YACvB,kBAAkB;YAClB,KAAK,MAAM,CAAC,KAAK,CAAC,EAAE;SACrB,EACD;YACE,KAAK,EAAE,wBAAwB;YAC/B,SAAS,EAAE,QAAQ,CAAC,UAAU;YAC9B,MAAM,EAAE,iBAAiB,CAAC,GAAG,IAAI,CAAC,UAAU,YAAY,CAAC;SAC1D,CACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,gFAAgF;QAChF,IAAI,WAAW,CAAC,KAAK,CAAC;YAAE,MAAM,GAAG,EAAE,CAAC;;YAC/B,MAAM,KAAK,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAG,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACjF,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,UAAU;QAChC,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,yCAAyC,KAAK,CAAC,EAAE,EAAE;KACtE,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,WAAW,EAAE,IAAI,CAAC,IAAI;QACtB,SAAS;QACT,WAAW,EAAE,SAAS,CAAC,MAAM,IAAI,KAAK;KACvC,CAAC;AACJ,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"clips.d.ts","sourceRoot":"","sources":["../../src/utils/clips.ts"],"names":[],"mappings":"AA0BA,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgBhE;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1D,OAAO,CAAC;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAwCjF;AAMD,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,YAAY,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAChE,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,UAAU,CAAC,CA2DrB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,KAAK,GAAG,KAAK,CAAA;CAAE,GACrD,OAAO,CAAC,WAAW,CAAC,CAoEtB;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC"}
+{"version":3,"file":"clips.d.ts","sourceRoot":"","sources":["../../src/utils/clips.ts"],"names":[],"mappings":"AA+BA,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgBhE;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1D,OAAO,CAAC;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAwCjF;AAMD,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,YAAY,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EAChE,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,UAAU,CAAC,CA2DrB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,KAAK,GAAG,KAAK,CAAA;CAAE,GACrD,OAAO,CAAC,WAAW,CAAC,CAkDtB;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC"}

package/dist/utils/clips.js

@@ -10,6 +10,7 @@ import { formatSrtTimestamp } from './transcript.js';
 import { getChapters, getVideoInfo } from './youtube.js';
 import { resolveChapter } from './chapters.js';
 import { dataDir } from './paths.js';
+import { DETAIL_STREAM_SELECTOR, FFMPEG_NETWORK_INPUT_ARGS, resolveStreamUrl, } from './video-stream.js';
 /**
  * Pulling usable excerpts out of a video for editing.
  *
@@ -147,26 +148,11 @@ export async function extractFrame(video, timestamp, options) {
         throw new YouTubeError('INVALID_INPUT', `${Math.round(timestamp)}s is past the end of this ${info.duration}s video.`, { nextStep: 'Pick a timestamp inside the video.' });
     }
     await mkdir(targetDir, { recursive: true });
-    const url = `https://www.youtube.com/watch?v=${info.id}`;
-    const mediaUrl = (await runYtDlp(['-f', 'bestvideo[height<=1080]/best', '--get-url', '--no-playlist'], {
-        label: 'extract_frame (resolve)',
-        target: url,
-    }))
-        .trim()
-        .split('\n')[0];
-    // ffmpeg accepts file:, pipe:, concat: and more as inputs; the only thing
-    // yt-dlp should have resolved is an https media URL, and the allowlist
-    // below makes ffmpeg refuse anything else even if it had.
-    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.',
-        });
-    }
+    const mediaUrl = await resolveStreamUrl(info.id, DETAIL_STREAM_SELECTOR, 'extract_frame');
     const filePath = join(targetDir, `${safeStem(info.title, info.id)} [${Math.round(timestamp)}s].${options.format}`);
     try {
         await execa('ffmpeg', [
-            '-protocol_whitelist',
-            'https,tls,tcp,crypto',
+            ...FFMPEG_NETWORK_INPUT_ARGS,
             // -ss before -i seeks without decoding everything up to that point.
             '-ss',
             String(timestamp),

package/dist/utils/clips.js.map

@@ -1 +1 @@
-{"version":3,"file":"clips.js","sourceRoot":"","sources":["../../src/utils/clips.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"clips.js","sourceRoot":"","sources":["../../src/utils/clips.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;GAOG;AAEH,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AACnC,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;AACrC,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;AAgB3C;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,QAAgB;IACtD,MAAM,OAAO,GAAG,KAAK;QACnB,yEAAyE;QACzE,qEAAqE;SACpE,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;QACrB,sEAAsE;QACtE,uEAAuE;SACtE,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;SACtB,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;QAC9B,kFAAkF;SACjF,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;SACnB,IAAI,EAAE;SACN,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SACZ,IAAI,EAAE,CAAC;IAEV,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC;AAC7C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAa,EACb,OAA2D;IAE3D,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;IAEvC,IAAI,KAAgB,CAAC;IAErB,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,cAAc,CAC1B,MAAM,WAAW,CAAC,KAAK,CAAC,EACxB,OAAO,CAAC,OAAO,EACf,6BAA6B,CAC9B,CAAC;QACF,KAAK,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;IACzD,CAAC;SAAM,CAAC;QACN,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YAC7D,MAAM,IAAI,YAAY,CAAC,eAAe,EAAE,gDAAgD,EAAE;gBACxF,QAAQ,EAAE,6EAA6E;aACxF,CAAC,CAAC;QACL,CAAC;QACD,KAAK,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;IACrD,CAAC;IAED,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC7B,MAAM,IAAI,YAAY,CAAC,eAAe,EAAE,+BAA+B,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACtD,MAAM,IAAI,YAAY,CACpB,eAAe,EACf,UAAU,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,8BAA8B,IAAI,CAAC,QAAQ,UAAU,EACtF,EAAE,QAAQ,EAAE,qCAAqC,EAAE,CACpD,CAAC;IACJ,CAAC;IAED,6EAA6E;IAC7E,+BAA+B;IAC/B,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnD,KAAK,GAAG,EAAE,GAAG,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3C,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;AACjF,CAAC;AAED,SAAS,UAAU,CAAC,KAAgB;IAClC,OAAO,IAAI,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;AACpH,CAAC;AAYD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAa,EACb,YAAgE,EAChE,OAA2B;IAE3B,0EAA0E;IAC1E,2DAA2D;IAC3D,MAAM,aAAa,CAAC,iBAAiB,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAEjE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IAC1E,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,MAAM,IAAI,GAAG,GAAG,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;IACjG,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,UAAU,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,mCAAmC,OAAO,EAAE,CAAC;IAEzD,MAAM,IAAI,GAAG;QACX,IAAI;QACJ,OAAO,CAAC,cAAc;QACtB,qBAAqB;QACrB,UAAU,CAAC,KAAK,CAAC;QACjB,IAAI;QACJ,cAAc;QACd,eAAe;KAChB,CAAC;IAEF,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,4EAA4E;QAC5E,uDAAuD;QACvD,IAAI,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,gBAAgB,EAAE,OAAO,CAAC,WAAW,IAAI,KAAK,CAAC,CAAC;IAC/E,CAAC;SAAM,CAAC;QACN,IAAI,CAAC,IAAI,CAAC,uBAAuB,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;IAED,yEAAyE;IACzE,yEAAyE;IACzE,uDAAuD;IACvD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IAE1C,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE;QAClC,KAAK,EAAE,cAAc;QACrB,SAAS,EAAE,QAAQ,CAAC,QAAQ;QAC5B,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,GAAG;KACZ,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;IACzF,MAAM,QAAQ,GACZ,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC;IAElG,OAAO;QACL,OAAO;QACP,KAAK;QACL,QAAQ;QACR,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,QAAQ,EAAE,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK;KAClC,CAAC;AACJ,CAAC;AASD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAa,EACb,SAAiB,EACjB,OAAsD;IAEtD,MAAM,aAAa,CAAC,kBAAkB,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAElE,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,CAAC;IAEvC,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,SAAS,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACpD,MAAM,IAAI,YAAY,CACpB,eAAe,EACf,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,6BAA6B,IAAI,CAAC,QAAQ,UAAU,EAC5E,EAAE,QAAQ,EAAE,oCAAoC,EAAE,CACnD,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,EAAE,EAAE,sBAAsB,EAAE,eAAe,CAAC,CAAC;IAE1F,MAAM,QAAQ,GAAG,IAAI,CACnB,SAAS,EACT,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,OAAO,CAAC,MAAM,EAAE,CACjF,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,KAAK,CACT,QAAQ,EACR;YACE,GAAG,yBAAyB;YAC5B,oEAAoE;YACpE,KAAK;YACL,MAAM,CAAC,SAAS,CAAC;YACjB,IAAI;YACJ,QAAQ;YACR,WAAW;YACX,GAAG;YACH,MAAM;YACN,GAAG;YACH,IAAI;YACJ,QAAQ;SACT,EACD,EAAE,OAAO,EAAE,QAAQ,CAAC,UAAU,EAAE,CACjC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,YAAY,CAAC,cAAc,EAAE,sCAAsC,EAAE;YAC7E,QAAQ,EAAE,2EAA2E;YACrF,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/utils/concat.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Joining clips into one video, in the order given.
+ *
+ * The inputs are files already on this machine, typically what extract_clip wrote.
+ * They are re-encoded rather than copied, because clips cut at different moments or
+ * from different sources rarely share the exact stream parameters a copy needs.
+ */
+export declare const MIN_CONCAT_FILES = 2;
+export declare const MAX_CONCAT_FILES = 20;
+export interface ConcatResult {
+    filePath: string;
+    clips: number;
+    bytes: number;
+}
+export declare function concatClips(inputs: string[], options: {
+    name?: string;
+    outputDir?: string;
+}): Promise<ConcatResult>;
+//# sourceMappingURL=concat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"concat.d.ts","sourceRoot":"","sources":["../../src/utils/concat.ts"],"names":[],"mappings":"AAWA;;;;;;GAMG;AAEH,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAKnC,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AA8DD,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,YAAY,CAAC,CAwEvB"}

package/dist/utils/concat.js

@@ -0,0 +1,135 @@
+import { createHash } from 'node:crypto';
+import { mkdir, mkdtemp, rm, stat, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { safeStem } from './clips.js';
+import { YouTubeError } from './errors.js';
+import { runFfmpeg } from './ffmpeg.js';
+import { dataDir } from './paths.js';
+import { requireFfmpeg } from './preflight.js';
+import { assertInsideHome, resolveOutputDir } from './validate.js';
+import { TIMEOUTS } from './ytdlp.js';
+/**
+ * Joining clips into one video, in the order given.
+ *
+ * The inputs are files already on this machine, typically what extract_clip wrote.
+ * They are re-encoded rather than copied, because clips cut at different moments or
+ * from different sources rarely share the exact stream parameters a copy needs.
+ */
+export const MIN_CONCAT_FILES = 2;
+export const MAX_CONCAT_FILES = 20;
+const MONTAGES_DIR = dataDir('montages');
+const NAME_HASH_LENGTH = 8;
+/** A path as one entry of ffmpeg's concat list: single-quoted, with any quote escaped. */
+function listEntry(path) {
+    return `file '${path.replace(/'/g, `'\\''`)}'`;
+}
+async function exists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Where the result may go.
+ *
+ * Never onto one of the clips being joined: ffmpeg would read and write the same file
+ * and destroy it. And never over a file the caller did not make: a name the caller
+ * chose can collide with anything in the folder, so an existing file is refused. A name
+ * this server derived from the inputs is its own, so repeating the call rewrites it.
+ */
+async function assertSafeOutput(filePath, inputs, chosenName) {
+    if (inputs.includes(filePath)) {
+        throw new YouTubeError('INVALID_INPUT', `The result would overwrite ${filePath}, a clip being joined.`, {
+            nextStep: 'Choose a different name, or another outputDir.',
+        });
+    }
+    if (chosenName && (await exists(filePath))) {
+        throw new YouTubeError('INVALID_INPUT', `${filePath} already exists.`, {
+            nextStep: 'Choose a different name, or remove the existing file first.',
+        });
+    }
+}
+async function assertReadableFile(path) {
+    let isFile;
+    try {
+        isFile = (await stat(path)).isFile();
+    }
+    catch (error) {
+        throw new YouTubeError('NOT_FOUND', `There is no file at ${path}.`, {
+            nextStep: 'Pass the paths extract_clip returned, in the order you want them.',
+            cause: error,
+        });
+    }
+    if (!isFile) {
+        throw new YouTubeError('INVALID_INPUT', `${path} is not a file.`, {
+            nextStep: 'Pass paths to video files, not folders.',
+        });
+    }
+}
+export async function concatClips(inputs, options) {
+    if (inputs.length < MIN_CONCAT_FILES || inputs.length > MAX_CONCAT_FILES) {
+        throw new YouTubeError('INVALID_INPUT', `Join between ${String(MIN_CONCAT_FILES)} and ${String(MAX_CONCAT_FILES)} clips at a time.`, { nextStep: 'Join in stages: concatenate groups, then concatenate the results.' });
+    }
+    await requireFfmpeg('Joining clips');
+    const targetDir = resolveOutputDir(options.outputDir, MONTAGES_DIR);
+    const paths = inputs.map((input) => assertInsideHome(input, 'clip'));
+    for (const path of paths)
+        await assertReadableFile(path);
+    const hash = createHash('sha256')
+        .update(paths.join('\n'))
+        .digest('hex')
+        .slice(0, NAME_HASH_LENGTH);
+    const stem = options.name === undefined ? `montage-${hash}` : safeStem(options.name, `montage-${hash}`);
+    const filePath = join(targetDir, `${stem}.mp4`);
+    await assertSafeOutput(filePath, paths, options.name !== undefined);
+    const resultExisted = await exists(filePath);
+    await mkdir(targetDir, { recursive: true });
+    // One folder per call: two calls joining the same clips must not share, and then
+    // delete, each other's list.
+    const workDir = await mkdtemp(join(targetDir, '.concat-'));
+    const listPath = join(workDir, 'list.txt');
+    await writeFile(listPath, `${paths.map(listEntry).join('\n')}\n`, 'utf-8');
+    try {
+        await runFfmpeg([
+            // The list is the only thing ffmpeg reads, and it names files only.
+            '-protocol_whitelist',
+            'file',
+            '-f',
+            'concat',
+            // Paths in the list are absolute and already checked above.
+            '-safe',
+            '0',
+            '-i',
+            listPath,
+            '-c:v',
+            'libx264',
+            '-c:a',
+            'aac',
+            '-movflags',
+            '+faststart',
+            '-y',
+            filePath,
+        ], {
+            failure: 'ffmpeg could not join those clips.',
+            nextStep: 'Check that every file is a playable video, or call check_health.',
+            // Joining re-encodes, so it takes as long as the clips do; the client's
+            // cancellation is the lever, as for a download.
+            timeoutMs: TIMEOUTS.download,
+        });
+    }
+    catch (error) {
+        // Only a file this call began is removed: before it, nothing existed at that path
+        // unless the name was derived, and a derived name is this server's own.
+        if (!resultExisted)
+            await rm(filePath, { force: true });
+        throw error;
+    }
+    finally {
+        await rm(workDir, { recursive: true, force: true });
+    }
+    return { filePath, clips: paths.length, bytes: (await stat(filePath)).size };
+}
+//# sourceMappingURL=concat.js.map

package/dist/utils/concat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concat.js","sourceRoot":"","sources":["../../src/utils/concat.ts"],"names":[],"mappings":"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"}

package/dist/utils/contact-sheet.d.ts

@@ -0,0 +1,28 @@
+import type { FramePlanRequest } from './frame-plan.js';
+/**
+ * A whole video's worth of looking in one picture.
+ *
+ * A model reading a video does not need every frame; it needs to see the shape of
+ * it. Tiling a couple of dozen small stills into one image is a single inline
+ * block instead of two dozen, and the order of the cells is the order of the
+ * timestamps returned beside it, so no text has to be burned into the pixels.
+ */
+/** Each cell's width; four columns come to about 1300px, sharp but still a single block. */
+export declare const SHEET_TILE_WIDTH = 320;
+export declare const MAX_SHEET_FRAMES = 24;
+export declare const DEFAULT_SHEET_COLUMNS = 4;
+export interface ContactSheet {
+    bytes: Buffer;
+    columns: number;
+    rows: number;
+}
+export interface VideoContactSheet extends ContactSheet {
+    videoId: string;
+    title: string;
+    duration: number;
+    /** One per cell, left to right then top to bottom. */
+    timestamps: number[];
+}
+export declare function buildContactSheet(frames: Buffer[], columns: number): Promise<ContactSheet>;
+export declare function captureContactSheet(video: string, request: FramePlanRequest, columns: number): Promise<VideoContactSheet>;
+//# sourceMappingURL=contact-sheet.d.ts.map

package/dist/utils/contact-sheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contact-sheet.d.ts","sourceRoot":"","sources":["../../src/utils/contact-sheet.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAIxD;;;;;;;GAOG;AAEH,4FAA4F;AAC5F,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAIvC,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,sDAAsD;IACtD,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAqChG;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,iBAAiB,CAAC,CAkB5B"}

package/dist/utils/contact-sheet.js

@@ -0,0 +1,65 @@
+import { YouTubeError } from './errors.js';
+import { FFMPEG_JPEG_QUALITY, runFfmpeg } from './ffmpeg.js';
+import { captureFrames } from './frames.js';
+import { TIMEOUTS } from './ytdlp.js';
+/**
+ * A whole video's worth of looking in one picture.
+ *
+ * A model reading a video does not need every frame; it needs to see the shape of
+ * it. Tiling a couple of dozen small stills into one image is a single inline
+ * block instead of two dozen, and the order of the cells is the order of the
+ * timestamps returned beside it, so no text has to be burned into the pixels.
+ */
+/** Each cell's width; four columns come to about 1300px, sharp but still a single block. */
+export const SHEET_TILE_WIDTH = 320;
+export const MAX_SHEET_FRAMES = 24;
+export const DEFAULT_SHEET_COLUMNS = 4;
+const TILE_GAP = 4;
+export async function buildContactSheet(frames, columns) {
+    if (frames.length === 0) {
+        throw new YouTubeError('INVALID_INPUT', 'A contact sheet needs at least one frame.');
+    }
+    // A grid wider than the frames it holds is only empty margin.
+    const width = Math.max(1, Math.min(columns, frames.length));
+    const rows = Math.ceil(frames.length / width);
+    const failure = 'ffmpeg could not assemble the contact sheet.';
+    const nextStep = 'Try fewer frames, or check that ffmpeg is working.';
+    const { stdout } = await runFfmpeg([
+        '-f',
+        'image2pipe',
+        '-c:v',
+        'mjpeg',
+        '-i',
+        'pipe:0',
+        '-vf',
+        `tile=${String(width)}x${String(rows)}:margin=${String(TILE_GAP)}:padding=${String(TILE_GAP)}:color=black`,
+        '-frames:v',
+        '1',
+        '-q:v',
+        FFMPEG_JPEG_QUALITY,
+        '-f',
+        'image2pipe',
+        '-c:v',
+        'mjpeg',
+        'pipe:1',
+    ], { failure, nextStep, timeoutMs: TIMEOUTS.transcript, input: Buffer.concat(frames) });
+    if (stdout.byteLength === 0)
+        throw new YouTubeError('YTDLP_FAILED', failure, { nextStep });
+    return { bytes: stdout, columns: width, rows };
+}
+export async function captureContactSheet(video, request, columns) {
+    const batch = await captureFrames(video, request, {
+        width: SHEET_TILE_WIDTH,
+        maxFrames: MAX_SHEET_FRAMES,
+        label: 'Contact sheet',
+    });
+    const sheet = await buildContactSheet(batch.frames.map((frame) => frame.bytes), columns);
+    return {
+        ...sheet,
+        videoId: batch.videoId,
+        title: batch.title,
+        duration: batch.duration,
+        timestamps: batch.frames.map((frame) => frame.timestamp),
+    };
+}
+//# sourceMappingURL=contact-sheet.js.map

package/dist/utils/contact-sheet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contact-sheet.js","sourceRoot":"","sources":["../../src/utils/contact-sheet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;;GAOG;AAEH,4FAA4F;AAC5F,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC;AACpC,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AACnC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEvC,MAAM,QAAQ,GAAG,CAAC,CAAC;AAgBnB,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAgB,EAAE,OAAe;IACvE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,YAAY,CAAC,eAAe,EAAE,2CAA2C,CAAC,CAAC;IACvF,CAAC;IAED,8DAA8D;IAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;IAE9C,MAAM,OAAO,GAAG,8CAA8C,CAAC;IAC/D,MAAM,QAAQ,GAAG,oDAAoD,CAAC;IAEtE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAChC;QACE,IAAI;QACJ,YAAY;QACZ,MAAM;QACN,OAAO;QACP,IAAI;QACJ,QAAQ;QACR,KAAK;QACL,QAAQ,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,QAAQ,CAAC,YAAY,MAAM,CAAC,QAAQ,CAAC,cAAc;QAC1G,WAAW;QACX,GAAG;QACH,MAAM;QACN,mBAAmB;QACnB,IAAI;QACJ,YAAY;QACZ,MAAM;QACN,OAAO;QACP,QAAQ;KACT,EACD,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CACpF,CAAC;IAEF,IAAI,MAAM,CAAC,UAAU,KAAK,CAAC;QAAE,MAAM,IAAI,YAAY,CAAC,cAAc,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC3F,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,KAAa,EACb,OAAyB,EACzB,OAAe;IAEf,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE;QAChD,KAAK,EAAE,gBAAgB;QACvB,SAAS,EAAE,gBAAgB;QAC3B,KAAK,EAAE,eAAe;KACvB,CAAC,CAAC;IACH,MAAM,KAAK,GAAG,MAAM,iBAAiB,CACnC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EACxC,OAAO,CACR,CAAC;IAEF,OAAO;QACL,GAAG,KAAK;QACR,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;KACzD,CAAC;AACJ,CAAC"}