docs: add Zod version compatibility note for Stagehand

Fixes: #25652

Author: ruifigueira

src/content/docs/browser-rendering/platform/stagehand.mdx

@@ -42,6 +42,24 @@ Install the necessary dependencies:
 	npm ci
 	```
 
+:::note
+Stagehand 2.5 does not fully support Zod 4 yet, so you need to ensure you have Zod 3.x installed, as well as `zod-to-json-schema`. In `package.json`, ensure that the dependencies are set as follows:
+
+	```json
+	{
+		// ...
+		"dependencies": {
+			"@browserbasehq/stagehand": "^2.5.0",
+			"@cloudflare/playwright": "^1.0.0",
+			"zod": "^3.25.76",
+			"zod-to-json-schema": "^3.24.6"
+			// ...
+		}
+	}
+	```
+:::
+
+
 ### 2. Configure your Worker
 
 Update your wrangler configuration file to include the bindings for Browser Rendering and [Workers AI](/workers-ai/):