@langchain/langgraph 0.2.15 → 0.2.16

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/state.cjs

@@ -238,14 +238,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 +326,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;

package/dist/graph/state.js

@@ -235,14 +235,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 +322,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;

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;

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;

package/dist/pregel/index.cjs

@@ -794,7 +794,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

@@ -787,7 +787,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/package.json

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