@steipete/summarize 0.10.0 → 0.11.1

package/dist/esm/run/runner.js

@@ -1,41 +1,46 @@
-import { execFile } from 'node:child_process';
-import { readFile } from 'node:fs/promises';
-import { CommanderError } from 'commander';
-import { clearCacheFiles, DEFAULT_CACHE_MAX_MB, resolveCachePath, } from '../cache.js';
-import { loadSummarizeConfig } from '../config.js';
-import { parseExtractFormat, parseMaxExtractCharactersArg, parseMetricsMode, parseStreamMode, } from '../flags.js';
-import { resolveSlideSettings } from '../slides/index.js';
-import { createThemeRenderer, resolveThemeNameFromSources, resolveTrueColor } from '../tty/theme.js';
-import { formatVersionLine } from '../version.js';
-import { createCacheStateFromConfig } from './cache-state.js';
-import { handleDaemonCliRequest, handleHelpRequest, handleRefreshFreeRequest, } from './cli-preflight.js';
-import { parseCliProviderArg } from './env.js';
-import { extractAssetContent } from './flows/asset/extract.js';
-import { handleFileInput, withUrlAsset } from './flows/asset/input.js';
-import { summarizeMediaFile as summarizeMediaFileImpl } from './flows/asset/media.js';
-import { outputExtractedAsset } from './flows/asset/output.js';
-import { summarizeAsset as summarizeAssetFlow } from './flows/asset/summary.js';
-import { runUrlFlow } from './flows/url/flow.js';
-import { attachRichHelp, buildProgram } from './help.js';
-import { createMediaCacheFromConfig } from './media-cache-state.js';
-import { createProgressGate } from './progress.js';
-import { resolveRunContextState } from './run-context.js';
-import { resolveRunInput } from './run-input.js';
-import { createRunMetrics } from './run-metrics.js';
-import { resolveModelSelection } from './run-models.js';
-import { resolveDesiredOutputTokens } from './run-output.js';
-import { resolveCliRunSettings } from './run-settings.js';
-import { resolveStreamSettings } from './run-stream.js';
-import { handleSlidesCliRequest } from './slides-cli.js';
-import { createSummaryEngine } from './summary-engine.js';
-import { isRichTty, supportsColor } from './terminal.js';
-import { handleTranscriberCliRequest } from './transcriber-cli.js';
-export async function runCli(argv, { env, fetch, execFile: execFileOverride, stdout, stderr }) {
-    ;
+import { CommanderError } from "commander";
+import { execFile } from "node:child_process";
+import fs from "node:fs/promises";
+import { clearCacheFiles, DEFAULT_CACHE_MAX_MB, resolveCachePath, } from "../cache.js";
+import { loadSummarizeConfig, mergeConfigEnv } from "../config.js";
+import { parseExtractFormat, parseMaxExtractCharactersArg, parseMetricsMode, parseStreamMode, } from "../flags.js";
+import { resolveSlideSettings } from "../slides/index.js";
+import { createThemeRenderer, resolveThemeNameFromSources, resolveTrueColor, } from "../tty/theme.js";
+import { formatVersionLine } from "../version.js";
+import { createCacheStateFromConfig } from "./cache-state.js";
+import { handleDaemonCliRequest, handleHelpRequest, handleRefreshFreeRequest, } from "./cli-preflight.js";
+import { parseCliProviderArg } from "./env.js";
+import { extractAssetContent } from "./flows/asset/extract.js";
+import { handleFileInput, isTranscribableExtension, withUrlAsset } from "./flows/asset/input.js";
+import { summarizeMediaFile as summarizeMediaFileImpl } from "./flows/asset/media.js";
+import { outputExtractedAsset } from "./flows/asset/output.js";
+import { summarizeAsset as summarizeAssetFlow } from "./flows/asset/summary.js";
+import { runUrlFlow } from "./flows/url/flow.js";
+import { attachRichHelp, buildProgram } from "./help.js";
+import { createMediaCacheFromConfig } from "./media-cache-state.js";
+import { createProgressGate } from "./progress.js";
+import { resolveRunContextState } from "./run-context.js";
+import { resolveRunInput } from "./run-input.js";
+import { createRunMetrics } from "./run-metrics.js";
+import { resolveModelSelection } from "./run-models.js";
+import { resolveDesiredOutputTokens } from "./run-output.js";
+import { resolveCliRunSettings } from "./run-settings.js";
+import { resolveStreamSettings } from "./run-stream.js";
+import { handleSlidesCliRequest } from "./slides-cli.js";
+import { createTempFileFromStdin } from "./stdin-temp-file.js";
+import { createSummaryEngine } from "./summary-engine.js";
+import { isRichTty, supportsColor } from "./terminal.js";
+import { handleTranscriberCliRequest } from "./transcriber-cli.js";
+export async function runCli(argv, { env: inputEnv, fetch, execFile: execFileOverride, stdin, stdout, stderr }) {
     globalThis.AI_SDK_LOG_WARNINGS = false;
-    const normalizedArgv = argv.filter((arg) => arg !== '--');
-    const noColorFlag = normalizedArgv.includes('--no-color');
-    const envForRun = noColorFlag ? { ...env, NO_COLOR: '1', FORCE_COLOR: '0' } : env;
+    const normalizedArgv = argv.filter((arg) => arg !== "--");
+    const noColorFlag = normalizedArgv.includes("--no-color");
+    let envForRun = noColorFlag
+        ? { ...inputEnv, NO_COLOR: "1", FORCE_COLOR: "0" }
+        : { ...inputEnv };
+    const { config: bootstrapConfig } = loadSummarizeConfig({ env: envForRun });
+    envForRun = mergeConfigEnv({ env: envForRun, config: bootstrapConfig });
+    const env = envForRun;
     if (handleHelpRequest({ normalizedArgv, envForRun, stdout, stderr })) {
         return;
     }
@@ -87,10 +92,10 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
     program.exitOverride();
     attachRichHelp(program, envForRun, stdout);
     try {
-        program.parse(normalizedArgv, { from: 'user' });
+        program.parse(normalizedArgv, { from: "user" });
     }
     catch (error) {
-        if (error instanceof CommanderError && error.code === 'commander.helpDisplayed') {
+        if (error instanceof CommanderError && error.code === "commander.helpDisplayed") {
             return;
         }
         throw error;
@@ -99,16 +104,16 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
         stdout.write(`${formatVersionLine()}\n`);
         return;
     }
-    const promptArg = typeof program.opts().prompt === 'string' ? program.opts().prompt : null;
-    const promptFileArg = typeof program.opts().promptFile === 'string' ? program.opts().promptFile : null;
+    const promptArg = typeof program.opts().prompt === "string" ? program.opts().prompt : null;
+    const promptFileArg = typeof program.opts().promptFile === "string" ? program.opts().promptFile : null;
     if (promptArg && promptFileArg) {
-        throw new Error('Use either --prompt or --prompt-file (not both).');
+        throw new Error("Use either --prompt or --prompt-file (not both).");
     }
     let promptOverride = null;
     if (promptFileArg) {
         let text;
         try {
-            text = await readFile(promptFileArg, 'utf8');
+            text = await fs.readFile(promptFileArg, "utf8");
         }
         catch (error) {
             const message = error instanceof Error ? error.message : String(error);
@@ -123,15 +128,15 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
     else if (promptArg) {
         const trimmed = promptArg.trim();
         if (!trimmed) {
-            throw new Error('Prompt must not be empty.');
+            throw new Error("Prompt must not be empty.");
         }
         promptOverride = trimmed;
     }
-    const clearCacheFlag = normalizedArgv.includes('--clear-cache');
+    const clearCacheFlag = normalizedArgv.includes("--clear-cache");
     if (clearCacheFlag) {
-        const extraArgs = normalizedArgv.filter((arg) => arg !== '--clear-cache');
+        const extraArgs = normalizedArgv.filter((arg) => arg !== "--clear-cache");
         if (extraArgs.length > 0) {
-            throw new Error('--clear-cache must be used alone.');
+            throw new Error("--clear-cache must be used alone.");
         }
         const { config } = loadSummarizeConfig({ env: envForRun });
         const cachePath = resolveCachePath({
@@ -139,17 +144,17 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
             cachePath: config?.cache?.path ?? null,
         });
         if (!cachePath) {
-            throw new Error('Unable to resolve cache path (missing HOME).');
+            throw new Error("Unable to resolve cache path (missing HOME).");
         }
         clearCacheFiles(cachePath);
-        stdout.write('Cache cleared.\n');
+        stdout.write("Cache cleared.\n");
         return;
     }
-    const cacheStatsFlag = normalizedArgv.includes('--cache-stats');
+    const cacheStatsFlag = normalizedArgv.includes("--cache-stats");
     if (cacheStatsFlag) {
-        const extraArgs = normalizedArgv.filter((arg) => arg !== '--cache-stats');
+        const extraArgs = normalizedArgv.filter((arg) => arg !== "--cache-stats");
         if (extraArgs.length > 0) {
-            throw new Error('--cache-stats must be used alone.');
+            throw new Error("--cache-stats must be used alone.");
         }
         const { config } = loadSummarizeConfig({ env: envForRun });
         const cachePath = resolveCachePath({
@@ -157,26 +162,26 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
             cachePath: config?.cache?.path ?? null,
         });
         if (!cachePath) {
-            throw new Error('Unable to resolve cache path (missing HOME).');
+            throw new Error("Unable to resolve cache path (missing HOME).");
         }
-        const cacheMaxMb = typeof config?.cache?.maxMb === 'number' ? config.cache.maxMb : DEFAULT_CACHE_MAX_MB;
+        const cacheMaxMb = typeof config?.cache?.maxMb === "number" ? config.cache.maxMb : DEFAULT_CACHE_MAX_MB;
         const cacheMaxBytes = Math.max(0, cacheMaxMb) * 1024 * 1024;
-        const { readCacheStats } = await import('../cache.js');
-        const { formatBytes } = await import('../tty/format.js');
+        const { readCacheStats } = await import("../cache.js");
+        const { formatBytes } = await import("../tty/format.js");
         const stats = await readCacheStats(cachePath);
         stdout.write(`Cache path: ${cachePath}\n`);
         if (!stats) {
-            stdout.write('Cache is empty.\n');
+            stdout.write("Cache is empty.\n");
             return;
         }
         const sizeLabel = formatBytes(stats.sizeBytes);
-        const maxLabel = cacheMaxBytes > 0 ? formatBytes(cacheMaxBytes) : 'disabled';
+        const maxLabel = cacheMaxBytes > 0 ? formatBytes(cacheMaxBytes) : "disabled";
         stdout.write(`Size: ${sizeLabel} (max ${maxLabel})\n`);
         stdout.write(`Entries: total=${stats.totalEntries} extract=${stats.counts.extract} summary=${stats.counts.summary} transcript=${stats.counts.transcript}\n`);
         return;
     }
-    const cliFlagPresent = normalizedArgv.some((arg) => arg === '--cli' || arg.startsWith('--cli='));
-    let cliProviderArgRaw = typeof program.opts().cli === 'string' ? program.opts().cli : null;
+    const cliFlagPresent = normalizedArgv.some((arg) => arg === "--cli" || arg.startsWith("--cli="));
+    let cliProviderArgRaw = typeof program.opts().cli === "string" ? program.opts().cli : null;
     const inputResolution = resolveRunInput({
         program,
         cliFlagPresent,
@@ -187,12 +192,12 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
     const inputTarget = inputResolution.inputTarget;
     const url = inputResolution.url;
     const runStartedAtMs = Date.now();
-    const videoModeExplicitlySet = normalizedArgv.some((arg) => arg === '--video-mode' || arg.startsWith('--video-mode='));
-    const lengthExplicitlySet = normalizedArgv.some((arg) => arg === '--length' || arg.startsWith('--length='));
-    const languageExplicitlySet = normalizedArgv.some((arg) => arg === '--language' ||
-        arg.startsWith('--language=') ||
-        arg === '--lang' ||
-        arg.startsWith('--lang='));
+    const videoModeExplicitlySet = normalizedArgv.some((arg) => arg === "--video-mode" || arg.startsWith("--video-mode="));
+    const lengthExplicitlySet = normalizedArgv.some((arg) => arg === "--length" || arg.startsWith("--length="));
+    const languageExplicitlySet = normalizedArgv.some((arg) => arg === "--language" ||
+        arg.startsWith("--language=") ||
+        arg === "--lang" ||
+        arg.startsWith("--lang="));
     const noCacheFlag = program.opts().cache === false;
     const noMediaCacheFlag = program.opts().mediaCache === false;
     const extractMode = Boolean(program.opts().extract) || Boolean(program.opts().extractOnly);
@@ -204,47 +209,47 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
     const debug = Boolean(program.opts().debug);
     const verbose = Boolean(program.opts().verbose) || debug;
     const normalizeTranscriber = (value) => {
-        if (typeof value !== 'string')
+        if (typeof value !== "string")
             return null;
         const normalized = value.trim().toLowerCase();
-        if (normalized === 'auto' ||
-            normalized === 'whisper' ||
-            normalized === 'parakeet' ||
-            normalized === 'canary')
+        if (normalized === "auto" ||
+            normalized === "whisper" ||
+            normalized === "parakeet" ||
+            normalized === "canary")
             return normalized;
         return null;
     };
-    const transcriberExplicitlySet = normalizedArgv.some((arg) => arg === '--transcriber' || arg.startsWith('--transcriber='));
+    const transcriberExplicitlySet = normalizedArgv.some((arg) => arg === "--transcriber" || arg.startsWith("--transcriber="));
     const envTranscriber = envForRun?.SUMMARIZE_TRANSCRIBER ??
         process.env.SUMMARIZE_TRANSCRIBER ??
         null;
     const transcriber = normalizeTranscriber(transcriberExplicitlySet ? program.opts().transcriber : envTranscriber) ??
-        'auto';
+        "auto";
     envForRun.SUMMARIZE_TRANSCRIBER = transcriber;
-    const maxExtractCharacters = parseMaxExtractCharactersArg(typeof program.opts().maxExtractCharacters === 'string'
+    const maxExtractCharacters = parseMaxExtractCharactersArg(typeof program.opts().maxExtractCharacters === "string"
         ? program.opts().maxExtractCharacters
         : program.opts().maxExtractCharacters != null
             ? String(program.opts().maxExtractCharacters)
             : undefined);
-    const isYoutubeUrl = typeof url === 'string' ? /youtube\.com|youtu\.be/i.test(url) : false;
-    const formatExplicitlySet = normalizedArgv.some((arg) => arg === '--format' || arg.startsWith('--format='));
-    const rawFormatOpt = typeof program.opts().format === 'string' ? program.opts().format : null;
+    const isYoutubeUrl = typeof url === "string" ? /youtube\.com|youtu\.be/i.test(url) : false;
+    const formatExplicitlySet = normalizedArgv.some((arg) => arg === "--format" || arg.startsWith("--format="));
+    const rawFormatOpt = typeof program.opts().format === "string" ? program.opts().format : null;
     const format = parseExtractFormat(formatExplicitlySet
-        ? (rawFormatOpt ?? 'text')
-        : extractMode && inputTarget.kind === 'url' && !isYoutubeUrl
-            ? 'md'
-            : 'text');
+        ? (rawFormatOpt ?? "text")
+        : extractMode && inputTarget.kind === "url" && !isYoutubeUrl
+            ? "md"
+            : "text");
     const runSettings = resolveCliRunSettings({
         length: String(program.opts().length),
         firecrawl: String(program.opts().firecrawl),
-        markdownMode: typeof program.opts().markdownMode === 'string' ? program.opts().markdownMode : undefined,
-        markdown: typeof program.opts().markdown === 'string' ? program.opts().markdown : undefined,
+        markdownMode: typeof program.opts().markdownMode === "string" ? program.opts().markdownMode : undefined,
+        markdown: typeof program.opts().markdown === "string" ? program.opts().markdown : undefined,
         format,
         preprocess: String(program.opts().preprocess),
         youtube: String(program.opts().youtube),
         timeout: String(program.opts().timeout),
         retries: String(program.opts().retries),
-        maxOutputTokens: typeof program.opts().maxOutputTokens === 'string'
+        maxOutputTokens: typeof program.opts().maxOutputTokens === "string"
             ? program.opts().maxOutputTokens
             : program.opts().maxOutputTokens != null
                 ? String(program.opts().maxOutputTokens)
@@ -252,31 +257,31 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
     });
     const { youtubeMode, lengthArg, maxOutputTokensArg, timeoutMs, retries, preprocessMode, firecrawlMode: requestedFirecrawlMode, markdownMode, } = runSettings;
     if (extractMode && lengthExplicitlySet && !json && isRichTty(stderr)) {
-        stderr.write('Warning: --length is ignored with --extract (no summary is generated).\n');
+        stderr.write("Warning: --length is ignored with --extract (no summary is generated).\n");
     }
-    const metricsExplicitlySet = normalizedArgv.some((arg) => arg === '--metrics' || arg.startsWith('--metrics='));
-    const metricsMode = parseMetricsMode(debug && !metricsExplicitlySet ? 'detailed' : program.opts().metrics);
-    const metricsEnabled = metricsMode !== 'off';
-    const metricsDetailed = metricsMode === 'detailed';
+    const metricsExplicitlySet = normalizedArgv.some((arg) => arg === "--metrics" || arg.startsWith("--metrics="));
+    const metricsMode = parseMetricsMode(debug && !metricsExplicitlySet ? "detailed" : program.opts().metrics);
+    const metricsEnabled = metricsMode !== "off";
+    const metricsDetailed = metricsMode === "detailed";
     const shouldComputeReport = metricsEnabled;
-    const _firecrawlExplicitlySet = normalizedArgv.some((arg) => arg === '--firecrawl' || arg.startsWith('--firecrawl='));
-    const markdownModeExplicitlySet = normalizedArgv.some((arg) => arg === '--markdown-mode' ||
-        arg.startsWith('--markdown-mode=') ||
-        arg === '--markdown' ||
-        arg.startsWith('--markdown='));
-    const modelArg = typeof program.opts().model === 'string' ? program.opts().model : null;
-    const cliProviderArg = typeof cliProviderArgRaw === 'string' && cliProviderArgRaw.trim().length > 0
+    const _firecrawlExplicitlySet = normalizedArgv.some((arg) => arg === "--firecrawl" || arg.startsWith("--firecrawl="));
+    const markdownModeExplicitlySet = normalizedArgv.some((arg) => arg === "--markdown-mode" ||
+        arg.startsWith("--markdown-mode=") ||
+        arg === "--markdown" ||
+        arg.startsWith("--markdown="));
+    const modelArg = typeof program.opts().model === "string" ? program.opts().model : null;
+    const cliProviderArg = typeof cliProviderArgRaw === "string" && cliProviderArgRaw.trim().length > 0
         ? parseCliProviderArg(cliProviderArgRaw)
         : null;
     if (cliFlagPresent && modelArg) {
-        throw new Error('Use either --model or --cli (not both).');
+        throw new Error("Use either --model or --cli (not both).");
     }
     const explicitModelArg = cliProviderArg
         ? `cli/${cliProviderArg}`
         : cliFlagPresent
-            ? 'auto'
+            ? "auto"
             : modelArg;
-    const { config, configPath, outputLanguage, openaiWhisperUsdPerMinute, videoMode, cliConfigForRun, configForCli, openaiUseChatCompletions, configModelLabel, apiKey, openrouterApiKey, openrouterConfigured, openaiTranscriptionKey, xaiApiKey, googleApiKey, anthropicApiKey, zaiApiKey, zaiBaseUrl, providerBaseUrls, firecrawlApiKey, firecrawlConfigured, googleConfigured, anthropicConfigured, apifyToken, ytDlpPath, falApiKey, cliAvailability, envForAuto, } = resolveRunContextState({
+    const { config, configPath, outputLanguage, openaiWhisperUsdPerMinute, videoMode, cliConfigForRun, configForCli, openaiUseChatCompletions, configModelLabel, apiKey, openrouterApiKey, openrouterConfigured, groqApiKey, openaiTranscriptionKey, xaiApiKey, googleApiKey, anthropicApiKey, zaiApiKey, zaiBaseUrl, providerBaseUrls, firecrawlApiKey, firecrawlConfigured, googleConfigured, anthropicConfigured, apifyToken, ytDlpPath, ytDlpCookiesFromBrowser, falApiKey, cliAvailability, envForAuto, } = resolveRunContextState({
         env,
         envForRun,
         programOpts: program.opts(),
@@ -291,15 +296,15 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
         config: config?.ui?.theme,
     });
     envForRun.SUMMARIZE_THEME = themeName;
-    if (!promptOverride && typeof config?.prompt === 'string' && config.prompt.trim().length > 0) {
+    if (!promptOverride && typeof config?.prompt === "string" && config.prompt.trim().length > 0) {
         promptOverride = config.prompt.trim();
     }
-    const slidesExplicitlySet = normalizedArgv.some((arg) => arg === '--slides' || arg === '--no-slides' || arg.startsWith('--slides='));
-    const slidesOcrExplicitlySet = normalizedArgv.some((arg) => arg === '--slides-ocr' || arg === '--no-slides-ocr' || arg.startsWith('--slides-ocr='));
-    const slidesDirExplicitlySet = normalizedArgv.some((arg) => arg === '--slides-dir' || arg.startsWith('--slides-dir='));
-    const slidesSceneThresholdExplicitlySet = normalizedArgv.some((arg) => arg === '--slides-scene-threshold' || arg.startsWith('--slides-scene-threshold='));
-    const slidesMaxExplicitlySet = normalizedArgv.some((arg) => arg === '--slides-max' || arg.startsWith('--slides-max='));
-    const slidesMinDurationExplicitlySet = normalizedArgv.some((arg) => arg === '--slides-min-duration' || arg.startsWith('--slides-min-duration='));
+    const slidesExplicitlySet = normalizedArgv.some((arg) => arg === "--slides" || arg === "--no-slides" || arg.startsWith("--slides="));
+    const slidesOcrExplicitlySet = normalizedArgv.some((arg) => arg === "--slides-ocr" || arg === "--no-slides-ocr" || arg.startsWith("--slides-ocr="));
+    const slidesDirExplicitlySet = normalizedArgv.some((arg) => arg === "--slides-dir" || arg.startsWith("--slides-dir="));
+    const slidesSceneThresholdExplicitlySet = normalizedArgv.some((arg) => arg === "--slides-scene-threshold" || arg.startsWith("--slides-scene-threshold="));
+    const slidesMaxExplicitlySet = normalizedArgv.some((arg) => arg === "--slides-max" || arg.startsWith("--slides-max="));
+    const slidesMinDurationExplicitlySet = normalizedArgv.some((arg) => arg === "--slides-min-duration" || arg.startsWith("--slides-min-duration="));
     const slidesConfig = config?.slides;
     const slidesSettings = resolveSlideSettings({
         slides: slidesExplicitlySet
@@ -314,7 +319,7 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
         slidesSceneThreshold: slidesSceneThresholdExplicitlySet
             ? program.opts().slidesSceneThreshold
             : (slidesConfig?.sceneThreshold ?? program.opts().slidesSceneThreshold),
-        slidesSceneThresholdExplicit: slidesSceneThresholdExplicitlySet || typeof slidesConfig?.sceneThreshold === 'number',
+        slidesSceneThresholdExplicit: slidesSceneThresholdExplicitlySet || typeof slidesConfig?.sceneThreshold === "number",
         slidesMax: slidesMaxExplicitlySet
             ? program.opts().slidesMax
             : (slidesConfig?.max ?? program.opts().slidesMax),
@@ -323,14 +328,14 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
             : (slidesConfig?.minDuration ?? program.opts().slidesMinDuration),
         cwd: process.cwd(),
     });
-    if (slidesSettings && inputTarget.kind !== 'url') {
-        throw new Error('--slides is only supported for URL inputs');
+    if (slidesSettings && inputTarget.kind !== "url") {
+        throw new Error("--slides is only supported for URL inputs");
     }
     const transcriptTimestamps = Boolean(program.opts().timestamps) || Boolean(slidesSettings);
-    const lengthInstruction = promptOverride && lengthExplicitlySet && lengthArg.kind === 'chars'
+    const lengthInstruction = promptOverride && lengthExplicitlySet && lengthArg.kind === "chars"
         ? `Output is ${lengthArg.maxCharacters.toLocaleString()} characters.`
         : null;
-    const languageInstruction = promptOverride && languageExplicitlySet && outputLanguage.kind === 'fixed'
+    const languageInstruction = promptOverride && languageExplicitlySet && outputLanguage.kind === "fixed"
         ? `Output should be ${outputLanguage.label}.`
         : null;
     const transcriptNamespace = `yt:${youtubeMode}`;
@@ -346,11 +351,19 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
         noMediaCacheFlag,
     });
     try {
-        if (markdownModeExplicitlySet && format !== 'markdown') {
-            throw new Error('--markdown-mode is only supported with --format md');
+        if (markdownModeExplicitlySet && format !== "markdown") {
+            throw new Error("--markdown-mode is only supported with --format md");
         }
-        if (markdownModeExplicitlySet && inputTarget.kind !== 'url') {
-            throw new Error('--markdown-mode is only supported for URL inputs');
+        if (markdownModeExplicitlySet &&
+            inputTarget.kind !== "url" &&
+            inputTarget.kind !== "file" &&
+            inputTarget.kind !== "stdin") {
+            throw new Error("--markdown-mode is only supported for URL, file, or stdin inputs");
+        }
+        if (markdownModeExplicitlySet &&
+            (inputTarget.kind === "file" || inputTarget.kind === "stdin") &&
+            markdownMode !== "llm") {
+            throw new Error("Only --markdown-mode llm is supported for file/stdin inputs; other modes require a URL");
         }
         const metrics = createRunMetrics({
             env,
@@ -358,7 +371,7 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
             maxOutputTokensArg,
         });
         const { llmCalls, trackedFetch, buildReport, estimateCostUsd, getLiteLlmCatalog, resolveMaxOutputTokensForCall, resolveMaxInputTokensForCall, setTranscriptionCost, } = metrics;
-        const { requestedModel, requestedModelInput, requestedModelLabel, isNamedModelSelection, wantsFreeNamedModel, configForModelSelection, isFallbackModel, } = resolveModelSelection({
+        const { requestedModel, requestedModelInput, requestedModelLabel, isNamedModelSelection, isImplicitAutoSelection, wantsFreeNamedModel, configForModelSelection, isFallbackModel, } = resolveModelSelection({
             config,
             configForCli,
             configPath,
@@ -371,23 +384,28 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
             enabled: verboseColor,
             trueColor: resolveTrueColor(envForRun),
         });
-        const renderSpinnerStatus = (label, detail = '…') => `${themeForStderr.label(label)}${themeForStderr.dim(detail)}`;
-        const renderSpinnerStatusWithModel = (label, modelId) => `${themeForStderr.label(label)}${themeForStderr.dim(' (model: ')}${themeForStderr.accent(modelId)}${themeForStderr.dim(')…')}`;
+        const renderSpinnerStatus = (label, detail = "…") => `${themeForStderr.label(label)}${themeForStderr.dim(detail)}`;
+        const renderSpinnerStatusWithModel = (label, modelId) => `${themeForStderr.label(label)}${themeForStderr.dim(" (model: ")}${themeForStderr.accent(modelId)}${themeForStderr.dim(")…")}`;
         const { streamingEnabled } = resolveStreamSettings({
             streamMode,
             stdout,
             json,
             extractMode,
         });
-        if (extractMode && inputTarget.kind !== 'url') {
-            throw new Error('--extract is only supported for website/YouTube URLs');
+        if (extractMode &&
+            inputTarget.kind === "file" &&
+            !isTranscribableExtension(inputTarget.filePath)) {
+            throw new Error("--extract for local files is only supported for media files (MP3, MP4, WAV, etc.)");
+        }
+        if (extractMode && inputTarget.kind === "stdin") {
+            throw new Error("--extract is not supported for piped stdin input");
         }
         // Progress UI (spinner + OSC progress) is shown on stderr. Before writing to stdout (including
         // streaming output), we stop + clear progress via the progress gate to keep scrollback clean.
         const progressEnabled = isRichTty(stderr) && !verbose && !json;
         const progressGate = createProgressGate();
         const { clearProgressForStdout, restoreProgressAfterStdout, setClearProgressBeforeStdout, clearProgressIfCurrent, } = progressGate;
-        const fixedModelSpec = requestedModel.kind === 'fixed' ? requestedModel : null;
+        const fixedModelSpec = requestedModel.kind === "fixed" ? requestedModel : null;
         const desiredOutputTokens = resolveDesiredOutputTokens({ lengthArg, maxOutputTokensArg });
         const summaryEngine = createSummaryEngine({
             env,
@@ -437,7 +455,7 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
             if (filtered.length === 0)
                 return;
             clearProgressForStdout();
-            stderr.write(`${themeForStderr.dim(`via ${filtered.join(', ')}`)}\n`);
+            stderr.write(`${themeForStderr.dim(`via ${filtered.join(", ")}`)}\n`);
             restoreProgressAfterStdout?.();
         };
         const assetSummaryContext = {
@@ -459,6 +477,8 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
             lengthInstruction,
             languageInstruction,
             isFallbackModel,
+            isImplicitAutoSelection,
+            allowAutoCliFallback: false,
             desiredOutputTokens,
             envForAuto,
             configForModelSelection,
@@ -517,6 +537,21 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
             setClearProgressBeforeStdout,
             clearProgressIfCurrent,
         };
+        if (inputTarget.kind === "stdin") {
+            const stdinTempFile = await createTempFileFromStdin({
+                stream: stdin ?? process.stdin,
+            });
+            try {
+                const stdinInputTarget = { kind: "file", filePath: stdinTempFile.filePath };
+                if (await handleFileInput(assetInputContext, stdinInputTarget)) {
+                    return;
+                }
+                throw new Error("Failed to process stdin input");
+            }
+            finally {
+                await stdinTempFile.cleanup();
+            }
+        }
         if (await handleFileInput(assetInputContext, inputTarget)) {
             return;
         }
@@ -524,7 +559,7 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
             (await withUrlAsset(assetInputContext, url, isYoutubeUrl, async ({ loaded, spinner }) => {
                 if (extractMode) {
                     if (progressEnabled)
-                        spinner.setText(renderSpinnerStatus('Extracting text'));
+                        spinner.setText(renderSpinnerStatus("Extracting text"));
                     const extracted = await extractAssetContent({
                         ctx: {
                             env,
@@ -572,22 +607,22 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
                     return;
                 }
                 if (progressEnabled)
-                    spinner.setText(renderSpinnerStatus('Summarizing'));
+                    spinner.setText(renderSpinnerStatus("Summarizing"));
                 await summarizeAsset({
-                    sourceKind: 'asset-url',
+                    sourceKind: "asset-url",
                     sourceLabel: loaded.sourceLabel,
                     attachment: loaded.attachment,
                     onModelChosen: (modelId) => {
                         if (!progressEnabled)
                             return;
-                        spinner.setText(renderSpinnerStatusWithModel('Summarizing', modelId));
+                        spinner.setText(renderSpinnerStatusWithModel("Summarizing", modelId));
                     },
                 });
             }))) {
             return;
         }
         if (!url) {
-            throw new Error('Only HTTP and HTTPS URLs can be summarized');
+            throw new Error("Only HTTP and HTTPS URLs can be summarized");
         }
         const urlFlowContext = {
             io: {
@@ -641,6 +676,8 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
                 requestedModelLabel,
                 fixedModelSpec,
                 isFallbackModel,
+                isImplicitAutoSelection,
+                allowAutoCliFallback: false,
                 isNamedModelSelection,
                 wantsFreeNamedModel,
                 desiredOutputTokens,
@@ -665,7 +702,9 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
                     firecrawlApiKey,
                     apifyToken,
                     ytDlpPath,
+                    ytDlpCookiesFromBrowser,
                     falApiKey,
+                    groqApiKey,
                     openaiTranscriptionKey,
                 },
                 summaryEngine,