@thunderkiller/video-clipper 1.7.0 → 1.9.0

package/dist/lib/services/video/source/youtube/subtitles.js

@@ -0,0 +1,340 @@
+import { execa } from 'execa';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { log } from '../../../../utils/logger.js';
+import { retryAsync } from '../../../../utils/retryAsync.js';
+import { TranscriptAnalyzer } from '../../../audio/transcriber/base.js';
+const WATCH_PAGE_URL = 'https://www.youtube.com/watch';
+const ACCEPT_LANGUAGE_HEADER = 'en-US,en;q=0.9';
+const PLAYER_RESPONSE_MARKERS = ['var ytInitialPlayerResponse = ', 'ytInitialPlayerResponse = '];
+const LIVE_CHAT_FILE_RE = /(?:^|[.])live_chat(?:[.-]|$)/i;
+/**
+ * Parses a WebVTT string into TranscriptLine[].
+ *
+ * Handles:
+ * - `HH:MM:SS.mmm --> HH:MM:SS.mmm` timestamp lines
+ * - `<MM:SS.mmm><c>text</c>` inline cue tags (stripped)
+ * - Duplicate / empty cues (skipped)
+ *
+ * Exported for unit testing.
+ */
+export function parseVtt(vttContent) {
+    const lines = vttContent.split(/\r?\n/);
+    const result = [];
+    /** Regex to match HH:MM:SS.mmm --> HH:MM:SS.mmm timestamp lines */
+    const TIMESTAMP_RE = /^(\d{2}):(\d{2}):(\d{2})[.,](\d{3})\s+-->\s+(\d{2}):(\d{2}):(\d{2})[.,](\d{3})/;
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i].trim();
+        const match = TIMESTAMP_RE.exec(line);
+        if (match) {
+            const startSec = parseInt(match[1], 10) * 3600 +
+                parseInt(match[2], 10) * 60 +
+                parseInt(match[3], 10) +
+                parseInt(match[4], 10) / 1000;
+            const endSec = parseInt(match[5], 10) * 3600 +
+                parseInt(match[6], 10) * 60 +
+                parseInt(match[7], 10) +
+                parseInt(match[8], 10) / 1000;
+            i++;
+            const textLines = [];
+            while (i < lines.length && lines[i].trim() !== '') {
+                textLines.push(lines[i].trim());
+                i++;
+            }
+            const rawText = textLines.join(' ');
+            const text = rawText
+                .replace(/<[^>]+>/g, '')
+                .replace(/&amp;/g, '&')
+                .replace(/&lt;/g, '<')
+                .replace(/&gt;/g, '>')
+                .replace(/&nbsp;/g, ' ')
+                .replace(/\s+/g, ' ')
+                .trim();
+            if (text.length === 0) {
+                continue;
+            }
+            const duration = Math.max(0, endSec - startSec);
+            /** Skip duplicate cues - YouTube VTT often repeats same line as text scrolls */
+            if (result.length > 0 && result[result.length - 1].text === text) {
+                continue;
+            }
+            result.push({ text, start: startSec, duration });
+            continue;
+        }
+        i++;
+    }
+    return result;
+}
+export function extractInitialPlayerResponse(html) {
+    for (const marker of PLAYER_RESPONSE_MARKERS) {
+        const markerIndex = html.indexOf(marker);
+        if (markerIndex === -1) {
+            continue;
+        }
+        const jsonStart = html.indexOf('{', markerIndex + marker.length);
+        if (jsonStart === -1) {
+            continue;
+        }
+        const json = extractBalancedJsonObject(html, jsonStart);
+        if (!json) {
+            continue;
+        }
+        try {
+            return JSON.parse(json);
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
+export function pickEnglishCaptionTrack(tracks) {
+    const englishTracks = tracks.filter((track) => isEnglishLanguage(track.languageCode));
+    if (englishTracks.length === 0) {
+        return null;
+    }
+    return englishTracks.sort((left, right) => captionTrackScore(right) - captionTrackScore(left))[0];
+}
+export function rankSubtitleFiles(files) {
+    return files
+        .filter((file) => file.endsWith('.vtt') && !LIVE_CHAT_FILE_RE.test(file))
+        .sort((left, right) => subtitleFileScore(right) - subtitleFileScore(left) || left.localeCompare(right));
+}
+function extractBalancedJsonObject(source, startIndex) {
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    for (let index = startIndex; index < source.length; index++) {
+        const char = source[index];
+        if (inString) {
+            if (escaped) {
+                escaped = false;
+                continue;
+            }
+            if (char === '\\') {
+                escaped = true;
+                continue;
+            }
+            if (char === '"') {
+                inString = false;
+            }
+            continue;
+        }
+        if (char === '"') {
+            inString = true;
+            continue;
+        }
+        if (char === '{') {
+            depth += 1;
+            continue;
+        }
+        if (char === '}') {
+            depth -= 1;
+            if (depth === 0) {
+                return source.slice(startIndex, index + 1);
+            }
+        }
+    }
+    return null;
+}
+function isEnglishLanguage(languageCode) {
+    const normalized = languageCode.trim().toLowerCase();
+    return normalized === 'en' || normalized.startsWith('en-');
+}
+function captionTrackScore(track) {
+    let score = 0;
+    if (track.languageCode.trim().toLowerCase() === 'en') {
+        score += 100;
+    }
+    else if (isEnglishLanguage(track.languageCode)) {
+        score += 90;
+    }
+    if (track.kind !== 'asr') {
+        score += 10;
+    }
+    return score;
+}
+function subtitleFileScore(file) {
+    let score = 0;
+    if (/\.en\.vtt$/i.test(file)) {
+        score += 120;
+    }
+    else if (/\.en(?:[.-]|$)/i.test(file)) {
+        score += 100;
+    }
+    else if (/\.en-[A-Z]{2}\.vtt$/i.test(file)) {
+        score += 90;
+    }
+    if (/orig|asr|auto/i.test(file)) {
+        score -= 10;
+    }
+    return score;
+}
+function playabilityReason(playerResponse) {
+    const renderer = playerResponse.playabilityStatus?.errorScreen?.playerErrorMessageRenderer;
+    return (renderer?.reason?.simpleText ??
+        renderer?.subreason?.simpleText ??
+        renderer?.subreason?.runs
+            ?.map((run) => run.text ?? '')
+            .join('')
+            .trim() ??
+        playerResponse.playabilityStatus?.reason ??
+        null);
+}
+function buildCaptionTrackUrl(baseUrl) {
+    const url = new URL(baseUrl);
+    url.searchParams.set('fmt', 'vtt');
+    return url.toString();
+}
+async function fetchTranscriptFromYouTube(videoId) {
+    const watchUrl = new URL(WATCH_PAGE_URL);
+    watchUrl.searchParams.set('v', videoId);
+    watchUrl.searchParams.set('hl', 'en');
+    const res = await fetch(watchUrl, {
+        headers: {
+            'accept-language': ACCEPT_LANGUAGE_HEADER,
+        },
+    });
+    if (!res.ok) {
+        throw new Error(`YouTube watch page request failed for "${videoId}": HTTP ${res.status}`);
+    }
+    const html = await res.text();
+    const playerResponse = extractInitialPlayerResponse(html);
+    if (!playerResponse) {
+        return null;
+    }
+    if (playerResponse.playabilityStatus?.status === 'LOGIN_REQUIRED') {
+        throw new Error(`YouTube requires sign-in for "${videoId}": ${playabilityReason(playerResponse) ?? 'Sign in to confirm you are not a bot.'}`);
+    }
+    const tracks = playerResponse.captions?.playerCaptionsTracklistRenderer?.captionTracks ?? [];
+    const track = pickEnglishCaptionTrack(tracks);
+    if (!track) {
+        return null;
+    }
+    const captionRes = await fetch(buildCaptionTrackUrl(track.baseUrl), {
+        headers: {
+            'accept-language': ACCEPT_LANGUAGE_HEADER,
+        },
+    });
+    if (!captionRes.ok) {
+        throw new Error(`YouTube caption track request failed for "${videoId}": HTTP ${captionRes.status}`);
+    }
+    const content = await captionRes.text();
+    const lines = parseVtt(content);
+    return lines.length > 0 ? lines : null;
+}
+async function readBestSubtitleFile(videoId, tmpDir) {
+    const files = rankSubtitleFiles(await fs.readdir(tmpDir));
+    if (files.length === 0) {
+        throw new Error(`No subtitles found for "${videoId}". The video may not have English captions, or YouTube may require authentication for subtitle access.`);
+    }
+    for (const file of files) {
+        const content = await fs.readFile(path.join(tmpDir, file), 'utf8');
+        const lines = parseVtt(content);
+        if (lines.length > 0) {
+            return { file, lines };
+        }
+    }
+    throw new Error(`Subtitle files for "${videoId}" were empty or contained no parseable cues.`);
+}
+async function fetchTranscriptViaYtDlp(videoId, cookies, directFetchError) {
+    const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'vc-vtt-'));
+    try {
+        const args = [
+            '--write-subs',
+            '--write-auto-subs',
+            '--sub-format',
+            'vtt',
+            '--sub-langs',
+            'en.*,-live_chat',
+            // mhtml is the format YouTube exposes when the TV-client n-challenge JS
+            // solver fails (Deno bug). Selecting it explicitly keeps yt-dlp from
+            // bailing out with "Requested format is not available" before it writes
+            // the VTT subtitle files. The format is irrelevant because --skip-download
+            // means no video/audio is actually downloaded.
+            '--format',
+            'mhtml',
+            '--skip-download',
+            '--no-playlist',
+            '--output',
+            path.join(tmpDir, '%(id)s.%(ext)s'),
+            `https://www.youtube.com/watch?v=${videoId}`,
+        ];
+        if (cookies.cookiesFromBrowser) {
+            args.unshift('--cookies-from-browser', cookies.cookiesFromBrowser);
+        }
+        else if (cookies.cookiesFile) {
+            args.unshift('--cookies', cookies.cookiesFile);
+        }
+        try {
+            await retryAsync(() => execa('yt-dlp', args), cookies.retryCount ?? 0, 2000, `yt-dlp:subtitles:${videoId}`);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            log.error('fetchTranscriptViaYtDlp', `yt-dlp subtitle download failed: ${message}`);
+            if (message.includes('Sign in to confirm') ||
+                message.includes('confirm you’re not a bot') ||
+                message.includes("confirm you're not a bot") ||
+                directFetchError?.message.includes('YouTube requires sign-in')) {
+                if (cookies.cookiesFromBrowser || cookies.cookiesFile) {
+                    throw new Error(`YouTube rejected the current cookies while fetching subtitles for "${videoId}". Refresh the cookies from a fresh private/incognito YouTube session and retry.`);
+                }
+                throw new Error(`YouTube requires authentication to access subtitles for "${videoId}". Set YT_DLP_COOKIES_FROM_BROWSER=chrome (or firefox/safari) or YT_DLP_COOKIES_FILE to a fresh cookies.txt export and retry.`);
+            }
+            throw new Error(`yt-dlp failed to fetch subtitles for "${videoId}": ${message}`);
+        }
+        const { file, lines } = await readBestSubtitleFile(videoId, tmpDir);
+        log.info('fetchTranscriptViaYtDlp', `Parsed ${lines.length} cues from subtitle file "${file}".`);
+        return lines;
+    }
+    finally {
+        await fs.rm(tmpDir, { recursive: true, force: true });
+    }
+}
+/**
+ * Fetches the transcript for a given YouTube video ID.
+ *
+ * Strategy:
+ * 1. Read public caption-track metadata directly from the YouTube watch page.
+ * 2. Fetch the English track from YouTube's own timedtext endpoint when available.
+ * 3. Fall back to yt-dlp subtitle extraction when YouTube does not expose public tracks.
+ *
+ * Cookie config (YT_DLP_COOKIES_FROM_BROWSER / YT_DLP_COOKIES_FILE) is only
+ * used for the yt-dlp fallback path.
+ */
+async function fetchTranscript(videoId, cookies) {
+    let directFetchError = null;
+    try {
+        const directLines = await fetchTranscriptFromYouTube(videoId);
+        if (directLines) {
+            log.info('fetchTranscript', `Fetched ${directLines.length} cues directly from YouTube for "${videoId}".`);
+            return directLines;
+        }
+    }
+    catch (err) {
+        directFetchError = err instanceof Error ? err : new Error(String(err));
+        log.warn('fetchTranscript', `[transcript:youtube] direct caption fetch failed for "${videoId}", falling back to yt-dlp: ${directFetchError.message}`);
+    }
+    return fetchTranscriptViaYtDlp(videoId, cookies, directFetchError);
+}
+/**
+ * Fetches the YouTube transcript from YouTube caption tracks first, then
+ * falls back to yt-dlp subtitle extraction when needed.
+ *
+ * This is the default transcript provider. It does not use the audio file —
+ * the `audioPath` parameter is accepted but ignored.
+ */
+export class YtDlpTranscriptAnalyzer extends TranscriptAnalyzer {
+    cookies;
+    source = 'ytdlp';
+    constructor(cookies = {}) {
+        super();
+        this.cookies = cookies;
+    }
+    async detect(videoId, _audioPath) {
+        return fetchTranscript(videoId, this.cookies);
+    }
+}
+//# sourceMappingURL=subtitles.js.map

package/dist/lib/services/video/source/youtube/subtitles.js.map

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

package/dist/lib/types/analyzer.d.ts

@@ -0,0 +1,55 @@
+import type { TranscriptLine, MicroBlock, LLMChunk } from './transcript.js';
+import type { AudioEvent } from './audio.js';
+import type { ChunkEvaluation, RankedSegment } from './segment.js';
+import type { LanguageModel } from 'ai';
+export interface LLMAnalyzerResult {
+    lines: TranscriptLine[];
+    microBlocks: MicroBlock[];
+    chunks: LLMChunk[];
+    chunkEvals: ChunkEvaluation[];
+}
+export interface LLMAnalyzerOpts {
+    videoId: string;
+    audioPath: string | null;
+    audioEvents: AudioEvent[];
+    maxChunks?: number;
+    maxParallel: number;
+    noCache: boolean;
+    requestId?: string;
+    signal?: AbortSignal;
+}
+export interface TranscriptDetectorResult {
+    lines: TranscriptLine[];
+    microBlocks: MicroBlock[];
+    chunks: LLMChunk[];
+}
+export interface StreamCallbacks {
+    onChunkStarted?: (chunkIndex: number) => void;
+    onChunkTextDelta?: (chunkIndex: number, text: string) => void;
+    onChunkAnalyzed?: (chunkIndex: number, evaluation: ChunkEvaluation) => void;
+    onSegmentStarted?: (segmentRank: number) => void;
+    onSegmentTextDelta?: (segmentRank: number, text: string) => void;
+    onSegmentRefined?: (segmentRank: number, segment: RankedSegment) => void;
+}
+export interface AnalyzeChunksOpts {
+    maxRetries: number;
+    systemPrompt: string;
+    model: LanguageModel;
+    callbacks?: Pick<StreamCallbacks, 'onChunkStarted' | 'onChunkTextDelta' | 'onChunkAnalyzed'>;
+    requestId?: string;
+    signal?: AbortSignal;
+}
+export interface RefineSegmentsOpts {
+    maxRetries: number;
+    model: LanguageModel;
+    callbacks?: Pick<StreamCallbacks, 'onSegmentStarted' | 'onSegmentTextDelta' | 'onSegmentRefined'>;
+    requestId?: string;
+    videoTitle?: string;
+    signal?: AbortSignal;
+}
+import { z } from 'zod';
+export declare const RefinedBoundariesSchema: z.ZodObject<{
+    clip_start: z.ZodNumber;
+    clip_end: z.ZodNumber;
+}, z.core.$strip>;
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/lib/types/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../../../src/lib/types/analyzer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAExC,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,UAAU,EAAE,eAAe,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,MAAM,EAAE,QAAQ,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9D,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,KAAK,IAAI,CAAC;IAC5E,gBAAgB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,kBAAkB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE,gBAAgB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,KAAK,IAAI,CAAC;CAC1E;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,gBAAgB,GAAG,kBAAkB,GAAG,iBAAiB,CAAC,CAAC;IAC7F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,kBAAkB,GAAG,oBAAoB,GAAG,kBAAkB,CAAC,CAAC;IAClG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,uBAAuB;;;iBAGlC,CAAC"}

package/dist/lib/types/analyzer.js

@@ -0,0 +1,6 @@
+import { z } from 'zod';
+export const RefinedBoundariesSchema = z.object({
+    clip_start: z.number().describe('Refined clip start time in seconds'),
+    clip_end: z.number().describe('Refined clip end time in seconds'),
+});
+//# sourceMappingURL=analyzer.js.map

package/dist/lib/types/analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.js","sourceRoot":"","sources":["../../../src/lib/types/analyzer.ts"],"names":[],"mappings":"AAwDA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IACrE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;CAClE,CAAC,CAAC"}

package/dist/lib/types/audio.d.ts

@@ -0,0 +1,54 @@
+import { z } from 'zod';
+export declare const AudioEventSchema: z.ZodObject<{
+    time: z.ZodNumber;
+    event: z.ZodString;
+    confidence: z.ZodNumber;
+    source: z.ZodEnum<{
+        whisper: "whisper";
+        gemini: "gemini";
+        yamnet: "yamnet";
+    }>;
+}, z.core.$strip>;
+export type AudioEvent = z.infer<typeof AudioEventSchema>;
+export declare const MergedCandidateSchema: z.ZodObject<{
+    start: z.ZodNumber;
+    end: z.ZodNumber;
+    score: z.ZodNumber;
+    source: z.ZodEnum<{
+        transcript: "transcript";
+        audio: "audio";
+        both: "both";
+    }>;
+    reason: z.ZodString;
+    audio_event: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type MergedCandidate = z.infer<typeof MergedCandidateSchema>;
+export interface AudioSource {
+    readonly name: string;
+    fetchAudio(videoId: string, outputDir: string): Promise<string>;
+}
+export interface GeminiAnalyzerConfig {
+    apiKey: string;
+    model: string;
+    extraInstructions?: string;
+}
+export declare const GeminiEventSchema: z.ZodArray<z.ZodObject<{
+    time_sec: z.ZodNumber;
+    event: z.ZodString;
+    confidence: z.ZodNumber;
+}, z.core.$strip>>;
+export interface AnalyzerChainConfig {
+    confidenceThreshold: number;
+    whisperModel: string;
+    gemini: GeminiAnalyzerConfig;
+}
+export interface SlicerConfig {
+    ffmpegPath?: string;
+    ffprobePath?: string;
+}
+export declare const WhisperSegmentSchema: z.ZodObject<{
+    text: z.ZodString;
+    start: z.ZodNumber;
+    duration: z.ZodNumber;
+}, z.core.$strip>;
+//# sourceMappingURL=audio.d.ts.map

package/dist/lib/types/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../../src/lib/types/audio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB;;;;;;;;;iBAK3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,qBAAqB;;;;;;;;;;;iBAOhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,eAAO,MAAM,iBAAiB;;;;kBAM7B,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,oBAAoB;;;;iBAI/B,CAAC"}

package/dist/{types → lib/types}/audio.js

@@ -13,4 +13,14 @@ export const MergedCandidateSchema = z.object({
     reason: z.string(),
     audio_event: z.string().optional(),
 });
+export const GeminiEventSchema = z.array(z.object({
+    time_sec: z.number(),
+    event: z.string(),
+    confidence: z.number().min(0).max(1),
+}));
+export const WhisperSegmentSchema = z.object({
+    text: z.string(),
+    start: z.number(),
+    duration: z.number(),
+});
 //# sourceMappingURL=audio.js.map

package/dist/lib/types/audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.js","sourceRoot":"","sources":["../../../src/lib/types/audio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;CAChD,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAChC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAcH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CACtC,CAAC,CAAC,MAAM,CAAC;IACP,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACrC,CAAC,CACH,CAAC;AAaF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;CACrB,CAAC,CAAC"}

package/dist/lib/types/cache.d.ts

@@ -0,0 +1,41 @@
+import { z } from 'zod';
+import type { TranscriptLine } from './transcript.js';
+import type { LLMChunk } from './transcript.js';
+import type { ChunkEvaluation } from './segment.js';
+import type { AudioEvent } from './audio.js';
+export declare const SegmentRefinementSchema: z.ZodObject<{
+    refined_start: z.ZodNumber;
+    refined_end: z.ZodNumber;
+}, z.core.$strip>;
+export type SegmentRefinement = z.infer<typeof SegmentRefinementSchema>;
+export interface CacheBackend {
+    readTranscript(videoId: string): Promise<TranscriptLine[] | null>;
+    writeTranscript(videoId: string, lines: TranscriptLine[]): Promise<void>;
+    readChunk(chunk: LLMChunk, chunkAudioEvents?: AudioEvent[]): Promise<ChunkEvaluation | null>;
+    writeChunk(chunk: LLMChunk, evaluation: ChunkEvaluation, chunkAudioEvents?: AudioEvent[]): Promise<void>;
+    readSegmentRefinement(start: number, end: number, reason: string): Promise<SegmentRefinement | null>;
+    writeSegmentRefinement(start: number, end: number, reason: string, refined: SegmentRefinement): Promise<void>;
+    readAudioEvents(videoId: string, gameProfile: string, provider: string): Promise<AudioEvent[] | null>;
+    writeAudioEvents(videoId: string, gameProfile: string, provider: string, events: AudioEvent[]): Promise<void>;
+    readAudioChunk(videoId: string, gameProfile: string, provider: string, windowStart: number, windowEnd: number): Promise<AudioEvent[] | null>;
+    writeAudioChunk(videoId: string, gameProfile: string, provider: string, windowStart: number, windowEnd: number, events: AudioEvent[]): Promise<void>;
+    close(): Promise<void>;
+}
+export interface CacheDocument<T> {
+    cacheKey: string;
+    data: T;
+    createdAt: Date;
+}
+export interface VideoCacheManifest {
+    chunkHashes: string[];
+    segmentHashes: string[];
+}
+export interface ClearVideoAnalysisResult {
+    manifestExisted: boolean;
+    chunksDeleted: number;
+    segmentsDeleted: number;
+}
+export interface ClearVideoTranscriptResult {
+    deleted: boolean;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/lib/types/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/lib/types/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,eAAO,MAAM,uBAAuB;;;iBAGlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,MAAM,WAAW,YAAY;IAC3B,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,CAAC;IAClE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,gBAAgB,CAAC,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAC7F,UAAU,CACR,KAAK,EAAE,QAAQ,EACf,UAAU,EAAE,eAAe,EAC3B,gBAAgB,CAAC,EAAE,UAAU,EAAE,GAC9B,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,qBAAqB,CACnB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IACrC,sBAAsB,CACpB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,eAAe,CACb,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;IAChC,gBAAgB,CACd,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,EAAE,GACnB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,cAAc,CACZ,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;IAChC,eAAe,CACb,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,UAAU,EAAE,GACnB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,CAAC,CAAC;IACR,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACvC,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/lib/types/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/lib/types/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;CACxB,CAAC,CAAC"}

package/dist/lib/types/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/lib/types/cli.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,gBAAgB,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;CACf"}

package/dist/lib/types/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../../src/lib/types/cli.ts"],"names":[],"mappings":""}