@steipete/summarize 0.9.0 → 0.11.0

package/dist/types/model-auto.d.ts

@@ -1,5 +1,5 @@
-import type { AutoRuleKind, CliProvider, SummarizeConfig } from './config.js';
-import type { LiteLlmCatalog } from './pricing/litellm.js';
+import type { AutoRuleKind, CliProvider, SummarizeConfig } from "./config.js";
+import type { LiteLlmCatalog } from "./pricing/litellm.js";
 export type AutoSelectionInput = {
     kind: AutoRuleKind;
     promptTokens: number | null;
@@ -11,14 +11,24 @@ export type AutoSelectionInput = {
     openrouterProvidersFromEnv: string[] | null;
     openrouterModelIds?: string[] | null;
     cliAvailability?: Partial<Record<CliProvider, boolean>>;
+    isImplicitAutoSelection?: boolean;
+    allowAutoCliFallback?: boolean;
+    lastSuccessfulCliProvider?: CliProvider | null;
 };
 export type AutoModelAttempt = {
-    transport: 'native' | 'openrouter' | 'cli';
+    transport: "native" | "openrouter" | "cli";
     userModelId: string;
     llmModelId: string | null;
     openrouterProviders: string[] | null;
     forceOpenRouter: boolean;
-    requiredEnv: 'XAI_API_KEY' | 'OPENAI_API_KEY' | 'GEMINI_API_KEY' | 'ANTHROPIC_API_KEY' | 'OPENROUTER_API_KEY' | 'Z_AI_API_KEY' | 'CLI_CLAUDE' | 'CLI_CODEX' | 'CLI_GEMINI';
+    requiredEnv: "XAI_API_KEY" | "OPENAI_API_KEY" | "GEMINI_API_KEY" | "ANTHROPIC_API_KEY" | "OPENROUTER_API_KEY" | "Z_AI_API_KEY" | "CLI_CLAUDE" | "CLI_CODEX" | "CLI_GEMINI" | "CLI_AGENT";
     debug: string;
 };
+export type ResolvedCliAutoFallbackConfig = {
+    enabled: boolean;
+    onlyWhenNoApiKeys: boolean;
+    order: CliProvider[];
+};
+export declare function resolveCliAutoFallbackConfig(config: SummarizeConfig | null): ResolvedCliAutoFallbackConfig;
+export declare function envHasKey(env: Record<string, string | undefined>, requiredEnv: AutoModelAttempt["requiredEnv"]): boolean;
 export declare function buildAutoModelAttempts(input: AutoSelectionInput): AutoModelAttempt[];

package/dist/types/model-spec.d.ts

@@ -1,35 +1,35 @@
-import type { CliProvider } from './config.js';
+import type { CliProvider } from "./config.js";
 export type FixedModelSpec = {
-    transport: 'native';
+    transport: "native";
     userModelId: string;
     llmModelId: string;
-    provider: 'xai' | 'openai' | 'google' | 'anthropic' | 'zai';
+    provider: "xai" | "openai" | "google" | "anthropic" | "zai";
     openrouterProviders: string[] | null;
     forceOpenRouter: false;
-    requiredEnv: 'XAI_API_KEY' | 'OPENAI_API_KEY' | 'GEMINI_API_KEY' | 'ANTHROPIC_API_KEY' | 'Z_AI_API_KEY';
+    requiredEnv: "XAI_API_KEY" | "OPENAI_API_KEY" | "GEMINI_API_KEY" | "ANTHROPIC_API_KEY" | "Z_AI_API_KEY";
     openaiBaseUrlOverride?: string | null;
     forceChatCompletions?: boolean;
 } | {
-    transport: 'openrouter';
+    transport: "openrouter";
     userModelId: string;
     openrouterModelId: string;
     llmModelId: string;
     openrouterProviders: string[] | null;
     forceOpenRouter: true;
-    requiredEnv: 'OPENROUTER_API_KEY';
+    requiredEnv: "OPENROUTER_API_KEY";
 } | {
-    transport: 'cli';
+    transport: "cli";
     userModelId: string;
     llmModelId: null;
     openrouterProviders: null;
     forceOpenRouter: false;
-    requiredEnv: 'CLI_CLAUDE' | 'CLI_CODEX' | 'CLI_GEMINI';
+    requiredEnv: "CLI_CLAUDE" | "CLI_CODEX" | "CLI_GEMINI" | "CLI_AGENT";
     cliProvider: CliProvider;
     cliModel: string | null;
 };
 export type RequestedModel = {
-    kind: 'auto';
+    kind: "auto";
 } | ({
-    kind: 'fixed';
+    kind: "fixed";
 } & FixedModelSpec);
 export declare function parseRequestedModelId(raw: string): RequestedModel;

package/dist/types/pricing/litellm.d.ts

@@ -1,4 +1,4 @@
-import { type LiteLlmCatalog, type LiteLlmLoadResult } from 'tokentally/node';
+import { type LiteLlmCatalog, type LiteLlmLoadResult } from "tokentally/node";
 export type { LiteLlmCatalog, LiteLlmLoadResult };
 export declare function loadLiteLlmCatalog({ env, fetchImpl, nowMs, }: {
     env: Record<string, string | undefined>;

package/dist/types/processes.d.ts

@@ -0,0 +1 @@
+export * from "@steipete/summarize-core/processes";

package/dist/types/prompts/index.d.ts

@@ -1 +1 @@
-export * from '@steipete/summarize-core/prompts';
+export * from "@steipete/summarize-core/prompts";

package/dist/types/run/attachments.d.ts

@@ -1,5 +1,5 @@
-import type { loadLocalAsset } from '../content/asset.js';
-export type AssetAttachment = Awaited<ReturnType<typeof loadLocalAsset>>['attachment'];
+import type { loadLocalAsset } from "../content/asset.js";
+export type AssetAttachment = Awaited<ReturnType<typeof loadLocalAsset>>["attachment"];
 export declare const MAX_DOCUMENT_BYTES_DEFAULT: number;
 export declare function isUnsupportedAttachmentError(error: unknown): boolean;
 export declare function isTextLikeMediaType(mediaType: string): boolean;
@@ -13,23 +13,23 @@ export declare function getTextContentFromAttachment(attachment: AssetAttachment
 } | null;
 export declare function getFileBytesFromAttachment(attachment: AssetAttachment): Uint8Array | null;
 export declare function ensureCliAttachmentPath({ sourceKind, sourceLabel, attachment, }: {
-    sourceKind: 'file' | 'asset-url';
+    sourceKind: "file" | "asset-url";
     sourceLabel: string;
     attachment: AssetAttachment;
 }): Promise<string>;
 export declare function shouldMarkitdownConvertMediaType(mediaType: string): boolean;
 export declare function supportsNativeFileAttachment({ provider, attachment, }: {
-    provider: 'xai' | 'openai' | 'google' | 'anthropic' | 'zai';
+    provider: "xai" | "openai" | "google" | "anthropic" | "zai";
     attachment: {
-        kind: 'image' | 'file';
+        kind: "image" | "file";
         mediaType: string;
     };
 }): boolean;
 export declare function assertProviderSupportsAttachment({ provider, modelId, attachment, }: {
-    provider: 'xai' | 'openai' | 'google' | 'anthropic' | 'zai';
+    provider: "xai" | "openai" | "google" | "anthropic" | "zai";
     modelId: string;
     attachment: {
-        kind: 'image' | 'file';
+        kind: "image" | "file";
         mediaType: string;
     };
 }): void;

package/dist/types/run/bird.d.ts

@@ -6,6 +6,13 @@ type BirdTweetPayload = {
         name?: string;
     };
     createdAt?: string;
+    media?: BirdTweetMedia | null;
+};
+type BirdTweetMedia = {
+    kind: "video" | "audio";
+    urls: string[];
+    preferredUrl: string | null;
+    source: "extended_entities" | "card" | "entities";
 };
 export declare function readTweetWithBird(args: {
     url: string;

package/dist/types/run/cache-state.d.ts

@@ -1,5 +1,5 @@
-import { type CacheState } from '../cache.js';
-import type { SummarizeConfig } from '../config.js';
+import type { SummarizeConfig } from "../config.js";
+import { type CacheState } from "../cache.js";
 export declare function createCacheStateFromConfig({ envForRun, config, noCacheFlag, transcriptNamespace, }: {
     envForRun: Record<string, string | undefined>;
     config: SummarizeConfig | null;

package/dist/types/run/cli-fallback-state.d.ts

@@ -0,0 +1,6 @@
+import type { CliProvider } from "../config.js";
+export declare function readLastSuccessfulCliProvider(env: Record<string, string | undefined>): Promise<CliProvider | null>;
+export declare function writeLastSuccessfulCliProvider({ env, provider, }: {
+    env: Record<string, string | undefined>;
+    provider: CliProvider;
+}): Promise<void>;

package/dist/types/run/constants.d.ts

@@ -1,4 +1,4 @@
-import type { ModelConfig } from '../config.js';
+import type { ModelConfig } from "../config.js";
 export declare const BIRD_TIP = "Tip: Install bird\uD83D\uDC26 for better Twitter support: https://github.com/steipete/bird";
 export declare const UVX_TIP = "Tip: Install uv (uvx) for local Markdown conversion: brew install uv (or set UVX_PATH to your uvx binary).";
 export declare const SUPPORT_URL = "https://github.com/steipete/summarize";

package/dist/types/run/cookies/twitter.d.ts

@@ -1,4 +1,4 @@
-export type BrowserName = 'chrome' | 'safari' | 'firefox';
+export type BrowserName = "chrome" | "safari" | "firefox";
 export type TwitterCookies = {
     cookiesFromBrowser: string | null;
     source: string | null;

package/dist/types/run/env.d.ts

@@ -1,4 +1,4 @@
-import type { CliProvider, SummarizeConfig } from '../config.js';
+import type { CliProvider, SummarizeConfig } from "../config.js";
 type ConfigForCli = SummarizeConfig | null;
 export declare function resolveExecutableInPath(binary: string, env: Record<string, string | undefined>): string | null;
 export declare function hasBirdCli(env: Record<string, string | undefined>): boolean;

package/dist/types/run/finish-line.d.ts

@@ -7,13 +7,13 @@ export type FinishLineModel = {
     detailParts: string[];
 };
 export type ExtractDiagnosticsForFinishLine = {
-    strategy: 'bird' | 'firecrawl' | 'html' | 'nitter';
+    strategy: "bird" | "firecrawl" | "html" | "nitter";
     firecrawl: {
         used: boolean;
     };
     markdown: {
         used: boolean;
-        provider: 'firecrawl' | 'llm' | null;
+        provider: "firecrawl" | "llm" | null;
         notes?: string | null;
     };
     transcript: {
@@ -33,7 +33,7 @@ export type ExtractedForLengths = {
     transcriptionProvider: string | null;
     mediaDurationSeconds: number | null;
     video: {
-        kind: 'youtube' | 'direct';
+        kind: "youtube" | "direct";
         url: string;
     } | null;
     isVideoOnly: boolean;
@@ -45,7 +45,7 @@ export type ExtractedForLengths = {
 };
 export declare function formatModelLabelForDisplay(model: string): string;
 export declare function buildLengthPartsForFinishLine(extracted: ExtractedForLengths, detailed: boolean): string[] | null;
-export declare function writeFinishLine({ stderr, elapsedMs, elapsedLabel, label, model, report, costUsd, detailed, extraParts, color, }: {
+export declare function writeFinishLine({ stderr, elapsedMs, elapsedLabel, label, model, report, costUsd, detailed, extraParts, color, env, }: {
     stderr: NodeJS.WritableStream;
     elapsedMs: number;
     elapsedLabel?: string | null;
@@ -71,6 +71,7 @@ export declare function writeFinishLine({ stderr, elapsedMs, elapsedLabel, label
     detailed: boolean;
     extraParts?: string[] | null;
     color: boolean;
+    env?: Record<string, string | undefined>;
 }): void;
 export declare function buildFinishLineText({ elapsedMs, elapsedLabel, label, model, report, costUsd, detailed, extraParts, }: {
     elapsedMs: number;
@@ -154,8 +155,8 @@ export declare function buildExtractFinishLabel(args: {
     extracted: {
         diagnostics: ExtractDiagnosticsForFinishLine;
     };
-    format: 'text' | 'markdown';
-    markdownMode: 'off' | 'auto' | 'llm' | 'readability';
+    format: "text" | "markdown";
+    markdownMode: "off" | "auto" | "llm" | "readability";
     hasMarkdownLlmCall: boolean;
 }): string;
 export declare function buildSummaryFinishLabel(args: {

package/dist/types/run/flows/asset/extract.d.ts

@@ -0,0 +1,18 @@
+import type { ExecFileFn } from "../../../markitdown.js";
+import type { ExtractDiagnosticsForFinishLine } from "../../finish-line.js";
+import { type AssetAttachment } from "../../attachments.js";
+export type AssetExtractContext = {
+    env: Record<string, string | undefined>;
+    envForRun: Record<string, string | undefined>;
+    execFileImpl: ExecFileFn;
+    timeoutMs: number;
+    preprocessMode: "off" | "auto" | "always";
+};
+export type AssetExtractResult = {
+    content: string;
+    diagnostics: ExtractDiagnosticsForFinishLine;
+};
+export declare function extractAssetContent({ ctx, attachment, }: {
+    ctx: AssetExtractContext;
+    attachment: AssetAttachment;
+}): Promise<AssetExtractResult>;

package/dist/types/run/flows/asset/input.d.ts

@@ -1,14 +1,30 @@
-import { type InputTarget } from '../../../content/asset.js';
-import type { SummarizeAssetArgs } from './summary.js';
+import type { SummarizeAssetArgs } from "./summary.js";
+import { type InputTarget, loadRemoteAsset } from "../../../content/asset.js";
+import { startSpinner } from "../../../tty/spinner.js";
+/**
+ * Check if a file extension indicates transcribable media.
+ * Used to route large audio/video files directly to the media handler
+ * which has a higher size limit (2GB vs 50MB).
+ */
+export declare function isTranscribableExtension(filePath: string): boolean;
 export type AssetInputContext = {
     env: Record<string, string | undefined>;
+    envForRun: Record<string, string | undefined>;
     stderr: NodeJS.WritableStream;
     progressEnabled: boolean;
     timeoutMs: number;
     trackedFetch: typeof fetch;
     summarizeAsset: (args: SummarizeAssetArgs) => Promise<void>;
-    setClearProgressBeforeStdout: (fn: (() => void) | null) => void;
+    summarizeMediaFile?: (args: SummarizeAssetArgs) => Promise<void>;
+    setClearProgressBeforeStdout: (fn: (() => undefined | (() => void)) | null) => void;
     clearProgressIfCurrent: (fn: () => void) => void;
 };
+type UrlAssetHandler = (args: {
+    loaded: Awaited<ReturnType<typeof loadRemoteAsset>>;
+    spinner: ReturnType<typeof startSpinner>;
+    clearProgressLine: () => void;
+}) => Promise<void>;
 export declare function handleFileInput(ctx: AssetInputContext, inputTarget: InputTarget): Promise<boolean>;
+export declare function withUrlAsset(ctx: AssetInputContext, url: string, isYoutubeUrl: boolean, handler: UrlAssetHandler): Promise<boolean>;
 export declare function handleUrlAsset(ctx: AssetInputContext, url: string, isYoutubeUrl: boolean): Promise<boolean>;
+export {};

package/dist/types/run/flows/asset/media-policy.d.ts

@@ -0,0 +1,2 @@
+export declare const MAX_LOCAL_MEDIA_BYTES: number;
+export declare const MAX_LOCAL_MEDIA_LABEL = "2 GB";

package/dist/types/run/flows/asset/media.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Media file transcription handler for local audio/video files.
+ * Phase 2: Transcript provider integration
+ * Phase 2.2: Local file path handling for transcript caching
+ */
+import type { AssetSummaryContext, SummarizeAssetArgs } from "./summary.js";
+/**
+ * Handler for local audio/video files.
+ *
+ * Phase 2 Implementation:
+ * 1. Validates transcription provider availability
+ * 2. Creates LinkPreviewClient with necessary dependencies
+ * 3. Calls client.fetchLinkContent to trigger transcription
+ * 4. Converts transcript text to AssetAttachment
+ * 5. Calls summarizeAsset with the transcript
+ *
+ * Phase 2.2 Enhancement:
+ * - Captures file modification time for cache invalidation
+ * - Passes fileMtime to transcript cache for local file support
+ */
+export declare function summarizeMediaFile(ctx: AssetSummaryContext, args: SummarizeAssetArgs): Promise<void>;

package/dist/types/run/flows/asset/output.d.ts

@@ -0,0 +1,42 @@
+import type { RunMetricsReport } from "../../../costs.js";
+import type { AssetAttachment } from "../../attachments.js";
+import type { AssetExtractResult } from "./extract.js";
+export declare function outputExtractedAsset({ io, flags, hooks, url, sourceLabel, attachment, extracted, apiStatus, }: {
+    io: {
+        env: Record<string, string | undefined>;
+        envForRun: Record<string, string | undefined>;
+        stdout: NodeJS.WritableStream;
+        stderr: NodeJS.WritableStream;
+    };
+    flags: {
+        timeoutMs: number;
+        preprocessMode: "off" | "auto" | "always";
+        format: "text" | "markdown";
+        plain: boolean;
+        json: boolean;
+        metricsEnabled: boolean;
+        metricsDetailed: boolean;
+        shouldComputeReport: boolean;
+        runStartedAtMs: number;
+        verboseColor: boolean;
+    };
+    hooks: {
+        clearProgressForStdout: () => void;
+        restoreProgressAfterStdout?: (() => void) | null;
+        buildReport: () => Promise<RunMetricsReport>;
+        estimateCostUsd: () => Promise<number | null>;
+    };
+    url: string;
+    sourceLabel: string;
+    attachment: AssetAttachment;
+    extracted: AssetExtractResult;
+    apiStatus: {
+        xaiApiKey: string | null;
+        apiKey: string | null;
+        openrouterApiKey: string | null;
+        apifyToken: string | null;
+        firecrawlConfigured: boolean;
+        googleConfigured: boolean;
+        anthropicConfigured: boolean;
+    };
+}): Promise<void>;

package/dist/types/run/flows/asset/preprocess.d.ts

@@ -1,21 +1,21 @@
-import type { OutputLanguage } from '../../../language.js';
-import type { Attachment } from '../../../llm/attachments.js';
-import { convertToMarkdownWithMarkitdown } from '../../../markitdown.js';
-import type { FixedModelSpec } from '../../../model-spec.js';
-import type { SummaryLength } from '../../../shared/contracts.js';
-import { type AssetAttachment } from '../../attachments.js';
+import type { OutputLanguage } from "../../../language.js";
+import type { Attachment } from "../../../llm/attachments.js";
+import type { FixedModelSpec } from "../../../model-spec.js";
+import type { SummaryLength } from "../../../shared/contracts.js";
+import { convertToMarkdownWithMarkitdown } from "../../../markitdown.js";
+import { type AssetAttachment } from "../../attachments.js";
 export type AssetPreprocessContext = {
     env: Record<string, string | undefined>;
     envForRun: Record<string, string | undefined>;
-    execFileImpl: Parameters<typeof convertToMarkdownWithMarkitdown>[0]['execFileImpl'];
+    execFileImpl: Parameters<typeof convertToMarkdownWithMarkitdown>[0]["execFileImpl"];
     timeoutMs: number;
-    preprocessMode: 'off' | 'auto' | 'always';
-    format: 'text' | 'markdown';
+    preprocessMode: "off" | "auto" | "always";
+    format: "text" | "markdown";
     lengthArg: {
-        kind: 'preset';
+        kind: "preset";
         preset: SummaryLength;
     } | {
-        kind: 'chars';
+        kind: "chars";
         maxCharacters: number;
     };
     outputLanguage: OutputLanguage;
@@ -23,6 +23,9 @@ export type AssetPreprocessContext = {
     promptOverride?: string | null;
     lengthInstruction?: string | null;
     languageInstruction?: string | null;
+    openaiApiKey?: string | null;
+    openrouterApiKey?: string | null;
+    openaiBaseUrl?: string | null;
 };
 export type AssetPreprocessResult = {
     promptText: string;
@@ -34,24 +37,27 @@ export type AssetPreprocessResult = {
     } | null;
 };
 export type DocumentHandlingDecision = {
-    mode: 'inline';
+    mode: "inline";
 } | {
-    mode: 'attach';
+    mode: "attach";
 } | {
-    mode: 'preprocess';
+    mode: "preprocess";
 } | {
-    mode: 'error';
+    mode: "error";
     error: Error;
 };
-export declare function resolveDocumentHandling({ attachment, textContent, fileBytes, preprocessMode, fixedModelSpec, }: {
+export declare function resolveDocumentHandling({ attachment, textContent, fileBytes, preprocessMode, fixedModelSpec, openaiApiKey, openrouterApiKey, openaiBaseUrl, }: {
     attachment: AssetAttachment;
     textContent: {
         content: string;
         bytes: number;
     } | null;
     fileBytes: Uint8Array | null;
-    preprocessMode: 'off' | 'auto' | 'always';
+    preprocessMode: "off" | "auto" | "always";
     fixedModelSpec: FixedModelSpec | null;
+    openaiApiKey?: string | null;
+    openrouterApiKey?: string | null;
+    openaiBaseUrl?: string | null;
 }): DocumentHandlingDecision;
 export declare function prepareAssetPrompt({ ctx, attachment, }: {
     ctx: AssetPreprocessContext;

package/dist/types/run/flows/asset/summary.d.ts

@@ -1,12 +1,13 @@
-import { type CacheState } from '../../../cache.js';
-import type { CliProvider, SummarizeConfig } from '../../../config.js';
-import type { LlmCall, RunMetricsReport } from '../../../costs.js';
-import type { OutputLanguage } from '../../../language.js';
-import type { ExecFileFn } from '../../../markitdown.js';
-import type { FixedModelSpec, RequestedModel } from '../../../model-spec.js';
-import type { SummaryLength } from '../../../shared/contracts.js';
-import { type AssetAttachment } from '../../attachments.js';
-import type { createSummaryEngine } from '../../summary-engine.js';
+import type { CliProvider, SummarizeConfig } from "../../../config.js";
+import type { MediaCache } from "../../../content/index.js";
+import type { LlmCall, RunMetricsReport } from "../../../costs.js";
+import type { OutputLanguage } from "../../../language.js";
+import type { ExecFileFn } from "../../../markitdown.js";
+import type { FixedModelSpec, RequestedModel } from "../../../model-spec.js";
+import type { SummaryLength } from "../../../shared/contracts.js";
+import type { createSummaryEngine } from "../../summary-engine.js";
+import { type CacheState } from "../../../cache.js";
+import { type AssetAttachment } from "../../attachments.js";
 export type AssetSummaryContext = {
     env: Record<string, string | undefined>;
     envForRun: Record<string, string | undefined>;
@@ -14,22 +15,26 @@ export type AssetSummaryContext = {
     stderr: NodeJS.WritableStream;
     execFileImpl: ExecFileFn;
     timeoutMs: number;
-    preprocessMode: 'off' | 'auto' | 'always';
-    format: 'text' | 'markdown';
+    preprocessMode: "off" | "auto" | "always";
+    format: "text" | "markdown";
+    extractMode: boolean;
     lengthArg: {
-        kind: 'preset';
+        kind: "preset";
         preset: SummaryLength;
     } | {
-        kind: 'chars';
+        kind: "chars";
         maxCharacters: number;
     };
+    forceSummary: boolean;
     outputLanguage: OutputLanguage;
-    videoMode: 'auto' | 'transcript' | 'understand';
+    videoMode: "auto" | "transcript" | "understand";
     fixedModelSpec: FixedModelSpec | null;
     promptOverride?: string | null;
     lengthInstruction?: string | null;
     languageInstruction?: string | null;
     isFallbackModel: boolean;
+    isImplicitAutoSelection: boolean;
+    allowAutoCliFallback: boolean;
     desiredOutputTokens: number | null;
     envForAuto: Record<string, string | undefined>;
     configForModelSelection: SummarizeConfig | null;
@@ -53,11 +58,14 @@ export type AssetSummaryContext = {
     trackedFetch: typeof fetch;
     writeViaFooter: (parts: string[]) => void;
     clearProgressForStdout: () => void;
-    getLiteLlmCatalog: () => Promise<Awaited<ReturnType<typeof import('../../../pricing/litellm.js').loadLiteLlmCatalog>>['catalog']>;
+    restoreProgressAfterStdout?: (() => void) | null;
+    getLiteLlmCatalog: () => Promise<Awaited<ReturnType<typeof import("../../../pricing/litellm.js").loadLiteLlmCatalog>>["catalog"]>;
     buildReport: () => Promise<RunMetricsReport>;
     estimateCostUsd: () => Promise<number | null>;
     llmCalls: LlmCall[];
     cache: CacheState;
+    summaryCacheBypass: boolean;
+    mediaCache: MediaCache | null;
     apiStatus: {
         xaiApiKey: string | null;
         apiKey: string | null;
@@ -77,7 +85,7 @@ export type AssetSummaryContext = {
     };
 };
 export type SummarizeAssetArgs = {
-    sourceKind: 'file' | 'asset-url';
+    sourceKind: "file" | "asset-url";
     sourceLabel: string;
     attachment: AssetAttachment;
     onModelChosen?: ((modelId: string) => void) | null;

package/dist/types/run/flows/url/extract.d.ts

@@ -1,4 +1,4 @@
-import type { ExtractedLinkContent, FetchLinkContentOptions } from '../../../content/index.js';
+import type { ExtractedLinkContent, FetchLinkContentOptions } from "../../../content/index.js";
 export type UrlExtractionUi = {
     contentSizeLabel: string;
     viaSourceLabel: string;
@@ -14,9 +14,10 @@ export declare function fetchLinkContentWithBirdTip({ client, url, options, env,
     env: Record<string, string | undefined>;
 }): Promise<ExtractedLinkContent>;
 export declare function deriveExtractionUi(extracted: ExtractedLinkContent): UrlExtractionUi;
-export declare function logExtractionDiagnostics({ extracted, stderr, verbose, verboseColor, }: {
+export declare function logExtractionDiagnostics({ extracted, stderr, verbose, verboseColor, env, }: {
     extracted: ExtractedLinkContent;
     stderr: NodeJS.WritableStream;
     verbose: boolean;
     verboseColor: boolean;
+    env?: Record<string, string | undefined>;
 }): void;

package/dist/types/run/flows/url/flow.d.ts

@@ -1,4 +1,4 @@
-import type { UrlFlowContext } from './types.js';
+import type { UrlFlowContext } from "./types.js";
 export declare function runUrlFlow({ ctx, url, isYoutubeUrl, }: {
     ctx: UrlFlowContext;
     url: string;

package/dist/types/run/flows/url/markdown.d.ts

@@ -1,19 +1,19 @@
-import { type ConvertTranscriptToMarkdown } from '../../../llm/transcript-to-markdown.js';
-import type { ModelAttempt } from '../../types.js';
-import type { UrlFlowContext } from './types.js';
+import type { ModelAttempt } from "../../types.js";
+import type { UrlFlowContext } from "./types.js";
+import { type ConvertTranscriptToMarkdown } from "../../../llm/transcript-to-markdown.js";
 export type MarkdownModel = {
     llmModelId: string;
     forceOpenRouter: boolean;
     openaiApiKeyOverride?: string | null;
     openaiBaseUrlOverride?: string | null;
     forceChatCompletions?: boolean;
-    requiredEnv?: ModelAttempt['requiredEnv'];
+    requiredEnv?: ModelAttempt["requiredEnv"];
 };
 export type MarkdownConverters = {
     markdownRequested: boolean;
     transcriptMarkdownRequested: boolean;
-    effectiveMarkdownMode: 'off' | 'auto' | 'llm' | 'readability';
-    markdownProvider: 'none' | 'xai' | 'openai' | 'google' | 'anthropic' | 'zai';
+    effectiveMarkdownMode: "off" | "auto" | "llm" | "readability";
+    markdownProvider: "none" | "xai" | "openai" | "google" | "anthropic" | "zai";
     markdownModel: MarkdownModel | null;
     convertHtmlToMarkdown: ((args: {
         url: string;