@ai-sdk/typesafe-ai
基于 AI SDK 上层做类型安全封装的 npm 包,锁定 provider 相关依赖版本以保证类型定义与运行时行为一致
核心事实
时间轴 (近 90 天)
在下游项目中,如果锁定了旧版 provider-utils,安装 @ai-sdk/typesafe-ai@3.0.40 时包管理器可能保留旧版本以满足其他依赖的范围约束,导致版本分裂。
升级到 3.0.40 版本时,建议检查锁文件中 @ai-sdk/provider-utils 的解析结果是否统一为 5.0.81,并运行类型检查与测试。
决策模型目录支持在单次调用或单个文件分片粒度上配置提供商参数。
决策模型目录明确标注哪些模型接受图像作为输入。
决策模型目录定义了模型能够处理的问题类型分类。
决策模型目录支持在编写代码时提供模型 ID 建议。
3.0.39 版本为 TypeSafe AI 引入了决策模型目录(decision model catalog)。
建议开发者先在开发环境升级至 3.0.39,确认类型提示与现有代码无冲突后再部署至生产。
3.0.34 版本没有引入新功能或破坏性改动,意义在于让类型安全层与上游 AI SDK 组件保持对齐。
凭证会在每次经过身份验证的请求时按请求解析(resolve credentials per authenticated request),同时保留原有认证行为和同步凭证序列化能力
还有 40 条时间轴事件
全部知识事实 (20)
该发布记录由 GitHub Actions 自动化流程完成,并经过 GitHub 官方验证签名(Verified)
90%已验证使用 @ai-sdk/svelte 时应确保 ai 与 @ai-sdk/svelte 版本对齐,避免混用不同大版本
90%已验证@ai-sdk/typesafe-ai 是 AI SDK 的类型安全封装层,为模型调用、工具定义、结构化输出等场景提供更严格的类型约束。
80%已验证由于大模型 API 迭代频繁,@ai-sdk/provider 和 @ai-sdk/provider-utils 在 AI SDK 工具链中发布频率较高
80%已验证AI SDK 生态中存在与 @ai-sdk/valibot 类似的适配包 @ai-sdk/zod,两者提供相同的对外接口
80%已验证本次更新将依赖 ai 升级到 7.0.102,将 @ai-sdk/provider-utils 升级到 5.0.41
80%已验证如果项目当前版本与核心 ai 包存在版本不一致,升级到 @ai-sdk/vue@3.0.310 有助于对齐依赖树。
75%已验证对于 patch 级别的更新,如果 changeset 描述过于简略或未被包含在发布流程中,Release 页面就可能只显示版本号和构建产物,而缺少面向用户的详细说明。
75%已验证typesafe-ai 是在 AI SDK 之上提供类型安全调用封装的包,需要锁定与之匹配的依赖版本以保证类型定义和运行时行为一致
75%已验证v3.24.0版本由GitHub经过验证签名发布
75%已验证@ai-sdk/typesafe-ai 子包的定位在于类型安全,借助 TypeScript 类型系统帮助开发者在编译阶段捕获潜在问题
75%已验证推理保留特性只在支持推理输出的模型上生效,普通对话模型不受影响
75%已验证@ai-sdk/zai 包发布了 3.0.8 版本,属于补丁变更(Patch Changes)
90%已验证@ai-sdk/svelte 发布了 5.0.93 版本
90%部分验证3.0.40 版本包含文档维护提交 e729d58,更新 README.md 以统一格式并避免重复内容。
90%待验证@ai-sdk/zai 3.0.44 中 provider 的 API Key 与 token 配置支持 Promise 以及同步/异步回调函数
70%待验证对于使用 `@ai-sdk/typesafe-ai` 的项目,建议升级后运行现有的类型检查和集成测试,确认 provider 接口的兼容性没有意外漂移。
70%待验证建议升级后跑一遍类型检查与测试用例,并将 provider-utils 和 provider 一并升级到对应版本
70%待验证typesafe-ai 模块将编译期类型检查与运行时校验结合,运行时校验可借助 Zod 等 Schema 校验库
70%待验证在下游项目中,如果锁定了旧版 provider-utils,安装 @ai-sdk/typesafe-ai@3.0.40 时包管理器可能保留旧版本以满足其他依赖的范围约束,导致版本分裂。
50%