@langgraph-js/sdk 3.8.0 → 3.8.1

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.1",
   "description": "The UI SDK for LangGraph - seamlessly integrate your AI agents with frontend interfaces",
   "main": "dist/index.js",
   "type": "module",

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;