@langgraph-js/sdk 4.6.1 → 4.6.3

package/dist/LangGraphClient.d.ts

@@ -35,6 +35,8 @@ export type RenderMessage = Message & {
     unique_id?: string;
     /** 工具调用是否完成 */
     done?: boolean;
+    /** 标记工具消息的原始 ai 消息 */
+    source_ai_message_id?: string;
 };
 export type SendMessageOptions = {
     extraParams?: Record<string, any>;
@@ -157,7 +159,7 @@ export declare class LangGraphClient<TStateType = unknown> extends EventEmitter<
         }): Promise<Thread<TStateType, unknown>>;
         search(query?: {
             metadata?: import("@langchain/langgraph-sdk").Metadata;
-            limit? /** 自定义客户端实现，如果不提供则使用官方 Client */: number;
+            limit?: number;
             offset?: number;
             status?: import("@langchain/langgraph-sdk").ThreadStatus;
             sortBy?: import("@langgraph-js/pure-graph/dist/types.js").ThreadSortBy;

package/dist/MessageProcessor.js

@@ -162,6 +162,8 @@ export class MessageProcessor {
                 if (parentMessage) {
                     message.usage_metadata = parentMessage.usage_metadata;
                     message.node_name = parentMessage.name;
+                    /** @ts-ignore 用于标记原始的 AI message 的id */
+                    message.source_ai_message_id = parentMessage.id;
                     // 修补特殊情况下，tool name 丢失的问题
                     if (!message.name) {
                         message.name = parentMessage.tool_calls.find((i) => i.id === message.tool_call_id)?.name;
@@ -251,10 +253,11 @@ export class MessageProcessor {
         const childrenMap = state_sub_messages_map;
         const rootMessages = [];
         for (const message of messages) {
-            const isRoot = !nonRootMessageId.has(message.id);
+            const sourceId = message.source_ai_message_id || message.id;
+            const isRoot = !nonRootMessageId.has(sourceId);
             if (!isRoot) {
                 // 处理子消息
-                const parentId = parentPointer.get(message.id);
+                const parentId = parentPointer.get(sourceId);
                 const children = childrenMap.get(parentId);
                 if (children) {
                     children.push(message);

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.1",
+  "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/LangGraphClient.ts

@@ -40,6 +40,8 @@ export type RenderMessage = Message & {
     unique_id?: string;
     /** 工具调用是否完成 */
     done?: boolean;
+    /** 标记工具消息的原始 ai 消息 */
+    source_ai_message_id?: string;
 };
 export type SendMessageOptions = {
     extraParams?: Record<string, any>;
@@ -370,7 +372,7 @@ export class LangGraphClient<TStateType = unknown> extends EventEmitter<LangGrap
             throw new Error("Thread or Assistant not initialized");
         }
         if (!this.currentThread) {
-            await this.createThread({ 
+            await this.createThread({
                 graphId: this.currentAssistant!.graph_id!,
                 metadata,
             });

package/src/MessageProcessor.ts

@@ -184,6 +184,8 @@ export class MessageProcessor {
                 if (parentMessage) {
                     message.usage_metadata = parentMessage.usage_metadata;
                     message.node_name = parentMessage.name;
+                    /** @ts-ignore 用于标记原始的 AI message 的id */
+                    message.source_ai_message_id = parentMessage.id;
                     // 修补特殊情况下，tool name 丢失的问题
                     if (!message.name) {
                         message.name = (parentMessage as AIMessage).tool_calls!.find((i) => i.id === message.tool_call_id)?.name;
@@ -294,10 +296,11 @@ export class MessageProcessor {
         const rootMessages: RenderMessage[] = [];
 
         for (const message of messages) {
-            const isRoot = !nonRootMessageId.has(message.id!);
+            const sourceId = message.source_ai_message_id || message.id!;
+            const isRoot = !nonRootMessageId.has(sourceId!);
             if (!isRoot) {
                 // 处理子消息
-                const parentId = parentPointer.get(message.id!)!;
+                const parentId = parentPointer.get(sourceId)!;
                 const children = childrenMap.get(parentId);
                 if (children) {
                     children.push(message);

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