youtube-knowledge-mcp 2.1.0 → 3.0.0

package/dist/tools/clips.js

@@ -1,12 +1,12 @@
 import { z } from 'zod';
-import { join } from 'node:path';
-import { mkdir, writeFile } from 'node:fs/promises';
 import { fileResult, toolResult } from '../utils/format.js';
 import { clipResultSchema } from '../schemas.js';
-import { parseTimestamp, resolveOutputDir } from '../utils/validate.js';
-import { extractClip, extractFrame, safeStem, subtitlesDir } from '../utils/clips.js';
-import { getTranscript } from '../utils/youtube.js';
-import { formatTimestamp, segmentsToText, toSrt, toVtt } from '../utils/transcript.js';
+import { parseTimestamp } from '../utils/validate.js';
+import { extractClip } from '../utils/clips.js';
+import { QUALITY_FORMAT_SELECTORS } from '../utils/youtube.js';
+import { inBatches } from '../utils/batches.js';
+import { concurrencyState } from '../utils/ytdlp.js';
+import { formatTimestamp } from '../utils/transcript.js';
 import { asYouTubeError } from '../utils/errors.js';
 import { reportProgress, throwIfAborted } from '../utils/context.js';
 /**
@@ -37,15 +37,15 @@ const RANGE_FIELDS = {
         .optional()
         .describe('Where to write the file. Must be inside your home directory.'),
 };
-const QUALITY_SELECTORS = {
-    best: 'bestvideo*+bestaudio/best',
-    '2160p': 'bestvideo[height<=2160]+bestaudio/best[height<=2160]/best',
-    '1440p': 'bestvideo[height<=1440]+bestaudio/best[height<=1440]/best',
-    '1080p': 'bestvideo[height<=1080]+bestaudio/best[height<=1080]/best',
-    '720p': 'bestvideo[height<=720]+bestaudio/best[height<=720]/best',
-    '480p': 'bestvideo[height<=480]+bestaudio/best[height<=480]/best',
-    '360p': 'bestvideo[height<=360]+bestaudio/best[height<=360]/best',
-};
+/**
+ * The one format-selector table, shared with download_video. A second copy
+ * lived here with shorter fallback chains, so a clip could fail on a video the
+ * same quality preset downloaded fine.
+ */
+function clipSelector(quality) {
+    const known = Object.keys(QUALITY_FORMAT_SELECTORS).find((key) => key === quality);
+    return QUALITY_FORMAT_SELECTORS[known ?? '1080p'];
+}
 function parseRange(args) {
     return {
         start: args.start === undefined ? undefined : parseTimestamp(args.start, 'start'),
@@ -66,7 +66,7 @@ export const extractClipSchema = {
 export const extractClipOutputSchema = clipResultSchema.shape;
 export async function extractClipHandler(args) {
     const result = await extractClip(args.video, parseRange(args), {
-        formatSelector: QUALITY_SELECTORS[args.quality] ?? QUALITY_SELECTORS['1080p'] ?? 'best',
+        formatSelector: clipSelector(args.quality),
         outputDir: args.outputDir,
         preciseCuts: args.preciseCuts,
         container: 'mp4',
@@ -149,131 +149,55 @@ export const extractClipsOutputSchema = {
     requested: z.number().int(),
     succeeded: z.number().int(),
 };
+/**
+ * Several ranges from one video, cut as many at a time as the yt-dlp limiter
+ * allows. Twenty clips used to run one after another while the limiter sat
+ * idle; the results still come back in the order the ranges were given.
+ */
 export async function extractClipsHandler(args) {
-    const lines = [];
-    const clips = [];
-    const failures = [];
-    let succeeded = 0;
-    for (const [index, range] of args.ranges.entries()) {
+    let done = 0;
+    const outcomes = await inBatches(args.ranges, concurrencyState().limit, async (range) => {
         throwIfAborted();
-        reportProgress(index, args.ranges.length, `Cutting clip ${index + 1} of ${args.ranges.length}`);
         try {
-            const result = await extractClip(args.video, parseRange({ start: range.start, end: range.end }), {
-                formatSelector: QUALITY_SELECTORS[args.quality] ?? QUALITY_SELECTORS['1080p'] ?? 'best',
+            const result = await extractClip(args.video, parseRange(range), {
+                formatSelector: clipSelector(args.quality),
                 outputDir: args.outputDir,
                 preciseCuts: args.preciseCuts,
                 container: 'mp4',
             });
-            lines.push(`✓ ${formatTimestamp(result.start)}–${formatTimestamp(result.end)}  ${result.filePath}`);
-            clips.push({
-                videoId: result.videoId,
-                title: result.title,
-                filePath: result.filePath,
-                startSeconds: result.start,
-                endSeconds: result.end,
-                durationSeconds: result.duration,
-            });
-            succeeded++;
+            return {
+                ok: true,
+                line: `✓ ${formatTimestamp(result.start)}–${formatTimestamp(result.end)}  ${result.filePath}`,
+                clip: {
+                    videoId: result.videoId,
+                    title: result.title,
+                    filePath: result.filePath,
+                    startSeconds: result.start,
+                    endSeconds: result.end,
+                    durationSeconds: result.duration,
+                },
+            };
         }
         catch (error) {
             // One bad range should not discard the clips that did cut.
             const failure = asYouTubeError(error);
-            lines.push(`✗ ${range.start}–${range.end}  [${failure.code}] ${failure.message}`);
-            failures.push({ start: range.start, end: range.end, error: failure.code });
+            return {
+                ok: false,
+                line: `✗ ${range.start}–${range.end}  [${failure.code}] ${failure.message}`,
+                failure: { start: range.start, end: range.end, error: failure.code },
+            };
+        }
+        finally {
+            done++;
+            reportProgress(done, args.ranges.length, `Cut ${done} of ${args.ranges.length} clips`);
         }
-    }
-    reportProgress(args.ranges.length, args.ranges.length);
-    return toolResult([`${succeeded} of ${args.ranges.length} clips extracted`, '', ...lines].join('\n'), { clips, failures, requested: args.ranges.length, succeeded });
-}
-// -- extract_frame -------------------------------------------------------
-export const extractFrameSchema = {
-    video: z.string().describe('YouTube video ID or full URL'),
-    timestamp: z.string().describe('When to capture. Seconds, MM:SS or HH:MM:SS.'),
-    format: z.enum(['png', 'jpg']).default('png').describe('Image format. Default: png'),
-    outputDir: z
-        .string()
-        .optional()
-        .describe('Where to write the image. Must be inside your home directory.'),
-};
-export const extractFrameOutputSchema = {
-    videoId: z.string(),
-    title: z.string(),
-    filePath: z.string(),
-    timestampSeconds: z.number(),
-};
-export async function extractFrameHandler(args) {
-    const seconds = parseTimestamp(args.timestamp, 'timestamp');
-    const result = await extractFrame(args.video, seconds, {
-        outputDir: args.outputDir,
-        format: args.format,
-    });
-    return fileResult([
-        '✓ Frame captured',
-        '',
-        result.title,
-        `at ${formatTimestamp(result.timestamp)}`,
-        '',
-        result.filePath,
-    ].join('\n'), {
-        videoId: result.videoId,
-        title: result.title,
-        filePath: result.filePath,
-        timestampSeconds: result.timestamp,
-    }, {
-        path: result.filePath,
-        name: `${result.title} frame`,
-        mimeType: args.format === 'png' ? 'image/png' : 'image/jpeg',
     });
-}
-// -- export_subtitles ----------------------------------------------------
-export const exportSubtitlesSchema = {
-    video: z.string().describe('YouTube video ID or full URL'),
-    format: z
-        .enum(['srt', 'vtt', 'txt'])
-        .default('srt')
-        .describe('Subtitle format. srt and vtt import into any editor; txt is plain text. Default: srt'),
-    language: z.string().default('en').describe('Caption language. Default: en'),
-    outputDir: z
-        .string()
-        .optional()
-        .describe('Where to write the file. Must be inside your home directory.'),
-};
-export const exportSubtitlesOutputSchema = {
-    videoId: z.string(),
-    language: z.string(),
-    format: z.enum(['srt', 'vtt', 'txt']),
-    filePath: z.string(),
-    cueCount: z.number().int(),
-};
-export async function exportSubtitlesHandler(args) {
-    // Validate the destination before spending a network round trip on a
-    // transcript we would then have nowhere to write.
-    const targetDir = resolveOutputDir(args.outputDir, subtitlesDir());
-    const transcript = await getTranscript(args.video, { language: args.language });
-    const body = args.format === 'srt'
-        ? toSrt(transcript.segments)
-        : args.format === 'vtt'
-            ? toVtt(transcript.segments)
-            : segmentsToText(transcript.segments);
-    await mkdir(targetDir, { recursive: true });
-    const filePath = join(targetDir, `${safeStem(transcript.videoId, transcript.videoId)}.${args.language}.${args.format}`);
-    await writeFile(filePath, body, 'utf-8');
-    return fileResult([
-        `✓ Subtitles exported (${args.format.toUpperCase()})`,
-        '',
-        `${transcript.segments.length.toLocaleString()} cues · ${transcript.language}`,
+    const clips = outcomes.flatMap((outcome) => (outcome.ok ? [outcome.clip] : []));
+    const failures = outcomes.flatMap((outcome) => (outcome.ok ? [] : [outcome.failure]));
+    return toolResult([
+        `${clips.length} of ${args.ranges.length} clips extracted`,
         '',
-        filePath,
-    ].join('\n'), {
-        videoId: transcript.videoId,
-        language: transcript.language,
-        format: args.format,
-        filePath,
-        cueCount: transcript.segments.length,
-    }, {
-        path: filePath,
-        name: `${transcript.videoId}.${args.format}`,
-        mimeType: args.format === 'txt' ? 'text/plain' : `text/${args.format}`,
-    });
+        ...outcomes.map((outcome) => outcome.line),
+    ].join('\n'), { clips, failures, requested: args.ranges.length, succeeded: clips.length });
 }
 //# sourceMappingURL=clips.js.map

package/dist/tools/clips.js.map

@@ -1 +1 @@
-{"version":3,"file":"clips.js","sourceRoot":"","sources":["../../src/tools/clips.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrE;;;;;GAKG;AAEH,MAAM,OAAO,GAAG,CAAC;KACd,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;KACjE,OAAO,CAAC,OAAO,CAAC;KAChB,QAAQ,CAAC,6CAA6C,CAAC,CAAC;AAE3D,MAAM,YAAY,GAAG;IACnB,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,2EAA2E,CAAC;IACxF,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,yEAAyE,CAAC;IACtF,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,iFAAiF,CAAC;IAC9F,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,8DAA8D,CAAC;CAC5E,CAAC;AAEF,MAAM,iBAAiB,GAA2B;IAChD,IAAI,EAAE,2BAA2B;IACjC,OAAO,EAAE,2DAA2D;IACpE,OAAO,EAAE,2DAA2D;IACpE,OAAO,EAAE,2DAA2D;IACpE,MAAM,EAAE,yDAAyD;IACjE,MAAM,EAAE,yDAAyD;IACjE,MAAM,EAAE,yDAAyD;CAClE,CAAC;AAEF,SAAS,UAAU,CAAC,IAAwD;IAK1E,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC;QACjF,GAAG,EAAE,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC;QACzE,OAAO,EAAE,IAAI,CAAC,OAAO;KACtB,CAAC;AACJ,CAAC;AAED,2EAA2E;AAE3E,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAC1D,GAAG,YAAY;IACf,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,CAAC;SACX,OAAO,EAAE;SACT,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CACP,gIAAgI,CACjI;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,gBAAgB,CAAC,KAAK,CAAC;AAY9D,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAqB;IAC5D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE;QAC7D,cAAc,EAAE,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,iBAAiB,CAAC,OAAO,CAAC,IAAI,MAAM;QACvF,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,SAAS,EAAE,KAAK;KACjB,CAAC,CAAC;IAEH,OAAO,UAAU,CACf;QACE,kBAAkB;QAClB,EAAE;QACF,MAAM,CAAC,KAAK;QACZ,GAAG,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI;QACrG,EAAE;QACF,MAAM,CAAC,QAAQ;KAChB,CAAC,IAAI,CAAC,IAAI,CAAC,EACZ;QACE,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,YAAY,EAAE,MAAM,CAAC,KAAK;QAC1B,UAAU,EAAE,MAAM,CAAC,GAAG;QACtB,eAAe,EAAE,MAAM,CAAC,QAAQ;KACjC,EACD,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,KAAK,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAC/E,CAAC;AACJ,CAAC;AAED,2EAA2E;AAE3E,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAC1D,GAAG,YAAY;IACf,WAAW,EAAE,CAAC;SACX,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;SAC3C,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,sEAAsE,CAAC;CACpF,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAG,gBAAgB,CAAC,KAAK,CAAC;AAWnE,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,IAA0B;IACtE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE;QAC7D,cAAc,EAAE,gBAAgB;QAChC,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,WAAW,EAAE,IAAI;QACjB,SAAS,EAAE,IAAI,CAAC,WAAW;QAC3B,SAAS,EAAE,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,CAAC,CAAC;IAEH,OAAO,UAAU,CACf;QACE,wBAAwB;QACxB,EAAE;QACF,MAAM,CAAC,KAAK;QACZ,GAAG,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,WAAW,GAAG;QAC1H,EAAE;QACF,MAAM,CAAC,QAAQ;KAChB,CAAC,IAAI,CAAC,IAAI,CAAC,EACZ;QACE,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,YAAY,EAAE,MAAM,CAAC,KAAK;QAC1B,UAAU,EAAE,MAAM,CAAC,GAAG;QACtB,eAAe,EAAE,MAAM,CAAC,QAAQ;KACjC,EACD,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,KAAK,QAAQ,EAAE,QAAQ,EAAE,SAAS,IAAI,CAAC,WAAW,EAAE,EAAE,CAChG,CAAC;AACJ,CAAC;AAED,2EAA2E;AAE3E,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAC1D,MAAM,EAAE,CAAC;SACN,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;QACrE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;KAClE,CAAC,CACH;SACA,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CAAC,wCAAwC,CAAC;IACrD,OAAO,EAAE,OAAO;IAChB,WAAW,EAAE,CAAC;SACX,OAAO,EAAE;SACT,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,mDAAmD,CAAC;IAChE,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,+DAA+D,CAAC;CAC7E,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;IAChC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACtF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;CAC5B,CAAC;AAUF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAsB;IAC9D,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAA8B,EAAE,CAAC;IAC5C,MAAM,QAAQ,GAAoD,EAAE,CAAC;IACrE,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;QACnD,cAAc,EAAE,CAAC;QACjB,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,KAAK,GAAG,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;QAEhG,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B,IAAI,CAAC,KAAK,EACV,UAAU,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,EAClD;gBACE,cAAc,EAAE,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,iBAAiB,CAAC,OAAO,CAAC,IAAI,MAAM;gBACvF,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,SAAS,EAAE,KAAK;aACjB,CACF,CAAC;YACF,KAAK,CAAC,IAAI,CACR,KAAK,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,QAAQ,EAAE,CACxF,CAAC;YACF,KAAK,CAAC,IAAI,CAAC;gBACT,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,YAAY,EAAE,MAAM,CAAC,KAAK;gBAC1B,UAAU,EAAE,MAAM,CAAC,GAAG;gBACtB,eAAe,EAAE,MAAM,CAAC,QAAQ;aACjC,CAAC,CAAC;YACH,SAAS,EAAE,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,2DAA2D;YAC3D,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;YAClF,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IAED,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAEvD,OAAO,UAAU,CACf,CAAC,GAAG,SAAS,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,kBAAkB,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAClF,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAC9D,CAAC;AACJ,CAAC;AAED,2EAA2E;AAE3E,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAC1D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;IAC9E,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACpF,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,+DAA+D,CAAC;CAC7E,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;CAC7B,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAKzC;IACC,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE;QACrD,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC;IAEH,OAAO,UAAU,CACf;QACE,kBAAkB;QAClB,EAAE;QACF,MAAM,CAAC,KAAK;QACZ,MAAM,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE;QACzC,EAAE;QACF,MAAM,CAAC,QAAQ;KAChB,CAAC,IAAI,CAAC,IAAI,CAAC,EACZ;QACE,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,gBAAgB,EAAE,MAAM,CAAC,SAAS;KACnC,EACD;QACE,IAAI,EAAE,MAAM,CAAC,QAAQ;QACrB,IAAI,EAAE,GAAG,MAAM,CAAC,KAAK,QAAQ;QAC7B,QAAQ,EAAE,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY;KAC7D,CACF,CAAC;AACJ,CAAC;AAED,2EAA2E;AAE3E,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAC1D,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;SAC3B,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CACP,sFAAsF,CACvF;IACH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAC5E,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,8DAA8D,CAAC;CAC5E,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,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACrC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;CAC3B,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAK5C;IACC,qEAAqE;IACrE,kDAAkD;IAClD,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;IAEnE,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEhF,MAAM,IAAI,GACR,IAAI,CAAC,MAAM,KAAK,KAAK;QACnB,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC;QAC5B,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,KAAK;YACrB,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC5B,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAE5C,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,MAAM,QAAQ,GAAG,IAAI,CACnB,SAAS,EACT,GAAG,QAAQ,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,CACtF,CAAC;IACF,MAAM,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAEzC,OAAO,UAAU,CACf;QACE,yBAAyB,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG;QACrD,EAAE;QACF,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,WAAW,UAAU,CAAC,QAAQ,EAAE;QAC9E,EAAE;QACF,QAAQ;KACT,CAAC,IAAI,CAAC,IAAI,CAAC,EACZ;QACE,OAAO,EAAE,UAAU,CAAC,OAAO;QAC3B,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ;QACR,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,MAAM;KACrC,EACD;QACE,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,GAAG,UAAU,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,EAAE;QAC5C,QAAQ,EAAE,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,MAAM,EAAE;KACvE,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"clips.js","sourceRoot":"","sources":["../../src/tools/clips.ts"],"names":[],"mappings":"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"}

package/dist/tools/fetch-channel-thumbnails.d.ts

@@ -0,0 +1,179 @@
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { type ThumbnailQuality, type ThumbnailTab } from '../thumbnail-schemas.js';
+export declare const fetchChannelThumbnailsSchema: {
+    channel: z.ZodString;
+    maxVideos: z.ZodDefault<z.ZodNumber>;
+    tabs: z.ZodDefault<z.ZodArray<z.ZodEnum<["videos", "shorts", "streams"]>, "many">>;
+    quality: z.ZodDefault<z.ZodEnum<["best", "listed"]>>;
+};
+export declare const fetchChannelThumbnailsOutputSchema: {
+    channelId: z.ZodString;
+    name: z.ZodString;
+    handle: z.ZodString;
+    channelUrl: z.ZodString;
+    directory: z.ZodString;
+    manifestPath: z.ZodString;
+    tabs: z.ZodArray<z.ZodEnum<["videos", "shorts", "streams"]>, "many">;
+    quality: z.ZodEnum<["best", "listed"]>;
+    considered: z.ZodNumber;
+    fetched: z.ZodNumber;
+    skipped: z.ZodNumber;
+    failed: z.ZodNumber;
+    failures: z.ZodArray<z.ZodObject<{
+        videoId: z.ZodString;
+        tab: z.ZodEnum<["videos", "shorts", "streams"]>;
+        error: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        videoId: string;
+        error: string;
+        tab: "videos" | "shorts" | "streams";
+    }, {
+        videoId: string;
+        error: string;
+        tab: "videos" | "shorts" | "streams";
+    }>, "many">;
+    tabErrors: z.ZodArray<z.ZodObject<{
+        tab: z.ZodEnum<["videos", "shorts", "streams"]>;
+        error: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        error: string;
+        tab: "videos" | "shorts" | "streams";
+    }, {
+        error: string;
+        tab: "videos" | "shorts" | "streams";
+    }>, "many">;
+    avatar: z.ZodOptional<z.ZodObject<{
+        file: z.ZodOptional<z.ZodString>;
+        sourceUrl: z.ZodOptional<z.ZodString>;
+        variant: z.ZodOptional<z.ZodString>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+        bytes: z.ZodOptional<z.ZodNumber>;
+        format: z.ZodOptional<z.ZodEnum<["jpg", "png", "webp"]>>;
+        fetchedAt: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+        kind: z.ZodEnum<["avatar", "banner"]>;
+        state: z.ZodEnum<["pending", "saved", "failed"]>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "avatar" | "banner";
+        state: "pending" | "failed" | "saved";
+        error?: string | undefined;
+        file?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+        fetchedAt?: string | undefined;
+        bytes?: number | undefined;
+        format?: "png" | "jpg" | "webp" | undefined;
+        sourceUrl?: string | undefined;
+        variant?: string | undefined;
+    }, {
+        kind: "avatar" | "banner";
+        state: "pending" | "failed" | "saved";
+        error?: string | undefined;
+        file?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+        fetchedAt?: string | undefined;
+        bytes?: number | undefined;
+        format?: "png" | "jpg" | "webp" | undefined;
+        sourceUrl?: string | undefined;
+        variant?: string | undefined;
+    }>>;
+    banner: z.ZodOptional<z.ZodObject<{
+        file: z.ZodOptional<z.ZodString>;
+        sourceUrl: z.ZodOptional<z.ZodString>;
+        variant: z.ZodOptional<z.ZodString>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+        bytes: z.ZodOptional<z.ZodNumber>;
+        format: z.ZodOptional<z.ZodEnum<["jpg", "png", "webp"]>>;
+        fetchedAt: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+        kind: z.ZodEnum<["avatar", "banner"]>;
+        state: z.ZodEnum<["pending", "saved", "failed"]>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "avatar" | "banner";
+        state: "pending" | "failed" | "saved";
+        error?: string | undefined;
+        file?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+        fetchedAt?: string | undefined;
+        bytes?: number | undefined;
+        format?: "png" | "jpg" | "webp" | undefined;
+        sourceUrl?: string | undefined;
+        variant?: string | undefined;
+    }, {
+        kind: "avatar" | "banner";
+        state: "pending" | "failed" | "saved";
+        error?: string | undefined;
+        file?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+        fetchedAt?: string | undefined;
+        bytes?: number | undefined;
+        format?: "png" | "jpg" | "webp" | undefined;
+        sourceUrl?: string | undefined;
+        variant?: string | undefined;
+    }>>;
+    stoppedEarly: z.ZodBoolean;
+    stopReason: z.ZodOptional<z.ZodString>;
+    stats: z.ZodObject<{
+        videoCount: z.ZodNumber;
+        savedCount: z.ZodNumber;
+        failedCount: z.ZodNumber;
+        pendingCount: z.ZodNumber;
+        totalBytes: z.ZodNumber;
+        tabs: z.ZodArray<z.ZodObject<{
+            tab: z.ZodEnum<["videos", "shorts", "streams"]>;
+            videoCount: z.ZodNumber;
+            savedCount: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            videoCount: number;
+            tab: "videos" | "shorts" | "streams";
+            savedCount: number;
+        }, {
+            videoCount: number;
+            tab: "videos" | "shorts" | "streams";
+            savedCount: number;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        videoCount: number;
+        failedCount: number;
+        pendingCount: number;
+        tabs: {
+            videoCount: number;
+            tab: "videos" | "shorts" | "streams";
+            savedCount: number;
+        }[];
+        savedCount: number;
+        totalBytes: number;
+    }, {
+        videoCount: number;
+        failedCount: number;
+        pendingCount: number;
+        tabs: {
+            videoCount: number;
+            tab: "videos" | "shorts" | "streams";
+            savedCount: number;
+        }[];
+        savedCount: number;
+        totalBytes: number;
+    }>;
+};
+/**
+ * Save every thumbnail of a channel, plus its avatar and banner.
+ *
+ * Idempotent by construction: images already on disk are kept, missing or
+ * truncated ones are fetched again, and a second call after an interruption
+ * continues. The listing is one yt-dlp call per tab; the images come from
+ * YouTube's image hosts directly, so no video is extracted individually.
+ */
+export declare function fetchChannelThumbnailsHandler({ channel, maxVideos, tabs, quality, }: {
+    channel: string;
+    maxVideos: number;
+    tabs: ThumbnailTab[];
+    quality: ThumbnailQuality;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=fetch-channel-thumbnails.d.ts.map

package/dist/tools/fetch-channel-thumbnails.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-channel-thumbnails.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-channel-thumbnails.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAKL,KAAK,gBAAgB,EACrB,KAAK,YAAY,EAClB,MAAM,yBAAyB,CAAC;AAejC,eAAO,MAAM,4BAA4B;;;;;CAiBxC,CAAC;AAEF,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsB9C,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,6BAA6B,CAAC,EAClD,OAAO,EACP,SAAS,EACT,IAAI,EACJ,OAAO,GACR,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,OAAO,EAAE,gBAAgB,CAAC;CAC3B,GAAG,OAAO,CAAC,cAAc,CAAC,CAmD1B"}

package/dist/tools/fetch-channel-thumbnails.js

@@ -0,0 +1,123 @@
+import { z } from 'zod';
+import { channelImageSchema, thumbnailQualitySchema, thumbnailStatsSchema, thumbnailTabSchema, } from '../thumbnail-schemas.js';
+import { YouTubeError } from '../utils/errors.js';
+import { withFileLock } from '../utils/file-lock.js';
+import { fileResult } from '../utils/format.js';
+import { fetchChannelThumbnails } from '../utils/thumbnail-fetch.js';
+import { listTabs } from '../utils/thumbnail-listing.js';
+import { thumbnailDir, thumbnailLockPath, thumbnailManifestPath, } from '../utils/thumbnail-paths.js';
+import { ensureThumbnailDirs, readThumbnailManifest } from '../utils/thumbnail-store.js';
+import { assertChannelId } from '../utils/validate.js';
+import { getChannelInfo } from '../utils/youtube.js';
+export const fetchChannelThumbnailsSchema = {
+    channel: z.string().max(256).describe('Channel URL, @handle, or name'),
+    maxVideos: z
+        .number()
+        .int()
+        .min(1)
+        .max(500)
+        .default(100)
+        .describe('Most recent videos to consider, per tab. Default: 100'),
+    tabs: z
+        .array(thumbnailTabSchema)
+        .min(1)
+        .default(['videos'])
+        .describe("Which channel tabs to read. Shorts have portrait thumbnails and are saved under shorts/. Default: ['videos']"),
+    quality: thumbnailQualitySchema.default('best'),
+};
+export const fetchChannelThumbnailsOutputSchema = {
+    channelId: z.string(),
+    name: z.string(),
+    handle: z.string(),
+    channelUrl: z.string(),
+    directory: z.string(),
+    manifestPath: z.string(),
+    tabs: z.array(thumbnailTabSchema),
+    quality: thumbnailQualitySchema,
+    considered: z.number().int().describe('Videos with a record after this call'),
+    fetched: z.number().int().describe('Images saved during this call'),
+    skipped: z.number().int().describe('Images already on disk'),
+    failed: z.number().int(),
+    failures: z.array(z.object({ videoId: z.string(), tab: thumbnailTabSchema, error: z.string() })),
+    tabErrors: z
+        .array(z.object({ tab: thumbnailTabSchema, error: z.string() }))
+        .describe('Tabs that could not be listed'),
+    avatar: channelImageSchema.optional(),
+    banner: channelImageSchema.optional(),
+    stoppedEarly: z.boolean(),
+    stopReason: z.string().optional(),
+    stats: thumbnailStatsSchema,
+};
+/**
+ * Save every thumbnail of a channel, plus its avatar and banner.
+ *
+ * Idempotent by construction: images already on disk are kept, missing or
+ * truncated ones are fetched again, and a second call after an interruption
+ * continues. The listing is one yt-dlp call per tab; the images come from
+ * YouTube's image hosts directly, so no video is extracted individually.
+ */
+export async function fetchChannelThumbnailsHandler({ channel, maxVideos, tabs, quality, }) {
+    const info = await getChannelInfo(channel);
+    const channelId = assertChannelId(info.channelId);
+    const wanted = [...new Set(tabs)];
+    await ensureThumbnailDirs(channelId, wanted);
+    const result = await withFileLock(thumbnailLockPath(channelId), async () => {
+        const { listings, tabErrors } = await listTabs(info.channelUrl, wanted, maxVideos);
+        const outcome = await fetchChannelThumbnails({
+            channel: info,
+            listings,
+            existing: await readThumbnailManifest(channelId),
+            quality,
+        });
+        return { ...outcome, tabErrors };
+    }, (existing) => alreadyFetching(channelId, existing));
+    const directory = thumbnailDir(channelId);
+    const manifestPath = thumbnailManifestPath(channelId);
+    const { manifest } = result;
+    return fileResult(render(info.name, directory, result), {
+        channelId,
+        name: info.name,
+        handle: info.handle,
+        channelUrl: info.channelUrl,
+        directory,
+        manifestPath,
+        tabs: manifest.tabs,
+        quality,
+        considered: result.considered,
+        fetched: result.fetched,
+        skipped: result.skipped,
+        failed: result.failed,
+        failures: result.failures,
+        tabErrors: result.tabErrors,
+        ...(manifest.avatar === undefined ? {} : { avatar: manifest.avatar }),
+        ...(manifest.banner === undefined ? {} : { banner: manifest.banner }),
+        stoppedEarly: result.stoppedEarly,
+        ...(result.stopReason === undefined ? {} : { stopReason: result.stopReason }),
+        stats: manifest.stats,
+    }, { path: manifestPath, name: `${info.name} thumbnails`, mimeType: 'application/json' });
+}
+function alreadyFetching(channelId, existing) {
+    const owner = existing === undefined ? '' : `Started at ${existing.startedAt} by process ${existing.pid}. `;
+    return new YouTubeError('INVALID_INPUT', `Thumbnails for ${channelId} are already being fetched.`, {
+        nextStep: `${owner}Wait for it to finish, then call fetch_channel_thumbnails again to continue.`,
+    });
+}
+function render(name, directory, result) {
+    const lines = [
+        `Thumbnails for ${name}: ${result.considered - result.failed} of ${result.considered} saved.`,
+        '',
+        `Fetched ${result.fetched} · already had ${result.skipped}${result.failed > 0 ? ` · ${result.failed} failed` : ''}`,
+        `Avatar: ${result.manifest.avatar?.state ?? 'not listed'} · banner: ${result.manifest.banner?.state ?? 'not listed'}`,
+        '',
+        directory,
+    ];
+    for (const { tab, error } of result.tabErrors)
+        lines.push(`The ${tab} tab could not be listed (${error}).`);
+    if (result.failed > 0)
+        lines.push('Call fetch_channel_thumbnails again to retry the failures.');
+    if (result.stopReason !== undefined) {
+        lines.push('', `Stopped early: ${result.stopReason}`, 'Call fetch_channel_thumbnails again to continue.');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=fetch-channel-thumbnails.js.map

package/dist/tools/fetch-channel-thumbnails.js.map

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

package/dist/tools/fetch-videos.d.ts

@@ -3,13 +3,15 @@ import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 export declare const fetchVideosSchema: {
     url: z.ZodString;
     limit: z.ZodDefault<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
 };
 export declare const fetchVideosOutputSchema: {
-    total: z.ZodNumber;
     count: z.ZodNumber;
-    offset: z.ZodNumber;
     hasMore: z.ZodBoolean;
-    nextOffset: z.ZodOptional<z.ZodNumber>;
+    nextCursor: z.ZodOptional<z.ZodString>;
+    total: z.ZodOptional<z.ZodNumber>;
+    totalSource: z.ZodOptional<z.ZodEnum<["youtube:playlist_count", "local-store", "source-exhausted"]>>;
+    driftDetected: z.ZodBoolean;
     source: z.ZodString;
     videos: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -20,6 +22,7 @@ export declare const fetchVideosOutputSchema: {
         channel: z.ZodOptional<z.ZodString>;
         viewCount: z.ZodOptional<z.ZodNumber>;
         uploadDate: z.ZodOptional<z.ZodString>;
+        thumbnailUrl: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         id: string;
         title: string;
@@ -29,6 +32,7 @@ export declare const fetchVideosOutputSchema: {
         channel?: string | undefined;
         viewCount?: number | undefined;
         uploadDate?: string | undefined;
+        thumbnailUrl?: string | undefined;
     }, {
         id: string;
         title: string;
@@ -38,10 +42,20 @@ export declare const fetchVideosOutputSchema: {
         channel?: string | undefined;
         viewCount?: number | undefined;
         uploadDate?: string | undefined;
+        thumbnailUrl?: string | undefined;
     }>, "many">;
 };
-export declare function fetchVideosHandler({ url, limit, }: {
+/**
+ * One page of a playlist or channel listing.
+ *
+ * Previously this reported `total` as the number of videos it happened to
+ * return, so a caller asking for 20 of a 5,000-video channel was told it had
+ * all 5,000 — `hasMore` was structurally false. Now `total` is only present
+ * when YouTube states one, and its absence means unknown rather than none.
+ */
+export declare function fetchVideosHandler({ url, limit, cursor, }: {
     url: string;
     limit: number;
+    cursor?: string;
 }): Promise<CallToolResult>;
 //# sourceMappingURL=fetch-videos.d.ts.map

package/dist/tools/fetch-videos.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-videos.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-videos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,iBAAiB;;;CAY7B,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAInC,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,EACvC,GAAG,EACH,KAAK,GACN,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,cAAc,CAAC,CAwB1B"}
+{"version":3,"file":"fetch-videos.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-videos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,iBAAiB;;;;CAmB7B,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAInC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,EACvC,GAAG,EACH,KAAK,EACL,MAAM,GACP,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,cAAc,CAAC,CA2D1B"}