@langchain/langgraph 1.1.5 → 1.2.1

package/dist/graph/messages_annotation.d.cts

@@ -1,4 +1,5 @@
-import { BinaryOperatorAggregate } from "../channels/binop.cjs";
+import { BaseChannel } from "../channels/base.cjs";
+import { OverwriteValue } from "../constants.cjs";
 import { ReducedZodChannel, SchemaMeta } from "./zod/meta.cjs";
 import { AnnotationRoot } from "./annotation.cjs";
 import { Messages } from "./messages_reducer.cjs";
@@ -44,7 +45,7 @@ import { BaseMessage } from "@langchain/core/messages";
  * ```
  */
 declare const MessagesAnnotation: AnnotationRoot<{
-  messages: BinaryOperatorAggregate<BaseMessage<_langchain_core_messages0.MessageStructure<_langchain_core_messages0.MessageToolSet>, _langchain_core_messages0.MessageType>[], Messages>;
+  messages: BaseChannel<BaseMessage<_langchain_core_messages0.MessageStructure<_langchain_core_messages0.MessageToolSet>, _langchain_core_messages0.MessageType>[], OverwriteValue<BaseMessage<_langchain_core_messages0.MessageStructure<_langchain_core_messages0.MessageToolSet>, _langchain_core_messages0.MessageType>[]> | Messages, unknown>;
 }>;
 /**
  * Prebuilt schema meta for Zod state definition.

package/dist/graph/messages_annotation.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"messages_annotation.d.cts","names":[],"sources":["../../src/graph/messages_annotation.ts"],"mappings":";;;;;;;;;;;;;;;;AA2CA;;;;;;;;;;;;;;;;;;;;;;AAoBA;;;;;;;cApBa,kBAAA;2FAKX,yBAAA,CAAA,cAAA;;;;;AA4DF;;;;;;;;;;cA7Ca,eAAA,EAAiB,UAAA,CAAW,WAAA,IAAe,QAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA6C3C,gBAAA,EAAgB,CAAA,CAAA,SAAA;+FAE3B,yBAAA,CAAA,cAAA"}
+{"version":3,"file":"messages_annotation.d.cts","names":[],"sources":["../../src/graph/messages_annotation.ts"],"mappings":";;;;;;;;;;;;;;;;;;AA2CA;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAAa,kBAAA;+EAKX,yBAAA,CAAA,cAAA;;;AAeF;;;;;;;;;;;;cAAa,eAAA,EAAiB,UAAA,CAAW,WAAA,IAAe,QAAA;AA6CxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,cAAa,gBAAA,EAAgB,CAAA,CAAA,SAAA;+FAE3B,yBAAA,CAAA,cAAA"}

package/dist/graph/messages_annotation.d.ts

@@ -1,4 +1,5 @@
-import { BinaryOperatorAggregate } from "../channels/binop.js";
+import { BaseChannel } from "../channels/base.js";
+import { OverwriteValue } from "../constants.js";
 import { ReducedZodChannel, SchemaMeta } from "./zod/meta.js";
 import { AnnotationRoot } from "./annotation.js";
 import { Messages } from "./messages_reducer.js";
@@ -45,7 +46,7 @@ import { z } from "zod/v3";
  * ```
  */
 declare const MessagesAnnotation: AnnotationRoot<{
-  messages: BinaryOperatorAggregate<BaseMessage<_langchain_core_messages0.MessageStructure<_langchain_core_messages0.MessageToolSet>, _langchain_core_messages0.MessageType>[], Messages>;
+  messages: BaseChannel<BaseMessage<_langchain_core_messages0.MessageStructure<_langchain_core_messages0.MessageToolSet>, _langchain_core_messages0.MessageType>[], OverwriteValue<BaseMessage<_langchain_core_messages0.MessageStructure<_langchain_core_messages0.MessageToolSet>, _langchain_core_messages0.MessageType>[]> | Messages, unknown>;
 }>;
 /**
  * Prebuilt schema meta for Zod state definition.

package/dist/graph/messages_annotation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messages_annotation.d.ts","names":[],"sources":["../../src/graph/messages_annotation.ts"],"mappings":";;;;;;;;;;;;;;;;;;AA2CA;;;;;;;;;;;;;;;;;;;;;;AAoBA;;;;;;cApBa,kBAAA;2FAKX,yBAAA,CAAA,cAAA;;;;;;AA4DF;;;;;;;;;cA7Ca,eAAA,EAAiB,UAAA,CAAW,WAAA,IAAe,QAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA6C3C,gBAAA,EAAgB,CAAA,CAAA,SAAA;+FAE3B,yBAAA,CAAA,cAAA"}
+{"version":3,"file":"messages_annotation.d.ts","names":[],"sources":["../../src/graph/messages_annotation.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;AA2CA;;;;;;;;;;;;;;;;;;;;;;;;;;;cAAa,kBAAA;+EAKX,yBAAA,CAAA,cAAA;;;;AAeF;;;;;;;;;;;cAAa,eAAA,EAAiB,UAAA,CAAW,WAAA,IAAe,QAAA;;AA6CxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAAa,gBAAA,EAAgB,CAAA,CAAA,SAAA;+FAE3B,yBAAA,CAAA,cAAA"}

package/dist/graph/state.cjs

@@ -1,7 +1,7 @@
+const require_constants = require('../constants.cjs');
 const require_errors = require('../errors.cjs');
 const require_last_value = require('../channels/last_value.cjs');
 const require_annotation = require('./annotation.cjs');
-const require_constants = require('../constants.cjs');
 const require_utils = require('../utils.cjs');
 const require_write = require('../pregel/write.cjs');
 const require_read = require('../pregel/read.cjs');

package/dist/graph/state.d.cts

@@ -1,9 +1,9 @@
 import { BaseChannel } from "../channels/base.cjs";
+import { Command, CommandInstance, END, INTERRUPT, Interrupt, START } from "../constants.cjs";
 import { SchemaMetaRegistry } from "./zod/meta.cjs";
 import { RunnableLike, Runtime } from "../pregel/runnable_types.cjs";
 import { AnnotationRoot, SingleReducer, StateDefinition, StateType } from "./annotation.cjs";
 import { CachePolicy, RetryPolicy } from "../pregel/utils/index.cjs";
-import { Command, CommandInstance, END, INTERRUPT, Interrupt, START } from "../constants.cjs";
 import { AddNodeOptions, Branch, CompiledGraph, Graph, NodeSpec } from "./graph.cjs";
 import { InferInterruptInputType, InferInterruptResumeType } from "../interrupt.cjs";
 import { InferWriterType } from "../writer.cjs";

package/dist/graph/state.d.ts

@@ -1,9 +1,9 @@
 import { BaseChannel } from "../channels/base.js";
+import { Command, CommandInstance, END, INTERRUPT, Interrupt, START } from "../constants.js";
 import { SchemaMetaRegistry } from "./zod/meta.js";
 import { RunnableLike, Runtime } from "../pregel/runnable_types.js";
 import { AnnotationRoot, SingleReducer, StateDefinition, StateType } from "./annotation.js";
 import { CachePolicy, RetryPolicy } from "../pregel/utils/index.js";
-import { Command, CommandInstance, END, INTERRUPT, Interrupt, START } from "../constants.js";
 import { AddNodeOptions, Branch, CompiledGraph, Graph, NodeSpec } from "./graph.js";
 import { InferInterruptInputType, InferInterruptResumeType } from "../interrupt.js";
 import { InferWriterType } from "../writer.js";

package/dist/graph/state.js

@@ -1,7 +1,7 @@
+import { CHECKPOINT_NAMESPACE_END, CHECKPOINT_NAMESPACE_SEPARATOR, Command, END, SELF, START, TAG_HIDDEN, _isSend, isCommand, isInterrupted } from "../constants.js";
 import { InvalidUpdateError, ParentCommand, StateGraphInputError } from "../errors.js";
 import { LastValueAfterFinish } from "../channels/last_value.js";
 import { AnnotationRoot, getChannel } from "./annotation.js";
-import { CHECKPOINT_NAMESPACE_END, CHECKPOINT_NAMESPACE_SEPARATOR, Command, END, SELF, START, TAG_HIDDEN, _isSend, isCommand, isInterrupted } from "../constants.js";
 import { RunnableCallable } from "../utils.js";
 import { ChannelWrite, PASSTHROUGH } from "../pregel/write.js";
 import { ChannelRead, PregelNode } from "../pregel/read.js";

package/dist/graph/types.cjs

@@ -1,5 +1,5 @@
-const require_base = require('../channels/base.cjs');
 const require_constants = require('../constants.cjs');
+const require_base = require('../channels/base.cjs');
 const require_schema = require('../state/schema.cjs');
 let _langchain_core_utils_types = require("@langchain/core/utils/types");
 

package/dist/graph/types.d.cts

@@ -1,7 +1,7 @@
+import { CommandInstance, END, Send } from "../constants.cjs";
 import { InteropZodToStateDefinition } from "./zod/meta.cjs";
 import { LangGraphRunnableConfig } from "../pregel/runnable_types.cjs";
 import { AnnotationRoot, StateDefinition, StateType, UpdateType } from "./annotation.cjs";
-import { CommandInstance, END, Send } from "../constants.cjs";
 import { AnyStateSchema, StateSchema, StateSchemaFieldsToStateDefinition } from "../state/schema.cjs";
 import { InteropZodObject } from "@langchain/core/utils/types";
 import { StandardSchemaV1 } from "@standard-schema/spec";

package/dist/graph/types.d.ts

@@ -1,7 +1,7 @@
+import { CommandInstance, END, Send } from "../constants.js";
 import { InteropZodToStateDefinition } from "./zod/meta.js";
 import { LangGraphRunnableConfig } from "../pregel/runnable_types.js";
 import { AnnotationRoot, StateDefinition, StateType, UpdateType } from "./annotation.js";
-import { CommandInstance, END, Send } from "../constants.js";
 import { AnyStateSchema, StateSchema, StateSchemaFieldsToStateDefinition } from "../state/schema.js";
 import { InteropZodObject } from "@langchain/core/utils/types";
 import { StandardSchemaV1 } from "@standard-schema/spec";

package/dist/graph/types.js

@@ -1,5 +1,5 @@
-import { isBaseChannel } from "../channels/base.js";
 import { END } from "../constants.js";
+import { isBaseChannel } from "../channels/base.js";
 import { StateSchema } from "../state/schema.js";
 import { isInteropZodObject } from "@langchain/core/utils/types";
 

package/dist/graph/zod/meta.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"meta.cjs","names":["BinaryOperatorAggregate","LastValue"],"sources":["../../../src/graph/zod/meta.ts"],"sourcesContent":["import {\n  InferInteropZodOutput,\n  InteropZodObject,\n  InteropZodType,\n  getInteropZodObjectShape,\n  extendInteropZodObject,\n  getInteropZodDefaultGetter,\n  interopZodObjectPartial,\n  InteropZodObjectShape,\n  isZodSchemaV3,\n  getSchemaDescription,\n} from \"@langchain/core/utils/types\";\nimport { BaseChannel } from \"../../channels/base.js\";\nimport { BinaryOperatorAggregate } from \"../../channels/binop.js\";\nimport { LastValue } from \"../../channels/last_value.js\";\n\nexport const META_EXTRAS_DESCRIPTION_PREFIX = \"lg:\";\n\n/** @internal */\nexport type ReducedZodChannel<\n  T extends InteropZodType,\n  TReducerSchema extends InteropZodType\n> = T & {\n  lg_reducer_schema: TReducerSchema;\n};\n\n/** @internal */\nexport type InteropZodToStateDefinition<\n  T extends InteropZodObject,\n  TShape = InteropZodObjectShape<T>\n> = {\n  [key in keyof TShape]: TShape[key] extends ReducedZodChannel<\n    infer Schema,\n    infer ReducerSchema\n  >\n    ? Schema extends InteropZodType<infer V>\n      ? ReducerSchema extends InteropZodType<infer U>\n        ? BaseChannel<V, U>\n        : never\n      : never\n    : TShape[key] extends InteropZodType<infer V, infer U>\n    ? BaseChannel<V, U>\n    : never;\n};\n\nexport type UpdateType<\n  T extends InteropZodObject,\n  TShape = InteropZodObjectShape<T>\n> = {\n  [key in keyof TShape]?: TShape[key] extends ReducedZodChannel<\n    infer Schema,\n    infer ReducerSchema\n  >\n    ? Schema extends InteropZodType<unknown>\n      ? ReducerSchema extends InteropZodType<infer U>\n        ? U\n        : never\n      : never\n    : TShape[key] extends InteropZodType<unknown, infer U>\n    ? U\n    : never;\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport interface SchemaMeta<TValue = any, TUpdate = TValue> {\n  jsonSchemaExtra?: {\n    langgraph_nodes?: string[];\n    langgraph_type?: \"prompt\" | \"messages\";\n    [key: string]: unknown;\n  };\n  reducer?: {\n    schema?: InteropZodType<TUpdate>;\n    fn: (a: TValue, b: TUpdate) => TValue;\n  };\n  default?: () => TValue;\n}\n\n/**\n * A registry for storing and managing metadata associated with schemas.\n * This class provides methods to get, extend, remove, and check metadata for a given schema.\n */\nexport class SchemaMetaRegistry {\n  /**\n   * Internal map storing schema metadata.\n   * @internal\n   */\n  _map = new Map<InteropZodType, SchemaMeta>();\n\n  /**\n   * Cache for extended schemas.\n   * @internal\n   */\n  _extensionCache = new Map<string, Map<InteropZodType, InteropZodType>>();\n\n  /**\n   * Retrieves the metadata associated with a given schema.\n   * @template TValue The value type of the schema.\n   * @template TUpdate The update type of the schema (defaults to TValue).\n   * @param schema The schema to retrieve metadata for.\n   * @returns The associated SchemaMeta, or undefined if not present.\n   */\n  get<TValue, TUpdate = TValue>(\n    schema: InteropZodType<TValue>\n  ): SchemaMeta<TValue, TUpdate> | undefined {\n    return this._map.get(schema);\n  }\n\n  /**\n   * Extends or sets the metadata for a given schema.\n   * @template TValue The value type of the schema.\n   * @template TUpdate The update type of the schema (defaults to TValue).\n   * @param schema The schema to extend metadata for.\n   * @param predicate A function that receives the existing metadata (or undefined) and returns the new metadata.\n   */\n  extend<TValue, TUpdate>(\n    schema: InteropZodType<TValue>,\n    predicate: (\n      meta: SchemaMeta<TValue, TUpdate> | undefined\n    ) => SchemaMeta<TValue, TUpdate>\n  ) {\n    const existingMeta = this.get<TValue, TUpdate>(schema);\n    this._map.set(schema, predicate(existingMeta));\n  }\n\n  /**\n   * Removes the metadata associated with a given schema.\n   * @param schema The schema to remove metadata for.\n   * @returns The SchemaMetaRegistry instance (for chaining).\n   */\n  remove(schema: InteropZodType): this {\n    this._map.delete(schema);\n    return this;\n  }\n\n  /**\n   * Checks if metadata exists for a given schema.\n   * @param schema The schema to check.\n   * @returns True if metadata exists, false otherwise.\n   */\n  has(schema: InteropZodType): boolean {\n    return this._map.has(schema);\n  }\n\n  /**\n   * Returns a mapping of channel instances for each property in the schema\n   * using the associated metadata in the registry.\n   *\n   * This is used to create the `channels` object that's passed to the `Graph` constructor.\n   *\n   * @template T The shape of the schema.\n   * @param schema The schema to extract channels from.\n   * @returns A mapping from property names to channel instances.\n   */\n  getChannelsForSchema<T extends InteropZodObject>(\n    schema: T\n  ): InteropZodToStateDefinition<T> {\n    const channels = {} as Record<string, BaseChannel>;\n    const shape = getInteropZodObjectShape(schema);\n    for (const [key, channelSchema] of Object.entries(shape)) {\n      const meta = this.get(channelSchema);\n      if (meta?.reducer) {\n        channels[key] = new BinaryOperatorAggregate<\n          InferInteropZodOutput<typeof channelSchema>\n        >(meta.reducer.fn, meta.default);\n      } else {\n        channels[key] = new LastValue(meta?.default);\n      }\n    }\n    return channels as InteropZodToStateDefinition<T>;\n  }\n\n  /**\n   * Returns a modified schema that introspectively looks at all keys of the provided\n   * object schema, and applies the augmentations based on meta provided with those keys\n   * in the registry and the selectors provided in the `effects` parameter.\n   *\n   * This assumes that the passed in schema is the \"root\" schema object for a graph where\n   * the keys of the schema are the channels of the graph. Because we need to represent\n   * the input of a graph in a couple of different ways, the `effects` parameter allows\n   * us to apply those augmentations based on pre determined conditions.\n   *\n   * @param schema The root schema object to extend.\n   * @param effects The effects that are being applied.\n   * @returns The extended schema.\n   */\n  getExtendedChannelSchemas<T extends InteropZodObject>(\n    schema: T,\n    effects: {\n      /**\n       * Augments the shape by using the reducer's schema if it exists\n       */\n      withReducerSchema?: boolean;\n      /**\n       * Applies the stringified jsonSchemaExtra as a description to the schema.\n       */\n      withJsonSchemaExtrasAsDescription?: boolean;\n      /**\n       * Applies the `.partial()` modifier to the schema.\n       */\n      asPartial?: boolean;\n    }\n  ): InteropZodObject {\n    // If no effects are being applied, return the schema unchanged\n    if (Object.keys(effects).length === 0) {\n      return schema;\n    }\n\n    // Cache key is determined by looking at the effects that are being applied\n    const cacheKey = Object.entries(effects)\n      .filter(([, v]) => v === true)\n      .sort(([a], [b]) => a.localeCompare(b))\n      .map(([k, v]) => `${k}:${v}`)\n      .join(\"|\");\n\n    const cache = this._extensionCache.get(cacheKey) ?? new Map();\n    if (cache.has(schema)) return cache.get(schema)! as T;\n\n    let modifiedSchema: InteropZodObject = schema;\n\n    if (\n      effects.withReducerSchema ||\n      effects.withJsonSchemaExtrasAsDescription\n    ) {\n      const newShapeEntries = Object.entries(\n        getInteropZodObjectShape(schema)\n      ).map(([key, schema]) => {\n        const meta = this.get(schema);\n        let outputSchema = effects.withReducerSchema\n          ? meta?.reducer?.schema ?? schema\n          : schema;\n        if (\n          effects.withJsonSchemaExtrasAsDescription &&\n          meta?.jsonSchemaExtra\n        ) {\n          const description =\n            getSchemaDescription(outputSchema) ?? getSchemaDescription(schema);\n          const strExtras = JSON.stringify({\n            ...meta.jsonSchemaExtra,\n            description,\n          });\n          outputSchema = outputSchema.describe(\n            `${META_EXTRAS_DESCRIPTION_PREFIX}${strExtras}`\n          );\n        }\n        return [key, outputSchema];\n      });\n      modifiedSchema = extendInteropZodObject(\n        schema,\n        Object.fromEntries(newShapeEntries)\n      );\n      if (isZodSchemaV3(modifiedSchema)) {\n        modifiedSchema._def.unknownKeys = \"strip\";\n      }\n    }\n    if (effects.asPartial) {\n      modifiedSchema = interopZodObjectPartial(modifiedSchema);\n    }\n\n    cache.set(schema, modifiedSchema);\n    this._extensionCache.set(cacheKey, cache);\n    return modifiedSchema;\n  }\n}\n\nexport const schemaMetaRegistry = new SchemaMetaRegistry();\n\nexport function withLangGraph<\n  TValue,\n  TUpdate,\n  TSchema extends InteropZodType<TValue>\n>(\n  schema: TSchema,\n  meta: SchemaMeta<TValue, TUpdate> & { reducer?: undefined }\n): TSchema;\nexport function withLangGraph<\n  TValue,\n  TUpdate,\n  TSchema extends InteropZodType<TValue>\n>(\n  schema: TSchema,\n  meta: SchemaMeta<TValue, TUpdate>\n): ReducedZodChannel<TSchema, InteropZodType<TUpdate>>;\nexport function withLangGraph<\n  TValue,\n  TUpdate,\n  TSchema extends InteropZodType<TValue>\n>(\n  schema: TSchema,\n  meta: SchemaMeta<TValue, TUpdate>\n): ReducedZodChannel<TSchema, InteropZodType<TUpdate>> | TSchema {\n  if (meta.reducer && !meta.default) {\n    const defaultValueGetter = getInteropZodDefaultGetter(schema);\n    if (defaultValueGetter != null) {\n      // eslint-disable-next-line no-param-reassign\n      meta.default = defaultValueGetter;\n    }\n  }\n  if (meta.reducer) {\n    const schemaWithReducer = Object.assign(schema, {\n      lg_reducer_schema: meta.reducer?.schema ?? schema,\n    });\n    schemaMetaRegistry.extend(schemaWithReducer, () => meta);\n    return schemaWithReducer;\n  } else {\n    schemaMetaRegistry.extend(schema, () => meta);\n    return schema;\n  }\n}\n"],"mappings":";;;;;AAgBA,MAAa,iCAAiC;;;;;AAiE9C,IAAa,qBAAb,MAAgC;;;;;CAK9B,uBAAO,IAAI,KAAiC;;;;;CAM5C,kCAAkB,IAAI,KAAkD;;;;;;;;CASxE,IACE,QACyC;AACzC,SAAO,KAAK,KAAK,IAAI,OAAO;;;;;;;;;CAU9B,OACE,QACA,WAGA;EACA,MAAM,eAAe,KAAK,IAAqB,OAAO;AACtD,OAAK,KAAK,IAAI,QAAQ,UAAU,aAAa,CAAC;;;;;;;CAQhD,OAAO,QAA8B;AACnC,OAAK,KAAK,OAAO,OAAO;AACxB,SAAO;;;;;;;CAQT,IAAI,QAAiC;AACnC,SAAO,KAAK,KAAK,IAAI,OAAO;;;;;;;;;;;;CAa9B,qBACE,QACgC;EAChC,MAAM,WAAW,EAAE;EACnB,MAAM,kEAAiC,OAAO;AAC9C,OAAK,MAAM,CAAC,KAAK,kBAAkB,OAAO,QAAQ,MAAM,EAAE;GACxD,MAAM,OAAO,KAAK,IAAI,cAAc;AACpC,OAAI,MAAM,QACR,UAAS,OAAO,IAAIA,sCAElB,KAAK,QAAQ,IAAI,KAAK,QAAQ;OAEhC,UAAS,OAAO,IAAIC,6BAAU,MAAM,QAAQ;;AAGhD,SAAO;;;;;;;;;;;;;;;;CAiBT,0BACE,QACA,SAckB;AAElB,MAAI,OAAO,KAAK,QAAQ,CAAC,WAAW,EAClC,QAAO;EAIT,MAAM,WAAW,OAAO,QAAQ,QAAQ,CACrC,QAAQ,GAAG,OAAO,MAAM,KAAK,CAC7B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC,CACtC,KAAK,CAAC,GAAG,OAAO,GAAG,EAAE,GAAG,IAAI,CAC5B,KAAK,IAAI;EAEZ,MAAM,QAAQ,KAAK,gBAAgB,IAAI,SAAS,oBAAI,IAAI,KAAK;AAC7D,MAAI,MAAM,IAAI,OAAO,CAAE,QAAO,MAAM,IAAI,OAAO;EAE/C,IAAI,iBAAmC;AAEvC,MACE,QAAQ,qBACR,QAAQ,mCACR;GACA,MAAM,kBAAkB,OAAO,kEACJ,OAAO,CACjC,CAAC,KAAK,CAAC,KAAK,YAAY;IACvB,MAAM,OAAO,KAAK,IAAI,OAAO;IAC7B,IAAI,eAAe,QAAQ,oBACvB,MAAM,SAAS,UAAU,SACzB;AACJ,QACE,QAAQ,qCACR,MAAM,iBACN;KACA,MAAM,oEACiB,aAAa,0DAAyB,OAAO;KACpE,MAAM,YAAY,KAAK,UAAU;MAC/B,GAAG,KAAK;MACR;MACD,CAAC;AACF,oBAAe,aAAa,SAC1B,GAAG,iCAAiC,YACrC;;AAEH,WAAO,CAAC,KAAK,aAAa;KAC1B;AACF,4EACE,QACA,OAAO,YAAY,gBAAgB,CACpC;AACD,sDAAkB,eAAe,CAC/B,gBAAe,KAAK,cAAc;;AAGtC,MAAI,QAAQ,UACV,2EAAyC,eAAe;AAG1D,QAAM,IAAI,QAAQ,eAAe;AACjC,OAAK,gBAAgB,IAAI,UAAU,MAAM;AACzC,SAAO;;;AAIX,MAAa,qBAAqB,IAAI,oBAAoB;AAkB1D,SAAgB,cAKd,QACA,MAC+D;AAC/D,KAAI,KAAK,WAAW,CAAC,KAAK,SAAS;EACjC,MAAM,iFAAgD,OAAO;AAC7D,MAAI,sBAAsB,KAExB,MAAK,UAAU;;AAGnB,KAAI,KAAK,SAAS;EAChB,MAAM,oBAAoB,OAAO,OAAO,QAAQ,EAC9C,mBAAmB,KAAK,SAAS,UAAU,QAC5C,CAAC;AACF,qBAAmB,OAAO,yBAAyB,KAAK;AACxD,SAAO;QACF;AACL,qBAAmB,OAAO,cAAc,KAAK;AAC7C,SAAO"}
+{"version":3,"file":"meta.cjs","names":["BinaryOperatorAggregate","LastValue"],"sources":["../../../src/graph/zod/meta.ts"],"sourcesContent":["import {\n  InferInteropZodOutput,\n  InteropZodObject,\n  InteropZodType,\n  getInteropZodObjectShape,\n  extendInteropZodObject,\n  getInteropZodDefaultGetter,\n  interopZodObjectPartial,\n  InteropZodObjectShape,\n  isZodSchemaV3,\n  getSchemaDescription,\n} from \"@langchain/core/utils/types\";\nimport { BaseChannel } from \"../../channels/base.js\";\nimport { BinaryOperatorAggregate } from \"../../channels/binop.js\";\nimport { LastValue } from \"../../channels/last_value.js\";\nimport type { OverwriteValue } from \"../../constants.js\";\n\nexport const META_EXTRAS_DESCRIPTION_PREFIX = \"lg:\";\n\n/** @internal */\nexport type ReducedZodChannel<\n  T extends InteropZodType,\n  TReducerSchema extends InteropZodType\n> = T & {\n  lg_reducer_schema: TReducerSchema;\n};\n\n/** @internal */\nexport type InteropZodToStateDefinition<\n  T extends InteropZodObject,\n  TShape = InteropZodObjectShape<T>\n> = {\n  [key in keyof TShape]: TShape[key] extends ReducedZodChannel<\n    infer Schema,\n    infer ReducerSchema\n  >\n    ? Schema extends InteropZodType<infer V>\n      ? ReducerSchema extends InteropZodType<infer U>\n        ? BaseChannel<V, OverwriteValue<V> | U>\n        : never\n      : never\n    : TShape[key] extends InteropZodType<infer V, infer U>\n    ? BaseChannel<V, U>\n    : never;\n};\n\nexport type UpdateType<\n  T extends InteropZodObject,\n  TShape = InteropZodObjectShape<T>\n> = {\n  [key in keyof TShape]?: TShape[key] extends ReducedZodChannel<\n    infer Schema,\n    infer ReducerSchema\n  >\n    ? Schema extends InteropZodType<infer V>\n      ? ReducerSchema extends InteropZodType<infer U>\n        ? OverwriteValue<V> | U\n        : never\n      : never\n    : TShape[key] extends InteropZodType<unknown, infer U>\n    ? U\n    : never;\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport interface SchemaMeta<TValue = any, TUpdate = TValue> {\n  jsonSchemaExtra?: {\n    langgraph_nodes?: string[];\n    langgraph_type?: \"prompt\" | \"messages\";\n    [key: string]: unknown;\n  };\n  reducer?: {\n    schema?: InteropZodType<TUpdate>;\n    fn: (a: TValue, b: TUpdate) => TValue;\n  };\n  default?: () => TValue;\n}\n\n/**\n * A registry for storing and managing metadata associated with schemas.\n * This class provides methods to get, extend, remove, and check metadata for a given schema.\n */\nexport class SchemaMetaRegistry {\n  /**\n   * Internal map storing schema metadata.\n   * @internal\n   */\n  _map = new Map<InteropZodType, SchemaMeta>();\n\n  /**\n   * Cache for extended schemas.\n   * @internal\n   */\n  _extensionCache = new Map<string, Map<InteropZodType, InteropZodType>>();\n\n  /**\n   * Retrieves the metadata associated with a given schema.\n   * @template TValue The value type of the schema.\n   * @template TUpdate The update type of the schema (defaults to TValue).\n   * @param schema The schema to retrieve metadata for.\n   * @returns The associated SchemaMeta, or undefined if not present.\n   */\n  get<TValue, TUpdate = TValue>(\n    schema: InteropZodType<TValue>\n  ): SchemaMeta<TValue, TUpdate> | undefined {\n    return this._map.get(schema);\n  }\n\n  /**\n   * Extends or sets the metadata for a given schema.\n   * @template TValue The value type of the schema.\n   * @template TUpdate The update type of the schema (defaults to TValue).\n   * @param schema The schema to extend metadata for.\n   * @param predicate A function that receives the existing metadata (or undefined) and returns the new metadata.\n   */\n  extend<TValue, TUpdate>(\n    schema: InteropZodType<TValue>,\n    predicate: (\n      meta: SchemaMeta<TValue, TUpdate> | undefined\n    ) => SchemaMeta<TValue, TUpdate>\n  ) {\n    const existingMeta = this.get<TValue, TUpdate>(schema);\n    this._map.set(schema, predicate(existingMeta));\n  }\n\n  /**\n   * Removes the metadata associated with a given schema.\n   * @param schema The schema to remove metadata for.\n   * @returns The SchemaMetaRegistry instance (for chaining).\n   */\n  remove(schema: InteropZodType): this {\n    this._map.delete(schema);\n    return this;\n  }\n\n  /**\n   * Checks if metadata exists for a given schema.\n   * @param schema The schema to check.\n   * @returns True if metadata exists, false otherwise.\n   */\n  has(schema: InteropZodType): boolean {\n    return this._map.has(schema);\n  }\n\n  /**\n   * Returns a mapping of channel instances for each property in the schema\n   * using the associated metadata in the registry.\n   *\n   * This is used to create the `channels` object that's passed to the `Graph` constructor.\n   *\n   * @template T The shape of the schema.\n   * @param schema The schema to extract channels from.\n   * @returns A mapping from property names to channel instances.\n   */\n  getChannelsForSchema<T extends InteropZodObject>(\n    schema: T\n  ): InteropZodToStateDefinition<T> {\n    const channels = {} as Record<string, BaseChannel>;\n    const shape = getInteropZodObjectShape(schema);\n    for (const [key, channelSchema] of Object.entries(shape)) {\n      const meta = this.get(channelSchema);\n      if (meta?.reducer) {\n        channels[key] = new BinaryOperatorAggregate<\n          InferInteropZodOutput<typeof channelSchema>\n        >(meta.reducer.fn, meta.default);\n      } else {\n        channels[key] = new LastValue(meta?.default);\n      }\n    }\n    return channels as InteropZodToStateDefinition<T>;\n  }\n\n  /**\n   * Returns a modified schema that introspectively looks at all keys of the provided\n   * object schema, and applies the augmentations based on meta provided with those keys\n   * in the registry and the selectors provided in the `effects` parameter.\n   *\n   * This assumes that the passed in schema is the \"root\" schema object for a graph where\n   * the keys of the schema are the channels of the graph. Because we need to represent\n   * the input of a graph in a couple of different ways, the `effects` parameter allows\n   * us to apply those augmentations based on pre determined conditions.\n   *\n   * @param schema The root schema object to extend.\n   * @param effects The effects that are being applied.\n   * @returns The extended schema.\n   */\n  getExtendedChannelSchemas<T extends InteropZodObject>(\n    schema: T,\n    effects: {\n      /**\n       * Augments the shape by using the reducer's schema if it exists\n       */\n      withReducerSchema?: boolean;\n      /**\n       * Applies the stringified jsonSchemaExtra as a description to the schema.\n       */\n      withJsonSchemaExtrasAsDescription?: boolean;\n      /**\n       * Applies the `.partial()` modifier to the schema.\n       */\n      asPartial?: boolean;\n    }\n  ): InteropZodObject {\n    // If no effects are being applied, return the schema unchanged\n    if (Object.keys(effects).length === 0) {\n      return schema;\n    }\n\n    // Cache key is determined by looking at the effects that are being applied\n    const cacheKey = Object.entries(effects)\n      .filter(([, v]) => v === true)\n      .sort(([a], [b]) => a.localeCompare(b))\n      .map(([k, v]) => `${k}:${v}`)\n      .join(\"|\");\n\n    const cache = this._extensionCache.get(cacheKey) ?? new Map();\n    if (cache.has(schema)) return cache.get(schema)! as T;\n\n    let modifiedSchema: InteropZodObject = schema;\n\n    if (\n      effects.withReducerSchema ||\n      effects.withJsonSchemaExtrasAsDescription\n    ) {\n      const newShapeEntries = Object.entries(\n        getInteropZodObjectShape(schema)\n      ).map(([key, schema]) => {\n        const meta = this.get(schema);\n        let outputSchema = effects.withReducerSchema\n          ? meta?.reducer?.schema ?? schema\n          : schema;\n        if (\n          effects.withJsonSchemaExtrasAsDescription &&\n          meta?.jsonSchemaExtra\n        ) {\n          const description =\n            getSchemaDescription(outputSchema) ?? getSchemaDescription(schema);\n          const strExtras = JSON.stringify({\n            ...meta.jsonSchemaExtra,\n            description,\n          });\n          outputSchema = outputSchema.describe(\n            `${META_EXTRAS_DESCRIPTION_PREFIX}${strExtras}`\n          );\n        }\n        return [key, outputSchema];\n      });\n      modifiedSchema = extendInteropZodObject(\n        schema,\n        Object.fromEntries(newShapeEntries)\n      );\n      if (isZodSchemaV3(modifiedSchema)) {\n        modifiedSchema._def.unknownKeys = \"strip\";\n      }\n    }\n    if (effects.asPartial) {\n      modifiedSchema = interopZodObjectPartial(modifiedSchema);\n    }\n\n    cache.set(schema, modifiedSchema);\n    this._extensionCache.set(cacheKey, cache);\n    return modifiedSchema;\n  }\n}\n\nexport const schemaMetaRegistry = new SchemaMetaRegistry();\n\nexport function withLangGraph<\n  TValue,\n  TUpdate,\n  TSchema extends InteropZodType<TValue>\n>(\n  schema: TSchema,\n  meta: SchemaMeta<TValue, TUpdate> & { reducer?: undefined }\n): TSchema;\nexport function withLangGraph<\n  TValue,\n  TUpdate,\n  TSchema extends InteropZodType<TValue>\n>(\n  schema: TSchema,\n  meta: SchemaMeta<TValue, TUpdate>\n): ReducedZodChannel<TSchema, InteropZodType<TUpdate>>;\nexport function withLangGraph<\n  TValue,\n  TUpdate,\n  TSchema extends InteropZodType<TValue>\n>(\n  schema: TSchema,\n  meta: SchemaMeta<TValue, TUpdate>\n): ReducedZodChannel<TSchema, InteropZodType<TUpdate>> | TSchema {\n  if (meta.reducer && !meta.default) {\n    const defaultValueGetter = getInteropZodDefaultGetter(schema);\n    if (defaultValueGetter != null) {\n      // eslint-disable-next-line no-param-reassign\n      meta.default = defaultValueGetter;\n    }\n  }\n  if (meta.reducer) {\n    const schemaWithReducer = Object.assign(schema, {\n      lg_reducer_schema: meta.reducer?.schema ?? schema,\n    });\n    schemaMetaRegistry.extend(schemaWithReducer, () => meta);\n    return schemaWithReducer;\n  } else {\n    schemaMetaRegistry.extend(schema, () => meta);\n    return schema;\n  }\n}\n"],"mappings":";;;;;AAiBA,MAAa,iCAAiC;;;;;AAiE9C,IAAa,qBAAb,MAAgC;;;;;CAK9B,uBAAO,IAAI,KAAiC;;;;;CAM5C,kCAAkB,IAAI,KAAkD;;;;;;;;CASxE,IACE,QACyC;AACzC,SAAO,KAAK,KAAK,IAAI,OAAO;;;;;;;;;CAU9B,OACE,QACA,WAGA;EACA,MAAM,eAAe,KAAK,IAAqB,OAAO;AACtD,OAAK,KAAK,IAAI,QAAQ,UAAU,aAAa,CAAC;;;;;;;CAQhD,OAAO,QAA8B;AACnC,OAAK,KAAK,OAAO,OAAO;AACxB,SAAO;;;;;;;CAQT,IAAI,QAAiC;AACnC,SAAO,KAAK,KAAK,IAAI,OAAO;;;;;;;;;;;;CAa9B,qBACE,QACgC;EAChC,MAAM,WAAW,EAAE;EACnB,MAAM,kEAAiC,OAAO;AAC9C,OAAK,MAAM,CAAC,KAAK,kBAAkB,OAAO,QAAQ,MAAM,EAAE;GACxD,MAAM,OAAO,KAAK,IAAI,cAAc;AACpC,OAAI,MAAM,QACR,UAAS,OAAO,IAAIA,sCAElB,KAAK,QAAQ,IAAI,KAAK,QAAQ;OAEhC,UAAS,OAAO,IAAIC,6BAAU,MAAM,QAAQ;;AAGhD,SAAO;;;;;;;;;;;;;;;;CAiBT,0BACE,QACA,SAckB;AAElB,MAAI,OAAO,KAAK,QAAQ,CAAC,WAAW,EAClC,QAAO;EAIT,MAAM,WAAW,OAAO,QAAQ,QAAQ,CACrC,QAAQ,GAAG,OAAO,MAAM,KAAK,CAC7B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC,CACtC,KAAK,CAAC,GAAG,OAAO,GAAG,EAAE,GAAG,IAAI,CAC5B,KAAK,IAAI;EAEZ,MAAM,QAAQ,KAAK,gBAAgB,IAAI,SAAS,oBAAI,IAAI,KAAK;AAC7D,MAAI,MAAM,IAAI,OAAO,CAAE,QAAO,MAAM,IAAI,OAAO;EAE/C,IAAI,iBAAmC;AAEvC,MACE,QAAQ,qBACR,QAAQ,mCACR;GACA,MAAM,kBAAkB,OAAO,kEACJ,OAAO,CACjC,CAAC,KAAK,CAAC,KAAK,YAAY;IACvB,MAAM,OAAO,KAAK,IAAI,OAAO;IAC7B,IAAI,eAAe,QAAQ,oBACvB,MAAM,SAAS,UAAU,SACzB;AACJ,QACE,QAAQ,qCACR,MAAM,iBACN;KACA,MAAM,oEACiB,aAAa,0DAAyB,OAAO;KACpE,MAAM,YAAY,KAAK,UAAU;MAC/B,GAAG,KAAK;MACR;MACD,CAAC;AACF,oBAAe,aAAa,SAC1B,GAAG,iCAAiC,YACrC;;AAEH,WAAO,CAAC,KAAK,aAAa;KAC1B;AACF,4EACE,QACA,OAAO,YAAY,gBAAgB,CACpC;AACD,sDAAkB,eAAe,CAC/B,gBAAe,KAAK,cAAc;;AAGtC,MAAI,QAAQ,UACV,2EAAyC,eAAe;AAG1D,QAAM,IAAI,QAAQ,eAAe;AACjC,OAAK,gBAAgB,IAAI,UAAU,MAAM;AACzC,SAAO;;;AAIX,MAAa,qBAAqB,IAAI,oBAAoB;AAkB1D,SAAgB,cAKd,QACA,MAC+D;AAC/D,KAAI,KAAK,WAAW,CAAC,KAAK,SAAS;EACjC,MAAM,iFAAgD,OAAO;AAC7D,MAAI,sBAAsB,KAExB,MAAK,UAAU;;AAGnB,KAAI,KAAK,SAAS;EAChB,MAAM,oBAAoB,OAAO,OAAO,QAAQ,EAC9C,mBAAmB,KAAK,SAAS,UAAU,QAC5C,CAAC;AACF,qBAAmB,OAAO,yBAAyB,KAAK;AACxD,SAAO;QACF;AACL,qBAAmB,OAAO,cAAc,KAAK;AAC7C,SAAO"}

package/dist/graph/zod/meta.d.cts

@@ -1,4 +1,5 @@
 import { BaseChannel } from "../../channels/base.cjs";
+import { OverwriteValue } from "../../constants.cjs";
 import { InteropZodObject, InteropZodObjectShape, InteropZodType } from "@langchain/core/utils/types";
 
 //#region src/graph/zod/meta.d.ts
@@ -8,8 +9,8 @@ type ReducedZodChannel<T extends InteropZodType, TReducerSchema extends InteropZ
   lg_reducer_schema: TReducerSchema;
 };
 /** @internal */
-type InteropZodToStateDefinition<T extends InteropZodObject, TShape = InteropZodObjectShape<T>> = { [key in keyof TShape]: TShape[key] extends ReducedZodChannel<infer Schema, infer ReducerSchema> ? Schema extends InteropZodType<infer V> ? ReducerSchema extends InteropZodType<infer U> ? BaseChannel<V, U> : never : never : TShape[key] extends InteropZodType<infer V, infer U> ? BaseChannel<V, U> : never };
-type UpdateType<T extends InteropZodObject, TShape = InteropZodObjectShape<T>> = { [key in keyof TShape]?: TShape[key] extends ReducedZodChannel<infer Schema, infer ReducerSchema> ? Schema extends InteropZodType<unknown> ? ReducerSchema extends InteropZodType<infer U> ? U : never : never : TShape[key] extends InteropZodType<unknown, infer U> ? U : never };
+type InteropZodToStateDefinition<T extends InteropZodObject, TShape = InteropZodObjectShape<T>> = { [key in keyof TShape]: TShape[key] extends ReducedZodChannel<infer Schema, infer ReducerSchema> ? Schema extends InteropZodType<infer V> ? ReducerSchema extends InteropZodType<infer U> ? BaseChannel<V, OverwriteValue<V> | U> : never : never : TShape[key] extends InteropZodType<infer V, infer U> ? BaseChannel<V, U> : never };
+type UpdateType<T extends InteropZodObject, TShape = InteropZodObjectShape<T>> = { [key in keyof TShape]?: TShape[key] extends ReducedZodChannel<infer Schema, infer ReducerSchema> ? Schema extends InteropZodType<infer V> ? ReducerSchema extends InteropZodType<infer U> ? OverwriteValue<V> | U : never : never : TShape[key] extends InteropZodType<unknown, infer U> ? U : never };
 interface SchemaMeta<TValue = any, TUpdate = TValue> {
   jsonSchemaExtra?: {
     langgraph_nodes?: string[];

package/dist/graph/zod/meta.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"meta.d.cts","names":[],"sources":["../../../src/graph/zod/meta.ts"],"mappings":";;;;cAgBa,8BAAA;;KAGD,iBAAA,WACA,cAAA,yBACa,cAAA,IACrB,CAAA;EACF,iBAAA,EAAmB,cAAA;AAAA;;KAIT,2BAAA,WACA,gBAAA,WACD,qBAAA,CAAsB,CAAA,qBAEjB,MAAA,GAAS,MAAA,CAAO,GAAA,UAAa,iBAAA,sCAIvC,MAAA,SAAe,cAAA,YACb,aAAA,SAAsB,cAAA,YACpB,WAAA,CAAY,CAAA,EAAG,CAAA,oBAGnB,MAAA,CAAO,GAAA,UAAa,cAAA,qBACpB,WAAA,CAAY,CAAA,EAAG,CAAA;AAAA,KAIT,UAAA,WACA,gBAAA,WACD,qBAAA,CAAsB,CAAA,qBAEjB,MAAA,IAAU,MAAA,CAAO,GAAA,UAAa,iBAAA,sCAIxC,MAAA,SAAe,cAAA,YACb,aAAA,SAAsB,cAAA,YACpB,CAAA,mBAGJ,MAAA,CAAO,GAAA,UAAa,cAAA,qBACpB,CAAA;AAAA,UAKW,UAAA,yBAAmC,MAAA;EAClD,eAAA;IACE,eAAA;IACA,cAAA;IAAA,CACC,GAAA;EAAA;EAEH,OAAA;IACE,MAAA,GAAS,cAAA,CAAe,OAAA;IACxB,EAAA,GAAK,CAAA,EAAG,MAAA,EAAQ,CAAA,EAAG,OAAA,KAAY,MAAA;EAAA;EAEjC,OAAA,SAAgB,MAAA;AAAA;;AA/ClB;;;cAsDa,kBAAA;EApDoB;;;;EAyD/B,IAAA,EAAI,GAAA,CAAA,cAAA,EAAA,UAAA;EAvDuC;;;;EA6D3C,eAAA,EAAe,GAAA,SAAA,GAAA,CAAA,cAAA,EAAA,cAAA;EAvDP;;;;;;;EAgER,GAAA,mBAAsB,MAAA,CAAA,CACpB,MAAA,EAAQ,cAAA,CAAe,MAAA,IACtB,UAAA,CAAW,MAAA,EAAQ,OAAA;EA9DP;;;;;;;EAyEf,MAAA,iBAAA,CACE,MAAA,EAAQ,cAAA,CAAe,MAAA,GACvB,SAAA,GACE,IAAA,EAAM,UAAA,CAAW,MAAA,EAAQ,OAAA,kBACtB,UAAA,CAAW,MAAA,EAAQ,OAAA;EAvFH;;;;;EAkGvB,MAAA,CAAO,MAAA,EAAQ,cAAA;EA9FI;;;;;EAwGnB,GAAA,CAAI,MAAA,EAAQ,cAAA;EAtGQ;;;;;;;;;;EAoHpB,oBAAA,WAA+B,gBAAA,CAAA,CAC7B,MAAA,EAAQ,CAAA,GACP,2BAAA,CAA4B,CAAA;EAlHX;AAItB;;;;;;;;;;;;;EA4IE,yBAAA,WAAoC,gBAAA,CAAA,CAClC,MAAA,EAAQ,CAAA,EACR,OAAA;IAjIsB;;;IAqIpB,iBAAA;IAjJM;;;IAqJN,iCAAA;IAlJH;;;IAsJG,SAAA;EAAA,IAED,gBAAA;AAAA;AAAA,cA+DQ,kBAAA,EAAkB,kBAAA;AAAA,iBAEf,aAAA,kCAGE,cAAA,CAAe,MAAA,EAAA,CAE/B,MAAA,EAAQ,OAAA,EACR,IAAA,EAAM,UAAA,CAAW,MAAA,EAAQ,OAAA;EAAa,OAAA;AAAA,IACrC,OAAA;AAAA,iBACa,aAAA,kCAGE,cAAA,CAAe,MAAA,EAAA,CAE/B,MAAA,EAAQ,OAAA,EACR,IAAA,EAAM,UAAA,CAAW,MAAA,EAAQ,OAAA,IACxB,iBAAA,CAAkB,OAAA,EAAS,cAAA,CAAe,OAAA"}
+{"version":3,"file":"meta.d.cts","names":[],"sources":["../../../src/graph/zod/meta.ts"],"mappings":";;;;;cAiBa,8BAAA;;KAGD,iBAAA,WACA,cAAA,yBACa,cAAA,IACrB,CAAA;EACF,iBAAA,EAAmB,cAAA;AAAA;;KAIT,2BAAA,WACA,gBAAA,WACD,qBAAA,CAAsB,CAAA,qBAEjB,MAAA,GAAS,MAAA,CAAO,GAAA,UAAa,iBAAA,sCAIvC,MAAA,SAAe,cAAA,YACb,aAAA,SAAsB,cAAA,YACpB,WAAA,CAAY,CAAA,EAAG,cAAA,CAAe,CAAA,IAAK,CAAA,oBAGvC,MAAA,CAAO,GAAA,UAAa,cAAA,qBACpB,WAAA,CAAY,CAAA,EAAG,CAAA;AAAA,KAIT,UAAA,WACA,gBAAA,WACD,qBAAA,CAAsB,CAAA,qBAEjB,MAAA,IAAU,MAAA,CAAO,GAAA,UAAa,iBAAA,sCAIxC,MAAA,SAAe,cAAA,YACb,aAAA,SAAsB,cAAA,YACpB,cAAA,CAAe,CAAA,IAAK,CAAA,mBAGxB,MAAA,CAAO,GAAA,UAAa,cAAA,qBACpB,CAAA;AAAA,UAKW,UAAA,yBAAmC,MAAA;EAClD,eAAA;IACE,eAAA;IACA,cAAA;IAAA,CACC,GAAA;EAAA;EAEH,OAAA;IACE,MAAA,GAAS,cAAA,CAAe,OAAA;IACxB,EAAA,GAAK,CAAA,EAAG,MAAA,EAAQ,CAAA,EAAG,OAAA,KAAY,MAAA;EAAA;EAEjC,OAAA,SAAgB,MAAA;AAAA;;AA/ClB;;;cAsDa,kBAAA;EApDoB;;;;EAyD/B,IAAA,EAAI,GAAA,CAAA,cAAA,EAAA,UAAA;EAvDuC;;;;EA6D3C,eAAA,EAAe,GAAA,SAAA,GAAA,CAAA,cAAA,EAAA,cAAA;EAvDQ;;;;;;;EAgEvB,GAAA,mBAAsB,MAAA,CAAA,CACpB,MAAA,EAAQ,cAAA,CAAe,MAAA,IACtB,UAAA,CAAW,MAAA,EAAQ,OAAA;EA9DlB;;;;;;;EAyEJ,MAAA,iBAAA,CACE,MAAA,EAAQ,cAAA,CAAe,MAAA,GACvB,SAAA,GACE,IAAA,EAAM,UAAA,CAAW,MAAA,EAAQ,OAAA,kBACtB,UAAA,CAAW,MAAA,EAAQ,OAAA;EAvFzB;;;;;EAkGD,MAAA,CAAO,MAAA,EAAQ,cAAA;EAhGP;;;;;EA0GR,GAAA,CAAI,MAAA,EAAQ,cAAA;EAvGqC;;;;;;;;;;EAqHjD,oBAAA,WAA+B,gBAAA,CAAA,CAC7B,MAAA,EAAQ,CAAA,GACP,2BAAA,CAA4B,CAAA;EAlH3B;;;;;AAIN;;;;;;;;;EA4IE,yBAAA,WAAoC,gBAAA,CAAA,CAClC,MAAA,EAAQ,CAAA,EACR,OAAA;IAtIiB;;;IA0If,iBAAA;IAxIwB;;;IA4IxB,iCAAA;IAzIkC;;;IA6IlC,SAAA;EAAA,IAED,gBAAA;AAAA;AAAA,cA+DQ,kBAAA,EAAkB,kBAAA;AAAA,iBAEf,aAAA,kCAGE,cAAA,CAAe,MAAA,EAAA,CAE/B,MAAA,EAAQ,OAAA,EACR,IAAA,EAAM,UAAA,CAAW,MAAA,EAAQ,OAAA;EAAa,OAAA;AAAA,IACrC,OAAA;AAAA,iBACa,aAAA,kCAGE,cAAA,CAAe,MAAA,EAAA,CAE/B,MAAA,EAAQ,OAAA,EACR,IAAA,EAAM,UAAA,CAAW,MAAA,EAAQ,OAAA,IACxB,iBAAA,CAAkB,OAAA,EAAS,cAAA,CAAe,OAAA"}

package/dist/graph/zod/meta.d.ts

@@ -1,4 +1,5 @@
 import { BaseChannel } from "../../channels/base.js";
+import { OverwriteValue } from "../../constants.js";
 import { InteropZodObject, InteropZodObjectShape, InteropZodType } from "@langchain/core/utils/types";
 
 //#region src/graph/zod/meta.d.ts
@@ -8,8 +9,8 @@ type ReducedZodChannel<T extends InteropZodType, TReducerSchema extends InteropZ
   lg_reducer_schema: TReducerSchema;
 };
 /** @internal */
-type InteropZodToStateDefinition<T extends InteropZodObject, TShape = InteropZodObjectShape<T>> = { [key in keyof TShape]: TShape[key] extends ReducedZodChannel<infer Schema, infer ReducerSchema> ? Schema extends InteropZodType<infer V> ? ReducerSchema extends InteropZodType<infer U> ? BaseChannel<V, U> : never : never : TShape[key] extends InteropZodType<infer V, infer U> ? BaseChannel<V, U> : never };
-type UpdateType<T extends InteropZodObject, TShape = InteropZodObjectShape<T>> = { [key in keyof TShape]?: TShape[key] extends ReducedZodChannel<infer Schema, infer ReducerSchema> ? Schema extends InteropZodType<unknown> ? ReducerSchema extends InteropZodType<infer U> ? U : never : never : TShape[key] extends InteropZodType<unknown, infer U> ? U : never };
+type InteropZodToStateDefinition<T extends InteropZodObject, TShape = InteropZodObjectShape<T>> = { [key in keyof TShape]: TShape[key] extends ReducedZodChannel<infer Schema, infer ReducerSchema> ? Schema extends InteropZodType<infer V> ? ReducerSchema extends InteropZodType<infer U> ? BaseChannel<V, OverwriteValue<V> | U> : never : never : TShape[key] extends InteropZodType<infer V, infer U> ? BaseChannel<V, U> : never };
+type UpdateType<T extends InteropZodObject, TShape = InteropZodObjectShape<T>> = { [key in keyof TShape]?: TShape[key] extends ReducedZodChannel<infer Schema, infer ReducerSchema> ? Schema extends InteropZodType<infer V> ? ReducerSchema extends InteropZodType<infer U> ? OverwriteValue<V> | U : never : never : TShape[key] extends InteropZodType<unknown, infer U> ? U : never };
 interface SchemaMeta<TValue = any, TUpdate = TValue> {
   jsonSchemaExtra?: {
     langgraph_nodes?: string[];

package/dist/graph/zod/meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"meta.d.ts","names":[],"sources":["../../../src/graph/zod/meta.ts"],"mappings":";;;;cAgBa,8BAAA;;KAGD,iBAAA,WACA,cAAA,yBACa,cAAA,IACrB,CAAA;EACF,iBAAA,EAAmB,cAAA;AAAA;;KAIT,2BAAA,WACA,gBAAA,WACD,qBAAA,CAAsB,CAAA,qBAEjB,MAAA,GAAS,MAAA,CAAO,GAAA,UAAa,iBAAA,sCAIvC,MAAA,SAAe,cAAA,YACb,aAAA,SAAsB,cAAA,YACpB,WAAA,CAAY,CAAA,EAAG,CAAA,oBAGnB,MAAA,CAAO,GAAA,UAAa,cAAA,qBACpB,WAAA,CAAY,CAAA,EAAG,CAAA;AAAA,KAIT,UAAA,WACA,gBAAA,WACD,qBAAA,CAAsB,CAAA,qBAEjB,MAAA,IAAU,MAAA,CAAO,GAAA,UAAa,iBAAA,sCAIxC,MAAA,SAAe,cAAA,YACb,aAAA,SAAsB,cAAA,YACpB,CAAA,mBAGJ,MAAA,CAAO,GAAA,UAAa,cAAA,qBACpB,CAAA;AAAA,UAKW,UAAA,yBAAmC,MAAA;EAClD,eAAA;IACE,eAAA;IACA,cAAA;IAAA,CACC,GAAA;EAAA;EAEH,OAAA;IACE,MAAA,GAAS,cAAA,CAAe,OAAA;IACxB,EAAA,GAAK,CAAA,EAAG,MAAA,EAAQ,CAAA,EAAG,OAAA,KAAY,MAAA;EAAA;EAEjC,OAAA,SAAgB,MAAA;AAAA;;AA/ClB;;;cAsDa,kBAAA;EApDoB;;;;EAyD/B,IAAA,EAAI,GAAA,CAAA,cAAA,EAAA,UAAA;EAvDuC;;;;EA6D3C,eAAA,EAAe,GAAA,SAAA,GAAA,CAAA,cAAA,EAAA,cAAA;EAvDP;;;;;;;EAgER,GAAA,mBAAsB,MAAA,CAAA,CACpB,MAAA,EAAQ,cAAA,CAAe,MAAA,IACtB,UAAA,CAAW,MAAA,EAAQ,OAAA;EA9DP;;;;;;;EAyEf,MAAA,iBAAA,CACE,MAAA,EAAQ,cAAA,CAAe,MAAA,GACvB,SAAA,GACE,IAAA,EAAM,UAAA,CAAW,MAAA,EAAQ,OAAA,kBACtB,UAAA,CAAW,MAAA,EAAQ,OAAA;EAvFH;;;;;EAkGvB,MAAA,CAAO,MAAA,EAAQ,cAAA;EA9FI;;;;;EAwGnB,GAAA,CAAI,MAAA,EAAQ,cAAA;EAtGQ;;;;;;;;;;EAoHpB,oBAAA,WAA+B,gBAAA,CAAA,CAC7B,MAAA,EAAQ,CAAA,GACP,2BAAA,CAA4B,CAAA;EAlHX;AAItB;;;;;;;;;;;;;EA4IE,yBAAA,WAAoC,gBAAA,CAAA,CAClC,MAAA,EAAQ,CAAA,EACR,OAAA;IAjIsB;;;IAqIpB,iBAAA;IAjJM;;;IAqJN,iCAAA;IAlJH;;;IAsJG,SAAA;EAAA,IAED,gBAAA;AAAA;AAAA,cA+DQ,kBAAA,EAAkB,kBAAA;AAAA,iBAEf,aAAA,kCAGE,cAAA,CAAe,MAAA,EAAA,CAE/B,MAAA,EAAQ,OAAA,EACR,IAAA,EAAM,UAAA,CAAW,MAAA,EAAQ,OAAA;EAAa,OAAA;AAAA,IACrC,OAAA;AAAA,iBACa,aAAA,kCAGE,cAAA,CAAe,MAAA,EAAA,CAE/B,MAAA,EAAQ,OAAA,EACR,IAAA,EAAM,UAAA,CAAW,MAAA,EAAQ,OAAA,IACxB,iBAAA,CAAkB,OAAA,EAAS,cAAA,CAAe,OAAA"}
+{"version":3,"file":"meta.d.ts","names":[],"sources":["../../../src/graph/zod/meta.ts"],"mappings":";;;;;cAiBa,8BAAA;;KAGD,iBAAA,WACA,cAAA,yBACa,cAAA,IACrB,CAAA;EACF,iBAAA,EAAmB,cAAA;AAAA;;KAIT,2BAAA,WACA,gBAAA,WACD,qBAAA,CAAsB,CAAA,qBAEjB,MAAA,GAAS,MAAA,CAAO,GAAA,UAAa,iBAAA,sCAIvC,MAAA,SAAe,cAAA,YACb,aAAA,SAAsB,cAAA,YACpB,WAAA,CAAY,CAAA,EAAG,cAAA,CAAe,CAAA,IAAK,CAAA,oBAGvC,MAAA,CAAO,GAAA,UAAa,cAAA,qBACpB,WAAA,CAAY,CAAA,EAAG,CAAA;AAAA,KAIT,UAAA,WACA,gBAAA,WACD,qBAAA,CAAsB,CAAA,qBAEjB,MAAA,IAAU,MAAA,CAAO,GAAA,UAAa,iBAAA,sCAIxC,MAAA,SAAe,cAAA,YACb,aAAA,SAAsB,cAAA,YACpB,cAAA,CAAe,CAAA,IAAK,CAAA,mBAGxB,MAAA,CAAO,GAAA,UAAa,cAAA,qBACpB,CAAA;AAAA,UAKW,UAAA,yBAAmC,MAAA;EAClD,eAAA;IACE,eAAA;IACA,cAAA;IAAA,CACC,GAAA;EAAA;EAEH,OAAA;IACE,MAAA,GAAS,cAAA,CAAe,OAAA;IACxB,EAAA,GAAK,CAAA,EAAG,MAAA,EAAQ,CAAA,EAAG,OAAA,KAAY,MAAA;EAAA;EAEjC,OAAA,SAAgB,MAAA;AAAA;;AA/ClB;;;cAsDa,kBAAA;EApDoB;;;;EAyD/B,IAAA,EAAI,GAAA,CAAA,cAAA,EAAA,UAAA;EAvDuC;;;;EA6D3C,eAAA,EAAe,GAAA,SAAA,GAAA,CAAA,cAAA,EAAA,cAAA;EAvDQ;;;;;;;EAgEvB,GAAA,mBAAsB,MAAA,CAAA,CACpB,MAAA,EAAQ,cAAA,CAAe,MAAA,IACtB,UAAA,CAAW,MAAA,EAAQ,OAAA;EA9DlB;;;;;;;EAyEJ,MAAA,iBAAA,CACE,MAAA,EAAQ,cAAA,CAAe,MAAA,GACvB,SAAA,GACE,IAAA,EAAM,UAAA,CAAW,MAAA,EAAQ,OAAA,kBACtB,UAAA,CAAW,MAAA,EAAQ,OAAA;EAvFzB;;;;;EAkGD,MAAA,CAAO,MAAA,EAAQ,cAAA;EAhGP;;;;;EA0GR,GAAA,CAAI,MAAA,EAAQ,cAAA;EAvGqC;;;;;;;;;;EAqHjD,oBAAA,WAA+B,gBAAA,CAAA,CAC7B,MAAA,EAAQ,CAAA,GACP,2BAAA,CAA4B,CAAA;EAlH3B;;;;;AAIN;;;;;;;;;EA4IE,yBAAA,WAAoC,gBAAA,CAAA,CAClC,MAAA,EAAQ,CAAA,EACR,OAAA;IAtIiB;;;IA0If,iBAAA;IAxIwB;;;IA4IxB,iCAAA;IAzIkC;;;IA6IlC,SAAA;EAAA,IAED,gBAAA;AAAA;AAAA,cA+DQ,kBAAA,EAAkB,kBAAA;AAAA,iBAEf,aAAA,kCAGE,cAAA,CAAe,MAAA,EAAA,CAE/B,MAAA,EAAQ,OAAA,EACR,IAAA,EAAM,UAAA,CAAW,MAAA,EAAQ,OAAA;EAAa,OAAA;AAAA,IACrC,OAAA;AAAA,iBACa,aAAA,kCAGE,cAAA,CAAe,MAAA,EAAA,CAE/B,MAAA,EAAQ,OAAA,EACR,IAAA,EAAM,UAAA,CAAW,MAAA,EAAQ,OAAA,IACxB,iBAAA,CAAkB,OAAA,EAAS,cAAA,CAAe,OAAA"}

package/dist/graph/zod/meta.js.map

@@ -1 +1 @@
-{"version":3,"file":"meta.js","names":[],"sources":["../../../src/graph/zod/meta.ts"],"sourcesContent":["import {\n  InferInteropZodOutput,\n  InteropZodObject,\n  InteropZodType,\n  getInteropZodObjectShape,\n  extendInteropZodObject,\n  getInteropZodDefaultGetter,\n  interopZodObjectPartial,\n  InteropZodObjectShape,\n  isZodSchemaV3,\n  getSchemaDescription,\n} from \"@langchain/core/utils/types\";\nimport { BaseChannel } from \"../../channels/base.js\";\nimport { BinaryOperatorAggregate } from \"../../channels/binop.js\";\nimport { LastValue } from \"../../channels/last_value.js\";\n\nexport const META_EXTRAS_DESCRIPTION_PREFIX = \"lg:\";\n\n/** @internal */\nexport type ReducedZodChannel<\n  T extends InteropZodType,\n  TReducerSchema extends InteropZodType\n> = T & {\n  lg_reducer_schema: TReducerSchema;\n};\n\n/** @internal */\nexport type InteropZodToStateDefinition<\n  T extends InteropZodObject,\n  TShape = InteropZodObjectShape<T>\n> = {\n  [key in keyof TShape]: TShape[key] extends ReducedZodChannel<\n    infer Schema,\n    infer ReducerSchema\n  >\n    ? Schema extends InteropZodType<infer V>\n      ? ReducerSchema extends InteropZodType<infer U>\n        ? BaseChannel<V, U>\n        : never\n      : never\n    : TShape[key] extends InteropZodType<infer V, infer U>\n    ? BaseChannel<V, U>\n    : never;\n};\n\nexport type UpdateType<\n  T extends InteropZodObject,\n  TShape = InteropZodObjectShape<T>\n> = {\n  [key in keyof TShape]?: TShape[key] extends ReducedZodChannel<\n    infer Schema,\n    infer ReducerSchema\n  >\n    ? Schema extends InteropZodType<unknown>\n      ? ReducerSchema extends InteropZodType<infer U>\n        ? U\n        : never\n      : never\n    : TShape[key] extends InteropZodType<unknown, infer U>\n    ? U\n    : never;\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport interface SchemaMeta<TValue = any, TUpdate = TValue> {\n  jsonSchemaExtra?: {\n    langgraph_nodes?: string[];\n    langgraph_type?: \"prompt\" | \"messages\";\n    [key: string]: unknown;\n  };\n  reducer?: {\n    schema?: InteropZodType<TUpdate>;\n    fn: (a: TValue, b: TUpdate) => TValue;\n  };\n  default?: () => TValue;\n}\n\n/**\n * A registry for storing and managing metadata associated with schemas.\n * This class provides methods to get, extend, remove, and check metadata for a given schema.\n */\nexport class SchemaMetaRegistry {\n  /**\n   * Internal map storing schema metadata.\n   * @internal\n   */\n  _map = new Map<InteropZodType, SchemaMeta>();\n\n  /**\n   * Cache for extended schemas.\n   * @internal\n   */\n  _extensionCache = new Map<string, Map<InteropZodType, InteropZodType>>();\n\n  /**\n   * Retrieves the metadata associated with a given schema.\n   * @template TValue The value type of the schema.\n   * @template TUpdate The update type of the schema (defaults to TValue).\n   * @param schema The schema to retrieve metadata for.\n   * @returns The associated SchemaMeta, or undefined if not present.\n   */\n  get<TValue, TUpdate = TValue>(\n    schema: InteropZodType<TValue>\n  ): SchemaMeta<TValue, TUpdate> | undefined {\n    return this._map.get(schema);\n  }\n\n  /**\n   * Extends or sets the metadata for a given schema.\n   * @template TValue The value type of the schema.\n   * @template TUpdate The update type of the schema (defaults to TValue).\n   * @param schema The schema to extend metadata for.\n   * @param predicate A function that receives the existing metadata (or undefined) and returns the new metadata.\n   */\n  extend<TValue, TUpdate>(\n    schema: InteropZodType<TValue>,\n    predicate: (\n      meta: SchemaMeta<TValue, TUpdate> | undefined\n    ) => SchemaMeta<TValue, TUpdate>\n  ) {\n    const existingMeta = this.get<TValue, TUpdate>(schema);\n    this._map.set(schema, predicate(existingMeta));\n  }\n\n  /**\n   * Removes the metadata associated with a given schema.\n   * @param schema The schema to remove metadata for.\n   * @returns The SchemaMetaRegistry instance (for chaining).\n   */\n  remove(schema: InteropZodType): this {\n    this._map.delete(schema);\n    return this;\n  }\n\n  /**\n   * Checks if metadata exists for a given schema.\n   * @param schema The schema to check.\n   * @returns True if metadata exists, false otherwise.\n   */\n  has(schema: InteropZodType): boolean {\n    return this._map.has(schema);\n  }\n\n  /**\n   * Returns a mapping of channel instances for each property in the schema\n   * using the associated metadata in the registry.\n   *\n   * This is used to create the `channels` object that's passed to the `Graph` constructor.\n   *\n   * @template T The shape of the schema.\n   * @param schema The schema to extract channels from.\n   * @returns A mapping from property names to channel instances.\n   */\n  getChannelsForSchema<T extends InteropZodObject>(\n    schema: T\n  ): InteropZodToStateDefinition<T> {\n    const channels = {} as Record<string, BaseChannel>;\n    const shape = getInteropZodObjectShape(schema);\n    for (const [key, channelSchema] of Object.entries(shape)) {\n      const meta = this.get(channelSchema);\n      if (meta?.reducer) {\n        channels[key] = new BinaryOperatorAggregate<\n          InferInteropZodOutput<typeof channelSchema>\n        >(meta.reducer.fn, meta.default);\n      } else {\n        channels[key] = new LastValue(meta?.default);\n      }\n    }\n    return channels as InteropZodToStateDefinition<T>;\n  }\n\n  /**\n   * Returns a modified schema that introspectively looks at all keys of the provided\n   * object schema, and applies the augmentations based on meta provided with those keys\n   * in the registry and the selectors provided in the `effects` parameter.\n   *\n   * This assumes that the passed in schema is the \"root\" schema object for a graph where\n   * the keys of the schema are the channels of the graph. Because we need to represent\n   * the input of a graph in a couple of different ways, the `effects` parameter allows\n   * us to apply those augmentations based on pre determined conditions.\n   *\n   * @param schema The root schema object to extend.\n   * @param effects The effects that are being applied.\n   * @returns The extended schema.\n   */\n  getExtendedChannelSchemas<T extends InteropZodObject>(\n    schema: T,\n    effects: {\n      /**\n       * Augments the shape by using the reducer's schema if it exists\n       */\n      withReducerSchema?: boolean;\n      /**\n       * Applies the stringified jsonSchemaExtra as a description to the schema.\n       */\n      withJsonSchemaExtrasAsDescription?: boolean;\n      /**\n       * Applies the `.partial()` modifier to the schema.\n       */\n      asPartial?: boolean;\n    }\n  ): InteropZodObject {\n    // If no effects are being applied, return the schema unchanged\n    if (Object.keys(effects).length === 0) {\n      return schema;\n    }\n\n    // Cache key is determined by looking at the effects that are being applied\n    const cacheKey = Object.entries(effects)\n      .filter(([, v]) => v === true)\n      .sort(([a], [b]) => a.localeCompare(b))\n      .map(([k, v]) => `${k}:${v}`)\n      .join(\"|\");\n\n    const cache = this._extensionCache.get(cacheKey) ?? new Map();\n    if (cache.has(schema)) return cache.get(schema)! as T;\n\n    let modifiedSchema: InteropZodObject = schema;\n\n    if (\n      effects.withReducerSchema ||\n      effects.withJsonSchemaExtrasAsDescription\n    ) {\n      const newShapeEntries = Object.entries(\n        getInteropZodObjectShape(schema)\n      ).map(([key, schema]) => {\n        const meta = this.get(schema);\n        let outputSchema = effects.withReducerSchema\n          ? meta?.reducer?.schema ?? schema\n          : schema;\n        if (\n          effects.withJsonSchemaExtrasAsDescription &&\n          meta?.jsonSchemaExtra\n        ) {\n          const description =\n            getSchemaDescription(outputSchema) ?? getSchemaDescription(schema);\n          const strExtras = JSON.stringify({\n            ...meta.jsonSchemaExtra,\n            description,\n          });\n          outputSchema = outputSchema.describe(\n            `${META_EXTRAS_DESCRIPTION_PREFIX}${strExtras}`\n          );\n        }\n        return [key, outputSchema];\n      });\n      modifiedSchema = extendInteropZodObject(\n        schema,\n        Object.fromEntries(newShapeEntries)\n      );\n      if (isZodSchemaV3(modifiedSchema)) {\n        modifiedSchema._def.unknownKeys = \"strip\";\n      }\n    }\n    if (effects.asPartial) {\n      modifiedSchema = interopZodObjectPartial(modifiedSchema);\n    }\n\n    cache.set(schema, modifiedSchema);\n    this._extensionCache.set(cacheKey, cache);\n    return modifiedSchema;\n  }\n}\n\nexport const schemaMetaRegistry = new SchemaMetaRegistry();\n\nexport function withLangGraph<\n  TValue,\n  TUpdate,\n  TSchema extends InteropZodType<TValue>\n>(\n  schema: TSchema,\n  meta: SchemaMeta<TValue, TUpdate> & { reducer?: undefined }\n): TSchema;\nexport function withLangGraph<\n  TValue,\n  TUpdate,\n  TSchema extends InteropZodType<TValue>\n>(\n  schema: TSchema,\n  meta: SchemaMeta<TValue, TUpdate>\n): ReducedZodChannel<TSchema, InteropZodType<TUpdate>>;\nexport function withLangGraph<\n  TValue,\n  TUpdate,\n  TSchema extends InteropZodType<TValue>\n>(\n  schema: TSchema,\n  meta: SchemaMeta<TValue, TUpdate>\n): ReducedZodChannel<TSchema, InteropZodType<TUpdate>> | TSchema {\n  if (meta.reducer && !meta.default) {\n    const defaultValueGetter = getInteropZodDefaultGetter(schema);\n    if (defaultValueGetter != null) {\n      // eslint-disable-next-line no-param-reassign\n      meta.default = defaultValueGetter;\n    }\n  }\n  if (meta.reducer) {\n    const schemaWithReducer = Object.assign(schema, {\n      lg_reducer_schema: meta.reducer?.schema ?? schema,\n    });\n    schemaMetaRegistry.extend(schemaWithReducer, () => meta);\n    return schemaWithReducer;\n  } else {\n    schemaMetaRegistry.extend(schema, () => meta);\n    return schema;\n  }\n}\n"],"mappings":";;;;;AAgBA,MAAa,iCAAiC;;;;;AAiE9C,IAAa,qBAAb,MAAgC;;;;;CAK9B,uBAAO,IAAI,KAAiC;;;;;CAM5C,kCAAkB,IAAI,KAAkD;;;;;;;;CASxE,IACE,QACyC;AACzC,SAAO,KAAK,KAAK,IAAI,OAAO;;;;;;;;;CAU9B,OACE,QACA,WAGA;EACA,MAAM,eAAe,KAAK,IAAqB,OAAO;AACtD,OAAK,KAAK,IAAI,QAAQ,UAAU,aAAa,CAAC;;;;;;;CAQhD,OAAO,QAA8B;AACnC,OAAK,KAAK,OAAO,OAAO;AACxB,SAAO;;;;;;;CAQT,IAAI,QAAiC;AACnC,SAAO,KAAK,KAAK,IAAI,OAAO;;;;;;;;;;;;CAa9B,qBACE,QACgC;EAChC,MAAM,WAAW,EAAE;EACnB,MAAM,QAAQ,yBAAyB,OAAO;AAC9C,OAAK,MAAM,CAAC,KAAK,kBAAkB,OAAO,QAAQ,MAAM,EAAE;GACxD,MAAM,OAAO,KAAK,IAAI,cAAc;AACpC,OAAI,MAAM,QACR,UAAS,OAAO,IAAI,wBAElB,KAAK,QAAQ,IAAI,KAAK,QAAQ;OAEhC,UAAS,OAAO,IAAI,UAAU,MAAM,QAAQ;;AAGhD,SAAO;;;;;;;;;;;;;;;;CAiBT,0BACE,QACA,SAckB;AAElB,MAAI,OAAO,KAAK,QAAQ,CAAC,WAAW,EAClC,QAAO;EAIT,MAAM,WAAW,OAAO,QAAQ,QAAQ,CACrC,QAAQ,GAAG,OAAO,MAAM,KAAK,CAC7B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC,CACtC,KAAK,CAAC,GAAG,OAAO,GAAG,EAAE,GAAG,IAAI,CAC5B,KAAK,IAAI;EAEZ,MAAM,QAAQ,KAAK,gBAAgB,IAAI,SAAS,oBAAI,IAAI,KAAK;AAC7D,MAAI,MAAM,IAAI,OAAO,CAAE,QAAO,MAAM,IAAI,OAAO;EAE/C,IAAI,iBAAmC;AAEvC,MACE,QAAQ,qBACR,QAAQ,mCACR;GACA,MAAM,kBAAkB,OAAO,QAC7B,yBAAyB,OAAO,CACjC,CAAC,KAAK,CAAC,KAAK,YAAY;IACvB,MAAM,OAAO,KAAK,IAAI,OAAO;IAC7B,IAAI,eAAe,QAAQ,oBACvB,MAAM,SAAS,UAAU,SACzB;AACJ,QACE,QAAQ,qCACR,MAAM,iBACN;KACA,MAAM,cACJ,qBAAqB,aAAa,IAAI,qBAAqB,OAAO;KACpE,MAAM,YAAY,KAAK,UAAU;MAC/B,GAAG,KAAK;MACR;MACD,CAAC;AACF,oBAAe,aAAa,SAC1B,GAAG,iCAAiC,YACrC;;AAEH,WAAO,CAAC,KAAK,aAAa;KAC1B;AACF,oBAAiB,uBACf,QACA,OAAO,YAAY,gBAAgB,CACpC;AACD,OAAI,cAAc,eAAe,CAC/B,gBAAe,KAAK,cAAc;;AAGtC,MAAI,QAAQ,UACV,kBAAiB,wBAAwB,eAAe;AAG1D,QAAM,IAAI,QAAQ,eAAe;AACjC,OAAK,gBAAgB,IAAI,UAAU,MAAM;AACzC,SAAO;;;AAIX,MAAa,qBAAqB,IAAI,oBAAoB;AAkB1D,SAAgB,cAKd,QACA,MAC+D;AAC/D,KAAI,KAAK,WAAW,CAAC,KAAK,SAAS;EACjC,MAAM,qBAAqB,2BAA2B,OAAO;AAC7D,MAAI,sBAAsB,KAExB,MAAK,UAAU;;AAGnB,KAAI,KAAK,SAAS;EAChB,MAAM,oBAAoB,OAAO,OAAO,QAAQ,EAC9C,mBAAmB,KAAK,SAAS,UAAU,QAC5C,CAAC;AACF,qBAAmB,OAAO,yBAAyB,KAAK;AACxD,SAAO;QACF;AACL,qBAAmB,OAAO,cAAc,KAAK;AAC7C,SAAO"}
+{"version":3,"file":"meta.js","names":[],"sources":["../../../src/graph/zod/meta.ts"],"sourcesContent":["import {\n  InferInteropZodOutput,\n  InteropZodObject,\n  InteropZodType,\n  getInteropZodObjectShape,\n  extendInteropZodObject,\n  getInteropZodDefaultGetter,\n  interopZodObjectPartial,\n  InteropZodObjectShape,\n  isZodSchemaV3,\n  getSchemaDescription,\n} from \"@langchain/core/utils/types\";\nimport { BaseChannel } from \"../../channels/base.js\";\nimport { BinaryOperatorAggregate } from \"../../channels/binop.js\";\nimport { LastValue } from \"../../channels/last_value.js\";\nimport type { OverwriteValue } from \"../../constants.js\";\n\nexport const META_EXTRAS_DESCRIPTION_PREFIX = \"lg:\";\n\n/** @internal */\nexport type ReducedZodChannel<\n  T extends InteropZodType,\n  TReducerSchema extends InteropZodType\n> = T & {\n  lg_reducer_schema: TReducerSchema;\n};\n\n/** @internal */\nexport type InteropZodToStateDefinition<\n  T extends InteropZodObject,\n  TShape = InteropZodObjectShape<T>\n> = {\n  [key in keyof TShape]: TShape[key] extends ReducedZodChannel<\n    infer Schema,\n    infer ReducerSchema\n  >\n    ? Schema extends InteropZodType<infer V>\n      ? ReducerSchema extends InteropZodType<infer U>\n        ? BaseChannel<V, OverwriteValue<V> | U>\n        : never\n      : never\n    : TShape[key] extends InteropZodType<infer V, infer U>\n    ? BaseChannel<V, U>\n    : never;\n};\n\nexport type UpdateType<\n  T extends InteropZodObject,\n  TShape = InteropZodObjectShape<T>\n> = {\n  [key in keyof TShape]?: TShape[key] extends ReducedZodChannel<\n    infer Schema,\n    infer ReducerSchema\n  >\n    ? Schema extends InteropZodType<infer V>\n      ? ReducerSchema extends InteropZodType<infer U>\n        ? OverwriteValue<V> | U\n        : never\n      : never\n    : TShape[key] extends InteropZodType<unknown, infer U>\n    ? U\n    : never;\n};\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport interface SchemaMeta<TValue = any, TUpdate = TValue> {\n  jsonSchemaExtra?: {\n    langgraph_nodes?: string[];\n    langgraph_type?: \"prompt\" | \"messages\";\n    [key: string]: unknown;\n  };\n  reducer?: {\n    schema?: InteropZodType<TUpdate>;\n    fn: (a: TValue, b: TUpdate) => TValue;\n  };\n  default?: () => TValue;\n}\n\n/**\n * A registry for storing and managing metadata associated with schemas.\n * This class provides methods to get, extend, remove, and check metadata for a given schema.\n */\nexport class SchemaMetaRegistry {\n  /**\n   * Internal map storing schema metadata.\n   * @internal\n   */\n  _map = new Map<InteropZodType, SchemaMeta>();\n\n  /**\n   * Cache for extended schemas.\n   * @internal\n   */\n  _extensionCache = new Map<string, Map<InteropZodType, InteropZodType>>();\n\n  /**\n   * Retrieves the metadata associated with a given schema.\n   * @template TValue The value type of the schema.\n   * @template TUpdate The update type of the schema (defaults to TValue).\n   * @param schema The schema to retrieve metadata for.\n   * @returns The associated SchemaMeta, or undefined if not present.\n   */\n  get<TValue, TUpdate = TValue>(\n    schema: InteropZodType<TValue>\n  ): SchemaMeta<TValue, TUpdate> | undefined {\n    return this._map.get(schema);\n  }\n\n  /**\n   * Extends or sets the metadata for a given schema.\n   * @template TValue The value type of the schema.\n   * @template TUpdate The update type of the schema (defaults to TValue).\n   * @param schema The schema to extend metadata for.\n   * @param predicate A function that receives the existing metadata (or undefined) and returns the new metadata.\n   */\n  extend<TValue, TUpdate>(\n    schema: InteropZodType<TValue>,\n    predicate: (\n      meta: SchemaMeta<TValue, TUpdate> | undefined\n    ) => SchemaMeta<TValue, TUpdate>\n  ) {\n    const existingMeta = this.get<TValue, TUpdate>(schema);\n    this._map.set(schema, predicate(existingMeta));\n  }\n\n  /**\n   * Removes the metadata associated with a given schema.\n   * @param schema The schema to remove metadata for.\n   * @returns The SchemaMetaRegistry instance (for chaining).\n   */\n  remove(schema: InteropZodType): this {\n    this._map.delete(schema);\n    return this;\n  }\n\n  /**\n   * Checks if metadata exists for a given schema.\n   * @param schema The schema to check.\n   * @returns True if metadata exists, false otherwise.\n   */\n  has(schema: InteropZodType): boolean {\n    return this._map.has(schema);\n  }\n\n  /**\n   * Returns a mapping of channel instances for each property in the schema\n   * using the associated metadata in the registry.\n   *\n   * This is used to create the `channels` object that's passed to the `Graph` constructor.\n   *\n   * @template T The shape of the schema.\n   * @param schema The schema to extract channels from.\n   * @returns A mapping from property names to channel instances.\n   */\n  getChannelsForSchema<T extends InteropZodObject>(\n    schema: T\n  ): InteropZodToStateDefinition<T> {\n    const channels = {} as Record<string, BaseChannel>;\n    const shape = getInteropZodObjectShape(schema);\n    for (const [key, channelSchema] of Object.entries(shape)) {\n      const meta = this.get(channelSchema);\n      if (meta?.reducer) {\n        channels[key] = new BinaryOperatorAggregate<\n          InferInteropZodOutput<typeof channelSchema>\n        >(meta.reducer.fn, meta.default);\n      } else {\n        channels[key] = new LastValue(meta?.default);\n      }\n    }\n    return channels as InteropZodToStateDefinition<T>;\n  }\n\n  /**\n   * Returns a modified schema that introspectively looks at all keys of the provided\n   * object schema, and applies the augmentations based on meta provided with those keys\n   * in the registry and the selectors provided in the `effects` parameter.\n   *\n   * This assumes that the passed in schema is the \"root\" schema object for a graph where\n   * the keys of the schema are the channels of the graph. Because we need to represent\n   * the input of a graph in a couple of different ways, the `effects` parameter allows\n   * us to apply those augmentations based on pre determined conditions.\n   *\n   * @param schema The root schema object to extend.\n   * @param effects The effects that are being applied.\n   * @returns The extended schema.\n   */\n  getExtendedChannelSchemas<T extends InteropZodObject>(\n    schema: T,\n    effects: {\n      /**\n       * Augments the shape by using the reducer's schema if it exists\n       */\n      withReducerSchema?: boolean;\n      /**\n       * Applies the stringified jsonSchemaExtra as a description to the schema.\n       */\n      withJsonSchemaExtrasAsDescription?: boolean;\n      /**\n       * Applies the `.partial()` modifier to the schema.\n       */\n      asPartial?: boolean;\n    }\n  ): InteropZodObject {\n    // If no effects are being applied, return the schema unchanged\n    if (Object.keys(effects).length === 0) {\n      return schema;\n    }\n\n    // Cache key is determined by looking at the effects that are being applied\n    const cacheKey = Object.entries(effects)\n      .filter(([, v]) => v === true)\n      .sort(([a], [b]) => a.localeCompare(b))\n      .map(([k, v]) => `${k}:${v}`)\n      .join(\"|\");\n\n    const cache = this._extensionCache.get(cacheKey) ?? new Map();\n    if (cache.has(schema)) return cache.get(schema)! as T;\n\n    let modifiedSchema: InteropZodObject = schema;\n\n    if (\n      effects.withReducerSchema ||\n      effects.withJsonSchemaExtrasAsDescription\n    ) {\n      const newShapeEntries = Object.entries(\n        getInteropZodObjectShape(schema)\n      ).map(([key, schema]) => {\n        const meta = this.get(schema);\n        let outputSchema = effects.withReducerSchema\n          ? meta?.reducer?.schema ?? schema\n          : schema;\n        if (\n          effects.withJsonSchemaExtrasAsDescription &&\n          meta?.jsonSchemaExtra\n        ) {\n          const description =\n            getSchemaDescription(outputSchema) ?? getSchemaDescription(schema);\n          const strExtras = JSON.stringify({\n            ...meta.jsonSchemaExtra,\n            description,\n          });\n          outputSchema = outputSchema.describe(\n            `${META_EXTRAS_DESCRIPTION_PREFIX}${strExtras}`\n          );\n        }\n        return [key, outputSchema];\n      });\n      modifiedSchema = extendInteropZodObject(\n        schema,\n        Object.fromEntries(newShapeEntries)\n      );\n      if (isZodSchemaV3(modifiedSchema)) {\n        modifiedSchema._def.unknownKeys = \"strip\";\n      }\n    }\n    if (effects.asPartial) {\n      modifiedSchema = interopZodObjectPartial(modifiedSchema);\n    }\n\n    cache.set(schema, modifiedSchema);\n    this._extensionCache.set(cacheKey, cache);\n    return modifiedSchema;\n  }\n}\n\nexport const schemaMetaRegistry = new SchemaMetaRegistry();\n\nexport function withLangGraph<\n  TValue,\n  TUpdate,\n  TSchema extends InteropZodType<TValue>\n>(\n  schema: TSchema,\n  meta: SchemaMeta<TValue, TUpdate> & { reducer?: undefined }\n): TSchema;\nexport function withLangGraph<\n  TValue,\n  TUpdate,\n  TSchema extends InteropZodType<TValue>\n>(\n  schema: TSchema,\n  meta: SchemaMeta<TValue, TUpdate>\n): ReducedZodChannel<TSchema, InteropZodType<TUpdate>>;\nexport function withLangGraph<\n  TValue,\n  TUpdate,\n  TSchema extends InteropZodType<TValue>\n>(\n  schema: TSchema,\n  meta: SchemaMeta<TValue, TUpdate>\n): ReducedZodChannel<TSchema, InteropZodType<TUpdate>> | TSchema {\n  if (meta.reducer && !meta.default) {\n    const defaultValueGetter = getInteropZodDefaultGetter(schema);\n    if (defaultValueGetter != null) {\n      // eslint-disable-next-line no-param-reassign\n      meta.default = defaultValueGetter;\n    }\n  }\n  if (meta.reducer) {\n    const schemaWithReducer = Object.assign(schema, {\n      lg_reducer_schema: meta.reducer?.schema ?? schema,\n    });\n    schemaMetaRegistry.extend(schemaWithReducer, () => meta);\n    return schemaWithReducer;\n  } else {\n    schemaMetaRegistry.extend(schema, () => meta);\n    return schema;\n  }\n}\n"],"mappings":";;;;;AAiBA,MAAa,iCAAiC;;;;;AAiE9C,IAAa,qBAAb,MAAgC;;;;;CAK9B,uBAAO,IAAI,KAAiC;;;;;CAM5C,kCAAkB,IAAI,KAAkD;;;;;;;;CASxE,IACE,QACyC;AACzC,SAAO,KAAK,KAAK,IAAI,OAAO;;;;;;;;;CAU9B,OACE,QACA,WAGA;EACA,MAAM,eAAe,KAAK,IAAqB,OAAO;AACtD,OAAK,KAAK,IAAI,QAAQ,UAAU,aAAa,CAAC;;;;;;;CAQhD,OAAO,QAA8B;AACnC,OAAK,KAAK,OAAO,OAAO;AACxB,SAAO;;;;;;;CAQT,IAAI,QAAiC;AACnC,SAAO,KAAK,KAAK,IAAI,OAAO;;;;;;;;;;;;CAa9B,qBACE,QACgC;EAChC,MAAM,WAAW,EAAE;EACnB,MAAM,QAAQ,yBAAyB,OAAO;AAC9C,OAAK,MAAM,CAAC,KAAK,kBAAkB,OAAO,QAAQ,MAAM,EAAE;GACxD,MAAM,OAAO,KAAK,IAAI,cAAc;AACpC,OAAI,MAAM,QACR,UAAS,OAAO,IAAI,wBAElB,KAAK,QAAQ,IAAI,KAAK,QAAQ;OAEhC,UAAS,OAAO,IAAI,UAAU,MAAM,QAAQ;;AAGhD,SAAO;;;;;;;;;;;;;;;;CAiBT,0BACE,QACA,SAckB;AAElB,MAAI,OAAO,KAAK,QAAQ,CAAC,WAAW,EAClC,QAAO;EAIT,MAAM,WAAW,OAAO,QAAQ,QAAQ,CACrC,QAAQ,GAAG,OAAO,MAAM,KAAK,CAC7B,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC,CACtC,KAAK,CAAC,GAAG,OAAO,GAAG,EAAE,GAAG,IAAI,CAC5B,KAAK,IAAI;EAEZ,MAAM,QAAQ,KAAK,gBAAgB,IAAI,SAAS,oBAAI,IAAI,KAAK;AAC7D,MAAI,MAAM,IAAI,OAAO,CAAE,QAAO,MAAM,IAAI,OAAO;EAE/C,IAAI,iBAAmC;AAEvC,MACE,QAAQ,qBACR,QAAQ,mCACR;GACA,MAAM,kBAAkB,OAAO,QAC7B,yBAAyB,OAAO,CACjC,CAAC,KAAK,CAAC,KAAK,YAAY;IACvB,MAAM,OAAO,KAAK,IAAI,OAAO;IAC7B,IAAI,eAAe,QAAQ,oBACvB,MAAM,SAAS,UAAU,SACzB;AACJ,QACE,QAAQ,qCACR,MAAM,iBACN;KACA,MAAM,cACJ,qBAAqB,aAAa,IAAI,qBAAqB,OAAO;KACpE,MAAM,YAAY,KAAK,UAAU;MAC/B,GAAG,KAAK;MACR;MACD,CAAC;AACF,oBAAe,aAAa,SAC1B,GAAG,iCAAiC,YACrC;;AAEH,WAAO,CAAC,KAAK,aAAa;KAC1B;AACF,oBAAiB,uBACf,QACA,OAAO,YAAY,gBAAgB,CACpC;AACD,OAAI,cAAc,eAAe,CAC/B,gBAAe,KAAK,cAAc;;AAGtC,MAAI,QAAQ,UACV,kBAAiB,wBAAwB,eAAe;AAG1D,QAAM,IAAI,QAAQ,eAAe;AACjC,OAAK,gBAAgB,IAAI,UAAU,MAAM;AACzC,SAAO;;;AAIX,MAAa,qBAAqB,IAAI,oBAAoB;AAkB1D,SAAgB,cAKd,QACA,MAC+D;AAC/D,KAAI,KAAK,WAAW,CAAC,KAAK,SAAS;EACjC,MAAM,qBAAqB,2BAA2B,OAAO;AAC7D,MAAI,sBAAsB,KAExB,MAAK,UAAU;;AAGnB,KAAI,KAAK,SAAS;EAChB,MAAM,oBAAoB,OAAO,OAAO,QAAQ,EAC9C,mBAAmB,KAAK,SAAS,UAAU,QAC5C,CAAC;AACF,qBAAmB,OAAO,yBAAyB,KAAK;AACxD,SAAO;QACF;AACL,qBAAmB,OAAO,cAAc,KAAK;AAC7C,SAAO"}

package/dist/index.cjs

@@ -1,10 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_async_local_storage = require('./setup/async_local_storage.cjs');
+const require_constants = require('./constants.cjs');
 const require_errors = require('./errors.cjs');
 const require_base = require('./channels/base.cjs');
 const require_binop = require('./channels/binop.cjs');
 const require_annotation = require('./graph/annotation.cjs');
-const require_constants = require('./constants.cjs');
 const require_config = require('./pregel/utils/config.cjs');
 const require_interrupt = require('./interrupt.cjs');
 const require_graph = require('./graph/graph.cjs');
@@ -50,7 +50,9 @@ Object.defineProperty(exports, 'BaseStore', {
   }
 });
 exports.BinaryOperatorAggregate = require_binop.BinaryOperatorAggregate;
+exports.COMMAND_SYMBOL = require_constants.COMMAND_SYMBOL;
 exports.Command = require_constants.Command;
+exports.CommandInstance = require_constants.CommandInstance;
 exports.CompiledStateGraph = require_state.CompiledStateGraph;
 exports.END = require_constants.END;
 exports.EmptyChannelError = require_errors.EmptyChannelError;
@@ -81,6 +83,7 @@ exports.MessagesZodMeta = require_messages_annotation.MessagesZodMeta;
 exports.MessagesZodState = require_messages_annotation.MessagesZodState;
 exports.MultipleSubgraphsError = require_errors.MultipleSubgraphsError;
 exports.NodeInterrupt = require_errors.NodeInterrupt;
+exports.Overwrite = require_constants.Overwrite;
 exports.ParentCommand = require_errors.ParentCommand;
 exports.REMOVE_ALL_MESSAGES = require_messages_reducer.REMOVE_ALL_MESSAGES;
 exports.ReducedValue = require_reduced.ReducedValue;

package/dist/index.d.cts

@@ -1,4 +1,5 @@
 import { BaseChannel } from "./channels/base.cjs";
+import { COMMAND_SYMBOL, Command, CommandInstance, CommandParams, END, INTERRUPT, Interrupt, Overwrite, OverwriteValue, START, Send, isCommand, isInterrupted } from "./constants.cjs";
 import { BinaryOperator, BinaryOperatorAggregate } from "./channels/binop.cjs";
 import { AnyValue } from "./channels/any_value.cjs";
 import { LastValue } from "./channels/last_value.cjs";
@@ -11,7 +12,6 @@ import { LangGraphRunnableConfig, Runtime } from "./pregel/runnable_types.cjs";
 import { Annotation, AnnotationRoot, NodeType, SingleReducer, StateDefinition, StateType, UpdateType } from "./graph/annotation.cjs";
 import { RetryPolicy } from "./pregel/utils/index.cjs";
 import { PregelNode } from "./pregel/read.cjs";
-import { Command, CommandParams, END, INTERRUPT, Interrupt, START, Send, isCommand, isInterrupted } from "./constants.cjs";
 import { GetStateOptions, MultipleChannelSubscriptionOptions, PregelOptions, PregelParams, SingleChannelSubscriptionOptions, StateSnapshot, StreamMode, StreamOutputMap } from "./pregel/types.cjs";
 import { Pregel } from "./pregel/index.cjs";
 import { CompiledGraph, Graph } from "./graph/graph.cjs";
@@ -32,4 +32,4 @@ import { getJsonSchemaFromSchema, getSchemaDefaultGetter } from "./state/adapter
 import { MessagesValue } from "./state/prebuilt/messages.cjs";
 import { AsyncBatchedStore, BaseCheckpointSaver, BaseStore, Checkpoint, CheckpointMetadata, CheckpointTuple, GetOperation, InMemoryStore, Item, ListNamespacesOperation, MatchCondition, MemorySaver, NameSpacePath, NamespaceMatchType, Operation, OperationResults, PutOperation, SearchOperation, copyCheckpoint, emptyCheckpoint } from "./web.cjs";
 import { getConfig, getCurrentTaskInput, getStore, getWriter } from "./pregel/utils/config.cjs";
-export { Annotation, AnnotationRoot, AnyValue, AsyncBatchedStore, BaseChannel, BaseCheckpointSaver, BaseLangGraphError, BaseLangGraphErrorFields, BaseStore, BinaryOperator, BinaryOperatorAggregate, Checkpoint, CheckpointMetadata, CheckpointTuple, Command, CommandParams, CompiledGraph, CompiledStateGraph, ConditionalEdgeRouter, ConditionalEdgeRouterTypes, ContextSchemaInit, DynamicBarrierValue, END, EmptyChannelError, EmptyInputError, EntrypointOptions, EphemeralValue, ExtractStateType, ExtractUpdateType, GetOperation, GetStateOptions, Graph, GraphBubbleUp, GraphInterrupt, GraphNode, GraphNodeReturnValue, GraphNodeTypes, GraphRecursionError, GraphValueError, INTERRUPT, InMemoryStore, InferStateSchemaUpdate, InferStateSchemaValue, Interrupt, InvalidUpdateError, Item, LangGraphRunnableConfig, LastValue, ListNamespacesOperation, MatchCondition, MemorySaver, MessageGraph, Messages, MessagesAnnotation, MessagesValue, MessagesZodMeta, MessagesZodState, MultipleChannelSubscriptionOptions, MultipleSubgraphsError, NameSpacePath, NamedBarrierValue, NamespaceMatchType, NodeInterrupt, NodeType, Operation, OperationResults, ParentCommand, Pregel, PregelNode, PregelOptions, PregelParams, PutOperation, REMOVE_ALL_MESSAGES, ReducedValue, ReducedValueInit, RemoteException, RetryPolicy, Runtime, START, SearchOperation, Send, SingleChannelSubscriptionOptions, SingleReducer, StateDefinition, StateDefinitionInit, StateGraph, StateGraphArgs, StateGraphInit, StateGraphInputError, StateGraphOptions, StateSchema, StateSchemaField, StateSchemaFields, StateSnapshot, StateType, StreamMode, StreamOutputMap, TaskOptions, Topic, UnreachableNodeError, UntrackedValue, UntrackedValueChannel, UntrackedValueInit, UpdateType, WaitForNames, messagesStateReducer as addMessages, copyCheckpoint, emptyCheckpoint, entrypoint, getConfig, getCurrentTaskInput, getJsonSchemaFromSchema, getPreviousState, getSchemaDefaultGetter, getStore, getSubgraphsSeenSet, getWriter, interrupt, isCommand, isGraphBubbleUp, isGraphInterrupt, isInterrupted, isParentCommand, isSerializableSchema, isStandardSchema, messagesStateReducer, pushMessage, task, writer };
+export { Annotation, AnnotationRoot, AnyValue, AsyncBatchedStore, BaseChannel, BaseCheckpointSaver, BaseLangGraphError, BaseLangGraphErrorFields, BaseStore, BinaryOperator, BinaryOperatorAggregate, COMMAND_SYMBOL, Checkpoint, CheckpointMetadata, CheckpointTuple, Command, CommandInstance, CommandParams, CompiledGraph, CompiledStateGraph, ConditionalEdgeRouter, ConditionalEdgeRouterTypes, ContextSchemaInit, DynamicBarrierValue, END, EmptyChannelError, EmptyInputError, EntrypointOptions, EphemeralValue, ExtractStateType, ExtractUpdateType, GetOperation, GetStateOptions, Graph, GraphBubbleUp, GraphInterrupt, GraphNode, GraphNodeReturnValue, GraphNodeTypes, GraphRecursionError, GraphValueError, INTERRUPT, InMemoryStore, InferStateSchemaUpdate, InferStateSchemaValue, Interrupt, InvalidUpdateError, Item, LangGraphRunnableConfig, LastValue, ListNamespacesOperation, MatchCondition, MemorySaver, MessageGraph, Messages, MessagesAnnotation, MessagesValue, MessagesZodMeta, MessagesZodState, MultipleChannelSubscriptionOptions, MultipleSubgraphsError, NameSpacePath, NamedBarrierValue, NamespaceMatchType, NodeInterrupt, NodeType, Operation, OperationResults, Overwrite, OverwriteValue, ParentCommand, Pregel, PregelNode, PregelOptions, PregelParams, PutOperation, REMOVE_ALL_MESSAGES, ReducedValue, ReducedValueInit, RemoteException, RetryPolicy, Runtime, START, SearchOperation, Send, SingleChannelSubscriptionOptions, SingleReducer, StateDefinition, StateDefinitionInit, StateGraph, StateGraphArgs, StateGraphInit, StateGraphInputError, StateGraphOptions, StateSchema, StateSchemaField, StateSchemaFields, StateSnapshot, StateType, StreamMode, StreamOutputMap, TaskOptions, Topic, UnreachableNodeError, UntrackedValue, UntrackedValueChannel, UntrackedValueInit, UpdateType, WaitForNames, messagesStateReducer as addMessages, copyCheckpoint, emptyCheckpoint, entrypoint, getConfig, getCurrentTaskInput, getJsonSchemaFromSchema, getPreviousState, getSchemaDefaultGetter, getStore, getSubgraphsSeenSet, getWriter, interrupt, isCommand, isGraphBubbleUp, isGraphInterrupt, isInterrupted, isParentCommand, isSerializableSchema, isStandardSchema, messagesStateReducer, pushMessage, task, writer };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { BaseChannel } from "./channels/base.js";
+import { COMMAND_SYMBOL, Command, CommandInstance, CommandParams, END, INTERRUPT, Interrupt, Overwrite, OverwriteValue, START, Send, isCommand, isInterrupted } from "./constants.js";
 import { BinaryOperator, BinaryOperatorAggregate } from "./channels/binop.js";
 import { AnyValue } from "./channels/any_value.js";
 import { LastValue } from "./channels/last_value.js";
@@ -11,7 +12,6 @@ import { LangGraphRunnableConfig, Runtime } from "./pregel/runnable_types.js";
 import { Annotation, AnnotationRoot, NodeType, SingleReducer, StateDefinition, StateType, UpdateType } from "./graph/annotation.js";
 import { RetryPolicy } from "./pregel/utils/index.js";
 import { PregelNode } from "./pregel/read.js";
-import { Command, CommandParams, END, INTERRUPT, Interrupt, START, Send, isCommand, isInterrupted } from "./constants.js";
 import { GetStateOptions, MultipleChannelSubscriptionOptions, PregelOptions, PregelParams, SingleChannelSubscriptionOptions, StateSnapshot, StreamMode, StreamOutputMap } from "./pregel/types.js";
 import { Pregel } from "./pregel/index.js";
 import { CompiledGraph, Graph } from "./graph/graph.js";
@@ -32,4 +32,4 @@ import { getJsonSchemaFromSchema, getSchemaDefaultGetter } from "./state/adapter
 import { MessagesValue } from "./state/prebuilt/messages.js";
 import { AsyncBatchedStore, BaseCheckpointSaver, BaseStore, Checkpoint, CheckpointMetadata, CheckpointTuple, GetOperation, InMemoryStore, Item, ListNamespacesOperation, MatchCondition, MemorySaver, NameSpacePath, NamespaceMatchType, Operation, OperationResults, PutOperation, SearchOperation, copyCheckpoint, emptyCheckpoint } from "./web.js";
 import { getConfig, getCurrentTaskInput, getStore, getWriter } from "./pregel/utils/config.js";
-export { Annotation, AnnotationRoot, AnyValue, AsyncBatchedStore, BaseChannel, BaseCheckpointSaver, BaseLangGraphError, BaseLangGraphErrorFields, BaseStore, BinaryOperator, BinaryOperatorAggregate, Checkpoint, CheckpointMetadata, CheckpointTuple, Command, CommandParams, CompiledGraph, CompiledStateGraph, ConditionalEdgeRouter, ConditionalEdgeRouterTypes, ContextSchemaInit, DynamicBarrierValue, END, EmptyChannelError, EmptyInputError, EntrypointOptions, EphemeralValue, ExtractStateType, ExtractUpdateType, GetOperation, GetStateOptions, Graph, GraphBubbleUp, GraphInterrupt, GraphNode, GraphNodeReturnValue, GraphNodeTypes, GraphRecursionError, GraphValueError, INTERRUPT, InMemoryStore, InferStateSchemaUpdate, InferStateSchemaValue, Interrupt, InvalidUpdateError, Item, LangGraphRunnableConfig, LastValue, ListNamespacesOperation, MatchCondition, MemorySaver, MessageGraph, Messages, MessagesAnnotation, MessagesValue, MessagesZodMeta, MessagesZodState, MultipleChannelSubscriptionOptions, MultipleSubgraphsError, NameSpacePath, NamedBarrierValue, NamespaceMatchType, NodeInterrupt, NodeType, Operation, OperationResults, ParentCommand, Pregel, PregelNode, PregelOptions, PregelParams, PutOperation, REMOVE_ALL_MESSAGES, ReducedValue, ReducedValueInit, RemoteException, RetryPolicy, Runtime, START, SearchOperation, Send, SingleChannelSubscriptionOptions, SingleReducer, StateDefinition, StateDefinitionInit, StateGraph, StateGraphArgs, StateGraphInit, StateGraphInputError, StateGraphOptions, StateSchema, StateSchemaField, StateSchemaFields, StateSnapshot, StateType, StreamMode, StreamOutputMap, TaskOptions, Topic, UnreachableNodeError, UntrackedValue, UntrackedValueChannel, UntrackedValueInit, UpdateType, WaitForNames, messagesStateReducer as addMessages, copyCheckpoint, emptyCheckpoint, entrypoint, getConfig, getCurrentTaskInput, getJsonSchemaFromSchema, getPreviousState, getSchemaDefaultGetter, getStore, getSubgraphsSeenSet, getWriter, interrupt, isCommand, isGraphBubbleUp, isGraphInterrupt, isInterrupted, isParentCommand, isSerializableSchema, isStandardSchema, messagesStateReducer, pushMessage, task, writer };
+export { Annotation, AnnotationRoot, AnyValue, AsyncBatchedStore, BaseChannel, BaseCheckpointSaver, BaseLangGraphError, BaseLangGraphErrorFields, BaseStore, BinaryOperator, BinaryOperatorAggregate, COMMAND_SYMBOL, Checkpoint, CheckpointMetadata, CheckpointTuple, Command, CommandInstance, CommandParams, CompiledGraph, CompiledStateGraph, ConditionalEdgeRouter, ConditionalEdgeRouterTypes, ContextSchemaInit, DynamicBarrierValue, END, EmptyChannelError, EmptyInputError, EntrypointOptions, EphemeralValue, ExtractStateType, ExtractUpdateType, GetOperation, GetStateOptions, Graph, GraphBubbleUp, GraphInterrupt, GraphNode, GraphNodeReturnValue, GraphNodeTypes, GraphRecursionError, GraphValueError, INTERRUPT, InMemoryStore, InferStateSchemaUpdate, InferStateSchemaValue, Interrupt, InvalidUpdateError, Item, LangGraphRunnableConfig, LastValue, ListNamespacesOperation, MatchCondition, MemorySaver, MessageGraph, Messages, MessagesAnnotation, MessagesValue, MessagesZodMeta, MessagesZodState, MultipleChannelSubscriptionOptions, MultipleSubgraphsError, NameSpacePath, NamedBarrierValue, NamespaceMatchType, NodeInterrupt, NodeType, Operation, OperationResults, Overwrite, OverwriteValue, ParentCommand, Pregel, PregelNode, PregelOptions, PregelParams, PutOperation, REMOVE_ALL_MESSAGES, ReducedValue, ReducedValueInit, RemoteException, RetryPolicy, Runtime, START, SearchOperation, Send, SingleChannelSubscriptionOptions, SingleReducer, StateDefinition, StateDefinitionInit, StateGraph, StateGraphArgs, StateGraphInit, StateGraphInputError, StateGraphOptions, StateSchema, StateSchemaField, StateSchemaFields, StateSnapshot, StateType, StreamMode, StreamOutputMap, TaskOptions, Topic, UnreachableNodeError, UntrackedValue, UntrackedValueChannel, UntrackedValueInit, UpdateType, WaitForNames, messagesStateReducer as addMessages, copyCheckpoint, emptyCheckpoint, entrypoint, getConfig, getCurrentTaskInput, getJsonSchemaFromSchema, getPreviousState, getSchemaDefaultGetter, getStore, getSubgraphsSeenSet, getWriter, interrupt, isCommand, isGraphBubbleUp, isGraphInterrupt, isInterrupted, isParentCommand, isSerializableSchema, isStandardSchema, messagesStateReducer, pushMessage, task, writer };

package/dist/index.js

@@ -1,9 +1,9 @@
 import { initializeAsyncLocalStorageSingleton } from "./setup/async_local_storage.js";
+import { COMMAND_SYMBOL, Command, CommandInstance, END, INTERRUPT, Overwrite, START, Send, isCommand, isInterrupted } from "./constants.js";
 import { BaseLangGraphError, EmptyChannelError, EmptyInputError, GraphBubbleUp, GraphInterrupt, GraphRecursionError, GraphValueError, InvalidUpdateError, MultipleSubgraphsError, NodeInterrupt, ParentCommand, RemoteException, StateGraphInputError, UnreachableNodeError, getSubgraphsSeenSet, isGraphBubbleUp, isGraphInterrupt, isParentCommand } from "./errors.js";
 import { BaseChannel } from "./channels/base.js";
 import { BinaryOperatorAggregate } from "./channels/binop.js";
 import { Annotation } from "./graph/annotation.js";
-import { Command, END, INTERRUPT, START, Send, isCommand, isInterrupted } from "./constants.js";
 import { getConfig, getCurrentTaskInput, getStore, getWriter } from "./pregel/utils/config.js";
 import { interrupt } from "./interrupt.js";
 import { Graph } from "./graph/graph.js";
@@ -26,5 +26,5 @@ import { writer } from "./writer.js";
 initializeAsyncLocalStorageSingleton();
 
 //#endregion
-export { Annotation, AsyncBatchedStore, BaseChannel, BaseCheckpointSaver, BaseLangGraphError, BaseStore, BinaryOperatorAggregate, Command, CompiledStateGraph, END, EmptyChannelError, EmptyInputError, Graph, GraphBubbleUp, GraphInterrupt, GraphRecursionError, GraphValueError, INTERRUPT, InMemoryStore, InvalidUpdateError, MemorySaver, MessageGraph, MessagesAnnotation, MessagesValue, MessagesZodMeta, MessagesZodState, MultipleSubgraphsError, NodeInterrupt, ParentCommand, REMOVE_ALL_MESSAGES, ReducedValue, RemoteException, START, Send, StateGraph, StateGraphInputError, StateSchema, UnreachableNodeError, UntrackedValue, UntrackedValueChannel, messagesStateReducer as addMessages, copyCheckpoint, emptyCheckpoint, entrypoint, getConfig, getCurrentTaskInput, getJsonSchemaFromSchema, getPreviousState, getSchemaDefaultGetter, getStore, getSubgraphsSeenSet, getWriter, interrupt, isCommand, isGraphBubbleUp, isGraphInterrupt, isInterrupted, isParentCommand, isSerializableSchema, isStandardSchema, messagesStateReducer, pushMessage, task, writer };
+export { Annotation, AsyncBatchedStore, BaseChannel, BaseCheckpointSaver, BaseLangGraphError, BaseStore, BinaryOperatorAggregate, COMMAND_SYMBOL, Command, CommandInstance, CompiledStateGraph, END, EmptyChannelError, EmptyInputError, Graph, GraphBubbleUp, GraphInterrupt, GraphRecursionError, GraphValueError, INTERRUPT, InMemoryStore, InvalidUpdateError, MemorySaver, MessageGraph, MessagesAnnotation, MessagesValue, MessagesZodMeta, MessagesZodState, MultipleSubgraphsError, NodeInterrupt, Overwrite, ParentCommand, REMOVE_ALL_MESSAGES, ReducedValue, RemoteException, START, Send, StateGraph, StateGraphInputError, StateSchema, UnreachableNodeError, UntrackedValue, UntrackedValueChannel, messagesStateReducer as addMessages, copyCheckpoint, emptyCheckpoint, entrypoint, getConfig, getCurrentTaskInput, getJsonSchemaFromSchema, getPreviousState, getSchemaDefaultGetter, getStore, getSubgraphsSeenSet, getWriter, interrupt, isCommand, isGraphBubbleUp, isGraphInterrupt, isInterrupted, isParentCommand, isSerializableSchema, isStandardSchema, messagesStateReducer, pushMessage, task, writer };
 //# sourceMappingURL=index.js.map

package/dist/interrupt.cjs

@@ -1,5 +1,5 @@
-const require_errors = require('./errors.cjs');
 const require_constants = require('./constants.cjs');
+const require_errors = require('./errors.cjs');
 const require_hash = require('./hash.cjs');
 let _langchain_core_singletons = require("@langchain/core/singletons");
 

package/dist/interrupt.js

@@ -1,5 +1,5 @@
-import { GraphInterrupt, GraphValueError } from "./errors.js";
 import { CHECKPOINT_NAMESPACE_SEPARATOR, CONFIG_KEY_CHECKPOINTER, CONFIG_KEY_CHECKPOINT_NS, CONFIG_KEY_SCRATCHPAD, CONFIG_KEY_SEND, RESUME } from "./constants.js";
+import { GraphInterrupt, GraphValueError } from "./errors.js";
 import { XXH3 } from "./hash.js";
 import { AsyncLocalStorageProviderSingleton } from "@langchain/core/singletons";
 

package/dist/prebuilt/react_agent_executor.cjs

@@ -1,5 +1,5 @@
-const require_annotation = require('../graph/annotation.cjs');
 const require_constants = require('../constants.cjs');
+const require_annotation = require('../graph/annotation.cjs');
 const require_messages_reducer = require('../graph/messages_reducer.cjs');
 const require_state = require('../graph/state.cjs');
 require('../graph/index.cjs');

package/dist/prebuilt/react_agent_executor.d.cts

@@ -1,9 +1,9 @@
-import { BinaryOperatorAggregate } from "../channels/binop.cjs";
+import { BaseChannel } from "../channels/base.cjs";
+import { OverwriteValue, START } from "../constants.cjs";
 import { LastValue } from "../channels/last_value.cjs";
 import { InteropZodToStateDefinition } from "../graph/zod/meta.cjs";
 import { LangGraphRunnableConfig, Runtime } from "../pregel/runnable_types.cjs";
 import { AnnotationRoot, SingleReducer, StateDefinition } from "../graph/annotation.cjs";
-import { START } from "../constants.cjs";
 import { CompiledStateGraph } from "../graph/state.cjs";
 import { Messages } from "../graph/messages_reducer.cjs";
 import { MessagesAnnotation } from "../graph/messages_annotation.cjs";
@@ -40,15 +40,15 @@ type StateModifier = Prompt;
 /** @deprecated Use Prompt instead. */
 type MessageModifier = SystemMessage | string | ((messages: BaseMessage[]) => BaseMessage[]) | ((messages: BaseMessage[]) => Promise<BaseMessage[]>) | Runnable;
 declare const createReactAgentAnnotation: <T extends Record<string, any> = Record<string, any>>() => AnnotationRoot<{
-  messages: BinaryOperatorAggregate<BaseMessage<_langchain_core_messages0.MessageStructure<_langchain_core_messages0.MessageToolSet>, _langchain_core_messages0.MessageType>[], Messages>;
+  messages: BaseChannel<BaseMessage<_langchain_core_messages0.MessageStructure<_langchain_core_messages0.MessageToolSet>, _langchain_core_messages0.MessageType>[], OverwriteValue<BaseMessage<_langchain_core_messages0.MessageStructure<_langchain_core_messages0.MessageToolSet>, _langchain_core_messages0.MessageType>[]> | Messages, unknown>;
   structuredResponse: {
+    (annotation: SingleReducer<T, T>): BaseChannel<T, T | OverwriteValue<T>, unknown>;
     (): LastValue<T>;
-    (annotation: SingleReducer<T, T>): BinaryOperatorAggregate<T, T>;
     Root: <S extends StateDefinition>(sd: S) => AnnotationRoot<S>;
   };
 }>;
 declare const PreHookAnnotation: AnnotationRoot<{
-  llmInputMessages: BinaryOperatorAggregate<BaseMessage<_langchain_core_messages0.MessageStructure<_langchain_core_messages0.MessageToolSet>, _langchain_core_messages0.MessageType>[], Messages>;
+  llmInputMessages: BaseChannel<BaseMessage<_langchain_core_messages0.MessageStructure<_langchain_core_messages0.MessageToolSet>, _langchain_core_messages0.MessageType>[], OverwriteValue<BaseMessage<_langchain_core_messages0.MessageStructure<_langchain_core_messages0.MessageToolSet>, _langchain_core_messages0.MessageType>[]> | Messages, unknown>;
 }>;
 type PreHookAnnotation = typeof PreHookAnnotation;
 type AnyAnnotationRoot = AnnotationRoot<any>;

package/dist/prebuilt/react_agent_executor.d.cts.map

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

package/dist/prebuilt/react_agent_executor.d.ts

@@ -1,9 +1,9 @@
-import { BinaryOperatorAggregate } from "../channels/binop.js";
+import { BaseChannel } from "../channels/base.js";
+import { OverwriteValue, START } from "../constants.js";
 import { LastValue } from "../channels/last_value.js";
 import { InteropZodToStateDefinition } from "../graph/zod/meta.js";
 import { LangGraphRunnableConfig, Runtime } from "../pregel/runnable_types.js";
 import { AnnotationRoot, SingleReducer, StateDefinition } from "../graph/annotation.js";
-import { START } from "../constants.js";
 import { CompiledStateGraph } from "../graph/state.js";
 import { Messages } from "../graph/messages_reducer.js";
 import "../graph/index.js";
@@ -42,15 +42,15 @@ type StateModifier = Prompt;
 /** @deprecated Use Prompt instead. */
 type MessageModifier = SystemMessage | string | ((messages: BaseMessage[]) => BaseMessage[]) | ((messages: BaseMessage[]) => Promise<BaseMessage[]>) | Runnable;
 declare const createReactAgentAnnotation: <T extends Record<string, any> = Record<string, any>>() => AnnotationRoot<{
-  messages: BinaryOperatorAggregate<BaseMessage<_langchain_core_messages0.MessageStructure<_langchain_core_messages0.MessageToolSet>, _langchain_core_messages0.MessageType>[], Messages>;
+  messages: BaseChannel<BaseMessage<_langchain_core_messages0.MessageStructure<_langchain_core_messages0.MessageToolSet>, _langchain_core_messages0.MessageType>[], OverwriteValue<BaseMessage<_langchain_core_messages0.MessageStructure<_langchain_core_messages0.MessageToolSet>, _langchain_core_messages0.MessageType>[]> | Messages, unknown>;
   structuredResponse: {
+    (annotation: SingleReducer<T, T>): BaseChannel<T, T | OverwriteValue<T>, unknown>;
     (): LastValue<T>;
-    (annotation: SingleReducer<T, T>): BinaryOperatorAggregate<T, T>;
     Root: <S extends StateDefinition>(sd: S) => AnnotationRoot<S>;
   };
 }>;
 declare const PreHookAnnotation: AnnotationRoot<{
-  llmInputMessages: BinaryOperatorAggregate<BaseMessage<_langchain_core_messages0.MessageStructure<_langchain_core_messages0.MessageToolSet>, _langchain_core_messages0.MessageType>[], Messages>;
+  llmInputMessages: BaseChannel<BaseMessage<_langchain_core_messages0.MessageStructure<_langchain_core_messages0.MessageToolSet>, _langchain_core_messages0.MessageType>[], OverwriteValue<BaseMessage<_langchain_core_messages0.MessageStructure<_langchain_core_messages0.MessageToolSet>, _langchain_core_messages0.MessageType>[]> | Messages, unknown>;
 }>;
 type PreHookAnnotation = typeof PreHookAnnotation;
 type AnyAnnotationRoot = AnnotationRoot<any>;

package/dist/prebuilt/react_agent_executor.d.ts.map

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

package/dist/prebuilt/react_agent_executor.js

@@ -1,5 +1,5 @@
-import { Annotation } from "../graph/annotation.js";
 import { END, START, Send } from "../constants.js";
+import { Annotation } from "../graph/annotation.js";
 import { messagesStateReducer } from "../graph/messages_reducer.js";
 import { StateGraph } from "../graph/state.js";
 import "../graph/index.js";

package/dist/prebuilt/tool_node.cjs

@@ -1,5 +1,5 @@
-const require_errors = require('../errors.cjs');
 const require_constants = require('../constants.cjs');
+const require_errors = require('../errors.cjs');
 const require_utils = require('../utils.cjs');
 let _langchain_core_messages = require("@langchain/core/messages");
 

package/dist/prebuilt/tool_node.d.cts

@@ -1,5 +1,5 @@
-import { RunnableCallable } from "../utils.cjs";
 import { Command, END } from "../constants.cjs";
+import { RunnableCallable } from "../utils.cjs";
 import { MessagesAnnotation } from "../graph/messages_annotation.cjs";
 import { RunnableConfig, RunnableToolLike } from "@langchain/core/runnables";
 import { BaseMessage, ToolMessage } from "@langchain/core/messages";

package/dist/prebuilt/tool_node.d.ts

@@ -1,5 +1,5 @@
-import { RunnableCallable } from "../utils.js";
 import { Command, END } from "../constants.js";
+import { RunnableCallable } from "../utils.js";
 import { MessagesAnnotation } from "../graph/messages_annotation.js";
 import { RunnableConfig, RunnableToolLike } from "@langchain/core/runnables";
 import { BaseMessage, ToolMessage } from "@langchain/core/messages";