pi-improve-interation

Companion enhancement layer over pi-subagents (and future open-source pi packages) — adapter framework for orchestration add-ons, no fork required

Packages

Package details

extension

Install pi-improve-interation from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-improve-interation
Package
pi-improve-interation
Version
0.0.2
Published
Sep 12, 2026
Downloads
198/mo · 171/wk
Author
mktagi
License
MIT
Types
extension
Size
9 MB
Dependencies
1 dependency · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-improve-interation

English | 中文

Summary

给 pi 原生与上游 pi 插件已有交互叠加增强的伴生包。交互不变，能力更强。

  • 不 fork 上游：只走宿主公开扩展 API，上游升级最多改一处 adapter
  • 不引入平行概念：增强的就是你已经在敲的 @、已经在派的活

增强了什么

当前增强对象是 pi-subagents（子 agent 编排包）：

场景 之前 之后
输入框敲 @ 只有文件补全 同时补全 agent（@rev → @agent:reviewer，含内置 + 你的自定义 agents）
派活给子 agent 自己拼 subagent 调用话术 直接写 @agent:<name> <任务>，扩展自动转成显式委派指令
怀疑增强层没接上 翻配置、看日志 /plus-doctor 一条命令定位

如何安装

pi install npm:pi-subagents             # 前置
pi install npm:pi-improve-interation

重启 pi，敲 /plus-doctor。看到 OK pi-subagents (pi-subagents): delegation event transport resolved … 即接线成功。

本地开发装法：pi install /path/to/pi-improve-interation

贡献

本包按 adapter 组织：每个被增强的上游包对应一个 PluginAdapter（probe 只返回诊断、永不抛错），增强功能宿主无关。

extensions/plus.ts          pi 扩展入口：/plus-doctor、@ 面板、input 转换
src/adapters/types.ts       PluginAdapter 契约（唯一来源）
src/adapters/index.ts       adapter 注册表
src/adapters/pi-subagents/  当前唯一 adapter

给下一个插件加增强：

  1. 实现 src/adapters/<pkg>/，契约见 src/adapters/types.ts（probe 永不抛错，只返回诊断）
  2. 追加进 src/adapters/index.ts，在 test/wiring.test.ts 补一条注册表断言
  3. npm run typecheck && npm test

Roadmap（欢迎认领）：

  • delegation event transport 编排增强（进度可见、重试、预算控制）
  • 第二个 adapter

License

MIT