youtube-knowledge-mcp 2.1.0 → 2.2.0

package/dist/utils/youtube-download.js.map

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

package/dist/utils/youtube-schemas.d.ts

@@ -0,0 +1,394 @@
+import { z } from 'zod';
+/**
+ * The shapes yt-dlp's JSON output is checked against.
+ *
+ * Every field is optional or nullable: yt-dlp emits `null` for what it could
+ * not find and omits what it never looked for, and a row missing a field is
+ * still a usable row. What the schemas guarantee is that a field that *is*
+ * present has the type the code reads it as — which the previous "is it an
+ * object" guard did not.
+ */
+/** `--print '%(.{...})j'` for one video: yt-dlp writes `null` for what it did not find. */
+export declare const videoInfoRowSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    duration: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    upload_date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    tags: z.ZodUnknown;
+    thumbnail: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    view_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    like_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    comment_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    availability: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    live_status: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    id?: string | null | undefined;
+    title?: string | null | undefined;
+    channel?: string | null | undefined;
+    description?: string | null | undefined;
+    tags?: unknown;
+    duration?: number | null | undefined;
+    upload_date?: string | null | undefined;
+    thumbnail?: string | null | undefined;
+    view_count?: number | null | undefined;
+    like_count?: number | null | undefined;
+    comment_count?: number | null | undefined;
+    availability?: string | null | undefined;
+    live_status?: string | null | undefined;
+}, {
+    id?: string | null | undefined;
+    title?: string | null | undefined;
+    channel?: string | null | undefined;
+    description?: string | null | undefined;
+    tags?: unknown;
+    duration?: number | null | undefined;
+    upload_date?: string | null | undefined;
+    thumbnail?: string | null | undefined;
+    view_count?: number | null | undefined;
+    like_count?: number | null | undefined;
+    comment_count?: number | null | undefined;
+    availability?: string | null | undefined;
+    live_status?: string | null | undefined;
+}>;
+/** `--print 'after_move:%(.{title,filepath})j'`: where yt-dlp put the finished file. */
+export declare const afterMoveRowSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    filepath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    title?: string | null | undefined;
+    filepath?: string | null | undefined;
+}, {
+    title?: string | null | undefined;
+    filepath?: string | null | undefined;
+}>;
+export declare const chapterRowSchema: z.ZodObject<{
+    title: z.ZodString;
+    start_time: z.ZodNumber;
+    end_time: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    start_time: number;
+    end_time: number;
+}, {
+    title: string;
+    start_time: number;
+    end_time: number;
+}>;
+export declare const videoDetailsRowSchema: z.ZodObject<{
+    chapters: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        start_time: z.ZodNumber;
+        end_time: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        start_time: number;
+        end_time: number;
+    }, {
+        title: string;
+        start_time: number;
+        end_time: number;
+    }>, "many">>>;
+    upload_date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    duration: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    duration?: number | null | undefined;
+    upload_date?: string | null | undefined;
+    chapters?: {
+        title: string;
+        start_time: number;
+        end_time: number;
+    }[] | null | undefined;
+}, {
+    duration?: number | null | undefined;
+    upload_date?: string | null | undefined;
+    chapters?: {
+        title: string;
+        start_time: number;
+        end_time: number;
+    }[] | null | undefined;
+}>;
+export declare const commentRowSchema: z.ZodObject<{
+    author: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    like_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    is_pinned: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    parent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    author?: string | null | undefined;
+    text?: string | null | undefined;
+    parent?: string | null | undefined;
+    like_count?: number | null | undefined;
+    is_pinned?: boolean | null | undefined;
+}, {
+    author?: string | null | undefined;
+    text?: string | null | undefined;
+    parent?: string | null | undefined;
+    like_count?: number | null | undefined;
+    is_pinned?: boolean | null | undefined;
+}>;
+export declare const commentsRowSchema: z.ZodObject<{
+    comments: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        author: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        like_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        is_pinned: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+        parent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        author?: string | null | undefined;
+        text?: string | null | undefined;
+        parent?: string | null | undefined;
+        like_count?: number | null | undefined;
+        is_pinned?: boolean | null | undefined;
+    }, {
+        author?: string | null | undefined;
+        text?: string | null | undefined;
+        parent?: string | null | undefined;
+        like_count?: number | null | undefined;
+        is_pinned?: boolean | null | undefined;
+    }>, "many">>>;
+}, "strip", z.ZodTypeAny, {
+    comments?: {
+        author?: string | null | undefined;
+        text?: string | null | undefined;
+        parent?: string | null | undefined;
+        like_count?: number | null | undefined;
+        is_pinned?: boolean | null | undefined;
+    }[] | null | undefined;
+}, {
+    comments?: {
+        author?: string | null | undefined;
+        text?: string | null | undefined;
+        parent?: string | null | undefined;
+        like_count?: number | null | undefined;
+        is_pinned?: boolean | null | undefined;
+    }[] | null | undefined;
+}>;
+export declare const formatRowSchema: z.ZodObject<{
+    format_id: z.ZodString;
+    ext: z.ZodString;
+    resolution: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    width: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    height: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    fps: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    vcodec: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    acodec: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    filesize: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    filesize_approx: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    format_note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    ext: string;
+    format_id: string;
+    resolution?: string | null | undefined;
+    fps?: number | null | undefined;
+    vcodec?: string | null | undefined;
+    acodec?: string | null | undefined;
+    width?: number | null | undefined;
+    height?: number | null | undefined;
+    filesize?: number | null | undefined;
+    filesize_approx?: number | null | undefined;
+    format_note?: string | null | undefined;
+}, {
+    ext: string;
+    format_id: string;
+    resolution?: string | null | undefined;
+    fps?: number | null | undefined;
+    vcodec?: string | null | undefined;
+    acodec?: string | null | undefined;
+    width?: number | null | undefined;
+    height?: number | null | undefined;
+    filesize?: number | null | undefined;
+    filesize_approx?: number | null | undefined;
+    format_note?: string | null | undefined;
+}>;
+export declare const formatsRowSchema: z.ZodObject<{
+    formats: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        format_id: z.ZodString;
+        ext: z.ZodString;
+        resolution: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        width: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        height: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        fps: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        vcodec: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        acodec: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        filesize: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        filesize_approx: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        format_note: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        ext: string;
+        format_id: string;
+        resolution?: string | null | undefined;
+        fps?: number | null | undefined;
+        vcodec?: string | null | undefined;
+        acodec?: string | null | undefined;
+        width?: number | null | undefined;
+        height?: number | null | undefined;
+        filesize?: number | null | undefined;
+        filesize_approx?: number | null | undefined;
+        format_note?: string | null | undefined;
+    }, {
+        ext: string;
+        format_id: string;
+        resolution?: string | null | undefined;
+        fps?: number | null | undefined;
+        vcodec?: string | null | undefined;
+        acodec?: string | null | undefined;
+        width?: number | null | undefined;
+        height?: number | null | undefined;
+        filesize?: number | null | undefined;
+        filesize_approx?: number | null | undefined;
+        format_note?: string | null | undefined;
+    }>, "many">>>;
+}, "strip", z.ZodTypeAny, {
+    formats?: {
+        ext: string;
+        format_id: string;
+        resolution?: string | null | undefined;
+        fps?: number | null | undefined;
+        vcodec?: string | null | undefined;
+        acodec?: string | null | undefined;
+        width?: number | null | undefined;
+        height?: number | null | undefined;
+        filesize?: number | null | undefined;
+        filesize_approx?: number | null | undefined;
+        format_note?: string | null | undefined;
+    }[] | null | undefined;
+}, {
+    formats?: {
+        ext: string;
+        format_id: string;
+        resolution?: string | null | undefined;
+        fps?: number | null | undefined;
+        vcodec?: string | null | undefined;
+        acodec?: string | null | undefined;
+        width?: number | null | undefined;
+        height?: number | null | undefined;
+        filesize?: number | null | undefined;
+        filesize_approx?: number | null | undefined;
+        format_note?: string | null | undefined;
+    }[] | null | undefined;
+}>;
+export declare const captionTracksSchema: z.ZodObject<{
+    subtitles: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    automatic_captions: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, "strip", z.ZodTypeAny, {
+    subtitles?: Record<string, unknown> | null | undefined;
+    automatic_captions?: Record<string, unknown> | null | undefined;
+}, {
+    subtitles?: Record<string, unknown> | null | undefined;
+    automatic_captions?: Record<string, unknown> | null | undefined;
+}>;
+/**
+ * yt-dlp's search rows. Only `id` is required — the rest are absent often
+ * enough (age-gated entries, deleted uploads still in the index) that treating
+ * them as guaranteed is what produced `undefined` in rendered output.
+ */
+export declare const searchResultSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    duration: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    channel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    view_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    title?: string | null | undefined;
+    url?: string | null | undefined;
+    channel?: string | null | undefined;
+    duration?: number | null | undefined;
+    view_count?: number | null | undefined;
+}, {
+    id: string;
+    title?: string | null | undefined;
+    url?: string | null | undefined;
+    channel?: string | null | undefined;
+    duration?: number | null | undefined;
+    view_count?: number | null | undefined;
+}>;
+export declare const channelSearchRowSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channel_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channel_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    uploader_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channel_follower_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    id?: string | null | undefined;
+    title?: string | null | undefined;
+    channel?: string | null | undefined;
+    description?: string | null | undefined;
+    channel_id?: string | null | undefined;
+    channel_url?: string | null | undefined;
+    uploader_id?: string | null | undefined;
+    channel_follower_count?: number | null | undefined;
+}, {
+    id?: string | null | undefined;
+    title?: string | null | undefined;
+    channel?: string | null | undefined;
+    description?: string | null | undefined;
+    channel_id?: string | null | undefined;
+    channel_url?: string | null | undefined;
+    uploader_id?: string | null | undefined;
+    channel_follower_count?: number | null | undefined;
+}>;
+export declare const channelMetaSchema: z.ZodObject<{
+    channel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channel_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channel_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    uploader_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channel_follower_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Checked by `selectChannelImages`, which tolerates any shape. */
+    thumbnails: z.ZodUnknown;
+}, "strip", z.ZodTypeAny, {
+    channel?: string | null | undefined;
+    description?: string | null | undefined;
+    channel_id?: string | null | undefined;
+    channel_url?: string | null | undefined;
+    uploader_id?: string | null | undefined;
+    channel_follower_count?: number | null | undefined;
+    thumbnails?: unknown;
+}, {
+    channel?: string | null | undefined;
+    description?: string | null | undefined;
+    channel_id?: string | null | undefined;
+    channel_url?: string | null | undefined;
+    uploader_id?: string | null | undefined;
+    channel_follower_count?: number | null | undefined;
+    thumbnails?: unknown;
+}>;
+export declare const playlistMetaSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channel_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    uploader_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    playlist_count: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    modified_date: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    webpage_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    id?: string | null | undefined;
+    title?: string | null | undefined;
+    channel?: string | null | undefined;
+    description?: string | null | undefined;
+    channel_url?: string | null | undefined;
+    uploader_id?: string | null | undefined;
+    playlist_count?: number | null | undefined;
+    modified_date?: string | null | undefined;
+    webpage_url?: string | null | undefined;
+}, {
+    id?: string | null | undefined;
+    title?: string | null | undefined;
+    channel?: string | null | undefined;
+    description?: string | null | undefined;
+    channel_url?: string | null | undefined;
+    uploader_id?: string | null | undefined;
+    playlist_count?: number | null | undefined;
+    modified_date?: string | null | undefined;
+    webpage_url?: string | null | undefined;
+}>;
+//# sourceMappingURL=youtube-schemas.d.ts.map

package/dist/utils/youtube-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"youtube-schemas.d.ts","sourceRoot":"","sources":["../../src/utils/youtube-schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AAEH,2FAA2F;AAC3F,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgB7B,CAAC;AAEH,wFAAwF;AACxF,eAAO,MAAM,kBAAkB;;;;;;;;;EAG7B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAI3B,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIhC,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;EAM3B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE5B,CAAC;AAEH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAY1B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAE3B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;EAG9B,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;EAO7B,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;EASjC,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;IAO5B,mEAAmE;;;;;;;;;;;;;;;;;;EAEnE,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU7B,CAAC"}

package/dist/utils/youtube-schemas.js

@@ -0,0 +1,118 @@
+import { z } from 'zod';
+/**
+ * The shapes yt-dlp's JSON output is checked against.
+ *
+ * Every field is optional or nullable: yt-dlp emits `null` for what it could
+ * not find and omits what it never looked for, and a row missing a field is
+ * still a usable row. What the schemas guarantee is that a field that *is*
+ * present has the type the code reads it as — which the previous "is it an
+ * object" guard did not.
+ */
+/** `--print '%(.{...})j'` for one video: yt-dlp writes `null` for what it did not find. */
+export const videoInfoRowSchema = z.object({
+    id: z.string().nullish(),
+    title: z.string().nullish(),
+    channel: z.string().nullish(),
+    duration: z.number().nullish(),
+    upload_date: z.string().nullish(),
+    description: z.string().nullish(),
+    // Kept loose on purpose: a tag list is read for the strings it holds, and a
+    // video whose tags field is odd should still be readable.
+    tags: z.unknown(),
+    thumbnail: z.string().nullish(),
+    view_count: z.number().nullish(),
+    like_count: z.number().nullish(),
+    comment_count: z.number().nullish(),
+    availability: z.string().nullish(),
+    live_status: z.string().nullish(),
+});
+/** `--print 'after_move:%(.{title,filepath})j'`: where yt-dlp put the finished file. */
+export const afterMoveRowSchema = z.object({
+    title: z.string().nullish(),
+    filepath: z.string().nullish(),
+});
+export const chapterRowSchema = z.object({
+    title: z.string(),
+    start_time: z.number(),
+    end_time: z.number(),
+});
+export const videoDetailsRowSchema = z.object({
+    chapters: z.array(chapterRowSchema).nullish(),
+    upload_date: z.string().nullish(),
+    duration: z.number().nullish(),
+});
+export const commentRowSchema = z.object({
+    author: z.string().nullish(),
+    text: z.string().nullish(),
+    like_count: z.number().nullish(),
+    is_pinned: z.boolean().nullish(),
+    parent: z.string().nullish(),
+});
+export const commentsRowSchema = z.object({
+    comments: z.array(commentRowSchema).nullish(),
+});
+export const formatRowSchema = z.object({
+    format_id: z.string(),
+    ext: z.string(),
+    resolution: z.string().nullish(),
+    width: z.number().nullish(),
+    height: z.number().nullish(),
+    fps: z.number().nullish(),
+    vcodec: z.string().nullish(),
+    acodec: z.string().nullish(),
+    filesize: z.number().nullish(),
+    filesize_approx: z.number().nullish(),
+    format_note: z.string().nullish(),
+});
+export const formatsRowSchema = z.object({
+    formats: z.array(formatRowSchema).nullish(),
+});
+export const captionTracksSchema = z.object({
+    subtitles: z.record(z.string(), z.unknown()).nullish(),
+    automatic_captions: z.record(z.string(), z.unknown()).nullish(),
+});
+/**
+ * yt-dlp's search rows. Only `id` is required — the rest are absent often
+ * enough (age-gated entries, deleted uploads still in the index) that treating
+ * them as guaranteed is what produced `undefined` in rendered output.
+ */
+export const searchResultSchema = z.object({
+    id: z.string(),
+    title: z.string().nullish(),
+    duration: z.number().nullish(),
+    channel: z.string().nullish(),
+    view_count: z.number().nullish(),
+    url: z.string().nullish(),
+});
+export const channelSearchRowSchema = z.object({
+    id: z.string().nullish(),
+    title: z.string().nullish(),
+    channel: z.string().nullish(),
+    channel_id: z.string().nullish(),
+    channel_url: z.string().nullish(),
+    uploader_id: z.string().nullish(),
+    channel_follower_count: z.number().nullish(),
+    description: z.string().nullish(),
+});
+export const channelMetaSchema = z.object({
+    channel: z.string().nullish(),
+    channel_id: z.string().nullish(),
+    channel_url: z.string().nullish(),
+    uploader_id: z.string().nullish(),
+    channel_follower_count: z.number().nullish(),
+    description: z.string().nullish(),
+    /** Checked by `selectChannelImages`, which tolerates any shape. */
+    thumbnails: z.unknown(),
+});
+export const playlistMetaSchema = z.object({
+    id: z.string().nullish(),
+    title: z.string().nullish(),
+    channel: z.string().nullish(),
+    channel_url: z.string().nullish(),
+    uploader_id: z.string().nullish(),
+    playlist_count: z.number().nullish(),
+    modified_date: z.string().nullish(),
+    webpage_url: z.string().nullish(),
+    description: z.string().nullish(),
+});
+//# sourceMappingURL=youtube-schemas.js.map

package/dist/utils/youtube-schemas.js.map

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

package/dist/utils/youtube-search.d.ts

@@ -0,0 +1,14 @@
+import type { ChannelInfo } from './youtube-channel.js';
+/** Keyword search for videos and channels. */
+export interface SearchResult {
+    id: string;
+    title: string;
+    duration: number;
+    durationFormatted: string;
+    channel: string;
+    viewCount: number;
+    url: string;
+}
+export declare function searchVideos(query: string, limit?: number): Promise<SearchResult[]>;
+export declare function searchChannels(query: string, limit?: number): Promise<ChannelInfo[]>;
+//# sourceMappingURL=youtube-search.d.ts.map

package/dist/utils/youtube-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"youtube-search.d.ts","sourceRoot":"","sources":["../../src/utils/youtube-search.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD,8CAA8C;AAE9C,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAiBpF;AAED,wBAAsB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAsBrF"}

package/dist/utils/youtube-search.js

@@ -0,0 +1,39 @@
+import { parseYtDlpJsonLines, runYtDlp } from './ytdlp.js';
+import { channelSearchRowSchema, searchResultSchema } from './youtube-schemas.js';
+import { formatDuration, watchUrl } from './youtube-url.js';
+export async function searchVideos(query, limit = 5) {
+    const stdout = await runYtDlp(['--dump-json', '--flat-playlist'], {
+        label: 'search_videos',
+        target: `ytsearch${limit}:${query}`,
+    });
+    return parseYtDlpJsonLines(stdout, searchResultSchema).map((data) => {
+        return {
+            id: data.id,
+            title: data.title ?? 'Unknown',
+            duration: data.duration ?? 0,
+            durationFormatted: formatDuration(data.duration ?? 0),
+            channel: data.channel ?? 'Unknown',
+            viewCount: data.view_count ?? 0,
+            url: data.url ?? watchUrl(data.id),
+        };
+    });
+}
+export async function searchChannels(query, limit = 5) {
+    // YouTube channel filter: sp=EgIQAg%3D%3D
+    const searchUrl = `https://www.youtube.com/results?search_query=${encodeURIComponent(query)}&sp=EgIQAg%3D%3D`;
+    const stdout = await runYtDlp(['--dump-json', '--flat-playlist', '--playlist-items', `1-${limit}`], {
+        label: 'search_channels',
+        target: searchUrl,
+    });
+    return parseYtDlpJsonLines(stdout, channelSearchRowSchema).map((data) => {
+        return {
+            name: data.channel ?? data.title ?? 'Unknown',
+            channelId: data.channel_id ?? data.id ?? '',
+            handle: data.uploader_id ?? '',
+            subscriberCount: data.channel_follower_count ?? 0,
+            channelUrl: data.channel_url ?? '',
+            description: data.description ?? '',
+        };
+    });
+}
+//# sourceMappingURL=youtube-search.js.map

package/dist/utils/youtube-search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"youtube-search.js","sourceRoot":"","sources":["../../src/utils/youtube-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAElF,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAc5D,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAa,EAAE,KAAK,GAAG,CAAC;IACzD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,CAAC,aAAa,EAAE,iBAAiB,CAAC,EAAE;QAChE,KAAK,EAAE,eAAe;QACtB,MAAM,EAAE,WAAW,KAAK,IAAI,KAAK,EAAE;KACpC,CAAC,CAAC;IAEH,OAAO,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAClE,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,SAAS;YAC9B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,CAAC;YAC5B,iBAAiB,EAAE,cAAc,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;YACrD,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,SAAS;YAClC,SAAS,EAAE,IAAI,CAAC,UAAU,IAAI,CAAC;YAC/B,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;SACnC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAa,EAAE,KAAK,GAAG,CAAC;IAC3D,0CAA0C;IAC1C,MAAM,SAAS,GAAG,gDAAgD,kBAAkB,CAAC,KAAK,CAAC,kBAAkB,CAAC;IAE9G,MAAM,MAAM,GAAG,MAAM,QAAQ,CAC3B,CAAC,aAAa,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,KAAK,KAAK,EAAE,CAAC,EACpE;QACE,KAAK,EAAE,iBAAiB;QACxB,MAAM,EAAE,SAAS;KAClB,CACF,CAAC;IAEF,OAAO,mBAAmB,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACtE,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,IAAI,SAAS;YAC7C,SAAS,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,EAAE,IAAI,EAAE;YAC3C,MAAM,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;YAC9B,eAAe,EAAE,IAAI,CAAC,sBAAsB,IAAI,CAAC;YACjD,UAAU,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;YAClC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;SACpC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/youtube-url.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Video ids, watch URLs and the duration formatter every YouTube module shares.
+ *
+ * Split out of youtube.ts so the modules that read video, channel, download
+ * and transcript data can each depend on this without depending on each other.
+ */
+export declare function extractVideoId(urlOrId: string): string;
+/**
+ * Turn a caller-supplied playlist or channel reference into a yt-dlp target.
+ *
+ * Three shapes are accepted — a URL on a YouTube host, an `@handle`, or a bare
+ * channel id — and everything else is refused. This is the boundary that keeps
+ * `fetch_videos` and friends from pointing yt-dlp at an arbitrary host.
+ */
+export declare function resolveListTarget(input: string): string;
+/**
+ * The URL for a channel named any way a caller might name it: a URL (checked),
+ * an `@handle`, or a bare name treated as a handle, which is what
+ * `get_channel_info` has always done.
+ */
+export declare function channelUrlFor(channel: string): string;
+/** The canonical watch page for a video id. */
+export declare function watchUrl(videoId: string): string;
+export declare function formatDuration(seconds: number): string;
+//# sourceMappingURL=youtube-url.d.ts.map

package/dist/utils/youtube-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"youtube-url.d.ts","sourceRoot":"","sources":["../../src/utils/youtube-url.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAwBtD;AAID;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAcvD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIrD;AAED,+CAA+C;AAC/C,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAStD"}