youtube-knowledge-mcp 3.0.0 → 3.0.2

package/dist/utils/harvest-details.d.ts

@@ -0,0 +1,30 @@
+import type { DatabaseSync } from 'node:sqlite';
+import type { Coverage } from '../harvest-schemas.js';
+import { type DetailFailure } from './detail-batch.js';
+import { type YouTubeErrorCode } from './errors.js';
+/**
+ * Reading every catalogued video of a channel, and keeping what each said.
+ *
+ * Resumable by construction: a video is read once, its row says so, and the next run
+ * takes the next unread one. What came back before a refusal is kept, because every
+ * batch commits on its own.
+ */
+export declare const DEFAULT_DETAIL_BATCH = 50;
+export declare const MAX_DETAIL_BATCH = 500;
+export interface DetailsResult {
+    channelId: string;
+    name: string;
+    attempted: number;
+    stored: number;
+    failures: DetailFailure[];
+    /** Videos still unread and still readable. */
+    remaining: number;
+    /** The error that made the run stop early, when one did. */
+    stoppedBecause?: YouTubeErrorCode;
+    coverage: Coverage;
+}
+export declare function harvestDetails(database: DatabaseSync, channel: string, options: {
+    maxVideos: number;
+    retryUnreadable?: boolean;
+}): Promise<DetailsResult>;
+//# sourceMappingURL=harvest-details.d.ts.map

package/dist/utils/harvest-details.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harvest-details.d.ts","sourceRoot":"","sources":["../../src/utils/harvest-details.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD,OAAO,EAAyC,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC9F,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAQlE;;;;;;GAMG;AAEH,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAQpC,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAClC,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,wBAAsB,cAAc,CAClC,QAAQ,EAAE,YAAY,EACtB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAAE,GACxD,OAAO,CAAC,aAAa,CAAC,CAmFxB"}

package/dist/utils/harvest-details.js

@@ -0,0 +1,98 @@
+import { reportProgress, throwIfAborted } from './context.js';
+import { coverageOf } from './coverage.js';
+import { STOPPING, persist, read, stoppingCode } from './detail-batch.js';
+import { YouTubeError } from './errors.js';
+import { withChannelHarvestLock } from './harvest-lock.js';
+import { readReceipt, saveReceipt } from './harvest-receipts.js';
+import { inTransaction } from './store.js';
+import { catalogCounts, pendingVideoIds, unreadableCount } from './video-detail-store.js';
+import { getChannelInfo } from './youtube-channel.js';
+import { concurrencyState } from './ytdlp.js';
+/**
+ * Reading every catalogued video of a channel, and keeping what each said.
+ *
+ * Resumable by construction: a video is read once, its row says so, and the next run
+ * takes the next unread one. What came back before a refusal is kept, because every
+ * batch commits on its own.
+ */
+export const DEFAULT_DETAIL_BATCH = 50;
+export const MAX_DETAIL_BATCH = 500;
+/** Concurrent reads. Each is a full yt-dlp extraction, the call YouTube throttles hardest. */
+const READ_CONCURRENCY = 4;
+function plural(count, noun) {
+    return `${String(count)} ${noun}${count === 1 ? '' : 's'}`;
+}
+export async function harvestDetails(database, channel, options) {
+    const info = await getChannelInfo(channel);
+    if (catalogCounts(database, info.channelId).videos === 0) {
+        throw new YouTubeError('NOT_FOUND', `${info.name} has not been catalogued yet.`, {
+            nextStep: 'Call harvest_channel first, so there is a catalogue of videos to read.',
+        });
+    }
+    return withChannelHarvestLock(info.channelId, async () => {
+        const startedAt = Date.now();
+        const { channelId } = info;
+        const queue = pendingVideoIds(database, channelId, options.maxVideos, {
+            includeUnreadable: options.retryUnreadable === true,
+        });
+        const width = Math.max(1, Math.min(concurrencyState().limit, READ_CONCURRENCY));
+        const failures = [];
+        let stored = 0;
+        let attempted = 0;
+        let stoppedBecause;
+        for (let start = 0; start < queue.length && stoppedBecause === undefined; start += width) {
+            throwIfAborted();
+            reportProgress(start, queue.length, 'harvest_details');
+            const batch = await Promise.all(queue.slice(start, start + width).map(read));
+            attempted += batch.length;
+            const saved = persist(database, batch);
+            stored += saved.stored;
+            failures.push(...saved.failures);
+            stoppedBecause = stoppingCode(batch);
+        }
+        const counts = catalogCounts(database, channelId);
+        const remaining = pendingVideoIds(database, channelId, counts.videos).length;
+        const unreadable = unreadableCount(database, channelId);
+        const capBound = attempted >= options.maxVideos && remaining > 0;
+        const catalog = readReceipt(database, 'channel-catalog', channelId);
+        const stopReason = stoppedBecause === undefined ? undefined : STOPPING[stoppedBecause];
+        const coverage = coverageOf({
+            scope: 'video-details',
+            targetId: channelId,
+            have: counts.detailed,
+            source: 'yt-dlp -j per catalogued video',
+            // The catalogue's size is a fair total only if the catalogue itself is whole.
+            ...(catalog?.complete === true
+                ? { expected: { value: counts.videos, source: 'store:catalog' } }
+                : {}),
+            ...(capBound ? { limitApplied: options.maxVideos } : {}),
+            ...(stopReason !== undefined
+                ? { reason: stopReason }
+                : remaining === 0 && (failures.length > 0 || unreadable > 0)
+                    ? { reason: 'PARTIAL_ERROR' }
+                    : {}),
+            ...(remaining > 0 || stoppedBecause !== undefined
+                ? { resumeToken: `details:${channelId}` }
+                : {}),
+            ...(unreadable > 0
+                ? {
+                    note: `${plural(unreadable, 'video')} cannot be read (private, members-only, age-gated, removed or failing), so this stays incomplete.`,
+                }
+                : {}),
+        });
+        inTransaction(database, () => {
+            saveReceipt(database, coverage, { startedAt });
+        });
+        return {
+            channelId,
+            name: info.name,
+            attempted,
+            stored,
+            failures,
+            remaining,
+            ...(stoppedBecause === undefined ? {} : { stoppedBecause }),
+            coverage,
+        };
+    });
+}
+//# sourceMappingURL=harvest-details.js.map

package/dist/utils/harvest-details.js.map

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

package/dist/utils/local-transcription.d.ts

@@ -0,0 +1,14 @@
+import { type TranscriptResult } from './transcript-cache.js';
+/**
+ * Turning a video's audio into a transcript when YouTube has no captions for it.
+ *
+ * Slow and CPU-heavy by nature, so it only ever runs when asked for, and what it
+ * produces is kept: a transcription is deterministic and takes minutes to redo.
+ */
+export interface LocalTranscriptionOptions {
+    language?: string;
+    /** Transcribe again even if a kept transcription exists. */
+    refresh?: boolean;
+}
+export declare function transcribeLocally(urlOrId: string, options: LocalTranscriptionOptions): Promise<TranscriptResult>;
+//# sourceMappingURL=local-transcription.d.ts.map

package/dist/utils/local-transcription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-transcription.d.ts","sourceRoot":"","sources":["../../src/utils/local-transcription.ts"],"names":[],"mappings":"AAYA,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAO/E;;;;;GAKG;AAEH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAcD,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,gBAAgB,CAAC,CAmE3B"}

package/dist/utils/local-transcription.js

@@ -0,0 +1,85 @@
+import { existsSync } from 'node:fs';
+import { mkdtemp, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+import { YouTubeError } from './errors.js';
+import { ensurePrivateDir } from './paths.js';
+import { requireFfmpeg } from './preflight.js';
+import { TRANSCRIPT_DIR, asrPath, readTranscriptFile, writeTranscriptFile, } from './transcript-files.js';
+import { resultFromEntry } from './transcript-cache.js';
+import { TRANSCRIPT_CACHE_VERSION, segmentsToText } from './transcript.js';
+import { assertLanguageTag } from './validate.js';
+import { requireWhisper, runWhisper } from './whisper.js';
+import { extractVideoId, watchUrl } from './youtube-url.js';
+import { TIMEOUTS, runYtDlp } from './ytdlp.js';
+/** What yt-dlp is told to leave behind: whisper reads 16 kHz mono, so make it that size. */
+const AUDIO_ARGS = [
+    '-f',
+    'bestaudio',
+    '-x',
+    '--audio-format',
+    'wav',
+    '--postprocessor-args',
+    'ExtractAudio:-ar 16000 -ac 1',
+    '--no-playlist',
+];
+export async function transcribeLocally(urlOrId, options) {
+    const language = options.language ?? 'en';
+    const videoId = extractVideoId(urlOrId);
+    assertLanguageTag(language);
+    if (options.refresh !== true) {
+        const kept = await readTranscriptFile(asrPath(videoId, language), { expires: false });
+        if (kept)
+            return resultFromEntry(kept, videoId, 'local-asr');
+    }
+    // Cheap local checks first: a missing tool should fail now, not after the audio
+    // has been downloaded.
+    await requireFfmpeg('Local transcription');
+    const modelPath = await requireWhisper('Local transcription');
+    const tempDir = join(TRANSCRIPT_DIR, 'temp');
+    await ensurePrivateDir(tempDir);
+    // A folder of its own for this call: yt-dlp leaves the original download and `.part`
+    // files beside the wav it makes, and two calls for one video must not share, then
+    // delete, each other's audio. The whole folder goes when this call does.
+    const workDir = await mkdtemp(join(tempDir, `${videoId}-`));
+    const audioBase = join(workDir, 'audio');
+    const audioPath = `${audioBase}.wav`;
+    try {
+        await runYtDlp([...AUDIO_ARGS, '-o', `${audioBase}.%(ext)s`], {
+            label: 'transcribe_video',
+            timeoutMs: TIMEOUTS.download,
+            retry: false,
+            target: watchUrl(videoId),
+        });
+        if (!existsSync(audioPath)) {
+            throw new YouTubeError('YTDLP_FAILED', 'yt-dlp did not produce the audio to transcribe.', {
+                nextStep: 'Check the video is playable, or call check_health.',
+            });
+        }
+        const segments = await runWhisper(audioPath, language, modelPath, join(workDir, 'whisper'));
+        if (segments.length === 0) {
+            throw new YouTubeError('NOT_FOUND', 'No speech was found in this video’s audio.', {
+                nextStep: 'The audio may be music or silence, or the model may not know this language. Try a larger model or another language.',
+            });
+        }
+        const entry = {
+            version: TRANSCRIPT_CACHE_VERSION,
+            videoId,
+            language,
+            fetchedAt: new Date().toISOString(),
+            segments,
+        };
+        await writeTranscriptFile(asrPath(videoId, language), entry);
+        return {
+            transcript: segmentsToText(segments),
+            segments,
+            language,
+            videoId,
+            cached: false,
+            source: 'local-asr',
+        };
+    }
+    finally {
+        await rm(workDir, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=local-transcription.js.map

package/dist/utils/local-transcription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-transcription.js","sourceRoot":"","sources":["../../src/utils/local-transcription.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EACL,cAAc,EACd,OAAO,EACP,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAyB,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EAAE,wBAAwB,EAAE,cAAc,EAAyB,MAAM,iBAAiB,CAAC;AAClG,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAehD,4FAA4F;AAC5F,MAAM,UAAU,GAAG;IACjB,IAAI;IACJ,WAAW;IACX,IAAI;IACJ,gBAAgB;IAChB,KAAK;IACL,sBAAsB;IACtB,8BAA8B;IAC9B,eAAe;CAChB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAe,EACf,OAAkC;IAElC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC;IAC1C,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACxC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAE5B,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACtF,IAAI,IAAI;YAAE,OAAO,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IAC/D,CAAC;IAED,gFAAgF;IAChF,uBAAuB;IACvB,MAAM,aAAa,CAAC,qBAAqB,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,qBAAqB,CAAC,CAAC;IAE9D,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAChC,qFAAqF;IACrF,kFAAkF;IAClF,yEAAyE;IACzE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC;IAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,GAAG,SAAS,MAAM,CAAC;IAErC,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,CAAC,GAAG,UAAU,EAAE,IAAI,EAAE,GAAG,SAAS,UAAU,CAAC,EAAE;YAC5D,KAAK,EAAE,kBAAkB;YACzB,SAAS,EAAE,QAAQ,CAAC,QAAQ;YAC5B,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC;SAC1B,CAAC,CAAC;QAEH,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,YAAY,CAAC,cAAc,EAAE,iDAAiD,EAAE;gBACxF,QAAQ,EAAE,oDAAoD;aAC/D,CAAC,CAAC;QACL,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;QAE5F,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,YAAY,CAAC,WAAW,EAAE,4CAA4C,EAAE;gBAChF,QAAQ,EACN,qHAAqH;aACxH,CAAC,CAAC;QACL,CAAC;QAED,MAAM,KAAK,GAAqB;YAC9B,OAAO,EAAE,wBAAwB;YACjC,OAAO;YACP,QAAQ;YACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,QAAQ;SACT,CAAC;QACF,MAAM,mBAAmB,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC;QAE7D,OAAO;YACL,UAAU,EAAE,cAAc,CAAC,QAAQ,CAAC;YACpC,QAAQ;YACR,QAAQ;YACR,OAAO;YACP,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,WAAW;SACpB,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC"}

package/dist/utils/moment.d.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+/**
+ * A point in a video, in every form a caller needs it.
+ *
+ * Frames, contact-sheet cells and scene cuts all answer "when", and each used to
+ * need the same three spellings of it: seconds to compute with, a clock reading to
+ * show a person, and a link that opens the video there.
+ */
+export declare const videoMomentSchema: z.ZodObject<{
+    timestampSeconds: z.ZodNumber;
+    timestamp: z.ZodString;
+    url: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    timestamp: string;
+    timestampSeconds: number;
+}, {
+    url: string;
+    timestamp: string;
+    timestampSeconds: number;
+}>;
+export type VideoMoment = z.infer<typeof videoMomentSchema>;
+export declare function videoMoment(videoId: string, seconds: number): VideoMoment;
+//# sourceMappingURL=moment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"moment.d.ts","sourceRoot":"","sources":["../../src/utils/moment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;GAMG;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;EAI5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CAMzE"}

package/dist/utils/moment.js

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+import { deepLink, formatTimestamp } from './transcript.js';
+/**
+ * A point in a video, in every form a caller needs it.
+ *
+ * Frames, contact-sheet cells and scene cuts all answer "when", and each used to
+ * need the same three spellings of it: seconds to compute with, a clock reading to
+ * show a person, and a link that opens the video there.
+ */
+export const videoMomentSchema = z.object({
+    timestampSeconds: z.number(),
+    timestamp: z.string().describe('Clock reading, H:MM:SS or M:SS'),
+    url: z.string().describe('Link that opens the video at this moment'),
+});
+export function videoMoment(videoId, seconds) {
+    return {
+        timestampSeconds: seconds,
+        timestamp: formatTimestamp(seconds),
+        url: deepLink(videoId, seconds),
+    };
+}
+//# sourceMappingURL=moment.js.map

package/dist/utils/moment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moment.js","sourceRoot":"","sources":["../../src/utils/moment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE5D;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IAChE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;CACrE,CAAC,CAAC;AAIH,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,OAAe;IAC1D,OAAO;QACL,gBAAgB,EAAE,OAAO;QACzB,SAAS,EAAE,eAAe,CAAC,OAAO,CAAC;QACnC,GAAG,EAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;KAChC,CAAC;AACJ,CAAC"}

package/dist/utils/most-replayed.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The moments of a video people replay most.
+ *
+ * YouTube's heatmap is a hundred or so equal slices, each scored from 0 to 1. A
+ * spike spans several adjacent slices, so taking the highest-scoring slices would
+ * return one spike over and over; instead each moment reserves the slices around it.
+ */
+export interface HeatSegment {
+    startSeconds: number;
+    endSeconds: number;
+    value: number;
+}
+/** Up to `count` distinct moments, strongest first. */
+export declare function mostReplayed(heatmap: HeatSegment[], count: number): HeatSegment[];
+//# sourceMappingURL=most-replayed.d.ts.map

package/dist/utils/most-replayed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"most-replayed.d.ts","sourceRoot":"","sources":["../../src/utils/most-replayed.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAUD,uDAAuD;AACvD,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CASjF"}

package/dist/utils/most-replayed.js

@@ -0,0 +1,25 @@
+/**
+ * The moments of a video people replay most.
+ *
+ * YouTube's heatmap is a hundred or so equal slices, each scored from 0 to 1. A
+ * spike spans several adjacent slices, so taking the highest-scoring slices would
+ * return one spike over and over; instead each moment reserves the slices around it.
+ */
+/** A moment keeps this many slice-widths clear on either side of it. */
+const SPACING_IN_SEGMENTS = 3;
+function isClearOf(segment, chosen) {
+    const reach = SPACING_IN_SEGMENTS * (segment.endSeconds - segment.startSeconds);
+    return chosen.every((peak) => Math.abs(segment.startSeconds - peak.startSeconds) >= reach);
+}
+/** Up to `count` distinct moments, strongest first. */
+export function mostReplayed(heatmap, count) {
+    const chosen = [];
+    for (const segment of [...heatmap].sort((a, b) => b.value - a.value)) {
+        if (chosen.length >= count)
+            break;
+        if (isClearOf(segment, chosen))
+            chosen.push(segment);
+    }
+    return chosen;
+}
+//# sourceMappingURL=most-replayed.js.map

package/dist/utils/most-replayed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"most-replayed.js","sourceRoot":"","sources":["../../src/utils/most-replayed.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,wEAAwE;AACxE,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAE9B,SAAS,SAAS,CAAC,OAAoB,EAAE,MAAqB;IAC5D,MAAM,KAAK,GAAG,mBAAmB,GAAG,CAAC,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAChF,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,CAAC;AAC7F,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,YAAY,CAAC,OAAsB,EAAE,KAAa;IAChE,MAAM,MAAM,GAAkB,EAAE,CAAC;IAEjC,KAAK,MAAM,OAAO,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QACrE,IAAI,MAAM,CAAC,MAAM,IAAI,KAAK;YAAE,MAAM;QAClC,IAAI,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/scenes.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Finding where a video cuts.
+ *
+ * ffmpeg scores every frame by how different it is from the one before; frames
+ * scoring above the threshold are cuts. Detection has to decode every frame of the
+ * window, so it reads the lightest stream and only a bounded window at a time.
+ */
+/** A scan decodes every frame; this keeps one call to a few minutes of work. */
+export declare const MAX_SCENE_WINDOW_SECONDS = 900;
+export declare const MAX_SCENE_CUTS = 200;
+export declare const DEFAULT_SCENE_THRESHOLD = 0.4;
+export interface ScanWindowRequest {
+    start?: number;
+    end?: number;
+}
+export interface SceneScanRequest extends ScanWindowRequest {
+    /** 0 to 1: how different a frame must be from the last to count as a cut. */
+    threshold: number;
+}
+export interface SceneScan {
+    videoId: string;
+    title: string;
+    duration: number;
+    start: number;
+    end: number;
+    threshold: number;
+    /** Absolute video time of each cut, ascending. */
+    cuts: number[];
+    /** True when more cuts were found than are returned. */
+    truncated: boolean;
+}
+/** Frames ffmpeg selected, as the times its showinfo filter logged them at. */
+export declare function parseSceneCuts(stderr: string, offset: number): number[];
+export declare function planScanWindow(request: ScanWindowRequest, duration: number): {
+    start: number;
+    end: number;
+};
+export declare function detectScenes(video: string, request: SceneScanRequest): Promise<SceneScan>;
+//# sourceMappingURL=scenes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scenes.d.ts","sourceRoot":"","sources":["../../src/utils/scenes.ts"],"names":[],"mappings":"AAWA;;;;;;GAMG;AAEH,gFAAgF;AAChF,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAG3C,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,wDAAwD;IACxD,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAUvE;AAED,wBAAgB,cAAc,CAC5B,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,MAAM,GACf;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CA0BhC;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,CA2C/F"}

package/dist/utils/scenes.js

@@ -0,0 +1,83 @@
+import { YouTubeError } from './errors.js';
+import { runFfmpeg } from './ffmpeg.js';
+import { roundToMillisecond } from './seconds.js';
+import { requireFfmpeg } from './preflight.js';
+import { FFMPEG_NETWORK_INPUT_ARGS, resolveStreamUrl, SCAN_STREAM_SELECTOR, } from './video-stream.js';
+import { getVideoInfo } from './youtube.js';
+/**
+ * Finding where a video cuts.
+ *
+ * ffmpeg scores every frame by how different it is from the one before; frames
+ * scoring above the threshold are cuts. Detection has to decode every frame of the
+ * window, so it reads the lightest stream and only a bounded window at a time.
+ */
+/** A scan decodes every frame; this keeps one call to a few minutes of work. */
+export const MAX_SCENE_WINDOW_SECONDS = 900;
+export const MAX_SCENE_CUTS = 200;
+export const DEFAULT_SCENE_THRESHOLD = 0.4;
+const SCAN_TIMEOUT_MS = 300_000;
+/** Frames ffmpeg selected, as the times its showinfo filter logged them at. */
+export function parseSceneCuts(stderr, offset) {
+    const times = stderr
+        .split('\n')
+        .filter((line) => line.includes('Parsed_showinfo'))
+        .flatMap((line) => {
+        const match = /pts_time:(\d+(?:\.\d+)?)/.exec(line);
+        return match?.[1] === undefined ? [] : [roundToMillisecond(offset + Number(match[1]))];
+    });
+    return [...new Set(times)].sort((a, b) => a - b);
+}
+export function planScanWindow(request, duration) {
+    const { start = 0 } = request;
+    if (duration > 0 && start >= duration) {
+        throw new YouTubeError('INVALID_INPUT', `${Math.round(start)}s is past the end of this ${duration}s video.`, { nextStep: 'Pick a start time inside the video.' });
+    }
+    const requestedEnd = request.end ?? start + MAX_SCENE_WINDOW_SECONDS;
+    if (requestedEnd <= start) {
+        throw new YouTubeError('INVALID_INPUT', 'end must be later than start.');
+    }
+    const end = duration > 0 ? Math.min(requestedEnd, duration) : requestedEnd;
+    if (end - start > MAX_SCENE_WINDOW_SECONDS) {
+        throw new YouTubeError('INVALID_INPUT', `Scene detection reads at most ${MAX_SCENE_WINDOW_SECONDS}s per call.`, { nextStep: 'Scan the video in windows, moving start forward each time.' });
+    }
+    return { start, end };
+}
+export async function detectScenes(video, request) {
+    await requireFfmpeg('Scene detection');
+    const info = await getVideoInfo(video);
+    const { start, end } = planScanWindow(request, info.duration);
+    const { threshold } = request;
+    const mediaUrl = await resolveStreamUrl(info.id, SCAN_STREAM_SELECTOR, 'Scene detection');
+    const { stderr } = await runFfmpeg([
+        ...FFMPEG_NETWORK_INPUT_ARGS,
+        // Both before -i: seek there, then read only the window.
+        '-ss',
+        String(start),
+        '-t',
+        String(end - start),
+        '-i',
+        mediaUrl,
+        '-an',
+        '-vf',
+        `select=gt(scene\\,${String(threshold)}),showinfo`,
+        '-f',
+        'null',
+        '-',
+    ], {
+        failure: 'ffmpeg could not scan this video for scene cuts.',
+        nextStep: 'Try a shorter window, or check that ffmpeg works with network input.',
+        timeoutMs: SCAN_TIMEOUT_MS,
+    });
+    const cuts = parseSceneCuts(stderr, start);
+    return {
+        videoId: info.id,
+        title: info.title,
+        duration: info.duration,
+        start,
+        end,
+        threshold,
+        cuts: cuts.slice(0, MAX_SCENE_CUTS),
+        truncated: cuts.length > MAX_SCENE_CUTS,
+    };
+}
+//# sourceMappingURL=scenes.js.map

package/dist/utils/scenes.js.map

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

package/dist/utils/seconds.d.ts

@@ -0,0 +1,5 @@
+/** Time in the units the tools speak (seconds) and the units ffmpeg and whisper.cpp write (milliseconds). */
+export declare const MILLISECONDS_PER_SECOND = 1000;
+/** Seconds rounded to the nearest millisecond, which is all the precision any source here has. */
+export declare function roundToMillisecond(seconds: number): number;
+//# sourceMappingURL=seconds.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seconds.d.ts","sourceRoot":"","sources":["../../src/utils/seconds.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAE7G,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C,kGAAkG;AAClG,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1D"}

package/dist/utils/seconds.js

@@ -0,0 +1,7 @@
+/** Time in the units the tools speak (seconds) and the units ffmpeg and whisper.cpp write (milliseconds). */
+export const MILLISECONDS_PER_SECOND = 1000;
+/** Seconds rounded to the nearest millisecond, which is all the precision any source here has. */
+export function roundToMillisecond(seconds) {
+    return Math.round(seconds * MILLISECONDS_PER_SECOND) / MILLISECONDS_PER_SECOND;
+}
+//# sourceMappingURL=seconds.js.map

package/dist/utils/seconds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seconds.js","sourceRoot":"","sources":["../../src/utils/seconds.ts"],"names":[],"mappings":"AAAA,6GAA6G;AAE7G,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAE5C,kGAAkG;AAClG,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,uBAAuB,CAAC,GAAG,uBAAuB,CAAC;AACjF,CAAC"}

package/dist/utils/sponsorblock.d.ts

@@ -0,0 +1,24 @@
+/** SponsorBlock's documented categories that mark something a viewer may want to skip. */
+export declare const SPONSOR_CATEGORIES: readonly ["sponsor", "selfpromo", "interaction", "intro", "outro", "preview", "music_offtopic", "filler"];
+export type SponsorCategory = (typeof SPONSOR_CATEGORIES)[number];
+export interface SponsorSegment {
+    category: string;
+    startSeconds: number;
+    endSeconds: number;
+    durationSeconds: number;
+    /** Community votes: higher is more agreed upon. */
+    votes: number;
+}
+/**
+ * The length covered by the segments, with overlaps counted once.
+ *
+ * SponsorBlock categories overlap (a sponsor read inside a self-promotion) and several
+ * submissions can mark the same range, so a plain sum of durations is more than the
+ * video can hold.
+ */
+export declare function coveredSeconds(segments: readonly SponsorSegment[]): number;
+export declare function hashPrefix(videoId: string): string;
+export declare function fetchSponsorSegments(videoId: string, categories?: readonly string[], options?: {
+    timeoutMs?: number;
+}): Promise<SponsorSegment[]>;
+//# sourceMappingURL=sponsorblock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sponsorblock.d.ts","sourceRoot":"","sources":["../../src/utils/sponsorblock.ts"],"names":[],"mappings":"AAuBA,0FAA0F;AAC1F,eAAO,MAAM,kBAAkB,2GASrB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;CACf;AAeD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAa1E;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAElD;AA8DD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,MAAM,EACf,UAAU,GAAE,SAAS,MAAM,EAAuB,EAClD,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnC,OAAO,CAAC,cAAc,EAAE,CAAC,CA6C3B"}