pi-cohort 6.1.0 → 6.1.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## [6.1.1] - 2026-09-17
+
+### Fixed
+
+- Child steps with an `outputSchema` now keep the `structured_output` tool when the resolved agent has a tool allowlist (`tools`, `toolsPrepend`, or `toolsAppend` in effect). Previously the allowlist dropped the extension-registered `structured_output` tool while the prompt still instructed the child to call it, so the step could never satisfy its structured output contract.
+
 ## [6.1.0] - 2026-09-12
 
 External execution backends currently require a non-Windows host. Native execution remains supported on Windows.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-cohort",
-  "version": "6.1.0",
+  "version": "6.1.1",
   "description": "Delegate Pi work to focused child agents: code review, scouting, implementation, parallel audits, saved chains, and background jobs.",
   "author": "Jacek Juraszek",
   "license": "MIT",

package/src/runs/shared/pi-args.ts

@@ -3,7 +3,7 @@ import * as os from "node:os";
 import * as path from "node:path";
 import { fileURLToPath } from "node:url";
 import { encodeNestedPathEnv, parseNestedPathEnv, type NestedPathEntry } from "./nested-path.ts";
-import { STRUCTURED_OUTPUT_CAPTURE_ENV, STRUCTURED_OUTPUT_SCHEMA_ENV } from "./structured-output.ts";
+import { STRUCTURED_OUTPUT_CAPTURE_ENV, STRUCTURED_OUTPUT_SCHEMA_ENV, STRUCTURED_OUTPUT_TOOL_NAME } from "./structured-output.ts";
 import type { JsonSchemaObject } from "../../shared/types.ts";
 
 const THINKING_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh"];
@@ -116,6 +116,11 @@ export function buildPiArgs(input: BuildPiArgsInput, fileSystem: BuildPiArgsFile
 			}
 		}
 		if (builtinTools.length > 0) {
+			// The prompt runtime registers structured_output on demand; an allowlist
+			// without it would strand the tool the child is instructed to call.
+			if (input.structuredOutput && !builtinTools.includes(STRUCTURED_OUTPUT_TOOL_NAME)) {
+				builtinTools.push(STRUCTURED_OUTPUT_TOOL_NAME);
+			}
 			args.push("--tools", builtinTools.join(","));
 		}
 	}

package/src/runs/shared/structured-output.ts

@@ -6,6 +6,9 @@ import type { JsonSchemaObject } from "../../shared/types.ts";
 
 export const STRUCTURED_OUTPUT_SCHEMA_ENV = "PI_SUBAGENT_STRUCTURED_OUTPUT_SCHEMA";
 export const STRUCTURED_OUTPUT_CAPTURE_ENV = "PI_SUBAGENT_STRUCTURED_OUTPUT_CAPTURE";
+// Registered by subagent-prompt-runtime.ts whenever the capture env is set; child
+// `--tools` allowlists must keep this name or the tool is filtered out of the toolbelt.
+export const STRUCTURED_OUTPUT_TOOL_NAME = "structured_output";
 
 export interface StructuredOutputRuntime {
 	schema: JsonSchemaObject;

package/src/runs/shared/subagent-prompt-runtime.ts

@@ -2,7 +2,7 @@ import * as fs from "node:fs";
 import * as path from "node:path";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { SUBAGENT_FANOUT_CHILD_ENV } from "./pi-args.ts";
-import { STRUCTURED_OUTPUT_CAPTURE_ENV, STRUCTURED_OUTPUT_SCHEMA_ENV, validateStructuredOutputValue } from "./structured-output.ts";
+import { STRUCTURED_OUTPUT_CAPTURE_ENV, STRUCTURED_OUTPUT_SCHEMA_ENV, STRUCTURED_OUTPUT_TOOL_NAME, validateStructuredOutputValue } from "./structured-output.ts";
 import type { JsonSchemaObject } from "../../shared/types.ts";
 
 const SUBAGENT_INHERIT_PROJECT_CONTEXT_ENV = "PI_SUBAGENT_INHERIT_PROJECT_CONTEXT";
@@ -10,7 +10,7 @@ const SUBAGENT_INHERIT_SKILLS_ENV = "PI_SUBAGENT_INHERIT_SKILLS";
 
 const STRUCTURED_OUTPUT_INSTRUCTIONS = [
 	"This subagent step has a strict structured output contract.",
-	"Your final action must be to call the `structured_output` tool with JSON matching the provided schema.",
+	"Your final action must be to call the `" + STRUCTURED_OUTPUT_TOOL_NAME + "` tool with JSON matching the provided schema.",
 	"Do not rely on prose-only completion; if you do not call `structured_output`, the parent will fail this step.",
 ].join("\n");
 
@@ -194,7 +194,7 @@ export default function registerSubagentPromptRuntime(pi: ExtensionAPI): void {
 			execute: (_id: string, params: { value: unknown }) => Promise<unknown>;
 		}) => void;
 		registerTool({
-			name: "structured_output",
+			name: STRUCTURED_OUTPUT_TOOL_NAME,
 			label: "Structured Output",
 			description: "Submit the required final structured output for this subagent step. This terminates the step.",
 			parameters: parameters as never,