@zhushanwen/pi-subagent-workflow 8.6.0 → 8.8.0

package/src/execution/__tests__/relay-agent.test.ts

@@ -1,448 +0,0 @@
-// src/execution/__tests__/relay-agent.test.ts
-//
-// relay.mjs 代理 CLI 协议行为集成测试（E-1 验收）——本地环回 socket + 伪 runtime
-// （net.createServer 模拟 runtime 侧行为），spawn 真实代理进程逐条断言：
-//   1. 启动自检：归属 env（SESSION_ID/RECORD_ID）缺失 / socket env 缺失 → 退出码 13
-//   2. socket 不可达（重试一次后仍失败）→ 退出码 11 + stderr 含路径与恢复指引
-//   3. 握手帧字段完整（v/kind/mainSessionId/recordId/argv/env/cwd）
-//   4. down/up/up-stderr 字节往返保真（中文/换行/空字节的二进制 buffer）
-//   5. exit 帧退出码传播 / 退出前 stdout 已 flush
-//   6. exit 帧 signal 传播（spawn 方观察到 (code=null, signal)）
-//   7. socket 断 → 退出码 12（崩溃矩阵②的 extension 侧感知机制）
-//   8. reject version → 退出码 10 + 重装指引；reject 其他 reason → 12
-//   9. 背压：1MB 随机字节经代理双向环回（stdin→down→server→up→stdout）收齐无丢字节
-
-import { spawn, type ChildProcessWithoutNullStreams } from "node:child_process";
-import * as crypto from "node:crypto";
-import * as fs from "node:fs";
-import * as net from "node:net";
-import * as os from "node:os";
-import * as path from "node:path";
-import { fileURLToPath } from "node:url";
-
-import { afterEach, describe, expect, it } from "vitest";
-
-import {
-  RELAY_ENV_NODE,
-  RELAY_ENV_RECORD_ID,
-  RELAY_ENV_SCRIPT,
-  RELAY_ENV_SESSION_ID,
-  RELAY_ENV_SOCKET,
-  RELAY_EXIT_CODES,
-  RELAY_PROTOCOL_VERSION,
-} from "../relay-env.ts";
-
-/** 被测脚本：包根 relay/relay.mjs（与 src/ 平行的零依赖脚本，不参与 TS 编译）。 */
-const RELAY_SCRIPT_PATH = path.resolve(
-  path.dirname(fileURLToPath(import.meta.url)),
-  "../../../relay/relay.mjs",
-);
-
-/** 协议帧（代理 ↔ runtime JSONL）。字段全部可选除 kind——按 kind 分支后逐字段断言。 */
-interface RelayFrame {
-  kind: string;
-  v?: unknown;
-  dir?: unknown;
-  b64?: unknown;
-  code?: unknown;
-  signal?: unknown;
-  reason?: unknown;
-  supported?: unknown;
-  mainSessionId?: unknown;
-  recordId?: unknown;
-  argv?: unknown;
-  env?: unknown;
-  cwd?: unknown;
-}
-
-/** JSON.parse + 运行时守卫（禁裸 as）：非对象或无 string kind 视为不可解析。 */
-function parseFrame(line: string): RelayFrame | null {
-  let parsed: unknown;
-  try {
-    parsed = JSON.parse(line);
-  } catch {
-    return null;
-  }
-  if (typeof parsed !== "object" || parsed === null) return null;
-  const kind = (parsed as Record<string, unknown>).kind;
-  if (typeof kind !== "string") return null;
-  return { ...(parsed as Record<string, unknown>), kind };
-}
-
-interface FakeRuntime {
-  socketPath: string;
-  server: net.Server;
-  conn: net.Socket | null;
-  /** 第一帧 handshake（默认 respond 逻辑 accept 后 resolve；自定义 respond 也 resolve）。 */
-  handshakePromise: Promise<RelayFrame>;
-  /** 收到的全部 down 帧解码后的字节块。 */
-  downChunks: Buffer[];
-  downTotal: () => number;
-  send: (frame: Record<string, unknown>) => boolean;
-  destroyConn: () => void;
-  close: () => Promise<void>;
-}
-
-/** 默认 runtime 行为：收 handshake → 回 accept。 */
-function defaultRespond(_handshake: RelayFrame, rt: FakeRuntime): void {
-  rt.send({ v: RELAY_PROTOCOL_VERSION, kind: "accept" });
-}
-
-function startFakeRuntime(
-  socketPath: string,
-  respond: (handshake: RelayFrame, rt: FakeRuntime) => void = defaultRespond,
-): Promise<FakeRuntime> {
-  // handshake 的 settle 状态（resolve 回调 + 已收到帧），供「仅首个 handshake 帧响应」判定
-  const handshakeState: { resolve: ((f: RelayFrame) => void) | null; frame: RelayFrame | null } = {
-    resolve: null,
-    frame: null,
-  };
-  const handshakePromise = new Promise<RelayFrame>((resolve) => {
-    handshakeState.resolve = resolve;
-  });
-  let connRef: net.Socket | null = null;
-  const downChunks: Buffer[] = [];
-  const server = net.createServer((conn) => {
-    connRef = conn;
-    let lineBuf = "";
-    conn.setEncoding("utf8");
-    conn.on("data", (chunk: string) => {
-      lineBuf += chunk;
-      let nl: number;
-      while ((nl = lineBuf.indexOf("\n")) >= 0) {
-        const line = lineBuf.slice(0, nl);
-        lineBuf = lineBuf.slice(nl + 1);
-        if (!line.trim()) continue;
-        const frame = parseFrame(line);
-        if (!frame) continue;
-        if (frame.kind === "handshake") {
-          // 仅首个 handshake 帧响应 + settle（单连接单握手是协议形态）
-          if (handshakeState.frame === null) {
-            handshakeState.frame = frame;
-            respond(frame, rt);
-            handshakeState.resolve?.(frame);
-          }
-          continue;
-        }
-        if (frame.kind === "data" && frame.dir === "down" && typeof frame.b64 === "string") {
-          downChunks.push(Buffer.from(frame.b64, "base64"));
-        }
-      }
-    });
-  });
-  const rt: FakeRuntime = {
-    socketPath,
-    server,
-    get conn() {
-      return connRef;
-    },
-    downChunks,
-    downTotal: () => downChunks.reduce((sum, c) => sum + c.length, 0),
-    send: (frame) => {
-      if (!connRef || connRef.destroyed) throw new Error("fake runtime: no live connection");
-      return connRef.write(JSON.stringify(frame) + "\n");
-    },
-    destroyConn: () => {
-      connRef?.destroy();
-    },
-    handshakePromise,
-    close: () =>
-      new Promise<void>((resolve) => {
-        server.close(() => resolve());
-      }),
-  };
-  return new Promise<FakeRuntime>((resolve, reject) => {
-    server.once("error", reject);
-    server.listen(socketPath, () => {
-      activeServers.push(server);
-      resolve(rt);
-    });
-  });
-}
-
-interface SpawnOpts {
-  /** undefined = 不注入该 env（测缺失路径）。 */
-  socketPath?: string;
-  sessionId?: string;
-  recordId?: string;
-  argv?: string[];
-}
-
-/**
- * spawn 代理进程（node 直跑 relay.mjs，env 精确控制 5 个 relay 变量）。
- * stdout/stderr 收集器随 spawn 立即挂上——对齐真实契约（extension 的 stdout pump
- * 从 spawn 起消费；若测试侧不读，代理的 stdout 背压会正确地暂停 socket，测试卡死）。
- */
-interface CollectedChild {
-  child: ChildProcessWithoutNullStreams;
-  stdoutChunks: Buffer[];
-  stderrChunks: Buffer[];
-}
-
-function spawnRelay(opts: SpawnOpts): CollectedChild {
-  const env: NodeJS.ProcessEnv = { ...process.env };
-  delete env[RELAY_ENV_SOCKET];
-  delete env[RELAY_ENV_NODE];
-  delete env[RELAY_ENV_SCRIPT];
-  delete env[RELAY_ENV_SESSION_ID];
-  delete env[RELAY_ENV_RECORD_ID];
-  if (opts.socketPath !== undefined) env[RELAY_ENV_SOCKET] = opts.socketPath;
-  if (opts.sessionId !== undefined) env[RELAY_ENV_SESSION_ID] = opts.sessionId;
-  if (opts.recordId !== undefined) env[RELAY_ENV_RECORD_ID] = opts.recordId;
-  const child = spawn(process.execPath, [RELAY_SCRIPT_PATH, ...(opts.argv ?? ["--mode", "rpc"])], {
-    env,
-    stdio: ["pipe", "pipe", "pipe"],
-  });
-  const collected: CollectedChild = {
-    child,
-    stdoutChunks: [],
-    stderrChunks: [],
-  };
-  child.stdout.on("data", (c: Buffer) => collected.stdoutChunks.push(c));
-  child.stderr.on("data", (c: Buffer) => collected.stderrChunks.push(c));
-  activeChildren.push(child);
-  return collected;
-}
-
-interface ExitResult {
-  code: number | null;
-  signal: NodeJS.Signals | null;
-  stderr: string;
-  stdout: Buffer;
-}
-
-/** 等 child close，输出取自 spawn 时挂起的收集器（close 时数据已齐）。 */
-function waitForExit({ child, stdoutChunks, stderrChunks }: CollectedChild): Promise<ExitResult> {
-  return new Promise((resolve, reject) => {
-    child.on("error", reject);
-    child.on("close", (code, signal) => {
-      resolve({
-        code,
-        signal,
-        stdout: Buffer.concat(stdoutChunks),
-        stderr: Buffer.concat(stderrChunks).toString("utf8"),
-      });
-    });
-  });
-}
-
-/** 轮询等待条件成立（25ms 间隔；超时抛错）。 */
-async function pollUntil(predicate: () => boolean, timeoutMs: number, what: string): Promise<void> {
-  const deadline = Date.now() + timeoutMs;
-  while (!predicate()) {
-    if (Date.now() > deadline) throw new Error(`timeout waiting for ${what}`);
-    await new Promise((r) => setTimeout(r, 25));
-  }
-}
-
-/** 分块发送大 up 帧（64KB/帧 + socket drain 等待，驱动代理侧 socket→stdout 背压路径）。 */
-async function sendLargeUp(rt: FakeRuntime, data: Buffer): Promise<void> {
-  const CHUNK = 64 * 1024;
-  for (let i = 0; i < data.length; i += CHUNK) {
-    const frame = {
-      v: RELAY_PROTOCOL_VERSION,
-      kind: "data",
-      dir: "up",
-      b64: data.subarray(i, i + CHUNK).toString("base64"),
-    };
-    if (!rt.send(frame)) {
-      await new Promise<void>((resolve) => {
-        const c = rt.conn;
-        if (!c) return resolve();
-        c.once("drain", () => resolve());
-      });
-    }
-  }
-}
-
-const activeServers: net.Server[] = [];
-const activeChildren: ChildProcessWithoutNullStreams[] = [];
-const activeTmpDirs: string[] = [];
-
-function makeSocketPath(): string {
-  const dir = fs.mkdtempSync(path.join(os.tmpdir(), "relay-agent-test-"));
-  activeTmpDirs.push(dir);
-  return path.join(dir, "relay.sock");
-}
-
-afterEach(async () => {
-  for (const child of activeChildren) {
-    if (!child.killed) child.kill("SIGKILL");
-  }
-  activeChildren.length = 0;
-  await Promise.all(
-    activeServers.map(
-      (s) => new Promise<void>((resolve) => s.close(() => resolve())),
-    ),
-  );
-  activeServers.length = 0;
-  for (const dir of activeTmpDirs) fs.rmSync(dir, { recursive: true, force: true });
-  activeTmpDirs.length = 0;
-});
-
-describe("relay agent CLI (relay.mjs)", () => {
-  it("identity env missing → exit 13 + stderr names the env vars", { timeout: 10_000 }, async () => {
-    const child = spawnRelay({});
-    const res = await waitForExit(child);
-    expect(res.code).toBe(RELAY_EXIT_CODES.MISSING_IDENTITY);
-    expect(res.stderr).toContain(RELAY_ENV_SESSION_ID);
-    expect(res.stderr).toContain(RELAY_ENV_RECORD_ID);
-  });
-
-  it("socket env missing (identity present) → exit 13", { timeout: 10_000 }, async () => {
-    const child = spawnRelay({ sessionId: "sess-1", recordId: "rec-1" });
-    const res = await waitForExit(child);
-    expect(res.code).toBe(RELAY_EXIT_CODES.MISSING_IDENTITY);
-    expect(res.stderr).toContain(RELAY_ENV_SOCKET);
-  });
-
-  it("socket unreachable → retry once then exit 11 with path + recovery hint", { timeout: 15_000 }, async () => {
-    const socketPath = path.join(makeSocketPath(), "never-listening.sock");
-    const child = spawnRelay({ socketPath, sessionId: "sess-1", recordId: "rec-1" });
-    const res = await waitForExit(child);
-    expect(res.code).toBe(RELAY_EXIT_CODES.SOCKET_UNREACHABLE);
-    expect(res.stderr).toContain(socketPath);
-    expect(res.stderr).toContain("重试任务");
-    expect(res.stderr).toContain("重启 xyz-agent");
-  });
-
-  it("handshake frame carries full spawn spec (v/kind/mainSessionId/recordId/argv/env/cwd)", { timeout: 15_000 }, async () => {
-    const socketPath = makeSocketPath();
-    const rt = await startFakeRuntime(socketPath);
-    const argv = ["--mode", "rpc", "--model", "test/model"];
-    const child = spawnRelay({ socketPath, sessionId: "sess-42", recordId: "rec-99", argv });
-    const hs = await rt.handshakePromise;
-    expect(hs.kind).toBe("handshake");
-    expect(hs.v).toBe(RELAY_PROTOCOL_VERSION);
-    expect(hs.mainSessionId).toBe("sess-42");
-    expect(hs.recordId).toBe("rec-99");
-    expect(hs.argv).toEqual(argv);
-    expect(hs.cwd).toBe(process.cwd());
-    // env 全量转发：含注入的归属 env 与 socket env（runtime spawn 真实 pi 原样使用）
-    expect(hs.env).toBeTypeOf("object");
-    expect(hs.env).toHaveProperty(RELAY_ENV_SESSION_ID, "sess-42");
-    expect(hs.env).toHaveProperty(RELAY_ENV_RECORD_ID, "rec-99");
-    expect(hs.env).toHaveProperty(RELAY_ENV_SOCKET, socketPath);
-    // 收尾：默认 respond 已 accept，发 exit 让子进程退出
-    rt.send({ kind: "exit", code: 0 });
-    const res = await waitForExit(child);
-    expect(res.code).toBe(0);
-  });
-
-  it("byte roundtrip fidelity: down/up/up-stderr with CJK, newlines, NUL bytes", { timeout: 15_000 }, async () => {
-    const socketPath = makeSocketPath();
-    const rt = await startFakeRuntime(socketPath);
-    const child = spawnRelay({ socketPath, sessionId: "s", recordId: "r" });
-    await rt.handshakePromise;
-
-    // 下行字节：JSON 命令行 + 中文 + 换行（挑战 JSONL 行协议）+ 空字节（挑战文本假设）
-    const downBytes = Buffer.concat([
-      Buffer.from('{"type":"prompt","message":"你好，世界\n', "utf8"),
-      Buffer.from([0x00, 0x01, 0xff, 0xfe]),
-      Buffer.from('第二行"}\n', "utf8"),
-    ]);
-    child.child.stdin.write(downBytes);
-    await pollUntil(() => rt.downTotal() === downBytes.length, 5_000, "down bytes");
-    expect(Buffer.concat(rt.downChunks)).toEqual(downBytes);
-
-    // 上行 stdout / stderr 字节保真
-    const upBytes = Buffer.concat([
-      Buffer.from("stdout 流式输出\nline2\0", "utf8"),
-      crypto.randomBytes(64),
-    ]);
-    const upStderrBytes = Buffer.concat([
-      Buffer.from("stderr 诊断\n\0字节", "utf8"),
-      crypto.randomBytes(32),
-    ]);
-    rt.send({ v: RELAY_PROTOCOL_VERSION, kind: "data", dir: "up", b64: upBytes.toString("base64") });
-    rt.send({
-      v: RELAY_PROTOCOL_VERSION,
-      kind: "data",
-      dir: "up-stderr",
-      b64: upStderrBytes.toString("base64"),
-    });
-    rt.send({ kind: "exit", code: 3 });
-    const res = await waitForExit(child);
-    expect(res.stdout).toEqual(upBytes);
-    expect(res.stderr).toEqual(upStderrBytes.toString("utf8"));
-    expect(res.code).toBe(3);
-  });
-
-  it("exit frame code propagation flushes stdout first", { timeout: 10_000 }, async () => {
-    const socketPath = makeSocketPath();
-    const rt = await startFakeRuntime(socketPath);
-    const child = spawnRelay({ socketPath, sessionId: "s", recordId: "r" });
-    await rt.handshakePromise;
-    const upBytes = Buffer.from("final bytes before exit\n", "utf8");
-    rt.send({ v: RELAY_PROTOCOL_VERSION, kind: "data", dir: "up", b64: upBytes.toString("base64") });
-    rt.send({ kind: "exit", code: 7 });
-    const res = await waitForExit(child);
-    expect(res.code).toBe(7);
-    expect(res.stdout).toEqual(upBytes);
-  });
-
-  it("exit frame signal propagation → close(null, SIGTERM)", { timeout: 10_000 }, async () => {
-    const socketPath = makeSocketPath();
-    const rt = await startFakeRuntime(socketPath);
-    const child = spawnRelay({ socketPath, sessionId: "s", recordId: "r" });
-    await rt.handshakePromise;
-    rt.send({ kind: "exit", signal: "SIGTERM" });
-    const res = await waitForExit(child);
-    expect(res.signal).toBe("SIGTERM");
-    expect(res.code).toBeNull();
-  });
-
-  it("socket closed by runtime → exit 12", { timeout: 10_000 }, async () => {
-    const socketPath = makeSocketPath();
-    const rt = await startFakeRuntime(socketPath);
-    const child = spawnRelay({ socketPath, sessionId: "s", recordId: "r" });
-    await rt.handshakePromise;
-    rt.destroyConn();
-    const res = await waitForExit(child);
-    expect(res.code).toBe(RELAY_EXIT_CODES.SOCKET_CLOSED);
-    expect(res.stderr).toContain("closed");
-  });
-
-  it("reject reason=version → exit 10 + reinstall recovery hint", { timeout: 10_000 }, async () => {
-    const socketPath = makeSocketPath();
-    const rt = await startFakeRuntime(socketPath, (_hs, r) => {
-      r.send({ kind: "reject", reason: "version", supported: [RELAY_PROTOCOL_VERSION] });
-    });
-    const child = spawnRelay({ socketPath, sessionId: "s", recordId: "r" });
-    const res = await waitForExit(child);
-    expect(res.code).toBe(RELAY_EXIT_CODES.VERSION_MISMATCH);
-    expect(res.stderr).toContain("version mismatch");
-    expect(res.stderr).toContain("重装应用");
-  });
-
-  it("reject with non-version reason → exit 12", { timeout: 10_000 }, async () => {
-    const socketPath = makeSocketPath();
-    const rt = await startFakeRuntime(socketPath, (_hs, r) => {
-      r.send({ kind: "reject", reason: "handshake_invalid" });
-    });
-    const child = spawnRelay({ socketPath, sessionId: "s", recordId: "r" });
-    const res = await waitForExit(child);
-    expect(res.code).toBe(RELAY_EXIT_CODES.SOCKET_CLOSED);
-    expect(res.stderr).toContain("handshake_invalid");
-  });
-
-  it("backpressure: 1MB random bytes survive full down→up roundtrip", { timeout: 60_000 }, async () => {
-    const socketPath = makeSocketPath();
-    const rt = await startFakeRuntime(socketPath);
-    const child = spawnRelay({ socketPath, sessionId: "s", recordId: "r" });
-    await rt.handshakePromise;
-
-    const payload = crypto.randomBytes(1024 * 1024);
-    child.child.stdin.write(payload);
-    await pollUntil(() => rt.downTotal() === payload.length, 30_000, "1MB down bytes");
-    const receivedDown = Buffer.concat(rt.downChunks);
-    expect(receivedDown).toEqual(payload);
-
-    // 同一 payload 分 64KB up 帧回发（驱动代理 socket→stdout 背压 + 行缓冲路径）
-    await sendLargeUp(rt, receivedDown);
-    rt.send({ kind: "exit", code: 0 });
-    const res = await waitForExit(child);
-    expect(res.code).toBe(0);
-    expect(res.stdout).toEqual(payload);
-  });
-});

package/src/execution/__tests__/relay-env.test.ts

@@ -1,42 +0,0 @@
-import { describe, expect, it } from 'vitest';
-
-import {
-  RELAY_ENV_NODE,
-  RELAY_ENV_RECORD_ID,
-  RELAY_ENV_SCRIPT,
-  RELAY_ENV_SESSION_ID,
-  RELAY_ENV_SOCKET,
-  RELAY_EXIT_CODES,
-  RELAY_PROTOCOL_VERSION,
-  isRelayActive,
-} from '../relay-env.js';
-
-describe('relay env SSOT', () => {
-  it('激活判定：三 env 同时非空', () => {
-    expect(isRelayActive({ [RELAY_ENV_SOCKET]: '/x.sock', [RELAY_ENV_NODE]: '/node', [RELAY_ENV_SCRIPT]: '/relay.mjs' })).toBe(true);
-  });
-
-  it('任一缺失即不激活（全有或全无）', () => {
-    const full = {
-      [RELAY_ENV_SOCKET]: '/x.sock',
-      [RELAY_ENV_NODE]: '/node',
-      [RELAY_ENV_SCRIPT]: '/relay.mjs',
-    };
-    expect(isRelayActive({ ...full, [RELAY_ENV_SOCKET]: '' })).toBe(false);
-    expect(isRelayActive({ ...full, [RELAY_ENV_NODE]: undefined })).toBe(false);
-    expect(isRelayActive({})).toBe(false);
-    expect(isRelayActive(process.env)).toBe(false);
-  });
-
-  it('env 名与退出码稳定（relay.mjs 镜像一致性由 conformance relay 断言锁定）', () => {
-    expect(RELAY_ENV_SESSION_ID).toBe('XYZ_SUBAGENT_RELAY_SESSION_ID');
-    expect(RELAY_ENV_RECORD_ID).toBe('XYZ_SUBAGENT_RELAY_RECORD_ID');
-    expect(RELAY_PROTOCOL_VERSION).toBe(1);
-    expect(RELAY_EXIT_CODES).toEqual({
-      VERSION_MISMATCH: 10,
-      SOCKET_UNREACHABLE: 11,
-      SOCKET_CLOSED: 12,
-      MISSING_IDENTITY: 13,
-    });
-  });
-});

package/src/execution/__tests__/resource-policy.test.ts

@@ -1,109 +0,0 @@
-// resource-policy 单测 —— SP-6 资源策略配置化（idleTimeoutMs + env 覆盖）。
-//
-// 测试策略：
-//   - 验证 armIdleTimer 的三层优先级：参数 > env XYZ_SUBAGENT_IDLE_TIMEOUT_MS > 默认 300000ms。
-//   - 用 vi.useFakeTimers() 控制时间流逝。
-//   - 每个用例 beforeEach/afterEach 清理 env + reset lifecycle state。
-
-import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
-
-import {
-  DEFAULT_IDLE_TIMEOUT_MS,
-  _resetLifecycleState,
-  armIdleTimer,
-  hasIdleTimer,
-} from "../lifecycle-manager.ts";
-
-describe("resource-policy — SP-6 idleTimeoutMs 配置化", () => {
-  const ENV_KEY = "XYZ_SUBAGENT_IDLE_TIMEOUT_MS";
-
-  beforeEach(() => {
-    vi.useFakeTimers();
-    _resetLifecycleState();
-    // 清理 env，确保用例间隔离。
-    delete process.env[ENV_KEY];
-  });
-
-  afterEach(() => {
-    _resetLifecycleState();
-    vi.useRealTimers();
-    delete process.env[ENV_KEY];
-  });
-
-  // TC-1: idleTimeoutMs 参数透传生效
-  it("TC-1: explicit timeoutMs 参数直接生效（不看 env）", () => {
-    const onTimeout = vi.fn();
-    armIdleTimer("sa-tc1", onTimeout, 1234);
-
-    expect(hasIdleTimer("sa-tc1")).toBe(true);
-
-    // 差 1ms 不触发
-    vi.advanceTimersByTime(1233);
-    expect(onTimeout).not.toHaveBeenCalled();
-
-    // 到点触发
-    vi.advanceTimersByTime(1);
-    expect(onTimeout).toHaveBeenCalledOnce();
-  });
-
-  // TC-2: env XYZ_SUBAGENT_IDLE_TIMEOUT_MS 覆盖默认值
-  it("TC-2: env XYZ_SUBAGENT_IDLE_TIMEOUT_MS 覆盖默认值（不传参数时）", () => {
-    process.env[ENV_KEY] = "5000"; // 5 秒
-
-    const onTimeout = vi.fn();
-    armIdleTimer("sa-tc2", onTimeout); // 不传 timeoutMs
-
-    // 4.9s 不触发
-    vi.advanceTimersByTime(4999);
-    expect(onTimeout).not.toHaveBeenCalled();
-
-    // 5s 触发（env 值，不是默认 300s）
-    vi.advanceTimersByTime(1);
-    expect(onTimeout).toHaveBeenCalledOnce();
-  });
-
-  // TC-3: 参数优先于 env
-  it("TC-3: explicit timeoutMs 参数优先于 env", () => {
-    process.env[ENV_KEY] = "99999"; // env 设大值
-
-    const onTimeout = vi.fn();
-    armIdleTimer("sa-tc3", onTimeout, 2000); // 参数设小值
-
-    // 2s 触发（参数优先，不等 env 的 99s）
-    vi.advanceTimersByTime(1999);
-    expect(onTimeout).not.toHaveBeenCalled();
-
-    vi.advanceTimersByTime(1);
-    expect(onTimeout).toHaveBeenCalledOnce();
-  });
-
-  // TC-4: 都不设时默认 5min (300000ms)
-  it("TC-4: 无参数无 env 时默认 300000ms (5min)", () => {
-    const onTimeout = vi.fn();
-    armIdleTimer("sa-tc4", onTimeout); // 不传 timeoutMs，env 也未设
-
-    // 差 1ms 不触发
-    vi.advanceTimersByTime(DEFAULT_IDLE_TIMEOUT_MS - 1);
-    expect(onTimeout).not.toHaveBeenCalled();
-
-    // 到点触发
-    vi.advanceTimersByTime(1);
-    expect(onTimeout).toHaveBeenCalledOnce();
-  });
-
-  // TC-5 (额外): env 非法值回落默认
-  it("TC-5: env 非法值（负数/非数字）回落默认 300000ms", () => {
-    process.env[ENV_KEY] = "not-a-number";
-
-    const onTimeout = vi.fn();
-    armIdleTimer("sa-tc5", onTimeout); // 不传 timeoutMs
-
-    // 非法 env → 回落默认 300s。299s 不触发。
-    vi.advanceTimersByTime(DEFAULT_IDLE_TIMEOUT_MS - 1);
-    expect(onTimeout).not.toHaveBeenCalled();
-
-    // 到点触发
-    vi.advanceTimersByTime(1);
-    expect(onTimeout).toHaveBeenCalledOnce();
-  });
-});

package/src/execution/__tests__/rpc-mode.test.ts

@@ -1,89 +0,0 @@
-// src/__tests__/rpc-mode.test.ts
-//
-// RPC 模式相关功能
-// 1. buildSpawnArgs 返回 --mode rpc（而非 json）
-// 2. parseSpawnLine 正确解析 Pi 原生 RpcResponse（type:response + command + success + data|error）
-
-import { describe, expect, it } from "vitest";
-
-import { buildSpawnArgs } from "../session-runner.ts";
-import { parseSpawnLine } from "../spawn-event-adapter.ts";
-
-describe("buildSpawnArgs - RPC mode", () => {
-  const baseParams = {
-    modelRef: { provider: "openai", id: "gpt-4" },
-    thinkingLevel: undefined,
-    agentTools: undefined,
-    appendSystemPromptPath: undefined,
-    sessionDir: "/tmp/sessions",
-    forkSource: undefined,
-    skillPaths: undefined,
-  };
-
-  it("生成 --mode rpc 参数（非 json）", () => {
-    const args = buildSpawnArgs(baseParams);
-    // 应包含 --mode rpc
-    expect(args).toContain("--mode");
-    const modeIdx = args.indexOf("--mode");
-    expect(args[modeIdx + 1]).toBe("rpc");
-  });
-
-  it("不包含 --mode json", () => {
-    const args = buildSpawnArgs(baseParams);
-    const modeIdx = args.indexOf("--mode");
-    expect(args[modeIdx + 1]).not.toBe("json");
-  });
-});
-
-describe("parseSpawnLine - RpcResponse", () => {
-  // Pi 原生 RpcResponse 格式（rpc-types.ts）：{type:"response", id?, command, success, data?, error?}
-  // W1 修复后 isRpcResponse 判 type:response + command:string + success:boolean（SR-1 根因 1b）
-
-  it("解析 Pi 原生 success response（kind=response）", () => {
-    const rpcResponse = JSON.stringify({
-      type: "response",
-      id: "req-123",
-      command: "run",
-      success: true,
-      data: { answers: [{ question: "Q1", answer: "A1" }] },
-    });
-    const result = parseSpawnLine(rpcResponse);
-    expect(result?.kind).toBe("response");
-    if (result?.kind === "response") {
-      expect(result.id).toBe("req-123");
-      expect(result.command).toBe("run");
-      expect(result.success).toBe(true);
-      expect(result.data).toEqual({ answers: [{ question: "Q1", answer: "A1" }] });
-    }
-  });
-
-  it("解析 Pi 原生 error response（kind=response）", () => {
-    const rpcError = JSON.stringify({
-      type: "response",
-      id: "req-456",
-      command: "run",
-      success: false,
-      error: "task failed: timeout",
-    });
-    const result = parseSpawnLine(rpcError);
-    expect(result?.kind).toBe("response");
-    if (result?.kind === "response") {
-      expect(result.id).toBe("req-456");
-      expect(result.success).toBe(false);
-      expect(result.error).toBe("task failed: timeout");
-    }
-  });
-
-  it("旧 JSON-RPC 2.0 格式不再归类为 response（W1 废弃）", () => {
-    // SR-1: 旧 {jsonrpc:"2.0", id, result} 无 type:response 字段，应落入 invalid
-    const oldRpc = JSON.stringify({ jsonrpc: "2.0", id: "req-old", result: { x: 1 } });
-    const result = parseSpawnLine(oldRpc);
-    expect(result?.kind).not.toBe("response");
-  });
-
-  it("非 response 类型的 JSON 不归类为 response", () => {
-    const normalEvent = JSON.stringify({ type: "tool_execution_start", toolName: "bash" });
-    const result = parseSpawnLine(normalEvent);
-    expect(result?.kind).not.toBe("response");
-  });
-});