@langchain/langgraph 0.3.1 → 0.3.2

package/dist/graph/zod/schema.cjs

@@ -5,8 +5,8 @@ exports.getUpdateTypeSchema = getUpdateTypeSchema;
 exports.getInputTypeSchema = getInputTypeSchema;
 exports.getOutputTypeSchema = getOutputTypeSchema;
 exports.getConfigTypeSchema = getConfigTypeSchema;
-const zod_to_json_schema_1 = require("zod-to-json-schema");
-const state_js_1 = require("./state.cjs");
+const json_schema_1 = require("@langchain/core/utils/json_schema");
+const meta_js_1 = require("./meta.cjs");
 const PartialStateSchema = Symbol.for("langgraph.state.partial");
 function isGraphWithZodLike(graph) {
     if (!graph || typeof graph !== "object")
@@ -18,37 +18,59 @@ function isGraphWithZodLike(graph) {
     }
     return true;
 }
+function applyJsonSchemaExtrasFromDescription(schema) {
+    if (Array.isArray(schema)) {
+        return schema.map(applyJsonSchemaExtrasFromDescription);
+    }
+    if (typeof schema === "object" && schema != null) {
+        const output = Object.fromEntries(Object.entries(schema).map(([key, value]) => [
+            key,
+            applyJsonSchemaExtrasFromDescription(value),
+        ]));
+        if ("description" in output &&
+            typeof output.description === "string" &&
+            output.description.startsWith(meta_js_1.META_EXTRAS_DESCRIPTION_PREFIX)) {
+            const strMeta = output.description.slice(meta_js_1.META_EXTRAS_DESCRIPTION_PREFIX.length);
+            delete output.description;
+            Object.assign(output, JSON.parse(strMeta));
+        }
+        return output;
+    }
+    return schema;
+}
 function toJsonSchema(schema) {
-    return (0, state_js_1.applyExtraFromDescription)((0, zod_to_json_schema_1.zodToJsonSchema)(schema));
+    return applyJsonSchemaExtrasFromDescription((0, json_schema_1.toJsonSchema)(schema));
 }
 /**
  * Get the state schema for a graph.
  * @param graph - The graph to get the state schema for.
  * @returns The state schema for the graph.
  */
-function getStateTypeSchema(graph) {
+function getStateTypeSchema(graph, registry = meta_js_1.schemaMetaRegistry) {
     if (!isGraphWithZodLike(graph))
         return undefined;
     const schemaDef = graph.builder._schemaRuntimeDefinition;
     if (!schemaDef)
         return undefined;
-    return toJsonSchema((0, state_js_1.applyZodPlugin)(schemaDef, { jsonSchemaExtra: true }));
+    return toJsonSchema(registry.getExtendedChannelSchemas(schemaDef, {
+        withJsonSchemaExtrasAsDescription: true,
+    }));
 }
 /**
  * Get the update schema for a graph.
  * @param graph - The graph to get the update schema for.
  * @returns The update schema for the graph.
  */
-function getUpdateTypeSchema(graph) {
+function getUpdateTypeSchema(graph, registry = meta_js_1.schemaMetaRegistry) {
     if (!isGraphWithZodLike(graph))
         return undefined;
     const schemaDef = graph.builder._schemaRuntimeDefinition;
     if (!schemaDef)
         return undefined;
-    return toJsonSchema((0, state_js_1.applyZodPlugin)(schemaDef, {
-        reducer: true,
-        jsonSchemaExtra: true,
-        partial: true,
+    return toJsonSchema(registry.getExtendedChannelSchemas(schemaDef, {
+        withReducerSchema: true,
+        withJsonSchemaExtrasAsDescription: true,
+        asPartial: true,
     }));
 }
 /**
@@ -56,7 +78,7 @@ function getUpdateTypeSchema(graph) {
  * @param graph - The graph to get the input schema for.
  * @returns The input schema for the graph.
  */
-function getInputTypeSchema(graph) {
+function getInputTypeSchema(graph, registry = meta_js_1.schemaMetaRegistry) {
     if (!isGraphWithZodLike(graph))
         return undefined;
     let schemaDef = graph.builder._inputRuntimeDefinition;
@@ -66,10 +88,10 @@ function getInputTypeSchema(graph) {
     }
     if (!schemaDef)
         return undefined;
-    return toJsonSchema((0, state_js_1.applyZodPlugin)(schemaDef, {
-        reducer: true,
-        jsonSchemaExtra: true,
-        partial: true,
+    return toJsonSchema(registry.getExtendedChannelSchemas(schemaDef, {
+        withReducerSchema: true,
+        withJsonSchemaExtrasAsDescription: true,
+        asPartial: true,
     }));
 }
 /**
@@ -77,25 +99,29 @@ function getInputTypeSchema(graph) {
  * @param graph - The graph to get the output schema for.
  * @returns The output schema for the graph.
  */
-function getOutputTypeSchema(graph) {
+function getOutputTypeSchema(graph, registry = meta_js_1.schemaMetaRegistry) {
     if (!isGraphWithZodLike(graph))
         return undefined;
     const schemaDef = graph.builder._outputRuntimeDefinition;
     if (!schemaDef)
         return undefined;
-    return toJsonSchema((0, state_js_1.applyZodPlugin)(schemaDef, { jsonSchemaExtra: true }));
+    return toJsonSchema(registry.getExtendedChannelSchemas(schemaDef, {
+        withJsonSchemaExtrasAsDescription: true,
+    }));
 }
 /**
  * Get the config schema for a graph.
  * @param graph - The graph to get the config schema for.
  * @returns The config schema for the graph.
  */
-function getConfigTypeSchema(graph) {
+function getConfigTypeSchema(graph, registry = meta_js_1.schemaMetaRegistry) {
     if (!isGraphWithZodLike(graph))
         return undefined;
     const configDef = graph.builder._configRuntimeSchema;
     if (!configDef)
         return undefined;
-    return toJsonSchema((0, state_js_1.applyZodPlugin)(configDef, { jsonSchemaExtra: true }));
+    return toJsonSchema(registry.getExtendedChannelSchemas(configDef, {
+        withJsonSchemaExtrasAsDescription: true,
+    }));
 }
 //# sourceMappingURL=schema.js.map

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

@@ -1,33 +1,32 @@
-import { zodToJsonSchema as _zodToJsonSchema } from "zod-to-json-schema";
-type JsonSchema = ReturnType<typeof _zodToJsonSchema>;
+import { type JSONSchema } from "@langchain/core/utils/json_schema";
+import { SchemaMetaRegistry } from "./meta.js";
 /**
  * Get the state schema for a graph.
  * @param graph - The graph to get the state schema for.
  * @returns The state schema for the graph.
  */
-export declare function getStateTypeSchema(graph: unknown): JsonSchema | undefined;
+export declare function getStateTypeSchema(graph: unknown, registry?: SchemaMetaRegistry): JSONSchema | undefined;
 /**
  * Get the update schema for a graph.
  * @param graph - The graph to get the update schema for.
  * @returns The update schema for the graph.
  */
-export declare function getUpdateTypeSchema(graph: unknown): JsonSchema | undefined;
+export declare function getUpdateTypeSchema(graph: unknown, registry?: SchemaMetaRegistry): JSONSchema | undefined;
 /**
  * Get the input schema for a graph.
  * @param graph - The graph to get the input schema for.
  * @returns The input schema for the graph.
  */
-export declare function getInputTypeSchema(graph: unknown): JsonSchema | undefined;
+export declare function getInputTypeSchema(graph: unknown, registry?: SchemaMetaRegistry): JSONSchema | undefined;
 /**
  * Get the output schema for a graph.
  * @param graph - The graph to get the output schema for.
  * @returns The output schema for the graph.
  */
-export declare function getOutputTypeSchema(graph: unknown): JsonSchema | undefined;
+export declare function getOutputTypeSchema(graph: unknown, registry?: SchemaMetaRegistry): JSONSchema | undefined;
 /**
  * Get the config schema for a graph.
  * @param graph - The graph to get the config schema for.
  * @returns The config schema for the graph.
  */
-export declare function getConfigTypeSchema(graph: unknown): JsonSchema | undefined;
-export {};
+export declare function getConfigTypeSchema(graph: unknown, registry?: SchemaMetaRegistry): JSONSchema | undefined;

package/dist/graph/zod/schema.js

@@ -1,5 +1,5 @@
-import { zodToJsonSchema as _zodToJsonSchema } from "zod-to-json-schema";
-import { applyZodPlugin, applyExtraFromDescription } from "./state.js";
+import { toJsonSchema as interopToJsonSchema, } from "@langchain/core/utils/json_schema";
+import { META_EXTRAS_DESCRIPTION_PREFIX, schemaMetaRegistry, } from "./meta.js";
 const PartialStateSchema = Symbol.for("langgraph.state.partial");
 function isGraphWithZodLike(graph) {
     if (!graph || typeof graph !== "object")
@@ -11,37 +11,59 @@ function isGraphWithZodLike(graph) {
     }
     return true;
 }
+function applyJsonSchemaExtrasFromDescription(schema) {
+    if (Array.isArray(schema)) {
+        return schema.map(applyJsonSchemaExtrasFromDescription);
+    }
+    if (typeof schema === "object" && schema != null) {
+        const output = Object.fromEntries(Object.entries(schema).map(([key, value]) => [
+            key,
+            applyJsonSchemaExtrasFromDescription(value),
+        ]));
+        if ("description" in output &&
+            typeof output.description === "string" &&
+            output.description.startsWith(META_EXTRAS_DESCRIPTION_PREFIX)) {
+            const strMeta = output.description.slice(META_EXTRAS_DESCRIPTION_PREFIX.length);
+            delete output.description;
+            Object.assign(output, JSON.parse(strMeta));
+        }
+        return output;
+    }
+    return schema;
+}
 function toJsonSchema(schema) {
-    return applyExtraFromDescription(_zodToJsonSchema(schema));
+    return applyJsonSchemaExtrasFromDescription(interopToJsonSchema(schema));
 }
 /**
  * Get the state schema for a graph.
  * @param graph - The graph to get the state schema for.
  * @returns The state schema for the graph.
  */
-export function getStateTypeSchema(graph) {
+export function getStateTypeSchema(graph, registry = schemaMetaRegistry) {
     if (!isGraphWithZodLike(graph))
         return undefined;
     const schemaDef = graph.builder._schemaRuntimeDefinition;
     if (!schemaDef)
         return undefined;
-    return toJsonSchema(applyZodPlugin(schemaDef, { jsonSchemaExtra: true }));
+    return toJsonSchema(registry.getExtendedChannelSchemas(schemaDef, {
+        withJsonSchemaExtrasAsDescription: true,
+    }));
 }
 /**
  * Get the update schema for a graph.
  * @param graph - The graph to get the update schema for.
  * @returns The update schema for the graph.
  */
-export function getUpdateTypeSchema(graph) {
+export function getUpdateTypeSchema(graph, registry = schemaMetaRegistry) {
     if (!isGraphWithZodLike(graph))
         return undefined;
     const schemaDef = graph.builder._schemaRuntimeDefinition;
     if (!schemaDef)
         return undefined;
-    return toJsonSchema(applyZodPlugin(schemaDef, {
-        reducer: true,
-        jsonSchemaExtra: true,
-        partial: true,
+    return toJsonSchema(registry.getExtendedChannelSchemas(schemaDef, {
+        withReducerSchema: true,
+        withJsonSchemaExtrasAsDescription: true,
+        asPartial: true,
     }));
 }
 /**
@@ -49,7 +71,7 @@ export function getUpdateTypeSchema(graph) {
  * @param graph - The graph to get the input schema for.
  * @returns The input schema for the graph.
  */
-export function getInputTypeSchema(graph) {
+export function getInputTypeSchema(graph, registry = schemaMetaRegistry) {
     if (!isGraphWithZodLike(graph))
         return undefined;
     let schemaDef = graph.builder._inputRuntimeDefinition;
@@ -59,10 +81,10 @@ export function getInputTypeSchema(graph) {
     }
     if (!schemaDef)
         return undefined;
-    return toJsonSchema(applyZodPlugin(schemaDef, {
-        reducer: true,
-        jsonSchemaExtra: true,
-        partial: true,
+    return toJsonSchema(registry.getExtendedChannelSchemas(schemaDef, {
+        withReducerSchema: true,
+        withJsonSchemaExtrasAsDescription: true,
+        asPartial: true,
     }));
 }
 /**
@@ -70,25 +92,29 @@ export function getInputTypeSchema(graph) {
  * @param graph - The graph to get the output schema for.
  * @returns The output schema for the graph.
  */
-export function getOutputTypeSchema(graph) {
+export function getOutputTypeSchema(graph, registry = schemaMetaRegistry) {
     if (!isGraphWithZodLike(graph))
         return undefined;
     const schemaDef = graph.builder._outputRuntimeDefinition;
     if (!schemaDef)
         return undefined;
-    return toJsonSchema(applyZodPlugin(schemaDef, { jsonSchemaExtra: true }));
+    return toJsonSchema(registry.getExtendedChannelSchemas(schemaDef, {
+        withJsonSchemaExtrasAsDescription: true,
+    }));
 }
 /**
  * Get the config schema for a graph.
  * @param graph - The graph to get the config schema for.
  * @returns The config schema for the graph.
  */
-export function getConfigTypeSchema(graph) {
+export function getConfigTypeSchema(graph, registry = schemaMetaRegistry) {
     if (!isGraphWithZodLike(graph))
         return undefined;
     const configDef = graph.builder._configRuntimeSchema;
     if (!configDef)
         return undefined;
-    return toJsonSchema(applyZodPlugin(configDef, { jsonSchemaExtra: true }));
+    return toJsonSchema(registry.getExtendedChannelSchemas(configDef, {
+        withJsonSchemaExtrasAsDescription: true,
+    }));
 }
 //# sourceMappingURL=schema.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/graph/zod/schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/graph/zod/schema.ts"],"names":[],"mappings":"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"}

package/dist/graph/zod/zod-registry.cjs

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registry = exports.LanggraphZodMetaRegistry = void 0;
+const types_1 = require("@langchain/core/utils/types");
+const core_1 = require("zod/v4/core");
+const meta_js_1 = require("./meta.cjs");
+/**
+ * A Zod v4-compatible meta registry that extends the base registry.
+ *
+ * This registry allows you to associate and retrieve metadata for Zod schemas,
+ * leveraging the base registry for storage. It is compatible with Zod v4 and
+ * interoperates with the base registry to ensure consistent metadata management
+ * across different Zod versions.
+ *
+ * @template Meta - The type of metadata associated with each schema.
+ * @template Schema - The Zod schema type.
+ */
+class LanggraphZodMetaRegistry extends core_1.$ZodRegistry {
+    /**
+     * Creates a new LanggraphZodMetaRegistry instance.
+     *
+     * @param parent - The base SchemaMetaRegistry to use for metadata storage.
+     */
+    constructor(parent) {
+        super();
+        Object.defineProperty(this, "parent", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: parent
+        });
+        // Use the parent's map for metadata storage
+        this._map = this.parent._map;
+    }
+    add(schema, ..._meta) {
+        const firstMeta = _meta[0];
+        if (firstMeta && !firstMeta?.default) {
+            const defaultValueGetter = (0, types_1.getInteropZodDefaultGetter)(schema);
+            if (defaultValueGetter != null) {
+                // eslint-disable-next-line no-param-reassign
+                firstMeta.default = defaultValueGetter;
+            }
+        }
+        return super.add(schema, ..._meta);
+    }
+}
+exports.LanggraphZodMetaRegistry = LanggraphZodMetaRegistry;
+exports.registry = new LanggraphZodMetaRegistry(meta_js_1.schemaMetaRegistry);
+//# sourceMappingURL=zod-registry.js.map

package/dist/graph/zod/zod-registry.d.ts

@@ -0,0 +1,24 @@
+import { $ZodType, $ZodRegistry, $replace } from "zod/v4/core";
+import { SchemaMeta, SchemaMetaRegistry } from "./meta.js";
+/**
+ * A Zod v4-compatible meta registry that extends the base registry.
+ *
+ * This registry allows you to associate and retrieve metadata for Zod schemas,
+ * leveraging the base registry for storage. It is compatible with Zod v4 and
+ * interoperates with the base registry to ensure consistent metadata management
+ * across different Zod versions.
+ *
+ * @template Meta - The type of metadata associated with each schema.
+ * @template Schema - The Zod schema type.
+ */
+export declare class LanggraphZodMetaRegistry<Meta extends SchemaMeta = SchemaMeta, Schema extends $ZodType = $ZodType> extends $ZodRegistry<Meta, Schema> {
+    protected parent: SchemaMetaRegistry;
+    /**
+     * Creates a new LanggraphZodMetaRegistry instance.
+     *
+     * @param parent - The base SchemaMetaRegistry to use for metadata storage.
+     */
+    constructor(parent: SchemaMetaRegistry);
+    add<S extends Schema>(schema: S, ..._meta: undefined extends Meta ? [$replace<Meta, S>?] : [$replace<Meta, S>]): this;
+}
+export declare const registry: LanggraphZodMetaRegistry<SchemaMeta<any, any>, $ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>>;

package/dist/graph/zod/zod-registry.js

@@ -0,0 +1,45 @@
+import { getInteropZodDefaultGetter } from "@langchain/core/utils/types";
+import { $ZodRegistry } from "zod/v4/core";
+import { schemaMetaRegistry } from "./meta.js";
+/**
+ * A Zod v4-compatible meta registry that extends the base registry.
+ *
+ * This registry allows you to associate and retrieve metadata for Zod schemas,
+ * leveraging the base registry for storage. It is compatible with Zod v4 and
+ * interoperates with the base registry to ensure consistent metadata management
+ * across different Zod versions.
+ *
+ * @template Meta - The type of metadata associated with each schema.
+ * @template Schema - The Zod schema type.
+ */
+export class LanggraphZodMetaRegistry extends $ZodRegistry {
+    /**
+     * Creates a new LanggraphZodMetaRegistry instance.
+     *
+     * @param parent - The base SchemaMetaRegistry to use for metadata storage.
+     */
+    constructor(parent) {
+        super();
+        Object.defineProperty(this, "parent", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: parent
+        });
+        // Use the parent's map for metadata storage
+        this._map = this.parent._map;
+    }
+    add(schema, ..._meta) {
+        const firstMeta = _meta[0];
+        if (firstMeta && !firstMeta?.default) {
+            const defaultValueGetter = getInteropZodDefaultGetter(schema);
+            if (defaultValueGetter != null) {
+                // eslint-disable-next-line no-param-reassign
+                firstMeta.default = defaultValueGetter;
+            }
+        }
+        return super.add(schema, ..._meta);
+    }
+}
+export const registry = new LanggraphZodMetaRegistry(schemaMetaRegistry);
+//# sourceMappingURL=zod-registry.js.map

package/dist/graph/zod/zod-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod-registry.js","sourceRoot":"","sources":["../../../src/graph/zod/zod-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAY,YAAY,EAAY,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAkC,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/E;;;;;;;;;;GAUG;AACH,MAAM,OAAO,wBAGX,SAAQ,YAA0B;IAClC;;;;OAIG;IACH,YAAsB,MAA0B;QAC9C,KAAK,EAAE,CAAC;QADE;;;;mBAAU,MAAM;WAAoB;QAE9C,4CAA4C;QAC5C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAA+C,CAAC;IAC1E,CAAC;IAED,GAAG,CACD,MAAS,EACT,GAAG,KAEoB;QAEvB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,SAAS,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,CAAC;YACrC,MAAM,kBAAkB,GAAG,0BAA0B,CAAC,MAAM,CAAC,CAAC;YAC9D,IAAI,kBAAkB,IAAI,IAAI,EAAE,CAAC;gBAC/B,6CAA6C;gBAC7C,SAAS,CAAC,OAAO,GAAG,kBAAkB,CAAC;YACzC,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC;IACrC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,wBAAwB,CAAC,kBAAkB,CAAC,CAAC"}

package/dist/prebuilt/react_agent_executor.d.ts

@@ -3,8 +3,8 @@ import { LanguageModelLike } from "@langchain/core/language_models/base";
 import { BaseMessage, BaseMessageLike, SystemMessage } from "@langchain/core/messages";
 import { Runnable, RunnableToolLike, type RunnableLike } from "@langchain/core/runnables";
 import { DynamicTool, StructuredToolInterface } from "@langchain/core/tools";
+import { InteropZodType } from "@langchain/core/utils/types";
 import { All, BaseCheckpointSaver, BaseStore } from "@langchain/langgraph-checkpoint";
-import { z } from "zod";
 import { type CompiledStateGraph, AnnotationRoot } from "../graph/index.js";
 import { MessagesAnnotation } from "../graph/messages_annotation.js";
 import { ToolNode } from "./tool_node.js";
@@ -18,7 +18,7 @@ export interface AgentState<StructuredResponseType extends Record<string, any> =
 export type N = typeof START | "agent" | "tools";
 export type StructuredResponseSchemaAndPrompt<StructuredResponseType> = {
     prompt: string;
-    schema: z.ZodType<StructuredResponseType> | Record<string, any>;
+    schema: InteropZodType<StructuredResponseType> | Record<string, any>;
 };
 type ServerTool = Record<string, unknown>;
 type ClientTool = StructuredToolInterface | DynamicTool | RunnableToolLike;
@@ -101,7 +101,7 @@ export type CreateReactAgentParams<A extends AnnotationRoot<any> = AnnotationRoo
      * **Note**: The graph will make a separate call to the LLM to generate the structured response after the agent loop is finished.
      * This is not the only strategy to get structured responses, see more options in [this guide](https://langchain-ai.github.io/langgraph/how-tos/react-agent-structured-output/).
      */
-    responseFormat?: z.ZodType<StructuredResponseType> | StructuredResponseSchemaAndPrompt<StructuredResponseType> | Record<string, any>;
+    responseFormat?: InteropZodType<StructuredResponseType> | StructuredResponseSchemaAndPrompt<StructuredResponseType> | Record<string, any>;
     /**
      * An optional name for the agent.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@langchain/langgraph",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "LangGraph",
   "type": "module",
   "engines": {
@@ -35,10 +35,10 @@
     "@langchain/langgraph-checkpoint": "~0.0.18",
     "@langchain/langgraph-sdk": "~0.0.32",
     "uuid": "^10.0.0",
-    "zod": "^3.23.8"
+    "zod": "^3.25.32"
   },
   "peerDependencies": {
-    "@langchain/core": ">=0.2.36 <0.3.0 || >=0.3.40 < 0.4.0",
+    "@langchain/core": ">=0.3.58 < 0.4.0",
     "zod-to-json-schema": "^3.x"
   },
   "peerDependenciesMeta": {
@@ -49,9 +49,9 @@
   "devDependencies": {
     "@langchain/anthropic": "^0.3.12",
     "@langchain/community": "^0.3.27",
-    "@langchain/core": "^0.3.40",
-    "@langchain/langgraph-checkpoint-postgres": "0.0.5",
-    "@langchain/langgraph-checkpoint-sqlite": "0.1.5",
+    "@langchain/core": "^0.3.58",
+    "@langchain/langgraph-checkpoint-postgres": "workspace:*",
+    "@langchain/langgraph-checkpoint-sqlite": "workspace:*",
     "@langchain/openai": "^0.4.0",
     "@langchain/scripts": ">=0.1.3 <0.2.0",
     "@swc/core": "^1.3.90",
@@ -185,4 +185,4 @@
     "zod/schema.d.ts",
     "zod/schema.d.cts"
   ]
-}
+}

package/dist/graph/zod/state.cjs

@@ -1,135 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isZodDefault = isZodDefault;
-exports.isAnyZodObject = isAnyZodObject;
-exports.withLangGraph = withLangGraph;
-exports.getMeta = getMeta;
-exports.extendMeta = extendMeta;
-exports.getChannelsFromZod = getChannelsFromZod;
-exports.applyZodPlugin = applyZodPlugin;
-exports.applyExtraFromDescription = applyExtraFromDescription;
-const binop_js_1 = require("../../channels/binop.cjs");
-const last_value_js_1 = require("../../channels/last_value.cjs");
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-const META_MAP = new WeakMap();
-function isZodType(value) {
-    return (typeof value === "object" &&
-        value != null &&
-        "_parse" in value &&
-        typeof value._parse === "function");
-}
-/**
- * @internal
- */
-function isZodDefault(value) {
-    return (isZodType(value) &&
-        "removeDefault" in value &&
-        typeof value.removeDefault === "function");
-}
-/**
- * @internal
- */
-function isAnyZodObject(value) {
-    return (isZodType(value) &&
-        "partial" in value &&
-        typeof value.partial === "function");
-}
-function withLangGraph(schema, meta) {
-    if (meta.reducer && !meta.default) {
-        const defaultValue = isZodDefault(schema)
-            ? schema._def.defaultValue
-            : undefined;
-        if (defaultValue != null) {
-            // eslint-disable-next-line no-param-reassign
-            meta.default = defaultValue;
-        }
-    }
-    META_MAP.set(schema, meta);
-    return schema;
-}
-function getMeta(schema) {
-    return META_MAP.get(schema);
-}
-function extendMeta(schema, update) {
-    const existingMeta = getMeta(schema);
-    const newMeta = update(existingMeta);
-    META_MAP.set(schema, newMeta);
-}
-function getChannelsFromZod(schema) {
-    const channels = {};
-    for (const key in schema.shape) {
-        if (Object.prototype.hasOwnProperty.call(schema.shape, key)) {
-            const keySchema = schema.shape[key];
-            const meta = getMeta(keySchema);
-            if (meta?.reducer) {
-                channels[key] = new binop_js_1.BinaryOperatorAggregate(meta.reducer.fn, meta.default);
-            }
-            else {
-                channels[key] = new last_value_js_1.LastValue();
-            }
-        }
-    }
-    return channels;
-}
-const ZOD_TYPE_CACHE = {};
-const ZOD_DESCRIPTION_PREFIX = "lg:";
-function applyZodPlugin(schema, actions) {
-    const cacheKey = [
-        `reducer:${actions.reducer ?? false}`,
-        `jsonSchemaExtra:${actions.jsonSchemaExtra ?? false}`,
-        `partial:${actions.partial ?? false}`,
-    ].join("|");
-    ZOD_TYPE_CACHE[cacheKey] ??= new WeakMap();
-    const cache = ZOD_TYPE_CACHE[cacheKey];
-    if (cache.has(schema))
-        return cache.get(schema);
-    let shape = schema.extend({
-        ...Object.fromEntries(Object.entries(schema.shape).map(([key, input]) => {
-            const meta = getMeta(input);
-            let output = actions.reducer ? meta?.reducer?.schema ?? input : input;
-            if (actions.jsonSchemaExtra) {
-                const strMeta = JSON.stringify({
-                    ...meta?.jsonSchemaExtra,
-                    description: output.description ?? input.description,
-                });
-                if (strMeta !== "{}") {
-                    output = output.describe(`${ZOD_DESCRIPTION_PREFIX}${strMeta}`);
-                }
-            }
-            return [key, output];
-        })),
-    });
-    // using zObject.extend() will set `unknownKeys` to `passthrough`
-    // which trips up `zod-to-json-schema`
-    if ("_def" in shape &&
-        shape._def != null &&
-        typeof shape._def === "object" &&
-        "unknownKeys" in shape._def) {
-        shape._def.unknownKeys = "strip";
-    }
-    if (actions.partial)
-        shape = shape.partial();
-    cache.set(schema, shape);
-    return shape;
-}
-function applyExtraFromDescription(schema) {
-    if (Array.isArray(schema)) {
-        return schema.map(applyExtraFromDescription);
-    }
-    if (typeof schema === "object" && schema != null) {
-        const output = Object.fromEntries(Object.entries(schema).map(([key, value]) => [
-            key,
-            applyExtraFromDescription(value),
-        ]));
-        if ("description" in output &&
-            typeof output.description === "string" &&
-            output.description.startsWith(ZOD_DESCRIPTION_PREFIX)) {
-            const strMeta = output.description.slice(ZOD_DESCRIPTION_PREFIX.length);
-            delete output.description;
-            Object.assign(output, JSON.parse(strMeta));
-        }
-        return output;
-    }
-    return schema;
-}
-//# sourceMappingURL=state.js.map