@steipete/summarize-core 0.7.0

package/dist/esm/prompts/file.js

@@ -0,0 +1,48 @@
+import { formatOutputLanguageInstruction } from '../language.js';
+export function buildFileSummaryPrompt({ filename, mediaType, outputLanguage, summaryLength, contentLength, }) {
+    const contentCharacters = typeof contentLength === 'number' ? contentLength : null;
+    const effectiveSummaryLength = typeof summaryLength === 'string'
+        ? summaryLength
+        : contentCharacters &&
+            contentCharacters > 0 &&
+            summaryLength.maxCharacters > contentCharacters
+            ? { maxCharacters: contentCharacters }
+            : summaryLength;
+    const maxCharactersLine = typeof effectiveSummaryLength === 'string'
+        ? ''
+        : `Target length: up to ${effectiveSummaryLength.maxCharacters.toLocaleString()} characters total (including Markdown and whitespace). Hard limit: do not exceed it.`;
+    const contentLengthLine = contentCharacters && contentCharacters > 0
+        ? `Extracted content length: ${contentCharacters.toLocaleString()} characters. Hard limit: never exceed this length. If the requested length is larger, do not pad—finish early rather than adding filler.`
+        : '';
+    const headerLines = [
+        filename ? `Filename: ${filename}` : null,
+        mediaType ? `Media type: ${mediaType}` : null,
+    ].filter(Boolean);
+    const languageInstruction = formatOutputLanguageInstruction(outputLanguage ?? { kind: 'auto' });
+    const prompt = `You summarize files for curious users. Summarize the attached file. Be factual and do not invent details. Format the answer in Markdown. Do not use emojis. ${maxCharactersLine} ${contentLengthLine}
+${languageInstruction}
+
+${headerLines.length > 0 ? `${headerLines.join('\n')}\n\n` : ''}Return only the summary.`;
+    return prompt;
+}
+export function buildFileTextSummaryPrompt({ filename, originalMediaType, contentMediaType, outputLanguage, summaryLength, contentLength, }) {
+    const effectiveSummaryLength = typeof summaryLength === 'string'
+        ? summaryLength
+        : summaryLength.maxCharacters > contentLength
+            ? { maxCharacters: contentLength }
+            : summaryLength;
+    const maxCharactersLine = typeof effectiveSummaryLength === 'string'
+        ? ''
+        : `Target length: up to ${effectiveSummaryLength.maxCharacters.toLocaleString()} characters total (including Markdown and whitespace). Hard limit: do not exceed it.`;
+    const headerLines = [
+        filename ? `Filename: ${filename}` : null,
+        originalMediaType ? `Original media type: ${originalMediaType}` : null,
+        `Provided as: ${contentMediaType}`,
+        `Extracted content length: ${contentLength.toLocaleString()} characters. Hard limit: never exceed this length. If the requested length is larger, do not pad—finish early rather than adding filler.`,
+    ].filter(Boolean);
+    const languageInstruction = formatOutputLanguageInstruction(outputLanguage ?? { kind: 'auto' });
+    return `You summarize files for curious users. Summarize the file content below. Be factual and do not invent details. Format the answer in Markdown. Do not use emojis. ${maxCharactersLine} ${languageInstruction}
+
+${headerLines.length > 0 ? `${headerLines.join('\n')}\n\n` : ''}Return only the summary.`;
+}
+//# sourceMappingURL=file.js.map

package/dist/esm/prompts/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../../src/prompts/file.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,+BAA+B,EAAE,MAAM,gBAAgB,CAAA;AAGhE,MAAM,UAAU,sBAAsB,CAAC,EACrC,QAAQ,EACR,SAAS,EACT,cAAc,EACd,aAAa,EACb,aAAa,GAOd;IACC,MAAM,iBAAiB,GAAG,OAAO,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAA;IAClF,MAAM,sBAAsB,GAC1B,OAAO,aAAa,KAAK,QAAQ;QAC/B,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,iBAAiB;YACf,iBAAiB,GAAG,CAAC;YACrB,aAAa,CAAC,aAAa,GAAG,iBAAiB;YACjD,CAAC,CAAC,EAAE,aAAa,EAAE,iBAAiB,EAAE;YACtC,CAAC,CAAC,aAAa,CAAA;IACrB,MAAM,iBAAiB,GACrB,OAAO,sBAAsB,KAAK,QAAQ;QACxC,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,wBAAwB,sBAAsB,CAAC,aAAa,CAAC,cAAc,EAAE,sFAAsF,CAAA;IACzK,MAAM,iBAAiB,GACrB,iBAAiB,IAAI,iBAAiB,GAAG,CAAC;QACxC,CAAC,CAAC,6BAA6B,iBAAiB,CAAC,cAAc,EAAE,0IAA0I;QAC3M,CAAC,CAAC,EAAE,CAAA;IAER,MAAM,WAAW,GAAG;QAClB,QAAQ,CAAC,CAAC,CAAC,aAAa,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI;QACzC,SAAS,CAAC,CAAC,CAAC,eAAe,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI;KAC9C,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAEjB,MAAM,mBAAmB,GAAG,+BAA+B,CAAC,cAAc,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;IAC/F,MAAM,MAAM,GAAG,+JAA+J,iBAAiB,IAAI,iBAAiB;EACpN,mBAAmB;;EAEnB,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,0BAA0B,CAAA;IAEvF,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,EACzC,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,aAAa,GAQd;IACC,MAAM,sBAAsB,GAC1B,OAAO,aAAa,KAAK,QAAQ;QAC/B,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,aAAa,CAAC,aAAa,GAAG,aAAa;YAC3C,CAAC,CAAC,EAAE,aAAa,EAAE,aAAa,EAAE;YAClC,CAAC,CAAC,aAAa,CAAA;IACrB,MAAM,iBAAiB,GACrB,OAAO,sBAAsB,KAAK,QAAQ;QACxC,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,wBAAwB,sBAAsB,CAAC,aAAa,CAAC,cAAc,EAAE,sFAAsF,CAAA;IAEzK,MAAM,WAAW,GAAG;QAClB,QAAQ,CAAC,CAAC,CAAC,aAAa,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI;QACzC,iBAAiB,CAAC,CAAC,CAAC,wBAAwB,iBAAiB,EAAE,CAAC,CAAC,CAAC,IAAI;QACtE,gBAAgB,gBAAgB,EAAE;QAClC,6BAA6B,aAAa,CAAC,cAAc,EAAE,0IAA0I;KACtM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAEjB,MAAM,mBAAmB,GAAG,+BAA+B,CAAC,cAAc,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;IAC/F,OAAO,oKAAoK,iBAAiB,IAAI,mBAAmB;;EAEnN,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,0BAA0B,CAAA;AACzF,CAAC"}

package/dist/esm/prompts/index.js

@@ -0,0 +1,4 @@
+export { buildPathSummaryPrompt } from './cli.js';
+export { buildFileSummaryPrompt, buildFileTextSummaryPrompt } from './file.js';
+export { buildLinkSummaryPrompt, estimateMaxCompletionTokensForCharacters, pickSummaryLengthForCharacters, SUMMARY_LENGTH_TO_TOKENS, } from './link-summary.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/prompts/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AACjD,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAA;AAC9E,OAAO,EACL,sBAAsB,EACtB,wCAAwC,EACxC,8BAA8B,EAE9B,wBAAwB,GAEzB,MAAM,mBAAmB,CAAA"}

package/dist/esm/prompts/link-summary.js

@@ -0,0 +1,116 @@
+import { formatOutputLanguageInstruction } from '../language.js';
+const SUMMARY_LENGTH_DIRECTIVES = {
+    short: {
+        guidance: 'Write a tight paragraph (2–3 sentences) that delivers the primary claim plus one high-signal supporting detail.',
+        formatting: 'Output a single paragraph with normal sentences; avoid headings or bullet lists.',
+    },
+    medium: {
+        guidance: 'Write two short paragraphs covering the core claim in the first paragraph and the most important supporting evidence, data points, or implications in the second.',
+        formatting: 'Each paragraph should contain 2–3 sentences. Separate paragraphs with a blank line. Do not use bullet lists or headings.',
+    },
+    long: {
+        guidance: 'Write three paragraphs: (1) summarize the claim and scope, (2) walk through the major supporting arguments or events, (3) explain implications, risks, or recommended next steps.',
+        formatting: 'Keep paragraphs balanced (3–4 sentences each) and separate them with single blank lines. No bullet lists or headings.',
+    },
+    xl: {
+        guidance: 'Produce a structured Markdown outline with short section headings (“Overview”, “Key Evidence”, “Implications”, “Next Steps”) followed by 2–3 bullet points under each heading. Surface quantitative details, quotes, or contrasting views when available.',
+        formatting: 'Use level-3 Markdown headings (###) for each section followed by bullet lists. Bullets may span 1–2 sentences and can exceed 20 words when necessary.',
+    },
+    xxl: {
+        guidance: 'Produce a comprehensive Markdown report: start with a short executive summary paragraph, then add sections for Background, Detailed Findings, Implications, and Open Questions. Within sections, use bullet lists or short paragraphs to cover nuanced context, statistics, quotes, counterpoints, and recommended follow-up actions.',
+        formatting: 'Use Markdown headings (###) for each section, combine paragraphs and bullet lists as needed, and ensure the overall response is substantial (multiple paragraphs and bullets totalling several hundred words) while remaining factual.',
+    },
+};
+export const SUMMARY_LENGTH_TO_TOKENS = {
+    short: 768,
+    medium: 1536,
+    long: 3072,
+    xl: 6144,
+    xxl: 12288,
+};
+export function pickSummaryLengthForCharacters(maxCharacters) {
+    if (maxCharacters <= 1200)
+        return 'short';
+    if (maxCharacters <= 2500)
+        return 'medium';
+    if (maxCharacters <= 6000)
+        return 'long';
+    if (maxCharacters <= 14000)
+        return 'xl';
+    return 'xxl';
+}
+export function estimateMaxCompletionTokensForCharacters(maxCharacters) {
+    const estimate = Math.ceil(maxCharacters / 4);
+    return Math.max(256, estimate);
+}
+const resolveSummaryDirective = (length) => 
+// SummaryLength is a contracts-enforced enum in all call sites; suppress generic injection warning.
+// eslint-disable-next-line security/detect-object-injection
+SUMMARY_LENGTH_DIRECTIVES[length];
+const formatCount = (value) => value.toLocaleString();
+export function buildLinkSummaryPrompt({ url, title, siteName, description, content, truncated, hasTranscript, outputLanguage, summaryLength, shares, }) {
+    const contentCharacters = content.length;
+    const contextLines = [`Source URL: ${url}`];
+    if (title) {
+        contextLines.push(`Title: ${title}`);
+    }
+    if (siteName) {
+        contextLines.push(`Site: ${siteName}`);
+    }
+    if (description) {
+        contextLines.push(`Page description: ${description}`);
+    }
+    if (truncated) {
+        contextLines.push('Note: Content truncated to the first portion available.');
+    }
+    const contextHeader = contextLines.join('\n');
+    const audienceLine = hasTranscript
+        ? 'You summarize online videos for curious Twitter users who want to know whether the clip is worth watching.'
+        : 'You summarize online articles for curious Twitter users who want the gist before deciding to dive in.';
+    const effectiveSummaryLength = typeof summaryLength === 'string'
+        ? summaryLength
+        : contentCharacters > 0 && summaryLength.maxCharacters > contentCharacters
+            ? { maxCharacters: contentCharacters }
+            : summaryLength;
+    const preset = typeof effectiveSummaryLength === 'string'
+        ? effectiveSummaryLength
+        : pickSummaryLengthForCharacters(effectiveSummaryLength.maxCharacters);
+    const directive = resolveSummaryDirective(preset);
+    const maxCharactersLine = typeof effectiveSummaryLength === 'string'
+        ? ''
+        : `Target length: up to ${formatCount(effectiveSummaryLength.maxCharacters)} characters total (including Markdown and whitespace). Hard limit: do not exceed it.`;
+    const contentLengthLine = contentCharacters > 0
+        ? `Extracted content length: ${formatCount(contentCharacters)} characters. Hard limit: never exceed this length. If the requested length is larger, do not pad—finish early rather than adding filler.`
+        : '';
+    const shareLines = shares.map((share) => {
+        const handle = share.handle && share.handle.length > 0 ? `@${share.handle}` : share.author;
+        const metrics = [];
+        if (typeof share.likeCount === 'number' && share.likeCount > 0) {
+            metrics.push(`${formatCount(share.likeCount)} likes`);
+        }
+        if (typeof share.reshareCount === 'number' && share.reshareCount > 0) {
+            metrics.push(`${formatCount(share.reshareCount)} reshares`);
+        }
+        if (typeof share.replyCount === 'number' && share.replyCount > 0) {
+            metrics.push(`${formatCount(share.replyCount)} replies`);
+        }
+        const metricsSuffix = metrics.length > 0 ? ` [${metrics.join(', ')}]` : '';
+        const timestamp = share.timestamp ? ` (${share.timestamp})` : '';
+        return `- ${handle}${timestamp}${metricsSuffix}: ${share.text}`;
+    });
+    const shareGuidance = shares.length > 0
+        ? 'You are also given quotes from people who recently shared this link. When these quotes contain substantive commentary, append a brief subsection titled "What sharers are saying" with one or two bullet points summarizing the key reactions. If they are generic reshares with no commentary, omit that subsection.'
+        : 'You are not given any quotes from people who shared this link. Do not fabricate reactions or add a "What sharers are saying" subsection.';
+    const sharesBlock = shares.length > 0 ? `Tweets from sharers:\n${shareLines.join('\n')}\n\n` : '';
+    const languageInstruction = formatOutputLanguageInstruction(outputLanguage ?? { kind: 'auto' });
+    return `${audienceLine} ${directive.guidance} ${directive.formatting} ${maxCharactersLine} ${contentLengthLine} ${languageInstruction} Keep the response compact by avoiding blank lines between sentences or list items; use only the single newlines required by the formatting instructions. Do not use emojis, disclaimers, or speculation. Write in direct, factual language. Format the answer in Markdown and obey the length-specific formatting above. Base everything strictly on the provided content and never invent details. ${shareGuidance}
+
+${contextHeader}
+
+${sharesBlock}Extracted content:
+"""
+${content}
+"""
+`;
+}
+//# sourceMappingURL=link-summary.js.map

package/dist/esm/prompts/link-summary.js.map

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

package/dist/esm/shared/contracts.js

@@ -0,0 +1,2 @@
+export const SUMMARY_LENGTHS = ['short', 'medium', 'long', 'xl', 'xxl'];
+//# sourceMappingURL=contracts.js.map

package/dist/esm/shared/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/shared/contracts.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAU,CAAA"}

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

@@ -0,0 +1,8 @@
+export const TRANSCRIPTION_TIMEOUT_MS = 600_000;
+export const MAX_ERROR_DETAIL_CHARS = 200;
+export const MAX_OPENAI_UPLOAD_BYTES = 24 * 1024 * 1024;
+export const DEFAULT_SEGMENT_SECONDS = 600;
+export const DISABLE_LOCAL_WHISPER_CPP_ENV = 'SUMMARIZE_DISABLE_LOCAL_WHISPER_CPP';
+export const WHISPER_CPP_MODEL_PATH_ENV = 'SUMMARIZE_WHISPER_CPP_MODEL_PATH';
+export const WHISPER_CPP_BINARY_ENV = 'SUMMARIZE_WHISPER_CPP_BINARY';
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/transcription/whisper/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAO,CAAA;AAC/C,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAA;AACzC,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAA;AACvD,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAA;AAC1C,MAAM,CAAC,MAAM,6BAA6B,GAAG,qCAAqC,CAAA;AAClF,MAAM,CAAC,MAAM,0BAA0B,GAAG,kCAAkC,CAAA;AAC5E,MAAM,CAAC,MAAM,sBAAsB,GAAG,8BAA8B,CAAA"}

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

@@ -0,0 +1,303 @@
+import { randomUUID } from 'node:crypto';
+import { promises as fs } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { DEFAULT_SEGMENT_SECONDS, MAX_OPENAI_UPLOAD_BYTES } from './constants.js';
+import { transcribeWithFal } from './fal.js';
+import { isFfmpegAvailable, runFfmpegSegment, transcodeBytesToMp3 } from './ffmpeg.js';
+import { shouldRetryOpenAiViaFfmpeg, transcribeWithOpenAi } from './openai.js';
+import { ensureWhisperFilenameExtension, formatBytes, readFirstBytes, wrapError } from './utils.js';
+import { isWhisperCppReady, transcribeWithWhisperCppFile } from './whisper-cpp.js';
+export async function transcribeMediaWithWhisper({ bytes, mediaType, filename, openaiApiKey, falApiKey, totalDurationSeconds = null, onProgress, }) {
+    const notes = [];
+    const localReady = await isWhisperCppReady();
+    let local = null;
+    if (localReady) {
+        const nameHint = filename?.trim() ? filename.trim() : 'media';
+        const tempFile = join(tmpdir(), `summarize-whisper-local-${randomUUID()}-${ensureWhisperFilenameExtension(nameHint, mediaType)}`);
+        try {
+            // Prefer local whisper.cpp when installed + model available (no network, no upload limits).
+            await fs.writeFile(tempFile, bytes);
+            try {
+                local = await transcribeWithWhisperCppFile({
+                    filePath: tempFile,
+                    mediaType,
+                    totalDurationSeconds,
+                    onProgress,
+                });
+            }
+            catch (error) {
+                local = {
+                    text: null,
+                    provider: 'whisper.cpp',
+                    error: wrapError('whisper.cpp failed', error),
+                    notes: [],
+                };
+            }
+            if (local.text) {
+                if (local.notes.length > 0)
+                    notes.push(...local.notes);
+                return { ...local, notes };
+            }
+            if (local.notes.length > 0)
+                notes.push(...local.notes);
+            if (local.error) {
+                notes.push(`whisper.cpp failed; falling back to remote Whisper: ${local.error.message}`);
+            }
+        }
+        finally {
+            await fs.unlink(tempFile).catch(() => { });
+        }
+    }
+    if (!openaiApiKey && !falApiKey) {
+        return {
+            text: null,
+            provider: null,
+            error: new Error('No transcription providers available (install whisper-cpp or set OPENAI_API_KEY or FAL_KEY)'),
+            notes,
+        };
+    }
+    if (openaiApiKey && bytes.byteLength > MAX_OPENAI_UPLOAD_BYTES) {
+        const canChunk = await isFfmpegAvailable();
+        if (canChunk) {
+            const tempFile = join(tmpdir(), `summarize-whisper-${randomUUID()}`);
+            try {
+                await fs.writeFile(tempFile, bytes);
+                const chunked = await transcribeMediaFileWithWhisper({
+                    filePath: tempFile,
+                    mediaType,
+                    filename,
+                    openaiApiKey,
+                    falApiKey,
+                    segmentSeconds: DEFAULT_SEGMENT_SECONDS,
+                    onProgress,
+                });
+                return chunked;
+            }
+            finally {
+                await fs.unlink(tempFile).catch(() => { });
+            }
+        }
+        notes.push(`Media too large for Whisper upload (${formatBytes(bytes.byteLength)}); transcribing first ${formatBytes(MAX_OPENAI_UPLOAD_BYTES)} only (install ffmpeg for full transcription)`);
+        bytes = bytes.slice(0, MAX_OPENAI_UPLOAD_BYTES);
+    }
+    let openaiError = null;
+    if (openaiApiKey) {
+        try {
+            const text = await transcribeWithOpenAi(bytes, mediaType, filename, openaiApiKey);
+            if (text) {
+                return { text, provider: 'openai', error: null, notes };
+            }
+            openaiError = new Error('OpenAI transcription returned empty text');
+        }
+        catch (error) {
+            openaiError = wrapError('OpenAI transcription failed', error);
+        }
+    }
+    if (openaiApiKey && openaiError && shouldRetryOpenAiViaFfmpeg(openaiError)) {
+        const canTranscode = await isFfmpegAvailable();
+        if (canTranscode) {
+            try {
+                // Some providers hand out containers/codecs Whisper rejects. Transcoding to a small mono MP3
+                // is the most reliable cross-format fallback (and also reduces upload size).
+                notes.push('OpenAI could not decode media; transcoding via ffmpeg and retrying');
+                const mp3Bytes = await transcodeBytesToMp3(bytes);
+                const retried = await transcribeWithOpenAi(mp3Bytes, 'audio/mpeg', 'audio.mp3', openaiApiKey);
+                if (retried) {
+                    return { text: retried, provider: 'openai', error: null, notes };
+                }
+                openaiError = new Error('OpenAI transcription returned empty text after ffmpeg transcode');
+                bytes = mp3Bytes;
+                mediaType = 'audio/mpeg';
+                filename = 'audio.mp3';
+            }
+            catch (error) {
+                notes.push(`ffmpeg transcode failed; cannot retry OpenAI decode error: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        else {
+            notes.push('OpenAI could not decode media; install ffmpeg to enable transcoding retry');
+        }
+    }
+    const canUseFal = Boolean(falApiKey) && mediaType.toLowerCase().startsWith('audio/');
+    if (openaiError && canUseFal) {
+        notes.push(`OpenAI transcription failed; falling back to FAL: ${openaiError.message}`);
+    }
+    if (falApiKey && !canUseFal) {
+        notes.push(`Skipping FAL transcription: unsupported mediaType ${mediaType}`);
+    }
+    if (falApiKey && canUseFal) {
+        try {
+            const text = await transcribeWithFal(bytes, mediaType, falApiKey);
+            if (text) {
+                return { text, provider: 'fal', error: null, notes };
+            }
+            return {
+                text: null,
+                provider: 'fal',
+                error: new Error('FAL transcription returned empty text'),
+                notes,
+            };
+        }
+        catch (error) {
+            return {
+                text: null,
+                provider: 'fal',
+                error: wrapError('FAL transcription failed', error),
+                notes,
+            };
+        }
+    }
+    return {
+        text: null,
+        provider: openaiApiKey ? 'openai' : null,
+        error: openaiError ?? new Error('No transcription providers available'),
+        notes,
+    };
+}
+export async function transcribeMediaFileWithWhisper({ filePath, mediaType, filename, openaiApiKey, falApiKey, segmentSeconds = DEFAULT_SEGMENT_SECONDS, totalDurationSeconds = null, onProgress = null, }) {
+    const notes = [];
+    const localReady = await isWhisperCppReady();
+    let local = null;
+    if (localReady) {
+        onProgress?.({
+            partIndex: null,
+            parts: null,
+            processedDurationSeconds: null,
+            totalDurationSeconds,
+        });
+        try {
+            local = await transcribeWithWhisperCppFile({
+                filePath,
+                mediaType,
+                totalDurationSeconds,
+                onProgress,
+            });
+        }
+        catch (error) {
+            local = {
+                text: null,
+                provider: 'whisper.cpp',
+                error: wrapError('whisper.cpp failed', error),
+                notes: [],
+            };
+        }
+        if (local.text) {
+            if (local.notes.length > 0)
+                notes.push(...local.notes);
+            return { ...local, notes };
+        }
+        if (local.notes.length > 0)
+            notes.push(...local.notes);
+        if (local.error) {
+            notes.push(`whisper.cpp failed; falling back to remote Whisper: ${local.error.message}`);
+        }
+    }
+    if (!openaiApiKey && !falApiKey) {
+        return {
+            text: null,
+            provider: null,
+            error: new Error('No transcription providers available (install whisper-cpp or set OPENAI_API_KEY or FAL_KEY)'),
+            notes,
+        };
+    }
+    const stat = await fs.stat(filePath);
+    if (openaiApiKey && stat.size > MAX_OPENAI_UPLOAD_BYTES) {
+        const canChunk = await isFfmpegAvailable();
+        if (!canChunk) {
+            notes.push(`Media too large for Whisper upload (${formatBytes(stat.size)}); install ffmpeg to enable chunked transcription`);
+            const head = await readFirstBytes(filePath, MAX_OPENAI_UPLOAD_BYTES);
+            const partial = await transcribeMediaWithWhisper({
+                bytes: head,
+                mediaType,
+                filename,
+                openaiApiKey,
+                falApiKey,
+            });
+            if (partial.notes.length > 0)
+                notes.push(...partial.notes);
+            return { ...partial, notes };
+        }
+        const dir = await fs.mkdtemp(join(tmpdir(), 'summarize-whisper-segments-'));
+        try {
+            const pattern = join(dir, 'part-%03d.mp3');
+            await runFfmpegSegment({
+                inputPath: filePath,
+                outputPattern: pattern,
+                segmentSeconds,
+            });
+            const files = (await fs.readdir(dir))
+                .filter((name) => name.startsWith('part-') && name.endsWith('.mp3'))
+                .sort((a, b) => a.localeCompare(b));
+            if (files.length === 0) {
+                return {
+                    text: null,
+                    provider: null,
+                    error: new Error('ffmpeg produced no audio segments'),
+                    notes,
+                };
+            }
+            notes.push(`ffmpeg chunked media into ${files.length} parts (${segmentSeconds}s each)`);
+            onProgress?.({
+                partIndex: null,
+                parts: files.length,
+                processedDurationSeconds: null,
+                totalDurationSeconds,
+            });
+            const parts = [];
+            let usedProvider = null;
+            for (const [index, name] of files.entries()) {
+                const segmentPath = join(dir, name);
+                const segmentBytes = new Uint8Array(await fs.readFile(segmentPath));
+                const result = await transcribeMediaWithWhisper({
+                    bytes: segmentBytes,
+                    mediaType: 'audio/mpeg',
+                    filename: name,
+                    openaiApiKey,
+                    falApiKey,
+                    onProgress: null,
+                });
+                if (!usedProvider && result.provider)
+                    usedProvider = result.provider;
+                if (result.error && !result.text) {
+                    return { text: null, provider: usedProvider, error: result.error, notes };
+                }
+                if (result.text)
+                    parts.push(result.text);
+                // Coarse but useful: update based on part boundaries. Duration is best-effort (RSS hints or
+                // ffprobe); the per-part time is stable enough to make the spinner feel alive.
+                const processedSeconds = Math.max(0, (index + 1) * segmentSeconds);
+                onProgress?.({
+                    partIndex: index + 1,
+                    parts: files.length,
+                    processedDurationSeconds: typeof totalDurationSeconds === 'number' && totalDurationSeconds > 0
+                        ? Math.min(processedSeconds, totalDurationSeconds)
+                        : null,
+                    totalDurationSeconds,
+                });
+            }
+            return { text: parts.join('\n\n'), provider: usedProvider, error: null, notes };
+        }
+        finally {
+            await fs.rm(dir, { recursive: true, force: true }).catch(() => { });
+        }
+    }
+    const bytes = new Uint8Array(await fs.readFile(filePath));
+    onProgress?.({
+        partIndex: null,
+        parts: null,
+        processedDurationSeconds: null,
+        totalDurationSeconds,
+    });
+    const result = await transcribeMediaWithWhisper({
+        bytes,
+        mediaType,
+        filename,
+        openaiApiKey,
+        falApiKey,
+    });
+    if (result.notes.length > 0)
+        notes.push(...result.notes);
+    return { ...result, notes };
+}
+//# sourceMappingURL=core.js.map

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

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

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

@@ -0,0 +1,41 @@
+import { createFalClient } from '@fal-ai/client';
+import { TRANSCRIPTION_TIMEOUT_MS } from './constants.js';
+import { toArrayBuffer } from './utils.js';
+export async function transcribeWithFal(bytes, mediaType, apiKey) {
+    const fal = createFalClient({ credentials: apiKey });
+    const blob = new Blob([toArrayBuffer(bytes)], { type: mediaType });
+    const audioUrl = await fal.storage.upload(blob);
+    const result = await Promise.race([
+        fal.subscribe('fal-ai/wizper', {
+            input: { audio_url: audioUrl, language: 'en' },
+        }),
+        new Promise((_, reject) => setTimeout(() => reject(new Error('FAL transcription timeout')), TRANSCRIPTION_TIMEOUT_MS)),
+    ]);
+    return extractText(result);
+}
+function extractText(result) {
+    if (typeof result !== 'object' || result === null)
+        return null;
+    const data = 'data' in result ? result.data : result;
+    if (typeof data !== 'object' || data === null)
+        return null;
+    if ('text' in data && typeof data.text === 'string') {
+        const text = data.text.trim();
+        return text.length > 0 ? text : null;
+    }
+    if ('chunks' in data && Array.isArray(data.chunks)) {
+        const chunks = data.chunks;
+        const lines = [];
+        for (const chunk of chunks) {
+            if (typeof chunk === 'object' && chunk !== null && 'text' in chunk) {
+                const text = chunk.text;
+                if (typeof text === 'string' && text.trim()) {
+                    lines.push(text.trim());
+                }
+            }
+        }
+        return lines.length > 0 ? lines.join(' ') : null;
+    }
+    return null;
+}
+//# sourceMappingURL=fal.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fal.js","sourceRoot":"","sources":["../../../../src/transcription/whisper/fal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE1C,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAiB,EACjB,SAAiB,EACjB,MAAc;IAEd,MAAM,GAAG,GAAG,eAAe,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAA;IACpD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAA;IAClE,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAE/C,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;QAChC,GAAG,CAAC,SAAS,CAAC,eAAe,EAAE;YAC7B,KAAK,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;SAC/C,CAAC;QACF,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAC/B,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC,EAAE,wBAAwB,CAAC,CAC3F;KACF,CAAC,CAAA;IAEF,OAAO,WAAW,CAAC,MAAM,CAAC,CAAA;AAC5B,CAAC;AAED,SAAS,WAAW,CAAC,MAAe;IAClC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAC9D,MAAM,IAAI,GAAG,MAAM,IAAI,MAAM,CAAC,CAAC,CAAE,MAA4B,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAA;IAC3E,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAC1D,IAAI,MAAM,IAAI,IAAI,IAAI,OAAQ,IAA0B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3E,MAAM,IAAI,GAAI,IAAyB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;QACnD,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;IACtC,CAAC;IACD,IAAI,QAAQ,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAE,IAA4B,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5E,MAAM,MAAM,GAAI,IAA8B,CAAC,MAAM,CAAA;QACrD,MAAM,KAAK,GAAa,EAAE,CAAA;QAC1B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;gBACnE,MAAM,IAAI,GAAI,KAA2B,CAAC,IAAI,CAAA;gBAC9C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;oBAC5C,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;gBACzB,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAClD,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}