youtube-knowledge-mcp 2.2.0 → 3.0.1

package/dist/tools/get-video-details.js

@@ -0,0 +1,147 @@
+import { z } from 'zod';
+import { formatCount, formatYouTubeDate, toolResult } from '../utils/format.js';
+import { mostReplayed } from '../utils/most-replayed.js';
+import { videoMoment, videoMomentSchema } from '../utils/moment.js';
+import { readVideoStats } from '../utils/video-stats-cache.js';
+/**
+ * Everything yt-dlp reports about one video that get_video_info does not carry:
+ * what people replay most, the licence, the music credits, the caption inventory,
+ * the category and the frame size. One read, served from disk when it is fresh.
+ */
+const MOST_REPLAYED_COUNT = 5;
+const heatSegmentSchema = z.object({
+    startSeconds: z.number(),
+    endSeconds: z.number(),
+    value: z.number().describe('Relative replay rate, 0 to 1'),
+});
+const mostReplayedSchema = videoMomentSchema.extend({
+    endSeconds: z.number(),
+    value: z.number().describe('Relative replay rate, 0 to 1'),
+});
+export const getVideoDetailsSchema = {
+    video: z.string().describe('YouTube video ID (e.g., dQw4w9WgXcQ) or full URL'),
+    heatmap: z
+        .boolean()
+        .default(false)
+        .describe('Also return the full replay heatmap, about a hundred slices. The strongest moments are always returned. Default: false'),
+    refresh: z
+        .boolean()
+        .default(false)
+        .describe('Fetch from YouTube even if a fresh saved copy exists. Default: false'),
+};
+export const getVideoDetailsOutputSchema = {
+    videoId: z.string(),
+    title: z.string(),
+    url: z.string(),
+    channel: z.string(),
+    channelId: z.string().optional(),
+    channelUrl: z.string().optional(),
+    channelFollowerCount: z.number().optional(),
+    uploader: z.string().optional(),
+    uploadDate: z.string(),
+    durationSeconds: z.number(),
+    durationFormatted: z.string(),
+    viewCount: z.number().optional(),
+    likeCount: z.number().optional(),
+    commentCount: z.number().optional(),
+    categories: z.array(z.string()),
+    tags: z.array(z.string()),
+    ageLimit: z.number().int(),
+    availability: z.string().optional(),
+    liveStatus: z.string().optional(),
+    wasLive: z.boolean(),
+    mediaType: z.string().optional(),
+    license: z.string().optional(),
+    language: z.string().optional(),
+    playableInEmbed: z.boolean().optional(),
+    releaseTimestamp: z.number().optional(),
+    music: z
+        .object({
+        track: z.string().optional(),
+        artist: z.string().optional(),
+        album: z.string().optional(),
+        releaseYear: z.number().optional(),
+    })
+        .optional(),
+    video: z
+        .object({
+        width: z.number().optional(),
+        height: z.number().optional(),
+        fps: z.number().optional(),
+    })
+        .optional(),
+    chapterCount: z.number().int(),
+    captions: z.object({ manual: z.array(z.string()), automatic: z.array(z.string()) }),
+    mostReplayed: z
+        .array(mostReplayedSchema)
+        .describe('The moments people replay most, strongest first. Empty when YouTube has no data'),
+    heatmap: z.array(heatSegmentSchema).optional(),
+    description: z.string(),
+    descriptionChars: z.number().int(),
+    thumbnailUrl: z.string().optional(),
+    cached: z.boolean().describe('True when served from a saved copy rather than fetched'),
+};
+export async function getVideoDetailsHandler(args) {
+    const { stats, cached } = await readVideoStats(args.video, { refresh: args.refresh });
+    const peaks = mostReplayed(stats.heatmap ?? [], MOST_REPLAYED_COUNT).map((peak) => ({
+        ...videoMoment(stats.id, peak.startSeconds),
+        endSeconds: peak.endSeconds,
+        value: peak.value,
+    }));
+    const counts = [
+        stats.viewCount === undefined ? undefined : `${formatCount(stats.viewCount)} views`,
+        stats.likeCount === undefined ? undefined : `${formatCount(stats.likeCount)} likes`,
+        stats.commentCount === undefined ? undefined : `${formatCount(stats.commentCount)} comments`,
+    ].filter((part) => part !== undefined);
+    const lines = [
+        stats.title,
+        `${stats.channel}${counts.length === 0 ? '' : ` · ${counts.join(' · ')}`}`,
+        `${stats.durationFormatted} · uploaded ${formatYouTubeDate(stats.uploadDate)}`,
+        ...(stats.categories.length === 0 ? [] : [`Category: ${stats.categories.join(', ')}`]),
+        ...(stats.license === undefined ? [] : [`License: ${stats.license}`]),
+        ...(stats.language === undefined ? [] : [`Language: ${stats.language}`]),
+        ...(peaks.length === 0
+            ? []
+            : [`Most replayed: ${peaks.map((peak) => peak.timestamp).join(', ')}`]),
+        `Captions: ${stats.captions.manual.length} manual, ${stats.captions.automatic.length} automatic`,
+        ...(cached ? ['', 'Served from a saved copy; pass refresh to fetch again.'] : []),
+    ];
+    return toolResult(lines.join('\n'), {
+        videoId: stats.id,
+        title: stats.title,
+        url: stats.url,
+        channel: stats.channel,
+        channelId: stats.channelId,
+        channelUrl: stats.channelUrl,
+        channelFollowerCount: stats.channelFollowerCount,
+        uploader: stats.uploader,
+        uploadDate: stats.uploadDate,
+        durationSeconds: stats.durationSeconds,
+        durationFormatted: stats.durationFormatted,
+        viewCount: stats.viewCount,
+        likeCount: stats.likeCount,
+        commentCount: stats.commentCount,
+        categories: stats.categories,
+        tags: stats.tags,
+        ageLimit: stats.ageLimit,
+        availability: stats.availability,
+        liveStatus: stats.liveStatus,
+        wasLive: stats.wasLive,
+        mediaType: stats.mediaType,
+        license: stats.license,
+        language: stats.language,
+        playableInEmbed: stats.playableInEmbed,
+        releaseTimestamp: stats.releaseTimestamp,
+        music: stats.music,
+        video: stats.video,
+        chapterCount: stats.chapters.length,
+        captions: stats.captions,
+        mostReplayed: peaks,
+        ...(args.heatmap && stats.heatmap !== undefined ? { heatmap: stats.heatmap } : {}),
+        description: stats.description,
+        descriptionChars: stats.descriptionChars,
+        thumbnailUrl: stats.thumbnailUrl,
+        cached,
+    });
+}
+//# sourceMappingURL=get-video-details.js.map

package/dist/tools/get-video-details.js.map

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

package/dist/tools/gif-concat.d.ts

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+/** Small pieces of video editing: an animated GIF from a moment, and clips joined into one. */
+export declare const extractGifSchema: {
+    width: z.ZodDefault<z.ZodNumber>;
+    fps: z.ZodDefault<z.ZodNumber>;
+    start: z.ZodOptional<z.ZodString>;
+    end: z.ZodOptional<z.ZodString>;
+    chapter: z.ZodOptional<z.ZodString>;
+    outputDir: z.ZodOptional<z.ZodString>;
+    video: z.ZodString;
+};
+export declare const extractGifOutputSchema: {
+    videoId: z.ZodString;
+    title: z.ZodString;
+    filePath: z.ZodString;
+    startSeconds: z.ZodNumber;
+    endSeconds: z.ZodNumber;
+    durationSeconds: z.ZodNumber;
+    width: z.ZodNumber;
+    fps: z.ZodNumber;
+    bytes: z.ZodNumber;
+};
+export interface ExtractGifArgs {
+    video: string;
+    start?: string;
+    end?: string;
+    chapter?: string;
+    outputDir?: string;
+    width: number;
+    fps: number;
+}
+export declare function extractGifHandler(args: ExtractGifArgs): Promise<CallToolResult>;
+export declare const concatClipsSchema: {
+    clips: z.ZodArray<z.ZodString, "many">;
+    name: z.ZodOptional<z.ZodString>;
+    outputDir: z.ZodOptional<z.ZodString>;
+};
+export declare const concatClipsOutputSchema: {
+    filePath: z.ZodString;
+    clips: z.ZodNumber;
+    bytes: z.ZodNumber;
+};
+export declare function concatClipsHandler(args: {
+    clips: string[];
+    name?: string;
+    outputDir?: string;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=gif-concat.d.ts.map

package/dist/tools/gif-concat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gif-concat.d.ts","sourceRoot":"","sources":["../../src/tools/gif-concat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAOzE,+FAA+F;AAI/F,eAAO,MAAM,gBAAgB;;;;;;;;CAiB5B,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;CAUlC,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CA6BrF;AAID,eAAO,MAAM,iBAAiB;;;;CAiB7B,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;CAInC,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,cAAc,CAAC,CAe1B"}

package/dist/tools/gif-concat.js

@@ -0,0 +1,96 @@
+import { z } from 'zod';
+import { fileResult, formatFilesize } from '../utils/format.js';
+import { DEFAULT_GIF_FPS, DEFAULT_GIF_WIDTH, extractGif } from '../utils/gif.js';
+import { MAX_CONCAT_FILES, MIN_CONCAT_FILES, concatClips } from '../utils/concat.js';
+import { formatTimestamp } from '../utils/transcript.js';
+import { RANGE_FIELDS, parseRange } from './clips.js';
+/** Small pieces of video editing: an animated GIF from a moment, and clips joined into one. */
+// -- extract_gif ---------------------------------------------------------
+export const extractGifSchema = {
+    video: z.string().describe('YouTube video ID or full URL'),
+    ...RANGE_FIELDS,
+    width: z
+        .number()
+        .int()
+        .min(120)
+        .max(800)
+        .default(DEFAULT_GIF_WIDTH)
+        .describe(`GIF width in pixels. Default: ${String(DEFAULT_GIF_WIDTH)}`),
+    fps: z
+        .number()
+        .int()
+        .min(4)
+        .max(24)
+        .default(DEFAULT_GIF_FPS)
+        .describe(`Frames per second. Default: ${String(DEFAULT_GIF_FPS)}`),
+};
+export const extractGifOutputSchema = {
+    videoId: z.string(),
+    title: z.string(),
+    filePath: z.string(),
+    startSeconds: z.number(),
+    endSeconds: z.number(),
+    durationSeconds: z.number(),
+    width: z.number().int(),
+    fps: z.number().int(),
+    bytes: z.number().int(),
+};
+export async function extractGifHandler(args) {
+    const result = await extractGif(args.video, parseRange(args), {
+        width: args.width,
+        fps: args.fps,
+        outputDir: args.outputDir,
+    });
+    return fileResult([
+        '✓ GIF made',
+        '',
+        result.title,
+        `${formatTimestamp(result.start)} – ${formatTimestamp(result.end)}, ${String(result.width)}px at ${String(result.fps)} fps, ${formatFilesize(result.bytes)}`,
+        '',
+        result.filePath,
+    ].join('\n'), {
+        videoId: result.videoId,
+        title: result.title,
+        filePath: result.filePath,
+        startSeconds: result.start,
+        endSeconds: result.end,
+        durationSeconds: result.duration,
+        width: result.width,
+        fps: result.fps,
+        bytes: result.bytes,
+    }, { path: result.filePath, name: `${result.title} GIF`, mimeType: 'image/gif' });
+}
+// -- concat_clips --------------------------------------------------------
+export const concatClipsSchema = {
+    clips: z
+        .array(z.string().max(1024))
+        .min(MIN_CONCAT_FILES)
+        .max(MAX_CONCAT_FILES)
+        .describe(`Paths of the video files to join, in order, each inside your home directory. Between ${String(MIN_CONCAT_FILES)} and ${String(MAX_CONCAT_FILES)}. Typically the paths extract_clip returned.`),
+    name: z
+        .string()
+        .max(80)
+        .optional()
+        .describe('Name for the joined file, without extension. Default: montage-<hash of the inputs>'),
+    outputDir: z
+        .string()
+        .optional()
+        .describe('Where to write the file. Must be inside your home directory.'),
+};
+export const concatClipsOutputSchema = {
+    filePath: z.string(),
+    clips: z.number().int(),
+    bytes: z.number().int(),
+};
+export async function concatClipsHandler(args) {
+    const { clips, name, outputDir } = args;
+    const result = await concatClips(clips, { name, outputDir });
+    return fileResult([
+        `✓ ${String(result.clips)} clips joined`,
+        '',
+        formatFilesize(result.bytes),
+        '',
+        result.filePath,
+    ].join('\n'), { filePath: result.filePath, clips: result.clips, bytes: result.bytes }, { path: result.filePath, name: 'Joined clips', mimeType: 'video/mp4' });
+}
+//# sourceMappingURL=gif-concat.js.map

package/dist/tools/gif-concat.js.map

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

package/dist/tools/harvest-channel.d.ts

@@ -0,0 +1,92 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+export declare const harvestChannelSchema: {
+    channel: z.ZodString;
+    maxVideos: z.ZodDefault<z.ZodNumber>;
+};
+export declare const harvestChannelOutputSchema: {
+    channelId: z.ZodString;
+    name: z.ZodString;
+    handle: z.ZodString;
+    videosSeen: z.ZodNumber;
+    videosAdded: z.ZodNumber;
+    tabs: z.ZodArray<z.ZodObject<{
+        tab: z.ZodString;
+        listed: z.ZodNumber;
+        added: z.ZodNumber;
+        complete: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        complete: boolean;
+        tab: string;
+        listed: number;
+        added: number;
+        error?: string | undefined;
+    }, {
+        complete: boolean;
+        tab: string;
+        listed: number;
+        added: number;
+        error?: string | undefined;
+    }>, "many">;
+    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;
+    }>;
+};
+/**
+ * Catalogues every video a channel lists, across every tab.
+ *
+ * Calling it again continues rather than duplicating: videos are keyed on
+ * their id and upserted, so a re-run costs requests and never data.
+ */
+export declare function harvestChannelHandler({ channel, maxVideos, }: {
+    channel: string;
+    maxVideos: number;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=harvest-channel.d.ts.map

package/dist/tools/harvest-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harvest-channel.d.ts","sourceRoot":"","sources":["../../src/tools/harvest-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,oBAAoB;;;CAYhC,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgBtC,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,EAC1C,OAAO,EACP,SAAS,GACV,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,cAAc,CAAC,CA2B1B"}

package/dist/tools/harvest-channel.js

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+import { toolResult } from '../utils/format.js';
+import { getStore } from '../utils/store.js';
+import { harvestCatalog, MAX_VIDEOS_PER_CATALOG } from '../utils/harvest-catalog.js';
+import { renderCoverage } from '../utils/coverage-text.js';
+import { coverageSchema } from '../harvest-schemas.js';
+export const harvestChannelSchema = {
+    channel: z.string().max(256).describe('Channel URL, @handle, or channel id'),
+    maxVideos: z
+        .number()
+        .int()
+        .min(1)
+        .max(MAX_VIDEOS_PER_CATALOG)
+        .default(500)
+        .describe(`Ceiling on videos to catalogue across all tabs (max ${String(MAX_VIDEOS_PER_CATALOG)}). ` +
+        'Reaching it makes the result provably incomplete, and the receipt says so.'),
+};
+export const harvestChannelOutputSchema = {
+    channelId: z.string(),
+    name: z.string(),
+    handle: z.string(),
+    videosSeen: z.number().int().describe('Distinct videos in the catalogue after this call'),
+    videosAdded: z.number().int().describe('Videos this call had not seen before'),
+    tabs: z.array(z.object({
+        tab: z.string(),
+        listed: z.number().int(),
+        added: z.number().int(),
+        complete: z.boolean(),
+        error: z.string().optional(),
+    })),
+    coverage: coverageSchema,
+};
+/**
+ * Catalogues every video a channel lists, across every tab.
+ *
+ * Calling it again continues rather than duplicating: videos are keyed on
+ * their id and upserted, so a re-run costs requests and never data.
+ */
+export async function harvestChannelHandler({ channel, maxVideos, }) {
+    const store = await getStore();
+    // harvestCatalog takes the per-channel lock itself, once it has resolved the
+    // id the lock is keyed on.
+    const result = await harvestCatalog(store, channel, { maxVideos });
+    const lines = [
+        renderCoverage(result.coverage),
+        '',
+        `${result.name} (${result.handle}): ${String(result.videosSeen)} videos catalogued, ${String(result.videosAdded)} new.`,
+        ...result.tabs.map((tab) => tab.error === undefined
+            ? `  ${tab.tab}: ${String(tab.listed)} listed${tab.complete ? '' : ' (capped)'}`
+            : `  ${tab.tab}: ${tab.error}`),
+    ];
+    return toolResult(lines.join('\n'), {
+        channelId: result.channelId,
+        name: result.name,
+        handle: result.handle,
+        videosSeen: result.videosSeen,
+        videosAdded: result.videosAdded,
+        tabs: result.tabs,
+        coverage: result.coverage,
+    });
+}
+//# sourceMappingURL=harvest-channel.js.map

package/dist/tools/harvest-channel.js.map

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

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

@@ -0,0 +1,81 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+export declare const MAX_COMMENTS_PER_VIDEO = 100000;
+export declare const harvestCommentsSchema: {
+    video: z.ZodString;
+    maxComments: z.ZodDefault<z.ZodNumber>;
+    sort: z.ZodDefault<z.ZodEnum<["top", "new"]>>;
+    maxRepliesPerThread: z.ZodDefault<z.ZodNumber>;
+};
+export declare const harvestCommentsOutputSchema: {
+    videoId: z.ZodString;
+    added: z.ZodNumber;
+    written: z.ZodNumber;
+    topLevel: z.ZodNumber;
+    replies: 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;
+    }>;
+};
+/**
+ * Extracts a video's comments into the store.
+ *
+ * There is no comment cursor — yt-dlp emits one object at the end of the walk,
+ * so an interrupted run keeps nothing for that video. The resume story is
+ * therefore "run it again with a larger cap", and the receipt says so rather
+ * than implying a continuation that does not exist.
+ */
+export declare function harvestCommentsHandler({ video, maxComments, sort, maxRepliesPerThread, }: {
+    video: string;
+    maxComments: number;
+    sort: 'top' | 'new';
+    maxRepliesPerThread: number;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=harvest-comments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harvest-comments.d.ts","sourceRoot":"","sources":["../../src/tools/harvest-comments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,eAAO,MAAM,sBAAsB,SAAU,CAAC;AAE9C,eAAO,MAAM,qBAAqB;;;;;CAoBjC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAWvC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAAC,EAC3C,KAAK,EACL,WAAW,EACX,IAAI,EACJ,mBAAmB,GACpB,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;CAC7B,GAAG,OAAO,CAAC,cAAc,CAAC,CAsE1B"}