youtube-knowledge-mcp 2.1.0 → 3.0.0

package/dist/registry/video-tools.js

@@ -0,0 +1,101 @@
+import { defineTool } from './types.js';
+import { listFormatsSchema, listFormatsOutputSchema, listFormatsHandler, } from '../tools/download-video.js';
+import { fetchVideosSchema, fetchVideosOutputSchema, fetchVideosHandler, } from '../tools/fetch-videos.js';
+import { getChaptersSchema, getChaptersOutputSchema, getChaptersHandler, } from '../tools/get-chapters.js';
+import { getCommentsSchema, getCommentsOutputSchema, getCommentsHandler, } from '../tools/get-comments.js';
+import { getVideoInfoSchema, getVideoInfoOutputSchema, getVideoInfoHandler, } from '../tools/get-video-info.js';
+import { searchVideosSchema, searchVideosOutputSchema, searchVideosHandler, } from '../tools/search-videos.js';
+/** Finding videos and reading what YouTube knows about one. Remote-safe: nothing here touches the filesystem. */
+export const videoTools = [
+    defineTool({
+        name: 'search_videos',
+        mode: 'all',
+        title: 'Search YouTube Videos',
+        description: 'Search YouTube for videos by keyword or phrase. Returns video IDs, titles, durations, channels, view counts, and URLs. Results sorted by relevance.',
+        inputSchema: searchVideosSchema,
+        outputSchema: searchVideosOutputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+        handler: searchVideosHandler,
+    }),
+    defineTool({
+        name: 'fetch_videos',
+        mode: 'all',
+        title: 'Fetch YouTube Videos',
+        description: 'List videos from a YouTube playlist or channel. Returns video IDs, titles, durations, upload dates, and URLs. Sorted by playlist or channel order.',
+        inputSchema: fetchVideosSchema,
+        outputSchema: fetchVideosOutputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+        handler: fetchVideosHandler,
+    }),
+    defineTool({
+        name: 'get_video_info',
+        mode: 'all',
+        title: 'Get YouTube Video Info',
+        description: 'Get detailed metadata for a single YouTube video. Returns title, channel, duration, upload date, view count, like count, comment count, description, tags, and thumbnail URL.',
+        inputSchema: getVideoInfoSchema,
+        outputSchema: getVideoInfoOutputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+        handler: getVideoInfoHandler,
+    }),
+    defineTool({
+        name: 'get_chapters',
+        mode: 'all',
+        title: 'Get YouTube Video Chapters',
+        description: 'Extract chapter markers and timestamps from a YouTube video. Returns chapter titles with start and end times. Not all videos have chapters. Returns empty list if none found.',
+        inputSchema: getChaptersSchema,
+        outputSchema: getChaptersOutputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+        handler: getChaptersHandler,
+    }),
+    defineTool({
+        name: 'get_comments',
+        mode: 'all',
+        title: 'Get YouTube Video Comments',
+        description: "Read a sample of a video's comments, with replies when includeReplies is set. Returns a completeness receipt saying how many of the video's comments this is — the real total comes from a separate metadata read, because a comment fetch reports only what it extracted. This is a sample, not a page: YouTube exposes no cursor for a live comment read.",
+        inputSchema: getCommentsSchema,
+        outputSchema: getCommentsOutputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+        handler: getCommentsHandler,
+    }),
+    defineTool({
+        name: 'list_formats',
+        mode: 'all',
+        title: 'List YouTube Video Formats',
+        description: 'List all available download formats for a YouTube video. Returns format IDs, extensions, resolutions, FPS, codecs, and file sizes. Grouped by video+audio, video-only, and audio-only.',
+        inputSchema: listFormatsSchema,
+        outputSchema: listFormatsOutputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+        handler: listFormatsHandler,
+    }),
+];
+//# sourceMappingURL=video-tools.js.map

package/dist/registry/video-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-tools.js","sourceRoot":"","sources":["../../src/registry/video-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAuB,MAAM,YAAY,CAAC;AAC7D,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AAEnC,iHAAiH;AACjH,MAAM,CAAC,MAAM,UAAU,GAAqB;IAC1C,UAAU,CAAC;QACT,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,uBAAuB;QAC9B,WAAW,EACT,qJAAqJ;QACvJ,WAAW,EAAE,kBAAkB;QAC/B,YAAY,EAAE,wBAAwB;QACtC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,mBAAmB;KAC7B,CAAC;IACF,UAAU,CAAC;QACT,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,oJAAoJ;QACtJ,WAAW,EAAE,iBAAiB;QAC9B,YAAY,EAAE,uBAAuB;QACrC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,kBAAkB;KAC5B,CAAC;IACF,UAAU,CAAC;QACT,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,+KAA+K;QACjL,WAAW,EAAE,kBAAkB;QAC/B,YAAY,EAAE,wBAAwB;QACtC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,mBAAmB;KAC7B,CAAC;IACF,UAAU,CAAC;QACT,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,4BAA4B;QACnC,WAAW,EACT,+KAA+K;QACjL,WAAW,EAAE,iBAAiB;QAC9B,YAAY,EAAE,uBAAuB;QACrC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,kBAAkB;KAC5B,CAAC;IACF,UAAU,CAAC;QACT,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,4BAA4B;QACnC,WAAW,EACT,6VAA6V;QAC/V,WAAW,EAAE,iBAAiB;QAC9B,YAAY,EAAE,uBAAuB;QACrC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,kBAAkB;KAC5B,CAAC;IACF,UAAU,CAAC;QACT,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,4BAA4B;QACnC,WAAW,EACT,wLAAwL;QAC1L,WAAW,EAAE,iBAAiB;QAC9B,YAAY,EAAE,uBAAuB;QACrC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,kBAAkB;KAC5B,CAAC;CACH,CAAC"}

package/dist/resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQzE;;;;;;GAMG;AAEH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAgJjF"}
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUzE;;;;;;GAMG;AAEH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAkJjF"}

package/dist/resources.js

@@ -1,9 +1,11 @@
 import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { getLibraryItem, listLibrary } from './utils/storage.js';
 import { hasProfile, listManifests, readProfile, requireManifest } from './utils/brain-storage.js';
+import { registerThumbnailResource } from './thumbnail-resource.js';
 import { YouTubeError } from './utils/errors.js';
 import { getTranscript } from './utils/youtube.js';
 import { segmentsToTimestamped } from './utils/transcript.js';
+import { guardedResource } from './utils/guard.js';
 /**
  * Saved notes and cached transcripts, exposed as MCP resources.
  *
@@ -16,7 +18,7 @@ export function registerResources(server, mode) {
         title: 'Video transcript',
         description: 'Timestamped transcript for a YouTube video, fetched and cached on first read.',
         mimeType: 'text/plain',
-    }, async (uri, { videoId }) => {
+    }, guardedResource(async (uri, { videoId }) => {
         const id = Array.isArray(videoId) ? videoId[0] : videoId;
         const transcript = await getTranscript(id ?? '');
         return {
@@ -28,12 +30,12 @@ export function registerResources(server, mode) {
                 },
             ],
         };
-    });
+    }));
     if (mode !== 'stdio')
         return;
     server.registerResource('library-item', new ResourceTemplate('youtube://library/{videoId}/{contentType}', {
         // Enumerate what is actually saved, so a client can browse the library.
-        list: async () => {
+        list: guardedResource(async () => {
             const items = await listLibrary();
             return {
                 resources: items.flatMap((item) => [
@@ -57,25 +59,25 @@ export function registerResources(server, mode) {
                         : []),
                 ]),
             };
-        },
+        }),
     }), {
         title: 'Saved library note',
         description: 'A summary or skill note previously saved to the local knowledge library.',
         mimeType: 'text/markdown',
-    }, async (uri, { videoId, contentType }) => {
+    }, guardedResource(async (uri, { videoId, contentType }) => {
         const id = Array.isArray(videoId) ? videoId[0] : videoId;
         const type = Array.isArray(contentType) ? contentType[0] : contentType;
         const wanted = type === 'skill' ? 'skill' : 'summary';
         const item = await getLibraryItem(id ?? '', wanted);
         const text = (wanted === 'skill' ? item.skill : item.summary) ?? '';
         return { contents: [{ uri: uri.href, mimeType: 'text/markdown', text }] };
-    });
+    }));
     server.registerResource('brain', new ResourceTemplate('youtube://brain/{channelId}/{part}', {
         // Only what a client can usefully attach: the manifest describes the
         // whole brain, and the profile is the written account of it. The passages
         // are not offered as a resource — they are tens of megabytes and exist to
         // be searched, not read.
-        list: async () => {
+        list: guardedResource(async () => {
             const brains = await listManifests();
             return {
                 resources: brains.flatMap((brain) => [
@@ -95,12 +97,12 @@ export function registerResources(server, mode) {
                         : []),
                 ]),
             };
-        },
+        }),
     }), {
         title: 'Channel brain',
         description: "A channel brain's manifest — what it covers and what it measured — or the written profile saved beside it.",
         mimeType: 'application/json',
-    }, async (uri, { channelId, part }) => {
+    }, guardedResource(async (uri, { channelId, part }) => {
         const id = first(channelId);
         const wanted = first(part);
         // Returning the manifest for an unrecognised part would answer a question
@@ -129,7 +131,8 @@ export function registerResources(server, mode) {
                 },
             ],
         };
-    });
+    }));
+    registerThumbnailResource(server);
 }
 /** Template variables arrive as a string or, for a repeated segment, an array. */
 function first(value) {

package/dist/resources.js.map

@@ -1 +1 @@
-{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACnG,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE9D;;;;;;GAMG;AAEH,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,IAAsB;IACzE,MAAM,CAAC,gBAAgB,CACrB,YAAY,EACZ,IAAI,gBAAgB,CAAC,gCAAgC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAC3E;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE,+EAA+E;QAC5F,QAAQ,EAAE,YAAY;KACvB,EACD,KAAK,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACzB,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QACzD,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAEjD,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,QAAQ,EAAE,YAAY;oBACtB,IAAI,EAAE,qBAAqB,CAAC,UAAU,CAAC,QAAQ,CAAC;iBACjD;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO;IAE7B,MAAM,CAAC,gBAAgB,CACrB,cAAc,EACd,IAAI,gBAAgB,CAAC,2CAA2C,EAAE;QAChE,wEAAwE;QACxE,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,KAAK,GAAG,MAAM,WAAW,EAAE,CAAC;YAClC,OAAO;gBACL,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;oBACjC,GAAG,CAAC,IAAI,CAAC,UAAU;wBACjB,CAAC,CAAC;4BACE;gCACE,GAAG,EAAE,qBAAqB,IAAI,CAAC,OAAO,UAAU;gCAChD,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,YAAY;gCAC/B,QAAQ,EAAE,eAAe;6BAC1B;yBACF;wBACH,CAAC,CAAC,EAAE,CAAC;oBACP,GAAG,CAAC,IAAI,CAAC,QAAQ;wBACf,CAAC,CAAC;4BACE;gCACE,GAAG,EAAE,qBAAqB,IAAI,CAAC,OAAO,QAAQ;gCAC9C,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,UAAU;gCAC7B,QAAQ,EAAE,eAAe;6BAC1B;yBACF;wBACH,CAAC,CAAC,EAAE,CAAC;iBACR,CAAC;aACH,CAAC;QACJ,CAAC;KACF,CAAC,EACF;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,0EAA0E;QACvF,QAAQ,EAAE,eAAe;KAC1B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE;QACtC,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QACzD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;QACvE,MAAM,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QAEtD,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,EAAE,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;QACpD,MAAM,IAAI,GAAG,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAEpE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAC5E,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,gBAAgB,CACrB,OAAO,EACP,IAAI,gBAAgB,CAAC,oCAAoC,EAAE;QACzD,qEAAqE;QACrE,0EAA0E;QAC1E,0EAA0E;QAC1E,yBAAyB;QACzB,IAAI,EAAE,KAAK,IAAI,EAAE;YACf,MAAM,MAAM,GAAG,MAAM,aAAa,EAAE,CAAC;YACrC,OAAO;gBACL,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC;oBACnC;wBACE,GAAG,EAAE,mBAAmB,KAAK,CAAC,OAAO,CAAC,SAAS,WAAW;wBAC1D,IAAI,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,UAAU;wBACrC,QAAQ,EAAE,kBAAkB;qBAC7B;oBACD,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;wBACrC,CAAC,CAAC;4BACE;gCACE,GAAG,EAAE,mBAAmB,KAAK,CAAC,OAAO,CAAC,SAAS,UAAU;gCACzD,IAAI,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,YAAY;gCACvC,QAAQ,EAAE,eAAe;6BAC1B;yBACF;wBACH,CAAC,CAAC,EAAE,CAAC;iBACR,CAAC;aACH,CAAC;QACJ,CAAC;KACF,CAAC,EACF;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,4GAA4G;QAC9G,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE;QACjC,MAAM,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;QAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;QAE3B,0EAA0E;QAC1E,sDAAsD;QACtD,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAClD,MAAM,IAAI,YAAY,CAAC,eAAe,EAAE,IAAI,MAAM,2BAA2B,EAAE;gBAC7E,QAAQ,EAAE,wBAAwB,EAAE,gCAAgC,EAAE,WAAW;aAClF,CAAC,CAAC;QACL,CAAC;QAED,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,EAAE,CAAC,CAAC;YACtC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,MAAM,IAAI,YAAY,CAAC,WAAW,EAAE,iCAAiC,EAAE,GAAG,EAAE;oBAC1E,QAAQ,EACN,+EAA+E;iBAClF,CAAC,CAAC;YACL,CAAC;YACD,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QACrF,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,EAAE,CAAC,CAAC;QAC3C,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;iBACxC;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC;AAED,kFAAkF;AAClF,SAAS,KAAK,CAAC,KAAoC;IACjD,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;AACzD,CAAC"}
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"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"}

package/dist/schemas.d.ts

@@ -24,6 +24,22 @@ export declare const paginationShape: {
     hasMore: z.ZodBoolean;
     nextOffset: z.ZodOptional<z.ZodNumber>;
 };
+/**
+ * Pagination for a source that may not know its own size.
+ *
+ * `paginationShape` requires a total, which is right for a local collection
+ * and a lie for a live YouTube listing: `playlist_count` is populated for
+ * playlists and routinely absent for channel tabs. An absent `total` here
+ * means "unknown", never zero and never "this is all of them".
+ */
+export declare const cursorPageShape: {
+    count: z.ZodNumber;
+    hasMore: z.ZodBoolean;
+    nextCursor: z.ZodOptional<z.ZodString>;
+    total: z.ZodOptional<z.ZodNumber>;
+    totalSource: z.ZodOptional<z.ZodEnum<["youtube:playlist_count", "local-store", "source-exhausted"]>>;
+    driftDetected: z.ZodBoolean;
+};
 export declare const videoSummarySchema: z.ZodObject<{
     id: z.ZodString;
     title: z.ZodString;
@@ -33,6 +49,7 @@ export declare const videoSummarySchema: z.ZodObject<{
     channel: z.ZodOptional<z.ZodString>;
     viewCount: z.ZodOptional<z.ZodNumber>;
     uploadDate: z.ZodOptional<z.ZodString>;
+    thumbnailUrl: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     id: string;
     title: string;
@@ -42,6 +59,7 @@ export declare const videoSummarySchema: z.ZodObject<{
     channel?: string | undefined;
     viewCount?: number | undefined;
     uploadDate?: string | undefined;
+    thumbnailUrl?: string | undefined;
 }, {
     id: string;
     title: string;
@@ -51,6 +69,7 @@ export declare const videoSummarySchema: z.ZodObject<{
     channel?: string | undefined;
     viewCount?: number | undefined;
     uploadDate?: string | undefined;
+    thumbnailUrl?: string | undefined;
 }>;
 export declare const videoInfoSchema: z.ZodObject<{
     id: z.ZodString;
@@ -75,9 +94,9 @@ export declare const videoInfoSchema: z.ZodObject<{
     channel: string;
     viewCount: number;
     uploadDate: string;
+    thumbnailUrl: string;
     description: string;
     tags: string[];
-    thumbnailUrl: string;
     likeCount: number;
     commentCount: number;
 }, {
@@ -89,9 +108,9 @@ export declare const videoInfoSchema: z.ZodObject<{
     channel: string;
     viewCount: number;
     uploadDate: string;
+    thumbnailUrl: string;
     description: string;
     tags: string[];
-    thumbnailUrl: string;
     likeCount: number;
     commentCount: number;
 }>;
@@ -133,6 +152,229 @@ export declare const commentSchema: z.ZodObject<{
     text: string;
     isPinned: boolean;
 }>;
+/** A comment with everything yt-dlp actually returns, including its place in a thread. */
+export declare const commentDetailSchema: 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;
+}>;
+export declare const commentThreadSchema: 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;
+}>;
 export declare const channelInfoSchema: z.ZodObject<{
     name: z.ZodString;
     channelId: z.ZodString;
@@ -140,6 +382,8 @@ export declare const channelInfoSchema: z.ZodObject<{
     subscriberCount: z.ZodNumber;
     channelUrl: z.ZodString;
     description: z.ZodString;
+    avatarUrl: z.ZodOptional<z.ZodString>;
+    bannerUrl: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     description: string;
     name: string;
@@ -147,6 +391,8 @@ export declare const channelInfoSchema: z.ZodObject<{
     handle: string;
     subscriberCount: number;
     channelUrl: string;
+    avatarUrl?: string | undefined;
+    bannerUrl?: string | undefined;
 }, {
     description: string;
     name: string;
@@ -154,6 +400,8 @@ export declare const channelInfoSchema: z.ZodObject<{
     handle: string;
     subscriberCount: number;
     channelUrl: string;
+    avatarUrl?: string | undefined;
+    bannerUrl?: string | undefined;
 }>;
 export declare const playlistInfoSchema: z.ZodObject<{
     id: z.ZodString;

package/dist/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;GASG;AAEH;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,UAAU,EAAE,OAAO,CAAC,GAC1C,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CASrE;AAED,eAAO,MAAM,eAAe;;;;;;CAM3B,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS7B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAc1B,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;EAOxB,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;EAKxB,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;EAO5B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU7B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU5B,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;EAIlC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;EAKhC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUhC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;EAMjC,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;EAO3B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;EAK7B,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;GASG;AAEH;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,UAAU,EAAE,OAAO,CAAC,GAC1C,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CASrE;AAED,eAAO,MAAM,eAAe;;;;;;CAM3B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe;;;;;;;CAyB3B,CAAC;AAEF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU7B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAc1B,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;EAOxB,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;EAKxB,CAAC;AAEH,0FAA0F;AAC1F,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgB9B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAO9B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW5B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU7B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU5B,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;EAIlC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;EAKhC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUhC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;EAMjC,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;EAO3B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;EAK7B,CAAC"}

package/dist/schemas.js

@@ -34,6 +34,36 @@ export const paginationShape = {
     hasMore: z.boolean().describe('Whether more items exist beyond this page'),
     nextOffset: z.number().int().optional().describe('Offset to pass to retrieve the next page'),
 };
+/**
+ * Pagination for a source that may not know its own size.
+ *
+ * `paginationShape` requires a total, which is right for a local collection
+ * and a lie for a live YouTube listing: `playlist_count` is populated for
+ * playlists and routinely absent for channel tabs. An absent `total` here
+ * means "unknown", never zero and never "this is all of them".
+ */
+export const cursorPageShape = {
+    count: z.number().int().describe('Items in this response'),
+    hasMore: z.boolean().describe('Whether more items exist beyond this page'),
+    nextCursor: z
+        .string()
+        .optional()
+        .describe('Opaque; pass back as `cursor`. Absent if and only if hasMore is false.'),
+    total: z
+        .number()
+        .int()
+        .optional()
+        .describe('Total available — ONLY when the source states one. ABSENT MEANS UNKNOWN. Never treat ' +
+        'count as the total, and never read an absent total as zero or as "this is everything".'),
+    totalSource: z
+        .enum(['youtube:playlist_count', 'local-store', 'source-exhausted'])
+        .optional()
+        .describe('Where total came from. Absent if and only if total is absent.'),
+    driftDetected: z
+        .boolean()
+        .describe('True when the listing changed between pages — a new upload shifts every index. The page ' +
+        'is still returned; the duplicate at the seam has been dropped.'),
+};
 export const videoSummarySchema = z.object({
     id: z.string(),
     title: z.string(),
@@ -43,6 +73,7 @@ export const videoSummarySchema = z.object({
     channel: z.string().optional(),
     viewCount: z.number().optional(),
     uploadDate: z.string().optional(),
+    thumbnailUrl: z.string().optional().describe('The largest thumbnail the listing offered'),
 });
 export const videoInfoSchema = z.object({
     id: z.string(),
@@ -73,6 +104,32 @@ export const commentSchema = z.object({
     likeCount: z.number(),
     isPinned: z.boolean(),
 });
+/** A comment with everything yt-dlp actually returns, including its place in a thread. */
+export const commentDetailSchema = z.object({
+    id: z.string(),
+    parentId: z.string().nullable().describe('null for a top-level comment'),
+    author: z.string(),
+    authorId: z.string().optional(),
+    authorUrl: z.string().optional(),
+    authorThumbnailUrl: z.string().optional(),
+    authorIsUploader: z.boolean(),
+    authorIsVerified: z.boolean(),
+    text: z.string(),
+    likeCount: z.number(),
+    isPinned: z.boolean(),
+    isFavorited: z.boolean(),
+    timestamp: z.number().optional(),
+    publishedAt: z.string().optional(),
+    timeText: z.string().optional().describe("yt-dlp's relative wording, e.g. '3 months ago'"),
+});
+export const commentThreadSchema = z.object({
+    comment: commentDetailSchema,
+    replies: z.array(commentDetailSchema),
+    replyCount: z
+        .number()
+        .int()
+        .describe('Replies present in THIS extraction, not the number the thread has'),
+});
 export const channelInfoSchema = z.object({
     name: z.string(),
     channelId: z.string(),
@@ -80,6 +137,10 @@ export const channelInfoSchema = z.object({
     subscriberCount: z.number(),
     channelUrl: z.string(),
     description: z.string(),
+    // Optional because this shape is embedded in every brain manifest on disk,
+    // written before the images were read.
+    avatarUrl: z.string().optional().describe("The channel's uncropped avatar image"),
+    bannerUrl: z.string().optional().describe("The channel's uncropped banner image"),
 });
 export const playlistInfoSchema = z.object({
     id: z.string(),