refactor(deps): move zod to peerDependencies with v4-mini (#278)

- Move zod from dependencies to peerDependencies (>=3.25.0 <5)
- Use zod/v4-mini subpath for smaller bundle size in schema/headers
- Use zod/v4 subpath in feedback.ts (requires .transform/.refine)
- Add zod to devDependencies and examples for development/testing

This allows users to bring their own zod version (3.25+ or 4.x)
while ensuring compatibility with AI SDK's zod peer dependency.
The v4-mini variant reduces bundle size for simple schemas.

Author: ryoppippi

README.md

@@ -14,18 +14,20 @@ The StackOne AI SDK provides the `StackOneToolSet` class, which fetches tools dy
 
 ```bash
 # Using npm
-npm install @stackone/ai
+npm install @stackone/ai zod
 
 # Using yarn
-yarn add @stackone/ai
+yarn add @stackone/ai zod
 
 # Using pnpm
-pnpm add @stackone/ai
+pnpm add @stackone/ai zod
 
 # Using bun
-bun add @stackone/ai
+bun add @stackone/ai zod
 ```
 
+> **Note:** `zod` is a peer dependency required for AI SDK integrations and internal schema validation. Version `>=3.25.0 <5` is supported.
+
 ## Usage
 
 ```typescript

examples/package.json

@@ -12,7 +12,8 @@
 		"@tanstack/ai": "catalog:examples",
 		"@tanstack/ai-openai": "catalog:examples",
 		"ai": "catalog:peer",
-		"openai": "catalog:peer"
+		"openai": "catalog:peer",
+		"zod": "catalog:dev"
 	},
 	"devDependencies": {
 		"@types/node": "catalog:dev",

package.json

@@ -53,8 +53,7 @@
 	"dependencies": {
 		"@modelcontextprotocol/sdk": "catalog:prod",
 		"@orama/orama": "catalog:prod",
-		"defu": "catalog:prod",
-		"zod": "catalog:prod"
+		"defu": "catalog:prod"
 	},
 	"devDependencies": {
 		"@fast-check/vitest": "catalog:dev",
@@ -76,12 +75,14 @@
 		"type-fest": "catalog:dev",
 		"typescript": "catalog:dev",
 		"unplugin-unused": "catalog:dev",
-		"vitest": "catalog:dev"
+		"vitest": "catalog:dev",
+		"zod": "catalog:dev"
 	},
 	"peerDependencies": {
 		"@anthropic-ai/sdk": "catalog:peer",
 		"ai": "catalog:peer",
-		"openai": "catalog:peer"
+		"openai": "catalog:peer",
+		"zod": "catalog:peer"
 	},
 	"peerDependenciesMeta": {
 		"@anthropic-ai/sdk": {

pnpm-lock.yaml

@@ -27,6 +27,7 @@ catalogs:
     typescript: ^5.8.3
     unplugin-unused: ^0.5.4
     vitest: ^4.0.15
+    zod: ^4.1.13
   examples:
     '@anthropic-ai/claude-agent-sdk': ^0.1.67
     '@tanstack/ai': ^0.0.3
@@ -35,11 +36,11 @@ catalogs:
     '@anthropic-ai/sdk': ^0.52.0
     ai: '>=5.0.108 <7.0.0'
     openai: ^6.2.0
+    zod: '>=3.25.0 <5'
   prod:
     '@modelcontextprotocol/sdk': ^1.24.3
     '@orama/orama': ^3.1.11
     defu: ^6.1.4
-    zod: ^4.1.13
 
 enablePrePostScripts: true
 

pnpm-workspace.yaml

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import { z } from 'zod/v4';
 import { DEFAULT_BASE_URL } from './consts';
 import { BaseTool } from './tool';
 import type { ExecuteConfig, ExecuteOptions, JsonObject, JsonValue, ToolParameters } from './types';

src/feedback.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod/mini';
+import { z } from 'zod/v4-mini';
 import type { JsonObject } from './types';
 
 /**

src/headers.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod/mini';
+import { z } from 'zod/v4-mini';
 import { stackOneHeadersSchema } from './headers';
 
 /**