@langgraph-js/sdk 1.1.5 → 1.1.8

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,8 +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;
 }) => {
@@ -30,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,31 @@ 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;
+    if (content && Array.isArray(content)) {
+        return content.map((item) => {
+            if (item.type === "text") {
+                return item.text;
+            }
+        });
+    }
+    else if (typeof content === "string") {
+        return content;
+    }
+    else {
+        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([]);
@@ -34,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);
                 // 创建新会话时，需要自动刷新历史面板
@@ -49,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())
@@ -69,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());
@@ -93,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]);
@@ -118,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";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langgraph-js/sdk",
-  "version": "1.1.5",
+  "version": "1.1.8",
   "description": "The UI SDK for LangGraph - seamlessly integrate your AI agents with frontend interfaces",
   "main": "dist/index.js",
   "type": "module",
@@ -34,9 +34,7 @@
     "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;
@@ -40,6 +57,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 +84,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,6 +106,10 @@ export class LangGraphClient extends Client {
             limit: 100,
         });
     }
+    /**
+     * @zh 初始化 Assistant。
+     * @en Initializes the Assistant.
+     */
     async initAssistant(agentName: string) {
         try {
             const assistants = await this.listAssistants();
@@ -99,6 +128,10 @@ export class LangGraphClient extends Client {
         }
     }
 
+    /**
+     * @zh 创建一个新的 Thread。
+     * @en Creates a new Thread.
+     */
     async createThread({
         threadId,
     }: {
@@ -114,12 +147,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 +195,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[] = [];
@@ -188,7 +231,7 @@ export class LangGraphClient extends Client {
                             type: "tool",
                             additional_kwargs: {},
                             /** @ts-ignore */
-                            tool_input: m.additional_kwargs?.tool_calls[index].function.arguments,
+                            tool_input: m.additional_kwargs?.tool_calls?.[index]?.function?.arguments,
                             id: tool.id,
                             name: tool.name,
                             response_metadata: {},
@@ -214,7 +257,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 +288,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>();
@@ -275,6 +326,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 +357,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 +373,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 +495,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 +506,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 +517,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;

package/src/SpendTime.ts

@@ -1,13 +1,30 @@
+/**
+ * @zh SpendTime 类用于计算和记录操作的耗时。
+ * @en The SpendTime class is used to calculate and record the time spent on operations.
+ */
 export class SpendTime {
     private timeCounter = new Map<string, [Date, Date] | [Date]>();
 
+    /**
+     * @zh 开始计时。
+     * @en Starts timing.
+     */
     start(key: string) {
         this.timeCounter.set(key, [new Date()]);
     }
 
+    /**
+     * @zh 结束计时。
+     * @en Ends timing.
+     */
     end(key: string) {
         this.timeCounter.set(key, [this.timeCounter.get(key)?.[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: string) {
         if (this.timeCounter.has(key)) {
             this.end(key);
@@ -15,13 +32,27 @@ export class SpendTime {
             this.start(key);
         }
     }
+
+    /**
+     * @zh 获取指定键的开始时间。
+     * @en Gets the start time for the specified key.
+     */
     getStartTime(key: string) {
         return this.timeCounter.get(key)?.[0] || new Date();
     }
+
+    /**
+     * @zh 获取指定键的结束时间。
+     * @en Gets the end time for the specified key.
+     */
     getEndTime(key: string) {
         return this.timeCounter.get(key)?.[1] || new Date();
     }
 
+    /**
+     * @zh 获取指定键的耗时（毫秒）。
+     * @en Gets the time spent (in milliseconds) for the specified key.
+     */
     getSpendTime(key: string) {
         const [start, end = new Date()] = this.timeCounter.get(key) || [new Date(), new Date()];
         return end.getTime() - start.getTime();