@steipete/summarize-core 0.8.2 → 0.10.0

package/dist/esm/content/link-preview/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/content/link-preview/types.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAU,CAAA"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/content/link-preview/types.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAU,CAAA"}

package/dist/esm/content/transcript/cache.js

@@ -1,7 +1,9 @@
 export const DEFAULT_TTL_MS = 1000 * 60 * 60 * 24 * 7;
 export const NEGATIVE_TTL_MS = 1000 * 60 * 60 * 6;
-export const readTranscriptCache = async ({ url, cacheMode, transcriptCache, }) => {
-    const cached = transcriptCache ? await transcriptCache.get({ url }) : null;
+export const readTranscriptCache = async ({ url, cacheMode, transcriptCache, transcriptTimestamps = false, fileMtime, }) => {
+    const cached = transcriptCache
+        ? await transcriptCache.get({ url, fileMtime: fileMtime ?? null })
+        : null;
     const diagnostics = buildBaseDiagnostics(cacheMode);
     if (!cached) {
         return { cached: null, resolution: null, diagnostics };
@@ -21,10 +23,23 @@ export const readTranscriptCache = async ({ url, cacheMode, transcriptCache, })
     }
     diagnostics.cacheStatus = 'hit';
     diagnostics.notes = appendNote(diagnostics.notes, 'Served transcript from cache');
+    const cachedSegments = extractSegments(cached.metadata);
+    const hasSegments = Boolean(cachedSegments && cachedSegments.length > 0);
+    const timestampsFlag = cached.metadata?.timestamps;
+    if (transcriptTimestamps &&
+        timestampsFlag !== false &&
+        (cachedSegments == null || cachedSegments.length === 0)) {
+        diagnostics.notes = appendNote(diagnostics.notes, 'Cached transcript missing timestamps; fetching fresh copy');
+        return { cached, resolution: null, diagnostics };
+    }
+    if (transcriptTimestamps && timestampsFlag === false) {
+        diagnostics.notes = appendNote(diagnostics.notes, 'Transcript timestamps unavailable');
+    }
     const resolution = {
         text: cached.content,
         source: provider,
         metadata: cached.metadata ?? null,
+        segments: transcriptTimestamps && hasSegments ? cachedSegments : null,
     };
     return { cached, resolution, diagnostics };
 };
@@ -47,6 +62,7 @@ export const mapCachedSource = (source) => {
         return null;
     if (source === 'youtubei' ||
         source === 'captionTracks' ||
+        source === 'embedded' ||
         source === 'yt-dlp' ||
         source === 'podcastTranscript' ||
         source === 'whisper' ||
@@ -57,7 +73,7 @@ export const mapCachedSource = (source) => {
     }
     return 'unknown';
 };
-export const writeTranscriptCache = async ({ url, service, resourceKey, result, transcriptCache, }) => {
+export const writeTranscriptCache = async ({ url, service, resourceKey, result, transcriptCache, fileMtime, }) => {
     if (!transcriptCache) {
         return;
     }
@@ -74,6 +90,16 @@ export const writeTranscriptCache = async ({ url, service, resourceKey, result,
         content: result.text,
         source: resolvedSource,
         metadata: result.metadata ?? null,
+        fileMtime,
     });
 };
+function extractSegments(metadata) {
+    if (!metadata)
+        return null;
+    const segments = metadata.segments;
+    if (!Array.isArray(segments))
+        return null;
+    const normalized = segments.filter((segment) => segment && typeof segment === 'object');
+    return normalized.length > 0 ? normalized : null;
+}
 //# sourceMappingURL=cache.js.map

package/dist/esm/content/transcript/cache.js.map

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

package/dist/esm/content/transcript/index.js

@@ -9,7 +9,7 @@ const PROVIDERS = [
     { id: 'generic', canHandle: canHandleGeneric, fetchTranscript: fetchGeneric },
 ];
 const GENERIC_PROVIDER_ID = 'generic';
-export const resolveTranscriptForLink = async (url, html, deps, { youtubeTranscriptMode, cacheMode: providedCacheMode } = {}) => {
+export const resolveTranscriptForLink = async (url, html, deps, { youtubeTranscriptMode, mediaTranscriptMode, mediaKindHint, transcriptTimestamps, cacheMode: providedCacheMode, fileMtime, } = {}) => {
     const normalizedUrl = url.trim();
     const embeddedYoutubeUrl = !isYouTubeUrlInternal(normalizedUrl) && html
         ? await extractEmbeddedYouTubeUrlFromHtml(html)
@@ -23,6 +23,8 @@ export const resolveTranscriptForLink = async (url, html, deps, { youtubeTranscr
         url: normalizedUrl,
         cacheMode,
         transcriptCache: deps.transcriptCache,
+        transcriptTimestamps: Boolean(transcriptTimestamps),
+        fileMtime: fileMtime ?? null,
     });
     const diagnostics = {
         cacheMode,
@@ -51,14 +53,19 @@ export const resolveTranscriptForLink = async (url, html, deps, { youtubeTranscr
     }
     const providerResult = await executeProvider(provider, baseContext, {
         fetch: deps.fetch,
+        env: deps.env,
         scrapeWithFirecrawl: deps.scrapeWithFirecrawl,
         apifyApiToken: deps.apifyApiToken,
         ytDlpPath: deps.ytDlpPath,
         falApiKey: deps.falApiKey,
         openaiApiKey: deps.openaiApiKey,
+        mediaCache: deps.mediaCache ?? null,
         resolveTwitterCookies: deps.resolveTwitterCookies ?? null,
         onProgress: deps.onProgress ?? null,
         youtubeTranscriptMode: youtubeTranscriptMode ?? 'auto',
+        mediaTranscriptMode: mediaTranscriptMode ?? 'auto',
+        mediaKindHint: mediaKindHint ?? null,
+        transcriptTimestamps: transcriptTimestamps ?? false,
     });
     if (shouldReportProgress) {
         deps.onProgress?.({
@@ -77,12 +84,30 @@ export const resolveTranscriptForLink = async (url, html, deps, { youtubeTranscr
         diagnostics.notes = appendNote(diagnostics.notes, providerResult.notes);
     }
     if (providerResult.source !== null || providerResult.text !== null) {
+        if (transcriptTimestamps) {
+            const nextMeta = { ...(providerResult.metadata ?? {}) };
+            if (providerResult.segments && providerResult.segments.length > 0) {
+                nextMeta.timestamps = true;
+                nextMeta.segments = providerResult.segments;
+            }
+            else if (nextMeta.timestamps == null) {
+                nextMeta.timestamps = false;
+            }
+            providerResult.metadata = nextMeta;
+        }
+        else if (providerResult.segments && providerResult.segments.length > 0) {
+            providerResult.metadata = {
+                ...(providerResult.metadata ?? {}),
+                segments: providerResult.segments,
+            };
+        }
         await writeTranscriptCache({
             url: normalizedUrl,
             service: provider.id,
             resourceKey,
             result: providerResult,
             transcriptCache: deps.transcriptCache,
+            fileMtime,
         });
     }
     if (!providerResult.text && cacheOutcome.cached?.content && cacheMode !== 'bypass') {
@@ -95,6 +120,9 @@ export const resolveTranscriptForLink = async (url, html, deps, { youtubeTranscr
             source: diagnostics.provider,
             metadata: cacheOutcome.cached.metadata ?? null,
             diagnostics,
+            segments: transcriptTimestamps
+                ? resolveSegmentsFromMetadata(cacheOutcome.cached.metadata)
+                : null,
         };
     }
     return {
@@ -102,6 +130,7 @@ export const resolveTranscriptForLink = async (url, html, deps, { youtubeTranscr
         source: providerResult.source,
         metadata: providerResult.metadata ?? null,
         diagnostics,
+        segments: transcriptTimestamps ? (providerResult.segments ?? null) : null,
     };
 };
 const extractResourceKey = (url) => {
@@ -128,4 +157,12 @@ const appendNote = (existing, next) => {
     }
     return `${existing}; ${next}`;
 };
+const resolveSegmentsFromMetadata = (metadata) => {
+    if (!metadata)
+        return null;
+    const segments = metadata.segments;
+    return Array.isArray(segments) && segments.length > 0
+        ? segments
+        : null;
+};
 //# sourceMappingURL=index.js.map

package/dist/esm/content/transcript/index.js.map

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

package/dist/esm/content/transcript/parse.js

@@ -0,0 +1,154 @@
+import { parseTimestampStringToMs, parseTimestampToMs } from './timestamps.js';
+export function vttToSegments(raw) {
+    const normalized = raw.replace(/\r\n/g, '\n');
+    const lines = normalized.split('\n');
+    const segments = [];
+    let idx = 0;
+    while (idx < lines.length) {
+        const line = lines[idx]?.trim() ?? '';
+        if (!line || line.toUpperCase() === 'WEBVTT' || /^(NOTE|STYLE|REGION)\b/i.test(line)) {
+            idx += 1;
+            continue;
+        }
+        if (!line.includes('-->')) {
+            idx += 1;
+            continue;
+        }
+        const [startRaw, rest] = line.split('-->');
+        const endRaw = rest?.trim().split(/\s+/)[0] ?? '';
+        const startMs = parseTimestampStringToMs(startRaw?.trim() ?? '');
+        const endMs = parseTimestampStringToMs(endRaw);
+        idx += 1;
+        const textLines = [];
+        while (idx < lines.length) {
+            const cueLine = lines[idx];
+            if (!cueLine || cueLine.trim().length === 0)
+                break;
+            if (!/^(NOTE|STYLE|REGION)\b/i.test(cueLine.trim())) {
+                textLines.push(cueLine.trim());
+            }
+            idx += 1;
+        }
+        idx += 1;
+        if (startMs == null)
+            continue;
+        const text = textLines.join(' ').replace(/\s+/g, ' ').trim();
+        if (!text)
+            continue;
+        segments.push({
+            startMs,
+            endMs: endMs ?? null,
+            text,
+        });
+    }
+    return segments.length > 0 ? segments : null;
+}
+export function vttToPlainText(raw) {
+    const segments = vttToSegments(raw);
+    if (segments) {
+        return segments
+            .map((segment) => segment.text)
+            .join('\n')
+            .trim();
+    }
+    const lines = raw
+        .replace(/\r\n/g, '\n')
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0)
+        .filter((line) => line.toUpperCase() !== 'WEBVTT')
+        .filter((line) => !/^\d{2}:\d{2}:\d{2}\.\d{3}\s+-->\s+\d{2}:\d{2}:\d{2}\.\d{3}/.test(line))
+        .filter((line) => !/^\d+$/.test(line))
+        .filter((line) => !/^(NOTE|STYLE|REGION)\b/i.test(line));
+    return lines.join('\n').trim();
+}
+function parseSegmentsFromJsonArray(items) {
+    const segments = [];
+    for (const item of items) {
+        if (!item || typeof item !== 'object')
+            continue;
+        const record = item;
+        const text = typeof record.text === 'string'
+            ? record.text
+            : typeof record.utf8 === 'string'
+                ? record.utf8
+                : null;
+        if (!text)
+            continue;
+        const startMs = parseTimestampToMs(record.startMs, false);
+        const endMs = parseTimestampToMs(record.endMs, false);
+        const startSeconds = parseTimestampToMs(record.start, true);
+        const endSeconds = parseTimestampToMs(record.end, true);
+        const start = startMs ?? startSeconds;
+        const end = endMs ?? endSeconds;
+        if (start == null)
+            continue;
+        segments.push({
+            startMs: start,
+            endMs: end ?? null,
+            text: text.replace(/\s+/g, ' ').trim(),
+        });
+    }
+    return segments;
+}
+export function jsonTranscriptToSegments(payload) {
+    if (Array.isArray(payload)) {
+        const segments = parseSegmentsFromJsonArray(payload);
+        return segments.length > 0 ? segments : null;
+    }
+    if (payload && typeof payload === 'object') {
+        const record = payload;
+        const segmentsPayload = record.segments;
+        if (Array.isArray(segmentsPayload)) {
+            const segments = parseSegmentsFromJsonArray(segmentsPayload);
+            return segments.length > 0 ? segments : null;
+        }
+    }
+    return null;
+}
+export function jsonTranscriptToPlainText(payload) {
+    if (Array.isArray(payload)) {
+        const segments = jsonTranscriptToSegments(payload);
+        if (segments) {
+            const text = segments
+                .map((segment) => segment.text)
+                .join('\n')
+                .trim();
+            return text.length > 0 ? text : null;
+        }
+        const parts = payload
+            .map((row) => (row && typeof row === 'object' ? row.text : null))
+            .filter((t) => typeof t === 'string')
+            .map((t) => t.trim())
+            .filter(Boolean);
+        const text = parts.join('\n').trim();
+        return text.length > 0 ? text : null;
+    }
+    if (payload && typeof payload === 'object') {
+        const record = payload;
+        if (typeof record.transcript === 'string' && record.transcript.trim())
+            return record.transcript.trim();
+        if (typeof record.text === 'string' && record.text.trim())
+            return record.text.trim();
+        const segments = record.segments;
+        if (Array.isArray(segments)) {
+            const segmentText = jsonTranscriptToSegments(record);
+            if (segmentText) {
+                const text = segmentText
+                    .map((segment) => segment.text)
+                    .join('\n')
+                    .trim();
+                return text.length > 0 ? text : null;
+            }
+            const parts = segments
+                .map((row) => row && typeof row === 'object' ? row.text : null)
+                .filter((t) => typeof t === 'string')
+                .map((t) => t.trim())
+                .filter(Boolean);
+            const text = parts.join('\n').trim();
+            return text.length > 0 ? text : null;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=parse.js.map

package/dist/esm/content/transcript/parse.js.map

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

package/dist/esm/content/transcript/providers/generic.js

@@ -1,16 +1,69 @@
-import { isWhisperCppReady } from '../../../transcription/whisper.js';
+import { load } from 'cheerio';
 import { isTwitterStatusUrl } from '../../link-preview/content/twitter-utils.js';
+import { isDirectMediaUrl } from '../../url.js';
 import { normalizeTranscriptText } from '../normalize.js';
+import { jsonTranscriptToPlainText, jsonTranscriptToSegments, vttToPlainText, vttToSegments, } from '../parse.js';
+import { resolveTranscriptionAvailability } from './transcription-start.js';
 export const canHandle = () => true;
 export const fetchTranscript = async (context, options) => {
     const attemptedProviders = [];
     const notes = [];
+    const embedded = context.html ? detectEmbeddedMedia(context.html, context.url) : null;
+    const twitterStatus = isTwitterStatusUrl(context.url);
+    const hasEmbeddedMedia = Boolean(embedded?.mediaUrl || embedded?.kind);
+    const mediaKindHint = options.mediaKindHint ?? embedded?.kind ?? null;
+    if (embedded?.track) {
+        attemptedProviders.push('embedded');
+        const caption = await fetchCaptionTrack(options.fetch, embedded.track, notes, Boolean(options.transcriptTimestamps));
+        if (caption?.text) {
+            return {
+                text: normalizeTranscriptText(caption.text),
+                source: 'embedded',
+                segments: options.transcriptTimestamps ? (caption.segments ?? null) : null,
+                attemptedProviders,
+                metadata: {
+                    provider: 'embedded',
+                    kind: embedded.kind,
+                    trackUrl: embedded.track.url,
+                    trackType: embedded.track.type,
+                    trackLanguage: embedded.track.language,
+                },
+                notes: notes.length > 0 ? notes.join('; ') : null,
+            };
+        }
+    }
+    const shouldAttemptMediaTranscript = options.mediaTranscriptMode === 'prefer' || (twitterStatus && hasEmbeddedMedia);
+    const mediaUrl = shouldAttemptMediaTranscript
+        ? (embedded?.mediaUrl ?? (isDirectMediaUrl(context.url) ? context.url : null))
+        : null;
+    if (shouldAttemptMediaTranscript &&
+        (mediaUrl || embedded?.kind || isDirectMediaUrl(context.url))) {
+        const result = await fetchDirectMediaTranscript({
+            url: mediaUrl ?? context.url,
+            options,
+            notes,
+            attemptedProviders,
+            kind: embedded?.kind ?? null,
+        });
+        if (result)
+            return result;
+    }
+    if (twitterStatus && options.mediaTranscriptMode !== 'prefer' && !hasEmbeddedMedia) {
+        return {
+            text: null,
+            source: null,
+            attemptedProviders,
+            metadata: { provider: 'generic', kind: 'twitter', reason: 'media_mode_auto' },
+            notes: 'Twitter transcript skipped (media transcript mode is auto; enable --video-mode transcript to force audio).',
+        };
+    }
     if (!isTwitterStatusUrl(context.url)) {
         return {
             text: null,
             source: null,
             attemptedProviders,
             metadata: { provider: 'generic', reason: 'not_implemented' },
+            notes: notes.length > 0 ? notes.join('; ') : null,
         };
     }
     if (!options.ytDlpPath) {
@@ -22,9 +75,12 @@ export const fetchTranscript = async (context, options) => {
             notes: 'yt-dlp is not configured (set YT_DLP_PATH or ensure yt-dlp is on PATH)',
         };
     }
-    const hasTranscriptionKeys = Boolean(options.openaiApiKey || options.falApiKey);
-    const hasLocalWhisper = await isWhisperCppReady();
-    if (!hasTranscriptionKeys && !hasLocalWhisper) {
+    const transcriptionAvailability = await resolveTranscriptionAvailability({
+        env: options.env,
+        openaiApiKey: options.openaiApiKey,
+        falApiKey: options.falApiKey,
+    });
+    if (!transcriptionAvailability.hasAnyProvider) {
         return {
             text: null,
             source: null,
@@ -48,12 +104,15 @@ export const fetchTranscript = async (context, options) => {
     const mod = await import('./youtube/yt-dlp.js');
     const ytdlpResult = await mod.fetchTranscriptWithYtDlp({
         ytDlpPath: options.ytDlpPath,
+        env: options.env,
         openaiApiKey: options.openaiApiKey,
         falApiKey: options.falApiKey,
+        mediaCache: options.mediaCache ?? null,
         url: context.url,
         onProgress: options.onProgress ?? null,
         service: 'generic',
         extraArgs: extraArgs.length > 0 ? extraArgs : undefined,
+        mediaKind: mediaKindHint,
     });
     if (ytdlpResult.notes.length > 0) {
         notes.push(...ytdlpResult.notes);
@@ -88,4 +147,176 @@ export const fetchTranscript = async (context, options) => {
         notes: notes.length > 0 ? notes.join('; ') : null,
     };
 };
+function detectEmbeddedMedia(html, baseUrl) {
+    const $ = load(html);
+    const trackCandidates = [];
+    $('track[kind="captions"], track[kind="subtitles"]').each((_idx, el) => {
+        const src = $(el).attr('src')?.trim();
+        if (!src)
+            return;
+        const url = resolveAbsoluteUrl(src, baseUrl);
+        if (!url)
+            return;
+        const type = $(el).attr('type')?.trim() ?? null;
+        const language = $(el).attr('srclang')?.trim() ?? $(el).attr('lang')?.trim() ?? null;
+        trackCandidates.push({ url, type, language });
+    });
+    const track = selectPreferredTrack(trackCandidates);
+    const videoUrl = resolveFirstMediaUrl($, baseUrl, 'video');
+    const audioUrl = resolveFirstMediaUrl($, baseUrl, 'audio');
+    const ogVideo = resolveOgMediaUrl($, baseUrl, 'video');
+    const ogAudio = resolveOgMediaUrl($, baseUrl, 'audio');
+    if (videoUrl || ogVideo) {
+        const mediaUrl = pickMediaUrl([videoUrl, ogVideo]);
+        return { kind: 'video', mediaUrl, track };
+    }
+    if (audioUrl || ogAudio) {
+        const mediaUrl = pickMediaUrl([audioUrl, ogAudio]);
+        return { kind: 'audio', mediaUrl, track };
+    }
+    const hasVideoTag = $('video').length > 0;
+    const hasAudioTag = !hasVideoTag && $('audio').length > 0;
+    if (track || hasVideoTag || hasAudioTag) {
+        return { kind: hasAudioTag ? 'audio' : 'video', mediaUrl: null, track };
+    }
+    return null;
+}
+function selectPreferredTrack(tracks) {
+    if (tracks.length === 0)
+        return null;
+    const normalized = tracks.map((track) => ({
+        ...track,
+        language: track.language?.toLowerCase() ?? null,
+    }));
+    const english = normalized.find((track) => track.language?.startsWith('en'));
+    return english ?? normalized[0] ?? null;
+}
+function resolveFirstMediaUrl($, baseUrl, tag) {
+    const direct = $(`${tag}[src]`).first().attr('src') ?? $(`${tag} source[src]`).first().attr('src') ?? null;
+    if (!direct)
+        return null;
+    return resolveAbsoluteUrl(direct, baseUrl);
+}
+function resolveOgMediaUrl($, baseUrl, kind) {
+    const meta = $(`meta[property="og:${kind}"], meta[property="og:${kind}:url"], meta[property="og:${kind}:secure_url"], meta[name="og:${kind}"], meta[name="og:${kind}:url"], meta[name="og:${kind}:secure_url"]`)
+        .first()
+        .attr('content');
+    if (!meta)
+        return null;
+    return resolveAbsoluteUrl(meta, baseUrl);
+}
+function resolveAbsoluteUrl(candidate, baseUrl) {
+    const trimmed = candidate.trim();
+    if (trimmed.length === 0)
+        return null;
+    try {
+        return new URL(trimmed, baseUrl).toString();
+    }
+    catch {
+        return null;
+    }
+}
+function pickMediaUrl(candidates) {
+    let fallback = null;
+    for (const candidate of candidates) {
+        if (!candidate)
+            continue;
+        if (isDirectMediaUrl(candidate))
+            return candidate;
+        if (!fallback)
+            fallback = candidate;
+    }
+    return fallback;
+}
+async function fetchCaptionTrack(fetchImpl, track, notes, includeSegments) {
+    try {
+        const res = await fetchImpl(track.url, {
+            headers: { accept: 'text/vtt,text/plain,application/json;q=0.9,*/*;q=0.8' },
+        });
+        if (!res.ok) {
+            notes.push(`Embedded captions fetch failed (${res.status})`);
+            return null;
+        }
+        const body = await res.text();
+        const contentType = res.headers.get('content-type')?.toLowerCase() ?? '';
+        const type = track.type?.toLowerCase() ?? '';
+        if (type.includes('application/json') || contentType.includes('application/json')) {
+            try {
+                const parsed = JSON.parse(body);
+                const text = jsonTranscriptToPlainText(parsed);
+                if (!text)
+                    return null;
+                const segments = includeSegments ? jsonTranscriptToSegments(parsed) : null;
+                return { text, segments };
+            }
+            catch {
+                notes.push('Embedded captions JSON parse failed');
+                return null;
+            }
+        }
+        if (type.includes('text/vtt') ||
+            contentType.includes('text/vtt') ||
+            track.url.toLowerCase().endsWith('.vtt')) {
+            const plain = vttToPlainText(body);
+            if (plain.length === 0)
+                return null;
+            const segments = includeSegments ? vttToSegments(body) : null;
+            return { text: plain, segments };
+        }
+        const trimmed = body.trim();
+        return trimmed.length > 0 ? { text: trimmed, segments: null } : null;
+    }
+    catch (error) {
+        notes.push(`Embedded captions fetch failed: ${error instanceof Error ? error.message : error}`);
+        return null;
+    }
+}
+async function fetchDirectMediaTranscript({ url, options, notes, attemptedProviders, kind, }) {
+    if (!options.ytDlpPath) {
+        notes.push('yt-dlp is not configured (set YT_DLP_PATH or ensure yt-dlp is on PATH)');
+        return null;
+    }
+    const transcriptionAvailability = await resolveTranscriptionAvailability({
+        env: options.env,
+        openaiApiKey: options.openaiApiKey,
+        falApiKey: options.falApiKey,
+    });
+    if (!transcriptionAvailability.hasAnyProvider) {
+        notes.push('Missing transcription provider (install whisper-cpp or set OPENAI_API_KEY/FAL_KEY)');
+        return null;
+    }
+    attemptedProviders.push('yt-dlp');
+    const mod = await import('./youtube/yt-dlp.js');
+    const ytdlpResult = await mod.fetchTranscriptWithYtDlp({
+        ytDlpPath: options.ytDlpPath,
+        env: options.env,
+        openaiApiKey: options.openaiApiKey,
+        falApiKey: options.falApiKey,
+        mediaCache: options.mediaCache ?? null,
+        url,
+        onProgress: options.onProgress ?? null,
+        service: 'generic',
+        mediaKind: kind ?? options.mediaKindHint ?? null,
+    });
+    if (ytdlpResult.notes.length > 0) {
+        notes.push(...ytdlpResult.notes);
+    }
+    if (ytdlpResult.text) {
+        return {
+            text: normalizeTranscriptText(ytdlpResult.text),
+            source: 'yt-dlp',
+            attemptedProviders,
+            metadata: {
+                provider: 'generic',
+                kind: kind ?? 'media',
+                transcriptionProvider: ytdlpResult.provider,
+            },
+            notes: notes.length > 0 ? notes.join('; ') : null,
+        };
+    }
+    if (ytdlpResult.error) {
+        notes.push(`yt-dlp transcription failed: ${ytdlpResult.error.message}`);
+    }
+    return null;
+}
 //# sourceMappingURL=generic.js.map