youtube-knowledge-mcp 2.2.0 → 3.0.0

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

package/dist/tools/query-comments.js

@@ -0,0 +1,106 @@
+import { z } from 'zod';
+import { pageInfo, toolResult } from '../utils/format.js';
+import { paginationShape } from '../schemas.js';
+import { coverageSchema } from '../harvest-schemas.js';
+import { getStore } from '../utils/store.js';
+import { countComments, queryComments } from '../utils/comment-store.js';
+import { readReceipt } from '../utils/harvest-receipts.js';
+export const queryCommentsSchema = {
+    video: z.string().max(2048).optional().describe('Restrict to one video id'),
+    channel: z.string().max(64).optional().describe('Restrict to one channel id'),
+    match: z
+        .string()
+        .max(512)
+        .optional()
+        .describe('Full-text query over comment text, SQLite FTS5 syntax: bare words, "quoted phrases", ' +
+        'AND / OR / NOT, prefix*. Omit to browse by order instead.'),
+    author: z.string().max(256).optional().describe('Match on author id, or exact author name'),
+    minLikes: z.number().int().min(0).default(0),
+    topLevelOnly: z.boolean().default(false),
+    threadOf: z
+        .string()
+        .max(64)
+        .optional()
+        .describe('A comment id: returns that comment and its replies, in reply order'),
+    order: z.enum(['likes', 'newest', 'oldest', 'relevance']).default('likes'),
+    limit: z.number().int().min(1).max(200).default(25),
+    offset: z.number().int().min(0).default(0),
+};
+export const queryCommentsOutputSchema = {
+    comments: z.array(z.object({
+        id: z.string(),
+        videoId: z.string(),
+        parentId: z.string().nullable(),
+        author: z.string(),
+        authorId: z.string().optional(),
+        text: z.string(),
+        likeCount: z.number().int(),
+        isPinned: z.boolean(),
+        authorIsUploader: z.boolean(),
+        publishedAt: z.string().optional(),
+    })),
+    coverage: z
+        .array(coverageSchema)
+        .describe('Coverage of the videos these results were drawn from. `total` counts rows IN THIS STORE — ' +
+        'it is not the number of comments those videos have, and these receipts are what says so.'),
+    ...paginationShape,
+};
+/**
+ * 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 async function queryCommentsHandler(input) {
+    const store = await getStore();
+    const query = {
+        ...(input.video === undefined ? {} : { videoId: input.video }),
+        ...(input.channel === undefined ? {} : { channelId: input.channel }),
+        ...(input.match === undefined ? {} : { match: input.match }),
+        ...(input.author === undefined ? {} : { authorId: input.author }),
+        ...(input.threadOf === undefined ? {} : { threadOf: input.threadOf }),
+        minLikes: input.minLikes,
+        topLevelOnly: input.topLevelOnly,
+        order: input.order,
+        limit: input.limit,
+        offset: input.offset,
+    };
+    const rows = queryComments(store, query);
+    const total = countComments(store, query);
+    const videoIds = [...new Set(rows.map((row) => row.video_id))];
+    const coverage = videoIds
+        .map((videoId) => readReceipt(store, 'video-comments', videoId))
+        .filter((receipt) => receipt !== undefined);
+    const incomplete = coverage.filter((receipt) => !receipt.complete).length;
+    const lines = [
+        `${String(rows.length)} of ${String(total)} matching comments in the store.`,
+        ...(incomplete > 0
+            ? [
+                `${String(incomplete)} of the ${String(coverage.length)} videos these came from are only partly harvested — this is a sample of their comments, not all of them.`,
+            ]
+            : []),
+        '',
+        ...rows.map((row) => `${row.author}${row.author_is_uploader ? ' (uploader)' : ''}: ${row.text.replace(/\s+/g, ' ').slice(0, 200)} — ${String(row.like_count)} likes`),
+    ];
+    return toolResult(lines.join('\n'), {
+        comments: rows.map((row) => ({
+            id: row.comment_id,
+            videoId: row.video_id,
+            parentId: row.parent_id,
+            author: row.author,
+            ...(row.author_id === null ? {} : { authorId: row.author_id }),
+            text: row.text,
+            likeCount: row.like_count,
+            isPinned: row.is_pinned,
+            authorIsUploader: row.author_is_uploader,
+            ...(row.published_at === null
+                ? {}
+                : { publishedAt: new Date(row.published_at * 1000).toISOString() }),
+        })),
+        coverage,
+        ...pageInfo({ total, count: rows.length, offset: input.offset }),
+    });
+}
+//# sourceMappingURL=query-comments.js.map

package/dist/tools/query-comments.js.map

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

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

@@ -0,0 +1,118 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+export declare const queryVideosSchema: {
+    channel: z.ZodOptional<z.ZodString>;
+    match: z.ZodOptional<z.ZodString>;
+    since: z.ZodOptional<z.ZodString>;
+    until: z.ZodOptional<z.ZodString>;
+    minDurationSeconds: z.ZodDefault<z.ZodNumber>;
+    detailedOnly: z.ZodDefault<z.ZodBoolean>;
+    withComments: z.ZodDefault<z.ZodBoolean>;
+    order: z.ZodDefault<z.ZodEnum<["newest", "oldest", "views", "comments", "catalog"]>>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+};
+export declare const queryVideosOutputSchema: {
+    total: z.ZodNumber;
+    count: z.ZodNumber;
+    offset: z.ZodNumber;
+    hasMore: z.ZodBoolean;
+    nextOffset: z.ZodOptional<z.ZodNumber>;
+    videos: z.ZodArray<z.ZodObject<{
+        videoId: z.ZodString;
+        channelId: z.ZodOptional<z.ZodString>;
+        title: z.ZodString;
+        durationSeconds: z.ZodOptional<z.ZodNumber>;
+        uploadDate: z.ZodOptional<z.ZodString>;
+        viewCount: z.ZodOptional<z.ZodNumber>;
+        tab: z.ZodOptional<z.ZodString>;
+        alsoInTabs: z.ZodArray<z.ZodString, "many">;
+        storedComments: z.ZodNumber;
+        detailed: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        videoId: string;
+        detailed: boolean;
+        alsoInTabs: string[];
+        storedComments: number;
+        durationSeconds?: number | undefined;
+        viewCount?: number | undefined;
+        uploadDate?: string | undefined;
+        channelId?: string | undefined;
+        tab?: string | undefined;
+    }, {
+        title: string;
+        videoId: string;
+        detailed: boolean;
+        alsoInTabs: string[];
+        storedComments: number;
+        durationSeconds?: number | undefined;
+        viewCount?: number | undefined;
+        uploadDate?: string | undefined;
+        channelId?: string | undefined;
+        tab?: 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 the catalogued videos. Local only; never contacts YouTube. */
+export declare function queryVideosHandler(input: {
+    channel?: string;
+    match?: string;
+    since?: string;
+    until?: string;
+    minDurationSeconds: number;
+    detailedOnly: boolean;
+    withComments: boolean;
+    order: 'newest' | 'oldest' | 'views' | 'comments' | 'catalog';
+    limit: number;
+    offset: number;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=query-videos.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-videos.d.ts","sourceRoot":"","sources":["../../src/tools/query-videos.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,iBAAiB;;;;;;;;;;;CAiB7B,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoBnC,CAAC;AAQF,0EAA0E;AAC1E,wBAAsB,kBAAkB,CAAC,KAAK,EAAE;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,cAAc,CAAC,CAoD1B"}

package/dist/tools/query-videos.js

@@ -0,0 +1,97 @@
+import { z } from 'zod';
+import { pageInfo, toolResult } from '../utils/format.js';
+import { paginationShape } from '../schemas.js';
+import { coverageSchema } from '../harvest-schemas.js';
+import { getStore } from '../utils/store.js';
+import { countVideos, queryVideos } from '../utils/video-store.js';
+import { readReceipt } from '../utils/harvest-receipts.js';
+export const queryVideosSchema = {
+    channel: z.string().max(64).optional().describe('Restrict to one channel id'),
+    match: z.string().max(512).optional().describe('Substring match on the title'),
+    since: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/)
+        .optional(),
+    until: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}$/)
+        .optional(),
+    minDurationSeconds: z.number().int().min(0).default(0),
+    detailedOnly: z.boolean().default(false).describe('Only videos whose full metadata was read'),
+    withComments: z.boolean().default(false).describe('Only videos that have harvested comments'),
+    order: z.enum(['newest', 'oldest', 'views', 'comments', 'catalog']).default('newest'),
+    limit: z.number().int().min(1).max(200).default(25),
+    offset: z.number().int().min(0).default(0),
+};
+export const queryVideosOutputSchema = {
+    videos: z.array(z.object({
+        videoId: z.string(),
+        channelId: z.string().optional(),
+        title: z.string(),
+        durationSeconds: z.number().optional(),
+        uploadDate: z
+            .string()
+            .optional()
+            .describe('Absent when only a flat listing has seen this video, which carries no date'),
+        viewCount: z.number().optional(),
+        tab: z.string().optional(),
+        alsoInTabs: z.array(z.string()),
+        storedComments: z.number().int().describe('Comments held locally, not the number it has'),
+        detailed: z.boolean(),
+    })),
+    coverage: z.array(coverageSchema).describe('The channel-catalogue receipts these rows came from'),
+    ...paginationShape,
+};
+/** The column is a JSON array written by SQLite's json_insert. */
+function parseTabs(value) {
+    const parsed = JSON.parse(value);
+    return z.array(z.string()).catch([]).parse(parsed);
+}
+/** Searches the catalogued videos. Local only; never contacts YouTube. */
+export async function queryVideosHandler(input) {
+    const store = await getStore();
+    const query = {
+        ...(input.channel === undefined ? {} : { channelId: input.channel }),
+        ...(input.match === undefined ? {} : { match: input.match }),
+        ...(input.since === undefined ? {} : { since: input.since }),
+        ...(input.until === undefined ? {} : { until: input.until }),
+        minDurationSeconds: input.minDurationSeconds,
+        detailedOnly: input.detailedOnly,
+        withComments: input.withComments,
+        order: input.order,
+        limit: input.limit,
+        offset: input.offset,
+    };
+    const rows = queryVideos(store, query);
+    const total = countVideos(store, query);
+    const channelIds = [...new Set(rows.map((row) => row.channel_id).filter((id) => id !== null))];
+    const coverage = channelIds
+        .map((channelId) => readReceipt(store, 'channel-catalog', channelId))
+        .filter((receipt) => receipt !== undefined);
+    const incomplete = coverage.filter((receipt) => !receipt.complete).length;
+    const lines = [
+        `${String(rows.length)} of ${String(total)} videos in the store.`,
+        ...(incomplete > 0
+            ? ['At least one channel here is only partly catalogued, so this is not its full video list.']
+            : []),
+        '',
+        ...rows.map((row) => `${row.upload_date ?? '(no date)'} ${row.title} — ${String(row.stored_comments)} comments held`),
+    ];
+    return toolResult(lines.join('\n'), {
+        videos: rows.map((row) => ({
+            videoId: row.video_id,
+            ...(row.channel_id === null ? {} : { channelId: row.channel_id }),
+            title: row.title,
+            ...(row.duration_s === null ? {} : { durationSeconds: row.duration_s }),
+            ...(row.upload_date === null ? {} : { uploadDate: row.upload_date }),
+            ...(row.view_count === null ? {} : { viewCount: row.view_count }),
+            ...(row.tab === null ? {} : { tab: row.tab }),
+            alsoInTabs: parseTabs(row.also_in_tabs),
+            storedComments: row.stored_comments,
+            detailed: row.detail_at !== null,
+        })),
+        coverage,
+        ...pageInfo({ total, count: rows.length, offset: input.offset }),
+    });
+}
+//# sourceMappingURL=query-videos.js.map

package/dist/tools/query-videos.js.map

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

package/dist/tools/repair-store.d.ts

@@ -0,0 +1,34 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+export declare const repairStoreSchema: {
+    confirm: z.ZodLiteral<true>;
+};
+export declare const repairStoreOutputSchema: {
+    wasCorrupt: z.ZodBoolean;
+    integrity: z.ZodEnum<["ok", "failed", "unchecked"]>;
+    movedTo: z.ZodOptional<z.ZodString>;
+    lost: z.ZodObject<{
+        channels: z.ZodNumber;
+        videos: z.ZodNumber;
+        comments: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        videos: number;
+        comments: number;
+        channels: number;
+    }, {
+        videos: number;
+        comments: number;
+        channels: number;
+    }>;
+    storePath: z.ZodString;
+};
+/**
+ * Moves a damaged store aside and starts a fresh one.
+ *
+ * Deliberately not automatic. `search-index.json` is rebuilt from disk without
+ * asking because it is derivable; this is not — it is the only copy of data
+ * that took hours of network to collect. So the damaged file is renamed rather
+ * than deleted, and the report says what was in it.
+ */
+export declare function repairStoreHandler(): Promise<CallToolResult>;
+//# sourceMappingURL=repair-store.d.ts.map

package/dist/tools/repair-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repair-store.d.ts","sourceRoot":"","sources":["../../src/tools/repair-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,iBAAiB;;CAO7B,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;CAanC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,cAAc,CAAC,CAkClE"}