youtube-knowledge-mcp 3.0.0 → 3.0.2

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":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC3F,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,MAAM,IAAI,GAAG;IACX,IAAI,EAAE,kBAAkB;IACxB,GAAG,EAAE,UAAU;IACf,QAAQ,EAAE,eAAe;CACjB,CAAC;AAEX,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,OAAO,EAAE,CAAC;SACP,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;SAC5B,QAAQ,CAAC,+EAA+E,CAAC;IAC5F,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;SACjC,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,CACP,iLAAiL,CAClL;IACH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IACvE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IAClF,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,eAAe,CAAC;SACpB,OAAO,CAAC,mBAAmB,CAAC;SAC5B,QAAQ,CACP,2BAA2B,eAAe,CAAC,cAAc,CAAC,OAAO,CAAC,eAAe,mBAAmB,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,CAC/H;IACH,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,8DAA8D,CAAC;CAC5E,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IACtF,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACvC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;IAC/C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;IACrE,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IAC7E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACvB,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IACnF,cAAc,EAAE,CAAC;SACd,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,CAAC,mEAAmE,CAAC;IAChF,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;CAC5F,CAAC;AAWF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAoB;IAC1D,MAAM,KAAK,GAAG,MAAM,QAAQ,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAE7C,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;IACjF,MAAM,KAAK,GAAG;QACZ,cAAc,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,MAAM,GAAG;QACnI,EAAE;QACF,MAAM,CAAC,QAAQ;QACf,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,aAAa,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;QAClF,GAAG,CAAC,MAAM,CAAC,SAAS;YAClB,CAAC,CAAC;gBACE,EAAE;gBACF,kBAAkB,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,iDAAiD;aACxH;YACH,CAAC,CAAC,EAAE,CAAC;QACP,EAAE;QACF,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;YAC9B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,UAAU,KAAK,CAAC;gBAChB,CAAC,CAAC,CAAC,2CAA2C,CAAC;gBAC/C,CAAC,CAAC;oBACE,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,aAAa,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,cAAc;oBACpH,yCAAyC,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,iBAAiB,GAAG;iBAC3G,CAAC;QACR,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC;YACpC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,mBAAmB,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,wCAAwC;aAC5F,CAAC;QACN,GAAG,CAAC,MAAM,CAAC,eAAe,KAAK,CAAC;YAC9B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,wCAAwC,CAAC,CAAC;KACjF,CAAC;IAEF,OAAO,UAAU,CACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAC1B;QACE,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,GAAG,CAAC,MAAM,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC;QACnF,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,eAAe,EAAE,MAAM,CAAC,eAAe;KACxC,EACD,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,OAAO,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAC3F,CAAC;AACJ,CAAC"}

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

package/dist/tools/frames.js.map

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

package/dist/tools/get-channel-info.d.ts

@@ -12,6 +12,8 @@ export declare const getChannelInfoOutputSchema: {
     description: z.ZodString;
     avatarUrl: z.ZodOptional<z.ZodString>;
     bannerUrl: z.ZodOptional<z.ZodString>;
+    isVerified: z.ZodOptional<z.ZodBoolean>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 };
 export declare function getChannelInfoHandler({ channel, }: {
     channel: string;

package/dist/tools/get-channel-info.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-channel-info.d.ts","sourceRoot":"","sources":["../../src/tools/get-channel-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,oBAAoB;;CAKhC,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;CAA0B,CAAC;AAElE,wBAAsB,qBAAqB,CAAC,EAC1C,OAAO,GACR,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,cAAc,CAAC,CAmB1B"}
+{"version":3,"file":"get-channel-info.d.ts","sourceRoot":"","sources":["../../src/tools/get-channel-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,oBAAoB;;CAKhC,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;;;;;;;;CAA0B,CAAC;AAElE,wBAAsB,qBAAqB,CAAC,EAC1C,OAAO,GACR,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,cAAc,CAAC,CAqB1B"}

package/dist/tools/get-channel-info.js

@@ -17,6 +17,10 @@ export async function getChannelInfoHandler({ channel, }) {
         `${formatCount(info.subscriberCount)} subscribers`,
         info.channelUrl,
     ].filter(Boolean);
+    if (info.isVerified === true)
+        lines.push('Verified');
+    if (info.tags !== undefined)
+        lines.push(`Keywords: ${info.tags.join(', ')}`);
     if (info.avatarUrl !== undefined)
         lines.push(`Avatar: ${info.avatarUrl}`);
     if (info.bannerUrl !== undefined)

package/dist/tools/get-channel-info.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-channel-info.js","sourceRoot":"","sources":["../../src/tools/get-channel-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CAAC,gEAAgE,CAAC;CAC9E,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG,iBAAiB,CAAC,KAAK,CAAC;AAElE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,EAC1C,OAAO,GAGR;IACC,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IAE3C,MAAM,KAAK,GAAa;QACtB,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QAC9B,GAAG,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC,cAAc;QAClD,IAAI,CAAC,UAAU;KAChB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElB,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAC1E,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAE1E,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC"}
+{"version":3,"file":"get-channel-info.js","sourceRoot":"","sources":["../../src/tools/get-channel-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAGlD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CAAC,gEAAgE,CAAC;CAC9E,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG,iBAAiB,CAAC,KAAK,CAAC;AAElE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,EAC1C,OAAO,GAGR;IACC,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IAE3C,MAAM,KAAK,GAAa;QACtB,IAAI,CAAC,IAAI;QACT,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QAC9B,GAAG,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC,cAAc;QAClD,IAAI,CAAC,UAAU;KAChB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElB,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7E,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAC1E,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAE1E,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC"}

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

@@ -205,7 +205,7 @@ export declare const getCommentsOutputSchema: {
         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"]>>;
+        expectedSource: z.ZodOptional<z.ZodEnum<["youtube:comment_count", "youtube:playlist_count", "source-exhausted", "store:catalog"]>>;
         ranToExhaustion: z.ZodOptional<z.ZodBoolean>;
         source: z.ZodString;
         harvestedAt: z.ZodString;
@@ -215,33 +215,33 @@ export declare const getCommentsOutputSchema: {
         resumeToken: z.ZodOptional<z.ZodString>;
         note: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
+        source: string;
         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;
+        expectedSource?: "youtube:playlist_count" | "source-exhausted" | "youtube:comment_count" | "store:catalog" | undefined;
         staleAfter?: string | undefined;
         limitApplied?: number | undefined;
         sortApplied?: "top" | "new" | undefined;
         resumeToken?: string | undefined;
     }, {
+        source: string;
         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;
+        expectedSource?: "youtube:playlist_count" | "source-exhausted" | "youtube:comment_count" | "store:catalog" | undefined;
         staleAfter?: string | undefined;
         limitApplied?: number | undefined;
         sortApplied?: "top" | "new" | undefined;

package/dist/tools/get-coverage.d.ts

@@ -20,7 +20,7 @@ export declare const getCoverageOutputSchema: {
         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"]>>;
+        expectedSource: z.ZodOptional<z.ZodEnum<["youtube:comment_count", "youtube:playlist_count", "source-exhausted", "store:catalog"]>>;
         ranToExhaustion: z.ZodOptional<z.ZodBoolean>;
         source: z.ZodString;
         harvestedAt: z.ZodString;
@@ -30,33 +30,33 @@ export declare const getCoverageOutputSchema: {
         resumeToken: z.ZodOptional<z.ZodString>;
         note: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
+        source: string;
         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;
+        expectedSource?: "youtube:playlist_count" | "source-exhausted" | "youtube:comment_count" | "store:catalog" | undefined;
         staleAfter?: string | undefined;
         limitApplied?: number | undefined;
         sortApplied?: "top" | "new" | undefined;
         resumeToken?: string | undefined;
     }, {
+        source: string;
         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;
+        expectedSource?: "youtube:playlist_count" | "source-exhausted" | "youtube:comment_count" | "store:catalog" | undefined;
         staleAfter?: string | undefined;
         limitApplied?: number | undefined;
         sortApplied?: "top" | "new" | undefined;

package/dist/tools/get-sponsor-segments.d.ts

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { SPONSOR_CATEGORIES } from '../utils/sponsorblock.js';
+/**
+ * Where a video sells something or repeats itself, according to the SponsorBlock
+ * community. It is their data, not YouTube's, and the result says so.
+ */
+export declare const getSponsorSegmentsSchema: {
+    video: z.ZodString;
+    categories: z.ZodOptional<z.ZodArray<z.ZodEnum<["sponsor", "selfpromo", "interaction", "intro", "outro", "preview", "music_offtopic", "filler"]>, "many">>;
+};
+export declare const getSponsorSegmentsOutputSchema: {
+    videoId: z.ZodString;
+    source: z.ZodLiteral<"sponsorblock">;
+    count: z.ZodNumber;
+    coveredSeconds: z.ZodNumber;
+    segments: z.ZodArray<z.ZodObject<Omit<{
+        timestampSeconds: z.ZodNumber;
+        timestamp: z.ZodString;
+        url: z.ZodString;
+    }, "timestampSeconds"> & {
+        category: z.ZodString;
+        startSeconds: z.ZodNumber;
+        endSeconds: z.ZodNumber;
+        durationSeconds: z.ZodNumber;
+        votes: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        durationSeconds: number;
+        url: string;
+        startSeconds: number;
+        endSeconds: number;
+        timestamp: string;
+        category: string;
+        votes: number;
+    }, {
+        durationSeconds: number;
+        url: string;
+        startSeconds: number;
+        endSeconds: number;
+        timestamp: string;
+        category: string;
+        votes: number;
+    }>, "many">;
+};
+export declare function getSponsorSegmentsHandler(args: {
+    video: string;
+    categories?: (typeof SPONSOR_CATEGORIES)[number][];
+}): Promise<CallToolResult>;
+//# sourceMappingURL=get-sponsor-segments.d.ts.map

package/dist/tools/get-sponsor-segments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-sponsor-segments.d.ts","sourceRoot":"","sources":["../../src/tools/get-sponsor-segments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGzE,OAAO,EAAE,kBAAkB,EAAwC,MAAM,0BAA0B,CAAC;AAIpG;;;GAGG;AAEH,eAAO,MAAM,wBAAwB;;;CASpC,CAAC;AAUF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAM1C,CAAC;AAEF,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;CACpD,GAAG,OAAO,CAAC,cAAc,CAAC,CAsC1B"}