youtube-knowledge-mcp 2.0.2 → 2.2.0

package/dist/tools/ask-brain.js

@@ -0,0 +1,70 @@
+import { z } from 'zod';
+import { brainPassageSchema } from '../brain-schemas.js';
+import { searchBrain } from '../utils/brain-index.js';
+import { resolveBrain } from '../utils/brain-lookup.js';
+import { pageInfo, toolResult } from '../utils/format.js';
+import { paginationShape } from '../schemas.js';
+export const askBrainSchema = {
+    channel: z.string().describe('Channel URL, @handle, or name of a brain built with build_brain'),
+    query: z
+        .string()
+        .min(1)
+        .describe('What to look for. Matched against the words actually spoken, not a summary of them'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(25)
+        .default(8)
+        .describe('How many passages to return. Default: 8'),
+    offset: z
+        .number()
+        .int()
+        .min(0)
+        .default(0)
+        .describe('Skip this many of the ranked passages, for paging. Default: 0'),
+};
+export const askBrainOutputSchema = {
+    channelId: z.string(),
+    name: z.string(),
+    query: z.string(),
+    passages: z.array(brainPassageSchema),
+    ...paginationShape,
+};
+/**
+ * Search a brain and return the moments that answer the query.
+ *
+ * This is the only route from a corpus into a model's context: a few hundred
+ * videos is tens of megabytes of transcript, and no tool here will hand that
+ * over. Every passage comes back with the second it was said and a link that
+ * opens the video there, so an answer built from these can be checked rather
+ * than trusted.
+ */
+export async function askBrainHandler({ channel, query, limit, offset, }) {
+    const manifest = await resolveBrain(channel);
+    const { channelId, name } = manifest.channel;
+    const { passages, total } = await searchBrain(channelId, query, limit, offset);
+    return toolResult(render(name, query, passages, total), {
+        channelId,
+        name,
+        query,
+        passages,
+        ...pageInfo(total, passages.length, offset),
+    });
+}
+function render(name, query, passages, total) {
+    if (passages.length === 0) {
+        return [
+            `Nothing in ${name}'s brain matches "${query}".`,
+            '',
+            'The words are matched as spoken, so try the phrasing the creator would use.',
+            'Call get_brain_info to see how much of the channel is actually indexed.',
+        ].join('\n');
+    }
+    const sections = passages.map((passage) => [`### ${passage.title} [${passage.startFormatted}]`, passage.url, '', passage.text].join('\n'));
+    const heading = passages.length === total
+        ? `${total} passages from ${name} matching "${query}"`
+        : `${passages.length} of ${total} passages from ${name} matching "${query}" — pass offset to see more`;
+    return [heading, '', ...sections].join('\n\n');
+}
+//# sourceMappingURL=ask-brain.js.map

package/dist/tools/ask-brain.js.map

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

package/dist/tools/batch.d.ts

@@ -24,16 +24,16 @@ export declare const getTranscriptsOutputSchema: {
     }, "strip", z.ZodTypeAny, {
         video: string;
         text?: string | undefined;
-        error?: string | undefined;
         videoId?: string | undefined;
+        error?: string | undefined;
         language?: string | undefined;
         truncated?: boolean | undefined;
         totalChars?: number | undefined;
     }, {
         video: string;
         text?: string | undefined;
-        error?: string | undefined;
         videoId?: string | undefined;
+        error?: string | undefined;
         language?: string | undefined;
         truncated?: boolean | undefined;
         totalChars?: number | undefined;
@@ -74,29 +74,29 @@ export declare const digestPlaylistOutputSchema: {
         transcriptWords: z.ZodOptional<z.ZodNumber>;
         transcriptError: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        url: string;
-        title: string;
         id: string;
+        title: string;
         durationFormatted: string;
+        url: string;
+        viewCount?: number | undefined;
+        uploadDate?: string | undefined;
         chapters?: {
             title: string;
             startSeconds: number;
         }[] | undefined;
-        uploadDate?: string | undefined;
-        viewCount?: number | undefined;
         transcriptWords?: number | undefined;
         transcriptError?: string | undefined;
     }, {
-        url: string;
-        title: string;
         id: string;
+        title: string;
         durationFormatted: string;
+        url: string;
+        viewCount?: number | undefined;
+        uploadDate?: string | undefined;
         chapters?: {
             title: string;
             startSeconds: number;
         }[] | undefined;
-        uploadDate?: string | undefined;
-        viewCount?: number | undefined;
         transcriptWords?: number | undefined;
         transcriptError?: string | undefined;
     }>, "many">;

package/dist/tools/batch.js

@@ -3,7 +3,7 @@ import { getChapters, getTranscript, getVideoInfo, listVideos } from '../utils/y
 import { toolResult } from '../utils/format.js';
 import { asYouTubeError } from '../utils/errors.js';
 import { reportProgress, throwIfAborted } from '../utils/context.js';
-import { formatTimestamp, segmentsToText, windowText } from '../utils/transcript.js';
+import { countWords, formatTimestamp, segmentsToText, windowText } from '../utils/transcript.js';
 /**
  * Multi-video operations.
  *
@@ -82,7 +82,7 @@ export async function getTranscriptsHandler({ videos, language, maxCharsPerVideo
 }
 // -- digest_playlist -----------------------------------------------------
 export const digestPlaylistSchema = {
-    url: z.string().describe('Playlist or channel URL'),
+    url: z.string().max(2048).describe('Playlist or channel URL'),
     limit: z
         .number()
         .int()
@@ -164,7 +164,7 @@ export async function digestPlaylistHandler({ url, limit, includeChapters, inclu
         if (includeTranscriptStats) {
             try {
                 const transcript = await getTranscript(video.id);
-                const words = segmentsToText(transcript.segments).split(/\s+/).filter(Boolean).length;
+                const words = countWords(segmentsToText(transcript.segments));
                 lines.push(`transcript: ${words.toLocaleString()} words (${transcript.language})`);
                 entry.transcriptWords = words;
             }

package/dist/tools/batch.js.map

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

package/dist/tools/brain-info.d.ts

@@ -0,0 +1,180 @@
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Reading what a brain covers: which channels have one, and how much of each
+ * channel it actually reached.
+ */
+export declare const listBrainsSchema: {};
+export declare const listBrainsOutputSchema: {
+    total: z.ZodNumber;
+    count: z.ZodNumber;
+    offset: z.ZodNumber;
+    hasMore: z.ZodBoolean;
+    nextOffset: z.ZodOptional<z.ZodNumber>;
+    brains: z.ZodArray<z.ZodObject<{
+        channelId: z.ZodString;
+        name: z.ZodString;
+        handle: z.ZodString;
+        channelUrl: z.ZodString;
+        language: z.ZodString;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        hasProfile: z.ZodBoolean;
+        videoCount: z.ZodNumber;
+        indexedCount: z.ZodNumber;
+        chunkCount: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        channelId: string;
+        handle: string;
+        channelUrl: string;
+        videoCount: number;
+        chunkCount: number;
+        indexedCount: number;
+        language: string;
+        createdAt: string;
+        updatedAt: string;
+        hasProfile: boolean;
+    }, {
+        name: string;
+        channelId: string;
+        handle: string;
+        channelUrl: string;
+        videoCount: number;
+        chunkCount: number;
+        indexedCount: number;
+        language: string;
+        createdAt: string;
+        updatedAt: string;
+        hasProfile: boolean;
+    }>, "many">;
+};
+export declare function listBrainsHandler(): Promise<CallToolResult>;
+export declare const getBrainInfoSchema: {
+    channel: z.ZodString;
+    includeVideos: z.ZodDefault<z.ZodBoolean>;
+};
+export declare const getBrainInfoOutputSchema: {
+    channelId: z.ZodString;
+    name: z.ZodString;
+    handle: z.ZodString;
+    channelUrl: z.ZodString;
+    language: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    hasProfile: z.ZodBoolean;
+    stats: z.ZodObject<{
+        videoCount: z.ZodNumber;
+        excludedCount: z.ZodNumber;
+        indexedCount: z.ZodNumber;
+        noCaptionsCount: z.ZodNumber;
+        failedCount: z.ZodNumber;
+        pendingCount: z.ZodNumber;
+        chunkCount: z.ZodNumber;
+        totalWords: z.ZodNumber;
+        medianWordsPerMinute: z.ZodNumber;
+        firstUpload: z.ZodOptional<z.ZodString>;
+        lastUpload: z.ZodOptional<z.ZodString>;
+        uploadsPerMonth: z.ZodArray<z.ZodObject<{
+            month: z.ZodString;
+            videos: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            month: string;
+            videos: number;
+        }, {
+            month: string;
+            videos: number;
+        }>, "many">;
+        recurringPhrases: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            phrase: z.ZodString;
+            videoCount: z.ZodNumber;
+            occurrences: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            videoCount: number;
+            phrase: string;
+            occurrences: number;
+        }, {
+            videoCount: number;
+            phrase: string;
+            occurrences: number;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        videoCount: number;
+        chunkCount: number;
+        excludedCount: number;
+        indexedCount: number;
+        noCaptionsCount: number;
+        failedCount: number;
+        pendingCount: number;
+        totalWords: number;
+        medianWordsPerMinute: number;
+        uploadsPerMonth: {
+            month: string;
+            videos: number;
+        }[];
+        firstUpload?: string | undefined;
+        lastUpload?: string | undefined;
+        recurringPhrases?: {
+            videoCount: number;
+            phrase: string;
+            occurrences: number;
+        }[] | undefined;
+    }, {
+        videoCount: number;
+        chunkCount: number;
+        excludedCount: number;
+        indexedCount: number;
+        noCaptionsCount: number;
+        failedCount: number;
+        pendingCount: number;
+        totalWords: number;
+        medianWordsPerMinute: number;
+        uploadsPerMonth: {
+            month: string;
+            videos: number;
+        }[];
+        firstUpload?: string | undefined;
+        lastUpload?: string | undefined;
+        recurringPhrases?: {
+            videoCount: number;
+            phrase: string;
+            occurrences: number;
+        }[] | undefined;
+    }>;
+    videos: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        videoId: z.ZodString;
+        title: z.ZodString;
+        url: z.ZodString;
+        uploadDate: z.ZodString;
+        durationSeconds: z.ZodNumber;
+        state: z.ZodEnum<["pending", "indexed", "no-captions", "failed", "excluded"]>;
+        chunkCount: z.ZodNumber;
+        wordCount: z.ZodNumber;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        durationSeconds: number;
+        url: string;
+        uploadDate: string;
+        videoId: string;
+        state: "pending" | "indexed" | "no-captions" | "failed" | "excluded";
+        chunkCount: number;
+        wordCount: number;
+        error?: string | undefined;
+    }, {
+        title: string;
+        durationSeconds: number;
+        url: string;
+        uploadDate: string;
+        videoId: string;
+        state: "pending" | "indexed" | "no-captions" | "failed" | "excluded";
+        chunkCount: number;
+        wordCount: number;
+        error?: string | undefined;
+    }>, "many">>;
+};
+export declare function getBrainInfoHandler({ channel, includeVideos, }: {
+    channel: string;
+    includeVideos: boolean;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=brain-info.d.ts.map

package/dist/tools/brain-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-info.d.ts","sourceRoot":"","sources":["../../src/tools/brain-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAYzE;;;GAGG;AAIH,eAAO,MAAM,gBAAgB,IAAK,CAAC;AAEnC,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAGlC,CAAC;AAEF,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,cAAc,CAAC,CAgBjE;AAsBD,eAAO,MAAM,kBAAkB;;;CAM9B,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAWpC,CAAC;AAEF,wBAAsB,mBAAmB,CAAC,EACxC,OAAO,EACP,aAAa,GACd,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;CACxB,GAAG,OAAO,CAAC,cAAc,CAAC,CA+D1B"}

package/dist/tools/brain-info.js

@@ -0,0 +1,108 @@
+import { z } from 'zod';
+import { brainStatsSchema, brainSummarySchema, brainVideoStateSchema, } from '../brain-schemas.js';
+import { resolveBrain } from '../utils/brain-lookup.js';
+import { hasProfile, listManifests } from '../utils/brain-storage.js';
+import { pageInfo, toolResult } from '../utils/format.js';
+import { paginationShape } from '../schemas.js';
+/**
+ * Reading what a brain covers: which channels have one, and how much of each
+ * channel it actually reached.
+ */
+// -- list_brains ---------------------------------------------------------
+export const listBrainsSchema = {};
+export const listBrainsOutputSchema = {
+    brains: z.array(brainSummarySchema),
+    ...paginationShape,
+};
+export async function listBrainsHandler() {
+    const manifests = await listManifests();
+    const brains = manifests.map(summarize);
+    const lines = brains.length === 0
+        ? ['No brains have been built yet.', '', 'Call build_brain with a channel URL or handle.']
+        : brains.map((brain) => `${brain.name} (${brain.handle || brain.channelId}) — ${brain.indexedCount}/${brain.videoCount} videos, ${brain.chunkCount.toLocaleString()} passages, updated ${brain.updatedAt.slice(0, 10)}${brain.hasProfile ? ', has a profile' : ''}`);
+    return toolResult(lines.join('\n'), {
+        brains,
+        ...pageInfo(brains.length, brains.length),
+    });
+}
+function summarize(manifest) {
+    const { channelId, name, handle, channelUrl } = manifest.channel;
+    return {
+        channelId,
+        name,
+        handle,
+        channelUrl,
+        language: manifest.language,
+        createdAt: manifest.createdAt,
+        updatedAt: manifest.updatedAt,
+        hasProfile: hasProfile(channelId),
+        videoCount: manifest.stats.videoCount,
+        indexedCount: manifest.stats.indexedCount,
+        chunkCount: manifest.stats.chunkCount,
+    };
+}
+// -- get_brain_info ------------------------------------------------------
+export const getBrainInfoSchema = {
+    channel: z.string().describe('Channel URL, @handle, name, or channel id of an existing brain'),
+    includeVideos: z
+        .boolean()
+        .default(false)
+        .describe('List every video and its state. Long for a large channel. Default: false'),
+};
+export const getBrainInfoOutputSchema = {
+    channelId: z.string(),
+    name: z.string(),
+    handle: z.string(),
+    channelUrl: z.string(),
+    language: z.string(),
+    createdAt: z.string(),
+    updatedAt: z.string(),
+    hasProfile: z.boolean(),
+    stats: brainStatsSchema,
+    videos: z.array(brainVideoStateSchema).optional(),
+};
+export async function getBrainInfoHandler({ channel, includeVideos, }) {
+    const manifest = await resolveBrain(channel);
+    const { channelId, name, handle, channelUrl } = manifest.channel;
+    const { stats } = manifest;
+    const videos = Object.values(manifest.videos);
+    const lines = [
+        `${name} (${handle || channelId})`,
+        `${stats.indexedCount} of ${stats.videoCount} videos indexed from ${manifest.language} captions · ${stats.chunkCount.toLocaleString()} passages · ${stats.totalWords.toLocaleString()} words`,
+        `${stats.medianWordsPerMinute} words per minute (median)`,
+        stats.firstUpload === undefined
+            ? 'No upload dates reported'
+            : `Uploads from ${stats.firstUpload} to ${stats.lastUpload ?? stats.firstUpload}`,
+        `Updated ${manifest.updatedAt}`,
+    ];
+    if (stats.noCaptionsCount > 0)
+        lines.push(`${stats.noCaptionsCount} videos have no captions`);
+    if (stats.excludedCount > 0) {
+        lines.push(`${stats.excludedCount} videos are outside the filters this brain was built with`);
+    }
+    if (stats.failedCount + stats.pendingCount > 0) {
+        lines.push(`${stats.failedCount + stats.pendingCount} videos still to read — call build_brain to continue`);
+    }
+    if (stats.recurringPhrases === undefined) {
+        lines.push('', 'Repeated phrases have not been measured yet — the last build did not finish. Call build_brain to complete it.');
+    }
+    else if (stats.recurringPhrases.length > 0) {
+        lines.push('', 'Phrases repeated across videos:', ...stats.recurringPhrases.map((entry) => `  "${entry.phrase}" — ${entry.videoCount} videos, ${entry.occurrences} times`));
+    }
+    if (includeVideos) {
+        lines.push('', ...videos.map((video) => `${video.state.padEnd(12)} ${video.uploadDate || '          '} ${video.title}${video.error === undefined ? '' : ` (${video.error})`}`));
+    }
+    return toolResult(lines.join('\n'), {
+        channelId,
+        name,
+        handle,
+        channelUrl,
+        language: manifest.language,
+        createdAt: manifest.createdAt,
+        updatedAt: manifest.updatedAt,
+        hasProfile: hasProfile(channelId),
+        stats,
+        ...(includeVideos ? { videos } : {}),
+    });
+}
+//# sourceMappingURL=brain-info.js.map

package/dist/tools/brain-info.js.map

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

package/dist/tools/build-brain.d.ts

@@ -0,0 +1,120 @@
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const buildBrainSchema: {
+    channel: z.ZodString;
+    maxVideos: z.ZodDefault<z.ZodNumber>;
+    language: z.ZodDefault<z.ZodString>;
+    since: z.ZodOptional<z.ZodString>;
+    minDurationSeconds: z.ZodDefault<z.ZodNumber>;
+};
+export declare const buildBrainOutputSchema: {
+    channelId: z.ZodString;
+    name: z.ZodString;
+    handle: z.ZodString;
+    channelUrl: z.ZodString;
+    language: z.ZodString;
+    considered: z.ZodNumber;
+    processed: z.ZodNumber;
+    skipped: z.ZodNumber;
+    excluded: z.ZodNumber;
+    stoppedEarly: z.ZodBoolean;
+    stopReason: z.ZodOptional<z.ZodString>;
+    stats: z.ZodObject<{
+        videoCount: z.ZodNumber;
+        excludedCount: z.ZodNumber;
+        indexedCount: z.ZodNumber;
+        noCaptionsCount: z.ZodNumber;
+        failedCount: z.ZodNumber;
+        pendingCount: z.ZodNumber;
+        chunkCount: z.ZodNumber;
+        totalWords: z.ZodNumber;
+        medianWordsPerMinute: z.ZodNumber;
+        firstUpload: z.ZodOptional<z.ZodString>;
+        lastUpload: z.ZodOptional<z.ZodString>;
+        uploadsPerMonth: z.ZodArray<z.ZodObject<{
+            month: z.ZodString;
+            videos: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            month: string;
+            videos: number;
+        }, {
+            month: string;
+            videos: number;
+        }>, "many">;
+        recurringPhrases: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            phrase: z.ZodString;
+            videoCount: z.ZodNumber;
+            occurrences: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            videoCount: number;
+            phrase: string;
+            occurrences: number;
+        }, {
+            videoCount: number;
+            phrase: string;
+            occurrences: number;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        videoCount: number;
+        chunkCount: number;
+        excludedCount: number;
+        indexedCount: number;
+        noCaptionsCount: number;
+        failedCount: number;
+        pendingCount: number;
+        totalWords: number;
+        medianWordsPerMinute: number;
+        uploadsPerMonth: {
+            month: string;
+            videos: number;
+        }[];
+        firstUpload?: string | undefined;
+        lastUpload?: string | undefined;
+        recurringPhrases?: {
+            videoCount: number;
+            phrase: string;
+            occurrences: number;
+        }[] | undefined;
+    }, {
+        videoCount: number;
+        chunkCount: number;
+        excludedCount: number;
+        indexedCount: number;
+        noCaptionsCount: number;
+        failedCount: number;
+        pendingCount: number;
+        totalWords: number;
+        medianWordsPerMinute: number;
+        uploadsPerMonth: {
+            month: string;
+            videos: number;
+        }[];
+        firstUpload?: string | undefined;
+        lastUpload?: string | undefined;
+        recurringPhrases?: {
+            videoCount: number;
+            phrase: string;
+            occurrences: number;
+        }[] | undefined;
+    }>;
+};
+/**
+ * Build or extend a channel brain.
+ *
+ * Idempotent by construction: it reads what is missing and leaves what is
+ * already there, so calling it again after an interruption continues, and
+ * calling it on a finished brain picks up new uploads. That is also why there
+ * is no separate refresh tool.
+ *
+ * The filters describe the brain rather than just this call, so a build makes
+ * the brain match them: narrowing one discards the passages of videos it now
+ * excludes, and widening it reads them again.
+ */
+export declare function buildBrainHandler({ channel, maxVideos, language, since, minDurationSeconds, }: {
+    channel: string;
+    maxVideos: number;
+    language: string;
+    since?: string;
+    minDurationSeconds: number;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=build-brain.d.ts.map

package/dist/tools/build-brain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-brain.d.ts","sourceRoot":"","sources":["../../src/tools/build-brain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AASzE,eAAO,MAAM,gBAAgB;;;;;;CA6B5B,CAAC;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAalC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAsB,iBAAiB,CAAC,EACtC,OAAO,EACP,SAAS,EACT,QAAQ,EACR,KAAK,EACL,kBAAkB,GACnB,EAAE;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,MAAM,CAAC;CAC5B,GAAG,OAAO,CAAC,cAAc,CAAC,CA+B1B"}