@co0ontty/wand 4.89.0 → 4.89.2-beta.g9f64cf7

package/dist/local-model-setup.js

@@ -7,6 +7,7 @@ import { LAYA_FILES, LAYA_REPOSITORY, layaFileUrl } from "./laya-model-manifest.
 import { ModelFileStore } from "./model-file-store.js";
 import { runModelSetup } from "./model-setup-process.js";
 import { speechModel } from "./speech-models.js";
+import { speechSupport } from "./speech-support.js";
 import { systemEnvValue } from "./env-utils.js";
 import { decisionHardware } from "./decision-hardware.js";
 import { DECISION_EXPERT_ID } from "./decision-expert-identity.js";
@@ -20,6 +21,8 @@ export class LocalModelSetupService {
     jobs = new Map();
     sequence = 0;
     disposed = false;
+    speechEnableRevision = 0;
+    supportCache = null;
     constructor(deps) {
         this.deps = deps;
         this.files = new ModelFileStore(deps.fetch);
@@ -55,6 +58,7 @@ export class LocalModelSetupService {
         const hardware = decisionHardware();
         const operation = this.operations.get("laya") ?? null;
         const selected = speech.models.find((value) => value.id === speech.settings.model);
+        const support = await this.speechSupport(speech.runtime.available);
         return {
             laya: { kind: "laya", label: "LAYA 本地决策", supported,
                 reason: !supported ? hardware.message
@@ -62,12 +66,38 @@ export class LocalModelSetupService {
                 enabled: decision.enabled, model: LAYA_REPOSITORY, modelSize: this.manifest.reduce((sum, file) => sum + file.size, 0),
                 downloaded: model.downloaded, runtimeAvailable: !!python, initialized: decision.state === "ready", busy: this.jobs.has("laya") || decision.queued > 0 || decision.state === "loading",
                 operation: operation ? { ...operation } : null, hardware, decisionEmployeeId: DECISION_EXPERT_ID },
-            speech: { kind: "speech", label: "服务端语音识别", supported: ["darwin", "linux", "win32"].includes(process.platform), reason: speech.reason,
+            speech: { kind: "speech", label: "服务端语音识别", supported: support.supported, supportReason: support.reason, reason: speech.reason,
                 enabled: speech.settings.enabled, model: speech.settings.model, modelSize: selected?.size ?? 0,
                 downloaded: selected?.downloaded ?? false, runtimeAvailable: speech.runtime.available, initialized: speech.initialized === true,
                 busy: speech.busy || this.jobs.has("speech"), operation: this.operations.has("speech") ? { ...this.operations.get("speech") } : null },
         };
     }
+    speechSupport(runtimeAvailable) {
+        if (!this.supportCache || this.supportCache.expires < Date.now() || this.supportCache.runtimeAvailable !== runtimeAvailable) {
+            this.supportCache = { expires: Date.now() + 30_000, runtimeAvailable, value: (this.deps.speechSupport ?? speechSupport)(runtimeAvailable) };
+        }
+        return this.supportCache.value;
+    }
+    async setSpeechEnabled(enabled) {
+        const revision = ++this.speechEnableRevision;
+        const settingsRevision = this.deps.speech.settingsRevision();
+        if (this.disposed)
+            throw new DecisionError("UNAVAILABLE", "模型管理已关闭。", 503);
+        if (!enabled) {
+            this.cancel("speech");
+            this.deps.speech.configure({ enabled: false });
+            return;
+        }
+        const status = await this.deps.speech.status();
+        const support = await this.speechSupport(status.runtime.available);
+        if (revision !== this.speechEnableRevision || this.disposed || settingsRevision !== this.deps.speech.settingsRevision())
+            return;
+        if (!support.supported)
+            throw new DecisionError("UNSUPPORTED", support.reason || "本机不支持语音识别。", 409);
+        if (status.busy || status.download?.phase === "downloading")
+            throw new DecisionError("BUSY", "语音识别或模型下载正在进行，请稍后启用。", 409);
+        this.start("speech", "activate", {});
+    }
     parse(kind, raw) {
         if (!raw || typeof raw !== "object" || Array.isArray(raw))
             throw new DecisionError("INVALID_REQUEST", "模型操作参数无效。");
@@ -90,6 +120,8 @@ export class LocalModelSetupService {
             throw new DecisionError("UNAVAILABLE", "模型管理已关闭。", 503);
         if (kind === "laya" && !this.supported())
             throw new DecisionError("UNSUPPORTED", `LAYA-MLX 需要 Apple Silicon macOS 与 Metal；${decisionHardware().message}`, 409);
+        if (kind === "laya" && action === "activate")
+            throw new DecisionError("INVALID_REQUEST", "一键启用仅用于语音识别。");
         const input = this.parse(kind, raw);
         if (this.jobs.has(kind))
             throw new DecisionError("BUSY", "该模型已有安装任务，请等待或取消。", 409);
@@ -119,6 +151,8 @@ export class LocalModelSetupService {
         timer.unref();
         const signal = abort.signal;
         const phase = (value, message) => this.update(kind, id, { phase: value, message });
+        let activationMaintenance = false;
+        const settingsRevision = this.deps.speech.settingsRevision();
         try {
             if (kind === "laya") {
                 let model = await this.layaModel();
@@ -170,7 +204,7 @@ export class LocalModelSetupService {
             }
             else {
                 const selected = input.model ?? this.deps.speech.settings().model;
-                if (action === "download") {
+                if (action === "download" || action === "activate") {
                     phase("downloading", "下载并校验语音模型");
                     await this.deps.speech.startDownload(selected);
                     while (true) {
@@ -188,7 +222,12 @@ export class LocalModelSetupService {
                         });
                     }
                 }
-                else {
+                if (action !== "download") {
+                    if (action === "activate") {
+                        signal.throwIfAborted();
+                        this.deps.speech.acquireMaintenance();
+                        activationMaintenance = true;
+                    }
                     const status = await this.deps.speech.status();
                     signal.throwIfAborted();
                     const backend = input.backend === "auto" || !input.backend ? process.platform === "darwin" ? "metal" : "cpu" : input.backend;
@@ -207,22 +246,30 @@ export class LocalModelSetupService {
                             await rm(work, { recursive: true, force: true }).catch(() => { });
                         }
                     }
-                    phase("initializing", "加载所选语音模型并用合成静音检查，未启用识别或重启服务");
-                    await this.deps.speech.initializeModel(selected, signal);
+                    phase("initializing", action === "activate" ? "正在检查语音模型，完成后自动启用。" : "加载所选语音模型并用合成静音检查，未启用识别或重启服务");
+                    await this.deps.speech.initializeModel(selected, signal, action === "activate" ? "auto" : undefined);
+                    if (action === "activate") {
+                        signal.throwIfAborted();
+                        if (settingsRevision !== this.deps.speech.settingsRevision())
+                            throw new DecisionError("SETTINGS_CHANGED", "语音设置已由其他操作修改，本次启用已取消。");
+                        this.deps.speech.configure({ enabled: true, acceleration: "auto" });
+                    }
                 }
             }
             signal.throwIfAborted();
-            phase("completed", action === "download" ? "模型下载及完整性校验完成；可继续初始化" : "运行时和模型初始化检查完成；启用状态保持不变");
+            phase("completed", action === "activate" ? "服务端语音识别已启用。" : action === "download" ? "模型下载及完整性校验完成；可继续初始化" : "运行时和模型初始化检查完成；启用状态保持不变");
         }
         catch (error) {
             const cancelled = signal.aborted;
             const message = cancelled ? "安装任务已取消，完整文件保留，可重试" : error instanceof DecisionError || (error instanceof Error && /请先|校验|自定义|独立/.test(error.message))
                 ? error.message : "安装或初始化失败，请检查网络、编译工具/Python版本、磁盘空间和平台能力，再重试。";
             this.update(kind, id, { phase: cancelled ? "cancelled" : "failed", message, ...(cancelled ? {} : { error: message }) });
-            if (kind === "speech" && action === "download" && cancelled)
+            if (kind === "speech" && (action === "download" || action === "activate") && cancelled)
                 this.deps.speech.cancelDownload();
         }
         finally {
+            if (activationMaintenance)
+                this.deps.speech.releaseMaintenance();
             clearTimeout(timer);
         }
     }

package/dist/local-model-types.d.ts

@@ -3,7 +3,7 @@ export type LocalModelKind = "laya" | "speech";
 export type ModelSetupPhase = "downloading" | "verifying" | "runtime" | "initializing" | "completed" | "failed" | "cancelled";
 export interface ModelSetupOperation {
     id: number;
-    action: "download" | "initialize";
+    action: "download" | "initialize" | "activate";
     phase: ModelSetupPhase;
     message: string;
     received: number;
@@ -14,6 +14,7 @@ export interface LocalModelStatus {
     kind: LocalModelKind;
     label: string;
     supported: boolean;
+    supportReason?: string | null;
     reason: string | null;
     enabled: boolean;
     model: string;

package/dist/plush-avatar.d.ts

@@ -0,0 +1,100 @@
+/** Shared, versioned employee avatar contract. Keep v1 option IDs and seed rules stable across clients. */
+export declare const PLUSH_SHAPES: readonly [{
+    readonly id: "heart";
+    readonly label: "心形";
+}, {
+    readonly id: "triangle";
+    readonly label: "圆角三角";
+}, {
+    readonly id: "diamond";
+    readonly label: "菱形";
+}, {
+    readonly id: "round";
+    readonly label: "圆形";
+}, {
+    readonly id: "square";
+    readonly label: "圆角方形";
+}, {
+    readonly id: "capsule";
+    readonly label: "胶囊";
+}];
+export declare const PLUSH_COLORS: readonly [{
+    readonly id: "coral";
+    readonly label: "珊瑚";
+    readonly color: "#E99589";
+}, {
+    readonly id: "sage";
+    readonly label: "灰绿";
+    readonly color: "#A9BDA7";
+}, {
+    readonly id: "lavender";
+    readonly label: "淡紫";
+    readonly color: "#BFB0D9";
+}, {
+    readonly id: "cream";
+    readonly label: "奶油";
+    readonly color: "#E8D8B8";
+}, {
+    readonly id: "blue";
+    readonly label: "雾蓝";
+    readonly color: "#A9C6D5";
+}, {
+    readonly id: "ochre";
+    readonly label: "赭黄";
+    readonly color: "#D4AE65";
+}];
+export declare const PLUSH_GLASSES: readonly [{
+    readonly id: "none";
+    readonly label: "无眼镜";
+}, {
+    readonly id: "gold";
+    readonly label: "金框眼镜";
+}, {
+    readonly id: "ink";
+    readonly label: "黑框眼镜";
+}];
+export declare const PLUSH_HATS: readonly [{
+    readonly id: "none";
+    readonly label: "无帽子";
+}, {
+    readonly id: "beanie";
+    readonly label: "针织帽";
+}, {
+    readonly id: "beret";
+    readonly label: "贝雷帽";
+}];
+export type PlushShape = typeof PLUSH_SHAPES[number]["id"];
+export type PlushColor = typeof PLUSH_COLORS[number]["id"];
+export type PlushGlasses = typeof PLUSH_GLASSES[number]["id"];
+export type PlushHat = typeof PLUSH_HATS[number]["id"];
+export interface PlushAvatarConfig {
+    version: 1;
+    shape: PlushShape;
+    color: PlushColor;
+    glasses: PlushGlasses;
+    hat: PlushHat;
+}
+/** Two explicit source-derived cat heads; geometric defaults and legacy pixels stay unchanged. */
+export interface PlushCatAvatarConfig {
+    version: 1;
+    kind: "cat";
+    coat: "silver" | "orange";
+}
+export type PlushRenderConfig = PlushAvatarConfig | PlushCatAvatarConfig;
+export declare function isPlushCatAvatar(config: PlushRenderConfig): config is PlushCatAvatarConfig;
+export declare function parsePlushCatAvatar(value: string): PlushCatAvatarConfig | null;
+export declare function encodePlushCatAvatar(config: PlushCatAvatarConfig): string;
+/** Common identity projection; only an explicit cat value opts into this exception. */
+export declare function resolveEmployeeAvatar(identity: PlushAvatarIdentity): PlushRenderConfig | null;
+export interface PlushAvatarIdentity {
+    id?: string | null;
+    name?: string | null;
+    avatar?: string | null;
+}
+/** Only the exact known v1 contract is accepted for explicit configuration; no URL or future-version guessing. */
+export declare function parsePlushAvatar(value: string): PlushAvatarConfig | null;
+export declare function encodePlushAvatar(config: PlushAvatarConfig): string;
+/** Pure presentation default; never persist this from a GET, a render, or a preview. */
+export declare function defaultPlushAvatar({ id, name }: Pick<PlushAvatarIdentity, "id" | "name">): PlushAvatarConfig;
+/** Uploaded photos and explicit legacy cats keep their renderer; corrupt old values fall back without migration. */
+export declare function resolvePlushAvatar(identity: PlushAvatarIdentity): PlushAvatarConfig | null;

package/dist/plush-avatar.js

@@ -0,0 +1,96 @@
+/** Shared, versioned employee avatar contract. Keep v1 option IDs and seed rules stable across clients. */
+export const PLUSH_SHAPES = [
+    { id: "heart", label: "心形" },
+    { id: "triangle", label: "圆角三角" },
+    { id: "diamond", label: "菱形" },
+    { id: "round", label: "圆形" },
+    { id: "square", label: "圆角方形" },
+    { id: "capsule", label: "胶囊" },
+];
+export const PLUSH_COLORS = [
+    { id: "coral", label: "珊瑚", color: "#E99589" },
+    { id: "sage", label: "灰绿", color: "#A9BDA7" },
+    { id: "lavender", label: "淡紫", color: "#BFB0D9" },
+    { id: "cream", label: "奶油", color: "#E8D8B8" },
+    { id: "blue", label: "雾蓝", color: "#A9C6D5" },
+    { id: "ochre", label: "赭黄", color: "#D4AE65" },
+];
+export const PLUSH_GLASSES = [
+    { id: "none", label: "无眼镜" },
+    { id: "gold", label: "金框眼镜" },
+    { id: "ink", label: "黑框眼镜" },
+];
+export const PLUSH_HATS = [
+    { id: "none", label: "无帽子" },
+    { id: "beanie", label: "针织帽" },
+    { id: "beret", label: "贝雷帽" },
+];
+export function isPlushCatAvatar(config) {
+    return "kind" in config && config.kind === "cat";
+}
+export function parsePlushCatAvatar(value) {
+    if (value === "plush-cat:v1:silver")
+        return { version: 1, kind: "cat", coat: "silver" };
+    if (value === "plush-cat:v1:orange")
+        return { version: 1, kind: "cat", coat: "orange" };
+    return null;
+}
+export function encodePlushCatAvatar(config) {
+    const value = `plush-cat:v${config.version}:${config.coat}`;
+    if (config.kind !== "cat" || !parsePlushCatAvatar(value))
+        throw new Error("毛绒猫头像配置无效。");
+    return value;
+}
+/** Common identity projection; only an explicit cat value opts into this exception. */
+export function resolveEmployeeAvatar(identity) {
+    return parsePlushCatAvatar(identity.avatar ?? "") ?? resolvePlushAvatar(identity);
+}
+function hasId(options, id) {
+    return options.some(option => option.id === id);
+}
+/** Only the exact known v1 contract is accepted for explicit configuration; no URL or future-version guessing. */
+export function parsePlushAvatar(value) {
+    const parts = value.split(":");
+    if (parts.length !== 6 || parts[0] !== "plush" || parts[1] !== "v1")
+        return null;
+    const [, , shape, color, glasses, hat] = parts;
+    if (!hasId(PLUSH_SHAPES, shape) || !hasId(PLUSH_COLORS, color)
+        || !hasId(PLUSH_GLASSES, glasses) || !hasId(PLUSH_HATS, hat))
+        return null;
+    return { version: 1, shape, color, glasses, hat };
+}
+export function encodePlushAvatar(config) {
+    const value = `plush:v${config.version}:${config.shape}:${config.color}:${config.glasses}:${config.hat}`;
+    if (!parsePlushAvatar(value))
+        throw new Error("毛绒头像配置无效。");
+    return value;
+}
+/** FNV-1a followed by an avalanche: fixed 32-bit integer math, shared by Node and browsers. */
+function seedHash(seed) {
+    let hash = 0x811c9dc5;
+    for (let at = 0; at < seed.length; at += 1) {
+        hash = Math.imul(hash ^ seed.charCodeAt(at), 0x01000193);
+    }
+    hash = Math.imul(hash ^ (hash >>> 16), 0x85ebca6b);
+    hash = Math.imul(hash ^ (hash >>> 13), 0xc2b2ae35);
+    return (hash ^ (hash >>> 16)) >>> 0;
+}
+/** Pure presentation default; never persist this from a GET, a render, or a preview. */
+export function defaultPlushAvatar({ id, name }) {
+    const identity = (id ?? "").trim() || (name ?? "").trim() || "member";
+    const pick = (field, options) => options[seedHash(`plush:v1:${identity}:${field}`) % options.length].id;
+    return {
+        version: 1,
+        shape: pick("shape", PLUSH_SHAPES),
+        color: pick("color", PLUSH_COLORS),
+        glasses: pick("glasses", PLUSH_GLASSES),
+        hat: pick("hat", PLUSH_HATS),
+    };
+}
+/** Uploaded photos and explicit legacy cats keep their renderer; corrupt old values fall back without migration. */
+export function resolvePlushAvatar(identity) {
+    const avatar = identity.avatar ?? "";
+    if (avatar.startsWith("data:image/") || /^cat:\d+$/.test(avatar))
+        return null;
+    return parsePlushAvatar(avatar) ?? defaultPlushAvatar(identity);
+}

package/dist/process-manager.d.ts

@@ -3,6 +3,7 @@ import { EventEmitter } from "node:events";
 import { WandStorage } from "./storage.js";
 import { ExecutionMode, ProcessEventHandler, SessionProvider, SessionSnapshot, SessionSource, WandConfig } from "./types.js";
 import { type PermissionResolution } from "./claude-pty-bridge.js";
+import type { EmployeeTextDeps } from "./employee-text.js";
 import { type PtyTerminalSnapshot, type PtyHistoryPage } from "./pty-terminal-state.js";
 import { samplePtyForegrounds } from "./pty-foreground.js";
 import { type TerminalHost } from "./terminal-host.js";
@@ -34,6 +35,7 @@ export declare const PTY_TURN_IDLE_MS = 3000;
  */
 export declare const PTY_FOREGROUND_SAMPLE_MS = 1000;
 export interface ProcessManagerOptions {
+    free?: EmployeeTextDeps["free"];
     /** Overrides the non-Claude PTY turn quiet window (tests use a short one). */
     ptyTurnIdleMs?: number;
     /** Overrides the foreground-process-group sampling interval (tests use a short one). */
@@ -55,6 +57,7 @@ export declare class ProcessManager extends EventEmitter {
     private readonly ptyForegroundSampleMs;
     /** Foreground probe; injectable so tests can drive it without a real process table. */
     private readonly probePtyForegrounds;
+    private readonly free;
     private readonly resolveDecisionEvaluate;
     /** 24h archive scan timer */
     private archiveTimer;
@@ -177,7 +180,7 @@ export declare class ProcessManager extends EventEmitter {
      */
     setSessionModel(id: string, model: string | null): SessionSnapshot;
     /**
-     * 归档会先停掉还在跑的终端，但保留会话 ID 和 provider session id，恢复时用它们续上。
+     * 归档只写标记，保留正在运行的终端、会话 ID 和 provider session id。
      * 取消归档只清标记；重新拉起由恢复入口负责。
      */
     setSessionArchived(id: string, archived: boolean): SessionSnapshot;

package/dist/process-manager.js

@@ -26,7 +26,7 @@ import { recordIterationPrompt } from "./iteration-log.js";
 import { describePtySpawnFailure } from "./ensure-node-pty-helper.js";
 import { resolveSessionProvider, resolveSystemAiContext } from "./session-ai-context.js";
 import { resolveSessionCwd } from "./session-cwd.js";
-import { inferProviderFromCommand, providerCliCommand } from "./session-provider.js";
+import { inferProviderFromCommand, isSessionProvider, providerCliCommand } from "./session-provider.js";
 import { RETENTION_IDLE_MS } from "./retention.js";
 import { PtyTerminalState } from "./pty-terminal-state.js";
 import { isPtySubmitInput } from "./pty-turn-activity.js";
@@ -563,6 +563,7 @@ export class ProcessManager extends EventEmitter {
     ptyForegroundSampleMs;
     /** Foreground probe; injectable so tests can drive it without a real process table. */
     probePtyForegrounds;
+    free;
     resolveDecisionEvaluate;
     /** 24h archive scan timer */
     archiveTimer = null;
@@ -595,6 +596,7 @@ export class ProcessManager extends EventEmitter {
         this.ptyTurnIdleMs = options.ptyTurnIdleMs ?? PTY_TURN_IDLE_MS;
         this.ptyForegroundSampleMs = options.ptyForegroundSampleMs ?? PTY_FOREGROUND_SAMPLE_MS;
         this.probePtyForegrounds = options.samplePtyForegrounds ?? samplePtyForegrounds;
+        this.free = options.free;
         this.resolveDecisionEvaluate = options.resolveDecisionEvaluate ?? (() => undefined);
         this.terminalHost = terminalHost ?? new InProcessTerminalHost();
         this.logger = new SessionLogger(configDir || path.join(process.env.HOME || process.cwd(), ".wand"), config.shortcutLogMaxBytes);
@@ -1229,7 +1231,7 @@ export class ProcessManager extends EventEmitter {
                     ai: resolveSystemAiContext({
                         provider: groupProvider, runner: undefined, command: providerCliCommand(groupProvider),
                         structuredState: undefined, selectedModel: null, thinkingEffort: opts?.thinkingEffort,
-                    }, this.config, this.storage.getSystemSiliconEmployee()),
+                    }, this.config, this.storage.getSystemSiliconEmployee(), this.free),
                     cwd: resolveSessionCwd(cwd, this.config.defaultCwd),
                     language: this.config.language,
                 });
@@ -1775,13 +1777,10 @@ export class ProcessManager extends EventEmitter {
         return this.snapshot(record);
     }
     /**
-     * 归档会先停掉还在跑的终端，但保留会话 ID 和 provider session id，恢复时用它们续上。
+     * 归档只写标记，保留正在运行的终端、会话 ID 和 provider session id。
      * 取消归档只清标记；重新拉起由恢复入口负责。
      */
     setSessionArchived(id, archived) {
-        if (archived && this.mustGet(id).status === "running") {
-            this.stop(id);
-        }
         const record = this.mustGet(id);
         record.archived = archived;
         record.archivedAt = archived ? (record.archivedAt ?? new Date().toISOString()) : null;
@@ -2339,6 +2338,9 @@ export class ProcessManager extends EventEmitter {
             return;
         // 迭代提示词记录：和会话标题共用同一套「有没有信息量」判断，用户不用多做一步。
         recordIterationPrompt(this.storage, record, prompt, "session");
+        // 空白终端只执行 Shell 命令，不生成会话标题或调用系统员工总结。
+        if (!isSessionProvider(record.provider))
+            return;
         const blockedTitles = sessionTopicBlocklistForSnapshot(record, this.storage);
         // CLI 自己起了名字就归它，模型标题与输入首行都不再覆盖；取不到原生标题才走系统硅基员工。
         const hasNativeTitle = this.nativeTitles.has(id);
@@ -2354,7 +2356,7 @@ export class ProcessManager extends EventEmitter {
             input: prompt,
             cwd: record.cwd,
             language: this.config.language,
-            ai: resolveSystemAiContext(record, this.config, this.storage.getSystemSiliconEmployee()),
+            ai: resolveSystemAiContext(record, this.config, this.storage.getSystemSiliconEmployee(), this.free),
             readNativeTitle: () => readNativeSessionTitle(resolveSessionProvider(record), record.claudeSessionId, record.cwd),
             hasNativeTitle,
             onGenerating: (generating) => {

package/dist/server-employee-routes.d.ts

@@ -1,5 +1,6 @@
 import type { Express } from "express";
 import { type SiliconEmployee, type SiliconEmployeeDraft } from "./ai-team-types.js";
+import type { OpenRouterFreeModelsService } from "./openrouter-free-models.js";
 import type { WandStorage } from "./storage.js";
 import type { WandTaskAgent } from "./task-types.js";
 import type { WandConfig } from "./types.js";
@@ -8,15 +9,18 @@ export interface EmployeeDraftRequest {
     existingNames: string[];
 }
 /**
- * 内置员工只接受 agents；其余字段即使前端遗漏地发上来也必须与服务端一致，
- * 不一致直接拒绝（静默忽略会让客户端以为改成功了）。
+ * 其他内置员工只接受 agents；固定猫头员工另外接受资料的部分更新。
+ * 锁定字段即使由旧客户端或直接 API 发来，也必须一致；不一致明确拒绝。
  */
 export declare function parseSystemEmployeeAgents(value: unknown, existing: SiliconEmployee): WandTaskAgent[];
+/** Partial edits preserve omitted fields and the raw saved prompt, not a generated read projection. */
+export declare function parseFixedAvatarEmployeeInput(value: unknown, existing: SiliconEmployee, now: string): SiliconEmployee;
 export declare function parseSiliconEmployeeInput(value: unknown, existing: SiliconEmployee | null, now: string): SiliconEmployee;
 export declare function registerSiliconEmployeeRoutes(app: Express, deps: {
     storage: WandStorage;
     notifyEmployeeChanged?: (employeeId: string) => void;
     config?: WandConfig;
+    free?: Pick<OpenRouterFreeModelsService, "resolveForCall">;
     /** 测试注入点：默认按系统 AI 配置真实调用模型。 */
     generateDraft?: (request: EmployeeDraftRequest) => Promise<SiliconEmployeeDraft>;
     /** 测试注入点：CLI 可用性探测。 */