@zhushanwen/pi-session-manager

agent-managed session pi extension：把 session 的创建/发送/读取/列表/状态/中止交给 agent 自主管理——agent 通过 6 个工具以子 session 形态并行工作，父 session 统一编排。

通道契约

• 工具调用经 ctx.ui.select(SESSION_MANAGER_MARKER, [JSON], {timeout}) 发出，超时按 action 分档（create/history 60s、其余 30s，SSOT 在 src/index.ts 的 SELECT_TIMEOUT_MS）；marker 为 \x00TAIJI_SESSION_MANAGER（NUL 前缀防与普通 select title 冲突，SSOT 在 @zhushanwen/extension-protocol）
• 请求体为嵌套形状 { action, params }（形状 SSOT 在 @zhushanwen/extension-protocol）；不要扁平化展开——runtime event-adapter 按 data.params 提取，扁平化会导致 params 丢失
• 应答方是 taiji runtime 的 SessionManagerHandler（select value 通道回写 JSON 字符串；取消/超时返回 null）

工具（6 个工具，每工具 1 个 action）

工具	action	说明
create_managed_session	create	在指定 cwd 创建子 session（可选 label；可选 prompt 作初始 prompt，create+send 原子完成）；服务端注入 spawnSource: 'agent' 与父 session id，.agent.json sidecar 落盘供重启恢复
send_to_session	send	向子 session 发送 prompt（异步处理）
read_session_history	history	读子 session 对话历史（可选 tailTurns 截尾部 N 个 turn）
list_my_sessions	list	列出本 agent 管理的 session（无过滤参数，自动限定发起方 agent）
get_session_status	status	查询子 session 状态与模型信息
abort_session	abort	中止运行中的子 session

运行要求

应答端（runtime handler）在 taiji 桌面应用内；独立 pi CLI 环境无 handler 应答，工具会等待至超时（create/history 60s、其余 30s）后返回 isError 错误结果（文案 cancelled or timed out——pi 实装对取消与超时不可区分，见 protocol callMarkerRpc）。

安装

pi install npm:@zhushanwen/pi-session-manager

测试

cd extensions/universal/session-manager && npx vitest run