chore: upgrade to zod v4 (#4039)

## Zod v4 compatibility

Upgrades the monorepo's internal zod version from 3.x to 4.4.3 and
widens the peer
dependency on all published packages to `"^3.25.56 || ^4.0.0"`.

### For library consumers

No breaking change if you are on zod 3.25+. The peer dependency range is
widened, not
narrowed — your existing zod 3.25+ install continues to satisfy it and
the library code
is runtime-compatible with both versions. Zod 4.x is now also supported.
Bumped as minor
across all affected packages.

Minimum zod 3 version is **3.25.56** (not 3.0.0).

### API compatibility

Zod types appear in the public API of `@trigger.dev/core` and
`@trigger.dev/redis-worker`
(generic constraints like `T extends z.ZodTypeAny`, exported schema
values typed as
`z.ZodType<T>`, and `WorkerCatalog`'s schema field). These types exist
in both zod 3 and
zod 4, so TypeScript consumers on either version should resolve them
without errors —
the shapes are structurally compatible across versions.

If you pass your own zod schemas into library APIs (e.g. `zodfetch`,
`zodShapeStream`,
`WorkerCatalog`), schemas from zod 3.25+ and zod 4.x are both accepted.

`WorkerCatalog` uses `z.ZodFirstPartySchemaTypes`, which is present in
zod 4 via a
compatibility alias but marked `@deprecated`. This is intentional — the
type is still
fully functional, and we've left it in place to avoid a breaking API
change.

## TODO list before merging
- [x] bump @trigger.dev/platform dep to 1.2.1 when that becomes
available

Author: carderne

.changeset/zod-4-support.md

@@ -0,0 +1,14 @@
+---
+"@trigger.dev/build": minor
+"@trigger.dev/core": minor
+"@trigger.dev/react-hooks": minor
+"@trigger.dev/rsc": minor
+"@trigger.dev/sdk": minor
+"trigger.dev": minor
+"@trigger.dev/redis-worker": minor
+"@trigger.dev/schema-to-json": minor
+---
+
+Trigger.dev now uses Zod 4 by default. Projects using Zod 3.25.56 or later 3.x releases remain supported.
+
+Zod remains a runtime dependency of packages that execute schemas, so existing and new installations continue to receive it automatically. The matching peer dependency range allows package managers to reuse either a compatible Zod 3 or Zod 4 installation from your project.

AGENTS.md

@@ -134,7 +134,7 @@ When a **server-only** change (`apps/webapp/`, `apps/supervisor/`, etc., with no
 
 ## Dependency Pinning
 
-Zod is pinned to a single version across the entire monorepo (currently `3.25.76`). When adding zod to a new or existing package, use the **exact same version** as the rest of the repo - never a different version or a range. Mismatched zod versions cause runtime type incompatibilities (e.g., schemas from one package can't be used as body validators in another).
+Zod is pinned to a single version across the entire monorepo. When adding zod to a new or existing package, use the **exact same version** as the rest of the repo - never a different version or a range. Mismatched zod versions cause runtime type incompatibilities (e.g., schemas from one package can't be used as body validators in another).
 
 ## Architecture Overview
 

apps/supervisor/package.json

@@ -23,7 +23,7 @@
     "prom-client": "^15.1.0",
     "socket.io": "4.8.3",
     "std-env": "^3.8.0",
-    "zod": "3.25.76"
+    "zod": "4.5.4"
   },
   "devDependencies": {
     "@internal/testcontainers": "workspace:*",

apps/webapp/app/components/Feedback.tsx

@@ -5,7 +5,7 @@ import {
   getTextareaProps,
   useForm,
 } from "@conform-to/react";
-import { parseWithZod } from "@conform-to/zod";
+import { parseWithZod } from "@conform-to/zod/v4";
 import { InformationCircleIcon, ArrowUpCircleIcon } from "@heroicons/react/20/solid";
 import { EnvelopeIcon, ShieldCheckIcon } from "@heroicons/react/24/solid";
 import { Form, useActionData, useLocation, useNavigation, useSearchParams } from "@remix-run/react";
@@ -130,7 +130,7 @@ export function Feedback({
             <Fieldset className="max-w-full gap-y-3">
               <input
                 value={location.pathname}
-                {...getInputProps(fields.path, { type: "hidden" })}
+                {...getInputProps(fields.path, { type: "hidden", value: false })}
               />
               <InputGroup className="max-w-full">
                 {type === "feature" && (

apps/webapp/app/components/billing/BillingAlertsSection.tsx

@@ -1,5 +1,5 @@
 import { getFormProps, getInputProps, useForm, type SubmissionResult } from "@conform-to/react";
-import { parseWithZod } from "@conform-to/zod";
+import { parseWithZod } from "@conform-to/zod/v4";
 import { PlusIcon, TrashIcon } from "@heroicons/react/20/solid";
 import { Form, useActionData, useSearchParams } from "@remix-run/react";
 import { Fragment, useEffect, useMemo, useRef, useState } from "react";

apps/webapp/app/components/billing/BillingLimitConfigSection.tsx

@@ -1,6 +1,6 @@
 import { getFormProps, useForm, type SubmissionResult } from "@conform-to/react";
 
-import { parseWithZod } from "@conform-to/zod";
+import { parseWithZod } from "@conform-to/zod/v4";
 import { Form, useActionData } from "@remix-run/react";
 import { useEffect, useMemo, useRef, useState } from "react";
 import { z } from "zod";
@@ -38,7 +38,7 @@ export const billingLimitFormSchema = z.discriminatedUnion("mode", [
   z.object({
     mode: z.literal("custom"),
     amount: z.coerce
-      .number({ invalid_type_error: "Not a valid amount" })
+      .number({ error: "Not a valid amount" })
       .positive("Amount must be greater than 0"),
     cancelInProgressRuns: z
       .preprocess((v) => v === "on" || v === true || v === "true", z.boolean())

apps/webapp/app/components/billing/BillingLimitRecoveryPanel.tsx

@@ -1,5 +1,5 @@
 import { getFormProps, useForm, type SubmissionResult } from "@conform-to/react";
-import { parseWithZod } from "@conform-to/zod";
+import { parseWithZod } from "@conform-to/zod/v4";
 import { Form, useActionData, useNavigation } from "@remix-run/react";
 import { useEffect, useMemo, useRef, useState } from "react";
 import { z } from "zod";
@@ -21,7 +21,7 @@ export const billingLimitRecoveryFormSchema = z
   .object({
     action: z.enum(["increase", "remove"]),
     newAmount: z.coerce
-      .number({ invalid_type_error: "Not a valid amount" })
+      .number({ error: "Not a valid amount" })
       .positive("Amount must be greater than 0")
       .optional(),
     resumeMode: z.enum(["queue", "new_only"]),
@@ -88,7 +88,7 @@ export function BillingLimitRecoveryPanel({
     },
     defaultValue: {
       action: "increase",
-      newAmount: suggestedNewLimitDollars,
+      newAmount: String(suggestedNewLimitDollars),
       resumeMode: "queue",
     },
   });

apps/webapp/app/components/errors/ConfigureErrorAlerts.tsx

@@ -1,6 +1,6 @@
 import { getFormProps, getInputProps, useForm } from "@conform-to/react";
 import { GlobeLinesIcon } from "~/assets/icons/GlobeLinesIcon";
-import { parseWithZod } from "@conform-to/zod";
+import { parseWithZod } from "@conform-to/zod/v4";
 import { EnvelopeIcon, HashtagIcon, LockClosedIcon, XMarkIcon } from "@heroicons/react/20/solid";
 import { BellAlertIcon } from "@heroicons/react/24/solid";
 import { useFetcher, useNavigate } from "@remix-run/react";

apps/webapp/app/components/metrics/QueryWidget.tsx

@@ -55,7 +55,7 @@ const chartConfigOptions = {
   sortByColumn: z.string().nullable(),
   sortDirection: SortDirection,
   aggregation: AggregationType,
-  seriesColors: z.record(z.string()).optional(),
+  seriesColors: z.record(z.string(), z.string()).optional(),
 };
 
 const ChartConfiguration = z.object({ ...chartConfigOptions });

apps/webapp/app/components/runs/v3/ReplayRunDialog.tsx

@@ -1,5 +1,5 @@
 import { getFormProps, getInputProps, getSelectProps, useForm } from "@conform-to/react";
-import { parseWithZod } from "@conform-to/zod";
+import { parseWithZod } from "@conform-to/zod/v4";
 import { RectangleStackIcon } from "@heroicons/react/20/solid";
 import { DialogClose } from "@radix-ui/react-dialog";
 import { Form, useActionData, useNavigation, useParams, useSubmit } from "@remix-run/react";