@ai-sdk/xai
Vercel AI SDK 生态中用于接入 xAI（Grok）模型的官方 provider 包，基于 OpenAI 兼容层实现，支持流式响应、工具调用等能力
核心事实
时间轴 (近 90 天)
依赖 OpenAI Live getServerWebSocketConfig() 的项目升级后须排查调用点，确保消费连接配置前已 await 异步结果。
官方描述新凭据解析行为为：在每个已认证请求上解析凭据，同时保留现有认证行为以及同步凭据序列化。
@ai-sdk/xai 5.0.34 的核心变更是支持在 provider API key 和 token 设置中使用 Promise 以及同步或异步回调。
5.0.34 版本对原有的静态字符串 API key 用法保持向后兼容，现有代码无需改动。
对于使用 @ai-sdk/xai 的项目，若使用 npm 或 pnpm 并依赖锁文件，执行一次常规的依赖更新即可；若处于版本冻结期，也可以安全跳过本次更新。
3.0.146 版本的变更内容为：在响应的 provider metadata 中暴露 costInUsdTicks 字段。
3.0.146 版本没有引入 API 破坏性改动，属于增量式的能力补充。
修复后每个引用只被发送一次，使流式输出中的引用列表与预期一致。
该修复的关键提交编号为 0eb8de6，提交说明为 'fix(xai): stop emitting each citation twice when streaming responses with web or X search'。
5.0.32 版本修复了在使用 Web 搜索或 X 搜索功能时引用（citation）在流式响应中被重复输出两次的缺陷。
还有 40 条时间轴事件
全部知识事实 (20)
@ai-sdk/xai 是 AI SDK 中面向 xAI Grok 系列模型的适配层 provider 包
90%已验证xAI 提供与 OpenAI 兼容的 API 接口，这是早期 @ai-sdk/xai 能通过 Chat Completions 端点进行适配的基础
90%已验证@ai-sdk/zai 是 Vercel AI SDK 面向智谱 AI（Zhipu AI）模型的官方 Provider
90%已验证xAI 的 Grok 系列模型在 API 设计上遵循 OpenAI 的接口规范
85%已验证@ai-sdk/xai@3.0.134 由 GitHub Actions 自动构建
80%已验证建议将相关 @ai-sdk/* 包成组升级，因为 provider-utils 已同步到 5.0.49
75%已验证补丁版本升级一般无需修改现有业务代码，但建议升级后运行集成测试确认依赖版本兼容性
75%已验证@ai-sdk/xai@5.0.5 由 github-actions 自动发布，属于 Patch Changes（补丁级更新）
75%已验证建议在升级后运行完整测试套件，尤其当项目同时锁定了 ai、@ai-sdk/provider 等相关依赖版本时
75%已验证使用 AI SDK 对接 xAI 模型且定义了带有严格属性约束工具或结构化输出 schema 的开发者，建议升级到 4.0.59
75%已验证建议在升级后运行现有测试用例，确认流式输出和消息处理逻辑正常
75%已验证由于 AI SDK 各包之间存在版本联动，建议将 @ai-sdk/provider、@ai-sdk/provider-utils 与 voyage 包保持在兼容的版本区间内
75%已验证升级 @ai-sdk/xai 时建议一并更新关联的 @ai-sdk/provider 与 @ai-sdk/provider-utils 依赖以保证一致性
75%已验证@ai-sdk/xai 适配器专门对接 xAI 公司的 Grok 系列模型
75%已验证该版本遵循语义化版本规范中的 PATCH 更新策略，不会引入破坏性变更，向后兼容
75%已验证补丁版本遵循语义化版本控制（SemVer）规范，理论上不会引入破坏性变更
75%已验证该依赖更新关联提交9942196
75%已验证补丁版本更新通常向后兼容，可通过 npm update @ai-sdk/zai 或对应包管理器命令升级
75%已验证`@ai-sdk/typesafe-ai` 包发布了 3.0.27 版本，属于补丁（Patch Changes）版本，没有引入新功能或破坏性变更。
80%已验证@ai-sdk/zai 包发布了 3.0.8 版本，属于补丁变更（Patch Changes）
90%