@langchain/langgraph 0.2.15 → 0.2.17

package/dist/channels/last_value.cjs

@@ -39,7 +39,9 @@ class LastValue extends base_js_1.BaseChannel {
             return false;
         }
         if (values.length !== 1) {
-            throw new errors_js_1.InvalidUpdateError("LastValue can only receive one value per step.");
+            throw new errors_js_1.InvalidUpdateError("LastValue can only receive one value per step.", {
+                lc_error_code: "INVALID_CONCURRENT_GRAPH_UPDATE",
+            });
         }
         // eslint-disable-next-line prefer-destructuring
         this.value = values[values.length - 1];

package/dist/channels/last_value.js

@@ -36,7 +36,9 @@ export class LastValue extends BaseChannel {
             return false;
         }
         if (values.length !== 1) {
-            throw new InvalidUpdateError("LastValue can only receive one value per step.");
+            throw new InvalidUpdateError("LastValue can only receive one value per step.", {
+                lc_error_code: "INVALID_CONCURRENT_GRAPH_UPDATE",
+            });
         }
         // eslint-disable-next-line prefer-destructuring
         this.value = values[values.length - 1];

package/dist/errors.cjs

@@ -1,9 +1,27 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getSubgraphsSeenSet = exports.MultipleSubgraphsError = exports.InvalidUpdateError = exports.EmptyChannelError = exports.EmptyInputError = exports.isGraphInterrupt = exports.NodeInterrupt = exports.GraphInterrupt = exports.GraphValueError = exports.GraphRecursionError = void 0;
-class GraphRecursionError extends Error {
-    constructor(message) {
-        super(message);
+exports.getSubgraphsSeenSet = exports.MultipleSubgraphsError = exports.InvalidUpdateError = exports.EmptyChannelError = exports.EmptyInputError = exports.isGraphInterrupt = exports.NodeInterrupt = exports.GraphInterrupt = exports.GraphValueError = exports.GraphRecursionError = exports.BaseLangGraphError = void 0;
+// TODO: Merge with base LangChain error class when we drop support for core@0.2.0
+class BaseLangGraphError extends Error {
+    constructor(message, fields) {
+        let finalMessage = message ?? "";
+        if (fields?.lc_error_code) {
+            finalMessage = `${finalMessage}\n\nTroubleshooting URL: https://js.langchain.com/docs/troubleshooting/errors/${fields.lc_error_code}/\n`;
+        }
+        super(finalMessage);
+        Object.defineProperty(this, "lc_error_code", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.lc_error_code = fields?.lc_error_code;
+    }
+}
+exports.BaseLangGraphError = BaseLangGraphError;
+class GraphRecursionError extends BaseLangGraphError {
+    constructor(message, fields) {
+        super(message, fields);
         this.name = "GraphRecursionError";
     }
     static get unminifiable_name() {
@@ -11,9 +29,9 @@ class GraphRecursionError extends Error {
     }
 }
 exports.GraphRecursionError = GraphRecursionError;
-class GraphValueError extends Error {
-    constructor(message) {
-        super(message);
+class GraphValueError extends BaseLangGraphError {
+    constructor(message, fields) {
+        super(message, fields);
         this.name = "GraphValueError";
     }
     static get unminifiable_name() {
@@ -21,9 +39,9 @@ class GraphValueError extends Error {
     }
 }
 exports.GraphValueError = GraphValueError;
-class GraphInterrupt extends Error {
-    constructor(interrupts = []) {
-        super(JSON.stringify(interrupts, null, 2));
+class GraphInterrupt extends BaseLangGraphError {
+    constructor(interrupts, fields) {
+        super(JSON.stringify(interrupts, null, 2), fields);
         Object.defineProperty(this, "interrupts", {
             enumerable: true,
             configurable: true,
@@ -31,7 +49,7 @@ class GraphInterrupt extends Error {
             value: void 0
         });
         this.name = "GraphInterrupt";
-        this.interrupts = interrupts;
+        this.interrupts = interrupts ?? [];
     }
     static get unminifiable_name() {
         return "GraphInterrupt";
@@ -40,13 +58,13 @@ class GraphInterrupt extends Error {
 exports.GraphInterrupt = GraphInterrupt;
 /** Raised by a node to interrupt execution. */
 class NodeInterrupt extends GraphInterrupt {
-    constructor(message) {
+    constructor(message, fields) {
         super([
             {
                 value: message,
                 when: "during",
             },
-        ]);
+        ], fields);
         this.name = "NodeInterrupt";
     }
     static get unminifiable_name() {
@@ -62,9 +80,9 @@ function isGraphInterrupt(e) {
         ].includes(e.name));
 }
 exports.isGraphInterrupt = isGraphInterrupt;
-class EmptyInputError extends Error {
-    constructor(message) {
-        super(message);
+class EmptyInputError extends BaseLangGraphError {
+    constructor(message, fields) {
+        super(message, fields);
         this.name = "EmptyInputError";
     }
     static get unminifiable_name() {
@@ -72,9 +90,9 @@ class EmptyInputError extends Error {
     }
 }
 exports.EmptyInputError = EmptyInputError;
-class EmptyChannelError extends Error {
-    constructor(message) {
-        super(message);
+class EmptyChannelError extends BaseLangGraphError {
+    constructor(message, fields) {
+        super(message, fields);
         this.name = "EmptyChannelError";
     }
     static get unminifiable_name() {
@@ -82,9 +100,9 @@ class EmptyChannelError extends Error {
     }
 }
 exports.EmptyChannelError = EmptyChannelError;
-class InvalidUpdateError extends Error {
-    constructor(message) {
-        super(message);
+class InvalidUpdateError extends BaseLangGraphError {
+    constructor(message, fields) {
+        super(message, fields);
         this.name = "InvalidUpdateError";
     }
     static get unminifiable_name() {
@@ -92,9 +110,9 @@ class InvalidUpdateError extends Error {
     }
 }
 exports.InvalidUpdateError = InvalidUpdateError;
-class MultipleSubgraphsError extends Error {
-    constructor(message) {
-        super(message);
+class MultipleSubgraphsError extends BaseLangGraphError {
+    constructor(message, fields) {
+        super(message, fields);
         this.name = "MultipleSubgraphError";
     }
     static get unminifiable_name() {

package/dist/errors.d.ts

@@ -1,37 +1,44 @@
 import { Interrupt } from "./constants.js";
-export declare class GraphRecursionError extends Error {
-    constructor(message?: string);
+export type BaseLangGraphErrorFields = {
+    lc_error_code?: string;
+};
+export declare class BaseLangGraphError extends Error {
+    lc_error_code?: string;
+    constructor(message?: string, fields?: BaseLangGraphErrorFields);
+}
+export declare class GraphRecursionError extends BaseLangGraphError {
+    constructor(message?: string, fields?: BaseLangGraphErrorFields);
     static get unminifiable_name(): string;
 }
-export declare class GraphValueError extends Error {
-    constructor(message?: string);
+export declare class GraphValueError extends BaseLangGraphError {
+    constructor(message?: string, fields?: BaseLangGraphErrorFields);
     static get unminifiable_name(): string;
 }
-export declare class GraphInterrupt extends Error {
+export declare class GraphInterrupt extends BaseLangGraphError {
     interrupts: Interrupt[];
-    constructor(interrupts?: Interrupt[]);
+    constructor(interrupts?: Interrupt[], fields?: BaseLangGraphErrorFields);
     static get unminifiable_name(): string;
 }
 /** Raised by a node to interrupt execution. */
 export declare class NodeInterrupt extends GraphInterrupt {
-    constructor(message: string);
+    constructor(message: string, fields?: BaseLangGraphErrorFields);
     static get unminifiable_name(): string;
 }
 export declare function isGraphInterrupt(e?: GraphInterrupt | Error): e is GraphInterrupt;
-export declare class EmptyInputError extends Error {
-    constructor(message?: string);
+export declare class EmptyInputError extends BaseLangGraphError {
+    constructor(message?: string, fields?: BaseLangGraphErrorFields);
     static get unminifiable_name(): string;
 }
-export declare class EmptyChannelError extends Error {
-    constructor(message?: string);
+export declare class EmptyChannelError extends BaseLangGraphError {
+    constructor(message?: string, fields?: BaseLangGraphErrorFields);
     static get unminifiable_name(): string;
 }
-export declare class InvalidUpdateError extends Error {
-    constructor(message?: string);
+export declare class InvalidUpdateError extends BaseLangGraphError {
+    constructor(message?: string, fields?: BaseLangGraphErrorFields);
     static get unminifiable_name(): string;
 }
-export declare class MultipleSubgraphsError extends Error {
-    constructor(message?: string);
+export declare class MultipleSubgraphsError extends BaseLangGraphError {
+    constructor(message?: string, fields?: BaseLangGraphErrorFields);
     static get unminifiable_name(): string;
 }
 /**

package/dist/errors.js

@@ -1,24 +1,41 @@
-export class GraphRecursionError extends Error {
-    constructor(message) {
-        super(message);
+// TODO: Merge with base LangChain error class when we drop support for core@0.2.0
+export class BaseLangGraphError extends Error {
+    constructor(message, fields) {
+        let finalMessage = message ?? "";
+        if (fields?.lc_error_code) {
+            finalMessage = `${finalMessage}\n\nTroubleshooting URL: https://js.langchain.com/docs/troubleshooting/errors/${fields.lc_error_code}/\n`;
+        }
+        super(finalMessage);
+        Object.defineProperty(this, "lc_error_code", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.lc_error_code = fields?.lc_error_code;
+    }
+}
+export class GraphRecursionError extends BaseLangGraphError {
+    constructor(message, fields) {
+        super(message, fields);
         this.name = "GraphRecursionError";
     }
     static get unminifiable_name() {
         return "GraphRecursionError";
     }
 }
-export class GraphValueError extends Error {
-    constructor(message) {
-        super(message);
+export class GraphValueError extends BaseLangGraphError {
+    constructor(message, fields) {
+        super(message, fields);
         this.name = "GraphValueError";
     }
     static get unminifiable_name() {
         return "GraphValueError";
     }
 }
-export class GraphInterrupt extends Error {
-    constructor(interrupts = []) {
-        super(JSON.stringify(interrupts, null, 2));
+export class GraphInterrupt extends BaseLangGraphError {
+    constructor(interrupts, fields) {
+        super(JSON.stringify(interrupts, null, 2), fields);
         Object.defineProperty(this, "interrupts", {
             enumerable: true,
             configurable: true,
@@ -26,7 +43,7 @@ export class GraphInterrupt extends Error {
             value: void 0
         });
         this.name = "GraphInterrupt";
-        this.interrupts = interrupts;
+        this.interrupts = interrupts ?? [];
     }
     static get unminifiable_name() {
         return "GraphInterrupt";
@@ -34,13 +51,13 @@ export class GraphInterrupt extends Error {
 }
 /** Raised by a node to interrupt execution. */
 export class NodeInterrupt extends GraphInterrupt {
-    constructor(message) {
+    constructor(message, fields) {
         super([
             {
                 value: message,
                 when: "during",
             },
-        ]);
+        ], fields);
         this.name = "NodeInterrupt";
     }
     static get unminifiable_name() {
@@ -54,36 +71,36 @@ export function isGraphInterrupt(e) {
             NodeInterrupt.unminifiable_name,
         ].includes(e.name));
 }
-export class EmptyInputError extends Error {
-    constructor(message) {
-        super(message);
+export class EmptyInputError extends BaseLangGraphError {
+    constructor(message, fields) {
+        super(message, fields);
         this.name = "EmptyInputError";
     }
     static get unminifiable_name() {
         return "EmptyInputError";
     }
 }
-export class EmptyChannelError extends Error {
-    constructor(message) {
-        super(message);
+export class EmptyChannelError extends BaseLangGraphError {
+    constructor(message, fields) {
+        super(message, fields);
         this.name = "EmptyChannelError";
     }
     static get unminifiable_name() {
         return "EmptyChannelError";
     }
 }
-export class InvalidUpdateError extends Error {
-    constructor(message) {
-        super(message);
+export class InvalidUpdateError extends BaseLangGraphError {
+    constructor(message, fields) {
+        super(message, fields);
         this.name = "InvalidUpdateError";
     }
     static get unminifiable_name() {
         return "InvalidUpdateError";
     }
 }
-export class MultipleSubgraphsError extends Error {
-    constructor(message) {
-        super(message);
+export class MultipleSubgraphsError extends BaseLangGraphError {
+    constructor(message, fields) {
+        super(message, fields);
         this.name = "MultipleSubgraphError";
     }
     static get unminifiable_name() {

package/dist/graph/graph.cjs

@@ -13,6 +13,7 @@ const write_js_1 = require("../pregel/write.cjs");
 const constants_js_1 = require("../constants.cjs");
 const utils_js_1 = require("../utils.cjs");
 const errors_js_1 = require("../errors.cjs");
+const subgraph_js_1 = require("../pregel/utils/subgraph.cjs");
 /** Special reserved node name denoting the start of a graph. */
 exports.START = "__start__";
 /** Special reserved node name denoting the end of a graph. */
@@ -140,11 +141,13 @@ class Graph {
         if (key === exports.END) {
             throw new Error(`Node \`${key}\` is reserved.`);
         }
+        const runnable = (0, runnables_1._coerceToRunnable)(
+        // Account for arbitrary state due to Send API
+        action);
         this.nodes[key] = {
-            runnable: (0, runnables_1._coerceToRunnable)(
-            // Account for arbitrary state due to Send API
-            action),
+            runnable,
             metadata: options?.metadata,
+            subgraphs: (0, subgraph_js_1.isPregelLike)(runnable) ? [runnable] : options?.subgraphs,
         };
         return this;
     }
@@ -300,6 +303,7 @@ class CompiledGraph extends index_js_1.Pregel {
             channels: [],
             triggers: [],
             metadata: node.metadata,
+            subgraphs: node.subgraphs,
         })
             .pipe(node.runnable)
             .pipe(new write_js_1.ChannelWrite([{ channel: key, value: write_js_1.PASSTHROUGH }], [constants_js_1.TAG_HIDDEN]));

package/dist/graph/graph.d.ts

@@ -28,9 +28,11 @@ export declare class Branch<IO, N extends string, CallOptions extends LangGraphR
 export type NodeSpec<RunInput, RunOutput> = {
     runnable: Runnable<RunInput, RunOutput>;
     metadata?: Record<string, unknown>;
+    subgraphs?: Pregel<any, any>[];
 };
 export type AddNodeOptions = {
     metadata?: Record<string, unknown>;
+    subgraphs?: Pregel<any, any>[];
 };
 export declare class Graph<N extends string = typeof END, RunInput = any, RunOutput = any, NodeSpecType extends NodeSpec<RunInput, RunOutput> = NodeSpec<RunInput, RunOutput>, C extends StateDefinition = StateDefinition> {
     nodes: Record<N, NodeSpecType>;

package/dist/graph/graph.js

@@ -10,6 +10,7 @@ import { ChannelWrite, PASSTHROUGH } from "../pregel/write.js";
 import { _isSend, CHECKPOINT_NAMESPACE_END, CHECKPOINT_NAMESPACE_SEPARATOR, TAG_HIDDEN, } from "../constants.js";
 import { gatherIteratorSync, RunnableCallable } from "../utils.js";
 import { InvalidUpdateError, NodeInterrupt } from "../errors.js";
+import { isPregelLike } from "../pregel/utils/subgraph.js";
 /** Special reserved node name denoting the start of a graph. */
 export const START = "__start__";
 /** Special reserved node name denoting the end of a graph. */
@@ -136,11 +137,13 @@ export class Graph {
         if (key === END) {
             throw new Error(`Node \`${key}\` is reserved.`);
         }
+        const runnable = _coerceToRunnable(
+        // Account for arbitrary state due to Send API
+        action);
         this.nodes[key] = {
-            runnable: _coerceToRunnable(
-            // Account for arbitrary state due to Send API
-            action),
+            runnable,
             metadata: options?.metadata,
+            subgraphs: isPregelLike(runnable) ? [runnable] : options?.subgraphs,
         };
         return this;
     }
@@ -295,6 +298,7 @@ export class CompiledGraph extends Pregel {
             channels: [],
             triggers: [],
             metadata: node.metadata,
+            subgraphs: node.subgraphs,
         })
             .pipe(node.runnable)
             .pipe(new ChannelWrite([{ channel: key, value: PASSTHROUGH }], [TAG_HIDDEN]));

package/dist/graph/state.cjs

@@ -14,6 +14,7 @@ const constants_js_1 = require("../constants.cjs");
 const errors_js_1 = require("../errors.cjs");
 const annotation_js_1 = require("./annotation.cjs");
 const base_js_2 = require("../managed/base.cjs");
+const subgraph_js_1 = require("../pregel/utils/subgraph.cjs");
 const ROOT = "__root__";
 /**
  * A graph whose nodes communicate by reading and writing to a shared state.
@@ -216,11 +217,16 @@ class StateGraph extends graph_js_1.Graph {
         if (options?.input !== undefined) {
             this._addSchema(options.input.spec);
         }
+        const runnable = (0, runnables_1._coerceToRunnable)(action);
         const nodeSpec = {
-            runnable: (0, runnables_1._coerceToRunnable)(action),
+            runnable,
             retryPolicy: options?.retryPolicy,
             metadata: options?.metadata,
             input: options?.input?.spec ?? this._schemaDefinition,
+            subgraphs: (0, subgraph_js_1.isPregelLike)(runnable)
+                ? // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    [runnable]
+                : options?.subgraphs,
         };
         this.nodes[key] = nodeSpec;
         return this;
@@ -238,14 +244,14 @@ class StateGraph extends graph_js_1.Graph {
                 throw new Error("END cannot be a start node");
             }
             if (!Object.keys(this.nodes).some((node) => node === start)) {
-                throw new Error(`Need to addNode ${start} first`);
+                throw new Error(`Need to add a node named "${start}" first`);
             }
         }
         if (endKey === graph_js_1.END) {
             throw new Error("END cannot be an end node");
         }
         if (!Object.keys(this.nodes).some((node) => node === endKey)) {
-            throw new Error(`Need to addNode ${endKey} first`);
+            throw new Error(`Need to add a node named "${endKey}" first`);
         }
         this.waitingEdges.add([startKey, endKey]);
         return this;
@@ -326,7 +332,9 @@ class CompiledStateGraph extends graph_js_1.CompiledGraph {
             }
             else if (typeof input !== "object" || Array.isArray(input)) {
                 const typeofInput = Array.isArray(input) ? "array" : typeof input;
-                throw new errors_js_1.InvalidUpdateError(`Expected object, got ${typeofInput}`);
+                throw new errors_js_1.InvalidUpdateError(`Expected node "${key.toString()}" to return an object, received ${typeofInput}`, {
+                    lc_error_code: "INVALID_GRAPH_NODE_RETURN_VALUE",
+                });
             }
             else {
                 return key in input ? input[key] : write_js_1.SKIP_WRITE;
@@ -375,6 +383,7 @@ class CompiledStateGraph extends graph_js_1.CompiledGraph {
                 bound: node?.runnable,
                 metadata: node?.metadata,
                 retryPolicy: node?.retryPolicy,
+                subgraphs: node?.subgraphs,
             });
         }
     }

package/dist/graph/state.js

@@ -11,6 +11,7 @@ import { _isSend, CHECKPOINT_NAMESPACE_END, CHECKPOINT_NAMESPACE_SEPARATOR, TAG_
 import { InvalidUpdateError } from "../errors.js";
 import { getChannel, } from "./annotation.js";
 import { isConfiguredManagedValue } from "../managed/base.js";
+import { isPregelLike } from "../pregel/utils/subgraph.js";
 const ROOT = "__root__";
 /**
  * A graph whose nodes communicate by reading and writing to a shared state.
@@ -213,11 +214,16 @@ export class StateGraph extends Graph {
         if (options?.input !== undefined) {
             this._addSchema(options.input.spec);
         }
+        const runnable = _coerceToRunnable(action);
         const nodeSpec = {
-            runnable: _coerceToRunnable(action),
+            runnable,
             retryPolicy: options?.retryPolicy,
             metadata: options?.metadata,
             input: options?.input?.spec ?? this._schemaDefinition,
+            subgraphs: isPregelLike(runnable)
+                ? // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    [runnable]
+                : options?.subgraphs,
         };
         this.nodes[key] = nodeSpec;
         return this;
@@ -235,14 +241,14 @@ export class StateGraph extends Graph {
                 throw new Error("END cannot be a start node");
             }
             if (!Object.keys(this.nodes).some((node) => node === start)) {
-                throw new Error(`Need to addNode ${start} first`);
+                throw new Error(`Need to add a node named "${start}" first`);
             }
         }
         if (endKey === END) {
             throw new Error("END cannot be an end node");
         }
         if (!Object.keys(this.nodes).some((node) => node === endKey)) {
-            throw new Error(`Need to addNode ${endKey} first`);
+            throw new Error(`Need to add a node named "${endKey}" first`);
         }
         this.waitingEdges.add([startKey, endKey]);
         return this;
@@ -322,7 +328,9 @@ export class CompiledStateGraph extends CompiledGraph {
             }
             else if (typeof input !== "object" || Array.isArray(input)) {
                 const typeofInput = Array.isArray(input) ? "array" : typeof input;
-                throw new InvalidUpdateError(`Expected object, got ${typeofInput}`);
+                throw new InvalidUpdateError(`Expected node "${key.toString()}" to return an object, received ${typeofInput}`, {
+                    lc_error_code: "INVALID_GRAPH_NODE_RETURN_VALUE",
+                });
             }
             else {
                 return key in input ? input[key] : SKIP_WRITE;
@@ -371,6 +379,7 @@ export class CompiledStateGraph extends CompiledGraph {
                 bound: node?.runnable,
                 metadata: node?.metadata,
                 retryPolicy: node?.retryPolicy,
+                subgraphs: node?.subgraphs,
             });
         }
     }

package/dist/prebuilt/index.d.ts

@@ -2,4 +2,4 @@ export { type AgentExecutorState, createAgentExecutor, } from "./agent_executor.
 export { type FunctionCallingExecutorState, createFunctionCallingExecutor, } from "./chat_agent_executor.js";
 export { type AgentState, createReactAgent } from "./react_agent_executor.js";
 export { type ToolExecutorArgs, type ToolInvocationInterface, ToolExecutor, } from "./tool_executor.js";
-export { ToolNode, toolsCondition } from "./tool_node.js";
+export { ToolNode, toolsCondition, type ToolNodeOptions } from "./tool_node.js";

package/dist/prebuilt/tool_node.d.ts

@@ -1,5 +1,5 @@
 import { BaseMessage } from "@langchain/core/messages";
-import { RunnableToolLike } from "@langchain/core/runnables";
+import { RunnableConfig, RunnableToolLike } from "@langchain/core/runnables";
 import { StructuredToolInterface } from "@langchain/core/tools";
 import { RunnableCallable } from "../utils.js";
 import { END } from "../graph/graph.js";
@@ -130,6 +130,6 @@ export declare class ToolNode<T = any> extends RunnableCallable<T, T> {
     tools: (StructuredToolInterface | RunnableToolLike)[];
     handleToolErrors: boolean;
     constructor(tools: (StructuredToolInterface | RunnableToolLike)[], options?: ToolNodeOptions);
-    private run;
+    protected run(input: any, config: RunnableConfig): Promise<T>;
 }
 export declare function toolsCondition(state: BaseMessage[] | typeof MessagesAnnotation.State): "tools" | typeof END;

package/dist/pregel/algo.cjs

@@ -84,7 +84,7 @@ writes) {
                 throw new errors_js_1.InvalidUpdateError(`Invalid packet type, expected SendProtocol, got ${JSON.stringify(value)}`);
             }
             if (!(value.node in processes)) {
-                throw new errors_js_1.InvalidUpdateError(`Invalid node name ${value.node} in packet`);
+                throw new errors_js_1.InvalidUpdateError(`Invalid node name "${value.node}" in Send packet`);
             }
             // replace any runtime values with placeholders
             managed.replaceRuntimeValues(step, value.args);
@@ -178,7 +178,9 @@ getNextVersion) {
             }
             catch (e) {
                 if (e.name === errors_js_1.InvalidUpdateError.unminifiable_name) {
-                    throw new errors_js_1.InvalidUpdateError(`Invalid update for channel ${chan} with values ${JSON.stringify(vals)}: ${e.message}`);
+                    const wrappedError = new errors_js_1.InvalidUpdateError(`Invalid update for channel "${chan}" with values ${JSON.stringify(vals)}: ${e.message}`);
+                    wrappedError.lc_error_code = e.lc_error_code;
+                    throw wrappedError;
                 }
                 else {
                     throw e;
@@ -273,6 +275,7 @@ function _prepareSingleTask(taskPath, checkpoint, processes, channels, managed,
                     name: packet.node,
                     input: packet.args,
                     proc: node,
+                    subgraphs: proc.subgraphs,
                     writes,
                     config: (0, runnables_1.patchConfig)((0, runnables_1.mergeConfigs)(config, {
                         metadata,
@@ -369,6 +372,7 @@ function _prepareSingleTask(taskPath, checkpoint, processes, channels, managed,
                         name,
                         input: val,
                         proc: node,
+                        subgraphs: proc.subgraphs,
                         writes,
                         config: (0, runnables_1.patchConfig)((0, runnables_1.mergeConfigs)(config, {
                             metadata,

package/dist/pregel/algo.js

@@ -78,7 +78,7 @@ writes) {
                 throw new InvalidUpdateError(`Invalid packet type, expected SendProtocol, got ${JSON.stringify(value)}`);
             }
             if (!(value.node in processes)) {
-                throw new InvalidUpdateError(`Invalid node name ${value.node} in packet`);
+                throw new InvalidUpdateError(`Invalid node name "${value.node}" in Send packet`);
             }
             // replace any runtime values with placeholders
             managed.replaceRuntimeValues(step, value.args);
@@ -171,7 +171,9 @@ getNextVersion) {
             }
             catch (e) {
                 if (e.name === InvalidUpdateError.unminifiable_name) {
-                    throw new InvalidUpdateError(`Invalid update for channel ${chan} with values ${JSON.stringify(vals)}: ${e.message}`);
+                    const wrappedError = new InvalidUpdateError(`Invalid update for channel "${chan}" with values ${JSON.stringify(vals)}: ${e.message}`);
+                    wrappedError.lc_error_code = e.lc_error_code;
+                    throw wrappedError;
                 }
                 else {
                     throw e;
@@ -264,6 +266,7 @@ export function _prepareSingleTask(taskPath, checkpoint, processes, channels, ma
                     name: packet.node,
                     input: packet.args,
                     proc: node,
+                    subgraphs: proc.subgraphs,
                     writes,
                     config: patchConfig(mergeConfigs(config, {
                         metadata,
@@ -360,6 +363,7 @@ export function _prepareSingleTask(taskPath, checkpoint, processes, channels, ma
                         name,
                         input: val,
                         proc: node,
+                        subgraphs: proc.subgraphs,
                         writes,
                         config: patchConfig(mergeConfigs(config, {
                             metadata,

package/dist/pregel/debug.cjs

@@ -127,7 +127,8 @@ function* mapDebugCheckpoint(step, config, channels, streamChannels, metadata, t
     const parentNs = config.configurable?.checkpoint_ns;
     const taskStates = {};
     for (const task of tasks) {
-        if (!(0, subgraph_js_1.findSubgraphPregel)(task.proc))
+        const candidates = task.subgraphs?.length ? task.subgraphs : [task.proc];
+        if (!candidates.find(subgraph_js_1.findSubgraphPregel))
             continue;
         let taskNs = `${task.name}:${task.id}`;
         if (parentNs)

package/dist/pregel/debug.js

@@ -121,7 +121,8 @@ export function* mapDebugCheckpoint(step, config, channels, streamChannels, meta
     const parentNs = config.configurable?.checkpoint_ns;
     const taskStates = {};
     for (const task of tasks) {
-        if (!findSubgraphPregel(task.proc))
+        const candidates = task.subgraphs?.length ? task.subgraphs : [task.proc];
+        if (!candidates.find(findSubgraphPregel))
             continue;
         let taskNs = `${task.name}:${task.id}`;
         if (parentNs)

package/dist/pregel/index.cjs

@@ -255,26 +255,28 @@ class Pregel extends runnables_1.Runnable {
                     continue;
                 }
             }
-            const graph = (0, subgraph_js_1.findSubgraphPregel)(node.bound);
-            // if found, yield recursively
-            if (graph !== undefined) {
-                if (name === namespace) {
-                    yield [name, graph];
-                    return;
-                }
-                if (namespace === undefined) {
-                    yield [name, graph];
-                }
-                if (recurse) {
-                    let newNamespace = namespace;
-                    if (namespace !== undefined) {
-                        newNamespace = namespace.slice(name.length + 1);
+            const candidates = node.subgraphs?.length ? node.subgraphs : [node.bound];
+            for (const candidate of candidates) {
+                const graph = (0, subgraph_js_1.findSubgraphPregel)(candidate);
+                if (graph !== undefined) {
+                    if (name === namespace) {
+                        yield [name, graph];
+                        return;
                     }
-                    for (const [subgraphName, subgraph] of graph.getSubgraphs(newNamespace, recurse)) {
-                        yield [
-                            `${name}${constants_js_1.CHECKPOINT_NAMESPACE_SEPARATOR}${subgraphName}`,
-                            subgraph,
-                        ];
+                    if (namespace === undefined) {
+                        yield [name, graph];
+                    }
+                    if (recurse) {
+                        let newNamespace = namespace;
+                        if (namespace !== undefined) {
+                            newNamespace = namespace.slice(name.length + 1);
+                        }
+                        for (const [subgraphName, subgraph] of graph.getSubgraphs(newNamespace, recurse)) {
+                            yield [
+                                `${name}${constants_js_1.CHECKPOINT_NAMESPACE_SEPARATOR}${subgraphName}`,
+                                subgraph,
+                            ];
+                        }
                     }
                 }
             }
@@ -794,7 +796,9 @@ class Pregel extends runnables_1.Runnable {
                     `Recursion limit of ${config.recursionLimit} reached`,
                     "without hitting a stop condition. You can increase the",
                     `limit by setting the "recursionLimit" config key.`,
-                ].join(" "));
+                ].join(" "), {
+                    lc_error_code: "GRAPH_RECURSION_LIMIT",
+                });
             }
             await Promise.all(loop?.checkpointerPromises ?? []);
             await runManager?.handleChainEnd(loop.output);

package/dist/pregel/index.js

@@ -248,26 +248,28 @@ export class Pregel extends Runnable {
                     continue;
                 }
             }
-            const graph = findSubgraphPregel(node.bound);
-            // if found, yield recursively
-            if (graph !== undefined) {
-                if (name === namespace) {
-                    yield [name, graph];
-                    return;
-                }
-                if (namespace === undefined) {
-                    yield [name, graph];
-                }
-                if (recurse) {
-                    let newNamespace = namespace;
-                    if (namespace !== undefined) {
-                        newNamespace = namespace.slice(name.length + 1);
+            const candidates = node.subgraphs?.length ? node.subgraphs : [node.bound];
+            for (const candidate of candidates) {
+                const graph = findSubgraphPregel(candidate);
+                if (graph !== undefined) {
+                    if (name === namespace) {
+                        yield [name, graph];
+                        return;
                     }
-                    for (const [subgraphName, subgraph] of graph.getSubgraphs(newNamespace, recurse)) {
-                        yield [
-                            `${name}${CHECKPOINT_NAMESPACE_SEPARATOR}${subgraphName}`,
-                            subgraph,
-                        ];
+                    if (namespace === undefined) {
+                        yield [name, graph];
+                    }
+                    if (recurse) {
+                        let newNamespace = namespace;
+                        if (namespace !== undefined) {
+                            newNamespace = namespace.slice(name.length + 1);
+                        }
+                        for (const [subgraphName, subgraph] of graph.getSubgraphs(newNamespace, recurse)) {
+                            yield [
+                                `${name}${CHECKPOINT_NAMESPACE_SEPARATOR}${subgraphName}`,
+                                subgraph,
+                            ];
+                        }
                     }
                 }
             }
@@ -787,7 +789,9 @@ export class Pregel extends Runnable {
                     `Recursion limit of ${config.recursionLimit} reached`,
                     "without hitting a stop condition. You can increase the",
                     `limit by setting the "recursionLimit" config key.`,
-                ].join(" "));
+                ].join(" "), {
+                    lc_error_code: "GRAPH_RECURSION_LIMIT",
+                });
             }
             await Promise.all(loop?.checkpointerPromises ?? []);
             await runManager?.handleChainEnd(loop.output);

package/dist/pregel/loop.cjs

@@ -313,7 +313,9 @@ class PregelLoop {
                     "This is not allowed if checkpointing is enabled.",
                     "",
                     `You can disable checkpointing for a subgraph by compiling it with ".compile({ checkpointer: false });"`,
-                ].join("\n"));
+                ].join("\n"), {
+                    lc_error_code: "MULTIPLE_SUBGRAPHS",
+                });
             }
             else {
                 (0, errors_js_1.getSubgraphsSeenSet)().add(config.configurable?.checkpoint_ns);

package/dist/pregel/loop.js

@@ -309,7 +309,9 @@ export class PregelLoop {
                     "This is not allowed if checkpointing is enabled.",
                     "",
                     `You can disable checkpointing for a subgraph by compiling it with ".compile({ checkpointer: false });"`,
-                ].join("\n"));
+                ].join("\n"), {
+                    lc_error_code: "MULTIPLE_SUBGRAPHS",
+                });
             }
             else {
                 getSubgraphsSeenSet().add(config.configurable?.checkpoint_ns);

package/dist/pregel/read.cjs

@@ -63,7 +63,7 @@ const defaultRunnableBound =
 /* #__PURE__ */ new runnables_1.RunnablePassthrough();
 class PregelNode extends runnables_1.RunnableBinding {
     constructor(fields) {
-        const { channels, triggers, mapper, writers, bound, kwargs, metadata, retryPolicy, tags, } = fields;
+        const { channels, triggers, mapper, writers, bound, kwargs, metadata, retryPolicy, tags, subgraphs, } = fields;
         const mergedTags = [
             ...(fields.config?.tags ? fields.config.tags : []),
             ...(tags ?? []),
@@ -139,6 +139,12 @@ class PregelNode extends runnables_1.RunnableBinding {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "subgraphs", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.channels = channels;
         this.triggers = triggers;
         this.mapper = mapper;
@@ -148,6 +154,7 @@ class PregelNode extends runnables_1.RunnableBinding {
         this.metadata = metadata ?? this.metadata;
         this.tags = mergedTags;
         this.retryPolicy = retryPolicy;
+        this.subgraphs = subgraphs;
     }
     getWriters() {
         const newWriters = [...this.writers];

package/dist/pregel/read.d.ts

@@ -20,6 +20,7 @@ interface PregelNodeArgs<RunInput, RunOutput> extends Partial<RunnableBindingArg
     config?: RunnableConfig;
     metadata?: Record<string, unknown>;
     retryPolicy?: RetryPolicy;
+    subgraphs?: Runnable[];
 }
 export type PregelNodeInputType = any;
 export type PregelNodeOutputType = any;
@@ -34,6 +35,7 @@ export declare class PregelNode<RunInput = PregelNodeInputType, RunOutput = Preg
     metadata: Record<string, unknown>;
     tags: string[];
     retryPolicy?: RetryPolicy;
+    subgraphs?: Runnable[];
     constructor(fields: PregelNodeArgs<RunInput, RunOutput>);
     getWriters(): Array<Runnable>;
     getNode(): Runnable<RunInput, RunOutput> | undefined;

package/dist/pregel/read.js

@@ -59,7 +59,7 @@ const defaultRunnableBound =
 /* #__PURE__ */ new RunnablePassthrough();
 export class PregelNode extends RunnableBinding {
     constructor(fields) {
-        const { channels, triggers, mapper, writers, bound, kwargs, metadata, retryPolicy, tags, } = fields;
+        const { channels, triggers, mapper, writers, bound, kwargs, metadata, retryPolicy, tags, subgraphs, } = fields;
         const mergedTags = [
             ...(fields.config?.tags ? fields.config.tags : []),
             ...(tags ?? []),
@@ -135,6 +135,12 @@ export class PregelNode extends RunnableBinding {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "subgraphs", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.channels = channels;
         this.triggers = triggers;
         this.mapper = mapper;
@@ -144,6 +150,7 @@ export class PregelNode extends RunnableBinding {
         this.metadata = metadata ?? this.metadata;
         this.tags = mergedTags;
         this.retryPolicy = retryPolicy;
+        this.subgraphs = subgraphs;
     }
     getWriters() {
         const newWriters = [...this.writers];

package/dist/pregel/types.d.ts

@@ -71,6 +71,7 @@ export interface PregelExecutableTask<N extends PropertyKey, C extends PropertyK
     readonly retry_policy?: RetryPolicy;
     readonly id: string;
     readonly path?: [string, ...(string | number)[]];
+    readonly subgraphs?: Runnable[];
 }
 export interface StateSnapshot {
     /**

package/dist/pregel/utils/subgraph.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.findSubgraphPregel = void 0;
+exports.findSubgraphPregel = exports.isPregelLike = void 0;
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 function isRunnableSequence(x) {
     return "steps" in x && Array.isArray(x.steps);
@@ -15,6 +15,7 @@ x
         "outputChannels" &&
         x.outputChannels !== undefined);
 }
+exports.isPregelLike = isPregelLike;
 function findSubgraphPregel(candidate
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 ) {

package/dist/pregel/utils/subgraph.d.ts

@@ -1,3 +1,4 @@
-import { Runnable } from "@langchain/core/runnables";
+import { Runnable, RunnableLike } from "@langchain/core/runnables";
 import type { PregelInterface } from "../types.js";
+export declare function isPregelLike(x: PregelInterface<any, any> | RunnableLike<any, any, any>): x is PregelInterface<any, any>;
 export declare function findSubgraphPregel(candidate: Runnable): PregelInterface<any, any> | undefined;

package/dist/pregel/utils/subgraph.js

@@ -2,7 +2,7 @@
 function isRunnableSequence(x) {
     return "steps" in x && Array.isArray(x.steps);
 }
-function isPregelLike(
+export function isPregelLike(
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 x
 // eslint-disable-next-line @typescript-eslint/no-explicit-any

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph",
-  "version": "0.2.15",
+  "version": "0.2.17",
   "description": "LangGraph",
   "type": "module",
   "engines": {