@langgraph-js/sdk 1.1.6 → 1.1.8

package/dist/SpendTime.d.ts

@@ -1,9 +1,37 @@
+/**
+ * @zh SpendTime 类用于计算和记录操作的耗时。
+ * @en The SpendTime class is used to calculate and record the time spent on operations.
+ */
 export declare class SpendTime {
     private timeCounter;
+    /**
+     * @zh 开始计时。
+     * @en Starts timing.
+     */
     start(key: string): void;
+    /**
+     * @zh 结束计时。
+     * @en Ends timing.
+     */
     end(key: string): void;
+    /**
+     * @zh 设置或更新指定键的耗时记录。如果键已存在，则更新结束时间；否则，开始新的计时。
+     * @en Sets or updates the time spent record for the specified key. If the key already exists, updates the end time; otherwise, starts a new timing.
+     */
     setSpendTime(key: string): void;
+    /**
+     * @zh 获取指定键的开始时间。
+     * @en Gets the start time for the specified key.
+     */
     getStartTime(key: string): Date;
+    /**
+     * @zh 获取指定键的结束时间。
+     * @en Gets the end time for the specified key.
+     */
     getEndTime(key: string): Date;
+    /**
+     * @zh 获取指定键的耗时（毫秒）。
+     * @en Gets the time spent (in milliseconds) for the specified key.
+     */
     getSpendTime(key: string): number;
 }

package/dist/SpendTime.js

@@ -1,14 +1,30 @@
+/**
+ * @zh SpendTime 类用于计算和记录操作的耗时。
+ * @en The SpendTime class is used to calculate and record the time spent on operations.
+ */
 export class SpendTime {
     constructor() {
         this.timeCounter = new Map();
     }
+    /**
+     * @zh 开始计时。
+     * @en Starts timing.
+     */
     start(key) {
         this.timeCounter.set(key, [new Date()]);
     }
+    /**
+     * @zh 结束计时。
+     * @en Ends timing.
+     */
     end(key) {
         var _a;
         this.timeCounter.set(key, [((_a = this.timeCounter.get(key)) === null || _a === void 0 ? void 0 : _a[0]) || new Date(), new Date()]);
     }
+    /**
+     * @zh 设置或更新指定键的耗时记录。如果键已存在，则更新结束时间；否则，开始新的计时。
+     * @en Sets or updates the time spent record for the specified key. If the key already exists, updates the end time; otherwise, starts a new timing.
+     */
     setSpendTime(key) {
         if (this.timeCounter.has(key)) {
             this.end(key);
@@ -17,14 +33,26 @@ export class SpendTime {
             this.start(key);
         }
     }
+    /**
+     * @zh 获取指定键的开始时间。
+     * @en Gets the start time for the specified key.
+     */
     getStartTime(key) {
         var _a;
         return ((_a = this.timeCounter.get(key)) === null || _a === void 0 ? void 0 : _a[0]) || new Date();
     }
+    /**
+     * @zh 获取指定键的结束时间。
+     * @en Gets the end time for the specified key.
+     */
     getEndTime(key) {
         var _a;
         return ((_a = this.timeCounter.get(key)) === null || _a === void 0 ? void 0 : _a[1]) || new Date();
     }
+    /**
+     * @zh 获取指定键的耗时（毫秒）。
+     * @en Gets the time spent (in milliseconds) for the specified key.
+     */
     getSpendTime(key) {
         const [start, end = new Date()] = this.timeCounter.get(key) || [new Date(), new Date()];
         return end.getTime() - start.getTime();

package/dist/ToolManager.d.ts

@@ -1,43 +1,54 @@
 import { ToolMessage } from "@langchain/langgraph-sdk";
-import { LangGraphClient } from "./LangGraphClient";
-import { CallToolResult, UnionTool } from "./tool/createTool";
+import { LangGraphClient } from "./LangGraphClient.js";
+import { CallToolResult, UnionTool } from "./tool/createTool.js";
+/**
+ * @zh ToolManager 类用于管理和执行工具。
+ * @en The ToolManager class is used to manage and execute tools.
+ */
 export declare class ToolManager {
     private tools;
     /**
-     * 注册一个工具
-     * @param tool 要注册的工具
+     * @zh 注册一个工具。
+     * @en Registers a tool.
      */
     bindTool(tool: UnionTool<any>): void;
     /**
-     * 注册多个工具
-     * @param tools 要注册的工具数组
+     * @zh 注册多个工具。
+     * @en Registers multiple tools.
      */
     bindTools(tools: UnionTool<any>[]): void;
     /**
-     * 获取所有已注册的工具
-     * @returns 工具数组
+     * @zh 获取所有已注册的工具。
+     * @en Gets all registered tools.
      */
     getAllTools(): UnionTool<any>[];
     /**
-     * 获取指定名称的工具
-     * @param name 工具名称
-     * @returns 工具实例或 undefined
+     * @zh 获取指定名称的工具。
+     * @en Gets the tool with the specified name.
      */
     getTool(name: string): UnionTool<any> | undefined;
     /**
-     * 移除指定名称的工具
-     * @param name 工具名称
-     * @returns 是否成功移除
+     * @zh 移除指定名称的工具。
+     * @en Removes the tool with the specified name.
      */
     removeTool(name: string): boolean;
     /**
-     * 清空所有工具
+     * @zh 清空所有工具。
+     * @en Clears all tools.
      */
     clearTools(): void;
+    /**
+     * @zh 调用指定名称的工具。
+     * @en Calls the tool with the specified name.
+     */
     callTool(name: string, args: any, context: {
         client: LangGraphClient;
         message: ToolMessage;
     }): Promise<CallToolResult>;
+    /**
+     * @zh 将所有工具转换为 JSON 定义格式。
+     * @en Converts all tools to JSON definition format.
+     */
     toJSON(): {
         name: string;
         description: string;
@@ -49,12 +60,19 @@ export declare class ToolManager {
         };
     }[];
     private waitingMap;
+    /**
+     * @zh 标记指定 ID 的工具等待已完成，并传递结果。
+     * @en Marks the tool waiting with the specified ID as completed and passes the result.
+     */
     doneWaiting(id: string, value: CallToolResult): boolean;
+    /**
+     * @zh 等待指定 ID 的工具完成。
+     * @en Waits for the tool with the specified ID to complete.
+     */
     waitForDone(id: string): Promise<unknown> | ((value: CallToolResult) => void) | undefined;
-    /** 等待用户输入
-     * @example
-     * // 继续 chat 流
-     * client.tools.doneWaiting(message.id!, (e.target as any).value);
+    /**
+     * @zh 一个静态方法，用于在前端等待用户界面操作完成。
+     * @en A static method used in the frontend to wait for user interface operations to complete.
      */
     static waitForUIDone<T>(_: T, context: {
         client: LangGraphClient;

package/dist/ToolManager.js

@@ -1,4 +1,8 @@
-import { createJSONDefineTool } from "./tool/createTool";
+import { createJSONDefineTool } from "./tool/createTool.js";
+/**
+ * @zh ToolManager 类用于管理和执行工具。
+ * @en The ToolManager class is used to manage and execute tools.
+ */
 export class ToolManager {
     constructor() {
         this.tools = new Map();
@@ -6,8 +10,8 @@ export class ToolManager {
         this.waitingMap = new Map();
     }
     /**
-     * 注册一个工具
-     * @param tool 要注册的工具
+     * @zh 注册一个工具。
+     * @en Registers a tool.
      */
     bindTool(tool) {
         if (this.tools.has(tool.name)) {
@@ -16,41 +20,44 @@ export class ToolManager {
         this.tools.set(tool.name, tool);
     }
     /**
-     * 注册多个工具
-     * @param tools 要注册的工具数组
+     * @zh 注册多个工具。
+     * @en Registers multiple tools.
      */
     bindTools(tools) {
         tools.forEach((tool) => this.bindTool(tool));
     }
     /**
-     * 获取所有已注册的工具
-     * @returns 工具数组
+     * @zh 获取所有已注册的工具。
+     * @en Gets all registered tools.
      */
     getAllTools() {
         return Array.from(this.tools.values());
     }
     /**
-     * 获取指定名称的工具
-     * @param name 工具名称
-     * @returns 工具实例或 undefined
+     * @zh 获取指定名称的工具。
+     * @en Gets the tool with the specified name.
      */
     getTool(name) {
         return this.tools.get(name);
     }
     /**
-     * 移除指定名称的工具
-     * @param name 工具名称
-     * @returns 是否成功移除
+     * @zh 移除指定名称的工具。
+     * @en Removes the tool with the specified name.
      */
     removeTool(name) {
         return this.tools.delete(name);
     }
     /**
-     * 清空所有工具
+     * @zh 清空所有工具。
+     * @en Clears all tools.
      */
     clearTools() {
         this.tools.clear();
     }
+    /**
+     * @zh 调用指定名称的工具。
+     * @en Calls the tool with the specified name.
+     */
     async callTool(name, args, context) {
         const tool = this.getTool(name);
         if (!tool) {
@@ -58,9 +65,17 @@ export class ToolManager {
         }
         return await tool.execute(args, context);
     }
+    /**
+     * @zh 将所有工具转换为 JSON 定义格式。
+     * @en Converts all tools to JSON definition format.
+     */
     toJSON() {
         return Array.from(this.tools.values()).map((i) => createJSONDefineTool(i));
     }
+    /**
+     * @zh 标记指定 ID 的工具等待已完成，并传递结果。
+     * @en Marks the tool waiting with the specified ID as completed and passes the result.
+     */
     doneWaiting(id, value) {
         if (this.waitingMap.has(id)) {
             this.waitingMap.get(id)(value);
@@ -72,6 +87,10 @@ export class ToolManager {
             return false;
         }
     }
+    /**
+     * @zh 等待指定 ID 的工具完成。
+     * @en Waits for the tool with the specified ID to complete.
+     */
     waitForDone(id) {
         if (this.waitingMap.has(id)) {
             return this.waitingMap.get(id);
@@ -81,10 +100,9 @@ export class ToolManager {
         });
         return promise;
     }
-    /** 等待用户输入
-     * @example
-     * // 继续 chat 流
-     * client.tools.doneWaiting(message.id!, (e.target as any).value);
+    /**
+     * @zh 一个静态方法，用于在前端等待用户界面操作完成。
+     * @en A static method used in the frontend to wait for user interface operations to complete.
      */
     static waitForUIDone(_, context) {
         // console.log(context.message);

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,23 @@
 import { atom } from "nanostores";
-import { LangGraphClient } from "../LangGraphClient";
+import { LangGraphClient } from "../LangGraphClient.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 +36,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 +57,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 +71,18 @@ export const createChatStore = (initClientName, config, context = {}) => {
     const showHistory = atom(true);
     const currentAgent = atom(initClientName);
     const currentChatId = atom(null);
-    const initClient = async () => {
+    /**
+     * @zh 初始化 LangGraph 客户端。
+     * @en Initializes the LangGraph client.
+     */
+    async function initClient() {
         var _a;
         const newClient = new LangGraphClient(config);
         await newClient.initAssistant(currentAgent.get());
         // 不再需要创建，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 +90,20 @@ 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);
         });
         (_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 +114,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 +154,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 +183,44 @@ 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();
                 });
             },
+            /**
+             * @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";