@langchain/langgraph 0.2.24 → 0.2.26

package/dist/constants.d.ts

@@ -84,6 +84,8 @@ export declare function _isSend(x: unknown): x is Send;
 export type Interrupt = {
     value: any;
     when: "during";
+    resumable?: boolean;
+    ns?: string[];
 };
 export declare class Command<R = unknown> {
     lg_name: string;

package/dist/graph/graph.d.ts

@@ -62,17 +62,17 @@ export declare class Graph<N extends string = typeof END, RunInput = any, RunOut
     }): CompiledGraph<N>;
     validate(interrupt?: string[]): void;
 }
-export declare class CompiledGraph<N extends string, RunInput = any, RunOutput = any, ConfigurableFieldType extends Record<string, any> = Record<string, any>> extends Pregel<Record<N | typeof START, PregelNode<RunInput, RunOutput>>, Record<N | typeof START | typeof END | string, BaseChannel>, ConfigurableFieldType & Record<string, any>> {
+export declare class CompiledGraph<N extends string, State = any, Update = any, ConfigurableFieldType extends Record<string, any> = Record<string, any>> extends Pregel<Record<N | typeof START, PregelNode<State, Update>>, Record<N | typeof START | typeof END | string, BaseChannel>, ConfigurableFieldType & Record<string, any>, Update, State> {
     NodeType: N;
-    RunInput: RunInput;
-    RunOutput: RunOutput;
-    builder: Graph<N, RunInput, RunOutput>;
+    RunInput: State;
+    RunOutput: Update;
+    builder: Graph<N, State, Update>;
     constructor({ builder, ...rest }: {
-        builder: Graph<N, RunInput, RunOutput>;
-    } & PregelParams<Record<N | typeof START, PregelNode<RunInput, RunOutput>>, Record<N | typeof START | typeof END | string, BaseChannel>>);
-    attachNode(key: N, node: NodeSpec<RunInput, RunOutput>): void;
+        builder: Graph<N, State, Update>;
+    } & PregelParams<Record<N | typeof START, PregelNode<State, Update>>, Record<N | typeof START | typeof END | string, BaseChannel>>);
+    attachNode(key: N, node: NodeSpec<State, Update>): void;
     attachEdge(start: N | typeof START, end: N | typeof END): void;
-    attachBranch(start: N | typeof START, name: string, branch: Branch<RunInput, N>): void;
+    attachBranch(start: N | typeof START, name: string, branch: Branch<State, N>): void;
     /**
      * Returns a drawable representation of the computation graph.
      */

package/dist/interrupt.cjs

@@ -14,7 +14,14 @@ function interrupt(value) {
         return resume;
     }
     else {
-        throw new errors_js_1.GraphInterrupt([{ value, when: "during" }]);
+        throw new errors_js_1.GraphInterrupt([
+            {
+                value,
+                when: "during",
+                resumable: true,
+                ns: config.configurable?.checkpoint_ns?.split("|"),
+            },
+        ]);
     }
 }
 exports.interrupt = interrupt;

package/dist/interrupt.js

@@ -11,6 +11,13 @@ export function interrupt(value) {
         return resume;
     }
     else {
-        throw new GraphInterrupt([{ value, when: "during" }]);
+        throw new GraphInterrupt([
+            {
+                value,
+                when: "during",
+                resumable: true,
+                ns: config.configurable?.checkpoint_ns?.split("|"),
+            },
+        ]);
     }
 }

package/dist/prebuilt/react_agent_executor.cjs

@@ -5,6 +5,7 @@ const messages_1 = require("@langchain/core/messages");
 const runnables_1 = require("@langchain/core/runnables");
 const prompts_1 = require("@langchain/core/prompts");
 const index_js_1 = require("../graph/index.cjs");
+const messages_annotation_js_1 = require("../graph/messages_annotation.cjs");
 const tool_node_js_1 = require("./tool_node.cjs");
 /**
  * Creates a StateGraph agent that relies on a chat model utilizing tool calling.
@@ -58,12 +59,6 @@ const tool_node_js_1 = require("./tool_node.cjs");
  */
 function createReactAgent(params) {
     const { llm, tools, messageModifier, checkpointSaver, interruptBefore, interruptAfter, } = params;
-    const schema = {
-        messages: {
-            value: index_js_1.messagesStateReducer,
-            default: () => [],
-        },
-    };
     let toolClasses;
     if (!Array.isArray(tools)) {
         toolClasses = tools.tools;
@@ -92,9 +87,7 @@ function createReactAgent(params) {
         // TODO: Auto-promote streaming.
         return { messages: [await modelRunnable.invoke(messages, config)] };
     };
-    const workflow = new index_js_1.StateGraph({
-        channels: schema,
-    })
+    const workflow = new index_js_1.StateGraph(messages_annotation_js_1.MessagesAnnotation)
         .addNode("agent", callModel)
         .addNode("tools", new tool_node_js_1.ToolNode(toolClasses))
         .addEdge(index_js_1.START, "agent")

package/dist/prebuilt/react_agent_executor.d.ts

@@ -69,4 +69,4 @@ export type CreateReactAgentParams = {
  * // Returns the messages in the state at each step of execution
  * ```
  */
-export declare function createReactAgent(params: CreateReactAgentParams): CompiledStateGraph<AgentState, Partial<AgentState>, typeof START | "agent" | "tools">;
+export declare function createReactAgent(params: CreateReactAgentParams): CompiledStateGraph<(typeof MessagesAnnotation)["State"], (typeof MessagesAnnotation)["Update"], typeof START | "agent" | "tools">;

package/dist/prebuilt/react_agent_executor.js

@@ -1,7 +1,8 @@
 import { isAIMessage, SystemMessage, } from "@langchain/core/messages";
 import { Runnable, RunnableLambda, } from "@langchain/core/runnables";
 import { ChatPromptTemplate } from "@langchain/core/prompts";
-import { END, messagesStateReducer, START, StateGraph, } from "../graph/index.js";
+import { END, START, StateGraph } from "../graph/index.js";
+import { MessagesAnnotation } from "../graph/messages_annotation.js";
 import { ToolNode } from "./tool_node.js";
 /**
  * Creates a StateGraph agent that relies on a chat model utilizing tool calling.
@@ -55,12 +56,6 @@ import { ToolNode } from "./tool_node.js";
  */
 export function createReactAgent(params) {
     const { llm, tools, messageModifier, checkpointSaver, interruptBefore, interruptAfter, } = params;
-    const schema = {
-        messages: {
-            value: messagesStateReducer,
-            default: () => [],
-        },
-    };
     let toolClasses;
     if (!Array.isArray(tools)) {
         toolClasses = tools.tools;
@@ -89,9 +84,7 @@ export function createReactAgent(params) {
         // TODO: Auto-promote streaming.
         return { messages: [await modelRunnable.invoke(messages, config)] };
     };
-    const workflow = new StateGraph({
-        channels: schema,
-    })
+    const workflow = new StateGraph(MessagesAnnotation)
         .addNode("agent", callModel)
         .addNode("tools", new ToolNode(toolClasses))
         .addEdge(START, "agent")

package/dist/pregel/debug.cjs

@@ -94,9 +94,7 @@ function* mapDebugTaskResults(step, tasks, streamChannels) {
                         ? streamChannels.includes(channel)
                         : channel === streamChannels;
                 }),
-                interrupts: writes.filter(([channel]) => {
-                    return channel === constants_js_1.INTERRUPT;
-                }),
+                interrupts: writes.filter((w) => w[0] === constants_js_1.INTERRUPT).map((w) => w[1]),
             },
         };
     }

package/dist/pregel/debug.d.ts

@@ -23,7 +23,7 @@ export declare function mapDebugTaskResults<N extends PropertyKey, C extends Pro
         id: string;
         name: N;
         result: PendingWrite<C>[];
-        interrupts: PendingWrite<C>[];
+        interrupts: unknown[];
     };
 }, 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[], parentConfig: RunnableConfig | undefined): Generator<{

package/dist/pregel/debug.js

@@ -89,9 +89,7 @@ export function* mapDebugTaskResults(step, tasks, streamChannels) {
                         ? streamChannels.includes(channel)
                         : channel === streamChannels;
                 }),
-                interrupts: writes.filter(([channel]) => {
-                    return channel === INTERRUPT;
-                }),
+                interrupts: writes.filter((w) => w[0] === INTERRUPT).map((w) => w[1]),
             },
         };
     }

package/dist/pregel/index.d.ts

@@ -22,7 +22,7 @@ export declare class Channel {
     static writeTo(channels: string[], kwargs?: Record<string, WriteValue>): ChannelWrite;
 }
 export type { PregelInputType, PregelOutputType, PregelOptions };
-export declare class Pregel<Nn extends StrRecord<string, PregelNode>, Cc extends StrRecord<string, BaseChannel | ManagedValueSpec>, ConfigurableFieldType extends Record<string, any> = StrRecord<string, any>> extends Runnable<PregelInputType, PregelOutputType, PregelOptions<Nn, Cc, ConfigurableFieldType>> implements PregelInterface<Nn, Cc, ConfigurableFieldType>, PregelParams<Nn, Cc> {
+export declare class Pregel<Nn extends StrRecord<string, PregelNode>, Cc extends StrRecord<string, BaseChannel | ManagedValueSpec>, ConfigurableFieldType extends Record<string, any> = StrRecord<string, any>, InputType = PregelInputType, OutputType = PregelOutputType> extends Runnable<InputType | Command | null, OutputType, PregelOptions<Nn, Cc, ConfigurableFieldType>> implements PregelInterface<Nn, Cc, ConfigurableFieldType>, PregelParams<Nn, Cc> {
     static lc_name(): string;
     lc_namespace: string[];
     lg_is_pregel: boolean;
@@ -103,7 +103,7 @@ export declare class Pregel<Nn extends StrRecord<string, PregelNode>, Cc extends
      * @param options.interruptAfter Nodes to interrupt after.
      * @param options.debug Whether to print debug information during execution.
      */
-    stream(input: PregelInputType | Command, options?: Partial<PregelOptions<Nn, Cc, ConfigurableFieldType>>): Promise<IterableReadableStream<PregelOutputType>>;
+    stream(input: InputType | Command | null, options?: Partial<PregelOptions<Nn, Cc, ConfigurableFieldType>>): Promise<IterableReadableStream<PregelOutputType>>;
     protected prepareSpecs(config: RunnableConfig, options?: {
         skipManaged?: boolean;
     }): Promise<{
@@ -126,5 +126,5 @@ export declare class Pregel<Nn extends StrRecord<string, PregelNode>, Cc extends
      * @param options.interruptAfter Nodes to interrupt after.
      * @param options.debug Whether to print debug information during execution.
      */
-    invoke(input: PregelInputType | Command, options?: Partial<PregelOptions<Nn, Cc, ConfigurableFieldType>>): Promise<PregelOutputType>;
+    invoke(input: InputType | Command | null, options?: Partial<PregelOptions<Nn, Cc, ConfigurableFieldType>>): Promise<OutputType>;
 }

package/dist/pregel/messages.cjs

@@ -68,7 +68,7 @@ class StreamMessagesHandler extends base_1.BaseCallbackHandler {
             // Include legacy LangGraph SDK tag
             (!tags || !(tags.includes(constants_js_1.TAG_NOSTREAM) && tags.includes("nostream")))) {
             this.metadatas[runId] = [
-                metadata.langgraph_checkpoint_ns.split("NS_SEP"),
+                metadata.langgraph_checkpoint_ns.split("|"),
                 { tags, name, ...metadata },
             ];
         }
@@ -105,7 +105,7 @@ class StreamMessagesHandler extends base_1.BaseCallbackHandler {
             name === metadata.langgraph_node &&
             (tags === undefined || !tags.includes(constants_js_1.TAG_HIDDEN))) {
             this.metadatas[runId] = [
-                metadata.langgraph_checkpoint_ns.split("NS_SEP"),
+                metadata.langgraph_checkpoint_ns.split("|"),
                 { tags, name, ...metadata },
             ];
         }

package/dist/pregel/messages.js

@@ -65,7 +65,7 @@ export class StreamMessagesHandler extends BaseCallbackHandler {
             // Include legacy LangGraph SDK tag
             (!tags || !(tags.includes(TAG_NOSTREAM) && tags.includes("nostream")))) {
             this.metadatas[runId] = [
-                metadata.langgraph_checkpoint_ns.split("NS_SEP"),
+                metadata.langgraph_checkpoint_ns.split("|"),
                 { tags, name, ...metadata },
             ];
         }
@@ -102,7 +102,7 @@ export class StreamMessagesHandler extends BaseCallbackHandler {
             name === metadata.langgraph_node &&
             (tags === undefined || !tags.includes(TAG_HIDDEN))) {
             this.metadatas[runId] = [
-                metadata.langgraph_checkpoint_ns.split("NS_SEP"),
+                metadata.langgraph_checkpoint_ns.split("|"),
                 { tags, name, ...metadata },
             ];
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph",
-  "version": "0.2.24",
+  "version": "0.2.26",
   "description": "LangGraph",
   "type": "module",
   "engines": {
@@ -43,7 +43,7 @@
     "@jest/globals": "^29.5.0",
     "@langchain/anthropic": "^0.3.5",
     "@langchain/community": "^0.3.9",
-    "@langchain/core": "^0.3.16",
+    "@langchain/core": "^0.3.22",
     "@langchain/langgraph-checkpoint-postgres": "workspace:*",
     "@langchain/langgraph-checkpoint-sqlite": "workspace:*",
     "@langchain/openai": "^0.3.11",