youtube-knowledge-mcp 2.1.0 → 3.0.0

package/dist/registry/health-tools.js

@@ -0,0 +1,39 @@
+import { defineTool } from './types.js';
+import { checkHealthSchema, checkHealthOutputSchema, checkHealthHandler, } from '../tools/check-health.js';
+import { repairStoreSchema, repairStoreOutputSchema, repairStoreHandler, } from '../tools/repair-store.js';
+/** Diagnostics. Remote-safe. */
+export const healthTools = [
+    defineTool({
+        name: 'check_health',
+        mode: 'all',
+        title: 'Check Server Health',
+        description: 'Report whether yt-dlp and ffmpeg are installed, their versions, and whether yt-dlp is stale. Call this first when tools start failing unexpectedly — an outdated yt-dlp is the most common cause.',
+        inputSchema: checkHealthSchema,
+        outputSchema: checkHealthOutputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        handler: checkHealthHandler,
+    }),
+    defineTool({
+        name: 'repair_store',
+        // Local-only: it renames a file in the user's data directory, and every
+        // tool that writes to disk is stdio-only.
+        mode: 'stdio',
+        title: 'Repair Harvested Store',
+        description: 'Check the harvested store and, if it is damaged, move it aside and start a fresh one. The damaged file is kept, never deleted. Call this when a harvest tool reports STORE_CORRUPT.',
+        inputSchema: repairStoreSchema,
+        outputSchema: repairStoreOutputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+        handler: repairStoreHandler,
+    }),
+];
+//# sourceMappingURL=health-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health-tools.js","sourceRoot":"","sources":["../../src/registry/health-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAuB,MAAM,YAAY,CAAC;AAC7D,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAElC,gCAAgC;AAChC,MAAM,CAAC,MAAM,WAAW,GAAqB;IAC3C,UAAU,CAAC;QACT,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,mMAAmM;QACrM,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,KAAK;SACrB;QACD,OAAO,EAAE,kBAAkB;KAC5B,CAAC;IACF,UAAU,CAAC;QACT,IAAI,EAAE,cAAc;QACpB,wEAAwE;QACxE,0CAA0C;QAC1C,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,qLAAqL;QACvL,WAAW,EAAE,iBAAiB;QAC9B,YAAY,EAAE,uBAAuB;QACrC,WAAW,EAAE;YACX,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,IAAI;YACrB,cAAc,EAAE,KAAK;YACrB,aAAa,EAAE,KAAK;SACrB;QACD,OAAO,EAAE,kBAAkB;KAC5B,CAAC;CACH,CAAC"}

package/dist/registry/index.d.ts

@@ -0,0 +1,8 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ToolDefinition } from './types.js';
+export type { ToolDefinition, ToolMode } from './types.js';
+/** Every tool the server can offer, in the order clients see them. */
+export declare const TOOLS: ToolDefinition[];
+/** Registers the tools the transport may carry: everything on stdio, remote-safe ones over HTTP. */
+export declare function registerTools(server: McpServer, mode: 'stdio' | 'http'): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3D,sEAAsE;AACtE,eAAO,MAAM,KAAK,EAAE,cAAc,EAUjC,CAAC;AAEF,oGAAoG;AACpG,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAI7E"}

package/dist/registry/index.js

@@ -0,0 +1,29 @@
+import { harvestTools } from './harvest-tools.js';
+import { brainTools } from './brain-tools.js';
+import { channelTools } from './channel-tools.js';
+import { healthTools } from './health-tools.js';
+import { libraryTools } from './library-tools.js';
+import { mediaTools } from './media-tools.js';
+import { thumbnailTools } from './thumbnail-tools.js';
+import { transcriptTools } from './transcript-tools.js';
+import { videoTools } from './video-tools.js';
+/** Every tool the server can offer, in the order clients see them. */
+export const TOOLS = [
+    ...videoTools,
+    ...channelTools,
+    ...transcriptTools,
+    ...healthTools,
+    ...libraryTools,
+    ...mediaTools,
+    ...brainTools,
+    ...harvestTools,
+    ...thumbnailTools,
+];
+/** Registers the tools the transport may carry: everything on stdio, remote-safe ones over HTTP. */
+export function registerTools(server, mode) {
+    for (const tool of TOOLS) {
+        if (tool.mode === 'all' || mode === 'stdio')
+            tool.register(server, mode);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAK9C,sEAAsE;AACtE,MAAM,CAAC,MAAM,KAAK,GAAqB;IACrC,GAAG,UAAU;IACb,GAAG,YAAY;IACf,GAAG,eAAe;IAClB,GAAG,WAAW;IACd,GAAG,YAAY;IACf,GAAG,UAAU;IACb,GAAG,UAAU;IACb,GAAG,YAAY;IACf,GAAG,cAAc;CAClB,CAAC;AAEF,oGAAoG;AACpG,MAAM,UAAU,aAAa,CAAC,MAAiB,EAAE,IAAsB;IACrE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,OAAO;YAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,4 @@
+import { type ToolDefinition } from './types.js';
+/** The local knowledge library. Local only: these write under the home directory. */
+export declare const libraryTools: ToolDefinition[];
+//# sourceMappingURL=library-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"library-tools.d.ts","sourceRoot":"","sources":["../../src/registry/library-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AA6B7D,qFAAqF;AACrF,eAAO,MAAM,YAAY,EAAE,cAAc,EAoHxC,CAAC"}

package/dist/registry/library-tools.js

@@ -0,0 +1,116 @@
+import { defineTool } from './types.js';
+import { getLibraryItemSchema, getLibraryItemOutputSchema, getLibraryItemHandler, searchLibrarySchema, searchLibraryOutputSchema, searchLibraryHandler, updateLibraryTagsSchema, updateLibraryTagsOutputSchema, updateLibraryTagsHandler, deleteLibraryItemSchema, deleteLibraryItemOutputSchema, deleteLibraryItemHandler, rebuildLibraryIndexSchema, rebuildLibraryIndexOutputSchema, rebuildLibraryIndexHandler, } from '../tools/library.js';
+import { listLibrarySchema, listLibraryOutputSchema, listLibraryHandler, } from '../tools/list-library.js';
+import { saveToLibrarySchema, saveToLibraryOutputSchema, saveToLibraryHandler, } from '../tools/save-to-library.js';
+/** The local knowledge library. Local only: these write under the home directory. */
+export const libraryTools = [
+    defineTool({
+        name: 'save_to_library',
+        mode: 'stdio',
+        title: 'Save to YouTube Knowledge Library',
+        description: 'Save a summary or skill note to the local YouTube knowledge library. Overwrites existing content of the same type for the same video. Returns the saved file path.',
+        inputSchema: saveToLibrarySchema,
+        outputSchema: saveToLibraryOutputSchema,
+        annotations: {
+            readOnlyHint: false,
+            // Overwrites an existing note of the same type in place, which is a
+            // destructive update: the previous content is not recoverable.
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        handler: saveToLibraryHandler,
+    }),
+    defineTool({
+        name: 'list_library',
+        mode: 'stdio',
+        title: 'List YouTube Knowledge Library',
+        description: 'List all saved items in the local YouTube knowledge library. Returns titles, channels, content types, tags, and save dates. Optionally filter by tag. Sorted by most recently saved.',
+        inputSchema: listLibrarySchema,
+        outputSchema: listLibraryOutputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        handler: listLibraryHandler,
+    }),
+    defineTool({
+        name: 'get_library_item',
+        mode: 'stdio',
+        title: 'Read a Saved Library Item',
+        description: 'Read back a summary or skill note previously saved with save_to_library. Returns the markdown content plus the saved metadata.',
+        inputSchema: getLibraryItemSchema,
+        outputSchema: getLibraryItemOutputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        handler: getLibraryItemHandler,
+    }),
+    defineTool({
+        name: 'search_library',
+        mode: 'stdio',
+        title: 'Search the Knowledge Library',
+        description: 'Full-text search across every saved summary and skill note, ranked by relevance. Returns matching excerpts with the video IDs needed to read the full note.',
+        inputSchema: searchLibrarySchema,
+        outputSchema: searchLibraryOutputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        handler: searchLibraryHandler,
+    }),
+    defineTool({
+        name: 'update_library_tags',
+        mode: 'stdio',
+        title: 'Update Library Tags',
+        description: 'Add, remove or replace the tags on a saved library item. Tags are how list_library filters, so this is the way to reorganize a growing library. The replace parameter discards all existing tags.',
+        inputSchema: updateLibraryTagsSchema,
+        outputSchema: updateLibraryTagsOutputSchema,
+        annotations: {
+            readOnlyHint: false,
+            // The replace parameter discards every existing tag.
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        handler: updateLibraryTagsHandler,
+    }),
+    defineTool({
+        name: 'delete_library_item',
+        mode: 'stdio',
+        title: 'Delete a Library Item',
+        description: 'Permanently delete a saved summary or skill note, or the entire library entry for a video. This removes files from disk and cannot be undone.',
+        inputSchema: deleteLibraryItemSchema,
+        outputSchema: deleteLibraryItemOutputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        handler: deleteLibraryItemHandler,
+    }),
+    defineTool({
+        name: 'rebuild_library_index',
+        mode: 'stdio',
+        title: 'Rebuild the Library Search Index',
+        description: 'Rebuild the full-text search index from the notes on disk. Use this if search_library results look stale or incomplete, for example after editing files by hand.',
+        inputSchema: rebuildLibraryIndexSchema,
+        outputSchema: rebuildLibraryIndexOutputSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        handler: rebuildLibraryIndexHandler,
+    }),
+];
+//# sourceMappingURL=library-tools.js.map

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"}