youtube-knowledge-mcp 2.1.0 → 3.0.0

package/dist/tools/get-comments.js

@@ -1,34 +1,98 @@
 import { z } from 'zod';
-import { getComments } from '../utils/youtube.js';
-import { pageInfo, toolResult } from '../utils/format.js';
-import { commentSchema, paginationShape } from '../schemas.js';
+import { getComments, getVideoDetails } from '../utils/youtube-video.js';
+import { toolResult } from '../utils/format.js';
+import { commentSchema, commentThreadSchema } from '../schemas.js';
+import { coverageSchema } from '../harvest-schemas.js';
+import { coverageOf } from '../utils/coverage.js';
+import { renderCoverage } from '../utils/coverage-text.js';
 export const getCommentsSchema = {
-    video: z.string().describe('YouTube video ID (e.g., dQw4w9WgXcQ) or full URL'),
+    video: z.string().max(2048).describe('YouTube video ID or URL'),
     limit: z
         .number()
+        .int()
         .min(1)
-        .max(50)
+        .max(500)
         .default(20)
-        .describe('Maximum number of top-level comments to return (1-50, default: 20)'),
+        .describe('Comments to extract, replies included (1-500, default 20)'),
+    includeReplies: z
+        .boolean()
+        .default(false)
+        .describe('Return full threads instead of top-level comments only. Replies are fetched either ' +
+        'way — this decides whether they are reported or thrown away.'),
+    sort: z
+        .enum(['top', 'new'])
+        .default('top')
+        .describe('"top" under a cap is a biased prefix; "new" is what an exhaustive read should use'),
 };
 export const getCommentsOutputSchema = {
-    comments: z.array(commentSchema),
-    ...paginationShape,
+    comments: z.array(commentSchema).describe('Top-level comments, unchanged in shape'),
+    threads: z
+        .array(commentThreadSchema)
+        .optional()
+        .describe('Full threads with replies. Present when includeReplies is true.'),
+    extractedTotal: z.number().int().describe('Comments held from this read: roots plus replies'),
+    orphanReplies: z
+        .number()
+        .int()
+        .describe('Replies whose parent was cut by the cap, so their threads are incomplete'),
+    coverage: coverageSchema,
 };
-export async function getCommentsHandler({ video, limit, }) {
-    const comments = await getComments(video, limit);
-    const structured = { comments, ...pageInfo(comments.length, comments.length) };
-    if (comments.length === 0) {
-        return toolResult('No comments found for this video.', structured);
-    }
-    const lines = [`${comments.length} top comments`, ''];
-    comments.forEach((c, i) => {
-        const pinned = c.isPinned ? ' [pinned]' : '';
-        const likes = c.likeCount > 0 ? ` (${c.likeCount.toLocaleString()} likes)` : '';
-        lines.push(`${i + 1}. @${c.author}${pinned}${likes}`);
-        lines.push(`   ${c.text}`);
+/**
+ * A sample of a video's comments, with a receipt saying so.
+ *
+ * There is no cursor: YouTube exposes none for a live comment read, so this
+ * cannot page. `coverage.expected` is the video's real comment count, read
+ * from a separate metadata pass — yt-dlp overwrites `comment_count` with the
+ * number it extracted whenever --write-comments is used, so the number cannot
+ * come from the same call that fetched the comments.
+ */
+export async function getCommentsHandler({ video, limit, includeReplies, sort, }) {
+    const [result, details] = await Promise.all([
+        getComments(video, { limit, sort }),
+        getVideoDetails(video).catch(() => undefined),
+    ]);
+    const reported = details?.commentCount;
+    const capBound = result.extractedTotal >= limit;
+    const coverage = coverageOf({
+        scope: 'video-comments',
+        targetId: video,
+        have: result.extractedTotal,
+        source: `yt-dlp --write-comments comment_sort=${sort}`,
+        ranToExhaustion: result.ranToExhaustion,
+        ...(result.commentsDisabled
+            ? {
+                expected: { value: 0, source: 'youtube:comment_count' },
+                reason: 'COMMENTS_DISABLED',
+            }
+            : reported === undefined
+                ? {}
+                : { expected: { value: reported, source: 'youtube:comment_count' } }),
+        ...(capBound ? { limitApplied: limit } : {}),
+        sortApplied: sort,
+        ...(capBound
+            ? { note: `Call again with a larger limit, or harvest_channel, to extract more.` }
+            : {}),
+    });
+    const roots = result.threads.filter((thread) => thread.comment.parentId === null);
+    const lines = [renderCoverage(coverage), ''];
+    roots.forEach((thread, index) => {
+        const { comment } = thread;
+        lines.push(`${String(index + 1)}. ${comment.author}${comment.isPinned ? ' (pinned)' : ''}`);
+        lines.push(`   ${comment.text}`);
+        lines.push(`   ${String(comment.likeCount)} likes${thread.replyCount > 0 ? ` · ${String(thread.replyCount)} replies` : ''}`);
         lines.push('');
     });
-    return toolResult(lines.join('\n'), structured);
+    return toolResult(lines.join('\n'), {
+        comments: roots.map((thread) => ({
+            author: thread.comment.author,
+            text: thread.comment.text,
+            likeCount: thread.comment.likeCount,
+            isPinned: thread.comment.isPinned,
+        })),
+        ...(includeReplies ? { threads: result.threads } : {}),
+        extractedTotal: result.extractedTotal,
+        orphanReplies: result.orphanCount,
+        coverage,
+    });
 }
 //# sourceMappingURL=get-comments.js.map

package/dist/tools/get-comments.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-comments.js","sourceRoot":"","sources":["../../src/tools/get-comments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAG/D,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IAC9E,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,oEAAoE,CAAC;CAClF,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC;IAChC,GAAG,eAAe;CACnB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EACvC,KAAK,EACL,KAAK,GAIN;IACC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;IAE/E,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,UAAU,CAAC,mCAAmC,EAAE,UAAU,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,KAAK,GAAa,CAAC,GAAG,QAAQ,CAAC,MAAM,eAAe,EAAE,EAAE,CAAC,CAAC;IAEhE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACxB,MAAM,MAAM,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,MAAM,KAAK,GAAG,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,MAAM,GAAG,KAAK,EAAE,CAAC,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;AAClD,CAAC"}
+{"version":3,"file":"get-comments.js","sourceRoot":"","sources":["../../src/tools/get-comments.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,122 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+export declare const getCoverageSchema: {
+    scope: z.ZodOptional<z.ZodEnum<["channel-catalog", "video-details", "video-comments"]>>;
+    incompleteOnly: z.ZodDefault<z.ZodBoolean>;
+    verify: z.ZodDefault<z.ZodBoolean>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+};
+export declare const getCoverageOutputSchema: {
+    total: z.ZodNumber;
+    count: z.ZodNumber;
+    offset: z.ZodNumber;
+    hasMore: z.ZodBoolean;
+    nextOffset: z.ZodOptional<z.ZodNumber>;
+    receipts: z.ZodArray<z.ZodObject<{
+        scope: z.ZodEnum<["channel-catalog", "video-details", "video-comments"]>;
+        targetId: z.ZodString;
+        complete: z.ZodBoolean;
+        reason: z.ZodEnum<["COMPLETE", "CAP_REACHED", "BUDGET_SPENT", "RATE_LIMITED", "CANCELLED", "TIMEOUT", "SOURCE_REFUSED", "COMMENTS_DISABLED", "SOURCE_SILENT", "PARTIAL_ERROR", "NOT_ATTEMPTED"]>;
+        have: z.ZodNumber;
+        expected: z.ZodOptional<z.ZodNumber>;
+        expectedSource: z.ZodOptional<z.ZodEnum<["youtube:comment_count", "youtube:playlist_count", "source-exhausted"]>>;
+        ranToExhaustion: z.ZodOptional<z.ZodBoolean>;
+        source: z.ZodString;
+        harvestedAt: z.ZodString;
+        staleAfter: z.ZodOptional<z.ZodString>;
+        limitApplied: z.ZodOptional<z.ZodNumber>;
+        sortApplied: z.ZodOptional<z.ZodEnum<["top", "new"]>>;
+        resumeToken: z.ZodOptional<z.ZodString>;
+        note: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        have: number;
+        scope: "channel-catalog" | "video-details" | "video-comments";
+        targetId: string;
+        complete: boolean;
+        reason: "RATE_LIMITED" | "TIMEOUT" | "CANCELLED" | "COMPLETE" | "CAP_REACHED" | "BUDGET_SPENT" | "SOURCE_REFUSED" | "COMMENTS_DISABLED" | "SOURCE_SILENT" | "PARTIAL_ERROR" | "NOT_ATTEMPTED";
+        source: string;
+        harvestedAt: string;
+        expected?: number | undefined;
+        note?: string | undefined;
+        ranToExhaustion?: boolean | undefined;
+        expectedSource?: "youtube:playlist_count" | "source-exhausted" | "youtube:comment_count" | undefined;
+        staleAfter?: string | undefined;
+        limitApplied?: number | undefined;
+        sortApplied?: "top" | "new" | undefined;
+        resumeToken?: string | undefined;
+    }, {
+        have: number;
+        scope: "channel-catalog" | "video-details" | "video-comments";
+        targetId: string;
+        complete: boolean;
+        reason: "RATE_LIMITED" | "TIMEOUT" | "CANCELLED" | "COMPLETE" | "CAP_REACHED" | "BUDGET_SPENT" | "SOURCE_REFUSED" | "COMMENTS_DISABLED" | "SOURCE_SILENT" | "PARTIAL_ERROR" | "NOT_ATTEMPTED";
+        source: string;
+        harvestedAt: string;
+        expected?: number | undefined;
+        note?: string | undefined;
+        ranToExhaustion?: boolean | undefined;
+        expectedSource?: "youtube:playlist_count" | "source-exhausted" | "youtube:comment_count" | undefined;
+        staleAfter?: string | undefined;
+        limitApplied?: number | undefined;
+        sortApplied?: "top" | "new" | undefined;
+        resumeToken?: string | undefined;
+    }>, "many">;
+    anyIncomplete: z.ZodBoolean;
+    summary: z.ZodObject<{
+        complete: z.ZodNumber;
+        incomplete: z.ZodNumber;
+        stale: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        complete: number;
+        incomplete: number;
+        stale: number;
+    }, {
+        complete: number;
+        incomplete: number;
+        stale: number;
+    }>;
+    store: z.ZodObject<{
+        channels: z.ZodNumber;
+        videos: z.ZodNumber;
+        comments: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        videos: number;
+        comments: number;
+        channels: number;
+    }, {
+        videos: number;
+        comments: number;
+        channels: number;
+    }>;
+    mismatches: z.ZodArray<z.ZodObject<{
+        scope: z.ZodEnum<["channel-catalog", "video-details", "video-comments"]>;
+        targetId: z.ZodString;
+        receiptHave: z.ZodNumber;
+        storeHave: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        scope: "channel-catalog" | "video-details" | "video-comments";
+        targetId: string;
+        receiptHave: number;
+        storeHave: number;
+    }, {
+        scope: "channel-catalog" | "video-details" | "video-comments";
+        targetId: string;
+        receiptHave: number;
+        storeHave: number;
+    }>, "many">;
+};
+/**
+ * What this server can actually prove it holds.
+ *
+ * Reads only the local store and never contacts YouTube, so it is cheap enough
+ * for a consumer to call before every claim it makes — which is the point.
+ */
+export declare function getCoverageHandler({ scope, incompleteOnly, verify, limit, offset, }: {
+    scope?: 'channel-catalog' | 'video-details' | 'video-comments';
+    incompleteOnly: boolean;
+    verify: boolean;
+    limit: number;
+    offset: number;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=get-coverage.d.ts.map

package/dist/tools/get-coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-coverage.d.ts","sourceRoot":"","sources":["../../src/tools/get-coverage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,iBAAiB;;;;;;CAe7B,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BnC,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,EACvC,KAAK,EACL,cAAc,EACd,MAAM,EACN,KAAK,EACL,MAAM,GACP,EAAE;IACD,KAAK,CAAC,EAAE,iBAAiB,GAAG,eAAe,GAAG,gBAAgB,CAAC;IAC/D,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,cAAc,CAAC,CAgE1B"}

package/dist/tools/get-coverage.js

@@ -0,0 +1,105 @@
+import { z } from 'zod';
+import { toolResult, pageInfo } from '../utils/format.js';
+import { paginationShape } from '../schemas.js';
+import { coverageSchema, harvestScopeSchema } from '../harvest-schemas.js';
+import { getStore } from '../utils/store.js';
+import { countReceipts, listReceipts } from '../utils/harvest-receipts.js';
+import { countRows } from '../utils/store-rows.js';
+import { RECEIPT_STALE_MS } from '../utils/coverage.js';
+export const getCoverageSchema = {
+    scope: harvestScopeSchema.optional().describe('Restrict to one kind of harvest'),
+    incompleteOnly: z
+        .boolean()
+        .default(false)
+        .describe('Only receipts that are not provably complete'),
+    verify: z
+        .boolean()
+        .default(true)
+        .describe('Recount the store and cross-check every receipt against it. A receipt that disagrees ' +
+        'is reported in mismatches and treated as incomplete.'),
+    limit: z.number().int().min(1).max(500).default(50),
+    offset: z.number().int().min(0).default(0),
+};
+export const getCoverageOutputSchema = {
+    receipts: z.array(coverageSchema),
+    anyIncomplete: z
+        .boolean()
+        .describe('True when ANY receipt in scope is not provably complete. While this is true a consumer ' +
+        'must not describe the data as a full history, for any part of it.'),
+    summary: z.object({
+        complete: z.number().int(),
+        incomplete: z.number().int(),
+        stale: z.number().int().describe('Complete receipts past their staleAfter'),
+    }),
+    store: z.object({
+        channels: z.number().int(),
+        videos: z.number().int(),
+        comments: z.number().int(),
+    }),
+    mismatches: z
+        .array(z.object({
+        scope: harvestScopeSchema,
+        targetId: z.string(),
+        receiptHave: z.number().int(),
+        storeHave: z.number().int(),
+    }))
+        .describe('Empty in normal operation. Non-empty means a receipt was wrong and is not to be trusted.'),
+    ...paginationShape,
+};
+/**
+ * What this server can actually prove it holds.
+ *
+ * Reads only the local store and never contacts YouTube, so it is cheap enough
+ * for a consumer to call before every claim it makes — which is the point.
+ */
+export async function getCoverageHandler({ scope, incompleteOnly, verify, limit, offset, }) {
+    const store = await getStore();
+    const all = listReceipts(store, { ...(scope === undefined ? {} : { scope }), limit, offset });
+    const now = Date.now();
+    const mismatches = [];
+    const receipts = all.map((receipt) => {
+        if (!verify || receipt.scope !== 'video-comments')
+            return receipt;
+        const storeHave = countRows(store.prepare('SELECT COUNT(*) FROM comment WHERE video_id = ?'), receipt.targetId);
+        if (storeHave === receipt.have)
+            return receipt;
+        // The store is the authority. A receipt that disagrees with it was written
+        // by something this build did not do, so it loses its claim rather than
+        // being believed.
+        mismatches.push({
+            scope: receipt.scope,
+            targetId: receipt.targetId,
+            receiptHave: receipt.have,
+            storeHave,
+        });
+        return { ...receipt, complete: false, reason: 'PARTIAL_ERROR', have: storeHave };
+    });
+    const shown = incompleteOnly ? receipts.filter((receipt) => !receipt.complete) : receipts;
+    const stale = receipts.filter((receipt) => receipt.complete && Date.parse(receipt.harvestedAt) + RECEIPT_STALE_MS < now).length;
+    const incomplete = receipts.filter((receipt) => !receipt.complete).length;
+    const counts = {
+        channels: countRows(store.prepare('SELECT COUNT(*) FROM channel')),
+        videos: countRows(store.prepare('SELECT COUNT(*) FROM video')),
+        comments: countRows(store.prepare('SELECT COUNT(*) FROM comment')),
+    };
+    const anyIncomplete = incomplete > 0;
+    const lines = [
+        anyIncomplete
+            ? `INCOMPLETE: ${String(incomplete)} of ${String(receipts.length)} receipts are not provably complete. Do not describe this data as a full history.`
+            : `All ${String(receipts.length)} receipts in scope are provably complete.`,
+        `Store: ${String(counts.channels)} channels, ${String(counts.videos)} videos, ${String(counts.comments)} comments.`,
+        ...(stale > 0 ? [`${String(stale)} complete receipts are past their re-check date.`] : []),
+        ...(mismatches.length > 0
+            ? [`${String(mismatches.length)} receipts disagreed with the store and were downgraded.`]
+            : []),
+    ];
+    return toolResult(lines.join('\n'), {
+        receipts: shown,
+        anyIncomplete,
+        summary: { complete: receipts.length - incomplete, incomplete, stale },
+        store: counts,
+        mismatches,
+        ...pageInfo({ total: countReceipts(store, scope), count: shown.length, offset }),
+    });
+}
+//# sourceMappingURL=get-coverage.js.map

package/dist/tools/get-coverage.js.map

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

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;

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

@@ -1 +1 @@
-{"version":3,"file":"get-playlist-info.js","sourceRoot":"","sources":["../../src/tools/get-playlist-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGnD,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,CACP,uGAAuG,CACxG;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG,kBAAkB,CAAC,KAAK,CAAC;AAEpE,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,EAAE,GAAG,EAAmB;IACnE,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;IAExC,MAAM,KAAK,GAAa;QACtB,IAAI,CAAC,KAAK;QACV,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE;QACjF,EAAE;QACF,GAAG,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS;QACxC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,iBAAiB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE;QAC7D,IAAI,CAAC,GAAG;KACT,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-playlist-info.js","sourceRoot":"","sources":["../../src/tools/get-playlist-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGnD,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,IAAI,CAAC;SACT,QAAQ,CACP,uGAAuG,CACxG;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG,kBAAkB,CAAC,KAAK,CAAC;AAEpE,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,EAAE,GAAG,EAAmB;IACnE,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;IAExC,MAAM,KAAK,GAAa;QACtB,IAAI,CAAC,KAAK;QACV,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE;QACjF,EAAE;QACF,GAAG,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS;QACxC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,iBAAiB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE;QAC7D,IAAI,CAAC,GAAG;KACT,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"}

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

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { type ThumbnailQuality } from '../thumbnail-schemas.js';
+export declare const getThumbnailSchema: {
+    video: z.ZodOptional<z.ZodString>;
+    channel: z.ZodOptional<z.ZodString>;
+    image: z.ZodDefault<z.ZodEnum<["thumbnail", "avatar", "banner"]>>;
+    quality: z.ZodDefault<z.ZodEnum<["best", "listed"]>>;
+};
+export declare const getThumbnailOutputSchema: {
+    image: z.ZodEnum<["thumbnail", "avatar", "banner"]>;
+    videoId: z.ZodOptional<z.ZodString>;
+    channelId: z.ZodOptional<z.ZodString>;
+    sourceUrl: z.ZodString;
+    variant: z.ZodString;
+    mimeType: z.ZodString;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    bytes: z.ZodNumber;
+    fromDisk: z.ZodBoolean;
+};
+export interface GetThumbnailArgs {
+    video?: string;
+    channel?: string;
+    image: 'thumbnail' | 'avatar' | 'banner';
+    quality: ThumbnailQuality;
+}
+/**
+ * One image, returned as an MCP image block so the model can look at it.
+ *
+ * Remote-safe: the image is fetched into memory under a cap and never written.
+ * Locally, an image a previous fetch_channel_thumbnails run saved is served
+ * from disk instead, so what the model sees is exactly what was stored.
+ */
+export declare function getThumbnailHandler(args: GetThumbnailArgs, options?: {
+    store: boolean;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=get-thumbnail.d.ts.map

package/dist/tools/get-thumbnail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-thumbnail.d.ts","sourceRoot":"","sources":["../../src/tools/get-thumbnail.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAA0B,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAUxF,eAAO,MAAM,kBAAkB;;;;;CAe9B,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;CAWpC,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACzC,OAAO,EAAE,gBAAgB,CAAC;CAC3B;AAYD;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,gBAAgB,EACtB,OAAO,GAAE;IAAE,KAAK,EAAE,OAAO,CAAA;CAAqB,GAC7C,OAAO,CAAC,cAAc,CAAC,CA6BzB"}

package/dist/tools/get-thumbnail.js

@@ -0,0 +1,152 @@
+import { readFile } from 'node:fs/promises';
+import { z } from 'zod';
+import { thumbnailQualitySchema } from '../thumbnail-schemas.js';
+import { YouTubeError } from '../utils/errors.js';
+import { probeImage } from '../utils/image-dimensions.js';
+import { fetchImage, MAX_INLINE_IMAGE_BYTES } from '../utils/image-fetch.js';
+import { climb, videoRungs } from '../utils/thumbnail-ladder.js';
+import { channelImageFile, entryPath, listThumbnailManifests } from '../utils/thumbnail-store.js';
+import { assertChannelId } from '../utils/validate.js';
+import { extractVideoId, getChannelInfo } from '../utils/youtube.js';
+import { findByChannel } from '../utils/channel-lookup.js';
+export const getThumbnailSchema = {
+    video: z
+        .string()
+        .optional()
+        .describe('Video ID or URL. Required unless image is avatar or banner'),
+    channel: z
+        .string()
+        .max(256)
+        .optional()
+        .describe('Channel URL, @handle or name, for image = avatar or banner'),
+    image: z
+        .enum(['thumbnail', 'avatar', 'banner'])
+        .default('thumbnail')
+        .describe("A video's thumbnail, or a channel's avatar or banner. Default: thumbnail"),
+    quality: thumbnailQualitySchema.default('best'),
+};
+export const getThumbnailOutputSchema = {
+    image: z.enum(['thumbnail', 'avatar', 'banner']),
+    videoId: z.string().optional(),
+    channelId: z.string().optional(),
+    sourceUrl: z.string(),
+    variant: z.string(),
+    mimeType: z.string(),
+    width: z.number().int(),
+    height: z.number().int(),
+    bytes: z.number().int(),
+    fromDisk: z.boolean().describe('True when served from a saved fetch_channel_thumbnails run'),
+};
+/**
+ * One image, returned as an MCP image block so the model can look at it.
+ *
+ * Remote-safe: the image is fetched into memory under a cap and never written.
+ * Locally, an image a previous fetch_channel_thumbnails run saved is served
+ * from disk instead, so what the model sees is exactly what was stored.
+ */
+export async function getThumbnailHandler(args, options = { store: false }) {
+    const picture = args.image === 'thumbnail'
+        ? await videoPicture(args, options.store)
+        : await channelPicture(args, options.store);
+    const { bytes, probe, sourceUrl, variant, fromDisk, videoId, channelId } = picture;
+    const label = videoId ?? channelId ?? '';
+    return {
+        content: [
+            {
+                type: 'text',
+                text: `${label} ${args.image}, ${probe.width}x${probe.height} ${probe.format.toUpperCase()}, ${Math.round(bytes.byteLength / 1024)} KB (${variant}${fromDisk ? ', from disk' : ''})`,
+            },
+            { type: 'image', data: bytes.toString('base64'), mimeType: probe.mimeType },
+        ],
+        structuredContent: {
+            image: args.image,
+            ...(videoId === undefined ? {} : { videoId }),
+            ...(channelId === undefined ? {} : { channelId }),
+            sourceUrl,
+            variant,
+            mimeType: probe.mimeType,
+            width: probe.width,
+            height: probe.height,
+            bytes: bytes.byteLength,
+            fromDisk,
+        },
+    };
+}
+async function videoPicture(args, store) {
+    if (args.video === undefined) {
+        throw new YouTubeError('INVALID_INPUT', 'Pass video to fetch a thumbnail.', {
+            nextStep: 'Give a video ID or URL, or set image to avatar or banner with a channel.',
+        });
+    }
+    const videoId = extractVideoId(args.video);
+    const stored = store ? await storedVideo(videoId) : undefined;
+    if (stored !== undefined)
+        return stored;
+    const climbed = await climb(videoRungs(videoId, undefined, false, args.quality), MAX_INLINE_IMAGE_BYTES);
+    return {
+        bytes: climbed.bytes,
+        probe: climbed.probe,
+        sourceUrl: climbed.rung.url,
+        variant: climbed.rung.variant,
+        fromDisk: false,
+        videoId,
+    };
+}
+async function channelPicture(args, store) {
+    if (args.channel === undefined || args.image === 'thumbnail') {
+        throw new YouTubeError('INVALID_INPUT', `Pass channel to fetch a channel ${args.image}.`, {
+            nextStep: 'Give a channel URL, @handle or name.',
+        });
+    }
+    const kind = args.image;
+    const stored = store ? await storedChannelImage(args.channel, kind) : undefined;
+    if (stored !== undefined)
+        return stored;
+    const info = await getChannelInfo(args.channel);
+    const channelId = assertChannelId(info.channelId);
+    const url = kind === 'avatar' ? info.avatarUrl : info.bannerUrl;
+    if (url === undefined) {
+        throw new YouTubeError('NOT_FOUND', `${info.name} lists no ${kind}.`);
+    }
+    const { bytes } = await fetchImage(url, { maxBytes: MAX_INLINE_IMAGE_BYTES });
+    const probe = probeImage(bytes);
+    if (probe === undefined)
+        throw new YouTubeError('FETCH_FAILED', 'The image could not be read.');
+    return { bytes, probe, sourceUrl: url, variant: 'uncropped', fromDisk: false, channelId };
+}
+/** A saved thumbnail for this video in any fetched channel, when there is one. */
+async function storedVideo(videoId) {
+    for (const manifest of await listThumbnailManifests()) {
+        const entry = manifest.videos[videoId];
+        const path = entry === undefined ? undefined : entryPath(manifest.channel.channelId, entry);
+        if (entry === undefined || path === undefined)
+            continue;
+        const picture = await fromDisk(path, entry.sourceUrl ?? '', entry.variant ?? 'saved');
+        if (picture !== undefined)
+            return { ...picture, videoId };
+    }
+    return undefined;
+}
+async function storedChannelImage(channel, kind) {
+    const [manifest] = findByChannel(await listThumbnailManifests(), channel);
+    const image = manifest?.[kind];
+    if (manifest === undefined || image === undefined)
+        return undefined;
+    const path = channelImageFile(manifest.channel.channelId, image);
+    if (path === undefined)
+        return undefined;
+    const picture = await fromDisk(path, image.sourceUrl ?? '', image.variant ?? 'saved');
+    return picture === undefined ? undefined : { ...picture, channelId: manifest.channel.channelId };
+}
+async function fromDisk(path, sourceUrl, variant) {
+    let bytes;
+    try {
+        bytes = await readFile(path);
+    }
+    catch {
+        return undefined;
+    }
+    const probe = probeImage(bytes);
+    return probe === undefined ? undefined : { bytes, probe, sourceUrl, variant, fromDisk: true };
+}
+//# sourceMappingURL=get-thumbnail.js.map

package/dist/tools/get-thumbnail.js.map

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

package/dist/tools/get-transcript.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-transcript.d.ts","sourceRoot":"","sources":["../../src/tools/get-transcript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,mBAAmB;;;;;;;;;;CA+C/B,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;CAWrC,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,UAAU,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAuCD,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAwF3F"}
+{"version":3,"file":"get-transcript.d.ts","sourceRoot":"","sources":["../../src/tools/get-transcript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,mBAAmB;;;;;;;;;;CA+C/B,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;CAWrC,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,UAAU,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AA0BD,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CAwF3F"}