You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
[pi] 内置 billion-context-pi-subagents(acp_delegate)进 Pi lane:官方自有 subagents 支持 #2186
⚠️omp 门控必须:src/agent/pi.ts 的工厂同时服务 pi 与 omp(dist/agent/omp.js),delegate 是 pi 专属(pi CLI spawn、--mode json、pi-tui)→ 需按宿主探测只在 pi 注册,omp lane 不得出现 delegate 工具。
Embeds billion-context-pi-subagents (0.1.1, just published via package PR #2 + release PR #4) into the native pi extension through the package's embedder contract (markEmbedded() + manual building-block wiring + tsup inline). pi lane only; omp untouched; zero new config surface; dist/index.js/dist/mcp.js import graph unchanged.
Activity
ranxianglei commentedon Oct 5, 2026
结论先行:硬阻塞核实成立,当前卡在一个我无法代劳的人为动作上——
billion-context-pi-subagents还没上 npm,而发版链上两步都需要 owner 手动完成。npm 可见后我可以立即开工实现 + PR。已核实的事实(带证据)
billion-context-pi-subagents404(未发布)。mergeable: clean;master 已带 version 0.1.0;release.yml/release-manual.yml随该 PR 分支落地(master 目前只有ci.yml)——即合并即触发发布流程。NPM_TOKEN未配置。PR fix: keep system prompt byte-stable for prefix cache #1 正文自己也标注了这一点("BLOCKER before merge")。不配 secret 就合并,publish 步骤会在 pre-flight 通过后失败。acp_delegate/billion-context-pi-subagents引用——干净起点,无并行工作。可行性核对(bili 侧,逐条对照 issue 断言)
src/agent/pi.ts的共享工厂createBiliPlugin(agentOverride?)同时服务 pi 与 omp——launcher 模式经-e dist/agent/pi.js(launcher.ts:4346)、native 模式经 package.jsonpimanifest →dist/agent/pi-native.js,两者 agent 均为"pi";omp 的两个 entry(omp.ts/omp-native.ts)显式传"omp"。omp 门控有天然落点:delegate 注册接进工厂并以agent === "pi"门控,一次覆盖 pi 两条加载路径、排除 omp 两条。isPiHost(ctx.sessionManager)(要求 Pi 的buildContextEntries()API)门控,omp 天然不满足 → 不注册并一次性告警(PI_ACP_FORK_HOST=1可 opt-in)。显式门控 + 宿主探测两层都在。tsup.config.ts的noExternal已有 acp-kernel 等内联先例;把新包加入其中只影响 import 它的 agent entry,dist/index.js保持零依赖(zod 同款先例成立)。devDep 精确钉0.1.0,NEVER caret。markEmbedded()(globalThisSymbol.for标记,用户单独安装的副本在 session_start 让位)、building-blocks 再导出(makeDelegateTool三件套、resolveDelegate、delegateStatusWidget、openFleetInspector、fix: wire search_context to the kernel search engine (blocks + visible messages, CJK) #415 的findPiSubagentsInstallsstand-down 检测等)齐备。@earendil-works/pi-coding-agent/@earendil-works/pi-tui/typebox的类型(peerDeps 为*)。bili tsconfig 有skipLibCheck: true不会硬炸,但为了让 typecheck 真正有效,devDependencies 需同步精确钉这三个类型源(@earendil-works/pi-coding-agent@0.83.0等,与包 devDeps 对齐)。delegate.*继续由包从~/.pi/acp.json读取,PI_ACP_DELEGATE_*env 也归包所有,bili 配置面零变化(PR 里会按规范声明)。顺带发现(供全局视角,不阻塞本 issue)
billion-context-pi#613 的当前 diff 仍是"整体移除 delegate + README 引导用户单独安装"形态,没有加 devDep(package.json 不在其 diff 里)——与本 issue 引用的裁定("主包 devDep 精确钉版 + tsup 内联")不一致。subagents#1 正文称嵌入面是 "needed by billion-context-pi's follow-up",推测 #613 的钉版部分是后续再补;如果属实,#613 按现状合并会让 BCP 用户丢失内置 acp_delegate(行为变更)。不影响本 issue——bili 直接钉 npm 版本,与 BCP 侧解耦。
计划(npm 可见后立即执行)
2026-MM-DD_builtin-pi-subagents:devDep 精确钉版(+ 类型依赖)、tsupnoExternal加包名、工厂内agent === "pi"门控接线(load 期markEmbedded())。tests/e2e/e2e-native-pi.test.ts覆盖验收四条(delegate 子代理具名压缩生效 / omp 不注册 / 双装无重复 / 与 @gotgenes/pi-subagents 共存)。全量回归交 CI。Closes #2186,正文含 config-surface 声明(零新增)。npm ci必然 404,所以等 npm 可见后 lockfile + push + PR 一步到位。需要 owner 的动作(顺序)
NPM_TOKEN(与 billion-context-pi 相同值);ranxianglei commentedon Oct 5, 2026
补充一条本地验证发现的新硬约束(issue 可行性一节未预见),影响实现方案,请裁定。
发现:包 dist 携带一个运行时宿主裸导入
我把 subagents 包源码 clone 下来实际构建 + 做了 esbuild 内联探针(等价于 bili tsup
noExternal的打包路径):dist/index.js是 448KB 单文件 ESM:typebox、pi-tui(fleet-inspector 的运行时依赖)都已内联;唯一残留的运行时裸导入是import * as piModule from "@earendil-works/pi-coding-agent",来自src/config-dir.ts——读CONFIG_DIR_NAME(带".pi"兜底,fix: surface raw-dump failures and rate-limit telemetry path noise (#362) #364 的宿主特性探测)。其余两处引用均无害:delegate-tool.ts对 pi-coding-agent 是纯import type(编译擦除),fleet-inspector.ts的 pi-tui 已打进 dist。Dynamic require of "child_process" is not supported(bili tsup 现有的 createRequire banner 能救,但代价是每个 entry +12MB 及宿主包 import-time 副作用风险)。src/agent/pi.ts静态引入该包,四个 entry(pi.js / pi-native.js / omp.js / omp-native.js)都会带上这个裸导入。pi lane 有 billion-context-pi 的生产先例(BCP 的 dist 同样保留该裸导入且正常工作),但 omp lane 与混合安装前缀场景无保证,且直接违反 bili 明文不变量(src/agent/pi.ts头部:"the bundled artifact imports NOTHING from the host at runtime")。三个选项
config-dir.ts改为 createRequire 探测 + try/catch(保留 #364 语义:宿主可解析时取CONFIG_DIR_NAME,否则".pi"),diff 约 15 行、对独立安装/pi 用户零行为变化 → dist 零裸导入 → bili 按原计划 acp-kernel 同款内联,四个 entry 全干净、零新增运行时依赖dependencies(真实运行时依赖)+ tsup 保持 external + 仅 pi 门控下动态 import推荐 A:两边契约都不破,issue 原前提("acp-kernel 同款内联模式可行")恢复成立,修复面极小。注意 BCP#613 不受此发现影响(BCP 自身 dist 本就带同样的宿主裸导入,该修复对它只是去冗余)。
修订后的动作清单(owner)
NPM_TOKENsecret(不变);npm 可见后在本 issue 触发我,我按上一条回复的计划交付 bili 侧实现 + PR。未获批准前我不会向该仓库提交任何东西。
ranxianglei commentedon Oct 6, 2026
Implementation PR: #2221
Embeds
billion-context-pi-subagents(0.1.1, just published via package PR #2 + release PR #4) into the native pi extension through the package's embedder contract (markEmbedded()+ manual building-block wiring + tsup inline). pi lane only; omp untouched; zero new config surface;dist/index.js/dist/mcp.jsimport graph unchanged.feat: inline billion-context-pi-subagents into the pi lane (#2186)
fix(tests): model pi's multi-listener event dispatch in the plugin-ag…
test(pi-subagents): exercise the fleet policy gate and #415 stand-down (
fix(pi-subagents): log config-load failure instead of swallowing it s…
ranxianglei commentedon Oct 6, 2026
[bot] 🏷
PR #2221 review 完成。一句话:方向正确、实现扎实;CI 四腿红的根因是一个测试 fake 对宿主事件模型建模错误(已定位并修复),另有几处小缺陷顺手修掉。三个修复 commit 已推到分支
2026-10-05_pi-subagents-embed(bacabf434、59969fba1、78c5d6538)。① 原 issue 方向:#2186 要求把官方 subagents 内置进 Pi lane。PR 用包内嵌契约(markEmbedded + building-blocks 手动接线 + tsup inline)精确实现,omp 门控排除、零新增配置面——方向与 issue 一致。实现路线(v0.1.1 补导出 + tsup alias stub 掉唯一宿主 import)不同于我在线程里建议的包侧切割,但效果等价且保持包独立形态,接受裁定。
② CI 四条测试腿全红的根因(每腿失败同一例:
#2072 … timed out waiting for the acp_cache tool):tests/issue2072-native-caller-stamping.test.ts的 fake 把pi.on(event, handler)建模成单槽 Map,而真实 pi 是多监听者广播(按注册顺序派发给所有 handler)。bili 工厂本身已有两个 session_start 注册(repin + registerTools——acp_cache 就是它注册的);本 PR 的接线加了第三个(最后注册)→ 单槽 fake 只剩最后一个 → registerTools 永不执行 → acp_cache 超时。wiring 代码无缺陷,是合法的第三注册暴露了 fake 对宿主的错误建模。你已修好这个文件(3e51990,数组模型,引 pi-coding-agent@0.83.0 runner.js emit()——比我最初的组合写法更忠实)。还有一颗孪生地雷:
tests/plugin-agent.test.ts的 fake 同样是单槽(且 ~20 个 fire-site)。今天能过只是因为它现有断言不依赖主 session_start 的副作用,未来一旦依赖会以同样方式炸。已在 commit 1 修(原地组合、最小 diff)。③ 其他小缺陷(已直接修):
tests/pi-subagents-wiring.test.ts的「fleet policy gate」测试从未真正调用过 handler(fake 不存 command options,注释自认)——假测试,且 PR body 把它宣称成了已测。重写为真实驱动 handler(delegate.enabled=false→ 断言通知文案);并补上 fix: wire search_context to the kernel search engine (blocks + visible messages, CJK) #415 project-scope stand-down 测试(tools 不注册 + 一条 warning toast)(commit 2)。src/agent/pi-subagents.ts静默吞掉 acp.json 加载失败(catch {})——独立包装会 logThrow,嵌入版丢失全部诊断。改为 console.error(agent 模块 house style,同 opencode.ts/pi.ts)(commit 3)。④ 回归清点(diff 触碰路径的既有行为):
dist/index.js零依赖不变量:base vs head 字节尺寸一致(4,071,834 B),所有 dist entry 均无裸宿主 import ✓dist/mcp.jsimport graph 不变 ✓agent !== "pi"early return 门控)✓/acp_delegate、_wait、_cancel工具 +/acp-fleet命令 + shortcut + prompt append(包默认 enabled=true)——即本 PR 的预期功能。⑤ 缓存:不涉及(未触碰缓存/重试/游标/去重键)。
⑥ 设计方向:不变——按你裁定的 embedder contract 走,无架构转向。
⑦ 新配置:无。delegate 配置留在包既有的
~/.pi/acp.json面(env > project > global > default 优先级不变),未新增任何 bili 配置字段或 env var——符合 #1437 纪律。遗留一项缺口(建议本线程内后续做,不单拆 issue):验收标准 1「delegate 子代理各自具名压缩生效」目前没有自动化覆盖——CI 里过的「real pi package-native lane」只证明不回归(该套件不脚本化 delegate 调用)。建议后续加一条 hermetic e2e:驱动一次真实 acp_delegate 调用,断言子代理 sessionId 绑定具名 plugin-mode 压缩会话。
结论(七问):是什么问题——PR review + CI 红腿定位;什么原因——测试 fake 单槽建模 vs 宿主多监听广播;怎么修的——fake 忠实化(owner 数组模型 + 我修孪生 fake)+ 假测试重写 + #415 覆盖 + 配置失败日志;是否回归——产品行为零回归(零依赖不变量字节级验证),bundle 体积变化已披露;缓存——不涉及;设计方向——不变;新配置——无。可合,待
78c5d6538上 CI 转绿后由你合并:#2221ranxianglei commentedon Oct 6, 2026
[bot] 🏷
CI 在
78c5d6538上全绿:四条测试腿(ubuntu/windows × node 22/24)✅、e2e-native-pi(真实 pi package-native lane)✅、lane-guard / kernel-guard / version-guard / docs ✅。之前红腿的#2072 acp_cache timeout已随 fake 修复消失。PR #2221 现在可以合并了(合并留给你):#2221
Merge pull request #2221 from ranxianglei/2026-10-05_pi-subagents-embed
fix(tests): multi-handler fake Pi — #2186's second session_start hand…
fix: pi-subagent-registry fake stores per-event handler arrays (ranxi…