@steipete/summarize 0.12.0 → 0.13.0

package/dist/esm/version.js

@@ -1,7 +1,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-export const FALLBACK_VERSION = "0.12.0";
+export const FALLBACK_VERSION = "0.13.0";
 export function resolvePackageVersion(importMetaUrl) {
     const injected = typeof process !== "undefined" && typeof process.env.SUMMARIZE_VERSION === "string"
         ? process.env.SUMMARIZE_VERSION.trim()

package/dist/types/cache-keys.d.ts

@@ -3,7 +3,7 @@ import type { OutputLanguage } from "./language.js";
 export declare function hashString(value: string): string;
 export declare function hashJson(value: unknown): string;
 export declare function normalizeContentForHash(content: string): string;
-export declare function extractTaggedBlock(prompt: string, tag: "instructions" | "content"): string | null;
+export declare function extractTaggedBlock(prompt: string, tag: "instructions" | "content" | "context"): string | null;
 export declare function buildPromptHash(prompt: string): string;
 export declare function buildPromptContentHash({ prompt, fallbackContent, }: {
     prompt: string;

package/dist/types/cache.d.ts

@@ -7,7 +7,7 @@ export type CacheConfig = {
     ttlDays?: number;
     path?: string;
 };
-export declare const CACHE_FORMAT_VERSION = 1;
+export declare const CACHE_FORMAT_VERSION = 2;
 export declare const DEFAULT_CACHE_MAX_MB = 512;
 export declare const DEFAULT_CACHE_TTL_DAYS = 30;
 export type CacheStore = {

package/dist/types/config/sections.d.ts

@@ -22,7 +22,8 @@ export declare function parseSlidesConfig(root: Record<string, unknown>, path: s
 } | undefined;
 export declare function parseCliConfig(root: Record<string, unknown>, path: string): CliConfig | undefined;
 export declare function parseOutputConfig(root: Record<string, unknown>, path: string): {
-    language: string;
+    length?: string | undefined;
+    language?: string | undefined;
 } | undefined;
 export declare function parseUiConfig(root: Record<string, unknown>, path: string): {
     theme: string;

package/dist/types/config/types.d.ts

@@ -1,6 +1,6 @@
 export type AutoRuleKind = "text" | "website" | "youtube" | "image" | "video" | "file";
 export type VideoMode = "auto" | "transcript" | "understand";
-export type CliProvider = "claude" | "codex" | "gemini" | "agent";
+export type CliProvider = "claude" | "codex" | "gemini" | "agent" | "openclaw" | "opencode";
 export type CliProviderConfig = {
     binary?: string;
     extraArgs?: string[];
@@ -18,6 +18,8 @@ export type CliConfig = {
     codex?: CliProviderConfig;
     gemini?: CliProviderConfig;
     agent?: CliProviderConfig;
+    openclaw?: CliProviderConfig;
+    opencode?: CliProviderConfig;
     autoFallback?: CliAutoFallbackConfig;
     magicAuto?: CliAutoFallbackConfig;
     promptOverride?: string;
@@ -200,6 +202,12 @@ export type SummarizeConfig = {
          * - otherwise: translate the output into the requested language
          */
         language?: string;
+        /**
+         * Default summary length (same values as `--length`).
+         *
+         * Examples: "short", "long", "xl", "20k".
+         */
+        length?: string;
     };
     ui?: {
         /**

package/dist/types/costs.d.ts

@@ -1,5 +1,5 @@
 import type { LlmTokenUsage } from "./llm/generate-text.js";
-export type LlmProvider = "xai" | "openai" | "google" | "anthropic" | "zai" | "nvidia" | "cli";
+export type LlmProvider = "xai" | "openai" | "google" | "anthropic" | "zai" | "nvidia" | "github-copilot" | "cli";
 export type LlmCall = {
     provider: LlmProvider;
     model: string;

package/dist/types/daemon/env-snapshot.d.ts

@@ -1,4 +1,4 @@
-declare const ENV_KEYS: readonly ["PATH", "XAI_API_KEY", "XAI_BASE_URL", "OPENAI_API_KEY", "OPENAI_WHISPER_BASE_URL", "OPENAI_BASE_URL", "OPENROUTER_API_KEY", "OPENAI_USE_CHAT_COMPLETIONS", "NVIDIA_API_KEY", "NGC_API_KEY", "NVIDIA_BASE_URL", "Z_AI_API_KEY", "ZAI_API_KEY", "Z_AI_BASE_URL", "ZAI_BASE_URL", "GEMINI_API_KEY", "GOOGLE_BASE_URL", "GEMINI_BASE_URL", "GOOGLE_GENERATIVE_AI_API_KEY", "GOOGLE_API_KEY", "ANTHROPIC_API_KEY", "ANTHROPIC_BASE_URL", "FIRECRAWL_API_KEY", "APIFY_API_TOKEN", "YT_DLP_PATH", "SUMMARIZE_YT_DLP_COOKIES_FROM_BROWSER", "YT_DLP_COOKIES_FROM_BROWSER", "FAL_KEY", "GROQ_API_KEY", "ASSEMBLYAI_API_KEY", "SUMMARIZE_MODEL", "SUMMARIZE_TRANSCRIBER", "SUMMARIZE_ONNX_PARAKEET_CMD", "SUMMARIZE_ONNX_CANARY_CMD", "CLAUDE_PATH", "CODEX_PATH", "GEMINI_PATH", "AGENT_PATH", "UVX_PATH"];
+declare const ENV_KEYS: readonly ["PATH", "XAI_API_KEY", "XAI_BASE_URL", "OPENAI_API_KEY", "OPENAI_WHISPER_BASE_URL", "OPENAI_BASE_URL", "OPENROUTER_API_KEY", "OPENAI_USE_CHAT_COMPLETIONS", "NVIDIA_API_KEY", "NGC_API_KEY", "NVIDIA_BASE_URL", "Z_AI_API_KEY", "ZAI_API_KEY", "Z_AI_BASE_URL", "ZAI_BASE_URL", "GEMINI_API_KEY", "GOOGLE_BASE_URL", "GEMINI_BASE_URL", "GOOGLE_GENERATIVE_AI_API_KEY", "GOOGLE_API_KEY", "ANTHROPIC_API_KEY", "ANTHROPIC_BASE_URL", "FIRECRAWL_API_KEY", "APIFY_API_TOKEN", "YT_DLP_PATH", "SUMMARIZE_YT_DLP_COOKIES_FROM_BROWSER", "YT_DLP_COOKIES_FROM_BROWSER", "FAL_KEY", "GROQ_API_KEY", "ASSEMBLYAI_API_KEY", "SUMMARIZE_MODEL", "SUMMARIZE_TRANSCRIBER", "SUMMARIZE_ONNX_PARAKEET_CMD", "SUMMARIZE_ONNX_CANARY_CMD", "CLAUDE_PATH", "CODEX_PATH", "GEMINI_PATH", "AGENT_PATH", "OPENCLAW_PATH", "OPENCODE_PATH", "UVX_PATH"];
 export type EnvSnapshot = Partial<Record<(typeof ENV_KEYS)[number], string>>;
 export declare function buildEnvSnapshotFromEnv(env: Record<string, string | undefined>): EnvSnapshot;
 export {};

package/dist/types/daemon/flow-context.d.ts

@@ -1,6 +1,6 @@
 import type { CacheState } from "../cache.js";
 import type { ExtractedLinkContent, LinkPreviewProgressEvent, MediaCache } from "../content/index.js";
-import type { UrlFlowContext } from "../run/flows/url/types.js";
+import { type UrlFlowContext } from "../run/flows/url/types.js";
 import { type RunOverrides } from "../run/run-settings.js";
 import type { SlideImage, SlideSettings, SlideSourceKind } from "../slides/index.js";
 type TextSink = {

package/dist/types/daemon/models.d.ts

@@ -23,6 +23,8 @@ export declare function buildModelPickerOptions({ env, envForRun, configForCli,
         cliGemini: boolean;
         cliCodex: boolean;
         cliAgent: boolean;
+        cliOpenclaw: boolean;
+        cliOpencode: boolean;
     };
     openaiBaseUrl: string | null;
     localModelsSource: {

package/dist/types/daemon/schtasks.d.ts

@@ -14,7 +14,8 @@ export declare function uninstallScheduledTask({ env, stdout, }: {
     env: Record<string, string | undefined>;
     stdout: NodeJS.WritableStream;
 }): Promise<void>;
-export declare function restartScheduledTask({ stdout, }: {
+export declare function restartScheduledTask({ env, stdout, }: {
+    env: Record<string, string | undefined>;
     stdout: NodeJS.WritableStream;
 }): Promise<void>;
 export declare function isScheduledTaskInstalled(): Promise<boolean>;

package/dist/types/daemon/server.d.ts

@@ -1,6 +1,7 @@
 import { type DaemonConfig } from "./config.js";
 import { type SessionEvent } from "./server-session.js";
 export { corsHeaders, isTrustedOrigin } from "./server-http.js";
+export declare function resolveDaemonListenHost(env: Record<string, string | undefined>): string;
 export declare function buildHealthPayload(importMetaUrl?: string): {
     ok: boolean;
     pid: number;

package/dist/types/daemon/windows-container.d.ts

@@ -0,0 +1 @@
+export declare function isWindowsContainerEnvironment(env: Record<string, string | undefined>): boolean;

package/dist/types/llm/cli-provider-output.d.ts

@@ -1,11 +1,20 @@
 import type { CliProvider } from "../config.js";
 import type { LlmTokenUsage } from "./generate-text.js";
-export type JsonCliProvider = Exclude<CliProvider, "codex">;
+export type JsonCliProvider = Exclude<CliProvider, "codex" | "openclaw" | "opencode">;
 export declare function isJsonCliProvider(provider: CliProvider): provider is JsonCliProvider;
 export declare const parseCodexUsageFromJsonl: (output: string) => {
     usage: LlmTokenUsage | null;
     costUsd: number | null;
 };
+export declare function parseCodexOutputFromJsonl(output: string): {
+    text: string | null;
+    sawStructuredEvent: boolean;
+};
+export declare function parseOpenCodeOutputFromJsonl(output: string): {
+    text: string;
+    usage: LlmTokenUsage | null;
+    costUsd: number | null;
+};
 export declare function parseJsonProviderOutput(args: {
     provider: JsonCliProvider;
     stdout: string;

package/dist/types/llm/generate-text-document.d.ts

@@ -1,7 +1,8 @@
+import type { LlmProvider } from "./model-id.js";
 import type { Prompt } from "./prompt.js";
 import type { LlmTokenUsage } from "./types.js";
 type ParsedModel = {
-    provider: "xai" | "openai" | "google" | "anthropic" | "zai" | "nvidia";
+    provider: LlmProvider;
     model: string;
     canonical: string;
 };

package/dist/types/llm/generate-text-shared.d.ts

@@ -16,10 +16,17 @@ export declare function streamUsageWithTimeout({ result, timeoutMs, }: {
     }>;
     timeoutMs: number;
 }): Promise<LlmTokenUsage | null>;
+export declare function isOpenAiGpt5Model(provider: string, model: string): boolean;
 export declare function resolveEffectiveTemperature({ provider, model, temperature, }: {
     provider: string;
     model: string;
     temperature?: number;
 }): number | undefined;
+export declare function shouldRetryGpt5WithoutTokenCap({ provider, model, maxOutputTokens, error, }: {
+    provider: string;
+    model: string;
+    maxOutputTokens?: number;
+    error: unknown;
+}): boolean;
 export declare function resolveGoogleEmptyResponseFallbackModelId(modelId: string): string | null;
 export declare function isGoogleEmptySummaryError(error: unknown): boolean;

package/dist/types/llm/generate-text-stream.d.ts

@@ -1,5 +1,6 @@
 import type { Context } from "@mariozechner/pi-ai";
 import type { LlmApiKeys } from "./generate-text.js";
+import type { LlmProvider } from "./model-id.js";
 import type { LlmTokenUsage } from "./types.js";
 export type StreamTextWithContextArgs = {
     modelId: string;
@@ -19,7 +20,7 @@ export type StreamTextWithContextArgs = {
 export type StreamTextResult = {
     textStream: AsyncIterable<string>;
     canonicalModelId: string;
-    provider: "xai" | "openai" | "google" | "anthropic" | "zai" | "nvidia";
+    provider: LlmProvider;
     usage: Promise<LlmTokenUsage | null>;
     lastError: () => unknown;
 };

package/dist/types/llm/generate-text.d.ts

@@ -1,3 +1,4 @@
+import type { LlmProvider } from "./model-id.js";
 import type { Prompt } from "./prompt.js";
 import type { LlmTokenUsage } from "./types.js";
 export { streamTextWithContext } from "./generate-text-stream.js";
@@ -38,7 +39,7 @@ export declare function generateTextWithModelId({ modelId, apiKeys, prompt, temp
 }): Promise<{
     text: string;
     canonicalModelId: string;
-    provider: "xai" | "openai" | "google" | "anthropic" | "zai" | "nvidia";
+    provider: LlmProvider;
     usage: LlmTokenUsage | null;
 }>;
 export declare function streamTextWithModelId({ modelId, apiKeys, prompt, temperature, maxOutputTokens, timeoutMs, fetchImpl, forceOpenRouter, openaiBaseUrlOverride, anthropicBaseUrlOverride, googleBaseUrlOverride, xaiBaseUrlOverride, forceChatCompletions, }: {
@@ -58,7 +59,7 @@ export declare function streamTextWithModelId({ modelId, apiKeys, prompt, temper
 }): Promise<{
     textStream: AsyncIterable<string>;
     canonicalModelId: string;
-    provider: "xai" | "openai" | "google" | "anthropic" | "zai" | "nvidia";
+    provider: LlmProvider;
     usage: Promise<LlmTokenUsage | null>;
     lastError: () => unknown;
 }>;

package/dist/types/llm/github-models.d.ts

@@ -0,0 +1,5 @@
+export declare const GITHUB_MODELS_BASE_URL = "https://models.github.ai/inference";
+export declare const GITHUB_MODELS_API_VERSION = "2026-03-10";
+export declare function resolveGitHubModelsApiKey(env: Record<string, string | undefined>): string | null;
+export declare function resolveGitHubCopilotBackendModelId(model: string): string;
+export declare function buildGitHubModelsHeaders(existing?: Record<string, string>): Record<string, string>;

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

@@ -1,5 +1,6 @@
 import type { ConvertHtmlToMarkdown } from "@steipete/summarize-core/content";
 import type { LlmTokenUsage } from "./generate-text.js";
+import type { LlmProvider } from "./model-id.js";
 export declare function createHtmlToMarkdownConverter({ modelId, forceOpenRouter, xaiApiKey, googleApiKey, openaiApiKey, openaiBaseUrlOverride, anthropicBaseUrlOverride, googleBaseUrlOverride, xaiBaseUrlOverride, anthropicApiKey, openrouterApiKey, fetchImpl, forceChatCompletions, retries, onRetry, onUsage, }: {
     modelId: string;
     forceOpenRouter?: boolean;
@@ -23,7 +24,7 @@ export declare function createHtmlToMarkdownConverter({ modelId, forceOpenRouter
     }) => void;
     onUsage?: (usage: {
         model: string;
-        provider: "xai" | "openai" | "google" | "anthropic" | "zai" | "nvidia";
+        provider: LlmProvider;
         usage: LlmTokenUsage | null;
     }) => void;
 }): ConvertHtmlToMarkdown;

package/dist/types/llm/model-id.d.ts

@@ -1,4 +1,4 @@
-export type LlmProvider = "xai" | "openai" | "google" | "anthropic" | "zai" | "nvidia";
+export type LlmProvider = "xai" | "openai" | "google" | "anthropic" | "zai" | "nvidia" | "github-copilot";
 export type ParsedModelId = {
     provider: LlmProvider;
     /**

package/dist/types/llm/provider-profile.d.ts

@@ -1,14 +1,14 @@
 import type { CliProvider } from "../config.js";
 import type { OpenAiClientConfig } from "./providers/types.js";
-export type GatewayProvider = "xai" | "openai" | "google" | "anthropic" | "zai" | "nvidia";
-export type RequiredModelEnv = "XAI_API_KEY" | "OPENAI_API_KEY" | "NVIDIA_API_KEY" | "GEMINI_API_KEY" | "ANTHROPIC_API_KEY" | "OPENROUTER_API_KEY" | "Z_AI_API_KEY" | "CLI_CLAUDE" | "CLI_CODEX" | "CLI_GEMINI" | "CLI_AGENT";
+export type GatewayProvider = "xai" | "openai" | "google" | "anthropic" | "zai" | "nvidia" | "github-copilot";
+export type RequiredModelEnv = "XAI_API_KEY" | "OPENAI_API_KEY" | "NVIDIA_API_KEY" | "GEMINI_API_KEY" | "ANTHROPIC_API_KEY" | "OPENROUTER_API_KEY" | "Z_AI_API_KEY" | "GITHUB_TOKEN" | "CLI_CLAUDE" | "CLI_CODEX" | "CLI_GEMINI" | "CLI_AGENT" | "CLI_OPENCLAW" | "CLI_OPENCODE";
 type GatewayProviderProfile = {
     requiredEnv: RequiredModelEnv;
     supportsDocuments: boolean;
     supportsStreaming: boolean;
     supportsVideoUnderstanding: boolean;
 };
-export declare const DEFAULT_CLI_MODELS: Record<CliProvider, string>;
+export declare const DEFAULT_CLI_MODELS: Record<CliProvider, string | null>;
 export declare const DEFAULT_AUTO_CLI_ORDER: CliProvider[];
 export declare function parseCliProviderName(raw: string): CliProvider | null;
 export declare function requiredEnvForCliProvider(provider: CliProvider): RequiredModelEnv;
@@ -21,7 +21,7 @@ export declare function envHasRequiredKey(env: Record<string, string | undefined
 export declare function resolveRequiredEnvForModelId(modelId: string): RequiredModelEnv;
 export declare function isVideoUnderstandingCapableModelId(modelId: string): boolean;
 export declare function resolveOpenAiCompatibleClientConfigForProvider({ provider, openaiApiKey, openrouterApiKey, forceOpenRouter, openaiBaseUrlOverride, forceChatCompletions, }: {
-    provider: "openai" | "zai" | "nvidia";
+    provider: "openai" | "zai" | "nvidia" | "github-copilot";
     openaiApiKey: string | null;
     openrouterApiKey: string | null;
     forceOpenRouter?: boolean;

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" | "nvidia";
+        provider: LlmProvider;
         usage: LlmTokenUsage | null;
     }) => void;
 }): ConvertTranscriptToMarkdown;

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" | "nvidia";
+    provider: LlmProvider;
     openrouterProviders: string[] | null;
     forceOpenRouter: false;
-    requiredEnv: "XAI_API_KEY" | "OPENAI_API_KEY" | "GEMINI_API_KEY" | "ANTHROPIC_API_KEY" | "Z_AI_API_KEY" | "NVIDIA_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" | "nvidia";
+    provider: LlmProvider;
     attachment: {
         kind: "image" | "file";
         mediaType: string;
     };
 }): boolean;
 export declare function assertProviderSupportsAttachment({ provider, modelId, attachment, }: {
-    provider: "xai" | "openai" | "google" | "anthropic" | "zai" | "nvidia";
+    provider: LlmProvider;
     modelId: string;
     attachment: {
         kind: "image" | "file";

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

@@ -1,6 +1,11 @@
 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;

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

@@ -88,6 +88,16 @@ export type AssetSummaryContext = {
         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

@@ -1,5 +1,5 @@
 import type { createThemeRenderer } from "../../../tty/theme.js";
-import type { UrlFlowContext } from "./types.js";
+import { type UrlFlowContext } from "./types.js";
 export declare function writeSlidesBackgroundFailureWarning({ ctx, theme, message, }: {
     ctx: Pick<UrlFlowContext, "io" | "flags" | "hooks">;
     theme: ReturnType<typeof createThemeRenderer>;
@@ -17,6 +17,7 @@ export declare function createUrlFlowProgress({ ctx, theme, }: {
         getSummaryText(): string | null;
         getSlidesText(): string | null;
     };
+    hooks: import("./types.js").UrlFlowHooks;
     pauseProgress: () => () => void;
     renderStatus: (label: string, detail?: string) => string;
     renderStatusFromText: (text: string) => string;
@@ -25,6 +26,7 @@ export declare function createUrlFlowProgress({ ctx, theme, }: {
         stop: () => void;
         clear: () => void;
         pause: () => void;
+        refresh: () => void;
         resume: () => void;
         stopAndClear: () => void;
         setText: (next: string) => void;

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

@@ -13,7 +13,7 @@ export type MarkdownConverters = {
     markdownRequested: boolean;
     transcriptMarkdownRequested: boolean;
     effectiveMarkdownMode: "off" | "auto" | "llm" | "readability";
-    markdownProvider: "none" | "xai" | "openai" | "google" | "anthropic" | "zai" | "nvidia";
+    markdownProvider: "none" | "xai" | "openai" | "google" | "anthropic" | "zai" | "nvidia" | "github-copilot";
     markdownModel: MarkdownModel | null;
     convertHtmlToMarkdown: ((args: {
         url: string;

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

@@ -0,0 +1,17 @@
+export type UrlProgressStatusState = {
+    summaryText: string | null;
+    slidesActive: boolean;
+    slidesText: string | null;
+    lastSlideRenderAt: number;
+};
+export declare function createUrlProgressStatusState(): UrlProgressStatusState;
+export declare function applySummaryText(state: UrlProgressStatusState, text: string): {
+    renderText: string | null;
+};
+export declare function applySlidesText(state: UrlProgressStatusState, text: string, nowMs: number): {
+    renderText: string | null;
+};
+export declare function clearSlidesText(state: UrlProgressStatusState): {
+    renderText: string | null;
+    summaryText: string | null;
+};

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

@@ -3,6 +3,7 @@ export declare function createUrlProgressStatus({ enabled, spinner, oscProgress,
     enabled: boolean;
     spinner: {
         setText: (text: string) => void;
+        refresh?: () => void;
     };
     oscProgress: OscProgressController;
     now?: () => number;

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

@@ -0,0 +1,26 @@
+import type { ExtractedLinkContent } from "../../../content/index.js";
+import { type SlideExtractionResult } from "../../../slides/index.js";
+import { type SlidesTerminalOutput } from "./slides-output.js";
+import { type UrlFlowContext } from "./types.js";
+type ProgressStatusLike = {
+    clearSlides: () => void;
+    setSlides: (text: string, percent?: number | null) => void;
+};
+export type UrlSlidesSession = {
+    getSlidesExtracted: () => SlideExtractionResult | null;
+    runSlidesExtraction: () => Promise<SlideExtractionResult | null>;
+    slidesOutput: SlidesTerminalOutput | null;
+    slidesTimelinePromise: Promise<SlideExtractionResult | null> | null;
+    setExtracted: (value: ExtractedLinkContent) => void;
+};
+export declare function createUrlSlidesSession({ ctx, url, extracted: initialExtracted, cacheStore, progressStatus, renderStatus, renderStatusFromText, updateSummaryProgress, }: {
+    ctx: UrlFlowContext;
+    url: string;
+    extracted: ExtractedLinkContent;
+    cacheStore: UrlFlowContext["cache"]["store"] | null;
+    progressStatus: ProgressStatusLike;
+    renderStatus: (label: string, detail?: string) => string;
+    renderStatusFromText: (text: string) => string;
+    updateSummaryProgress: () => void;
+}): UrlSlidesSession;
+export {};

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

@@ -142,6 +142,22 @@ export type UrlFlowHooks = {
     buildReport: () => Promise<RunMetricsReport>;
     estimateCostUsd: () => Promise<number | null>;
 };
+export type UrlFlowEventHooks = Pick<UrlFlowHooks, "onModelChosen" | "onExtracted" | "onSlidesExtracted" | "onSlidesProgress" | "onSlidesDone" | "onSlideChunk" | "onLinkPreviewProgress" | "onSummaryCached">;
+export type UrlFlowRuntimeHooks = Pick<UrlFlowHooks, "setTranscriptionCost" | "summarizeAsset" | "writeViaFooter" | "clearProgressForStdout" | "restoreProgressAfterStdout" | "setClearProgressBeforeStdout" | "clearProgressIfCurrent" | "buildReport" | "estimateCostUsd">;
+export declare function createUrlFlowHooks(options: {
+    runtime: UrlFlowRuntimeHooks;
+    events?: Partial<UrlFlowEventHooks>;
+}): UrlFlowHooks;
+export declare function composeUrlFlowHooks(base: UrlFlowHooks, overrides: Partial<UrlFlowHooks>): UrlFlowHooks;
+export declare function createUrlFlowContext(options: {
+    io: UrlFlowIo;
+    flags: UrlFlowFlags;
+    model: UrlFlowModel;
+    cache: CacheState;
+    mediaCache: MediaCache | null;
+    runtimeHooks: UrlFlowRuntimeHooks;
+    eventHooks?: Partial<UrlFlowEventHooks>;
+}): UrlFlowContext;
 /**
  * Wiring struct for `runUrlFlow`.
  * CLI runner populates the full surface; daemon uses a smaller subset (no TTY/progress/footer),

package/dist/types/run/flows/url/video-only.d.ts

@@ -0,0 +1,27 @@
+import { type ExtractedLinkContent } from "../../../content/index.js";
+import type { SlideExtractionResult } from "../../../slides/index.js";
+import { type UrlExtractionUi } from "./extract.js";
+import type { UrlFlowContext } from "./types.js";
+export type VideoOnlyResult = {
+    handled: true;
+} | {
+    handled: false;
+    extracted: ExtractedLinkContent;
+    extractionUi: UrlExtractionUi;
+};
+export declare function handleVideoOnlyExtractedContent({ ctx, extracted, extractionUi, isYoutubeUrl, fetchWithCache, runSlidesExtraction, renderStatus, renderStatusWithMeta, spinner, styleDim, updateSummaryProgress, accent, }: {
+    ctx: UrlFlowContext;
+    extracted: ExtractedLinkContent;
+    extractionUi: UrlExtractionUi;
+    isYoutubeUrl: boolean;
+    fetchWithCache: (url: string) => Promise<ExtractedLinkContent>;
+    runSlidesExtraction: () => Promise<SlideExtractionResult | null>;
+    renderStatus: (label: string, detail?: string) => string;
+    renderStatusWithMeta: (label: string, meta: string, suffix?: string) => string;
+    spinner: {
+        setText: (text: string) => void;
+    };
+    styleDim: (text: string) => string;
+    updateSummaryProgress: () => void;
+    accent: (text: string) => string;
+}): Promise<VideoOnlyResult>;