@langchain/langgraph 0.2.39 → 0.2.40

package/dist/prebuilt/index.d.ts

@@ -3,3 +3,4 @@ export { type FunctionCallingExecutorState, createFunctionCallingExecutor, } fro
 export { type AgentState, type CreateReactAgentParams, createReactAgent, } from "./react_agent_executor.js";
 export { type ToolExecutorArgs, type ToolInvocationInterface, ToolExecutor, } from "./tool_executor.js";
 export { ToolNode, toolsCondition, type ToolNodeOptions } from "./tool_node.js";
+export type { HumanInterruptConfig, ActionRequest, HumanInterrupt, HumanResponse, } from "./interrupt.js";

package/dist/prebuilt/interrupt.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/prebuilt/interrupt.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Configuration interface that defines what actions are allowed for a human interrupt.
+ * This controls the available interaction options when the graph is paused for human input.
+ *
+ * @property {boolean} allow_ignore - Whether the human can choose to ignore/skip the current step
+ * @property {boolean} allow_respond - Whether the human can provide a text response/feedback
+ * @property {boolean} allow_edit - Whether the human can edit the provided content/state
+ * @property {boolean} allow_accept - Whether the human can accept/approve the current state
+ */
+export interface HumanInterruptConfig {
+    allow_ignore: boolean;
+    allow_respond: boolean;
+    allow_edit: boolean;
+    allow_accept: boolean;
+}
+/**
+ * Represents a request for human action within the graph execution.
+ * Contains the action type and any associated arguments needed for the action.
+ *
+ * @property {string} action - The type or name of action being requested (e.g., "Approve XYZ action")
+ * @property {Record<string, any>} args - Key-value pairs of arguments needed for the action
+ */
+export interface ActionRequest {
+    action: string;
+    args: Record<string, any>;
+}
+/**
+ * Represents an interrupt triggered by the graph that requires human intervention.
+ * This is passed to the `interrupt` function when execution is paused for human input.
+ *
+ * @property {ActionRequest} action_request - The specific action being requested from the human
+ * @property {HumanInterruptConfig} config - Configuration defining what actions are allowed
+ * @property {string} [description] - Optional detailed description of what input is needed
+ */
+export interface HumanInterrupt {
+    action_request: ActionRequest;
+    config: HumanInterruptConfig;
+    description?: string;
+}
+/**
+ * The response provided by a human to an interrupt, which is returned when graph execution resumes.
+ *
+ * @property {("accept"|"ignore"|"response"|"edit")} type - The type of response:
+ *   - "accept": Approves the current state without changes
+ *   - "ignore": Skips/ignores the current step
+ *   - "response": Provides text feedback or instructions
+ *   - "edit": Modifies the current state/content
+ * @property {null|string|ActionRequest} args - The response payload:
+ *   - null: For ignore/accept actions
+ *   - string: For text responses
+ *   - ActionRequest: For edit actions with updated content
+ */
+export type HumanResponse = {
+    type: "accept" | "ignore" | "response" | "edit";
+    args: null | string | ActionRequest;
+};

package/dist/prebuilt/interrupt.js

@@ -0,0 +1 @@
+export {};

package/dist/pregel/io.cjs

@@ -94,8 +94,15 @@ function* mapCommand(cmd, pendingWrites) {
         if (typeof cmd.update !== "object" || !cmd.update) {
             throw new Error("Expected cmd.update to be a dict mapping channel names to update values");
         }
-        for (const [k, v] of Object.entries(cmd.update)) {
-            yield [constants_js_1.NULL_TASK_ID, k, v];
+        if (Array.isArray(cmd.update)) {
+            for (const [k, v] of cmd.update) {
+                yield [constants_js_1.NULL_TASK_ID, k, v];
+            }
+        }
+        else {
+            for (const [k, v] of Object.entries(cmd.update)) {
+                yield [constants_js_1.NULL_TASK_ID, k, v];
+            }
         }
     }
 }

package/dist/pregel/io.js

@@ -89,8 +89,15 @@ export function* mapCommand(cmd, pendingWrites) {
         if (typeof cmd.update !== "object" || !cmd.update) {
             throw new Error("Expected cmd.update to be a dict mapping channel names to update values");
         }
-        for (const [k, v] of Object.entries(cmd.update)) {
-            yield [NULL_TASK_ID, k, v];
+        if (Array.isArray(cmd.update)) {
+            for (const [k, v] of cmd.update) {
+                yield [NULL_TASK_ID, k, v];
+            }
+        }
+        else {
+            for (const [k, v] of Object.entries(cmd.update)) {
+                yield [NULL_TASK_ID, k, v];
+            }
         }
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph",
-  "version": "0.2.39",
+  "version": "0.2.40",
   "description": "LangGraph",
   "type": "module",
   "engines": {
@@ -72,7 +72,7 @@
     "pg": "^8.13.0",
     "prettier": "^2.8.3",
     "release-it": "^17.6.0",
-    "rollup": "^4.24.1",
+    "rollup": "^4.29.0",
     "ts-jest": "^29.1.0",
     "tsx": "^4.7.0",
     "typescript": "^4.9.5 || ^5.4.5",