@langchain/langgraph 1.2.8 → 1.3.0

package/dist/pregel/types.d.ts

@@ -3,6 +3,7 @@ import { Interrupt } from "../constants.js";
 import { LangGraphRunnableConfig } from "./runnable_types.js";
 import { CachePolicy, RetryPolicy } from "./utils/index.js";
 import { PregelNode } from "./read.js";
+import { StreamTransformer } from "../stream/types.js";
 import { All, BaseCache, BaseCheckpointSaver, BaseStore, CheckpointListOptions, CheckpointMetadata, PendingWrite } from "@langchain/langgraph-checkpoint";
 import { Runnable, RunnableConfig } from "@langchain/core/runnables";
 import { Graph } from "@langchain/core/runnables/graph";
@@ -263,7 +264,7 @@ interface PregelInterface<Nodes extends StrRecord<string, PregelNode>, Channels
  * Parameters for creating a Pregel graph.
  * @internal
  */
-type PregelParams<Nodes extends StrRecord<string, PregelNode>, Channels extends StrRecord<string, BaseChannel>> = {
+type PregelParams<Nodes extends StrRecord<string, PregelNode>, Channels extends StrRecord<string, BaseChannel>, TStreamTransformers extends ReadonlyArray<() => StreamTransformer<any>> = []> = {
   /**
    * The name of the graph. @see {@link Runnable.name}
    */
@@ -349,6 +350,12 @@ type PregelParams<Nodes extends StrRecord<string, PregelNode>, Channels extends
    * @internal
    */
   userInterrupt?: unknown;
+  /**
+   * Stream transformer factories registered at compile time.  These run
+   * automatically for every `streamEvents(..., { version: "v3" })` call,
+   * before any call-site transformers.
+   */
+  streamTransformers?: TStreamTransformers;
 };
 interface PregelTaskDescription {
   readonly id: string;

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

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

package/dist/pregel/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../src/pregel/types.ts"],"sourcesContent":["import type { Runnable, RunnableConfig } from \"@langchain/core/runnables\";\nimport type {\n  All,\n  PendingWrite,\n  CheckpointMetadata,\n  BaseCheckpointSaver,\n  BaseStore,\n  CheckpointListOptions,\n  BaseCache,\n} from \"@langchain/langgraph-checkpoint\";\nimport { Graph as DrawableGraph } from \"@langchain/core/runnables/graph\";\nimport { IterableReadableStream } from \"@langchain/core/utils/stream\";\nimport type { BaseMessage } from \"@langchain/core/messages\";\nimport type { BaseChannel } from \"../channels/base.js\";\nimport type { PregelNode } from \"./read.js\";\nimport type { Interrupt } from \"../constants.js\";\nimport { CachePolicy, RetryPolicy } from \"./utils/index.js\";\nimport { LangGraphRunnableConfig } from \"./runnable_types.js\";\n\n/**\n * Selects the type of output you'll receive when streaming from the graph. See [Streaming](/langgraphjs/how-tos/#streaming) for more details.\n */\nexport type StreamMode =\n  | \"values\"\n  | \"updates\"\n  | \"debug\"\n  | \"messages\"\n  | \"checkpoints\"\n  | \"tasks\"\n  | \"custom\"\n  | \"tools\";\n\nexport type Durability = \"exit\" | \"async\" | \"sync\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type PregelInputType = any;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type PregelOutputType = any;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype StreamMessageOutput = [BaseMessage, Record<string, any>];\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype StreamDebugOutput = Record<string, any>;\n\ntype StreamCheckpointsOutput<StreamValues> = {\n  values: StreamValues;\n  next: string[];\n  config: RunnableConfig;\n  metadata?: CheckpointMetadata;\n  parentConfig?: RunnableConfig | undefined;\n  tasks: PregelTaskDescription[];\n};\n\ninterface StreamTasksOutputBase {\n  id: string;\n  name: string;\n  interrupts: Interrupt[];\n}\n\ninterface StreamTasksCreateOutput<StreamValues> extends StreamTasksOutputBase {\n  input: StreamValues;\n  triggers: string[];\n}\n\ninterface StreamTasksResultOutput<\n  Keys,\n  StreamUpdates,\n> extends StreamTasksOutputBase {\n  result: [Keys, StreamUpdates][];\n}\n\ntype StreamTasksOutput<StreamUpdates, StreamValues, Nodes = string> =\n  | StreamTasksCreateOutput<StreamValues>\n  | StreamTasksResultOutput<Nodes, StreamUpdates>;\n\nexport type StreamToolsOutput =\n  | {\n      event: \"on_tool_start\";\n      toolCallId?: string;\n      name: string;\n      input: unknown;\n    }\n  | {\n      event: \"on_tool_event\";\n      toolCallId?: string;\n      name: string;\n      data: unknown;\n    }\n  | {\n      event: \"on_tool_end\";\n      toolCallId?: string;\n      name: string;\n      output: unknown;\n    }\n  | {\n      event: \"on_tool_error\";\n      toolCallId?: string;\n      name: string;\n      error: unknown;\n    };\n\ntype DefaultStreamMode = \"updates\";\n\nexport type IsEventStream<T> = [T] extends [\"text/event-stream\"]\n  ? [\"text/event-stream\"] extends [T]\n    ? true\n    : false\n  : false;\n\nexport type StreamOutputMap<\n  TStreamMode extends StreamMode | StreamMode[] | undefined,\n  TStreamSubgraphs extends boolean,\n  StreamUpdates,\n  StreamValues,\n  Nodes,\n  NodeReturnType,\n  StreamCustom,\n  TEncoding extends \"text/event-stream\" | undefined,\n> =\n  IsEventStream<TEncoding> extends true\n    ? Uint8Array\n    : (\n          undefined extends TStreamMode\n            ? []\n            : StreamMode | StreamMode[] extends TStreamMode\n              ? TStreamMode extends StreamMode[]\n                ? TStreamMode[number]\n                : TStreamMode\n              : TStreamMode extends StreamMode[]\n                ? TStreamMode[number]\n                : []\n        ) extends infer Multiple extends StreamMode\n      ? [TStreamSubgraphs] extends [true]\n        ? {\n            values: [string[], \"values\", StreamValues];\n            updates: [\n              string[],\n              \"updates\",\n              NodeReturnType extends Record<string, unknown>\n                ? { [K in keyof NodeReturnType]?: NodeReturnType[K] }\n                : Record<Nodes extends string ? Nodes : string, StreamUpdates>,\n            ];\n            messages: [string[], \"messages\", StreamMessageOutput];\n            custom: [string[], \"custom\", StreamCustom];\n            checkpoints: [\n              string[],\n              \"checkpoints\",\n              StreamCheckpointsOutput<StreamValues>,\n            ];\n            tasks: [\n              string[],\n              \"tasks\",\n              StreamTasksOutput<StreamUpdates, StreamValues>,\n            ];\n            tools: [string[], \"tools\", StreamToolsOutput];\n            debug: [string[], \"debug\", StreamDebugOutput];\n          }[Multiple]\n        : {\n            values: [\"values\", StreamValues];\n            updates: [\n              \"updates\",\n              NodeReturnType extends Record<string, unknown>\n                ? { [K in keyof NodeReturnType]?: NodeReturnType[K] }\n                : Record<Nodes extends string ? Nodes : string, StreamUpdates>,\n            ];\n            messages: [\"messages\", StreamMessageOutput];\n            custom: [\"custom\", StreamCustom];\n            checkpoints: [\"checkpoints\", StreamCheckpointsOutput<StreamValues>];\n            tasks: [\n              \"tasks\",\n              StreamTasksOutput<StreamUpdates, StreamValues, Nodes>,\n            ];\n            tools: [\"tools\", StreamToolsOutput];\n            debug: [\"debug\", StreamDebugOutput];\n          }[Multiple]\n      : (\n            undefined extends TStreamMode ? DefaultStreamMode : TStreamMode\n          ) extends infer Single extends StreamMode\n        ? [TStreamSubgraphs] extends [true]\n          ? {\n              values: [string[], StreamValues];\n              updates: [\n                string[],\n                NodeReturnType extends Record<string, unknown>\n                  ? { [K in keyof NodeReturnType]?: NodeReturnType[K] }\n                  : Record<\n                      Nodes extends string ? Nodes : string,\n                      StreamUpdates\n                    >,\n              ];\n              messages: [string[], StreamMessageOutput];\n              custom: [string[], StreamCustom];\n              checkpoints: [string[], StreamCheckpointsOutput<StreamValues>];\n              tasks: [\n                string[],\n                StreamTasksOutput<StreamUpdates, StreamValues, Nodes>,\n              ];\n              tools: [string[], StreamToolsOutput];\n              debug: [string[], StreamDebugOutput];\n            }[Single]\n          : {\n              values: StreamValues;\n              updates: NodeReturnType extends Record<string, unknown>\n                ? { [K in keyof NodeReturnType]?: NodeReturnType[K] }\n                : Record<Nodes extends string ? Nodes : string, StreamUpdates>;\n              messages: StreamMessageOutput;\n              custom: StreamCustom;\n              checkpoints: StreamCheckpointsOutput<StreamValues>;\n              tasks: StreamTasksOutput<StreamUpdates, StreamValues, Nodes>;\n              tools: StreamToolsOutput;\n              debug: StreamDebugOutput;\n            }[Single]\n        : never;\n\n/**\n * Configuration options for executing a Pregel graph.\n * These options control how the graph executes, what data is streamed, and how interrupts are handled.\n *\n * @typeParam Nodes - Mapping of node names to their {@link PregelNode} implementations\n * @typeParam Channels - Mapping of channel names to their {@link BaseChannel} implementations\n * @typeParam ContextType - Type of context that can be passed to the graph\n */\nexport interface PregelOptions<\n  Nodes extends StrRecord<string, PregelNode>,\n  Channels extends StrRecord<string, BaseChannel>,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ContextType extends Record<string, any> = Record<string, any>,\n  TStreamMode extends StreamMode | StreamMode[] | undefined =\n    | StreamMode\n    | StreamMode[]\n    | undefined,\n  TSubgraphs extends boolean = boolean,\n  TEncoding extends \"text/event-stream\" | undefined =\n    | \"text/event-stream\"\n    | undefined,\n> extends RunnableConfig<ContextType> {\n  /**\n   * Controls what information is streamed during graph execution.\n   * Multiple modes can be enabled simultaneously.\n   *\n   * Supported modes:\n   * - \"values\": Streams complete state after each step\n   * - \"updates\": Streams only state changes after each step\n   * - \"messages\": Streams messages from within nodes\n   * - \"custom\": Streams custom events from within nodes\n   * - \"debug\": Streams detailed execution events for tracing & debugging\n   *\n   * @example\n   * ```typescript\n   * // Stream only values\n   * streamMode: \"values\"\n   *\n   * // Stream both values and debug info\n   * streamMode: [\"values\", \"debug\"]\n   * ```\n   *\n   * @default [\"values\"]\n   */\n  streamMode?: TStreamMode;\n\n  /**\n   * Specifies which channel keys to retrieve from the checkpoint when resuming execution.\n   * This is an advanced option that you generally don't need to set manually.\n   * The graph will automatically determine the appropriate input keys based on its configuration.\n   */\n  inputKeys?: keyof Channels | Array<keyof Channels>;\n\n  /**\n   * Specifies which channel keys to include in the output stream and final result.\n   * Use this to filter which parts of the graph state you want to observe.\n   *\n   * @example\n   * ```typescript\n   * // Stream only the 'result' channel\n   * outputKeys: \"result\"\n   *\n   * // Stream multiple channels\n   * outputKeys: [\"result\", \"intermediateState\"]\n   * ```\n   */\n  outputKeys?: keyof Channels | Array<keyof Channels>;\n\n  /**\n   * List of nodes where execution should be interrupted BEFORE the node runs.\n   * Can be used for debugging and advanced state manipulation use cases. For\n   * human-in-the-loop workflows, developers should prefer the\n   * @link {interrupt} function instead.\n   *\n   * When interrupted, a resume @link {Command} must be provided to continue\n   * execution.\n   *\n   * @example\n   * ```typescript\n   * // Interrupt before specific nodes\n   * interruptBefore: [\"humanReview\", \"qualityCheck\"]\n   *\n   * // Interrupt before all nodes\n   * interruptBefore: \"all\"\n   * ```\n   */\n  interruptBefore?: All | Array<keyof Nodes>;\n\n  /**\n   * List of nodes where execution should be interrupted AFTER the node runs.\n   * Similar to interruptBefore, but interrupts after node completion.\n   * Useful when the node's output needs to be reviewed before proceeding.\n   *\n   * @example\n   * ```typescript\n   * // Interrupt after specific nodes\n   * interruptAfter: [\"generateContent\", \"analyze\"]\n   *\n   * // Interrupt after all nodes\n   * interruptAfter: \"all\"\n   * ```\n   */\n  interruptAfter?: All | Array<keyof Nodes>;\n\n  /**\n   * Enables detailed debug logging during graph execution.\n   * When enabled, prints information about:\n   * - Task execution\n   * - Channel updates\n   * - Checkpoint writes\n   *\n   * @default false\n   */\n  debug?: boolean;\n\n  /**\n   * Whether to include subgraph execution details in the stream.\n   * When true, state updates from nested graphs will also be streamed.\n   *\n   * @default false\n   */\n  subgraphs?: TSubgraphs;\n\n  /**\n   * Whether to checkpoint intermediate steps, defaults to `true`.\n   * If `false`, only the final checkpoint is saved.\n   * @deprecated Use `durability` instead.\n   */\n  checkpointDuring?: boolean;\n\n  /**\n   * Whether to checkpoint during the run (or only at the end/interruption).\n   * - `\"async\"`: Save checkpoint asynchronously while the next step executes (default).\n   * - `\"sync\"`: Save checkpoint synchronously before the next step starts.\n   * - `\"exit\"`: Save checkpoint only when the graph exits.\n   * @default \"async\"\n   */\n  durability?: Durability;\n\n  /**\n   * A shared value store that allows you to store and retrieve state across\n   * threads. Useful for implementing long-term memory patterns.\n   */\n  store?: BaseStore;\n\n  /**\n   * Optional cache for the graph, useful for caching tasks.\n   */\n  cache?: BaseCache;\n\n  /**\n   * Static context for the graph run, like `userId`, `dbConnection` etc.\n   */\n  context?: ContextType;\n\n  /**\n   * The encoding to use for the stream.\n   * - `undefined`: Use the default format.\n   * - `\"text/event-stream\"`: Use the Server-Sent Events format.\n   * @default undefined\n   */\n  encoding?: TEncoding;\n}\n\n/**\n * Construct a type with a set of properties K of type T\n */\ntype StrRecord<K extends string, T> = {\n  [P in K]: T;\n};\n\nexport interface PregelInterface<\n  Nodes extends StrRecord<string, PregelNode>,\n  Channels extends StrRecord<string, BaseChannel>,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ContextType extends Record<string, any> = StrRecord<string, any>,\n> {\n  lg_is_pregel: boolean;\n\n  withConfig(config: RunnableConfig): PregelInterface<Nodes, Channels>;\n\n  getGraphAsync(\n    config: RunnableConfig & { xray?: boolean | number }\n  ): Promise<DrawableGraph>;\n\n  /** @deprecated Use getSubgraphsAsync instead. The async method will become the default in the next minor release. */\n  getSubgraphs(\n    namespace?: string,\n    recurse?: boolean\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ): Generator<[string, PregelInterface<any, any>]>;\n\n  getSubgraphsAsync(\n    namespace?: string,\n    recurse?: boolean\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ): AsyncGenerator<[string, PregelInterface<any, any>]>;\n\n  getState(\n    config: RunnableConfig,\n    options?: { subgraphs?: boolean }\n  ): Promise<StateSnapshot>;\n\n  getStateHistory(\n    config: RunnableConfig,\n    options?: CheckpointListOptions\n  ): AsyncIterableIterator<StateSnapshot>;\n\n  updateState(\n    inputConfig: LangGraphRunnableConfig,\n    values: Record<string, unknown> | unknown,\n    asNode?: keyof Nodes | string\n  ): Promise<RunnableConfig>;\n\n  stream(\n    input: PregelInputType,\n    options?: Partial<PregelOptions<Nodes, Channels, ContextType>>\n  ): Promise<IterableReadableStream<PregelOutputType>>;\n\n  invoke(\n    input: PregelInputType,\n    options?: Partial<PregelOptions<Nodes, Channels, ContextType>>\n  ): Promise<PregelOutputType>;\n}\n\n/**\n * Parameters for creating a Pregel graph.\n * @internal\n */\nexport type PregelParams<\n  Nodes extends StrRecord<string, PregelNode>,\n  Channels extends StrRecord<string, BaseChannel>,\n> = {\n  /**\n   * The name of the graph. @see {@link Runnable.name}\n   */\n  name?: string;\n\n  /**\n   * The nodes in the graph.\n   */\n  nodes: Nodes;\n\n  /**\n   * The channels in the graph.\n   */\n  channels: Channels;\n\n  /**\n   * Whether to validate the graph.\n   *\n   * @default true\n   */\n  autoValidate?: boolean;\n\n  /**\n   * The stream mode for the graph run. See [Streaming](/langgraphjs/how-tos/#streaming) for more details.\n   *\n   * @default [\"values\"]\n   */\n  streamMode?: StreamMode | StreamMode[];\n\n  /**\n   * The input channels for the graph run.\n   */\n  inputChannels: keyof Channels | Array<keyof Channels>;\n\n  /**\n   * The output channels for the graph run.\n   */\n  outputChannels: keyof Channels | Array<keyof Channels>;\n\n  /**\n   * After processing one of the nodes named in this list, the graph will be interrupted and a resume {@link Command} must be provided to proceed with the execution of this thread.\n   * @default []\n   */\n  interruptAfter?: Array<keyof Nodes> | All;\n\n  /**\n   * Before processing one of the nodes named in this list, the graph will be interrupted and a resume {@link Command} must be provided to proceed with the execution of this thread.\n   * @default []\n   */\n  interruptBefore?: Array<keyof Nodes> | All;\n\n  /**\n   * The channels to stream from the graph run.\n   * @default []\n   */\n  streamChannels?: keyof Channels | Array<keyof Channels>;\n\n  /**\n   * @default undefined\n   */\n  stepTimeout?: number;\n\n  /**\n   * @default false\n   */\n  debug?: boolean;\n\n  /**\n   * The {@link BaseCheckpointSaver | checkpointer} to use for the graph run.\n   */\n  checkpointer?: BaseCheckpointSaver | boolean;\n\n  /**\n   * The default retry policy for this graph. For defaults, see {@link RetryPolicy}.\n   */\n  retryPolicy?: RetryPolicy;\n\n  /**\n   * The configuration for the graph run.\n   */\n  config?: LangGraphRunnableConfig;\n\n  /**\n   * External key-value store.\n   */\n  store?: BaseStore;\n\n  /**\n   * Storage used for node caching.\n   */\n  cache?: BaseCache;\n\n  /**\n   * The trigger to node mapping for the graph run.\n   * @internal\n   */\n  triggerToNodes?: Record<string, string[]>;\n\n  /**\n   * Interrupt helper function.\n   * @internal\n   */\n  userInterrupt?: unknown;\n};\n\nexport interface PregelTaskDescription {\n  readonly id: string;\n  readonly name: string;\n  readonly error?: unknown;\n  readonly interrupts: Interrupt[];\n  readonly state?: LangGraphRunnableConfig | StateSnapshot;\n  readonly path?: TaskPath;\n  readonly result?: unknown;\n}\n\ninterface CacheKey {\n  ns: string[];\n  key: string;\n  ttl?: number;\n}\n\nexport interface PregelExecutableTask<\n  NodeKey extends PropertyKey,\n  ChannelKey extends PropertyKey,\n> {\n  readonly name: NodeKey;\n  readonly input: unknown;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  readonly proc: Runnable<any, any, LangGraphRunnableConfig>;\n  readonly writes: PendingWrite<ChannelKey>[];\n  readonly config?: LangGraphRunnableConfig;\n  readonly triggers: Array<string>;\n  readonly retry_policy?: RetryPolicy;\n  readonly cache_key?: CacheKey;\n  readonly id: string;\n  readonly path?: TaskPath;\n  readonly subgraphs?: Runnable[];\n  readonly writers: Runnable[];\n}\n\nexport interface StateSnapshot {\n  /**\n   * Current values of channels\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  readonly values: Record<string, any> | any;\n  /**\n   * Nodes to execute in the next step, if any\n   */\n  readonly next: Array<string>;\n  /**\n   * Config used to fetch this snapshot\n   */\n  readonly config: RunnableConfig;\n  /**\n   * Metadata about the checkpoint\n   */\n  readonly metadata?: CheckpointMetadata;\n  /**\n   * Time when the snapshot was created\n   */\n  readonly createdAt?: string;\n  /**\n   * Config used to fetch the parent snapshot, if any\n   * @default undefined\n   */\n  readonly parentConfig?: RunnableConfig | undefined;\n  /**\n   * Tasks to execute in this step. If already attempted, may contain an error.\n   */\n  readonly tasks: PregelTaskDescription[];\n}\n\n/**\n * Options for subscribing to multiple channels.\n */\nexport type MultipleChannelSubscriptionOptions = {\n  /**\n   * Optional tags to associate with the subscription.\n   */\n  tags?: string[];\n};\n\n/**\n * Options for subscribing to a single channel.\n */\nexport type SingleChannelSubscriptionOptions = {\n  /**\n   * When specified, the channel mapping will be an object with this key pointing\n   * to the array of channels to subscribe to. Otherwise, the channel mapping\n   * will be an array of channels.\n   */\n  key?: string;\n  /**\n   * Optional tags to associate with the subscription.\n   */\n  tags?: string[];\n};\n\n/**\n * Options for getting the state of the graph.\n */\nexport type GetStateOptions = {\n  /**\n   * Whether to include subgraph states.\n   * @default false\n   */\n  subgraphs?: boolean;\n};\n\n/**\n * Used for storing/retrieving internal execution state.\n *\n * @internal\n */\nexport type PregelScratchpad<Resume = unknown> = {\n  /** Counter for tracking call invocations */\n  callCounter: number;\n  /** Counter for tracking interrupts */\n  interruptCounter: number;\n  /** List of resume values */\n  resume: Resume[];\n  /** Single resume value for null task ID */\n  nullResume: Resume;\n\n  consumeNullResume: () => Resume | undefined;\n  /** Counter for tracking subgraph invocations */\n  subgraphCounter: number;\n\n  /** The input to the currently executing task */\n  currentTaskInput: unknown;\n};\n\n/**\n * @internal\n */\nexport type PregelAbortSignals = {\n  /** Aborts when the user calls `stream.cancel()` or aborts the {@link AbortSignal} that they passed in via the `signal` option */\n  externalAbortSignal?: AbortSignal;\n\n  /**\n   * Aborts when the currently executing task throws any error other than a {@link GraphBubbleUp}\n   */\n  timeoutAbortSignal?: AbortSignal;\n\n  /**\n   * A reference to the AbortSignal that is passed to the node. Aborts on step timeout, stream cancel, or when an error is thrown.\n   */\n  composedAbortSignal?: AbortSignal;\n};\n\nexport type CallOptions = {\n  func: (...args: unknown[]) => unknown | Promise<unknown>;\n  name: string;\n  input: unknown;\n  cache?: CachePolicy;\n  retry?: RetryPolicy;\n  callbacks?: unknown;\n};\n\nexport class Call {\n  func: (...args: unknown[]) => unknown | Promise<unknown>;\n\n  name: string;\n\n  input: unknown;\n\n  retry?: RetryPolicy;\n\n  cache?: CachePolicy;\n\n  callbacks?: unknown;\n\n  readonly __lg_type = \"call\";\n\n  constructor({ func, name, input, retry, cache, callbacks }: CallOptions) {\n    this.func = func;\n    this.name = name;\n    this.input = input;\n    this.retry = retry;\n    this.cache = cache;\n    this.callbacks = callbacks;\n  }\n}\n\nexport function isCall(value: unknown): value is Call {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"__lg_type\" in value &&\n    value.__lg_type === \"call\"\n  );\n}\n\nexport type SimpleTaskPath = [string, string | number];\nexport type VariadicTaskPath = [string, ...(string | number)[], boolean];\nexport type CallTaskPath =\n  | [string, ...(string | number)[], Call]\n  | [string, TaskPath, ...(string | number)[], Call];\nexport type TaskPath = SimpleTaskPath | CallTaskPath | VariadicTaskPath;\n"],"mappings":";AAqsBA,IAAa,OAAb,MAAkB;CAChB;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA,YAAqB;CAErB,YAAY,EAAE,MAAM,MAAM,OAAO,OAAO,OAAO,aAA0B;AACvE,OAAK,OAAO;AACZ,OAAK,OAAO;AACZ,OAAK,QAAQ;AACb,OAAK,QAAQ;AACb,OAAK,QAAQ;AACb,OAAK,YAAY;;;AAIrB,SAAgB,OAAO,OAA+B;AACpD,QACE,OAAO,UAAU,YACjB,UAAU,QACV,eAAe,SACf,MAAM,cAAc"}
+{"version":3,"file":"types.js","names":[],"sources":["../../src/pregel/types.ts"],"sourcesContent":["import type { Runnable, RunnableConfig } from \"@langchain/core/runnables\";\nimport type {\n  All,\n  PendingWrite,\n  CheckpointMetadata,\n  BaseCheckpointSaver,\n  BaseStore,\n  CheckpointListOptions,\n  BaseCache,\n} from \"@langchain/langgraph-checkpoint\";\nimport { Graph as DrawableGraph } from \"@langchain/core/runnables/graph\";\nimport { IterableReadableStream } from \"@langchain/core/utils/stream\";\nimport type { BaseMessage } from \"@langchain/core/messages\";\nimport type { BaseChannel } from \"../channels/base.js\";\nimport type { PregelNode } from \"./read.js\";\nimport type { Interrupt } from \"../constants.js\";\nimport type { StreamTransformer } from \"../stream/types.js\";\nimport { CachePolicy, RetryPolicy } from \"./utils/index.js\";\nimport { LangGraphRunnableConfig } from \"./runnable_types.js\";\n\n/**\n * Selects the type of output you'll receive when streaming from the graph. See [Streaming](/langgraphjs/how-tos/#streaming) for more details.\n */\nexport type StreamMode =\n  | \"values\"\n  | \"updates\"\n  | \"debug\"\n  | \"messages\"\n  | \"checkpoints\"\n  | \"tasks\"\n  | \"custom\"\n  | \"tools\";\n\nexport type Durability = \"exit\" | \"async\" | \"sync\";\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type PregelInputType = any;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type PregelOutputType = any;\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype StreamMessageOutput = [BaseMessage, Record<string, any>];\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype StreamDebugOutput = Record<string, any>;\n\ntype StreamCheckpointsOutput<StreamValues> = {\n  values: StreamValues;\n  next: string[];\n  config: RunnableConfig;\n  metadata?: CheckpointMetadata;\n  parentConfig?: RunnableConfig | undefined;\n  tasks: PregelTaskDescription[];\n};\n\ninterface StreamTasksOutputBase {\n  id: string;\n  name: string;\n  interrupts: Interrupt[];\n}\n\ninterface StreamTasksCreateOutput<StreamValues> extends StreamTasksOutputBase {\n  input: StreamValues;\n  triggers: string[];\n}\n\ninterface StreamTasksResultOutput<\n  Keys,\n  StreamUpdates,\n> extends StreamTasksOutputBase {\n  result: [Keys, StreamUpdates][];\n}\n\ntype StreamTasksOutput<StreamUpdates, StreamValues, Nodes = string> =\n  | StreamTasksCreateOutput<StreamValues>\n  | StreamTasksResultOutput<Nodes, StreamUpdates>;\n\nexport type StreamToolsOutput =\n  | {\n      event: \"on_tool_start\";\n      toolCallId?: string;\n      name: string;\n      input: unknown;\n    }\n  | {\n      event: \"on_tool_event\";\n      toolCallId?: string;\n      name: string;\n      data: unknown;\n    }\n  | {\n      event: \"on_tool_end\";\n      toolCallId?: string;\n      name: string;\n      output: unknown;\n    }\n  | {\n      event: \"on_tool_error\";\n      toolCallId?: string;\n      name: string;\n      error: unknown;\n    };\n\ntype DefaultStreamMode = \"updates\";\n\nexport type IsEventStream<T> = [T] extends [\"text/event-stream\"]\n  ? [\"text/event-stream\"] extends [T]\n    ? true\n    : false\n  : false;\n\nexport type StreamOutputMap<\n  TStreamMode extends StreamMode | StreamMode[] | undefined,\n  TStreamSubgraphs extends boolean,\n  StreamUpdates,\n  StreamValues,\n  Nodes,\n  NodeReturnType,\n  StreamCustom,\n  TEncoding extends \"text/event-stream\" | undefined,\n> =\n  IsEventStream<TEncoding> extends true\n    ? Uint8Array\n    : (\n          undefined extends TStreamMode\n            ? []\n            : StreamMode | StreamMode[] extends TStreamMode\n              ? TStreamMode extends StreamMode[]\n                ? TStreamMode[number]\n                : TStreamMode\n              : TStreamMode extends StreamMode[]\n                ? TStreamMode[number]\n                : []\n        ) extends infer Multiple extends StreamMode\n      ? [TStreamSubgraphs] extends [true]\n        ? {\n            values: [string[], \"values\", StreamValues];\n            updates: [\n              string[],\n              \"updates\",\n              NodeReturnType extends Record<string, unknown>\n                ? { [K in keyof NodeReturnType]?: NodeReturnType[K] }\n                : Record<Nodes extends string ? Nodes : string, StreamUpdates>,\n            ];\n            messages: [string[], \"messages\", StreamMessageOutput];\n            custom: [string[], \"custom\", StreamCustom];\n            checkpoints: [\n              string[],\n              \"checkpoints\",\n              StreamCheckpointsOutput<StreamValues>,\n            ];\n            tasks: [\n              string[],\n              \"tasks\",\n              StreamTasksOutput<StreamUpdates, StreamValues>,\n            ];\n            tools: [string[], \"tools\", StreamToolsOutput];\n            debug: [string[], \"debug\", StreamDebugOutput];\n          }[Multiple]\n        : {\n            values: [\"values\", StreamValues];\n            updates: [\n              \"updates\",\n              NodeReturnType extends Record<string, unknown>\n                ? { [K in keyof NodeReturnType]?: NodeReturnType[K] }\n                : Record<Nodes extends string ? Nodes : string, StreamUpdates>,\n            ];\n            messages: [\"messages\", StreamMessageOutput];\n            custom: [\"custom\", StreamCustom];\n            checkpoints: [\"checkpoints\", StreamCheckpointsOutput<StreamValues>];\n            tasks: [\n              \"tasks\",\n              StreamTasksOutput<StreamUpdates, StreamValues, Nodes>,\n            ];\n            tools: [\"tools\", StreamToolsOutput];\n            debug: [\"debug\", StreamDebugOutput];\n          }[Multiple]\n      : (\n            undefined extends TStreamMode ? DefaultStreamMode : TStreamMode\n          ) extends infer Single extends StreamMode\n        ? [TStreamSubgraphs] extends [true]\n          ? {\n              values: [string[], StreamValues];\n              updates: [\n                string[],\n                NodeReturnType extends Record<string, unknown>\n                  ? { [K in keyof NodeReturnType]?: NodeReturnType[K] }\n                  : Record<\n                      Nodes extends string ? Nodes : string,\n                      StreamUpdates\n                    >,\n              ];\n              messages: [string[], StreamMessageOutput];\n              custom: [string[], StreamCustom];\n              checkpoints: [string[], StreamCheckpointsOutput<StreamValues>];\n              tasks: [\n                string[],\n                StreamTasksOutput<StreamUpdates, StreamValues, Nodes>,\n              ];\n              tools: [string[], StreamToolsOutput];\n              debug: [string[], StreamDebugOutput];\n            }[Single]\n          : {\n              values: StreamValues;\n              updates: NodeReturnType extends Record<string, unknown>\n                ? { [K in keyof NodeReturnType]?: NodeReturnType[K] }\n                : Record<Nodes extends string ? Nodes : string, StreamUpdates>;\n              messages: StreamMessageOutput;\n              custom: StreamCustom;\n              checkpoints: StreamCheckpointsOutput<StreamValues>;\n              tasks: StreamTasksOutput<StreamUpdates, StreamValues, Nodes>;\n              tools: StreamToolsOutput;\n              debug: StreamDebugOutput;\n            }[Single]\n        : never;\n\n/**\n * Configuration options for executing a Pregel graph.\n * These options control how the graph executes, what data is streamed, and how interrupts are handled.\n *\n * @typeParam Nodes - Mapping of node names to their {@link PregelNode} implementations\n * @typeParam Channels - Mapping of channel names to their {@link BaseChannel} implementations\n * @typeParam ContextType - Type of context that can be passed to the graph\n */\nexport interface PregelOptions<\n  Nodes extends StrRecord<string, PregelNode>,\n  Channels extends StrRecord<string, BaseChannel>,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ContextType extends Record<string, any> = Record<string, any>,\n  TStreamMode extends StreamMode | StreamMode[] | undefined =\n    | StreamMode\n    | StreamMode[]\n    | undefined,\n  TSubgraphs extends boolean = boolean,\n  TEncoding extends \"text/event-stream\" | undefined =\n    | \"text/event-stream\"\n    | undefined,\n> extends RunnableConfig<ContextType> {\n  /**\n   * Controls what information is streamed during graph execution.\n   * Multiple modes can be enabled simultaneously.\n   *\n   * Supported modes:\n   * - \"values\": Streams complete state after each step\n   * - \"updates\": Streams only state changes after each step\n   * - \"messages\": Streams messages from within nodes\n   * - \"custom\": Streams custom events from within nodes\n   * - \"debug\": Streams detailed execution events for tracing & debugging\n   *\n   * @example\n   * ```typescript\n   * // Stream only values\n   * streamMode: \"values\"\n   *\n   * // Stream both values and debug info\n   * streamMode: [\"values\", \"debug\"]\n   * ```\n   *\n   * @default [\"values\"]\n   */\n  streamMode?: TStreamMode;\n\n  /**\n   * Specifies which channel keys to retrieve from the checkpoint when resuming execution.\n   * This is an advanced option that you generally don't need to set manually.\n   * The graph will automatically determine the appropriate input keys based on its configuration.\n   */\n  inputKeys?: keyof Channels | Array<keyof Channels>;\n\n  /**\n   * Specifies which channel keys to include in the output stream and final result.\n   * Use this to filter which parts of the graph state you want to observe.\n   *\n   * @example\n   * ```typescript\n   * // Stream only the 'result' channel\n   * outputKeys: \"result\"\n   *\n   * // Stream multiple channels\n   * outputKeys: [\"result\", \"intermediateState\"]\n   * ```\n   */\n  outputKeys?: keyof Channels | Array<keyof Channels>;\n\n  /**\n   * List of nodes where execution should be interrupted BEFORE the node runs.\n   * Can be used for debugging and advanced state manipulation use cases. For\n   * human-in-the-loop workflows, developers should prefer the\n   * @link {interrupt} function instead.\n   *\n   * When interrupted, a resume @link {Command} must be provided to continue\n   * execution.\n   *\n   * @example\n   * ```typescript\n   * // Interrupt before specific nodes\n   * interruptBefore: [\"humanReview\", \"qualityCheck\"]\n   *\n   * // Interrupt before all nodes\n   * interruptBefore: \"all\"\n   * ```\n   */\n  interruptBefore?: All | Array<keyof Nodes>;\n\n  /**\n   * List of nodes where execution should be interrupted AFTER the node runs.\n   * Similar to interruptBefore, but interrupts after node completion.\n   * Useful when the node's output needs to be reviewed before proceeding.\n   *\n   * @example\n   * ```typescript\n   * // Interrupt after specific nodes\n   * interruptAfter: [\"generateContent\", \"analyze\"]\n   *\n   * // Interrupt after all nodes\n   * interruptAfter: \"all\"\n   * ```\n   */\n  interruptAfter?: All | Array<keyof Nodes>;\n\n  /**\n   * Enables detailed debug logging during graph execution.\n   * When enabled, prints information about:\n   * - Task execution\n   * - Channel updates\n   * - Checkpoint writes\n   *\n   * @default false\n   */\n  debug?: boolean;\n\n  /**\n   * Whether to include subgraph execution details in the stream.\n   * When true, state updates from nested graphs will also be streamed.\n   *\n   * @default false\n   */\n  subgraphs?: TSubgraphs;\n\n  /**\n   * Whether to checkpoint intermediate steps, defaults to `true`.\n   * If `false`, only the final checkpoint is saved.\n   * @deprecated Use `durability` instead.\n   */\n  checkpointDuring?: boolean;\n\n  /**\n   * Whether to checkpoint during the run (or only at the end/interruption).\n   * - `\"async\"`: Save checkpoint asynchronously while the next step executes (default).\n   * - `\"sync\"`: Save checkpoint synchronously before the next step starts.\n   * - `\"exit\"`: Save checkpoint only when the graph exits.\n   * @default \"async\"\n   */\n  durability?: Durability;\n\n  /**\n   * A shared value store that allows you to store and retrieve state across\n   * threads. Useful for implementing long-term memory patterns.\n   */\n  store?: BaseStore;\n\n  /**\n   * Optional cache for the graph, useful for caching tasks.\n   */\n  cache?: BaseCache;\n\n  /**\n   * Static context for the graph run, like `userId`, `dbConnection` etc.\n   */\n  context?: ContextType;\n\n  /**\n   * The encoding to use for the stream.\n   * - `undefined`: Use the default format.\n   * - `\"text/event-stream\"`: Use the Server-Sent Events format.\n   * @default undefined\n   */\n  encoding?: TEncoding;\n}\n\n/**\n * Construct a type with a set of properties K of type T\n */\ntype StrRecord<K extends string, T> = {\n  [P in K]: T;\n};\n\nexport interface PregelInterface<\n  Nodes extends StrRecord<string, PregelNode>,\n  Channels extends StrRecord<string, BaseChannel>,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ContextType extends Record<string, any> = StrRecord<string, any>,\n> {\n  lg_is_pregel: boolean;\n\n  withConfig(config: RunnableConfig): PregelInterface<Nodes, Channels>;\n\n  getGraphAsync(\n    config: RunnableConfig & { xray?: boolean | number }\n  ): Promise<DrawableGraph>;\n\n  /** @deprecated Use getSubgraphsAsync instead. The async method will become the default in the next minor release. */\n  getSubgraphs(\n    namespace?: string,\n    recurse?: boolean\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ): Generator<[string, PregelInterface<any, any>]>;\n\n  getSubgraphsAsync(\n    namespace?: string,\n    recurse?: boolean\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  ): AsyncGenerator<[string, PregelInterface<any, any>]>;\n\n  getState(\n    config: RunnableConfig,\n    options?: { subgraphs?: boolean }\n  ): Promise<StateSnapshot>;\n\n  getStateHistory(\n    config: RunnableConfig,\n    options?: CheckpointListOptions\n  ): AsyncIterableIterator<StateSnapshot>;\n\n  updateState(\n    inputConfig: LangGraphRunnableConfig,\n    values: Record<string, unknown> | unknown,\n    asNode?: keyof Nodes | string\n  ): Promise<RunnableConfig>;\n\n  stream(\n    input: PregelInputType,\n    options?: Partial<PregelOptions<Nodes, Channels, ContextType>>\n  ): Promise<IterableReadableStream<PregelOutputType>>;\n\n  invoke(\n    input: PregelInputType,\n    options?: Partial<PregelOptions<Nodes, Channels, ContextType>>\n  ): Promise<PregelOutputType>;\n}\n\n/**\n * Parameters for creating a Pregel graph.\n * @internal\n */\nexport type PregelParams<\n  Nodes extends StrRecord<string, PregelNode>,\n  Channels extends StrRecord<string, BaseChannel>,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  TStreamTransformers extends ReadonlyArray<() => StreamTransformer<any>> = [],\n> = {\n  /**\n   * The name of the graph. @see {@link Runnable.name}\n   */\n  name?: string;\n\n  /**\n   * The nodes in the graph.\n   */\n  nodes: Nodes;\n\n  /**\n   * The channels in the graph.\n   */\n  channels: Channels;\n\n  /**\n   * Whether to validate the graph.\n   *\n   * @default true\n   */\n  autoValidate?: boolean;\n\n  /**\n   * The stream mode for the graph run. See [Streaming](/langgraphjs/how-tos/#streaming) for more details.\n   *\n   * @default [\"values\"]\n   */\n  streamMode?: StreamMode | StreamMode[];\n\n  /**\n   * The input channels for the graph run.\n   */\n  inputChannels: keyof Channels | Array<keyof Channels>;\n\n  /**\n   * The output channels for the graph run.\n   */\n  outputChannels: keyof Channels | Array<keyof Channels>;\n\n  /**\n   * After processing one of the nodes named in this list, the graph will be interrupted and a resume {@link Command} must be provided to proceed with the execution of this thread.\n   * @default []\n   */\n  interruptAfter?: Array<keyof Nodes> | All;\n\n  /**\n   * Before processing one of the nodes named in this list, the graph will be interrupted and a resume {@link Command} must be provided to proceed with the execution of this thread.\n   * @default []\n   */\n  interruptBefore?: Array<keyof Nodes> | All;\n\n  /**\n   * The channels to stream from the graph run.\n   * @default []\n   */\n  streamChannels?: keyof Channels | Array<keyof Channels>;\n\n  /**\n   * @default undefined\n   */\n  stepTimeout?: number;\n\n  /**\n   * @default false\n   */\n  debug?: boolean;\n\n  /**\n   * The {@link BaseCheckpointSaver | checkpointer} to use for the graph run.\n   */\n  checkpointer?: BaseCheckpointSaver | boolean;\n\n  /**\n   * The default retry policy for this graph. For defaults, see {@link RetryPolicy}.\n   */\n  retryPolicy?: RetryPolicy;\n\n  /**\n   * The configuration for the graph run.\n   */\n  config?: LangGraphRunnableConfig;\n\n  /**\n   * External key-value store.\n   */\n  store?: BaseStore;\n\n  /**\n   * Storage used for node caching.\n   */\n  cache?: BaseCache;\n\n  /**\n   * The trigger to node mapping for the graph run.\n   * @internal\n   */\n  triggerToNodes?: Record<string, string[]>;\n\n  /**\n   * Interrupt helper function.\n   * @internal\n   */\n  userInterrupt?: unknown;\n\n  /**\n   * Stream transformer factories registered at compile time.  These run\n   * automatically for every `streamEvents(..., { version: \"v3\" })` call,\n   * before any call-site transformers.\n   */\n  streamTransformers?: TStreamTransformers;\n};\n\nexport interface PregelTaskDescription {\n  readonly id: string;\n  readonly name: string;\n  readonly error?: unknown;\n  readonly interrupts: Interrupt[];\n  readonly state?: LangGraphRunnableConfig | StateSnapshot;\n  readonly path?: TaskPath;\n  readonly result?: unknown;\n}\n\ninterface CacheKey {\n  ns: string[];\n  key: string;\n  ttl?: number;\n}\n\nexport interface PregelExecutableTask<\n  NodeKey extends PropertyKey,\n  ChannelKey extends PropertyKey,\n> {\n  readonly name: NodeKey;\n  readonly input: unknown;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  readonly proc: Runnable<any, any, LangGraphRunnableConfig>;\n  readonly writes: PendingWrite<ChannelKey>[];\n  readonly config?: LangGraphRunnableConfig;\n  readonly triggers: Array<string>;\n  readonly retry_policy?: RetryPolicy;\n  readonly cache_key?: CacheKey;\n  readonly id: string;\n  readonly path?: TaskPath;\n  readonly subgraphs?: Runnable[];\n  readonly writers: Runnable[];\n}\n\nexport interface StateSnapshot {\n  /**\n   * Current values of channels\n   */\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  readonly values: Record<string, any> | any;\n  /**\n   * Nodes to execute in the next step, if any\n   */\n  readonly next: Array<string>;\n  /**\n   * Config used to fetch this snapshot\n   */\n  readonly config: RunnableConfig;\n  /**\n   * Metadata about the checkpoint\n   */\n  readonly metadata?: CheckpointMetadata;\n  /**\n   * Time when the snapshot was created\n   */\n  readonly createdAt?: string;\n  /**\n   * Config used to fetch the parent snapshot, if any\n   * @default undefined\n   */\n  readonly parentConfig?: RunnableConfig | undefined;\n  /**\n   * Tasks to execute in this step. If already attempted, may contain an error.\n   */\n  readonly tasks: PregelTaskDescription[];\n}\n\n/**\n * Options for subscribing to multiple channels.\n */\nexport type MultipleChannelSubscriptionOptions = {\n  /**\n   * Optional tags to associate with the subscription.\n   */\n  tags?: string[];\n};\n\n/**\n * Options for subscribing to a single channel.\n */\nexport type SingleChannelSubscriptionOptions = {\n  /**\n   * When specified, the channel mapping will be an object with this key pointing\n   * to the array of channels to subscribe to. Otherwise, the channel mapping\n   * will be an array of channels.\n   */\n  key?: string;\n  /**\n   * Optional tags to associate with the subscription.\n   */\n  tags?: string[];\n};\n\n/**\n * Options for getting the state of the graph.\n */\nexport type GetStateOptions = {\n  /**\n   * Whether to include subgraph states.\n   * @default false\n   */\n  subgraphs?: boolean;\n};\n\n/**\n * Used for storing/retrieving internal execution state.\n *\n * @internal\n */\nexport type PregelScratchpad<Resume = unknown> = {\n  /** Counter for tracking call invocations */\n  callCounter: number;\n  /** Counter for tracking interrupts */\n  interruptCounter: number;\n  /** List of resume values */\n  resume: Resume[];\n  /** Single resume value for null task ID */\n  nullResume: Resume;\n\n  consumeNullResume: () => Resume | undefined;\n  /** Counter for tracking subgraph invocations */\n  subgraphCounter: number;\n\n  /** The input to the currently executing task */\n  currentTaskInput: unknown;\n};\n\n/**\n * @internal\n */\nexport type PregelAbortSignals = {\n  /** Aborts when the user calls `stream.cancel()` or aborts the {@link AbortSignal} that they passed in via the `signal` option */\n  externalAbortSignal?: AbortSignal;\n\n  /**\n   * Aborts when the currently executing task throws any error other than a {@link GraphBubbleUp}\n   */\n  timeoutAbortSignal?: AbortSignal;\n\n  /**\n   * A reference to the AbortSignal that is passed to the node. Aborts on step timeout, stream cancel, or when an error is thrown.\n   */\n  composedAbortSignal?: AbortSignal;\n};\n\nexport type CallOptions = {\n  func: (...args: unknown[]) => unknown | Promise<unknown>;\n  name: string;\n  input: unknown;\n  cache?: CachePolicy;\n  retry?: RetryPolicy;\n  callbacks?: unknown;\n};\n\nexport class Call {\n  func: (...args: unknown[]) => unknown | Promise<unknown>;\n\n  name: string;\n\n  input: unknown;\n\n  retry?: RetryPolicy;\n\n  cache?: CachePolicy;\n\n  callbacks?: unknown;\n\n  readonly __lg_type = \"call\";\n\n  constructor({ func, name, input, retry, cache, callbacks }: CallOptions) {\n    this.func = func;\n    this.name = name;\n    this.input = input;\n    this.retry = retry;\n    this.cache = cache;\n    this.callbacks = callbacks;\n  }\n}\n\nexport function isCall(value: unknown): value is Call {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"__lg_type\" in value &&\n    value.__lg_type === \"call\"\n  );\n}\n\nexport type SimpleTaskPath = [string, string | number];\nexport type VariadicTaskPath = [string, ...(string | number)[], boolean];\nexport type CallTaskPath =\n  | [string, ...(string | number)[], Call]\n  | [string, TaskPath, ...(string | number)[], Call];\nexport type TaskPath = SimpleTaskPath | CallTaskPath | VariadicTaskPath;\n"],"mappings":";AA+sBA,IAAa,OAAb,MAAkB;CAChB;CAEA;CAEA;CAEA;CAEA;CAEA;CAEA,YAAqB;CAErB,YAAY,EAAE,MAAM,MAAM,OAAO,OAAO,OAAO,aAA0B;AACvE,OAAK,OAAO;AACZ,OAAK,OAAO;AACZ,OAAK,QAAQ;AACb,OAAK,QAAQ;AACb,OAAK,QAAQ;AACb,OAAK,YAAY;;;AAIrB,SAAgB,OAAO,OAA+B;AACpD,QACE,OAAO,UAAU,YACjB,UAAU,QACV,eAAe,SACf,MAAM,cAAc"}

package/dist/pregel/utils/config.cjs

@@ -31,6 +31,25 @@ const CONFIG_KEYS = [
 	"serverInfo"
 ];
 const DEFAULT_RECURSION_LIMIT = 25;
+const PROPAGATE_TO_METADATA = new Set([
+	"thread_id",
+	"checkpoint_id",
+	"checkpoint_ns",
+	"task_id",
+	"run_id",
+	"assistant_id",
+	"graph_id"
+]);
+function propagateConfigurableToMetadata(configurable, metadata) {
+	if (!configurable) return metadata;
+	const result = metadata ?? {};
+	for (const key of PROPAGATE_TO_METADATA) {
+		if (key in result) continue;
+		const value = configurable[key];
+		if (value !== void 0) result[key] = value;
+	}
+	return result;
+}
 function ensureLangGraphConfig(...configs) {
 	const empty = {
 		tags: [],
@@ -54,10 +73,7 @@ function ensureLangGraphConfig(...configs) {
 		if (config === void 0) continue;
 		for (const [k, v] of Object.entries(config)) if (v !== void 0 && CONFIG_KEYS.includes(k)) empty[k] = v;
 	}
-	for (const [key, value] of Object.entries(empty.configurable)) {
-		empty.metadata = empty.metadata ?? {};
-		if (!key.startsWith("__") && (typeof value === "string" || typeof value === "number" || typeof value === "boolean") && !(key in empty.metadata)) empty.metadata[key] = value;
-	}
+	empty.metadata = propagateConfigurableToMetadata(empty.configurable, empty.metadata) ?? {};
 	return empty;
 }
 /**
@@ -117,6 +133,7 @@ exports.getCurrentTaskInput = getCurrentTaskInput;
 exports.getParentCheckpointNamespace = getParentCheckpointNamespace;
 exports.getStore = getStore;
 exports.getWriter = getWriter;
+exports.propagateConfigurableToMetadata = propagateConfigurableToMetadata;
 exports.recastCheckpointNamespace = recastCheckpointNamespace;
 
 //# sourceMappingURL=config.cjs.map

package/dist/pregel/utils/config.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"config.cjs","names":["AsyncLocalStorageProviderSingleton","CONFIG_KEY_SCRATCHPAD"],"sources":["../../../src/pregel/utils/config.ts"],"sourcesContent":["import { RunnableConfig } from \"@langchain/core/runnables\";\nimport { AsyncLocalStorageProviderSingleton } from \"@langchain/core/singletons\";\nimport { BaseStore } from \"@langchain/langgraph-checkpoint\";\nimport { LangGraphRunnableConfig } from \"../runnable_types.js\";\nimport {\n  CHECKPOINT_NAMESPACE_END,\n  CHECKPOINT_NAMESPACE_SEPARATOR,\n  CONFIG_KEY_SCRATCHPAD,\n} from \"../../constants.js\";\n\nconst COPIABLE_KEYS = [\"tags\", \"metadata\", \"callbacks\", \"configurable\"];\n\nconst CONFIG_KEYS = [\n  \"tags\",\n  \"metadata\",\n  \"callbacks\",\n  \"runName\",\n  \"maxConcurrency\",\n  \"recursionLimit\",\n  \"configurable\",\n  \"runId\",\n  \"outputKeys\",\n  \"streamMode\",\n  \"store\",\n  \"writer\",\n  \"interrupt\",\n  \"context\",\n  \"interruptBefore\",\n  \"interruptAfter\",\n  \"checkpointDuring\",\n  \"durability\",\n  \"signal\",\n  \"executionInfo\",\n  \"serverInfo\",\n];\n\nconst DEFAULT_RECURSION_LIMIT = 25;\n\nexport function ensureLangGraphConfig(\n  ...configs: (LangGraphRunnableConfig | undefined)[]\n): RunnableConfig {\n  const empty: LangGraphRunnableConfig = {\n    tags: [],\n    metadata: {},\n    callbacks: undefined,\n    recursionLimit: DEFAULT_RECURSION_LIMIT,\n    configurable: {},\n  };\n\n  const implicitConfig: RunnableConfig =\n    AsyncLocalStorageProviderSingleton.getRunnableConfig();\n  if (implicitConfig !== undefined) {\n    for (const [k, v] of Object.entries(implicitConfig)) {\n      if (v !== undefined) {\n        if (COPIABLE_KEYS.includes(k)) {\n          let copiedValue;\n          if (Array.isArray(v)) {\n            copiedValue = [...v];\n          } else if (typeof v === \"object\") {\n            if (\n              k === \"callbacks\" &&\n              \"copy\" in v &&\n              typeof v.copy === \"function\"\n            ) {\n              copiedValue = v.copy();\n            } else {\n              copiedValue = { ...v };\n            }\n          } else {\n            copiedValue = v;\n          }\n          empty[k as keyof RunnableConfig] = copiedValue;\n        } else {\n          empty[k as keyof RunnableConfig] = v;\n        }\n      }\n    }\n  }\n\n  for (const config of configs) {\n    if (config === undefined) {\n      continue;\n    }\n\n    for (const [k, v] of Object.entries(config)) {\n      if (v !== undefined && CONFIG_KEYS.includes(k)) {\n        empty[k as keyof LangGraphRunnableConfig] = v;\n      }\n    }\n  }\n\n  for (const [key, value] of Object.entries(empty.configurable!)) {\n    empty.metadata = empty.metadata ?? {};\n    if (\n      !key.startsWith(\"__\") &&\n      (typeof value === \"string\" ||\n        typeof value === \"number\" ||\n        typeof value === \"boolean\") &&\n      !(key in empty.metadata!)\n    ) {\n      empty.metadata[key] = value;\n    }\n  }\n\n  return empty;\n}\n\n/**\n * A helper utility function that returns the {@link BaseStore} that was set when the graph was initialized\n *\n * @returns a reference to the {@link BaseStore} that was set when the graph was initialized\n */\nexport function getStore(\n  config?: LangGraphRunnableConfig\n): BaseStore | undefined {\n  const runConfig: LangGraphRunnableConfig =\n    config ?? AsyncLocalStorageProviderSingleton.getRunnableConfig();\n\n  if (runConfig === undefined) {\n    throw new Error(\n      [\n        \"Config not retrievable. This is likely because you are running in an environment without support for AsyncLocalStorage.\",\n        \"If you're running `getStore` in such environment, pass the `config` from the node function directly.\",\n      ].join(\"\\n\")\n    );\n  }\n\n  return runConfig?.store;\n}\n\n/**\n * A helper utility function that returns the {@link LangGraphRunnableConfig#writer} if \"custom\" stream mode is enabled, otherwise undefined.\n *\n * @returns a reference to the {@link LangGraphRunnableConfig#writer} if \"custom\" stream mode is enabled, otherwise undefined\n */\nexport function getWriter(\n  config?: LangGraphRunnableConfig\n): ((chunk: unknown) => void) | undefined {\n  const runConfig: LangGraphRunnableConfig =\n    config ?? AsyncLocalStorageProviderSingleton.getRunnableConfig();\n\n  if (runConfig === undefined) {\n    throw new Error(\n      [\n        \"Config not retrievable. This is likely because you are running in an environment without support for AsyncLocalStorage.\",\n        \"If you're running `getWriter` in such environment, pass the `config` from the node function directly.\",\n      ].join(\"\\n\")\n    );\n  }\n\n  return runConfig?.writer || runConfig?.configurable?.writer;\n}\n\n/**\n * A helper utility function that returns the {@link LangGraphRunnableConfig} that was set when the graph was initialized.\n *\n * Note: This only works when running in an environment that supports node:async_hooks and AsyncLocalStorage. If you're running this in a\n * web environment, access the LangGraphRunnableConfig from the node function directly.\n *\n * @returns the {@link LangGraphRunnableConfig} that was set when the graph was initialized\n */\nexport function getConfig(): LangGraphRunnableConfig {\n  return AsyncLocalStorageProviderSingleton.getRunnableConfig();\n}\n\n/**\n * A helper utility function that returns the input for the currently executing task\n *\n * @returns the input for the currently executing task\n */\nexport function getCurrentTaskInput<T = unknown>(\n  config?: LangGraphRunnableConfig\n): T {\n  const runConfig: LangGraphRunnableConfig =\n    config ?? AsyncLocalStorageProviderSingleton.getRunnableConfig();\n\n  if (runConfig === undefined) {\n    throw new Error(\n      [\n        \"Config not retrievable. This is likely because you are running in an environment without support for AsyncLocalStorage.\",\n        \"If you're running `getCurrentTaskInput` in such environment, pass the `config` from the node function directly.\",\n      ].join(\"\\n\")\n    );\n  }\n\n  if (\n    runConfig.configurable?.[CONFIG_KEY_SCRATCHPAD]?.currentTaskInput ===\n    undefined\n  ) {\n    throw new Error(\"BUG: internal scratchpad not initialized.\");\n  }\n\n  return runConfig!.configurable![CONFIG_KEY_SCRATCHPAD]!.currentTaskInput as T;\n}\n\nexport function recastCheckpointNamespace(namespace: string): string {\n  return namespace\n    .split(CHECKPOINT_NAMESPACE_SEPARATOR)\n    .filter((part) => !part.match(/^\\d+$/))\n    .map((part) => part.split(CHECKPOINT_NAMESPACE_END)[0])\n    .join(CHECKPOINT_NAMESPACE_SEPARATOR);\n}\n\nexport function getParentCheckpointNamespace(namespace: string): string {\n  const parts = namespace.split(CHECKPOINT_NAMESPACE_SEPARATOR);\n  while (parts.length > 1 && parts[parts.length - 1].match(/^\\d+$/)) {\n    parts.pop();\n  }\n  return parts.slice(0, -1).join(CHECKPOINT_NAMESPACE_SEPARATOR);\n}\n"],"mappings":"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"}
+{"version":3,"file":"config.cjs","names":["AsyncLocalStorageProviderSingleton","CONFIG_KEY_SCRATCHPAD"],"sources":["../../../src/pregel/utils/config.ts"],"sourcesContent":["import { RunnableConfig } from \"@langchain/core/runnables\";\nimport { AsyncLocalStorageProviderSingleton } from \"@langchain/core/singletons\";\nimport { BaseStore } from \"@langchain/langgraph-checkpoint\";\nimport { LangGraphRunnableConfig } from \"../runnable_types.js\";\nimport {\n  CHECKPOINT_NAMESPACE_END,\n  CHECKPOINT_NAMESPACE_SEPARATOR,\n  CONFIG_KEY_SCRATCHPAD,\n} from \"../../constants.js\";\n\nconst COPIABLE_KEYS = [\"tags\", \"metadata\", \"callbacks\", \"configurable\"];\n\nconst CONFIG_KEYS = [\n  \"tags\",\n  \"metadata\",\n  \"callbacks\",\n  \"runName\",\n  \"maxConcurrency\",\n  \"recursionLimit\",\n  \"configurable\",\n  \"runId\",\n  \"outputKeys\",\n  \"streamMode\",\n  \"store\",\n  \"writer\",\n  \"interrupt\",\n  \"context\",\n  \"interruptBefore\",\n  \"interruptAfter\",\n  \"checkpointDuring\",\n  \"durability\",\n  \"signal\",\n  \"executionInfo\",\n  \"serverInfo\",\n];\n\nconst DEFAULT_RECURSION_LIMIT = 25;\nexport const PROPAGATE_TO_METADATA = new Set([\n  \"thread_id\",\n  \"checkpoint_id\",\n  \"checkpoint_ns\",\n  \"task_id\",\n  \"run_id\",\n  \"assistant_id\",\n  \"graph_id\",\n]);\n\nexport function propagateConfigurableToMetadata(\n  configurable?: Record<string, unknown>,\n  metadata?: Record<string, unknown>\n): Record<string, unknown> | undefined {\n  if (!configurable) {\n    return metadata;\n  }\n  const result = metadata ?? {};\n  for (const key of PROPAGATE_TO_METADATA) {\n    if (key in result) {\n      continue;\n    }\n    const value = configurable[key];\n    if (value !== undefined) {\n      result[key] = value;\n    }\n  }\n  return result;\n}\n\nexport function ensureLangGraphConfig(\n  ...configs: (LangGraphRunnableConfig | undefined)[]\n): RunnableConfig {\n  const empty: LangGraphRunnableConfig = {\n    tags: [],\n    metadata: {},\n    callbacks: undefined,\n    recursionLimit: DEFAULT_RECURSION_LIMIT,\n    configurable: {},\n  };\n\n  const implicitConfig: RunnableConfig =\n    AsyncLocalStorageProviderSingleton.getRunnableConfig();\n  if (implicitConfig !== undefined) {\n    for (const [k, v] of Object.entries(implicitConfig)) {\n      if (v !== undefined) {\n        if (COPIABLE_KEYS.includes(k)) {\n          let copiedValue;\n          if (Array.isArray(v)) {\n            copiedValue = [...v];\n          } else if (typeof v === \"object\") {\n            if (\n              k === \"callbacks\" &&\n              \"copy\" in v &&\n              typeof v.copy === \"function\"\n            ) {\n              copiedValue = v.copy();\n            } else {\n              copiedValue = { ...v };\n            }\n          } else {\n            copiedValue = v;\n          }\n          empty[k as keyof RunnableConfig] = copiedValue;\n        } else {\n          empty[k as keyof RunnableConfig] = v;\n        }\n      }\n    }\n  }\n\n  for (const config of configs) {\n    if (config === undefined) {\n      continue;\n    }\n\n    for (const [k, v] of Object.entries(config)) {\n      if (v !== undefined && CONFIG_KEYS.includes(k)) {\n        empty[k as keyof LangGraphRunnableConfig] = v;\n      }\n    }\n  }\n\n  empty.metadata =\n    propagateConfigurableToMetadata(\n      empty.configurable as Record<string, unknown> | undefined,\n      empty.metadata as Record<string, unknown> | undefined\n    ) ?? {};\n  return empty;\n}\n\n/**\n * A helper utility function that returns the {@link BaseStore} that was set when the graph was initialized\n *\n * @returns a reference to the {@link BaseStore} that was set when the graph was initialized\n */\nexport function getStore(\n  config?: LangGraphRunnableConfig\n): BaseStore | undefined {\n  const runConfig: LangGraphRunnableConfig =\n    config ?? AsyncLocalStorageProviderSingleton.getRunnableConfig();\n\n  if (runConfig === undefined) {\n    throw new Error(\n      [\n        \"Config not retrievable. This is likely because you are running in an environment without support for AsyncLocalStorage.\",\n        \"If you're running `getStore` in such environment, pass the `config` from the node function directly.\",\n      ].join(\"\\n\")\n    );\n  }\n\n  return runConfig?.store;\n}\n\n/**\n * A helper utility function that returns the {@link LangGraphRunnableConfig#writer} if \"custom\" stream mode is enabled, otherwise undefined.\n *\n * @returns a reference to the {@link LangGraphRunnableConfig#writer} if \"custom\" stream mode is enabled, otherwise undefined\n */\nexport function getWriter(\n  config?: LangGraphRunnableConfig\n): ((chunk: unknown) => void) | undefined {\n  const runConfig: LangGraphRunnableConfig =\n    config ?? AsyncLocalStorageProviderSingleton.getRunnableConfig();\n\n  if (runConfig === undefined) {\n    throw new Error(\n      [\n        \"Config not retrievable. This is likely because you are running in an environment without support for AsyncLocalStorage.\",\n        \"If you're running `getWriter` in such environment, pass the `config` from the node function directly.\",\n      ].join(\"\\n\")\n    );\n  }\n\n  return runConfig?.writer || runConfig?.configurable?.writer;\n}\n\n/**\n * A helper utility function that returns the {@link LangGraphRunnableConfig} that was set when the graph was initialized.\n *\n * Note: This only works when running in an environment that supports node:async_hooks and AsyncLocalStorage. If you're running this in a\n * web environment, access the LangGraphRunnableConfig from the node function directly.\n *\n * @returns the {@link LangGraphRunnableConfig} that was set when the graph was initialized\n */\nexport function getConfig(): LangGraphRunnableConfig {\n  return AsyncLocalStorageProviderSingleton.getRunnableConfig();\n}\n\n/**\n * A helper utility function that returns the input for the currently executing task\n *\n * @returns the input for the currently executing task\n */\nexport function getCurrentTaskInput<T = unknown>(\n  config?: LangGraphRunnableConfig\n): T {\n  const runConfig: LangGraphRunnableConfig =\n    config ?? AsyncLocalStorageProviderSingleton.getRunnableConfig();\n\n  if (runConfig === undefined) {\n    throw new Error(\n      [\n        \"Config not retrievable. This is likely because you are running in an environment without support for AsyncLocalStorage.\",\n        \"If you're running `getCurrentTaskInput` in such environment, pass the `config` from the node function directly.\",\n      ].join(\"\\n\")\n    );\n  }\n\n  if (\n    runConfig.configurable?.[CONFIG_KEY_SCRATCHPAD]?.currentTaskInput ===\n    undefined\n  ) {\n    throw new Error(\"BUG: internal scratchpad not initialized.\");\n  }\n\n  return runConfig!.configurable![CONFIG_KEY_SCRATCHPAD]!.currentTaskInput as T;\n}\n\nexport function recastCheckpointNamespace(namespace: string): string {\n  return namespace\n    .split(CHECKPOINT_NAMESPACE_SEPARATOR)\n    .filter((part) => !part.match(/^\\d+$/))\n    .map((part) => part.split(CHECKPOINT_NAMESPACE_END)[0])\n    .join(CHECKPOINT_NAMESPACE_SEPARATOR);\n}\n\nexport function getParentCheckpointNamespace(namespace: string): string {\n  const parts = namespace.split(CHECKPOINT_NAMESPACE_SEPARATOR);\n  while (parts.length > 1 && parts[parts.length - 1].match(/^\\d+$/)) {\n    parts.pop();\n  }\n  return parts.slice(0, -1).join(CHECKPOINT_NAMESPACE_SEPARATOR);\n}\n"],"mappings":"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"}

package/dist/pregel/utils/config.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.cts","names":[],"sources":["../../../src/pregel/utils/config.ts"],"mappings":";;;;;;AAgHA;;;;iBAAgB,QAAA,CACd,MAAA,GAAS,uBAAA,GACR,SAAA;;;;;AAqBH;iBAAgB,SAAA,CACd,MAAA,GAAS,uBAAA,KACN,KAAA;;;;;;;;AAwBL;iBAAgB,SAAA,CAAA,GAAa,uBAAA;;;;AAS7B;;iBAAgB,mBAAA,aAAA,CACd,MAAA,GAAS,uBAAA,GACR,CAAA"}
+{"version":3,"file":"config.d.cts","names":[],"sources":["../../../src/pregel/utils/config.ts"],"mappings":";;;;;;;;;;iBAqIgB,QAAA,CACd,MAAA,GAAS,uBAAA,GACR,SAAA;;;AAqBH;;;iBAAgB,SAAA,CACd,MAAA,GAAS,uBAAA,KACN,KAAA;;;;;;AAwBL;;;iBAAgB,SAAA,CAAA,GAAa,uBAAA;;AAS7B;;;;iBAAgB,mBAAA,aAAA,CACd,MAAA,GAAS,uBAAA,GACR,CAAA"}

package/dist/pregel/utils/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","names":[],"sources":["../../../src/pregel/utils/config.ts"],"mappings":";;;;;;AAgHA;;;;iBAAgB,QAAA,CACd,MAAA,GAAS,uBAAA,GACR,SAAA;;;;;AAqBH;iBAAgB,SAAA,CACd,MAAA,GAAS,uBAAA,KACN,KAAA;;;;;;;;AAwBL;iBAAgB,SAAA,CAAA,GAAa,uBAAA;;;;AAS7B;;iBAAgB,mBAAA,aAAA,CACd,MAAA,GAAS,uBAAA,GACR,CAAA"}
+{"version":3,"file":"config.d.ts","names":[],"sources":["../../../src/pregel/utils/config.ts"],"mappings":";;;;;;;;;;iBAqIgB,QAAA,CACd,MAAA,GAAS,uBAAA,GACR,SAAA;;;AAqBH;;;iBAAgB,SAAA,CACd,MAAA,GAAS,uBAAA,KACN,KAAA;;;;;;AAwBL;;;iBAAgB,SAAA,CAAA,GAAa,uBAAA;;AAS7B;;;;iBAAgB,mBAAA,aAAA,CACd,MAAA,GAAS,uBAAA,GACR,CAAA"}

package/dist/pregel/utils/config.js

@@ -31,6 +31,25 @@ const CONFIG_KEYS = [
 	"serverInfo"
 ];
 const DEFAULT_RECURSION_LIMIT = 25;
+const PROPAGATE_TO_METADATA = new Set([
+	"thread_id",
+	"checkpoint_id",
+	"checkpoint_ns",
+	"task_id",
+	"run_id",
+	"assistant_id",
+	"graph_id"
+]);
+function propagateConfigurableToMetadata(configurable, metadata) {
+	if (!configurable) return metadata;
+	const result = metadata ?? {};
+	for (const key of PROPAGATE_TO_METADATA) {
+		if (key in result) continue;
+		const value = configurable[key];
+		if (value !== void 0) result[key] = value;
+	}
+	return result;
+}
 function ensureLangGraphConfig(...configs) {
 	const empty = {
 		tags: [],
@@ -54,10 +73,7 @@ function ensureLangGraphConfig(...configs) {
 		if (config === void 0) continue;
 		for (const [k, v] of Object.entries(config)) if (v !== void 0 && CONFIG_KEYS.includes(k)) empty[k] = v;
 	}
-	for (const [key, value] of Object.entries(empty.configurable)) {
-		empty.metadata = empty.metadata ?? {};
-		if (!key.startsWith("__") && (typeof value === "string" || typeof value === "number" || typeof value === "boolean") && !(key in empty.metadata)) empty.metadata[key] = value;
-	}
+	empty.metadata = propagateConfigurableToMetadata(empty.configurable, empty.metadata) ?? {};
 	return empty;
 }
 /**
@@ -111,6 +127,6 @@ function getParentCheckpointNamespace(namespace) {
 	return parts.slice(0, -1).join("|");
 }
 //#endregion
-export { ensureLangGraphConfig, getConfig, getCurrentTaskInput, getParentCheckpointNamespace, getStore, getWriter, recastCheckpointNamespace };
+export { ensureLangGraphConfig, getConfig, getCurrentTaskInput, getParentCheckpointNamespace, getStore, getWriter, propagateConfigurableToMetadata, recastCheckpointNamespace };
 
 //# sourceMappingURL=config.js.map

package/dist/pregel/utils/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","names":[],"sources":["../../../src/pregel/utils/config.ts"],"sourcesContent":["import { RunnableConfig } from \"@langchain/core/runnables\";\nimport { AsyncLocalStorageProviderSingleton } from \"@langchain/core/singletons\";\nimport { BaseStore } from \"@langchain/langgraph-checkpoint\";\nimport { LangGraphRunnableConfig } from \"../runnable_types.js\";\nimport {\n  CHECKPOINT_NAMESPACE_END,\n  CHECKPOINT_NAMESPACE_SEPARATOR,\n  CONFIG_KEY_SCRATCHPAD,\n} from \"../../constants.js\";\n\nconst COPIABLE_KEYS = [\"tags\", \"metadata\", \"callbacks\", \"configurable\"];\n\nconst CONFIG_KEYS = [\n  \"tags\",\n  \"metadata\",\n  \"callbacks\",\n  \"runName\",\n  \"maxConcurrency\",\n  \"recursionLimit\",\n  \"configurable\",\n  \"runId\",\n  \"outputKeys\",\n  \"streamMode\",\n  \"store\",\n  \"writer\",\n  \"interrupt\",\n  \"context\",\n  \"interruptBefore\",\n  \"interruptAfter\",\n  \"checkpointDuring\",\n  \"durability\",\n  \"signal\",\n  \"executionInfo\",\n  \"serverInfo\",\n];\n\nconst DEFAULT_RECURSION_LIMIT = 25;\n\nexport function ensureLangGraphConfig(\n  ...configs: (LangGraphRunnableConfig | undefined)[]\n): RunnableConfig {\n  const empty: LangGraphRunnableConfig = {\n    tags: [],\n    metadata: {},\n    callbacks: undefined,\n    recursionLimit: DEFAULT_RECURSION_LIMIT,\n    configurable: {},\n  };\n\n  const implicitConfig: RunnableConfig =\n    AsyncLocalStorageProviderSingleton.getRunnableConfig();\n  if (implicitConfig !== undefined) {\n    for (const [k, v] of Object.entries(implicitConfig)) {\n      if (v !== undefined) {\n        if (COPIABLE_KEYS.includes(k)) {\n          let copiedValue;\n          if (Array.isArray(v)) {\n            copiedValue = [...v];\n          } else if (typeof v === \"object\") {\n            if (\n              k === \"callbacks\" &&\n              \"copy\" in v &&\n              typeof v.copy === \"function\"\n            ) {\n              copiedValue = v.copy();\n            } else {\n              copiedValue = { ...v };\n            }\n          } else {\n            copiedValue = v;\n          }\n          empty[k as keyof RunnableConfig] = copiedValue;\n        } else {\n          empty[k as keyof RunnableConfig] = v;\n        }\n      }\n    }\n  }\n\n  for (const config of configs) {\n    if (config === undefined) {\n      continue;\n    }\n\n    for (const [k, v] of Object.entries(config)) {\n      if (v !== undefined && CONFIG_KEYS.includes(k)) {\n        empty[k as keyof LangGraphRunnableConfig] = v;\n      }\n    }\n  }\n\n  for (const [key, value] of Object.entries(empty.configurable!)) {\n    empty.metadata = empty.metadata ?? {};\n    if (\n      !key.startsWith(\"__\") &&\n      (typeof value === \"string\" ||\n        typeof value === \"number\" ||\n        typeof value === \"boolean\") &&\n      !(key in empty.metadata!)\n    ) {\n      empty.metadata[key] = value;\n    }\n  }\n\n  return empty;\n}\n\n/**\n * A helper utility function that returns the {@link BaseStore} that was set when the graph was initialized\n *\n * @returns a reference to the {@link BaseStore} that was set when the graph was initialized\n */\nexport function getStore(\n  config?: LangGraphRunnableConfig\n): BaseStore | undefined {\n  const runConfig: LangGraphRunnableConfig =\n    config ?? AsyncLocalStorageProviderSingleton.getRunnableConfig();\n\n  if (runConfig === undefined) {\n    throw new Error(\n      [\n        \"Config not retrievable. This is likely because you are running in an environment without support for AsyncLocalStorage.\",\n        \"If you're running `getStore` in such environment, pass the `config` from the node function directly.\",\n      ].join(\"\\n\")\n    );\n  }\n\n  return runConfig?.store;\n}\n\n/**\n * A helper utility function that returns the {@link LangGraphRunnableConfig#writer} if \"custom\" stream mode is enabled, otherwise undefined.\n *\n * @returns a reference to the {@link LangGraphRunnableConfig#writer} if \"custom\" stream mode is enabled, otherwise undefined\n */\nexport function getWriter(\n  config?: LangGraphRunnableConfig\n): ((chunk: unknown) => void) | undefined {\n  const runConfig: LangGraphRunnableConfig =\n    config ?? AsyncLocalStorageProviderSingleton.getRunnableConfig();\n\n  if (runConfig === undefined) {\n    throw new Error(\n      [\n        \"Config not retrievable. This is likely because you are running in an environment without support for AsyncLocalStorage.\",\n        \"If you're running `getWriter` in such environment, pass the `config` from the node function directly.\",\n      ].join(\"\\n\")\n    );\n  }\n\n  return runConfig?.writer || runConfig?.configurable?.writer;\n}\n\n/**\n * A helper utility function that returns the {@link LangGraphRunnableConfig} that was set when the graph was initialized.\n *\n * Note: This only works when running in an environment that supports node:async_hooks and AsyncLocalStorage. If you're running this in a\n * web environment, access the LangGraphRunnableConfig from the node function directly.\n *\n * @returns the {@link LangGraphRunnableConfig} that was set when the graph was initialized\n */\nexport function getConfig(): LangGraphRunnableConfig {\n  return AsyncLocalStorageProviderSingleton.getRunnableConfig();\n}\n\n/**\n * A helper utility function that returns the input for the currently executing task\n *\n * @returns the input for the currently executing task\n */\nexport function getCurrentTaskInput<T = unknown>(\n  config?: LangGraphRunnableConfig\n): T {\n  const runConfig: LangGraphRunnableConfig =\n    config ?? AsyncLocalStorageProviderSingleton.getRunnableConfig();\n\n  if (runConfig === undefined) {\n    throw new Error(\n      [\n        \"Config not retrievable. This is likely because you are running in an environment without support for AsyncLocalStorage.\",\n        \"If you're running `getCurrentTaskInput` in such environment, pass the `config` from the node function directly.\",\n      ].join(\"\\n\")\n    );\n  }\n\n  if (\n    runConfig.configurable?.[CONFIG_KEY_SCRATCHPAD]?.currentTaskInput ===\n    undefined\n  ) {\n    throw new Error(\"BUG: internal scratchpad not initialized.\");\n  }\n\n  return runConfig!.configurable![CONFIG_KEY_SCRATCHPAD]!.currentTaskInput as T;\n}\n\nexport function recastCheckpointNamespace(namespace: string): string {\n  return namespace\n    .split(CHECKPOINT_NAMESPACE_SEPARATOR)\n    .filter((part) => !part.match(/^\\d+$/))\n    .map((part) => part.split(CHECKPOINT_NAMESPACE_END)[0])\n    .join(CHECKPOINT_NAMESPACE_SEPARATOR);\n}\n\nexport function getParentCheckpointNamespace(namespace: string): string {\n  const parts = namespace.split(CHECKPOINT_NAMESPACE_SEPARATOR);\n  while (parts.length > 1 && parts[parts.length - 1].match(/^\\d+$/)) {\n    parts.pop();\n  }\n  return parts.slice(0, -1).join(CHECKPOINT_NAMESPACE_SEPARATOR);\n}\n"],"mappings":";;;AAUA,MAAM,gBAAgB;CAAC;CAAQ;CAAY;CAAa;CAAe;AAEvE,MAAM,cAAc;CAClB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,MAAM,0BAA0B;AAEhC,SAAgB,sBACd,GAAG,SACa;CAChB,MAAM,QAAiC;EACrC,MAAM,EAAE;EACR,UAAU,EAAE;EACZ,WAAW,KAAA;EACX,gBAAgB;EAChB,cAAc,EAAE;EACjB;CAED,MAAM,iBACJ,mCAAmC,mBAAmB;AACxD,KAAI,mBAAmB,KAAA;OAChB,MAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,eAAe,CACjD,KAAI,MAAM,KAAA,EACR,KAAI,cAAc,SAAS,EAAE,EAAE;GAC7B,IAAI;AACJ,OAAI,MAAM,QAAQ,EAAE,CAClB,eAAc,CAAC,GAAG,EAAE;YACX,OAAO,MAAM,SACtB,KACE,MAAM,eACN,UAAU,KACV,OAAO,EAAE,SAAS,WAElB,eAAc,EAAE,MAAM;OAEtB,eAAc,EAAE,GAAG,GAAG;OAGxB,eAAc;AAEhB,SAAM,KAA6B;QAEnC,OAAM,KAA6B;;AAM3C,MAAK,MAAM,UAAU,SAAS;AAC5B,MAAI,WAAW,KAAA,EACb;AAGF,OAAK,MAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,OAAO,CACzC,KAAI,MAAM,KAAA,KAAa,YAAY,SAAS,EAAE,CAC5C,OAAM,KAAsC;;AAKlD,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,aAAc,EAAE;AAC9D,QAAM,WAAW,MAAM,YAAY,EAAE;AACrC,MACE,CAAC,IAAI,WAAW,KAAK,KACpB,OAAO,UAAU,YAChB,OAAO,UAAU,YACjB,OAAO,UAAU,cACnB,EAAE,OAAO,MAAM,UAEf,OAAM,SAAS,OAAO;;AAI1B,QAAO;;;;;;;AAQT,SAAgB,SACd,QACuB;CACvB,MAAM,YACJ,UAAU,mCAAmC,mBAAmB;AAElE,KAAI,cAAc,KAAA,EAChB,OAAM,IAAI,MACR,CACE,2HACA,uGACD,CAAC,KAAK,KAAK,CACb;AAGH,QAAO,WAAW;;;;;;;AAQpB,SAAgB,UACd,QACwC;CACxC,MAAM,YACJ,UAAU,mCAAmC,mBAAmB;AAElE,KAAI,cAAc,KAAA,EAChB,OAAM,IAAI,MACR,CACE,2HACA,wGACD,CAAC,KAAK,KAAK,CACb;AAGH,QAAO,WAAW,UAAU,WAAW,cAAc;;;;;;;;;;AAWvD,SAAgB,YAAqC;AACnD,QAAO,mCAAmC,mBAAmB;;;;;;;AAQ/D,SAAgB,oBACd,QACG;CACH,MAAM,YACJ,UAAU,mCAAmC,mBAAmB;AAElE,KAAI,cAAc,KAAA,EAChB,OAAM,IAAI,MACR,CACE,2HACA,kHACD,CAAC,KAAK,KAAK,CACb;AAGH,KACE,UAAU,eAAA,wBAAuC,qBACjD,KAAA,EAEA,OAAM,IAAI,MAAM,4CAA4C;AAG9D,QAAO,UAAW,aAAc,uBAAwB;;AAG1D,SAAgB,0BAA0B,WAA2B;AACnE,QAAO,UACJ,MAAA,IAAqC,CACrC,QAAQ,SAAS,CAAC,KAAK,MAAM,QAAQ,CAAC,CACtC,KAAK,SAAS,KAAK,MAAA,IAA+B,CAAC,GAAG,CACtD,KAAA,IAAoC;;AAGzC,SAAgB,6BAA6B,WAA2B;CACtE,MAAM,QAAQ,UAAU,MAAA,IAAqC;AAC7D,QAAO,MAAM,SAAS,KAAK,MAAM,MAAM,SAAS,GAAG,MAAM,QAAQ,CAC/D,OAAM,KAAK;AAEb,QAAO,MAAM,MAAM,GAAG,GAAG,CAAC,KAAA,IAAoC"}
+{"version":3,"file":"config.js","names":[],"sources":["../../../src/pregel/utils/config.ts"],"sourcesContent":["import { RunnableConfig } from \"@langchain/core/runnables\";\nimport { AsyncLocalStorageProviderSingleton } from \"@langchain/core/singletons\";\nimport { BaseStore } from \"@langchain/langgraph-checkpoint\";\nimport { LangGraphRunnableConfig } from \"../runnable_types.js\";\nimport {\n  CHECKPOINT_NAMESPACE_END,\n  CHECKPOINT_NAMESPACE_SEPARATOR,\n  CONFIG_KEY_SCRATCHPAD,\n} from \"../../constants.js\";\n\nconst COPIABLE_KEYS = [\"tags\", \"metadata\", \"callbacks\", \"configurable\"];\n\nconst CONFIG_KEYS = [\n  \"tags\",\n  \"metadata\",\n  \"callbacks\",\n  \"runName\",\n  \"maxConcurrency\",\n  \"recursionLimit\",\n  \"configurable\",\n  \"runId\",\n  \"outputKeys\",\n  \"streamMode\",\n  \"store\",\n  \"writer\",\n  \"interrupt\",\n  \"context\",\n  \"interruptBefore\",\n  \"interruptAfter\",\n  \"checkpointDuring\",\n  \"durability\",\n  \"signal\",\n  \"executionInfo\",\n  \"serverInfo\",\n];\n\nconst DEFAULT_RECURSION_LIMIT = 25;\nexport const PROPAGATE_TO_METADATA = new Set([\n  \"thread_id\",\n  \"checkpoint_id\",\n  \"checkpoint_ns\",\n  \"task_id\",\n  \"run_id\",\n  \"assistant_id\",\n  \"graph_id\",\n]);\n\nexport function propagateConfigurableToMetadata(\n  configurable?: Record<string, unknown>,\n  metadata?: Record<string, unknown>\n): Record<string, unknown> | undefined {\n  if (!configurable) {\n    return metadata;\n  }\n  const result = metadata ?? {};\n  for (const key of PROPAGATE_TO_METADATA) {\n    if (key in result) {\n      continue;\n    }\n    const value = configurable[key];\n    if (value !== undefined) {\n      result[key] = value;\n    }\n  }\n  return result;\n}\n\nexport function ensureLangGraphConfig(\n  ...configs: (LangGraphRunnableConfig | undefined)[]\n): RunnableConfig {\n  const empty: LangGraphRunnableConfig = {\n    tags: [],\n    metadata: {},\n    callbacks: undefined,\n    recursionLimit: DEFAULT_RECURSION_LIMIT,\n    configurable: {},\n  };\n\n  const implicitConfig: RunnableConfig =\n    AsyncLocalStorageProviderSingleton.getRunnableConfig();\n  if (implicitConfig !== undefined) {\n    for (const [k, v] of Object.entries(implicitConfig)) {\n      if (v !== undefined) {\n        if (COPIABLE_KEYS.includes(k)) {\n          let copiedValue;\n          if (Array.isArray(v)) {\n            copiedValue = [...v];\n          } else if (typeof v === \"object\") {\n            if (\n              k === \"callbacks\" &&\n              \"copy\" in v &&\n              typeof v.copy === \"function\"\n            ) {\n              copiedValue = v.copy();\n            } else {\n              copiedValue = { ...v };\n            }\n          } else {\n            copiedValue = v;\n          }\n          empty[k as keyof RunnableConfig] = copiedValue;\n        } else {\n          empty[k as keyof RunnableConfig] = v;\n        }\n      }\n    }\n  }\n\n  for (const config of configs) {\n    if (config === undefined) {\n      continue;\n    }\n\n    for (const [k, v] of Object.entries(config)) {\n      if (v !== undefined && CONFIG_KEYS.includes(k)) {\n        empty[k as keyof LangGraphRunnableConfig] = v;\n      }\n    }\n  }\n\n  empty.metadata =\n    propagateConfigurableToMetadata(\n      empty.configurable as Record<string, unknown> | undefined,\n      empty.metadata as Record<string, unknown> | undefined\n    ) ?? {};\n  return empty;\n}\n\n/**\n * A helper utility function that returns the {@link BaseStore} that was set when the graph was initialized\n *\n * @returns a reference to the {@link BaseStore} that was set when the graph was initialized\n */\nexport function getStore(\n  config?: LangGraphRunnableConfig\n): BaseStore | undefined {\n  const runConfig: LangGraphRunnableConfig =\n    config ?? AsyncLocalStorageProviderSingleton.getRunnableConfig();\n\n  if (runConfig === undefined) {\n    throw new Error(\n      [\n        \"Config not retrievable. This is likely because you are running in an environment without support for AsyncLocalStorage.\",\n        \"If you're running `getStore` in such environment, pass the `config` from the node function directly.\",\n      ].join(\"\\n\")\n    );\n  }\n\n  return runConfig?.store;\n}\n\n/**\n * A helper utility function that returns the {@link LangGraphRunnableConfig#writer} if \"custom\" stream mode is enabled, otherwise undefined.\n *\n * @returns a reference to the {@link LangGraphRunnableConfig#writer} if \"custom\" stream mode is enabled, otherwise undefined\n */\nexport function getWriter(\n  config?: LangGraphRunnableConfig\n): ((chunk: unknown) => void) | undefined {\n  const runConfig: LangGraphRunnableConfig =\n    config ?? AsyncLocalStorageProviderSingleton.getRunnableConfig();\n\n  if (runConfig === undefined) {\n    throw new Error(\n      [\n        \"Config not retrievable. This is likely because you are running in an environment without support for AsyncLocalStorage.\",\n        \"If you're running `getWriter` in such environment, pass the `config` from the node function directly.\",\n      ].join(\"\\n\")\n    );\n  }\n\n  return runConfig?.writer || runConfig?.configurable?.writer;\n}\n\n/**\n * A helper utility function that returns the {@link LangGraphRunnableConfig} that was set when the graph was initialized.\n *\n * Note: This only works when running in an environment that supports node:async_hooks and AsyncLocalStorage. If you're running this in a\n * web environment, access the LangGraphRunnableConfig from the node function directly.\n *\n * @returns the {@link LangGraphRunnableConfig} that was set when the graph was initialized\n */\nexport function getConfig(): LangGraphRunnableConfig {\n  return AsyncLocalStorageProviderSingleton.getRunnableConfig();\n}\n\n/**\n * A helper utility function that returns the input for the currently executing task\n *\n * @returns the input for the currently executing task\n */\nexport function getCurrentTaskInput<T = unknown>(\n  config?: LangGraphRunnableConfig\n): T {\n  const runConfig: LangGraphRunnableConfig =\n    config ?? AsyncLocalStorageProviderSingleton.getRunnableConfig();\n\n  if (runConfig === undefined) {\n    throw new Error(\n      [\n        \"Config not retrievable. This is likely because you are running in an environment without support for AsyncLocalStorage.\",\n        \"If you're running `getCurrentTaskInput` in such environment, pass the `config` from the node function directly.\",\n      ].join(\"\\n\")\n    );\n  }\n\n  if (\n    runConfig.configurable?.[CONFIG_KEY_SCRATCHPAD]?.currentTaskInput ===\n    undefined\n  ) {\n    throw new Error(\"BUG: internal scratchpad not initialized.\");\n  }\n\n  return runConfig!.configurable![CONFIG_KEY_SCRATCHPAD]!.currentTaskInput as T;\n}\n\nexport function recastCheckpointNamespace(namespace: string): string {\n  return namespace\n    .split(CHECKPOINT_NAMESPACE_SEPARATOR)\n    .filter((part) => !part.match(/^\\d+$/))\n    .map((part) => part.split(CHECKPOINT_NAMESPACE_END)[0])\n    .join(CHECKPOINT_NAMESPACE_SEPARATOR);\n}\n\nexport function getParentCheckpointNamespace(namespace: string): string {\n  const parts = namespace.split(CHECKPOINT_NAMESPACE_SEPARATOR);\n  while (parts.length > 1 && parts[parts.length - 1].match(/^\\d+$/)) {\n    parts.pop();\n  }\n  return parts.slice(0, -1).join(CHECKPOINT_NAMESPACE_SEPARATOR);\n}\n"],"mappings":"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"}

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

@@ -1,6 +1,5 @@
 import { CheckpointMetadata } from "@langchain/langgraph-checkpoint";
 import { RunnableConfig } from "@langchain/core/runnables";
-
 //#region src/pregel/utils/index.d.ts
 type RetryPolicy = {
   /**

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/pregel/utils/index.ts"],"mappings":";;;;KAuDY,WAAA;EAAW;;;;EAKrB,eAAA;EAqBA;;;;EAfA,aAAA;EAqBU;AAMZ;;;EArBE,WAAA;EA0BA;;;;EApBA,WAAA;EAGA,MAAA;EAGA,OAAA,IAAW,CAAA;EAGX,UAAA;AAAA;;;;KAMU,WAAA;;;;;EAKV,OAAA,IAAW,IAAA;;;;;EAMX,GAAA;AAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/pregel/utils/index.ts"],"mappings":";;;KAuDY,WAAA;;;;;EAKV,eAAA;EAkBA;;;;EAZA,aAAA;EAqBU;;AAMZ;;EArBE,WAAA;EAqBqB;;;;EAfrB,WAAA,WA0BG;EAvBH,MAAA;EAGA,OAAA,IAAW,CAAA;EAGX,UAAA;AAAA;;;;KAMU,WAAA;;;;;EAKV,OAAA,IAAW,IAAA;;;;;EAMX,GAAA;AAAA"}

package/dist/state/index.d.ts

@@ -1,6 +1,6 @@
 import { isSerializableSchema, isStandardSchema } from "./types.js";
 import { ReducedValue, ReducedValueInit } from "./values/reduced.js";
 import { UntrackedValue, UntrackedValueInit } from "./values/untracked.js";
-import { InferStateSchemaUpdate, InferStateSchemaValue, StateSchema, StateSchemaField, StateSchemaFields } from "./schema.js";
+import { AnyStateSchema, InferStateSchemaUpdate, InferStateSchemaValue, StateSchema, StateSchemaField, StateSchemaFieldToChannel, StateSchemaFields, StateSchemaFieldsToStateDefinition } from "./schema.js";
 import { getJsonSchemaFromSchema, getSchemaDefaultGetter } from "./adapter.js";
 import { MessagesValue } from "./prebuilt/messages.js";

package/dist/state/schema.d.cts

@@ -201,5 +201,5 @@ declare class StateSchema<TFields extends StateSchemaFields> {
 }
 type AnyStateSchema = StateSchema<any>;
 //#endregion
-export { AnyStateSchema, InferStateSchemaUpdate, InferStateSchemaValue, StateSchema, StateSchemaField, StateSchemaFields, StateSchemaFieldsToStateDefinition };
+export { AnyStateSchema, InferStateSchemaUpdate, InferStateSchemaValue, StateSchema, StateSchemaField, StateSchemaFieldToChannel, StateSchemaFields, StateSchemaFieldsToStateDefinition };
 //# sourceMappingURL=schema.d.cts.map

package/dist/state/schema.d.ts

@@ -201,5 +201,5 @@ declare class StateSchema<TFields extends StateSchemaFields> {
 }
 type AnyStateSchema = StateSchema<any>;
 //#endregion
-export { AnyStateSchema, InferStateSchemaUpdate, InferStateSchemaValue, StateSchema, StateSchemaField, StateSchemaFields, StateSchemaFieldsToStateDefinition };
+export { AnyStateSchema, InferStateSchemaUpdate, InferStateSchemaValue, StateSchema, StateSchemaField, StateSchemaFieldToChannel, StateSchemaFields, StateSchemaFieldsToStateDefinition };
 //# sourceMappingURL=schema.d.ts.map

package/dist/stream/convert.cjs

@@ -0,0 +1,207 @@
+//#region src/stream/convert.ts
+/**
+* The set of stream modes requested by
+* `streamEvents(..., { version: "v3" })` — every mode the protocol maps
+* to a channel.
+*
+* The verbose `"debug"` mode is intentionally excluded: it was a thin
+* re-wrap of `checkpoints` + `tasks` carrying no new information.
+*
+* The `"checkpoints"` mode is likewise excluded from the stream-mode
+* request because the protocol's `checkpoints` channel carries only a
+* lightweight envelope (`id`, `parent_id`, `step`, `source`) derived from
+* {@link StreamChunkMeta.checkpoint} on the adjacent `values` chunk — not
+* the full-state shape that Pregel's `checkpoints` stream mode produces.
+* `convertToProtocolEvent` emits a companion `checkpoints` protocol event
+* next to each `values` event when meta is present, so clients can build
+* branching/time-travel UIs without a full-state `checkpoints` subscription.
+*/
+const STREAM_EVENTS_V3_MODES = [
+	"values",
+	"updates",
+	"messages",
+	"tools",
+	"custom",
+	"tasks"
+];
+function unwrapMessagesPayload(payload) {
+	if (!Array.isArray(payload) || payload.length !== 2) return { data: payload };
+	const [data, metadata] = payload;
+	if (metadata == null || typeof metadata !== "object") return { data: payload };
+	const record = metadata;
+	const node = typeof record.langgraph_node === "string" ? record.langgraph_node : void 0;
+	const runId = typeof record.run_id === "string" ? record.run_id : void 0;
+	return {
+		data: runId != null && data != null && typeof data === "object" ? {
+			...data,
+			run_id: runId
+		} : data,
+		node
+	};
+}
+function convertToProtocolEvent({ namespace: ns, mode, payload, seq, meta }) {
+	const timestamp = Date.now();
+	const base = { type: "event" };
+	switch (mode) {
+		case "messages": {
+			const { data, node } = unwrapMessagesPayload(payload);
+			return [{
+				...base,
+				seq,
+				method: "messages",
+				params: {
+					namespace: ns,
+					timestamp,
+					...node ? { node } : {},
+					data
+				}
+			}];
+		}
+		case "tools": return [{
+			...base,
+			seq,
+			method: "tools",
+			params: {
+				namespace: ns,
+				timestamp,
+				data: convertToolsPayload(payload)
+			}
+		}];
+		case "values": {
+			const events = [];
+			if (meta?.checkpoint != null) events.push({
+				...base,
+				seq,
+				method: "checkpoints",
+				params: {
+					namespace: ns,
+					timestamp,
+					data: meta.checkpoint
+				}
+			});
+			events.push({
+				...base,
+				seq: meta?.checkpoint != null ? seq + 1 : seq,
+				method: "values",
+				params: {
+					namespace: ns,
+					timestamp,
+					data: payload
+				}
+			});
+			return events;
+		}
+		case "updates": {
+			const data = convertUpdatesPayload(payload);
+			return [{
+				...base,
+				seq,
+				method: "updates",
+				params: {
+					namespace: ns,
+					timestamp,
+					...typeof data.node === "string" ? { node: data.node } : {},
+					data
+				}
+			}];
+		}
+		case "custom": {
+			const data = typeof payload === "object" && payload !== null && !Array.isArray(payload) && "name" in payload ? payload : { payload };
+			return [{
+				...base,
+				seq,
+				method: "custom",
+				params: {
+					namespace: ns,
+					timestamp,
+					data
+				}
+			}];
+		}
+		case "tasks": return [{
+			...base,
+			seq,
+			method: "tasks",
+			params: {
+				namespace: ns,
+				timestamp,
+				data: payload
+			}
+		}];
+		default: return [];
+	}
+}
+/**
+* Normalises a raw tools-mode payload into a typed {@link ToolsEventData}
+* discriminated union, mapping internal lifecycle events (`on_tool_start`,
+* `on_tool_end`, etc.) to their protocol counterparts.
+*
+* @param payload - The raw payload from a `"tools"` stream chunk.
+* @returns A {@link ToolsEventData} object with the appropriate `event`
+*   discriminant and associated fields.
+*/
+function convertToolsPayload(payload) {
+	if (typeof payload !== "object" || payload === null) return {
+		event: "tool-error",
+		tool_call_id: "",
+		message: "Unexpected tools payload shape"
+	};
+	const p = payload;
+	const tool_call_id = String(p.toolCallId ?? "");
+	switch (p.event) {
+		case "on_tool_start": return {
+			event: "tool-started",
+			tool_call_id,
+			tool_name: String(p.name ?? "unknown"),
+			input: p.input
+		};
+		case "on_tool_event": return {
+			event: "tool-output-delta",
+			tool_call_id,
+			delta: typeof p.data === "string" ? p.data : JSON.stringify(p.data ?? "")
+		};
+		case "on_tool_end": return {
+			event: "tool-finished",
+			tool_call_id,
+			output: p.output
+		};
+		case "on_tool_error": {
+			const err = p.error;
+			return {
+				event: "tool-error",
+				tool_call_id,
+				message: typeof err === "object" && err !== null && "message" in err && typeof err.message === "string" ? err.message : String(err ?? "unknown error")
+			};
+		}
+		default: return {
+			event: "tool-error",
+			tool_call_id: "",
+			message: `Unknown tool event: ${String(p.event)}`
+		};
+	}
+}
+/**
+* Extracts the first `{node: delta}` entry from an updates-mode payload and
+* reshapes it into an {@link UpdatesEventData} with explicit `node` and
+* `values` fields.  Non-object payloads are coerced to `{ values: {} }`.
+*
+* @param payload - The raw payload from an `"updates"` stream chunk,
+*   expected to be a `Record<string, unknown>` keyed by node name.
+* @returns An {@link UpdatesEventData} containing the extracted node name
+*   and its associated delta values.
+*/
+function convertUpdatesPayload(payload) {
+	if (typeof payload !== "object" || payload === null) return { values: {} };
+	const entries = Object.entries(payload);
+	if (entries.length === 0) return { values: {} };
+	const [node, values] = entries[0];
+	return {
+		node,
+		values: typeof values === "object" && values !== null ? values : { value: values }
+	};
+}
+//#endregion
+exports.STREAM_EVENTS_V3_MODES = STREAM_EVENTS_V3_MODES;
+exports.convertToProtocolEvent = convertToProtocolEvent;
+
+//# sourceMappingURL=convert.cjs.map