@zhushanwen/pi-subagent-workflow 8.5.0 → 8.7.0

package/src/orchestration/execute-agent-call.ts

@@ -1,217 +0,0 @@
-/**
- * Workflow Extension — executeAgentCall（关键路径）
- *
- * 单次 agent 调用执行的 Engine free function（D-12）。显式 5 参数
- * `(call, runner, budget, signal, trace)`，无依赖注入 bag（AC-2：消除散落的
- * Context factory）。
- *
- * 职责：
- * - 重试：3 次 + 指数退避（BACKOFF_MS = [1000, 2000, 4000]）
- * - 预算：超限不重试（直接 markDone failed）
- * - stale-context：不重试（直接 markDone failed）
- * - 成功：consume usage + incrementCallCount + markDone + trace.update(completed)
- *
- * 关键设计：
- * - **usage 透传**：result.usage 直接交给 budget.consume，加权由 Budget 内部的权重常量
- * 处理（见 budget.ts）。此函数不再做 usage 形状的改写。
- * - **参数显式化**：runner 直接传入（而非 ctx.getRun(runId).pool），无 runId 查找 / pool 守卫。
- * - **stale-state 检查**：signal.aborted 时早返回。WorkflowRun 状态由调用方 lifecycle
- * 持有，executeAgentCall 只关心单次 call 生命周期。
- *
- * 层归属：Engine。零 infra 依赖（runner 是 AgentRunner port，budget/trace/call 是 Engine 模型）。
- *
- * 参考：domain-models.md §5 + §失败处理矩阵。
- */
-
-import type { SubagentStream } from "../execution/stream-sink.ts";
-import type { AgentEvent } from "../shared/agent-event.ts";
-import type { AgentCall } from "./models/agent-call.ts";
-import type { Budget } from "./models/budget.ts";
-import type { AgentRunner } from "./models/ports.ts";
-import type { Trace } from "./models/trace.ts";
-import type { AgentResult } from "./models/types.ts";
-
-// ── 常量 ─────────────────────────────────────────────────────
-
-/** 指数退避基数（ms）：第 n 次重试等待 BASE^n。 */
-const BACKOFF_BASE_MS = 1000;
-const BACKOFF_EXPONENT_BASE = 2;
-
-/** 最大尝试次数（含首次）：initial + 2 retries = 3。 */
-const MAX_ATTEMPTS = 3;
-
-/**
- * Stale context 检测模式（P1-5；W4b 对齐 pi 0.84.x 真实文案）。
- *
- * pi session context 被 compact/cancel 时报告的模式。这种情况下重试无意义——
- * 同样的 call 会再次失败。直接 markDone failed 终止单次调用。
- *
- * W4b：原 "stale context"/"stalecontext" 与 pi 真实文案零匹配（真实文案为
- * "This extension ctx is stale after session replacement or reload. ..."——
- * runner.ts:544（dist runner.js:352），词序是 "ctx is stale" 而非 "stale context"），stale 分诊对
- * 真实文案失效。现对齐：
- * - "ctx is stale"：真实文案核心子串（词序修正）
- * - "stale after session replacement"：scheduler 已验证 marker（runtime.ts
- *   STALE_CTX_MARKER，同文案锚定）
- * - "context canceled"/"aborted"：保留——abort 族错误同样不重试（signal.aborted
- *   分支的先行分诊，防边界竞态漏网），删除会放宽重试语义。
- */
-export const STALE_CONTEXT_PATTERNS = [
-  "ctx is stale",
-  "stale after session replacement",
-  "context canceled",
-  "aborted",
-] as const;
-
-/**
- * 判断错误信息是否表示 stale/canceled pi session context。
- * 命中时不重试——重试只会再次失败（P1-5）。
- */
-export function isStaleContextErrorMsg(msg: string | undefined): boolean {
-  if (!msg) return false;
-  const lower = msg.toLowerCase();
-  return STALE_CONTEXT_PATTERNS.some((p) => lower.includes(p));
-}
-
-// ── 内部 helper ──────────────────────────────────────────────
-
-/**
- * 计算第 n 次重试前的退避时间（ms）。
- * 第 1 次重试 → 1000ms，第 2 次 → 2000ms，第 3 次 → 4000ms（指数退避）。
- */
-function backoffDelay(retryIndex: number): number {
-  return BACKOFF_BASE_MS * Math.pow(BACKOFF_EXPONENT_BASE, retryIndex - 1);
-}
-
-/**
- * 终态化单次 call：markDone + trace.update。
- *
- * 成功：status="completed"；失败：status="failed"。
- * traceNode.stepIndex === call.id（D-10 单源，调用方保证）。
- *
- * 孤儿守卫（OB2，S7 残留）：isOrphaned 谓词为 true 时跳过 trace.update——
- * rebuild 竞态窗口中，重跑 dispatch 已 append 同 stepIndex 新节点，旧代际
- * finalize 的 update 会命中新节点，TUI/中间快照短暂可见错误终态。正确性论证：
- * 运行期 calls Map 写点仅 discardInFlightCalls 的 delete 与 dispatchAgentCall 的
- * set 两族（error-recovery.ts isOrphanedCall 文档注释既定），故实例不等 ⟺ 本
- * finalize 属于被丢弃/被替换的旧代际——与 dispatch 层 .then/.catch 守卫
- * （S7-second 修复，8353f6b60）同一判定语义，本守卫只是把它前移到 trace.update
- * 之前。markDone 与 sessionId/sessionFile 同步保留（markDone 在孤儿实例上无害，
- * dispatch 层 catch 路径依赖 call.status 语义）。跳过时不记日志——本文件是纯
- * 函数层无日志通道，dispatch 层 .then 守卫的 orphan completion dropped 日志已
- * 覆盖同一事件的可观察性。
- */
-function finalizeCall(
-  call: AgentCall,
-  result: AgentResult,
-  trace: Trace,
-  isOrphaned?: () => boolean,
-): void {
-  call.markDone(result);
-  const status = result.error === undefined ? "completed" : "failed";
-  // 同步 AgentCall 的 sessionId/sessionFile（对齐 trace 节点，持久化 + reset 用）
-  if (result.sessionId !== undefined) call.setSessionId(result.sessionId);
-  if (result.sessionFile !== undefined) call.setSessionFile(result.sessionFile);
-  if (isOrphaned?.()) return;
-  trace.update(call.id, {
-    status,
-    result,
-    completedAt: new Date().toISOString(),
-    sessionId: result.sessionId,
-    sessionFile: result.sessionFile,
-  });
-}
-
-/**
- * 延迟工具（testable —— 测试可通过 fake timers 推进）。
- */
-function delay(ms: number): Promise<void> {
-  return new Promise((resolve) => {
-    const timer = setTimeout(resolve, ms);
-    timer.unref();
-  });
-}
-
-// ── executeAgentCall ─────────────────────────────────────────
-
-/**
- * 执行单次 agent 调用，含重试 + 预算 + stale-context 检测。
- *
- * 流程：
- * 1. markRunning（attempts++，含首次）
- * 2. await runner.run(opts, signal)（AgentRunner port，infra 实现 spawn pi 子进程）
- * 3. 若 result.usage 存在：consumeUsage（D.4 修复）
- * 4. stale-context → finalizeCall failed，返回（不重试）
- * 5. signal.aborted → 返回（调用方已终止，不重试）
- * 6. budget.isExceeded → finalizeCall failed，返回（不重试）
- * 7. 失败 && attempts < MAX → 退避后递归（下一次 markRunning）
- * 8. 否则 finalizeCall（completed 或 failed）+ incrementCallCount
- *
- * @param call AgentCall 实体（markRunning/markDone 由本函数驱动）
- * @param runner AgentRunner port（执行子进程）
- * @param budget Budget 值对象（consume + isExceeded 检查）
- * @param signal AbortSignal（runner.run 传播；abort 后不重试）
- * @param trace Trace 值对象（finalizeCall 时 update）
- * @param onEvent 实时事件回调（live record 更新用）
- * @param stream streaming sink（透传 runner.run）
- * @param isOrphaned 孤儿判定谓词（OB2，可选，默认恒 false）：true 时 finalizeCall
- *   跳过 trace.update（判定语义与正确性论证见 finalizeCall 文档注释）。递归重试
- *   透传本谓词。
- */
-export async function executeAgentCall(
-  call: AgentCall,
-  runner: AgentRunner,
-  budget: Budget,
-  signal: AbortSignal,
-  trace: Trace,
-  onEvent?: (event: AgentEvent) => void,
-  stream?: SubagentStream,
-  isOrphaned?: () => boolean,
-): Promise<void> {
-  call.markRunning();
-
-  const result = await runner.run(call.opts, signal, onEvent, stream);
-
- // 累加 usage（加权由 budget.consume 内部按权重常量处理，见 budget.ts）
-  if (result.usage) {
-    budget.consume(result.usage);
-  }
-
- // stale-context：不重试（P1-5）
-  if (result.error !== undefined && isStaleContextErrorMsg(result.error)) {
-    finalizeCall(call, result, trace, isOrphaned);
-    budget.incrementCallCount();
-    return;
-  }
-
- // signal 已 abort：调用方终止，不重试（避免无意义的递归）
-  if (signal.aborted) {
-    finalizeCall(call, result, trace, isOrphaned);
-    budget.incrementCallCount();
-    return;
-  }
-
- // 预算超限：不重试（重试只会突破预算且无意义）
-  if (result.error !== undefined && budget.isExceeded()) {
-    finalizeCall(call, result, trace, isOrphaned);
-    budget.incrementCallCount();
-    return;
-  }
-
- // 可重试失败：退避后递归
-  if (result.error !== undefined && call.attempts < MAX_ATTEMPTS) {
-    await delay(backoffDelay(call.attempts));
- // 退避期间 signal 可能 abort
-    if (signal.aborted) {
-      finalizeCall(call, result, trace, isOrphaned);
-      budget.incrementCallCount();
-      return;
-    }
-    await executeAgentCall(call, runner, budget, signal, trace, onEvent, stream, isOrphaned);
-    return;
-  }
-
- // 终态（成功或达到重试上限的失败）
-  finalizeCall(call, result, trace, isOrphaned);
-  budget.incrementCallCount();
-}

package/src/orchestration/launcher.ts

@@ -1,410 +0,0 @@
-/**
- * Workflow Extension — launcher
- *
- * runAndWait free function（D-12）。跨扩展编程入口（pi.__workflowRun）——
- * 阻塞至 run 到达 done 终态。
- *
- * **D-8 签名**：返回 WorkflowRunResult（{status:"done", reason, ...}）——
- * status 恒为 "done"，具体原因由 reason 区分
- * （completed/failed/aborted/budget_limited/time_limited）。
- *
- * **C.7**：timeout → transition done,time_limited（仅返回 timeout 标记但不转终态
- * 会让 workflow 仍 running，资源泄漏）。
- *
- * 流程：
- * 1. registry.get(name) → WorkflowScript（未找到返回 failed）
- * 2. script.validate（lint 检查）→ 失败抛错（不进 runWorkflow）
- * 3. script.toExecutable → 可执行源
- * 4. 构建 RunSpec + runWorkflow(spec, deps, signal)
- * 5. 轮询至 done（间隔 STATUS_POLL_INTERVAL_MS）
- * 6. timeout → abortRun + transition done,time_limited
- * 7. signal.aborted → abortRun + reason=aborted
- *
- * 层归属：Engine。依赖 registry + runWorkflow/abortRun + LifecycleDeps。
- *
- * 参考：domain-models.md §D-8（WorkflowRunResult 签名）、clarification.md C.7。
- */
-
-import { ArgsValidationError } from "./args-validator.ts";
-import { abortRun, runWorkflow } from "./lifecycle.ts";
-import type { LifecycleDeps } from "./models/ports.ts";
-import type { RunSpec } from "./models/run-spec.ts";
-import type { DoneReason } from "./models/types.ts";
-import type { WorkflowRun } from "./models/workflow-run.ts";
-import type { WorkflowScriptRegistry } from "./models/workflow-script-registry.ts";
-
-// ── 常量 ─────────────────────────────────────────────────────
-
-/** 默认 runAndWait 超时（10 分钟）。 */
-const DEFAULT_RUNANDWAIT_TIMEOUT_MS = 600_000;
-
-/** 轮询间隔（500ms）。 */
-const STATUS_POLL_INTERVAL_MS = 500;
-
-// ── 类型 ─────────────────────────────────────────────────────
-
-/**
- * runAndWait 的返回（D-8 签名）。
- *
- * status 恒为 "done"（runAndWait 阻塞至 done 才返回）；具体原因由 reason 区分
- * （completed/failed/aborted/budget_limited/time_limited）。
- */
-export interface WorkflowRunResult {
- /** 恒为 "done"（runAndWait 阻塞至 done）。 */
-  status: "done";
- /** 终态原因（completed/failed/aborted/budget_limited/time_limited）。 */
-  reason: DoneReason;
- /** 脚本返回值（reason==="completed" 时有）。 */
-  scriptResult?: unknown;
- /** 错误信息（reason!=="completed" 时可有）。 */
-  error?: string;
- /** run 标识。 */
-  runId: string;
-}
-
-/**
- * Launcher 依赖：LifecycleDeps + registry（脚本发现）。
- *
- * registry 是「发现依赖」（文件系统扫描），与 LifecycleDeps 的 3 个 port
- * （执行依赖：子进程/线程/持久化）性质不同——故单独扩展，不进 LifecycleDeps。
- */
-export interface LauncherDeps extends LifecycleDeps {
- /** workflow 脚本仓库。 */
-  registry: WorkflowScriptRegistry;
-}
-
-// ── 内部 helper ──────────────────────────────────────────────
-
-/** 轮询间隔 Promise。 */
-function pollInterval(): Promise<void> {
-  // IF10(#16)：unref 使轮询等待 tick 不钉住事件循环（对齐 subagent-service
-  // gcTimer.unref?.() 先例的防御 duck-type 写法）。resolve 语义不变——unref
-  // 只影响进程退出判定，已注册 timer 仍按 500ms 触发。
-  return new Promise((resolve) => {
-    const timer = setTimeout(resolve, STATUS_POLL_INTERVAL_MS);
-    timer.unref?.();
-  });
-}
-
-/**
- * 从 WorkflowRun 构建 WorkflowRunResult（D-8）。
- *
- * reason 取 run.state.reason（done 时必有，WorkflowRun 不变式 I2 保证），
- * 防御性 fallback "failed"（理论不可达——I2 保证 done 时 reason 已设）。
- */
-function toResult(run: WorkflowRun): WorkflowRunResult {
-  return {
-    status: "done",
-    reason: run.state.reason ?? "failed",
-    scriptResult: run.state.scriptResult,
-    error: run.state.error,
-    runId: run.runId,
-  };
-}
-
-// ── pollRunToResult（runAndWait + executeNestedWorkflow 共用轮询） ────
-
-/**
- * 轮询 run 至 done 终态并返回 WorkflowRunResult。
- *
- * runAndWait 与 executeNestedWorkflow 共用的轮询逻辑（D-12 后去重）：
- * - signal.aborted → 先查 run 是否已 done（避免二次 safeAbort 写不同 error 造成
- *   非确定性），否则 safeAbort(aborted) + 返回 aborted 结果
- * - run 丢失 → failed 结果
- * - run done → toResult
- * - deadline 到 → 先查 done，否则 safeAbort(time_limited) + 返回 timeout 结果
- *
- * @param abortReason signal abort 时写入 run.state.error 的原因串。runAndWait 传
- * "Aborted by signal"；executeNestedWorkflow 传 "Aborted by parent signal"。
- */
-async function pollRunToResult(
-  runId: string,
-  deps: LauncherDeps,
-  signal: AbortSignal | undefined,
-  timeoutMs: number,
-  abortReason: string,
-): Promise<WorkflowRunResult> {
-  const deadline = Date.now() + timeoutMs;
-  while (Date.now() < deadline) {
-    if (signal?.aborted) {
-      const runBeforeAbort = deps.runs.get(runId);
-      if (runBeforeAbort?.state.status === "done") return toResult(runBeforeAbort);
-      await safeAbort(runId, deps, abortReason, "aborted");
-      const run = deps.runs.get(runId);
-      return run
-        ? toResult(run)
-        : { status: "done", reason: "aborted", error: abortReason, runId };
-    }
-    const run = deps.runs.get(runId);
-    if (!run) return { status: "done", reason: "failed", error: "Run not found", runId };
-    if (run.state.status === "done") return toResult(run);
-    await pollInterval();
-  }
-  const runBeforeTimeout = deps.runs.get(runId);
-  if (runBeforeTimeout?.state.status === "done") return toResult(runBeforeTimeout);
-  await safeAbort(runId, deps, `Workflow timed out after ${timeoutMs}ms`, "time_limited");
-  const finalRun = deps.runs.get(runId);
-  return finalRun
-    ? toResult(finalRun)
-    : {
-        status: "done",
-        reason: "time_limited",
-        error: `Workflow timed out after ${timeoutMs}ms`,
-        runId,
-      };
-}
-
-// ── runAndWait ───────────────────────────────────────────────
-
-/**
- * 同步运行 workflow 至终态（跨扩展编程入口）。
- *
- * 阻塞至 run 到达 done，返回 WorkflowRunResult。用于 pi.__workflowRun 等
- * 编程式调用——非交互场景（交互用 run + lifecycle tools）。
- *
- * **超时处理（C.7）**：timeout → abortRun + 返回 reason=time_limited。
- * 旧代码返回 status:"timeout" 但 workflow 可能仍 running（资源泄漏）；
- * 本实现确保 timeout 转 done,time_limited 终态。
- *
- * **signal abort**：signal.aborted → abortRun + 返回 reason=aborted。
- *
- * **脚本未找到**：返回 reason=failed（不抛错——编程调用方据 reason 判断）。
- *
- * @param name workflow 脚本名（registry.get 查找）
- * @param args 调用参数（worker 内 $ARGS 访问）
- * @param deps LauncherDeps（LifecycleDeps + registry）
- * @param signal 外部 abort signal（可选）
- * @param timeoutMs 超时上限（默认 10 分钟）
- * @returns WorkflowRunResult（status 恒 "done"）
- */
-export async function runAndWait(
-  name: string,
-  args: Record<string, unknown>,
-  deps: LauncherDeps,
-  signal?: AbortSignal,
-  timeoutMs: number = DEFAULT_RUNANDWAIT_TIMEOUT_MS,
-): Promise<WorkflowRunResult> {
- // 1. registry 查找脚本（workflowRef = 绝对路径，S2 路径统一）
-  const script = await deps.registry.getPath(name);
-  if (!script) {
-    return {
-      status: "done",
-      reason: "failed",
-      error: `Workflow '${name}' not found`,
-      runId: "",
-    };
-  }
-
- // 2. lint 校验（失败抛错——脚本本身有问题，不应静默吞）
-  const lintResult = script.validate();
-  if (!lintResult.valid) {
-    const errors = lintResult.findings
-      .filter((f) => f.severity === "error")
-      .map((f) => `L${f.line}: ${f.message}`)
-      .join("; ");
-    throw new Error(`Workflow script '${name}' has lint errors: ${errors}`);
-  }
-
- // 3. 构建 RunSpec
- // 不设 budgetTimeMs：runAndWait 自身用轮询 deadline（pollRunToResult 内 while + safeAbort）
- // 实施 timeout，并产出「Workflow timed out after Xms」的具体错误信息。spec 级
- // 时间预算（lifecycle.scheduleTimeBudget）服务于 fire-and-forget 的交互式 run
- // （tool-workflow actionRun），若在此也设会与轮询 deadline 同时触发产生竞态。
-  const spec: RunSpec = {
-    scriptSource: script.toExecutable(),
-    args,
-    budgetTokens: undefined,
-    scriptName: script.name,
-    scriptPath: script.path,
-    description: script.meta.description,
-    parameters: script.meta.parameters,
-  };
-
- // 4. 启动 workflow + 5. 轮询至 done（含 6. timeout → abortRun，C.7）
- // pending-notification 的 register/unregister 由 runWorkflow（启动注册）+
- // transition("done") 路径（完成注销）统一处理，runAndWait 不再重复 emit。
- // m3：chokepoint 校验失败（ArgsValidationError）→ 返回 invalid_args 结果（run 从未
- // 创建，runId 恒 ''），非 ArgsValidationError 保持传播。
-  let runId: string;
-  try {
-    runId = await runWorkflow(spec, deps, signal);
-  } catch (err) {
-    if (err instanceof ArgsValidationError) {
-      // 注：WorkflowRunResult.reason 是 pi.__workflowRun 的跨扩展公开类型——新增
-      // 'invalid_args' 成员是对外部消费方的契约变更（m3 exec-review m5）；该 reason
-      // 永不进 run.state.reason（run 从未创建），仅存在于本合成返回值。
-      return {
-        status: "done",
-        reason: "invalid_args",
-        runId: "",
-        error: err.message,
-      };
-    }
-    throw err;
-  }
-  return pollRunToResult(runId, deps, signal, timeoutMs, "Aborted by signal");
-}
-
-/**
- * 安全 abort——run 可能已终态（abortRun 对 done no-op，但防御兜底）。
- */
-async function safeAbort(
-  runId: string,
-  deps: LauncherDeps,
-  reason: string,
-  doneReason: DoneReason,
-): Promise<void> {
-  try {
-    await abortRun(runId, deps, reason, doneReason);
-  } catch (err) {
- // run 可能已终态或不存在——忽略，调用方据 toResult 判断
-    void err;
-  }
-}
-
-// ── executeNestedWorkflow（workflow() 嵌套调用实现） ────────
-
-/**
- * workflow() 嵌套调用的 Engine 实现。
- *
- * Worker 脚本内调 workflow(name, args) 时，error-recovery.dispatchWorkflowCall 路由
- * 到 deps.onWorkflowCall，后者（Interface 层 makeDeps 注入）委托本函数。
- *
- * 流程（6 步）：
- * 1. 循环检测——name 已在 parentWorkflowChain 中则拒绝（防 A→B→A 死循环）
- * 2. signal 继承——子 run 响应父 run abort（parentController → childController）
- * 3. registry.get + lint——失败返回 error result（不抛错，让脚本 soft-fail）
- * 4. 构建 RunSpec（共享父 Budget 引用 + parentWorkflowChain 延长）+ runWorkflow
- * 5. pollRunToResult 轮询至 done（复用 runAndWait 的轮询逻辑）
- * 6. 结果转换（budget 已通过共享引用实时同步）
- *
- * 不走 runAndWait：runAndWait 内部构建 RunSpec 不支持 parentWorkflowChain 与 budget
- * 共享引用，故直接构建 spec + runWorkflow + pollRunToResult。
- *
- * @param name 子 workflow 脚本名（registry.get 查找）
- * @param args 调用参数（子 worker 内 $ARGS 访问）
- * @param parentRun 发起嵌套调用的父 WorkflowRun（budget 共享 + 循环链源）
- * @param deps LauncherDeps（与 runAndWait 同一组依赖 + registry）
- * @returns { content, parsedOutput?, error? }——dispatchWorkflowCall 原样 postMessage 回 worker
- */
-export async function executeNestedWorkflow(
-  name: string,
-  args: Record<string, unknown>,
-  parentRun: WorkflowRun,
-  deps: LauncherDeps,
-): Promise<{ content: string; parsedOutput?: unknown; error?: string }> {
- // Step 1: 循环检测——parentWorkflowChain 不存在时为 []（顶层 run）
-  const chain = [
-    ...(parentRun.spec.parentWorkflowChain ?? []),
-    parentRun.spec.scriptName,
-  ];
-  if (chain.includes(name)) {
-    return {
-      content: "",
-      error: `Circular workflow call detected: ${[...chain, name].join(" → ")}`,
-    };
-  }
-
- // Step 2: signal 继承——子 run 响应父 run abort
- // [L-2] 提取命名 onParentAbort 以便 finally removeEventListener，防子 run 完成后
- //  parentSignal 上残留 listener（多次嵌套调用会累积）。
-  const childController = new AbortController();
-  const parentSignal = parentRun.runtime?.controller.signal;
-  const onParentAbort = (): void => childController.abort();
-  if (parentSignal) {
-    if (parentSignal.aborted) {
-      childController.abort();
-    } else {
-      parentSignal.addEventListener("abort", onParentAbort, { once: true });
-    }
-  }
-
- // Step 3+：registry 查找 + lint + RunSpec + runWorkflow + poll 全程 try（m3 E8——
- // try 起点提到 Step 2 的 listener 注册之后，覆盖 Step 3-6。runWorkflow throw
- // （含 chokepoint ArgsValidationError）与 not found/lint 早返回均走 finally 移除
- // parentSignal listener——修复原 try 外 runWorkflow 的泄漏路径）。
-  try {
-    // Step 3: registry 查找 + lint（失败返回 error result，不抛错）
-    const script = await deps.registry.getPath(name);
-    if (!script) {
-      return { content: "", error: `Workflow '${name}' not found` };
-    }
-    const lintResult = script.validate();
-    if (!lintResult.valid) {
-      const errors = lintResult.findings
-        .filter((f) => f.severity === "error")
-        .map((f) => `L${f.line}: ${f.message}`)
-        .join("; ");
-      return {
-        content: "",
-        error: `Workflow script '${name}' has lint errors: ${errors}`,
-      };
-    }
-
-    // Step 4: 构建 RunSpec（共享父 Budget + 循环链）+ 启动子 workflow
-    // budget 共享（F-7 方案 B）：子 run 直接复用父 Budget 引用（budgetRef），consume 实时
-    // 累加到父 Budget，消除并行嵌套下的超支窗口，无需 Step 6 的 sync-back。
-    const spec: RunSpec = {
-      scriptSource: script.toExecutable(),
-      args,
-      budgetRef: parentRun.state.budget,
-      // Run-level override 传播（与父 run 对齐）：子 run 继承父 run 的 model/thinkingLevel，
-      // 否则嵌套 workflow 丢失父 run 的模型指定，回落主 agent 模型。
-      model: parentRun.spec.model,
-      thinkingLevel: parentRun.spec.thinkingLevel,
-      scriptName: script.name,
-      scriptPath: script.path,
-      description: script.meta.description,
-      parameters: script.meta.parameters,
-      parentWorkflowChain: chain,
-    };
-    const runId = await runWorkflow(spec, deps, childController.signal);
-
-    // Step 5: 轮询至 done（复用 runAndWait 的轮询逻辑）
-    // [H-1] 嵌套 workflow timeout 从父 run 继承：父 spec.budgetTimeMs 存在时取
-    //  min(父 budget, DEFAULT)，让子 run 不超出父 run 的剩余时间预算；否则用 DEFAULT。
-    //  budgetRef（共享 Budget）已在 Step 4 透传给子 run 处理 token/cost 预算，
-    //  此处的 budgetTimeMs 只服务 pollRunToResult 的轮询 deadline（wall-clock 兜底）。
-    const nestedTimeoutMs = parentRun.spec.budgetTimeMs
-      ? Math.min(parentRun.spec.budgetTimeMs, DEFAULT_RUNANDWAIT_TIMEOUT_MS)
-      : DEFAULT_RUNANDWAIT_TIMEOUT_MS;
-
-    const result = await pollRunToResult(
-      runId,
-      deps,
-      childController.signal,
-      nestedTimeoutMs,
-      "Aborted by parent signal",
-    );
-
-    // Step 6: 结果转换（budget 已通过共享 budgetRef 实时同步，无需 sync-back）
-    if (result.reason === "completed") {
-      const scriptResult = result.scriptResult;
-      return {
-        content:
-          typeof scriptResult === "string"
-            ? scriptResult
-            : JSON.stringify(scriptResult ?? ""),
-        parsedOutput:
-          typeof scriptResult === "object" && scriptResult !== null
-            ? scriptResult
-            : undefined,
-      };
-    }
-    return {
-      content: "",
-      error: result.error ?? `Workflow '${name}' ended: ${result.reason}`,
-    };
-  } catch (err) {
-    // m3：chokepoint 校验失败 → {error}（§5.3 指引文案），非 ArgsValidationError 保持传播
-    // （dispatchWorkflowCall 的 .catch 兜底转 postResult，worker 不崩）。
-    if (err instanceof ArgsValidationError) {
-      return { content: "", error: err.message };
-    }
-    throw err;
-  } finally {
-    // [L-2] 子 run done 后移除 parentSignal listener，避免累积（{ once: true } 在
-    //  正常完成路径下不会自动触发，listener 残留；多次嵌套调用会泄漏到 parentSignal）。
-    parentSignal?.removeEventListener("abort", onParentAbort);
-  }
-}