@steipete/summarize 0.11.1 → 0.13.0

package/dist/types/llm/providers/google.d.ts

@@ -1,6 +1,11 @@
 import type { Context } from "@mariozechner/pi-ai";
 import type { Attachment } from "../attachments.js";
 import type { LlmTokenUsage } from "../types.js";
+type GoogleAssistantLike = {
+    stopReason?: string;
+    errorMessage?: string;
+};
+export declare function normalizeGoogleAssistantError(response: GoogleAssistantLike | null | undefined, modelId: string): Error | null;
 export declare function completeGoogleText({ modelId, apiKey, context, temperature, maxOutputTokens, signal, googleBaseUrlOverride, }: {
     modelId: string;
     apiKey: string;
@@ -27,3 +32,4 @@ export declare function completeGoogleDocument({ modelId, apiKey, promptText, do
     text: string;
     usage: LlmTokenUsage | null;
 }>;
+export {};

package/dist/types/llm/providers/models.d.ts

@@ -10,6 +10,11 @@ export declare function resolveZaiModel({ modelId, context, openaiBaseUrlOverrid
     context: Context;
     openaiBaseUrlOverride?: string | null;
 }): Model<Api>;
+export declare function resolveNvidiaModel({ modelId, context, openaiBaseUrlOverride, }: {
+    modelId: string;
+    context: Context;
+    openaiBaseUrlOverride?: string | null;
+}): Model<Api>;
 export declare function resolveXaiModel({ modelId, context, xaiBaseUrlOverride, }: {
     modelId: string;
     context: Context;

package/dist/types/llm/providers/openai.d.ts

@@ -11,18 +11,21 @@ export type OpenAiClientConfigInput = {
     openaiBaseUrlOverride?: string | null;
     forceChatCompletions?: boolean;
 };
+type OpenAiTextCompletionResult = {
+    text: string;
+    usage: LlmTokenUsage | null;
+    resolvedModelId?: string;
+};
 export declare function resolveOpenAiClientConfig({ apiKeys, forceOpenRouter, openaiBaseUrlOverride, forceChatCompletions, }: OpenAiClientConfigInput): OpenAiClientConfig;
-export declare function completeOpenAiText({ modelId, openaiConfig, context, temperature, maxOutputTokens, signal, }: {
+export declare function completeOpenAiText({ modelId, openaiConfig, context, temperature, maxOutputTokens, signal, fetchImpl, }: {
     modelId: string;
     openaiConfig: OpenAiClientConfig;
     context: Context;
     temperature?: number;
     maxOutputTokens?: number;
     signal: AbortSignal;
-}): Promise<{
-    text: string;
-    usage: LlmTokenUsage | null;
-}>;
+    fetchImpl?: typeof fetch;
+}): Promise<OpenAiTextCompletionResult>;
 export declare function completeOpenAiDocument({ modelId, openaiConfig, promptText, document, maxOutputTokens, temperature, timeoutMs, fetchImpl, }: {
     modelId: string;
     openaiConfig: OpenAiClientConfig;
@@ -36,3 +39,4 @@ export declare function completeOpenAiDocument({ modelId, openaiConfig, promptTe
     text: string;
     usage: LlmTokenUsage | null;
 }>;
+export {};

package/dist/types/llm/providers/types.d.ts

@@ -3,4 +3,5 @@ export type OpenAiClientConfig = {
     baseURL?: string;
     useChatCompletions: boolean;
     isOpenRouter: boolean;
+    extraHeaders?: Record<string, string>;
 };

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

@@ -1,5 +1,6 @@
 import type { OutputLanguage } from "../language.js";
 import type { LlmTokenUsage } from "./generate-text.js";
+import type { LlmProvider } from "./model-id.js";
 export type ConvertTranscriptToMarkdown = (args: {
     title: string | null;
     source: string | null;
@@ -30,7 +31,7 @@ export declare function createTranscriptToMarkdownConverter({ modelId, forceOpen
     }) => void;
     onUsage?: (usage: {
         model: string;
-        provider: "xai" | "openai" | "google" | "anthropic" | "zai";
+        provider: LlmProvider;
         usage: LlmTokenUsage | null;
     }) => void;
 }): ConvertTranscriptToMarkdown;

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

@@ -0,0 +1,15 @@
+import type { CliProvider, SummarizeConfig } from "./config.js";
+export type ResolvedCliAutoFallbackConfig = {
+    enabled: boolean;
+    onlyWhenNoApiKeys: boolean;
+    order: CliProvider[];
+};
+export declare function resolveCliAutoFallbackConfig(config: SummarizeConfig | null): ResolvedCliAutoFallbackConfig;
+export declare function prependCliCandidates({ candidates, config, env, isImplicitAutoSelection, allowAutoCliFallback, lastSuccessfulCliProvider, }: {
+    candidates: string[];
+    config: SummarizeConfig | null;
+    env: Record<string, string | undefined>;
+    isImplicitAutoSelection: boolean;
+    allowAutoCliFallback: boolean;
+    lastSuccessfulCliProvider: CliProvider | null;
+}): string[];

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

@@ -0,0 +1,7 @@
+import type { AutoRule, AutoRuleKind, SummarizeConfig } from "./config.js";
+export declare const DEFAULT_RULES: AutoRule[];
+export declare function resolveRuleCandidates({ kind, promptTokens, config, }: {
+    kind: AutoRuleKind;
+    promptTokens: number | null;
+    config: SummarizeConfig | null;
+}): string[];

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

@@ -1,5 +1,9 @@
 import type { AutoRuleKind, CliProvider, SummarizeConfig } from "./config.js";
+import { type RequiredModelEnv } from "./llm/provider-capabilities.js";
+import { resolveCliAutoFallbackConfig, type ResolvedCliAutoFallbackConfig } from "./model-auto-cli.js";
 import type { LiteLlmCatalog } from "./pricing/litellm.js";
+export { resolveCliAutoFallbackConfig };
+export type { ResolvedCliAutoFallbackConfig };
 export type AutoSelectionInput = {
     kind: AutoRuleKind;
     promptTokens: number | null;
@@ -21,14 +25,8 @@ export type AutoModelAttempt = {
     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" | "CLI_AGENT";
+    requiredEnv: RequiredModelEnv;
     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,12 +1,13 @@
 import type { CliProvider } from "./config.js";
+import type { LlmProvider } from "./llm/model-id.js";
 export type FixedModelSpec = {
     transport: "native";
     userModelId: string;
     llmModelId: string;
-    provider: "xai" | "openai" | "google" | "anthropic" | "zai";
+    provider: LlmProvider;
     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" | "NVIDIA_API_KEY" | "GITHUB_TOKEN";
     openaiBaseUrlOverride?: string | null;
     forceChatCompletions?: boolean;
 } | {
@@ -23,7 +24,7 @@ export type FixedModelSpec = {
     llmModelId: null;
     openrouterProviders: null;
     forceOpenRouter: false;
-    requiredEnv: "CLI_CLAUDE" | "CLI_CODEX" | "CLI_GEMINI" | "CLI_AGENT";
+    requiredEnv: "CLI_CLAUDE" | "CLI_CODEX" | "CLI_GEMINI" | "CLI_AGENT" | "CLI_OPENCLAW" | "CLI_OPENCODE";
     cliProvider: CliProvider;
     cliModel: string | null;
 };

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

@@ -1,4 +1,5 @@
 import type { loadLocalAsset } from "../content/asset.js";
+import type { LlmProvider } from "../llm/model-id.js";
 export type AssetAttachment = Awaited<ReturnType<typeof loadLocalAsset>>["attachment"];
 export declare const MAX_DOCUMENT_BYTES_DEFAULT: number;
 export declare function isUnsupportedAttachmentError(error: unknown): boolean;
@@ -19,14 +20,14 @@ export declare function ensureCliAttachmentPath({ sourceKind, sourceLabel, attac
 }): Promise<string>;
 export declare function shouldMarkitdownConvertMediaType(mediaType: string): boolean;
 export declare function supportsNativeFileAttachment({ provider, attachment, }: {
-    provider: "xai" | "openai" | "google" | "anthropic" | "zai";
+    provider: LlmProvider;
     attachment: {
         kind: "image" | "file";
         mediaType: string;
     };
 }): boolean;
 export declare function assertProviderSupportsAttachment({ provider, modelId, attachment, }: {
-    provider: "xai" | "openai" | "google" | "anthropic" | "zai";
+    provider: LlmProvider;
     modelId: string;
     attachment: {
         kind: "image" | "file";

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

@@ -0,0 +1 @@
+export declare function execTweetCli(binary: string, args: string[], timeoutMs: number, env: Record<string, string | undefined>): Promise<string>;

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

@@ -0,0 +1,3 @@
+import type { BirdTweetMedia } from "./types.js";
+export declare function extractMediaFromBirdRaw(raw: unknown): BirdTweetMedia | null;
+export declare function extractMediaFromXurlRaw(raw: unknown): BirdTweetMedia | null;

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

@@ -0,0 +1,3 @@
+import type { BirdTweetPayload } from "./types.js";
+export declare function parseXurlTweetPayload(raw: unknown): BirdTweetPayload;
+export declare function parseBirdTweetPayload(raw: unknown): BirdTweetPayload;

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

@@ -0,0 +1,18 @@
+export type TweetCliClient = "xurl" | "bird";
+export type BirdTweetMedia = {
+    kind: "video" | "audio";
+    urls: string[];
+    preferredUrl: string | null;
+    source: "extended_entities" | "card" | "entities" | "xurl";
+};
+export type BirdTweetPayload = {
+    id?: string;
+    text: string;
+    author?: {
+        username?: string;
+        name?: string;
+    };
+    createdAt?: string;
+    media?: BirdTweetMedia | null;
+    client?: TweetCliClient;
+};

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

@@ -1,23 +1,18 @@
-type BirdTweetPayload = {
-    id?: string;
-    text: string;
-    author?: {
-        username?: string;
-        name?: string;
-    };
-    createdAt?: string;
-    media?: BirdTweetMedia | null;
-};
-type BirdTweetMedia = {
-    kind: "video" | "audio";
-    urls: string[];
-    preferredUrl: string | null;
-    source: "extended_entities" | "card" | "entities";
-};
+import type { BirdTweetPayload } from "./bird/types.js";
+export type { TweetCliClient } from "./bird/types.js";
+export declare function readTweetWithXurl(args: {
+    url: string;
+    timeoutMs: number;
+    env: Record<string, string | undefined>;
+}): Promise<BirdTweetPayload>;
 export declare function readTweetWithBird(args: {
     url: string;
     timeoutMs: number;
     env: Record<string, string | undefined>;
 }): Promise<BirdTweetPayload>;
+export declare function readTweetWithPreferredClient(args: {
+    url: string;
+    timeoutMs: number;
+    env: Record<string, string | undefined>;
+}): Promise<BirdTweetPayload>;
 export declare function withBirdTip(error: unknown, url: string | null, env: Record<string, string | undefined>): Error;
-export {};

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

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

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

@@ -1,5 +1,6 @@
 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 TWITTER_CLI_TIP = "Tip: Install xurl (preferred) or bird for better X support: brew install --cask xdevplatform/tap/xurl";
+export declare const BIRD_TIP = "Tip: Install xurl (preferred) or bird for better X support: brew install --cask xdevplatform/tap/xurl";
 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";
 export declare const TWITTER_HOSTS: Set<string>;

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

@@ -1,7 +1,13 @@
 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 canSpawnCommand({ command, args, env, }: {
+    command: string;
+    args?: string[];
+    env: Record<string, string | undefined>;
+}): Promise<boolean>;
 export declare function hasBirdCli(env: Record<string, string | undefined>): boolean;
+export declare function hasXurlCli(env: Record<string, string | undefined>): boolean;
 export declare function hasUvxCli(env: Record<string, string | undefined>): boolean;
 export declare function resolveCliAvailability({ env, config, }: {
     env: Record<string, string | undefined>;

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

@@ -0,0 +1,29 @@
+export type ExtractDiagnosticsForFinishLine = {
+    strategy: "bird" | "xurl" | "firecrawl" | "html" | "nitter";
+    firecrawl: {
+        used: boolean;
+    };
+    markdown: {
+        used: boolean;
+        provider: "firecrawl" | "llm" | null;
+        notes?: string | null;
+    };
+    transcript: {
+        textProvided: boolean;
+        provider: string | null;
+    };
+};
+export declare function buildExtractFinishLabel(args: {
+    extracted: {
+        diagnostics: ExtractDiagnosticsForFinishLine;
+    };
+    format: "text" | "markdown";
+    markdownMode: "off" | "auto" | "llm" | "readability";
+    hasMarkdownLlmCall: boolean;
+}): string;
+export declare function buildSummaryFinishLabel(args: {
+    extracted: {
+        diagnostics: ExtractDiagnosticsForFinishLine;
+        wordCount: number;
+    };
+}): string | null;

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

@@ -0,0 +1,23 @@
+export type ExtractedForLengths = {
+    url: string;
+    siteName: string | null;
+    totalCharacters: number;
+    wordCount: number;
+    transcriptCharacters: number | null;
+    transcriptLines: number | null;
+    transcriptWordCount: number | null;
+    transcriptSource: string | null;
+    transcriptionProvider: string | null;
+    mediaDurationSeconds: number | null;
+    video: {
+        kind: "youtube" | "direct";
+        url: string;
+    } | null;
+    isVideoOnly: boolean;
+    diagnostics: {
+        transcript: {
+            cacheStatus: string;
+        };
+    };
+};
+export declare function buildLengthPartsForFinishLine(extracted: ExtractedForLengths, detailed: boolean): string[] | null;

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

@@ -1,3 +1,5 @@
+export { buildExtractFinishLabel, buildSummaryFinishLabel, type ExtractDiagnosticsForFinishLine, } from "./finish-line-labels.js";
+export { buildLengthPartsForFinishLine, type ExtractedForLengths } from "./finish-line-lengths.js";
 export type FinishLineText = {
     line: string;
     details: string | null;
@@ -6,45 +8,7 @@ export type FinishLineModel = {
     lineParts: string[];
     detailParts: string[];
 };
-export type ExtractDiagnosticsForFinishLine = {
-    strategy: "bird" | "firecrawl" | "html" | "nitter";
-    firecrawl: {
-        used: boolean;
-    };
-    markdown: {
-        used: boolean;
-        provider: "firecrawl" | "llm" | null;
-        notes?: string | null;
-    };
-    transcript: {
-        textProvided: boolean;
-        provider: string | null;
-    };
-};
-export type ExtractedForLengths = {
-    url: string;
-    siteName: string | null;
-    totalCharacters: number;
-    wordCount: number;
-    transcriptCharacters: number | null;
-    transcriptLines: number | null;
-    transcriptWordCount: number | null;
-    transcriptSource: string | null;
-    transcriptionProvider: string | null;
-    mediaDurationSeconds: number | null;
-    video: {
-        kind: "youtube" | "direct";
-        url: string;
-    } | null;
-    isVideoOnly: boolean;
-    diagnostics: {
-        transcript: {
-            cacheStatus: string;
-        };
-    };
-};
 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, env, }: {
     stderr: NodeJS.WritableStream;
     elapsedMs: number;
@@ -151,17 +115,3 @@ export declare function buildFinishLineModel({ elapsedMs, elapsedLabel, label, m
     costUsd: number | null;
     extraParts?: string[] | null;
 }): FinishLineModel;
-export declare function buildExtractFinishLabel(args: {
-    extracted: {
-        diagnostics: ExtractDiagnosticsForFinishLine;
-    };
-    format: "text" | "markdown";
-    markdownMode: "off" | "auto" | "llm" | "readability";
-    hasMarkdownLlmCall: boolean;
-}): string;
-export declare function buildSummaryFinishLabel(args: {
-    extracted: {
-        diagnostics: ExtractDiagnosticsForFinishLine;
-        wordCount: number;
-    };
-}): string | null;

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

@@ -1,6 +1,6 @@
 import type { ExecFileFn } from "../../../markitdown.js";
-import type { ExtractDiagnosticsForFinishLine } from "../../finish-line.js";
 import { type AssetAttachment } from "../../attachments.js";
+import type { ExtractDiagnosticsForFinishLine } from "../../finish-line.js";
 export type AssetExtractContext = {
     env: Record<string, string | undefined>;
     envForRun: Record<string, string | undefined>;

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

@@ -1,6 +1,6 @@
-import type { SummarizeAssetArgs } from "./summary.js";
 import { type InputTarget, loadRemoteAsset } from "../../../content/asset.js";
 import { startSpinner } from "../../../tty/spinner.js";
+import type { SummarizeAssetArgs } from "./summary.js";
 /**
  * Check if a file extension indicates transcribable media.
  * Used to route large audio/video files directly to the media handler

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

@@ -1,8 +1,8 @@
 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 { convertToMarkdownWithMarkitdown } from "../../../markitdown.js";
 import { type AssetAttachment } from "../../attachments.js";
 export type AssetPreprocessContext = {
     env: Record<string, string | undefined>;

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

@@ -0,0 +1,24 @@
+import type { CliProvider } from "../../../config.js";
+import type { ModelAttempt } from "../../types.js";
+import type { AssetSummaryContext, SummarizeAssetArgs } from "./summary.js";
+export declare function buildAssetModelAttempts({ ctx, kind, promptTokensForAuto, requiresVideoUnderstanding, lastSuccessfulCliProvider, }: {
+    ctx: AssetSummaryContext;
+    kind: "video" | "image" | "text" | "file";
+    promptTokensForAuto: number | null;
+    requiresVideoUnderstanding: boolean;
+    lastSuccessfulCliProvider: CliProvider | null;
+}): Promise<ModelAttempt[]>;
+export declare function buildAssetCliContext({ ctx, args, attempts, attachmentsCount, summaryLengthTarget, }: {
+    ctx: AssetSummaryContext;
+    args: SummarizeAssetArgs;
+    attempts: ModelAttempt[];
+    attachmentsCount: number;
+    summaryLengthTarget: import("../../../shared/contracts.js").SummaryLength | {
+        maxCharacters: number;
+    };
+}): Promise<{
+    promptOverride: string;
+    allowTools: boolean;
+    cwd: string;
+    extraArgsByProvider: Partial<Record<CliProvider, string[]>>;
+} | null>;

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

@@ -1,3 +1,4 @@
+import { type CacheState } from "../../../cache.js";
 import type { CliProvider, SummarizeConfig } from "../../../config.js";
 import type { MediaCache } from "../../../content/index.js";
 import type { LlmCall, RunMetricsReport } from "../../../costs.js";
@@ -5,9 +6,8 @@ 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";
+import type { createSummaryEngine } from "../../summary-engine.js";
 export type AssetSummaryContext = {
     env: Record<string, string | undefined>;
     envForRun: Record<string, string | undefined>;
@@ -69,6 +69,7 @@ export type AssetSummaryContext = {
     apiStatus: {
         xaiApiKey: string | null;
         apiKey: string | null;
+        nvidiaApiKey: string | null;
         openrouterApiKey: string | null;
         apifyToken: string | null;
         firecrawlConfigured: boolean;
@@ -76,14 +77,27 @@ export type AssetSummaryContext = {
         anthropicConfigured: boolean;
         providerBaseUrls: {
             openai: string | null;
+            nvidia: string | null;
             anthropic: string | null;
             google: string | null;
             xai: string | null;
         };
         zaiApiKey: string | null;
         zaiBaseUrl: string;
+        nvidiaBaseUrl: string;
+        assemblyaiApiKey: string | null;
     };
 };
+export type AssetSummaryContextInput = {
+    io: Pick<AssetSummaryContext, "env" | "envForRun" | "stdout" | "stderr" | "execFileImpl" | "trackedFetch">;
+    summary: Pick<AssetSummaryContext, "timeoutMs" | "preprocessMode" | "format" | "extractMode" | "lengthArg" | "forceSummary" | "outputLanguage" | "videoMode" | "promptOverride" | "lengthInstruction" | "languageInstruction" | "maxOutputTokensArg" | "summaryCacheBypass">;
+    model: Pick<AssetSummaryContext, "fixedModelSpec" | "isFallbackModel" | "isImplicitAutoSelection" | "allowAutoCliFallback" | "desiredOutputTokens" | "envForAuto" | "configForModelSelection" | "cliAvailability" | "requestedModel" | "requestedModelInput" | "requestedModelLabel" | "wantsFreeNamedModel" | "isNamedModelSelection" | "summaryEngine" | "getLiteLlmCatalog" | "llmCalls">;
+    output: Pick<AssetSummaryContext, "json" | "metricsEnabled" | "metricsDetailed" | "shouldComputeReport" | "runStartedAtMs" | "verbose" | "verboseColor" | "streamingEnabled" | "plain">;
+    hooks: Pick<AssetSummaryContext, "writeViaFooter" | "clearProgressForStdout" | "restoreProgressAfterStdout" | "buildReport" | "estimateCostUsd">;
+    cache: Pick<AssetSummaryContext, "cache" | "mediaCache">;
+    apiStatus: AssetSummaryContext["apiStatus"];
+};
+export declare function createAssetSummaryContext(input: AssetSummaryContextInput): AssetSummaryContext;
 export type SummarizeAssetArgs = {
     sourceKind: "file" | "asset-url";
     sourceLabel: string;

package/dist/types/run/flows/url/extraction-session.d.ts

@@ -0,0 +1,22 @@
+import { createLinkPreviewClient, type ExtractedLinkContent, type LinkPreviewProgressEvent } from "../../../content/index.js";
+import type { UrlFlowContext } from "./types.js";
+type LinkPreviewClientOptions = NonNullable<Parameters<typeof createLinkPreviewClient>[0]>;
+type ConvertHtmlToMarkdown = LinkPreviewClientOptions["convertHtmlToMarkdown"];
+type LinkPreviewProgressHandler = ((event: LinkPreviewProgressEvent) => void) | null;
+export type UrlExtractionSession = {
+    cacheStore: UrlFlowContext["cache"]["store"] | null;
+    fetchInitialExtract: (url: string) => Promise<ExtractedLinkContent>;
+    fetchWithCache: (targetUrl: string, options?: {
+        bypassExtractCache?: boolean;
+    }) => Promise<ExtractedLinkContent>;
+};
+export declare function createUrlExtractionSession({ ctx, markdown, onProgress, }: {
+    ctx: UrlFlowContext;
+    markdown: {
+        convertHtmlToMarkdown: ConvertHtmlToMarkdown;
+        effectiveMarkdownMode: "off" | "auto" | "llm" | "readability";
+        markdownRequested: boolean;
+    };
+    onProgress: LinkPreviewProgressHandler;
+}): UrlExtractionSession;
+export {};

package/dist/types/run/flows/url/fetch-options.d.ts

@@ -0,0 +1,29 @@
+import type { CacheMode, FetchLinkContentOptions } from "../../../content/index.js";
+type UrlFetchFlags = {
+    timeoutMs: number;
+    maxExtractCharacters?: number | null;
+    youtubeMode: "auto" | "web" | "apify" | "yt-dlp" | "no-auto";
+    videoMode: "auto" | "transcript" | "understand";
+    transcriptTimestamps: boolean;
+    firecrawlMode: "off" | "auto" | "always";
+    slides: object | null;
+};
+type UrlMarkdownOptions = {
+    effectiveMarkdownMode: "off" | "auto" | "llm" | "readability";
+    markdownRequested: boolean;
+};
+export declare function shouldPreferTranscriptForTarget({ targetUrl, videoMode, slides, }: {
+    targetUrl: string;
+    videoMode: UrlFetchFlags["videoMode"];
+    slides: UrlFetchFlags["slides"];
+}): boolean;
+export declare function resolveUrlFetchOptions({ targetUrl, flags, markdown, cacheMode, }: {
+    targetUrl: string;
+    flags: UrlFetchFlags;
+    markdown: UrlMarkdownOptions;
+    cacheMode: CacheMode;
+}): {
+    localFile: boolean;
+    options: FetchLinkContentOptions;
+};
+export {};

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

@@ -0,0 +1,43 @@
+import type { createThemeRenderer } from "../../../tty/theme.js";
+import { type UrlFlowContext } from "./types.js";
+export declare function writeSlidesBackgroundFailureWarning({ ctx, theme, message, }: {
+    ctx: Pick<UrlFlowContext, "io" | "flags" | "hooks">;
+    theme: ReturnType<typeof createThemeRenderer>;
+    message: string;
+}): void;
+export declare function createUrlFlowProgress({ ctx, theme, }: {
+    ctx: UrlFlowContext;
+    theme: ReturnType<typeof createThemeRenderer>;
+}): {
+    progressStatus: {
+        setSummary(text: string, oscLabel?: string | null): void;
+        setSlides(text: string, percent?: number | null): void;
+        clearSlides(): void;
+        isSlidesActive(): boolean;
+        getSummaryText(): string | null;
+        getSlidesText(): string | null;
+    };
+    hooks: import("./types.js").UrlFlowHooks;
+    pauseProgress: () => () => void;
+    renderStatus: (label: string, detail?: string) => string;
+    renderStatusFromText: (text: string) => string;
+    renderStatusWithMeta: (label: string, meta: string, suffix?: string) => string;
+    spinner: {
+        stop: () => void;
+        clear: () => void;
+        pause: () => void;
+        refresh: () => void;
+        resume: () => void;
+        stopAndClear: () => void;
+        setText: (next: string) => void;
+    };
+    styleDim: (text: string) => string;
+    styleLabel: (text: string) => string;
+    handleSigint: () => never;
+    handleSigterm: () => never;
+    stopProgress: () => void;
+    websiteProgress: {
+        stop: () => void;
+        onProgress: (event: import("@steipete/summarize-core").LinkPreviewProgressEvent) => void;
+    } | null;
+};

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

@@ -1,6 +1,6 @@
+import { type ConvertTranscriptToMarkdown } from "../../../llm/transcript-to-markdown.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;
@@ -13,7 +13,7 @@ export type MarkdownConverters = {
     markdownRequested: boolean;
     transcriptMarkdownRequested: boolean;
     effectiveMarkdownMode: "off" | "auto" | "llm" | "readability";
-    markdownProvider: "none" | "xai" | "openai" | "google" | "anthropic" | "zai";
+    markdownProvider: "none" | "xai" | "openai" | "google" | "anthropic" | "zai" | "nvidia" | "github-copilot";
     markdownModel: MarkdownModel | null;
     convertHtmlToMarkdown: ((args: {
         url: string;