@duckmind/dm-windows-x64 0.61.5 → 0.62.1

package/extensions/dm-subagents/src/runs/background/run-status.js

@@ -1,24 +1,112 @@
 import * as fs from "node:fs";
 import * as path from "node:path";
-import { formatAsyncRunList, formatAsyncRunOutputPath, formatAsyncRunProgressLabel, listAsyncRuns } from "./async-status.js";
+import { safeTerminalText } from "../../shared/display-text.js";
+import { formatAsyncRunList, formatAsyncRunOutputPath, formatAsyncRunProgressLabel, formatWorkflowStageLine, listAsyncRuns } from "./async-status.js";
 import { formatAsyncResultTranscript, formatAsyncRunTranscript, formatNestedRunTranscript, inspectSubagentFleet } from "./fleet-view.js";
 import { formatNestedRunStatusLines } from "../shared/nested-render.js";
 import { formatModelThinking } from "../../shared/formatters.js";
 import { formatActivityLabel } from "../../shared/status-format.js";
-import { ASYNC_DIR, RESULTS_DIR } from "../../shared/types.js";
+import { DIRS } from "../../shared/types.js";
+import { inspectActiveAsyncCapacityOwner } from "./active-async-capacity.js";
+import { readStatus } from "../../shared/utils.js";
 import { resolveSubagentIntercomTarget } from "../../intercom/intercom-bridge.js";
+import { normalizeExternalCliRunnerStatus } from "../shared/external-cli-contract.js";
+import { resolveSubagentResultStatus } from "../../intercom/result-intercom.js";
+import { readProcessTerminal, sanitizeProcessTerminal } from "./process-terminal.js";
+import { formatWaitSubscriptions } from "./wait-subscriptions.js";
 import { resolveAsyncRunLocation } from "./async-resume.js";
 import { resolveSubagentRunId } from "./run-id-resolver.js";
 import { flatToLogicalStepIndex, normalizeParallelGroups } from "./parallel-groups.js";
 import { reconcileAsyncRun, reconcileNestedAsyncDescendants } from "./stale-run-reconciler.js";
 import { attachRootChildrenToSteps, findNestedRouteForRootId, projectNestedRegistryForRoot } from "../shared/nested-events.js";
+import { readMissionBinding } from "../../missions/lifecycle.js";
+import { formatWorkflowJsonPreview } from "../../workflows/scripted-workflow.js";
+import { parseWorkflowChildSummary } from "../../workflows/workflow-child-summary.js";
+import { formatWorkflowPreflightPlanSummary, formatWorkflowPreflightWarningSummary } from "../../workflows/workflow-preflight.js";
+import { formatRunFanoutBudget, getRunFanoutBudgetSnapshot, readRunFanoutBudgetDescriptor } from "../shared/run-fanout-budget.js";
+import { workflowGraphStageNodes } from "../shared/workflow-graph.js";
+import { getExternalJobProvider } from "../../api/external-job-provider.js";
+import { formatTimeoutRecoveryLines } from "../shared/mutation-evidence.js";
+function formatProcessTerminal(value) {
+  if (!value)
+    return "missing";
+  return `${value.state}${value.reason ? ` (${value.reason})` : ""}${value.runnerProcessInstanceId ? ` · runner ${value.runnerProcessInstanceId}` : ""}`;
+}
+function debugProcessTerminal(asyncDir, status) {
+  const expected = { runId: status.runId, runnerProcessInstanceId: status.processTerminal?.runnerProcessInstanceId };
+  return {
+    sidecar: readProcessTerminal(asyncDir, expected),
+    overlay: sanitizeProcessTerminal(status.processTerminal, expected, path.join(asyncDir, "status.json"))
+  };
+}
+function formatCapacityOwner(inspect) {
+  if (!inspect.owner)
+    return [`Active capacity: ${inspect.release.state} — ${inspect.release.reason}`];
+  const owner = inspect.owner;
+  return [
+    `Active capacity: ${inspect.release.state} — ${inspect.release.reason}`,
+    `Capacity owner: ${inspect.relation} slot ${owner.slot}, ${owner.kind}, generation ${owner.generation}`,
+    `Capacity session: ${owner.ownerSessionId}`,
+    owner.sourceRunId ? `Capacity source run: ${owner.sourceRunId}` : undefined,
+    `Capacity async dir: ${owner.asyncDir}`,
+    owner.runnerProcessInstanceId ? `Capacity runner: ${owner.runnerProcessInstanceId}` : undefined,
+    owner.runnerStartedAt !== undefined ? `Capacity runner started: ${new Date(owner.runnerStartedAt).toISOString()}` : undefined
+  ].filter((line) => line !== undefined);
+}
+function formatWorkflowDebug(status) {
+  if (status.mode !== "workflow" && !status.parentWorkflowRunId && !status.workflowKey && !status.lane)
+    return [];
+  const lines = [
+    status.parentWorkflowRunId ? `Workflow parent: ${status.parentWorkflowRunId}${status.workflowKey ? ` (${status.workflowKey})` : ""}` : undefined,
+    status.mode === "workflow" ? `Workflow children: ${(status.steps ?? []).length}` : undefined,
+    status.lane ? `Lane: ${status.lane.key}${status.lane.mode ? ` (${status.lane.mode})` : ""}` : undefined
+  ].filter((line) => line !== undefined);
+  for (const [index, step] of (status.steps ?? []).entries()) {
+    lines.push(`  ${index + 1}. key ${step.workflowKey ?? "n/a"} · ${runStatusStepDisplayName(step)} · ${step.status} · async ${step.async === undefined ? "unknown" : step.async ? "yes" : "no"}${step.runId ? ` · run ${step.runId}` : ""}${step.lane ? ` · lane ${step.lane.key}` : ""}${step.worktreePath ? ` · worktree ${step.worktreePath} · branch ${step.branch ?? "unknown"}` : ""}`);
+  }
+  return lines;
+}
+function formatRunLifecycleDebug(input) {
+  const { status, asyncDir, sidecarProcessTerminal, overlayProcessTerminal, capacity } = input;
+  const lines = [
+    "Run lifecycle debug",
+    `Run: ${status.runId}`,
+    `Dir: ${asyncDir}`,
+    `Status file: ${path.join(asyncDir, "status.json")}`,
+    `Process terminal file: ${path.join(asyncDir, "process-terminal.json")}`,
+    `Session: ${status.sessionId ?? "unknown"}`,
+    `State: ${status.state}`,
+    `Mode: ${status.mode}`,
+    status.parentWorkflowRunId ? `Workflow parent: ${status.parentWorkflowRunId}` : undefined,
+    status.workflowKey ? `Workflow key: ${status.workflowKey}` : undefined,
+    status.lane ? `Lane: ${status.lane.key}${status.lane.mode ? ` (${status.lane.mode})` : ""}` : undefined,
+    `Status process terminal: ${formatProcessTerminal(overlayProcessTerminal)}`,
+    `Sidecar process terminal: ${formatProcessTerminal(sidecarProcessTerminal)}`,
+    ...formatCapacityOwner(capacity),
+    ...formatWorkflowDebug(status)
+  ].filter((line) => line !== undefined);
+  return lines.join(`
+`);
+}
 function hasExistingSessionFile(value) {
   return typeof value === "string" && fs.existsSync(value);
 }
-function formatResumeGuidance(runId, children, fallbackSessionFile) {
+function formatResumeGuidance(runId, children, fallbackSessionFile, options = {}) {
+  if (options.stopped)
+    return "Resume: unavailable; stopped runs are not resumable. Start a new run instead.";
   const knownChildren = children.map((child, index) => ({ child, index })).filter(({ child }) => typeof child.agent === "string");
   if (!runId || knownChildren.length === 0)
     return "Resume: unavailable; no child session file was persisted.";
+  const workflowChildren = knownChildren.filter(({ child }) => typeof child.runId === "string" && child.runId.trim() && hasExistingSessionFile(child.sessionFile));
+  const supervisorDetachedWorkflowChildren = workflowChildren.filter(({ child }) => child.status === "paused" && child.activityState === "needs_attention");
+  const resumableWorkflowChildren = workflowChildren.filter(({ child }) => !(child.status === "paused" && child.activityState === "needs_attention"));
+  if (workflowChildren.length > 0) {
+    return [
+      ...supervisorDetachedWorkflowChildren.map(({ child }) => `Recovery workflow child${typeof child.workflowKey === "string" && child.workflowKey.trim() ? ` '${child.workflowKey}'` : ""}: reply to the supervisor request first, then wait with bg_wait({ id: "${child.runId}" }). Use subagent({ action: "status", id: "${child.runId}" }) to recover the result; do not resume or launch a replacement while it remains detached.`),
+      ...resumableWorkflowChildren.map(({ child }) => `Revive workflow child${typeof child.workflowKey === "string" && child.workflowKey.trim() ? ` '${child.workflowKey}'` : ""}: subagent({ action: "resume", id: "${child.runId}", message: "..." })`)
+    ].join(`
+`);
+  }
   const singleSessionFile = knownChildren[0]?.child.sessionFile ?? fallbackSessionFile;
   if (children.length === 1 && knownChildren.length === 1 && hasExistingSessionFile(singleSessionFile)) {
     return `Revive: subagent({ action: "resume", id: "${runId}", message: "..." })`;
@@ -33,6 +121,8 @@ function stepLineLabel(status, index) {
   const steps = status.steps ?? [];
   if (status.mode === "parallel")
     return `Agent ${index + 1}/${steps.length || 1}`;
+  if (status.mode === "workflow")
+    return `Workflow child ${steps[index]?.workflowKey ?? index + 1}`;
   if (status.mode === "chain") {
     const chainStepCount = status.chainStepCount ?? (steps.length || 1);
     const groups = normalizeParallelGroups(status.parallelGroups, steps.length, chainStepCount);
@@ -43,7 +133,12 @@ function stepLineLabel(status, index) {
   }
   return `Step ${index + 1}`;
 }
+function runStatusStepDisplayName(step) {
+  return step.sessionName?.trim() || (step.label ? `${step.label} (${step.agent})` : step.agent);
+}
 function nestedRunDisplayName(run) {
+  if (run.sessionName?.trim())
+    return run.sessionName.trim();
   if (run.agent)
     return run.agent;
   if (run.agents?.length)
@@ -51,15 +146,21 @@ function nestedRunDisplayName(run) {
   return run.id;
 }
 function formatSteeringSummary(input) {
-  const parts = [];
-  if (input.steerCount !== undefined)
-    parts.push(`${input.steerCount} steer${input.steerCount === 1 ? "" : "s"}`);
-  if (typeof input.lastSteerAt === "number" && Number.isFinite(input.lastSteerAt))
-    parts.push(`last ${new Date(input.lastSteerAt).toISOString()}`);
-  return parts.length ? parts.join(", ") : undefined;
+  const steering = input.steering;
+  if (!steering || steering.requested === 0)
+    return;
+  const lateAcknowledgments = steering.recent.reduce((count, request) => count + request.targets.filter((target) => target.lateDeliveredAt !== undefined).length, 0);
+  return `${steering.requested} requested, ${steering.scheduled} scheduled, ${steering.pending} pending, ${steering.delivered} delivered, ${steering.failed} failed, ${steering.recovered} recovered${lateAcknowledgments ? `, ${lateAcknowledgments} late acknowledged` : ""}`;
+}
+function externalJobFollowUpSupported(provider) {
+  try {
+    return typeof getExternalJobProvider(provider)?.followUp === "function";
+  } catch {
+    return false;
+  }
 }
 function rememberedForegroundChildOutput(child) {
-  const outputPath = child.artifactPaths?.outputPath;
+  const outputPath = child.artifactPaths?.outputPath ?? child.savedOutputPath;
   if (outputPath && fs.existsSync(outputPath)) {
     try {
       const artifactOutput = fs.readFileSync(outputPath, "utf-8").trim();
@@ -80,9 +181,11 @@ function formatRememberedForegroundStatus(run) {
   for (const child of run.children) {
     const output = rememberedForegroundChildOutput(child).trim().split(/\r?\n/).find((line) => line.trim());
     const parts = [
-      `${child.index + 1}. ${child.agent} ${child.status}`,
+      `${child.index + 1}. ${child.sessionName?.trim() || child.agent} ${child.status}`,
       child.exitCode !== undefined ? `exit ${child.exitCode}` : undefined,
       child.detachedReason ? `detached: ${child.detachedReason}` : undefined,
+      child.acceptance ? `acceptance: ${child.acceptance.status}` : undefined,
+      child.error ? `error: ${child.error}` : undefined,
       output ? `output: ${output.slice(0, 160)}` : undefined
     ].filter(Boolean);
     lines.push(parts.join(", "));
@@ -92,6 +195,10 @@ function formatRememberedForegroundStatus(run) {
       lines.push(`  Transcript: ${child.transcriptPath}`);
     if (child.artifactPaths?.outputPath)
       lines.push(`  Output: ${child.artifactPaths.outputPath}`);
+    if (child.savedOutputPath && child.savedOutputPath !== child.artifactPaths?.outputPath)
+      lines.push(`  Saved output: ${child.savedOutputPath}`);
+    if (child.outputSaveError)
+      lines.push(`  Output warning: ${child.outputSaveError}`);
     if (child.transcriptError)
       lines.push(`  Transcript warning: ${child.transcriptError}`);
   }
@@ -100,11 +207,12 @@ function formatRememberedForegroundStatus(run) {
     lines.push(`Transcript: subagent({ action: "status", id: "${run.runId}", view: "transcript" })`);
   else
     lines.push(`Transcript: subagent({ action: "status", id: "${run.runId}", index: 0, view: "transcript" })`);
-  const resumable = run.children.find((child) => child.status !== "detached" && hasExistingSessionFile(child.sessionFile));
-  if (resumable) {
+  const detached = run.children.some((child) => child.status === "detached");
+  const resumable = run.children.find((child) => hasExistingSessionFile(child.sessionFile));
+  if (detached) {
+    lines.push(`Recovery: reply to the supervisor request first, then wait with bg_wait({ id: "${run.runId}" }); do not resume or launch a replacement while any child remains detached.`);
+  } else if (resumable) {
     lines.push(run.children.length === 1 ? `Revive: subagent({ action: "resume", id: "${run.runId}", message: "..." })` : `Revive child: subagent({ action: "resume", id: "${run.runId}", index: ${resumable.index}, message: "..." })`);
-  } else if (run.children.some((child) => child.status === "detached")) {
-    lines.push("Recovery: child detached for intercom coordination; status will show recovered output after the child exits when DM can observe it.");
   } else {
     lines.push("Resume: unavailable; no child session file was persisted.");
   }
@@ -127,10 +235,12 @@ function formatRememberedForegroundTranscript(run, options) {
   const lines = [
     `Run: ${run.runId}`,
     `State: ${child.status}`,
-    `Child: ${index} (${child.agent})`,
+    `Child: ${index} (${child.sessionName?.trim() || child.agent})`,
     child.sessionFile ? `Session: ${child.sessionFile}` : undefined,
     child.transcriptPath ? `Transcript: ${child.transcriptPath}` : undefined,
-    child.artifactPaths?.outputPath ? `Output: ${child.artifactPaths.outputPath}` : undefined
+    child.artifactPaths?.outputPath ? `Output: ${child.artifactPaths.outputPath}` : undefined,
+    child.savedOutputPath && child.savedOutputPath !== child.artifactPaths?.outputPath ? `Saved output: ${child.savedOutputPath}` : undefined,
+    child.outputSaveError ? `Output warning: ${child.outputSaveError}` : undefined
   ].filter((line) => Boolean(line));
   lines.push("Result transcript tail:");
   if (outputLines.length === 0)
@@ -138,7 +248,7 @@ function formatRememberedForegroundTranscript(run, options) {
   else
     for (const line of outputLines)
       lines.push(`  ${line}`);
-  return lines.join(`
+  return lines.map((line) => safeTerminalText(line)).join(`
 `);
 }
 function formatNestedExactStatus(rootRunId, run) {
@@ -164,7 +274,7 @@ function formatNestedExactStatus(rootRunId, run) {
     for (const [index, step] of run.steps.entries()) {
       const activity = step.status === "running" ? formatActivityLabel(step.lastActivityAt, step.activityState) : undefined;
       const budget = step.turnBudget ? `, turn budget: ${step.turnBudget.turnCount}/${step.turnBudget.maxTurns}+${step.turnBudget.graceTurns} (${step.turnBudget.outcome})` : "";
-      lines.push(`  ${index + 1}. ${step.agent} ${step.status}${activity ? `, ${activity}` : ""}${budget}${step.error ? `, error: ${step.error}` : ""}`);
+      lines.push(`  ${index + 1}. ${step.sessionName?.trim() || step.agent} ${step.status}${activity ? `, ${activity}` : ""}${budget}${step.error ? `, error: ${step.error}` : ""}`);
       lines.push(...formatNestedRunStatusLines(step.children, { indent: "    ", commandHints: true }));
     }
   }
@@ -174,8 +284,8 @@ function formatNestedExactStatus(rootRunId, run) {
 `);
 }
 export function inspectSubagentStatus(params, deps = {}) {
-  const asyncDirRoot = deps.asyncDirRoot ?? ASYNC_DIR;
-  const resultsDir = deps.resultsDir ?? RESULTS_DIR;
+  const asyncDirRoot = deps.asyncDirRoot ?? DIRS.async;
+  const resultsDir = deps.resultsDir ?? DIRS.results;
   const currentSessionId = deps.state?.currentSessionId ?? undefined;
   if (params.view && params.view !== "fleet" && params.view !== "transcript") {
     return {
@@ -206,8 +316,11 @@ export function inspectSubagentStatus(params, deps = {}) {
           details: { mode: "single", results: [] }
         };
       }
+      const waitSubscriptions = deps.state ? formatWaitSubscriptions(deps.state, deps.now?.() ?? Date.now()) : undefined;
       return {
-        content: [{ type: "text", text: formatAsyncRunList(runs) }],
+        content: [{ type: "text", text: [formatAsyncRunList(runs), waitSubscriptions].filter(Boolean).join(`
+
+`) }],
         details: { mode: "single", results: [] }
       };
     } catch (error) {
@@ -222,7 +335,9 @@ export function inspectSubagentStatus(params, deps = {}) {
   let location;
   try {
     const requestedId = params.id ?? params.runId;
-    if (!params.dir && requestedId) {
+    if (params.action === "debug.run") {
+      location = resolveAsyncRunLocation(params, asyncDirRoot, resultsDir);
+    } else if (!params.dir && requestedId) {
       const resolved = resolveSubagentRunId(requestedId, { asyncDirRoot, resultsDir, state: deps.state, nested: deps.nested });
       if (resolved?.kind === "foreground") {
         const run = deps.state?.foregroundRuns?.get(resolved.id);
@@ -276,6 +391,7 @@ export function inspectSubagentStatus(params, deps = {}) {
     };
   }
   if (asyncDir) {
+    const diskStatus = readStatus(asyncDir);
     let reconciliation;
     try {
       reconciliation = reconcileAsyncRun(asyncDir, { resultsDir, kill: deps.kill, now: deps.now });
@@ -288,10 +404,45 @@ export function inspectSubagentStatus(params, deps = {}) {
       };
     }
     const status = reconciliation.status;
+    if (!status && diskStatus?.displayDismissedAt !== undefined) {
+      if (params.action === "debug.run") {
+        const { sidecar, overlay } = debugProcessTerminal(asyncDir, diskStatus);
+        const capacity = inspectActiveAsyncCapacityOwner({ runId: diskStatus.runId, sessionId: diskStatus.sessionId, asyncDir }, { rootDir: deps.activeCapacityRoot, liveWorkflowRunIds: new Set(deps.state?.workflowControllers?.keys() ?? []), abandonedSlotReleaseAfterMs: deps.abandonedSlotReleaseAfterMs });
+        return {
+          content: [{ type: "text", text: formatRunLifecycleDebug({ status: diskStatus, asyncDir, sidecarProcessTerminal: sidecar, overlayProcessTerminal: overlay, capacity }) }],
+          details: { mode: "single", results: [], ...sidecar ?? overlay ? { lifecycleStatus: { processTerminal: sidecar ?? overlay } } : {} }
+        };
+      }
+      if (params.view === "transcript") {
+        if (currentSessionId && diskStatus.sessionId !== currentSessionId) {
+          return {
+            content: [{ type: "text", text: "Transcript view is only available for async runs owned by the current session." }],
+            isError: true,
+            details: { mode: "single", results: [] }
+          };
+        }
+        return { content: [{ type: "text", text: formatAsyncRunTranscript(diskStatus, asyncDir, { index: params.index, lines: params.lines, sessionRoots: deps.sessionRoots }) }], details: { mode: "single", results: [] } };
+      }
+      return {
+        content: [{ type: "text", text: `Run: ${diskStatus.runId}
+State: display-dismissed
+Dismissed: ${new Date(diskStatus.displayDismissedAt).toISOString()}
+No running work was terminated.` }],
+        details: { mode: "single", results: [] }
+      };
+    }
     const effectiveRunId = status?.runId ?? resolvedId ?? "unknown";
     const logPath = path.join(asyncDir, `subagent-log-${effectiveRunId}.md`);
     const eventsPath = path.join(asyncDir, "events.jsonl");
     if (status) {
+      if (params.action === "debug.run") {
+        const { sidecar, overlay } = debugProcessTerminal(asyncDir, status);
+        const capacity = inspectActiveAsyncCapacityOwner({ runId: status.runId, sessionId: status.sessionId, asyncDir }, { rootDir: deps.activeCapacityRoot, liveWorkflowRunIds: new Set(deps.state?.workflowControllers?.keys() ?? []), abandonedSlotReleaseAfterMs: deps.abandonedSlotReleaseAfterMs });
+        return {
+          content: [{ type: "text", text: formatRunLifecycleDebug({ status, asyncDir, sidecarProcessTerminal: sidecar, overlayProcessTerminal: overlay, capacity }) }],
+          details: { mode: "single", results: [], ...sidecar ?? overlay ? { lifecycleStatus: { processTerminal: sidecar ?? overlay } } : {} }
+        };
+      }
       if (params.view === "transcript") {
         if (currentSessionId && status.sessionId !== currentSessionId) {
           return {
@@ -325,19 +476,43 @@ export function inspectSubagentStatus(params, deps = {}) {
         currentStep: status.currentStep,
         chainStepCount: status.chainStepCount,
         parallelGroups: status.parallelGroups,
+        workflowGraph: status.workflowGraph,
         steps: (status.steps ?? []).map((step, index) => ({ index, agent: step.agent, status: step.status }))
       });
       const started = new Date(status.startedAt).toISOString();
       const updated = status.lastUpdate ? new Date(status.lastUpdate).toISOString() : "n/a";
       const statusActivityText = status.state === "running" ? formatActivityLabel(status.lastActivityAt, status.activityState) : undefined;
       const steeringText = formatSteeringSummary(status);
+      const processTerminal = readProcessTerminal(asyncDir, { runId: status.runId, runnerProcessInstanceId: status.processTerminal?.runnerProcessInstanceId }) ?? sanitizeProcessTerminal(status.processTerminal, { runId: status.runId, runnerProcessInstanceId: status.processTerminal?.runnerProcessInstanceId }, path.join(asyncDir, "status.json"));
+      const runFanoutBudgetDescriptor = readRunFanoutBudgetDescriptor(asyncDir);
+      const runFanoutBudget = runFanoutBudgetDescriptor ? getRunFanoutBudgetSnapshot(runFanoutBudgetDescriptor) : status.runFanoutBudget;
+      let missionId;
+      try {
+        missionId = readMissionBinding(asyncDir)?.missionId;
+      } catch (error) {
+        nestedWarning = `${nestedWarning ? `${nestedWarning}; ` : ""}Mission binding unavailable: ${error instanceof Error ? error.message : String(error)}`;
+      }
+      const workflowReturnPreview = status.workflow?.value !== undefined ? formatWorkflowJsonPreview(status.workflow.value, 240) : undefined;
+      const workflowEmitPreview = status.workflow?.emits.length ? formatWorkflowJsonPreview(status.workflow.emits.at(-1), 240) : undefined;
       const lines = [
         `Run: ${status.runId}`,
+        status.toolCallId ? `Tool call: ${status.toolCallId}` : undefined,
+        missionId ? `Mission: ${missionId}` : undefined,
         `State: ${status.state}`,
+        processTerminal ? `Process terminal: ${processTerminal.state}${processTerminal.reason ? ` (${processTerminal.reason})` : ""}` : undefined,
+        status.capabilityCeiling ? `Capability ceiling: ${status.capabilityCeiling.allowedTools === undefined ? "names unrestricted" : status.capabilityCeiling.allowedTools.length === 0 ? "none" : status.capabilityCeiling.allowedTools.join(", ")}
+Extensions denied: ${status.capabilityCeiling.denyExtensions ? "yes" : "no"} (sources: ${status.capabilityCeiling.sources.join(", ")})` : undefined,
+        status.capabilityAudit ? `Capability audit: ${status.capabilityAudit.removedTools.length} tools removed, ${status.capabilityAudit.removedExtensionCount} extension entries removed` : undefined,
         status.error ? `Error: ${status.error}` : undefined,
         statusActivityText ? `Activity: ${statusActivityText}` : undefined,
         steeringText ? `Steering: ${steeringText}` : undefined,
         `Mode: ${status.mode}`,
+        ...status.preflight ? [formatWorkflowPreflightPlanSummary(status.preflight)] : [],
+        ...status.workflow?.preflightWarnings?.length ? [formatWorkflowPreflightWarningSummary(status.workflow.preflightWarnings)] : [],
+        runFanoutBudget ? formatRunFanoutBudget(runFanoutBudget) : undefined,
+        status.parentWorkflowRunId ? `Workflow parent: ${status.parentWorkflowRunId}${status.workflowKey ? ` (${status.workflowKey})` : ""}` : undefined,
+        status.mode === "workflow" && workflowReturnPreview !== undefined ? `Return: ${workflowReturnPreview}` : undefined,
+        status.mode === "workflow" && workflowEmitPreview !== undefined ? `Latest emit: ${workflowEmitPreview}` : undefined,
         `Progress: ${progressLabel}`,
         status.pendingAppends ? `Pending appends: ${status.pendingAppends}` : undefined,
         `Started: ${started}`,
@@ -345,9 +520,12 @@ export function inspectSubagentStatus(params, deps = {}) {
         status.turnBudget ? `Turn budget: ${status.turnBudget.turnCount}/${status.turnBudget.maxTurns}+${status.turnBudget.graceTurns} (${status.turnBudget.outcome})` : undefined,
         `Dir: ${asyncDir}`,
         outputPath ? `Output: ${outputPath}` : undefined,
+        status.parallelHandoff ? `Parallel handoff: ${status.parallelHandoff.path}` : undefined,
         reconciliation.message ? `Diagnosis: ${reconciliation.message}` : undefined,
         reconciliation.resultPath && fs.existsSync(reconciliation.resultPath) ? `Result: ${reconciliation.resultPath}` : undefined
       ].filter((line) => Boolean(line));
+      const liveWorkflowControls = status.mode === "workflow" && deps.state?.currentSessionId === status.sessionId && deps.state?.workflowControllers?.has(status.runId) ? [...deps.state?.foregroundControls.values() ?? []].filter((control) => control.parentWorkflowRunId === status.runId && control.sessionId === status.sessionId && Boolean(control.workflowSteeringDir && fs.existsSync(control.workflowSteeringDir)) && (control.activeChildren?.size ?? 0) > 0) : [];
+      let hasExternalJobFollowUpHint = false;
       for (const [index, step] of (status.steps ?? []).entries()) {
         const stepActivityText = step.status === "running" ? formatActivityLabel(step.lastActivityAt, step.activityState) : undefined;
         const modelThinking = formatModelThinking(step.model, step.thinking);
@@ -357,39 +535,114 @@ export function inspectSubagentStatus(params, deps = {}) {
         const errorText = step.error ? `, error: ${step.error}` : "";
         const acceptanceText = step.acceptance?.status ? `, acceptance: ${step.acceptance.status}` : "";
         const budgetText = step.turnBudget ? `, turn budget: ${step.turnBudget.turnCount}/${step.turnBudget.maxTurns}+${step.turnBudget.graceTurns} (${step.turnBudget.outcome})` : "";
-        const display = step.label ? `${step.label} (${step.agent})` : step.agent;
+        const display = runStatusStepDisplayName(step);
         const phase = step.phase ? `[${step.phase}] ` : "";
         lines.push(`${stepLineLabel(status, index)}: ${phase}${display} ${step.status}${modelText}${stepActivityText ? `, ${stepActivityText}` : ""}${steeringSuffix}${acceptanceText}${budgetText}${errorText}`);
+        lines.push(...formatTimeoutRecoveryLines(step.timeoutRecovery, "  "));
+        if (step.runner?.type === "external-cli") {
+          const runner = normalizeExternalCliRunnerStatus(step.runner);
+          if (runner) {
+            lines.push(`  Runner: external-cli (${runner.command}${runner.args.length ? ` ${runner.args.join(" ")}` : ""})`);
+            lines.push(`  Adapter: ${runner.adapter.id} v${runner.adapter.version} (${runner.adapter.executionMode})`);
+            if (runner.safety) {
+              if ("approvalPolicy" in runner.safety)
+                lines.push(`  Safety: ${"access" in runner.safety ? `access=${runner.safety.access}, ` : ""}sandbox=${runner.safety.sandbox}, approval=${runner.safety.approvalPolicy}, ephemeral=${runner.safety.ephemeral}`);
+              else if ("mode" in runner.safety)
+                lines.push(`  Safety: access=${runner.safety.access}, auth=${runner.safety.authentication}, mode=${runner.safety.mode}, sandbox=${runner.safety.sandbox}, workspaceTrust=${runner.safety.workspaceTrust}, sessionReuse=${runner.safety.sessionReuse}`);
+              else if ("authentication" in runner.safety)
+                lines.push(`  Safety: access=${runner.safety.access}, auth=${runner.safety.authentication}, permission=${runner.safety.permissionMode}, tools=${runner.safety.tools}, mcp=${runner.safety.mcp}, settings=${runner.safety.settingSources}, settingsTrust=${runner.safety.userSettingsTrust}, persistence=${runner.safety.sessionPersistence}`);
+              else
+                lines.push(`  Safety: access=read-only, permission=${runner.safety.permissionMode}, tools=${runner.safety.tools}, mcp=${runner.safety.mcp}, settings=${runner.safety.settingSources}, persistence=${runner.safety.sessionPersistence}`);
+            }
+            lines.push(`  Capabilities: stop=${runner.capabilities.stop}, steer=false, resume=false, structuredOutput=false, toolEvents=false, supervisor=unsupported, forkContext=false, extensionBindings=false`);
+            lines.push(`  Unsupported steer: ${runner.unsupportedReasons.steer}`);
+            lines.push(`  Unsupported resume: ${runner.nonResumableReason}`);
+            lines.push(`  Unsupported supervisor: ${runner.unsupportedReasons.supervisor}`);
+            lines.push(`  Context handoff: fresh only (${runner.unsupportedReasons.forkContext})`);
+          } else {
+            lines.push("  Runner: external-cli (invalid persisted runner metadata)");
+          }
+          if (step.externalProcess?.pid !== undefined)
+            lines.push(`  Process: ${step.externalProcess.pid}`);
+          if (step.externalProcess) {
+            lines.push(`  Stdout: ${step.externalProcess.stdoutPath}`, `  Stderr: ${step.externalProcess.stderrPath}`);
+            if (step.externalProcess.finalOutputPath)
+              lines.push(`  Final output: ${step.externalProcess.finalOutputPath}`);
+          }
+        } else if (step.runner?.type === "external-job") {
+          lines.push(`  Runner: external-job (${step.runner.provider})`);
+          if (step.externalJob?.providerJobId)
+            lines.push(`  Provider job: ${step.externalJob.providerJobId}`);
+          if (step.externalJob?.state)
+            lines.push(`  Provider state: ${step.externalJob.state}`);
+          if (step.externalJob?.conversationUrl)
+            lines.push(`  Conversation: ${step.externalJob.conversationUrl}`);
+          if (step.externalJob?.resultArtifactPath)
+            lines.push(`  Result artifact: ${step.externalJob.resultArtifactPath}`);
+          if ((step.status === "complete" || step.status === "completed") && step.externalJob?.state === "completed" && step.externalJob.providerJobId && externalJobFollowUpSupported(step.runner.provider)) {
+            hasExternalJobFollowUpHint = true;
+            lines.push(`  Follow-up: subagent({ action: "resume", id: "${status.runId}", index: ${index}, message: "..." })`);
+          }
+        }
         lines.push(...formatNestedRunStatusLines(step.children, { indent: "  ", commandHints: true, maxLines: 20 }));
         const stepOutputPath = path.join(asyncDir, `output-${index}.log`);
         if (stepOutputPath !== outputPath && fs.existsSync(stepOutputPath))
           lines.push(`  Output: ${stepOutputPath}`);
-        if (step.status === "running") {
+        if (step.status === "running" && step.runner?.type !== "external-cli" && step.runner?.type !== "external-job" && status.mode !== "workflow") {
           lines.push(`  Intercom target: ${resolveSubagentIntercomTarget(status.runId, step.agent, index)} (if registered)`);
           lines.push(`  Steer: subagent({ action: "steer", id: "${status.runId}", index: ${index}, message: "..." })`);
+        } else if (step.status === "running" && (step.runner?.type === "external-cli" || step.runner?.type === "external-job")) {
+          lines.push("  Steer: unavailable; external runners do not accept live messages.");
         }
       }
+      const loadedWorkflowKeys = new Set((status.steps ?? []).flatMap((step) => step.workflowKey ? [step.workflowKey] : []));
+      const graphStages = status.mode === "workflow" ? workflowGraphStageNodes(status.workflowGraph) : [];
+      for (const [index, node] of graphStages.entries()) {
+        if (!loadedWorkflowKeys.has(node.id))
+          lines.push(`  ${formatWorkflowStageLine(node, index, graphStages.length)}`);
+      }
       const attached = new Set((status.steps ?? []).flatMap((step) => step.children?.map((child) => child.id) ?? []));
       const unattached = nestedChildren.filter((child) => !attached.has(child.id));
       lines.push(...formatNestedRunStatusLines(unattached, { indent: "", commandHints: true, maxLines: 20 }));
+      if (status.mode === "workflow" && status.state === "running") {
+        if (liveWorkflowControls.length === 0)
+          lines.push("Steer: unavailable; no live foreground route is registered in the active session.");
+        else
+          for (const control of liveWorkflowControls) {
+            for (const index of [...control.activeChildren.keys()].sort((left, right) => left - right)) {
+              lines.push(`Steer live foreground child: subagent({ action: "steer", id: "${control.runId}", index: ${index}, message: "..." })`);
+            }
+          }
+      }
       if (nestedWarning)
         lines.push(`Warning: ${nestedWarning}`);
       if (status.sessionFile)
         lines.push(`Session: ${status.sessionFile}`);
-      if (status.state === "running")
+      const allExternal = (status.steps?.length ?? 0) > 0 && status.steps.every((step) => step.runner?.type === "external-cli" || step.runner?.type === "external-job");
+      if (status.state === "running" && !allExternal && status.mode !== "workflow")
         lines.push(`Steer running child: subagent({ action: "steer", id: "${status.runId}", message: "..." })`);
       if (status.state !== "running") {
-        lines.push(formatResumeGuidance(status.runId, status.steps ?? [], status.sessionFile));
+        lines.push(allExternal ? hasExternalJobFollowUpHint ? "Resume: use the external-job follow-up hint above." : "Resume: unavailable; external runners do not persist DM sessions." : formatResumeGuidance(status.runId, status.steps ?? [], status.sessionFile, { stopped: status.state === "stopped" || status.stopped === true }));
       }
       if (fs.existsSync(logPath))
         lines.push(`Log: ${logPath}`);
       if (fs.existsSync(eventsPath))
         lines.push(`Events: ${eventsPath}`);
+      const workflowChildren = parseWorkflowChildSummary(status.workflowChildren);
+      if (workflowChildren && workflowChildren.workflowRunId !== status.runId)
+        throw new Error("workflowChildren.workflowRunId does not match async status runId.");
       return { content: [{ type: "text", text: lines.join(`
-`) }], details: { mode: "single", results: [] } };
+`) }], details: { mode: "single", results: [], ...status.preflight ? { preflight: status.preflight } : {}, ...status.workflow?.preflightWarnings?.length ? { preflightWarnings: status.workflow.preflightWarnings } : {}, ...workflowChildren ? { workflowChildren } : {}, ...runFanoutBudget ? { runFanoutBudget } : {}, ...processTerminal ? { lifecycleStatus: { processTerminal } } : {} } };
     }
   }
   if (resultPath) {
+    if (params.action === "debug.run") {
+      return {
+        content: [{ type: "text", text: "Run lifecycle debug needs an async run directory with status.json." }],
+        isError: true,
+        details: { mode: "single", results: [] }
+      };
+    }
     try {
       const raw = fs.readFileSync(resultPath, "utf-8");
       const data = JSON.parse(raw);
@@ -401,15 +654,33 @@ export function inspectSubagentStatus(params, deps = {}) {
           return { content: [{ type: "text", text: message }], isError: true, details: { mode: "single", results: [] } };
         }
       }
-      const status = data.success ? "complete" : data.state === "paused" || data.exitCode === 0 ? "paused" : "failed";
+      const childStatuses = Array.isArray(data.results) ? data.results.map((child) => resolveSubagentResultStatus({
+        success: child.success,
+        state: child.state,
+        interrupted: child.interrupted,
+        timedOut: child.timedOut,
+        stopped: child.stopped,
+        turnBudgetExceeded: child.turnBudgetExceeded,
+        processSignal: child.processSignal,
+        exitCode: typeof child.exitCode === "number" ? child.exitCode : undefined
+      })) : [];
+      const status = data.state === "stopped" || data.stopped === true || childStatuses.includes("stopped") ? "stopped" : data.success ? "complete" : data.state === "paused" || data.exitCode === 0 ? "paused" : "failed";
       const runId = data.runId ?? data.id ?? resolvedId;
-      const lines = [`Run: ${runId}`, `State: ${status}`, `Result: ${resultPath}`];
+      const lines = [`Run: ${runId}`, data.toolCallId ? `Tool call: ${data.toolCallId}` : undefined, `State: ${status}`, `Result: ${resultPath}`].filter((line) => Boolean(line));
+      if (data.parallelHandoff?.path)
+        lines.push(`Parallel handoff: ${data.parallelHandoff.path}`);
       const children = Array.isArray(data.results) ? data.results : data.agent ? [{ agent: data.agent, sessionFile: data.sessionFile }] : [];
-      lines.push(formatResumeGuidance(runId, children, data.sessionFile));
+      lines.push(...formatTimeoutRecoveryLines(data.timeoutRecovery, "  "));
+      for (const child of children)
+        lines.push(...formatTimeoutRecoveryLines(child.timeoutRecovery, "  "));
+      lines.push(formatResumeGuidance(runId, children, data.sessionFile, { stopped: status === "stopped" }));
       if (data.summary)
         lines.push("", data.summary);
+      const workflowChildren = parseWorkflowChildSummary(data.workflowChildren);
+      if (workflowChildren && workflowChildren.workflowRunId !== runId)
+        throw new Error("workflowChildren.workflowRunId does not match the result run id.");
       return { content: [{ type: "text", text: lines.join(`
-`) }], details: { mode: "single", results: [] } };
+`) }], details: { mode: "single", results: [], ...workflowChildren ? { workflowChildren } : {} } };
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
       return {