youtube-knowledge-mcp 2.0.2 → 2.2.0

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;
+        bytes?: number | undefined;
+        format?: "png" | "jpg" | "webp" | undefined;
+        fetchedAt?: string | 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;
+        bytes?: number | undefined;
+        format?: "png" | "jpg" | "webp" | undefined;
+        fetchedAt?: string | 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;
+        bytes?: number | undefined;
+        format?: "png" | "jpg" | "webp" | undefined;
+        fetchedAt?: string | 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;
+        bytes?: number | undefined;
+        format?: "png" | "jpg" | "webp" | undefined;
+        fetchedAt?: string | 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;
+        savedCount: number;
+        totalBytes: number;
+        tabs: {
+            videoCount: number;
+            tab: "videos" | "shorts" | "streams";
+            savedCount: number;
+        }[];
+    }, {
+        videoCount: number;
+        failedCount: number;
+        pendingCount: number;
+        savedCount: number;
+        totalBytes: number;
+        tabs: {
+            videoCount: number;
+            tab: "videos" | "shorts" | "streams";
+            savedCount: 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

@@ -20,24 +20,27 @@ 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, {
-        url: string;
-        title: string;
         id: string;
-        durationFormatted: string;
+        title: string;
         durationSeconds: number;
+        durationFormatted: string;
+        url: string;
         channel?: string | undefined;
-        uploadDate?: string | undefined;
         viewCount?: number | undefined;
+        uploadDate?: string | undefined;
+        thumbnailUrl?: string | undefined;
     }, {
-        url: string;
-        title: string;
         id: string;
-        durationFormatted: string;
+        title: string;
         durationSeconds: number;
+        durationFormatted: string;
+        url: string;
         channel?: string | undefined;
-        uploadDate?: string | undefined;
         viewCount?: number | undefined;
+        uploadDate?: string | undefined;
+        thumbnailUrl?: string | undefined;
     }>, "many">;
 };
 export declare function fetchVideosHandler({ url, limit, }: {

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;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,iBAAiB;;;CAa7B,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,CA0B1B"}

package/dist/tools/fetch-videos.js

@@ -5,6 +5,7 @@ import { paginationShape, videoSummarySchema } from '../schemas.js';
 export const fetchVideosSchema = {
     url: z
         .string()
+        .max(2048)
         .describe('YouTube playlist URL, channel URL, or channel handle (e.g., https://www.youtube.com/@channel)'),
     limit: z
         .number()
@@ -36,6 +37,8 @@ export async function fetchVideosHandler({ url, limit, }) {
             durationFormatted: v.durationFormatted,
             url: v.url,
             uploadDate: v.uploadDate,
+            ...(v.thumbnailUrl === undefined ? {} : { thumbnailUrl: v.thumbnailUrl }),
+            ...(v.viewCount === undefined ? {} : { viewCount: v.viewCount }),
         })),
         ...pageInfo(videos.length, videos.length),
     });

package/dist/tools/fetch-videos.js.map

@@ -1 +1 @@
-{"version":3,"file":"fetch-videos.js","sourceRoot":"","sources":["../../src/tools/fetch-videos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGpE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,CACP,+FAA+F,CAChG;IACH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,yDAAyD,CAAC;CACvE,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC;IACnC,GAAG,eAAe;CACnB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EACvC,GAAG,EACH,KAAK,GAIN;IACC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAE5C,MAAM,KAAK,GAAa,CAAC,WAAW,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAEhG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACtB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,iBAAiB,MAAM,CAAC,CAAC,UAAU,IAAI,cAAc,EAAE,CAAC,CAAC;QAC5E,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAClC,MAAM,EAAE,GAAG;QACX,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzB,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,eAAe,EAAE,CAAC,CAAC,QAAQ;YAC3B,iBAAiB,EAAE,CAAC,CAAC,iBAAiB;YACtC,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,UAAU,EAAE,CAAC,CAAC,UAAU;SACzB,CAAC,CAAC;QACH,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"fetch-videos.js","sourceRoot":"","sources":["../../src/tools/fetch-videos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGpE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,IAAI,CAAC;SACT,QAAQ,CACP,+FAA+F,CAChG;IACH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,yDAAyD,CAAC;CACvE,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC;IACnC,GAAG,eAAe;CACnB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EACvC,GAAG,EACH,KAAK,GAIN;IACC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAE5C,MAAM,KAAK,GAAa,CAAC,WAAW,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAEhG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACtB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,iBAAiB,MAAM,CAAC,CAAC,UAAU,IAAI,cAAc,EAAE,CAAC,CAAC;QAC5E,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAClC,MAAM,EAAE,GAAG;QACX,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzB,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,eAAe,EAAE,CAAC,CAAC,QAAQ;YAC3B,iBAAiB,EAAE,CAAC,CAAC,iBAAiB;YACtC,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,GAAG,CAAC,CAAC,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC;YACzE,GAAG,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC;SACjE,CAAC,CAAC;QACH,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/frames-subtitles.d.ts

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Stills and subtitles: the two extraction tools that produce something other
+ * than a media clip. Split from clips.ts only for size.
+ */
+export declare const extractFrameSchema: {
+    video: z.ZodString;
+    timestamp: z.ZodString;
+    format: z.ZodDefault<z.ZodEnum<["png", "jpg"]>>;
+    outputDir: z.ZodOptional<z.ZodString>;
+};
+export declare const extractFrameOutputSchema: {
+    videoId: z.ZodString;
+    title: z.ZodString;
+    filePath: z.ZodString;
+    timestampSeconds: z.ZodNumber;
+};
+export declare function extractFrameHandler(args: {
+    video: string;
+    timestamp: string;
+    format: 'png' | 'jpg';
+    outputDir?: string;
+}): Promise<CallToolResult>;
+export declare const exportSubtitlesSchema: {
+    video: z.ZodString;
+    format: z.ZodDefault<z.ZodEnum<["srt", "vtt", "txt"]>>;
+    language: z.ZodDefault<z.ZodString>;
+    outputDir: z.ZodOptional<z.ZodString>;
+};
+export declare const exportSubtitlesOutputSchema: {
+    videoId: z.ZodString;
+    language: z.ZodString;
+    format: z.ZodEnum<["srt", "vtt", "txt"]>;
+    filePath: z.ZodString;
+    cueCount: z.ZodNumber;
+};
+export declare function exportSubtitlesHandler(args: {
+    video: string;
+    format: 'srt' | 'vtt' | 'txt';
+    language: string;
+    outputDir?: string;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=frames-subtitles.d.ts.map

package/dist/tools/frames-subtitles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frames-subtitles.d.ts","sourceRoot":"","sources":["../../src/tools/frames-subtitles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE;;;GAGG;AAIH,eAAO,MAAM,kBAAkB;;;;;CAQ9B,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;CAKpC,CAAC;AAEF,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,KAAK,GAAG,KAAK,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,cAAc,CAAC,CA4B1B;AAID,eAAO,MAAM,qBAAqB;;;;;CAajC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;CAMvC,CAAC;AAEF,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,cAAc,CAAC,CA2C1B"}

package/dist/tools/frames-subtitles.js

@@ -0,0 +1,104 @@
+import { z } from 'zod';
+import { join } from 'node:path';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { fileResult } from '../utils/format.js';
+import { parseTimestamp, resolveOutputDir } from '../utils/validate.js';
+import { extractFrame, safeStem, subtitlesDir } from '../utils/clips.js';
+import { getTranscript } from '../utils/youtube.js';
+import { formatTimestamp, segmentsToText, toSrt, toVtt } from '../utils/transcript.js';
+/**
+ * Stills and subtitles: the two extraction tools that produce something other
+ * than a media clip. Split from clips.ts only for size.
+ */
+// -- 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}`,
+        '',
+        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}`,
+    });
+}
+//# sourceMappingURL=frames-subtitles.js.map

package/dist/tools/frames-subtitles.js.map

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

package/dist/tools/get-channel-info.d.ts

@@ -10,6 +10,8 @@ export declare const getChannelInfoOutputSchema: {
     subscriberCount: z.ZodNumber;
     channelUrl: z.ZodString;
     description: z.ZodString;
+    avatarUrl: z.ZodOptional<z.ZodString>;
+    bannerUrl: z.ZodOptional<z.ZodString>;
 };
 export declare function getChannelInfoHandler({ channel, }: {
     channel: string;

package/dist/tools/get-channel-info.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-channel-info.d.ts","sourceRoot":"","sources":["../../src/tools/get-channel-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,oBAAoB;;CAEhC,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;;CAA0B,CAAC;AAElE,wBAAsB,qBAAqB,CAAC,EAC1C,OAAO,GACR,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,cAAc,CAAC,CAgB1B"}
+{"version":3,"file":"get-channel-info.d.ts","sourceRoot":"","sources":["../../src/tools/get-channel-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,oBAAoB;;CAKhC,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;CAA0B,CAAC;AAElE,wBAAsB,qBAAqB,CAAC,EAC1C,OAAO,GACR,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,cAAc,CAAC,CAmB1B"}

package/dist/tools/get-channel-info.js

@@ -3,7 +3,10 @@ import { getChannelInfo } from '../utils/youtube.js';
 import { formatCount, toolResult } from '../utils/format.js';
 import { channelInfoSchema } from '../schemas.js';
 export const getChannelInfoSchema = {
-    channel: z.string().describe('YouTube channel URL, handle (e.g., @Fireship), or channel name'),
+    channel: z
+        .string()
+        .max(256)
+        .describe('YouTube channel URL, handle (e.g., @Fireship), or channel name'),
 };
 export const getChannelInfoOutputSchema = channelInfoSchema.shape;
 export async function getChannelInfoHandler({ channel, }) {
@@ -14,6 +17,10 @@ export async function getChannelInfoHandler({ channel, }) {
         `${formatCount(info.subscriberCount)} subscribers`,
         info.channelUrl,
     ].filter(Boolean);
+    if (info.avatarUrl !== undefined)
+        lines.push(`Avatar: ${info.avatarUrl}`);
+    if (info.bannerUrl !== undefined)
+        lines.push(`Banner: ${info.bannerUrl}`);
     if (info.description) {
         lines.push('');
         lines.push(info.description);

package/dist/tools/get-channel-info.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-channel-info.js","sourceRoot":"","sources":["../../src/tools/get-channel-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;CAC/F,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG,iBAAiB,CAAC,KAAK,CAAC;AAElE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,EAC1C,OAAO,GAGR;IACC,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IAE3C,MAAM,KAAK,GAAa;QACtB,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QAC9B,GAAG,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC,cAAc;QAClD,IAAI,CAAC,UAAU;KAChB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC"}
+{"version":3,"file":"get-channel-info.js","sourceRoot":"","sources":["../../src/tools/get-channel-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CAAC,gEAAgE,CAAC;CAC9E,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG,iBAAiB,CAAC,KAAK,CAAC;AAElE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,EAC1C,OAAO,GAGR;IACC,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IAE3C,MAAM,KAAK,GAAa;QACtB,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QAC9B,GAAG,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC,cAAc;QAClD,IAAI,CAAC,UAAU;KAChB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElB,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAC1E,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAE1E,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC"}

package/dist/tools/get-chapters.d.ts

@@ -13,15 +13,15 @@ export declare const getChaptersOutputSchema: {
         endFormatted: z.ZodString;
         url: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        url: string;
         title: string;
+        url: string;
         startSeconds: number;
         startFormatted: string;
         endSeconds: number;
         endFormatted: string;
     }, {
-        url: string;
         title: string;
+        url: string;
         startSeconds: number;
         startFormatted: string;
         endSeconds: number;

package/dist/tools/get-comments.d.ts

@@ -16,14 +16,14 @@ export declare const getCommentsOutputSchema: {
         likeCount: z.ZodNumber;
         isPinned: z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
-        text: string;
         likeCount: number;
         author: string;
+        text: string;
         isPinned: boolean;
     }, {
-        text: string;
         likeCount: number;
         author: string;
+        text: string;
         isPinned: boolean;
     }>, "many">;
 };

package/dist/tools/get-playlist-info.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-playlist-info.d.ts","sourceRoot":"","sources":["../../src/tools/get-playlist-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,qBAAqB;;CAMjC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;CAA2B,CAAC;AAEpE,wBAAsB,sBAAsB,CAAC,EAAE,GAAG,EAAE,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAkB9F"}
+{"version":3,"file":"get-playlist-info.d.ts","sourceRoot":"","sources":["../../src/tools/get-playlist-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,qBAAqB;;CAOjC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;CAA2B,CAAC;AAEpE,wBAAsB,sBAAsB,CAAC,EAAE,GAAG,EAAE,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAkB9F"}

package/dist/tools/get-playlist-info.js

@@ -5,6 +5,7 @@ import { playlistInfoSchema } from '../schemas.js';
 export const getPlaylistInfoSchema = {
     url: z
         .string()
+        .max(2048)
         .describe('YouTube playlist URL (e.g., https://www.youtube.com/playlist?list=PLlrATfBNZ98dudnM48yfGUldqGD0S4FFb)'),
 };
 export const getPlaylistInfoOutputSchema = playlistInfoSchema.shape;