@steipete/summarize 0.8.2 → 0.10.0

package/dist/esm/run/run-settings.js

@@ -0,0 +1,182 @@
+import { parseDurationMs, parseFirecrawlMode, parseLengthArg, parseMarkdownMode, parseMaxOutputTokensArg, parsePreprocessMode, parseRetriesArg, parseVideoMode, parseYoutubeMode, } from '../flags.js';
+import { resolveOutputLanguage } from '../language.js';
+export function resolveSummaryLength(raw, fallback = 'xl') {
+    const value = typeof raw === 'string' ? raw.trim() : '';
+    const lengthArg = parseLengthArg(value || fallback);
+    const summaryLength = lengthArg.kind === 'preset' ? lengthArg.preset : { maxCharacters: lengthArg.maxCharacters };
+    return { lengthArg, summaryLength };
+}
+export function resolveOutputLanguageSetting({ raw, fallback, }) {
+    const value = typeof raw === 'string' ? raw.trim() : '';
+    if (!value)
+        return fallback;
+    return resolveOutputLanguage(value);
+}
+export function resolveCliRunSettings({ length, firecrawl, markdownMode, markdown, format, preprocess, youtube, timeout, retries, maxOutputTokens, }) {
+    const strictOverrides = resolveRunOverrides({
+        firecrawl,
+        markdownMode: format === 'markdown' ? (markdownMode ?? markdown ?? 'readability') : 'off',
+        preprocess,
+        youtube,
+        timeout,
+        retries,
+        maxOutputTokens,
+    }, { strict: true });
+    const requireOverride = (value, label) => {
+        if (value == null) {
+            throw new Error(`Missing ${label} override value.`);
+        }
+        return value;
+    };
+    return {
+        lengthArg: parseLengthArg(length),
+        firecrawlMode: requireOverride(strictOverrides.firecrawlMode, '--firecrawl'),
+        markdownMode: requireOverride(strictOverrides.markdownMode, '--markdown-mode'),
+        preprocessMode: requireOverride(strictOverrides.preprocessMode, '--preprocess'),
+        youtubeMode: requireOverride(strictOverrides.youtubeMode, '--youtube'),
+        timeoutMs: requireOverride(strictOverrides.timeoutMs, '--timeout'),
+        retries: requireOverride(strictOverrides.retries, '--retries'),
+        maxOutputTokensArg: strictOverrides.maxOutputTokensArg,
+    };
+}
+const parseOptionalSetting = (raw, parse, strict) => {
+    if (typeof raw !== 'string')
+        return null;
+    try {
+        return parse(raw);
+    }
+    catch (error) {
+        if (strict)
+            throw error;
+        return null;
+    }
+};
+const parseOptionalBoolean = (raw, strict) => {
+    if (typeof raw === 'boolean')
+        return raw;
+    if (typeof raw !== 'string')
+        return null;
+    const normalized = raw.trim().toLowerCase();
+    if (!normalized)
+        return null;
+    if (normalized === 'true' || normalized === '1' || normalized === 'yes' || normalized === 'on') {
+        return true;
+    }
+    if (normalized === 'false' || normalized === '0' || normalized === 'no' || normalized === 'off') {
+        return false;
+    }
+    if (strict) {
+        throw new Error(`Unsupported --timestamps: ${raw}`);
+    }
+    return null;
+};
+export function resolveRunOverrides({ firecrawl, markdownMode, preprocess, youtube, videoMode, timestamps, forceSummary, timeout, retries, maxOutputTokens, transcriber, }, options = {}) {
+    const strict = options.strict ?? false;
+    const timeoutMs = (() => {
+        if (typeof timeout === 'number') {
+            if (Number.isFinite(timeout) && timeout > 0) {
+                return Math.floor(timeout);
+            }
+            if (strict) {
+                throw new Error(`Unsupported --timeout: ${String(timeout)}`);
+            }
+            return null;
+        }
+        if (typeof timeout !== 'string')
+            return null;
+        try {
+            return parseDurationMs(timeout);
+        }
+        catch (error) {
+            if (strict)
+                throw error;
+            return null;
+        }
+    })();
+    const retriesResolved = (() => {
+        if (typeof retries === 'number') {
+            if (Number.isFinite(retries) && Number.isInteger(retries)) {
+                try {
+                    return parseRetriesArg(String(retries));
+                }
+                catch (error) {
+                    if (strict)
+                        throw error;
+                    return null;
+                }
+            }
+            if (strict) {
+                throw new Error(`Unsupported --retries: ${String(retries)}`);
+            }
+            return null;
+        }
+        if (typeof retries !== 'string')
+            return null;
+        try {
+            return parseRetriesArg(retries);
+        }
+        catch (error) {
+            if (strict)
+                throw error;
+            return null;
+        }
+    })();
+    const maxOutputTokensArg = (() => {
+        if (typeof maxOutputTokens === 'number') {
+            if (Number.isFinite(maxOutputTokens) && maxOutputTokens > 0) {
+                try {
+                    return parseMaxOutputTokensArg(String(maxOutputTokens));
+                }
+                catch (error) {
+                    if (strict)
+                        throw error;
+                    return null;
+                }
+            }
+            if (strict) {
+                throw new Error(`Unsupported --max-output-tokens: ${String(maxOutputTokens)}`);
+            }
+            return null;
+        }
+        if (typeof maxOutputTokens !== 'string')
+            return null;
+        try {
+            return parseMaxOutputTokensArg(maxOutputTokens);
+        }
+        catch (error) {
+            if (strict)
+                throw error;
+            return null;
+        }
+    })();
+    const transcriberOverride = (() => {
+        if (typeof transcriber !== 'string')
+            return null;
+        const normalized = transcriber.trim().toLowerCase();
+        if (normalized === 'auto' ||
+            normalized === 'whisper' ||
+            normalized === 'parakeet' ||
+            normalized === 'canary') {
+            return normalized;
+        }
+        if (strict) {
+            throw new Error(`Unsupported transcriber: ${transcriber}`);
+        }
+        return null;
+    })();
+    const forceSummaryResolved = parseOptionalBoolean(forceSummary, strict);
+    return {
+        firecrawlMode: parseOptionalSetting(firecrawl, parseFirecrawlMode, strict),
+        markdownMode: parseOptionalSetting(markdownMode, parseMarkdownMode, strict),
+        preprocessMode: parseOptionalSetting(preprocess, parsePreprocessMode, strict),
+        youtubeMode: parseOptionalSetting(youtube, parseYoutubeMode, strict),
+        videoMode: parseOptionalSetting(videoMode, parseVideoMode, strict),
+        transcriptTimestamps: parseOptionalBoolean(timestamps, strict),
+        forceSummary: forceSummaryResolved,
+        timeoutMs,
+        retries: retriesResolved,
+        maxOutputTokensArg,
+        transcriber: transcriberOverride,
+    };
+}
+//# sourceMappingURL=run-settings.js.map

package/dist/esm/run/run-settings.js.map

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

package/dist/esm/run/runner.js

@@ -3,25 +3,33 @@ 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 { parseDurationMs, parseExtractFormat, parseFirecrawlMode, parseLengthArg, parseMarkdownMode, parseMaxOutputTokensArg, parseMetricsMode, parsePreprocessMode, parseRetriesArg, parseStreamMode, parseYoutubeMode, } from '../flags.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 { handleFileInput, handleUrlAsset } from './flows/asset/input.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 { resolveConfigState } from './run-config.js';
-import { resolveEnvState } from './run-env.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 { ansi, isRichTty, supportsColor } from './terminal.js';
+import { isRichTty, supportsColor } from './terminal.js';
+import { handleTranscriberCliRequest } from './transcriber-cli.js';
 export async function runCli(argv, { env, fetch, execFile: execFileOverride, stdout, stderr }) {
     ;
     globalThis.AI_SDK_LOG_WARNINGS = false;
@@ -49,6 +57,23 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
     })) {
         return;
     }
+    if (await handleSlidesCliRequest({
+        normalizedArgv,
+        envForRun,
+        fetchImpl: fetch,
+        stdout,
+        stderr,
+    })) {
+        return;
+    }
+    if (await handleTranscriberCliRequest({
+        normalizedArgv,
+        envForRun,
+        stdout,
+        stderr,
+    })) {
+        return;
+    }
     const execFileImpl = execFileOverride ?? execFile;
     const program = buildProgram();
     program.configureOutput({
@@ -162,33 +187,45 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
     const inputTarget = inputResolution.inputTarget;
     const url = inputResolution.url;
     const runStartedAtMs = Date.now();
-    const youtubeMode = parseYoutubeMode(program.opts().youtube);
     const videoModeExplicitlySet = normalizedArgv.some((arg) => arg === '--video-mode' || arg.startsWith('--video-mode='));
     const lengthExplicitlySet = normalizedArgv.some((arg) => arg === '--length' || arg.startsWith('--length='));
-    const lengthArg = parseLengthArg(program.opts().length);
-    const maxOutputTokensArg = parseMaxOutputTokensArg(program.opts().maxOutputTokens);
-    const timeoutMs = parseDurationMs(program.opts().timeout);
     const languageExplicitlySet = normalizedArgv.some((arg) => arg === '--language' ||
         arg.startsWith('--language=') ||
         arg === '--lang' ||
         arg.startsWith('--lang='));
-    const retries = parseRetriesArg(program.opts().retries);
     const noCacheFlag = program.opts().cache === false;
+    const noMediaCacheFlag = program.opts().mediaCache === false;
     const extractMode = Boolean(program.opts().extract) || Boolean(program.opts().extractOnly);
     const json = Boolean(program.opts().json);
+    const forceSummary = Boolean(program.opts().forceSummary);
+    const slidesDebug = Boolean(program.opts().slidesDebug);
     const streamMode = parseStreamMode(program.opts().stream);
     const plain = Boolean(program.opts().plain);
     const debug = Boolean(program.opts().debug);
     const verbose = Boolean(program.opts().verbose) || debug;
-    if (extractMode && lengthExplicitlySet && !json && isRichTty(stderr)) {
-        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 preprocessMode = parsePreprocessMode(program.opts().preprocess);
-    const shouldComputeReport = metricsEnabled;
+    const normalizeTranscriber = (value) => {
+        if (typeof value !== 'string')
+            return null;
+        const normalized = value.trim().toLowerCase();
+        if (normalized === 'auto' ||
+            normalized === 'whisper' ||
+            normalized === 'parakeet' ||
+            normalized === 'canary')
+            return normalized;
+        return null;
+    };
+    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';
+    envForRun.SUMMARIZE_TRANSCRIBER = transcriber;
+    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;
@@ -197,17 +234,36 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
         : 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,
+        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'
+            ? program.opts().maxOutputTokens
+            : program.opts().maxOutputTokens != null
+                ? String(program.opts().maxOutputTokens)
+                : undefined,
+    });
+    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');
+    }
+    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 markdownMode = format === 'markdown'
-        ? parseMarkdownMode(program.opts().markdownMode ??
-            program.opts().markdown ??
-            'readability')
-        : 'off';
-    const requestedFirecrawlMode = parseFirecrawlMode(program.opts().firecrawl);
     const modelArg = typeof program.opts().model === 'string' ? program.opts().model : null;
     const cliProviderArg = typeof cliProviderArgRaw === 'string' && cliProviderArgRaw.trim().length > 0
         ? parseCliProviderArg(cliProviderArgRaw)
@@ -220,7 +276,8 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
         : cliFlagPresent
             ? 'auto'
             : modelArg;
-    const { config, configPath, outputLanguage, openaiWhisperUsdPerMinute, videoMode, cliConfigForRun, configForCli, openaiUseChatCompletions, configModelLabel, } = resolveConfigState({
+    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({
+        env,
         envForRun,
         programOpts: program.opts(),
         languageExplicitlySet,
@@ -228,9 +285,48 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
         cliFlagPresent,
         cliProviderArg,
     });
+    const themeName = resolveThemeNameFromSources({
+        cli: program.opts().theme,
+        env: envForRun.SUMMARIZE_THEME,
+        config: config?.ui?.theme,
+    });
+    envForRun.SUMMARIZE_THEME = themeName;
     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 slidesConfig = config?.slides;
+    const slidesSettings = resolveSlideSettings({
+        slides: slidesExplicitlySet
+            ? program.opts().slides
+            : (slidesConfig?.enabled ?? program.opts().slides),
+        slidesOcr: slidesOcrExplicitlySet
+            ? program.opts().slidesOcr
+            : (slidesConfig?.ocr ?? program.opts().slidesOcr),
+        slidesDir: slidesDirExplicitlySet
+            ? program.opts().slidesDir
+            : (slidesConfig?.dir ?? program.opts().slidesDir),
+        slidesSceneThreshold: slidesSceneThresholdExplicitlySet
+            ? program.opts().slidesSceneThreshold
+            : (slidesConfig?.sceneThreshold ?? program.opts().slidesSceneThreshold),
+        slidesSceneThresholdExplicit: slidesSceneThresholdExplicitlySet || typeof slidesConfig?.sceneThreshold === 'number',
+        slidesMax: slidesMaxExplicitlySet
+            ? program.opts().slidesMax
+            : (slidesConfig?.max ?? program.opts().slidesMax),
+        slidesMinDuration: slidesMinDurationExplicitlySet
+            ? program.opts().slidesMinDuration
+            : (slidesConfig?.minDuration ?? program.opts().slidesMinDuration),
+        cwd: process.cwd(),
+    });
+    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'
         ? `Output is ${lengthArg.maxCharacters.toLocaleString()} characters.`
         : null;
@@ -241,11 +337,15 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
     const cacheState = await createCacheStateFromConfig({
         envForRun,
         config,
-        noCacheFlag,
+        noCacheFlag: false,
         transcriptNamespace,
     });
+    const mediaCache = await createMediaCacheFromConfig({
+        envForRun,
+        config,
+        noMediaCacheFlag,
+    });
     try {
-        const { apiKey, openrouterApiKey, openrouterConfigured, openaiTranscriptionKey, xaiApiKey, googleApiKey, anthropicApiKey, zaiApiKey, zaiBaseUrl, providerBaseUrls, firecrawlApiKey, firecrawlConfigured, googleConfigured, anthropicConfigured, apifyToken, ytDlpPath, falApiKey, cliAvailability, envForAuto, } = resolveEnvState({ env, envForRun, configForCli });
         if (markdownModeExplicitlySet && format !== 'markdown') {
             throw new Error('--markdown-mode is only supported with --format md');
         }
@@ -266,6 +366,13 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
             explicitModelArg,
         });
         const verboseColor = supportsColor(stderr, envForRun);
+        const themeForStderr = createThemeRenderer({
+            themeName,
+            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 { streamingEnabled } = resolveStreamSettings({
             streamMode,
             stdout,
@@ -279,7 +386,7 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
         // 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, setClearProgressBeforeStdout, clearProgressIfCurrent } = progressGate;
+        const { clearProgressForStdout, restoreProgressAfterStdout, setClearProgressBeforeStdout, clearProgressIfCurrent, } = progressGate;
         const fixedModelSpec = requestedModel.kind === 'fixed' ? requestedModel : null;
         const desiredOutputTokens = resolveDesiredOutputTokens({ lengthArg, maxOutputTokensArg });
         const summaryEngine = createSummaryEngine({
@@ -302,6 +409,7 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
             resolveMaxInputTokensForCall,
             llmCalls,
             clearProgressForStdout,
+            restoreProgressAfterStdout,
             apiKeys: {
                 xaiApiKey,
                 openaiApiKey: apiKey,
@@ -329,7 +437,8 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
             if (filtered.length === 0)
                 return;
             clearProgressForStdout();
-            stderr.write(`${ansi('2', `via ${filtered.join(', ')}`, verboseColor)}\n`);
+            stderr.write(`${themeForStderr.dim(`via ${filtered.join(', ')}`)}\n`);
+            restoreProgressAfterStdout?.();
         };
         const assetSummaryContext = {
             env,
@@ -340,7 +449,9 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
             timeoutMs,
             preprocessMode,
             format,
+            extractMode,
             lengthArg,
+            forceSummary,
             outputLanguage,
             videoMode,
             fixedModelSpec,
@@ -371,11 +482,14 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
             trackedFetch,
             writeViaFooter,
             clearProgressForStdout,
+            restoreProgressAfterStdout,
             getLiteLlmCatalog,
             buildReport,
             estimateCostUsd,
             llmCalls,
             cache: cacheState,
+            summaryCacheBypass: noCacheFlag,
+            mediaCache,
             apiStatus: {
                 xaiApiKey,
                 apiKey,
@@ -390,20 +504,86 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
             },
         };
         const summarizeAsset = (args) => summarizeAssetFlow(assetSummaryContext, args);
+        const summarizeMediaFile = (args) => summarizeMediaFileImpl(assetSummaryContext, args);
         const assetInputContext = {
             env,
+            envForRun,
             stderr,
             progressEnabled,
             timeoutMs,
             trackedFetch,
             summarizeAsset,
+            summarizeMediaFile,
             setClearProgressBeforeStdout,
             clearProgressIfCurrent,
         };
         if (await handleFileInput(assetInputContext, inputTarget)) {
             return;
         }
-        if (url && (await handleUrlAsset(assetInputContext, url, isYoutubeUrl))) {
+        if (url &&
+            (await withUrlAsset(assetInputContext, url, isYoutubeUrl, async ({ loaded, spinner }) => {
+                if (extractMode) {
+                    if (progressEnabled)
+                        spinner.setText(renderSpinnerStatus('Extracting text'));
+                    const extracted = await extractAssetContent({
+                        ctx: {
+                            env,
+                            envForRun,
+                            execFileImpl,
+                            timeoutMs,
+                            preprocessMode,
+                        },
+                        attachment: loaded.attachment,
+                    });
+                    await outputExtractedAsset({
+                        io: { env, envForRun, stdout, stderr },
+                        flags: {
+                            timeoutMs,
+                            preprocessMode,
+                            format,
+                            plain,
+                            json,
+                            metricsEnabled,
+                            metricsDetailed,
+                            shouldComputeReport,
+                            runStartedAtMs,
+                            verboseColor,
+                        },
+                        hooks: {
+                            clearProgressForStdout,
+                            restoreProgressAfterStdout,
+                            buildReport,
+                            estimateCostUsd,
+                        },
+                        url,
+                        sourceLabel: loaded.sourceLabel,
+                        attachment: loaded.attachment,
+                        extracted,
+                        apiStatus: {
+                            xaiApiKey,
+                            apiKey,
+                            openrouterApiKey,
+                            apifyToken,
+                            firecrawlConfigured,
+                            googleConfigured,
+                            anthropicConfigured,
+                        },
+                    });
+                    return;
+                }
+                if (progressEnabled)
+                    spinner.setText(renderSpinnerStatus('Summarizing'));
+                await summarizeAsset({
+                    sourceKind: 'asset-url',
+                    sourceLabel: loaded.sourceLabel,
+                    attachment: loaded.attachment,
+                    onModelChosen: (modelId) => {
+                        if (!progressEnabled)
+                            return;
+                        spinner.setText(renderSpinnerStatusWithModel('Summarizing', modelId));
+                    },
+                });
+            }))) {
             return;
         }
         if (!url) {
@@ -420,7 +600,7 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
             },
             flags: {
                 timeoutMs,
-                maxExtractCharacters: null,
+                maxExtractCharacters: extractMode ? maxExtractCharacters : null,
                 retries,
                 format,
                 markdownMode,
@@ -428,11 +608,14 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
                 youtubeMode,
                 firecrawlMode: requestedFirecrawlMode,
                 videoMode,
+                transcriptTimestamps,
                 outputLanguage,
                 lengthArg,
+                forceSummary,
                 promptOverride,
                 lengthInstruction,
                 languageInstruction,
+                summaryCacheBypass: noCacheFlag,
                 maxOutputTokensArg,
                 json,
                 extractMode,
@@ -443,10 +626,14 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
                 verbose,
                 verboseColor,
                 progressEnabled,
+                streamMode,
                 streamingEnabled,
                 plain,
                 configPath,
                 configModelLabel,
+                slides: slidesSettings,
+                slidesDebug,
+                slidesOutput: true,
             },
             model: {
                 requestedModel,
@@ -486,19 +673,25 @@ export async function runCli(argv, { env, fetch, execFile: execFileOverride, std
                 llmCalls,
             },
             cache: cacheState,
+            mediaCache,
             hooks: {
                 onModelChosen: null,
                 onExtracted: null,
+                onSlidesExtracted: null,
+                onSlidesProgress: null,
                 onLinkPreviewProgress: null,
                 onSummaryCached: null,
                 setTranscriptionCost,
                 summarizeAsset,
                 writeViaFooter,
                 clearProgressForStdout,
+                restoreProgressAfterStdout,
                 setClearProgressBeforeStdout,
                 clearProgressIfCurrent,
                 buildReport,
                 estimateCostUsd,
+                onSlideChunk: undefined,
+                onSlidesDone: null,
             },
         };
         await runUrlFlow({ ctx: urlFlowContext, url, isYoutubeUrl });