@steipete/summarize 0.2.0 → 0.3.0

package/dist/types/llm/generate-text.d.ts

@@ -4,13 +4,17 @@ export type LlmApiKeys = {
     openaiApiKey: string | null;
     googleApiKey: string | null;
     anthropicApiKey: string | null;
+    openrouterApiKey: string | null;
+};
+export type OpenRouterOptions = {
+    providers: string[] | null;
 };
 export type LlmTokenUsage = {
     promptTokens: number | null;
     completionTokens: number | null;
     totalTokens: number | null;
 };
-export declare function generateTextWithModelId({ modelId, apiKeys, system, prompt, temperature, maxOutputTokens, timeoutMs, fetchImpl, }: {
+export declare function generateTextWithModelId({ modelId, apiKeys, system, prompt, temperature, maxOutputTokens, timeoutMs, fetchImpl, openrouter, }: {
     modelId: string;
     apiKeys: LlmApiKeys;
     system?: string;
@@ -19,13 +23,14 @@ export declare function generateTextWithModelId({ modelId, apiKeys, system, prom
     maxOutputTokens?: number;
     timeoutMs: number;
     fetchImpl: typeof fetch;
+    openrouter?: OpenRouterOptions;
 }): Promise<{
     text: string;
     canonicalModelId: string;
     provider: 'xai' | 'openai' | 'google' | 'anthropic';
     usage: LlmTokenUsage | null;
 }>;
-export declare function streamTextWithModelId({ modelId, apiKeys, system, prompt, temperature, maxOutputTokens, timeoutMs, fetchImpl, }: {
+export declare function streamTextWithModelId({ modelId, apiKeys, system, prompt, temperature, maxOutputTokens, timeoutMs, fetchImpl, openrouter, }: {
     modelId: string;
     apiKeys: LlmApiKeys;
     system?: string;
@@ -34,6 +39,7 @@ export declare function streamTextWithModelId({ modelId, apiKeys, system, prompt
     maxOutputTokens?: number;
     timeoutMs: number;
     fetchImpl: typeof fetch;
+    openrouter?: OpenRouterOptions;
 }): Promise<{
     textStream: AsyncIterable<string>;
     canonicalModelId: string;

package/dist/types/llm/html-to-markdown.d.ts

@@ -1,12 +1,15 @@
 import type { ConvertHtmlToMarkdown } from '../content/link-preview/deps.js';
 import type { LlmTokenUsage } from './generate-text.js';
-export declare function createHtmlToMarkdownConverter({ modelId, xaiApiKey, googleApiKey, openaiApiKey, anthropicApiKey, fetchImpl, onUsage, }: {
+import { type OpenRouterOptions } from './generate-text.js';
+export declare function createHtmlToMarkdownConverter({ modelId, xaiApiKey, googleApiKey, openaiApiKey, anthropicApiKey, openrouterApiKey, openrouter, fetchImpl, onUsage, }: {
     modelId: string;
     xaiApiKey: string | null;
     googleApiKey: string | null;
     openaiApiKey: string | null;
     fetchImpl: typeof fetch;
     anthropicApiKey: string | null;
+    openrouterApiKey: string | null;
+    openrouter?: OpenRouterOptions;
     onUsage?: (usage: {
         model: string;
         provider: 'xai' | 'openai' | 'google' | 'anthropic';

package/dist/types/version.d.ts

@@ -1,2 +1,2 @@
-export declare const FALLBACK_VERSION = "0.2.0";
+export declare const FALLBACK_VERSION = "0.3.0";
 export declare function resolvePackageVersion(importMetaUrl?: string): string;

package/docs/youtube.md

@@ -2,11 +2,12 @@
 
 YouTube URLs use transcript-first extraction.
 
-## `--youtube auto|web|apify`
+## `--youtube auto|web|apify|yt-dlp`
 
-- `auto` (default): try `youtubei` → `captionTracks` → Apify (if token exists)
+- `auto` (default): try `youtubei` → `captionTracks` → Apify (if token exists) → `yt-dlp` (if configured)
 - `web`: try `youtubei` → `captionTracks` only
 - `apify`: Apify only
+- `yt-dlp`: download audio + transcribe (OpenAI Whisper preferred; FAL fallback)
 
 ## `youtubei` vs `captionTracks`
 
@@ -24,6 +25,8 @@ YouTube URLs use transcript-first extraction.
 - If no transcript is available, we still extract `ytInitialPlayerResponse.videoDetails.shortDescription` so YouTube links can still summarize meaningfully.
 - Apify is an optional fallback (needs `APIFY_API_TOKEN`).
   - By default, we use the actor id `faVsWy9VTSNVIhWpR` (Pinto Studio’s “Youtube Transcript Scraper”).
+- `yt-dlp` requires `YT_DLP_PATH` and either `OPENAI_API_KEY` (preferred) or `FAL_KEY`.
+  - If OpenAI transcription fails and `FAL_KEY` is set, we fall back to FAL automatically.
 
 ## Example
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steipete/summarize",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Link → clean text → summary.",
   "type": "module",
   "bin": {
@@ -30,7 +30,11 @@
     "README.md",
     "LICENSE"
   ],
+  "engines": {
+    "node": ">=22"
+  },
   "dependencies": {
+    "@fal-ai/client": "^1.2.1",
     "cheerio": "^1.1.2",
     "es-toolkit": "^1.43.0",
     "gpt-tokenizer": "^3.4.0",