@steipete/summarize-core 0.7.0

package/dist/esm/transcription/whisper/ffmpeg.js

@@ -0,0 +1,179 @@
+import { spawn } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+import { promises as fs } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+export async function isFfmpegAvailable() {
+    return new Promise((resolve) => {
+        const proc = spawn('ffmpeg', ['-version'], { stdio: ['ignore', 'ignore', 'ignore'] });
+        proc.on('error', () => resolve(false));
+        proc.on('close', (code) => resolve(code === 0));
+    });
+}
+export async function probeMediaDurationSecondsWithFfprobe(filePath) {
+    // ffprobe is part of the ffmpeg suite. We keep this optional (best-effort) so environments
+    // without ffmpeg still work; it only powers nicer progress output.
+    return new Promise((resolve) => {
+        const args = [
+            '-v',
+            'error',
+            '-show_entries',
+            'format=duration',
+            '-of',
+            'default=noprint_wrappers=1:nokey=1',
+            filePath,
+        ];
+        const proc = spawn('ffprobe', args, { stdio: ['ignore', 'pipe', 'ignore'] });
+        let stdout = '';
+        proc.stdout?.setEncoding('utf8');
+        proc.stdout?.on('data', (chunk) => {
+            if (stdout.length > 2048)
+                return;
+            stdout += chunk;
+        });
+        proc.on('error', () => resolve(null));
+        proc.on('close', (code) => {
+            if (code !== 0) {
+                resolve(null);
+                return;
+            }
+            const trimmed = stdout.trim();
+            const parsed = Number(trimmed);
+            resolve(Number.isFinite(parsed) && parsed > 0 ? parsed : null);
+        });
+    });
+}
+export async function runFfmpegSegment({ inputPath, outputPattern, segmentSeconds, }) {
+    await new Promise((resolve, reject) => {
+        const args = [
+            '-hide_banner',
+            '-loglevel',
+            'error',
+            '-i',
+            inputPath,
+            '-vn',
+            '-ac',
+            '1',
+            '-ar',
+            '16000',
+            '-b:a',
+            '32k',
+            '-f',
+            'segment',
+            '-segment_time',
+            String(segmentSeconds),
+            '-reset_timestamps',
+            '1',
+            outputPattern,
+        ];
+        const proc = spawn('ffmpeg', args, { stdio: ['ignore', 'ignore', 'pipe'] });
+        let stderr = '';
+        proc.stderr?.setEncoding('utf8');
+        proc.stderr?.on('data', (chunk) => {
+            if (stderr.length > 8192)
+                return;
+            stderr += chunk;
+        });
+        proc.on('error', (error) => reject(error));
+        proc.on('close', (code) => {
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            const detail = stderr.trim();
+            reject(new Error(`ffmpeg failed (${code ?? 'unknown'}): ${detail || 'unknown error'}`));
+        });
+    });
+}
+export async function runFfmpegTranscodeToMp3({ inputPath, outputPath, }) {
+    await runFfmpegTranscode({
+        inputPath,
+        outputPath,
+        mode: 'strict',
+        args: [
+            '-hide_banner',
+            '-loglevel',
+            'error',
+            '-i',
+            inputPath,
+            '-vn',
+            '-ac',
+            '1',
+            '-ar',
+            '16000',
+            '-b:a',
+            '64k',
+            outputPath,
+        ],
+    });
+}
+export async function runFfmpegTranscodeToMp3Lenient({ inputPath, outputPath, }) {
+    await runFfmpegTranscode({
+        inputPath,
+        outputPath,
+        mode: 'lenient',
+        args: [
+            '-hide_banner',
+            '-loglevel',
+            'error',
+            '-err_detect',
+            'ignore_err',
+            '-fflags',
+            '+genpts',
+            '-i',
+            inputPath,
+            '-vn',
+            '-sn',
+            '-dn',
+            '-map',
+            '0:a:0?',
+            '-ac',
+            '1',
+            '-ar',
+            '16000',
+            '-b:a',
+            '64k',
+            outputPath,
+        ],
+    });
+}
+export async function transcodeBytesToMp3(bytes) {
+    const inputPath = join(tmpdir(), `summarize-whisper-input-${randomUUID()}.bin`);
+    const outputPath = join(tmpdir(), `summarize-whisper-output-${randomUUID()}.mp3`);
+    try {
+        await fs.writeFile(inputPath, bytes);
+        try {
+            await runFfmpegTranscodeToMp3({ inputPath, outputPath });
+        }
+        catch (_error) {
+            await runFfmpegTranscodeToMp3Lenient({ inputPath, outputPath });
+        }
+        return new Uint8Array(await fs.readFile(outputPath));
+    }
+    finally {
+        await fs.unlink(inputPath).catch(() => { });
+        await fs.unlink(outputPath).catch(() => { });
+    }
+}
+async function runFfmpegTranscode({ inputPath, outputPath, mode, args, }) {
+    await new Promise((resolve, reject) => {
+        const proc = spawn('ffmpeg', args, { stdio: ['ignore', 'ignore', 'pipe'] });
+        let stderr = '';
+        proc.stderr?.setEncoding('utf8');
+        proc.stderr?.on('data', (chunk) => {
+            if (stderr.length > 8192)
+                return;
+            stderr += chunk;
+        });
+        proc.on('error', (error) => reject(error));
+        proc.on('close', (code) => {
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            const detail = stderr.trim();
+            reject(new Error(`ffmpeg ${mode} transcode failed (${code ?? 'unknown'}) for ${inputPath} -> ${outputPath}: ${detail || 'unknown error'}`));
+        });
+    });
+}
+//# sourceMappingURL=ffmpeg.js.map

package/dist/esm/transcription/whisper/ffmpeg.js.map

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

package/dist/esm/transcription/whisper/openai.js

@@ -0,0 +1,47 @@
+import { MAX_ERROR_DETAIL_CHARS, TRANSCRIPTION_TIMEOUT_MS } from './constants.js';
+import { ensureWhisperFilenameExtension, toArrayBuffer } from './utils.js';
+export async function transcribeWithOpenAi(bytes, mediaType, filename, apiKey) {
+    const form = new FormData();
+    const providedName = filename?.trim() ? filename.trim() : 'media';
+    // Whisper sometimes relies on the filename extension for format detection; ensure a reasonable one.
+    const safeName = ensureWhisperFilenameExtension(providedName, mediaType);
+    form.append('file', new Blob([toArrayBuffer(bytes)], { type: mediaType }), safeName);
+    form.append('model', 'whisper-1');
+    const response = await globalThis.fetch('https://api.openai.com/v1/audio/transcriptions', {
+        method: 'POST',
+        headers: { Authorization: `Bearer ${apiKey}` },
+        body: form,
+        signal: AbortSignal.timeout(TRANSCRIPTION_TIMEOUT_MS),
+    });
+    if (!response.ok) {
+        const detail = await readErrorDetail(response);
+        const suffix = detail ? `: ${detail}` : '';
+        throw new Error(`OpenAI transcription failed (${response.status})${suffix}`);
+    }
+    const payload = (await response.json());
+    if (typeof payload?.text !== 'string')
+        return null;
+    const trimmed = payload.text.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+export function shouldRetryOpenAiViaFfmpeg(error) {
+    const msg = error.message.toLowerCase();
+    return (msg.includes('unrecognized file format') ||
+        msg.includes('could not be decoded') ||
+        msg.includes('format is not supported'));
+}
+async function readErrorDetail(response) {
+    try {
+        const text = await response.text();
+        const trimmed = text.trim();
+        if (!trimmed)
+            return null;
+        return trimmed.length > MAX_ERROR_DETAIL_CHARS
+            ? `${trimmed.slice(0, MAX_ERROR_DETAIL_CHARS)}…`
+            : trimmed;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=openai.js.map

package/dist/esm/transcription/whisper/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../../../src/transcription/whisper/openai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AACjF,OAAO,EAAE,8BAA8B,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1E,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,KAAiB,EACjB,SAAiB,EACjB,QAAuB,EACvB,MAAc;IAEd,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAA;IAC3B,MAAM,YAAY,GAAG,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAA;IACjE,oGAAoG;IACpG,MAAM,QAAQ,GAAG,8BAA8B,CAAC,YAAY,EAAE,SAAS,CAAC,CAAA;IACxE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAA;IACpF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;IAEjC,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,gDAAgD,EAAE;QACxF,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,MAAM,EAAE,EAAE;QAC9C,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,wBAAwB,CAAC;KACtD,CAAC,CAAA;IAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAA;QAC9C,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAC1C,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC,CAAA;IAC9E,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAuB,CAAA;IAC7D,IAAI,OAAO,OAAO,EAAE,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAA;IAClD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;IACnC,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAA;AAC5C,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAAY;IACrD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAA;IACvC,OAAO,CACL,GAAG,CAAC,QAAQ,CAAC,0BAA0B,CAAC;QACxC,GAAG,CAAC,QAAQ,CAAC,sBAAsB,CAAC;QACpC,GAAG,CAAC,QAAQ,CAAC,yBAAyB,CAAC,CACxC,CAAA;AACH,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,QAAkB;IAC/C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAClC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;QAC3B,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAA;QACzB,OAAO,OAAO,CAAC,MAAM,GAAG,sBAAsB;YAC5C,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,sBAAsB,CAAC,GAAG;YAChD,CAAC,CAAC,OAAO,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC"}

package/dist/esm/transcription/whisper/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/transcription/whisper/types.js.map

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

package/dist/esm/transcription/whisper/utils.js

@@ -0,0 +1,63 @@
+import { promises as fs } from 'node:fs';
+export function wrapError(prefix, error) {
+    if (error instanceof Error) {
+        return new Error(`${prefix}: ${error.message}`, { cause: error });
+    }
+    return new Error(`${prefix}: ${String(error)}`);
+}
+export function toArrayBuffer(view) {
+    const buffer = view.buffer;
+    return buffer.slice(view.byteOffset, view.byteOffset + view.byteLength);
+}
+export function ensureWhisperFilenameExtension(name, mediaType) {
+    const trimmed = name.trim();
+    const base = trimmed.length > 0 ? trimmed : 'media';
+    const hasExtension = (() => {
+        const dot = base.lastIndexOf('.');
+        if (dot <= 0)
+            return false;
+        if (dot === base.length - 1)
+            return false;
+        return true;
+    })();
+    if (hasExtension)
+        return base;
+    const type = mediaType.toLowerCase().split(';')[0]?.trim() ?? '';
+    const ext = type === 'audio/mpeg' || type === 'audio/mp3' || type === 'audio/mpga'
+        ? 'mp3'
+        : type === 'video/mp4' || type === 'audio/mp4' || type === 'application/mp4'
+            ? 'mp4'
+            : type === 'audio/x-wav' || type === 'audio/wav'
+                ? 'wav'
+                : type === 'audio/flac'
+                    ? 'flac'
+                    : type === 'audio/webm' || type === 'video/webm'
+                        ? 'webm'
+                        : type === 'audio/ogg' || type === 'audio/oga' || type === 'application/ogg'
+                            ? 'ogg'
+                            : 'mp3';
+    return `${base}.${ext}`;
+}
+export async function readFirstBytes(filePath, maxBytes) {
+    const handle = await fs.open(filePath, 'r');
+    try {
+        const buffer = Buffer.allocUnsafe(maxBytes);
+        const read = await handle.read(buffer, 0, maxBytes, 0);
+        return new Uint8Array(buffer.slice(0, read.bytesRead));
+    }
+    finally {
+        await handle.close().catch(() => { });
+    }
+}
+export function formatBytes(bytes) {
+    const units = ['B', 'KB', 'MB', 'GB'];
+    let value = bytes;
+    let idx = 0;
+    while (value >= 1024 && idx < units.length - 1) {
+        value /= 1024;
+        idx += 1;
+    }
+    const decimals = value >= 10 || idx === 0 ? 0 : 1;
+    return `${value.toFixed(decimals)}${units[idx]}`;
+}
+//# sourceMappingURL=utils.js.map

package/dist/esm/transcription/whisper/utils.js.map

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

package/dist/esm/transcription/whisper/whisper-cpp.js

@@ -0,0 +1,227 @@
+import { spawn } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+import { promises as fs } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { DISABLE_LOCAL_WHISPER_CPP_ENV, WHISPER_CPP_BINARY_ENV, WHISPER_CPP_MODEL_PATH_ENV, } from './constants.js';
+import { isFfmpegAvailable, runFfmpegTranscodeToMp3, runFfmpegTranscodeToMp3Lenient, } from './ffmpeg.js';
+import { wrapError } from './utils.js';
+export async function isWhisperCppReady() {
+    if (!isWhisperCppEnabled())
+        return false;
+    if (!(await isWhisperCliAvailable()))
+        return false;
+    const model = await resolveWhisperCppModelPath();
+    return Boolean(model);
+}
+export async function resolveWhisperCppModelNameForDisplay() {
+    const modelPath = await resolveWhisperCppModelPath();
+    return modelPath ? resolveWhisperCppModelLabelFromPath(modelPath) : null;
+}
+export async function transcribeWithWhisperCppFile({ filePath, mediaType, totalDurationSeconds, onProgress, }) {
+    const notes = [];
+    const modelPath = await resolveWhisperCppModelPath();
+    if (!modelPath) {
+        return {
+            text: null,
+            provider: null,
+            error: new Error('whisper.cpp model not found (set SUMMARIZE_WHISPER_CPP_MODEL_PATH)'),
+            notes,
+        };
+    }
+    const canUseDirectly = isWhisperCppSupportedMediaType(mediaType);
+    const canTranscode = !canUseDirectly && (await isFfmpegAvailable());
+    if (!canUseDirectly && !canTranscode) {
+        return {
+            text: null,
+            provider: 'whisper.cpp',
+            error: new Error(`whisper.cpp supports only flac/mp3/ogg/wav (mediaType=${mediaType}); install ffmpeg to transcode`),
+            notes,
+        };
+    }
+    const effectivePath = (() => {
+        if (canUseDirectly)
+            return { path: filePath, cleanup: null };
+        if (!canTranscode)
+            return { path: filePath, cleanup: null };
+        const mp3Path = join(tmpdir(), `summarize-whisper-cpp-${randomUUID()}.mp3`);
+        return {
+            path: mp3Path,
+            cleanup: async () => {
+                await fs.unlink(mp3Path).catch(() => { });
+            },
+        };
+    })();
+    try {
+        if (!canUseDirectly && canTranscode) {
+            // whisper-cli supports only a few audio formats. We transcode via ffmpeg when possible to
+            // keep “any media file” working locally too.
+            try {
+                await runFfmpegTranscodeToMp3({ inputPath: filePath, outputPath: effectivePath.path });
+                notes.push('whisper.cpp: transcoded media to MP3 via ffmpeg');
+            }
+            catch (error) {
+                await runFfmpegTranscodeToMp3Lenient({
+                    inputPath: filePath,
+                    outputPath: effectivePath.path,
+                });
+                notes.push('whisper.cpp: transcoded media to MP3 via ffmpeg (lenient)');
+                notes.push(`whisper.cpp: strict transcode failed: ${wrapError('ffmpeg', error).message}`);
+            }
+            onProgress?.({
+                partIndex: null,
+                parts: null,
+                processedDurationSeconds: null,
+                totalDurationSeconds,
+            });
+        }
+        const outputBase = join(tmpdir(), `summarize-whisper-cpp-out-${randomUUID()}`);
+        const outputTxt = `${outputBase}.txt`;
+        const args = [
+            '--model',
+            modelPath,
+            '--language',
+            'auto',
+            '--no-timestamps',
+            '--no-prints',
+            '--print-progress',
+            '--output-txt',
+            '--output-file',
+            outputBase,
+            effectivePath.path,
+        ];
+        try {
+            await new Promise((resolve, reject) => {
+                const proc = spawn(resolveWhisperCppBinary(), args, { stdio: ['ignore', 'ignore', 'pipe'] });
+                let stderr = '';
+                proc.stderr?.setEncoding('utf8');
+                let lastProgressPercent = -1;
+                proc.stderr?.on('data', (chunk) => {
+                    if (stderr.length <= 8192) {
+                        stderr += chunk;
+                    }
+                    // Progress output from `whisper-cli --print-progress` arrives on stderr. We parse it
+                    // best-effort and map to seconds when we know the total duration.
+                    const lines = chunk.split(/\r?\n/);
+                    for (const line of lines) {
+                        const match = line.match(/progress\s*=\s*(\d{1,3})%/i);
+                        if (!match)
+                            continue;
+                        const raw = Number(match[1]);
+                        if (!Number.isFinite(raw))
+                            continue;
+                        const pct = Math.max(0, Math.min(100, Math.round(raw)));
+                        if (pct === lastProgressPercent)
+                            continue;
+                        lastProgressPercent = pct;
+                        const processed = typeof totalDurationSeconds === 'number' && totalDurationSeconds > 0
+                            ? (totalDurationSeconds * pct) / 100
+                            : null;
+                        onProgress?.({
+                            partIndex: null,
+                            parts: null,
+                            processedDurationSeconds: processed,
+                            totalDurationSeconds,
+                        });
+                    }
+                });
+                proc.on('error', reject);
+                proc.on('close', (code) => {
+                    if (code === 0) {
+                        resolve();
+                        return;
+                    }
+                    reject(new Error(`whisper.cpp failed (${code ?? 'unknown'}): ${stderr.trim()}`));
+                });
+            });
+        }
+        catch (error) {
+            return {
+                text: null,
+                provider: 'whisper.cpp',
+                error: wrapError('whisper.cpp failed', error),
+                notes,
+            };
+        }
+        const raw = await fs.readFile(outputTxt, 'utf8').catch(() => '');
+        await fs.unlink(outputTxt).catch(() => { });
+        const text = raw.trim();
+        if (!text) {
+            return {
+                text: null,
+                provider: 'whisper.cpp',
+                error: new Error('whisper.cpp returned empty text'),
+                notes,
+            };
+        }
+        notes.push(`whisper.cpp: model=${resolveWhisperCppModelLabelFromPath(modelPath)}`);
+        return { text, provider: 'whisper.cpp', error: null, notes };
+    }
+    finally {
+        await effectivePath.cleanup?.().catch(() => { });
+    }
+}
+function isWhisperCppEnabled() {
+    return (process.env[DISABLE_LOCAL_WHISPER_CPP_ENV] ?? '').trim() !== '1';
+}
+async function isWhisperCliAvailable() {
+    const bin = resolveWhisperCppBinary();
+    return new Promise((resolve) => {
+        const proc = spawn(bin, ['--help'], { stdio: ['ignore', 'ignore', 'ignore'] });
+        proc.on('error', () => resolve(false));
+        proc.on('close', (code) => resolve(code === 0));
+    });
+}
+function resolveWhisperCppBinary() {
+    const override = (process.env[WHISPER_CPP_BINARY_ENV] ?? '').trim();
+    return override.length > 0 ? override : 'whisper-cli';
+}
+async function resolveWhisperCppModelPath() {
+    const override = (process.env[WHISPER_CPP_MODEL_PATH_ENV] ?? '').trim();
+    if (override) {
+        try {
+            const stat = await fs.stat(override);
+            return stat.isFile() ? override : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    const home = (process.env.HOME ?? process.env.USERPROFILE ?? '').trim();
+    const cacheCandidate = home
+        ? join(home, '.summarize', 'cache', 'whisper-cpp', 'models', 'ggml-base.bin')
+        : null;
+    if (cacheCandidate) {
+        try {
+            const stat = await fs.stat(cacheCandidate);
+            if (stat.isFile())
+                return cacheCandidate;
+        }
+        catch {
+            // ignore
+        }
+    }
+    return null;
+}
+function resolveWhisperCppModelLabelFromPath(modelPath) {
+    const base = modelPath.split('/').pop() ?? modelPath;
+    let name = base
+        .replace(/^ggml-/, '')
+        .replace(/\.bin$/i, '')
+        .replace(/\.en$/i, '');
+    name = name.trim();
+    return name.length > 0 ? name : base;
+}
+function isWhisperCppSupportedMediaType(mediaType) {
+    const type = mediaType.toLowerCase().split(';')[0]?.trim() ?? '';
+    return (type === 'audio/mpeg' ||
+        type === 'audio/mp3' ||
+        type === 'audio/mpga' ||
+        type === 'audio/ogg' ||
+        type === 'audio/oga' ||
+        type === 'application/ogg' ||
+        type === 'audio/flac' ||
+        type === 'audio/x-wav' ||
+        type === 'audio/wav');
+}
+//# sourceMappingURL=whisper-cpp.js.map

package/dist/esm/transcription/whisper/whisper-cpp.js.map

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

package/dist/esm/transcription/whisper.js

@@ -0,0 +1,5 @@
+export { MAX_OPENAI_UPLOAD_BYTES } from './whisper/constants.js';
+export { transcribeMediaFileWithWhisper, transcribeMediaWithWhisper } from './whisper/core.js';
+export { isFfmpegAvailable, probeMediaDurationSecondsWithFfprobe } from './whisper/ffmpeg.js';
+export { isWhisperCppReady, resolveWhisperCppModelNameForDisplay, } from './whisper/whisper-cpp.js';
+//# sourceMappingURL=whisper.js.map

package/dist/esm/transcription/whisper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"whisper.js","sourceRoot":"","sources":["../../../src/transcription/whisper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,EAAE,8BAA8B,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAA;AAC9F,OAAO,EAAE,iBAAiB,EAAE,oCAAoC,EAAE,MAAM,qBAAqB,CAAA;AAM7F,OAAO,EACL,iBAAiB,EACjB,oCAAoC,GACrC,MAAM,0BAA0B,CAAA"}

package/dist/types/content/index.d.ts

@@ -0,0 +1,5 @@
+export { createLinkPreviewClient, type LinkPreviewClient, type LinkPreviewClientOptions, } from './link-preview/client.js';
+export { DEFAULT_CACHE_MODE, DEFAULT_MAX_CONTENT_CHARACTERS, DEFAULT_TIMEOUT_MS, type ExtractedLinkContent, type FetchLinkContentOptions, } from './link-preview/content/types.js';
+export type { ConvertHtmlToMarkdown, FirecrawlScrapeResult, LinkPreviewDeps, LinkPreviewProgressEvent, ReadTweetWithBird, ScrapeWithFirecrawl, TranscriptCache, } from './link-preview/deps.js';
+export { ProgressKind } from './link-preview/deps.js';
+export { CACHE_MODES, type CacheMode, type CacheStatus, type TranscriptSource, } from './link-preview/types.js';

package/dist/types/content/link-preview/client.d.ts

@@ -0,0 +1,18 @@
+import type { ExtractedLinkContent, FetchLinkContentOptions } from './content/types.js';
+import type { ConvertHtmlToMarkdown, LinkPreviewDeps, LinkPreviewProgressEvent, ScrapeWithFirecrawl, TranscriptCache } from './deps.js';
+export interface LinkPreviewClient {
+    fetchLinkContent(url: string, options?: FetchLinkContentOptions): Promise<ExtractedLinkContent>;
+}
+export interface LinkPreviewClientOptions {
+    fetch?: typeof fetch;
+    scrapeWithFirecrawl?: ScrapeWithFirecrawl | null;
+    apifyApiToken?: string | null;
+    ytDlpPath?: string | null;
+    falApiKey?: string | null;
+    openaiApiKey?: string | null;
+    convertHtmlToMarkdown?: ConvertHtmlToMarkdown | null;
+    transcriptCache?: TranscriptCache | null;
+    readTweetWithBird?: LinkPreviewDeps['readTweetWithBird'];
+    onProgress?: ((event: LinkPreviewProgressEvent) => void) | null;
+}
+export declare function createLinkPreviewClient(options?: LinkPreviewClientOptions): LinkPreviewClient;

package/dist/types/content/link-preview/content/article.d.ts

@@ -0,0 +1,4 @@
+export declare function sanitizeHtmlForMarkdownConversion(html: string): string;
+export declare function extractArticleContent(html: string): string;
+export declare function collectSegmentsFromHtml(html: string): string[];
+export declare function extractPlainText(html: string): string;

package/dist/types/content/link-preview/content/cleaner.d.ts

@@ -0,0 +1,12 @@
+export interface ContentBudgetResult {
+    content: string;
+    truncated: boolean;
+    totalCharacters: number;
+    wordCount: number;
+}
+export declare function normalizeForPrompt(input: string): string;
+export declare function normalizeWhitespace(input: string): string;
+export declare function decodeHtmlEntities(input: string): string;
+export declare function normalizeCandidate(value: string | null | undefined): string | null;
+export declare function clipAtSentenceBoundary(input: string, maxLength: number): string;
+export declare function applyContentBudget(baseContent: string, maxCharacters: number): ContentBudgetResult;

package/dist/types/content/link-preview/content/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const BLOCKED_HTML_HINT_PATTERN: RegExp;
+export declare const MIN_HTML_CONTENT_CHARACTERS = 200;
+export declare const MIN_READABILITY_CONTENT_CHARACTERS = 200;
+export declare const MIN_METADATA_DESCRIPTION_CHARACTERS = 120;
+export declare const READABILITY_RELATIVE_THRESHOLD = 0.6;
+export declare const MIN_HTML_DOCUMENT_CHARACTERS_FOR_FALLBACK = 5000;

package/dist/types/content/link-preview/content/fetcher.d.ts

@@ -0,0 +1,16 @@
+import type { FirecrawlScrapeResult, LinkPreviewProgressEvent, ScrapeWithFirecrawl } from '../deps.js';
+import type { CacheMode, FirecrawlDiagnostics } from '../types.js';
+export interface FirecrawlFetchResult {
+    payload: FirecrawlScrapeResult | null;
+    diagnostics: FirecrawlDiagnostics;
+}
+export declare function fetchHtmlDocument(fetchImpl: typeof fetch, url: string, { timeoutMs, onProgress, }?: {
+    timeoutMs?: number;
+    onProgress?: ((event: LinkPreviewProgressEvent) => void) | null;
+}): Promise<string>;
+export declare function fetchWithFirecrawl(url: string, scrapeWithFirecrawl: ScrapeWithFirecrawl | null, options?: {
+    timeoutMs?: number;
+    cacheMode?: CacheMode;
+    onProgress?: ((event: LinkPreviewProgressEvent) => void) | null;
+    reason?: string | null;
+}): Promise<FirecrawlFetchResult>;