@zhushanwen/pi-subagent-workflow 8.14.7 → 9.0.0

package/src/host/pi-host.ts

@@ -18,7 +18,11 @@
 //     project/workspace 根不在壳侧提供——core 消费方按 workspaceRoot 自行推导
 //     （u0-data-discovery 波次接注入消费）。C5⑥ 起 agents kind 追加第 4 根：
 //     core 包一级父目录（source "npm"）——core agents/ 资产进 pi 发现面，见
-//     corePackageNpmRoot 注释。
+//     corePackageNpmRoot 注释。[P5 D4-2] agents/workflows 的 npm/npm-dev 两根
+//     形态感知（taiji 态指 agentDir 父目录 = 实际安装目录，独立态保留 agentDir
+//     直拼），且 core 根对 workflows kind 同样注入（staged 副本入扫描面）——
+//     见 agentDirKindRoots 注释。skills/engines 的同构 npm 槽错位不在 P5 范围
+//     （D4 发现层 = agents/workflows 注入面；skills 另有「刻意不补」既有决策）。
 //   - countActiveFromEntries 适配：pi 侧真函数返回 CountActiveResult 对象，core
 //     端口契约是 number（core 消费面只读 .count，notify-ports.ts 契约注释）——
 //     foundation 单元登记给本单元的适配责任。
@@ -27,6 +31,7 @@
 //     是结构超集成员，多不碍兼容）——结构兼容由本注入点 typecheck 守护，上游签名
 //     漂移即红（notify-ports.ts「闭包红线」段）。
 
+import { existsSync } from "node:fs";
 import { createRequire } from "node:module";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -81,28 +86,40 @@ function corePackageNpmRoot(): string | undefined {
 
 /** agents/workflows 共享的 agentDir 派生根（末级目录名由 kind 决定）。
  *  顺序与 source 标签逐项对齐 resource-discovery.ts buildScanTargets 的
- *  user-pi → npm → npm-dev 段（根列表按优先级低→高排列，D2 语义边界）。 */
+ *  user-pi → npm → npm-dev 段（根列表按优先级低→高排列，D2 语义边界）。
+ *
+ *  [P5 D4-2 扫描根修正] npm/npm-dev 两根形态感知：taiji 宿主注入态改指 taiji
+ *  实际安装目录（agentDir 的父目录——taiji 布局迁移后 npm/extensions 是 agentDir
+ *  的 sibling，对齐 runtime pi-paths.ts getNpmDir/getExtensionsDir 的推导），独立
+ *  pi 形态保留 getAgentDir() 派生的 pi 语义根（现状即正确）。 */
 function agentDirKindRoots(kind: "agents" | "workflows"): DiscoveryRoot[] {
   const agentDir = getAgentDir();
+  // taiji 态 npm/extensions 布局 = agentDir 的 sibling（<dataDir>/npm、
+  // <dataDir>/extensions，agentDir = <dataDir>/agent）；旧 agentDir 直拼形态在
+  // taiji 态恒为不存在目录——taiji 形态下 npm 安装位与 staged 包发现面恒空的
+  // 病灶根因。已知误判面（有意接受，登记 deviations）：独立态用户以 -e 手动加载
+  // 本扩展时 argv 同样有 --extension，npm 槽根指到不存在的 <agentDir> 父目录 →
+  // 扫描静默空（损失 = 罕见场景的 npm 安装位发现；agentDir/npm 本就非 pi 官方布局）。
+  const installBase = isTaijiHostInjected() ? dirname(agentDir) : agentDir;
   const roots: DiscoveryRoot[] = [
     // 1. user .pi/agent/<kind>/
     { dir: join(agentDir, kind), source: "user-pi" },
-    // 2. npm global: agentDir/npm/node_modules/*/<pkg>/
-    { dir: join(agentDir, "npm", "node_modules"), source: "npm" },
-    // 3. npm dev symlink: agentDir/extensions/*/<pkg>/
-    { dir: join(agentDir, "extensions"), source: "npm-dev" },
+    // 2. npm global: <installBase>/npm/node_modules/*/<pkg>/
+    { dir: join(installBase, "npm", "node_modules"), source: "npm" },
+    // 3. npm dev symlink: <installBase>/extensions/*/<pkg>/
+    { dir: join(installBase, "extensions"), source: "npm-dev" },
   ];
-  // 4. core 包根（C5⑥，仅 agents kind）：追加在既有 npm 根之后——同标签多根依注入
-  //    序扫描 + last-writer-wins，core（随本包依赖分发的新模板）遮蔽同 agentDir 内
-  //    旧版残留副本；序位仍在 user 级之上、npm-dev/project 级之下（红线 1）。
-  //    workflows kind 刻意不注入：<available_workflows> 的 <location> 是 CA2 快照
-  //    不豁免面（红线 8 豁免仅限 10 内置 agent 角色路径前缀），注入会翻转内置
-  //    workflow 的胜出路径。
-  if (kind === "agents") {
-    const coreNpmRoot = corePackageNpmRoot();
-    if (coreNpmRoot !== undefined) {
-      roots.push({ dir: coreNpmRoot, source: "npm" });
-    }
+  // 4. core 包根（C5⑥ + P5）：agents/workflows 两 kind 都追加在既有 npm 根之后——
+  //    同标签多根依注入序扫描 + last-writer-wins，core（随本包依赖分发的新模板）
+  //    遮蔽同安装位内旧版残留副本；序位仍在 user 级之上、project 级之下（红线 1）。
+  //    [P5] workflows kind 的「刻意不注入」禁区拆除：原顾虑 = <available_workflows>
+  //    的 <location> 是 CA2 快照不豁免面（红线 8 豁免仅限 agent 角色路径前缀）。
+  //    P-C6 实施期核查裁决：CA2 锚定测试为 fixture 输入驱动（不消费运行时路径），
+  //    turn 间字节稳定由工厂渲染缓存 + 码点序构造性保证——staged 绝对路径渲染
+  //    <location> 不破坏快照稳定性，内置 workflow 因此可列出、路径可派发。
+  const coreNpmRoot = corePackageNpmRoot();
+  if (coreNpmRoot !== undefined) {
+    roots.push({ dir: coreNpmRoot, source: "npm" });
   }
   return roots;
 }
@@ -188,9 +205,180 @@ export function createPiHostServices(): HostServices {
         engines: engineRoots(),
       };
     },
+
+    // [D2 扩展加载显式化] 孙进程扩展路径集（per-host 常量，双形态解析见
+    // resolveGrandchildExtensionPaths 注释）。每次调用现解析（P-C2 惰性求值：
+    // configureCore 只挂函数引用，取值发生在 core run 派发期）。
+    extensionPaths(): string[] {
+      return resolveGrandchildExtensionPaths(process.argv);
+    },
   };
 }
 
+// ── [D2 扩展加载显式化] 孙进程扩展白名单注入源（双形态） ──
+
+/**
+ * 孙进程（subagent 任务子进程）schema 强制所需的最小扩展集（P-C5 起步裁决：
+ * 仅 structured-output）。全量 staged 下发会让孙进程加载全部无关扩展——每包都
+ * 可能注册工具/注入提示词，孙进程的工具面与 system prompt 行为不可控。
+ *
+ * 白名单组成唯一登记处（runtime 侧 getExtensionPaths 全量下发、本常量收窄，
+ * 无第二份判据副本——扩白名单只改此处并同步 pi-host.test.ts 用例，以及
+ * spawn-runner.ts 断言②的 SCHEMA_ENFORCEMENT_EXTENSION_SEGS 同判据两端）。
+ *
+ * 每条 = 路径段序列（`/`|`\` 分段后连续匹配）。两形态别名：
+ *   - `@zhushanwen/pi-structured-output`：npm staged 布局
+ *     `.../node_modules/@zhushanwen/pi-structured-output[/index.js]`。
+ *   - `universal/structured-output`：dev 源码布局 `.../extensions/universal/structured-output`
+ *     （dev 下 runtime 下发的 --extension 是源码目录，无 @zhushanwen scope 段——
+ *     只认 npm 布局时孙进程扩展集恒空，schema 拦截链静默失效）。
+ *     选型：两段连续匹配（分组目录名 + 包目录名）而非尾段单匹配 `structured-output`
+ *     ——尾段会撞任意同名无关目录（如其他包内的同名子目录）；两段含本仓 extensions
+ *     固定分组名 `universal`，且 --extension 值来源可控（runtime extension-service
+ *     下发 / pi CLI flags），实际碰撞面可忽略。
+ */
+const GRANDCHILD_EXTENSION_PKG_SEGMENTS: readonly (readonly string[])[] = [
+  ["@zhushanwen", "pi-structured-output"],
+  ["universal", "structured-output"],
+];
+
+/** npm 布局包名（peerDep 解析锚点与诊断文案用；匹配判据见上段集）。 */
+const GRANDCHILD_EXTENSION_NPM_PKG = "@zhushanwen/pi-structured-output";
+
+/**
+ * 孙进程扩展路径集解析（设计 D2 双形态；argv 与 peerDep 解析器经参数注入，纯函数
+ * 可测——HostServices 方法闭包传 process.argv）：
+ *   1. taiji 宿主形态：主 pi 进程 argv 的 `--extension` 全量值 = runtime
+ *      extension-service 经 spawn argv 下发的 staged 集——按白名单收窄。该形态
+ *      判据 = argv 有 `--extension`（taiji spawn 恒带）。
+ *   2. 独立 pi 形态（npm 安装、无 taiji runtime）：从包自身 optional peerDep 解析
+ *      structured-output sibling 路径（安装了即解析、未安装则空）。
+ * e2e 门：resolveE2eFaux 命中（faux-llm-ext.ts 在盘）时追加进结果末尾——见
+ * resolveE2eFauxExtensionPath 注释。双源皆空且无 e2e faux = 空数组（不炸；带
+ * schema run 的 fail-fast 属 H3 断言，非本通道职责）。
+ */
+export function resolveGrandchildExtensionPaths(
+  argv: readonly string[],
+  resolvePeer: () => string | undefined = resolveStructuredOutputPeer,
+  resolveE2eFaux: () => string | undefined = resolveE2eFauxExtensionPath,
+): string[] {
+  const stagedAll = collectExtensionFlagValues(argv);
+  const whitelisted = stagedAll.filter(isGrandchildExtensionPath);
+  const e2eFaux = resolveE2eFaux();
+  if (whitelisted.length > 0 || e2eFaux !== undefined) {
+    return e2eFaux !== undefined ? [...whitelisted, e2eFaux] : whitelisted;
+  }
+  const peer = resolvePeer();
+  return peer !== undefined ? [peer] : [];
+}
+
+/**
+ * e2e harness 专用的孙进程扩展放行门（faux 轨装配）。
+ *
+ * faux 轨（e2e/fixtures/launch-app-real.ts seedFauxDataDir）的孙进程 LLM 演员注入
+ * 靠 `<agentDir>/extensions/faux-llm-ext.ts` 自动发现装载——[D2 扩展加载显式化]
+ * 孙进程恒 `--no-extensions`（自动发现全关）+ 仅加载本文件白名单集后，该路径被
+ * 排除，孙进程报 `Model "faux/..." not found`。faux-llm-ext 是 e2e harness 复制进
+ * 临时数据目录的测试 provider 壳（非生产扩展，路径也不经主 pi argv——白名单
+ * filter 无法命中，须在此主动解析），故按装配归属放行：
+ * 仅 `process.env.TAIJI_E2E === "1"`（e2e harness 独有 env，生产进程无此值——
+ * 白名单收窄语义对生产不变）且文件在盘时返回该路径，由
+ * resolveGrandchildExtensionPaths 追加进孙进程显式 `--extension` 集。
+ */
+function resolveE2eFauxExtensionPath(): string | undefined {
+  if (process.env.TAIJI_E2E !== "1") return undefined;
+  const fauxExtPath = join(getAgentDir(), "extensions", "faux-llm-ext.ts");
+  return existsSync(fauxExtPath) ? fauxExtPath : undefined;
+}
+
+/** 路径是否命中孙进程扩展白名单：路径段序列包含白名单任一段集的连续匹配
+ *  （目录形态与入口文件形态都命中——末尾越界段取 undefined 不等，天然界内；
+ *  前缀相似目录如 `pi-structured-output-lookalike` 因段值不等不误判）。 */
+function isGrandchildExtensionPath(p: string): boolean {
+  const segs = p.split(/[\\/]/).filter((s) => s.length > 0);
+  return GRANDCHILD_EXTENSION_PKG_SEGMENTS.some((wanted) =>
+    segs.some((_, i) => wanted.every((w, j) => segs[i + j] === w)),
+  );
+}
+
+/**
+ * 独立形态回退源：optional peerDep sibling 解析（package.json 锚点 → 包根目录）。
+ * 解析失败（未安装 / 布局异常）= undefined，不炸——空集回退。
+ */
+function resolveStructuredOutputPeer(): string | undefined {
+  try {
+    const require = createRequire(import.meta.url);
+    return dirname(require.resolve(`${GRANDCHILD_EXTENSION_NPM_PKG}/package.json`));
+  } catch (err) {
+    getLogger("pi-host").debug(
+      "[pi-host] structured-output optional peerDep 未解析（独立形态未安装，孙进程扩展集回退空）",
+      { reason: toErrorMessage(err) },
+    );
+    return undefined;
+  }
+}
+
+/**
+ * 从 argv 提取 `--extension` / `-e` 的全部值（等号与空格两种形式；自旧
+ * mirrorMainProcessFlags 的解析规则精简迁移——该镜像机制已废弃，此处只取
+ * extension 值，布尔镜像面不再透传）。
+ *
+ * 有值 flag 表（跳过其他 flag 的值时不误吃）与 MF-7a 判定（`--extension` 后跟
+ * `--` 开头 token 不吃值）逐字保留原语义——解析坑防回归见 pi-host.test.ts
+ * 解析用例（--skill 值跳过 / 真 flag 不吃值 / 单 - 路径是值）；
+ * spawn-args.test.ts 历史族已随镜像退役换代。
+ */
+const ARGV_VALUED_FLAGS = new Set<string>([
+  "--extension", "-e",
+  "--skill",
+  // g4-allow: argv 有值 flag 解析词表（跳过非 extension flag 的值防误吃），非模型引用拼装
+  "--model", "--system-prompt", "--append-system-prompt", // g4-allow: 同上——解析词表成员，非拼装
+  "--tools", "-t", "--exclude-tools", "-xt",
+  "--fork", "--session-dir", "--mode",
+  "--thinking", "--models",
+]);
+
+/** argv 中 flag 起始索引：argv[0]=runtime，argv[1]=binary 路径。 */
+const ARGV_FLAG_START = 2;
+
+/**
+ * taiji 宿主注入态判据（P5 D4-2 扫描根修正；形态判据复用 H2 先例）：主 pi 进程
+ * argv 含 --extension/-e 值即 taiji spawn（runtime 恒带 staged 全量集下发的
+ * --extension；独立 pi 经 settings 清单加载扩展，argv 无该 flag）。
+ * 与 resolveGrandchildExtensionPaths 的白名单收窄是两个决策——此处只做形态判定
+ * （决定扫描根指向），不做白名单（白名单只约束孙进程扩展集）。
+ */
+function isTaijiHostInjected(argv: readonly string[] = process.argv): boolean {
+  return collectExtensionFlagValues(argv).length > 0;
+}
+
+function collectExtensionFlagValues(argv: readonly string[]): string[] {
+  const values: string[] = [];
+  const flagArgs = argv.length > ARGV_FLAG_START ? argv.slice(ARGV_FLAG_START) : [];
+  for (let i = 0; i < flagArgs.length; i++) {
+    const tok = flagArgs[i];
+    const eqMatch = /^(--extension|-e)=(.*)$/.exec(tok);
+    if (eqMatch !== null) {
+      if (eqMatch[2]) values.push(eqMatch[2]);
+      continue;
+    }
+    if (tok === "--extension" || tok === "-e") {
+      const next = flagArgs[i + 1];
+      // 单 `-` 开头的合法路径不是 flag（原 MF-7a）；`--` 开头是真 flag，不吃值
+      if (next !== undefined && !next.startsWith("--") && next.length > 0) {
+        values.push(next);
+        i++;
+      }
+      continue;
+    }
+    if (ARGV_VALUED_FLAGS.has(tok)) {
+      i++;
+      continue;
+    }
+  }
+  return values;
+}
+
 /**
  * pi 侧通知域窄端口实现（configureNotifyDomain 注入）。zsw 壳不注入本端口
  * （其完成通知走 HostServices.notify，P2 落地）。

package/src/index.ts

@@ -2,8 +2,8 @@
  * subagent-workflow Extension — Factory（extension 装配点）
  *
  * 合并 @zhushanwen/pi-subagents + @zhushanwen/pi-workflow 为统一包。
- * 注册项：3 tool（subagent + workflow + workflow-script）+ 2 command（subagents + workflows）
- * + messageRenderer（subagent-bg-notify）+ pi.__workflowRun + session 事件。
+ * 注册项：4 tool（subagent + subagents + workflow + workflow-script）+ 2 command（subagents + workflows）
+ * + messageRenderer（subagent-bg-notify）+ session 事件。
  *
  * 包内结构（执行运行时已迁 packages/subagent-core，本包只留注册面与宿主适配）：
  *   interface/           → 注册胶水（tools / commands / TUI 渲染 / GUI mappers）
@@ -12,12 +12,12 @@
  *   session-lifecycle.ts → 会话生命周期装配 seam（测试可注入 fake 依赖）
  *   workflow-events.ts   → workflow 域事件族装配 seam（7 个 pi.on handler + deps 装配）
  *
- * 本文件 = 组合根：只留注册（tools / commands / renderer / pi.__workflowRun / 进程级
- * 信号 hook）与装配接线（core 端口 / 注入器 / 两个 seam 调用）。
+ * 本文件 = 组合根：只留注册（tools / commands / renderer / 进程级信号 hook）与
+ * 装配接线（core 端口 / 注入器 / 两个 seam 调用）。
  *
  * 架构导航见 docs/extensions/subagents/architecture.md。
  *
- * 设计基线：D-004（旧包不动）/ ADR-025（进程内执行）/ D-8（pi.__workflowRun 签名）。
+ * 设计基线：D-004（旧包不动）/ ADR-025（进程内执行）。
  */
 
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
@@ -28,10 +28,7 @@ import { toErrorMessage } from "@zhushanwen/pi-ext-guards";
 // ═══ core 宿主端口接线（subagent-core 包抽离 u0-wire；实现见 src/host/pi-host.ts） ═══
 import { configureCore } from "@zhushanwen/subagent-core";
 import { configureNotifyDomain } from "@zhushanwen/subagent-core";
-import { setInFlightListener } from "@zhushanwen/subagent-core";
 import { createPiHostServices, createPiNotifyDomainPorts } from "./host/pi-host.ts";
-// [u7a D5] 壳层在途上报出口：core 状态迁移 → 本出口 → select 通道（marker 帧）→ runtime。
-import { createInFlightReporter } from "./host/inflight-reporter.ts";
 
 // ═══ 经 core barrel 消费执行域（执行运行时住 packages/subagent-core） ═══
 // [U7] 引擎列表状态文件（registry → engines.json，GUI 引擎选择器数据源）
@@ -42,8 +39,9 @@ import { syncEnginesFile } from "@zhushanwen/subagent-core";
 // [P3 引擎接线] 组合根登记 'zcode' 引擎（D8 薄壳：vendored 定位 cli descriptor；
 // engineDataDir 默认走 common/data-dir SSOT）
 import { registerZcodeEngine } from "@zhushanwen/subagent-core";
-import { killAllSpawnedChildren } from "@zhushanwen/subagent-core";
-import { runAndWait, type WorkflowRunResult } from "@zhushanwen/subagent-core";
+import { markAllSpawnedChildrenDead } from "@zhushanwen/subagent-core";
+// bg-notify 送达通道 customType（notify 词表单源，与 shared/runtime/core 消费侧同源）
+import { SUBAGENT_BG_NOTIFY_CUSTOM_TYPE } from "@zhushanwen/extension-protocol";
 // [engine-awareness U3/D7-④] per-turn 引擎检测编排 + before_agent_start 链尾接线
 import { setupEngineAwarenessInjector } from "./injectors/engine-awareness.ts";
 import { setupModelListInjector } from "./injectors/model-list-injector.ts";
@@ -57,23 +55,10 @@ import { registerSubagentsCommand } from "./interface/subagents.ts";
 import { registerSubagentsTool } from "./interface/tool-subagents.ts";
 import { registerWorkflowTool } from "./interface/tool-workflow.ts";
 import { registerWorkflowScriptTool } from "./interface/tool-workflow-script.ts";
-// ═══ workflow 域事件族装配 seam（7 个 pi.on handler + makeDeps/getWorkflowDeps/
-// lazyDeps；与 session-lifecycle.ts 同构，D2 原样搬移 + lazyDeps 样板收敛） ═══
+// ═══ workflow 域事件族装配 seam（7 个 pi.on handler + makeDeps/lazyDeps；
+// 与 session-lifecycle.ts 同构，D2 原样搬移 + lazyDeps 样板收敛） ═══
 import { setupWorkflowDomain } from "./workflow-events.ts";
 
-// ── pi.__workflowRun 类型扩展（D-8 签名） ─────────────────
-
-declare module "@earendil-works/pi-coding-agent" {
-  interface ExtensionAPI {
-    __workflowRun?: (
-      workflowName: string,
-      workflowArgs: Record<string, unknown>,
-      workflowSignal?: AbortSignal,
-      workflowTimeoutMs?: number,
-    ) => Promise<WorkflowRunResult>;
-  }
-}
-
 // ── Factory ──────────────────────────────────────────────────
 
 // 模块级 logger（setPiHandle 注入后自动走 appendEntry）
@@ -83,23 +68,23 @@ const logger = getLogger("subagents");
 //
 // session_shutdown 是 pi 的 async hook，进程被 SIGTERM/SIGINT 强杀或崩溃时来不及
 // 触发；sync 子进程（controller 为 undefined，abortRunningControllers 跳过它们）会
-// 泄漏为孤儿。process.on 兜底调 killAllSpawnedChildren——[如实口径] core 侧该入口
-// 为镜像置死 no-op（仅清空 core spawnedChildren 镜像记账，不发任何进程信号），真实
-// 回收链 = 子进程 stdin-EOF 自灭（宿主退出 / EngineClient 销毁）+ dispose 链；本调用
-// 保留兜底占位（镜像一致性），不构成真实收割。guard 防多信号叠加（如 SIGINT 后又
-// beforeExit）重复触发。
+// 泄漏为孤儿。process.on 兜底调 markAllSpawnedChildrenDead——core 侧该入口为
+// 镜像置死 no-op（仅清空 core spawnedChildren 镜像记账，不发任何进程信号；命名即
+// 语义，防「kill 前缀」误读为发信号），真实回收链 = 子进程 stdin-EOF 自灭（宿主
+// 退出 / EngineClient 销毁）+ dispose 链；本调用保留兜底占位（镜像一致性），不构成
+// 真实收割。guard 防多信号叠加（如 SIGINT 后又 beforeExit）重复触发。
 let processShutdownHookFired = false;
 
 function reapSpawnedChildrenOnShutdown(): void {
   if (processShutdownHookFired) return;
   processShutdownHookFired = true;
   try {
-    killAllSpawnedChildren("SIGTERM");
+    markAllSpawnedChildrenDead();
   } catch (err) {
     // best-effort：收割失败不阻断退出流程——debug 留痕（孤儿子进程排查线索），
     // 不静默吞错，对齐「错误必须可操作」。
     logger.debug(
-      "[subagents] process shutdown reap best-effort failed (killAllSpawnedChildren SIGTERM)",
+      "[subagents] process shutdown reap best-effort failed (markAllSpawnedChildrenDead)",
       { reason: toErrorMessage(err) },
     );
   }
@@ -139,13 +124,6 @@ export default function subagentsWorkflowExtension(pi: ExtensionAPI): void {
   // [P3 引擎接线] 登记 'zcode'（幂等同上）。D8 薄壳：vendored 定位 cli descriptor。
   registerZcodeEngine();
 
-  // [u7a D5] 在途聚合上报接线：core 状态迁移（spawn/close/arm/disarm）→ 出口回调 →
-  // 本 reporter 经 select 通道推绝对计数帧。出口为进程级单监听（在途记账本身是 pi
-  // 进程级模块状态），后注册覆盖先注册（jiti 重载幂等）；回调同步 void，不进任何
-  // 生命周期 await 链（D5 接线约束①）。ctx 由 session_start 注入（factory 阶段无 ui）。
-  const inflightReporter = createInFlightReporter();
-  setInFlightListener(inflightReporter.onInFlightChanged);
-
   // [U7b] 引擎列表在 extension 模块加载时即同步 engines.json（不等 session_start——
   // 用户体验拍板 2026-08-25：taiji 打开后激活任意 session 的第一时间（含 TUI 等价
   // 场景）GUI 引擎选择器就该有数据；session_start 处保留幂等重写兜底 jiti 双路径/
@@ -165,7 +143,7 @@ export default function subagentsWorkflowExtension(pi: ExtensionAPI): void {
   // ════════════════════════════════════════════════════════════
   registerSubagentTool(pi);
   registerSubagentsCommand(pi);
-  pi.registerMessageRenderer("subagent-bg-notify", renderBgNotifyMessage);
+  pi.registerMessageRenderer(SUBAGENT_BG_NOTIFY_CUSTOM_TYPE, renderBgNotifyMessage);
 
   // ════════════════════════════════════════════════════════════
   //  injectors：before_agent_start 注入 <available_subagents> + <available_workflows>
@@ -186,9 +164,10 @@ export default function subagentsWorkflowExtension(pi: ExtensionAPI): void {
   //  状态创建（lsRef / notifiedRunIds / workerHost / registry / sessionState）、log、
   //  makeLifecycleDeps / makeDeps、7 个 pi.on handler、getWorkflowDeps 守卫 +
   //  lazyDeps 已收编 workflow-events.ts（事件族 seam，与 session-lifecycle.ts 同构；
-  //  7 个 handler 的注册相对顺序原样保留）。此处仅接线。
+  //  7 个 handler 的注册相对顺序原样保留）。此处仅接线——在途上报（createInFlightReporter
+  //  + setInFlightListener 登记与 attach/detach 驱动）同为该 seam 家内装配。
   // ════════════════════════════════════════════════════════════
-  const workflow = setupWorkflowDomain(pi, { inflightReporter });
+  const workflow = setupWorkflowDomain(pi);
 
   // ════════════════════════════════════════════════════════════
   //  [U7 + engine-awareness U3] before_agent_start：引擎感知注入（链尾注册，D7——
@@ -246,36 +225,6 @@ export default function subagentsWorkflowExtension(pi: ExtensionAPI): void {
   process.on("SIGINT", sigintHandler);
   process.on("beforeExit", reapSpawnedChildrenOnShutdown);
 
-  // ════════════════════════════════════════════════════════════
-  //  pi.__workflowRun（D-8 签名）
-  // ════════════════════════════════════════════════════════════
-  pi.__workflowRun = async (
-    workflowName: string,
-    workflowArgs: Record<string, unknown>,
-    workflowSignal?: AbortSignal,
-    workflowTimeoutMs?: number,
-  ): Promise<WorkflowRunResult> => {
-    // 注意：lastSessionId 是单值假设——Pi 当前保证单 session 串行（一次只一个活跃 session）。
-    // 若未来 Pi 支持多 session 并发，此处需改为从 ctx.sessionManager.getSessionId() 显式传入。
-    // M-2 已记录此假设。
-    const resolved = workflow.getWorkflowDeps(workflow.state.lsRef.lastSessionId);
-    if (!resolved.ok) {
-      return {
-        status: "done",
-        reason: "failed",
-        error: resolved.reason,
-        runId: "",
-      };
-    }
-    return runAndWait(
-      workflowName,
-      workflowArgs,
-      resolved.deps,
-      workflowSignal,
-      workflowTimeoutMs,
-    );
-  };
-
   // ════════════════════════════════════════════════════════════
   //  Tools（3 个）+ Commands（2 个）—— 注册面
   //