@co0ontty/wand 4.23.0 → 4.24.0

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "commit": "2814c6ba1030b82a600d3f42d74befdf60801e4c",
-  "builtAt": "2026-07-24T23:00:20.185Z",
-  "version": "4.23.0",
+  "commit": "090ceecd30c3ef681295a17b38285bb22d37ce54",
+  "builtAt": "2026-07-25T01:03:54.326Z",
+  "version": "4.24.0",
   "channel": "stable"
 }

package/dist/claude-sdk-runner.d.ts

@@ -1,3 +1,4 @@
+import { type Options as SdkOptions } from "@anthropic-ai/claude-agent-sdk";
 export type ClaudeRunErrorCode = "CLAUDE_CLI_MISSING" | "CLAUDE_TIMEOUT" | "CLAUDE_CLI_FAILED" | "CLAUDE_EMPTY_RESULT";
 export declare class ClaudeRunError extends Error {
     readonly code: ClaudeRunErrorCode;
@@ -8,6 +9,8 @@ export interface RunClaudePrintOptions {
     timeoutMs: number;
     /** Optional Claude model id / alias. Empty or "default" keeps Claude Code's own default. */
     model?: string;
+    /** Optional adaptive-thinking effort, aligned with the active Claude session. */
+    effort?: SdkOptions["effort"];
     /**
      * 用户偏好的回复语言（取自 config.language）。传进来时会以
      * `appendSystemPrompt` 形式灌给 Claude，保证 quick-commit / prompt-optimizer

package/dist/claude-sdk-runner.js

@@ -129,6 +129,7 @@ export async function runClaudePrint(prompt, options) {
         ...(sdkClaudeBinary ? { pathToClaudeCodeExecutable: sdkClaudeBinary } : {}),
         ...(languageDirective ? { appendSystemPrompt: languageDirective } : {}),
         ...(model && model !== "default" ? { model } : {}),
+        ...(options.effort ? { effort: options.effort } : {}),
     };
     // 单条 user message → AsyncGenerator，SDK 的 streaming input 协议要求。
     async function* singleShot() {

package/dist/config.d.ts

@@ -40,8 +40,12 @@ export declare function applyStoragePreferences(config: WandConfig, storage: Wan
 export declare function writePreferenceToStorage(config: WandConfig, storage: WandStorage, key: PreferenceKey, value: unknown, options?: {
     deferCommitAiValidation?: boolean;
 }): void;
-/** Validate the cross-field contract for Commit's direct-API source. */
-export declare function validateCommitAiConfig(config: Pick<WandConfig, "commitAiSource" | "systemAi">): void;
+/**
+ * Kept as a compatibility seam for callers that validate preference batches.
+ * Commit API profiles are discovered from the configured tools at request time,
+ * so selecting API is valid even when no manual systemAi profile is stored.
+ */
+export declare function validateCommitAiConfig(_config: Pick<WandConfig, "commitAiSource" | "systemAi">): void;
 export declare function normalizeCardDefaults(input: unknown): CardExpandDefaults;
 export declare function isExecutionMode(value: unknown): value is ExecutionMode;
 export declare function getProviderDefaultModels(config: Pick<WandConfig, "defaultModel" | "defaultCodexModel" | "defaultOpenCodeModel" | "defaultGrokModel" | "defaultQoderModel">): {

package/dist/config.js

@@ -4,7 +4,7 @@ import { chmod, mkdir, readFile, rename, unlink, writeFile } from "node:fs/promi
 import path from "node:path";
 import process from "node:process";
 import { isRunningAsRoot } from "./env-utils.js";
-import { normalizeSystemAiConfig, systemAiProfiles } from "./system-ai.js";
+import { normalizeSystemAiConfig } from "./system-ai.js";
 function isThinkingEffort(value) {
     return value === "off"
         || value === "standard"
@@ -509,14 +509,12 @@ export function writePreferenceToStorage(config, storage, key, value, options =
         }
     }
 }
-/** Validate the cross-field contract for Commit's direct-API source. */
-export function validateCommitAiConfig(config) {
-    if (config.commitAiSource !== "api")
-        return;
-    if (!systemAiProfiles(config.systemAi, true).length) {
-        throw new Error("选择直连 API 生成 Commit 时，必须先填写 API 地址、API Key 和模型。");
-    }
-}
+/**
+ * Kept as a compatibility seam for callers that validate preference batches.
+ * Commit API profiles are discovered from the configured tools at request time,
+ * so selecting API is valid even when no manual systemAi profile is stored.
+ */
+export function validateCommitAiConfig(_config) { }
 function defaultCardExpandDefaults() {
     return {
         editCards: false,

package/dist/git-quick-commit.d.ts

@@ -10,8 +10,6 @@ interface QuickCommitOptions {
     model?: string | null;
     thinkingEffort?: SessionSnapshot["thinkingEffort"];
     inheritEnv?: boolean;
-    /** Direct API to try when the selected Commit source is a CLI. */
-    fallbackSystemAi?: import("./types.js").SystemAiConfig;
     systemAi?: import("./types.js").SystemAiConfig;
     autoMessage: boolean;
     customMessage?: string;
@@ -30,7 +28,6 @@ export interface QuickCommitAiOptions {
     model?: string | null;
     thinkingEffort?: SessionSnapshot["thinkingEffort"];
     inheritEnv?: boolean;
-    fallbackSystemAi?: import("./types.js").SystemAiConfig;
     systemAi?: import("./types.js").SystemAiConfig;
 }
 export declare class QuickCommitError extends Error {
@@ -38,8 +35,9 @@ export declare class QuickCommitError extends Error {
     constructor(message: string, code: QuickCommitErrorCode);
 }
 /**
- * Run a lightweight AI request through the same source ordering used by quick
- * commit: the user's selected source first, then the reciprocal source once.
+ * Run a lightweight AI request through the selected Commit source. API mode
+ * exhausts its profile chain and then falls back once to the current-session
+ * CLI. CLI mode uses only that CLI.
  */
 export declare function callConfiguredAiText(prompt: string, cwd: string, language: string, opts: QuickCommitAiOptions): Promise<string>;
 export interface GenerateCommitMessageResult {
@@ -55,7 +53,6 @@ interface TagHeadOptions {
     model?: string | null;
     thinkingEffort?: SessionSnapshot["thinkingEffort"];
     inheritEnv?: boolean;
-    fallbackSystemAi?: import("./types.js").SystemAiConfig;
     systemAi?: import("./types.js").SystemAiConfig;
     /** Explicit tag name. If empty and `autoTag` is true, ask the session provider to generate one. */
     tag?: string;

package/dist/git-quick-commit.js

@@ -4,7 +4,7 @@ import { ClaudeRunError, runClaudePrint } from "./claude-sdk-runner.js";
 import { callSystemAiTextWithFallback } from "./system-ai.js";
 import { buildChildEnv } from "./env-utils.js";
 import { runGit as runGitBase, runGitAsync as runGitAsyncBase, runGitRaw as runGitRawBase, runGitRawAsync as runGitRawAsyncBase, getGitErrorMessage, } from "./git-utils.js";
-import { thinkingEffortToClaudeCliEffort, thinkingEffortToCodexReasoningEffort, thinkingEffortToOpenCodeVariant } from "./structured-provider-common.js";
+import { thinkingEffortToClaudeCliEffort, thinkingEffortToCodexReasoningEffort, thinkingEffortToGrokEffort, thinkingEffortToOpenCodeVariant, thinkingEffortToQoderEffort, } from "./structured-provider-common.js";
 const GIT_TIMEOUT_MS = 1500;
 const GIT_PUSH_TIMEOUT_MS = 30_000;
 const MAX_FILE_ENTRIES = 200;
@@ -12,6 +12,10 @@ const MAX_FILE_ENTRIES = 200;
 // 30s 在 API 抖动时不够用，放宽到 60s。
 const CLAUDE_MESSAGE_TIMEOUT_MS = 60_000;
 const CODEX_MESSAGE_TIMEOUT_MS = 60_000;
+// API mode can contain several profiles. Keep each probe bounded so the whole
+// chain can still reach the current-session CLI before native clients' 180s
+// request deadline.
+const DIRECT_API_PROFILE_TIMEOUT_MS = 20_000;
 const QUICK_COMMIT_CLI_TIMEOUT_MS = 120_000;
 const MAX_DIFF_FOR_AI = 100_000;
 const GIT_MAX_BUFFER = 16 * 1024 * 1024;
@@ -454,9 +458,16 @@ export class QuickCommitError extends Error {
     }
 }
 // ── AI commit message generation ──
-async function callClaudeText(prompt, cwd, language, model) {
+async function callClaudeText(prompt, cwd, language, opts) {
     try {
-        return await runClaudePrint(prompt, { cwd, timeoutMs: CLAUDE_MESSAGE_TIMEOUT_MS, language, model: model ?? undefined });
+        const effort = thinkingEffortToClaudeCliEffort(opts.thinkingEffort ?? "off");
+        return await runClaudePrint(prompt, {
+            cwd,
+            timeoutMs: CLAUDE_MESSAGE_TIMEOUT_MS,
+            language,
+            model: opts.model ?? undefined,
+            ...(effort ? { effort } : {}),
+        });
     }
     catch (error) {
         if (error instanceof ClaudeRunError) {
@@ -473,7 +484,12 @@ async function callClaudeText(prompt, cwd, language, model) {
     }
 }
 function normalizeProvider(provider) {
-    return provider === "codex" || provider === "opencode" ? provider : "claude";
+    return provider === "codex"
+        || provider === "opencode"
+        || provider === "grok"
+        || provider === "qoder"
+        ? provider
+        : "claude";
 }
 function stripFences(raw) {
     return raw.trim().replace(/^```(?:json)?\s*/i, "").replace(/\s*```$/i, "").trim();
@@ -525,6 +541,77 @@ function extractOpenCodeText(stdout) {
     }
     return texts.join("\n").trim();
 }
+function extractGrokText(stdout) {
+    let text = "";
+    for (const line of stdout.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith("{"))
+            continue;
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (parsed.type === "text" && typeof parsed.data === "string")
+                text += parsed.data;
+        }
+        catch {
+            // ignore diagnostics mixed into stdout
+        }
+    }
+    return text.trim();
+}
+function extractQoderText(stdout) {
+    let resultText = "";
+    const assistantTexts = [];
+    for (const line of stdout.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith("{"))
+            continue;
+        try {
+            const parsed = JSON.parse(trimmed);
+            if (parsed.type === "result" && parsed.subtype === "success" && typeof parsed.result === "string") {
+                resultText = parsed.result;
+                continue;
+            }
+            if (parsed.type !== "assistant" || !Array.isArray(parsed.message?.content))
+                continue;
+            for (const block of parsed.message.content) {
+                if (block
+                    && typeof block === "object"
+                    && block.type === "text"
+                    && typeof block.text === "string") {
+                    assistantTexts.push(block.text);
+                }
+            }
+        }
+        catch {
+            // ignore diagnostics mixed into stdout
+        }
+    }
+    return (resultText || assistantTexts.join("\n")).trim();
+}
+function buildGrokTextArgs(prompt, opts, allowTools = false) {
+    const args = ["--no-auto-update", "-p", prompt, "--output-format", "streaming-json"];
+    const model = opts.model?.trim();
+    if (model && model !== "default")
+        args.push("--model", model);
+    const effort = thinkingEffortToGrokEffort(opts.thinkingEffort ?? "off");
+    if (effort)
+        args.push("--effort", effort);
+    if (allowTools)
+        args.push("--always-approve");
+    return args;
+}
+function buildQoderTextArgs(prompt, opts, allowTools = false) {
+    const args = ["-p", prompt, "--output-format", "stream-json", "--no-session-persistence"];
+    const model = opts.model?.trim();
+    if (model && model !== "default")
+        args.push("--model", model);
+    const effort = thinkingEffortToQoderEffort(opts.thinkingEffort ?? "off");
+    if (effort)
+        args.push("--reasoning-effort", effort);
+    if (allowTools)
+        args.push("--permission-mode", "bypass_permissions");
+    return args;
+}
 function runCliText(command, args, prompt, opts) {
     return new Promise((resolve, reject) => {
         const child = spawn(command, args, {
@@ -605,6 +692,28 @@ async function callOpenCodeText(prompt, cwd, opts) {
         throw new QuickCommitError("OpenCode 返回了空的 commit message。", "EMPTY_AI_MESSAGE");
     return text;
 }
+async function callGrokText(prompt, cwd, opts) {
+    const stdout = await runCliText("grok", buildGrokTextArgs(prompt, opts), "", {
+        cwd,
+        timeoutMs: CODEX_MESSAGE_TIMEOUT_MS,
+        inheritEnv: opts.inheritEnv,
+    });
+    const text = extractGrokText(stdout);
+    if (!text)
+        throw new QuickCommitError("Grok 返回了空的 commit message。", "EMPTY_AI_MESSAGE");
+    return text;
+}
+async function callQoderText(prompt, cwd, opts) {
+    const stdout = await runCliText("qodercli", buildQoderTextArgs(prompt, opts), "", {
+        cwd,
+        timeoutMs: CODEX_MESSAGE_TIMEOUT_MS,
+        inheritEnv: opts.inheritEnv,
+    });
+    const text = extractQoderText(stdout);
+    if (!text)
+        throw new QuickCommitError("Qoder 返回了空的 commit message。", "EMPTY_AI_MESSAGE");
+    return text;
+}
 async function callCliAiText(prompt, cwd, language, opts) {
     const provider = normalizeProvider(opts.provider);
     if (provider === "codex") {
@@ -612,10 +721,14 @@ async function callCliAiText(prompt, cwd, language, opts) {
     }
     if (provider === "opencode")
         return callOpenCodeText(prompt, cwd, opts);
-    return callClaudeText(prompt, cwd, language, opts.model);
+    if (provider === "grok")
+        return callGrokText(prompt, cwd, opts);
+    if (provider === "qoder")
+        return callQoderText(prompt, cwd, opts);
+    return callClaudeText(prompt, cwd, language, opts);
 }
 async function callDirectApiText(prompt, systemAi) {
-    const text = await callSystemAiTextWithFallback(prompt, systemAi);
+    const text = await callSystemAiTextWithFallback(prompt, systemAi, DIRECT_API_PROFILE_TIMEOUT_MS);
     if (!text.trim()) {
         throw new QuickCommitError("直连 API 返回了空结果。", "EMPTY_AI_MESSAGE");
     }
@@ -626,8 +739,9 @@ function aiFallbackFailed(primary, primaryError, fallbackError) {
     return new QuickCommitError(`${primary} 与 ${fallback} 均失败：${getGitErrorMessage(primaryError)}；${getGitErrorMessage(fallbackError)}`, "AI_FALLBACK_FAILED");
 }
 /**
- * Run a lightweight AI request through the same source ordering used by quick
- * commit: the user's selected source first, then the reciprocal source once.
+ * Run a lightweight AI request through the selected Commit source. API mode
+ * exhausts its profile chain and then falls back once to the current-session
+ * CLI. CLI mode uses only that CLI.
  */
 export async function callConfiguredAiText(prompt, cwd, language, opts) {
     if (opts.systemAi?.enabled) {
@@ -645,21 +759,7 @@ export async function callConfiguredAiText(prompt, cwd, language, opts) {
             }
         }
     }
-    try {
-        return await callCliAiText(prompt, cwd, language, opts);
-    }
-    catch (cliError) {
-        if (!opts.fallbackSystemAi?.enabled)
-            throw cliError;
-        try {
-            // The user selected the CLI first. A complete direct-API profile is only
-            // provided here as the reciprocal fallback, never as a second CLI try.
-            return await callDirectApiText(prompt, opts.fallbackSystemAi);
-        }
-        catch (apiError) {
-            throw aiFallbackFailed("CLI", cliError, apiError);
-        }
-    }
+    return callCliAiText(prompt, cwd, language, opts);
 }
 async function collectStagedDiff(cwd) {
     let diff;
@@ -899,7 +999,6 @@ export async function runTagHead(opts) {
             model: opts.model,
             thinkingEffort: opts.thinkingEffort,
             inheritEnv: opts.inheritEnv,
-            fallbackSystemAi: opts.fallbackSystemAi,
             systemAi: opts.systemAi,
         });
     }
@@ -1265,6 +1364,20 @@ async function runQuickCommitFallbackCli(opts, priorError) {
             inheritEnv: opts.inheritEnv,
         });
     }
+    else if (provider === "grok") {
+        await runCliText("grok", buildGrokTextArgs(prompt, opts, true), "", {
+            cwd: opts.cwd,
+            timeoutMs: QUICK_COMMIT_CLI_TIMEOUT_MS,
+            inheritEnv: opts.inheritEnv,
+        });
+    }
+    else if (provider === "qoder") {
+        await runCliText("qodercli", buildQoderTextArgs(prompt, opts, true), "", {
+            cwd: opts.cwd,
+            timeoutMs: QUICK_COMMIT_CLI_TIMEOUT_MS,
+            inheritEnv: opts.inheritEnv,
+        });
+    }
     else {
         const args = [
             "-p",
@@ -1333,7 +1446,6 @@ export async function runQuickCommit(opts) {
         model: opts.model,
         thinkingEffort: opts.thinkingEffort,
         inheritEnv: opts.inheritEnv,
-        fallbackSystemAi: opts.fallbackSystemAi,
         systemAi: opts.systemAi,
     };
     await assertGitWorkTreeAsync(cwd);

package/dist/server-settings-routes.js

@@ -123,11 +123,7 @@ export function registerSettingsRoutes(app, deps) {
         res.json({ inheritEnv, total: entries.length, reveal, entries });
     });
     app.post("/api/settings/system-ai/import", requireAdmin, (req, res) => {
-        const body = (req.body ?? {});
-        const source = body.source === "codex" || body.source === "opencode" || body.source === "claude"
-            ? body.source
-            : config.commitCli;
-        const imported = discoverCliSystemAiConfigs(source);
+        const imported = discoverCliSystemAiConfigs();
         if (!imported.length) {
             res.status(404).json({ error: "没有在已配置的 CLI 文件中找到可直连的 API 地址、密钥和模型。" });
             return;

package/dist/session-ai-context.d.ts

@@ -1,11 +1,10 @@
+import { discoverCliSystemAiConfigs } from "./system-ai.js";
 import type { SessionProvider, SessionSnapshot, SystemAiConfig, WandConfig } from "./types.js";
 export interface SessionAiContext {
     provider: SessionProvider;
     model?: string;
     thinkingEffort: SessionSnapshot["thinkingEffort"];
     inheritEnv?: boolean;
-    /** Direct API to try when Commit is configured to prefer its CLI. */
-    fallbackSystemAi?: SystemAiConfig;
     systemAi?: SystemAiConfig;
 }
 /**
@@ -19,4 +18,4 @@ export declare function resolveSessionAiContext(snapshot: Pick<SessionSnapshot,
 /** Build the source order for Wand-owned AI features such as titles. */
 export declare function resolveSystemAiContext(snapshot: Parameters<typeof resolveSessionAiContext>[0], config: Parameters<typeof resolveSessionAiContext>[1] & Pick<WandConfig, "systemAi" | "commitCli" | "commitModel">): SessionAiContext;
 /** Build the AI context for quick-commit actions from their global preferences. */
-export declare function resolveCommitAiContext(snapshot: Pick<SessionSnapshot, "provider" | "structuredState" | "runner" | "command" | "selectedModel" | "thinkingEffort">, config: Pick<WandConfig, "defaultModel" | "defaultCodexModel" | "defaultOpenCodeModel" | "defaultGrokModel" | "defaultQoderModel" | "defaultThinkingEffort" | "inheritEnv" | "commitCli" | "commitModel" | "commitAiSource" | "systemAi">): SessionAiContext;
+export declare function resolveCommitAiContext(snapshot: Pick<SessionSnapshot, "provider" | "structuredState" | "runner" | "command" | "selectedModel" | "thinkingEffort">, config: Pick<WandConfig, "defaultModel" | "defaultCodexModel" | "defaultOpenCodeModel" | "defaultGrokModel" | "defaultQoderModel" | "defaultThinkingEffort" | "inheritEnv" | "commitAiSource" | "systemAi">, discoverApis?: typeof discoverCliSystemAiConfigs): SessionAiContext;

package/dist/session-ai-context.js

@@ -1,5 +1,5 @@
 import { getDefaultModelForProvider } from "./config.js";
-import { systemAiProfiles } from "./system-ai.js";
+import { discoverCliSystemAiConfigs, mergeSystemAiConfigs, systemAiProfiles, } from "./system-ai.js";
 /**
  * Resolve the provider from every representation used by current and legacy
  * sessions. Older persisted sessions may not have the top-level provider, but
@@ -74,22 +74,20 @@ export function resolveSystemAiContext(snapshot, config) {
     return directApi && config.systemAi?.enabled ? { ...cliContext, systemAi: directApi } : cliContext;
 }
 /** Build the AI context for quick-commit actions from their global preferences. */
-export function resolveCommitAiContext(snapshot, config) {
+export function resolveCommitAiContext(snapshot, config, discoverApis = discoverCliSystemAiConfigs) {
     const sessionContext = resolveSessionAiContext(snapshot, config);
-    const directApi = config.systemAi ?? {
-        enabled: true,
-        protocol: "openai",
-        baseUrl: "",
-        apiKey: "",
-        model: "",
+    const commitContext = {
+        ...sessionContext,
+        // Commit messages and tags are short classification/summarization tasks.
+        // Keep them on the minimum explicit provider effort instead of inheriting
+        // an expensive deep/max setting from the conversation.
+        thinkingEffort: "standard",
     };
-    const readyDirectApi = usableSystemAi(directApi);
+    if (config.commitAiSource !== "api")
+        return commitContext;
+    const directApi = mergeSystemAiConfigs(discoverApis(commitContext.provider), config.systemAi);
     return {
-        ...sessionContext,
-        provider: config.commitCli === "codex" || config.commitCli === "opencode" ? config.commitCli : "claude",
-        model: normalizeModel(config.commitModel),
-        ...(config.commitAiSource === "api"
-            ? { systemAi: { ...directApi, enabled: true } }
-            : readyDirectApi ? { fallbackSystemAi: readyDirectApi } : {}),
+        ...commitContext,
+        ...(directApi ? { systemAi: directApi } : {}),
     };
 }

package/dist/structured-provider-common.d.ts

@@ -5,8 +5,9 @@ export declare function resolveStructuredRunner(provider: SessionProvider, reque
 export declare function defaultStructuredState(provider: SessionProvider, runner?: SessionRunner): StructuredSessionState;
 export declare function normalizeThinkingEffort(value: unknown): SessionSnapshot["thinkingEffort"];
 export declare function thinkingEffortToSdkBudget(effort: SessionSnapshot["thinkingEffort"]): number;
-export declare function thinkingEffortToClaudeCliEffort(effort: SessionSnapshot["thinkingEffort"]): string | null;
+export declare function thinkingEffortToClaudeCliEffort(effort: SessionSnapshot["thinkingEffort"]): "low" | "medium" | "max" | null;
 export declare function thinkingEffortToClaudeSlashEffort(effort: SessionSnapshot["thinkingEffort"]): string;
 export declare function thinkingEffortToCodexReasoningEffort(effort: SessionSnapshot["thinkingEffort"]): string | null;
 export declare function thinkingEffortToOpenCodeVariant(effort: SessionSnapshot["thinkingEffort"]): string | null;
 export declare function thinkingEffortToGrokEffort(effort: SessionSnapshot["thinkingEffort"]): string | null;
+export declare function thinkingEffortToQoderEffort(effort: SessionSnapshot["thinkingEffort"]): string | null;

package/dist/structured-provider-common.js

@@ -94,3 +94,14 @@ export function thinkingEffortToGrokEffort(effort) {
         return "max";
     return effort.startsWith("codex:") ? effort.slice("codex:".length) || null : null;
 }
+export function thinkingEffortToQoderEffort(effort) {
+    if (!effort || effort === "off")
+        return null;
+    if (effort === "standard")
+        return "low";
+    if (effort === "deep")
+        return "high";
+    if (effort === "max")
+        return "max";
+    return effort.startsWith("codex:") ? effort.slice("codex:".length) || null : null;
+}

package/dist/system-ai.d.ts

@@ -10,6 +10,11 @@ export declare function discoverCliSystemAiConfigs(preferred?: SessionProvider,
 export declare function discoverCliSystemAiConfig(preferred?: SessionProvider, home?: string): SystemAiConfig | null;
 /** Return the configured API chain in call order, excluding incomplete entries. */
 export declare function systemAiProfiles(config: SystemAiConfig | undefined, forceEnabled?: boolean): SystemAiConfig[];
+/**
+ * Flatten and combine direct-API groups in priority order. Dynamically discovered
+ * profiles can be passed first, followed by stored/legacy settings.
+ */
+export declare function mergeSystemAiConfigs(...groups: Array<SystemAiConfig | SystemAiConfig[] | undefined>): SystemAiConfig | undefined;
 export declare function callSystemAiText(prompt: string, config: SystemAiConfig, timeoutMs?: number): Promise<string>;
 /** Try every configured API in order. Empty responses are treated as unavailable. */
 export declare function callSystemAiTextWithFallback(prompt: string, config: SystemAiConfig, timeoutMs?: number): Promise<string>;