@langgraph-js/sdk 1.1.6 → 1.1.9

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export * from "./LangGraphClient";
-export * from "./tool";
+export * from "./LangGraphClient.js";
+export * from "./tool/index.js";
 export * from "@langchain/langgraph-sdk";
-export * from "./ui-store";
-export * from "./ToolManager";
+export * from "./ui-store/index.js";
+export * from "./ToolManager.js";

package/dist/index.js

@@ -1,5 +1,5 @@
-export * from "./LangGraphClient";
-export * from "./tool";
+export * from "./LangGraphClient.js";
+export * from "./tool/index.js";
 export * from "@langchain/langgraph-sdk";
-export * from "./ui-store";
-export * from "./ToolManager";
+export * from "./ui-store/index.js";
+export * from "./ToolManager.js";

package/dist/tool/createTool.d.ts

@@ -1,5 +1,5 @@
 import { z, ZodRawShape, ZodTypeAny } from "zod";
-import { Action, Parameter } from "./copilotkit-actions";
+import { Action, Parameter } from "./copilotkit-actions.js";
 import { Message } from "@langchain/langgraph-sdk";
 export interface UnionTool<Args extends ZodRawShape> {
     name: string;

package/dist/tool/createTool.js

@@ -1,4 +1,4 @@
-import { actionParametersToJsonSchema, convertJsonSchemaToZodRawShape } from "./utils";
+import { actionParametersToJsonSchema, convertJsonSchemaToZodRawShape } from "./utils.js";
 import { z } from "zod";
 import { zodToJsonSchema } from "zod-to-json-schema";
 /** 用于格式校验 */

package/dist/tool/index.d.ts

@@ -1,2 +1,2 @@
-export * from "./createTool";
-export * from "./copilotkit-actions";
+export * from "./createTool.js";
+export * from "./copilotkit-actions.js";

package/dist/tool/index.js

@@ -1,2 +1,2 @@
-export * from "./createTool";
-export * from "./copilotkit-actions";
+export * from "./createTool.js";
+export * from "./copilotkit-actions.js";

package/dist/tool/utils.d.ts

@@ -5,7 +5,7 @@
  * MIT License
  */
 import { z, ZodRawShape } from "zod";
-import { Parameter } from "./copilotkit-actions";
+import { Parameter } from "./copilotkit-actions.js";
 export type JSONSchemaString = {
     type: "string";
     description?: string;

package/dist/ui-store/UnionStore.d.ts

@@ -1,10 +1,18 @@
 import { PreinitializedWritableAtom, StoreValue } from "nanostores";
+/**
+ * @zh UnionStore 类型用于合并 store 的 data 和 mutations，使其可以直接访问。
+ * @en The UnionStore type is used to merge the data and mutations of a store, allowing direct access.
+ */
 export type UnionStore<T extends {
     data: Record<string, PreinitializedWritableAtom<any>>;
     mutations: Record<string, any>;
 }> = {
     [k in keyof T["data"]]: StoreValue<T["data"][k]>;
 } & T["mutations"];
+/**
+ * @zh useUnionStore Hook 用于将 nanostores 的 store 结构转换为更易于在 UI 组件中使用的扁平结构。
+ * @en The useUnionStore Hook is used to transform the nanostores store structure into a flatter structure that is easier to use in UI components.
+ */
 export declare const useUnionStore: <T extends {
     data: Record<string, any>;
     mutations: Record<string, any>;

package/dist/ui-store/UnionStore.js

@@ -1,3 +1,7 @@
+/**
+ * @zh useUnionStore Hook 用于将 nanostores 的 store 结构转换为更易于在 UI 组件中使用的扁平结构。
+ * @en The useUnionStore Hook is used to transform the nanostores store structure into a flatter structure that is easier to use in UI components.
+ */
 export const useUnionStore = (store, useStore) => {
     const data = Object.fromEntries(Object.entries(store.data).map(([key, value]) => {
         return [key, useStore(value)];

package/dist/ui-store/createChatStore.d.ts

@@ -1,9 +1,29 @@
-import { LangGraphClient, LangGraphClientConfig, RenderMessage, SendMessageOptions } from "../LangGraphClient";
+import { LangGraphClient, LangGraphClientConfig, RenderMessage, SendMessageOptions } from "../LangGraphClient.js";
 import { Message, Thread } from "@langchain/langgraph-sdk";
+/**
+ * @zh 格式化日期对象为时间字符串。
+ * @en Formats a Date object into a time string.
+ */
 export declare const formatTime: (date: Date) => string;
+/**
+ * @zh 格式化数字为带千位分隔符的字符串。
+ * @en Formats a number into a string with thousand separators.
+ */
 export declare const formatTokens: (tokens: number) => string;
+/**
+ * @zh 获取消息内容的文本表示，处理不同类型的消息内容。
+ * @en Gets the text representation of message content, handling different types of message content.
+ */
 export declare const getMessageContent: (content: any) => string;
+/**
+ * @zh 获取历史记录中 Thread 内容的文本表示。
+ * @en Gets the text representation of Thread content in history.
+ */
 export declare const getHistoryContent: (thread: Thread) => string | any[];
+/**
+ * @zh 创建一个用于聊天界面的状态管理器 (store)。
+ * @en Creates a state manager (store) for the chat interface.
+ */
 export declare const createChatStore: (initClientName: string, config: LangGraphClientConfig, context?: {
     onInit?: (client: LangGraphClient) => void;
 }) => {
@@ -31,12 +51,32 @@ export declare const createChatStore: (initClientName: string, config: LangGraph
         addToHistory: (thread: Thread<{
             messages: Message[];
         }>) => void;
+        /**
+         * @zh 设置用户输入内容。
+         * @en Sets the user input content.
+         */
         setUserInput(input: string): void;
+        /**
+         * @zh 设置当前的 Agent 并重新初始化客户端。
+         * @en Sets the current Agent and reinitializes the client.
+         */
         setCurrentAgent(agent: string): Promise<void>;
+        /**
+         * @zh 创建一个新的聊天会话。
+         * @en Creates a new chat session.
+         */
         createNewChat(): void;
+        /**
+         * @zh 切换到指定的历史聊天会话。
+         * @en Switches to the specified historical chat session.
+         */
         toHistoryChat(thread: Thread<{
             messages: Message[];
         }>): void;
+        /**
+         * @zh 删除指定的历史聊天会话。
+         * @en Deletes the specified historical chat session.
+         */
         deleteHistoryChat(thread: Thread<{
             messages: Message[];
         }>): Promise<void>;

package/dist/ui-store/createChatStore.js

@@ -1,11 +1,24 @@
 import { atom } from "nanostores";
-import { LangGraphClient } from "../LangGraphClient";
+import { LangGraphClient } from "../LangGraphClient.js";
+import { rafDebounce } from "./rafDebounce.js";
+/**
+ * @zh 格式化日期对象为时间字符串。
+ * @en Formats a Date object into a time string.
+ */
 export const formatTime = (date) => {
     return date.toLocaleTimeString("en-US");
 };
+/**
+ * @zh 格式化数字为带千位分隔符的字符串。
+ * @en Formats a number into a string with thousand separators.
+ */
 export const formatTokens = (tokens) => {
     return tokens.toLocaleString("en");
 };
+/**
+ * @zh 获取消息内容的文本表示，处理不同类型的消息内容。
+ * @en Gets the text representation of message content, handling different types of message content.
+ */
 export const getMessageContent = (content) => {
     if (typeof content === "string")
         return content;
@@ -24,6 +37,10 @@ export const getMessageContent = (content) => {
     }
     return JSON.stringify(content);
 };
+/**
+ * @zh 获取历史记录中 Thread 内容的文本表示。
+ * @en Gets the text representation of Thread content in history.
+ */
 export const getHistoryContent = (thread) => {
     var _a, _b, _c;
     const content = (_c = (_b = (_a = thread === null || thread === void 0 ? void 0 : thread.values) === null || _a === void 0 ? void 0 : _a.messages) === null || _b === void 0 ? void 0 : _b[0]) === null || _c === void 0 ? void 0 : _c.content;
@@ -41,6 +58,10 @@ export const getHistoryContent = (thread) => {
         return "";
     }
 };
+/**
+ * @zh 创建一个用于聊天界面的状态管理器 (store)。
+ * @en Creates a state manager (store) for the chat interface.
+ */
 export const createChatStore = (initClientName, config, context = {}) => {
     const client = atom(null);
     const renderMessages = atom([]);
@@ -51,14 +72,22 @@ export const createChatStore = (initClientName, config, context = {}) => {
     const showHistory = atom(true);
     const currentAgent = atom(initClientName);
     const currentChatId = atom(null);
-    const initClient = async () => {
+    const updateUI = rafDebounce((newClient) => {
+        renderMessages.set(newClient.renderMessage);
+    });
+    /**
+     * @zh 初始化 LangGraph 客户端。
+     * @en Initializes the LangGraph client.
+     */
+    async function initClient() {
         var _a;
         const newClient = new LangGraphClient(config);
         await newClient.initAssistant(currentAgent.get());
+        currentAgent.set(newClient.getCurrentAssistant().graph_id);
         // 不再需要创建，sendMessage 会自动创建
         // await newClient.createThread();
+        inChatError.set(null);
         newClient.onStreamingUpdate((event) => {
-            var _a;
             if (event.type === "thread" || event.type === "done") {
                 // console.log(event.data);
                 // 创建新会话时，需要自动刷新历史面板
@@ -66,16 +95,19 @@ export const createChatStore = (initClientName, config, context = {}) => {
             }
             if (event.type === "error") {
                 loading.set(false);
-                inChatError.set(((_a = event.data) === null || _a === void 0 ? void 0 : _a.message) || "发生错误");
+                inChatError.set(event.data);
             }
             // console.log(newClient.renderMessage);
-            renderMessages.set(newClient.renderMessage);
+            updateUI(newClient);
         });
         (_a = context.onInit) === null || _a === void 0 ? void 0 : _a.call(context, newClient);
-        // newClient.tools.bindTools([fileTool, askUserTool]);
         newClient.graphState = {};
         client.set(newClient);
-    };
+    }
+    /**
+     * @zh 发送消息。
+     * @en Sends a message.
+     */
     const sendMessage = async (message, extraData) => {
         var _a;
         if ((!userInput.get().trim() && !(message === null || message === void 0 ? void 0 : message.length)) || loading.get() || !client.get())
@@ -86,21 +118,37 @@ export const createChatStore = (initClientName, config, context = {}) => {
         userInput.set("");
         loading.set(false);
     };
+    /**
+     * @zh 停止当前的消息生成。
+     * @en Stops the current message generation.
+     */
     const stopGeneration = () => {
         var _a;
         (_a = client.get()) === null || _a === void 0 ? void 0 : _a.cancelRun();
     };
+    /**
+     * @zh 切换工具消息的折叠状态。
+     * @en Toggles the collapsed state of a tool message.
+     */
     const toggleToolCollapse = (toolId) => {
         const prev = collapsedTools.get();
         collapsedTools.set(prev.includes(toolId) ? prev.filter((id) => id !== toolId) : [...prev, toolId]);
     };
+    /**
+     * @zh 切换历史记录面板的可见性。
+     * @en Toggles the visibility of the history panel.
+     */
     const toggleHistoryVisible = () => {
         showHistory.set(!showHistory.get());
     };
     const historyList = atom([]);
+    /**
+     * @zh 刷新历史记录列表。
+     * @en Refreshes the history list.
+     */
     const refreshHistoryList = async () => {
         var _a;
-        if (!client.get())
+        if (!client.get() || !showHistory.get())
             return;
         try {
             const response = await ((_a = client.get()) === null || _a === void 0 ? void 0 : _a.listThreads());
@@ -110,6 +158,10 @@ export const createChatStore = (initClientName, config, context = {}) => {
             console.error("Failed to fetch threads:", error);
         }
     };
+    /**
+     * @zh 将一个 Thread 添加到历史记录列表的开头。
+     * @en Adds a Thread to the beginning of the history list.
+     */
     const addToHistory = (thread) => {
         const prev = historyList.get();
         historyList.set([thread, ...prev]);
@@ -135,23 +187,46 @@ export const createChatStore = (initClientName, config, context = {}) => {
             toggleHistoryVisible,
             refreshHistoryList,
             addToHistory,
+            /**
+             * @zh 设置用户输入内容。
+             * @en Sets the user input content.
+             */
             setUserInput(input) {
                 userInput.set(input);
             },
+            /**
+             * @zh 设置当前的 Agent 并重新初始化客户端。
+             * @en Sets the current Agent and reinitializes the client.
+             */
             setCurrentAgent(agent) {
                 currentAgent.set(agent);
                 return initClient().then(() => {
-                    refreshHistoryList();
+                    if (showHistory.get()) {
+                        refreshHistoryList();
+                    }
                 });
             },
+            /**
+             * @zh 创建一个新的聊天会话。
+             * @en Creates a new chat session.
+             */
             createNewChat() {
                 var _a;
                 (_a = client.get()) === null || _a === void 0 ? void 0 : _a.reset();
+                inChatError.set(null);
             },
+            /**
+             * @zh 切换到指定的历史聊天会话。
+             * @en Switches to the specified historical chat session.
+             */
             toHistoryChat(thread) {
                 var _a, _b;
                 (_a = client.get()) === null || _a === void 0 ? void 0 : _a.resetThread((_b = thread.metadata) === null || _b === void 0 ? void 0 : _b.graph_id, thread.thread_id);
             },
+            /**
+             * @zh 删除指定的历史聊天会话。
+             * @en Deletes the specified historical chat session.
+             */
             async deleteHistoryChat(thread) {
                 var _a;
                 await ((_a = client.get()) === null || _a === void 0 ? void 0 : _a.threads.delete(thread.thread_id));

package/dist/ui-store/index.d.ts

@@ -1,2 +1,2 @@
-export * from "./createChatStore";
-export * from "./UnionStore";
+export * from "./createChatStore.js";
+export * from "./UnionStore.js";

package/dist/ui-store/index.js

@@ -1,2 +1,2 @@
-export * from "./createChatStore";
-export * from "./UnionStore";
+export * from "./createChatStore.js";
+export * from "./UnionStore.js";

package/dist/ui-store/rafDebounce.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Creates a debounced function that executes once per animation frame
+ * @param callback - The function to debounce
+ * @returns A function that executes the callback on the next animation frame
+ */
+export declare function rafDebounce<T extends (...args: any[]) => any>(callback: T): (...args: Parameters<T>) => void;

package/dist/ui-store/rafDebounce.js

@@ -0,0 +1,26 @@
+/**
+ * Creates a debounced function that executes once per animation frame
+ * @param callback - The function to debounce
+ * @returns A function that executes the callback on the next animation frame
+ */
+export function rafDebounce(callback) {
+    let rafId = null;
+    let lastArgs = null;
+    // Return the debounced function
+    return function (...args) {
+        // Store the most recent arguments
+        lastArgs = args;
+        // Cancel any pending animation frame
+        if (rafId !== null) {
+            cancelAnimationFrame(rafId);
+        }
+        // Schedule execution on the next animation frame
+        rafId = requestAnimationFrame(() => {
+            if (lastArgs !== null) {
+                callback(...lastArgs);
+                lastArgs = null;
+            }
+            rafId = null;
+        });
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langgraph-js/sdk",
-  "version": "1.1.6",
+  "version": "1.1.9",
   "description": "The UI SDK for LangGraph - seamlessly integrate your AI agents with frontend interfaces",
   "main": "dist/index.js",
   "type": "module",
@@ -29,14 +29,12 @@
     "url": "https://github.com/KonghaYao/YaoAgent/issues"
   },
   "dependencies": {
-    "@langchain/langgraph-sdk": "^0.0.74",
+    "@langchain/langgraph-sdk": "^0.0.76",
     "nanostores": "^1.0.1",
     "zod": "^3.24.3",
     "zod-to-json-schema": "^3.24.3"
   },
-  "devDependencies": {
-    "vite": "^6.3.4"
-  },
+  "devDependencies": {},
   "scripts": {
     "build": "tsc",
     "prepublish": "pnpm build"

package/src/LangGraphClient.ts

@@ -1,8 +1,25 @@
 import { Client, Thread, Message, Assistant, HumanMessage, AIMessage, ToolMessage, Command } from "@langchain/langgraph-sdk";
-import { ToolManager } from "./ToolManager";
-import { CallToolResult } from "./tool";
-import { AsyncCallerParams } from "@langchain/langgraph-sdk/dist/utils/async_caller";
-
+import { ToolManager } from "./ToolManager.js";
+import { CallToolResult } from "./tool/createTool.js";
+interface AsyncCallerParams {
+    /**
+     * The maximum number of concurrent calls that can be made.
+     * Defaults to `Infinity`, which means no limit.
+     */
+    maxConcurrency?: number;
+    /**
+     * The maximum number of retries that can be made for a single call,
+     * with an exponential backoff between each attempt. Defaults to 6.
+     */
+    maxRetries?: number;
+    onFailedResponseHook?: any;
+    /**
+     * Specify a custom fetch implementation.
+     *
+     * By default we expect the `fetch` is available in the global scope.
+     */
+    fetch?: typeof fetch | ((...args: any[]) => any);
+}
 export type RenderMessage = Message & {
     /** 工具入参 ，聚合而来*/
     tool_input?: string;
@@ -26,6 +43,8 @@ export type RenderMessage = Message & {
     spend_time?: number;
     /** 渲染时的唯一 id，聚合而来*/
     unique_id?: string;
+    /** 工具调用是否完成 */
+    done?: boolean;
 };
 export type SendMessageOptions = {
     extraParams?: Record<string, any>;
@@ -40,6 +59,10 @@ export interface LangGraphClientConfig {
     defaultHeaders?: Record<string, string | null | undefined>;
 }
 
+/**
+ * @zh StreamingMessageType 类用于判断消息的类型。
+ * @en The StreamingMessageType class is used to determine the type of a message.
+ */
 export class StreamingMessageType {
     static isUser(m: Message) {
         return m.type === "human";
@@ -63,6 +86,10 @@ type StreamingUpdateEvent = {
 
 type StreamingUpdateCallback = (event: StreamingUpdateEvent) => void;
 
+/**
+ * @zh LangGraphClient 类是与 LangGraph 后端交互的主要客户端。
+ * @en The LangGraphClient class is the main client for interacting with the LangGraph backend.
+ */
 export class LangGraphClient extends Client {
     private currentAssistant: Assistant | null = null;
     private currentThread: Thread | null = null;
@@ -81,14 +108,23 @@ export class LangGraphClient extends Client {
             limit: 100,
         });
     }
-    async initAssistant(agentName: string) {
+    /**
+     * @zh 初始化 Assistant。
+     * @en Initializes the Assistant.
+     */
+    async initAssistant(agentName?: string) {
         try {
             const assistants = await this.listAssistants();
             this.availableAssistants = assistants;
             if (assistants.length > 0) {
-                this.currentAssistant = assistants.find((assistant) => assistant.graph_id === agentName) || null;
-                if (!this.currentAssistant) {
-                    throw new Error("Agent not found: " + agentName);
+                if (agentName) {
+                    console.log("agentName", agentName);
+                    this.currentAssistant = assistants.find((assistant) => assistant.graph_id === agentName) || null;
+                    if (!this.currentAssistant) {
+                        throw new Error("Agent not found: " + agentName);
+                    }
+                } else {
+                    this.currentAssistant = assistants[0];
                 }
             } else {
                 throw new Error("No assistants found");
@@ -99,6 +135,10 @@ export class LangGraphClient extends Client {
         }
     }
 
+    /**
+     * @zh 创建一个新的 Thread。
+     * @en Creates a new Thread.
+     */
     async createThread({
         threadId,
     }: {
@@ -114,12 +154,19 @@ export class LangGraphClient extends Client {
             throw error;
         }
     }
+    /**
+     * @zh 列出所有的 Thread。
+     * @en Lists all Threads.
+     */
     async listThreads<T>() {
         return this.threads.search<T>({
             sortOrder: "desc",
         });
     }
-    /** 从历史中恢复数据 */
+    /**
+     * @zh 从历史中恢复 Thread 数据。
+     * @en Resets the Thread data from history.
+     */
     async resetThread(agent: string, threadId: string) {
         await this.initAssistant(agent);
         this.currentThread = await this.threads.get(threadId);
@@ -155,7 +202,10 @@ export class LangGraphClient extends Client {
         return message;
     }
 
-    /** 用于 UI 中的流式渲染中的消息 */
+    /**
+     * @zh 用于 UI 中的流式渲染中的消息。
+     * @en Messages used for streaming rendering in the UI.
+     */
     get renderMessage() {
         const previousMessage = new Map<string, Message>();
         const result: Message[] = [];
@@ -214,7 +264,11 @@ export class LangGraphClient extends Client {
 
         return this.attachInfoForMessage(this.composeToolMessages(result as RenderMessage[]));
     }
-    attachInfoForMessage(result: RenderMessage[]) {
+    /**
+     * @zh 为消息附加额外的信息，如耗时、唯一 ID 等。
+     * @en Attaches additional information to messages, such as spend time, unique ID, etc.
+     */
+    private attachInfoForMessage(result: RenderMessage[]) {
         let lastMessage: RenderMessage | null = null;
         for (const message of result) {
             const createTime = message.response_metadata?.create_time || "";
@@ -241,7 +295,11 @@ export class LangGraphClient extends Client {
         }
         return result;
     }
-    composeToolMessages(messages: RenderMessage[]): RenderMessage[] {
+    /**
+     * @zh 组合工具消息，将 AI 的工具调用和工具的执行结果关联起来。
+     * @en Composes tool messages, associating AI tool calls with tool execution results.
+     */
+    private composeToolMessages(messages: RenderMessage[]): RenderMessage[] {
         const result: RenderMessage[] = [];
         const assistantToolMessages = new Map<string, { args: string }>();
         const toolParentMessage = new Map<string, RenderMessage>();
@@ -261,7 +319,9 @@ export class LangGraphClient extends Client {
                     message.tool_input = typeof assistantToolMessage.args !== "string" ? JSON.stringify(assistantToolMessage.args) : assistantToolMessage.args;
                     if (message.additional_kwargs) {
                         message.additional_kwargs.done = true;
+                        message.done = true;
                     } else {
+                        message.done = true;
                         message.additional_kwargs = {
                             done: true,
                         };
@@ -275,6 +335,10 @@ export class LangGraphClient extends Client {
         }
         return result;
     }
+    /**
+     * @zh 获取 Token 计数器信息。
+     * @en Gets the Token counter information.
+     */
     get tokenCounter() {
         return this.graphMessages.reduce(
             (acc, message) => {
@@ -302,6 +366,10 @@ export class LangGraphClient extends Client {
             }
         );
     }
+    /**
+     * @zh 注册流式更新的回调函数。
+     * @en Registers a callback function for streaming updates.
+     */
     onStreamingUpdate(callback: StreamingUpdateCallback) {
         this.streamingCallbacks.add(callback);
         return () => {
@@ -314,11 +382,19 @@ export class LangGraphClient extends Client {
     }
     graphState: any = {};
     currentRun?: { run_id: string };
+    /**
+     * @zh 取消当前的 Run。
+     * @en Cancels the current Run.
+     */
     cancelRun() {
         if (this.currentThread?.thread_id && this.currentRun?.run_id) {
             this.runs.cancel(this.currentThread!.thread_id, this.currentRun.run_id);
         }
     }
+    /**
+     * @zh 发送消息到 LangGraph 后端。
+     * @en Sends a message to the LangGraph backend.
+     */
     async sendMessage(input: string | Message[], { extraParams, _debug, command }: SendMessageOptions = {}) {
         if (!this.currentAssistant) {
             throw new Error("Thread or Assistant not initialized");
@@ -428,7 +504,10 @@ export class LangGraphClient extends Client {
         const result = await this.tools.callTool(message.name!, args, { client: that, message });
         return this.resume(result);
     }
-    /** 恢复消息，当中断流时使用 */
+    /**
+     * @zh 继续被前端工具中断的流程。
+     * @en Resumes a process interrupted by a frontend tool.
+     */
     resume(result: CallToolResult) {
         return this.sendMessage([], {
             command: {
@@ -436,7 +515,10 @@ export class LangGraphClient extends Client {
             },
         });
     }
-    /** 完成工具等待 */
+    /**
+     * @zh 标记前端工具等待已完成。
+     * @en Marks the frontend tool waiting as completed.
+     */
     doneFEToolWaiting(id: string, result: CallToolResult) {
         const done = this.tools.doneWaiting(id, result);
         if (!done && this.currentThread?.status === "interrupted") {
@@ -444,14 +526,26 @@ export class LangGraphClient extends Client {
         }
     }
 
+    /**
+     * @zh 获取当前的 Thread。
+     * @en Gets the current Thread.
+     */
     getCurrentThread() {
         return this.currentThread;
     }
 
+    /**
+     * @zh 获取当前的 Assistant。
+     * @en Gets the current Assistant.
+     */
     getCurrentAssistant() {
         return this.currentAssistant;
     }
 
+    /**
+     * @zh 重置客户端状态。
+     * @en Resets the client state.
+     */
     async reset() {
         await this.initAssistant(this.currentAssistant?.name!);
         this.currentThread = null;