@steipete/summarize 0.10.0 → 0.11.1

package/dist/esm/config.js

@@ -1,35 +1,82 @@
-import { readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import JSON5 from 'json5';
-import { isCliThemeName, listCliThemes } from './tty/theme.js';
+import JSON5 from "json5";
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { isCliThemeName, listCliThemes } from "./tty/theme.js";
 function isRecord(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
+    return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function parseOptionalBaseUrl(raw) {
-    return typeof raw === 'string' && raw.trim().length > 0 ? raw.trim() : undefined;
+    return typeof raw === "string" && raw.trim().length > 0 ? raw.trim() : undefined;
+}
+function resolveLegacyApiKeysEnv(apiKeys) {
+    if (!apiKeys)
+        return {};
+    const mapped = {};
+    if (typeof apiKeys.openai === "string")
+        mapped.OPENAI_API_KEY = apiKeys.openai;
+    if (typeof apiKeys.anthropic === "string")
+        mapped.ANTHROPIC_API_KEY = apiKeys.anthropic;
+    if (typeof apiKeys.google === "string")
+        mapped.GEMINI_API_KEY = apiKeys.google;
+    if (typeof apiKeys.xai === "string")
+        mapped.XAI_API_KEY = apiKeys.xai;
+    if (typeof apiKeys.openrouter === "string")
+        mapped.OPENROUTER_API_KEY = apiKeys.openrouter;
+    if (typeof apiKeys.zai === "string")
+        mapped.Z_AI_API_KEY = apiKeys.zai;
+    if (typeof apiKeys.apify === "string")
+        mapped.APIFY_API_TOKEN = apiKeys.apify;
+    if (typeof apiKeys.firecrawl === "string")
+        mapped.FIRECRAWL_API_KEY = apiKeys.firecrawl;
+    if (typeof apiKeys.fal === "string")
+        mapped.FAL_KEY = apiKeys.fal;
+    return mapped;
+}
+export function resolveConfigEnv(config) {
+    if (!config)
+        return {};
+    return {
+        ...resolveLegacyApiKeysEnv(config.apiKeys),
+        ...(config.env ?? {}),
+    };
+}
+export function mergeConfigEnv({ env, config, }) {
+    const configEnv = resolveConfigEnv(config);
+    if (Object.keys(configEnv).length === 0)
+        return env;
+    let changed = false;
+    const merged = { ...env };
+    for (const [key, value] of Object.entries(configEnv)) {
+        const current = merged[key];
+        if (typeof current === "string" && current.trim().length > 0)
+            continue;
+        merged[key] = value;
+        changed = true;
+    }
+    return changed ? merged : env;
 }
 function parseProviderBaseUrlConfig(raw, path, providerName) {
-    if (typeof raw === 'undefined')
+    if (typeof raw === "undefined")
         return undefined;
     if (!isRecord(raw)) {
         throw new Error(`Invalid config file ${path}: "${providerName}" must be an object.`);
     }
     const baseUrl = parseOptionalBaseUrl(raw.baseUrl);
-    return typeof baseUrl === 'string' ? { baseUrl } : undefined;
+    return typeof baseUrl === "string" ? { baseUrl } : undefined;
 }
 function parseAutoRuleKind(value) {
-    return value === 'text' ||
-        value === 'website' ||
-        value === 'youtube' ||
-        value === 'image' ||
-        value === 'video' ||
-        value === 'file'
+    return value === "text" ||
+        value === "website" ||
+        value === "youtube" ||
+        value === "image" ||
+        value === "video" ||
+        value === "file"
         ? value
         : null;
 }
 function parseCliProvider(value, path) {
-    const trimmed = typeof value === 'string' ? value.trim().toLowerCase() : '';
-    if (trimmed === 'claude' || trimmed === 'codex' || trimmed === 'gemini') {
+    const trimmed = typeof value === "string" ? value.trim().toLowerCase() : "";
+    if (trimmed === "claude" || trimmed === "codex" || trimmed === "gemini" || trimmed === "agent") {
         return trimmed;
     }
     throw new Error(`Invalid config file ${path}: unknown CLI provider "${String(value)}".`);
@@ -40,7 +87,7 @@ function parseStringArray(raw, path, label) {
     }
     const items = [];
     for (const entry of raw) {
-        if (typeof entry !== 'string') {
+        if (typeof entry !== "string") {
             throw new Error(`Invalid config file ${path}: "${label}" must be an array of strings.`);
         }
         const trimmed = entry.trim();
@@ -51,21 +98,21 @@ function parseStringArray(raw, path, label) {
     return items;
 }
 function parseLoggingLevel(raw, path) {
-    if (typeof raw !== 'string') {
+    if (typeof raw !== "string") {
         throw new Error(`Invalid config file ${path}: "logging.level" must be a string.`);
     }
     const trimmed = raw.trim().toLowerCase();
-    if (trimmed === 'debug' || trimmed === 'info' || trimmed === 'warn' || trimmed === 'error') {
+    if (trimmed === "debug" || trimmed === "info" || trimmed === "warn" || trimmed === "error") {
         return trimmed;
     }
     throw new Error(`Invalid config file ${path}: "logging.level" must be one of "debug", "info", "warn", "error".`);
 }
 function parseLoggingFormat(raw, path) {
-    if (typeof raw !== 'string') {
+    if (typeof raw !== "string") {
         throw new Error(`Invalid config file ${path}: "logging.format" must be a string.`);
     }
     const trimmed = raw.trim().toLowerCase();
-    if (trimmed === 'json' || trimmed === 'pretty') {
+    if (trimmed === "json" || trimmed === "pretty") {
         return trimmed;
     }
     throw new Error(`Invalid config file ${path}: "logging.format" must be one of "json" or "pretty".`);
@@ -86,12 +133,12 @@ function parseCliProviderConfig(raw, path, label) {
     if (!isRecord(raw)) {
         throw new Error(`Invalid config file ${path}: "cli.${label}" must be an object.`);
     }
-    if (typeof raw.enabled !== 'undefined') {
+    if (typeof raw.enabled !== "undefined") {
         throw new Error(`Invalid config file ${path}: "cli.${label}.enabled" is not supported. Use "cli.enabled" instead.`);
     }
-    const binaryValue = typeof raw.binary === 'string' ? raw.binary.trim() : undefined;
-    const modelValue = typeof raw.model === 'string' ? raw.model.trim() : undefined;
-    const extraArgs = typeof raw.extraArgs === 'undefined'
+    const binaryValue = typeof raw.binary === "string" ? raw.binary.trim() : undefined;
+    const modelValue = typeof raw.model === "string" ? raw.model.trim() : undefined;
+    const extraArgs = typeof raw.extraArgs === "undefined"
         ? undefined
         : parseStringArray(raw.extraArgs, path, `cli.${label}.extraArgs`);
     return {
@@ -100,6 +147,33 @@ function parseCliProviderConfig(raw, path, label) {
         ...(extraArgs && extraArgs.length > 0 ? { extraArgs } : {}),
     };
 }
+function parseCliAutoFallbackConfig(raw, path, label) {
+    if (!isRecord(raw)) {
+        throw new Error(`Invalid config file ${path}: "cli.${label}" must be an object.`);
+    }
+    const enabled = typeof raw.enabled === "boolean"
+        ? raw.enabled
+        : typeof raw.enabled === "undefined"
+            ? undefined
+            : (() => {
+                throw new Error(`Invalid config file ${path}: "cli.${label}.enabled" must be a boolean.`);
+            })();
+    const onlyWhenNoApiKeys = typeof raw.onlyWhenNoApiKeys === "boolean"
+        ? raw.onlyWhenNoApiKeys
+        : typeof raw.onlyWhenNoApiKeys === "undefined"
+            ? undefined
+            : (() => {
+                throw new Error(`Invalid config file ${path}: "cli.${label}.onlyWhenNoApiKeys" must be a boolean.`);
+            })();
+    const order = typeof raw.order === "undefined"
+        ? undefined
+        : parseCliProviderList(raw.order, path, `cli.${label}.order`);
+    return {
+        ...(typeof enabled === "boolean" ? { enabled } : {}),
+        ...(typeof onlyWhenNoApiKeys === "boolean" ? { onlyWhenNoApiKeys } : {}),
+        ...(Array.isArray(order) && order.length > 0 ? { order } : {}),
+    };
+}
 function parseWhenKinds(raw, path) {
     if (!Array.isArray(raw)) {
         throw new Error(`Invalid config file ${path}: "model.rules[].when" must be an array of kinds.`);
@@ -124,7 +198,7 @@ function parseModelCandidates(raw, path) {
     }
     const candidates = [];
     for (const entry of raw) {
-        if (typeof entry !== 'string') {
+        if (typeof entry !== "string") {
             throw new Error(`Invalid config file ${path}: "model.rules[].candidates" must be an array of strings.`);
         }
         const trimmed = entry.trim();
@@ -143,23 +217,23 @@ function parseTokenBand(raw, path) {
     }
     const candidates = parseModelCandidates(raw.candidates, path);
     const token = (() => {
-        if (typeof raw.token === 'undefined')
+        if (typeof raw.token === "undefined")
             return undefined;
         if (!isRecord(raw.token)) {
             throw new Error(`Invalid config file ${path}: "model.rules[].bands[].token" must be an object.`);
         }
-        const min = typeof raw.token.min === 'number' ? raw.token.min : undefined;
-        const max = typeof raw.token.max === 'number' ? raw.token.max : undefined;
-        if (typeof min === 'number' && (!Number.isFinite(min) || min < 0)) {
+        const min = typeof raw.token.min === "number" ? raw.token.min : undefined;
+        const max = typeof raw.token.max === "number" ? raw.token.max : undefined;
+        if (typeof min === "number" && (!Number.isFinite(min) || min < 0)) {
             throw new Error(`Invalid config file ${path}: "model.rules[].bands[].token.min" must be >= 0.`);
         }
-        if (typeof max === 'number' && (!Number.isFinite(max) || max < 0)) {
+        if (typeof max === "number" && (!Number.isFinite(max) || max < 0)) {
             throw new Error(`Invalid config file ${path}: "model.rules[].bands[].token.max" must be >= 0.`);
         }
-        if (typeof min === 'number' && typeof max === 'number' && min > max) {
+        if (typeof min === "number" && typeof max === "number" && min > max) {
             throw new Error(`Invalid config file ${path}: "model.rules[].bands[].token.min" must be <= "token.max".`);
         }
-        return typeof min === 'number' || typeof max === 'number' ? { min, max } : undefined;
+        return typeof min === "number" || typeof max === "number" ? { min, max } : undefined;
     })();
     return { ...(token ? { token } : {}), candidates };
 }
@@ -169,15 +243,15 @@ function assertNoComments(raw, path) {
     let line = 1;
     let col = 1;
     for (let i = 0; i < raw.length; i += 1) {
-        const ch = raw[i] ?? '';
-        const next = raw[i + 1] ?? '';
+        const ch = raw[i] ?? "";
+        const next = raw[i + 1] ?? "";
         if (inString) {
             if (escaped) {
                 escaped = false;
                 col += 1;
                 continue;
             }
-            if (ch === '\\') {
+            if (ch === "\\") {
                 escaped = true;
                 col += 1;
                 continue;
@@ -185,7 +259,7 @@ function assertNoComments(raw, path) {
             if (ch === inString) {
                 inString = null;
             }
-            if (ch === '\n') {
+            if (ch === "\n") {
                 line += 1;
                 col = 1;
             }
@@ -200,13 +274,13 @@ function assertNoComments(raw, path) {
             col += 1;
             continue;
         }
-        if (ch === '/' && next === '/') {
+        if (ch === "/" && next === "/") {
             throw new Error(`Invalid config file ${path}: comments are not allowed (found // at ${line}:${col}).`);
         }
-        if (ch === '/' && next === '*') {
+        if (ch === "/" && next === "*") {
             throw new Error(`Invalid config file ${path}: comments are not allowed (found /* at ${line}:${col}).`);
         }
-        if (ch === '\n') {
+        if (ch === "\n") {
             line += 1;
             col = 1;
         }
@@ -219,10 +293,10 @@ export function loadSummarizeConfig({ env }) {
     const home = env.HOME?.trim() || env.USERPROFILE?.trim() || null;
     if (!home)
         return { config: null, path: null };
-    const path = join(home, '.summarize', 'config.json');
+    const path = join(home, ".summarize", "config.json");
     let raw;
     try {
-        raw = readFileSync(path, 'utf8');
+        raw = readFileSync(path, "utf8");
     }
     catch {
         return { config: null, path };
@@ -240,21 +314,21 @@ export function loadSummarizeConfig({ env }) {
         throw new Error(`Invalid config file ${path}: expected an object at the top level`);
     }
     const parseModelConfig = (raw, label) => {
-        if (typeof raw === 'undefined')
+        if (typeof raw === "undefined")
             return undefined;
         // Shorthand:
         // - "auto" -> { mode: "auto" }
         // - "<provider>/<model>" or "openrouter/<provider>/<model>" -> { id: "..." }
         // - "<name>" -> { name: "<name>" }
-        if (typeof raw === 'string') {
+        if (typeof raw === "string") {
             const value = raw.trim();
             if (value.length === 0) {
                 throw new Error(`Invalid config file ${path}: "${label}" must not be empty.`);
             }
-            if (value.toLowerCase() === 'auto') {
-                return { mode: 'auto' };
+            if (value.toLowerCase() === "auto") {
+                return { mode: "auto" };
             }
-            if (value.includes('/')) {
+            if (value.includes("/")) {
                 return { id: value };
             }
             return { name: value };
@@ -262,30 +336,30 @@ export function loadSummarizeConfig({ env }) {
         if (!isRecord(raw)) {
             throw new Error(`Invalid config file ${path}: "${label}" must be an object.`);
         }
-        if (typeof raw.name === 'string') {
+        if (typeof raw.name === "string") {
             const name = raw.name.trim();
             if (name.length === 0) {
                 throw new Error(`Invalid config file ${path}: "${label}.name" must not be empty.`);
             }
-            if (name.toLowerCase() === 'auto') {
+            if (name.toLowerCase() === "auto") {
                 throw new Error(`Invalid config file ${path}: "${label}.name" must not be "auto".`);
             }
             return { name };
         }
-        if (typeof raw.id === 'string') {
+        if (typeof raw.id === "string") {
             const id = raw.id.trim();
             if (id.length === 0) {
                 throw new Error(`Invalid config file ${path}: "${label}.id" must not be empty.`);
             }
-            if (!id.includes('/')) {
+            if (!id.includes("/")) {
                 throw new Error(`Invalid config file ${path}: "${label}.id" must be provider-prefixed (e.g. "openai/gpt-5-mini").`);
             }
             return { id };
         }
-        const hasRules = typeof raw.rules !== 'undefined';
-        if (raw.mode === 'auto' || (!('mode' in raw) && hasRules)) {
+        const hasRules = typeof raw.rules !== "undefined";
+        if (raw.mode === "auto" || (!("mode" in raw) && hasRules)) {
             const rules = (() => {
-                if (typeof raw.rules === 'undefined')
+                if (typeof raw.rules === "undefined")
                     return undefined;
                 if (!Array.isArray(raw.rules)) {
                     throw new Error(`Invalid config file ${path}: "${label}.rules" must be an array.`);
@@ -294,9 +368,9 @@ export function loadSummarizeConfig({ env }) {
                 for (const entry of raw.rules) {
                     if (!isRecord(entry))
                         continue;
-                    const when = typeof entry.when === 'undefined' ? undefined : parseWhenKinds(entry.when, path);
-                    const hasCandidates = typeof entry.candidates !== 'undefined';
-                    const hasBands = typeof entry.bands !== 'undefined';
+                    const when = typeof entry.when === "undefined" ? undefined : parseWhenKinds(entry.when, path);
+                    const hasCandidates = typeof entry.candidates !== "undefined";
+                    const hasBands = typeof entry.bands !== "undefined";
                     if (hasCandidates && hasBands) {
                         throw new Error(`Invalid config file ${path}: "${label}.rules[]" must use either "candidates" or "bands" (not both).`);
                     }
@@ -317,18 +391,18 @@ export function loadSummarizeConfig({ env }) {
                 }
                 return rulesParsed;
             })();
-            return { mode: 'auto', ...(rules ? { rules } : {}) };
+            return { mode: "auto", ...(rules ? { rules } : {}) };
         }
         throw new Error(`Invalid config file ${path}: "${label}" must include either "id", "name", or { "mode": "auto" }.`);
     };
     const model = (() => {
-        return parseModelConfig(parsed.model, 'model');
+        return parseModelConfig(parsed.model, "model");
     })();
     const language = (() => {
         const value = parsed.language;
-        if (typeof value === 'undefined')
+        if (typeof value === "undefined")
             return undefined;
-        if (typeof value !== 'string') {
+        if (typeof value !== "string") {
             throw new Error(`Invalid config file ${path}: "language" must be a string.`);
         }
         const trimmed = value.trim();
@@ -339,9 +413,9 @@ export function loadSummarizeConfig({ env }) {
     })();
     const prompt = (() => {
         const value = parsed.prompt;
-        if (typeof value === 'undefined')
+        if (typeof value === "undefined")
             return undefined;
-        if (typeof value !== 'string') {
+        if (typeof value !== "string") {
             throw new Error(`Invalid config file ${path}: "prompt" must be a string.`);
         }
         const trimmed = value.trim();
@@ -352,11 +426,11 @@ export function loadSummarizeConfig({ env }) {
     })();
     const models = (() => {
         const root = parsed;
-        if (typeof root.bags !== 'undefined') {
+        if (typeof root.bags !== "undefined") {
             throw new Error(`Invalid config file ${path}: legacy key "bags" is no longer supported. Use "models" instead.`);
         }
         const raw = root.models;
-        if (typeof raw === 'undefined')
+        if (typeof raw === "undefined")
             return undefined;
         if (!isRecord(raw)) {
             throw new Error(`Invalid config file ${path}: "models" must be an object.`);
@@ -368,7 +442,7 @@ export function loadSummarizeConfig({ env }) {
             if (!key)
                 continue;
             const keyLower = key.toLowerCase();
-            if (keyLower === 'auto') {
+            if (keyLower === "auto") {
                 throw new Error(`Invalid config file ${path}: model name "auto" is reserved.`);
             }
             if (seen.has(keyLower)) {
@@ -377,13 +451,13 @@ export function loadSummarizeConfig({ env }) {
             if (/\s/.test(key)) {
                 throw new Error(`Invalid config file ${path}: model name "${key}" must not contain spaces.`);
             }
-            if (key.includes('/')) {
+            if (key.includes("/")) {
                 throw new Error(`Invalid config file ${path}: model name "${key}" must not include "/".`);
             }
             const parsedModel = parseModelConfig(value, `models.${key}`);
             if (!parsedModel)
                 continue;
-            if ('name' in parsedModel) {
+            if ("name" in parsedModel) {
                 throw new Error(`Invalid config file ${path}: "models.${key}" must not reference another model.`);
             }
             seen.add(keyLower);
@@ -393,90 +467,90 @@ export function loadSummarizeConfig({ env }) {
     })();
     const cache = (() => {
         const value = parsed.cache;
-        if (typeof value === 'undefined')
+        if (typeof value === "undefined")
             return undefined;
         if (!isRecord(value)) {
             throw new Error(`Invalid config file ${path}: "cache" must be an object.`);
         }
-        const enabled = typeof value.enabled === 'boolean' ? value.enabled : undefined;
+        const enabled = typeof value.enabled === "boolean" ? value.enabled : undefined;
         const maxMbRaw = value.maxMb;
-        const maxMb = typeof maxMbRaw === 'number' && Number.isFinite(maxMbRaw) && maxMbRaw > 0
+        const maxMb = typeof maxMbRaw === "number" && Number.isFinite(maxMbRaw) && maxMbRaw > 0
             ? maxMbRaw
-            : typeof maxMbRaw === 'undefined'
+            : typeof maxMbRaw === "undefined"
                 ? undefined
                 : (() => {
                     throw new Error(`Invalid config file ${path}: "cache.maxMb" must be a number.`);
                 })();
         const ttlDaysRaw = value.ttlDays;
-        const ttlDays = typeof ttlDaysRaw === 'number' && Number.isFinite(ttlDaysRaw) && ttlDaysRaw > 0
+        const ttlDays = typeof ttlDaysRaw === "number" && Number.isFinite(ttlDaysRaw) && ttlDaysRaw > 0
             ? ttlDaysRaw
-            : typeof ttlDaysRaw === 'undefined'
+            : typeof ttlDaysRaw === "undefined"
                 ? undefined
                 : (() => {
                     throw new Error(`Invalid config file ${path}: "cache.ttlDays" must be a number.`);
                 })();
-        const pathValue = typeof value.path === 'string' && value.path.trim().length > 0
+        const pathValue = typeof value.path === "string" && value.path.trim().length > 0
             ? value.path.trim()
-            : typeof value.path === 'undefined'
+            : typeof value.path === "undefined"
                 ? undefined
                 : (() => {
                     throw new Error(`Invalid config file ${path}: "cache.path" must be a string.`);
                 })();
         const media = (() => {
             const mediaValue = value.media;
-            if (typeof mediaValue === 'undefined')
+            if (typeof mediaValue === "undefined")
                 return undefined;
             if (!isRecord(mediaValue)) {
                 throw new Error(`Invalid config file ${path}: "cache.media" must be an object.`);
             }
-            const mediaEnabled = typeof mediaValue.enabled === 'boolean' ? mediaValue.enabled : undefined;
+            const mediaEnabled = typeof mediaValue.enabled === "boolean" ? mediaValue.enabled : undefined;
             const mediaMaxRaw = mediaValue.maxMb;
-            const mediaMaxMb = typeof mediaMaxRaw === 'number' && Number.isFinite(mediaMaxRaw) && mediaMaxRaw > 0
+            const mediaMaxMb = typeof mediaMaxRaw === "number" && Number.isFinite(mediaMaxRaw) && mediaMaxRaw > 0
                 ? mediaMaxRaw
-                : typeof mediaMaxRaw === 'undefined'
+                : typeof mediaMaxRaw === "undefined"
                     ? undefined
                     : (() => {
                         throw new Error(`Invalid config file ${path}: "cache.media.maxMb" must be a number.`);
                     })();
             const mediaTtlRaw = mediaValue.ttlDays;
-            const mediaTtlDays = typeof mediaTtlRaw === 'number' && Number.isFinite(mediaTtlRaw) && mediaTtlRaw > 0
+            const mediaTtlDays = typeof mediaTtlRaw === "number" && Number.isFinite(mediaTtlRaw) && mediaTtlRaw > 0
                 ? mediaTtlRaw
-                : typeof mediaTtlRaw === 'undefined'
+                : typeof mediaTtlRaw === "undefined"
                     ? undefined
                     : (() => {
                         throw new Error(`Invalid config file ${path}: "cache.media.ttlDays" must be a number.`);
                     })();
-            const mediaPath = typeof mediaValue.path === 'string' && mediaValue.path.trim().length > 0
+            const mediaPath = typeof mediaValue.path === "string" && mediaValue.path.trim().length > 0
                 ? mediaValue.path.trim()
-                : typeof mediaValue.path === 'undefined'
+                : typeof mediaValue.path === "undefined"
                     ? undefined
                     : (() => {
                         throw new Error(`Invalid config file ${path}: "cache.media.path" must be a string.`);
                     })();
-            const verifyRaw = typeof mediaValue.verify === 'string' ? mediaValue.verify.trim().toLowerCase() : '';
-            const verify = verifyRaw === 'none' || verifyRaw === 'size' || verifyRaw === 'hash'
+            const verifyRaw = typeof mediaValue.verify === "string" ? mediaValue.verify.trim().toLowerCase() : "";
+            const verify = verifyRaw === "none" || verifyRaw === "size" || verifyRaw === "hash"
                 ? verifyRaw
                 : verifyRaw.length > 0
                     ? (() => {
                         throw new Error(`Invalid config file ${path}: "cache.media.verify" must be one of "none", "size", "hash".`);
                     })()
                     : undefined;
-            return mediaEnabled || mediaMaxMb || mediaTtlDays || mediaPath || typeof verify === 'string'
+            return mediaEnabled || mediaMaxMb || mediaTtlDays || mediaPath || typeof verify === "string"
                 ? {
-                    ...(typeof mediaEnabled === 'boolean' ? { enabled: mediaEnabled } : {}),
-                    ...(typeof mediaMaxMb === 'number' ? { maxMb: mediaMaxMb } : {}),
-                    ...(typeof mediaTtlDays === 'number' ? { ttlDays: mediaTtlDays } : {}),
-                    ...(typeof mediaPath === 'string' ? { path: mediaPath } : {}),
-                    ...(typeof verify === 'string' ? { verify } : {}),
+                    ...(typeof mediaEnabled === "boolean" ? { enabled: mediaEnabled } : {}),
+                    ...(typeof mediaMaxMb === "number" ? { maxMb: mediaMaxMb } : {}),
+                    ...(typeof mediaTtlDays === "number" ? { ttlDays: mediaTtlDays } : {}),
+                    ...(typeof mediaPath === "string" ? { path: mediaPath } : {}),
+                    ...(typeof verify === "string" ? { verify } : {}),
                 }
                 : undefined;
         })();
         return enabled || maxMb || ttlDays || pathValue || media
             ? {
-                ...(typeof enabled === 'boolean' ? { enabled } : {}),
-                ...(typeof maxMb === 'number' ? { maxMb } : {}),
-                ...(typeof ttlDays === 'number' ? { ttlDays } : {}),
-                ...(typeof pathValue === 'string' ? { path: pathValue } : {}),
+                ...(typeof enabled === "boolean" ? { enabled } : {}),
+                ...(typeof maxMb === "number" ? { maxMb } : {}),
+                ...(typeof ttlDays === "number" ? { ttlDays } : {}),
+                ...(typeof pathValue === "string" ? { path: pathValue } : {}),
                 ...(media ? { media } : {}),
             }
             : undefined;
@@ -485,69 +559,69 @@ export function loadSummarizeConfig({ env }) {
         const value = parsed.media;
         if (!isRecord(value))
             return undefined;
-        const videoMode = value.videoMode === 'auto' ||
-            value.videoMode === 'transcript' ||
-            value.videoMode === 'understand'
+        const videoMode = value.videoMode === "auto" ||
+            value.videoMode === "transcript" ||
+            value.videoMode === "understand"
             ? value.videoMode
             : undefined;
         return videoMode ? { videoMode } : undefined;
     })();
     const slides = (() => {
         const value = parsed.slides;
-        if (typeof value === 'undefined')
+        if (typeof value === "undefined")
             return undefined;
         if (!isRecord(value)) {
             throw new Error(`Invalid config file ${path}: "slides" must be an object.`);
         }
-        const enabled = typeof value.enabled === 'boolean' ? value.enabled : undefined;
-        const ocr = typeof value.ocr === 'boolean' ? value.ocr : undefined;
-        const dir = typeof value.dir === 'string' && value.dir.trim().length > 0
+        const enabled = typeof value.enabled === "boolean" ? value.enabled : undefined;
+        const ocr = typeof value.ocr === "boolean" ? value.ocr : undefined;
+        const dir = typeof value.dir === "string" && value.dir.trim().length > 0
             ? value.dir.trim()
-            : typeof value.dir === 'undefined'
+            : typeof value.dir === "undefined"
                 ? undefined
                 : (() => {
                     throw new Error(`Invalid config file ${path}: "slides.dir" must be a string.`);
                 })();
         const sceneRaw = value.sceneThreshold;
-        const sceneThreshold = typeof sceneRaw === 'number' && Number.isFinite(sceneRaw) && sceneRaw >= 0.1 && sceneRaw <= 1
+        const sceneThreshold = typeof sceneRaw === "number" && Number.isFinite(sceneRaw) && sceneRaw >= 0.1 && sceneRaw <= 1
             ? sceneRaw
-            : typeof sceneRaw === 'undefined'
+            : typeof sceneRaw === "undefined"
                 ? undefined
                 : (() => {
                     throw new Error(`Invalid config file ${path}: "slides.sceneThreshold" must be a number between 0.1 and 1.0.`);
                 })();
         const maxRaw = value.max;
-        const max = typeof maxRaw === 'number' &&
+        const max = typeof maxRaw === "number" &&
             Number.isFinite(maxRaw) &&
             Number.isInteger(maxRaw) &&
             maxRaw > 0
             ? maxRaw
-            : typeof maxRaw === 'undefined'
+            : typeof maxRaw === "undefined"
                 ? undefined
                 : (() => {
                     throw new Error(`Invalid config file ${path}: "slides.max" must be an integer.`);
                 })();
         const minRaw = value.minDuration;
-        const minDuration = typeof minRaw === 'number' && Number.isFinite(minRaw) && minRaw >= 0
+        const minDuration = typeof minRaw === "number" && Number.isFinite(minRaw) && minRaw >= 0
             ? minRaw
-            : typeof minRaw === 'undefined'
+            : typeof minRaw === "undefined"
                 ? undefined
                 : (() => {
                     throw new Error(`Invalid config file ${path}: "slides.minDuration" must be a number.`);
                 })();
         return enabled ||
-            typeof ocr === 'boolean' ||
+            typeof ocr === "boolean" ||
             dir ||
-            typeof sceneThreshold === 'number' ||
-            typeof max === 'number' ||
-            typeof minDuration === 'number'
+            typeof sceneThreshold === "number" ||
+            typeof max === "number" ||
+            typeof minDuration === "number"
             ? {
-                ...(typeof enabled === 'boolean' ? { enabled } : {}),
-                ...(typeof ocr === 'boolean' ? { ocr } : {}),
-                ...(typeof dir === 'string' ? { dir } : {}),
-                ...(typeof sceneThreshold === 'number' ? { sceneThreshold } : {}),
-                ...(typeof max === 'number' ? { max } : {}),
-                ...(typeof minDuration === 'number' ? { minDuration } : {}),
+                ...(typeof enabled === "boolean" ? { enabled } : {}),
+                ...(typeof ocr === "boolean" ? { ocr } : {}),
+                ...(typeof dir === "string" ? { dir } : {}),
+                ...(typeof sceneThreshold === "number" ? { sceneThreshold } : {}),
+                ...(typeof max === "number" ? { max } : {}),
+                ...(typeof minDuration === "number" ? { minDuration } : {}),
             }
             : undefined;
     })();
@@ -555,29 +629,44 @@ export function loadSummarizeConfig({ env }) {
         const value = parsed.cli;
         if (!isRecord(value))
             return undefined;
-        if (typeof value.disabled !== 'undefined') {
+        if (typeof value.disabled !== "undefined") {
             throw new Error(`Invalid config file ${path}: "cli.disabled" is not supported. Use "cli.enabled" instead.`);
         }
-        const enabled = typeof value.enabled !== 'undefined'
-            ? parseCliProviderList(value.enabled, path, 'cli.enabled')
+        const enabled = typeof value.enabled !== "undefined"
+            ? parseCliProviderList(value.enabled, path, "cli.enabled")
             : undefined;
-        const claude = value.claude ? parseCliProviderConfig(value.claude, path, 'claude') : undefined;
-        const codex = value.codex ? parseCliProviderConfig(value.codex, path, 'codex') : undefined;
-        const gemini = value.gemini ? parseCliProviderConfig(value.gemini, path, 'gemini') : undefined;
-        const promptOverride = typeof value.promptOverride === 'string' && value.promptOverride.trim().length > 0
+        const claude = value.claude ? parseCliProviderConfig(value.claude, path, "claude") : undefined;
+        const codex = value.codex ? parseCliProviderConfig(value.codex, path, "codex") : undefined;
+        const gemini = value.gemini ? parseCliProviderConfig(value.gemini, path, "gemini") : undefined;
+        const agent = value.agent ? parseCliProviderConfig(value.agent, path, "agent") : undefined;
+        if (typeof value.autoFallback !== "undefined" && typeof value.magicAuto !== "undefined") {
+            throw new Error(`Invalid config file ${path}: use only one of "cli.autoFallback" or legacy "cli.magicAuto".`);
+        }
+        const autoFallback = (() => {
+            if (typeof value.autoFallback !== "undefined") {
+                return parseCliAutoFallbackConfig(value.autoFallback, path, "autoFallback");
+            }
+            if (typeof value.magicAuto !== "undefined") {
+                return parseCliAutoFallbackConfig(value.magicAuto, path, "magicAuto");
+            }
+            return undefined;
+        })();
+        const promptOverride = typeof value.promptOverride === "string" && value.promptOverride.trim().length > 0
             ? value.promptOverride.trim()
             : undefined;
-        const allowTools = typeof value.allowTools === 'boolean' ? value.allowTools : undefined;
-        const cwd = typeof value.cwd === 'string' && value.cwd.trim().length > 0 ? value.cwd.trim() : undefined;
-        const extraArgs = typeof value.extraArgs === 'undefined'
+        const allowTools = typeof value.allowTools === "boolean" ? value.allowTools : undefined;
+        const cwd = typeof value.cwd === "string" && value.cwd.trim().length > 0 ? value.cwd.trim() : undefined;
+        const extraArgs = typeof value.extraArgs === "undefined"
             ? undefined
-            : parseStringArray(value.extraArgs, path, 'cli.extraArgs');
+            : parseStringArray(value.extraArgs, path, "cli.extraArgs");
         return enabled ||
             claude ||
             codex ||
             gemini ||
+            agent ||
+            autoFallback ||
             promptOverride ||
-            typeof allowTools === 'boolean' ||
+            typeof allowTools === "boolean" ||
             cwd ||
             (extraArgs && extraArgs.length > 0)
             ? {
@@ -585,8 +674,10 @@ export function loadSummarizeConfig({ env }) {
                 ...(claude ? { claude } : {}),
                 ...(codex ? { codex } : {}),
                 ...(gemini ? { gemini } : {}),
+                ...(agent ? { agent } : {}),
+                ...(autoFallback ? { autoFallback } : {}),
                 ...(promptOverride ? { promptOverride } : {}),
-                ...(typeof allowTools === 'boolean' ? { allowTools } : {}),
+                ...(typeof allowTools === "boolean" ? { allowTools } : {}),
                 ...(cwd ? { cwd } : {}),
                 ...(extraArgs && extraArgs.length > 0 ? { extraArgs } : {}),
             }
@@ -594,59 +685,59 @@ export function loadSummarizeConfig({ env }) {
     })();
     const output = (() => {
         const value = parsed.output;
-        if (typeof value === 'undefined')
+        if (typeof value === "undefined")
             return undefined;
         if (!isRecord(value)) {
             throw new Error(`Invalid config file ${path}: "output" must be an object.`);
         }
-        const language = typeof value.language === 'string' && value.language.trim().length > 0
+        const language = typeof value.language === "string" && value.language.trim().length > 0
             ? value.language.trim()
             : undefined;
-        return typeof language === 'string' ? { language } : undefined;
+        return typeof language === "string" ? { language } : undefined;
     })();
     const ui = (() => {
         const value = parsed.ui;
-        if (typeof value === 'undefined')
+        if (typeof value === "undefined")
             return undefined;
         if (!isRecord(value)) {
             throw new Error(`Invalid config file ${path}: "ui" must be an object.`);
         }
-        const themeRaw = typeof value.theme === 'string' ? value.theme.trim().toLowerCase() : '';
+        const themeRaw = typeof value.theme === "string" ? value.theme.trim().toLowerCase() : "";
         if (themeRaw && !isCliThemeName(themeRaw)) {
-            throw new Error(`Invalid config file ${path}: "ui.theme" must be one of ${listCliThemes().join(', ')}.`);
+            throw new Error(`Invalid config file ${path}: "ui.theme" must be one of ${listCliThemes().join(", ")}.`);
         }
         const theme = themeRaw.length > 0 ? themeRaw : undefined;
         return theme ? { theme } : undefined;
     })();
     const logging = (() => {
         const value = parsed.logging;
-        if (typeof value === 'undefined')
+        if (typeof value === "undefined")
             return undefined;
         if (!isRecord(value)) {
             throw new Error(`Invalid config file ${path}: "logging" must be an object.`);
         }
-        const enabled = typeof value.enabled === 'boolean' ? value.enabled : undefined;
-        const level = typeof value.level === 'undefined' ? undefined : parseLoggingLevel(value.level, path);
-        const format = typeof value.format === 'undefined' ? undefined : parseLoggingFormat(value.format, path);
-        const file = typeof value.file === 'string' && value.file.trim().length > 0
+        const enabled = typeof value.enabled === "boolean" ? value.enabled : undefined;
+        const level = typeof value.level === "undefined" ? undefined : parseLoggingLevel(value.level, path);
+        const format = typeof value.format === "undefined" ? undefined : parseLoggingFormat(value.format, path);
+        const file = typeof value.file === "string" && value.file.trim().length > 0
             ? value.file.trim()
-            : typeof value.file === 'undefined'
+            : typeof value.file === "undefined"
                 ? undefined
                 : (() => {
                     throw new Error(`Invalid config file ${path}: "logging.file" must be a string.`);
                 })();
         const maxMbRaw = value.maxMb;
-        const maxMb = typeof maxMbRaw === 'number' && Number.isFinite(maxMbRaw) && maxMbRaw > 0
+        const maxMb = typeof maxMbRaw === "number" && Number.isFinite(maxMbRaw) && maxMbRaw > 0
             ? maxMbRaw
-            : typeof maxMbRaw === 'undefined'
+            : typeof maxMbRaw === "undefined"
                 ? undefined
                 : (() => {
                     throw new Error(`Invalid config file ${path}: "logging.maxMb" must be a number.`);
                 })();
         const maxFilesRaw = value.maxFiles;
-        const maxFiles = typeof maxFilesRaw === 'number' && Number.isFinite(maxFilesRaw) && maxFilesRaw > 0
+        const maxFiles = typeof maxFilesRaw === "number" && Number.isFinite(maxFilesRaw) && maxFilesRaw > 0
             ? Math.trunc(maxFilesRaw)
-            : typeof maxFilesRaw === 'undefined'
+            : typeof maxFilesRaw === "undefined"
                 ? undefined
                 : (() => {
                     throw new Error(`Invalid config file ${path}: "logging.maxFiles" must be a number.`);
@@ -655,46 +746,97 @@ export function loadSummarizeConfig({ env }) {
             level ||
             format ||
             file ||
-            typeof maxMb === 'number' ||
-            typeof maxFiles === 'number'
+            typeof maxMb === "number" ||
+            typeof maxFiles === "number"
             ? {
-                ...(typeof enabled === 'boolean' ? { enabled } : {}),
+                ...(typeof enabled === "boolean" ? { enabled } : {}),
                 ...(level ? { level } : {}),
                 ...(format ? { format } : {}),
                 ...(file ? { file } : {}),
-                ...(typeof maxMb === 'number' ? { maxMb } : {}),
-                ...(typeof maxFiles === 'number' ? { maxFiles } : {}),
+                ...(typeof maxMb === "number" ? { maxMb } : {}),
+                ...(typeof maxFiles === "number" ? { maxFiles } : {}),
             }
             : undefined;
     })();
     const openai = (() => {
         const value = parsed.openai;
-        if (typeof value === 'undefined')
+        if (typeof value === "undefined")
             return undefined;
         if (!isRecord(value)) {
             throw new Error(`Invalid config file ${path}: "openai" must be an object.`);
         }
         const baseUrl = parseOptionalBaseUrl(value.baseUrl);
-        const useChatCompletions = typeof value.useChatCompletions === 'boolean' ? value.useChatCompletions : undefined;
+        const useChatCompletions = typeof value.useChatCompletions === "boolean" ? value.useChatCompletions : undefined;
         const whisperUsdPerMinuteRaw = value.whisperUsdPerMinute;
-        const whisperUsdPerMinute = typeof whisperUsdPerMinuteRaw === 'number' &&
+        const whisperUsdPerMinute = typeof whisperUsdPerMinuteRaw === "number" &&
             Number.isFinite(whisperUsdPerMinuteRaw) &&
             whisperUsdPerMinuteRaw > 0
             ? whisperUsdPerMinuteRaw
             : undefined;
-        return typeof baseUrl === 'string' ||
-            typeof useChatCompletions === 'boolean' ||
-            typeof whisperUsdPerMinute === 'number'
+        return typeof baseUrl === "string" ||
+            typeof useChatCompletions === "boolean" ||
+            typeof whisperUsdPerMinute === "number"
             ? {
-                ...(typeof baseUrl === 'string' ? { baseUrl } : {}),
-                ...(typeof useChatCompletions === 'boolean' ? { useChatCompletions } : {}),
-                ...(typeof whisperUsdPerMinute === 'number' ? { whisperUsdPerMinute } : {}),
+                ...(typeof baseUrl === "string" ? { baseUrl } : {}),
+                ...(typeof useChatCompletions === "boolean" ? { useChatCompletions } : {}),
+                ...(typeof whisperUsdPerMinute === "number" ? { whisperUsdPerMinute } : {}),
             }
             : undefined;
     })();
-    const anthropic = parseProviderBaseUrlConfig(parsed.anthropic, path, 'anthropic');
-    const google = parseProviderBaseUrlConfig(parsed.google, path, 'google');
-    const xai = parseProviderBaseUrlConfig(parsed.xai, path, 'xai');
+    const anthropic = parseProviderBaseUrlConfig(parsed.anthropic, path, "anthropic");
+    const google = parseProviderBaseUrlConfig(parsed.google, path, "google");
+    const xai = parseProviderBaseUrlConfig(parsed.xai, path, "xai");
+    const configEnv = (() => {
+        const value = parsed.env;
+        if (typeof value === "undefined")
+            return undefined;
+        if (!isRecord(value)) {
+            throw new Error(`Invalid config file ${path}: "env" must be an object.`);
+        }
+        const env = {};
+        for (const [rawKey, rawValue] of Object.entries(value)) {
+            const key = rawKey.trim();
+            if (key.length === 0) {
+                throw new Error(`Invalid config file ${path}: "env" contains an empty key.`);
+            }
+            if (typeof rawValue !== "string") {
+                throw new Error(`Invalid config file ${path}: "env.${rawKey}" must be a string.`);
+            }
+            env[key] = rawValue;
+        }
+        return Object.keys(env).length > 0 ? env : undefined;
+    })();
+    const apiKeys = (() => {
+        const value = parsed.apiKeys;
+        if (typeof value === "undefined")
+            return undefined;
+        if (!isRecord(value)) {
+            throw new Error(`Invalid config file ${path}: "apiKeys" must be an object.`);
+        }
+        const keys = {};
+        const allowed = [
+            "openai",
+            "anthropic",
+            "google",
+            "xai",
+            "openrouter",
+            "zai",
+            "apify",
+            "firecrawl",
+            "fal",
+        ];
+        for (const [key, val] of Object.entries(value)) {
+            const k = key.trim().toLowerCase();
+            if (!allowed.includes(k)) {
+                throw new Error(`Invalid config file ${path}: unknown apiKeys provider "${key}".`);
+            }
+            if (typeof val !== "string" || val.trim().length === 0) {
+                throw new Error(`Invalid config file ${path}: "apiKeys.${key}" must be a non-empty string.`);
+            }
+            keys[k] = val.trim();
+        }
+        return Object.keys(keys).length > 0 ? keys : undefined;
+    })();
     return {
         config: {
             ...(model ? { model } : {}),
@@ -712,6 +854,8 @@ export function loadSummarizeConfig({ env }) {
             ...(google ? { google } : {}),
             ...(xai ? { xai } : {}),
             ...(logging ? { logging } : {}),
+            ...(configEnv ? { env: configEnv } : {}),
+            ...(apiKeys ? { apiKeys } : {}),
         },
         path,
     };