[控场AI]
产品ai-sdk valibot adapter

@ai-sdk/valibot

Vercel AI SDK 生态中的校验适配包,作为桥接层把 AI SDK 内部数据结构约定转译为 valibot 校验库可理解的 schema,用于对 LLM 输出进行结构化校验

核心事实

时间轴 (近 90 天)

11月12日

所有 provider 适配包(包括 @ai-sdk/valibot、@ai-sdk/zod 等)都依赖 @ai-sdk/provider-utils 来保证行为一致性。

待验证50%
11月11日

对于使用 @ai-sdk/vue 的开发者,升级到 3.0.330 无需额外迁移步骤,升级风险较低,但仍建议在锁文件更新后运行现有测试用例。

待验证50%
10月30日

@ai-sdk/valibot 3.0.72 的变更记录只有两条“Updated dependencies”,指向提交 7716e18 与 5c247e9,受影响的依赖为 @ai-sdk/provider-utils@5.0.72。

已过期90%
10月30日

Valibot 适配包对于使用多个 AI SDK 相关包的项目,统一到相同补丁号有助于减少依赖树中的重复版本,升级到 3.0.72 属于低风险操作。

待验证50%
10月30日

@ai-sdk/valibot 的职责是让开发者用 Valibot schema 定义工具参数和结构化输出,从而在调用模型时获得类型安全与运行时校验。

待验证50%
10月29日

对于 @ai-sdk/valibot 这类封套层包,依赖漂移可能导致同一进程内并存两套校验逻辑,问题通常在运行时而非安装时暴露。

待验证50%
10月29日

对绝大多数项目而言,升级到 2.0.64 不需要改动业务代码,建议纳入日常依赖更新流程而非单独安排升级窗口。

已过期50%
10月28日

@ai-sdk/rsc 包发布了 3.0.156 版本,这是一次补丁更新,由 GitHub Actions 自动发布,包含 5 个提交。

已过期80%
10月27日

对于使用 @ai-sdk/valibot 的项目,建议在 package.json 中使用 ^3.0.70 范围声明并配合锁文件固定版本。

待验证50%
10月27日

升级到 3.0.70 后,如果同时依赖 @ai-sdk/provider-utils,建议检查其版本是否已对齐到 5.0.70,避免两个不同小版本共存。

待验证50%

还有 40 条时间轴事件

全部知识事实 (20)

已验证

@ai-sdk/provider-utils 作为底层共享工具包,被 @ai-sdk/valibot、@ai-sdk/zod 等多个上层适配包共同依赖

90%
已验证

该发布记录由 GitHub Actions 自动化流程完成,并经过 GitHub 官方验证签名(Verified)

90%
已验证

Vercel AI SDK 采用 Monorepo 单一代码仓库管理模式,核心包 ai 与各框架适配包(如 @ai-sdk/vue、@ai-sdk/react、@ai-sdk/svelte)协同发布

90%
已验证

@ai-sdk/valibot 是 Vercel AI SDK 提供的 Valibot 集成模块,让开发者可以使用 Valibot 定义数据结构并接入 AI SDK 的生成流程

85%
已验证

AI SDK 的框架适配包与核心包保持补丁号版本号对齐(例如 ai@7.0.140 对应 @ai-sdk/svelte@5.0.140)。

80%
已验证

AI SDK 生态中存在与 @ai-sdk/valibot 类似的适配包 @ai-sdk/zod,两者提供相同的对外接口

80%
已验证

本次更新将依赖 ai 升级到 7.0.102,将 @ai-sdk/provider-utils 升级到 5.0.41

80%
已验证

适配器依赖的 provider-utils 版本与主包不一致时,可能出现类型定义不匹配、运行时工具函数行为差异等隐性故障。

75%
已验证

当 @ai-sdk/provider-utils 这类被多个包共同依赖的基础层包更新时,Changeset 会自动将依赖它的包标记为 patch 版本升级,这是 @ai-sdk/valibot 自身代码无变化却仍发布新版本的原因

75%
已验证

建议在升级后运行完整测试套件,尤其当项目同时锁定了 ai、@ai-sdk/provider 等相关依赖版本时

75%
已验证

@ai-sdk/svelte@5.0.93 更新归类为 Patch Changes,核心内容是同步九处上游依赖更新,并同步升级核心包 ai 至 7.0.93 版本

90%
已验证

@ai-sdk/voyage 发布了 2.0.62 版本,是一个标记为 Patch Changes 的补丁更新,发布于 10 月 16 日。

80%
已验证

@ai-sdk/valibot 3.0.59 是一次 Patch 级别的补丁发布,不引入破坏性改动,也不改变公开 API 形态。

75%
部分验证

3.0.40 版本包含文档维护提交 e729d58,更新 README.md 以统一格式并避免重复内容。

90%
待验证

@ai-sdk/valibot 的作用是将 Valibot 的 Schema 定义自动转换为 AI SDK 所需的 JSON Schema,并在模型返回结果后执行运行时类型校验

70%
待验证

本次更新为纯构建工具迁移,不涉及 API 变更或功能新增,理论上不会带来破坏性变更

70%
待验证

@ai-sdk/valibot 将 Valibot schema 转换为 AI SDK 内部统一的 schema 描述格式,使 generateObject、streamObject 等核心 API 能够使用 Valibot 进行结构化输出的类型约束与运行时校验

70%
待验证

所有 provider 适配包(包括 @ai-sdk/valibot、@ai-sdk/zod 等)都依赖 @ai-sdk/provider-utils 来保证行为一致性。

50%
待验证

对于使用 @ai-sdk/vue 的开发者,升级到 3.0.330 无需额外迁移步骤,升级风险较低,但仍建议在锁文件更新后运行现有测试用例。

50%
待验证

Valibot 适配包对于使用多个 AI SDK 相关包的项目,统一到相同补丁号有助于减少依赖树中的重复版本,升级到 3.0.72 属于低风险操作。

50%

来源文章