youtube-knowledge-mcp 2.0.2 → 2.2.0

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

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

package/dist/registry/media-tools.d.ts

@@ -0,0 +1,4 @@
+import { type ToolDefinition } from './types.js';
+/** Clips, stills, subtitles and downloads. Local only: these write files. */
+export declare const mediaTools: ToolDefinition[];
+//# sourceMappingURL=media-tools.d.ts.map

package/dist/registry/media-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-tools.d.ts","sourceRoot":"","sources":["../../src/registry/media-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AA0B7D,6EAA6E;AAC7E,eAAO,MAAM,UAAU,EAAE,cAAc,EAmGtC,CAAC"}

package/dist/registry/media-tools.js

@@ -0,0 +1,100 @@
+import { defineTool } from './types.js';
+import { extractClipSchema, extractClipOutputSchema, extractClipHandler, extractAudioClipSchema, extractAudioClipOutputSchema, extractAudioClipHandler, extractClipsSchema, extractClipsOutputSchema, extractClipsHandler, } from '../tools/clips.js';
+import { downloadVideoSchema, downloadVideoOutputSchema, downloadVideoHandler, } from '../tools/download-video.js';
+import { extractFrameSchema, extractFrameOutputSchema, extractFrameHandler, exportSubtitlesSchema, exportSubtitlesOutputSchema, exportSubtitlesHandler, } from '../tools/frames-subtitles.js';
+/** Clips, stills, subtitles and downloads. Local only: these write files. */
+export const mediaTools = [
+    defineTool({
+        name: 'extract_clip',
+        mode: 'stdio',
+        title: 'Extract a Video Clip',
+        description: 'Cut a time range out of a YouTube video without downloading the whole thing. Give start and end, or a chapter name. Pair with search_transcript to find the moment first. Requires ffmpeg.',
+        inputSchema: extractClipSchema,
+        outputSchema: extractClipOutputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+        handler: extractClipHandler,
+    }),
+    defineTool({
+        name: 'extract_audio_clip',
+        mode: 'stdio',
+        title: 'Extract an Audio Clip',
+        description: 'Cut a time range out of a video as audio only, in an editor-friendly format (mp3, m4a, wav, flac, opus). Use for podcast pulls and voice-over sourcing. Requires ffmpeg.',
+        inputSchema: extractAudioClipSchema,
+        outputSchema: extractAudioClipOutputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+        handler: extractAudioClipHandler,
+    }),
+    defineTool({
+        name: 'extract_clips',
+        mode: 'stdio',
+        title: 'Extract Several Clips',
+        description: 'Cut several time ranges out of one video in a single call. A range that fails is reported individually rather than losing the clips that succeeded. Requires ffmpeg.',
+        inputSchema: extractClipsSchema,
+        outputSchema: extractClipsOutputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+        handler: extractClipsHandler,
+    }),
+    defineTool({
+        name: 'extract_frame',
+        mode: 'stdio',
+        title: 'Capture a Frame',
+        description: 'Capture a single still image from a video at a given timestamp, without downloading the file. Use for thumbnails and reference frames. Requires ffmpeg.',
+        inputSchema: extractFrameSchema,
+        outputSchema: extractFrameOutputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+        handler: extractFrameHandler,
+    }),
+    defineTool({
+        name: 'export_subtitles',
+        mode: 'stdio',
+        title: 'Export Subtitles',
+        description: 'Write a video transcript to disk as SRT, WebVTT or plain text, ready to import into a video editor such as Premiere, Resolve or CapCut.',
+        inputSchema: exportSubtitlesSchema,
+        outputSchema: exportSubtitlesOutputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+        handler: exportSubtitlesHandler,
+    }),
+    defineTool({
+        name: 'download_video',
+        mode: 'stdio',
+        title: 'Download YouTube Video',
+        description: 'Download a YouTube video to local disk. Use the quality parameter for automatic format selection with smart fallbacks, or formatId for a specific format from list_formats. Returns the downloaded file path, title, and format details.',
+        inputSchema: downloadVideoSchema,
+        outputSchema: downloadVideoOutputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            // Writes to a deterministic path and overwrites, exactly like the
+            // extract_* tools; repeating the call leaves the same state.
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+        handler: downloadVideoHandler,
+    }),
+];
+//# sourceMappingURL=media-tools.js.map

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

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

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

@@ -0,0 +1,7 @@
+import { type ToolDefinition } from './types.js';
+/**
+ * Thumbnails. Looking at one is remote-safe; saving a channel's worth is local
+ * only, for the same reason as the brains.
+ */
+export declare const thumbnailTools: ToolDefinition[];
+//# sourceMappingURL=thumbnail-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"thumbnail-tools.d.ts","sourceRoot":"","sources":["../../src/registry/thumbnail-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAoB7D;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,cAAc,EAkE1C,CAAC"}

package/dist/registry/thumbnail-tools.js

@@ -0,0 +1,72 @@
+import { defineTool } from './types.js';
+import { fetchChannelThumbnailsSchema, fetchChannelThumbnailsOutputSchema, fetchChannelThumbnailsHandler, } from '../tools/fetch-channel-thumbnails.js';
+import { listChannelThumbnailsSchema, listChannelThumbnailsOutputSchema, listChannelThumbnailsHandler, deleteChannelThumbnailsSchema, deleteChannelThumbnailsOutputSchema, deleteChannelThumbnailsHandler, } from '../tools/list-channel-thumbnails.js';
+import { getThumbnailSchema, getThumbnailOutputSchema, getThumbnailHandler, } from '../tools/get-thumbnail.js';
+/**
+ * Thumbnails. Looking at one is remote-safe; saving a channel's worth is local
+ * only, for the same reason as the brains.
+ */
+export const thumbnailTools = [
+    defineTool({
+        name: 'get_thumbnail',
+        mode: 'all',
+        title: 'Look at a Thumbnail',
+        description: "Return a video's thumbnail, or a channel's avatar or banner, as an image you can look at, with its real pixel size. Tries the largest image YouTube serves and falls back to smaller ones. Locally, an image saved by fetch_channel_thumbnails is served from disk.",
+        inputSchema: getThumbnailSchema,
+        outputSchema: getThumbnailOutputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+        handler: (args) => getThumbnailHandler(args, { store: false }),
+        stdioHandler: (args) => getThumbnailHandler(args, { store: true }),
+    }),
+    defineTool({
+        name: 'fetch_channel_thumbnails',
+        mode: 'stdio',
+        title: "Save a Channel's Thumbnails",
+        description: "Save every video thumbnail of a channel, plus its avatar and banner, under ~/.youtube-knowledge/thumbnails. One listing per tab, then the images from YouTube's image hosts directly, largest available first; each saved image is recorded with the size actually decoded from it. Safe to interrupt and call again: images already on disk are kept, missing ones fetched. Choose tabs to include shorts and streams.",
+        inputSchema: fetchChannelThumbnailsSchema,
+        outputSchema: fetchChannelThumbnailsOutputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+        handler: fetchChannelThumbnailsHandler,
+    }),
+    defineTool({
+        name: 'list_channel_thumbnails',
+        mode: 'stdio',
+        title: "List a Channel's Saved Thumbnails",
+        description: 'List the thumbnails saved for a channel: each file path, its decoded size and which image variant it is, plus the avatar and banner. Works offline from the saved manifest.',
+        inputSchema: listChannelThumbnailsSchema,
+        outputSchema: listChannelThumbnailsOutputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        handler: listChannelThumbnailsHandler,
+    }),
+    defineTool({
+        name: 'delete_channel_thumbnails',
+        mode: 'stdio',
+        title: "Delete a Channel's Saved Thumbnails",
+        description: 'Permanently delete every thumbnail saved for a channel, with its manifest. Use this to start over, for example to fetch again at a different quality.',
+        inputSchema: deleteChannelThumbnailsSchema,
+        outputSchema: deleteChannelThumbnailsOutputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        handler: deleteChannelThumbnailsHandler,
+    }),
+];
+//# sourceMappingURL=thumbnail-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"thumbnail-tools.js","sourceRoot":"","sources":["../../src/registry/thumbnail-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAuB,MAAM,YAAY,CAAC;AAC7D,OAAO,EACL,4BAA4B,EAC5B,kCAAkC,EAClC,6BAA6B,GAC9B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,2BAA2B,EAC3B,iCAAiC,EACjC,4BAA4B,EAC5B,6BAA6B,EAC7B,mCAAmC,EACnC,8BAA8B,GAC/B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AAEnC;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAqB;IAC9C,UAAU,CAAC;QACT,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,qQAAqQ;QACvQ,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,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC9D,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;KACnE,CAAC;IACF,UAAU,CAAC;QACT,IAAI,EAAE,0BAA0B;QAChC,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,6BAA6B;QACpC,WAAW,EACT,yZAAyZ;QAC3Z,WAAW,EAAE,4BAA4B;QACzC,YAAY,EAAE,kCAAkC;QAChD,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,6BAA6B;KACvC,CAAC;IACF,UAAU,CAAC;QACT,IAAI,EAAE,yBAAyB;QAC/B,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,mCAAmC;QAC1C,WAAW,EACT,6KAA6K;QAC/K,WAAW,EAAE,2BAA2B;QACxC,YAAY,EAAE,iCAAiC;QAC/C,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;QACD,OAAO,EAAE,4BAA4B;KACtC,CAAC;IACF,UAAU,CAAC;QACT,IAAI,EAAE,2BAA2B;QACjC,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,qCAAqC;QAC5C,WAAW,EACT,uJAAuJ;QACzJ,WAAW,EAAE,6BAA6B;QAC1C,YAAY,EAAE,mCAAmC;QACjD,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACrB;QACD,OAAO,EAAE,8BAA8B;KACxC,CAAC;CACH,CAAC"}

package/dist/registry/transcript-tools.d.ts

@@ -0,0 +1,4 @@
+import { type ToolDefinition } from './types.js';
+/** Reading and searching transcripts, singly and in batches. Remote-safe. */
+export declare const transcriptTools: ToolDefinition[];
+//# sourceMappingURL=transcript-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-tools.d.ts","sourceRoot":"","sources":["../../src/registry/transcript-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAoB7D,6EAA6E;AAC7E,eAAO,MAAM,eAAe,EAAE,cAAc,EAiE3C,CAAC"}

package/dist/registry/transcript-tools.js

@@ -0,0 +1,68 @@
+import { defineTool } from './types.js';
+import { getTranscriptsSchema, getTranscriptsOutputSchema, getTranscriptsHandler, digestPlaylistSchema, digestPlaylistOutputSchema, digestPlaylistHandler, } from '../tools/batch.js';
+import { getTranscriptSchema, getTranscriptOutputSchema, getTranscriptHandler, } from '../tools/get-transcript.js';
+import { searchTranscriptSchema, searchTranscriptOutputSchema, searchTranscriptHandler, } from '../tools/search-transcript.js';
+/** Reading and searching transcripts, singly and in batches. Remote-safe. */
+export const transcriptTools = [
+    defineTool({
+        name: 'get_transcript',
+        mode: 'all',
+        title: 'Get YouTube Video Transcript',
+        description: 'Extract the full transcript from a YouTube video. Supports auto-generated and manual captions. Returns plain text with word count and detected language. Results are cached locally.',
+        inputSchema: getTranscriptSchema,
+        outputSchema: getTranscriptOutputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+        handler: getTranscriptHandler,
+    }),
+    defineTool({
+        name: 'search_transcript',
+        mode: 'all',
+        title: 'Search Inside a Transcript',
+        description: 'Find a phrase or pattern inside a video transcript and return each match with its timestamp and a link that opens the video at that moment. Use this instead of reading a whole transcript when you need to locate or cite a specific moment.',
+        inputSchema: searchTranscriptSchema,
+        outputSchema: searchTranscriptOutputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+        handler: searchTranscriptHandler,
+    }),
+    defineTool({
+        name: 'get_transcripts',
+        mode: 'all',
+        title: 'Get Transcripts for Several Videos',
+        description: 'Fetch transcripts for up to 25 videos in one call, each capped so the batch cannot flood the context. Videos that have no captions are reported individually rather than failing the whole call.',
+        inputSchema: getTranscriptsSchema,
+        outputSchema: getTranscriptsOutputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+        handler: getTranscriptsHandler,
+    }),
+    defineTool({
+        name: 'digest_playlist',
+        mode: 'all',
+        title: 'Digest a Playlist or Channel',
+        description: 'Summarize a playlist or channel in one call: per-video metadata, chapter markers, and optionally transcript word counts. Use this to survey a body of content before deciding what to read in full.',
+        inputSchema: digestPlaylistSchema,
+        outputSchema: digestPlaylistOutputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+        handler: digestPlaylistHandler,
+    }),
+];
+//# sourceMappingURL=transcript-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transcript-tools.js","sourceRoot":"","sources":["../../src/registry/transcript-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAuB,MAAM,YAAY,CAAC;AAC7D,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,+BAA+B,CAAC;AAEvC,6EAA6E;AAC7E,MAAM,CAAC,MAAM,eAAe,GAAqB;IAC/C,UAAU,CAAC;QACT,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,8BAA8B;QACrC,WAAW,EACT,sLAAsL;QACxL,WAAW,EAAE,mBAAmB;QAChC,YAAY,EAAE,yBAAyB;QACvC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,oBAAoB;KAC9B,CAAC;IACF,UAAU,CAAC;QACT,IAAI,EAAE,mBAAmB;QACzB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,4BAA4B;QACnC,WAAW,EACT,+OAA+O;QACjP,WAAW,EAAE,sBAAsB;QACnC,YAAY,EAAE,4BAA4B;QAC1C,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,uBAAuB;KACjC,CAAC;IACF,UAAU,CAAC;QACT,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,oCAAoC;QAC3C,WAAW,EACT,kMAAkM;QACpM,WAAW,EAAE,oBAAoB;QACjC,YAAY,EAAE,0BAA0B;QACxC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,qBAAqB;KAC/B,CAAC;IACF,UAAU,CAAC;QACT,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,8BAA8B;QACrC,WAAW,EACT,qMAAqM;QACvM,WAAW,EAAE,oBAAoB;QACjC,YAAY,EAAE,0BAA0B;QACxC,WAAW,EAAE;YACX,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,IAAI;SACpB;QACD,OAAO,EAAE,qBAAqB;KAC/B,CAAC;CACH,CAAC"}

package/dist/registry/types.d.ts

@@ -0,0 +1,41 @@
+import type { ZodRawShape } from 'zod';
+import type { McpServer, ToolCallback } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * A tool as one declarative record.
+ *
+ * `createServer` used to be twenty-seven near-identical `registerTool` calls
+ * spread over seven hundred lines, and the only thing that varied between them
+ * was data. Declaring each tool as data keeps the registration in one loop,
+ * lets a test enumerate every tool without booting a server, and makes the
+ * transport gate — local-only tools never registered over HTTP — a field
+ * rather than an `if` block a new tool can land on the wrong side of.
+ */
+export type ToolMode = 'all' | 'stdio';
+export interface ToolDefinition {
+    name: string;
+    mode: ToolMode;
+    register: (server: McpServer, transport: 'stdio' | 'http') => void;
+}
+export interface ToolSpec<In extends ZodRawShape, Out extends ZodRawShape> {
+    name: string;
+    mode: ToolMode;
+    title: string;
+    description: string;
+    inputSchema: In;
+    outputSchema: Out;
+    /** Every hint is required: a client decides what to ask before running on them. */
+    annotations: Required<Pick<ToolAnnotations, 'readOnlyHint' | 'destructiveHint' | 'idempotentHint' | 'openWorldHint'>>;
+    handler: ToolCallback<In>;
+    /**
+     * A handler to use on stdio instead of `handler`, for the rare tool whose
+     * remote and local behaviour differ (a local one may read the user's disk).
+     */
+    stdioHandler?: ToolCallback<In>;
+}
+/**
+ * Capture the schema/handler pairing generically, then hand back a record the
+ * registry can hold in one array without any of them needing a cast.
+ */
+export declare function defineTool<In extends ZodRawShape, Out extends ZodRawShape>(spec: ToolSpec<In, Out>): ToolDefinition;
+//# sourceMappingURL=types.d.ts.map

package/dist/registry/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/registry/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAG1E;;;;;;;;;GASG;AAEH,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAC;AAEvC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,KAAK,IAAI,CAAC;CACpE;AAED,MAAM,WAAW,QAAQ,CAAC,EAAE,SAAS,WAAW,EAAE,GAAG,SAAS,WAAW;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,EAAE,CAAC;IAChB,YAAY,EAAE,GAAG,CAAC;IAClB,mFAAmF;IACnF,WAAW,EAAE,QAAQ,CACnB,IAAI,CAAC,eAAe,EAAE,cAAc,GAAG,iBAAiB,GAAG,gBAAgB,GAAG,eAAe,CAAC,CAC/F,CAAC;IACF,OAAO,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC;IAC1B;;;OAGG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EAAE,SAAS,WAAW,EAAE,GAAG,SAAS,WAAW,EACxE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,GACtB,cAAc,CAchB"}

package/dist/registry/types.js

@@ -0,0 +1,17 @@
+import { guarded } from '../utils/guard.js';
+/**
+ * Capture the schema/handler pairing generically, then hand back a record the
+ * registry can hold in one array without any of them needing a cast.
+ */
+export function defineTool(spec) {
+    const { name, mode, title, description, inputSchema, outputSchema, annotations } = spec;
+    return {
+        name,
+        mode,
+        register: (server, transport) => {
+            const handler = transport === 'stdio' ? (spec.stdioHandler ?? spec.handler) : spec.handler;
+            server.registerTool(name, { title, description, inputSchema, outputSchema, annotations }, guarded(handler));
+        },
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/registry/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/registry/types.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAwC5C;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,IAAuB;IAEvB,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IACxF,OAAO;QACL,IAAI;QACJ,IAAI;QACJ,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE;YAC9B,MAAM,OAAO,GAAG,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;YAC3F,MAAM,CAAC,YAAY,CACjB,IAAI,EACJ,EAAE,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,EAC9D,OAAO,CAAC,OAAO,CAAC,CACjB,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/registry/video-tools.d.ts

@@ -0,0 +1,4 @@
+import { type ToolDefinition } from './types.js';
+/** Finding videos and reading what YouTube knows about one. Remote-safe: nothing here touches the filesystem. */
+export declare const videoTools: ToolDefinition[];
+//# sourceMappingURL=video-tools.d.ts.map

package/dist/registry/video-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-tools.d.ts","sourceRoot":"","sources":["../../src/registry/video-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAgC7D,iHAAiH;AACjH,eAAO,MAAM,UAAU,EAAE,cAAc,EAiGtC,CAAC"}

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: 'Get top comments from a YouTube video sorted by popularity. Returns author, text, like count, and pinned status. Only top-level comments, no replies.',
+        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,uJAAuJ;QACzJ,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;AAMzE;;;;;;GAMG;AAEH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAyEjF"}
+{"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,7 +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.
  *
@@ -14,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 {
@@ -26,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) => [
@@ -55,18 +59,83 @@ 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: guardedResource(async () => {
+            const brains = await listManifests();
+            return {
+                resources: brains.flatMap((brain) => [
+                    {
+                        uri: `youtube://brain/${brain.channel.channelId}/manifest`,
+                        name: `${brain.channel.name} (brain)`,
+                        mimeType: 'application/json',
+                    },
+                    ...(hasProfile(brain.channel.channelId)
+                        ? [
+                            {
+                                uri: `youtube://brain/${brain.channel.channelId}/profile`,
+                                name: `${brain.channel.name} (profile)`,
+                                mimeType: 'text/markdown',
+                            },
+                        ]
+                        : []),
+                ]),
+            };
+        }),
+    }), {
+        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',
+    }, guardedResource(async (uri, { channelId, part }) => {
+        const id = first(channelId);
+        const wanted = first(part);
+        // Returning the manifest for an unrecognised part would answer a question
+        // nobody asked, and look like the URI was understood.
+        if (wanted !== 'manifest' && wanted !== 'profile') {
+            throw new YouTubeError('INVALID_INPUT', `"${wanted}" is not part of a brain.`, {
+                nextStep: `Read youtube://brain/${id}/manifest or youtube://brain/${id}/profile.`,
+            });
+        }
+        if (wanted === 'profile') {
+            const profile = await readProfile(id);
+            if (profile === undefined) {
+                throw new YouTubeError('NOT_FOUND', `No profile has been saved for ${id}.`, {
+                    nextStep: 'Call save_brain_profile to write one, after reading the brain with ask_brain.',
+                });
+            }
+            return { contents: [{ uri: uri.href, mimeType: 'text/markdown', text: profile }] };
+        }
+        const manifest = await requireManifest(id);
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: 'application/json',
+                    text: JSON.stringify(manifest, null, 2),
+                },
+            ],
+        };
+    }));
+    registerThumbnailResource(server);
+}
+/** Template variables arrive as a string or, for a repeated segment, an array. */
+function first(value) {
+    return (Array.isArray(value) ? value[0] : value) ?? '';
 }
 //# sourceMappingURL=resources.js.map

package/dist/resources.js.map

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