@co0ontty/wand 4.72.2 → 4.73.0

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "commit": "cc5d57ee24c38039f381a1bbda3b8d4a95fc26b4",
-  "builtAt": "2026-09-22T23:09:41.272Z",
-  "version": "4.72.2",
+  "commit": "7ff219242659cdf0ec264845fbba73b7bbf8561f",
+  "builtAt": "2026-09-23T13:34:35.791Z",
+  "version": "4.73.0",
   "channel": "stable"
 }

package/dist/config.js

@@ -91,6 +91,8 @@ export const defaultConfig = () => ({
     android: defaultAndroidApkConfig(),
     macos: defaultMacosDmgConfig(),
     ios: defaultIosIpaConfig(),
+    render: defaultRenderConfig(),
+    structured: { processHost: "legacy" },
     cardDefaults: defaultCardExpandDefaults(),
     defaultModel: "",
     defaultCodexModel: "",
@@ -634,6 +636,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 +755,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",

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;
 /**
@@ -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/native/darwin-arm64/wand-render.sha256

@@ -0,0 +1 @@
+6855db8c0423d995dbd57567076cdf019a4e3306a465d0828cca80ee2f85f34c  wand-render

package/dist/native/darwin-arm64/wand-render.version

@@ -0,0 +1 @@
+0.1.1

package/dist/native/darwin-x64/wand-render.sha256

@@ -0,0 +1 @@
+783bd070dad27f2ec879ed5853f813f7ffdb3914d719d3ed947ec86af12a7b88  wand-render

package/dist/native/darwin-x64/wand-render.version

@@ -0,0 +1 @@
+0.1.1

package/dist/native/linux-arm64/wand-render.sha256

@@ -0,0 +1 @@
+7acb6e92e8f049ac87d8159905115dabe5f9a33f9d310e3c98f38b798c4302e5  wand-render

package/dist/native/linux-arm64/wand-render.version

@@ -0,0 +1 @@
+0.1.1

package/dist/native/linux-x64/wand-render.sha256

@@ -0,0 +1 @@
+7814590a02ae2606fedc395ee1708921aec3b16332edb46fa2369e43e9a589f5  wand-render

package/dist/native/linux-x64/wand-render.version

@@ -0,0 +1 @@
+0.1.1

package/dist/process-manager.d.ts

@@ -15,6 +15,11 @@ export declare class SessionInputError extends Error {
     readonly sessionStatus?: SessionSnapshot["status"] | undefined;
     constructor(message: string, code: "SESSION_NOT_FOUND" | "SESSION_NOT_RUNNING" | "SESSION_NO_PTY", sessionId: string, sessionStatus?: SessionSnapshot["status"] | undefined);
 }
+/** Write outcome is unknown to the caller; do not record this as accepted input. */
+export declare class PtyInputDeliveryError extends Error {
+    readonly sessionId: string;
+    constructor(sessionId: string, cause: unknown);
+}
 export declare class ProcessManager extends EventEmitter {
     private readonly config;
     private readonly storage;
@@ -39,6 +44,7 @@ export declare class ProcessManager extends EventEmitter {
     private bindRestoredTerminal;
     private initializeClaudeBridge;
     private bindTerminalProcess;
+    private handleTerminalResync;
     private handleTerminalExit;
     private handleTerminalData;
     on(_event: "process", listener: ProcessEventHandler): this;
@@ -107,6 +113,10 @@ export declare class ProcessManager extends EventEmitter {
      */
     setSessionMode(id: string, mode: ExecutionMode): SessionSnapshot;
     sendInput(id: string, input: string, view?: "chat" | "terminal", shortcutKey?: string, trackUserInput?: boolean): SessionSnapshot;
+    sendInputConfirmed(id: string, input: string, view?: "chat" | "terminal", shortcutKey?: string, trackUserInput?: boolean): Promise<SessionSnapshot>;
+    private preparePtyInput;
+    private validatePtyInput;
+    private trackPtyInput;
     resize(id: string, cols: number, rows: number): SessionSnapshot;
     getTerminalState(id: string): PtyTerminalSnapshot | null;
     /**

package/dist/process-manager.js

@@ -150,6 +150,15 @@ export class SessionInputError extends Error {
         this.name = "SessionInputError";
     }
 }
+/** Write outcome is unknown to the caller; do not record this as accepted input. */
+export class PtyInputDeliveryError extends Error {
+    sessionId;
+    constructor(sessionId, cause) {
+        super("PTY input delivery could not be confirmed.", { cause });
+        this.sessionId = sessionId;
+        this.name = "PtyInputDeliveryError";
+    }
+}
 const REAL_CONVERSATION_MIN_LINES = 2;
 const DISCOVERY_RECENT_WINDOW_MS = 10 * 60 * 1000;
 const START_TIME_SKEW_MS = 30 * 1000;
@@ -736,8 +745,9 @@ export class ProcessManager extends EventEmitter {
         });
     }
     bindTerminalProcess(record, child, onVisibleChunk) {
-        child.onExit(({ exitCode }) => this.handleTerminalExit(record, child, exitCode));
+        child.onResync?.((state) => this.handleTerminalResync(record, child, state));
         child.onData((event) => this.handleTerminalData(record, child, event, onVisibleChunk));
+        child.onExit(({ exitCode }) => this.handleTerminalExit(record, child, exitCode));
         if (record.ptyBridge) {
             record.ptyBridge.setPtyWrite((input) => {
                 if (this.sessions.get(record.id) !== record || record.ptyProcess !== child)
@@ -746,6 +756,31 @@ export class ProcessManager extends EventEmitter {
             });
         }
     }
+    handleTerminalResync(record, child, state) {
+        const current = this.sessions.get(record.id);
+        if (current !== record || current.ptyProcess !== child)
+            return;
+        current.terminalState?.dispose();
+        current.terminalState = restoreTerminalState(state);
+        current.output = state.output;
+        current.storedOutput = state.output;
+        current.ptyOutputSeq = state.seq;
+        current.ptyCols = state.cols;
+        current.ptyRows = state.rows;
+        current.ptyLaunchMarkerToken = state.launchMarkerToken;
+        current.providerShellMarker = state.launchMarkerToken
+            ? new PtyCliExitMarker(state.launchMarkerToken)
+            : null;
+        if (current.ptyBridge)
+            current.messages = current.ptyBridge.getMessages();
+        this.initializeClaudeBridge(current, state.output);
+        current.ptyBridge?.setPtyWrite((input) => {
+            if (this.sessions.get(record.id) === current && current.ptyProcess === child)
+                child.write(input);
+        });
+        this.flushPersist(current, true);
+        this.emitEvent({ type: "resync", sessionId: record.id, data: { reason: "render_replay_gap" } });
+    }
     handleTerminalExit(record, child, exitCode) {
         const current = this.sessions.get(record.id);
         // A stopped session can be resumed under the same public id before the old
@@ -1483,6 +1518,39 @@ export class ProcessManager extends EventEmitter {
         return this.snapshot(record);
     }
     sendInput(id, input, view, shortcutKey, trackUserInput = true) {
+        const record = this.preparePtyInput(id, input, view, shortcutKey, trackUserInput);
+        record.ptyProcess.write(input);
+        this.persist(record);
+        return this.snapshot(record);
+    }
+    async sendInputConfirmed(id, input, view, shortcutKey, trackUserInput = true) {
+        const record = this.validatePtyInput(id);
+        const terminal = record.ptyProcess;
+        try {
+            if (terminal.writeConfirmed)
+                await terminal.writeConfirmed(input);
+            else
+                terminal.write(input);
+        }
+        catch (cause) {
+            throw new PtyInputDeliveryError(id, cause);
+        }
+        const current = this.sessions.get(id);
+        if (current !== record || record.ptyProcess !== terminal) {
+            // The write reached an old PTY, but the caller cannot treat it as input
+            // accepted by the current incarnation or persist the stale record.
+            throw new PtyInputDeliveryError(id, new Error("PTY incarnation changed during write"));
+        }
+        this.trackPtyInput(record, input, view, shortcutKey, trackUserInput);
+        this.persist(record);
+        return this.snapshot(record);
+    }
+    preparePtyInput(id, input, view, shortcutKey, trackUserInput = true) {
+        const record = this.validatePtyInput(id);
+        this.trackPtyInput(record, input, view, shortcutKey, trackUserInput);
+        return record;
+    }
+    validatePtyInput(id) {
         if (this.disposed)
             throw new Error("ProcessManager has been disposed.");
         const record = this.mustGet(id);
@@ -1495,6 +1563,10 @@ export class ProcessManager extends EventEmitter {
             console.error(`[ProcessManager] Rejecting input: session ${id} has no PTY`);
             throw new SessionInputError("Session is not running.", "SESSION_NO_PTY", id, record.status);
         }
+        return record;
+    }
+    trackPtyInput(record, input, view, shortcutKey, trackUserInput = true) {
+        const id = record.id;
         if (!record.ptyTopicDraft)
             record.ptyTopicDraft = createPtyTopicLineBuffer();
         const topicInput = consumePtyInputForTopic(record.ptyTopicDraft, input, view, shortcutKey);
@@ -1516,9 +1588,6 @@ export class ProcessManager extends EventEmitter {
         if (record.ptyBridge && trackUserInput) {
             record.ptyBridge.onUserInput(input);
         }
-        record.ptyProcess.write(input);
-        this.persist(record);
-        return this.snapshot(record);
     }
     resize(id, cols, rows) {
         const record = this.mustGet(id);

package/dist/render-binary.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 支持的分发三元组。
+ *
+ * 与 `render-bin/manifest.json` 的版本条目键、`render/release.json` 的
+ * `supportedTriples` 必须一致；新增平台要同时改这三处与 CI 矩阵。
+ */
+export declare const SUPPORTED_RENDER_TRIPLES: readonly ["darwin-arm64", "darwin-x64", "linux-x64", "linux-arm64"];
+/** `uname -m` 的输出归一成 Node 的 arch 名；认不出返回 null（调用方回退 process.arch）。 */
+export declare function normalizeMachineArch(machine: string | null | undefined): string | null;
+/**
+ * 平台三元组（`darwin-arm64` 等）。
+ *
+ * 为什么不直接用 `process.arch`：macOS 上 Node 跑在 Rosetta 里时它报 `x64`，
+ * 而机器其实是 arm64 —— 于是会去找一个不存在（或架构不符）的产物，最后表现成
+ * 「自动模式下 Rust 引擎莫名其妙不生效」。`uname -m` 才反映真实硬件；只有
+ * `uname` 不可用（PATH 被清空、Windows）时才回退 `process.arch`。
+ *
+ * `rosettaTranslated` 是反向兜底：翻译态下 `uname -m` 同样报 `x86_64`，
+ * 只有 `sysctl.proc_translated` 能说明「这个 x64 进程跑在 arm64 机器上」。
+ * 少了它，上面那条规则在它最该生效的场景里形同虚设。
+ */
+export declare function resolveRenderTriple(platform: string, nodeArch: string, unameMachine: string | null, rosettaTranslated?: boolean): string;
+interface PlatformArchProbe {
+    unameMachine: string | null;
+    rosettaTranslated: boolean;
+}
+/**
+ * 真实架构探测（进程级缓存）：`resolveRenderBinaryPath` 在一次启动里会被调用多次，
+ * 不该每次都 spawn 两个进程。
+ */
+export declare function probePlatformArch(): PlatformArchProbe;
+/** 当前进程应使用的三元组。 */
+export declare function currentRenderTriple(): string;
+/**
+ * 约定候选路径（不含 `WAND_RENDER_BIN` 与 `PATH`，调用方单独处理）。
+ *
+ * 顺序刻意把「刚 cargo build 出来的」排在分发位置之前：开发机上调 Rust 引擎时
+ * 期望立刻生效，而不是被上一次安装的旧二进制盖住。
+ *
+ * 旧布局（`wand-rs/`、仓库根 `native/`）已不存在，候选里不留兼容分支：
+ * 留着只会让「引擎没生效」这类问题多一个静默的假来源。
+ */
+export declare function renderBinaryCandidates(configDir: string, triple: string): string[];
+/**
+ * 解析 wand-render 可执行文件。
+ *
+ * 顺序：`WAND_RENDER_BIN` → `<repo>/render/target/{release,debug}` → `<configDir>/bin`
+ * → `<repo>/dist/native/<triple>` → `PATH`。返回 null 表示「这台机器没有」，由调用方
+ * 按 engine 决定告警还是报错。
+ */
+export declare function resolveRenderBinaryPath(configPath: string): string | null;
+/**
+ * 读取 wand-render 的版本。
+ *
+ * 先读二进制旁边的 `wand-render.version` sidecar（就位脚本会写），读不到才去跑
+ * `wand-render --version` —— 启动路径上不该无谓地执行一个进程。
+ * 两种方式都失败时返回 null：调用方只要一个展示用版本号，拿不到不能影响启动。
+ */
+export declare function readRenderBinaryVersion(binaryPath: string): Promise<string | null>;
+export declare function isExecutableFile(candidate: string): boolean;
+export {};