@ai-sdk/valibot
Vercel AI SDK 生态中的校验适配包,作为桥接层把 AI SDK 内部数据结构约定转译为 valibot 校验库可理解的 schema,用于对 LLM 输出进行结构化校验
核心事实
时间轴 (近 90 天)
所有 provider 适配包(包括 @ai-sdk/valibot、@ai-sdk/zod 等)都依赖 @ai-sdk/provider-utils 来保证行为一致性。
对于使用 @ai-sdk/vue 的开发者,升级到 3.0.330 无需额外迁移步骤,升级风险较低,但仍建议在锁文件更新后运行现有测试用例。
@ai-sdk/valibot 3.0.72 的变更记录只有两条“Updated dependencies”,指向提交 7716e18 与 5c247e9,受影响的依赖为 @ai-sdk/provider-utils@5.0.72。
Valibot 适配包对于使用多个 AI SDK 相关包的项目,统一到相同补丁号有助于减少依赖树中的重复版本,升级到 3.0.72 属于低风险操作。
@ai-sdk/valibot 的职责是让开发者用 Valibot schema 定义工具参数和结构化输出,从而在调用模型时获得类型安全与运行时校验。
对于 @ai-sdk/valibot 这类封套层包,依赖漂移可能导致同一进程内并存两套校验逻辑,问题通常在运行时而非安装时暴露。
对绝大多数项目而言,升级到 2.0.64 不需要改动业务代码,建议纳入日常依赖更新流程而非单独安排升级窗口。
@ai-sdk/rsc 包发布了 3.0.156 版本,这是一次补丁更新,由 GitHub Actions 自动发布,包含 5 个提交。
对于使用 @ai-sdk/valibot 的项目,建议在 package.json 中使用 ^3.0.70 范围声明并配合锁文件固定版本。
升级到 3.0.70 后,如果同时依赖 @ai-sdk/provider-utils,建议检查其版本是否已对齐到 5.0.70,避免两个不同小版本共存。
还有 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%