@langgraph-js/sdk 4.6.2 → 4.6.3

package/dist/react/ChatContext.d.ts

@@ -85,6 +85,8 @@ interface ChatProviderProps {
     onInitError?: (error: any, currentAgent: string) => void;
     client?: ILangGraphClient;
     legacyMode?: boolean;
+    /** 历史记录筛选的默认参数 */
+    historyFilter?: import("../ui-store/createChatStore.js").HistoryFilter;
 }
 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, }) => {
     // 使用 useMemo 稳定 defaultHeaders 的引用
     const stableHeaders = useMemo(() => defaultHeaders || {}, [defaultHeaders]);
     // 使用 useRef 保存 onInitError 的最新引用
@@ -42,8 +42,9 @@ export const ChatProvider = ({ children, defaultAgent = "", apiUrl = "http://loc
             showGraph,
             fallbackToAvailableAssistants,
             autoRestoreLastSession,
+            historyFilter,
         });
-    }, [defaultAgent, apiUrl, stableHeaders, withCredentials, fetch, showHistory, showGraph, fallbackToAvailableAssistants, autoRestoreLastSession]);
+    }, [defaultAgent, apiUrl, stableHeaders, withCredentials, fetch, showHistory, showGraph, fallbackToAvailableAssistants, autoRestoreLastSession, client, legacyMode, historyFilter]);
     const unionStore = useUnionStore(store, useStore);
     // 使用 ref 标记是否已初始化
     const initializedRef = useRef(false);

package/dist/solid/ChatContext.d.ts

@@ -85,6 +85,8 @@ interface ChatProviderProps {
     onInitError?: (error: any, currentAgent: string) => void;
     client?: ILangGraphClient;
     legacyMode?: boolean;
+    /** 历史记录筛选的默认参数 */
+    historyFilter?: import("../ui-store/createChatStore.js").HistoryFilter;
 }
 /**
  * @zh UnionStore 类型用于合并 store 的 data 和 mutations，使其可以直接访问。

package/dist/solid/ChatContext.js

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

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

@@ -16,6 +16,8 @@ interface ChatStoreContext {
     onInit?: (client: LangGraphClient) => void;
     /** 初始化时是否自动激活最近的历史会话（默认 false，创建新会话） */
     autoRestoreLastSession?: boolean;
+    /** 历史记录筛选的默认参数 */
+    historyFilter?: Partial<HistoryFilter>;
 }
 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;
     // ============ 计算属性 ============
@@ -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

@@ -39,6 +39,8 @@ export interface ChatProviderProps {
     onInitError?: (error: any, currentAgent: string) => void;
     client?: ILangGraphClient;
     legacyMode?: boolean;
+    /** 历史记录筛选的默认参数 */
+    historyFilter?: import("../ui-store/createChatStore.js").HistoryFilter;
 }
 /**
  * @zh Chat Provider Hook，用于在 setup 中直接使用
@@ -156,6 +158,10 @@ 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;
+    };
 }>, () => 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,11 +201,16 @@ 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;
+    };
 }>> & Readonly<{}>, {
     apiUrl: string;
     defaultHeaders: Record<string, string>;
     showGraph: boolean;
     showHistory: boolean;
+    historyFilter: any;
     defaultAgent: string;
     withCredentials: boolean;
     fetch: typeof fetch;

package/dist/vue/ChatContext.js

@@ -53,6 +53,7 @@ export const useChatProvider = (props) => {
         showGraph: props.showGraph,
         fallbackToAvailableAssistants: props.fallbackToAvailableAssistants,
         autoRestoreLastSession: props.autoRestoreLastSession,
+        historyFilter: props.historyFilter,
     });
     const unionStore = useUnionStoreVue(store, useStore);
     // 提供 store 给子组件
@@ -113,6 +114,10 @@ export const ChatProvider = defineComponent({
             type: Function,
             default: undefined,
         },
+        historyFilter: {
+            type: Object,
+            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.3",
   "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

@@ -29,6 +29,8 @@ interface ChatProviderProps {
     onInitError?: (error: any, currentAgent: string) => void;
     client?: ILangGraphClient;
     legacyMode?: boolean;
+    /** 历史记录筛选的默认参数 */
+    historyFilter?: import("../ui-store/createChatStore.js").HistoryFilter;
 }
 
 export const ChatProvider: React.FC<ChatProviderProps> = ({
@@ -45,6 +47,7 @@ export const ChatProvider: React.FC<ChatProviderProps> = ({
     onInitError,
     client,
     legacyMode = false,
+    historyFilter,
 }) => {
     // 使用 useMemo 稳定 defaultHeaders 的引用
     const stableHeaders = useMemo(() => defaultHeaders || {}, [defaultHeaders]);
@@ -80,8 +83,9 @@ export const ChatProvider: React.FC<ChatProviderProps> = ({
             showGraph,
             fallbackToAvailableAssistants,
             autoRestoreLastSession,
+            historyFilter,
         });
-    }, [defaultAgent, apiUrl, stableHeaders, withCredentials, fetch, showHistory, showGraph, fallbackToAvailableAssistants, autoRestoreLastSession]);
+    }, [defaultAgent, apiUrl, stableHeaders, withCredentials, fetch, showHistory, showGraph, fallbackToAvailableAssistants, autoRestoreLastSession, client, legacyMode, historyFilter]);
 
     const unionStore = useUnionStore(store, useStore);
 

package/src/solid/ChatContext.ts

@@ -29,6 +29,8 @@ interface ChatProviderProps {
     onInitError?: (error: any, currentAgent: string) => void;
     client?: ILangGraphClient;
     legacyMode?: boolean;
+    /** 历史记录筛选的默认参数 */
+    historyFilter?: import("../ui-store/createChatStore.js").HistoryFilter;
 }
 /**
  * @zh UnionStore 类型用于合并 store 的 data 和 mutations，使其可以直接访问。
@@ -90,6 +92,7 @@ export const ChatProvider = (props: ChatProviderProps) => {
             showGraph: props.showGraph || false,
             fallbackToAvailableAssistants: props.fallbackToAvailableAssistants || false,
             autoRestoreLastSession: props.autoRestoreLastSession || false,
+            historyFilter: props.historyFilter,
         });
     });
 

package/src/ui-store/createChatStore.ts

@@ -59,6 +59,8 @@ interface ChatStoreContext {
     onInit?: (client: LangGraphClient) => void;
     /** 初始化时是否自动激活最近的历史会话（默认 false，创建新会话） */
     autoRestoreLastSession?: boolean;
+    /** 历史记录筛选的默认参数 */
+    historyFilter?: Partial<HistoryFilter>;
 }
 
 // 分页状态类型
@@ -113,13 +115,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);
 
     // ============ 内部状态 ============
 
@@ -611,10 +615,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

@@ -61,6 +61,8 @@ export interface ChatProviderProps {
     onInitError?: (error: any, currentAgent: string) => void;
     client?: ILangGraphClient;
     legacyMode?: boolean;
+    /** 历史记录筛选的默认参数 */
+    historyFilter?: import("../ui-store/createChatStore.js").HistoryFilter;
 }
 
 /**
@@ -93,6 +95,7 @@ export const useChatProvider = (props: ChatProviderProps) => {
             showGraph: props.showGraph,
             fallbackToAvailableAssistants: props.fallbackToAvailableAssistants,
             autoRestoreLastSession: props.autoRestoreLastSession,
+            historyFilter: props.historyFilter,
         }
     );
 
@@ -159,6 +162,10 @@ export const ChatProvider = defineComponent({
             type: Function as PropType<(error: any, currentAgent: string) => void>,
             default: undefined,
         },
+        historyFilter: {
+            type: Object as PropType<any>,
+            default: undefined,
+        },
     },
     setup(props, { slots }) {
         const { unionStore } = useChatProvider(props);