pi-ptc-subagents 7.2.0 → 7.4.0

package/dist/index.js

@@ -1,9 +1,10 @@
+import * as piHost from "@earendil-works/pi-coding-agent";
 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 { mkdir, open, readFile, readdir, rename, writeFile } from "node:fs/promises";
 import { gunzipSync, gzip } from "node:zlib";
 import { promisify } from "node:util";
 import { fileURLToPath } from "node:url";
@@ -2746,6 +2747,15 @@ const TERMINAL_STATUSES = [
 	"canceled",
 	"lost"
 ];
+const TASK_STATUSES = [
+	"queued",
+	"running",
+	"stopping",
+	"succeeded",
+	"failed",
+	"canceled",
+	"lost"
+];
 function isTerminal(status) {
 	return TERMINAL_STATUSES.includes(status);
 }
@@ -3341,6 +3351,47 @@ var NotificationCenter = class {
 function isTerminalStatus(status) {
 	return status === "succeeded" || status === "failed" || status === "canceled" || status === "lost";
 }
+/** 护栏的检查间隔（秒级问一次就够——阈值本身是分钟量级） */
+const STALL_CHECK_INTERVAL_MS = 1e3;
+var ChildActivityTracker = class {
+	#buffer = "";
+	#lastActivityAt;
+	/** 在飞的工具调用计数（嵌套调用靠计数，不靠集合——start/end 成对进出） */
+	#toolOpen = 0;
+	#now;
+	constructor(now = Date.now) {
+		this.#now = now;
+		this.#lastActivityAt = now();
+	}
+	/** 喂一段 stdout 增量（chunk 边界不按行切 ⇒ 自己攒半行） */
+	push(chunk) {
+		this.#lastActivityAt = this.#now();
+		this.#buffer += chunk;
+		let index = this.#buffer.indexOf("\n");
+		while (index >= 0) {
+			this.#consume(this.#buffer.slice(0, index));
+			this.#buffer = this.#buffer.slice(index + 1);
+			index = this.#buffer.indexOf("\n");
+		}
+	}
+	/** 两条都成立 ⇒ 孩子什么都没在做 */
+	isStalled(now, thresholdMs) {
+		if (this.#toolOpen > 0) return false;
+		return now - this.#lastActivityAt >= thresholdMs;
+	}
+	#consume(line) {
+		const trimmed = line.trim();
+		if (!trimmed.includes("\"tool_execution_start\"") && !trimmed.includes("\"tool_execution_end\"")) return;
+		let event;
+		try {
+			event = JSON.parse(trimmed);
+		} catch {
+			return;
+		}
+		if (event.type === "tool_execution_start") this.#toolOpen++;
+		else if (event.type === "tool_execution_end") this.#toolOpen = Math.max(0, this.#toolOpen - 1);
+	}
+};
 // ../dispatch/src/engine.ts
 const DEFAULT_STOP_GRACE_MS = 5e3;
 const STDOUT_KEEP_CHARS = 16777216;
@@ -3382,6 +3433,7 @@ var TaskEngine = class {
 	#terminalRecordKeep;
 	#archiveEnabled;
 	#archiveTtlDays;
+	#stallMs;
 	#purgeTail = Promise.resolve();
 	#children = /* @__PURE__ */ new Map();
 	#ending = false;
@@ -3404,6 +3456,7 @@ var TaskEngine = class {
 		this.#terminalRecordKeep = options.terminalRecordKeep ?? DEFAULT_TERMINAL_RECORD_KEEP;
 		this.#archiveEnabled = options.archiveEnabled ?? true;
 		this.#archiveTtlDays = options.archiveTtlDays ?? DEFAULT_ARCHIVE_TTL_DAYS;
+		this.#stallMs = options.stallMs ?? 3e5;
 		this.#ready = options.storageDir ? this.#restore(options.storageDir) : Promise.resolve();
 		this.#stopGraceMs = options.stopGraceMs ?? DEFAULT_STOP_GRACE_MS;
 		const whyOpt = options.whyEnabled;
@@ -3443,7 +3496,8 @@ var TaskEngine = class {
 				label: input.label,
 				whySuppressed,
 				ownerPid: this.#owner.pid,
-				ownerBootMs: this.#owner.bootMs
+				ownerBootMs: this.#owner.bootMs,
+				sessionId: this.#context.sessionId
 			}
 		}).then(async () => {
 			if (input.wait) {
@@ -3539,9 +3593,16 @@ var TaskEngine = class {
 			this.stop(taskId, `timeout after ${timeoutMs}ms`);
 		}, timeoutMs) : void 0;
 		timer?.unref();
+		const activity = new ChildActivityTracker();
+		const stallMs = this.#stallMs > 0 ? this.#stallMs : void 0;
+		const stallGuard = stallMs ? setInterval(() => {
+			if (activity.isStalled(Date.now(), stallMs)) this.stop(taskId, `stalled: no activity for ${stallMs}ms`);
+		}, Math.min(STALL_CHECK_INTERVAL_MS, stallMs)) : void 0;
+		stallGuard?.unref();
 		let text = "";
 		let outputTruncated = false;
 		child.onOutput((chunk) => {
+			activity.push(chunk);
 			text += chunk;
 			if (text.length > STDOUT_KEEP_CHARS) {
 				text = text.slice(-16777216);
@@ -3552,6 +3613,7 @@ var TaskEngine = class {
 			child.onExit((code) => resolveExit(code));
 		});
 		if (timer) clearTimeout(timer);
+		if (stallGuard) clearInterval(stallGuard);
 		this.#children.delete(taskId);
 		const outputPath = await this.#output.write(taskId, text);
 		const parsed = parseChildStream(text);
@@ -3700,6 +3762,23 @@ var TaskEngine = class {
 			return Promise.resolve(void 0);
 		}
 	}
+	/** 归档区的全部记录（冷存按 id 存 gz）——scope=all 时一次列出；异步读，不堵宿主事件循环 */
+	async readArchivedRecords() {
+		const dir = this.#storageDir ? join(this.#storageDir, "archive") : null;
+		if (!dir || !existsSync(dir)) return [];
+		const out = [];
+		for (const file of await readdir(dir)) {
+			if (!file.endsWith(".json.gz")) continue;
+			try {
+				const parsed = JSON.parse(gunzipSync(await readFile(join(dir, file))).toString("utf8"));
+				if (parsed && typeof parsed.id === "string") out.push({
+					...parsed,
+					archived: true
+				});
+			} catch {}
+		}
+		return out;
+	}
 	#readArchivedOutput(taskId) {
 		const file = this.#storageDir ? join(this.#storageDir, "archive", `${taskId}.output.gz`) : null;
 		if (!file || !existsSync(file)) return void 0;
@@ -3826,152 +3905,547 @@ var TaskEngine = class {
 		await this.#purgeTail.catch(() => void 0);
 	}
 };
-// ../search/src/provider.ts
-const SEARCH_COUNT_RANGE = {
-	min: 1,
-	max: 50
+// ../tui/src/bounds.ts
+const RENDER_BOUNDS = {
+	MAX_LOG_LINES_EXPANDED: 12,
+	VALUE_TREE_MAX_DEPTH: 4,
+	VALUE_TREE_MAX_CHILDREN: 6,
+	VALUE_TREE_MAX_LINE_CHARS: 120
 };
-const SEARCH_MEMORY_MAX_CHARS = 4e5;
-// ../search/src/deepseek.ts
-const API_BASE = "https://api.deepseek.com/v1/tools";
-function retryHint(status) {
-	if (status === 402) return "账号余额不足：充值后再试";
-	if (status === 408 || status === 429 || status >= 500) return "临时性失败：稍后重试";
-	if (status >= 400) return "请求不合法：修改请求后再试（原样重试无益）";
-	if (status === 0) return "网络不可达：检查连接后重试";
-	return "";
+// ../tui/src/text.ts
+const ANSI_PATTERN = /\x1B\[[0-9:;<=>?]*[ -/]*[@-~]|\x1B\][^\x07\x1B]*(?:\x07|\x1B\\)|[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g;
+function stripAnsi(text) {
+	return text.replace(ANSI_PATTERN, "");
 }
-function redact(text, apiKey) {
-	return apiKey ? text.split(apiKey).join("[REDACTED]") : text;
+function sanitizeText(text) {
+	return stripAnsi(text.replace(/\r/g, ""));
 }
-async function postJson(path, body, apiKey) {
-	let response;
-	try {
-		response = await fetch(`${API_BASE}${path}`, {
-			method: "POST",
-			headers: {
-				Authorization: `Bearer ${apiKey}`,
-				"Content-Type": "application/json"
-			},
-			body: JSON.stringify(body),
-			signal: AbortSignal.timeout(3e4)
-		});
-	} catch (error) {
-		return {
-			ok: false,
-			status: 0,
-			error: `network: ${error instanceof Error ? error.message : String(error)}`
-		};
+const MAX_LINE_CHARS = RENDER_BOUNDS.VALUE_TREE_MAX_LINE_CHARS;
+function truncateLine(line, maxChars = MAX_LINE_CHARS) {
+	if (line.length <= maxChars) return line;
+	let cut = maxChars;
+	while (cut > 0 && (line.charCodeAt(cut) & 64512) === 56320) cut--;
+	return `${line.slice(0, cut)}…`;
+}
+function renderModelValue(value, depth = 0, seen = /* @__PURE__ */ new WeakSet()) {
+	const pad = "  ".repeat(depth);
+	if (depth >= RENDER_BOUNDS.VALUE_TREE_MAX_DEPTH) return "…";
+	if (typeof value === "string") return depth === 0 ? value : JSON.stringify(value);
+	if (value === null || typeof value === "number" || typeof value === "boolean") return String(value);
+	if (undefinedValue(value)) return "（无完成值）";
+	if (value !== null && typeof value === "object") {
+		if (seen.has(value)) return "[Circular]";
+		seen.add(value);
 	}
-	const text = await response.text();
-	if (!response.ok) {
-		const base = redact(text.slice(0, 300), apiKey);
-		const hint = retryHint(response.status);
-		return {
-			ok: false,
-			status: response.status,
-			error: hint ? `${base}（${hint}）` : base
-		};
+	if (Array.isArray(value)) {
+		const shown = value.slice(0, RENDER_BOUNDS.VALUE_TREE_MAX_CHILDREN);
+		const rest = value.length - shown.length;
+		const oneLine = `[${shown.map((v) => JSON.stringify(v)).join(", ")}]`;
+		const rendered = value.length === 0 ? "[]" : rest === 0 && shown.every((v) => primitive(v)) && oneLine.length <= MAX_LINE_CHARS ? oneLine : `[\n${shown.map((v) => truncateLine(`${pad}  ${renderModelValue(v, depth + 1, seen)}`)).join(",\n")}${rest > 0 ? `,\n${pad}  …（余 ${rest} 项）` : ""}\n${pad}]`;
+		seen.delete(value);
+		return rendered;
+	}
+	if (value !== null && typeof value === "object") {
+		const entries = Object.entries(value);
+		const shown = entries.slice(0, RENDER_BOUNDS.VALUE_TREE_MAX_CHILDREN);
+		const rest = entries.length - shown.length;
+		const oneLine = `{ ${shown.map(([k, v]) => `${k}: ${JSON.stringify(v)}`).join(", ")} }`;
+		const rendered = entries.length === 0 ? "{}" : rest === 0 && shown.every(([, v]) => primitive(v)) && oneLine.length <= MAX_LINE_CHARS ? oneLine : `{\n${shown.map(([k, v]) => truncateLine(`${pad}  ${k}: ${renderModelValue(v, depth + 1, seen)}`)).join(",\n")}${rest > 0 ? `,\n${pad}  …（余 ${rest} 项）` : ""}\n${pad}}`;
+		seen.delete(value);
+		return rendered;
 	}
+	return String(value);
+}
+function primitive(v) {
+	return v === null || [
+		"string",
+		"number",
+		"boolean"
+	].includes(typeof v);
+}
+function undefinedValue(value) {
+	return typeof value === "object" && value !== null && value.$void === true;
+}
+// ../tui/src/truncate.ts
+const TRUNCATION_MAX_BYTES = 51200;
+const TMP_FILE_TTL_MS = 864e5;
+const TMP_FILE_PREFIX = "pi-ptc-output-";
+let sweptTmp = false;
+function sweepExpiredTmp() {
+	sweptTmp = true;
+	let names;
 	try {
-		return {
-			ok: true,
-			value: JSON.parse(text)
-		};
+		names = readdirSync(tmpdir());
 	} catch {
-		return {
-			ok: false,
-			status: response.status,
-			error: `bad json: ${redact(text.slice(0, 200), apiKey)}`
-		};
+		return;
+	}
+	for (const name of names) {
+		if (!name.startsWith(TMP_FILE_PREFIX)) continue;
+		try {
+			const file = join(tmpdir(), name);
+			if (Date.now() - statSync(file).mtimeMs > TMP_FILE_TTL_MS) rmSync(file, { force: true });
+		} catch {}
 	}
 }
-function asMatches(payload) {
-	const list = payload?.results ?? payload?.data ?? [];
-	if (!Array.isArray(list)) return [];
-	return list.map((item) => {
-		const r = item;
-		return {
-			title: String(r.title ?? ""),
-			url: String(r.url ?? r.link ?? ""),
-			snippet: r.snippet !== void 0 ? String(r.snippet) : void 0,
-			summary: r.summary !== void 0 ? String(r.summary) : void 0,
-			rank: typeof r.rank === "number" ? r.rank : typeof r.rerank === "number" ? r.rerank : void 0,
-			date: r.date !== void 0 ? String(r.date) : void 0
-		};
-	}).filter((m) => m.url.length > 0);
-}
-function createDeepSeekProvider(apiKey) {
+function applyAdr0015Truncation(text) {
+	const lines = text.split("\n");
+	const bytes = Buffer.byteLength(text, "utf8");
+	if (bytes <= 51200 && lines.length <= 2e3) return {
+		text,
+		truncated: false
+	};
+	let keptLines = lines.slice(-2e3);
+	let kept = keptLines.join("\n");
+	while (Buffer.byteLength(kept, "utf8") > 51200 && keptLines.length > 1) {
+		keptLines = keptLines.slice(Math.max(1, Math.floor(keptLines.length / 2)));
+		kept = keptLines.join("\n");
+	}
+	const keptBuffer = Buffer.from(kept, "utf8");
+	if (keptBuffer.length > 51200) kept = keptBuffer.subarray(keptBuffer.length - TRUNCATION_MAX_BYTES).toString("utf8");
+	const fullOutputPath = join(tmpdir(), `${TMP_FILE_PREFIX}${randomUUID()}.txt`);
+	mkdirSync(tmpdir(), { recursive: true });
+	writeFileSync(fullOutputPath, text, "utf8");
+	if (!sweptTmp) sweepExpiredTmp();
 	return {
-		id: "deepseek",
-		async search(query, options) {
-			const outcome = await postJson("/search", {
-				query,
-				count: options?.count ?? 10
-			}, apiKey);
-			if (!outcome.ok) return outcome;
-			return {
-				ok: true,
-				value: asMatches(outcome.value)
-			};
-		},
-		async open(url) {
-			const outcome = await postJson("/fetch", { url }, apiKey);
-			if (!outcome.ok) return outcome;
-			const payload = outcome.value;
-			return {
-				ok: true,
-				value: redact(String(payload.content ?? payload.text ?? payload.markdown ?? ""), apiKey)
-			};
-		}
+		text: [`…（已截断：省略前 ${lines.length - keptLines.length} 行 / ${bytes - Buffer.byteLength(kept, "utf8")} 字节，全文在 ${fullOutputPath}）`, kept].join("\n"),
+		truncated: true,
+		fullOutputPath
 	};
 }
-// ../search/src/quota.ts
-function createSearchQuota(maxCallsPerSession) {
-	let inFlight = 0;
-	let used = 0;
-	const unlimited = maxCallsPerSession <= 0;
+// ../task/src/list-tasks.ts
+function selectVisibleTasks(records, recentCompletedLimit = 10) {
+	const inFlight = records.filter((record) => !isTerminal(record.status));
+	const recentCompleted = records.filter((record) => isTerminal(record.status)).sort((a, b) => (b.finishedAt ?? 0) - (a.finishedAt ?? 0)).slice(0, recentCompletedLimit);
+	return [...inFlight, ...recentCompleted];
+}
+function taskFaceVisible(records) {
+	return records.length > 0;
+}
+const TASK_TEXT_MAX_CHARS = 80;
+const SUMMARY_MAX_CHARS = 100;
+const LABEL_MAX_CHARS = 120;
+function projectTaskEntry(record, options = {}) {
 	return {
-		tryAcquire() {
-			if (unlimited) return true;
-			if (used + inFlight >= maxCallsPerSession) return false;
-			inFlight++;
-			return true;
-		},
-		release(success = true) {
-			if (unlimited) return;
-			inFlight = Math.max(0, inFlight - 1);
-			if (success) used++;
-		},
-		remaining() {
-			return unlimited ? Infinity : Math.max(0, maxCallsPerSession - used - inFlight);
-		}
+		id: record.id,
+		status: record.status,
+		...record.label ? { label: truncateLine(record.label, LABEL_MAX_CHARS) } : {},
+		...record.finishedAt !== void 0 ? { finishedAt: record.finishedAt } : {},
+		...record.task ? { task: truncateLine(record.task, TASK_TEXT_MAX_CHARS) } : {},
+		...record.report?.summary ? { summary: truncateLine(record.report.summary, SUMMARY_MAX_CHARS) } : {},
+		...options.archived ? { archived: true } : {},
+		...options.withSession && record.sessionId ? { sessionId: record.sessionId } : {}
 	};
 }
-// ../search/src/memory.ts
-function urlsLooselyEqual(a, b) {
-	try {
-		const ua = new URL(a);
-		const ub = new URL(b);
-		if (ua.host !== ub.host || ua.protocol !== ub.protocol) return false;
-		if (ua.pathname.replace(/\/$/, "") !== ub.pathname.replace(/\/$/, "")) return false;
-		return ua.search === ub.search || ua.search === "" || ub.search === "";
-	} catch {
-		return a === b;
+function fitTaskEntries(entries, limit) {
+	const picked = [];
+	let bytes = 2;
+	for (const entry of entries) {
+		if (picked.length >= limit) break;
+		const size = Buffer.byteLength(JSON.stringify(entry), "utf8") + 1;
+		if (bytes + size > 49152) break;
+		picked.push(entry);
+		bytes += size;
 	}
+	return picked;
 }
-function createSearchMemory() {
-	const entries = [];
-	const looseTexts = /* @__PURE__ */ new Map();
-	let looseChars = 0;
-	let totalChars = 0;
-	const trim = () => {
-		while (totalChars > SEARCH_MEMORY_MAX_CHARS) {
-			const oldest = looseTexts.keys().next();
-			if (!oldest.done) {
-				const len = looseTexts.get(oldest.value)?.length ?? 0;
-				looseChars -= len;
-				totalChars -= len;
+// ../routes/src/surface.ts
+const FALLBACK_SURFACE_MODE = "full_ptc";
+// ../routes/src/registry.ts
+const TOOLS = {
+	ptc_run_code: {
+		name: "ptc_run_code",
+		description: (s) => ["写一段 TypeScript 程序批量调用工具：tools.<name>(args)。支持顶层 await、Promise.all 并行、循环与条件；程序返回值是归约后的结果，中间产物不进上下文。", s === "codemode_ptc" ? "本会话里我从 codemode 脚本可达，模型直走 codemode。" : [
+			"什么时候写程序而不是逐个调工具，看系统提示词 <ptc> 节的路由表。",
+			"程序内可调本会话已启用的同名工具（read / write / edit / grep / find / ls；bash 默认不可用），参数与直接调用该工具完全一致；每次调用返回 Promise，要 await，返回文本结果，失败抛异常。",
+			"程序内还可调 task_records({ scope: \"all\" }) 取任务记录（all 含压缩归档）——要挑很多条时在程序里筛完只 return 要的几条。",
+			"例：const files = await tools.find({ pattern: \"*.py\" }); for (const f of files) await tools.write({ path: f, content: body });"
+		].join("")].join("")
+	},
+	ptc_workflow: {
+		name: "ptc_workflow",
+		description: (s) => ["结构化的多阶段程序：script 里可用 workflow.log / workflow.phase / workflow.parallel / workflow.pipeline。适合阶段明确的批处理。", s === "codemode_ptc" ? "本会话里我从 codemode 脚本可达。" : "与 ptc_run_code 的取舍看 <ptc> 节的路由表。"].join("")
+	},
+	pi_task_codemode: {
+		name: "pi_task_codemode",
+		description: () => "建一条子代理任务，默认立刻返回 handle（taskId + label）；wait:true 时阻塞到终态再返回结果。任务在任务记录里排队，由派发引擎起独立 pi 进程执行；完成后的报告与产出经 ptc_task_output 读取。"
+	},
+	ptc_task_list: {
+		name: "ptc_task_list",
+		description: () => "列出在飞的任务与最近完成的任务（默认最近 50 条已完成）。响应给精简条目（id/status/label/finishedAt/任务摘要）与候选总数——总数比返回条数大，说明还有更早的记录没列出来。scope=all 连压缩归档一起列（更全也更慢），status 与 session 可筛。"
+	},
+	ptc_task_output: {
+		name: "ptc_task_output",
+		description: () => "按 task_id 读一条任务记录：状态、报告、孩子的正文（text——那是交付物，报告只是摘要）与实测轨迹。正文超长时按截断契约给尾部与全文路径；记录里的 outputPath 指向原始事件流。"
+	},
+	ptc_task_stop: {
+		name: "ptc_task_stop",
+		description: () => "按 task_id 叫停任务：排队中的直接抽掉（canceled），在跑的转 stopping。"
+	}
+};
+const TASK_DOOR_PARAM_DESCRIPTIONS = {
+	task: "孩子要干的活",
+	agent: "已注册的 agent 名字；省略 = 通用孩子",
+	agentScope: "agent 定义的查找范围（user / project / both）",
+	why: "这一刀为什么切出来（调用方自己的话）——它会进孩子的提示词、多花孩子的 token；孩子从 task 里已经能读懂就别传",
+	model: "覆盖孩子跑的模型",
+	thinkingLevel: "覆盖孩子的思考档位——孩子的思考 token 是可调的成本项",
+	wait: "true = 等这个任务完成再返回结果；false = 立刻返回 handle，结果走任务面/通知",
+	label: "后台任务给人看的标签",
+	readOnly: "strict = 孩子只有读工具（read/grep/find/ls，搜索开启时含 web_ds_search）；lenient = 默认全工具。只需要读的活别给写权限",
+	timeoutMs: "孩子的运行时长上限（毫秒）——超了按超时收尸；不传 = 不限（与不传时同）",
+	projectContext: "孩子的项目上下文（AGENTS.md/CLAUDE.md）：auto = 照常加载；none = 不加载——注意 none 只关「注入」不关「知识」：文件还在工作目录里，孩子会自己去翻（实测输入只差约 15%，不是省一半）；这活不需要项目约定就传 none，要孩子遵守项目规矩就照常传（auto 也可能把项目里的写码规矩套进答案）"
+};
+const DELIVERY_CHECK_LEAD = "交付核对（引擎实测）";
+const DELIVERY_CHECK_NOTHING = "这孩子的结论没有依据：重派它，或明说缺口，别替它补数。";
+/** 父面渲染一行交付核对：工具/路径（实测）· 报错 · 正文长度 · 报告条数（自述） */
+function renderDeliveryCheck(input) {
+	const d = input.delivery;
+	if (!d) return "";
+	const calls = Object.entries(d.tools);
+	const totalCalls = calls.reduce((sum, [, count]) => sum + count, 0);
+	const parts = [];
+	if (calls.length > 0) {
+		const tools = calls.map(([name, count]) => `${name}×${count}`).join(" ");
+		const paths = d.paths.length > 0 ? `（${d.paths.slice(0, 5).join("、")}${d.paths.length > 5 ? ` 等 ${d.paths.length} 条` : ""}）` : "";
+		parts.push(`工具 ${tools}${paths}`);
+	} else parts.push("没调用任何工具");
+	parts.push(`报错 ${d.errors}`);
+	parts.push(`正文 ${d.textChars} 字`);
+	const findings = input.findings ?? 0;
+	parts.push(`报告 ${findings} 条（${input.channel ?? "none"}）`);
+	return totalCalls === 0 && findings === 0 && d.textChars === 0 ? `${DELIVERY_CHECK_LEAD}：零产出——${parts.join(" · ")}。${DELIVERY_CHECK_NOTHING}` : `${DELIVERY_CHECK_LEAD}：${parts.join(" · ")}`;
+}
+const ROUTES = [
+	{
+		id: "create-a-task",
+		name: "派一个子代理",
+		when: "材料多、主题互不相干、每份都要读一堆材料时派——父一个人扛会算错（实测 92%→100%，n=3）；成本 10 倍上下，一件能算完的活别派",
+		how: {
+			full_ptc: "tools.pi_task_ptc({ task, label? })（程序内）——task 是孩子的唯一规格（写死路径/命令/交付物格式）；要报告就点名 child report 的 JSON 块（summary/findings），别自创报告格式；汇总前核对孩子产出（delivery），零产出就重派别补数",
+			codemode_ptc: "tools.pi_task_codemode({ task, label? })（脚本内）——task 是孩子的唯一规格（写死路径/命令/交付物格式）；要报告就点名 child report 的 JSON 块（summary/findings），别自创报告格式；汇总前核对孩子产出（delivery），零产出就重派别补数"
+		},
+		fact: "默认不等，立刻返回 handle；任务在任务记录里排队，可经任务面三工具查/停",
+		detail: "docs/routes/create-a-task.md"
+	},
+	{
+		id: "run-one-program",
+		name: "批量调工具的一段程序",
+		when: "连续多次工具调用、结果要过滤/归约后再看",
+		how: {
+			full_ptc: "ptc_run_code({ code, description })",
+			codemode_ptc: "不适用——写程序是 full_ptc 面的编排能力；本面用 codemode 编排、pi_task_codemode 派任务"
+		},
+		fact: "程序内 tools.*；bash 当前不在程序绑定表里（旧 ADR-0040 的 opt-in 尚未接线）；只在本面（full_ptc）注册 PTC 工具",
+		detail: "docs/routes/run-one-program.md"
+	},
+	{
+		id: "run-a-phased-workflow",
+		name: "分阶段 workflow",
+		when: "批处理有明确阶段，要阶段性可见进度",
+		how: {
+			full_ptc: "ptc_workflow({ meta, script, args? })",
+			codemode_ptc: "不适用——同 run-one-program：workflow 是 full_ptc 的编排能力"
+		},
+		fact: "script 内可用 workflow.log/phase/parallel/pipeline；只在本面注册",
+		detail: "docs/routes/run-a-phased-workflow.md"
+	},
+	{
+		id: "use-the-built-in-tools",
+		name: "直接用内置工具",
+		when: "单次调用就够，或每步都要模型判断（写操作、审批敏感）",
+		how: {
+			full_ptc: "程序内 tools.read/grep/find/ls/edit/write；逐个直调走 pi 自己的工具",
+			codemode_ptc: "脚本内 tools.<内置名> 直接调"
+		},
+		fact: "bash 当前不在程序绑定表里（旧 ADR-0040 的 opt-in 尚未接线）",
+		detail: "docs/routes/use-the-built-in-tools.md"
+	},
+	{
+		id: "report-what-you-did",
+		name: "交报告",
+		when: "子代理收工：结论要有证据、副作用与用量要可核对",
+		how: {
+			full_ptc: "孩子的契约：最终消息末尾 fenced JSON（summary/findings/files_touched/usage）；宿主自动解析",
+			codemode_ptc: "同左——契约在孩子的追加提示词里，与 surface 无关"
+		},
+		fact: "reportChannel 恒在四值：tool/prompt-json/none/opted-out；工具通道（ptc_child_report）已是首选",
+		detail: "docs/routes/report-what-you-did.md"
+	},
+	{
+		id: "reach-the-web",
+		name: "上网查资料",
+		when: "需要网页搜索、抓页面、页内找内容——判断力在干活的子代理侧",
+		how: {
+			full_ptc: "派子代理（pi_task_ptc），孩子用 web_ds_search（search/open/find 三动作）",
+			codemode_ptc: "同左——搜索只在子代理进程里注册，父会话没有这个工具"
+		},
+		fact: "webDsSearch 开关默认关（fail-closed）；配额每进程计；概览走 snippet 超预算整条丢弃",
+		detail: "docs/routes/reach-the-web.md"
+	},
+	{
+		id: "manage-a-task",
+		name: "管一个任务",
+		when: "要知道孩子跑得怎样、读它的产出、或叫停它",
+		how: {
+			full_ptc: "ptc_task_list / ptc_task_output / ptc_task_stop（模型直调）——产出里的 delivery 是引擎实测轨迹",
+			codemode_ptc: "同左（模型直调；脚本经结构化返回）——产出里的 delivery 是引擎实测轨迹"
+		},
+		fact: "有任务记录这三个工具才出现在模型面前（ADR-0007）",
+		detail: "docs/routes/manage-a-task.md"
+	}
+];
+const LONG_OUTPUT_GUIDANCE_WITH_REPORT = "产出超过截断阈值（{bytes} 字节）。先看孩子的报告（归约层）：{report}——响应里的 output 是截断后的尾部；报告没收录的完整原文用 read 读记录上的 outputPath。";
+const LONG_OUTPUT_GUIDANCE_NO_REPORT = "产出超过截断阈值（{bytes} 字节），且孩子未交报告（reportChannel=none，散文可信度存疑）。响应里的 output 是截断后的尾部；完整原文用 read 读记录上的 outputPath。";
+function renderLongOutputGuidance(options) {
+	if (options.report && options.reportChannel && options.reportChannel !== "none") {
+		const findings = (options.report.findings ?? []).slice(0, 5).map((f) => `- ${f.what}${f.evidence ? `（证据：${f.evidence}）` : ""}`).join("\n");
+		return LONG_OUTPUT_GUIDANCE_WITH_REPORT.replace("{bytes}", String(options.bytes)).replace("{report}", [`summary: ${options.report.summary}`, findings].filter(Boolean).join("\n"));
+	}
+	return LONG_OUTPUT_GUIDANCE_NO_REPORT.replace("{bytes}", String(options.bytes));
+}
+const COMPACTED_TASK_REMINDER_LEAD = "对话刚被压缩——启动这些任务的消息已经不在上下文里了，但任务还在跑或已经跑完。用 ptc_task_list 看全部（scope=all 连压缩归档一起列），用 ptc_task_output 取产出（给的是孩子的正文，不是原始事件流）。";
+function renderCompactedTaskReminder(tasks) {
+	const lines = tasks.map((t) => `- ${t.id}${t.label ? ` (${t.label})` : ""}: ${t.status}`);
+	return [
+		"<compacted-tasks>",
+		COMPACTED_TASK_REMINDER_LEAD,
+		...lines,
+		"</compacted-tasks>"
+	].join("\n");
+}
+function renderTaskNotifications(batch) {
+	return [
+		"<bg-task-notifications>",
+		...batch.map((n) => `- task ${n.taskId}${n.label ? ` (${n.label})` : ""}: ${n.status}${n.stopReason ? ` — ${n.stopReason}` : ""}`),
+		"</bg-task-notifications>"
+	].join("\n");
+}
+function estimateTokens(text) {
+	return Math.ceil(text.length / 2);
+}
+const ROUTE_INDEX_LEAD = {
+	full_ptc: "批量调工具默认先写程序（ptc_run_code）；单次调用或要逐步判断、审批敏感的才直连。派不派子代理自己判断——路由表第一行写了代价。",
+	codemode_ptc: "编排写 codemode 脚本；批量派活经脚本内的 pi_task_codemode；要查/停任务用任务面三工具。派不派自己判断——路由表第一行写了代价。"
+};
+function renderRouteIndex(surface, detailBase, nudge = true) {
+	const lines = ROUTES.map((route) => `- ${route.name} — ${route.when}。这面怎么走：${route.how[surface]}。细节：${detailBase ? route.detail.split("/").pop() : route.detail}`);
+	let index = [
+		`<ptc>`,
+		...nudge ? [ROUTE_INDEX_LEAD[surface]] : [],
+		...detailBase ? [`详情目录：${detailBase}`] : [],
+		"路由表（一条一行，详情按需 read）：",
+		...lines,
+		`</ptc>`
+	].join("\n");
+	const tokens = estimateTokens(index);
+	if (tokens > 560) index += `\n> WARNING: index over token budget (${tokens} > 560); move detail into docs/routes/*.md`;
+	return index;
+}
+function taskListSnapshot(registry, query = {}, archived = []) {
+	const scope = query.scope === "all" ? "all" : "recent";
+	const limit = Math.min(Math.max(query.limit ?? 50, 1), 200);
+	const candidates = (scope === "all" ? [...registry.list(), ...archived] : registry.list()).filter((record) => {
+		if (query.status && record.status !== query.status) return false;
+		if (query.session && record.sessionId !== query.session) return false;
+		return true;
+	});
+	const visible = selectVisibleTasks(candidates, limit);
+	const withSession = query.session !== void 0;
+	return {
+		scope,
+		total: candidates.length,
+		tasks: fitTaskEntries(visible.map((record) => projectTaskEntry(record, {
+			archived: "archived" in record,
+			withSession
+		})), limit)
+	};
+}
+function faceVisible(registry) {
+	return taskFaceVisible(registry.list());
+}
+/**
+* 压缩后重注入的清单：在飞任务 + 最近完成的 5 条。
+* 没有任务就不注入（空清单只是噪音）。
+*/
+function compactedTaskReminder(registry) {
+	const records = registry.list();
+	const inFlight = records.filter((record) => !isTerminal(record.status));
+	const recentCompleted = records.filter((record) => isTerminal(record.status)).sort((a, b) => (b.finishedAt ?? 0) - (a.finishedAt ?? 0)).slice(0, 5);
+	if (inFlight.length === 0 && recentCompleted.length === 0) return void 0;
+	return renderCompactedTaskReminder([...inFlight, ...recentCompleted].map((record) => ({
+		id: record.id,
+		status: record.status,
+		label: record.label
+	})));
+}
+// ../task/src/output.ts
+/**
+* 任务产出读法：先给归约后的孩子正文（从事件流现算，不另存一份），
+* 没有正文才退回原始尾部 + 分层引导（完整原文在 outputPath）。
+*/
+async function readTaskOutput(source, record) {
+	const taskId = record.id;
+	const outputBytes = await source.outputSize(taskId);
+	if (outputBytes === void 0) return {};
+	const tail = await source.readOutputTail(taskId, 51200) ?? "";
+	let answer = parseChildStream(tail).text;
+	if (!answer && outputBytes > 51200) answer = parseChildStream(await source.readOutput(taskId) ?? "").text;
+	if (answer) return { text: applyAdr0015Truncation(answer).text };
+	return {
+		output: applyAdr0015Truncation(tail).text,
+		guidance: renderLongOutputGuidance({
+			bytes: outputBytes,
+			report: record.report,
+			reportChannel: record.reportChannel ?? "none"
+		})
+	};
+}
+// ../search/src/provider.ts
+const SEARCH_COUNT_RANGE = {
+	min: 1,
+	max: 50
+};
+const SEARCH_MEMORY_MAX_CHARS = 4e5;
+// ../search/src/deepseek.ts
+const API_BASE = "https://api.deepseek.com/v1/tools";
+function retryHint(status) {
+	if (status === 402) return "账号余额不足：充值后再试";
+	if (status === 408 || status === 429 || status >= 500) return "临时性失败：稍后重试";
+	if (status >= 400) return "请求不合法：修改请求后再试（原样重试无益）";
+	if (status === 0) return "网络不可达：检查连接后重试";
+	return "";
+}
+function redact(text, apiKey) {
+	return apiKey ? text.split(apiKey).join("[REDACTED]") : text;
+}
+async function postJson(path, body, apiKey) {
+	let response;
+	try {
+		response = await fetch(`${API_BASE}${path}`, {
+			method: "POST",
+			headers: {
+				Authorization: `Bearer ${apiKey}`,
+				"Content-Type": "application/json"
+			},
+			body: JSON.stringify(body),
+			signal: AbortSignal.timeout(3e4)
+		});
+	} catch (error) {
+		return {
+			ok: false,
+			status: 0,
+			error: `network: ${error instanceof Error ? error.message : String(error)}`
+		};
+	}
+	const text = await response.text();
+	if (!response.ok) {
+		const base = redact(text.slice(0, 300), apiKey);
+		const hint = retryHint(response.status);
+		return {
+			ok: false,
+			status: response.status,
+			error: hint ? `${base}（${hint}）` : base
+		};
+	}
+	try {
+		return {
+			ok: true,
+			value: JSON.parse(text)
+		};
+	} catch {
+		return {
+			ok: false,
+			status: response.status,
+			error: `bad json: ${redact(text.slice(0, 200), apiKey)}`
+		};
+	}
+}
+function asMatches(payload) {
+	const list = payload?.results ?? payload?.data ?? [];
+	if (!Array.isArray(list)) return [];
+	return list.map((item) => {
+		const r = item;
+		return {
+			title: String(r.title ?? ""),
+			url: String(r.url ?? r.link ?? ""),
+			snippet: r.snippet !== void 0 ? String(r.snippet) : void 0,
+			summary: r.summary !== void 0 ? String(r.summary) : void 0,
+			rank: typeof r.rank === "number" ? r.rank : typeof r.rerank === "number" ? r.rerank : void 0,
+			date: r.date !== void 0 ? String(r.date) : void 0
+		};
+	}).filter((m) => m.url.length > 0);
+}
+function createDeepSeekProvider(apiKey) {
+	return {
+		id: "deepseek",
+		async search(query, options) {
+			const outcome = await postJson("/search", {
+				query,
+				count: options?.count ?? 10
+			}, apiKey);
+			if (!outcome.ok) return outcome;
+			return {
+				ok: true,
+				value: asMatches(outcome.value)
+			};
+		},
+		async open(url) {
+			const outcome = await postJson("/fetch", { url }, apiKey);
+			if (!outcome.ok) return outcome;
+			const payload = outcome.value;
+			return {
+				ok: true,
+				value: redact(String(payload.content ?? payload.text ?? payload.markdown ?? ""), apiKey)
+			};
+		}
+	};
+}
+// ../search/src/quota.ts
+function createSearchQuota(maxCallsPerSession) {
+	let inFlight = 0;
+	let used = 0;
+	const unlimited = maxCallsPerSession <= 0;
+	return {
+		tryAcquire() {
+			if (unlimited) return true;
+			if (used + inFlight >= maxCallsPerSession) return false;
+			inFlight++;
+			return true;
+		},
+		release(success = true) {
+			if (unlimited) return;
+			inFlight = Math.max(0, inFlight - 1);
+			if (success) used++;
+		},
+		remaining() {
+			return unlimited ? Infinity : Math.max(0, maxCallsPerSession - used - inFlight);
+		}
+	};
+}
+// ../search/src/memory.ts
+function urlsLooselyEqual(a, b) {
+	try {
+		const ua = new URL(a);
+		const ub = new URL(b);
+		if (ua.host !== ub.host || ua.protocol !== ub.protocol) return false;
+		if (ua.pathname.replace(/\/$/, "") !== ub.pathname.replace(/\/$/, "")) return false;
+		return ua.search === ub.search || ua.search === "" || ub.search === "";
+	} catch {
+		return a === b;
+	}
+}
+function createSearchMemory() {
+	const entries = [];
+	const looseTexts = /* @__PURE__ */ new Map();
+	let looseChars = 0;
+	let totalChars = 0;
+	const trim = () => {
+		while (totalChars > SEARCH_MEMORY_MAX_CHARS) {
+			const oldest = looseTexts.keys().next();
+			if (!oldest.done) {
+				const len = looseTexts.get(oldest.value)?.length ?? 0;
+				looseChars -= len;
+				totalChars -= len;
 				looseTexts.delete(oldest.value);
 				continue;
 			}
@@ -4013,71 +4487,9 @@ function createSearchMemory() {
 			trim();
 		},
 		lookup(url) {
-			for (let i = entries.length - 1; i >= 0; i--) for (const [stored, text] of entries[i].textByUrl) if (urlsLooselyEqual(stored, url)) return text;
-			for (const [stored, text] of [...looseTexts].reverse()) if (urlsLooselyEqual(stored, url)) return text;
-		}
-	};
-}
-// ../tui/src/bounds.ts
-const RENDER_BOUNDS$1 = {
-	MAX_LOG_LINES_EXPANDED: 12,
-	VALUE_TREE_MAX_DEPTH: 4,
-	VALUE_TREE_MAX_CHILDREN: 6,
-	VALUE_TREE_MAX_LINE_CHARS: 120
-};
-// ../tui/src/text.ts
-const ANSI_PATTERN$1 = /\x1B\[[0-9:;<=>?]*[ -/]*[@-~]|\x1B\][^\x07\x1B]*(?:\x07|\x1B\\)|[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g;
-function stripAnsi$1(text) {
-	return text.replace(ANSI_PATTERN$1, "");
-}
-function sanitizeText$1(text) {
-	return stripAnsi$1(text.replace(/\r/g, ""));
-}
-RENDER_BOUNDS$1.VALUE_TREE_MAX_LINE_CHARS;
-// ../tui/src/truncate.ts
-const TRUNCATION_MAX_BYTES$1 = 51200;
-const TMP_FILE_TTL_MS$1 = 864e5;
-const TMP_FILE_PREFIX$1 = "pi-ptc-output-";
-let sweptTmp$1 = false;
-function sweepExpiredTmp$1() {
-	sweptTmp$1 = true;
-	let names;
-	try {
-		names = readdirSync(tmpdir());
-	} catch {
-		return;
-	}
-	for (const name of names) {
-		if (!name.startsWith(TMP_FILE_PREFIX$1)) continue;
-		try {
-			const file = join(tmpdir(), name);
-			if (Date.now() - statSync(file).mtimeMs > TMP_FILE_TTL_MS$1) rmSync(file, { force: true });
-		} catch {}
-	}
-}
-function applyAdr0015Truncation$1(text) {
-	const lines = text.split("\n");
-	const bytes = Buffer.byteLength(text, "utf8");
-	if (bytes <= 51200 && lines.length <= 2e3) return {
-		text,
-		truncated: false
-	};
-	let keptLines = lines.slice(-2e3);
-	let kept = keptLines.join("\n");
-	while (Buffer.byteLength(kept, "utf8") > 51200 && keptLines.length > 1) {
-		keptLines = keptLines.slice(Math.max(1, Math.floor(keptLines.length / 2)));
-		kept = keptLines.join("\n");
-	}
-	const keptBuffer = Buffer.from(kept, "utf8");
-	if (keptBuffer.length > 51200) kept = keptBuffer.subarray(keptBuffer.length - TRUNCATION_MAX_BYTES$1).toString("utf8");
-	const fullOutputPath = join(tmpdir(), `${TMP_FILE_PREFIX$1}${randomUUID()}.txt`);
-	mkdirSync(tmpdir(), { recursive: true });
-	writeFileSync(fullOutputPath, text, "utf8");
-	if (!sweptTmp$1) sweepExpiredTmp$1();
-	return {
-		text: [`…（已截断：省略前 ${lines.length - keptLines.length} 行 / ${bytes - Buffer.byteLength(kept, "utf8")} 字节，全文在 ${fullOutputPath}）`, kept].join("\n"),
-		truncated: true,
-		fullOutputPath
+			for (let i = entries.length - 1; i >= 0; i--) for (const [stored, text] of entries[i].textByUrl) if (urlsLooselyEqual(stored, url)) return text;
+			for (const [stored, text] of [...looseTexts].reverse()) if (urlsLooselyEqual(stored, url)) return text;
+		}
 	};
 }
 // ../search/src/run.ts
@@ -4140,14 +4552,14 @@ async function runWebSearch(action, context) {
 		};
 		return {
 			ok: true,
-			text: sanitizeText$1(renderSearchOverview(outcome.value, budget))
+			text: sanitizeText(renderSearchOverview(outcome.value, budget))
 		};
 	}
 	if (action.kind === "open") {
 		const cached = context.memory.lookup(action.url);
 		if (cached !== void 0) return {
 			ok: true,
-			text: sanitizeText$1(`（记忆命中，未发请求）\n${cached.slice(0, budget)}`)
+			text: sanitizeText(`（记忆命中，未发请求）\n${cached.slice(0, budget)}`)
 		};
 		if (!context.quota.tryAcquire()) return {
 			ok: false,
@@ -4166,7 +4578,7 @@ async function runWebSearch(action, context) {
 		context.memory.storeText(action.url, outcome.value);
 		return {
 			ok: true,
-			text: sanitizeText$1(outcome.value.slice(0, budget))
+			text: sanitizeText(outcome.value.slice(0, budget))
 		};
 	}
 	let regex;
@@ -4186,7 +4598,7 @@ async function runWebSearch(action, context) {
 	})).filter(({ line }) => regex.test(line));
 	return {
 		ok: true,
-		text: sanitizeText$1(lines.length > 0 ? lines.slice(0, 50).map(({ line, index }) => `${index + 1}: ${line}`).join("\n") : "（页内无匹配行）").slice(0, budget)
+		text: sanitizeText(lines.length > 0 ? lines.slice(0, 50).map(({ line, index }) => `${index + 1}: ${line}`).join("\n") : "（页内无匹配行）").slice(0, budget)
 	};
 }
 /** 页文获取：记忆命中免费；否则占额抓取并回存记忆 */
@@ -4245,262 +4657,37 @@ function createWebDsSearchTool(context) {
 				count: args.count
 			} : args.action === "open" ? {
 				kind: "open",
-				url: args.url ?? ""
-			} : {
-				kind: "find",
-				url: args.url ?? "",
-				pattern: args.pattern ?? ""
-			};
-			if (action.kind === "search" && action.query === "") return {
-				content: [{
-					type: "text",
-					text: "search 动作需要 query"
-				}],
-				details: void 0,
-				isError: true
-			};
-			if (action.kind !== "search" && action.url === "") return {
-				content: [{
-					type: "text",
-					text: `${action.kind} 动作需要 url`
-				}],
-				details: void 0,
-				isError: true
-			};
-			const result = await runWebSearch(action, context);
-			return {
-				content: [{
-					type: "text",
-					text: result.ok ? result.text : result.error
-				}],
-				details: void 0,
-				isError: !result.ok
-			};
-		}
-	};
-}
-// ../routes/src/surface.ts
-const FALLBACK_SURFACE_MODE = "full_ptc";
-// ../routes/src/registry.ts
-const TOOLS = {
-	ptc_run_code: {
-		name: "ptc_run_code",
-		description: (s) => ["写一段 TypeScript 程序批量调用工具：tools.<name>(args)。支持顶层 await、Promise.all 并行、循环与条件；程序返回值是归约后的结果，中间产物不进上下文。", s === "codemode_ptc" ? "本会话里我从 codemode 脚本可达，模型直走 codemode。" : [
-			"什么时候写程序而不是逐个调工具，看系统提示词 <ptc> 节的路由表。",
-			"程序内可调本会话已启用的同名工具（read / write / edit / grep / find / ls；bash 默认不可用），参数与直接调用该工具完全一致；每次调用返回 Promise，要 await，返回文本结果，失败抛异常。",
-			"例：const files = await tools.find({ pattern: \"*.py\" }); for (const f of files) await tools.write({ path: f, content: body });"
-		].join("")].join("")
-	},
-	ptc_workflow: {
-		name: "ptc_workflow",
-		description: (s) => ["结构化的多阶段程序：script 里可用 workflow.log / workflow.phase / workflow.parallel / workflow.pipeline。适合阶段明确的批处理。", s === "codemode_ptc" ? "本会话里我从 codemode 脚本可达。" : "与 ptc_run_code 的取舍看 <ptc> 节的路由表。"].join("")
-	},
-	pi_task_codemode: {
-		name: "pi_task_codemode",
-		description: () => "建一条子代理任务，默认立刻返回 handle（taskId + label）；wait:true 时阻塞到终态再返回结果。任务在任务记录里排队，由派发引擎起独立 pi 进程执行；完成后的报告与产出经 ptc_task_output 读取。"
-	},
-	ptc_task_list: {
-		name: "ptc_task_list",
-		description: () => "列出在飞的任务与最近完成的任务（最近 10 条已完成）。"
-	},
-	ptc_task_output: {
-		name: "ptc_task_output",
-		description: () => "按 task_id 读一条任务记录：状态、报告、产出。产出超过截断阈值时给尾部与完整产出位置（outputPath）。"
-	},
-	ptc_task_stop: {
-		name: "ptc_task_stop",
-		description: () => "按 task_id 叫停任务：排队中的直接抽掉（canceled），在跑的转 stopping。"
-	}
-};
-const TASK_DOOR_PARAM_DESCRIPTIONS = {
-	task: "孩子要干的活",
-	agent: "已注册的 agent 名字；省略 = 通用孩子",
-	agentScope: "agent 定义的查找范围（user / project / both）",
-	why: "这一刀为什么切出来（调用方自己的话）——它会进孩子的提示词、多花孩子的 token；孩子从 task 里已经能读懂就别传",
-	model: "覆盖孩子跑的模型",
-	thinkingLevel: "覆盖孩子的思考档位——孩子的思考 token 是可调的成本项",
-	wait: "true = 等这个任务完成再返回结果；false = 立刻返回 handle，结果走任务面/通知",
-	label: "后台任务给人看的标签",
-	readOnly: "strict = 孩子只有读工具（read/grep/find/ls，搜索开启时含 web_ds_search）；lenient = 默认全工具。只需要读的活别给写权限",
-	timeoutMs: "孩子的运行时长上限（毫秒）——超了按超时收尸；不传 = 不限（与不传时同）",
-	projectContext: "孩子的项目上下文（AGENTS.md/CLAUDE.md）：auto = 照常加载；none = 不加载——注意 none 只关「注入」不关「知识」：文件还在工作目录里，孩子会自己去翻（实测输入只差约 15%，不是省一半）；这活不需要项目约定就传 none，要孩子遵守项目规矩就照常传（auto 也可能把项目里的写码规矩套进答案）"
-};
-const DELIVERY_CHECK_LEAD = "交付核对（引擎实测）";
-const DELIVERY_CHECK_NOTHING = "这孩子的结论没有依据：重派它，或明说缺口，别替它补数。";
-/** 父面渲染一行交付核对：工具/路径（实测）· 报错 · 正文长度 · 报告条数（自述） */
-function renderDeliveryCheck(input) {
-	const d = input.delivery;
-	if (!d) return "";
-	const calls = Object.entries(d.tools);
-	const totalCalls = calls.reduce((sum, [, count]) => sum + count, 0);
-	const parts = [];
-	if (calls.length > 0) {
-		const tools = calls.map(([name, count]) => `${name}×${count}`).join(" ");
-		const paths = d.paths.length > 0 ? `（${d.paths.slice(0, 5).join("、")}${d.paths.length > 5 ? ` 等 ${d.paths.length} 条` : ""}）` : "";
-		parts.push(`工具 ${tools}${paths}`);
-	} else parts.push("没调用任何工具");
-	parts.push(`报错 ${d.errors}`);
-	parts.push(`正文 ${d.textChars} 字`);
-	const findings = input.findings ?? 0;
-	parts.push(`报告 ${findings} 条（${input.channel ?? "none"}）`);
-	return totalCalls === 0 && findings === 0 && d.textChars === 0 ? `${DELIVERY_CHECK_LEAD}：零产出——${parts.join(" · ")}。${DELIVERY_CHECK_NOTHING}` : `${DELIVERY_CHECK_LEAD}：${parts.join(" · ")}`;
-}
-const ROUTES = [
-	{
-		id: "create-a-task",
-		name: "派一个子代理",
-		when: "材料多、主题互不相干、每份都要读一堆材料时派——父一个人扛会算错（实测 92%→100%，n=3）；成本 10 倍上下，一件能算完的活别派",
-		how: {
-			full_ptc: "tools.pi_task_ptc({ task, label? })（程序内）——task 是孩子的唯一规格（写死路径/命令/交付物格式）；要报告就点名 child report 的 JSON 块（summary/findings），别自创报告格式；汇总前核对孩子产出（delivery），零产出就重派别补数",
-			codemode_ptc: "tools.pi_task_codemode({ task, label? })（脚本内）——task 是孩子的唯一规格（写死路径/命令/交付物格式）；要报告就点名 child report 的 JSON 块（summary/findings），别自创报告格式；汇总前核对孩子产出（delivery），零产出就重派别补数"
-		},
-		fact: "默认不等，立刻返回 handle；任务在任务记录里排队，可经任务面三工具查/停",
-		detail: "docs/routes/create-a-task.md"
-	},
-	{
-		id: "run-one-program",
-		name: "批量调工具的一段程序",
-		when: "连续多次工具调用、结果要过滤/归约后再看",
-		how: {
-			full_ptc: "ptc_run_code({ code, description })",
-			codemode_ptc: "不适用——写程序是 full_ptc 面的编排能力；本面用 codemode 编排、pi_task_codemode 派任务"
-		},
-		fact: "程序内 tools.*；bash 当前不在程序绑定表里（旧 ADR-0040 的 opt-in 尚未接线）；只在本面（full_ptc）注册 PTC 工具",
-		detail: "docs/routes/run-one-program.md"
-	},
-	{
-		id: "run-a-phased-workflow",
-		name: "分阶段 workflow",
-		when: "批处理有明确阶段，要阶段性可见进度",
-		how: {
-			full_ptc: "ptc_workflow({ meta, script, args? })",
-			codemode_ptc: "不适用——同 run-one-program：workflow 是 full_ptc 的编排能力"
-		},
-		fact: "script 内可用 workflow.log/phase/parallel/pipeline；只在本面注册",
-		detail: "docs/routes/run-a-phased-workflow.md"
-	},
-	{
-		id: "use-the-built-in-tools",
-		name: "直接用内置工具",
-		when: "单次调用就够，或每步都要模型判断（写操作、审批敏感）",
-		how: {
-			full_ptc: "程序内 tools.read/grep/find/ls/edit/write；逐个直调走 pi 自己的工具",
-			codemode_ptc: "脚本内 tools.<内置名> 直接调"
-		},
-		fact: "bash 当前不在程序绑定表里（旧 ADR-0040 的 opt-in 尚未接线）",
-		detail: "docs/routes/use-the-built-in-tools.md"
-	},
-	{
-		id: "report-what-you-did",
-		name: "交报告",
-		when: "子代理收工：结论要有证据、副作用与用量要可核对",
-		how: {
-			full_ptc: "孩子的契约：最终消息末尾 fenced JSON（summary/findings/files_touched/usage）；宿主自动解析",
-			codemode_ptc: "同左——契约在孩子的追加提示词里，与 surface 无关"
-		},
-		fact: "reportChannel 恒在四值：tool/prompt-json/none/opted-out；工具通道（ptc_child_report）已是首选",
-		detail: "docs/routes/report-what-you-did.md"
-	},
-	{
-		id: "reach-the-web",
-		name: "上网查资料",
-		when: "需要网页搜索、抓页面、页内找内容——判断力在干活的子代理侧",
-		how: {
-			full_ptc: "派子代理（pi_task_ptc），孩子用 web_ds_search（search/open/find 三动作）",
-			codemode_ptc: "同左——搜索只在子代理进程里注册，父会话没有这个工具"
-		},
-		fact: "webDsSearch 开关默认关（fail-closed）；配额每进程计；概览走 snippet 超预算整条丢弃",
-		detail: "docs/routes/reach-the-web.md"
-	},
-	{
-		id: "manage-a-task",
-		name: "管一个任务",
-		when: "要知道孩子跑得怎样、读它的产出、或叫停它",
-		how: {
-			full_ptc: "ptc_task_list / ptc_task_output / ptc_task_stop（模型直调）——产出里的 delivery 是引擎实测轨迹",
-			codemode_ptc: "同左（模型直调；脚本经结构化返回）——产出里的 delivery 是引擎实测轨迹"
-		},
-		fact: "有任务记录这三个工具才出现在模型面前（ADR-0007）",
-		detail: "docs/routes/manage-a-task.md"
-	}
-];
-const LONG_OUTPUT_GUIDANCE_WITH_REPORT = "产出超过截断阈值（{bytes} 字节）。先看孩子的报告（归约层）：{report}——响应里的 output 是截断后的尾部；报告没收录的完整原文用 read 读记录上的 outputPath。";
-const LONG_OUTPUT_GUIDANCE_NO_REPORT = "产出超过截断阈值（{bytes} 字节），且孩子未交报告（reportChannel=none，散文可信度存疑）。响应里的 output 是截断后的尾部；完整原文用 read 读记录上的 outputPath。";
-function renderLongOutputGuidance(options) {
-	if (options.report && options.reportChannel && options.reportChannel !== "none") {
-		const findings = (options.report.findings ?? []).slice(0, 5).map((f) => `- ${f.what}${f.evidence ? `（证据：${f.evidence}）` : ""}`).join("\n");
-		return LONG_OUTPUT_GUIDANCE_WITH_REPORT.replace("{bytes}", String(options.bytes)).replace("{report}", [`summary: ${options.report.summary}`, findings].filter(Boolean).join("\n"));
-	}
-	return LONG_OUTPUT_GUIDANCE_NO_REPORT.replace("{bytes}", String(options.bytes));
-}
-function renderTaskNotifications(batch) {
-	return [
-		"<bg-task-notifications>",
-		...batch.map((n) => `- task ${n.taskId}${n.label ? ` (${n.label})` : ""}: ${n.status}${n.stopReason ? ` — ${n.stopReason}` : ""}`),
-		"</bg-task-notifications>"
-	].join("\n");
-}
-function estimateTokens(text) {
-	return Math.ceil(text.length / 2);
-}
-const ROUTE_INDEX_LEAD = {
-	full_ptc: "批量调工具默认先写程序（ptc_run_code）；单次调用或要逐步判断、审批敏感的才直连。派不派子代理自己判断——路由表第一行写了代价。",
-	codemode_ptc: "编排写 codemode 脚本；批量派活经脚本内的 pi_task_codemode；要查/停任务用任务面三工具。派不派自己判断——路由表第一行写了代价。"
-};
-function renderRouteIndex(surface, detailBase, nudge = true) {
-	const lines = ROUTES.map((route) => `- ${route.name} — ${route.when}。这面怎么走：${route.how[surface]}。细节：${detailBase ? route.detail.split("/").pop() : route.detail}`);
-	let index = [
-		`<ptc>`,
-		...nudge ? [ROUTE_INDEX_LEAD[surface]] : [],
-		...detailBase ? [`详情目录：${detailBase}`] : [],
-		"路由表（一条一行，详情按需 read）：",
-		...lines,
-		`</ptc>`
-	].join("\n");
-	const tokens = estimateTokens(index);
-	if (tokens > 560) index += `\n> WARNING: index over token budget (${tokens} > 560); move detail into docs/routes/*.md`;
-	return index;
-}
-// ../ptc/src/task-binding.ts
-const TASK_BINDING_NAME = "pi_task_ptc";
-const TASK_DOOR_PARAMETERS = _Object_({
-	task: String$1({
-		minLength: 1,
-		description: TASK_DOOR_PARAM_DESCRIPTIONS.task
-	}),
-	agent: Optional(String$1({ description: TASK_DOOR_PARAM_DESCRIPTIONS.agent })),
-	why: Optional(String$1({ description: TASK_DOOR_PARAM_DESCRIPTIONS.why })),
-	agentScope: Optional(Union([
-		Literal("user"),
-		Literal("project"),
-		Literal("both")
-	], { description: TASK_DOOR_PARAM_DESCRIPTIONS.agentScope })),
-	model: Optional(String$1({ description: TASK_DOOR_PARAM_DESCRIPTIONS.model })),
-	thinkingLevel: Optional(String$1({ description: TASK_DOOR_PARAM_DESCRIPTIONS.thinkingLevel })),
-	wait: Optional(Boolean$1({ description: TASK_DOOR_PARAM_DESCRIPTIONS.wait })),
-	label: Optional(String$1({ description: TASK_DOOR_PARAM_DESCRIPTIONS.label })),
-	readOnly: Optional(Union([Literal("strict"), Literal("lenient")], { description: TASK_DOOR_PARAM_DESCRIPTIONS.readOnly })),
-	timeoutMs: Optional(Number$1({ description: TASK_DOOR_PARAM_DESCRIPTIONS.timeoutMs })),
-	projectContext: Optional(Union([Literal("auto"), Literal("none")], { description: TASK_DOOR_PARAM_DESCRIPTIONS.projectContext }))
-});
-function createTaskBinding(door) {
-	return {
-		name: TASK_BINDING_NAME,
-		parameters: TASK_DOOR_PARAMETERS,
-		execute(args) {
-			const input = args ?? {};
-			return door.createTask(input.task, {
-				label: input.label,
-				wait: input.wait,
-				why: input.why,
-				model: input.model,
-				thinkingLevel: input.thinkingLevel,
-				agent: input.agent,
-				agentScope: input.agentScope,
-				readOnly: input.readOnly,
-				timeoutMs: input.timeoutMs,
-				projectContext: input.projectContext
-			});
+				url: args.url ?? ""
+			} : {
+				kind: "find",
+				url: args.url ?? "",
+				pattern: args.pattern ?? ""
+			};
+			if (action.kind === "search" && action.query === "") return {
+				content: [{
+					type: "text",
+					text: "search 动作需要 query"
+				}],
+				details: void 0,
+				isError: true
+			};
+			if (action.kind !== "search" && action.url === "") return {
+				content: [{
+					type: "text",
+					text: `${action.kind} 动作需要 url`
+				}],
+				details: void 0,
+				isError: true
+			};
+			const result = await runWebSearch(action, context);
+			return {
+				content: [{
+					type: "text",
+					text: result.ok ? result.text : result.error
+				}],
+				details: void 0,
+				isError: !result.ok
+			};
 		}
 	};
 }
@@ -4832,127 +5019,7 @@ var WorkerPool = class {
 		this.#spawned = Math.max(0, this.#spawned - 1);
 	}
 };
-// ../ptc/src/bindings.ts
-const KNOWN_BINDING_NAMES = [
-	"read",
-	"bash",
-	"grep",
-	"find",
-	"ls",
-	"edit",
-	"write"
-];
-const OPT_IN_BINDING_NAMES = ["bash"];
-const DEFAULT_BINDING_NAMES = KNOWN_BINDING_NAMES.filter((name) => !OPT_IN_BINDING_NAMES.includes(name));
-function resolveBindingNames(activeToolNames, optIns = []) {
-	const allowed = /* @__PURE__ */ new Set([...DEFAULT_BINDING_NAMES, ...optIns]);
-	return KNOWN_BINDING_NAMES.filter((name) => activeToolNames.includes(name) && allowed.has(name));
-}
-// ../output/dist/index.js
-const RENDER_BOUNDS = {
-	MAX_LOG_LINES_EXPANDED: 12,
-	VALUE_TREE_MAX_DEPTH: 4,
-	VALUE_TREE_MAX_CHILDREN: 6,
-	VALUE_TREE_MAX_LINE_CHARS: 120
-};
-const ANSI_PATTERN = /\x1B\[[0-9:;<=>?]*[ -/]*[@-~]|\x1B\][^\x07\x1B]*(?:\x07|\x1B\\)|[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g;
-function stripAnsi(text) {
-	return text.replace(ANSI_PATTERN, "");
-}
-function sanitizeText(text) {
-	return stripAnsi(text.replace(/\r/g, ""));
-}
-const MAX_LINE_CHARS = RENDER_BOUNDS.VALUE_TREE_MAX_LINE_CHARS;
-function truncateLine(line, maxChars = MAX_LINE_CHARS) {
-	if (line.length <= maxChars) return line;
-	let cut = maxChars;
-	while (cut > 0 && (line.charCodeAt(cut) & 64512) === 56320) cut--;
-	return `${line.slice(0, cut)}…`;
-}
-function renderModelValue(value, depth = 0, seen = /* @__PURE__ */ new WeakSet()) {
-	const pad = "  ".repeat(depth);
-	if (depth >= RENDER_BOUNDS.VALUE_TREE_MAX_DEPTH) return "…";
-	if (typeof value === "string") return depth === 0 ? value : JSON.stringify(value);
-	if (value === null || typeof value === "number" || typeof value === "boolean") return String(value);
-	if (undefinedValue(value)) return "（无完成值）";
-	if (value !== null && typeof value === "object") {
-		if (seen.has(value)) return "[Circular]";
-		seen.add(value);
-	}
-	if (Array.isArray(value)) {
-		const shown = value.slice(0, RENDER_BOUNDS.VALUE_TREE_MAX_CHILDREN);
-		const rest = value.length - shown.length;
-		const oneLine = `[${shown.map((v) => JSON.stringify(v)).join(", ")}]`;
-		const rendered = value.length === 0 ? "[]" : rest === 0 && shown.every((v) => primitive(v)) && oneLine.length <= MAX_LINE_CHARS ? oneLine : `[\n${shown.map((v) => truncateLine(`${pad}  ${renderModelValue(v, depth + 1, seen)}`)).join(",\n")}${rest > 0 ? `,\n${pad}  …（余 ${rest} 项）` : ""}\n${pad}]`;
-		seen.delete(value);
-		return rendered;
-	}
-	if (value !== null && typeof value === "object") {
-		const entries = Object.entries(value);
-		const shown = entries.slice(0, RENDER_BOUNDS.VALUE_TREE_MAX_CHILDREN);
-		const rest = entries.length - shown.length;
-		const oneLine = `{ ${shown.map(([k, v]) => `${k}: ${JSON.stringify(v)}`).join(", ")} }`;
-		const rendered = entries.length === 0 ? "{}" : rest === 0 && shown.every(([, v]) => primitive(v)) && oneLine.length <= MAX_LINE_CHARS ? oneLine : `{\n${shown.map(([k, v]) => truncateLine(`${pad}  ${k}: ${renderModelValue(v, depth + 1, seen)}`)).join(",\n")}${rest > 0 ? `,\n${pad}  …（余 ${rest} 项）` : ""}\n${pad}}`;
-		seen.delete(value);
-		return rendered;
-	}
-	return String(value);
-}
-function primitive(v) {
-	return v === null || [
-		"string",
-		"number",
-		"boolean"
-	].includes(typeof v);
-}
-function undefinedValue(value) {
-	return typeof value === "object" && value !== null && value.$void === true;
-}
-const TRUNCATION_MAX_BYTES = 51200;
-const TMP_FILE_TTL_MS = 864e5;
-const TMP_FILE_PREFIX = "pi-ptc-output-";
-let sweptTmp = false;
-function sweepExpiredTmp() {
-	sweptTmp = true;
-	let names;
-	try {
-		names = readdirSync(tmpdir());
-	} catch {
-		return;
-	}
-	for (const name of names) {
-		if (!name.startsWith(TMP_FILE_PREFIX)) continue;
-		try {
-			const file = join(tmpdir(), name);
-			if (Date.now() - statSync(file).mtimeMs > TMP_FILE_TTL_MS) rmSync(file, { force: true });
-		} catch {}
-	}
-}
-function applyAdr0015Truncation(text) {
-	const lines = text.split("\n");
-	const bytes = Buffer.byteLength(text, "utf8");
-	if (bytes <= 51200 && lines.length <= 2e3) return {
-		text,
-		truncated: false
-	};
-	let keptLines = lines.slice(-2e3);
-	let kept = keptLines.join("\n");
-	while (Buffer.byteLength(kept, "utf8") > 51200 && keptLines.length > 1) {
-		keptLines = keptLines.slice(Math.max(1, Math.floor(keptLines.length / 2)));
-		kept = keptLines.join("\n");
-	}
-	const keptBuffer = Buffer.from(kept, "utf8");
-	if (keptBuffer.length > 51200) kept = keptBuffer.subarray(keptBuffer.length - TRUNCATION_MAX_BYTES).toString("utf8");
-	const fullOutputPath = join(tmpdir(), `${TMP_FILE_PREFIX}${randomUUID()}.txt`);
-	mkdirSync(tmpdir(), { recursive: true });
-	writeFileSync(fullOutputPath, text, "utf8");
-	if (!sweptTmp) sweepExpiredTmp();
-	return {
-		text: [`…（已截断：省略前 ${lines.length - keptLines.length} 行 / ${bytes - Buffer.byteLength(kept, "utf8")} 字节，全文在 ${fullOutputPath}）`, kept].join("\n"),
-		truncated: true,
-		fullOutputPath
-	};
-}
+// ../output/src/result-text.ts
 function renderToolResult(outcome) {
 	let body;
 	if (outcome.status === "fulfilled") body = (outcome.logs.length > 0 ? [...outcome.logs, renderModelValue(outcome.value)] : [renderModelValue(outcome.value)]).join("\n");
@@ -4965,7 +5032,7 @@ function renderToolResult(outcome) {
 		fullOutputPath
 	};
 }
-// ../ptc/src/render.ts
+// src/ptc-render.ts
 function renderPtcResult(surface) {
 	return (result, options, _theme, context) => {
 		const args = context.args;
@@ -4984,14 +5051,14 @@ function renderPtcResult(surface) {
 		if (options.expanded && !options.isPartial) for (const block of result.content) {
 			if (block.type !== "text") continue;
 			const lines = block.text.split("\n");
-			const kept = lines.slice(0, RENDER_BOUNDS$1.MAX_LOG_LINES_EXPANDED);
+			const kept = lines.slice(0, RENDER_BOUNDS.MAX_LOG_LINES_EXPANDED);
 			for (const line of kept) box.addChild(new Text(line));
 			if (lines.length > kept.length) box.addChild(new Text(`…（共 ${lines.length} 行，省略 ${lines.length - kept.length} 行）`));
 		}
 		return box;
 	};
 }
-// ../ptc/src/tools.ts
+// src/ptc-tools.ts
 const RUN_CODE_PARAMETERS = _Object_({
 	code: String$1({ description: "要执行的 TypeScript 程序体，可用顶层 await 和 return" }),
 	description: String$1({ description: "这段程序要干什么（给人看的一行）" }),
@@ -5106,22 +5173,66 @@ function validateWorkflowArgs(args) {
 		throw new Error(`workflow args 必须是 JSON 值：${error instanceof Error ? error.message : String(error)}`);
 	}
 }
-// ../task/src/list-tasks.ts
-function selectVisibleTasks(records, recentCompletedLimit = 10) {
-	const inFlight = records.filter((record) => !isTerminal(record.status));
-	const recentCompleted = records.filter((record) => isTerminal(record.status)).sort((a, b) => (b.finishedAt ?? 0) - (a.finishedAt ?? 0)).slice(0, recentCompletedLimit);
-	return [...inFlight, ...recentCompleted];
-}
-function taskFaceVisible(records) {
-	return records.length > 0;
-}
-// ../task/src/lifecycle.ts
-function listTasks(registry, recentCompletedLimit) {
-	return selectVisibleTasks(registry.list(), recentCompletedLimit);
+// src/ptc-bindings.ts
+const KNOWN_BINDING_NAMES = [
+	"read",
+	"bash",
+	"grep",
+	"find",
+	"ls",
+	"edit",
+	"write"
+];
+const OPT_IN_BINDING_NAMES = ["bash"];
+const DEFAULT_BINDING_NAMES = KNOWN_BINDING_NAMES.filter((name) => !OPT_IN_BINDING_NAMES.includes(name));
+function resolveBindingNames(activeToolNames, optIns = []) {
+	const allowed = /* @__PURE__ */ new Set([...DEFAULT_BINDING_NAMES, ...optIns]);
+	return KNOWN_BINDING_NAMES.filter((name) => activeToolNames.includes(name) && allowed.has(name));
 }
-function faceVisible(registry) {
-	return taskFaceVisible(registry.list());
+// src/task-binding.ts
+const TASK_BINDING_NAME = "pi_task_ptc";
+const TASK_DOOR_PARAMETERS = _Object_({
+	task: String$1({
+		minLength: 1,
+		description: TASK_DOOR_PARAM_DESCRIPTIONS.task
+	}),
+	agent: Optional(String$1({ description: TASK_DOOR_PARAM_DESCRIPTIONS.agent })),
+	why: Optional(String$1({ description: TASK_DOOR_PARAM_DESCRIPTIONS.why })),
+	agentScope: Optional(Union([
+		Literal("user"),
+		Literal("project"),
+		Literal("both")
+	], { description: TASK_DOOR_PARAM_DESCRIPTIONS.agentScope })),
+	model: Optional(String$1({ description: TASK_DOOR_PARAM_DESCRIPTIONS.model })),
+	thinkingLevel: Optional(String$1({ description: TASK_DOOR_PARAM_DESCRIPTIONS.thinkingLevel })),
+	wait: Optional(Boolean$1({ description: TASK_DOOR_PARAM_DESCRIPTIONS.wait })),
+	label: Optional(String$1({ description: TASK_DOOR_PARAM_DESCRIPTIONS.label })),
+	readOnly: Optional(Union([Literal("strict"), Literal("lenient")], { description: TASK_DOOR_PARAM_DESCRIPTIONS.readOnly })),
+	timeoutMs: Optional(Number$1({ description: TASK_DOOR_PARAM_DESCRIPTIONS.timeoutMs })),
+	projectContext: Optional(Union([Literal("auto"), Literal("none")], { description: TASK_DOOR_PARAM_DESCRIPTIONS.projectContext }))
+});
+function createTaskBinding(door) {
+	return {
+		name: TASK_BINDING_NAME,
+		parameters: TASK_DOOR_PARAMETERS,
+		execute(args) {
+			const input = args ?? {};
+			return door.createTask(input.task, {
+				label: input.label,
+				wait: input.wait,
+				why: input.why,
+				model: input.model,
+				thinkingLevel: input.thinkingLevel,
+				agent: input.agent,
+				agentScope: input.agentScope,
+				readOnly: input.readOnly,
+				timeoutMs: input.timeoutMs,
+				projectContext: input.projectContext
+			});
+		}
+	};
 }
+const TASK_RECORDS_BINDING_NAME = "task_records";
 // src/session.ts
 function assemblePtcSession(options = {}) {
 	const registry = new TaskRegistry(options.onTransition);
@@ -5139,14 +5250,46 @@ function assemblePtcSession(options = {}) {
 			...opts,
 			task
 		}),
-		listTasks: (recentCompletedLimit) => listTasks(registry, recentCompletedLimit),
+		taskListSnapshot: (query) => taskListSnapshot(registry, query),
 		stopTask: (taskId, reason) => engine.stop(taskId, reason),
 		faceVisible: () => faceVisible(registry),
 		shutdown: () => engine.shutdown(),
 		readOutput: (taskId) => engine.readOutput(taskId),
 		outputSize: (taskId) => engine.outputSize(taskId),
 		readOutputTail: (taskId, maxBytes) => engine.readOutputTail(taskId, maxBytes),
-		readArchivedRecord: (taskId) => engine.readArchivedRecord(taskId)
+		readArchivedRecord: (taskId) => engine.readArchivedRecord(taskId),
+		readArchivedRecords: () => engine.readArchivedRecords(),
+		get sessionId() {
+			return options.context?.sessionId;
+		}
+	};
+}
+/**
+* 引擎运行时上下文：孩子的模型默认继承父会话的当前模型。
+* 优先级（旧 ADR-0044）：调用参数 → agent 定义 → 会话模型（缺省继承）。
+* sessionModel 是活 getter——派发那一刻才读，用户中途换模型也跟着换；
+* floor 0.86 也有 ctx.model（实测 0.86.0 的 ExtensionContext.model 同为活 getter，provider/id 同形）→ 无版本门；
+* 会话没有模型 → undefined → 不发 --model；扩展被卸载后 ctx 的 getter 会抛（pi 的 assertActive）→ 吞掉退回旧行为。
+*/
+function buildEngineContext(ctx, piVersion) {
+	return {
+		depth: 0,
+		piVersion,
+		get sessionModel() {
+			try {
+				const model = ctx.model;
+				return model ? `${model.provider}/${model.id}` : void 0;
+			} catch {
+				return;
+			}
+		},
+		get sessionId() {
+			try {
+				return ctx.sessionManager.getSessionId();
+			} catch {
+				return;
+			}
+		}
 	};
 }
 // src/index.ts
@@ -5250,10 +5393,7 @@ function piPtcEntry(pi) {
 		session = assemblePtcSession({
 			onTransition: () => applyTaskFaceVisibility(),
 			whyEnabled: () => whyEnabledOverride ?? whyEnabledPersisted,
-			context: {
-				depth: 0,
-				piVersion
-			},
+			context: buildEngineContext(ctx, piVersion),
 			engine: {
 				notifications,
 				resolveAgent: (name, scope) => findAgent(name, agentDirs, scope),
@@ -5329,11 +5469,34 @@ function piPtcEntry(pi) {
 		};
 		registerTaskFace(registerTracked, session, surface);
 		applyTaskFaceVisibility();
+		let compactReminderPending = false;
+		pi.on("session_compact", () => {
+			compactReminderPending = true;
+		});
+		pi.on("context", (event) => {
+			if (!compactReminderPending) return void 0;
+			compactReminderPending = false;
+			const reminder = compactedTaskReminder(session.registry);
+			if (!reminder) return void 0;
+			return { messages: [...event.messages, {
+				role: "user",
+				content: [{
+					type: "text",
+					text: reminder
+				}],
+				timestamp: Date.now()
+			}] };
+		});
 		let toolContext;
-		const getBindings = () => createBindingTable(pi, session, () => toolContext);
+		const cwd = process.cwd();
+		const getBindings = () => createBindingTable(pi, session, () => toolContext, {
+			cwd,
+			extCtx: ctx,
+			piVersion
+		});
 		registerPtcTools(registerTracked, {
 			getBindings,
-			cwd: process.cwd(),
+			cwd,
 			surface,
 			getPool: () => pool,
 			onToolContext: (ctx) => {
@@ -5465,13 +5628,52 @@ function normalizeToolValue(value) {
 	}
 	return value;
 }
-function createBindingTable(pi, session, getToolContext) {
+const PI_TOOL_FACTORIES = Object.fromEntries([
+	"read",
+	"write",
+	"edit",
+	"grep",
+	"ls",
+	"find"
+].map((name) => [name, piHost[`create${name[0].toUpperCase()}${name.slice(1)}ToolDefinition`]]));
+function hasNestedToolCalls(piVersion) {
+	if (!piVersion) return true;
+	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 true;
+	return M > 0 || M === 0 && m >= 99;
+}
+function createBindingTable(pi, session, getToolContext, env) {
+	const { cwd, extCtx, piVersion } = env;
 	const active = pi.getActiveTools();
 	const known = new Set(KNOWN_BINDING_NAMES);
 	const names = resolveBindingNames(!getToolContext() && !active.some((name) => known.has(name)) ? pi.getAllTools().map((tool) => tool.name) : active);
+	let piTools;
+	const piToolFor = (name) => {
+		if (!piTools) {
+			piTools = {};
+			for (const [tool, factory] of Object.entries(PI_TOOL_FACTORIES)) if (typeof factory === "function") piTools[tool] = factory(cwd);
+		}
+		return piTools[name];
+	};
 	const table = Object.fromEntries(names.map((name) => [name, async (args, callCtx) => {
 		const ctx = getToolContext();
-		if (!ctx?.executeTool) throw new Error(`此 pi 版本没有程序内调用工具的通道（需 pi ≥ 0.99，binding: ${name}）`);
+		if (!ctx?.executeTool) {
+			const def = hasNestedToolCalls(piVersion) ? void 0 : piToolFor(name);
+			if (!def) throw new Error(`此 pi 版本没有程序内调用工具的通道（需 pi ≥ 0.99，binding: ${name}）`);
+			const prepared = def.prepareArguments ? def.prepareArguments(args) : args;
+			const result = await def.execute(`ptc-${name}`, prepared, callCtx.signal, void 0, extCtx);
+			for (const block of result.content ?? []) if (block.type === "image") callCtx.emitImage(block);
+			if (result.isError) {
+				const text = (result.content ?? []).map((block) => {
+					const obj = block;
+					return obj.type === "text" ? obj.text ?? "" : `[${obj.type ?? "block"}]`;
+				}).join("\n");
+				throw new Error(text || `工具 ${name} 执行失败`);
+			}
+			return normalizeToolValue(result.structuredContent ?? result.content);
+		}
 		const outcome = await ctx.executeTool(name, args, { signal: callCtx.signal });
 		for (const block of outcome.result.content) if (block.type === "image") callCtx.emitImage(block);
 		if (outcome.isError) {
@@ -5482,6 +5684,11 @@ function createBindingTable(pi, session, getToolContext) {
 	}]));
 	const taskBinding = createTaskBinding(session);
 	table[TASK_BINDING_NAME] = async (args) => withDeliveryNote(await taskBinding.execute(args));
+	table[TASK_RECORDS_BINDING_NAME] = async (args) => {
+		const records = session.registry.list();
+		if (args?.scope !== "all") return records;
+		return [...records, ...await session.readArchivedRecords()];
+	};
 	return table;
 }
 function registerPtcTools(registerTool, options, surface) {
@@ -5494,9 +5701,23 @@ function registerTaskFace(registerTool, session, surface) {
 		name: "ptc_task_list",
 		label: "任务列表",
 		description: TOOLS.ptc_task_list.description(surface),
-		parameters: _Object_({}),
+		parameters: _Object_({
+			scope: Optional(Union([Literal("recent"), Literal("all")], { description: "recent = 只热存（默认）；all = 含压缩归档（更全但更慢）" })),
+			limit: Optional(Number$1({ description: "取多少条（默认 50，上限 200）" })),
+			status: Optional(Union(TASK_STATUSES.map((s) => Literal(s)), { description: "只看某个状态" })),
+			session: Optional(String$1({ description: "按会话筛：current = 本会话，或给一个会话 id" }))
+		}),
 		defaultActive: false,
-		execute: async () => textResult(session.listTasks())
+		execute: async (_id, args) => {
+			const query = {
+				scope: args.scope,
+				limit: args.limit,
+				status: args.status,
+				session: args.session === "current" ? session.sessionId : args.session
+			};
+			const archived = query.scope === "all" ? await session.readArchivedRecords() : [];
+			return textResult(taskListSnapshot(session.registry, query, archived));
+		}
 	});
 	registerTool({
 		name: "ptc_task_output",
@@ -5507,24 +5728,9 @@ function registerTaskFace(registerTool, session, surface) {
 		execute: async (_id, args) => {
 			const record = session.registry.get(args.task_id) ?? await session.readArchivedRecord(args.task_id);
 			if (!record) return textResult({ error: `unknown task id ${args.task_id}` });
-			const outputBytes = await session.outputSize(args.task_id);
-			if (outputBytes === void 0) return textResult(withDeliveryNote(record));
-			if (outputBytes > 51200) {
-				const { text } = applyAdr0015Truncation$1(await session.readOutputTail(args.task_id, 51200) ?? "");
-				return textResult(withDeliveryNote({
-					...record,
-					output: text,
-					guidance: renderLongOutputGuidance({
-						bytes: outputBytes,
-						report: record.report,
-						reportChannel: record.reportChannel ?? "none"
-					})
-				}));
-			}
-			const { text } = applyAdr0015Truncation$1(await session.readOutputTail(args.task_id, 51200) ?? "");
 			return textResult(withDeliveryNote({
 				...record,
-				output: text
+				...await readTaskOutput(session, record)
 			}));
 		}
 	});
@@ -5569,4 +5775,4 @@ function registerTaskDoor(registerTool, session, surface) {
 		}
 	});
 }
-export { assemblePtcSession, piPtcEntry as default, withDeliveryNote };
+export { assemblePtcSession, buildEngineContext, piPtcEntry as default, withDeliveryNote };