@wd041216-bit/agent-model-switch-guard
v0.1.1
Published
Stop agent runtimes from falsely claiming a model switch already happened by separating saved selection from active runtime state.
Maintainers
Readme
Agent Model Switch Guard
一个很小但很实用的运行时状态库,用来避免 agent 在模型切换时“误报成功”。
它专门区分三件事:
- 用户刚刚选择的模型
- 当前 reply cycle 仍在运行的活跃模型
- 新选择真正生效的时机
这能解决很多聊天式 agent 产品里的一个典型问题:
界面或 agent 说“已经切换到 X”,但这一轮回复其实还在用 Y。
这个库解决什么
它把“模型切换”从模糊口径变成显式状态:
selectedactiveactiveDiffersactivationPhase
这样你的产品就可以说:
- 已保存新的模型选择
- 当前活跃运行时仍然是旧模型
- 新选择会在下一次 reply cycle 生效
安装
npm install @wd041216-bit/agent-model-switch-guard核心能力
- 统一 provider/model 引用格式
- 对比 selected model 和 active runtime model
- 生成保守且真实的 ACK 文案
- 生成 session status 需要的说明和结构化字段
适合用在
- 聊天式 agent runtime
/model切换命令- session status 工具
- 模型路由面板
- 回归测试和状态验证
项目来源
这个库最初来自一个真实的 OpenClaw 修复:避免 agent 在主控模型切换时“以为已经切换成功”。现在它被抽成了通用库,便于其他 agent 框架复用。
License
MIT
