fix(api): remove pin to Zod 3 when consuming langgraph-api / cli or ui (#1763)

.changeset/tall-onions-fry.md

@@ -0,0 +1,7 @@
+---
+"@langchain/langgraph-api": patch
+"@langchain/langgraph-cli": patch
+"@langchain/langgraph-ui": patch
+---
+
+Remove Zod 3.x dependency constraint to allow Zod 4.x and avoid installing duplicate Zod packages

libs/langgraph-api/package.json

@@ -80,7 +80,7 @@
     "uuid": "^10.0.0",
     "winston": "^3.17.0",
     "winston-console-format": "^1.0.8",
-    "zod": "^3.23.8"
+    "zod": "^3.25.76 || ^4"
   },
   "peerDependencies": {
     "@langchain/core": "^0.3.59 || ^1.0.1",

libs/langgraph-api/src/api/assistants.mts

@@ -2,7 +2,7 @@ import { zValidator } from "@hono/zod-validator";
 import { Hono } from "hono";
 
 import { v4 as uuid } from "uuid";
-import { z } from "zod";
+import { z } from "zod/v3";
 
 import {
   getAssistantId,

libs/langgraph-api/src/api/runs.mts

@@ -3,7 +3,7 @@ import { Hono } from "hono";
 import { HTTPException } from "hono/http-exception";
 import { streamSSE } from "hono/streaming";
 import { v4 as uuid4 } from "uuid";
-import { z } from "zod";
+import { z } from "zod/v3";
 import type { AuthContext } from "../auth/index.mjs";
 import { getAssistantId } from "../graph/load.mjs";
 import { logError, logger } from "../logging.mjs";

libs/langgraph-api/src/api/threads.mts

@@ -3,7 +3,7 @@ import { zValidator } from "@hono/zod-validator";
 import { Hono } from "hono";
 import { v4 as uuid4 } from "uuid";
 
-import { z } from "zod";
+import { z } from "zod/v3";
 import * as schemas from "../schemas.mjs";
 import { stateSnapshotToThreadState } from "../state.mjs";
 import { threads } from "../storage/context.mjs";

libs/langgraph-api/src/experimental/embed.mts

@@ -12,7 +12,7 @@ import { v4 as uuidv4 } from "uuid";
 import type { Metadata, Run } from "../storage/types.mjs";
 import * as schemas from "../schemas.mjs";
 
-import { z } from "zod";
+import { z } from "zod/v3";
 import { streamState } from "../stream.mjs";
 import { serialiseAsDict, serializeError } from "../utils/serde.mjs";
 import { getDisconnectAbortSignal, jsonExtra } from "../utils/hono.mjs";

libs/langgraph-api/src/graph/load.mts

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import { z } from "zod/v3";
 
 import * as uuid from "uuid";
 import type { AssistantsRepo } from "../storage/types.mjs";

libs/langgraph-api/src/schemas.mts

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import { z } from "zod/v3";
 
 export const AssistantConfigurable = z
   .object({

libs/langgraph-api/src/server.mts

@@ -12,7 +12,7 @@ import meta from "./api/meta.mjs";
 
 import type { Ops, Store, StorageEnv } from "./storage/types.mjs";
 import { zValidator } from "@hono/zod-validator";
-import { z } from "zod";
+import { z } from "zod/v3";
 import { queue } from "./queue.mjs";
 import {
   logger,

libs/langgraph-api/src/ui/load.mts

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import { z } from "zod/v3";
 import { Hono } from "hono";
 import { getMimeType } from "hono/utils/mime";
 import { zValidator } from "@hono/zod-validator";

libs/langgraph-api/src/utils/runnableConfig.mts

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import { z } from "zod/v3";
 import type { Checkpoint, RunnableConfig } from "../storage/types.mjs";
 
 const ConfigSchema = z.object({

libs/langgraph-cli/package.json

@@ -50,7 +50,7 @@
     "winston": "^3.17.0",
     "winston-console-format": "^1.0.8",
     "yaml": "^2.7.0",
-    "zod": "^3.23.8"
+    "zod": "^3.25.76 || ^4"
   },
   "devDependencies": {
     "@types/babel__code-frame": "^7.0.6",

libs/langgraph-cli/src/cli/dev.mts

@@ -4,7 +4,7 @@ import type { ChildProcess } from "node:child_process";
 
 import { parse, populate } from "dotenv";
 import { watch } from "chokidar";
-import { z } from "zod";
+import { z } from "zod/v3";
 import open from "open";
 
 import { startCloudflareTunnel, type CloudflareTunnel } from "./cloudflare.mjs";

libs/langgraph-cli/src/docker/compose.mts

@@ -1,6 +1,6 @@
 import { $ } from "execa";
 import * as yaml from "yaml";
-import { z } from "zod";
+import { z } from "zod/v3";
 import { getExecaOptions } from "./shell.mjs";
 
 export const DEFAULT_POSTGRES_URI =

libs/langgraph-cli/src/utils/config.mts

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import { z } from "zod/v3";
 import { extname } from "node:path";
 
 const GraphPathSchema = z.string().refine((i) => i.includes(":"), {

libs/langgraph-ui/package.json

@@ -31,7 +31,7 @@
     "commander": "^13.0.0",
     "esbuild": "^0.25.0",
     "esbuild-plugin-tailwindcss": "^2.0.1",
-    "zod": "^3.23.8"
+    "zod": "^3.25.76 || ^4"
   },
   "devDependencies": {
     "@types/node": "^18.15.11",

libs/langgraph-ui/src/api.mts

@@ -1,4 +1,4 @@
-import { z } from "zod";
+import { z } from "zod/v3";
 import * as fs from "node:fs/promises";
 import * as path from "node:path";
 import * as bundler from "./bundler.mjs";

yarn.lock

@@ -1657,7 +1657,7 @@ __metadata:
     wait-port: "npm:^1.1.0"
     winston: "npm:^3.17.0"
     winston-console-format: "npm:^1.0.8"
-    zod: "npm:^3.23.8"
+    zod: "npm:^3.25.76 || ^4"
   peerDependencies:
     "@langchain/core": ^0.3.59 || ^1.0.1
     "@langchain/langgraph": ^0.2.57 || ^0.3.0 || ^0.4.0 || ^1.0.0-alpha || ^1.0.0
@@ -1918,7 +1918,7 @@ __metadata:
     winston: "npm:^3.17.0"
     winston-console-format: "npm:^1.0.8"
     yaml: "npm:^2.7.0"
-    zod: "npm:^3.23.8"
+    zod: "npm:^3.25.76 || ^4"
   bin:
     langgraphjs: dist/cli/cli.mjs
   languageName: unknown
@@ -2102,7 +2102,7 @@ __metadata:
     prettier: "npm:^2.8.3"
     typescript: "npm:^4.9.5 || ^5.4.5"
     vitest: "npm:^3.1.2"
-    zod: "npm:^3.23.8"
+    zod: "npm:^3.25.76 || ^4"
   bin:
     langgraphjs-ui: ./dist/cli.mjs
   languageName: unknown