@steipete/summarize 0.12.0 → 0.13.0

package/dist/types/run/run-settings.d.ts

@@ -1,7 +1,7 @@
 import type { CliProvider } from "../config.js";
 import type { FirecrawlMode, LengthArg, MarkdownMode, PreprocessMode, VideoMode, YoutubeMode } from "../flags.js";
 import type { OutputLanguage } from "../language.js";
-import type { SummaryLengthTarget } from "../prompts/index.js";
+import { type SummaryLengthTarget } from "../prompts/index.js";
 export type ResolvedRunSettings = {
     lengthArg: LengthArg;
     firecrawlMode: FirecrawlMode;
@@ -50,6 +50,7 @@ export declare function resolveSummaryLength(raw: unknown, fallback?: string): {
     lengthArg: LengthArg;
     summaryLength: SummaryLengthTarget;
 };
+export declare function buildPromptLengthInstruction(lengthArg: LengthArg): string;
 export declare function resolveOutputLanguageSetting({ raw, fallback, }: {
     raw: unknown;
     fallback: OutputLanguage;

package/dist/types/run/runner-contexts.d.ts

@@ -1,7 +1,7 @@
 import type { CacheState } from "../cache.js";
 import type { MediaCache } from "../content/index.js";
-import type { SummarizeAssetArgs } from "./flows/asset/summary.js";
-import type { UrlFlowContext } from "./flows/url/types.js";
+import { type SummarizeAssetArgs } from "./flows/asset/summary.js";
+import { type UrlFlowContext } from "./flows/url/types.js";
 type SummarizeMediaFile = typeof import("./flows/asset/media.js").summarizeMediaFile;
 export declare function createRunnerFlowContexts(options: {
     summarizeMediaFileImpl: SummarizeMediaFile;
@@ -32,31 +32,6 @@ export declare function createRunnerFlowContexts(options: {
         setClearProgressBeforeStdout: (fn: (() => undefined | (() => void)) | null) => void;
         clearProgressIfCurrent: (fn: () => void) => void;
     };
-    urlFlowContext: {
-        io: import("./flows/url/types.js").UrlFlowIo;
-        flags: import("./flows/url/types.js").UrlFlowFlags;
-        model: import("./flows/url/types.js").UrlFlowModel;
-        cache: CacheState;
-        mediaCache: MediaCache | null;
-        hooks: {
-            onModelChosen: null;
-            onExtracted: null;
-            onSlidesExtracted: null;
-            onSlidesProgress: null;
-            onLinkPreviewProgress: null;
-            onSummaryCached: null;
-            setTranscriptionCost: (costUsd: number | null, label: string | null) => void;
-            summarizeAsset: (args: SummarizeAssetArgs) => Promise<void>;
-            writeViaFooter: (parts: string[]) => void;
-            clearProgressForStdout: () => void;
-            restoreProgressAfterStdout: (() => void) | null | undefined;
-            setClearProgressBeforeStdout: (fn: (() => undefined | (() => void)) | null) => void;
-            clearProgressIfCurrent: (fn: () => void) => void;
-            buildReport: () => Promise<import("../costs.js").RunMetricsReport>;
-            estimateCostUsd: () => Promise<number | null>;
-            onSlideChunk: undefined;
-            onSlidesDone: null;
-        };
-    };
+    urlFlowContext: UrlFlowContext;
 };
 export {};

package/dist/types/run/runner-execution.d.ts

@@ -10,6 +10,7 @@ export declare function executeRunnerInput(options: {
     url: string | null;
     isYoutubeUrl: boolean;
     withUrlAssetContext: unknown;
+    slidesEnabled: boolean;
     extractMode: boolean;
     progressEnabled: boolean;
     renderSpinnerStatus: (label: string, detail?: string) => string;

package/dist/types/run/runner-plan.d.ts

@@ -0,0 +1,19 @@
+import type { Command } from "commander";
+import { type CacheState } from "../cache.js";
+import type { ExecFileFn } from "../markitdown.js";
+export type RunnerPlan = {
+    cacheState: CacheState;
+    execute: () => Promise<void>;
+};
+export declare function createRunnerPlan(options: {
+    normalizedArgv: string[];
+    program: Command;
+    env: Record<string, string | undefined>;
+    envForRun: Record<string, string | undefined>;
+    fetchImpl: typeof fetch;
+    execFileImpl: ExecFileFn;
+    stdin?: NodeJS.ReadableStream;
+    stdout: NodeJS.WritableStream;
+    stderr: NodeJS.WritableStream;
+    promptOverride: string | null;
+}): Promise<RunnerPlan>;

package/dist/types/run/runner-slides.d.ts

@@ -1,8 +1,9 @@
 import type { SummarizeConfig } from "../config.js";
+import type { InputTarget } from "../content/asset.js";
 import { type SlideSettings } from "../slides/index.js";
 export declare function resolveRunnerSlidesSettings(options: {
     normalizedArgv: string[];
     programOpts: Record<string, unknown>;
     config: SummarizeConfig | null;
-    inputKind: "url" | "file" | "stdin";
+    inputTarget: InputTarget;
 }): SlideSettings | null;

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

@@ -1,8 +1,9 @@
+import type { LlmProvider } from "../llm/model-id.js";
 export { mergeStreamingChunk } from "../shared/streaming-merge.js";
 export declare function isGoogleStreamingUnsupportedError(error: unknown): boolean;
 export declare function isStreamingTimeoutError(error: unknown): boolean;
 export declare function canStream({ provider, prompt, transport, }: {
-    provider: "xai" | "openai" | "google" | "anthropic" | "zai" | "nvidia";
+    provider: LlmProvider;
     prompt: {
         attachments?: Array<{
             kind: "text" | "image" | "document";

package/dist/types/run/summary-engine.d.ts

@@ -24,7 +24,7 @@ export type SummaryEngineDeps = {
     resolveMaxOutputTokensForCall: (modelId: string) => Promise<number | null>;
     resolveMaxInputTokensForCall: (modelId: string) => Promise<number | null>;
     llmCalls: Array<{
-        provider: "xai" | "openai" | "google" | "anthropic" | "zai" | "nvidia" | "cli";
+        provider: "xai" | "openai" | "google" | "anthropic" | "zai" | "nvidia" | "github-copilot" | "cli";
         model: string;
         usage: Awaited<ReturnType<typeof summarizeWithModelId>>["usage"] | null;
         costUsd?: number | null;

package/dist/types/run/summary-llm.d.ts

@@ -1,4 +1,5 @@
 import { generateTextWithModelId } from "../llm/generate-text.js";
+import type { LlmProvider } from "../llm/model-id.js";
 import type { parseGatewayStyleModelId } from "../llm/model-id.js";
 import type { Prompt } from "../llm/prompt.js";
 export declare function resolveModelIdForLlmCall({ parsedModel, apiKeys, fetchImpl, timeoutMs, }: {
@@ -42,7 +43,7 @@ export declare function summarizeWithModelId({ modelId, prompt, maxOutputTokens,
     }) => void;
 }): Promise<{
     text: string;
-    provider: "xai" | "openai" | "google" | "anthropic" | "zai" | "nvidia";
+    provider: LlmProvider;
     canonicalModelId: string;
     usage: Awaited<ReturnType<typeof generateTextWithModelId>>["usage"];
 }>;

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

@@ -1,5 +1,6 @@
 import type { CliProvider } from "../config.js";
-export type ModelAttemptRequiredEnv = "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";
+import type { LlmProvider } from "../llm/model-id.js";
+export type ModelAttemptRequiredEnv = "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";
 export type ModelAttempt = {
     transport: "native" | "openrouter" | "cli";
     userModelId: string;
@@ -14,7 +15,7 @@ export type ModelAttempt = {
     cliModel?: string | null;
 };
 export type ModelMeta = {
-    provider: "xai" | "openai" | "google" | "anthropic" | "zai" | "nvidia" | "cli";
+    provider: LlmProvider | "cli";
     canonical: string;
 };
 export type MarkdownModel = {

package/dist/types/shared/slides-text.d.ts

@@ -0,0 +1 @@
+export { buildSlideTextFallback, coerceSummaryWithSlides, parseSlideSummariesFromMarkdown, parseTranscriptTimedText, resolveSlideTextBudget, splitSlideTitleFromText, splitSummaryFromSlides, type SlideTimelineEntry, } from "../run/flows/url/slides-text.js";

package/dist/types/slides/extract.d.ts

@@ -1,4 +1,4 @@
-import type { ExtractedLinkContent, MediaCache } from "../content/index.js";
+import type { MediaCache } from "../content/index.js";
 import type { SlideSettings } from "./settings.js";
 import type { SlideExtractionResult, SlideImage, SlideSource, SlideSourceKind } from "./types.js";
 export { parseShowinfoTimestamp, resolveExtractedTimestamp } from "./scene-detection.js";
@@ -29,9 +29,4 @@ type ExtractSlidesArgs = {
         onSlidesLog?: ((message: string) => void) | null;
     } | null;
 };
-export declare function resolveSlideSource({ url, extracted, }: {
-    url: string;
-    extracted: ExtractedLinkContent;
-}): SlideSource | null;
-export declare function resolveSlideSourceFromUrl(url: string): SlideSource | null;
 export declare function extractSlidesForSource({ source, settings, noCache, mediaCache, env, timeoutMs, ytDlpPath, ytDlpCookiesFromBrowser, ffmpegPath, tesseractPath, hooks, }: ExtractSlidesArgs): Promise<SlideExtractionResult>;

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

@@ -1,4 +1,5 @@
-export { extractSlidesForSource, parseShowinfoTimestamp, resolveExtractedTimestamp, resolveSlideSource, resolveSlideSourceFromUrl, } from "./extract.js";
+export { extractSlidesForSource, parseShowinfoTimestamp, resolveExtractedTimestamp, } from "./extract.js";
+export { isDirectVideoInput, resolveSlideSource, resolveSlideSourceFromUrl } from "./source.js";
 export type { SlideSettings, SlideSettingsInput } from "./settings.js";
 export { resolveSlideSettings } from "./settings.js";
 export { buildSlidesDirId, readSlidesCacheIfValid, resolveSlideImagePath, resolveSlidesDir, serializeSlideImagePath, validateSlidesCache, } from "./store.js";

package/dist/types/slides/source.d.ts

@@ -0,0 +1,8 @@
+import type { ExtractedLinkContent } from "../content/index.js";
+import type { SlideSource } from "./types.js";
+export { isDirectVideoInput } from "../content/index.js";
+export declare function resolveSlideSource({ url, extracted, }: {
+    url: string;
+    extracted: ExtractedLinkContent;
+}): SlideSource | null;
+export declare function resolveSlideSourceFromUrl(url: string): SlideSource | null;

package/dist/types/tty/progress/fetch-html.d.ts

@@ -4,6 +4,7 @@ import type { ThemeRenderer } from "../theme.js";
 export declare function createFetchHtmlProgressRenderer({ spinner, oscProgress, theme, }: {
     spinner: {
         setText: (text: string) => void;
+        refresh?: () => void;
     };
     oscProgress?: OscProgressController | null;
     theme?: ThemeRenderer | null;

package/dist/types/tty/progress/transcript-state.d.ts

@@ -0,0 +1,27 @@
+import type { LinkPreviewProgressEvent } from "@steipete/summarize-core/content";
+import type { ThemeRenderer } from "../theme.js";
+export type TranscriptProgressState = {
+    phase: "idle" | "download" | "whisper";
+    service: "youtube" | "podcast" | "generic";
+    downloadedBytes: number;
+    totalBytes: number | null;
+    startedAtMs: number | null;
+    whisperProviderHint: string;
+    mediaKind: "video" | "audio" | "unknown";
+    whisperModelId: string | null;
+    whisperProcessedSeconds: number | null;
+    whisperTotalSeconds: number | null;
+    whisperPartIndex: number | null;
+    whisperParts: number | null;
+};
+export declare function createTranscriptProgressState(): TranscriptProgressState;
+export declare function applyTranscriptProgressEvent(state: TranscriptProgressState, event: LinkPreviewProgressEvent, nowMs: number): void;
+export declare function renderTranscriptSimple(state: TranscriptProgressState, theme?: ThemeRenderer | null): string | null;
+export declare function renderTranscriptLine(state: TranscriptProgressState, { nowMs, theme, }: {
+    nowMs: number;
+    theme?: ThemeRenderer | null;
+}): string | null;
+export declare function resolveTranscriptOscPayload(state: TranscriptProgressState): {
+    label: string;
+    percent: number | null;
+} | null;

package/dist/types/tty/progress/transcript.d.ts

@@ -4,6 +4,7 @@ import type { ThemeRenderer } from "../theme.js";
 export declare function createTranscriptProgressRenderer({ spinner, oscProgress, theme, }: {
     spinner: {
         setText: (text: string) => void;
+        refresh?: () => void;
     };
     oscProgress?: OscProgressController | null;
     theme?: ThemeRenderer | null;

package/dist/types/tty/spinner.d.ts

@@ -8,6 +8,7 @@ export declare function startSpinner({ text, enabled, stream, color, }: {
     stop: () => void;
     clear: () => void;
     pause: () => void;
+    refresh: () => void;
     resume: () => void;
     stopAndClear: () => void;
     setText: (next: string) => void;

package/dist/types/version.d.ts

@@ -1,4 +1,4 @@
-export declare const FALLBACK_VERSION = "0.12.0";
+export declare const FALLBACK_VERSION = "0.13.0";
 export declare function resolvePackageVersion(importMetaUrl?: string): string;
 export declare function resolveGitSha(importMetaUrl?: string): string | null;
 export declare function formatVersionLine(importMetaUrl?: string): string;

package/docs/README.md

@@ -6,7 +6,7 @@ summary: "Docs index for summarize behaviors and modes."
 
 - `docs/chrome-extension.md` — Chrome side panel extension + daemon setup/troubleshooting
 - `docs/cache.md` — cache design + config (SQLite)
-- `docs/cli.md` — CLI models (Claude/Codex/Gemini)
+- `docs/cli.md` — CLI models (Claude/Codex/Gemini/Agent/OpenClaw/OpenCode)
 - `docs/config.md` — config file location, precedence, and schema
 - `docs/extract-only.md` — extract mode (no summary LLM call)
 - `docs/firecrawl.md` — Firecrawl mode + API key

package/docs/agent.md

@@ -138,7 +138,7 @@ Returns cached chat history for the same cache key as `/v1/agent`.
 - **Auto model**: uses existing auto-selection logic (`buildAutoModelAttempts`), preferring API-key transports and then CLI fallback when available.
 - **Synthetic models**: created for OpenAI-compatible base URLs (local/openrouter).
 - `maxOutputTokens` defaults to 2048 or `maxOutputTokens` override.
-- CLI models are supported as auto fallback and via explicit `cli/<provider>/<model>` overrides.
+- CLI models are supported as auto fallback and via explicit `cli/<provider>` or `cli/<provider>/<model>` overrides.
 - If the daemon still says no model is available after key/install changes, restart or reinstall it so the saved environment snapshot refreshes.
 
 ## Page Content Payload

package/docs/assets/site.css

@@ -30,6 +30,7 @@
   :root {
     --bg0: #fbf6eb;
     --bg1: #f1ecdf;
+    --bg-code: rgba(0, 0, 0, 0.55);
     --panel: rgba(255, 255, 255, 0.86);
     --paper: #0b0f12;
     --ink: #0b0f12;
@@ -40,6 +41,9 @@
     --shadow: 0 26px 70px rgba(9, 12, 16, 0.12);
     --shadow2: 0 10px 26px rgba(9, 12, 16, 0.1);
   }
+  div.highlight {
+    background-color: var(--bg-code);
+  }
 }
 
 * {
@@ -539,6 +543,13 @@ code {
   color: var(--fg1);
 }
 
+div.highlight {
+  border-radius: 10px;
+}
+pre.highlight {
+  margin: 0;
+  padding: 14px;
+}
 .more {
   margin-top: 24px;
   padding: 0 6px;

package/docs/chrome-extension.md

@@ -12,7 +12,7 @@ Quickstart:
 
 - Install summarize (choose one):
   - `npm i -g @steipete/summarize`
-  - `brew install steipete/tap/summarize` (macOS arm64)
+  - `brew install summarize` (macOS, Linux)
 - Build/load extension: `apps/chrome-extension/README.md`
 - Firefox sidebar build: `pnpm -C apps/chrome-extension build:firefox` (load via `about:debugging` → temporary add-on)
 - Open side panel → copy token install command → run:
@@ -44,6 +44,12 @@ Dev (repo checkout):
   - `summarize daemon install` now tries both launchd domains (`gui/<uid>` then `user/<uid>`).
   - Install as your normal user (not root) so HOME + launchd domain match.
   - Re-run: `summarize daemon install --token <TOKEN>`.
+- Windows containers:
+  - `summarize daemon install --token <TOKEN>` starts the daemon for the current container session but does not create a Scheduled Task.
+  - Run that command manually each time the container starts, or add it to your container startup. Also publish the daemon port in `docker-compose.yml`:
+    `ports: ['8787:8787']`
+    `command: ['cmd', '/c', 'summarize daemon install --token <TOKEN>']`
+  - Then restart the container and verify `http://127.0.0.1:8787/health`.
 - “Need extension-side traces”:
   - Options → Logs → `extension.log` (panel/background events).
   - Enable “Extended logging” in Advanced settings for full pipeline traces.

package/docs/cli.md

@@ -1,12 +1,12 @@
 ---
-summary: "CLI model providers and config for Claude, Codex, Gemini, and Cursor Agent."
+summary: "CLI model providers and config for Claude, Codex, Gemini, Cursor Agent, OpenClaw, and OpenCode."
 read_when:
   - "When changing CLI model integration."
 ---
 
 # CLI models
 
-Summarize can use installed CLIs (Claude, Codex, Gemini, Cursor Agent) as local model backends.
+Summarize can use installed CLIs (Claude, Codex, Gemini, Cursor Agent, OpenClaw, OpenCode) as local model backends.
 
 ## Model ids
 
@@ -14,6 +14,10 @@ Summarize can use installed CLIs (Claude, Codex, Gemini, Cursor Agent) as local
 - `cli/codex/<model>` (e.g. `cli/codex/gpt-5.2`)
 - `cli/gemini/<model>` (e.g. `cli/gemini/gemini-3-flash`)
 - `cli/agent/<model>` (e.g. `cli/agent/gpt-5.2`)
+- `cli/openclaw/<model>` (e.g. `cli/openclaw/main`)
+- `openclaw/<model>` (alias for the same OpenClaw CLI path)
+- `cli/opencode/<model>` (e.g. `cli/opencode/openai/gpt-5.4`)
+- `cli/opencode` (use the OpenCode runtime default model)
 
 Use `--cli [provider]` (case-insensitive) for the provider default, or `--model cli/<provider>/<model>` to pin a model.
 If `--cli` is provided without a provider, auto selection is used with CLI enabled.
@@ -28,7 +32,7 @@ Auto mode can prepend CLI attempts in two ways:
 - Auto CLI fallback (`cli.autoFallback`, default enabled):
   - Applies only to **implicit** auto (when no model is set via flag/env/config).
   - Default behavior: only when no API key is configured.
-  - Default order: `claude, gemini, codex, agent`.
+  - Default order: `claude, gemini, codex, agent, openclaw, opencode`.
   - Remembers + prioritizes the last successful CLI provider (`~/.summarize/cli-state.json`).
 
 Gemini CLI performance: summarize sets `GEMINI_CLI_NO_RELAUNCH=true` for Gemini CLI runs to avoid a costly self-relaunch (can be overridden by setting it yourself).
@@ -49,7 +53,7 @@ Configure auto CLI fallback:
     "autoFallback": {
       "enabled": true,
       "onlyWhenNoApiKeys": true,
-      "order": ["claude", "gemini", "codex", "agent"]
+      "order": ["claude", "gemini", "codex", "agent", "openclaw", "opencode"]
     }
   }
 }
@@ -71,6 +75,8 @@ Binary lookup:
 
 - `CLAUDE_PATH`, `CODEX_PATH`, `GEMINI_PATH` (optional overrides)
 - `AGENT_PATH` (optional override)
+- `OPENCLAW_PATH` (optional override)
+- `OPENCODE_PATH` (optional override)
 - Otherwise uses `PATH`
 
 ## Attachments (images/files)
@@ -82,17 +88,18 @@ path-based prompt and enables the required tool flags:
 - Gemini: `--yolo` and `--include-directories <dir>`
 - Codex: `codex exec --output-last-message ...` and `-i <image>` for images
 - Agent: uses built-in file tools in `agent --print` mode (no extra flags)
+- OpenCode: `opencode run --format json ... --file <path>` when a file/image path is required
 
 ## Config
 
 ```json
 {
   "cli": {
-    "enabled": ["claude", "gemini", "codex", "agent"],
+    "enabled": ["claude", "gemini", "codex", "agent", "openclaw", "opencode"],
     "autoFallback": {
       "enabled": true,
       "onlyWhenNoApiKeys": true,
-      "order": ["claude", "gemini", "codex", "agent"]
+      "order": ["claude", "gemini", "codex", "agent", "openclaw", "opencode"]
     },
     "codex": { "model": "gpt-5.2" },
     "gemini": { "model": "gemini-3-flash", "extraArgs": ["--verbose"] },
@@ -104,6 +111,13 @@ path-based prompt and enables the required tool flags:
     "agent": {
       "model": "gpt-5.2",
       "binary": "/usr/local/bin/agent"
+    },
+    "openclaw": {
+      "model": "main",
+      "binary": "/usr/local/bin/openclaw"
+    },
+    "opencode": {
+      "binary": "/usr/local/bin/opencode"
     }
   }
 }
@@ -115,6 +129,8 @@ Notes:
 - If a CLI call fails, auto mode falls back to the next candidate.
 - Cursor Agent CLI uses the `agent` binary and relies on Cursor CLI auth (login or `CURSOR_API_KEY`).
 - Gemini CLI is invoked in headless mode with `--prompt` for compatibility with current Gemini CLI releases.
+- OpenClaw uses the `openclaw agent --agent <model> - --json` path, streams the prompt over stdin, and expects local OpenClaw auth/config to already be set up.
+- OpenCode uses `opencode run --format json`, streams prompt text over stdin, and uses the runtime default model when none is configured.
 
 ## Quick smoke test (all CLI providers)
 
@@ -127,6 +143,8 @@ summarize --cli codex --plain --timeout 2m /tmp/summarize-cli-smoke.txt
 summarize --cli claude --plain --timeout 2m /tmp/summarize-cli-smoke.txt
 summarize --cli gemini --plain --timeout 2m /tmp/summarize-cli-smoke.txt
 summarize --cli agent --plain --timeout 2m /tmp/summarize-cli-smoke.txt
+summarize --cli openclaw --plain --timeout 2m /tmp/summarize-cli-smoke.txt
+summarize --cli opencode --plain --timeout 2m /tmp/summarize-cli-smoke.txt
 ```
 
 If Agent fails with auth, run `agent login` (interactive) or set `CURSOR_API_KEY`.

package/docs/config.md

@@ -29,6 +29,12 @@ For output language:
 2. Config file `output.language` (preferred) or `language` (legacy)
 3. Built-in default (`auto` = match source content language)
 
+For output length:
+
+1. CLI flag `--length`
+2. Config file `output.length`
+3. Built-in default (`xl`)
+
 See `docs/language.md` for supported values.
 
 For prompt:
@@ -58,12 +64,18 @@ For UI theme:
 {
   "model": { "id": "google/gemini-3-flash" },
   "env": { "OPENAI_API_KEY": "sk-..." },
-  "output": { "language": "auto" },
+  "output": { "language": "auto", "length": "long" },
   "prompt": "Explain like I am five.",
   "ui": { "theme": "ember" }
 }
 ```
 
+`output.length` accepts the same values as `--length`:
+
+- Presets: `short`, `medium`, `long`, `xl`, `xxl`
+- Shorthand: `s`, `m`, `l`
+- Character targets: `1500`, `20k`, `20000`
+
 Shorthand (equivalent):
 
 ```json
@@ -316,15 +328,17 @@ Examples:
 ```json
 {
   "cli": {
-    "enabled": ["gemini", "agent"],
+    "enabled": ["gemini", "agent", "openclaw", "opencode"],
     "autoFallback": {
       "enabled": true,
       "onlyWhenNoApiKeys": true,
-      "order": ["claude", "gemini", "codex", "agent"]
+      "order": ["claude", "gemini", "codex", "agent", "openclaw", "opencode"]
     },
     "codex": { "model": "gpt-5.2" },
     "claude": { "binary": "/usr/local/bin/claude", "extraArgs": ["--verbose"] },
-    "agent": { "binary": "/usr/local/bin/agent", "model": "gpt-5.2" }
+    "agent": { "binary": "/usr/local/bin/agent", "model": "gpt-5.2" },
+    "openclaw": { "binary": "/usr/local/bin/openclaw", "model": "main" },
+    "opencode": { "binary": "/usr/local/bin/opencode", "model": "openai/gpt-5.4" }
   }
 }
 ```
@@ -333,7 +347,7 @@ Notes:
 
 - `cli.enabled` is an allowlist (and order) for auto + explicit CLI model ids.
 - `cli.autoFallback` controls implicit-auto CLI fallback when `cli.enabled` is not set.
-- Default auto fallback order: `claude, gemini, codex, agent`.
+- Default auto fallback order: `claude, gemini, codex, agent, openclaw, opencode`.
 - Auto fallback stores the last successful provider in `~/.summarize/cli-state.json` and prioritizes it on the next run.
 - `cli.<provider>.binary` overrides CLI binary discovery.
 - `cli.<provider>.extraArgs` appends extra CLI args.

package/docs/extract-only.md

@@ -18,13 +18,13 @@ Deprecated alias: `--extract-only`.
 - `--format md` may still convert HTML to Markdown (depending on `--markdown-mode` and available tools).
 - `--length` is intended for summarization guidance; extraction prints full content.
 - `--timestamps` keeps the plain transcript text but also exposes `transcriptSegments` and `transcriptTimedText` (JSON) and prints a timed transcript block when available.
-- `--slides` runs slide detection (YouTube/direct video URLs). Slide metadata is included in JSON output and written to `slides.json` in the slide directory.
+- `--slides` runs slide detection (YouTube/direct video URLs/local video files). Slide metadata is included in JSON output and written to `slides.json` in the slide directory.
   - When combined with `--extract` for videos that have timed transcripts, the CLI interleaves slide images inline at matching timestamps.
   - Scene detection auto-tunes using sampled frame hashes.
 - For non-YouTube URLs with `--format md`, the CLI uses Readability article HTML as the default Markdown input (`--markdown-mode readability`).
   - Use `--markdown-mode auto` to prefer LLM/markitdown conversion without Readability preprocessing.
   - Use `--markdown-mode llm` to force an LLM conversion.
-  - Use `--firecrawl always` to try Firecrawl first.
+  - Use `--firecrawl always` to try Firecrawl first for non-YouTube URLs.
 - For non-YouTube URLs with `--format md`, `--markdown-mode auto` can convert HTML to Markdown via an LLM when configured.
   - Force it with `--markdown-mode llm`.
   - If no LLM is configured, `--markdown-mode auto` may fall back to `uvx markitdown` when available.

package/docs/firecrawl.md

@@ -12,7 +12,8 @@ Firecrawl is a fallback for sites that block direct HTML fetching or don’t ren
 
 - `off`: never use Firecrawl.
 - `auto` (default): use Firecrawl only when HTML extraction looks blocked/thin.
-- `always`: try Firecrawl first (falls back to HTML if Firecrawl is unavailable/empty).
+- `always`: try Firecrawl first for non-YouTube URLs (falls back to HTML if Firecrawl is unavailable/empty).
+  - YouTube URLs reject `--firecrawl always`; use `--youtube auto|web|yt-dlp|apify` instead.
 
 ## Extract default
 

package/docs/llm.md

@@ -27,6 +27,7 @@ installed, auto mode can use local CLI models via `cli.enabled` or implicit auto
 - `NVIDIA_API_KEY` (required for `nvidia/...` models; alias: `NGC_API_KEY`)
 - `NVIDIA_BASE_URL` (optional; override NVIDIA OpenAI-compatible API endpoint; default: `https://integrate.api.nvidia.com/v1`)
 - `OPENROUTER_API_KEY` (optional; required for `openrouter/...` models; also used when `OPENAI_BASE_URL` points to OpenRouter)
+- `GITHUB_TOKEN` / `GH_TOKEN` (required for `github-copilot/...` models via GitHub Models)
 - `Z_AI_API_KEY` (required for `zai/...` models; supports `ZAI_API_KEY` alias)
 - `Z_AI_BASE_URL` (optional; override default Z.AI base URL)
 - `GEMINI_API_KEY` (required for `google/...` models; also accepts `GOOGLE_GENERATIVE_AI_API_KEY` / `GOOGLE_API_KEY`)
@@ -34,7 +35,7 @@ installed, auto mode can use local CLI models via `cli.enabled` or implicit auto
 - `ANTHROPIC_API_KEY` (required for `anthropic/...` models)
 - `ANTHROPIC_BASE_URL` (optional; override Anthropic API endpoint)
 - `SUMMARIZE_MODEL` (optional; overrides default model selection)
-- `CLAUDE_PATH` / `CODEX_PATH` / `GEMINI_PATH` / `AGENT_PATH` (optional; override CLI binary paths)
+- `CLAUDE_PATH` / `CODEX_PATH` / `GEMINI_PATH` / `AGENT_PATH` / `OPENCLAW_PATH` / `OPENCODE_PATH` (optional; override CLI binary paths)
 
 ## Flags
 
@@ -44,8 +45,15 @@ installed, auto mode can use local CLI models via `cli.enabled` or implicit auto
     - `cli/claude/sonnet`
     - `cli/gemini/gemini-3-flash`
     - `cli/agent/gpt-5.2`
+    - `cli/openclaw/main`
+    - `cli/opencode/openai/gpt-5.4`
+    - `openai/gpt-5.4`
+    - `openai/gpt-5.4-mini`
+    - `openai/gpt-5.4-nano`
     - `google/gemini-3-flash`
     - `openai/gpt-5-mini`
+    - `openai/gpt-5-nano`
+    - `github-copilot/gpt-5.4`
     - `nvidia/z-ai/glm5`
     - `zai/glm-4.7`
     - `xai/grok-4-fast-non-reasoning`
@@ -53,7 +61,7 @@ installed, auto mode can use local CLI models via `cli.enabled` or implicit auto
     - `anthropic/claude-sonnet-4-5`
     - `openrouter/meta-llama/llama-3.3-70b-instruct:free` (force OpenRouter)
 - `--cli [provider]`
-  - Examples: `--cli claude`, `--cli Gemini`, `--cli codex`, `--cli agent` (equivalent to `--model cli/<provider>`); `--cli` alone uses auto selection with CLI enabled.
+  - Examples: `--cli claude`, `--cli Gemini`, `--cli codex`, `--cli agent`, `--cli openclaw`, `--cli opencode` (equivalent to `--model cli/<provider>`); `--cli` alone uses auto selection with CLI enabled.
 - `--model auto`
   - See `docs/model-auto.md`
 - `--model <preset>`
@@ -73,7 +81,8 @@ installed, auto mode can use local CLI models via `cli.enabled` or implicit auto
 - `--length short|medium|long|xl|xxl|<chars>`
   - This is _soft guidance_ to the model (no hard truncation).
   - Minimum numeric value: 50 chars.
-  - Default: `long`.
+  - Built-in default: `xl`.
+  - Config default: `output.length` in `~/.summarize/config.json`.
   - Output format is Markdown; use short paragraphs and only add bullets when they improve scanability.
 - `--force-summary`
   - Always run the LLM even when extracted content is shorter than the requested length.
@@ -98,6 +107,23 @@ installed, auto mode can use local CLI models via `cli.enabled` or implicit auto
 
 Use `--model zai/<model>` (e.g. `zai/glm-4.7`). Defaults to Z.AI’s base URL and uses chat completions.
 
+## GitHub Copilot / GitHub Models
+
+Use `--model github-copilot/<model>` for explicit GitHub-hosted model calls.
+
+- Examples:
+  - `github-copilot/gpt-5.4`
+  - `github-copilot/gpt-5.4-mini`
+  - `github-copilot/gpt-5.4-nano`
+  - `github-copilot/gpt-5-mini`
+  - `github-copilot/gpt-5-nano`
+  - `github-copilot/anthropic/claude-haiku-4.5`
+- Auth: `GITHUB_TOKEN` or `GH_TOKEN`
+- Transport: GitHub Models chat completions (`https://models.github.ai/inference`)
+- Notes:
+  - bare shorthand like `github-copilot/gpt-5.4` or `github-copilot/claude-opus-4.6` auto-expands to the provider-qualified backend id
+  - document attachments stay unsupported in this mode
+
 ## Input limits
 
 - Text prompts are checked against the model’s max input tokens (LiteLLM catalog) using a GPT tokenizer.

package/docs/media.md

@@ -28,6 +28,12 @@ read_when:
 - Remote transcription providers: `ASSEMBLYAI_API_KEY`, `GEMINI_API_KEY` / `GOOGLE_GENERATIVE_AI_API_KEY` / `GOOGLE_API_KEY`, `OPENAI_API_KEY`, `FAL_KEY` (plus `GROQ_API_KEY` before local/remote fallback).
 - Gemini uses the Files API automatically for larger uploads.
 
+## Shared helpers
+
+- Direct media classification lives in `packages/core/src/content/direct-media.ts`.
+- Local path/`file://` normalization + mtime lookup lives in `packages/core/src/content/local-file.ts`.
+- Slides, URL extraction, and transcription should reuse those helpers instead of re-parsing extensions separately.
+
 ## Chrome extension behavior
 
 - When media is detected on a page, the Summarize button gains a dropdown caret (Page/Video or Page/Audio).