fix: make workspace toolkit schemas compatible with Zod v4 record han…

[omeraplak]

…dling - #1043

PR Checklist

Please check if your PR fulfills the following requirements:

• The commit message follows our guidelines: https://voltagent.dev/docs/community/contributing/#commit-convention

Bugs / Features

• Related issue(s) linked
• Tests for the changes have been added
• Docs have been added / updated
• Changesets have been added https://voltagent.dev/docs/community/contributing/#creating-a-changeset

What is the current behavior?

What is the new behavior?

fixes (issue)

• [BUG] TypeError: Cannot read properties of undefined (reading '_zod') when using workspace toolkit tools with latest Zod and AI SDK #1043

Notes for reviewers

---

Summary by cubic

Updates workspace toolkit schemas to align with Zod v4 record handling, fixing runtime errors in sandbox and search indexing flows. Fixes #1043 and prevents “Cannot read properties of undefined (reading '_zod')”.

• Bug Fixes
  • Sandbox toolkit: env schema now uses z.record(z.string(), z.string()).
  • Search indexing: metadata schema now uses z.record(z.string(), z.unknown()).

^{Written for commit b4267e9. Summary will update on new commits.}

Summary by CodeRabbit

Bug Fixes

• Fixed runtime errors in workspace sandbox execution and search indexing features to ensure stable, reliable operation across all supported configurations.

[changeset-bot]

🦋 Changeset detected

Latest commit: b4267e9

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@voltagent/core	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[coderabbitai]

📝 Walkthrough

Walkthrough

Updates workspace toolkit schemas to support Zod v4 by explicitly specifying key and value types in z.record() calls. The sandbox toolkit's env parameter now requires string values, and the search index's metadata parameter explicitly defines string keys with unknown values.

Changes

Cohort / File(s)	Summary
Changeset Documentation .changeset/khaki-worms-wave.md	Documents Zod v4 compatibility fixes for workspace toolkit schemas to prevent runtime errors in workflows.
Zod Schema Updates packages/core/src/workspace/sandbox/toolkit.ts, packages/core/src/workspace/search/index.ts	Updated z.record() calls to explicitly specify both key and value types: env changed to z.record(z.string(), z.string()) and metadata changed to z.record(z.string(), z.unknown()).

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

• fix: include instructions from dynamic toolkits in system prompt gene… #1044: Contains identical Zod v4-compatible schema changes to workspace toolkit parameters for sandbox execute_command and search indexContent tools.

Poem

🐰 A rabbit hops through schema land,
Where types now flow from Zod's command,
String to string, and unknown too,
Version four works bright and new! 🌟

🚥 Pre-merge checks | ✅ 4

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly describes the main change: updating workspace toolkit schemas for Zod v4 record handling compatibility, directly addressing issue #1043.
Description check	✅ Passed	The description follows the template with all required sections completed: checklist items marked, current/new behavior documented, related issue linked, and additional context from cubic provided.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Merge Conflict Detection	✅ Passed	✅ No merge conflicts detected when merging into main

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch fix/zod-4-compatible-workspace-toolkit

---

No actionable comments were generated in the recent review. 🎉

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[cubic-dev-ai]

No issues found across 3 files

[cloudflare-workers-and-pages]

Deploying voltagent with    Cloudflare Pages

Latest commit:	b4267e9
Status:	✅  Deploy successful!
Preview URL:	https://915329f5.voltagent.pages.dev
Branch Preview URL:	https://fix-zod-4-compatible-workspa.voltagent.pages.dev

View logs