@langchain/langgraph 0.2.35 → 0.2.37

package/dist/constants.cjs

@@ -117,6 +117,12 @@ class Send {
             value: "Send"
         });
     }
+    toJSON() {
+        return {
+            node: this.node,
+            args: this.args,
+        };
+    }
 }
 exports.Send = Send;
 function _isSend(x) {
@@ -206,12 +212,11 @@ class Command {
             writable: true,
             value: void 0
         });
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         Object.defineProperty(this, "update", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: []
+            value: void 0
         });
         Object.defineProperty(this, "resume", {
             enumerable: true,
@@ -246,6 +251,30 @@ class Command {
             return [["__root__", this.update]];
         }
     }
+    toJSON() {
+        let serializedGoto;
+        if (typeof this.goto === "string") {
+            serializedGoto = this.goto;
+        }
+        else if (_isSend(this.goto)) {
+            serializedGoto = this.goto.toJSON();
+        }
+        else {
+            serializedGoto = this.goto.map((innerGoto) => {
+                if (typeof innerGoto === "string") {
+                    return innerGoto;
+                }
+                else {
+                    return innerGoto.toJSON();
+                }
+            });
+        }
+        return {
+            update: this.update,
+            resume: this.resume,
+            goto: serializedGoto,
+        };
+    }
 }
 exports.Command = Command;
 Object.defineProperty(Command, "PARENT", {

package/dist/constants.d.ts

@@ -83,6 +83,10 @@ export declare class Send implements SendInterface {
     args: any;
     lg_name: string;
     constructor(node: string, args: any);
+    toJSON(): {
+        node: string;
+        args: any;
+    };
 }
 export declare function _isSend(x: unknown): x is Send;
 export type Interrupt = {
@@ -105,7 +109,7 @@ export type CommandParams<R> = {
     /**
      * Update to apply to the graph's state.
      */
-    update?: Record<string, any>;
+    update?: Record<string, unknown> | [string, unknown][];
     /**
      * Can be one of the following:
      *   - name of the node to navigate to next (any node that belongs to the specified `graph`)
@@ -181,11 +185,22 @@ export declare class Command<R = unknown> {
     lg_name: string;
     lc_direct_tool_output: boolean;
     graph?: string;
-    update?: Record<string, any> | [string, any][];
+    update?: Record<string, unknown> | [string, unknown][];
     resume?: R;
     goto: string | Send | (string | Send)[];
     static PARENT: string;
     constructor(args: CommandParams<R>);
     _updateAsTuples(): [string, unknown][];
+    toJSON(): {
+        update: Record<string, unknown> | [string, unknown][] | undefined;
+        resume: R | undefined;
+        goto: string | {
+            node: string;
+            args: any;
+        } | (string | {
+            node: string;
+            args: any;
+        })[];
+    };
 }
 export declare function isCommand(x: unknown): x is Command;

package/dist/constants.js

@@ -113,6 +113,12 @@ export class Send {
             value: "Send"
         });
     }
+    toJSON() {
+        return {
+            node: this.node,
+            args: this.args,
+        };
+    }
 }
 export function _isSend(x) {
     const operation = x;
@@ -200,12 +206,11 @@ export class Command {
             writable: true,
             value: void 0
         });
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         Object.defineProperty(this, "update", {
             enumerable: true,
             configurable: true,
             writable: true,
-            value: []
+            value: void 0
         });
         Object.defineProperty(this, "resume", {
             enumerable: true,
@@ -240,6 +245,30 @@ export class Command {
             return [["__root__", this.update]];
         }
     }
+    toJSON() {
+        let serializedGoto;
+        if (typeof this.goto === "string") {
+            serializedGoto = this.goto;
+        }
+        else if (_isSend(this.goto)) {
+            serializedGoto = this.goto.toJSON();
+        }
+        else {
+            serializedGoto = this.goto.map((innerGoto) => {
+                if (typeof innerGoto === "string") {
+                    return innerGoto;
+                }
+                else {
+                    return innerGoto.toJSON();
+                }
+            });
+        }
+        return {
+            update: this.update,
+            resume: this.resume,
+            goto: serializedGoto,
+        };
+    }
 }
 Object.defineProperty(Command, "PARENT", {
     enumerable: true,

package/dist/graph/state.cjs

@@ -425,7 +425,7 @@ class CompiledStateGraph extends graph_js_1.CompiledGraph {
             }
             else {
                 const typeofInput = Array.isArray(input) ? "array" : typeof input;
-                throw new errors_js_1.InvalidUpdateError(`Expected node "${nodeKey.toString()}" to return an object, received ${typeofInput}`, {
+                throw new errors_js_1.InvalidUpdateError(`Expected node "${nodeKey.toString()}" to return an object or an array containing at least one Command object, received ${typeofInput}`, {
                     lc_error_code: "INVALID_GRAPH_NODE_RETURN_VALUE",
                 });
             }
@@ -583,13 +583,29 @@ function _controlBranch(value) {
     if ((0, constants_js_1._isSend)(value)) {
         return [value];
     }
-    if (!(0, constants_js_1.isCommand)(value)) {
+    const commands = [];
+    if ((0, constants_js_1.isCommand)(value)) {
+        commands.push(value);
+    }
+    else if (Array.isArray(value) && value.every(constants_js_1.isCommand)) {
+        commands.push(...value);
+    }
+    else {
         return [];
     }
-    if (value.graph === constants_js_1.Command.PARENT) {
-        throw new errors_js_1.ParentCommand(value);
+    const destinations = [];
+    for (const command of commands) {
+        if (command.graph === constants_js_1.Command.PARENT) {
+            throw new errors_js_1.ParentCommand(command);
+        }
+        if ((0, constants_js_1._isSend)(command.goto) || typeof command.goto === "string") {
+            destinations.push(command.goto);
+        }
+        else {
+            destinations.push(...command.goto);
+        }
     }
-    return Array.isArray(value.goto) ? value.goto : [value.goto];
+    return destinations;
 }
 function _getControlBranch() {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any

package/dist/graph/state.js

@@ -421,7 +421,7 @@ export class CompiledStateGraph extends CompiledGraph {
             }
             else {
                 const typeofInput = Array.isArray(input) ? "array" : typeof input;
-                throw new InvalidUpdateError(`Expected node "${nodeKey.toString()}" to return an object, received ${typeofInput}`, {
+                throw new InvalidUpdateError(`Expected node "${nodeKey.toString()}" to return an object or an array containing at least one Command object, received ${typeofInput}`, {
                     lc_error_code: "INVALID_GRAPH_NODE_RETURN_VALUE",
                 });
             }
@@ -578,13 +578,29 @@ function _controlBranch(value) {
     if (_isSend(value)) {
         return [value];
     }
-    if (!isCommand(value)) {
+    const commands = [];
+    if (isCommand(value)) {
+        commands.push(value);
+    }
+    else if (Array.isArray(value) && value.every(isCommand)) {
+        commands.push(...value);
+    }
+    else {
         return [];
     }
-    if (value.graph === Command.PARENT) {
-        throw new ParentCommand(value);
+    const destinations = [];
+    for (const command of commands) {
+        if (command.graph === Command.PARENT) {
+            throw new ParentCommand(command);
+        }
+        if (_isSend(command.goto) || typeof command.goto === "string") {
+            destinations.push(command.goto);
+        }
+        else {
+            destinations.push(...command.goto);
+        }
     }
-    return Array.isArray(value.goto) ? value.goto : [value.goto];
+    return destinations;
 }
 function _getControlBranch() {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any

package/dist/pregel/remote.cjs

@@ -295,8 +295,8 @@ class RemoteGraph extends runnables_1.Runnable {
         const sanitizedConfig = this._sanitizeConfig(mergedConfig);
         const streamProtocolInstance = options?.configurable?.[constants_js_1.CONFIG_KEY_STREAM];
         const streamSubgraphs = options?.subgraphs ?? streamProtocolInstance !== undefined;
-        const interruptBefore = this.interruptBefore ?? options?.interruptBefore;
-        const interruptAfter = this.interruptAfter ?? options?.interruptAfter;
+        const interruptBefore = options?.interruptBefore ?? this.interruptBefore;
+        const interruptAfter = options?.interruptAfter ?? this.interruptAfter;
         const { updatedStreamModes, reqSingle, reqUpdates } = getStreamModes(options?.streamMode);
         const extendedStreamModes = [
             ...new Set([
@@ -304,8 +304,19 @@ class RemoteGraph extends runnables_1.Runnable {
                 ...(streamProtocolInstance?.modes ?? new Set()),
             ]),
         ];
+        let command;
+        let serializedInput;
+        if ((0, constants_js_1.isCommand)(input)) {
+            // TODO: Remove cast when SDK type fix gets merged
+            command = input.toJSON();
+            serializedInput = undefined;
+        }
+        else {
+            serializedInput = _serializeInputs(input);
+        }
         for await (const chunk of this.client.runs.stream(sanitizedConfig.configurable.thread_id, this.graphId, {
-            input: _serializeInputs(input),
+            command,
+            input: serializedInput,
             config: sanitizedConfig,
             streamMode: extendedStreamModes,
             interruptBefore: interruptBefore,

package/dist/pregel/remote.js

@@ -3,7 +3,7 @@ import { Graph as DrawableGraph, } from "@langchain/core/runnables/graph";
 import { mergeConfigs, Runnable, } from "@langchain/core/runnables";
 import { isBaseMessage } from "@langchain/core/messages";
 import { GraphInterrupt, RemoteException, } from "../web.js";
-import { CHECKPOINT_NAMESPACE_SEPARATOR, CONFIG_KEY_STREAM, INTERRUPT, } from "../constants.js";
+import { CHECKPOINT_NAMESPACE_SEPARATOR, CONFIG_KEY_STREAM, INTERRUPT, isCommand, } from "../constants.js";
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 const _serializeInputs = (obj) => {
     if (obj === null || typeof obj !== "object") {
@@ -292,8 +292,8 @@ export class RemoteGraph extends Runnable {
         const sanitizedConfig = this._sanitizeConfig(mergedConfig);
         const streamProtocolInstance = options?.configurable?.[CONFIG_KEY_STREAM];
         const streamSubgraphs = options?.subgraphs ?? streamProtocolInstance !== undefined;
-        const interruptBefore = this.interruptBefore ?? options?.interruptBefore;
-        const interruptAfter = this.interruptAfter ?? options?.interruptAfter;
+        const interruptBefore = options?.interruptBefore ?? this.interruptBefore;
+        const interruptAfter = options?.interruptAfter ?? this.interruptAfter;
         const { updatedStreamModes, reqSingle, reqUpdates } = getStreamModes(options?.streamMode);
         const extendedStreamModes = [
             ...new Set([
@@ -301,8 +301,19 @@ export class RemoteGraph extends Runnable {
                 ...(streamProtocolInstance?.modes ?? new Set()),
             ]),
         ];
+        let command;
+        let serializedInput;
+        if (isCommand(input)) {
+            // TODO: Remove cast when SDK type fix gets merged
+            command = input.toJSON();
+            serializedInput = undefined;
+        }
+        else {
+            serializedInput = _serializeInputs(input);
+        }
         for await (const chunk of this.client.runs.stream(sanitizedConfig.configurable.thread_id, this.graphId, {
-            input: _serializeInputs(input),
+            command,
+            input: serializedInput,
             config: sanitizedConfig,
             streamMode: extendedStreamModes,
             interruptBefore: interruptBefore,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph",
-  "version": "0.2.35",
+  "version": "0.2.37",
   "description": "LangGraph",
   "type": "module",
   "engines": {
@@ -32,7 +32,7 @@
   "license": "MIT",
   "dependencies": {
     "@langchain/langgraph-checkpoint": "~0.0.13",
-    "@langchain/langgraph-sdk": "~0.0.21",
+    "@langchain/langgraph-sdk": "~0.0.32",
     "uuid": "^10.0.0",
     "zod": "^3.23.8"
   },