@zhushanwen/subagent-core 0.6.0 → 0.7.0

package/src/execution/engine/engines/pi/spawn-event-adapter.ts

@@ -1,404 +0,0 @@
-// src/execution/engine/engines/pi/spawn-event-adapter.ts
-//
-// pi 子进程 stdout JSON 事件流的解析器。Core 叶子原语（仅依赖 types.ts）。
-//
-// spawn 改造的基座模块。session-runner runSpawn 用 `pi --mode rpc` spawn 子进程。
-// RPC mode 不向 stdout 输出 header 行（只有 json/print mode 才输出），故 runSpawn 额外
-// 通过 get_state RPC 握手回填 sessionFile/sessionId。两种 stdout 行形态本模块统一解析：
-//   1. header 行（json/print mode 首行）：{ type: "session", id, timestamp, cwd, ... }
-//      —— session 元信息，含 session id（RPC mode 不发，靠 get_state 握手替代）
-//   2. 事件行：{ type: "tool_execution_start" | "message_end" | ..., ... }
-//      —— 与 in-process session.subscribe 收到的 SdkEvent 同源同构
-//
-// 本模块只做「行 → 分类事件对象」的纯解析，不做累积/翻译（那是 runSpawn +
-// handleSdkEvent 的职责）。刻意保持薄，便于单测。
-//
-// 与 session-runner.handleSdkEvent 的契约：parseSpawnLine 返回 kind:"event" 的
-// event 字段即为 SdkEvent，可直接喂给 handleSdkEvent（事件 type schema 一致，
-// 由 print-mode.ts:106 JSON.stringify(event) 保证同源）。
-
-import * as fs from "node:fs";
-import * as path from "node:path";
-
-import type { SdkEvent } from "../../../types.ts";
-import { toErrorMessage } from "../../../../core/error-message.ts";
-
-/** pi stdout header 行（session 元信息）。type 固定为 "session"。 */
-export interface SpawnSessionHeader {
-  readonly type: "session";
-  readonly id: string;
-  readonly timestamp: string;
-  readonly cwd: string;
-  readonly parentSession?: string;
-  readonly version?: number;
-}
-
-/** Pi 原生 extension_ui_request 的方法特定字段（按 method 平铺）。
- *  与 Pi rpc-types.ts L230-265 的 RpcExtensionUIRequest 1:1 对应。
- *  method 是判别字段；每个变体仅列出该 method 的已知字段（可选字段保持可选）。
- *  未知 method 走 string fallback（保留 raw 字段，避免协议演进时丢字段）。 */
-export type ExtensionUiRequest =
-  | { method: "select"; title: string; options: string[]; timeout?: number }
-  | { method: "confirm"; title: string; message: string; timeout?: number }
-  | { method: "input"; title: string; placeholder?: string; timeout?: number }
-  | { method: "editor"; title: string; prefill?: string }
-  | { method: "notify"; message: string; notifyType?: "info" | "warning" | "error" }
-  | { method: "setStatus"; statusKey: string; statusText: string | undefined }
-  | {
-      method: "setWidget";
-      widgetKey: string;
-      widgetLines: string[] | undefined;
-      widgetPlacement?: "aboveEditor" | "belowEditor";
-    }
-  | { method: "setTitle"; title: string }
-  | { method: "set_editor_text"; text: string }
-  // 未知 method fallback：保留原始字段，避免协议演进时丢信息
-  | { method: string; raw: Record<string, unknown> };
-
-/** 解析后的 extension_ui_request 顶层形状（type 守卫用）。
- *  id 和 method 在顶层，method 特定字段平铺（与 Pi 原生格式一致）。 */
-interface ExtensionUiRequestEnvelope {
-  type: "extension_ui_request";
-  id: string;
-  method: string;
-  [key: string]: unknown;
-}
-
-/** Pi 原生 RPC response 顶层形状（type 守卫用）。
- *  与 Pi rpc-types.ts 的 RpcResponse 一致：type:"response" + command + success。 */
-interface RpcResponseEnvelope {
-  type: "response";
-  command: string;
-  success: boolean;
-  id?: string;
-  data?: unknown;
-  error?: string;
-  [key: string]: unknown;
-}
-
-/** parseSpawnLine 的分类结果。
- *
- *  关键改动（W1 协议层重写）：
- *    - extension_ui_request 分支：从 {id, params:Record} 改为 {id, request: ExtensionUiRequest}
- *      （request 按 method 平铺，与 Pi rpc-types.ts 1:1）
- *    - response 分支：从 {id, result, error} 改为 {id?, command, success, data?, error?}
- *      （Pi 原生 RpcResponse 格式，SR-1 根因 1b） */
-export type ParsedSpawnLine =
-  | { kind: "header"; header: SpawnSessionHeader }
-  | { kind: "event"; event: SdkEvent }
-  | {
-      kind: "response";
-      id?: string;
-      command: string;
-      success: boolean;
-      data?: unknown;
-      error?: string;
-    }
-  | { kind: "extension_ui_request"; id: string; request: ExtensionUiRequest }
-  | { kind: "invalid"; raw: string; error: string };
-
-/**
- * 判断解析出的 JSON 是否为 header 行（type === "session"）。
- * 校验所有必需字段（id/timestamp/cwd），缺任一则不收窄——避免下游
- * deriveSessionFilePath 访问 undefined 字段时抛 TypeError。
- */
-function isSessionHeader(obj: unknown): obj is SpawnSessionHeader {
-  if (typeof obj !== "object" || obj === null) return false;
-  const r = obj as Record<string, unknown>;
-  return (
-    r.type === "session" &&
-    typeof r.id === "string" &&
-    typeof r.timestamp === "string" &&
-    typeof r.cwd === "string"
-  );
-}
-
-/**
- * 判断解析出的 JSON 是否为 Pi 原生 RPC response。
- *
- * SR-1 根因 1b 修复：旧守卫判 JSON-RPC 2.0（jsonrpc + id + result/error），
- * 但 Pi 实际发 {type:"response", command, success, data?, error?}。
- * 新守卫只认 Pi 原生格式：
- *   - type === "response"
- *   - command: string（调用的命令名，如 "run_tool"）
- *   - success: boolean
- * id 可选（通知型 response 无 id）。
- *
- * 旧 JSON-RPC 2.0 response（{jsonrpc, id, result}）不再被识别 → 落 invalid 分支。
- */
-function isRpcResponse(obj: unknown): obj is RpcResponseEnvelope {
-  if (typeof obj !== "object" || obj === null) return false;
-  const r = obj as Record<string, unknown>;
-  return (
-    r.type === "response" &&
-    typeof r.command === "string" &&
-    typeof r.success === "boolean"
-  );
-}
-
-/**
- * 判断解析出的 JSON 是否为 Pi 原生 extension_ui_request。
- *
- * 关键改动（W1）：旧守卫判 JSON-RPC 2.0（jsonrpc + method:"extension_ui_request" + params），
- * 但 Pi 实际发平铺格式 {type:"extension_ui_request", id, method, ...method特定字段}。
- * 新守卫：
- *   - type === "extension_ui_request"（顶层 type 字段，非 method 字段值）
- *   - id: string
- *   - method: string（select/confirm/.../set_editor_text 等具体方法名）
- *
- * 删掉 jsonrpc 守卫（Pi 不发 JSON-RPC 2.0 envelope）和 params 守卫（字段平铺，无 params 包裹）。
- * 旧 JSON-RPC 2.0 格式（{jsonrpc, method:"extension_ui_request", params}）不再被识别。
- */
-function isExtensionUiRequest(obj: unknown): obj is ExtensionUiRequestEnvelope {
-  if (typeof obj !== "object" || obj === null) return false;
-  const r = obj as Record<string, unknown>;
-  return (
-    r.type === "extension_ui_request" &&
-    typeof r.id === "string" &&
-    typeof r.method === "string"
-  );
-}
-
-/** 必填 string 字段提取：类型不符降级空串（字段容错——仍归类已知 method，不丢 method 信息）。 */
-function reqStr(r: Record<string, unknown>, key: string): string {
-  const v = r[key];
-  return typeof v === "string" ? v : "";
-}
-
-/** string[] 字段提取：数组剔除非字符串元素；非数组降级 onMissing（options 传 []，
- *  widgetLines 传 undefined——两者对缺失值的载荷语义不同：前者恒挂键，后者键挂值 undefined）。 */
-function strArrayField<T extends string[] | undefined>(
-  r: Record<string, unknown>,
-  key: string,
-  onMissing: T,
-): string[] | T {
-  const v = r[key];
-  return Array.isArray(v)
-    ? v.filter((x): x is string => typeof x === "string")
-    : onMissing;
-}
-
-/** timeout 条件展开：非 number 不挂键（timeout?: number 的字段省略语义）。 */
-function optTimeout(r: Record<string, unknown>): { timeout?: number } {
-  return typeof r.timeout === "number" ? { timeout: r.timeout } : {};
-}
-
-/** placeholder 条件展开：非 string 不挂键。 */
-function optPlaceholder(r: Record<string, unknown>): { placeholder?: string } {
-  return typeof r.placeholder === "string" ? { placeholder: r.placeholder } : {};
-}
-
-/** prefill 条件展开：非 string 不挂键。 */
-function optPrefill(r: Record<string, unknown>): { prefill?: string } {
-  return typeof r.prefill === "string" ? { prefill: r.prefill } : {};
-}
-
-/** notifyType 条件展开：仅接受三种已知枚举值，其余不挂键。 */
-function optNotifyType(
-  r: Record<string, unknown>
-): { notifyType?: "info" | "warning" | "error" } {
-  const v = r.notifyType;
-  return v === "info" || v === "warning" || v === "error" ? { notifyType: v } : {};
-}
-
-/** widgetPlacement 条件展开：仅接受两种已知枚举值，其余不挂键。 */
-function optWidgetPlacement(
-  r: Record<string, unknown>
-): { widgetPlacement?: "aboveEditor" | "belowEditor" } {
-  const v = r.widgetPlacement;
-  return v === "aboveEditor" || v === "belowEditor" ? { widgetPlacement: v } : {};
-}
-
-/**
- * 从已通过 isExtensionUiRequest 守卫的 envelope 构造 ExtensionUiRequest 变体。
- *
- * 按 method 平铺提取字段（与 Pi rpc-types.ts L230-265 1:1）。已知 method
- * 走对应变体；未知 method 走 string fallback（保留 raw 字段全量字段）。
- *
- * 字段类型容错：协议字段类型不符（如 options 非数组）时，该字段降级为空数组/undefined
- *（数组类字段做元素类型过滤，剔除非字符串元素），仍归类为已知 method（不丢 method 信息）。
- * 字段级提取/条件展开由上方字段 helper 承担，本函数只做 method 分发。
- */
-function buildExtensionUiRequest(env: ExtensionUiRequestEnvelope): ExtensionUiRequest {
-  const r: Record<string, unknown> = env;
-  switch (env.method) {
-    case "select":
-      return {
-        method: "select",
-        title: reqStr(r, "title"),
-        options: strArrayField(r, "options", []),
-        ...optTimeout(r),
-      };
-    case "confirm":
-      return {
-        method: "confirm",
-        title: reqStr(r, "title"),
-        message: reqStr(r, "message"),
-        ...optTimeout(r),
-      };
-    case "input":
-      return {
-        method: "input",
-        title: reqStr(r, "title"),
-        ...optPlaceholder(r),
-        ...optTimeout(r),
-      };
-    case "editor":
-      return {
-        method: "editor",
-        title: reqStr(r, "title"),
-        ...optPrefill(r),
-      };
-    case "notify":
-      return {
-        method: "notify",
-        message: reqStr(r, "message"),
-        ...optNotifyType(r),
-      };
-    case "setStatus":
-      return {
-        method: "setStatus",
-        statusKey: reqStr(r, "statusKey"),
-        statusText: typeof r.statusText === "string" ? r.statusText : undefined,
-      };
-    case "setWidget":
-      return {
-        method: "setWidget",
-        widgetKey: reqStr(r, "widgetKey"),
-        widgetLines: strArrayField(r, "widgetLines", undefined),
-        ...optWidgetPlacement(r),
-      };
-    case "setTitle":
-      return {
-        method: "setTitle",
-        title: reqStr(r, "title"),
-      };
-    case "set_editor_text":
-      return {
-        method: "set_editor_text",
-        text: reqStr(r, "text"),
-      };
-    default:
-      // 未知 method：保留全部原始字段，避免协议演进时丢信息
-      return { method: env.method, raw: r };
-  }
-}
-
-/**
- * 解析 pi stdout 的一行。
- *
- * @param line stdout 的一行（不含换行符；空行返回 null）
- * @returns 分类结果，或 null（空行/仅空白）
- *
- * 分类规则（判定顺序关键，见 W1 bug 修复）：
- *   - 空白行 → null（pi 可能输出空行，跳过）
- *   - 合法 JSON + type:"session" + 必需字段 → header
- *   - 合法 JSON + type:"extension_ui_request" + id + method → extension_ui_request
- *     （必须在 event 分支之前，否则被 typeof obj.type===string 吞为 event）
- *   - 合法 JSON + type:"response" + command + success → response
- *   - 合法 JSON + 有 type 字段 → event（SdkEvent，type schema 由调用方校验）
- *   - 合法 JSON 但无 type → invalid
- *   - 非法 JSON → invalid（记录 error，不抛——单行损坏不应中断整个流）
- *
- * 容错原则：stdout 是流式输出，任何单行解析失败都不应中断进程。invalid 归类
- * 由 runSpawn 决定是否记录/忽略，本函数不丢弃信息。
- */
-export function parseSpawnLine(line: string): ParsedSpawnLine | null {
-  const trimmed = line.trim();
-  if (trimmed === "") return null;
-
-  let obj: unknown;
-  try {
-    obj = JSON.parse(trimmed);
-  } catch (err) {
-    return {
-      kind: "invalid",
-      raw: trimmed,
-      error: toErrorMessage(err),
-    };
-  }
-
-  if (isSessionHeader(obj)) {
-    return { kind: "header", header: obj };
-  }
-
-  // extension_ui_request：必须在 event 分支之前判定（W1 判定顺序 bug 修复）。
-  // 原因：extension_ui_request 也有 type 字段，若 event 分支（typeof obj.type===string）
-  // 在前，会被当 event 静默吞掉。现在先于 event 判定，命中后按 method 构造 request。
-  if (isExtensionUiRequest(obj)) {
-    return { kind: "extension_ui_request", id: obj.id, request: buildExtensionUiRequest(obj) };
-  }
-
-  // RPC response：Pi 原生格式 {type:"response", command, success, data?, error?}
-  if (isRpcResponse(obj)) {
-    return {
-      kind: "response",
-      ...(typeof obj.id === "string" ? { id: obj.id } : {}),
-      command: obj.command,
-      success: obj.success,
-      ...(obj.data !== undefined ? { data: obj.data } : {}),
-      ...(typeof obj.error === "string" ? { error: obj.error } : {}),
-    };
-  }
-
-  // 事件行：必须有 type 字段（SdkEvent 契约）
-  if (
-    typeof obj === "object" &&
-    obj !== null &&
-    typeof (obj as Record<string, unknown>).type === "string"
-  ) {
-    return { kind: "event", event: obj as SdkEvent };
-  }
-
-  return {
-    kind: "invalid",
-    raw: trimmed,
-    error: "JSON missing string 'type' field",
-  };
-}
-
-/**
- * 从已收集的 header + 事件流推导子进程的 session 文件路径。
- *
- * pi session 文件命名规则（session-manager.ts:846）：
- *   `${fileTimestamp}_${sessionId}.jsonl`
- * 其中 fileTimestamp = header.timestamp.replace(/[:.]/g, "-")
- * （ISO 时间里的冒号和点替换为连字符，如 2026-07-03T12-34-56-789Z）。
- *
- * @param header spawn 解析出的 session header
- * @param sessionDir 指定的 session 目录（spawn 时通过 --session-dir 传入）
- * @returns 推导的 session 文件绝对路径（不保证文件存在——子进程可能仍在写入）
- *
- * 注意：这是基于 pi 命名规则的推导。runSpawn 会在进程结束后校验文件实际存在，
- * 不存在时用 sessionId 后缀匹配兜底。
- */
-export function deriveSessionFilePath(
-  header: SpawnSessionHeader,
-  sessionDir: string,
-): string {
-  const fileTimestamp = header.timestamp.replace(/[:.]/g, "-");
-  return `${sessionDir}/${fileTimestamp}_${header.id}.jsonl`;
-}
-
-/**
- * 在 sessionDir 中按 sessionId 后缀匹配查找实际存在的 session 文件。
- *
- * 兜底机制：deriveSessionFilePath 基于命名规则推导，若 pi 命名规则变化导致
- * 推导路径不存在，用 sessionId 作为后缀匹配实际文件。sessionId 是 header
- * 的稳定标识，文件名必含它，匹配可靠。
- *
- * @returns 匹配到的文件绝对路径，或 undefined（无匹配）
- */
-export function findSessionFileByHeaderId(
-  sessionDir: string,
-  sessionId: string,
-): string | undefined {
-  try {
-    const files = fs.readdirSync(sessionDir);
-    // 文件名格式：<fileTimestamp>_<sessionId>.jsonl，sessionId 是后缀（去掉 .jsonl）
-    const match = files.find((f) => f.endsWith(`_${sessionId}.jsonl`));
-    return match ? path.join(sessionDir, match) : undefined;
-  } catch {
-    return undefined;
-  }
-}

package/src/execution/engine/engines/pi/stdin-writer.ts

@@ -1,199 +0,0 @@
-// src/execution/engine/engines/pi/stdin-writer.ts
-//
-// 向 rpc 子进程 stdin 写入命令的 helper 集合。
-//
-// pi --mode rpc 通过 stdin 的 JSON RpcCommand / RpcExtensionUIResponse 驱动：
-//   - extension_ui_response（主进程回答子进程的 UI 请求，如 ask_user）
-//   - prompt（驱动子进程开始处理 task）
-// 两者共用 child.stdin.write + 背压检查，提取到此模块统一维护。
-
-import type { ChildProcess } from "node:child_process";
-import * as crypto from "node:crypto";
-
-import { getLogger } from "../../../../core/logger.ts";
-
-import type { UiResponse } from "../../../dialog-queue.ts";
-import { toErrorMessage } from "../../../../core/error-message.ts";
-
-const logger = getLogger("subagents");
-
-/**
- * EPIPE 连续失败计数器（record.id → 连续 EPIPE 次数）。
- *
- * [v4 A-1] 计数器从 subagent-service.ts 迁移到本模块（stdin 错误域）。迁移原因：
- * session-runner.ts 已被 subagent-service.ts import（runSpawn 等），若 session-runner
- * 反向 import subagent-service 的 helper 会循环依赖。stdin-writer 不 import 两者，
- * 是 stdin 域中立模块，epipe 计数属 stdin 错误域，职责合理。
- *
- * 错误处理两半面共用本计数器（合并计数，防 spawn→EPIPE→resume 死循环）：
- *   ① 同步 write 抛错（writeStdinLine throw → PiEngine.deliverPrompt catch 递增）
- *   ② 异步 stream 'error' event（session-runner.ts child.stdin.on('error') 递增）
- */
-const epipeConsecutiveFailures = new Map<string, number>();
-
-/** 连续 EPIPE 失败阈值：达到即不再尝试 resume（避免无限 spawn → EPIPE → resume 循环）。 */
-export const EPIPE_FAILURE_THRESHOLD = 2;
-
-/**
- * 递增 recordId 的 EPIPE 连续失败计数，返回递增后的新计数。
- * 同步 writeStdinLine throw 与异步 child.stdin 'error' event 共用此入口（合并计数）。
- */
-export function recordEpipeFailure(recordId: string): number {
-  const count = (epipeConsecutiveFailures.get(recordId) ?? 0) + 1;
-  epipeConsecutiveFailures.set(recordId, count);
-  return count;
-}
-
-/** 成功写入时清零某 record 的 EPIPE 连续失败计数（热路径成功 → 重置，允许后续重新计数）。 */
-export function clearEpipeFailure(recordId: string): void {
-  epipeConsecutiveFailures.delete(recordId);
-}
-
-/** dispose 时清空所有 EPIPE 计数（防跨 session 泄漏）。 */
-export function resetAllEpipeFailures(): void {
-  epipeConsecutiveFailures.clear();
-}
-
-/**
- * 按 UiResponse 形状构造 Pi 原生 extension_ui_response 并写 stdin。
- *
- * SR-5：ack（fire-and-forget）不写 stdin——Pi 对 fire-and-forget method 不期待响应，
- * 写入会触发协议错配。其他三种 shape（value/confirmed/cancelled）按对应字段写。
- *
- * [R1] 背压检查：child.stdin.write 返回 false 时记 warn（不阻塞，内核缓冲会随后排空）。
- * [R2] 序列化在本函数内逐分支完成。JSON.stringify 可能抛错（out.value 含循环引用 /
- *     BigInt 等不可序列化结构），try/catch 降级为 cancelled——宁可取消单次 dialog 也不让
- *     父进程崩溃（UI 请求通道不应被脏数据拖垮）。
- *
- * @param child 子进程（stdin 写入响应）
- * @param id 请求 id（关联 response）
- * @param out UiResponse（{value}/{confirmed}/{cancelled}/{ack}）
- * @param signal abort signal（已 aborted 时跳过写入）
- */
-export function respond(child: ChildProcess, id: string, out: UiResponse, signal?: AbortSignal): void {
-  if (signal?.aborted) return;
-  let line: string | undefined;
-  try {
-    if ("value" in out) line = JSON.stringify({ type: "extension_ui_response", id, value: out.value });
-    else if ("confirmed" in out) line = JSON.stringify({ type: "extension_ui_response", id, confirmed: out.confirmed });
-    else if ("cancelled" in out) line = JSON.stringify({ type: "extension_ui_response", id, cancelled: true });
-  } catch (err) {
-    // [R2] out.value 含循环引用/BigInt 等不可序列化结构——降级 cancelled，避免父进程崩溃。
-    logger.warn(`[subagents] JSON.stringify failed for ui response ${id}, degrading to cancelled`, {
-      detail: toErrorMessage(err),
-    });
-    line = JSON.stringify({ type: "extension_ui_response", id, cancelled: true });
-  }
-  // ack: fire-and-forget，不写 stdin（SR-5）
-  if (line === undefined) return;
-  writeStdinLine(child, line, `ui response for request ${id}`);
-}
-
-/**
- * spawn 后向 rpc 子进程 stdin 写 prompt 命令，驱动 agent 开始处理 task。
- *
- * pi 的 runRpcMode 只通过 stdin RpcCommand 驱动——positional task arg / -p flag
- * 在 rpc mode 下被 resolveAppMode 无视。必须在 spawn 后主动喂 prompt 命令，
- * 否则子进程阻塞等 stdin、永不进入推理（totalTokens 恒 0）。
- *
- * 时机：spawn 后立即写。stdin 是 pipe，内核缓冲保证数据不丢；
- * pi 在 await rebindSession() 后才挂 stdin reader（rpc-mode.ts:778-781），
- * reader 处理 prompt 时 session 已就绪。
- *
- * [V2 决策 3] chatMode 续聊热路径用 prompt + streamingBehavior 统一投递（替代 steer/followUp
- * 命令），pi 权威裁决 busy/idle（设计 F3/F4）：busy 时 followUp 入队/steer 抢占；idle 时
- * streamingBehavior 被忽略、直接开新 turn。不传 streamingBehavior（首帧 prompt / 旧调用方）
- * 行为完全不变——向后兼容。
- *
- * @param child 子进程（stdin 写入 prompt 命令）
- * @param task 完整 task 文本（含 schema 指令）
- * @param options.streamingBehavior V2 统一投递语义：`"followUp"`（排队，当前轮后处理）/ `"steer"`（抢占，立即中断 streaming）。
- *        省略时不写入该字段（首帧 prompt / 非 chatMode 调用方，行为不变）。
- */
-export function sendPromptCommand(
-  child: ChildProcess,
-  task: string,
-  options?: { streamingBehavior?: "followUp" | "steer" },
-): void {
-  if (!child.stdin || child.stdin.destroyed) return;
-  const payload: Record<string, unknown> = {
-    id: crypto.randomUUID(),
-    type: "prompt",
-    message: task,
-  };
-  if (options?.streamingBehavior) {
-    payload.streamingBehavior = options.streamingBehavior;
-  }
-  writeStdinLine(child, JSON.stringify(payload), "prompt command");
-}
-
-/**
- * [review 修复 round2] 已删除 sendFollowUpCommand / sendSteerCommand——deliverToRunning
- * （busy 投递死机制，S2 删除）的唯一消费方移除后两函数成零生产调用方死 export。
- * busy 投递语义由 prompt + streamingBehavior（sendPromptCommand 的
- * options.streamingBehavior: "followUp" | "steer"，pi 权威裁决）承担。
- */
-
-/**
- * 向 rpc 子进程 stdin 写 get_state 命令，查询 sessionFile/sessionId。
- *
- * FR-4: RPC get_state 握手。当 stdout header 未携带 sessionFile 时，
- * 通过此命令向子进程查询当前 session 状态。子进程收到后返回
- * {type:"response", command:"get_state", success:true, data:{sessionFile, sessionId}}。
- *
- * @param child 子进程（stdin 写入 get_state 命令）
- * @returns 请求 id（用于匹配 response）
- */
-export function sendGetStateCommand(child: ChildProcess): string {
-  const id = crypto.randomUUID();
-  const command = JSON.stringify({
-    id,
-    type: "get_state",
-  });
-  writeStdinLine(child, command, "get_state command");
-  return id;
-}
-
-/**
- * 向子进程 stdin 写一行（自动补换行），带背压检查 + EPIPE 检测。
- *
- * [R1] write 返回 false 时记 warn（不阻塞，内核缓冲会随后排空）。
- * [R3] write 抛 EPIPE / ERR_STREAM_DESTROYED 时 throw 含 EPIPE 关键词的 Error，
- *      让上层（PiEngine.deliverPrompt）能捕获并自动转冷路径 resume。
- * stdin 已关闭/销毁时跳过——respond 已检查 signal，sendPromptCommand 已检查 destroyed。
- *
- * @param child 子进程
- * @param line JSON 行（不含换行）
- * @param warnTag warn 日志的语义标记
- * @throws Error 含 "EPIPE" 关键词——stdin 管道已断（子进程已退出 / stdin 被销毁）
- */
-function writeStdinLine(child: ChildProcess, line: string, warnTag: string): void {
-  if (!child.stdin || child.stdin.destroyed) return;
-  try {
-    const ok = child.stdin.write(line + "\n");
-    if (!ok) logger.warn(`[subagents] stdin backpressure on ${warnTag}`);
-  } catch (err) {
-    // [R3] EPIPE / ERR_STREAM_DESTROYED：stdin 管道已断，子进程已退出或 stdin 被销毁。
-    // [v4 A-1] 错误处理两半面：① 同步 write 抛错（本 catch）——上层（PiEngine.deliverPrompt）捕获后
-    //   调 recordEpipeFailure 递增计数；② 异步 stream 'error' event（session-runner.ts 的
-    //   child.stdin.on('error') listener）。两者共用本模块 export 的 recordEpipeFailure
-    //   helper 合并计数（防 spawn→EPIPE→resume 死循环）。
-    // throw 让上层（PiEngine.deliverPrompt）捕获并自动转冷路径 resume + 消息重放。
-    if (
-      err !== null &&
-      typeof err === "object" &&
-      "code" in err &&
-      ((err as NodeJS.ErrnoException).code === "EPIPE" ||
-        (err as NodeJS.ErrnoException).code === "ERR_STREAM_DESTROYED")
-    ) {
-      throw new Error(
-        `[subagents] EPIPE on stdin write (${warnTag}): pipe broken, child process likely exited. ` +
-          `Recovery: treat as dead process and resume via cold path.`,
-      );
-    }
-    // 非 EPIPE 错误（不应发生，但兜底降级为 warn 不崩溃）
-    logger.warn(`[subagents] unexpected stdin write error on ${warnTag}`, {
-      detail: toErrorMessage(err),
-    });
-  }
-}

package/src/execution/engine/engines/pi/temp-prompt.ts

@@ -1,62 +0,0 @@
-// src/execution/engine/engines/pi/temp-prompt.ts
-//
-// 将 agent systemPrompt 写入临时文件，供 pi CLI --append-system-prompt 使用。
-// Core 叶子原语（node 内置 + 同目录 bestEffort 清理 helper）。注意 bestEffort
-// 经 extension-logger 有到 pi 的传递依赖（仅日志通路，无 pi 运行时调用）。
-//
-// pi CLI 的 --append-system-prompt 接受文件路径（非内联字符串），故 spawn 前
-// 需把 systemPrompt 落盘。每次调用创建唯一临时目录，用完由 runSpawn 清理。
-//
-// 移植自 nicobailon subagent example，去掉 withFileMutationQueue（目录已唯一，
-// 无并发写入风险，queue 冗余）。
-
-import * as fs from "node:fs";
-import * as os from "node:os";
-import * as path from "node:path";
-
-import { bestEffort } from "../../../best-effort.ts";
-
-/** 临时 prompt 文件创建结果。dir 供调用方清理。 */
-export interface TempPromptFile {
-  /** 临时目录绝对路径（mkdtemp 创建，调用方负责删除）。 */
-  dir: string;
-  /** prompt 文件绝对路径（dir 下）。 */
-  filePath: string;
-}
-
-/**
- * 将 systemPrompt 写入临时文件。
- *
- * @param agentName agent 名称（用于文件名，非法字符替换为 _）
- * @param prompt systemPrompt 全文
- * @returns 临时文件信息（dir + filePath）
- *
- * 安全：文件权限 0o600（仅 owner 读写），防止其他用户读取 prompt 内容。
- * 目录用 mkdtemp 保证唯一，无需额外锁。
- */
-export async function writePromptToTempFile(
-  agentName: string,
-  prompt: string,
-): Promise<TempPromptFile> {
-  const dir = await fs.promises.mkdtemp(path.join(os.tmpdir(), "pi-subagent-"));
-  const safeName = agentName.replace(/[^\w.-]+/g, "_");
-  const filePath = path.join(dir, `prompt-${safeName}.md`);
-  await fs.promises.writeFile(filePath, prompt, { encoding: "utf-8", mode: 0o600 });
-  return { dir, filePath };
-}
-
-/**
- * 删除临时 prompt 目录（含文件）。best-effort，失败不抛。
- *
- * runSpawn 的 finally 调用，确保临时文件不泄漏。子进程可能仍持有文件句柄
- * （--append-system-prompt 读取后即释放），rm 用 recursive 容错。
- */
-export async function cleanupTempPrompt(file: TempPromptFile): Promise<void> {
-  try {
-    await fs.promises.rm(file.dir, { recursive: true, force: true });
-  } catch (err) {
-    // best-effort：临时文件泄漏不影响功能，OS tmpdir 清理机制兜底；失败经
-    // bestEffort 记 debug 日志（对齐 idle-gc / finalize-record 的清理惯例）
-    bestEffort(err, `cleanup temp prompt dir ${file.dir}`);
-  }
-}