@langgraph-js/sdk 4.6.0 → 4.6.2

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @langgraph-js/sdk@4.6.0 build /Users/konghayao/code/ai/YaoAgent/apps/langgraph-client
+> tsc
+

package/dist/History.d.ts

@@ -9,6 +9,8 @@ export interface SessionInfo {
     thread?: Thread<any>;
     /** Agent 名称 */
     agentName: string;
+    /** 会话元数据 */
+    metadata?: Record<string, any>;
 }
 export interface CreateSessionOptions {
     /** 会话 ID / Thread ID，不提供则自动生成 */
@@ -19,6 +21,8 @@ export interface CreateSessionOptions {
     restore?: boolean;
     /** Graph ID */
     graphId?: string;
+    /** 会话元数据 */
+    metadata?: Record<string, any>;
 }
 /**
  * @zh History 类用于管理多个 LangGraphClient 实例，支持多会话场景

package/dist/History.js

@@ -32,6 +32,7 @@ export class History {
         const sessionInfo = {
             sessionId,
             agentName,
+            metadata: options.metadata,
         };
         // 如果是从已有 Thread 恢复，则立即获取 Thread
         if (options.restore) {
@@ -54,8 +55,14 @@ export class History {
         if (!session.client) {
             const client = new LangGraphClient(this.clientConfig);
             await client.initAssistant(session.agentName);
-            // 只有在有 thread 的情况下才重置（恢复已有会话）
-            // 新会话的 thread 会在发送第一条消息时自动创建
+            // 如果有 metadata，立即创建 Thread 并带上 metadata
+            if (session.metadata && !session.thread) {
+                await client.createThread({
+                    graphId: client.getCurrentAssistant()?.graph_id,
+                    metadata: session.metadata,
+                });
+            }
+            // 如果已有 thread 或者必须重置，则从历史恢复
             if (session.thread || mustResetStream) {
                 await client.resetThread(session.agentName, sessionId);
             }

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>;
@@ -43,6 +45,7 @@ export type SendMessageOptions = {
     };
     command?: Command;
     joinRunId?: string;
+    metadata?: Record<string, any>;
 };
 export interface LangGraphClientConfig {
     apiUrl?: string;
@@ -182,9 +185,10 @@ export declare class LangGraphClient<TStateType = unknown> extends EventEmitter<
      * @zh 创建一个新的 Thread。
      * @en Creates a new Thread.
      */
-    createThread({ threadId, graphId }?: {
+    createThread({ threadId, graphId, metadata }?: {
         threadId?: string;
         graphId?: string;
+        metadata?: Record<string, any>;
     }): Promise<Thread<TStateType, unknown>>;
     graphVisualize(): Promise<import("@langchain/langgraph-sdk").AssistantGraph>;
     /**
@@ -247,7 +251,7 @@ export declare class LangGraphClient<TStateType = unknown> extends EventEmitter<
      * @zh 发送消息到 LangGraph 后端。
      * @en Sends a message to the LangGraph backend.
      */
-    sendMessage(input: string | Message[], { joinRunId, extraParams, _debug, command }?: SendMessageOptions): Promise<any[]>;
+    sendMessage(input: string | Message[], { joinRunId, extraParams, _debug, command, metadata }?: SendMessageOptions): Promise<any[]>;
     /** 当前子图位置，但是依赖 stream，不太适合稳定使用*/
     private graphPosition;
     getGraphPosition(): {

package/dist/LangGraphClient.js

@@ -89,9 +89,10 @@ export class LangGraphClient extends EventEmitter {
      * @zh 创建一个新的 Thread。
      * @en Creates a new Thread.
      */
-    async createThread({ threadId, graphId } = {}) {
+    async createThread({ threadId, graphId, metadata } = {}) {
         try {
             this.currentThread = await this.threads.create({
+                metadata,
                 threadId,
                 graphId,
             });
@@ -249,12 +250,15 @@ export class LangGraphClient extends EventEmitter {
      * @zh 发送消息到 LangGraph 后端。
      * @en Sends a message to the LangGraph backend.
      */
-    async sendMessage(input, { joinRunId, extraParams, _debug, command } = {}) {
+    async sendMessage(input, { joinRunId, extraParams, _debug, command, metadata } = {}) {
         if (!this.currentAssistant) {
             throw new Error("Thread or Assistant not initialized");
         }
         if (!this.currentThread) {
-            await this.createThread({ graphId: this.currentAssistant.graph_id });
+            await this.createThread({
+                graphId: this.currentAssistant.graph_id,
+                metadata,
+            });
             this.emit("thread", {
                 event: "thread/create",
                 data: {

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

@@ -40,7 +40,7 @@ export declare const useChat: () => UnionStore<{
         createNewSession: () => Promise<void>;
         refreshSessionList: () => Promise<void>;
         refreshHistoryList: () => Promise<void>;
-        sendMessage: (message?: import("@langchain/langgraph-sdk").Message[], extraData?: import("../LangGraphClient.js").SendMessageOptions, withoutCheck?: boolean, isResume?: boolean) => Promise<void>;
+        sendMessage: (message?: import("@langchain/langgraph-sdk").Message[], options?: import("../LangGraphClient.js").SendMessageOptions, withoutCheck?: boolean, isResume?: boolean) => Promise<void>;
         stopGeneration: () => void;
         setUserInput: (input: string) => void;
         revertChatTo(messageId: string, resend?: boolean, sendOptions?: import("../LangGraphClient.js").SendMessageOptions & import("../time-travel/index.js").RevertChatToOptions): Promise<void>;
@@ -57,7 +57,7 @@ export declare const useChat: () => UnionStore<{
         addToHistory: (thread: import("@langchain/langgraph-sdk").Thread<{
             messages: import("@langchain/langgraph-sdk").Message[];
         }>) => void;
-        createNewChat: () => Promise<void>;
+        createNewChat(metadata?: Record<string, any>): Promise<void>;
         toHistoryChat: (thread: import("@langchain/langgraph-sdk").Thread<{
             messages: import("@langchain/langgraph-sdk").Message[];
         }>) => Promise<void>;

package/dist/solid/ChatContext.d.ts

@@ -40,7 +40,7 @@ export declare const useChat: () => UnionStoreSolid<{
         createNewSession: () => Promise<void>;
         refreshSessionList: () => Promise<void>;
         refreshHistoryList: () => Promise<void>;
-        sendMessage: (message?: import("@langchain/langgraph-sdk").Message[], extraData?: import("../LangGraphClient.js").SendMessageOptions, withoutCheck?: boolean, isResume?: boolean) => Promise<void>;
+        sendMessage: (message?: import("@langchain/langgraph-sdk").Message[], options?: import("../LangGraphClient.js").SendMessageOptions, withoutCheck?: boolean, isResume?: boolean) => Promise<void>;
         stopGeneration: () => void;
         setUserInput: (input: string) => void;
         revertChatTo(messageId: string, resend?: boolean, sendOptions?: import("../LangGraphClient.js").SendMessageOptions & import("../time-travel/index.js").RevertChatToOptions): Promise<void>;
@@ -57,7 +57,7 @@ export declare const useChat: () => UnionStoreSolid<{
         addToHistory: (thread: import("@langchain/langgraph-sdk").Thread<{
             messages: import("@langchain/langgraph-sdk").Message[];
         }>) => void;
-        createNewChat: () => Promise<void>;
+        createNewChat(metadata?: Record<string, any>): Promise<void>;
         toHistoryChat: (thread: import("@langchain/langgraph-sdk").Thread<{
             messages: import("@langchain/langgraph-sdk").Message[];
         }>) => Promise<void>;

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

@@ -67,7 +67,7 @@ export declare const createChatStore: (initClientName: string, config: Partial<L
         createNewSession: () => Promise<void>;
         refreshSessionList: () => Promise<void>;
         refreshHistoryList: () => Promise<void>;
-        sendMessage: (message?: Message[], extraData?: SendMessageOptions, withoutCheck?: boolean, isResume?: boolean) => Promise<void>;
+        sendMessage: (message?: Message[], options?: SendMessageOptions, withoutCheck?: boolean, isResume?: boolean) => Promise<void>;
         stopGeneration: () => void;
         setUserInput: (input: string) => void;
         revertChatTo(messageId: string, resend?: boolean, sendOptions?: SendMessageOptions & RevertChatToOptions): Promise<void>;
@@ -84,7 +84,7 @@ export declare const createChatStore: (initClientName: string, config: Partial<L
         addToHistory: (thread: Thread<{
             messages: Message[];
         }>) => void;
-        createNewChat: () => Promise<void>;
+        createNewChat(metadata?: Record<string, any>): Promise<void>;
         toHistoryChat: (thread: Thread<{
             messages: Message[];
         }>) => Promise<void>;

package/dist/ui-store/createChatStore.js

@@ -171,6 +171,7 @@ export const createChatStore = (initClientName, config, context = {}) => {
                 sessionId: thread.thread_id,
                 thread,
                 agentName: currentAgent.get(),
+                metadata: thread.metadata,
             })));
             historyList.set(threads);
             // 更新分页状态（注意：这里只是估计值，实际总数可能需要从后端获取）
@@ -324,7 +325,7 @@ export const createChatStore = (initClientName, config, context = {}) => {
         }
     }
     // ============ 消息和交互逻辑 ============
-    async function sendMessage(message, extraData, withoutCheck = false, isResume = false) {
+    async function sendMessage(message, options, withoutCheck = false, isResume = false) {
         const c = client.get();
         if ((!withoutCheck && !userInput.get().trim() && !message?.length) || !c)
             return;
@@ -334,7 +335,7 @@ export const createChatStore = (initClientName, config, context = {}) => {
         inChatError.set(null);
         try {
             loading.set(true);
-            await c.sendMessage(message || userInput.get(), extraData);
+            await c.sendMessage(message || userInput.get(), options);
         }
         catch (e) {
             const isThreadRunning = e.message.includes("422");
@@ -461,7 +462,20 @@ export const createChatStore = (initClientName, config, context = {}) => {
             },
             // 历史记录（兼容旧 API）
             addToHistory,
-            createNewChat: createNewSession,
+            async createNewChat(metadata) {
+                const historyManager = history.get();
+                if (!historyManager)
+                    return;
+                try {
+                    const session = await historyManager.createSession({ metadata });
+                    await refreshSessionList();
+                    await activateSession(session.sessionId);
+                }
+                catch (error) {
+                    console.error("Failed to create new chat:", error);
+                    inChatError.set(error.message);
+                }
+            },
             toHistoryChat: (thread) => activateSession(thread.thread_id, true),
             async deleteHistoryChat(thread) {
                 const historyManager = history.get();

package/dist/vue/ChatContext.d.ts

@@ -84,7 +84,7 @@ export declare const useChatProvider: (props: ChatProviderProps) => {
             createNewSession: () => Promise<void>;
             refreshSessionList: () => Promise<void>;
             refreshHistoryList: () => Promise<void>;
-            sendMessage: (message?: import("@langchain/langgraph-sdk").Message[], extraData?: import("../LangGraphClient.js").SendMessageOptions, withoutCheck?: boolean, isResume?: boolean) => Promise<void>;
+            sendMessage: (message?: import("@langchain/langgraph-sdk").Message[], options?: import("../LangGraphClient.js").SendMessageOptions, withoutCheck?: boolean, isResume?: boolean) => Promise<void>;
             stopGeneration: () => void;
             setUserInput: (input: string) => void;
             revertChatTo(messageId: string, resend?: boolean, sendOptions?: import("../LangGraphClient.js").SendMessageOptions & import("../time-travel/index.js").RevertChatToOptions): Promise<void>;
@@ -101,7 +101,7 @@ export declare const useChatProvider: (props: ChatProviderProps) => {
             addToHistory: (thread: import("@langchain/langgraph-sdk").Thread<{
                 messages: import("@langchain/langgraph-sdk").Message[];
             }>) => void;
-            createNewChat: () => Promise<void>;
+            createNewChat(metadata?: Record<string, any>): Promise<void>;
             toHistoryChat: (thread: import("@langchain/langgraph-sdk").Thread<{
                 messages: import("@langchain/langgraph-sdk").Message[];
             }>) => Promise<void>;

package/package.json

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

package/src/History.ts

@@ -10,6 +10,8 @@ export interface SessionInfo {
     thread?: Thread<any>;
     /** Agent 名称 */
     agentName: string;
+    /** 会话元数据 */
+    metadata?: Record<string, any>;
 }
 
 export interface CreateSessionOptions {
@@ -21,6 +23,8 @@ export interface CreateSessionOptions {
     restore?: boolean;
     /** Graph ID */
     graphId?: string;
+    /** 会话元数据 */
+    metadata?: Record<string, any>;
 }
 
 /**
@@ -61,6 +65,7 @@ export class History {
         const sessionInfo: SessionInfo = {
             sessionId,
             agentName,
+            metadata: options.metadata,
         };
 
         // 如果是从已有 Thread 恢复，则立即获取 Thread
@@ -89,8 +94,15 @@ export class History {
             const client = new LangGraphClient(this.clientConfig);
             await client.initAssistant(session.agentName);
 
-            // 只有在有 thread 的情况下才重置（恢复已有会话）
-            // 新会话的 thread 会在发送第一条消息时自动创建
+            // 如果有 metadata，立即创建 Thread 并带上 metadata
+            if (session.metadata && !session.thread) {
+                await client.createThread({ 
+                    graphId: client.getCurrentAssistant()?.graph_id,
+                    metadata: session.metadata,
+                });
+            }
+
+            // 如果已有 thread 或者必须重置，则从历史恢复
             if (session.thread || mustResetStream) {
                 await client.resetThread(session.agentName, sessionId);
             }

package/src/LangGraphClient.ts

@@ -40,12 +40,15 @@ export type RenderMessage = Message & {
     unique_id?: string;
     /** 工具调用是否完成 */
     done?: boolean;
+    /** 标记工具消息的原始 ai 消息 */
+    source_ai_message_id?: string;
 };
 export type SendMessageOptions = {
     extraParams?: Record<string, any>;
     _debug?: { streamResponse?: any };
     command?: Command;
     joinRunId?: string;
+    metadata?: Record<string, any>;
 };
 
 export interface LangGraphClientConfig {
@@ -188,9 +191,10 @@ export class LangGraphClient<TStateType = unknown> extends EventEmitter<LangGrap
      * @zh 创建一个新的 Thread。
      * @en Creates a new Thread.
      */
-    async createThread({ threadId, graphId }: { threadId?: string; graphId?: string } = {}) {
+    async createThread({ threadId, graphId, metadata }: { threadId?: string; graphId?: string; metadata?: Record<string, any> } = {}) {
         try {
             this.currentThread = await this.threads.create({
+                metadata,
                 threadId,
                 graphId,
             });
@@ -363,12 +367,15 @@ export class LangGraphClient<TStateType = unknown> extends EventEmitter<LangGrap
      * @zh 发送消息到 LangGraph 后端。
      * @en Sends a message to the LangGraph backend.
      */
-    async sendMessage(input: string | Message[], { joinRunId, extraParams, _debug, command }: SendMessageOptions = {}) {
+    async sendMessage(input: string | Message[], { joinRunId, extraParams, _debug, command, metadata }: SendMessageOptions = {}) {
         if (!this.currentAssistant) {
             throw new Error("Thread or Assistant not initialized");
         }
         if (!this.currentThread) {
-            await this.createThread({ graphId: this.currentAssistant!.graph_id! });
+            await this.createThread({
+                graphId: this.currentAssistant!.graph_id!,
+                metadata,
+            });
             this.emit("thread", {
                 event: "thread/create",
                 data: {

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/ui-store/createChatStore.ts

@@ -227,6 +227,7 @@ export const createChatStore = (initClientName: string, config: Partial<LangGrap
                             sessionId: thread.thread_id,
                             thread,
                             agentName: currentAgent.get(),
+                            metadata: thread.metadata as Record<string, any> | undefined,
                         }) as SessionInfo
                 )
             );
@@ -405,7 +406,7 @@ export const createChatStore = (initClientName: string, config: Partial<LangGrap
 
     // ============ 消息和交互逻辑 ============
 
-    async function sendMessage(message?: Message[], extraData?: SendMessageOptions, withoutCheck = false, isResume = false) {
+    async function sendMessage(message?: Message[], options?: SendMessageOptions, withoutCheck = false, isResume = false) {
         const c = client.get();
         if ((!withoutCheck && !userInput.get().trim() && !message?.length) || !c) return;
 
@@ -415,7 +416,7 @@ export const createChatStore = (initClientName: string, config: Partial<LangGrap
         inChatError.set(null);
         try {
             loading.set(true);
-            await c.sendMessage(message || userInput.get(), extraData);
+            await c.sendMessage(message || userInput.get(), options);
         } catch (e) {
             const isThreadRunning = (e as Error).message.includes("422");
             if (isThreadRunning) {
@@ -559,7 +560,19 @@ export const createChatStore = (initClientName: string, config: Partial<LangGrap
             },
             // 历史记录（兼容旧 API）
             addToHistory,
-            createNewChat: createNewSession,
+            async createNewChat(metadata?: Record<string, any>) {
+                const historyManager = history.get();
+                if (!historyManager) return;
+
+                try {
+                    const session = await historyManager.createSession({ metadata });
+                    await refreshSessionList();
+                    await activateSession(session.sessionId);
+                } catch (error) {
+                    console.error("Failed to create new chat:", error);
+                    inChatError.set((error as Error).message);
+                }
+            },
             toHistoryChat: (thread: Thread<{ messages: Message[] }>) => activateSession(thread.thread_id, true),
             async deleteHistoryChat(thread: Thread<{ messages: Message[] }>) {
                 const historyManager = history.get();