@zhushanwen/pi-subagent-workflow 8.5.0 → 8.7.0

package/src/execution/model-resolver.ts

@@ -1,276 +0,0 @@
-// src/core/model-resolver.ts
-//
-// 模型解析（三层）：
-//   1. 用户显式 override（tool 参数 model，平铺在 subagent params 顶层）→ registry lookup + auth
-//   2. agent .md frontmatter model（agent 作者指定）→ registry lookup + auth
-//   3. 主 agent 当前模型（ctx.model）→ 直接透传，无需 lookup
-//
-// 设计：默认与主 agent 同模型（零配置）。只有「有人显式指定 model」时才查
-// registry 做解析 + 鉴权校验。thinkingLevel 同链路，无指定时 undefined。
-
-/**
- * ModelRegistry 的最小接口（duck-typed，测试可 mock）。
- * 字段结构与 Pi SDK 的 ctx.modelRegistry 对齐。
- */
-export interface ModelRegistryLike {
-  /** 返回所有已配置鉴权的可用模型。 */
-  getAvailable(): ModelInfo[];
-  /** 按 (provider, modelId) 查找。 */
-  find(provider: string, modelId: string): ModelInfo | undefined;
-  /** 校验模型鉴权是否就绪。 */
-  hasConfiguredAuth(model: unknown): boolean;
-}
-
-/**
- * 模型信息（registry 返回元素 / ctx.model 鸭子类型兼容）。
- * ctx.model（SDK Model<Api>）是此类型的超集，运行时直接当 ModelInfo 用。
- */
-export interface ModelInfo {
-  id: string;
-  name: string;
-  provider: string;
-  reasoning: boolean;
-  thinkingLevelMap?: Record<string, unknown>;
-  contextWindow?: number;
-}
-
-/** agent .md frontmatter 解析结果。 */
-export interface AgentConfig {
-  /** agent 名（文件名 basename）。 */
-  name: string;
-  /** system prompt（markdown 正文）。 */
-  systemPrompt: string;
-  /** tool allowlist（三层过滤之一）。 */
-  tools?: string[];
-  /** 默认模型 override（"provider/modelId"）。agent 作者显式指定。 */
-  model?: string;
-  /** 默认 thinkingLevel override。 */
-  thinkingLevel?: string;
-  /** 默认 background 模式（true 时无显式 wait 走 background）。 */
-  defaultBackground?: boolean;
-  /**
-   * 执行引擎 id（agent .md frontmatter engine 字段，D9 per-agent 主通道）。
-   * 解析期已对注册表校验（未注册 id 在 agent-registry 抛 EngineNotFoundError）；
-   * 执行侧（P4 路由层）按 调用参数 > 本字段 > 全局默认 三层取值。
-   */
-  engine?: string;
-}
-
-/** 解析结果（model 实例 + 生效的 thinkingLevel）。 */
-export interface ResolvedModel {
-  model: ModelInfo;
-  thinkingLevel: string | undefined;
-}
-
-// ============================================================
-// 常量
-// ============================================================
-
-/** thinking level 支持顺序（低→高），用于 clamp 到 model 可用级别。
- *  SSOT（单一权威源）：新增 thinking 级别只改此处，subagent-tool 的 thinkingLevel 枚举
- *  从本常量派生，避免两处硬编码不同步。 */
-export const THINKING_ORDER = ["off", "minimal", "low", "medium", "high", "xhigh", "max"] as const;
-
-/** 解析失败时错误信息列出的可用模型上限（防超长错误信息）。 */
-const MODEL_LIST_LIMIT = 20;
-
-// ============================================================
-// 解析
-// ============================================================
-
-/**
- * 三层模型解析：
- *
- *   ╔═══════════════════════════════════════════════════════════════╗
-//   ║  优先级（高→低）:                                              ║
-//   ║    1. paramOverride.model      （调用方显式指定，tool 参数）     ║
-//   ║    2. agentConfig.model        （agent .md frontmatter）        ║
-//   ║    3. ctxModel                 （主 agent 当前模型，直接透传）   ║
-//   ║                                                                ║
-//   ║  1/2 级查 registry + auth 校验；3 级无需 lookup（主 agent 在用  ║
-//   ║  说明 auth OK）。thinkingLevel 无显式指定时兜底「模型最高可用档」║
-//   ║  （maxThinkingForModel，含 "max" 时用 max）——不落回 pi 默认      ║
-//   ║  medium，subagent 任务需要最大推理深度。                          ║
-//   ║                                                                ║
-//   ║  显式指定但 lookup/auth 失败 → 抛错（不静默降级到主 agent，     ║
-//   ║  因为用户明确要求了某个 model，降级会造成「以为用了 X 实际用 Y」║
-//   ╚════════════════════════════════════════════════════════════════╝
- *
- * @param agentConfig     agent .md 解析结果（查 model override + thinkingLevel）
- * @param modelRegistry   registry（仅 override 路径用）
- * @param paramOverride   调用方显式 override（最高优先级）
- * @param ctxModel        主 agent 当前模型（兜底，直接透传）
- */
-export function resolveModel(
-  agentConfig: AgentConfig | undefined,
-  modelRegistry: ModelRegistryLike,
-  paramOverride?: { model?: string; thinkingLevel?: string },
-  ctxModel?: ModelInfo,
-): ResolvedModel {
-  // 1. paramOverride（最高优先级）。显式指定但 lookup/auth 失败 → 直接抛错，
-  // 不降级到下层（避免「以为用了 X 实际用 Y」的静默错误）。
-  if (paramOverride?.model) {
-    return lookupAndResolve(
-      paramOverride.model,
-      paramOverride.thinkingLevel ?? agentConfig?.thinkingLevel,
-      modelRegistry,
-      "paramOverride",
-    );
-  }
-
-  // 2. agentConfig.model（agent 作者指定）。同样显式 → 失败即抛错。
-  if (agentConfig?.model) {
-    return lookupAndResolve(
-      agentConfig.model,
-      agentConfig.thinkingLevel,
-      modelRegistry,
-      "agentConfig",
-    );
-  }
-
-  // 3. 主 agent model（直接透传）。无显式 thinking → 兜底最高可用档。
-  if (ctxModel) {
-    return {
-      model: ctxModel,
-      thinkingLevel: paramOverride?.thinkingLevel ?? agentConfig?.thinkingLevel
-        ?? maxThinkingForModel(ctxModel),
-    };
-  }
-
-  // 全部不可用 → 列出可用模型辅助调试
-  const available = modelRegistry.getAvailable().map((m) => `${m.provider}/${m.id}`);
-  throw new Error(
-    `No available model. Main agent has no active model, and no override was resolved.` +
-      (available.length > 0
-        ? `\nAvailable models:\n  ${available.slice(0, MODEL_LIST_LIMIT).join("\n  ")}`
-        : ""),
-  );
-}
-
-/**
- * lookup + auth 校验 + thinkingLevel clamp。显式指定但失败 → 抛错（不降级）。
- *
- * 错误信息区分两种失败（避免误导排查方向）：
- *   - model 不存在 → 提示检查拼写 + 列出相近可用 model
- *   - model 存在但 auth 未配置 → 提示在 models.json 配置鉴权
- */
-function lookupAndResolve(
-  modelStr: string,
-  requestedThinking: string | undefined,
-  registry: ModelRegistryLike,
-  source: "paramOverride" | "agentConfig",
-): ResolvedModel {
-  const model = lookupModel(modelStr, registry);
-  if (!model) {
-    throw new Error(
-      `Model "${modelStr}" (${source}) not found in registry. ` +
-        suggestSimilarModels(modelStr, registry),
-    );
-  }
-  if (!registry.hasConfiguredAuth(model)) {
-    throw new Error(
-      `Model "${modelStr}" (${source}) exists but auth is not configured. ` +
-        `Configure auth in models.json or switch to an authorized model.`,
-    );
-  }
-  return {
-    model,
-    // 无显式请求时兜底「模型最高可用档」（不落 pi 默认 medium）。
-    thinkingLevel: resolveThinkingLevel(model, requestedThinking ?? maxThinkingForModel(model)),
-  };
-}
-
-/**
- * subagent 默认 thinking：模型最高可用档。
- *
- *   - thinkingLevelMap 配置了级别 → map 中最高档（模型显式配置 "max" 时即 max）
- *   - reasoning 但无 map → "xhigh"（pi 合法最高档；"max" 非 pi 合法值——
- *     spawn 侧 model:"max" 后缀会被 pi 判为非法 thinking 后缀导致 model 解析失败，
- *     故无 map 时不能直接用 "max"）
- *   - 非 reasoning 模型 → undefined（不支持 thinking）
- */
-function maxThinkingForModel(
-  model: { reasoning: boolean; thinkingLevelMap?: Record<string, unknown> },
-): string | undefined {
-  const levels = availableThinkingLevels(model);
-  if (levels.length > 0) return levels[levels.length - 1];
-  return model.reasoning ? "xhigh" : undefined;
-}
-
-/**
- * 解析 "provider/modelId" 并查 registry。
- *
- * 容错：剥离尾部 ":thinkingLevel" 后缀（off/minimal/low/medium/high/xhigh）。
- * 原因：LLM 常把平台复合标识 "provider/modelId:thinkingLevel"（如
- * "deepseek-router/ds-pro:xhigh"）整体当 model 参数传入。registry 仅存
- * "provider/modelId"（无后缀），不剥离则 modelId="ds-pro:xhigh" 查不到。
- * 剥离后 thinkingLevel 仍由独立的 thinkingLevel 参数/resolveThinkingLevel 处理。
- *
- * modelId 可含 /，按第一个 / 分割 provider 与 modelId。
- */
-function lookupModel(modelStr: string, registry: ModelRegistryLike): ModelInfo | undefined {
-  const cleanStr = stripThinkingSuffix(modelStr);
-  const idx = cleanStr.indexOf("/");
-  if (idx <= 0) return undefined;
-  return registry.find(cleanStr.slice(0, idx), cleanStr.slice(idx + 1));
-}
-
-/**
- * 剥离模型字符串尾部 ":thinkingLevel" 后缀（如 "ds-pro:xhigh" → "ds-pro"）。
- * 仅匹配合法 thinking level，避免误剥 "foo:bar" 这类无关冒号。
- * 返回去除后缀的字符串；无后缀则原样返回。
- */
-function stripThinkingSuffix(modelStr: string): string {
-  // THINKING_ORDER 含 off/minimal/low/medium/high/xhigh，按长度降序拼正则避免短串误匹配
-  const alt = THINKING_ORDER.slice().sort((a, b) => b.length - a.length).join("|");
-  return modelStr.replace(new RegExp(`:(${alt})$`), "");
-}
-
-/**
- * 为 not-found 错误生成「相近可用 model」建议，辅助定位拼写错误。
- * 策略：取 provider/modelId 的末段，与每个可用 model 的末段做小写包含匹配，
- * 命中则列出。无命中则列出前 N 个全部可用 model（兜底）。空 registry 不列。
- */
-function suggestSimilarModels(modelStr: string, registry: ModelRegistryLike): string {
-  const available = registry.getAvailable();
-  if (available.length === 0) return "Registry has no available models.";
-  const target = modelStr.split("/").pop()?.toLowerCase() ?? "";
-  // ponytail: 末段子串包含足够定位拼写错误，无需编辑距离/相似度库
-  const similar = available
-    .filter((m) => m.id.toLowerCase().includes(target) || target.includes(m.id.toLowerCase()))
-    .map((m) => `${m.provider}/${m.id}`)
-    .slice(0, MODEL_LIST_LIMIT);
-  const list = similar.length > 0 ? similar : available.slice(0, MODEL_LIST_LIMIT).map((m) => `${m.provider}/${m.id}`);
-  return `Check the model string (maybe a typo, or a ":thinkingLevel" suffix that should be passed via the thinkingLevel param instead). Similar available models:\n  ${list.join("\n  ")}`;
-}
-
-/**
- * 从 model.thinkingLevelMap 提取可用级别，clamp 到最高可用。
- * model.reasoning === false → undefined（不支持 thinking）
- */
-function resolveThinkingLevel(
-  model: { reasoning: boolean; thinkingLevelMap?: Record<string, unknown> },
-  requested?: string,
-): string | undefined {
-  const levels = availableThinkingLevels(model);
-  if (levels.length === 0) return model.reasoning ? requested : undefined;
-  if (requested && levels.includes(requested)) return requested;
-  // requested 不可用 → 降级到最高可用
-  return levels[levels.length - 1];
-}
-
-/**
- * 列出 model 实际支持的 thinking level（升序）。
- *
- *   - model.reasoning === false → [] （不支持 thinking）
- *   - 无 thinkingLevelMap → [] （无级别信息，调用方按需透传）
- *   - 有 map → THINKING_ORDER 中 map[lvl] != null 的子集（保留升序）
- */
-export function availableThinkingLevels(
-  model: { reasoning: boolean; thinkingLevelMap?: Record<string, unknown> },
-): readonly string[] {
-  if (!model.reasoning) return [];
-  const map = model.thinkingLevelMap;
-  if (!map) return [];
-  return THINKING_ORDER.filter((lvl) => map[lvl] != null);
-}

package/src/execution/notifier.ts

@@ -1,260 +0,0 @@
-// src/execution/notifier.ts
-//
-// Background 完成回注主对话。sync 不用（调用方还在 await，结果直接返回）。
-//
-// 职责（迁移后，U3）：
-//   - buildLlmContent：格式化通知文案（本文件唯一逻辑职责）
-//   - createNotifier：薄工厂，装配 @xyz-agent/session-delivery 内核
-//   - 合并窗口 / 去重 / 退避 / flush 全部委托内核
-//
-// 投递通道：内核 → pi.sendMessage({ deliverAs:"steer", triggerTurn:true }) 注入——
-//   当前 turn 结束后唤醒父 agent 处理结果（steer 不打断 streaming、不锁滚动）
-
-import { createDelivery, type DeliveryHandle, type DeliveryPort } from "@xyz-agent/session-delivery";
-
-/**
- * 一条待发送的完成通知记录。
- * SP-1: done/failed/crashed 合并为 closed + closedReason L2 子枚举。
- */
-export interface BgNotifyRecord {
-  id: string;
-  /**
-   * 完成状态。v4 B-1 两态收敛：closed（终态，含 cancelled，closedReason 表达 L2 原因）
-   * 或 running（对话模式轮次完成，旧 idle 折入 running，携带本轮结果送回主 agent）。
-   * toNotifyRecord 守卫放行后经此联合穷尽。
-   */
-  status: "running" | "closed";
-  /** L2 关闭原因子枚举（仅 status="closed" 时有意义）。供通知文案按需展示。 */
-  closedReason?: import("./types.ts").ClosedReason;
-  agent: string;
-  /** 执行所用 model（RecordSnapshot.model），用于完成通知显示。 */
-  model?: string;
-  result?: string;
-  error?: string;
-  startedAt: number;
-  endedAt: number | undefined;
-  /**
-   * 对话轮次计数（仅 idle 有意义）。dedup key 按 `id:round` 去重——对话模式每轮 round
-   * 不同，60s 内多轮不被吞；非 chatMode round 恒定（0/undefined），key 同旧 id 行为不变。
-   */
-  round?: number;
-  /** [MF#1] worktree 模式下子 agent 改动的 patch 路径（worktree 外，cleanup 后留存）。
-   *  done 时通知文本显式提示 `git apply`，否则 background 子 agent 在隔离 worktree 的改动
-   *  会静默丢失——父 LLM 不知 patch 路径，无法应用。 */
-  patchFile?: string;
-  /** [wave2] 子 agent session 文件路径（增量语义的全文恢复通道）。
-   *  仅 chatMode 透传（toNotifyRecord 条件透传）——轮次/完成通知末尾追加
-   *  "Full transcript: <path>" 指针行，父 LLM 可按需读全文；one-shot 不透传，
-   *  通知输出逐字节不变。缺失时 buildLlmContent 省略整行。 */
-  sessionFile?: string;
-  /** [C-2] close 终态通知的轮次统计（文案 "completed after N rounds." 用）。
-   *  仅 chatMode close 语义（notifyClosed）构造时携带——此时 dedup 身份 round 已被
-   *  置 undefined（与轮次通知的 id:round key 区分，终态不被吞），轮数改由本字段进
-   *  文案。one-shot 完成通知不设置，文案保持 "completed. Result:" 逐字节（G4）。 */
-  totalRounds?: number;
-}
-
-/** notifier 依赖的宿主最小接口（解耦，便于测试）。
- *  迁移后：仅用于构造 DeliveryPort 的底层依赖。 */
-export interface NotifierHost {
-  /** 注入消息到主对话。 */
-  sendMessage(
-    message: { customType: string; content: string; display: boolean; details?: unknown },
-    options?: { triggerTurn?: boolean; deliverAs?: "steer" | "followUp" | "nextTurn" },
-  ): void;
-  /** 是否还有 running 的 background 任务（用于滑动窗口立即 flush 判断）。 */
-  hasRunningBackground(): boolean;
-  /** 主 agent 是否空闲（非 streaming）。可选：未注入时 flush 不 gate。 */
-  isIdle?: () => boolean;
-  /**
-   * 原生 settled 事件订阅能力（D8）：注册 handler 监听主 agent settled 边沿。
-   * 无退订语义（pi 0.84.1 的 `pi.on(...)` 全部重载返回 void、无 off——实装锚点：
-   * node_modules `@earendil-works/pi-coding-agent` dist/core/extensions/types.d.ts
-   * `on()` 系列重载，0.84.1 实测）——退订由本模块的 disposed
-   * 标志包装兑现（见下方 port 装配）。可选：未注入时内核退化退避轮询（busy 消息
-   * 靠退避达上限强发，不走 settled 边沿驱动）。
-   */
-  onAgentSettled?(handler: () => void): void;
-}
-
-/** 发送给主对话的 customType（bg-notify-render 消费）。 */
-const NOTIFY_CUSTOM_TYPE = "subagent-bg-notify";
-
-/**
- * 将 BgNotifyRecord 格式化为 LLM 可读的 notification content。
- *
- * 模块内唯一消费方是下方 createNotifier 的 notify()（预格式化后传 delivery.send，
- * 内核只做拼接——多条以 "\n\n---\n\n" join）。
- */
-function buildLlmContent(record: BgNotifyRecord): string {
-  const agent = record.agent;
-  const id = record.id;
-  // [wave2 指针行] 增量语义下轮次通知只携带本轮增量，异步 flush 窗口丢失时不可重发
-  //（见 subagent-service.ts onRoundSettled 注释），恢复通道是 session 文件全文。
-  // 仅 chatMode 透传 sessionFile，one-shot 通知不含该行；cancelled/gc-failed 不追加
-  //（无成功结果可读，指针无意义）；缺失时省略整行（追加空串 = 输出逐字节不变）。
-  const transcriptPointer = record.sessionFile
-    ? `\n\nFull transcript: ${record.sessionFile}`
-    : "";
-  switch (record.status) {
-    case "closed": {
-      // v4 B-1: closed 统一终态（含 cancelled）。按 closedReason 派生通知文案。
-      const reason = record.closedReason ?? "gc";
-      if (reason === "cancelled") {
-        return `Subagent "${agent}" (${id}) cancelled.`;
-      }
-      // 失败场景（gc + 有 error）：展示错误。判定必须先于 patchFile——失败轮也会写
-      // patchFile（doFinalizeRecord Step 0 对 worktreeHandle 无条件 collectPatch），若
-      // patch 分支在前，gc 失败 + worktree 并存时 LLM 被告知 completed。顺序与三处
-      // 同构契约的另外两处一致（shared/subagent.ts deriveClosedDisplay、
-      // bg-notify-render.ts renderRecordLines：cancelled → gc+error → patch/result）。
-      if (record.error && reason === "gc") {
-        return `Subagent "${agent}" (${id}) failed: ${record.error}`;
-      }
-      // 成功完成（user-close）或通用结束（gc/parent-shutdown 等）：展示结果。
-      // [C-2] chatMode close 终态通知附轮次统计（设计 D2 路径①"completed after N rounds"）。
-      // totalRounds 仅 close 语义携带（notifyClosed）；one-shot 完成通知不设置（round 无轮次
-      // 语义），文案保持 "completed. Result:" 逐字节（G4 硬约束，one-shot 字节锁测试锚定）。
-      const roundsSuffix =
-        record.totalRounds != null && record.totalRounds > 0
-          ? ` after ${record.totalRounds} round${record.totalRounds === 1 ? "" : "s"}`
-          : "";
-      const base = `Subagent "${agent}" (${id}) completed${roundsSuffix}. Result:\n${record.result ?? "(empty)"}`;
-      if (record.patchFile) {
-        // [wave2 review] 长 return 拆行：模板串内不可直接换行（会改变输出内容），提取 patchHint 中转变量
-        const patchHint = `\n\nThis subagent ran in an isolated worktree; its file changes were captured as a patch:\n  ${record.patchFile}\nTo bring these changes into the current repo, run: \`git apply ${record.patchFile}\``;
-        return `${base}${patchHint}${transcriptPointer}`;
-      }
-      return `${base}${transcriptPointer}`;
-    }
-    case "running":
-      // v4 B-1: 对话模式轮次完成（旧 idle 折入 running）：携带本轮结果送回主 agent，等待下一轮 message。
-      return `Subagent "${agent}" (${id}) finished a round. Reply:\n${record.result ?? "(empty)"}${transcriptPointer}`;
-  }
-}
-
-/**
- * Background 完成通知器接口（迁移后由内核实现）。
- *
- * 保持与旧 BgNotifier 类相同的公共 API，避免消费方（subagent-service）改动面过大。
- */
-export interface BgNotifier {
-  /** 入队一条完成通知（去重 + 合批窗口合并）。dispose 后短路。 */
-  notify(record: BgNotifyRecord): void;
-  /** 立即 flush（session_shutdown 调用，防丢失）。 */
-  flushPendingNotifications(): void;
-  /** session 结束：清队列，dispose 内核 handle。 */
-  dispose(): void;
-  /** /resume /fork /new 后复活。 */
-  revive(): void;
-}
-
-/**
- * 创建 Background 完成通知器（薄工厂，装配 @xyz-agent/session-delivery 内核）。
- *
- * 内核接管：gate（isIdle 退避）/ 合批窗口（滑动 60s）/ dedup（按 id:round）/ flush / shutdown flush。
- * 本函数职责：将 BgNotifyRecord → DeliveryMessage 映射 + buildLlmContent 预格式化。
- *
- * @param host 宿主能力注入（pi.sendMessage + hasRunningBackground + isIdle）
- * @returns BgNotifier 接口（与旧类同形）
- */
-export function createNotifier(host: NotifierHost): BgNotifier {
-  let disposed = false;
-
-  // 构造 DeliveryPort：intent → pi 参数翻译在适配器内（D3）
-  const port: DeliveryPort = {
-    supportedPayloads: ["custom"],
-    isIdle: () => {
-      if (host.isIdle) {
-        return host.isIdle();
-      }
-      // 未注入 isIdle → 视为 idle（不 gate，向后兼容旧 host）
-      return true;
-    },
-    hasPendingMessages: () => false, // notifier 不关心 hasPendingMessages
-    // D8（must-fix #4）：settled 边沿驱动装配——内核 busy 入队后由 settled 事件唤醒
-    // flush（watch-dog 兜底事件丢失），替代无订阅时的退避轮询。host 只注入原生订阅
-    // 能力；disposed 标志包装（兑现退订语义——pi.on 返回 void 且无 off）在此完成。
-    subscribeSettled:
-      host.onAgentSettled === undefined
-        ? undefined
-        : (cb) => {
-            let disposed = false;
-            host.onAgentSettled?.(() => {
-              if (!disposed) cb();
-            });
-            return () => {
-              disposed = true;
-            };
-          },
-    send: (msg, intent) => {
-      host.sendMessage(
-        {
-          customType: NOTIFY_CUSTOM_TYPE,
-          content: msg.payload.content,
-          display: true,
-          details: msg.payload.kind === "custom" ? msg.payload.details : undefined,
-        },
-        intent === "interrupt-at-turn-boundary"
-          ? { triggerTurn: true, deliverAs: "steer" }
-          : { triggerTurn: true, deliverAs: "followUp" },
-      );
-    },
-  };
-
-  // #5（must-fix）：内核 handle 的 disposed 不可逆——dispose 后 revive 必须重建 handle，
-  // 否则 revive 后所有 notify() 被内核静默吞（外层标志复位救不回已销毁的内核）。
-  // revive = 新生命周期：合批窗口 / 在途批次 / dedup LRU 随重建自然复位（可接受）。
-  const createHandle = (): DeliveryHandle =>
-    createDelivery(port, {
-      intent: "interrupt-at-turn-boundary",    // D3：turn 边界抢占（F1 教训内化）
-      mergeWindowMs: 60_000,                   // 滑动窗口合批（继承 MERGE_WINDOW_MS=60s）
-      mergeHoldActive: () => host.hasRunningBackground(), // D4 must-fix #1：禁止用 isIdle 代替
-      busyPolicy: "retry-force",               // settled 边沿驱动 + 退避达上限强发
-      backoff: { ms: 100, max: 50 },           // 继承 FLUSH_BACKOFF_MS/MAX
-      // dedup LRU：语义与旧 DEDUP_TTL_MS=60s **不同**——按 key 永久去重（仅 LRU 逐出后
-      // 同 key 可再入）。当前 key 空间（id / id:round，id 每 spawn 唯一）无实际差异；
-      // 后续复用方勿按「60s 内不重复」假设接入（同 key 通知会被永久吞）。
-      dedupe: { maxKeys: 1000 },
-    });
-  let handle: DeliveryHandle = createHandle();
-
-  return {
-    notify(record: BgNotifyRecord): void {
-      if (disposed) return;
-
-      // dedup key：idle（对话模式每轮完成）按 id:round 去重——不同轮次不互相掩蔽；
-      // 非 idle（closed/cancelled）round 恒定 undefined，key 同旧行为不变。
-      const dedupeKey = record.round != null ? `${record.id}:${record.round}` : record.id;
-
-      handle.send({
-        payload: {
-          kind: "custom",
-          customType: NOTIFY_CUSTOM_TYPE,
-          content: buildLlmContent(record),
-          display: true,
-          details: record,
-        },
-        dedupeKey,
-      });
-    },
-
-    flushPendingNotifications(): void {
-      handle.flush();
-    },
-
-    dispose(): void {
-      disposed = true;
-      handle.dispose();
-    },
-
-    revive(): void {
-      disposed = false;
-      // #5：内核 disposed 不可逆——revive 必须重建 handle（/resume /fork /new 后的
-      // session_start 时序：disposeAll → initSession → revive）。旧 handle 若仍存活
-      // （首次 session_start 的 revive）dispose 为幂等清理，无副作用。
-      handle.dispose();
-      handle = createHandle();
-    },
-  };
-}

package/src/execution/output-collector.ts

@@ -1,88 +0,0 @@
-// src/core/output-collector.ts
-//
-// 结果收集器（Record + CollectResultArgs → AgentResult）。
-//
-// 收口设计（2026-06-22）：collectResult 全部从 record 读——
-//   text ← getFullText(record)（聚合 turns[].text，不再读 session.messages）
-//   turns ← record.turnCount
-//   toolCalls ← getAllToolCalls(record)（扁平化 turns[].toolCalls）
-//   usage ← getTotalUsage(record)（聚合 turns[].usageDelta）
-//
-// 基础层模块：依赖 execution-record（派生函数）+ types。
-
-import type {
-  AgentResult,
-  ExecutionRecord,
-  ToolCall,
-} from "./types.ts";
-import {
-  getAllToolCalls,
-  getFullText,
-  getTotalUsage,
-} from "./execution-record.ts";
-
-// ============================================================
-// Result 收集
-// ============================================================
-
-/** collectResult 的入参（session 身份 + 执行控制字段，执行内容从 record 读）。 */
-export interface CollectResultArgs {
-  startTime: number;
-  success: boolean;
-  error: string | undefined;
-  sessionId: string;
-  sessionFile: string | undefined;
-}
-
-/** structured-output tool 名（与 structured-output 扩展 TOOL_NAME 一致，见 session-runner.ts）。 */
-const STRUCTURED_OUTPUT_TOOL = "structured-output";
-
-/**
- * 从 toolCalls 提取 structured-output 的 result.details（schema 模式产出）。
- * schema enforcement 保证 agent 调过该 tool（漏调会 steer 重试）；这里只做逆向提取。
- * 未调或无 details 返回 undefined。
- *
- * 导出以便直接单测（纯函数契约）。
- */
-export function extractParsedOutput(toolCalls: ToolCall[]): unknown {
-  for (let i = toolCalls.length - 1; i >= 0; i--) {
-    const tc = toolCalls[i]!;
-    if (tc.toolName === STRUCTURED_OUTPUT_TOOL && tc.result?.details !== undefined) {
-      return tc.result.details;
-    }
-  }
-  return undefined;
-}
-
-/**
- * 从 record + args 组装 AgentResult。每个字段来源单一且收口于 record：
- *   text      ← getFullText(record)（聚合 turns[].text，单一数据源）
- *   turns     ← record.turnCount
- *   toolCalls ← getAllToolCalls(record)（扁平化 turns[].toolCalls）
- *   usage     ← getTotalUsage(record)（聚合 turns[].usageDelta，全零则 undefined）
- *   parsedOutput ← extractParsedOutput(toolCalls)
- *
- * startTime 算 durationMs。
- *
- * success 双来源判定（调用方传入）：
- *   ① session.prompt() 抛错 → args.success=false
- *   ② prompt 成功但 record.lastError 非空（message_end stopReason=error）→ success=false
- */
-export function collectResult(
-  record: ExecutionRecord,
-  args: CollectResultArgs,
-): AgentResult {
-  const toolCalls = getAllToolCalls(record);
-  return {
-    text: getFullText(record),
-    turns: record.turnCount,
-    durationMs: Date.now() - args.startTime,
-    success: args.success,
-    error: args.error,
-    sessionId: args.sessionId,
-    toolCalls,
-    usage: getTotalUsage(record),
-    sessionFile: args.sessionFile,
-    parsedOutput: extractParsedOutput(toolCalls),
-  };
-}