youtube-knowledge-mcp 2.2.0 → 3.0.1

package/dist/tools/export-data.js

@@ -0,0 +1,99 @@
+import { z } from 'zod';
+import { coverageSchema } from '../harvest-schemas.js';
+import { DEFAULT_EXPORT_ROWS, MAX_EXPORT_ROWS, exportData } from '../utils/export-data.js';
+import { fileResult } from '../utils/format.js';
+import { getStore } from '../utils/store.js';
+const MIME = {
+    json: 'application/json',
+    csv: 'text/csv',
+    markdown: 'text/markdown',
+};
+export const exportDataSchema = {
+    dataset: z
+        .enum(['videos', 'comments'])
+        .describe('What to export from the local store: catalogued videos, or harvested comments'),
+    format: z
+        .enum(['json', 'csv', 'markdown'])
+        .default('json')
+        .describe('json keeps everything and carries the receipts inside; csv opens in a spreadsheet, with the receipts in a .coverage.json file beside it; markdown is for reading. Default: json'),
+    channel: z.string().max(64).optional().describe('Only this channel id'),
+    video: z.string().max(32).optional().describe('Only this video id. Comments only'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(MAX_EXPORT_ROWS)
+        .default(DEFAULT_EXPORT_ROWS)
+        .describe(`Most rows to write (max ${MAX_EXPORT_ROWS.toLocaleString('en-US')}). Default: ${DEFAULT_EXPORT_ROWS.toLocaleString('en-US')}`),
+    outputDir: z
+        .string()
+        .optional()
+        .describe('Where to write the file. Must be inside your home directory.'),
+};
+export const exportDataOutputSchema = {
+    filePath: z.string(),
+    coveragePath: z.string().optional().describe('For csv: the file holding the receipts'),
+    dataset: z.enum(['videos', 'comments']),
+    format: z.enum(['json', 'csv', 'markdown']),
+    rows: z.number().int().describe('Rows written'),
+    total: z.number().int().describe('Rows that matched, written or not'),
+    truncated: z.boolean().describe('True when the limit left matching rows out'),
+    bytes: z.number().int(),
+    coverage: z.array(coverageSchema).describe('The receipts for the rows in the file'),
+    withoutReceipt: z
+        .array(z.string())
+        .describe('Receipts that should exist for these rows and do not, as scope:id'),
+    omittedReceipts: z.number().int().describe('Receipts left out of the list, past its limit'),
+};
+/**
+ * Writes harvested data to a file, with the receipts that say how whole it is.
+ * Local only: it reads the store and writes to disk.
+ */
+export async function exportDataHandler(args) {
+    const store = await getStore();
+    const result = await exportData(store, args);
+    const incomplete = result.coverage.filter((receipt) => !receipt.complete).length;
+    const lines = [
+        `✓ Exported ${result.rows.toLocaleString('en-US')} of ${result.total.toLocaleString('en-US')} ${result.dataset} (${result.format})`,
+        '',
+        result.filePath,
+        ...(result.coveragePath === undefined ? [] : [`Receipts: ${result.coveragePath}`]),
+        ...(result.truncated
+            ? [
+                '',
+                `The limit left ${(result.total - result.rows).toLocaleString('en-US')} matching rows out. Raise limit to export more.`,
+            ]
+            : []),
+        '',
+        ...(result.coverage.length === 0
+            ? []
+            : incomplete === 0
+                ? ['Every receipt for these rows is complete.']
+                : [
+                    `${String(incomplete)} of ${String(result.coverage.length)} receipts ${incomplete === 1 ? 'is' : 'are'} incomplete.`,
+                    `Do not describe this file as the full ${result.dataset === 'videos' ? 'video list' : 'comment history'}.`,
+                ]),
+        ...(result.withoutReceipt.length === 0
+            ? []
+            : [
+                `No receipt for: ${result.withoutReceipt.join(', ')}. How whole those rows are is unknown.`,
+            ]),
+        ...(result.omittedReceipts === 0
+            ? []
+            : [`${String(result.omittedReceipts)} further receipts are not listed here.`]),
+    ];
+    return fileResult(lines.join('\n').trimEnd(), {
+        filePath: result.filePath,
+        ...(result.coveragePath === undefined ? {} : { coveragePath: result.coveragePath }),
+        dataset: result.dataset,
+        format: result.format,
+        rows: result.rows,
+        total: result.total,
+        truncated: result.truncated,
+        bytes: result.bytes,
+        coverage: result.coverage,
+        withoutReceipt: result.withoutReceipt,
+        omittedReceipts: result.omittedReceipts,
+    }, { path: result.filePath, name: `${result.dataset} export`, mimeType: MIME[result.format] });
+}
+//# sourceMappingURL=export-data.js.map

package/dist/tools/export-data.js.map

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

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

@@ -62,9 +62,9 @@ export declare const fetchChannelThumbnailsOutputSchema: {
         file?: string | undefined;
         width?: number | undefined;
         height?: number | undefined;
+        fetchedAt?: string | undefined;
         bytes?: number | undefined;
         format?: "png" | "jpg" | "webp" | undefined;
-        fetchedAt?: string | undefined;
         sourceUrl?: string | undefined;
         variant?: string | undefined;
     }, {
@@ -74,9 +74,9 @@ export declare const fetchChannelThumbnailsOutputSchema: {
         file?: string | undefined;
         width?: number | undefined;
         height?: number | undefined;
+        fetchedAt?: string | undefined;
         bytes?: number | undefined;
         format?: "png" | "jpg" | "webp" | undefined;
-        fetchedAt?: string | undefined;
         sourceUrl?: string | undefined;
         variant?: string | undefined;
     }>>;
@@ -99,9 +99,9 @@ export declare const fetchChannelThumbnailsOutputSchema: {
         file?: string | undefined;
         width?: number | undefined;
         height?: number | undefined;
+        fetchedAt?: string | undefined;
         bytes?: number | undefined;
         format?: "png" | "jpg" | "webp" | undefined;
-        fetchedAt?: string | undefined;
         sourceUrl?: string | undefined;
         variant?: string | undefined;
     }, {
@@ -111,9 +111,9 @@ export declare const fetchChannelThumbnailsOutputSchema: {
         file?: string | undefined;
         width?: number | undefined;
         height?: number | undefined;
+        fetchedAt?: string | undefined;
         bytes?: number | undefined;
         format?: "png" | "jpg" | "webp" | undefined;
-        fetchedAt?: string | undefined;
         sourceUrl?: string | undefined;
         variant?: string | undefined;
     }>>;
@@ -142,24 +142,24 @@ export declare const fetchChannelThumbnailsOutputSchema: {
         videoCount: number;
         failedCount: number;
         pendingCount: number;
-        savedCount: number;
-        totalBytes: number;
         tabs: {
             videoCount: number;
             tab: "videos" | "shorts" | "streams";
             savedCount: number;
         }[];
+        savedCount: number;
+        totalBytes: number;
     }, {
         videoCount: number;
         failedCount: number;
         pendingCount: number;
-        savedCount: number;
-        totalBytes: number;
         tabs: {
             videoCount: number;
             tab: "videos" | "shorts" | "streams";
             savedCount: number;
         }[];
+        savedCount: number;
+        totalBytes: number;
     }>;
 };
 /**

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

@@ -3,13 +3,15 @@ import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 export declare const fetchVideosSchema: {
     url: z.ZodString;
     limit: z.ZodDefault<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
 };
 export declare const fetchVideosOutputSchema: {
-    total: z.ZodNumber;
     count: z.ZodNumber;
-    offset: z.ZodNumber;
     hasMore: z.ZodBoolean;
-    nextOffset: z.ZodOptional<z.ZodNumber>;
+    nextCursor: z.ZodOptional<z.ZodString>;
+    total: z.ZodOptional<z.ZodNumber>;
+    totalSource: z.ZodOptional<z.ZodEnum<["youtube:playlist_count", "local-store", "source-exhausted"]>>;
+    driftDetected: z.ZodBoolean;
     source: z.ZodString;
     videos: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
@@ -43,8 +45,17 @@ export declare const fetchVideosOutputSchema: {
         thumbnailUrl?: string | undefined;
     }>, "many">;
 };
-export declare function fetchVideosHandler({ url, limit, }: {
+/**
+ * One page of a playlist or channel listing.
+ *
+ * Previously this reported `total` as the number of videos it happened to
+ * return, so a caller asking for 20 of a 5,000-video channel was told it had
+ * all 5,000 — `hasMore` was structurally false. Now `total` is only present
+ * when YouTube states one, and its absence means unknown rather than none.
+ */
+export declare function fetchVideosHandler({ url, limit, cursor, }: {
     url: string;
     limit: number;
+    cursor?: string;
 }): Promise<CallToolResult>;
 //# sourceMappingURL=fetch-videos.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"fetch-videos.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-videos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,iBAAiB;;;CAa7B,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAInC,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,EACvC,GAAG,EACH,KAAK,GACN,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC,cAAc,CAAC,CA0B1B"}
+{"version":3,"file":"fetch-videos.d.ts","sourceRoot":"","sources":["../../src/tools/fetch-videos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,iBAAiB;;;;CAmB7B,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAInC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,EACvC,GAAG,EACH,KAAK,EACL,MAAM,GACP,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,cAAc,CAAC,CA2D1B"}

package/dist/tools/fetch-videos.js

@@ -1,7 +1,9 @@
 import { z } from 'zod';
 import { listVideos } from '../utils/youtube.js';
-import { pageInfo, toolResult } from '../utils/format.js';
-import { paginationShape, videoSummarySchema } from '../schemas.js';
+import { toolResult } from '../utils/format.js';
+import { cursorPageShape, videoSummarySchema } from '../schemas.js';
+import { decodeCursor, encodeCursor } from '../utils/listing-cursor.js';
+import { playlistTotal } from '../utils/youtube-channel.js';
 export const fetchVideosSchema = {
     url: z
         .string()
@@ -9,38 +11,77 @@ export const fetchVideosSchema = {
         .describe('YouTube playlist URL, channel URL, or channel handle (e.g., https://www.youtube.com/@channel)'),
     limit: z
         .number()
+        .int()
         .min(1)
-        .max(100)
+        .max(500)
         .default(20)
-        .describe('Maximum number of videos to return (1-100, default: 20)'),
+        .describe('Videos per page (1-500, default 20)'),
+    cursor: z
+        .string()
+        .max(512)
+        .optional()
+        .describe('Opaque token from a previous nextCursor. Omit for the first page.'),
 };
 export const fetchVideosOutputSchema = {
     source: z.string(),
     videos: z.array(videoSummarySchema),
-    ...paginationShape,
+    ...cursorPageShape,
 };
-export async function fetchVideosHandler({ url, limit, }) {
-    const videos = await listVideos(url, limit);
-    const lines = [`✓ Found ${videos.length} video${videos.length !== 1 ? 's' : ''}`, ''];
-    videos.forEach((v, i) => {
-        lines.push(`${i + 1}. ${v.title}`);
-        lines.push(`   ${v.durationFormatted} · ${v.uploadDate || 'Unknown date'}`);
-        lines.push(`   ${v.url}`);
+/**
+ * One page of a playlist or channel listing.
+ *
+ * Previously this reported `total` as the number of videos it happened to
+ * return, so a caller asking for 20 of a 5,000-video channel was told it had
+ * all 5,000 — `hasMore` was structurally false. Now `total` is only present
+ * when YouTube states one, and its absence means unknown rather than none.
+ */
+export async function fetchVideosHandler({ url, limit, cursor, }) {
+    const position = cursor === undefined ? { v: 1, start: 1, anchor: '' } : decodeCursor(cursor);
+    const [page, total] = await Promise.all([
+        listVideos(url, limit, position.start),
+        playlistTotal(url),
+    ]);
+    // A new upload shifts every index by one, so the item we ended on can
+    // reappear at the top of the next page. Dropping it is the honest fix; yt-dlp
+    // cannot offer a cursor stable against edits.
+    const driftDetected = position.anchor !== '' && page.some((video) => video.id === position.anchor);
+    const videos = driftDetected ? page.filter((video) => video.id !== position.anchor) : page;
+    const nextStart = position.start + page.length;
+    const hasMore = total === undefined ? page.length === limit : nextStart <= total && page.length > 0;
+    const last = videos.at(-1);
+    const lines = [
+        `✓ ${String(videos.length)} video${videos.length === 1 ? '' : 's'}${total === undefined ? '' : ` of ${String(total)}`}`,
+        ...(total === undefined && hasMore
+            ? ['YouTube states no total for this listing, so the number remaining is unknown.']
+            : []),
+        ...(driftDetected ? ['The listing changed between pages; a duplicate was dropped.'] : []),
+        '',
+    ];
+    videos.forEach((video, index) => {
+        lines.push(`${String(position.start + index)}. ${video.title}`);
+        lines.push(`   ${video.durationFormatted} · ${video.uploadDate || 'Unknown date'}`);
+        lines.push(`   ${video.url}`);
         lines.push('');
     });
     return toolResult(lines.join('\n'), {
         source: url,
-        videos: videos.map((v) => ({
-            id: v.id,
-            title: v.title,
-            durationSeconds: v.duration,
-            durationFormatted: v.durationFormatted,
-            url: v.url,
-            uploadDate: v.uploadDate,
-            ...(v.thumbnailUrl === undefined ? {} : { thumbnailUrl: v.thumbnailUrl }),
-            ...(v.viewCount === undefined ? {} : { viewCount: v.viewCount }),
+        videos: videos.map((video) => ({
+            id: video.id,
+            title: video.title,
+            durationSeconds: video.duration,
+            durationFormatted: video.durationFormatted,
+            url: video.url,
+            uploadDate: video.uploadDate,
+            ...(video.thumbnailUrl === undefined ? {} : { thumbnailUrl: video.thumbnailUrl }),
+            ...(video.viewCount === undefined ? {} : { viewCount: video.viewCount }),
         })),
-        ...pageInfo(videos.length, videos.length),
+        count: videos.length,
+        hasMore,
+        ...(hasMore && last !== undefined
+            ? { nextCursor: encodeCursor({ v: 1, start: nextStart, anchor: last.id }) }
+            : {}),
+        ...(total === undefined ? {} : { total, totalSource: 'youtube:playlist_count' }),
+        driftDetected,
     });
 }
 //# sourceMappingURL=fetch-videos.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"fetch-videos.js","sourceRoot":"","sources":["../../src/tools/fetch-videos.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGpE,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,CAAC,IAAI,CAAC;SACT,QAAQ,CACP,+FAA+F,CAChG;IACH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,yDAAyD,CAAC;CACvE,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC;IACnC,GAAG,eAAe;CACnB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EACvC,GAAG,EACH,KAAK,GAIN;IACC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAE5C,MAAM,KAAK,GAAa,CAAC,WAAW,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;IAEhG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACtB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,iBAAiB,MAAM,CAAC,CAAC,UAAU,IAAI,cAAc,EAAE,CAAC,CAAC;QAC5E,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAClC,MAAM,EAAE,GAAG;QACX,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACzB,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,eAAe,EAAE,CAAC,CAAC,QAAQ;YAC3B,iBAAiB,EAAE,CAAC,CAAC,iBAAiB;YACtC,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,GAAG,CAAC,CAAC,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,CAAC;YACzE,GAAG,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,CAAC;SACjE,CAAC,CAAC;QACH,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"fetch-videos.js","sourceRoot":"","sources":["../../src/tools/fetch-videos.ts"],"names":[],"mappings":"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"}

package/dist/tools/frames-subtitles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frames-subtitles.d.ts","sourceRoot":"","sources":["../../src/tools/frames-subtitles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE;;;GAGG;AAIH,eAAO,MAAM,kBAAkB;;;;;CAQ9B,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;CAKpC,CAAC;AAEF,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,KAAK,GAAG,KAAK,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,cAAc,CAAC,CA4B1B;AAID,eAAO,MAAM,qBAAqB;;;;;CAajC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;CAMvC,CAAC;AAEF,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,cAAc,CAAC,CA2C1B"}
+{"version":3,"file":"frames-subtitles.d.ts","sourceRoot":"","sources":["../../src/tools/frames-subtitles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE;;;GAGG;AAIH,eAAO,MAAM,kBAAkB;;;;;CAQ9B,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;CAKpC,CAAC;AAEF,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,KAAK,GAAG,KAAK,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,cAAc,CAAC,CAqC1B;AAID,eAAO,MAAM,qBAAqB;;;;;CAajC,CAAC;AAEF,eAAO,MAAM,2BAA2B;;;;;;CAMvC,CAAC;AAEF,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,cAAc,CAAC,CA2C1B"}

package/dist/tools/frames-subtitles.js

@@ -1,7 +1,8 @@
 import { z } from 'zod';
 import { join } from 'node:path';
-import { mkdir, writeFile } from 'node:fs/promises';
-import { fileResult } from '../utils/format.js';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { fileResult, imageBlock } from '../utils/format.js';
+import { MAX_INLINE_IMAGE_BYTES } from '../utils/image-fetch.js';
 import { parseTimestamp, resolveOutputDir } from '../utils/validate.js';
 import { extractFrame, safeStem, subtitlesDir } from '../utils/clips.js';
 import { getTranscript } from '../utils/youtube.js';
@@ -32,23 +33,30 @@ export async function extractFrameHandler(args) {
         outputDir: args.outputDir,
         format: args.format,
     });
-    return fileResult([
+    // The file is the deliverable; showing it to the model too is what lets it answer
+    // "what is on screen" without a human opening the image.
+    const mimeType = args.format === 'png' ? 'image/png' : 'image/jpeg';
+    const bytes = await readFile(result.filePath);
+    const isInline = bytes.byteLength <= MAX_INLINE_IMAGE_BYTES;
+    const captured = fileResult([
         '✓ Frame captured',
         '',
         result.title,
         `at ${formatTimestamp(result.timestamp)}`,
         '',
         result.filePath,
+        ...(isInline
+            ? []
+            : ['', 'This frame is too large to show inline: open the file, or capture as jpg.']),
     ].join('\n'), {
         videoId: result.videoId,
         title: result.title,
         filePath: result.filePath,
         timestampSeconds: result.timestamp,
-    }, {
-        path: result.filePath,
-        name: `${result.title} frame`,
-        mimeType: args.format === 'png' ? 'image/png' : 'image/jpeg',
-    });
+    }, { path: result.filePath, name: `${result.title} frame`, mimeType });
+    return isInline
+        ? { ...captured, content: [...captured.content, imageBlock(bytes, mimeType)] }
+        : captured;
 }
 // -- export_subtitles ----------------------------------------------------
 export const exportSubtitlesSchema = {

package/dist/tools/frames-subtitles.js.map

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

package/dist/tools/frames.d.ts

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const extractFramesSchema: {
+    width: z.ZodDefault<z.ZodNumber>;
+    start: z.ZodOptional<z.ZodString>;
+    end: z.ZodOptional<z.ZodString>;
+    video: z.ZodString;
+    timestamps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    count: z.ZodOptional<z.ZodNumber>;
+};
+export declare const extractFramesOutputSchema: {
+    videoId: z.ZodString;
+    title: z.ZodString;
+    width: z.ZodNumber;
+    frames: z.ZodArray<z.ZodObject<{
+        timestampSeconds: z.ZodNumber;
+        timestamp: z.ZodString;
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        timestamp: string;
+        timestampSeconds: number;
+    }, {
+        url: string;
+        timestamp: string;
+        timestampSeconds: number;
+    }>, "many">;
+};
+export interface ExtractFramesArgs {
+    video: string;
+    timestamps?: string[];
+    count?: number;
+    start?: string;
+    end?: string;
+    width: number;
+}
+export declare function extractFramesHandler(args: ExtractFramesArgs): Promise<CallToolResult>;
+export declare const contactSheetSchema: {
+    columns: z.ZodDefault<z.ZodNumber>;
+    start: z.ZodOptional<z.ZodString>;
+    end: z.ZodOptional<z.ZodString>;
+    video: z.ZodString;
+    count: z.ZodDefault<z.ZodNumber>;
+};
+export declare const contactSheetOutputSchema: {
+    videoId: z.ZodString;
+    title: z.ZodString;
+    columns: z.ZodNumber;
+    rows: z.ZodNumber;
+    mimeType: z.ZodString;
+    cells: z.ZodArray<z.ZodObject<{
+        timestampSeconds: z.ZodNumber;
+        timestamp: z.ZodString;
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        timestamp: string;
+        timestampSeconds: number;
+    }, {
+        url: string;
+        timestamp: string;
+        timestampSeconds: number;
+    }>, "many">;
+};
+export interface ContactSheetArgs {
+    video: string;
+    count: number;
+    start?: string;
+    end?: string;
+    columns: number;
+}
+export declare function contactSheetHandler(args: ContactSheetArgs): Promise<CallToolResult>;
+//# sourceMappingURL=frames.d.ts.map

package/dist/tools/frames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frames.d.ts","sourceRoot":"","sources":["../../src/tools/frames.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAmCzE,eAAO,MAAM,mBAAmB;;;;;;;CAwB/B,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;CAKrC,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC,CA2B3F;AAID,eAAO,MAAM,kBAAkB;;;;;;CAmB9B,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;CASpC,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAuCzF"}

package/dist/tools/frames.js

@@ -0,0 +1,136 @@
+import { z } from 'zod';
+import { imageBlock } from '../utils/format.js';
+import { parseOptionalTimestamp, parseTimestamp } from '../utils/validate.js';
+import { DEFAULT_FRAME_WIDTH, MAX_FRAMES_PER_CALL, captureFrames } from '../utils/frames.js';
+import { DEFAULT_SHEET_COLUMNS, MAX_SHEET_FRAMES, captureContactSheet, } from '../utils/contact-sheet.js';
+import { formatTimestamp } from '../utils/transcript.js';
+import { videoMoment, videoMomentSchema } from '../utils/moment.js';
+/**
+ * Looking at a video: stills and contact sheets returned as images the model can
+ * read, rather than files a person has to open.
+ */
+const JPEG_MIME = 'image/jpeg';
+const DEFAULT_SHEET_FRAMES = 12;
+const MAX_SHEET_COLUMNS = 8;
+const WINDOW_FIELDS = {
+    start: z.string().optional().describe('Window start. Seconds, MM:SS or HH:MM:SS. Default: 0.'),
+    end: z
+        .string()
+        .optional()
+        .describe('Window end. Seconds, MM:SS or HH:MM:SS. Default: the end of the video.'),
+};
+function textBlock(text) {
+    return { type: 'text', text };
+}
+// -- extract_frames ------------------------------------------------------
+export const extractFramesSchema = {
+    video: z.string().describe('YouTube video ID or full URL'),
+    timestamps: z
+        .array(z.string())
+        .max(MAX_FRAMES_PER_CALL)
+        .optional()
+        .describe(`Exact moments to look at, each as seconds, MM:SS or HH:MM:SS. Up to ${MAX_FRAMES_PER_CALL}. Use this after search_transcript or get_chapters.`),
+    count: z
+        .number()
+        .int()
+        .min(1)
+        .max(MAX_FRAMES_PER_CALL)
+        .optional()
+        .describe('Instead of timestamps: this many frames spread evenly across the window.'),
+    ...WINDOW_FIELDS,
+    width: z
+        .number()
+        .int()
+        .min(160)
+        .max(1280)
+        .default(DEFAULT_FRAME_WIDTH)
+        .describe(`Frame width in pixels, never enlarged. Default: ${DEFAULT_FRAME_WIDTH}`),
+};
+export const extractFramesOutputSchema = {
+    videoId: z.string(),
+    title: z.string(),
+    width: z.number().int(),
+    frames: z.array(videoMomentSchema).describe('One per image, in the order the images appear'),
+};
+export async function extractFramesHandler(args) {
+    const { video, count, width } = args;
+    const timestamps = args.timestamps?.map((value) => parseTimestamp(value, 'timestamps'));
+    const batch = await captureFrames(video, {
+        timestamps,
+        count,
+        start: parseOptionalTimestamp(args.start, 'start'),
+        end: parseOptionalTimestamp(args.end, 'end'),
+    }, { width, maxFrames: MAX_FRAMES_PER_CALL, label: 'Frame capture' });
+    const moments = batch.frames.map((frame) => videoMoment(batch.videoId, frame.timestamp));
+    return {
+        content: [
+            textBlock(`${batch.title}: ${batch.frames.length} frames, ${width}px wide`),
+            ...batch.frames.flatMap((frame) => [
+                textBlock(`At ${formatTimestamp(frame.timestamp)}`),
+                imageBlock(frame.bytes, JPEG_MIME),
+            ]),
+        ],
+        structuredContent: { videoId: batch.videoId, title: batch.title, width, frames: moments },
+    };
+}
+// -- contact_sheet -------------------------------------------------------
+export const contactSheetSchema = {
+    video: z.string().describe('YouTube video ID or full URL'),
+    count: z
+        .number()
+        .int()
+        .min(1)
+        .max(MAX_SHEET_FRAMES)
+        .default(DEFAULT_SHEET_FRAMES)
+        .describe(`How many frames to tile, spread evenly across the window. Up to ${MAX_SHEET_FRAMES}. Default: ${DEFAULT_SHEET_FRAMES}`),
+    ...WINDOW_FIELDS,
+    columns: z
+        .number()
+        .int()
+        .min(1)
+        .max(MAX_SHEET_COLUMNS)
+        .default(DEFAULT_SHEET_COLUMNS)
+        .describe(`Cells per row. Default: ${DEFAULT_SHEET_COLUMNS}`),
+};
+export const contactSheetOutputSchema = {
+    videoId: z.string(),
+    title: z.string(),
+    columns: z.number().int(),
+    rows: z.number().int(),
+    mimeType: z.string(),
+    cells: z
+        .array(videoMomentSchema)
+        .describe('The moment each cell shows, left to right then top to bottom'),
+};
+export async function contactSheetHandler(args) {
+    const { video, count, columns } = args;
+    const sheet = await captureContactSheet(video, {
+        count,
+        start: parseOptionalTimestamp(args.start, 'start'),
+        end: parseOptionalTimestamp(args.end, 'end'),
+    }, columns);
+    const readings = sheet.timestamps.map(formatTimestamp);
+    const legend = Array.from({ length: sheet.rows }, (_, row) => {
+        const cells = readings.slice(row * sheet.columns, (row + 1) * sheet.columns);
+        return `Row ${row + 1}: ${cells.join(', ')}`;
+    });
+    return {
+        content: [
+            textBlock([
+                `${sheet.title}: contact sheet, ${sheet.timestamps.length} frames in ${sheet.rows} rows`,
+                'Read left to right, top to bottom.',
+                ...legend,
+            ].join('\n')),
+            imageBlock(sheet.bytes, JPEG_MIME),
+        ],
+        structuredContent: {
+            videoId: sheet.videoId,
+            title: sheet.title,
+            columns: sheet.columns,
+            rows: sheet.rows,
+            mimeType: JPEG_MIME,
+            cells: sheet.timestamps.map((seconds) => videoMoment(sheet.videoId, seconds)),
+        },
+    };
+}
+//# sourceMappingURL=frames.js.map