fix(zod): ensure only zod/v4 types are used (#992)

Closes [#1035](#1035)

Author: karpetrosyan

examples/structured-outputs-streaming.ts

@@ -2,7 +2,7 @@
 
 import { zodOutputFormat } from '@anthropic-ai/sdk/helpers/zod';
 import Anthropic from '@anthropic-ai/sdk';
-import { z } from 'zod';
+import { z } from 'zod/v4';
 
 const WeatherResponse = z.object({
   city: z.string(),

examples/structured-outputs-zod.ts

@@ -2,7 +2,7 @@
 
 import { zodOutputFormat } from '@anthropic-ai/sdk/helpers/zod';
 import Anthropic from '@anthropic-ai/sdk';
-import { z } from 'zod';
+import { z } from 'zod/v4';
 
 const NumbersResponse = z.object({
   primes: z.array(z.number()),

examples/tools-helpers-advanced-streaming.ts

@@ -3,7 +3,7 @@
 import Anthropic from '@anthropic-ai/sdk';
 import { betaZodTool } from '@anthropic-ai/sdk/helpers/beta/zod';
 import { BetaToolUseBlock } from '@anthropic-ai/sdk/resources/beta';
-import { z } from 'zod';
+import { z } from 'zod/v4';
 
 const client = new Anthropic();
 

examples/tools-helpers-advanced.ts

@@ -3,7 +3,7 @@
 import Anthropic from '@anthropic-ai/sdk';
 import { betaZodTool } from '@anthropic-ai/sdk/helpers/beta/zod';
 import { BetaToolUseBlock } from '@anthropic-ai/sdk/resources/beta';
-import { z } from 'zod';
+import { z } from 'zod/v4';
 
 const client = new Anthropic();
 

examples/tools-helpers-zod.ts

@@ -2,7 +2,7 @@
 
 import Anthropic from '@anthropic-ai/sdk';
 import { betaZodTool } from '@anthropic-ai/sdk/helpers/beta/zod';
-import { z } from 'zod';
+import { z } from 'zod/v4';
 
 const client = new Anthropic();
 

helpers.md

@@ -108,7 +108,7 @@ The SDK provides helpers for parsing structured JSON outputs from Claude using J
 ```ts
 import { zodOutputFormat } from '@anthropic-ai/sdk/helpers/zod';
 import Anthropic from '@anthropic-ai/sdk';
-import { z } from 'zod';
+import { z } from 'zod/v4';
 
 const client = new Anthropic();
 
@@ -183,7 +183,7 @@ The SDK provides helper functions to create runnable tools that can be automatic
 
 ```ts
 import { betaZodTool } from '@anthropic-ai/sdk/helpers/beta/zod';
-import { z } from 'zod';
+import { z } from 'zod/v4';
 
 const weatherTool = betaZodTool({
   name: 'get_weather',

src/helpers/beta/zod.ts

@@ -1,5 +1,4 @@
 import { transformJSONSchema } from '../..//lib/transform-json-schema';
-import type { infer as zodInfer, ZodType } from 'zod';
 import * as z from 'zod/v4';
 import { AnthropicError } from '../../core/error';
 import { AutoParseableBetaOutputFormat } from '../../lib/beta-parser';
@@ -14,9 +13,9 @@ import { BetaToolResultContentBlockParam } from '../../resources/beta';
  * This can be passed directly to the `.create()` method but will not
  * result in any automatic parsing, you'll have to parse the response yourself.
  */
-export function betaZodOutputFormat<ZodInput extends ZodType>(
+export function betaZodOutputFormat<ZodInput extends z.ZodType>(
   zodObject: ZodInput,
-): AutoParseableBetaOutputFormat<zodInfer<ZodInput>> {
+): AutoParseableBetaOutputFormat<z.infer<ZodInput>> {
   let jsonSchema = z.toJSONSchema(zodObject, { reused: 'ref' });
 
   jsonSchema = transformJSONSchema(jsonSchema);
@@ -46,15 +45,15 @@ export function betaZodOutputFormat<ZodInput extends ZodType>(
  * converted into JSON Schema when passed to the API. The provided function's
  * input arguments will also be validated against the provided schema.
  */
-export function betaZodTool<InputSchema extends ZodType>(options: {
+export function betaZodTool<InputSchema extends z.ZodType>(options: {
   name: string;
   inputSchema: InputSchema;
   description: string;
   run: (
-    args: zodInfer<InputSchema>,
+    args: z.infer<InputSchema>,
     context?: BetaToolRunContext,
   ) => Promisable<string | Array<BetaToolResultContentBlockParam>>;
-}): BetaRunnableTool<zodInfer<InputSchema>> {
+}): BetaRunnableTool<z.infer<InputSchema>> {
   const jsonSchema = z.toJSONSchema(options.inputSchema, { reused: 'ref' });
 
   if (jsonSchema.type !== 'object') {
@@ -70,6 +69,6 @@ export function betaZodTool<InputSchema extends ZodType>(options: {
     input_schema: objectSchema,
     description: options.description,
     run: options.run,
-    parse: (args: unknown) => options.inputSchema.parse(args) as zodInfer<InputSchema>,
+    parse: (args: unknown) => options.inputSchema.parse(args) as z.infer<InputSchema>,
   };
 }

src/helpers/zod.ts

@@ -1,5 +1,4 @@
 import { transformJSONSchema } from '../lib/transform-json-schema';
-import type { infer as zodInfer, ZodType } from 'zod';
 import * as z from 'zod/v4';
 import { AnthropicError } from '../core/error';
 import { AutoParseableOutputFormat } from '../lib/parser';
@@ -13,9 +12,9 @@ import { AutoParseableOutputFormat } from '../lib/parser';
  * This can be passed directly to the `.create()` method but will not
  * result in any automatic parsing, you'll have to parse the response yourself.
  */
-export function zodOutputFormat<ZodInput extends ZodType>(
+export function zodOutputFormat<ZodInput extends z.ZodType>(
   zodObject: ZodInput,
-): AutoParseableOutputFormat<zodInfer<ZodInput>> {
+): AutoParseableOutputFormat<z.infer<ZodInput>> {
   let jsonSchema = z.toJSONSchema(zodObject, { reused: 'ref' });
 
   jsonSchema = transformJSONSchema(jsonSchema);

tests/helpers/beta/zod.test.ts

@@ -1,4 +1,4 @@
-import * as z from 'zod';
+import * as z from 'zod/v4';
 import { betaZodTool } from '../../../src/helpers/beta/zod';
 
 describe('zod helpers', () => {

tests/helpers/zod.test.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import { z } from 'zod/v4';
 import { betaZodOutputFormat } from '../../src/helpers/beta/zod';
 import { zodOutputFormat } from '../../src/helpers/zod';