keepwork-sdk 1.0.2 → 1.0.3

package/dist-npm/keepwork-sdk.js

@@ -887,7 +887,7 @@ if (typeof window !== "undefined") {
   window.LocalStorageUtil = LocalStorageUtil;
   window.StorageUtil = StorageUtil;
 }
-const console$p = SDKLogger.createModuleConsole("PersonalPageStore");
+const console$q = SDKLogger.createModuleConsole("PersonalPageStore");
 class PersonalPageStoreBase {
   constructor(sdk) {
     // ──────────────────── 字段 ────────────────────
@@ -970,7 +970,7 @@ class PersonalPageStoreBase {
       try {
         handler(...args);
       } catch (e) {
-        console$p.warn(`PersonalPageStore: listener for '${event}' threw:`, e);
+        console$q.warn(`PersonalPageStore: listener for '${event}' threw:`, e);
       }
     }
   }
@@ -1087,7 +1087,7 @@ class PersonalPageStoreBase {
     if (typeof mountedFolder === "string") {
       const parts = mountedFolder.replace(/^\/+|\/+$/g, "").split("/").filter(Boolean);
       if (parts.length < 2) {
-        console$p.warn("PersonalPageStore: mountedFolder path requires at least username/workspace");
+        console$q.warn("PersonalPageStore: mountedFolder path requires at least username/workspace");
         return null;
       }
       const username = parts[0];
@@ -1098,7 +1098,7 @@ class PersonalPageStoreBase {
     if (typeof mountedFolder === "object" && mountedFolder !== null) {
       const m = mountedFolder;
       if (!m["username"] || !m["workspace"]) {
-        console$p.warn("PersonalPageStore: mountedFolder object requires username and workspace");
+        console$q.warn("PersonalPageStore: mountedFolder object requires username and workspace");
         return null;
       }
       return {
@@ -1107,7 +1107,7 @@ class PersonalPageStoreBase {
         remoteStorePath: m["remoteStorePath"] ?? this.remoteStorePath
       };
     }
-    console$p.warn("PersonalPageStore: mountedFolder must be a path string, object, or null");
+    console$q.warn("PersonalPageStore: mountedFolder must be a path string, object, or null");
     return null;
   }
   // ──────────────────── SearchPath ────────────────────
@@ -1127,10 +1127,10 @@ class PersonalPageStoreBase {
     if (existing) {
       existing.baseUrl = normalizedBaseUrl;
       existing.isReadonly = isReadonly;
-      console$p.log(`[PersonalPageStore] Updated search path: ${normalizedPrefix} -> ${normalizedBaseUrl} (readonly=${isReadonly})`);
+      console$q.log(`[PersonalPageStore] Updated search path: ${normalizedPrefix} -> ${normalizedBaseUrl} (readonly=${isReadonly})`);
     } else {
       this._searchPaths.push({ prefix: normalizedPrefix, baseUrl: normalizedBaseUrl, isReadonly });
-      console$p.log(`[PersonalPageStore] Added search path: ${normalizedPrefix} -> ${normalizedBaseUrl} (readonly=${isReadonly})`);
+      console$q.log(`[PersonalPageStore] Added search path: ${normalizedPrefix} -> ${normalizedBaseUrl} (readonly=${isReadonly})`);
     }
   }
   /**
@@ -1184,7 +1184,7 @@ class PersonalPageStoreBase {
         if (!resp.ok) continue;
         const text = await resp.text();
         if (text != null) {
-          console$p.log(`[PersonalPageStore] SearchPath found: ${effectiveName} -> ${fileUrl}`);
+          console$q.log(`[PersonalPageStore] SearchPath found: ${effectiveName} -> ${fileUrl}`);
           const pageKey = this._toInternalPageKey(pageName);
           this.personalPageData[pageKey] = this.personalPageData[pageKey] ?? {};
           this.setValueByPath(this.personalPageData[pageKey], "content", text);
@@ -1193,7 +1193,7 @@ class PersonalPageStoreBase {
       } catch {
       }
     }
-    console$p.log(`[PersonalPageStore] SearchPath not found: ${effectiveName}`);
+    console$q.log(`[PersonalPageStore] SearchPath not found: ${effectiveName}`);
     this._searchPathNotFound.add(effectiveName);
     return null;
   }
@@ -1457,7 +1457,7 @@ class PersonalPageStoreBase {
     const newUsername = username || null;
     if (this.overrideUsername !== newUsername) this.reset();
     this.overrideUsername = newUsername;
-    console$p.log(`PersonalPageStore: Override username set to: ${this.overrideUsername ?? "current user"}`);
+    console$q.log(`PersonalPageStore: Override username set to: ${this.overrideUsername ?? "current user"}`);
   }
   /**
    * 获取当前使用的用户名（override 或当前登录用户）。
@@ -1503,7 +1503,7 @@ class PersonalPageStoreBase {
     if (this.userProfileLoaded) return;
     try {
       if (!this.sdk.token) {
-        console$p.log("personalPageStore: No token set, using anonymous mode");
+        console$q.log("personalPageStore: No token set, using anonymous mode");
         return;
       }
       await ((_b2 = (_a2 = this.sdk).getUserProfile) == null ? void 0 : _b2.call(_a2, { useCache: true }));
@@ -4579,7 +4579,7 @@ class AudioEngine {
     };
   }
 }
-const console$o = SDKLogger.createModuleConsole("Speech");
+const console$p = SDKLogger.createModuleConsole("Speech");
 let _md5 = null;
 async function getMd5() {
   if (_md5) return _md5;
@@ -4651,7 +4651,7 @@ class Speech {
     if (valid.includes(mode)) {
       this.fallbackMode = mode;
     } else {
-      console$o.warn(`Invalid fallbackMode "${mode}", expected one of: ${valid.join(", ")}`);
+      console$p.warn(`Invalid fallbackMode "${mode}", expected one of: ${valid.join(", ")}`);
     }
   }
   /** 获取共享 AudioEngine 实例（优先 sdk.audioEngine，否则 AudioEngine.getShared()）。 */
@@ -4684,7 +4684,7 @@ class Speech {
     }
     const OfflineCtx = typeof window !== "undefined" ? window.OfflineAudioContext || window.webkitOfflineAudioContext : null;
     if (!OfflineCtx) {
-      console$o.warn("当前浏览器不支持 OfflineAudioContext，返回原始采样率音频");
+      console$p.warn("当前浏览器不支持 OfflineAudioContext，返回原始采样率音频");
       return audioBuffer;
     }
     const frameCount = Math.max(1, Math.ceil(audioBuffer.duration * nextSampleRate));
@@ -5013,7 +5013,7 @@ class Speech {
         }
       });
     } catch (error) {
-      console$o.error("停止音频播放时发生错误:", error);
+      console$p.error("停止音频播放时发生错误:", error);
     }
   }
   /** 停止所有音频（stopAllAudio 的别名）。 */
@@ -5038,10 +5038,10 @@ class Speech {
       audio.src = audioUrl;
       void ((_b2 = (_a2 = this.resumeSharedAudioEngine()) == null ? void 0 : _a2.finally) == null ? void 0 : _b2.call(_a2, () => {
         const p = audio.play();
-        if (p) p.catch((err) => console$o.error("Error playing YouDao audio:", err));
+        if (p) p.catch((err) => console$p.error("Error playing YouDao audio:", err));
       }));
     } catch (e) {
-      console$o.error("Error with YouDao API:", e);
+      console$p.error("Error with YouDao API:", e);
     }
   }
   // ──────────────────── 语音转文字（STT）────────────────────
@@ -5058,10 +5058,10 @@ class Speech {
       maxDuration: 60,
       sampleRate: 16e3,
       format: "wav",
-      onStart: () => console$o.log("录音开始"),
-      onStop: () => console$o.log("录音停止"),
-      onError: (e) => console$o.error("录音错误:", e),
-      onResult: (r) => console$o.log("识别结果:", r),
+      onStart: () => console$p.log("录音开始"),
+      onStop: () => console$p.log("录音停止"),
+      onError: (e) => console$p.error("录音错误:", e),
+      onResult: (r) => console$p.log("识别结果:", r),
       ...options
     };
     if (!((_a2 = navigator.mediaDevices) == null ? void 0 : _a2.getUserMedia)) throw new Error("当前浏览器不支持录音功能，请使用现代浏览器并确保在HTTPS环境下访问");
@@ -5295,7 +5295,7 @@ class Speech {
     });
   }
 }
-const console$n = SDKLogger.createModuleConsole("MqttManager");
+const console$o = SDKLogger.createModuleConsole("MqttManager");
 class MqttManager {
   constructor() {
     __publicField(this, "client", null);
@@ -5367,11 +5367,11 @@ class MqttManager {
           }
         }
       } catch (e) {
-        console$n.error("Failed to load MQTT config from storage:", e);
+        console$o.error("Failed to load MQTT config from storage:", e);
       }
     }
     if (!effectiveConfig) {
-      console$n.error("MQTT connect: No config provided and no stored config");
+      console$o.error("MQTT connect: No config provided and no stored config");
       this.status = "error";
       this.emit("statusChange", this.status);
       return;
@@ -5379,7 +5379,7 @@ class MqttManager {
     try {
       await this.LoadMQTT();
     } catch (e) {
-      console$n.error("Failed to load MQTT library:", e);
+      console$o.error("Failed to load MQTT library:", e);
       this.status = "error";
       this.emit("statusChange", this.status);
       return;
@@ -5403,7 +5403,7 @@ class MqttManager {
       reconnectPeriod: 5e3,
       connectTimeout: 30 * 1e3
     };
-    console$n.log("Connecting to MQTT with options:", connectOptions);
+    console$o.log("Connecting to MQTT with options:", connectOptions);
     try {
       this.client = mqtt.connect(connectOptions);
       this.client.on("connect", () => {
@@ -5411,7 +5411,7 @@ class MqttManager {
         topics == null ? void 0 : topics.forEach((topic) => this.subscribe(topic));
       });
       this.client.on("error", (err) => {
-        console$n.error("MQTT Error:", err);
+        console$o.error("MQTT Error:", err);
         this.status = "error";
         this.emit("statusChange", this.status);
         this.emit("error", err);
@@ -5425,7 +5425,7 @@ class MqttManager {
       this.client.on("reconnect", () => {
         var _a3;
         this.retryCount++;
-        console$n.log(`MQTT Reconnecting... (${this.retryCount}/${this.maxRetries})`);
+        console$o.log(`MQTT Reconnecting... (${this.retryCount}/${this.maxRetries})`);
         if (this.retryCount > this.maxRetries) {
           (_a3 = this.client) == null ? void 0 : _a3.end();
           this.status = "error";
@@ -5434,21 +5434,21 @@ class MqttManager {
         }
       });
     } catch (e) {
-      console$n.error("MQTT Connection Exception:", e);
+      console$o.error("MQTT Connection Exception:", e);
       this.status = "error";
       this.emit("statusChange", this.status);
     }
   }
   /** @private 连接成功回调。 */
   OnConnect() {
-    console$n.log("MQTT Connected");
+    console$o.log("MQTT Connected");
     this.status = "connected";
     this.retryCount = 0;
     this.emit("statusChange", this.status);
   }
   /** @private 连接关闭回调。 */
   OnClose() {
-    console$n.log("MQTT Closed");
+    console$o.log("MQTT Closed");
     if (this.status !== "disconnected") {
       this.status = "disconnected";
       this.emit("statusChange", this.status);
@@ -5459,7 +5459,7 @@ class MqttManager {
    */
   OnMessage(topic, message) {
     const msgStr = String(message);
-    console$n.log(`message ${msgStr}
+    console$o.log(`message ${msgStr}
 On topic: ${topic}`);
     localStorage.setItem(`mqtt_msg_${topic}`, msgStr);
     this.emit("message", { topic, message: msgStr });
@@ -5486,7 +5486,7 @@ On topic: ${topic}`);
     var _a2;
     if ((_a2 = this.client) == null ? void 0 : _a2.connected) {
       this.client.subscribe(topic, (err) => {
-        if (!err) console$n.log(`Subscribed to ${topic}`);
+        if (!err) console$o.log(`Subscribed to ${topic}`);
       });
     }
   }
@@ -6282,7 +6282,7 @@ class SandboxToolEnv {
     });
   }
 }
-const console$m = SDKLogger.createModuleConsole("AgentTool");
+const console$n = SDKLogger.createModuleConsole("AgentTool");
 class AgentTool {
   constructor(sdk) {
     __publicField(this, "sdk");
@@ -6322,7 +6322,7 @@ class AgentTool {
       } = args;
       if (!task) return "Failed: 'task' is a required parameter.";
       const resolvedAgentName = agentName || this.currentAgentName(session);
-      console$m.log(`[CopilotTools] runAsyncAgentTask session='${session.name ?? "root"}' target='${resolvedAgentName}' callbackMode=${callbackMode ?? "delay"} task=${this.summarizeDebugValue(task)}`);
+      console$n.log(`[CopilotTools] runAsyncAgentTask session='${session.name ?? "root"}' target='${resolvedAgentName}' callbackMode=${callbackMode ?? "delay"} task=${this.summarizeDebugValue(task)}`);
       const expandedTask = await this.expandTemplate(session, task, "task");
       const expandedSystemPrompt = await this.expandTemplate(session, systemPrompt, "systemPrompt");
       const router = (_a2 = this.sdk) == null ? void 0 : _a2.agentRouter;
@@ -6447,11 +6447,11 @@ class AgentTool {
     if (!value.includes("${") && !/^\s*\/\S+/.test(value)) return value;
     try {
       const expanded = await session.sandbox.processTemplate(value);
-      console$m.log(`[CopilotTools] runAsyncAgentTask ${label} expanded via sandbox: ${this.summarizeDebugValue(expanded)}`);
+      console$n.log(`[CopilotTools] runAsyncAgentTask ${label} expanded via sandbox: ${this.summarizeDebugValue(expanded)}`);
       return expanded;
     } catch (e) {
       if (e && e["isRestartAgentSignal"]) throw e;
-      console$m.warn(`[CopilotTools] runAsyncAgentTask: ${label} template expansion failed. Error: ${e.message}`);
+      console$n.warn(`[CopilotTools] runAsyncAgentTask: ${label} template expansion failed. Error: ${e.message}`);
       return value;
     }
   }
@@ -6493,7 +6493,7 @@ ${resultText}`;
       try {
         await ((_a3 = target == null ? void 0 : target["sendMessage"]) == null ? void 0 : _a3.call(target, payload));
       } catch (e) {
-        console$m.error(`[CopilotTools] ${targetLabel}.sendMessage failed:`, e);
+        console$n.error(`[CopilotTools] ${targetLabel}.sendMessage failed:`, e);
       }
     }).catch(async (e) => {
       var _a3;
@@ -6501,7 +6501,7 @@ ${resultText}`;
       try {
         await ((_a3 = target == null ? void 0 : target["sendMessage"]) == null ? void 0 : _a3.call(target, payload));
       } catch (e2) {
-        console$m.error(`[CopilotTools] ${targetLabel}.sendMessage failed:`, e2);
+        console$n.error(`[CopilotTools] ${targetLabel}.sendMessage failed:`, e2);
       }
     });
     return `Task submitted to agent '${agentName}'. The agent is working in a brand-new background session. Results will be delivered as a message via ${targetLabel} when complete.`;
@@ -6587,7 +6587,7 @@ __publicField(AgentTool, "definitions", [
     }
   }
 ]);
-const console$l = SDKLogger.createModuleConsole("PersonalPageTool");
+const console$m = SDKLogger.createModuleConsole("PersonalPageTool");
 class PersonalPageTool {
   constructor(sdk) {
     __publicField(this, "sdk");
@@ -6630,19 +6630,19 @@ class PersonalPageTool {
     }
     if (name === "personal_page_load") {
       try {
-        console$l.log(`[PersonalPageTool] Loading data from file '${filePageName}', key '${storageKey}'`);
+        console$m.log(`[PersonalPageTool] Loading data from file '${filePageName}', key '${storageKey}'`);
         if (!this.sdk.personalPageStore) throw new Error("SDK PersonalPageStore not available");
         const data = storageKey ? await this.sdk.personalPageStore.loadPageData(filePageName, storageKey) : await this.sdk.personalPageStore.loadPageData(filePageName);
         return JSON.stringify(data);
       } catch (e) {
-        console$l.error("[PersonalPageTool] Load failed:", e);
+        console$m.error("[PersonalPageTool] Load failed:", e);
         return `Failed to load data: ${e.message}`;
       }
     }
     if (name === "personal_page_save") {
       const { data, bForceFlush } = args;
       try {
-        console$l.log(`[PersonalPageTool] Saving data to file '${filePageName}', key '${storageKey}'`, data);
+        console$m.log(`[PersonalPageTool] Saving data to file '${filePageName}', key '${storageKey}'`, data);
         if (!this.sdk.personalPageStore) throw new Error("SDK PersonalPageStore not available");
         await this.sdk.personalPageStore.savePageData(
           filePageName,
@@ -6652,7 +6652,7 @@ class PersonalPageTool {
         );
         return "Data saved successfully.";
       } catch (e) {
-        console$l.error("[PersonalPageTool] Save failed:", e);
+        console$m.error("[PersonalPageTool] Save failed:", e);
         return `Failed to save data: ${e.message}`;
       }
     }
@@ -6712,7 +6712,7 @@ __publicField(PersonalPageTool, "definitions", [
     }
   }
 ]);
-const console$k = SDKLogger.createModuleConsole("ExecuteTool");
+const console$l = SDKLogger.createModuleConsole("ExecuteTool");
 const AsyncFunction = Object.getPrototypeOf(async function() {
 }).constructor;
 class ExecuteTool {
@@ -6762,7 +6762,7 @@ class ExecuteTool {
   async runAppCmd(code, config = {}) {
     const logs = [];
     try {
-      const originalConsole = console$k;
+      const originalConsole = console$l;
       const wrappedConsole = Object.create(originalConsole);
       const consoleMethods = ["log", "info", "warn", "error", "debug"];
       for (const level of consoleMethods) {
@@ -7901,7 +7901,7 @@ __publicField(AppTools, "definitions", [
     }
   }
 ]);
-const console$j = SDKLogger.createModuleConsole("AIChat");
+const console$k = SDKLogger.createModuleConsole("AIChat");
 class AIChat {
   constructor(sdk) {
     __publicField(this, "sdk");
@@ -7993,7 +7993,7 @@ class AIChat {
       try {
         token = window.localStorage.getItem("token");
       } catch (e) {
-        console$j.warn("Failed to get token from localStorage:", e);
+        console$k.warn("Failed to get token from localStorage:", e);
       }
     }
     if (token) headers["authorization"] = `Bearer ${token}`;
@@ -8107,7 +8107,7 @@ class AIChat {
       const session = options._session;
       for (const toolCall of toolCalls) {
         if (session == null ? void 0 : session._restartSignal) {
-          console$j.log("[AIChat] _restartSignal detected, aborting tool loop");
+          console$k.log("[AIChat] _restartSignal detected, aborting tool loop");
           break;
         }
         const fnName = (_d = toolCall.function) == null ? void 0 : _d.name;
@@ -8120,14 +8120,14 @@ class AIChat {
             if (session) session["_restartSignal"] = error;
             throw error;
           }
-          console$j.error("Tool call execution failed:", error);
+          console$k.error("Tool call execution failed:", error);
           const errorResult = { error: error.message ?? "Tool execution failed" };
           toolResults.push({ tool_call_id: toolCall.id, result: errorResult });
           (_f = options.onToolResult) == null ? void 0 : _f.call(options, { name: fnName, toolCallId: toolCall.id, result: errorResult });
         }
       }
       if (session == null ? void 0 : session._restartSignal) {
-        console$j.log("[AIChat] _restartSignal detected, aborting chat recursion");
+        console$k.log("[AIChat] _restartSignal detected, aborting chat recursion");
         return assistantContent ?? "";
       }
       for (const toolResult of toolResults) {
@@ -8204,7 +8204,7 @@ class AIChat {
     throw new Error("createSession not yet initialized — ensure AIChat.session.ts is imported");
   }
 }
-const console$i = SDKLogger.createModuleConsole("ChildSessionMixin");
+const console$j = SDKLogger.createModuleConsole("ChildSessionMixin");
 function _generateUUID() {
   if (typeof crypto !== "undefined" && crypto.randomUUID) return crypto.randomUUID();
   return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
@@ -8275,7 +8275,7 @@ const childSessionMethods = {
     if (this.sandbox) childSession["sandbox"] = this.sandbox;
     const entry = { session: childSession, queue: [], isRunning: false };
     this._childSessions[name] = entry;
-    console$i.log(`[ChildSessionMixin] Child agent '${name}' created`);
+    console$j.log(`[ChildSessionMixin] Child agent '${name}' created`);
     return entry;
   },
   /**
@@ -8302,7 +8302,7 @@ const childSessionMethods = {
 2. ${task}`;
       if (tools) last.tools = [.../* @__PURE__ */ new Set([...last.tools, ...tools])];
       last.maxIterations = Math.max(last.maxIterations, maxIterations);
-      console$i.log(`[ChildSessionMixin] Merged task into queue for child '${name}'`);
+      console$j.log(`[ChildSessionMixin] Merged task into queue for child '${name}'`);
       return last.promise;
     }
     let resolve;
@@ -8377,15 +8377,15 @@ const childSessionMethods = {
         const result = typeof response === "string" ? response : (response == null ? void 0 : response["result"]) ?? "";
         const taskSummary = taskObj.description ?? (taskObj.task.length > 80 ? taskObj.task.slice(0, 80) + "..." : taskObj.task);
         this._pendingChildResults.push({ agentName: name, taskId: taskObj.id, taskSummary, result });
-        console$i.log(`[ChildSessionMixin] Child '${name}' completed task ${taskObj.id}; pendingChildResults=${this._pendingChildResults.length}; result=${_summarize(result)}`);
+        console$j.log(`[ChildSessionMixin] Child '${name}' completed task ${taskObj.id}; pendingChildResults=${this._pendingChildResults.length}; result=${_summarize(result)}`);
         (_h = self._handleChildCallback) == null ? void 0 : _h.call(self, taskObj.callbackMode, taskObj.debounceSeconds);
         taskObj.resolve(result);
       } catch (e) {
-        console$i.error(`[ChildSessionMixin] Child '${name}' task ${taskObj.id} failed:`, e);
+        console$j.error(`[ChildSessionMixin] Child '${name}' task ${taskObj.id} failed:`, e);
         const errorResult = { error: e.message ?? "Child agent task failed" };
         const taskSummary = taskObj.description ?? (taskObj.task.length > 80 ? taskObj.task.slice(0, 80) + "..." : taskObj.task);
         this._pendingChildResults.push({ agentName: name, taskId: taskObj.id, taskSummary, result: errorResult });
-        console$i.warn(`[ChildSessionMixin] Child '${name}' failure queued; taskId=${taskObj.id}; pendingChildResults=${this._pendingChildResults.length}; result=${_summarize(errorResult)}`);
+        console$j.warn(`[ChildSessionMixin] Child '${name}' failure queued; taskId=${taskObj.id}; pendingChildResults=${this._pendingChildResults.length}; result=${_summarize(errorResult)}`);
         (_i = self._handleChildCallback) == null ? void 0 : _i.call(self, taskObj.callbackMode, taskObj.debounceSeconds);
         taskObj.reject(e);
       }
@@ -8415,7 +8415,7 @@ const childSessionMethods = {
       try {
         this.onChildStream(event);
       } catch (e) {
-        console$i.warn("[ChildSessionMixin] onChildStream callback error:", e);
+        console$j.warn("[ChildSessionMixin] onChildStream callback error:", e);
       }
     }
   },
@@ -8435,7 +8435,7 @@ const childSessionMethods = {
     const results = this._pendingChildResults;
     this._pendingChildResults = [];
     if (results.length > 0) {
-      console$i.log(
+      console$j.log(
         `[ChildSessionMixin] _consumePendingChildResults session='${this.name ?? "root"}' consumed ${results.length} result(s): ` + results.map((item) => `${item.agentName}:${item.taskId}:${_summarize(item.result, 80)}`).join(" | ")
       );
     }
@@ -8452,7 +8452,7 @@ const childSessionMethods = {
    */
   _handleChildCallback(mode, debounceSeconds) {
     var _a2, _b2;
-    console$i.log(
+    console$j.log(
       `[ChildSessionMixin] _handleChildCallback session='${this.name ?? "root"}' mode=${mode ?? "delay"} debounceSeconds=${debounceSeconds ?? 5} pendingChildResults=${this._pendingChildResults.length}`
     );
     const selfCb = this;
@@ -8468,7 +8468,7 @@ const childSessionMethods = {
    * @private
    */
   async _triggerImmediateCallback() {
-    console$i.warn("[ChildSessionMixin] _triggerImmediateCallback not overridden — child results will accumulate until next send.");
+    console$j.warn("[ChildSessionMixin] _triggerImmediateCallback not overridden — child results will accumulate until next send.");
   },
   /**
    * 延迟执行 `_triggerImmediateCallback`（用于 debounce 模式）。
@@ -8481,7 +8481,7 @@ const childSessionMethods = {
       await this._triggerImmediateCallback();
     }, seconds * 1e3);
     this._debounceTimers.push(timerId);
-    console$i.log(`[ChildSessionMixin] Debounce callback set: ${seconds}s pendingChildResults=${this._pendingChildResults.length}`);
+    console$j.log(`[ChildSessionMixin] Debounce callback set: ${seconds}s pendingChildResults=${this._pendingChildResults.length}`);
   },
   /**
    * 取消所有待处理的 debounce 定时器。
@@ -8535,7 +8535,137 @@ const childSessionMethods = {
     this._pendingChildResults = [];
   }
 };
-const console$h = SDKLogger.createModuleConsole("ImageUtils");
+function detectFormat(url) {
+  if (!url || typeof url !== "string") return null;
+  const path = url.split(/[?#]/)[0].toLowerCase();
+  if (path.endsWith(".json")) return "json";
+  if (path.endsWith(".yml") || path.endsWith(".yaml")) return "yml";
+  if (path.endsWith(".md")) return "md";
+  return null;
+}
+function normalize(config) {
+  if (!config || typeof config !== "object") return config;
+  if (config.content && !config.system_prompt) {
+    const body = String(config.content).trim();
+    if (body) config.system_prompt = body;
+  }
+  delete config.content;
+  if (config.workspace) {
+    if (!config.tools) config.tools = {};
+    if (!config.tools.fileOps) config.tools.fileOps = { enabled: false };
+    if (!config.tools.fileOps.workspace) {
+      config.tools.fileOps.workspace = config.workspace;
+    }
+  }
+  if (config.mountFolder) {
+    if (!config.tools) config.tools = {};
+    if (!config.tools.fileOps) config.tools.fileOps = { enabled: false };
+    if (!config.tools.fileOps.mountFolder) {
+      config.tools.fileOps.mountFolder = config.mountFolder;
+    }
+  }
+  if (config.history_length !== void 0 && config.historyLength === void 0) {
+    config.historyLength = config.history_length;
+  }
+  delete config.history_length;
+  return config;
+}
+function parseTable(tableText) {
+  if (!tableText || typeof tableText !== "string") return {};
+  const lines = tableText.split("\n").map((l) => l.trim()).filter((l) => l.startsWith("|"));
+  if (lines.length < 2) return {};
+  const headerCells = lines[0].split("|").map((c) => c.trim()).filter(Boolean);
+  const dataLines = lines.slice(2);
+  const rows = dataLines.map((line) => {
+    const cells = line.split("|").map((c) => c.trim()).filter(Boolean);
+    const row = {};
+    headerCells.forEach((h, i) => {
+      row[h] = cells[i] !== void 0 ? cells[i] : "";
+    });
+    return row;
+  });
+  if (headerCells.length === 2) {
+    const [keyCol, valCol] = headerCells;
+    const isKV = keyCol.toLowerCase() === "key" && valCol.toLowerCase() === "value";
+    if (isKV) {
+      const obj = {};
+      for (const row of rows) {
+        const k = row[keyCol];
+        if (k) obj[k] = _coerceValue(row[valCol]);
+      }
+      return obj;
+    }
+  }
+  return rows;
+}
+function _coerceValue(v) {
+  if (v === "true") return true;
+  if (v === "false") return false;
+  if (v === "null" || v === "") return null;
+  const n = Number(v);
+  if (!isNaN(n) && v.trim() !== "") return n;
+  return v;
+}
+function parse(text, formatHint) {
+  if (!text || typeof text !== "string") return {};
+  const trimmed = text.trim();
+  if (formatHint === "json" || trimmed.startsWith("{") || trimmed.startsWith("[")) {
+    return normalize(JSON.parse(trimmed));
+  }
+  if (trimmed.startsWith("---\n") || trimmed.startsWith("---\r\n")) {
+    const YML = _getYMLParser();
+    if (YML) return normalize(YML.yamlToObject(trimmed, true));
+  }
+  const firstLine = trimmed.split("\n").find((l) => l.trim());
+  if (firstLine && firstLine.trim().startsWith("|")) {
+    return normalize(parseTable(trimmed));
+  }
+  try {
+    return normalize(JSON.parse(trimmed));
+  } catch {
+    const YML = _getYMLParser();
+    if (YML) return normalize(YML.yamlToObject(trimmed, true));
+  }
+  return {};
+}
+async function fetchConfig(source) {
+  if (source && typeof source === "object") {
+    return normalize({ ...source });
+  }
+  if (typeof source !== "string" || !source.trim()) {
+    throw new Error("AgentConfig.fetch: source must be a non-empty string or object");
+  }
+  const trimmed = source.trim();
+  if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
+    return normalize(JSON.parse(trimmed));
+  }
+  const resp = await fetch(trimmed);
+  if (!resp.ok) {
+    throw new Error(`AgentConfig.fetch: fetch failed (${resp.status}) for ${trimmed}`);
+  }
+  let text = await resp.text();
+  text = text.replace(
+    /<script[^>]*\/___vscode_livepreview_injected_script[^>]*><\/script>\s*/gi,
+    ""
+  );
+  const format = detectFormat(trimmed);
+  return parse(text, format);
+}
+function _getYMLParser() {
+  if (typeof YMLParser !== "undefined") return YMLParser;
+  if (typeof window !== "undefined" && window.YMLParser) {
+    return window.YMLParser;
+  }
+  return null;
+}
+const AgentConfig = {
+  detectFormat,
+  normalize,
+  parse,
+  parseTable,
+  fetch: fetchConfig
+};
+const console$i = SDKLogger.createModuleConsole("ImageUtils");
 const DEFAULT_MAX_BYTES = 32 * 1024;
 function base64ByteSize(base64) {
   const len = base64.length;
@@ -8578,7 +8708,7 @@ async function compressBase64Image(inputBase64, options = {}) {
     for (const quality of QUALITY_STEPS) {
       const result = canvasToBase64(img, width, height, quality);
       if (result.byteSize <= maxBytes) {
-        console$h.log(
+        console$i.log(
           `[ImageUtils] Compressed image: ${width}x${height} q=${quality} → ${(result.byteSize / 1024).toFixed(1)} KB`
         );
         return result.base64;
@@ -8588,7 +8718,7 @@ async function compressBase64Image(inputBase64, options = {}) {
     height = Math.max(1, Math.floor(height / 2));
   }
   const final = canvasToBase64(img, width, height, 0.2);
-  console$h.warn(
+  console$i.warn(
     `[ImageUtils] Could not compress below ${maxBytes} bytes; final size ${final.byteSize}`
   );
   return final.base64;
@@ -8658,7 +8788,7 @@ async function uploadTempVisionImage(base64OrDataURI, options = {}) {
       try {
         const headResp = await fetch(cdnUrl, { method: "HEAD" });
         if (headResp.ok) {
-          console$h.log(`[ImageUtils] File already exists at ${cdnUrl}, skipping upload`);
+          console$i.log(`[ImageUtils] File already exists at ${cdnUrl}, skipping upload`);
           return cdnUrl;
         }
       } catch {
@@ -8686,7 +8816,7 @@ async function uploadTempVisionImage(base64OrDataURI, options = {}) {
   if (!uploadResp.ok) {
     throw new Error(`[ImageUtils] Qiniu upload failed: HTTP ${uploadResp.status}`);
   }
-  console$h.log(`[ImageUtils] Uploaded to ${cdnUrl} (${(blob.size / 1024).toFixed(1)} KB)`);
+  console$i.log(`[ImageUtils] Uploaded to ${cdnUrl} (${(blob.size / 1024).toFixed(1)} KB)`);
   return cdnUrl;
 }
 let _cachedMd5 = null;
@@ -8706,7 +8836,7 @@ async function _getMd5() {
   }
   return _cachedMd5;
 }
-const console$g = SDKLogger.createModuleConsole("AIChat");
+const console$h = SDKLogger.createModuleConsole("AIChat");
 class ChatSession {
   constructor(aiChat, options = {}) {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -8795,7 +8925,7 @@ class ChatSession {
       if (router) {
         this._registeredAsAgent = ((_b2 = router.register) == null ? void 0 : _b2.call(router, this.name, this)) ?? false;
         if (!this._registeredAsAgent) {
-          console$g.warn(`[ChatSession] Failed to register agent '${this.name}' — name may already be taken.`);
+          console$h.warn(`[ChatSession] Failed to register agent '${this.name}' — name may already be taken.`);
         }
       }
     }
@@ -8844,7 +8974,7 @@ class ChatSession {
     this._workspaceExplicitlySet = true;
     this.workspace = nextWorkspace;
     if (this.sandbox) this.sandbox.workspace = nextSandboxWorkspace;
-    console$g.log(`[ChatSession] Workspace set to: ${this.workspace ?? "(none)"}`);
+    console$h.log(`[ChatSession] Workspace set to: ${this.workspace ?? "(none)"}`);
   }
   /**
    * 设置只读回退层的 mountFolder 配置。
@@ -8853,7 +8983,7 @@ class ChatSession {
   setMountFolder(mountFolderConfig) {
     this.mountFolder = mountFolderConfig ?? null;
     if (this.sandbox) this.sandbox.mountFolder = this.mountFolder;
-    console$g.log(`[ChatSession] MountFolder set to: ${this.mountFolder ?? "(none)"}`);
+    console$h.log(`[ChatSession] MountFolder set to: ${this.mountFolder ?? "(none)"}`);
   }
   /** 设置 API 缓存 Key（传递给 aiGenerators.chat）。 */
   setAPICacheKey(key) {
@@ -8922,7 +9052,7 @@ class ChatSession {
       const s = typeof v === "string" ? v : JSON.stringify(v);
       return s.length > 180 ? s.slice(0, 180) + "..." : s;
     };
-    console$g.log(`[ChatSession.send] start session='${this.name ?? "root"}' userMessage=${summarizeDebugValue2(userMessage)}`);
+    console$h.log(`[ChatSession.send] start session='${this.name ?? "root"}' userMessage=${summarizeDebugValue2(userMessage)}`);
     try {
       let resolvedUserMessage = userMessage;
       const effectiveOptions = {
@@ -8934,11 +9064,11 @@ class ChatSession {
       const shouldProcessTemplate = effectiveOptions.runCode === true && typeof userMessage === "string";
       if (shouldProcessTemplate) {
         resolvedUserMessage = await this.sandbox.processTemplate(userMessage);
-        console$g.log(`[ChatSession.send] runCode resolved userMessage=${summarizeDebugValue2(resolvedUserMessage)}`);
+        console$h.log(`[ChatSession.send] runCode resolved userMessage=${summarizeDebugValue2(resolvedUserMessage)}`);
       }
       const childResults = ((_b2 = this._consumePendingChildResults) == null ? void 0 : _b2.call(this)) ?? [];
       if (childResults.length > 0) {
-        console$g.log(`[ChatSession.send] injecting ${childResults.length} pending child result(s) into session='${this.name ?? "root"}'`);
+        console$h.log(`[ChatSession.send] injecting ${childResults.length} pending child result(s) into session='${this.name ?? "root"}'`);
         const toolCalls = childResults.map((cr) => ({
           id: cr.taskId,
           type: "function",
@@ -8960,7 +9090,7 @@ class ChatSession {
         else if (Array.isArray(resolvedUserMessage)) resolvedUserMessage = [{ type: "text", text: contextPrefix }, ...resolvedUserMessage];
       }
       if (effectiveOptions.skipIfMessageTextEmpty === true && shouldProcessTemplate && typeof resolvedUserMessage === "string" && resolvedUserMessage.trim() === "" && childResults.length === 0) {
-        console$g.log(`[ChatSession.send] skipped empty runCode result in session='${this.name ?? "root"}'`);
+        console$h.log(`[ChatSession.send] skipped empty runCode result in session='${this.name ?? "root"}'`);
         return "";
       }
       if (Array.isArray(resolvedUserMessage)) {
@@ -8978,7 +9108,7 @@ class ChatSession {
           try {
             effectiveOptions.onUserMessage(userMessageEntry);
           } catch (e) {
-            console$g.warn("[ChatSession.send] onUserMessage callback failed:", e);
+            console$h.warn("[ChatSession.send] onUserMessage callback failed:", e);
           }
         }
       }
@@ -8988,7 +9118,7 @@ class ChatSession {
         this._evictExcessImages(effectiveOptions.imageConfig.maxImageHistoryCount);
       }
       this._lastSendOptions = effectiveOptions;
-      console$g.log("[ChatSession.send] options:", effectiveOptions);
+      console$h.log("[ChatSession.send] options:", effectiveOptions);
       let currentGptChatId;
       const response = await this.aiChat.chat({
         ...effectiveOptions,
@@ -9035,11 +9165,11 @@ class ChatSession {
               if (history) this.historyId = history.id;
             }
           } catch (e) {
-            console$g.warn("Failed to fetch chat history", e);
+            console$h.warn("Failed to fetch chat history", e);
           }
         }
       } catch (e) {
-        console$g.error("Failed to save chat history", e);
+        console$h.error("Failed to save chat history", e);
       }
       return response;
     } finally {
@@ -9062,10 +9192,10 @@ class ChatSession {
         if (!url || !url.startsWith("data:")) return item;
         try {
           const cdnUrl = await uploadTempVisionImage(url, { sdk: this.aiChat.sdk });
-          console$g.log("[ChatSession] Uploaded inline image to CDN:", cdnUrl);
+          console$h.log("[ChatSession] Uploaded inline image to CDN:", cdnUrl);
           return { ...item, image_url: { ...item.image_url, url: cdnUrl } };
         } catch (e) {
-          console$g.warn("[ChatSession] Failed to upload inline image, keeping data-URI:", e);
+          console$h.warn("[ChatSession] Failed to upload inline image, keeping data-URI:", e);
           return item;
         }
       })
@@ -9090,7 +9220,7 @@ class ChatSession {
     const keepFrom = roundStarts[roundStarts.length - limit];
     const evicted = keepFrom - systemEnd;
     this.messages = [...this.messages.slice(0, systemEnd), ...this.messages.slice(keepFrom)];
-    console$g.log(`[ChatSession] Evicted ${evicted} message(s), kept ${limit} round(s)`);
+    console$h.log(`[ChatSession] Evicted ${evicted} message(s), kept ${limit} round(s)`);
   }
   /**
    * 从历史中移除超出 maxCount 限制的旧图片，
@@ -9118,7 +9248,7 @@ class ChatSession {
       msg.content[partIdx] = { type: "text", text: "(user_image)" };
       removedCount++;
     }
-    if (removedCount > 0) console$g.log(`[ChatSession] Evicted ${removedCount} image(s) from history, kept ${maxCount}`);
+    if (removedCount > 0) console$h.log(`[ChatSession] Evicted ${removedCount} image(s) from history, kept ${maxCount}`);
   }
   // ──────────────────── 历史管理 ────────────────────
   /** 清空对话历史（仅清空 messages 数组）。 */
@@ -9145,7 +9275,7 @@ class ChatSession {
    */
   async restartAgent(promptFile, tools, _options) {
     var _a2, _b2, _c, _d, _e, _f;
-    console$g.log(`[ChatSession] restartAgent session='${this.name ?? "root"}' promptFile=${promptFile ?? "(none)"}`);
+    console$h.log(`[ChatSession] restartAgent session='${this.name ?? "root"}' promptFile=${promptFile ?? "(none)"}`);
     const normalizedTools = Array.isArray(tools) ? tools.filter((t) => typeof t === "string" && t.trim()) : [];
     const cleanupFn = this["_cleanupChildSessions"];
     cleanupFn == null ? void 0 : cleanupFn.call(this);
@@ -9161,18 +9291,17 @@ class ChatSession {
     const hasPromptFile = !!(promptFile && typeof promptFile === "string" && promptFile.trim());
     if (hasPromptFile) {
       try {
-        const AgentConfig2 = (await Promise.resolve().then(() => AgentConfig$1)).default;
-        loadedConfig = await AgentConfig2.fetch(promptFile.trim());
+        loadedConfig = await AgentConfig.fetch(promptFile.trim());
       } catch (e) {
-        console$g.warn(`[ChatSession] restartAgent failed to load '${promptFile}': ${e.message}`);
+        console$h.warn(`[ChatSession] restartAgent failed to load '${promptFile}': ${e.message}`);
       }
     }
     const systemPrompt = loadedConfig ? loadedConfig["system_prompt"] ?? loadedConfig["systemPrompt"] ?? defaults.systemPrompt : defaults.systemPrompt;
     if (hasPromptFile && loadedConfig) {
       this._savedMessages = this.messages.filter((m) => m.role !== "system");
-      console$g.log(`[ChatSession] restartAgent: saved ${this._savedMessages.length} history messages`);
+      console$h.log(`[ChatSession] restartAgent: saved ${this._savedMessages.length} history messages`);
     } else if (!hasPromptFile && this._savedMessages) {
-      console$g.log(`[ChatSession] restartAgent: keeping ${this._savedMessages.length} saved history messages for summarizer`);
+      console$h.log(`[ChatSession] restartAgent: keeping ${this._savedMessages.length} saved history messages for summarizer`);
     }
     this.messages = [];
     if (systemPrompt) this.messages.push({ role: "system", content: systemPrompt });
@@ -9213,7 +9342,7 @@ function installAIChatSessionFactory() {
   Object.assign(ChatSession.prototype, childSessionMethods);
   Object.assign(ChatSession.prototype, {
     async _triggerImmediateCallback() {
-      console$g.log(
+      console$h.log(
         `[ChatSession] _triggerImmediateCallback session='${this.name ?? "root"}' pendingChildResults=${this._pendingChildResults.length} isSending=${this._isSending}`
       );
       if (this._isSending) {
@@ -9226,11 +9355,11 @@ function installAIChatSessionFactory() {
         });
       }
       if (this._pendingChildResults.length === 0) return;
-      console$g.log("[ChatSession] Immediate callback: sending child results to parent");
+      console$h.log("[ChatSession] Immediate callback: sending child results to parent");
       try {
         await this.send(null, this._lastSendOptions);
       } catch (e) {
-        console$g.error("[ChatSession] Immediate callback send failed:", e);
+        console$h.error("[ChatSession] Immediate callback send failed:", e);
       }
     }
   });
@@ -9242,7 +9371,7 @@ function installAIChatSessionFactory() {
 }
 installAIChatSessionFactory();
 installAIChatSessionFactory();
-const console$f = SDKLogger.createModuleConsole("SummarizeTool");
+const console$g = SDKLogger.createModuleConsole("SummarizeTool");
 const _SummarizeTool = class _SummarizeTool {
   constructor() {
     __publicField(this, "config", {});
@@ -9318,7 +9447,7 @@ const _SummarizeTool = class _SummarizeTool {
     };
     const filtered = this.filterSessionMessages(session, filters);
     const result = filtered.slice(-count);
-    console$f.log(`[SummarizeTool] get_history_messages: ${result.length}/${filtered.length} messages (count=${count})`);
+    console$g.log(`[SummarizeTool] get_history_messages: ${result.length}/${filtered.length} messages (count=${count})`);
     return JSON.stringify(
       result.map((msg) => ({
         role: msg.role,
@@ -9338,7 +9467,7 @@ const _SummarizeTool = class _SummarizeTool {
     const filters = args["filters"] ?? null;
     const filtered = this.filterSessionMessages(session, filters);
     const total = Array.isArray(session.messages) ? session.messages.length : Array.isArray(session._history) ? session._history.length : 0;
-    console$f.log(`[SummarizeTool] get_history_messages_count: ${filtered.length}/${total}`);
+    console$g.log(`[SummarizeTool] get_history_messages_count: ${filtered.length}/${total}`);
     return JSON.stringify({ count: filtered.length, total });
   }
   /**
@@ -9388,7 +9517,7 @@ ${result.summary}`;
     const messageBased = _SummarizeTool.isMessageBased(session);
     if (isAsync) {
       if (session._isSummarizing) {
-        console$f.log("[SummarizeTool] Async summarization already running, merging");
+        console$g.log("[SummarizeTool] Async summarization already running, merging");
         return { summary: "", removedCount: 0, remainingCount: messages.length, status: "merged" };
       }
       session._isSummarizing = true;
@@ -9399,7 +9528,7 @@ ${result.summary}`;
     }
     const sdk = session.sdk ?? ((_a2 = session.aiChat) == null ? void 0 : _a2.sdk);
     if (!(sdk == null ? void 0 : sdk.aiChat)) {
-      console$f.error("[SummarizeTool] No SDK instance available on session");
+      console$g.error("[SummarizeTool] No SDK instance available on session");
       return { summary: "", removedCount: 0, remainingCount: messages.length };
     }
     const keepRecentRounds = Number(options.keepRecentRounds) || 3;
@@ -9445,7 +9574,7 @@ ${result.summary}`;
       }
       return result;
     } catch (e) {
-      console$f.error("[SummarizeTool] Summarization failed:", e);
+      console$g.error("[SummarizeTool] Summarization failed:", e);
       return { summary: "", removedCount: 0, remainingCount: messages.length };
     } finally {
       agent.destroy();
@@ -9464,10 +9593,10 @@ ${result.summary}`;
           taskSummary: "Conversation summarization",
           result: result.summary
         });
-        console$f.log(`[SummarizeTool] Async summary queued as pending result (taskId=${taskId})`);
+        console$g.log(`[SummarizeTool] Async summary queued as pending result (taskId=${taskId})`);
       }
     } catch (e) {
-      console$f.error("[SummarizeTool] Async summarization failed:", e);
+      console$g.error("[SummarizeTool] Async summarization failed:", e);
     } finally {
       session._isSummarizing = false;
     }
@@ -9628,7 +9757,7 @@ class SummarizeAgent {
    */
   async loadConfig(config, { skipCopilotToolsOverride = false } = {}) {
     this._config = config;
-    console$f.log("[SummarizeAgent] Config loaded:", Object.keys(config).join(", "));
+    console$g.log("[SummarizeAgent] Config loaded:", Object.keys(config).join(", "));
     if (this.session) await this._createAgentSession();
     if (!skipCopilotToolsOverride) this._overrideCopilotToolsExecutor();
     return config;
@@ -9646,7 +9775,7 @@ class SummarizeAgent {
     this._timer = setInterval(() => {
       void this._onTick();
     }, interval * 1e3);
-    console$f.log(`[SummarizeAgent] Silent-tick timer started (${interval}s)`);
+    console$g.log(`[SummarizeAgent] Silent-tick timer started (${interval}s)`);
   }
   /** 停止静默计时器。 */
   stopTimer() {
@@ -9688,7 +9817,7 @@ class SummarizeAgent {
     }
     this._checkAndTriggerRunning = true;
     this._autoTriggerSignature = signature;
-    console$f.log(`[SummarizeAgent] Auto-summarization triggered: ${roundCount} rounds, ${totalTextLength} chars`);
+    console$g.log(`[SummarizeAgent] Auto-summarization triggered: ${roundCount} rounds, ${totalTextLength} chars`);
     try {
       if (this._config) {
         try {
@@ -9697,7 +9826,7 @@ class SummarizeAgent {
             this._onEvent("summarized", { summary: result.summary, removedCount: result.removedCount, remainingCount: result.remainingCount, trigger: "auto", mode: result.mode, summarizeBeginTime: result.summarizeBeginTime });
           }
         } catch (e) {
-          console$f.error("[SummarizeAgent] Auto-summarization (agent) failed:", e);
+          console$g.error("[SummarizeAgent] Auto-summarization (agent) failed:", e);
         }
         return;
       }
@@ -9711,7 +9840,7 @@ class SummarizeAgent {
           this._onEvent("summarized", { summary: result.summary, removedCount: result.removedCount, remainingCount: result.remainingCount, trigger: "auto", mode: result.mode, summarizeBeginTime: result.summarizeBeginTime });
         }
       } catch (e) {
-        console$f.error("[SummarizeAgent] Auto-summarization fallback failed:", e);
+        console$g.error("[SummarizeAgent] Auto-summarization fallback failed:", e);
       }
     } finally {
       this._checkAndTriggerRunning = false;
@@ -9727,7 +9856,7 @@ class SummarizeAgent {
   async run(options = {}) {
     var _a2, _b2, _c, _d, _e, _f;
     if (this._running) {
-      console$f.log("[SummarizeAgent] Already running, skipping");
+      console$g.log("[SummarizeAgent] Already running, skipping");
       return { summary: "", removedCount: 0, remainingCount: ((_b2 = (_a2 = this.session) == null ? void 0 : _a2.messages) == null ? void 0 : _b2.length) ?? 0 };
     }
     const session = this.session;
@@ -9735,7 +9864,7 @@ class SummarizeAgent {
     if (!this._config) return { summary: "", removedCount: 0, remainingCount: session.messages.length };
     if (!this._agentSession) await this._createAgentSession();
     if (!this._agentSession) {
-      console$f.error("[SummarizeAgent] Failed to create agent session");
+      console$g.error("[SummarizeAgent] Failed to create agent session");
       return { summary: "", removedCount: 0, remainingCount: session.messages.length };
     }
     const opts = this._getOptions();
@@ -9744,11 +9873,11 @@ class SummarizeAgent {
     const summarizeBeginTime = Date.now();
     const conversationMessages = session.messages.filter((m) => m.role !== "system");
     if (conversationMessages.length < 2) {
-      console$f.log("[SummarizeAgent] Not enough messages to summarize");
+      console$g.log("[SummarizeAgent] Not enough messages to summarize");
       return { summary: "", removedCount: 0, remainingCount: session.messages.length };
     }
     this._running = true;
-    console$f.log(`[SummarizeAgent] Running: ${conversationMessages.length} messages, mode=${mode}`);
+    console$g.log(`[SummarizeAgent] Running: ${conversationMessages.length} messages, mode=${mode}`);
     try {
       const agentSession = this._agentSession;
       const agentConfig = this._config;
@@ -9757,7 +9886,7 @@ class SummarizeAgent {
       try {
         systemPrompt = ((_c = agentSession.sandbox) == null ? void 0 : _c.processTemplate) ? await agentSession.sandbox.processTemplate(rawPrompt) : rawPrompt;
       } catch (e) {
-        console$f.warn("[SummarizeAgent] Prompt template failed, using raw:", e);
+        console$g.warn("[SummarizeAgent] Prompt template failed, using raw:", e);
         systemPrompt = rawPrompt;
       }
       const serialized = SummarizeTool.serializeMessages(conversationMessages);
@@ -9786,7 +9915,7 @@ class SummarizeAgent {
       );
       const summaryText = (lastAssistant == null ? void 0 : lastAssistant.content) ?? "";
       if (!summaryText) {
-        console$f.warn("[SummarizeAgent] Empty summary returned");
+        console$g.warn("[SummarizeAgent] Empty summary returned");
         return { summary: "", removedCount: 0, remainingCount: session.messages.length };
       }
       const cleanedMessages = session.messages.filter(
@@ -9800,17 +9929,17 @@ class SummarizeAgent {
           await ((_f = aiChat == null ? void 0 : aiChat.updateChatHistory) == null ? void 0 : _f.call(aiChat, session.historyId, { id: session.historyId, chatId: session.chatId, modId: session.modId, model: session.model, messages: cleanedMessages }));
         }
       } catch (e) {
-        console$f.warn("[SummarizeAgent] Failed to persist summarized history:", e);
+        console$g.warn("[SummarizeAgent] Failed to persist summarized history:", e);
       }
       if (mode === "replace") {
         session.messages = cleanedMessages;
         this.syncHistoryToRTC();
       }
       const remainingCount = session.messages.length;
-      console$f.log(`[SummarizeAgent] ${mode} mode: removed ${removedCount} from history, session ${mode === "replace" ? "updated" : "unchanged"}`);
+      console$g.log(`[SummarizeAgent] ${mode} mode: removed ${removedCount} from history, session ${mode === "replace" ? "updated" : "unchanged"}`);
       return { summary: summaryText, removedCount, remainingCount, mode, summarizeBeginTime };
     } catch (e) {
-      console$f.error("[SummarizeAgent] Failed:", e);
+      console$g.error("[SummarizeAgent] Failed:", e);
       return { summary: "", removedCount: 0, remainingCount: session.messages.length };
     } finally {
       this._running = false;
@@ -9832,7 +9961,7 @@ class SummarizeAgent {
       newHistory.push({ role: msg.role, text, roundId: null });
     }
     vcSession._history = newHistory;
-    console$f.log(`[SummarizeAgent] Synced history to RTC (${newHistory.length} entries)`);
+    console$g.log(`[SummarizeAgent] Synced history to RTC (${newHistory.length} entries)`);
   }
   /** 完全销毁 agent：停止计时器，清除所有状态。 */
   destroy() {
@@ -9896,7 +10025,7 @@ class SummarizeAgent {
     }
     this._tickSummarizing = true;
     this._autoTriggerSignature = signature;
-    console$f.log(`[SummarizeAgent] Silent-tick triggered: ${roundCount} rounds, ${totalTextLength} chars`);
+    console$g.log(`[SummarizeAgent] Silent-tick triggered: ${roundCount} rounds, ${totalTextLength} chars`);
     try {
       let result;
       if (this._config) {
@@ -9909,7 +10038,7 @@ class SummarizeAgent {
         this._onEvent("summarized", { summary: result.summary, removedCount: result.removedCount, remainingCount: result.remainingCount, trigger: "silentTick", mode: result.mode, summarizeBeginTime: result.summarizeBeginTime });
       }
     } catch (e) {
-      console$f.error("[SummarizeAgent] Silent-tick failed:", e);
+      console$g.error("[SummarizeAgent] Silent-tick failed:", e);
     } finally {
       this._tickSummarizing = false;
       if (this._pendingAutoCheck) this._drainPendingAutoCheck();
@@ -9934,7 +10063,7 @@ class SummarizeAgent {
     this._agentSession = sdk.aiChat.createSession({ model, workspace, mountFolder, enableTools, skipHistory: true });
     if ((_e = this.session) == null ? void 0 : _e.sandbox) this._agentSession["sandbox"] = this.session.sandbox;
     this._registerHistoryAPIsOnSandbox(this._agentSession["sandbox"]);
-    console$f.log(`[SummarizeAgent] Agent session created (model=${model}, tools=${enableTools.join(",")})`);
+    console$g.log(`[SummarizeAgent] Agent session created (model=${model}, tools=${enableTools.join(",")})`);
     return this._agentSession;
   }
   /** @private 覆盖 CopilotTools 的 summarize 分类 executor，使其通过 agent 执行。 */
@@ -9963,7 +10092,7 @@ class SummarizeAgent {
       definitions: mergedDefs,
       executor: async (fnName, fnArgs, config) => {
         if (fnName === "summarize_conversation") {
-          console$f.log(`[SummarizeAgent] summarize_conversation tool called: ${(fnArgs == null ? void 0 : fnArgs["reason"]) ?? "(no reason)"}`);
+          console$g.log(`[SummarizeAgent] summarize_conversation tool called: ${(fnArgs == null ? void 0 : fnArgs["reason"]) ?? "(no reason)"}`);
           try {
             const result = await agent.run();
             if (result.summary) {
@@ -9975,7 +10104,7 @@ ${result.summary}`;
             }
             return "No summarization needed — conversation is short enough.";
           } catch (e) {
-            console$f.error("[SummarizeAgent] summarize_conversation tool failed:", e);
+            console$g.error("[SummarizeAgent] summarize_conversation tool failed:", e);
             return `Summarization failed: ${e.message}`;
           }
         }
@@ -9984,7 +10113,7 @@ ${result.summary}`;
       }
     });
     this._registerHistoryAPIsOnSandbox((_f = this.session) == null ? void 0 : _f.sandbox);
-    console$f.log("[SummarizeAgent] Overrode CopilotTools summarize executor");
+    console$g.log("[SummarizeAgent] Overrode CopilotTools summarize executor");
   }
   /**
    * @private 在 sandbox 上注册 get_history_messages / get_history_messages_count 自定义 API，
@@ -10004,7 +10133,7 @@ ${result.summary}`;
     });
   }
 }
-const console$e = SDKLogger.createModuleConsole("CopilotTools");
+const console$f = SDKLogger.createModuleConsole("CopilotTools");
 class CopilotTools {
   constructor(sdk) {
     /** 工具分类注册表 */
@@ -10163,7 +10292,7 @@ class CopilotTools {
     const sessionName = (sessionObj == null ? void 0 : sessionObj["name"]) || (sessionObj == null ? void 0 : sessionObj["workspace"]) || "direct";
     const source = (config == null ? void 0 : config["_proxied"]) ? "proxied" : "local";
     const routerId = ((_c = (_b2 = (_a2 = this.sdk) == null ? void 0 : _a2.agentRouter) == null ? void 0 : _b2.instanceId) == null ? void 0 : _c.slice(0, 8)) || (typeof window !== "undefined" && window.parent === window ? "parent" : "iframe");
-    console$e.log(`[CopilotTools|${routerId}] ${source} execute: ${fnName} [category: ${categoryName}, session: ${sessionName}]`);
+    console$f.log(`[CopilotTools|${routerId}] ${source} execute: ${fnName} [category: ${categoryName}, session: ${sessionName}]`);
     return this._registry[categoryName].executor(fnName, fnArgs, config);
   }
   /**
@@ -10296,7 +10425,7 @@ class CopilotTools {
 /** AppTools 类引用（供外部访问） */
 __publicField(CopilotTools, "AppTools");
 CopilotTools.AppTools = AppTools;
-const console$d = SDKLogger.createModuleConsole("WxLaunchApp");
+const console$e = SDKLogger.createModuleConsole("WxLaunchApp");
 class WxLaunchApp {
   constructor(sdk) {
     __publicField(this, "sdk");
@@ -10395,27 +10524,27 @@ class WxLaunchApp {
   /** 在容器中创建唤起按钮，返回按钮元素 id（失败返回 null）。 */
   createLaunchButton(container, options = {}) {
     if (!container) {
-      console$d.error("Container element is required");
+      console$e.error("Container element is required");
       return null;
     }
     if (!this.isConfigured) {
-      console$d.warn("WeChat SDK not configured. Please call initialize() first, or the button may not work properly.");
-      console$d.warn('Example: await wxLaunchApp.initialize({ appId: "your-appid" })');
+      console$e.warn("WeChat SDK not configured. Please call initialize() first, or the button may not work properly.");
+      console$e.warn('Example: await wxLaunchApp.initialize({ appId: "your-appid" })');
       if (options.autoInit && options.appId) {
-        console$d.log("Attempting auto-initialization...");
+        console$e.log("Attempting auto-initialization...");
         this.initialize({
           appId: options.appId,
           url: options.url,
           debug: options.debug
         }).then((result) => {
           if (result.success) {
-            console$d.log("Auto-initialization successful, recreating button...");
+            console$e.log("Auto-initialization successful, recreating button...");
             this.createLaunchButton(container, { ...options, autoInit: false });
           } else {
-            console$d.error("Auto-initialization failed:", result.message);
+            console$e.error("Auto-initialization failed:", result.message);
           }
         }).catch((err) => {
-          console$d.error("Auto-initialization error:", err);
+          console$e.error("Auto-initialization error:", err);
         });
         return null;
       }
@@ -10497,7 +10626,7 @@ class WxLaunchApp {
     this.downloadUrl = url;
   }
 }
-const console$c = SDKLogger.createModuleConsole("WxAuth");
+const console$d = SDKLogger.createModuleConsole("WxAuth");
 const DEFAULT_CONFIG = {
   appId: "wx7935c49369d421c1",
   // 默认微信 App ID
@@ -10558,7 +10687,7 @@ class WxAuth {
    */
   authorize(options = {}) {
     if (typeof window === "undefined") {
-      console$c.warn("WxAuth.authorize: Not in browser environment");
+      console$d.warn("WxAuth.authorize: Not in browser environment");
       return;
     }
     const appId = options.appId || this.appId;
@@ -10612,7 +10741,7 @@ class WxAuth {
       }
       const res = await response.json();
       if (appId === this.maisiAppId) {
-        console$c.log("Using Maisi App ID for wxCodeToToken");
+        console$d.log("Using Maisi App ID for wxCodeToToken");
         onSuccess(res);
         return { success: true, data: res, isMaisi: true };
       }
@@ -14248,6 +14377,7 @@ const SERVICE_PRESETS = {
       { name: "openrouter-gpt-5.5", modelId: "openai/gpt-5.5", category: "Chat" },
       { name: "openrouter-claude-opus-4-8", modelId: "anthropic/claude-4.8-opus", category: "Chat" },
       { name: "openrouter-claude", modelId: "anthropic/claude-4.8-opus", category: "Chat" },
+      { name: "openrouter-claude-fable-5", modelId: "anthropic/claude-fable-5", category: "Chat" },
       { name: "openrouter-claude-sonnet", modelId: "anthropic/claude-4.6-sonnet", category: "Chat" },
       { name: "openrouter-gemini-3.1-flash-image-preview", modelId: "google/gemini-3.1-flash-image-preview", category: "Image" },
       { name: "openrouter-gemini-3-pro-image-preview", modelId: "google/gemini-3-pro-image-preview", category: "Image" },
@@ -14726,6 +14856,7 @@ class LocalAPIKeySettings {
     }
   }
   async save() {
+    var _a2;
     const data = this._serializeData();
     try {
       if (this.storageMode === "personalPageStore") {
@@ -14736,6 +14867,14 @@ class LocalAPIKeySettings {
       } else {
         localStorage.setItem(STORAGE_KEY, JSON.stringify(data, null, 2));
       }
+      const onSave = (_a2 = this._showOptions) == null ? void 0 : _a2.onSave;
+      if (typeof onSave === "function") {
+        try {
+          onSave();
+        } catch (e) {
+          console.warn("[LocalAPIKeySettings] onSave callback failed:", e);
+        }
+      }
     } catch (e) {
       console.warn("[LocalAPIKeySettings] Failed to save settings:", e);
     }
@@ -15872,7 +16011,7 @@ class LocalAPIKeySettings {
     return `<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M17.94 17.94A10.07 10.07 0 0 1 12 20c-7 0-11-8-11-8a18.45 18.45 0 0 1 5.06-5.94M9.9 4.24A9.12 9.12 0 0 1 12 4c7 0 11 8 11 8a18.5 18.5 0 0 1-2.16 3.19m-6.72-1.07a3 3 0 1 1-4.24-4.24"/><line x1="1" y1="1" x2="23" y2="23"/></svg>`;
   }
 }
-const console$b = SDKLogger.createModuleConsole("AIGenerators");
+const console$c = SDKLogger.createModuleConsole("AIGenerators");
 const DEFAULT_CHAT_MODEL = "keepwork-flash";
 const DEFAULT_IMAGE_MODEL = "keepwork-image";
 const DEFAULT_VIDEO_MODEL = "keepwork-video";
@@ -15962,6 +16101,41 @@ class AIGeneratorsBase {
     var _a2;
     return ((_a2 = this.sdk.localAPIKeySettings) == null ? void 0 : _a2.resolveModelSettings(model ?? "", { provider })) ?? { model: model ?? "" };
   }
+  /**
+   * 判断某个模型当前是否「可能可用」（potentially usable）：
+   * - 本地 API key 功能已启用（localAPIKeySettings.enabled）：模型必须能解析出 apiKey，
+   *   跳过没有配置 key 的模型。
+   * - 未启用：请求走 Keepwork proxy，跳过必须依赖本地 key 直连的模型
+   *   （如 OpenRouter `provider/model` 格式），其余模型视为可用。
+   *
+   * @param model - 模型名字符串，或带 name/modelId/enabled 字段的配置对象
+   *   （如 `localAPIKeySettings.listModels()` 的条目）。enabled === false 的条目直接视为不可用。
+   *   传入空字符串 / null / undefined 时按默认聊天模型（DEFAULT_CHAT_MODEL）判断，
+   *   与 chat() 缺省 model 的行为一致。
+   */
+  isModelUsable(model) {
+    if (model == null || model === "") return this.isModelUsable(DEFAULT_CHAT_MODEL);
+    const isObj = typeof model === "object";
+    if (isObj && model.enabled === false) return false;
+    const name = isObj ? model.name || model.modelId || "" : String(model).trim();
+    if (!name) return false;
+    const localSettings = this.sdk.localAPIKeySettings;
+    const resolved = this._resolveLocalModelSettings(name);
+    if (localSettings == null ? void 0 : localSettings.enabled) {
+      return !!resolved.apiKey;
+    }
+    const modelId = isObj && model.modelId || resolved.model || name;
+    const provider = this._detectProvider(String(modelId));
+    return provider !== "openrouter" && !String(modelId).includes("/");
+  }
+  /**
+   * 过滤出「可能可用」的模型列表（规则见 isModelUsable）。
+   * 支持字符串数组或 `localAPIKeySettings.listModels()` 返回的配置对象数组。
+   */
+  filterUsableModels(models) {
+    if (!Array.isArray(models)) return [];
+    return models.filter((m) => this.isModelUsable(m));
+  }
   /** 判断是否应优先使用直连路由。 */
   _shouldPreferDirect(localModelSettings, opts = {}) {
     if (opts["directOnly"]) return true;
@@ -16135,6 +16309,16 @@ class AIGeneratorsBase {
     if (this._shouldDisableReasoning(model)) return false;
     return reasoning;
   }
+  /**
+   * 解析 maxTokens 选项：同时接受 camelCase `maxTokens` 与下划线 `max_tokens`，
+   * 返回正整数或 undefined（不传）。
+   */
+  _resolveMaxTokens(options) {
+    const raw = (options == null ? void 0 : options.maxTokens) ?? (options == null ? void 0 : options.max_tokens);
+    const value = Number(raw);
+    if (!Number.isFinite(value) || value < 1) return void 0;
+    return Math.floor(value);
+  }
   _buildReasoningBodyField(provider, reasoning) {
     if (reasoning === void 0) return null;
     if (provider === "openrouter") {
@@ -16198,7 +16382,7 @@ class AIGeneratorsBase {
    * 支持流式和非流式两种模式，统一发出 AIChat 兼容的回调。
    */
   async chatViaProxy(options = {}) {
-    const { messages = [], stream = true, reasoning, knowledgeBaseCodes = [], apiCacheKey, abortController, extraHeaders, onMessage, onReasoning, onToolCall, onComplete, onError } = options;
+    const { messages = [], stream = true, reasoning, knowledgeBaseCodes = [], apiCacheKey, abortController, extraHeaders, onMessage, onReasoning, onToolCall, onToolCallChunk, onComplete, onError } = options;
     const requestedModel = options["model"] ?? "keepwork-pro";
     const tools = options["tools"] ?? [];
     if (!messages || messages.length === 0) throw new Error("Messages array is required and cannot be empty");
@@ -16211,6 +16395,8 @@ class AIGeneratorsBase {
       if (extraHeaders) Object.assign(headers, extraHeaders);
       const requestBody = { messages, model, stream };
       if (localModelSettings.apiKey) requestBody["apiKey"] = localModelSettings.apiKey;
+      const maxTokens = this._resolveMaxTokens(options);
+      if (maxTokens !== void 0) requestBody["max_tokens"] = maxTokens;
       const reasoningOpt = this._normalizeReasoningOption(model, reasoning);
       if (reasoningOpt !== void 0) requestBody["reasoning"] = reasoningOpt;
       if ((knowledgeBaseCodes == null ? void 0 : knowledgeBaseCodes.length) > 0) requestBody["knowledgeBaseCodes"] = knowledgeBaseCodes;
@@ -16227,7 +16413,7 @@ class AIGeneratorsBase {
         const msg = response.status === 429 ? "请求频率过高，请稍后重试" : `请求失败: ${response.status} ${response.statusText}`;
         throw new Error(msg);
       }
-      if (stream) return await this._readKeepworkProxySSE(response, { onMessage, onReasoning, onToolCall, onComplete });
+      if (stream) return await this._readKeepworkProxySSE(response, { onMessage, onReasoning, onToolCall, onToolCallChunk, onComplete });
       const result = await response.json();
       const fullResultText = typeof result["result"] === "string" ? result["result"] : "";
       const reasoningText = typeof result["reasoning_content"] === "string" ? result["reasoning_content"] : "";
@@ -16236,21 +16422,21 @@ class AIGeneratorsBase {
         try {
           onReasoning(reasoningText, reasoningText, result);
         } catch (e) {
-          console$b.warn("onReasoning failed:", e);
+          console$c.warn("onReasoning failed:", e);
         }
       }
       if (onToolCall) for (const tc of toolCalls) {
         try {
           onToolCall(tc);
         } catch (e) {
-          console$b.warn("onToolCall failed:", e);
+          console$c.warn("onToolCall failed:", e);
         }
       }
       if (onMessage && (fullResultText || reasoningText)) {
         try {
           onMessage(fullResultText, { result: fullResultText, reasoning_content: reasoningText, tool_calls: toolCalls });
         } catch (e) {
-          console$b.warn("onMessage failed:", e);
+          console$c.warn("onMessage failed:", e);
         }
       }
       if (onComplete) onComplete(fullResultText, { result: fullResultText, reasoning_content: reasoningText, tool_calls: toolCalls, raw: result, headers: Object.fromEntries(response.headers.entries()) });
@@ -16260,56 +16446,174 @@ class AIGeneratorsBase {
       throw error;
     }
   }
-  /** @private 解析 Keepwork proxy SSE 流，返回累积文本。 */
-  async _readKeepworkProxySSE(response, { onMessage, onReasoning, onToolCall, onComplete } = {}) {
+  /**
+   * @private 解析 Keepwork proxy SSE 流，返回累积文本。
+   *
+   * 增量式设计（性能关键）：每条 `data:` 行只解析一次，缓冲区只保留未收完的尾行。
+   * 此前的实现把全部已收数据留在缓冲区、每次网络读取都重新 split + JSON.parse 所有行——
+   * create_file 把整页 HTML 拆成数千条小 delta 行传输时，这会变成 O(n²) 的主线程占用，
+   * 浏览器完全没机会绘制（UI 卡死、CSS 动画停帧、工具调用 chip 直到流结束才出现）。
+   */
+  async _readKeepworkProxySSE(response, { onMessage, onReasoning, onToolCall, onToolCallChunk, onComplete } = {}) {
     var _a2;
     const reader = (_a2 = response.body) == null ? void 0 : _a2.getReader();
     const decoder = new TextDecoder("utf-8");
-    let result = "", fullResult = "", fullReasoningContent = "";
-    let emittedReasoningLen = 0;
+    let buffer = "", fullResult = "", fullReasoningContent = "";
     const toolCalls = [];
+    const deltaToolCallsByIndex = /* @__PURE__ */ new Map();
+    const announcedDelta = /* @__PURE__ */ new Set();
+    const announceDeltaToolCalls = () => {
+      var _a3;
+      for (const entry of deltaToolCallsByIndex.values()) {
+        if (!((_a3 = entry.function) == null ? void 0 : _a3.name) || announcedDelta.has(entry)) continue;
+        announcedDelta.add(entry);
+        if (onToolCall) {
+          try {
+            onToolCall(entry);
+          } catch (e) {
+            console$c.warn("onToolCall failed:", e);
+          }
+        }
+      }
+    };
     if (!reader) {
       if (onComplete) onComplete("", { result: "", reasoning_content: "", tool_calls: [] });
       return "";
     }
-    while (true) {
-      const { done, value } = await reader.read();
-      if (done) {
-        if (onComplete) onComplete(fullResult, { result: fullResult, reasoning_content: fullReasoningContent, tool_calls: toolCalls, headers: Object.fromEntries(response.headers.entries()) });
-        break;
+    const consumePayload = (json) => {
+      var _a3, _b2, _c, _d;
+      let textChanged = false;
+      if (typeof json["result"] === "string" && json["result"]) {
+        fullResult += json["result"];
+        textChanged = true;
+      }
+      if (typeof json["reasoning_content"] === "string" && json["reasoning_content"]) {
+        fullReasoningContent += json["reasoning_content"];
+        textChanged = true;
+        if (onReasoning) {
+          try {
+            onReasoning(fullReasoningContent, json["reasoning_content"]);
+          } catch (e) {
+            console$c.warn("onReasoning failed:", e);
+          }
+        }
       }
-      result += decoder.decode(value, { stream: true });
-      const datas = result.split("\n");
-      try {
-        const responsesArray = datas.filter((d) => d.startsWith("data: {")).map((d) => JSON.parse(d.substring("data: ".length)));
-        const responseResult = responsesArray.map((r) => r["result"]).filter((d) => d !== void 0).reduce((a, b) => a + b, "");
-        const responseReasoning = responsesArray.map((r) => r["reasoning_content"]).filter((d) => d !== void 0).reduce((a, b) => a + b, "");
-        responsesArray.forEach((r) => {
-          if (r["tool_calls"] && Array.isArray(r["tool_calls"])) {
-            r["tool_calls"].forEach((toolCall) => {
-              if (!toolCalls.find((tc) => tc.id === toolCall.id)) {
-                toolCalls.push(toolCall);
-                if (onToolCall) onToolCall(toolCall);
+      if (Array.isArray(json["tool_calls"])) {
+        for (const toolCall of json["tool_calls"]) {
+          const existing = toolCalls.find((tc) => tc.id === toolCall.id);
+          if (!existing) {
+            toolCalls.push(toolCall);
+            if (onToolCallChunk) {
+              try {
+                onToolCallChunk(toolCall);
+              } catch (e) {
+                console$c.warn("onToolCallChunk failed:", e);
               }
-            });
+            }
+            if (onToolCall) {
+              try {
+                onToolCall(toolCall);
+              } catch (e) {
+                console$c.warn("onToolCall failed:", e);
+              }
+            }
+          } else {
+            const nextArgs = (_a3 = toolCall.function) == null ? void 0 : _a3.arguments;
+            if (typeof nextArgs === "string" && nextArgs.length > (((_c = (_b2 = existing.function) == null ? void 0 : _b2.arguments) == null ? void 0 : _c.length) ?? 0)) {
+              if (!existing.function) existing.function = { name: ((_d = toolCall.function) == null ? void 0 : _d.name) ?? "", arguments: "" };
+              existing.function.arguments = nextArgs;
+              if (onToolCallChunk) {
+                try {
+                  onToolCallChunk(existing);
+                } catch (e) {
+                  console$c.warn("onToolCallChunk failed:", e);
+                }
+              }
+            }
           }
-        });
-        if (responseResult.length > 0) fullResult = responseResult;
-        if (responseReasoning.length > 0) fullReasoningContent = responseReasoning;
-        if (onReasoning && fullReasoningContent.length > emittedReasoningLen) {
-          const reasoningDelta = fullReasoningContent.slice(emittedReasoningLen);
-          emittedReasoningLen = fullReasoningContent.length;
+        }
+      }
+      if (Array.isArray(json["tool_calls_delta"])) {
+        for (const frag of json["tool_calls_delta"]) {
+          const idx = frag["index"] ?? 0;
+          let entry = deltaToolCallsByIndex.get(idx);
+          if (!entry) {
+            entry = { id: "", type: "function", function: { name: "", arguments: "" }, index: idx };
+            deltaToolCallsByIndex.set(idx, entry);
+            toolCalls.push(entry);
+          }
+          if (typeof frag["id"] === "string" && frag["id"]) entry.id = frag["id"];
+          if (typeof frag["type"] === "string" && frag["type"]) entry.type = frag["type"];
+          const fn = frag["function"];
+          let tcChanged = false;
+          if (typeof (fn == null ? void 0 : fn["name"]) === "string" && fn["name"]) {
+            entry.function.name += fn["name"];
+            tcChanged = true;
+          }
+          if (typeof (fn == null ? void 0 : fn["arguments"]) === "string" && fn["arguments"]) {
+            entry.function.arguments += fn["arguments"];
+            tcChanged = true;
+          }
+          if (tcChanged && entry.function.name && onToolCallChunk) {
+            try {
+              onToolCallChunk(entry);
+            } catch (e) {
+              console$c.warn("onToolCallChunk failed:", e);
+            }
+          }
+        }
+      }
+      return textChanged;
+    };
+    const consumeTail = () => {
+      const line = buffer.trim();
+      buffer = "";
+      if (!line.startsWith("data: {")) return false;
+      try {
+        return consumePayload(JSON.parse(line.substring("data: ".length)));
+      } catch (_) {
+        return false;
+      }
+    };
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) {
+        const tailChanged = consumeTail();
+        if (tailChanged && onMessage) {
           try {
-            onReasoning(fullReasoningContent, reasoningDelta);
+            onMessage(fullResult, { result: fullResult, reasoning_content: fullReasoningContent, tool_calls: toolCalls });
           } catch (e) {
-            console$b.warn("onReasoning failed:", e);
+            console$c.warn("onMessage failed:", e);
           }
         }
-        if ((responseResult.length > 0 || responseReasoning.length > 0) && onMessage) {
+        announceDeltaToolCalls();
+        if (onComplete) onComplete(fullResult, { result: fullResult, reasoning_content: fullReasoningContent, tool_calls: toolCalls, headers: Object.fromEntries(response.headers.entries()) });
+        break;
+      }
+      buffer += decoder.decode(value, { stream: true });
+      const lines = buffer.split("\n");
+      buffer = lines.pop() ?? "";
+      let textChanged = false;
+      for (const line of lines) {
+        if (!line.startsWith("data: {")) continue;
+        let json;
+        try {
+          json = JSON.parse(line.substring("data: ".length));
+        } catch (_) {
+          continue;
+        }
+        try {
+          if (consumePayload(json)) textChanged = true;
+        } catch (e) {
+          console$c.warn("Error consuming stream payload:", e);
+        }
+      }
+      if (textChanged && onMessage) {
+        try {
           onMessage(fullResult, { result: fullResult, reasoning_content: fullReasoningContent, tool_calls: toolCalls });
+        } catch (e) {
+          console$c.warn("onMessage failed:", e);
         }
-      } catch (e) {
-        console$b.warn("Error parsing stream response:", e);
       }
     }
     return fullResult;
@@ -16320,7 +16624,7 @@ class AIGeneratorsBase {
    */
   async chatCompletion(options = {}) {
     var _a2, _b2, _c;
-    const { messages, prompt, stream = false, temperature, responseFormat, abortController, extraHeaders, onMessage, onReasoning, onToolCall, onComplete, onError } = options;
+    const { messages, prompt, stream = false, temperature, responseFormat, abortController, extraHeaders, onMessage, onReasoning, onToolCall, onToolCallChunk, onComplete, onError } = options;
     const requestedModel = options["model"] ?? DEFAULT_CHAT_MODEL;
     const tools = options["tools"];
     try {
@@ -16333,11 +16637,12 @@ class AIGeneratorsBase {
       }
       if (!apiKey) throw new Error(`Direct chat requires API key for provider: ${provider ?? "unknown"}`);
       const normalizedMessages = this._normalizeMessages(messages, prompt);
+      const maxTokens = this._resolveMaxTokens(options);
       const isGemini = provider === "gemini" || provider === "google";
       if (isGemini && (tools == null ? void 0 : tools.length)) throw new Error("Direct chat with tools is not supported for provider: gemini");
       if (isGemini) {
         const wrappedOnMessage = stream && onMessage ? (fullText, _delta, raw) => onMessage(fullText, { result: fullText, reasoning_content: "", tool_calls: [] }, raw) : void 0;
-        const result = await this._callGoogleLLM({ model, apiKey, messages: normalizedMessages, stream, temperature, responseFormat, onMessage: wrappedOnMessage, abortController, extraHeaders });
+        const result = await this._callGoogleLLM({ model, apiKey, messages: normalizedMessages, stream, temperature, maxTokens, responseFormat, onMessage: wrappedOnMessage, abortController, extraHeaders });
         const res = result;
         if (stream) {
           if (onComplete) onComplete(res.text, { result: res.text, reasoning_content: "", tool_calls: [] });
@@ -16358,6 +16663,7 @@ class AIGeneratorsBase {
       if (extraHeaders) Object.assign(headers, extraHeaders);
       const body = { model, messages: this._normalizeOpenAIChatMessages(normalizedMessages), stream };
       if (temperature !== void 0) body["temperature"] = temperature;
+      if (maxTokens !== void 0) body["max_tokens"] = maxTokens;
       if (responseFormat) body["response_format"] = typeof responseFormat === "string" ? { type: responseFormat } : responseFormat;
       if (tools == null ? void 0 : tools.length) body["tools"] = tools;
       const reasoningOpt = this._normalizeReasoningOption(model, options["reasoning"]);
@@ -16383,35 +16689,35 @@ class AIGeneratorsBase {
           try {
             onReasoning(reasoningText, reasoningText, data);
           } catch (e) {
-            console$b.warn("onReasoning failed:", e);
+            console$c.warn("onReasoning failed:", e);
           }
         }
         if (onToolCall) for (const tc of tCalls) {
           try {
             onToolCall(tc);
           } catch (e) {
-            console$b.warn("onToolCall failed:", e);
+            console$c.warn("onToolCall failed:", e);
           }
         }
         if (onMessage && (text || reasoningText)) {
           try {
             onMessage(text, { result: text, reasoning_content: reasoningText, tool_calls: tCalls });
           } catch (e) {
-            console$b.warn("onMessage failed:", e);
+            console$c.warn("onMessage failed:", e);
           }
         }
         if (onComplete) onComplete(text, { result: text, reasoning_content: reasoningText, tool_calls: tCalls, raw: data, headers: Object.fromEntries(response.headers.entries()) });
         return text;
       }
-      return await this._readChatCompletionSSE(response, { onMessage, onReasoning, onToolCall, onComplete });
+      return await this._readChatCompletionSSE(response, { onMessage, onReasoning, onToolCall, onToolCallChunk, onComplete });
     } catch (error) {
       if (onError) onError(error);
       throw error;
     }
   }
   /** @private 解析 OpenAI/OpenRouter chat-completion SSE，返回累积文本。 */
-  async _readChatCompletionSSE(response, { onMessage, onReasoning, onToolCall, onComplete } = {}) {
-    var _a2, _b2, _c;
+  async _readChatCompletionSSE(response, { onMessage, onReasoning, onToolCall, onToolCallChunk, onComplete } = {}) {
+    var _a2, _b2, _c, _d;
     const reader = (_a2 = response.body) == null ? void 0 : _a2.getReader();
     if (!reader) {
       if (onComplete) onComplete("", { result: "", reasoning_content: "", tool_calls: [] });
@@ -16473,7 +16779,7 @@ class AIGeneratorsBase {
             try {
               onReasoning(fullReasoningContent, rPiece, json);
             } catch (e) {
-              console$b.warn("onReasoning failed:", e);
+              console$c.warn("onReasoning failed:", e);
             }
           }
         }
@@ -16488,8 +16794,22 @@ class AIGeneratorsBase {
             if (tc["id"]) entry.id = tc["id"];
             if (tc["type"]) entry.type = tc["type"];
             const fn = tc["function"];
-            if (fn == null ? void 0 : fn["name"]) entry.function.name += fn["name"];
-            if (fn == null ? void 0 : fn["arguments"]) entry.function.arguments += fn["arguments"];
+            let tcChanged = false;
+            if (fn == null ? void 0 : fn["name"]) {
+              entry.function.name += fn["name"];
+              tcChanged = true;
+            }
+            if (fn == null ? void 0 : fn["arguments"]) {
+              entry.function.arguments += fn["arguments"];
+              tcChanged = true;
+            }
+            if (tcChanged && onToolCallChunk && ((_d = entry.function) == null ? void 0 : _d.name)) {
+              try {
+                onToolCallChunk(entry);
+              } catch (e) {
+                console$c.warn("onToolCallChunk failed:", e);
+              }
+            }
           }
         }
         if (choice["finish_reason"] === "tool_calls") announce();
@@ -16511,22 +16831,24 @@ class AIGeneratorsBase {
     const provider = this._directProvider(localModelSettings, { ...options, model });
     if (!apiKey) throw new Error("Direct provider API key is required");
     const normalizedMessages = this._normalizeMessages(messages, prompt);
+    const maxTokens = this._resolveMaxTokens(options);
     let result;
     if (provider === "gemini" || provider === "google") {
-      result = await this._callGoogleLLM({ model, apiKey, messages: normalizedMessages, stream, temperature, responseFormat, onMessage, onReasoning, abortController, extraHeaders });
+      result = await this._callGoogleLLM({ model, apiKey, messages: normalizedMessages, stream, temperature, maxTokens, responseFormat, onMessage, onReasoning, abortController, extraHeaders });
     } else if (provider === "openai") {
-      result = await this._callOpenAILLM({ model, apiKey, messages: normalizedMessages, stream, temperature, responseFormat, onMessage, onReasoning, abortController, extraHeaders });
+      result = await this._callOpenAILLM({ model, apiKey, messages: normalizedMessages, stream, temperature, maxTokens, responseFormat, onMessage, onReasoning, abortController, extraHeaders });
     } else if (provider === "openrouter") {
-      result = await this._callOpenRouterLLM({ model, apiKey, messages: normalizedMessages, stream, temperature, responseFormat, onMessage, onReasoning, abortController, extraHeaders });
+      result = await this._callOpenRouterLLM({ model, apiKey, messages: normalizedMessages, stream, temperature, maxTokens, responseFormat, onMessage, onReasoning, abortController, extraHeaders });
     } else {
       throw new Error(`Direct provider is not supported: ${provider ?? "unknown"}`);
     }
     return returnRaw ? result : result == null ? void 0 : result.text;
   }
   async _callOpenAILLM(opts) {
-    const { model, apiKey, messages, stream = false, temperature, responseFormat, onMessage, onReasoning, abortController, extraHeaders } = opts;
+    const { model, apiKey, messages, stream = false, temperature, maxTokens, responseFormat, onMessage, onReasoning, abortController, extraHeaders } = opts;
     const body = { model, messages, stream };
     if (temperature !== void 0) body["temperature"] = temperature;
+    if (maxTokens !== void 0) body["max_tokens"] = maxTokens;
     if (responseFormat) body["response_format"] = typeof responseFormat === "string" ? { type: responseFormat } : responseFormat;
     const resp = await fetch("https://api.openai.com/v1/chat/completions", {
       method: "POST",
@@ -16540,9 +16862,10 @@ class AIGeneratorsBase {
     return { text: this._extractOpenAIText(data), data };
   }
   async _callOpenRouterLLM(opts) {
-    const { model, apiKey, messages, stream = false, temperature, responseFormat, onMessage, onReasoning, onImage, abortController, extraHeaders, extraBody } = opts;
+    const { model, apiKey, messages, stream = false, temperature, maxTokens, responseFormat, onMessage, onReasoning, onImage, abortController, extraHeaders, extraBody } = opts;
     const body = { model, messages, stream };
     if (temperature !== void 0) body["temperature"] = temperature;
+    if (maxTokens !== void 0) body["max_tokens"] = maxTokens;
     if (responseFormat) body["response_format"] = typeof responseFormat === "string" ? { type: responseFormat } : responseFormat;
     if (extraBody) Object.assign(body, extraBody);
     const resp = await fetch("https://openrouter.ai/api/v1/chat/completions", {
@@ -16563,9 +16886,10 @@ class AIGeneratorsBase {
     return { text: this._extractOpenAIText(data), data };
   }
   async _callGoogleLLM(opts) {
-    const { model, apiKey, messages, stream = false, temperature, responseFormat, onMessage, onReasoning, abortController, extraHeaders } = opts;
+    const { model, apiKey, messages, stream = false, temperature, maxTokens, responseFormat, onMessage, onReasoning, abortController, extraHeaders } = opts;
     const generationConfig = {};
     if (temperature !== void 0) generationConfig["temperature"] = temperature;
+    if (maxTokens !== void 0) generationConfig["maxOutputTokens"] = maxTokens;
     if (responseFormat === "json_object" || (responseFormat == null ? void 0 : responseFormat["type"]) === "json_object") generationConfig["responseMimeType"] = "application/json";
     const body = { contents: this._messagesToGeminiContents(messages) };
     if (Object.keys(generationConfig).length > 0) body["generationConfig"] = generationConfig;
@@ -16599,7 +16923,7 @@ class AIGeneratorsBase {
       try {
         json = JSON.parse(payload);
       } catch (err) {
-        console$b.warn("[AIGenerators] Ignoring malformed SSE payload:", payload, err);
+        console$c.warn("[AIGenerators] Ignoring malformed SSE payload:", payload, err);
         return;
       }
       sawChunk = true;
@@ -16622,7 +16946,7 @@ class AIGeneratorsBase {
         result = await reader.read();
       } catch (err) {
         if (fullText || reasoningText || sawChunk) {
-          console$b.warn("[AIGenerators] SSE stream ended with read error after content:", err);
+          console$c.warn("[AIGenerators] SSE stream ended with read error after content:", err);
           return fullText || reasoningText;
         }
         throw err;
@@ -16654,7 +16978,7 @@ class AIGeneratorsBase {
       try {
         json = JSON.parse(payload);
       } catch (err) {
-        console$b.warn("[AIGenerators] Ignoring malformed image SSE payload:", payload, err);
+        console$c.warn("[AIGenerators] Ignoring malformed image SSE payload:", payload, err);
         return;
       }
       lastData = json;
@@ -18966,7 +19290,7 @@ function applyPagesMixin(TargetClass) {
     return this.get(`/sites/${siteId}`);
   };
 }
-const console$a = SDKLogger.createModuleConsole("AgentRouter");
+const console$b = SDKLogger.createModuleConsole("AgentRouter");
 const MSG$1 = {
   REGISTER: "agent_register",
   REGISTER_ACK: "agent_register_ack",
@@ -19069,11 +19393,11 @@ const _AgentRouter = class _AgentRouter {
   register(agentName, session) {
     if (!agentName) return false;
     if (this.localAgents.has(agentName) || this.routeTable.has(agentName)) {
-      console$a.warn(`[AgentRouter] Agent '${agentName}' already registered.`);
+      console$b.warn(`[AgentRouter] Agent '${agentName}' already registered.`);
       return false;
     }
     this.localAgents.set(agentName, { session });
-    console$a.log(`[AgentRouter] Registered local agent '${agentName}'`);
+    console$b.log(`[AgentRouter] Registered local agent '${agentName}'`);
     this._broadcast({ is_agent_router: true, type: MSG$1.REGISTER, agentName, instanceId: this.instanceId }, null);
     return true;
   }
@@ -19084,7 +19408,7 @@ const _AgentRouter = class _AgentRouter {
   unregister(agentName) {
     if (!this.localAgents.has(agentName)) return;
     this.localAgents.delete(agentName);
-    console$a.log(`[AgentRouter] Unregistered local agent '${agentName}'`);
+    console$b.log(`[AgentRouter] Unregistered local agent '${agentName}'`);
     this._broadcast({ is_agent_router: true, type: MSG$1.UNREGISTER, agentName, instanceId: this.instanceId }, null);
   }
   /**
@@ -19133,7 +19457,7 @@ const _AgentRouter = class _AgentRouter {
   submitTask(agentName, payload, callbacks = {}) {
     const route = this.routeTable.get(agentName);
     if (!route) {
-      console$a.warn(`[AgentRouter] submitTask failed: no route to '${agentName}'`);
+      console$b.warn(`[AgentRouter] submitTask failed: no route to '${agentName}'`);
       return Promise.reject(new Error(`No route to remote agent '${agentName}'`));
     }
     const taskId = generateUUID();
@@ -19216,7 +19540,7 @@ const _AgentRouter = class _AgentRouter {
    */
   attachNPLJS(npljs, options = {}) {
     if (!npljs) {
-      console$a.warn("[AgentRouter] attachNPLJS: npljs instance is required");
+      console$b.warn("[AgentRouter] attachNPLJS: npljs instance is required");
       return this;
     }
     const sendEventName = options.sendEventName ?? "@webparacraft_backgroundAgent";
@@ -19236,7 +19560,7 @@ const _AgentRouter = class _AgentRouter {
       this._onMessage({ data: msg, source: proxy });
     });
     this.addChildWindow(proxy);
-    console$a.log(`[AgentRouter] attachNPLJS: send=${sendEventName} recv=${recvEventName}`);
+    console$b.log(`[AgentRouter] attachNPLJS: send=${sendEventName} recv=${recvEventName}`);
     return this;
   }
   /**
@@ -19250,7 +19574,7 @@ const _AgentRouter = class _AgentRouter {
     if (npljs && this._nplRecvEventName) npljs.OffMsg(this._nplRecvEventName);
     this._nplWindowProxy = null;
     this._nplRecvEventName = null;
-    console$a.log("[AgentRouter] detachNPLJS: bridge removed");
+    console$b.log("[AgentRouter] detachNPLJS: bridge removed");
   }
   // ─────────────────────── 传输帮助 ───────────────────────
   /**
@@ -19266,7 +19590,7 @@ const _AgentRouter = class _AgentRouter {
       }
       windowRef.postMessage(msg, "*");
     } catch (e) {
-      console$a.warn("[AgentRouter] _sendTo failed:", e);
+      console$b.warn("[AgentRouter] _sendTo failed:", e);
     }
   }
   /**
@@ -19350,7 +19674,7 @@ const _AgentRouter = class _AgentRouter {
     }
     this.routeTable.set(agentName, { windowRef: sourceWindow, sourceInstanceId: instanceId, learnedFrom: sourceWindow, updatedAt: Date.now() });
     this._indexWindowAgent(sourceWindow, agentName);
-    console$a.log(`[AgentRouter] Discovered remote agent '${agentName}' via instance ${instanceId}`);
+    console$b.log(`[AgentRouter] Discovered remote agent '${agentName}' via instance ${instanceId}`);
     if (sourceWindow !== window.parent) this.connectedWindows.add(sourceWindow);
     if (!syncBackfill) {
       this._sendTo(sourceWindow, { is_agent_router: true, type: MSG$1.REGISTER_ACK, agentName, instanceId: this.instanceId });
@@ -19360,14 +19684,14 @@ const _AgentRouter = class _AgentRouter {
   }
   /** @private 处理 agent_register_ack（当前仅记录日志）。 */
   _handleRegisterAck(msg) {
-    console$a.log(`[AgentRouter] Registration of '${msg.agentName}' acknowledged by instance ${msg.instanceId}`);
+    console$b.log(`[AgentRouter] Registration of '${msg.agentName}' acknowledged by instance ${msg.instanceId}`);
   }
   /** @private 处理 agent_register_reject（回滚本地乐观注册）。 */
   _handleRegisterReject(msg) {
-    console$a.warn(`[AgentRouter] Registration of '${msg.agentName}' rejected: ${msg.reason}`);
+    console$b.warn(`[AgentRouter] Registration of '${msg.agentName}' rejected: ${msg.reason}`);
     if (this.localAgents.has(msg.agentName ?? "")) {
       this.localAgents.delete(msg.agentName ?? "");
-      console$a.warn(`[AgentRouter] Rolled back local registration of '${msg.agentName}'`);
+      console$b.warn(`[AgentRouter] Rolled back local registration of '${msg.agentName}'`);
     }
   }
   /** @private 处理 agent_unregister（验证来源后删除路由，防止劫持）。 */
@@ -19377,7 +19701,7 @@ const _AgentRouter = class _AgentRouter {
     const existing = this.routeTable.get(agentName);
     if (existing) {
       if (existing.windowRef !== sourceWindow || existing.sourceInstanceId !== instanceId) {
-        console$a.warn(`[AgentRouter] _handleUnregister ignored stale unregister for '${agentName}'`);
+        console$b.warn(`[AgentRouter] _handleUnregister ignored stale unregister for '${agentName}'`);
         return;
       }
       this.routeTable.delete(agentName);
@@ -19407,7 +19731,7 @@ const _AgentRouter = class _AgentRouter {
       this._createRelayTask(taskId, agentName, route.windowRef, sourceWindow);
       return;
     }
-    console$a.warn(`[AgentRouter] _handleTask no route found for agent='${agentName}' taskId=${taskId}`);
+    console$b.warn(`[AgentRouter] _handleTask no route found for agent='${agentName}' taskId=${taskId}`);
     this._sendTo(sourceWindow, {
       is_agent_router: true,
       type: MSG$1.TASK_RESULT,
@@ -19461,7 +19785,7 @@ const _AgentRouter = class _AgentRouter {
       const result = typeof response === "string" ? response : (response == null ? void 0 : response["result"]) ?? "";
       this._sendTo(replyWindow, { is_agent_router: true, type: MSG$1.TASK_RESULT, taskId, result, error: null, sourceInstanceId: this.instanceId });
     } catch (e) {
-      console$a.error("[AgentRouter] Local task execution failed:", e);
+      console$b.error("[AgentRouter] Local task execution failed:", e);
       this._sendTo(replyWindow, {
         is_agent_router: true,
         type: MSG$1.TASK_RESULT,
@@ -19528,11 +19852,11 @@ const _AgentRouter = class _AgentRouter {
     const { taskId = "", result, error } = msg;
     const record = this.taskRegistry.get(taskId);
     if (!record) {
-      console$a.warn(`[AgentRouter] _handleTaskResult dropped taskId=${taskId}: no task record`);
+      console$b.warn(`[AgentRouter] _handleTaskResult dropped taskId=${taskId}: no task record`);
       return;
     }
     if (!this._isExpectedTaskSource(record, sourceWindow)) {
-      console$a.warn(`[AgentRouter] _handleTaskResult dropped taskId=${taskId}: unexpected source`);
+      console$b.warn(`[AgentRouter] _handleTaskResult dropped taskId=${taskId}: unexpected source`);
       return;
     }
     if (record.kind === "origin") {
@@ -19558,7 +19882,7 @@ const _AgentRouter = class _AgentRouter {
     const { taskId = "" } = msg;
     const record = this.taskRegistry.get(taskId);
     if (!record) {
-      console$a.warn(`[AgentRouter] _handleStream dropped taskId=${taskId}: no task record`);
+      console$b.warn(`[AgentRouter] _handleStream dropped taskId=${taskId}: no task record`);
       return;
     }
     if (!this._isExpectedTaskSource(record, sourceWindow)) return;
@@ -20048,6 +20372,10 @@ const _KeepworkSDK = class _KeepworkSDK {
  * 因此 npm 包中 `API_KEYS.maisi` 为 `''`；如需鉴权请通过 `setUserApiKey()` 自行提供。
  */
 __publicField(_KeepworkSDK, "API_KEYS", {
+  // 正常情况下 `__MAISI_API_KEY__` 由 Vite `define` 在构建/转译期替换为字符串字面量。
+  // 但当源码 `.ts` 被裸服务（如 maisi dev server 直接以 ESM 提供未做 define 替换的文件）时，
+  // 该全局并不存在，直接引用会抛 ReferenceError 导致整个 SDK 加载失败。
+  // 用 typeof 守卫做安全回退：缺失时退化为空串（与 npm 构建一致），不再抛错。
   maisi: ""
 });
 /** bundle 自身 URL（由 index.ts 在加载时写入，供 DigitalHumanFrame 等推导 CDN 路径）。 */
@@ -20561,7 +20889,7 @@ function normalizeRTCMessageContent(content) {
   if (content === null || content === void 0) return null;
   return typeof content === "string" ? content : JSON.stringify(content);
 }
-const console$9 = SDKLogger.createModuleConsole("AIChatRTC");
+const console$a = SDKLogger.createModuleConsole("AIChatRTC");
 class RTCChatSession {
   /**
    * @param {AIChatRTC} aiChatRTC - Parent AIChatRTC instance
@@ -20679,7 +21007,7 @@ class RTCChatSession {
       try {
         fn(data);
       } catch (e) {
-        console$9.warn(`[RTCChatSession] Event '${event}' listener error:`, e);
+        console$a.warn(`[RTCChatSession] Event '${event}' listener error:`, e);
       }
     }
   }
@@ -20778,7 +21106,7 @@ class RTCChatSession {
           taskId: this.taskId
         });
       } catch (e) {
-        console$9.warn("[RTCChatSession] stop voiceChat warning:", e == null ? void 0 : e.message);
+        console$a.warn("[RTCChatSession] stop voiceChat warning:", e == null ? void 0 : e.message);
       }
     }
     this._cleanup();
@@ -20842,7 +21170,7 @@ class RTCChatSession {
         this.rtcEngine.leaveRoom();
         VERTC.destroyEngine(this.rtcEngine);
       } catch (e) {
-        console$9.warn("[RTCChatSession] cleanup warning:", e == null ? void 0 : e.message);
+        console$a.warn("[RTCChatSession] cleanup warning:", e == null ? void 0 : e.message);
       }
       this.rtcEngine = null;
     }
@@ -21194,7 +21522,7 @@ class RTCChatSession {
    */
   async restartAgent(promptFile, tools) {
     var _a2, _b2;
-    console$9.log(`[RTCChatSession] restartAgent promptFile=${promptFile || "(none)"}`);
+    console$a.log(`[RTCChatSession] restartAgent promptFile=${promptFile || "(none)"}`);
     const normalizedTools = Array.isArray(tools) ? tools.filter((t) => typeof t === "string" && t.trim()) : [];
     if (typeof this._cleanupChildSessions === "function") {
       this._cleanupChildSessions();
@@ -21207,10 +21535,9 @@ class RTCChatSession {
     let loadedConfig = null;
     if (promptFile && typeof promptFile === "string" && promptFile.trim()) {
       try {
-        const AgentConfig2 = (await Promise.resolve().then(() => AgentConfig$1)).default;
-        loadedConfig = await AgentConfig2.fetch(promptFile.trim());
+        loadedConfig = await AgentConfig.fetch(promptFile.trim());
       } catch (e) {
-        console$9.warn(`[RTCChatSession] restartAgent failed to load '${promptFile}': ${e == null ? void 0 : e.message}`);
+        console$a.warn(`[RTCChatSession] restartAgent failed to load '${promptFile}': ${e == null ? void 0 : e.message}`);
       }
     }
     if (loadedConfig) {
@@ -21558,7 +21885,7 @@ class RTCChatSession {
     for (const toolCall of toolCalls) {
       const funcName = (_a2 = toolCall.function) == null ? void 0 : _a2.name;
       if (!funcName) {
-        console$9.warn("[AIChatRTC] Skipping tool call with empty function name", toolCall == null ? void 0 : toolCall.id);
+        console$a.warn("[AIChatRTC] Skipping tool call with empty function name", toolCall == null ? void 0 : toolCall.id);
         if (this.rtcEngine && toolCall.id) {
           await this._sendFuncResultChunked(toolCall.id, "OK", "unknown");
         }
@@ -21579,7 +21906,7 @@ class RTCChatSession {
         if (e && e.isRestartAgentSignal) {
           const dh = this._digitalHuman;
           if (dh && typeof dh.restartAgent === "function") {
-            console$9.log(`[AIChatRTC] RestartAgentSignal caught in _handleFunctionCall, restarting with '${e.promptFile}'`);
+            console$a.log(`[AIChatRTC] RestartAgentSignal caught in _handleFunctionCall, restarting with '${e.promptFile}'`);
             if (this.rtcEngine && toolCall.id) {
               await this._sendFuncResultChunked(toolCall.id, "Agent restarting...", funcName);
             }
@@ -21589,7 +21916,7 @@ class RTCChatSession {
               try {
                 await dh.restartAgent(promptFile, tools);
               } catch (err) {
-                console$9.error("[AIChatRTC] deferred restartAgent failed:", err == null ? void 0 : err.message);
+                console$a.error("[AIChatRTC] deferred restartAgent failed:", err == null ? void 0 : err.message);
                 dh.emit("error", { error: err, stage: "restartAgent" });
               }
             }, 0);
@@ -21845,7 +22172,7 @@ function installRTCChatSessionMixin() {
     try {
       await this.send(null, this._lastSendOptions);
     } catch (e) {
-      console$9.error("[RTCChatSession] Immediate callback send failed:", e);
+      console$a.error("[RTCChatSession] Immediate callback send failed:", e);
     }
   };
 }
@@ -21909,7 +22236,7 @@ let AIChatRTC$1 = (_a = class {
     return new RTCChatSession(this, config);
   }
 }, __publicField(_a, "AGENT_STATE", AGENT_STATE), __publicField(_a, "AGENT_STATE_LABELS", AGENT_STATE_LABELS), __publicField(_a, "COMMAND", COMMAND), _a);
-const console$8 = SDKLogger.createModuleConsole("AIChatRTCLocal");
+const console$9 = SDKLogger.createModuleConsole("AIChatRTCLocal");
 const _win = typeof window !== "undefined" ? window : {};
 const DEFAULT_VAD_CDN = {
   ortUrl: "https://cdn.keepwork.com/keepwork/cdn/voice/ort.min.js",
@@ -23116,7 +23443,7 @@ class WebSpeechASRBackend extends BaseASRBackend {
     };
     this._recognition.onerror = (event) => {
       if (event.error === "no-speech" || event.error === "aborted") return;
-      console$8.warn("[LocalRTCSession] SpeechRecognition error:", event.error);
+      console$9.warn("[LocalRTCSession] SpeechRecognition error:", event.error);
       const message = event.error === "not-allowed" ? "Microphone permission denied for speech recognition" : `SpeechRecognition error: ${event.error}`;
       this.session._handleASRError(message, { fatal: false });
     };
@@ -24086,7 +24413,7 @@ class LocalNeuralTTSBackend extends BaseTTSBackend {
     if (Number.isFinite(this._numSpeakers) && this._numSpeakers > 0) {
       if (speakerId < 0 || speakerId >= this._numSpeakers) {
         const fallbackSpeakerId = ((_b2 = this._resolvedConfig) == null ? void 0 : _b2.defaultSpeakerId) || 0;
-        console$8.warn(`[LocalNeuralTTS] Speaker ${speakerId} is out of range for preset ${((_d = (_c = this._resolvedConfig) == null ? void 0 : _c.activePreset) == null ? void 0 : _d.id) || "unknown"} (numSpeakers=${this._numSpeakers}); using ${fallbackSpeakerId} instead.`);
+        console$9.warn(`[LocalNeuralTTS] Speaker ${speakerId} is out of range for preset ${((_d = (_c = this._resolvedConfig) == null ? void 0 : _c.activePreset) == null ? void 0 : _d.id) || "unknown"} (numSpeakers=${this._numSpeakers}); using ${fallbackSpeakerId} instead.`);
         speakerId = fallbackSpeakerId >= 0 && fallbackSpeakerId < this._numSpeakers ? fallbackSpeakerId : 0;
       }
     }
@@ -24143,7 +24470,7 @@ class LocalNeuralTTSBackend extends BaseTTSBackend {
   }
 }
 const SENTENCE_END_RE = /[。！？!?\n]+/;
-const console$7 = SDKLogger.createModuleConsole("AIChatRTCLocal");
+const console$8 = SDKLogger.createModuleConsole("AIChatRTCLocal");
 class LocalRTCSession {
   /**
    * @param {AIChatRTCLocal} parent - Parent AIChatRTCLocal instance
@@ -24217,7 +24544,7 @@ class LocalRTCSession {
         fn(data);
       } catch (eRaw) {
         const e = eRaw;
-        console$7.warn(`[LocalRTCSession] Event '${event}' listener error:`, e);
+        console$8.warn(`[LocalRTCSession] Event '${event}' listener error:`, e);
       }
     }
   }
@@ -24518,10 +24845,10 @@ class LocalRTCSession {
         }
       });
       this._micVAD.start();
-      console$7.log("[LocalRTCSession] Silero VAD started (single-thread)");
+      console$8.log("[LocalRTCSession] Silero VAD started (single-thread)");
     } catch (eRaw) {
       const e = eRaw;
-      console$7.warn("[LocalRTCSession] Silero VAD init failed, falling back to energy VAD:", e.message);
+      console$8.warn("[LocalRTCSession] Silero VAD init failed, falling back to energy VAD:", e.message);
       this.parent._vadAvailable = false;
       await this._initEnergyVAD();
     }
@@ -24577,7 +24904,7 @@ class LocalRTCSession {
         this._silenceStart = 0;
       }
     }, ENERGY_VAD.SAMPLE_INTERVAL);
-    console$7.log("[LocalRTCSession] Energy VAD started (fallback)");
+    console$8.log("[LocalRTCSession] Energy VAD started (fallback)");
   }
   _onSpeechStart() {
     if (this._isTTSSpeaking || this._isLLMStreaming) {
@@ -24734,7 +25061,7 @@ class LocalRTCSession {
   _notifyMediaStreamChanged(stream) {
     if (!this._asrBackend || typeof this._asrBackend.attachMediaStream !== "function") return;
     this._asrBackend.attachMediaStream(stream).catch((error) => {
-      console$7.warn("[LocalRTCSession] Failed to rebind ASR media stream:", (error == null ? void 0 : error.message) || error);
+      console$8.warn("[LocalRTCSession] Failed to rebind ASR media stream:", (error == null ? void 0 : error.message) || error);
     });
   }
   _beginRecognitionRound() {
@@ -24850,7 +25177,7 @@ class LocalRTCSession {
     var _a2, _b2;
     const MAX_ITERATIONS = 10;
     if (iteration >= MAX_ITERATIONS) {
-      console$7.warn("[LocalRTCSession] Max tool-call iterations reached");
+      console$8.warn("[LocalRTCSession] Max tool-call iterations reached");
       if (this.isActive && !this.isMuted) this._setState(AGENT_STATE.LISTENING);
       return;
     }
@@ -24894,7 +25221,7 @@ class LocalRTCSession {
         },
         onError: (error) => {
           if (error.name === "AbortError") return;
-          console$7.error("[LocalRTCSession] LLM error:", error.message);
+          console$8.error("[LocalRTCSession] LLM error:", error.message);
           this.emit("error", { error: error.message || "LLM request failed" });
         }
       });
@@ -24902,7 +25229,7 @@ class LocalRTCSession {
       const error = errorRaw;
       this._isLLMStreaming = false;
       if (error.name === "AbortError") return;
-      console$7.error("[LocalRTCSession] LLM error:", error.message);
+      console$8.error("[LocalRTCSession] LLM error:", error.message);
       this.emit("error", { error: error.message || "LLM request failed" });
       if (this.isActive && !this.isMuted) this._setState(AGENT_STATE.LISTENING);
       return;
@@ -25038,7 +25365,7 @@ class LocalRTCSession {
         if ((error == null ? void 0 : error.name) === "AbortError" || this._ttsToken !== drainToken) {
           break;
         }
-        console$7.warn("[LocalRTCSession] TTS error:", (error == null ? void 0 : error.message) || error);
+        console$8.warn("[LocalRTCSession] TTS error:", (error == null ? void 0 : error.message) || error);
         this._emitTTSStatus("error", {
           provider: this.ttsBackendName,
           message: (error == null ? void 0 : error.message) || String(error)
@@ -25145,7 +25472,7 @@ Result: ${resultText}`;
   };
 }
 installLocalRTCSessionMixin();
-const console$6 = SDKLogger.createModuleConsole("AIChatRTCLocal");
+const console$7 = SDKLogger.createModuleConsole("AIChatRTCLocal");
 installLocalRTCSessionMixin();
 let AIChatRTCLocal$1 = (_b = class {
   /**
@@ -25193,12 +25520,12 @@ let AIChatRTCLocal$1 = (_b = class {
     this._loadPromise = this._loadScripts().then(() => {
       this._vadAvailable = !!(typeof vad !== "undefined" && vad.MicVAD);
       if (this._vadAvailable) {
-        console$6.log("[AIChatRTCLocal] Silero VAD loaded");
+        console$7.log("[AIChatRTCLocal] Silero VAD loaded");
       } else {
-        console$6.warn("[AIChatRTCLocal] VAD bundle loaded but vad.MicVAD not found — using energy fallback");
+        console$7.warn("[AIChatRTCLocal] VAD bundle loaded but vad.MicVAD not found — using energy fallback");
       }
     }).catch(() => {
-      console$6.warn("[AIChatRTCLocal] Failed to load Silero VAD — using energy fallback");
+      console$7.warn("[AIChatRTCLocal] Failed to load Silero VAD — using energy fallback");
       this._vadAvailable = false;
       this._loadPromise = null;
     });
@@ -25269,7 +25596,7 @@ let AIChatRTCLocal$1 = (_b = class {
         return this._rememberBlobURL(cacheKey, cached);
       }
     } catch (error) {
-      console$6.warn(`[AIChatRTCLocal] IndexedDB cache read failed for ${fileName}:`, (error == null ? void 0 : error.message) || error);
+      console$7.warn(`[AIChatRTCLocal] IndexedDB cache read failed for ${fileName}:`, (error == null ? void 0 : error.message) || error);
     }
     try {
       const response = await fetch(remoteUrl);
@@ -25284,7 +25611,7 @@ let AIChatRTCLocal$1 = (_b = class {
       });
       return this._rememberBlobURL(cacheKey, blob);
     } catch (error) {
-      console$6.warn(`[AIChatRTCLocal] Failed to cache ${fileName}:`, (error == null ? void 0 : error.message) || error);
+      console$7.warn(`[AIChatRTCLocal] Failed to cache ${fileName}:`, (error == null ? void 0 : error.message) || error);
       return null;
     }
   }
@@ -25361,6 +25688,886 @@ let AIChatRTCLocal$1 = (_b = class {
 AIChatRTCLocal$1.DEFAULT_MODEL_CDN = DEFAULT_KEEPWORK_MODEL_CDN;
 AIChatRTCLocal$1.DEFAULT_MODEL_BASE = getDefaultModelAssetBase();
 const AIChatRTCLocal = AIChatRTCLocal$1;
+const LocalRTC = typeof window !== "undefined" && window.SherpaOnnxLocalRTC || null;
+const console$6 = SDKLogger.createModuleConsole("LocalRTCController");
+const SHERPA_DEFAULT_BASE = "https://cdn.keepwork.com/npm/sherpaonnx-full-js/";
+function normalizeText(text) {
+  return String(text || "").replace(/[\s\r\n\t.,，。！!？?、]+/g, "");
+}
+function waitForSherpaGlobal(timeoutMs = 15e3) {
+  if (typeof window === "undefined") return Promise.resolve(false);
+  const w = window;
+  if (w.SherpaOnnxLocalRTC) return Promise.resolve(true);
+  return new Promise((resolve) => {
+    const start = Date.now();
+    const tick = () => {
+      if (w.SherpaOnnxLocalRTC) return resolve(true);
+      if (Date.now() - start >= timeoutMs) return resolve(false);
+      setTimeout(tick, 50);
+    };
+    tick();
+  });
+}
+function loadScript$1(src) {
+  return new Promise((resolve, reject) => {
+    if (typeof document === "undefined") {
+      resolve();
+      return;
+    }
+    if (document.querySelector(`script[src^="${src.split("?")[0]}"]`)) {
+      resolve();
+      return;
+    }
+    const s = document.createElement("script");
+    s.src = src;
+    s.async = false;
+    s.onload = () => resolve();
+    s.onerror = () => reject(new Error(`Failed to load ${src}`));
+    document.head.appendChild(s);
+  });
+}
+class LocalRTCController {
+  constructor(options) {
+    // ── 运行时引用 ──
+    __publicField(this, "host");
+    __publicField(this, "config");
+    __publicField(this, "hooks");
+    /** SherpaOnnxLocalRTC 实例 */
+    __publicField(this, "_rtc", null);
+    /** LocalRTC 类 */
+    __publicField(this, "_LocalRTC", null);
+    /** 预加载是否已完成 */
+    __publicField(this, "_preloaded", false);
+    /** 预加载 Promise（防止并发重复预加载） */
+    __publicField(this, "_preloadPromise", null);
+    __publicField(this, "_sherpaBase", "");
+    __publicField(this, "_sherpaVersion", "");
+    // ── 加载进度 ──
+    __publicField(this, "_loadProgress", {
+      phase: "未开始",
+      wasm: 0,
+      kws: 0,
+      asr: 0,
+      source: "",
+      done: false,
+      error: ""
+    });
+    // ── 本地语音会话状态 ──
+    __publicField(this, "_localVcActive", false);
+    __publicField(this, "_localVcProcessing", false);
+    __publicField(this, "_localTtsPlaying", false);
+    __publicField(this, "_localTtsEndTime", 0);
+    __publicField(this, "_localAsrEndTime", 0);
+    __publicField(this, "_wakeViaKwsLocalAsr", false);
+    __publicField(this, "_currentTtsText", "");
+    __publicField(this, "_localAsrPausedForTts", false);
+    __publicField(this, "_savedBargeInThreshold", null);
+    __publicField(this, "_ttsVersion", 0);
+    __publicField(this, "_lastSentAsrText", "");
+    // ── textSpeech 事件订阅句柄（destroy 时解绑）──
+    __publicField(this, "_onTtsStartBound", null);
+    __publicField(this, "_onTtsEndBound", null);
+    __publicField(this, "_onTtsCanceledBound", null);
+    if (!(options == null ? void 0 : options.host)) throw new Error("LocalRTCController requires a host");
+    this.host = options.host;
+    this.config = options.config || {};
+    this.hooks = options.hooks || {};
+    this._LocalRTC = options.localRTCClass || null;
+    this._onTtsStartBound = () => {
+      void this.onTtsStart();
+    };
+    this._onTtsEndBound = () => {
+      void this.onTtsEnd();
+    };
+    this._onTtsCanceledBound = () => {
+      void this.onTtsCanceled();
+    };
+    this.host.on("textSpeechStart", this._onTtsStartBound);
+    this.host.on("textSpeechEnd", this._onTtsEndBound);
+    this.host.on("textSpeechCanceled", this._onTtsCanceledBound);
+  }
+  // =================== 公共状态查询 ===================
+  /** 当前是否处于本地 ASR 活跃会话 */
+  isLocalVcActive() {
+    return this._localVcActive;
+  }
+  /** 当前 RTC 实例（供调试 / 高级用法） */
+  getRtc() {
+    return this._rtc;
+  }
+  /** 读取当前加载进度快照 */
+  getLoadProgress() {
+    return { ...this._loadProgress };
+  }
+  /** 内部：合并更新进度并通知钩子 */
+  _setProgress(patch) {
+    var _a2, _b2;
+    this._loadProgress = { ...this._loadProgress, ...patch };
+    const snap = this.getLoadProgress();
+    try {
+      (_b2 = (_a2 = this.hooks).onLoadProgress) == null ? void 0 : _b2.call(_a2, snap);
+    } catch {
+    }
+  }
+  _emitStatus(text) {
+    var _a2, _b2;
+    try {
+      (_b2 = (_a2 = this.hooks).onStatus) == null ? void 0 : _b2.call(_a2, text);
+    } catch {
+    }
+  }
+  _isLocalAsrEnabled() {
+    var _a2, _b2;
+    try {
+      return !!((_b2 = (_a2 = this.hooks).isLocalAsrEnabled) == null ? void 0 : _b2.call(_a2));
+    } catch {
+      return false;
+    }
+  }
+  /** 获取打断（barge-in）配置：是否允许 TTS 播放时被打断 */
+  _getInterruptionEnabled() {
+    var _a2, _b2;
+    return ((_b2 = (_a2 = this.config) == null ? void 0 : _a2.interruption) == null ? void 0 : _b2.enabled) !== false;
+  }
+  /** 是否为 android 原生 ASR 运行时（决定是否走「伪 KWS」方案） */
+  _isAndroidRuntime() {
+    const cfg = this.config || {};
+    const asrRuntime = cfg.asrRuntime || (cfg.runtime === "android" ? "android" : "wasm");
+    return asrRuntime === "android";
+  }
+  // =================== 解析 LocalRTC 类 ===================
+  _resolveLocalRTCClass() {
+    if (this._LocalRTC) return this._LocalRTC;
+    if (LocalRTC) return LocalRTC;
+    const w = typeof window !== "undefined" ? window : null;
+    return w && w.SherpaOnnxLocalRTC || null;
+  }
+  // =================== 预加载 ===================
+  /**
+   * 预加载本地 RTC 资源并构造 SherpaOnnxLocalRTC 实例。
+   * 幂等：重复调用返回同一个 Promise。
+   * @returns rtc 实例或 null（不可用）
+   */
+  async preload() {
+    if (this.config.enabled === false) return null;
+    if (this._preloaded) return this._rtc;
+    if (this._preloadPromise) return this._preloadPromise;
+    this._setProgress({ phase: "开始预加载...", done: false, error: "" });
+    this._preloadPromise = this._doPreload().then((rtc) => {
+      this._preloaded = true;
+      this._preloadPromise = null;
+      return rtc;
+    }).catch((e) => {
+      this._preloadPromise = null;
+      this._setProgress({ phase: "加载失败", error: String((e == null ? void 0 : e.message) || e) });
+      console$6.warn("[LocalRTCController] 预加载失败:", e);
+      this._emitStatus("本地语音不可用");
+      return null;
+    });
+    return this._preloadPromise;
+  }
+  async _doPreload() {
+    var _a2, _b2, _c, _d, _e, _f, _g;
+    const cfg = this.config;
+    const w = typeof window !== "undefined" ? window : {};
+    const base = cfg.baseUrl || w.sherpaonnxBase || SHERPA_DEFAULT_BASE;
+    w.sherpaonnxBase = base;
+    this._sherpaBase = base;
+    this._sherpaVersion = cfg.version || "";
+    const echo = cfg.echoGuard || {};
+    if (echo.prefixRatio != null) w._echoPrefixRatio = echo.prefixRatio;
+    if (echo.bigramRatio != null) w._echoBigramRatio = echo.bigramRatio;
+    if (!w.SherpaOnnxLocalRTC) {
+      this._setProgress({ phase: "加载 sherpa-onnx-local-rtc.js..." });
+      await loadScript$1(base + "sherpa-onnx-local-rtc.js").catch(
+        (e) => console$6.warn("[LocalRTCController] local-rtc 脚本加载失败", e)
+      );
+    }
+    const ready = await waitForSherpaGlobal();
+    if (!ready) {
+      throw new Error("window.SherpaOnnxLocalRTC 未就绪（sherpa-onnx-local-rtc.js 加载失败？）");
+    }
+    await Promise.all([
+      loadScript$1(base + "sherpa-onnx-kws.js").catch((e) => console$6.warn("[LocalRTCController] kws 脚本加载失败", e))
+    ]);
+    const LocalRTC2 = this._resolveLocalRTCClass();
+    if (!LocalRTC2) {
+      throw new Error("LocalRTC 类不可用");
+    }
+    this._LocalRTC = LocalRTC2;
+    const asrRuntime = cfg.asrRuntime || (cfg.runtime === "android" ? "android" : "wasm");
+    const rtc = new LocalRTC2({
+      baseUrl: base,
+      asrRuntime,
+      minAudioRms: cfg.minAudioRms ?? 0.015,
+      audioSource: ((_a2 = cfg.audio) == null ? void 0 : _a2.source) || "voice_communication",
+      aecEnabled: ((_b2 = cfg.audio) == null ? void 0 : _b2.aecEnabled) !== false,
+      vadConfig: ((_c = cfg.vad) == null ? void 0 : _c.enabled) !== false ? cfg.vad || void 0 : void 0,
+      kwsKeywords: ((_d = cfg.kws) == null ? void 0 : _d.keywords) || [],
+      kwsThreshold: ((_e = cfg.kws) == null ? void 0 : _e.threshold) ?? 0.25,
+      bargeInThreshold: ((_f = cfg.bargeIn) == null ? void 0 : _f.threshold) ?? 0.04,
+      bargeInMinFrames: ((_g = cfg.bargeIn) == null ? void 0 : _g.minFrames) ?? 2,
+      onLog: (msg) => console$6.log(msg),
+      onError: (msg) => console$6.warn("ERROR " + msg),
+      onStateChange: (state, old) => console$6.log(`State: ${old} -> ${state}`),
+      onKwsDetected: (keyword, action) => this._handleKwsDetected(keyword, action),
+      onAsrPartial: (text) => this._handleAsrPartial(text),
+      onAsrResult: (text, all) => this._handleAsrResult(text, all),
+      onProgress: (label, pct, source) => {
+        const key = String(label || "").toLowerCase().includes("asr") ? "asr" : "kws";
+        this._setProgress({ [key]: Math.round(pct), source: source || this._loadProgress.source, phase: `加载${label} ${Math.round(pct)}%` });
+      }
+    });
+    this._rtc = rtc;
+    w.localRTC = rtc;
+    this._setProgress({ phase: "加载 WASM 运行时...", wasm: 5 });
+    console$6.log("Calling init()...");
+    await rtc.init();
+    this._setProgress({ phase: "WASM 就绪", wasm: 100 });
+    console$6.log("WASM runtime ready");
+    const tasks = [
+      rtc.preloadKws().then(() => {
+        this._setProgress({ kws: 100 });
+        console$6.log("KWS preloaded");
+      }).catch((e) => {
+        this._setProgress({ error: "KWS:" + ((e == null ? void 0 : e.message) || e) });
+        console$6.warn("KWS preload failed: " + ((e == null ? void 0 : e.message) || e));
+      })
+    ];
+    if (cfg.preloadAsr) {
+      tasks.push(
+        rtc.preloadAsr().then(() => {
+          this._setProgress({ asr: 100 });
+          console$6.log("ASR preloaded");
+        }).catch((e) => {
+          this._setProgress({ error: "ASR:" + ((e == null ? void 0 : e.message) || e) });
+          console$6.warn("ASR preload failed: " + ((e == null ? void 0 : e.message) || e));
+        })
+      );
+    } else {
+      this._setProgress({ asr: -1 });
+    }
+    await Promise.all(tasks);
+    this._setProgress({ phase: "就绪", done: true });
+    await this._startKwsWithRetry();
+    return rtc;
+  }
+  /**
+   * 启动 WASM KWS，失败时重试若干次。
+   * "Could not start audio source" 多为麦克风被上一次会话/其它进程残留占用。
+   */
+  async _startKwsWithRetry(maxAttempts = 3, delayMs = 500) {
+    var _a2;
+    const rtc = this._rtc;
+    if (!rtc) return false;
+    for (let i = 1; i <= maxAttempts; i++) {
+      try {
+        await rtc.start();
+        console$6.log(`WASM KWS listening started${i > 1 ? `（第 ${i} 次尝试成功）` : ""}`);
+        return true;
+      } catch (e) {
+        const msg = (e == null ? void 0 : e.message) || e;
+        console$6.warn(`start() 第 ${i}/${maxAttempts} 次失败: ${msg}`);
+        if (i < maxAttempts) {
+          try {
+            (_a2 = rtc.stop) == null ? void 0 : _a2.call(rtc);
+          } catch {
+          }
+          await new Promise((r) => setTimeout(r, delayMs));
+        } else {
+          this._emitStatus("麦克风被占用，唤醒启动失败");
+          console$6.warn("WASM KWS 启动最终失败：麦克风可能被其它应用/会话占用");
+        }
+      }
+    }
+    return false;
+  }
+  // =================== 唤醒待机 / 麦克风让渡 ===================
+  /**
+   * 对话结束后重启 WASM KWS 唤醒监听（web/android 统一），回到「待唤醒」状态。
+   */
+  async resumeKws() {
+    const rtc = this._rtc;
+    if (!rtc) return false;
+    if (this._localVcActive) return false;
+    const ok = await this._startKwsWithRetry();
+    if (ok) {
+      this._emitStatus("待唤醒...");
+      console$6.log("对话已结束，WASM KWS 已重启（待唤醒）");
+    }
+    return ok;
+  }
+  /**
+   * 启动云端 RTC 前，停掉 WASM KWS 释放麦克风（+短延迟确保设备真正释放）。
+   */
+  async releaseMicForCloud() {
+    const rtc = this._rtc;
+    if (!(rtc == null ? void 0 : rtc.stop)) return;
+    try {
+      rtc.stop();
+      console$6.log("云端启动前：已停止 WASM KWS 并释放麦克风");
+      await new Promise((r) => setTimeout(r, 150));
+    } catch (e) {
+      console$6.warn("releaseMicForCloud error: " + ((e == null ? void 0 : e.message) || e));
+    }
+  }
+  // =================== 热切换：本地 ASR ⇄ 云端 ===================
+  /**
+   * 开启本地 ASR（从云端切换到本地，或直接启动本地语音会话）。
+   * @returns 是否成功
+   */
+  async enableLocalAsr(opts = {}) {
+    const skipSwitchToAsr = opts.skipSwitchToAsr === true || this._wakeViaKwsLocalAsr === true;
+    this._wakeViaKwsLocalAsr = false;
+    const rtc = this._rtc;
+    if (!rtc) {
+      console$6.warn("LocalRTC not available");
+      this._emitStatus("本地语音不可用");
+      return false;
+    }
+    if (this._localVcActive) {
+      console$6.log("enableLocalAsr 忽略：已处于本地对话中");
+      return true;
+    }
+    console$6.log(`Starting local voice chat (ASR -> LLM -> TTS)...${skipSwitchToAsr ? "（switchToAsr 交给 SDK 自动）" : ""}`);
+    this._localVcActive = true;
+    let asrOk = false;
+    if (skipSwitchToAsr) {
+      asrOk = true;
+    } else {
+      if (this._localAsrEndTime) {
+        const sinceEnd = Date.now() - this._localAsrEndTime;
+        const minGap = 600;
+        if (sinceEnd >= 0 && sinceEnd < minGap) {
+          const wait = minGap - sinceEnd;
+          console$6.log(`距上次本地 ASR 结束 ${sinceEnd}ms，等 ${wait}ms 供原生 AudioRecord 重初始化`);
+          await new Promise((r) => setTimeout(r, wait));
+        }
+      }
+      try {
+        asrOk = await rtc.switchToAsr();
+      } catch (e) {
+        console$6.warn("switchToAsr error: " + ((e == null ? void 0 : e.message) || e));
+      }
+    }
+    if (!asrOk) {
+      console$6.log("ASR not available (no native bridge?). Cannot start local voice chat.");
+      this._localVcActive = false;
+      this._emitStatus("本地 ASR 不可用");
+      return false;
+    }
+    this._localTtsEndTime = Date.now();
+    this._localTtsPlaying = false;
+    this._currentTtsText = "";
+    this._emitStatus("本地：聆听中...");
+    console$6.log("Now using local ASR");
+    return true;
+  }
+  /**
+   * 关闭本地 ASR。
+   * @param opts.resumeKws 结束后是否回到 WASM KWS 待唤醒（true=结束对话；false=热切换到云端）
+   */
+  async disableLocalAsr(opts = {}) {
+    var _a2, _b2, _c, _d;
+    const resumeKws = opts.resumeKws !== false;
+    this._localVcActive = false;
+    this._lastSentAsrText = "";
+    this._localAsrEndTime = Date.now();
+    this._localTtsPlaying = false;
+    this._localAsrPausedForTts = false;
+    this._restoreBargeIn();
+    if (!resumeKws) {
+      try {
+        if ((_a2 = this._rtc) == null ? void 0 : _a2.stopAsr) {
+          this._rtc.stopAsr();
+          await new Promise((r) => setTimeout(r, 500));
+        }
+        (_c = (_b2 = this._rtc) == null ? void 0 : _b2.stop) == null ? void 0 : _c.call(_b2);
+        await new Promise((r) => setTimeout(r, 500));
+        console$6.log("本地 ASR 已结束（热切换到云端：原生 ASR 已停、麦克风已释放，不重启 KWS）");
+      } catch (e) {
+        console$6.warn("disableLocalAsr(stop for cloud) error: " + ((e == null ? void 0 : e.message) || e));
+      }
+      return;
+    }
+    try {
+      if ((_d = this._rtc) == null ? void 0 : _d.stopAsr) {
+        this._rtc.stopAsr();
+        this._emitStatus("待唤醒...");
+        console$6.log("本地 ASR 已结束（stopAsr → 自动回到 KWS 待唤醒）");
+        return;
+      }
+    } catch (e) {
+      console$6.warn("disableLocalAsr stopAsr error: " + ((e == null ? void 0 : e.message) || e));
+    }
+    void this.resumeKws();
+  }
+  // =================== TTS 生命周期联动（内置订阅 host 事件） ===================
+  /** host textSpeechStart：TTS 开始播放 */
+  async onTtsStart() {
+    if (!this._localVcActive || !this._rtc || !this._isLocalAsrEnabled()) return;
+    this._localTtsPlaying = true;
+    this._currentTtsText = "";
+    if (this._getInterruptionEnabled()) {
+      this._localAsrPausedForTts = false;
+      console$6.log("TTS 开始 — 打断模式，ASR 保持活跃（AEC + echo guard）");
+    } else {
+      try {
+        const alreadyPaused = this._rtc.isAsrPaused && this._rtc.isAsrPaused();
+        if (alreadyPaused) {
+          this._localAsrPausedForTts = true;
+          this._suppressBargeIn();
+          console$6.log("TTS 开始 — ASR 已处于暂停状态，保持暂停");
+        } else if (this._rtc.getState && this._rtc.getState() === "ASR_LISTENING") {
+          this._suppressBargeIn();
+          await this._rtc.pauseAsr();
+          this._localAsrPausedForTts = true;
+          console$6.log("TTS 开始 — ASR 已暂停（pauseAsr，能量打断已禁用）");
+        } else {
+          this._localAsrPausedForTts = false;
+        }
+      } catch (e) {
+        console$6.warn("onTtsStart error: " + ((e == null ? void 0 : e.message) || e));
+      }
+    }
+  }
+  /** host textSpeechEnd：TTS 播放结束 */
+  async onTtsEnd() {
+    if (!this._localVcActive || !this._isLocalAsrEnabled()) return;
+    this._localTtsPlaying = false;
+    this._localTtsEndTime = Date.now();
+    if (!this._localAsrPausedForTts) {
+      console$6.log("TTS 结束 — ASR 未曾暂停");
+      this._emitStatus("本地：聆听中...");
+      return;
+    }
+    this._localAsrPausedForTts = false;
+    this._restoreBargeIn();
+    if (this._localVcActive && !this._localVcProcessing && this._rtc) {
+      try {
+        await this._rtc.resumeAsr();
+        console$6.log("TTS 结束 — ASR 已恢复（resumeAsr）");
+        this._emitStatus("本地：聆听中...");
+      } catch (e) {
+        console$6.warn("resumeAsr after TTS error: " + ((e == null ? void 0 : e.message) || e));
+      }
+    }
+  }
+  /** host textSpeechCanceled：TTS 被打断/取消 */
+  async onTtsCanceled() {
+    if (!this._localVcActive || !this._isLocalAsrEnabled()) return;
+    this._localTtsPlaying = false;
+    this._localTtsEndTime = Date.now();
+    if (!this._localAsrPausedForTts) {
+      console$6.log("TTS 取消 — ASR 未曾暂停");
+      this._emitStatus("本地：聆听中...");
+      return;
+    }
+    this._localAsrPausedForTts = false;
+    if (this._localVcProcessing) {
+      console$6.log("TTS 取消（新 LLM 调用进行中，ASR 保持暂停）");
+      return;
+    }
+    this._restoreBargeIn();
+    if (this._localVcActive && !this._localVcProcessing && this._rtc) {
+      try {
+        await this._rtc.resumeAsr();
+        console$6.log("TTS 取消 — ASR 已恢复（resumeAsr）");
+        this._emitStatus("本地：聆听中...");
+      } catch (e) {
+        console$6.warn("resumeAsr after cancel error: " + ((e == null ? void 0 : e.message) || e));
+      }
+    }
+  }
+  /** 非打断模式：禁用 barge-in 能量检测（阈值推到 Infinity）。幂等。 */
+  _suppressBargeIn() {
+    const rtc = this._rtc;
+    if (!rtc || this._savedBargeInThreshold != null) return;
+    if (typeof rtc._bargeInThreshold === "number") {
+      this._savedBargeInThreshold = rtc._bargeInThreshold;
+      rtc._bargeInThreshold = Infinity;
+    }
+  }
+  /** 恢复被 _suppressBargeIn 暂存的 barge-in 能量阈值。 */
+  _restoreBargeIn() {
+    const rtc = this._rtc;
+    if (!rtc || this._savedBargeInThreshold == null) return;
+    rtc._bargeInThreshold = this._savedBargeInThreshold;
+    this._savedBargeInThreshold = null;
+  }
+  // =================== LocalRTC 回调 ===================
+  _handleKwsDetected(keyword, action) {
+    var _a2, _b2;
+    console$6.log(`KWS "${keyword}" (${action})`);
+    if (action === "start") {
+      void this._wakeAndStartChat();
+    } else if (action === "stop") {
+      (_b2 = (_a2 = this.hooks).onToggleVoiceChat) == null ? void 0 : _b2.call(_a2, "stop");
+    }
+  }
+  /**
+   * 唤醒命中后启动对话。按模式区分麦克风处理。
+   */
+  async _wakeAndStartChat() {
+    var _a2, _b2, _c, _d;
+    const localAsr = this._isLocalAsrEnabled();
+    if (!localAsr) {
+      try {
+        (_b2 = (_a2 = this._rtc) == null ? void 0 : _a2.stop) == null ? void 0 : _b2.call(_a2);
+        console$6.log("唤醒命中（云端）：已同步停止 KWS（阻止 SDK 自动 switchToAsr）并释放麦克风");
+      } catch (e) {
+        console$6.warn("唤醒命中云端 stop 失败: " + ((e == null ? void 0 : e.message) || e));
+      }
+    } else {
+      this._wakeViaKwsLocalAsr = true;
+      console$6.log("唤醒命中（localASR）：由 SDK 自动 switchToAsr，回调不重复切换");
+    }
+    (_d = (_c = this.hooks).onToggleVoiceChat) == null ? void 0 : _d.call(_c, "start");
+  }
+  _isLikelyEcho(text) {
+    const w = typeof window !== "undefined" ? window : {};
+    const Cls = this._LocalRTC || w.SherpaOnnxLocalRTC;
+    if (!(Cls == null ? void 0 : Cls.isLikelyEcho)) return false;
+    return Cls.isLikelyEcho(text, this._currentTtsText, {
+      prefixRatio: w._echoPrefixRatio,
+      bigramRatio: w._echoBigramRatio
+    });
+  }
+  _handleAsrPartial(text) {
+    console$6.log(`ASR partial: ${text}`);
+    if (!this._localVcActive || !String(text || "").trim()) return;
+    this._emitStatus(`本地：${String(text).slice(0, 30)}...`);
+    if (this._localTtsPlaying && this._getInterruptionEnabled()) {
+      if (!this._isLikelyEcho(text)) {
+        console$6.log(`[Barge-in partial] 取消 TTS+LLM："${text}"`);
+        this._localTtsPlaying = false;
+        try {
+          void this.host.cancelSend("barge-in");
+        } catch (e) {
+          console$6.warn("cancelSend error: " + ((e == null ? void 0 : e.message) || e));
+        }
+      }
+    }
+  }
+  async _handleAsrResult(text, _all) {
+    var _a2, _b2, _c, _d, _e, _f;
+    const trimmed = normalizeText(text);
+    const keywords = ((_b2 = (_a2 = this.config) == null ? void 0 : _a2.kws) == null ? void 0 : _b2.keywords) || [];
+    const stopKeywords = keywords.filter((k) => k.type === "stop").map((k) => k.keyword);
+    const startKeywords = keywords.filter((k) => k.type === "start").map((k) => k.keyword);
+    const matches = (list) => list.some(
+      (kw) => trimmed === kw || trimmed.endsWith(kw) || trimmed.includes(kw) && trimmed.length <= kw.length + 2
+    );
+    if (matches(stopKeywords)) {
+      console$6.log("Stop keyword in ASR — hanging up");
+      (_d = (_c = this.hooks).onToggleVoiceChat) == null ? void 0 : _d.call(_c, "stop");
+      return;
+    }
+    if (!this._localVcActive) {
+      console$6.log(`未在对话中，忽略 ASR："${trimmed}"`);
+      return;
+    }
+    if (matches(startKeywords)) {
+      console$6.log(`Start keyword in ASR — ignoring: "${trimmed}"`);
+      return;
+    }
+    console$6.log(`ASR result: ${text}`);
+    if (this._localTtsPlaying) {
+      if (this._isLikelyEcho(text)) {
+        console$6.log(`[Echo Guard] 忽略 TTS 期间回声: ${text}`);
+        return;
+      }
+      if (this._getInterruptionEnabled()) {
+        console$6.log(`[Barge-in] 用户打断 TTS（final）: ${text}`);
+        this._localTtsPlaying = false;
+      } else {
+        console$6.log(`[非打断] 忽略 TTS 期间 ASR 结果: ${text}`);
+        return;
+      }
+    }
+    if (this._localTtsEndTime && Date.now() - this._localTtsEndTime < 1500) {
+      if (this._isLikelyEcho(text)) {
+        console$6.log(`[Echo Guard] 忽略 TTS 后回声 (${Date.now() - this._localTtsEndTime}ms): ${text}`);
+        return;
+      }
+    }
+    if (this._lastSentAsrText && trimmed === normalizeText(this._lastSentAsrText)) {
+      console$6.log(`忽略重复 ASR: ${text}`);
+      this._lastSentAsrText = "";
+      return;
+    }
+    if (this._localVcActive && String(text).trim()) {
+      this._ttsVersion++;
+      const myVersion = this._ttsVersion;
+      this._localVcProcessing = true;
+      this._lastSentAsrText = text;
+      try {
+        (_f = (_e = this.hooks).onUserSpeech) == null ? void 0 : _f.call(_e, String(text).trim());
+      } catch (e) {
+        console$6.warn("onUserSpeech error: " + ((e == null ? void 0 : e.message) || e));
+      }
+      this._emitStatus("本地：思考中...");
+      try {
+        await this.host.cancelSend("barge-in");
+        const result = await this.host.sendMessage(text, { textToSpeech: true });
+        const reply = (result == null ? void 0 : result.finalText) || "";
+        console$6.log(
+          `LLM reply v${myVersion} (${reply.length} chars)` + (myVersion !== this._ttsVersion ? " [superseded]" : "")
+        );
+        if (reply && this._localVcActive) {
+          this._emitStatus("本地：等待 TTS...");
+        }
+      } catch (e) {
+        console$6.warn("Local VC error: " + ((e == null ? void 0 : e.message) || e));
+        if (this._localVcActive && myVersion === this._ttsVersion) {
+          this._emitStatus("本地：聆听中...");
+        }
+      } finally {
+        this._localVcProcessing = false;
+      }
+    }
+  }
+  // =================== 调试 API（下沉自 silvermind 调试面板） ===================
+  /** 读取当前 LocalRTC 相关属性快照（供调试面板展示）。 */
+  getDebugConfig() {
+    var _a2, _b2, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q;
+    const cfg = this.config || {};
+    const rtc = this._rtc;
+    const w = typeof window !== "undefined" ? window : {};
+    return {
+      runtime: cfg.runtime || "-",
+      asrRuntime: cfg.asrRuntime || (cfg.runtime === "android" ? "android" : "wasm"),
+      state: (rtc == null ? void 0 : rtc.getState) ? rtc.getState() : "-",
+      localVcActive: this._localVcActive,
+      localAsrEnabled: this._isLocalAsrEnabled(),
+      isAndroid: this._isAndroidRuntime(),
+      loadProgress: this.getLoadProgress(),
+      sherpa: (() => {
+        const base = this._sherpaBase || cfg.baseUrl || w.sherpaonnxBase || SHERPA_DEFAULT_BASE;
+        const version = this._sherpaVersion || cfg.version || (rtc == null ? void 0 : rtc._version) || "";
+        return {
+          base,
+          version: version || "latest",
+          isDefaultCdn: base === SHERPA_DEFAULT_BASE,
+          coreUrl: base + "sherpa-onnx-local-rtc.js",
+          wasmUrl: base + "sherpa-onnx-wasm-full.wasm",
+          kwsUrl: base + "sherpa-onnx-kws.js"
+        };
+      })(),
+      interruptionEnabled: ((_a2 = cfg.interruption) == null ? void 0 : _a2.enabled) !== false,
+      minAudioRms: (rtc == null ? void 0 : rtc._minAudioRms) != null ? rtc._minAudioRms : cfg.minAudioRms ?? 0.015,
+      bargeInThreshold: this._savedBargeInThreshold != null ? this._savedBargeInThreshold : (rtc == null ? void 0 : rtc._bargeInThreshold) != null && Number.isFinite(rtc._bargeInThreshold) ? rtc._bargeInThreshold : ((_b2 = cfg.bargeIn) == null ? void 0 : _b2.threshold) ?? 0.04,
+      bargeInMinFrames: (rtc == null ? void 0 : rtc._bargeInMinFrames) != null ? rtc._bargeInMinFrames : ((_c = cfg.bargeIn) == null ? void 0 : _c.minFrames) ?? 2,
+      kwsThreshold: (rtc == null ? void 0 : rtc._kwsThreshold) != null ? rtc._kwsThreshold : ((_d = cfg.kws) == null ? void 0 : _d.threshold) ?? 0.25,
+      kwsKeywords: (Array.isArray(rtc == null ? void 0 : rtc._kwsKeywords) && rtc._kwsKeywords.length ? rtc._kwsKeywords : (_e = cfg.kws) == null ? void 0 : _e.keywords) || [],
+      echoPrefixRatio: w._echoPrefixRatio ?? ((_f = cfg.echoGuard) == null ? void 0 : _f.prefixRatio) ?? 0.8,
+      echoBigramRatio: w._echoBigramRatio ?? ((_g = cfg.echoGuard) == null ? void 0 : _g.bigramRatio) ?? 0.5,
+      audioSource: (rtc == null ? void 0 : rtc._audioSource) ?? ((_h = cfg.audio) == null ? void 0 : _h.source) ?? "voice_communication",
+      aecEnabled: (rtc == null ? void 0 : rtc.getAecEnabled) ? rtc.getAecEnabled() : ((_i = cfg.audio) == null ? void 0 : _i.aecEnabled) !== false,
+      vadEnabled: ((_j = rtc == null ? void 0 : rtc._vadConfig) == null ? void 0 : _j.enabled) ?? ((_k = cfg.vad) == null ? void 0 : _k.enabled) !== false,
+      vadThreshold: ((_l = rtc == null ? void 0 : rtc._vadConfig) == null ? void 0 : _l.threshold) ?? ((_m = cfg.vad) == null ? void 0 : _m.threshold) ?? 0.3,
+      vadMinSilence: ((_n = rtc == null ? void 0 : rtc._vadConfig) == null ? void 0 : _n.minSilenceDuration) ?? ((_o = cfg.vad) == null ? void 0 : _o.minSilenceDuration) ?? 0.4,
+      vadMinSpeech: ((_p = rtc == null ? void 0 : rtc._vadConfig) == null ? void 0 : _p.minSpeechDuration) ?? ((_q = cfg.vad) == null ? void 0 : _q.minSpeechDuration) ?? 0.1
+    };
+  }
+  /** 组装当前 VAD 配置对象。 */
+  _buildVadConfig() {
+    const cfg = this.config || {};
+    const rtc = this._rtc;
+    const cur = (rtc == null ? void 0 : rtc._vadConfig) || cfg.vad || {};
+    return {
+      enabled: cur.enabled !== false,
+      threshold: cur.threshold ?? 0.3,
+      minSilenceDuration: cur.minSilenceDuration ?? 0.4,
+      minSpeechDuration: cur.minSpeechDuration ?? 0.1
+    };
+  }
+  /** 把 VAD 配置热更新到 rtc 实例 + 原生桥接（live 生效）。 */
+  _applyVadConfig(vad2) {
+    const cfg = this.config || (this.config = {});
+    cfg.vad = { ...cfg.vad || {}, ...vad2 };
+    const rtc = this._rtc;
+    if (rtc) rtc._vadConfig = { ...vad2 };
+    try {
+      const w = typeof window !== "undefined" ? window : {};
+      const bridge = w.SherpaOnnxAsrBridge || w.AndroidAsrBridge || null;
+      if (bridge && typeof bridge.configureVad === "function") {
+        bridge.configureVad(JSON.stringify(vad2));
+      }
+    } catch (e) {
+      console$6.warn("configureVad error: " + ((e == null ? void 0 : e.message) || e));
+    }
+  }
+  /** 热更新单个 LocalRTC 属性（仅内存，不持久化）。 */
+  applyDebugSetting(key, value) {
+    var _a2, _b2, _c, _d;
+    const cfg = this.config || (this.config = {});
+    const rtc = this._rtc;
+    const w = typeof window !== "undefined" ? window : {};
+    switch (key) {
+      case "interruptionEnabled": {
+        if (!cfg.interruption) cfg.interruption = {};
+        cfg.interruption.enabled = !!value;
+        if (value && this._savedBargeInThreshold != null) this._restoreBargeIn();
+        console$6.log(`[Debug] interruption.enabled = ${!!value}`);
+        break;
+      }
+      case "minAudioRms": {
+        cfg.minAudioRms = value;
+        try {
+          (_a2 = rtc == null ? void 0 : rtc.setMinAudioRms) == null ? void 0 : _a2.call(rtc, value);
+        } catch (e) {
+          console$6.warn("setMinAudioRms error: " + ((e == null ? void 0 : e.message) || e));
+        }
+        console$6.log(`[Debug] minAudioRms = ${value}`);
+        break;
+      }
+      case "bargeInThreshold": {
+        if (!cfg.bargeIn) cfg.bargeIn = {};
+        cfg.bargeIn.threshold = value;
+        if (this._savedBargeInThreshold != null) this._savedBargeInThreshold = value;
+        else if (rtc) rtc._bargeInThreshold = value;
+        console$6.log(`[Debug] bargeIn.threshold = ${value}`);
+        break;
+      }
+      case "bargeInMinFrames": {
+        if (!cfg.bargeIn) cfg.bargeIn = {};
+        cfg.bargeIn.minFrames = value;
+        if (rtc) rtc._bargeInMinFrames = value;
+        console$6.log(`[Debug] bargeIn.minFrames = ${value}`);
+        break;
+      }
+      case "kwsThreshold": {
+        if (!cfg.kws) cfg.kws = {};
+        cfg.kws.threshold = value;
+        try {
+          (_b2 = rtc == null ? void 0 : rtc.setKwsThreshold) == null ? void 0 : _b2.call(rtc, value);
+        } catch (e) {
+          console$6.warn("setKwsThreshold error: " + ((e == null ? void 0 : e.message) || e));
+        }
+        console$6.log(`[Debug] kws.threshold = ${value}`);
+        break;
+      }
+      case "echoPrefixRatio": {
+        if (!cfg.echoGuard) cfg.echoGuard = {};
+        cfg.echoGuard.prefixRatio = value;
+        w._echoPrefixRatio = value;
+        console$6.log(`[Debug] echoGuard.prefixRatio = ${value}`);
+        break;
+      }
+      case "echoBigramRatio": {
+        if (!cfg.echoGuard) cfg.echoGuard = {};
+        cfg.echoGuard.bigramRatio = value;
+        w._echoBigramRatio = value;
+        console$6.log(`[Debug] echoGuard.bigramRatio = ${value}`);
+        break;
+      }
+      case "audioSource": {
+        if (!cfg.audio) cfg.audio = {};
+        cfg.audio.source = value;
+        if (rtc) rtc._audioSource = value;
+        try {
+          const bridge = w.SherpaOnnxAsrBridge || w.AndroidAsrBridge || null;
+          (_c = bridge == null ? void 0 : bridge.configureAudioSource) == null ? void 0 : _c.call(bridge, JSON.stringify({ source: value }));
+        } catch (e) {
+          console$6.warn("configureAudioSource error: " + ((e == null ? void 0 : e.message) || e));
+        }
+        console$6.log(`[Debug] audio.source = ${value}（下次录音生效）`);
+        break;
+      }
+      case "aecEnabled": {
+        if (!cfg.audio) cfg.audio = {};
+        cfg.audio.aecEnabled = !!value;
+        try {
+          (_d = rtc == null ? void 0 : rtc.setAecEnabled) == null ? void 0 : _d.call(rtc, !!value);
+        } catch (e) {
+          console$6.warn("setAecEnabled error: " + ((e == null ? void 0 : e.message) || e));
+        }
+        console$6.log(`[Debug] audio.aecEnabled = ${!!value}`);
+        break;
+      }
+      case "vadEnabled": {
+        const vad2 = this._buildVadConfig();
+        vad2.enabled = !!value;
+        this._applyVadConfig(vad2);
+        console$6.log(`[Debug] vad.enabled = ${!!value}`);
+        break;
+      }
+      case "vadThreshold": {
+        const vad2 = this._buildVadConfig();
+        vad2.threshold = value;
+        this._applyVadConfig(vad2);
+        console$6.log(`[Debug] vad.threshold = ${value}`);
+        break;
+      }
+      case "vadMinSilence": {
+        const vad2 = this._buildVadConfig();
+        vad2.minSilenceDuration = value;
+        this._applyVadConfig(vad2);
+        console$6.log(`[Debug] vad.minSilenceDuration = ${value}`);
+        break;
+      }
+      case "vadMinSpeech": {
+        const vad2 = this._buildVadConfig();
+        vad2.minSpeechDuration = value;
+        this._applyVadConfig(vad2);
+        console$6.log(`[Debug] vad.minSpeechDuration = ${value}`);
+        break;
+      }
+      default:
+        console$6.warn(`[Debug] 未知属性: ${key}`);
+    }
+  }
+  /** 查询 Android 音频效果状态（AEC/NS/AGC），需原生桥接支持。 */
+  async queryAudioEffects() {
+    const rtc = this._rtc;
+    if (!rtc || typeof rtc.getAudioEffectsInfo !== "function") {
+      return { error: "getAudioEffectsInfo 不可用（需 Android 原生桥接）" };
+    }
+    try {
+      return await rtc.getAudioEffectsInfo();
+    } catch (e) {
+      return { error: String((e == null ? void 0 : e.message) || e) };
+    }
+  }
+  // =================== 销毁 ===================
+  /** 销毁控制器（页面卸载/auth 切换/host destroy 时）。 */
+  async destroy() {
+    var _a2, _b2, _c, _d;
+    try {
+      if (this._onTtsStartBound) this.host.off("textSpeechStart", this._onTtsStartBound);
+      if (this._onTtsEndBound) this.host.off("textSpeechEnd", this._onTtsEndBound);
+      if (this._onTtsCanceledBound) this.host.off("textSpeechCanceled", this._onTtsCanceledBound);
+    } catch {
+    }
+    this._onTtsStartBound = null;
+    this._onTtsEndBound = null;
+    this._onTtsCanceledBound = null;
+    const wasLocalVc = this._localVcActive;
+    this._localVcActive = false;
+    this._wakeViaKwsLocalAsr = false;
+    if (this._rtc) {
+      try {
+        if (wasLocalVc && this._rtc.stopAsr) {
+          try {
+            this._rtc.stopAsr();
+          } catch {
+          }
+          await new Promise((r) => setTimeout(r, 300));
+        }
+        (_b2 = (_a2 = this._rtc).stop) == null ? void 0 : _b2.call(_a2);
+        (_d = (_c = this._rtc).destroy) == null ? void 0 : _d.call(_c);
+      } catch (e) {
+        console$6.warn("destroy error: " + ((e == null ? void 0 : e.message) || e));
+      }
+    }
+    this._rtc = null;
+    this._preloaded = false;
+    this._preloadPromise = null;
+    this._localAsrEndTime = 0;
+    if (typeof window !== "undefined") window.localRTC = null;
+  }
+}
 SDKLogger.createModuleConsole("SpeechRTC");
 const DEFAULT_WS_URL = "wss://openspeech.bytedance.com/api/v3/tts/bidirection";
 const DEFAULT_PROXY_URL = "wss://speechrtc.keepwork.com/tts";
@@ -26913,145 +28120,6 @@ class SpeechRTCSession {
     this._audioTime = 0;
   }
 }
-function detectFormat(url) {
-  if (!url || typeof url !== "string") return null;
-  const path = url.split(/[?#]/)[0].toLowerCase();
-  if (path.endsWith(".json")) return "json";
-  if (path.endsWith(".yml") || path.endsWith(".yaml")) return "yml";
-  if (path.endsWith(".md")) return "md";
-  return null;
-}
-function normalize(config) {
-  if (!config || typeof config !== "object") return config;
-  if (config.content && !config.system_prompt) {
-    const body = String(config.content).trim();
-    if (body) config.system_prompt = body;
-  }
-  delete config.content;
-  if (config.workspace) {
-    if (!config.tools) config.tools = {};
-    if (!config.tools.fileOps) config.tools.fileOps = { enabled: false };
-    if (!config.tools.fileOps.workspace) {
-      config.tools.fileOps.workspace = config.workspace;
-    }
-  }
-  if (config.mountFolder) {
-    if (!config.tools) config.tools = {};
-    if (!config.tools.fileOps) config.tools.fileOps = { enabled: false };
-    if (!config.tools.fileOps.mountFolder) {
-      config.tools.fileOps.mountFolder = config.mountFolder;
-    }
-  }
-  if (config.history_length !== void 0 && config.historyLength === void 0) {
-    config.historyLength = config.history_length;
-  }
-  delete config.history_length;
-  return config;
-}
-function parseTable(tableText) {
-  if (!tableText || typeof tableText !== "string") return {};
-  const lines = tableText.split("\n").map((l) => l.trim()).filter((l) => l.startsWith("|"));
-  if (lines.length < 2) return {};
-  const headerCells = lines[0].split("|").map((c) => c.trim()).filter(Boolean);
-  const dataLines = lines.slice(2);
-  const rows = dataLines.map((line) => {
-    const cells = line.split("|").map((c) => c.trim()).filter(Boolean);
-    const row = {};
-    headerCells.forEach((h, i) => {
-      row[h] = cells[i] !== void 0 ? cells[i] : "";
-    });
-    return row;
-  });
-  if (headerCells.length === 2) {
-    const [keyCol, valCol] = headerCells;
-    const isKV = keyCol.toLowerCase() === "key" && valCol.toLowerCase() === "value";
-    if (isKV) {
-      const obj = {};
-      for (const row of rows) {
-        const k = row[keyCol];
-        if (k) obj[k] = _coerceValue(row[valCol]);
-      }
-      return obj;
-    }
-  }
-  return rows;
-}
-function _coerceValue(v) {
-  if (v === "true") return true;
-  if (v === "false") return false;
-  if (v === "null" || v === "") return null;
-  const n = Number(v);
-  if (!isNaN(n) && v.trim() !== "") return n;
-  return v;
-}
-function parse(text, formatHint) {
-  if (!text || typeof text !== "string") return {};
-  const trimmed = text.trim();
-  if (formatHint === "json" || trimmed.startsWith("{") || trimmed.startsWith("[")) {
-    return normalize(JSON.parse(trimmed));
-  }
-  if (trimmed.startsWith("---\n") || trimmed.startsWith("---\r\n")) {
-    const YML = _getYMLParser();
-    if (YML) return normalize(YML.yamlToObject(trimmed, true));
-  }
-  const firstLine = trimmed.split("\n").find((l) => l.trim());
-  if (firstLine && firstLine.trim().startsWith("|")) {
-    return normalize(parseTable(trimmed));
-  }
-  try {
-    return normalize(JSON.parse(trimmed));
-  } catch {
-    const YML = _getYMLParser();
-    if (YML) return normalize(YML.yamlToObject(trimmed, true));
-  }
-  return {};
-}
-async function fetchConfig(source) {
-  if (source && typeof source === "object") {
-    return normalize({ ...source });
-  }
-  if (typeof source !== "string" || !source.trim()) {
-    throw new Error("AgentConfig.fetch: source must be a non-empty string or object");
-  }
-  const trimmed = source.trim();
-  if (trimmed.startsWith("{") || trimmed.startsWith("[")) {
-    return normalize(JSON.parse(trimmed));
-  }
-  const resp = await fetch(trimmed);
-  if (!resp.ok) {
-    throw new Error(`AgentConfig.fetch: fetch failed (${resp.status}) for ${trimmed}`);
-  }
-  let text = await resp.text();
-  text = text.replace(
-    /<script[^>]*\/___vscode_livepreview_injected_script[^>]*><\/script>\s*/gi,
-    ""
-  );
-  const format = detectFormat(trimmed);
-  return parse(text, format);
-}
-function _getYMLParser() {
-  if (typeof YMLParser !== "undefined") return YMLParser;
-  if (typeof window !== "undefined" && window.YMLParser) {
-    return window.YMLParser;
-  }
-  return null;
-}
-const AgentConfig = {
-  detectFormat,
-  normalize,
-  parse,
-  parseTable,
-  fetch: fetchConfig
-};
-const AgentConfig$1 = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
-  __proto__: null,
-  default: AgentConfig,
-  detectFormat,
-  fetchConfig,
-  normalize,
-  parse,
-  parseTable
-}, Symbol.toStringTag, { value: "Module" }));
 function clearExternalContextDebounce(target) {
   if (target._externalContextDebounceTimer) {
     clearTimeout(target._externalContextDebounceTimer);
@@ -27347,11 +28415,14 @@ const _MinigameTools = class _MinigameTools {
     const name = slotName ?? options["slot"] ?? this._activeSlot ?? "default";
     const slot = this._getSlot(name);
     if (!(slot == null ? void 0 : slot.container)) return false;
+    this._cancelPendingClose(slot);
     const frameOptions = { ...slot.defaultFrameOptions ?? {}, ...options["frameOptions"] ?? {}, ...options };
     delete frameOptions["frameOptions"];
     this._applyFrameOptions(slot, frameOptions);
     this.setSlotForegroundElements(name, options["foregroundElements"], options["foregroundOptions"]);
+    const wasHidden = slot.container.style.display === "none";
     slot.container.style.display = "flex";
+    if (wasHidden) this._animateSlotIn(slot);
     this.setActiveSlot(name);
     const session = this.getLaunchSession(name);
     if (session) {
@@ -27367,6 +28438,7 @@ const _MinigameTools = class _MinigameTools {
     const visible = options.visible !== false;
     const slotName = this._resolveSlot(fnArgs["slot"]);
     const slot = this._getOrCreateSlot(slotName);
+    this._cancelPendingClose(slot);
     const session = this.getLaunchSession(slotName);
     const shouldShow = visible && !((session == null ? void 0 : session.preload) && session.revealed === false);
     const pKey = fnArgs["persistKey"] ?? null;
@@ -27385,6 +28457,7 @@ const _MinigameTools = class _MinigameTools {
     const url = store ? store.getAbsUrl(relativePath) : relativePath;
     (_e = this._log) == null ? void 0 : _e.call(this, `[load_minigame] slot=${slotName}, ${relativePath} → ${url}`);
     const c = slot.container;
+    const wasHidden = c.style.display === "none";
     c.style.left = "50%";
     c.style.top = "50%";
     c.style.right = "";
@@ -27394,6 +28467,7 @@ const _MinigameTools = class _MinigameTools {
     slot.title.textContent = "🎮 " + relativePath.split("/").pop();
     if (slot.defaultFrameOptions) this._applyFrameOptions(slot, shouldShow ? slot.defaultFrameOptions : this._withoutBackdrop(slot.defaultFrameOptions));
     this._applyFrameOptions(slot, shouldShow ? fnArgs : this._withoutBackdrop(fnArgs));
+    if (shouldShow && wasHidden) this._animateSlotIn(slot);
     this.setActiveSlot(slotName);
     const iframe = slot.iframe;
     const loaded = await new Promise((resolve) => {
@@ -27441,11 +28515,19 @@ iframe已设置但未收到gameLoaded确认，URL: ${url}` : `[小游戏预加
     if (!slot) return;
     const reason = opts.reason ?? "user";
     const wasVisible = ((_a2 = slot.container) == null ? void 0 : _a2.style.display) !== "none";
-    if (slot.container) slot.container.style.display = "none";
-    if (slot.iframe) slot.iframe.src = "";
     slot.persistKey = null;
     this._hideBackdrop(slot);
     this._restoreForegroundElements(slot);
+    const finalize = () => {
+      if (slot.container) {
+        slot.container.style.display = "none";
+        slot.container.style.opacity = "1";
+        slot.container.style.transition = "";
+      }
+      if (slot.iframe) slot.iframe.src = "";
+    };
+    if (wasVisible && reason !== "destroy" && this._slotTransitionEnabled(slot)) this._animateSlotOut(slot, finalize);
+    else finalize();
     if (slotName === this._activeSlot) {
       let fallback = null;
       for (const [name, s] of this._slots) {
@@ -27609,6 +28691,10 @@ iframe已设置但未收到gameLoaded确认，URL: ${url}` : `[小游戏预加
       document.body.appendChild(el);
       slot.backdropEl = el;
     }
+    if (slot.backdropHideTimer) {
+      clearTimeout(slot.backdropHideTimer);
+      slot.backdropHideTimer = null;
+    }
     const zIndex = parseInt(((_a2 = slot.container) == null ? void 0 : _a2.style.zIndex) || String(this.zIndex), 10) - 1;
     slot.backdropEl.style.zIndex = String(zIndex);
     slot.backdropEl.style.background = bg;
@@ -27617,10 +28703,79 @@ iframe已设置但未收到gameLoaded确认，URL: ${url}` : `[小游戏预加
     slot.backdropEl.style.opacity = "1";
   }
   _hideBackdrop(slot) {
-    if (slot.backdropEl) {
-      slot.backdropEl.style.opacity = "0";
-      slot.backdropEl.style.display = "none";
+    const el = slot.backdropEl;
+    if (!el) return;
+    if (slot.backdropHideTimer) {
+      clearTimeout(slot.backdropHideTimer);
+      slot.backdropHideTimer = null;
+    }
+    el.style.opacity = "0";
+    slot.backdropHideTimer = setTimeout(() => {
+      slot.backdropHideTimer = null;
+      if (el.style.opacity === "0") el.style.display = "none";
+    }, 220);
+  }
+  /** slot 是否启用显隐过渡动画（frameOptions.transition，默认启用）。 */
+  _slotTransitionEnabled(slot) {
+    var _a2;
+    return ((_a2 = slot.defaultFrameOptions) == null ? void 0 : _a2.transition) !== false;
+  }
+  /** 取消尚未完成的关闭淡出收尾（重新打开 slot 时调用）。 */
+  _cancelPendingClose(slot) {
+    if (slot.closeTimer) {
+      clearTimeout(slot.closeTimer);
+      slot.closeTimer = null;
+    }
+    if (slot.container) {
+      slot.container.style.transition = "";
+      slot.container.style.opacity = "1";
+    }
+  }
+  /**
+   * 弹窗淡入：opacity 0→1 + 轻微 scale 放大。动画结束后移除 transition，
+   * 避免影响后续拖拽（拖拽直接改 left/top/transform）。
+   */
+  _animateSlotIn(slot) {
+    const c = slot.container;
+    if (!c) return;
+    this._cancelPendingClose(slot);
+    if (!this._slotTransitionEnabled(slot)) {
+      c.style.opacity = "1";
+      return;
+    }
+    const baseTransform = c.style.transform || "none";
+    const enterTransform = baseTransform === "none" ? "scale(0.96)" : `${baseTransform} scale(0.96)`;
+    c.style.transition = "none";
+    c.style.opacity = "0";
+    c.style.transform = enterTransform;
+    void c.offsetWidth;
+    c.style.transition = "opacity 0.28s ease, transform 0.28s ease";
+    c.style.opacity = "1";
+    c.style.transform = baseTransform;
+    setTimeout(() => {
+      if (c.style.opacity === "1") {
+        c.style.transition = "";
+      }
+    }, 320);
+  }
+  /** 弹窗淡出；done 在动画结束后调用（负责 display:none 与清理）。 */
+  _animateSlotOut(slot, done) {
+    const c = slot.container;
+    if (!c) {
+      done();
+      return;
     }
+    const baseTransform = c.style.transform || "none";
+    const exitTransform = baseTransform === "none" ? "scale(0.96)" : `${baseTransform} scale(0.96)`;
+    c.style.transition = "opacity 0.24s ease, transform 0.24s ease";
+    void c.offsetWidth;
+    c.style.opacity = "0";
+    c.style.transform = exitTransform;
+    slot.closeTimer = setTimeout(() => {
+      slot.closeTimer = null;
+      c.style.transform = baseTransform;
+      done();
+    }, 260);
   }
   _normalizeForegroundElements(elements) {
     const source = Array.isArray(elements) ? elements : elements ? [elements] : [];
@@ -28641,13 +29796,16 @@ const _DigitalHuman = class _DigitalHuman {
    * @param {HTMLElement} [options.container] - Container element for avatar rendering
    * @param {Object} [options.config] - Initial configuration
    */
-  constructor({ sdk, container, config, subtitle } = {}) {
+  constructor({ sdk, container, config, subtitle, localRTC } = {}) {
     var _a2, _b2;
     if (!sdk) throw new Error("DigitalHuman requires a KeepworkSDK instance");
     this.sdk = sdk;
     this.container = container || null;
     this.config = config || {};
     this._subtitleOverlay = new DigitalHumanSubtitleOverlay(this, subtitle ?? this.config.subtitle);
+    this._localRTCConfig = localRTC ?? this.config.localRTC ?? void 0;
+    this._localRTCController = null;
+    this._localRTCHooks = null;
     EventEmitterMixin$1._initEvents.call(this);
     this._avatarRoot = null;
     this._videoIdle = null;
@@ -28916,6 +30074,93 @@ const _DigitalHuman = class _DigitalHuman {
   showSubtitle(text, options = {}) {
     this._subtitleOverlay.updateAssistant(text, { definite: true, paragraph: true, ...options });
   }
+  // ========================================================================
+  // Local RTC (sherpa-onnx KWS + local ASR + cloud TTS) — host-level API
+  // ========================================================================
+  /**
+   * 内部：确保 LocalRTCController 已构造（host 用本 DigitalHuman 实例的注入接口）。
+   * @returns {LocalRTCController|null}
+   */
+  _ensureLocalRTCController() {
+    if (this._localRTCController) return this._localRTCController;
+    if (!this._localRTCConfig) return null;
+    const self = this;
+    this._localRTCController = new LocalRTCController({
+      host: {
+        send: (text, opts) => self.send(text, opts),
+        sendMessage: (text, opts) => self.sendMessage(text, opts),
+        cancelSend: (reason) => self.cancelSend(reason),
+        updateVoiceChat: (command, opts) => {
+          var _a2;
+          return (_a2 = self.updateVoiceChat) == null ? void 0 : _a2.call(self, command, opts);
+        },
+        startVoiceChat: (preset) => {
+          var _a2;
+          return (_a2 = self.startVoiceChat) == null ? void 0 : _a2.call(self, preset);
+        },
+        stopVoiceChat: () => {
+          var _a2;
+          return (_a2 = self.stopVoiceChat) == null ? void 0 : _a2.call(self);
+        },
+        on: (event, handler) => self.on(event, handler),
+        off: (event, handler) => self.off(event, handler)
+      },
+      config: this._localRTCConfig,
+      hooks: this._localRTCHooks || {}
+    });
+    return this._localRTCController;
+  }
+  /** 获取 LocalRTCController 实例（高级用法 / 调试）。 */
+  getLocalRTCController() {
+    return this._localRTCController;
+  }
+  /** 设置/更新本地 RTC 配置；若已有控制器则同步配置。 */
+  setLocalRTCConfig(config) {
+    this._localRTCConfig = config;
+    if (this._localRTCController) this._localRTCController.config = config || {};
+  }
+  /** 读取当前本地 RTC 配置。 */
+  getLocalRTCConfig() {
+    return this._localRTCConfig;
+  }
+  /**
+   * 注入业务钩子（onUserSpeech 字幕、onStatus、isLocalAsrEnabled、onToggleVoiceChat、onLoadProgress）。
+   * 控制器已构造时同步合并，未构造时缓存待构造时使用。
+   */
+  setLocalRTCHooks(hooks) {
+    this._localRTCHooks = { ...this._localRTCHooks || {}, ...hooks || {} };
+    if (this._localRTCController) this._localRTCController.hooks = this._localRTCHooks;
+  }
+  /** 便捷：注册本地 ASR 识别到用户说话的回调。 */
+  onLocalUserSpeech(cb) {
+    this.setLocalRTCHooks({ onUserSpeech: cb });
+  }
+  /** 本地 ASR 语音会话是否活跃。 */
+  isLocalVoiceActive() {
+    var _a2;
+    return !!((_a2 = this._localRTCController) == null ? void 0 : _a2.isLocalVcActive());
+  }
+  /** 启动本地 ASR 语音会话（ASR → LLM → 云端 TTS）。 */
+  async enableLocalVoice(opts) {
+    const ctrl = this._ensureLocalRTCController();
+    if (!ctrl) return false;
+    return ctrl.enableLocalAsr(opts);
+  }
+  /** 结束本地 ASR 语音会话。 */
+  async disableLocalVoice(opts) {
+    if (!this._localRTCController) return;
+    return this._localRTCController.disableLocalAsr(opts);
+  }
+  /** 重启 WASM KWS 回到待唤醒。 */
+  async resumeLocalKws() {
+    if (!this._localRTCController) return false;
+    return this._localRTCController.resumeKws();
+  }
+  /** 云端启动前释放麦克风（停 WASM KWS）。 */
+  async releaseLocalMicForCloud() {
+    if (!this._localRTCController) return;
+    return this._localRTCController.releaseMicForCloud();
+  }
   _getAudioEngine() {
     var _a2;
     return ((_a2 = this.sdk) == null ? void 0 : _a2.audioEngine) || AudioEngine.getShared();
@@ -32477,6 +33722,7 @@ You only need to play idle animation if you are looping in indefinite loop of an
    * @returns {Promise<Object>} { session, config, bootResponse? }
    */
   async initFromConfig(config = {}) {
+    var _a2;
     this.characterConfig = config;
     if (Object.prototype.hasOwnProperty.call(config, "subtitle")) {
       this.setSubtitleConfig(config.subtitle);
@@ -32507,6 +33753,19 @@ You only need to play idle animation if you are looping in indefinite loop of an
     if (config.pageRouters) {
       this._pageRouters = config.pageRouters;
     }
+    if (Object.prototype.hasOwnProperty.call(config, "localRTC")) {
+      this._localRTCConfig = config.localRTC;
+    }
+    if (this._localRTCConfig && this._localRTCConfig.enabled !== false) {
+      try {
+        this._ensureLocalRTCController();
+        void ((_a2 = this._localRTCController) == null ? void 0 : _a2.preload().catch((e) => {
+          console$4.warn("[DigitalHuman] LocalRTC preload failed:", e);
+        }));
+      } catch (e) {
+        console$4.warn("[DigitalHuman] LocalRTC init failed:", e);
+      }
+    }
     return { session, config };
   }
   // ========================================================================
@@ -34769,6 +36028,13 @@ ${turn.Content}`;
     this._clearVoiceIdleTimer();
     this._clearVoiceLifecycleHandlers();
     this._subtitleOverlay.destroy();
+    if (this._localRTCController) {
+      try {
+        await this._localRTCController.destroy();
+      } catch (e) {
+      }
+      this._localRTCController = null;
+    }
     if ((_a2 = this._vcSession) == null ? void 0 : _a2.isActive) {
       try {
         await this._vcSession.stop();
@@ -35086,7 +36352,7 @@ class DigitalHumanFrame {
    * @param {string} [options.sdkSrc] - URL to keepworkSDK.iife.js
    * @param {boolean} [options.useLocalSdk] - Set to true if sdkSrc is a local ES module instead of IIFE bundle
    */
-  constructor({ sdk, container, sdkSrc, useLocalSdk, useExternalHtml, workspace, proxyCategories, subtitle } = {}) {
+  constructor({ sdk, container, sdkSrc, useLocalSdk, useExternalHtml, workspace, proxyCategories, subtitle, localRTC } = {}) {
     __publicField(this, "sdk");
     __publicField(this, "container");
     __publicField(this, "workspace");
@@ -35104,6 +36370,9 @@ class DigitalHumanFrame {
     this.sdk = sdk;
     this.container = container;
     this.workspace = workspace;
+    this.localRTCConfig = localRTC;
+    this._localRTCController = null;
+    this._localRTCHooks = null;
     this._useLocalSdk = useLocalSdk !== void 0 ? !!useLocalSdk : !!sdk.constructor.sourceIsModule;
     this._useExternalHtml = !!useExternalHtml;
     this._proxyCategories = proxyCategories || null;
@@ -35891,9 +37160,15 @@ class DigitalHumanFrame {
     }
   }
   async initFromConfig(config = {}) {
+    var _a2;
     if (this.subtitleConfig !== void 0 && !Object.prototype.hasOwnProperty.call(config, "subtitle")) {
       config = { ...config, subtitle: this.subtitleConfig };
     }
+    if (Object.prototype.hasOwnProperty.call(config, "localRTC")) {
+      if (this.localRTCConfig === void 0) this.localRTCConfig = config.localRTC;
+      const { localRTC: _stripped, ...rest } = config;
+      config = rest;
+    }
     await this._prepareConfigForIframe(config);
     this.characterConfig = config;
     const frameState = extractDigitalHumanFrameState(config);
@@ -35906,6 +37181,16 @@ class DigitalHumanFrame {
     this.subtitleConfig = frameState.subtitleConfig;
     if (frameState.avatarOnlyMode) this.avatarOnlyMode = true;
     const res = await this._rpc(MSG.INIT_FROM_CONFIG, { config });
+    if (this.localRTCConfig && this.localRTCConfig.enabled !== false) {
+      try {
+        this._ensureLocalRTCController();
+        void ((_a2 = this._localRTCController) == null ? void 0 : _a2.preload().catch((e) => {
+          console$3.warn("[DigitalHumanFrame] LocalRTC preload failed:", e);
+        }));
+      } catch (e) {
+        console$3.warn("[DigitalHumanFrame] LocalRTC init failed:", e);
+      }
+    }
     return {
       session: this._proxySession,
       config: res.config,
@@ -36106,6 +37391,80 @@ class DigitalHumanFrame {
     const result = await this._rpc(MSG.GET_SUBTITLE_CONFIG);
     return (result == null ? void 0 : result.config) || null;
   }
+  // ========================================================================
+  // Local RTC (sherpa-onnx KWS + local ASR + cloud TTS) — host-level API
+  // 控制器在父窗口，host 用本 DHF 实例（镜像 sendMessage/cancelSend/updateVoiceChat，
+  // 并转发内层 textSpeech 事件）。
+  // ========================================================================
+  /** 内部：确保父窗口 LocalRTCController 已构造。 */
+  _ensureLocalRTCController() {
+    if (this._localRTCController) return this._localRTCController;
+    if (!this.localRTCConfig) return null;
+    const self = this;
+    this._localRTCController = new LocalRTCController({
+      host: {
+        send: (text, opts) => self.send(text, opts),
+        sendMessage: (text, opts) => self.sendMessage(text, opts),
+        cancelSend: (reason) => self.cancelSend(reason),
+        updateVoiceChat: (command, opts) => self.updateVoiceChat(command, opts || {}),
+        startVoiceChat: (preset) => self.startVoiceChat(preset || {}),
+        stopVoiceChat: () => self.stopVoiceChat(),
+        on: (event, handler) => self.on(event, handler),
+        off: (event, handler) => self.off(event, handler)
+      },
+      config: this.localRTCConfig,
+      hooks: this._localRTCHooks || {}
+    });
+    return this._localRTCController;
+  }
+  /** 获取父窗口 LocalRTCController 实例（高级用法 / 调试）。 */
+  getLocalRTCController() {
+    return this._localRTCController;
+  }
+  /** 设置/更新本地 RTC 配置；若已有控制器则同步配置。 */
+  setLocalRTCConfig(config) {
+    this.localRTCConfig = config;
+    if (this._localRTCController) this._localRTCController.config = config || {};
+  }
+  /** 读取当前本地 RTC 配置。 */
+  getLocalRTCConfig() {
+    return this.localRTCConfig;
+  }
+  /** 注入业务钩子（onUserSpeech 字幕、onStatus、isLocalAsrEnabled、onToggleVoiceChat、onLoadProgress）。 */
+  setLocalRTCHooks(hooks) {
+    this._localRTCHooks = { ...this._localRTCHooks || {}, ...hooks || {} };
+    if (this._localRTCController) this._localRTCController.hooks = this._localRTCHooks;
+  }
+  /** 便捷：注册本地 ASR 识别到用户说话的回调。 */
+  onLocalUserSpeech(cb) {
+    this.setLocalRTCHooks({ onUserSpeech: cb });
+  }
+  /** 本地 ASR 语音会话是否活跃。 */
+  isLocalVoiceActive() {
+    var _a2;
+    return !!((_a2 = this._localRTCController) == null ? void 0 : _a2.isLocalVcActive());
+  }
+  /** 启动本地 ASR 语音会话（ASR → LLM → 云端 TTS）。 */
+  async enableLocalVoice(opts) {
+    const ctrl = this._ensureLocalRTCController();
+    if (!ctrl) return false;
+    return ctrl.enableLocalAsr(opts);
+  }
+  /** 结束本地 ASR 语音会话。 */
+  async disableLocalVoice(opts) {
+    if (!this._localRTCController) return;
+    return this._localRTCController.disableLocalAsr(opts);
+  }
+  /** 重启 WASM KWS 回到待唤醒。 */
+  async resumeLocalKws() {
+    if (!this._localRTCController) return false;
+    return this._localRTCController.resumeKws();
+  }
+  /** 云端启动前释放麦克风（停 WASM KWS）。 */
+  async releaseLocalMicForCloud() {
+    if (!this._localRTCController) return;
+    return this._localRTCController.releaseMicForCloud();
+  }
   async clearSubtitle(options = {}) {
     return this._rpc(MSG.CLEAR_SUBTITLE, { options });
   }
@@ -36363,6 +37722,13 @@ class DigitalHumanFrame {
       this._authStateUnsubscribe();
       this._authStateUnsubscribe = null;
     }
+    if (this._localRTCController) {
+      try {
+        await this._localRTCController.destroy();
+      } catch (_) {
+      }
+      this._localRTCController = null;
+    }
     await this._tearDownIframe("DigitalHumanFrame destroyed");
     window.removeEventListener("message", this._onMessage);
     clearExternalContextDebounce(this);
@@ -38158,6 +39524,8 @@ if (typeof window !== "undefined") {
   window.AIChat = AIChat;
   window.AIChatRTC = AIChatRTC$1;
   window.AIChatRTCLocal = AIChatRTCLocal;
+  window.LocalRTC = LocalRTC;
+  window.LocalRTCController = LocalRTCController;
   window.SpeechRTC = SpeechRTC;
   window.DigitalHuman = DigitalHuman;
   window.DigitalHumanFrame = DigitalHumanFrame;
@@ -38186,6 +39554,8 @@ export {
   DigitalHumanFrame,
   KeepworkSDK,
   LocalAPIKeySettings,
+  LocalRTC,
+  LocalRTCController,
   LocalStorageUtil,
   LoginWindow,
   MinigameTools,