upgrade-pi

SkillAI & models

升级pi-agent-core和pi-ai到最新版本

Available today. Use it from your connected AI after setup.

No other account needed.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the upgrade-pi skill

What this skill tells your AI

The instructions your AI receives, as published by maotoumao/cebian in .agents/skills/upgrade-pi/SKILL.md and read by ahel’s review.

帮我调研一下 @earendil-works/pi-agent-core 和 @earendil-works/pi-ai 的最新更新，深入调研我目前安装的版本和最新版本之间的更新内容和细节，确认后，和我讨论能否进行升级。

这是一次调研 + 讨论任务：默认不要改 package.json 或跑安装命令，讨论确认后再动。

这两个包同属 pi monorepo（github.com/earendil-works/pi），变更日志在仓库里，不在 npm release notes，逐版本读、别只看最新一版：

两个 CHANGELOG 都遵循 Keep a Changelog（Breaking Changes / Added / Changed / Fixed / Removed）。重点抓 Breaking Changes。

两个包锁步升级到同一版本。lockfile 里 pi-agent-core 依赖同版本 pi-ai；只升其中一个会造成版本错配。
typebox 跟随 pi，绝不单独升。本项目 package.json 把 typebox 精确锁死（无 ^），就是为了和 pi 内部捆绑的 typebox 完全一致——两边 TSchema 类型标识必须是同一份，否则本项目用 Type.Object(...) 造出来的 schema 传给 pi 校验会类型不兼容，还可能产生两份 typebox 副本。
- 升级 pi 后，去 pnpm-lock.yaml 查 pi 实际解析的 typebox 版本；只有当它变了，才把项目的 typebox 精确 pin 改成同一版本。
- 参考：pi 的 typebox 迁移发生在 0.69.0（@sinclair/typebox 0.34.x → typebox 1.x），此后长期未再动 typebox。
本项目实际用法（评估破坏性变更时以这些为准）：
- Type / Static / TSchema：lib/tools/*、lib/mcp/client.ts 里的 typebox/value 校验器。
- agent runtime：hooks/useBackgroundAgent.ts、lib/agent/、AgentTool 协议（tool 抛错=失败、返回=成功）。

pnpm outdated 看两个包的 Current / Latest。
逐版本读上面两个 CHANGELOG（把 Current→Latest 之间每个版本都覆盖到），重点抓 Breaking Changes 和公开 API 改动。
交叉验证：CHANGELOG 与 npm 版本历史日期是否一致；破坏性变更是否命中本项目实际用法（别人眼里的 breaking 我们可能没用到）。
给结论 + 和我讨论：能否升、要不要顺带动 typebox（按上面约束判断）、升级后需要手动回归哪些链路（发消息 / 流式思考 / 工具调用 / 中止 abort / 模型切换）。默认不改 package.json，确认后再动。

Advanced