@langgraph-js/sdk 4.6.2 → 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;
     };
 }>;
@@ -85,6 +85,10 @@ interface ChatProviderProps {
     onInitError?: (error: any, currentAgent: string) => void;
     client?: ILangGraphClient;
     legacyMode?: boolean;
+    /** 历史记录筛选的默认参数 */
+    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, }) => {
+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 的最新引用
@@ -42,8 +42,10 @@ export const ChatProvider = ({ children, defaultAgent = "", apiUrl = "http://loc
             showGraph,
             fallbackToAvailableAssistants,
             autoRestoreLastSession,
+            historyFilter,
+            debounceTime,
         });
-    }, [defaultAgent, apiUrl, stableHeaders, withCredentials, fetch, showHistory, showGraph, fallbackToAvailableAssistants, autoRestoreLastSession]);
+    }, [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;
     };
 }>;
@@ -85,6 +86,10 @@ interface ChatProviderProps {
     onInitError?: (error: any, currentAgent: string) => void;
     client?: ILangGraphClient;
     legacyMode?: boolean;
+    /** 历史记录筛选的默认参数 */
+    historyFilter?: HistoryFilter;
+    /** UI 更新的防抖时间（毫秒，默认 10） */
+    debounceTime?: number;
 }
 /**
  * @zh UnionStore 类型用于合并 store 的 data 和 mutations，使其可以直接访问。

package/dist/solid/ChatContext.js

@@ -53,6 +53,8 @@ export const ChatProvider = (props) => {
             showGraph: props.showGraph || false,
             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

@@ -16,6 +16,10 @@ interface ChatStoreContext {
     onInit?: (client: LangGraphClient) => void;
     /** 初始化时是否自动激活最近的历史会话（默认 false，创建新会话） */
     autoRestoreLastSession?: boolean;
+    /** 历史记录筛选的默认参数 */
+    historyFilter?: Partial<HistoryFilter>;
+    /** UI 更新的防抖时间（毫秒，默认 10） */
+    debounceTime?: number;
 }
 export interface HistoryPagination {
     page: number;

package/dist/ui-store/createChatStore.js

@@ -76,13 +76,14 @@ export const createChatStore = (initClientName, config, context = {}) => {
         pageSize: 10,
         total: 0,
     });
-    // 历史记录筛选状态
-    const historyFilter = atom({
-        metadata: null,
-        status: null,
-        sortBy: "updated_at",
-        sortOrder: "desc",
-    });
+    // 历史记录筛选状态 - 使用 context 中的默认值
+    const defaultHistoryFilter = {
+        metadata: context.historyFilter?.metadata ?? null,
+        status: context.historyFilter?.status ?? null,
+        sortBy: context.historyFilter?.sortBy ?? "updated_at",
+        sortOrder: context.historyFilter?.sortOrder ?? "desc",
+    };
+    const historyFilter = atom(defaultHistoryFilter);
     // ============ 内部状态 ============
     let cleanupCurrentClient = null;
     // ============ 计算属性 ============
@@ -104,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();
@@ -513,10 +514,7 @@ export const createChatStore = (initClientName, config, context = {}) => {
             },
             resetHistoryFilter() {
                 historyFilter.set({
-                    metadata: null,
-                    status: null,
-                    sortBy: "updated_at",
-                    sortOrder: "desc",
+                    ...defaultHistoryFilter,
                 });
                 historyPagination.set({
                     ...historyPagination.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";
 /**
@@ -39,6 +39,10 @@ export interface ChatProviderProps {
     onInitError?: (error: any, currentAgent: string) => void;
     client?: ILangGraphClient;
     legacyMode?: boolean;
+    /** 历史记录筛选的默认参数 */
+    historyFilter?: HistoryFilter;
+    /** UI 更新的防抖时间（毫秒，默认 10） */
+    debounceTime?: number;
 }
 /**
  * @zh Chat Provider Hook，用于在 setup 中直接使用
@@ -72,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;
@@ -110,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;
         };
     }>;
@@ -156,6 +160,14 @@ export declare const ChatProvider: import("vue").DefineComponent<import("vue").E
         type: PropType<(error: any, currentAgent: string) => void>;
         default: undefined;
     };
+    historyFilter: {
+        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<{
@@ -195,14 +207,24 @@ export declare const ChatProvider: import("vue").DefineComponent<import("vue").E
         type: PropType<(error: any, currentAgent: string) => void>;
         default: undefined;
     };
+    historyFilter: {
+        type: PropType<any>;
+        default: undefined;
+    };
+    debounceTime: {
+        type: PropType<number>;
+        default: undefined;
+    };
 }>> & Readonly<{}>, {
     apiUrl: string;
     defaultHeaders: Record<string, string>;
     showGraph: boolean;
     showHistory: boolean;
+    historyFilter: any;
     defaultAgent: string;
     withCredentials: boolean;
     fetch: typeof fetch;
     autoRestoreLastSession: boolean;
     onInitError: (error: any, currentAgent: string) => void;
+    debounceTime: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/vue/ChatContext.js

@@ -53,6 +53,8 @@ export const useChatProvider = (props) => {
         showGraph: props.showGraph,
         fallbackToAvailableAssistants: props.fallbackToAvailableAssistants,
         autoRestoreLastSession: props.autoRestoreLastSession,
+        historyFilter: props.historyFilter,
+        debounceTime: props.debounceTime,
     });
     const unionStore = useUnionStoreVue(store, useStore);
     // 提供 store 给子组件
@@ -113,6 +115,14 @@ export const ChatProvider = defineComponent({
             type: Function,
             default: undefined,
         },
+        historyFilter: {
+            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.2",
+  "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";
 
@@ -29,6 +29,10 @@ interface ChatProviderProps {
     onInitError?: (error: any, currentAgent: string) => void;
     client?: ILangGraphClient;
     legacyMode?: boolean;
+    /** 历史记录筛选的默认参数 */
+    historyFilter?: HistoryFilter;
+    /** UI 更新的防抖时间（毫秒，默认 10） */
+    debounceTime?: number;
 }
 
 export const ChatProvider: React.FC<ChatProviderProps> = ({
@@ -45,6 +49,8 @@ export const ChatProvider: React.FC<ChatProviderProps> = ({
     onInitError,
     client,
     legacyMode = false,
+    historyFilter,
+    debounceTime,
 }) => {
     // 使用 useMemo 稳定 defaultHeaders 的引用
     const stableHeaders = useMemo(() => defaultHeaders || {}, [defaultHeaders]);
@@ -80,8 +86,10 @@ export const ChatProvider: React.FC<ChatProviderProps> = ({
             showGraph,
             fallbackToAvailableAssistants,
             autoRestoreLastSession,
+            historyFilter,
+            debounceTime,
         });
-    }, [defaultAgent, apiUrl, stableHeaders, withCredentials, fetch, showHistory, showGraph, fallbackToAvailableAssistants, autoRestoreLastSession]);
+    }, [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";
@@ -29,6 +29,10 @@ interface ChatProviderProps {
     onInitError?: (error: any, currentAgent: string) => void;
     client?: ILangGraphClient;
     legacyMode?: boolean;
+    /** 历史记录筛选的默认参数 */
+    historyFilter?: HistoryFilter;
+    /** UI 更新的防抖时间（毫秒，默认 10） */
+    debounceTime?: number;
 }
 /**
  * @zh UnionStore 类型用于合并 store 的 data 和 mutations，使其可以直接访问。
@@ -90,6 +94,8 @@ export const ChatProvider = (props: ChatProviderProps) => {
             showGraph: props.showGraph || false,
             fallbackToAvailableAssistants: props.fallbackToAvailableAssistants || false,
             autoRestoreLastSession: props.autoRestoreLastSession || false,
+            historyFilter: props.historyFilter,
+            debounceTime: props.debounceTime,
         });
     });
 

package/src/ui-store/createChatStore.ts

@@ -59,6 +59,10 @@ interface ChatStoreContext {
     onInit?: (client: LangGraphClient) => void;
     /** 初始化时是否自动激活最近的历史会话（默认 false，创建新会话） */
     autoRestoreLastSession?: boolean;
+    /** 历史记录筛选的默认参数 */
+    historyFilter?: Partial<HistoryFilter>;
+    /** UI 更新的防抖时间（毫秒，默认 10） */
+    debounceTime?: number;
 }
 
 // 分页状态类型
@@ -113,13 +117,15 @@ export const createChatStore = (initClientName: string, config: Partial<LangGrap
         total: 0,
     });
 
-    // 历史记录筛选状态
-    const historyFilter = atom<HistoryFilter>({
-        metadata: null,
-        status: null,
-        sortBy: "updated_at",
-        sortOrder: "desc",
-    });
+    // 历史记录筛选状态 - 使用 context 中的默认值
+    const defaultHistoryFilter: HistoryFilter = {
+        metadata: context.historyFilter?.metadata ?? null,
+        status: context.historyFilter?.status ?? null,
+        sortBy: context.historyFilter?.sortBy ?? "updated_at",
+        sortOrder: context.historyFilter?.sortOrder ?? "desc",
+    };
+
+    const historyFilter = atom<HistoryFilter>(defaultHistoryFilter);
 
     // ============ 内部状态 ============
 
@@ -149,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 () => {
@@ -611,10 +617,7 @@ export const createChatStore = (initClientName: string, config: Partial<LangGrap
             },
             resetHistoryFilter() {
                 historyFilter.set({
-                    metadata: null,
-                    status: null,
-                    sortBy: "updated_at",
-                    sortOrder: "desc",
+                    ...defaultHistoryFilter,
                 });
                 historyPagination.set({
                     ...historyPagination.get(),

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";
@@ -61,6 +61,10 @@ export interface ChatProviderProps {
     onInitError?: (error: any, currentAgent: string) => void;
     client?: ILangGraphClient;
     legacyMode?: boolean;
+    /** 历史记录筛选的默认参数 */
+    historyFilter?: HistoryFilter;
+    /** UI 更新的防抖时间（毫秒，默认 10） */
+    debounceTime?: number;
 }
 
 /**
@@ -93,6 +97,8 @@ export const useChatProvider = (props: ChatProviderProps) => {
             showGraph: props.showGraph,
             fallbackToAvailableAssistants: props.fallbackToAvailableAssistants,
             autoRestoreLastSession: props.autoRestoreLastSession,
+            historyFilter: props.historyFilter,
+            debounceTime: props.debounceTime,
         }
     );
 
@@ -159,6 +165,14 @@ export const ChatProvider = defineComponent({
             type: Function as PropType<(error: any, currentAgent: string) => void>,
             default: undefined,
         },
+        historyFilter: {
+            type: Object as PropType<any>,
+            default: undefined,
+        },
+        debounceTime: {
+            type: Number as PropType<number>,
+            default: undefined,
+        },
     },
     setup(props, { slots }) {
         const { unionStore } = useChatProvider(props);