@steipete/summarize-core 0.10.0 → 0.11.1

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

@@ -1,5 +1,6 @@
-import type { MediaCache, TranscriptCache } from '../cache/types.js';
-import type { CacheMode, TranscriptSource } from './types.js';
+import type { MediaCache, TranscriptCache } from "../cache/types.js";
+import type { TranscriptionConfig } from "../transcript/transcription-config.js";
+import type { CacheMode, TranscriptSource } from "./types.js";
 export declare const ProgressKind: {
     readonly FetchHtmlStart: "fetch-html-start";
     readonly FetchHtmlProgress: "fetch-html-progress";
@@ -18,93 +19,93 @@ export declare const ProgressKind: {
     readonly BirdStart: "bird-start";
     readonly BirdDone: "bird-done";
 };
-export type TranscriptionProviderHint = 'cpp' | 'onnx' | 'openai' | 'fal' | 'openai->fal' | 'unknown';
+export type TranscriptionProviderHint = "cpp" | "onnx" | "groq" | "groq->openai" | "groq->fal" | "groq->openai->fal" | "openai" | "fal" | "openai->fal" | "unknown";
 /** Public progress events emitted by link preview fetchers. */
 export type LinkPreviewProgressEvent = {
-    kind: 'fetch-html-start';
+    kind: "fetch-html-start";
     url: string;
 } | {
-    kind: 'fetch-html-progress';
+    kind: "fetch-html-progress";
     url: string;
     downloadedBytes: number;
     totalBytes: number | null;
 } | {
-    kind: 'fetch-html-done';
+    kind: "fetch-html-done";
     url: string;
     downloadedBytes: number;
     totalBytes: number | null;
 } | {
-    kind: 'transcript-media-download-start';
+    kind: "transcript-media-download-start";
     url: string;
-    service: 'youtube' | 'podcast' | 'generic';
+    service: "youtube" | "podcast" | "generic";
     mediaUrl: string | null;
-    mediaKind?: 'video' | 'audio' | null;
+    mediaKind?: "video" | "audio" | null;
     totalBytes: number | null;
 } | {
-    kind: 'transcript-media-download-progress';
+    kind: "transcript-media-download-progress";
     url: string;
-    service: 'youtube' | 'podcast' | 'generic';
+    service: "youtube" | "podcast" | "generic";
     downloadedBytes: number;
     totalBytes: number | null;
-    mediaKind?: 'video' | 'audio' | null;
+    mediaKind?: "video" | "audio" | null;
 } | {
-    kind: 'transcript-media-download-done';
+    kind: "transcript-media-download-done";
     url: string;
-    service: 'youtube' | 'podcast' | 'generic';
+    service: "youtube" | "podcast" | "generic";
     downloadedBytes: number;
     totalBytes: number | null;
-    mediaKind?: 'video' | 'audio' | null;
+    mediaKind?: "video" | "audio" | null;
 } | {
-    kind: 'transcript-whisper-start';
+    kind: "transcript-whisper-start";
     url: string;
-    service: 'youtube' | 'podcast' | 'generic';
+    service: "youtube" | "podcast" | "generic";
     providerHint: TranscriptionProviderHint;
     modelId: string | null;
     totalDurationSeconds: number | null;
     parts: number | null;
 } | {
-    kind: 'transcript-whisper-progress';
+    kind: "transcript-whisper-progress";
     url: string;
-    service: 'youtube' | 'podcast' | 'generic';
+    service: "youtube" | "podcast" | "generic";
     processedDurationSeconds: number | null;
     totalDurationSeconds: number | null;
     partIndex: number | null;
     parts: number | null;
 } | {
-    kind: 'transcript-start';
+    kind: "transcript-start";
     url: string;
-    service: 'youtube' | 'podcast' | 'generic';
+    service: "youtube" | "podcast" | "generic";
     hint: string | null;
 } | {
-    kind: 'transcript-done';
+    kind: "transcript-done";
     url: string;
     ok: boolean;
-    service: 'youtube' | 'podcast' | 'generic';
+    service: "youtube" | "podcast" | "generic";
     source: TranscriptSource | null;
     hint: string | null;
 } | {
-    kind: 'firecrawl-start';
+    kind: "firecrawl-start";
     url: string;
     reason: string;
 } | {
-    kind: 'firecrawl-done';
+    kind: "firecrawl-done";
     url: string;
     ok: boolean;
     markdownBytes: number | null;
     htmlBytes: number | null;
 } | {
-    kind: 'nitter-start';
+    kind: "nitter-start";
     url: string;
 } | {
-    kind: 'nitter-done';
+    kind: "nitter-done";
     url: string;
     ok: boolean;
     textBytes: number | null;
 } | {
-    kind: 'bird-start';
+    kind: "bird-start";
     url: string;
 } | {
-    kind: 'bird-done';
+    kind: "bird-done";
     url: string;
     ok: boolean;
     textBytes: number | null;
@@ -126,10 +127,10 @@ export type ConvertHtmlToMarkdown = (args: {
     timeoutMs: number;
 }) => Promise<string>;
 export type BirdTweetMedia = {
-    kind: 'video' | 'audio';
+    kind: "video" | "audio";
     urls: string[];
     preferredUrl: string | null;
-    source: 'extended_entities' | 'card' | 'entities';
+    source: "extended_entities" | "card" | "entities";
 };
 export type BirdTweetPayload = {
     id?: string;
@@ -160,8 +161,10 @@ export interface LinkPreviewDeps {
     scrapeWithFirecrawl: ScrapeWithFirecrawl | null;
     apifyApiToken: string | null;
     ytDlpPath: string | null;
-    falApiKey: string | null;
-    openaiApiKey: string | null;
+    transcription?: TranscriptionConfig | null;
+    falApiKey?: string | null;
+    groqApiKey?: string | null;
+    openaiApiKey?: string | null;
     convertHtmlToMarkdown: ConvertHtmlToMarkdown | null;
     transcriptCache: TranscriptCache | null;
     mediaCache?: MediaCache | null;

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

@@ -1,4 +1,4 @@
-export type TranscriptSource = 'youtubei' | 'captionTracks' | 'embedded' | 'yt-dlp' | 'podcastTranscript' | 'whisper' | 'apify' | 'html' | 'unavailable' | 'unknown';
+export type TranscriptSource = "youtubei" | "captionTracks" | "embedded" | "yt-dlp" | "podcastTranscript" | "whisper" | "apify" | "html" | "unavailable" | "unknown";
 export type TranscriptSegment = {
     startMs: number;
     endMs?: number | null;
@@ -6,7 +6,7 @@ export type TranscriptSegment = {
 };
 export declare const CACHE_MODES: readonly ["default", "bypass"];
 export type CacheMode = (typeof CACHE_MODES)[number];
-export type CacheStatus = 'hit' | 'miss' | 'expired' | 'bypassed' | 'fallback' | 'unknown';
+export type CacheStatus = "hit" | "miss" | "expired" | "bypassed" | "fallback" | "unknown";
 export interface TranscriptDiagnostics {
     cacheMode: CacheMode;
     cacheStatus: CacheStatus;
@@ -25,11 +25,11 @@ export interface FirecrawlDiagnostics {
 export interface MarkdownDiagnostics {
     requested: boolean;
     used: boolean;
-    provider: 'firecrawl' | 'llm' | null;
+    provider: "firecrawl" | "llm" | null;
     notes?: string | null;
 }
 export interface ContentFetchDiagnostics {
-    strategy: 'bird' | 'firecrawl' | 'html' | 'nitter';
+    strategy: "bird" | "firecrawl" | "html" | "nitter";
     firecrawl: FirecrawlDiagnostics;
     markdown: MarkdownDiagnostics;
     transcript: TranscriptDiagnostics;

package/dist/types/content/transcript/cache.d.ts

@@ -1,8 +1,8 @@
-import type { TranscriptCache } from '../cache/types.js';
-import type { CacheMode, TranscriptDiagnostics, TranscriptResolution, TranscriptSource } from '../link-preview/types.js';
+import type { TranscriptCache } from "../cache/types.js";
+import type { CacheMode, TranscriptDiagnostics, TranscriptResolution, TranscriptSource } from "../link-preview/types.js";
 export declare const DEFAULT_TTL_MS: number;
 export declare const NEGATIVE_TTL_MS: number;
-type CacheDiagnostics = Pick<TranscriptDiagnostics, 'cacheStatus' | 'notes' | 'provider' | 'textProvided' | 'cacheMode' | 'attemptedProviders'>;
+type CacheDiagnostics = Pick<TranscriptDiagnostics, "cacheStatus" | "notes" | "provider" | "textProvided" | "cacheMode" | "attemptedProviders">;
 export interface CacheReadArguments {
     url: string;
     cacheMode: CacheMode;
@@ -11,7 +11,7 @@ export interface CacheReadArguments {
     fileMtime?: number | null;
 }
 export interface TranscriptCacheLookup {
-    cached: Awaited<ReturnType<TranscriptCache['get']>> | null;
+    cached: Awaited<ReturnType<TranscriptCache["get"]>> | null;
     resolution: TranscriptResolution | null;
     diagnostics: CacheDiagnostics;
 }

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

@@ -1,11 +1,11 @@
-import type { LinkPreviewDeps } from '../link-preview/deps.js';
-import type { CacheMode, TranscriptResolution } from '../link-preview/types.js';
-import type { ProviderFetchOptions } from './types.js';
+import type { LinkPreviewDeps } from "../link-preview/deps.js";
+import type { CacheMode, TranscriptResolution } from "../link-preview/types.js";
+import type { ProviderFetchOptions } from "./types.js";
 interface ResolveTranscriptOptions {
-    youtubeTranscriptMode?: ProviderFetchOptions['youtubeTranscriptMode'];
-    mediaTranscriptMode?: ProviderFetchOptions['mediaTranscriptMode'];
-    mediaKindHint?: ProviderFetchOptions['mediaKindHint'];
-    transcriptTimestamps?: ProviderFetchOptions['transcriptTimestamps'];
+    youtubeTranscriptMode?: ProviderFetchOptions["youtubeTranscriptMode"];
+    mediaTranscriptMode?: ProviderFetchOptions["mediaTranscriptMode"];
+    mediaKindHint?: ProviderFetchOptions["mediaKindHint"];
+    transcriptTimestamps?: ProviderFetchOptions["transcriptTimestamps"];
     cacheMode?: CacheMode;
     fileMtime?: number | null;
 }

package/dist/types/content/transcript/parse.d.ts

@@ -1,4 +1,4 @@
-import type { TranscriptSegment } from '../link-preview/types.js';
+import type { TranscriptSegment } from "../link-preview/types.js";
 export type TranscriptParseResult = {
     text: string | null;
     segments: TranscriptSegment[] | null;

package/dist/types/content/transcript/providers/generic.d.ts

@@ -1,3 +1,3 @@
-import type { ProviderContext, ProviderFetchOptions, ProviderResult } from '../types.js';
+import type { ProviderContext, ProviderFetchOptions, ProviderResult } from "../types.js";
 export declare const canHandle: () => boolean;
 export declare const fetchTranscript: (context: ProviderContext, options: ProviderFetchOptions) => Promise<ProviderResult>;

package/dist/types/content/transcript/providers/podcast/apple-flow.d.ts

@@ -1,4 +1,4 @@
-import type { ProviderResult } from '../../types.js';
-import type { PodcastFlowContext } from './flow-context.js';
+import type { ProviderResult } from "../../types.js";
+import type { PodcastFlowContext } from "./flow-context.js";
 export declare function fetchAppleTranscriptFromItunesLookup(flow: PodcastFlowContext): Promise<ProviderResult | null>;
 export declare function fetchAppleTranscriptFromEmbeddedHtml(flow: PodcastFlowContext): Promise<ProviderResult | null>;

package/dist/types/content/transcript/providers/podcast/flow-context.d.ts

@@ -1,11 +1,11 @@
-import type { ProviderContext, ProviderFetchOptions, ProviderResult } from '../../types.js';
-import type { TranscribeRequest, TranscriptionResult } from './media.js';
+import type { ProviderContext, ProviderFetchOptions, ProviderResult } from "../../types.js";
+import type { TranscribeRequest, TranscriptionResult } from "./media.js";
 export type PodcastFlowContext = {
     context: ProviderContext;
     options: ProviderFetchOptions;
-    attemptedProviders: ProviderResult['attemptedProviders'];
+    attemptedProviders: ProviderResult["attemptedProviders"];
     notes: string[];
-    pushOnce: (provider: ProviderResult['attemptedProviders'][number]) => void;
+    pushOnce: (provider: ProviderResult["attemptedProviders"][number]) => void;
     ensureTranscriptionProvider: () => ProviderResult | null;
     transcribe: (request: TranscribeRequest) => Promise<TranscriptionResult>;
 };

package/dist/types/content/transcript/providers/podcast/media.d.ts

@@ -1,4 +1,5 @@
-import type { ProviderFetchOptions } from '../../types.js';
+import type { ProviderFetchOptions } from "../../types.js";
+import { type TranscriptionConfig } from "../../transcription-config.js";
 export type TranscribeRequest = {
     url: string;
     filenameHint: string;
@@ -9,19 +10,21 @@ export type TranscriptionResult = {
     provider: string | null;
     error: Error | null;
 };
-export declare function transcribeMediaUrl({ fetchImpl, env, url, filenameHint, durationSecondsHint, openaiApiKey, falApiKey, notes, progress, }: {
+export declare function transcribeMediaUrl({ fetchImpl, transcription, env, url, filenameHint, durationSecondsHint, groqApiKey, openaiApiKey, falApiKey, notes, progress, }: {
     fetchImpl: typeof fetch;
+    transcription?: Partial<TranscriptionConfig> | null;
     env?: Record<string, string | undefined>;
     url: string;
     filenameHint: string;
     durationSecondsHint: number | null;
-    openaiApiKey: string | null;
-    falApiKey: string | null;
+    groqApiKey?: string | null;
+    openaiApiKey?: string | null;
+    falApiKey?: string | null;
     notes: string[];
     progress: {
         url: string;
-        service: 'podcast';
-        onProgress: ProviderFetchOptions['onProgress'] | null;
+        service: "podcast";
+        onProgress: ProviderFetchOptions["onProgress"] | null;
     } | null;
 }): Promise<TranscriptionResult>;
 export declare function probeRemoteMedia(fetchImpl: typeof fetch, url: string): Promise<{

package/dist/types/content/transcript/providers/podcast/results.d.ts

@@ -1,8 +1,8 @@
-import type { ProviderResult } from '../../types.js';
-import type { TranscriptionResult } from './media.js';
+import type { ProviderResult } from "../../types.js";
+import type { TranscriptionResult } from "./media.js";
 export declare function joinNotes(notes: string[]): string | null;
 export declare function buildWhisperResult({ attemptedProviders, notes, outcome, metadata, includeProviderOnFailure, }: {
-    attemptedProviders: ProviderResult['attemptedProviders'];
+    attemptedProviders: ProviderResult["attemptedProviders"];
     notes: string[];
     outcome: TranscriptionResult;
     metadata: Record<string, unknown>;

package/dist/types/content/transcript/providers/podcast/rss.d.ts

@@ -1,4 +1,4 @@
-import type { TranscriptSegment } from '../../../link-preview/types.js';
+import type { TranscriptSegment } from "../../../link-preview/types.js";
 export declare function looksLikeRssOrAtomFeed(xml: string): boolean;
 export declare function extractEnclosureFromFeed(xml: string): {
     enclosureUrl: string;

package/dist/types/content/transcript/providers/podcast/spotify-flow.d.ts

@@ -1,3 +1,3 @@
-import type { ProviderResult } from '../../types.js';
-import type { PodcastFlowContext } from './flow-context.js';
+import type { ProviderResult } from "../../types.js";
+import type { PodcastFlowContext } from "./flow-context.js";
 export declare function fetchSpotifyTranscript(flow: PodcastFlowContext): Promise<ProviderResult | null>;

package/dist/types/content/transcript/providers/podcast/spotify.d.ts

@@ -11,7 +11,7 @@ export declare function fetchSpotifyEmbedHtml({ embedUrl, episodeId, fetchImpl,
     episodeId: string;
     fetchImpl: typeof fetch;
     scrapeWithFirecrawl: ((url: string, options?: {
-        cacheMode?: 'default' | 'bypass';
+        cacheMode?: "default" | "bypass";
         timeoutMs?: number;
     }) => Promise<{
         html?: string | null;
@@ -19,6 +19,6 @@ export declare function fetchSpotifyEmbedHtml({ embedUrl, episodeId, fetchImpl,
     } | null>) | null;
 }): Promise<{
     html: string;
-    via: 'fetch' | 'firecrawl';
+    via: "fetch" | "firecrawl";
 }>;
 export declare function looksLikeBlockedHtml(html: string): boolean;

package/dist/types/content/transcript/providers/podcast.d.ts

@@ -1,8 +1,8 @@
-import type { ProviderContext, ProviderFetchOptions, ProviderResult } from '../types.js';
-import { resolvePodcastFeedUrlFromItunesSearch } from './podcast/itunes.js';
-import { downloadCappedBytes, downloadToFile, filenameFromUrl, formatBytes, normalizeHeaderType, parseContentLength, probeRemoteMedia } from './podcast/media.js';
-import { extractEnclosureForEpisode, extractItemDurationSeconds } from './podcast/rss.js';
-import { looksLikeBlockedHtml } from './podcast/spotify.js';
+import type { ProviderContext, ProviderFetchOptions, ProviderResult } from "../types.js";
+import { resolvePodcastFeedUrlFromItunesSearch } from "./podcast/itunes.js";
+import { downloadCappedBytes, downloadToFile, filenameFromUrl, formatBytes, normalizeHeaderType, parseContentLength, probeRemoteMedia } from "./podcast/media.js";
+import { extractEnclosureForEpisode, extractItemDurationSeconds } from "./podcast/rss.js";
+import { looksLikeBlockedHtml } from "./podcast/spotify.js";
 export declare const canHandle: ({ url, html }: ProviderContext) => boolean;
 export declare const fetchTranscript: (context: ProviderContext, options: ProviderFetchOptions) => Promise<ProviderResult>;
 export declare const __test__: {

package/dist/types/content/transcript/providers/transcription-start.d.ts

@@ -1,23 +1,29 @@
-import { resolvePreferredOnnxModel } from '../../../transcription/onnx-cli.js';
-import type { TranscriptionProviderHint } from '../../link-preview/deps.js';
+import type { TranscriptionProviderHint } from "../../link-preview/deps.js";
+import { resolvePreferredOnnxModel } from "../../../transcription/onnx-cli.js";
+import { type TranscriptionConfig } from "../transcription-config.js";
 type Env = Record<string, string | undefined>;
 export type TranscriptionAvailability = {
     preferredOnnxModel: ReturnType<typeof resolvePreferredOnnxModel>;
     onnxReady: boolean;
     hasLocalWhisper: boolean;
+    hasGroq: boolean;
     hasOpenai: boolean;
     hasFal: boolean;
     hasAnyProvider: boolean;
 };
-export declare function resolveTranscriptionAvailability({ env, openaiApiKey, falApiKey, }: {
+export declare function resolveTranscriptionAvailability({ env, transcription, groqApiKey, openaiApiKey, falApiKey, }: {
     env?: Env;
-    openaiApiKey: string | null;
-    falApiKey: string | null;
+    transcription?: Partial<TranscriptionConfig> | null;
+    groqApiKey?: string | null;
+    openaiApiKey?: string | null;
+    falApiKey?: string | null;
 }): Promise<TranscriptionAvailability>;
-export declare function resolveTranscriptionStartInfo({ env, openaiApiKey, falApiKey, }: {
+export declare function resolveTranscriptionStartInfo({ env, transcription, groqApiKey, openaiApiKey, falApiKey, }: {
     env?: Env;
-    openaiApiKey: string | null;
-    falApiKey: string | null;
+    transcription?: Partial<TranscriptionConfig> | null;
+    groqApiKey?: string | null;
+    openaiApiKey?: string | null;
+    falApiKey?: string | null;
 }): Promise<{
     availability: TranscriptionAvailability;
     providerHint: TranscriptionProviderHint;

package/dist/types/content/transcript/providers/youtube/api.d.ts

@@ -1,4 +1,4 @@
-import type { TranscriptSegment } from '../../../link-preview/types.js';
+import type { TranscriptSegment } from "../../../link-preview/types.js";
 export interface YoutubeTranscriptConfig {
     apiKey: string;
     context: Record<string, unknown>;

package/dist/types/content/transcript/providers/youtube/captions.d.ts

@@ -1,4 +1,4 @@
-import type { TranscriptSegment } from '../../../link-preview/types.js';
+import type { TranscriptSegment } from "../../../link-preview/types.js";
 interface YoutubeTranscriptContext {
     html: string;
     originalUrl: string;

package/dist/types/content/transcript/providers/youtube/yt-dlp.d.ts

@@ -1,6 +1,7 @@
-import { type TranscriptionProvider } from '../../../../transcription/whisper.js';
-import type { MediaCache } from '../../../cache/types.js';
-import type { LinkPreviewProgressEvent } from '../../../link-preview/deps.js';
+import type { MediaCache } from "../../../cache/types.js";
+import type { LinkPreviewProgressEvent } from "../../../link-preview/deps.js";
+import { type TranscriptionProvider } from "../../../../transcription/whisper.js";
+import { type TranscriptionConfig } from "../../transcription-config.js";
 type YtDlpTranscriptResult = {
     text: string | null;
     provider: TranscriptionProvider | null;
@@ -9,13 +10,15 @@ type YtDlpTranscriptResult = {
 };
 type YtDlpRequest = {
     ytDlpPath: string | null;
+    transcription?: Partial<TranscriptionConfig> | null;
     env?: Record<string, string | undefined>;
-    openaiApiKey: string | null;
-    falApiKey: string | null;
+    groqApiKey?: string | null;
+    openaiApiKey?: string | null;
+    falApiKey?: string | null;
     url: string;
     onProgress?: ((event: LinkPreviewProgressEvent) => void) | null;
-    service?: 'youtube' | 'podcast' | 'generic';
-    mediaKind?: 'video' | 'audio' | null;
+    service?: "youtube" | "podcast" | "generic";
+    mediaKind?: "video" | "audio" | null;
     mediaCache?: MediaCache | null;
     extraArgs?: string[];
 };
@@ -23,6 +26,6 @@ type YtDlpDurationRequest = {
     ytDlpPath: string | null;
     url: string;
 };
-export declare const fetchTranscriptWithYtDlp: ({ ytDlpPath, env, openaiApiKey, falApiKey, url, onProgress, service, mediaKind, mediaCache, extraArgs, }: YtDlpRequest) => Promise<YtDlpTranscriptResult>;
+export declare const fetchTranscriptWithYtDlp: ({ ytDlpPath, transcription, env, groqApiKey, openaiApiKey, falApiKey, url, onProgress, service, mediaKind, mediaCache, extraArgs, }: YtDlpRequest) => Promise<YtDlpTranscriptResult>;
 export declare const fetchDurationSecondsWithYtDlp: ({ ytDlpPath, url, }: YtDlpDurationRequest) => Promise<number | null>;
 export {};

package/dist/types/content/transcript/providers/youtube.d.ts

@@ -1,3 +1,3 @@
-import type { ProviderContext, ProviderFetchOptions, ProviderResult } from '../types.js';
+import type { ProviderContext, ProviderFetchOptions, ProviderResult } from "../types.js";
 export declare const canHandle: ({ url }: ProviderContext) => boolean;
 export declare const fetchTranscript: (context: ProviderContext, options: ProviderFetchOptions) => Promise<ProviderResult>;

package/dist/types/content/transcript/timestamps.d.ts

@@ -1,4 +1,4 @@
-import type { TranscriptSegment } from '../link-preview/types.js';
+import type { TranscriptSegment } from "../link-preview/types.js";
 export declare function formatTimestampMs(ms: number): string;
 export declare function parseTimestampStringToMs(value: string): number | null;
 export declare function parseTimestampToMs(value: unknown, assumeSeconds?: boolean): number | null;

package/dist/types/content/transcript/transcription-config.d.ts

@@ -0,0 +1,15 @@
+export type TranscriptionConfig = {
+    env?: Record<string, string | undefined>;
+    groqApiKey: string | null;
+    openaiApiKey: string | null;
+    falApiKey: string | null;
+};
+type TranscriptionConfigInput = {
+    env?: Record<string, string | undefined>;
+    transcription?: Partial<TranscriptionConfig> | null;
+    groqApiKey?: string | null;
+    openaiApiKey?: string | null;
+    falApiKey?: string | null;
+};
+export declare function resolveTranscriptionConfig(input: TranscriptionConfigInput): TranscriptionConfig;
+export {};

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

@@ -1,8 +1,9 @@
-import type { MediaCache } from '../cache/types.js';
-import type { MediaTranscriptMode, YoutubeTranscriptMode } from '../link-preview/content/types.js';
-import type { LinkPreviewProgressEvent, ResolveTwitterCookies, ScrapeWithFirecrawl } from '../link-preview/deps.js';
-import type { TranscriptResolution, TranscriptSource } from '../link-preview/types.js';
-export type TranscriptService = 'youtube' | 'podcast' | 'generic';
+import type { MediaCache } from "../cache/types.js";
+import type { MediaTranscriptMode, YoutubeTranscriptMode } from "../link-preview/content/types.js";
+import type { LinkPreviewProgressEvent, ResolveTwitterCookies, ScrapeWithFirecrawl } from "../link-preview/deps.js";
+import type { TranscriptResolution, TranscriptSource } from "../link-preview/types.js";
+import type { TranscriptionConfig } from "./transcription-config.js";
+export type TranscriptService = "youtube" | "podcast" | "generic";
 export interface ProviderContext {
     url: string;
     html: string | null;
@@ -15,11 +16,13 @@ export interface ProviderFetchOptions {
     apifyApiToken: string | null;
     youtubeTranscriptMode: YoutubeTranscriptMode;
     mediaTranscriptMode: MediaTranscriptMode;
-    mediaKindHint?: 'video' | 'audio' | null;
+    mediaKindHint?: "video" | "audio" | null;
     transcriptTimestamps?: boolean;
     ytDlpPath: string | null;
-    falApiKey: string | null;
-    openaiApiKey: string | null;
+    transcription?: TranscriptionConfig;
+    falApiKey?: string | null;
+    groqApiKey?: string | null;
+    openaiApiKey?: string | null;
     mediaCache?: MediaCache | null;
     resolveTwitterCookies?: ResolveTwitterCookies | null;
     onProgress?: ((event: LinkPreviewProgressEvent) => void) | null;
@@ -34,4 +37,4 @@ export interface ProviderModule {
     canHandle(context: ProviderContext): boolean;
     fetchTranscript(context: ProviderContext, options: ProviderFetchOptions): Promise<ProviderResult>;
 }
-export type { TranscriptSource } from '../link-preview/types.js';
+export type { TranscriptSource } from "../link-preview/types.js";

package/dist/types/content/transcript/utils.d.ts

@@ -1,4 +1,4 @@
-export { extractYouTubeVideoId, isYouTubeUrl, isYouTubeVideoUrl } from '../url.js';
+export { extractYouTubeVideoId, isYouTubeUrl, isYouTubeVideoUrl } from "../url.js";
 export declare function isRecord(value: unknown): value is Record<string, unknown>;
 export declare function extractEmbeddedYouTubeUrlFromHtml(html: string, maxTextChars?: number, maxReadabilityChars?: number): Promise<string | null>;
 export declare function sanitizeYoutubeJsonResponse(input: string): string;

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

@@ -1,8 +1,10 @@
-import { isPodcastHost } from './link-preview/content/podcast-utils.js';
-import { isTwitterStatusUrl } from './link-preview/content/twitter-utils.js';
+import { isPodcastHost } from "./link-preview/content/podcast-utils.js";
+import { isTwitterBroadcastUrl, isTwitterStatusUrl } from "./link-preview/content/twitter-utils.js";
 export declare const isYouTubeUrl: (rawUrl: string) => boolean;
+export declare const DIRECT_MEDIA_EXTENSIONS: readonly ["mp4", "mov", "m4v", "mkv", "webm", "mpeg", "mpg", "avi", "wmv", "flv", "mp3", "m4a", "wav", "flac", "aac", "ogg", "opus", "aiff", "wma"];
 export declare function isYouTubeVideoUrl(rawUrl: string): boolean;
 export declare function extractYouTubeVideoId(rawUrl: string): string | null;
 export declare function isDirectMediaUrl(url: string): boolean;
+export declare function isDirectMediaExtension(ext: string): boolean;
 export declare function shouldPreferUrlMode(url: string): boolean;
-export { isTwitterStatusUrl, isPodcastHost };
+export { isTwitterBroadcastUrl, isTwitterStatusUrl, isPodcastHost };

package/dist/types/index.d.ts

@@ -1,4 +1,5 @@
-export * from './content/index.js';
-export * from './prompts/index.js';
-export type { SummaryLength } from './shared/contracts.js';
-export { SUMMARY_LENGTHS } from './shared/contracts.js';
+export * from "./content/index.js";
+export { isOpenRouterBaseUrl, normalizeBaseUrl, resolveConfiguredBaseUrl, resolveOpenAiWhisperBaseUrl, } from "./openai/base-url.js";
+export * from "./prompts/index.js";
+export type { SummaryLength } from "./shared/contracts.js";
+export { SUMMARY_LENGTHS } from "./shared/contracts.js";

package/dist/types/language.d.ts

@@ -1,7 +1,7 @@
 export type OutputLanguage = {
-    kind: 'auto';
+    kind: "auto";
 } | {
-    kind: 'fixed';
+    kind: "fixed";
     /**
      * BCP-47-ish language tag (e.g. "en", "de", "en-US").
      *
@@ -17,9 +17,9 @@ export declare function parseOutputLanguage(raw: string): OutputLanguage;
 export declare function resolveOutputLanguage(raw: string | null | undefined): OutputLanguage;
 export declare function formatOutputLanguageInstruction(language: OutputLanguage): string;
 export declare function formatOutputLanguageForJson(language: OutputLanguage): {
-    mode: 'auto';
+    mode: "auto";
 } | {
-    mode: 'fixed';
+    mode: "fixed";
     tag: string;
     label: string;
 };

package/dist/types/openai/base-url.d.ts

@@ -0,0 +1,14 @@
+type Env = Record<string, string | undefined>;
+export declare function normalizeBaseUrl(raw: string | null | undefined): string | null;
+export declare function isOpenRouterBaseUrl(baseUrl: string): boolean;
+export declare function resolveConfiguredBaseUrl({ envValue, configValue, }: {
+    envValue: string | null | undefined;
+    configValue: string | null | undefined;
+}): string | null;
+export declare function resolveOpenAiWhisperBaseUrl({ explicitBaseUrl, env, allowOpenRouterFallback, defaultBaseUrl, }: {
+    explicitBaseUrl?: string | null;
+    env?: Env;
+    allowOpenRouterFallback?: boolean;
+    defaultBaseUrl?: string;
+}): string;
+export {};

package/dist/types/processes.d.ts

@@ -1,4 +1,4 @@
-import type { ChildProcess, ExecFileException, ExecFileOptions, SpawnOptions } from 'node:child_process';
+import type { ChildProcess, ExecFileException, ExecFileOptions, SpawnOptions } from "node:child_process";
 export type ProcessContext = {
     runId?: string | null;
     source?: string | null;
@@ -17,7 +17,7 @@ export type ProcessRegistration = {
 export type ProcessHandle = {
     id: string;
     setPid: (pid: number | null) => void;
-    appendOutput: (stream: 'stdout' | 'stderr', line: string) => void;
+    appendOutput: (stream: "stdout" | "stderr", line: string) => void;
     setProgress: (progress: number | null, detail?: string | null) => void;
     setStatus: (text: string | null) => void;
     finish: (result: {