@langgraph-js/sdk 4.6.3 → 4.6.4

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/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.4",
   "description": "The UI SDK for LangGraph - seamlessly integrate your AI agents with frontend interfaces",
   "main": "dist/index.js",
   "type": "module",

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/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);