pi-ptc-subagents 6.1.0 → 6.2.0

package/dist/index.js

@@ -1,9 +1,9 @@
 import { getAgentDir } from "@earendil-works/pi-coding-agent";
 import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
+import { execSync, spawn } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import { mkdir, open, readFile, rename, writeFile } from "node:fs/promises";
-import { spawn } from "node:child_process";
 import { gunzipSync, gzip } from "node:zlib";
 import { promisify } from "node:util";
 import { fileURLToPath } from "node:url";
@@ -3062,6 +3062,7 @@ const REPORT_CONTRACT_BLOCK = [
 	"```json",
 	"{ \"summary\": \"one sentence conclusion\", \"findings\": [{ \"what\": \"claim\", \"evidence\": \"where it comes from\" }], \"files_touched\": [\"relative/path\"], \"usage\": { \"input\": 0, \"output\": 0, \"cost\": 0, \"turns\": 0 } }",
 	"```",
+	"Rules: \"summary\" is your deliverable — answer the task asked, in one sentence. \"findings\" carries load-bearing evidence only; never recap content you merely read. Do NOT write report/summary .md files — your final message is what the parent reads.",
 	"findings/files_touched/usage may be omitted when empty. Your prose answer stays; the report is checked alongside it.",
 	"</child-report-contract>"
 ].join("\n");
@@ -3132,6 +3133,14 @@ function spawnChild(argv, env = process.env) {
 function escapeXmlText(text) {
 	return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
 }
+function supportsNoMcp(piVersion) {
+	if (!piVersion) return false;
+	const [major = "0", minor = "0"] = piVersion.trim().replace(/^v/, "").split(".");
+	const M = Number.parseInt(major, 10);
+	const m = Number.parseInt(minor, 10);
+	if (Number.isNaN(M) || Number.isNaN(m)) return false;
+	return M > 1 || M === 1 && m >= 1;
+}
 function buildPiArgv(input, context) {
 	const argv = [
 		"pi",
@@ -3148,6 +3157,8 @@ function buildPiArgv(input, context) {
 			"</pi-ptc-context>"
 		].filter(Boolean).join("\n")
 	];
+	argv.push("--no-extensions", "--no-skills");
+	if (supportsNoMcp(context.piVersion)) argv.push("--no-mcp");
 	const model = input.model ?? input.agentModel ?? context.sessionModel;
 	const thinking = input.thinkingLevel ?? input.agentThinkingLevel;
 	if (model) argv.push("--model", thinking ? `${model}:${thinking}` : model);
@@ -3235,6 +3246,8 @@ function parseChildStream(stdout) {
 				observedUsage = {
 					input: message.usage.input,
 					output: message.usage.output,
+					...message.usage.cacheRead !== void 0 ? { cacheRead: message.usage.cacheRead } : {},
+					...message.usage.cacheWrite !== void 0 ? { cacheWrite: message.usage.cacheWrite } : {},
 					...cost !== void 0 ? { cost } : {}
 				};
 			}
@@ -4964,6 +4977,7 @@ function assemblePtcSession(options = {}) {
 		registry,
 		gates: options.gates,
 		whyEnabled: options.whyEnabled,
+		context: options.context,
 		...options.engine
 	});
 	return {
@@ -4994,6 +5008,20 @@ const textResult = (value) => ({
 const packageRoot = fileURLToPath(new URL("..", import.meta.url));
 const publishedDetailDir = join(packageRoot, "docs", "routes");
 const detailDir = existsSync(publishedDetailDir) ? publishedDetailDir : join(packageRoot, "..", "routes", "docs", "routes");
+function resolvePiVersion() {
+	try {
+		return execSync("pi --version", {
+			encoding: "utf8",
+			stdio: [
+				"ignore",
+				"pipe",
+				"ignore"
+			]
+		}).trim() || void 0;
+	} catch {
+		return;
+	}
+}
 function piPtcEntry(pi) {
 	pi.on("session_start", (_event, ctx) => {
 		if (Number(process.env.PI_PTC_DEPTH ?? 0) > 0) {
@@ -5034,6 +5062,7 @@ function piPtcEntry(pi) {
 			userDir: join(getAgentDir(), "agents"),
 			projectDir: join(process.cwd(), ".pi", "agents")
 		};
+		const piVersion = resolvePiVersion();
 		let session;
 		const faceAddedByUs = /* @__PURE__ */ new Set();
 		const applyTaskFaceVisibility = () => {
@@ -5055,6 +5084,10 @@ function piPtcEntry(pi) {
 		session = assemblePtcSession({
 			onTransition: () => applyTaskFaceVisibility(),
 			whyEnabled: () => whyEnabledOverride ?? whyEnabledPersisted,
+			context: {
+				depth: 0,
+				piVersion
+			},
 			engine: {
 				notifications,
 				resolveAgent: (name, scope) => findAgent(name, agentDirs, scope),

package/docs/routes/create-a-task.md

@@ -13,3 +13,14 @@ agent 定义里的 `tools / model / thinkingLevel / childReport` 由 frontmatter
 
 任务建成后在任务记录里排队（满员排队不拒绝，ADR-0010），经
 `ptc_task_list / ptc_task_output / ptc_task_stop` 查/停。
+
+## Briefing 纪律（省 token，派发前自查）
+
+- **给确切路径、命令、决策**：孩子看不到父会话。task 里写死一个路径，省孩子一轮探索
+  （每轮探索 = 一次工具调用结果 + 推理 token）。
+- **写明最终消息要带回什么**：孩子只回一次。要什么格式、哪些字段，task 里说清。
+- **不确定能否一次搜中才派**：目标明确（已知路径、已知行号）的活别派，主会话直接
+  `tools.read` 更省。
+- **同域的活合并给一个串行孩子**：每个孩子都付一份固定 harness 税（系统提示词 +
+  项目上下文）。多个重叠的小活拆并行 = 同一份探索被付费多次。
+- **孩子不写报告文件**：交付物就是最终消息（含报告 JSON 块），落盘 .md 是浪费。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-ptc-subagents",
-  "version": "6.1.0",
+  "version": "6.2.0",
   "description": "Programmable tool calling (PTC) and subagent fan-out for pi",
   "keywords": [
     "pi",
@@ -30,10 +30,12 @@
     ".": "./dist/index.js"
   },
   "scripts": {
-    "build": "pnpm -r run build",
+    "build": "pnpm -r --filter=!@pi-ptc/website run build",
     "prepack": "pnpm run build && rm -rf dist docs/routes && cp -R packages/entry/dist dist && cp -R packages/routes/docs/routes docs/routes",
-    "check": "pnpm -r run check",
+    "check": "pnpm -r --filter=!@pi-ptc/website run check",
     "lint": "oxlint",
+    "test": "node --test tests/*.test.mjs",
+    "pretest": "pnpm run build",
     "fmt": "oxfmt",
     "fmt:check": "oxfmt --check"
   },