youtube-knowledge-mcp 2.1.0 → 3.0.0

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

@@ -0,0 +1,235 @@
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { type ThumbnailEntry, type ThumbnailTab } from '../thumbnail-schemas.js';
+export declare const listChannelThumbnailsSchema: {
+    channel: z.ZodString;
+    tab: z.ZodOptional<z.ZodEnum<["videos", "shorts", "streams"]>>;
+    state: z.ZodOptional<z.ZodEnum<["pending", "saved", "failed"]>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+};
+export declare const listChannelThumbnailsOutputSchema: {
+    total: z.ZodNumber;
+    count: z.ZodNumber;
+    offset: z.ZodNumber;
+    hasMore: z.ZodBoolean;
+    nextOffset: z.ZodOptional<z.ZodNumber>;
+    channelId: z.ZodString;
+    name: z.ZodString;
+    handle: z.ZodString;
+    directory: z.ZodString;
+    tabs: z.ZodArray<z.ZodEnum<["videos", "shorts", "streams"]>, "many">;
+    quality: z.ZodEnum<["best", "listed"]>;
+    updatedAt: z.ZodString;
+    avatar: z.ZodOptional<z.ZodObject<{
+        file: z.ZodOptional<z.ZodString>;
+        sourceUrl: z.ZodOptional<z.ZodString>;
+        variant: z.ZodOptional<z.ZodString>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+        bytes: z.ZodOptional<z.ZodNumber>;
+        format: z.ZodOptional<z.ZodEnum<["jpg", "png", "webp"]>>;
+        fetchedAt: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+        kind: z.ZodEnum<["avatar", "banner"]>;
+        state: z.ZodEnum<["pending", "saved", "failed"]>;
+    } & {
+        path: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "avatar" | "banner";
+        state: "pending" | "failed" | "saved";
+        path?: string | undefined;
+        error?: string | undefined;
+        file?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+        fetchedAt?: string | undefined;
+        bytes?: number | undefined;
+        format?: "png" | "jpg" | "webp" | undefined;
+        sourceUrl?: string | undefined;
+        variant?: string | undefined;
+    }, {
+        kind: "avatar" | "banner";
+        state: "pending" | "failed" | "saved";
+        path?: string | undefined;
+        error?: string | undefined;
+        file?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+        fetchedAt?: string | undefined;
+        bytes?: number | undefined;
+        format?: "png" | "jpg" | "webp" | undefined;
+        sourceUrl?: string | undefined;
+        variant?: string | undefined;
+    }>>;
+    banner: z.ZodOptional<z.ZodObject<{
+        file: z.ZodOptional<z.ZodString>;
+        sourceUrl: z.ZodOptional<z.ZodString>;
+        variant: z.ZodOptional<z.ZodString>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+        bytes: z.ZodOptional<z.ZodNumber>;
+        format: z.ZodOptional<z.ZodEnum<["jpg", "png", "webp"]>>;
+        fetchedAt: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+        kind: z.ZodEnum<["avatar", "banner"]>;
+        state: z.ZodEnum<["pending", "saved", "failed"]>;
+    } & {
+        path: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "avatar" | "banner";
+        state: "pending" | "failed" | "saved";
+        path?: string | undefined;
+        error?: string | undefined;
+        file?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+        fetchedAt?: string | undefined;
+        bytes?: number | undefined;
+        format?: "png" | "jpg" | "webp" | undefined;
+        sourceUrl?: string | undefined;
+        variant?: string | undefined;
+    }, {
+        kind: "avatar" | "banner";
+        state: "pending" | "failed" | "saved";
+        path?: string | undefined;
+        error?: string | undefined;
+        file?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+        fetchedAt?: string | undefined;
+        bytes?: number | undefined;
+        format?: "png" | "jpg" | "webp" | undefined;
+        sourceUrl?: string | undefined;
+        variant?: string | undefined;
+    }>>;
+    stats: z.ZodObject<{
+        videoCount: z.ZodNumber;
+        savedCount: z.ZodNumber;
+        failedCount: z.ZodNumber;
+        pendingCount: z.ZodNumber;
+        totalBytes: z.ZodNumber;
+        tabs: z.ZodArray<z.ZodObject<{
+            tab: z.ZodEnum<["videos", "shorts", "streams"]>;
+            videoCount: z.ZodNumber;
+            savedCount: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            videoCount: number;
+            tab: "videos" | "shorts" | "streams";
+            savedCount: number;
+        }, {
+            videoCount: number;
+            tab: "videos" | "shorts" | "streams";
+            savedCount: number;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        videoCount: number;
+        failedCount: number;
+        pendingCount: number;
+        tabs: {
+            videoCount: number;
+            tab: "videos" | "shorts" | "streams";
+            savedCount: number;
+        }[];
+        savedCount: number;
+        totalBytes: number;
+    }, {
+        videoCount: number;
+        failedCount: number;
+        pendingCount: number;
+        tabs: {
+            videoCount: number;
+            tab: "videos" | "shorts" | "streams";
+            savedCount: number;
+        }[];
+        savedCount: number;
+        totalBytes: number;
+    }>;
+    thumbnails: z.ZodArray<z.ZodObject<{
+        file: z.ZodOptional<z.ZodString>;
+        sourceUrl: z.ZodOptional<z.ZodString>;
+        variant: z.ZodOptional<z.ZodString>;
+        width: z.ZodOptional<z.ZodNumber>;
+        height: z.ZodOptional<z.ZodNumber>;
+        bytes: z.ZodOptional<z.ZodNumber>;
+        format: z.ZodOptional<z.ZodEnum<["jpg", "png", "webp"]>>;
+        fetchedAt: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+        videoId: z.ZodString;
+        title: z.ZodString;
+        url: z.ZodString;
+        tab: z.ZodEnum<["videos", "shorts", "streams"]>;
+        isShort: z.ZodBoolean;
+        durationSeconds: z.ZodNumber;
+        liveStatus: z.ZodOptional<z.ZodString>;
+        listedUrl: z.ZodOptional<z.ZodString>;
+        listedWidth: z.ZodOptional<z.ZodNumber>;
+        listedHeight: z.ZodOptional<z.ZodNumber>;
+        state: z.ZodEnum<["pending", "saved", "failed"]>;
+    } & {
+        path: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        durationSeconds: number;
+        url: string;
+        videoId: string;
+        state: "pending" | "failed" | "saved";
+        tab: "videos" | "shorts" | "streams";
+        isShort: boolean;
+        path?: string | undefined;
+        error?: string | undefined;
+        file?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+        liveStatus?: string | undefined;
+        fetchedAt?: string | undefined;
+        bytes?: number | undefined;
+        format?: "png" | "jpg" | "webp" | undefined;
+        listedUrl?: string | undefined;
+        listedWidth?: number | undefined;
+        listedHeight?: number | undefined;
+        sourceUrl?: string | undefined;
+        variant?: string | undefined;
+    }, {
+        title: string;
+        durationSeconds: number;
+        url: string;
+        videoId: string;
+        state: "pending" | "failed" | "saved";
+        tab: "videos" | "shorts" | "streams";
+        isShort: boolean;
+        path?: string | undefined;
+        error?: string | undefined;
+        file?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+        liveStatus?: string | undefined;
+        fetchedAt?: string | undefined;
+        bytes?: number | undefined;
+        format?: "png" | "jpg" | "webp" | undefined;
+        listedUrl?: string | undefined;
+        listedWidth?: number | undefined;
+        listedHeight?: number | undefined;
+        sourceUrl?: string | undefined;
+        variant?: string | undefined;
+    }>, "many">;
+};
+export declare function listChannelThumbnailsHandler({ channel, tab, state, limit, offset, }: {
+    channel: string;
+    tab?: ThumbnailTab;
+    state?: ThumbnailEntry['state'];
+    limit: number;
+    offset: number;
+}): Promise<CallToolResult>;
+export declare const deleteChannelThumbnailsSchema: {
+    channel: z.ZodString;
+};
+export declare const deleteChannelThumbnailsOutputSchema: {
+    channelId: z.ZodString;
+    name: z.ZodString;
+    deleted: z.ZodBoolean;
+};
+export declare function deleteChannelThumbnailsHandler({ channel, }: {
+    channel: string;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=list-channel-thumbnails.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-channel-thumbnails.d.ts","sourceRoot":"","sources":["../../src/tools/list-channel-thumbnails.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,EAQL,KAAK,cAAc,EACnB,KAAK,YAAY,EAClB,MAAM,yBAAyB,CAAC;AAiBjC,eAAO,MAAM,2BAA2B;;;;;;CAMvC,CAAC;AAEF,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAa7C,CAAC;AAEF,wBAAsB,4BAA4B,CAAC,EACjD,OAAO,EACP,GAAG,EACH,KAAK,EACL,KAAK,EACL,MAAM,GACP,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,YAAY,CAAC;IACnB,KAAK,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,cAAc,CAAC,CAwC1B;AAID,eAAO,MAAM,6BAA6B;;CAEzC,CAAC;AAEF,eAAO,MAAM,mCAAmC;;;;CAI/C,CAAC;AAEF,wBAAsB,8BAA8B,CAAC,EACnD,OAAO,GACR,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,cAAc,CAAC,CAS1B"}

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

@@ -0,0 +1,79 @@
+import { z } from 'zod';
+import { paginationShape } from '../schemas.js';
+import { channelImageSchema, thumbnailEntrySchema, thumbnailQualitySchema, thumbnailStateSchema, thumbnailStatsSchema, thumbnailTabSchema, } from '../thumbnail-schemas.js';
+import { pageInfo, toolResult } from '../utils/format.js';
+import { thumbnailDir } from '../utils/thumbnail-paths.js';
+import { channelImageFile, deleteThumbnails, entryPath, resolveThumbnails, } from '../utils/thumbnail-store.js';
+/** Reading back, and throwing away, a channel's saved thumbnails. Neither touches the network. */
+const withPath = (item, path) => path === undefined ? item : { ...item, path };
+// -- list_channel_thumbnails ---------------------------------------------
+export const listChannelThumbnailsSchema = {
+    channel: z.string().describe('Channel URL, @handle, name, or channel id of a fetched channel'),
+    tab: thumbnailTabSchema.optional().describe('Only entries from this tab'),
+    state: thumbnailStateSchema.optional().describe('Only entries in this state'),
+    limit: z.number().int().min(1).max(200).default(50).describe('Maximum entries. Default: 50'),
+    offset: z.number().int().min(0).default(0).describe('Skip this many entries'),
+};
+export const listChannelThumbnailsOutputSchema = {
+    channelId: z.string(),
+    name: z.string(),
+    handle: z.string(),
+    directory: z.string(),
+    tabs: z.array(thumbnailTabSchema),
+    quality: thumbnailQualitySchema,
+    updatedAt: z.string(),
+    avatar: channelImageSchema.extend({ path: z.string().optional() }).optional(),
+    banner: channelImageSchema.extend({ path: z.string().optional() }).optional(),
+    stats: thumbnailStatsSchema,
+    thumbnails: z.array(thumbnailEntrySchema.extend({ path: z.string().optional() })),
+    ...paginationShape,
+};
+export async function listChannelThumbnailsHandler({ channel, tab, state, limit, offset, }) {
+    const manifest = await resolveThumbnails(channel);
+    const { channelId, name, handle } = manifest.channel;
+    const all = Object.values(manifest.videos).filter((entry) => (tab === undefined || entry.tab === tab) && (state === undefined || entry.state === state));
+    const page = all.slice(offset, offset + limit);
+    const image = (kind) => {
+        const recorded = manifest[kind];
+        return recorded === undefined
+            ? undefined
+            : withPath(recorded, channelImageFile(channelId, recorded));
+    };
+    const lines = [
+        `${name}: ${manifest.stats.savedCount} of ${manifest.stats.videoCount} thumbnails saved in ${thumbnailDir(channelId)}`,
+        '',
+        ...page.map((entry) => `${entry.state === 'saved' ? '✓' : '✗'} ${entry.videoId} ${entry.title}${entry.width === undefined ? '' : ` (${entry.width}x${entry.height})`}`),
+    ];
+    if (page.length === 0)
+        lines.push('No entries match.');
+    return toolResult(lines.join('\n'), {
+        channelId,
+        name,
+        handle,
+        directory: thumbnailDir(channelId),
+        tabs: manifest.tabs,
+        quality: manifest.quality,
+        updatedAt: manifest.updatedAt,
+        ...(image('avatar') === undefined ? {} : { avatar: image('avatar') }),
+        ...(image('banner') === undefined ? {} : { banner: image('banner') }),
+        stats: manifest.stats,
+        thumbnails: page.map((entry) => withPath(entry, entryPath(channelId, entry))),
+        ...pageInfo({ total: all.length, count: page.length, offset }),
+    });
+}
+// -- delete_channel_thumbnails -------------------------------------------
+export const deleteChannelThumbnailsSchema = {
+    channel: z.string().describe('Channel URL, @handle, name, or channel id of a fetched channel'),
+};
+export const deleteChannelThumbnailsOutputSchema = {
+    channelId: z.string(),
+    name: z.string(),
+    deleted: z.boolean(),
+};
+export async function deleteChannelThumbnailsHandler({ channel, }) {
+    const manifest = await resolveThumbnails(channel);
+    const { channelId, name } = manifest.channel;
+    const deleted = await deleteThumbnails(channelId);
+    return toolResult(`Deleted the thumbnails for ${name}. Call fetch_channel_thumbnails to fetch them again, at a different quality if you like.`, { channelId, name, deleted });
+}
+//# sourceMappingURL=list-channel-thumbnails.js.map

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

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

package/dist/tools/list-library.js

@@ -14,7 +14,7 @@ export const listLibraryOutputSchema = {
 };
 export async function listLibraryHandler({ tag }) {
     const items = await listLibrary(tag ? { tag } : undefined);
-    const structured = { items, ...pageInfo(items.length, items.length) };
+    const structured = { items, ...pageInfo({ total: items.length, count: items.length }) };
     const lines = [];
     if (items.length === 0) {
         lines.push('Your library is empty.');

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

@@ -1 +1 @@
-{"version":3,"file":"list-library.js","sourceRoot":"","sources":["../../src/tools/list-library.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGvE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,+FAA+F,CAChG;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC;IACrC,GAAG,eAAe;CACnB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EAAE,GAAG,EAAoB;IAChE,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC3D,MAAM,UAAU,GAAG,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;IAEtE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACvC,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,GAAG;YAChB,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,QAAQ,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,cAAc,GAAG,GAAG;YAC1E,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,QAAQ,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC;QACtE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YACxB,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,UAAU;gBAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC3C,IAAI,IAAI,CAAC,QAAQ;gBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAEvC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACtC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YACtC,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;YAC/D,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjD,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;AAClD,CAAC"}
+{"version":3,"file":"list-library.js","sourceRoot":"","sources":["../../src/tools/list-library.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGvE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,+FAA+F,CAChG;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC;IACrC,GAAG,eAAe;CACnB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EAAE,GAAG,EAAoB;IAChE,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC3D,MAAM,UAAU,GAAG,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;IAExF,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACvC,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,GAAG;YAChB,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,QAAQ,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,cAAc,GAAG,GAAG;YAC1E,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,QAAQ,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC;QACtE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YACxB,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,UAAU;gBAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC3C,IAAI,IAAI,CAAC,QAAQ;gBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAEvC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACtC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YACtC,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;YAC/D,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjD,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC;AAClD,CAAC"}

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

@@ -0,0 +1,59 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+export declare const pruneHarvestSchema: {
+    channel: z.ZodOptional<z.ZodString>;
+    video: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+    scope: z.ZodDefault<z.ZodEnum<["comments", "catalog", "all"]>>;
+    confirm: z.ZodLiteral<true>;
+    vacuum: z.ZodDefault<z.ZodBoolean>;
+};
+export declare const pruneHarvestOutputSchema: {
+    removed: z.ZodObject<{
+        comments: z.ZodNumber;
+        videos: z.ZodNumber;
+        channels: z.ZodNumber;
+        receipts: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        videos: number;
+        comments: number;
+        channels: number;
+        receipts: number;
+    }, {
+        videos: number;
+        comments: number;
+        channels: number;
+        receipts: number;
+    }>;
+    remaining: z.ZodObject<{
+        comments: z.ZodNumber;
+        videos: z.ZodNumber;
+        channels: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        videos: number;
+        comments: number;
+        channels: number;
+    }, {
+        videos: number;
+        comments: number;
+        channels: number;
+    }>;
+    vacuumed: z.ZodBoolean;
+};
+/**
+ * Removes harvested data.
+ *
+ * The store holds personal data at scale — display names, channel ids and
+ * free-text opinions from people who never used this tool — so a way to remove
+ * it is a requirement, not a convenience. `author` is the per-person erasure
+ * path; the other scopes are for reclaiming disk.
+ */
+export declare function pruneHarvestHandler(input: {
+    channel?: string;
+    video?: string;
+    author?: string;
+    scope: 'comments' | 'catalog' | 'all';
+    confirm: true;
+    vacuum: boolean;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=prune-harvest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prune-harvest.d.ts","sourceRoot":"","sources":["../../src/tools/prune-harvest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,kBAAkB;;;;;;;CAkB9B,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAapC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,EAAE;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,KAAK,CAAC;IACtC,OAAO,EAAE,IAAI,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC,cAAc,CAAC,CAwE1B"}

package/dist/tools/prune-harvest.js

@@ -0,0 +1,108 @@
+import { z } from 'zod';
+import { toolResult } from '../utils/format.js';
+import { getStore, inTransaction } from '../utils/store.js';
+import { countRows } from '../utils/store-rows.js';
+export const pruneHarvestSchema = {
+    channel: z.string().max(64).optional().describe('Restrict to one channel id'),
+    video: z.string().max(64).optional().describe('Restrict to one video id'),
+    author: z
+        .string()
+        .max(256)
+        .optional()
+        .describe("Remove one author's comments everywhere. The erasure path for a person who asks."),
+    scope: z.enum(['comments', 'catalog', 'all']).default('comments'),
+    confirm: z
+        .literal(true)
+        .describe('Must be true. Harvested comments cost hours of network that no local cache can replay.'),
+    vacuum: z
+        .boolean()
+        .default(false)
+        .describe('Reclaim disk afterwards. Slow on a large store, and it blocks other writers.'),
+};
+export const pruneHarvestOutputSchema = {
+    removed: z.object({
+        comments: z.number().int(),
+        videos: z.number().int(),
+        channels: z.number().int(),
+        receipts: z.number().int(),
+    }),
+    remaining: z.object({
+        comments: z.number().int(),
+        videos: z.number().int(),
+        channels: z.number().int(),
+    }),
+    vacuumed: z.boolean(),
+};
+/**
+ * Removes harvested data.
+ *
+ * The store holds personal data at scale — display names, channel ids and
+ * free-text opinions from people who never used this tool — so a way to remove
+ * it is a requirement, not a convenience. `author` is the per-person erasure
+ * path; the other scopes are for reclaiming disk.
+ */
+export async function pruneHarvestHandler(input) {
+    const store = await getStore();
+    const count = (sql) => countRows(store.prepare(sql));
+    const before = {
+        comments: count('SELECT COUNT(*) FROM comment'),
+        videos: count('SELECT COUNT(*) FROM video'),
+        channels: count('SELECT COUNT(*) FROM channel'),
+        receipts: count('SELECT COUNT(*) FROM harvest_receipt'),
+    };
+    inTransaction(store, () => {
+        if (input.author !== undefined) {
+            store
+                .prepare('DELETE FROM comment WHERE author_id = ? OR author = ?')
+                .run(input.author, input.author);
+            return;
+        }
+        if (input.scope !== 'catalog') {
+            if (input.video !== undefined) {
+                store.prepare('DELETE FROM comment WHERE video_id = ?').run(input.video);
+                store
+                    .prepare("DELETE FROM harvest_receipt WHERE scope = 'video-comments' AND target_id = ?")
+                    .run(input.video);
+            }
+            else if (input.channel !== undefined) {
+                store
+                    .prepare('DELETE FROM comment WHERE video_id IN (SELECT video_id FROM video WHERE channel_id = ?)')
+                    .run(input.channel);
+            }
+            else {
+                store.exec('DELETE FROM comment');
+                store.exec("DELETE FROM harvest_receipt WHERE scope = 'video-comments'");
+            }
+        }
+        if (input.scope !== 'comments') {
+            // ON DELETE CASCADE takes the videos, and their comments, with the channel.
+            if (input.channel !== undefined) {
+                store.prepare('DELETE FROM channel WHERE channel_id = ?').run(input.channel);
+                store
+                    .prepare("DELETE FROM harvest_receipt WHERE scope = 'channel-catalog' AND target_id = ?")
+                    .run(input.channel);
+            }
+            else {
+                store.exec('DELETE FROM channel');
+                store.exec('DELETE FROM video');
+                store.exec('DELETE FROM harvest_receipt');
+            }
+        }
+    });
+    if (input.vacuum)
+        store.exec('VACUUM');
+    const remaining = {
+        comments: count('SELECT COUNT(*) FROM comment'),
+        videos: count('SELECT COUNT(*) FROM video'),
+        channels: count('SELECT COUNT(*) FROM channel'),
+    };
+    const removed = {
+        comments: before.comments - remaining.comments,
+        videos: before.videos - remaining.videos,
+        channels: before.channels - remaining.channels,
+        receipts: before.receipts - count('SELECT COUNT(*) FROM harvest_receipt'),
+    };
+    return toolResult(`Removed ${String(removed.comments)} comments, ${String(removed.videos)} videos and ${String(removed.channels)} channels. ` +
+        `${String(remaining.comments)} comments remain.`, { removed, remaining, vacuumed: input.vacuum });
+}
+//# sourceMappingURL=prune-harvest.js.map

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

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

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

@@ -0,0 +1,125 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+export declare const queryCommentsSchema: {
+    video: z.ZodOptional<z.ZodString>;
+    channel: z.ZodOptional<z.ZodString>;
+    match: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+    minLikes: z.ZodDefault<z.ZodNumber>;
+    topLevelOnly: z.ZodDefault<z.ZodBoolean>;
+    threadOf: z.ZodOptional<z.ZodString>;
+    order: z.ZodDefault<z.ZodEnum<["likes", "newest", "oldest", "relevance"]>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+};
+export declare const queryCommentsOutputSchema: {
+    total: z.ZodNumber;
+    count: z.ZodNumber;
+    offset: z.ZodNumber;
+    hasMore: z.ZodBoolean;
+    nextOffset: z.ZodOptional<z.ZodNumber>;
+    comments: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        videoId: z.ZodString;
+        parentId: z.ZodNullable<z.ZodString>;
+        author: z.ZodString;
+        authorId: z.ZodOptional<z.ZodString>;
+        text: z.ZodString;
+        likeCount: z.ZodNumber;
+        isPinned: z.ZodBoolean;
+        authorIsUploader: z.ZodBoolean;
+        publishedAt: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        likeCount: number;
+        author: string;
+        text: string;
+        isPinned: boolean;
+        parentId: string | null;
+        authorIsUploader: boolean;
+        videoId: string;
+        authorId?: string | undefined;
+        publishedAt?: string | undefined;
+    }, {
+        id: string;
+        likeCount: number;
+        author: string;
+        text: string;
+        isPinned: boolean;
+        parentId: string | null;
+        authorIsUploader: boolean;
+        videoId: string;
+        authorId?: string | undefined;
+        publishedAt?: string | undefined;
+    }>, "many">;
+    coverage: z.ZodArray<z.ZodObject<{
+        scope: z.ZodEnum<["channel-catalog", "video-details", "video-comments"]>;
+        targetId: z.ZodString;
+        complete: z.ZodBoolean;
+        reason: z.ZodEnum<["COMPLETE", "CAP_REACHED", "BUDGET_SPENT", "RATE_LIMITED", "CANCELLED", "TIMEOUT", "SOURCE_REFUSED", "COMMENTS_DISABLED", "SOURCE_SILENT", "PARTIAL_ERROR", "NOT_ATTEMPTED"]>;
+        have: z.ZodNumber;
+        expected: z.ZodOptional<z.ZodNumber>;
+        expectedSource: z.ZodOptional<z.ZodEnum<["youtube:comment_count", "youtube:playlist_count", "source-exhausted"]>>;
+        ranToExhaustion: z.ZodOptional<z.ZodBoolean>;
+        source: z.ZodString;
+        harvestedAt: z.ZodString;
+        staleAfter: z.ZodOptional<z.ZodString>;
+        limitApplied: z.ZodOptional<z.ZodNumber>;
+        sortApplied: z.ZodOptional<z.ZodEnum<["top", "new"]>>;
+        resumeToken: z.ZodOptional<z.ZodString>;
+        note: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        have: number;
+        scope: "channel-catalog" | "video-details" | "video-comments";
+        targetId: string;
+        complete: boolean;
+        reason: "RATE_LIMITED" | "TIMEOUT" | "CANCELLED" | "COMPLETE" | "CAP_REACHED" | "BUDGET_SPENT" | "SOURCE_REFUSED" | "COMMENTS_DISABLED" | "SOURCE_SILENT" | "PARTIAL_ERROR" | "NOT_ATTEMPTED";
+        source: string;
+        harvestedAt: string;
+        expected?: number | undefined;
+        note?: string | undefined;
+        ranToExhaustion?: boolean | undefined;
+        expectedSource?: "youtube:playlist_count" | "source-exhausted" | "youtube:comment_count" | undefined;
+        staleAfter?: string | undefined;
+        limitApplied?: number | undefined;
+        sortApplied?: "top" | "new" | undefined;
+        resumeToken?: string | undefined;
+    }, {
+        have: number;
+        scope: "channel-catalog" | "video-details" | "video-comments";
+        targetId: string;
+        complete: boolean;
+        reason: "RATE_LIMITED" | "TIMEOUT" | "CANCELLED" | "COMPLETE" | "CAP_REACHED" | "BUDGET_SPENT" | "SOURCE_REFUSED" | "COMMENTS_DISABLED" | "SOURCE_SILENT" | "PARTIAL_ERROR" | "NOT_ATTEMPTED";
+        source: string;
+        harvestedAt: string;
+        expected?: number | undefined;
+        note?: string | undefined;
+        ranToExhaustion?: boolean | undefined;
+        expectedSource?: "youtube:playlist_count" | "source-exhausted" | "youtube:comment_count" | undefined;
+        staleAfter?: string | undefined;
+        limitApplied?: number | undefined;
+        sortApplied?: "top" | "new" | undefined;
+        resumeToken?: string | undefined;
+    }>, "many">;
+};
+/**
+ * Searches comments already in the store.
+ *
+ * The one place in this server where `total` is honestly a total: the dataset
+ * is local and fixed, so it is a real COUNT(*) and the offset genuinely works.
+ * It is paired with coverage so "total: 4,312" cannot be read as "the video
+ * has 4,312 comments".
+ */
+export declare function queryCommentsHandler(input: {
+    video?: string;
+    channel?: string;
+    match?: string;
+    author?: string;
+    minLikes: number;
+    topLevelOnly: boolean;
+    threadOf?: string;
+    order: 'likes' | 'newest' | 'oldest' | 'relevance';
+    limit: number;
+    offset: number;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=query-comments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-comments.d.ts","sourceRoot":"","sources":["../../src/tools/query-comments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,mBAAmB;;;;;;;;;;;CAsB/B,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsBrC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,cAAc,CAAC,CAwD1B"}