youtube-knowledge-mcp 3.0.0 → 3.0.1

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

@@ -36,7 +36,7 @@ export declare const harvestChannelOutputSchema: {
         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"]>>;
+        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;
@@ -46,33 +46,33 @@ export declare const harvestChannelOutputSchema: {
         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";
-        source: string;
         harvestedAt: string;
         expected?: number | undefined;
         note?: string | undefined;
         ranToExhaustion?: boolean | undefined;
-        expectedSource?: "youtube:playlist_count" | "source-exhausted" | "youtube:comment_count" | 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";
-        source: string;
         harvestedAt: string;
         expected?: number | undefined;
         note?: string | undefined;
         ranToExhaustion?: boolean | undefined;
-        expectedSource?: "youtube:playlist_count" | "source-exhausted" | "youtube:comment_count" | undefined;
+        expectedSource?: "youtube:playlist_count" | "source-exhausted" | "youtube:comment_count" | "store:catalog" | undefined;
         staleAfter?: string | undefined;
         limitApplied?: number | undefined;
         sortApplied?: "top" | "new" | undefined;

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

@@ -21,7 +21,7 @@ export declare const harvestCommentsOutputSchema: {
         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"]>>;
+        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;
@@ -31,33 +31,33 @@ export declare const harvestCommentsOutputSchema: {
         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";
-        source: string;
         harvestedAt: string;
         expected?: number | undefined;
         note?: string | undefined;
         ranToExhaustion?: boolean | undefined;
-        expectedSource?: "youtube:playlist_count" | "source-exhausted" | "youtube:comment_count" | 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";
-        source: string;
         harvestedAt: string;
         expected?: number | undefined;
         note?: string | undefined;
         ranToExhaustion?: boolean | undefined;
-        expectedSource?: "youtube:playlist_count" | "source-exhausted" | "youtube:comment_count" | undefined;
+        expectedSource?: "youtube:playlist_count" | "source-exhausted" | "youtube:comment_count" | "store:catalog" | undefined;
         staleAfter?: string | undefined;
         limitApplied?: number | undefined;
         sortApplied?: "top" | "new" | undefined;

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

@@ -0,0 +1,84 @@
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const harvestDetailsSchema: {
+    channel: z.ZodString;
+    maxVideos: z.ZodDefault<z.ZodNumber>;
+    retryUnreadable: z.ZodDefault<z.ZodBoolean>;
+};
+export declare const harvestDetailsOutputSchema: {
+    channelId: z.ZodString;
+    name: z.ZodString;
+    attempted: z.ZodNumber;
+    stored: z.ZodNumber;
+    failures: z.ZodArray<z.ZodObject<{
+        videoId: z.ZodString;
+        code: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        videoId: string;
+    }, {
+        code: string;
+        videoId: string;
+    }>, "many">;
+    remaining: z.ZodNumber;
+    stoppedBecause: z.ZodOptional<z.ZodString>;
+    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;
+    }>;
+};
+/**
+ * Reads the full record of each catalogued video and keeps it in the store, a batch at a
+ * time. Calling it again continues with the next unread videos.
+ */
+export declare function harvestDetailsHandler(args: {
+    channel: string;
+    maxVideos: number;
+    retryUnreadable: boolean;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=harvest-details.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"harvest-details.d.ts","sourceRoot":"","sources":["../../src/tools/harvest-details.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAWzE,eAAO,MAAM,oBAAoB;;;;CAiBhC,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAYtC,CAAC;AAEF;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;CAC1B,GAAG,OAAO,CAAC,cAAc,CAAC,CAkC1B"}

package/dist/tools/harvest-details.js

@@ -0,0 +1,71 @@
+import { z } from 'zod';
+import { coverageSchema } from '../harvest-schemas.js';
+import { renderCoverage } from '../utils/coverage-text.js';
+import { toolResult } from '../utils/format.js';
+import { DEFAULT_DETAIL_BATCH, MAX_DETAIL_BATCH, harvestDetails, } from '../utils/harvest-details.js';
+import { getStore } from '../utils/store.js';
+export const harvestDetailsSchema = {
+    channel: z.string().max(256).describe('Channel URL, @handle, or channel id, already catalogued'),
+    maxVideos: z
+        .number()
+        .int()
+        .min(1)
+        .max(MAX_DETAIL_BATCH)
+        .default(DEFAULT_DETAIL_BATCH)
+        .describe(`How many unread videos to read in this call (max ${String(MAX_DETAIL_BATCH)}). Each is a full read, the request YouTube throttles hardest, so run it in batches. Default: ${String(DEFAULT_DETAIL_BATCH)}`),
+    retryUnreadable: z
+        .boolean()
+        .default(false)
+        .describe('Try again the videos earlier runs found private, members-only, age-gated or removed. Worth it after adding cookies. Default: false'),
+};
+export const harvestDetailsOutputSchema = {
+    channelId: z.string(),
+    name: z.string(),
+    attempted: z.number().int().describe('Videos read, or tried, in this call'),
+    stored: z.number().int().describe('Videos whose full record was kept'),
+    failures: z.array(z.object({ videoId: z.string(), code: z.string() })),
+    remaining: z.number().int().describe('Videos still unread that can be read'),
+    stoppedBecause: z
+        .string()
+        .optional()
+        .describe('The refusal that ended the call early, when one did'),
+    coverage: coverageSchema,
+};
+/**
+ * Reads the full record of each catalogued video and keeps it in the store, a batch at a
+ * time. Calling it again continues with the next unread videos.
+ */
+export async function harvestDetailsHandler(args) {
+    const store = await getStore();
+    const result = await harvestDetails(store, args.channel, {
+        maxVideos: args.maxVideos,
+        retryUnreadable: args.retryUnreadable,
+    });
+    const lines = [
+        renderCoverage(result.coverage),
+        '',
+        `${result.name}: ${String(result.stored)} of ${String(result.attempted)} videos read this run, ${String(result.remaining)} still unread.`,
+        ...(result.stoppedBecause === undefined
+            ? []
+            : [`Stopped early: ${result.stoppedBecause}. Everything read before it is kept.`]),
+        ...(result.failures.length === 0
+            ? []
+            : [
+                `Could not read: ${result.failures.map((failure) => `${failure.videoId} (${failure.code})`).join(', ')}`,
+            ]),
+        ...(result.remaining > 0 || result.stoppedBecause !== undefined
+            ? ['', 'Call harvest_details again to continue with the next unread videos.']
+            : []),
+    ];
+    return toolResult(lines.join('\n'), {
+        channelId: result.channelId,
+        name: result.name,
+        attempted: result.attempted,
+        stored: result.stored,
+        failures: result.failures,
+        remaining: result.remaining,
+        ...(result.stoppedBecause === undefined ? {} : { stoppedBecause: result.stoppedBecause }),
+        coverage: result.coverage,
+    });
+}
+//# sourceMappingURL=harvest-details.js.map

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

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

package/dist/tools/list-captions.d.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const listCaptionsSchema: {
+    video: z.ZodString;
+};
+export declare const listCaptionsOutputSchema: {
+    videoId: z.ZodString;
+    title: z.ZodString;
+    hasCaptions: z.ZodBoolean;
+    manual: z.ZodArray<z.ZodString, "many">;
+    automatic: z.ZodArray<z.ZodString, "many">;
+    spokenLanguage: z.ZodOptional<z.ZodString>;
+};
+export declare function listCaptionsHandler({ video }: {
+    video: string;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=list-captions.d.ts.map

package/dist/tools/list-captions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-captions.d.ts","sourceRoot":"","sources":["../../src/tools/list-captions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAazE,eAAO,MAAM,kBAAkB;;CAE9B,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;CAUpC,CAAC;AAMF,wBAAsB,mBAAmB,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAyC/F"}

package/dist/tools/list-captions.js

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+import { toolResult } from '../utils/format.js';
+import { readVideoStats } from '../utils/video-stats-cache.js';
+/**
+ * Which caption languages a video has, read from the same saved copy as
+ * get_video_details, so asking costs no extra request when that one was already made.
+ */
+/** Automatic captions come in every language YouTube can translate to; the text stays readable. */
+const LISTED_AUTOMATIC_LANGUAGES = 25;
+const ORIGINAL_SUFFIX = '-orig';
+export const listCaptionsSchema = {
+    video: z.string().describe('YouTube video ID (e.g., dQw4w9WgXcQ) or full URL'),
+};
+export const listCaptionsOutputSchema = {
+    videoId: z.string(),
+    title: z.string(),
+    hasCaptions: z.boolean(),
+    manual: z.array(z.string()).describe('Language codes of captions a person wrote or uploaded'),
+    automatic: z.array(z.string()).describe('Language codes YouTube generated or translated'),
+    spokenLanguage: z
+        .string()
+        .optional()
+        .describe('The language YouTube recognised in the audio, when it says'),
+};
+function sortedUnique(codes) {
+    return [...new Set(codes)].sort();
+}
+export async function listCaptionsHandler({ video }) {
+    const { stats } = await readVideoStats(video);
+    const manual = sortedUnique(stats.captions.manual);
+    const automatic = sortedUnique(stats.captions.automatic.filter((code) => !code.endsWith(ORIGINAL_SUFFIX)));
+    const original = stats.captions.automatic.find((code) => code.endsWith(ORIGINAL_SUFFIX));
+    const spokenLanguage = original?.slice(0, -ORIGINAL_SUFFIX.length);
+    const hasCaptions = manual.length > 0 || automatic.length > 0;
+    const structured = {
+        videoId: stats.id,
+        title: stats.title,
+        hasCaptions,
+        manual,
+        automatic,
+        ...(spokenLanguage === undefined ? {} : { spokenLanguage }),
+    };
+    if (!hasCaptions) {
+        return toolResult([
+            `${stats.title}: this video has no captions in any language.`,
+            'Use get_comments for viewer discussion, or get_video_info for the description.',
+        ].join('\n'), structured);
+    }
+    const hidden = automatic.length - LISTED_AUTOMATIC_LANGUAGES;
+    const lines = [
+        stats.title,
+        ...(spokenLanguage === undefined ? [] : [`Spoken language: ${spokenLanguage}`]),
+        `Manual (${manual.length}): ${manual.join(', ') || 'none'}`,
+        `Automatic (${automatic.length}): ${automatic.slice(0, LISTED_AUTOMATIC_LANGUAGES).join(', ') || 'none'}${hidden > 0 ? `, and ${hidden} more` : ''}`,
+        '',
+        'Pass any of these codes as language to get_transcript.',
+    ];
+    return toolResult(lines.join('\n'), structured);
+}
+//# sourceMappingURL=list-captions.js.map

package/dist/tools/list-captions.js.map

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

package/dist/tools/list-channel-playlists.d.ts

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const listChannelPlaylistsSchema: {
+    channel: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+};
+export declare const listChannelPlaylistsOutputSchema: {
+    channelId: z.ZodString;
+    channelName: z.ZodString;
+    count: z.ZodNumber;
+    mayHaveMore: z.ZodBoolean;
+    playlists: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        title: string;
+        url: string;
+    }, {
+        id: string;
+        title: string;
+        url: string;
+    }>, "many">;
+};
+export declare function listChannelPlaylistsHandler(args: {
+    channel: string;
+    limit: number;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=list-channel-playlists.d.ts.map

package/dist/tools/list-channel-playlists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-channel-playlists.d.ts","sourceRoot":"","sources":["../../src/tools/list-channel-playlists.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAMzE,eAAO,MAAM,0BAA0B;;;CActC,CAAC;AAEF,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;CAM5C,CAAC;AAEF,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,cAAc,CAAC,CAyB1B"}

package/dist/tools/list-channel-playlists.js

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import { toolResult } from '../utils/format.js';
+import { MAX_CHANNEL_PLAYLISTS, listChannelPlaylists } from '../utils/channel-playlists.js';
+const DEFAULT_LIMIT = 50;
+export const listChannelPlaylistsSchema = {
+    channel: z
+        .string()
+        .max(256)
+        .describe('YouTube channel URL, handle (e.g., @Fireship), channel id or channel name'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(MAX_CHANNEL_PLAYLISTS)
+        .default(DEFAULT_LIMIT)
+        .describe(`How many playlists to list, up to ${MAX_CHANNEL_PLAYLISTS}. Default: ${DEFAULT_LIMIT}`),
+};
+export const listChannelPlaylistsOutputSchema = {
+    channelId: z.string(),
+    channelName: z.string(),
+    count: z.number().int(),
+    mayHaveMore: z.boolean().describe('True when the limit was reached, so there may be more'),
+    playlists: z.array(z.object({ id: z.string(), title: z.string(), url: z.string() })),
+};
+export async function listChannelPlaylistsHandler(args) {
+    const { channelId, channelName, playlists, mayHaveMore } = await listChannelPlaylists(args.channel, args.limit);
+    const structured = { channelId, channelName, count: playlists.length, mayHaveMore, playlists };
+    if (playlists.length === 0) {
+        return toolResult(`${channelName} has no public playlists.`, structured);
+    }
+    const lines = [
+        `${channelName}: ${playlists.length} playlists`,
+        '',
+        ...playlists.flatMap((playlist, index) => [
+            `${index + 1}. ${playlist.title}`,
+            `   ${playlist.url}`,
+        ]),
+        ...(mayHaveMore ? ['', 'Raise limit to list more.'] : []),
+        '',
+        'Pass a playlist URL to fetch_videos or digest_playlist.',
+    ];
+    return toolResult(lines.join('\n'), structured);
+}
+//# sourceMappingURL=list-channel-playlists.js.map

package/dist/tools/list-channel-playlists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-channel-playlists.js","sourceRoot":"","sources":["../../src/tools/list-channel-playlists.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE5F,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CAAC,2EAA2E,CAAC;IACxF,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,qBAAqB,CAAC;SAC1B,OAAO,CAAC,aAAa,CAAC;SACtB,QAAQ,CACP,qCAAqC,qBAAqB,cAAc,aAAa,EAAE,CACxF;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACvB,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;IAC1F,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;CACrF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,IAGjD;IACC,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,MAAM,oBAAoB,CACnF,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,KAAK,CACX,CAAC;IAEF,MAAM,UAAU,GAAG,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;IAE/F,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,UAAU,CAAC,GAAG,WAAW,2BAA2B,EAAE,UAAU,CAAC,CAAC;IAC3E,CAAC;IAED,MAAM,KAAK,GAAG;QACZ,GAAG,WAAW,KAAK,SAAS,CAAC,MAAM,YAAY;QAC/C,EAAE;QACF,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC;YACxC,GAAG,KAAK,GAAG,CAAC,KAAK,QAAQ,CAAC,KAAK,EAAE;YACjC,MAAM,QAAQ,CAAC,GAAG,EAAE;SACrB,CAAC;QACF,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,2BAA2B,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,EAAE;QACF,yDAAyD;KAC1D,CAAC;IAEF,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;AAClD,CAAC"}

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

@@ -59,7 +59,7 @@ export declare const queryCommentsOutputSchema: {
         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"]>>;
+        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;
@@ -69,33 +69,33 @@ export declare const queryCommentsOutputSchema: {
         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";
-        source: string;
         harvestedAt: string;
         expected?: number | undefined;
         note?: string | undefined;
         ranToExhaustion?: boolean | undefined;
-        expectedSource?: "youtube:playlist_count" | "source-exhausted" | "youtube:comment_count" | 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";
-        source: string;
         harvestedAt: string;
         expected?: number | undefined;
         note?: string | undefined;
         ranToExhaustion?: boolean | undefined;
-        expectedSource?: "youtube:playlist_count" | "source-exhausted" | "youtube:comment_count" | undefined;
+        expectedSource?: "youtube:playlist_count" | "source-exhausted" | "youtube:comment_count" | "store:catalog" | undefined;
         staleAfter?: string | undefined;
         limitApplied?: number | undefined;
         sortApplied?: "top" | "new" | undefined;

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

@@ -59,7 +59,7 @@ export declare const queryVideosOutputSchema: {
         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"]>>;
+        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;
@@ -69,33 +69,33 @@ export declare const queryVideosOutputSchema: {
         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";
-        source: string;
         harvestedAt: string;
         expected?: number | undefined;
         note?: string | undefined;
         ranToExhaustion?: boolean | undefined;
-        expectedSource?: "youtube:playlist_count" | "source-exhausted" | "youtube:comment_count" | 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";
-        source: string;
         harvestedAt: string;
         expected?: number | undefined;
         note?: string | undefined;
         ranToExhaustion?: boolean | undefined;
-        expectedSource?: "youtube:playlist_count" | "source-exhausted" | "youtube:comment_count" | undefined;
+        expectedSource?: "youtube:playlist_count" | "source-exhausted" | "youtube:comment_count" | "store:catalog" | undefined;
         staleAfter?: string | undefined;
         limitApplied?: number | undefined;
         sortApplied?: "top" | "new" | undefined;