@maxiaochao/pi-toolkit 0.12.2 → 0.13.1

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");