keepwork-sdk 1.0.0 → 1.0.2

package/dist-npm/keepwork-sdk.js

@@ -887,7 +887,7 @@ if (typeof window !== "undefined") {
   window.LocalStorageUtil = LocalStorageUtil;
   window.StorageUtil = StorageUtil;
 }
-const console$o = SDKLogger.createModuleConsole("PersonalPageStore");
+const console$p = SDKLogger.createModuleConsole("PersonalPageStore");
 class PersonalPageStoreBase {
   constructor(sdk) {
     // ──────────────────── 字段 ────────────────────
@@ -970,7 +970,7 @@ class PersonalPageStoreBase {
       try {
         handler(...args);
       } catch (e) {
-        console$o.warn(`PersonalPageStore: listener for '${event}' threw:`, e);
+        console$p.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$o.warn("PersonalPageStore: mountedFolder path requires at least username/workspace");
+        console$p.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$o.warn("PersonalPageStore: mountedFolder object requires username and workspace");
+        console$p.warn("PersonalPageStore: mountedFolder object requires username and workspace");
         return null;
       }
       return {
@@ -1107,7 +1107,7 @@ class PersonalPageStoreBase {
         remoteStorePath: m["remoteStorePath"] ?? this.remoteStorePath
       };
     }
-    console$o.warn("PersonalPageStore: mountedFolder must be a path string, object, or null");
+    console$p.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$o.log(`[PersonalPageStore] Updated search path: ${normalizedPrefix} -> ${normalizedBaseUrl} (readonly=${isReadonly})`);
+      console$p.log(`[PersonalPageStore] Updated search path: ${normalizedPrefix} -> ${normalizedBaseUrl} (readonly=${isReadonly})`);
     } else {
       this._searchPaths.push({ prefix: normalizedPrefix, baseUrl: normalizedBaseUrl, isReadonly });
-      console$o.log(`[PersonalPageStore] Added search path: ${normalizedPrefix} -> ${normalizedBaseUrl} (readonly=${isReadonly})`);
+      console$p.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$o.log(`[PersonalPageStore] SearchPath found: ${effectiveName} -> ${fileUrl}`);
+          console$p.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$o.log(`[PersonalPageStore] SearchPath not found: ${effectiveName}`);
+    console$p.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$o.log(`PersonalPageStore: Override username set to: ${this.overrideUsername ?? "current user"}`);
+    console$p.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$o.log("personalPageStore: No token set, using anonymous mode");
+        console$p.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$n = SDKLogger.createModuleConsole("Speech");
+const console$o = 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$n.warn(`Invalid fallbackMode "${mode}", expected one of: ${valid.join(", ")}`);
+      console$o.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$n.warn("当前浏览器不支持 OfflineAudioContext，返回原始采样率音频");
+      console$o.warn("当前浏览器不支持 OfflineAudioContext，返回原始采样率音频");
       return audioBuffer;
     }
     const frameCount = Math.max(1, Math.ceil(audioBuffer.duration * nextSampleRate));
@@ -5013,7 +5013,7 @@ class Speech {
         }
       });
     } catch (error) {
-      console$n.error("停止音频播放时发生错误:", error);
+      console$o.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$n.error("Error playing YouDao audio:", err));
+        if (p) p.catch((err) => console$o.error("Error playing YouDao audio:", err));
       }));
     } catch (e) {
-      console$n.error("Error with YouDao API:", e);
+      console$o.error("Error with YouDao API:", e);
     }
   }
   // ──────────────────── 语音转文字（STT）────────────────────
@@ -5058,10 +5058,10 @@ class Speech {
       maxDuration: 60,
       sampleRate: 16e3,
       format: "wav",
-      onStart: () => console$n.log("录音开始"),
-      onStop: () => console$n.log("录音停止"),
-      onError: (e) => console$n.error("录音错误:", e),
-      onResult: (r) => console$n.log("识别结果:", r),
+      onStart: () => console$o.log("录音开始"),
+      onStop: () => console$o.log("录音停止"),
+      onError: (e) => console$o.error("录音错误:", e),
+      onResult: (r) => console$o.log("识别结果:", r),
       ...options
     };
     if (!((_a2 = navigator.mediaDevices) == null ? void 0 : _a2.getUserMedia)) throw new Error("当前浏览器不支持录音功能，请使用现代浏览器并确保在HTTPS环境下访问");
@@ -5295,7 +5295,7 @@ class Speech {
     });
   }
 }
-const console$m = SDKLogger.createModuleConsole("MqttManager");
+const console$n = SDKLogger.createModuleConsole("MqttManager");
 class MqttManager {
   constructor() {
     __publicField(this, "client", null);
@@ -5367,11 +5367,11 @@ class MqttManager {
           }
         }
       } catch (e) {
-        console$m.error("Failed to load MQTT config from storage:", e);
+        console$n.error("Failed to load MQTT config from storage:", e);
       }
     }
     if (!effectiveConfig) {
-      console$m.error("MQTT connect: No config provided and no stored config");
+      console$n.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$m.error("Failed to load MQTT library:", e);
+      console$n.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$m.log("Connecting to MQTT with options:", connectOptions);
+    console$n.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$m.error("MQTT Error:", err);
+        console$n.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$m.log(`MQTT Reconnecting... (${this.retryCount}/${this.maxRetries})`);
+        console$n.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$m.error("MQTT Connection Exception:", e);
+      console$n.error("MQTT Connection Exception:", e);
       this.status = "error";
       this.emit("statusChange", this.status);
     }
   }
   /** @private 连接成功回调。 */
   OnConnect() {
-    console$m.log("MQTT Connected");
+    console$n.log("MQTT Connected");
     this.status = "connected";
     this.retryCount = 0;
     this.emit("statusChange", this.status);
   }
   /** @private 连接关闭回调。 */
   OnClose() {
-    console$m.log("MQTT Closed");
+    console$n.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$m.log(`message ${msgStr}
+    console$n.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$m.log(`Subscribed to ${topic}`);
+        if (!err) console$n.log(`Subscribed to ${topic}`);
       });
     }
   }
@@ -6282,7 +6282,7 @@ class SandboxToolEnv {
     });
   }
 }
-const console$l = SDKLogger.createModuleConsole("AgentTool");
+const console$m = 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$l.log(`[CopilotTools] runAsyncAgentTask session='${session.name ?? "root"}' target='${resolvedAgentName}' callbackMode=${callbackMode ?? "delay"} task=${this.summarizeDebugValue(task)}`);
+      console$m.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$l.log(`[CopilotTools] runAsyncAgentTask ${label} expanded via sandbox: ${this.summarizeDebugValue(expanded)}`);
+      console$m.log(`[CopilotTools] runAsyncAgentTask ${label} expanded via sandbox: ${this.summarizeDebugValue(expanded)}`);
       return expanded;
     } catch (e) {
       if (e && e["isRestartAgentSignal"]) throw e;
-      console$l.warn(`[CopilotTools] runAsyncAgentTask: ${label} template expansion failed. Error: ${e.message}`);
+      console$m.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$l.error(`[CopilotTools] ${targetLabel}.sendMessage failed:`, e);
+        console$m.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$l.error(`[CopilotTools] ${targetLabel}.sendMessage failed:`, e2);
+        console$m.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$k = SDKLogger.createModuleConsole("PersonalPageTool");
+const console$l = SDKLogger.createModuleConsole("PersonalPageTool");
 class PersonalPageTool {
   constructor(sdk) {
     __publicField(this, "sdk");
@@ -6630,19 +6630,19 @@ class PersonalPageTool {
     }
     if (name === "personal_page_load") {
       try {
-        console$k.log(`[PersonalPageTool] Loading data from file '${filePageName}', key '${storageKey}'`);
+        console$l.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$k.error("[PersonalPageTool] Load failed:", e);
+        console$l.error("[PersonalPageTool] Load failed:", e);
         return `Failed to load data: ${e.message}`;
       }
     }
     if (name === "personal_page_save") {
       const { data, bForceFlush } = args;
       try {
-        console$k.log(`[PersonalPageTool] Saving data to file '${filePageName}', key '${storageKey}'`, data);
+        console$l.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$k.error("[PersonalPageTool] Save failed:", e);
+        console$l.error("[PersonalPageTool] Save failed:", e);
         return `Failed to save data: ${e.message}`;
       }
     }
@@ -6712,7 +6712,7 @@ __publicField(PersonalPageTool, "definitions", [
     }
   }
 ]);
-const console$j = SDKLogger.createModuleConsole("ExecuteTool");
+const console$k = 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$j;
+      const originalConsole = console$k;
       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$i = SDKLogger.createModuleConsole("AIChat");
+const console$j = 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$i.warn("Failed to get token from localStorage:", e);
+        console$j.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$i.log("[AIChat] _restartSignal detected, aborting tool loop");
+          console$j.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$i.error("Tool call execution failed:", error);
+          console$j.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$i.log("[AIChat] _restartSignal detected, aborting chat recursion");
+        console$j.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$h = SDKLogger.createModuleConsole("ChildSessionMixin");
+const console$i = 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$h.log(`[ChildSessionMixin] Child agent '${name}' created`);
+    console$i.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$h.log(`[ChildSessionMixin] Merged task into queue for child '${name}'`);
+      console$i.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$h.log(`[ChildSessionMixin] Child '${name}' completed task ${taskObj.id}; pendingChildResults=${this._pendingChildResults.length}; result=${_summarize(result)}`);
+        console$i.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$h.error(`[ChildSessionMixin] Child '${name}' task ${taskObj.id} failed:`, e);
+        console$i.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$h.warn(`[ChildSessionMixin] Child '${name}' failure queued; taskId=${taskObj.id}; pendingChildResults=${this._pendingChildResults.length}; result=${_summarize(errorResult)}`);
+        console$i.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$h.warn("[ChildSessionMixin] onChildStream callback error:", e);
+        console$i.warn("[ChildSessionMixin] onChildStream callback error:", e);
       }
     }
   },
@@ -8435,7 +8435,7 @@ const childSessionMethods = {
     const results = this._pendingChildResults;
     this._pendingChildResults = [];
     if (results.length > 0) {
-      console$h.log(
+      console$i.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$h.log(
+    console$i.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$h.warn("[ChildSessionMixin] _triggerImmediateCallback not overridden — child results will accumulate until next send.");
+    console$i.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$h.log(`[ChildSessionMixin] Debounce callback set: ${seconds}s pendingChildResults=${this._pendingChildResults.length}`);
+    console$i.log(`[ChildSessionMixin] Debounce callback set: ${seconds}s pendingChildResults=${this._pendingChildResults.length}`);
   },
   /**
    * 取消所有待处理的 debounce 定时器。
@@ -8535,7 +8535,7 @@ const childSessionMethods = {
     this._pendingChildResults = [];
   }
 };
-const console$g = SDKLogger.createModuleConsole("ImageUtils");
+const console$h = SDKLogger.createModuleConsole("ImageUtils");
 const DEFAULT_MAX_BYTES = 32 * 1024;
 function base64ByteSize(base64) {
   const len = base64.length;
@@ -8578,7 +8578,7 @@ async function compressBase64Image(inputBase64, options = {}) {
     for (const quality of QUALITY_STEPS) {
       const result = canvasToBase64(img, width, height, quality);
       if (result.byteSize <= maxBytes) {
-        console$g.log(
+        console$h.log(
           `[ImageUtils] Compressed image: ${width}x${height} q=${quality} → ${(result.byteSize / 1024).toFixed(1)} KB`
         );
         return result.base64;
@@ -8588,11 +8588,34 @@ async function compressBase64Image(inputBase64, options = {}) {
     height = Math.max(1, Math.floor(height / 2));
   }
   const final = canvasToBase64(img, width, height, 0.2);
-  console$g.warn(
+  console$h.warn(
     `[ImageUtils] Could not compress below ${maxBytes} bytes; final size ${final.byteSize}`
   );
   return final.base64;
 }
+async function compressDataURI(dataURI, options = {}) {
+  const maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;
+  const { mimeType, base64 } = splitDataURI(dataURI);
+  if (base64ByteSize(base64) <= maxBytes) return dataURI;
+  const compressed = await compressBase64Image(base64, { maxBytes, mimeType });
+  return `data:image/jpeg;base64,${compressed}`;
+}
+async function compressContentImages(contentArray, options = {}) {
+  if (!Array.isArray(contentArray)) return contentArray;
+  const maxBytes = options.maxBytes ?? DEFAULT_MAX_BYTES;
+  return Promise.all(
+    contentArray.map(async (item) => {
+      var _a2;
+      if (item.type !== "image_url") return item;
+      const url = (_a2 = item.image_url) == null ? void 0 : _a2.url;
+      if (!url || !url.startsWith("data:")) return item;
+      const { base64 } = splitDataURI(url);
+      if (base64ByteSize(base64) <= maxBytes) return item;
+      const compressedURI = await compressDataURI(url, { maxBytes });
+      return { ...item, image_url: { ...item.image_url, url: compressedURI } };
+    })
+  );
+}
 async function uploadTempVisionImage(base64OrDataURI, options = {}) {
   var _a2, _b2;
   const { sdk, fileName = "image.jpg", maxBytes } = options;
@@ -8635,7 +8658,7 @@ async function uploadTempVisionImage(base64OrDataURI, options = {}) {
       try {
         const headResp = await fetch(cdnUrl, { method: "HEAD" });
         if (headResp.ok) {
-          console$g.log(`[ImageUtils] File already exists at ${cdnUrl}, skipping upload`);
+          console$h.log(`[ImageUtils] File already exists at ${cdnUrl}, skipping upload`);
           return cdnUrl;
         }
       } catch {
@@ -8663,7 +8686,7 @@ async function uploadTempVisionImage(base64OrDataURI, options = {}) {
   if (!uploadResp.ok) {
     throw new Error(`[ImageUtils] Qiniu upload failed: HTTP ${uploadResp.status}`);
   }
-  console$g.log(`[ImageUtils] Uploaded to ${cdnUrl} (${(blob.size / 1024).toFixed(1)} KB)`);
+  console$h.log(`[ImageUtils] Uploaded to ${cdnUrl} (${(blob.size / 1024).toFixed(1)} KB)`);
   return cdnUrl;
 }
 let _cachedMd5 = null;
@@ -8683,6 +8706,542 @@ async function _getMd5() {
   }
   return _cachedMd5;
 }
+const console$g = SDKLogger.createModuleConsole("AIChat");
+class ChatSession {
+  constructor(aiChat, options = {}) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    __publicField(this, "aiChat");
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    __publicField(this, "messages", []);
+    __publicField(this, "chatId");
+    __publicField(this, "modId");
+    __publicField(this, "skipHistory");
+    __publicField(this, "historyId");
+    __publicField(this, "historyRows", null);
+    __publicField(this, "model");
+    __publicField(this, "apiCacheKey");
+    __publicField(this, "historyLength");
+    __publicField(this, "options");
+    __publicField(this, "sandbox");
+    __publicField(this, "_workspaceExplicitlySet");
+    __publicField(this, "workspace");
+    __publicField(this, "mountFolder");
+    __publicField(this, "_pendingContexts", []);
+    __publicField(this, "_restartedWithPromptFile", false);
+    __publicField(this, "_savedMessages");
+    __publicField(this, "_restartSignal");
+    __publicField(this, "_registeredAsAgent", false);
+    __publicField(this, "_defaultSettings");
+    // ChildSessionHost fields (injected by initChildSessionState)
+    __publicField(this, "name");
+    __publicField(this, "parentSession");
+    __publicField(this, "_childSessions");
+    __publicField(this, "_pendingChildResults");
+    __publicField(this, "_debounceTimers");
+    __publicField(this, "_isSending");
+    __publicField(this, "_lastSendOptions");
+    __publicField(this, "_maxChildSessions");
+    __publicField(this, "_depth");
+    __publicField(this, "_maxDepth");
+    __publicField(this, "onChildStream");
+    var _a2, _b2;
+    const normalizedOptions = { ...options };
+    if (normalizedOptions.systemPrompt === void 0 && normalizedOptions.system_prompt !== void 0) {
+      normalizedOptions.systemPrompt = normalizedOptions.system_prompt;
+    }
+    this.aiChat = aiChat;
+    this.messages = [];
+    this.chatId = normalizedOptions.chatId ?? AIChat.generateUUID();
+    let persistedId = normalizedOptions.persistedId;
+    if (!normalizedOptions.modId && !persistedId) {
+      persistedId = Math.floor(1e3 + Math.random() * 9e3).toString();
+    }
+    this.modId = normalizedOptions.modId ?? aiChat._generateModId(persistedId) ?? null;
+    this.skipHistory = !!normalizedOptions.skipHistory;
+    this.historyId = void 0;
+    this.historyRows = null;
+    this.model = normalizedOptions.model ?? "keepwork-flash";
+    this.apiCacheKey = normalizedOptions.apiCacheKey ?? null;
+    this.historyLength = (normalizedOptions.historyLength ?? 0) > 0 ? normalizedOptions.historyLength : 0;
+    this.options = normalizedOptions;
+    if (normalizedOptions.systemPrompt) {
+      this.messages.push({ role: "system", content: normalizedOptions.systemPrompt });
+    }
+    this._workspaceExplicitlySet = normalizedOptions.workspace !== void 0;
+    this.workspace = normalizedOptions.workspace ?? null;
+    this.mountFolder = normalizedOptions.mountFolder ?? null;
+    this._pendingContexts = [];
+    this.sandbox = new SandboxToolEnv(aiChat.sdk, {
+      workspace: this.workspace ?? "",
+      mountFolder: this.mountFolder,
+      enabledCategories: normalizedOptions.enabledCategories ?? ["fileOps", "execute"],
+      toolProxy: normalizedOptions.toolProxy ?? void 0,
+      // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      session: this
+    });
+    Object.defineProperty(this, "sdk", { get: () => this.aiChat.sdk, configurable: true });
+    initChildSessionState(this, normalizedOptions);
+    this._defaultSettings = {
+      model: this.model,
+      historyLength: this.historyLength,
+      workspace: this.workspace,
+      mountFolder: this.mountFolder,
+      systemPrompt: normalizedOptions.systemPrompt ?? null,
+      enabledCategories: normalizedOptions.enabledCategories ?? ["fileOps", "execute"]
+    };
+    this._registeredAsAgent = false;
+    if (this.name && !this.parentSession) {
+      const router = (_a2 = aiChat.sdk) == null ? void 0 : _a2["agentRouter"];
+      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.`);
+        }
+      }
+    }
+  }
+  // ──────────────────── 消息 API ────────────────────
+  /** sdk 访问器（指向 aiChat.sdk） */
+  get sdk() {
+    return this.aiChat.sdk;
+  }
+  /**
+   * 入队后台上下文（将在下一次 send() 时注入到用户消息前）。
+   * 多次调用会累积；下次 send() 时统一冲刷。
+   * @param text - 要注入的上下文文本
+   */
+  sendContext(text) {
+    if (!text) return;
+    this._pendingContexts.push(String(text));
+  }
+  /**
+   * 取消注册 AgentRouter 中的 agent 名称。
+   * 当此 session 不再处理该 agent 任务时调用。
+   */
+  unregisterAgent() {
+    var _a2, _b2;
+    if (this._registeredAsAgent && this.name) {
+      const router = (_a2 = this.aiChat.sdk) == null ? void 0 : _a2["agentRouter"];
+      (_b2 = router == null ? void 0 : router.unregister) == null ? void 0 : _b2.call(router, this.name);
+      this._registeredAsAgent = false;
+    }
+  }
+  /**
+   * 直接通过 sandbox 执行工具（AgentRouter.toolCallOnly 路径使用）。
+   */
+  executeTool(fnName, fnArgs) {
+    return this.sandbox.execute(fnName, fnArgs, { _proxied: true });
+  }
+  /**
+   * 设置文件操作工作空间。
+   * 同步更新 `this.workspace` 和 `this.sandbox.workspace`。
+   * @param wsName - 工作空间名，null/'' 表示清除
+   */
+  setWorkspace(wsName) {
+    const nextWorkspace = wsName || null;
+    const nextSandboxWorkspace = nextWorkspace ?? "";
+    if (this.workspace === nextWorkspace && (!this.sandbox || this.sandbox.workspace === nextSandboxWorkspace)) return;
+    this._workspaceExplicitlySet = true;
+    this.workspace = nextWorkspace;
+    if (this.sandbox) this.sandbox.workspace = nextSandboxWorkspace;
+    console$g.log(`[ChatSession] Workspace set to: ${this.workspace ?? "(none)"}`);
+  }
+  /**
+   * 设置只读回退层的 mountFolder 配置。
+   * @param mountFolderConfig - 挂载文件夹路径/对象，或 null 清除
+   */
+  setMountFolder(mountFolderConfig) {
+    this.mountFolder = mountFolderConfig ?? null;
+    if (this.sandbox) this.sandbox.mountFolder = this.mountFolder;
+    console$g.log(`[ChatSession] MountFolder set to: ${this.mountFolder ?? "(none)"}`);
+  }
+  /** 设置 API 缓存 Key（传递给 aiGenerators.chat）。 */
+  setAPICacheKey(key) {
+    this.apiCacheKey = key;
+  }
+  /**
+   * 向会话历史追加用户消息（自动冲刷 _pendingContexts 并注入到消息前）。
+   * @param content - 消息内容（字符串或多模态数组）
+   */
+  addUserMessage(content) {
+    const contextPrefix = this._flushPendingContexts();
+    let resolvedContent = content;
+    if (contextPrefix && typeof resolvedContent === "string") {
+      resolvedContent = contextPrefix + "\n" + resolvedContent;
+    } else if (contextPrefix && Array.isArray(resolvedContent)) {
+      resolvedContent = [{ type: "text", text: contextPrefix }, ...resolvedContent];
+    }
+    const message = { role: "user", content: resolvedContent, _ts: Date.now() };
+    this.messages.push(message);
+    return message;
+  }
+  /**
+   * 冲刷并返回所有待注入的上下文（包裹在 context_begin…context_end 块中）。
+   * 若无待处理上下文则返回空字符串。
+   * @private
+   */
+  _flushPendingContexts() {
+    var _a2;
+    if (!((_a2 = this._pendingContexts) == null ? void 0 : _a2.length)) return "";
+    const contexts = this._pendingContexts.splice(0);
+    return "(context_begin)\n" + contexts.join("\n") + "\n(context_end)";
+  }
+  /**
+   * 向会话历史追加助手消息。
+   * @param content    - 助手文本内容
+   * @param gptChatId  - 可选的 GPT Chat ID（用于历史关联）
+   */
+  addAssistantMessage(content, gptChatId) {
+    const message = { role: "assistant", content, _ts: Date.now() };
+    if (gptChatId) message.gptChatId = gptChatId;
+    this.messages.push(message);
+  }
+  // ──────────────────── send() ────────────────────
+  /**
+   * 发送消息并更新会话历史（主发送入口）。
+   *
+   * 处理流程：
+   * 1. 取消 debounce 定时器
+   * 2. 若 runCode=true，通过 sandbox.processTemplate 展开 ${...} 表达式
+   * 3. 注入待处理的子 agent 结果（tool call 形式）
+   * 4. 冲刷 _pendingContexts
+   * 5. 压缩 / 上传内联 base64 图片
+   * 6. 添加用户消息，修剪历史
+   * 7. 调用 aiChat.chat()
+   * 8. 追加助手消息，持久化历史
+   *
+   * @param userMessage - 用户消息（字符串、多模态数组，或 null 仅消费子 agent 结果）
+   * @param options     - 发送选项（model / tools / enableTools / 流式回调等）
+   */
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  async send(userMessage, options = {}) {
+    var _a2, _b2, _c, _d;
+    (_a2 = this._cancelDebounceTimers) == null ? void 0 : _a2.call(this);
+    this._isSending = true;
+    const summarizeDebugValue2 = (v) => {
+      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)}`);
+    try {
+      let resolvedUserMessage = userMessage;
+      const effectiveOptions = {
+        ...this.options,
+        ...options,
+        apiCacheKey: this.apiCacheKey
+      };
+      if (this._workspaceExplicitlySet) effectiveOptions.workspace = this.workspace;
+      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)}`);
+      }
+      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"}'`);
+        const toolCalls = childResults.map((cr) => ({
+          id: cr.taskId,
+          type: "function",
+          function: { name: "async_agent_task", arguments: JSON.stringify({ agent: cr.agentName, task: cr.taskSummary }) }
+        }));
+        this.messages.push({ role: "assistant", content: null, tool_calls: toolCalls });
+        for (const cr of childResults) {
+          this.messages.push({
+            role: "tool",
+            tool_call_id: cr.taskId,
+            content: typeof cr.result === "string" ? cr.result : JSON.stringify(cr.result)
+          });
+        }
+      }
+      const contextPrefix = this._flushPendingContexts();
+      if (contextPrefix) {
+        if (resolvedUserMessage == null) resolvedUserMessage = contextPrefix;
+        else if (typeof resolvedUserMessage === "string") resolvedUserMessage = contextPrefix + "\n" + resolvedUserMessage;
+        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"}'`);
+        return "";
+      }
+      if (Array.isArray(resolvedUserMessage)) {
+        const imageConfig = effectiveOptions.imageConfig ?? {};
+        const maxImageBytes = imageConfig.maxImageBytes ?? DEFAULT_MAX_BYTES;
+        resolvedUserMessage = await compressContentImages(resolvedUserMessage, { maxBytes: maxImageBytes });
+        if (imageConfig.autoConvertBase64ToURL !== false) {
+          resolvedUserMessage = await this._uploadInlineImages(resolvedUserMessage);
+        }
+      }
+      let userMessageEntry = null;
+      if (resolvedUserMessage != null) {
+        userMessageEntry = this.addUserMessage(resolvedUserMessage);
+        if (typeof effectiveOptions.onUserMessage === "function") {
+          try {
+            effectiveOptions.onUserMessage(userMessageEntry);
+          } catch (e) {
+            console$g.warn("[ChatSession.send] onUserMessage callback failed:", e);
+          }
+        }
+      }
+      if (this._restartedWithPromptFile) this._restartedWithPromptFile = false;
+      this._evictMessages();
+      if (((_c = effectiveOptions.imageConfig) == null ? void 0 : _c.maxImageHistoryCount) != null) {
+        this._evictExcessImages(effectiveOptions.imageConfig.maxImageHistoryCount);
+      }
+      this._lastSendOptions = effectiveOptions;
+      console$g.log("[ChatSession.send] options:", effectiveOptions);
+      let currentGptChatId;
+      const response = await this.aiChat.chat({
+        ...effectiveOptions,
+        _session: this,
+        messages: this.messages,
+        onComplete: (result, fullResponse) => {
+          var _a3, _b3;
+          const fr = fullResponse;
+          if (fr == null ? void 0 : fr["headers"]) {
+            currentGptChatId = (_a3 = fr["headers"]) == null ? void 0 : _a3["x-gpt-chat-id"];
+          }
+          (_b3 = effectiveOptions.onComplete) == null ? void 0 : _b3.call(effectiveOptions, result, fullResponse);
+        }
+      });
+      const assistantContent = typeof response === "string" ? response : (response == null ? void 0 : response["result"]) ?? null;
+      this.addAssistantMessage(assistantContent, currentGptChatId);
+      try {
+        const sdkRef = this.aiChat.sdk;
+        if (!this.skipHistory && this.chatId && this.modId && ((_d = sdkRef == null ? void 0 : sdkRef.token) == null ? void 0 : _d.trim())) {
+          const usedModel = options.model ?? this.model;
+          if (this.historyId) {
+            await this.aiChat.updateChatHistory(this.historyId, {
+              id: this.historyId,
+              chatId: this.chatId,
+              modId: this.modId,
+              model: usedModel,
+              messages: this.messages
+            });
+          } else {
+            await this.aiChat.upsertChatHistory({
+              title: typeof resolvedUserMessage === "string" ? resolvedUserMessage.substring(0, 50) : "",
+              chatId: this.chatId,
+              modId: this.modId,
+              model: usedModel,
+              messages: this.messages
+            });
+            if (this.historyRows === null) this.historyRows = [];
+          }
+          try {
+            const historyRes = await this.aiChat.getChatHistory(this.modId);
+            if (historyRes == null ? void 0 : historyRes.rows) {
+              this.historyRows = historyRes.rows;
+              const history = historyRes.rows.find((h) => h.chatId === this.chatId);
+              if (history) this.historyId = history.id;
+            }
+          } catch (e) {
+            console$g.warn("Failed to fetch chat history", e);
+          }
+        }
+      } catch (e) {
+        console$g.error("Failed to save chat history", e);
+      }
+      return response;
+    } finally {
+      this._isSending = false;
+    }
+  }
+  // ──────────────────── 图片处理 ────────────────────
+  /**
+   * 将多模态 content 数组中的内联 base64 图片上传到临时 CDN，
+   * 并将 data-URI 替换为远程 URL。
+   * @private
+   */
+  async _uploadInlineImages(contentArray) {
+    if (!Array.isArray(contentArray)) return contentArray;
+    return Promise.all(
+      contentArray.map(async (item) => {
+        var _a2;
+        if (item.type !== "image_url") return item;
+        const url = (_a2 = item.image_url) == null ? void 0 : _a2.url;
+        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);
+          return { ...item, image_url: { ...item.image_url, url: cdnUrl } };
+        } catch (e) {
+          console$g.warn("[ChatSession] Failed to upload inline image, keeping data-URI:", e);
+          return item;
+        }
+      })
+    );
+  }
+  // ──────────────────── 消息修剪 ────────────────────
+  /**
+   * 按 historyLength 修剪旧消息轮次。
+   * 保留所有前置 system 消息 + 最后 `historyLength` 轮对话。
+   * @private
+   */
+  _evictMessages() {
+    const limit = this.historyLength;
+    if (!limit || limit <= 0) return;
+    let systemEnd = 0;
+    while (systemEnd < this.messages.length && this.messages[systemEnd].role === "system") systemEnd++;
+    const roundStarts = [];
+    for (let i = systemEnd; i < this.messages.length; i++) {
+      if (this.messages[i].role === "user") roundStarts.push(i);
+    }
+    if (roundStarts.length <= limit) return;
+    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)`);
+  }
+  /**
+   * 从历史中移除超出 maxCount 限制的旧图片，
+   * 将被移除的 image_url 替换为 `(user_image)` 文本占位符。
+   * @private
+   */
+  _evictExcessImages(maxCount) {
+    var _a2;
+    if (maxCount < 0) return;
+    const positions = [];
+    for (let i = 0; i < this.messages.length; i++) {
+      const msg = this.messages[i];
+      if (msg.role !== "user" || !Array.isArray(msg.content)) continue;
+      for (let j = 0; j < msg.content.length; j++) {
+        if (((_a2 = msg.content[j]) == null ? void 0 : _a2["type"]) === "image_url") {
+          positions.push({ msgIdx: i, partIdx: j });
+        }
+      }
+    }
+    if (positions.length <= maxCount) return;
+    const toRemove = positions.slice(0, positions.length - maxCount);
+    let removedCount = 0;
+    for (const { msgIdx, partIdx } of toRemove) {
+      const msg = this.messages[msgIdx];
+      msg.content[partIdx] = { type: "text", text: "(user_image)" };
+      removedCount++;
+    }
+    if (removedCount > 0) console$g.log(`[ChatSession] Evicted ${removedCount} image(s) from history, kept ${maxCount}`);
+  }
+  // ──────────────────── 历史管理 ────────────────────
+  /** 清空对话历史（仅清空 messages 数组）。 */
+  clear() {
+    this.messages = [];
+  }
+  /** 获取当前对话历史的副本。 */
+  getHistory() {
+    return [...this.messages];
+  }
+  // ──────────────────── restartAgent ────────────────────
+  /**
+   * 重启 agent 会话（可选加载配置文件）。
+   *
+   * 行为：
+   * - 无 promptFile：恢复所有设置到构造时的默认值
+   * - 纯 Markdown（只有 system_prompt）：仅更换系统提示，其他设置保持默认
+   * - 完整配置：临时覆盖设置；下次无 promptFile 的重启会恢复全部默认值
+   *
+   * @param promptFile - 配置文件 URL 或路径（.json / .yml / .yaml / .md）
+   * @param tools      - 可选工具分类覆盖（空表示继承默认值）
+   * @param _options   - 高级选项（预留）
+   * @returns `{ configSource }`
+   */
+  async restartAgent(promptFile, tools, _options) {
+    var _a2, _b2, _c, _d, _e, _f;
+    console$g.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);
+    const defaults = this._defaultSettings;
+    this.model = defaults.model ?? "keepwork-flash";
+    this.historyLength = defaults.historyLength ?? 0;
+    if (defaults.workspace !== void 0) this.setWorkspace(defaults.workspace);
+    if (defaults.mountFolder !== void 0) this.setMountFolder(defaults.mountFolder);
+    if (this.sandbox && defaults.enabledCategories) {
+      (_b2 = (_a2 = this.sandbox).setEnabledCategories) == null ? void 0 : _b2.call(_a2, defaults.enabledCategories);
+    }
+    let loadedConfig = null;
+    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());
+      } catch (e) {
+        console$g.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`);
+    } else if (!hasPromptFile && this._savedMessages) {
+      console$g.log(`[ChatSession] restartAgent: keeping ${this._savedMessages.length} saved history messages for summarizer`);
+    }
+    this.messages = [];
+    if (systemPrompt) this.messages.push({ role: "system", content: systemPrompt });
+    if (!hasPromptFile && this._savedMessages) this._savedMessages = null;
+    if (loadedConfig) {
+      if (loadedConfig["model"]) this.model = loadedConfig["model"];
+      if (loadedConfig["historyLength"] !== void 0) this.historyLength = loadedConfig["historyLength"];
+      if (loadedConfig["workspace"]) this.setWorkspace(loadedConfig["workspace"]);
+      if (loadedConfig["mountFolder"]) this.setMountFolder(loadedConfig["mountFolder"]);
+      if (loadedConfig["tools"] && this.sandbox) {
+        const cats = loadedConfig["tools"];
+        const enabledCategories = Object.keys(cats).filter((k) => {
+          var _a3;
+          return ((_a3 = cats[k]) == null ? void 0 : _a3.enabled) !== false;
+        });
+        if (enabledCategories.length > 0) {
+          (_d = (_c = this.sandbox).setEnabledCategories) == null ? void 0 : _d.call(_c, enabledCategories);
+        }
+      }
+    }
+    if (this.sandbox && normalizedTools.length > 0) {
+      (_f = (_e = this.sandbox).setEnabledCategories) == null ? void 0 : _f.call(_e, normalizedTools);
+    }
+    this._pendingContexts = [];
+    this._restartedWithPromptFile = hasPromptFile && !!loadedConfig;
+    if (this.sandbox) {
+      this.sandbox._activePromptFile = promptFile ?? null;
+      this.sandbox._templateSourceFile = promptFile ?? null;
+    }
+    return { configSource: loadedConfig ? promptFile ?? "unknown" : "default" };
+  }
+  // ChildSessionHost 必须实现的方法占位（由 mixin 注入）
+  _triggerImmediateCallback() {
+    return Promise.resolve();
+  }
+}
+function installAIChatSessionFactory() {
+  Object.assign(ChatSession.prototype, childSessionMethods);
+  Object.assign(ChatSession.prototype, {
+    async _triggerImmediateCallback() {
+      console$g.log(
+        `[ChatSession] _triggerImmediateCallback session='${this.name ?? "root"}' pendingChildResults=${this._pendingChildResults.length} isSending=${this._isSending}`
+      );
+      if (this._isSending) {
+        await new Promise((resolve) => {
+          const check = () => {
+            if (!this._isSending) resolve();
+            else setTimeout(check, 50);
+          };
+          setTimeout(check, 50);
+        });
+      }
+      if (this._pendingChildResults.length === 0) return;
+      console$g.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);
+      }
+    }
+  });
+  Object.assign(AIChat.prototype, {
+    createSession(options = {}) {
+      return new ChatSession(this, options);
+    }
+  });
+}
+installAIChatSessionFactory();
+installAIChatSessionFactory();
 const console$f = SDKLogger.createModuleConsole("SummarizeTool");
 const _SummarizeTool = class _SummarizeTool {
   constructor() {
@@ -11138,7 +11697,9 @@ class LoginWindow {
       const t = (k) => this._strings[k] || k;
       const enableRegister = options.enableRegister !== false;
       const enableWechat = options.enableWechat !== false;
-      const isWeChat = detectWxEnvironment().isWeChat;
+      const wxEnv = detectWxEnvironment();
+      const isWeChat = wxEnv.isWeChat;
+      const isWxMiniProgram = wxEnv.isMiniProgram;
       const isMobile = isMobileDevice();
       const showWechatQr = enableWechat && !isWeChat && !isMobile && typeof window !== "undefined";
       const showWechatRedirect = enableWechat && isWeChat;
@@ -11153,6 +11714,13 @@ class LoginWindow {
       this._machineCode = options.machineCode;
       this._wechatOptions = this._normalizeWechatOptions(options);
       this._wxAuthInstance = this.sdk.wxAuth || new WxAuth(this.sdk);
+      if (typeof window !== "undefined" && isWxMiniProgram && !this.sdk.token) {
+        const hasWechatCode = new URL(window.location.href).searchParams.get("code");
+        if (!hasWechatCode) {
+          this._wxAuthInstance.authorize({ autoRegister: true });
+          return;
+        }
+      }
       this._injectStyles();
       const overlay = document.createElement("div");
       overlay.className = "kw-login-overlay";
@@ -11349,16 +11917,14 @@ class LoginWindow {
           }
           regSubmit.textContent = t("registering");
           try {
+            const channel = options.channel != null ? Number(options.channel) : 60;
             const response = await this.sdk.post("/users/register", {
               username,
               password,
               platform: "WEB",
-              channel: 60
+              channel
             });
-            if (response && response.token) {
-              this.sdk.setToken(response.token);
-            }
-            this._finish(response);
+            this._finishWithAuth(response);
           } catch (err) {
             regSubmit.disabled = false;
             regSubmit.textContent = t("registerBtn");
@@ -11422,6 +11988,24 @@ class LoginWindow {
   close() {
     this._destroy();
   }
+  /**
+   * 打开登录弹窗并直接进入「设置账号」视图，用于微信回调全局识别后、
+   * 探测到未绑定账号（needBind）时完成绑定登录。
+   *
+   * show() 内部同步创建并挂载 overlay 后才返回 Promise，因此可在返回后立即
+   * 切换到 oauth-setup 视图（用户只会看到设置账号界面，不会看到账号/密码登录界面）。
+   *
+   * @param data    - codeToProbe 返回的 { ticket, suggestedUsername, provider, bindPath? }
+   * @param options - 透传给 show() 的选项（title / lang 等）
+   * @returns 与 show() 一致：绑定成功 resolve 登录结果，取消 reject
+   */
+  showWechatBindSetup(data, options = {}) {
+    const promise = this.show({ ...options, enableWechat: false, enableGoogle: false });
+    if (this._overlay) {
+      this._showOauthSetup(this._overlay, data, data.bindPath || OAUTH_BIND_PATH);
+    }
+    return promise;
+  }
   _renderWechatQrPanel(t) {
     return `
       <div class="kw-login-wechat-panel">
@@ -11602,11 +12186,8 @@ class LoginWindow {
       if (this._machineCode) payload.machineCode = this._machineCode;
       const response = await this.sdk.post(options.probePath, payload);
       if (response && response.token) {
-        this.sdk.setToken(response.token);
-        setCookie("token", response.token, 14);
-        setCookie("token", response.token, 14, { sameSite: "None", secure: true });
         this._clearWechatQueryFromCurrentUrl();
-        this._finish(response);
+        this._finishWithAuth(response);
         return;
       }
       if (response && response.needBind && response.ticket) {
@@ -11680,7 +12261,8 @@ class LoginWindow {
       const data = result && result.data;
       if (result && result.success && data && data.token) {
         this._clearWechatQueryFromCurrentUrl();
-        this._finish(data);
+        this._finishWithAuth(data);
+        this._reloadAfterOAuthLogin();
         return;
       }
       if (result && result.success && data && data.needBind && data.ticket) {
@@ -11951,11 +12533,8 @@ class LoginWindow {
       if (options.machineCode) payload.machineCode = options.machineCode;
       const response = await this.sdk.post(options.probePath, payload);
       if (response && response.token) {
-        this.sdk.setToken(response.token);
-        setCookie("token", response.token, 14);
-        setCookie("token", response.token, 14, { sameSite: "None", secure: true });
         this._clearGoogleQueryFromCurrentUrl();
-        this._finish(response);
+        this._finishWithAuth(response);
         return;
       }
       if (response && response.needBind && response.ticket) {
@@ -12199,10 +12778,7 @@ class LoginWindow {
       if (this._machineCode) payload.machineCode = this._machineCode;
       const response = await this.sdk.post(ctx.bindPath, payload);
       if (response && response.token) {
-        this.sdk.setToken(response.token);
-        setCookie("token", response.token, 14);
-        setCookie("token", response.token, 14, { sameSite: "None", secure: true });
-        this._finish(response);
+        this._finishWithAuth(response);
         return;
       }
       if (submitBtn) {
@@ -12231,6 +12807,28 @@ class LoginWindow {
     }
     return pwd;
   }
+  /**
+   * 登录/注册成功统一收尾：写 token + cookie，然后关窗口并 resolve。
+   * 所有「直接持有 token 的路径」都走此方法，避免各处重复写 setToken + setCookie。
+   * 若 response 不含 token（如账号登录走 sdk.login() 内部处理），退化为普通 _finish。
+   */
+  _finishWithAuth(response) {
+    if (response && response.token) {
+      this.sdk.setToken(response.token);
+      setCookie("token", response.token, 14);
+      setCookie("token", response.token, 14, { sameSite: "None", secure: true });
+    }
+    this._finish(response);
+  }
+  /**
+   * 整页跳转式 OAuth 登录（微信浏览器 / 小程序）成功后刷新页面，
+   * 使宿主页面以登录态重新初始化。SSR 等无 window 环境下静默跳过。
+   */
+  _reloadAfterOAuthLogin() {
+    if (typeof window !== "undefined" && window.location && typeof window.location.reload === "function") {
+      window.location.reload();
+    }
+  }
   _finish(response) {
     this._destroy();
     if (this._resolve) {
@@ -14320,8 +14918,9 @@ class LocalAPIKeySettings {
     this._injectStyles();
     const overlay = document.createElement("div");
     overlay.className = `lak-overlay${options.fullscreen ? " lak-overlay-fullscreen" : ""}`;
+    overlay.style.cssText = "position:fixed;top:0;left:0;right:0;bottom:0;width:100vw;height:100vh;height:100dvh;z-index:2147483647;margin:0;";
     overlay.innerHTML = this._buildHTML(options);
-    document.body.appendChild(overlay);
+    (document.body || document.documentElement).appendChild(overlay);
     this._overlay = overlay;
     this._populateFields();
     this._renderActivePanel();
@@ -14914,7 +15513,13 @@ class LocalAPIKeySettings {
     const style = document.createElement("style");
     style.textContent = `
       .lak-overlay {
-        position: fixed; inset: 0; z-index: 99999;
+        position: fixed; inset: 0;
+        /* Explicit width/height in addition to inset:0 so the overlay always
+         * fills the screen even when a transformed/filter/perspective ancestor
+         * turns it into the fixed-positioning containing block (e.g. a scaled
+         * app shell). vw/vh are resolved against the viewport regardless. */
+        width: 100vw; height: 100vh; height: 100dvh;
+        z-index: 2147483647;
         background: rgba(0,0,0,0.55);
         display: flex; align-items: center; justify-content: center;
         opacity: 0; transition: opacity 0.2s;
@@ -14943,10 +15548,12 @@ class LocalAPIKeySettings {
       }
 
       .lak-overlay-fullscreen .lak-box {
-        width: 100vw;
+        /* Fill the overlay (which already spans the viewport) rather than
+         * re-deriving from vw/dvh. This keeps the box correct even if the
+         * overlay is clamped by an ancestor containing block. */
+        width: 100%;
         max-width: none;
-        height: 100vh;
-        height: 100dvh;
+        height: 100%;
         max-height: none;
         border-radius: 0;
         box-shadow: none;
@@ -17812,6 +18419,57 @@ function applyCoreMixin(TargetClass) {
   proto.showProfileWindow = async function(options = {}) {
     return this.profileWindow.show(options);
   };
+  proto.handleWechatRedirectLogin = async function() {
+    var _a2, _b2;
+    if (typeof window === "undefined") return false;
+    let url;
+    try {
+      url = new URL(window.location.href);
+    } catch {
+      return false;
+    }
+    const code = url.searchParams.get("code");
+    const wxauth = url.searchParams.get("wxauth");
+    if (!code || wxauth !== "1") return false;
+    const guardKey = `kwWxRedirectLogin:${code}`;
+    try {
+      if (sessionStorage.getItem(guardKey)) return false;
+      sessionStorage.setItem(guardKey, "1");
+    } catch {
+    }
+    try {
+      const result = await this.wxAuth.codeToProbe(code);
+      const data = result && result.data;
+      if (result && result.success && data && data.token) {
+        this._clearWechatRedirectQuery();
+        if (typeof window !== "undefined" && window.location && typeof window.location.reload === "function") {
+          window.location.reload();
+        }
+        return true;
+      }
+      if (result && result.success && data && data.needBind && data.ticket) {
+        this._clearWechatRedirectQuery();
+        if (data.provider == null) data.provider = "wechat";
+        (_b2 = (_a2 = this.loginWindow).showWechatBindSetup) == null ? void 0 : _b2.call(_a2, data);
+        return true;
+      }
+    } catch (err) {
+      console.warn("[KeepworkSDK] WeChat redirect login failed:", err);
+    }
+    return true;
+  };
+  proto._clearWechatRedirectQuery = function() {
+    if (typeof window === "undefined" || !window.history || !window.history.replaceState) return;
+    try {
+      const url = new URL(window.location.href);
+      if (!url.searchParams.has("code") && !url.searchParams.has("state") && !url.searchParams.has("wxauth")) return;
+      url.searchParams.delete("code");
+      url.searchParams.delete("state");
+      url.searchParams.delete("wxauth");
+      window.history.replaceState({}, "", `${url.pathname}${url.search}${url.hash}`);
+    } catch {
+    }
+  };
   proto.logout = async function() {
     let response;
     try {
@@ -19344,6 +20002,15 @@ const _KeepworkSDK = class _KeepworkSDK {
     this._speechRTC = null;
     this._loadAIChatPromise = null;
     this._patchAIChat();
+    if (typeof window !== "undefined") {
+      Promise.resolve().then(
+        () => {
+          var _a2;
+          return (_a2 = this.handleWechatRedirectLogin) == null ? void 0 : _a2.call(this);
+        }
+      ).catch(() => {
+      });
+    }
   }
   // ──────────────────── AIChat / SpeechRTC 懒加载 getter/setter ────────────────────
   // 实际方法（_patchAIChat / loadAIChat）由 keepworkSDK.core.ts mixin 注入
@@ -20190,7 +20857,20 @@ class RTCChatSession {
     this.agentState = AGENT_STATE.UNKNOWN;
     this._stateEventReceived = false;
     this._autoPlayResumeRegistered = false;
-    this._cleanupChildSessions();
+    this._cleanupChildSessionsSafe();
+  }
+  _cleanupChildSessionsSafe() {
+    const cleanup = this._cleanupChildSessions;
+    if (typeof cleanup === "function") {
+      cleanup.call(this);
+      return;
+    }
+    for (const timer of this._debounceTimers || []) {
+      clearTimeout(timer);
+    }
+    this._debounceTimers = [];
+    this._childSessions = {};
+    this._pendingChildResults = [];
   }
   _ensureSandbox() {
     if (!this.sandbox) {
@@ -21149,24 +21829,28 @@ class RTCChatSession {
     }
   }
 }
-Object.assign(RTCChatSession.prototype, childSessionMethods);
-RTCChatSession.prototype._triggerImmediateCallback = async function() {
-  if (this._isSending) {
-    await new Promise((resolve) => {
-      const check = () => {
-        if (!this._isSending) resolve();
-        else setTimeout(check, 50);
-      };
-      setTimeout(check, 50);
-    });
-  }
-  if (this._pendingChildResults.length === 0) return;
-  try {
-    await this.send(null, this._lastSendOptions);
-  } catch (e) {
-    console$9.error("[RTCChatSession] Immediate callback send failed:", e);
-  }
-};
+function installRTCChatSessionMixin() {
+  Object.assign(RTCChatSession.prototype, childSessionMethods);
+  RTCChatSession.prototype._triggerImmediateCallback = async function() {
+    if (this._isSending) {
+      await new Promise((resolve) => {
+        const check = () => {
+          if (!this._isSending) resolve();
+          else setTimeout(check, 50);
+        };
+        setTimeout(check, 50);
+      });
+    }
+    if (this._pendingChildResults.length === 0) return;
+    try {
+      await this.send(null, this._lastSendOptions);
+    } catch (e) {
+      console$9.error("[RTCChatSession] Immediate callback send failed:", e);
+    }
+  };
+}
+installRTCChatSessionMixin();
+installRTCChatSessionMixin();
 let AIChatRTC$1 = (_a = class {
   /**
    * @param {Object} sdk  - KeepworkSDK instance (provides sdk.post, sdk.token, sdk.copilotTools)
@@ -23629,7 +24313,20 @@ class LocalRTCSession {
     this._isSpeaking = false;
     this._isLLMStreaming = false;
     this._messages = [];
-    this._cleanupChildSessions();
+    this._cleanupChildSessionsSafe();
+  }
+  _cleanupChildSessionsSafe() {
+    const cleanup = this._cleanupChildSessions;
+    if (typeof cleanup === "function") {
+      cleanup.call(this);
+      return;
+    }
+    for (const timer of this._debounceTimers || []) {
+      clearTimeout(timer);
+    }
+    this._debounceTimers = [];
+    this._childSessions = {};
+    this._pendingChildResults = [];
   }
   _mergeConfigSection(currentConfig = {}, nextConfig = {}) {
     return {
@@ -24433,19 +25130,23 @@ class LocalRTCSession {
     }
   }
 }
-Object.assign(LocalRTCSession.prototype, childSessionMethods);
-LocalRTCSession.prototype._triggerImmediateCallback = async function() {
-  if (this._pendingChildResults.length === 0) return;
-  const results = this._consumePendingChildResults();
-  const parts = results.map((cr) => {
-    const resultText = typeof cr.result === "string" ? cr.result : JSON.stringify(cr.result);
-    return `[Agent ${cr.agentName}] Task: ${cr.taskSummary}
+function installLocalRTCSessionMixin() {
+  Object.assign(LocalRTCSession.prototype, childSessionMethods);
+  LocalRTCSession.prototype._triggerImmediateCallback = async function() {
+    if (this._pendingChildResults.length === 0) return;
+    const results = this._consumePendingChildResults();
+    const parts = results.map((cr) => {
+      const resultText = typeof cr.result === "string" ? cr.result : JSON.stringify(cr.result);
+      return `[Agent ${cr.agentName}] Task: ${cr.taskSummary}
 Result: ${resultText}`;
-  });
-  const summary = parts.join("\n\n");
-  this.sendText(summary);
-};
+    });
+    const summary = parts.join("\n\n");
+    this.sendText(summary);
+  };
+}
+installLocalRTCSessionMixin();
 const console$6 = SDKLogger.createModuleConsole("AIChatRTCLocal");
+installLocalRTCSessionMixin();
 let AIChatRTCLocal$1 = (_b = class {
   /**
    * @param {Object} sdk  - KeepworkSDK instance