@langchain/langgraph 1.2.9 → 1.3.0

package/dist/pregel/index.d.cts

@@ -3,8 +3,10 @@ import { Command, CommandInstance } from "../constants.cjs";
 import { LangGraphRunnableConfig } from "./runnable_types.cjs";
 import { RetryPolicy } from "./utils/index.cjs";
 import { PregelNode } from "./read.cjs";
+import { InferExtensions, StreamTransformer } from "../stream/types.cjs";
 import { Durability, GetStateOptions, MultipleChannelSubscriptionOptions, PregelInputType, PregelInterface, PregelOptions, PregelOutputType, PregelParams, SingleChannelSubscriptionOptions, StateSnapshot, StreamMode, StreamOutputMap } from "./types.cjs";
 import { StrRecord } from "./algo.cjs";
+import { GraphRunStream } from "../stream/run-stream.cjs";
 import { ChannelWrite } from "./write.cjs";
 import { All, BaseCache, BaseCheckpointSaver, BaseStore, CheckpointListOptions, CheckpointTuple } from "@langchain/langgraph-checkpoint";
 import { Runnable, RunnableConfig, RunnableFunc } from "@langchain/core/runnables";
@@ -15,6 +17,14 @@ import { IterableReadableStream } from "@langchain/core/utils/stream";
 //#region src/pregel/index.d.ts
 type WriteValue = Runnable | RunnableFunc<unknown, unknown> | unknown;
 type StreamEventsOptions = Parameters<Runnable["streamEvents"]>[2];
+type StreamEventsV3Options<Nodes extends StrRecord<string, PregelNode>, Channels extends StrRecord<string, BaseChannel>, ContextType extends Record<string, any>, TTransformers extends ReadonlyArray<() => StreamTransformer<any>>, TEncoding extends "text/event-stream" | undefined = undefined> = Partial<Omit<PregelOptions<Nodes, Channels, ContextType>, "encoding" | "subgraphs">> & {
+  version: "v3"; /** User-supplied transformer factories for custom projections. */
+  transformers?: TTransformers;
+} & (TEncoding extends "text/event-stream" ? {
+  encoding: "text/event-stream";
+} : {
+  encoding?: undefined;
+});
 /**
  * Utility class for working with channels in the Pregel system.
  * Provides static methods for subscribing to channels and writing to them.
@@ -159,7 +169,8 @@ declare class PartialRunnable<RunInput, RunOutput, CallOptions extends RunnableC
  * @typeParam InputType - Type of input values accepted by the graph
  * @typeParam OutputType - Type of output values produced by the graph
  */
-declare class Pregel<Nodes extends StrRecord<string, PregelNode>, Channels extends StrRecord<string, BaseChannel>, ContextType extends Record<string, any> = StrRecord<string, any>, InputType = PregelInputType, OutputType = PregelOutputType, StreamUpdatesType = InputType, StreamValuesType = OutputType, NodeReturnType = unknown, CommandType = CommandInstance, StreamCustom = any> extends PartialRunnable<InputType | CommandType | null, OutputType, PregelOptions<Nodes, Channels, ContextType>> implements PregelInterface<Nodes, Channels, ContextType> {
+declare class Pregel<Nodes extends StrRecord<string, PregelNode>, Channels extends StrRecord<string, BaseChannel>, ContextType extends Record<string, any> = StrRecord<string, any>, InputType = PregelInputType, OutputType = PregelOutputType, StreamUpdatesType = InputType, StreamValuesType = OutputType, NodeReturnType = unknown, CommandType = CommandInstance, StreamCustom = any, TStreamTransformers extends ReadonlyArray<() => StreamTransformer<any>> = []> extends PartialRunnable<InputType | CommandType | null, OutputType, PregelOptions<Nodes, Channels, ContextType>> implements PregelInterface<Nodes, Channels, ContextType> {
+  #private;
   /**
    * Name of the class when serialized
    * @internal
@@ -242,6 +253,12 @@ declare class Pregel<Nodes extends StrRecord<string, PregelNode>, Channels exten
    * @internal
    */
   private userInterrupt?;
+  /**
+   * Stream reducer factories registered at compile time.  These run
+   * automatically for every `streamEvents(..., { version: "v3" })` call,
+   * before any call-site transformers.
+   */
+  streamTransformers: TStreamTransformers;
   /**
    * The trigger to node mapping for the graph run.
    * @internal
@@ -252,7 +269,7 @@ declare class Pregel<Nodes extends StrRecord<string, PregelNode>, Channels exten
    *
    * @internal
    */
-  constructor(fields: PregelParams<Nodes, Channels>);
+  constructor(fields: PregelParams<Nodes, Channels, TStreamTransformers>);
   /**
    * Creates a new instance of the Pregel graph with updated configuration.
    * This method follows the immutable pattern - instead of modifying the current instance,
@@ -272,7 +289,10 @@ declare class Pregel<Nodes extends StrRecord<string, PregelNode>, Channels exten
    * @param config - The configuration to merge with the current configuration
    * @returns A new Pregel instance with the merged configuration
    */
-  withConfig(config: Omit<LangGraphRunnableConfig, "store" | "writer" | "interrupt">): typeof this;
+  withConfig<const TTransformers extends ReadonlyArray<() => StreamTransformer<any>> = []>(config: Omit<LangGraphRunnableConfig, "store" | "writer" | "interrupt"> & {
+    streamTransformers: TTransformers;
+  }): Pregel<Nodes, Channels, ContextType, InputType, OutputType, StreamUpdatesType, StreamValuesType, NodeReturnType, CommandType, StreamCustom, readonly [...TStreamTransformers, ...TTransformers]>;
+  withConfig(config: PregelOptions<Nodes, Channels, ContextType>): this;
   /**
    * Validates the graph structure to ensure it is well-formed.
    * Checks for:
@@ -454,6 +474,8 @@ declare class Pregel<Nodes extends StrRecord<string, PregelNode>, Channels exten
   /**
    * @inheritdoc
    */
+  streamEvents<const TTransformers extends ReadonlyArray<() => StreamTransformer<any>> = []>(input: InputType | CommandType | null, options: StreamEventsV3Options<Nodes, Channels, ContextType, TTransformers, "text/event-stream">): Promise<IterableReadableStream<Uint8Array>>;
+  streamEvents<const TTransformers extends ReadonlyArray<() => StreamTransformer<any>> = []>(input: InputType | CommandType | null, options: StreamEventsV3Options<Nodes, Channels, ContextType, TTransformers>): Promise<GraphRunStream<OutputType, InferExtensions<readonly [...TStreamTransformers, ...TTransformers]>>>;
   streamEvents(input: InputType | CommandType | null, options: Partial<PregelOptions<Nodes, Channels, ContextType>> & {
     version: "v1" | "v2";
   }, streamOptions?: StreamEventsOptions): IterableReadableStream<StreamEvent>;

package/dist/pregel/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/pregel/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/pregel/index.ts"],"mappings":"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"}

package/dist/pregel/index.d.ts

@@ -3,8 +3,10 @@ import { Command, CommandInstance } from "../constants.js";
 import { LangGraphRunnableConfig } from "./runnable_types.js";
 import { RetryPolicy } from "./utils/index.js";
 import { PregelNode } from "./read.js";
+import { InferExtensions, StreamTransformer } from "../stream/types.js";
 import { Durability, GetStateOptions, MultipleChannelSubscriptionOptions, PregelInputType, PregelInterface, PregelOptions, PregelOutputType, PregelParams, SingleChannelSubscriptionOptions, StateSnapshot, StreamMode, StreamOutputMap } from "./types.js";
 import { StrRecord } from "./algo.js";
+import { GraphRunStream } from "../stream/run-stream.js";
 import { ChannelWrite } from "./write.js";
 import { All, BaseCache, BaseCheckpointSaver, BaseStore, CheckpointListOptions, CheckpointTuple } from "@langchain/langgraph-checkpoint";
 import { Runnable, RunnableConfig, RunnableFunc } from "@langchain/core/runnables";
@@ -15,6 +17,14 @@ import { StreamEvent } from "@langchain/core/tracers/log_stream";
 //#region src/pregel/index.d.ts
 type WriteValue = Runnable | RunnableFunc<unknown, unknown> | unknown;
 type StreamEventsOptions = Parameters<Runnable["streamEvents"]>[2];
+type StreamEventsV3Options<Nodes extends StrRecord<string, PregelNode>, Channels extends StrRecord<string, BaseChannel>, ContextType extends Record<string, any>, TTransformers extends ReadonlyArray<() => StreamTransformer<any>>, TEncoding extends "text/event-stream" | undefined = undefined> = Partial<Omit<PregelOptions<Nodes, Channels, ContextType>, "encoding" | "subgraphs">> & {
+  version: "v3"; /** User-supplied transformer factories for custom projections. */
+  transformers?: TTransformers;
+} & (TEncoding extends "text/event-stream" ? {
+  encoding: "text/event-stream";
+} : {
+  encoding?: undefined;
+});
 /**
  * Utility class for working with channels in the Pregel system.
  * Provides static methods for subscribing to channels and writing to them.
@@ -159,7 +169,8 @@ declare class PartialRunnable<RunInput, RunOutput, CallOptions extends RunnableC
  * @typeParam InputType - Type of input values accepted by the graph
  * @typeParam OutputType - Type of output values produced by the graph
  */
-declare class Pregel<Nodes extends StrRecord<string, PregelNode>, Channels extends StrRecord<string, BaseChannel>, ContextType extends Record<string, any> = StrRecord<string, any>, InputType = PregelInputType, OutputType = PregelOutputType, StreamUpdatesType = InputType, StreamValuesType = OutputType, NodeReturnType = unknown, CommandType = CommandInstance, StreamCustom = any> extends PartialRunnable<InputType | CommandType | null, OutputType, PregelOptions<Nodes, Channels, ContextType>> implements PregelInterface<Nodes, Channels, ContextType> {
+declare class Pregel<Nodes extends StrRecord<string, PregelNode>, Channels extends StrRecord<string, BaseChannel>, ContextType extends Record<string, any> = StrRecord<string, any>, InputType = PregelInputType, OutputType = PregelOutputType, StreamUpdatesType = InputType, StreamValuesType = OutputType, NodeReturnType = unknown, CommandType = CommandInstance, StreamCustom = any, TStreamTransformers extends ReadonlyArray<() => StreamTransformer<any>> = []> extends PartialRunnable<InputType | CommandType | null, OutputType, PregelOptions<Nodes, Channels, ContextType>> implements PregelInterface<Nodes, Channels, ContextType> {
+  #private;
   /**
    * Name of the class when serialized
    * @internal
@@ -242,6 +253,12 @@ declare class Pregel<Nodes extends StrRecord<string, PregelNode>, Channels exten
    * @internal
    */
   private userInterrupt?;
+  /**
+   * Stream reducer factories registered at compile time.  These run
+   * automatically for every `streamEvents(..., { version: "v3" })` call,
+   * before any call-site transformers.
+   */
+  streamTransformers: TStreamTransformers;
   /**
    * The trigger to node mapping for the graph run.
    * @internal
@@ -252,7 +269,7 @@ declare class Pregel<Nodes extends StrRecord<string, PregelNode>, Channels exten
    *
    * @internal
    */
-  constructor(fields: PregelParams<Nodes, Channels>);
+  constructor(fields: PregelParams<Nodes, Channels, TStreamTransformers>);
   /**
    * Creates a new instance of the Pregel graph with updated configuration.
    * This method follows the immutable pattern - instead of modifying the current instance,
@@ -272,7 +289,10 @@ declare class Pregel<Nodes extends StrRecord<string, PregelNode>, Channels exten
    * @param config - The configuration to merge with the current configuration
    * @returns A new Pregel instance with the merged configuration
    */
-  withConfig(config: Omit<LangGraphRunnableConfig, "store" | "writer" | "interrupt">): typeof this;
+  withConfig<const TTransformers extends ReadonlyArray<() => StreamTransformer<any>> = []>(config: Omit<LangGraphRunnableConfig, "store" | "writer" | "interrupt"> & {
+    streamTransformers: TTransformers;
+  }): Pregel<Nodes, Channels, ContextType, InputType, OutputType, StreamUpdatesType, StreamValuesType, NodeReturnType, CommandType, StreamCustom, readonly [...TStreamTransformers, ...TTransformers]>;
+  withConfig(config: PregelOptions<Nodes, Channels, ContextType>): this;
   /**
    * Validates the graph structure to ensure it is well-formed.
    * Checks for:
@@ -454,6 +474,8 @@ declare class Pregel<Nodes extends StrRecord<string, PregelNode>, Channels exten
   /**
    * @inheritdoc
    */
+  streamEvents<const TTransformers extends ReadonlyArray<() => StreamTransformer<any>> = []>(input: InputType | CommandType | null, options: StreamEventsV3Options<Nodes, Channels, ContextType, TTransformers, "text/event-stream">): Promise<IterableReadableStream<Uint8Array>>;
+  streamEvents<const TTransformers extends ReadonlyArray<() => StreamTransformer<any>> = []>(input: InputType | CommandType | null, options: StreamEventsV3Options<Nodes, Channels, ContextType, TTransformers>): Promise<GraphRunStream<OutputType, InferExtensions<readonly [...TStreamTransformers, ...TTransformers]>>>;
   streamEvents(input: InputType | CommandType | null, options: Partial<PregelOptions<Nodes, Channels, ContextType>> & {
     version: "v1" | "v2";
   }, streamOptions?: StreamEventsOptions): IterableReadableStream<StreamEvent>;

package/dist/pregel/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/pregel/index.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/pregel/index.ts"],"mappings":"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"}

package/dist/pregel/index.js

@@ -13,7 +13,11 @@ import { printStepCheckpoint, printStepTasks, printStepWrites, tasksWithWrites }
 import { IterableReadableStreamWithAbortSignal, IterableReadableWritableStream, StreamToolsHandler, toEventStream } from "./stream.js";
 import { PregelLoop } from "./loop.js";
 import { StreamMessagesHandler } from "./messages.js";
+import { StreamProtocolMessagesHandler } from "./messages-v2.js";
 import { PregelRunner } from "./runner.js";
+import { STREAM_EVENTS_V3_MODES } from "../stream/convert.js";
+import { createGraphRunStream } from "../stream/run-stream.js";
+import "../stream/index.js";
 import { validateGraph, validateKeys } from "./validate.js";
 import { Topic } from "../channels/topic.js";
 import { interrupt } from "../interrupt.js";
@@ -21,6 +25,22 @@ import { SCHEDULED, compareChannelVersions, copyCheckpoint, emptyCheckpoint, uui
 import { Runnable, RunnableSequence, _coerceToRunnable, mergeConfigs, patchConfig } from "@langchain/core/runnables";
 import { CallbackManager } from "@langchain/core/callbacks/manager";
 //#region src/pregel/index.ts
+function protocolEventsToEventStream(run) {
+	const encoder = new TextEncoder();
+	return new ReadableStream({ async start(controller) {
+		try {
+			for await (const event of run) {
+				const namespace = event.params.namespace;
+				const eventName = namespace.length ? `${event.method}|${namespace.join("|")}` : event.method;
+				controller.enqueue(encoder.encode(`event: ${eventName}\ndata: ${JSON.stringify(event.params.data ?? {})}\n\n`));
+			}
+		} catch (error) {
+			controller.enqueue(encoder.encode(`event: error\ndata: ${JSON.stringify({ message: String(error) })}\n\n`));
+		} finally {
+			controller.close();
+		}
+	} });
+}
 /**
 * Utility class for working with channels in the Pregel system.
 * Provides static methods for subscribing to channels and writing to them.
@@ -245,6 +265,12 @@ var Pregel = class extends PartialRunnable {
 	*/
 	userInterrupt;
 	/**
+	* Stream reducer factories registered at compile time.  These run
+	* automatically for every `streamEvents(..., { version: "v3" })` call,
+	* before any call-site transformers.
+	*/
+	streamTransformers;
+	/**
 	* The trigger to node mapping for the graph run.
 	* @internal
 	*/
@@ -279,32 +305,17 @@ var Pregel = class extends PartialRunnable {
 		this.name = fields.name;
 		this.triggerToNodes = fields.triggerToNodes ?? this.triggerToNodes;
 		this.userInterrupt = fields.userInterrupt;
+		this.streamTransformers = fields.streamTransformers ?? [];
 		if (this.autoValidate) this.validate();
 	}
-	/**
-	* Creates a new instance of the Pregel graph with updated configuration.
-	* This method follows the immutable pattern - instead of modifying the current instance,
-	* it returns a new instance with the merged configuration.
-	*
-	* @example
-	* ```typescript
-	* // Create a new instance with debug enabled
-	* const debugGraph = graph.withConfig({ debug: true });
-	*
-	* // Create a new instance with a specific thread ID
-	* const threadGraph = graph.withConfig({
-	*   configurable: { thread_id: "123" }
-	* });
-	* ```
-	*
-	* @param config - The configuration to merge with the current configuration
-	* @returns A new Pregel instance with the merged configuration
-	*/
 	withConfig(config) {
-		const mergedConfig = mergeConfigs(this.config, config);
+		const { streamTransformers, ...restConfig } = config;
+		const mergedConfig = mergeConfigs(this.config, restConfig);
+		const mergedStreamTransformers = [...this.streamTransformers, ...streamTransformers ?? []];
 		return new this.constructor({
 			...this,
-			config: mergedConfig
+			config: mergedConfig,
+			streamTransformers: mergedStreamTransformers
 		});
 	}
 	/**
@@ -913,7 +924,34 @@ var Pregel = class extends PartialRunnable {
 		const stream = await super.stream(input, config);
 		return new IterableReadableStreamWithAbortSignal(options?.encoding === "text/event-stream" ? toEventStream(stream) : stream, abortController);
 	}
+	async #streamEventsV3(input, options) {
+		const { version, encoding, transformers: userTransformers, ...restOptions } = options;
+		const streamOptions = {
+			recursionLimit: this.config?.recursionLimit,
+			...restOptions,
+			configurable: {
+				...this.config?.configurable,
+				...restOptions?.configurable
+			},
+			version,
+			streamMode: STREAM_EVENTS_V3_MODES,
+			subgraphs: true,
+			encoding: void 0
+		};
+		const sourcePromise = this.stream(input, streamOptions);
+		const graphRun = createGraphRunStream({ [Symbol.asyncIterator]: async function* () {
+			const src = await sourcePromise;
+			for await (const chunk of src) yield chunk;
+		} }, [...this.streamTransformers ?? [], ...userTransformers ?? []]);
+		if (encoding === "text/event-stream") {
+			const abortController = new AbortController();
+			abortController.signal.addEventListener("abort", () => graphRun.abort(abortController.signal.reason), { once: true });
+			return new IterableReadableStreamWithAbortSignal(protocolEventsToEventStream(graphRun), abortController);
+		}
+		return graphRun;
+	}
 	streamEvents(input, options, streamOptions) {
+		if (options.version === "v3") return this.#streamEventsV3(input, options);
 		const abortController = new AbortController();
 		const config = {
 			recursionLimit: this.config?.recursionLimit,
@@ -972,7 +1010,7 @@ var Pregel = class extends PartialRunnable {
 			config.configurable[CONFIG_KEY_CHECKPOINT_NS] = ns.split("|").map((part) => part.split(":")[0]).join("|");
 		}
 		if (streamMode.includes("messages")) {
-			const messageStreamer = new StreamMessagesHandler((chunk) => stream.push(chunk));
+			const messageStreamer = options?.version === "v3" ? new StreamProtocolMessagesHandler((chunk) => stream.push(chunk)) : new StreamMessagesHandler((chunk) => stream.push(chunk));
 			const { callbacks } = config;
 			if (callbacks === void 0) config.callbacks = [messageStreamer];
 			else if (Array.isArray(callbacks)) config.callbacks = callbacks.concat(messageStreamer);
@@ -1004,7 +1042,8 @@ var Pregel = class extends PartialRunnable {
 		};
 		config.interrupt ??= this.userInterrupt ?? interrupt;
 		if (config.serverInfo == null) config.serverInfo = _buildServerInfo(config);
-		const runManager = await (await CallbackManager._configureSync(config?.callbacks, void 0, config?.tags, void 0, config?.metadata, void 0, { tracerInheritableMetadata: _getTracingMetadataDefaults(config) }))?.handleChainStart(this.toJSON(), _coerceToDict(input, "input"), runId, void 0, void 0, void 0, config?.runName ?? this.getName());
+		const callbackManagerOptions = { tracerInheritableMetadata: _getTracingMetadataDefaults(config) };
+		const runManager = await (await CallbackManager._configureSync(config?.callbacks, void 0, config?.tags, void 0, config?.metadata, void 0, callbackManagerOptions))?.handleChainStart(this.toJSON(), _coerceToDict(input, "input"), runId, void 0, void 0, void 0, config?.runName ?? this.getName());
 		const channelSpecs = getOnlyChannels(this.channels);
 		let loop;
 		let loopError;
@@ -1071,7 +1110,7 @@ var Pregel = class extends PartialRunnable {
 		try {
 			for await (const chunk of stream) {
 				if (chunk === void 0) throw new Error("Data structure error.");
-				const [namespace, mode, payload] = chunk;
+				const [namespace, mode, payload, meta] = chunk;
 				if (streamMode.includes(mode)) {
 					if (streamEncoding === "text/event-stream") {
 						if (streamSubgraphs) yield [
@@ -1086,7 +1125,12 @@ var Pregel = class extends PartialRunnable {
 						];
 						continue;
 					}
-					if (streamSubgraphs && !streamModeSingle) yield [
+					if (streamSubgraphs && !streamModeSingle) yield meta !== void 0 ? [
+						namespace,
+						mode,
+						payload,
+						meta
+					] : [
 						namespace,
 						mode,
 						payload