@langchain/langgraph 0.2.14 → 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/index.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.messagesStateReducer = exports.MessageGraph = exports.StateGraph = exports.Graph = exports.START = exports.END = exports.AnnotationRoot = exports.Annotation = void 0;
+exports.messagesStateReducer = exports.MessageGraph = exports.CompiledStateGraph = exports.StateGraph = exports.Graph = exports.START = exports.END = exports.AnnotationRoot = exports.Annotation = void 0;
 var annotation_js_1 = require("./annotation.cjs");
 Object.defineProperty(exports, "Annotation", { enumerable: true, get: function () { return annotation_js_1.Annotation; } });
 Object.defineProperty(exports, "AnnotationRoot", { enumerable: true, get: function () { return annotation_js_1.AnnotationRoot; } });
@@ -10,6 +10,7 @@ Object.defineProperty(exports, "START", { enumerable: true, get: function () { r
 Object.defineProperty(exports, "Graph", { enumerable: true, get: function () { return graph_js_1.Graph; } });
 var state_js_1 = require("./state.cjs");
 Object.defineProperty(exports, "StateGraph", { enumerable: true, get: function () { return state_js_1.StateGraph; } });
+Object.defineProperty(exports, "CompiledStateGraph", { enumerable: true, get: function () { return state_js_1.CompiledStateGraph; } });
 var message_js_1 = require("./message.cjs");
 Object.defineProperty(exports, "MessageGraph", { enumerable: true, get: function () { return message_js_1.MessageGraph; } });
 Object.defineProperty(exports, "messagesStateReducer", { enumerable: true, get: function () { return message_js_1.messagesStateReducer; } });

package/dist/graph/index.d.ts

@@ -1,4 +1,4 @@
 export { Annotation, type StateType, type UpdateType, type NodeType, AnnotationRoot, type StateDefinition, type SingleReducer, } from "./annotation.js";
 export { END, START, Graph, type CompiledGraph } from "./graph.js";
-export { type StateGraphArgs, StateGraph, type CompiledStateGraph, } from "./state.js";
+export { type StateGraphArgs, StateGraph, CompiledStateGraph, } from "./state.js";
 export { MessageGraph, messagesStateReducer, type Messages, } from "./message.js";

package/dist/graph/index.js

@@ -1,4 +1,4 @@
 export { Annotation, AnnotationRoot, } from "./annotation.js";
 export { END, START, Graph } from "./graph.js";
-export { StateGraph, } from "./state.js";
+export { StateGraph, CompiledStateGraph, } from "./state.js";
 export { MessageGraph, messagesStateReducer, } from "./message.js";

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;
@@ -312,6 +312,11 @@ function _getChannels(schema) {
     }
     return channels;
 }
+/**
+ * Final result from building and compiling a {@link StateGraph}.
+ * Should not be instantiated directly, only using the StateGraph `.compile()`
+ * instance method.
+ */
 class CompiledStateGraph extends graph_js_1.CompiledGraph {
     attachNode(key, node) {
         const stateKeys = Object.keys(this.builder.channels);
@@ -321,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.d.ts

@@ -123,6 +123,11 @@ export declare class StateGraph<SD extends StateDefinition | unknown, S = SD ext
         interruptAfter?: N[] | All;
     }): CompiledStateGraph<S, U, N, I, O, C>;
 }
+/**
+ * Final result from building and compiling a {@link StateGraph}.
+ * Should not be instantiated directly, only using the StateGraph `.compile()`
+ * instance method.
+ */
 export declare class CompiledStateGraph<S, U, N extends string = typeof START, I extends StateDefinition = StateDefinition, O extends StateDefinition = StateDefinition, C extends StateDefinition = StateDefinition> extends CompiledGraph<N, S, U, StateType<C>> {
     builder: StateGraph<unknown, S, U, N, I, O, C>;
     attachNode(key: typeof START, node?: never): void;

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;
@@ -308,6 +308,11 @@ function _getChannels(schema) {
     }
     return channels;
 }
+/**
+ * Final result from building and compiling a {@link StateGraph}.
+ * Should not be instantiated directly, only using the StateGraph `.compile()`
+ * instance method.
+ */
 export class CompiledStateGraph extends CompiledGraph {
     attachNode(key, node) {
         const stateKeys = Object.keys(this.builder.channels);
@@ -317,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/debug.cjs

@@ -4,6 +4,7 @@ exports.printStepWrites = exports.printStepTasks = exports.printStepCheckpoint =
 const constants_js_1 = require("../constants.cjs");
 const errors_js_1 = require("../errors.cjs");
 const io_js_1 = require("./io.cjs");
+const subgraph_js_1 = require("./utils/subgraph.cjs");
 const COLORS_MAP = {
     blue: {
         start: "\x1b[34m",
@@ -101,7 +102,7 @@ function* mapDebugTaskResults(step, tasks, streamChannels) {
     }
 }
 exports.mapDebugTaskResults = mapDebugTaskResults;
-function* mapDebugCheckpoint(step, config, channels, streamChannels, metadata, tasks, pendingWrites) {
+function* mapDebugCheckpoint(step, config, channels, streamChannels, metadata, tasks, pendingWrites, parentConfig) {
     function formatConfig(config) {
         // make sure the config is consistent with Python
         const pyConfig = {};
@@ -123,11 +124,22 @@ function* mapDebugCheckpoint(step, config, channels, streamChannels, metadata, t
             pyConfig.tags = config.tags;
         return pyConfig;
     }
-    function getCurrentUTC() {
-        const now = new Date();
-        return new Date(now.getTime() - now.getTimezoneOffset() * 60 * 1000);
+    const parentNs = config.configurable?.checkpoint_ns;
+    const taskStates = {};
+    for (const task of tasks) {
+        if (!(0, subgraph_js_1.findSubgraphPregel)(task.proc))
+            continue;
+        let taskNs = `${task.name}:${task.id}`;
+        if (parentNs)
+            taskNs = `${parentNs}|${taskNs}`;
+        taskStates[task.id] = {
+            configurable: {
+                thread_id: config.configurable?.thread_id,
+                checkpoint_ns: taskNs,
+            },
+        };
     }
-    const ts = getCurrentUTC().toISOString();
+    const ts = new Date().toISOString();
     yield {
         type: "checkpoint",
         timestamp: ts,
@@ -137,7 +149,8 @@ function* mapDebugCheckpoint(step, config, channels, streamChannels, metadata, t
             values: (0, io_js_1.readChannels)(channels, streamChannels),
             metadata,
             next: tasks.map((task) => task.name),
-            tasks: tasksWithWrites(tasks, pendingWrites),
+            tasks: tasksWithWrites(tasks, pendingWrites, taskStates),
+            parentConfig: parentConfig ? formatConfig(parentConfig) : undefined,
         },
     };
 }

package/dist/pregel/debug.d.ts

@@ -26,7 +26,7 @@ export declare function mapDebugTaskResults<N extends PropertyKey, C extends Pro
         interrupts: PendingWrite<C>[];
     };
 }, void, unknown>;
-export declare function mapDebugCheckpoint<N extends PropertyKey, C extends PropertyKey>(step: number, config: RunnableConfig, channels: Record<string, BaseChannel>, streamChannels: string | string[], metadata: CheckpointMetadata, tasks: readonly PregelExecutableTask<N, C>[], pendingWrites: CheckpointPendingWrite[]): Generator<{
+export declare function mapDebugCheckpoint<N extends PropertyKey, C extends PropertyKey>(step: number, config: RunnableConfig, channels: Record<string, BaseChannel>, streamChannels: string | string[], metadata: CheckpointMetadata, tasks: readonly PregelExecutableTask<N, C>[], pendingWrites: CheckpointPendingWrite[], parentConfig: RunnableConfig | undefined): Generator<{
     type: string;
     timestamp: string;
     step: number;
@@ -36,6 +36,7 @@ export declare function mapDebugCheckpoint<N extends PropertyKey, C extends Prop
         metadata: CheckpointMetadata;
         next: N[];
         tasks: PregelTaskDescription[];
+        parentConfig: Partial<Record<"configurable" | "timeout" | "signal" | "tags" | "metadata" | "callbacks" | "recursion_limit" | "max_concurrency" | "run_name" | "run_id", unknown>> | undefined;
     };
 }, void, unknown>;
 export declare function tasksWithWrites<N extends PropertyKey, C extends PropertyKey>(tasks: PregelTaskDescription[] | readonly PregelExecutableTask<N, C>[], pendingWrites: CheckpointPendingWrite[], states?: Record<string, RunnableConfig | StateSnapshot>): PregelTaskDescription[];

package/dist/pregel/debug.js

@@ -1,6 +1,7 @@
 import { ERROR, INTERRUPT, TAG_HIDDEN } from "../constants.js";
 import { EmptyChannelError } from "../errors.js";
 import { readChannels } from "./io.js";
+import { findSubgraphPregel } from "./utils/subgraph.js";
 const COLORS_MAP = {
     blue: {
         start: "\x1b[34m",
@@ -95,7 +96,7 @@ export function* mapDebugTaskResults(step, tasks, streamChannels) {
         };
     }
 }
-export function* mapDebugCheckpoint(step, config, channels, streamChannels, metadata, tasks, pendingWrites) {
+export function* mapDebugCheckpoint(step, config, channels, streamChannels, metadata, tasks, pendingWrites, parentConfig) {
     function formatConfig(config) {
         // make sure the config is consistent with Python
         const pyConfig = {};
@@ -117,11 +118,22 @@ export function* mapDebugCheckpoint(step, config, channels, streamChannels, meta
             pyConfig.tags = config.tags;
         return pyConfig;
     }
-    function getCurrentUTC() {
-        const now = new Date();
-        return new Date(now.getTime() - now.getTimezoneOffset() * 60 * 1000);
+    const parentNs = config.configurable?.checkpoint_ns;
+    const taskStates = {};
+    for (const task of tasks) {
+        if (!findSubgraphPregel(task.proc))
+            continue;
+        let taskNs = `${task.name}:${task.id}`;
+        if (parentNs)
+            taskNs = `${parentNs}|${taskNs}`;
+        taskStates[task.id] = {
+            configurable: {
+                thread_id: config.configurable?.thread_id,
+                checkpoint_ns: taskNs,
+            },
+        };
     }
-    const ts = getCurrentUTC().toISOString();
+    const ts = new Date().toISOString();
     yield {
         type: "checkpoint",
         timestamp: ts,
@@ -131,7 +143,8 @@ export function* mapDebugCheckpoint(step, config, channels, streamChannels, meta
             values: readChannels(channels, streamChannels),
             metadata,
             next: tasks.map((task) => task.name),
-            tasks: tasksWithWrites(tasks, pendingWrites),
+            tasks: tasksWithWrites(tasks, pendingWrites, taskStates),
+            parentConfig: parentConfig ? formatConfig(parentConfig) : undefined,
         },
     };
 }

package/dist/pregel/index.cjs

@@ -18,6 +18,7 @@ const constants_js_1 = require("../constants.cjs");
 const errors_js_1 = require("../errors.cjs");
 const algo_js_1 = require("./algo.cjs");
 const index_js_1 = require("./utils/index.cjs");
+const subgraph_js_1 = require("./utils/subgraph.cjs");
 const loop_js_1 = require("./loop.cjs");
 const retry_js_1 = require("./retry.cjs");
 const base_js_2 = require("../managed/base.cjs");
@@ -81,16 +82,6 @@ class Channel {
     }
 }
 exports.Channel = Channel;
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-function isPregel(x) {
-    return ("inputChannels" in x &&
-        x.inputChannels !== undefined &&
-        "outputChannels" &&
-        x.outputChannels !== undefined);
-}
-function isRunnableSequence(x) {
-    return "steps" in x && Array.isArray(x.steps);
-}
 class Pregel extends runnables_1.Runnable {
     static lc_name() {
         return "LangGraph";
@@ -264,18 +255,7 @@ class Pregel extends runnables_1.Runnable {
                     continue;
                 }
             }
-            // find the subgraph if any
-            let graph;
-            const candidates = [node.bound];
-            for (const candidate of candidates) {
-                if (isPregel(candidate)) {
-                    graph = candidate;
-                    break;
-                }
-                else if (isRunnableSequence(candidate)) {
-                    candidates.push(...candidate.steps);
-                }
-            }
+            const graph = (0, subgraph_js_1.findSubgraphPregel)(node.bound);
             // if found, yield recursively
             if (graph !== undefined) {
                 if (name === namespace) {
@@ -814,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

@@ -12,6 +12,7 @@ import { CONFIG_KEY_CHECKPOINTER, CONFIG_KEY_READ, CONFIG_KEY_SEND, ERROR, INTER
 import { GraphRecursionError, GraphValueError, InvalidUpdateError, isGraphInterrupt, } from "../errors.js";
 import { _prepareNextTasks, _localRead, _applyWrites, } from "./algo.js";
 import { _coerceToDict, getNewChannelVersions, patchCheckpointMap, } from "./utils/index.js";
+import { findSubgraphPregel } from "./utils/subgraph.js";
 import { PregelLoop, StreamProtocol } from "./loop.js";
 import { executeTasksWithRetry } from "./retry.js";
 import { ChannelKeyPlaceholder, isConfiguredManagedValue, ManagedValueMapping, NoopManagedValue, } from "../managed/base.js";
@@ -74,16 +75,6 @@ export class Channel {
         return new ChannelWrite(channelWriteEntries);
     }
 }
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-function isPregel(x) {
-    return ("inputChannels" in x &&
-        x.inputChannels !== undefined &&
-        "outputChannels" &&
-        x.outputChannels !== undefined);
-}
-function isRunnableSequence(x) {
-    return "steps" in x && Array.isArray(x.steps);
-}
 export class Pregel extends Runnable {
     static lc_name() {
         return "LangGraph";
@@ -257,18 +248,7 @@ export class Pregel extends Runnable {
                     continue;
                 }
             }
-            // find the subgraph if any
-            let graph;
-            const candidates = [node.bound];
-            for (const candidate of candidates) {
-                if (isPregel(candidate)) {
-                    graph = candidate;
-                    break;
-                }
-                else if (isRunnableSequence(candidate)) {
-                    candidates.push(...candidate.steps);
-                }
-            }
+            const graph = findSubgraphPregel(node.bound);
             // if found, yield recursively
             if (graph !== undefined) {
                 if (name === namespace) {
@@ -807,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

@@ -166,6 +166,12 @@ class PregelLoop {
             writable: true,
             value: 0
         });
+        Object.defineProperty(this, "prevCheckpointConfig", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "status", {
             enumerable: true,
             configurable: true,
@@ -238,6 +244,7 @@ class PregelLoop {
         this.store = params.store;
         this.stream = params.stream;
         this.checkpointNamespace = params.checkpointNamespace;
+        this.prevCheckpointConfig = params.prevCheckpointConfig;
     }
     static async initialize(params) {
         let { config, stream } = params;
@@ -284,6 +291,7 @@ class PregelLoop {
                 ...saved.config.configurable,
             },
         };
+        const prevCheckpointConfig = saved.parentConfig;
         const checkpoint = (0, langgraph_checkpoint_1.copyCheckpoint)(saved.checkpoint);
         const checkpointMetadata = { ...saved.metadata };
         const checkpointPendingWrites = saved.pendingWrites ?? [];
@@ -305,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);
@@ -318,6 +328,7 @@ class PregelLoop {
             checkpoint,
             checkpointMetadata,
             checkpointConfig,
+            prevCheckpointConfig,
             checkpointNamespace,
             channels,
             managed: params.managed,
@@ -467,7 +478,7 @@ class PregelLoop {
             // Produce debug output
             if (this.checkpointer) {
                 this._emit(await (0, utils_js_1.gatherIterator)((0, utils_js_1.prefixGenerator)((0, debug_js_1.mapDebugCheckpoint)(this.step - 1, // printing checkpoint for previous step
-                this.checkpointConfig, this.channels, this.streamKeys, this.checkpointMetadata, Object.values(this.tasks), this.checkpointPendingWrites), "debug")));
+                this.checkpointConfig, this.channels, this.streamKeys, this.checkpointMetadata, Object.values(this.tasks), this.checkpointPendingWrites, this.prevCheckpointConfig), "debug")));
             }
             if (Object.values(this.tasks).length === 0) {
                 this.status = "done";
@@ -600,6 +611,11 @@ class PregelLoop {
         };
         // Bail if no checkpointer
         if (this.checkpointer !== undefined) {
+            // store the previous checkpoint config for debug events
+            this.prevCheckpointConfig = this.checkpointConfig?.configurable
+                ?.checkpoint_id
+                ? this.checkpointConfig
+                : undefined;
             // create new checkpoint
             this.checkpointMetadata = metadata;
             // child graphs keep at most one checkpoint per parent checkpoint

package/dist/pregel/loop.d.ts

@@ -41,6 +41,7 @@ type PregelLoopParams = {
     isNested: boolean;
     stream: StreamProtocol;
     store?: AsyncBatchedStore;
+    prevCheckpointConfig: RunnableConfig | undefined;
 };
 export declare class StreamProtocol {
     push: (chunk: StreamChunk) => void;
@@ -68,6 +69,7 @@ export declare class PregelLoop {
     protected nodes: Record<string, PregelNode>;
     protected skipDoneTasks: boolean;
     protected taskWritesLeft: number;
+    protected prevCheckpointConfig: RunnableConfig | undefined;
     status: "pending" | "done" | "interrupt_before" | "interrupt_after" | "out_of_steps";
     tasks: Record<string, PregelExecutableTask<any, any>>;
     stream: StreamProtocol;

package/dist/pregel/loop.js

@@ -162,6 +162,12 @@ export class PregelLoop {
             writable: true,
             value: 0
         });
+        Object.defineProperty(this, "prevCheckpointConfig", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "status", {
             enumerable: true,
             configurable: true,
@@ -234,6 +240,7 @@ export class PregelLoop {
         this.store = params.store;
         this.stream = params.stream;
         this.checkpointNamespace = params.checkpointNamespace;
+        this.prevCheckpointConfig = params.prevCheckpointConfig;
     }
     static async initialize(params) {
         let { config, stream } = params;
@@ -280,6 +287,7 @@ export class PregelLoop {
                 ...saved.config.configurable,
             },
         };
+        const prevCheckpointConfig = saved.parentConfig;
         const checkpoint = copyCheckpoint(saved.checkpoint);
         const checkpointMetadata = { ...saved.metadata };
         const checkpointPendingWrites = saved.pendingWrites ?? [];
@@ -301,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);
@@ -314,6 +324,7 @@ export class PregelLoop {
             checkpoint,
             checkpointMetadata,
             checkpointConfig,
+            prevCheckpointConfig,
             checkpointNamespace,
             channels,
             managed: params.managed,
@@ -463,7 +474,7 @@ export class PregelLoop {
             // Produce debug output
             if (this.checkpointer) {
                 this._emit(await gatherIterator(prefixGenerator(mapDebugCheckpoint(this.step - 1, // printing checkpoint for previous step
-                this.checkpointConfig, this.channels, this.streamKeys, this.checkpointMetadata, Object.values(this.tasks), this.checkpointPendingWrites), "debug")));
+                this.checkpointConfig, this.channels, this.streamKeys, this.checkpointMetadata, Object.values(this.tasks), this.checkpointPendingWrites, this.prevCheckpointConfig), "debug")));
             }
             if (Object.values(this.tasks).length === 0) {
                 this.status = "done";
@@ -596,6 +607,11 @@ export class PregelLoop {
         };
         // Bail if no checkpointer
         if (this.checkpointer !== undefined) {
+            // store the previous checkpoint config for debug events
+            this.prevCheckpointConfig = this.checkpointConfig?.configurable
+                ?.checkpoint_id
+                ? this.checkpointConfig
+                : undefined;
             // create new checkpoint
             this.checkpointMetadata = metadata;
             // child graphs keep at most one checkpoint per parent checkpoint

package/dist/pregel/retry.cjs

@@ -131,13 +131,9 @@ pregelTask, retryPolicy) {
                 error.constructor.unminifiable_name ??
                 error.constructor.name;
             console.log(`Retrying task "${pregelTask.name}" after ${interval.toFixed(2)} seconds (attempt ${attempts}) after ${errorName}: ${error}`);
-            // Clear checkpoint_ns seen (for subgraph detection)
-            const checkpointNs = pregelTask.config?.configurable?.checkpoint_ns;
-            if (checkpointNs) {
-                (0, errors_js_1.getSubgraphsSeenSet)().delete(checkpointNs);
-            }
         }
         finally {
+            // Clear checkpoint_ns seen (for subgraph detection)
             const checkpointNs = pregelTask.config?.configurable?.checkpoint_ns;
             if (checkpointNs) {
                 (0, errors_js_1.getSubgraphsSeenSet)().delete(checkpointNs);

package/dist/pregel/retry.js

@@ -127,13 +127,9 @@ pregelTask, retryPolicy) {
                 error.constructor.unminifiable_name ??
                 error.constructor.name;
             console.log(`Retrying task "${pregelTask.name}" after ${interval.toFixed(2)} seconds (attempt ${attempts}) after ${errorName}: ${error}`);
-            // Clear checkpoint_ns seen (for subgraph detection)
-            const checkpointNs = pregelTask.config?.configurable?.checkpoint_ns;
-            if (checkpointNs) {
-                getSubgraphsSeenSet().delete(checkpointNs);
-            }
         }
         finally {
+            // Clear checkpoint_ns seen (for subgraph detection)
             const checkpointNs = pregelTask.config?.configurable?.checkpoint_ns;
             if (checkpointNs) {
                 getSubgraphsSeenSet().delete(checkpointNs);

package/dist/pregel/utils/subgraph.cjs

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findSubgraphPregel = void 0;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function isRunnableSequence(x) {
+    return "steps" in x && Array.isArray(x.steps);
+}
+function isPregelLike(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+x
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+) {
+    return ("inputChannels" in x &&
+        x.inputChannels !== undefined &&
+        "outputChannels" &&
+        x.outputChannels !== undefined);
+}
+function findSubgraphPregel(candidate
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+) {
+    const candidates = [candidate];
+    for (const candidate of candidates) {
+        if (isPregelLike(candidate)) {
+            return candidate;
+        }
+        else if (isRunnableSequence(candidate)) {
+            candidates.push(...candidate.steps);
+        }
+    }
+    return undefined;
+}
+exports.findSubgraphPregel = findSubgraphPregel;

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

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

package/dist/pregel/utils/subgraph.js

@@ -0,0 +1,28 @@
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function isRunnableSequence(x) {
+    return "steps" in x && Array.isArray(x.steps);
+}
+function isPregelLike(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+x
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+) {
+    return ("inputChannels" in x &&
+        x.inputChannels !== undefined &&
+        "outputChannels" &&
+        x.outputChannels !== undefined);
+}
+export function findSubgraphPregel(candidate
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+) {
+    const candidates = [candidate];
+    for (const candidate of candidates) {
+        if (isPregelLike(candidate)) {
+            return candidate;
+        }
+        else if (isRunnableSequence(candidate)) {
+            candidates.push(...candidate.steps);
+        }
+    }
+    return undefined;
+}

package/dist/web.cjs

@@ -14,12 +14,13 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MessagesAnnotation = exports.InMemoryStore = exports.AsyncBatchedStore = exports.BaseStore = exports.BaseCheckpointSaver = exports.emptyCheckpoint = exports.copyCheckpoint = exports.MemorySaver = exports.Send = exports.BinaryOperatorAggregate = exports.BaseChannel = exports.Annotation = exports.messagesStateReducer = exports.MessageGraph = exports.StateGraph = exports.START = exports.Graph = exports.END = void 0;
+exports.MessagesAnnotation = exports.InMemoryStore = exports.AsyncBatchedStore = exports.BaseStore = exports.BaseCheckpointSaver = exports.emptyCheckpoint = exports.copyCheckpoint = exports.MemorySaver = exports.Send = exports.BinaryOperatorAggregate = exports.BaseChannel = exports.Annotation = exports.messagesStateReducer = exports.MessageGraph = exports.CompiledStateGraph = exports.StateGraph = exports.START = exports.Graph = exports.END = void 0;
 var index_js_1 = require("./graph/index.cjs");
 Object.defineProperty(exports, "END", { enumerable: true, get: function () { return index_js_1.END; } });
 Object.defineProperty(exports, "Graph", { enumerable: true, get: function () { return index_js_1.Graph; } });
 Object.defineProperty(exports, "START", { enumerable: true, get: function () { return index_js_1.START; } });
 Object.defineProperty(exports, "StateGraph", { enumerable: true, get: function () { return index_js_1.StateGraph; } });
+Object.defineProperty(exports, "CompiledStateGraph", { enumerable: true, get: function () { return index_js_1.CompiledStateGraph; } });
 Object.defineProperty(exports, "MessageGraph", { enumerable: true, get: function () { return index_js_1.MessageGraph; } });
 Object.defineProperty(exports, "messagesStateReducer", { enumerable: true, get: function () { return index_js_1.messagesStateReducer; } });
 Object.defineProperty(exports, "Annotation", { enumerable: true, get: function () { return index_js_1.Annotation; } });

package/dist/web.d.ts

@@ -1,4 +1,4 @@
-export { END, Graph, type StateGraphArgs, START, StateGraph, type CompiledStateGraph, MessageGraph, messagesStateReducer, type Messages, Annotation, type StateType, type UpdateType, type NodeType, type StateDefinition, type SingleReducer, type CompiledGraph, } from "./graph/index.js";
+export { END, Graph, type StateGraphArgs, START, StateGraph, CompiledStateGraph, MessageGraph, messagesStateReducer, type Messages, Annotation, type StateType, type UpdateType, type NodeType, type StateDefinition, type SingleReducer, type CompiledGraph, } from "./graph/index.js";
 export type { StateSnapshot } from "./pregel/types.js";
 export * from "./errors.js";
 export { BaseChannel, type BinaryOperator, BinaryOperatorAggregate, type AnyValue, type WaitForNames, type DynamicBarrierValue, type LastValue, type NamedBarrierValue, type Topic, } from "./channels/index.js";

package/dist/web.js

@@ -1,4 +1,4 @@
-export { END, Graph, START, StateGraph, MessageGraph, messagesStateReducer, Annotation, } from "./graph/index.js";
+export { END, Graph, START, StateGraph, CompiledStateGraph, MessageGraph, messagesStateReducer, Annotation, } from "./graph/index.js";
 export * from "./errors.js";
 export { BaseChannel, BinaryOperatorAggregate, } from "./channels/index.js";
 export { Send } from "./constants.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph",
-  "version": "0.2.14",
+  "version": "0.2.16",
   "description": "LangGraph",
   "type": "module",
   "engines": {
@@ -43,7 +43,7 @@
     "@jest/globals": "^29.5.0",
     "@langchain/anthropic": "^0.3.0",
     "@langchain/community": "^0.3.0",
-    "@langchain/core": "^0.3.6",
+    "@langchain/core": "^0.3.10",
     "@langchain/langgraph-checkpoint-postgres": "workspace:*",
     "@langchain/langgraph-checkpoint-sqlite": "workspace:*",
     "@langchain/openai": "^0.3.0",