@steipete/summarize 0.9.0 → 0.10.0

package/dist/esm/run/slides-cli.js

@@ -0,0 +1,225 @@
+import { CommanderError } from 'commander';
+import { loadSummarizeConfig } from '../config.js';
+import { parseDurationMs } from '../flags.js';
+import { extractSlidesForSource, resolveSlideSettings, resolveSlideSourceFromUrl, } from '../slides/index.js';
+import { createOscProgressController } from '../tty/osc-progress.js';
+import { startSpinner } from '../tty/spinner.js';
+import { createThemeRenderer, resolveThemeNameFromSources, resolveTrueColor } from '../tty/theme.js';
+import { formatVersionLine } from '../version.js';
+import { applyHelpStyle, buildSlidesProgram } from './help.js';
+import { writeVerbose } from './logging.js';
+import { createMediaCacheFromConfig } from './media-cache-state.js';
+import { resolveEnvState } from './run-env.js';
+import { renderSlidesInline } from './slides-render.js';
+import { isRichTty, supportsColor } from './terminal.js';
+function formatTimestamp(seconds) {
+    const clamped = Math.max(0, Math.floor(seconds));
+    const hours = Math.floor(clamped / 3600);
+    const minutes = Math.floor((clamped % 3600) / 60);
+    const secs = clamped % 60;
+    const mm = String(minutes).padStart(2, '0');
+    const ss = String(secs).padStart(2, '0');
+    if (hours <= 0)
+        return `${minutes}:${ss}`;
+    const hh = String(hours).padStart(2, '0');
+    return `${hh}:${mm}:${ss}`;
+}
+function parseRenderMode(raw) {
+    const value = typeof raw === 'string' ? raw.trim().toLowerCase() : '';
+    if (!value || value === 'none')
+        return 'none';
+    if (value === 'auto' || value === 'kitty' || value === 'iterm')
+        return value;
+    throw new Error(`Unsupported --render: ${String(raw)}`);
+}
+export async function handleSlidesCliRequest({ normalizedArgv, envForRun, stdout, stderr, }) {
+    if (normalizedArgv[0]?.toLowerCase() !== 'slides')
+        return false;
+    const program = buildSlidesProgram();
+    program.configureOutput({
+        writeOut(str) {
+            stdout.write(str);
+        },
+        writeErr(str) {
+            stderr.write(str);
+        },
+    });
+    applyHelpStyle(program, envForRun, stdout);
+    program.exitOverride();
+    try {
+        program.parse(normalizedArgv.slice(1), { from: 'user' });
+    }
+    catch (error) {
+        if (error instanceof CommanderError && error.code === 'commander.helpDisplayed') {
+            return true;
+        }
+        throw error;
+    }
+    if (program.opts().version) {
+        stdout.write(`${formatVersionLine()}\n`);
+        return true;
+    }
+    const url = program.args[0];
+    if (!url) {
+        throw new Error('summarize slides requires a URL input.');
+    }
+    const opts = program.opts();
+    const renderMode = parseRenderMode(opts.render);
+    if (opts.json && renderMode !== 'none') {
+        throw new Error('--render is not supported with --json output.');
+    }
+    const slidesSettings = resolveSlideSettings({
+        slides: true,
+        slidesOcr: opts.slidesOcr ?? false,
+        slidesDir: opts.output ?? opts.slidesDir,
+        slidesSceneThreshold: opts.slidesSceneThreshold,
+        slidesSceneThresholdExplicit: normalizedArgv.some((arg) => arg === '--slides-scene-threshold' || arg.startsWith('--slides-scene-threshold=')),
+        slidesMax: opts.slidesMax,
+        slidesMinDuration: opts.slidesMinDuration,
+        cwd: process.cwd(),
+    });
+    if (!slidesSettings) {
+        throw new Error('Slides are disabled (enable --slides-ocr or check arguments).');
+    }
+    const timeoutRaw = typeof opts.timeout === 'string' && opts.timeout.trim() ? opts.timeout : '2m';
+    const timeoutMs = parseDurationMs(timeoutRaw);
+    const { config } = loadSummarizeConfig({ env: envForRun });
+    const mediaCache = await createMediaCacheFromConfig({
+        envForRun,
+        config,
+        noMediaCacheFlag: false,
+    });
+    const themeName = resolveThemeNameFromSources({
+        cli: opts.theme,
+        env: envForRun.SUMMARIZE_THEME,
+        config: config?.ui?.theme,
+    });
+    envForRun.SUMMARIZE_THEME = themeName;
+    const envState = resolveEnvState({ env: envForRun, envForRun, configForCli: config });
+    const source = resolveSlideSourceFromUrl(url);
+    if (!source) {
+        throw new Error('Slides are only supported for YouTube or direct video URLs.');
+    }
+    const verboseEnabled = Boolean(opts.verbose || opts.debug);
+    const progressEnabled = isRichTty(stderr) && !opts.json && !verboseEnabled;
+    const theme = createThemeRenderer({
+        themeName,
+        enabled: progressEnabled,
+        trueColor: resolveTrueColor(envForRun),
+    });
+    const renderStatus = (label, detail = '…') => `${theme.label(label)}${theme.dim(detail)}`;
+    const renderStatusFromText = (text) => {
+        const match = text.match(/^([^:]+):(.*)$/);
+        if (!match)
+            return renderStatus(text);
+        const [, prefix, rest] = match;
+        return `${theme.label(prefix.trim())}${theme.dim(`:${rest}`)}`;
+    };
+    const oscProgress = progressEnabled
+        ? createOscProgressController({
+            label: 'Slides',
+            env: envForRun,
+            isTty: progressEnabled,
+            write: (data) => stderr.write(data),
+        })
+        : null;
+    const spinner = startSpinner({
+        text: renderStatus('Extracting slides'),
+        enabled: progressEnabled,
+        stream: stderr,
+        color: theme.palette.spinner,
+    });
+    const handleSignal = () => {
+        try {
+            spinner.stopAndClear();
+        }
+        catch {
+            // ignore
+        }
+        oscProgress?.clear();
+    };
+    const handleSigint = () => {
+        handleSignal();
+        process.exit(130);
+    };
+    const handleSigterm = () => {
+        handleSignal();
+        process.exit(143);
+    };
+    if (progressEnabled) {
+        process.once('SIGINT', handleSigint);
+        process.once('SIGTERM', handleSigterm);
+    }
+    const verboseColor = supportsColor(stderr, envForRun);
+    const logSlides = (message) => {
+        writeVerbose(stderr, verboseEnabled, `slides ${message}`, verboseColor, envForRun);
+    };
+    const onSlidesProgress = (text) => {
+        if (progressEnabled) {
+            spinner.setText(renderStatusFromText(text));
+            const match = text.match(/(\d{1,3})%/);
+            const percent = match ? Number(match[1]) : null;
+            if (Number.isFinite(percent) && percent !== null) {
+                oscProgress?.setPercent('Slides', Math.max(0, Math.min(100, percent)));
+            }
+            else {
+                oscProgress?.setIndeterminate('Slides');
+            }
+            return;
+        }
+        if (verboseEnabled) {
+            stderr.write(`${text}\n`);
+        }
+    };
+    let slidesExtracted;
+    try {
+        slidesExtracted = await extractSlidesForSource({
+            source,
+            settings: slidesSettings,
+            noCache: opts.cache === false,
+            mediaCache,
+            env: envForRun,
+            timeoutMs,
+            ytDlpPath: envState.ytDlpPath,
+            ffmpegPath: null,
+            tesseractPath: null,
+            hooks: {
+                onSlidesProgress,
+                onSlidesLog: logSlides,
+            },
+        });
+    }
+    finally {
+        spinner.stopAndClear();
+        oscProgress?.clear();
+        if (progressEnabled) {
+            process.off('SIGINT', handleSigint);
+            process.off('SIGTERM', handleSigterm);
+        }
+    }
+    if (opts.json) {
+        stdout.write(`${JSON.stringify({ ok: true, slides: slidesExtracted }, null, 2)}\n`);
+        return true;
+    }
+    const count = slidesExtracted.slides.length;
+    stdout.write(`Slides extracted: ${count}\n`);
+    stdout.write(`Slides dir: ${slidesExtracted.slidesDir}\n`);
+    if (renderMode !== 'none') {
+        if (!isRichTty(stdout)) {
+            throw new Error('--render requires a TTY stdout.');
+        }
+        await renderSlidesInline({
+            slides: slidesExtracted.slides,
+            mode: renderMode,
+            env: envForRun,
+            stdout,
+            labelForSlide: (slide) => `Slide ${slide.index} · ${formatTimestamp(slide.timestamp)} (${slide.imagePath})`,
+        });
+        return true;
+    }
+    for (const slide of slidesExtracted.slides) {
+        stdout.write(`${slide.index}\t${formatTimestamp(slide.timestamp)}\t${slide.imagePath}\n`);
+    }
+    return true;
+}
+//# sourceMappingURL=slides-cli.js.map

package/dist/esm/run/slides-cli.js.map

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

package/dist/esm/run/slides-render.js

@@ -0,0 +1,163 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { isRichTty, terminalWidth } from './terminal.js';
+function parsePngSize(data) {
+    if (data.length < 24)
+        return null;
+    if (data[0] !== 0x89 ||
+        data[1] !== 0x50 ||
+        data[2] !== 0x4e ||
+        data[3] !== 0x47 ||
+        data[4] !== 0x0d ||
+        data[5] !== 0x0a ||
+        data[6] !== 0x1a ||
+        data[7] !== 0x0a) {
+        return null;
+    }
+    const width = data.readUInt32BE(16);
+    const height = data.readUInt32BE(20);
+    if (!Number.isFinite(width) || !Number.isFinite(height) || width <= 0 || height <= 0)
+        return null;
+    return { width, height };
+}
+function resolveInlineProtocol({ mode, env, stdout, }) {
+    if (mode === 'none')
+        return 'none';
+    if (!isRichTty(stdout))
+        return 'none';
+    if (mode === 'kitty' || mode === 'iterm')
+        return mode;
+    const termProgram = (env.TERM_PROGRAM ?? '').toLowerCase();
+    const term = (env.TERM ?? '').toLowerCase();
+    if (env.KITTY_WINDOW_ID ||
+        term.includes('xterm-kitty') ||
+        termProgram.includes('ghostty') ||
+        termProgram.includes('konsole') ||
+        env.KONSOLE_VERSION) {
+        return 'kitty';
+    }
+    if (termProgram.includes('iterm') || env.ITERM_SESSION_ID) {
+        return 'iterm';
+    }
+    return 'none';
+}
+function clampInt(min, max, value) {
+    if (value < min)
+        return min;
+    if (value > max)
+        return max;
+    return value;
+}
+function resolveSlideCellSize({ width, height, termCols, }) {
+    const maxCols = clampInt(24, 64, Math.floor(termCols * 0.75));
+    const cols = clampInt(16, maxCols, 32);
+    if (!width || !height) {
+        return { cols, rows: 10 };
+    }
+    const aspect = height / width;
+    const rows = clampInt(4, 24, Math.round(cols * 0.5 * aspect));
+    return { cols, rows };
+}
+function writeKittyImage({ stdout, data, cols, rows, id, }) {
+    const encoded = data.toString('base64');
+    const chunkSize = 4096;
+    let offset = 0;
+    let first = true;
+    while (offset < encoded.length) {
+        const chunk = encoded.slice(offset, offset + chunkSize);
+        offset += chunkSize;
+        const more = offset < encoded.length ? 1 : 0;
+        if (first) {
+            const params = [
+                'a=T',
+                'f=100',
+                `i=${id}`,
+                `m=${more}`,
+                'q=2',
+                `c=${cols}`,
+                `r=${rows}`,
+                'C=1',
+            ].join(',');
+            stdout.write(`\u001b_G${params};${chunk}\u001b\\`);
+            first = false;
+        }
+        else {
+            stdout.write(`\u001b_Gm=${more};${chunk}\u001b\\`);
+        }
+    }
+}
+function writeItermImage({ stdout, data, cols, rows, name, }) {
+    const encodedName = Buffer.from(name).toString('base64');
+    const encodedData = data.toString('base64');
+    const args = [
+        `name=${encodedName}`,
+        `size=${data.length}`,
+        'inline=1',
+        'preserveAspectRatio=1',
+        `width=${cols}`,
+        `height=${rows}`,
+    ].join(';');
+    stdout.write(`\u001b]1337;File=${args}:${encodedData}\u001b\\`);
+}
+export async function renderSlidesInline({ slides, mode, env, stdout, labelForSlide, }) {
+    const renderer = createSlidesInlineRenderer({ mode, env, stdout });
+    return renderer.renderSlides({ slides, labelForSlide });
+}
+export function createSlidesInlineRenderer({ mode, env, stdout, }) {
+    const protocol = resolveInlineProtocol({ mode, env, stdout });
+    let nextId = 1;
+    const renderSlide = async (slide, label) => {
+        if (protocol === 'none')
+            return false;
+        if (label)
+            stdout.write(`${label}\n`);
+        let data;
+        try {
+            data = await fs.readFile(slide.imagePath);
+        }
+        catch {
+            stdout.write('(missing slide image)\n');
+            return false;
+        }
+        if (data.length === 0) {
+            stdout.write('(empty slide image)\n');
+            return false;
+        }
+        const termCols = terminalWidth(stdout, env);
+        const size = parsePngSize(data);
+        const { cols, rows } = resolveSlideCellSize({
+            width: size?.width ?? null,
+            height: size?.height ?? null,
+            termCols,
+        });
+        if (protocol === 'kitty') {
+            writeKittyImage({ stdout, data, cols, rows, id: nextId });
+            nextId += 1;
+        }
+        else if (protocol === 'iterm') {
+            writeItermImage({
+                stdout,
+                data,
+                cols,
+                rows,
+                name: path.basename(slide.imagePath) || 'slide.png',
+            });
+        }
+        stdout.write('\n'.repeat(Math.max(1, rows)));
+        stdout.write('\n');
+        return true;
+    };
+    const renderSlides = async ({ slides, labelForSlide, }) => {
+        if (protocol === 'none')
+            return { rendered: 0, protocol };
+        let rendered = 0;
+        for (const slide of slides) {
+            const label = labelForSlide?.(slide) ?? null;
+            if (await renderSlide(slide, label))
+                rendered += 1;
+        }
+        return { rendered, protocol };
+    };
+    return { protocol, renderSlide, renderSlides };
+}
+//# sourceMappingURL=slides-render.js.map

package/dist/esm/run/slides-render.js.map

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

package/dist/esm/run/stream-output.js

@@ -1,4 +1,4 @@
-export function createStreamOutputGate({ stdout, clearProgressForStdout, outputMode, richTty, }) {
+export function createStreamOutputGate({ stdout, clearProgressForStdout, restoreProgressAfterStdout, outputMode, richTty, }) {
     let cleared = false;
     let plainFlushedLen = 0;
     const ensureCleared = () => {
@@ -12,6 +12,7 @@ export function createStreamOutputGate({ stdout, clearProgressForStdout, outputM
     const flush = (text) => {
         clearProgressForStdout();
         stdout.write(text);
+        restoreProgressAfterStdout?.();
     };
     const handleChunk = (streamed, prevStreamed) => {
         if (plainFlushedLen === 0) {
@@ -43,13 +44,19 @@ export function createStreamOutputGate({ stdout, clearProgressForStdout, outputM
     };
     const finalize = (finalText) => {
         const remaining = plainFlushedLen < finalText.length ? finalText.slice(plainFlushedLen) : '';
-        if (remaining)
+        if (remaining) {
+            clearProgressForStdout();
             stdout.write(remaining);
+            restoreProgressAfterStdout?.();
+        }
         const endedWithNewline = remaining
             ? remaining.endsWith('\n')
             : plainFlushedLen > 0 && finalText[plainFlushedLen - 1] === '\n';
-        if (!endedWithNewline)
+        if (!endedWithNewline) {
+            clearProgressForStdout();
             stdout.write('\n');
+            restoreProgressAfterStdout?.();
+        }
     };
     return { handleChunk, finalize, getFlushedLen: () => plainFlushedLen };
 }

package/dist/esm/run/stream-output.js.map

@@ -1 +1 @@
-{"version":3,"file":"stream-output.js","sourceRoot":"","sources":["../../../src/run/stream-output.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,sBAAsB,CAAC,EACrC,MAAM,EACN,sBAAsB,EACtB,UAAU,EACV,OAAO,GAMR;IACC,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,IAAI,eAAe,GAAG,CAAC,CAAA;IAEvB,MAAM,aAAa,GAAG,GAAG,EAAE;QACzB,IAAI,OAAO;YAAE,OAAM;QACnB,sBAAsB,EAAE,CAAA;QACxB,IAAI,OAAO;YAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QAC/B,OAAO,GAAG,IAAI,CAAA;IAChB,CAAC,CAAA;IAED,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,EAAE;QAC7B,sBAAsB,EAAE,CAAA;QACxB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACpB,CAAC,CAAA;IAED,MAAM,WAAW,GAAG,CAAC,QAAgB,EAAE,YAAoB,EAAE,EAAE;QAC7D,IAAI,eAAe,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;YACpC,IAAI,KAAK;gBAAE,eAAe,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;QAC9C,CAAC;QAED,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAA;YACzC,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,GAAG,CAAC,GAAG,eAAe,EAAE,CAAC;gBAChD,aAAa,EAAE,CAAA;gBACf,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,eAAe,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAA;gBAClD,eAAe,GAAG,MAAM,GAAG,CAAC,CAAA;YAC9B,CAAC;YACD,OAAM;QACR,CAAC;QAED,MAAM,YAAY,GAAG,QAAQ,CAAC,UAAU,CAAC,YAAY,CAAC,CAAA;QACtD,IAAI,QAAQ,CAAC,MAAM,GAAG,eAAe,IAAI,YAAY,EAAE,CAAC;YACtD,aAAa,EAAE,CAAA;YACf,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAA;YACtC,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAA;YACjC,OAAM;QACR,CAAC;QACD,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,aAAa,EAAE,CAAA;YACf,KAAK,CAAC,QAAQ,CAAC,CAAA;YACf,eAAe,GAAG,QAAQ,CAAC,MAAM,CAAA;QACnC,CAAC;IACH,CAAC,CAAA;IAED,MAAM,QAAQ,GAAG,CAAC,SAAiB,EAAE,EAAE;QACrC,MAAM,SAAS,GAAG,eAAe,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QAC5F,IAAI,SAAS;YAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QACtC,MAAM,gBAAgB,GAAG,SAAS;YAChC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC1B,CAAC,CAAC,eAAe,GAAG,CAAC,IAAI,SAAS,CAAC,eAAe,GAAG,CAAC,CAAC,KAAK,IAAI,CAAA;QAClE,IAAI,CAAC,gBAAgB;YAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC3C,CAAC,CAAA;IAED,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC,eAAe,EAAE,CAAA;AACxE,CAAC"}
+{"version":3,"file":"stream-output.js","sourceRoot":"","sources":["../../../src/run/stream-output.ts"],"names":[],"mappings":"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"}

package/dist/esm/run/summary-engine.js

@@ -60,7 +60,7 @@ export function createSummaryEngine(deps) {
         }
         return `Missing ${attempt.requiredEnv} for model ${attempt.userModelId}. Set the env var or choose a different --model.`;
     };
-    const runSummaryAttempt = async ({ attempt, prompt, allowStreaming, onModelChosen, cli, }) => {
+    const runSummaryAttempt = async ({ attempt, prompt, allowStreaming, onModelChosen, cli, streamHandler, }) => {
         onModelChosen?.(attempt.userModelId);
         if (attempt.transport === 'cli') {
             const hasAttachments = (prompt.attachments?.length ?? 0) > 0;
@@ -123,7 +123,7 @@ export function createSummaryEngine(deps) {
             timeoutMs: deps.timeoutMs,
         });
         if (modelResolution.note && deps.verbose) {
-            writeVerbose(deps.stderr, deps.verbose, modelResolution.note, deps.verboseColor);
+            writeVerbose(deps.stderr, deps.verbose, modelResolution.note, deps.verboseColor, deps.envForRun);
         }
         const parsedModelEffective = parseGatewayStyleModelId(modelResolution.modelId);
         const streamingEnabledForCall = allowStreaming &&
@@ -167,6 +167,7 @@ export function createSummaryEngine(deps) {
                     verbose: deps.verbose,
                     color: deps.verboseColor,
                     modelId: parsedModelEffective.canonical,
+                    env: deps.envForRun,
                 }),
             });
             deps.llmCalls.push({
@@ -192,8 +193,9 @@ export function createSummaryEngine(deps) {
             };
         }
         const shouldRenderMarkdownToAnsi = !deps.plain && isRichTty(deps.stdout);
-        const shouldStreamSummaryToStdout = streamingEnabledForCall && !shouldRenderMarkdownToAnsi;
-        const shouldStreamRenderedMarkdownToStdout = streamingEnabledForCall && shouldRenderMarkdownToAnsi;
+        const hasStreamHandler = Boolean(streamHandler);
+        const shouldStreamSummaryToStdout = streamingEnabledForCall && !shouldRenderMarkdownToAnsi && !hasStreamHandler;
+        const shouldStreamRenderedMarkdownToStdout = streamingEnabledForCall && shouldRenderMarkdownToAnsi && !hasStreamHandler;
         let summaryAlreadyPrinted = false;
         let summary = '';
         let getLastStreamError = null;
@@ -217,7 +219,7 @@ export function createSummaryEngine(deps) {
         }
         catch (error) {
             if (isStreamingTimeoutError(error)) {
-                writeVerbose(deps.stderr, deps.verbose, `Streaming timed out for ${parsedModelEffective.canonical}; falling back to non-streaming.`, deps.verboseColor);
+                writeVerbose(deps.stderr, deps.verbose, `Streaming timed out for ${parsedModelEffective.canonical}; falling back to non-streaming.`, deps.verboseColor, deps.envForRun);
                 const result = await summarizeWithModelId({
                     modelId: parsedModelEffective.canonical,
                     prompt,
@@ -237,6 +239,7 @@ export function createSummaryEngine(deps) {
                         verbose: deps.verbose,
                         color: deps.verboseColor,
                         modelId: parsedModelEffective.canonical,
+                        env: deps.envForRun,
                     }),
                 });
                 deps.llmCalls.push({
@@ -250,7 +253,7 @@ export function createSummaryEngine(deps) {
             }
             else if (parsedModelEffective.provider === 'google' &&
                 isGoogleStreamingUnsupportedError(error)) {
-                writeVerbose(deps.stderr, deps.verbose, `Google model ${parsedModelEffective.canonical} rejected streamGenerateContent; falling back to non-streaming.`, deps.verboseColor);
+                writeVerbose(deps.stderr, deps.verbose, `Google model ${parsedModelEffective.canonical} rejected streamGenerateContent; falling back to non-streaming.`, deps.verboseColor, deps.envForRun);
                 const result = await summarizeWithModelId({
                     modelId: parsedModelEffective.canonical,
                     prompt,
@@ -269,6 +272,7 @@ export function createSummaryEngine(deps) {
                         verbose: deps.verbose,
                         color: deps.verboseColor,
                         modelId: parsedModelEffective.canonical,
+                        env: deps.envForRun,
                     }),
                 });
                 deps.llmCalls.push({
@@ -286,6 +290,7 @@ export function createSummaryEngine(deps) {
         }
         if (streamResult) {
             deps.clearProgressForStdout();
+            deps.restoreProgressAfterStdout?.();
             getLastStreamError = streamResult.lastError;
             let streamed = '';
             let streamedRaw = '';
@@ -306,6 +311,7 @@ export function createSummaryEngine(deps) {
                 ? createStreamOutputGate({
                     stdout: deps.stdout,
                     clearProgressForStdout: deps.clearProgressForStdout,
+                    restoreProgressAfterStdout: deps.restoreProgressAfterStdout ?? null,
                     outputMode: deps.streamingOutputMode ?? 'line',
                     richTty: isRichTty(deps.stdout),
                 })
@@ -315,6 +321,14 @@ export function createSummaryEngine(deps) {
                     const prevStreamed = streamed;
                     const merged = mergeStreamingChunk(streamed, delta);
                     streamed = merged.next;
+                    if (streamHandler) {
+                        await streamHandler.onChunk({
+                            streamed: merged.next,
+                            prevStreamed,
+                            appended: merged.appended,
+                        });
+                        continue;
+                    }
                     if (shouldStreamSummaryToStdout && outputGate) {
                         outputGate.handleChunk(streamed, prevStreamed);
                         continue;
@@ -330,6 +344,7 @@ export function createSummaryEngine(deps) {
                             else {
                                 deps.stdout.write(out);
                             }
+                            deps.restoreProgressAfterStdout?.();
                         }
                     }
                 }
@@ -338,7 +353,11 @@ export function createSummaryEngine(deps) {
                 streamed = trimmed;
             }
             finally {
-                if (shouldStreamRenderedMarkdownToStdout) {
+                if (streamHandler) {
+                    await streamHandler.onDone?.(streamedRaw || streamed);
+                    summaryAlreadyPrinted = true;
+                }
+                else if (shouldStreamRenderedMarkdownToStdout) {
                     const out = streamer?.finish();
                     if (out) {
                         deps.clearProgressForStdout();
@@ -349,6 +368,7 @@ export function createSummaryEngine(deps) {
                         else {
                             deps.stdout.write(out);
                         }
+                        deps.restoreProgressAfterStdout?.();
                     }
                     summaryAlreadyPrinted = true;
                 }
@@ -375,6 +395,12 @@ export function createSummaryEngine(deps) {
             }
             throw new Error('LLM returned an empty summary');
         }
+        if (!streamResult && streamHandler) {
+            const cleaned = summary.trim();
+            await streamHandler.onChunk({ streamed: cleaned, prevStreamed: '', appended: cleaned });
+            await streamHandler.onDone?.(cleaned);
+            summaryAlreadyPrinted = true;
+        }
         return {
             summary,
             summaryAlreadyPrinted,