@co0ontty/wand 4.72.2 → 4.75.0-beta.g1d477a2

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "commit": "cc5d57ee24c38039f381a1bbda3b8d4a95fc26b4",
-  "builtAt": "2026-09-22T23:09:41.272Z",
-  "version": "4.72.2",
-  "channel": "stable"
+  "commit": "1d477a238a1e35f04bdd754c96a3bfff5e1738a3",
+  "builtAt": "2026-09-24T07:07:30.365Z",
+  "version": "4.75.0-beta.g1d477a2",
+  "channel": "beta"
 }

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

@@ -1,4 +1,3 @@
-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;
@@ -9,8 +8,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"];
+    /** Optional adaptive-thinking effort. CLI 动态档位（high / xhigh 等）原样传给 SDK。 */
+    effort?: string;
     /**
      * 用户偏好的回复语言（取自 config.language）。传进来时会以
      * `appendSystemPrompt` 形式灌给 Claude，保证 quick-commit / prompt-optimizer

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", "defaultTaskWorktree", "defaultMode", "defaultCwd", "defaultModel", "defaultCodexModel", "defaultOpenCodeModel", "defaultGrokModel", "defaultQoderModel", "defaultPiModel", "commitCli", "commitModel", "commitAiSource", "systemAi", "defaultThinkingEffort", "structuredRunner", "language", "cardDefaults", "inheritEnv"];
+export declare const PREFERENCE_KEYS: readonly ["defaultProvider", "defaultSessionKind", "defaultTaskWorktree", "defaultMode", "defaultCwd", "defaultModel", "defaultCodexModel", "defaultOpenCodeModel", "defaultGrokModel", "defaultQoderModel", "defaultPiModel", "commitCli", "commitModel", "commitAiSource", "systemAi", "systemAiCli", "systemAiModel", "defaultThinkingEffort", "structuredRunner", "language", "cardDefaults", "inheritEnv"];
 export type PreferenceKey = (typeof PREFERENCE_KEYS)[number];
 export declare function isPreferenceKey(key: string): key is PreferenceKey;
 /**

package/dist/config.js

@@ -33,6 +33,8 @@ export const PREFERENCE_KEYS = [
     "commitModel",
     "commitAiSource",
     "systemAi",
+    "systemAiCli",
+    "systemAiModel",
     "defaultThinkingEffort",
     "structuredRunner",
     "language",
@@ -91,6 +93,8 @@ export const defaultConfig = () => ({
     android: defaultAndroidApkConfig(),
     macos: defaultMacosDmgConfig(),
     ios: defaultIosIpaConfig(),
+    render: defaultRenderConfig(),
+    structured: { processHost: "legacy" },
     cardDefaults: defaultCardExpandDefaults(),
     defaultModel: "",
     defaultCodexModel: "",
@@ -111,6 +115,7 @@ export const defaultConfig = () => ({
         authHeader: "bearer",
         source: "custom",
     },
+    systemAiModel: "",
     defaultThinkingEffort: "off",
     structuredRunner: "cli",
     inheritEnv: true,
@@ -380,6 +385,16 @@ export function applyStoragePreferences(config, storage) {
         const v = storage.getPreference(preferenceStorageKey("systemAi"), defaults.systemAi);
         config.systemAi = normalizeSystemAiConfig(v, defaults.systemAi);
     }
+    if (storage.hasPreference(preferenceStorageKey("systemAiCli"))) {
+        const v = storage.getPreference(preferenceStorageKey("systemAiCli"), defaults.systemAiCli);
+        if (isSessionProvider(v))
+            config.systemAiCli = v;
+    }
+    if (storage.hasPreference(preferenceStorageKey("systemAiModel"))) {
+        const v = storage.getPreference(preferenceStorageKey("systemAiModel"), defaults.systemAiModel);
+        if (typeof v === "string")
+            config.systemAiModel = v.trim();
+    }
     if (storage.hasPreference(preferenceStorageKey("defaultThinkingEffort"))) {
         const v = storage.getPreference(preferenceStorageKey("defaultThinkingEffort"), defaults.defaultThinkingEffort ?? "off");
         if (isThinkingEffort(v))
@@ -518,6 +533,19 @@ export function writePreferenceToStorage(config, storage, key, value, options =
             config.systemAi = normalized;
             break;
         }
+        case "systemAiCli": {
+            if (!isSessionProvider(value))
+                throw new Error(`无效系统 AI CLI: ${String(value)}`);
+            storage.setPreference(dbKey, value);
+            config.systemAiCli = value;
+            break;
+        }
+        case "systemAiModel": {
+            const v = typeof value === "string" ? value.trim() : "";
+            storage.setPreference(dbKey, v);
+            config.systemAiModel = v;
+            break;
+        }
         case "defaultThinkingEffort": {
             if (!isThinkingEffort(value))
                 throw new Error(`无效思考深度: ${String(value)}`);
@@ -634,6 +662,22 @@ function defaultIosIpaConfig() {
         currentIpaFile: "",
     };
 }
+/**
+ * 默认 auto：存在 wand-render 就用它，否则保持 legacy terminald。
+ * 放在 config.json（部署项）而非 SQLite 偏好里——它决定进程所有权，属于部署决策。
+ */
+function defaultRenderConfig() {
+    return { engine: "auto" };
+}
+/** 旧 config.json 没有 render 字段时回落到默认值，不能因为新字段让启动失败。 */
+function normalizeRenderConfig(input) {
+    if (!input || typeof input !== "object" || Array.isArray(input))
+        return undefined;
+    const raw = input;
+    const engine = raw.engine === "rust" || raw.engine === "legacy" ? raw.engine : "auto";
+    const binaryPath = typeof raw.binaryPath === "string" ? raw.binaryPath.trim() : "";
+    return { engine, ...(binaryPath ? { binaryPath } : {}) };
+}
 function normalizeIosIpaConfig(input) {
     if (!input || typeof input !== "object")
         return undefined;
@@ -737,6 +781,8 @@ function mergeWithDefaults(input) {
         android: normalizeAndroidApkConfig(input.android) ?? defaults.android,
         macos: normalizeMacosDmgConfig(input.macos) ?? defaults.macos,
         ios: normalizeIosIpaConfig(input.ios) ?? defaults.ios,
+        render: normalizeRenderConfig(input.render) ?? defaults.render,
+        structured: { processHost: input.structured?.processHost === "rust" ? "rust" : "legacy" },
         cardDefaults: normalizeCardDefaults(input.cardDefaults),
         defaultProvider: isSessionProvider(input.defaultProvider) ? input.defaultProvider : "claude",
         defaultSessionKind: input.defaultSessionKind === "pty" ? "pty" : "structured",
@@ -750,6 +796,8 @@ function mergeWithDefaults(input) {
         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",
+        systemAiCli: isSessionProvider(input.systemAiCli) ? input.systemAiCli : undefined,
+        systemAiModel: typeof input.systemAiModel === "string" ? input.systemAiModel.trim() : defaults.systemAiModel,
         defaultThinkingEffort: isThinkingEffort(input.defaultThinkingEffort) ? input.defaultThinkingEffort : "off",
         structuredRunner: (input.structuredRunner === "sdk" || input.structuredRunner === "cli") ? input.structuredRunner : defaults.structuredRunner,
         inheritEnv: typeof input.inheritEnv === "boolean" ? input.inheritEnv : (defaults.inheritEnv ?? true),

package/dist/daemon-connection.d.ts

@@ -0,0 +1,9 @@
+import type net from "node:net";
+/** Bound connect attempts, including sockets that close before the handshake. */
+export declare function waitForDaemonSocket(socket: net.Socket): Promise<void>;
+/** Probe the application, not just the fd: a half-open socket may still be writable. */
+export declare function startDaemonHeartbeat(socket: net.Socket, probe: () => Promise<unknown>, options?: {
+    socketPath?: string;
+    intervalMs?: number;
+    timeoutMs?: number;
+}): () => void;

package/dist/daemon-connection.js

@@ -0,0 +1,86 @@
+import { lstatSync, utimesSync } from "node:fs";
+const CONNECT_TIMEOUT_MS = 10_000;
+const HEARTBEAT_INTERVAL_MS = 15_000;
+const HEARTBEAT_TIMEOUT_MS = 5_000;
+/** Bound connect attempts, including sockets that close before the handshake. */
+export function waitForDaemonSocket(socket) {
+    return new Promise((resolve, reject) => {
+        const cleanup = () => {
+            clearTimeout(timer);
+            socket.off("connect", onConnect);
+            socket.off("error", onError);
+            socket.off("close", onClose);
+        };
+        const onConnect = () => { cleanup(); resolve(); };
+        const onError = (error) => { cleanup(); socket.destroy(); reject(error); };
+        const onClose = () => onError(new Error("Daemon socket closed while connecting"));
+        const timer = setTimeout(() => onError(new Error("Daemon socket connect timed out")), CONNECT_TIMEOUT_MS);
+        socket.once("connect", onConnect);
+        socket.once("error", onError);
+        socket.once("close", onClose);
+    });
+}
+/** Probe the application, not just the fd: a half-open socket may still be writable. */
+export function startDaemonHeartbeat(socket, probe, options = {}) {
+    const { socketPath, intervalMs = HEARTBEAT_INTERVAL_MS, timeoutMs = HEARTBEAT_TIMEOUT_MS } = options;
+    // Old daemons have no listener watchdog. Refresh their existing endpoint's
+    // timestamps after a successful probe so idle /tmp cleanup won't remove it.
+    const identity = (() => {
+        if (!socketPath || process.platform === "win32")
+            return null;
+        try {
+            const stat = lstatSync(socketPath);
+            return stat.isSocket() && (typeof process.getuid !== "function" || stat.uid === process.getuid())
+                ? stat : null;
+        }
+        catch {
+            return null;
+        }
+    })();
+    let lastTouch = 0;
+    let stopped = false;
+    let inFlight = false;
+    let deadline = null;
+    const stop = () => {
+        stopped = true;
+        clearInterval(timer);
+        if (deadline)
+            clearTimeout(deadline);
+        socket.off("close", stop);
+    };
+    const fail = () => {
+        if (stopped)
+            return;
+        stop();
+        // Destroy this generation only; its close handler performs normal replay
+        // and reconnect. Never retry mutating RPCs or terminate the daemon.
+        socket.destroy(new Error("Daemon heartbeat failed; reconnecting"));
+    };
+    const timer = setInterval(() => {
+        if (stopped || inFlight || socket.destroyed)
+            return;
+        inFlight = true;
+        deadline = setTimeout(fail, timeoutMs);
+        deadline.unref();
+        void Promise.resolve().then(() => stopped ? undefined : probe()).then(() => {
+            if (deadline)
+                clearTimeout(deadline);
+            deadline = null;
+            inFlight = false;
+            if (stopped || !identity || !socketPath || Date.now() - lastTouch < 60_000)
+                return;
+            try {
+                const stat = lstatSync(socketPath);
+                if (stat.dev === identity.dev && stat.ino === identity.ino) {
+                    const now = new Date();
+                    utimesSync(socketPath, now, now);
+                    lastTouch = Date.now();
+                }
+            }
+            catch { /* The owning daemon repairs a missing path; never replace it here. */ }
+        }, fail);
+    }, intervalMs);
+    timer.unref();
+    socket.once("close", stop);
+    return stop;
+}

package/dist/distribution-manager.d.ts

@@ -82,6 +82,11 @@ export declare class DistributionManager {
         deleted: string[];
         freedBytes: number;
     }>;
+    /** Beta 仅从当前服务端的 macOS 分发目录选择，绝不回退 GitHub。 */
+    resolveLatestMacosBeta(): Promise<ResolvedDistributionAsset | null>;
+    /** 固定下载文件名，避免检查与下载之间新增包后下载到另一个版本。 */
+    resolveMacosBetaDownload(fileName: string): Promise<LocalDistributionAsset | null>;
+    private resolveMacosBetaAsset;
     resolveLatestDmg(): Promise<ResolvedDistributionAsset | null>;
     resolveMacosDownload(): Promise<LocalDistributionAsset | null>;
     resolveLatestIpa(): Promise<ResolvedDistributionAsset | null>;

package/dist/distribution-manager.js

@@ -1,9 +1,10 @@
 import { createHash } from "node:crypto";
 import { createReadStream } from "node:fs";
-import { mkdir, readdir, readFile, stat, unlink } from "node:fs/promises";
+import { lstat, mkdir, readdir, readFile, stat, unlink } from "node:fs/promises";
 import path from "node:path";
 import { compareApkInstallOrder, compareSemver, compareWandInstallOrder, extractSemver } from "./version-utils.js";
 const GITHUB_CACHE_TTL_MS = 10 * 60 * 1000;
+const MACOS_UPDATE_FILE_PATTERN = /^wand-v\d+\.\d+\.\d+(?:-[A-Za-z0-9.-]+)?(?:\+[A-Za-z0-9.-]+)?\.(?:zip|dmg)$/i;
 /**
  * GitHub Release 正文还包含 Android/macOS/iOS 的安装指引；它们属于发布页，
  * 不该出现在 Android 的更新弹窗。保留分隔线前的变更摘要，并兼容旧版正文。
@@ -211,6 +212,83 @@ export class DistributionManager {
         }
         return { deleted, freedBytes };
     }
+    /** Beta 仅从当前服务端的 macOS 分发目录选择，绝不回退 GitHub。 */
+    async resolveLatestMacosBeta() {
+        const asset = await this.resolveMacosBetaAsset();
+        if (!asset?.version || asset.size <= 0)
+            return null;
+        const sha256 = await this.computeAssetSha256(asset);
+        if (!sha256)
+            return null;
+        return {
+            version: asset.version.split("+")[0],
+            downloadUrl: `/macos/update-download?fileName=${encodeURIComponent(asset.fileName)}`,
+            fileName: asset.fileName,
+            size: asset.size,
+            source: "local",
+            sha256,
+        };
+    }
+    /** 固定下载文件名，避免检查与下载之间新增包后下载到另一个版本。 */
+    async resolveMacosBetaDownload(fileName) {
+        if (!MACOS_UPDATE_FILE_PATTERN.test(fileName))
+            return null;
+        await this.refreshConfig();
+        const { config, configDir } = this.options;
+        if (config.macos?.enabled !== true)
+            return null;
+        const directory = resolveConfiguredDir(configDir, config.macos.dmgDir, "macos");
+        const filePath = path.join(directory, fileName);
+        try {
+            if (!(await lstat(filePath)).isFile())
+                return null;
+        }
+        catch {
+            return null;
+        }
+        return this.readLocalAsset(filePath, {
+            extension: fileName.toLowerCase().endsWith(".zip") ? ".zip" : ".dmg",
+            downloadUrl: `/macos/update-download?fileName=${encodeURIComponent(fileName)}`,
+        });
+    }
+    async resolveMacosBetaAsset() {
+        await this.refreshConfig();
+        const { config, configDir } = this.options;
+        if (config.macos?.enabled !== true)
+            return null;
+        const directory = resolveConfiguredDir(configDir, config.macos.dmgDir, "macos");
+        await mkdir(directory, { recursive: true });
+        const entries = await readdir(directory, { withFileTypes: true });
+        const candidates = await Promise.all(entries
+            .filter((entry) => entry.isFile() && MACOS_UPDATE_FILE_PATTERN.test(entry.name))
+            .map(async (entry) => ({
+            name: entry.name,
+            filePath: path.join(directory, entry.name),
+            fileStat: await stat(path.join(directory, entry.name)),
+        })));
+        candidates.sort((a, b) => {
+            const aVersion = extractArtifactVersion(a.name, path.extname(a.name));
+            const bVersion = extractArtifactVersion(b.name, path.extname(b.name));
+            const order = compareWandInstallOrder(aVersion ?? "", bVersion ?? "");
+            if (order !== 0)
+                return -order;
+            // 同版本优先 ZIP，避免 DMG 挂载；同格式多构建按最新修改时间挑选。
+            const format = Number(b.name.toLowerCase().endsWith(".zip")) - Number(a.name.toLowerCase().endsWith(".zip"));
+            return format || b.fileStat.mtimeMs - a.fileStat.mtimeMs;
+        });
+        const selected = candidates[0];
+        if (!selected)
+            return null;
+        return {
+            fileName: selected.name,
+            filePath: selected.filePath,
+            size: selected.fileStat.size,
+            updatedAt: selected.fileStat.mtime.toISOString(),
+            version: extractArtifactVersion(selected.name, path.extname(selected.name)),
+            downloadUrl: `/macos/update-download?fileName=${encodeURIComponent(selected.name)}`,
+            source: "local",
+        };
+    }
     async resolveLatestDmg() {
         const localDmg = await this.resolveMacosDownload();
         if (localDmg?.version) {

package/dist/git-quick-commit.js

@@ -494,6 +494,18 @@ function runCliText(command, args, prompt, opts) {
             }
             reject(new QuickCommitError(`${command} CLI 失败：${(stderr || stdout).trim() || `exit ${code}`}`, "CLAUDE_CLI_FAILED"));
         });
+        // A CLI may exit before reading stdin (e.g. invalid credentials/argv).
+        // The writable stream emits EPIPE independently of ChildProcess.error;
+        // without a listener that becomes an uncaught exception after callers
+        // have already finished their turn or closed storage.
+        child.stdin?.on("error", (error) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timeout);
+            child.kill("SIGTERM");
+            reject(new QuickCommitError(`${command} CLI stdin failed: ${error.code ?? "write error"}`, "CLAUDE_CLI_FAILED"));
+        });
         child.stdin?.end(prompt);
     });
 }

package/dist/message-truncator.js

@@ -3,6 +3,7 @@
  * Cards that are collapsed by default have their large results replaced
  * with a summary, and clients fetch full content on-demand via API.
  */
+import { contentHasStructuredImage } from "./structured-content.js";
 const TRUNCATION_THRESHOLD = 200;
 const SUMMARY_LENGTH = 100;
 /**
@@ -12,12 +13,12 @@ const SUMMARY_LENGTH = 100;
  */
 const MESSAGE_WINDOW_SIZE = 40;
 /**
- * 块级窗口的默认预算：init/REST 默认只下发最近这么多个「内容块」（跨 turn 累计，
+ * 块级窗口的默认预算：显式启用时 init/REST 只下发最近这么多个「内容块」（跨 turn 累计，
  * 必要时切掉最旧那条 turn 的头部），更早的块由客户端滚动到顶时按需分页拉取。
  * turn 级窗口（MESSAGE_WINDOW_SIZE）对「单条 turn 携带上百块」的长任务无能为力——
  * 一条流式 assistant turn 可膨胀到 1MB+，整条下发会撑爆移动端 WS 帧、拖慢打开。
- * 块级窗口是对这种会话的根治手段。仅在客户端显式带 blockBudget 时启用（iOS），
- * Web/Android 走原有 turn 级路径不受影响。
+ * 块级窗口是对这种会话的根治手段。客户端显式带 blockBudget 时启用（Web/iOS），
+ * 未携带的原生客户端仍走 turn 级路径。
  */
 const MESSAGE_BLOCK_WINDOW = 60;
 /**
@@ -162,6 +163,11 @@ export function truncateMessagesForTransport(messages, cardDefaults, streamingTu
             const toolName = toolNameMap.get(result.tool_use_id) || "";
             if (!isToolDefaultCollapsed(toolName, cardDefaults))
                 return block;
+            // 带图片的 tool_result 永不截断：图片 part 被 JSON.stringify 截半后客户端再也
+            // 抽不出 data URI（线上表现就是「读图不显示，只剩一串 base64 残文」）。图片要么
+            // 整块送达（客户端会强制展开渲染），要么由 _truncated + 懒加载单独取回。
+            if (contentHasStructuredImage(result.content))
+                return block;
             const contentStr = getContentString(result.content);
             if (contentStr.length <= TRUNCATION_THRESHOLD)
                 return block;

package/dist/models.d.ts

@@ -12,6 +12,8 @@ interface ModelCacheStorage {
 interface ModelCommandOptions {
     env: NodeJS.ProcessEnv;
     timeout: number;
+    /** Written to stdin, then closed. Pi RPC needs this. */
+    input?: string;
 }
 interface ModelCommandResult {
     stdout: string;
@@ -36,6 +38,18 @@ export interface ModelRefreshOptions {
     verifyClaudeCandidates?: boolean;
     now?: () => Date;
 }
+export interface ThinkingEffortLevel {
+    effort: string;
+    description?: string;
+}
+/** 各 CLI 自己报出来的思考档位。Codex / 部分 OpenCode 模型另有 per-model 列表。 */
+export interface ProviderThinkingEfforts {
+    claude: ThinkingEffortLevel[];
+    opencode: ThinkingEffortLevel[];
+    grok: ThinkingEffortLevel[];
+    qoder: ThinkingEffortLevel[];
+    pi: ThinkingEffortLevel[];
+}
 export interface ModelCache {
     models: ClaudeModelInfo[];
     codexModels: ClaudeModelInfo[];
@@ -43,10 +57,13 @@ export interface ModelCache {
     grokModels: ClaudeModelInfo[];
     qoderModels: ClaudeModelInfo[];
     piModels: ClaudeModelInfo[];
+    thinkingEfforts: ProviderThinkingEfforts;
     claudeVersion: string | null;
     opencodeVersion: string | null;
     refreshedAt: string;
 }
+/** 探针失败时的已知档位。下一次 CLI 成功应答会把它换掉。 */
+export declare const FALLBACK_PROVIDER_THINKING: ProviderThinkingEfforts;
 /** Immutable-looking snapshot returned to API clients. */
 export interface ModelCatalogSnapshot extends ModelCache {
     /** SHA-256 of the catalog excluding `refreshedAt`. Changes only with content. */
@@ -62,6 +79,13 @@ export interface ModelCatalogRefreshRequest {
     /** Administrator-triggered refreshes may also validate Claude candidates. */
     verifyClaudeCandidates?: boolean;
 }
+/** 从 CLI 的 help / 非法档位报错里抽出 `low, medium, high` 这种列表。 */
+export declare function parseCliEffortList(text: string): string[];
+/**
+ * `opencode models --verbose` 是「一行 id + 一段 JSON」。
+ * variants 是这个模型自己的推理档位；没有 JSON 时退回一行一个 id。
+ */
+export declare function parseOpenCodeModelCatalog(stdout: string): ClaudeModelInfo[];
 /**
  * Parse `grok models` human-readable output:
  *
@@ -79,12 +103,22 @@ export declare function parseGrokModels(stdout: string): ClaudeModelInfo[];
  * safe ID below the `MODEL` header.
  */
 export declare function parseQoderModels(stdout: string): ClaudeModelInfo[];
+/**
+ * Same rule as Pi's `getSupportedThinkingLevels`: no reasoning means only off;
+ * `xhigh` / `max` exist only when `thinkingLevelMap` defines them; `null` drops a level.
+ */
+export declare function piThinkingLevelsForModel(model: {
+    reasoning?: boolean;
+    thinkingLevelMap?: Record<string, unknown> | null;
+}): string[];
+/** `pi --mode rpc` + `get_available_models`. One JSON response holds every model's thinking map. */
+export declare function parsePiRpcModels(stdout: string): ClaudeModelInfo[];
 /**
  * Parse `pi --list-models`.
  *
  * Pi prints a padEnd-aligned table whose selectable `--model` value is
- * `provider/id` (for example `xai/grok-4.6`). The first two columns are the
- * only ones we keep; context / max-out / thinking / images are display-only.
+ * `provider/id` (for example `xai/grok-4.6`). The table only says thinking
+ * yes/no, so per-model levels come from `parsePiRpcModels` instead.
  */
 export declare function parsePiModels(stdout: string): ClaudeModelInfo[];
 /** Parse `opencode models`, whose stable machine-friendly output is one provider/model id per line. */
@@ -106,8 +140,11 @@ export declare class ModelCatalogService {
     private hasPersistedSnapshot;
     private refreshPromise;
     private inFlightIncludesVerification;
+    private readonly changeListeners;
     constructor(getOptions: () => ModelRefreshOptions);
     snapshot(): ModelCatalogSnapshot;
+    /** 目录内容真正变化时通知。客户端靠它刷新下拉，不用自己再跑一遍 CLI。 */
+    onChanged(listener: (result: ModelCatalogRefreshResult) => void): () => void;
     refresh(request?: ModelCatalogRefreshRequest): Promise<ModelCatalogRefreshResult>;
     private performRefresh;
 }