@maxiaochao/pi-toolkit 0.13.0 → 0.13.2

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## 2026-10-21 - v0.13.2
+
+- make agent-team user-invoked only and add post-release workflow/npm/tarball verification
+
+## Unreleased
+
+- Make Agent Team user-invoked only through `/skill:agent-team`, hidden from automatic model selection.
+- Add `npm run release:check -- vX.Y.Z` to wait for GitHub publication and verify exact npm versions, remote tags, integrity, and all tarball contents against the release commit, including coordinated child releases.
+
+## 2026-10-21 - v0.13.1
+
+- herdr-subagents v0.7.2: clarify final answer submission through subagent_report
+- Herdr Subagents: clarify that child tasks must finish through `subagent_report`, not a normal text reply; remove the process-exit condition from the report instructions.
+
 ## 2026-10-20 - v0.13.0
 
 - background-tasks v0.1.0: bundle background shell tasks with runtime limits, bounded logs, completion notifications and /bg controls

package/README.md

@@ -77,7 +77,7 @@ bash scripts/install.sh
 | `html-artifact` | Build self-contained HTML explainers and diagrams |
 | `pdlog` | Decompress and inspect Pudu `.pdlog` files |
 | `herdr` | Control Herdr workspaces, tabs, panes, and agents |
-| `agent-team` | Let the main agent dispatch concurrent analysis using configured models and roles, collect results, and maintain investigation records; run extra review rounds as needed |
+| `agent-team` | Manually invoke `/skill:agent-team` for concurrent analysis with configured models and roles, result collection, and investigation records; hidden from automatic model selection |
 | `tapd` | Investigate and operate on TAPD items with workspace, evidence, and safe-download guardrails |
 
 Package-specific skills, such as `pi-worktree`, are documented by their child package.
@@ -85,3 +85,17 @@ Package-specific skills, such as `pi-worktree`, are documented by their child pa
 ## Repository
 
 This repository is an npm workspace. Child implementations live under `packages/*`; `extensions/` contains only the toolkit-only BTW module. Development, testing, media generation, and release rules are documented in [AGENTS.md](AGENTS.md).
+
+### Post-release verification
+
+After pushing a release, run from this checkout:
+
+```bash
+npm run release:check -- v0.13.1
+# Wait up to 15 minutes, polling every 15 seconds:
+npm run release:check -- v0.13.1 --timeout 900 --interval 15
+```
+
+Omit the tag to use the current root `package.json` version. Requires Node.js, Git, npm, tar, authenticated GitHub CLI (`gh auth login`), and local release tags (`git fetch origin --tags` if needed).
+
+The read-only check verifies remote tag commits, waits for the matching `publish.yml` run to succeed, and checks exact public npm versions and tarball integrity. It compares every packaged file and mode against an isolated snapshot of the release tag, including an optional coordinated child release. It uses the tag rather than uncommitted checkout changes, never installs or publishes, and removes temporary downloads. Failures exit nonzero; only a pending workflow or npm `E404` is retried within the shared timeout (600 seconds by default). Local packing uses `--ignore-scripts`, matching this repository's source-only packages; packages that add generated prepack output will need this check updated.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxiaochao/pi-toolkit",
-  "version": "0.13.0",
+  "version": "0.13.2",
   "description": "Personal pi coding agent toolkit: background tasks, scheduler, /btw, /cache_export, apply_patch, browser automation, and bundled theme/skills.",
   "type": "module",
   "workspaces": [
@@ -61,10 +61,11 @@
     "ws": "^8.19.0"
   },
   "scripts": {
-    "test": "node tests/package-layout.mjs && node tests/release-check.mjs && npm --prefix packages/todo test && npm --prefix packages/cache-export test && npm --prefix packages/codex-edit test && npm --prefix packages/herdr-subagents test && npm --prefix packages/openai-account-pool test && npm --prefix packages/scheduler test && npm --prefix packages/background-tasks test && npm --prefix packages/worktree test && node --experimental-strip-types extensions/btw/tests/history.mjs",
-    "test:root": "node tests/package-layout.mjs && node tests/release-check.mjs && node --experimental-strip-types extensions/btw/tests/history.mjs",
+    "test": "node tests/package-layout.mjs && node tests/release-check.mjs && node tests/post-release-check.mjs && npm --prefix packages/todo test && npm --prefix packages/cache-export test && npm --prefix packages/codex-edit test && npm --prefix packages/herdr-subagents test && npm --prefix packages/openai-account-pool test && npm --prefix packages/scheduler test && npm --prefix packages/background-tasks test && npm --prefix packages/worktree test && node --experimental-strip-types extensions/btw/tests/history.mjs",
+    "test:root": "node tests/package-layout.mjs && node tests/release-check.mjs && node tests/post-release-check.mjs && node --experimental-strip-types extensions/btw/tests/history.mjs",
     "load-test": "pi -ne -e ./packages/cache-export/extensions/cache-export.ts && pi -ne -e ./extensions/btw/index.ts && pi -ne -e ./packages/codex-edit/extensions/codex-edit.ts && pi -ne -e ./packages/herdr-subagents/extensions/herdr-subagents.ts && pi -ne -e ./packages/scheduler/extensions/scheduler.ts && pi -ne -e ./packages/background-tasks/extensions/background-tasks.ts && pi -ne -e ./packages/worktree/extensions/worktree.ts && npm --prefix packages/background-tasks run load-test -- --toolkit",
     "load-test:root": "pi -ne -e ./extensions/btw/index.ts",
+    "release:check": "node scripts/post-release-check.mjs",
     "eval:agents": "node evaluations/agents-md/run.mjs",
     "eval:agents:test": "node evaluations/agents-md/tests/run-tests.mjs",
     "postinstall": "node scripts/install-agents.mjs"

package/packages/herdr-subagents/CHANGELOG.md

@@ -1,3 +1,8 @@
+## 2026-10-21 - v0.7.2
+
+- clarify final answer submission through subagent_report
+- Clarify child report instructions: submit the final result through `subagent_report` when work finishes or cannot be completed, rather than tying submission to process exit or ending with a normal text reply.
+
 ## 2026-10-20 - v0.7.1
 
 - clarify Persona responsibilities and dispatch guidance

package/packages/herdr-subagents/README.md

@@ -52,7 +52,7 @@ Cleanup belongs to the Pi session that created the run. Starting a new Pi sessio
 
 ## Result protocol
 
-The child must call `subagent_report` once with a terminal status:
+When the task finishes or cannot be completed, the child must call `subagent_report` once instead of ending with a normal text reply. The terminal status is:
 
 - `completed`: the requested work finished.
 - `failed`: it cannot be completed; include `error`.

package/packages/herdr-subagents/TESTING.md

@@ -17,6 +17,7 @@ It verifies:
 - required explicit Personas in the tool schema and execution, including legacy single-task argument normalization;
 - model-facing role selection guidance for broad independent review, codebase investigation, file-changing work, and charter-driven agent-team execution;
 - effective Persona descriptions in parent listings, corresponding bodies in child system prompts, and unchanged read/write tool boundaries;
+- child system prompts require a terminal `subagent_report` when work finishes or cannot be completed, not a normal text reply or a process-exit condition;
 - rejection of missing, blank, invalid, and unknown Personas before creating runs, while custom Personas remain supported;
 - explicit rejection of parallel write-capable tasks with the conflicting task, Persona, and corrective action;
 - waiting through a delayed authoritative report after a prompt transport error while the Pi process is alive;

package/packages/herdr-subagents/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxiaochao/pi-herdr-subagents",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "Run inspectable interactive Pi subagent batches through Herdr.",
   "type": "module",
   "keywords": [

package/packages/herdr-subagents/src/protocol.ts

@@ -11,7 +11,7 @@ export function reportProtocolPrompt(systemPrompt: string, kind: ReportPromptKin
 		TURN_INTRO[kind],
 		systemPrompt.trim(),
 		"",
-		"Before this process exits, call subagent_report exactly once with a terminal result.",
+		"Submit your final answer by calling the subagent_report tool.",
 		"Put the complete final answer in result, a concise parent-facing paragraph in summary, and list any useful document paths.",
 		"Use status=completed when the task is finished, or status=failed with error when it cannot be completed.",
 		"Do not pause for parent input; make a reasonable assumption or report failed with the missing requirement.",

package/packages/herdr-subagents/tests/core-state-machine.mjs

@@ -155,7 +155,8 @@ async function run(tasks, concurrency, herdr = fakeHerdr(), signal) {
 		const directory = parallel.details.tasks[index].recordDirectory;
 		const instructions = readFileSync(join(directory, "system-prompt.md"), "utf8");
 		assert.ok(instructions.startsWith(personas.get(name).systemPrompt), "Each child must receive its selected Persona body");
-		assert.match(instructions, /call subagent_report exactly once/);
+		assert.ok(instructions.includes("Submit your final answer by calling the subagent_report tool."));
+		assert.doesNotMatch(instructions, /process exits/);
 	}
 
 	const projectAgents = join(root, ".pi", "herdr-subagents", "agents");

package/skills/agent-team/SKILL.md

@@ -1,13 +1,14 @@
 ---
 name: agent-team
-description: 多模型协作分析：主 Agent 按配置的模型和角色调度独立子代理，汇总结果并维护调查档案。用于用户要求多模型分析或对抗评审，或高代价决策需要独立复核时。
+description: 多模型协作分析：按配置的模型和角色调度独立子代理，汇总结果并维护调查档案。
+disable-model-invocation: true
 ---
 
 当前会话是**主 Agent**，负责核心调度：按配置中的模型和角色启动独立子代理，分派用户问题，收集结果并维护调查档案。主 Agent 根据结果决定直接回答、补充核验或继续下一轮。子代理不需要常驻；跨轮连续性来自持久调查档案和逻辑成员身份，而不是聊天记忆。
 
-## 何时值得开
+## 调用方式
 
-用户明确要求多模型分析或对抗评审时开启；主 Agent 也可在结论会驱动高代价动作（改内核、下线设备、向客户定责）时主动开启。查一个事实、读一份文件用不上。
+用户通过 `/skill:agent-team` 显式加载后开启。此 skill 不参与模型自动选择；高代价决策也不构成自动加载或启动的授权。
 
 ## 1. 建立调查档案