@langgraph-js/sdk 4.6.3 → 4.6.5

package/dist/LangGraphClient.d.ts

@@ -284,6 +284,8 @@ export declare class LangGraphClient<TStateType = unknown> extends EventEmitter<
      * @deprecated 请使用 doneHumanInTheLoopWaiting 和规范的 humanInTheLoop 协议定义状态
      */
     doneFEToolWaiting(id: string, result: CallToolResult): void;
+    /** 尝试强制跳过工具调用 */
+    private forceSkipToolLock?;
     /**
      * @zh 标记人机交互等待已完成。
      * @en Marks the human in the loop waiting as completed.

package/dist/LangGraphClient.js

@@ -324,7 +324,13 @@ export class LangGraphClient extends EventEmitter {
                 this.processStreamChunk(chunk, command);
             }
         }
-        const data = await this.runFETool();
+        const data = (await Promise.race([
+            this.runFETool(),
+            new Promise((res) => {
+                this.forceSkipToolLock = () => res(null);
+            }),
+        ]));
+        this.forceSkipToolLock = undefined;
         await this.responseHumanInTheLoop();
         if (data)
             streamRecord.push(...data);
@@ -421,7 +427,6 @@ export class LangGraphClient extends EventEmitter {
                 // json 校验
                 return this.callFETool(toolMessage, tool.args).catch((e) => console.warn(e));
             });
-            console.log("batch call tools", result.length);
             // 只有当卡住流程时，才改变状态为 interrupted
             this._status = "interrupted";
             this.currentThread.status = "interrupted"; // 修复某些机制下，状态不为 interrupted 与后端有差异
@@ -511,6 +516,8 @@ export class LangGraphClient extends EventEmitter {
             this.resume(result);
         }
     }
+    /** 尝试强制跳过工具调用 */
+    forceSkipToolLock;
     /**
      * @zh 标记人机交互等待已完成。
      * @en Marks the human in the loop waiting as completed.
@@ -520,6 +527,14 @@ export class LangGraphClient extends EventEmitter {
         this.tools.doneWaiting(tool_id, result);
         if (this.humanInTheLoop) {
             this.humanInTheLoop.result[action_request_id] = result;
+            if (Object.keys(this.humanInTheLoop.result).length === this.humanInTheLoop.interruptData.length) {
+                setTimeout(() => {
+                    if (this.forceSkipToolLock) {
+                        console.warn("force kill tool lock");
+                        this.forceSkipToolLock();
+                    }
+                }, 100);
+            }
         }
     }
     /**

package/dist/react/ChatContext.d.ts

@@ -1,5 +1,5 @@
 import { ReactNode } from "react";
-import { UnionStore } from "../ui-store/index.js";
+import { HistoryFilter, UnionStore } from "../ui-store/index.js";
 import { ILangGraphClient } from "@langgraph-js/pure-graph/dist/types.js";
 export declare const useChat: () => UnionStore<{
     data: {
@@ -28,7 +28,7 @@ export declare const useChat: () => UnionStore<{
             messages: import("@langchain/langgraph-sdk").Message[];
         }, unknown>[]> & object;
         historyPagination: import("nanostores").PreinitializedWritableAtom<import("../ui-store/createChatStore.js").HistoryPagination> & object;
-        historyFilter: import("nanostores").PreinitializedWritableAtom<import("../ui-store/createChatStore.js").HistoryFilter> & object;
+        historyFilter: import("nanostores").PreinitializedWritableAtom<HistoryFilter> & object;
     };
     mutations: {
         setCurrentArtifactById: (id: string, tool_id: string) => void;
@@ -66,7 +66,7 @@ export declare const useChat: () => UnionStore<{
         }>): Promise<void>;
         setHistoryPage(page: number): void;
         setHistoryPageSize(pageSize: number): void;
-        setHistoryFilter(filter: Partial<import("../ui-store/createChatStore.js").HistoryFilter>): void;
+        setHistoryFilter(filter: Partial<HistoryFilter>): void;
         resetHistoryFilter(): void;
     };
 }>;
@@ -86,7 +86,9 @@ interface ChatProviderProps {
     client?: ILangGraphClient;
     legacyMode?: boolean;
     /** 历史记录筛选的默认参数 */
-    historyFilter?: import("../ui-store/createChatStore.js").HistoryFilter;
+    historyFilter?: HistoryFilter;
+    /** UI 更新的防抖时间（毫秒，默认 10） */
+    debounceTime?: number;
 }
 export declare const ChatProvider: React.FC<ChatProviderProps>;
 export {};

package/dist/react/ChatContext.js

@@ -9,7 +9,7 @@ export const useChat = () => {
     }
     return context;
 };
-export const ChatProvider = ({ children, defaultAgent = "", apiUrl = "http://localhost:8123", defaultHeaders, withCredentials = false, fetch, showHistory = false, showGraph = false, fallbackToAvailableAssistants = false, autoRestoreLastSession = false, onInitError, client, legacyMode = false, historyFilter, }) => {
+export const ChatProvider = ({ children, defaultAgent = "", apiUrl = "http://localhost:8123", defaultHeaders, withCredentials = false, fetch, showHistory = false, showGraph = false, fallbackToAvailableAssistants = false, autoRestoreLastSession = false, onInitError, client, legacyMode = false, historyFilter, debounceTime, }) => {
     // 使用 useMemo 稳定 defaultHeaders 的引用
     const stableHeaders = useMemo(() => defaultHeaders || {}, [defaultHeaders]);
     // 使用 useRef 保存 onInitError 的最新引用
@@ -43,8 +43,9 @@ export const ChatProvider = ({ children, defaultAgent = "", apiUrl = "http://loc
             fallbackToAvailableAssistants,
             autoRestoreLastSession,
             historyFilter,
+            debounceTime,
         });
-    }, [defaultAgent, apiUrl, stableHeaders, withCredentials, fetch, showHistory, showGraph, fallbackToAvailableAssistants, autoRestoreLastSession, client, legacyMode, historyFilter]);
+    }, [defaultAgent, apiUrl, stableHeaders, withCredentials, fetch, showHistory, showGraph, fallbackToAvailableAssistants, autoRestoreLastSession, client, legacyMode, historyFilter, debounceTime]);
     const unionStore = useUnionStore(store, useStore);
     // 使用 ref 标记是否已初始化
     const initializedRef = useRef(false);

package/dist/solid/ChatContext.d.ts

@@ -1,4 +1,5 @@
 import { type JSX, Accessor } from "solid-js";
+import { HistoryFilter } from "../ui-store/index.js";
 import { ILangGraphClient } from "@langgraph-js/pure-graph/dist/types.js";
 import { PreinitializedWritableAtom, StoreValue } from "nanostores";
 export declare const useChat: () => UnionStoreSolid<{
@@ -28,7 +29,7 @@ export declare const useChat: () => UnionStoreSolid<{
             messages: import("@langchain/langgraph-sdk").Message[];
         }, unknown>[]> & object;
         historyPagination: PreinitializedWritableAtom<import("../ui-store/createChatStore.js").HistoryPagination> & object;
-        historyFilter: PreinitializedWritableAtom<import("../ui-store/createChatStore.js").HistoryFilter> & object;
+        historyFilter: PreinitializedWritableAtom<HistoryFilter> & object;
     };
     mutations: {
         setCurrentArtifactById: (id: string, tool_id: string) => void;
@@ -66,7 +67,7 @@ export declare const useChat: () => UnionStoreSolid<{
         }>): Promise<void>;
         setHistoryPage(page: number): void;
         setHistoryPageSize(pageSize: number): void;
-        setHistoryFilter(filter: Partial<import("../ui-store/createChatStore.js").HistoryFilter>): void;
+        setHistoryFilter(filter: Partial<HistoryFilter>): void;
         resetHistoryFilter(): void;
     };
 }>;
@@ -86,7 +87,9 @@ interface ChatProviderProps {
     client?: ILangGraphClient;
     legacyMode?: boolean;
     /** 历史记录筛选的默认参数 */
-    historyFilter?: import("../ui-store/createChatStore.js").HistoryFilter;
+    historyFilter?: HistoryFilter;
+    /** UI 更新的防抖时间（毫秒，默认 10） */
+    debounceTime?: number;
 }
 /**
  * @zh UnionStore 类型用于合并 store 的 data 和 mutations，使其可以直接访问。

package/dist/solid/ChatContext.js

@@ -54,6 +54,7 @@ export const ChatProvider = (props) => {
             fallbackToAvailableAssistants: props.fallbackToAvailableAssistants || false,
             autoRestoreLastSession: props.autoRestoreLastSession || false,
             historyFilter: props.historyFilter,
+            debounceTime: props.debounceTime,
         });
     });
     const unionStore = useUnionStoreSolid(store(), useStore);

package/dist/tool/ToolUI.d.ts

@@ -8,6 +8,7 @@ export declare class ToolRenderData<I, D> {
     message: RenderMessage;
     client: LangGraphClient;
     constructor(message: RenderMessage, client: LangGraphClient);
+    /** 这个 id 需要联系到 tool call id, 但是很悲哀langgraph 的 hitl interrupt 没有传递任何 id,非常蠢 */
     private getToolActionRequestID;
     /**
      * 获取人机交互数据

package/dist/tool/ToolUI.js

@@ -8,6 +8,7 @@ export class ToolRenderData {
         this.message = message;
         this.client = client;
     }
+    /** 这个 id 需要联系到 tool call id, 但是很悲哀langgraph 的 hitl interrupt 没有传递任何 id,非常蠢 */
     getToolActionRequestID() {
         return createActionRequestID({
             name: this.message.name,
@@ -43,7 +44,7 @@ export class ToolRenderData {
             /**@ts-ignore 修复 sb 的 langchain 官方的命名不统一，我们一致采用下划线版本，而非驼峰版本 */
             response.editedAction = response.edited_action;
         }
-        return this.client.doneHumanInTheLoopWaiting(this.message.id, this.getToolActionRequestID(), response);
+        return this.client.doneHumanInTheLoopWaiting(this.message.id || this.message.tool_call_id, this.getToolActionRequestID(), response);
     }
     get state() {
         if (this.message.type === "tool" && this.message?.additional_kwargs?.done) {

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

@@ -18,6 +18,8 @@ interface ChatStoreContext {
     autoRestoreLastSession?: boolean;
     /** 历史记录筛选的默认参数 */
     historyFilter?: Partial<HistoryFilter>;
+    /** UI 更新的防抖时间（毫秒，默认 10） */
+    debounceTime?: number;
 }
 export interface HistoryPagination {
     page: number;

package/dist/ui-store/createChatStore.js

@@ -105,7 +105,7 @@ export const createChatStore = (initClientName, config, context = {}) => {
         currentNodeName.set(lastMessage?.node_name || lastMessage?.name || "__start__");
         renderMessages.set(messages);
         currentStatus.set(newClient.status);
-    }, 10);
+    }, context.debounceTime ?? 10);
     // ============ 工具和图表辅助函数 ============
     const refreshTools = async () => {
         const c = client.get();

package/dist/vue/ChatContext.d.ts

@@ -1,5 +1,5 @@
 import { type PropType, Ref } from "vue";
-import { createChatStore } from "../ui-store/index.js";
+import { createChatStore, HistoryFilter } from "../ui-store/index.js";
 import { PreinitializedWritableAtom, StoreValue } from "nanostores";
 import { ILangGraphClient } from "@langgraph-js/pure-graph/dist/types.js";
 /**
@@ -40,7 +40,9 @@ export interface ChatProviderProps {
     client?: ILangGraphClient;
     legacyMode?: boolean;
     /** 历史记录筛选的默认参数 */
-    historyFilter?: import("../ui-store/createChatStore.js").HistoryFilter;
+    historyFilter?: HistoryFilter;
+    /** UI 更新的防抖时间（毫秒，默认 10） */
+    debounceTime?: number;
 }
 /**
  * @zh Chat Provider Hook，用于在 setup 中直接使用
@@ -74,7 +76,7 @@ export declare const useChatProvider: (props: ChatProviderProps) => {
                 messages: import("@langchain/langgraph-sdk").Message[];
             }, unknown>[]> & object;
             historyPagination: PreinitializedWritableAtom<import("../ui-store/createChatStore.js").HistoryPagination> & object;
-            historyFilter: PreinitializedWritableAtom<import("../ui-store/createChatStore.js").HistoryFilter> & object;
+            historyFilter: PreinitializedWritableAtom<HistoryFilter> & object;
         };
         mutations: {
             setCurrentArtifactById: (id: string, tool_id: string) => void;
@@ -112,7 +114,7 @@ export declare const useChatProvider: (props: ChatProviderProps) => {
             }>): Promise<void>;
             setHistoryPage(page: number): void;
             setHistoryPageSize(pageSize: number): void;
-            setHistoryFilter(filter: Partial<import("../ui-store/createChatStore.js").HistoryFilter>): void;
+            setHistoryFilter(filter: Partial<HistoryFilter>): void;
             resetHistoryFilter(): void;
         };
     }>;
@@ -162,6 +164,10 @@ export declare const ChatProvider: import("vue").DefineComponent<import("vue").E
         type: PropType<any>;
         default: undefined;
     };
+    debounceTime: {
+        type: PropType<number>;
+        default: undefined;
+    };
 }>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
     [key: string]: any;
 }>[] | undefined, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
@@ -205,6 +211,10 @@ export declare const ChatProvider: import("vue").DefineComponent<import("vue").E
         type: PropType<any>;
         default: undefined;
     };
+    debounceTime: {
+        type: PropType<number>;
+        default: undefined;
+    };
 }>> & Readonly<{}>, {
     apiUrl: string;
     defaultHeaders: Record<string, string>;
@@ -216,4 +226,5 @@ export declare const ChatProvider: import("vue").DefineComponent<import("vue").E
     fetch: typeof fetch;
     autoRestoreLastSession: boolean;
     onInitError: (error: any, currentAgent: string) => void;
+    debounceTime: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/vue/ChatContext.js

@@ -54,6 +54,7 @@ export const useChatProvider = (props) => {
         fallbackToAvailableAssistants: props.fallbackToAvailableAssistants,
         autoRestoreLastSession: props.autoRestoreLastSession,
         historyFilter: props.historyFilter,
+        debounceTime: props.debounceTime,
     });
     const unionStore = useUnionStoreVue(store, useStore);
     // 提供 store 给子组件
@@ -118,6 +119,10 @@ export const ChatProvider = defineComponent({
             type: Object,
             default: undefined,
         },
+        debounceTime: {
+            type: Number,
+            default: undefined,
+        },
     },
     setup(props, { slots }) {
         const { unionStore } = useChatProvider(props);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langgraph-js/sdk",
-  "version": "4.6.3",
+  "version": "4.6.5",
   "description": "The UI SDK for LangGraph - seamlessly integrate your AI agents with frontend interfaces",
   "main": "dist/index.js",
   "type": "module",

package/src/LangGraphClient.ts

@@ -443,7 +443,13 @@ export class LangGraphClient<TStateType = unknown> extends EventEmitter<LangGrap
                 this.processStreamChunk(chunk, command);
             }
         }
-        const data = await this.runFETool();
+        const data = (await Promise.race([
+            this.runFETool(),
+            new Promise((res) => {
+                this.forceSkipToolLock = () => res(null);
+            }),
+        ])) as any[] | null;
+        this.forceSkipToolLock = undefined;
         await this.responseHumanInTheLoop();
         if (data) streamRecord.push(...data);
         this._status = "idle";
@@ -538,7 +544,7 @@ export class LangGraphClient<TStateType = unknown> extends EventEmitter<LangGrap
                 // json 校验
                 return this.callFETool(toolMessage, tool.args).catch((e) => console.warn(e));
             });
-            console.log("batch call tools", result.length);
+
             // 只有当卡住流程时，才改变状态为 interrupted
             this._status = "interrupted";
             this.currentThread!.status = "interrupted"; // 修复某些机制下，状态不为 interrupted 与后端有差异
@@ -632,6 +638,8 @@ export class LangGraphClient<TStateType = unknown> extends EventEmitter<LangGrap
         }
     }
 
+    /** 尝试强制跳过工具调用 */
+    private forceSkipToolLock?: () => void;
     /**
      * @zh 标记人机交互等待已完成。
      * @en Marks the human in the loop waiting as completed.
@@ -641,6 +649,14 @@ export class LangGraphClient<TStateType = unknown> extends EventEmitter<LangGrap
         this.tools.doneWaiting(tool_id, result);
         if (this.humanInTheLoop) {
             this.humanInTheLoop.result[action_request_id] = result;
+            if (Object.keys(this.humanInTheLoop.result).length === this.humanInTheLoop.interruptData.length) {
+                setTimeout(() => {
+                    if (this.forceSkipToolLock) {
+                        console.warn("force kill tool lock");
+                        this.forceSkipToolLock();
+                    }
+                }, 100);
+            }
         }
     }
 

package/src/react/ChatContext.ts

@@ -1,6 +1,6 @@
 import { createElement, createContext, useContext, useMemo, ReactNode, useEffect, useRef } from "react";
 
-import { createChatStore, UnionStore, useUnionStore } from "../ui-store/index.js";
+import { createChatStore, HistoryFilter, UnionStore, useUnionStore } from "../ui-store/index.js";
 import { useStore } from "@nanostores/react";
 import { ILangGraphClient } from "@langgraph-js/pure-graph/dist/types.js";
 
@@ -30,7 +30,9 @@ interface ChatProviderProps {
     client?: ILangGraphClient;
     legacyMode?: boolean;
     /** 历史记录筛选的默认参数 */
-    historyFilter?: import("../ui-store/createChatStore.js").HistoryFilter;
+    historyFilter?: HistoryFilter;
+    /** UI 更新的防抖时间（毫秒，默认 10） */
+    debounceTime?: number;
 }
 
 export const ChatProvider: React.FC<ChatProviderProps> = ({
@@ -48,6 +50,7 @@ export const ChatProvider: React.FC<ChatProviderProps> = ({
     client,
     legacyMode = false,
     historyFilter,
+    debounceTime,
 }) => {
     // 使用 useMemo 稳定 defaultHeaders 的引用
     const stableHeaders = useMemo(() => defaultHeaders || {}, [defaultHeaders]);
@@ -84,8 +87,9 @@ export const ChatProvider: React.FC<ChatProviderProps> = ({
             fallbackToAvailableAssistants,
             autoRestoreLastSession,
             historyFilter,
+            debounceTime,
         });
-    }, [defaultAgent, apiUrl, stableHeaders, withCredentials, fetch, showHistory, showGraph, fallbackToAvailableAssistants, autoRestoreLastSession, client, legacyMode, historyFilter]);
+    }, [defaultAgent, apiUrl, stableHeaders, withCredentials, fetch, showHistory, showGraph, fallbackToAvailableAssistants, autoRestoreLastSession, client, legacyMode, historyFilter, debounceTime]);
 
     const unionStore = useUnionStore(store, useStore);
 

package/src/solid/ChatContext.ts

@@ -1,5 +1,5 @@
 import { createContext, useContext, createMemo, onMount, type JSX, type Component, createComponent, Accessor } from "solid-js";
-import { createChatStore, UnionStore } from "../ui-store/index.js";
+import { createChatStore, HistoryFilter, UnionStore } from "../ui-store/index.js";
 import { useStore } from "@nanostores/solid";
 import { ILangGraphClient } from "@langgraph-js/pure-graph/dist/types.js";
 import { PreinitializedWritableAtom, StoreValue } from "nanostores";
@@ -30,7 +30,9 @@ interface ChatProviderProps {
     client?: ILangGraphClient;
     legacyMode?: boolean;
     /** 历史记录筛选的默认参数 */
-    historyFilter?: import("../ui-store/createChatStore.js").HistoryFilter;
+    historyFilter?: HistoryFilter;
+    /** UI 更新的防抖时间（毫秒，默认 10） */
+    debounceTime?: number;
 }
 /**
  * @zh UnionStore 类型用于合并 store 的 data 和 mutations，使其可以直接访问。
@@ -93,6 +95,7 @@ export const ChatProvider = (props: ChatProviderProps) => {
             fallbackToAvailableAssistants: props.fallbackToAvailableAssistants || false,
             autoRestoreLastSession: props.autoRestoreLastSession || false,
             historyFilter: props.historyFilter,
+            debounceTime: props.debounceTime,
         });
     });
 

package/src/tool/ToolUI.ts

@@ -13,6 +13,7 @@ export class ToolRenderData<I, D> {
         public message: RenderMessage,
         public client: LangGraphClient
     ) {}
+    /** 这个 id 需要联系到 tool call id, 但是很悲哀langgraph 的 hitl interrupt 没有传递任何 id,非常蠢 */
     private getToolActionRequestID() {
         return createActionRequestID({
             name: this.message.name!,
@@ -48,7 +49,7 @@ export class ToolRenderData<I, D> {
             response.editedAction = response.edited_action;
         }
 
-        return this.client.doneHumanInTheLoopWaiting(this.message.id!, this.getToolActionRequestID(), response);
+        return this.client.doneHumanInTheLoopWaiting(this.message.id || this.message.tool_call_id!, this.getToolActionRequestID(), response);
     }
 
     get state() {

package/src/ui-store/createChatStore.ts

@@ -61,6 +61,8 @@ interface ChatStoreContext {
     autoRestoreLastSession?: boolean;
     /** 历史记录筛选的默认参数 */
     historyFilter?: Partial<HistoryFilter>;
+    /** UI 更新的防抖时间（毫秒，默认 10） */
+    debounceTime?: number;
 }
 
 // 分页状态类型
@@ -153,7 +155,7 @@ export const createChatStore = (initClientName: string, config: Partial<LangGrap
         currentNodeName.set(lastMessage?.node_name || lastMessage?.name || "__start__");
         renderMessages.set(messages);
         currentStatus.set(newClient.status);
-    }, 10);
+    }, context.debounceTime ?? 10);
     // ============ 工具和图表辅助函数 ============
 
     const refreshTools = async () => {

package/src/vue/ChatContext.ts

@@ -1,5 +1,5 @@
 import { defineComponent, inject, provide, onMounted, defineExpose, type InjectionKey, type PropType, Ref } from "vue";
-import { createChatStore } from "../ui-store/index.js";
+import { createChatStore, HistoryFilter } from "../ui-store/index.js";
 import { useStore } from "@nanostores/vue";
 import { PreinitializedWritableAtom, StoreValue } from "nanostores";
 import { ILangGraphClient } from "@langgraph-js/pure-graph/dist/types.js";
@@ -62,7 +62,9 @@ export interface ChatProviderProps {
     client?: ILangGraphClient;
     legacyMode?: boolean;
     /** 历史记录筛选的默认参数 */
-    historyFilter?: import("../ui-store/createChatStore.js").HistoryFilter;
+    historyFilter?: HistoryFilter;
+    /** UI 更新的防抖时间（毫秒，默认 10） */
+    debounceTime?: number;
 }
 
 /**
@@ -96,6 +98,7 @@ export const useChatProvider = (props: ChatProviderProps) => {
             fallbackToAvailableAssistants: props.fallbackToAvailableAssistants,
             autoRestoreLastSession: props.autoRestoreLastSession,
             historyFilter: props.historyFilter,
+            debounceTime: props.debounceTime,
         }
     );
 
@@ -166,6 +169,10 @@ export const ChatProvider = defineComponent({
             type: Object as PropType<any>,
             default: undefined,
         },
+        debounceTime: {
+            type: Number as PropType<number>,
+            default: undefined,
+        },
     },
     setup(props, { slots }) {
         const { unionStore } = useChatProvider(props);