@langgraph-js/sdk 3.8.0 → 3.8.2

package/dist/MessageProcessor.d.ts

@@ -80,6 +80,7 @@ export declare class MessageProcessor {
             messages: RenderMessage[];
         }>;
     }, messagesMetadata?: Record<string, any>): RenderMessage[];
+    private beforeFold;
     /**
      * @zh 统一的消息处理入口，按顺序执行所有处理步骤
      * @en Unified message processing entry point, executing all processing steps in order

package/dist/MessageProcessor.js

@@ -264,21 +264,25 @@ export class MessageProcessor {
             if (rootMessage.type === "tool" && childrenMap.has(rootMessage.tool_call_id)) {
                 rootMessage.sub_messages.unshift(...childrenMap.get(rootMessage.tool_call_id));
                 // 根据 id 去重
-                rootMessage.sub_messages = rootMessage.sub_messages.filter((i, index, self) => self.findIndex((t) => t.id === i.id) === index);
+                const sub_messages = rootMessage.sub_messages.filter((i, index, self) => self.findIndex((t) => t.id === i.id) === index);
+                rootMessage.sub_messages = this.beforeFold(sub_messages);
             }
         }
         return rootMessages;
     }
+    beforeFold(messages) {
+        // 1. 组合工具消息
+        const composedMessages = this.composeToolMessages(messages);
+        // 2. 附加信息
+        const messagesWithInfo = this.attachInfoForMessage(composedMessages);
+        return messagesWithInfo;
+    }
     /**
      * @zh 统一的消息处理入口，按顺序执行所有处理步骤
      * @en Unified message processing entry point, executing all processing steps in order
      */
     processMessages(messages, graphState, messagesMetadata) {
-        // 1. 组合工具消息
-        const composedMessages = this.composeToolMessages(messages);
-        // 2. 附加信息
-        const messagesWithInfo = this.attachInfoForMessage(composedMessages);
         // 3. 折叠树状消息（如果提供了 messagesMetadata）
-        return this.foldTreeMessages(messagesWithInfo, graphState, messagesMetadata);
+        return this.foldTreeMessages(this.beforeFold(messages), graphState, messagesMetadata);
     }
 }

package/dist/tool/ToolUI.d.ts

@@ -1,5 +1,6 @@
 import { RenderMessage } from "../LangGraphClient.js";
 import { LangGraphClient } from "../LangGraphClient.js";
+import { InterruptResponse } from "./createTool.js";
 export type DeepPartial<T> = {
     [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
 };
@@ -7,7 +8,39 @@ export declare class ToolRenderData<I, D> {
     message: RenderMessage;
     client: LangGraphClient;
     constructor(message: RenderMessage, client: LangGraphClient);
-    get state(): "idle" | "done" | "loading";
+    /**
+     * 获取人机交互数据
+     * 直接使用 reviewConfig 获取可以显示的按钮
+     * actionRequest 获取当前工具的入参
+     */
+    getHumanInTheLoopData(): {
+        config: {
+            id: string;
+            value: {
+                actionRequests: {
+                    name: string;
+                    description: string;
+                    args: any;
+                }[];
+                reviewConfigs: {
+                    actionName: string;
+                    allowedDecisions: ("approve" | "edit" | "reject")[];
+                }[];
+            };
+        };
+        reviewConfig: {
+            actionName: string;
+            allowedDecisions: ("approve" | "edit" | "reject")[];
+        };
+        actionRequest: {
+            name: string;
+            description: string;
+            args: any;
+        };
+    } | null;
+    /** 发送恢复状态的数据 */
+    sendResumeData(response: InterruptResponse["decisions"][number]): void;
+    get state(): "idle" | "interrupted" | "done" | "loading";
     get input(): I | null;
     get output(): string;
     getJSONOutput(): D;

package/dist/tool/ToolUI.js

@@ -7,10 +7,36 @@ export class ToolRenderData {
         this.message = message;
         this.client = client;
     }
+    /**
+     * 获取人机交互数据
+     * 直接使用 reviewConfig 获取可以显示的按钮
+     * actionRequest 获取当前工具的入参
+     */
+    getHumanInTheLoopData() {
+        const configOfHumanInTheLoop = this.client.humanInTheLoop?.find((i) => i.value.reviewConfigs?.some((j) => j.actionName === this.message.name));
+        if (!configOfHumanInTheLoop)
+            return null;
+        return {
+            config: configOfHumanInTheLoop,
+            reviewConfig: configOfHumanInTheLoop.value.reviewConfigs.find((j) => j.actionName === this.message.name),
+            actionRequest: configOfHumanInTheLoop.value.actionRequests.find((j) => j.name === this.message.name),
+        };
+    }
+    /** 发送恢复状态的数据 */
+    sendResumeData(response) {
+        if (response.type === "edit") {
+            /**@ts-ignore 修复 sb 的 langchain 官方的命名不统一，我们一致采用下划线版本，而非驼峰版本 */
+            response.editedAction = response.edited_action;
+        }
+        return this.client.doneFEToolWaiting(this.message.id, { decisions: [response] });
+    }
     get state() {
         if (this.message.type === "tool" && this.message?.additional_kwargs?.done) {
             return "done";
         }
+        if (this.client.status === "interrupted" && this.client.humanInTheLoop?.some((i) => i.value.reviewConfigs?.some((j) => j.actionName === this.message.name))) {
+            return "interrupted";
+        }
         if (this.message.tool_input) {
             return "loading";
         }

package/dist/tool/createTool.d.ts

@@ -22,6 +22,9 @@ export interface UnionTool<Args extends ZodRawShape, Child extends Object = Obje
     isPureParams?: boolean;
 }
 export type ToolCallback<Args extends ZodRawShape> = (args: z.infer<z.ZodObject<Args>>, context?: any) => CallToolResult | Promise<CallToolResult>;
+/**
+ * HumanInTheLoop 的标准回复格式
+ */
 export type InterruptResponse = {
     decisions: ({
         type: "approve";
@@ -33,7 +36,7 @@ export type InterruptResponse = {
         };
     } | {
         type: "reject";
-        message: string;
+        message?: string;
     })[];
 };
 export type CallToolResult = string | {
@@ -170,10 +173,10 @@ export declare const createMCPTool: <Args extends ZodRawShape>(tool: UnionTool<A
     }[];
     isError?: undefined;
 } | {
-    content: {
+    content: InterruptResponse | {
         type: "text";
         text: string;
-    }[] | InterruptResponse | undefined;
+    }[] | undefined;
     isError?: undefined;
 } | {
     content: {

package/package.json

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

package/src/MessageProcessor.ts

@@ -307,23 +307,26 @@ export class MessageProcessor {
             if (rootMessage.type === "tool" && childrenMap.has(rootMessage.tool_call_id)) {
                 rootMessage.sub_messages.unshift(...childrenMap.get(rootMessage.tool_call_id)!);
                 // 根据 id 去重
-                rootMessage.sub_messages = rootMessage.sub_messages.filter((i, index, self) => self.findIndex((t) => t.id === i.id) === index);
+                const sub_messages = rootMessage.sub_messages.filter((i, index, self) => self.findIndex((t) => t.id === i.id) === index);
+                rootMessage.sub_messages = this.beforeFold(sub_messages);
             }
         }
         return rootMessages;
     }
-    /**
-     * @zh 统一的消息处理入口，按顺序执行所有处理步骤
-     * @en Unified message processing entry point, executing all processing steps in order
-     */
-    processMessages(messages: RenderMessage[], graphState?: any, messagesMetadata?: Record<string, any>): RenderMessage[] {
+    private beforeFold(messages: RenderMessage[]) {
         // 1. 组合工具消息
         const composedMessages = this.composeToolMessages(messages);
 
         // 2. 附加信息
         const messagesWithInfo = this.attachInfoForMessage(composedMessages);
-
+        return messagesWithInfo;
+    }
+    /**
+     * @zh 统一的消息处理入口，按顺序执行所有处理步骤
+     * @en Unified message processing entry point, executing all processing steps in order
+     */
+    processMessages(messages: RenderMessage[], graphState?: any, messagesMetadata?: Record<string, any>): RenderMessage[] {
         // 3. 折叠树状消息（如果提供了 messagesMetadata）
-        return this.foldTreeMessages(messagesWithInfo, graphState, messagesMetadata);
+        return this.foldTreeMessages(this.beforeFold(messages), graphState, messagesMetadata);
     }
 }

package/src/tool/ToolUI.ts

@@ -3,6 +3,7 @@ import { RenderMessage } from "../LangGraphClient.js";
 import { LangGraphClient } from "../LangGraphClient.js";
 import { getMessageContent } from "../ui-store/createChatStore.js";
 import { jsonrepair } from "jsonrepair";
+import { InterruptResponse } from "./createTool.js";
 
 export type DeepPartial<T> = {
     [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
@@ -12,10 +13,35 @@ export class ToolRenderData<I, D> {
         public message: RenderMessage,
         public client: LangGraphClient
     ) {}
+    /**
+     * 获取人机交互数据
+     * 直接使用 reviewConfig 获取可以显示的按钮
+     * actionRequest 获取当前工具的入参
+     */
+    getHumanInTheLoopData() {
+        const configOfHumanInTheLoop = this.client.humanInTheLoop?.find((i) => i.value.reviewConfigs?.some((j) => j.actionName === this.message.name));
+        if (!configOfHumanInTheLoop) return null;
+        return {
+            config: configOfHumanInTheLoop,
+            reviewConfig: configOfHumanInTheLoop.value.reviewConfigs.find((j) => j.actionName === this.message.name)!,
+            actionRequest: configOfHumanInTheLoop.value.actionRequests.find((j) => j.name === this.message.name)!,
+        };
+    }
+    /** 发送恢复状态的数据 */
+    sendResumeData(response: InterruptResponse["decisions"][number]) {
+        if (response.type === "edit") {
+            /**@ts-ignore 修复 sb 的 langchain 官方的命名不统一，我们一致采用下划线版本，而非驼峰版本 */
+            response.editedAction = response.edited_action;
+        }
+        return this.client.doneFEToolWaiting(this.message.id!, { decisions: [response] });
+    }
     get state() {
         if (this.message.type === "tool" && this.message?.additional_kwargs?.done) {
             return "done";
         }
+        if (this.client.status === "interrupted" && this.client.humanInTheLoop?.some((i) => i.value.reviewConfigs?.some((j) => j.actionName === this.message.name))) {
+            return "interrupted";
+        }
         if (this.message.tool_input) {
             return "loading";
         }

package/src/tool/createTool.ts

@@ -25,6 +25,9 @@ export interface UnionTool<Args extends ZodRawShape, Child extends Object = Obje
     isPureParams?: boolean;
 }
 export type ToolCallback<Args extends ZodRawShape> = (args: z.infer<z.ZodObject<Args>>, context?: any) => CallToolResult | Promise<CallToolResult>;
+/**
+ * HumanInTheLoop 的标准回复格式
+ */
 export type InterruptResponse = {
     decisions: (
         | { type: "approve" }
@@ -35,7 +38,7 @@ export type InterruptResponse = {
                   args: Record<string, any>;
               };
           }
-        | { type: "reject"; message: string }
+        | { type: "reject"; message?: string }
     )[];
 };
 export type CallToolResult = string | { type: "text"; text: string }[] | InterruptResponse;