youtube-knowledge-mcp 2.2.0 → 3.0.1

package/dist/tools/frames.js.map

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

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

@@ -12,6 +12,8 @@ export declare const getChannelInfoOutputSchema: {
     description: z.ZodString;
     avatarUrl: z.ZodOptional<z.ZodString>;
     bannerUrl: z.ZodOptional<z.ZodString>;
+    isVerified: z.ZodOptional<z.ZodBoolean>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 };
 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;;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"}
+{"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,CAqB1B"}

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

@@ -17,6 +17,10 @@ export async function getChannelInfoHandler({ channel, }) {
         `${formatCount(info.subscriberCount)} subscribers`,
         info.channelUrl,
     ].filter(Boolean);
+    if (info.isVerified === true)
+        lines.push('Verified');
+    if (info.tags !== undefined)
+        lines.push(`Keywords: ${info.tags.join(', ')}`);
     if (info.avatarUrl !== undefined)
         lines.push(`Avatar: ${info.avatarUrl}`);
     if (info.bannerUrl !== undefined)

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;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"}
+{"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,UAAU,KAAK,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7E,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-comments.d.ts

@@ -3,13 +3,10 @@ import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 export declare const getCommentsSchema: {
     video: z.ZodString;
     limit: z.ZodDefault<z.ZodNumber>;
+    includeReplies: z.ZodDefault<z.ZodBoolean>;
+    sort: z.ZodDefault<z.ZodEnum<["top", "new"]>>;
 };
 export declare const getCommentsOutputSchema: {
-    total: z.ZodNumber;
-    count: z.ZodNumber;
-    offset: z.ZodNumber;
-    hasMore: z.ZodBoolean;
-    nextOffset: z.ZodOptional<z.ZodNumber>;
     comments: z.ZodArray<z.ZodObject<{
         author: z.ZodString;
         text: z.ZodString;
@@ -26,9 +23,244 @@ export declare const getCommentsOutputSchema: {
         text: string;
         isPinned: boolean;
     }>, "many">;
+    threads: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        comment: z.ZodObject<{
+            id: z.ZodString;
+            parentId: z.ZodNullable<z.ZodString>;
+            author: z.ZodString;
+            authorId: z.ZodOptional<z.ZodString>;
+            authorUrl: z.ZodOptional<z.ZodString>;
+            authorThumbnailUrl: z.ZodOptional<z.ZodString>;
+            authorIsUploader: z.ZodBoolean;
+            authorIsVerified: z.ZodBoolean;
+            text: z.ZodString;
+            likeCount: z.ZodNumber;
+            isPinned: z.ZodBoolean;
+            isFavorited: z.ZodBoolean;
+            timestamp: z.ZodOptional<z.ZodNumber>;
+            publishedAt: z.ZodOptional<z.ZodString>;
+            timeText: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            likeCount: number;
+            author: string;
+            text: string;
+            isPinned: boolean;
+            parentId: string | null;
+            authorIsUploader: boolean;
+            authorIsVerified: boolean;
+            isFavorited: boolean;
+            authorId?: string | undefined;
+            authorUrl?: string | undefined;
+            authorThumbnailUrl?: string | undefined;
+            timestamp?: number | undefined;
+            publishedAt?: string | undefined;
+            timeText?: string | undefined;
+        }, {
+            id: string;
+            likeCount: number;
+            author: string;
+            text: string;
+            isPinned: boolean;
+            parentId: string | null;
+            authorIsUploader: boolean;
+            authorIsVerified: boolean;
+            isFavorited: boolean;
+            authorId?: string | undefined;
+            authorUrl?: string | undefined;
+            authorThumbnailUrl?: string | undefined;
+            timestamp?: number | undefined;
+            publishedAt?: string | undefined;
+            timeText?: string | undefined;
+        }>;
+        replies: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            parentId: z.ZodNullable<z.ZodString>;
+            author: z.ZodString;
+            authorId: z.ZodOptional<z.ZodString>;
+            authorUrl: z.ZodOptional<z.ZodString>;
+            authorThumbnailUrl: z.ZodOptional<z.ZodString>;
+            authorIsUploader: z.ZodBoolean;
+            authorIsVerified: z.ZodBoolean;
+            text: z.ZodString;
+            likeCount: z.ZodNumber;
+            isPinned: z.ZodBoolean;
+            isFavorited: z.ZodBoolean;
+            timestamp: z.ZodOptional<z.ZodNumber>;
+            publishedAt: z.ZodOptional<z.ZodString>;
+            timeText: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            likeCount: number;
+            author: string;
+            text: string;
+            isPinned: boolean;
+            parentId: string | null;
+            authorIsUploader: boolean;
+            authorIsVerified: boolean;
+            isFavorited: boolean;
+            authorId?: string | undefined;
+            authorUrl?: string | undefined;
+            authorThumbnailUrl?: string | undefined;
+            timestamp?: number | undefined;
+            publishedAt?: string | undefined;
+            timeText?: string | undefined;
+        }, {
+            id: string;
+            likeCount: number;
+            author: string;
+            text: string;
+            isPinned: boolean;
+            parentId: string | null;
+            authorIsUploader: boolean;
+            authorIsVerified: boolean;
+            isFavorited: boolean;
+            authorId?: string | undefined;
+            authorUrl?: string | undefined;
+            authorThumbnailUrl?: string | undefined;
+            timestamp?: number | undefined;
+            publishedAt?: string | undefined;
+            timeText?: string | undefined;
+        }>, "many">;
+        replyCount: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        comment: {
+            id: string;
+            likeCount: number;
+            author: string;
+            text: string;
+            isPinned: boolean;
+            parentId: string | null;
+            authorIsUploader: boolean;
+            authorIsVerified: boolean;
+            isFavorited: boolean;
+            authorId?: string | undefined;
+            authorUrl?: string | undefined;
+            authorThumbnailUrl?: string | undefined;
+            timestamp?: number | undefined;
+            publishedAt?: string | undefined;
+            timeText?: string | undefined;
+        };
+        replies: {
+            id: string;
+            likeCount: number;
+            author: string;
+            text: string;
+            isPinned: boolean;
+            parentId: string | null;
+            authorIsUploader: boolean;
+            authorIsVerified: boolean;
+            isFavorited: boolean;
+            authorId?: string | undefined;
+            authorUrl?: string | undefined;
+            authorThumbnailUrl?: string | undefined;
+            timestamp?: number | undefined;
+            publishedAt?: string | undefined;
+            timeText?: string | undefined;
+        }[];
+        replyCount: number;
+    }, {
+        comment: {
+            id: string;
+            likeCount: number;
+            author: string;
+            text: string;
+            isPinned: boolean;
+            parentId: string | null;
+            authorIsUploader: boolean;
+            authorIsVerified: boolean;
+            isFavorited: boolean;
+            authorId?: string | undefined;
+            authorUrl?: string | undefined;
+            authorThumbnailUrl?: string | undefined;
+            timestamp?: number | undefined;
+            publishedAt?: string | undefined;
+            timeText?: string | undefined;
+        };
+        replies: {
+            id: string;
+            likeCount: number;
+            author: string;
+            text: string;
+            isPinned: boolean;
+            parentId: string | null;
+            authorIsUploader: boolean;
+            authorIsVerified: boolean;
+            isFavorited: boolean;
+            authorId?: string | undefined;
+            authorUrl?: string | undefined;
+            authorThumbnailUrl?: string | undefined;
+            timestamp?: number | undefined;
+            publishedAt?: string | undefined;
+            timeText?: string | undefined;
+        }[];
+        replyCount: number;
+    }>, "many">>;
+    extractedTotal: z.ZodNumber;
+    orphanReplies: z.ZodNumber;
+    coverage: 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", "store:catalog"]>>;
+        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, {
+        source: string;
+        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";
+        harvestedAt: string;
+        expected?: number | undefined;
+        note?: string | undefined;
+        ranToExhaustion?: boolean | undefined;
+        expectedSource?: "youtube:playlist_count" | "source-exhausted" | "youtube:comment_count" | "store:catalog" | undefined;
+        staleAfter?: string | undefined;
+        limitApplied?: number | undefined;
+        sortApplied?: "top" | "new" | undefined;
+        resumeToken?: string | undefined;
+    }, {
+        source: string;
+        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";
+        harvestedAt: string;
+        expected?: number | undefined;
+        note?: string | undefined;
+        ranToExhaustion?: boolean | undefined;
+        expectedSource?: "youtube:playlist_count" | "source-exhausted" | "youtube:comment_count" | "store:catalog" | undefined;
+        staleAfter?: string | undefined;
+        limitApplied?: number | undefined;
+        sortApplied?: "top" | "new" | undefined;
+        resumeToken?: string | undefined;
+    }>;
 };
-export declare function getCommentsHandler({ video, limit, }: {
+/**
+ * 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 declare function getCommentsHandler({ video, limit, includeReplies, sort, }: {
     video: string;
     limit: number;
+    includeReplies: boolean;
+    sort: 'top' | 'new';
 }): Promise<CallToolResult>;
 //# sourceMappingURL=get-comments.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"get-comments.d.ts","sourceRoot":"","sources":["../../src/tools/get-comments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,iBAAiB;;;CAQ7B,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;CAGnC,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,EACvC,KAAK,EACL,KAAK,GACN,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,cAAc,CAAC,CAmB1B"}
+{"version":3,"file":"get-comments.d.ts","sourceRoot":"","sources":["../../src/tools/get-comments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,iBAAiB;;;;;CAoB7B,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAYnC,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,EACvC,KAAK,EACL,KAAK,EACL,cAAc,EACd,IAAI,GACL,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,OAAO,CAAC;IACxB,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;CACrB,GAAG,OAAO,CAAC,cAAc,CAAC,CAuD1B"}

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", "store:catalog"]>>;
+        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, {
+        source: string;
+        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";
+        harvestedAt: string;
+        expected?: number | undefined;
+        note?: string | undefined;
+        ranToExhaustion?: boolean | undefined;
+        expectedSource?: "youtube:playlist_count" | "source-exhausted" | "youtube:comment_count" | "store:catalog" | undefined;
+        staleAfter?: string | undefined;
+        limitApplied?: number | undefined;
+        sortApplied?: "top" | "new" | undefined;
+        resumeToken?: string | undefined;
+    }, {
+        source: string;
+        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";
+        harvestedAt: string;
+        expected?: number | undefined;
+        note?: string | undefined;
+        ranToExhaustion?: boolean | undefined;
+        expectedSource?: "youtube:playlist_count" | "source-exhausted" | "youtube:comment_count" | "store:catalog" | 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"}