youtube-knowledge-mcp 1.0.0

package/dist/tools/list-library.js

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import { listLibrary } from '../utils/storage.js';
+export const listLibrarySchema = {
+    tag: z.string().optional().describe('Filter by tag (partial match)'),
+};
+export async function listLibraryHandler({ tag }) {
+    const items = await listLibrary(tag ? { tag } : undefined);
+    const lines = [];
+    if (items.length === 0) {
+        lines.push('Your library is empty.');
+    }
+    else {
+        const header = tag
+            ? `${items.length} item${items.length !== 1 ? 's' : ''} matching "${tag}"`
+            : `${items.length} item${items.length !== 1 ? 's' : ''} in library`;
+        lines.push(header);
+        lines.push('');
+        items.forEach((item, i) => {
+            const types = [];
+            if (item.hasSummary)
+                types.push('summary');
+            if (item.hasSkill)
+                types.push('skill');
+            lines.push(`${i + 1}. ${item.title}`);
+            if (item.channel) {
+                lines.push(`   by ${item.channel}`);
+            }
+            lines.push(`   ${types.join(', ')} · saved ${item.dateSaved}`);
+            if (item.tags.length > 0) {
+                lines.push(`   tags: ${item.tags.join(', ')}`);
+            }
+            lines.push('');
+        });
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: lines.join('\n'),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=list-library.js.map

package/dist/tools/list-library.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-library.js","sourceRoot":"","sources":["../../src/tools/list-library.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;CACrE,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EAAE,GAAG,EAAoB;IAChE,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAE3D,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACvC,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,GAAG,GAAG;YAChB,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,QAAQ,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,cAAc,GAAG,GAAG;YAC1E,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,QAAQ,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC;QACtE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YACxB,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,UAAU;gBAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC3C,IAAI,IAAI,CAAC,QAAQ;gBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAEvC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACtC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YACtC,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;YAC/D,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjD,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;aACvB;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/save-to-library.d.ts

@@ -0,0 +1,23 @@
+import { z } from 'zod';
+export declare const saveToLibrarySchema: {
+    video_id: z.ZodString;
+    title: z.ZodString;
+    content: z.ZodString;
+    content_type: z.ZodDefault<z.ZodEnum<["summary", "skill"]>>;
+    channel: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+};
+export declare function saveToLibraryHandler({ video_id, title, content, content_type, channel, tags, }: {
+    video_id: string;
+    title: string;
+    content: string;
+    content_type: 'summary' | 'skill';
+    channel?: string;
+    tags?: string[];
+}): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=save-to-library.d.ts.map

package/dist/tools/save-to-library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-to-library.d.ts","sourceRoot":"","sources":["../../src/tools/save-to-library.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,mBAAmB;;;;;;;CAU/B,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,EACzC,QAAQ,EACR,KAAK,EACL,OAAO,EACP,YAAY,EACZ,OAAO,EACP,IAAI,GACL,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,SAAS,GAAG,OAAO,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;;;;;GA+BA"}

package/dist/tools/save-to-library.js

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import { saveToLibrary } from '../utils/storage.js';
+export const saveToLibrarySchema = {
+    video_id: z.string().describe('YouTube video ID'),
+    title: z.string().describe('Video title'),
+    content: z.string().describe('Content to save (summary, notes, or skill)'),
+    content_type: z
+        .enum(['summary', 'skill'])
+        .default('summary')
+        .describe('Type of content being saved'),
+    channel: z.string().optional().describe('Channel name'),
+    tags: z.array(z.string()).optional().describe('Tags for categorization'),
+};
+export async function saveToLibraryHandler({ video_id, title, content, content_type, channel, tags, }) {
+    const result = await saveToLibrary({
+        videoId: video_id,
+        title,
+        content,
+        contentType: content_type,
+        channel,
+        tags,
+    });
+    const lines = [`✓ Saved ${content_type} to library`, '', title];
+    if (channel) {
+        lines.push(`by ${channel}`);
+    }
+    if (tags && tags.length > 0) {
+        lines.push(`tags: ${tags.join(', ')}`);
+    }
+    lines.push('');
+    lines.push(result.path);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: lines.join('\n'),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=save-to-library.js.map

package/dist/tools/save-to-library.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-to-library.js","sourceRoot":"","sources":["../../src/tools/save-to-library.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IACjD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IAC1E,YAAY,EAAE,CAAC;SACZ,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;SAC1B,OAAO,CAAC,SAAS,CAAC;SAClB,QAAQ,CAAC,6BAA6B,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;IACvD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;CACzE,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,EACzC,QAAQ,EACR,KAAK,EACL,OAAO,EACP,YAAY,EACZ,OAAO,EACP,IAAI,GAQL;IACC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC;QACjC,OAAO,EAAE,QAAQ;QACjB,KAAK;QACL,OAAO;QACP,WAAW,EAAE,YAAY;QACzB,OAAO;QACP,IAAI;KACL,CAAC,CAAC;IAEH,MAAM,KAAK,GAAa,CAAC,WAAW,YAAY,aAAa,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;IAE1E,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAExB,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;aACvB;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/utils/storage.d.ts

@@ -0,0 +1,38 @@
+export interface LibraryMetadata {
+    videoId: string;
+    title: string;
+    channel: string;
+    url: string;
+    tags: string[];
+    dateSaved: string;
+    hasTranscript: boolean;
+    hasSummary: boolean;
+    hasSkill: boolean;
+}
+export interface LibraryIndex {
+    version: number;
+    items: Record<string, LibraryMetadata>;
+}
+export interface LibraryItem extends LibraryMetadata {
+    summary?: string;
+    skill?: string;
+}
+export interface SaveOptions {
+    videoId: string;
+    title: string;
+    channel?: string;
+    url?: string;
+    content: string;
+    contentType: 'summary' | 'skill';
+    tags?: string[];
+}
+export declare function saveToLibrary(options: SaveOptions): Promise<{
+    path: string;
+    saved: boolean;
+}>;
+export declare function listLibrary(filter?: {
+    tag?: string;
+}): Promise<LibraryMetadata[]>;
+export declare function getFromLibrary(videoId: string): Promise<LibraryItem | null>;
+export declare function deleteFromLibrary(videoId: string): Promise<boolean>;
+//# sourceMappingURL=storage.d.ts.map

package/dist/utils/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/utils/storage.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA6CD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CAgD3C;AAED,wBAAsB,WAAW,CAAC,MAAM,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAavF;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAwBjF;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgBzE"}

package/dist/utils/storage.js

@@ -0,0 +1,128 @@
+import { homedir } from 'os';
+import { join } from 'path';
+import { mkdir, readFile, writeFile } from 'fs/promises';
+import { existsSync } from 'fs';
+const BASE_DIR = join(homedir(), '.youtube-knowledge');
+const LIBRARY_DIR = join(BASE_DIR, 'library');
+const INDEX_FILE = join(BASE_DIR, 'index.json');
+async function ensureDirectories() {
+    await mkdir(BASE_DIR, { recursive: true });
+    await mkdir(LIBRARY_DIR, { recursive: true });
+}
+async function loadIndex() {
+    await ensureDirectories();
+    if (!existsSync(INDEX_FILE)) {
+        return { version: 1, items: {} };
+    }
+    try {
+        const content = await readFile(INDEX_FILE, 'utf-8');
+        const parsed = JSON.parse(content);
+        if (isLibraryIndex(parsed)) {
+            return parsed;
+        }
+        return { version: 1, items: {} };
+    }
+    catch {
+        return { version: 1, items: {} };
+    }
+}
+function isLibraryIndex(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'version' in value &&
+        'items' in value &&
+        typeof value.version === 'number');
+}
+function isPartialMetadata(value) {
+    return typeof value === 'object' && value !== null;
+}
+async function saveIndex(index) {
+    await ensureDirectories();
+    await writeFile(INDEX_FILE, JSON.stringify(index, null, 2), 'utf-8');
+}
+export async function saveToLibrary(options) {
+    const { videoId, title, channel, url, content, contentType, tags = [] } = options;
+    await ensureDirectories();
+    const itemDir = join(LIBRARY_DIR, videoId);
+    await mkdir(itemDir, { recursive: true });
+    // Save content
+    const filename = contentType === 'summary' ? 'summary.md' : 'skill.md';
+    const filePath = join(itemDir, filename);
+    await writeFile(filePath, content, 'utf-8');
+    // Update metadata
+    const metadataPath = join(itemDir, 'metadata.json');
+    let metadata = {};
+    if (existsSync(metadataPath)) {
+        try {
+            const parsed = JSON.parse(await readFile(metadataPath, 'utf-8'));
+            if (isPartialMetadata(parsed)) {
+                metadata = parsed;
+            }
+        }
+        catch {
+            // Ignore parse errors
+        }
+    }
+    const updatedMetadata = {
+        videoId,
+        title,
+        channel: channel ?? metadata.channel ?? '',
+        url: url ?? metadata.url ?? `https://www.youtube.com/watch?v=${videoId}`,
+        tags: [...new Set([...(metadata.tags ?? []), ...tags])],
+        dateSaved: new Date().toISOString(),
+        hasTranscript: metadata.hasTranscript ?? false,
+        hasSummary: contentType === 'summary' ? true : (metadata.hasSummary ?? false),
+        hasSkill: contentType === 'skill' ? true : (metadata.hasSkill ?? false),
+    };
+    await writeFile(metadataPath, JSON.stringify(updatedMetadata, null, 2), 'utf-8');
+    // Update index
+    const index = await loadIndex();
+    index.items[videoId] = updatedMetadata;
+    await saveIndex(index);
+    return { path: filePath, saved: true };
+}
+export async function listLibrary(filter) {
+    const index = await loadIndex();
+    let items = Object.values(index.items);
+    if (filter?.tag) {
+        const tagLower = filter.tag.toLowerCase();
+        items = items.filter((item) => item.tags.some((t) => t.toLowerCase().includes(tagLower)));
+    }
+    // Sort by date saved (most recent first)
+    items.sort((a, b) => new Date(b.dateSaved).getTime() - new Date(a.dateSaved).getTime());
+    return items;
+}
+export async function getFromLibrary(videoId) {
+    const index = await loadIndex();
+    if (!Object.hasOwn(index.items, videoId)) {
+        return null;
+    }
+    const metadata = index.items[videoId];
+    const itemDir = join(LIBRARY_DIR, videoId);
+    const item = { ...metadata };
+    // Load summary if exists
+    const summaryPath = join(itemDir, 'summary.md');
+    if (existsSync(summaryPath)) {
+        item.summary = await readFile(summaryPath, 'utf-8');
+    }
+    // Load skill if exists
+    const skillPath = join(itemDir, 'skill.md');
+    if (existsSync(skillPath)) {
+        item.skill = await readFile(skillPath, 'utf-8');
+    }
+    return item;
+}
+export async function deleteFromLibrary(videoId) {
+    const index = await loadIndex();
+    if (!Object.hasOwn(index.items, videoId)) {
+        return false;
+    }
+    // Create new items object without the deleted videoId
+    const { [videoId]: _removed, ...remainingItems } = index.items;
+    index.items = remainingItems;
+    await saveIndex(index);
+    // Note: We don't delete the files, just remove from index
+    // This allows recovery if needed
+    return true;
+}
+//# sourceMappingURL=storage.js.map

package/dist/utils/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/utils/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAEhC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,oBAAoB,CAAC,CAAC;AACvD,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;AAwBhD,KAAK,UAAU,iBAAiB;IAC9B,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,MAAM,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,KAAK,UAAU,SAAS;IACtB,MAAM,iBAAiB,EAAE,CAAC;IAE1B,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACnC,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACpD,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACnC,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,SAAS,IAAI,KAAK;QAClB,OAAO,IAAI,KAAK;QAChB,OAAQ,KAAsB,CAAC,OAAO,KAAK,QAAQ,CACpD,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,KAAmB;IAC1C,MAAM,iBAAiB,EAAE,CAAC;IAC1B,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACvE,CAAC;AAYD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAoB;IAEpB,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAElF,MAAM,iBAAiB,EAAE,CAAC;IAE1B,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC3C,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1C,eAAe;IACf,MAAM,QAAQ,GAAG,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC;IACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACzC,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAE5C,kBAAkB;IAClB,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IACpD,IAAI,QAAQ,GAA6B,EAAE,CAAC;IAE5C,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;YAC1E,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9B,QAAQ,GAAG,MAAM,CAAC;YACpB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;IACH,CAAC;IAED,MAAM,eAAe,GAAoB;QACvC,OAAO;QACP,KAAK;QACL,OAAO,EAAE,OAAO,IAAI,QAAQ,CAAC,OAAO,IAAI,EAAE;QAC1C,GAAG,EAAE,GAAG,IAAI,QAAQ,CAAC,GAAG,IAAI,mCAAmC,OAAO,EAAE;QACxE,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QACvD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,aAAa,EAAE,QAAQ,CAAC,aAAa,IAAI,KAAK;QAC9C,UAAU,EAAE,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,IAAI,KAAK,CAAC;QAC7E,QAAQ,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,IAAI,KAAK,CAAC;KACxE,CAAC;IAEF,MAAM,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAEjF,eAAe;IACf,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;IAChC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,eAAe,CAAC;IACvC,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;IAEvB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAyB;IACzD,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;IAChC,IAAI,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEvC,IAAI,MAAM,EAAE,GAAG,EAAE,CAAC;QAChB,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;QAC1C,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC5F,CAAC;IAED,yCAAyC;IACzC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAExF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAe;IAClD,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;IAEhC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAgB,EAAE,GAAG,QAAQ,EAAE,CAAC;IAE1C,yBAAyB;IACzB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAChD,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,uBAAuB;IACvB,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC5C,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAe;IACrD,MAAM,KAAK,GAAG,MAAM,SAAS,EAAE,CAAC;IAEhC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;QACzC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,sDAAsD;IACtD,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,GAAG,cAAc,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC;IAC/D,KAAK,CAAC,KAAK,GAAG,cAAc,CAAC;IAC7B,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;IAEvB,0DAA0D;IAC1D,iCAAiC;IAEjC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/utils/youtube.d.ts

@@ -0,0 +1,48 @@
+export interface VideoInfo {
+    id: string;
+    title: string;
+    channel: string;
+    duration: number;
+    durationFormatted: string;
+    uploadDate: string;
+    description: string;
+    tags: string[];
+    url: string;
+    thumbnailUrl: string;
+}
+export interface VideoListItem {
+    id: string;
+    title: string;
+    duration: number;
+    durationFormatted: string;
+    uploadDate: string;
+    url: string;
+}
+export interface TranscriptResult {
+    transcript: string;
+    language: string;
+    videoId: string;
+}
+export interface VideoFormat {
+    formatId: string;
+    ext: string;
+    resolution: string;
+    fps?: number;
+    vcodec: string;
+    acodec: string;
+    filesize?: number;
+    note: string;
+}
+export interface DownloadResult {
+    videoId: string;
+    title: string;
+    filePath: string;
+    format: string;
+}
+export declare function getVideoInfo(urlOrId: string): Promise<VideoInfo>;
+export declare function listVideos(urlOrChannel: string, limit?: number): Promise<VideoListItem[]>;
+export declare function getTranscript(urlOrId: string, preferredLang?: string): Promise<TranscriptResult>;
+export declare function listFormats(urlOrId: string): Promise<VideoFormat[]>;
+export type VideoQuality = 'best' | '2160p' | '1440p' | '1080p' | '720p' | '480p' | '360p' | 'audio';
+export declare function downloadVideo(urlOrId: string, formatId: string, outputDir?: string, quality?: VideoQuality): Promise<DownloadResult>;
+//# sourceMappingURL=youtube.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"youtube.d.ts","sourceRoot":"","sources":["../../src/utils/youtube.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAmCD,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAuCtE;AAED,wBAAsB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CA4B3F;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,aAAa,SAAO,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAoF3B;AAkBD,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA0BzE;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAcrG,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,cAAc,CAAC,CAmEzB"}

package/dist/utils/youtube.js

@@ -0,0 +1,288 @@
+import { execa } from 'execa';
+import { homedir } from 'os';
+import { join } from 'path';
+import { mkdir, readFile, writeFile, unlink } from 'fs/promises';
+import { existsSync } from 'fs';
+const CACHE_DIR = join(homedir(), '.youtube-knowledge', 'transcripts');
+function extractVideoId(urlOrId) {
+    // If it's already an ID (11 characters, no special chars except - and _)
+    if (/^[a-zA-Z0-9_-]{11}$/.test(urlOrId)) {
+        return urlOrId;
+    }
+    // Try to extract from URL
+    const patterns = [
+        /(?:youtube\.com\/watch\?v=|youtu\.be\/|youtube\.com\/embed\/|youtube\.com\/v\/)([a-zA-Z0-9_-]{11})/,
+        /(?:youtube\.com\/shorts\/)([a-zA-Z0-9_-]{11})/,
+    ];
+    for (const pattern of patterns) {
+        const match = urlOrId.match(pattern);
+        if (match) {
+            return match[1];
+        }
+    }
+    throw new Error(`Could not extract video ID from: ${urlOrId}`);
+}
+function formatDuration(seconds) {
+    const hours = Math.floor(seconds / 3600);
+    const minutes = Math.floor((seconds % 3600) / 60);
+    const secs = seconds % 60;
+    if (hours > 0) {
+        return `${hours}:${minutes.toString().padStart(2, '0')}:${secs.toString().padStart(2, '0')}`;
+    }
+    return `${minutes}:${secs.toString().padStart(2, '0')}`;
+}
+export async function getVideoInfo(urlOrId) {
+    const videoId = extractVideoId(urlOrId);
+    const url = `https://www.youtube.com/watch?v=${videoId}`;
+    const { stdout } = await execa('yt-dlp', [
+        '--skip-download',
+        '--print',
+        '%(id)s|||%(title)s|||%(channel)s|||%(duration)s|||%(upload_date)s|||%(description)s|||%(tags)j|||%(thumbnail)s',
+        url,
+    ]);
+    const [id, title, channel, durationStr, uploadDate, description, tagsJson, thumbnailUrl] = stdout.split('|||');
+    const duration = parseInt(durationStr, 10) || 0;
+    let tags = [];
+    try {
+        const parsedTags = JSON.parse(tagsJson || '[]');
+        if (Array.isArray(parsedTags)) {
+            tags = parsedTags.filter((t) => typeof t === 'string');
+        }
+    }
+    catch {
+        tags = [];
+    }
+    return {
+        id,
+        title,
+        channel,
+        duration,
+        durationFormatted: formatDuration(duration),
+        uploadDate: uploadDate
+            ? `${uploadDate.slice(0, 4)}-${uploadDate.slice(4, 6)}-${uploadDate.slice(6, 8)}`
+            : '',
+        description: description || '',
+        tags,
+        url,
+        thumbnailUrl: thumbnailUrl || '',
+    };
+}
+export async function listVideos(urlOrChannel, limit = 20) {
+    const { stdout } = await execa('yt-dlp', [
+        '--skip-download',
+        '--flat-playlist',
+        '--print',
+        '%(id)s|||%(title)s|||%(duration)s|||%(upload_date)s',
+        '--playlist-end',
+        limit.toString(),
+        urlOrChannel,
+    ]);
+    const lines = stdout.trim().split('\n').filter(Boolean);
+    return lines.map((line) => {
+        const [id, title, durationStr, uploadDate] = line.split('|||');
+        const duration = parseInt(durationStr, 10) || 0;
+        return {
+            id,
+            title: title || 'Unknown title',
+            duration,
+            durationFormatted: formatDuration(duration),
+            uploadDate: uploadDate
+                ? `${uploadDate.slice(0, 4)}-${uploadDate.slice(4, 6)}-${uploadDate.slice(6, 8)}`
+                : '',
+            url: `https://www.youtube.com/watch?v=${id}`,
+        };
+    });
+}
+export async function getTranscript(urlOrId, preferredLang = 'en') {
+    const videoId = extractVideoId(urlOrId);
+    const url = `https://www.youtube.com/watch?v=${videoId}`;
+    // Ensure cache directory exists
+    await mkdir(CACHE_DIR, { recursive: true });
+    // Check cache first
+    const cachedPath = join(CACHE_DIR, `${videoId}.txt`);
+    if (existsSync(cachedPath)) {
+        const transcript = await readFile(cachedPath, 'utf-8');
+        return {
+            transcript,
+            language: preferredLang,
+            videoId,
+        };
+    }
+    // Use a temp directory for yt-dlp subtitle output
+    const tempDir = join(CACHE_DIR, 'temp');
+    await mkdir(tempDir, { recursive: true });
+    const outputTemplate = join(tempDir, videoId);
+    try {
+        // Try to get subtitles (auto-generated or manual)
+        await execa('yt-dlp', [
+            '--skip-download',
+            '--write-auto-sub',
+            '--write-sub',
+            '--sub-lang',
+            `${preferredLang},${preferredLang}-orig`,
+            '--sub-format',
+            'vtt',
+            '--convert-subs',
+            'vtt',
+            '-o',
+            outputTemplate,
+            url,
+        ]);
+        // Find the generated subtitle file
+        const possibleFiles = [
+            `${outputTemplate}.${preferredLang}.vtt`,
+            `${outputTemplate}.${preferredLang}-orig.vtt`,
+            `${outputTemplate}.en.vtt`,
+        ];
+        let subtitleFile = null;
+        let detectedLang = preferredLang;
+        for (const file of possibleFiles) {
+            if (existsSync(file)) {
+                subtitleFile = file;
+                if (file.includes('-orig')) {
+                    detectedLang = `${preferredLang} (auto-generated)`;
+                }
+                break;
+            }
+        }
+        if (!subtitleFile) {
+            throw new Error(`No subtitles found for video ${videoId}`);
+        }
+        // Read and parse VTT file
+        const vttContent = await readFile(subtitleFile, 'utf-8');
+        const transcript = parseVtt(vttContent);
+        // Cache the transcript
+        await writeFile(cachedPath, transcript, 'utf-8');
+        // Clean up temp file (ignore errors)
+        await unlink(subtitleFile).catch(() => undefined);
+        return {
+            transcript,
+            language: detectedLang,
+            videoId,
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to get transcript for ${videoId}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+const DOWNLOADS_DIR = join(homedir(), '.youtube-knowledge', 'downloads');
+export async function listFormats(urlOrId) {
+    const videoId = extractVideoId(urlOrId);
+    const url = `https://www.youtube.com/watch?v=${videoId}`;
+    const { stdout } = await execa('yt-dlp', ['-j', '--skip-download', url]);
+    const data = JSON.parse(stdout);
+    const formats = data.formats ?? [];
+    return formats
+        .filter((f) => !f.format_id.startsWith('sb')) // skip storyboards
+        .map((f) => {
+        const resolution = f.resolution ?? (f.width && f.height ? `${f.width}x${f.height}` : 'audio only');
+        return {
+            formatId: f.format_id,
+            ext: f.ext,
+            resolution,
+            fps: f.fps,
+            vcodec: f.vcodec ?? 'none',
+            acodec: f.acodec ?? 'none',
+            filesize: f.filesize ?? f.filesize_approx,
+            note: f.format_note ?? '',
+        };
+    });
+}
+// Smart format selectors that use yt-dlp's fallback syntax
+const QUALITY_FORMAT_SELECTORS = {
+    best: 'bestvideo*+bestaudio/best',
+    '2160p': 'bestvideo[height<=2160]+bestaudio/bestvideo*[height<=2160]+bestaudio/best[height<=2160]/bestvideo+bestaudio/best',
+    '1440p': 'bestvideo[height<=1440]+bestaudio/bestvideo*[height<=1440]+bestaudio/best[height<=1440]/bestvideo+bestaudio/best',
+    '1080p': 'bestvideo[height<=1080]+bestaudio/bestvideo*[height<=1080]+bestaudio/best[height<=1080]/bestvideo+bestaudio/best',
+    '720p': 'bestvideo[height<=720]+bestaudio/bestvideo*[height<=720]+bestaudio/best[height<=720]/bestvideo+bestaudio/best',
+    '480p': 'bestvideo[height<=480]+bestaudio/bestvideo*[height<=480]+bestaudio/best[height<=480]/bestvideo+bestaudio/best',
+    '360p': 'bestvideo[height<=360]+bestaudio/bestvideo*[height<=360]+bestaudio/best[height<=360]/bestvideo+bestaudio/best',
+    audio: 'bestaudio/best',
+};
+export async function downloadVideo(urlOrId, formatId, outputDir, quality) {
+    const videoId = extractVideoId(urlOrId);
+    const url = `https://www.youtube.com/watch?v=${videoId}`;
+    const targetDir = outputDir ?? DOWNLOADS_DIR;
+    // Ensure download directory exists
+    await mkdir(targetDir, { recursive: true });
+    // Get video title first for the result
+    const { stdout: titleOutput } = await execa('yt-dlp', [
+        '--skip-download',
+        '--print',
+        '%(title)s',
+        url,
+    ]);
+    const title = titleOutput.trim();
+    // Download with specified format
+    const outputTemplate = join(targetDir, '%(title)s.%(ext)s');
+    // Determine format selector - use quality preset or explicit formatId
+    const formatSelector = quality ? QUALITY_FORMAT_SELECTORS[quality] : formatId;
+    // Build yt-dlp arguments with merge format for combining video+audio
+    const ytdlpArgs = [
+        '-f', formatSelector,
+        '-o', outputTemplate,
+        '--no-playlist',
+        '--merge-output-format', 'mp4', // Ensure merged output is mp4
+    ];
+    // Try download, with fallback to best available if format fails
+    try {
+        await execa('yt-dlp', [...ytdlpArgs, url]);
+    }
+    catch (error) {
+        // If specific format failed, try with best available as fallback
+        if (!quality && formatId !== 'best') {
+            console.error(`Format ${formatId} failed, trying best available...`);
+            await execa('yt-dlp', [
+                '-f', QUALITY_FORMAT_SELECTORS.best,
+                '-o', outputTemplate,
+                '--no-playlist',
+                '--merge-output-format', 'mp4',
+                url,
+            ]);
+        }
+        else {
+            throw error;
+        }
+    }
+    // Get the actual filename that was created
+    const { stdout: filenameOutput } = await execa('yt-dlp', [
+        '-f', formatSelector,
+        '--print', 'filename',
+        '-o', outputTemplate,
+        '--no-playlist',
+        '--merge-output-format', 'mp4',
+        url,
+    ]);
+    const filePath = filenameOutput.trim();
+    return {
+        videoId,
+        title,
+        filePath,
+        format: quality ?? formatId,
+    };
+}
+function parseVtt(vttContent) {
+    const lines = vttContent.split('\n');
+    const textLines = [];
+    let lastText = '';
+    for (const line of lines) {
+        // Skip VTT headers and timestamps
+        if (line.startsWith('WEBVTT') ||
+            line.startsWith('Kind:') ||
+            line.startsWith('Language:') ||
+            line.includes('-->') ||
+            /^\d{2}:\d{2}/.exec(line) ||
+            line.trim() === '') {
+            continue;
+        }
+        // Remove VTT tags like <c> </c>
+        const cleanLine = line.replace(/<[^>]+>/g, '').trim();
+        // Skip duplicate lines (common in auto-generated subs)
+        if (cleanLine && cleanLine !== lastText) {
+            textLines.push(cleanLine);
+            lastText = cleanLine;
+        }
+    }
+    return textLines.join(' ').replace(/\s+/g, ' ').trim();
+}
+//# sourceMappingURL=youtube.js.map