@langchain/langgraph 0.4.9 → 1.0.0-alpha.1

package/dist/graph/message.js.map

@@ -1 +1 @@
-{"version":3,"file":"message.js","sourceRoot":"","sources":["../../src/graph/message.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"message.js","names":["removeAllIdx: number | undefined"],"sources":["../../src/graph/message.ts"],"sourcesContent":["import {\n  BaseMessage,\n  BaseMessageLike,\n  coerceMessageLikeToMessage,\n} from \"@langchain/core/messages\";\nimport { v4 } from \"uuid\";\nimport { StateGraph } from \"./state.js\";\nimport type { LangGraphRunnableConfig } from \"../pregel/runnable_types.js\";\nimport type { StreamMessagesHandler } from \"../pregel/messages.js\";\n\nexport const REMOVE_ALL_MESSAGES = \"__remove_all__\";\n\nexport type Messages =\n  | Array<BaseMessage | BaseMessageLike>\n  | BaseMessage\n  | BaseMessageLike;\n\n/**\n * Prebuilt reducer that combines returned messages.\n * Can handle standard messages and special modifiers like {@link RemoveMessage}\n * instances.\n */\nexport function messagesStateReducer(\n  left: Messages,\n  right: Messages\n): BaseMessage[] {\n  const leftArray = Array.isArray(left) ? left : [left];\n  const rightArray = Array.isArray(right) ? right : [right];\n  // coerce to message\n  const leftMessages = (leftArray as BaseMessageLike[]).map(\n    coerceMessageLikeToMessage\n  );\n  const rightMessages = (rightArray as BaseMessageLike[]).map(\n    coerceMessageLikeToMessage\n  );\n  // assign missing ids\n  for (const m of leftMessages) {\n    if (m.id === null || m.id === undefined) {\n      m.id = v4();\n      m.lc_kwargs.id = m.id;\n    }\n  }\n\n  let removeAllIdx: number | undefined;\n  for (let i = 0; i < rightMessages.length; i += 1) {\n    const m = rightMessages[i];\n    if (m.id === null || m.id === undefined) {\n      m.id = v4();\n      m.lc_kwargs.id = m.id;\n    }\n\n    if (m.getType() === \"remove\" && m.id === REMOVE_ALL_MESSAGES) {\n      removeAllIdx = i;\n    }\n  }\n\n  if (removeAllIdx != null) return rightMessages.slice(removeAllIdx + 1);\n\n  // merge\n  const merged = [...leftMessages];\n  const mergedById = new Map(merged.map((m, i) => [m.id, i]));\n  const idsToRemove = new Set();\n  for (const m of rightMessages) {\n    const existingIdx = mergedById.get(m.id);\n    if (existingIdx !== undefined) {\n      if (m.getType() === \"remove\") {\n        idsToRemove.add(m.id);\n      } else {\n        idsToRemove.delete(m.id);\n        merged[existingIdx] = m;\n      }\n    } else {\n      if (m.getType() === \"remove\") {\n        throw new Error(\n          `Attempting to delete a message with an ID that doesn't exist ('${m.id}')`\n        );\n      }\n      mergedById.set(m.id, merged.length);\n      merged.push(m);\n    }\n  }\n  return merged.filter((m) => !idsToRemove.has(m.id));\n}\n\n/** @ignore */\nexport class MessageGraph extends StateGraph<\n  BaseMessage[],\n  BaseMessage[],\n  Messages\n> {\n  constructor() {\n    super({\n      channels: {\n        __root__: {\n          reducer: messagesStateReducer,\n          default: () => [],\n        },\n      },\n    });\n  }\n}\n\nexport function pushMessage(\n  message: BaseMessage | BaseMessageLike,\n  config: LangGraphRunnableConfig,\n  options?: { stateKey?: string | null }\n) {\n  let stateKey: string | undefined = options?.stateKey ?? \"messages\";\n  if (options?.stateKey === null) {\n    stateKey = undefined;\n  }\n\n  // coerce to message\n  const validMessage = coerceMessageLikeToMessage(message);\n  if (!validMessage.id) throw new Error(\"Message ID is required.\");\n\n  const callbacks = (() => {\n    if (Array.isArray(config.callbacks)) {\n      return config.callbacks;\n    }\n\n    if (typeof config.callbacks !== \"undefined\") {\n      return config.callbacks.handlers;\n    }\n\n    return [];\n  })();\n\n  const messagesHandler = callbacks.find(\n    (cb): cb is StreamMessagesHandler =>\n      \"name\" in cb && cb.name === \"StreamMessagesHandler\"\n  );\n\n  if (messagesHandler) {\n    const metadata = config.metadata ?? {};\n    const namespace = (\n      (metadata.langgraph_checkpoint_ns ?? \"\") as string\n    ).split(\"|\");\n\n    messagesHandler._emit(\n      [namespace, metadata],\n      validMessage,\n      undefined,\n      false\n    );\n  }\n\n  if (stateKey) {\n    config.configurable?.__pregel_send?.([[stateKey, validMessage]]);\n  }\n\n  return validMessage;\n}\n"],"mappings":";;;;;AAUA,MAAa,sBAAsB;;;;;;AAYnC,SAAgB,qBACd,MACA,OACe;CACf,MAAM,YAAY,MAAM,QAAQ,QAAQ,OAAO,CAAC;CAChD,MAAM,aAAa,MAAM,QAAQ,SAAS,QAAQ,CAAC;CAEnD,MAAM,eAAgB,UAAgC,IACpD;CAEF,MAAM,gBAAiB,WAAiC,IACtD;AAGF,MAAK,MAAM,KAAK,aACd,KAAI,EAAE,OAAO,QAAQ,EAAE,OAAO,QAAW;AACvC,IAAE,KAAK;AACP,IAAE,UAAU,KAAK,EAAE;;CAIvB,IAAIA;AACJ,MAAK,IAAI,IAAI,GAAG,IAAI,cAAc,QAAQ,KAAK,GAAG;EAChD,MAAM,IAAI,cAAc;AACxB,MAAI,EAAE,OAAO,QAAQ,EAAE,OAAO,QAAW;AACvC,KAAE,KAAK;AACP,KAAE,UAAU,KAAK,EAAE;;AAGrB,MAAI,EAAE,cAAc,YAAY,EAAE,OAAO,oBACvC,gBAAe;;AAInB,KAAI,gBAAgB,KAAM,QAAO,cAAc,MAAM,eAAe;CAGpE,MAAM,SAAS,CAAC,GAAG;CACnB,MAAM,aAAa,IAAI,IAAI,OAAO,KAAK,GAAG,MAAM,CAAC,EAAE,IAAI;CACvD,MAAM,8BAAc,IAAI;AACxB,MAAK,MAAM,KAAK,eAAe;EAC7B,MAAM,cAAc,WAAW,IAAI,EAAE;AACrC,MAAI,gBAAgB,OAClB,KAAI,EAAE,cAAc,SAClB,aAAY,IAAI,EAAE;OACb;AACL,eAAY,OAAO,EAAE;AACrB,UAAO,eAAe;;OAEnB;AACL,OAAI,EAAE,cAAc,SAClB,OAAM,IAAI,MACR,kEAAkE,EAAE,GAAG;AAG3E,cAAW,IAAI,EAAE,IAAI,OAAO;AAC5B,UAAO,KAAK;;;AAGhB,QAAO,OAAO,QAAQ,MAAM,CAAC,YAAY,IAAI,EAAE;;;AAIjD,IAAa,eAAb,cAAkC,WAIhC;CACA,cAAc;AACZ,QAAM,EACJ,UAAU,EACR,UAAU;GACR,SAAS;GACT,eAAe"}

package/dist/graph/messages_annotation.cjs

@@ -1,110 +1,110 @@
-"use strict";
-/* __LC_ALLOW_ENTRYPOINT_SIDE_EFFECTS__ */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MessagesZodState = exports.MessagesZodMeta = exports.MessagesAnnotation = void 0;
-const v3_1 = require("zod/v3");
-const annotation_js_1 = require("./annotation.cjs");
-const message_js_1 = require("./message.cjs");
-const meta_js_1 = require("./zod/meta.cjs");
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_annotation = require('./annotation.cjs');
+const require_meta = require('./zod/meta.cjs');
+const require_message = require('./message.cjs');
+const zod_v3 = require_rolldown_runtime.__toESM(require("zod/v3"));
+
+//#region src/graph/messages_annotation.ts
 /**
- * Prebuilt state annotation that combines returned messages.
- * Can handle standard messages and special modifiers like {@link RemoveMessage}
- * instances.
- *
- * Specifically, importing and using the prebuilt MessagesAnnotation like this:
- *
- * @example
- * ```ts
- * import { MessagesAnnotation, StateGraph } from "@langchain/langgraph";
- *
- * const graph = new StateGraph(MessagesAnnotation)
- *   .addNode(...)
- *   ...
- * ```
- *
- * Is equivalent to initializing your state manually like this:
- *
- * @example
- * ```ts
- * import { BaseMessage } from "@langchain/core/messages";
- * import { Annotation, StateGraph, messagesStateReducer } from "@langchain/langgraph";
- *
- * export const StateAnnotation = Annotation.Root({
- *   messages: Annotation<BaseMessage[]>({
- *     reducer: messagesStateReducer,
- *     default: () => [],
- *   }),
- * });
- *
- * const graph = new StateGraph(StateAnnotation)
- *   .addNode(...)
- *   ...
- * ```
- */
-exports.MessagesAnnotation = annotation_js_1.Annotation.Root({
-    messages: (0, annotation_js_1.Annotation)({
-        reducer: message_js_1.messagesStateReducer,
-        default: () => [],
-    }),
-});
+* Prebuilt state annotation that combines returned messages.
+* Can handle standard messages and special modifiers like {@link RemoveMessage}
+* instances.
+*
+* Specifically, importing and using the prebuilt MessagesAnnotation like this:
+*
+* @example
+* ```ts
+* import { MessagesAnnotation, StateGraph } from "@langchain/langgraph";
+*
+* const graph = new StateGraph(MessagesAnnotation)
+*   .addNode(...)
+*   ...
+* ```
+*
+* Is equivalent to initializing your state manually like this:
+*
+* @example
+* ```ts
+* import { BaseMessage } from "@langchain/core/messages";
+* import { Annotation, StateGraph, messagesStateReducer } from "@langchain/langgraph";
+*
+* export const StateAnnotation = Annotation.Root({
+*   messages: Annotation<BaseMessage[]>({
+*     reducer: messagesStateReducer,
+*     default: () => [],
+*   }),
+* });
+*
+* const graph = new StateGraph(StateAnnotation)
+*   .addNode(...)
+*   ...
+* ```
+*/
+const MessagesAnnotation = require_annotation.Annotation.Root({ messages: require_annotation.Annotation({
+	reducer: require_message.messagesStateReducer,
+	default: () => []
+}) });
 /**
- * Prebuilt schema meta for Zod state definition.
- *
- * @example
- * ```ts
- * import { z } from "zod/v4-mini";
- * import { MessagesZodState, StateGraph } from "@langchain/langgraph";
- *
- * const AgentState = z.object({
- *   messages: z.custom<BaseMessage[]>().register(registry, MessagesZodMeta),
- * });
- * ```
- */
-exports.MessagesZodMeta = {
-    reducer: { fn: message_js_1.messagesStateReducer },
-    jsonSchemaExtra: { langgraph_type: "messages" },
-    default: () => [],
+* Prebuilt schema meta for Zod state definition.
+*
+* @example
+* ```ts
+* import { z } from "zod/v4-mini";
+* import { MessagesZodState, StateGraph } from "@langchain/langgraph";
+*
+* const AgentState = z.object({
+*   messages: z.custom<BaseMessage[]>().register(registry, MessagesZodMeta),
+* });
+* ```
+*/
+const MessagesZodMeta = {
+	reducer: { fn: require_message.messagesStateReducer },
+	jsonSchemaExtra: { langgraph_type: "messages" },
+	default: () => []
 };
 /**
- * Prebuilt state object that uses Zod to combine returned messages.
- * This utility is synonymous with the `MessagesAnnotation` annotation,
- * but uses Zod as the way to express messages state.
- *
- * You can use import and use this prebuilt schema like this:
- *
- * @example
- * ```ts
- * import { MessagesZodState, StateGraph } from "@langchain/langgraph";
- *
- * const graph = new StateGraph(MessagesZodState)
- *   .addNode(...)
- *   ...
- * ```
- *
- * Which is equivalent to initializing the schema object manually like this:
- *
- * @example
- * ```ts
- * import { z } from "zod";
- * import type { BaseMessage, BaseMessageLike } from "@langchain/core/messages";
- * import { StateGraph, messagesStateReducer } from "@langchain/langgraph";
- * import "@langchain/langgraph/zod";
- *
- * const AgentState = z.object({
- *   messages: z
- *     .custom<BaseMessage[]>()
- *     .default(() => [])
- *     .langgraph.reducer(
- *        messagesStateReducer,
- *        z.custom<BaseMessageLike | BaseMessageLike[]>()
- *     ),
- * });
- * const graph = new StateGraph(AgentState)
- *   .addNode(...)
- *   ...
- * ```
- */
-exports.MessagesZodState = v3_1.z.object({
-    messages: (0, meta_js_1.withLangGraph)(v3_1.z.custom(), exports.MessagesZodMeta),
-});
-//# sourceMappingURL=messages_annotation.js.map
+* Prebuilt state object that uses Zod to combine returned messages.
+* This utility is synonymous with the `MessagesAnnotation` annotation,
+* but uses Zod as the way to express messages state.
+*
+* You can use import and use this prebuilt schema like this:
+*
+* @example
+* ```ts
+* import { MessagesZodState, StateGraph } from "@langchain/langgraph";
+*
+* const graph = new StateGraph(MessagesZodState)
+*   .addNode(...)
+*   ...
+* ```
+*
+* Which is equivalent to initializing the schema object manually like this:
+*
+* @example
+* ```ts
+* import { z } from "zod";
+* import type { BaseMessage, BaseMessageLike } from "@langchain/core/messages";
+* import { StateGraph, messagesStateReducer } from "@langchain/langgraph";
+* import "@langchain/langgraph/zod";
+*
+* const AgentState = z.object({
+*   messages: z
+*     .custom<BaseMessage[]>()
+*     .default(() => [])
+*     .langgraph.reducer(
+*        messagesStateReducer,
+*        z.custom<BaseMessageLike | BaseMessageLike[]>()
+*     ),
+* });
+* const graph = new StateGraph(AgentState)
+*   .addNode(...)
+*   ...
+* ```
+*/
+const MessagesZodState = zod_v3.z.object({ messages: require_meta.withLangGraph(zod_v3.z.custom(), MessagesZodMeta) });
+
+//#endregion
+exports.MessagesAnnotation = MessagesAnnotation;
+exports.MessagesZodMeta = MessagesZodMeta;
+exports.MessagesZodState = MessagesZodState;
+//# sourceMappingURL=messages_annotation.cjs.map

package/dist/graph/messages_annotation.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages_annotation.cjs","names":["Annotation","messagesStateReducer","MessagesZodMeta: SchemaMeta<BaseMessage[], Messages>","z","withLangGraph"],"sources":["../../src/graph/messages_annotation.ts"],"sourcesContent":["/* __LC_ALLOW_ENTRYPOINT_SIDE_EFFECTS__ */\n\nimport { BaseMessage } from \"@langchain/core/messages\";\nimport { z } from \"zod/v3\";\nimport { Annotation } from \"./annotation.js\";\nimport { Messages, messagesStateReducer } from \"./message.js\";\nimport { SchemaMeta, withLangGraph } from \"./zod/meta.js\";\n\n/**\n * Prebuilt state annotation that combines returned messages.\n * Can handle standard messages and special modifiers like {@link RemoveMessage}\n * instances.\n *\n * Specifically, importing and using the prebuilt MessagesAnnotation like this:\n *\n * @example\n * ```ts\n * import { MessagesAnnotation, StateGraph } from \"@langchain/langgraph\";\n *\n * const graph = new StateGraph(MessagesAnnotation)\n *   .addNode(...)\n *   ...\n * ```\n *\n * Is equivalent to initializing your state manually like this:\n *\n * @example\n * ```ts\n * import { BaseMessage } from \"@langchain/core/messages\";\n * import { Annotation, StateGraph, messagesStateReducer } from \"@langchain/langgraph\";\n *\n * export const StateAnnotation = Annotation.Root({\n *   messages: Annotation<BaseMessage[]>({\n *     reducer: messagesStateReducer,\n *     default: () => [],\n *   }),\n * });\n *\n * const graph = new StateGraph(StateAnnotation)\n *   .addNode(...)\n *   ...\n * ```\n */\nexport const MessagesAnnotation = Annotation.Root({\n  messages: Annotation<BaseMessage[], Messages>({\n    reducer: messagesStateReducer,\n    default: () => [],\n  }),\n});\n\n/**\n * Prebuilt schema meta for Zod state definition.\n *\n * @example\n * ```ts\n * import { z } from \"zod/v4-mini\";\n * import { MessagesZodState, StateGraph } from \"@langchain/langgraph\";\n *\n * const AgentState = z.object({\n *   messages: z.custom<BaseMessage[]>().register(registry, MessagesZodMeta),\n * });\n * ```\n */\nexport const MessagesZodMeta: SchemaMeta<BaseMessage[], Messages> = {\n  reducer: { fn: messagesStateReducer },\n  jsonSchemaExtra: { langgraph_type: \"messages\" },\n  default: () => [],\n};\n\n/**\n * Prebuilt state object that uses Zod to combine returned messages.\n * This utility is synonymous with the `MessagesAnnotation` annotation,\n * but uses Zod as the way to express messages state.\n *\n * You can use import and use this prebuilt schema like this:\n *\n * @example\n * ```ts\n * import { MessagesZodState, StateGraph } from \"@langchain/langgraph\";\n *\n * const graph = new StateGraph(MessagesZodState)\n *   .addNode(...)\n *   ...\n * ```\n *\n * Which is equivalent to initializing the schema object manually like this:\n *\n * @example\n * ```ts\n * import { z } from \"zod\";\n * import type { BaseMessage, BaseMessageLike } from \"@langchain/core/messages\";\n * import { StateGraph, messagesStateReducer } from \"@langchain/langgraph\";\n * import \"@langchain/langgraph/zod\";\n *\n * const AgentState = z.object({\n *   messages: z\n *     .custom<BaseMessage[]>()\n *     .default(() => [])\n *     .langgraph.reducer(\n *        messagesStateReducer,\n *        z.custom<BaseMessageLike | BaseMessageLike[]>()\n *     ),\n * });\n * const graph = new StateGraph(AgentState)\n *   .addNode(...)\n *   ...\n * ```\n */\nexport const MessagesZodState = z.object({\n  messages: withLangGraph(z.custom<BaseMessage[]>(), MessagesZodMeta),\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CA,MAAa,qBAAqBA,8BAAW,KAAK,EAChD,UAAUA,8BAAoC;CAC5C,SAASC;CACT,eAAe;;;;;;;;;;;;;;;AAiBnB,MAAaC,kBAAuD;CAClE,SAAS,EAAE,IAAID;CACf,iBAAiB,EAAE,gBAAgB;CACnC,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CjB,MAAa,mBAAmBE,SAAE,OAAO,EACvC,UAAUC,2BAAcD,SAAE,UAAyB"}

package/dist/graph/messages_annotation.d.cts

@@ -0,0 +1,111 @@
+import { BinaryOperatorAggregate } from "../channels/binop.cjs";
+import { ReducedZodChannel, SchemaMeta } from "./zod/meta.cjs";
+import { AnnotationRoot } from "./annotation.cjs";
+import { Messages } from "./message.cjs";
+import * as _langchain_core_utils_types0 from "@langchain/core/utils/types";
+import { BaseMessage } from "@langchain/core/messages";
+import { z } from "zod/v3";
+
+//#region src/graph/messages_annotation.d.ts
+
+/**
+ * Prebuilt state annotation that combines returned messages.
+ * Can handle standard messages and special modifiers like {@link RemoveMessage}
+ * instances.
+ *
+ * Specifically, importing and using the prebuilt MessagesAnnotation like this:
+ *
+ * @example
+ * ```ts
+ * import { MessagesAnnotation, StateGraph } from "@langchain/langgraph";
+ *
+ * const graph = new StateGraph(MessagesAnnotation)
+ *   .addNode(...)
+ *   ...
+ * ```
+ *
+ * Is equivalent to initializing your state manually like this:
+ *
+ * @example
+ * ```ts
+ * import { BaseMessage } from "@langchain/core/messages";
+ * import { Annotation, StateGraph, messagesStateReducer } from "@langchain/langgraph";
+ *
+ * export const StateAnnotation = Annotation.Root({
+ *   messages: Annotation<BaseMessage[]>({
+ *     reducer: messagesStateReducer,
+ *     default: () => [],
+ *   }),
+ * });
+ *
+ * const graph = new StateGraph(StateAnnotation)
+ *   .addNode(...)
+ *   ...
+ * ```
+ */
+declare const MessagesAnnotation: AnnotationRoot<{
+  messages: BinaryOperatorAggregate<BaseMessage[], Messages>;
+}>;
+/**
+ * Prebuilt schema meta for Zod state definition.
+ *
+ * @example
+ * ```ts
+ * import { z } from "zod/v4-mini";
+ * import { MessagesZodState, StateGraph } from "@langchain/langgraph";
+ *
+ * const AgentState = z.object({
+ *   messages: z.custom<BaseMessage[]>().register(registry, MessagesZodMeta),
+ * });
+ * ```
+ */
+declare const MessagesZodMeta: SchemaMeta<BaseMessage[], Messages>;
+/**
+ * Prebuilt state object that uses Zod to combine returned messages.
+ * This utility is synonymous with the `MessagesAnnotation` annotation,
+ * but uses Zod as the way to express messages state.
+ *
+ * You can use import and use this prebuilt schema like this:
+ *
+ * @example
+ * ```ts
+ * import { MessagesZodState, StateGraph } from "@langchain/langgraph";
+ *
+ * const graph = new StateGraph(MessagesZodState)
+ *   .addNode(...)
+ *   ...
+ * ```
+ *
+ * Which is equivalent to initializing the schema object manually like this:
+ *
+ * @example
+ * ```ts
+ * import { z } from "zod";
+ * import type { BaseMessage, BaseMessageLike } from "@langchain/core/messages";
+ * import { StateGraph, messagesStateReducer } from "@langchain/langgraph";
+ * import "@langchain/langgraph/zod";
+ *
+ * const AgentState = z.object({
+ *   messages: z
+ *     .custom<BaseMessage[]>()
+ *     .default(() => [])
+ *     .langgraph.reducer(
+ *        messagesStateReducer,
+ *        z.custom<BaseMessageLike | BaseMessageLike[]>()
+ *     ),
+ * });
+ * const graph = new StateGraph(AgentState)
+ *   .addNode(...)
+ *   ...
+ * ```
+ */
+declare const MessagesZodState: z.ZodObject<{
+  messages: ReducedZodChannel<z.ZodType<BaseMessage[], z.ZodTypeDef, BaseMessage[]>, _langchain_core_utils_types0.InteropZodType<Messages>>;
+}, "strip", z.ZodTypeAny, {
+  messages: BaseMessage[];
+}, {
+  messages: BaseMessage[];
+}>;
+//#endregion
+export { MessagesAnnotation, MessagesZodMeta, MessagesZodState };
+//# sourceMappingURL=messages_annotation.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messages_annotation.d.cts","names":["__annotation_js0","_langchain_core_utils_types0","__zod_meta_js0","BaseMessage","z","Messages","SchemaMeta","MessagesAnnotation","___web_js7","BinaryOperatorAggregate","AnnotationRoot","MessagesZodMeta","MessagesZodState","ZodTypeDef","ZodType","InteropZodType","ReducedZodChannel","ZodTypeAny","ZodObject"],"sources":["../../src/graph/messages_annotation.d.ts"],"sourcesContent":["/* __LC_ALLOW_ENTRYPOINT_SIDE_EFFECTS__ */\nimport { BaseMessage } from \"@langchain/core/messages\";\nimport { z } from \"zod/v3\";\nimport { Messages } from \"./message.js\";\nimport { SchemaMeta } from \"./zod/meta.js\";\n/**\n * Prebuilt state annotation that combines returned messages.\n * Can handle standard messages and special modifiers like {@link RemoveMessage}\n * instances.\n *\n * Specifically, importing and using the prebuilt MessagesAnnotation like this:\n *\n * @example\n * ```ts\n * import { MessagesAnnotation, StateGraph } from \"@langchain/langgraph\";\n *\n * const graph = new StateGraph(MessagesAnnotation)\n *   .addNode(...)\n *   ...\n * ```\n *\n * Is equivalent to initializing your state manually like this:\n *\n * @example\n * ```ts\n * import { BaseMessage } from \"@langchain/core/messages\";\n * import { Annotation, StateGraph, messagesStateReducer } from \"@langchain/langgraph\";\n *\n * export const StateAnnotation = Annotation.Root({\n *   messages: Annotation<BaseMessage[]>({\n *     reducer: messagesStateReducer,\n *     default: () => [],\n *   }),\n * });\n *\n * const graph = new StateGraph(StateAnnotation)\n *   .addNode(...)\n *   ...\n * ```\n */\nexport declare const MessagesAnnotation: import(\"./annotation.js\").AnnotationRoot<{\n    messages: import(\"../web.js\").BinaryOperatorAggregate<BaseMessage[], Messages>;\n}>;\n/**\n * Prebuilt schema meta for Zod state definition.\n *\n * @example\n * ```ts\n * import { z } from \"zod/v4-mini\";\n * import { MessagesZodState, StateGraph } from \"@langchain/langgraph\";\n *\n * const AgentState = z.object({\n *   messages: z.custom<BaseMessage[]>().register(registry, MessagesZodMeta),\n * });\n * ```\n */\nexport declare const MessagesZodMeta: SchemaMeta<BaseMessage[], Messages>;\n/**\n * Prebuilt state object that uses Zod to combine returned messages.\n * This utility is synonymous with the `MessagesAnnotation` annotation,\n * but uses Zod as the way to express messages state.\n *\n * You can use import and use this prebuilt schema like this:\n *\n * @example\n * ```ts\n * import { MessagesZodState, StateGraph } from \"@langchain/langgraph\";\n *\n * const graph = new StateGraph(MessagesZodState)\n *   .addNode(...)\n *   ...\n * ```\n *\n * Which is equivalent to initializing the schema object manually like this:\n *\n * @example\n * ```ts\n * import { z } from \"zod\";\n * import type { BaseMessage, BaseMessageLike } from \"@langchain/core/messages\";\n * import { StateGraph, messagesStateReducer } from \"@langchain/langgraph\";\n * import \"@langchain/langgraph/zod\";\n *\n * const AgentState = z.object({\n *   messages: z\n *     .custom<BaseMessage[]>()\n *     .default(() => [])\n *     .langgraph.reducer(\n *        messagesStateReducer,\n *        z.custom<BaseMessageLike | BaseMessageLike[]>()\n *     ),\n * });\n * const graph = new StateGraph(AgentState)\n *   .addNode(...)\n *   ...\n * ```\n */\nexport declare const MessagesZodState: z.ZodObject<{\n    messages: import(\"./zod/meta.js\").ReducedZodChannel<z.ZodType<BaseMessage[], z.ZodTypeDef, BaseMessage[]>, import(\"@langchain/core/utils/types\").InteropZodType<Messages>>;\n}, \"strip\", z.ZodTypeAny, {\n    messages: BaseMessage[];\n}, {\n    messages: BaseMessage[];\n}>;\n"],"mappings":";;;;;;;;;;;;;;AAwCA;;;;;;;AAgBA;;;;;;AAwCA;;;;;;;;;;;;;;;;;;cAxDqBO;oCACqCJ,eAAeE;;;;;;;;;;;;;;;cAepDM,iBAAiBL,WAAWH,eAAeE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAwC3CO,kBAAkBR,CAAAA,CAAEc;8BACed,CAAAA,CAAEU,QAAQX,eAAeC,CAAAA,CAAES,YAAYV,gBAA6EF,4BAAAA,CAAvBc,eAAeV;YACxJD,CAAAA,CAAEa;YACAd;;YAEAA"}

package/dist/graph/messages_annotation.d.ts

@@ -1,7 +1,13 @@
+import { BinaryOperatorAggregate } from "../channels/binop.js";
+import { ReducedZodChannel, SchemaMeta } from "./zod/meta.js";
+import { AnnotationRoot } from "./annotation.js";
+import { Messages } from "./message.js";
 import { BaseMessage } from "@langchain/core/messages";
+import * as _langchain_core_utils_types0 from "@langchain/core/utils/types";
 import { z } from "zod/v3";
-import { Messages } from "./message.js";
-import { SchemaMeta } from "./zod/meta.js";
+
+//#region src/graph/messages_annotation.d.ts
+
 /**
  * Prebuilt state annotation that combines returned messages.
  * Can handle standard messages and special modifiers like {@link RemoveMessage}
@@ -37,8 +43,8 @@ import { SchemaMeta } from "./zod/meta.js";
  *   ...
  * ```
  */
-export declare const MessagesAnnotation: import("./annotation.js").AnnotationRoot<{
-    messages: import("../web.js").BinaryOperatorAggregate<BaseMessage[], Messages>;
+declare const MessagesAnnotation: AnnotationRoot<{
+  messages: BinaryOperatorAggregate<BaseMessage[], Messages>;
 }>;
 /**
  * Prebuilt schema meta for Zod state definition.
@@ -53,7 +59,7 @@ export declare const MessagesAnnotation: import("./annotation.js").AnnotationRoo
  * });
  * ```
  */
-export declare const MessagesZodMeta: SchemaMeta<BaseMessage[], Messages>;
+declare const MessagesZodMeta: SchemaMeta<BaseMessage[], Messages>;
 /**
  * Prebuilt state object that uses Zod to combine returned messages.
  * This utility is synonymous with the `MessagesAnnotation` annotation,
@@ -93,10 +99,13 @@ export declare const MessagesZodMeta: SchemaMeta<BaseMessage[], Messages>;
  *   ...
  * ```
  */
-export declare const MessagesZodState: z.ZodObject<{
-    messages: import("./zod/meta.js").ReducedZodChannel<z.ZodType<BaseMessage[], z.ZodTypeDef, BaseMessage[]>, import("@langchain/core/utils/types").InteropZodType<Messages>>;
+declare const MessagesZodState: z.ZodObject<{
+  messages: ReducedZodChannel<z.ZodType<BaseMessage[], z.ZodTypeDef, BaseMessage[]>, _langchain_core_utils_types0.InteropZodType<Messages>>;
 }, "strip", z.ZodTypeAny, {
-    messages: BaseMessage[];
+  messages: BaseMessage[];
 }, {
-    messages: BaseMessage[];
+  messages: BaseMessage[];
 }>;
+//#endregion
+export { MessagesAnnotation, MessagesZodMeta, MessagesZodState };
+//# sourceMappingURL=messages_annotation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messages_annotation.d.ts","names":["__annotation_js0","_langchain_core_utils_types0","__zod_meta_js0","BaseMessage","z","Messages","SchemaMeta","MessagesAnnotation","___web_js0","BinaryOperatorAggregate","AnnotationRoot","MessagesZodMeta","MessagesZodState","ZodTypeDef","ZodType","InteropZodType","ReducedZodChannel","ZodTypeAny","ZodObject"],"sources":["../../src/graph/messages_annotation.d.ts"],"sourcesContent":["/* __LC_ALLOW_ENTRYPOINT_SIDE_EFFECTS__ */\nimport { BaseMessage } from \"@langchain/core/messages\";\nimport { z } from \"zod/v3\";\nimport { Messages } from \"./message.js\";\nimport { SchemaMeta } from \"./zod/meta.js\";\n/**\n * Prebuilt state annotation that combines returned messages.\n * Can handle standard messages and special modifiers like {@link RemoveMessage}\n * instances.\n *\n * Specifically, importing and using the prebuilt MessagesAnnotation like this:\n *\n * @example\n * ```ts\n * import { MessagesAnnotation, StateGraph } from \"@langchain/langgraph\";\n *\n * const graph = new StateGraph(MessagesAnnotation)\n *   .addNode(...)\n *   ...\n * ```\n *\n * Is equivalent to initializing your state manually like this:\n *\n * @example\n * ```ts\n * import { BaseMessage } from \"@langchain/core/messages\";\n * import { Annotation, StateGraph, messagesStateReducer } from \"@langchain/langgraph\";\n *\n * export const StateAnnotation = Annotation.Root({\n *   messages: Annotation<BaseMessage[]>({\n *     reducer: messagesStateReducer,\n *     default: () => [],\n *   }),\n * });\n *\n * const graph = new StateGraph(StateAnnotation)\n *   .addNode(...)\n *   ...\n * ```\n */\nexport declare const MessagesAnnotation: import(\"./annotation.js\").AnnotationRoot<{\n    messages: import(\"../web.js\").BinaryOperatorAggregate<BaseMessage[], Messages>;\n}>;\n/**\n * Prebuilt schema meta for Zod state definition.\n *\n * @example\n * ```ts\n * import { z } from \"zod/v4-mini\";\n * import { MessagesZodState, StateGraph } from \"@langchain/langgraph\";\n *\n * const AgentState = z.object({\n *   messages: z.custom<BaseMessage[]>().register(registry, MessagesZodMeta),\n * });\n * ```\n */\nexport declare const MessagesZodMeta: SchemaMeta<BaseMessage[], Messages>;\n/**\n * Prebuilt state object that uses Zod to combine returned messages.\n * This utility is synonymous with the `MessagesAnnotation` annotation,\n * but uses Zod as the way to express messages state.\n *\n * You can use import and use this prebuilt schema like this:\n *\n * @example\n * ```ts\n * import { MessagesZodState, StateGraph } from \"@langchain/langgraph\";\n *\n * const graph = new StateGraph(MessagesZodState)\n *   .addNode(...)\n *   ...\n * ```\n *\n * Which is equivalent to initializing the schema object manually like this:\n *\n * @example\n * ```ts\n * import { z } from \"zod\";\n * import type { BaseMessage, BaseMessageLike } from \"@langchain/core/messages\";\n * import { StateGraph, messagesStateReducer } from \"@langchain/langgraph\";\n * import \"@langchain/langgraph/zod\";\n *\n * const AgentState = z.object({\n *   messages: z\n *     .custom<BaseMessage[]>()\n *     .default(() => [])\n *     .langgraph.reducer(\n *        messagesStateReducer,\n *        z.custom<BaseMessageLike | BaseMessageLike[]>()\n *     ),\n * });\n * const graph = new StateGraph(AgentState)\n *   .addNode(...)\n *   ...\n * ```\n */\nexport declare const MessagesZodState: z.ZodObject<{\n    messages: import(\"./zod/meta.js\").ReducedZodChannel<z.ZodType<BaseMessage[], z.ZodTypeDef, BaseMessage[]>, import(\"@langchain/core/utils/types\").InteropZodType<Messages>>;\n}, \"strip\", z.ZodTypeAny, {\n    messages: BaseMessage[];\n}, {\n    messages: BaseMessage[];\n}>;\n"],"mappings":";;;;;;;;;;;;;;AAwCA;;;;;;;AAgBA;;;;;;AAwCA;;;;;;;;;;;;;;;;;;cAxDqBO;oCACqCJ,eAAeE;;;;;;;;;;;;;;;cAepDM,iBAAiBL,WAAWH,eAAeE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAwC3CO,kBAAkBR,CAAAA,CAAEc;8BACed,CAAAA,CAAEU,QAAQX,eAAeC,CAAAA,CAAES,YAAYV,gBAA6EF,4BAAAA,CAAvBc,eAAeV;YACxJD,CAAAA,CAAEa;YACAd;;YAEAA"}