@co0ontty/wand 4.8.0 → 4.9.0

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "commit": "8688b5cf30adc66cff2a50d9cfa34a6b1b9a4adc",
-  "builtAt": "2026-07-17T00:33:01.780Z",
-  "version": "4.8.0",
+  "commit": "68a079166c78753758bb0c06b975a6bf7a7634a5",
+  "builtAt": "2026-07-17T01:40:14.674Z",
+  "version": "4.9.0",
   "channel": "stable"
 }

package/dist/config.d.ts

@@ -7,7 +7,7 @@ import type { WandStorage } from "./storage.js";
  * 升级路径：老 JSON 里仍存有这些字段时，首次启动会被搬到 DB（见 migrateLegacyPreferencesToDb），
  * 然后下一次 saveConfig 写回 JSON 时它们会被剥离（见 stripPreferenceFields）。
  */
-export declare const PREFERENCE_KEYS: readonly ["defaultProvider", "defaultSessionKind", "defaultMode", "defaultCwd", "defaultModel", "defaultCodexModel", "defaultOpenCodeModel", "commitCli", "commitModel", "commitAiSource", "systemAi", "defaultThinkingEffort", "structuredRunner", "language", "cardDefaults", "inheritEnv"];
+export declare const PREFERENCE_KEYS: readonly ["defaultProvider", "defaultSessionKind", "defaultMode", "defaultCwd", "defaultModel", "defaultCodexModel", "defaultOpenCodeModel", "defaultGrokModel", "commitCli", "commitModel", "commitAiSource", "systemAi", "defaultThinkingEffort", "structuredRunner", "language", "cardDefaults", "inheritEnv"];
 export type PreferenceKey = (typeof PREFERENCE_KEYS)[number];
 export declare function isPreferenceKey(key: string): key is PreferenceKey;
 export declare const defaultConfig: () => WandConfig;
@@ -44,10 +44,11 @@ export declare function writePreferenceToStorage(config: WandConfig, storage: Wa
 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">): {
+export declare function getProviderDefaultModels(config: Pick<WandConfig, "defaultModel" | "defaultCodexModel" | "defaultOpenCodeModel" | "defaultGrokModel">): {
     claude: string;
     codex: string;
     opencode: string;
+    grok: string;
 };
-export declare function getDefaultModelForProvider(config: Pick<WandConfig, "defaultModel" | "defaultCodexModel" | "defaultOpenCodeModel">, provider: SessionProvider | undefined): string;
+export declare function getDefaultModelForProvider(config: Pick<WandConfig, "defaultModel" | "defaultCodexModel" | "defaultOpenCodeModel" | "defaultGrokModel">, provider: SessionProvider | undefined): string;
 export declare function normalizeMode(input: string | undefined, fallback: ExecutionMode): ExecutionMode;

package/dist/config.js

@@ -29,6 +29,7 @@ export const PREFERENCE_KEYS = [
     "defaultModel",
     "defaultCodexModel",
     "defaultOpenCodeModel",
+    "defaultGrokModel",
     "commitCli",
     "commitModel",
     "commitAiSource",
@@ -71,6 +72,7 @@ export const defaultConfig = () => ({
     defaultModel: "",
     defaultCodexModel: "",
     defaultOpenCodeModel: "",
+    defaultGrokModel: "",
     commitCli: "claude",
     commitModel: "",
     commitAiSource: "cli",
@@ -313,6 +315,11 @@ export function applyStoragePreferences(config, storage) {
         if (typeof v === "string")
             config.defaultOpenCodeModel = v.trim();
     }
+    if (storage.hasPreference(preferenceStorageKey("defaultGrokModel"))) {
+        const v = storage.getPreference(preferenceStorageKey("defaultGrokModel"), defaults.defaultGrokModel ?? "");
+        if (typeof v === "string")
+            config.defaultGrokModel = v.trim();
+    }
     if (storage.hasPreference(preferenceStorageKey("commitCli"))) {
         const v = storage.getPreference(preferenceStorageKey("commitCli"), defaults.commitCli ?? "claude");
         if (v === "claude" || v === "codex" || v === "opencode")
@@ -407,6 +414,12 @@ export function writePreferenceToStorage(config, storage, key, value, options =
             config.defaultOpenCodeModel = v;
             break;
         }
+        case "defaultGrokModel": {
+            const v = typeof value === "string" ? value.trim() : "";
+            storage.setPreference(dbKey, v);
+            config.defaultGrokModel = v;
+            break;
+        }
         case "commitCli": {
             if (value !== "claude" && value !== "codex" && value !== "opencode")
                 throw new Error(`无效 commit CLI: ${value}`);
@@ -633,6 +646,7 @@ function mergeWithDefaults(input) {
         defaultModel: typeof input.defaultModel === "string" ? input.defaultModel.trim() : defaults.defaultModel,
         defaultCodexModel: typeof input.defaultCodexModel === "string" ? input.defaultCodexModel.trim() : defaults.defaultCodexModel,
         defaultOpenCodeModel: typeof input.defaultOpenCodeModel === "string" ? input.defaultOpenCodeModel.trim() : defaults.defaultOpenCodeModel,
+        defaultGrokModel: typeof input.defaultGrokModel === "string" ? input.defaultGrokModel.trim() : defaults.defaultGrokModel,
         commitCli: input.commitCli === "codex" || input.commitCli === "opencode" ? input.commitCli : "claude",
         commitModel: typeof input.commitModel === "string" ? input.commitModel.trim() : defaults.commitModel,
         commitAiSource: input.commitAiSource === "api" ? "api" : "cli",
@@ -649,11 +663,18 @@ export function getProviderDefaultModels(config) {
         claude: (config.defaultModel ?? "").trim(),
         codex: (config.defaultCodexModel ?? "").trim(),
         opencode: (config.defaultOpenCodeModel ?? "").trim(),
+        grok: (config.defaultGrokModel ?? "").trim(),
     };
 }
 export function getDefaultModelForProvider(config, provider) {
     const defaults = getProviderDefaultModels(config);
-    return provider === "codex" ? defaults.codex : provider === "opencode" ? defaults.opencode : provider === "grok" ? "" : defaults.claude;
+    if (provider === "codex")
+        return defaults.codex;
+    if (provider === "opencode")
+        return defaults.opencode;
+    if (provider === "grok")
+        return defaults.grok;
+    return defaults.claude;
 }
 export function normalizeMode(input, fallback) {
     return isExecutionMode(input) ? input : fallback;

package/dist/models.d.ts

@@ -34,10 +34,19 @@ export interface ModelCache {
     models: ClaudeModelInfo[];
     codexModels: ClaudeModelInfo[];
     opencodeModels: ClaudeModelInfo[];
+    grokModels: ClaudeModelInfo[];
     claudeVersion: string | null;
     opencodeVersion: string | null;
     refreshedAt: string;
 }
+/**
+ * Parse `grok models` human-readable output:
+ *
+ *   Default model: grok-4.5
+ *   Available models:
+ *     * grok-4.5 (default)
+ */
+export declare function parseGrokModels(stdout: string): ClaudeModelInfo[];
 /** Parse `opencode models`, whose stable machine-friendly output is one provider/model id per line. */
 export declare function parseOpenCodeModels(stdout: string): ClaudeModelInfo[];
 /** Parse the machine-readable model registry emitted by the installed Codex CLI. */

package/dist/models.js

@@ -29,6 +29,10 @@ const CODEX_FALLBACK_MODELS = [
 const OPENCODE_FALLBACK_MODELS = [
     { id: "default", label: "跟随 OpenCode 默认", alias: true },
 ];
+const GROK_FALLBACK_MODELS = [
+    { id: "default", label: "跟随 Grok 默认", alias: true },
+    { id: "grok-4.5", label: "grok-4.5" },
+];
 let cache = null;
 function cloneModels(models) {
     return models.map((model) => ({ ...model }));
@@ -193,6 +197,7 @@ function createInitialCache(options) {
         }),
         codexModels: cloneModels(CODEX_FALLBACK_MODELS),
         opencodeModels: cloneModels(OPENCODE_FALLBACK_MODELS),
+        grokModels: cloneModels(GROK_FALLBACK_MODELS),
         claudeVersion: null,
         opencodeVersion: null,
         refreshedAt: now.toISOString(),
@@ -253,6 +258,15 @@ async function probeOpenCode(runner, env) {
         : null;
     return { models, version };
 }
+async function probeGrokModels(runner, env) {
+    try {
+        const { stdout } = await runner("grok", ["models"], { env, timeout: 8000 });
+        return parseGrokModels(stdout);
+    }
+    catch {
+        return cloneModels(GROK_FALLBACK_MODELS);
+    }
+}
 function createOfficialModelsApi(apiKey) {
     const client = new Anthropic({ apiKey });
     return {
@@ -319,6 +333,47 @@ function mergeVerifications(previous, models, verifiedIds, claudeVersion, now) {
     }
     return [...byId.values()];
 }
+/**
+ * Parse `grok models` human-readable output:
+ *
+ *   Default model: grok-4.5
+ *   Available models:
+ *     * grok-4.5 (default)
+ */
+export function parseGrokModels(stdout) {
+    const stripAnsi = (line) => line.replace(/\x1b\[[0-?]*[ -\/]*[@-~]/g, "");
+    const lines = stdout.split(/\r?\n/).map((line) => stripAnsi(line).trim()).filter(Boolean);
+    let defaultModel = "";
+    const ids = [];
+    for (const line of lines) {
+        const defaultMatch = line.match(/^Default model:\s*([A-Za-z0-9][A-Za-z0-9._:-]{0,127})\s*$/i);
+        if (defaultMatch) {
+            defaultModel = defaultMatch[1];
+            continue;
+        }
+        const bulletMatch = line.match(/^\*+\s*([A-Za-z0-9][A-Za-z0-9._:-]{0,127})(?:\s*\(.*\))?\s*$/);
+        if (bulletMatch) {
+            ids.push(bulletMatch[1]);
+            continue;
+        }
+        // Some builds may print plain model ids after the "Available models" header.
+        if (/^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/.test(line) && !/^(available|default)\b/i.test(line)) {
+            ids.push(line);
+        }
+    }
+    const unique = Array.from(new Set(ids.filter((id) => id && id !== "default")));
+    if (defaultModel && !unique.includes(defaultModel))
+        unique.unshift(defaultModel);
+    if (!unique.length && !defaultModel)
+        return cloneModels(GROK_FALLBACK_MODELS);
+    const defaultLabel = defaultModel
+        ? `${defaultModel}（Grok 默认）`
+        : "跟随 Grok 默认";
+    return [
+        { id: "default", label: defaultLabel, alias: true },
+        ...unique.map((id) => ({ id, label: id })),
+    ];
+}
 /** Parse `opencode models`, whose stable machine-friendly output is one provider/model id per line. */
 export function parseOpenCodeModels(stdout) {
     const ids = Array.from(new Set(stdout
@@ -397,10 +452,11 @@ export async function refreshModels(options = {}) {
     const now = options.now?.() ?? new Date();
     const env = resolveProbeEnv(options);
     const runner = options.commandRunner ?? defaultCommandRunner;
-    const [claudeVersion, codexModels, opencode, apiModels] = await Promise.all([
+    const [claudeVersion, codexModels, opencode, grokModels, apiModels] = await Promise.all([
         probeClaudeVersion(runner, env),
         probeCodexModels(runner, env),
         probeOpenCode(runner, env),
+        probeGrokModels(runner, env),
         listClaudeModelsFromApi(options, env),
     ]);
     const priorVerifications = loadClaudeVerifications(options.storage);
@@ -427,6 +483,7 @@ export async function refreshModels(options = {}) {
         }),
         codexModels,
         opencodeModels: opencode.models,
+        grokModels,
         claudeVersion,
         opencodeVersion: opencode.version,
         refreshedAt: now.toISOString(),

package/dist/server-settings-routes.js

@@ -20,6 +20,7 @@ function publicConfig(config) {
         defaultModel: defaultModels.claude,
         defaultCodexModel: defaultModels.codex,
         defaultOpenCodeModel: defaultModels.opencode,
+        defaultGrokModel: defaultModels.grok,
         defaultModels,
     };
 }
@@ -184,6 +185,8 @@ export function registerSettingsRoutes(app, deps) {
                     stagePreference("defaultCodexModel", body.defaultModels.codex);
                 if (Object.hasOwn(body.defaultModels, "opencode"))
                     stagePreference("defaultOpenCodeModel", body.defaultModels.opencode);
+                if (Object.hasOwn(body.defaultModels, "grok"))
+                    stagePreference("defaultGrokModel", body.defaultModels.grok);
             }
             if (body.systemAi !== undefined) {
                 if (!body.systemAi || typeof body.systemAi !== "object" || Array.isArray(body.systemAi)) {
@@ -252,6 +255,7 @@ export function registerSettingsRoutes(app, deps) {
             defaultModel: defaults.claude,
             defaultCodexModel: defaults.codex,
             defaultOpenCodeModel: defaults.opencode,
+            defaultGrokModel: defaults.grok,
             defaultModels: defaults,
         });
     });
@@ -264,6 +268,7 @@ export function registerSettingsRoutes(app, deps) {
                 defaultModel: defaults.claude,
                 defaultCodexModel: defaults.codex,
                 defaultOpenCodeModel: defaults.opencode,
+                defaultGrokModel: defaults.grok,
                 defaultModels: defaults,
             });
         }

package/dist/server.js

@@ -197,6 +197,7 @@ const CONNECTED_APP_PREFERENCE_KEYS = new Set([
     "defaultModel",
     "defaultCodexModel",
     "defaultOpenCodeModel",
+    "defaultGrokModel",
     "defaultModels",
     "defaultThinkingEffort",
     "defaultProvider",
@@ -717,6 +718,7 @@ export async function startServer(config, configPath, options = {}) {
             defaultModel: defaultModels.claude,
             defaultCodexModel: defaultModels.codex,
             defaultOpenCodeModel: defaultModels.opencode,
+            defaultGrokModel: defaultModels.grok,
             defaultModels,
             defaultThinkingEffort: config.defaultThinkingEffort ?? "off",
             commandPresets: config.commandPresets,

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

@@ -13,6 +13,6 @@ export interface SessionAiContext {
  */
 export declare function resolveSessionProvider(snapshot: Pick<SessionSnapshot, "provider" | "structuredState" | "runner" | "command">): SessionProvider;
 /** Build the provider-specific settings used by session-adjacent AI actions. */
-export declare function resolveSessionAiContext(snapshot: Pick<SessionSnapshot, "provider" | "structuredState" | "runner" | "command" | "selectedModel" | "thinkingEffort">, config: Pick<WandConfig, "defaultModel" | "defaultCodexModel" | "defaultOpenCodeModel" | "defaultThinkingEffort" | "inheritEnv">): SessionAiContext;
+export declare function resolveSessionAiContext(snapshot: Pick<SessionSnapshot, "provider" | "structuredState" | "runner" | "command" | "selectedModel" | "thinkingEffort">, config: Pick<WandConfig, "defaultModel" | "defaultCodexModel" | "defaultOpenCodeModel" | "defaultGrokModel" | "defaultThinkingEffort" | "inheritEnv">): 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" | "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" | "defaultThinkingEffort" | "inheritEnv" | "commitCli" | "commitModel" | "commitAiSource" | "systemAi">): SessionAiContext;

package/dist/session-ai-context.js

@@ -5,10 +5,16 @@ import { getDefaultModelForProvider } from "./config.js";
  * still identify Codex through structuredState, runner, or command.
  */
 export function resolveSessionProvider(snapshot) {
-    if (snapshot.provider === "claude" || snapshot.provider === "codex" || snapshot.provider === "opencode") {
+    if (snapshot.provider === "claude"
+        || snapshot.provider === "codex"
+        || snapshot.provider === "opencode"
+        || snapshot.provider === "grok") {
         return snapshot.provider;
     }
-    if (snapshot.structuredState?.provider === "claude" || snapshot.structuredState?.provider === "codex" || snapshot.structuredState?.provider === "opencode") {
+    if (snapshot.structuredState?.provider === "claude"
+        || snapshot.structuredState?.provider === "codex"
+        || snapshot.structuredState?.provider === "opencode"
+        || snapshot.structuredState?.provider === "grok") {
         return snapshot.structuredState.provider;
     }
     const runner = snapshot.runner ?? snapshot.structuredState?.runner;
@@ -16,11 +22,17 @@ export function resolveSessionProvider(snapshot) {
         return "codex";
     if (runner === "opencode-cli-run")
         return "opencode";
+    if (runner === "grok-cli-headless")
+        return "grok";
     if (runner === "claude-cli" || runner === "claude-cli-print" || runner === "claude-sdk")
         return "claude";
     if (/^codex\b/i.test(snapshot.command.trim()))
         return "codex";
-    return /^opencode\b/i.test(snapshot.command.trim()) ? "opencode" : "claude";
+    if (/^opencode\b/i.test(snapshot.command.trim()))
+        return "opencode";
+    if (/^grok\b/i.test(snapshot.command.trim()))
+        return "grok";
+    return "claude";
 }
 function normalizeModel(value) {
     const model = value?.trim();

package/dist/types.d.ts

@@ -112,6 +112,8 @@ export interface WandConfig {
     defaultCodexModel?: string;
     /** 新建 OpenCode 会话时默认使用的 provider/model。留空则由 opencode 自行决定。 */
     defaultOpenCodeModel?: string;
+    /** 新建 Grok 会话时默认使用的模型。留空则不传 --model，由 grok 自行决定。 */
+    defaultGrokModel?: string;
     /** 快捷提交生成 commit message / tag 时使用的 CLI。 */
     commitCli?: SessionProvider;
     /** 快捷提交专用模型。留空则跟随所选 CLI 的默认模型。 */