Default provider failover plugin for Agent Forge (explicit chains and backupProviders, module-level circuit breaker, committed-boundary replay with credential stripping)
Agent Forge 出厂默认 provider 主备切换插件（显式链与 backupProviders、模块级熔断状态机、提交边界内的无感重放与凭据剔除），bundled 分发，宿主通过 manifest 加载并经 api.registerStreamFnWrapper（priority: -100，链最外层）挂进默认 stream 装配（D-082 批 3b，迁自内核内嵌实现 packages/agent-forge/src/core/extensions/provider-failover.ts）。
配置经宿主 config 注入通道递交：{ version: 1, failover: <settings failover 节原样> }；无注入 = 插件 no-op。装载预检消费 api.host.modelCatalog 宿主服务（目录解析/provider 存在/凭据条目），配置了 failover 而宿主未提供 modelCatalog 时 fail-loud。
@ai-agent-forge/plugin-provider-failover 共发布 27 个版本，首次发布于 2026/10/04；过去 12 个月发布了 27 个版本。
| 版本 | 发布日期 | 距今 |
|---|---|---|
0.88.28latest | 2026/11/02 | 4 天前 |
0.88.27 | 2026/11/01 | 4 天前 |
0.88.26 | 2026/11/01 | 5 天前 |
0.88.25 | 2026/10/31 | 6 天前 |
0.88.24 | 2026/10/30 | 6 天前 |
0.88.23 | 2026/10/30 | 7 天前 |
Default provider failover plugin for Agent Forge (explicit chains and backupProviders, module-level circuit breaker, committed-boundary replay with credential stripping)
在项目目录运行 npm install @ai-agent-forge/plugin-provider-failover，或使用 pnpm add / yarn add / bun add。
支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。
package.json 的 engines 字段要求 Node.js >=22.19.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。
@ai-agent-forge/plugin-provider-failover 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
根据 npm 官方下载统计，@ai-agent-forge/plugin-provider-failover 在 2026/10/05 – 2026/11/03 这 30 天内被下载 4,158 次，日均约 139 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
最新版本 0.88.28 发布于 2026/11/02（4 天前）；至今共发布 27 个版本，其中过去 12 个月发布了 27 个；首次发布于 2026/10/04。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。